@noego/wood 0.0.1

package/dist/stick/index.js

@@ -0,0 +1,237 @@
+import "./allow_cli.js";
+import * as fs from "fs";
+import * as path from "path";
+import { resolveImageRendererTemplate } from "./template_resolver.js";
+class PlaywrightNotInstalledError extends Error {
+  constructor() {
+    super(
+      "ImageRenderer requires Playwright. Install it with:\n  npm install playwright\n  npx playwright install chromium"
+    );
+    this.name = "PlaywrightNotInstalledError";
+  }
+}
+class BrowserLaunchError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "BrowserLaunchError";
+  }
+}
+class RenderTimeoutError extends Error {
+  constructor(timeoutMs) {
+    super(`Render timed out after ${timeoutMs}ms`);
+    this.name = "RenderTimeoutError";
+  }
+}
+class RenderError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "RenderError";
+  }
+}
+async function loadPlaywright() {
+  try {
+    const playwright = await import("playwright");
+    return playwright;
+  } catch {
+    throw new PlaywrightNotInstalledError();
+  }
+}
+function getContentType(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  const types = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".webp": "image/webp",
+    ".css": "text/css",
+    ".js": "application/javascript",
+    ".json": "application/json",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf"
+  };
+  return types[ext] || "application/octet-stream";
+}
+class ImageRenderer {
+  constructor(browser, staticRenderer, config) {
+    this.browser = browser;
+    this.staticRenderer = staticRenderer;
+    this.config = {
+      outputDir: config.outputDir,
+      width: config.width ?? 1920,
+      height: config.height ?? 1080,
+      deviceScaleFactor: config.deviceScaleFactor ?? 1,
+      format: config.format ?? "png",
+      quality: config.quality ?? 80,
+      waitUntil: config.waitUntil ?? "networkidle",
+      timeoutMs: config.timeoutMs ?? 1e4,
+      template: config.template,
+      assets: config.assets
+    };
+  }
+  /**
+   * Capture a view by dot-path key and save to outputDir
+   */
+  async capture(name, viewKey, options) {
+    const { view, layout, wood } = options ?? {};
+    const html = await this.staticRenderer.renderToPage({
+      viewKey,
+      data: { view, layout },
+      wood,
+      template: this.config.template
+    });
+    return this.captureHtmlInternal(name, html, options);
+  }
+  /**
+   * Capture raw HTML and save to outputDir
+   */
+  async captureHtml(name, html, options) {
+    return this.captureHtmlInternal(name, html, options);
+  }
+  /**
+   * Internal method to capture HTML to image
+   */
+  async captureHtmlInternal(name, html, options) {
+    const width = options?.width ?? this.config.width;
+    const height = options?.height ?? this.config.height;
+    let context;
+    let page;
+    try {
+      context = await this.browser.newContext({
+        viewport: { width, height },
+        deviceScaleFactor: this.config.deviceScaleFactor
+      });
+      page = await context.newPage();
+      const FAKE_BASE_URL = "http://stick-renderer/";
+      await page.route(FAKE_BASE_URL, async (route) => {
+        await route.fulfill({
+          body: html,
+          contentType: "text/html"
+        });
+      });
+      if (this.config.assets) {
+        for (const [urlPath, fsPaths] of Object.entries(this.config.assets)) {
+          await page.route(`**${urlPath}/**`, async (route) => {
+            const url = new URL(route.request().url());
+            const relativePath = url.pathname.replace(urlPath, "");
+            for (const fsPath of fsPaths) {
+              const filePath = path.join(fsPath, relativePath);
+              try {
+                const body = await fs.promises.readFile(filePath);
+                const contentType = getContentType(filePath);
+                await route.fulfill({ body, contentType });
+                return;
+              } catch {
+              }
+            }
+            await route.abort("filenotfound");
+          });
+        }
+      }
+      const waitUntilMapping = {
+        "load": "load",
+        "domcontentloaded": "domcontentloaded",
+        "networkidle": "networkidle"
+      };
+      try {
+        await page.goto(FAKE_BASE_URL, {
+          waitUntil: waitUntilMapping[this.config.waitUntil],
+          timeout: this.config.timeoutMs
+        });
+      } catch (error) {
+        if (error instanceof Error && error.message.includes("timeout")) {
+          throw new RenderTimeoutError(this.config.timeoutMs);
+        }
+        throw new RenderError(
+          "Failed to render HTML content",
+          error instanceof Error ? error : void 0
+        );
+      }
+      if (options?.beforeCapture) {
+        await options.beforeCapture(page);
+      }
+      const screenshotOptions = {
+        type: this.config.format,
+        fullPage: options?.fullPage ?? true
+      };
+      if (this.config.format === "jpeg") {
+        screenshotOptions.quality = this.config.quality;
+      }
+      const screenshot = await page.screenshot(screenshotOptions);
+      const buffer = Buffer.from(screenshot);
+      const filename = `${name}@${width}x${height}.${this.config.format}`;
+      const outputPath = path.join(this.config.outputDir, filename);
+      await fs.promises.mkdir(this.config.outputDir, { recursive: true });
+      await fs.promises.writeFile(outputPath, buffer);
+      return { buffer, path: outputPath };
+    } finally {
+      if (page) {
+        await page.close().catch(() => {
+        });
+      }
+      if (context) {
+        await context.close().catch(() => {
+        });
+      }
+    }
+  }
+  /**
+   * Close browser and clean up resources
+   */
+  async close() {
+    if (this.browser) {
+      await this.browser.close().catch(() => {
+      });
+    }
+  }
+}
+async function createImageRenderer(config) {
+  const resolvedTemplate = resolveImageRendererTemplate({
+    template: config.template,
+    componentDir: config.componentDir
+  });
+  const resolvedConfig = {
+    ...config,
+    template: resolvedTemplate
+  };
+  const playwright = await loadPlaywright();
+  let browser;
+  try {
+    browser = await playwright.chromium.launch({
+      headless: true
+    });
+  } catch (error) {
+    throw new BrowserLaunchError(
+      "Failed to launch Chromium. Ensure it is installed with: npx playwright install chromium",
+      error instanceof Error ? error : void 0
+    );
+  }
+  let staticRenderer;
+  if (resolvedConfig.staticRenderer) {
+    staticRenderer = resolvedConfig.staticRenderer;
+  } else if (resolvedConfig.viewsConfig && resolvedConfig.componentDir) {
+    const { createWoodStaticRenderer } = await import("./static_renderer.js");
+    staticRenderer = createWoodStaticRenderer({
+      viewsConfig: resolvedConfig.viewsConfig,
+      componentDir: resolvedConfig.componentDir
+    });
+  } else {
+    throw new Error(
+      "ImageRendererConfig requires either staticRenderer or both viewsConfig and componentDir"
+    );
+  }
+  return new ImageRenderer(browser, staticRenderer, resolvedConfig);
+}
+export {
+  BrowserLaunchError,
+  ImageRenderer,
+  PlaywrightNotInstalledError,
+  RenderError,
+  RenderTimeoutError,
+  createImageRenderer
+};
+//# sourceMappingURL=index.js.map

