@vscode/component-explorer 0.2.1-6 → 0.2.1-60

package/README.md

@@ -1,6 +1,6 @@
 # @vscode/component-explorer
 
-Core library for the [Component Explorer](../../README.md). Contains the fixture API, property schemas, fixture registry, and the Explorer React UI.
+Core library for the [Component Explorer](../../README.md). Contains the fixture API, input schemas, fixture registry, and the Explorer React UI.
 
 ## Fixture API
 
@@ -10,46 +10,54 @@ Defines a single component fixture.
 
 ```tsx
 import { defineFixture } from '@vscode/component-explorer';
+import { z } from 'zod';
 
 export default defineFixture({
-  properties: [
-    { type: 'string', name: 'label', defaultValue: 'Click me' },
-    { type: 'boolean', name: 'disabled', defaultValue: false },
-  ],
-  render: (container, props) => {
+  inputSchema: z.object({
+    label: z.string().default('Click me'),
+    disabled: z.boolean().default(false),
+  }),
+  render: (container, { input }) => {
     const root = createRoot(container);
-    root.render(<Button label={props.label as string} disabled={props.disabled as boolean} />);
+    root.render(<Button label={input.label} disabled={input.disabled} />);
     return { dispose: () => root.unmount() };
   },
 });
 ```
 
