@vizejs/fresco 0.715.0 → 0.716.0

package/dist/accessibility-OEhyYUxd.d.mts

@@ -0,0 +1,88 @@
+import { S as FrescoRenderNodeKind } from "./protocol-D8xt3DG7.mjs";
+import { Ref, RendererElement, RendererNode } from "vue";
+
+//#region src/renderer.d.ts
+/** Read-only view of a node owned by one Fresco renderer instance. */
+interface FrescoHostNode {
+  /** Stable, process-unique identifier retained across keyed moves and updates. */
+  readonly id: number;
+  /** Native render-node kind represented by this host node. */
+  readonly type: FrescoRenderNodeKind;
+  /** Current Vue host properties. */
+  readonly props: Readonly<Record<string, unknown>>;
+  /** Ordered child host nodes. */
+  readonly children: readonly FrescoHostNode[];
+  /** Parent host node, or null while detached. */
+  readonly parent: FrescoHostNode | null;
+  /** Current text-node content when present. */
+  readonly text?: string;
+}
+/** Declared host dimensions observed before native layout. */
+interface FrescoDeclaredSize {
+  /** Declared width, when the host props provide one. */
+  readonly width?: string | number;
+  /** Declared height, when the host props provide one. */
+  readonly height?: string | number;
+}
+/** Host-tree update category passed to lifecycle observers. */
+type FrescoNodeUpdateKind = "children" | "props" | "text";
+/** Optional lifecycle observers for nodes owned by a Fresco renderer. */
+interface FrescoNodeLifecycleHooks {
+  /** Observe allocation of a stable host node. @default No-op. */
+  onCreate?(node: FrescoHostNode): void;
+  /** Observe a committed host-tree update. @default No-op. */
+  onUpdate?(node: FrescoHostNode, kind: FrescoNodeUpdateKind): void;
+  /** Observe a change to declared width or height. @default No-op. */
+  onResize?(node: FrescoHostNode, previous: FrescoDeclaredSize, current: FrescoDeclaredSize): void;
+  /** Observe recursive disposal after descendants have been removed. @default No-op. */
+  onRemove?(node: FrescoHostNode): void;
+}
+/** Configuration for {@link createRenderer}. */
+interface FrescoRendererOptions {
+  /** Observe a host-tree mutation that requires native frame work. @default No-op. */
+  onMutation?: () => void;
+  /** Observe stable-node lifecycle transitions. @default No lifecycle observers. */
+  lifecycle?: FrescoNodeLifecycleHooks;
+}
+/** @internal Mutable Vue host node; not part of the public render protocol. */
+interface FrescoNode extends RendererNode, FrescoHostNode {
+  id: number;
+  type: FrescoRenderNodeKind;
+  props: Record<string, unknown>;
+  children: FrescoNode[];
+  parent: FrescoNode | null;
+  text?: string;
+}
+/** @internal Mutable Vue host element; not part of the public render protocol. */
+interface FrescoElement extends FrescoNode, RendererElement {}
+/**
+ * Create a Fresco renderer with stable host-node lookup and lifecycle control.
+ */
+declare function createRenderer$1(options?: FrescoRendererOptions | (() => void)): import("vue").Renderer<FrescoElement> & {
+  /** Return one live host node by its stable identifier. */getNode(id: number): FrescoHostNode | undefined; /** Find one node under the supplied subtree without crossing its boundary. */
+  findDescendantById(root: FrescoHostNode, id: number): FrescoHostNode | undefined; /** Detach and dispose a registered node and every descendant exactly once. */
+  destroyRecursively(id: number): boolean;
+};
+//#endregion
+//#region src/accessibility.d.ts
+/** Semantic roles supported by Fresco screen-reader serialization. */
+type AriaRole = "button" | "checkbox" | "combobox" | "list" | "listbox" | "listitem" | "menu" | "menuitem" | "option" | "progressbar" | "radio" | "radiogroup" | "scrollbar" | "tab" | "tablist" | "table" | "textbox" | "timer" | "toolbar";
+/** Accessible state rendered alongside the semantic node description. */
+interface AriaState {
+  busy?: boolean;
+  checked?: boolean;
+  disabled?: boolean;
+  expanded?: boolean;
+  multiline?: boolean;
+  multiselectable?: boolean;
+  readonly?: boolean;
+  required?: boolean;
+  selected?: boolean;
+  orientation?: "horizontal" | "vertical";
+  valueMin?: number;
+  valueMax?: number;
+  valueNow?: number;
+}
+//#endregion
+export { FrescoHostNode as a, FrescoNodeUpdateKind as c, FrescoElement as i, FrescoRendererOptions as l, AriaState as n, FrescoNode as o, FrescoDeclaredSize as r, FrescoNodeLifecycleHooks as s, AriaRole as t, createRenderer$1 as u };
+//# sourceMappingURL=accessibility-OEhyYUxd.d.mts.map