package/dist/stick/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stick/index.ts"],"sourcesContent":["import './allow_cli.js';\n// Type-only import — erased at runtime, won't trigger module loading\nimport type { WoodStaticRenderer } from './static_renderer.js';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { resolveImageRendererTemplate } from './template_resolver.js';\n\nexport type { WoodStaticRenderer };\nexport type {\n    WoodStaticRendererConfig,\n    WoodRenderOptions,\n    WoodRenderToPageOptions,\n    WoodRenderResult,\n} from './static_renderer';\n\n// ─────────────────────────────────────────────────────────────\n// Error Classes\n// ─────────────────────────────────────────────────────────────\n\nexport class PlaywrightNotInstalledError extends Error {\n    name = 'PlaywrightNotInstalledError' as const;\n    constructor() {\n        super(\n            'ImageRenderer requires Playwright. Install it with:\\n' +\n            '  npm install playwright\\n' +\n            '  npx playwright install chromium'\n        );\n    }\n}\n\nexport class BrowserLaunchError extends Error {\n    name = 'BrowserLaunchError' as const;\n    constructor(message: string, public cause?: Error) {\n        super(message);\n    }\n}\n\nexport class RenderTimeoutError extends Error {\n    name = 'RenderTimeoutError' as const;\n    constructor(timeoutMs: number) {\n        super(`Render timed out after ${timeoutMs}ms`);\n    }\n}\n\nexport class RenderError extends Error {\n    name = 'RenderError' as const;\n    constructor(message: string, public cause?: Error) {\n        super(message);\n    }\n}\n\n// ─────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────\n\nexport interface ImageRendererConfig {\n    /** Output directory for screenshots */\n    outputDir: string;\n    /** Default width (default: 1920) */\n    width?: number;\n    /** Default height (default: 1080) */\n    height?: number;\n    /** Device scale factor for retina (default: 1) */\n    deviceScaleFactor?: number;\n    /** Image format (default: 'png') */\n    format?: 'png' | 'jpeg';\n    /** JPEG quality 0-100 (default: 80) */\n    quality?: number;\n    /** Wait condition (default: 'networkidle') */\n    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';\n    /** Timeout in ms (default: 10000) */\n    timeoutMs?: number;\n    /** Custom HTML template with {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders */\n    template?: string;\n\n    // Static renderer config (one of these)\n    /** Pre-created WoodStaticRenderer instance */\n    staticRenderer?: WoodStaticRenderer;\n    /** OR: Path to views.yaml */\n    viewsConfig?: string;\n    /**\n     * Component directory (required if viewsConfig provided).\n     * When template is omitted, stick auto-loads <componentDir>/index.html and\n     * inlines <componentDir>/styles.css when present.\n     */\n    componentDir?: string;\n    /** Asset path mappings (e.g., { '/images': ['public/images'] }) */\n    assets?: Record<string, string[]>;\n}\n\nexport interface CaptureOptions {\n    /** View component data */\n    view?: any;\n    /** Layout data (one object per layout) */\n    layout?: any[];\n    /** Wood bridge object passed as a prop to layouts and views */\n    wood?: any;\n    /** Override width */\n    width?: number;\n    /** Override height */\n    height?: number;\n    /** Capture full page (default: true) */\n    fullPage?: boolean;\n    /** Callback executed after page load, before screenshot. Receives the Playwright page object. */\n    beforeCapture?: (page: any) => Promise<void>;\n}\n\nexport interface CaptureHtmlOptions {\n    /** Override width */\n    width?: number;\n    /** Override height */\n    height?: number;\n    /** Capture full page (default: true) */\n    fullPage?: boolean;\n    /** Callback executed after page load, before screenshot. Receives the Playwright page object. */\n    beforeCapture?: (page: any) => Promise<void>;\n}\n\ninterface CaptureResult {\n    /** Raw image buffer */\n    buffer: Buffer;\n    /** Path where image was saved */\n    path: string;\n}\n\n// ─────────────────────────────────────────────────────────────\n// Playwright Loader\n// ─────────────────────────────────────────────────────────────\n\ntype PlaywrightModule = typeof import('playwright');\n\nasync function loadPlaywright(): Promise<PlaywrightModule> {\n    try {\n        const playwright = await import('playwright');\n        return playwright;\n    } catch {\n        throw new PlaywrightNotInstalledError();\n    }\n}\n\n// ─────────────────────────────────────────────────────────────\n// Content Type Helper\n// ─────────────────────────────────────────────────────────────\n\nfunction getContentType(filePath: string): string {\n    const ext = path.extname(filePath).toLowerCase();\n    const types: Record<string, string> = {\n        '.png': 'image/png',\n        '.jpg': 'image/jpeg',\n        '.jpeg': 'image/jpeg',\n        '.gif': 'image/gif',\n        '.svg': 'image/svg+xml',\n        '.webp': 'image/webp',\n        '.css': 'text/css',\n        '.js': 'application/javascript',\n        '.json': 'application/json',\n        '.woff': 'font/woff',\n        '.woff2': 'font/woff2',\n        '.ttf': 'font/ttf',\n    };\n    return types[ext] || 'application/octet-stream';\n}\n\n// ─────────────────────────────────────────────────────────────\n// ImageRenderer Class\n// ─────────────────────────────────────────────────────────────\n\nexport class ImageRenderer {\n    private browser: any;\n    private staticRenderer: WoodStaticRenderer;\n    private config: Required<Omit<ImageRendererConfig, 'staticRenderer' | 'viewsConfig' | 'componentDir' | 'template' | 'assets'>> & {\n        outputDir: string;\n        template?: string;\n        assets?: Record<string, string[]>;\n    };\n\n    constructor(\n        browser: any,\n        staticRenderer: WoodStaticRenderer,\n        config: ImageRendererConfig\n    ) {\n        this.browser = browser;\n        this.staticRenderer = staticRenderer;\n        this.config = {\n            outputDir: config.outputDir,\n            width: config.width ?? 1920,\n            height: config.height ?? 1080,\n            deviceScaleFactor: config.deviceScaleFactor ?? 1,\n            format: config.format ?? 'png',\n            quality: config.quality ?? 80,\n            waitUntil: config.waitUntil ?? 'networkidle',\n            timeoutMs: config.timeoutMs ?? 10000,\n            template: config.template,\n            assets: config.assets,\n        };\n    }\n\n    /**\n     * Capture a view by dot-path key and save to outputDir\n     */\n    async capture(\n        name: string,\n        viewKey: string,\n        options?: CaptureOptions\n    ): Promise<CaptureResult> {\n        const { view, layout, wood } = options ?? {};\n        const html = await this.staticRenderer.renderToPage({\n            viewKey,\n            data: { view, layout },\n            wood,\n            template: this.config.template,\n        });\n\n        return this.captureHtmlInternal(name, html, options);\n    }\n\n    /**\n     * Capture raw HTML and save to outputDir\n     */\n    async captureHtml(\n        name: string,\n        html: string,\n        options?: CaptureHtmlOptions\n    ): Promise<CaptureResult> {\n        return this.captureHtmlInternal(name, html, options);\n    }\n\n    /**\n     * Internal method to capture HTML to image\n     */\n    private async captureHtmlInternal(\n        name: string,\n        html: string,\n        options?: CaptureHtmlOptions\n    ): Promise<CaptureResult> {\n        const width = options?.width ?? this.config.width;\n        const height = options?.height ?? this.config.height;\n\n        let context: any;\n        let page: any;\n\n        try {\n            context = await this.browser.newContext({\n                viewport: { width, height },\n                deviceScaleFactor: this.config.deviceScaleFactor,\n            });\n\n            page = await context.newPage();\n\n            // Route Interception Strategy:\n            // We use page.goto() with a fake URL instead of page.setContent() because\n            // setContent() has no base URL, so relative paths can't resolve.\n            const FAKE_BASE_URL = 'http://stick-renderer/';\n\n            await page.route(FAKE_BASE_URL, async (route: any) => {\n                await route.fulfill({\n                    body: html,\n                    contentType: 'text/html',\n                });\n            });\n\n            // Asset route interception\n            if (this.config.assets) {\n                for (const [urlPath, fsPaths] of Object.entries(this.config.assets)) {\n                    await page.route(`**${urlPath}/**`, async (route: any) => {\n                        const url = new URL(route.request().url());\n                        const relativePath = url.pathname.replace(urlPath, '');\n\n                        for (const fsPath of fsPaths) {\n                            const filePath = path.join(fsPath, relativePath);\n                            try {\n                                const body = await fs.promises.readFile(filePath);\n                                const contentType = getContentType(filePath);\n                                await route.fulfill({ body, contentType });\n                                return;\n                            } catch {\n                                // File not found in this path, try the next one\n                            }\n                        }\n\n                        await route.abort('filenotfound');\n                    });\n                }\n            }\n\n            const waitUntilMapping = {\n                'load': 'load',\n                'domcontentloaded': 'domcontentloaded',\n                'networkidle': 'networkidle',\n            } as const;\n\n            try {\n                await page.goto(FAKE_BASE_URL, {\n                    waitUntil: waitUntilMapping[this.config.waitUntil],\n                    timeout: this.config.timeoutMs,\n                });\n            } catch (error) {\n                if (error instanceof Error && error.message.includes('timeout')) {\n                    throw new RenderTimeoutError(this.config.timeoutMs);\n                }\n                throw new RenderError(\n                    'Failed to render HTML content',\n                    error instanceof Error ? error : undefined\n                );\n            }\n\n            if (options?.beforeCapture) {\n                await options.beforeCapture(page);\n            }\n\n            const screenshotOptions: {\n                type: 'png' | 'jpeg';\n                quality?: number;\n                fullPage: boolean;\n            } = {\n                type: this.config.format,\n                fullPage: options?.fullPage ?? true,\n            };\n\n            if (this.config.format === 'jpeg') {\n                screenshotOptions.quality = this.config.quality;\n            }\n\n            const screenshot = await page.screenshot(screenshotOptions);\n            const buffer = Buffer.from(screenshot);\n\n            const filename = `${name}@${width}x${height}.${this.config.format}`;\n            const outputPath = path.join(this.config.outputDir, filename);\n\n            await fs.promises.mkdir(this.config.outputDir, { recursive: true });\n            await fs.promises.writeFile(outputPath, buffer);\n\n            return { buffer, path: outputPath };\n\n        } finally {\n            if (page) {\n                await page.close().catch(() => {});\n            }\n            if (context) {\n                await context.close().catch(() => {});\n            }\n        }\n    }\n\n    /**\n     * Close browser and clean up resources\n     */\n    async close(): Promise<void> {\n        if (this.browser) {\n            await this.browser.close().catch(() => {});\n        }\n    }\n}\n\n// ─────────────────────────────────────────────────────────────\n// Factory Function\n// ─────────────────────────────────────────────────────────────\n\nexport async function createImageRenderer(\n    config: ImageRendererConfig\n): Promise<ImageRenderer> {\n    const resolvedTemplate = resolveImageRendererTemplate({\n        template: config.template,\n        componentDir: config.componentDir,\n    });\n    const resolvedConfig: ImageRendererConfig = {\n        ...config,\n        template: resolvedTemplate,\n    };\n\n    const playwright = await loadPlaywright();\n\n    let browser: any;\n    try {\n        browser = await playwright.chromium.launch({\n            headless: true,\n        });\n    } catch (error) {\n        throw new BrowserLaunchError(\n            'Failed to launch Chromium. Ensure it is installed with: npx playwright install chromium',\n            error instanceof Error ? error : undefined\n        );\n    }\n\n    let staticRenderer: WoodStaticRenderer;\n    if (resolvedConfig.staticRenderer) {\n        staticRenderer = resolvedConfig.staticRenderer;\n    } else if (resolvedConfig.viewsConfig && resolvedConfig.componentDir) {\n        const { createWoodStaticRenderer } = await import('./static_renderer.js');\n        staticRenderer = createWoodStaticRenderer({\n            viewsConfig: resolvedConfig.viewsConfig,\n            componentDir: resolvedConfig.componentDir,\n        });\n    } else {\n        throw new Error(\n            'ImageRendererConfig requires either staticRenderer or both viewsConfig and componentDir'\n        );\n    }\n\n    return new ImageRenderer(browser, staticRenderer, resolvedConfig);\n}\n"],"mappings":"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","names":[]}

