@cmj/juice 0.0.1

package/dist/compiler/parse.js

@@ -0,0 +1,246 @@
+/**
+ * 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
+ */
+// ---------------------------------------------------------------------------
+// Fast-path substring check
+// ---------------------------------------------------------------------------
+/**
+ * Quick check for the `'use client'` substring before doing a full AST parse.
+ * Returns `false` if the directive cannot possibly be present.
+ *
+ * @internal
+ */
+export function _mayContainClientDirective(source) {
+    return source.includes('use client');
+}
+/**
+ * Quick check for the `'use server'` substring before doing a full AST parse.
+ * Returns `false` if the directive cannot possibly be present.
+ *
+ * @internal
+ */
+export function _mayContainServerDirective(source) {
+    return source.includes('use server');
+}
+/**
+ * Quick check for either `'use client'` or `'use server'` substrings.
+ * Returns `false` if neither directive can possibly be present.
+ *
+ * @internal
+ */
+export function _mayContainDirective(source) {
+    return _mayContainClientDirective(source) || _mayContainServerDirective(source);
+}
+/**
+ * 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 function _analyzeAST(ast) {
+    const program = ast;
+    if (!program.body || program.body.length === 0) {
+        return { hasDirective: false };
+    }
+    // The directive must be the very first statement
+    const firstNode = program.body[0];
+    if (!firstNode || !_isDirective(firstNode, 'use client')) {
+        return { hasDirective: false };
+    }
+    // Directive confirmed — extract all exports
+    const exports = _extractExports(program.body);
+    return { hasDirective: true, exports };
+}
+/**
+ * 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 function _analyzeServerAST(ast) {
+    const program = ast;
+    if (!program.body || program.body.length === 0) {
+        return { hasDirective: false };
+    }
+    // The directive must be the very first statement
+    const firstNode = program.body[0];
+    if (!firstNode || !_isDirective(firstNode, 'use server')) {
+        return { hasDirective: false };
+    }
+    // Directive confirmed — extract all exports
+    const exports = _extractExports(program.body);
+    return { hasDirective: true, exports };
+}
+/**
+ * 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 function _detectDirective(ast) {
+    const program = ast;
+    const empty = {
+        directive: null,
+        exports: [],
+        barrelReExports: [],
+        hasMutualExclusion: false,
+    };
+    if (!program.body || program.body.length === 0) {
+        return empty;
+    }
+    const firstNode = program.body[0];
+    if (!firstNode) {
+        return empty;
+    }
+    // Determine which directive (if any) is at position 0
+    const isClient = _isDirective(firstNode, 'use client');
+    const isServer = _isDirective(firstNode, 'use server');
+    if (!isClient && !isServer) {
+        return empty;
+    }
+    // Check for mutual exclusion: scan remaining body for the other directive
+    let hasMutualExclusion = false;
+    const otherDirective = isClient ? 'use server' : 'use client';
+    for (let i = 1; i < program.body.length; i++) {
+        const node = program.body[i];
+        if (node && _isDirective(node, otherDirective)) {
+            hasMutualExclusion = true;
+            break;
+        }
+    }
+    // Extract exports and barrel re-exports
+    const exports = _extractExports(program.body);
+    const barrelReExports = _extractBarrelReExports(program.body);
+    return {
+        directive: isClient ? 'use client' : 'use server',
+        exports,
+        barrelReExports,
+        hasMutualExclusion,
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check if an AST node is a directive expression statement with the given value.
+ *
+ * Handles both the `directive` shorthand (acorn option) and the raw
+ * `ExpressionStatement > Literal` pattern.
+ *
+ * @internal
+ */
+function _isDirective(node, directive) {
+    if (node.type !== 'ExpressionStatement') {
+        return false;
+    }
+    const stmt = node;
+    // Acorn's `directive` property (when `allowReserved` is set)
+    if (stmt.directive === directive) {
+        return true;
+    }
+    // Fallback: raw literal check
+    const expr = stmt.expression;
+    if (expr.type === 'Literal' && expr.value === directive) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Walk the program body and extract all named and default exports.
+ *
+ * @internal
+ */
+function _extractExports(body) {
+    const records = [];
+    for (const node of body) {
+        switch (node.type) {
+            case 'ExportDefaultDeclaration': {
+                const decl = node;
+                const localName = decl.declaration.id?.name ?? 'default';
+                records.push({ exportedName: 'default', localName });
+                break;
+            }
+            case 'ExportNamedDeclaration': {
+                const named = node;
+                // `export function Foo() {}` / `export const Foo = ...`
+                if (named.declaration) {
+                    const decl = named.declaration;
+                    if (decl.id) {
+                        records.push({ exportedName: decl.id.name, localName: decl.id.name });
+                    }
+                    else if (decl.declarations) {
+                        for (const varDecl of decl.declarations) {
+                            records.push({ exportedName: varDecl.id.name, localName: varDecl.id.name });
+                        }
+                    }
+                }
+                // `export { Foo, Bar as Baz }`
+                for (const spec of named.specifiers) {
+                    records.push({
+                        exportedName: spec.exported.name,
+                        localName: spec.local.name,
+                    });
+                }
+                break;
+            }
+            // ExportAllDeclaration (`export * from '...'`) is handled separately
+            // by _extractBarrelReExports — we intentionally skip it here.
+            default:
+                break;
+        }
+    }
+    return records;
+}
+/**
+ * Extract all `export * from '...'` (barrel re-export) sources from the AST.
+ *
+ * These are forbidden in `'use client'` and `'use server'` modules because
+ * each export must be individually addressable in the Flight protocol.
+ *
+ * @internal
+ */
+function _extractBarrelReExports(body) {
+    const sources = [];
+    for (const node of body) {
+        if (node.type === 'ExportAllDeclaration') {
+            const exportAll = node;
+            const source = exportAll.source?.value;
+            if (typeof source === 'string') {
+                sources.push(source);
+            }
+        }
+    }
+    return sources;
+}
+//# sourceMappingURL=parse.js.map

package/dist/compiler/parse.js.map

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

package/dist/compiler/plugin.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Juice Vite Plugin — `juice/plugin`
+ *
+ * Hooks into Vite's transform lifecycle to:
+ * 1. Detect `'use client'` directives via AST analysis.
+ * 2. Extract client components into separate Rollup chunks.
+ * 3. Replace server-side imports with React Flight proxy references.
+ * 4. Detect `'use server'` directives and register server actions.
+ * 5. Replace client-side imports of server actions with RPC proxies.
+ * 6. Emit a strict, readable `flight-manifest.json` mapping everything.
+ *
+ * @module plugin
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import juice from '@cmj/juice/plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [juice()],
+ * });
+ * ```
+ */
+import type { JuicePluginOptions } from './types.js';
+/**
+ * Create the Juice Vite plugin.
+ *
+ * @param options - Optional plugin configuration.
+ * @returns A Vite {@link Plugin} object.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'vite';
+ * import juice from '@cmj/juice/plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [juice()],
+ * });
+ * ```
+ */
+export default function juice(options?: JuicePluginOptions): any;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/compiler/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwBrD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,GAAG,CAsQ/D"}

