@vscode/component-explorer 0.1.1-2 → 0.1.1-21

package/dist/core/CliRuntime.d.ts

@@ -0,0 +1,50 @@
+import { RenderReport } from './ErrorInfo.js';
+export interface FixtureModules {
+    [path: string]: {
+        default?: unknown;
+    };
+}
+interface FlatFixture {
+    readonly fixtureId: string;
+    readonly fixtureName: string;
+    readonly groupPath: string[];
+    readonly background: 'light' | 'dark';
+    readonly labels: readonly string[];
+}
+interface CliApi {
+    readonly sessionId: string;
+    readonly updateVersion: number;
+    listFixtures(): FlatFixture[];
+    renderFixture(fixtureId: string): Promise<RenderReport>;
+}
+declare global {
+    interface Window {
+        __componentExplorerCli__?: CliApi;
+    }
+}
+/**
+ * Runtime for the CLI/screenshot mode.
+ * Manages fixture registration, rendering, and HMR versioning.
+ * Installs itself as `window.__componentExplorerCli__`.
+ */
+export declare class CliRuntime {
+    private readonly _containerElement;
+    readonly sessionId: string;
+    private _updateVersion;
+    private _root;
+    private _fixtureModules;
+    private _currentRendering;
+    private _currentContainer;
+    constructor(_containerElement: HTMLElement, fixtureModules: FixtureModules);
+    get updateVersion(): number;
+    updateFixtures(fixtureModules: FixtureModules): void;
+    bumpVersion(): void;
+    listFixtures(): FlatFixture[];
+    renderFixture(fixtureId: string): Promise<RenderReport>;
+    private _buildRegistry;
+    private _flattenFixtures;
+    private _findFixtureNode;
+    private _installGlobalApi;
+}
+export {};
+//# sourceMappingURL=CliRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CliRuntime.d.ts","sourceRoot":"","sources":["../../src/core/CliRuntime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9D,MAAM,WAAW,cAAc;IAC9B,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACtC;AAED,UAAU,WAAW;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,UAAU,MAAM;IACf,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,YAAY,IAAI,WAAW,EAAE,CAAC;IAC9B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACxD;AAED,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,wBAAwB,CAAC,EAAE,MAAM,CAAC;KAClC;CACD;AAED;;;;GAIG;AACH,qBAAa,UAAU;IASrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IARnC,QAAQ,CAAC,SAAS,SAAuC;IACzD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,iBAAiB,CAA0B;gBAGjC,iBAAiB,EAAE,WAAW,EAC/C,cAAc,EAAE,cAAc;IAU/B,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,cAAc,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAQpD,WAAW,IAAI,IAAI;IAKnB,YAAY,IAAI,WAAW,EAAE;IAIvB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgG7D,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,iBAAiB;CAYzB"}

package/dist/core/ComponentRenderer.d.ts

@@ -0,0 +1,14 @@
+import { ComponentDefinition } from './fixtureApiConsumer.js';
+import { RenderReturn } from './fixtureApi.js';
+export declare class ComponentRendering {
+    readonly component: ComponentDefinition;
+    readonly renderTarget: HTMLElement;
+    readonly shadowRoot: ShadowRoot | null;
+    private readonly _abortController;
+    private readonly _rawResult;
+    private _resolvedResult;
+    get result(): RenderReturn;
+    constructor(host: HTMLElement, component: ComponentDefinition);
+    dispose(): void;
+}
+//# sourceMappingURL=ComponentRenderer.d.ts.map

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

@@ -0,0 +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,EAAgB,MAAM,iBAAiB,CAAC;AAGlE,qBAAa,kBAAkB;IASC,QAAQ,CAAC,SAAS,EAAE,mBAAmB;IARtE,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,eAAe,CAA2B;IAElD,IAAI,MAAM,IAAI,YAAY,CAA4B;gBAE1C,IAAI,EAAE,WAAW,EAAW,SAAS,EAAE,mBAAmB;IA6DtE,OAAO,IAAI,IAAI;CAKf"}

