@vscode/component-explorer 0.2.1-8 → 0.2.1-80

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/FixtureInteractionRuntime.d.ts

@@ -0,0 +1,29 @@
+import { DebugPanelActivation, IDisposable } from './fixtureApi.js';
+export declare const OUTPUT_DEBUG_PANEL_ID = "$output";
+export interface ActiveDebugPanelSession extends IDisposable {
+    sendAction(action: unknown): void;
+}
+type InputListener = (value: unknown, input: unknown) => void;
+export declare class FixtureInputRuntime {
+    private _input;
+    private readonly _listeners;
+    constructor(_input: unknown);
+    watch(key: string, listener: InputListener): IDisposable;
+    update(input: unknown): boolean;
+}
+export declare class FixtureDebugRuntime implements IDisposable {
+    private readonly _activations;
+    private readonly _activeSessions;
+    private _output;
+    private _hasOutput;
+    connect(panelId: string, activate: DebugPanelActivation<unknown, unknown>): IDisposable;
+    setOutput(output: unknown): void;
+    get hasOutput(): boolean;
+    get outputEditable(): boolean;
+    getOutputSnapshot(): unknown;
+    activate(panelId: string, publish: (state: unknown) => void): ActiveDebugPanelSession;
+    dispose(): void;
+    private _activateOutput;
+}
+export {};
+//# sourceMappingURL=FixtureInteractionRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FixtureInteractionRuntime.d.ts","sourceRoot":"","sources":["../../src/core/FixtureInteractionRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAE9D,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;gBAEhD,MAAM,EAAE,OAAO;IAEnC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,WAAW;IAsBxD,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAqBhC;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6D;IAC1F,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IACtE,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CACL,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,GAC/C,WAAW;IAcd,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKhC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,iBAAiB,IAAI,OAAO;IAM5B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,uBAAuB;IAgDrF,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,eAAe;CAWxB"}

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,20 +1,63 @@
-/**
- * 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>;
+}
+export type DebugPanelPlacement = 'canvas-right' | 'bottom-panel';
+export interface DebugPanelViewContext<TAction> {
+    sendAction(action: TAction): void;
+}
+export interface DebugPanelViewInstance<TState> extends IDisposable {
+    update(state: TState): void;
+}
+export interface DefineDebugPanelOptions<TState, TAction> {
+    readonly id: string;
+    readonly title: string;
+    readonly placement?: DebugPanelPlacement;
+    render(container: HTMLElement, context: DebugPanelViewContext<TAction>): DebugPanelViewInstance<TState>;
+}
+interface ErasedDebugPanelViewInstance extends IDisposable {
+    update(state: unknown): void;
+}
+/**
+ * A statically declared custom panel. `TState` is published by the fixture and
+ * `TAction` is sent back by the panel UI.
+ */
+export interface DebugPanelDefinition<TState = unknown, TAction = unknown> {
+    readonly id: string;
+    readonly title: string;
+    readonly placement?: DebugPanelPlacement;
+    /** @internal Viewer-side, type-erased renderer produced by defineDebugPanel. */
+    readonly _render: (container: HTMLElement, sendAction: (action: unknown) => void) => ErasedDebugPanelViewInstance;
+    /** @internal Carries types for inference without affecting the runtime shape. */
+    readonly _types?: {
+        readonly state: TState;
+        readonly action: TAction;
+    };
+}
+export interface DebugPanelChannel<TState, TAction> {
+    publish(state: TState): void;
+    onAction(listener: (action: TAction) => void): IDisposable;
+}
+export type DebugPanelActivation<TState, TAction> = (channel: DebugPanelChannel<TState, TAction>) => void | IDisposable;
+export interface FixtureDebugApi {
+    connect<TState, TAction>(panel: DebugPanelDefinition<TState, TAction>, activate: DebugPanelActivation<TState, TAction>): IDisposable;
+}
+export interface FixtureInputControlOptions {
+    readonly placement?: 'sidebar' | 'toolbar' | 'both';
+    readonly label?: string;
+    readonly title?: string;
+}
+/** Brand for an output that can be observed and edited while its Output panel is visible. */
+export declare const interactiveOutputBrand: unique symbol;
+export interface InteractiveOutput<T> {
+    readonly [interactiveOutputBrand]: true;
+    getSnapshot(): T;
+    activate(channel: DebugPanelChannel<T, T>): void | IDisposable;
 }
 /**
  * Result of a render operation.
@@ -30,14 +73,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.
@@ -48,13 +97,65 @@ 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;
+    /**
+     * Observes one input property without remounting the fixture. The listener is
+     * invoked immediately and again for subsequent changes to this property.
+     * Input properties without a watcher retain the default remount behavior.
+     */
+    watchInput<TKey extends Extract<keyof TInput, string>>(key: TKey, listener: (value: TInput[TKey], input: TInput) => void): IDisposable;
+    /** Connects statically declared debug panels to this live fixture instance. */
+    readonly debug: FixtureDebugApi;
+    /**
+     * 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 +195,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 +233,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 +260,41 @@ 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>;
+    /** Controls how selected input properties are presented in the Explorer UI. */
+    inputControls?: {
+        readonly [TKey in Extract<keyof TInput, string>]?: FixtureInputControlOptions;
+    };
+    /** Custom debug panels contributed by this fixture. */
+    debugPanels?: readonly DebugPanelDefinition<unknown, unknown>[];
     /**
      * 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 +305,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 +323,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 +337,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 +365,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 +394,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 +408,39 @@ 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;
+export declare function defineDebugPanel<TState, TAction = never>(options: DefineDebugPanelOptions<TState, TAction>): DebugPanelDefinition<TState, TAction>;
+export declare function interactiveOutput<T>(options: {
+    readonly getSnapshot: () => T;
+    readonly activate: DebugPanelActivation<T, T>;
+}): InteractiveOutput<T>;
+export declare function isInteractiveOutput(value: unknown): value is InteractiveOutput<unknown>;
 /**
  * Defines a group of fixtures with support for nesting.
  *
@@ -298,9 +485,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 +504,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 = ''; };
@@ -326,4 +513,5 @@ export declare function syncRender(doRender: () => (() => void) | IDisposable |
  * ```
  */
 export declare function asyncRender(signal: AbortSignal, doRender: () => Promise<(() => void) | IDisposable | void>): RenderResult;
