@cmj/juice 0.0.1

package/dist/cli/templates.js

@@ -0,0 +1,154 @@
+// ─────────────────────────────────────────────────────────────────
+// @cmj/juice — CLI Template Files
+// Pure functions that return file content strings for scaffolding.
+// ─────────────────────────────────────────────────────────────────
+export const DEPLOY_TARGETS = ['bun', 'node', 'cloudflare', 'deno'];
+export const TARGET_LABELS = {
+    bun: 'Bun',
+    node: 'Node.js',
+    cloudflare: 'Cloudflare Workers',
+    deno: 'Deno',
+};
+export function packageJson({ name, target }) {
+    const startScript = {
+        bun: 'bun server.ts',
+        node: 'node dist/server.js',
+        cloudflare: 'wrangler dev',
+        deno: 'deno run --allow-net --allow-read server.ts',
+    };
+    const pkg = {
+        name,
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: 'vite dev',
+            build: 'vite build',
+            start: startScript[target],
+            typecheck: 'tsc --noEmit',
+        },
+        dependencies: {
+            '@cmj/juice': '^0.0.1',
+            react: '^19.0.0',
+            'react-dom': '^19.0.0',
+        },
+        devDependencies: {
+            '@types/react': '^19.0.0',
+            '@types/react-dom': '^19.0.0',
+            typescript: '^5.7.0',
+            vite: '^6.0.0',
+        },
+    };
+    // Bun and Deno have built-in types; Node needs @types/node
+    if (target === 'node') {
+        pkg.devDependencies['@types/node'] = '^22.0.0';
+    }
+    return JSON.stringify(pkg, null, 2) + '\n';
+}
+export function tsconfig() {
+    const config = {
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'ESNext',
+            moduleResolution: 'bundler',
+            jsx: 'react-jsx',
+            strict: true,
+            noEmit: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            isolatedModules: true,
+            verbatimModuleSyntax: true,
+        },
+        include: ['**/*.ts', '**/*.tsx'],
+    };
+    return JSON.stringify(config, null, 2) + '\n';
+}
+export function viteConfig() {
+    return `import { defineConfig } from 'vite';
+import juice from '@cmj/juice/plugin';
+
+export default defineConfig({
+  plugins: [juice()],
+});
+`;
+}
+// ── Server entry per target ─────────────────────────────────────
+const SERVER_PREAMBLE = `import { createRouter } from '@cmj/juice/runtime';
+import type { FlightManifest } from '@cmj/juice/runtime';
+
+const manifest: FlightManifest = {
+  routes: {
+    '/': { moduleId: './app/routes/home.tsx' },
+  },
+  clientModules: {},
+  serverActions: {},
+};
+
+const handler = createRouter(manifest, {
+  root: import.meta.url,
+});
+`;
+const SERVER_ADAPTERS = {
+    bun: `
+Bun.serve({
+  port: 3000,
+  fetch: handler,
+});
+
+console.log('🧃 Listening on http://localhost:3000');
+`,
+    node: `
+import { createServer } from 'node:http';
+
+createServer(async (req, res) => {
+  const url = new URL(req.url ?? '/', \`http://\${req.headers.host}\`);
+  const body = await new Promise<Buffer>((resolve) => {
+    const chunks: Buffer[] = [];
+    req.on('data', (c: Buffer) => chunks.push(c));
+    req.on('end', () => resolve(Buffer.concat(chunks)));
+  });
+  const request = new Request(url.href, {
+    method: req.method,
+    headers: req.headers as Record<string, string>,
+    body: req.method !== 'GET' && req.method !== 'HEAD' ? body : undefined,
+  });
+  const response = await handler(request);
+  res.writeHead(response.status, Object.fromEntries(response.headers));
+  const buffer = Buffer.from(await response.arrayBuffer());
+  res.end(buffer);
+}).listen(3000, () => {
+  console.log('🧃 Listening on http://localhost:3000');
+});
+`,
+    cloudflare: `
+export default { fetch: handler };
+`,
+    deno: `
+Deno.serve({ port: 3000 }, handler);
+
+console.log('🧃 Listening on http://localhost:3000');
+`,
+};
+export function serverEntry(target) {
+    return SERVER_PREAMBLE + SERVER_ADAPTERS[target];
+}
+export function homeRoute() {
+    return `import React from 'react';
+
+export default function HomePage() {
+  const timestamp = new Date().toISOString();
+
+  return (
+    <html>
+      <head>
+        <title>Juice App</title>
+      </head>
+      <body>
+        <h1>🧃 Juice</h1>
+        <p>Server-rendered at {timestamp}</p>
+      </body>
+    </html>
+  );
+}
+`;
+}
+//# sourceMappingURL=templates.js.map

