@aroman22/codegraph-vba-darwin-arm64 1.14.0 → 1.16.0

package/lib/dist/extraction/vba/runtime-objects.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Canonical list of VBA/Access runtime objects and singletons whose
+ * `Receiver.Member` calls are NEVER user-defined code — DAO, FileSystemObject
+ * (`fso`), intrinsic collections, error/debug intrinsics, late-binding
+ * factories, and Access application singletons.
+ *
+ * Issue #245: this used to be TWO literal sets written at different times.
+ * `RUNTIME_OBJECTS` (formerly in `src/resolution/vba-runtime-objects.ts`)
+ * decided whether a synthetic call EDGE was stamped `declined-runtime`;
+ * `RUNTIME_RECEIVER_BLACKLIST` (formerly a second literal in
+ * `./constants.ts`) decided whether the call-site scan looked at a receiver
+ * at all. Because the second list omitted `VBA`, `fso`, `Collection`,
+ * `ListBox` and friends, the extractor still synthesized a `function` NODE
+ * for every one of those calls — 6,132 stub nodes against 3,840 real
+ * procedures on the reference corpus. Edge consumers can filter on
+ * `repointDecision`; symbol search and node counts cannot.
+ *
+ * The two sets are now one literal (`RUNTIME_OBJECT_DEFS`) with two derived
+ * views, so they can never drift apart again:
+ *
+ *   - `RUNTIME_OBJECTS` — every canonical name, lowercased, for the
+ *     case-insensitive `isRuntimeObject` predicate. Consumed by the
+ *     post-extraction stub resolver (`ReferenceResolver.resolveVbaCallStubTarget`)
+ *     to DECLINE repointing a stub whose receiver is a runtime object, and by
+ *     the extractor's stub-NODE gate in `./calls.ts`.
+ *   - `RUNTIME_RECEIVER_BLACKLIST` — the case-sensitive PascalCase subset
+ *     flagged `blocksCallScan`. These receivers/members are dropped by the
+ *     call-site scans BEFORE any reference is surfaced, so the set is
+ *     deliberately narrow: widening it would silently delete
+ *     `unresolved_refs` rows. Widening the canonical set is safe; promoting
+ *     an entry to `blocksCallScan` is not.
+ *
+ * A user class or module that happens to share a runtime-object name (a
+ * "shadow" declaration, e.g. a user `.cls` literally named `DAO`) is still
+ * linked by the resolver: it runs its normal two-step name resolution FIRST
+ * and only falls back to this list when no real target exists (FR-2.1).
+ *
+ * This module is a LEAF: it imports nothing. `src/extraction/` must not
+ * depend on `src/resolution/`, so the canonical set lives here and
+ * `src/resolution/vba-runtime-objects.ts` re-exports it — every existing
+ * resolver import keeps working unchanged.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUNTIME_RECEIVER_BLACKLIST = exports.RUNTIME_OBJECTS = void 0;
+exports.isRuntimeObject = isRuntimeObject;
+/** THE single literal. Both exported sets below are views over it. */
+const RUNTIME_OBJECT_DEFS = [
+    // Access application singletons.
+    { name: 'Application', blocksCallScan: true },
+    { name: 'DoCmd', blocksCallScan: true },
+    { name: 'SysCmd', blocksCallScan: true },
+    { name: 'Screen', blocksCallScan: true },
+    // Access object collections.
+    { name: 'Forms', blocksCallScan: true },
+    { name: 'Reports', blocksCallScan: true },
+    { name: 'Modules', blocksCallScan: true },
+    { name: 'References', blocksCallScan: true },
+    { name: 'CommandBars', blocksCallScan: true },
+    // VBA debugging / error-handling intrinsics.
+    { name: 'Debug', blocksCallScan: true },
+    { name: 'Err', blocksCallScan: true },
+    // Late-binding factories (return IDispatch — not user code).
+    { name: 'CreateObject', blocksCallScan: true },
+    { name: 'GetObject', blocksCallScan: true },
+    // DAO/ADO recordset field collection access (e.g. rcdDatos.Fields("ID")).
+    { name: 'Fields', blocksCallScan: true },
+    // Data-access libraries and the current-database singletons.
+    { name: 'DAO' },
+    { name: 'CurrentDb' },
+    { name: 'CurrentProject' },
+    { name: 'CodeData' },
+    { name: 'CodeProject' },
+    // Scripting runtime.
+    { name: 'fso' },
+    // The VBA library namespace itself — `VBA.DoEvents`, `VBA.Format`, ...
+    { name: 'VBA' },
+    // Intrinsic collection type.
+    { name: 'Collection' },
+    // Access control types used as declared local-variable types.
+    { name: 'ListBox' },
+    { name: 'ComboBox' },
+    { name: 'TextBox' },
+];
+/**
+ * Every canonical runtime-object name, lowercased so matching is
+ * case-insensitive against a receiver as it appears in source.
+ */
+exports.RUNTIME_OBJECTS = new Set(RUNTIME_OBJECT_DEFS.map((def) => def.name.toLowerCase()));
+/**
+ * Derived view: the case-sensitive receivers/members the call-site scans drop
+ * before surfacing anything. NOT a second literal — see `blocksCallScan`.
+ */
+exports.RUNTIME_RECEIVER_BLACKLIST = new Set(RUNTIME_OBJECT_DEFS.filter((def) => def.blocksCallScan).map((def) => def.name));
+/**
+ * True iff `receiver` (any case) names a known VBA/Access runtime object.
+ * Leading/trailing brackets and surrounding whitespace are stripped
+ * defensively so a bracketed receiver (`[DAO]`) still matches.
+ */
+function isRuntimeObject(receiver) {
+    if (!receiver)
+        return false;
+    const key = receiver.replace(/^\[/, '').replace(/\]$/, '').trim().toLowerCase();
+    return exports.RUNTIME_OBJECTS.has(key);
+}
+//# sourceMappingURL=runtime-objects.js.map

