@opensip-cli/lang-typescript 0.1.0

package/dist/filter.js

@@ -0,0 +1,263 @@
+// @fitness-ignore-file file-length-limit -- framework/content-filter complexity requires single-file cohesion
+// @fitness-ignore-file toctou-race-condition -- filterContent cache.get + cache.set on a per-RunScope Map; both operations are synchronous, no async gap, safe in single-threaded Node.js
+/**
+ * @fileoverview TypeScript scanner-based content filtering
+ *
+ * Uses the TypeScript scanner (not full AST parser) to identify string literal
+ * and comment regions. String content is replaced with spaces of equal length,
+ * preserving line/column positions for accurate violation reporting.
+ */
+import { logger, currentScope } from '@opensip-cli/core';
+import { buildLineStarts } from '@opensip-cli/core/languages';
+import ts from 'typescript';
+// =============================================================================
+// HELPERS
+// =============================================================================
+/**
+ * Build a set of 1-based line numbers from a list of regions.
+ * A line is included if any part of it falls within a region.
+ *
+ * Reuses `buildLineStarts` from `@opensip-cli/core/languages` so UTF-16
+ * surrogate-pair / BOM / CRLF handling stays in one place across language
+ * adapters.
+ */
+function linesToSet(content, regions) {
+    if (regions.length === 0)
+        return new Set();
+    const lineStarts = buildLineStarts(content);
+    const result = new Set();
+    for (const region of regions) {
+        for (let lineIdx = 0; lineIdx < lineStarts.length; lineIdx++) {
+            const lineStart = lineStarts[lineIdx];
+            const lineEnd = lineIdx + 1 < lineStarts.length ? lineStarts[lineIdx + 1] - 1 : content.length;
+            if (lineStart > region.end)
+                break;
+            if (lineEnd >= region.start) {
+                result.add(lineIdx + 1); // 1-based
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Check if a (1-based line, 0-based column) offset falls within any region.
+ */
+function isInRegions(content, regions, line, column) {
+    if (regions.length === 0)
+        return false;
+    // Convert line/column to byte offset
+    let currentLine = 1;
+    let lineStart = 0;
+    // eslint-disable-next-line unicorn/no-for-loop -- offset-bearing scan: captures UTF-16 line start
+    for (let i = 0; i < content.length; i++) {
+        if (currentLine === line) {
+            lineStart = i;
+            break;
+        }
+        if (content[i] === '\n')
+            currentLine++;
+    }
+    if (currentLine !== line)
+        return false;
+    const offset = lineStart + column;
+    for (const region of regions) {
+        if (offset >= region.start && offset < region.end)
+            return true;
+    }
+    return false;
+}
+/**
+ * Replace characters in the given range with spaces, preserving newlines.
+ * Records the range as a string region.
+ */
+function replaceCharsInRange(chars, start, end, stringRegions) {
+    stringRegions.push({ start, end });
+    for (let i = start; i < end; i++) {
+        if (chars[i] !== '\n')
+            chars[i] = ' ';
+    }
+}
+// =============================================================================
+// MAIN
+// =============================================================================
+/**
+ * Scan content using TypeScript's scanner to identify string and comment regions.
+ *
+ * String literals are replaced with spaces of equal length, preserving
+ * line/column positions. Comments are tracked but not removed (directives
+ * live in comments and must be preserved).
+ */
+// Module-level cache to avoid re-running the TS scanner on the same content.
+// Bounded by an idle timer (10 min, matching parse-cache.ts) so long-lived
+// embedders don't accumulate cached filter results across runs forever. The
+// timer resets each time filterContent runs, so an active session never
+// loses its cache.
+//
+// Filter-content caching now rides on the current `RunScope`'s
+// `parseCache.filteredContent` Map (Phase 6 Task 6.4). The previous
+// design kept a separate module-level `filterCache` Map + 10-min
+// idle timer, which had three failure modes: (1) two tests in the
+// same process couldn't isolate state without a `clearFilterCache()`
+// call; (2) the timer kept the process alive in environments where
+// it wasn't `unref`'d correctly; (3) lifetime drift vs the parse
+// cache meant a `clearParseCache()` call left stale filter entries.
+// Folding into `RunScope` means the test/run lifecycle owns both
+// caches together — one `scope.dispose()` clears them both.
+//
+// Calling `filterContent(content)` outside any `runWithScope` (e.g.
+// a direct unit test of the filter) just bypasses the cache; the
+// filtered output is computed every call. That's a documented
+// fallback, not a hot-path concern, because production paths always
+// run inside a scope established by the CLI's pre-action-hook.
+/** Strips TS comments and string literals; result is cached per-content on the active scope. */
+export function filterContent(content) {
+    const scope = currentScope();
+    if (scope) {
+        const cached = scope.parseCache.filteredContent.get(content);
+        if (cached)
+            return cached;
+    }
+    try {
+        const result = filterContentImpl(content);
+        if (scope)
+            scope.parseCache.filteredContent.set(content, result);
+        return result;
+        /* v8 ignore start -- defensive: TypeScript scanner is robust and recovers from malformed input rather than throwing; this fallback exists for theoretical scanner exceptions */
+    }
+    catch {
+        /*
+         * Silent degradation — by design.
+         *
+         * The TypeScript scanner is best-effort: it CAN throw on resource
+         * exhaustion, malformed input the scanner doesn't recognise, or
+         * unsupported character classes. When that happens, raising would
+         * terminate the entire fitness run because filterContent is called
+         * from every TS check that needs string/comment masking.
+         *
+         * The fallback returns raw content with stub `isInString` /
+         * `isInComment` predicates that always return `false`. This is the
+         * safest default: callers that pattern-match identifiers will see
+         * un-stripped source (so a banned-call reference inside a string or
+         * comment may produce a false positive), but they will never
+         * see a SILENT TRUNCATION of legitimate code (which is what would
+         * happen if the scanner desynced and we returned partially-stripped
+         * output).
+         *
+         * The audit (2026-05-23 F-M1) flagged this as a P3 — the trade-off
+         * is intentional but the only signal today is `logger.debug`. A
+         * future revision SHOULD widen `FilteredContent` with a
+         * `degraded: boolean` flag so callers can branch on it; until then,
+         * the debug log line below is the only operator-visible signal.
+         */
+        logger.debug('Content filter fell back to raw content', {
+            evt: 'fitness.content_filter.fallback',
+            module: 'fitness:framework',
+        });
+        const fallback = {
+            code: content,
+            codeNoComments: content,
+            raw: content,
+            commentLines: new Set(),
+            isInString: () => false,
+            isInComment: () => false,
+        };
+        if (scope)
+            scope.parseCache.filteredContent.set(content, fallback);
+        return fallback;
+    }
+    /* v8 ignore stop */
+}
+// eslint-disable-next-line sonarjs/cognitive-complexity -- TS scanner driver: token-by-token loop with per-kind handling; flatter shape would scatter token classification
+function filterContentImpl(content) {
+    const scanner = ts.createScanner(ts.ScriptTarget.Latest, false, ts.LanguageVariant.Standard, content);
+    const stringRegions = [];
+    const commentRegions = [];
+    // Use UTF-16 code-unit array (split('')) so that scanner.getTokenStart()/getTokenEnd()
+    // (which are UTF-16 code unit offsets) align with indices, even for astral (non-BMP)
+    // characters. Using spread [...] produces a code-point array and desynchronizes
+    // after the first emoji/etc, corrupting all subsequent positions, signals, SARIF,
+    // baselines, suppression matching, etc.
+    // eslint-disable-next-line unicorn/prefer-spread -- correctness: must be UTF-16 code units to match TS scanner offsets; spread would be code points and corrupt token ranges for astral chars.
+    const chars = content.split('');
+    // Depth counter, not a boolean — a `${ `inner` }` construct nests two templates
+    // and each `}` that closes a template-expression must be rescanned. A plain
+    // boolean flipped off by the inner TemplateTail would leave the outer unrescanned
+    // and desync the scanner for the rest of the file (which silently wipes real
+    // code to whitespace). Incremented at TemplateHead, decremented at TemplateTail.
+    let templateDepth = 0;
+    while (true) {
+        let token = scanner.scan();
+        // @fitness-ignore-next-line unsafe-secret-comparison -- comparing TypeScript SyntaxKind enum, not a secret
+        if (token === ts.SyntaxKind.EndOfFileToken)
+            break;
+        // After a CloseBraceToken inside ANY template expression, rescan to get TemplateMiddle/TemplateTail
+        // @fitness-ignore-next-line unsafe-secret-comparison -- comparing TypeScript SyntaxKind enum, not a secret
+        if (token === ts.SyntaxKind.CloseBraceToken && templateDepth > 0) {
+            token = scanner.reScanTemplateToken(false);
+        }
+        const start = scanner.getTokenStart();
+        const end = scanner.getTokenEnd();
+        switch (token) {
+            case ts.SyntaxKind.StringLiteral:
+            case ts.SyntaxKind.NoSubstitutionTemplateLiteral: {
+                // Replace content inside quotes/backticks (keep delimiters)
+                replaceCharsInRange(chars, start + 1, end - 1, stringRegions);
+                break;
+            }
+            case ts.SyntaxKind.TemplateHead: {
+                // `text ${ — replace text between ` and ${
+                templateDepth++;
+                replaceCharsInRange(chars, start + 1, end - 2, stringRegions);
+                break;
+            }
+            case ts.SyntaxKind.TemplateMiddle: {
+                // }text ${ — replace text between } and ${
+                replaceCharsInRange(chars, start + 1, end - 2, stringRegions);
+                break;
+            }
+            case ts.SyntaxKind.TemplateTail: {
+                // }text` — replace text between } and `
+                templateDepth--;
+                replaceCharsInRange(chars, start + 1, end - 1, stringRegions);
+                break;
+            }
+            case ts.SyntaxKind.SingleLineCommentTrivia:
+            case ts.SyntaxKind.MultiLineCommentTrivia: {
+                // Track comment regions but don't modify content
+                commentRegions.push({ start, end });
+                break;
+            }
+            // RegularExpressionLiteral — leave unchanged, regex is code
+            default: {
+                break;
+            }
+        }
+    }
+    const code = chars.join('');
+    const commentLines = linesToSet(content, commentRegions);
+    // Compute `codeNoComments` ... (same UTF-16 alignment requirement as above)
+    // eslint-disable-next-line unicorn/prefer-spread -- correctness: must be UTF-16 code units to match TS scanner offsets; spread would be code points and corrupt token ranges for astral chars.
+    const charsNoComments = content.split('');
+    for (const region of stringRegions) {
+        for (let i = region.start; i < region.end; i++) {
+            if (charsNoComments[i] !== '\n')
+                charsNoComments[i] = ' ';
+        }
+    }
+    for (const region of commentRegions) {
+        for (let i = region.start; i < region.end; i++) {
+            if (charsNoComments[i] !== '\n')
+                charsNoComments[i] = ' ';
+        }
+    }
+    const codeNoComments = charsNoComments.join('');
+    return {
+        code,
+        codeNoComments,
+        raw: content,
+        commentLines,
+        isInString: (line, column) => isInRegions(content, stringRegions, line, column),
+        isInComment: (line, column) => isInRegions(content, commentRegions, line, column),
+    };
+}
+//# sourceMappingURL=filter.js.map

package/dist/filter.js.map

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

package/dist/function-scope.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Function-scope AST helpers.
+ *
+ * Walking helpers that answer "what function am I inside?" / "is this in an
+ * async context?" / "is this in a conditional branch?" — used by checks that
+ * need to reason about scope boundaries (lifecycle cleanup, async waterfall
+ * detection, etc.).
+ *
+ * Lives in its own module so consumers reading these helpers don't scroll
+ * past unrelated parsing / inspection / comment-detection code, and so the
+ * next round of scope helpers has a sensible home rather than landing in
+ * the general-purpose `ast-utilities.ts` module.
+ */
+import * as ts from 'typescript';
+/**
+ * Function-like nodes the helpers below treat as a "function boundary":
+ * regular declarations, methods, function expressions, arrow functions, and
+ * constructor declarations. The helpers stop their upward walk at any of
+ * these.
+ */
+export type FunctionLikeNode = ts.FunctionDeclaration | ts.MethodDeclaration | ts.FunctionExpression | ts.ArrowFunction | ts.ConstructorDeclaration;
+/**
+ * Walk up the AST from a node and return the nearest enclosing function-like
+ * declaration. Includes constructors. Returns null when the node sits at
+ * module scope.
+ */
+export declare function findEnclosingFunction(node: ts.Node): FunctionLikeNode | null;
+/**
+ * Walk up the AST from a node and return the BODY of the nearest enclosing
+ * function-like declaration when that body is a {@link ts.Block}. Returns
+ * null when there is no enclosing function, or when the function uses an
+ * expression body (e.g. an arrow function `() => x`) rather than a block.
+ */
+export declare function findEnclosingFunctionBody(node: ts.Node): ts.Block | null;
+/**
+ * Return the textual name of the nearest enclosing named function-like, or
+ * null when the enclosing function is anonymous or there is no enclosing
+ * function. Walks past anonymous arrow functions to the next named ancestor —
+ * e.g. for a node inside `class Foo { bar() { (() => baz())() } }`, this
+ * returns `'bar'`, not `null`.
+ */
+export declare function getEnclosingFunctionName(node: ts.Node, sourceFile: ts.SourceFile): string | null;
+/**
+ * Walk up the AST from a node and return the nearest function-like ancestor
+ * OR the enclosing SourceFile. Differs from {@link findEnclosingFunction} in
+ * that it always returns a node (never null) — the SourceFile acts as the
+ * top-level scope.
+ */
+export declare function findEnclosingScope(node: ts.Node): ts.Node;
+/**
+ * Return true when `node` carries the `async` modifier. Uses the modern
+ * `canHaveModifiers` + `getModifiers` API so it is safe to call on any node
+ * kind, not just function-likes.
+ */
+export declare function isAsync(node: ts.Node): boolean;
+/**
+ * Return true when `node` is nested inside an `async` function-like ancestor.
+ * Walks up until the first function-like is found (returns false if none),
+ * then asks {@link isAsync} of that function. Module-top-level code returns
+ * false — there is no enclosing async context.
+ */
+export declare function isInAsyncContext(node: ts.Node): boolean;
+/**
+ * Return true when `node` is nested inside a conditional construct — `if`,
+ * `else`, `switch` case, or a ternary expression — within its enclosing
+ * function. Stops at function boundaries (does NOT cross into outer
+ * functions).
+ */
+export declare function isInsideConditionalBlock(node: ts.Node): boolean;
+//# sourceMappingURL=function-scope.d.ts.map

package/dist/function-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-scope.d.ts","sourceRoot":"","sources":["../src/function-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAMjC;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,EAAE,CAAC,mBAAmB,GACtB,EAAE,CAAC,iBAAiB,GACpB,EAAE,CAAC,kBAAkB,GACrB,EAAE,CAAC,aAAa,GAChB,EAAE,CAAC,sBAAsB,CAAC;AAgB9B;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,gBAAgB,GAAG,IAAI,CAO5E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,KAAK,GAAG,IAAI,CAMxE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAkBhG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,CAOzD;AAMD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAIvD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAW/D"}

package/dist/function-scope.js

@@ -0,0 +1,142 @@
+/**
+ * @fileoverview Function-scope AST helpers.
+ *
+ * Walking helpers that answer "what function am I inside?" / "is this in an
+ * async context?" / "is this in a conditional branch?" — used by checks that
+ * need to reason about scope boundaries (lifecycle cleanup, async waterfall
+ * detection, etc.).
+ *
+ * Lives in its own module so consumers reading these helpers don't scroll
+ * past unrelated parsing / inspection / comment-detection code, and so the
+ * next round of scope helpers has a sensible home rather than landing in
+ * the general-purpose `ast-utilities.ts` module.
+ */
+import * as ts from 'typescript';
+function isFunctionLike(node) {
+    return (ts.isFunctionDeclaration(node) ||
+        ts.isMethodDeclaration(node) ||
+        ts.isFunctionExpression(node) ||
+        ts.isArrowFunction(node) ||
+        ts.isConstructorDeclaration(node));
+}
+// =============================================================================
+// ENCLOSING-FUNCTION WALKERS
+// =============================================================================
+/**
+ * Walk up the AST from a node and return the nearest enclosing function-like
+ * declaration. Includes constructors. Returns null when the node sits at
+ * module scope.
+ */
+export function findEnclosingFunction(node) {
+    let current = node.parent;
+    while (current && !ts.isSourceFile(current)) {
+        if (isFunctionLike(current))
+            return current;
+        current = current.parent;
+    }
+    return null;
+}
+/**
+ * Walk up the AST from a node and return the BODY of the nearest enclosing
+ * function-like declaration when that body is a {@link ts.Block}. Returns
+ * null when there is no enclosing function, or when the function uses an
+ * expression body (e.g. an arrow function `() => x`) rather than a block.
+ */
+export function findEnclosingFunctionBody(node) {
+    const fn = findEnclosingFunction(node);
+    if (!fn)
+        return null;
+    const body = fn.body;
+    if (body && ts.isBlock(body))
+        return body;
+    return null;
+}
+/**
+ * Return the textual name of the nearest enclosing named function-like, or
+ * null when the enclosing function is anonymous or there is no enclosing
+ * function. Walks past anonymous arrow functions to the next named ancestor —
+ * e.g. for a node inside `class Foo { bar() { (() => baz())() } }`, this
+ * returns `'bar'`, not `null`.
+ */
+export function getEnclosingFunctionName(node, sourceFile) {
+    let current = node.parent;
+    while (current && !ts.isSourceFile(current)) {
+        if (ts.isMethodDeclaration(current)) {
+            return current.name.getText(sourceFile);
+        }
+        if (ts.isFunctionDeclaration(current) && current.name) {
+            return current.name.getText(sourceFile);
+        }
+        // Named function expression: `const x = function namedFn() { … }`
+        // — the name is part of the FunctionExpression, not its parent. Without
+        // this branch the walker would skip past namedFn to its outer scope.
+        if (ts.isFunctionExpression(current) && current.name) {
+            return current.name.getText(sourceFile);
+        }
+        current = current.parent;
+    }
+    return null;
+}
+/**
+ * Walk up the AST from a node and return the nearest function-like ancestor
+ * OR the enclosing SourceFile. Differs from {@link findEnclosingFunction} in
+ * that it always returns a node (never null) — the SourceFile acts as the
+ * top-level scope.
+ */
+export function findEnclosingScope(node) {
+    let current = node.parent;
+    while (current) {
+        if (isFunctionLike(current) || ts.isSourceFile(current))
+            return current;
+        current = current.parent;
+    }
+    return node.getSourceFile();
+}
+// =============================================================================
+// ASYNC / CONDITIONAL CONTEXT
+// =============================================================================
+/**
+ * Return true when `node` carries the `async` modifier. Uses the modern
+ * `canHaveModifiers` + `getModifiers` API so it is safe to call on any node
+ * kind, not just function-likes.
+ */
+export function isAsync(node) {
+    const modifiers = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+    return modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword) ?? false;
+}
+/**
+ * Return true when `node` is nested inside an `async` function-like ancestor.
+ * Walks up until the first function-like is found (returns false if none),
+ * then asks {@link isAsync} of that function. Module-top-level code returns
+ * false — there is no enclosing async context.
+ */
+export function isInAsyncContext(node) {
+    const fn = findEnclosingFunction(node);
+    if (!fn)
+        return false;
+    return isAsync(fn);
+}
+/**
+ * Return true when `node` is nested inside a conditional construct — `if`,
+ * `else`, `switch` case, or a ternary expression — within its enclosing
+ * function. Stops at function boundaries (does NOT cross into outer
+ * functions).
+ */
+export function isInsideConditionalBlock(node) {
+    let current = node.parent;
+    while (current && !ts.isSourceFile(current)) {
+        if (isFunctionLike(current))
+            return false;
+        if (ts.isIfStatement(current))
+            return true;
+        if (ts.isSwitchStatement(current))
+            return true;
+        if (ts.isCaseClause(current))
+            return true;
+        if (ts.isConditionalExpression(current))
+            return true;
+        current = current.parent;
+    }
+    return false;
+}
+//# sourceMappingURL=function-scope.js.map

package/dist/function-scope.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import * as ts from 'typescript';
+export { ts };
+export { typescriptAdapter, adapters } from './adapter.js';
+export { parseSource } from './parse.js';
+export { typescriptQuery } from './query.js';
+export { stripStrings, stripComments } from './strip.js';
+export { filterContent } from './filter.js';
+export type { FilteredContent } from './filter.js';
+export { discoverTypescriptWorkspaceUnits } from './workspace-units.js';
+export { findEnclosingFunction, findEnclosingFunctionBody, getEnclosingFunctionName, findEnclosingScope, isAsync, isInAsyncContext, isInsideConditionalBlock, } from './function-scope.js';
+export type { FunctionLikeNode } from './function-scope.js';
+export { getSharedSourceFile, walkNodes, getIdentifierName, getPropertyChain, getLineNumber, getColumn, isPropertyAccess, isLiteral, isInStringLiteral, findCallExpressions, findBinaryExpressions, findTemplateLiterals, isInComment, countUnescapedBackticks, } from './ast-utilities.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,EAAE,EAAE,CAAC;AAEd,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAKxE,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,OAAO,EACP,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+// TypeScript LanguageAdapter for opensip-cli
+// Re-export the TypeScript namespace as a first-class top-level export so the
+// barrel surface is the single source of truth for `ts` access. Done as a
+// namespace import + named export because `export * as ts from 'typescript'`
+// is invalid against typescript's `export =` shape.
+import * as ts from 'typescript';
+// eslint-disable-next-line unicorn/prefer-export-from -- `export * as from 'typescript'` is invalid (typescript uses `export =`); the namespace import + named export form is the only working shape
+export { ts };
+export { typescriptAdapter, adapters } from './adapter.js';
+export { parseSource } from './parse.js';
+export { typescriptQuery } from './query.js';
+export { stripStrings, stripComments } from './strip.js';
+export { filterContent } from './filter.js';
+export { discoverTypescriptWorkspaceUnits } from './workspace-units.js';
+// Function-scope helpers — extracted from `ast-utilities.ts` into a
+// concern-named module. New scope helpers go in `./function-scope.ts`,
+// NOT in `ast-utilities.ts`.
+export { findEnclosingFunction, findEnclosingFunctionBody, getEnclosingFunctionName, findEnclosingScope, isAsync, isInAsyncContext, isInsideConditionalBlock, } from './function-scope.js';
+// Canonical TS AST helpers — the compiler-API utilities check packs use.
+// Re-exported so TS checks import them from @opensip-cli/lang-typescript.
+// The `ts` re-export from this module is intentionally NOT re-surfaced here
+// (it now lives at the top of the barrel above).
+export { getSharedSourceFile, walkNodes, getIdentifierName, getPropertyChain, getLineNumber, getColumn, isPropertyAccess, isLiteral, isInStringLiteral, findCallExpressions, findBinaryExpressions, findTemplateLiterals, isInComment, countUnescapedBackticks, } from './ast-utilities.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,8EAA8E;AAC9E,0EAA0E;AAC1E,6EAA6E;AAC7E,oDAAoD;AACpD,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,qMAAqM;AACrM,OAAO,EAAE,EAAE,EAAE,CAAC;AAEd,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAExE,oEAAoE;AACpE,uEAAuE;AACvE,6BAA6B;AAC7B,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,OAAO,EACP,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,yEAAyE;AACzE,0EAA0E;AAC1E,4EAA4E;AAC5E,iDAAiD;AACjD,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,10 @@
+import ts from 'typescript';
+/**
+ * Parse TypeScript/JavaScript source into a SourceFile.
+ * Returns null on parse failure.
+ *
+ * Uses ts.ScriptKind.TSX so the same parse path handles .ts and .tsx
+ * (and is permissive enough for .js / .jsx).
+ */
+export declare function parseSource(content: string, filePath: string): ts.SourceFile | null;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,UAAU,GAAG,IAAI,CAanF"}

package/dist/parse.js

@@ -0,0 +1,19 @@
+import ts from 'typescript';
+/**
+ * Parse TypeScript/JavaScript source into a SourceFile.
+ * Returns null on parse failure.
+ *
+ * Uses ts.ScriptKind.TSX so the same parse path handles .ts and .tsx
+ * (and is permissive enough for .js / .jsx).
+ */
+export function parseSource(content, filePath) {
+    try {
+        return ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, 
+        /* setParentNodes */ true, ts.ScriptKind.TSX);
+    }
+    catch {
+        // @fitness-ignore-next-line error-handling-quality -- defensive parse-or-null helper; ts.createSourceFile is permissive (recovers from syntax errors) and effectively does not throw on real input, so caller's null-check is belt-and-suspenders.
+        return null;
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,QAAgB;IAC3D,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,gBAAgB,CACxB,QAAQ,EACR,OAAO,EACP,EAAE,CAAC,YAAY,CAAC,MAAM;QACtB,oBAAoB,CAAC,IAAI,EACzB,EAAE,CAAC,UAAU,CAAC,GAAG,CAClB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,mPAAmP;QACnP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,4 @@
+import ts from 'typescript';
+import type { LanguageQueryAPI } from '@opensip-cli/core/languages';
+export declare const typescriptQuery: LanguageQueryAPI<ts.SourceFile, ts.Node>;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,6BAA6B,CAAC;AAYrC,eAAO,MAAM,eAAe,EAAE,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CA4DpE,CAAC"}