@planu/cli 0.28.0 → 0.29.0

package/dist/engine/code-transforms/transform-engine.js

@@ -0,0 +1,67 @@
+// engine/code-transforms/transform-engine.ts — Transform orchestrator (AC-01).
+// Validates intent, dispatches to the correct transform implementation, measures timing.
+import { TRANSFORM_INTENTS, } from '../../types/index.js';
+import { renameSymbol } from './typescript/rename-symbol.js';
+import { addTypes } from './typescript/add-types.js';
+import { addErrorHandling } from './typescript/add-error-handling.js';
+import { modernizeSyntax } from './typescript/modernize-syntax.js';
+import { extractInterface } from './typescript/extract-interface.js';
+import { addJSDoc } from './typescript/add-jsdoc.js';
+/**
+ * Execute a code transform based on the request intent.
+ * Returns a TransformResult with the transformed source, changes list, and timing.
+ */
+export function executeTransform(request) {
+    const start = performance.now();
+    const fileName = request.fileName ?? 'input.ts';
+    // Validate intent
+    if (!TRANSFORM_INTENTS.includes(request.intent)) {
+        return {
+            success: false,
+            transformed: request.source,
+            changes: [],
+            durationMs: performance.now() - start,
+            error: `Unknown transform intent: '${request.intent}'. Valid intents: ${TRANSFORM_INTENTS.join(', ')}`,
+        };
+    }
+    try {
+        const result = dispatch(request.intent, request.source, request.options, fileName);
+        return {
+            success: true,
+            transformed: result.transformed,
+            changes: result.changes,
+            durationMs: performance.now() - start,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            transformed: request.source,
+            changes: [],
+            durationMs: performance.now() - start,
+            error: message,
+        };
+    }
+}
+function dispatch(intent, source, options, fileName) {
+    switch (intent) {
+        case 'rename-symbol':
+            return renameSymbol(source, options, fileName);
+        case 'add-types':
+            return addTypes(source, options, fileName);
+        case 'add-error-handling':
+            return addErrorHandling(source, options, fileName);
+        case 'modernize-syntax':
+            return modernizeSyntax(source, options, fileName);
+        case 'extract-interface':
+            return extractInterface(source, options, fileName);
+        case 'add-jsdoc':
+            return addJSDoc(source, options, fileName);
+        /* v8 ignore next 4 -- exhaustive check: unreachable thanks to TRANSFORM_INTENTS validation */
+        default: {
+            throw new Error(`Unhandled transform intent: ${String(intent)}`);
+        }
+    }
+}
+//# sourceMappingURL=transform-engine.js.map

package/dist/engine/code-transforms/transform-engine.js.map

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

package/dist/engine/code-transforms/typescript/add-error-handling.d.ts

@@ -0,0 +1,6 @@
+import type { AddErrorHandlingOptions, ErrorHandlingResult } from '../../../types/index.js';
+/**
+ * Add try/catch error handling to async functions.
+ */
+export declare function addErrorHandling(source: string, options: AddErrorHandlingOptions, fileName: string): ErrorHandlingResult;
+//# sourceMappingURL=add-error-handling.d.ts.map

package/dist/engine/code-transforms/typescript/add-error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-error-handling.d.ts","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/add-error-handling.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,uBAAuB,EAGvB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAoDjC;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,MAAM,GACf,mBAAmB,CAiDrB"}

package/dist/engine/code-transforms/typescript/add-error-handling.js

