@hozu/adapter-static 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 olevatorr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @hozu/adapter-static
+
+Export a Hozu app as static files.
+
+Part of [Hozu](https://github.com/olevatorr/Hozu#readme), an AI-first web framework. Most apps start from
+`npm create hozu@latest`, which installs the right packages and sets up Claude Code or `AGENTS.md` agents.
+
+```sh
+npm install @hozu/adapter-static
+```
+
+Requires Node 22.18 or newer. Documentation: the [README](https://github.com/olevatorr/Hozu#readme) and the
+agent skill that `create-hozu` writes into each app.
+
+MIT © olevatorr

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { BuildResult, ImageSet } from '@hozu/core/ir';
+import { type ResolverSet } from '@hozu/data';
+import { type Stylesheet, type WidgetBundle } from '@hozu/runtime-server';
+export interface StaticExportOptions {
+    build: BuildResult;
+    resolvers: ResolverSet;
+    outDir: string;
+    styles?: Stylesheet | null;
+    widgets?: WidgetBundle | null;
+    images?: ImageSet | null;
+}
+export interface StaticExport {
+    written: string[];
+    skipped: {
+        route: string;
+        reason: string;
+    }[];
+}
+export declare function exportStatic({ build, resolvers, outDir, styles, widgets, images, }: StaticExportOptions): Promise<StaticExport>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAKL,KAAK,UAAU,EAGf,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,CAAA;IAClB,SAAS,EAAE,WAAW,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1B,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAC7B,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC7C;AAOD,wBAAsB,YAAY,CAAC,EACjC,KAAK,EACL,SAAS,EACT,MAAM,EACN,MAAa,EACb,OAAc,EACd,MAAa,GACd,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmE7C"}

package/dist/index.js

@@ -0,0 +1,80 @@
+import { copyFile, mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { planRoute } from '@hozu/compiler';
+import { createDataRuntime } from '@hozu/data';
+import { pageEntries, publicAssets, renderToString, robotsTxt, sitemapXml, staticFiles, } from '@hozu/runtime-server';
+const write = async (file, content) => {
+    await mkdir(dirname(file), { recursive: true });
+    await writeFile(file, content);
+};
+export async function exportStatic({ build, resolvers, outDir, styles = null, widgets = null, images = null, }) {
+    const assets = publicAssets(build.ir.http.basePath, styles, widgets?.urls ?? {});
+    const data = createDataRuntime({ build, resolvers });
+    const result = { written: [], skipped: [] };
+    let js = false;
+    const entries = await pageEntries(build, data);
+    for (const [route, page] of Object.entries(build.ir.pages).sort(([a], [b]) => a.localeCompare(b))) {
+        const { plan } = planRoute(build.ir, route);
+        const dynamic = plan.regions.filter((r) => r.mode === 'request');
+        if (dynamic.length) {
+            result.skipped.push({ route, reason: `per-request regions: ${dynamic.map((r) => r.query).join(', ')}` });
+            continue;
+        }
+        const list = entries.filter((e) => e.route === route);
+        if (!list.length && build.ir.routes[route]?.params && !page.entries) {
+            result.skipped.push({ route, reason: 'parameterized route without entries (HZ025)' });
+            continue;
+        }
+        for (const entry of list) {
+            const { html, status } = await renderToString({
+                build,
+                data,
+                route,
+                params: entry.params,
+                assets,
+                locale: entry.locale,
+                images: images?.variants ?? null,
+            });
+            if (status !== 200) {
+                result.skipped.push({ route: entry.path, reason: `status ${status}` });
+                continue;
+            }
+            const file = join(outDir, entry.path.replace(/^\//, ''), 'index.html');
+            await write(file, html);
+            result.written.push(file);
+            js ||= plan.js;
+        }
+    }
+    if (build.ir.notFound) {
+        const { html } = await renderToString({
+            build,
+            data,
+            route: build.ir.notFound,
+            params: null,
+            assets,
+            images: images?.variants ?? null,
+        });
+        await write(join(outDir, '404.html'), html);
+        result.written.push(join(outDir, '404.html'));
+    }
+    await write(join(outDir, 'robots.txt'), robotsTxt(build));
+    await write(join(outDir, 'sitemap.xml'), sitemapXml(build, entries));
+    result.written.push(join(outDir, 'robots.txt'), join(outDir, 'sitemap.xml'));
+    for (const f of staticFiles(build, { styles, widgets, client: js })) {
+        const file = join(outDir, f.path.replace(/^\//, ''));
+        await mkdir(dirname(file), { recursive: true });
+        if (f.file)
+            await copyFile(f.file, file);
+        else
+            await writeFile(file, f.text ?? '');
+        result.written.push(file);
+    }
+    for (const [href, bytes] of Object.entries(images?.files ?? {})) {
+        const file = join(outDir, href.replace(/^\//, ''));
+        await mkdir(dirname(file), { recursive: true });
+        await writeFile(file, bytes);
+        result.written.push(file);
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@hozu/adapter-static",
+  "version": "0.1.0",
+  "description": "Export a Hozu app as static files",
+  "keywords": [
+    "hozu",
+    "framework",
+    "ai",
+    "agents",
+    "ssr",
+    "islands",
+    "typescript"
+  ],
+  "homepage": "https://github.com/olevatorr/Hozu/tree/main/packages/adapter-static#readme",
+  "bugs": {
+    "url": "https://github.com/olevatorr/Hozu/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/olevatorr/Hozu.git",
+    "directory": "packages/adapter-static"
+  },
+  "license": "MIT",
+  "author": "olevatorr",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@hozu/core": "0.1.0",
+    "@hozu/compiler": "0.1.0",
+    "@hozu/data": "0.1.0",
+    "@hozu/runtime-client": "0.1.0",
+    "@hozu/runtime-server": "0.1.0"
+  }
+}