@kernlang/codemod 3.3.4

package/dist/adapter-registry.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Adapter registry — keyed by TemplateMatch.templateName.
+ *
+ * Adapters are registered up-front (see adapters/index.ts). A future public
+ * API could expose `register()` for external adapters; for MVP the set is
+ * fixed and shipped with the package.
+ */
+import type { TemplateAdapter } from './types.js';
+export declare function registerAdapter(adapter: TemplateAdapter): void;
+export declare function getAdapter(templateName: string): TemplateAdapter | undefined;
+export declare function listAdapters(): TemplateAdapter[];
+export declare function hasAdapter(templateName: string): boolean;

package/dist/adapter-registry.js

@@ -0,0 +1,21 @@
+/**
+ * Adapter registry — keyed by TemplateMatch.templateName.
+ *
+ * Adapters are registered up-front (see adapters/index.ts). A future public
+ * API could expose `register()` for external adapters; for MVP the set is
+ * fixed and shipped with the package.
+ */
+const registry = new Map();
+export function registerAdapter(adapter) {
+    registry.set(adapter.templateName, adapter);
+}
+export function getAdapter(templateName) {
+    return registry.get(templateName);
+}
+export function listAdapters() {
+    return Array.from(registry.values());
+}
+export function hasAdapter(templateName) {
+    return registry.has(templateName);
+}
+//# sourceMappingURL=adapter-registry.js.map

package/dist/adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.js","sourceRoot":"","sources":["../src/adapter-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEpD,MAAM,UAAU,eAAe,CAAC,OAAwB;IACtD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,OAAO,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,OAAO,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,2 @@
+import { zustandStoreAdapter } from './zustand-store.js';
+export { zustandStoreAdapter };

package/dist/adapters/index.js

@@ -0,0 +1,5 @@
+import { registerAdapter } from '../adapter-registry.js';
+import { zustandStoreAdapter } from './zustand-store.js';
+registerAdapter(zustandStoreAdapter);
+export { zustandStoreAdapter };
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,eAAe,CAAC,mBAAmB,CAAC,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/adapters/zustand-store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Zustand store adapter.
+ *
+ * Resolves and rewrites:
+ *   export const useXStore = create<State>((set, get) => ({ ... }));
+ *   export const useXStore = create<State>()((set, get) => ({ ... }));
+ *
+ * Fails closed on: aliased `create` imports, non-object returns, spread
+ * elements, computed property keys, type-annotated actions where the declared
+ * type diverges from the implementation, multiple zustand stores in one file,
+ * and non-`create` calls.
+ */
+import type { TemplateAdapter } from '../types.js';
+export declare const zustandStoreAdapter: TemplateAdapter;

package/dist/adapters/zustand-store.js