package/dist/stick/static_renderer.cjs

@@ -0,0 +1,144 @@
+"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 static_renderer_exports = {};
+__export(static_renderer_exports, {
+  WoodStaticRenderer: () => WoodStaticRenderer,
+  createWoodStaticRenderer: () => createWoodStaticRenderer
+});
+module.exports = __toCommonJS(static_renderer_exports);
+var import_url = require("url");
+var import_path = require("path");
+var import_views_parser = require("../parser/views_parser.cjs");
+async function loadWoodRecursiveRenderComponent() {
+  const candidates = [
+    "./WoodRecursiveRender.svelte",
+    "../../src/stick/WoodRecursiveRender.svelte"
+  ];
+  let lastNotFoundError;
+  for (const candidate of candidates) {
+    try {
+      return await import(
+        /* @vite-ignore */
+        candidate
+      );
+    } catch (error) {
+      const code = error?.code;
+      const message = error instanceof Error ? error.message : String(error);
+      const isNotFound = code === "ERR_MODULE_NOT_FOUND" || message.includes("Cannot find module");
+      if (!isNotFound) {
+        throw error;
+      }
+      lastNotFoundError = error;
+    }
+  }
+  throw lastNotFoundError ?? new Error("Failed to load WoodRecursiveRender.svelte.");
+}
+class WoodStaticRenderer {
+  constructor(views, componentDir) {
+    this.views = views;
+    this.componentDir = componentDir;
+  }
+  /** Find a ViewDef by dot-path key (e.g., 'chat.main') */
+  findView(viewKey) {
+    const segments = viewKey.split(".");
+    const windowName = segments[0];
+    const pageName = segments.slice(1).join(".");
+    const found = this.views.find(
+      (v) => v.windowName === windowName && v.pageName === pageName
+    );
+    if (!found) {
+      const available = this.views.map((v) => `${v.windowName}.${v.pageName}`).join(", ");
+      throw new Error(
+        `No view found for key "${viewKey}". Available views: ${available}`
+      );
+    }
+    return found;
+  }
+  /** Dynamically import a Svelte component via the ESM loader */
+  async loadComponent(relativePath) {
+    const absPath = (0, import_path.resolve)(this.componentDir, relativePath);
+    const fileUrl = (0, import_url.pathToFileURL)(absPath).href;
+    const mod = await import(fileUrl);
+    return mod.default;
+  }
+  async render(options) {
+    const { viewKey, data = {}, wood } = options;
+    const viewDef = this.findView(viewKey);
+    const view = await this.loadComponent(viewDef.viewPath);
+    const layouts = [];
+    for (const layoutPath of viewDef.layouts) {
+      layouts.push(await this.loadComponent(layoutPath));
+    }
+    const serverData = {
+      layout: data.layout || [],
+      view: data.view || {}
+    };
+    const svelteServer = "svelte/server";
+    const { render } = await import(
+      /* @vite-ignore */
+      svelteServer
+    );
+    const WoodRecursiveRenderMod = await loadWoodRecursiveRenderComponent();
+    const WoodRecursiveRender = WoodRecursiveRenderMod.default;
+    const result = render(WoodRecursiveRender, {
+      props: {
+        layouts,
+        view,
+        data: serverData,
+        wood
+      }
+    });
+    return {
+      html: result.html,
+      head: result.head,
+      css: result.css?.code || "",
+      viewDef
+    };
+  }
+  /**
+   * Render to a full HTML document.
+   * Uses default template or custom template with {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders.
+   */
+  async renderToPage(options) {
+    const { html, head, css } = await this.render(options);
+    const defaultTemplate = `<!DOCTYPE html>
+<html>
+<head>
+    {{{HEAD}}}
+    <style>{{{CSS}}}</style>
+</head>
+<body>
+    <div id="app">{{{APP}}}</div>
+</body>
+</html>`;
+    const template = options.template || defaultTemplate;
+    return template.replace("{{{HEAD}}}", head).replace("{{{CSS}}}", css).replace("{{{APP}}}", html);
+  }
+}
+function createWoodStaticRenderer(config) {
+  const views = (0, import_views_parser.parseViewsFile)(config.viewsConfig);
+  const componentDir = (0, import_path.resolve)(config.componentDir);
+  return new WoodStaticRenderer(views, componentDir);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WoodStaticRenderer,
+  createWoodStaticRenderer
+});
+//# sourceMappingURL=static_renderer.cjs.map

