irgen 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to the `irgen` project will be documented in this file.
 
+## [0.2.1] - 2026-01-11
+
+### GitHub Pages (SSG/Hybrid)
+- Generate and build SSG/hybrid output for `examples/irgen-web.dsl.ts` in CI.
+- Fix basePath handling so nav/docs links keep `/irgen` prefix after hydration.
+- Add favicon/apple-touch-icon links in SSG output.
+- Fix PWA manifest icon path and service worker cache paths under basePath.
+- Set `SITE_URL` in Pages workflow for correct sitemap/robots URLs.
+
+### Packaging
+- Remove TypeScript sourcemaps and declaration maps from build output.
+- Align README outputs with generated examples and keep example script in sync.
+
 ## [0.2.0] - 2026-01-11
 
 ### General Purpose Frontend & Headless Runtime (Phase 3)

package/dist/cli.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -309,4 +309,3 @@ main().catch((err) => {
     console.error(err);
     process.exit(1);
 });
-//# sourceMappingURL=cli.js.map

package/dist/dsl/aggregator.d.ts

@@ -5,4 +5,3 @@ import { DeclBundle } from "../ir/decl/index.js";
 export declare function aggregateDecls(entries: string[], opts?: {
     prefer?: "frontend" | "backend";
 }): Promise<DeclBundle>;
-//# sourceMappingURL=aggregator.d.ts.map

package/dist/dsl/aggregator.js

@@ -61,4 +61,3 @@ function mergeMeta(metas) {
     }
     return Object.keys(finalMeta).length ? finalMeta : undefined;
 }
-//# sourceMappingURL=aggregator.js.map

package/dist/dsl/frontend-runtime.d.ts

@@ -483,4 +483,3 @@ export declare function frontend(name: string, optsOrFn: FrontendOptions | ((a:
 };
 export declare function loadFrontendDsl(entry: string): Promise<DeclFrontendApp>;
 export {};
-//# sourceMappingURL=frontend-runtime.d.ts.map

package/dist/dsl/frontend-runtime.js

@@ -1,17 +1,19 @@
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { DeclFrontendAppSchema } from "../ir/decl/frontend.raw.schema.js";
-let CURRENT_FRONTEND = null;
+// Use globalThis to share state across multiple module instances (e.g., src vs dist)
+const _global = globalThis;
+_global.__IR_CURRENT_FRONTEND = _global.__IR_CURRENT_FRONTEND || null;
 function assert(cond, msg) {
     if (!cond)
         throw new Error(msg);
 }
 function mergePolicy(target, value) {
-    if (!CURRENT_FRONTEND)
+    if (!_global.__IR_CURRENT_FRONTEND)
         return;
-    CURRENT_FRONTEND.meta = CURRENT_FRONTEND.meta ?? {};
-    const existing = (CURRENT_FRONTEND.meta.policies ?? {});
-    CURRENT_FRONTEND.meta.policies = { ...existing, [target]: { ...(existing[target] ?? {}), ...value } };
+    _global.__IR_CURRENT_FRONTEND.meta = _global.__IR_CURRENT_FRONTEND.meta ?? {};
+    const existing = (_global.__IR_CURRENT_FRONTEND.meta.policies ?? {});
+    _global.__IR_CURRENT_FRONTEND.meta.policies = { ...existing, [target]: { ...(existing[target] ?? {}), ...value } };
 }
 const RUNTIME_HELPERS = [
     "field",
@@ -38,28 +40,28 @@ function stripRuntimeHelpers(comp) {
     }
 }
 export function datasource(id, config) {
-    assert(CURRENT_FRONTEND, "datasource() harus di dalam frontend()");
-    CURRENT_FRONTEND.datasources.push({ id, ...config });
+    assert(_global.__IR_CURRENT_FRONTEND, "datasource() harus di dalam frontend()");
+    _global.__IR_CURRENT_FRONTEND.datasources.push({ id, ...config });
 }
 export function operation(id, config) {
-    assert(CURRENT_FRONTEND, "operation() harus di dalam frontend()");
-    CURRENT_FRONTEND.operations.push({ id, ...config });
+    assert(_global.__IR_CURRENT_FRONTEND, "operation() harus di dalam frontend()");
+    _global.__IR_CURRENT_FRONTEND.operations.push({ id, ...config });
 }
 export function resource(id, config) {
-    assert(CURRENT_FRONTEND, "resource() harus di dalam frontend()");
-    CURRENT_FRONTEND.resources.push({ id, ...config });
+    assert(_global.__IR_CURRENT_FRONTEND, "resource() harus di dalam frontend()");
+    _global.__IR_CURRENT_FRONTEND.resources.push({ id, ...config });
 }
 export function meta(key, value) {
-    assert(CURRENT_FRONTEND, "meta() harus di dalam frontend()");
-    CURRENT_FRONTEND.meta = CURRENT_FRONTEND.meta ?? {};
-    CURRENT_FRONTEND.meta[key] = value;
+    assert(_global.__IR_CURRENT_FRONTEND, "meta() harus di dalam frontend()");
+    _global.__IR_CURRENT_FRONTEND.meta = _global.__IR_CURRENT_FRONTEND.meta ?? {};
+    _global.__IR_CURRENT_FRONTEND.meta[key] = value;
 }
 export function policy(target, value) {
-    assert(CURRENT_FRONTEND, "policy() harus di dalam frontend()");
+    assert(_global.__IR_CURRENT_FRONTEND, "policy() harus di dalam frontend()");
     mergePolicy(target, value);
 }
 export function page(pName, opts, cb) {
-    assert(CURRENT_FRONTEND, "page() harus di dalam frontend()");
+    assert(_global.__IR_CURRENT_FRONTEND, "page() harus di dalam frontend()");
     const page = {
         type: "page",
         name: pName,
@@ -110,16 +112,16 @@ export function page(pName, opts, cb) {
                 }
                 const finalized = comp;
                 page.components.push(finalized);
-                if (CURRENT_FRONTEND)
-                    CURRENT_FRONTEND.components.push(finalized);
+                if (_global.__IR_CURRENT_FRONTEND)
+                    _global.__IR_CURRENT_FRONTEND.components.push(finalized);
             }
         });
     }
