@opentui/react 0.1.12 → 0.1.14

package/README.md

@@ -15,12 +15,12 @@ import { render } from "@opentui/react"
 
 function App() {
   return (
-    <group>
+    <box>
       <text fg="#00FF00">Hello, Terminal!</text>
       <box title="Welcome" padding={2}>
-        <text>Welcome to OpenTUI with React!"</text>
+        <text>Welcome to OpenTUI with React!</text>
       </box>
-    </group>
+    </box>
   )
 }
 
@@ -35,7 +35,6 @@ OpenTUI React provides several built-in components that map to OpenTUI core rend
 
 - **`<text>`** - Display text with styling
 - **`<box>`** - Container with borders and layout
-- **`<group>`** - Layout container for organizing components
 - **`<input>`** - Text input field
 - **`<select>`** - Selection dropdown
 - **`<tab-select>`** - Tab-based selection
@@ -147,14 +146,14 @@ function MyComponent() {
   const { width, height } = useTerminalDimensions()
 
   return (
-    <group>
+    <box>
       <text>
         Terminal dimensions: {width}x{height}
       </text>
       <box style={{ width: Math.floor(width / 2), height: Math.floor(height / 3) }}>
         <text>Half-width, third-height box</text>
       </box>
-    </group>
+    </box>
   )
 }
 ```
@@ -172,7 +171,7 @@ import { bold, fg, t } from "@opentui/core"
 
 function TextExample() {
   return (
-    <group>
+    <box>
       {/* Simple text */}
       <text>Hello World</text>
 
@@ -181,7 +180,7 @@ function TextExample() {
 
       {/* Template literals */}
       <text>{t`${bold("Bold")} and ${fg("blue")("Blue")}`}</text>
-    </group>
+    </box>
   )
 }
 ```
@@ -193,7 +192,7 @@ Container with borders and layout capabilities.
 ```tsx
 function BoxExample() {
   return (
-    <group flexDirection="column">
+    <box flexDirection="column">
       {/* Basic box */}
       <box>
         <text>Simple box</text>
@@ -216,26 +215,7 @@ function BoxExample() {
       >
         <text>Centered content</text>
       </box>
-    </group>
-  )
-}
-```
-
-### Group Component
-
-Layout container for organizing multiple components.
-
-```tsx
-function GroupExample() {
-  return (
-    <group flexDirection="row">
-      <box>
-        <text>Left</text>
-      </box>
-      <box>
-        <text>Right</text>
-      </box>
-    </group>
+    </box>
   )
 }
 ```
