@rezi-ui/ink-compat 0.1.0-alpha.6 → 0.1.0-alpha.60

package/README.md

@@ -0,0 +1,182 @@
+# @rezi-ui/ink-compat
+
+`@rezi-ui/ink-compat` is an Ink API compatibility layer powered by Rezi.
+
+It keeps the Ink component/hook model, but replaces Ink's renderer backend with
+Rezi's deterministic layout + draw pipeline.
+
+## Why use it
+
+- Keep existing Ink app code and mental model.
+- Migrate incrementally (explicit import swap or package aliasing).
+- Get deterministic, env-gated diagnostics for parity and performance triage.
+
+## Install
+
+```bash
+npm install @rezi-ui/ink-compat
+```
+
+If your app uses `ink-gradient` or `ink-spinner`, install matching shims:
+
+```bash
+npm install ink-gradient-shim ink-spinner-shim
+```
+
+## Migration options
+
+### Option A: explicit import swap
+
+```ts
+// Before
+import { render, Box, Text } from "ink";
+
+// After
+import { render, Box, Text } from "@rezi-ui/ink-compat";
+```
+
+### Option B: no-source-change package aliasing
+
+Keep `import "ink"` in app code and alias dependencies:
+
+```bash
+npm install \
+  ink@npm:@rezi-ui/ink-compat@latest \
+  ink-gradient@npm:ink-gradient-shim@latest \
+  ink-spinner@npm:ink-spinner-shim@latest
+```
+
+Equivalent with `pnpm`:
+
+```bash
+pnpm add \
+  ink@npm:@rezi-ui/ink-compat@latest \
+  ink-gradient@npm:ink-gradient-shim@latest \
+  ink-spinner@npm:ink-spinner-shim@latest
+```
+
+Equivalent with `yarn`:
+
+```bash
+yarn add \
+  ink@npm:@rezi-ui/ink-compat@latest \
+  ink-gradient@npm:ink-gradient-shim@latest \
+  ink-spinner@npm:ink-spinner-shim@latest
+```
+
+## Verify wiring (avoid silent fallback to real Ink)
+
+Run this in the app root:
+
+```bash
+node -e "const p=require('ink/package.json'); if(p.name!=='@rezi-ui/ink-compat') throw new Error('ink resolves to '+p.name); console.log('ink-compat active:', p.version);"
+```
+
+And confirm resolved path:
+
+```bash
+node -e "const fs=require('node:fs'); const path=require('node:path'); const pkg=require.resolve('ink/package.json'); console.log(fs.realpathSync(path.dirname(pkg)));"
+```
+
+## How it works
+
+At runtime, ink-compat runs this pipeline:
+
+1. React reconciles to an `InkHostNode` tree (compat host config).
+2. Translation maps Ink props/components to Rezi VNodes.
+3. Rezi layout + render generate draw ops, then ANSI output is serialized to terminal streams.
+
+Key behavior:
+
+- `<Static>` is handled as a dedicated scrollback-oriented channel.
+- Input/focus/cursor are bridged through compat context/hooks.
+- Diagnostics and heavy instrumentation are env-gated.
+
+For full architecture details, see `https://rezitui.dev/docs/architecture/ink-compat/`.
+For a practical migration workflow, see `https://rezitui.dev/docs/migration/ink-to-ink-compat/`.
+
+## Supported API surface
+
+### Components
+
+- `Box`
+- `Text`
+- `Newline`
+- `Spacer`
+- `Static`
+- `Transform`
+
+### Hooks
+
+- `useApp`
+- `useInput`
+- `useFocus`
+- `useFocusManager`
+- `useStdin`
+- `useStdout`
+- `useStderr`
+- `useIsScreenReaderEnabled`
+- `useCursor`
+
+### Runtime APIs
+
+- `render`
+- `renderToString`
+- `measureElement`
+- `ResizeObserver`
+- `getBoundingBox`
+- `getInnerHeight`
+- `getScrollHeight`
+
+### Keyboard helpers
+
+- `kittyFlags`
+- `kittyModifiers`
+
+### Testing entrypoint
+
+- `@rezi-ui/ink-compat/testing`
+
+## `render(element, options)` options
+
+- `stdout`, `stdin`, `stderr`
+- `exitOnCtrlC`
+- `patchConsole`
+- `debug`
+- `maxFps`
+- `concurrent` (compatibility flag; not an upstream-concurrency semantic toggle)
+- `kittyKeyboard`
+- `isScreenReaderEnabled`
+- `onRender`
+- `alternateBuffer`
+- `incrementalRendering`
+
+## Diagnostics
+
+Trace output is env-gated:
+
+- `INK_COMPAT_TRACE=1`
+- `INK_COMPAT_TRACE_FILE=/path/log`
+- `INK_COMPAT_TRACE_STDERR=1`
+- `INK_COMPAT_TRACE_DETAIL=1`
+- `INK_COMPAT_TRACE_DETAIL_FULL=1`
+- `INK_COMPAT_TRACE_ALL_FRAMES=1`
+- `INK_COMPAT_TRACE_IO=1`
+- `INK_COMPAT_TRACE_RESIZE_VERBOSE=1`
+- `INK_GRADIENT_TRACE=1`
+
+Debugging runbook:
+
+- `https://rezitui.dev/docs/dev/ink-compat-debugging/`
+
+## Known boundaries
+
+- Minor visual differences can occur across terminal emulators / OS TTY behavior.
+- App/version-specific messaging differences are expected and are not renderer bugs.
+- Gradient interpolation can differ slightly while preserving overall behavior.
+
+## Documentation
+
+- Porting guide: `https://rezitui.dev/docs/migration/ink-to-ink-compat/`
+- Architecture and internals: `https://rezitui.dev/docs/architecture/ink-compat/`
+- Debugging and parity runbook: `https://rezitui.dev/docs/dev/ink-compat-debugging/`