package/lib/dist/extraction/vba/runtime-objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-objects.js","sourceRoot":"","sources":["../../../src/extraction/vba/runtime-objects.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;;;AA+EH,0CAIC;AAhED,sEAAsE;AACtE,MAAM,mBAAmB,GAAgC;IACvD,iCAAiC;IACjC,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,IAAI,EAAE;IAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE;IACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE;IACxC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE;IACxC,6BAA6B;IAC7B,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE;IACvC,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE;IACzC,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE;IACzC,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE;IAC5C,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,IAAI,EAAE;IAC7C,6CAA6C;IAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE;IACvC,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE;IACrC,6DAA6D;IAC7D,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,IAAI,EAAE;IAC9C,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE;IAC3C,0EAA0E;IAC1E,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE;IACxC,6DAA6D;IAC7D,EAAE,IAAI,EAAE,KAAK,EAAE;IACf,EAAE,IAAI,EAAE,WAAW,EAAE;IACrB,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC1B,EAAE,IAAI,EAAE,UAAU,EAAE;IACpB,EAAE,IAAI,EAAE,aAAa,EAAE;IACvB,qBAAqB;IACrB,EAAE,IAAI,EAAE,KAAK,EAAE;IACf,uEAAuE;IACvE,EAAE,IAAI,EAAE,KAAK,EAAE;IACf,6BAA6B;IAC7B,EAAE,IAAI,EAAE,YAAY,EAAE;IACtB,8DAA8D;IAC9D,EAAE,IAAI,EAAE,SAAS,EAAE;IACnB,EAAE,IAAI,EAAE,UAAU,EAAE;IACpB,EAAE,IAAI,EAAE,SAAS,EAAE;CACpB,CAAC;AAEF;;;GAGG;AACU,QAAA,eAAe,GAAwB,IAAI,GAAG,CACzD,mBAAmB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CACzD,CAAC;AAEF;;;GAGG;AACU,QAAA,0BAA0B,GAAwB,IAAI,GAAG,CACpE,mBAAmB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAC/E,CAAC;AAEF;;;;GAIG;AACH,SAAgB,eAAe,CAAC,QAAmC;IACjE,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChF,OAAO,uBAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/lib/dist/extraction/vba/signature.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Issue #250 (task T8): parse a VBA procedure's parameter list off its
+ * declaration line.
+ *
+ * The line handed in here has already been through the preprocessor, so a
+ * signature split with `_` continuations arrives as ONE logical line and a
+ * trailing `'` comment is already gone. This module must never re-implement
+ * continuation joining — see `vba-preprocess.ts` and issue #202.
+ */
+/** One declared parameter of a `Sub` / `Function` / `Property` signature. */
+export interface VbaParameterInfo {
+    /** Declared name, original casing, brackets unwrapped. */
+    name: string;
+    /** The `As <Type>` type, or `null` for an implicitly-`Variant` parameter. */
+    type: string | null;
+    /**
+     * `true` unless the declaration says `ByVal`. VBA passes by reference by
+     * default, so an unqualified parameter really is a `ByRef` one.
+     */
+    byRef: boolean;
+    /** The literal `Optional` keyword was present. */
+    optional: boolean;
+    /** Declared as an array — `name()`. */
+    isArray: boolean;
+    /** An `= <default>` clause was present. */
+    hasDefault: boolean;
+}
+/**
+ * Declared arity. `total` is `null` — not `Infinity` — when the signature ends
+ * in a `ParamArray`, because this value is serialised into node metadata and
+ * crosses the parse-worker boundary, and JSON has no `Infinity`.
+ */
+export interface VbaArity {
+    required: number;
+    total: number | null;
+}
+/** The parsed shape of one procedure signature. */
+export interface VbaSignatureInfo {
+    params: VbaParameterInfo[];
+    arity: VbaArity;
+}
+/**
+ * Split a parameter-list body on its top-level commas. Depth- and
+ * string-aware, so `Optional s As String = "a,b"` stays one entry.
+ */
+export declare function splitParameterList(body: string): string[];
+/**
+ * Parse the signature of the procedure whose name ends at `nameEndIndex`.
+ *
+ * A `ParamArray` tail is excluded from `arity.required` (it accepts zero
+ * arguments) and forces `arity.total` to `null` (it accepts any number). The
+ * `ParamArray` parameter itself is still reported in `params` with
+ * `optional: false`, because that flag mirrors the literal `Optional` keyword
+ * — which VBA forbids on a `ParamArray`.
+ */
+export declare function parseSignature(line: string, nameEndIndex: number): VbaSignatureInfo;
+//# sourceMappingURL=signature.d.ts.map

