@nexus_js/compiler 0.6.0

package/dist/preload-scanner.js

@@ -0,0 +1,156 @@
+/**
+ * Nexus Preload Scanner — Eliminates island waterfall loading.
+ *
+ * The waterfall problem:
+ *   <Page>            → loads Island A JS
+ *     <IslandA>       → renders, then discovers Island B
+ *       <IslandB>     → ONLY NOW starts loading Island B JS  ← waterfall!
+ *
+ * The fix:
+ *   At SSR time, the scanner walks the entire component tree and collects
+ *   ALL island component paths (including deeply nested ones).
+ *   It then emits <link rel="modulepreload"> for each, so the browser
+ *   fetches them in parallel while parsing the initial HTML.
+ *
+ *   Result: Island A and Island B both start loading immediately,
+ *   even if B is nested inside A.
+ *
+ * Algorithm:
+ *   1. Parse the template for component references (<ComponentName ...>)
+ *   2. For each component that resolves to a .nx file, compile it
+ *   3. If it has islands, record their client bundle paths
+ *   4. Recurse into imported components
+ *   5. Deduplicate and emit modulepreload links
+ */
+import { readFile } from 'node:fs/promises';
+import { join, resolve, dirname, relative } from 'node:path';
+import { parse } from './parser.js';
+// Priority order for fetch (load > idle > visible > media)
+const STRATEGY_PRIORITY = {
+    'client:load': 0,
+    'client:idle': 1,
+    'client:visible': 2,
+    'client:media': 3,
+    'server:only': 99,
+};
+/**
+ * Scans a route file and all its imported components recursively.
+ * Returns modulepreload entries for every island in the tree.
+ */
+export async function scanPreloads(filepath, opts) {
+    const publicBase = opts.publicBase ?? '/_nexus/islands';
+    const maxDepth = opts.maxDepth ?? 8;
+    const visited = new Set();
+    const entries = [];
+    await walkComponent(filepath, opts.root, publicBase, maxDepth, 0, visited, entries);
+    // Sort by hydration strategy priority
+    entries.sort((a, b) => (STRATEGY_PRIORITY[a.strategy] ?? 99) - (STRATEGY_PRIORITY[b.strategy] ?? 99));
+    const linkTags = entries.map((e) => buildPreloadTag(e)).join('\n  ');
+    return { entries, linkTags, islandCount: entries.length };
+}
+async function walkComponent(filepath, root, publicBase, maxDepth, depth, visited, entries) {
+    if (depth > maxDepth)
+        return;
+    if (visited.has(filepath))
+        return;
+    visited.add(filepath);
+    let source;
+    try {
+        source = await readFile(filepath, 'utf-8');
+    }
+    catch {
+        return; // File not found — skip
+    }
+    const parsed = parse(source, filepath);
+    // Collect islands from this component
+    for (const directive of parsed.islandDirectives) {
+        if (directive.directive === 'server:only')
+            continue;
+        const relPath = relative(root, filepath);
+        const href = `${publicBase}/${relPath.replace(/\.nx$/, '.client.js')}`;
+        entries.push({
+            modulePath: filepath,
+            href,
+            strategy: directive.directive,
+            component: directive.componentName,
+        });
+    }
+    // Find and recurse into imported components
+    const importedPaths = extractComponentImports(source, filepath, root);
+    for (const importedPath of importedPaths) {
+        await walkComponent(importedPath, root, publicBase, maxDepth, depth + 1, visited, entries);
+    }
+}
+/**
+ * Extracts .nx component imports from a file's frontmatter and script block.
+ * Resolves them relative to the current file.
+ */
+function extractComponentImports(source, filepath, root) {
+    const dir = dirname(filepath);
+    const resolved = [];
+    // Match: import X from './Foo.nx' or import './Foo.nx'
+    const importRe = /import\s+(?:\w+\s+from\s+)?['"]([^'"]+\.nx)['"]/g;
+    let m;
+    while ((m = importRe.exec(source)) !== null) {
+        const spec = m[1];
+        if (!spec)
+            continue;
+        let absPath;
+        if (spec.startsWith('.')) {
+            absPath = resolve(dir, spec);
+        }
+        else if (spec.startsWith('$')) {
+            // $lib/* alias
+            absPath = resolve(root, 'src', spec.slice(1), '.nx');
+        }
+        else {
+            continue; // External package — skip
+        }
+        if (!absPath.endsWith('.nx'))
+            absPath += '.nx';
+        resolved.push(absPath);
+    }
+    // Also scan template for <ComponentName /> patterns
+    // These may map to co-located .nx files
+    const componentRe = /<([A-Z][a-zA-Z0-9]*)\s/g;
+    while ((m = componentRe.exec(source)) !== null) {
+        const name = m[1];
+        if (!name)
+            continue;
+        // Try conventional co-location paths
+        const candidates = [
+            join(dir, `${name}.nx`),
+            join(dir, 'components', `${name}.nx`),
+            join(root, 'src', 'components', `${name}.nx`),
+        ];
+        for (const candidate of candidates) {
+            resolved.push(candidate); // walkComponent will skip non-existent files
+        }
+    }
+    return [...new Set(resolved)];
+}
+/**
+ * Builds a <link rel="modulepreload"> tag with correct fetch priority.
+ */
+function buildPreloadTag(entry) {
+    const priority = entry.strategy === 'client:load' ? ' fetchpriority="high"' : '';
+    const asAttr = ' as="script"';
+    return `<link rel="modulepreload" href="${entry.href}"${asAttr}${priority}>`;
+}
+/**
+ * Quick synchronous scan — for use inside the compiler during codegen.
+ * Returns preload hrefs from already-parsed island directives.
+ */
+export function buildPreloadTagsFromManifest(islands, root, publicBase = '/_nexus/islands') {
+    const tags = islands
+        .filter((i) => i.directive !== 'server:only')
+        .sort((a, b) => (STRATEGY_PRIORITY[a.directive] ?? 99) - (STRATEGY_PRIORITY[b.directive] ?? 99))
+        .map((island) => {
+        const relPath = relative(root, island.componentPath);
+        const href = `${publicBase}/${relPath.replace(/\.nx$/, '.client.js')}`;
+        const priority = island.directive === 'client:load' ? ' fetchpriority="high"' : '';
+        return `<link rel="modulepreload" href="${href}" as="script"${priority}>`;
+    });
+    return tags.join('\n  ');
+}
+//# sourceMappingURL=preload-scanner.js.map

