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

package/dist/daemon/DaemonModel.d.ts

@@ -0,0 +1,59 @@
+import { IObservable } from '@vscode/observables';
+import { DaemonApiType } from '@vscode/component-explorer-cli/daemon-types';
+import { DaemonConfig } from './DaemonConfig.js';
+/** Screenshot result from the daemon */
+export type DaemonScreenshotResult = DaemonApiType['screenshots']['take']['TResult'];
+/** Comparison result from the daemon */
+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.
+ */
+export declare class DaemonModel {
+    readonly config: DaemonConfig;
+    private readonly _sourceTreeIds;
+    private readonly _sessions;
+    private readonly _screenshotCache;
+    private readonly _client;
+    private _eventStreamAbort;
+    readonly sessionName: string;
+    /** Observable map of sessionName → current sourceTreeId */
+    readonly sourceTreeIds: IObservable<ReadonlyMap<string, string>>;
+    /** Observable list of sessions from the daemon */
+    readonly sessions: IObservable<readonly DaemonSession[]>;
+    constructor(config: DaemonConfig);
+    /**
+     * Initializes the model: fetches initial session info and starts listening to events.
+     * Call this once after construction.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get a screenshot for a fixture in a session, using cache when available.
+     * Cache is keyed on sessionName + fixtureId and invalidated when sourceTreeId changes.
+     */
+    getScreenshot(sessionName: string, fixtureId: string): Promise<DaemonScreenshotResult>;
+    /**
+     * Compare a fixture across two sessions. Returns match status and hashes (no images).
+     */
+    compare(fixtureId: string, baselineSessionName: string, currentSessionName: string): Promise<DaemonCompareResult>;
+    /**
+     * List fixtures from a session.
+     */
+    listFixtures(sessionName: string): Promise<readonly DaemonFixtureInfo[]>;
+    /**
+     * Get the explorer URL for a different session (for session switching via full navigation).
+     */
+    getSessionExplorerUrl(sessionName: string): string | undefined;
+    dispose(): void;
+    private _fetchSessionInfos;
+    private _startEventStream;
+    private _handleEvent;
+}
+//# sourceMappingURL=DaemonModel.d.ts.map

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

@@ -0,0 +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;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;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"}

package/dist/daemon/index.d.ts

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

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

@@ -0,0 +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,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index-BsQr630j.js

@@ -0,0 +1,80 @@
+const f = Symbol.for("@vscode/component-explorer/singleFixture/v1"), i = Symbol.for("@vscode/component-explorer/fixtureGroup/v1"), u = Symbol.for("@vscode/component-explorer/fixtureVariants/v1");
+function d(t) {
+  return {
+    [f]: !0,
+    _options: t,
+    _path: t.path
+  };
+}
+function p(t, e) {
+  if (e !== void 0) {
+    const r = t;
+    return {
+      [i]: !0,
+      _entries: e,
+      _path: r.path,
+      _labels: r.labels
+    };
+  }
+  return {
+    [i]: !0,
+    _entries: t
+  };
+}
+function l(t, e) {
+  if (e !== void 0) {
+    const r = t;
+    return {
+      [u]: !0,
+      _variants: e,
+      _path: r.path,
+      _labels: r.labels
+    };
+  }
+  return {
+    [u]: !0,
+    _variants: t
+  };
+}
+const c = Promise.resolve();
+function x(t) {
+  const e = t();
+  return {
+    ready: c,
+    dispose: () => {
+      typeof e == "function" ? e() : e && typeof e.dispose == "function" && e.dispose();
+    }
+  };
+}
+function v(t, e) {
+  let r, n = !1;
+  function o() {
+    return t.aborted;
+  }
+  const a = (async () => {
+    if (o())
+      throw new DOMException("Render aborted", "AbortError");
+    if (r = await e(), (o() || n) && (s(), o()))
+      throw new DOMException("Render aborted", "AbortError");
+  })();
+  function s() {
+    typeof r == "function" ? r() : r && typeof r.dispose == "function" && r.dispose(), r = void 0;
+  }
+  return {
+    ready: a,
+    dispose: () => {
+      n = !0, s();
+    }
+  };
+}
+export {
+  u as a,
+  v as b,
+  p as c,
+  d,
+  l as e,
+  i as f,
+  x as g,
+  f as s
+};
+//# sourceMappingURL=index-BsQr630j.js.map