@@ -0,0 +1,261 @@
+/**
+ * Zustand store adapter.
+ *
+ * Resolves and rewrites:
+ *   export const useXStore = create<State>((set, get) => ({ ... }));
+ *   export const useXStore = create<State>()((set, get) => ({ ... }));
+ *
+ * Fails closed on: aliased `create` imports, non-object returns, spread
+ * elements, computed property keys, type-annotated actions where the declared
+ * type diverges from the implementation, multiple zustand stores in one file,
+ * and non-`create` calls.
+ */
+import { SyntaxKind, } from 'ts-morph';
+const ZUSTAND_MODULE = 'zustand';
+const CREATE_NAME = 'create';
+function hasUnaliasedCreateImport(sourceFile) {
+    for (const imp of sourceFile.getImportDeclarations()) {
+        if (imp.getModuleSpecifierValue() !== ZUSTAND_MODULE)
+            continue;
+        for (const named of imp.getNamedImports()) {
+            if (named.getName() !== CREATE_NAME)
+                continue;
+            // Fail closed on aliased import: `import { create as foo } from 'zustand'`
+            const alias = named.getAliasNode();
+            if (alias && alias.getText() !== CREATE_NAME)
+                return false;
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns the CallExpression that looks like `create<T>(...)` or `create<T>()(...)`.
+ * For the curried form, returns the OUTER call (the one whose callee is `create`)
+ * because that's where `stateType` lives, and we still need to descend into the
+ * inner call to find the object literal.
+ */
+function findCreateCall(node) {
+    if (!node)
+        return undefined;
+    if (node.isKind(SyntaxKind.CallExpression)) {
+        const call = node.asKindOrThrow(SyntaxKind.CallExpression);
+        const expr = call.getExpression();
+        // Direct: create<T>(...)
+        if (expr.isKind(SyntaxKind.Identifier) && expr.getText() === CREATE_NAME) {
+            return call;
+        }
+        // Curried: create<T>()(...) — outer call's callee is itself a CallExpression
+        // whose callee is the `create` identifier.
+        if (expr.isKind(SyntaxKind.CallExpression)) {
+            const inner = expr.asKindOrThrow(SyntaxKind.CallExpression);
+            const innerExpr = inner.getExpression();
+            if (innerExpr.isKind(SyntaxKind.Identifier) && innerExpr.getText() === CREATE_NAME) {
+                return inner; // Return the inner `create<T>()` — outer call is the factory invocation
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Follow a create<T>(...) call to the ObjectLiteralExpression returned by its
+ * state initializer. Handles:
+ *   create<T>((set, get) => ({ ... }))        — direct arrow returning obj literal
+ *   create<T>()((set, get) => ({ ... }))      — curried factory
+ *   create<T>()((set) => { return { ... }; }) — arrow with block body
+ */
+function findStateObjectLiteral(createCall) {
+    // Determine the actual state-initializer call.
+    // For curried form, the parent of createCall is a CallExpression whose arguments
+    // hold the arrow fn. For direct form, createCall itself has the arguments.
+    const parent = createCall.getParent();
+    let argsCall;
+    if (parent?.isKind(SyntaxKind.CallExpression)) {
+        const parentCall = parent.asKindOrThrow(SyntaxKind.CallExpression);
+        if (parentCall.getExpression() === createCall) {
+            // Curried: parent call holds the arrow fn
+            argsCall = parentCall;
+        }
+        else {
+            argsCall = createCall;
+        }
+    }
+    else {
+        argsCall = createCall;
+    }
+    const args = argsCall.getArguments();
+    if (args.length === 0)
+        return undefined;
+    const first = args[0];
+    let body;
+    if (first.isKind(SyntaxKind.ArrowFunction)) {
+        body = first.getBody();
+    }
+    else if (first.isKind(SyntaxKind.FunctionExpression)) {
+        body = first.getBody();
+    }
+    else {
+        return undefined;
+    }
+    if (!body)
+        return undefined;
+    // Body can be a direct ObjectLiteralExpression (arrow returning object literal
+    // via parenthesized expression: `=> ({...})`) or a block statement that
+    // returns an object literal.
+    if (body.isKind(SyntaxKind.ObjectLiteralExpression)) {
+        return body.asKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+    }
+    if (body.isKind(SyntaxKind.ParenthesizedExpression)) {
+        const inner = body.asKindOrThrow(SyntaxKind.ParenthesizedExpression).getExpression();
+        if (inner.isKind(SyntaxKind.ObjectLiteralExpression)) {
+            return inner.asKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+        }
+    }
+    if (body.isKind(SyntaxKind.Block)) {
+        const block = body.asKindOrThrow(SyntaxKind.Block);
+        const stmts = block.getStatements();
+        if (stmts.length !== 1)
+            return undefined;
+        const only = stmts[0];
+        if (!only.isKind(SyntaxKind.ReturnStatement))
+            return undefined;
+        const retExpr = only.asKindOrThrow(SyntaxKind.ReturnStatement).getExpression();
+        if (retExpr?.isKind(SyntaxKind.ObjectLiteralExpression)) {
+            return retExpr.asKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+        }
+        if (retExpr?.isKind(SyntaxKind.ParenthesizedExpression)) {
+            const inner = retExpr.asKindOrThrow(SyntaxKind.ParenthesizedExpression).getExpression();
+            if (inner.isKind(SyntaxKind.ObjectLiteralExpression)) {
+                return inner.asKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+            }
+        }
+    }
+    return undefined;
+}
+function findOwningVariableStatement(call) {
+    let cur = call;
+    while (cur) {
+        if (cur.isKind(SyntaxKind.VariableStatement)) {
+            return cur.asKindOrThrow(SyntaxKind.VariableStatement);
+        }
+        cur = cur.getParent();
+    }
+    return undefined;
+}
+function countCreateCalls(sourceFile) {
+    let count = 0;
+    for (const call of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+        const createCall = findCreateCall(call);
+        if (createCall === call)
+            count++;
+    }
+    return count;
+}
+export const zustandStoreAdapter = {
+    templateName: 'zustand-store',
+    resolveRegion(sourceFile, _match) {
+        if (!hasUnaliasedCreateImport(sourceFile)) {
+            return { ok: false, reason: 'zustand `create` is missing or aliased' };
+        }
+        // Reject files with multiple zustand stores to avoid ambiguity on which to rewrite.
+        if (countCreateCalls(sourceFile) > 1) {
+            return { ok: false, reason: 'multiple zustand stores in file' };
+        }
+        // Find the one create call and walk up to its VariableStatement.
+        let createCall;
+        for (const call of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+            const found = findCreateCall(call);
+            if (found === call) {
+                createCall = call;
+                break;
+            }
+        }
+        if (!createCall) {
+            return { ok: false, reason: 'no create<T>(...) call found' };
+        }
+        const varStmt = findOwningVariableStatement(createCall);
+        if (!varStmt) {
+            return { ok: false, reason: 'create call is not inside a variable declaration' };
+        }
+        // Sanity check: exactly one declaration, and its initializer transitively contains our call.
+        const decls = varStmt.getDeclarations();
+        if (decls.length !== 1) {
+            return { ok: false, reason: 'multi-declarator variable statement' };
+        }
+        return {
+            ok: true,
+            region: {
+                start: varStmt.getStart(),
+                end: varStmt.getEnd(),
+                label: `VariableStatement@L${varStmt.getStartLineNumber()}`,
+            },
+        };
+    },
+    extractChildren(sourceFile, _region, _match) {
+        // Re-resolve the create call — the region only gives us offsets, not the node.
+        let createCall;
+        for (const call of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+            const found = findCreateCall(call);
+            if (found === call) {
+                createCall = call;
+                break;
+            }
+        }
+        if (!createCall) {
+            return { ok: false, reason: 'create call disappeared during extract' };
+        }
+        const objLit = findStateObjectLiteral(createCall);
+        if (!objLit) {
+            return { ok: false, reason: 'state initializer is not an object literal' };
+        }
+        const properties = objLit.getProperties();
+        if (properties.length === 0) {
+            return { ok: true, children: [] };
+        }
+        const childLines = [];
+        for (const prop of properties) {
+            // Fail closed on anything that isn't a plain PropertyAssignment or ShorthandPropertyAssignment.
+            if (prop.isKind(SyntaxKind.SpreadAssignment)) {
+                return { ok: false, reason: 'spread in state initializer' };
+            }
+            if (prop.isKind(SyntaxKind.GetAccessor) || prop.isKind(SyntaxKind.SetAccessor)) {
+                return { ok: false, reason: 'accessor in state initializer' };
+            }
+            if (prop.isKind(SyntaxKind.MethodDeclaration)) {
+                // Method shorthand — emit as-is.
+                childLines.push(prop.getText());
+                continue;
+            }
+            if (prop.isKind(SyntaxKind.ShorthandPropertyAssignment)) {
+                childLines.push(prop.getText());
+                continue;
+            }
+            if (prop.isKind(SyntaxKind.PropertyAssignment)) {
+                const assignment = prop.asKindOrThrow(SyntaxKind.PropertyAssignment);
+                const nameNode = assignment.getNameNode();
+                // Reject computed keys like [Symbol.iterator] or [dynamicKey].
+                if (nameNode.isKind(SyntaxKind.ComputedPropertyName)) {
+                    return { ok: false, reason: 'computed property key in state initializer' };
+                }
+                childLines.push(prop.getText());
+                continue;
+            }
+            return {
+                ok: false,
+                reason: `unsupported property kind: ${prop.getKindName()}`,
+            };
+        }
+        // Append commas between lines to preserve object-literal syntax when re-emitted
+        // inside the template's `({ {{CHILDREN}} })`.
+        const withCommas = childLines.map((line, i) => {
+            const needsComma = i < childLines.length - 1 || !line.trimEnd().endsWith(',');
+            if (!needsComma)
+                return line;
+            if (line.trimEnd().endsWith(','))
+                return line;
+            return `${line},`;
+        });
+        return { ok: true, children: withCommas };
+    },
+};
+//# sourceMappingURL=zustand-store.js.map

package/dist/adapters/zustand-store.js.map

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

package/dist/apply-files.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Batch driver — apply codemod across one or more files.
+ *
+ * Responsibilities:
+ *   - Load the shared ts-morph Project once.
+ *   - For each file: ensure it's in the Project, detect templates, and run
+ *     applyMatch for every candidate above the confidence threshold.
+ *   - Emit one audit entry per decision.
+ *
+ * The driver does not own --interactive prompting; the CLI layer wraps around
+ * this and streams decisions to the user.
+ */
+import type { ApplyOptions, ApplyResult } from './types.js';
+import './adapters/index.js';
+export interface ApplyFilesResult {
+    results: ApplyResult[];
+    auditPath: string;
+}
+export declare function applyFiles(filePaths: string[], options?: ApplyOptions): ApplyFilesResult;

package/dist/apply-files.js

@@ -0,0 +1,60 @@
+/**
+ * Batch driver — apply codemod across one or more files.
+ *
+ * Responsibilities:
+ *   - Load the shared ts-morph Project once.
+ *   - For each file: ensure it's in the Project, detect templates, and run
+ *     applyMatch for every candidate above the confidence threshold.
+ *   - Emit one audit entry per decision.
+ *
+ * The driver does not own --interactive prompting; the CLI layer wraps around
+ * this and streams decisions to the user.
+ */
+import { detectTemplates } from '@kernlang/review';
+import { resolve } from 'path';
+import { applyMatch } from './apply.js';
+import { defaultAuditPath, writeAuditEntry } from './audit.js';
+import { snapshotAffectedSet } from './diagnostics.js';
+import { loadHostProject } from './project.js';
+// Register built-in adapters via side-effect import.
+import './adapters/index.js';
+export function applyFiles(filePaths, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const auditPath = options.auditPath ?? defaultAuditPath(cwd);
+    const project = loadHostProject({ cwd });
+    const results = [];
+    for (const input of filePaths) {
+        const absPath = resolve(cwd, input);
+        let sourceFile = project.getSourceFile(absPath);
+        if (!sourceFile) {
+            try {
+                sourceFile = project.addSourceFileAtPath(absPath);
+            }
+            catch (err) {
+                const result = {
+                    filePath: absPath,
+                    templateName: '<unknown>',
+                    confidencePct: 0,
+                    decision: 'skipped',
+                    reason: `could not add to Project: ${err.message}`,
+                    timestamp: new Date().toISOString(),
+                };
+                writeAuditEntry(auditPath, result);
+                results.push(result);
+                continue;
+            }
+        }
+        const matches = detectTemplates(sourceFile);
+        if (matches.length === 0)
+            continue;
+        // Snapshot affected-set once per file so every candidate shares the baseline.
+        const preDiagnostics = snapshotAffectedSet(project, sourceFile);
+        for (const match of matches) {
+            const result = applyMatch({ project, filePath: absPath, match, preDiagnostics }, options);
+            writeAuditEntry(auditPath, result);
+            results.push(result);
+        }
+    }
+    return { results, auditPath };
+}
+//# sourceMappingURL=apply-files.js.map

package/dist/apply-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-files.js","sourceRoot":"","sources":["../src/apply-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,qDAAqD;AACrD,OAAO,qBAAqB,CAAC;AAO7B,MAAM,UAAU,UAAU,CAAC,SAAmB,EAAE,UAAwB,EAAE;IACxE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,IAAI,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAgB;oBAC1B,QAAQ,EAAE,OAAO;oBACjB,YAAY,EAAE,WAAW;oBACzB,aAAa,EAAE,CAAC;oBAChB,QAAQ,EAAE,SAAS;oBACnB,MAAM,EAAE,6BAA8B,GAAa,CAAC,OAAO,EAAE;oBAC7D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC;gBACF,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEnC,8EAA8E;QAC9E,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEhE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;YAC1F,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC"}

package/dist/apply.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Apply orchestrator — turn a TemplateMatch into a transformed source file.
+ *
+ * Pipeline:
+ *   1. Adapter resolves the exact rewrite region (re-derived from AST; detector
+ *      reports endLine=EOF which we ignore).
+ *   2. Adapter extracts the user interior as CHILDREN lines.
+ *   3. Parse match.suggestedKern into an IR node and register the named
+ *      template if it isn't already.
+ *   4. Attach a `handler` child carrying the extracted CHILDREN.
+ *   5. expandTemplateNode → generateCoreNode-style line array.
+ *   6. Strip template-prepended imports (source file already imports them).
+ *   7. Splice new text into source at [region.start, region.end] (no comment
+ *      duplication — `before` already contains any leading trivia).
+ *   8. Mutate the original SourceFile IN-PLACE with replaceWithText so that
+ *      downstream consumers see the transformed module when diagnostics run,
+ *      then revert if any gate fails.
+ *   9. Reparse check (syntax), re-detect gate (template still recognized),
+ *      affected-set diagnostics gate, whole-program gate (--write only).
+ *  10. Write audit entry and return ApplyResult.
+ *
+ * The shared ts-morph Project is the caller's responsibility (see project.ts)
+ * so affected-set diagnostics amortize across --interactive sessions.
+ */
+import { type TemplateMatch } from '@kernlang/review';
+import type { Project } from 'ts-morph';
+import type { ApplyOptions, ApplyResult } from './types.js';
+export interface ApplyFileInput {
+    project: Project;
+    /** Absolute path to the file being transformed (must already be in Project). */
+    filePath: string;
+    /** One TemplateMatch candidate from detectTemplates(). */
+    match: TemplateMatch;
+    /** Pre-computed file-level diagnostics snapshot (perf: avoids re-walking). */
+    preDiagnostics?: ReadonlyArray<string>;
+}
+export declare function applyMatch(input: ApplyFileInput, options?: ApplyOptions): ApplyResult;