+export {};
 //# sourceMappingURL=fixtureApi.d.ts.map

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

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

package/dist/core/fixtureApiConsumer.d.ts

@@ -1,4 +1,4 @@
-import { FixtureExport, SingleFixtureExport, FixtureGroupExport, FixtureVariantsExport, DisplayMode, StyleDefinition, RenderReturn, RenderContext } from './fixtureApi.js';
+import { FixtureExport, SingleFixtureExport, FixtureGroupExport, FixtureVariantsExport, DisplayMode, StyleDefinition, RenderReturn, RenderContext, IJsonSchema, DebugPanelDefinition, FixtureInputControlOptions } from './fixtureApi.js';
 /**
  * Type guard for SingleFixtureExport.
  * Uses the global symbol brand for cross-version compatibility.
@@ -64,6 +64,12 @@ export interface ComponentDefinition {
     readonly labels: readonly string[];
     /** Accumulated expected visual descriptions (from self + parent groups/variants) */
     readonly expectedVisualDescriptions: readonly string[];
+    /** JSON Schema describing the expected shape of `RenderContext.input` (always an object). */
+    readonly inputSchema?: IJsonSchema;
+    /** Explorer presentation metadata for input properties. */
+    readonly inputControls?: Readonly<Record<string, FixtureInputControlOptions>>;
+    /** Statically declared custom debug panels. */
+    readonly debugPanels: readonly DebugPanelDefinition<unknown, unknown>[];
     /** Source file path this fixture was defined in */
     readonly sourceFile: string;
     /**
@@ -74,8 +80,22 @@ export interface ComponentDefinition {
 }
 /**
  * Creates the component definition from a validated SingleFixtureExport.
+ *
+ * @param inheritedInputSchema - JSON Schema accumulated from enclosing groups/variants; merged
+ *   with the fixture's own schema (the fixture's properties win on conflict).
  */
