@kabyeon/nexusjs 0.6.5

package/dist/view/index.js

@@ -0,0 +1,240 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __legacyDecorateClassTS = function(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+    r = Reflect.decorate(decorators, target, key, desc);
+  else
+    for (var i = decorators.length - 1;i >= 0; i--)
+      if (d = decorators[i])
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __legacyDecorateParamTS = (index, decorator) => (target, key) => decorator(target, key, index);
+var __legacyMetadataTS = (k, v) => {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
+    return Reflect.metadata(k, v);
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// src/view/rendu.ts
+import { compileTemplate } from "rendu";
+
+class RenduAdapter {
+  name = "rendu";
+  cache = new Map;
+  render(template, data, context, options) {
+    const safe = {};
+    for (const [k, v] of Object.entries(data)) {
+      safe[k] = typeof v === "string" ? v : v == null ? "" : String(v);
+    }
+    const merged = this.mergeData(safe, context, options);
+    return this.getCompiled(template, options)(merged);
+  }
+  compile(template, options) {
+    const compiled = this.getCompiled(template, options);
+    return (data) => compiled(data);
+  }
+  getCompiled(template, options) {
+    const cacheKey = options ? `${options.stream ? "s" : ""}` : "";
+    let compiled = this.cache.get(cacheKey);
+    if (!compiled) {
+      compiled = compileTemplate(template, {
+        stream: options?.stream ?? false
+      });
+      this.cache.set(cacheKey, compiled);
+    }
+    return compiled;
+  }
+  mergeData(data, context, options) {
+    const merged = { ...data };
+    if (context) {
+      if (context.request)
+        merged.$REQUEST = context.request;
+      if (context.response)
+        merged.$RESPONSE = context.response;
+      if (context.globals)
+        Object.assign(merged, context.globals);
+    }
+    if (options?.layout)
+      merged.$LAYOUT = options.layout;
+    return merged;
+  }
+}
+var init_rendu = () => {};
+
+// src/view/edge.ts
+class EdgeAdapter {
+  edge;
+  name = "edge";
+  constructor(edge) {
+    this.edge = edge;
+  }
+  async render(template, data, context, options) {
+    if (!this.edge) {
+      throw new Error("EdgeAdapter requires an Edge instance. " + "Install `edge.js` and pass it to `new EdgeAdapter(edge)`, " + "or use the default RenduAdapter instead.");
+    }
+    const fn = this.edge.renderRaw ?? this.edge.renderString;
+    if (!fn) {
+      throw new Error("Provided Edge instance does not implement renderRaw/renderString.");
+    }
+    return fn.call(this.edge, template, { ...data, $OPTIONS: options });
+  }
+}
+
+// src/view/eta.ts
+class EtaAdapter {
+  name = "eta";
+  cache = new Map;
+  async render(template, data, _context, _options) {
+    const compiled = this.getCompiled(template);
+    return compiled(data);
+  }
+  compile(template, _options) {
+    const compiled = this.getCompiled(template);
+    return (data) => Promise.resolve(compiled(data));
+  }
+  getCompiled(template) {
+    let fn = this.cache.get(template);
+    if (!fn) {
+      let Eta;
+      try {
+        Eta = __require("eta").Eta;
+      } catch (e) {
+        throw new Error(`[nexus] EtaAdapter: the "eta" package is not installed. ` + `Run \`bun add eta\` (or \`npm install eta\`) to use .eta templates.`);
+      }
+      const eta = new Eta;
+      fn = (data) => eta.renderString(template, data);
+      this.cache.set(template, fn);
+    }
+    return fn;
+  }
+}
+
+// src/view/view-engine.ts
+var exports_view_engine = {};
+__export(exports_view_engine, {
+  setViewPaths: () => setViewPaths,
+  renderView: () => renderView,
+  loadTemplate: () => loadTemplate,
+  getViewPaths: () => getViewPaths
+});
+function setViewPaths(path) {
+  viewPath = path ? path.endsWith("/") || path.endsWith("\\") ? path : `${path}/` : "";
+}
+function getViewPaths() {
+  return viewPath;
+}
+function isViewFilePath(name) {
+  const lower = name.toLowerCase();
+  return VIEW_FILE_EXTS.some((ext) => lower.endsWith(ext));
+}
+function selectAdapter(template) {
+  const lower = template.toLowerCase();
+  if (lower.endsWith(".edge"))
+    return new EdgeAdapter;
+  if (lower.endsWith(".eta"))
+    return new EtaAdapter;
+  return new RenduAdapter;
+}
+async function renderView(template, data, context) {
+  let source = template;
+  if (isViewFilePath(template) && viewPath.length > 0) {
+    const loaded = await loadTemplate(viewPath, template);
+    if (loaded === null) {
+      throw new Error(`[nexus] View file not found: "${template}" (searched: ${viewPath})`);
+    }
+    source = loaded;
+  }
+  const adapter = selectAdapter(source);
+  return adapter.render(source, data, context);
+}
+async function loadTemplate(dir, name) {
+  if (!dir)
+    return null;
+  const full = joinPath(dir, name);
+  try {
+    const file = await readFile(full);
+    if (file !== null)
+      return file;
+  } catch {}
+  return null;
+}
+function joinPath(dir, name) {
+  if (!dir.endsWith("/") && !dir.endsWith("\\"))
+    return `${dir}/${name}`;
+  return `${dir}${name}`;
+}
+async function readFile(path) {
+  if (typeof globalThis.Bun !== "undefined") {
+    try {
+      const file = globalThis.Bun.file(path);
+      if (await file.exists())
+        return file.text();
+    } catch {}
+  }
+  try {
+    const fs = await import("fs/promises");
+    return await fs.readFile(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+var viewPath = "", VIEW_FILE_EXTS;
+var init_view_engine = __esm(() => {
+  init_rendu();
+  VIEW_FILE_EXTS = [".html", ".edge", ".rendu", ".eta"];
+});
+
+// src/view/index.ts
+init_rendu();
+init_view_engine();
+export {
+  setViewPaths,
+  renderView,
+  loadTemplate,
+  getViewPaths,
+  RenduAdapter,
+  EtaAdapter,
+  EdgeAdapter
+};
+
+//# debugId=8CC13EEB69A7C3E164756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/view/index.js.map

@@ -0,0 +1,14 @@
+{
+  "version": 3,
+  "sources": ["../src/view/rendu.ts", "../src/view/edge.ts", "../src/view/eta.ts", "../src/view/view-engine.ts", "../src/view/index.ts"],
+  "sourcesContent": [
+    "/**\n * Rendu template engine adapter.\n *\n * Rendu is a PHP-style templating library that compiles templates into\n * render functions, which makes it fast and edge-friendly (no eval, no\n * file-system access at render time). It is the default adapter because\n * it works on every runtime the framework supports.\n *\n * See: https://github.com/h3js/rendu\n */\nimport { compileTemplate } from \"rendu\";\nimport type { ViewAdapter, ViewContext, ViewOptions } from \"./types.js\";\n\nexport class RenduAdapter implements ViewAdapter {\n\treadonly name = \"rendu\";\n\tprivate cache = new Map<string, ReturnType<typeof compileTemplate>>();\n\n\trender(\n\t\ttemplate: string,\n\t\tdata: Record<string, any>,\n\t\tcontext?: ViewContext,\n\t\toptions?: ViewOptions,\n\t): Promise<string> {\n\t\t// Workaround for a Rendu 0.1.0 bug: its generated runtime\n\t\t// does `typeof chunk === \"string\" ? chunk : new TextDecoder()\n\t\t// .decode(chunk)`, so any non-string chunk (a number from\n\t\t// `<?= year ?>`, a boolean, etc.) throws. We shallow-coerce\n\t\t// top-level values to strings here. The framework's contract\n\t\t// is that view templates render output — arithmetic in\n\t\t// templates is rare and users who need it can wrap with\n\t\t// `Number(...)` explicitly.\n\t\tconst safe: Record<string, any> = {};\n\t\tfor (const [k, v] of Object.entries(data)) {\n\t\t\tsafe[k] = typeof v === \"string\" ? v : v == null ? \"\" : String(v);\n\t\t}\n\t\tconst merged = this.mergeData(safe, context, options);\n\t\treturn this.getCompiled(template, options)(merged);\n\t}\n\n\tcompile(template: string, options?: ViewOptions) {\n\t\tconst compiled = this.getCompiled(template, options);\n\t\treturn (data: Record<string, any>) => compiled(data);\n\t}\n\n\tprivate getCompiled(template: string, options?: ViewOptions) {\n\t\tconst cacheKey = options ? `${options.stream ? \"s\" : \"\"}` : \"\";\n\t\tlet compiled = this.cache.get(cacheKey);\n\t\tif (!compiled) {\n\t\t\tcompiled = compileTemplate(template, {\n\t\t\t\tstream: options?.stream ?? false,\n\t\t\t});\n\t\t\tthis.cache.set(cacheKey, compiled);\n\t\t}\n\t\treturn compiled;\n\t}\n\n\t/** Merge user data with view context globals. */\n\tprivate mergeData(\n\t\tdata: Record<string, any>,\n\t\tcontext?: ViewContext,\n\t\toptions?: ViewOptions,\n\t): Record<string, any> {\n\t\tconst merged: Record<string, any> = { ...data };\n\t\tif (context) {\n\t\t\tif (context.request) merged.$REQUEST = context.request;\n\t\t\tif (context.response) merged.$RESPONSE = context.response;\n\t\t\tif (context.globals) Object.assign(merged, context.globals);\n\t\t}\n\t\tif (options?.layout) merged.$LAYOUT = options.layout;\n\t\treturn merged;\n\t}\n}\n",
+    "/**\n * Edge-style template engine adapter (Adonis-style).\n *\n * Edge is the templating engine built for AdonisJS with a mustache-like\n * syntax (`{{ }}`, `@if`, `@each`). It is bundled here as a placeholder\n * for users who prefer that style.\n *\n * The adapter does not bundle Edge directly — it expects the user to\n * provide an `Edge` instance via the constructor so the dependency\n * stays optional.\n */\nimport type { ViewAdapter, ViewContext, ViewOptions } from \"./types.js\";\n\nexport interface EdgeLike {\n\trenderRaw?: (template: string, data: Record<string, any>) => Promise<string>;\n\trenderString?: (\n\t\ttemplate: string,\n\t\tdata: Record<string, any>,\n\t) => Promise<string>;\n}\n\nexport class EdgeAdapter implements ViewAdapter {\n\treadonly name = \"edge\";\n\tconstructor(private edge?: EdgeLike) {}\n\n\tasync render(\n\t\ttemplate: string,\n\t\tdata: Record<string, any>,\n\t\tcontext?: ViewContext,\n\t\toptions?: ViewOptions,\n\t): Promise<string> {\n\t\tif (!this.edge) {\n\t\t\tthrow new Error(\n\t\t\t\t\"EdgeAdapter requires an Edge instance. \" +\n\t\t\t\t\t\"Install `edge.js` and pass it to `new EdgeAdapter(edge)`, \" +\n\t\t\t\t\t\"or use the default RenduAdapter instead.\",\n\t\t\t);\n\t\t}\n\t\tconst fn = this.edge.renderRaw ?? this.edge.renderString;\n\t\tif (!fn) {\n\t\t\tthrow new Error(\n\t\t\t\t\"Provided Edge instance does not implement renderRaw/renderString.\",\n\t\t\t);\n\t\t}\n\t\treturn fn.call(this.edge, template, { ...data, $OPTIONS: options });\n\t}\n}\n",
+    "/**\n * Eta template engine adapter.\n *\n * Eta is a lightweight, high-performance templating engine with\n * EJS-like syntax (`<%= expr %>`, `<% code %>`). It works on every\n * runtime (Bun, Node, Deno, Cloudflare Workers) because templates\n * are compiled to JavaScript render functions — no eval, no\n * filesystem access at render time.\n *\n * Install (optional peer dep): `bun add eta`\n *\n *   import { EtaAdapter } from \"nexusjs/view\";\n *   const eta = new EtaAdapter();\n *   const html = await eta.render(\"<h1><%= it.title %></h1>\", { title: \"Hi\" });\n *\n * Or just use a file with a `.eta` extension — `renderView` picks\n * the Eta adapter automatically:\n *\n *   setViewPaths(\"views\");\n *   return { view: \"about.eta\", data: { title: \"Hi\" } };\n */\nimport type { ViewAdapter, ViewContext, ViewOptions } from \"./types.js\";\n\nexport class EtaAdapter implements ViewAdapter {\n\treadonly name = \"eta\";\n\tprivate cache = new Map<string, (data: Record<string, any>) => string>();\n\n\tasync render(\n\t\ttemplate: string,\n\t\tdata: Record<string, any>,\n\t\t_context?: ViewContext,\n\t\t_options?: ViewOptions,\n\t): Promise<string> {\n\t\tconst compiled = this.getCompiled(template);\n\t\treturn compiled(data);\n\t}\n\n\tcompile(template: string, _options?: ViewOptions) {\n\t\tconst compiled = this.getCompiled(template);\n\t\treturn (data: Record<string, any>) => Promise.resolve(compiled(data));\n\t}\n\n\tprivate getCompiled(template: string) {\n\t\tlet fn = this.cache.get(template);\n\t\tif (!fn) {\n\t\t\t// Lazy require so `eta` is truly optional. If the\n\t\t\t// user never uses `.eta` files, Eta isn't loaded.\n\t\t\tlet Eta: any;\n\t\t\ttry {\n\t\t\t\t// @ts-ignore — eta is an optional peer dep\n\t\t\t\tEta = require(\"eta\").Eta;\n\t\t\t} catch (e) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`[nexus] EtaAdapter: the \"eta\" package is not installed. ` +\n\t\t\t\t\t\t`Run \\`bun add eta\\` (or \\`npm install eta\\`) to use .eta templates.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst eta = new Eta();\n\t\t\tfn = (data: Record<string, any>) =>\n\t\t\t\teta.renderString(template, data) as string;\n\t\t\tthis.cache.set(template, fn);\n\t\t}\n\t\treturn fn;\n\t}\n}\n",
+    "/**\n * View engine abstraction.\n *\n * The framework can render templates using any installed engine. Built-in\n * adapters ship for Rendu (PHP-style templates), Edge (Adonis-style),\n * and Eta (EJS-style).\n *\n * The default adapter is Rendu because it works on every runtime —\n * Cloudflare Workers, Bun, Deno, and Node — without extra dependencies.\n */\nimport { RenduAdapter } from \"./rendu.js\";\nimport { EdgeAdapter } from \"./edge.js\";\nimport { EtaAdapter } from \"./eta.js\";\nimport type { ViewAdapter, ViewContext } from \"./types.js\";\n\nexport type { ViewAdapter, ViewContext, ViewOptions } from \"./types.js\";\n\n/**\n * A single directory to search when the `view` value looks like a file path\n * (e.g. `\"about.html\"` or `\"emails/welcome.html\"`). Configured via\n * `setViewPaths()` or `Application.setViewPaths()`. Empty by default\n * — leave it empty (the default) to require inline templates,\n * or set it once at boot to enable file-based views.\n */\nlet viewPath: string = \"\";\n\n/** Set the directory searched for view files. Pass `\"\"` to disable. */\nexport function setViewPaths(path: string): void {\n\tviewPath = path ? (path.endsWith(\"/\") || path.endsWith(\"\\\\\") ? path : `${path}/`) : \"\";\n}\n\n/** Return the current view path (empty string means disabled). */\nexport function getViewPaths(): string {\n\treturn viewPath;\n}\n\n/** File extensions that indicate the `view` value is a file path. */\nconst VIEW_FILE_EXTS = [\".html\", \".edge\", \".rendu\", \".eta\"] as const;\n\n/**\n * Is the given string a file path (i.e. has one of the known view\n * file extensions)? Used to decide whether `renderView` should\n * load the file from disk or treat the string as inline source.\n */\nfunction isViewFilePath(name: string): boolean {\n\tconst lower = name.toLowerCase();\n\treturn VIEW_FILE_EXTS.some((ext) => lower.endsWith(ext));\n}\n\n/**\n * Pick the right adapter for a given template source. Selection\n * is by file extension:\n *   `.edge`  → EdgeAdapter\n *   `.eta`   → EtaAdapter\n *   `.html` / `.rendu` / no extension  → RenduAdapter (default)\n */\nfunction selectAdapter(template: string): ViewAdapter {\n\tconst lower = template.toLowerCase();\n\tif (lower.endsWith(\".edge\")) return new EdgeAdapter();\n\tif (lower.endsWith(\".eta\")) return new EtaAdapter();\n\treturn new RenduAdapter();\n}\n\n/**\n * Render a view.\n *\n * - If `template` ends in a known view file extension (`.html`,\n *   `.edge`, `.rendu`, `.eta`) and `viewPaths` is non-empty, the\n *   file is loaded from the first matching directory and used\n *   as the template source. The adapter is picked by extension.\n * - Otherwise `template` is treated as inline template source\n *   with the default (Rendu) adapter.\n *\n * Override the default adapter globally with\n * `app.setViewAdapter()`.\n */\nexport async function renderView(\n\ttemplate: string,\n\tdata: Record<string, any>,\n\tcontext?: ViewContext,\n): Promise<string> {\n\tlet source = template;\n\tif (isViewFilePath(template) && viewPath.length > 0) {\n\t\tconst loaded = await loadTemplate(viewPath, template);\n\t\tif (loaded === null) {\n\t\t\tthrow new Error(\n\t\t\t\t`[nexus] View file not found: \"${template}\" (searched: ${viewPath})`,\n\t\t\t);\n\t\t}\n\t\tsource = loaded;\n\t}\n\tconst adapter = selectAdapter(source);\n\treturn adapter.render(source, data, context);\n}\n\n/**\n * Try to locate a template file inside the given directory. Returns the\n * file contents or `null` if not found. This is intentionally\n * filesystem-based and only used on serverful runtimes; edge adapters\n * should pass inline strings instead.\n */\nexport async function loadTemplate(\n\tdir: string,\n\tname: string,\n): Promise<string | null> {\n\tif (!dir) return null;\n\tconst full = joinPath(dir, name);\n\ttry {\n\t\tconst file = await readFile(full);\n\t\tif (file !== null) return file;\n\t} catch {\n\t\t// ignore\n\t}\n\treturn null;\n}\n\n/**\n * Path join that works on both POSIX and Windows. Node/Bun provide path,\n * but Cloudflare Workers do not, so we re-implement minimally.\n */\nfunction joinPath(dir: string, name: string): string {\n\tif (!dir.endsWith(\"/\") && !dir.endsWith(\"\\\\\")) return `${dir}/${name}`;\n\treturn `${dir}${name}`;\n}\n\nasync function readFile(path: string): Promise<string | null> {\n\t// Node/Bun.\n\tif (typeof globalThis.Bun !== \"undefined\") {\n\t\ttry {\n\t\t\tconst file = (globalThis as any).Bun.file(path);\n\t\t\tif (await file.exists()) return file.text();\n\t\t} catch {\n\t\t\t// ignore\n\t\t}\n\t}\n\t// Node-style (also works in Bun).\n\ttry {\n\t\tconst fs = await import(\"node:fs/promises\");\n\t\treturn await fs.readFile(path, \"utf8\");\n\t} catch {\n\t\treturn null;\n\t}\n}\n",
+    "/**\n * `nexusjs/view` — view engine adapter + file-based view loader.\n *\n * Public API:\n * - `renderView(template, data, context?)` — render a view.\n *   If `template` ends in a known file extension (`.html`, `.edge`,\n *   `.rendu`, `.eta`) AND `setViewPaths()` has been called, the\n *   file is loaded from the first matching directory and used\n *   as the template source. Otherwise the string is treated as\n *   inline source.\n *   The adapter is selected by file extension (or Rendu for\n *   inline / non-extension values).\n * - `setViewPaths(path)` — configure the directory searched for\n *   view files. Pass `\"\"` to disable.\n * - `getViewPaths()` — return the current path (empty = disabled).\n * - `loadTemplate(dir, name)` — low-level: load a file from\n *   the given directory.\n * - `Application.setViewPaths(path)` — same as the module\n *   function, but chainable.\n *\n * Adapters:\n * - RenduAdapter  (default for `.html`/`.rendu`/inline)\n * - EdgeAdapter   (for `.edge`)\n * - EtaAdapter    (for `.eta`)\n *\n * Override with `app.setViewAdapter(new MyAdapter())` to install\n * a different engine globally.\n */\n\nexport type {\n\tViewAdapter,\n\tViewContext,\n\tViewOptions,\n} from \"./types.js\";\nexport { RenduAdapter } from \"./rendu.js\";\nexport { EdgeAdapter } from \"./edge.js\";\nexport { EtaAdapter } from \"./eta.js\";\nexport {\n\trenderView,\n\tloadTemplate,\n\tsetViewPaths,\n\tgetViewPaths,\n} from \"./view-engine.js\";\n"
+  ],
+  "mappings": "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",
+  "debugId": "8CC13EEB69A7C3E164756E2164756E21",
+  "names": []
+}

package/dist/view/inertia/default-ssr.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default Inertia HTML shell renderer.
+ *
+ * When no SSR adapter is configured (the most common case for getting
+ * started), we ship a minimal HTML page with the page object embedded
+ * as a `data-page` attribute. The client picks it up and hydrates from
+ * there.
+ *
+ * When an SSR adapter is configured, we render the page tree and
+ * inject the resulting HTML into `<div id="app">` before sending.
+ */
+import type { Context } from "hono";
+import type { InertiaAdapter, InertiaPage, SsrAdapter } from "./types.js";
+export declare function renderDefaultRoot(adapter: InertiaAdapter, ssr: SsrAdapter | null, component: string, page: InertiaPage, c: Context): Promise<Response>;
+//# sourceMappingURL=default-ssr.d.ts.map

package/dist/view/inertia/default-ssr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-ssr.d.ts","sourceRoot":"","sources":["../../../src/view/inertia/default-ssr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1E,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,UAAU,GAAG,IAAI,EACtB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,OAAO,GACR,OAAO,CAAC,QAAQ,CAAC,CA8CnB"}

package/dist/view/inertia/form-helper.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Inertia `<Form>` server-side helper.
+ *
+ * Mirrors the Inertia v3 client-side `<Form>` component behaviour:
+ *
+ * 1. Controllers wrap form actions with `inertia.form(...)`.
+ * 2. They validate input (typically with Zod). On failure they call
+ *    `.withErrors(...).render()` and the page re-renders with the
+ *    `errors` and (optionally) `errorBag` props injected.
+ * 3. On success they call `.redirect(url)` which emits a 303 — the
+ *    PRG (Post-Redirect-Get) pattern that prevents double-submits.
+ * 4. `.withValues(input)` re-populates the form after a validation
+ *    failure so the user does not have to retype everything.
+ *
+ * The `errors` prop is special-cased by the Inertia client: it surfaces
+ * validation errors to form fields automatically when you wire up the
+ * matching `useForm` hook. `errorBag` lets multiple forms on the same
+ * page coexist (each form has its own error namespace).
+ *
+ * @example
+ * ```ts
+ * @Post('/users')
+ * async store(@Body() input: any) {
+ *   const form = this.inertia.form('Users/Create');
+ *   const result = UserSchema.safeParse(input);
+ *   if (!result.success) {
+ *     return form
+ *       .withErrorBag('createUser')
+ *       .withErrors(result.error.flatten().fieldErrors)
+ *       .withValues(input)
+ *       .render();
+ *   }
+ *   await this.userService.create(result.data);
+ *   return form.redirect('/users');
+ * }
+ * ```
+ */
+import type { Inertia } from "./inertia-adapter.js";
+import type { InertiaResponse } from "./inertia-response.js";
+/**
+ * Value shape for `withErrors`. Each field maps to a string (single
+ * error) or an array of strings (multiple errors).
+ */
+export type ErrorMap = Record<string, string | string[]>;
+/**
+ * Builder for an Inertia form response. Fluent API — every method
+ * returns `this` so calls can be chained.
+ */
+export declare class InertiaFormBuilder {
+    private readonly adapter;
+    private readonly component;
+    private props;
+    private errorMap;
+    private errorBagName?;
+    constructor(adapter: Inertia, component: string, initialProps?: Record<string, any>);
+    /** Merge a batch of props at once. */
+    withProps(extra: Record<string, any>): this;
+    /** Set a single prop. */
+    with(key: string, value: any): this;
+    /**
+     * Attach validation errors. Each field maps to a string (single
+     * error) or string[] (multiple). Strings are wrapped in arrays
+     * internally to keep the shape uniform.
+     */
+    withErrors(errors: ErrorMap): this;
+    /** Add a single error to a field. */
+    withError(field: string, message: string): this;
+    /**
+     * Name the form's error namespace. Useful when multiple forms share
+     * a page; each `useForm` hook on the client can read its own bag.
+     */
+    withErrorBag(name: string): this;
+    /**
+     * Re-populate the form with the originally submitted values so
+     * users don't have to retype them after a validation failure.
+     */
+    withValues(values: Record<string, any>): this;
+    /**
+     * Render the page with the (possibly error-laden) props. If any
+     * errors were attached, they are automatically injected as the
+     * `errors` prop (and `errorBag` if a bag name was set).
+     */
+    render(): InertiaResponse;
+    /**
+     * Issue a 303 redirect. 303 is the right status for non-GET methods
+     * (POST/PUT/PATCH/DELETE) because it forces the client to follow up
+     * with a GET — i.e. the PRG pattern. This prevents the browser from
+     * resubmitting the form on refresh.
+     */
+    redirect(url: string): Response;
+    /**
+     * Navigate back to the previous page (the Inertia client interprets
+     * `Location: back` and steps one entry in its history). If `to` is
+     * provided, redirect there instead.
+     */
+    back(to?: string): Response;
+    /** Read the currently-accumulated errors (without rendering). */
+    getErrors(): Record<string, string[]>;
+    /** Read the current prop draft. */
+    getProps(): Record<string, any>;
+}
+//# sourceMappingURL=form-helper.d.ts.map

package/dist/view/inertia/form-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-helper.d.ts","sourceRoot":"","sources":["../../../src/view/inertia/form-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAEzD;;;GAGG;AACH,qBAAa,kBAAkB;IAM7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN3B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,YAAY,CAAC,CAAS;gBAGZ,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EAClC,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IASvC,sCAAsC;IACtC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAK3C,yBAAyB;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAKnC;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IASlC,qCAAqC;IACrC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK/C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKhC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAS7C;;;;OAIG;IACH,MAAM,IAAI,eAAe;IAUzB;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAO/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ;IAW3B,iEAAiE;IACjE,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAIrC,mCAAmC;IACnC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAG/B"}

package/dist/view/inertia/form-middleware.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Inertia form middleware.
+ *
+ * Hooks into the request lifecycle for form actions (POST/PUT/PATCH/
+ * DELETE) to do two things:
+ *
+ * 1. **Pre-parse form bodies.** When the client posts URL-encoded or
+ *    multipart data, parsing the body consumes the request stream.
+ *    The framework's `@Body()` parameter decorator parses JSON bodies
+ *    by default; this middleware additionally caches the parsed form
+ *    under `c.var.nexus.formBody` so controllers can read it via
+ *    `c.get('formBody')` without re-parsing.
+ *
+ * 2. **CSRF token validation.** If `validateCsrf` is enabled the
+ *    middleware looks for a token either in a header (`csrfHeader`) or
+ *    a form field (`csrfField`), compares it to the token registered
+ *    in shared props (`csrfSharedKey`), and returns 419 on mismatch.
+ *
+ * The middleware does NOT enforce a specific redirect strategy — the
+ * `InertiaFormBuilder` handles that at the action level (303 + PRG).
+ */
+import type { Context } from "hono";
+import type { Middleware } from "../../core/http/middleware.js";
+export interface InertiaFormMiddlewareOptions {
+    /**
+     * Whether to enforce CSRF validation. Off by default; turn on for
+     * any deployment that exposes session-cookie auth.
+     */
+    validateCsrf?: boolean;
+    /** Header name carrying the CSRF token. Default: `X-CSRF-Token`. */
+    csrfHeader?: string;
+    /** Form field name carrying the CSRF token. Default: `_token`. */
+    csrfField?: string;
+    /**
+     * Key under `sharedProps` where the canonical CSRF token lives.
+     * Default: `csrfToken`. The middleware reads this from
+     * `c.var.nexus?.shared` (populated by `inertia.share(...)`).
+     */
+    csrfSharedKey?: string;
+    /**
+     * Provide a custom CSRF resolver. Overrides the default shared-prop
+     * lookup. Useful when the token is rotated per request via a
+     * dedicated provider.
+     */
+    getCsrfToken?: (c: Context) => string | undefined;
+    /**
+     * Status code to return on CSRF mismatch. Default: 419 (Laravel's
+     * "Page Expired" convention).
+     */
+    csrfFailureStatus?: number;
+}
+export declare function inertiaFormMiddleware(options?: InertiaFormMiddlewareOptions): Middleware;
+//# sourceMappingURL=form-middleware.d.ts.map

package/dist/view/inertia/form-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-middleware.d.ts","sourceRoot":"","sources":["../../../src/view/inertia/form-middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAQ,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,WAAW,4BAA4B;IAC5C;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAElD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAKD,wBAAgB,qBAAqB,CACpC,OAAO,GAAE,4BAAiC,GACxC,UAAU,CAyDZ"}

package/dist/view/inertia/helpers.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Inertia.js lazy-evaluation helpers.
+ *
+ * These wrap a callback so the framework can decide *when* to resolve
+ * it:
+ *
+ * - `defer()`        → resolved on a follow-up partial reload only.
+ * - `always()`       → included in every partial reload, never trimmed.
+ * - `optional()`     → skipped on partial reloads when empty.
+ * - `merge()`        → client merges new value with previous.
+ * - `deepMerge()`    → client deep-merges new value with previous.
+ * - `once()`         → included only on first page load.
+ *
+ * Each helper is a thin wrapper class with a discriminator tag. The
+ * adapter inspects the tag to decide the correct serialization behaviour.
+ */
+/** Common shape for all Inertia helper wrappers. */
+export interface InertiaHelper<T = any> {
+    /** Discriminator tag — read by the adapter, never sent to the client. */
+    readonly __inertiaKind: string;
+    /** Resolve the wrapped callback. */
+    resolve(): T | Promise<T>;
+}
+/**
+ * Deferred prop. The client receives a `null` placeholder initially and
+ * issues a follow-up request to fetch the real value. Use for expensive
+ * data that shouldn't block the initial render.
+ */
+export declare class DeferredProp<T = any> implements InertiaHelper<T> {
+    private readonly callback;
+    /** Group name. Props in the same group resolve in one request. */
+    readonly group: string;
+    readonly __inertiaKind = "deferred";
+    constructor(callback: () => T | Promise<T>, 
+    /** Group name. Props in the same group resolve in one request. */
+    group?: string);
+    resolve(): T | Promise<T>;
+}
+/** Build a deferred prop. */
+export declare function defer<T>(callback: () => T | Promise<T>, group?: string): DeferredProp<T>;
+/**
+ * Always-on prop. Included in *every* partial reload, regardless of the
+ * client's `only` / `except` filter. Useful for data that nearly every
+ * page needs (e.g. notification counts, current user).
+ */
+export declare class AlwaysProp<T = any> implements InertiaHelper<T> {
+    private readonly callback;
+    readonly __inertiaKind = "always";
+    constructor(callback: () => T | Promise<T>);
+    resolve(): T | Promise<T>;
+}
+export declare function always<T>(callback: () => T | Promise<T>): AlwaysProp<T>;
+/**
+ * Optional prop. On partial reloads, omitted when the resolved value is
+ * an array shorter than or equal to `threshold` (default 0). Helps
+ * reduce response size when the user is filtering down to zero results.
+ */
+export declare class OptionalProp<T = any> implements InertiaHelper<T> {
+    private readonly callback;
+    readonly threshold: number;
+    readonly __inertiaKind = "optional";
+    constructor(callback: () => T | Promise<T>, threshold?: number);
+    resolve(): T | Promise<T>;
+}
+export declare function optional<T>(callback: () => T | Promise<T>, threshold?: number): OptionalProp<T>;
+/**
+ * Merge prop. The client merges the new value with its previous value,
+ * which is essential for infinite-scroll pagination (append rather
+ * than replace).
+ */
+export declare class MergeProp<T = any> implements InertiaHelper<T> {
+    readonly __inertiaKind = "merge";
+    /**
+     * When provided, the client uses these paths to identify matching
+     * items between the old and new arrays. Each inner array is a list of
+     * property names whose combined values are compared.
+     */
+    readonly matchPropsOn: string[][];
+    constructor(callback: () => T | Promise<T>, matchPropsOn?: string[][]);
+    private callback;
+    resolve(): T | Promise<T>;
+}
+export declare function merge<T>(callback: () => T | Promise<T>, matchPropsOn?: string[][]): MergeProp<T>;
+/**
+ * Deep-merge prop. Like `merge`, but the client performs a recursive
+ * object merge instead of array deduplication.
+ */
+export declare class DeepMergeProp<T = any> implements InertiaHelper<T> {
+    private readonly callback;
+    readonly __inertiaKind = "deepMerge";
+    constructor(callback: () => T | Promise<T>);
+    resolve(): T | Promise<T>;
+}
+export declare function deepMerge<T>(callback: () => T | Promise<T>): DeepMergeProp<T>;
+/**
+ * Once prop. Resolved and included only on the very first page load;
+ * subsequent partial reloads never include it.
+ */
+export declare class OnceProp<T = any> implements InertiaHelper<T> {
+    private readonly callback;
+    readonly __inertiaKind = "once";
+    constructor(callback: () => T | Promise<T>);
+    resolve(): T | Promise<T>;
+}
+export declare function once<T>(callback: () => T | Promise<T>): OnceProp<T>;
+/**
+ * Lazy prop. Resolved on every response (just like a plain prop), but
+ * with two important differences:
+ *
+ * 1. The factory is invoked only once per request — even if multiple
+ *    keys point at the same factory or the same prop is referenced
+ *    elsewhere on the page. The adapter keys the cache on
+ *    `LazyProp.tag`, so two `lazy()` calls with the same tag share
+ *    their resolved value.
+ * 2. Resolutions run alongside other lazy props so independent work
+ *    can overlap.
+ *
+ * Use this for any expensive computation you don't want to repeat
+ * within a single request, but that should not be deferred to a
+ * follow-up partial reload.
+ */
+export declare class LazyProp<T = any> implements InertiaHelper<T> {
+    private readonly callback;
+    readonly __inertiaKind = "lazy";
+    /** Cache key used by the adapter to deduplicate. */
+    readonly tag: string;
+    /** Increments on every resolve() — useful for tests / observability. */
+    invocations: number;
+    constructor(callback: () => T | Promise<T>, tag?: string);
+    resolve(): T | Promise<T>;
+}
+/** Build a lazy prop. Two calls with the same `tag` share their value. */
+export declare function lazy<T>(callback: () => T | Promise<T>, tag?: string): LazyProp<T>;
+/**
+ * Type guard: check whether a value is any Inertia helper wrapper.
+ */
+export declare function isInertiaHelper(value: unknown): value is InertiaHelper;
+/**
+ * Strip helper wrappers from a props object, returning a plain
+ * `{ [helperKind]: string[] }` map of which keys were wrapped and how.
+ */
+export interface PropAnnotation {
+    /** Map of helperKind → array of prop keys. */
+    byKind: Record<string, string[]>;
+    /** Optional config extracted per prop (e.g. merge matchPropsOn). */
+    configs: Record<string, InertiaHelper>;
+}
+export declare function annotateProps(props: Record<string, any>): PropAnnotation;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/view/inertia/helpers.d.ts.map

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

package/dist/view/inertia/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Inertia adapter barrel.
+ *
+ * Public exports for the server-side Inertia.js v2/v3 adapter. The
+ * adapter implements the Inertia protocol: JSON responses for XHR,
+ * HTML shell with embedded page data for first-page loads, deferred /
+ * merge / always / once / lazy prop helpers, asset versioning, shared
+ * data, form helpers, and a pluggable SSR adapter interface.
+ */
+export * from "./types.js";
+export * from "./helpers.js";
+export * from "./inertia-response.js";
+export * from "./form-helper.js";
+export * from "./form-middleware.js";
+export * from "./inertia-adapter.js";
+export * from "./default-ssr.js";
+export * from "./ssr/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/view/inertia/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/view/inertia/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}