package/dist/cli/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/cli/templates.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,kCAAkC;AAClC,mEAAmE;AACnE,oEAAoE;AAIpE,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAU,CAAC;AAEtG,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,oBAAoB;IAChC,IAAI,EAAE,MAAM;CACb,CAAC;AAOF,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAmB;IAC3D,MAAM,WAAW,GAAiC;QAChD,GAAG,EAAE,eAAe;QACpB,IAAI,EAAE,qBAAqB;QAC3B,UAAU,EAAE,cAAc;QAC1B,IAAI,EAAE,6CAA6C;KACpD,CAAC;IAEF,MAAM,GAAG,GAA4B;QACnC,IAAI;QACJ,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC;YAC1B,SAAS,EAAE,cAAc;SAC1B;QACD,YAAY,EAAE;YACZ,YAAY,EAAE,QAAQ;YACtB,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,SAAS;SACvB;QACD,eAAe,EAAE;YACf,cAAc,EAAE,SAAS;YACzB,kBAAkB,EAAE,SAAS;YAC7B,UAAU,EAAE,QAAQ;YACpB,IAAI,EAAE,QAAQ;SACf;KACF,CAAC;IAEF,2DAA2D;IAC3D,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACrB,GAAG,CAAC,eAA0C,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;IAC7E,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,MAAM,MAAM,GAAG;QACb,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,gBAAgB,EAAE,SAAS;YAC3B,GAAG,EAAE,WAAW;YAChB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,oBAAoB,EAAE,IAAI;SAC3B;QACD,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;KACjC,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO;;;;;;CAMR,CAAC;AACF,CAAC;AAED,mEAAmE;AAEnE,MAAM,eAAe,GAAG;;;;;;;;;;;;;;CAcvB,CAAC;AAEF,MAAM,eAAe,GAAiC;IACpD,GAAG,EAAE;;;;;;;CAON;IACC,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;CAsBP;IACC,UAAU,EAAE;;CAEb;IACC,IAAI,EAAE;;;;CAIP;CACA,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,OAAO,eAAe,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO;;;;;;;;;;;;;;;;;CAiBR,CAAC;AACF,CAAC"}

