mirror of
https://github.com/DeusData/codebase-memory-mcp.git
synced 2026-11-06 17:49:47 +00:00
Martin Vogel
18d8a9aa6c
es_usage_crossfile_typescript caught a wrong edge: with type positions resolving, a parameter annotation also published USAGE to the interface. Its oracle forbids that, because USAGE means a value. Every annotated name in TypeScript did this, so USAGE on real code counted types as values. A written type name, and the `Ns` root of `Ns.Type`, now abstains from USAGE with reason usage_names_a_type. `typeof value` stays USAGE: it reads a value. USES_TYPE had to take those names over, and it only looked at signatures and a few body forms. It now walks every type name in the TS family, so class fields, heritage clauses and alias bodies are not lost. Also promotes two known gaps these rules satisfy: the TS parameter annotation and the CommonJS `module.exports = async function`. Signed-off-by: Martin Vogel <martin.vogel.tech@gmail.com>
202 lines
12 KiB
C
202 lines
12 KiB
C
#ifndef CBM_RESOLVE_BINDING_H
|
|
#define CBM_RESOLVE_BINDING_H
|
|
|
|
#include "../cbm.h"
|
|
#include "model.h"
|
|
#include "lookup.h"
|
|
|
|
typedef struct cbm_resolve_binding_index cbm_resolve_binding_index_t;
|
|
|
|
/* One ECMAScript module binding, from `import` or a `require("literal")`
|
|
* initializer. A NULL member names the whole module (or its default when
|
|
* is_default). A NULL source means the specifier is not a plain literal. */
|
|
typedef struct {
|
|
const char *local;
|
|
const char *source;
|
|
const char *member;
|
|
bool is_default;
|
|
bool is_require;
|
|
bool type_only;
|
|
} cbm_resolve_js_import_t;
|
|
|
|
/* One exported name of an ECMAScript module, in source terms:
|
|
* target set: the name is this module's own declaration
|
|
* source set: it is re-exported from that module (member NULL: its namespace)
|
|
* name NULL: `export * from source`
|
|
* whole: `module.exports = value` / `export = value`; a whole export
|
|
* with is_object is the module's named exports themselves
|
|
* !known: the name is exported, but its value is not a proved declaration */
|
|
typedef struct {
|
|
const char *name;
|
|
const char *target;
|
|
const char *source;
|
|
const char *member;
|
|
unsigned kind;
|
|
bool known;
|
|
bool whole;
|
|
bool is_object;
|
|
bool default_import;
|
|
} cbm_resolve_js_export_t;
|
|
|
|
/* Build once per source file. Borrows result/source until the arena is freed.
|
|
* Supported syntax is deliberately explicit: Python module functions and
|
|
* direct imports, Lua local functions, JavaScript/TypeScript modules, plus one
|
|
* inline Vue/Svelte script with an audited inert host. An ECMAScript file is a
|
|
* module when it has import/export, CommonJS syntax or a module extension, or
|
|
* is TypeScript (a duplicate script-global implementation is a compile error).
|
|
* A classic browser script has no such signal; another script can replace its
|
|
* globals, so it remains unsupported. Lexical scopes are real, so a local name
|
|
* blocks only the scope it is visible in. Unknown syntax, dynamic namespace
|
|
* effects and partial parses fail closed. The source must be the raw buffer
|
|
* used to produce result->cached_tree. */
|
|
cbm_resolve_binding_index_t *cbm_resolve_binding_build(CBMArena *arena, const CBMFileResult *result,
|
|
CBMLanguage language, const char *source,
|
|
size_t source_len);
|
|
/* As above, for a .js file its package manifest declares a module (`"type"`). */
|
|
cbm_resolve_binding_index_t *cbm_resolve_binding_build_declared_module(
|
|
CBMArena *arena, const CBMFileResult *result, CBMLanguage language, const char *source,
|
|
size_t source_len, bool declared_module);
|
|
|
|
/* The module binding visible at this exact occurrence, by the lexical scope of
|
|
* its root identifier. NULL when the root is anything but such a binding. *path
|
|
* receives the whole `a.b.c` spelling that binds, when name is only `c`, and
|
|
* *type_position whether the occurrence names a type. */
|
|
const cbm_resolve_js_import_t *cbm_resolve_binding_js_import(const cbm_resolve_binding_index_t *,
|
|
const char *name, uint32_t start,
|
|
uint32_t end, CBMSourceOrigin origin,
|
|
const char **path,
|
|
bool *type_position);
|
|
/* `Owner.member()` or `this.member()` where the file itself assigns that member:
|
|
* `Owner.member = function`, `Owner.prototype.member = function`, or a member of
|
|
* the literal `const Owner = {...}`. Replaced or computed members abstain. */
|
|
cbm_resolve_result_t cbm_resolve_binding_js_member(const cbm_resolve_binding_index_t *,
|
|
const char *name, uint32_t start, uint32_t end,
|
|
CBMSourceOrigin origin);
|
|
/* This occurrence names a type, in a type annotation or as its `Ns` path root. */
|
|
bool cbm_resolve_binding_js_type_occurrence(const cbm_resolve_binding_index_t *, const char *name,
|
|
uint32_t start, uint32_t end, CBMSourceOrigin origin);
|
|
/* The exact source lines of the declaration this occurrence lexically names. */
|
|
bool cbm_resolve_binding_js_declaration_lines(const cbm_resolve_binding_index_t *, const char *name,
|
|
uint32_t start, uint32_t end, CBMSourceOrigin origin,
|
|
uint32_t *start_line, uint32_t *end_line);
|
|
/* False when the export list cannot be trusted as this file's complete surface. */
|
|
bool cbm_resolve_binding_js_exports_complete(const cbm_resolve_binding_index_t *);
|
|
/* True when CommonJS syntax makes `require()` of this file yield module.exports. */
|
|
bool cbm_resolve_binding_js_commonjs(const cbm_resolve_binding_index_t *);
|
|
size_t cbm_resolve_binding_js_export_count(const cbm_resolve_binding_index_t *);
|
|
const cbm_resolve_js_export_t *cbm_resolve_binding_js_export_at(const cbm_resolve_binding_index_t *,
|
|
size_t);
|
|
|
|
/* Set exact caller identity without re-reading or hashing source. Captured
|
|
* content/configuration IDs already came from result at build. */
|
|
bool cbm_resolve_binding_set_identity(cbm_resolve_binding_index_t *, const char *project,
|
|
const char *file);
|
|
cbm_resolve_lookup_context_t *cbm_resolve_binding_lookup_context(
|
|
const cbm_resolve_binding_index_t *);
|
|
/* Separate local validation root. Never incorporates/clones an incoming shared
|
|
* import proof. The accessor returns only the matching last audited site. */
|
|
const cbm_resolve_proof_t *cbm_resolve_binding_site_proof(const cbm_resolve_binding_index_t *,
|
|
const char *name, uint32_t start,
|
|
uint32_t end, CBMSourceOrigin origin);
|
|
|
|
/* O(log n) site/name queries. Candidate identity must already be exact.
|
|
* Local definitions are checked against the source declaration. Imported
|
|
* names additionally need independent target/export LOOKUP_COMPLETE evidence;
|
|
* a source alias alone cannot certify another module's export semantics.
|
|
* Does not trust callee_is_locally_bound's default false value. */
|
|
cbm_resolve_result_t cbm_resolve_binding_validate(const cbm_resolve_binding_index_t *index,
|
|
const char *name, uint32_t start, uint32_t end,
|
|
CBMSourceOrigin origin,
|
|
cbm_resolve_result_t candidate);
|
|
|
|
/* Exact whole-tag AST classification only, not target authority. This permits
|
|
* simple uppercase JSX names to request the ordinary lexical/import proof;
|
|
* all scope, export, target and projection checks still apply. */
|
|
bool cbm_resolve_binding_jsx_occurrence(const cbm_resolve_binding_index_t *index, const char *name,
|
|
uint32_t start, uint32_t end, CBMSourceOrigin origin);
|
|
|
|
/* A fixed diagnostic capability/reason string, never an inferred success. */
|
|
const char *cbm_resolve_binding_status(const cbm_resolve_binding_index_t *index);
|
|
|
|
enum { CBM_RESOLVE_EXPORT_VALUE = 1u << 0, CBM_RESOLVE_EXPORT_TYPE = 1u << 1 };
|
|
|
|
/* Named-export syntax proof, after the complete syntax/shadow/write audit.
|
|
* Python direct module functions and explicit JS/TS module declarations only.
|
|
* Functions expose VALUE, classes VALUE|TYPE, interfaces/type aliases TYPE.
|
|
* Private/default-only/aliased/re-export bindings are not named-export proof.
|
|
* This does not describe wildcard exports or externally observed mutations. */
|
|
unsigned cbm_resolve_binding_export_kind(const cbm_resolve_binding_index_t *index,
|
|
const char *qualified_name);
|
|
/* True only for one unshadowed source import in a completely audited module. */
|
|
bool cbm_resolve_binding_import(const cbm_resolve_binding_index_t *index, const char *local_name);
|
|
bool cbm_resolve_binding_export(const cbm_resolve_binding_index_t *index,
|
|
const char *qualified_name);
|
|
|
|
/* HTTP-only source facts; these do not expose a generic default export or
|
|
* namespace binding. A true default result has an exact const value identity;
|
|
* base == NULL means that the composed relative URL remains unknown. */
|
|
/* Runtime module-value access enumerated from the same AST audit. A NULL
|
|
* local_name is a namespace/re-export/loader escape unless side_effect_only.
|
|
* All strings are borrowed from the binding index arena. */
|
|
typedef struct {
|
|
const char *path;
|
|
const char *local_name;
|
|
bool side_effect_only;
|
|
} cbm_resolve_http_dependency_t;
|
|
bool cbm_resolve_binding_http_domain_complete(const cbm_resolve_binding_index_t *);
|
|
size_t cbm_resolve_binding_http_dependency_count(const cbm_resolve_binding_index_t *);
|
|
const cbm_resolve_http_dependency_t *cbm_resolve_binding_http_dependency_at(
|
|
const cbm_resolve_binding_index_t *, size_t);
|
|
bool cbm_resolve_binding_http_import_safe(const cbm_resolve_binding_index_t *, const char *,
|
|
bool axios_factory);
|
|
/* Exact default-import source literal; NULL for blocked or other import forms. */
|
|
const char *cbm_resolve_binding_http_import_path(const cbm_resolve_binding_index_t *, const char *);
|
|
bool cbm_resolve_binding_http_default(const cbm_resolve_binding_index_t *, const char **target,
|
|
const char **base);
|
|
bool cbm_resolve_binding_import_occurrence(const cbm_resolve_binding_index_t *, const CBMCall *,
|
|
const char *local_name);
|
|
|
|
/* Source-audited library namespace facts. A complete namespace includes every
|
|
* public spelling, including declarations whose edge binding is unsupported.
|
|
* These facts describe one library file only; parts/re-exports fail closed. */
|
|
typedef struct {
|
|
const char *uri;
|
|
/* Exact raw URI token identity for the audited extraction bridge. */
|
|
uint32_t uri_start_byte, uri_end_byte;
|
|
const char *prefix;
|
|
const char *const *show;
|
|
size_t show_count;
|
|
const char *const *hide;
|
|
size_t hide_count;
|
|
bool has_show;
|
|
} cbm_resolve_source_import_t;
|
|
|
|
/* Strong, source-audited Python absence domain. Inert package initialization
|
|
* only: imports, assignments, classes, decorators, defaults, dynamic attributes
|
|
* and conditional/effectful statements remain open. Names are sorted and may
|
|
* include NULL entries for non-module scopes; copy while the index is alive. */
|
|
/* Dynamic execution/module registry access remains an unknown project effect. */
|
|
bool cbm_resolve_binding_python_effects_complete(const cbm_resolve_binding_index_t *);
|
|
/* Conservatively includes writes and unknown alias/callee escapes. */
|
|
bool cbm_resolve_binding_python_import_escaped(const cbm_resolve_binding_index_t *, const char *);
|
|
bool cbm_resolve_binding_python_namespace_closed(const cbm_resolve_binding_index_t *index);
|
|
size_t cbm_resolve_binding_python_namespace_size(const cbm_resolve_binding_index_t *index);
|
|
const char *cbm_resolve_binding_python_namespace_name(const cbm_resolve_binding_index_t *index,
|
|
size_t offset);
|
|
|
|
bool cbm_resolve_binding_namespace_complete(const cbm_resolve_binding_index_t *index);
|
|
size_t cbm_resolve_binding_namespace_size(const cbm_resolve_binding_index_t *index);
|
|
const char *cbm_resolve_binding_namespace_member(const cbm_resolve_binding_index_t *index,
|
|
size_t offset, unsigned *kind);
|
|
size_t cbm_resolve_binding_import_count(const cbm_resolve_binding_index_t *index);
|
|
const cbm_resolve_source_import_t *cbm_resolve_binding_import_at(
|
|
const cbm_resolve_binding_index_t *index, size_t offset);
|
|
bool cbm_resolve_binding_name_present(const cbm_resolve_binding_index_t *index, const char *name);
|
|
|
|
/* Source-established lexical declaration candidate. Projection still must
|
|
* verify exact source/target graph ownership before emitting an edge. */
|
|
cbm_resolve_result_t cbm_resolve_binding_local(const cbm_resolve_binding_index_t *, const char *,
|
|
uint32_t, uint32_t, CBMSourceOrigin);
|
|
|
|
#endif
|