npm - @cmj/juice - Versions diffs - 0.0.1 - Mend

@cmj/juice 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (91) hide show

package/LICENSE +21 -0
package/README.md +88 -0
package/dist/cli/commands.d.ts +29 -0
package/dist/cli/commands.d.ts.map +1 -0
package/dist/cli/commands.js +102 -0
package/dist/cli/commands.js.map +1 -0
package/dist/cli/create.d.ts +35 -0
package/dist/cli/create.d.ts.map +1 -0
package/dist/cli/create.js +108 -0
package/dist/cli/create.js.map +1 -0
package/dist/cli/index.d.ts +3 -0
package/dist/cli/index.d.ts.map +1 -0
package/dist/cli/index.js +97 -0
package/dist/cli/index.js.map +1 -0
package/dist/cli/templates.d.ts +14 -0
package/dist/cli/templates.d.ts.map +1 -0
package/dist/cli/templates.js +154 -0
package/dist/cli/templates.js.map +1 -0
package/dist/compiler/errors.d.ts +91 -0
package/dist/compiler/errors.d.ts.map +1 -0
package/dist/compiler/errors.js +110 -0
package/dist/compiler/errors.js.map +1 -0
package/dist/compiler/manifest.d.ts +39 -0
package/dist/compiler/manifest.d.ts.map +1 -0
package/dist/compiler/manifest.js +78 -0
package/dist/compiler/manifest.js.map +1 -0
package/dist/compiler/parse.d.ts +126 -0
package/dist/compiler/parse.d.ts.map +1 -0
package/dist/compiler/parse.js +246 -0
package/dist/compiler/parse.js.map +1 -0
package/dist/compiler/plugin.d.ts +43 -0
package/dist/compiler/plugin.d.ts.map +1 -0
package/dist/compiler/plugin.js +281 -0
package/dist/compiler/plugin.js.map +1 -0
package/dist/compiler/proxy.d.ts +42 -0
package/dist/compiler/proxy.d.ts.map +1 -0
package/dist/compiler/proxy.js +80 -0
package/dist/compiler/proxy.js.map +1 -0
package/dist/compiler/registry.d.ts +58 -0
package/dist/compiler/registry.d.ts.map +1 -0
package/dist/compiler/registry.js +79 -0
package/dist/compiler/registry.js.map +1 -0
package/dist/compiler/server-action-registry.d.ts +57 -0
package/dist/compiler/server-action-registry.d.ts.map +1 -0
package/dist/compiler/server-action-registry.js +76 -0
package/dist/compiler/server-action-registry.js.map +1 -0
package/dist/compiler/server-actions.d.ts +49 -0
package/dist/compiler/server-actions.d.ts.map +1 -0
package/dist/compiler/server-actions.js +89 -0
package/dist/compiler/server-actions.js.map +1 -0
package/dist/compiler/types.d.ts +188 -0
package/dist/compiler/types.d.ts.map +1 -0
package/dist/compiler/types.js +9 -0
package/dist/compiler/types.js.map +1 -0
package/dist/runtime/actions.d.ts +37 -0
package/dist/runtime/actions.d.ts.map +1 -0
package/dist/runtime/actions.js +167 -0
package/dist/runtime/actions.js.map +1 -0
package/dist/runtime/dev.d.ts +43 -0
package/dist/runtime/dev.d.ts.map +1 -0
package/dist/runtime/dev.js +260 -0
package/dist/runtime/dev.js.map +1 -0
package/dist/runtime/errors.d.ts +98 -0
package/dist/runtime/errors.d.ts.map +1 -0
package/dist/runtime/errors.js +124 -0
package/dist/runtime/errors.js.map +1 -0
package/dist/runtime/index.d.ts +3 -0
package/dist/runtime/index.d.ts.map +1 -0
package/dist/runtime/index.js +5 -0
package/dist/runtime/index.js.map +1 -0
package/dist/runtime/matcher.d.ts +44 -0
package/dist/runtime/matcher.d.ts.map +1 -0
package/dist/runtime/matcher.js +83 -0
package/dist/runtime/matcher.js.map +1 -0
package/dist/runtime/render.d.ts +25 -0
package/dist/runtime/render.d.ts.map +1 -0
package/dist/runtime/render.js +141 -0
package/dist/runtime/render.js.map +1 -0
package/dist/runtime/resolve.d.ts +24 -0
package/dist/runtime/resolve.d.ts.map +1 -0
package/dist/runtime/resolve.js +41 -0
package/dist/runtime/resolve.js.map +1 -0
package/dist/runtime/router.d.ts +74 -0
package/dist/runtime/router.d.ts.map +1 -0
package/dist/runtime/router.js +367 -0
package/dist/runtime/router.js.map +1 -0
package/dist/runtime/types.d.ts +245 -0
package/dist/runtime/types.d.ts.map +1 -0
package/dist/runtime/types.js +5 -0
package/dist/runtime/types.js.map +1 -0
package/package.json +92 -0

