@nexusts/view 0.7.2

package/README.md

@@ -0,0 +1,41 @@
+# @nexusts/view
+
+> **NexusTS** — Bun-native fullstack framework
+
+## Description
+
+View engines (Rendu, Edge, Eta) + Inertia.js v2 adapter.
+
+3 engines: Rendu (default, every runtime), Edge (Adonis-style .edge), Eta (EJS-style .eta). Inertia v2 adapter for React + Vue SPAs and SSR.
+
+## Install
+
+This module is part of the NexusTS monorepo. Each module is published as its own npm package under the `@nexusts/` scope.
+
+Most apps start with just the core:
+
+```bash
+bun add @nexusts/core
+```
+
+Then add this module only if you need it:
+
+```bash
+bun add @nexusts/view
+```
+
+## Peer dependencies
+
+**None.** No external dependencies for Rendu / Edge / Eta. Inertia.js React requires `react` and `@inertiajs/react`; Inertia.js Vue requires `vue` and `@inertiajs/vue3`.
+
+## Usage
+
+```typescript
+import { /* public API */ } from "@nexusts/view";
+```
+
+See the [user guide](../../docs/user-guide/view.md) and the [example app](../../examples/) for a working demo.
+
+## License
+
+MIT — see the root [LICENSE](../../LICENSE).

package/dist/edge.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Edge-style template engine adapter (Adonis-style).
+ *
+ * Edge is the templating engine built for AdonisJS with a mustache-like
+ * syntax (`{{ }}`, `@if`, `@each`). It is bundled here as a placeholder
+ * for users who prefer that style.
+ *
+ * The adapter does not bundle Edge directly — it expects the user to
+ * provide an `Edge` instance via the constructor so the dependency
+ * stays optional.
+ */
+import type { ViewAdapter, ViewContext, ViewOptions } from "./types.js";
+export interface EdgeLike {
+    renderRaw?: (template: string, data: Record<string, any>) => Promise<string>;
+    renderString?: (template: string, data: Record<string, any>) => Promise<string>;
+}
+export declare class EdgeAdapter implements ViewAdapter {
+    private edge?;
+    readonly name = "edge";
+    constructor(edge?: EdgeLike);
+    render(template: string, data: Record<string, any>, context?: ViewContext, options?: ViewOptions): Promise<string>;
+}

package/dist/eta.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Eta template engine adapter.
+ *
+ * Eta is a lightweight, high-performance templating engine with
+ * EJS-like syntax (`<%= expr %>`, `<% code %>`). It works on every
+ * runtime (Bun, Node, Deno, Cloudflare Workers) because templates
+ * are compiled to JavaScript render functions — no eval, no
+ * filesystem access at render time.
+ *
+ * Install (optional peer dep): `bun add eta`
+ *
+ *   import { EtaAdapter } from "nexusjs/view";
+ *   const eta = new EtaAdapter();
+ *   const html = await eta.render("<h1><%= it.title %></h1>", { title: "Hi" });
+ *
+ * Or just use a file with a `.eta` extension — `renderView` picks
+ * the Eta adapter automatically:
+ *
+ *   setViewPaths("views");
+ *   return { view: "about.eta", data: { title: "Hi" } };
+ */
+import type { ViewAdapter, ViewContext, ViewOptions } from "./types.js";
+export declare class EtaAdapter implements ViewAdapter {
+    readonly name = "eta";
+    private cache;
+    render(template: string, data: Record<string, any>, _context?: ViewContext, _options?: ViewOptions): Promise<string>;
+    compile(template: string, _options?: ViewOptions): (data: Record<string, any>) => Promise<string>;
+    private getCompiled;
+}

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `nexusjs/view` — view engine adapter + file-based view loader.
+ *
+ * Public API:
+ * - `renderView(template, data, context?)` — render a view.
+ *   If `template` ends in a known file extension (`.html`, `.edge`,
+ *   `.rendu`, `.eta`) AND `setViewPaths()` has been called, the
+ *   file is loaded from the first matching directory and used
+ *   as the template source. Otherwise the string is treated as
+ *   inline source.
+ *   The adapter is selected by file extension (or Rendu for
+ *   inline / non-extension values).
+ * - `setViewPaths(path)` — configure the directory searched for
+ *   view files. Pass `""` to disable.
+ * - `getViewPaths()` — return the current path (empty = disabled).
+ * - `loadTemplate(dir, name)` — low-level: load a file from
+ *   the given directory.
+ * - `Application.setViewPaths(path)` — same as the module
+ *   function, but chainable.
+ *
+ * Adapters:
+ * - RenduAdapter  (default for `.html`/`.rendu`/inline)
+ * - EdgeAdapter   (for `.edge`)
+ * - EtaAdapter    (for `.eta`)
+ *
+ * Override with `app.setViewAdapter(new MyAdapter())` to install
+ * a different engine globally.
+ */
+export type { ViewAdapter, ViewContext, ViewOptions, } from "./types.js";
+export { RenduAdapter } from "./rendu.js";
+export { EdgeAdapter } from "./edge.js";
+export { EtaAdapter } from "./eta.js";
+export { Inertia } from "./inertia/inertia-adapter.js";
+export { defer, always, optional, merge, deepMerge, once, } from "./inertia/helpers.js";
+export { InertiaFormBuilder } from "./inertia/form-helper.js";
+export { inertiaFormMiddleware } from "./inertia/form-middleware.js";
+export { renderDefaultRoot } from "./inertia/default-ssr.js";
+export type { SsrAdapter, SsrRenderResult, InertiaConfig, InertiaPage, InertiaSharedProps, } from "./inertia/types.js";
+export { createReactAdapter } from "./inertia/ssr/react-adapter.js";
+export { createVueAdapter } from "./inertia/ssr/vue-adapter.js";
+export { ComponentRegistry, createRegistry, asRegistry, } from "./inertia/ssr/registry.js";
+export type { ReactSsrOptions } from "./inertia/ssr/react-adapter.js";
+export type { VueSsrOptions } from "./inertia/ssr/vue-adapter.js";
+export { renderView, loadTemplate, setViewPaths, getViewPaths, } from "./view-engine.js";