@hozu/bundle 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/bundle
+
+Bundles Hozu widget client modules with esbuild.
+
+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/bundle
+```
+
+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,10 @@
+import { type BuildResult, type Diagnostic } from '@hozu/core/ir';
+export interface WidgetBundle {
+    urls: Record<string, string>;
+    files: Record<string, string>;
+    diagnostics: Diagnostic[];
+}
+export declare function bundleWidgets(project: BuildResult, { minify }?: {
+    minify?: boolean;
+}): Promise<WidgetBundle>;
+//# 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":"AACA,OAAO,EAAE,KAAK,WAAW,EAAS,KAAK,UAAU,EAAQ,MAAM,eAAe,CAAA;AAG9E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAID,wBAAsB,aAAa,CACjC,OAAO,EAAE,WAAW,EACpB,EAAE,MAAa,EAAE,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,OAAO,CAAC,YAAY,CAAC,CA8CvB"}

package/dist/index.js

@@ -0,0 +1,57 @@
+import { relative } from 'node:path';
+import { codes, join } from '@hozu/core/ir';
+import { build } from 'esbuild';
+const base = '/_hozu/w';
+export async function bundleWidgets(project, { minify = true } = {}) {
+    const entries = Object.entries(project.bindings.widgets);
+    const out = { urls: {}, files: {}, diagnostics: [] };
+    if (!entries.length)
+        return out;
+    const result = await build({
+        entryPoints: Object.fromEntries(entries.map(([ref, file]) => [ref.replace('.', '-'), file])),
+        bundle: true,
+        splitting: true,
+        format: 'esm',
+        platform: 'browser',
+        target: 'es2022',
+        minify,
+        outdir: base,
+        entryNames: '[name]-[hash]',
+        chunkNames: 'chunk-[hash]',
+        define: { 'process.env.NODE_ENV': '"production"' },
+        metafile: true,
+        write: false,
+        logLevel: 'silent',
+    });
+    for (const file of result.outputFiles)
+        out.files[file.path.slice(file.path.indexOf(base))] = file.text;
+    for (const [path, meta] of Object.entries(result.metafile.outputs)) {
+        if (!meta.entryPoint)
+            continue;
+        const ref = entries.find(([, file]) => relative(process.cwd(), file) === meta.entryPoint)?.[0];
+        if (!ref)
+            continue;
+        out.urls[ref] = path.slice(path.indexOf(base));
+        if (meta.exports.includes('default'))
+            continue;
+        const [feature, symbol] = ref.split('.');
+        out.diagnostics.push({
+            code: 'HZ029',
+            severity: codes.HZ029.severity,
+            message: `Widget module for ${ref} has no default export`,
+            location: {
+                feature,
+                pointer: join('', 'features', feature, 'widgets', symbol, 'client'),
+                source: null,
+            },
+            cause: 'The runtime mounts the default export of the widget module.',
+            fix: {
+                summary: 'Export the setup function',
+                snippet: `export default implement<typeof ${symbol}>(({ el, props, emit, signal }) => ({ update(next) {}, destroy() {} }))`,
+                patch: null,
+            },
+        });
+    }
+    return out;
+}
+//# 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,46 @@
+{
+  "name": "@hozu/bundle",
+  "version": "0.1.0",
+  "description": "Bundles Hozu widget client modules with esbuild",
+  "keywords": [
+    "hozu",
+    "framework",
+    "ai",
+    "agents",
+    "ssr",
+    "islands",
+    "typescript"
+  ],
+  "homepage": "https://github.com/olevatorr/Hozu/tree/main/packages/bundle#readme",
+  "bugs": {
+    "url": "https://github.com/olevatorr/Hozu/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/olevatorr/Hozu.git",
+    "directory": "packages/bundle"
+  },
+  "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": {
+    "esbuild": "0.28.2",
+    "@hozu/core": "0.1.0"
+  },
+  "sideEffects": false
+}