@@ -0,0 +1,92 @@
+// engine/code-transforms/typescript/add-error-handling.ts — (AC-04).
+// Wraps async function bodies with try/catch blocks.
+import { getTypeScript, parseSource, getLineNumber, createChange } from './ast-utils.js';
+function isAsyncFunction(ts, node) {
+    if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node) || ts.isArrowFunction(node)) {
+        const mods = ts.getModifiers(node);
+        return mods?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword) === true;
+    }
+    return false;
+}
+function getNodeName(ts, node, sourceFile) {
+    if ((ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) && node.name) {
+        return node.name.getText(sourceFile);
+    }
+    return '<anonymous>';
+}
+function buildCatchBlock(style, fnName) {
+    switch (style) {
+        case 'return-null':
+            return [
+                `catch (error: unknown) {`,
+                `    console.error('Error in ${fnName}:', error);`,
+                `    return null;`,
+                `  }`,
+            ].join('\n');
+        case 'log-and-rethrow':
+            return [
+                `catch (error: unknown) {`,
+                `    console.error('Error in ${fnName}:', error);`,
+                `    throw error;`,
+                `  }`,
+            ].join('\n');
+        default: // 'rethrow'
+            return [`catch (error: unknown) {`, `    throw error;`, `  }`].join('\n');
+    }
+}
+function hasExistingTryCatch(ts, body) {
+    for (const stmt of body.statements) {
+        if (ts.isTryStatement(stmt)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Add try/catch error handling to async functions.
+ */
+export function addErrorHandling(source, options, fileName) {
+    const ts = getTypeScript();
+    const sourceFile = parseSource(source, fileName);
+    const style = options.style ?? 'rethrow';
+    const targets = [];
+    function visit(node) {
+        if (isAsyncFunction(ts, node)) {
+            let body;
+            if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) {
+                body = node.body;
+            }
+            else if (ts.isArrowFunction(node) && ts.isBlock(node.body)) {
+                body = node.body;
+            }
+            if (body && !hasExistingTryCatch(ts, body)) {
+                const name = getNodeName(ts, node, sourceFile);
+                targets.push({
+                    name,
+                    bodyStart: body.getStart(sourceFile) + 1,
+                    bodyEnd: body.getEnd() - 1,
+                    line: getLineNumber(sourceFile, node.getStart(sourceFile)),
+                });
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    if (targets.length === 0) {
+        return { transformed: source, changes: [] };
+    }
+    // Apply in reverse order
+    targets.sort((a, b) => b.bodyStart - a.bodyStart);
+    let result = source;
+    const changes = [];
+    for (const target of targets) {
+        const innerBody = result.slice(target.bodyStart, target.bodyEnd);
+        const catchBlock = buildCatchBlock(style, target.name);
+        const wrapped = `\n  try {${innerBody}} ${catchBlock}\n`;
+        result = result.slice(0, target.bodyStart) + wrapped + result.slice(target.bodyEnd);
+        changes.push(createChange(target.line, `Wrapped '${target.name}' with try/catch (${style})`));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { transformed: result, changes };
+}
+//# sourceMappingURL=add-error-handling.js.map

package/dist/engine/code-transforms/typescript/add-error-handling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-error-handling.js","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/add-error-handling.ts"],"names":[],"mappings":"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"}

package/dist/engine/code-transforms/typescript/add-jsdoc.d.ts

@@ -0,0 +1,6 @@
+import type { AddJSDocOptions, AddJSDocResult } from '../../../types/index.js';
+/**
+ * Add JSDoc comments to functions and methods that don't have them.
+ */
+export declare function addJSDoc(source: string, options: AddJSDocOptions, fileName: string): AddJSDocResult;
+//# sourceMappingURL=add-jsdoc.d.ts.map

package/dist/engine/code-transforms/typescript/add-jsdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-jsdoc.d.ts","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/add-jsdoc.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAGf,cAAc,EACf,MAAM,yBAAyB,CAAC;AAwDjC;;GAEG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,GACf,cAAc,CAwChB"}

package/dist/engine/code-transforms/typescript/add-jsdoc.js

@@ -0,0 +1,83 @@
+// engine/code-transforms/typescript/add-jsdoc.ts — Add JSDoc comments (AC-07).
+// Generates JSDoc stubs with @param, @returns, @throws for functions.
+import { getTypeScript, parseSource, getLineNumber, createChange } from './ast-utils.js';
+function hasJSDoc(source, nodeStart) {
+    // Check if there is already a JSDoc comment before this node
+    const before = source.slice(Math.max(0, nodeStart - 200), nodeStart);
+    return before.trimEnd().endsWith('*/');
+}
+function bodyHasThrow(ts, body) {
+    if (ts.isThrowStatement(body)) {
+        return true;
+    }
+    let found = false;
+    ts.forEachChild(body, (child) => {
+        if (bodyHasThrow(ts, child)) {
+            found = true;
+        }
+    });
+    return found;
+}
+function buildJSDoc(ts, node, sourceFile, options) {
+    const lines = ['/**'];
+    /* v8 ignore next 1 -- FunctionDeclaration without name is extremely rare in valid TS */
+    const name = node.name ? node.name.getText(sourceFile) : 'anonymous';
+    lines.push(` * ${name}`);
+    if (options.includeParams !== false) {
+        for (const param of node.parameters) {
+            const pName = param.name.getText(sourceFile);
+            const pType = param.type ? param.type.getText(sourceFile) : 'unknown';
+            lines.push(` * @param {${pType}} ${pName}`);
+        }
+    }
+    if (options.includeReturns !== false && node.type) {
+        const retType = node.type.getText(sourceFile);
+        if (retType !== 'void') {
+            lines.push(` * @returns {${retType}}`);
+        }
+    }
+    if (options.includeThrows !== false && node.body && bodyHasThrow(ts, node.body)) {
+        lines.push(` * @throws {Error}`);
+    }
+    lines.push(' */');
+    return lines.join('\n');
+}
+/**
+ * Add JSDoc comments to functions and methods that don't have them.
+ */
+export function addJSDoc(source, options, fileName) {
+    const ts = getTypeScript();
+    const sourceFile = parseSource(source, fileName);
+    const insertions = [];
+    function visit(node) {
+        if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) {
+            const start = node.getStart(sourceFile);
+            if (!hasJSDoc(source, start) && node.name) {
+                const name = node.name.getText(sourceFile);
+                const doc = buildJSDoc(ts, node, sourceFile, options);
+                insertions.push({
+                    position: start,
+                    text: doc + '\n',
+                    line: getLineNumber(sourceFile, start),
+                    name,
+                });
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    if (insertions.length === 0) {
+        return { transformed: source, changes: [] };
+    }
+    // Apply in reverse order
+    insertions.sort((a, b) => b.position - a.position);
+    let result = source;
+    const changes = [];
+    for (const ins of insertions) {
+        result = result.slice(0, ins.position) + ins.text + result.slice(ins.position);
+        changes.push(createChange(ins.line, `Added JSDoc to '${ins.name}'`));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { transformed: result, changes };
+}
+//# sourceMappingURL=add-jsdoc.js.map

package/dist/engine/code-transforms/typescript/add-jsdoc.js.map

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

package/dist/engine/code-transforms/typescript/add-types.d.ts

@@ -0,0 +1,3 @@
+import type { AddTypesOptions, AddTypesResult } from '../../../types/index.js';
+export declare function addTypes(source: string, _options: AddTypesOptions, fileName: string): AddTypesResult;
+//# sourceMappingURL=add-types.d.ts.map

package/dist/engine/code-transforms/typescript/add-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-types.d.ts","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/add-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAGf,cAAc,EACf,MAAM,yBAAyB,CAAC;AA0LjC,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,GACf,cAAc,CAwBhB"}

package/dist/engine/code-transforms/typescript/add-types.js

@@ -0,0 +1,182 @@
+// engine/code-transforms/typescript/add-types.ts — Add types transform (AC-03).
+// Infers types from initializers and adds type annotations.
+import { getTypeScript, parseSource, getLineNumber, createChange } from './ast-utils.js';
+// ---------------------------------------------------------------------------
+// Type inference from initializer
+// ---------------------------------------------------------------------------
+function inferTypeFromInit(ts, init) {
+    if (ts.isStringLiteral(init) || ts.isNoSubstitutionTemplateLiteral(init)) {
+        return 'string';
+    }
+    if (ts.isNumericLiteral(init)) {
+        return 'number';
+    }
+    if (init.kind === ts.SyntaxKind.TrueKeyword || init.kind === ts.SyntaxKind.FalseKeyword) {
+        return 'boolean';
+    }
+    if (init.kind === ts.SyntaxKind.NullKeyword) {
+        return 'null';
+    }
+    /* v8 ignore start -- UndefinedKeyword is rarely emitted; TS parses `undefined` as Identifier */
+    if (init.kind === ts.SyntaxKind.UndefinedKeyword) {
+        return 'undefined';
+    }
+    /* v8 ignore stop */
+    if (ts.isArrayLiteralExpression(init)) {
+        return inferArrayType(ts, init);
+    }
+    if (ts.isObjectLiteralExpression(init)) {
+        return 'Record<string, unknown>';
+    }
+    return undefined;
+}
+function inferArrayType(ts, arr) {
+    if (arr.elements.length === 0) {
+        return 'unknown[]';
+    }
+    const first = arr.elements[0];
+    /* v8 ignore start -- defensive: elements[0] always exists when length > 0 */
+    if (!first) {
+        return 'unknown[]';
+    }
+    /* v8 ignore stop */
+    const elemType = inferTypeFromInit(ts, first);
+    return elemType ? `${elemType}[]` : 'unknown[]';
+}
+// ---------------------------------------------------------------------------
+// Collect replacements from variable declarations
+// ---------------------------------------------------------------------------
+function collectVariableTypes(ts, sourceFile, replacements) {
+    function visit(node) {
+        if (ts.isVariableDeclaration(node) && !node.type && node.initializer) {
+            const inferred = inferTypeFromInit(ts, node.initializer);
+            if (inferred) {
+                const nameEnd = node.name.getEnd();
+                replacements.push({
+                    position: nameEnd,
+                    length: 0,
+                    newText: `: ${inferred}`,
+                    line: getLineNumber(sourceFile, node.getStart(sourceFile)),
+                    description: `Added type annotation ': ${inferred}' to variable '${node.name.getText(sourceFile)}'`,
+                });
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+}
+// ---------------------------------------------------------------------------
+// Collect replacements from function return types
+// ---------------------------------------------------------------------------
+function inferReturnType(ts, body) {
+    let foundType;
+    for (const stmt of body.statements) {
+        if (ts.isReturnStatement(stmt) && stmt.expression) {
+            const t = inferTypeFromInit(ts, stmt.expression);
+            if (t && !foundType) {
+                foundType = t;
+            }
+            else if (t && foundType && t !== foundType) {
+                return undefined; // mixed return types
+            }
+        }
+    }
+    return foundType;
+}
+function findClosingParen(source, startPos) {
+    let depth = 0;
+    for (let i = startPos; i < source.length; i++) {
+        const ch = source[i];
+        if (ch === '(') {
+            depth++;
+        }
+        if (ch === ')') {
+            depth--;
+            if (depth === 0) {
+                return i;
+            }
+        }
+    }
+    /* v8 ignore next 1 */
+    return -1;
+}
+function collectFunctionReturnTypes(ts, sourceFile, source, replacements) {
+    function visit(node) {
+        if ((ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) &&
+            !node.type &&
+            node.body) {
+            const retType = inferReturnType(ts, node.body);
+            if (retType) {
+                const parenPos = findClosingParen(source, node.getStart(sourceFile));
+                /* v8 ignore start -- defensive: findClosingParen always succeeds for valid function decls */
+                if (parenPos > 0) {
+                    /* v8 ignore stop */
+                    const insertPos = parenPos + 1;
+                    /* v8 ignore start -- FunctionDeclaration without name is extremely rare */
+                    const name = node.name ? node.name.getText(sourceFile) : '<anonymous>';
+                    /* v8 ignore stop */
+                    replacements.push({
+                        position: insertPos,
+                        length: 0,
+                        newText: `: ${retType}`,
+                        line: getLineNumber(sourceFile, node.getStart(sourceFile)),
+                        description: `Added return type ': ${retType}' to function '${name}'`,
+                    });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+}
+// ---------------------------------------------------------------------------
+// Collect replacements from function parameters
+// ---------------------------------------------------------------------------
+function collectParameterTypes(ts, sourceFile, replacements) {
+    function visit(node) {
+        if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) {
+            for (const param of node.parameters) {
+                if (!param.type && param.initializer) {
+                    const inferred = inferTypeFromInit(ts, param.initializer);
+                    if (inferred) {
+                        const nameEnd = param.name.getEnd();
+                        replacements.push({
+                            position: nameEnd,
+                            length: 0,
+                            newText: `: ${inferred}`,
+                            line: getLineNumber(sourceFile, param.getStart(sourceFile)),
+                            description: `Added type ': ${inferred}' to parameter '${param.name.getText(sourceFile)}'`,
+                        });
+                    }
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+export function addTypes(source, _options, fileName) {
+    const ts = getTypeScript();
+    const sourceFile = parseSource(source, fileName);
+    const replacements = [];
+    collectVariableTypes(ts, sourceFile, replacements);
+    collectFunctionReturnTypes(ts, sourceFile, source, replacements);
+    collectParameterTypes(ts, sourceFile, replacements);
+    if (replacements.length === 0) {
+        return { transformed: source, changes: [] };
+    }
+    // Apply in reverse position order
+    replacements.sort((a, b) => b.position - a.position);
+    let result = source;
+    const changes = [];
+    for (const rep of replacements) {
+        result = result.slice(0, rep.position) + rep.newText + result.slice(rep.position + rep.length);
+        changes.push(createChange(rep.line, rep.description));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { transformed: result, changes };
+}
+//# sourceMappingURL=add-types.js.map

package/dist/engine/code-transforms/typescript/add-types.js.map

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

package/dist/engine/code-transforms/typescript/ast-utils.d.ts

@@ -0,0 +1,38 @@
+import type TSModule from 'typescript';
+/**
+ * Lazy-load the TypeScript compiler API. Caches after first call.
+ * Throws if `typescript` is not installed as a peer dependency.
+ */
+export declare function getTypeScript(): typeof TSModule;
+/** Reset the TS cache — used in tests. */
+export declare function resetTypeScriptCache(): void;
+/**
+ * Parse source code into a TS SourceFile AST node.
+ */
+export declare function parseSource(source: string, fileName: string): TSModule.SourceFile;
+/**
+ * Pretty-print a SourceFile AST back to string.
+ */
+export declare function printSource(sourceFile: TSModule.SourceFile): string;
+/**
+ * Find all AST nodes of a given SyntaxKind in a source file.
+ */
+export declare function findNodes(sourceFile: TSModule.SourceFile, kind: TSModule.SyntaxKind): TSModule.Node[];
+/**
+ * Get 1-based line number for a position in the source file.
+ */
+export declare function getLineNumber(sourceFile: TSModule.SourceFile, pos: number): number;
+/**
+ * Create a change record for reporting.
+ */
+export declare function createChange(line: number, description: string): {
+    line: number;
+    description: string;
+};
+/**
+ * Apply a text replacement at a specific range in the source string.
+ * Replacements must be applied in reverse order (highest position first)
+ * to keep earlier positions valid.
+ */
+export declare function replaceRange(source: string, start: number, end: number, replacement: string): string;
+//# sourceMappingURL=ast-utils.d.ts.map

package/dist/engine/code-transforms/typescript/ast-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-utils.d.ts","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/ast-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAQvC;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,QAAQ,CAa/C;AAED,0CAA0C;AAC1C,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,UAAU,CAGjF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,GAAG,MAAM,CAInE;AAMD;;GAEG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,QAAQ,CAAC,UAAU,EAC/B,IAAI,EAAE,QAAQ,CAAC,UAAU,GACxB,QAAQ,CAAC,IAAI,EAAE,CAajB;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAElF;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,MAAM,CAER"}

package/dist/engine/code-transforms/typescript/ast-utils.js

@@ -0,0 +1,90 @@
+// engine/code-transforms/typescript/ast-utils.ts — Shared AST utilities (AC-08).
+// Lazy-loads TypeScript compiler API and provides common helpers.
+// ---------------------------------------------------------------------------
+// Lazy TypeScript loader with cache
+// ---------------------------------------------------------------------------
+let tsCache;
+/**
+ * Lazy-load the TypeScript compiler API. Caches after first call.
+ * Throws if `typescript` is not installed as a peer dependency.
+ */
+export function getTypeScript() {
+    if (tsCache) {
+        return tsCache;
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        tsCache = require('typescript');
+        return tsCache;
+    }
+    catch {
+        throw new Error('TypeScript compiler API not available. Install typescript as a peer dependency.');
+    }
+}
+/** Reset the TS cache — used in tests. */
+export function resetTypeScriptCache() {
+    tsCache = undefined;
+}
+// ---------------------------------------------------------------------------
+// Parse / print helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parse source code into a TS SourceFile AST node.
+ */
+export function parseSource(source, fileName) {
+    const ts = getTypeScript();
+    return ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true);
+}
+/**
+ * Pretty-print a SourceFile AST back to string.
+ */
+export function printSource(sourceFile) {
+    const ts = getTypeScript();
+    const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
+    return printer.printFile(sourceFile);
+}
+// ---------------------------------------------------------------------------
+// AST traversal
+// ---------------------------------------------------------------------------
+/**
+ * Find all AST nodes of a given SyntaxKind in a source file.
+ */
+export function findNodes(sourceFile, kind) {
+    const ts = getTypeScript();
+    const results = [];
+    function visit(node) {
+        if (node.kind === kind) {
+            results.push(node);
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Position helpers
+// ---------------------------------------------------------------------------
+/**
+ * Get 1-based line number for a position in the source file.
+ */
+export function getLineNumber(sourceFile, pos) {
+    return sourceFile.getLineAndCharacterOfPosition(pos).line + 1;
+}
+// ---------------------------------------------------------------------------
+// Text replacement helper
+// ---------------------------------------------------------------------------
+/**
+ * Create a change record for reporting.
+ */
+export function createChange(line, description) {
+    return { line, description };
+}
+/**
+ * Apply a text replacement at a specific range in the source string.
+ * Replacements must be applied in reverse order (highest position first)
+ * to keep earlier positions valid.
+ */
+export function replaceRange(source, start, end, replacement) {
+    return source.slice(0, start) + replacement + source.slice(end);
+}
+//# sourceMappingURL=ast-utils.js.map

package/dist/engine/code-transforms/typescript/ast-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-utils.js","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/ast-utils.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kEAAkE;AAIlE,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAE9E,IAAI,OAAoC,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC;QACH,iEAAiE;QACjE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAoB,CAAC;QACnD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,oBAAoB;IAClC,OAAO,GAAG,SAAS,CAAC;AACtB,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,QAAgB;IAC1D,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,UAA+B;IACzD,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvE,OAAO,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,UAA+B,EAC/B,IAAyB;IAEzB,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,SAAS,KAAK,CAAC,IAAmB;QAChC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,UAA+B,EAAE,GAAW;IACxE,OAAO,UAAU,CAAC,6BAA6B,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,WAAmB;IAEnB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,KAAa,EACb,GAAW,EACX,WAAmB;IAEnB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAClE,CAAC"}

package/dist/engine/code-transforms/typescript/extract-interface.d.ts

@@ -0,0 +1,6 @@
+import type { ExtractInterfaceOptions, ExtractResult } from '../../../types/index.js';
+/**
+ * Extract an interface from a class declaration.
+ */
+export declare function extractInterface(source: string, options: ExtractInterfaceOptions, fileName: string): ExtractResult;
+//# sourceMappingURL=extract-interface.d.ts.map

package/dist/engine/code-transforms/typescript/extract-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-interface.d.ts","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/extract-interface.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,uBAAuB,EAEvB,aAAa,EAEd,MAAM,yBAAyB,CAAC;AAyEjC;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,MAAM,GACf,aAAa,CA0Df"}