package/dist/core/ErrorInfo.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Error captured during fixture rendering.
+ * Can be either an unhandled exception or a console error/warning.
+ */
+export type ErrorInfo = ExceptionError | ConsoleError;
+/**
+ * Unhandled exception thrown during render.
+ */
+export interface ExceptionError {
+    readonly kind: 'exception';
+    readonly message: string;
+    readonly stack?: string;
+}
+/**
+ * Console error or warning captured during render.
+ */
+export interface ConsoleError {
+    readonly kind: 'console';
+    readonly level: 'error' | 'warn';
+    readonly message: string;
+}
+/**
+ * Result of rendering a fixture, including any captured errors.
+ */
+export interface RenderReport {
+    /** Errors captured during rendering (exceptions and console.error/warn) */
+    readonly errors: ErrorInfo[];
+}
+//# sourceMappingURL=ErrorInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorInfo.d.ts","sourceRoot":"","sources":["../../src/core/ErrorInfo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;CAC7B"}

package/dist/core/FixtureNode.d.ts

@@ -1,4 +1,5 @@
-import { ComponentDefinition, FixtureExport } from './ComponentDefinition.js';
+import { FixtureExport } from './fixtureApi.js';
+import { ComponentDefinition } from './fixtureApiConsumer.js';
 /**
  * A node in the fixture tree.
  * Can be a folder (with children), variants (with children, horizontal layout), or a component leaf.
@@ -14,6 +15,8 @@ export interface FixtureNode {
     readonly children?: readonly FixtureNode[];
     /** Component definition (only for component nodes) */
     readonly component?: ComponentDefinition;