package/dist/stick/static_renderer.cjs.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.cjs';\nimport type { ViewDef } from '../types/index.cjs';\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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAA8B;AAC9B,kBAAwB;AACxB,0BAA+B;AA0C/B,eAAe,mCAAiD;AAC5D,QAAM,aAAa;AAAA,IACf;AAAA,IACA;AAAA,EACJ;AAEA,MAAI;AACJ,aAAW,aAAa,YAAY;AAChC,QAAI;AACA,aAAO,MAAM;AAAA;AAAA,QAA0B;AAAA;AAAA,IAC3C,SAAS,OAAO;AACZ,YAAM,OAAQ,OAA6B;AAC3C,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAM,aAAa,SAAS,0BAA0B,QAAQ,SAAS,oBAAoB;AAC3F,UAAI,CAAC,YAAY;AACb,cAAM;AAAA,MACV;AACA,0BAAoB;AAAA,IACxB;AAAA,EACJ;AAEA,QAAM,qBAAqB,IAAI,MAAM,4CAA4C;AACrF;AAMO,MAAM,mBAAmB;AAAA,EAI5B,YAAY,OAAkB,cAAsB;AAChD,SAAK,QAAQ;AACb,SAAK,eAAe;AAAA,EACxB;AAAA;AAAA,EAGQ,SAAS,SAA0B;AACvC,UAAM,WAAW,QAAQ,MAAM,GAAG;AAClC,UAAM,aAAa,SAAS,CAAC;AAC7B,UAAM,WAAW,SAAS,MAAM,CAAC,EAAE,KAAK,GAAG;AAE3C,UAAM,QAAQ,KAAK,MAAM;AAAA,MACrB,OAAK,EAAE,eAAe,cAAc,EAAE,aAAa;AAAA,IACvD;AACA,QAAI,CAAC,OAAO;AACR,YAAM,YAAY,KAAK,MAAM,IAAI,OAAK,GAAG,EAAE,UAAU,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,IAAI;AAChF,YAAM,IAAI;AAAA,QACN,0BAA0B,OAAO,uBAAuB,SAAS;AAAA,MACrE;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA;AAAA,EAGA,MAAc,cAAc,cAAoC;AAC5D,UAAM,cAAU,qBAAQ,KAAK,cAAc,YAAY;AACvD,UAAM,cAAU,0BAAc,OAAO,EAAE;AACvC,UAAM,MAAM,MAAM,OAAO;AACzB,WAAO,IAAI;AAAA,EACf;AAAA,EAEA,MAAM,OAAO,SAAuD;AAChE,UAAM,EAAE,SAAS,OAAO,CAAC,GAAG,KAAK,IAAI;AAErC,UAAM,UAAU,KAAK,SAAS,OAAO;AAGrC,UAAM,OAAO,MAAM,KAAK,cAAc,QAAQ,QAAQ;AAGtD,UAAM,UAAU,CAAC;AACjB,eAAW,cAAc,QAAQ,SAAS;AACtC,cAAQ,KAAK,MAAM,KAAK,cAAc,UAAU,CAAC;AAAA,IACrD;AAGA,UAAM,aAAa;AAAA,MACf,QAAQ,KAAK,UAAU,CAAC;AAAA,MACxB,MAAM,KAAK,QAAQ,CAAC;AAAA,IACxB;AAIA,UAAM,eAAe;AACrB,UAAM,EAAE,OAAO,IAAI,MAAM;AAAA;AAAA,MAA0B;AAAA;AACnD,UAAM,yBAAyB,MAAM,iCAAiC;AACtE,UAAM,sBAAsB,uBAAuB;AAEnD,UAAM,SAAS,OAAO,qBAAqB;AAAA,MACvC,OAAO;AAAA,QACH;AAAA,QACA;AAAA,QACA,MAAM;AAAA,QACN;AAAA,MACJ;AAAA,IACJ,CAAC;AAED,WAAO;AAAA,MACH,MAAM,OAAO;AAAA,MACb,MAAM,OAAO;AAAA,MACb,KAAM,OAAe,KAAK,QAAQ;AAAA,MAClC;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,aAAa,SAAmD;AAClE,UAAM,EAAE,MAAM,MAAM,IAAI,IAAI,MAAM,KAAK,OAAO,OAAO;AAErD,UAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWxB,UAAM,WAAW,QAAQ,YAAY;AAErC,WAAO,SACF,QAAQ,cAAc,IAAI,EAC1B,QAAQ,aAAa,GAAG,EACxB,QAAQ,aAAa,IAAI;AAAA,EAClC;AACJ;AAMO,SAAS,yBACZ,QACkB;AAClB,QAAM,YAAQ,oCAAe,OAAO,WAAW;AAC/C,QAAM,mBAAe,qBAAQ,OAAO,YAAY;AAChD,SAAO,IAAI,mBAAmB,OAAO,YAAY;AACrD;","names":[]}

