phantom-build 0.1.0

package/dist/extract/import-resolver.js

@@ -0,0 +1,51 @@
+import { resolve, dirname } from 'node:path';
+/**
+ * Resolve what the extracted segment needs: imports vs captured variables.
+ *
+ * ClassifiedSegment.dependencies merges fn.captured + fn.imported.
+ * We recover the split by matching back to the FunctionDependency via span,
+ * then cross-reference imported names against AnalyzedModule.imports.
+ *
+ * Relative import paths (./foo, ../bar) are rewritten to absolute paths
+ * so that chunk virtual modules (which have no filesystem location) can
+ * resolve their dependencies correctly.
+ */
+export function resolveImports(segment, analyzed, sourceFilePath) {
+    const fnDep = analyzed.functions.find((fn) => fn.span.start === segment.span.start && fn.span.end === segment.span.end);
+    if (!fnDep) {
+        return { imports: [], capturedParams: segment.dependencies };
+    }
+    const capturedParams = fnDep.captured;
+    const importedNames = new Set(fnDep.imported);
+    // Group needed imports by source module
+    const importMap = new Map();
+    const sourceDir = dirname(sourceFilePath);
+    for (const imp of analyzed.imports) {
+        for (const spec of imp.specifiers) {
+            if (importedNames.has(spec.local)) {
+                // Rewrite relative imports to absolute paths for virtual module resolution
+                const resolvedSource = isRelativeImport(imp.source)
+                    ? resolve(sourceDir, imp.source)
+                    : imp.source;
+                let entry = importMap.get(resolvedSource);
+                if (!entry) {
+                    entry = { source: resolvedSource, specifiers: [] };
+                    importMap.set(resolvedSource, entry);
+                }
+                entry.specifiers.push(spec);
+            }
+        }
+    }
+    return {
+        imports: Array.from(importMap.values()),
+        capturedParams,
+    };
+}
+/**
+ * Check if an import specifier is a relative path (./foo or ../bar).
+ * Bare specifiers like 'react' or '@org/pkg' are NOT relative.
+ */
+function isRelativeImport(source) {
+    return source.startsWith('./') || source.startsWith('../');
+}
+//# sourceMappingURL=import-resolver.js.map

package/dist/extract/import-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-resolver.js","sourceRoot":"","sources":["../../src/extract/import-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAU7C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA0B,EAC1B,QAAwB,EACxB,cAAsB;IAEtB,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CACnC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,CACjF,CAAC;IAEF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC;IACtC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE9C,wCAAwC;IACxC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClC,2EAA2E;gBAC3E,MAAM,cAAc,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC;oBACjD,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC;oBAChC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;gBAEf,IAAI,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,KAAK,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;oBACnD,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;gBACvC,CAAC;gBACD,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACvC,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,MAAc;IACtC,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC"}

package/dist/extract/index.d.ts

@@ -0,0 +1,20 @@
+import type { AnalyzedModule, ClassifiedSegment, LazyCandidate, SourceMapLike } from '../types.js';
+export interface ExtractionResult {
+    clientCode: string;
+    clientMap: SourceMapLike;
+    chunkModules: Array<{
+        id: string;
+        code: string;
+        map: SourceMapLike;
+    }>;
+}
+/**
+ * Extract EventHandler segments from a module into lazy-loaded chunks.
+ *
+ * Returns null if no segments qualify for extraction,
+ * otherwise returns rewritten client code + chunk modules.
+ *
+ * Uses proper AST-based codegen with esrap — no source text splicing.
+ */
+export declare function extractModule(analyzed: AnalyzedModule, segments: ClassifiedSegment[], _sourceCode: string, confidenceThreshold: number, sourceFilePath: string, lazyCandidates?: LazyCandidate[]): ExtractionResult | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/extract/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extract/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMnG,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;CACvE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,EAC3B,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,aAAa,EAAE,GAC/B,gBAAgB,GAAG,IAAI,CA6EzB"}

package/dist/extract/index.js