package/dist/preload-scanner.js.map

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

package/dist/server-actions-extract.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Server Action extraction via TypeScript AST (handles nested braces, return objects, etc.).
+ */
+import type { ServerAction } from './types.js';
+/**
+ * Extracts server actions from script + frontmatter (TypeScript / JS).
+ */
+export declare function extractServerActionsFromSource(code: string): ServerAction[];
+//# sourceMappingURL=server-actions-extract.d.ts.map

package/dist/server-actions-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-actions-extract.d.ts","sourceRoot":"","sources":["../src/server-actions-extract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiE/C;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAuC3E"}

package/dist/server-actions-extract.js

@@ -0,0 +1,89 @@
+/**
+ * Server Action extraction via TypeScript AST (handles nested braces, return objects, etc.).
+ */
+import ts from 'typescript';
+function hasUseServerDirective(body) {
+    if (body.statements.length === 0)
+        return false;
+    const first = body.statements[0];
+    if (!ts.isExpressionStatement(first))
+        return false;
+    const ex = first.expression;
+    if (ts.isStringLiteral(ex))
+        return ex.text === 'use server';
+    if (ts.isNoSubstitutionTemplateLiteral(ex))
+        return ex.text === 'use server';
+    return false;
+}
+/** Body text for registerAction: statements after the leading "use server" directive. */
+function extractActionBody(sourceFile, body) {
+    return body.statements.slice(1).map((s) => s.getText(sourceFile)).join('\n');
+}
+function paramTexts(sourceFile, params) {
+    return params.map((p) => p.getText(sourceFile));
+}
+function tryPushAction(name, sourceFile, params, body, seen, out) {
+    if (!body || !hasUseServerDirective(body))
+        return;
+    if (seen.has(name))
+        return;
+    seen.add(name);
+    const bodyText = extractActionBody(sourceFile, body);
+    out.push({
+        name,
+        params: paramTexts(sourceFile, params),
+        body: bodyText,
+        returnType: 'Promise<unknown>',
+    });
+}
+function isCreateActionCallee(expr) {
+    return ts.isIdentifier(expr) && expr.text === 'createAction';
+}
+/** `const save = createAction({ handler: ... })` or `createAction(async (fd, ctx) => {})` */
+function tryPushCreateAction(name, sourceFile, call, seen, out) {
+    if (seen.has(name))
+        return;
+    seen.add(name);
+    const createActionSource = call.getText(sourceFile);
+    out.push({
+        name,
+        params: [],
+        body: '',
+        returnType: 'Promise<unknown>',
+        createActionSource,
+    });
+}
+/**
+ * Extracts server actions from script + frontmatter (TypeScript / JS).
+ */
+export function extractServerActionsFromSource(code) {
+    const out = [];
+    const seen = new Set();
+    const sourceFile = ts.createSourceFile('actions.ts', code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    function visit(node) {
+        if (ts.isFunctionDeclaration(node) && node.name && node.body) {
+            tryPushAction(node.name.text, sourceFile, node.parameters, node.body, seen, out);
+        }
+        if (ts.isVariableStatement(node)) {
+            for (const decl of node.declarationList.declarations) {
+                if (!ts.isIdentifier(decl.name) || !decl.initializer)
+                    continue;
+                const name = decl.name.text;
+                const init = decl.initializer;
+                if (ts.isCallExpression(init) && isCreateActionCallee(init.expression)) {
+                    tryPushCreateAction(name, sourceFile, init, seen, out);
+                    continue;
+                }
+                if (ts.isArrowFunction(init) || ts.isFunctionExpression(init)) {
+                    if (init.body && ts.isBlock(init.body)) {
+                        tryPushAction(name, sourceFile, init.parameters, init.body, seen, out);
+                    }
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return out;
+}
+//# sourceMappingURL=server-actions-extract.js.map

package/dist/server-actions-extract.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+/** A parsed block extracted from a .nx file */
+export interface NexusBlock {
+    type: 'server' | 'script' | 'template' | 'style';
+    content: string;
+    start: number;
+    end: number;
+}
+/** Parsed representation of a .nx component file */
+export interface ParsedComponent {
+    /** Raw source code */
+    source: string;
+    /** Path of the file */
+    filepath: string;
+    /** Frontmatter block (server-only, runs at request time) */
+    frontmatter: NexusBlock | null;
+    /** Reactive script block (client island code using Runes) */
+    script: NexusBlock | null;
+    /** HTML template block */
+    template: NexusBlock | null;
+    /** Style block */
+    style: NexusBlock | null;
+    /** Detected island directives e.g. client:visible, client:idle */
+    islandDirectives: IslandDirective[];
+    /** Detected server actions ("use server" functions) */
+    serverActions: ServerAction[];
+}
+export type IslandHydration = 'client:load' | 'client:idle' | 'client:visible' | 'client:media' | 'server:only';
+export interface IslandDirective {
+    directive: IslandHydration;
+    componentName: string;
+    /** For client:media — the query string */
+    mediaQuery?: string;
+}
+export interface ServerAction {
+    name: string;
+    params: string[];
+    body: string;
+    /** Inferred TypeScript return type */
+    returnType: string;
+    /**
+     * If set, emitted as `registerAction(name, createAction(...), { csrf: false })` instead of a raw
+     * async handler (from `const x = createAction(...)` in the .nx script).
+     */
+    createActionSource?: string;
+}
+export interface CompileOptions {
+    mode: 'server' | 'client' | 'static';
+    dev: boolean;
+    ssr: boolean;
+    /** Whether to emit island manifests for the runtime */
+    emitIslandManifest: boolean;
+    target: 'node' | 'edge' | 'browser';
+    /** App root — used for stable /_nexus/islands/client.mjs?path=… query strings */
+    appRoot?: string;
+}
+export interface CompileResult {
+    /** Server-side module code (runs on every request) */
+    serverCode: string;
+    /** Client-side island code (only sent to browser when needed) */
+    clientCode: string | null;
+    /** CSS output */
+    css: string | null;
+    /** Island manifest for runtime hydration */
+    islandManifest: IslandManifest | null;
+    /** Server Actions extracted to separate module */
+    actionsModule: string | null;
+    /** Source maps */
+    map: string | null;
+    warnings: CompileWarning[];
+}
+export interface IslandManifest {
+    islands: IslandEntry[];
+}
+export interface IslandEntry {
+    id: string;
+    componentPath: string;
+    directive: IslandHydration;
+    props: string[];
+    mediaQuery?: string;
+}
+export interface CompileWarning {
+    message: string;
+    start?: number;
+    end?: number;
+}
+export interface RouteManifest {
+    routes: RouteEntry[];
+}
+export interface RouteEntry {
+    pattern: string;
+    filepath: string;
+    params: string[];
+    isDynamic: boolean;
+    isLayout: boolean;
+    parentLayout?: string;
+    serverActions: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@nexus_js/compiler",
+  "version": "0.6.0",
+  "description": "Nexus compiler — transforms .nx files into optimized server/client bundles",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "magic-string": "^0.30.0",
+    "typescript": "^5.5.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "license": "MIT",
+  "homepage": "https://nexusjs.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bierfor/nexus.git",
+    "directory": "packages/compiler"
+  },
+  "bugs": {
+    "url": "https://github.com/bierfor/nexus/issues"
+  },
+  "keywords": [
+    "nexus",
+    "framework",
+    "full-stack",
+    "svelte",
+    "islands",
+    "ssr",
+    "vite",
+    "server-actions"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}