package/dist/stick/static_renderer.d.cts

@@ -0,0 +1,51 @@
+import { ViewDef } from '../types/views.cjs';
+
+interface WoodStaticRendererConfig {
+    /** Path to views.yaml (e.g., './ui/views.yaml') */
+    viewsConfig: string;
+    /** Base directory for components (e.g., './ui') */
+    componentDir: string;
+}
+interface WoodRenderOptions {
+    /** Dot-path view key (e.g., 'chat.main') */
+    viewKey: string;
+    /** Mock data for layouts and view */
+    data?: {
+        layout?: any[];
+        view?: any;
+    };
+    /** Wood bridge object passed as a prop to layouts and views */
+    wood?: any;
+}
+interface WoodRenderToPageOptions extends WoodRenderOptions {
+    /** Custom HTML template. Use {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders */
+    template?: string;
+}
+interface WoodRenderResult {
+    /** Rendered component HTML */
+    html: string;
+    /** Content from <svelte:head> tags */
+    head: string;
+    /** Component CSS */
+    css: string;
+    /** The matched view definition */
+    viewDef: ViewDef;
+}
+declare class WoodStaticRenderer {
+    private views;
+    private componentDir;
+    constructor(views: ViewDef[], componentDir: string);
+    /** Find a ViewDef by dot-path key (e.g., 'chat.main') */
+    private findView;
+    /** Dynamically import a Svelte component via the ESM loader */
+    private loadComponent;
+    render(options: WoodRenderOptions): Promise<WoodRenderResult>;
+    /**
+     * Render to a full HTML document.
+     * Uses default template or custom template with {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders.
+     */
+    renderToPage(options: WoodRenderToPageOptions): Promise<string>;
+}
+declare function createWoodStaticRenderer(config: WoodStaticRendererConfig): WoodStaticRenderer;
+
+export { type WoodRenderOptions, type WoodRenderResult, type WoodRenderToPageOptions, WoodStaticRenderer, type WoodStaticRendererConfig, createWoodStaticRenderer };

