@vizejs/fresco 0.716.0 → 0.718.0

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/kittyKeyboard.ts"],"sourcesContent":["/**\n * Kitty keyboard protocol constants compatible with Ink.\n */\n\n/** Bit values defined by the Kitty keyboard progressive-enhancement protocol. */\nexport const kittyFlags = {\n  disambiguateEscapeCodes: 1,\n  reportEventTypes: 2,\n  reportAlternateKeys: 4,\n  reportAllKeysAsEscapeCodes: 8,\n  reportAssociatedText: 16,\n} as const;\n\n/** Supported Kitty keyboard protocol flag name. */\nexport type KittyFlagName = keyof typeof kittyFlags;\n\n/** Kitty keyboard protocol negotiation options. */\nexport interface KittyKeyboardOptions {\n  /** Whether protocol negotiation is automatic, forced, or disabled. @default \"auto\" */\n  mode?: \"auto\" | \"enabled\" | \"disabled\";\n  /** Progressive-enhancement flags requested from the terminal. @default [] */\n  flags?: KittyFlagName[];\n}\n\n/** Combine named Kitty keyboard flags into the protocol bit mask. */\nexport function resolveKittyFlags(flags: KittyFlagName[]): number {\n  return flags.reduce((bits, flag) => bits | kittyFlags[flag], 0);\n}\n\n/** Modifier bit values reported by the Kitty keyboard protocol. */\nexport const kittyModifiers = {\n  shift: 1,\n  alt: 2,\n  ctrl: 4,\n  super: 8,\n  hyper: 16,\n  meta: 32,\n  capsLock: 64,\n  numLock: 128,\n} as const;\n"],"mappings":";;;;;;;;;AAKA,MAAa,aAAa;CACxB,yBAAyB;CACzB,kBAAkB;CAClB,qBAAqB;CACrB,4BAA4B;CAC5B,sBAAsB;AACxB;;AAcA,SAAgB,kBAAkB,OAAgC;CAChE,OAAO,MAAM,QAAQ,MAAM,SAAS,OAAO,WAAW,OAAO,CAAC;AAChE;;AAGA,MAAa,iBAAiB;CAC5B,OAAO;CACP,KAAK;CACL,MAAM;CACN,OAAO;CACP,OAAO;CACP,MAAM;CACN,UAAU;CACV,SAAS;AACX"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/kittyKeyboard.ts","../src/plugins.ts","../src/devtools.ts","../src/theme.ts"],"sourcesContent":["/**\n * Kitty keyboard protocol constants compatible with Ink.\n */\n\n/** Bit values defined by the Kitty keyboard progressive-enhancement protocol. */\nexport const kittyFlags = {\n  disambiguateEscapeCodes: 1,\n  reportEventTypes: 2,\n  reportAlternateKeys: 4,\n  reportAllKeysAsEscapeCodes: 8,\n  reportAssociatedText: 16,\n} as const;\n\n/** Supported Kitty keyboard protocol flag name. */\nexport type KittyFlagName = keyof typeof kittyFlags;\n\n/** Kitty keyboard protocol negotiation options. */\nexport interface KittyKeyboardOptions {\n  /** Whether protocol negotiation is automatic, forced, or disabled. @default \"auto\" */\n  mode?: \"auto\" | \"enabled\" | \"disabled\";\n  /** Progressive-enhancement flags requested from the terminal. @default [] */\n  flags?: KittyFlagName[];\n}\n\n/** Combine named Kitty keyboard flags into the protocol bit mask. */\nexport function resolveKittyFlags(flags: KittyFlagName[]): number {\n  return flags.reduce((bits, flag) => bits | kittyFlags[flag], 0);\n}\n\n/** Modifier bit values reported by the Kitty keyboard protocol. */\nexport const kittyModifiers = {\n  shift: 1,\n  alt: 2,\n  ctrl: 4,\n  super: 8,\n  hyper: 16,\n  meta: 32,\n  capsLock: 64,\n  numLock: 128,\n} as const;\n","import { inject, type App as VueApp, type Component, type InjectionKey, type Plugin } from \"vue\";\n\n/** Typed provider owned by a Fresco extension. */\nexport interface FrescoProvider<Value> {\n  /** Stable Vue injection key for advanced adapter integration. */\n  readonly key: InjectionKey<Value>;\n  /** Install a value while a plugin is configuring the application. */\n  provide(app: VueApp, value: Value): void;\n  /** Read the nearest value from component setup. */\n  use(): Value;\n}\n\n/** Declarative component and provider setup for one Fresco plugin. */\nexport interface FrescoPluginDefinition {\n  /** Optional global components keyed by their public template names. */\n  readonly components?: Readonly<Record<string, Component>>;\n  /** Additional provider or application setup performed during installation. */\n  readonly setup?: (app: VueApp) => void;\n}\n\n/**\n * Define a typed extension provider with an optional fallback value.\n *\n * Fallback presence follows argument presence: explicitly passing `undefined`\n * is a valid fallback for value types that include it.\n */\nexport function defineFrescoProvider<Value>(\n  description: string,\n  fallback?: Value,\n): FrescoProvider<Value> {\n  const key: InjectionKey<Value> = Symbol(description);\n  const hasFallback = arguments.length >= 2;\n  const missing = Symbol(\"missing-fresco-provider\");\n\n  return {\n    key,\n    provide(app, value) {\n      app.provide(key, value);\n    },\n    use() {\n      const value = inject(key as InjectionKey<Value | typeof missing>, missing);\n      if (value !== missing) return value;\n      if (hasFallback) return fallback as Value;\n      throw new Error(`Fresco provider ${JSON.stringify(description)} is not installed`);\n    },\n  };\n}\n\n/** Define a Vue plugin that registers Fresco components and typed providers. */\nexport function defineFrescoPlugin(definition: Readonly<FrescoPluginDefinition>): Plugin<[]> {\n  return {\n    install(app) {\n      for (const [name, component] of Object.entries(definition.components ?? {})) {\n        app.component(name, component);\n      }\n      definition.setup?.(app);\n    },\n  };\n}\n","import type { LayoutResultNapi } from \"@vizejs/fresco-native\";\nimport type { FrescoInputEvent } from \"./protocol.js\";\nimport type {\n  FrescoDeclaredSize,\n  FrescoHostNode,\n  FrescoNodeLifecycleHooks,\n  FrescoNodeUpdateKind,\n  FrescoRenderNodeKind,\n} from \"./renderer.js\";\n\n/** One immutable native layout rectangle joined to its host node. */\nexport interface FrescoLayoutInspection {\n  readonly x: number;\n  readonly y: number;\n  readonly width: number;\n  readonly height: number;\n}\n\n/** Flat, immutable host-node record suitable for tree inspectors. */\nexport interface FrescoNodeInspection {\n  readonly id: number;\n  readonly type: FrescoRenderNodeKind;\n  readonly parentId: number | null;\n  readonly childIds: readonly number[];\n  readonly depth: number;\n  readonly props: Readonly<Record<string, unknown>>;\n  readonly text?: string;\n  readonly layout: FrescoLayoutInspection | null;\n}\n\n/** One inspected Fresco host tree and the native layouts joined to it. */\nexport interface FrescoTreeInspection {\n  readonly rootId: number;\n  readonly nodes: readonly FrescoNodeInspection[];\n  readonly nodeCount: number;\n  readonly layoutCount: number;\n  /** Layout ids that did not belong to the inspected host tree. */\n  readonly unmatchedLayoutIds: readonly number[];\n}\n\n/** Metrics recorded after one application frame. */\nexport interface FrescoDevtoolsRenderMetrics {\n  readonly renderTime: number;\n  readonly nodeCount: number;\n  readonly layoutCount: number;\n}\n\ninterface FrescoDevtoolsEventBase {\n  /** Monotonic event order local to this devtools instance. */\n  readonly sequence: number;\n  readonly nodeId?: number;\n}\n\n/** Bounded, discriminated event records emitted by Fresco devtools. */\nexport type FrescoDevtoolsEvent =\n  | (FrescoDevtoolsEventBase & {\n      readonly type: \"create\";\n      readonly nodeId: number;\n      readonly nodeType: FrescoRenderNodeKind;\n    })\n  | (FrescoDevtoolsEventBase & {\n      readonly type: \"update\";\n      readonly nodeId: number;\n      readonly updateKind: FrescoNodeUpdateKind;\n    })\n  | (FrescoDevtoolsEventBase & {\n      readonly type: \"resize\";\n      readonly nodeId: number;\n      readonly previous: FrescoDeclaredSize;\n      readonly current: FrescoDeclaredSize;\n    })\n  | (FrescoDevtoolsEventBase & {\n      readonly type: \"remove\";\n      readonly nodeId: number;\n      readonly nodeType: FrescoRenderNodeKind;\n    })\n  | (FrescoDevtoolsEventBase & {\n      readonly type: \"input\";\n      readonly input: FrescoInputEvent;\n    })\n  | (FrescoDevtoolsEventBase & {\n      readonly type: \"render\";\n      readonly metrics: FrescoDevtoolsRenderMetrics;\n    });\n\ntype WithoutSequence<Event> = Event extends unknown ? Omit<Event, \"sequence\"> : never;\ntype FrescoDevtoolsEventInput = WithoutSequence<FrescoDevtoolsEvent>;\n\n/** Point-in-time state returned by {@link FrescoDevtools.snapshot}. */\nexport interface FrescoDevtoolsSnapshot {\n  readonly tree: FrescoTreeInspection | null;\n  readonly events: readonly FrescoDevtoolsEvent[];\n  readonly latestRender: FrescoDevtoolsRenderMetrics | null;\n}\n\n/** Configuration for {@link createFrescoDevtools}. */\nexport interface FrescoDevtoolsOptions {\n  /** Maximum retained trace events. Older records are discarded first. @default 200 */\n  eventLimit?: number;\n}\n\n/** Inspector and bounded trace collector accepted by `createApp`. */\nexport interface FrescoDevtools {\n  /** Lifecycle hooks wired into the public Fresco renderer. */\n  readonly lifecycle: FrescoNodeLifecycleHooks;\n  /** Record one normalized terminal input event. */\n  recordInput(input: FrescoInputEvent): void;\n  /** Join a rendered host tree with its native layouts and render metrics. */\n  recordRender(\n    root: FrescoHostNode,\n    layouts: readonly LayoutResultNapi[],\n    metrics: FrescoDevtoolsRenderMetrics,\n  ): FrescoTreeInspection;\n  /** Read an immutable copy of the current inspector state and bounded trace. */\n  snapshot(): FrescoDevtoolsSnapshot;\n  /** Remove trace records without discarding the latest tree or metrics. */\n  clearEvents(): void;\n}\n\n/** Options for the terminal-friendly debug overlay formatter. */\nexport interface FrescoDebugOverlayOptions {\n  /** Maximum tree rows included after the summary. @default 20 */\n  maxNodes?: number;\n  /** Maximum recent trace rows included after the tree. @default 8 */\n  maxEvents?: number;\n}\n\nfunction copyLayout(layout: LayoutResultNapi): FrescoLayoutInspection {\n  return {\n    x: layout.x,\n    y: layout.y,\n    width: layout.width,\n    height: layout.height,\n  };\n}\n\n/**\n * Join a live host tree with the layout results produced by the same native frame.\n *\n * The returned records are flat and immutable, so devtools can index them without\n * retaining parent back-references or the mutable Vue renderer tree.\n */\nexport function inspectFrescoTree(\n  root: FrescoHostNode,\n  layouts: readonly LayoutResultNapi[] = [],\n): FrescoTreeInspection {\n  const layoutsById = new Map(layouts.map((layout) => [layout.id, layout]));\n  const matchedLayoutIds = new Set<number>();\n  const nodes: FrescoNodeInspection[] = [];\n\n  const visit = (node: FrescoHostNode, depth: number) => {\n    const layout = layoutsById.get(node.id);\n    if (layout) matchedLayoutIds.add(node.id);\n    nodes.push({\n      id: node.id,\n      type: node.type,\n      parentId: node.parent?.id ?? null,\n      childIds: node.children.map((child) => child.id),\n      depth,\n      props: { ...node.props },\n      ...(node.text === undefined ? {} : { text: node.text }),\n      layout: layout ? copyLayout(layout) : null,\n    });\n    for (const child of node.children) visit(child, depth + 1);\n  };\n\n  visit(root, 0);\n  return {\n    rootId: root.id,\n    nodes,\n    nodeCount: nodes.length,\n    layoutCount: matchedLayoutIds.size,\n    unmatchedLayoutIds: layouts\n      .map((layout) => layout.id)\n      .filter((id) => !matchedLayoutIds.has(id)),\n  };\n}\n\nfunction retainedLimit(limit: number | undefined): number {\n  if (limit === undefined) return 200;\n  if (!Number.isFinite(limit)) return 200;\n  return Math.max(0, Math.floor(limit));\n}\n\n/** Create one opt-in tree inspector and bounded event trace collector. */\nexport function createFrescoDevtools(options: FrescoDevtoolsOptions = {}): FrescoDevtools {\n  const eventLimit = retainedLimit(options.eventLimit);\n  const events: FrescoDevtoolsEvent[] = [];\n  let sequence = 0;\n  let tree: FrescoTreeInspection | null = null;\n  let latestRender: FrescoDevtoolsRenderMetrics | null = null;\n\n  const append = (event: FrescoDevtoolsEventInput) => {\n    if (eventLimit === 0) return;\n    events.push({ ...event, sequence: sequence++ } as FrescoDevtoolsEvent);\n    const overflow = events.length - eventLimit;\n    if (overflow > 0) events.splice(0, overflow);\n  };\n\n  const lifecycle: FrescoNodeLifecycleHooks = {\n    onCreate(node) {\n      append({ type: \"create\", nodeId: node.id, nodeType: node.type });\n    },\n    onUpdate(node, updateKind) {\n      append({ type: \"update\", nodeId: node.id, updateKind });\n    },\n    onResize(node, previous, current) {\n      append({ type: \"resize\", nodeId: node.id, previous, current });\n    },\n    onRemove(node) {\n      append({ type: \"remove\", nodeId: node.id, nodeType: node.type });\n    },\n  };\n\n  return {\n    lifecycle,\n    recordInput(input) {\n      append({ type: \"input\", input: { ...input } as FrescoInputEvent });\n    },\n    recordRender(root, layouts, metrics) {\n      tree = inspectFrescoTree(root, layouts);\n      latestRender = { ...metrics };\n      append({ type: \"render\", metrics: latestRender });\n      return tree;\n    },\n    snapshot() {\n      return {\n        tree,\n        events: events.map((event) => ({ ...event })),\n        latestRender,\n      };\n    },\n    clearEvents() {\n      events.length = 0;\n    },\n  };\n}\n\nfunction formatNode(node: FrescoNodeInspection): string {\n  const indent = \"  \".repeat(node.depth);\n  const layout = node.layout\n    ? ` ${node.layout.width}x${node.layout.height}@${node.layout.x},${node.layout.y}`\n    : \" layout:pending\";\n  const text = node.text === undefined ? \"\" : ` ${JSON.stringify(node.text)}`;\n  return `${indent}#${node.id} ${node.type}${layout}${text}`;\n}\n\nfunction formatEvent(event: FrescoDevtoolsEvent): string {\n  switch (event.type) {\n    case \"create\":\n      return `${event.sequence} create #${event.nodeId} ${event.nodeType}`;\n    case \"update\":\n      return `${event.sequence} update #${event.nodeId} ${event.updateKind}`;\n    case \"resize\":\n      return `${event.sequence} resize #${event.nodeId}`;\n    case \"remove\":\n      return `${event.sequence} remove #${event.nodeId} ${event.nodeType}`;\n    case \"input\":\n      return `${event.sequence} input ${event.input.type}`;\n    case \"render\":\n      return `${event.sequence} render ${event.metrics.renderTime.toFixed(2)}ms`;\n  }\n}\n\n/** Render an inspector snapshot as a compact terminal debug overlay. */\nexport function formatFrescoDebugOverlay(\n  snapshot: FrescoDevtoolsSnapshot,\n  options: FrescoDebugOverlayOptions = {},\n): string {\n  const maxNodes = Math.max(0, Math.floor(options.maxNodes ?? 20));\n  const maxEvents = Math.max(0, Math.floor(options.maxEvents ?? 8));\n  const render = snapshot.latestRender;\n  const summary = render\n    ? `Fresco ${render.nodeCount} nodes · ${render.layoutCount} layouts · ${render.renderTime.toFixed(2)}ms`\n    : \"Fresco devtools · waiting for first render\";\n  const treeRows = snapshot.tree?.nodes.slice(0, maxNodes).map(formatNode) ?? [];\n  const eventRows = snapshot.events.slice(-maxEvents).map(formatEvent);\n  return [summary, ...treeRows, ...(eventRows.length > 0 ? [\"events\", ...eventRows] : [])].join(\n    \"\\n\",\n  );\n}\n","import {\n  computed,\n  inject,\n  provide,\n  toValue,\n  type InjectionKey,\n  type MaybeRefOrGetter,\n  type Ref,\n} from \"vue\";\n\nimport type { FrescoBorderStyle } from \"./protocol.js\";\n\n/** Semantic terminal colors consumed by Fresco components and applications. */\nexport interface FrescoThemeColors {\n  foreground: string;\n  background: string;\n  muted: string;\n  primary: string;\n  accent: string;\n  positive: string;\n  caution: string;\n  negative: string;\n  info: string;\n  focus: string;\n}\n\n/** Cell-based spacing scale shared by layout components. */\nexport interface FrescoThemeSpacing {\n  none: number;\n  xs: number;\n  sm: number;\n  md: number;\n  lg: number;\n  xl: number;\n}\n\n/** Border defaults for progressively stronger terminal surfaces. */\nexport interface FrescoThemeBorders {\n  subtle: FrescoBorderStyle;\n  regular: FrescoBorderStyle;\n  strong: FrescoBorderStyle;\n}\n\n/** Animation timing contract, including the effective reduced-motion policy. */\nexport interface FrescoThemeMotion {\n  reduced: boolean;\n  fastMs: number;\n  regularMs: number;\n  slowMs: number;\n}\n\n/** Complete, resolved Fresco theme available to descendants. */\nexport interface FrescoTheme {\n  colors: FrescoThemeColors;\n  spacing: FrescoThemeSpacing;\n  borders: FrescoThemeBorders;\n  motion: FrescoThemeMotion;\n}\n\n/** Scoped partial theme layered over the nearest provider. */\nexport interface FrescoThemeOverride {\n  colors?: Partial<FrescoThemeColors>;\n  spacing?: Partial<FrescoThemeSpacing>;\n  borders?: Partial<FrescoThemeBorders>;\n  motion?: Partial<FrescoThemeMotion>;\n}\n\n/** Static defaults shared without runtime stylesheet or token generation. */\nexport const defaultFrescoTheme: Readonly<FrescoTheme> = Object.freeze({\n  colors: Object.freeze({\n    foreground: \"white\",\n    background: \"black\",\n    muted: \"gray\",\n    primary: \"cyan\",\n    accent: \"magenta\",\n    positive: \"green\",\n    caution: \"yellow\",\n    negative: \"red\",\n    info: \"blue\",\n    focus: \"cyan\",\n  }),\n  spacing: Object.freeze({ none: 0, xs: 1, sm: 1, md: 2, lg: 3, xl: 4 }),\n  borders: Object.freeze({ subtle: \"single\", regular: \"rounded\", strong: \"double\" }),\n  motion: Object.freeze({ reduced: false, fastMs: 80, regularMs: 160, slowMs: 240 }),\n});\n\n/** Injection identity for framework adapters that bridge Fresco theme scopes. */\nexport const FRESCO_THEME_KEY: InjectionKey<Readonly<Ref<FrescoTheme>>> = Symbol(\"fresco-theme\");\n\n/** Resolve one scoped override without mutating its parent theme. */\nexport function resolveFrescoTheme(\n  parent: Readonly<FrescoTheme>,\n  override: Readonly<FrescoThemeOverride> = {},\n): FrescoTheme {\n  return {\n    colors: { ...parent.colors, ...override.colors },\n    spacing: { ...parent.spacing, ...override.spacing },\n    borders: { ...parent.borders, ...override.borders },\n    motion: { ...parent.motion, ...override.motion },\n  };\n}\n\n/** Provide a reactive theme scoped to the current component subtree. */\nexport function provideFrescoTheme(\n  override: MaybeRefOrGetter<FrescoThemeOverride> = {},\n): Readonly<Ref<FrescoTheme>> {\n  const parent = inject(FRESCO_THEME_KEY, undefined);\n  const theme = computed(() =>\n    resolveFrescoTheme(parent?.value ?? defaultFrescoTheme, toValue(override)),\n  );\n  provide(FRESCO_THEME_KEY, theme);\n  return theme;\n}\n\n/** Read the nearest resolved theme, falling back to the static defaults. */\nexport function useFrescoTheme(): Readonly<Ref<FrescoTheme>> {\n  const theme = inject(FRESCO_THEME_KEY, undefined);\n  return theme ?? computed(() => defaultFrescoTheme as FrescoTheme);\n}\n"],"mappings":"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"}