package/dist/runtime/dev.js ADDED Viewed

@@ -0,0 +1,260 @@
+// ── juice/runtime dev mode ─────────────────────────────────────────
+// Development-only utilities. WinterCG only. No Node.js APIs.
+//
+// These are internal (`_` prefixed) and never exported from the
+// public `juice/runtime` barrel. They are tree-shaken in production
+// builds when the `mode` option is `'production'` (default).
+// ────────────────────────────────────────────────────────────────────
+/**
+ * Generates a rich HTML error overlay for development mode.
+ *
+ * Features:
+ * - Dark theme with syntax-highlighted stack trace
+ * - Source file + line number parsed from Error stack
+ * - Request URL, method, and matched route context
+ * - Auto-refresh via HMR EventSource (if hmrUrl provided)
+ *
+ * @param error   - The caught error (may be Error or unknown).
+ * @param req     - The incoming request (for URL/method display).
+ * @param context - Optional context string (e.g., route path, action ID).
+ * @returns A full HTML string for the error overlay response.
+ *
+ * @internal
+ */
+export function _generateDevErrorOverlay(error, req, context) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    const name = err.name || 'Error';
+    const message = _escapeHtml(err.message);
+    const stack = _formatStack(err.stack ?? '');
+    const url = new URL(req.url);
+    const contextLine = context ? `<p class="ctx">Context: ${_escapeHtml(context)}</p>` : '';
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>🧃 Juice — ${name}</title>
+<style>
+  *{margin:0;padding:0;box-sizing:border-box}
+  body{
+    font-family:'SF Mono','Cascadia Code','Fira Code',monospace;
+    background:#0a0a0f;
+    color:#e4e4e7;
+    min-height:100vh;
+    display:flex;
+    flex-direction:column;
+    padding:2rem;
+  }
+  .bar{
+    display:flex;
+    align-items:center;
+    gap:.75rem;
+    padding:.75rem 1.25rem;
+    background:linear-gradient(135deg,#1a0a2e,#16082a);
+    border:1px solid #2d1b4e;
+    border-radius:12px;
+    margin-bottom:1.5rem;
+  }
+  .bar .logo{font-size:1.5rem}
+  .bar .label{color:#a78bfa;font-size:.85rem;font-weight:600;letter-spacing:.05em}
+  .bar .mode{
+    margin-left:auto;
+    font-size:.7rem;
+    padding:3px 10px;
+    border-radius:100px;
+    background:#7c3aed22;
+    color:#a78bfa;
+    border:1px solid #7c3aed44;
+  }
+  .error-box{
+    background:#18181b;
+    border:1px solid #ef444488;
+    border-left:4px solid #ef4444;
+    border-radius:12px;
+    padding:1.5rem 2rem;
+    margin-bottom:1.5rem;
+  }
+  .error-box h1{
+    color:#ef4444;
+    font-size:1.25rem;
+    font-weight:700;
+    margin-bottom:.5rem;
+  }
+  .error-box .msg{
+    color:#fca5a5;
+    font-size:.95rem;
+    line-height:1.6;
+    word-break:break-word;
+  }
+  .ctx{
+    color:#a1a1aa;
+    font-size:.8rem;
+    margin-top:.75rem;
+    padding:.5rem .75rem;
+    background:#27272a;
+    border-radius:8px;
+  }
+  .req{
+    display:flex;
+    gap:1rem;
+    margin-bottom:1.5rem;
+  }
+  .req .pill{
+    font-size:.75rem;
+    padding:4px 12px;
+    border-radius:100px;
+    background:#27272a;
+    border:1px solid #3f3f46;
+    color:#a1a1aa;
+  }
+  .req .pill b{color:#e4e4e7}
+  .stack-box{
+    background:#18181b;
+    border:1px solid #27272a;
+    border-radius:12px;
+    padding:1.25rem 1.5rem;
+    overflow-x:auto;
+  }
+  .stack-box h2{
+    font-size:.8rem;
+    color:#71717a;
+    text-transform:uppercase;
+    letter-spacing:.1em;
+    margin-bottom:.75rem;
+  }
+  .stack{
+    font-size:.8rem;
+    line-height:2;
+    color:#a1a1aa;
+  }
+  .stack .fn{color:#93c5fd}
+  .stack .file{color:#fbbf24}
+  .stack .line-num{color:#ef4444}
+  .hint{
+    margin-top:1.5rem;
+    padding:1rem 1.25rem;
+    background:#1c1917;
+    border:1px solid #292524;
+    border-radius:8px;
+    font-size:.75rem;
+    color:#78716c;
+    line-height:1.6;
+  }
+  .hint code{color:#a78bfa;font-size:.8rem}
+</style>
+</head>
+<body>
+  <div class="bar">
+    <span class="logo">🧃</span>
+    <span class="label">JUICE RUNTIME ERROR</span>
+    <span class="mode">DEV MODE</span>
+  </div>
+  <div class="req">
+    <span class="pill"><b>${_escapeHtml(req.method)}</b></span>
+    <span class="pill">${_escapeHtml(url.pathname + url.search)}</span>
+  </div>
+  <div class="error-box">
+    <h1>${_escapeHtml(name)}</h1>
+    <p class="msg">${message}</p>
+    ${contextLine}
+  </div>
+  <div class="stack-box">
+    <h2>Stack Trace</h2>
+    <div class="stack">${stack || '<em>No stack trace available</em>'}</div>
+  </div>
+  <div class="hint">
+    💡 This error overlay is only shown in <code>mode: 'development'</code>.
+    In production, a minimal 500 response is returned instead.<br/>
+    Save a file to trigger HMR and auto-reload.
+  </div>
+  <script type="module">
+    // Auto-refresh when Vite signals a full-reload
+    if (import.meta.hot) {
+      import.meta.hot.on('vite:beforeFullReload', () => location.reload());
+    }
+  </script>
+</body>
+</html>`;
+}
+/**
+ * Generates the Vite HMR client `<script>` tag for SSR injection.
+ *
+ * @param hmrUrl - The HMR client URL (default: `'/@vite/client'`).
+ * @returns A `<script type="module">` string.
+ *
+ * @internal
+ */
+export function _generateHmrClientScript(hmrUrl) {
+    const url = hmrUrl || '/@vite/client';
+    return `<script type="module" src="${_escapeHtml(url)}"></script>`;
+}
+/**
+ * Appends a cache-busting timestamp query parameter to a module ID.
+ *
+ * In development mode, this forces the JS runtime to re-evaluate
+ * the module on every `import()` call, ensuring edits are picked up
+ * immediately without a server restart.
+ *
+ * In production, this function should NOT be called — modules are
+ * cached normally for performance.
+ *
+ * @param moduleId - The original module path (e.g., `'./app/routes/home.tsx'`).
+ * @returns The module path with `?t={timestamp}` appended.
+ *
+ * @internal
+ */
+export function _bustModuleCache(moduleId) {
+    const separator = moduleId.includes('?') ? '&' : '?';
+    return `${moduleId}${separator}t=${Date.now()}`;
+}
+// ── Private Helpers ────────────────────────────────────────────────
+/**
+ * Escapes HTML special characters to prevent XSS in the error overlay.
+ * @internal
+ */
+function _escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+}
+/**
+ * Parses and syntax-highlights a stack trace for the error overlay.
+ * Highlights function names in blue, file paths in yellow, and
+ * line numbers in red.
+ *
+ * @internal
+ */
+function _formatStack(stack) {
+    if (!stack)
+        return '';
+    return stack
+        .split('\n')
+        .map((line) => {
+        // Match "    at FunctionName (file:line:col)"
+        const match = line.match(/^\s*at\s+(.+?)\s+\((.+?):(\d+):\d+\)/);
+        if (match) {
+            const fn = match[1];
+            const file = match[2];
+            const lineNum = match[3];
+            return `at <span class="fn">${_escapeHtml(fn)}</span> (<span class="file">${_escapeHtml(file)}</span>:<span class="line-num">${lineNum}</span>)`;
+        }
+        // Match "    at file:line:col" (no function name)
+        const match2 = line.match(/^\s*at\s+(.+?):(\d+):\d+/);
+        if (match2) {
+            const file = match2[1];
+            const lineNum = match2[2];
+            return `at <span class="file">${_escapeHtml(file)}</span>:<span class="line-num">${lineNum}</span>`;
+        }
+        return _escapeHtml(line);
+    })
+        .join('<br/>');
+}
+//# sourceMappingURL=dev.js.map

package/dist/runtime/dev.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/runtime/errors.d.ts ADDED Viewed

@@ -0,0 +1,98 @@
+/**
+ * Base error class for all Juice runtime errors.
+ *
+ * Every error includes:
+ * - A `[juice/runtime]` prefix for instant identification in logs.
+ * - A machine-readable `code` for programmatic error handling.
+ * - An actionable message telling the developer exactly how to fix it.
+ */
+export declare class JuiceRouterError extends Error {
+    /** Machine-readable error code (e.g., `'ROUTE_NOT_FOUND'`). */
+    readonly code: string;
+    name: string;
+    constructor(message: string,
+    /** Machine-readable error code (e.g., `'ROUTE_NOT_FOUND'`). */
+    code: string);
+}
+/**
+ * Thrown when the incoming request URL does not match any route
+ * in the flight manifest.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] No route matches "/dashboard/settings".
+ * // Check that your app/ directory has a page.tsx file for this path,
+ * // then re-run the Juice compiler to regenerate flight-manifest.json.
+ * ```
+ */
+export declare class RouteNotFoundError extends JuiceRouterError {
+    readonly name = "RouteNotFoundError";
+    constructor(pathname: string);
+}
+/**
+ * Thrown when a POST request references a server action ID that
+ * does not exist in the flight manifest.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] Server Action "abc123" not found in the manifest.
+ * // Ensure the function is exported with 'use server' and the manifest
+ * // is up to date.
+ * ```
+ */
+export declare class ActionNotFoundError extends JuiceRouterError {
+    readonly name = "ActionNotFoundError";
+    constructor(actionId: string);
+}
+/**
+ * Thrown when the flight manifest fails structural validation
+ * at router initialization time.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] Invalid flight-manifest.json: missing "routes" field.
+ * // Re-run the Juice compiler to regenerate it.
+ * ```
+ */
+export declare class ManifestValidationError extends JuiceRouterError {
+    readonly name = "ManifestValidationError";
+    constructor(detail: string);
+}
+/**
+ * Thrown when a dynamic `import()` for a route module or server action
+ * module fails at runtime.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] Failed to load module "./app/routes/missing.tsx"
+ * // for route "/missing". The module may have been deleted or the
+ * // flight-manifest.json is stale. Re-run the Juice compiler.
+ * // Cause: Cannot find module './app/routes/missing.tsx'
+ * ```
+ */
+export declare class ModuleLoadError extends JuiceRouterError {
+    readonly name = "ModuleLoadError";
+    constructor(moduleId: string, context: string, cause: unknown);
+}
+/**
+ * Thrown internally when a user-provided hook (`onBeforeRequest`,
+ * `onNotFound`, `onError`) throws an exception. The router catches
+ * this to prevent user bugs from crashing the server.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] The "onBeforeRequest" hook threw an error.
+ * // Your hook function must return a Response or void, not throw.
+ * // Cause: Cannot read properties of undefined (reading 'session')
+ * ```
+ */
+export declare class HookExecutionError extends JuiceRouterError {
+    readonly name = "HookExecutionError";
+    constructor(hookName: string, cause: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/runtime/errors.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAKvC,+DAA+D;aAC/C,IAAI,EAAE,MAAM;IALrB,IAAI,EAAE,MAAM,CAAsB;gBAGzC,OAAO,EAAE,MAAM;IACf,+DAA+D;IAC/C,IAAI,EAAE,MAAM;CAI/B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,SAAkB,IAAI,wBAAwB;gBAElC,QAAQ,EAAE,MAAM;CAQ7B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD,SAAkB,IAAI,yBAAyB;gBAEnC,QAAQ,EAAE,MAAM;CAO7B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,SAAQ,gBAAgB;IAC3D,SAAkB,IAAI,6BAA6B;gBAEvC,MAAM,EAAE,MAAM;CAO3B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,SAAkB,IAAI,qBAAqB;gBAGzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO;CAWjB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,SAAkB,IAAI,wBAAwB;gBAElC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAU7C"}

package/dist/runtime/errors.js ADDED Viewed

@@ -0,0 +1,124 @@
+// ── juice/runtime errors ───────────────────────────────────────────
+// Empathic error handling: every error tells the developer
+// WHAT went wrong, WHY, and HOW to fix it.
+// ────────────────────────────────────────────────────────────────────
+/**
+ * Base error class for all Juice runtime errors.
+ *
+ * Every error includes:
+ * - A `[juice/runtime]` prefix for instant identification in logs.
+ * - A machine-readable `code` for programmatic error handling.
+ * - An actionable message telling the developer exactly how to fix it.
+ */
+export class JuiceRouterError extends Error {
+    code;
+    name = 'JuiceRouterError';
+    constructor(message,
+    /** Machine-readable error code (e.g., `'ROUTE_NOT_FOUND'`). */
+    code) {
+        super(`[juice/runtime] ${message}`);
+        this.code = code;
+    }
+}
+/**
+ * Thrown when the incoming request URL does not match any route
+ * in the flight manifest.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] No route matches "/dashboard/settings".
+ * // Check that your app/ directory has a page.tsx file for this path,
+ * // then re-run the Juice compiler to regenerate flight-manifest.json.
+ * ```
+ */
+export class RouteNotFoundError extends JuiceRouterError {
+    name = 'RouteNotFoundError';
+    constructor(pathname) {
+        super(`No route matches "${pathname}". ` +
+            `Check that your app/ directory has a page.tsx file for this path, ` +
+            `then re-run the Juice compiler to regenerate flight-manifest.json.`, 'ROUTE_NOT_FOUND');
+    }
+}
+/**
+ * Thrown when a POST request references a server action ID that
+ * does not exist in the flight manifest.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] Server Action "abc123" not found in the manifest.
+ * // Ensure the function is exported with 'use server' and the manifest
+ * // is up to date.
+ * ```
+ */
+export class ActionNotFoundError extends JuiceRouterError {
+    name = 'ActionNotFoundError';
+    constructor(actionId) {
+        super(`Server Action "${actionId}" not found in the manifest. ` +
+            `Ensure the function is exported with 'use server' and the manifest is up to date.`, 'ACTION_NOT_FOUND');
+    }
+}
+/**
+ * Thrown when the flight manifest fails structural validation
+ * at router initialization time.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] Invalid flight-manifest.json: missing "routes" field.
+ * // Re-run the Juice compiler to regenerate it.
+ * ```
+ */
+export class ManifestValidationError extends JuiceRouterError {
+    name = 'ManifestValidationError';
+    constructor(detail) {
+        super(`Invalid flight-manifest.json: ${detail}. ` +
+            `Re-run the Juice compiler to regenerate it.`, 'INVALID_MANIFEST');
+    }
+}
+/**
+ * Thrown when a dynamic `import()` for a route module or server action
+ * module fails at runtime.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] Failed to load module "./app/routes/missing.tsx"
+ * // for route "/missing". The module may have been deleted or the
+ * // flight-manifest.json is stale. Re-run the Juice compiler.
+ * // Cause: Cannot find module './app/routes/missing.tsx'
+ * ```
+ */
+export class ModuleLoadError extends JuiceRouterError {
+    name = 'ModuleLoadError';
+    constructor(moduleId, context, cause) {
+        const causeMessage = cause instanceof Error ? cause.message : String(cause);
+        super(`Failed to load module "${moduleId}" for ${context}. ` +
+            `The module may have been deleted or the flight-manifest.json is stale. ` +
+            `Re-run the Juice compiler.\nCause: ${causeMessage}`, 'MODULE_LOAD_FAILED');
+    }
+}
+/**
+ * Thrown internally when a user-provided hook (`onBeforeRequest`,
+ * `onNotFound`, `onError`) throws an exception. The router catches
+ * this to prevent user bugs from crashing the server.
+ *
+ * @example
+ * ```
+ * // Error message:
+ * // [juice/runtime] The "onBeforeRequest" hook threw an error.
+ * // Your hook function must return a Response or void, not throw.
+ * // Cause: Cannot read properties of undefined (reading 'session')
+ * ```
+ */
+export class HookExecutionError extends JuiceRouterError {
+    name = 'HookExecutionError';
+    constructor(hookName, cause) {
+        const causeMessage = cause instanceof Error ? cause.message : String(cause);
+        super(`The "${hookName}" hook threw an error. ` +
+            `Your hook function must return a Response or void, not throw.\n` +
+            `Cause: ${causeMessage}`, 'HOOK_EXECUTION_FAILED');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/runtime/errors.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,2DAA2D;AAC3D,2CAA2C;AAC3C,uEAAuE;AAEvE;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAMvB;IALT,IAAI,GAAW,kBAAkB,CAAC;IAE3C,YACE,OAAe;IACf,+DAA+D;IAC/C,IAAY;QAE5B,KAAK,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;QAFpB,SAAI,GAAJ,IAAI,CAAQ;IAG9B,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACpC,IAAI,GAAG,oBAAoB,CAAC;IAE9C,YAAY,QAAgB;QAC1B,KAAK,CACH,qBAAqB,QAAQ,KAAK;YAChC,oEAAoE;YACpE,oEAAoE,EACtE,iBAAiB,CAClB,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IACrC,IAAI,GAAG,qBAAqB,CAAC;IAE/C,YAAY,QAAgB;QAC1B,KAAK,CACH,kBAAkB,QAAQ,+BAA+B;YACvD,mFAAmF,EACrF,kBAAkB,CACnB,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,uBAAwB,SAAQ,gBAAgB;IACzC,IAAI,GAAG,yBAAyB,CAAC;IAEnD,YAAY,MAAc;QACxB,KAAK,CACH,iCAAiC,MAAM,IAAI;YACzC,6CAA6C,EAC/C,kBAAkB,CACnB,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACjC,IAAI,GAAG,iBAAiB,CAAC;IAE3C,YACE,QAAgB,EAChB,OAAe,EACf,KAAc;QAEd,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,KAAK,CACH,0BAA0B,QAAQ,SAAS,OAAO,IAAI;YACpD,yEAAyE;YACzE,sCAAsC,YAAY,EAAE,EACtD,oBAAoB,CACrB,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACpC,IAAI,GAAG,oBAAoB,CAAC;IAE9C,YAAY,QAAgB,EAAE,KAAc;QAC1C,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,KAAK,CACH,QAAQ,QAAQ,yBAAyB;YACvC,iEAAiE;YACjE,UAAU,YAAY,EAAE,EAC1B,uBAAuB,CACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/runtime/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export { createRouter } from './router.js';
+export type { FlightManifest, RouterOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/runtime/index.js ADDED Viewed

@@ -0,0 +1,5 @@
+// ── juice/runtime ──────────────────────────────────────────────────
+// Public API barrel. Three exports. One function, two types.
+// ────────────────────────────────────────────────────────────────────
+export { createRouter } from './router.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,6DAA6D;AAC7D,uEAAuE;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/matcher.d.ts ADDED Viewed

@@ -0,0 +1,44 @@
+import type { RouteEntry, _CompiledRoute, _RouteMatch } from './types.js';
+/**
+ * Compiles the manifest's flat route map into an array of `URLPattern`
+ * matchers. Called **once** inside `createRouter` at initialization.
+ *
+ * Patterns use the URLPattern pathname syntax:
+ * - `/blog/:slug` — named parameter
+ * - `/docs/*` — wildcard
+ * - `/` — exact root match
+ *
+ * @param routes   - The `manifest.routes` record (pattern → RouteEntry).
+ * @param basePath - Optional prefix prepended to every pattern.
+ * @returns An array of compiled routes, ordered by declaration order.
+ *
+ * @example
+ * ```ts
+ * const compiled = _compileRoutes(manifest.routes, '/');
+ * // compiled[0].pattern matches URLPattern({ pathname: '/blog/:slug' })
+ * ```
+ *
+ * @internal
+ */
+export declare function _compileRoutes(routes: Readonly<Record<string, RouteEntry>>, basePath: string): _CompiledRoute[];
+/**
+ * Matches a full URL string against the compiled route table.
+ * Returns the first match with extracted pathname params, or `null`.
+ *
+ * @param url      - The full request URL (e.g., `'https://example.com/blog/hello'`).
+ * @param compiled - The pre-compiled route array from `_compileRoutes`.
+ * @returns The matched route entry and extracted params, or `null`.
+ *
+ * @example
+ * ```ts
+ * const match = _matchRoute('https://example.com/blog/hello', compiled);
+ * if (match) {
+ *   console.log(match.params.slug); // 'hello'
+ *   console.log(match.entry.moduleId); // './app/blog/[slug]/page.tsx'
+ * }
+ * ```
+ *
+ * @internal
+ */
+export declare function _matchRoute(url: string, compiled: readonly _CompiledRoute[]): _RouteMatch | null;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/runtime/matcher.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/runtime/matcher.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,EAC5C,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE,CAmBlB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,WAAW,GAAG,IAAI,CAqBpB"}

package/dist/runtime/matcher.js ADDED Viewed

@@ -0,0 +1,83 @@
+// ── juice/runtime matcher ──────────────────────────────────────────
+// Zero-dependency route matching using the WinterCG URLPattern API.
+// Compiled once at startup, matched per-request.
+// ────────────────────────────────────────────────────────────────────
+import { ManifestValidationError } from './errors.js';
+/**
+ * Compiles the manifest's flat route map into an array of `URLPattern`
+ * matchers. Called **once** inside `createRouter` at initialization.
+ *
+ * Patterns use the URLPattern pathname syntax:
+ * - `/blog/:slug` — named parameter
+ * - `/docs/*` — wildcard
+ * - `/` — exact root match
+ *
+ * @param routes   - The `manifest.routes` record (pattern → RouteEntry).
+ * @param basePath - Optional prefix prepended to every pattern.
+ * @returns An array of compiled routes, ordered by declaration order.
+ *
+ * @example
+ * ```ts
+ * const compiled = _compileRoutes(manifest.routes, '/');
+ * // compiled[0].pattern matches URLPattern({ pathname: '/blog/:slug' })
+ * ```
+ *
+ * @internal
+ */
+export function _compileRoutes(routes, basePath) {
+    // Normalize: strip trailing slash from basePath (unless it IS '/')
+    const base = basePath === '/' ? '' : basePath.replace(/\/+$/, '');
+    return Object.entries(routes).map(([pattern, entry]) => {
+        const fullPattern = base + (pattern === '/' ? '/' : pattern);
+        try {
+            return {
+                pattern: new URLPattern({ pathname: fullPattern }),
+                entry,
+            };
+        }
+        catch (cause) {
+            throw new ManifestValidationError(`invalid route pattern "${pattern}" (resolved to "${fullPattern}"). ` +
+                `URLPattern could not parse it. ` +
+                `Check the route keys in your manifest`);
+        }
+    });
+}
+/**
+ * Matches a full URL string against the compiled route table.
+ * Returns the first match with extracted pathname params, or `null`.
+ *
+ * @param url      - The full request URL (e.g., `'https://example.com/blog/hello'`).
+ * @param compiled - The pre-compiled route array from `_compileRoutes`.
+ * @returns The matched route entry and extracted params, or `null`.
+ *
+ * @example
+ * ```ts
+ * const match = _matchRoute('https://example.com/blog/hello', compiled);
+ * if (match) {
+ *   console.log(match.params.slug); // 'hello'
+ *   console.log(match.entry.moduleId); // './app/blog/[slug]/page.tsx'
+ * }
+ * ```
+ *
+ * @internal
+ */
+export function _matchRoute(url, compiled) {
+    for (const route of compiled) {
+        const result = route.pattern.exec(url);
+        if (result) {
+            // URLPattern groups are Record<string, string | undefined>.
+            // Filter out undefined values for a clean params object.
+            const rawGroups = result.pathname.groups;
+            const params = {};
+            for (const key of Object.keys(rawGroups)) {
+                const value = rawGroups[key];
+                if (value !== undefined) {
+                    params[key] = value;
+                }
+            }
+            return { entry: route.entry, params };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=matcher.js.map

package/dist/runtime/matcher.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../src/runtime/matcher.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,oEAAoE;AACpE,iDAAiD;AACjD,uEAAuE;AAGvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA4C,EAC5C,QAAgB;IAEhB,mEAAmE;IACnE,MAAM,IAAI,GAAG,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAElE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE;QACrD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,IAAI,UAAU,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;gBAClD,KAAK;aACN,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,IAAI,uBAAuB,CAC/B,0BAA0B,OAAO,mBAAmB,WAAW,MAAM;gBACnE,iCAAiC;gBACjC,uCAAuC,CAC1C,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,QAAmC;IAEnC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,MAAM,EAAE,CAAC;YACX,4DAA4D;YAC5D,yDAAyD;YACzD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACzC,MAAM,MAAM,GAA2B,EAAE,CAAC;YAE1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}