@vizejs/fresco 0.347.7 → 0.351.0

package/dist/app-DJImCkSW.d.mts

@@ -0,0 +1,135 @@
+import { F as PasteEvent, I as ResizeEvent, M as KeyEvent, P as MouseEvent, a as FocusEvent, i as CompositionEvent } from "./renderer-DWG0G3g8.mjs";
+import { Component, Ref, VNode } from "@vue/runtime-core";
+import { TerminalInfoNapi } from "@vizejs/fresco-native";
+
+//#region src/kittyKeyboard.d.ts
+/**
+ * Kitty keyboard protocol constants compatible with Ink.
+ */
+declare const kittyFlags: {
+  readonly disambiguateEscapeCodes: 1;
+  readonly reportEventTypes: 2;
+  readonly reportAlternateKeys: 4;
+  readonly reportAllKeysAsEscapeCodes: 8;
+  readonly reportAssociatedText: 16;
+};
+type KittyFlagName = keyof typeof kittyFlags;
+interface KittyKeyboardOptions {
+  mode?: "auto" | "enabled" | "disabled";
+  flags?: KittyFlagName[];
+}
+declare function resolveKittyFlags(flags: KittyFlagName[]): number;
+declare const kittyModifiers: {
+  readonly shift: 1;
+  readonly alt: 2;
+  readonly ctrl: 4;
+  readonly super: 8;
+  readonly hyper: 16;
+  readonly meta: 32;
+  readonly capsLock: 64;
+  readonly numLock: 128;
+};
+//#endregion
+//#region src/app.d.ts
+declare const lastKeyEvent: Ref<KeyEvent | null>;
+declare const lastPasteEvent: Ref<PasteEvent | null>;
+declare const lastResizeEvent: Ref<ResizeEvent | null>;
+declare const lastMouseEvent: Ref<MouseEvent | null>;
+declare const lastFocusEvent: Ref<FocusEvent | null>;
+declare const lastCompositionEvent: Ref<CompositionEvent | null>;
+/**
+ * App options
+ */
+interface AppOptions {
+  /** Enable mouse support */
+  mouse?: boolean;
+  /** Exit on Ctrl+C */
+  exitOnCtrlC?: boolean;
+  /** Custom error handler */
+  onError?: (error: Error) => void;
+  /** Debug mode - logs render tree */
+  debug?: boolean;
+  /** Ink-compatible option, accepted for API parity */
+  stdout?: NodeJS.WriteStream;
+  /** Ink-compatible option, accepted for API parity */
+  stdin?: NodeJS.ReadStream;
+  /** Ink-compatible option, accepted for API parity */
+  stderr?: NodeJS.WriteStream;
+  /** Ink-compatible option, accepted for API parity */
+  patchConsole?: boolean;
+  /** Called after a frame is rendered */
+  onRender?: (metrics: RenderMetrics) => void;
+  /** Enable screen reader rendering hints */
+  isScreenReaderEnabled?: boolean;
+  /** Maximum render frames per second */
+  maxFps?: number;
+  /** Use alternate screen buffer */
+  alternateScreen?: boolean;
+  /** Ink-compatible option, accepted for API parity */
+  incrementalRendering?: boolean;
+  /** Ink-compatible option, accepted for API parity */
+  concurrent?: boolean;
+  /** Override interactive mode detection */
+  interactive?: boolean;
+  /** Configure Kitty keyboard protocol support */
+  kittyKeyboard?: KittyKeyboardOptions;
+}
+type RenderOptions = AppOptions;
+type AppRoot = Component | VNode;
+/**
+ * Performance metrics for a render operation.
+ */
+interface RenderMetrics {
+  /** Time spent rendering in milliseconds */
+  renderTime: number;
+}
+/**
+ * Fresco App instance
+ */
+interface App$1 {
+  /** Mount the app */
+  mount(): Promise<void>;
+  /** Unmount the app */
+  unmount(errorOrResult?: unknown): Promise<void>;
+  /** Wait for exit */
+  waitUntilExit(): Promise<unknown>;
+  /** Wait for pending render output */
+  waitUntilRenderFlush(): Promise<void>;
+  /** Render the app */
+  render(): void;
+  /** Clear the screen */
+  clear(): void;
+  /** Get terminal info */
+  getTerminalInfo(): Promise<TerminalInfoNapi>;
+}
+interface RenderInstance {
+  rerender(root: AppRoot): void;
+  unmount(errorOrResult?: unknown): Promise<void>;
+  waitUntilExit(): Promise<unknown>;
+  waitUntilRenderFlush(): Promise<void>;
+  cleanup(): Promise<void>;
+  clear(): void;
+}
+type Instance = RenderInstance;
+interface RenderToStringOptions {
+  /** Width of the virtual terminal in columns */
+  columns?: number;
+}
+interface WritableStreamLike {
+  write(...args: unknown[]): unknown;
+}
+/**
+ * Create a Fresco TUI app
+ */
+declare function createApp(rootComponent: AppRoot, options?: AppOptions): App$1;
+/**
+ * Ink-compatible helper that mounts immediately.
+ */
+declare function render(root: AppRoot, options?: AppOptions | WritableStreamLike): RenderInstance;
+/**
+ * Render a Fresco component to a plain string without starting a terminal app.
+ */
+declare function renderToString(root: AppRoot, options?: RenderToStringOptions): string;
+//#endregion
+export { KittyFlagName as _, RenderMetrics as a, kittyModifiers as b, createApp as c, lastKeyEvent as d, lastMouseEvent as f, renderToString as g, render as h, RenderInstance as i, lastCompositionEvent as l, lastResizeEvent as m, AppOptions as n, RenderOptions as o, lastPasteEvent as p, Instance as r, RenderToStringOptions as s, App$1 as t, lastFocusEvent as u, KittyKeyboardOptions as v, resolveKittyFlags as x, kittyFlags as y };
+//# sourceMappingURL=app-DJImCkSW.d.mts.map

