@vizejs/fresco 0.347.7 → 0.350.2

package/dist/testing/index.d.mts

@@ -0,0 +1,124 @@
+import { M as KeyEvent, P as MouseEvent, n as FrescoNode, t as FrescoElement } from "../renderer-DWG0G3g8.mjs";
+import { r as FocusManager, t as UseAppReturn } from "../useApp-CNjer3hJ.mjs";
+import { App, Component, Ref, VNodeChild } from "@vue/runtime-core";
+
+//#region src/testing/mount.d.ts
+/** Options for {@link mountFresco}. */
+interface MountFrescoOptions {
+  /** Terminal width provided through the app context. Defaults to 80. */
+  width?: number;
+  /** Terminal height provided through the app context. Defaults to 24. */
+  height?: number;
+  /** Initial screen reader mode. Defaults to false. */
+  screenReader?: boolean;
+}
+/** A mounted Fresco component tree under test. */
+interface MountedFresco {
+  /** Root element the Vue app mounted into; children form the output tree. */
+  root: FrescoElement;
+  /** The Vue app instance (for `provide`-level introspection if needed). */
+  app: App<FrescoElement>;
+  /** App context provided to composables such as `useApp` and `useWindowSize`. */
+  appContext: UseAppReturn;
+  /** Focus manager provided to the tree, as the real app would. */
+  focusManager: FocusManager;
+  /** Screen reader flag provided to the tree; writable to flip modes. */
+  screenReaderEnabled: Ref<boolean>;
+  /** Unmount the tree and dispose all component watchers. */
+  unmount(): void;
+}
+/**
+ * Mount a component (or a plain render function) through the Fresco renderer.
+ *
+ * The returned {@link MountedFresco.root} is live: re-read it after reactive
+ * updates plus `await nextTick()` to observe the patched output tree.
+ */
+declare function mountFresco(root: Component | (() => VNodeChild), options?: MountFrescoOptions): MountedFresco;
+/**
+ * Dispatch a key event through the same `lastKeyEvent` ref the interactive
+ * event loop writes, then wait for watchers to flush.
+ *
+ * Pass `char` for printable input or `key` for named keys ("left", "enter",
+ * "backspace", ...). Modifiers default to false.
+ */
+declare function dispatchKey(event: Partial<Omit<KeyEvent, "type">>): Promise<void>;
+/** Dispatch a sequence of printable characters via {@link dispatchKey}. */
+declare function typeChars(text: string): Promise<void>;
+/**
+ * Serializable snapshot of a mounted output tree.
+ *
+ * Node ids come from a module-global counter and depend on mount order, and
+ * `parent` back-references make trees cyclic, so both are omitted. Props are
+ * kept only when defined, so snapshots stay inline-sized and deterministic.
+ */
+interface FrescoNodeSnapshot {
+  type: FrescoNode["type"];
+  text?: string;
+  props?: Record<string, unknown>;
+  children?: FrescoNodeSnapshot[];
+}
+/**
+ * Convert a mounted node (or the harness root) into a plain snapshot object
+ * suitable for `assert.deepEqual` against an inline expected structure.
+ */
+declare function toTreeSnapshot(node: FrescoNode): FrescoNodeSnapshot;
+/** Depth-first list of nodes matching a predicate, starting at `node`. */
+declare function findNodes(node: FrescoNode, predicate: (candidate: FrescoNode) => boolean): FrescoNode[];
+/** First mounted child under the harness root, asserting it exists. */
+declare function firstChild(mounted: MountedFresco): FrescoNode;
+/** Convenience wrapper that renders `component` with `h` and mounts it. */
+declare function mountComponent(component: Component, props?: Record<string, unknown>, slot?: () => VNodeChild, options?: MountFrescoOptions): MountedFresco;
+//#endregion
+//#region src/testing/index.d.ts
+type RenderTuiOptions = MountFrescoOptions;
+type RenderTuiRoot = Component | (() => VNodeChild);
+type KeyInput = Partial<Omit<KeyEvent, "type">>;
+type MouseInput = Omit<MouseEvent, "type">;
+/** A single recorded harness frame. */
+interface FrescoFrameSnapshot {
+  /** Plain terminal output projected from the current mounted tree. */
+  output: string;
+  /** Serializable renderer tree for structural assertions. */
+  tree: FrescoNodeSnapshot;
+}
+/** Input driver that injects events through Fresco's public event refs. */
+interface FrescoInputDriver {
+  /** Dispatch a key event and record the resulting frame. */
+  key(event: KeyInput): Promise<FrescoFrameSnapshot>;
+  /** Dispatch each printable character and record one frame after the text. */
+  text(text: string): Promise<FrescoFrameSnapshot>;
+  /** Dispatch a bracketed paste payload and record the resulting frame. */
+  paste(text: string): Promise<FrescoFrameSnapshot>;
+  /** Update the provided app size, dispatch a resize event, and record a frame. */
+  resize(width: number, height: number): Promise<FrescoFrameSnapshot>;
+  /** Dispatch a mouse event and record the resulting frame. */
+  mouse(event: MouseInput): Promise<FrescoFrameSnapshot>;
+  /** Dispatch terminal focus state and record the resulting frame. */
+  focus(focused: boolean): Promise<FrescoFrameSnapshot>;
+  /** Dispatch a composition start event and record the resulting frame. */
+  compositionStart(text?: string, cursor?: number): Promise<FrescoFrameSnapshot>;
+  /** Dispatch a composition update event and record the resulting frame. */
+  compositionUpdate(text: string, cursor: number): Promise<FrescoFrameSnapshot>;
+  /** Dispatch a composition end event and record the resulting frame. */
+  compositionEnd(text: string, cursor?: number): Promise<FrescoFrameSnapshot>;
+}
+/** Mounted TUI harness with frame history and input helpers. */
+interface RenderTuiResult extends MountedFresco {
+  /** Recorded plain frames, including the initial mount frame. */
+  readonly frames: readonly string[];
+  /** Recorded frame snapshots, including the initial mount frame. */
+  readonly frameSnapshots: readonly FrescoFrameSnapshot[];
+  /** Event injection helpers. */
+  readonly input: FrescoInputDriver;
+  /** Record and return a fresh snapshot of the current mounted tree. */
+  captureFrame(): FrescoFrameSnapshot;
+  /** Return the latest recorded plain frame. */
+  lastFrame(): string;
+  /** Return the latest recorded frame snapshot. */
+  frameSnapshot(): FrescoFrameSnapshot;
+}
+/** Mount a Fresco app for tests with frame snapshots and input injection. */
+declare function renderTui(root: RenderTuiRoot, options?: RenderTuiOptions): RenderTuiResult;
+//#endregion
+export { FrescoFrameSnapshot, FrescoInputDriver, type FrescoNodeSnapshot, KeyInput, type MountFrescoOptions, type MountedFresco, MouseInput, RenderTuiOptions, RenderTuiResult, RenderTuiRoot, dispatchKey, findNodes, firstChild, mountComponent, mountFresco, renderTui, toTreeSnapshot, typeChars };
+//# sourceMappingURL=index.d.mts.map