package/dist/compiler/errors.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Custom error classes for the Juice compiler.
+ *
+ * Every error provides:
+ * 1. **What** went wrong.
+ * 2. **Why** it went wrong.
+ * 3. **Exactly how to fix it.**
+ *
+ * @module errors
+ */
+/**
+ * The two directive types supported by the Juice compiler.
+ */
+export type DirectiveType = 'use client' | 'use server';
+/**
+ * Thrown when a `'use client'` directive is found in an invalid position.
+ *
+ * @example
+ * ```
+ * JuiceDirectiveError: 'use client' must be the first statement in
+ * components/Counter.tsx. Found 'ImportDeclaration' at line 1 instead.
+ * Move the directive to the very first line of the file.
+ * ```
+ */
+export declare class JuiceDirectiveError extends Error {
+    readonly name = "JuiceDirectiveError";
+    constructor(file: string, actualNodeType: string, line: number);
+}
+/**
+ * Thrown when a directive module exports nothing.
+ *
+ * @example
+ * ```
+ * JuiceExportError: components/Counter.tsx has a 'use client' directive
+ * but exports nothing. Directive modules must export at least one binding.
+ * Did you forget to add 'export default'?
+ * ```
+ */
+export declare class JuiceExportError extends Error {
+    readonly name = "JuiceExportError";
+    constructor(file: string, directive?: DirectiveType);
+}
+/**
+ * Thrown when a module contains BOTH `'use client'` and `'use server'` directives.
+ *
+ * A module cannot be both a client component and a server action — they have
+ * fundamentally incompatible execution semantics. Split the code into two files.
+ *
+ * @example
+ * ```
+ * JuiceMutualExclusionError: components/Mixed.tsx contains both 'use client'
+ * and 'use server' directives. A module cannot be both. Split the client
+ * component and server action into separate files.
+ * ```
+ */
+export declare class JuiceMutualExclusionError extends Error {
+    readonly name = "JuiceMutualExclusionError";
+    constructor(file: string);
+}
+/**
+ * Thrown when a directive module uses `export * from '...'` which is unsupported.
+ *
+ * React requires explicit exports for client/server boundary modules because
+ * each export becomes a separately addressable reference in the Flight protocol.
+ * Barrel re-exports (`export *`) lose the explicit mapping.
+ *
+ * @example
+ * ```
+ * JuiceBarrelExportError: components/index.tsx uses 'export * from' with
+ * a 'use client' directive. Only explicit named exports are allowed in
+ * directive modules. Replace with: export { Counter, Badge } from './Counter';
+ * ```
+ */
+export declare class JuiceBarrelExportError extends Error {
+    readonly name = "JuiceBarrelExportError";
+    constructor(file: string, directive: DirectiveType, source: string);
+}
+/**
+ * Thrown when the Flight manifest cannot be written to disk.
+ *
+ * @example
+ * ```
+ * JuiceManifestError: Failed to write flight-manifest.json to dist/.
+ * Ensure the output directory exists and is writable. Path: /abs/dist/flight-manifest.json
+ * ```
+ */
+export declare class JuiceManifestError extends Error {
+    readonly name = "JuiceManifestError";
+    constructor(outDir: string, fullPath: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/compiler/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/compiler/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,YAAY,CAAC;AAExD;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAkB,IAAI,yBAAyB;gBAEnC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAO/D;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAkB,IAAI,sBAAsB;gBAEhC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,aAA4B;CAOlE;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,+BAA+B;gBAEzC,IAAI,EAAE,MAAM;CAOzB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAkB,IAAI,4BAA4B;gBAEtC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM;CASnE;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;gBAElC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAQ9D"}

package/dist/compiler/errors.js

@@ -0,0 +1,110 @@
+/**
+ * Custom error classes for the Juice compiler.
+ *
+ * Every error provides:
+ * 1. **What** went wrong.
+ * 2. **Why** it went wrong.
+ * 3. **Exactly how to fix it.**
+ *
+ * @module errors
+ */
+/**
+ * Thrown when a `'use client'` directive is found in an invalid position.
+ *
+ * @example
+ * ```
+ * JuiceDirectiveError: 'use client' must be the first statement in
+ * components/Counter.tsx. Found 'ImportDeclaration' at line 1 instead.
+ * Move the directive to the very first line of the file.
+ * ```
+ */
+export class JuiceDirectiveError extends Error {
+    name = 'JuiceDirectiveError';
+    constructor(file, actualNodeType, line) {
+        super(`'use client' must be the first statement in ${file}. ` +
+            `Found '${actualNodeType}' at line ${line} instead. ` +
+            `Move the directive to the very first line of the file.`);
+    }
+}
+/**
+ * Thrown when a directive module exports nothing.
+ *
+ * @example
+ * ```
+ * JuiceExportError: components/Counter.tsx has a 'use client' directive
+ * but exports nothing. Directive modules must export at least one binding.
+ * Did you forget to add 'export default'?
+ * ```
+ */
+export class JuiceExportError extends Error {
+    name = 'JuiceExportError';
+    constructor(file, directive = 'use client') {
+        super(`${file} has a '${directive}' directive but exports nothing. ` +
+            `Directive modules must export at least one binding. ` +
+            `Did you forget to add 'export default' or 'export function'?`);
+    }
+}
+/**
+ * Thrown when a module contains BOTH `'use client'` and `'use server'` directives.
+ *
+ * A module cannot be both a client component and a server action — they have
+ * fundamentally incompatible execution semantics. Split the code into two files.
+ *
+ * @example
+ * ```
+ * JuiceMutualExclusionError: components/Mixed.tsx contains both 'use client'
+ * and 'use server' directives. A module cannot be both. Split the client
+ * component and server action into separate files.
+ * ```
+ */
+export class JuiceMutualExclusionError extends Error {
+    name = 'JuiceMutualExclusionError';
+    constructor(file) {
+        super(`${file} contains both 'use client' and 'use server' directives. ` +
+            `A module cannot be both a client component and a server action. ` +
+            `Split the client component and server action into separate files.`);
+    }
+}
+/**
+ * Thrown when a directive module uses `export * from '...'` which is unsupported.
+ *
+ * React requires explicit exports for client/server boundary modules because
+ * each export becomes a separately addressable reference in the Flight protocol.
+ * Barrel re-exports (`export *`) lose the explicit mapping.
+ *
+ * @example
+ * ```
+ * JuiceBarrelExportError: components/index.tsx uses 'export * from' with
+ * a 'use client' directive. Only explicit named exports are allowed in
+ * directive modules. Replace with: export { Counter, Badge } from './Counter';
+ * ```
+ */
+export class JuiceBarrelExportError extends Error {
+    name = 'JuiceBarrelExportError';
+    constructor(file, directive, source) {
+        super(`${file} uses 'export * from ${JSON.stringify(source)}' with a ` +
+            `'${directive}' directive. Only explicit named exports are allowed ` +
+            `in directive modules because each export must be individually ` +
+            `addressable in the Flight protocol. ` +
+            `Replace with: export { SpecificExport } from ${JSON.stringify(source)};`);
+    }
+}
+/**
+ * Thrown when the Flight manifest cannot be written to disk.
+ *
+ * @example
+ * ```
+ * JuiceManifestError: Failed to write flight-manifest.json to dist/.
+ * Ensure the output directory exists and is writable. Path: /abs/dist/flight-manifest.json
+ * ```
+ */
+export class JuiceManifestError extends Error {
+    name = 'JuiceManifestError';
+    constructor(outDir, fullPath, cause) {
+        super(`Failed to write flight-manifest.json to ${outDir}. ` +
+            `Ensure the output directory exists and is writable. ` +
+            `Path: ${fullPath}`);
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/compiler/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/compiler/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;;;;;;;GASG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC1B,IAAI,GAAG,qBAAqB,CAAC;IAE/C,YAAY,IAAY,EAAE,cAAsB,EAAE,IAAY;QAC5D,KAAK,CACH,+CAA+C,IAAI,IAAI;YACvD,UAAU,cAAc,aAAa,IAAI,YAAY;YACrD,wDAAwD,CACzD,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACvB,IAAI,GAAG,kBAAkB,CAAC;IAE5C,YAAY,IAAY,EAAE,YAA2B,YAAY;QAC/D,KAAK,CACH,GAAG,IAAI,WAAW,SAAS,mCAAmC;YAC9D,sDAAsD;YACtD,8DAA8D,CAC/D,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAChC,IAAI,GAAG,2BAA2B,CAAC;IAErD,YAAY,IAAY;QACtB,KAAK,CACH,GAAG,IAAI,2DAA2D;YAClE,kEAAkE;YAClE,mEAAmE,CACpE,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7B,IAAI,GAAG,wBAAwB,CAAC;IAElD,YAAY,IAAY,EAAE,SAAwB,EAAE,MAAc;QAChE,KAAK,CACH,GAAG,IAAI,wBAAwB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW;YAChE,IAAI,SAAS,uDAAuD;YACpE,gEAAgE;YAChE,sCAAsC;YACtC,gDAAgD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAC1E,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzB,IAAI,GAAG,oBAAoB,CAAC;IAE9C,YAAY,MAAc,EAAE,QAAgB,EAAE,KAAe;QAC3D,KAAK,CACH,2CAA2C,MAAM,IAAI;YACrD,sDAAsD;YACtD,SAAS,QAAQ,EAAE,CACpB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/compiler/manifest.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Emits the `flight-manifest.json` file that maps server component references
+ * to client-side chunks.
+ *
+ * @module manifest
+ * @internal
+ */
+import type { FlightManifest, ManifestRouteEntry } from './types.js';
+import type { ClientModuleRegistry } from './registry.js';
+import type { ServerActionRegistry } from './server-action-registry.js';
+/**
+ * Build the {@link FlightManifest} object from the registries and resolved
+ * chunk file names.
+ *
+ * @param clientRegistry - The populated client module registry.
+ * @param chunkMap - Maps module specifiers to their emitted chunk file paths
+ *                   (e.g., `'components/Counter.tsx' → ['client/Counter.CxK3d.js']`).
+ * @param serverRegistry - Optional server action registry.
+ * @param routes - Optional route map (pattern → module info).
+ * @returns The complete manifest ready for JSON serialization.
+ *
+ * @internal
+ */
+export declare function _buildManifest(clientRegistry: ClientModuleRegistry, chunkMap: ReadonlyMap<string, readonly string[]>, serverRegistry?: ServerActionRegistry, routes?: Readonly<Record<string, ManifestRouteEntry>>, meta?: FlightManifest['_meta']): FlightManifest;
+/**
+ * Serialize the manifest to a human-readable JSON string.
+ *
+ * The output is intentionally pretty-printed (2-space indent) because the
+ * manifest is a build artifact consumed by the server runtime — human
+ * readability aids debugging and diffs. Size is irrelevant as it is never
+ * sent to clients.
+ *
+ * @param manifest - The manifest to serialize.
+ * @returns A JSON string with 2-space indentation.
+ *
+ * @internal
+ */
+export declare function _serializeManifest(manifest: FlightManifest): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/compiler/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/compiler/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EAGd,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,oBAAoB,EACpC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EAChD,cAAc,CAAC,EAAE,oBAAoB,EACrC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,EACrD,IAAI,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,cAAc,CA6ChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAEnE"}

package/dist/compiler/manifest.js

@@ -0,0 +1,78 @@
+/**
+ * Emits the `flight-manifest.json` file that maps server component references
+ * to client-side chunks.
+ *
+ * @module manifest
+ * @internal
+ */
+/**
+ * Build the {@link FlightManifest} object from the registries and resolved
+ * chunk file names.
+ *
+ * @param clientRegistry - The populated client module registry.
+ * @param chunkMap - Maps module specifiers to their emitted chunk file paths
+ *                   (e.g., `'components/Counter.tsx' → ['client/Counter.CxK3d.js']`).
+ * @param serverRegistry - Optional server action registry.
+ * @param routes - Optional route map (pattern → module info).
+ * @returns The complete manifest ready for JSON serialization.
+ *
+ * @internal
+ */
+export function _buildManifest(clientRegistry, chunkMap, serverRegistry, routes, meta) {
+    const clientModules = {};
+    for (const [specifier, info] of clientRegistry.entries()) {
+        const chunks = chunkMap.get(specifier) ?? [];
+        const exports = {};
+        for (const exp of info.exports) {
+            exports[exp.exportedName] = {
+                id: `${specifier}#${exp.exportedName}`,
+                name: exp.exportedName,
+                chunks: [...chunks],
+            };
+        }
+        clientModules[specifier] = {
+            chunks: [...chunks],
+            exports,
+        };
+    }
+    // Build server actions map — field names aligned with runtime ServerActionRef
+    const serverActions = {};
+    if (serverRegistry) {
+        for (const [specifier, info] of serverRegistry.entries()) {
+            for (const exp of info.exports) {
+                const actionId = `${specifier}#${exp.exportedName}`;
+                serverActions[actionId] = {
+                    id: actionId,
+                    exportName: exp.exportedName,
+                    moduleId: specifier,
+                };
+            }
+        }
+    }
+    return {
+        $schema: 'https://juice.dev/schemas/flight-manifest.v1.json',
+        version: 1,
+        routes: routes ?? {},
+        clientModules,
+        ssrModules: {},
+        serverActions,
+        ...(meta ? { _meta: meta } : {}),
+    };
+}
+/**
+ * Serialize the manifest to a human-readable JSON string.
+ *
+ * The output is intentionally pretty-printed (2-space indent) because the
+ * manifest is a build artifact consumed by the server runtime — human
+ * readability aids debugging and diffs. Size is irrelevant as it is never
+ * sent to clients.
+ *
+ * @param manifest - The manifest to serialize.
+ * @returns A JSON string with 2-space indentation.
+ *
+ * @internal
+ */
+export function _serializeManifest(manifest) {
+    return JSON.stringify(manifest, null, 2) + '\n';
+}
+//# sourceMappingURL=manifest.js.map

package/dist/compiler/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/compiler/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,cAAoC,EACpC,QAAgD,EAChD,cAAqC,EACrC,MAAqD,EACrD,IAA8B;IAE9B,MAAM,aAAa,GAAwC,EAAE,CAAC;IAE9D,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAE7C,MAAM,OAAO,GAAwC,EAAE,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG;gBAC1B,EAAE,EAAE,GAAG,SAAS,IAAI,GAAG,CAAC,YAAY,EAAE;gBACtC,IAAI,EAAE,GAAG,CAAC,YAAY;gBACtB,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;aACpB,CAAC;QACJ,CAAC;QAED,aAAa,CAAC,SAAS,CAAC,GAAG;YACzB,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;YACnB,OAAO;SACR,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,MAAM,aAAa,GAA8C,EAAE,CAAC;IACpE,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBACpD,aAAa,CAAC,QAAQ,CAAC,GAAG;oBACxB,EAAE,EAAE,QAAQ;oBACZ,UAAU,EAAE,GAAG,CAAC,YAAY;oBAC5B,QAAQ,EAAE,SAAS;iBACpB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,mDAAmD;QAC5D,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,MAAM,IAAI,EAAE;QACpB,aAAa;QACb,UAAU,EAAE,EAAE;QACd,aAAa;QACb,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAwB;IACzD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAClD,CAAC"}

package/dist/compiler/parse.d.ts

@@ -0,0 +1,126 @@
+/**
+ * AST-based detection of `'use client'` and `'use server'` directives
+ * and export extraction.
+ *
+ * Uses Vite's built-in acorn parser via the Rollup plugin context — zero
+ * additional dependencies.
+ *
+ * @module parse
+ * @internal
+ */
+import type { ExportRecord } from './types.js';
+/**
+ * Quick check for the `'use client'` substring before doing a full AST parse.
+ * Returns `false` if the directive cannot possibly be present.
+ *
+ * @internal
+ */
+export declare function _mayContainClientDirective(source: string): boolean;
+/**
+ * Quick check for the `'use server'` substring before doing a full AST parse.
+ * Returns `false` if the directive cannot possibly be present.
+ *
+ * @internal
+ */
+export declare function _mayContainServerDirective(source: string): boolean;
+/**
+ * Quick check for either `'use client'` or `'use server'` substrings.
+ * Returns `false` if neither directive can possibly be present.
+ *
+ * @internal
+ */
+export declare function _mayContainDirective(source: string): boolean;
+/**
+ * Result of analyzing a module's AST for the `'use client'` directive.
+ *
+ * @internal
+ */
+export type DirectiveResult = {
+    readonly hasDirective: false;
+} | {
+    readonly hasDirective: true;
+    readonly exports: readonly ExportRecord[];
+};
+/**
+ * Analyze a parsed AST `Program` node for a `'use client'` directive and
+ * extract all exports if found.
+ *
+ * The directive MUST be the first statement in the module body (after optional
+ * comments). If `'use client'` appears anywhere other than position 0, this
+ * function returns `{ hasDirective: false }` — no false positives.
+ *
+ * @param ast - The acorn `Program` AST node (from `this.parse()` in Rollup context).
+ * @returns A {@link DirectiveResult} indicating whether the directive was found
+ *          and, if so, all exports extracted from the module.
+ *
+ * @internal
+ */
+export declare function _analyzeAST(ast: unknown): DirectiveResult;
+/**
+ * Result of analyzing a module's AST for the `'use server'` directive.
+ *
+ * @internal
+ */
+export type ServerDirectiveResult = {
+    readonly hasDirective: false;
+} | {
+    readonly hasDirective: true;
+    readonly exports: readonly ExportRecord[];
+};
+/**
+ * Analyze a parsed AST `Program` node for a `'use server'` directive and
+ * extract all exports if found.
+ *
+ * The directive MUST be the first statement in the module body (after optional
+ * comments). If `'use server'` appears anywhere other than position 0, this
+ * function returns `{ hasDirective: false }` — no false positives.
+ *
+ * @param ast - The acorn `Program` AST node (from `this.parse()` in Rollup context).
+ * @returns A {@link ServerDirectiveResult} indicating whether the directive was found
+ *          and, if so, all exports extracted from the module.
+ *
+ * @internal
+ */
+export declare function _analyzeServerAST(ast: unknown): ServerDirectiveResult;
+/**
+ * Detected directive type from a module's AST.
+ *
+ * @internal
+ */
+export type DetectedDirective = 'use client' | 'use server' | null;
+/**
+ * Unified result from `_detectDirective` — detects which directive (if any)
+ * is present and extracts exports, barrel re-export sources, and flags for
+ * mutual exclusion validation.
+ *
+ * @internal
+ */
+export interface UnifiedDirectiveResult {
+    /** Which directive was detected, or `null` if none. */
+    readonly directive: DetectedDirective;
+    /** All explicit exports found in the module. */
+    readonly exports: readonly ExportRecord[];
+    /** Sources of any `export * from '...'` barrel re-exports. */
+    readonly barrelReExports: readonly string[];
+    /**
+     * Whether both `'use client'` and `'use server'` appear as directives
+     * in the AST. This is a fatal error condition.
+     */
+    readonly hasMutualExclusion: boolean;
+}
+/**
+ * Detect the directive (if any), extract exports, and perform validation
+ * checks in a single AST pass for the hardened pipeline.
+ *
+ * Advantages over calling `_analyzeAST` + `_analyzeServerAST` separately:
+ * - Single AST walk (not two)
+ * - Catches mutual exclusion (`'use client'` + `'use server'` simultaneously)
+ * - Detects barrel re-exports (`export *`) for a clear error
+ *
+ * @param ast - The acorn `Program` AST node.
+ * @returns A {@link UnifiedDirectiveResult} with all extracted information.
+ *
+ * @internal
+ */
+export declare function _detectDirective(ast: unknown): UnifiedDirectiveResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/compiler/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/compiler/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkE/C;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAMD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;CAAE,CAAC;AAE/E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAiBzD;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;CAAE,CAAC;AAE/E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,CAiBrE;AAMD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAEtC,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAE1C,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CAiDrE"}