package/dist/app-DJImCkSW.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-DJImCkSW.d.mts","names":[],"sources":["../src/kittyKeyboard.ts","../src/app.ts"],"mappings":";;;;;;;;cAIa,UAAA;EAAA;;;;;;KAQD,aAAA,gBAA6B,UAAU;AAAA,UAElC,oBAAA;EACf,IAAA;EACA,KAAA,GAAQ,aAAa;AAAA;AAAA,iBAGP,iBAAA,CAAkB,KAAsB,EAAf,aAAa;AAAA,cAIzC,cAAA;EAAA;;;;;;;;;;;cCoCA,YAAA,EAAc,GAAG,CAAC,QAAA;AAAA,cAClB,cAAA,EAAgB,GAAG,CAAC,UAAA;AAAA,cACpB,eAAA,EAAiB,GAAG,CAAC,WAAA;AAAA,cACrB,cAAA,EAAgB,GAAG,CAAC,UAAA;AAAA,cACpB,cAAA,EAAgB,GAAG,CAAC,UAAA;AAAA,cACpB,oBAAA,EAAsB,GAAG,CAAC,gBAAA;;;ADpDvC;UCuEiB,UAAA;;EAEf,KAAA;EDzEiD;EC2EjD,WAAA;EDzEmC;EC2EnC,OAAA,IAAW,KAAA,EAAO,KAAA;EDzEG;EC2ErB,KAAA;ED3EA;EC6EA,MAAA,GAAS,MAAA,CAAO,WAAA;ED7EK;EC+ErB,KAAA,GAAQ,MAAA,CAAO,UAAA;ED5ED;EC8Ed,MAAA,GAAS,MAAA,CAAO,WAAA;;EAEhB,YAAA;EDhFsD;ECkFtD,QAAA,IAAY,OAAA,EAAS,aAAA;EDrEb;ECuER,qBAAA;EDvEQ;ECyER,MAAA;;EAEA,eAAA;;EAEA,oBAAA;;EAEA,UAAA;;EAEA,WAAA;;EAEA,aAAA,GAAgB,oBAAA;AAAA;AAAA,KAGN,aAAA,GAAgB,UAAU;AAAA,KAE1B,OAAA,GAAU,SAAA,GAAY,KAAK;;;;UAKtB,aAAA;EAjEJ;EAmEX,UAAU;AAAA;;AAnE+B;AAC3C;UAwEiB,KAAA;;EAEf,KAAA,IAAS,OAAA;EA1EkC;EA4E3C,OAAA,CAAQ,aAAA,aAA0B,OAAA;EA3E2B;EA6E7D,aAAA,IAAiB,OAAA;EA7EU;EA+E3B,oBAAA,IAAwB,OAAA;EA9Eb;EAgFX,MAAA;;EAEA,KAAA;EAlFyC;EAoFzC,eAAA,IAAmB,OAAA,CAAQ,gBAAA;AAAA;AAAA,UAGZ,cAAA;EACf,QAAA,CAAS,IAAA,EAAM,OAAA;EACf,OAAA,CAAQ,aAAA,aAA0B,OAAA;EAClC,aAAA,IAAiB,OAAA;EACjB,oBAAA,IAAwB,OAAA;EACxB,OAAA,IAAW,OAAA;EACX,KAAA;AAAA;AAAA,KAGU,QAAA,GAAW,cAAc;AAAA,UAEpB,qBAAA;EA5DM;EA8DrB,OAAO;AAAA;AAAA,UAGQ,kBAAA;EACf,KAAA,IAAS,IAAI;AAAA;;;;iBA2PC,SAAA,CAAU,aAAA,EAAe,OAAA,EAAS,OAAA,GAAS,UAAA,GAAkB,KAAA;;;;iBA6c7D,MAAA,CACd,IAAA,EAAM,OAAA,EACN,OAAA,GAAS,UAAA,GAAa,kBAAA,GACrB,cAAA;;;;iBAgCa,cAAA,CAAe,IAAA,EAAM,OAAA,EAAS,OAAA,GAAS,qBAA0B"}

