@westopp/windo 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -93,6 +93,20 @@ interface WindoRenderContext<State = unknown> {
     setState: (patch: Partial<State>) => void;
     /** Resolved values of opted-in contexts, keyed by context name. */
     contexts: Record<string, unknown>;
+    /**
+     * Shared, cross-component state seeded from the config's `ctxState`. Unlike
+     * `state` (per-windo, reset on selection), this persists across selection and
+     * is global: any component can read it and write it via `setCtxState`. Use it
+     * to drive providers that wrap every component — e.g. a theme provider toggled
+     * from any component on the canvas.
+     */
+    ctxState: Record<string, unknown>;
+    /** Merge a patch into the shared `ctxState` and re-render every consumer. */
+    setCtxState: (patch: Record<string, unknown>) => void;
+    /** Set the canvas colour scheme from a component or action. */
+    setColorScheme: (scheme: 'light' | 'dark') => void;
+    /** Flip the canvas colour scheme between light and dark. */
+    toggleTheme: () => void;
 }
 /** A variant: a label plus a partial prop patch. Renders in the gallery and is click-to-apply. */
 interface WindoVariant<Props> {
@@ -106,7 +120,11 @@ interface WindoPropDoc {
     default?: string;
     desc?: string;
 }
-type WindoDefaultProps<Props, State = unknown> = Props | ((ctx: WindoRenderContext<State>) => Props);
+/** A value that may be authored statically or as a context-aware `ctx => value` function resolved at render-time. */
+type Ctxual<T, State = unknown> = T | ((ctx: WindoRenderContext<State>) => T);
+/** The ctx surface available while resolving a windo's initial state — the render-time `state`/`setState` pair is excluded because it does not exist yet. */
+type WindoInitContext<State = unknown> = Omit<WindoRenderContext<State>, 'state' | 'setState'>;
+type WindoDefaultProps<Props, State = unknown> = Ctxual<Props, State>;
 /**
  * The object returned by a `windo(...)` factory.
  *
@@ -115,15 +133,18 @@ type WindoDefaultProps<Props, State = unknown> = Props | ((ctx: WindoRenderConte
  * `actions`, `providers`, `component` — runs at render-time with the live `ctx`.
  * Never close over live values in the static factory body.
  */
-interface WindoDefinition<Props = unknown, State = unknown, GroupSlug extends string = string> {
+interface WindoDefinition<Props = unknown, State = unknown, GroupSlug extends string = string, Tag extends string = string> {
     title: string;
     group: GroupSlug;
+    /** Tags this component carries. Each must be one of the config's declared `tags`. Drives the sidebar's tag filter. */
+    tags?: Tag[];
     status?: WindoStatus;
     description?: string;
     deprecation?: string;
-    placement?: WindoPlacement;
-    /** Initial component-local state. Its shape is the `State` generic; `ctx.state`/`ctx.setState` derive from it. */
-    state?: State;
+    /** Where the component anchors in the canvas frame. Either a static placement or a function resolved with the live `ctx`. */
+    placement?: Ctxual<WindoPlacement, State>;
+    /** Initial component-local state. Its shape is the `State` generic; `ctx.state`/`ctx.setState` derive from it. Either a static value or a function resolved with the init `ctx` (no `state`/`setState`) when the component is selected. */
+    state?: State | ((ctx: WindoInitContext<State>) => State);
     /** Out-of-band actions that drive state: toolbar buttons (`click`) and stage pointer triggers (`enter`/`exit`/`hover`). */
     actions?: WindoAction<State>[];
     /** zod schema: validator + parser for the JSON-editable prop subset. `z.output ⊆ Props`. */
@@ -132,11 +153,12 @@ interface WindoDefinition<Props = unknown, State = unknown, GroupSlug extends st
     defaultProps: WindoDefaultProps<Props, State>;
     /** Names of provider contexts this component opts into. */
     uses?: string[];
-    variants?: WindoVariant<Props>[];
-    /** Authored documentation table (not derived from the schema). */
-    props?: WindoPropDoc[];
-    /** Optional authored code snippet for the Code tab. */
-    code?: (values: Props) => string;
+    /** Gallery variants. Either a static array or a function resolved with the live `ctx` when the component is selected. */
+    variants?: Ctxual<WindoVariant<Props>[], State>;
+    /** Authored documentation table (not derived from the schema). Either a static array or a function resolved with the live `ctx` when the component is selected. */
+    props?: Ctxual<WindoPropDoc[], State>;
+    /** Optional authored code snippet for the Code tab, resolved with the JSON-editable values and the live `ctx`. */
+    code?: (values: Props, ctx: WindoRenderContext<State>) => string;
     /** A local provider wrapping just this windo (in addition to `uses`). */
     providers?: ComponentType<{
         children: ReactNode;
@@ -145,10 +167,12 @@ interface WindoDefinition<Props = unknown, State = unknown, GroupSlug extends st
     component: (props: Props, ctx: WindoRenderContext<State>) => ReactNode;
 }
 /** Argument handed to the `windo(w => ...)` factory. */
-interface WindoFactoryArg<Groups extends readonly WindoGroup[], Contexts extends WindoContextMap> {
+interface WindoFactoryArg<Groups extends readonly WindoGroup[], Contexts extends WindoContextMap, Tags extends readonly string[] = readonly string[]> {
     /** Configured groups keyed by slug. */
     groups: Record<Groups[number]['slug'], WindoGroup>;
     contexts: Contexts;
+    /** The config's declared tags, in declaration order. */
+    tags: Tags;
 }
 /**
  * The default export of a `*.windo.tsx` file. A branded, lazily-resolved
@@ -158,11 +182,15 @@ interface WindoModule<Props = any, State = any> {
     readonly __windo: true;
     resolve: (w: WindoFactoryArg<readonly WindoGroup[], WindoContextMap>) => WindoDefinition<Props, State>;
 }
-interface WindoConfig<Groups extends readonly WindoGroup[] = readonly WindoGroup[], Contexts extends WindoContextMap = WindoContextMap> {
+interface WindoConfig<Groups extends readonly WindoGroup[] = readonly WindoGroup[], Contexts extends WindoContextMap = WindoContextMap, Tags extends readonly string[] = readonly string[]> {
     /** Configured groups. A component's `group` must be one of these slugs. */
     groups: Groups;
     /** Named contexts available to components. */
     contexts?: Contexts;
+    /** The set of tags components may be assigned. A component's `tags` must be drawn from this list; the sidebar filters by them. */
+    tags?: Tags;
+    /** Initial shared state exposed on `ctx.ctxState`. Global across every component and persisted across selection — write it from any component via `ctx.setCtxState`. */
+    ctxState?: Record<string, unknown>;
     /** Glob(s) for discovery, relative to project root. Default `**\/*.windo.tsx`. */
     include?: string | string[];
     /** Title shown in the workbench chrome. */
@@ -192,6 +220,7 @@ interface WindoManifestEntry {
     id: string;
     title: string;
     group: string;
+    tags: string[];
     status: WindoStatus;
     description?: string;
     deprecation?: string;
@@ -244,11 +273,11 @@ interface WindoContextMeta {
     controls: WindoContextControlMeta[];
 }
 
-interface DefineWindoConfigResult<Groups extends readonly WindoGroup[], Contexts extends WindoContextMap> {
-    config: WindoConfig<Groups, Contexts>;
-    windo: <Props, State = Record<string, never>>(factory: (w: WindoFactoryArg<Groups, Contexts>) => WindoDefinition<Props, State, Groups[number]['slug']>) => WindoModule<Props, State>;
+interface DefineWindoConfigResult<Groups extends readonly WindoGroup[], Tags extends readonly string[], Contexts extends WindoContextMap> {
+    config: WindoConfig<Groups, Contexts, Tags>;
+    windo: <Props, State = Record<string, never>>(factory: (w: WindoFactoryArg<Groups, Contexts, Tags>) => WindoDefinition<Props, State, Groups[number]['slug'], Tags[number]>) => WindoModule<Props, State>;
 }
-declare function defineWindoConfig<const Groups extends readonly WindoGroup[], Contexts extends WindoContextMap = Record<string, never>>(config: WindoConfig<Groups, Contexts>): DefineWindoConfigResult<Groups, Contexts>;
+declare function defineWindoConfig<const Groups extends readonly WindoGroup[], const Tags extends readonly string[] = readonly [], Contexts extends WindoContextMap = Record<string, never>>(config: WindoConfig<Groups, Contexts, Tags>): DefineWindoConfigResult<Groups, Tags, Contexts>;
 /**
  * Define a named context. A context can contribute ambient `controls` (values +
  * UI), a `provider` (mounted inside the iframe for components that opt in via
@@ -302,6 +331,11 @@ type WindoHostMessage = {
     dir: 'host';
     type: 'set-env';
     env: WindoEnvState;
+} | {
+    source: typeof WINDO_MSG;
+    dir: 'host';
+    type: 'set-ctx-state';
+    state: Record<string, unknown>;
 } | {
     source: typeof WINDO_MSG;
     dir: 'host';
@@ -321,7 +355,10 @@ type WindoPreviewMessage = {
     title: string;
     entries: WindoManifestEntry[];
     groups: WindoGroup[];
+    tags: string[];
     contexts: WindoContextMeta[];
+    /** Initial shared state from the config — seeds the chrome's editable strip. */
+    ctxState: Record<string, unknown>;
 } | {
     source: typeof WINDO_MSG;
     dir: 'preview';
@@ -358,6 +395,16 @@ type WindoPreviewMessage = {
         id: string;
         disabled: boolean;
     }[];
+} | {
+    source: typeof WINDO_MSG;
+    dir: 'preview';
+    type: 'ctx-state';
+    state: Record<string, unknown>;
+} | {
+    source: typeof WINDO_MSG;
+    dir: 'preview';
+    type: 'color-scheme';
+    colorScheme: 'light' | 'dark';
 } | {
     source: typeof WINDO_MSG;
     dir: 'preview';
@@ -371,4 +418,4 @@ declare function isWindoMessage(data: unknown): data is WindoMessage;
 declare function isHostMessage(msg: WindoMessage): msg is WindoHostMessage;
 declare function isPreviewMessage(msg: WindoMessage): msg is WindoPreviewMessage;
 
-export { type DefineWindoConfigResult, WINDO_ACTION_TRIGGERS, WINDO_MSG, WINDO_PLACEMENTS, WINDO_STATUSES, type WindoAction, type WindoActionMeta, type WindoActionTrigger, type WindoConfig, type WindoContextControlMeta, type WindoContextDefinition, type WindoContextMap, type WindoContextMeta, type WindoControlDescriptor, type WindoControlKind, type WindoControlMap, type WindoControlSpec, type WindoControlType, type WindoControlValues, type WindoDefaultProps, type WindoDefinition, type WindoEnvState, type WindoFactoryArg, type WindoFieldError, type WindoGroup, type WindoHostMessage, type WindoLogEntry, type WindoLogger, type WindoManifestEntry, type WindoMessage, type WindoModule, type WindoPlacement, type WindoPreviewMessage, type WindoPropDoc, type WindoRenderContext, type WindoSchemaDescriptor, type WindoStatus, type WindoVariant, type WindoVariantMeta, type WindoViewport, configurableProps, defineContext, defineWindoConfig, describeSchema, isHostMessage, isPreviewMessage, isWindoMessage };
+export { type Ctxual, type DefineWindoConfigResult, WINDO_ACTION_TRIGGERS, WINDO_MSG, WINDO_PLACEMENTS, WINDO_STATUSES, type WindoAction, type WindoActionMeta, type WindoActionTrigger, type WindoConfig, type WindoContextControlMeta, type WindoContextDefinition, type WindoContextMap, type WindoContextMeta, type WindoControlDescriptor, type WindoControlKind, type WindoControlMap, type WindoControlSpec, type WindoControlType, type WindoControlValues, type WindoDefaultProps, type WindoDefinition, type WindoEnvState, type WindoFactoryArg, type WindoFieldError, type WindoGroup, type WindoHostMessage, type WindoInitContext, type WindoLogEntry, type WindoLogger, type WindoManifestEntry, type WindoMessage, type WindoModule, type WindoPlacement, type WindoPreviewMessage, type WindoPropDoc, type WindoRenderContext, type WindoSchemaDescriptor, type WindoStatus, type WindoVariant, type WindoVariantMeta, type WindoViewport, configurableProps, defineContext, defineWindoConfig, describeSchema, isHostMessage, isPreviewMessage, isWindoMessage };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/define-config.ts","../src/descriptor.ts","../src/protocol.ts","../src/types.ts"],"sourcesContent":["// 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":[]}
+{"version":3,"sources":["../src/define-config.ts","../src/descriptor.ts","../src/protocol.ts","../src/types.ts"],"sourcesContent":["// 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[], Tags extends readonly string[], Contexts extends WindoContextMap> {\n  config: WindoConfig<Groups, Contexts, Tags>\n  windo: <Props, State = Record<string, never>>(\n    factory: (w: WindoFactoryArg<Groups, Contexts, Tags>) => WindoDefinition<Props, State, Groups[number]['slug'], Tags[number]>\n  ) => WindoModule<Props, State>\n}\n\nexport function defineWindoConfig<const Groups extends readonly WindoGroup[], const Tags extends readonly string[] = readonly [], Contexts extends WindoContextMap = Record<string, never>>(\n  config: WindoConfig<Groups, Contexts, Tags>\n): DefineWindoConfigResult<Groups, Tags, Contexts> {\n  function windo<Props, State = Record<string, never>>(\n    factory: (w: WindoFactoryArg<Groups, Contexts, Tags>) => WindoDefinition<Props, State, Groups[number]['slug'], Tags[number]>\n  ): WindoModule<Props, State> {\n    return {\n      __windo: true,\n      resolve: w => factory(w as unknown as WindoFactoryArg<Groups, Contexts, Tags>),\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: 'set-ctx-state'; state: Record<string, unknown> }\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      tags: string[]\n      contexts: WindoContextMeta[]\n      /** Initial shared state from the config — seeds the chrome's editable strip. */\n      ctxState: Record<string, unknown>\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: 'ctx-state'; state: Record<string, unknown> }\n  | { source: typeof WINDO_MSG; dir: 'preview'; type: 'color-scheme'; colorScheme: 'light' | 'dark' }\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   * Shared, cross-component state seeded from the config's `ctxState`. Unlike\n   * `state` (per-windo, reset on selection), this persists across selection and\n   * is global: any component can read it and write it via `setCtxState`. Use it\n   * to drive providers that wrap every component — e.g. a theme provider toggled\n   * from any component on the canvas.\n   */\n  ctxState: Record<string, unknown>\n  /** Merge a patch into the shared `ctxState` and re-render every consumer. */\n  setCtxState: (patch: Record<string, unknown>) => void\n  /** Set the canvas colour scheme from a component or action. */\n  setColorScheme: (scheme: 'light' | 'dark') => void\n  /** Flip the canvas colour scheme between light and dark. */\n  toggleTheme: () => void\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\n/** A value that may be authored statically or as a context-aware `ctx => value` function resolved at render-time. */\nexport type Ctxual<T, State = unknown> = T | ((ctx: WindoRenderContext<State>) => T)\n\n/** The ctx surface available while resolving a windo's initial state — the render-time `state`/`setState` pair is excluded because it does not exist yet. */\nexport type WindoInitContext<State = unknown> = Omit<WindoRenderContext<State>, 'state' | 'setState'>\n\nexport type WindoDefaultProps<Props, State = unknown> = Ctxual<Props, State>\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, Tag extends string = string> {\n  title: string\n  group: GroupSlug\n  /** Tags this component carries. Each must be one of the config's declared `tags`. Drives the sidebar's tag filter. */\n  tags?: Tag[]\n  status?: WindoStatus\n  description?: string\n  deprecation?: string\n  /** Where the component anchors in the canvas frame. Either a static placement or a function resolved with the live `ctx`. */\n  placement?: Ctxual<WindoPlacement, State>\n  /** Initial component-local state. Its shape is the `State` generic; `ctx.state`/`ctx.setState` derive from it. Either a static value or a function resolved with the init `ctx` (no `state`/`setState`) when the component is selected. */\n  state?: State | ((ctx: WindoInitContext<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  /** Gallery variants. Either a static array or a function resolved with the live `ctx` when the component is selected. */\n  variants?: Ctxual<WindoVariant<Props>[], State>\n  /** Authored documentation table (not derived from the schema). Either a static array or a function resolved with the live `ctx` when the component is selected. */\n  props?: Ctxual<WindoPropDoc[], State>\n  /** Optional authored code snippet for the Code tab, resolved with the JSON-editable values and the live `ctx`. */\n  code?: (values: Props, ctx: WindoRenderContext<State>) => 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, Tags extends readonly string[] = readonly string[]> {\n  /** Configured groups keyed by slug. */\n  groups: Record<Groups[number]['slug'], WindoGroup>\n  contexts: Contexts\n  /** The config's declared tags, in declaration order. */\n  tags: Tags\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, Tags extends readonly string[] = readonly string[]> {\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  /** The set of tags components may be assigned. A component's `tags` must be drawn from this list; the sidebar filters by them. */\n  tags?: Tags\n  /** Initial shared state exposed on `ctx.ctxState`. Global across every component and persisted across selection — write it from any component via `ctx.setCtxState`. */\n  ctxState?: Record<string, unknown>\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  tags: 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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@westopp/windo",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Zero-infra component canvas — point it at *.windo.tsx files and get a resizable preview with live props, variants, and context",
   "license": "MIT",
   "type": "module",
@@ -57,7 +57,8 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "!src/**/*.test.*"
   ],
   "scripts": {
     "build": "tsup",

package/src/cli/index.ts

@@ -10,7 +10,7 @@ import pc from 'picocolors'
 import { build, createServer, preview } from 'vite'
 import { windoPlugin } from '../plugin'
 
-const VERSION = '0.1.0'
+const VERSION = '0.1.2'
 
 const USAGE = `
 ${pc.bold('windo')} ${pc.dim(`v${VERSION}`)} — zero-infra component canvas

package/src/client/App.tsx

@@ -11,7 +11,7 @@ import { useWindoBridge } from './bridge'
 import { Canvas } from './Canvas'
 import { Inspector } from './Inspector'
 import { Icons } from './icons'
-import type { CanvasGridOpts, ChromeEnv, InspectorPosition, ThemeMode } from './internal-types'
+import type { CanvasGridOpts, ChromeEnv, InspectorPosition, TagMatch, ThemeMode } from './internal-types'
 import { CANVAS_GRID_DEFAULTS } from './internal-types'
 import { loadJSON, loadString, saveJSON, saveString } from './persist'
 import { Sidebar } from './Sidebar'
@@ -33,6 +33,18 @@ function viewportName(width: number): 'mobile' | 'tablet' | 'desktop' {
   return width < 640 ? 'mobile' : width < 1024 ? 'tablet' : 'desktop'
 }
 
+// windo brand mark — red tile, yellow "wn". Fixed colours: brand, not themed.
+function WindoMark() {
+  return (
+    <svg className="wb-logo-mark" viewBox="0 0 32 32" width="22" height="22" aria-hidden="true" xmlns="http://www.w3.org/2000/svg">
+      <rect width="32" height="32" rx="9" fill="#d83a2e" />
+      <text x="16" y="22" textAnchor="middle" fontSize="16" fontWeight={800} fontFamily="system-ui, -apple-system, Helvetica, Arial, sans-serif" fill="#f5c518">
+        wn
+      </text>
+    </svg>
+  )
+}
+
 export function App() {
   const iframeRef = useRef<HTMLIFrameElement | null>(null)
   const bridge = useWindoBridge(iframeRef)
@@ -40,6 +52,11 @@ export function App() {
   const [theme, setTheme] = useState<ThemeMode>(() => loadString('windo:theme', 'light') as ThemeMode)
   const [selected, setSelected] = useState<string | null>(() => loadJSON<string | null>('windo:selected', null))
   const [query, setQuery] = useState('')
+  const [selectedTags, setSelectedTags] = useState<string[]>(() => {
+    const raw = loadJSON<unknown>('windo:tags', [])
+    return Array.isArray(raw) ? raw.filter((t): t is string => typeof t === 'string') : []
+  })
+  const [tagMatch, setTagMatch] = useState<TagMatch>(() => (loadJSON<unknown>('windo:tag-match', 'any') === 'all' ? 'all' : 'any'))
   const [navCollapsed, setNavCollapsed] = useState(() => loadJSON<boolean>('windo:nav-collapsed', false))
   const [inspCollapsed, setInspCollapsed] = useState(() => loadJSON<boolean>('windo:insp-collapsed', false))
   const inspectorPosition: InspectorPosition = 'right'
@@ -50,6 +67,14 @@ export function App() {
   const [grid, setGridState] = useState<CanvasGridOpts>(() => loadJSON<CanvasGridOpts>('windo:grid', CANVAS_GRID_DEFAULTS))
   const [env, setEnv] = useState<ChromeEnv>(() => ({ ...loadJSON<ChromeEnv>('windo:env', DEFAULT_ENV), colorScheme: loadString('windo:theme', 'light') as ThemeMode }))
 
+  // Shared, cross-component state. The chrome holds the canonical, persisted copy;
+  // the preview owns a working copy it can write from any component. They stay in
+  // sync via the bridge: component writes echo up (adopted below), chrome edits and
+  // reload re-syncs push down.
+  const [ctxState, setCtxState] = useState<Record<string, unknown>>(() => loadJSON<Record<string, unknown>>('windo:ctx-state', {}))
+  const ctxStateRef = useRef(ctxState)
+  ctxStateRef.current = ctxState
+
   const [draftById, setDraftById] = useState<Record<string, string>>({})
   // Last JSON pushed to the preview, per id. `dirty` = draft differs from this.
   // Every push (seed, save, reset, variant, reload re-sync) updates it, so the
@@ -78,6 +103,8 @@ export function App() {
     saveString('windo:theme', theme)
   }, [theme])
   useEffect(() => saveJSON('windo:selected', selected), [selected])
+  useEffect(() => saveJSON('windo:tags', selectedTags), [selectedTags])
+  useEffect(() => saveJSON('windo:tag-match', tagMatch), [tagMatch])
   useEffect(() => saveJSON('windo:nav-collapsed', navCollapsed), [navCollapsed])
   useEffect(() => saveJSON('windo:insp-collapsed', inspCollapsed), [inspCollapsed])
   useEffect(() => saveJSON('windo:width', width), [width])
@@ -85,6 +112,7 @@ export function App() {
   useEffect(() => saveJSON('windo:zoom', zoom), [zoom])
   useEffect(() => saveJSON('windo:grid', grid), [grid])
   useEffect(() => saveJSON('windo:env', env), [env])
+  useEffect(() => saveJSON('windo:ctx-state', ctxState), [ctxState])
 
   // ── selection wiring ───────────────────────────────────────────────────
   useEffect(() => {
@@ -124,6 +152,33 @@ export function App() {
     bridge.setEnv(next)
   }, [env, width, height, theme, bridge.setEnv, bridge.readyNonce])
 
+  // ── shared state (ctxState) sync ──────────────────────────────────────────
+  // Seed the canonical from the config defaults, filling only keys the chrome
+  // hasn't already persisted (persisted edits win).
+  useEffect(() => {
+    if (!Object.keys(bridge.ctxStateDefaults).length) return
+    setCtxState(prev => ({ ...bridge.ctxStateDefaults, ...prev }))
+  }, [bridge.ctxStateDefaults])
+
+  // Adopt component-driven writes echoed up from the preview (preview is the live
+  // truth for those). The chrome's own pushes don't echo, so this never loops.
+  useEffect(() => {
+    if (!Object.keys(bridge.ctxState).length) return
+    setCtxState(prev => ({ ...prev, ...bridge.ctxState }))
+  }, [bridge.ctxState])
+
+  // Re-sync the canonical down on every (re)ready — the iframe reloads on HMR and
+  // re-seeds from config defaults, so we re-assert the persisted shared state.
+  useEffect(() => {
+    if (Object.keys(ctxStateRef.current).length) bridge.setCtxState(ctxStateRef.current)
+  }, [bridge.setCtxState, bridge.readyNonce])
+
+  // Follow a component's `toggleTheme`/`setColorScheme` push (depends only on the
+  // echo, never on `theme` — so a topbar toggle is never reverted by a stale echo).
+  useEffect(() => {
+    if (bridge.colorScheme) setTheme(bridge.colorScheme.value)
+  }, [bridge.colorScheme])
+
   // ── draft commit / variant ─────────────────────────────────────────────
   function setValuesJson(json: string) {
     if (!selected) return
@@ -177,6 +232,14 @@ export function App() {
     }))
   }
 
+  // Edit one key of the shared state from the chrome: update the canonical and
+  // push the whole object down (the preview adopts it without echoing back).
+  function setCtxStateValue(key: string, value: unknown) {
+    const next = { ...ctxStateRef.current, [key]: value }
+    setCtxState(next)
+    bridge.setCtxState(next)
+  }
+
   function setGrid(patch: Partial<CanvasGridOpts> | null) {
     if (patch === null) {
       setGridState(CANVAS_GRID_DEFAULTS)
@@ -257,6 +320,8 @@ export function App() {
       logs={bridge.logs}
       clearLogs={bridge.clearLogs}
       state={stateForEntry}
+      ctxState={ctxState}
+      setCtxStateValue={setCtxStateValue}
       contexts={contextsForEntry}
       env={env}
       setEnv={setEnvPatch}
@@ -272,7 +337,7 @@ export function App() {
     <div className="wb-app" style={accentVars} data-screen-label="Workbench">
       <header className="wb-topbar">
         <span className="wb-logo">
-          <span className="wb-logo-mark">{title.charAt(0).toUpperCase()}</span>
+          <WindoMark />
           {title}
           <span className="wb-logo-sub">/ Workbench</span>
         </span>
@@ -290,7 +355,21 @@ export function App() {
       </header>
 
       <div className="wb-main">
-        <Sidebar groups={bridge.groups} manifest={bridge.manifest} selected={selected} onSelect={setSelected} query={query} setQuery={setQuery} collapsed={navCollapsed} onToggle={toggleNav} />
+        <Sidebar
+          groups={bridge.groups}
+          tags={bridge.tags}
+          manifest={bridge.manifest}
+          selected={selected}
+          onSelect={setSelected}
+          query={query}
+          setQuery={setQuery}
+          selectedTags={selectedTags}
+          setSelectedTags={setSelectedTags}
+          tagMatch={tagMatch}
+          setTagMatch={setTagMatch}
+          collapsed={navCollapsed}
+          onToggle={toggleNav}
+        />
         <div className="wb-center">
           {inspectorRight ? (
             <div className="wb-center-row">

package/src/client/Canvas.tsx

@@ -156,7 +156,7 @@ function ResizeHandle({
   }
 
   // biome-ignore lint/a11y/noStaticElementInteractions: drag handle is pointer-only by design
-  return <div className={`wb-handle${dragging ? ' dragging' : ''}`} title="Drag to resize width — double-click to fill" onDoubleClick={onReset} onPointerDown={onPointerDown} />
+  return <div className={`wb-handle${dragging ? ' dragging' : ''}`} title="Drag to resize width — double-click to toggle fill / mobile" onDoubleClick={onReset} onPointerDown={onPointerDown} />
 }
 
 function HeightHandle({ height, setHeight, zoom, onReset }: { height: number; setHeight: (h: number) => void; zoom: number; onReset: () => void }) {
@@ -296,6 +296,11 @@ export function Canvas(props: CanvasProps) {
   const mode = theme === 'dark' ? grid.dark : grid.light
   const bp = breakpointFor(clamped)
 
+  // Double-clicking a width handle fills the stage; if already filled, it drops
+  // to the mobile preset so the gesture toggles between the two extremes.
+  const mobileWidth = PRESETS.find(p => p.id === 'mobile')?.width ?? MIN_WIDTH
+  const toggleFillWidth = () => setWidth(clamped >= maxWidth - 2 ? Math.min(mobileWidth, maxWidth) : maxWidth)
+
   const gridClass = grid.on ? (grid.style === 'lines' ? ' grid-lines' : ' grid-dots') : ''
 
   const frameStyle = {
@@ -327,7 +332,7 @@ export function Canvas(props: CanvasProps) {
         <div className="wb-zoomwrap" style={{ transform: `scale(${zoom})` }}>
           <div className="wb-frame-col">
             <div className="wb-frame-row">
-              <ResizeHandle side="left" width={clamped} setWidth={setWidth} maxWidth={maxWidth} zoom={zoom} onReset={() => setWidth(maxWidth)} />
+              <ResizeHandle side="left" width={clamped} setWidth={setWidth} maxWidth={maxWidth} zoom={zoom} onReset={toggleFillWidth} />
               <div className="wb-framewrap">
                 <span className="wb-corner tl" />
                 <span className="wb-corner tr" />
@@ -344,7 +349,7 @@ export function Canvas(props: CanvasProps) {
                   </div>
                 </div>
               </div>
-              <ResizeHandle side="right" width={clamped} setWidth={setWidth} maxWidth={maxWidth} zoom={zoom} onReset={() => setWidth(maxWidth)} />
+              <ResizeHandle side="right" width={clamped} setWidth={setWidth} maxWidth={maxWidth} zoom={zoom} onReset={toggleFillWidth} />
             </div>
             <HeightHandle height={frameH} setHeight={setHeight} zoom={zoom} onReset={() => setHeight(null)} />
             <div className="wb-dim-readout">

package/src/client/Inspector.tsx

@@ -432,6 +432,40 @@ function formatStateValue(value: unknown): string {
   return out.length > 80 ? `${out.slice(0, 80)}…` : out
 }
 
+/* ---------- Shared (ctxState) strip: editable, global across components ---------- */
+
+// Infer the editor from the live value's type — ctxState carries no control
+// metadata (it's a plain object, like the `state` declaration), so primitives
+// get a fitting inline editor and anything richer falls back to a read-only chip.
+function CtxStateEditor({ value, onChange }: { value: unknown; onChange: (next: unknown) => void }) {
+  if (typeof value === 'boolean') {
+    return <button type="button" role="switch" aria-checked={value} className={`wb-switch${value ? ' on' : ''}`} onClick={() => onChange(!value)} />
+  }
+  if (typeof value === 'number') {
+    return <input type="number" className="wb-ctxstate-input" value={Number.isFinite(value) ? value : ''} onChange={e => onChange(e.target.valueAsNumber)} />
+  }
+  if (typeof value === 'string') {
+    return <input type="text" className="wb-ctxstate-input" value={value} onChange={e => onChange(e.target.value)} />
+  }
+  return <span className="v">{formatStateValue(value)}</span>
+}
+
+function CtxStateStrip({ ctxState, setCtxStateValue }: { ctxState: Record<string, unknown>; setCtxStateValue: InspectorProps['setCtxStateValue'] }) {
+  const keys = Object.keys(ctxState)
+  if (!keys.length) return null
+  return (
+    <div className="wb-ctxstate" title="Shared state (ctx.ctxState) — global across components, editable here or from any component">
+      <span className="wb-state-label">shared</span>
+      {keys.map(k => (
+        <span className="wb-state-item" key={k}>
+          <span className="k">{k}</span>
+          <CtxStateEditor value={ctxState[k]} onChange={next => setCtxStateValue(k, next)} />
+        </span>
+      ))}
+    </div>
+  )
+}
+
 function LogsStrip({ logs, clearLogs }: { logs: InspectorProps['logs']; clearLogs: InspectorProps['clearLogs'] }) {
   const recent = logs.slice(-50)
   return (
@@ -478,6 +512,8 @@ export function Inspector(props: InspectorProps) {
     logs,
     clearLogs,
     state,
+    ctxState,
+    setCtxStateValue,
     contexts,
     env,
     setEnv,
@@ -562,6 +598,7 @@ export function Inspector(props: InspectorProps) {
           ))}
         </div>
       )}
+      <CtxStateStrip ctxState={ctxState} setCtxStateValue={setCtxStateValue} />
       <div className="wb-inspector-body">
         {tab === 'Controls' && (
           <ControlsTab