package/dist/testing/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/testing/mount.ts","../../src/testing/index.ts"],"mappings":";;;;;;UA+BiB,kBAAA;EAcH;EAZZ,KAAA;EAcY;EAZZ,MAAA;EAgBqB;EAdrB,YAAA;AAAA;;UAIe,aAAA;EAIf;EAFA,IAAA,EAAM,aAAA;EAEM;EAAZ,GAAA,EAAK,GAAA,CAAO,aAAA;EAEA;EAAZ,UAAA,EAAY,YAAA;EAEE;EAAd,YAAA,EAAc,YAAA;EAEO;EAArB,mBAAA,EAAqB,GAAA;EAEd;EAAP,OAAA;AAAA;;;;;;;iBASc,WAAA,CACd,IAAA,EAAM,SAAA,UAAmB,UAAA,GACzB,OAAA,GAAS,kBAAA,GACR,aAAA;;;;;;;;iBA2Da,WAAA,CAAY,KAAA,EAAO,OAAA,CAAQ,IAAA,CAAK,QAAA,aAAqB,OAAA;AA3DrD;AAAA,iBA4EM,SAAA,CAAU,IAAA,WAAe,OAAO;;;;;;;;UAarC,kBAAA;EACf,IAAA,EAAM,UAAA;EACN,IAAA;EACA,KAAA,GAAQ,MAAA;EACR,QAAA,GAAW,kBAAA;AAAA;;AAlC+D;AAiB5E;;iBA8BgB,cAAA,CAAe,IAAA,EAAM,UAAA,GAAa,kBAAkB;;iBAYpD,SAAA,CACd,IAAA,EAAM,UAAA,EACN,SAAA,GAAY,SAAA,EAAW,UAAA,eACtB,UAAA;AAhCH;AAAA,iBA2CgB,UAAA,CAAW,OAAA,EAAS,aAAA,GAAgB,UAAU;;iBAO9C,cAAA,CACd,SAAA,EAAW,SAAA,EACX,KAAA,GAAO,MAAA,mBACP,IAAA,SAAa,UAAA,EACb,OAAA,GAAS,kBAAA,GACR,aAAA;;;KCpKS,gBAAA,GAAmB,kBAAkB;AAAA,KACrC,aAAA,GAAgB,SAAA,UAAmB,UAAU;AAAA,KAC7C,QAAA,GAAW,OAAA,CAAQ,IAAA,CAAK,QAAA;AAAA,KACxB,UAAA,GAAa,IAAI,CAAC,UAAA;ADP9B;AAAA,UCUiB,mBAAA;;EAEf,MAAA;EDRY;ECUZ,IAAA,EAAM,kBAAkB;AAAA;;UAIT,iBAAA;EDRS;ECUxB,GAAA,CAAI,KAAA,EAAO,QAAA,GAAW,OAAA,CAAQ,mBAAA;EDlB9B;ECoBA,IAAA,CAAK,IAAA,WAAe,OAAA,CAAQ,mBAAA;EDlB5B;ECoBA,KAAA,CAAM,IAAA,WAAe,OAAA,CAAQ,mBAAA;EDpBjB;ECsBZ,MAAA,CAAO,KAAA,UAAe,MAAA,WAAiB,OAAA,CAAQ,mBAAA;EDpBnC;ECsBZ,KAAA,CAAM,KAAA,EAAO,UAAA,GAAa,OAAA,CAAQ,mBAAA;EDpBpB;ECsBd,KAAA,CAAM,OAAA,YAAmB,OAAA,CAAQ,mBAAA;EDpBZ;ECsBrB,gBAAA,CAAiB,IAAA,WAAe,MAAA,YAAkB,OAAA,CAAQ,mBAAA;EDpBnD;ECsBP,iBAAA,CAAkB,IAAA,UAAc,MAAA,WAAiB,OAAA,CAAQ,mBAAA;EDb3C;ECed,cAAA,CAAe,IAAA,UAAc,MAAA,YAAkB,OAAA,CAAQ,mBAAA;AAAA;;UAIxC,eAAA,SAAwB,aAAA;EDjB9B;EAAA,SCmBA,MAAA;EDlBK;EAAA,SCoBL,cAAA,WAAyB,mBAAA;EDtB5B;EAAA,SCwBG,KAAA,EAAO,iBAAA;EDxBhB;EC0BA,YAAA,IAAgB,mBAAA;EDzBhB;EC2BA,SAAA;ED1Bc;EC4Bd,aAAA,IAAiB,mBAAA;AAAA;;iBA2HH,SAAA,CAAU,IAAA,EAAM,aAAA,EAAe,OAAA,GAAS,gBAAA,GAAwB,eAAA"}