package/dist/{useInput-iUuaOefz.mjs → app-D_Ke7C8w.mjs}

@@ -1366,220 +1366,6 @@ function renderToString(root, options = {}) {
 	return output;
 }
 //#endregion
-//#region src/composables/useIsScreenReaderEnabled.ts
-/**
-* useIsScreenReaderEnabled - screen reader mode flag.
-*/
-function useIsScreenReaderEnabled() {
-	return inject(SCREEN_READER_KEY, null)?.value ?? isScreenReaderEnabledByDefault();
-}
-//#endregion
-//#region src/composables/usePaste.ts
-/**
-* usePaste - bracketed paste handling.
-*/
-let activePasteHandlerCount = 0;
-function hasActivePasteHandlers() {
-	return activePasteHandlerCount > 0;
-}
-function toRef$1(value) {
-	return isRef(value) ? value : ref(value);
-}
-function usePaste(handler, options = {}) {
-	const isActive = toRef$1(options.isActive ?? true);
-	const streams = useStreamsContext();
-	let rawModeEnabled = false;
-	let bracketedPasteEnabled = false;
-	let pasteHandlerRegistered = false;
-	const syncRawMode = (isEnabled) => {
-		if (rawModeEnabled === isEnabled) return;
-		streams.setRawMode(isEnabled);
-		rawModeEnabled = isEnabled;
-	};
-	const syncBracketedPasteMode = (isEnabled) => {
-		if (bracketedPasteEnabled === isEnabled) return;
-		streams.setBracketedPasteMode(isEnabled);
-		bracketedPasteEnabled = isEnabled;
-	};
-	const syncPasteRegistration = (isEnabled) => {
-		if (pasteHandlerRegistered === isEnabled) return;
-		activePasteHandlerCount += isEnabled ? 1 : -1;
-		pasteHandlerRegistered = isEnabled;
-	};
-	const syncActiveState = (isEnabled) => {
-		syncRawMode(isEnabled);
-		syncBracketedPasteMode(isEnabled);
-		syncPasteRegistration(isEnabled);
-	};
-	watch(lastPasteEvent, (event) => {
-		if (!event || !isActive.value) return;
-		handler(event.text);
-	});
-	watch(isActive, syncActiveState, { immediate: true });
-	onUnmounted(() => syncActiveState(false));
-	return {
-		isActive,
-		enable: () => {
-			isActive.value = true;
-		},
-		disable: () => {
-			isActive.value = false;
-		}
-	};
-}
-//#endregion
-//#region src/composables/useInput.ts
-/**
-* useInput - Input handling composable
-*/
-function toRef(value) {
-	return isRef(value) ? value : ref(value);
-}
-function keyName(event) {
-	return event.char ?? event.key ?? "";
-}
-function toInkKey(event) {
-	const key = event.key;
-	return {
-		upArrow: key === "up",
-		downArrow: key === "down",
-		leftArrow: key === "left",
-		rightArrow: key === "right",
-		pageDown: key === "pagedown" || key === "pageDown",
-		pageUp: key === "pageup" || key === "pageUp",
-		home: key === "home",
-		end: key === "end",
-		return: key === "enter" || key === "return",
-		escape: key === "escape" || key === "esc",
-		ctrl: event.ctrl,
-		shift: event.shift,
-		tab: key === "tab" || key === "backtab",
-		backspace: key === "backspace",
-		delete: key === "delete",
-		meta: event.meta,
-		super: event.super,
-		hyper: event.hyper,
-		capsLock: event.capsLock,
-		numLock: event.numLock,
-		eventType: event.eventType
-	};
-}
-function emptyKey() {
-	return {
-		upArrow: false,
-		downArrow: false,
-		leftArrow: false,
-		rightArrow: false,
-		pageDown: false,
-		pageUp: false,
-		home: false,
-		end: false,
-		return: false,
-		escape: false,
-		ctrl: false,
-		shift: false,
-		tab: false,
-		backspace: false,
-		delete: false,
-		meta: false,
-		super: false,
-		hyper: false,
-		capsLock: false,
-		numLock: false
-	};
-}
-function inputValue(event, key) {
-	if (event.char) return event.char;
-	if (key.return) return "\r";
-	return "";
-}
-function handleStructuredOptions(event, options, lastKey) {
-	const modifiers = {
-		ctrl: event.ctrl,
-		alt: event.alt,
-		shift: event.shift,
-		meta: event.meta
-	};
-	const pressedKey = keyName(event);
-	const inkKey = toInkKey(event);
-	if (event.char) {
-		lastKey.value = event.char;
-		options.onChar?.(event.char);
-		options.onKey?.(event.char, modifiers);
-		return;
-	}
-	if (pressedKey) {
-		lastKey.value = pressedKey;
-		options.onKey?.(pressedKey, modifiers);
-	}
-	if (inkKey.return) options.onSubmit?.();
-	if (inkKey.escape) options.onEscape?.();
-	if (inkKey.upArrow) options.onArrow?.("up");
-	if (inkKey.downArrow) options.onArrow?.("down");
-	if (inkKey.leftArrow) options.onArrow?.("left");
-	if (inkKey.rightArrow) options.onArrow?.("right");
-}
-function useInput(handlerOrOptions = {}, handlerOptions = {}) {
-	const options = typeof handlerOrOptions === "function" ? {
-		handler: handlerOrOptions,
-		isActive: handlerOptions.isActive
-	} : handlerOrOptions;
-	const isActive = toRef(options.isActive ?? options.active ?? true);
-	const lastKey = ref(null);
-	const streams = useStreamsContext();
-	let rawModeEnabled = false;
-	const syncRawMode = (isEnabled) => {
-		if (rawModeEnabled === isEnabled) return;
-		streams.setRawMode(isEnabled);
-		rawModeEnabled = isEnabled;
-	};
-	watch(lastKeyEvent, (event) => {
-		if (!event || !isActive.value) return;
-		const inkKey = toInkKey(event);
-		const input = inputValue(event, inkKey);
-		const pressedKey = keyName(event);
-		if (input === "c" && inkKey.ctrl && streams.internal_exitOnCtrlC) return;
-		lastKey.value = pressedKey || null;
-		options.handler?.(input, inkKey);
-		handleStructuredOptions(event, options, lastKey);
-	});
-	watch(lastPasteEvent, (event) => {
-		if (!event || !isActive.value || hasActivePasteHandlers()) return;
-		lastKey.value = event.text;
-		options.handler?.(event.text, emptyKey());
-		options.onChar?.(event.text);
-	});
-	watch(lastCompositionEvent, (event) => {
-		if (!event || !isActive.value) return;
-		if (event.type === "compositionstart") options.onCompositionStart?.();
-		else if (event.type === "compositionupdate") options.onCompositionUpdate?.(event.text, event.cursor);
-		else options.onCompositionEnd?.(event.text);
-	});
-	watch(isActive, syncRawMode, { immediate: true });
-	onUnmounted(() => syncRawMode(false));
-	const enable = () => {
-		isActive.value = true;
-	};
-	const disable = () => {
-		isActive.value = false;
-	};
-	return {
-		isActive,
-		lastKey,
-		enable,
-		disable
-	};
-}
-/**
-* Shorthand for handling specific key combinations
-*/
-function useKeyPress(key, handler, options = {}) {
-	const { ctrl = false, alt = false, shift = false, meta = false } = options;
-	useInput({ onKey: (pressedKey, modifiers) => {
-		if (pressedKey.toLowerCase() === key.toLowerCase() && modifiers.ctrl === ctrl && modifiers.alt === alt && modifiers.shift === shift && modifiers.meta === meta) handler();
-	} });
-}
-//#endregion
-export { useFocusManager as C, useFocus as S, updateLastRenderLayouts as _, createApp as a, useStdin as b, lastKeyEvent as c, lastResizeEvent as d, render as f, measureElement as g, getLastRenderLayout as h, useIsScreenReaderEnabled as i, lastMouseEvent as l, createRenderer$1 as m, useKeyPress as n, lastCompositionEvent as o, renderToString as p, usePaste as r, lastFocusEvent as s, useInput as t, lastPasteEvent as u, useCursor as v, useApp as w, useStdout as x, useStderr as y };
+export { SCREEN_READER_KEY as A, FOCUS_KEY as C, APP_KEY as D, useFocusManager as E, createAppContext as O, useStreamsContext as S, useFocus as T, STREAMS_KEY as _, lastMouseEvent as a, useStdin as b, render as c, getLastRenderLayout as d, measureElement as f, useCursor as g, createCursorContext as h, lastKeyEvent as i, isScreenReaderEnabledByDefault as j, useApp as k, renderToString as l, CURSOR_KEY as m, lastCompositionEvent as n, lastPasteEvent as o, updateLastRenderLayouts as p, lastFocusEvent as r, lastResizeEvent as s, createApp as t, createRenderer$1 as u, createStreamsContext as v, createFocusManager as w, useStdout as x, useStderr as y };
 
-//# sourceMappingURL=useInput-iUuaOefz.mjs.map
+//# sourceMappingURL=app-D_Ke7C8w.mjs.map