@westopp/windo 0.1.0

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/index.ts","../src/plugin/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// The package bin. `windo [command] [root] [options]`:\n//   dev      boot a Vite dev server wired with the windo plugin (default)\n//   build    emit a static canvas to windo-static/ (drop on any static host)\n//   preview  serve a built canvas locally\n\nimport { parseArgs } from 'node:util'\nimport pc from 'picocolors'\nimport { build, createServer, preview } from 'vite'\nimport { windoPlugin } from '../plugin'\n\nconst VERSION = '0.1.0'\n\nconst USAGE = `\n${pc.bold('windo')} ${pc.dim(`v${VERSION}`)} — zero-infra component canvas\n\n${pc.bold('Usage')}\n  windo [command] [root] [options]\n\n${pc.bold('Commands')}\n  dev                Start the dev server (default)\n  build              Emit a static canvas to windo-static/\n  preview            Serve a built canvas locally\n\n${pc.bold('Options')}\n  -p, --port <n>     Port to listen on (dev, preview)\n      --host [host]  Expose on the network (dev, preview)\n  -o, --open         Open the workbench in the browser (dev, preview)\n  -c, --config <p>   Path to windo.config.ts (dev, build)\n  -d, --outDir <p>   Output directory (build, preview) ${pc.dim('[windo-static]')}\n  -b, --base <p>     Public base path for the build ${pc.dim('[./]')}\n  -h, --help         Show this help\n`\n\nconst COMMANDS = new Set(['dev', 'build', 'preview'])\n\nasync function main() {\n  const argv = process.argv.slice(2)\n  const first = argv[0]\n\n  if (first === '-h' || first === '--help') {\n    console.log(USAGE)\n    return\n  }\n\n  // A leading token that names a command selects it; no token (or a flag)\n  // defaults to `dev`. Any other leading token is a mistyped command — fail\n  // loudly rather than silently treating it as a dev root.\n  let command = 'dev'\n  let rest = argv\n  if (first !== undefined && !first.startsWith('-')) {\n    if (!COMMANDS.has(first)) {\n      console.error(`${pc.red(`windo: unknown command \"${first}\".`)}\\n${USAGE}`)\n      process.exitCode = 1\n      return\n    }\n    command = first\n    rest = argv.slice(1)\n  }\n\n  const { values, positionals } = parseArgs({\n    args: rest,\n    allowPositionals: true,\n    options: {\n      port: { type: 'string', short: 'p' },\n      host: { type: 'string' },\n      open: { type: 'boolean', short: 'o' },\n      config: { type: 'string', short: 'c' },\n      outDir: { type: 'string', short: 'd' },\n      base: { type: 'string', short: 'b' },\n      help: { type: 'boolean', short: 'h' },\n    },\n  })\n\n  if (values.help) {\n    console.log(USAGE)\n    return\n  }\n\n  // Each command accepts only its own flags; reject the rest so a misplaced\n  // `windo build --port` fails instead of silently doing nothing.\n  const ALLOWED: Record<string, Set<string>> = {\n    dev: new Set(['port', 'host', 'open', 'config', 'help']),\n    build: new Set(['config', 'outDir', 'base', 'help']),\n    preview: new Set(['port', 'host', 'open', 'outDir', 'help']),\n  }\n  const stray = Object.keys(values).filter(k => !ALLOWED[command].has(k))\n  if (stray.length > 0) {\n    console.error(`${pc.red(`windo ${command}: unsupported option${stray.length > 1 ? 's' : ''} ${stray.map(s => `--${s}`).join(', ')}.`)}\\n${USAGE}`)\n    process.exitCode = 1\n    return\n  }\n\n  const root = positionals[0] ? String(positionals[0]) : process.cwd()\n  const config = values.config\n\n  if (command === 'build') {\n    const outDir = values.outDir ?? 'windo-static'\n    const base = values.base ?? './'\n    console.log()\n    console.log(`  ${pc.bold(pc.cyan('windo'))} ${pc.dim(`v${VERSION}`)} ${pc.dim('build')}`)\n    console.log()\n    await build({\n      root,\n      base,\n      // Self-contained: don't merge an unrelated vite.config from the project.\n      configFile: false,\n      plugins: [windoPlugin({ config })],\n      build: { outDir, emptyOutDir: true },\n    })\n    console.log()\n    console.log(`  ${pc.green('✓')} canvas written to ${pc.cyan(outDir)}`)\n    console.log(`  ${pc.dim('preview it with')} ${pc.bold('windo preview')}${outDir === 'windo-static' ? '' : ` -d ${outDir}`}`)\n    console.log()\n    return\n  }\n\n  if (command === 'preview') {\n    const outDir = values.outDir ?? 'windo-static'\n    const port = values.port === undefined ? undefined : Number(values.port)\n    const host = values.host === '' ? true : values.host\n    const open = values.open ?? false\n    const server = await preview({\n      root,\n      configFile: false,\n      build: { outDir },\n      preview: { port, host, open },\n    })\n    console.log()\n    console.log(`  ${pc.bold(pc.cyan('windo'))} ${pc.dim(`v${VERSION}`)} ${pc.dim('preview')}`)\n    console.log()\n    server.printUrls()\n    return\n  }\n\n  // dev\n  const port = values.port === undefined ? undefined : Number(values.port)\n  const host = values.host === '' ? true : values.host\n  const open = values.open ?? false\n\n  const server = await createServer({\n    root,\n    plugins: [windoPlugin({ config })],\n    server: { port, host, open },\n  })\n\n  await server.listen()\n\n  console.log()\n  console.log(`  ${pc.bold(pc.cyan('windo'))} ${pc.dim(`v${VERSION}`)}`)\n  console.log()\n  server.printUrls()\n}\n\nmain().catch(err => {\n  process.exitCode = 1\n  console.error(pc.red('windo: command failed.'))\n  console.error(err)\n})\n","// Vite plugin (node side). Pairs `@vitejs/plugin-react` with the windo plugin:\n// serves the chrome + iframe HTML documents ourselves (appType custom) and\n// exposes a `virtual:windo-registry` module that re-exports the user config and\n// glob-imports every `*.windo.tsx` file.\n\nimport { existsSync } from 'node:fs'\nimport { isAbsolute, resolve as resolvePath } from 'node:path'\nimport reactPlugin from '@vitejs/plugin-react'\nimport type { Plugin, PluginOption, UserConfig, ViteDevServer } from 'vite'\n\nexport interface WindoPluginOptions {\n  include?: string | string[]\n  config?: string\n  root?: string\n}\n\nconst VIRTUAL_ID = 'virtual:windo-registry'\nconst RESOLVED_VIRTUAL_ID = `\\0${VIRTUAL_ID}`\n\nconst CONFIG_CANDIDATES = ['windo.config.ts', 'windo.config.tsx', 'windo.config.mts', 'windo.config.js', 'windo.config.mjs'] as const\n\nfunction findConfig(root: string, configOpt?: string): string | null {\n  if (configOpt) return isAbsolute(configOpt) ? configOpt : resolvePath(root, configOpt)\n  for (const candidate of CONFIG_CANDIDATES) {\n    const full = resolvePath(root, candidate)\n    if (existsSync(full)) return full\n  }\n  return null\n}\n\nfunction toGlob(include?: string | string[]): string {\n  const first = Array.isArray(include) ? include[0] : include\n  const pattern = first ?? '**/*.windo.tsx'\n  return pattern.startsWith('/') ? pattern : `/${pattern}`\n}\n\nconst CHROME_HTML = `<!doctype html>\n<html data-theme=\"light\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n    <title>windo</title>\n  </head>\n  <body>\n    <div id=\"root\"></div>\n    <script type=\"module\">\n      import('@westopp/windo/client')\n    </script>\n  </body>\n</html>\n`\n\nconst IFRAME_HTML = `<!doctype html>\n<html>\n  <head>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n  </head>\n  <body style=\"background: transparent\">\n    <div id=\"root\"></div>\n    <script type=\"module\">\n      import('@westopp/windo/preview')\n    </script>\n  </body>\n</html>\n`\n\n// Absolute ids for the two HTML entry documents, relative to the project root.\n// They are virtual — the files need not exist on disk; the plugin's `load`\n// returns their contents. Keeping them rooted at `<root>/index.html` and\n// `<root>/__windo/iframe.html` makes `vite build` emit them at the matching\n// paths in the output directory (Vite derives an HTML asset's output path from\n// the input id's path relative to root).\nfunction htmlIds(root: string) {\n  return {\n    index: resolvePath(root, 'index.html'),\n    iframe: resolvePath(root, '__windo/iframe.html'),\n  }\n}\n\nexport function windo(options: WindoPluginOptions = {}): PluginOption[] {\n  let resolvedRoot = process.cwd()\n  let ids = htmlIds(resolvedRoot)\n\n  const registryModule = (): string => {\n    const root = options.root ?? resolvedRoot ?? process.cwd()\n    const configPath = findConfig(root, options.config)\n    const glob = toGlob(options.include)\n    const importPath = configPath ? JSON.stringify(configPath) : 'null'\n    const globLiteral = JSON.stringify(glob)\n    return [\n      `import * as __cfg from ${importPath}`,\n      'const config = __cfg.config ?? (__cfg.default && __cfg.default.config) ?? __cfg.default',\n      'export { config }',\n      `export const modules = import.meta.glob(${globLiteral})`,\n      '',\n    ].join('\\n')\n  }\n\n  const plugin: Plugin = {\n    name: 'windo',\n    // `pre` so our resolveId/load claim the virtual registry and the two HTML\n    // entries before Vite's filesystem fallback tries (and fails) to read them.\n    enforce: 'pre',\n\n    config(userConfig: UserConfig, { command, isPreview }) {\n      const root = resolvePath(options.root ?? userConfig.root ?? '.')\n      ids = htmlIds(root)\n      const base: UserConfig = {\n        // Dev serves the chrome + iframe HTML from `configureServer`, so it runs\n        // headless (`custom`). Build and preview want the normal SPA behaviour so\n        // `/` resolves to the emitted index.html.\n        appType: command === 'serve' && !isPreview ? 'custom' : 'spa',\n        define: {\n          __WINDO_IFRAME_SRC__: JSON.stringify(command === 'build' ? './__windo/iframe.html' : './__windo/iframe'),\n        },\n        resolve: {\n          dedupe: ['react', 'react-dom'],\n        },\n        optimizeDeps: {\n          // Pre-bundle every React entrypoint in one pass so React's identity is\n          // fixed up front. If `react-dom/client` (the preview renderer) is\n          // discovered late, Vite re-optimizes and can split React across two\n          // instances — fine until a component calls a hook, then \"invalid hook\n          // call\". Keeping them all here prevents that re-optimize.\n          include: ['react', 'react-dom', 'react-dom/client', 'react/jsx-runtime', 'react/jsx-dev-runtime'],\n        },\n      }\n\n      // Wire the chrome + iframe as build inputs unless the user supplied their\n      // own. Both are emitted as static HTML the canvas can be hosted from.\n      if (command === 'build' && !userConfig.build?.rollupOptions?.input) {\n        base.build = { rollupOptions: { input: { index: ids.index, iframe: ids.iframe } } }\n      }\n      return base\n    },\n\n    configResolved(resolved) {\n      resolvedRoot = resolved.root\n      ids = htmlIds(resolvedRoot)\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_ID) return RESOLVED_VIRTUAL_ID\n      if (id === ids.index || id === ids.iframe) return id\n      return null\n    },\n\n    load(id) {\n      if (id === RESOLVED_VIRTUAL_ID) return registryModule()\n      if (id === ids.index) return CHROME_HTML\n      if (id === ids.iframe) return IFRAME_HTML\n      return null\n    },\n\n    configureServer(server: ViteDevServer) {\n      server.middlewares.use(async (req, res, next) => {\n        if (req.method !== 'GET') return next()\n        const url = (req.url ?? '').split('?')[0]\n        let html: string | null = null\n        if (url === '/' || url === '/index.html') html = CHROME_HTML\n        else if (url.startsWith('/__windo/iframe')) html = IFRAME_HTML\n        if (html === null) return next()\n        try {\n          const transformed = await server.transformIndexHtml(url, html)\n          res.statusCode = 200\n          res.setHeader('Content-Type', 'text/html')\n          res.end(transformed)\n        } catch (err) {\n          next(err)\n        }\n      })\n    },\n  }\n\n  return [reactPlugin(), plugin]\n}\n\nexport const windoPlugin = windo\n\nexport default windo\n"],"mappings":"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","names":["resolvePath","reactPlugin","pc","port","host","open","server"]}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+import {
+  windoPlugin
+} from "./chunk-5RM2VYAM.js";
+
+// src/cli/index.ts
+import { parseArgs } from "util";
+import pc from "picocolors";
+import { build, createServer, preview } from "vite";
+var VERSION = "0.1.0";
+var USAGE = `
+${pc.bold("windo")} ${pc.dim(`v${VERSION}`)} \u2014 zero-infra component canvas
+
+${pc.bold("Usage")}
+  windo [command] [root] [options]
+
+${pc.bold("Commands")}
+  dev                Start the dev server (default)
+  build              Emit a static canvas to windo-static/
+  preview            Serve a built canvas locally
+
+${pc.bold("Options")}
+  -p, --port <n>     Port to listen on (dev, preview)
+      --host [host]  Expose on the network (dev, preview)
+  -o, --open         Open the workbench in the browser (dev, preview)
+  -c, --config <p>   Path to windo.config.ts (dev, build)
+  -d, --outDir <p>   Output directory (build, preview) ${pc.dim("[windo-static]")}
+  -b, --base <p>     Public base path for the build ${pc.dim("[./]")}
+  -h, --help         Show this help
+`;
+var COMMANDS = /* @__PURE__ */ new Set(["dev", "build", "preview"]);
+async function main() {
+  const argv = process.argv.slice(2);
+  const first = argv[0];
+  if (first === "-h" || first === "--help") {
+    console.log(USAGE);
+    return;
+  }
+  let command = "dev";
+  let rest = argv;
+  if (first !== void 0 && !first.startsWith("-")) {
+    if (!COMMANDS.has(first)) {
+      console.error(`${pc.red(`windo: unknown command "${first}".`)}
+${USAGE}`);
+      process.exitCode = 1;
+      return;
+    }
+    command = first;
+    rest = argv.slice(1);
+  }
+  const { values, positionals } = parseArgs({
+    args: rest,
+    allowPositionals: true,
+    options: {
+      port: { type: "string", short: "p" },
+      host: { type: "string" },
+      open: { type: "boolean", short: "o" },
+      config: { type: "string", short: "c" },
+      outDir: { type: "string", short: "d" },
+      base: { type: "string", short: "b" },
+      help: { type: "boolean", short: "h" }
+    }
+  });
+  if (values.help) {
+    console.log(USAGE);
+    return;
+  }
+  const ALLOWED = {
+    dev: /* @__PURE__ */ new Set(["port", "host", "open", "config", "help"]),
+    build: /* @__PURE__ */ new Set(["config", "outDir", "base", "help"]),
+    preview: /* @__PURE__ */ new Set(["port", "host", "open", "outDir", "help"])
+  };
+  const stray = Object.keys(values).filter((k) => !ALLOWED[command].has(k));
+  if (stray.length > 0) {
+    console.error(`${pc.red(`windo ${command}: unsupported option${stray.length > 1 ? "s" : ""} ${stray.map((s) => `--${s}`).join(", ")}.`)}
+${USAGE}`);
+    process.exitCode = 1;
+    return;
+  }
+  const root = positionals[0] ? String(positionals[0]) : process.cwd();
+  const config = values.config;
+  if (command === "build") {
+    const outDir = values.outDir ?? "windo-static";
+    const base = values.base ?? "./";
+    console.log();
+    console.log(`  ${pc.bold(pc.cyan("windo"))} ${pc.dim(`v${VERSION}`)} ${pc.dim("build")}`);
+    console.log();
+    await build({
+      root,
+      base,
+      // Self-contained: don't merge an unrelated vite.config from the project.
+      configFile: false,
+      plugins: [windoPlugin({ config })],
+      build: { outDir, emptyOutDir: true }
+    });
+    console.log();
+    console.log(`  ${pc.green("\u2713")} canvas written to ${pc.cyan(outDir)}`);
+    console.log(`  ${pc.dim("preview it with")} ${pc.bold("windo preview")}${outDir === "windo-static" ? "" : ` -d ${outDir}`}`);
+    console.log();
+    return;
+  }
+  if (command === "preview") {
+    const outDir = values.outDir ?? "windo-static";
+    const port2 = values.port === void 0 ? void 0 : Number(values.port);
+    const host2 = values.host === "" ? true : values.host;
+    const open2 = values.open ?? false;
+    const server2 = await preview({
+      root,
+      configFile: false,
+      build: { outDir },
+      preview: { port: port2, host: host2, open: open2 }
+    });
+    console.log();
+    console.log(`  ${pc.bold(pc.cyan("windo"))} ${pc.dim(`v${VERSION}`)} ${pc.dim("preview")}`);
+    console.log();
+    server2.printUrls();
+    return;
+  }
+  const port = values.port === void 0 ? void 0 : Number(values.port);
+  const host = values.host === "" ? true : values.host;
+  const open = values.open ?? false;
+  const server = await createServer({
+    root,
+    plugins: [windoPlugin({ config })],
+    server: { port, host, open }
+  });
+  await server.listen();
+  console.log();
+  console.log(`  ${pc.bold(pc.cyan("windo"))} ${pc.dim(`v${VERSION}`)}`);
+  console.log();
+  server.printUrls();
+}
+main().catch((err) => {
+  process.exitCode = 1;
+  console.error(pc.red("windo: command failed."));
+  console.error(err);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// The package bin. `windo [command] [root] [options]`:\n//   dev      boot a Vite dev server wired with the windo plugin (default)\n//   build    emit a static canvas to windo-static/ (drop on any static host)\n//   preview  serve a built canvas locally\n\nimport { parseArgs } from 'node:util'\nimport pc from 'picocolors'\nimport { build, createServer, preview } from 'vite'\nimport { windoPlugin } from '../plugin'\n\nconst VERSION = '0.1.0'\n\nconst USAGE = `\n${pc.bold('windo')} ${pc.dim(`v${VERSION}`)} — zero-infra component canvas\n\n${pc.bold('Usage')}\n  windo [command] [root] [options]\n\n${pc.bold('Commands')}\n  dev                Start the dev server (default)\n  build              Emit a static canvas to windo-static/\n  preview            Serve a built canvas locally\n\n${pc.bold('Options')}\n  -p, --port <n>     Port to listen on (dev, preview)\n      --host [host]  Expose on the network (dev, preview)\n  -o, --open         Open the workbench in the browser (dev, preview)\n  -c, --config <p>   Path to windo.config.ts (dev, build)\n  -d, --outDir <p>   Output directory (build, preview) ${pc.dim('[windo-static]')}\n  -b, --base <p>     Public base path for the build ${pc.dim('[./]')}\n  -h, --help         Show this help\n`\n\nconst COMMANDS = new Set(['dev', 'build', 'preview'])\n\nasync function main() {\n  const argv = process.argv.slice(2)\n  const first = argv[0]\n\n  if (first === '-h' || first === '--help') {\n    console.log(USAGE)\n    return\n  }\n\n  // A leading token that names a command selects it; no token (or a flag)\n  // defaults to `dev`. Any other leading token is a mistyped command — fail\n  // loudly rather than silently treating it as a dev root.\n  let command = 'dev'\n  let rest = argv\n  if (first !== undefined && !first.startsWith('-')) {\n    if (!COMMANDS.has(first)) {\n      console.error(`${pc.red(`windo: unknown command \"${first}\".`)}\\n${USAGE}`)\n      process.exitCode = 1\n      return\n    }\n    command = first\n    rest = argv.slice(1)\n  }\n\n  const { values, positionals } = parseArgs({\n    args: rest,\n    allowPositionals: true,\n    options: {\n      port: { type: 'string', short: 'p' },\n      host: { type: 'string' },\n      open: { type: 'boolean', short: 'o' },\n      config: { type: 'string', short: 'c' },\n      outDir: { type: 'string', short: 'd' },\n      base: { type: 'string', short: 'b' },\n      help: { type: 'boolean', short: 'h' },\n    },\n  })\n\n  if (values.help) {\n    console.log(USAGE)\n    return\n  }\n\n  // Each command accepts only its own flags; reject the rest so a misplaced\n  // `windo build --port` fails instead of silently doing nothing.\n  const ALLOWED: Record<string, Set<string>> = {\n    dev: new Set(['port', 'host', 'open', 'config', 'help']),\n    build: new Set(['config', 'outDir', 'base', 'help']),\n    preview: new Set(['port', 'host', 'open', 'outDir', 'help']),\n  }\n  const stray = Object.keys(values).filter(k => !ALLOWED[command].has(k))\n  if (stray.length > 0) {\n    console.error(`${pc.red(`windo ${command}: unsupported option${stray.length > 1 ? 's' : ''} ${stray.map(s => `--${s}`).join(', ')}.`)}\\n${USAGE}`)\n    process.exitCode = 1\n    return\n  }\n\n  const root = positionals[0] ? String(positionals[0]) : process.cwd()\n  const config = values.config\n\n  if (command === 'build') {\n    const outDir = values.outDir ?? 'windo-static'\n    const base = values.base ?? './'\n    console.log()\n    console.log(`  ${pc.bold(pc.cyan('windo'))} ${pc.dim(`v${VERSION}`)} ${pc.dim('build')}`)\n    console.log()\n    await build({\n      root,\n      base,\n      // Self-contained: don't merge an unrelated vite.config from the project.\n      configFile: false,\n      plugins: [windoPlugin({ config })],\n      build: { outDir, emptyOutDir: true },\n    })\n    console.log()\n    console.log(`  ${pc.green('✓')} canvas written to ${pc.cyan(outDir)}`)\n    console.log(`  ${pc.dim('preview it with')} ${pc.bold('windo preview')}${outDir === 'windo-static' ? '' : ` -d ${outDir}`}`)\n    console.log()\n    return\n  }\n\n  if (command === 'preview') {\n    const outDir = values.outDir ?? 'windo-static'\n    const port = values.port === undefined ? undefined : Number(values.port)\n    const host = values.host === '' ? true : values.host\n    const open = values.open ?? false\n    const server = await preview({\n      root,\n      configFile: false,\n      build: { outDir },\n      preview: { port, host, open },\n    })\n    console.log()\n    console.log(`  ${pc.bold(pc.cyan('windo'))} ${pc.dim(`v${VERSION}`)} ${pc.dim('preview')}`)\n    console.log()\n    server.printUrls()\n    return\n  }\n\n  // dev\n  const port = values.port === undefined ? undefined : Number(values.port)\n  const host = values.host === '' ? true : values.host\n  const open = values.open ?? false\n\n  const server = await createServer({\n    root,\n    plugins: [windoPlugin({ config })],\n    server: { port, host, open },\n  })\n\n  await server.listen()\n\n  console.log()\n  console.log(`  ${pc.bold(pc.cyan('windo'))} ${pc.dim(`v${VERSION}`)}`)\n  console.log()\n  server.printUrls()\n}\n\nmain().catch(err => {\n  process.exitCode = 1\n  console.error(pc.red('windo: command failed.'))\n  console.error(err)\n})\n"],"mappings":"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","names":["port","host","open","server"]}

package/dist/index.cjs

@@ -0,0 +1,219 @@
+"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);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  WINDO_ACTION_TRIGGERS: () => WINDO_ACTION_TRIGGERS,
+  WINDO_MSG: () => WINDO_MSG,
+  WINDO_PLACEMENTS: () => WINDO_PLACEMENTS,
+  WINDO_STATUSES: () => WINDO_STATUSES,
+  configurableProps: () => configurableProps,
+  defineContext: () => defineContext,
+  defineWindoConfig: () => defineWindoConfig,
+  describeSchema: () => describeSchema,
+  isHostMessage: () => isHostMessage,
+  isPreviewMessage: () => isPreviewMessage,
+  isWindoMessage: () => isWindoMessage
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/define-config.ts
+function defineWindoConfig(config) {
+  function windo(factory) {
+    return {
+      __windo: true,
+      resolve: (w) => factory(w)
+    };
+  }
+  return { config, windo };
+}
+function defineContext(def) {
+  return def;
+}
+function configurableProps() {
+  return (schema) => schema;
+}
+
+// src/descriptor.ts
+var import_zod = require("zod");
+function describeSchema(schema) {
+  if (!schema) return { fields: [] };
+  let json;
+  try {
+    json = import_zod.z.toJSONSchema(schema, { io: "input", unrepresentable: "any" });
+  } catch {
+    return { fields: [] };
+  }
+  const root = unwrap(json);
+  const properties = root.properties ?? {};
+  const required = new Set(root.required ?? []);
+  const zodKinds = shapeKinds(schema);
+  const fields = Object.keys(properties).map((key) => fieldFrom(key, properties[key], required.has(key), zodKinds[key]));
+  return { fields };
+}
+function unwrap(node) {
+  if (node.properties) return node;
+  const branches = node.anyOf ?? node.oneOf ?? node.allOf;
+  if (branches) {
+    const withProps = branches.find((b) => b.properties);
+    if (withProps) return withProps;
+  }
+  return node;
+}
+function fieldFrom(key, node, isRequired, zodKind) {
+  const inner = collapseNullable(node);
+  let kind = kindOf(inner);
+  if (zodKind && (kind === "unknown" || zodKind === "date")) kind = zodKind;
+  const descriptor = {
+    key,
+    kind,
+    optional: !isRequired || isNullable(node)
+  };
+  if (inner.description) descriptor.description = inner.description;
+  const options = enumOptions(inner);
+  if (options) descriptor.options = options;
+  if (typeof inner.minimum === "number") descriptor.min = inner.minimum;
+  if (typeof inner.maximum === "number") descriptor.max = inner.maximum;
+  return descriptor;
+}
+function isNullable(node) {
+  const branches = node.anyOf ?? node.oneOf;
+  if (!branches) return false;
+  return branches.some((b) => b.type === "null");
+}
+function collapseNullable(node) {
+  const branches = node.anyOf ?? node.oneOf;
+  if (!branches) return node;
+  const nonNull = branches.filter((b) => b.type !== "null");
+  if (nonNull.length === 1) return nonNull[0];
+  return node;
+}
+function enumOptions(node) {
+  if (Array.isArray(node.enum)) return node.enum.map((v) => String(v));
+  const branches = node.anyOf ?? node.oneOf;
+  if (branches?.every((b) => b.const !== void 0)) {
+    return branches.map((b) => String(b.const));
+  }
+  return void 0;
+}
+function kindOf(node) {
+  if (Array.isArray(node.enum) || (node.anyOf?.every((b) => b.const !== void 0) ?? false)) return "enum";
+  if (node.format === "date-time" || node.format === "date") return "date";
+  const type = Array.isArray(node.type) ? node.type.find((t) => t !== "null") : node.type;
+  switch (type) {
+    case "string":
+      return "string";
+    case "number":
+    case "integer":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "array":
+      return "array";
+    case "object":
+      return "object";
+    default:
+      return "unknown";
+  }
+}
+function zodDef(node) {
+  const n = node;
+  if (!n || typeof n !== "object") return void 0;
+  return n.def ?? n._zod?.def;
+}
+var ZOD_WRAPPERS = /* @__PURE__ */ new Set(["optional", "nullable", "default", "prefault", "catch", "readonly", "nonoptional", "lazy"]);
+function unwrapZodDef(node) {
+  let def = zodDef(node);
+  let guard = 0;
+  while (def && def.innerType && ZOD_WRAPPERS.has(def.type ?? "") && guard++ < 16) {
+    def = zodDef(def.innerType);
+  }
+  return def;
+}
+function mapZodType(type) {
+  switch (type) {
+    case "date":
+      return "date";
+    case "string":
+      return "string";
+    case "number":
+    case "int":
+    case "bigint":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "array":
+    case "set":
+    case "tuple":
+      return "array";
+    case "object":
+    case "record":
+    case "map":
+      return "object";
+    case "enum":
+    case "literal":
+      return "enum";
+    default:
+      return void 0;
+  }
+}
+function shapeKinds(schema) {
+  const shape = schema.shape;
+  if (!shape || typeof shape !== "object") return {};
+  const out = {};
+  for (const key of Object.keys(shape)) {
+    const kind = mapZodType(unwrapZodDef(shape[key])?.type);
+    if (kind) out[key] = kind;
+  }
+  return out;
+}
+
+// src/protocol.ts
+var WINDO_MSG = "windo";
+function isWindoMessage(data) {
+  return typeof data === "object" && data !== null && data.source === WINDO_MSG;
+}
+function isHostMessage(msg) {
+  return msg.dir === "host";
+}
+function isPreviewMessage(msg) {
+  return msg.dir === "preview";
+}
+
+// src/types.ts
+var WINDO_STATUSES = ["stable", "beta", "deprecated"];
+var WINDO_PLACEMENT_BASE = ["center", "fill", "top", "bottom", "left", "right", "top-left", "top-right", "bottom-left", "bottom-right"];
+var WINDO_PLACEMENTS = [...WINDO_PLACEMENT_BASE, ...WINDO_PLACEMENT_BASE.map((p) => `${p}-padding`)];
+var WINDO_ACTION_TRIGGERS = ["click", "enter", "exit", "hover"];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WINDO_ACTION_TRIGGERS,
+  WINDO_MSG,
+  WINDO_PLACEMENTS,
+  WINDO_STATUSES,
+  configurableProps,
+  defineContext,
+  defineWindoConfig,
+  describeSchema,
+  isHostMessage,
+  isPreviewMessage,
+  isWindoMessage
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/define-config.ts","../src/descriptor.ts","../src/protocol.ts","../src/types.ts"],"sourcesContent":["// Public authoring API. This is the isomorphic entry point users import from\n// their `*.windo.tsx` and `windo.config.ts` files. No DOM or Node code lives\n// here — the chrome (`/client`), preview (`/preview`), plugin (`/plugin`), and\n// CLI (`bin`) are separate entry points.\n\nexport type { DefineWindoConfigResult } from './define-config'\nexport { configurableProps, defineContext, defineWindoConfig } from './define-config'\nexport { describeSchema } from './descriptor'\nexport type { WindoHostMessage, WindoMessage, WindoPreviewMessage } from './protocol'\nexport {\n  isHostMessage,\n  isPreviewMessage,\n  isWindoMessage,\n  WINDO_MSG,\n} from './protocol'\nexport type {\n  WindoAction,\n  WindoActionMeta,\n  WindoActionTrigger,\n  WindoConfig,\n  WindoContextControlMeta,\n  WindoContextDefinition,\n  WindoContextMap,\n  WindoContextMeta,\n  WindoControlDescriptor,\n  WindoControlKind,\n  WindoControlMap,\n  WindoControlSpec,\n  WindoControlType,\n  WindoControlValues,\n  WindoDefaultProps,\n  WindoDefinition,\n  WindoEnvState,\n  WindoFactoryArg,\n  WindoFieldError,\n  WindoGroup,\n  WindoLogEntry,\n  WindoLogger,\n  WindoManifestEntry,\n  WindoModule,\n  WindoPlacement,\n  WindoPropDoc,\n  WindoRenderContext,\n  WindoSchemaDescriptor,\n  WindoStatus,\n  WindoVariant,\n  WindoVariantMeta,\n  WindoViewport,\n} from './types'\nexport {\n  WINDO_ACTION_TRIGGERS,\n  WINDO_PLACEMENTS,\n  WINDO_STATUSES,\n} from './types'\n","// The authoring API. `defineWindoConfig` is the single entry point: it captures\n// the project's groups + contexts and hands back a `windo` factory whose `group`\n// field is type-checked against the configured slugs.\n\nimport type { ComponentType, ReactNode } from 'react'\nimport type { z } from 'zod'\nimport type { WindoConfig, WindoContextDefinition, WindoContextMap, WindoControlMap, WindoControlValues, WindoDefinition, WindoFactoryArg, WindoGroup, WindoModule, WindoRenderContext } from './types'\n\nexport interface DefineWindoConfigResult<Groups extends readonly WindoGroup[], Contexts extends WindoContextMap> {\n  config: WindoConfig<Groups, Contexts>\n  windo: <Props, State = Record<string, never>>(factory: (w: WindoFactoryArg<Groups, Contexts>) => WindoDefinition<Props, State, Groups[number]['slug']>) => WindoModule<Props, State>\n}\n\nexport function defineWindoConfig<const Groups extends readonly WindoGroup[], Contexts extends WindoContextMap = Record<string, never>>(\n  config: WindoConfig<Groups, Contexts>\n): DefineWindoConfigResult<Groups, Contexts> {\n  function windo<Props, State = Record<string, never>>(factory: (w: WindoFactoryArg<Groups, Contexts>) => WindoDefinition<Props, State, Groups[number]['slug']>): WindoModule<Props, State> {\n    return {\n      __windo: true,\n      resolve: w => factory(w as unknown as WindoFactoryArg<Groups, Contexts>),\n    }\n  }\n  return { config, windo }\n}\n\n/**\n * Define a named context. A context can contribute ambient `controls` (values +\n * UI), a `provider` (mounted inside the iframe for components that opt in via\n * `uses`), or both.\n *\n * No cast: `def` is already structurally a `WindoContextDefinition<WindoControlValues<C>,\n * Provided>` (only `controls` widens, covariantly). The unavoidable variance — TS has\n * no existential type to hold contexts heterogeneous in `C` — is absorbed once, in\n * `WindoContextMap`, not here and not at call sites.\n */\nexport function defineContext<C extends WindoControlMap, Provided = WindoControlValues<C>>(def: {\n  label?: string\n  description?: string\n  controls?: C\n  provider?: ComponentType<{ children: ReactNode; values: WindoControlValues<C>; ctx: WindoRenderContext }>\n  resolve?: (values: WindoControlValues<C>, ctx: WindoRenderContext) => Provided\n}): WindoContextDefinition<WindoControlValues<C>, Provided> {\n  return def\n}\n\n/**\n * Bind a zod schema to a component's props. The generic carries the component's\n * prop type so the schema's output stays a subset of it; the returned schema is\n * the runtime validator + parser (`z.input` is the JSON edit surface, `z.output`\n * is what the component receives).\n */\nexport function configurableProps<P>() {\n  return <S extends z.ZodType<Partial<P>>>(schema: S): S => schema\n}\n","// Walk a zod schema into a serialisable descriptor that can cross the iframe\n// boundary and render the Controls/Schema UI. We lean on `z.toJSONSchema` (zod\n// v4) for the input shape (enum options, min/max, optionality), then enrich the\n// kind from the zod node's own type tag — some types (Date, Map, Set) are\n// unrepresentable in JSON Schema and come back as `{}`, but their zod `def.type`\n// is exact. The live schema (with transforms/coerce/refine) stays in the iframe\n// and does the actual parsing — only this descriptor travels.\n\nimport { z } from 'zod'\nimport type { WindoControlDescriptor, WindoControlKind, WindoSchemaDescriptor } from './types'\n\ninterface JsonNode {\n  type?: string | string[]\n  enum?: unknown[]\n  const?: unknown\n  format?: string\n  properties?: Record<string, JsonNode>\n  required?: string[]\n  items?: JsonNode\n  anyOf?: JsonNode[]\n  oneOf?: JsonNode[]\n  allOf?: JsonNode[]\n  minimum?: number\n  maximum?: number\n  description?: string\n}\n\nexport function describeSchema(schema: z.ZodType | undefined | null): WindoSchemaDescriptor {\n  if (!schema) return { fields: [] }\n  let json: JsonNode\n  try {\n    json = z.toJSONSchema(schema, { io: 'input', unrepresentable: 'any' }) as JsonNode\n  } catch {\n    return { fields: [] }\n  }\n  const root = unwrap(json)\n  const properties = root.properties ?? {}\n  const required = new Set(root.required ?? [])\n  const zodKinds = shapeKinds(schema)\n  const fields: WindoControlDescriptor[] = Object.keys(properties).map(key => fieldFrom(key, properties[key], required.has(key), zodKinds[key]))\n  return { fields }\n}\n\n// JSON Schema often wraps the object in anyOf (for optional/nullable). Find the\n// node that actually carries the object's properties.\nfunction unwrap(node: JsonNode): JsonNode {\n  if (node.properties) return node\n  const branches = node.anyOf ?? node.oneOf ?? node.allOf\n  if (branches) {\n    const withProps = branches.find(b => b.properties)\n    if (withProps) return withProps\n  }\n  return node\n}\n\nfunction fieldFrom(key: string, node: JsonNode, isRequired: boolean, zodKind?: WindoControlKind): WindoControlDescriptor {\n  const inner = collapseNullable(node)\n  let kind = kindOf(inner)\n  // The zod tag wins for types JSON Schema can't express (date/array/object that\n  // came back as {}), and as a fallback whenever the JSON kind is unknown.\n  if (zodKind && (kind === 'unknown' || zodKind === 'date')) kind = zodKind\n  const descriptor: WindoControlDescriptor = {\n    key,\n    kind,\n    optional: !isRequired || isNullable(node),\n  }\n  if (inner.description) descriptor.description = inner.description\n  const options = enumOptions(inner)\n  if (options) descriptor.options = options\n  if (typeof inner.minimum === 'number') descriptor.min = inner.minimum\n  if (typeof inner.maximum === 'number') descriptor.max = inner.maximum\n  return descriptor\n}\n\nfunction isNullable(node: JsonNode): boolean {\n  const branches = node.anyOf ?? node.oneOf\n  if (!branches) return false\n  return branches.some(b => b.type === 'null')\n}\n\n// Strip a `{ anyOf: [T, null] }` wrapper down to T.\nfunction collapseNullable(node: JsonNode): JsonNode {\n  const branches = node.anyOf ?? node.oneOf\n  if (!branches) return node\n  const nonNull = branches.filter(b => b.type !== 'null')\n  if (nonNull.length === 1) return nonNull[0]\n  return node\n}\n\nfunction enumOptions(node: JsonNode): string[] | undefined {\n  if (Array.isArray(node.enum)) return node.enum.map(v => String(v))\n  const branches = node.anyOf ?? node.oneOf\n  if (branches?.every(b => b.const !== undefined)) {\n    return branches.map(b => String(b.const))\n  }\n  return undefined\n}\n\nfunction kindOf(node: JsonNode): WindoControlKind {\n  if (Array.isArray(node.enum) || (node.anyOf?.every(b => b.const !== undefined) ?? false)) return 'enum'\n  if (node.format === 'date-time' || node.format === 'date') return 'date'\n  const type = Array.isArray(node.type) ? node.type.find(t => t !== 'null') : node.type\n  switch (type) {\n    case 'string':\n      return 'string'\n    case 'number':\n    case 'integer':\n      return 'number'\n    case 'boolean':\n      return 'boolean'\n    case 'array':\n      return 'array'\n    case 'object':\n      return 'object'\n    default:\n      return 'unknown'\n  }\n}\n\n/* ------------------------------------------------------------------ *\n * zod node introspection (the kind source of truth for unrepresentable types)\n * ------------------------------------------------------------------ */\n\ninterface ZodDefLike {\n  type?: string\n  innerType?: unknown\n}\n\nfunction zodDef(node: unknown): ZodDefLike | undefined {\n  const n = node as { def?: ZodDefLike; _zod?: { def?: ZodDefLike } } | null\n  if (!n || typeof n !== 'object') return undefined\n  return n.def ?? n._zod?.def\n}\n\nconst ZOD_WRAPPERS = new Set(['optional', 'nullable', 'default', 'prefault', 'catch', 'readonly', 'nonoptional', 'lazy'])\n\n// Unwrap optional/nullable/default/... down to the meaningful inner node.\nfunction unwrapZodDef(node: unknown): ZodDefLike | undefined {\n  let def = zodDef(node)\n  let guard = 0\n  while (def && def.innerType && ZOD_WRAPPERS.has(def.type ?? '') && guard++ < 16) {\n    def = zodDef(def.innerType)\n  }\n  return def\n}\n\nfunction mapZodType(type: string | undefined): WindoControlKind | undefined {\n  switch (type) {\n    case 'date':\n      return 'date'\n    case 'string':\n      return 'string'\n    case 'number':\n    case 'int':\n    case 'bigint':\n      return 'number'\n    case 'boolean':\n      return 'boolean'\n    case 'array':\n    case 'set':\n    case 'tuple':\n      return 'array'\n    case 'object':\n    case 'record':\n    case 'map':\n      return 'object'\n    case 'enum':\n    case 'literal':\n      return 'enum'\n    default:\n      return undefined\n  }\n}\n\n// Per-field kind read straight from the zod object's shape.\nfunction shapeKinds(schema: z.ZodType): Record<string, WindoControlKind> {\n  const shape = (schema as { shape?: Record<string, unknown> }).shape\n  if (!shape || typeof shape !== 'object') return {}\n  const out: Record<string, WindoControlKind> = {}\n  for (const key of Object.keys(shape)) {\n    const kind = mapZodType(unwrapZodDef(shape[key])?.type)\n    if (kind) out[key] = kind\n  }\n  return out\n}\n","// The chrome <-> iframe postMessage contract. The schema itself never crosses\n// the boundary: the iframe walks it into a serialisable descriptor, the chrome\n// sends candidate JSON down, the iframe parses and reports back. Every payload\n// here is plain JSON.\n\nimport type { WindoContextMeta, WindoEnvState, WindoFieldError, WindoGroup, WindoLogEntry, WindoManifestEntry, WindoPropDoc, WindoSchemaDescriptor, WindoVariantMeta } from './types'\n\nexport const WINDO_MSG = 'windo'\n\n/** chrome -> iframe */\nexport type WindoHostMessage =\n  | { source: typeof WINDO_MSG; dir: 'host'; type: 'request-manifest' }\n  | { source: typeof WINDO_MSG; dir: 'host'; type: 'select'; id: string }\n  | { source: typeof WINDO_MSG; dir: 'host'; type: 'set-props'; id: string; json: string }\n  | { source: typeof WINDO_MSG; dir: 'host'; type: 'set-env'; env: WindoEnvState }\n  | { source: typeof WINDO_MSG; dir: 'host'; type: 'invoke-action'; id: string; actionId: string }\n\n/** iframe -> chrome */\nexport type WindoPreviewMessage =\n  | { source: typeof WINDO_MSG; dir: 'preview'; type: 'ready' }\n  | {\n      source: typeof WINDO_MSG\n      dir: 'preview'\n      type: 'manifest'\n      title: string\n      entries: WindoManifestEntry[]\n      groups: WindoGroup[]\n      contexts: WindoContextMeta[]\n    }\n  | {\n      source: typeof WINDO_MSG\n      dir: 'preview'\n      type: 'describe'\n      id: string\n      descriptor: WindoSchemaDescriptor\n      props: WindoPropDoc[]\n      variants: WindoVariantMeta[]\n      defaults: unknown\n      code: string | null\n    }\n  | { source: typeof WINDO_MSG; dir: 'preview'; type: 'parse-ok'; id: string }\n  | { source: typeof WINDO_MSG; dir: 'preview'; type: 'parse-error'; id: string; errors: WindoFieldError[] }\n  | { source: typeof WINDO_MSG; dir: 'preview'; type: 'log'; entry: WindoLogEntry }\n  | { source: typeof WINDO_MSG; dir: 'preview'; type: 'state'; id: string; state: Record<string, unknown>; actions: { id: string; disabled: boolean }[] }\n  | { source: typeof WINDO_MSG; dir: 'preview'; type: 'render-error'; id: string; message: string; stack?: string }\n\nexport type WindoMessage = WindoHostMessage | WindoPreviewMessage\n\nexport function isWindoMessage(data: unknown): data is WindoMessage {\n  return typeof data === 'object' && data !== null && (data as { source?: unknown }).source === WINDO_MSG\n}\n\nexport function isHostMessage(msg: WindoMessage): msg is WindoHostMessage {\n  return msg.dir === 'host'\n}\n\nexport function isPreviewMessage(msg: WindoMessage): msg is WindoPreviewMessage {\n  return msg.dir === 'preview'\n}\n","// Core type system for windo. Everything — the authoring API, the iframe\n// preview runtime, the chrome UI, and the postMessage protocol — is typed\n// against the contracts in this file.\n\nimport type { ComponentType, ReactNode } from 'react'\nimport type { z } from 'zod'\n\n/* ------------------------------------------------------------------ *\n * Primitives\n * ------------------------------------------------------------------ */\n\nexport type WindoStatus = 'stable' | 'beta' | 'deprecated'\n\nexport const WINDO_STATUSES: readonly WindoStatus[] = ['stable', 'beta', 'deprecated']\n\n/** Anchor a component within the canvas frame. */\nexport type WindoPlacementBase = 'center' | 'fill' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'\n\n/**\n * Where a component renders inside the canvas frame. Placements render flush by\n * default; append `-padding` to inset the component from the frame edges\n * (e.g. `top` sits flush at the top, `top-padding` adds breathing room).\n */\nexport type WindoPlacement = WindoPlacementBase | `${WindoPlacementBase}-padding`\n\nconst WINDO_PLACEMENT_BASE: readonly WindoPlacementBase[] = ['center', 'fill', 'top', 'bottom', 'left', 'right', 'top-left', 'top-right', 'bottom-left', 'bottom-right']\n\nexport const WINDO_PLACEMENTS: readonly WindoPlacement[] = [...WINDO_PLACEMENT_BASE, ...WINDO_PLACEMENT_BASE.map(p => `${p}-padding` as WindoPlacement)]\n\n/** A configured group. Components reference a group by its `slug`. */\nexport interface WindoGroup {\n  name: string\n  slug: string\n  description?: string\n}\n\n/* ------------------------------------------------------------------ *\n * Context system\n * ------------------------------------------------------------------ */\n\nexport type WindoControlType = 'enum' | 'boolean' | 'string' | 'number'\n\n/** A single ambient control: a value plus the metadata to render its toggle. */\nexport interface WindoControlSpec<T = unknown> {\n  type: WindoControlType\n  label?: string\n  default: T\n  options?: readonly string[]\n  min?: number\n  max?: number\n  step?: number\n}\n\nexport type WindoControlMap = Record<string, WindoControlSpec>\n\n/** Resolve a control map to the value object it produces. */\nexport type WindoControlValues<C extends WindoControlMap> = {\n  [K in keyof C]: C[K] extends WindoControlSpec<infer T> ? T : never\n}\n\n/**\n * A named context. Two capabilities, either or both:\n *  - `controls`  → ambient values + UI toggles (free, no opt-in needed)\n *  - `provider`  → a React wrapper, mounted inside the iframe around components\n *                  that opt in via `uses`\n */\nexport interface WindoContextDefinition<Values = unknown, Provided = Values> {\n  label?: string\n  description?: string\n  controls?: WindoControlMap\n  provider?: ComponentType<{ children: ReactNode; values: Values; ctx: WindoRenderContext }>\n  /** Derive the value exposed on `ctx.contexts[name]`. Defaults to the control values. */\n  resolve?: (values: Values, ctx: WindoRenderContext) => Provided\n}\n\n// Contexts are each generic over a different control map `C`; TS has no existential\n// to hold `exists C. WindoContextDefinition<WindoControlValues<C>>`. `Values` sits in\n// contravariant positions (provider props, resolve arg) so no precise common supertype\n// exists — `any` is the single, contained variance hatch for this heterogeneous\n// registry. Mirrors WindoModule. Definition sites stay precise; this only erases at the\n// point of collection.\n// biome-ignore lint/suspicious/noExplicitAny: existential variance hatch for the heterogeneous context registry\nexport type WindoContextMap = Record<string, WindoContextDefinition<any, any>>\n\n/* ------------------------------------------------------------------ *\n * Render-time context\n * ------------------------------------------------------------------ */\n\nexport interface WindoViewport {\n  width: number\n  height: number\n  name: 'mobile' | 'tablet' | 'desktop'\n}\n\n/** Console channel: `ctx.logger.log(…)` posts an entry to the chrome's Console tab. */\nexport interface WindoLogger {\n  log: (...args: unknown[]) => void\n}\n\n/** How an action fires. `click` renders a toolbar button; the rest bind to the stage's pointer events. */\nexport type WindoActionTrigger = 'click' | 'enter' | 'exit' | 'hover'\n\nexport const WINDO_ACTION_TRIGGERS: readonly WindoActionTrigger[] = ['click', 'enter', 'exit', 'hover']\n\n/**\n * An out-of-band action that drives a component's state. `click` actions render as\n * toolbar buttons; `enter`/`exit`/`hover` bind to the stage's pointer events. `run`\n * receives the live ctx and an `active` flag — for `hover` it is `true` on\n * pointer-enter and `false` on pointer-leave; for the others it is always `true`.\n */\nexport interface WindoAction<State = unknown> {\n  label: string\n  /** Defaults to `click`. */\n  on?: WindoActionTrigger\n  run: (ctx: WindoRenderContext<State>, active: boolean) => void\n  /** Greys out a `click` action's toolbar button. Evaluated against the live state. */\n  disabled?: (ctx: WindoRenderContext<State>) => boolean\n}\n\n/** Live environment handed to every render-time function inside the iframe. */\nexport interface WindoRenderContext<State = unknown> {\n  colorScheme: 'light' | 'dark'\n  viewport: WindoViewport\n  reducedMotion: boolean\n  direction: 'ltr' | 'rtl'\n  locale: string\n  logger: WindoLogger\n  /** Current component-local state, typed by the windo's `State` generic. */\n  state: State\n  /** Merge a patch into the component-local state and re-render. */\n  setState: (patch: Partial<State>) => void\n  /** Resolved values of opted-in contexts, keyed by context name. */\n  contexts: Record<string, unknown>\n}\n\n/* ------------------------------------------------------------------ *\n * Authoring API\n * ------------------------------------------------------------------ */\n\n/** A variant: a label plus a partial prop patch. Renders in the gallery and is click-to-apply. */\nexport interface WindoVariant<Props> {\n  label: string\n  props: Partial<Props>\n}\n\n/** A row in the authored Props documentation table. */\nexport interface WindoPropDoc {\n  name: string\n  type: string\n  default?: string\n  desc?: string\n}\n\nexport type WindoDefaultProps<Props, State = unknown> = Props | ((ctx: WindoRenderContext<State>) => Props)\n\n/**\n * The object returned by a `windo(...)` factory.\n *\n * Keystone rule: the surrounding factory runs ONCE (definition-time) for static\n * fields (title, group, schema). Every function field below — `defaultProps`,\n * `actions`, `providers`, `component` — runs at render-time with the live `ctx`.\n * Never close over live values in the static factory body.\n */\nexport interface WindoDefinition<Props = unknown, State = unknown, GroupSlug extends string = string> {\n  title: string\n  group: GroupSlug\n  status?: WindoStatus\n  description?: string\n  deprecation?: string\n  placement?: WindoPlacement\n  /** Initial component-local state. Its shape is the `State` generic; `ctx.state`/`ctx.setState` derive from it. */\n  state?: State\n  /** Out-of-band actions that drive state: toolbar buttons (`click`) and stage pointer triggers (`enter`/`exit`/`hover`). */\n  actions?: WindoAction<State>[]\n  /** zod schema: validator + parser for the JSON-editable prop subset. `z.output ⊆ Props`. */\n  configurableProps?: z.ZodType\n  /** Full props incl. functions/JSX. The editor's JSON overrides merge on top. */\n  defaultProps: WindoDefaultProps<Props, State>\n  /** Names of provider contexts this component opts into. */\n  uses?: string[]\n  variants?: WindoVariant<Props>[]\n  /** Authored documentation table (not derived from the schema). */\n  props?: WindoPropDoc[]\n  /** Optional authored code snippet for the Code tab. */\n  code?: (values: Props) => string\n  /** A local provider wrapping just this windo (in addition to `uses`). */\n  providers?: ComponentType<{ children: ReactNode; ctx: WindoRenderContext<State> }>\n  component: (props: Props, ctx: WindoRenderContext<State>) => ReactNode\n}\n\n/** Argument handed to the `windo(w => ...)` factory. */\nexport interface WindoFactoryArg<Groups extends readonly WindoGroup[], Contexts extends WindoContextMap> {\n  /** Configured groups keyed by slug. */\n  groups: Record<Groups[number]['slug'], WindoGroup>\n  contexts: Contexts\n}\n\n/**\n * The default export of a `*.windo.tsx` file. A branded, lazily-resolved\n * definition — the runtime calls `resolve(w)` with the config-derived factory arg.\n */\n// biome-ignore lint/suspicious/noExplicitAny: variance escape hatch for the heterogeneous WindoModule registry\nexport interface WindoModule<Props = any, State = any> {\n  readonly __windo: true\n  resolve: (w: WindoFactoryArg<readonly WindoGroup[], WindoContextMap>) => WindoDefinition<Props, State>\n}\n\n/* ------------------------------------------------------------------ *\n * Config\n * ------------------------------------------------------------------ */\n\nexport interface WindoConfig<Groups extends readonly WindoGroup[] = readonly WindoGroup[], Contexts extends WindoContextMap = WindoContextMap> {\n  /** Configured groups. A component's `group` must be one of these slugs. */\n  groups: Groups\n  /** Named contexts available to components. */\n  contexts?: Contexts\n  /** Glob(s) for discovery, relative to project root. Default `**\\/*.windo.tsx`. */\n  include?: string | string[]\n  /** Title shown in the workbench chrome. */\n  title?: string\n}\n\n/* ------------------------------------------------------------------ *\n * Schema descriptor (crosses the iframe boundary; renders the controls)\n * ------------------------------------------------------------------ */\n\nexport type WindoControlKind = 'string' | 'number' | 'boolean' | 'enum' | 'date' | 'array' | 'object' | 'unknown'\n\nexport interface WindoControlDescriptor {\n  key: string\n  kind: WindoControlKind\n  optional: boolean\n  options?: string[]\n  min?: number\n  max?: number\n  description?: string\n}\n\nexport interface WindoSchemaDescriptor {\n  fields: WindoControlDescriptor[]\n}\n\n/* ------------------------------------------------------------------ *\n * Runtime manifest + protocol payloads\n * ------------------------------------------------------------------ */\n\n/** Serialisable metadata for one action — drives the canvas toolbar. */\nexport interface WindoActionMeta {\n  id: string\n  label: string\n  on: WindoActionTrigger\n}\n\n/** Static, serialisable metadata for one windo — drives the sidebar. */\nexport interface WindoManifestEntry {\n  id: string\n  title: string\n  group: string\n  status: WindoStatus\n  description?: string\n  deprecation?: string\n  placement: WindoPlacement\n  uses: string[]\n  hasVariants: boolean\n  actions: WindoActionMeta[]\n  hasState: boolean\n}\n\nexport interface WindoVariantMeta {\n  label: string\n  props: Record<string, unknown>\n}\n\n/** Ambient environment pushed from the chrome down into the iframe. */\nexport interface WindoEnvState {\n  colorScheme: 'light' | 'dark'\n  viewport: WindoViewport\n  reducedMotion: boolean\n  direction: 'ltr' | 'rtl'\n  locale: string\n  /** Per-context control values, keyed by context name then control key. */\n  contexts: Record<string, Record<string, unknown>>\n}\n\nexport interface WindoLogEntry {\n  ts: number\n  args: unknown[]\n}\n\nexport interface WindoFieldError {\n  path: string\n  message: string\n}\n\n/* ------------------------------------------------------------------ *\n * Context metadata (serialisable; drives the chrome's Context panel)\n * ------------------------------------------------------------------ */\n\nexport interface WindoContextControlMeta {\n  key: string\n  type: WindoControlType\n  label?: string\n  options?: string[]\n  default: unknown\n  min?: number\n  max?: number\n  step?: number\n}\n\nexport interface WindoContextMeta {\n  name: string\n  label?: string\n  description?: string\n  /** True when the context contributes controls (ambient values). */\n  ambient: boolean\n  /** True when the context mounts a provider (opt-in via `uses`). */\n  hasProvider: boolean\n  controls: WindoContextControlMeta[]\n}\n"],"mappings":"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","names":[]}