package/dist/_bench_layout_profile.d.ts

@@ -0,0 +1,16 @@
+export declare const layoutCounters: {
+    layoutNodeCalls: number;
+    measureNodeCalls: number;
+    measureCacheHits: number;
+    layoutCacheHits: number;
+    constraintPassCount: number;
+    textMeasureCalls: number;
+    textMeasureTotalChars: number;
+    textMeasureTotalMs: number;
+    stackLayoutCalls: number;
+    leafLayoutCalls: number;
+    frameCount: number;
+};
+export declare function resetLayoutCounters(): void;
+export declare function dumpLayoutCounters(label: string): string;
+//# sourceMappingURL=_bench_layout_profile.d.ts.map

package/dist/_bench_layout_profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_bench_layout_profile.d.ts","sourceRoot":"","sources":["../src/_bench_layout_profile.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,cAAc;;;;;;;;;;;;CAY1B,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,IAAI,CAY1C;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAexD"}

package/dist/_bench_layout_profile.js

@@ -0,0 +1,44 @@
+// Counters for profiling the layout pass
+export const layoutCounters = {
+    layoutNodeCalls: 0,
+    measureNodeCalls: 0,
+    measureCacheHits: 0,
+    layoutCacheHits: 0,
+    constraintPassCount: 0,
+    textMeasureCalls: 0,
+    textMeasureTotalChars: 0,
+    textMeasureTotalMs: 0,
+    stackLayoutCalls: 0,
+    leafLayoutCalls: 0,
+    frameCount: 0,
+};
+export function resetLayoutCounters() {
+    layoutCounters.layoutNodeCalls = 0;
+    layoutCounters.measureNodeCalls = 0;
+    layoutCounters.measureCacheHits = 0;
+    layoutCounters.layoutCacheHits = 0;
+    layoutCounters.constraintPassCount = 0;
+    layoutCounters.textMeasureCalls = 0;
+    layoutCounters.textMeasureTotalChars = 0;
+    layoutCounters.textMeasureTotalMs = 0;
+    layoutCounters.stackLayoutCalls = 0;
+    layoutCounters.leafLayoutCalls = 0;
+    layoutCounters.frameCount += 1;
+}
+export function dumpLayoutCounters(label) {
+    const c = layoutCounters;
+    return [
+        `=== Layout Profile: ${label} ===`,
+        `  layoutNode calls: ${c.layoutNodeCalls}`,
+        `  measureNode calls: ${c.measureNodeCalls}`,
+        `  measure cache hits: ${c.measureCacheHits}`,
+        `  layout cache hits: ${c.layoutCacheHits}`,
+        `  constraint pass count: ${c.constraintPassCount}`,
+        `  stack layout calls: ${c.stackLayoutCalls}`,
+        `  leaf layout calls: ${c.leafLayoutCalls}`,
+        `  text measure calls: ${c.textMeasureCalls}`,
+        `  text measure total chars: ${c.textMeasureTotalChars}`,
+        `  text measure total ms: ${c.textMeasureTotalMs.toFixed(3)}`,
+    ].join("\n");
+}
+//# sourceMappingURL=_bench_layout_profile.js.map