+    /** Labels for categorization and filtering */
+    readonly labels: readonly string[];
 }
 /**
  * Creates a fixture tree from a map of fixture exports.

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,mBAAmB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGnF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,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;CAC1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,WAAW,CAenF;AA8FD;;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;AACrD,OAAO,EAKH,KAAK,mBAAmB,EAC3B,MAAM,yBAAyB,CAAC;AA8CjC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,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;CACpC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,WAAW,CAiBnF;AA6HD;;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/FixtureRegistry.d.ts

@@ -1,5 +1,6 @@
 import { IObservable, IReader } from '@vscode/observables';
-import { ComponentDefinition, FixtureExport } from './ComponentDefinition.js';
+import { FixtureExport } from './fixtureApi.js';
+import { ComponentDefinition } from './fixtureApiConsumer.js';
 import { FixtureNode } from './FixtureNode.js';
 /**
  * Registry for discovered fixtures.

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

@@ -1 +1 @@
-{"version":3,"file":"FixtureRegistry.d.ts","sourceRoot":"","sources":["../../src/core/FixtureRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEvF;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgE;IAE1F,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC,CAGpC;IAEH;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,IAAI;IAM1D;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,SAAS;IAKjE;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB,GAAG,SAAS;CAMpE"}
+{"version":3,"file":"FixtureRegistry.d.ts","sourceRoot":"","sources":["../../src/core/FixtureRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEvF;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgE;IAE1F,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC,CAGpC;IAEH;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,IAAI;IAM1D;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,SAAS;IAKjE;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB,GAAG,SAAS;CAMpE"}

package/dist/core/fixtureApi.d.ts

@@ -0,0 +1,353 @@
+/**
+ * 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
+ */
+/**
+ * Disposable resource that can be cleaned up.
+ */
+export interface IDisposable {
+    dispose(): void;
+}
+/** @deprecated Use IDisposable instead */
+export type Disposable = IDisposable;
+/**
+ * Result of a render operation.
+ * Supports both sync and async rendering with cancellation.
+ * All fields are optional for simple use cases.
+ */
+export interface RenderResult {
+    /**
+     * Resolves when the component is fully rendered and ready.
+     * For sync renders, this can be omitted (treated as immediately ready).
+     * Rejects if the render is aborted via the AbortSignal.
+     */
+    readonly ready?: Promise<void>;
+    /**
+     * Cleanup function. Called when the fixture is unmounted.
+     * Can be omitted if no cleanup is needed.
+     */
+    dispose?(): void;
+}
+/**
+ * What the render function can return.
+ * - undefined: no cleanup needed, immediately ready
+ * - RenderResult: object with optional ready/dispose
+ * - Promise<...>: async render that resolves to undefined or RenderResult
+ */
+export type RenderReturn = RenderResult | undefined | void | Promise<RenderResult | undefined | void>;
+/**
+ * Context passed to the render function.
+ */
+export interface RenderContext {
+    /** Property values based on the property schema */
+    readonly props: Record<string, unknown>;
+    /** AbortSignal for cancellation; check signal.aborted or listen to 'abort' event */
+    readonly signal: AbortSignal;
+}
+/**
+ * Style definition for shadow DOM injection.
+ */
+export type StyleDefinition = {
+    readonly type: 'css';
+    readonly content: string;
+} | {
+    readonly type: 'url';
+    readonly href: string;
+} | {
+    readonly type: 'adopted';
+    readonly sheet: CSSStyleSheet;
+};
+/**
+ * Display mode for a component.
+ */
+export type DisplayMode = PageMode | ComponentMode;
+/**
+ * Page mode - component fills a viewport with device presets.
+ */
+export interface PageMode {
+    readonly type: 'page';
+    readonly viewports: ViewportPreset[];
+}
+/**
+ * Component mode - renders at natural size.
+ */
+export interface ComponentMode {
+    readonly type: 'component';
+}
+/**
+ * Viewport preset - either a named preset or custom dimensions.
+ */
+export type ViewportPreset = ViewportPresetName | {
+    readonly name: string;
+    readonly width: number;
+    readonly height: number;
+};
+export type ViewportPresetName = 'mobile' | 'tablet' | 'desktop';
+/**
+ * Schema for a component property.
+ */
+export type PropertySchema = BooleanProperty | StringProperty | NumberProperty | EnumProperty;
+export interface BooleanProperty {
+    readonly type: 'boolean';
+    readonly name: string;
+    readonly defaultValue: boolean;
+    readonly description?: string;
+}
+export interface StringProperty {
+    readonly type: 'string';
+    readonly name: string;
+    readonly defaultValue: string;
+    readonly description?: string;
+    readonly multiline?: boolean;
+}
+export interface NumberProperty {
+    readonly type: 'number';
+    readonly name: string;
+    readonly defaultValue: number;
+    readonly description?: string;
+    readonly min?: number;
+    readonly max?: number;
+    readonly step?: number;
+}
+export interface EnumProperty {
+    readonly type: 'enum';
+    readonly name: string;
+    readonly defaultValue: string;
+    readonly description?: string;
+    readonly options: readonly string[];
+}
+/** Brand symbol to identify single fixtures */
+export declare const singleFixtureBrand: unique symbol;
+/** Brand symbol to identify fixture groups */
+export declare const fixtureGroupBrand: unique symbol;
+/** Brand symbol to identify fixture variants */
+export declare const fixtureVariantsBrand: unique symbol;
+/**
+ * Options for defining a single component fixture.
+ */
+export interface DefineFixtureOptions {
+    /**
+     * Path in the explorer tree.
+     * - `undefined` (default): use fixture filename only
+     * - `'Foo/Bar'`: exact path (fixture filename NOT appended)
+     * - `'Foo/Bar/'`: prefix (fixture filename IS appended → Foo/Bar/{filename})
+     *
+     * @throws Error if path contains empty segments (e.g., '/foo', 'foo//bar')
+     */
+    path?: string;
+    /** Optional description for documentation */
+    description?: string;
+    /** How to isolate: 'iframe' for full isolation, 'shadow-dom' (default) for lighter isolation */
+    isolation?: 'iframe' | 'shadow-dom';
+    /** Display mode: defaults to { type: 'component' } */
+    displayMode?: DisplayMode;
+    /** Styles to inject (for shadow-dom isolation) */
+    styles?: StyleDefinition[];
+    /** Background pattern for the preview canvas: 'light' (default) or 'dark' for dark transparent pattern */
+    background?: 'light' | 'dark';
+    /** Labels for categorization and filtering (e.g. 'animation', 'blocks-ci') */
+    labels?: readonly string[];
+    /** Property definitions */
+    properties?: PropertySchema[];
+    /**
+     * Render the component into the container.
+     *
+     * @param container - The DOM element to render into
+     * @param context - Render context containing props and abort signal
+     * @returns Optional RenderResult, or a Promise that resolves to one
+     */
+    render: (container: HTMLElement, context: RenderContext) => RenderReturn;
+}
+/** @deprecated Use DefineFixtureOptions instead */
+export type DefineComponentOptions = DefineFixtureOptions;
+/**
+ * A single fixture export created by defineFixture().
+ */
+export interface SingleFixtureExport {
+    readonly [singleFixtureBrand]: true;
+    readonly _options: DefineFixtureOptions;
+    readonly _path?: string;
+}
+/**
+ * Group entry: either a single fixture, a nested group, or variants.
+ */
+export type FixtureGroupEntry = SingleFixtureExport | FixtureGroupExport | FixtureVariantsExport;
+/**
+ * A fixture group export created by defineFixtureGroup().
+ */
+export interface FixtureGroupExport {
+    readonly [fixtureGroupBrand]: true;
+    readonly _entries: {
+        [key: string]: FixtureGroupEntry;
+    };
+    readonly _path?: string;
+    readonly _labels?: readonly string[];
+}
+/**
+ * A fixture variants export created by defineFixtureVariants().
+ */
+export interface FixtureVariantsExport {
+    readonly [fixtureVariantsBrand]: true;
+    readonly _variants: {
+        [key: string]: SingleFixtureExport;
+    };
+    readonly _path?: string;
+    readonly _labels?: readonly string[];
+}
+/**
+ * Fixture export type - a single fixture, a group, or variants.
+ */
+export type FixtureExport = SingleFixtureExport | FixtureGroupExport | FixtureVariantsExport;
+/**
+ * Input for defineFixtureGroup.
+ */
+export type FixtureGroupInput = {
+    [key: string]: FixtureGroupEntry;
+};
+/**
+ * Options for defineFixtureGroup with optional path.
+ */
+export interface DefineFixtureGroupOptions {
+    /**
+     * Path in the explorer tree.
+     * - `undefined` (default): use fixture filename only
+     * - `'Foo/Bar'`: exact path (fixture filename NOT appended)
+     * - `'Foo/Bar/'`: prefix (fixture filename IS appended → Foo/Bar/{filename})
+     */
+    path?: string;
+    /** Labels for categorization and filtering (e.g. 'animation', 'blocks-ci') */
+    labels?: readonly string[];
+}
+/**
+ * Input for defineFixtureVariants (only single fixtures, no nesting).
+ */
+export type FixtureVariantsInput = {
+    [key: string]: SingleFixtureExport;
+};
+/**
+ * Options for defineFixtureVariants with optional path.
+ */
+export interface DefineFixtureVariantsOptions {
+    /**
+     * Path in the explorer tree.
+     * - `undefined` (default): use fixture filename only
+     * - `'Foo/Bar'`: exact path (fixture filename NOT appended)
+     * - `'Foo/Bar/'`: prefix (fixture filename IS appended → Foo/Bar/{filename})
+     */
+    path?: string;
+    /** Labels for categorization and filtering (e.g. 'animation', 'blocks-ci') */
+    labels?: readonly string[];
+}
+/**
+ * Defines a single fixture.
+ *
+ * @example
+ * ```ts
+ * // Simple - no cleanup needed
+ * export default defineFixture({
+ *   render: (container, { props }) => {
+ *     container.innerHTML = `<button>${props.label}</button>`;
+ *   },
+ * });
+ *
+ * // With cleanup
+ * export default defineFixture({
+ *   render: (container, { props }) => {
+ *     const root = createRoot(container);
+ *     root.render(<Button label={props.label} />);
+ *     return { dispose: () => root.unmount() };
+ *   },
+ * });
+ *
+ * // Async render
+ * export default defineFixture({
+ *   render: async (container, { props, signal }) => {
+ *     const data = await fetch(props.url, { signal });
+ *     container.innerHTML = await data.text();
+ *     return { dispose: () => { container.innerHTML = ''; } };
+ *   },
+ * });
+ * ```
+ */
+export declare function defineFixture(options: DefineFixtureOptions): SingleFixtureExport;
+/**
+ * Defines a group of fixtures with support for nesting.
+ *
+ * @example
+ * ```ts
+ * export default defineFixtureGroup({
+ *   Primary: defineFixture({
+ *     render: (container) => { ... },
+ *   }),
+ *   Variants: defineFixtureGroup({
+ *     Small: defineFixture({ ... }),
+ *     Large: defineFixture({ ... }),
+ *   }),
+ * });
+ * ```
+ */
+export declare function defineFixtureGroup(entries: FixtureGroupInput): FixtureGroupExport;
+export declare function defineFixtureGroup(options: DefineFixtureGroupOptions, entries: FixtureGroupInput): FixtureGroupExport;
+/**
+ * Defines a group of fixture variants (no nesting allowed).
+ * Variants are rendered horizontally by default and have a distinct icon in the tree.
+ *
+ * @example
+ * ```ts
+ * export default defineFixtureGroup({
+ *   Button: defineFixtureVariants({
+ *     Small: defineFixture({ ... }),
+ *     Medium: defineFixture({ ... }),
+ *     Large: defineFixture({ ... }),
+ *   }),
+ * });
+ * ```
+ */
+export declare function defineFixtureVariants(variants: FixtureVariantsInput): FixtureVariantsExport;
+export declare function defineFixtureVariants(options: DefineFixtureVariantsOptions, variants: FixtureVariantsInput): FixtureVariantsExport;
+/**
+ * Helper for synchronous renders.
+ * Executes the render function immediately and wraps the cleanup in a RenderResult.
+ *
+ * @param doRender - Function that renders synchronously and returns a cleanup function
+ * @returns A RenderResult with an already-resolved ready promise
+ *
+ * @example
+ * ```ts
+ * render: (container, { props }) => syncRender(() => {
+ *   const el = document.createElement('button');
+ *   el.textContent = props.label;
+ *   container.appendChild(el);
+ *   return () => el.remove();
+ * })
+ * ```
+ */
+export declare function syncRender(doRender: () => (() => void) | IDisposable | void): RenderResult;
+/**
+ * Helper for asynchronous renders with cancellation support.
+ *
+ * @param signal - AbortSignal for cancellation
+ * @param doRender - Async function that renders and returns a cleanup function.
+ *                   Should check signal.aborted periodically for long operations.
+ * @returns A RenderResult whose ready promise rejects with AbortError if cancelled
+ *
+ * @example
+ * ```ts
+ * render: (container, { props, signal }) => asyncRender(signal, async () => {
+ *   const data = await fetchData(props.url, { signal });
+ *   if (signal.aborted) return;
+ *   container.innerHTML = data;
+ *   return () => { container.innerHTML = ''; };
+ * })
+ * ```
+ */
+export declare function asyncRender(signal: AbortSignal, doRender: () => Promise<(() => void) | IDisposable | void>): RenderResult;
+//# sourceMappingURL=fixtureApi.d.ts.map

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

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