package/lib/dist/extraction/vba/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../../src/extraction/vba/signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,KAAK,EAAE,QAAQ,CAAC;CACjB;AA0DD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBzD;AAmCD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAmBlB"}

package/lib/dist/extraction/vba/signature.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Issue #250 (task T8): parse a VBA procedure's parameter list off its
+ * declaration line.
+ *
+ * The line handed in here has already been through the preprocessor, so a
+ * signature split with `_` continuations arrives as ONE logical line and a
+ * trailing `'` comment is already gone. This module must never re-implement
+ * continuation joining — see `vba-preprocess.ts` and issue #202.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitParameterList = splitParameterList;
+exports.parseSignature = parseSignature;
+/**
+ * `[Optional] [ByVal|ByRef|ParamArray] name[()] [As Type] [= default]`.
+ *
+ * The mode alternatives all demand trailing whitespace, so a parameter simply
+ * named `x` cannot be mistaken for a mode keyword. The type allows dots so
+ * `As DAO.Recordset` survives, and the bracketed `As [Type With Spaces]` form
+ * is unwrapped.
+ */
+const PARAM_RE = /^\s*(Optional\s+)?(ByVal\s+|ByRef\s+|ParamArray\s+)?(?:\[([^\]]+)\]|(\p{L}[\p{L}\p{N}_]*))\s*(\(\s*\))?\s*(?:As\s+(?:\[([^\]]+)\]|(\p{L}[\p{L}\p{N}_.]*)))?\s*(=[\s\S]*)?$/iu;
+/**
+ * Find the parameter-list body that starts at the first `(` at or after
+ * `searchFrom`, returning the text between the parentheses.
+ *
+ * The scan is depth- and string-aware so a default value such as
+ * `= "a)b"` or a nested `Array(1, 2)` cannot end the list early. Returns
+ * `null` when the declaration has no parameter list at all (`Public Sub Bare`)
+ * or when the parentheses never close.
+ *
+ * Anchoring on `searchFrom` (the end of the procedure NAME) rather than on
+ * `lastIndexOf(')')` is what keeps a colon-separated single-line procedure
+ * (`Public Sub X(): Debug.Print "(y)": End Sub`) from swallowing its own body
+ * as a parameter list.
+ */
+function findParameterListBody(line, searchFrom) {
+    let open = -1;
+    for (let i = searchFrom; i < line.length; i++) {
+        const ch = line[i];
+        if (ch === ' ' || ch === '\t')
+            continue;
+        if (ch === '(')
+            open = i;
+        break;
+    }
+    if (open < 0)
+        return null;
+    let depth = 0;
+    let inString = false;
+    for (let i = open; i < line.length; i++) {
+        const ch = line[i];
+        if (inString) {
+            if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"')
+            inString = true;
+        else if (ch === '(')
+            depth++;
+        else if (ch === ')') {
+            depth--;
+            if (depth === 0)
+                return line.slice(open + 1, i);
+        }
+    }
+    return null;
+}
+/**
+ * Split a parameter-list body on its top-level commas. Depth- and
+ * string-aware, so `Optional s As String = "a,b"` stays one entry.
+ */
+function splitParameterList(body) {
+    if (!body.trim())
+        return [];
+    const out = [];
+    let depth = 0;
+    let inString = false;
+    let start = 0;
+    for (let i = 0; i < body.length; i++) {
+        const ch = body[i];
+        if (inString) {
+            if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"')
+            inString = true;
+        else if (ch === '(')
+            depth++;
+        else if (ch === ')')
+            depth--;
+        else if (ch === ',' && depth === 0) {
+            out.push(body.slice(start, i));
+            start = i + 1;
+        }
+    }
+    out.push(body.slice(start));
+    return out;
+}
+/**
+ * Parse one raw parameter fragment. A fragment the regex cannot make sense of
+ * still yields an entry — dropping it would silently under-count the arity,
+ * and a wrong arity is worse than a coarse one.
+ */
+function parseParameter(raw) {
+    const m = PARAM_RE.exec(raw);
+    if (!m) {
+        return {
+            name: raw.trim(),
+            type: null,
+            byRef: true,
+            optional: false,
+            isArray: false,
+            hasDefault: false,
+        };
+    }
+    const mode = (m[2] ?? '').trim().toLowerCase();
+    return {
+        name: m[3] ?? m[4] ?? '',
+        type: m[6] ?? m[7] ?? null,
+        byRef: mode !== 'byval',
+        optional: Boolean(m[1]),
+        isArray: Boolean(m[5]),
+        hasDefault: Boolean(m[8]),
+    };
+}
+/** `true` when the fragment declares a `ParamArray`. */
+function isParamArray(raw) {
+    return /^\s*ParamArray\s+/i.test(raw);
+}
+/**
+ * Parse the signature of the procedure whose name ends at `nameEndIndex`.
+ *
+ * A `ParamArray` tail is excluded from `arity.required` (it accepts zero
+ * arguments) and forces `arity.total` to `null` (it accepts any number). The
+ * `ParamArray` parameter itself is still reported in `params` with
+ * `optional: false`, because that flag mirrors the literal `Optional` keyword
+ * — which VBA forbids on a `ParamArray`.
+ */
+function parseSignature(line, nameEndIndex) {
+    const body = findParameterListBody(line, nameEndIndex);
+    if (body === null) {
+        return { params: [], arity: { required: 0, total: 0 } };
+    }
+    const fragments = splitParameterList(body);
+    const params = [];
+    let unbounded = false;
+    let required = 0;
+    for (const raw of fragments) {
+        const param = parseParameter(raw);
+        params.push(param);
+        if (isParamArray(raw))
+            unbounded = true;
+        else if (!param.optional)
+            required++;
+    }
+    return {
+        params,
+        arity: { required, total: unbounded ? null : params.length },
+    };
+}
+//# sourceMappingURL=signature.js.map

package/lib/dist/extraction/vba/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../../../src/extraction/vba/signature.ts"],"names":[],"mappings":"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"}

package/lib/dist/extraction/vba/sql-wrapper.d.ts

@@ -1,7 +1,68 @@
-import { VbaExtractorContext } from './context';
-export declare function scanSqlInLine(ctx: VbaExtractorContext, line: string, lineNum: number, dedupe: Set<string>, sqlVariables: Map<string, string>): void;
+import { VbaExtractorContext, ProcInfo } from './context';
 /**
- * #13 fix: `sql = sql & "..."` (self-referential concatenation) must
+ * Issue #252 — `metadata.synthesizedBy` for a table reached through SQL
+ * assigned to a binding property at RUNTIME. Deliberately distinct from the
+ * `.form.txt` sweep's static `vba-row-source` so an audit can tell the two
+ * provenances apart: one is what the designer stored, the other is what the
+ * code actually binds.
+ */
+export declare const RUNTIME_BINDING_SYNTHESIZER = "vba-row-source-dynamic";
+/**
+ * Issue #244 — the wrapper list used when `codegraph.json` →
+ * `vba.sqlWrappers` is absent. A STRICT SUPERSET of the pre-#244 behaviour:
+ *
+ *   - `db` covers every receiver the old `…db\b` regex reached (see
+ *     {@link receiverMatches} for the suffix arm that preserves it) plus the
+ *     `db`-prefixed locals it missed (`dbUse`, `dbToUse`, `m_dbLanzadera`).
+ *   - `getdb` covers the per-backend accessor family (`getdbHPS()`,
+ *     `getdbExpedientes()`, `getdbLanzadera()`) the issue measured at 26-36%
+ *     of all execution sites.
+ *   - `CurrentDb` / `DBEngine` are the Access built-ins.
+ *   - `qd` / `qdf` are the conventional DAO `QueryDef` receivers.
+ *   - `DoCmd.RunSQL` is the Access statement form (both the literal and the
+ *     variable spelling, previously two dedicated regexes).
+ *   - `Connection.Execute` / `Recordset.Open` are the ADO pair.
+ *
+ * Project-specific accessors that do not fit these names are added through
+ * `vba.sqlWrappers`, which EXTENDS this list rather than replacing it.
+ */
+export declare const DEFAULT_SQL_WRAPPERS: readonly string[];
+/** One parsed wrapper entry. Both fields are lowercase — VBA is case-insensitive. */
+interface SqlWrapperMatcher {
+    /** Receiver name fragment, e.g. `getdb` from `"getdb"` or `cnn` from `"cnn.Execute"`. */
+    receiver: string;
+    /** Method name, or `null` for a bare entry (which implies {@link DEFAULT_WRAPPER_METHODS}). */
+    method: string | null;
+}
+/**
+ * The per-extractor compiled wrapper state. Built ONCE per `VbaExtractor`
+ * (see `vba-extractor.ts`) and cached on `VbaExtractorContext` — the two
+ * RegExps are stateful (`/g`) and `scanSqlInLine` runs on every line of every
+ * file, so re-compiling them per line (which is what the pre-#244 code did)
+ * is pure waste on the hottest path in VBA extraction.
+ */
+export interface CompiledSqlWrappers {
+    /** Literal form — `<receiver>[()].<method> "…"`. Stateful; reset before use. */
+    readonly literalRe: RegExp;
+    /** Variable form — `<receiver>[()].<method> <identifier>`. Stateful; reset before use. */
+    readonly varRe: RegExp;
+    /** Parsed entries, defaults first, project entries appended. */
+    readonly matchers: readonly SqlWrapperMatcher[];
+}
+/**
+ * Parse the plain-string wrapper entries into matchers and pair them with a
+ * fresh pair of scanning RegExps.
+ *
+ * `configured` entries are APPENDED to {@link DEFAULT_SQL_WRAPPERS}, never
+ * substituted for them: a project that names its own accessor must not lose
+ * `CurrentDb` in the trade. Entries are accepted in exactly two forms — a
+ * bare identifier fragment (`"getdb"`) or a `receiver.method` pair
+ * (`"cnn.Execute"`). Anything else is dropped here; `project-config.ts`
+ * already warned about it at load time.
+ */
+export declare function compileSqlWrappers(configured?: readonly string[]): CompiledSqlWrappers;
+/**
+ * Issue #13: `sql = sql & "..."` (self-referential concatenation) must
  * ACCUMULATE the new fragment onto whatever was already tracked for
  * `varName`, not overwrite it. Overwriting silently dropped earlier
  * fragments' tables — typically the initial `FROM <table>` in
@@ -14,4 +75,16 @@ export declare function scanSqlInLine(ctx: VbaExtractorContext, line: string, li
  * behavior is unchanged.
  */
 export declare function trackSqlVariableAssignment(lines: string[], lineIndex: number, sqlVariables: Map<string, string>): void;
+/**
+ * Issue #255: scan one line for domain-aggregate calls and emit the saved-query
+ * reference their second argument names.
+ *
+ * Deliberately NOT handled: a domain spelled as a full SQL statement
+ * (`DLookup("N", "SELECT Id FROM T")`), which Access also accepts. It is
+ * rejected by `looksLikeSavedQueryName`'s verb gate and produces nothing —
+ * the same silence T11 chose for every literal it cannot classify.
+ */
+export declare function scanDomainFunctionsInLine(ctx: VbaExtractorContext, line: string, lineNum: number, dedupe: Set<string>, caller: ProcInfo): void;
+export declare function scanSqlInLine(ctx: VbaExtractorContext, line: string, lineNum: number, dedupe: Set<string>, sqlVariables: Map<string, string>, caller?: ProcInfo): void;
+export {};
 //# sourceMappingURL=sql-wrapper.d.ts.map

package/lib/dist/extraction/vba/sql-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-wrapper.d.ts","sourceRoot":"","sources":["../../../src/extraction/vba/sql-wrapper.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAuHhD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,EACnB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,IAAI,CA+CN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,IAAI,CAiBN"}
+{"version":3,"file":"sql-wrapper.d.ts","sourceRoot":"","sources":["../../../src/extraction/vba/sql-wrapper.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAa1D;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AA6FpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAUjD,CAAC;AAEF,qFAAqF;AACrF,UAAU,iBAAiB;IACzB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAC7B,mBAAmB,CA6BrB;AAqGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,IAAI,CAiBN;AA4SD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,EACnB,MAAM,EAAE,QAAQ,GACf,IAAI,CAeN;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,EACnB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,CAAC,EAAE,QAAQ,GAChB,IAAI,CA0EN"}