package/dist/_bench_layout_profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_bench_layout_profile.js","sourceRoot":"","sources":["../src/_bench_layout_profile.ts"],"names":[],"mappings":"AAWA,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,eAAe,EAAE,CAAC;IAClB,gBAAgB,EAAE,CAAC;IACnB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,CAAC;IACtB,gBAAgB,EAAE,CAAC;IACnB,qBAAqB,EAAE,CAAC;IACxB,kBAAkB,EAAE,CAAC;IACrB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,CAAC;IAClB,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,MAAM,UAAU,mBAAmB;IACjC,cAAc,CAAC,eAAe,GAAG,CAAC,CAAC;IACnC,cAAc,CAAC,gBAAgB,GAAG,CAAC,CAAC;IACpC,cAAc,CAAC,gBAAgB,GAAG,CAAC,CAAC;IACpC,cAAc,CAAC,eAAe,GAAG,CAAC,CAAC;IACnC,cAAc,CAAC,mBAAmB,GAAG,CAAC,CAAC;IACvC,cAAc,CAAC,gBAAgB,GAAG,CAAC,CAAC;IACpC,cAAc,CAAC,qBAAqB,GAAG,CAAC,CAAC;IACzC,cAAc,CAAC,kBAAkB,GAAG,CAAC,CAAC;IACtC,cAAc,CAAC,gBAAgB,GAAG,CAAC,CAAC;IACpC,cAAc,CAAC,eAAe,GAAG,CAAC,CAAC;IACnC,cAAc,CAAC,UAAU,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,CAAC,GAAG,cAAc,CAAC;IACzB,OAAO;QACL,uBAAuB,KAAK,MAAM;QAClC,uBAAuB,CAAC,CAAC,eAAe,EAAE;QAC1C,wBAAwB,CAAC,CAAC,gBAAgB,EAAE;QAC5C,yBAAyB,CAAC,CAAC,gBAAgB,EAAE;QAC7C,wBAAwB,CAAC,CAAC,eAAe,EAAE;QAC3C,4BAA4B,CAAC,CAAC,mBAAmB,EAAE;QACnD,yBAAyB,CAAC,CAAC,gBAAgB,EAAE;QAC7C,wBAAwB,CAAC,CAAC,eAAe,EAAE;QAC3C,yBAAyB,CAAC,CAAC,gBAAgB,EAAE;QAC7C,+BAA+B,CAAC,CAAC,qBAAqB,EAAE;QACxD,4BAA4B,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;KAC9D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/components/Box.d.ts

@@ -1,86 +1,86 @@
 import React from "react";