package/dist/testing/index.mjs

@@ -0,0 +1,282 @@
+import { A as SCREEN_READER_KEY, C as FOCUS_KEY, D as APP_KEY, O as createAppContext, _ as STREAMS_KEY, a as lastMouseEvent, h as createCursorContext, i as lastKeyEvent, m as CURSOR_KEY, n as lastCompositionEvent, o as lastPasteEvent, r as lastFocusEvent, s as lastResizeEvent, u as createRenderer$1, v as createStreamsContext, w as createFocusManager } from "../app-D_Ke7C8w.mjs";
+import { h, nextTick, ref } from "@vue/runtime-core";
+//#region src/testing/mount.ts
+/**
+* Test-only mount harness for the Fresco JS layer.
+*
+* Fresco's renderer is pure JS up to the byte boundary that crosses into the
+* native module: `renderer.ts` imports only types from `@vizejs/fresco-native`,
+* and `app.ts` loads the native binding lazily and only in interactive mode.
+* This harness mounts components through the real custom renderer with the
+* same provide set `createApp`/`renderToString` install, so tests assert the
+* mounted `FrescoNode` output tree without a native build and without mocks.
+*
+* Not exported from the package entry points; `vp pack` does not ship it.
+*/
+/**
+* Mount a component (or a plain render function) through the Fresco renderer.
+*
+* The returned {@link MountedFresco.root} is live: re-read it after reactive
+* updates plus `await nextTick()` to observe the patched output tree.
+*/
+function mountFresco(root, options = {}) {
+	const { createApp } = createRenderer$1();
+	const app = createApp(typeof root === "function" ? { setup: () => root } : root);
+	const focusManager = createFocusManager();
+	const screenReaderEnabled = ref(options.screenReader ?? false);
+	const noopWrite = () => {};
+	const width = options.width ?? 80;
+	const height = options.height ?? 24;
+	const appContext = createAppContext({
+		width,
+		height,
+		stdout: {
+			isTTY: false,
+			columns: width,
+			rows: height,
+			write: () => true
+		}
+	});
+	app.provide(APP_KEY, appContext);
+	app.provide(FOCUS_KEY, focusManager);
+	app.provide(SCREEN_READER_KEY, screenReaderEnabled);
+	app.provide(CURSOR_KEY, createCursorContext(noopWrite));
+	app.provide(STREAMS_KEY, createStreamsContext({
+		interactive: false,
+		writeToStdout: noopWrite,
+		writeToStderr: noopWrite
+	}));
+	const rootElement = {
+		id: -1,
+		type: "root",
+		props: {},
+		children: [],
+		parent: null
+	};
+	app.mount(rootElement);
+	return {
+		root: rootElement,
+		app,
+		appContext,
+		focusManager,
+		screenReaderEnabled,
+		unmount: () => app.unmount()
+	};
+}
+/**
+* Dispatch a key event through the same `lastKeyEvent` ref the interactive
+* event loop writes, then wait for watchers to flush.
+*
+* Pass `char` for printable input or `key` for named keys ("left", "enter",
+* "backspace", ...). Modifiers default to false.
+*/
+function dispatchKey(event) {
+	lastKeyEvent.value = {
+		type: "key",
+		ctrl: false,
+		alt: false,
+		shift: false,
+		meta: false,
+		super: false,
+		hyper: false,
+		capsLock: false,
+		numLock: false,
+		...event
+	};
+	return nextTick();
+}
+/** Dispatch a sequence of printable characters via {@link dispatchKey}. */
+async function typeChars(text) {
+	for (const char of text) await dispatchKey({ char });
+}
+function definedProps(props) {
+	const entries = Object.entries(props).filter(([, value]) => value !== void 0);
+	if (entries.length === 0) return void 0;
+	return Object.fromEntries(entries);
+}
+/**
+* Convert a mounted node (or the harness root) into a plain snapshot object
+* suitable for `assert.deepEqual` against an inline expected structure.
+*/
+function toTreeSnapshot(node) {
+	const snapshot = { type: node.type };
+	if (node.text !== void 0) snapshot.text = node.text;
+	const props = definedProps(node.props);
+	if (props) snapshot.props = props;
+	if (node.children.length > 0) snapshot.children = node.children.map((child) => toTreeSnapshot(child));
+	return snapshot;
+}
+/** Depth-first list of nodes matching a predicate, starting at `node`. */
+function findNodes(node, predicate) {
+	const matches = [];
+	const visit = (current) => {
+		if (predicate(current)) matches.push(current);
+		for (const child of current.children) visit(child);
+	};
+	visit(node);
+	return matches;
+}
+/** First mounted child under the harness root, asserting it exists. */
+function firstChild(mounted) {
+	const child = mounted.root.children[0];
+	if (!child) throw new Error("expected the mounted tree to have a root child");
+	return child;
+}
+/** Convenience wrapper that renders `component` with `h` and mounts it. */
+function mountComponent(component, props = {}, slot, options = {}) {
+	return mountFresco(() => h(component, props, slot), options);
+}
+//#endregion
+//#region src/testing/index.ts
+/**
+* Test utilities for Fresco component and app behavior.
+*
+* The harness mounts through the real Vue custom renderer and records frames
+* without loading the native terminal binding, so it is safe in plain Node,
+* Vitest, and `node:test` suites.
+*/
+function nodeText(node) {
+	if (node.text !== void 0) return node.text;
+	const propText = node.props.text ?? node.props.content;
+	if (typeof propText === "string" || typeof propText === "number") return String(propText);
+	if (node.type !== "input") return "";
+	const value = node.props.value;
+	const placeholder = node.props.placeholder;
+	if (typeof value === "string" || typeof value === "number") return String(value);
+	if (typeof placeholder === "string" || typeof placeholder === "number") return String(placeholder);
+	return "";
+}
+function isStaticNode(node) {
+	return node.props.internal_static === true || node.props.internalStatic === true;
+}
+function joinOutput(parts, separator = "\n") {
+	return parts.filter(Boolean).join(separator);
+}
+function normalizeOutput(output) {
+	return output.endsWith("\n") ? output.slice(0, -1) : output;
+}
+function appendOutput(previous, next) {
+	const normalized = normalizeOutput(next);
+	if (!normalized) return previous;
+	return previous ? `${previous}\n${normalized}` : normalized;
+}
+function treeToFrameOutput(node, options = {}) {
+	if (options.skipStatic && isStaticNode(node)) return "";
+	const ownText = nodeText(node);
+	const childOutput = node.children.map((child) => treeToFrameOutput(child, options));
+	if (node.type === "text" || node.type === "input") return `${ownText}${childOutput.join("")}`;
+	const style = node.props.style ?? {};
+	return joinOutput(childOutput, (style.flexDirection ?? style.flex_direction) === "column" ? "\n" : "");
+}
+function captureStaticOutput(node, renderedStaticItems) {
+	const output = [];
+	const visit = (current) => {
+		if (isStaticNode(current)) {
+			const renderedItems = renderedStaticItems.get(current.id) ?? 0;
+			const nextOutput = joinOutput(current.children.slice(renderedItems).map((child) => treeToFrameOutput(child)), "\n");
+			if (nextOutput) output.push(nextOutput);
+			renderedStaticItems.set(current.id, current.children.length);
+			return;
+		}
+		for (const child of current.children) visit(child);
+	};
+	visit(node);
+	return joinOutput(output, "\n");
+}
+function renderFrame(root, staticOutput) {
+	return joinOutput([staticOutput, treeToFrameOutput(root, { skipStatic: true })], "\n");
+}
+function latestSnapshot(snapshots) {
+	const snapshot = snapshots[snapshots.length - 1];
+	if (!snapshot) throw new Error("expected renderTui to record an initial frame");
+	return snapshot;
+}
+async function dispatchPaste(text) {
+	lastPasteEvent.value = {
+		type: "paste",
+		text
+	};
+	await nextTick();
+}
+async function dispatchMouse(event) {
+	lastMouseEvent.value = {
+		type: "mouse",
+		...event
+	};
+	await nextTick();
+}
+async function dispatchFocus(focused) {
+	lastFocusEvent.value = {
+		type: "focus",
+		focused
+	};
+	await nextTick();
+}
+async function dispatchComposition(type, text, cursor) {
+	lastCompositionEvent.value = {
+		type,
+		text,
+		cursor
+	};
+	await nextTick();
+}
+async function dispatchResize(mounted, width, height) {
+	lastResizeEvent.value = {
+		type: "resize",
+		width,
+		height
+	};
+	mounted.appContext.width.value = width;
+	mounted.appContext.height.value = height;
+	await nextTick();
+}
+/** Mount a Fresco app for tests with frame snapshots and input injection. */
+function renderTui(root, options = {}) {
+	const mounted = mountFresco(root, options);
+	const frames = [];
+	const frameSnapshots = [];
+	const renderedStaticItems = /* @__PURE__ */ new Map();
+	let staticOutput = "";
+	const captureFrame = () => {
+		staticOutput = appendOutput(staticOutput, captureStaticOutput(mounted.root, renderedStaticItems));
+		const snapshot = {
+			output: renderFrame(mounted.root, staticOutput),
+			tree: toTreeSnapshot(mounted.root)
+		};
+		frames.push(snapshot.output);
+		frameSnapshots.push(snapshot);
+		return snapshot;
+	};
+	const recordAfter = async (dispatch) => {
+		await dispatch;
+		return captureFrame();
+	};
+	const input = {
+		key: (event) => recordAfter(dispatchKey(event)),
+		async text(text) {
+			for (const char of text) await dispatchKey({ char });
+			return captureFrame();
+		},
+		paste: (text) => recordAfter(dispatchPaste(text)),
+		resize: (width, height) => recordAfter(dispatchResize(mounted, width, height)),
+		mouse: (event) => recordAfter(dispatchMouse(event)),
+		focus: (focused) => recordAfter(dispatchFocus(focused)),
+		compositionStart: (text = "", cursor = 0) => recordAfter(dispatchComposition("compositionstart", text, cursor)),
+		compositionUpdate: (text, cursor) => recordAfter(dispatchComposition("compositionupdate", text, cursor)),
+		compositionEnd: (text, cursor = text.length) => recordAfter(dispatchComposition("compositionend", text, cursor))
+	};
+	captureFrame();
+	return {
+		...mounted,
+		frames,
+		frameSnapshots,
+		input,
+		captureFrame,
+		lastFrame: () => latestSnapshot(frameSnapshots).output,
+		frameSnapshot: () => latestSnapshot(frameSnapshots)
+	};
+}
+//#endregion
+export { dispatchKey, findNodes, firstChild, mountComponent, mountFresco, renderTui, toTreeSnapshot, typeChars };
+
+//# sourceMappingURL=index.mjs.map