+The `inputSchema` is a [zod](https://zod.dev) schema. It is converted to JSON Schema at define
+time, and `input` (typed as `z.infer<typeof schema>`) is populated with the schema's defaults
+plus any overrides set in the explorer's properties panel.
+
 Options:
 
 | Option | Type | Default | Description |
 |---|---|---|---|
-| `render` | `(container, props) => Disposable` | **(required)** | Renders the component. Must return `{ dispose() }` for cleanup. |
-| `properties` | `PropertySchema[]` | `[]` | Configurable properties shown in the properties panel. |
+| `render` | `(container, context) => Disposable` | **(required)** | Renders the component. Must return `{ dispose() }` for cleanup. |
+| `inputSchema` | `z.ZodType` | — | Zod schema describing `input`. Drives the properties panel controls. |
 | `isolation` | `'shadow-dom' \| 'iframe'` | `'shadow-dom'` | Component isolation strategy. |
 | `displayMode` | `DisplayMode` | `{ type: 'component' }` | `'component'` for natural size, or `'page'` with viewport presets. |
 | `styles` | `StyleDefinition[]` | — | Stylesheets injected into the shadow root (shadow-dom isolation only). |
 | `background` | `'light' \| 'dark'` | `'light'` | Preview canvas background pattern. |
 | `description` | `string` | — | Documentation description. |
 
-### `defineFixtureGroup(entries)`
+### `defineFixtureGroup(entries)` / `defineFixtureGroup(options, entries)`
 
-Groups multiple fixtures (supports nesting):
+Groups multiple fixtures (supports nesting). An optional first argument can declare an
+`inputSchema` shared by — and merged into — every descendant fixture, so common input (e.g. a
+`theme` switch) is declared once for the whole group:
 
 ```tsx
 import { defineFixture, defineFixtureGroup } from '@vscode/component-explorer';
+import { z } from 'zod';
 
-export default defineFixtureGroup({
-  Primary: defineFixture({ render: (c) => { /* ... */ } }),
-  Secondary: defineFixture({ render: (c) => { /* ... */ } }),
-  Nested: defineFixtureGroup({
-    Small: defineFixture({ render: (c) => { /* ... */ } }),
-  }),
-});
+export default defineFixtureGroup(
+  { inputSchema: z.object({ theme: z.enum(['light', 'dark']).default('dark') }) },
+  {
+    Primary: defineFixture({ render: (c) => { /* ... */ } }),
+    Secondary: defineFixture({ render: (c) => { /* ... */ } }),
+  },
+);
 ```
 
 ### `defineFixtureVariants(variants)`
@@ -66,16 +74,21 @@ defineFixtureVariants({
 });
 ```
 
-## Property Types
+## Input Schemas
+
+Fixture `input` is described with a [zod](https://zod.dev) schema (`inputSchema`). The explorer
+converts it to JSON Schema and renders a control per property in the properties panel:
 
-| Type | Fields | Description |
-|---|---|---|
-| `boolean` | `name`, `defaultValue` | Toggle checkbox |
-| `string` | `name`, `defaultValue`, `multiline?` | Text input (or textarea) |
-| `number` | `name`, `defaultValue`, `min?`, `max?`, `step?` | Number input with optional range |
-| `enum` | `name`, `defaultValue`, `options` | Dropdown select |
+| Zod type | Control |
+|---|---|
+| `z.boolean()` | Toggle checkbox |
+| `z.string()` | Text input |
+| `z.number()` / `z.int()` | Number input |
+| `z.enum([...])` | Dropdown select |
 
-All property types support an optional `description` field.
+Use `.default(...)` to set the initial value and `.describe(...)` to document a property. When
+multiple rendered fixtures share a property of the same name and schema, the panel exposes a
+single control that edits them all at once.
 
 ## Explorer UI Components
 
@@ -96,7 +109,6 @@ The package exports the full Explorer UI as React components:
 |---|---|
 | `FixtureRegistry` | Observable registry of discovered fixtures. |
 | `createFixtureTree` | Builds a `FixtureNode` tree from registered fixtures. |
-| `getDefaultPropertyValues` | Extracts default values from a `PropertySchema[]`. |
 | `VIEWPORT_SIZES` | Built-in viewport preset dimensions (`mobile`, `tablet`, `desktop`). |
 
 ## Styles

package/dist/components/ExplorerModel.d.ts

@@ -1,5 +1,5 @@
 import { IReader } from '@vscode/observables';
-import { FixtureRegistry, ComponentDefinition } from '../core/index.js';
+import { FixtureRegistry, ComponentDefinition, FixtureInputStore } from '../core/index.js';
 import { ExplorerTreeNode } from './types.js';
 import { DaemonModel } from '../daemon/index.js';
 import { ReportModel } from '../report/ReportModel.js';
@@ -72,6 +72,10 @@ export declare class ExplorerModel extends ExplorerModel_base {
     readonly selectedNode: import('@vscode/observables').IObservableWithChange<ExplorerTreeNode | undefined, void>;
     /** List of preview rows to render based on current selection and view mode */
     readonly selectedFixtures: import('@vscode/observables').IObservableWithChange<readonly PreviewRow[], void>;
+    /** Shared store of per-fixture `input` overrides, edited via the properties panel. */
+    readonly inputStore: FixtureInputStore;
+    /** Flattened list of the live fixtures currently shown in the preview area. */
+    readonly renderedFixtures: import('@vscode/observables').IObservableWithChange<readonly FixtureItem[], void>;
     setViewMode: (mode: ViewMode) => void;
     navigateToSession: (sessionName: string) => void;
     toggleLeftSidebar: () => void;

package/dist/components/ExplorerModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExplorerModel.d.ts","sourceRoot":"","sources":["../../src/components/ExplorerModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ExplorerModel.d.ts","sourceRoot":"","sources":["../../src/components/ExplorerModel.ts"],"names":[],"mappings":"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"}

package/dist/components/FixturePreviewItem.d.ts

@@ -1,8 +1,10 @@
+import { FixtureInputStore } from '../core/index.js';
 import { FixtureItem } from './ExplorerModel.js';
 import * as React from 'react';
 export declare const FixturePreviewItem: React.ComponentType<{
     fixture: FixtureItem;
     compact: boolean | undefined;
     onSelect: ((nodeId: string) => void) | undefined;
+    inputStore: FixtureInputStore | undefined;
 } & {} & {} & {}>;
 //# sourceMappingURL=FixturePreviewItem.d.ts.map

package/dist/components/FixturePreviewItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FixturePreviewItem.d.ts","sourceRoot":"","sources":["../../src/components/FixturePreviewItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAwFtD,eAAO,MAAM,kBAAkB;;;wBA9EE,MAAM,KAAK,IAAI;iBAqH/C,CAAC"}
+{"version":3,"file":"FixturePreviewItem.d.ts","sourceRoot":"","sources":["../../src/components/FixturePreviewItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA6HtD,eAAO,MAAM,kBAAkB;;;wBA1GE,MAAM,KAAK,IAAI;;iBA0J/C,CAAC"}

package/dist/components/PreviewArea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PreviewArea.d.ts","sourceRoot":"","sources":["../../src/components/PreviewArea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,oBAAoB,CAAC;AAqbpE,eAAO,MAAM,WAAW;;iBAmGvB,CAAC"}
+{"version":3,"file":"PreviewArea.d.ts","sourceRoot":"","sources":["../../src/components/PreviewArea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,oBAAoB,CAAC;AAsbpE,eAAO,MAAM,WAAW;;iBAmGvB,CAAC"}

package/dist/components/RightSidebar.d.ts

@@ -1,6 +1,12 @@
-import { ExplorerTreeNode } from './types.js';
+import { ExplorerModel } from './ExplorerModel.js';
 import * as React from 'react';
+/**
+ * Properties panel: aggregates the input schemas of every fixture currently rendered in the
+ * preview area and presents one control per shared property. Editing a control updates the
+ * `input` of all fixtures that declare that property (same name + schema), so common values
+ * like a theme can be switched across the whole view at once.
+ */
 export declare const RightSidebar: React.ComponentType<import('@vscode/observables-react').PropsIn<{
-    selectedNode: import('@vscode/observables-react').IPropertyTransformerFactory<ExplorerTreeNode | undefined, ExplorerTreeNode | undefined>;
+    model: import('@vscode/observables-react').IPropertyTransformerFactory<ExplorerModel, ExplorerModel>;
 }>>;
 //# sourceMappingURL=RightSidebar.d.ts.map

package/dist/components/RightSidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RightSidebar.d.ts","sourceRoot":"","sources":["../../src/components/RightSidebar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA8GnD,eAAO,MAAM,YAAY;;GAqBxB,CAAC"}
+{"version":3,"file":"RightSidebar.d.ts","sourceRoot":"","sources":["../../src/components/RightSidebar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAiJxD;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;GAqCxB,CAAC"}

package/dist/core/ComponentRenderer.d.ts

@@ -1,11 +1,12 @@
 import { ComponentDefinition } from './fixtureApiConsumer.js';
-import { RenderResult } from './fixtureApi.js';
+import { RenderHost, RenderResult } from './fixtureApi.js';
 import { ExceptionError } from './ErrorInfo.js';
-export interface ComponentRenderingOptions {
-    onError?: (error: ExceptionError) => void;
-}
+/** Maximum time a fixture render may take before it is reported as failed. */
+export declare const RENDER_TIMEOUT_MS = 3000;
 export declare class ComponentRendering {
     readonly component: ComponentDefinition;
+    private readonly _renderHost;
+    private readonly _input?;
     readonly renderTarget: HTMLElement;
     readonly iframe: HTMLIFrameElement | null;
     private readonly _abortController;
@@ -13,13 +14,10 @@ export declare class ComponentRendering {
     private _injectedElements;
     private _adoptedSheets;
     private _styleTarget;
+    private readonly _disposables;
     private readonly _rendered;
-    private readonly _onError?;
-    private _errorReported;
-    error: ExceptionError | undefined;
-    constructor(host: HTMLElement, component: ComponentDefinition, options?: ComponentRenderingOptions);
-    private _reportError;
+    constructor(host: HTMLElement, component: ComponentDefinition, _renderHost?: RenderHost, _input?: unknown | undefined);
     waitForRendering(): Promise<RenderResult | undefined>;
-    dispose(): void;
+    dispose(): Promise<readonly ExceptionError[]>;
 }
 //# sourceMappingURL=ComponentRenderer.d.ts.map

package/dist/core/ComponentRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentRenderer.d.ts","sourceRoot":"","sources":["../../src/core/ComponentRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,gBAAgB,CAAC;AAItE,MAAM,WAAW,yBAAyB;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC1C;AA0CD,qBAAa,kBAAkB;IAcC,QAAQ,CAAC,SAAS,EAAE,mBAAmB;IAbtE,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAkC;IAC5D,OAAO,CAAC,cAAc,CAAS;IAE/B,KAAK,EAAE,cAAc,GAAG,SAAS,CAAa;gBAElC,IAAI,EAAE,WAAW,EAAW,SAAS,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAmG3G,OAAO,CAAC,YAAY;IAOd,gBAAgB,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAM3D,OAAO,IAAI,IAAI;CAMf"}
+{"version":3,"file":"ComponentRenderer.d.ts","sourceRoot":"","sources":["../../src/core/ComponentRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,EAAe,UAAU,EAAE,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,gBAAgB,CAAC;AAItE,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,OAAO,CAAC;AA8CtC,qBAAa,kBAAkB;IAa7B,QAAQ,CAAC,SAAS,EAAE,mBAAmB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAdzB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,eAAe,CAAuD;IAC9E,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;gBAG7D,IAAI,EAAE,WAAW,EACR,SAAS,EAAE,mBAAmB,EACtB,WAAW,GAAE,UAAqD,EAClE,MAAM,CAAC,EAAE,OAAO,YAAA;IA8H5B,gBAAgB,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAmB3D,OAAO,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;CA8C7C"}

package/dist/core/ErrorInfo.d.ts

@@ -6,15 +6,35 @@ export type RenderEventType = 'console.error' | 'console.warn' | 'console.log' |
 export interface RenderEvent {
     readonly type: RenderEventType;
     readonly message: string;
+    readonly stack?: string;
+}
+/**
+ * Errors and events captured while disposing a fixture (the implicit dispose
+ * that runs before a new render, or the explicit one triggered by
+ * `disposeAfter` / `disposeCurrentFixture()`).
+ */
+export interface DisposeReport {
+    readonly hasError: boolean;
+    /** Errors thrown by `dispose()` calls (RenderResult.dispose, addDisposable disposables). */
+    readonly errors: readonly ExceptionError[];
+    /** Console / window error events fired during the dispose call. */
+    readonly events: readonly RenderEvent[];
 }
 export interface RenderReport {
     readonly hasError: boolean;
     readonly error?: ExceptionError;
     readonly events: RenderEvent[];
-    readonly resultData?: unknown;
+    /** Output data the fixture provided via `RenderResult.output` (counterpart of `RenderContext.input`). */
+    readonly output?: unknown;
     readonly renderTimeMs: {
         readonly sync: number;
         readonly total: number;
     };
+    /**
+     * Errors / events captured while disposing the previous fixture (the implicit
+     * dispose that runs at the start of `renderFixture`). Present only if the
+     * dispose actually surfaced something.
+     */
+    readonly previousDispose?: DisposeReport;
 }
 //# sourceMappingURL=ErrorInfo.d.ts.map

package/dist/core/ErrorInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorInfo.d.ts","sourceRoot":"","sources":["../../src/core/ErrorInfo.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,2BAA2B,CAAC;AAE9H,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE"}
+{"version":3,"file":"ErrorInfo.d.ts","sourceRoot":"","sources":["../../src/core/ErrorInfo.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,2BAA2B,CAAC;AAE9H,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAC/B,yGAAyG;IACzG,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;CACzC"}

package/dist/core/FixtureInputStore.d.ts

@@ -0,0 +1,32 @@
+import { IObservable, IReader } from '@vscode/observables';
+import { IJsonSchema } from './fixtureApi.js';
+/** A fixture's input override object (only the keys the user explicitly changed). */
+export type FixtureInputOverride = Record<string, unknown>;
+/**
+ * Central store of `input` overrides for the explorer UI.
+ *
+ * Values are keyed by **property identity** (name + structural schema), not by fixture, so a
+ * value chosen on one fixture is automatically reused by every other fixture that declares the
+ * same input — navigating between fixtures keeps the shared value instead of resetting it.
+ * The whole map is persisted to `localStorage` so choices survive reloads. Schema defaults are
+ * applied at render time (see `applyInputDefaults`); only explicit overrides are stored here.
+ */
+export declare class FixtureInputStore {
+    /** Shared values keyed by `inputPropertyKey(name, schema)`. */
+    private readonly _values;
+    /** Cache of derived per-fixture override observables. */
+    private readonly _byFixture;
+    constructor();
+    /**
+     * Returns a derived observable of `fixtureId`'s input overrides, mapped from the shared
+     * per-property store. Only properties the user explicitly set (across any fixture) appear.
+     */
+    getInput(fixtureId: string, schema: IJsonSchema | undefined): IObservable<FixtureInputOverride>;
+    /** The currently effective value of a shared property: explicit override, else schema default. */
+    readValue(reader: IReader, name: string, schema: IJsonSchema): unknown;
+    /** Sets a shared input property (applies to every fixture that declares it) and persists. */
+    setValue(name: string, schema: IJsonSchema, value: unknown): void;
+    private _load;
+    private _persist;
+}
+//# sourceMappingURL=FixtureInputStore.d.ts.map

package/dist/core/FixtureInputStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixtureInputStore.d.ts","sourceRoot":"","sources":["../../src/core/FixtureInputStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,qFAAqF;AACrF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAI3D;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC1B,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IACvE,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwD;;IAMnF;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC,oBAAoB,CAAC;IAuB/F,kGAAkG;IAClG,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO;IAStE,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAOjE,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,QAAQ;CAOnB"}

package/dist/core/FixtureNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FixtureNode.d.ts","sourceRoot":"","sources":["../../src/core/FixtureNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAKL,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA8C/C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IAEzB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;IAEnD,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAE3C,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEzC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAEnC,0GAA0G;IAC1G,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,WAAW,CA8BnF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,GAC5D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAYrC;AAsID;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,SAAS,CAezF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,EAAE,CAU1E"}
+{"version":3,"file":"FixtureNode.d.ts","sourceRoot":"","sources":["../../src/core/FixtureNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA8C/C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IAEzB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;IAEnD,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAE3C,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEzC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAEnC,0GAA0G;IAC1G,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,WAAW,CA8BnF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,GAC5D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAYrC;AAyID;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,SAAS,CAezF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,EAAE,CAU1E"}

package/dist/core/fixtureApi.d.ts

@@ -1,23 +1,12 @@
-/**
- * Public Fixture API
- *
- * This module is the public API for defining fixtures.
- * It's designed to be stable across versions - projects can use a different
- * @vscode/component-explorer version than the explorer viewer uses.
- *
- * Use Symbol.for() instead of Symbol() so the same symbol is shared across
- * different versions of this package.
- *
- * @module fixtureApi
- */
+import { z } from 'zod';
 /**
  * Disposable resource that can be cleaned up.
+ * `dispose` may be sync or async; the framework awaits the returned promise (if any)
+ * and captures any thrown errors.
  */
 export interface IDisposable {
-    dispose(): void;
+    dispose(): void | Promise<void>;
 }
-/** @deprecated Use IDisposable instead */
-export type Disposable = IDisposable;
 /**
  * Result of a render operation.
  * Supports both sync and async rendering with cancellation.
@@ -32,14 +21,20 @@ export interface RenderResult {
     readonly ready?: Promise<void>;
     /**
      * Cleanup function. Called when the fixture is unmounted.
+     * May be sync or async; the framework awaits the returned promise (if any).
+     * Errors thrown (sync or async) are captured and surfaced via the
+     * `previousDispose` field of the next render report (or `currentDispose`
+     * if `disposeAfter` was requested).
      * Can be omitted if no cleanup is needed.
      */
-    dispose?(): void;
+    dispose?(): void | Promise<void>;
     /**
      * Arbitrary data to include in the render report.
-     * Visible to the CLI and MCP tools.
+     * Visible to the CLI and MCP tools (surfaced as `output`).
+     *
+     * Symmetric counterpart of `RenderContext.input`: input flows in, output flows out.
      */
-    readonly data?: unknown;
+    readonly output?: unknown;
 }
 /**
  * What the render function can return.
@@ -50,11 +45,57 @@ export interface RenderResult {
 export type RenderReturn = RenderResult | undefined | void | Promise<RenderResult | undefined | void>;
 /**
  * Context passed to the render function.
+ *
+ * @typeParam TInput - Shape of `input`, inferred from the fixture's zod `inputSchema`
+ *   (defaults to `unknown` when no schema is declared).
  */
-export interface RenderContext {
+export interface RenderContext<TInput = unknown> {
+    /**
+     * Unique identifier of the fixture being rendered.
+     * Stable across renders of the same fixture; useful for keying caches,
+     * logging, or distinguishing between sibling fixtures sharing a render function.
+     */
+    readonly fixtureId: string;
     /** AbortSignal for cancellation; check signal.aborted or listen to 'abort' event */
     readonly signal: AbortSignal;
+    /** Register a disposable to be cleaned up when the fixture is unmounted. Returns the same disposable for chaining. */
+    addDisposable<T extends IDisposable>(disposable: T): T;
+    /**
+     * Describes where this fixture is being rendered. Use this to enable dev-only affordances
+     * (e.g. extra controls, logging) without affecting screenshots or embedded views.
+     */
+    readonly host: RenderHost;
+    /**
+     * Data passed in by the caller (CLI/MCP screenshot tool, explorer UI). Use this to
+     * parameterize the fixture: e.g. switch theme, vary props, select a scenario.
+     *
+     * When the fixture declares a zod `inputSchema`, this is typed as `z.infer<typeof schema>`
+     * and populated with the schema's defaults for any keys the caller omitted. Without a
+     * schema it is `unknown` (and `undefined` when no input was provided).
+     *
+     * Symmetric with `RenderResult.output` (which flows back out to the caller).
+     */
+    readonly input: TInput;
+}
+/**
+ * Describes the environment a fixture is rendered in.
+ */
+export type RenderHost = 
+/** Rendered in the Component Explorer UI (visible to a human). */
+{
+    readonly kind: 'explorer-ui';
+    readonly interactive: true;
 }
+/** Headless render for CLI/MCP screenshots. */
+ | {
+    readonly kind: 'headless';
+    readonly interactive: false;
+}
+/** Rendered inside an isolation iframe (user-facing standalone view). */
+ | {
+    readonly kind: 'embedded';
+    readonly interactive: false;
+};
 /**
  * Style definition for shadow DOM injection.
  */
@@ -94,6 +135,36 @@ export type ViewportPreset = ViewportPresetName | {
     readonly height: number;
 };
 export type ViewportPresetName = 'mobile' | 'tablet' | 'desktop';
+/**
+ * Minimal JSON Schema interface used to describe a fixture's expected `input` shape.
+ *
+ * This is the *derived* form: fixtures declare their input with a zod schema
+ * (`DefineFixtureOptions.inputSchema`) and the framework converts it to this JSON Schema
+ * at define time. Tools (CLI/MCP/explorer UI) read it for validation, autocompletion, or
+ * to generate input-editing controls.
+ *
+ * Intentionally a structural, recursive type covering the subset of JSON Schema we
+ * actually surface to tools — the index signature lets any additional standard JSON Schema
+ * keywords (`format`, `pattern`, `oneOf`, `$ref`, …) flow through without changing this interface.
+ */
+export interface IJsonSchema {
+    readonly type?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+    readonly properties?: {
+        readonly [key: string]: IJsonSchema;
+    };
+    readonly required?: readonly string[];
+    readonly items?: IJsonSchema;
+    readonly enum?: readonly unknown[];
+    readonly const?: unknown;
+    readonly default?: unknown;
+    readonly description?: string;
+    readonly title?: string;
+    readonly additionalProperties?: boolean | IJsonSchema;
+    readonly anyOf?: readonly IJsonSchema[];
+    readonly oneOf?: readonly IJsonSchema[];
+    readonly allOf?: readonly IJsonSchema[];
+    readonly [key: string]: unknown;
+}
 /** Brand symbol to identify single fixtures */
 export declare const singleFixtureBrand: unique symbol;
 /** Brand symbol to identify fixture groups */
@@ -102,8 +173,10 @@ export declare const fixtureGroupBrand: unique symbol;
 export declare const fixtureVariantsBrand: unique symbol;
 /**
  * Options for defining a single component fixture.
+ *
+ * @typeParam TInput - Shape of the fixture's `input`, inferred from `inputSchema`.
  */
-export interface DefineFixtureOptions {
+export interface DefineFixtureOptions<TInput = unknown> {
     /**
      * Path in the explorer tree.
      * - `undefined` (default): use fixture filename only
@@ -127,14 +200,35 @@ export interface DefineFixtureOptions {
     labels?: readonly string[];
     /** Human/AI-readable description(s) of expected visual appearance. Inherited from parent group/variants and accumulated into a string[]. */
     expectedVisualDescriptions?: string | readonly string[];
+    /**
+     * Zod schema describing the expected shape of `RenderContext.input`.
+     *
+     * Declaring it gives two things:
+     *  1. **Type safety** — `render`'s `context.input` is typed as `z.infer<typeof schema>`.
+     *  2. **Tooling** — the framework converts the schema to JSON Schema at define time so the
+     *     CLI/MCP/explorer UI can validate, autocomplete, or render input-editing controls.
+     *
+     * The schema must describe an object (`z.object({...})`) — `input` is always a JSON object
+     * (or `undefined`). Property-level `.default(...)` values are surfaced to tooling and used
+     * to populate omitted keys before `render` runs.
+     *
+     * @example
+     * ```ts
+     * inputSchema: z.object({
+     *   theme: z.enum(['light', 'dark']).default('light'),
+     *   count: z.number().int().default(1),
+     * })
+     * ```
+     */
+    inputSchema?: z.ZodType<TInput>;
     /**
      * Render the component into the container.
      *
      * @param container - The DOM element to render into
-     * @param context - Render context containing props and abort signal
+     * @param context - Render context containing input and abort signal
      * @returns Optional RenderResult, or a Promise that resolves to one
      */
-    render: (container: HTMLElement, context: RenderContext) => RenderReturn;
+    render: (container: HTMLElement, context: RenderContext<TInput>) => RenderReturn;
 }
 /** @deprecated Use DefineFixtureOptions instead */
 export type DefineComponentOptions = DefineFixtureOptions;
@@ -145,6 +239,8 @@ export interface SingleFixtureExport {
     readonly [singleFixtureBrand]: true;
     readonly _options: DefineFixtureOptions;
     readonly _path?: string;
+    /** JSON Schema derived from `_options.inputSchema` at define time (cross-version safe). */
+    readonly _inputSchemaJson?: IJsonSchema;
 }
 /**
  * Group entry: either a single fixture, a nested group, or variants.
@@ -161,6 +257,8 @@ export interface FixtureGroupExport {
     readonly _path?: string;
     readonly _labels?: readonly string[];
     readonly _expectedVisualDescriptions?: string | readonly string[];
+    /** JSON Schema derived from the group's `inputSchema`; merged into every descendant fixture. */
+    readonly _inputSchemaJson?: IJsonSchema;
 }
 /**
  * A fixture variants export created by defineFixtureVariants().
@@ -173,6 +271,8 @@ export interface FixtureVariantsExport {
     readonly _path?: string;
     readonly _labels?: readonly string[];
     readonly _expectedVisualDescriptions?: string | readonly string[];
+    /** JSON Schema derived from the variants group's `inputSchema`; merged into every variant. */
+    readonly _inputSchemaJson?: IJsonSchema;
 }
 /**
  * Fixture export type - a single fixture, a group, or variants.
@@ -199,6 +299,13 @@ export interface DefineFixtureGroupOptions {
     labels?: readonly string[];
     /** Human/AI-readable description(s) of expected visual appearance. Inherited by nested fixtures. */
     expectedVisualDescriptions?: string | readonly string[];
+    /**
+     * Zod schema describing `input` shared by every fixture in this group. It is converted to
+     * JSON Schema at define time and merged into each descendant fixture's own schema (the
+     * descendant's properties win on conflict). Use it to declare common input — e.g. a `theme`
+     * switch — once for a whole group instead of repeating it on each fixture.
+     */
+    inputSchema?: z.ZodType;
 }
 /**
  * Input for defineFixtureVariants (only single fixtures, no nesting).
@@ -221,6 +328,12 @@ export interface DefineFixtureVariantsOptions {
     labels?: readonly string[];
     /** Human/AI-readable description(s) of expected visual appearance. Inherited by nested fixtures. */
     expectedVisualDescriptions?: string | readonly string[];
+    /**
+     * Zod schema describing `input` shared by every variant in this group. Converted to JSON
+     * Schema at define time and merged into each variant's own schema (the variant's properties
+     * win on conflict).
+     */
+    inputSchema?: z.ZodType;
 }
 /**
  * Defines a single fixture.
@@ -229,31 +342,33 @@ export interface DefineFixtureVariantsOptions {
  * ```ts
  * // Simple - no cleanup needed
  * export default defineFixture({
- *   render: (container, { props }) => {
- *     container.innerHTML = `<button>${props.label}</button>`;
+ *   render: (container) => {
+ *     container.innerHTML = `<button>Click me</button>`;
  *   },
  * });
  *
- * // With cleanup
+ * // Typed, parameterizable input via a zod schema
  * export default defineFixture({
- *   render: (container, { props }) => {
+ *   inputSchema: z.object({ label: z.string().default('Click me') }),
+ *   render: (container, { input }) => {
  *     const root = createRoot(container);
- *     root.render(<Button label={props.label} />);
+ *     root.render(<Button label={input.label} />);
  *     return { dispose: () => root.unmount() };
  *   },
  * });
  *
  * // Async render
  * export default defineFixture({
- *   render: async (container, { props, signal }) => {
- *     const data = await fetch(props.url, { signal });
+ *   inputSchema: z.object({ url: z.string() }),
+ *   render: async (container, { input, signal }) => {
+ *     const data = await fetch(input.url, { signal });
  *     container.innerHTML = await data.text();
  *     return { dispose: () => { container.innerHTML = ''; } };
  *   },
  * });
  * ```
  */
-export declare function defineFixture(options: DefineFixtureOptions): SingleFixtureExport;
+export declare function defineFixture<TInput = unknown>(options: DefineFixtureOptions<TInput>): SingleFixtureExport;
 /**
  * Defines a group of fixtures with support for nesting.
  *
@@ -298,9 +413,9 @@ export declare function defineFixtureVariants(options: DefineFixtureVariantsOpti
  *
  * @example
  * ```ts
- * render: (container, { props }) => syncRender(() => {
+ * render: (container, { input }) => syncRender(() => {
  *   const el = document.createElement('button');
- *   el.textContent = props.label;
+ *   el.textContent = input.label;
  *   container.appendChild(el);
  *   return () => el.remove();
  * })
@@ -317,8 +432,8 @@ export declare function syncRender(doRender: () => (() => void) | IDisposable |
  *
  * @example
  * ```ts
- * render: (container, { props, signal }) => asyncRender(signal, async () => {
- *   const data = await fetchData(props.url, { signal });
+ * render: (container, { input, signal }) => asyncRender(signal, async () => {
+ *   const data = await fetchData(input.url, { signal });
  *   if (signal.aborted) return;
  *   container.innerHTML = data;
  *   return () => { container.innerHTML = ''; };