@moku-labs/web 0.3.1 → 0.4.0

package/dist/render-BL9Fv6G6.mjs

@@ -0,0 +1,20 @@
+import { render } from "preact";
+//#region src/plugins/spa/render.ts
+/**
+* Render a route's `VNode` into the live swap region, replacing its contents.
+* Reuses the build's component output verbatim (same `route.render`), so the
+* client paint matches the SSG paint.
+*
+* @param vnode - The VNode produced by the matched route's `.render(ctx)`.
+* @param region - The swap-region element to render into.
+* @example
+* ```ts
+* const { renderVNode } = await import("./render");
+* renderVNode(route._handlers.render(ctx), document.querySelector("main > section"));
+* ```
+*/
+function renderVNode(vnode, region) {
+	render(vnode, region);
+}
+//#endregion
+export { renderVNode };

package/dist/render-BSTM0Akv.cjs

@@ -0,0 +1,20 @@
+let preact = require("preact");
+//#region src/plugins/spa/render.ts
+/**
+* Render a route's `VNode` into the live swap region, replacing its contents.
+* Reuses the build's component output verbatim (same `route.render`), so the
+* client paint matches the SSG paint.
+*
+* @param vnode - The VNode produced by the matched route's `.render(ctx)`.
+* @param region - The swap-region element to render into.
+* @example
+* ```ts
+* const { renderVNode } = await import("./render");
+* renderVNode(route._handlers.render(ctx), document.querySelector("main > section"));
+* ```
+*/
+function renderVNode(vnode, region) {
+	(0, preact.render)(vnode, region);
+}
+//#endregion
+exports.renderVNode = renderVNode;

package/dist/writer-BcWqa_7I.mjs

@@ -0,0 +1,90 @@
+import { t as dataSuffix } from "./convention-X3zLTlJ8.mjs";
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import pLimit from "p-limit";
+//#region src/plugins/data/writer.ts
+/**
+* @file data plugin — Node write side of the agnostic provider (`write()`).
+*
+* This is the ONLY module in the `data` plugin that touches `node:*`. It is
+* reached exclusively through a lazy `await import("./writer")` inside `api.ts`'s
+* `write()`, so a browser bundle that composes `data` for the read side never
+* statically pulls `node:fs` (see `__tests__/unit/isolation.test.ts`).
+*
+* It is domain-agnostic: it persists whatever `data` each {@link DataEntry} carries
+* (the route's own `load`/projection output — `build` produced these), one JSON
+* file per page, at the path {@link dataSuffix} mirrors from the page URL. No
+* content/article knowledge, no expansion (build already expanded the routes).
+*/
+/** Default build output root, matching `build`'s `defaultBuildConfig.outDir`. */
+const DEFAULT_OUT_DIR = "./dist";
+/** Concurrency bound for per-page writes (matches the OG-image phase's pool). */
+const WRITE_CONCURRENCY = 8;
+/**
+* Resolve the `outDir`-relative file for a page path using the shared convention,
+* trimming a trailing slash from the config dir so the join stays clean.
+*
+* @param outputDir - The configured data output subdir (e.g. `"_data"`).
+* @param pagePath - The page URL path (e.g. `/en/hello/`).
+* @returns The `outDir`-relative file path (e.g. `_data/en/hello/index.json`).
+* @example
+* ```ts
+* relativeFile("_data", "/en/hello/"); // "_data/en/hello/index.json"
+* ```
+*/
+function relativeFile(outputDir, pagePath) {
+	return `${outputDir.endsWith("/") ? outputDir.slice(0, -1) : outputDir}/${dataSuffix(pagePath)}`;
+}
+/**
+* Persist one entry's data as JSON under `<outDir>/<relativeFile>` and return the
+* written `{ relative, bytes }`.
+*
+* @param entry - The page entry to persist.
+* @param outDir - The build output root.
+* @param outputDir - The configured data output subdir.
+* @returns The written file's `outDir`-relative path and byte length.
+* @example
+* ```ts
+* await writeEntry({ path: "/en/hello/", data }, "./dist", "_data");
+* ```
+*/
+async function writeEntry(entry, outDir, outputDir) {
+	const relative = relativeFile(outputDir, entry.path);
+	const filePath = path.join(outDir, relative);
+	await mkdir(path.dirname(filePath), { recursive: true });
+	const body = JSON.stringify(entry.data);
+	await writeFile(filePath, body, "utf8");
+	return {
+		relative,
+		bytes: Buffer.byteLength(body, "utf8")
+	};
+}
+/**
+* The Node write side of the provider. Persists one JSON file per entry (bounded
+* by `p-limit`) — domain-agnostic, no route expansion (`build` already did that).
+* Records the summary in `ctx.state.lastWrite`.
+*
+* @param ctx - The data plugin context (state, config).
+* @param entries - The per-page data to persist.
+* @param options - Optional overrides.
+* @param options.outDir - Build output directory to write under (default `./dist`).
+* @returns A summary of the written files.
+* @example
+* ```ts
+* const summary = await writeData(ctx, [{ path: "/en/hello/", data }], { outDir: "./dist" });
+* ```
+*/
+async function writeData(ctx, entries, options) {
+	const outDir = options?.outDir ?? DEFAULT_OUT_DIR;
+	const limit = pLimit(WRITE_CONCURRENCY);
+	const written = await Promise.all(entries.map((entry) => limit(() => writeEntry(entry, outDir, ctx.config.outputDir))));
+	const summary = {
+		fileCount: written.length,
+		bytes: written.reduce((total, file) => total + file.bytes, 0),
+		files: written.map((file) => file.relative)
+	};
+	ctx.state.lastWrite = summary;
+	return summary;
+}
+//#endregion
+export { writeData };