package/dist/{protocol-D8xt3DG7.d.mts → protocol-DavoeNLn.d.mts}

@@ -1,7 +1,7 @@
 //#region src/protocol.d.ts
 /** Public JavaScript protocol shared by Fresco components and the renderer. */
 /** Discriminant shared by JavaScript and native render nodes. */
-type FrescoRenderNodeKind = "root" | "box" | "text" | "input";
+type FrescoRenderNodeKind = "root" | "box" | "text" | "input" | "raw";
 /** Numeric or CSS-like dimension accepted by component style props. */
 type FrescoDimension = number | string;
 /** Display modes supported by the native layout engine. */
@@ -142,14 +142,24 @@ interface FrescoInputRenderNode extends FrescoRenderNodeBase {
   placeholder?: string;
   focused?: boolean;
   cursor?: number;
+  /** Inclusive grapheme index at the start of the active selection. */
+  selectionStart?: number;
+  /** Exclusive grapheme index at the end of the active selection. */
+  selectionEnd?: number;
   mask?: boolean;
   maskChar?: string;
 }
+/** Precomposed terminal lines emitted without text wrapping. */
+interface FrescoRawRenderNode extends FrescoRenderNodeBase {
+  nodeType: "raw";
+  /** Exact terminal rows painted in order inside the computed layout. */
+  lines?: string[];
+}
 type UnionKeys<Union> = Union extends Union ? keyof Union : never;
 type StrictUnionHelper<Member, Union> = Member extends Member ? Member & Partial<Record<Exclude<UnionKeys<Union>, keyof Member>, never>> : never;
 type StrictUnion<Union> = StrictUnionHelper<Union, Union>;
 /** Strict discriminated union accepted by the native render bridge. */