-export declare function createComponentDefinition(fixture: SingleFixtureExport, id: string, name: string, sourceFile: string, inheritedVisualDescriptions?: readonly string[]): ComponentDefinition;
+export declare function createComponentDefinition(fixture: SingleFixtureExport, id: string, name: string, sourceFile: string, inheritedVisualDescriptions?: readonly string[], inheritedInputSchema?: IJsonSchema | undefined): ComponentDefinition;
+/**
+ * Merges two object JSON Schemas. `child` properties win over `parent` on key conflicts;
+ * `required` is the de-duplicated union. Returns whichever side is defined when only one is.
+ */
+export declare function mergeInputSchemas(parent: IJsonSchema | undefined, child: IJsonSchema | undefined): IJsonSchema | undefined;
+/**
+ * Builds the effective `input` object passed to a fixture: the schema's top-level property
+ * defaults, overlaid with any caller-provided overrides. Returns the override unchanged when
+ * there is no schema (so schemaless fixtures keep their original `undefined`/passthrough input).
+ */
+export declare function applyInputDefaults(schema: IJsonSchema | undefined, input: unknown): unknown;
 /**
  * Type guard for checking if a value is a ComponentDefinition.
  * @deprecated Use isSingleFixture or isFixtureGroup instead

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

@@ -1 +1 @@
-{"version":3,"file":"fixtureApiConsumer.d.ts","sourceRoot":"","sources":["../../src/core/fixtureApiConsumer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAOzB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAS5E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAS1E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAShF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAMD,MAAM,MAAM,WAAW,CAAC,CAAC,IACrB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC,CAW7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAKnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAKjF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAKvF;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;IAErD,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAE7C,0GAA0G;IAC1G,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAAC;IAEtC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAEnC,oFAAoF;IACpF,QAAQ,CAAC,0BAA0B,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvD,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,CAAC;CACtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,mBAAmB,EAC5B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,2BAA2B,GAAE,SAAS,MAAM,EAAO,GAClD,mBAAmB,CAmBrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CASlF"}
+{"version":3,"file":"fixtureApiConsumer.d.ts","sourceRoot":"","sources":["../../src/core/fixtureApiConsumer.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -1,7 +1,11 @@
-export type { IDisposable, StyleDefinition, DisplayMode, PageMode, ComponentMode, ViewportPreset, ViewportPresetName, DefineFixtureOptions, DefineComponentOptions, FixtureGroupEntry, FixtureGroupInput, FixtureVariantsInput, FixtureExport, SingleFixtureExport, FixtureGroupExport, FixtureVariantsExport, RenderResult, RenderReturn, RenderContext, } from './fixtureApi.js';
-export { singleFixtureBrand, fixtureGroupBrand, fixtureVariantsBrand, defineFixture, defineFixtureGroup, defineFixtureVariants, syncRender, asyncRender, } from './fixtureApi.js';
+export type { IDisposable, StyleDefinition, DisplayMode, PageMode, ComponentMode, ViewportPreset, ViewportPresetName, DefineFixtureOptions, DefineComponentOptions, FixtureGroupEntry, FixtureGroupInput, FixtureVariantsInput, FixtureExport, SingleFixtureExport, FixtureGroupExport, FixtureVariantsExport, RenderResult, RenderReturn, RenderContext, RenderHost, IJsonSchema, DebugPanelPlacement, DebugPanelViewContext, DebugPanelViewInstance, DefineDebugPanelOptions, DebugPanelDefinition, DebugPanelChannel, DebugPanelActivation, FixtureDebugApi, FixtureInputControlOptions, InteractiveOutput, } from './fixtureApi.js';
+export { singleFixtureBrand, fixtureGroupBrand, fixtureVariantsBrand, defineFixture, defineFixtureGroup, defineFixtureVariants, defineDebugPanel, interactiveOutput, isInteractiveOutput, syncRender, asyncRender, } from './fixtureApi.js';
 export type { ComponentDefinition, ParseResult } from './fixtureApiConsumer.js';
-export { isSingleFixture, isFixtureGroup, isFixtureVariants, parseFixtureExport, parseSingleFixture, parseFixtureGroup, parseFixtureVariants, createComponentDefinition, isComponentDefinition, } from './fixtureApiConsumer.js';
+export { isSingleFixture, isFixtureGroup, isFixtureVariants, parseFixtureExport, parseSingleFixture, parseFixtureGroup, parseFixtureVariants, createComponentDefinition, mergeInputSchemas, applyInputDefaults, isComponentDefinition, } from './fixtureApiConsumer.js';
+export { FixtureInputStore } from './FixtureInputStore.js';
+export type { FixtureInputOverride } from './FixtureInputStore.js';
+export { aggregateInputProperties, effectiveInputValue, } from './inputAggregation.js';
+export type { AggregatedInputProperty, ComponentInputInfo, } from './inputAggregation.js';
 export type { ExceptionError, RenderEvent, RenderEventType, RenderReport, } from './ErrorInfo.js';
 export type { FixtureNode, } from './FixtureNode.js';
 export { FixturePath } from './FixturePath.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAKzB,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAKjC,YAAY,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGxF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,MAAM,WAAW,cAAc;IAC7B,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACrD,WAAW,IAAI,IAAI,CAAC;CACrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAKzB,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAK/B,YAAY,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGxF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,MAAM,WAAW,cAAc;IAC7B,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACrD,WAAW,IAAI,IAAI,CAAC;CACrB"}

package/dist/core/inputAggregation.d.ts

@@ -0,0 +1,31 @@
+import { IJsonSchema } from './fixtureApi.js';
+/**
+ * A single input property shared by one or more of the currently rendered fixtures.
+ * Properties are grouped by name **and** structural schema equality, so a control can edit
+ * every fixture that declares the same property at once.
+ */
+export interface AggregatedInputProperty {
+    readonly name: string;
+    readonly schema: IJsonSchema;
+    /** Ids of the fixtures that declare this exact property (same name + schema). */
+    readonly fixtureIds: readonly string[];
+}
+/** Minimal shape needed to aggregate: a fixture id and its (merged) input schema. */
+export interface ComponentInputInfo {
+    readonly id: string;
+    readonly inputSchema?: IJsonSchema;
+}
+/**
+ * Stable identity of an input property: its name plus structural schema. Two fixtures that
+ * declare the same property (same name + schema) share this key, so a chosen value can be
+ * persisted once and reused across every fixture that has it.
+ */
+export declare function inputPropertyKey(name: string, schema: IJsonSchema): string;
+/**
+ * Collects the input properties declared across the given fixtures, grouping identical
+ * (name + schema) properties so they can be edited together. Order follows first appearance.
+ */
+export declare function aggregateInputProperties(components: readonly ComponentInputInfo[]): AggregatedInputProperty[];
+/** The value currently in effect for a property: explicit override, else schema default. */
+export declare function effectiveInputValue(override: Record<string, unknown> | undefined, name: string, schema: IJsonSchema): unknown;
+//# sourceMappingURL=inputAggregation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputAggregation.d.ts","sourceRoot":"","sources":["../../src/core/inputAggregation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;CACtC;AAgBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,UAAU,EAAE,SAAS,kBAAkB,EAAE,GAC1C,uBAAuB,EAAE,CA0B3B;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GACpB,OAAO,CAKT"}

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  *
  * For the viewer/explorer UI, import from '@vscode/component-explorer/viewer' instead.
  */
