@noego/wood 0.0.1

package/dist/stick/static_renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stick/static_renderer.ts"],"sourcesContent":["import { pathToFileURL } from 'url';\nimport { resolve } from 'path';\nimport { parseViewsFile } from '../parser/views_parser.js';\nimport type { ViewDef } from '../types/index.js';\n\n// ─────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────\n\nexport interface WoodStaticRendererConfig {\n    /** Path to views.yaml (e.g., './ui/views.yaml') */\n    viewsConfig: string;\n    /** Base directory for components (e.g., './ui') */\n    componentDir: string;\n}\n\nexport interface WoodRenderOptions {\n    /** Dot-path view key (e.g., 'chat.main') */\n    viewKey: string;\n    /** Mock data for layouts and view */\n    data?: {\n        layout?: any[];\n        view?: any;\n    };\n    /** Wood bridge object passed as a prop to layouts and views */\n    wood?: any;\n}\n\nexport interface WoodRenderToPageOptions extends WoodRenderOptions {\n    /** Custom HTML template. Use {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders */\n    template?: string;\n}\n\nexport interface WoodRenderResult {\n    /** Rendered component HTML */\n    html: string;\n    /** Content from <svelte:head> tags */\n    head: string;\n    /** Component CSS */\n    css: string;\n    /** The matched view definition */\n    viewDef: ViewDef;\n}\n\nasync function loadWoodRecursiveRenderComponent(): Promise<any> {\n    const candidates = [\n        './WoodRecursiveRender.svelte',\n        '../../src/stick/WoodRecursiveRender.svelte',\n    ];\n\n    let lastNotFoundError: unknown;\n    for (const candidate of candidates) {\n        try {\n            return await import(/* @vite-ignore */ candidate);\n        } catch (error) {\n            const code = (error as { code?: string })?.code;\n            const message = error instanceof Error ? error.message : String(error);\n            const isNotFound = code === 'ERR_MODULE_NOT_FOUND' || message.includes('Cannot find module');\n            if (!isNotFound) {\n                throw error;\n            }\n            lastNotFoundError = error;\n        }\n    }\n\n    throw lastNotFoundError ?? new Error('Failed to load WoodRecursiveRender.svelte.');\n}\n\n// ─────────────────────────────────────────────────────────────\n// WoodStaticRenderer\n// ─────────────────────────────────────────────────────────────\n\nexport class WoodStaticRenderer {\n    private views: ViewDef[];\n    private componentDir: string;\n\n    constructor(views: ViewDef[], componentDir: string) {\n        this.views = views;\n        this.componentDir = componentDir;\n    }\n\n    /** Find a ViewDef by dot-path key (e.g., 'chat.main') */\n    private findView(viewKey: string): ViewDef {\n        const segments = viewKey.split('.');\n        const windowName = segments[0];\n        const pageName = segments.slice(1).join('.');\n\n        const found = this.views.find(\n            v => v.windowName === windowName && v.pageName === pageName\n        );\n        if (!found) {\n            const available = this.views.map(v => `${v.windowName}.${v.pageName}`).join(', ');\n            throw new Error(\n                `No view found for key \"${viewKey}\". Available views: ${available}`\n            );\n        }\n        return found;\n    }\n\n    /** Dynamically import a Svelte component via the ESM loader */\n    private async loadComponent(relativePath: string): Promise<any> {\n        const absPath = resolve(this.componentDir, relativePath);\n        const fileUrl = pathToFileURL(absPath).href;\n        const mod = await import(fileUrl);\n        return mod.default;\n    }\n\n    async render(options: WoodRenderOptions): Promise<WoodRenderResult> {\n        const { viewKey, data = {}, wood } = options;\n\n        const viewDef = this.findView(viewKey);\n\n        // Load view component\n        const view = await this.loadComponent(viewDef.viewPath);\n\n        // Load layout components\n        const layouts = [];\n        for (const layoutPath of viewDef.layouts) {\n            layouts.push(await this.loadComponent(layoutPath));\n        }\n\n        // Build server data\n        const serverData = {\n            layout: data.layout || [],\n            view: data.view || {},\n        };\n\n        // Variable-based dynamic imports so tsc doesn't try to resolve these\n        // modules during DTS generation (svelte is a peer dep, .svelte needs the loader).\n        const svelteServer = 'svelte/server';\n        const { render } = await import(/* @vite-ignore */ svelteServer);\n        const WoodRecursiveRenderMod = await loadWoodRecursiveRenderComponent();\n        const WoodRecursiveRender = WoodRecursiveRenderMod.default;\n\n        const result = render(WoodRecursiveRender, {\n            props: {\n                layouts,\n                view,\n                data: serverData,\n                wood,\n            },\n        });\n\n        return {\n            html: result.html,\n            head: result.head,\n            css: (result as any).css?.code || '',\n            viewDef,\n        };\n    }\n\n    /**\n     * Render to a full HTML document.\n     * Uses default template or custom template with {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders.\n     */\n    async renderToPage(options: WoodRenderToPageOptions): Promise<string> {\n        const { html, head, css } = await this.render(options);\n\n        const defaultTemplate = `<!DOCTYPE html>\n<html>\n<head>\n    {{{HEAD}}}\n    <style>{{{CSS}}}</style>\n</head>\n<body>\n    <div id=\"app\">{{{APP}}}</div>\n</body>\n</html>`;\n\n        const template = options.template || defaultTemplate;\n\n        return template\n            .replace('{{{HEAD}}}', head)\n            .replace('{{{CSS}}}', css)\n            .replace('{{{APP}}}', html);\n    }\n}\n\n// ─────────────────────────────────────────────────────────────\n// Factory Function\n// ─────────────────────────────────────────────────────────────\n\nexport function createWoodStaticRenderer(\n    config: WoodStaticRendererConfig\n): WoodStaticRenderer {\n    const views = parseViewsFile(config.viewsConfig);\n    const componentDir = resolve(config.componentDir);\n    return new WoodStaticRenderer(views, componentDir);\n}\n"],"mappings":"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","names":[]}