-type FrescoRenderNode = StrictUnion<FrescoRootRenderNode | FrescoBoxRenderNode | FrescoTextRenderNode | FrescoInputRenderNode>;
+type FrescoRenderNode = StrictUnion<FrescoRootRenderNode | FrescoBoxRenderNode | FrescoTextRenderNode | FrescoInputRenderNode | FrescoRawRenderNode>;
 /** Lifecycle phase attached to a normalized keyboard event. */
 type KeyEventType = "press" | "repeat" | "release";
 /** Modifier state shared by keyboard and mouse events. */
@@ -208,5 +218,5 @@ type FrescoInputEvent = StrictUnion<KeyEvent | PasteEvent | ResizeEvent | MouseE
 /** Compatibility alias for the pre-protocol event union name. */
 type InputEvent = FrescoInputEvent;
 //#endregion
-export { KeyEvent as A, FrescoRenderStyle as C, FrescoTextRenderNode as D, FrescoStyle as E, MouseEvent as M, PasteEvent as N, FrescoTextWrapMode as O, ResizeEvent as P, FrescoRenderNodeKind as S, FrescoSnakeStyleAliases as T, FrescoModifiers as _, FrescoAlignSelf as a, FrescoPosition as b, FrescoBoxRenderNode as c, FrescoDisplay as d, FrescoFlexDirection as f, FrescoJustifyContent as g, FrescoInputRenderNode as h, FrescoAlignItems as i, KeyEventType as j, InputEvent as k, FrescoCanonicalStyle as l, FrescoInputEvent as m, FocusEvent as n, FrescoAppearance as o, FrescoFlexWrap as p, FrescoAlignContent as r, FrescoBorderStyle as s, CompositionEvent as t, FrescoDimension as u, FrescoMouseEventKind as v, FrescoRootRenderNode as w, FrescoRenderNode as x, FrescoOverflow as y };
-//# sourceMappingURL=protocol-D8xt3DG7.d.mts.map
+export { InputEvent as A, FrescoRenderNodeKind as C, FrescoStyle as D, FrescoSnakeStyleAliases as E, ResizeEvent as F, KeyEventType as M, MouseEvent as N, FrescoTextRenderNode as O, PasteEvent as P, FrescoRenderNode as S, FrescoRootRenderNode as T, FrescoModifiers as _, FrescoAlignSelf as a, FrescoPosition as b, FrescoBoxRenderNode as c, FrescoDisplay as d, FrescoFlexDirection as f, FrescoJustifyContent as g, FrescoInputRenderNode as h, FrescoAlignItems as i, KeyEvent as j, FrescoTextWrapMode as k, FrescoCanonicalStyle as l, FrescoInputEvent as m, FocusEvent as n, FrescoAppearance as o, FrescoFlexWrap as p, FrescoAlignContent as r, FrescoBorderStyle as s, CompositionEvent as t, FrescoDimension as u, FrescoMouseEventKind as v, FrescoRenderStyle as w, FrescoRawRenderNode as x, FrescoOverflow as y };
+//# sourceMappingURL=protocol-DavoeNLn.d.mts.map

package/dist/{protocol-D8xt3DG7.d.mts.map → protocol-DavoeNLn.d.mts.map}

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

package/dist/qr-code/index.d.mts