package/dist/testing/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["createRenderer"],"sources":["../../src/testing/mount.ts","../../src/testing/index.ts"],"sourcesContent":["/**\n * Test-only mount harness for the Fresco JS layer.\n *\n * Fresco's renderer is pure JS up to the byte boundary that crosses into the\n * native module: `renderer.ts` imports only types from `@vizejs/fresco-native`,\n * and `app.ts` loads the native binding lazily and only in interactive mode.\n * This harness mounts components through the real custom renderer with the\n * same provide set `createApp`/`renderToString` install, so tests assert the\n * mounted `FrescoNode` output tree without a native build and without mocks.\n *\n * Not exported from the package entry points; `vp pack` does not ship it.\n */\n\nimport {\n  h,\n  ref,\n  nextTick,\n  type App as VueApp,\n  type Component,\n  type Ref,\n  type VNodeChild,\n} from \"@vue/runtime-core\";\nimport { SCREEN_READER_KEY } from \"../accessibility.js\";\nimport { lastKeyEvent, type KeyEvent } from \"../app.js\";\nimport { APP_KEY, createAppContext, type UseAppReturn } from \"../composables/useApp.js\";\nimport { createCursorContext, CURSOR_KEY } from \"../composables/useCursor.js\";\nimport { createFocusManager, FOCUS_KEY, type FocusManager } from \"../composables/useFocus.js\";\nimport { createStreamsContext, STREAMS_KEY } from \"../composables/useStreams.js\";\nimport { createRenderer, type FrescoElement, type FrescoNode } from \"../renderer.js\";\n\n/** Options for {@link mountFresco}. */\nexport interface MountFrescoOptions {\n  /** Terminal width provided through the app context. Defaults to 80. */\n  width?: number;\n  /** Terminal height provided through the app context. Defaults to 24. */\n  height?: number;\n  /** Initial screen reader mode. Defaults to false. */\n  screenReader?: boolean;\n}\n\n/** A mounted Fresco component tree under test. */\nexport interface MountedFresco {\n  /** Root element the Vue app mounted into; children form the output tree. */\n  root: FrescoElement;\n  /** The Vue app instance (for `provide`-level introspection if needed). */\n  app: VueApp<FrescoElement>;\n  /** App context provided to composables such as `useApp` and `useWindowSize`. */\n  appContext: UseAppReturn;\n  /** Focus manager provided to the tree, as the real app would. */\n  focusManager: FocusManager;\n  /** Screen reader flag provided to the tree; writable to flip modes. */\n  screenReaderEnabled: Ref<boolean>;\n  /** Unmount the tree and dispose all component watchers. */\n  unmount(): void;\n}\n\n/**\n * Mount a component (or a plain render function) through the Fresco renderer.\n *\n * The returned {@link MountedFresco.root} is live: re-read it after reactive\n * updates plus `await nextTick()` to observe the patched output tree.\n */\nexport function mountFresco(\n  root: Component | (() => VNodeChild),\n  options: MountFrescoOptions = {},\n): MountedFresco {\n  const { createApp } = createRenderer();\n  const component: Component = typeof root === \"function\" ? { setup: () => root } : root;\n  const app = createApp(component);\n\n  const focusManager = createFocusManager();\n  const screenReaderEnabled = ref(options.screenReader ?? false);\n  const noopWrite = () => {};\n  const width = options.width ?? 80;\n  const height = options.height ?? 24;\n  // A detached stdout stand-in keeps createAppContext from attaching resize\n  // listeners to the real process.stdout on every mounted test tree.\n  const stdout = {\n    isTTY: false,\n    columns: width,\n    rows: height,\n    write: () => true,\n  } as unknown as NodeJS.WriteStream;\n\n  const appContext = createAppContext({ width, height, stdout });\n  app.provide(APP_KEY, appContext);\n  app.provide(FOCUS_KEY, focusManager);\n  app.provide(SCREEN_READER_KEY, screenReaderEnabled);\n  app.provide(CURSOR_KEY, createCursorContext(noopWrite));\n  app.provide(\n    STREAMS_KEY,\n    createStreamsContext({\n      interactive: false,\n      writeToStdout: noopWrite,\n      writeToStderr: noopWrite,\n    }),\n  );\n\n  const rootElement: FrescoElement = {\n    id: -1,\n    type: \"root\",\n    props: {},\n    children: [],\n    parent: null,\n  };\n  app.mount(rootElement);\n\n  return {\n    root: rootElement,\n    app,\n    appContext,\n    focusManager,\n    screenReaderEnabled,\n    unmount: () => app.unmount(),\n  };\n}\n\n/**\n * Dispatch a key event through the same `lastKeyEvent` ref the interactive\n * event loop writes, then wait for watchers to flush.\n *\n * Pass `char` for printable input or `key` for named keys (\"left\", \"enter\",\n * \"backspace\", ...). Modifiers default to false.\n */\nexport function dispatchKey(event: Partial<Omit<KeyEvent, \"type\">>): Promise<void> {\n  lastKeyEvent.value = {\n    type: \"key\",\n    ctrl: false,\n    alt: false,\n    shift: false,\n    meta: false,\n    super: false,\n    hyper: false,\n    capsLock: false,\n    numLock: false,\n    ...event,\n  };\n  return nextTick();\n}\n\n/** Dispatch a sequence of printable characters via {@link dispatchKey}. */\nexport async function typeChars(text: string): Promise<void> {\n  for (const char of text) {\n    await dispatchKey({ char });\n  }\n}\n\n/**\n * Serializable snapshot of a mounted output tree.\n *\n * Node ids come from a module-global counter and depend on mount order, and\n * `parent` back-references make trees cyclic, so both are omitted. Props are\n * kept only when defined, so snapshots stay inline-sized and deterministic.\n */\nexport interface FrescoNodeSnapshot {\n  type: FrescoNode[\"type\"];\n  text?: string;\n  props?: Record<string, unknown>;\n  children?: FrescoNodeSnapshot[];\n}\n\nfunction definedProps(props: Record<string, unknown>): Record<string, unknown> | undefined {\n  const entries = Object.entries(props).filter(([, value]) => value !== undefined);\n  if (entries.length === 0) return undefined;\n  return Object.fromEntries(entries);\n}\n\n/**\n * Convert a mounted node (or the harness root) into a plain snapshot object\n * suitable for `assert.deepEqual` against an inline expected structure.\n */\nexport function toTreeSnapshot(node: FrescoNode): FrescoNodeSnapshot {\n  const snapshot: FrescoNodeSnapshot = { type: node.type };\n  if (node.text !== undefined) snapshot.text = node.text;\n  const props = definedProps(node.props);\n  if (props) snapshot.props = props;\n  if (node.children.length > 0) {\n    snapshot.children = node.children.map((child) => toTreeSnapshot(child));\n  }\n  return snapshot;\n}\n\n/** Depth-first list of nodes matching a predicate, starting at `node`. */\nexport function findNodes(\n  node: FrescoNode,\n  predicate: (candidate: FrescoNode) => boolean,\n): FrescoNode[] {\n  const matches: FrescoNode[] = [];\n  const visit = (current: FrescoNode) => {\n    if (predicate(current)) matches.push(current);\n    for (const child of current.children) visit(child);\n  };\n  visit(node);\n  return matches;\n}\n\n/** First mounted child under the harness root, asserting it exists. */\nexport function firstChild(mounted: MountedFresco): FrescoNode {\n  const child = mounted.root.children[0];\n  if (!child) throw new Error(\"expected the mounted tree to have a root child\");\n  return child;\n}\n\n/** Convenience wrapper that renders `component` with `h` and mounts it. */\nexport function mountComponent(\n  component: Component,\n  props: Record<string, unknown> = {},\n  slot?: () => VNodeChild,\n  options: MountFrescoOptions = {},\n): MountedFresco {\n  return mountFresco(() => h(component, props, slot), options);\n}\n","/**\n * Test utilities for Fresco component and app behavior.\n *\n * The harness mounts through the real Vue custom renderer and records frames\n * without loading the native terminal binding, so it is safe in plain Node,\n * Vitest, and `node:test` suites.\n */\n\nimport { nextTick, type Component, type VNodeChild } from \"@vue/runtime-core\";\nimport {\n  lastCompositionEvent,\n  lastFocusEvent,\n  lastMouseEvent,\n  lastPasteEvent,\n  lastResizeEvent,\n  type CompositionEvent,\n  type FocusEvent,\n  type KeyEvent,\n  type MouseEvent,\n  type PasteEvent,\n  type ResizeEvent,\n} from \"../app.js\";\nimport type { FrescoNode } from \"../renderer.js\";\nimport {\n  dispatchKey,\n  mountFresco,\n  toTreeSnapshot,\n  type FrescoNodeSnapshot,\n  type MountedFresco,\n  type MountFrescoOptions,\n} from \"./mount.js\";\n\nexport {\n  dispatchKey,\n  findNodes,\n  firstChild,\n  mountComponent,\n  mountFresco,\n  toTreeSnapshot,\n  typeChars,\n  type FrescoNodeSnapshot,\n  type MountedFresco,\n  type MountFrescoOptions,\n} from \"./mount.js\";\n\nexport type RenderTuiOptions = MountFrescoOptions;\nexport type RenderTuiRoot = Component | (() => VNodeChild);\nexport type KeyInput = Partial<Omit<KeyEvent, \"type\">>;\nexport type MouseInput = Omit<MouseEvent, \"type\">;\n\n/** A single recorded harness frame. */\nexport interface FrescoFrameSnapshot {\n  /** Plain terminal output projected from the current mounted tree. */\n  output: string;\n  /** Serializable renderer tree for structural assertions. */\n  tree: FrescoNodeSnapshot;\n}\n\n/** Input driver that injects events through Fresco's public event refs. */\nexport interface FrescoInputDriver {\n  /** Dispatch a key event and record the resulting frame. */\n  key(event: KeyInput): Promise<FrescoFrameSnapshot>;\n  /** Dispatch each printable character and record one frame after the text. */\n  text(text: string): Promise<FrescoFrameSnapshot>;\n  /** Dispatch a bracketed paste payload and record the resulting frame. */\n  paste(text: string): Promise<FrescoFrameSnapshot>;\n  /** Update the provided app size, dispatch a resize event, and record a frame. */\n  resize(width: number, height: number): Promise<FrescoFrameSnapshot>;\n  /** Dispatch a mouse event and record the resulting frame. */\n  mouse(event: MouseInput): Promise<FrescoFrameSnapshot>;\n  /** Dispatch terminal focus state and record the resulting frame. */\n  focus(focused: boolean): Promise<FrescoFrameSnapshot>;\n  /** Dispatch a composition start event and record the resulting frame. */\n  compositionStart(text?: string, cursor?: number): Promise<FrescoFrameSnapshot>;\n  /** Dispatch a composition update event and record the resulting frame. */\n  compositionUpdate(text: string, cursor: number): Promise<FrescoFrameSnapshot>;\n  /** Dispatch a composition end event and record the resulting frame. */\n  compositionEnd(text: string, cursor?: number): Promise<FrescoFrameSnapshot>;\n}\n\n/** Mounted TUI harness with frame history and input helpers. */\nexport interface RenderTuiResult extends MountedFresco {\n  /** Recorded plain frames, including the initial mount frame. */\n  readonly frames: readonly string[];\n  /** Recorded frame snapshots, including the initial mount frame. */\n  readonly frameSnapshots: readonly FrescoFrameSnapshot[];\n  /** Event injection helpers. */\n  readonly input: FrescoInputDriver;\n  /** Record and return a fresh snapshot of the current mounted tree. */\n  captureFrame(): FrescoFrameSnapshot;\n  /** Return the latest recorded plain frame. */\n  lastFrame(): string;\n  /** Return the latest recorded frame snapshot. */\n  frameSnapshot(): FrescoFrameSnapshot;\n}\n\nfunction nodeText(node: FrescoNode): string {\n  if (node.text !== undefined) return node.text;\n  const propText = node.props.text ?? node.props.content;\n  if (typeof propText === \"string\" || typeof propText === \"number\") return String(propText);\n  if (node.type !== \"input\") return \"\";\n\n  const value = node.props.value;\n  const placeholder = node.props.placeholder;\n  if (typeof value === \"string\" || typeof value === \"number\") return String(value);\n  if (typeof placeholder === \"string\" || typeof placeholder === \"number\")\n    return String(placeholder);\n  return \"\";\n}\n\nfunction isStaticNode(node: FrescoNode): boolean {\n  return node.props.internal_static === true || node.props.internalStatic === true;\n}\n\nfunction joinOutput(parts: readonly string[], separator = \"\\n\"): string {\n  return parts.filter(Boolean).join(separator);\n}\n\nfunction normalizeOutput(output: string): string {\n  return output.endsWith(\"\\n\") ? output.slice(0, -1) : output;\n}\n\nfunction appendOutput(previous: string, next: string): string {\n  const normalized = normalizeOutput(next);\n  if (!normalized) return previous;\n  return previous ? `${previous}\\n${normalized}` : normalized;\n}\n\nfunction treeToFrameOutput(node: FrescoNode, options: { skipStatic?: boolean } = {}): string {\n  if (options.skipStatic && isStaticNode(node)) return \"\";\n\n  const ownText = nodeText(node);\n  const childOutput = node.children.map((child) => treeToFrameOutput(child, options));\n\n  if (node.type === \"text\" || node.type === \"input\") {\n    return `${ownText}${childOutput.join(\"\")}`;\n  }\n\n  const style = (node.props.style ?? {}) as Record<string, unknown>;\n  const flexDirection = style.flexDirection ?? style.flex_direction;\n  const separator = flexDirection === \"column\" ? \"\\n\" : \"\";\n  return joinOutput(childOutput, separator);\n}\n\nfunction captureStaticOutput(node: FrescoNode, renderedStaticItems: Map<number, number>): string {\n  const output: string[] = [];\n\n  const visit = (current: FrescoNode) => {\n    if (isStaticNode(current)) {\n      const renderedItems = renderedStaticItems.get(current.id) ?? 0;\n      const nextItems = current.children.slice(renderedItems);\n      const nextOutput = joinOutput(\n        nextItems.map((child) => treeToFrameOutput(child)),\n        \"\\n\",\n      );\n      if (nextOutput) output.push(nextOutput);\n      renderedStaticItems.set(current.id, current.children.length);\n      return;\n    }\n\n    for (const child of current.children) visit(child);\n  };\n\n  visit(node);\n  return joinOutput(output, \"\\n\");\n}\n\nfunction renderFrame(root: FrescoNode, staticOutput: string): string {\n  return joinOutput([staticOutput, treeToFrameOutput(root, { skipStatic: true })], \"\\n\");\n}\n\nfunction latestSnapshot(snapshots: readonly FrescoFrameSnapshot[]): FrescoFrameSnapshot {\n  const snapshot = snapshots[snapshots.length - 1];\n  if (!snapshot) throw new Error(\"expected renderTui to record an initial frame\");\n  return snapshot;\n}\n\nasync function dispatchPaste(text: string): Promise<void> {\n  const event: PasteEvent = { type: \"paste\", text };\n  lastPasteEvent.value = event;\n  await nextTick();\n}\n\nasync function dispatchMouse(event: MouseInput): Promise<void> {\n  lastMouseEvent.value = { type: \"mouse\", ...event };\n  await nextTick();\n}\n\nasync function dispatchFocus(focused: boolean): Promise<void> {\n  const event: FocusEvent = { type: \"focus\", focused };\n  lastFocusEvent.value = event;\n  await nextTick();\n}\n\nasync function dispatchComposition(\n  type: CompositionEvent[\"type\"],\n  text: string,\n  cursor: number,\n): Promise<void> {\n  lastCompositionEvent.value = { type, text, cursor };\n  await nextTick();\n}\n\nasync function dispatchResize(\n  mounted: MountedFresco,\n  width: number,\n  height: number,\n): Promise<void> {\n  const event: ResizeEvent = { type: \"resize\", width, height };\n  lastResizeEvent.value = event;\n  mounted.appContext.width.value = width;\n  mounted.appContext.height.value = height;\n  await nextTick();\n}\n\n/** Mount a Fresco app for tests with frame snapshots and input injection. */\nexport function renderTui(root: RenderTuiRoot, options: RenderTuiOptions = {}): RenderTuiResult {\n  const mounted = mountFresco(root, options);\n  const frames: string[] = [];\n  const frameSnapshots: FrescoFrameSnapshot[] = [];\n  const renderedStaticItems = new Map<number, number>();\n  let staticOutput = \"\";\n\n  const captureFrame = () => {\n    staticOutput = appendOutput(\n      staticOutput,\n      captureStaticOutput(mounted.root, renderedStaticItems),\n    );\n    const snapshot: FrescoFrameSnapshot = {\n      output: renderFrame(mounted.root, staticOutput),\n      tree: toTreeSnapshot(mounted.root),\n    };\n    frames.push(snapshot.output);\n    frameSnapshots.push(snapshot);\n    return snapshot;\n  };\n\n  const recordAfter = async (dispatch: Promise<void>) => {\n    await dispatch;\n    return captureFrame();\n  };\n\n  const input: FrescoInputDriver = {\n    key: (event) => recordAfter(dispatchKey(event)),\n    async text(text) {\n      for (const char of text) {\n        await dispatchKey({ char });\n      }\n      return captureFrame();\n    },\n    paste: (text) => recordAfter(dispatchPaste(text)),\n    resize: (width, height) => recordAfter(dispatchResize(mounted, width, height)),\n    mouse: (event) => recordAfter(dispatchMouse(event)),\n    focus: (focused) => recordAfter(dispatchFocus(focused)),\n    compositionStart: (text = \"\", cursor = 0) =>\n      recordAfter(dispatchComposition(\"compositionstart\", text, cursor)),\n    compositionUpdate: (text, cursor) =>\n      recordAfter(dispatchComposition(\"compositionupdate\", text, cursor)),\n    compositionEnd: (text, cursor = text.length) =>\n      recordAfter(dispatchComposition(\"compositionend\", text, cursor)),\n  };\n\n  captureFrame();\n\n  return {\n    ...mounted,\n    frames,\n    frameSnapshots,\n    input,\n    captureFrame,\n    lastFrame: () => latestSnapshot(frameSnapshots).output,\n    frameSnapshot: () => latestSnapshot(frameSnapshots),\n  };\n}\n"],"mappings":"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"}