-export { defineFixture, defineFixtureGroup, defineFixtureVariants, singleFixtureBrand, fixtureGroupBrand, fixtureVariantsBrand, } from './core/fixtureApi.js';
-export type { DefineFixtureOptions, DefineComponentOptions, FixtureExport, SingleFixtureExport, FixtureGroupExport, FixtureVariantsExport, FixtureGroupEntry, FixtureGroupInput, FixtureVariantsInput, IDisposable, StyleDefinition, DisplayMode, PageMode, ComponentMode, ViewportPreset, ViewportPresetName, } from './core/fixtureApi.js';
+export { defineFixture, defineFixtureGroup, defineFixtureVariants, defineDebugPanel, interactiveOutput, singleFixtureBrand, fixtureGroupBrand, fixtureVariantsBrand, } from './core/fixtureApi.js';
+export type { DefineFixtureOptions, DefineComponentOptions, FixtureExport, SingleFixtureExport, FixtureGroupExport, FixtureVariantsExport, FixtureGroupEntry, FixtureGroupInput, FixtureVariantsInput, IDisposable, StyleDefinition, DisplayMode, PageMode, ComponentMode, ViewportPreset, ViewportPresetName, RenderContext, RenderHost, RenderResult, RenderReturn, IJsonSchema, DebugPanelPlacement, DebugPanelViewContext, DebugPanelViewInstance, DefineDebugPanelOptions, DebugPanelDefinition, DebugPanelChannel, DebugPanelActivation, FixtureDebugApi, FixtureInputControlOptions, InteractiveOutput, } from './core/fixtureApi.js';
 export { runtimeVersion, } from './runtimeVersion.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EAGrB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAEV,oBAAoB,EACpB,sBAAsB,EAGtB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EAGpB,WAAW,EACX,eAAe,EACf,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,GACf,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EAGjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAEV,oBAAoB,EACpB,sBAAsB,EAGtB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EAGpB,WAAW,EACX,eAAe,EACf,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,kBAAkB,EAGlB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,GACf,MAAM,qBAAqB,CAAC"}