@@ -0,0 +1,101 @@
+import { PropType } from "vue";
+
+//#region src/qr-code/index.d.ts
+type QrCodeErrorCorrection = "low" | "medium" | "quartile" | "high";
+type QrCodeMatrix = readonly (readonly boolean[])[];
+interface QrCodeProviderOptions {
+  errorCorrection: QrCodeErrorCorrection;
+}
+type QrCodeProvider = (value: string, options: Readonly<QrCodeProviderOptions>) => QrCodeMatrix;
+interface QrCodeProps {
+  value: string;
+  provider: QrCodeProvider;
+  errorCorrection?: QrCodeErrorCorrection;
+  quietZone?: number;
+  cellWidth?: number;
+  dark?: string;
+  light?: string;
+  fg?: string;
+  bg?: string;
+  invert?: boolean;
+}
+/** Preserve a provider's exact public type without wrapping its implementation. */
+declare function defineQrCodeProvider(provider: QrCodeProvider): QrCodeProvider;
+/** Render a provider matrix without bundling a QR encoder in Fresco. */
+declare const QrCode: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+  provider: {
+    type: PropType<QrCodeProvider>;
+    required: true;
+  };
+  errorCorrection: {
+    type: PropType<QrCodeErrorCorrection>;
+    default: string;
+  };
+  quietZone: {
+    type: NumberConstructor;
+    default: number;
+  };
+  cellWidth: {
+    type: NumberConstructor;
+    default: number;
+  };
+  dark: {
+    type: StringConstructor;
+    default: string;
+  };
+  light: {
+    type: StringConstructor;
+    default: string;
+  };
+  fg: StringConstructor;
+  bg: StringConstructor;
+  invert: BooleanConstructor;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+  provider: {
+    type: PropType<QrCodeProvider>;
+    required: true;
+  };
+  errorCorrection: {
+    type: PropType<QrCodeErrorCorrection>;
+    default: string;
+  };
+  quietZone: {
+    type: NumberConstructor;
+    default: number;
+  };
+  cellWidth: {
+    type: NumberConstructor;
+    default: number;
+  };
+  dark: {
+    type: StringConstructor;
+    default: string;
+  };
+  light: {
+    type: StringConstructor;
+    default: string;
+  };
+  fg: StringConstructor;
+  bg: StringConstructor;
+  invert: BooleanConstructor;
+}>> & Readonly<{}>, {
+  invert: boolean;
+  errorCorrection: QrCodeErrorCorrection;
+  quietZone: number;
+  cellWidth: number;
+  dark: string;
+  light: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { QrCode, QrCodeErrorCorrection, QrCodeMatrix, QrCodeProps, QrCodeProvider, QrCodeProviderOptions, defineQrCodeProvider };
+//# sourceMappingURL=index.d.mts.map

package/dist/qr-code/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/qr-code/index.ts"],"mappings":";;;KAIY,qBAAA;AAAA,KACA,YAAA;AAAA,UAEK,qBAAA;EACf,eAAA,EAAiB,qBAAqB;AAAA;AAAA,KAG5B,cAAA,IACV,KAAA,UACA,OAAA,EAAS,QAAA,CAAS,qBAAA,MACf,YAAA;AAAA,UAEY,WAAA;EACf,KAAA;EACA,QAAA,EAAU,cAAA;EACV,eAAA,GAAkB,qBAAqB;EACvC,SAAA;EACA,SAAA;EACA,IAAA;EACA,KAAA;EACA,EAAA;EACA,EAAA;EACA,MAAA;AAAA;;iBAIc,oBAAA,CAAqB,QAAA,EAAU,cAAA,GAAiB,cAAc;;cAgCjE,MAAA,gBAAM,eAAA,eAAA,gBAAA;;;;;;UAIe,QAAA,CAAS,cAAA;;;;UAErB,QAAA,CAAS,qBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAFG,QAAA,CAAS,cAAA;;;;UAErB,QAAA,CAAS,qBAAA"}

package/dist/qr-code/index.mjs

@@ -0,0 +1,88 @@
+import { computed, defineComponent, h } from "vue";
+//#region src/qr-code/index.ts
+/** Optional, provider-driven QR code entry point. */
+/** Preserve a provider's exact public type without wrapping its implementation. */
+function defineQrCodeProvider(provider) {
+	return provider;
+}
+function normalizedInteger(value, fallback) {
+	if (!Number.isFinite(value)) return fallback;
+	return Math.max(0, Math.trunc(value));
+}
+function validateMatrix(matrix) {
+	if (matrix.length === 0) throw new Error("FRESCO_QR_MATRIX_EMPTY: provider returned an empty matrix");
+	const size = matrix.length;
+	return matrix.map((row, rowIndex) => {
+		if (row.length !== size) throw new Error(`FRESCO_QR_MATRIX_SQUARE: row ${rowIndex} has ${row.length} cells; expected ${size}`);
+		return row.map((cell, columnIndex) => {
+			if (typeof cell !== "boolean") throw new Error(`FRESCO_QR_MATRIX_CELL: row ${rowIndex}, column ${columnIndex} is not boolean`);
+			return cell;
+		});
+	});
+}
+/** Render a provider matrix without bundling a QR encoder in Fresco. */
+const QrCode = defineComponent({
+	name: "QrCode",
+	props: {
+		value: {
+			type: String,
+			required: true
+		},
+		provider: {
+			type: Function,
+			required: true
+		},
+		errorCorrection: {
+			type: String,
+			default: "medium"
+		},
+		quietZone: {
+			type: Number,
+			default: 2
+		},
+		cellWidth: {
+			type: Number,
+			default: 2
+		},
+		dark: {
+			type: String,
+			default: "█"
+		},
+		light: {
+			type: String,
+			default: " "
+		},
+		fg: String,
+		bg: String,
+		invert: Boolean
+	},
+	setup(props) {
+		const matrix = computed(() => validateMatrix(props.provider(props.value, { errorCorrection: props.errorCorrection })));
+		const rows = computed(() => {
+			const quietZone = normalizedInteger(props.quietZone, 2);
+			const cellWidth = Math.max(1, normalizedInteger(props.cellWidth, 2));
+			const dark = (props.invert ? props.light : props.dark).repeat(cellWidth);
+			const light = (props.invert ? props.dark : props.light).repeat(cellWidth);
+			const quietRow = light.repeat(matrix.value.length + quietZone * 2);
+			const horizontalPadding = light.repeat(quietZone);
+			return [
+				...Array(quietZone).fill(quietRow),
+				...matrix.value.map((row) => `${horizontalPadding}${row.map((cell) => cell ? dark : light).join("")}${horizontalPadding}`),
+				...Array(quietZone).fill(quietRow)
+			];
+		});
+		return () => h("box", {
+			style: { flexDirection: "column" },
+			"aria-label": `QR code for ${props.value}`
+		}, rows.value.map((row, index) => h("text", {
+			key: index,
+			text: row,
+			fg: props.fg,
+			bg: props.bg
+		})));
+	}
+});
+//#endregion
+export { QrCode, defineQrCodeProvider };
+
+//# sourceMappingURL=index.mjs.map

package/dist/qr-code/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/qr-code/index.ts"],"sourcesContent":["/** Optional, provider-driven QR code entry point. */\n\nimport { computed, defineComponent, h, type PropType } from \"vue\";\n\nexport type QrCodeErrorCorrection = \"low\" | \"medium\" | \"quartile\" | \"high\";\nexport type QrCodeMatrix = readonly (readonly boolean[])[];\n\nexport interface QrCodeProviderOptions {\n  errorCorrection: QrCodeErrorCorrection;\n}\n\nexport type QrCodeProvider = (\n  value: string,\n  options: Readonly<QrCodeProviderOptions>,\n) => QrCodeMatrix;\n\nexport interface QrCodeProps {\n  value: string;\n  provider: QrCodeProvider;\n  errorCorrection?: QrCodeErrorCorrection;\n  quietZone?: number;\n  cellWidth?: number;\n  dark?: string;\n  light?: string;\n  fg?: string;\n  bg?: string;\n  invert?: boolean;\n}\n\n/** Preserve a provider's exact public type without wrapping its implementation. */\nexport function defineQrCodeProvider(provider: QrCodeProvider): QrCodeProvider {\n  return provider;\n}\n\nfunction normalizedInteger(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.trunc(value));\n}\n\nfunction validateMatrix(matrix: QrCodeMatrix): boolean[][] {\n  if (matrix.length === 0) {\n    throw new Error(\"FRESCO_QR_MATRIX_EMPTY: provider returned an empty matrix\");\n  }\n  const size = matrix.length;\n  return matrix.map((row, rowIndex) => {\n    if (row.length !== size) {\n      throw new Error(\n        `FRESCO_QR_MATRIX_SQUARE: row ${rowIndex} has ${row.length} cells; expected ${size}`,\n      );\n    }\n    return row.map((cell, columnIndex) => {\n      if (typeof cell !== \"boolean\") {\n        throw new Error(\n          `FRESCO_QR_MATRIX_CELL: row ${rowIndex}, column ${columnIndex} is not boolean`,\n        );\n      }\n      return cell;\n    });\n  });\n}\n\n/** Render a provider matrix without bundling a QR encoder in Fresco. */\nexport const QrCode = defineComponent({\n  name: \"QrCode\",\n  props: {\n    value: { type: String, required: true },\n    provider: { type: Function as PropType<QrCodeProvider>, required: true },\n    errorCorrection: {\n      type: String as PropType<QrCodeErrorCorrection>,\n      default: \"medium\",\n    },\n    quietZone: { type: Number, default: 2 },\n    cellWidth: { type: Number, default: 2 },\n    dark: { type: String, default: \"█\" },\n    light: { type: String, default: \" \" },\n    fg: String,\n    bg: String,\n    invert: Boolean,\n  },\n  setup(props) {\n    const matrix = computed(() =>\n      validateMatrix(\n        props.provider(props.value, {\n          errorCorrection: props.errorCorrection,\n        }),\n      ),\n    );\n    const rows = computed(() => {\n      const quietZone = normalizedInteger(props.quietZone, 2);\n      const cellWidth = Math.max(1, normalizedInteger(props.cellWidth, 2));\n      const dark = (props.invert ? props.light : props.dark).repeat(cellWidth);\n      const light = (props.invert ? props.dark : props.light).repeat(cellWidth);\n      const quietRow = light.repeat(matrix.value.length + quietZone * 2);\n      const horizontalPadding = light.repeat(quietZone);\n      return [\n        ...Array<string>(quietZone).fill(quietRow),\n        ...matrix.value.map(\n          (row) =>\n            `${horizontalPadding}${row.map((cell) => (cell ? dark : light)).join(\"\")}${horizontalPadding}`,\n        ),\n        ...Array<string>(quietZone).fill(quietRow),\n      ];\n    });\n\n    return () =>\n      h(\n        \"box\",\n        {\n          style: { flexDirection: \"column\" },\n          \"aria-label\": `QR code for ${props.value}`,\n        },\n        rows.value.map((row, index) =>\n          h(\"text\", { key: index, text: row, fg: props.fg, bg: props.bg }),\n        ),\n      );\n  },\n});\n"],"mappings":";;;;AA8BA,SAAgB,qBAAqB,UAA0C;CAC7E,OAAO;AACT;AAEA,SAAS,kBAAkB,OAAe,UAA0B;CAClE,IAAI,CAAC,OAAO,SAAS,KAAK,GAAG,OAAO;CACpC,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC;AACtC;AAEA,SAAS,eAAe,QAAmC;CACzD,IAAI,OAAO,WAAW,GACpB,MAAM,IAAI,MAAM,2DAA2D;CAE7E,MAAM,OAAO,OAAO;CACpB,OAAO,OAAO,KAAK,KAAK,aAAa;EACnC,IAAI,IAAI,WAAW,MACjB,MAAM,IAAI,MACR,gCAAgC,SAAS,OAAO,IAAI,OAAO,mBAAmB,MAChF;EAEF,OAAO,IAAI,KAAK,MAAM,gBAAgB;GACpC,IAAI,OAAO,SAAS,WAClB,MAAM,IAAI,MACR,8BAA8B,SAAS,WAAW,YAAY,gBAChE;GAEF,OAAO;EACT,CAAC;CACH,CAAC;AACH;;AAGA,MAAa,SAAS,gBAAgB;CACpC,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,UAAU;EAAK;EACtC,UAAU;GAAE,MAAM;GAAsC,UAAU;EAAK;EACvE,iBAAiB;GACf,MAAM;GACN,SAAS;EACX;EACA,WAAW;GAAE,MAAM;GAAQ,SAAS;EAAE;EACtC,WAAW;GAAE,MAAM;GAAQ,SAAS;EAAE;EACtC,MAAM;GAAE,MAAM;GAAQ,SAAS;EAAI;EACnC,OAAO;GAAE,MAAM;GAAQ,SAAS;EAAI;EACpC,IAAI;EACJ,IAAI;EACJ,QAAQ;CACV;CACA,MAAM,OAAO;EACX,MAAM,SAAS,eACb,eACE,MAAM,SAAS,MAAM,OAAO,EAC1B,iBAAiB,MAAM,gBACzB,CAAC,CACH,CACF;EACA,MAAM,OAAO,eAAe;GAC1B,MAAM,YAAY,kBAAkB,MAAM,WAAW,CAAC;GACtD,MAAM,YAAY,KAAK,IAAI,GAAG,kBAAkB,MAAM,WAAW,CAAC,CAAC;GACnE,MAAM,QAAQ,MAAM,SAAS,MAAM,QAAQ,MAAM,MAAM,OAAO,SAAS;GACvE,MAAM,SAAS,MAAM,SAAS,MAAM,OAAO,MAAM,OAAO,OAAO,SAAS;GACxE,MAAM,WAAW,MAAM,OAAO,OAAO,MAAM,SAAS,YAAY,CAAC;GACjE,MAAM,oBAAoB,MAAM,OAAO,SAAS;GAChD,OAAO;IACL,GAAG,MAAc,SAAS,EAAE,KAAK,QAAQ;IACzC,GAAG,OAAO,MAAM,KACb,QACC,GAAG,oBAAoB,IAAI,KAAK,SAAU,OAAO,OAAO,KAAM,EAAE,KAAK,EAAE,IAAI,mBAC/E;IACA,GAAG,MAAc,SAAS,EAAE,KAAK,QAAQ;GAC3C;EACF,CAAC;EAED,aACE,EACE,OACA;GACE,OAAO,EAAE,eAAe,SAAS;GACjC,cAAc,eAAe,MAAM;EACrC,GACA,KAAK,MAAM,KAAK,KAAK,UACnB,EAAE,QAAQ;GAAE,KAAK;GAAO,MAAM;GAAK,IAAI,MAAM;GAAI,IAAI,MAAM;EAAG,CAAC,CACjE,CACF;CACJ;AACF,CAAC"}