package/dist/accessibility-OEhyYUxd.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-OEhyYUxd.d.mts","names":[],"sources":["../src/renderer.ts","../src/accessibility.ts"],"mappings":";;;;;UAgBiB,cAAA;EAMU;EAAA,SAJhB,EAAA;EAMmB;EAAA,SAJnB,IAAA,EAAM,oBAAA;EAMgB;EAAA,SAJtB,KAAA,EAAO,QAAA,CAAS,MAAA;EAJhB;EAAA,SAMA,QAAA,WAAmB,cAAA;EAJb;EAAA,SAMN,MAAA,EAAQ,cAAA;EAJD;EAAA,SAMP,IAAA;AAAA;;UAIM,kBAAA;EANE;EAAA,SAQR,KAAA;EANI;EAAA,SAQJ,MAAM;AAAA;;KAIL,oBAAA;;UAGK,wBAAA;EAHL;EAKV,QAAA,EAAU,IAAA,EAAM,cAAA;;EAEhB,QAAA,EAAU,IAAA,EAAM,cAAA,EAAgB,IAAA,EAAM,oBAAA;EAPR;EAS9B,QAAA,EAAU,IAAA,EAAM,cAAA,EAAgB,QAAA,EAAU,kBAAA,EAAoB,OAAA,EAAS,kBAAA;EANhC;EAQvC,QAAA,EAAU,IAAA,EAAM,cAAA;AAAA;;UAID,qBAAA;EANC;EAQhB,UAAA;EARuE;EAUvE,SAAA,GAAY,wBAAwB;AAAA;;UAIrB,UAAA,SAAmB,YAAA,EAAc,cAAA;EAChD,EAAA;EACA,IAAA,EAAM,oBAAA;EACN,KAAA,EAAO,MAAA;EACP,QAAA,EAAU,UAAA;EACV,MAAA,EAAQ,UAAA;EACR,IAAA;AAAA;;UAIe,aAAA,SAAsB,UAAA,EAAY,eAAe;;;;iBAiMlD,gBAAA,CAAe,OAAA,GAAS,qBAAA,gCAAyC,QAAA,CAAA,aAAA;EAvN/E,+EAkOuB,cAAA,cAlOb;2BAsOiB,cAAA,EAAc,EAAA,WAAe,cAAA,cAtO1B;;;;;;KCtCpB,QAAA;;UAsBK,SAAA;EACf,IAAA;EACA,OAAA;EACA,QAAA;EACA,QAAA;EACA,SAAA;EACA,eAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;EACA,WAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;AAAA"}

package/dist/{app-DoXcF_Dn.mjs → app-CIX6NAW-.mjs}

@@ -96,6 +96,7 @@ function nonEmptyStringValue(value) {
 	const string = stringValue$1(value);
 	return string ? string : void 0;
 }
