@vscode/component-explorer 0.1.1-8 → 0.2.0

package/dist/core/fixtureApi.d.ts

@@ -0,0 +1,358 @@
+/**
+ * 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;
+    /**
+     * Arbitrary data to include in the render report.
+     * Visible to the CLI and MCP tools.
+     */
+    readonly data?: unknown;
+}
+/**
+ * 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: 'none' (default) renders in light DOM, 'shadow-dom' for CSS isolation, 'iframe' for full isolation */
+    isolation?: 'none' | 'shadow-dom' | 'iframe';
+    /** Display mode: defaults to { type: 'component' } */
+    displayMode?: DisplayMode;
+    /** Styles to inject (into document head for 'none', into shadow root for 'shadow-dom', into iframe head for 'iframe') */
+    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,84 @@
+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: 'none' | 'shadow-dom' | 'iframe';
+    /** How to display: page (device viewport) or component (natural size) */
+    readonly displayMode: DisplayMode;
+    /** Stylesheets to inject (into document head, shadow root, or iframe head depending on isolation mode) */
+    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[];
+    /** Source file path this fixture was defined in */
+    readonly sourceFile: string;
+    /**
+     * 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, sourceFile: 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,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,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAE/C,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,GACjB,mBAAmB,CAerB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CASlF"}

package/dist/core/index.d.ts

@@ -1,14 +1,21 @@
-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 { ExceptionError, RenderEvent, RenderEventType, RenderReport, } from './ErrorInfo.js';
 export type { FixtureNode, } from './FixtureNode.js';
-export type { DefineFixtureOptions, DefineComponentOptions, FixtureGroupEntry, FixtureGroupInput, FixtureVariantsInput, } from './defineFixture.js';
+export { FixturePath } from './FixturePath.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';
+export interface FixtureModules {
+    [path: string]: {
+        default?: unknown;
+    };
+}
+export interface ExplorerRuntime {
+    updateFixtures(fixtureModules: FixtureModules): void;
+    bumpVersion(): void;
+}
 //# 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;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,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,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,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,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/daemon/DaemonConfig.d.ts

@@ -1,19 +1,13 @@
 /**
  * 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.
+ * Passed to ExplorerApp as `options.daemonConfig`.
  */
 export interface DaemonConfig {
     /** Name of the session this explorer instance belongs to (e.g. 'current' or 'baseline') */
     readonly sessionName: string;
+    /** Daemon API version served by the daemon process. */
+    readonly daemonApiVersion: string;
+    /** Runtime version required by the vite plugin for the explorer bundle it serves. */
+    readonly runtimeVersionNeededByPlugin: 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

@@ -1 +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"}
+{"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;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,qFAAqF;IACrF,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;CAC9C"}

package/dist/daemon/DaemonModel.d.ts

@@ -7,6 +7,11 @@ export type DaemonScreenshotResult = DaemonApiType['screenshots']['take']['TResu
 export type DaemonCompareResult = DaemonApiType['screenshots']['compare']['TResult'];
 /** Fixture info from the daemon */
 export type DaemonFixtureInfo = DaemonApiType['fixtures']['list']['TResult'][number];
+export interface DaemonSession {
+    readonly name: string;
+    readonly serverUrl: string;
+    readonly sourceKind: 'current' | 'worktree';
+}
 /**
  * Client-side model for interacting with the daemon.
  * Manages source tree IDs, screenshot caching, and the event stream.
@@ -22,10 +27,7 @@ export declare class DaemonModel {
     /** Observable map of sessionName → current sourceTreeId */
     readonly sourceTreeIds: IObservable<ReadonlyMap<string, string>>;
     /** Observable list of sessions from the daemon */
-    readonly sessions: IObservable<readonly {
-        name: string;
-        serverUrl: string;
-    }[]>;
+    readonly sessions: IObservable<readonly DaemonSession[]>;
     constructor(config: DaemonConfig);
     /**
      * Initializes the model: fetches initial session info and starts listening to events.
@@ -53,5 +55,6 @@ export declare class DaemonModel {
     private _fetchSessionInfos;
     private _startEventStream;
     private _handleEvent;
+    private _validateProtocolVersions;
 }
 //# sourceMappingURL=DaemonModel.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DaemonModel.d.ts","sourceRoot":"","sources":["../../src/daemon/DaemonModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,6CAA6C,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,wCAAwC;AACxC,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;AAErF,wCAAwC;AACxC,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC;AAErF,mCAAmC;AACnC,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAOrF;;;GAGG;AACH,qBAAa,WAAW;IAeX,QAAQ,CAAC,MAAM,EAAE,YAAY;IAdzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiE;IAChG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6E;IACvG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuC;IACxE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,iBAAiB,CAAgC;IAEzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAuB;IAEvF,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAkB;gBAE3E,MAAM,EAAE,YAAY;IAKzC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;;OAGG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAuB5F;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgBvH;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;IAQ9E;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAM9D,OAAO,IAAI,IAAI;YASD,kBAAkB;YAYlB,iBAAiB;IAuB/B,OAAO,CAAC,YAAY;CAepB"}
+{"version":3,"file":"DaemonModel.d.ts","sourceRoot":"","sources":["../../src/daemon/DaemonModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EACN,KAAK,aAAa,EAElB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,wCAAwC;AACxC,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;AAErF,wCAAwC;AACxC,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC;AAErF,mCAAmC;AACnC,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAErF,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;CAC5C;AAOD;;;GAGG;AACH,qBAAa,WAAW;IAeX,QAAQ,CAAC,MAAM,EAAE,YAAY;IAdzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiE;IAChG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuD;IACjF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuC;IACxE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,iBAAiB,CAAgC;IAEzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAuB;IAEvF,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,SAAS,aAAa,EAAE,CAAC,CAAkB;gBAErD,MAAM,EAAE,YAAY;IAOzC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;OAGG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAuB5F;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgBvH;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;IAQ9E;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAM9D,OAAO,IAAI,IAAI;YASD,kBAAkB;YAelB,iBAAiB;IAuB/B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,yBAAyB;CAgBjC"}

package/dist/daemon/index.d.ts

@@ -1,5 +1,4 @@
 export { DaemonModel } from './DaemonModel.js';
-export type { DaemonScreenshotResult, DaemonCompareResult, DaemonFixtureInfo } from './DaemonModel.js';
-export { getDaemonConfig } from './DaemonConfig.js';
+export type { DaemonScreenshotResult, DaemonCompareResult, DaemonFixtureInfo, DaemonSession } from './DaemonModel.js';
 export type { DaemonConfig } from './DaemonConfig.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/daemon/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/daemon/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtH,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -1,36 +1,12 @@
-import { FixtureModules } from './core/index.js';
-export * from './core/index.js';
-export { Explorer, ExplorerWithDefaults, ExplorerModel } from './components/index.js';
-export type { ExplorerTreeNode } from './components/index.js';
-export { toExplorerTree } from './components/index.js';
-export { TitleBar, TitleBarButton, LeftSidebar, RightSidebar, TreeView, TreeItem, } from './components/index.js';
-export * from './components/icons.js';
-export { styles, mergeStyles } from './components/index.js';
-export { DaemonModel } from './daemon/index.js';
-export type { DaemonScreenshotResult, DaemonCompareResult, DaemonFixtureInfo } from './daemon/DaemonModel.js';
 /**
- * The main Component Explorer application.
- * Create with `new ExplorerApp(element, fixtureModules)`.
+ * @vscode/component-explorer
+ *
+ * This is the public API for defining fixtures.
+ * Projects import from this module to define their fixtures.
+ *
+ * For the viewer/explorer UI, import from '@vscode/component-explorer/viewer' instead.
  */
-export declare class ExplorerApp {
-    private readonly _root;
-    private readonly _registry;
-    private readonly _daemonModel?;
-    constructor(element: HTMLElement, fixtureModules: FixtureModules);
-    private _initializeDaemonModel;
-    private _populateRegistry;
-    /**
-     * Updates the fixtures. The UI will update automatically since the registry is observable.
-     */
-    updateFixtures(fixtureModules: FixtureModules): void;
-    /**
-     * No-op for ExplorerApp (only meaningful for CliRuntime).
-     * Present so the plugin's HMR wiring can call it polymorphically.
-     */
-    bumpVersion(): void;
-    /**
-     * Unmounts the explorer and cleans up resources.
-     */
-    dispose(): void;
-}
+export { defineFixture, defineFixtureGroup, defineFixtureVariants, singleFixtureBrand, fixtureGroupBrand, fixtureVariantsBrand, } from './core/fixtureApi.js';
+export type { DefineFixtureOptions, DefineComponentOptions, FixtureExport, SingleFixtureExport, FixtureGroupExport, FixtureVariantsExport, FixtureGroupEntry, FixtureGroupInput, FixtureVariantsInput, IDisposable, Disposable, StyleDefinition, DisplayMode, PageMode, ComponentMode, ViewportPreset, ViewportPresetName, PropertySchema, BooleanProperty, StringProperty, NumberProperty, EnumProperty, } 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":"AACA,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EAAuC,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,cAAc,CAAC;AAEtB,OAAO,uCAAuC,CAAC;AAC/C,OAAO,wCAAwC,CAAC;AAOhD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAG/B,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE9G;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAc;gBAEhC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc;IAOhE,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,cAAc,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAIpD;;;OAGG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}
+{"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,UAAU,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,GACf,MAAM,qBAAqB,CAAC"}