package/dist/compiler/plugin.js

@@ -0,0 +1,281 @@
+/**
+ * Juice Vite Plugin — `juice/plugin`
+ *
+ * Hooks into Vite's transform lifecycle to:
+ * 1. Detect `'use client'` directives via AST analysis.
+ * 2. Extract client components into separate Rollup chunks.
+ * 3. Replace server-side imports with React Flight proxy references.
+ * 4. Detect `'use server'` directives and register server actions.
+ * 5. Replace client-side imports of server actions with RPC proxies.
+ * 6. Emit a strict, readable `flight-manifest.json` mapping everything.
+ *
+ * @module plugin
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import juice from '@cmj/juice/plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [juice()],
+ * });
+ * ```
+ */
+import { relative } from 'node:path';
+import { JuiceExportError, JuiceMutualExclusionError, JuiceBarrelExportError, } from './errors.js';
+import { _mayContainDirective, _detectDirective, } from './parse.js';
+import { _generateProxyModule } from './proxy.js';
+import { _generateServerActionProxy } from './server-actions.js';
+import { _buildManifest, _serializeManifest } from './manifest.js';
+import { ClientModuleRegistry } from './registry.js';
+import { ServerActionRegistry } from './server-action-registry.js';
+/**
+ * Virtual module prefix used to serve proxy modules for `'use client'`
+ * components during the server build.
+ *
+ * @internal
+ */
+const VIRTUAL_PREFIX = '\0juice-client-proxy:';
+/**
+ * Create the Juice Vite plugin.
+ *
+ * @param options - Optional plugin configuration.
+ * @returns A Vite {@link Plugin} object.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'vite';
+ * import juice from '@cmj/juice/plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [juice()],
+ * });
+ * ```
+ */
+export default function juice(options) {
+    // ── Options validation ─────────────────────────────────────────
+    if (options !== undefined && options !== null) {
+        if (typeof options !== 'object' || Array.isArray(options)) {
+            throw new TypeError(`juice() options must be a plain object. Received: ${typeof options}`);
+        }
+        if (options.manifestFileName !== undefined &&
+            typeof options.manifestFileName !== 'string') {
+            throw new TypeError(`juice() option 'manifestFileName' must be a string. ` +
+                `Received: ${typeof options.manifestFileName} (${JSON.stringify(options.manifestFileName)})`);
+        }
+        // Warn on unknown keys (non-breaking, but highly suspicious)
+        const knownKeys = new Set(['manifestFileName', 'routes']);
+        for (const key of Object.keys(options)) {
+            if (!knownKeys.has(key)) {
+                console.warn(`[juice] Unknown option "${key}" passed to juice(). ` +
+                    `Known options: ${[...knownKeys].join(', ')}`);
+            }
+        }
+        // Validate routes shape if provided
+        if (options.routes !== undefined) {
+            if (typeof options.routes !== 'object' || options.routes === null || Array.isArray(options.routes)) {
+                throw new TypeError(`juice() option 'routes' must be a plain object mapping URL patterns to route entries. ` +
+                    `Received: ${typeof options.routes}`);
+            }
+            for (const [pattern, entry] of Object.entries(options.routes)) {
+                if (!entry || typeof entry !== 'object' || typeof entry.moduleId !== 'string') {
+                    throw new TypeError(`juice() route "${pattern}" must have a 'moduleId' string property. ` +
+                        `Received: ${JSON.stringify(entry)}`);
+                }
+            }
+        }
+    }
+    const manifestFileName = options?.manifestFileName ?? 'flight-manifest.json';
+    const routes = options?.routes;
+    const clientRegistry = new ClientModuleRegistry();
+    const serverRegistry = new ServerActionRegistry();
+    let config;
+    let isSSR = false;
+    return {
+        name: 'juice:client-components',
+        enforce: 'pre',
+        // ------------------------------------------------------------------
+        // Config phase — capture resolved config
+        // ------------------------------------------------------------------
+        configResolved(resolvedConfig) {
+            config = resolvedConfig;
+            // Detect SSR mode from Vite's build config
+            isSSR = !!resolvedConfig.build.ssr;
+        },
+        // ------------------------------------------------------------------
+        // Transform phase — detect directives via unified analysis
+        // ------------------------------------------------------------------
+        transform(source, id) {
+            // Only process TS/JS/JSX/TSX files
+            if (!/\.[jt]sx?$/.test(id)) {
+                return null;
+            }
+            // Ignore node_modules — use path-segment-bounded check to avoid
+            // false positives (e.g., "/path/node_modules_extra/src/app.tsx")
+            if (/[\/\\]node_modules[\/\\]/.test(id)) {
+                return null;
+            }
+            // Fast-path bail-out: skip full AST parse if no directive is present
+            if (!_mayContainDirective(source)) {
+                return null;
+            }
+            // Parse the AST using Rollup's built-in acorn
+            const moduleSpecifier = relative(config.root, id);
+            let ast;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                ast = this.parse(source);
+            }
+            catch (parseError) {
+                const msg = parseError instanceof Error ? parseError.message : String(parseError);
+                throw new Error(`[juice] Syntax error in ${moduleSpecifier}: ${msg}\n` +
+                    `This file was flagged for directive analysis because it contains ` +
+                    `'use client' or 'use server' as a substring. If this file is not ` +
+                    `a directive module, the issue is a syntax error in your source code.`);
+            }
+            // Unified analysis: single-pass detection + validation
+            const result = _detectDirective(ast);
+            // No directive found — pass through
+            if (result.directive === null) {
+                return null;
+            }
+            // ── Guard: mutual exclusion ──────────────────────────────────
+            if (result.hasMutualExclusion) {
+                throw new JuiceMutualExclusionError(moduleSpecifier);
+            }
+            // ── Guard: barrel re-exports ─────────────────────────────────
+            if (result.barrelReExports.length > 0) {
+                throw new JuiceBarrelExportError(moduleSpecifier, result.directive, result.barrelReExports[0]);
+            }
+            // ── Guard: empty exports ─────────────────────────────────────
+            if (result.exports.length === 0) {
+                throw new JuiceExportError(moduleSpecifier, result.directive);
+            }
+            // ── 'use client' path ────────────────────────────────────────
+            if (result.directive === 'use client') {
+                clientRegistry.register({
+                    moduleSpecifier,
+                    absolutePath: id,
+                    exports: result.exports,
+                });
+                // Server build: replace with Flight proxy
+                if (isSSR) {
+                    return {
+                        code: _generateProxyModule(moduleSpecifier, result.exports),
+                        map: null,
+                    };
+                }
+                // Client build: pass through (Rollup will chunk it)
+                return null;
+            }
+            // ── 'use server' path ────────────────────────────────────────
+            if (result.directive === 'use server') {
+                serverRegistry.register({
+                    moduleSpecifier,
+                    absolutePath: id,
+                    exports: result.exports,
+                });
+                // Client build: replace with RPC proxy
+                if (!isSSR) {
+                    return {
+                        code: _generateServerActionProxy(moduleSpecifier, result.exports),
+                        map: null,
+                    };
+                }
+                // Server build: pass through (real functions)
+                return null;
+            }
+            return null;
+        },
+        // ------------------------------------------------------------------
+        // resolveId — intercept virtual proxy module IDs
+        // ------------------------------------------------------------------
+        resolveId(source, importer) {
+            if (!importer) {
+                return null;
+            }
+            if (source.startsWith(VIRTUAL_PREFIX)) {
+                return source;
+            }
+            return null;
+        },
+        // ------------------------------------------------------------------
+        // buildStart — emit client modules as chunks (client build only)
+        // ------------------------------------------------------------------
+        buildStart() {
+            if (isSSR || clientRegistry.size === 0) {
+                return;
+            }
+            for (const [, info] of clientRegistry.entries()) {
+                this.emitFile({
+                    type: 'chunk',
+                    id: info.absolutePath,
+                    name: _chunkName(info.moduleSpecifier),
+                });
+            }
+        },
+        // ------------------------------------------------------------------
+        // generateBundle — emit flight-manifest.json (client build only)
+        // ------------------------------------------------------------------
+        generateBundle(outputOptions, bundle) {
+            if (isSSR) {
+                return;
+            }
+            if (clientRegistry.size === 0 && serverRegistry.size === 0 && !routes) {
+                return;
+            }
+            // Build chunk map: moduleSpecifier → chunk file names
+            const chunkMap = new Map();
+            for (const [fileName, chunk] of Object.entries(bundle)) {
+                if (chunk.type !== 'chunk')
+                    continue;
+                for (const [specifier, info] of clientRegistry.entries()) {
+                    if (chunk.facadeModuleId === info.absolutePath ||
+                        chunk.moduleIds?.includes(info.absolutePath)) {
+                        const existing = chunkMap.get(specifier) ?? [];
+                        existing.push(fileName);
+                        chunkMap.set(specifier, existing);
+                    }
+                }
+            }
+            // Build _meta for zero-config runtime DX
+            const isDev = config.command === 'serve';
+            const meta = {
+                root: `file://${config.root}/`,
+                mode: isDev ? 'development' : 'production',
+                assetPrefix: config.base || '/',
+                ...(isDev ? { hmrUrl: '/@vite/client' } : {}),
+            };
+            const manifest = _buildManifest(clientRegistry, chunkMap, serverRegistry, routes, meta);
+            const json = _serializeManifest(manifest);
+            this.emitFile({
+                type: 'asset',
+                fileName: manifestFileName,
+                source: json,
+            });
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Derive a human-readable chunk name from a module specifier.
+ *
+ * @example
+ * ```ts
+ * _chunkName('components/Counter.tsx'); // → 'Counter'
+ * _chunkName('src/ui/SearchBar.tsx');   // → 'SearchBar'
+ * ```
+ *
+ * @internal
+ */
+function _chunkName(specifier) {
+    const parts = specifier.replace(/\.[jt]sx?$/, '').split('/');
+    // Use up to the last 2 path segments for uniqueness
+    // e.g., 'components/Counter' instead of just 'Counter'
+    const meaningful = parts.slice(-2).join('_');
+    return meaningful || 'chunk';
+}
+//# sourceMappingURL=plugin.js.map

package/dist/compiler/plugin.js.map

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

package/dist/compiler/proxy.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Generates React Flight proxy modules that replace `'use client'` source
+ * modules in the server build.
+ *
+ * The proxy module exports `registerClientReference` calls for each export
+ * found in the original client component. This allows the React Flight
+ * serializer to emit a reference to the client chunk instead of attempting
+ * to render the component on the server.
+ *
+ * @module proxy
+ * @internal
+ */
+import type { ExportRecord } from './types.js';
+/**
+ * Generate the server-side proxy source code for a `'use client'` module.
+ *
+ * The emitted code replaces the original module in the server bundle.
+ * Each export becomes a `registerClientReference()` call that the React
+ * Flight serializer understands.
+ *
+ * @param moduleSpecifier - Root-relative module path used as the stable ID
+ *                          in the Flight wire format (e.g., `'components/Counter.tsx'`).
+ * @param exports - All exports extracted from the original module AST.
+ * @returns A complete ES module source string ready to feed into Vite's
+ *          `load` hook.
+ *
+ * @example
+ * ```ts
+ * const source = _generateProxyModule('components/Counter.tsx', [
+ *   { exportedName: 'default', localName: 'Counter' },
+ *   { exportedName: 'Badge', localName: 'Badge' },
+ * ]);
+ * // Returns:
+ * // import { registerClientReference } from 'react-server-dom-webpack/server';
+ * // export default registerClientReference({}, 'components/Counter.tsx', 'default');
+ * // export const Badge = registerClientReference({}, 'components/Counter.tsx', 'Badge');
+ * ```
+ *
+ * @internal
+ */
+export declare function _generateProxyModule(moduleSpecifier: string, exports: readonly ExportRecord[]): string;
+//# sourceMappingURL=proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/compiler/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,MAAM,CA6BR"}