-import type { DOMElement } from "../types.js";
-/**
- * Ink-compatible `<Box>` component.
- *
- * We render a host element (`"ink-box"`) that is interpreted by this package's
- * custom reconciler and converted into Rezi VNodes.
- */
-declare const Box: React.ForwardRefExoticComponent<Readonly<{
-    position?: "absolute" | "relative";
-    columnGap?: number;
-    rowGap?: number;
-    gap?: number;
-    margin?: number;
-    marginX?: number;
-    marginY?: number;
-    marginTop?: number;
-    marginBottom?: number;
-    marginLeft?: number;
-    marginRight?: number;
-    padding?: number;
-    paddingX?: number;
-    paddingY?: number;
-    paddingTop?: number;
-    paddingBottom?: number;
-    paddingLeft?: number;
-    paddingRight?: number;
+import type { InkHostNode } from "../reconciler/types.js";
+type InkBorderStyleName = "single" | "double" | "round" | "bold" | "singleDouble" | "doubleSingle" | "classic" | "arrow";
+export interface BoxProps {
+    flexDirection?: "row" | "row-reverse" | "column" | "column-reverse";
     flexGrow?: number;
     flexShrink?: number;
-    flexDirection?: "row" | "column" | "row-reverse" | "column-reverse";
     flexBasis?: number | string;
     flexWrap?: "nowrap" | "wrap" | "wrap-reverse";
     alignItems?: "flex-start" | "center" | "flex-end" | "stretch";
-    alignSelf?: "flex-start" | "center" | "flex-end" | "auto";
-    justifyContent?: "flex-start" | "flex-end" | "space-between" | "space-around" | "space-evenly" | "center";
+    alignSelf?: "auto" | "flex-start" | "center" | "flex-end";
+    justifyContent?: "flex-start" | "center" | "flex-end" | "space-between" | "space-around" | "space-evenly";
+    display?: "flex" | "none";
     width?: number | string;
     height?: number | string;
     minWidth?: number | string;
+    /** @jrichman/ink fork: non-upstream extension used by Gemini CLI tab headers */
     maxWidth?: number | string;
     minHeight?: number | string;
     maxHeight?: number | string;
-    display?: "flex" | "none";
-    borderStyle?: string;
-    borderTop?: boolean;
-    borderBottom?: boolean;
-    borderLeft?: boolean;
-    borderRight?: boolean;
+    position?: "relative" | "absolute";
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+    padding?: number;
+    paddingX?: number;
+    paddingY?: number;
+    paddingTop?: number;
+    paddingRight?: number;
+    paddingBottom?: number;
+    paddingLeft?: number;
+    margin?: number;
+    marginX?: number;
+    marginY?: number;
+    marginTop?: number;
+    marginRight?: number;
+    marginBottom?: number;
+    marginLeft?: number;
+    gap?: number;
+    columnGap?: number;
+    rowGap?: number;
+    /** @jrichman/ink fork: supports custom border glyph maps in addition to named styles */
+    borderStyle?: InkBorderStyleName | Record<string, string>;
     borderColor?: string;
     borderTopColor?: string;
+    borderRightColor?: string;
     borderBottomColor?: string;
     borderLeftColor?: string;
-    borderRightColor?: string;
     borderDimColor?: boolean;
     borderTopDimColor?: boolean;
+    borderRightDimColor?: boolean;
     borderBottomDimColor?: boolean;
     borderLeftDimColor?: boolean;
-    borderRightDimColor?: boolean;
+    borderTop?: boolean;
+    borderRight?: boolean;
+    borderBottom?: boolean;
+    borderLeft?: boolean;
+    backgroundColor?: string;
+    ariaLabel?: string;
+    "aria-label"?: string;
+    accessibilityLabel?: string;
     overflow?: "visible" | "hidden" | "scroll";
     overflowX?: "visible" | "hidden" | "scroll";
     overflowY?: "visible" | "hidden" | "scroll";
-    backgroundColor?: string;
-    scrollTop?: number;
+    /** @jrichman/ink fork: horizontal scroll offset */
     scrollLeft?: number;
+    /** @jrichman/ink fork: vertical scroll offset */
+    scrollTop?: number;
+    /** @jrichman/ink fork: scrollbar thumb color */
     scrollbarThumbColor?: string;
-    userSelect?: "auto" | "none" | "text" | "all";
-    "aria-label"?: string;
-    "aria-hidden"?: boolean;
-    "aria-role"?: "button" | "checkbox" | "combobox" | "list" | "listbox" | "listitem" | "menu" | "menuitem" | "option" | "progressbar" | "radio" | "radiogroup" | "tab" | "tablist" | "table" | "textbox" | "timer" | "toolbar";
-    "aria-state"?: Readonly<{
-        busy?: boolean;
-        checked?: boolean;
-        disabled?: boolean;
-        expanded?: boolean;
-        multiline?: boolean;
-        multiselectable?: boolean;
-        readonly?: boolean;
-        required?: boolean;
-        selected?: boolean;
-    }>;
+    /** @jrichman/ink fork: make this box opaque (paints background over content below) */
     opaque?: boolean;
+    /** @jrichman/ink fork: pin this box to the top of its parent (sticky header) */
     sticky?: boolean;
+    /** @jrichman/ink fork: children rendered inside the sticky area */
     stickyChildren?: React.ReactNode;
     children?: React.ReactNode;
-}> & React.RefAttributes<DOMElement>>;
-export default Box;
+    ref?: React.Ref<InkHostNode>;
+}
+export declare const Box: {
+    (props: BoxProps): React.ReactElement;
+    displayName: string;
+};
+export {};
 //# sourceMappingURL=Box.d.ts.map