@@ -318,7 +298,7 @@ function ASCIIFontExample() {
   })
 
   return (
-    <group style={{ paddingLeft: 1, paddingRight: 1 }}>
+    <box style={{ paddingLeft: 1, paddingRight: 1 }}>
       <box
         style={{
           height: 8,
@@ -356,7 +336,7 @@ function ASCIIFontExample() {
       </box>
 
       <ascii-font style={{ width, height }} text={text} font={font} />
-    </group>
+    </box>
   )
 }
 ```
@@ -390,7 +370,7 @@ function LoginForm() {
   }, [username, password])
 
   return (
-    <group style={{ padding: 2, flexDirection: "column" }}>
+    <box style={{ padding: 2, flexDirection: "column" }}>
       <text fg="#FFFF00">Login Form</text>
 
       <box title="Username" style={{ width: 40, height: 3, marginTop: 1 }}>
@@ -418,7 +398,7 @@ function LoginForm() {
       >
         {status.toUpperCase()}
       </text>
-    </group>
+    </box>
   )
 }
 
@@ -460,7 +440,7 @@ import { render } from "@opentui/react"
 
 function StyledTextShowcase() {
   return (
-    <group style={{ flexDirection: "column" }}>
+    <box style={{ flexDirection: "column" }}>
       <text>Simple text</text>
       <text>{bold("Bold text")}</text>
       <text>{underline("Underlined text")}</text>
@@ -468,7 +448,7 @@ function StyledTextShowcase() {
       <text>{blue("Blue text")}</text>
       <text>{bold(red("Bold red text"))}</text>
       <text>{t`${bold("Bold")} and ${blue("blue")} combined`}</text>
-    </group>
+    </box>
   )
 }
 
@@ -504,7 +484,7 @@ class ButtonRenderable extends BoxRenderable {
 
   set label(value: string) {
     this._label = value
-    this.needsUpdate()
+    this.requestRender()
   }
 }
 
@@ -521,10 +501,10 @@ extend({ button: ButtonRenderable })
 // Use in JSX
 function App() {
   return (
-    <group>
+    <box>
       <button label="Click me!" style={{ backgroundColor: "blue" }} />
       <button label="Another button" style={{ backgroundColor: "green" }} />
-    </group>
+    </box>
   )
 }
 

package/index.js

@@ -3,7 +3,6 @@
 import {
   ASCIIFontRenderable,
   BoxRenderable,
-  GroupRenderable,
   InputRenderable,
   SelectRenderable,
   TabSelectRenderable,
@@ -12,7 +11,6 @@ import {
 var baseComponents = {
   box: BoxRenderable,
   text: TextRenderable,
-  group: GroupRenderable,
   input: InputRenderable,
   select: SelectRenderable,
   "ascii-font": ASCIIFontRenderable,
@@ -36,14 +34,30 @@ var useAppContext = () => {
 };
 // src/hooks/use-keyboard.tsx
 import { useEffect } from "react";
+
+// src/hooks/use-event.tsx
+import { useCallback, useLayoutEffect, useRef } from "react";
+function useEvent(handler) {
+  const handlerRef = useRef(handler);
+  useLayoutEffect(() => {
+    handlerRef.current = handler;
+  });
+  return useCallback((...args) => {
+    const fn = handlerRef.current;
+    return fn(...args);
+  }, []);
+}
+
+// src/hooks/use-keyboard.tsx
 var useKeyboard = (handler) => {
   const { keyHandler } = useAppContext();
+  const stableHandler = useEvent(handler);
   useEffect(() => {
-    keyHandler?.on("keypress", handler);
+    keyHandler?.on("keypress", stableHandler);
     return () => {
-      keyHandler?.off("keypress", handler);
+      keyHandler?.off("keypress", stableHandler);
     };
-  }, [keyHandler, handler]);
+  }, [keyHandler, stableHandler]);
 };
 // src/hooks/use-renderer.tsx
 var useRenderer = () => {
@@ -70,8 +84,8 @@ import { useState } from "react";
 var useTerminalDimensions = () => {
   const renderer = useRenderer();
   const [dimensions, setDimensions] = useState({
-    width: renderer.terminalWidth,
-    height: renderer.terminalHeight
+    width: renderer.width,
+    height: renderer.height
   });
   const cb = (width, height) => {
     setDimensions({ width, height });
@@ -289,7 +303,7 @@ var hostConfig = {
     return null;
   },
   resetAfterCommit(containerInfo) {
-    containerInfo.needsUpdate();
+    containerInfo.requestRender();
   },
   getRootHostContext(rootContainerInstance) {
     return {};
@@ -323,11 +337,11 @@ var hostConfig = {
   commitMount(instance, type, props, internalInstanceHandle) {},
   commitUpdate(instance, type, oldProps, newProps, internalInstanceHandle) {
     updateProperties(instance, type, oldProps, newProps);
-    instance.needsUpdate();
+    instance.requestRender();
   },
   commitTextUpdate(textInstance, oldText, newText) {
     textInstance.content = newText;
-    textInstance.needsUpdate();
+    textInstance.requestRender();
   },
   appendChildToContainer(container, child) {
     container.add(child);
@@ -337,19 +351,19 @@ var hostConfig = {
   },
   hideInstance(instance) {
     instance.visible = false;
-    instance.needsUpdate();
+    instance.requestRender();
   },
   unhideInstance(instance, props) {
     instance.visible = true;
-    instance.needsUpdate();
+    instance.requestRender();
   },
   hideTextInstance(textInstance) {
     textInstance.visible = false;
-    textInstance.needsUpdate();
+    textInstance.requestRender();
   },
   unhideTextInstance(textInstance, text) {
     textInstance.visible = true;
-    textInstance.needsUpdate();
+    textInstance.requestRender();
   },
   clearContainer(container) {
     const children = container.getChildren();

package/jsx-namespace.d.ts

@@ -2,7 +2,6 @@ import type * as React from "react"
 import type {
   AsciiFontProps,
   BoxProps,
-  GroupProps,
   InputProps,
   SelectProps,
   TabSelectProps,
@@ -28,7 +27,6 @@ export namespace JSX {
   interface IntrinsicElements extends React.JSX.IntrinsicElements, ExtendedIntrinsicElements<OpenTUIComponents> {
     box: BoxProps
     text: TextProps
-    group: GroupProps
     input: InputProps
     select: SelectProps
     "ascii-font": AsciiFontProps

package/package.json

@@ -4,7 +4,7 @@
   "main": "index.js",
   "types": "src/index.d.ts",
   "type": "module",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "React renderer for building terminal user interfaces using OpenTUI core",
   "license": "MIT",
   "repository": {
@@ -35,7 +35,7 @@
     }
   },
   "dependencies": {
-    "@opentui/core": "0.1.12",
+    "@opentui/core": "0.1.14",
     "react-reconciler": "^0.32.0"
   },
   "devDependencies": {

package/src/components/index.d.ts

@@ -1,9 +1,8 @@
-import { ASCIIFontRenderable, BoxRenderable, GroupRenderable, InputRenderable, SelectRenderable, TabSelectRenderable, TextRenderable } from "@opentui/core";
+import { ASCIIFontRenderable, BoxRenderable, InputRenderable, SelectRenderable, TabSelectRenderable, TextRenderable } from "@opentui/core";
 import type { RenderableConstructor } from "../types/components";
 export declare const baseComponents: {
     box: typeof BoxRenderable;
     text: typeof TextRenderable;
-    group: typeof GroupRenderable;
     input: typeof InputRenderable;
     select: typeof SelectRenderable;
     "ascii-font": typeof ASCIIFontRenderable;

package/src/hooks/use-event.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a stable callback that always calls the latest version of the provided handler.
+ * This prevents unnecessary re-renders and effect re-runs while ensuring the callback
+ * always has access to the latest props and state.
+ *
+ * Useful for event handlers that need to be passed to effects with empty dependency arrays
+ * or memoized child components.
+ */
+export declare function useEvent<T extends (...args: any[]) => any>(handler: T): T;

package/src/reconciler/renderer.js

@@ -22,7 +22,6 @@ import { DefaultEventPriority, NoEventPriority } from "react-reconciler/constant
 import {
   ASCIIFontRenderable,
   BoxRenderable,
-  GroupRenderable,
   InputRenderable,
   SelectRenderable,
   TabSelectRenderable,
@@ -31,7 +30,6 @@ import {
 var baseComponents = {
   box: BoxRenderable,
   text: TextRenderable,
-  group: GroupRenderable,
   input: InputRenderable,
   select: SelectRenderable,
   "ascii-font": ASCIIFontRenderable,
@@ -240,7 +238,7 @@ var hostConfig = {
     return null;
   },
   resetAfterCommit(containerInfo) {
-    containerInfo.needsUpdate();
+    containerInfo.requestRender();
   },
   getRootHostContext(rootContainerInstance) {
     return {};
@@ -274,11 +272,11 @@ var hostConfig = {
   commitMount(instance, type, props, internalInstanceHandle) {},
   commitUpdate(instance, type, oldProps, newProps, internalInstanceHandle) {
     updateProperties(instance, type, oldProps, newProps);
-    instance.needsUpdate();
+    instance.requestRender();
   },
   commitTextUpdate(textInstance, oldText, newText) {
     textInstance.content = newText;
-    textInstance.needsUpdate();
+    textInstance.requestRender();
   },
   appendChildToContainer(container, child) {
     container.add(child);
@@ -288,19 +286,19 @@ var hostConfig = {
   },
   hideInstance(instance) {
     instance.visible = false;
-    instance.needsUpdate();
+    instance.requestRender();
   },
   unhideInstance(instance, props) {
     instance.visible = true;
-    instance.needsUpdate();
+    instance.requestRender();
   },
   hideTextInstance(textInstance) {
     textInstance.visible = false;
-    textInstance.needsUpdate();
+    textInstance.requestRender();
   },
   unhideTextInstance(textInstance, text) {
     textInstance.visible = true;
-    textInstance.needsUpdate();
+    textInstance.requestRender();
   },
   clearContainer(container) {
     const children = container.getChildren();

package/src/types/components.d.ts

@@ -1,4 +1,4 @@
-import type { ASCIIFontOptions, ASCIIFontRenderable, BoxOptions, BoxRenderable, GroupRenderable, InputRenderable, InputRenderableOptions, Renderable, RenderableOptions, RenderContext, SelectOption, SelectRenderable, SelectRenderableOptions, StyledText, TabSelectOption, TabSelectRenderable, TabSelectRenderableOptions, TextChunk, TextOptions, TextRenderable } from "@opentui/core";
+import type { ASCIIFontOptions, ASCIIFontRenderable, BoxOptions, BoxRenderable, InputRenderable, InputRenderableOptions, Renderable, RenderableOptions, RenderContext, SelectOption, SelectRenderable, SelectRenderableOptions, StyledText, TabSelectOption, TabSelectRenderable, TabSelectRenderableOptions, TextChunk, TextOptions, TextRenderable } from "@opentui/core";
 import type React from "react";
 /** Properties that should not be included in the style prop */
 export type NonStyledProps = "id" | "buffered" | "live" | "enableLayout" | "selectable" | "renderAfter" | "renderBefore" | `on${string}`;
@@ -29,7 +29,6 @@ export type TextProps = ComponentProps<TextOptions, TextRenderable> & {
     children?: TextChildren | StyledText | TextChunk | Array<TextChildren | StyledText | TextChunk>;
 };
 export type BoxProps = ComponentProps<ContainerProps<BoxOptions>, BoxRenderable>;
-export type GroupProps = ComponentProps<ContainerProps<RenderableOptions>, GroupRenderable>;
 export type InputProps = ComponentProps<InputRenderableOptions, InputRenderable> & {
     focused?: boolean;
     onInput?: (value: string) => void;