package/dist/index-BsQr630j.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BsQr630j.js","sources":["../src/core/fixtureApi.ts"],"sourcesContent":["/**\n * Public Fixture API\n * \n * This module is the public API for defining fixtures.\n * It's designed to be stable across versions - projects can use a different\n * @vscode/component-explorer version than the explorer viewer uses.\n * \n * Use Symbol.for() instead of Symbol() so the same symbol is shared across\n * different versions of this package.\n *\n * @module fixtureApi\n */\n\n// ============================================================================\n// Types for fixture definition (re-exported for convenience)\n// ============================================================================\n\n/**\n * Disposable resource that can be cleaned up.\n */\nexport interface IDisposable {\n  dispose(): void;\n}\n\n/** @deprecated Use IDisposable instead */\nexport type Disposable = IDisposable;\n\n/**\n * Result of a render operation.\n * Supports both sync and async rendering with cancellation.\n * All fields are optional for simple use cases.\n */\nexport interface RenderResult {\n  /**\n   * Resolves when the component is fully rendered and ready.\n   * For sync renders, this can be omitted (treated as immediately ready).\n   * Rejects if the render is aborted via the AbortSignal.\n   */\n  readonly ready?: Promise<void>;\n  \n  /**\n   * Cleanup function. Called when the fixture is unmounted.\n   * Can be omitted if no cleanup is needed.\n   */\n  dispose?(): void;\n}\n\n/**\n * What the render function can return.\n * - undefined: no cleanup needed, immediately ready\n * - RenderResult: object with optional ready/dispose\n * - Promise<...>: async render that resolves to undefined or RenderResult\n */\nexport type RenderReturn = RenderResult | undefined | void | Promise<RenderResult | undefined | void>;\n\n/**\n * Context passed to the render function.\n */\nexport interface RenderContext {\n  /** Property values based on the property schema */\n  readonly props: Record<string, unknown>;\n  /** AbortSignal for cancellation; check signal.aborted or listen to 'abort' event */\n  readonly signal: AbortSignal;\n}\n\n/**\n * Style definition for shadow DOM injection.\n */\nexport type StyleDefinition =\n  | { readonly type: 'css'; readonly content: string }\n  | { readonly type: 'url'; readonly href: string }\n  | { readonly type: 'adopted'; readonly sheet: CSSStyleSheet };\n\n/**\n * Display mode for a component.\n */\nexport type DisplayMode = PageMode | ComponentMode;\n\n/**\n * Page mode - component fills a viewport with device presets.\n */\nexport interface PageMode {\n  readonly type: 'page';\n  readonly viewports: ViewportPreset[];\n}\n\n/**\n * Component mode - renders at natural size.\n */\nexport interface ComponentMode {\n  readonly type: 'component';\n}\n\n/**\n * Viewport preset - either a named preset or custom dimensions.\n */\nexport type ViewportPreset =\n  | ViewportPresetName\n  | { readonly name: string; readonly width: number; readonly height: number };\n\nexport type ViewportPresetName = 'mobile' | 'tablet' | 'desktop';\n\n/**\n * Schema for a component property.\n */\nexport type PropertySchema =\n  | BooleanProperty\n  | StringProperty\n  | NumberProperty\n  | EnumProperty;\n\nexport interface BooleanProperty {\n  readonly type: 'boolean';\n  readonly name: string;\n  readonly defaultValue: boolean;\n  readonly description?: string;\n}\n\nexport interface StringProperty {\n  readonly type: 'string';\n  readonly name: string;\n  readonly defaultValue: string;\n  readonly description?: string;\n  readonly multiline?: boolean;\n}\n\nexport interface NumberProperty {\n  readonly type: 'number';\n  readonly name: string;\n  readonly defaultValue: number;\n  readonly description?: string;\n  readonly min?: number;\n  readonly max?: number;\n  readonly step?: number;\n}\n\nexport interface EnumProperty {\n  readonly type: 'enum';\n  readonly name: string;\n  readonly defaultValue: string;\n  readonly description?: string;\n  readonly options: readonly string[];\n}\n\n// ============================================================================\n// Brand symbols - use Symbol.for() for cross-version compatibility\n// ============================================================================\n\n/** Brand symbol to identify single fixtures */\nexport const singleFixtureBrand = Symbol.for('@vscode/component-explorer/singleFixture/v1');\n\n/** Brand symbol to identify fixture groups */\nexport const fixtureGroupBrand = Symbol.for('@vscode/component-explorer/fixtureGroup/v1');\n\n/** Brand symbol to identify fixture variants */\nexport const fixtureVariantsBrand = Symbol.for('@vscode/component-explorer/fixtureVariants/v1');\n\n// ============================================================================\n// Define fixture options\n// ============================================================================\n\n/**\n * Options for defining a single component fixture.\n */\nexport interface DefineFixtureOptions {\n  /**\n   * Path in the explorer tree.\n   * - `undefined` (default): use fixture filename only\n   * - `'Foo/Bar'`: exact path (fixture filename NOT appended)\n   * - `'Foo/Bar/'`: prefix (fixture filename IS appended → Foo/Bar/{filename})\n   * \n   * @throws Error if path contains empty segments (e.g., '/foo', 'foo//bar')\n   */\n  path?: string;\n\n  /** Optional description for documentation */\n  description?: string;\n\n  /** How to isolate: 'iframe' for full isolation, 'shadow-dom' (default) for lighter isolation */\n  isolation?: 'iframe' | 'shadow-dom';\n\n  /** Display mode: defaults to { type: 'component' } */\n  displayMode?: DisplayMode;\n\n  /** Styles to inject (for shadow-dom isolation) */\n  styles?: StyleDefinition[];\n\n  /** Background pattern for the preview canvas: 'light' (default) or 'dark' for dark transparent pattern */\n  background?: 'light' | 'dark';\n\n  /** Labels for categorization and filtering (e.g. 'animation', 'blocks-ci') */\n  labels?: readonly string[];\n\n  /** Property definitions */\n  properties?: PropertySchema[];\n\n  /**\n   * Render the component into the container.\n   * \n   * @param container - The DOM element to render into\n   * @param context - Render context containing props and abort signal\n   * @returns Optional RenderResult, or a Promise that resolves to one\n   */\n  render: (container: HTMLElement, context: RenderContext) => RenderReturn;\n}\n\n/** @deprecated Use DefineFixtureOptions instead */\nexport type DefineComponentOptions = DefineFixtureOptions;\n\n// ============================================================================\n// Fixture export types (opaque to the user, consumed by fixtureApiConsumer)\n// ============================================================================\n\n/**\n * A single fixture export created by defineFixture().\n */\nexport interface SingleFixtureExport {\n  readonly [singleFixtureBrand]: true;\n  readonly _options: DefineFixtureOptions;\n  readonly _path?: string;\n}\n\n/**\n * Group entry: either a single fixture, a nested group, or variants.\n */\nexport type FixtureGroupEntry = SingleFixtureExport | FixtureGroupExport | FixtureVariantsExport;\n\n/**\n * A fixture group export created by defineFixtureGroup().\n */\nexport interface FixtureGroupExport {\n  readonly [fixtureGroupBrand]: true;\n  readonly _entries: { [key: string]: FixtureGroupEntry };\n  readonly _path?: string;\n  readonly _labels?: readonly string[];\n}\n\n/**\n * A fixture variants export created by defineFixtureVariants().\n */\nexport interface FixtureVariantsExport {\n  readonly [fixtureVariantsBrand]: true;\n  readonly _variants: { [key: string]: SingleFixtureExport };\n  readonly _path?: string;\n  readonly _labels?: readonly string[];\n}\n\n/**\n * Fixture export type - a single fixture, a group, or variants.\n */\nexport type FixtureExport = SingleFixtureExport | FixtureGroupExport | FixtureVariantsExport;\n\n/**\n * Input for defineFixtureGroup.\n */\nexport type FixtureGroupInput = { [key: string]: FixtureGroupEntry };\n\n/**\n * Options for defineFixtureGroup with optional path.\n */\nexport interface DefineFixtureGroupOptions {\n  /**\n   * Path in the explorer tree.\n   * - `undefined` (default): use fixture filename only\n   * - `'Foo/Bar'`: exact path (fixture filename NOT appended)\n   * - `'Foo/Bar/'`: prefix (fixture filename IS appended → Foo/Bar/{filename})\n   */\n  path?: string;\n\n  /** Labels for categorization and filtering (e.g. 'animation', 'blocks-ci') */\n  labels?: readonly string[];\n}\n\n/**\n * Input for defineFixtureVariants (only single fixtures, no nesting).\n */\nexport type FixtureVariantsInput = { [key: string]: SingleFixtureExport };\n\n/**\n * Options for defineFixtureVariants with optional path.\n */\nexport interface DefineFixtureVariantsOptions {\n  /**\n   * Path in the explorer tree.\n   * - `undefined` (default): use fixture filename only  \n   * - `'Foo/Bar'`: exact path (fixture filename NOT appended)\n   * - `'Foo/Bar/'`: prefix (fixture filename IS appended → Foo/Bar/{filename})\n   */\n  path?: string;\n\n  /** Labels for categorization and filtering (e.g. 'animation', 'blocks-ci') */\n  labels?: readonly string[];\n}\n\n// ============================================================================\n// Define fixture functions\n// ============================================================================\n\n/**\n * Defines a single fixture.\n * \n * @example\n * ```ts\n * // Simple - no cleanup needed\n * export default defineFixture({\n *   render: (container, { props }) => {\n *     container.innerHTML = `<button>${props.label}</button>`;\n *   },\n * });\n * \n * // With cleanup\n * export default defineFixture({\n *   render: (container, { props }) => {\n *     const root = createRoot(container);\n *     root.render(<Button label={props.label} />);\n *     return { dispose: () => root.unmount() };\n *   },\n * });\n * \n * // Async render\n * export default defineFixture({\n *   render: async (container, { props, signal }) => {\n *     const data = await fetch(props.url, { signal });\n *     container.innerHTML = await data.text();\n *     return { dispose: () => { container.innerHTML = ''; } };\n *   },\n * });\n * ```\n */\nexport function defineFixture(options: DefineFixtureOptions): SingleFixtureExport {\n  return {\n    [singleFixtureBrand]: true,\n    _options: options,\n    _path: options.path,\n  };\n}\n\n/**\n * Defines a group of fixtures with support for nesting.\n * \n * @example\n * ```ts\n * export default defineFixtureGroup({\n *   Primary: defineFixture({\n *     render: (container) => { ... },\n *   }),\n *   Variants: defineFixtureGroup({\n *     Small: defineFixture({ ... }),\n *     Large: defineFixture({ ... }),\n *   }),\n * });\n * ```\n */\nexport function defineFixtureGroup(entries: FixtureGroupInput): FixtureGroupExport;\nexport function defineFixtureGroup(options: DefineFixtureGroupOptions, entries: FixtureGroupInput): FixtureGroupExport;\nexport function defineFixtureGroup(optionsOrEntries: DefineFixtureGroupOptions | FixtureGroupInput, maybeEntries?: FixtureGroupInput): FixtureGroupExport {\n  if (maybeEntries !== undefined) {\n    const opts = optionsOrEntries as DefineFixtureGroupOptions;\n    return {\n      [fixtureGroupBrand]: true,\n      _entries: maybeEntries,\n      _path: opts.path,\n      _labels: opts.labels,\n    };\n  }\n  return {\n    [fixtureGroupBrand]: true,\n    _entries: optionsOrEntries as FixtureGroupInput,\n  };\n}\n\n/**\n * Defines a group of fixture variants (no nesting allowed).\n * Variants are rendered horizontally by default and have a distinct icon in the tree.\n * \n * @example\n * ```ts\n * export default defineFixtureGroup({\n *   Button: defineFixtureVariants({\n *     Small: defineFixture({ ... }),\n *     Medium: defineFixture({ ... }),\n *     Large: defineFixture({ ... }),\n *   }),\n * });\n * ```\n */\nexport function defineFixtureVariants(variants: FixtureVariantsInput): FixtureVariantsExport;\nexport function defineFixtureVariants(options: DefineFixtureVariantsOptions, variants: FixtureVariantsInput): FixtureVariantsExport;\nexport function defineFixtureVariants(optionsOrVariants: DefineFixtureVariantsOptions | FixtureVariantsInput, maybeVariants?: FixtureVariantsInput): FixtureVariantsExport {\n  if (maybeVariants !== undefined) {\n    const opts = optionsOrVariants as DefineFixtureVariantsOptions;\n    return {\n      [fixtureVariantsBrand]: true,\n      _variants: maybeVariants,\n      _path: opts.path,\n      _labels: opts.labels,\n    };\n  }\n  return {\n    [fixtureVariantsBrand]: true,\n    _variants: optionsOrVariants as FixtureVariantsInput,\n  };\n}\n\n// ============================================================================\n// Render helpers\n// ============================================================================\n\n/** Already-resolved promise, reused for efficiency */\nconst resolvedPromise = Promise.resolve();\n\n/**\n * Helper for synchronous renders.\n * Executes the render function immediately and wraps the cleanup in a RenderResult.\n * \n * @param doRender - Function that renders synchronously and returns a cleanup function\n * @returns A RenderResult with an already-resolved ready promise\n * \n * @example\n * ```ts\n * render: (container, { props }) => syncRender(() => {\n *   const el = document.createElement('button');\n *   el.textContent = props.label;\n *   container.appendChild(el);\n *   return () => el.remove();\n * })\n * ```\n */\nexport function syncRender(doRender: () => (() => void) | IDisposable | void): RenderResult {\n  const cleanup = doRender();\n  return {\n    ready: resolvedPromise,\n    dispose: () => {\n      if (typeof cleanup === 'function') {\n        cleanup();\n      } else if (cleanup && typeof cleanup.dispose === 'function') {\n        cleanup.dispose();\n      }\n    },\n  };\n}\n\n/**\n * Helper for asynchronous renders with cancellation support.\n * \n * @param signal - AbortSignal for cancellation\n * @param doRender - Async function that renders and returns a cleanup function.\n *                   Should check signal.aborted periodically for long operations.\n * @returns A RenderResult whose ready promise rejects with AbortError if cancelled\n * \n * @example\n * ```ts\n * render: (container, { props, signal }) => asyncRender(signal, async () => {\n *   const data = await fetchData(props.url, { signal });\n *   if (signal.aborted) return;\n *   container.innerHTML = data;\n *   return () => { container.innerHTML = ''; };\n * })\n * ```\n */\nexport function asyncRender(\n  signal: AbortSignal,\n  doRender: () => Promise<(() => void) | IDisposable | void>\n): RenderResult {\n  let cleanup: (() => void) | IDisposable | void;\n  let disposed = false;\n\n  function isAborted(): boolean {\n    return signal.aborted;\n  }\n\n  const ready = (async () => {\n    if (isAborted()) {\n      throw new DOMException('Render aborted', 'AbortError');\n    }\n    cleanup = await doRender();\n    if (isAborted() || disposed) {\n      // Cleanup immediately if aborted/disposed during render\n      doCleanup();\n      if (isAborted()) {\n        throw new DOMException('Render aborted', 'AbortError');\n      }\n    }\n  })();\n\n  function doCleanup(): void {\n    if (typeof cleanup === 'function') {\n      cleanup();\n    } else if (cleanup && typeof cleanup.dispose === 'function') {\n      cleanup.dispose();\n    }\n    cleanup = undefined;\n  }\n\n  return {\n    ready,\n    dispose: () => {\n      disposed = true;\n      doCleanup();\n    },\n  };\n}\n"],"names":["singleFixtureBrand","fixtureGroupBrand","fixtureVariantsBrand","defineFixture","options","defineFixtureGroup","optionsOrEntries","maybeEntries","opts","defineFixtureVariants","optionsOrVariants","maybeVariants","resolvedPromise","syncRender","doRender","cleanup","asyncRender","signal","disposed","isAborted","ready","doCleanup"],"mappings":"AAqJO,MAAMA,IAAqB,OAAO,IAAI,6CAA6C,GAG7EC,IAAoB,OAAO,IAAI,4CAA4C,GAG3EC,IAAuB,OAAO,IAAI,+CAA+C;AA8KvF,SAASC,EAAcC,GAAoD;AAChF,SAAO;AAAA,IACL,CAACJ,CAAkB,GAAG;AAAA,IACtB,UAAUI;AAAA,IACV,OAAOA,EAAQ;AAAA,EAAA;AAEnB;AAoBO,SAASC,EAAmBC,GAAiEC,GAAsD;AACxJ,MAAIA,MAAiB,QAAW;AAC9B,UAAMC,IAAOF;AACb,WAAO;AAAA,MACL,CAACL,CAAiB,GAAG;AAAA,MACrB,UAAUM;AAAA,MACV,OAAOC,EAAK;AAAA,MACZ,SAASA,EAAK;AAAA,IAAA;AAAA,EAElB;AACA,SAAO;AAAA,IACL,CAACP,CAAiB,GAAG;AAAA,IACrB,UAAUK;AAAA,EAAA;AAEd;AAmBO,SAASG,EAAsBC,GAAwEC,GAA6D;AACzK,MAAIA,MAAkB,QAAW;AAC/B,UAAMH,IAAOE;AACb,WAAO;AAAA,MACL,CAACR,CAAoB,GAAG;AAAA,MACxB,WAAWS;AAAA,MACX,OAAOH,EAAK;AAAA,MACZ,SAASA,EAAK;AAAA,IAAA;AAAA,EAElB;AACA,SAAO;AAAA,IACL,CAACN,CAAoB,GAAG;AAAA,IACxB,WAAWQ;AAAA,EAAA;AAEf;AAOA,MAAME,IAAkB,QAAQ,QAAA;AAmBzB,SAASC,EAAWC,GAAiE;AAC1F,QAAMC,IAAUD,EAAA;AAChB,SAAO;AAAA,IACL,OAAOF;AAAA,IACP,SAAS,MAAM;AACb,MAAI,OAAOG,KAAY,aACrBA,EAAA,IACSA,KAAW,OAAOA,EAAQ,WAAY,cAC/CA,EAAQ,QAAA;AAAA,IAEZ;AAAA,EAAA;AAEJ;AAoBO,SAASC,EACdC,GACAH,GACc;AACd,MAAIC,GACAG,IAAW;AAEf,WAASC,IAAqB;AAC5B,WAAOF,EAAO;AAAA,EAChB;AAEA,QAAMG,KAAS,YAAY;AACzB,QAAID;AACF,YAAM,IAAI,aAAa,kBAAkB,YAAY;AAGvD,QADAJ,IAAU,MAAMD,EAAA,IACZK,EAAA,KAAeD,OAEjBG,EAAA,GACIF;AACF,YAAM,IAAI,aAAa,kBAAkB,YAAY;AAAA,EAG3D,GAAA;AAEA,WAASE,IAAkB;AACzB,IAAI,OAAON,KAAY,aACrBA,EAAA,IACSA,KAAW,OAAOA,EAAQ,WAAY,cAC/CA,EAAQ,QAAA,GAEVA,IAAU;AAAA,EACZ;AAEA,SAAO;AAAA,IACL,OAAAK;AAAA,IACA,SAAS,MAAM;AACb,MAAAF,IAAW,IACXG,EAAA;AAAA,IACF;AAAA,EAAA;AAEJ;"}

package/dist/index.d.ts

@@ -1,31 +1,11 @@
-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 interface FixtureModules {
-    [path: string]: {
-        default?: unknown;
-    };
-}
 /**
- * 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;
-    constructor(element: HTMLElement, fixtureModules: FixtureModules);
-    private _populateRegistry;
-    /**
-     * Updates the fixtures. The UI will update automatically since the registry is observable.
-     */
-    updateFixtures(fixtureModules: FixtureModules): 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';
 //# 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;AAGhC,OAAO,cAAc,CAAC;AAEtB,OAAO,uCAAuC,CAAC;AAC/C,OAAO,wCAAwC,CAAC;AAMhD,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;AAE5D,MAAM,WAAW,cAAc;IAC7B,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACvC;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;gBAEvC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc;IAMhE,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,cAAc,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAIpD;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}
+{"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"}