package/dist/writer-DAF0pM25.cjs

@@ -0,0 +1,92 @@
+const require_convention = require("./convention-Dr8jxG70.cjs");
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+node_path = require_convention.__toESM(node_path, 1);
+let p_limit = require("p-limit");
+p_limit = require_convention.__toESM(p_limit, 1);
+//#region src/plugins/data/writer.ts
+/**
+* @file data plugin — Node write side of the agnostic provider (`write()`).
+*
+* This is the ONLY module in the `data` plugin that touches `node:*`. It is
+* reached exclusively through a lazy `await import("./writer")` inside `api.ts`'s
+* `write()`, so a browser bundle that composes `data` for the read side never
+* statically pulls `node:fs` (see `__tests__/unit/isolation.test.ts`).
+*
+* It is domain-agnostic: it persists whatever `data` each {@link DataEntry} carries
+* (the route's own `load`/projection output — `build` produced these), one JSON
+* file per page, at the path {@link dataSuffix} mirrors from the page URL. No
+* content/article knowledge, no expansion (build already expanded the routes).
+*/
+/** Default build output root, matching `build`'s `defaultBuildConfig.outDir`. */
+const DEFAULT_OUT_DIR = "./dist";
+/** Concurrency bound for per-page writes (matches the OG-image phase's pool). */
+const WRITE_CONCURRENCY = 8;
+/**
+* Resolve the `outDir`-relative file for a page path using the shared convention,
+* trimming a trailing slash from the config dir so the join stays clean.
+*
+* @param outputDir - The configured data output subdir (e.g. `"_data"`).
+* @param pagePath - The page URL path (e.g. `/en/hello/`).
+* @returns The `outDir`-relative file path (e.g. `_data/en/hello/index.json`).
+* @example
+* ```ts
+* relativeFile("_data", "/en/hello/"); // "_data/en/hello/index.json"
+* ```
+*/
+function relativeFile(outputDir, pagePath) {
+	return `${outputDir.endsWith("/") ? outputDir.slice(0, -1) : outputDir}/${require_convention.dataSuffix(pagePath)}`;
+}
+/**
+* Persist one entry's data as JSON under `<outDir>/<relativeFile>` and return the
+* written `{ relative, bytes }`.
+*
+* @param entry - The page entry to persist.
+* @param outDir - The build output root.
+* @param outputDir - The configured data output subdir.
+* @returns The written file's `outDir`-relative path and byte length.
+* @example
+* ```ts
+* await writeEntry({ path: "/en/hello/", data }, "./dist", "_data");
+* ```
+*/
+async function writeEntry(entry, outDir, outputDir) {
+	const relative = relativeFile(outputDir, entry.path);
+	const filePath = node_path.default.join(outDir, relative);
+	await (0, node_fs_promises.mkdir)(node_path.default.dirname(filePath), { recursive: true });
+	const body = JSON.stringify(entry.data);
+	await (0, node_fs_promises.writeFile)(filePath, body, "utf8");
+	return {
+		relative,
+		bytes: Buffer.byteLength(body, "utf8")
+	};
+}
+/**
+* The Node write side of the provider. Persists one JSON file per entry (bounded
+* by `p-limit`) — domain-agnostic, no route expansion (`build` already did that).
+* Records the summary in `ctx.state.lastWrite`.
+*
+* @param ctx - The data plugin context (state, config).
+* @param entries - The per-page data to persist.
+* @param options - Optional overrides.
+* @param options.outDir - Build output directory to write under (default `./dist`).
+* @returns A summary of the written files.
+* @example
+* ```ts
+* const summary = await writeData(ctx, [{ path: "/en/hello/", data }], { outDir: "./dist" });
+* ```
+*/
+async function writeData(ctx, entries, options) {
+	const outDir = options?.outDir ?? DEFAULT_OUT_DIR;
+	const limit = (0, p_limit.default)(WRITE_CONCURRENCY);
+	const written = await Promise.all(entries.map((entry) => limit(() => writeEntry(entry, outDir, ctx.config.outputDir))));
+	const summary = {
+		fileCount: written.length,
+		bytes: written.reduce((total, file) => total + file.bytes, 0),
+		files: written.map((file) => file.relative)
+	};
+	ctx.state.lastWrite = summary;
+	return summary;
+}
+//#endregion
+exports.writeData = writeData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/web",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Content static-site generator + SPA web framework for TypeScript, built on @moku-labs/core.",
   "author": "Oleksandr Kucherenko",
   "license": "MIT",
@@ -42,13 +42,14 @@
       }
     }
   },
+  "sideEffects": false,
   "files": [
     "dist",
     "LICENSE",
     "README.md"
   ],
   "engines": {
-    "node": ">=22.0.0",
+    "node": ">=24.0.0",
     "bun": ">=1.3.14"
   },
   "dependencies": {