package/dist/core/fixtureApiConsumer.d.ts

@@ -0,0 +1,85 @@
+import { FixtureExport, SingleFixtureExport, FixtureGroupExport, FixtureVariantsExport, DisplayMode, StyleDefinition, PropertySchema, RenderReturn, RenderContext } from './fixtureApi.js';
+/**
+ * Type guard for SingleFixtureExport.
+ * Uses the global symbol brand for cross-version compatibility.
+ */
+export declare function isSingleFixture(value: unknown): value is SingleFixtureExport;
+/**
+ * Type guard for FixtureGroupExport.
+ * Uses the global symbol brand for cross-version compatibility.
+ */
+export declare function isFixtureGroup(value: unknown): value is FixtureGroupExport;
+/**
+ * Type guard for FixtureVariantsExport.
+ * Uses the global symbol brand for cross-version compatibility.
+ */
+export declare function isFixtureVariants(value: unknown): value is FixtureVariantsExport;
+/**
+ * Type guard for any fixture export type.
+ */
+export declare function isFixtureExport(value: unknown): value is FixtureExport;
+export type ParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Parses and validates a potential fixture export.
+ * Returns a ParseResult with either the validated data or an error message.
+ */
+export declare function parseFixtureExport(value: unknown): ParseResult<FixtureExport>;
+/**
+ * Parses and validates a single fixture export.
+ */
+export declare function parseSingleFixture(value: unknown): ParseResult<SingleFixtureExport>;
+/**
+ * Parses and validates a fixture group export.
+ */
+export declare function parseFixtureGroup(value: unknown): ParseResult<FixtureGroupExport>;
+/**
+ * Parses and validates a fixture variants export.
+ */
+export declare function parseFixtureVariants(value: unknown): ParseResult<FixtureVariantsExport>;
+/**
+ * Definition of a component fixture (internal representation).
+ */
+export interface ComponentDefinition {
+    /** Unique identifier within the fixture file */
+    readonly id: string;
+    /** Display name shown in the tree */
+    readonly name: string;
+    /** Optional description for documentation */
+    readonly description?: string;
+    /** How to isolate this component from other components */
+    readonly isolation: 'iframe' | 'shadow-dom';
+    /** How to display: page (device viewport) or component (natural size) */
+    readonly displayMode: DisplayMode;
+    /**
+     * Stylesheets to inject into shadow root (for shadow-dom isolation).
+     * Ignored when isolation is 'iframe'.
+     */
+    readonly styles?: readonly StyleDefinition[];
+    /** Background pattern for the preview canvas: 'light' (default) or 'dark' for dark transparent pattern */
+    readonly background: 'light' | 'dark';
+    /** Labels for categorization and filtering */
+    readonly labels: readonly string[];
+    /** Property schema for the component */
+    readonly properties: readonly PropertySchema[];
+    /**
+     * Render the component into the container.
+     * Returns an optional RenderResult or Promise for cleanup and async readiness.
+     */
+    render(container: HTMLElement, context: RenderContext): RenderReturn;
+}
+/**
+ * Creates the component definition from a validated SingleFixtureExport.
+ */
+export declare function createComponentDefinition(fixture: SingleFixtureExport, id: string, name: string): ComponentDefinition;
+/**
+ * Type guard for checking if a value is a ComponentDefinition.
+ * @deprecated Use isSingleFixture or isFixtureGroup instead
+ */
+export declare function isComponentDefinition(value: unknown): value is ComponentDefinition;
+//# sourceMappingURL=fixtureApiConsumer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixtureApiConsumer.d.ts","sourceRoot":"","sources":["../../src/core/fixtureApiConsumer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIH,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EACrB,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,QAAQ,GAAG,YAAY,CAAC;IAE5C,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;;OAGG;IACH,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,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAE/C;;;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,GACX,mBAAmB,CAcrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CASlF"}