package/dist/stick/static_renderer.d.ts

@@ -0,0 +1,51 @@
+import { ViewDef } from '../types/views.js';
+
+interface WoodStaticRendererConfig {
+    /** Path to views.yaml (e.g., './ui/views.yaml') */
+    viewsConfig: string;
+    /** Base directory for components (e.g., './ui') */
+    componentDir: string;
+}
+interface WoodRenderOptions {
+    /** Dot-path view key (e.g., 'chat.main') */
+    viewKey: string;
+    /** Mock data for layouts and view */
+    data?: {
+        layout?: any[];
+        view?: any;
+    };
+    /** Wood bridge object passed as a prop to layouts and views */
+    wood?: any;
+}
+interface WoodRenderToPageOptions extends WoodRenderOptions {
+    /** Custom HTML template. Use {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders */
+    template?: string;
+}
+interface WoodRenderResult {
+    /** Rendered component HTML */
+    html: string;
+    /** Content from <svelte:head> tags */
+    head: string;
+    /** Component CSS */
+    css: string;
+    /** The matched view definition */
+    viewDef: ViewDef;
+}
+declare class WoodStaticRenderer {
+    private views;
+    private componentDir;
+    constructor(views: ViewDef[], componentDir: string);
+    /** Find a ViewDef by dot-path key (e.g., 'chat.main') */
+    private findView;
+    /** Dynamically import a Svelte component via the ESM loader */
+    private loadComponent;
+    render(options: WoodRenderOptions): Promise<WoodRenderResult>;
+    /**
+     * Render to a full HTML document.
+     * Uses default template or custom template with {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders.
+     */
+    renderToPage(options: WoodRenderToPageOptions): Promise<string>;
+}
+declare function createWoodStaticRenderer(config: WoodStaticRendererConfig): WoodStaticRenderer;
+
+export { type WoodRenderOptions, type WoodRenderResult, type WoodRenderToPageOptions, WoodStaticRenderer, type WoodStaticRendererConfig, createWoodStaticRenderer };