package/dist/components/Box.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Box.d.ts","sourceRoot":"","sources":["../../src/components/Box.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAY,UAAU,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;GAKG;AACH,QAAA,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YASuiF,CAAC;eAAsB,CAAC;gBAAuB,CAAC;gBAAuB,CAAC;iBAAwB,CAAC;uBAA8B,CAAC;gBAAuB,CAAC;gBAAuB,CAAC;gBAAuB,CAAC;;;;;;qCALtvF,CAAC;AAIH,eAAe,GAAG,CAAC"}
+{"version":3,"file":"Box.d.ts","sourceRoot":"","sources":["../../src/components/Box.ts"],"names":[],"mappings":"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"}

package/dist/components/Box.js

@@ -1,15 +1,6 @@
 import React from "react";
-/**
- * Ink-compatible `<Box>` component.
- *
- * We render a host element (`"ink-box"`) that is interpreted by this package's
- * custom reconciler and converted into Rezi VNodes.
- */
-const Box = React.forwardRef((props, ref) => {
-    const { children, ...rest } = props;
-    // `ref` is accepted for compatibility but currently unused.
-    return React.createElement("ink-box", { ...rest, ref }, children);
-});
+export const Box = (props) => {
+    return React.createElement("ink-box", { ...props });
+};
 Box.displayName = "Box";
-export default Box;
 //# sourceMappingURL=Box.js.map

package/dist/components/Box.js.map