package/dist/core/index.d.ts

@@ -1,12 +1,13 @@
-export type { Disposable, StyleDefinition, DisplayMode, PageMode, ComponentMode, ViewportPreset, ViewportPresetName, } from './DisplayMode.js';
-export type { PropertySchema, BooleanProperty, StringProperty, NumberProperty, EnumProperty, } from './PropertySchema.js';
-export type { ComponentDefinition, FixtureExport, SingleFixtureExport, FixtureGroupExport, FixtureVariantsExport, } from './ComponentDefinition.js';
+export type { IDisposable, StyleDefinition, DisplayMode, PageMode, ComponentMode, ViewportPreset, ViewportPresetName, PropertySchema, BooleanProperty, StringProperty, NumberProperty, EnumProperty, 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 { ComponentDefinition, ParseResult } from './fixtureApiConsumer.js';
+export { isSingleFixture, isFixtureGroup, isFixtureVariants, parseFixtureExport, parseSingleFixture, parseFixtureGroup, parseFixtureVariants, createComponentDefinition, isComponentDefinition, } from './fixtureApiConsumer.js';
+export type { ErrorInfo, ExceptionError, ConsoleError, RenderReport, } from './ErrorInfo.js';
 export type { FixtureNode, } from './FixtureNode.js';
-export type { DefineFixtureOptions, DefineComponentOptions, FixtureGroupEntry, FixtureGroupInput, FixtureVariantsInput, } from './defineFixture.js';
 export { VIEWPORT_SIZES, resolveViewport } from './DisplayMode.js';
 export { getDefaultPropertyValues } from './PropertySchema.js';
-export { isComponentDefinition } from './ComponentDefinition.js';
 export { createFixtureTree, findNodeByPath, collectComponents } from './FixtureNode.js';
-export { defineFixture, defineFixtureGroup, defineFixtureVariants, isSingleFixture, isFixtureGroup, isFixtureVariants } from './defineFixture.js';
 export { FixtureRegistry } from './FixtureRegistry.js';
+export { CliRuntime } from './CliRuntime.js';
+export type { FixtureModules } from './CliRuntime.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGlJ,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"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,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,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,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGxF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/daemon/DaemonConfig.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Configuration injected by the daemon via the Vite plugin.
+ * Set as `window.__EXPLORER_DAEMON__` when the explorer is served from a daemon-managed Vite server.
+ */
+export interface DaemonConfig {
+    /** Name of the session this explorer instance belongs to (e.g. 'current' or 'baseline') */
+    readonly sessionName: string;
+}
+declare global {
+    interface Window {
+        __EXPLORER_DAEMON__?: DaemonConfig;
+    }
+}
+/**
+ * Reads daemon config from the global window object.
+ * Returns undefined if the explorer is not running under a daemon.
+ */
+export declare function getDaemonConfig(): DaemonConfig | undefined;
+//# sourceMappingURL=DaemonConfig.d.ts.map

package/dist/daemon/DaemonConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonConfig.d.ts","sourceRoot":"","sources":["../../src/daemon/DaemonConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,mBAAmB,CAAC,EAAE,YAAY,CAAC;KACnC;CACD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,SAAS,CAE1D"}