package/dist/stick/static_renderer.js

@@ -0,0 +1,119 @@
+import { pathToFileURL } from "url";
+import { resolve } from "path";
+import { parseViewsFile } from "../parser/views_parser.js";
+async function loadWoodRecursiveRenderComponent() {
+  const candidates = [
+    "./WoodRecursiveRender.svelte",
+    "../../src/stick/WoodRecursiveRender.svelte"
+  ];
+  let lastNotFoundError;
+  for (const candidate of candidates) {
+    try {
+      return await import(
+        /* @vite-ignore */
+        candidate
+      );
+    } catch (error) {
+      const code = error?.code;
+      const message = error instanceof Error ? error.message : String(error);
+      const isNotFound = code === "ERR_MODULE_NOT_FOUND" || message.includes("Cannot find module");
+      if (!isNotFound) {
+        throw error;
+      }
+      lastNotFoundError = error;
+    }
+  }
+  throw lastNotFoundError ?? new Error("Failed to load WoodRecursiveRender.svelte.");
+}
+class WoodStaticRenderer {
+  constructor(views, componentDir) {
+    this.views = views;
+    this.componentDir = componentDir;
+  }
+  /** Find a ViewDef by dot-path key (e.g., 'chat.main') */
+  findView(viewKey) {
+    const segments = viewKey.split(".");
+    const windowName = segments[0];
+    const pageName = segments.slice(1).join(".");
+    const found = this.views.find(
+      (v) => v.windowName === windowName && v.pageName === pageName
+    );
+    if (!found) {
+      const available = this.views.map((v) => `${v.windowName}.${v.pageName}`).join(", ");
+      throw new Error(
+        `No view found for key "${viewKey}". Available views: ${available}`
+      );
+    }
+    return found;
+  }
+  /** Dynamically import a Svelte component via the ESM loader */
+  async loadComponent(relativePath) {
+    const absPath = resolve(this.componentDir, relativePath);
+    const fileUrl = pathToFileURL(absPath).href;
+    const mod = await import(fileUrl);
+    return mod.default;
+  }
+  async render(options) {
+    const { viewKey, data = {}, wood } = options;
+    const viewDef = this.findView(viewKey);
+    const view = await this.loadComponent(viewDef.viewPath);
+    const layouts = [];
+    for (const layoutPath of viewDef.layouts) {
+      layouts.push(await this.loadComponent(layoutPath));
+    }
+    const serverData = {
+      layout: data.layout || [],
+      view: data.view || {}
+    };
+    const svelteServer = "svelte/server";
+    const { render } = await import(
+      /* @vite-ignore */
+      svelteServer
+    );
+    const WoodRecursiveRenderMod = await loadWoodRecursiveRenderComponent();
+    const WoodRecursiveRender = WoodRecursiveRenderMod.default;
+    const result = render(WoodRecursiveRender, {
+      props: {
+        layouts,
+        view,
+        data: serverData,
+        wood
+      }
+    });
+    return {
+      html: result.html,
+      head: result.head,
+      css: result.css?.code || "",
+      viewDef
+    };
+  }
+  /**
+   * Render to a full HTML document.
+   * Uses default template or custom template with {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders.
+   */
+  async renderToPage(options) {
+    const { html, head, css } = await this.render(options);
+    const defaultTemplate = `<!DOCTYPE html>
+<html>
+<head>
+    {{{HEAD}}}
+    <style>{{{CSS}}}</style>
+</head>
+<body>
+    <div id="app">{{{APP}}}</div>
+</body>
+</html>`;
+    const template = options.template || defaultTemplate;
+    return template.replace("{{{HEAD}}}", head).replace("{{{CSS}}}", css).replace("{{{APP}}}", html);
+  }
+}
+function createWoodStaticRenderer(config) {
+  const views = parseViewsFile(config.viewsConfig);
+  const componentDir = resolve(config.componentDir);
+  return new WoodStaticRenderer(views, componentDir);
+}
+export {
+  WoodStaticRenderer,
+  createWoodStaticRenderer
+};
+//# sourceMappingURL=static_renderer.js.map