@@ -1 +1 @@
-{"version":3,"file":"Box.js","sourceRoot":"","sources":["../../src/components/Box.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;;;GAKG;AACH,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAuB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACpC,4DAA4D;IAC5D,OAAO,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC;AAExB,eAAe,GAAG,CAAC"}
+{"version":3,"file":"Box.js","sourceRoot":"","sources":["../../src/components/Box.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AA4G1B,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,KAAe,EAAsB,EAAE;IACzD,OAAO,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC"}

package/dist/components/Newline.d.ts

@@ -1,16 +1,6 @@
 import React from "react";
-export type Props = Readonly<{
-    /**
-     * Number of newlines to insert.
-     *
-     * @default 1
-     */
+export interface NewlineProps {
     count?: number;
-}>;
-/**
- * Ink-compatible `<Newline>` component.
- *
- * Adds one or more newline (`\n`) characters. Intended to be used within `<Text>`.
- */
-export default function Newline({ count }: Props): React.JSX.Element;
+}
+export declare const Newline: React.FC<NewlineProps>;
 //# sourceMappingURL=Newline.d.ts.map

package/dist/components/Newline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Newline.d.ts","sourceRoot":"","sources":["../../src/components/Newline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC3B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,KAAS,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAEvE"}
+{"version":3,"file":"Newline.d.ts","sourceRoot":"","sources":["../../src/components/Newline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAE1C,CAAC"}

package/dist/components/Newline.js

@@ -1,10 +1,6 @@
 import React from "react";
-/**
- * Ink-compatible `<Newline>` component.
- *
- * Adds one or more newline (`\n`) characters. Intended to be used within `<Text>`.
- */
-export default function Newline({ count = 1 }) {
-    return React.createElement("ink-text", null, "\n".repeat(count));
-}
+export const Newline = ({ count = 1 }) => {
+    return React.createElement("ink-virtual", { __inkType: "newline", count });
+};
+Newline.displayName = "Newline";
 //# sourceMappingURL=Newline.js.map

package/dist/components/Newline.js.map

@@ -1 +1 @@
-{"version":3,"file":"Newline.js","sourceRoot":"","sources":["../../src/components/Newline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,KAAK,GAAG,CAAC,EAAS;IAClD,OAAO,KAAK,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"Newline.js","sourceRoot":"","sources":["../../src/components/Newline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,MAAM,CAAC,MAAM,OAAO,GAA2B,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE;IAC/D,OAAO,KAAK,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEF,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC"}

package/dist/components/Spacer.d.ts

@@ -1,9 +1,3 @@
 import React from "react";
-/**
- * Ink-compatible `<Spacer>` component.
- *
- * Ink implements this as `<Box flexGrow={1} />`. For Rezi, we map it directly
- * to a spacer node to avoid creating unnecessary layout containers.
- */
-export default function Spacer(): React.JSX.Element;
+export declare const Spacer: React.FC;
 //# sourceMappingURL=Spacer.d.ts.map

package/dist/components/Spacer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Spacer.d.ts","sourceRoot":"","sources":["../../src/components/Spacer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAElD"}
+{"version":3,"file":"Spacer.d.ts","sourceRoot":"","sources":["../../src/components/Spacer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,EAE1B,CAAC"}

package/dist/components/Spacer.js

@@ -1,11 +1,6 @@
 import React from "react";
-/**
- * Ink-compatible `<Spacer>` component.
- *
- * Ink implements this as `<Box flexGrow={1} />`. For Rezi, we map it directly
- * to a spacer node to avoid creating unnecessary layout containers.
- */
-export default function Spacer() {
-    return React.createElement("ink-spacer", null);
-}
+export const Spacer = () => {
+    return React.createElement("ink-box", { __inkType: "spacer", flexGrow: 1 });
+};
+Spacer.displayName = "Spacer";
 //# sourceMappingURL=Spacer.js.map

package/dist/components/Spacer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Spacer.js","sourceRoot":"","sources":["../../src/components/Spacer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM;IAC5B,OAAO,KAAK,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"Spacer.js","sourceRoot":"","sources":["../../src/components/Spacer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAa,GAAG,EAAE;IACnC,OAAO,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC"}

package/dist/components/Static.d.ts

@@ -1,29 +1,15 @@
-import React, { type ReactNode } from "react";
-import type { BoxProps } from "../types.js";
-type BoxStyleProps = Omit<BoxProps, "children">;
-export type Props<T> = Readonly<{
-    /**
-     * Array of items of any type to render using a function you pass as a component child.
-     */
-    items: readonly T[];
-    /**
-     * Styles to apply to a container of child elements. See `<Box>` for supported properties.
-     */
-    style?: BoxStyleProps;
-    /**
-     * Function that is called to render every item in `items` array.
-     * First argument is an item itself and second argument is index of that item in `items` array.
-     * Note that `key` must be assigned to the root component.
-     */
-    children: (item: T, index: number) => ReactNode;
-}>;
+import React from "react";
+export interface StaticProps<T> {
+    items: T[];
+    children: (item: T, index: number) => React.ReactNode;
+    style?: Record<string, unknown>;
+}
 /**
- * Ink-compatible `<Static>` component.
- *
- * Ink's implementation relies on static output being rendered separately and left on the terminal.
- * Rezi re-renders the full framebuffer, so we emulate Ink semantics by accumulating static nodes
- * in the renderer layer (see `internal_static` handling in the compat reconciler).
+ * <Static> renders items once. This implementation marks the subtree as static
+ * so renderers can treat it as scrollback-oriented output.
  */
-export default function Static<T>(props: Props<T>): React.JSX.Element;
-export {};
+export declare function Static<T>(props: StaticProps<T>): React.ReactElement;
+export declare namespace Static {
+    var displayName: string;
+}
 //# sourceMappingURL=Static.d.ts.map

package/dist/components/Static.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Static.d.ts","sourceRoot":"","sources":["../../src/components/Static.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,KAAK,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAEhD,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC9B;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;CACjD,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAsBpE"}
+{"version":3,"file":"Static.d.ts","sourceRoot":"","sources":["../../src/components/Static.ts"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CA6BnE;yBA7Be,MAAM"}

package/dist/components/Static.js

@@ -1,24 +1,23 @@
 import React, { useLayoutEffect, useMemo, useState } from "react";
 /**
- * Ink-compatible `<Static>` component.
- *
- * Ink's implementation relies on static output being rendered separately and left on the terminal.
- * Rezi re-renders the full framebuffer, so we emulate Ink semantics by accumulating static nodes
- * in the renderer layer (see `internal_static` handling in the compat reconciler).
+ * <Static> renders items once. This implementation marks the subtree as static
+ * so renderers can treat it as scrollback-oriented output.
  */
-export default function Static(props) {
-    const { items, children: render, style: customStyle } = props;
+export function Static(props) {
+    const { items, children: renderItem, style } = props;
     const [index, setIndex] = useState(0);
-    const itemsToRender = useMemo(() => items.slice(index), [items, index]);
+    const itemsToRender = useMemo(() => {
+        return items.slice(index);
+    }, [items, index]);
     useLayoutEffect(() => {
         setIndex(items.length);
     }, [items.length]);
-    const children = itemsToRender.map((item, itemIndex) => render(item, index + itemIndex));
-    const style = useMemo(() => ({
+    const staticStyle = {
+        ...(style ?? {}),
         position: "absolute",
         flexDirection: "column",
-        ...(customStyle ?? {}),
-    }), [customStyle]);
-    return React.createElement("ink-box", { internal_static: true, ...style }, children);
+    };
+    return React.createElement("ink-box", { __inkStatic: true, ...staticStyle }, ...itemsToRender.map((item, itemIndex) => React.createElement(React.Fragment, { key: `${index}:${itemIndex}` }, renderItem(item, index + itemIndex))));
 }
+Static.displayName = "Static";
 //# sourceMappingURL=Static.js.map

package/dist/components/Static.js.map

@@ -1 +1 @@
-{"version":3,"file":"Static.js","sourceRoot":"","sources":["../../src/components/Static.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAsBlF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAI,KAAe;IAC/C,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAC9D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAExE,eAAe,CAAC,GAAG,EAAE;QACnB,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnB,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC;IAEzF,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE,UAAmB;QAC7B,aAAa,EAAE,QAAiB;QAChC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;KACvB,CAAC,EACF,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,OAAO,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AACvF,CAAC"}
+{"version":3,"file":"Static.js","sourceRoot":"","sources":["../../src/components/Static.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAQlE;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAI,KAAqB;IAC7C,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE;QACjC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnB,eAAe,CAAC,GAAG,EAAE;QACnB,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnB,MAAM,WAAW,GAA4B;QAC3C,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QAChB,QAAQ,EAAE,UAAU;QACpB,aAAa,EAAE,QAAQ;KACxB,CAAC;IAEF,OAAO,KAAK,CAAC,aAAa,CACxB,SAAS,EACT,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,EACrC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CACvC,KAAK,CAAC,aAAa,CACjB,KAAK,CAAC,QAAQ,EACd,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,SAAS,EAAE,EAAE,EAChC,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC,CACpC,CACF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC"}