package/dist/stick/template_resolver.cjs

@@ -0,0 +1,156 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var template_resolver_exports = {};
+__export(template_resolver_exports, {
+  resolveImageRendererTemplate: () => resolveImageRendererTemplate
+});
+module.exports = __toCommonJS(template_resolver_exports);
+var fs = __toESM(require("fs"), 1);
+var path = __toESM(require("path"), 1);
+function resolveImageRendererTemplate(input) {
+  if (input.template) {
+    return input.template;
+  }
+  if (!input.componentDir) {
+    return void 0;
+  }
+  const componentDir = path.resolve(input.componentDir);
+  const htmlPath = path.join(componentDir, "index.html");
+  if (!fs.existsSync(htmlPath)) {
+    return void 0;
+  }
+  let template = fs.readFileSync(htmlPath, "utf8");
+  template = stripRuntimeScripts(template);
+  template = ensureAppPlaceholder(template);
+  const cssPath = path.join(componentDir, "styles.css");
+  const globalCss = fs.existsSync(cssPath) ? fs.readFileSync(cssPath, "utf8") : void 0;
+  template = ensureHeadPlaceholders(template, globalCss);
+  return template;
+}
+function stripRuntimeScripts(template) {
+  return template.replace(
+    /<script\b[^>]*type=["']module["'][^>]*>\s*<\/script>\s*/gi,
+    ""
+  ).replace(
+    /<script\b[^>]*src=["'][^"']*main\.[^"']+["'][^>]*>\s*<\/script>\s*/gi,
+    ""
+  );
+}
+function ensureAppPlaceholder(template) {
+  if (template.includes("{{{APP}}}")) {
+    return template;
+  }
+  const appRootPattern = /<div\s+id=["']app["'][^>]*>\s*<\/div>/i;
+  if (!appRootPattern.test(template)) {
+    throw new Error(
+      'Renderer HTML template must contain <div id="app"></div> or {{{APP}}}.'
+    );
+  }
+  return template.replace(appRootPattern, '<div id="app">{{{APP}}}</div>');
+}
+function ensureHeadPlaceholders(template, globalCss) {
+  const injections = [];
+  if (globalCss && globalCss.trim().length > 0) {
+    if (/@tailwind\b/.test(globalCss)) {
+      injections.push('<script src="https://cdn.tailwindcss.com"></script>');
+      injections.push('<style type="text/tailwindcss">');
+      injections.push(globalCss);
+      injections.push("</style>");
+    } else {
+      injections.push("<style>");
+      injections.push(globalCss);
+      injections.push("</style>");
+    }
+  }
+  if (!template.includes("{{{HEAD}}}")) {
+    injections.push("{{{HEAD}}}");
+  }
+  if (!template.includes("{{{CSS}}}")) {
+    injections.push("<style>{{{CSS}}}</style>");
+  }
+  if (shouldInjectPreviewBackdrop(globalCss)) {
+    injections.push("<style data-wood-stick-preview-backdrop>");
+    injections.push(getPreviewBackdropCss());
+    injections.push("</style>");
+  }
+  if (injections.length === 0) {
+    return template;
+  }
+  if (!/<\/head>/i.test(template)) {
+    throw new Error("Renderer HTML template must contain a </head> tag.");
+  }
+  return template.replace(/<\/head>/i, `${injections.join("\n")}
+</head>`);
+}
+function shouldInjectPreviewBackdrop(globalCss) {
+  if (!globalCss) {
+    return false;
+  }
+  const hasTransparentBackground = /background(?:-color)?\s*:\s*transparent\b/i.test(globalCss);
+  const bodyBackgroundMatches = globalCss.matchAll(
+    /body[^{}]*\{[^}]*background(?:-color)?\s*:\s*([^;]+);?/gis
+  );
+  let hasOpaqueBodyBackground = false;
+  for (const match of bodyBackgroundMatches) {
+    const value = match[1]?.trim().toLowerCase() || "";
+    if (value !== "transparent") {
+      hasOpaqueBodyBackground = true;
+      break;
+    }
+  }
+  return hasTransparentBackground && !hasOpaqueBodyBackground;
+}
+function getPreviewBackdropCss() {
+  return [
+    "html, body, #app {",
+    "  min-height: 100%;",
+    "}",
+    "body {",
+    "  margin: 0;",
+    "  background: radial-gradient(130% 120% at 50% 100%, #0d3f59 0%, #0a2a3f 38%, #061a30 62%, #020617 100%) !important;",
+    "  color: #e2e8f0;",
+    "}",
+    "#app {",
+    "  position: relative;",
+    "  z-index: 1;",
+    "}",
+    "body::before {",
+    "  content: '';",
+    "  position: fixed;",
+    "  inset: 0;",
+    "  pointer-events: none;",
+    "  background: linear-gradient(90deg, rgba(2, 6, 23, 0.62) 0%, rgba(2, 6, 23, 0.24) 20%, rgba(2, 6, 23, 0.08) 50%, rgba(2, 6, 23, 0.24) 80%, rgba(2, 6, 23, 0.62) 100%);",
+    "}"
+  ].join("\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  resolveImageRendererTemplate
+});
+//# sourceMappingURL=template_resolver.cjs.map

package/dist/stick/template_resolver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stick/template_resolver.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nexport interface ResolveImageRendererTemplateInput {\n    template?: string;\n    componentDir?: string;\n}\n\nexport function resolveImageRendererTemplate(\n    input: ResolveImageRendererTemplateInput\n): string | undefined {\n    if (input.template) {\n        return input.template;\n    }\n\n    if (!input.componentDir) {\n        return undefined;\n    }\n\n    const componentDir = path.resolve(input.componentDir);\n    const htmlPath = path.join(componentDir, 'index.html');\n    if (!fs.existsSync(htmlPath)) {\n        return undefined;\n    }\n\n    let template = fs.readFileSync(htmlPath, 'utf8');\n    template = stripRuntimeScripts(template);\n    template = ensureAppPlaceholder(template);\n\n    const cssPath = path.join(componentDir, 'styles.css');\n    const globalCss = fs.existsSync(cssPath)\n        ? fs.readFileSync(cssPath, 'utf8')\n        : undefined;\n\n    template = ensureHeadPlaceholders(template, globalCss);\n    return template;\n}\n\nfunction stripRuntimeScripts(template: string): string {\n    return template\n        .replace(\n            /<script\\b[^>]*type=[\"']module[\"'][^>]*>\\s*<\\/script>\\s*/gi,\n            ''\n        )\n        .replace(\n            /<script\\b[^>]*src=[\"'][^\"']*main\\.[^\"']+[\"'][^>]*>\\s*<\\/script>\\s*/gi,\n            ''\n        );\n}\n\nfunction ensureAppPlaceholder(template: string): string {\n    if (template.includes('{{{APP}}}')) {\n        return template;\n    }\n\n    const appRootPattern = /<div\\s+id=[\"']app[\"'][^>]*>\\s*<\\/div>/i;\n    if (!appRootPattern.test(template)) {\n        throw new Error(\n            'Renderer HTML template must contain <div id=\"app\"></div> or {{{APP}}}.'\n        );\n    }\n\n    return template.replace(appRootPattern, '<div id=\"app\">{{{APP}}}</div>');\n}\n\nfunction ensureHeadPlaceholders(template: string, globalCss?: string): string {\n    const injections: string[] = [];\n\n    if (globalCss && globalCss.trim().length > 0) {\n        if (/@tailwind\\b/.test(globalCss)) {\n            injections.push('<script src=\"https://cdn.tailwindcss.com\"></script>');\n            injections.push('<style type=\"text/tailwindcss\">');\n            injections.push(globalCss);\n            injections.push('</style>');\n        } else {\n            injections.push('<style>');\n            injections.push(globalCss);\n            injections.push('</style>');\n        }\n    }\n\n    if (!template.includes('{{{HEAD}}}')) {\n        injections.push('{{{HEAD}}}');\n    }\n    if (!template.includes('{{{CSS}}}')) {\n        injections.push('<style>{{{CSS}}}</style>');\n    }\n\n    if (shouldInjectPreviewBackdrop(globalCss)) {\n        injections.push('<style data-wood-stick-preview-backdrop>');\n        injections.push(getPreviewBackdropCss());\n        injections.push('</style>');\n    }\n\n    if (injections.length === 0) {\n        return template;\n    }\n\n    if (!/<\\/head>/i.test(template)) {\n        throw new Error('Renderer HTML template must contain a </head> tag.');\n    }\n\n    return template.replace(/<\\/head>/i, `${injections.join('\\n')}\\n</head>`);\n}\n\nfunction shouldInjectPreviewBackdrop(globalCss?: string): boolean {\n    if (!globalCss) {\n        return false;\n    }\n\n    const hasTransparentBackground =\n        /background(?:-color)?\\s*:\\s*transparent\\b/i.test(globalCss);\n\n    const bodyBackgroundMatches = globalCss.matchAll(\n        /body[^{}]*\\{[^}]*background(?:-color)?\\s*:\\s*([^;]+);?/gis\n    );\n\n    let hasOpaqueBodyBackground = false;\n    for (const match of bodyBackgroundMatches) {\n        const value = match[1]?.trim().toLowerCase() || '';\n        if (value !== 'transparent') {\n            hasOpaqueBodyBackground = true;\n            break;\n        }\n    }\n\n    return hasTransparentBackground && !hasOpaqueBodyBackground;\n}\n\nfunction getPreviewBackdropCss(): string {\n    return [\n        'html, body, #app {',\n        '  min-height: 100%;',\n        '}',\n        'body {',\n        '  margin: 0;',\n        '  background: radial-gradient(130% 120% at 50% 100%, #0d3f59 0%, #0a2a3f 38%, #061a30 62%, #020617 100%) !important;',\n        '  color: #e2e8f0;',\n        '}',\n        '#app {',\n        '  position: relative;',\n        '  z-index: 1;',\n        '}',\n        'body::before {',\n        \"  content: '';\",\n        '  position: fixed;',\n        '  inset: 0;',\n        '  pointer-events: none;',\n        '  background: linear-gradient(90deg, rgba(2, 6, 23, 0.62) 0%, rgba(2, 6, 23, 0.24) 20%, rgba(2, 6, 23, 0.08) 50%, rgba(2, 6, 23, 0.24) 80%, rgba(2, 6, 23, 0.62) 100%);',\n        '}',\n    ].join('\\n');\n}\n"],"mappings":"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","names":[]}

package/dist/stick/template_resolver.d.cts

@@ -0,0 +1,7 @@
+interface ResolveImageRendererTemplateInput {
+    template?: string;
+    componentDir?: string;
+}
+declare function resolveImageRendererTemplate(input: ResolveImageRendererTemplateInput): string | undefined;
+
+export { type ResolveImageRendererTemplateInput, resolveImageRendererTemplate };

package/dist/stick/template_resolver.d.ts

@@ -0,0 +1,7 @@
+interface ResolveImageRendererTemplateInput {
+    template?: string;
+    componentDir?: string;
+}
+declare function resolveImageRendererTemplate(input: ResolveImageRendererTemplateInput): string | undefined;
+
+export { type ResolveImageRendererTemplateInput, resolveImageRendererTemplate };

package/dist/stick/template_resolver.js

@@ -0,0 +1,122 @@
+import * as fs from "fs";
+import * as path from "path";
+function resolveImageRendererTemplate(input) {
+  if (input.template) {
+    return input.template;
+  }
+  if (!input.componentDir) {
+    return void 0;
+  }
+  const componentDir = path.resolve(input.componentDir);
+  const htmlPath = path.join(componentDir, "index.html");
+  if (!fs.existsSync(htmlPath)) {
+    return void 0;
+  }
+  let template = fs.readFileSync(htmlPath, "utf8");
+  template = stripRuntimeScripts(template);
+  template = ensureAppPlaceholder(template);
+  const cssPath = path.join(componentDir, "styles.css");
+  const globalCss = fs.existsSync(cssPath) ? fs.readFileSync(cssPath, "utf8") : void 0;
+  template = ensureHeadPlaceholders(template, globalCss);
+  return template;
+}
+function stripRuntimeScripts(template) {
+  return template.replace(
+    /<script\b[^>]*type=["']module["'][^>]*>\s*<\/script>\s*/gi,
+    ""
+  ).replace(
+    /<script\b[^>]*src=["'][^"']*main\.[^"']+["'][^>]*>\s*<\/script>\s*/gi,
+    ""
+  );
+}
+function ensureAppPlaceholder(template) {
+  if (template.includes("{{{APP}}}")) {
+    return template;
+  }
+  const appRootPattern = /<div\s+id=["']app["'][^>]*>\s*<\/div>/i;
+  if (!appRootPattern.test(template)) {
+    throw new Error(
+      'Renderer HTML template must contain <div id="app"></div> or {{{APP}}}.'
+    );
+  }
+  return template.replace(appRootPattern, '<div id="app">{{{APP}}}</div>');
+}
+function ensureHeadPlaceholders(template, globalCss) {
+  const injections = [];
+  if (globalCss && globalCss.trim().length > 0) {
+    if (/@tailwind\b/.test(globalCss)) {
+      injections.push('<script src="https://cdn.tailwindcss.com"></script>');
+      injections.push('<style type="text/tailwindcss">');
+      injections.push(globalCss);
+      injections.push("</style>");
+    } else {
+      injections.push("<style>");
+      injections.push(globalCss);
+      injections.push("</style>");
+    }
+  }
+  if (!template.includes("{{{HEAD}}}")) {
+    injections.push("{{{HEAD}}}");
+  }
+  if (!template.includes("{{{CSS}}}")) {
+    injections.push("<style>{{{CSS}}}</style>");
+  }
+  if (shouldInjectPreviewBackdrop(globalCss)) {
+    injections.push("<style data-wood-stick-preview-backdrop>");
+    injections.push(getPreviewBackdropCss());
+    injections.push("</style>");
+  }
+  if (injections.length === 0) {
+    return template;
+  }
+  if (!/<\/head>/i.test(template)) {
+    throw new Error("Renderer HTML template must contain a </head> tag.");
+  }
+  return template.replace(/<\/head>/i, `${injections.join("\n")}
+</head>`);
+}
+function shouldInjectPreviewBackdrop(globalCss) {
+  if (!globalCss) {
+    return false;
+  }
+  const hasTransparentBackground = /background(?:-color)?\s*:\s*transparent\b/i.test(globalCss);
+  const bodyBackgroundMatches = globalCss.matchAll(
+    /body[^{}]*\{[^}]*background(?:-color)?\s*:\s*([^;]+);?/gis
+  );
+  let hasOpaqueBodyBackground = false;
+  for (const match of bodyBackgroundMatches) {
+    const value = match[1]?.trim().toLowerCase() || "";
+    if (value !== "transparent") {
+      hasOpaqueBodyBackground = true;
+      break;
+    }
+  }
+  return hasTransparentBackground && !hasOpaqueBodyBackground;
+}
+function getPreviewBackdropCss() {
+  return [
+    "html, body, #app {",
+    "  min-height: 100%;",
+    "}",
+    "body {",
+    "  margin: 0;",
+    "  background: radial-gradient(130% 120% at 50% 100%, #0d3f59 0%, #0a2a3f 38%, #061a30 62%, #020617 100%) !important;",
+    "  color: #e2e8f0;",
+    "}",
+    "#app {",
+    "  position: relative;",
+    "  z-index: 1;",
+    "}",
+    "body::before {",
+    "  content: '';",
+    "  position: fixed;",
+    "  inset: 0;",
+    "  pointer-events: none;",
+    "  background: linear-gradient(90deg, rgba(2, 6, 23, 0.62) 0%, rgba(2, 6, 23, 0.24) 20%, rgba(2, 6, 23, 0.08) 50%, rgba(2, 6, 23, 0.24) 80%, rgba(2, 6, 23, 0.62) 100%);",
+    "}"
+  ].join("\n");
+}
+export {
+  resolveImageRendererTemplate
+};
+//# sourceMappingURL=template_resolver.js.map

package/dist/stick/template_resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stick/template_resolver.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nexport interface ResolveImageRendererTemplateInput {\n    template?: string;\n    componentDir?: string;\n}\n\nexport function resolveImageRendererTemplate(\n    input: ResolveImageRendererTemplateInput\n): string | undefined {\n    if (input.template) {\n        return input.template;\n    }\n\n    if (!input.componentDir) {\n        return undefined;\n    }\n\n    const componentDir = path.resolve(input.componentDir);\n    const htmlPath = path.join(componentDir, 'index.html');\n    if (!fs.existsSync(htmlPath)) {\n        return undefined;\n    }\n\n    let template = fs.readFileSync(htmlPath, 'utf8');\n    template = stripRuntimeScripts(template);\n    template = ensureAppPlaceholder(template);\n\n    const cssPath = path.join(componentDir, 'styles.css');\n    const globalCss = fs.existsSync(cssPath)\n        ? fs.readFileSync(cssPath, 'utf8')\n        : undefined;\n\n    template = ensureHeadPlaceholders(template, globalCss);\n    return template;\n}\n\nfunction stripRuntimeScripts(template: string): string {\n    return template\n        .replace(\n            /<script\\b[^>]*type=[\"']module[\"'][^>]*>\\s*<\\/script>\\s*/gi,\n            ''\n        )\n        .replace(\n            /<script\\b[^>]*src=[\"'][^\"']*main\\.[^\"']+[\"'][^>]*>\\s*<\\/script>\\s*/gi,\n            ''\n        );\n}\n\nfunction ensureAppPlaceholder(template: string): string {\n    if (template.includes('{{{APP}}}')) {\n        return template;\n    }\n\n    const appRootPattern = /<div\\s+id=[\"']app[\"'][^>]*>\\s*<\\/div>/i;\n    if (!appRootPattern.test(template)) {\n        throw new Error(\n            'Renderer HTML template must contain <div id=\"app\"></div> or {{{APP}}}.'\n        );\n    }\n\n    return template.replace(appRootPattern, '<div id=\"app\">{{{APP}}}</div>');\n}\n\nfunction ensureHeadPlaceholders(template: string, globalCss?: string): string {\n    const injections: string[] = [];\n\n    if (globalCss && globalCss.trim().length > 0) {\n        if (/@tailwind\\b/.test(globalCss)) {\n            injections.push('<script src=\"https://cdn.tailwindcss.com\"></script>');\n            injections.push('<style type=\"text/tailwindcss\">');\n            injections.push(globalCss);\n            injections.push('</style>');\n        } else {\n            injections.push('<style>');\n            injections.push(globalCss);\n            injections.push('</style>');\n        }\n    }\n\n    if (!template.includes('{{{HEAD}}}')) {\n        injections.push('{{{HEAD}}}');\n    }\n    if (!template.includes('{{{CSS}}}')) {\n        injections.push('<style>{{{CSS}}}</style>');\n    }\n\n    if (shouldInjectPreviewBackdrop(globalCss)) {\n        injections.push('<style data-wood-stick-preview-backdrop>');\n        injections.push(getPreviewBackdropCss());\n        injections.push('</style>');\n    }\n\n    if (injections.length === 0) {\n        return template;\n    }\n\n    if (!/<\\/head>/i.test(template)) {\n        throw new Error('Renderer HTML template must contain a </head> tag.');\n    }\n\n    return template.replace(/<\\/head>/i, `${injections.join('\\n')}\\n</head>`);\n}\n\nfunction shouldInjectPreviewBackdrop(globalCss?: string): boolean {\n    if (!globalCss) {\n        return false;\n    }\n\n    const hasTransparentBackground =\n        /background(?:-color)?\\s*:\\s*transparent\\b/i.test(globalCss);\n\n    const bodyBackgroundMatches = globalCss.matchAll(\n        /body[^{}]*\\{[^}]*background(?:-color)?\\s*:\\s*([^;]+);?/gis\n    );\n\n    let hasOpaqueBodyBackground = false;\n    for (const match of bodyBackgroundMatches) {\n        const value = match[1]?.trim().toLowerCase() || '';\n        if (value !== 'transparent') {\n            hasOpaqueBodyBackground = true;\n            break;\n        }\n    }\n\n    return hasTransparentBackground && !hasOpaqueBodyBackground;\n}\n\nfunction getPreviewBackdropCss(): string {\n    return [\n        'html, body, #app {',\n        '  min-height: 100%;',\n        '}',\n        'body {',\n        '  margin: 0;',\n        '  background: radial-gradient(130% 120% at 50% 100%, #0d3f59 0%, #0a2a3f 38%, #061a30 62%, #020617 100%) !important;',\n        '  color: #e2e8f0;',\n        '}',\n        '#app {',\n        '  position: relative;',\n        '  z-index: 1;',\n        '}',\n        'body::before {',\n        \"  content: '';\",\n        '  position: fixed;',\n        '  inset: 0;',\n        '  pointer-events: none;',\n        '  background: linear-gradient(90deg, rgba(2, 6, 23, 0.62) 0%, rgba(2, 6, 23, 0.24) 20%, rgba(2, 6, 23, 0.08) 50%, rgba(2, 6, 23, 0.24) 80%, rgba(2, 6, 23, 0.62) 100%);',\n        '}',\n    ].join('\\n');\n}\n"],"mappings":"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","names":[]}

package/dist/testing/create_controller_harness.cjs

@@ -0,0 +1,175 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var create_controller_harness_exports = {};
+__export(create_controller_harness_exports, {
+  createControllerHarness: () => createControllerHarness
+});
+module.exports = __toCommonJS(create_controller_harness_exports);
+var import_node_fs = require("node:fs");
+var import_client = require("../client/index.js");
+var import_ipc = require("../ipc/index.js");
+var import_navigation = require("../navigation/index.js");
+var import_tracing = require("../tracing/index.js");
+var import_operations_parser = require("../parser/operations_parser.cjs");
+var import_create_router_bridge = require("./create_router_bridge.cjs");
+var import_create_test_router = require("./create_test_router.cjs");
+function readOperations(input) {
+  if (input.includes("\n") || input.includes(":")) {
+    return (0, import_operations_parser.parseOperations)(input);
+  }
+  return (0, import_operations_parser.parseOperations)((0, import_node_fs.readFileSync)(input, "utf-8"));
+}
+function mergeOperations(inputs) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {
+    for (const [channel, operation] of readOperations(input)) {
+      merged.set(channel, operation);
+    }
+  }
+  return merged;
+}
+function createRpcManifest(operations) {
+  return Array.from(operations.values()).map((operation) => ({
+    channel: operation.channel,
+    controller: operation.controller,
+    action: operation.action,
+    path: operation.channel.split("."),
+    hasInput: !!operation.inputSchema
+  }));
+}
+function registerClientBuiltins(container) {
+  if (typeof container.registerFunction !== "function") {
+    return;
+  }
+  const traceConfiguration = new import_tracing.TraceProviderConfiguration();
+  traceConfiguration.configureMode("test");
+  traceConfiguration.configureRuntime("renderer");
+  container.registerFunction(import_navigation.Navigation, () => (0, import_navigation.getNavigation)());
+  container.registerFunction(import_client.App, () => (0, import_client.getApp)());
+  container.registerFunction(import_client.Ipc, () => (0, import_ipc.getIpc)());
+  container.registerFunction(WindowControls, () => (0, import_client.getWindowControls)());
+  container.registerFunction(import_tracing.TraceProviderConfiguration, () => traceConfiguration);
+}
+class WindowControls {
+  async open(_windowId, _options) {
+  }
+  async close(_windowId) {
+  }
+  async focus(_windowId) {
+  }
+  async minimize(_windowId) {
+  }
+  async maximize(_windowId) {
+  }
+}
+async function createControllerHarness(options) {
+  await options.configureContainer?.(options.container);
+  if (typeof options.container.instance === "function") {
+    const rootTraceConfiguration = await options.container.instance(import_tracing.TraceProviderConfiguration);
+    rootTraceConfiguration.configureMode("test");
+    rootTraceConfiguration.configureRuntime("main");
+  }
+  const operations = mergeOperations(options.operations);
+  const { router } = (0, import_create_test_router.createTestRouter)("", {
+    container: options.container,
+    controllersDir: options.controllersDir,
+    middlewareDir: options.middlewareDir
+  });
+  router.loadOperations(operations);
+  await options.configureRouter?.(router);
+  const { bridge, events } = (0, import_create_router_bridge.createRouterBridge)(router);
+  const harnessBridge = Object.assign(bridge, {
+    __rpcManifest: createRpcManifest(operations)
+  });
+  const globalObj = globalThis;
+  const previousInternalBridge = globalObj[import_client.WOOD_INTERNAL_BRIDGE_KEY];
+  const previousWoodBridge = globalObj.wood;
+  globalObj[import_client.WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;
+  globalObj.wood = harnessBridge;
+  (0, import_client.clearClientContainerForTests)();
+  (0, import_client.clearClientAppForTests)();
+  (0, import_client.clearClientNavigationForTests)();
+  (0, import_client.clearClientWindowControlsForTests)();
+  (0, import_client.clearClientLoggersForTests)();
+  const scopedContainer = options.container.extend();
+  registerClientBuiltins(scopedContainer);
+  if (typeof scopedContainer.registerClass === "function") {
+    scopedContainer.registerClass(options.controllerClass);
+  }
+  const navigation = (0, import_navigation.getNavigation)();
+  await options.prepareClient?.({
+    bridge: harnessBridge,
+    events,
+    navigation,
+    container: scopedContainer
+  });
+  const controller = await scopedContainer.instance(options.controllerClass);
+  const trace = await scopedContainer.instance(import_tracing.TraceProvider);
+  if (options.initialize && typeof controller.initialize === "function") {
+    await Promise.resolve(
+      controller.initialize()
+    );
+  }
+  trace.info({
+    source: "wood.testing.controller-harness",
+    type: "harness.created",
+    payload: {
+      controllerClass: options.controllerClass.name
+    }
+  });
+  return {
+    controller,
+    bridge: harnessBridge,
+    events,
+    router,
+    container: scopedContainer,
+    navigation,
+    trace,
+    destroy: () => {
+      trace.info({
+        source: "wood.testing.controller-harness",
+        type: "harness.destroyed"
+      });
+      if (typeof controller.destroy === "function") {
+        controller.destroy();
+      }
+      events.clear();
+      (0, import_client.clearClientContainerForTests)();
+      (0, import_client.clearClientAppForTests)();
+      (0, import_client.clearClientNavigationForTests)();
+      (0, import_client.clearClientWindowControlsForTests)();
+      (0, import_client.clearClientLoggersForTests)();
+      if (previousInternalBridge === void 0) {
+        delete globalObj[import_client.WOOD_INTERNAL_BRIDGE_KEY];
+      } else {
+        globalObj[import_client.WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;
+      }
+      if (previousWoodBridge === void 0) {
+        delete globalObj.wood;
+      } else {
+        globalObj.wood = previousWoodBridge;
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createControllerHarness
+});
+//# sourceMappingURL=create_controller_harness.cjs.map

package/dist/testing/create_controller_harness.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/create_controller_harness.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport {\n  App,\n  clearClientAppForTests,\n  clearClientContainerForTests,\n  clearClientLoggersForTests,\n  clearClientNavigationForTests,\n  clearClientWindowControlsForTests,\n  getApp,\n  getWindowControls,\n  Ipc,\n  WOOD_INTERNAL_BRIDGE_KEY,\n} from '../client/index.js';\nimport { getIpc } from '../ipc/index.js';\nimport { Navigation, getNavigation } from '../navigation/index.js';\nimport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport type { OperationDef } from '../types/operations.cjs';\nimport { createRouterBridge, type RouterBridgeResult } from './create_router_bridge.cjs';\nimport { createTestRouter } from './create_test_router.cjs';\n\nexport interface CreateControllerHarnessOptions<T> {\n  controllerClass: new (...args: any[]) => T;\n  container: any;\n  operations: string | string[];\n  controllersDir: string;\n  middlewareDir?: string;\n  configureContainer?: (container: any) => void | Promise<void>;\n  configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;\n  prepareClient?: (context: {\n    bridge: Record<string, any>;\n    events: RouterBridgeResult['events'];\n    navigation: Navigation;\n    container: any;\n  }) => void | Promise<void>;\n  initialize?: boolean;\n}\n\nexport interface ControllerHarnessResult<T> extends RouterBridgeResult {\n  controller: T;\n  container: any;\n  router: ReturnType<typeof createTestRouter>['router'];\n  navigation: Navigation;\n  trace: TraceProvider;\n  destroy: () => void;\n}\n\ntype MutableGlobal = typeof globalThis & {\n  [WOOD_INTERNAL_BRIDGE_KEY]?: unknown;\n  wood?: unknown;\n};\n\nfunction readOperations(input: string): Map<string, OperationDef> {\n  if (input.includes('\\n') || input.includes(':')) {\n    return parseOperations(input);\n  }\n\n  return parseOperations(readFileSync(input, 'utf-8'));\n}\n\nfunction mergeOperations(inputs: string | string[]): Map<string, OperationDef> {\n  const merged = new Map<string, OperationDef>();\n\n  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {\n    for (const [channel, operation] of readOperations(input)) {\n      merged.set(channel, operation);\n    }\n  }\n\n  return merged;\n}\n\nfunction createRpcManifest(operations: Map<string, OperationDef>) {\n  return Array.from(operations.values()).map((operation) => ({\n    channel: operation.channel,\n    controller: operation.controller,\n    action: operation.action,\n    path: operation.channel.split('.'),\n    hasInput: !!operation.inputSchema,\n  }));\n}\n\nfunction registerClientBuiltins(container: any): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureMode('test');\n  traceConfiguration.configureRuntime('renderer');\n\n  container.registerFunction(Navigation, () => getNavigation());\n  container.registerFunction(App, () => getApp());\n  container.registerFunction(Ipc, () => getIpc());\n  container.registerFunction(WindowControls, () => getWindowControls());\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration);\n}\n\nclass WindowControls {\n  async open(_windowId: string, _options?: Record<string, unknown>): Promise<void> {}\n  async close(_windowId?: string): Promise<void> {}\n  async focus(_windowId: string): Promise<void> {}\n  async minimize(_windowId?: string): Promise<void> {}\n  async maximize(_windowId?: string): Promise<void> {}\n}\n\nexport async function createControllerHarness<T>(\n  options: CreateControllerHarnessOptions<T>,\n): Promise<ControllerHarnessResult<T>> {\n  await options.configureContainer?.(options.container);\n\n  if (typeof options.container.instance === 'function') {\n    const rootTraceConfiguration = await options.container.instance(TraceProviderConfiguration);\n    rootTraceConfiguration.configureMode('test');\n    rootTraceConfiguration.configureRuntime('main');\n  }\n\n  const operations = mergeOperations(options.operations);\n  const { router } = createTestRouter('', {\n    container: options.container,\n    controllersDir: options.controllersDir,\n    middlewareDir: options.middlewareDir,\n  });\n  router.loadOperations(operations);\n  await options.configureRouter?.(router);\n\n  const { bridge, events } = createRouterBridge(router);\n  const harnessBridge = Object.assign(bridge, {\n    __rpcManifest: createRpcManifest(operations),\n  });\n\n  const globalObj = globalThis as MutableGlobal;\n  const previousInternalBridge = globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n  const previousWoodBridge = globalObj.wood;\n  globalObj[WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;\n  globalObj.wood = harnessBridge;\n\n  clearClientContainerForTests();\n  clearClientAppForTests();\n  clearClientNavigationForTests();\n  clearClientWindowControlsForTests();\n  clearClientLoggersForTests();\n\n  const scopedContainer = options.container.extend();\n  registerClientBuiltins(scopedContainer);\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(options.controllerClass);\n  }\n  const navigation = getNavigation();\n  await options.prepareClient?.({\n    bridge: harnessBridge,\n    events,\n    navigation,\n    container: scopedContainer,\n  });\n\n  const controller = await scopedContainer.instance(options.controllerClass);\n  const trace = await scopedContainer.instance(TraceProvider);\n  if (options.initialize && typeof (controller as { initialize?: () => void }).initialize === 'function') {\n    await Promise.resolve(\n      (controller as { initialize: () => void | Promise<void> }).initialize(),\n    );\n  }\n\n  trace.info({\n    source: 'wood.testing.controller-harness',\n    type: 'harness.created',\n    payload: {\n      controllerClass: options.controllerClass.name,\n    },\n  });\n\n  return {\n    controller,\n    bridge: harnessBridge,\n    events,\n    router,\n    container: scopedContainer,\n    navigation,\n    trace,\n    destroy: () => {\n      trace.info({\n        source: 'wood.testing.controller-harness',\n        type: 'harness.destroyed',\n      });\n      if (typeof (controller as { destroy?: () => void }).destroy === 'function') {\n        (controller as { destroy: () => void }).destroy();\n      }\n      events.clear();\n      clearClientContainerForTests();\n      clearClientAppForTests();\n      clearClientNavigationForTests();\n      clearClientWindowControlsForTests();\n      clearClientLoggersForTests();\n\n      if (previousInternalBridge === undefined) {\n        delete globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n      } else {\n        globalObj[WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;\n      }\n\n      if (previousWoodBridge === undefined) {\n        delete globalObj.wood;\n      } else {\n        globalObj.wood = previousWoodBridge;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/testing/create_controller_harness.d.cts

@@ -0,0 +1,37 @@
+import { Navigation } from '../navigation/index.cjs';
+import { TraceProvider } from '../tracing/trace_provider.cjs';
+import { RouterBridgeResult } from './create_router_bridge.cjs';
+import { createTestRouter } from './create_test_router.cjs';
+import '../tracing/trace_hub.cjs';
+import 'rxjs';
+import '@noego/ioc';
+import '../router/wood_router.cjs';
+import '../types/operations.cjs';
+
+interface CreateControllerHarnessOptions<T> {
+    controllerClass: new (...args: any[]) => T;
+    container: any;
+    operations: string | string[];
+    controllersDir: string;
+    middlewareDir?: string;
+    configureContainer?: (container: any) => void | Promise<void>;
+    configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;
+    prepareClient?: (context: {
+        bridge: Record<string, any>;
+        events: RouterBridgeResult['events'];
+        navigation: Navigation;
+        container: any;
+    }) => void | Promise<void>;
+    initialize?: boolean;
+}
+interface ControllerHarnessResult<T> extends RouterBridgeResult {
+    controller: T;
+    container: any;
+    router: ReturnType<typeof createTestRouter>['router'];
+    navigation: Navigation;
+    trace: TraceProvider;
+    destroy: () => void;
+}
+declare function createControllerHarness<T>(options: CreateControllerHarnessOptions<T>): Promise<ControllerHarnessResult<T>>;
+
+export { type ControllerHarnessResult, type CreateControllerHarnessOptions, createControllerHarness };

package/dist/testing/create_controller_harness.d.ts

@@ -0,0 +1,37 @@
+import { Navigation } from '../navigation/index.js';
+import { TraceProvider } from '../tracing/trace_provider.js';
+import { RouterBridgeResult } from './create_router_bridge.js';
+import { createTestRouter } from './create_test_router.js';
+import '../tracing/trace_hub.js';
+import 'rxjs';
+import '@noego/ioc';
+import '../router/wood_router.js';
+import '../types/operations.js';
+
+interface CreateControllerHarnessOptions<T> {
+    controllerClass: new (...args: any[]) => T;
+    container: any;
+    operations: string | string[];
+    controllersDir: string;
+    middlewareDir?: string;
+    configureContainer?: (container: any) => void | Promise<void>;
+    configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;
+    prepareClient?: (context: {
+        bridge: Record<string, any>;
+        events: RouterBridgeResult['events'];
+        navigation: Navigation;
+        container: any;
+    }) => void | Promise<void>;
+    initialize?: boolean;
+}
+interface ControllerHarnessResult<T> extends RouterBridgeResult {
+    controller: T;
+    container: any;
+    router: ReturnType<typeof createTestRouter>['router'];
+    navigation: Navigation;
+    trace: TraceProvider;
+    destroy: () => void;
+}
+declare function createControllerHarness<T>(options: CreateControllerHarnessOptions<T>): Promise<ControllerHarnessResult<T>>;
+
+export { type ControllerHarnessResult, type CreateControllerHarnessOptions, createControllerHarness };