package/dist/testing/index.d.mts

@@ -1,6 +1,6 @@
-import { A as KeyEvent, M as MouseEvent, x as FrescoRenderNode } from "../protocol-D8xt3DG7.mjs";
-import { i as FrescoElement, n as AriaState, o as FrescoNode, s as FrescoNodeLifecycleHooks, t as AriaRole, u as createRenderer$1 } from "../accessibility-OEhyYUxd.mjs";
-import { r as FocusManager, t as UseAppReturn } from "../useApp-CVB2jNCO.mjs";
+import { N as MouseEvent, S as FrescoRenderNode, j as KeyEvent } from "../protocol-DavoeNLn.mjs";
+import { i as FrescoElement, l as FrescoNode, m as createRenderer$1, n as AriaState, t as AriaRole, u as FrescoNodeLifecycleHooks } from "../accessibility-DwzT925M.mjs";
+import { r as FocusManager, t as UseAppReturn } from "../useApp-vIRJ5Th3.mjs";
 import { App, Component, Ref, VNodeChild } from "vue";
 
 //#region src/testing/mount.d.ts

package/dist/testing/index.mjs

@@ -1,4 +1,4 @@
-import { A as APP_KEY, D as createFocusManager, E as FOCUS_KEY, N as SCREEN_READER_KEY, _ as CURSOR_KEY, a as lastMouseEvent, b as STREAMS_KEY, d as isStaticNode, f as createRenderer$1, i as lastKeyEvent, j as createAppContext, n as lastCompositionEvent, o as lastPasteEvent, p as treeToRenderNodes, r as lastFocusEvent, s as lastResizeEvent, u as isStaticItemNode, v as createCursorContext, x as createStreamsContext } from "../app-CIX6NAW-.mjs";
+import { D as createFocusManager, E as FOCUS_KEY, M as createAppContext, P as SCREEN_READER_KEY, _ as CURSOR_KEY, a as lastMouseEvent, b as STREAMS_KEY, d as isStaticNode, f as createRenderer$1, i as lastKeyEvent, j as APP_KEY, n as lastCompositionEvent, o as lastPasteEvent, p as treeToRenderNodes, r as lastFocusEvent, s as lastResizeEvent, u as isStaticItemNode, v as createCursorContext, x as createStreamsContext } from "../app-C_wFlWSV.mjs";
 import { h, nextTick, ref } from "vue";
 //#region src/testing/mount.ts
 /**

package/dist/{useApp-CVB2jNCO.d.mts → useApp-vIRJ5Th3.d.mts}

@@ -1,4 +1,4 @@
-import { Ref } from "vue";
+import { InjectionKey, Ref } from "vue";
 
 //#region src/composables/useFocus.d.ts
 interface UseFocusOptions {
@@ -10,6 +10,21 @@ interface UseFocusOptions {
   id?: string;
   /** Parent focus ID used to derive descendant-focus state */
   parentId?: string | null | Ref<string | null | undefined>;
