@pygmalionjs/pygmalion 0.5.14 → 0.5.15

package/types.d.ts

@@ -1,2675 +0,0 @@
-// Package public type — used by the host repo's tsc to interpret pygmalion import.
-// (lib build doesn't generate d.ts , so keep it by hand — in sync with src/lib.tsx · src/editor/registry.ts )
-import type {
-  ComponentType,
-  CSSProperties,
-  ReactElement,
-  ReactNode,
-} from 'react';
-
-export interface RegistryEntry {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  component: ComponentType<any>;
-  /** Previewable props. Boolean vocabularies become On/Off controls; other values become selects. */
-  props?: Record<string, readonly RegistryPropValue[]>;
-  /** Optional human-readable labels for preview controls. */
-  propLabels?: Readonly<Record<string, string>>;
-  /** Default props when inserting. */
-  defaultProps?: Record<string, RegistryPropValue>;
-  /** 'text' = children Edit string · 'nodes' = Place canvas nodes as children (Card, etc.). */
-  children?: 'text' | 'none' | 'nodes';
-  /**
-   * Whether a captured screen subtree may be REPLACED by this entry when a
-   * screen is imported. Declare it only for entries that render the real
-   * component from literal props — a catalog demo or a fixture-seeded adapter
-   * draws its own sample content, so collapsing into it swaps the captured
-   * screen for that sample. Default false.
-   */
-  collapsible?: boolean;
-  /** Static children default values ​​to use when inserting from the palette. */
-  defaultChildren?: string;
-  /** Path for generating codegen import statements. */
-  importPath?: string;
-  /** In inspection mode, only actually valid dynamic cases are exposed. */
-  casePreview?: {
-    /** Whether the text varies in length at runtime, such as user input/API response. */
-    text?: boolean;
-    /** A preview of what states the component actually supports. */
-    states?: readonly ('selected' | 'disabled' | 'loading')[];
-  };
-}
-
-export type ComponentRegistry = Record<string, RegistryEntry>;
-export type RegistryPropValue = string | number | boolean;
-
-export type DesignConnectionPropertyKind =
-  | 'text'
-  | 'boolean'
-  | 'variant'
-  | 'instance'
-  | 'slot';
-
-export interface DesignComponentReference {
-  provider: string;
-  documentId?: string;
-  nodeId: string;
-  url?: string;
-  name?: string;
-}
-
-export interface DesignConnectionPropertyDef {
-  designName: string;
-  kind: DesignConnectionPropertyKind;
-  values?: readonly string[];
-  defaultValue?: string | boolean;
-  codeProperty?: string;
-  valueMap?: Readonly<Record<string, string | boolean>>;
-  omitReason?: string;
-}
-
-export interface DesignComponentConnectionDef {
-  id: string;
-  componentName: string;
-  design: DesignComponentReference;
-  code?: { sourcePath?: string; importPath?: string };
-  properties?: readonly DesignConnectionPropertyDef[];
-}
-
-export interface DesignConnectionDiagnostic {
-  severity: 'warning' | 'error';
-  code: string;
-  message: string;
-  connectionId: string;
-  property?: string;
-}
-
-export interface DesignComponentConnectionCase {
-  id: string;
-  label: string;
-  designValues: Readonly<Record<string, string | boolean>>;
-  codeProps: Readonly<Record<string, string | boolean>>;
-}
-
-export interface DesignComponentConnectionCases {
-  connectionId: string;
-  cases: readonly DesignComponentConnectionCase[];
-  total: number;
-  truncated: { total: number; limit: number } | null;
-  diagnostics: readonly DesignConnectionDiagnostic[];
-}
-
-export interface CodegenFrameOptions {
-  fill?: string;
-  opacity?: number;
-  radius?: number;
-  clipContent?: boolean;
-}
-
-export type DesignCompilePurpose = 'interactive' | 'export';
-export type DesignCompileSeverity = 'info' | 'warning' | 'error';
-export type DesignCompileStage =
-  | 'normalize'
-  | 'analyze'
-  | 'generate'
-  | 'resource';
-export type DesignCompileStatus = 'ready' | 'deferred' | 'blocked';
-
-export interface DesignCompileDiagnostic {
-  severity: DesignCompileSeverity;
-  stage: DesignCompileStage;
-  code: string;
-  message: string;
-  nodeId?: string;
-  nodePath?: string;
-  details?: Readonly<Record<string, string | number | boolean>>;
-}
-
-export interface DesignIRAsset {
-  id: string;
-  kind: 'image' | 'video' | 'background';
-  source: string;
-  portability: 'embedded' | 'remote' | 'project' | 'ephemeral';
-  nodeIds: readonly string[];
-}
-
-export interface DesignIRComponent {
-  name: string;
-  importPath: string;
-  registered: boolean;
-  connectionId?: string;
-  sourcePath?: string;
-  design?: {
-    provider: string;
-    documentId?: string;
-    nodeId: string;
-    url?: string;
-  };
-  nodeIds: readonly string[];
-}
-
-export interface DesignIRMetrics {
-  nodeCount: number;
-  maxDepth: number;
-  hiddenNodeCount: number;
-  componentCount: number;
-  assetCount: number;
-}
-
-export interface DesignIntermediateDocumentV1 {
-  schema: 'pygmalion.design-ir';
-  version: 1;
-  root: NodeJSON;
-  frame?: CodegenFrameOptions;
-  components: readonly DesignIRComponent[];
-  assets: readonly DesignIRAsset[];
-  metrics: DesignIRMetrics;
-}
-
-export interface DesignCompileLimits {
-  previewNodeLimit: number;
-  maxNodes: number;
-  maxDepth: number;
-  maxOutputBytes: number;
-}
-
-export interface DesignCodegenAdapterContext {
-  document: DesignIntermediateDocumentV1;
-}
-
-export interface DesignCodegenAdapterOutput {
-  code: string;
-  diagnostics?: readonly DesignCompileDiagnostic[];
-}
-
-export interface DesignCodegenAdapter {
-  id: string;
-  label: string;
-  language: string;
-  extension: string;
-  generate(
-    context: DesignCodegenAdapterContext,
-  ): string | DesignCodegenAdapterOutput;
-}
-
-export interface DesignCompileOptions {
-  target?: string;
-  purpose?: DesignCompilePurpose;
-  force?: boolean;
-  frame?: CodegenFrameOptions;
-  limits?: Partial<DesignCompileLimits>;
-}
-
-export interface DesignCompileResult {
-  target: string;
-  status: DesignCompileStatus;
-  code: string;
-  language?: string;
-  extension?: string;
-  document: DesignIntermediateDocumentV1;
-  diagnostics: readonly DesignCompileDiagnostic[];
-  metrics: DesignIRMetrics & { outputBytes: number };
-}
-
-export const DESIGN_IR_SCHEMA: 'pygmalion.design-ir';
-export const DESIGN_IR_VERSION: 1;
-export const DEFAULT_DESIGN_COMPILE_LIMITS: Readonly<DesignCompileLimits>;
-
-export type DesignCatalogKind =
-  'icons' | 'design-tokens' | 'atoms' | 'components';
-
-export interface DesignCatalogItem {
-  id: string;
-  name: string;
-  section: string;
-  sourcePath?: string;
-  codeName?: string;
-  description?: string;
-}
-
-export interface DesignCatalogPageDescriptor {
-  id: string;
-  name: string;
-  section: string;
-}
-
-export interface DesignCatalogFrame {
-  width: number;
-  height: number;
-}
-
-export interface DesignCatalogBuild {
-  registry: ComponentRegistry;
-  collection: DesignImportCollection;
-}
-
-export interface DesignGalleryCatalogOptions<T extends DesignCatalogItem> {
-  kind: 'icons' | 'design-tokens';
-  items: readonly T[];
-  expectedCount?: number;
-  pageFor: (item: T) => DesignCatalogPageDescriptor;
-  renderPreview: (item: T) => ReactNode;
-  secondaryLabel?: (item: T) => ReactNode;
-  frame?:
-    | DesignCatalogFrame
-    | ((
-        page: DesignCatalogPageDescriptor,
-        items: readonly T[],
-      ) => DesignCatalogFrame);
-  minimumColumnWidth?: number;
-  registryPrefix?: string;
-}
-
-export interface DesignComponentCatalogOptions {
-  kind: 'atoms' | 'components';
-  items: readonly DesignCatalogItem[];
-  registry: ComponentRegistry;
-  expectedCount?: number;
-  maxVariantCells?: number;
-  registryPrefix?: string;
-}
-
-export interface DesignComponentVariantMatrix {
-  row?: readonly [name: string, values: readonly RegistryPropValue[]];
-  column?: readonly [name: string, values: readonly RegistryPropValue[]];
-  fixed: readonly (readonly [name: string, value: RegistryPropValue])[];
-  additional: readonly (readonly [name: string, values: readonly RegistryPropValue[]])[];
-}
-
-export interface PygmalionCatalogDocumentProps {
-  title: ReactNode;
-  eyebrow?: ReactNode;
-  description?: ReactNode;
-  version?: ReactNode;
-  meta?: ReactNode;
-  children: ReactNode;
-  headerBackground?: string;
-  headerColor?: string;
-  bodyBackground?: string;
-  bodyGap?: number;
-}
-
-export interface PygmalionCatalogSectionProps {
-  title: ReactNode;
-  /** Inventory id used to select this item when it is opened from Assets. */
-  itemId?: string;
-  count?: number;
-  description?: ReactNode;
-  children: ReactNode;
-  tone?: 'plain' | 'tinted';
-}
-
-export interface PygmalionCatalogMatrixProps {
-  rows: readonly RegistryPropValue[];
-  columns: readonly RegistryPropValue[];
-  cornerLabel?: ReactNode;
-  renderCell: (row: RegistryPropValue, column: RegistryPropValue) => ReactNode;
-  renderRowLabel?: (row: RegistryPropValue) => ReactNode;
-  renderColumnLabel?: (column: RegistryPropValue) => ReactNode;
-  boundary?: boolean;
-  cellStyle?: CSSProperties;
-}
-
-export declare function PygmalionCatalogDocument(
-  props: PygmalionCatalogDocumentProps,
-): ReactElement;
-export declare function PygmalionCatalogSection(
-  props: PygmalionCatalogSectionProps,
-): ReactElement;
-export declare function PygmalionCatalogMatrix(
-  props: PygmalionCatalogMatrixProps,
-): ReactElement;
-
-export declare function designCatalogKey(value: string): string;
-export declare function designCatalogRegistryName(
-  kind: DesignCatalogKind,
-  id: string,
-  prefix?: string,
-): string;
-export declare function createDesignGalleryCatalog<T extends DesignCatalogItem>(
-  options: DesignGalleryCatalogOptions<T>,
-): DesignCatalogBuild;
-export declare function createDesignComponentVariantMatrix(
-  entry: RegistryEntry | undefined,
-  maxCells?: number,
-): DesignComponentVariantMatrix;
-export declare function createDesignComponentCatalog(
-  options: DesignComponentCatalogOptions,
-): DesignCatalogBuild;
-
-export interface TokenDef {
-  /** CSS variable name — e.g. `--app-color-surface-brand`. */
-  name: string;
-  /** Value for swatch display (hex, etc., light). Canvas is rendered with var(name). */
-  value: string;
-  /** Dark mode value (swatch half-and-half display). */
-  dark?: string;
-  group?: string;
-}
-
-export interface ViewportPresetDef {
-  /** Button text. The panel column is narrow, so keep it to a few characters. */
-  label: string;
-  /** Frame width in CSS pixels. */
-  width: number;
-  /** Frame height. Omit to resize width only and leave the current height alone. */
-  height?: number;
-  /** Tooltip text. Defaults to the dimensions. */
-  description?: string;
-}
-
-export interface PreviewEnvironmentControlOptionDef {
-  value: string;
-  label: string;
-  description?: string;
-  environment?: StoryboardEnvironment;
-}
-
-export interface PreviewEnvironmentControlDef {
-  id: string;
-  label: string;
-  description?: string;
-  defaultValue: string;
-  options: readonly PreviewEnvironmentControlOptionDef[];
-}
-
-export const DESIGN_IMPORT_KINDS: readonly [
-  'icons',
-  'design-tokens',
-  'atoms',
-  'components',
-  'screens',
-];
-export type DesignImportKind = (typeof DESIGN_IMPORT_KINDS)[number];
-export type DesignFrameSizeMode = 'fixed' | 'content';
-export type DesignFrameHeightMode = 'fixed' | 'document';
-
-export interface DesignImportAsset {
-  id: string;
-  name: string;
-  section: string;
-  pageId: string;
-  sourcePath?: string;
-  codeName?: string;
-  flow?: string;
-  scenarioId?: string;
-  description?: string;
-}
-
-export type DesignScreenInteractionAction =
-  'click' | 'focus' | 'fill' | 'check' | 'press' | 'wait' | 'storage';
-
-export interface DesignScreenInteraction {
-  action: DesignScreenInteractionAction;
-  label: string;
-  selector?: string;
-  text?: string;
-  exact?: boolean;
-  index?: number;
-  /** A wait step observes visible elements by default. Use attached to wait for DOM insertion only. */
-  waitState?: 'visible' | 'attached';
-  value?: string;
-  key?: string;
-  storage?: 'local' | 'session';
-  timeoutMs?: number;
-  settleMs?: number;
-  optional?: boolean;
-}
-
-export type DesignSerializable =
-  | string
-  | number
-  | boolean
-  | null
-  | readonly DesignSerializable[]
-  | { readonly [key: string]: DesignSerializable };
-
-export type DesignScreenPreset = Readonly<Record<string, DesignSerializable>>;
-export type StoryboardPermissionState = 'granted' | 'denied' | 'prompt';
-export type StoryboardMediaFailure =
-  'not-allowed' | 'not-found' | 'not-readable' | 'overconstrained';
-
-export interface StoryboardMediaDevice {
-  kind: 'audioinput' | 'audiooutput' | 'videoinput';
-  deviceId: string;
-  groupId?: string;
-  label?: string;
-}
-
-export interface StoryboardEnvironment {
-  localStorage?: Readonly<Record<string, string | null>>;
-  sessionStorage?: Readonly<Record<string, string | null>>;
-  permissions?: Readonly<Record<string, StoryboardPermissionState>>;
-  mediaDevices?: {
-    devices?: readonly StoryboardMediaDevice[];
-    getUserMedia?: 'passthrough' | StoryboardMediaFailure;
-  };
-  /**
-   * 'sandbox' virtualizes the whole origin storage for the document: reads
-   * of undeclared keys see a pristine profile and writes never reach the
-   * shared storage. Hidden preview instances set it so persisted UI state
-   * from one walk cannot poison sibling instances or the designer's tab.
-   */
-  storageIsolation?: 'sandbox';
-  /**
-   * Host screen preset installed as `window.__PYGMALION_SCREEN_PRESET__` before
-   * application modules execute.
-   */
-  screenPreset?: Readonly<Record<string, unknown>>;
-  /**
-   * Request outcomes, applied by patching fetch and XMLHttpRequest before
-   * application modules execute. A failed request, an empty result, a slow
-   * response — states the product spends real time in that a designer cannot
-   * click their way into. The host says which request, not how to fake it.
-   */
-  network?: StoryboardNetwork;
-}
-
-export type StoryboardRequestOutcome =
-  | { kind: 'fail'; status?: number; message?: string }
-  | { kind: 'empty'; status?: number; body?: string }
-  | { kind: 'slow'; delayMs: number };
-
-export interface StoryboardRequestCondition {
-  /** Matched against the request URL as a substring. */
-  match: string;
-  method?: string;
-  outcome: StoryboardRequestOutcome;
-}
-
-export interface StoryboardNetwork {
-  conditions?: readonly StoryboardRequestCondition[];
-}
-
-export type DesignScreenAssertionVisibility = 'visible' | 'hidden';
-
-export interface DesignScreenAttributeAssertion {
-  name: string;
-  value?: string;
-  match?: 'equals' | 'contains';
-  present?: boolean;
-}
-
-export interface DesignScreenAssertion {
-  label: string;
-  selector: string;
-  index?: number;
-  exists?: boolean;
-  text?: string;
-  exact?: boolean;
-  attribute?: DesignScreenAttributeAssertion;
-  visibility?: DesignScreenAssertionVisibility;
-  timeoutMs?: number;
-  optional?: boolean;
-}
-
-export interface DesignImportPage {
-  id: string;
-  name: string;
-  section: string;
-  componentName?: string;
-  gallery?: string[];
-  route?: string;
-  path?: string;
-  publish?: boolean;
-  width?: number;
-  height?: number;
-  /** `content` replaces the 1×1 measurement seed with actual rendered DOM bounds. */
-  frameSizeMode?: DesignFrameSizeMode;
-  /** `document` expands the frame to the rendered document height. The default remains a fixed viewport. */
-  heightMode?: DesignFrameHeightMode;
-  /** Safety limit used only by document-height frames. Defaults to 12,000px and is capped at 32,000px. */
-  maxHeight?: number;
-  flow?: string;
-  scenario?: string;
-  state?: string;
-  /** Host-declared kind of the state branch (overlay, badge, layout, ...). Presentation hint for the Screen states control. */
-  stateKind?: string;
-  /** Host-declared situation lane the canvas arranges the frame into. */
-  lane?: string;
-  scenarioId?: string;
-  /** Every scenario the screen demonstrates; coverage counts this set. */
-  scenarioIds?: readonly string[];
-  interactions?: readonly DesignScreenInteraction[];
-  environment?: StoryboardEnvironment;
-  preset?: DesignScreenPreset;
-  assertions?: readonly DesignScreenAssertion[];
-}
-
-export interface DesignImportCollection {
-  assets: readonly DesignImportAsset[];
-  pages: readonly DesignImportPage[];
-  expectedCount: number;
-}
-
-export interface DesignScenarioSource {
-  id: string;
-  name?: string;
-  section: string;
-  flow?: string;
-  sourcePath?: string;
-  codeName?: string;
-  description?: string;
-}
-
-export interface DesignScreenCase extends DesignImportPage {
-  scenarioIds?: readonly string[];
-  sourcePath?: string;
-  codeName?: string;
-  coverageRoutes?: readonly string[];
-  /** Names a group of screens that can be captured on one booted page. */
-  session?: string;
-}
-
-export interface DesignBehaviorScenario {
-  id: string;
-  reason: string;
-}
-
-export interface DesignScenarioCoverage {
-  total: number;
-  screen: number;
-  behavior: number;
-  missing: readonly string[];
-  complete: boolean;
-}
-
-export interface DesignScreenCollectionResult {
-  collection: DesignImportCollection;
-  coverage: DesignScenarioCoverage;
-}
-
-export interface DesignScreenViewport {
-  id: string;
-  label: string;
-  width: number;
-  height: number;
-  heightMode?: DesignFrameHeightMode;
-  maxHeight?: number;
-}
-
-export type DesignScreenViewportPagePatch = Partial<
-  Omit<DesignImportPage, 'id' | 'name' | 'section' | 'width' | 'height'>
->;
-
-export interface DesignScreenViewportExpansionOptions {
-  include?: (page: DesignImportPage, viewport: DesignScreenViewport) => boolean;
-  transformPage?: (
-    page: DesignImportPage,
-    viewport: DesignScreenViewport,
-  ) => DesignScreenViewportPagePatch | undefined;
-  createPageId?: (
-    page: DesignImportPage,
-    viewport: DesignScreenViewport,
-  ) => string;
-  createPageName?: (
-    page: DesignImportPage,
-    viewport: DesignScreenViewport,
-  ) => string;
-  createSection?: (
-    page: DesignImportPage,
-    viewport: DesignScreenViewport,
-  ) => string;
-}
-
-export interface DesignImportManifest {
-  sourceSha?: string;
-  registry: ComponentRegistry;
-  tokens: readonly TokenDef[];
-  collections: Record<DesignImportKind, DesignImportCollection>;
-}
-
-export interface DesignImportCoverageItem {
-  expected: number;
-  imported: number;
-  pages: number;
-  missing: number;
-}
-
-export type DesignImportCoverage = Record<
-  DesignImportKind,
-  DesignImportCoverageItem
-> & {
-  sourceSha?: string;
-  complete: boolean;
-};
-
-export interface DesignScreenInteractionReport {
-  complete: boolean;
-  completed: number;
-  total: number;
-  failedLabel?: string;
-  error?: string;
-}
-
-export type DesignScreenCaptureFailureStage =
-  'preset' | 'interaction' | 'assertion';
-export type DesignScreenCaptureFailureCode =
-  | 'preset_executor_missing'
-  | 'preset_rejected'
-  | 'preset_error'
-  | 'interaction_failed'
-  | 'invalid_selector'
-  | 'existence_mismatch'
-  | 'text_mismatch'
-  | 'attribute_mismatch'
-  | 'visibility_mismatch';
-
-export interface DesignScreenCaptureFailure {
-  stage: DesignScreenCaptureFailureStage;
-  code: DesignScreenCaptureFailureCode;
-  message: string;
-  label?: string;
-  index?: number;
-  selector?: string;
-  expected?: DesignSerializable;
-  actual?: DesignSerializable;
-}
-
-export interface DesignScreenAssertionReport {
-  complete: boolean;
-  completed: number;
-  total: number;
-  failures: DesignScreenCaptureFailure[];
-}
-
-export interface DesignScreenCaptureReport {
-  complete: boolean;
-  presetApplied: boolean;
-  interactions: DesignScreenInteractionReport;
-  assertions: DesignScreenAssertionReport;
-  failures: DesignScreenCaptureFailure[];
-  failedLabel?: string;
-  error?: string;
-}
-
-export interface DesignScreenPresetRequest {
-  pageId: string;
-  route?: string;
-  preset: DesignScreenPreset;
-}
-
-export interface DesignScreenPresetContext {
-  iframe: HTMLIFrameElement;
-}
-
-export interface DesignScreenPresetExecutionResult {
-  complete: boolean;
-  message?: string;
-  details?: DesignSerializable;
-}
-
-export type DesignScreenPresetExecutor = (
-  request: DesignScreenPresetRequest,
-  context: DesignScreenPresetContext,
-) =>
-  | Promise<DesignScreenPresetExecutionResult | void>
-  | DesignScreenPresetExecutionResult
-  | void;
-
-export interface DesignScreenCaptureSpec {
-  pageId: string;
-  route?: string;
-  preset?: DesignScreenPreset;
-  interactions?: readonly DesignScreenInteraction[];
-  assertions?: readonly DesignScreenAssertion[];
-}
-
-export interface DesignScreenCaptureDefaults {
-  preset?: DesignScreenPreset;
-  assertions?: readonly DesignScreenAssertion[];
-}
-
-export interface DesignScreenCaptureRequirements {
-  preset?: boolean;
-  assertions?: boolean;
-}
-
-export interface DomImportOptions {
-  instanceMode?: 'collapse' | 'expand' | 'ignore';
-  exclude?: ReadonlySet<string>;
-  scale?: number;
-  maxDepth?: number;
-  maxNodes?: number;
-  includeHidden?: boolean;
-  includeZeroSize?: boolean;
-  mediaMode?: 'placeholder' | 'layers';
-}
-
-export interface NodeJSON {
-  id: string;
-  type: 'rows' | 'columns' | 'text' | 'component';
-  name: string;
-  widthMode: 'fill' | 'fit' | 'fixed';
-  width: number;
-  heightMode: 'fill' | 'fit' | 'fixed';
-  height: number;
-  gap: number;
-  padding: number;
-  justify: 'start' | 'center' | 'end' | 'between';
-  alignItems: 'start' | 'center' | 'end';
-  fill: string;
-  radius: number;
-  borderWidth: number;
-  borderColor: string;
-  opacity: number;
-  hidden: boolean;
-  locked: boolean;
-  text: string;
-  fontSize: number;
-  fontWeight: number;
-  color: string;
-  textAlign: 'left' | 'center' | 'right';
-  componentName: string;
-  componentProps: Record<string, RegistryPropValue>;
-  childrenText: string;
-  domTag: string;
-  domAttributes: Record<string, string>;
-  domStyle: Record<string, string>;
-  sourceComponent?: string;
-  sourceStyle?: string;
-  sourceKey?: string;
-  sourceProps?: Record<string, PrimitiveSourceValue>;
-  linkTo: string;
-  children: NodeJSON[];
-}
-
-export interface DomImportResult {
-  root: NodeJSON;
-  count: number;
-  truncated: boolean;
-  diagnostics: readonly DomImportDiagnostic[];
-  metrics: DomImportMetrics;
-}
-
-export interface DomImportDiagnostic {
-  severity: 'warning';
-  stage: 'capture';
-  code: 'max-nodes' | 'max-depth';
-  message: string;
-  limit: number;
-  actual: number;
-}
-
-export interface DomImportMetrics {
-  nodeCount: number;
-  maxDepth: number;
-}
-
-export type SharedSourceEditScope = 'shared' | 'instance';
-
-export interface SharedSourceFrameSummary {
-  id: string;
-  name: string;
-}
-
-export interface SharedSourceImpact {
-  sourceKey: string;
-  frames: SharedSourceFrameSummary[];
-  nodeCount: number;
-}
-
-export interface DesignImportInitialPage extends InitialPageDef {
-  importLayers?: boolean;
-  importPageId?: string;
-  importKind?: DesignImportKind;
-  assetIds?: string[];
-  sourcePaths?: string[];
-  flow?: string;
-  scenario?: string;
-  state?: string;
-  /** Host-declared kind of the state branch (overlay, badge, layout, ...). Presentation hint for the Screen states control. */
-  stateKind?: string;
-  /** Host-declared situation lane the canvas arranges the frame into. */
-  lane?: string;
-  scenarioId?: string;
-  interactions?: DesignScreenInteraction[];
-  environment?: StoryboardEnvironment;
-  preset?: DesignScreenPreset;
-  assertions?: DesignScreenAssertion[];
-}
-
-export interface DesignImportController {
-  readonly sourceSha?: string;
-  getRegistry(): ComponentRegistry;
-  getTokens(): TokenDef[];
-  getAssets(kind?: DesignImportKind): DesignImportAsset[];
-  getInitialPages(): DesignImportInitialPage[];
-  getCoverage(): DesignImportCoverage;
-  assertComplete(): void;
-  captureElement(
-    element: Element,
-    win?: Window,
-    options?: DomImportOptions,
-  ): DomImportResult | null;
-  captureIframe(
-    iframe: HTMLIFrameElement,
-    options?: DomImportOptions,
-  ): DomImportResult | null;
-  captureIframeWhenStable(
-    iframe: HTMLIFrameElement,
-    options?: DomImportOptions & {
-      settleMs?: number;
-      timeoutMs?: number;
-      minElementCount?: number;
-    },
-  ): Promise<DomImportResult | null>;
-  runScreenInteractions(
-    iframe: HTMLIFrameElement,
-    interactions: readonly DesignScreenInteraction[],
-  ): Promise<DesignScreenInteractionReport>;
-  prepareScreenCapture(
-    iframe: HTMLIFrameElement,
-    spec: DesignScreenCaptureSpec,
-  ): Promise<DesignScreenCaptureReport>;
-}
-
-export interface CreateDesignImportOptions {
-  layerOptions?: DomImportOptions;
-  executeScreenPreset?: DesignScreenPresetExecutor;
-  /**
-   * `section` gives each screen section its own canvas
-   * (`<screens canvas> · <section>`), so the camera, the LOD budget, and
-   * decoded previews scale with a section instead of the whole catalog.
-   */
-  screensCanvasPartition?: 'single' | 'section';
-}
-
-export declare function createDesignImportController(
-  manifest: DesignImportManifest,
-  options?: CreateDesignImportOptions,
-): DesignImportController;
-export declare function createDesignScreenCollection(options: {
-  cases: readonly DesignScreenCase[];
-  scenarios: readonly DesignScenarioSource[];
-  behaviorScenarios?: readonly DesignBehaviorScenario[];
-  captureDefaults?: DesignScreenCaptureDefaults;
-  captureRequirements?: DesignScreenCaptureRequirements;
-}): DesignScreenCollectionResult;
-export declare function expandDesignScreenCasesViewports(
-  cases: readonly DesignScreenCase[],
-  viewports: readonly DesignScreenViewport[],
-  options?: DesignScreenViewportExpansionOptions,
-): DesignScreenCase[];
-export declare function expandDesignScreenCollectionViewports(
-  collection: DesignImportCollection,
-  viewports: readonly DesignScreenViewport[],
-  options?: DesignScreenViewportExpansionOptions,
-): DesignImportCollection;
-export declare function mergeScreenPresets(
-  defaults?: DesignScreenPreset,
-  override?: DesignScreenPreset,
-): DesignScreenPreset;
-
-export declare function setComponentRegistry(r: ComponentRegistry): void;
-export declare function setDesignComponentConnections(
-  connections: readonly DesignComponentConnectionDef[],
-): void;
-export declare function getDesignComponentConnections(): readonly DesignComponentConnectionDef[];
-export declare function getDesignComponentConnection(
-  connectionId: string,
-): DesignComponentConnectionDef | undefined;
-export declare function getDesignComponentConnectionForComponent(
-  componentName: string,
-): DesignComponentConnectionDef | undefined;
-export declare function validateDesignComponentConnections(): readonly DesignConnectionDiagnostic[];
-export declare function enumerateDesignComponentConnectionCases(
-  connectionId: string,
-  options?: { limit?: number },
-): DesignComponentConnectionCases;
-export declare function registerDesignCodegenAdapter(
-  adapter: DesignCodegenAdapter,
-): () => void;
-export declare function getDesignCodegenAdapters(): readonly DesignCodegenAdapter[];
-export declare function createDesignIntermediateDocument(
-  root: NodeJSON,
-  frame?: CodegenFrameOptions,
-): DesignIntermediateDocumentV1;
-export declare function compileDesignDocument(
-  root: NodeJSON,
-  options?: DesignCompileOptions,
-): DesignCompileResult;
-
-export declare function setTokens(t: TokenDef[]): void;
-
-/** Declares the frame widths the panel offers. A malformed entry throws at mount. */
-export declare function setViewportPresets(
-  presets: readonly ViewportPresetDef[],
-): void;
-export declare function getViewportPresets(): ViewportPresetDef[];
-export declare function setPreviewEnvironmentControls(
-  controls: readonly PreviewEnvironmentControlDef[],
-): void;
-export declare function getPreviewEnvironmentControls(): readonly PreviewEnvironmentControlDef[];
-export declare function getPreviewEnvironmentControlValue(
-  controlId: string,
-): string | undefined;
-export declare function setPreviewEnvironmentControlValue(
-  controlId: string,
-  value: string,
-): void;
-export declare function clearPreviewEnvironmentControlValues(): void;
-export declare function getPreviewEnvironmentOverride(): StoryboardEnvironment | undefined;
-export declare function subscribePreviewEnvironmentControls(
-  listener: () => void,
-): () => void;
-
-/** Updates the standard route of the running route iframe. The existing editing status is maintained. */
-export declare function setPygmalionAppOrigin(origin: string): void;
-/** Update the static screen cache when a preview of the same URL points to a new code version. */
-export declare function setPygmalionPreviewRevision(revision: string): void;
-/** Sets the number of actual app iframes to run simultaneously in the entire editor. */
-export declare function setPygmalionPreviewConcurrency(value: number): void;
-/** Returns the adaptive live-preview lane count for the current browser. */
-export declare function getRecommendedPygmalionPreviewConcurrency(capabilities?: {
-  hardwareConcurrency?: number;
-  deviceMemory?: number;
-}): number;
-/** Removes all route screens fixed in memory and IndexedDB. If a namespace is given, only the corresponding cache is deleted. */
-export declare function clearPygmalionPreviewCache(namespace?: string): void;
-export declare const STORYBOARD_ENVIRONMENT_QUERY: string;
-export declare const STORYBOARD_ENVIRONMENT_CONTROL: string;
-export declare function createStoryboardRouteUrl(
-  appOrigin: string,
-  route: string,
-  environment?: StoryboardEnvironment,
-): string;
-export declare function setStoryboardBaselineEnvironment(
-  environment?: StoryboardEnvironment,
-): void;
-export declare function getStoryboardBaselineEnvironment():
-  StoryboardEnvironment | undefined;
-export declare function mergeStoryboardEnvironment(
-  base?: StoryboardEnvironment,
-  override?: StoryboardEnvironment,
-): StoryboardEnvironment | undefined;
-
-export interface RoutePreviewArtifactBundleV1 {
-  version: 1;
-  namespace: string;
-  /** Source SHA at the time of creation. It must match the value before the first ':' of runtime previewRevision. */
-  sourceRevision?: string;
-  snapshots: Record<string, string>;
-}
-
-export interface RoutePreviewArtifactBundleV2 {
-  readonly version: 2;
-  readonly namespace: string;
-  readonly sourceRevision?: string;
-  readonly assets: {
-    readonly head: Readonly<Record<string, string>>;
-    readonly stylesheets: Readonly<Record<string, string>>;
-  };
-  readonly frames: Readonly<
-    Record<
-      string,
-      {
-        readonly document: {
-          readonly doctype: string;
-          readonly htmlAttributes: string;
-          readonly headAttributes: string;
-          readonly bodyAttributes: string;
-        };
-        readonly head: readonly {
-          readonly kind: 'head' | 'stylesheet';
-          readonly hash: string;
-        }[];
-        readonly body: string;
-      }
-    >
-  >;
-}
-
-export type RoutePreviewArtifactV3Status =
-  'ready' | 'rendered-with-qa-failure' | 'capture-error';
-export type RoutePreviewArtifactV3ScreenshotMediaType =
-  'image/png' | 'image/webp';
-
-export interface RoutePreviewArtifactV3Viewport {
-  readonly width: number;
-  readonly height: number;
-}
-
-export interface RoutePreviewArtifactV3Diagnostic {
-  readonly stage: string;
-  readonly code: string;
-  readonly selector?: string;
-  readonly label?: string;
-  readonly message?: string;
-  readonly viewport: RoutePreviewArtifactV3Viewport;
-}
-
-export interface RoutePreviewArtifactV3ScreenshotReference {
-  readonly hash: `sha256-${string}`;
-  readonly mediaType: RoutePreviewArtifactV3ScreenshotMediaType;
-  readonly width: number;
-  readonly height: number;
-}
-
-export interface RoutePreviewArtifactV3ScreenshotAsset {
-  readonly mediaType: RoutePreviewArtifactV3ScreenshotMediaType;
-  readonly width: number;
-  readonly height: number;
-  readonly data: string;
-  readonly byteLength: number;
-}
-
-export interface RoutePreviewArtifactV3Frame {
-  readonly status: RoutePreviewArtifactV3Status;
-  readonly viewport: RoutePreviewArtifactV3Viewport;
-  readonly sourceRevision?: string;
-  readonly fingerprint?: string;
-  readonly snapshot?: RoutePreviewArtifactBundleV2['frames'][string];
-  readonly screenshot?: RoutePreviewArtifactV3ScreenshotReference;
-  readonly diagnostics: readonly RoutePreviewArtifactV3Diagnostic[];
-}
-
-export interface RoutePreviewArtifactBundleV3 {
-  readonly version: 3;
-  readonly namespace: string;
-  readonly sourceRevision?: string;
-  readonly assets: {
-    readonly head: RoutePreviewArtifactBundleV2['assets']['head'];
-    readonly stylesheets: RoutePreviewArtifactBundleV2['assets']['stylesheets'];
-    readonly screenshots: Readonly<
-      Record<string, RoutePreviewArtifactV3ScreenshotAsset>
-    >;
-  };
-  readonly frames: Readonly<Record<string, RoutePreviewArtifactV3Frame>>;
-}
-
-export interface RoutePreviewArtifactV3ValidationResult {
-  readonly valid: boolean;
-  readonly errors: string[];
-  readonly bytes: number;
-}
-
-export interface RoutePreviewArtifactV3ReconstructedScreenshot {
-  readonly mediaType: RoutePreviewArtifactV3ScreenshotMediaType;
-  readonly width: number;
-  readonly height: number;
-  readonly dataUrl: string;
-}
-
-export type RoutePreviewArtifactBundle =
-  | RoutePreviewArtifactBundleV1
-  | RoutePreviewArtifactBundleV2
-  | RoutePreviewArtifactBundleV3;
-
-export declare function validateRoutePreviewArtifactV3Browser(
-  value: unknown,
-): RoutePreviewArtifactV3ValidationResult;
-export declare function reconstructRoutePreviewArtifactSnapshotV3(
-  value: unknown,
-  frameId: string,
-): string | null;
-export declare function reconstructRoutePreviewArtifactScreenshotV3(
-  value: unknown,
-  frameId: string,
-): RoutePreviewArtifactV3ReconstructedScreenshot | null;
-
-export interface PreviewRecipeIdentity {
-  id: string;
-  recipe: unknown;
-}
-
-export interface PreviewCacheNamespaceOptions {
-  sourceRevision: string;
-  recipes: readonly PreviewRecipeIdentity[];
-  recipeVersion?: number;
-  scope?: string;
-}
-
-export type StoryboardCaptureRecipeInput = Pick<
-  DesignScreenCase,
-  | 'route'
-  | 'path'
-  | 'componentName'
-  | 'gallery'
-  | 'width'
-  | 'height'
-  | 'environment'
-  | 'preset'
-  | 'interactions'
-  | 'assertions'
->;
-
-export interface PreviewArtifactExpectation {
-  namespace: string;
-  sourceRevision: string;
-}
-
-export interface PreviewArtifactFrameRequest {
-  id: string;
-  fingerprint?: string;
-}
-
-export interface PreviewArtifactTransportRequest extends PreviewArtifactExpectation {
-  signal?: AbortSignal;
-  captureBaseUrl?: string;
-  /** Frames to fetch. Omitted asks for the whole bundle, as earlier versions did. */
-  frames?: readonly PreviewArtifactFrameRequest[];
-  /** Set false to seed only what exists instead of capturing what is absent. */
-  generate?: boolean;
-}
-
-export type PreviewArtifactTransport = (
-  request: PreviewArtifactTransportRequest,
-) => Promise<unknown | null | undefined>;
-
-export interface PreviewArtifactHttpResponse {
-  readonly ok: boolean;
-  readonly status?: number;
-  readonly statusText?: string;
-  json(): Promise<unknown>;
-}
-
-export type PreviewArtifactFetch = (
-  input: string,
-  init: {
-    method: 'GET';
-    headers: { accept: 'application/json' };
-    cache: 'no-store';
-    signal?: AbortSignal;
-  },
-) => Promise<PreviewArtifactHttpResponse>;
-
-export interface PreviewArtifactHttpTransportOptions {
-  endpoint: string;
-  fetcher?: PreviewArtifactFetch;
-  captureBaseUrl?: string;
-}
-
-export type PreviewArtifactValidationReason =
-  'invalid-bundle' | 'namespace-mismatch' | 'revision-mismatch';
-
-export interface PreviewArtifactFrameResolution {
-  exact: readonly string[];
-  missing: readonly string[];
-  stale: readonly string[];
-}
-
-export type PreviewArtifactValidationResult =
-  | {
-      valid: true;
-      artifact: RoutePreviewArtifactBundle;
-      errors: readonly [];
-    }
-  | {
-      valid: false;
-      artifact: null;
-      reason: PreviewArtifactValidationReason;
-      errors: readonly string[];
-    };
-
-export type PreviewArtifactBootstrapResult =
-  | {
-      status: 'accepted';
-      artifact: RoutePreviewArtifactBundle;
-      frameResolution?: PreviewArtifactFrameResolution;
-    }
-  | {
-      status: 'unavailable';
-      artifact: null;
-      error?: unknown;
-    }
-  | {
-      status: 'rejected';
-      artifact: null;
-      reason: PreviewArtifactValidationReason;
-      errors: readonly string[];
-    };
-
-export declare function createPreviewRecipeFingerprint(
-  recipes: readonly PreviewRecipeIdentity[],
-): string;
-export declare function createPreviewFrameFingerprint(
-  screen: StoryboardCaptureRecipeInput & { id?: string },
-  options?: { dependencyDigest?: string },
-): string;
-export declare function createPreviewCacheNamespace(
-  options: PreviewCacheNamespaceOptions,
-): string;
-export declare function createStoryboardCaptureRecipeIdentity(
-  screen: StoryboardCaptureRecipeInput,
-): unknown;
-/** The declaration-relevant slice of a page: everything grouping keys off. */
-export interface ScreenStateGroupInput {
-  name: string;
-  canvas?: string;
-  route?: string;
-  scenario?: string;
-  state?: string;
-  width?: number;
-  height?: number;
-}
-export interface ScreenStateGroupDiagnostic {
-  severity: 'warning' | 'info';
-  code: 'mixed-viewport' | 'duplicate-state' | 'cross-canvas' | 'singleton-group';
-  scenario: string;
-  message: string;
-}
-/**
- * Validates host-declared screen-state groups against the contract the
- * Screen states panel enforces — same canvas, one frame per state label, a
- * shared viewport, at least one sibling. Hosts own membership; the core
- * validates the declaration.
- */
-export declare function validateScreenStateGroups(
-  pages: readonly ScreenStateGroupInput[],
-): ScreenStateGroupDiagnostic[];
-/** One waypoint of a flow path: the screen it materializes and the walk delta reaching it. */
-export interface ScreenFlowWaypoint {
-  /** Catalog id of the screen this waypoint materializes (importPageId). */
-  screenId: string;
-  /** Interactions from the previous waypoint (or the boot) to this screen's state. */
-  steps?: readonly DesignScreenInteraction[];
-}
-/**
- * One captureless surface path: a hidden live instance boots `route` with
- * `environment` and walks the waypoints in order, publishing one frozen
- * snapshot per screen. A single-waypoint path is a per-screen recipe; a
- * multi-waypoint path amortizes one boot across a user journey.
- */
-export interface ScreenFlowPath {
-  id: string;
-  route: string;
-  environment?: StoryboardEnvironment;
-  waypoints: readonly ScreenFlowWaypoint[];
-}
-export interface ScreenFlowDiagnostic {
-  severity: 'error' | 'warning';
-  pathId: string;
-  message: string;
-}
-/** Structural validation of flow paths against the screen catalog. */
-export declare function validateScreenFlows(
-  paths: readonly ScreenFlowPath[],
-  screens: readonly { id: string }[],
-): ScreenFlowDiagnostic[];
-/**
- * Where one QA scenario is verified: a dedicated frame, a folded screen
- * state, a component toggle, a viewport preset, or a declared behavior/todo.
- * Claims are host-declared, core-validated, and executable in the editor.
- */
-export type ScenarioCoverageClaim =
-  | { scenarioId: string; kind: 'frame'; screenId: string; reason?: string }
-  | { scenarioId: string; kind: 'screen-state'; screenId: string; reason?: string }
-  | {
-      scenarioId: string;
-      kind: 'component-state';
-      screenId: string;
-      componentName: string;
-      prop: string;
-      value: RegistryPropValue;
-      reason?: string;
-    }
-  | {
-      scenarioId: string;
-      kind: 'viewport';
-      screenId: string;
-      preset: string;
-      reason?: string;
-    }
-  | { scenarioId: string; kind: 'catalog'; screenId: string; reason?: string }
-  | {
-      scenarioId: string;
-      /** A declared interactive axis reaches the scenario in one gesture. */
-      kind: 'interactive-state';
-      /** InteractiveStateDef id. */
-      interaction: string;
-      /** InteractiveStateOption id within that axis. */
-      option: string;
-      screenId: string;
-      reason?: string;
-    }
-  | {
-      scenarioId: string;
-      /** A badge composition on the screen's repeated card demonstrates it. */
-      kind: 'card-slot';
-      /** ScreenCardDef id. */
-      card: string;
-      /** CardSlotDef id within that card. */
-      slot: string;
-      /** CardBadgeOption id within that slot. */
-      option: string;
-      screenId: string;
-      reason?: string;
-    }
-  | {
-      scenarioId: string;
-      /** A row count on the screen's declared list demonstrates it. */
-      kind: 'list-length';
-      /** ScreenListDef id. */
-      list: string;
-      count: number;
-      screenId: string;
-      reason?: string;
-    }
-  | { scenarioId: string; kind: 'behavior'; reason: string }
-  | { scenarioId: string; kind: 'todo'; reason: string };
-export interface ScenarioCoverageDiagnostic {
-  severity: 'error' | 'warning';
-  scenarioId: string;
-  message: string;
-}
-export interface ScenarioCoverageContext {
-  scenarios: readonly { id: string }[];
-  screens: readonly { id: string; scenario?: string; state?: string }[];
-  registry: Readonly<
-    Record<string, { props?: Readonly<Record<string, readonly RegistryPropValue[]>> }>
-  >;
-  viewportPresets: readonly { label: string }[];
-  catalogPages?: readonly { id: string }[];
-  /** Host-declared interactive axes, for interactive-state claims. */
-  interactiveStates?: readonly {
-    id: string;
-    options: readonly { id: string; steps?: readonly unknown[] }[];
-  }[];
-  /** Host-declared card compositions, for card-slot claims. */
-  screenCards?: readonly {
-    id: string;
-    slots: readonly { id: string; options: readonly { id: string }[] }[];
-  }[];
-  /** Host-declared list axes, for list-length claims. */
-  screenLists?: readonly { id: string; min?: number; max?: number }[];
-}
-export declare function validateScenarioCoverage(
-  claims: readonly ScenarioCoverageClaim[],
-  context: ScenarioCoverageContext,
-): ScenarioCoverageDiagnostic[];
-
-// Surface demands — the editor asks, the host answers. The coverage ledger above
-// checks declarations against declarations; these enumerate what exists, so an
-// undeclared surface is a hole rather than an absence.
-export type SurfaceDemandKind = 'route' | 'control' | 'request';
-export interface SurfaceCandidate {
-  kind: SurfaceDemandKind;
-  id: string;
-  frameId?: string;
-  /**
-   * Frame-independent form of the same surface. A verdict on this id answers the
-   * surface in every frame it appears in; a frame-scoped verdict still wins when
-   * the answer differs there.
-   */
-  matchId?: string;
-  detail: string;
-}
-export type SurfaceVerdict =
-  | { verdict: 'covered'; by: string }
-  | { verdict: 'excluded'; reason: string };
-export type SurfaceClassification = SurfaceVerdict & { id: string };
-export interface SurfaceDemandDiagnostic {
-  severity: 'error' | 'warning';
-  kind: SurfaceDemandKind | 'unknown';
-  candidateId: string;
-  message: string;
-}
-export declare const MIN_SURFACE_REASON_LENGTH: number;
-export declare function validateSurfaceDemands(
-  candidates: readonly SurfaceCandidate[],
-  classifications: readonly SurfaceClassification[],
-): SurfaceDemandDiagnostic[];
-export declare function unclassifiedSurfaces(
-  candidates: readonly SurfaceCandidate[],
-  classifications: readonly SurfaceClassification[],
-): SurfaceCandidate[];
-export interface RouteEnumerationInput {
-  routes: readonly { path?: string; id?: string }[];
-  declaredScreens: readonly { id: string; route?: string }[];
-}
-export declare function enumerateRouteCandidates(
-  input: RouteEnumerationInput,
-): SurfaceCandidate[];
-export interface ControlNodeLike {
-  id: string;
-  domTag?: string;
-  domAttributes?: Readonly<Record<string, string>>;
-  hidden?: boolean;
-}
-export declare function enumerateControlCandidates(
-  frameId: string,
-  nodes: readonly ControlNodeLike[],
-): SurfaceCandidate[];
-export interface ObservedRequest {
-  url: string;
-  method?: string;
-}
-export declare function requestEndpointShape(url: string): string;
-export declare function enumerateRequestCandidates(
-  frameId: string,
-  requests: readonly ObservedRequest[],
-): SurfaceCandidate[];
-export declare function setSurfaceClassifications(
-  classifications: readonly SurfaceClassification[] | undefined,
-): void;
-export declare function getSurfaceClassifications(): readonly SurfaceClassification[];
-export declare function setObservedRequests(
-  frameId: string,
-  requests: readonly ObservedRequest[],
-): void;
-export declare function getObservedRequests(
-  frameId: string,
-): readonly ObservedRequest[];
-export interface FrameSurfaceDemands {
-  candidates: SurfaceCandidate[];
-  unclassified: SurfaceCandidate[];
-}
-export declare function frameSurfaceDemands(
-  frameId: string,
-  root?: (ControlNodeLike & { children?: readonly ControlNodeLike[] }) | null,
-  classifications?: readonly SurfaceClassification[],
-): FrameSurfaceDemands;
-/** One discovered conditional-render branch from the component scanner. */
-export interface ComponentBranch {
-  kind: 'conditional' | 'enum';
-  condition: string;
-  element?: string;
-  renders?: string;
-  values?: readonly string[];
-  line?: number;
-}
-export interface ScreenDimensionOption {
-  label: string;
-  props: Readonly<Record<string, RegistryPropValue>>;
-}
-/**
- * Points at captured markup by a test id or css-module class prefix. A list
- * of prefixes matches any one of them, which lets a single axis cover
- * sibling elements the product renders from different branches.
- */
-export interface NodeSelector {
-  testId?: string;
-  classIncludes?: string | readonly string[];
-}
-/**
- * A curated right-panel control that swaps a captured piece's state by
- * adopting the matched node into a registry adapter instance.
- */
-export interface ScreenDimensionDef {
-  id: string;
-  label: string;
-  component: string;
-  prop?: string;
-  options?: readonly ScreenDimensionOption[];
-  match: NodeSelector;
-  /**
-   * 'first' (default) drives the one piece a screen shows once; 'each'
-   * opens a control per match, which is what a list of rows needs.
-   */
-  sourcePath?: string;
-}
-export interface ScreenDimensionDiagnostic {
-  severity: 'error' | 'warning';
-  dimensionId: string;
-  message: string;
-}
-export declare function validateScreenDimensions(
-  dimensions: readonly ScreenDimensionDef[],
-  context: {
-    registry: Readonly<
-      Record<string, { props?: Readonly<Record<string, readonly RegistryPropValue[]>> }>
-    >;
-    scansBySource?: Readonly<Record<string, readonly ComponentBranch[]>>;
-  },
-): ScreenDimensionDiagnostic[];
-/**
- * A repeating list whose row count becomes a right-panel control. Growing
- * clones the last row (identical on purpose — the per-row dimension
- * controls are what make rows differ); shrinking drops trailing rows. It
- * edits the captured tree, so it applies instantly and undoes in one step.
- */
-export interface ScreenListDef {
-  id: string;
-  label: string;
-  container: NodeSelector;
-  item: NodeSelector;
-  /** Fewest rows the control offers. Default 0. */
-  min?: number;
-  /** Most rows the control offers. Default 12. */
-  max?: number;
-}
-export interface ScreenListDiagnostic {
-  severity: 'error' | 'warning';
-  listId: string;
-  message: string;
-}
-export declare function validateScreenLists(
-  defs: readonly ScreenListDef[],
-): ScreenListDiagnostic[];
-/**
- * One badge a card slot may hold. `match` recognizes the captured element;
- * `component`/`props` build it from the registry when the screen has no
- * captured instance to clone; `anchor` is its fixed position in the slot.
- */
-export interface CardBadgeOption {
-  id: string;
-  label: string;
-  component: string;
-  props: Readonly<Record<string, RegistryPropValue>>;
-  match: NodeSelector;
-  anchor?: { before?: NodeSelector; after?: NodeSelector };
-}
-/** A region of a card with its own vocabulary and capacity. */
-export interface CardSlotDef {
-  id: string;
-  label: string;
-  container: NodeSelector;
-  /** 'multiple' (the default) when the product can show several at once. */
-  arity?: 'single' | 'multiple';
-  /** The product renders the container only when it has content. */
-  hideWhenEmpty?: boolean;
-  /** Where to create the container on a card that lacks one. */
-  placement?: { parent: NodeSelector; before?: NodeSelector; after?: NodeSelector };
-  options: readonly CardBadgeOption[];
-}
-/**
- * The badge composition of a repeated card, declared the way the component
- * is built: slots, what each may hold, how many at once.
- */
-export interface ScreenCardDef {
-  id: string;
-  label: string;
-  card: NodeSelector;
-  slots: readonly CardSlotDef[];
-  sourcePath?: string;
-}
-export interface ScreenCardDiagnostic {
-  severity: 'error' | 'warning';
-  cardId: string;
-  message: string;
-}
-export declare function validateScreenCards(
-  defs: readonly ScreenCardDef[],
-  context: {
-    registry: Readonly<
-      Record<string, { props?: Readonly<Record<string, readonly RegistryPropValue[]>> }>
-    >;
-    scansBySource?: Readonly<Record<string, readonly ComponentBranch[]>>;
-  },
-): ScreenCardDiagnostic[];
-/**
- * An axis a screen reaches by acting on it (folding the sidebar, hovering a
- * row) rather than by being a separate captured frame. Selecting an option
- * appends its steps to the frame's recipe, so the ordinary supply produces
- * the variant.
- */
-export interface InteractiveStateOption {
-  id: string;
-  label: string;
-  /** Absent or empty marks the base state — the screen as captured. */
-  steps?: readonly DesignScreenInteraction[];
-  /**
-   * Boot condition for states no gesture can reach — a failed request, an empty
-   * result, a stalled stream. Merged into the frame's environment, which already
-   * belongs to the recipe identity, so the existing supply path reproduces it.
-   * The base is the option with neither steps nor a condition.
-   */
-  environment?: StoryboardEnvironment;
-  /**
-   * Recognizes this option in the CAPTURED tree, making the base a property of
-   * the frame instead of the axis. Declare it on every option (each with its own
-   * steps) when the frames an axis covers were captured in different states —
-   * otherwise the axis is a no-op wherever the capture is not the declared base.
-   */
-  capturedWhen?: { testId: string; attribute?: { name: string; value: string } };
-}
-export interface InteractiveStateDef {
-  id: string;
-  label: string;
-  /** Frames the axis applies to: exact route and/or a test id in the tree. */
-  requires?: { testId?: string; route?: string };
-  options: readonly InteractiveStateOption[];
-}
-export interface InteractiveStateDiagnostic {
-  severity: 'error' | 'warning';
-  interactionId: string;
-  message: string;
-}
-export declare function validateInteractiveStates(
-  defs: readonly InteractiveStateDef[],
-): InteractiveStateDiagnostic[];
-/**
- * Host-declared description of one canvas section — the band above its box.
- * The core counts frames, folded variants, scenarios and viewport itself.
- */
-/**
- * A situation group within one section. Declaration order is lane order, and
- * one lane is one row of the canvas — the axis that replaces area packing so
- * an arrangement reads as the product's structure.
- */
-export interface ScreenLaneDef {
-  /** Unique within its section. */
-  id: string;
-  /** Human-readable, drawn as the lane caption. */
-  label: string;
-  /** Section name exactly as the frames carry it. */
-  section: string;
-  /** Caption rule colour (hex). Defaults to a neutral. */
-  accent?: string;
-}
-export interface ScreenLaneDiagnostic {
-  severity: 'error' | 'warning';
-  laneId: string;
-  message: string;
-}
-export declare function validateScreenLanes(
-  lanes: readonly ScreenLaneDef[],
-  context?: { sections?: readonly string[] },
-): ScreenLaneDiagnostic[];
-export interface SectionHeaderDef {
-  /** Section name exactly as the frames carry it — the join key. */
-  section: string;
-  /** Short handle shown large, e.g. "02". */
-  code: string;
-  /** Section title. */
-  title: string;
-  /** Secondary clause after the title: what kind of group this is. */
-  kind?: string;
-  /** One line a planner needs: what the section covers. */
-  purpose: string;
-  /** Accent colour (hex) for the rule and the category pill. */
-  accent: string;
-  /** Category shown in the pill. */
-  pill?: string;
-}
-/** Words for the facts a section header counts. Defaults are English. */
-export interface SectionHeaderLabels {
-  code?: string;
-  frames?: string;
-  folded?: string;
-  scenarios?: string;
-  flows?: string;
-}
-export interface SectionHeaderDiagnostic {
-  severity: 'error' | 'warning';
-  section: string;
-  message: string;
-}
-export interface SectionHeaderFacts {
-  frameCount: number;
-  foldedCount: number;
-  scenarioCount: number;
-  flows: string[];
-  viewport: string | null;
-}
-export declare function validateSectionHeaders(
-  defs: readonly SectionHeaderDef[],
-  context: { sections: readonly string[] },
-): SectionHeaderDiagnostic[];
-/**
- * Presentation of one branch kind a frame label can carry: a state kind the
- * catalog declares, or the core's own `step` (a plain screen) and `variant`
- * (a numbered branch that declares no state kind).
- */
-export interface FrameBranchKindDef {
-  kind: string;
-  /** Word shown in the label's pill. */
-  label: string;
-  /** Accent colour for the rule and the pill text. */
-  accent: string;
-}
-/** Words for the facts a frame label counts. English by default. */
-export interface FrameLabelLabels {
-  layers?: string;
-  noScenario?: string;
-  omissions?: string;
-  checkFlow?: string;
-}
-export interface FrameBranchKindDiagnostic {
-  severity: 'error' | 'warning';
-  kind: string;
-  message: string;
-}
-export declare function validateFrameBranchKinds(
-  defs: readonly FrameBranchKindDef[],
-  context?: { stateKinds?: readonly string[] },
-): FrameBranchKindDiagnostic[];
-/** Screen frames claiming no scenario at all — the holes in the ledger. */
-export declare function framesMissingScenario(
-  pages: readonly { route?: string; scenarioId?: string; scenarioIds?: readonly string[] }[],
-): readonly { name: string; section?: string }[];
-export interface ApplyCoverageResult {
-  status: 'applied' | 'pending-import' | 'failed';
-  message?: string;
-}
-/** Reproduces the reviewed state a claim describes inside the editor. */
-export declare function applyScenarioCoverageClaim(
-  claim: ScenarioCoverageClaim,
-): ApplyCoverageResult;
-export declare function createPreviewArtifactHttpTransport(
-  options: PreviewArtifactHttpTransportOptions,
-): PreviewArtifactTransport;
-export declare function validatePreviewArtifactBundle(
-  value: unknown,
-  expectation?: PreviewArtifactExpectation,
-  options?: { perFrameIdentity?: boolean },
-): PreviewArtifactValidationResult;
-export declare function resolvePreviewArtifactFrames(
-  artifact: RoutePreviewArtifactBundle,
-  expectation: PreviewArtifactExpectation,
-  frames: readonly PreviewArtifactFrameRequest[],
-): PreviewArtifactFrameResolution;
-export declare function bootstrapPreviewArtifact(
-  options: PreviewArtifactExpectation & {
-    transport: PreviewArtifactTransport;
-    signal?: AbortSignal;
-    frames?: readonly PreviewArtifactFrameRequest[];
-    generate?: boolean;
-  },
-): Promise<PreviewArtifactBootstrapResult>;
-
-export type StoryboardGraphEdgeOrigin = 'explicit' | 'inferred';
-
-export interface StoryboardGraphEdgeInput {
-  id?: string;
-  from: string;
-  to: string;
-  /** Screen or node identities that inherit this outgoing route connection. */
-  fromScope?: readonly string[];
-  /** Screen or node identities that inherit this incoming route connection. */
-  toScope?: readonly string[];
-  kind?: string;
-  label?: string;
-}
-
-export interface StoryboardPathInput {
-  /** Stable author-owned identity used as the edge id prefix. */
-  id: string;
-  /** Ordered screen ids visited by this path. */
-  screenIds: readonly string[];
-  kind?: string;
-  label?: string;
-}
-
-export interface StoryboardDefinition {
-  paths?: readonly StoryboardPathInput[];
-  edges?: readonly StoryboardGraphEdgeInput[];
-  startScreenIds?: readonly string[];
-  nonVisualScenarioIds?: readonly string[];
-}
-
-export declare function createStoryboardPathEdges(
-  paths: readonly StoryboardPathInput[],
-): StoryboardGraphEdgeInput[];
-
-export interface StoryboardGraphBuildOptions {
-  screens: readonly DesignScreenCase[];
-  assets?: readonly DesignImportAsset[];
-  scenarios?: readonly DesignScenarioSource[];
-  explicitEdges?: readonly StoryboardGraphEdgeInput[];
-  inferredEdges?: readonly StoryboardGraphEdgeInput[];
-  startScreenIds?: readonly string[];
-  nonVisualScenarioIds?: readonly string[];
-  recipeKey?: (screen: DesignScreenCase) => string;
-}
-
-export interface StoryboardGraphNode {
-  id: string;
-  canonicalScreenId: string;
-  screenIds: readonly string[];
-  names: readonly string[];
-  recipeKey: string;
-  routes: readonly string[];
-  scenarioIds: readonly string[];
-  sourceKeys: readonly string[];
-  flows: readonly string[];
-  states: readonly string[];
-}
-
-export interface StoryboardGraphEdge {
-  id: string;
-  from: string;
-  to: string;
-  /** Canonical nodes that expose this edge as an outgoing connection. */
-  fromNodeIds?: readonly string[];
-  /** Canonical nodes that expose this edge as an incoming connection. */
-  toNodeIds?: readonly string[];
-  kind?: string;
-  label?: string;
-  origin: StoryboardGraphEdgeOrigin;
-  sourceEdgeIds: readonly string[];
-}
-
-export interface StoryboardGraphSourceGroup {
-  sourceKey: string;
-  nodeIds: readonly string[];
-  screenIds: readonly string[];
-  shared: boolean;
-}
-
-export interface StoryboardGraphBranch {
-  nodeId: string;
-  edgeIds: readonly string[];
-  targetNodeIds: readonly string[];
-}
-
-export type StoryboardGraphWarningCode =
-  | 'duplicate-screen-id'
-  | 'invalid-recipe'
-  | 'unknown-edge-source'
-  | 'unknown-edge-target'
-  | 'ambiguous-edge-source'
-  | 'ambiguous-edge-target'
-  | 'unknown-start-screen'
-  | 'disconnected-screen'
-  | 'missing-code-scenario';
-
-export interface StoryboardGraphWarning {
-  code: StoryboardGraphWarningCode;
-  severity: 'warning' | 'error';
-  message: string;
-  screenId?: string;
-  nodeId?: string;
-  edgeId?: string;
-  scenarioId?: string;
-}
-
-export interface StoryboardGraphCoverage {
-  screens: number;
-  canonicalNodes: number;
-  mergedScreens: number;
-  edges: number;
-  connectedNodes: number;
-  disconnectedScreens: readonly string[];
-  codeScenarios: number;
-  representedScenarios: number;
-  missingScenarios: readonly string[];
-  complete: boolean;
-}
-
-export interface StoryboardGraph {
-  version: 1;
-  nodes: readonly StoryboardGraphNode[];
-  edges: readonly StoryboardGraphEdge[];
-  aliases: Readonly<Record<string, string>>;
-  sourceGroups: readonly StoryboardGraphSourceGroup[];
-  startNodeIds: readonly string[];
-  branches: readonly StoryboardGraphBranch[];
-  warnings: readonly StoryboardGraphWarning[];
-  coverage: StoryboardGraphCoverage;
-}
-
-export declare function storyboardScreenRecipeKey(
-  screen: DesignScreenCase,
-): string;
-export declare function createStoryboardGraph(
-  options: StoryboardGraphBuildOptions,
-): StoryboardGraph;
-
-export interface StoryboardFrameReference {
-  frameId: string;
-  screenId: string;
-  name: string;
-}
-
-export interface StoryboardGraphFrameView {
-  frameId: string;
-  screenId: string;
-  name: string;
-  nodeId: string;
-  canonicalScreenId: string;
-  canonicalFrameId?: string;
-  isCanonical: boolean;
-  isStart: boolean;
-  isBranch: boolean;
-  routes: readonly string[];
-  flows: readonly string[];
-  states: readonly string[];
-  depth?: number;
-  aliasScreenIds: readonly string[];
-  relatedFrameIds: readonly string[];
-  branchTargetFrameIds: readonly string[];
-  incomingTransitions: readonly StoryboardGraphTransitionView[];
-  outgoingTransitions: readonly StoryboardGraphTransitionView[];
-  warnings: readonly StoryboardGraphWarning[];
-}
-
-export interface StoryboardGraphTransitionView {
-  edgeId: string;
-  sourceFrameId: string;
-  targetFrameId: string;
-  label?: string;
-  kind?: string;
-  origin: StoryboardGraphEdgeOrigin;
-}
-
-export interface StoryboardGraphCanonicalView {
-  nodeId: string;
-  canonicalScreenId: string;
-  canonicalFrameId?: string;
-  aliasScreenIds: readonly string[];
-  aliasFrameIds: readonly string[];
-}
-
-export interface StoryboardGraphSourceView {
-  sourceKey: string;
-  frameIds: readonly string[];
-  nodeIds: readonly string[];
-}
-
-export interface StoryboardGraphViewModel {
-  frames: readonly StoryboardGraphFrameView[];
-  canonicalGroups: readonly StoryboardGraphCanonicalView[];
-  sharedSources: readonly StoryboardGraphSourceView[];
-  startFrameIds: readonly string[];
-  branchFrameIds: readonly string[];
-  warnings: readonly StoryboardGraphWarning[];
-  unresolvedWarnings: readonly StoryboardGraphWarning[];
-  coverage: StoryboardGraphCoverage;
-}
-
-export declare function createStoryboardGraphViewModel(
-  graph: StoryboardGraph,
-  frameReferences: readonly StoryboardFrameReference[],
-): StoryboardGraphViewModel;
-export declare function setStoryboardGraph(graph: StoryboardGraph | null): void;
-export declare function getStoryboardGraph(): StoryboardGraph | null;
-export declare function subscribeStoryboardGraph(
-  listener: () => void,
-): () => void;
-
-export interface StoryboardDiscoveryScenario {
-  id?: string;
-  name?: string;
-  section?: string;
-  flow?: string;
-  sourcePath?: string;
-  description?: string;
-  environment?: StoryboardEnvironment;
-}
-
-export interface StoryboardDiscoveryCandidate {
-  id?: string;
-  route?: string;
-  scenarioId?: string;
-  environment?: StoryboardEnvironment;
-}
-
-export interface StoryboardDiscoveryEdge {
-  id?: string;
-  from?: string;
-  to?: string;
-  kind?: string;
-  label?: string;
-  unresolvedTarget?: boolean;
-}
-
-export interface StoryboardDiscoveryRoute {
-  id?: string;
-  path?: string;
-}
-
-export interface StoryboardDiscoveryManifest {
-  version?: number;
-  routes?: readonly StoryboardDiscoveryRoute[];
-  scenarios?: readonly StoryboardDiscoveryScenario[];
-  candidates?: readonly StoryboardDiscoveryCandidate[];
-  edges?: readonly StoryboardDiscoveryEdge[];
-}
-
-export interface StoryboardResolvedPage {
-  id: string;
-  name: string;
-  canvas?: string;
-  section?: string;
-  importKind?: DesignImportKind;
-  componentName?: string;
-  gallery?: string[];
-  route?: string;
-  path?: string;
-  publish?: boolean;
-  width?: number;
-  height?: number;
-  frameSizeMode?: DesignFrameSizeMode;
-  heightMode?: DesignFrameHeightMode;
-  maxHeight?: number;
-  sourcePaths?: string[];
-  flow?: string;
-  scenario?: string;
-  state?: string;
-  /** Host-declared kind of the state branch (overlay, badge, layout, ...). Presentation hint for the Screen states control. */
-  stateKind?: string;
-  scenarioId?: string;
-  interactions?: readonly DesignScreenInteraction[];
-  environment?: StoryboardEnvironment;
-  preset?: DesignScreenPreset;
-  assertions?: readonly DesignScreenAssertion[];
-}
-
-export interface StoryboardDiscoveryGraphOptions {
-  manifest: StoryboardDiscoveryManifest;
-  pages: readonly StoryboardResolvedPage[];
-  assets?: readonly DesignImportAsset[];
-  /** Host-authored user journeys layered over source-inferred transitions. */
-  storyboard?: StoryboardDefinition;
-}
-
-export interface StoryboardDiscoveryResult {
-  manifest: StoryboardDiscoveryManifest;
-  baselineEnvironment?: StoryboardEnvironment;
-  graph: StoryboardGraph;
-}
-
-export interface StoryboardDiscoveryResponse {
-  ok: boolean;
-  status: number;
-  json(): Promise<unknown>;
-}
-
-export type StoryboardDiscoveryFetch = (
-  endpoint: string,
-  init: {
-    headers: { accept: 'application/json' };
-    cache: 'no-store';
-    signal?: AbortSignal;
-  },
-) => Promise<StoryboardDiscoveryResponse>;
-
-export interface LoadStoryboardDiscoveryOptions extends Omit<
-  StoryboardDiscoveryGraphOptions,
-  'manifest'
-> {
-  endpoint: string;
-  signal?: AbortSignal;
-  fetcher?: StoryboardDiscoveryFetch;
-}
-
-export declare function resolveStoryboardScreenCases(
-  pages: readonly StoryboardResolvedPage[],
-  manifest: StoryboardDiscoveryManifest,
-): DesignScreenCase[];
-export declare function createStoryboardRouteScenarioId(route: string): string;
-export declare function getStoryboardDiscoveryBaselineEnvironment(
-  manifest: StoryboardDiscoveryManifest,
-): StoryboardEnvironment | undefined;
-export declare function createStoryboardGraphFromDiscovery(
-  options: StoryboardDiscoveryGraphOptions,
-): StoryboardGraph;
-export declare function loadStoryboardDiscovery(
-  options: LoadStoryboardDiscoveryOptions,
-): Promise<StoryboardDiscoveryResult>;
-export declare function publishStoryboardDiscovery(
-  options: LoadStoryboardDiscoveryOptions,
-): Promise<StoryboardDiscoveryResult>;
-
-export interface InitialPageDef {
-  name: string;
-  /** Owning canvas, such as 'Design System' or 'Screens'. Defaults to 'default'. */
-  canvas?: string;
-  /** Page = 1 of this registry component (screen injection). */
-  componentName?: string;
-  /** Page = Vertical gallery of registry names (Components gallery page). */
-  gallery?: string[];
-  /** Page = actual running app route (see iframe — non-editable, preview actual routing). */
-  route?: string;
-  /** Publishing path in creation screen. */
-  path?: string;
-  /** If false, excluded from reflected output. */
-  publish?: boolean;
-  /** Optional section header shown in the page list. */
-  section?: string;
-  /** Frame size (px) — 390×600 (mobile) if not specified. */
-  width?: number;
-  height?: number;
-  frameSizeMode?: DesignFrameSizeMode;
-  heightMode?: DesignFrameHeightMode;
-  maxHeight?: number;
-  /** Immediately after the first render, the entire actual DOM is imported into the layer tree. */
-  importLayers?: boolean;
-  importPageId?: string;
-  importKind?: DesignImportKind;
-  assetIds?: string[];
-  sourcePaths?: string[];
-  flow?: string;
-  scenario?: string;
-  state?: string;
-  /** Host-declared kind of the state branch (overlay, badge, layout, ...). Presentation hint for the Screen states control. */
-  stateKind?: string;
-  /** Host-declared situation lane the canvas arranges the frame into. */
-  lane?: string;
-  scenarioId?: string;
-  interactions?: DesignScreenInteraction[];
-  environment?: StoryboardEnvironment;
-  preset?: DesignScreenPreset;
-  assertions?: DesignScreenAssertion[];
-}
-
-export interface ApplyPayload {
-  tokens: { name: string; value: string }[];
-  pages: {
-    id: string;
-    name: string;
-    path: string;
-    width: number;
-    height: number;
-    canvas: string;
-    section?: string;
-    jsx: string;
-  }[];
-}
-
-export interface DesignCodeDocument {
-  type: 'document';
-  id: string;
-  kind: DesignImportKind;
-  name: string;
-  canvas: string;
-  section?: string;
-  path?: string;
-  route?: string;
-  width: number;
-  height: number;
-  assetIds: string[];
-  sourcePaths: string[];
-  jsx: string;
-}
-
-export interface DesignTokenDocument {
-  type: 'token';
-  id: string;
-  kind: 'design-tokens';
-  name: string;
-  value: string;
-}
-
-export type DesignElementDocument = DesignCodeDocument | DesignTokenDocument;
-
-export interface DesignElementChange {
-  operation: 'upsert' | 'delete';
-  element: DesignElementDocument;
-}
-
-export interface DesignChangePayload {
-  revision: number;
-  changes: DesignElementChange[];
-}
-
-export interface DesignChangeResult {
-  saved: number;
-  files?: string[];
-  message?: string;
-}
-
-export interface SourceIdentity {
-  componentFile: string;
-  sourceStart: number;
-  elementName: string;
-}
-
-export interface SourceAffectedFrame {
-  id: string;
-  name: string;
-}
-
-export type SourceEditScope = 'instance' | 'shared-source';
-export type PrimitiveSourceValue = string | number | boolean;
-export type PrimitiveSourceValueType = 'string' | 'number' | 'boolean';
-
-export interface SourceInsertComponent {
-  name: string;
-  importPath: string;
-  importKind: 'named';
-  props: Record<string, PrimitiveSourceValue>;
-  children?: string;
-}
-
-export type SourceEditOperation =
-  | {
-      kind: 'prop';
-      identity: SourceIdentity;
-      prop: string;
-      from: PrimitiveSourceValue;
-      to: PrimitiveSourceValue;
-      valueType: PrimitiveSourceValueType;
-      scope: SourceEditScope;
-      affectedFrames: SourceAffectedFrame[];
-    }
-  | {
-      kind: 'text';
-      identity: SourceIdentity;
-      from: string;
-      to: string;
-      scope: SourceEditScope;
-      affectedFrames: SourceAffectedFrame[];
-    }
-  | {
-      kind: 'insert';
-      mode: 'clone';
-      identity: SourceIdentity;
-      fromIndex: number;
-      toIndex: number;
-      scope: SourceEditScope;
-      affectedFrames: SourceAffectedFrame[];
-    }
-  | {
-      kind: 'insert';
-      mode: 'component';
-      identity: SourceIdentity;
-      slot: 'children';
-      toIndex: number;
-      component: SourceInsertComponent;
-      scope: SourceEditScope;
-      affectedFrames: SourceAffectedFrame[];
-    }
-  | {
-      kind: 'remove';
-      identity: SourceIdentity;
-      fromIndex: number;
-      scope: SourceEditScope;
-      affectedFrames: SourceAffectedFrame[];
-    }
-  | {
-      kind: 'move';
-      identity: SourceIdentity;
-      fromIndex: number;
-      toIndex: number;
-      scope: SourceEditScope;
-      affectedFrames: SourceAffectedFrame[];
-    };
-
-/** Source edit payload sent through the host write-back endpoint. */
-export interface InspectApplyPayload {
-  /** Final CSS declaration bundle per (scss file, css module local class). */
-  styles: {
-    file: string;
-    className: string;
-    componentFile: string;
-    declarations: Record<string, string>;
-    affectedFrames: SourceAffectedFrame[];
-    media?: { minWidth?: number; maxWidth?: number };
-  }[];
-  /** Initial text for each element → Final text (assuming one-time exact matching substitution in the source). */
-  texts: {
-    componentFile: string;
-    oldText: string;
-    newText: string;
-    affectedFrames: SourceAffectedFrame[];
-  }[];
-  /** Atomic modification of prop·children based on JSX/TSX source location. */
-  operations: SourceEditOperation[];
-}
-
-/** Result returned after the host applies source edits. */
-export interface InspectApplyResult {
-  applied: number;
-  /** Modification session branch created by the host. */
-  branch?: string;
-  /** Result of merging with latest development code. */
-  integration?:
-    'up_to_date' | 'auto_merged' | 'review_required' | 'conflict' | 'offline';
-  /** Text of application results to show to the designer. */
-  message?: string;
-  /** Comparison of DOM·PNG recapture of the impact screen immediately after application. */
-  qa?: InspectQaResult;
-}
-
-export interface InspectPreviewResult {
-  revision: number;
-  files: { file: string; diff: string }[];
-  affectedFiles: string[];
-  /** Based on comparison of impact screens captured in current revision. */
-  qa?: InspectQaResult;
-}
-
-export interface InspectImpactResult {
-  files: string[];
-}
-
-export interface InspectQaArtifactHash {
-  domStructureHash: string;
-  screenshotHash: string;
-  screenshotUrl?: string;
-}
-
-export interface InspectQaPixelDimensions {
-  width: number;
-  height: number;
-}
-
-export interface InspectQaPixelDiff {
-  before: InspectQaPixelDimensions;
-  after: InspectQaPixelDimensions;
-  dimensionsMatch: boolean;
-  changedPixels: number;
-  totalPixels: number;
-  diffRatio: number;
-  threshold: number;
-  heatmapUrl: string | null;
-}
-
-export interface InspectQaFrameResult {
-  id: string;
-  before: InspectQaArtifactHash;
-  after?: InspectQaArtifactHash;
-  domChanged?: boolean;
-  screenshotChanged?: boolean;
-  pixelDiff?: InspectQaPixelDiff;
-}
-
-export interface InspectQaFailure {
-  id: string;
-  error: string;
-}
-
-export interface InspectQaResult {
-  phase: 'baseline' | 'changed';
-  baselineId: string;
-  complete: boolean;
-  frames: InspectQaFrameResult[];
-  failures: InspectQaFailure[];
-}
-
-export interface InspectQaCaptureRequest {
-  phase: 'baseline' | 'changed';
-  basePath: string;
-  frameIds: string[];
-  baselineId?: string;
-}
-
-export type PygmalionIntegrationState =
-  'up_to_date' | 'auto_merged' | 'review_required' | 'conflict' | 'offline';
-
-export interface PygmalionDevMirrorStatus {
-  state: 'idle' | 'syncing' | 'ready' | 'error';
-  commit: string | null;
-  shortCommit: string | null;
-  /** Git ref the mirror is tracking, or null when it follows the source branch. */
-  sourceRef: string | null;
-  syncedAt: string | null;
-  updated: boolean;
-  warning: string | null;
-  error: string | null;
-  appOrigin: string | null;
-}
-
-export interface PygmalionVisualOperation {
-  id: string;
-  revision: number;
-  kind: 'visual';
-  createdAt: string;
-  commitSha: string;
-  files: string[];
-  integrationState: PygmalionIntegrationState;
-}
-
-export interface PygmalionVisualRevertOperation {
-  id: string;
-  revision: number;
-  kind: 'visual-revert';
-  createdAt: string;
-  commitSha: string;
-  revertsOperationId: string;
-  revertsRevision: number;
-  revertsCommitSha: string;
-  recordedCommitSha: string;
-  files: string[];
-  integrationState: PygmalionIntegrationState;
-}
-
-export type PygmalionSessionOperation =
-  PygmalionVisualOperation | PygmalionVisualRevertOperation;
-
-export interface PygmalionDesignSessionStatus {
-  id: string;
-  createdAt: string;
-  updatedAt: string;
-  createdFromSha: string;
-  baseDevSha: string;
-  branchName: string | null;
-  headSha: string | null;
-  revision: number;
-  integration: {
-    state: PygmalionIntegrationState;
-    latestDevSha: string;
-    checkedAt: string;
-    affectedFiles: string[];
-    conflictFiles: string[];
-    error?: string;
-  };
-  lastOperation: PygmalionSessionOperation | null;
-  canRevert: boolean;
-  lastRevertableOperation: PygmalionVisualOperation | null;
-  lastRevert: PygmalionVisualRevertOperation | null;
-  appOrigin: string | null;
-  previewError: string | null;
-}
-
-export interface PygmalionRevertResult {
-  reverted: true;
-  operation: PygmalionVisualRevertOperation;
-  session: PygmalionDesignSessionStatus;
-}
-
-export interface PygmalionProjectEndpoints {
-  mirror: string;
-  sessions: string;
-  inspect: string;
-}
-
-export interface PygmalionProjectRuntimeOptions {
-  endpoints?: Partial<PygmalionProjectEndpoints>;
-  sessionId?: string;
-  sessionStorageKey?: string;
-  autoStart?: boolean;
-  fetcher?: typeof fetch;
-  /** Automatically compare DOM and PNG hashes for affected screens before and after apply. */
-  visualQa?: {
-    endpoint?: string;
-    eligibleFrameIds: readonly string[];
-  };
-  formatApplyMessage?: (
-    session: PygmalionDesignSessionStatus,
-    applied: number,
-  ) => string | undefined;
-}
-
-/** One revision the mirror can be repointed at. */
-export interface PygmalionSourceRef {
-  name: string;
-  commit: string;
-  fullName: string;
-  kind: 'local' | 'remote';
-}
-
-/** Revisions available to `switchSource`, listed from the mirror repository. */
-export interface PygmalionSourceRefs {
-  refs: readonly PygmalionSourceRef[];
-  /** Revision followed when none is pinned. */
-  defaultRef: string | null;
-  /** Ref that renders uncommitted work. */
-  worktreeRef: string | null;
-}
-
-export interface SourceRefControlProps {
-  value: string | null;
-  /** Commit currently rendered by the mirror. Used to expose a newer ref tip. */
-  currentCommit?: string | null;
-  refs: readonly PygmalionSourceRef[];
-  onChange(ref: string): void;
-  busy?: boolean;
-  defaultRef?: string | null;
-  worktreeRef?: string | null;
-  label?: string;
-  /** Menu label for reloading the selected revision after its tip moves. */
-  refreshLabel?: string;
-  /** Trigger content. Defaults to the selected revision. */
-  children?: ReactNode;
-  className?: string;
-}
-
-/** Selects the revision the dev mirror follows. Owned by Pygmalion, not by the host. */
-export declare function SourceRefControl(props: SourceRefControlProps): ReactElement;
-
-export interface PygmalionProjectRuntime {
-  mirror: PygmalionDevMirrorStatus;
-  session: PygmalionDesignSessionStatus | null;
-  ready: boolean;
-  appOrigin: string | null;
-  previewRevision: string;
-  /**
-   * Source SHA of previewRevision, without the session mutation counter.
-   * Artifact bundles are stamped with this, so hosts must build artifact cache
-   * namespaces from it instead of parsing previewRevision themselves.
-   */
-  previewSourceRevision: string;
-  refresh(manual?: boolean, sourceRef?: string): Promise<void>;
-  /**
-   * Repoints the mirror at another git ref without restarting the dev server.
-   * Pass PYGMALION_WORKTREE_SOURCE_REF to preview uncommitted work.
-   * The artifact cache is keyed by source SHA, so a switch invalidates it.
-   */
-  switchSource(
-    sourceRef: string,
-    options?: { discardEdits?: boolean },
-  ): Promise<void>;
-  /**
-   * Revisions `switchSource` can be given. Empty until listed, so a host can
-   * offer a choice instead of asking for a ref string.
-   */
-  sourceRefs: PygmalionSourceRefs;
-  loadSourceRefs(): Promise<PygmalionSourceRefs>;
-  previewVisual(payload: InspectApplyPayload): Promise<InspectPreviewResult>;
-  inspectImpact(componentFiles: string[]): Promise<InspectImpactResult>;
-  applyVisual(payload: InspectApplyPayload): Promise<InspectApplyResult>;
-  revertLastVisual(): Promise<PygmalionRevertResult>;
-}
-
-export declare function usePygmalionProject(
-  options?: PygmalionProjectRuntimeOptions,
-): PygmalionProjectRuntime;
-
-export declare function PygmalionEditor(props: {
-  registry?: ComponentRegistry;
-  tokens?: TokenDef[];
-  initialPages?: InitialPageDef[];
-  /** Canvas shown on first mount. Useful when an earlier catalog canvas is expensive to render. */
-  initialCanvas?: string;
-  /**
-   * Mode the editor opens in. Defaults to 'edit'. Declare 'view-only' when the
-   * editor is a review surface: it applies once, so the toggle still belongs to
-   * the designer, and nothing is persisted across reloads.
-   */
-  initialEditMode?: 'edit' | 'view-only';
-  /** Explicit external-design to registered-code component mappings. */
-  componentConnections?: readonly DesignComponentConnectionDef[];
-  /** Named frame widths the application supports — rendered as one-click buttons beside the W/H boxes. */
-  viewportPresets?: readonly ViewportPresetDef[];
-  /** Host-declared browser conditions shown in the active frame's Preview inspector. */
-  previewEnvironmentControls?: readonly PreviewEnvironmentControlDef[];
-  /** icons/tokens/atoms/components/screens Controller for getting inventory and full DOM layers. */
-  designImport?: DesignImportController;
-  /** Called with cumulative changes when editing asset panel tokens — Host is responsible for write-back (file saving). */
-  onTokensChange?: (changed: { name: string; value: string }[]) => void;
-  /** The standard origin of the route page iframe ('' if same-origin). */
-  appOrigin?: string;
-  /** Code version as of preview (dev SHA, etc.). Even if the URL is the same, if the value changes, the screen cache is updated. */
-  previewRevision?: string;
-  /** Project/branch boundaries for screen caches that are persistent in the browser. Stable string separate from random dev port. */
-  previewCacheNamespace?: string;
-  /** A canonical screen snapshot created during build. When the namespace matches, it is injected into the cache before the first render. */
-  previewArtifacts?: RoutePreviewArtifactBundle;
-  /** Same-origin endpoint that resolves an exact namespace and source revision. Stale embedded previews remain visibly last-known until this endpoint returns an exact frame. */
-  previewArtifactEndpoint?: string;
-  /** Number of actual app previews to run simultaneously. Defaults to an adaptive 12–32 lanes. */
-  previewConcurrency?: number;
-  /** Controlled by external status such as host route ▶ Whether the preview is opened or not. */
-  previewOpen?: boolean;
-  /** ▶ Called when the preview is opened or closed — allows the host to synchronize URLs. */
-  onPreviewOpenChange?: (open: boolean) => void;
-  /** ▶ The name of the “app screen flow” canvas that the preview will always play — Enter this canvas screen even if you press it on another canvas. */
-  flowCanvas?: string;
-  /**
-   * Static surface for route frames: `bitmap` (default) renders captured
-   * screenshots and reconstructs frozen DOM on demand; `dom` mounts the
-   * frozen DOM from the start — recommended with per-section canvases.
-   */
-  frameSurface?: 'bitmap' | 'dom';
-  /**
-   * Host-declared flow paths — the captureless surface supply. One hidden
-   * live instance walks each path and publishes a frozen snapshot per
-   * waypoint; frames a flow claims wait for delivery instead of booting
-   * live. Screens no flow claims keep the artifact/sweep/boot supply.
-   */
-  screenFlows?: readonly ScreenFlowPath[];
-  /**
-   * Host-declared scenario coverage ledger. The right panel lists a screen's
-   * claims as executable rows and badges component controls with the
-   * scenarios they demonstrate.
-   */
-  scenarioCoverage?: readonly ScenarioCoverageClaim[];
-  /** Curated per-screen dimension controls (see ScreenDimensionDef). */
-  screenDimensions?: readonly ScreenDimensionDef[];
-  /** Row-count controls for repeating lists (see ScreenListDef). */
-  screenLists?: readonly ScreenListDef[];
-  /** Section header bands (see SectionHeaderDef). */
-  sectionHeaders?: readonly SectionHeaderDef[];
-  /** Situation lanes: one lane is one canvas row (see ScreenLaneDef). */
-  screenLanes?: readonly ScreenLaneDef[];
-  /** Branch-kind presentation for frame labels (see FrameBranchKindDef). */
-  frameBranchKinds?: readonly FrameBranchKindDef[];
-  /** Words for the facts a frame label counts. */
-  frameLabelLabels?: FrameLabelLabels;
-  /** Words for the facts a section header counts. */
-  sectionHeaderLabels?: SectionHeaderLabels;
-  /** Badge composition per repeated card (see ScreenCardDef). */
-  screenCards?: readonly ScreenCardDef[];
-  /**
-   * How many frames may render the running application instead of their
-   * capture. Default 0 — every frame is served from its capture. Raise it
-   * to keep the frames in use interactive; the least recently activated
-   * holder gives its slot back.
-   */
-  liveScreenBudget?: number;
-  /** Interactive axes reachable by acting on a screen (see InteractiveStateDef). */
-  interactiveStates?: readonly InteractiveStateDef[];
-  /**
-   * Host verdicts for the surfaces the editor asks about. Each either names the
-   * declaration that covers it or excludes it with a reason; anything
-   * unanswered shows on the frame as an unclassified surface.
-   */
-  surfaceClassifications?: readonly SurfaceClassification[];
-  /** Reflect button — Returns { branch } after the host saves the file and commits the branch (push is done directly by the user). */
-  onApply?: (payload: ApplyPayload) => Promise<{ branch: string } | void>;
-  /** Code auto-save path that does not differentiate between icon/token/atom/component/screen. */
-  onDesignChange?: (
-    payload: DesignChangePayload,
-  ) => Promise<DesignChangeResult | void>;
-  /** Apply inspection edits through the host write-back endpoint. */
-  onInspectApply?: (
-    payload: InspectApplyPayload,
-  ) => Promise<InspectApplyResult | void>;
-  /** Preview the code diff before applying. If connected, the Apply button is locked before confirmation. */
-  onInspectPreview?: (
-    payload: InspectApplyPayload,
-  ) => Promise<InspectPreviewResult>;
-  /** Check the reverse dependency closure of the changed source file. */
-  onInspectImpact?: (componentFiles: string[]) => Promise<InspectImpactResult>;
-  /** Authored screen paths and starts merged with source-discovered navigation. */
-  storyboard?: StoryboardDefinition;
-  /** Detect portable browser branches from source before route frames boot. Default true. */
-  storyboardDiscovery?: boolean;
-  /** Vite endpoint that returns the generated generic storyboard environment manifest. */
-  storyboardDiscoveryEndpoint?: string;
-}): ReactElement;
-
-/** Edit token values ​​in code (live override + onTokensChange notification). */
-export declare function applyTokenOverride(name: string, value: string): void;
-
-/** Disable all token overrides. */
-export declare function resetTokenOverrides(): void;
-
-/** Called from the actual button handler of the host screen fixture — Switches to the name matching page (common in editor and preview). */
-export declare function pygmalionNavigate(pageName: string): void;
-
-/** Open the prototype preview (▶) in the code. */
-export declare function pygmalionOpenPreview(): void;
-/** Discard unapplied canvas and inspection edits created after the latest source load or apply. */
-export declare function pygmalionResetCurrentEdits(): boolean;
-
-/** For host debugging — editor store·mobx inspection utility (instance in bundle). */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export declare const __debug: {
-  editor: any;
-  getObserverTree: any;
-  isObservableProp: any;
-};