@@ -0,0 +1,105 @@
+import { print } from 'esrap';
+import tsx from 'esrap/languages/tsx';
+import { resolveImports } from './import-resolver.js';
+import { generateChunkModule } from './chunk-module.js';
+import { replaceWithStub } from './client-stub.js';
+import { applyLazyTransforms } from './lazy-transform.js';
+/**
+ * Extract EventHandler segments from a module into lazy-loaded chunks.
+ *
+ * Returns null if no segments qualify for extraction,
+ * otherwise returns rewritten client code + chunk modules.
+ *
+ * Uses proper AST-based codegen with esrap — no source text splicing.
+ */
+export function extractModule(analyzed, segments, _sourceCode, confidenceThreshold, sourceFilePath, lazyCandidates) {
+    const extractable = segments.filter((seg) => seg.classification === 'EventHandler' &&
+        seg.confidence >= confidenceThreshold);
+    const hasLazyTransforms = lazyCandidates && lazyCandidates.length > 0;
+    // Nothing to do if no handler extractions and no lazy transforms
+    if (extractable.length === 0 && !hasLazyTransforms)
+        return null;
+    // Deep-copy the full AST for client code mutation
+    const clientAST = structuredClone(analyzed.ast);
+    const chunkModules = [];
+    let extractedCount = 0;
+    for (const segment of extractable) {
+        // Find the AST node in the ORIGINAL tree (for chunk module generation)
+        const originalNode = findASTNode(analyzed.ast, segment.span);
+        if (!originalNode)
+            continue;
+        // Find the corresponding node in the CLONED tree (for client mutation)
+        const clientNode = findASTNode(clientAST, segment.span);
+        if (!clientNode)
+            continue;
+        // Separate captured vars from imports (rewrites relative paths to absolute)
+        const resolution = resolveImports(segment, analyzed, sourceFilePath);
+        // Generate the chunk module from the original (unmutated) AST
+        const chunkResult = generateChunkModule(segment, originalNode, resolution.imports, resolution.capturedParams, sourceFilePath, _sourceCode);
+        chunkModules.push({ id: segment.id, code: chunkResult.code, map: chunkResult.map });
+        // Mutate the client AST node — replace function body with lazy stub
+        replaceWithStub(clientNode, segment, resolution.capturedParams);
+        extractedCount++;
+    }
+    // Apply React.lazy + Suspense transforms (after handler extraction)
+    if (hasLazyTransforms) {
+        applyLazyTransforms(clientAST, lazyCandidates);
+    }
+    // Bail if neither handler extraction nor lazy transforms produced changes
+    if (extractedCount === 0 && !hasLazyTransforms)
+        return null;
+    // Prepend `import { __phantom_lazy } from 'phantom-build/runtime'` if handlers were extracted
+    if (extractedCount > 0) {
+        const lazyImport = {
+            type: 'ImportDeclaration',
+            specifiers: [{
+                    type: 'ImportSpecifier',
+                    imported: { type: 'Identifier', name: '__phantom_lazy' },
+                    local: { type: 'Identifier', name: '__phantom_lazy' },
+                }],
+            source: { type: 'Literal', value: 'phantom-build/runtime' },
+        };
+        clientAST.body.unshift(lazyImport);
+    }
+    // Generate client code with esrap (including source map)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- esrap tsx visitors expect TSESTree.Node, OXC produces compatible estree nodes
+    const result = print(clientAST, tsx(), {
+        sourceMapSource: sourceFilePath,
+        sourceMapContent: _sourceCode,
+    });
+    return { clientCode: result.code, clientMap: result.map, chunkModules };
+}
+// ── AST helpers ──────────────────────────────────────────────────────────
+function findASTNode(root, span) {
+    let match = null;
+    walkNode(root, (node) => {
+        const n = node;
+        if (n.start !== span.start || n.end !== span.end)
+            return;
+        if (node.type === 'ArrowFunctionExpression' ||
+            node.type === 'FunctionExpression' ||
+            node.type === 'FunctionDeclaration') {
+            match = node;
+        }
+    });
+    return match;
+}
+function walkNode(node, callback) {
+    if (!node || typeof node !== 'object')
+        return;
+    if (Array.isArray(node)) {
+        for (const child of node)
+            walkNode(child, callback);
+        return;
+    }
+    const obj = node;
+    if (typeof obj.type !== 'string')
+        return;
+    callback(obj);
+    for (const key of Object.keys(obj)) {
+        if (key === 'type')
+            continue;
+        walkNode(obj[key], callback);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/extract/index.js.map

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

package/dist/extract/lazy-transform.d.ts

@@ -0,0 +1,14 @@
+import type { Program } from 'estree';
+import type { LazyCandidate } from '../types.js';
+/**
+ * Apply React.lazy + Suspense transforms to a cloned AST.
+ *
+ * Mutates the AST in place:
+ * 1. Rewrites component imports → React.lazy(() => import(...))
+ * 2. Wraps JSX usages in <Suspense fallback={null}>
+ * 3. Ensures `lazy` and `Suspense` are imported from 'react'
+ *
+ * Should be called on a structuredClone of the original AST.
+ */
+export declare function applyLazyTransforms(ast: Program, candidates: LazyCandidate[]): void;
+//# sourceMappingURL=lazy-transform.d.ts.map

package/dist/extract/lazy-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-transform.d.ts","sourceRoot":"","sources":["../../src/extract/lazy-transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,OAAO,EAYR,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,aAAa,EAAE,GAC1B,IAAI,CAiBN"}