-    if (CURRENT_FRONTEND)
-        CURRENT_FRONTEND.pages.push(page);
+    if (_global.__IR_CURRENT_FRONTEND)
+        _global.__IR_CURRENT_FRONTEND.pages.push(page);
 }
 export function component(name, cb) {
-    assert(CURRENT_FRONTEND, "component() harus di dalam frontend()");
+    assert(_global.__IR_CURRENT_FRONTEND, "component() harus di dalam frontend()");
     const comp = { type: "component", name: name, props: {}, form: { fields: [] } };
     // add convenience methods to the comp object for DSL users: field() and prop()
     comp.field = function (fieldName, type, label, validators, config) {
@@ -155,8 +157,8 @@ export function component(name, cb) {
     if (comp.html) {
         throw new Error(`component.html is not allowed (component: ${comp.name}). Use component.content with Markdown instead.`);
     }
-    if (CURRENT_FRONTEND)
-        CURRENT_FRONTEND.components.push(comp);
+    if (_global.__IR_CURRENT_FRONTEND)
+        _global.__IR_CURRENT_FRONTEND.components.push(comp);
 }
 export function frontend(name, optsOrFn, maybeFn) {
     assert(typeof name === "string" && name.length > 0, "frontend(name) harus string");
@@ -164,7 +166,7 @@ export function frontend(name, optsOrFn, maybeFn) {
     const fn = (typeof optsOrFn === "function" ? optsOrFn : maybeFn);
     assert(typeof fn === "function", "frontend(..., fn) fn harus function");
     const baseMeta = opts?.meta ?? {};
-    CURRENT_FRONTEND = {
+    _global.__IR_CURRENT_FRONTEND = {
         type: "frontend",
         name,
         basePath: opts?.basePath ?? "/",
@@ -190,15 +192,15 @@ export function frontend(name, optsOrFn, maybeFn) {
         meta,
         policy,
     });
-    const parsed = DeclFrontendAppSchema.parse(CURRENT_FRONTEND);
-    CURRENT_FRONTEND = parsed;
+    const parsed = DeclFrontendAppSchema.parse(_global.__IR_CURRENT_FRONTEND);
+    _global.__IR_CURRENT_FRONTEND = parsed;
     return parsed;
 }
 export async function loadFrontendDsl(entry) {
     const abs = path.resolve(process.cwd(), entry);
     const url = pathToFileURL(abs).href;
     // reset
-    CURRENT_FRONTEND = null;
+    _global.__IR_CURRENT_FRONTEND = null;
     try {
         await import(url);
     }
@@ -224,9 +226,8 @@ export async function loadFrontendDsl(entry) {
             throw new Error(`Failed to load frontend DSL (${entry}): ${err2?.message ?? err2}`);
         }
     }
-    if (!CURRENT_FRONTEND)
+    if (!_global.__IR_CURRENT_FRONTEND)
         throw new Error(`Frontend DSL did not call frontend(...)`);
-    const parsed = DeclFrontendAppSchema.parse(CURRENT_FRONTEND);
+    const parsed = DeclFrontendAppSchema.parse(_global.__IR_CURRENT_FRONTEND);
     return parsed;
 }
-//# sourceMappingURL=frontend-runtime.js.map

package/dist/dsl/runtime.d.ts

@@ -30,4 +30,3 @@ export declare function app(name: string, opts: AppOptions, fn: (a: AppBuilder)
  */
 export declare function loadDsl(entry: string): Promise<DeclApp>;
 export {};
-//# sourceMappingURL=runtime.d.ts.map

package/dist/dsl/runtime.js

@@ -1,7 +1,9 @@
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { DeclAppSchema } from "../ir/decl/backend.raw.schema.js";
-let CURRENT = null;
+// Use globalThis to share state across multiple module instances (e.g., src vs dist)
+const _global = globalThis;
+_global.__IR_CURRENT_BACKEND = _global.__IR_CURRENT_BACKEND || null;
 function assert(cond, msg) {
     if (!cond)
         throw new Error(msg);
@@ -11,18 +13,18 @@ function defaultEntityId(name) {
     return `${kebab(name)}`;
 }
 function mergePolicy(target, value) {
-    if (!CURRENT)
+    if (!_global.__IR_CURRENT_BACKEND)
         return;
-    CURRENT.meta = CURRENT.meta ?? {};
-    const existing = (CURRENT.meta.policies ?? {});
-    CURRENT.meta.policies = { ...existing, [target]: { ...(existing[target] ?? {}), ...value } };
+    _global.__IR_CURRENT_BACKEND.meta = _global.__IR_CURRENT_BACKEND.meta ?? {};
+    const existing = (_global.__IR_CURRENT_BACKEND.meta.policies ?? {});
+    _global.__IR_CURRENT_BACKEND.meta.policies = { ...existing, [target]: { ...(existing[target] ?? {}), ...value } };
 }
 export function app(name, optsOrFn, maybeFn) {
     assert(typeof name === "string" && name.length > 0, "app(name) harus string");
     const opts = (typeof optsOrFn === "function" ? {} : optsOrFn) ?? {};
     const fn = (typeof optsOrFn === "function" ? optsOrFn : maybeFn);
     assert(typeof fn === "function", "app(..., fn) fn harus function");
-    CURRENT = { type: "app", name, entities: [], meta: { ...(opts.meta ?? {}) } };
+    _global.__IR_CURRENT_BACKEND = { type: "app", name, entities: [], meta: { ...(opts.meta ?? {}) } };
     if (opts.policies) {
         for (const [target, value] of Object.entries(opts.policies)) {
             mergePolicy(target, value);
@@ -30,7 +32,7 @@ export function app(name, optsOrFn, maybeFn) {
     }
     fn({
         entity(entityName, entityFn) {
-            assert(CURRENT, "entity() harus di dalam app()");
+            assert(_global.__IR_CURRENT_BACKEND, "entity() harus di dalam app()");
             const entity = {
                 type: "entity",
                 name: entityName,
@@ -67,14 +69,14 @@ export function app(name, optsOrFn, maybeFn) {
                 },
             };
             entityFn(eb);
-            CURRENT.entities.push(entity);
+            _global.__IR_CURRENT_BACKEND.entities.push(entity);
         },
         meta(key, value) {
-            assert(CURRENT, "meta() harus di dalam app()");
-            CURRENT.meta[key] = value;
+            assert(_global.__IR_CURRENT_BACKEND, "meta() harus di dalam app()");
+            _global.__IR_CURRENT_BACKEND.meta[key] = value;
         },
         policy(target, value) {
-            assert(CURRENT, "policy() harus di dalam app()");
+            assert(_global.__IR_CURRENT_BACKEND, "policy() harus di dalam app()");
             mergePolicy(target, value);
         },
     });
@@ -88,7 +90,7 @@ export async function loadDsl(entry) {
     const abs = path.resolve(process.cwd(), entry);
     const url = pathToFileURL(abs).href;
     // reset
-    CURRENT = null;
+    _global.__IR_CURRENT_BACKEND = null;
     try {
         await import(url);
     }
@@ -112,9 +114,8 @@ export async function loadDsl(entry) {
             throw new Error(`Failed to load DSL (${entry}): ${errMessage2}`);
         }
     }
-    assert(CURRENT, `DSL tidak memanggil app(...) — file: ${entry}`);
+    assert(_global.__IR_CURRENT_BACKEND, `DSL tidak memanggil app(...) — file: ${entry}`);
     // validate + normalize
-    const parsed = DeclAppSchema.parse(CURRENT);
+    const parsed = DeclAppSchema.parse(_global.__IR_CURRENT_BACKEND);
     return parsed;
 }
-//# sourceMappingURL=runtime.js.map

package/dist/emit/backend/adapters.d.ts

@@ -8,4 +8,3 @@ export declare function emitPaginationAdapter(project: Project, outDir: string,
 export declare function emitValidationAdapter(project: Project, outDir: string, policies?: any): void;
 export declare function emitResponseAdapter(project: Project, outDir: string, policies?: any): void;
 export declare function emitAuthAdapter(project: Project, outDir: string, policies?: any): void;
-//# sourceMappingURL=adapters.d.ts.map

package/dist/emit/backend/adapters.js

@@ -371,4 +371,3 @@ export function emitAuthAdapter(project, outDir, policies) {
         `export function isAuthEnabled() { return JWT_ENABLED; }`,
     ]);
 }
-//# sourceMappingURL=adapters.js.map

package/dist/emit/backend/backend-tsmorph.d.ts

@@ -2,4 +2,3 @@ import { Project } from "ts-morph";
 import type { BackendTargetIR } from "../../ir/target/backend.js";
 export declare function emitBackendToProject(project: Project, outDir: string, ir: BackendTargetIR): void;
 export declare function emitBackend(ir: BackendTargetIR, outDir: string): void;
-//# sourceMappingURL=backend-tsmorph.d.ts.map

package/dist/emit/backend/backend-tsmorph.js

@@ -855,4 +855,3 @@ function emitServiceTest(project, outDir, entity) {
         `});`
     ]);
 }
-//# sourceMappingURL=backend-tsmorph.js.map

package/dist/emit/backend/fake-backend.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=fake-backend.d.ts.map

package/dist/emit/backend/fake-backend.js

@@ -16,4 +16,3 @@ try {
 catch (e) {
     // ignore double registration in test loops
 }
-//# sourceMappingURL=fake-backend.js.map

package/dist/emit/backend/packaging.d.ts

@@ -1,3 +1,2 @@
 export declare function emitPackageJson(outDir: string, appName: string, policies?: any): void;
 export declare function emitTsConfig(outDir: string): void;
-//# sourceMappingURL=packaging.d.ts.map

package/dist/emit/backend/packaging.js

@@ -68,4 +68,3 @@ export function emitTsConfig(outDir) {
     fs.mkdirSync(outDir, { recursive: true });
     fs.writeFileSync(path.join(outDir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2), "utf-8");
 }
-//# sourceMappingURL=packaging.js.map

package/dist/emit/backend/server.d.ts

@@ -1,4 +1,3 @@
 import { Project } from "ts-morph";
 import type { BackendTargetIR } from "../../ir/target/backend.js";
 export declare function emitHttpServer(project: Project, outDir: string, ir: BackendTargetIR, policies?: any): void;
-//# sourceMappingURL=server.d.ts.map

package/dist/emit/backend/server.js

@@ -166,4 +166,3 @@ export function emitHttpServer(project, outDir, ir, policies) {
         `app.listen(PORT, () => { console.log("Backend server listening on port", PORT); });`,
     ]);
 }
-//# sourceMappingURL=server.js.map

package/dist/emit/cli/cli-fake.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=cli-fake.d.ts.map

package/dist/emit/cli/cli-fake.js

@@ -30,4 +30,3 @@ try {
 catch (e) {
     // ignore
 }
-//# sourceMappingURL=cli-fake.js.map

package/dist/emit/electron/electron-shell.d.ts

@@ -1,3 +1,2 @@
 import type { ElectronTargetIR } from "../../ir/target/electron.js";
 export declare function emitElectronShell(ir: ElectronTargetIR, outDir: string): void;
-//# sourceMappingURL=electron-shell.d.ts.map

package/dist/emit/electron/electron-shell.js

@@ -451,4 +451,3 @@ export function registerCustomHandlers(ipcMain: IpcMain) {${body}
 `.trim();
     fs.writeFileSync(path.join(outDir, "ipc-handlers.ts"), content, "utf-8");
 }
-//# sourceMappingURL=electron-shell.js.map

package/dist/emit/engine.d.ts

@@ -11,4 +11,3 @@ declare class EmitterEngine {
 }
 export declare const emitterEngine: EmitterEngine;
 export {};
-//# sourceMappingURL=engine.d.ts.map

package/dist/emit/engine.js

@@ -22,4 +22,3 @@ class EmitterEngine {
     }
 }
 export const emitterEngine = new EmitterEngine();
-//# sourceMappingURL=engine.js.map

package/dist/emit/format.d.ts

@@ -1,2 +1 @@
 export declare function formatDirectory(outDir: string, formatter: string | undefined): void;
-//# sourceMappingURL=format.d.ts.map

package/dist/emit/format.js

@@ -20,4 +20,3 @@ export function formatDirectory(outDir, formatter) {
         console.warn(`Unknown formatter '${fmt}', skipping formatting.`);
     }
 }
-//# sourceMappingURL=format.js.map

package/dist/emit/frontend/frontend-react.d.ts

@@ -1,4 +1,3 @@
 import { Project } from "ts-morph";
 import type { FrontendTargetIR } from "../../ir/target/frontend.js";
 export declare function emitFrontend(project: Project, outDir: string, ir: FrontendTargetIR): void;
-//# sourceMappingURL=frontend-react.d.ts.map

package/dist/emit/frontend/frontend-react.js

@@ -281,6 +281,9 @@ function emitPwaAssets(outDir, ir) {
     if (!ir.pwa?.enabled)
         return;
     const pwa = ir.pwa;
+    const basePath = ir.policies.frontend.framework.rendering.basePath || "/";
+    const swBasePath = basePath === "/" ? "" : basePath.replace(/\/$/, "");
+    const manifestIconPath = basePath === "/" ? "/icons/icon.svg" : `${basePath.replace(/\/$/, "")}/icons/icon.svg`;
     const manifest = {
         name: pwa.name,
         short_name: pwa.shortName,
@@ -292,7 +295,7 @@ function emitPwaAssets(outDir, ir) {
         theme_color: pwa.themeColor,
         orientation: pwa.orientation,
         icons: pwa.icons ?? [
-            { src: "/icons/icon.svg", sizes: "any", type: "image/svg+xml" },
+            { src: manifestIconPath, sizes: "any", type: "image/svg+xml" },
         ],
     };
     const publicDir = path.join(outDir, "public");
@@ -314,7 +317,11 @@ function emitPwaAssets(outDir, ir) {
     fs.writeFileSync(path.join(iconsDir, "icon.svg"), svgIcon, "utf-8");
     const sw = `
 const CACHE_NAME = "irgen-pwa-v1";
-const ASSETS = ["/", "/index.html", "/manifest.webmanifest"];
+const ASSETS = [
+  "${swBasePath}/",
+  "${swBasePath}/index.html",
+  "${swBasePath}/manifest.webmanifest"
+];
 
 self.addEventListener("install", (event) => {
   event.waitUntil(
@@ -337,7 +344,7 @@ self.addEventListener("fetch", (event) => {
         const copy = resp.clone();
         caches.open(CACHE_NAME).then((cache) => cache.put(event.request, copy));
         return resp;
-      }).catch(() => caches.match("/index.html"));
+      }).catch(() => caches.match("${swBasePath}/index.html"));
     })
   );
 });
@@ -353,7 +360,7 @@ import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react";
 
 export default defineConfig({
-  base: "/",
+  base: "${policy.framework.rendering.basePath}",
   plugins: [react()],
   resolve: {
     dedupe: ["react", "react-dom", "react-router", "react-router-dom"],
@@ -366,7 +373,7 @@ export default defineConfig({
     manifest: true,
   },
   ssr: {
-    noExternal: ["react", "react-dom", "react-router", "react-router-dom"],
+    noExternal: ["react", "react-dom", "react-router", "react-router-dom", /react-syntax-highlighter/, /lucide-react/, "prismjs"],
   },` : ""}
 });
   `.trim();
@@ -421,7 +428,10 @@ export function emitFrontend(project, outDir, ir) {
         clientEntry.addImportDeclaration({ moduleSpecifier: "prismjs/components/prism-bash" });
         clientEntry.addImportDeclaration({ moduleSpecifier: "prismjs/components/prism-css" });
     }
-    const basePath = ir.basePath || policy.framework.rendering.basePath || "/";
+    const policyBasePath = policy.framework.rendering.basePath || "/";
+    const irBasePath = ir.basePath || "/";
+    const basePathRaw = policyBasePath !== "/" ? policyBasePath : irBasePath;
+    const basePath = basePathRaw.replace(/\/$/, "") || "/";
     const hasBasePath = basePath !== "/";
     if (mode === "hybrid") {
         clientEntry.addStatements(`
@@ -465,10 +475,11 @@ root.render(
     `.trim());
     }
     if (ir.pwa?.enabled) {
+        const swBasePath = basePath !== "/" ? basePath : "";
         clientEntry.addStatements(`
 if ('serviceWorker' in navigator) {
   window.addEventListener('load', () => {
-    navigator.serviceWorker.register('/pwa-sw.js').catch(err => {
+    navigator.serviceWorker.register('${swBasePath}/pwa-sw.js').catch(err => {
       console.error('Service worker registration failed', err);
     });
   });
@@ -511,6 +522,8 @@ if ('serviceWorker' in navigator) {
         writer.writeLine("const [tocItems, setTocItems] = useState([] as Array<{ id: string; text: string; level: number }>);");
         writer.writeLine("const [activeToc, setActiveToc] = useState(\"\" as string);");
         writer.writeLine("const location = useLocation();");
+        writer.writeLine(`const basePath = "${policy.framework.rendering.basePath}".replace(/\\/$/, "") || "/";`);
+        writer.writeLine("const relativePath = location.pathname.startsWith(basePath) ? location.pathname.substring(basePath.length) || '/' : location.pathname;");
         writer.writeLine(`const docsLinks = ${JSON.stringify(docsLinks, null, 2)};`);
         writer.writeLine(`const defaultDocsGroupLabel = ${JSON.stringify(docsGroupLabel)};`);
         writer.writeLine("const docsSidebarGroups = docsLinks.reduce((acc, link) => {");
@@ -521,7 +534,7 @@ if ('serviceWorker' in navigator) {
         writer.writeLine("  return acc;");
         writer.writeLine("}, [] as Array<{ label: string; items: typeof docsLinks }>)");
         writer.writeLine("const docsPaths = docsLinks.map((link) => link.path);");
-        writer.writeLine("const isDocsRoute = docsPaths.includes(location.pathname);");
+        writer.writeLine("const isDocsRoute = docsPaths.includes(relativePath);");
         writer.writeLine("");
         writer.writeLine("useEffect(() => {");
         writer.writeLine("  if (isDark) {");
@@ -727,13 +740,18 @@ if ('serviceWorker' in navigator) {
         writer.writeLine("  );");
     });
     // index.html (SPA fallback / CSR entry)
+    // Note: Vite handles prefixing based on 'base' config during build. 
+    // Scripts in index.html should point to the source path relative to project root.
+    const htmlBasePath = basePath !== "/" ? basePath : "";
     project.createSourceFile(path.join(outDir, "index.html"), `
 <!DOCTYPE html>
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    ${ir.pwa?.enabled ? `<link rel="manifest" href="/manifest.webmanifest" />` : ""}
+    ${ir.pwa?.enabled ? `<link rel="manifest" href="${htmlBasePath}/manifest.webmanifest" />` : ""}
+    ${ir.pwa?.enabled ? `<link rel="icon" href="${htmlBasePath}/icons/icon.svg" />` : ""}
+    ${ir.pwa?.enabled ? `<link rel="apple-touch-icon" href="${htmlBasePath}/icons/icon.svg" />` : ""}
     ${ir.pwa?.enabled ? `<meta name="theme-color" content="${ir.pwa.themeColor}" />` : ""}
     <title>${ir.appName}</title>
   </head>
@@ -2018,4 +2036,3 @@ function emitMarketingComponent(writer, m, policy) {
         writer.writeLine(`    </div>`);
     }
 }
-//# sourceMappingURL=frontend-react.js.map

package/dist/emit/frontend/registry.d.ts

@@ -17,4 +17,3 @@ export declare const envelopeAdapters: Registry<EnvelopeAdapter>;
 export declare const paginationAdapters: Registry<PaginationAdapter>;
 export declare const uiComponents: Registry<any>;
 export {};
-//# sourceMappingURL=registry.d.ts.map

package/dist/emit/frontend/registry.js

@@ -43,4 +43,3 @@ paginationAdapters.register("cursor_root", {
         ? { nextCursor: typeof p.nextCursor === "string" ? p.nextCursor : undefined }
         : {},
 });
-//# sourceMappingURL=registry.js.map

package/dist/emit/frontend/runtime-emitter.d.ts

@@ -1,4 +1,3 @@
 import { Project } from "ts-morph";
 import type { FrontendTargetIR } from "../../ir/target/frontend.js";
 export declare function emitRuntime(project: Project, srcDir: string, ir: FrontendTargetIR): void;
-//# sourceMappingURL=runtime-emitter.d.ts.map

package/dist/emit/frontend/runtime-emitter.js

@@ -432,4 +432,3 @@ export function useResource(resourceId: string) {
 `;
     project.createSourceFile(filePath, content, { overwrite: true });
 }
-//# sourceMappingURL=runtime-emitter.js.map

package/dist/emit/frontend/runtime-template.d.ts

@@ -25,4 +25,3 @@ export declare class BaseRuntime implements Runtime {
     private handleResultSignals;
     invalidate(targets: any): void;
 }
-//# sourceMappingURL=runtime-template.d.ts.map

package/dist/emit/frontend/runtime-template.js

@@ -215,4 +215,3 @@ export class BaseRuntime {
         // Implementation for cache invalidation (e.g. TanStack Query integration)
     }
 }
-//# sourceMappingURL=runtime-template.js.map

package/dist/emit/frontend/ssg.d.ts

@@ -5,4 +5,3 @@ import type { FrontendPolicy } from "../../ir/target/frontend.policy.js";
 export declare function isInteractiveComponent(component: FrontendComponent): boolean;
 export declare function inferInteractiveRoutes(ir: FrontendTargetIR, policy: FrontendPolicy): string[];
 export declare function emitSsgSupport(project: Project, outDir: string, frontendDir: string, ir: FrontendTargetIR): void;
-//# sourceMappingURL=ssg.d.ts.map

package/dist/emit/frontend/ssg.js

@@ -60,10 +60,14 @@ export function emitSsgSupport(project, outDir, frontendDir, ir) {
     serverEntry.addImportDeclaration({ moduleSpecifier: "react-router-dom/server", namedImports: ["StaticRouter"] });
     serverEntry.addImportDeclaration({ moduleSpecifier: "./App", namedImports: ["App"] });
     serverEntry.addStatements(`
+const basePath = "${policy.framework.rendering.basePath}".replace(/\\/$/, "");
+const hasBasePath = basePath && basePath !== "/";
+
 export function render(url: string) {
+  const location = hasBasePath ? \`\${basePath}\${url}\` : url;
   const html = renderToString(
     <React.StrictMode>
-      <StaticRouter location={url}>
+      <StaticRouter location={location} basename={hasBasePath ? basePath : undefined}>
         <App />
       </StaticRouter>
     </React.StrictMode>
@@ -78,7 +82,9 @@ export function render(url: string) {
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    ${ir.pwa?.enabled ? `<link rel="manifest" href="/manifest.webmanifest" />` : ""}
+    ${ir.pwa?.enabled ? `<link rel="manifest" href="${policy.framework.rendering.basePath.replace(/\/$/, "")}/manifest.webmanifest" />` : ""}
+    ${ir.pwa?.enabled ? `<link rel="icon" href="${policy.framework.rendering.basePath.replace(/\/$/, "")}/icons/icon.svg" />` : ""}
+    ${ir.pwa?.enabled ? `<link rel="apple-touch-icon" href="${policy.framework.rendering.basePath.replace(/\/$/, "")}/icons/icon.svg" />` : ""}
     ${ir.pwa?.enabled ? `<meta name="theme-color" content="${ir.pwa.themeColor}" />` : ""}
     <!--app-head-->
     <title>${ir.appName}</title>
@@ -139,19 +145,20 @@ function resolveEntry(manifest) {
 function buildHead(entry, manifest, shouldHydrate) {
   if (!entry) return "";
   const tags = [];
+  const base = "${policy.framework.rendering.basePath}".replace(/\\/$/, "");
   if (entry.css) {
     for (const css of entry.css) {
-      tags.push(\`<link rel="stylesheet" href="/\${css}">\`);
+      tags.push(\`<link rel="stylesheet" href="\${base}/\${css}">\`);
     }
   }
   if (shouldHydrate && entry.imports) {
     for (const imp of entry.imports) {
       const file = manifest?.[imp]?.file ?? null;
-      if (file) tags.push(\`<link rel="modulepreload" href="/\${file}">\`);
+      if (file) tags.push(\`<link rel="modulepreload" href="\${base}/\${file}">\`);
     }
   }
   if (shouldHydrate && entry.file) {
-    tags.push(\`<script type="module" src="/\${entry.file}"></script>\`);
+    tags.push(\`<script type="module" src="\${base}/\${entry.file}"></script>\`);
   }
   return tags.join("\\n    ");
 }
@@ -188,10 +195,14 @@ async function prerender() {
     fs.writeFileSync(outFile, finalHtml, "utf-8");
   }
 
+  const base = "${policy.framework.rendering.basePath}".replace(/\\/$/, "");
   if (emitSitemap) {
     const urls = routes
       .filter((r) => !isDynamicRoute(r))
-      .map((route) => \`  <url><loc>\${new URL(route, siteUrl).href}</loc></url>\`)
+      .map((route) => {
+        const fullPath = (base + route).replace(/\\/\\//g, "/");
+        return \`  <url><loc>\${new URL(fullPath, siteUrl).href}</loc></url>\`;
+      })
       .join("\\n");
     const sitemap = \`<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
@@ -201,9 +212,9 @@ async function prerender() {
   }
 
   if (emitRobotsTxt) {
-    const sitemapUrl = emitSitemap ? new URL("/sitemap.xml", siteUrl).href : null;
+    const sitemapUrl = emitSitemap ? new URL((base + "/sitemap.xml").replace(/\\/\\//g, "/"), siteUrl).href : null;
     const robotsTxt = \`User-agent: *
-Allow: /
+Allow: \${base || "/"}
 \${sitemapUrl ? "\\nSitemap: " + sitemapUrl : ""}\`;
     fs.writeFileSync(path.join(outDir, "robots.txt"), robotsTxt, "utf-8");
   }
@@ -216,4 +227,3 @@ prerender().catch((err) => {
   `.trim();
     fs.writeFileSync(path.join(scriptDir, "prerender.mjs"), prerenderScript, "utf-8");
 }
-//# sourceMappingURL=ssg.js.map