+  /** Descendant that receives focus when this target is focused */
+  delegateFocusTo?: string | null | Ref<string | null | undefined>;
+  /** Keep programmatic and sequential focus inside this target subtree */
+  trapFocus?: boolean | Ref<boolean>;
+}
+/** Registration state retained for one focusable target. */
+interface FocusRegistrationOptions {
+  /** Whether the target participates in focus traversal. @default true */
+  isActive?: boolean;
+  /** Focus the target when no target currently owns focus. @default false */
+  autoFocus?: boolean;
+  /** Registered parent used for descendant and trap boundaries. @default null */
+  parentId?: string | null | undefined;
+  /** Registered descendant that receives delegated focus. @default null */
+  delegateFocusTo?: string | null | undefined;
 }
 interface FocusManager {
   /** Currently focused element ID */
@@ -18,6 +33,8 @@ interface FocusManager {
   activeId: Readonly<Ref<string | undefined>>;
   /** All active focusable element IDs */
   focusableIds: Readonly<Ref<string[]>>;
+  /** Innermost active focus-trap root, when present */
+  activeTrapId: Readonly<Ref<string | undefined>>;
   /** Whether focus management is enabled */
   isEnabled: Ref<boolean>;
   /** Enable focus management */
@@ -31,20 +48,24 @@ interface FocusManager {
   /** Focus previous element */
   focusPrevious: () => void;
   /** Register a focusable element */
-  register: (id: string, options?: {
-    isActive?: boolean;
-    autoFocus?: boolean;
-    parentId?: string | null | undefined;
-  }) => void;
+  register: (id: string, options?: FocusRegistrationOptions) => void;
   /** Unregister a focusable element */
   unregister: (id: string) => void;
   /** Activate or deactivate a focusable element while keeping its order */
   setActive: (id: string, isActive: boolean) => void;
   /** Reparent a focusable element while keeping its registration order */
   setParent: (id: string, parentId: string | null | undefined) => void;
+  /** Change the descendant that receives delegated focus */
+  setDelegate: (id: string, delegateFocusTo: string | null | undefined) => void;
+  /** Activate a nested focus boundary rooted at a registered target */
+  trapFocus: (id: string) => void;
+  /** Release a focus boundary and every nested boundary that depends on it */
+  releaseFocusTrap: (id: string) => void;
   /** Whether a registered descendant of the target currently owns focus */
   hasFocusedDescendant: (id: string) => boolean;
 }
+/** Make an owning focus target the default parent for nested useFocus calls. */
+declare function provideFocusScope(parentId: string | null | Ref<string | null | undefined>): void;
 /**
  * Use focus management
  */
@@ -52,6 +73,7 @@ declare function useFocus(options?: UseFocusOptions): {
   id: string;
   isFocused: import("vue").ComputedRef<boolean>;
   hasFocusedDescendant: import("vue").ComputedRef<boolean>;
+  isFocusTrapActive: import("vue").ComputedRef<boolean>;
   focus: (targetId?: string) => void;
   blur: () => void;
 };
@@ -65,8 +87,12 @@ declare function useFocusManager(): {
   focusPrevious: () => void;
   focus: (id: string) => void;
   hasFocusedDescendant: (id: string) => boolean;
+  trapFocus: (id: string) => void;
+  releaseFocusTrap: (id: string) => void;
+  setDelegate: (id: string, delegateFocusTo: string | null | undefined) => void;
   activeId: Readonly<Ref<string | undefined, string | undefined>>;
   focusableIds: Readonly<Ref<string[], string[]>>;
+  activeTrapId: Readonly<Ref<string | undefined, string | undefined>>;
 };
 //#endregion
 //#region src/composables/useApp.d.ts
@@ -91,5 +117,5 @@ interface UseAppReturn {
  */
 declare function useApp(): UseAppReturn;
 //#endregion
-export { useFocus as a, UseFocusOptions as i, useApp as n, useFocusManager as o, FocusManager as r, UseAppReturn as t };
-//# sourceMappingURL=useApp-CVB2jNCO.d.mts.map
+export { provideFocusScope as a, UseFocusOptions as i, useApp as n, useFocus as o, FocusManager as r, useFocusManager as s, UseAppReturn as t };
+//# sourceMappingURL=useApp-vIRJ5Th3.d.mts.map

package/dist/useApp-vIRJ5Th3.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApp-vIRJ5Th3.d.mts","names":[],"sources":["../src/composables/useFocus.ts","../src/composables/useApp.ts"],"mappings":";;;UAoBiB,eAAA;EAEM;EAArB,QAAA,aAAqB,GAAA;EAQa;EANlC,SAAA;EAQyB;EANzB,EAAA;EAJA;EAMA,QAAA,mBAA2B,GAAA;EAJ3B;EAMA,eAAA,mBAAkC,GAAA;EAFlC;EAIA,SAAA,aAAsB,GAAA;AAAA;;UAIP,wBAAA;EAJO;EAMtB,QAAA;EANyB;EAQzB,SAAA;EAJuC;EAMvC,QAAA;EANuC;EAQvC,eAAA;AAAA;AAAA,UAGe,YAAA;EAHf;EAKA,SAAA,EAAW,GAAA;EALI;EAOf,QAAA,EAAU,QAAA,CAAS,GAAA;EAJQ;EAM3B,YAAA,EAAc,QAAA,CAAS,GAAA;EAJZ;EAMX,YAAA,EAAc,QAAA,CAAS,GAAA;EAJb;EAMV,SAAA,EAAW,GAAA;EAJG;EAMd,WAAA;EAJc;EAMd,YAAA;EAQiC;EANjC,KAAA,GAAQ,EAAA;EAMiD;EAJzD,SAAA;EAhBW;EAkBX,aAAA;EAhBU;EAkBV,QAAA,GAAW,EAAA,UAAY,OAAA,GAAU,wBAAA;EAhBjC;EAkBA,UAAA,GAAa,EAAA;EAlBU;EAoBvB,SAAA,GAAY,EAAA,UAAY,QAAA;EAlBV;EAoBd,SAAA,GAAY,EAAA,UAAY,QAAA;EAlBxB;EAoBA,WAAA,GAAc,EAAA,UAAY,eAAA;EAlB1B;EAoBA,SAAA,GAAY,EAAA;EAhBZ;EAkBA,gBAAA,GAAmB,EAAA;EAhBnB;EAkBA,oBAAA,GAAuB,EAAA;AAAA;;iBAiPT,iBAAA,CAAkB,QAAwD,kBAA9B,GAAG;;;;iBAO/C,QAAA,CAAS,OAAA,GAAS,eAAoB;;;;;;;;AAxPnB;AAiPnC;;AAjPmC,iBAmWnB,eAAA;;;;;;;;;4BAzWU,eAAA;;;;;;;UCrET,YAAA;EDcM;ECZrB,KAAA,EAAO,GAAA;EDoB2B;EClBlC,MAAA,EAAQ,GAAA;EDoBiB;EClBzB,SAAA,EAAW,GAAA;EDQX;ECNA,IAAA,GAAO,aAAA;EDQP;ECNA,MAAA;EDUA;ECRA,KAAA;EDUA;ECRA,oBAAA,QAA4B,OAAA;AAAA;;;;iBAwEd,MAAA,IAAU,YAAY"}

package/dist/{useVirtualViewport-pPZWmwUC.mjs → useBoxMetrics-lF5Myjc7.mjs}

@@ -1,5 +1,5 @@
-import { N as SCREEN_READER_KEY, P as isScreenReaderEnabledByDefault, T as useStreamsContext, a as lastMouseEvent, i as lastKeyEvent, n as lastCompositionEvent, o as lastPasteEvent } from "./app-CIX6NAW-.mjs";
-import { computed, inject, isRef, onUnmounted, ref, watch } from "vue";
+import { F as isScreenReaderEnabledByDefault, P as SCREEN_READER_KEY, T as useStreamsContext, a as lastMouseEvent, g as updateLastRenderLayouts, i as lastKeyEvent, m as getLastRenderLayout, n as lastCompositionEvent, o as lastPasteEvent } from "./app-C_wFlWSV.mjs";
+import { computed, inject, isRef, onMounted, onUnmounted, reactive, ref, watch } from "vue";
 //#region src/composables/useIsScreenReaderEnabled.ts
 /**
 * useIsScreenReaderEnabled - screen reader mode flag.
@@ -138,7 +138,7 @@ function handleStructuredOptions(event, options, lastKey) {
 	const inkKey = toInkKey(event);
 	if (event.char) {
 		lastKey.value = event.char;
-		options.onChar?.(event.char);
+		if (!event.ctrl && !event.alt && !event.meta) options.onChar?.(event.char);
 		options.onKey?.(event.char, modifiers);
 		return;
 	}
@@ -172,7 +172,7 @@ function useInput(handlerOrOptions = {}, handlerOptions = {}) {
 		const inkKey = toInkKey(event);
 		const input = inputValue(event, inkKey);
 		const pressedKey = keyName(event);
-		if (input === "c" && inkKey.ctrl && streams.internal_exitOnCtrlC) return;
+		if (input === "c" && inkKey.ctrl && streams.internal_exitOnCtrlC && !options.captureCtrlC) return;
 		lastKey.value = pressedKey || null;
 		options.handler?.(input, inkKey);
 		handleStructuredOptions(event, options, lastKey);
@@ -323,6 +323,66 @@ function createVirtualViewport(options) {
 /** Composition API alias for {@link createVirtualViewport}. */
 const useVirtualViewport = createVirtualViewport;
 //#endregion
-export { useKeyPress as a, useInput as i, useVirtualViewport as n, usePaste as o, useMouse as r, useIsScreenReaderEnabled as s, createVirtualViewport as t };
+//#region src/composables/useBoxMetrics.ts
+/**
+* useBoxMetrics - best-effort layout metrics for a rendered Fresco node.
+*/
+async function loadNative() {
+	return import("@vizejs/fresco-native");
+}
+function targetId(target) {
+	return target?.id ?? target?.$el?.id;
+}
+function useBoxMetrics(ref) {
+	const metrics = reactive({
+		width: 0,
+		height: 0,
+		left: 0,
+		top: 0,
+		hasMeasured: false
+	});
+	let timer = null;
+	const applyLayout = (layout) => {
+		metrics.width = layout.width;
+		metrics.height = layout.height;
+		metrics.left = layout.x;
+		metrics.top = layout.y;
+		metrics.hasMeasured = true;
+	};
+	const refresh = () => {
+		const id = targetId(ref.value);
+		if (id === void 0) {
+			metrics.width = 0;
+			metrics.height = 0;
+			metrics.left = 0;
+			metrics.top = 0;
+			metrics.hasMeasured = false;
+			return;
+		}
+		const cachedLayout = getLastRenderLayout(ref.value);
+		if (cachedLayout) {
+			applyLayout(cachedLayout);
+			return;
+		}
+		loadNative().then((native) => {
+			const layouts = "getLastRenderLayouts" in native ? native.getLastRenderLayouts() : [];
+			updateLastRenderLayouts(layouts);
+			const layout = layouts.find((item) => item.id === id);
+			if (!layout) return;
+			applyLayout(layout);
+		}).catch(() => {});
+	};
+	metrics.refresh = refresh;
+	onMounted(() => {
+		refresh();
+		timer = setInterval(refresh, 100);
+	});
+	onUnmounted(() => {
+		if (timer) clearInterval(timer);
+	});
+	return metrics;
+}
+//#endregion
+export { useInput as a, useIsScreenReaderEnabled as c, useMouse as i, createVirtualViewport as n, useKeyPress as o, useVirtualViewport as r, usePaste as s, useBoxMetrics as t };
 
-//# sourceMappingURL=useVirtualViewport-pPZWmwUC.mjs.map
+//# sourceMappingURL=useBoxMetrics-lF5Myjc7.mjs.map

package/dist/useBoxMetrics-lF5Myjc7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoxMetrics-lF5Myjc7.mjs","names":["toRef"],"sources":["../src/composables/useIsScreenReaderEnabled.ts","../src/composables/usePaste.ts","../src/composables/useInput.ts","../src/composables/useMouse.ts","../src/composables/useVirtualViewport.ts","../src/composables/useBoxMetrics.ts"],"sourcesContent":["/**\n * useIsScreenReaderEnabled - screen reader mode flag.\n */\n\nimport { inject } from \"vue\";\nimport { SCREEN_READER_KEY, isScreenReaderEnabledByDefault } from \"../accessibility.js\";\n\nexport function useIsScreenReaderEnabled(): boolean {\n  const enabled = inject(SCREEN_READER_KEY, null);\n  return enabled?.value ?? isScreenReaderEnabledByDefault();\n}\n","/**\n * usePaste - bracketed paste handling.\n */\n\nimport { isRef, onUnmounted, ref, watch, type Ref } from \"vue\";\nimport { lastPasteEvent } from \"../app.js\";\nimport { useStreamsContext } from \"./useStreams.js\";\n\nlet activePasteHandlerCount = 0;\n\nexport interface UsePasteOptions {\n  /** Whether the paste handler is active */\n  isActive?: boolean | Ref<boolean>;\n}\n\nexport function hasActivePasteHandlers(): boolean {\n  return activePasteHandlerCount > 0;\n}\n\nfunction toRef(value: boolean | Ref<boolean>): Ref<boolean> {\n  return isRef(value) ? value : ref(value);\n}\n\nexport function usePaste(handler: (text: string) => void, options: UsePasteOptions = {}) {\n  const isActive = toRef(options.isActive ?? true);\n  const streams = useStreamsContext();\n  let rawModeEnabled = false;\n  let bracketedPasteEnabled = false;\n  let pasteHandlerRegistered = false;\n\n  const syncRawMode = (isEnabled: boolean) => {\n    if (rawModeEnabled === isEnabled) return;\n    streams.setRawMode(isEnabled);\n    rawModeEnabled = isEnabled;\n  };\n\n  const syncBracketedPasteMode = (isEnabled: boolean) => {\n    if (bracketedPasteEnabled === isEnabled) return;\n    streams.setBracketedPasteMode(isEnabled);\n    bracketedPasteEnabled = isEnabled;\n  };\n\n  const syncPasteRegistration = (isEnabled: boolean) => {\n    if (pasteHandlerRegistered === isEnabled) return;\n    activePasteHandlerCount += isEnabled ? 1 : -1;\n    pasteHandlerRegistered = isEnabled;\n  };\n\n  const syncActiveState = (isEnabled: boolean) => {\n    syncRawMode(isEnabled);\n    syncBracketedPasteMode(isEnabled);\n    syncPasteRegistration(isEnabled);\n  };\n\n  watch(lastPasteEvent, (event) => {\n    if (!event || !isActive.value) return;\n    handler(event.text);\n  });\n\n  watch(isActive, syncActiveState, { immediate: true });\n  onUnmounted(() => syncActiveState(false));\n\n  return {\n    isActive,\n    enable: () => {\n      isActive.value = true;\n    },\n    disable: () => {\n      isActive.value = false;\n    },\n  };\n}\n","/**\n * useInput - Input handling composable\n */\n\nimport { isRef, onUnmounted, ref, watch, type Ref } from \"vue\";\nimport { lastCompositionEvent, lastKeyEvent, lastPasteEvent, type KeyEvent } from \"../app.js\";\nimport { hasActivePasteHandlers } from \"./usePaste.js\";\nimport { useStreamsContext } from \"./useStreams.js\";\n\nexport interface Key {\n  upArrow: boolean;\n  downArrow: boolean;\n  leftArrow: boolean;\n  rightArrow: boolean;\n  pageDown: boolean;\n  pageUp: boolean;\n  home: boolean;\n  end: boolean;\n  return: boolean;\n  escape: boolean;\n  ctrl: boolean;\n  shift: boolean;\n  tab: boolean;\n  backspace: boolean;\n  delete: boolean;\n  meta: boolean;\n  super: boolean;\n  hyper: boolean;\n  capsLock: boolean;\n  numLock: boolean;\n  eventType?: \"press\" | \"repeat\" | \"release\";\n}\n\nexport interface KeyHandler {\n  (key: string, modifiers: { ctrl: boolean; alt: boolean; shift: boolean; meta: boolean }): void;\n}\n\nexport interface UseInputOptions {\n  /** Whether to capture input (boolean or Ref<boolean>) */\n  active?: boolean | Ref<boolean>;\n  /** Whether to capture input (alias for active, boolean or Ref<boolean>) */\n  isActive?: boolean | Ref<boolean>;\n  /** Ink-compatible input callback */\n  handler?: (input: string, key: Key) => void;\n  /** Called on key press */\n  onKey?: KeyHandler;\n  /** Called on character input */\n  onChar?: (char: string) => void;\n  /** Called on Enter */\n  onSubmit?: () => void;\n  /** Called on Escape */\n  onEscape?: () => void;\n  /** Called on arrow keys */\n  onArrow?: (direction: \"up\" | \"down\" | \"left\" | \"right\") => void;\n  /** Called when an IME composition starts */\n  onCompositionStart?: () => void;\n  /** Called when IME preedit text changes */\n  onCompositionUpdate?: (text: string, cursor: number) => void;\n  /** Called when IME commits text */\n  onCompositionEnd?: (text: string) => void;\n  /** Deliver Ctrl+C to this handler instead of reserving it for app exit. */\n  captureCtrlC?: boolean;\n}\n\nexport interface UseInputReturn {\n  isActive: Ref<boolean>;\n  lastKey: Ref<string | null>;\n  enable: () => void;\n  disable: () => void;\n}\n\nexport type InputHandler = (input: string, key: Key) => void;\n\nexport interface UseInputHandlerOptions {\n  isActive?: boolean | Ref<boolean>;\n}\n\nfunction toRef(value: boolean | Ref<boolean>): Ref<boolean> {\n  return isRef(value) ? value : ref(value);\n}\n\nfunction keyName(event: KeyEvent): string {\n  return event.char ?? event.key ?? \"\";\n}\n\nfunction toInkKey(event: KeyEvent): Key {\n  const key = event.key;\n\n  return {\n    upArrow: key === \"up\",\n    downArrow: key === \"down\",\n    leftArrow: key === \"left\",\n    rightArrow: key === \"right\",\n    pageDown: key === \"pagedown\" || key === \"pageDown\",\n    pageUp: key === \"pageup\" || key === \"pageUp\",\n    home: key === \"home\",\n    end: key === \"end\",\n    return: key === \"enter\" || key === \"return\",\n    escape: key === \"escape\" || key === \"esc\",\n    ctrl: event.ctrl,\n    shift: event.shift,\n    tab: key === \"tab\" || key === \"backtab\",\n    backspace: key === \"backspace\",\n    delete: key === \"delete\",\n    meta: event.meta,\n    super: event.super,\n    hyper: event.hyper,\n    capsLock: event.capsLock,\n    numLock: event.numLock,\n    eventType: event.eventType,\n  };\n}\n\nfunction emptyKey(): Key {\n  return {\n    upArrow: false,\n    downArrow: false,\n    leftArrow: false,\n    rightArrow: false,\n    pageDown: false,\n    pageUp: false,\n    home: false,\n    end: false,\n    return: false,\n    escape: false,\n    ctrl: false,\n    shift: false,\n    tab: false,\n    backspace: false,\n    delete: false,\n    meta: false,\n    super: false,\n    hyper: false,\n    capsLock: false,\n    numLock: false,\n  };\n}\n\nfunction inputValue(event: KeyEvent, key: Key): string {\n  if (event.char) return event.char;\n  if (key.return) return \"\\r\";\n  return \"\";\n}\n\nfunction handleStructuredOptions(\n  event: KeyEvent,\n  options: UseInputOptions,\n  lastKey: Ref<string | null>,\n) {\n  const modifiers = {\n    ctrl: event.ctrl,\n    alt: event.alt,\n    shift: event.shift,\n    meta: event.meta,\n  };\n  const pressedKey = keyName(event);\n  const inkKey = toInkKey(event);\n\n  if (event.char) {\n    lastKey.value = event.char;\n    // Modified character chords represent commands, not text insertion. AltGr\n    // terminals report their committed text without these command modifiers.\n    if (!event.ctrl && !event.alt && !event.meta) options.onChar?.(event.char);\n    options.onKey?.(event.char, modifiers);\n    return;\n  }\n\n  if (pressedKey) {\n    lastKey.value = pressedKey;\n    options.onKey?.(pressedKey, modifiers);\n  }\n\n  if (inkKey.return) options.onSubmit?.();\n  if (inkKey.escape) options.onEscape?.();\n  if (inkKey.upArrow) options.onArrow?.(\"up\");\n  if (inkKey.downArrow) options.onArrow?.(\"down\");\n  if (inkKey.leftArrow) options.onArrow?.(\"left\");\n  if (inkKey.rightArrow) options.onArrow?.(\"right\");\n}\n\nexport function useInput(handler: InputHandler, options?: UseInputHandlerOptions): UseInputReturn;\nexport function useInput(options?: UseInputOptions): UseInputReturn;\nexport function useInput(\n  handlerOrOptions: InputHandler | UseInputOptions = {},\n  handlerOptions: UseInputHandlerOptions = {},\n): UseInputReturn {\n  const options =\n    typeof handlerOrOptions === \"function\"\n      ? { handler: handlerOrOptions, isActive: handlerOptions.isActive }\n      : handlerOrOptions;\n\n  const activeSource = options.isActive ?? options.active ?? true;\n  const isActive = toRef(activeSource);\n  const lastKey = ref<string | null>(null);\n  const streams = useStreamsContext();\n  let rawModeEnabled = false;\n\n  const syncRawMode = (isEnabled: boolean) => {\n    if (rawModeEnabled === isEnabled) return;\n    streams.setRawMode(isEnabled);\n    rawModeEnabled = isEnabled;\n  };\n\n  watch(lastKeyEvent, (event) => {\n    if (!event || !isActive.value) return;\n\n    const inkKey = toInkKey(event);\n    const input = inputValue(event, inkKey);\n    const pressedKey = keyName(event);\n\n    if (input === \"c\" && inkKey.ctrl && streams.internal_exitOnCtrlC && !options.captureCtrlC)\n      return;\n\n    lastKey.value = pressedKey || null;\n    options.handler?.(input, inkKey);\n    handleStructuredOptions(event, options, lastKey);\n  });\n\n  watch(lastPasteEvent, (event) => {\n    if (!event || !isActive.value || hasActivePasteHandlers()) return;\n\n    lastKey.value = event.text;\n    options.handler?.(event.text, emptyKey());\n    options.onChar?.(event.text);\n  });\n\n  watch(lastCompositionEvent, (event) => {\n    if (!event || !isActive.value) return;\n\n    if (event.type === \"compositionstart\") {\n      options.onCompositionStart?.();\n    } else if (event.type === \"compositionupdate\") {\n      options.onCompositionUpdate?.(event.text, event.cursor);\n    } else {\n      options.onCompositionEnd?.(event.text);\n    }\n  });\n\n  watch(isActive, syncRawMode, { immediate: true });\n  onUnmounted(() => syncRawMode(false));\n\n  const enable = () => {\n    isActive.value = true;\n  };\n\n  const disable = () => {\n    isActive.value = false;\n  };\n\n  return {\n    isActive,\n    lastKey,\n    enable,\n    disable,\n  };\n}\n\n/**\n * Shorthand for handling specific key combinations\n */\nexport function useKeyPress(\n  key: string,\n  handler: () => void,\n  options: { ctrl?: boolean; alt?: boolean; shift?: boolean; meta?: boolean } = {},\n) {\n  const { ctrl = false, alt = false, shift = false, meta = false } = options;\n\n  useInput({\n    onKey: (pressedKey, modifiers) => {\n      const matches =\n        pressedKey.toLowerCase() === key.toLowerCase() &&\n        modifiers.ctrl === ctrl &&\n        modifiers.alt === alt &&\n        modifiers.shift === shift &&\n        modifiers.meta === meta;\n\n      if (matches) {\n        handler();\n      }\n    },\n  });\n}\n","/** Mouse and wheel input handling for focused Fresco surfaces. */\n\nimport { computed, isRef, ref, watch, type Ref } from \"vue\";\nimport { lastMouseEvent } from \"../app.js\";\nimport type { MouseEvent } from \"../protocol.js\";\n\nexport interface UseMouseOptions {\n  /** Whether the handler receives events. */\n  isActive?: boolean | Readonly<Ref<boolean>>;\n}\n\nexport interface UseMouseReturn {\n  isActive: Readonly<Ref<boolean>>;\n  /** Start delivering normalized mouse events. */\n  enable: () => void;\n  /** Stop delivering normalized mouse events. */\n  disable: () => void;\n  /** Unsubscribe the handler from the shared mouse event stream. */\n  stop: () => void;\n}\n\n/** Subscribe to normalized mouse actions, including wheel direction. */\nexport function useMouse(\n  handler: (event: MouseEvent) => void,\n  options: UseMouseOptions = {},\n): UseMouseReturn {\n  const externalIsActive = isRef(options.isActive) ? options.isActive : undefined;\n  const locallyEnabled = ref(externalIsActive ? true : (options.isActive ?? true));\n  const isActive = computed(() => locallyEnabled.value && (externalIsActive?.value ?? true));\n\n  const stop = watch(\n    lastMouseEvent,\n    (event) => {\n      if (event && isActive.value) handler(event);\n    },\n    { flush: \"sync\" },\n  );\n\n  return {\n    isActive,\n    enable: () => {\n      locallyEnabled.value = true;\n    },\n    disable: () => {\n      locallyEnabled.value = false;\n    },\n    stop,\n  };\n}\n","/** Bounded viewport state for large terminal collections. */\n\nimport { computed, ref, type ComputedRef, type Ref } from \"vue\";\n\nexport type VirtualScrollAlignment = \"nearest\" | \"start\" | \"center\" | \"end\";\n\nexport interface VirtualViewportRange {\n  /** First item occupying the viewport. */\n  visibleStart: number;\n  /** Exclusive end of items occupying the viewport. */\n  visibleEnd: number;\n  /** First retained item, including leading overscan. */\n  overscanStart: number;\n  /** Exclusive end of retained items, including trailing overscan. */\n  overscanEnd: number;\n}\n\nexport interface VirtualViewportOptions {\n  itemCount: number;\n  viewportSize: number;\n  overscan?: number;\n  initialOffset?: number;\n}\n\nexport interface VirtualViewport {\n  readonly itemCount: Readonly<Ref<number>>;\n  readonly viewportSize: Readonly<Ref<number>>;\n  readonly overscan: Readonly<Ref<number>>;\n  readonly offset: Readonly<Ref<number>>;\n  readonly maxOffset: ComputedRef<number>;\n  readonly atStart: ComputedRef<boolean>;\n  readonly atEnd: ComputedRef<boolean>;\n  readonly range: ComputedRef<VirtualViewportRange>;\n  /** Replace the collection size and clamp the current offset. */\n  setItemCount(value: number): boolean;\n  /** Replace the visible row count and clamp the current offset. */\n  setViewportSize(value: number): boolean;\n  /** Replace the number of retained rows on each side of the viewport. */\n  setOverscan(value: number): boolean;\n  /** Move to an absolute, bounded offset. */\n  scrollTo(offset: number): boolean;\n  /** Move by a signed row delta. */\n  scrollBy(delta: number): boolean;\n  /** Reveal one item using the requested viewport alignment. */\n  scrollIntoView(index: number, alignment?: VirtualScrollAlignment): boolean;\n}\n\nfunction count(value: number, name: string): number {\n  if (!Number.isSafeInteger(value) || value < 0) {\n    throw new RangeError(`${name} must be a non-negative safe integer`);\n  }\n  return value;\n}\n\n/** Create viewport state whose retained range scales with visible rows, not item count. */\nexport function createVirtualViewport(options: VirtualViewportOptions): VirtualViewport {\n  const itemCount = ref(count(options.itemCount, \"itemCount\"));\n  const viewportSize = ref(count(options.viewportSize, \"viewportSize\"));\n  const overscan = ref(count(options.overscan ?? 2, \"overscan\"));\n  const offset = ref(0);\n  const maxOffset = computed(() => Math.max(0, itemCount.value - viewportSize.value));\n  const atStart = computed(() => offset.value === 0);\n  const atEnd = computed(() => offset.value === maxOffset.value);\n  const range = computed<VirtualViewportRange>(() => {\n    const visibleStart = Math.min(offset.value, itemCount.value);\n    const visibleEnd = Math.min(itemCount.value, visibleStart + viewportSize.value);\n    return {\n      visibleStart,\n      visibleEnd,\n      overscanStart: Math.max(0, visibleStart - overscan.value),\n      overscanEnd: Math.min(itemCount.value, visibleEnd + overscan.value),\n    };\n  });\n\n  const scrollTo = (value: number) => {\n    const next = Math.min(maxOffset.value, count(value, \"offset\"));\n    if (next === offset.value) return false;\n    offset.value = next;\n    return true;\n  };\n  const clamp = () => scrollTo(Math.min(offset.value, maxOffset.value));\n\n  const setItemCount = (value: number) => {\n    const next = count(value, \"itemCount\");\n    if (next === itemCount.value) return false;\n    itemCount.value = next;\n    clamp();\n    return true;\n  };\n  const setViewportSize = (value: number) => {\n    const next = count(value, \"viewportSize\");\n    if (next === viewportSize.value) return false;\n    viewportSize.value = next;\n    clamp();\n    return true;\n  };\n  const setOverscan = (value: number) => {\n    const next = count(value, \"overscan\");\n    if (next === overscan.value) return false;\n    overscan.value = next;\n    return true;\n  };\n  const scrollBy = (delta: number) => {\n    if (!Number.isSafeInteger(delta)) throw new RangeError(\"delta must be a safe integer\");\n    return scrollTo(Math.max(0, offset.value + delta));\n  };\n  const scrollIntoView = (index: number, alignment: VirtualScrollAlignment = \"nearest\") => {\n    count(index, \"index\");\n    if (index >= itemCount.value || viewportSize.value === 0) return false;\n    let next = offset.value;\n    if (alignment === \"start\") next = index;\n    else if (alignment === \"center\") next = Math.max(0, index - Math.floor(viewportSize.value / 2));\n    else if (alignment === \"end\") next = Math.max(0, index + 1 - viewportSize.value);\n    else if (index < offset.value) next = index;\n    else if (index >= offset.value + viewportSize.value) {\n      next = index + 1 - viewportSize.value;\n    }\n    return scrollTo(next);\n  };\n\n  scrollTo(options.initialOffset ?? 0);\n\n  return {\n    itemCount,\n    viewportSize,\n    overscan,\n    offset,\n    maxOffset,\n    atStart,\n    atEnd,\n    range,\n    setItemCount,\n    setViewportSize,\n    setOverscan,\n    scrollTo,\n    scrollBy,\n    scrollIntoView,\n  };\n}\n\n/** Composition API alias for {@link createVirtualViewport}. */\nexport const useVirtualViewport = createVirtualViewport;\n","/**\n * useBoxMetrics - best-effort layout metrics for a rendered Fresco node.\n */\n\nimport { onMounted, onUnmounted, reactive, type Ref } from \"vue\";\nimport { getLastRenderLayout, updateLastRenderLayouts, type DOMElement } from \"../layoutMetrics.js\";\n\nexport interface BoxMetrics {\n  width: number;\n  height: number;\n  left: number;\n  top: number;\n}\n\nexport interface UseBoxMetricsResult extends BoxMetrics {\n  hasMeasured: boolean;\n  /** Refresh from the latest completed native layout snapshot. */\n  refresh(): void;\n}\n\nexport type MetricTarget = DOMElement;\n\nasync function loadNative() {\n  return import(\"@vizejs/fresco-native\");\n}\n\nfunction targetId(target: MetricTarget | null | undefined): number | undefined {\n  return target?.id ?? target?.$el?.id;\n}\n\nexport function useBoxMetrics(ref: Ref<MetricTarget | null>): UseBoxMetricsResult {\n  const metrics = reactive({\n    width: 0,\n    height: 0,\n    left: 0,\n    top: 0,\n    hasMeasured: false,\n  }) as UseBoxMetricsResult;\n\n  let timer: ReturnType<typeof setInterval> | null = null;\n\n  const applyLayout = (layout: { width: number; height: number; x: number; y: number }) => {\n    metrics.width = layout.width;\n    metrics.height = layout.height;\n    metrics.left = layout.x;\n    metrics.top = layout.y;\n    metrics.hasMeasured = true;\n  };\n\n  const refresh = () => {\n    const id = targetId(ref.value);\n    if (id === undefined) {\n      metrics.width = 0;\n      metrics.height = 0;\n      metrics.left = 0;\n      metrics.top = 0;\n      metrics.hasMeasured = false;\n      return;\n    }\n\n    const cachedLayout = getLastRenderLayout(ref.value);\n    if (cachedLayout) {\n      applyLayout(cachedLayout);\n      return;\n    }\n\n    void loadNative()\n      .then((native) => {\n        const layouts = \"getLastRenderLayouts\" in native ? native.getLastRenderLayouts() : [];\n        updateLastRenderLayouts(layouts);\n        const layout = layouts.find((item: { id: number }) => item.id === id);\n        if (!layout) return;\n\n        applyLayout(layout);\n      })\n      .catch(() => {});\n  };\n\n  metrics.refresh = refresh;\n\n  onMounted(() => {\n    refresh();\n    timer = setInterval(refresh, 100);\n  });\n\n  onUnmounted(() => {\n    if (timer) clearInterval(timer);\n  });\n\n  return metrics;\n}\n"],"mappings":"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"}