+/** Normalize component style input into the canonical native render style. */
 function normalizeFrescoStyle(value) {
 	const source = recordValue(value);
 	const style = {};
@@ -177,6 +178,7 @@ function wrappingEnabled(value, mode) {
 	if (value === void 0 || value === false) return false;
 	return !(mode?.startsWith("truncate") ?? false);
 }
+/** Convert one internal Fresco node into its strict public render protocol node. */
 function frescoNodeToRenderNode(node) {
 	const common = commonFields(node);
 	if (node.type === "root" || node.type === "box") return {
@@ -217,7 +219,9 @@ function frescoNodeToRenderNode(node) {
 }
 //#endregion
 //#region src/accessibility.ts
+/** Injection key exposing whether screen-reader output is active. */
 const SCREEN_READER_KEY = Symbol("fresco-screen-reader");
+/** Read the Ink- and Fresco-compatible screen-reader environment flags. */
 function isScreenReaderEnabledByDefault() {
 	return process.env.INK_SCREEN_READER === "true" || process.env.FRESCO_SCREEN_READER === "true";
 }
@@ -253,6 +257,7 @@ function ariaState(node) {
 function isAriaHidden(node) {
 	return node.props["aria-hidden"] === true;
 }
+/** Serialize a Fresco tree into deterministic semantic screen-reader text. */
 function treeToScreenReaderString(node, options = {}) {
 	if (isAriaHidden(node)) return "";
 	let output = "";
@@ -275,6 +280,7 @@ function treeToScreenReaderString(node, options = {}) {
 	if (role && role !== options.parentRole) output = `${role}: ${output}`;
 	return output;
 }
+/** Convert a Fresco tree into the minimal native nodes used for screen-reader output. */
 function treeToScreenReaderRenderNodes(root) {
 	const output = treeToScreenReaderString(root);
 	const rootStyle = normalizeFrescoStyle(root.props.style) ?? {};
@@ -664,14 +670,17 @@ function useCursor() {
 //#endregion
 //#region src/layoutMetrics.ts
 let lastRenderLayouts = [];
+/** Replace the layout snapshot exposed by the most recent native render. */
 function updateLastRenderLayouts(layouts) {
 	lastRenderLayouts = layouts;
 }
+/** Look up the latest native layout for an element or component public instance. */
 function getLastRenderLayout(node) {
 	const id = node?.id ?? node?.$el?.id;
 	if (id === void 0) return null;
 	return lastRenderLayouts.find((layout) => layout.id === id) ?? null;
 }
+/** Return the latest element dimensions, falling back to zero before layout. */
 function measureElement(node) {
 	const layout = getLastRenderLayout(node);
 	return {
@@ -681,6 +690,7 @@ function measureElement(node) {
 }
 //#endregion
 //#region src/nativeInput.ts
+/** Accept only key event phases supported by the public Fresco protocol. */
 function normalizeKeyEventType(value) {
 	switch (value) {
 		case "press":
@@ -715,72 +725,136 @@ function normalizeMouseEvent(event) {
 * Fresco Vue Custom Renderer
 */
 let nextId = 0;
-function createNode(type) {
+/** Keep only dimension values accepted by the public style contract. */
+function dimension(value) {
+	return typeof value === "string" || typeof value === "number" ? value : void 0;
+}
+/** Read the dimensions declared directly by a host node before native layout. */
+function declaredSize(node) {
+	const style = typeof node.props.style === "object" && node.props.style !== null ? node.props.style : {};
 	return {
+		width: dimension(style.width ?? node.props.width),
+		height: dimension(style.height ?? node.props.height)
+	};
+}
+/** Compare declared dimensions without coercing numeric and string values. */
+function sameSize(left, right) {
+	return Object.is(left.width, right.width) && Object.is(left.height, right.height);
+}
+/** Allocate and register one stable host node before exposing it to Vue. */
+function createNode(tree, type, text) {
+	const node = {
 		id: nextId++,
 		type,
 		props: {},
 		children: [],
-		parent: null
+		parent: null,
+		...text === void 0 ? {} : { text }
 	};
+	tree.nodes.set(node.id, node);
+	tree.lifecycle.onCreate?.(node);
+	return node;
+}
+/** Publish a committed host-tree update to the optional lifecycle observer. */
+function notifyUpdate(tree, node, kind) {
+	tree.lifecycle.onUpdate?.(node, kind);
+}
+/** Dispose a registered subtree depth-first, reporting each node once. */
+function disposeNode(tree, node) {
+	if (!tree.nodes.has(node.id)) return false;
+	for (const child of node.children) disposeNode(tree, child);
+	node.children = [];
+	node.parent = null;
+	tree.nodes.delete(node.id);
+	tree.lifecycle.onRemove?.(node);
+	return true;
+}
+/** Detach a node only after its parent collection reflects the removal. */
+function detachNode(tree, node) {
+	const parent = node.parent;
+	if (!parent) return false;
+	const index = parent.children.indexOf(node);
+	node.parent = null;
+	if (index === -1) return false;
+	parent.children.splice(index, 1);
+	notifyUpdate(tree, parent, "children");
+	return true;
 }
 /**
 * Renderer options for Fresco
 */
-const rendererOptions = {
-	patchProp(el, key, _prevValue, nextValue) {
-		if (nextValue == null) delete el.props[key];
-		else el.props[key] = nextValue;
-	},
-	insert(child, parent, anchor) {
-		if (child.parent) {
-			const existing = child.parent.children.indexOf(child);
-			if (existing !== -1) child.parent.children.splice(existing, 1);
-		}
-		child.parent = parent;
-		if (anchor) {
-			const index = parent.children.indexOf(anchor);
-			if (index !== -1) {
-				parent.children.splice(index, 0, child);
-				return;
+function rendererOptions(tree) {
+	return {
+		patchProp(el, key, _prevValue, nextValue) {
+			const previousSize = declaredSize(el);
+			if (nextValue == null) {
+				if (!(key in el.props)) return;
+				delete el.props[key];
+			} else {
+				if (Object.is(el.props[key], nextValue)) return;
+				el.props[key] = nextValue;
 			}
+			notifyUpdate(tree, el, "props");
+			const currentSize = declaredSize(el);
+			if (!sameSize(previousSize, currentSize)) tree.lifecycle.onResize?.(el, previousSize, currentSize);
+			tree.onMutation();
+		},
+		insert(child, parent, anchor) {
+			const previousParent = child.parent;
+			if (previousParent) {
+				const existing = previousParent.children.indexOf(child);
+				if (existing !== -1) previousParent.children.splice(existing, 1);
+				child.parent = null;
+			}
+			child.parent = parent;
+			const index = anchor ? parent.children.indexOf(anchor) : -1;
+			if (index === -1) parent.children.push(child);
+			else parent.children.splice(index, 0, child);
+			try {
+				if (previousParent && previousParent !== parent) notifyUpdate(tree, previousParent, "children");
+				notifyUpdate(tree, parent, "children");
+			} finally {
+				tree.onMutation();
+			}
+		},
+		remove(child) {
+			const detached = detachNode(tree, child);
+			const disposed = disposeNode(tree, child);
+			if (detached || disposed) tree.onMutation();
+		},
+		createElement(type) {
+			return createNode(tree, mapElementType(type));
+		},
+		createText(text) {
+			return createNode(tree, "text", text);
+		},
+		createComment() {
+			return createNode(tree, "text");
+		},
+		setText(node, text) {
+			if (node.text === text) return;
+			node.text = text;
+			notifyUpdate(tree, node, "text");
+			tree.onMutation();
+		},
+		setElementText(el, text) {
+			if (el.text === text && el.children.length === 0) return;
+			for (const child of el.children) disposeNode(tree, child);
+			el.text = text;
+			el.children = [];
+			notifyUpdate(tree, el, "text");
+			tree.onMutation();
+		},
+		parentNode(node) {
+			return node.parent;
+		},
+		nextSibling(node) {
+			if (!node.parent) return null;
+			const index = node.parent.children.indexOf(node);
+			return node.parent.children[index + 1] || null;
 		}
-		parent.children.push(child);
-	},
-	remove(child) {
-		if (child.parent) {
-			const index = child.parent.children.indexOf(child);
-			if (index !== -1) child.parent.children.splice(index, 1);
-			child.parent = null;
-		}
-	},
-	createElement(type) {
-		return createNode(mapElementType(type));
-	},
-	createText(text) {
-		const node = createNode("text");
-		node.text = text;
-		return node;
-	},
-	createComment() {
-		return createNode("text");
-	},
-	setText(node, text) {
-		node.text = text;
-	},
-	setElementText(el, text) {
-		el.text = text;
-		el.children = [];
-	},
-	parentNode(node) {
-		return node.parent;
-	},
-	nextSibling(node) {
-		if (!node.parent) return null;
-		const index = node.parent.children.indexOf(node);
-		return node.parent.children[index + 1] || null;
-	}
-};
+	};
+}
 /**
 * Map Vue element types to Fresco node types
 */
@@ -797,10 +871,38 @@ function mapElementType(type) {
 	}
 }
 /**
-* Create the Fresco renderer
+* Create a Fresco renderer with stable host-node lookup and lifecycle control.
 */
-function createRenderer$1() {
-	return createRenderer(rendererOptions);
+function createRenderer$1(options = {}) {
+	const normalized = typeof options === "function" ? { onMutation: options } : options;
+	const tree = {
+		nodes: /* @__PURE__ */ new Map(),
+		lifecycle: normalized.lifecycle ?? {},
+		onMutation: normalized.onMutation ?? (() => {})
+	};
+	const renderer = createRenderer(rendererOptions(tree));
+	return Object.assign(renderer, {
+		/** Return one live host node by its stable identifier. */
+		getNode(id) {
+			return tree.nodes.get(id);
+		},
+		/** Find one node under the supplied subtree without crossing its boundary. */
+		findDescendantById(root, id) {
+			if (root.id === id) return root;
+			const registered = tree.nodes.get(id);
+			if (!registered) return void 0;
+			for (let parent = registered.parent; parent; parent = parent.parent) if (parent === root) return registered;
+		},
+		/** Detach and dispose a registered node and every descendant exactly once. */
+		destroyRecursively(id) {
+			const node = tree.nodes.get(id);
+			if (!node) return false;
+			detachNode(tree, node);
+			disposeNode(tree, node);
+			tree.onMutation();
+			return true;
+		}
+	});
 }
 /**
 * Convert Fresco tree to render nodes for native
@@ -816,28 +918,8 @@ function treeToRenderNodes(root) {
 	return nodes;
 }
 //#endregion
-//#region src/app.ts
-/**
-* Fresco App - Application instance management
-*/
-const lastKeyEvent = ref(null);
-const lastPasteEvent = ref(null);
-const lastResizeEvent = ref(null);
-const lastMouseEvent = ref(null);
-const lastFocusEvent = ref(null);
-const lastCompositionEvent = ref(null);
-let native = null;
-const consoleMethods = [
-	"debug",
-	"error",
-	"info",
-	"log",
-	"warn"
-];
-async function loadNative() {
-	if (!native) native = await import("@vizejs/fresco-native");
-	return native;
-}
+//#region src/renderToStringStreams.ts
+/** Create a detached writable stream for non-interactive Fresco rendering. */
 function createNoopWriteStream(columns, rows) {
 	const stream = {
 		isTTY: false,
@@ -851,6 +933,7 @@ function createNoopWriteStream(columns, rows) {
 	};
 	return stream;
 }
+/** Create a detached readable stream for non-interactive Fresco rendering. */
 function createNoopReadStream() {
 	const stream = {
 		isTTY: false,
@@ -868,6 +951,45 @@ function createNoopReadStream() {
 	};
 	return stream;
 }
+//#endregion
+//#region src/staticNodes.ts
+/** Whether a renderer node owns append-only static output. */
+function isStaticNode(node) {
+	return node.props.internal_static === true || node.props.internalStatic === true;
+}
+/** Whether a renderer node is one append-only item inside a static owner. */
+function isStaticItemNode(node) {
+	return node.props.internal_static_item === true || node.props.internalStaticItem === true;
+}
+//#endregion
+//#region src/app.ts
+/**
+* Fresco App - Application instance management
+*/
+/** Latest normalized key event received by the active Fresco application. */
+const lastKeyEvent = ref(null);
+/** Latest bracketed-paste event received by the active Fresco application. */
+const lastPasteEvent = ref(null);
+/** Latest terminal resize event received by the active Fresco application. */
+const lastResizeEvent = ref(null);
+/** Latest normalized mouse event received by the active Fresco application. */
+const lastMouseEvent = ref(null);
+/** Latest terminal focus event received by the active Fresco application. */
+const lastFocusEvent = ref(null);
+/** Latest IME composition event received by the active Fresco application. */
+const lastCompositionEvent = ref(null);
+let native = null;
+const consoleMethods = [
+	"debug",
+	"error",
+	"info",
+	"log",
+	"warn"
+];
+async function loadNative() {
+	if (!native) native = await import("@vizejs/fresco-native");
+	return native;
+}
 function isWritableStream(value) {
 	return typeof value === "object" && value !== null && "write" in value && typeof value.write === "function";
 }
@@ -914,9 +1036,6 @@ function nodeText(node) {
 	}
 	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);
 }
@@ -941,9 +1060,10 @@ function captureStaticOutput(node, renderedStaticItems) {
 	function visit(current) {
 		if (isStaticNode(current)) {
 			const renderedItems = renderedStaticItems.get(current.id) ?? 0;
-			const nextOutput = joinOutput(current.children.slice(renderedItems).map((child) => treeToString(child)), "\n");
+			const staticItems = current.children.filter(isStaticItemNode);
+			const nextOutput = joinOutput(staticItems.slice(renderedItems).map((child) => treeToString(child)), "\n");
 			if (nextOutput) output.push(nextOutput);
-			renderedStaticItems.set(current.id, current.children.length);
+			renderedStaticItems.set(current.id, staticItems.length);
 			return;
 		}
 		for (const child of current.children) visit(child);
@@ -1067,7 +1187,9 @@ function createApp(rootComponent, options = {}) {
 		resolveExit = resolve;
 		rejectExit = reject;
 	});
-	const { createApp: createVueApp } = createRenderer$1();
+	const { createApp: createVueApp } = createRenderer$1(() => {
+		needsRender = true;
+	});
 	async function mount() {
 		if (mounted) return;
 		const n = interactive ? await loadNative() : null;
@@ -1335,7 +1457,6 @@ function createApp(rootComponent, options = {}) {
 					render();
 					needsRender = false;
 				}
-				needsRender = true;
 			} catch (error) {
 				if (onError) onError(error);
 			}
@@ -1413,6 +1534,6 @@ function renderToString(root, options = {}) {
 	return output;
 }
 //#endregion
-export { useApp as A, useStreamsContext as C, useFocusManager as D, useFocus as E, isScreenReaderEnabledByDefault as M, APP_KEY as O, useStdout as S, createFocusManager as T, useCursor as _, lastMouseEvent as a, useStderr as b, render as c, treeToRenderNodes as d, getLastRenderLayout as f, createCursorContext as g, CURSOR_KEY as h, lastKeyEvent as i, SCREEN_READER_KEY as j, createAppContext as k, renderToString as l, updateLastRenderLayouts as m, lastCompositionEvent as n, lastPasteEvent as o, measureElement as p, lastFocusEvent as r, lastResizeEvent as s, createApp as t, createRenderer$1 as u, STREAMS_KEY as v, FOCUS_KEY as w, useStdin as x, createStreamsContext as y };
+export { APP_KEY as A, useStdin as C, createFocusManager as D, FOCUS_KEY as E, useApp as M, SCREEN_READER_KEY as N, useFocus as O, isScreenReaderEnabledByDefault as P, useStderr as S, useStreamsContext as T, CURSOR_KEY as _, lastMouseEvent as a, STREAMS_KEY as b, render as c, isStaticNode as d, createRenderer$1 as f, updateLastRenderLayouts as g, measureElement as h, lastKeyEvent as i, createAppContext as j, useFocusManager as k, renderToString as l, getLastRenderLayout as m, lastCompositionEvent as n, lastPasteEvent as o, treeToRenderNodes as p, lastFocusEvent as r, lastResizeEvent as s, createApp as t, isStaticItemNode as u, createCursorContext as v, useStdout as w, createStreamsContext as x, useCursor as y };
 
-//# sourceMappingURL=app-DoXcF_Dn.mjs.map
+//# sourceMappingURL=app-CIX6NAW-.mjs.map