irgen 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to the `irgen` project will be documented in this file.
 
+## [0.2.3] - 2026-01-21
+
+### Bug Fixes
+- **Frontend Emitter**: Fixed `ReferenceError: rowActionIcons is not defined` in `frontend-react.ts` when rendering table row actions.
+- **Frontend Components**: Resolved `[object Object]` AST leak in code blocks by ensuring `React` is correctly imported and utilized for runtime element creation.
+
+### Documentation & Verification
+- **Test Suite**: Verified all core golden tests (Backend, Electron, Static Site) pass with the latest fixes.
+- **Cleanup**: Improved documentation quality and consistency in core emitters.
+
 ## [0.2.2] - 2026-01-18
 
 ### Core Extensions & Architecture (Phase 10)

package/README.md

@@ -160,3 +160,5 @@ See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for details on:
 - [x] Automated Testing
 - [x] Rich Frontend Components & Routing
 - [x] Frontend SSG/Hybrid (Vite prerender)
+
+See [docs/ROADMAP-FUTURE.md](docs/ROADMAP-FUTURE.md) for the upcoming **v0.3.0 (Enterprise & Ecosystem)** plan.

package/dist/dsl/frontend-runtime.js

@@ -220,7 +220,9 @@ export async function loadFrontendDsl(entry) {
     // reset
     _global.__IR_CURRENT_FRONTEND = null;
     try {
-        await import(url);
+        // Add cache buster to force re-execution if file is already in module cache
+        const cacheBuster = `?cb=${Date.now()}`;
+        await import(url + cacheBuster);
     }
     catch (err) {
         // Some environments (tsx ESM loader) may fail resolving .ts imports via file URL.

package/dist/dsl/runtime.js

@@ -92,7 +92,9 @@ export async function loadDsl(entry) {
     // reset
     _global.__IR_CURRENT_BACKEND = null;
     try {
-        await import(url);
+        // Add cache buster to force re-execution if file is already in module cache
+        const cacheBuster = `?cb=${Date.now()}`;
+        await import(url + cacheBuster);
     }
     catch (err) {
         const errMessage = err instanceof Error ? err.message : String(err);

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

@@ -41,8 +41,8 @@ export function emitComponent(project, frontendDir, component, ir) {
             namedImports: ["Prism as SyntaxHighlighter"],
         });
         sf.addImportDeclaration({
-            moduleSpecifier: "react-syntax-highlighter/dist/esm/styles/prism",
-            namedImports: ["oneDark"],
+            moduleSpecifier: "react-syntax-highlighter/dist/esm/styles/prism/one-dark",
+            defaultImport: "oneDark",
         });
     }
     // Import layout child components if any
@@ -1162,8 +1162,10 @@ export function emitComponent(project, frontendDir, component, ir) {
                             const toExpr = actionExpr(action.onClick.to);
                             const confirmMsg = action.onClick.confirmMessage;
                             const confirmSnippet = confirmMsg ? `if (!window.confirm(${JSON.stringify(confirmMsg)})) return; ` : "";
+                            const iconName = rowActionIcons[label];
+                            const iconSnippet = iconName ? `React.createElement((Icons as any)["${iconName}"] || Icons.Square, { size: 14, className: "mr-1.5" })` : "null";
                             writer.writeLine(`                  <button type="button" className="${tableActionButtonClass}" onClick={(e) => { e.stopPropagation(); ${confirmSnippet} let target = evalLogic(${toExpr}, undefined, { item }); if (typeof target === "string" && target.includes(":")) { target = target.replace(/:([A-Za-z0-9_]+)/g, (_: any, key: string) => String(item[key] ?? "")); } if (target) navigate(String(target)); }}>`);
-                            writer.writeLine(`                    {rowActionIcons["${label}"] ? React.createElement((Icons as any)[rowActionIcons["${label}"]] || Icons.Square, { size: 14, className: "mr-1.5" }) : null}`);
+                            writer.writeLine(`                    {${iconSnippet}}`);
                             writer.writeLine(`                    ${label}`);
                             writer.writeLine(`                  </button>`);
                         }
@@ -1172,8 +1174,10 @@ export function emitComponent(project, frontendDir, component, ir) {
                             const argsCode = argsExpr !== "undefined" ? `evalLogic(${argsExpr}, undefined, { item })` : "{}";
                             const confirmMsg = action.onClick.confirmMessage;
                             const confirmSnippet = confirmMsg ? `if (!window.confirm(${JSON.stringify(confirmMsg)})) return; ` : "";
+                            const iconName = rowActionIcons[label];
+                            const iconSnippet = iconName ? `React.createElement((Icons as any)["${iconName}"] || Icons.Square, { size: 14, className: "mr-1.5" })` : "null";
                             writer.writeLine(`                  <button type="button" className="${tableActionButtonClass}" onClick={(e) => { e.stopPropagation(); ${confirmSnippet} const input = ${argsCode}; rowActionOp_${idx}.execute(input, { kind: "tableRow", pageId: "", rowId: String(item["slug"] ?? i) }); }}>`);
-                            writer.writeLine(`                    {rowActionIcons["${label}"] ? React.createElement((Icons as any)[rowActionIcons["${label}"]] || Icons.Square, { size: 14, className: "mr-1.5" }) : null}`);
+                            writer.writeLine(`                    {${iconSnippet}}`);
                             writer.writeLine(`                    ${label}`);
                             writer.writeLine(`                  </button>`);
                         }
@@ -1218,6 +1222,33 @@ export function emitComponent(project, frontendDir, component, ir) {
 }
 export function emitMarketingComponent(writer, m, policy, actionHandlers) {
     const primaryColor = policy.styling.theme.primaryColor;
+    const basePath = policy.framework?.rendering?.basePath ?? "/";
+    const normalizeBasePath = (value) => {
+        if (!value || value === "/")
+            return "";
+        let normalized = value.trim();
+        if (!normalized.startsWith("/"))
+            normalized = `/${normalized}`;
+        if (normalized.endsWith("/"))
+            normalized = normalized.slice(0, -1);
+        return normalized;
+    };
+    const resolveHref = (href) => {
+        if (!href)
+            return "#";
+        if (href.startsWith("#"))
+            return href;
+        if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(href) || href.startsWith("//"))
+            return href;
+        const base = normalizeBasePath(basePath);
+        if (!base)
+            return href;
+        if (!href.startsWith("/"))
+            return `${base}/${href}`;
+        if (href === base || href.startsWith(`${base}/`))
+            return href;
+        return `${base}${href}`;
+    };
     const marketingVisual = policy.visual?.marketing ?? {};
     const radiusMap = { none: "rounded-none", sm: "rounded-sm", md: "rounded-md", lg: "rounded-lg", full: "rounded-full" };
     const radius = radiusMap[policy.styling.theme.borderRadius] || "rounded-xl";
@@ -1245,11 +1276,12 @@ export function emitMarketingComponent(writer, m, policy, actionHandlers) {
             m.actions.forEach((a, idx) => {
                 const btnCls = a.variant === "primary" ? `bg-[${primaryColor}] text-white` : "bg-white/10 text-white border border-white/20 hover:bg-white/20";
                 const handler = actionHandlers?.[idx];
+                const href = resolveHref(a.href);
                 if (handler) {
                     writer.writeLine(`          <button type="button" onClick={${handler}} className="inline-flex items-center gap-2 px-6 py-3 font-semibold ${radius} transition-all ${btnCls}">`);
                 }
                 else {
-                    writer.writeLine(`          <a href="${a.href ?? "#"}" className="inline-flex items-center gap-2 px-6 py-3 font-semibold ${radius} transition-all ${btnCls}">`);
+                    writer.writeLine(`          <a href="${href}" className="inline-flex items-center gap-2 px-6 py-3 font-semibold ${radius} transition-all ${btnCls}">`);
                 }
                 if (a.icon)
                     writer.writeLine(`            {React.createElement((Icons as any)["${a.icon}"], { size: 20 })}`);
@@ -1377,11 +1409,12 @@ export function emitMarketingComponent(writer, m, policy, actionHandlers) {
             writer.writeLine(`      <div className="flex justify-center gap-4 pt-4">`);
             m.actions.forEach((a, idx) => {
                 const handler = actionHandlers?.[idx];
+                const href = resolveHref(a.href);
                 if (handler) {
                     writer.writeLine(`        <button type="button" onClick={${handler}} className="inline-flex items-center gap-2 px-8 py-3.5 font-bold ${radius} bg-[${primaryColor}] text-white hover:scale-105 active:scale-95 shadow-xl shadow-[${primaryColor}]/20 transition-all">`);
                 }
                 else {
-                    writer.writeLine(`        <a href="${a.href ?? "#"}" className="inline-flex items-center gap-2 px-8 py-3.5 font-bold ${radius} bg-[${primaryColor}] text-white hover:scale-105 active:scale-95 shadow-xl shadow-[${primaryColor}]/20 transition-all">`);
+                    writer.writeLine(`        <a href="${href}" className="inline-flex items-center gap-2 px-8 py-3.5 font-bold ${radius} bg-[${primaryColor}] text-white hover:scale-105 active:scale-95 shadow-xl shadow-[${primaryColor}]/20 transition-all">`);
                 }
                 if (a.icon)
                     writer.writeLine(`          {React.createElement((Icons as any)["${a.icon}"], { size: 20 })}`);

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

@@ -262,7 +262,9 @@ if ('serviceWorker' in navigator) {
         writer.writeLine("const adminMainClass = `${adminOffsetClass} max-w-none mx-auto ${contentPaddingClass} py-6`;");
         writer.writeLine("const defaultMainClass = `${contentWidthClass} mx-auto ${contentPaddingClass} ${densityClass} ${motionPageEnter}`;");
         writer.writeLine("const docsMainClass = `${visualContentWidth === \"full\" ? \"max-w-none\" : \"max-w-[1400px]\"} mx-auto ${docsPaddingClass} ${docsDensityClass} ${motionDocsEnter}`;");
-        writer.writeLine("const isActivePath = (path: string) => relativePath === path;");
+        writer.writeLine("const normalizePath = (p: string) => (p && p.length > 1 ? p.replace(/\\/$/, \"\") : p || \"/\");");
+        writer.writeLine("const normalizedPath = normalizePath(relativePath);");
+        writer.writeLine("const isActivePath = (path: string) => normalizePath(path) === normalizedPath;");
         writer.writeLine(`const docsLinks = ${JSON.stringify(docsLinks, null, 2)};`);
         writer.writeLine(`const defaultDocsGroupLabel = ${JSON.stringify(docsGroupLabel)};`);
         writer.writeLine("const docsSidebarGroups = docsLinks.reduce((acc, link) => {");
@@ -272,8 +274,8 @@ if ('serviceWorker' in navigator) {
         writer.writeLine("  group.items.push(link);");
         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(relativePath);");
+        writer.writeLine("const docsPaths = docsLinks.map((link) => normalizePath(link.path));");
+        writer.writeLine("const isDocsRoute = docsPaths.includes(normalizedPath);");
         writer.writeLine("const topbarLinks = Array.isArray(visualNavItems.topbar) && visualNavItems.topbar.length > 0 ? visualNavItems.topbar : " + JSON.stringify(navbarLinks) + ";");
         writer.writeLine("const sidebarLinks = Array.isArray(visualNavItems.sidebar) && visualNavItems.sidebar.length > 0 ? visualNavItems.sidebar : " + JSON.stringify(navbarLinks) + ";");
         writer.writeLine("const footerLinks = Array.isArray(visualFooterLinks) ? visualFooterLinks : [{ label: \"Terms\", href: \"#\" }, { label: \"Privacy\", href: \"#\" }, { label: \"Contact\", href: \"#\" }];");

package/dist/ir/target/frontend.policy.d.ts

@@ -281,31 +281,85 @@ export declare const FrontendPolicySchema: z.ZodDefault<z.ZodObject<{
             fromDir?: string | undefined;
         } | undefined;
     }>>;
-}, "strip", z.ZodTypeAny, {
-    build: {
-        postbuild?: string | undefined;
-        copyTo?: {
-            enabled: boolean;
-            targetRoot: string;
-            fromDir: string;
-            basePath?: string | undefined;
-        } | undefined;
-        copyToPublic?: {
-            enabled: boolean;
-            targetRoot: string;
-            fromDir: string;
-            basePath?: string | undefined;
-        } | undefined;
-    };
-    styling: {
+    visual: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    styling: z.ZodDefault<z.ZodObject<{
+        cssFramework: z.ZodDefault<z.ZodEnum<["tailwind", "none"]>>;
+        themePack: z.ZodDefault<z.ZodEnum<["default", "admin"]>>;
+        theme: z.ZodDefault<z.ZodObject<{
+            primaryColor: z.ZodDefault<z.ZodString>;
+            borderRadius: z.ZodDefault<z.ZodEnum<["none", "sm", "md", "lg", "full"]>>;
+        }, "strip", z.ZodTypeAny, {
+            primaryColor: string;
+            borderRadius: "none" | "sm" | "md" | "lg" | "full";
+        }, {
+            primaryColor?: string | undefined;
+            borderRadius?: "none" | "sm" | "md" | "lg" | "full" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
         cssFramework: "none" | "tailwind";
         themePack: "default" | "admin";
         theme: {
             primaryColor: string;
             borderRadius: "none" | "sm" | "md" | "lg" | "full";
         };
-    };
-    framework: {
+    }, {
+        cssFramework?: "none" | "tailwind" | undefined;
+        themePack?: "default" | "admin" | undefined;
+        theme?: {
+            primaryColor?: string | undefined;
+            borderRadius?: "none" | "sm" | "md" | "lg" | "full" | undefined;
+        } | undefined;
+    }>>;
+    framework: z.ZodDefault<z.ZodObject<{
+        library: z.ZodDefault<z.ZodEnum<["react"]>>;
+        runtime: z.ZodDefault<z.ZodEnum<["vite", "none"]>>;
+        router: z.ZodDefault<z.ZodEnum<["react-router-dom", "none"]>>;
+        iconLibrary: z.ZodDefault<z.ZodEnum<["lucide-react", "none"]>>;
+        rendering: z.ZodDefault<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<["csr", "ssg", "hybrid"]>>;
+            basePath: z.ZodDefault<z.ZodString>;
+            prerender: z.ZodDefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                routes: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"auto">, z.ZodArray<z.ZodString, "many">]>>;
+                outDir: z.ZodDefault<z.ZodString>;
+                emitSitemap: z.ZodDefault<z.ZodBoolean>;
+                emitRobotsTxt: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                outDir: string;
+                routes: string[] | "auto";
+                emitSitemap: boolean;
+                emitRobotsTxt: boolean;
+            }, {
+                enabled?: boolean | undefined;
+                outDir?: string | undefined;
+                routes?: string[] | "auto" | undefined;
+                emitSitemap?: boolean | undefined;
+                emitRobotsTxt?: boolean | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            basePath: string;
+            mode: "csr" | "ssg" | "hybrid";
+            prerender: {
+                enabled: boolean;
+                outDir: string;
+                routes: string[] | "auto";
+                emitSitemap: boolean;
+                emitRobotsTxt: boolean;
+            };
+        }, {
+            basePath?: string | undefined;
+            mode?: "csr" | "ssg" | "hybrid" | undefined;
+            prerender?: {
+                enabled?: boolean | undefined;
+                outDir?: string | undefined;
+                routes?: string[] | "auto" | undefined;
+                emitSitemap?: boolean | undefined;
+                emitRobotsTxt?: boolean | undefined;
+            } | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
         library: "react";
         runtime: "none" | "vite";
         router: "none" | "react-router-dom";
@@ -321,9 +375,72 @@ export declare const FrontendPolicySchema: z.ZodDefault<z.ZodObject<{
                 emitRobotsTxt: boolean;
             };
         };
-    };
-}, {
-    build?: {
+    }, {
+        library?: "react" | undefined;
+        runtime?: "none" | "vite" | undefined;
+        router?: "none" | "react-router-dom" | undefined;
+        iconLibrary?: "none" | "lucide-react" | undefined;
+        rendering?: {
+            basePath?: string | undefined;
+            mode?: "csr" | "ssg" | "hybrid" | undefined;
+            prerender?: {
+                enabled?: boolean | undefined;
+                outDir?: string | undefined;
+                routes?: string[] | "auto" | undefined;
+                emitSitemap?: boolean | undefined;
+                emitRobotsTxt?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+    }>>;
+    build: z.ZodDefault<z.ZodObject<{
+        postbuild: z.ZodOptional<z.ZodString>;
+        copyTo: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            targetRoot: z.ZodDefault<z.ZodString>;
+            basePath: z.ZodOptional<z.ZodString>;
+            fromDir: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            targetRoot: string;
+            fromDir: string;
+            basePath?: string | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            basePath?: string | undefined;
+            targetRoot?: string | undefined;
+            fromDir?: string | undefined;
+        }>>;
+        copyToPublic: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            targetRoot: z.ZodDefault<z.ZodString>;
+            basePath: z.ZodOptional<z.ZodString>;
+            fromDir: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            targetRoot: string;
+            fromDir: string;
+            basePath?: string | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            basePath?: string | undefined;
+            targetRoot?: string | undefined;
+            fromDir?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        postbuild?: string | undefined;
+        copyTo?: {
+            enabled: boolean;
+            targetRoot: string;
+            fromDir: string;
+            basePath?: string | undefined;
+        } | undefined;
+        copyToPublic?: {
+            enabled: boolean;
+            targetRoot: string;
+            fromDir: string;
+            basePath?: string | undefined;
+        } | undefined;
+    }, {
         postbuild?: string | undefined;
         copyTo?: {
             enabled?: boolean | undefined;
@@ -337,16 +454,102 @@ export declare const FrontendPolicySchema: z.ZodDefault<z.ZodObject<{
             targetRoot?: string | undefined;
             fromDir?: string | undefined;
         } | undefined;
-    } | undefined;
-    styling?: {
+    }>>;
+    visual: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    styling: z.ZodDefault<z.ZodObject<{
+        cssFramework: z.ZodDefault<z.ZodEnum<["tailwind", "none"]>>;
+        themePack: z.ZodDefault<z.ZodEnum<["default", "admin"]>>;
+        theme: z.ZodDefault<z.ZodObject<{
+            primaryColor: z.ZodDefault<z.ZodString>;
+            borderRadius: z.ZodDefault<z.ZodEnum<["none", "sm", "md", "lg", "full"]>>;
+        }, "strip", z.ZodTypeAny, {
+            primaryColor: string;
+            borderRadius: "none" | "sm" | "md" | "lg" | "full";
+        }, {
+            primaryColor?: string | undefined;
+            borderRadius?: "none" | "sm" | "md" | "lg" | "full" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        cssFramework: "none" | "tailwind";
+        themePack: "default" | "admin";
+        theme: {
+            primaryColor: string;
+            borderRadius: "none" | "sm" | "md" | "lg" | "full";
+        };
+    }, {
         cssFramework?: "none" | "tailwind" | undefined;
         themePack?: "default" | "admin" | undefined;
         theme?: {
             primaryColor?: string | undefined;
             borderRadius?: "none" | "sm" | "md" | "lg" | "full" | undefined;
         } | undefined;
-    } | undefined;
-    framework?: {
+    }>>;
+    framework: z.ZodDefault<z.ZodObject<{
+        library: z.ZodDefault<z.ZodEnum<["react"]>>;
+        runtime: z.ZodDefault<z.ZodEnum<["vite", "none"]>>;
+        router: z.ZodDefault<z.ZodEnum<["react-router-dom", "none"]>>;
+        iconLibrary: z.ZodDefault<z.ZodEnum<["lucide-react", "none"]>>;
+        rendering: z.ZodDefault<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<["csr", "ssg", "hybrid"]>>;
+            basePath: z.ZodDefault<z.ZodString>;
+            prerender: z.ZodDefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                routes: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"auto">, z.ZodArray<z.ZodString, "many">]>>;
+                outDir: z.ZodDefault<z.ZodString>;
+                emitSitemap: z.ZodDefault<z.ZodBoolean>;
+                emitRobotsTxt: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                outDir: string;
+                routes: string[] | "auto";
+                emitSitemap: boolean;
+                emitRobotsTxt: boolean;
+            }, {
+                enabled?: boolean | undefined;
+                outDir?: string | undefined;
+                routes?: string[] | "auto" | undefined;
+                emitSitemap?: boolean | undefined;
+                emitRobotsTxt?: boolean | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            basePath: string;
+            mode: "csr" | "ssg" | "hybrid";
+            prerender: {
+                enabled: boolean;
+                outDir: string;
+                routes: string[] | "auto";
+                emitSitemap: boolean;
+                emitRobotsTxt: boolean;
+            };
+        }, {
+            basePath?: string | undefined;
+            mode?: "csr" | "ssg" | "hybrid" | undefined;
+            prerender?: {
+                enabled?: boolean | undefined;
+                outDir?: string | undefined;
+                routes?: string[] | "auto" | undefined;
+                emitSitemap?: boolean | undefined;
+                emitRobotsTxt?: boolean | undefined;
+            } | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        library: "react";
+        runtime: "none" | "vite";
+        router: "none" | "react-router-dom";
+        iconLibrary: "none" | "lucide-react";
+        rendering: {
+            basePath: string;
+            mode: "csr" | "ssg" | "hybrid";
+            prerender: {
+                enabled: boolean;
+                outDir: string;
+                routes: string[] | "auto";
+                emitSitemap: boolean;
+                emitRobotsTxt: boolean;
+            };
+        };
+    }, {
         library?: "react" | undefined;
         runtime?: "none" | "vite" | undefined;
         router?: "none" | "react-router-dom" | undefined;
@@ -362,7 +565,71 @@ export declare const FrontendPolicySchema: z.ZodDefault<z.ZodObject<{
                 emitRobotsTxt?: boolean | undefined;
             } | undefined;
         } | undefined;
-    } | undefined;
-}>>;
+    }>>;
+    build: z.ZodDefault<z.ZodObject<{
+        postbuild: z.ZodOptional<z.ZodString>;
+        copyTo: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            targetRoot: z.ZodDefault<z.ZodString>;
+            basePath: z.ZodOptional<z.ZodString>;
+            fromDir: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            targetRoot: string;
+            fromDir: string;
+            basePath?: string | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            basePath?: string | undefined;
+            targetRoot?: string | undefined;
+            fromDir?: string | undefined;
+        }>>;
+        copyToPublic: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            targetRoot: z.ZodDefault<z.ZodString>;
+            basePath: z.ZodOptional<z.ZodString>;
+            fromDir: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            targetRoot: string;
+            fromDir: string;
+            basePath?: string | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            basePath?: string | undefined;
+            targetRoot?: string | undefined;
+            fromDir?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        postbuild?: string | undefined;
+        copyTo?: {
+            enabled: boolean;
+            targetRoot: string;
+            fromDir: string;
+            basePath?: string | undefined;
+        } | undefined;
+        copyToPublic?: {
+            enabled: boolean;
+            targetRoot: string;
+            fromDir: string;
+            basePath?: string | undefined;
+        } | undefined;
+    }, {
+        postbuild?: string | undefined;
+        copyTo?: {
+            enabled?: boolean | undefined;
+            basePath?: string | undefined;
+            targetRoot?: string | undefined;
+            fromDir?: string | undefined;
+        } | undefined;
+        copyToPublic?: {
+            enabled?: boolean | undefined;
+            basePath?: string | undefined;
+            targetRoot?: string | undefined;
+            fromDir?: string | undefined;
+        } | undefined;
+    }>>;
+    visual: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.ZodTypeAny, "passthrough">>>;
 export type FrontendPolicy = z.infer<typeof FrontendPolicySchema>;
 export declare function normalizeFrontendPolicy(input: unknown): FrontendPolicy;

package/dist/ir/target/frontend.policy.js

@@ -42,7 +42,8 @@ export const FrontendPolicySchema = z.object({
             fromDir: z.string().default("dist"),
         }).optional(),
     }).default({}),
-}).default({});
+    visual: z.record(z.any()).optional(),
+}).passthrough().default({});
 export function normalizeFrontendPolicy(input) {
     return FrontendPolicySchema.parse(input || {});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "irgen",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "private": false,
   "license": "MIT",
   "description": "a policy-driven, IR-based code generation toolchain for backend, frontend, and beyond.",