package/dist/useApp-CNjer3hJ.d.mts

@@ -0,0 +1,86 @@
+import { Ref } from "@vue/runtime-core";
+
+//#region src/composables/useFocus.d.ts
+interface UseFocusOptions {
+  /** Enable or disable this focus target while keeping its logical identity */
+  isActive?: boolean | Ref<boolean>;
+  /** Auto-focus this component when nothing else is focused */
+  autoFocus?: boolean;
+  /** Focus ID for this element */
+  id?: string;
+}
+interface FocusManager {
+  /** Currently focused element ID */
+  focusedId: Ref<string | null>;
+  /** Ink-compatible currently focused ID alias */
+  activeId: Readonly<Ref<string | undefined>>;
+  /** All active focusable element IDs */
+  focusableIds: Readonly<Ref<string[]>>;
+  /** Whether focus management is enabled */
+  isEnabled: Ref<boolean>;
+  /** Enable focus management */
+  enableFocus: () => void;
+  /** Disable focus management */
+  disableFocus: () => void;
+  /** Focus a specific element */
+  focus: (id: string) => void;
+  /** Focus next element */
+  focusNext: () => void;
+  /** Focus previous element */
+  focusPrevious: () => void;
+  /** Register a focusable element */
+  register: (id: string, options?: {
+    isActive?: boolean;
+    autoFocus?: boolean;
+  }) => 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;
+}
+/**
+ * Use focus management
+ */
+declare function useFocus(options?: UseFocusOptions): {
+  id: string;
+  isFocused: import("@vue/reactivity").ComputedRef<boolean>;
+  focus: (targetId?: string) => void;
+  blur: () => void;
+};
+/**
+ * Use global focus manager controls.
+ */
+declare function useFocusManager(): {
+  enableFocus: () => void;
+  disableFocus: () => void;
+  focusNext: () => void;
+  focusPrevious: () => void;
+  focus: (id: string) => void;
+  activeId: Readonly<Ref<string | undefined, string | undefined>>;
+  focusableIds: Readonly<Ref<string[], string[]>>;
+};
+//#endregion
+//#region src/composables/useApp.d.ts
+interface UseAppReturn {
+  /** Terminal width */
+  width: Ref<number>;
+  /** Terminal height */
+  height: Ref<number>;
+  /** Whether app is running */
+  isRunning: Ref<boolean>;
+  /** Exit the app */
+  exit: (errorOrResult?: unknown) => void;
+  /** Force re-render */
+  render: () => void;
+  /** Clear the screen */
+  clear: () => void;
+  /** Wait until pending render output has flushed */
+  waitUntilRenderFlush: () => Promise<void>;
+}
+/**
+ * Use app context
+ */
+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-CNjer3hJ.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useApp-CNjer3hJ.d.mts","names":[],"sources":["../src/composables/useFocus.ts","../src/composables/useApp.ts"],"mappings":";;;UAkBiB,eAAA;EAES;EAAxB,QAAA,aAAqB,GAAG;EAAH;EAErB,SAAA;EAEA;EAAA,EAAA;AAAA;AAAA,UAGe,YAAA;EAAY;EAE3B,SAAA,EAAW,GAAA;EAAA;EAEX,QAAA,EAAU,QAAA,CAAS,GAAA;EAAT;EAEV,YAAA,EAAc,QAAA,CAAS,GAAA;EAAT;EAEd,SAAA,EAAW,GAAA;EAAG;EAEd,WAAA;EARA;EAUA,YAAA;EARA;EAUA,KAAA,GAAQ,EAAA;EAVW;EAYnB,SAAA;EAVc;EAYd,aAAA;EAVA;EAYA,QAAA,GAAW,EAAA,UAAY,OAAA;IAAY,QAAA;IAAoB,SAAA;EAAA;EAN/C;EAQR,UAAA,GAAa,EAAA;EAJb;EAMA,SAAA,GAAY,EAAA,UAAY,QAAA;AAAA;;AAAiB;AA4H3C;iBAAgB,QAAA,CAAS,OAAA,GAAS,eAAoB;;;;;;;;;iBAgEtC,eAAA;;;;;;;;;;;UCvOC,YAAA;EDYS;ECVxB,KAAA,EAAO,GAAA;EDUc;ECRrB,MAAA,EAAQ,GAAA;EDYR;ECVA,SAAA,EAAW,GAAA;EDUT;ECRF,IAAA,GAAO,aAAA;EDWoB;ECT3B,MAAA;EDWW;ECTX,KAAA;EDWU;ECTV,oBAAA,QAA4B,OAAA;AAAA;;;;iBAwEd,MAAA,IAAU,YAAY"}