@effect-tui/react 0.1.6 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@effect-tui/react",
-	"version": "0.1.6",
+	"version": "0.2.0",
 	"description": "React bindings for @effect-tui/core",
 	"type": "module",
 	"files": [
@@ -83,7 +83,7 @@
 		"prepublishOnly": "bun run typecheck && bun run build"
 	},
 	"dependencies": {
-		"@effect-tui/core": "^0.1.6",
+		"@effect-tui/core": "^0.2.0",
 		"@effect/platform": "^0.94.0",
 		"@effect/platform-bun": "^0.87.0",
 		"@effect/rpc": "^0.73.0",
@@ -110,6 +110,7 @@
 		}
 	},
 	"devDependencies": {
+		"@effect-tui/emulator": "workspace:^",
 		"@effect/opentelemetry": "^0.60.0",
 		"@effect/vitest": "^0.27.0",
 		"@opentelemetry/api": "^1.9.0",

package/src/dev.tsx

@@ -395,8 +395,8 @@ export async function devRender(entryPath: string, options?: DevRenderOptions):
 	const renderer = createRenderer(options)
 	const root = createRoot(renderer)
 
-	// Dev mode always enables remote control
-	const stopRemote = enableRemote(renderer)
+	// Dev mode always enables remote control with entry path for identification
+	const stopRemote = enableRemote(renderer, { entryPath })
 
 	let debounceTimer: ReturnType<typeof setTimeout> | null = null
 	let version = 0

package/src/hooks/index.ts

@@ -3,5 +3,6 @@ export type { UseKeyboardOptions } from "./use-keyboard.js"
 export { useMouse } from "./use-mouse.js"
 export type { UseMouseOptions } from "./use-mouse.js"
 export { usePaste } from "./use-paste.js"
+export { useQuit } from "./use-quit.js"
 export { useScroll } from "./use-scroll.js"
 export type { UseScrollOptions, UseScrollReturn, ScrollState } from "./use-scroll.js"

package/src/hooks/use-quit.ts

@@ -0,0 +1,33 @@
+import { useCallback } from "react"
+import { useRenderer } from "../renderer-context.js"
+
+/**
+ * Hook that returns a quit function for cleanly exiting the TUI application.
+ *
+ * This ensures terminal state is properly restored (alternate buffer exit,
+ * cursor shown, raw mode disabled) before the process exits.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const quit = useQuit()
+ *
+ *   useKeyboard((key) => {
+ *     if (key.text === "q") quit()
+ *   })
+ *
+ *   return <text>Press q to quit</text>
+ * }
+ * ```
+ */
+export function useQuit(): (code?: number) => void {
+	const renderer = useRenderer()
+
+	return useCallback(
+		(code = 0) => {
+			renderer.stop()
+			process.exit(code)
+		},
+		[renderer],
+	)
+}

package/src/hosts/base.ts

@@ -32,9 +32,11 @@ export abstract class BaseHost implements HostInstance {
 	children: HostInstance[] = []
 	rect: Rect | null = null
 
-	// Common flex props
-	flexGrow = 0
-	flexShrink = 1
+	// Greedy layout - expands to fill remaining space
+	// undefined = not greedy (hug content)
+	// true or 1 = 1 share
+	// number > 1 = proportionally more shares
+	greedy: boolean | number | undefined = undefined
 
 	// ─────────────────────────────────────────────────────────────
 	// Frame constraints (like SwiftUI's .frame modifier)
@@ -65,7 +67,20 @@ export abstract class BaseHost implements HostInstance {
 	abstract render(buffer: CellBuffer, palette: Palette): void
 
 	layout(rect: Rect): void {
-		this.rect = rect
+		// Apply frame constraints to the assigned rect
+		let { w, h } = rect
+
+		// Fixed width/height override
+		if (this.frameWidth !== undefined) w = this.frameWidth
+		if (this.frameHeight !== undefined) h = this.frameHeight
+
+		// Apply min/max clamps
+		if (this.frameMinWidth !== undefined) w = Math.max(this.frameMinWidth, w)
+		if (this.frameMaxWidth !== undefined) w = Math.min(this.frameMaxWidth, w)
+		if (this.frameMinHeight !== undefined) h = Math.max(this.frameMinHeight, h)
+		if (this.frameMaxHeight !== undefined) h = Math.min(this.frameMaxHeight, h)
+
+		this.rect = { x: rect.x, y: rect.y, w, h }
 	}
 
 	/**
@@ -144,8 +159,23 @@ export abstract class BaseHost implements HostInstance {
 	}
 
 	updateProps(props: Record<string, unknown>): void {
-		this.flexGrow = (props.flexGrow as number | undefined) ?? 0
-		this.flexShrink = (props.flexShrink as number | undefined) ?? 1
+		// Greedy layout - reset to undefined unless explicitly set
+		// Subclasses like Spacer/Scroll set their own default before calling super
+		if ("greedy" in props) {
+			const greedy = props.greedy
+			if (greedy === true) {
+				this.greedy = 1
+			} else if (typeof greedy === "number") {
+				this.greedy = greedy
+			} else {
+				// greedy is false, undefined, or null
+				this.greedy = undefined
+			}
+		} else {
+			// No greedy prop - reset to default (undefined)
+			// Subclasses like Spacer/Scroll handle this before calling super
+			this.greedy = undefined
+		}
 
 		// Frame constraints - only accept valid numbers (ignore strings like "100%")
 		this.frameWidth = typeof props.width === "number" ? props.width : undefined
@@ -183,4 +213,18 @@ export abstract class BaseHost implements HostInstance {
 		}
 		child.parent = this
 	}
+
+	/**
+	 * Render a child with optional clipping to its rect.
+	 * Common pattern used by containers (ZStack, Overlay, etc.)
+	 */
+	protected renderChildWithClip(child: HostInstance, buffer: CellBuffer, palette: Palette): void {
+		if (child.rect) {
+			buffer.withClip(child.rect.x, child.rect.y, child.rect.w, child.rect.h, () => {
+				child.render(buffer, palette)
+			})
+		} else {
+			child.render(buffer, palette)
+		}
+	}
 }

package/src/hosts/box.ts

@@ -1,7 +1,6 @@
 import type { CellBuffer, Palette, Color } from "@effect-tui/core"
 import { Colors } from "@effect-tui/core"
 import type { HostContext, Rect, Size, CommonProps } from "../reconciler/types.js"
-import { getInheritedBg } from "./base.js"
 import { SingleChildHost } from "./single-child.js"
 import {
 	type BorderKind,
@@ -10,7 +9,7 @@ import {
 	type Padding,
 	type PaddingInput,
 	resolvePadding,
-	resolveBgStyle,
+	resolveInheritedBgStyle,
 	toColorValue,
 } from "../utils/index.js"
 
@@ -94,11 +93,9 @@ export class BoxHost extends SingleChildHost {
 		if (!this.rect) return
 		const { x, y, w, h } = this.rect
 
-		// If no explicit bg, inherit from parent (so child boxes are transparent over parents)
-		const rawBg: Color | undefined = this.bg ?? getInheritedBg(this.parent)
-
 		// Always clear our rect to ensure stale backgrounds are removed.
-		const { styleId: bgStyleId } = resolveBgStyle(palette, rawBg)
+		// If no explicit bg, inherit from parent (so child boxes are transparent over parents)
+		const { styleId: bgStyleId } = resolveInheritedBgStyle(palette, this.bg, this.parent)
 		buffer.fillRect(x, y, w, h, " ".codePointAt(0)!, bgStyleId)
 
 		// Draw border

package/src/hosts/flex-container.ts

@@ -84,12 +84,14 @@ export class FlexContainerHost<A extends FlexAxis> extends BaseHost {
 
 	override layout(rect: Rect): void {
 		super.layout(rect)
+		// Use this.rect (constrained) not rect (raw input)
+		if (!this.rect) return
 		const stretchCross = this.axis === "vertical" ? this.alignment === "leading" : this.alignment === "top"
 		layoutFlex(
 			this.axis,
 			this.layoutChildren,
 			this.cachedSizes,
-			rect,
+			this.rect,
 			this.spacing,
 			toFlexAlignment(this.axis, this.alignment),
 			stretchCross,

package/src/hosts/overlay-item.ts

@@ -7,7 +7,7 @@
 
 import type { CellBuffer, Palette, Rect, Size } from "@effect-tui/core"
 import type { HostContext, CommonProps } from "../reconciler/types.js"
-import { BaseHost } from "./base.js"
+import { SingleChildHost } from "./single-child.js"
 
 type HAlign = "left" | "center" | "right"
 type VAlign = "top" | "center" | "bottom"
@@ -17,7 +17,7 @@ export interface OverlayItemProps extends CommonProps {
 	alignment?: { h?: HAlign; v?: VAlign }
 }
 
-export class OverlayItemHost extends BaseHost {
+export class OverlayItemHost extends SingleChildHost {
 	/** Stored alignment for parent Overlay to read */
 	alignment: { h?: HAlign; v?: VAlign } = {}
 
@@ -29,37 +29,22 @@ export class OverlayItemHost extends BaseHost {
 	override measure(maxW: number, maxH: number): Size {
 		const constrained = this.constrainProposal(maxW, maxH)
 
-		// Size is determined by single child
-		const child = this.children[0]
-		if (!child) {
+		if (!this.child) {
 			return this.constrainResult({ w: 0, h: 0 })
 		}
 
-		const childSize = child.measure(constrained.w, constrained.h)
+		const childSize = this.child.measure(constrained.w, constrained.h)
 		return this.constrainResult(childSize)
 	}
 
 	override layout(rect: Rect): void {
 		this.rect = rect
-
-		// Pass rect to child
-		const child = this.children[0]
-		if (child) {
-			child.layout(rect)
-		}
+		this.child?.layout(rect)
 	}
 
 	override render(buffer: CellBuffer, palette: Palette): void {
-		// Render child
-		const child = this.children[0]
-		if (child) {
-			if (child.rect) {
-				buffer.withClip(child.rect.x, child.rect.y, child.rect.w, child.rect.h, () => {
-					child.render(buffer, palette)
-				})
-			} else {
-				child.render(buffer, palette)
-			}
+		if (this.child) {
+			this.renderChildWithClip(this.child, buffer, palette)
 		}
 	}
 

package/src/hosts/overlay.ts

@@ -19,6 +19,7 @@
 import type { CellBuffer, Palette, Rect, Size } from "@effect-tui/core"
 import type { HostContext, CommonProps } from "../reconciler/types.js"
 import { BaseHost } from "./base.js"
+import { alignInRect } from "../utils/index.js"
 import type { OverlayItemHost } from "./overlay-item.js"
 
 export interface OverlayProps extends CommonProps {}
@@ -70,36 +71,7 @@ export class OverlayHost extends BaseHost {
 
 			// Read alignment from OverlayItemHost (use type check, not instanceof, for bundler compatibility)
 			const alignment = child.type === "overlayItem" ? (child as OverlayItemHost).alignment : {}
-			const hAlign = alignment.h ?? "center"
-			const vAlign = alignment.v ?? "center"
-
-			// Calculate position based on alignment
-			let x = rect.x
-			let y = rect.y
-
-			switch (hAlign) {
-				case "left":
-					x = rect.x
-					break
-				case "center":
-					x = rect.x + Math.floor((rect.w - size.w) / 2)
-					break
-				case "right":
-					x = rect.x + rect.w - size.w
-					break
-			}
-
-			switch (vAlign) {
-				case "top":
-					y = rect.y
-					break
-				case "center":
-					y = rect.y + Math.floor((rect.h - size.h) / 2)
-					break
-				case "bottom":
-					y = rect.y + rect.h - size.h
-					break
-			}
+			const { x, y } = alignInRect(rect, size, alignment.h ?? "center", alignment.v ?? "center")
 
 			child.layout({
 				x,
@@ -113,13 +85,7 @@ export class OverlayHost extends BaseHost {
 	override render(buffer: CellBuffer, palette: Palette): void {
 		// Render all children in order (base first, then overlays)
 		for (const child of this.children) {
-			if (child.rect) {
-				buffer.withClip(child.rect.x, child.rect.y, child.rect.w, child.rect.h, () => {
-					child.render(buffer, palette)
-				})
-			} else {
-				child.render(buffer, palette)
-			}
+			this.renderChildWithClip(child, buffer, palette)
 		}
 	}
 }

package/src/hosts/scroll.ts

@@ -1,9 +1,8 @@
 // scroll.ts — Scrollable container host
 import type { CellBuffer, Palette, Color } from "@effect-tui/core"
 import type { HostContext, Rect, Size, CommonProps } from "../reconciler/types.js"
-import { getInheritedBg } from "./base.js"
 import { SingleChildHost } from "./single-child.js"
-import { resolveBgStyle } from "../utils/index.js"
+import { resolveInheritedBgStyle } from "../utils/index.js"
 
 export interface ScrollProps extends CommonProps {
 	/** Scroll axis: "vertical" (default), "horizontal", or "both" */
@@ -39,6 +38,9 @@ export class ScrollHost extends SingleChildHost {
 	bg?: Color
 	showScrollbar = true
 	sticky = false
+
+	// Scroll is greedy by default - expands to fill available space
+	override greedy: boolean | number | undefined = 1
 	onContentSize?: (width: number, height: number) => void
 	onViewportSize?: (width: number, height: number) => void
 	onEffectiveOffset?: (offset: number) => void
@@ -86,8 +88,12 @@ export class ScrollHost extends SingleChildHost {
 			// Note: onContentSize callback is deferred to layout() to keep measure() pure
 		}
 
-		// Scroll container is greedy - takes all available space (after constraints)
-		return this.constrainResult({ w: constrained.w, h: constrained.h })
+		// Report natural content size (clamped to constrained bounds)
+		// Greedy expansion happens in layout phase via layoutFlex
+		const naturalW = Math.min(this.contentWidth, constrained.w)
+		const naturalH = Math.min(this.contentHeight, constrained.h)
+
+		return this.constrainResult({ w: naturalW, h: naturalH })
 	}
 
 	override layout(rect: Rect): void {
@@ -175,9 +181,8 @@ export class ScrollHost extends SingleChildHost {
 		if (!this.rect) return
 		const { x, y, w, h } = this.rect
 
-		// Fill background
-		const rawBg: Color | undefined = this.bg ?? getInheritedBg(this.parent)
-		const { value: bgValue, styleId: bgStyleId } = resolveBgStyle(palette, rawBg)
+		// Fill background (inherit from parent if not explicitly set)
+		const { value: bgValue, styleId: bgStyleId } = resolveInheritedBgStyle(palette, this.bg, this.parent)
 		if (bgValue !== undefined) {
 			buffer.fillRect(x, y, w, h, " ".codePointAt(0)!, bgStyleId)
 		}
@@ -241,6 +246,10 @@ export class ScrollHost extends SingleChildHost {
 
 	override updateProps(props: Record<string, unknown>): void {
 		super.updateProps(props)
+		// Scroll is greedy by default unless explicitly set to false
+		if (!("greedy" in props)) {
+			this.greedy = 1
+		}
 		if (props.axis !== undefined) this.axis = (props.axis as ScrollProps["axis"]) ?? "vertical"
 		if (props.offset !== undefined) this.offset = props.offset as number
 		if (props.offsetX !== undefined) this.offsetX = props.offsetX as number

package/src/hosts/spacer.ts

@@ -13,15 +13,16 @@ export class SpacerHost extends BaseHost {
 	minWidth = 0
 	minHeight = 0
 
+	// Spacers are greedy by default
+	override greedy: boolean | number | undefined = 1
+
 	constructor(props: SpacerProps, ctx: HostContext) {
-		// Spacers have flexGrow=1 by default
-		const propsWithDefaults = { flexGrow: 1, ...props }
-		super("spacer", propsWithDefaults, ctx)
-		this.updateProps(propsWithDefaults)
+		super("spacer", props, ctx)
+		this.updateProps(props)
 	}
 
 	measure(_maxW: number, _maxH: number): Size {
-		// Spacers have no natural size, they expand via flexGrow
+		// Spacers have no natural size, they expand via greedy
 		return { w: this.minWidth, h: this.minHeight }
 	}
 
@@ -34,10 +35,11 @@ export class SpacerHost extends BaseHost {
 	}
 
 	override updateProps(props: Record<string, unknown>): void {
-		// Keep spacer default flexGrow=1 unless explicitly provided
-		const flexGrow = props.flexGrow as number | undefined
-		const propsWithDefaults = flexGrow === undefined ? { ...props, flexGrow: 1 } : props
-		super.updateProps(propsWithDefaults)
+		super.updateProps(props)
+		// Spacer is greedy by default unless explicitly set to false
+		if (!("greedy" in props)) {
+			this.greedy = 1
+		}
 		if (props.minWidth !== undefined) this.minWidth = props.minWidth as number
 		if (props.minHeight !== undefined) this.minHeight = props.minHeight as number
 	}

package/src/hosts/text.ts

@@ -1,7 +1,7 @@
 import { displayWidth, type CellBuffer, type Palette, type Color } from "@effect-tui/core"
 import type { HostContext, Rect, Size, CommonProps } from "../reconciler/types.js"
 import { BaseHost, getInheritedBg } from "./base.js"
-import { resolveBgStyle, styleIdFromProps } from "../utils/index.js"
+import { resolveInheritedBgStyle, styleIdFromProps } from "../utils/index.js"
 
 export interface TextProps extends CommonProps {
 	fg?: Color
@@ -114,8 +114,8 @@ export class TextHost extends BaseHost {
 		if (!this.rect) return
 
 		// If text has no bg, inherit from parent box for proper highlight rendering
-		const inheritedBg: Color | undefined = this.bg ?? getInheritedBg(this.parent)
-		const { value: bgValue, styleId: bgStyleId } = resolveBgStyle(palette, inheritedBg)
+		const { value: bgValue, styleId: bgStyleId } = resolveInheritedBgStyle(palette, this.bg, this.parent)
+		const inheritedBg = this.bg ?? getInheritedBg(this.parent)
 
 		const styleId = styleIdFromProps(palette, {
 			fg: this.fg,

package/src/hosts/zstack.ts

@@ -1,6 +1,7 @@
 import type { CellBuffer, Palette } from "@effect-tui/core"
 import type { HostContext, Rect, Size, CommonProps } from "../reconciler/types.js"
 import { BaseHost } from "./base.js"
+import { alignInRect, type HAlign, type VAlign } from "../utils/index.js"
 
 export interface ZStackProps extends CommonProps {
 	alignment?: { h?: "leading" | "center" | "trailing"; v?: "top" | "center" | "bottom" }
@@ -8,8 +9,8 @@ export interface ZStackProps extends CommonProps {
 
 // Overlay children in the same rect, honoring alignment for each child.
 export class ZStackHost extends BaseHost {
-	alignmentH: "leading" | "center" | "trailing" = "center"
-	alignmentV: "top" | "center" | "bottom" = "center"
+	alignmentH: HAlign = "center"
+	alignmentV: VAlign = "center"
 	private cachedSizes: Size[] = []
 
 	constructor(props: ZStackProps, ctx: HostContext) {
@@ -47,15 +48,7 @@ export class ZStackHost extends BaseHost {
 		for (let i = 0; i < this.children.length; i++) {
 			const child = this.children[i]
 			const size = this.cachedSizes[i] ?? child.measure(rect.w, rect.h)
-
-			let x = rect.x
-			let y = rect.y
-
-			if (this.alignmentH === "center") x += Math.floor((rect.w - size.w) / 2)
-			else if (this.alignmentH === "trailing") x += Math.max(0, rect.w - size.w)
-
-			if (this.alignmentV === "center") y += Math.floor((rect.h - size.h) / 2)
-			else if (this.alignmentV === "bottom") y += Math.max(0, rect.h - size.h)
+			const { x, y } = alignInRect(rect, size, this.alignmentH, this.alignmentV)
 
 			child.layout({
 				x,
@@ -68,13 +61,7 @@ export class ZStackHost extends BaseHost {
 
 	render(buffer: CellBuffer, palette: Palette): void {
 		for (const child of this.children) {
-			if (child.rect) {
-				buffer.withClip(child.rect.x, child.rect.y, child.rect.w, child.rect.h, () => {
-					child.render(buffer, palette)
-				})
-			} else {
-				child.render(buffer, palette)
-			}
+			this.renderChildWithClip(child, buffer, palette)
 		}
 	}
 

package/src/reconciler/types.ts

@@ -92,10 +92,15 @@ export interface HostContext {
  * With the constraint, it reports exactly 10, so spacer gets the rest.
  */
 export interface CommonProps {
-	/** Flex grow factor - how much extra space this view takes (default: 0) */
-	flexGrow?: number
-	/** Flex shrink factor - how much this view shrinks when space is tight (default: 1) */
-	flexShrink?: number
+	/**
+	 * Greedy layout - element expands to fill remaining space.
+	 * - `true` or `1`: takes 1 share of remaining space
+	 * - number > 1: takes proportionally more (e.g., `greedy={2}` gets 2x space)
+	 * - `false` or undefined: hugs content (default)
+	 *
+	 * Scroll and Spacer are greedy by default.
+	 */
+	greedy?: boolean | number
 
 	// ─────────────────────────────────────────────────────────────
 	// Frame constraints (like SwiftUI's .frame modifier)

package/src/remote/Procedures.ts

@@ -39,6 +39,10 @@ const Info = Rpc.make("Info", {
 		pid: Schema.Number,
 		width: Schema.Number,
 		height: Schema.Number,
+		/** Entry file path (e.g., /Users/kit/code/my-app/src/tui.tsx) */
+		entryPath: Schema.optional(Schema.String),
+		/** Short name derived from entry path (e.g., my-app/src/tui.tsx) */
+		name: Schema.optional(Schema.String),
 	}),
 })
 

package/src/remote/Router.ts

@@ -10,7 +10,13 @@ export interface TuiSessionImpl {
 	readonly dispatchKey: (key: KeyMsg) => void
 	readonly dispatchPaste: (text: string) => void
 	readonly dispatchResize: (width: number, height: number) => void
-	readonly getInfo: () => { pid: number; width: number; height: number }
+	readonly getInfo: () => {
+		pid: number
+		width: number
+		height: number
+		entryPath?: string
+		name?: string
+	}
 }
 
 export class TuiSession extends Context.Tag("TuiSession")<

package/src/remote/index.ts

@@ -17,19 +17,55 @@ import type { TuiRenderer } from "../renderer-types.js"
 import type { TuiSessionImpl } from "./Router.js"
 import { makeServerLayer, getSocketPath } from "./Server.js"
 
+export interface EnableRemoteOptions {
+	/** Custom socket path (defaults to /tmp/effect-tui-sessions/<pid>.sock) */
+	socketPath?: string
+	/** Entry file path for identification (e.g., import.meta.path) */
+	entryPath?: string
+}
+
+/**
+ * Derive a short name from the entry path.
+ * Uses the last directory + filename (e.g., "/Users/kit/code/my-app/src/tui.tsx" -> "my-app/src/tui.tsx")
+ */
+function deriveSessionName(entryPath: string): string {
+	const parts = entryPath.split("/")
+	// Find the last directory that looks like a project name (not src, lib, etc)
+	const commonDirs = ["src", "lib", "dist", "build", "packages"]
+	let srcIdx = -1
+	for (let i = parts.length - 1; i >= 0; i--) {
+		if (commonDirs.includes(parts[i])) {
+			srcIdx = i
+			break
+		}
+	}
+	if (srcIdx > 0) {
+		// Include project name + relative path from there
+		return parts.slice(srcIdx - 1).join("/")
+	}
+	// Fallback: last 3 path segments
+	return parts.slice(-3).join("/")
+}
+
 /**
  * Enable remote control for a TUI renderer.
  * Starts an RPC server on a Unix socket at /tmp/effect-tui-sessions/<pid>.sock
  *
  * @param renderer - The TUI renderer to control
- * @param socketPath - Optional custom socket path
+ * @param options - Socket path and entry path for session identification
  * @returns A cleanup function to stop the server
  */
 export function enableRemote(
 	renderer: TuiRenderer,
-	socketPath?: string,
+	options?: EnableRemoteOptions | string,
 ): () => void {
-	const actualPath = socketPath ?? getSocketPath()
+	// Support old API: enableRemote(renderer, socketPath?)
+	const opts: EnableRemoteOptions =
+		typeof options === "string" ? { socketPath: options } : options ?? {}
+	const actualPath = opts.socketPath ?? getSocketPath()
+
+	// Derive session name from entry path
+	const name = opts.entryPath ? deriveSessionName(opts.entryPath) : undefined
 
 	// Create session implementation from renderer
 	const session: TuiSessionImpl = {
@@ -41,6 +77,8 @@ export function enableRemote(
 			pid: process.pid,
 			width: renderer.width,
 			height: renderer.height,
+			entryPath: opts.entryPath,
+			name,
 		}),
 	}
 

package/src/renderer/input/InputProcessor.ts

@@ -7,6 +7,7 @@ export interface InputProcessorConfig {
 	dispatchPaste: (text: string) => void
 	flushSync: <T>(fn: () => T) => T
 	onInputProcessed: () => void
+	onQuit?: () => void // Called instead of process.exit() for proper cleanup
 }
 
 /**
@@ -86,7 +87,11 @@ export class InputProcessor {
 				// Default Ctrl+C handling - exit unless user called preventDefault()
 				// Only match Ctrl+C (not Ctrl+Shift+C which should be available for copy)
 				if (this.config.exitOnCtrlC && !wrapped.defaultPrevented && event.ctrl && !event.shift && event.text === "c") {
-					process.exit(0)
+					if (this.config.onQuit) {
+						this.config.onQuit()
+					} else {
+						process.exit(0)
+					}
 				}
 			}
 		}