@taui-standard/ink-adapter 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { TAUIRuntime } from '@taui-standard/core';
+export * from './renderer.js';
+export interface TAUIAppProps {
+    runtime: TAUIRuntime;
+}
+export declare const TAUIApp: React.FC<TAUIAppProps>;
+export declare function startTAUI(runtime: TAUIRuntime): import("ink").Instance;

package/dist/index.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { render, Box, Text, useFocusManager } from 'ink';
+import { TAUIRenderer } from './renderer.js';
+export * from './renderer.js';
+export const TAUIApp = ({ runtime }) => {
+    const [doc, setDoc] = React.useState(runtime.getDocument());
+    const { focusNext, focusPrevious } = useFocusManager();
+    React.useEffect(() => {
+        return runtime.onEvent(() => {
+            setDoc({ ...runtime.getDocument() });
+        });
+    }, [runtime]);
+    // Handle global tab navigation
+    React.useEffect(() => {
+        const handleKey = (input, key) => {
+            if (key.tab) {
+                if (key.shift)
+                    focusPrevious();
+                else
+                    focusNext();
+            }
+        };
+        // Note: useInput is inside components, but we could add a global listener here if needed.
+        // However, Ink's focus manager handles Tab by default if components are wrapped in <Box focusable>.
+    }, []);
+    if (!doc)
+        return _jsx(Text, { children: "Loading..." });
+    return (_jsx(Box, { flexDirection: "column", padding: 1, children: _jsx(TAUIRenderer, { node: doc.screen, runtime: runtime }) }));
+};
+export function startTAUI(runtime) {
+    return render(_jsx(TAUIApp, { runtime: runtime }));
+}

package/dist/renderer.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { TAUINode } from '@taui-standard/validator';
+import { TAUIRuntime } from '@taui-standard/core';
+export interface RendererProps {
+    node: TAUINode;
+    runtime: TAUIRuntime;
+}
+export declare const TAUIText: React.FC<RendererProps>;
+export declare const TAUIBox: React.FC<RendererProps>;
+export declare const TAUIButton: React.FC<RendererProps>;
+export declare const TAUIInput: React.FC<RendererProps>;
+export declare const TAUIProgress: React.FC<RendererProps>;
+export declare const TAUIKeyBinding: React.FC<RendererProps>;
+export declare const TAUIRenderer: React.FC<RendererProps>;

package/dist/renderer.js

@@ -0,0 +1,97 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useInput, useFocus } from 'ink';
+import TextInput from 'ink-text-input';
+export const TAUIText = ({ node }) => {
+    if (node.type !== 'Text')
+        return null;
+    return (_jsx(Text, { color: node.style?.color, backgroundColor: node.style?.backgroundColor, bold: node.style?.bold, dimColor: node.style?.dim, italic: node.style?.italic, underline: node.style?.underline, children: node.content }));
+};
+export const TAUIBox = ({ node, runtime }) => {
+    if (!['Box', 'Row', 'Column', 'Grid', 'Panel'].includes(node.type))
+        return null;
+    const flexDirection = node.type === 'Row' ? 'row' : 'column';
+    const borderStyle = node.type === 'Panel' ? (node.borderStyle || 'single') : undefined;
+    return (_jsxs(Box, { flexDirection: flexDirection, padding: typeof node.padding === 'number' ? node.padding : undefined, gap: node.gap, borderStyle: borderStyle === 'none' ? undefined : borderStyle, children: [node.type === 'Panel' && node.title && (_jsx(Box, { position: "absolute", marginTop: -1, marginLeft: 1, paddingX: 1, children: _jsx(Text, { bold: true, children: node.title }) })), node.children?.map((child, idx) => (_jsx(TAUIRenderer, { node: child, runtime: runtime }, child.id || `${node.type}-${idx}`)))] }));
+};
+export const TAUIButton = ({ node, runtime }) => {
+    const { isFocused } = useFocus({ id: node.id });
+    useInput((input, key) => {
+        if (isFocused && (key.return || input === ' ')) {
+            runtime.dispatchRawEvent({
+                type: 'action',
+                targetId: node.id,
+                timestamp: new Date().toISOString()
+            });
+        }
+    });
+    return (_jsx(Box, { borderStyle: "round", borderColor: isFocused ? 'cyan' : 'gray', paddingX: 1, children: _jsx(Text, { color: isFocused ? 'cyan' : undefined, children: node.label }) }));
+};
+export const TAUIInput = ({ node, runtime }) => {
+    const { isFocused } = useFocus({ id: node.id });
+    const onChange = (value) => {
+        runtime.dispatchRawEvent({
+            type: 'change',
+            targetId: node.id,
+            payload: { value },
+            timestamp: new Date().toISOString()
+        });
+    };
+    return (_jsxs(Box, { flexDirection: "row", gap: 1, children: [node.placeholder && _jsxs(Text, { dimColor: true, children: [node.placeholder, ": "] }), _jsx(Box, { borderStyle: "single", borderColor: isFocused ? 'yellow' : 'gray', paddingX: 1, minWidth: 10, children: isFocused ? (_jsx(TextInput, { value: node.value || '', onChange: onChange, mask: node.mask ? '*' : undefined })) : (_jsx(Text, { children: node.mask ? '*'.repeat((node.value || '').length) : (node.value || ' ') })) })] }));
+};
+export const TAUIProgress = ({ node }) => {
+    const width = 20;
+    const val = node.value || 0;
+    const completed = Math.round(val * width);
+    const bar = '\u2588'.repeat(completed) + '\u2591'.repeat(width - completed);
+    return (_jsxs(Box, { flexDirection: "row", gap: 1, children: [node.label && _jsx(Text, { children: node.label }), _jsx(Text, { color: "cyan", children: bar }), _jsxs(Text, { children: [Math.round(val * 100), "%"] })] }));
+};
+export const TAUIKeyBinding = ({ node, runtime }) => {
+    if (node.type !== 'KeyBinding')
+        return null;
+    useInput((input, key) => {
+        const matchesKey = input === node.key ||
+            (key.return && node.key === 'enter') ||
+            (key.backspace && node.key === 'backspace') ||
+            (key.escape && node.key === 'escape') ||
+            (key.tab && node.key === 'tab') ||
+            (key.upArrow && node.key === 'up') ||
+            (key.downArrow && node.key === 'down') ||
+            (key.leftArrow && node.key === 'left') ||
+            (key.rightArrow && node.key === 'right');
+        const matchesModifiers = (!!node.ctrl === key.ctrl) &&
+            (!!node.meta === key.meta) &&
+            (!!node.shift === key.shift);
+        if (matchesKey && matchesModifiers) {
+            runtime.dispatchRawEvent({
+                type: 'key',
+                targetId: node.id || 'global',
+                payload: { key: node.key, ctrl: node.ctrl, meta: node.meta, shift: node.shift },
+                timestamp: new Date().toISOString()
+            });
+        }
+    });
+    return null;
+};
+export const TAUIRenderer = (props) => {
+    const { node } = props;
+    switch (node.type) {
+        case 'Box':
+        case 'Row':
+        case 'Column':
+        case 'Grid':
+        case 'Panel':
+            return _jsx(TAUIBox, { ...props });
+        case 'Text':
+            return _jsx(TAUIText, { ...props });
+        case 'Button':
+            return _jsx(TAUIButton, { ...props });
+        case 'Input':
+            return _jsx(TAUIInput, { ...props });
+        case 'Progress':
+            return _jsx(TAUIProgress, { ...props });
+        case 'KeyBinding':
+            return _jsx(TAUIKeyBinding, { ...props });
+        default:
+            return _jsxs(Text, { dimColor: true, children: ["Unsupported node type: ", node.type] });
+    }
+};

package/examples/basic-htop/index.ts

@@ -0,0 +1,8 @@
+import { TAUIRuntime } from '@taui-standard/core';
+import { startTAUI } from '@taui-standard/ink-adapter';
+import htopDoc from '../../taui-standards/examples/htop.json';
+
+const runtime = new TAUIRuntime();
+runtime.setDocument(htopDoc);
+
+startTAUI(runtime);

package/examples/basic-htop/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "example-htop",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "tsx index.ts"
+  },
+  "dependencies": {
+    "@taui-standard/core": "0.0.1",
+    "@taui-standard/ink-adapter": "0.0.1",
+    "@taui-standard/validator": "0.0.1",
+    "tsx": "^4.7.0"
+  }
+}

package/examples/interactive-dashboard/index.ts

@@ -0,0 +1,89 @@
+import { TAUIRuntime } from '@taui-standard/core';
+import { startTAUI } from '@taui-standard/ink-adapter';
+
+const runtime = new TAUIRuntime();
+
+// Initial state
+let userEmail = '';
+let selectedPriority = 'medium';
+let logs: string[] = ['System initialized. Press "q" to exit.'];
+
+function updateUI() {
+  runtime.setDocument({
+    version: "1.0",
+    metadata: { title: "TAUI Advanced Dashboard" },
+    screen: {
+      type: "Panel",
+      title: "TAUI interactive Demo",
+      padding: 1,
+      children: [
+        {
+          type: "KeyBinding",
+          id: "exit-key",
+          key: "q",
+          action: "exit"
+        },
+        {
+          type: "Column",
+          gap: 1,
+          children: [
+            {
+              type: "Input",
+              id: "email-input",
+              placeholder: "User Email",
+              value: userEmail
+            },
+            {
+              type: "Select",
+              id: "priority-select",
+              value: selectedPriority,
+              options: [
+                { label: "Low Priority", value: "low" },
+                { label: "Medium Priority", value: "medium" },
+                { label: "High Priority", value: "high" }
+              ]
+            },
+            {
+              type: "Row",
+              gap: 2,
+              children: [
+                { type: "Button", id: "submit-btn", label: "Deploy Agent" },
+                { type: "Button", id: "clear-btn", label: "Clear Logs" }
+              ]
+            },
+            {
+              type: "Panel",
+              title: "Activity Logs",
+              children: logs.slice(-5).map((msg, i) => ({
+                type: "Text",
+                id: `log-${i}`,
+                content: `> ${msg}`,
+                style: { dim: true }
+              }))
+            }
+          ]
+        }
+      ]
+    }
+  });
+}
+
+runtime.onEvent((event) => {
+  if (event.type === 'change' && event.targetId === 'email-input') {
+    userEmail = (event.payload as any).value;
+    logs.push(`Email changed: ${userEmail}`);
+  } else if (event.type === 'change' && event.targetId === 'priority-select') {
+    selectedPriority = (event.payload as any).value;
+    logs.push(`Priority set to: ${selectedPriority}`);
+  } else if (event.type === 'action' && event.targetId === 'submit-btn') {
+    logs.push(`DEPLOYING agent to ${userEmail} [Priority: ${selectedPriority}]`);
+  } else if (event.type === 'action' && event.targetId === 'clear-btn') {
+    logs = ['Logs cleared.'];
+  } else if (event.type === 'key' && event.targetId === 'exit-key') {
+    process.exit(0);
+  }
+  updateUI();
+});
+
+updateUI();
+startTAUI(runtime);

package/examples/interactive-dashboard/package-lock.json

@@ -0,0 +1,544 @@
+{
+  "name": "example-dashboard",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "example-dashboard",
+      "version": "1.0.0",
+      "dependencies": {
+        "@taui-standard/core": "file:../../taui-core",
+        "@taui-standard/ink-adapter": "file:..",
+        "@taui-standard/validator": "file:../../taui-validator",
+        "tsx": "^4.7.0"
+      }
+    },
+    "..": {},
+    "../../taui-core": {},
+    "../../taui-validator": {},
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.2.tgz",
+      "integrity": "sha512-GZMB+a0mOMZs4MpDbj8RJp4cw+w1WV5NYD6xzgvzUJ5Ek2jerwfO2eADyI6ExDSUED+1X8aMbegahsJi+8mgpw==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.2.tgz",
+      "integrity": "sha512-DVNI8jlPa7Ujbr1yjU2PfUSRtAUZPG9I1RwW4F4xFB1Imiu2on0ADiI/c3td+KmDtVKNbi+nffGDQMfcIMkwIA==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.2.tgz",
+      "integrity": "sha512-pvz8ZZ7ot/RBphf8fv60ljmaoydPU12VuXHImtAs0XhLLw+EXBi2BLe3OYSBslR4rryHvweW5gmkKFwTiFy6KA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.2.tgz",
+      "integrity": "sha512-z8Ank4Byh4TJJOh4wpz8g2vDy75zFL0TlZlkUkEwYXuPSgX8yzep596n6mT7905kA9uHZsf/o2OJZubl2l3M7A==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.2.tgz",
+      "integrity": "sha512-davCD2Zc80nzDVRwXTcQP/28fiJbcOwvdolL0sOiOsbwBa72kegmVU0Wrh1MYrbuCL98Omp5dVhQFWRKR2ZAlg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.2.tgz",
+      "integrity": "sha512-ZxtijOmlQCBWGwbVmwOF/UCzuGIbUkqB1faQRf5akQmxRJ1ujusWsb3CVfk/9iZKr2L5SMU5wPBi1UWbvL+VQA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.2.tgz",
+      "integrity": "sha512-lS/9CN+rgqQ9czogxlMcBMGd+l8Q3Nj1MFQwBZJyoEKI50XGxwuzznYdwcav6lpOGv5BqaZXqvBSiB/kJ5op+g==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.2.tgz",
+      "integrity": "sha512-tAfqtNYb4YgPnJlEFu4c212HYjQWSO/w/h/lQaBK7RbwGIkBOuNKQI9tqWzx7Wtp7bTPaGC6MJvWI608P3wXYA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.2.tgz",
+      "integrity": "sha512-vWfq4GaIMP9AIe4yj1ZUW18RDhx6EPQKjwe7n8BbIecFtCQG4CfHGaHuh7fdfq+y3LIA2vGS/o9ZBGVxIDi9hw==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.2.tgz",
+      "integrity": "sha512-hYxN8pr66NsCCiRFkHUAsxylNOcAQaxSSkHMMjcpx0si13t1LHFphxJZUiGwojB1a/Hd5OiPIqDdXONia6bhTw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.2.tgz",
+      "integrity": "sha512-MJt5BRRSScPDwG2hLelYhAAKh9imjHK5+NE/tvnRLbIqUWa+0E9N4WNMjmp/kXXPHZGqPLxggwVhz7QP8CTR8w==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.2.tgz",
+      "integrity": "sha512-lugyF1atnAT463aO6KPshVCJK5NgRnU4yb3FUumyVz+cGvZbontBgzeGFO1nF+dPueHD367a2ZXe1NtUkAjOtg==",
+      "cpu": [
+        "loong64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.2.tgz",
+      "integrity": "sha512-nlP2I6ArEBewvJ2gjrrkESEZkB5mIoaTswuqNFRv/WYd+ATtUpe9Y09RnJvgvdag7he0OWgEZWhviS1OTOKixw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.2.tgz",
+      "integrity": "sha512-C92gnpey7tUQONqg1n6dKVbx3vphKtTHJaNG2Ok9lGwbZil6DrfyecMsp9CrmXGQJmZ7iiVXvvZH6Ml5hL6XdQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.2.tgz",
+      "integrity": "sha512-B5BOmojNtUyN8AXlK0QJyvjEZkWwy/FKvakkTDCziX95AowLZKR6aCDhG7LeF7uMCXEJqwa8Bejz5LTPYm8AvA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.2.tgz",
+      "integrity": "sha512-p4bm9+wsPwup5Z8f4EpfN63qNagQ47Ua2znaqGH6bqLlmJ4bx97Y9JdqxgGZ6Y8xVTixUnEkoKSHcpRlDnNr5w==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.2.tgz",
+      "integrity": "sha512-uwp2Tip5aPmH+NRUwTcfLb+W32WXjpFejTIOWZFw/v7/KnpCDKG66u4DLcurQpiYTiYwQ9B7KOeMJvLCu/OvbA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.2.tgz",
+      "integrity": "sha512-Kj6DiBlwXrPsCRDeRvGAUb/LNrBASrfqAIok+xB0LxK8CHqxZ037viF13ugfsIpePH93mX7xfJp97cyDuTZ3cw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.2.tgz",
+      "integrity": "sha512-HwGDZ0VLVBY3Y+Nw0JexZy9o/nUAWq9MlV7cahpaXKW6TOzfVno3y3/M8Ga8u8Yr7GldLOov27xiCnqRZf0tCA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.2.tgz",
+      "integrity": "sha512-DNIHH2BPQ5551A7oSHD0CKbwIA/Ox7+78/AWkbS5QoRzaqlev2uFayfSxq68EkonB+IKjiuxBFoV8ESJy8bOHA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.2.tgz",
+      "integrity": "sha512-/it7w9Nb7+0KFIzjalNJVR5bOzA9Vay+yIPLVHfIQYG/j+j9VTH84aNB8ExGKPU4AzfaEvN9/V4HV+F+vo8OEg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.2.tgz",
+      "integrity": "sha512-LRBbCmiU51IXfeXk59csuX/aSaToeG7w48nMwA6049Y4J4+VbWALAuXcs+qcD04rHDuSCSRKdmY63sruDS5qag==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.2.tgz",
+      "integrity": "sha512-kMtx1yqJHTmqaqHPAzKCAkDaKsffmXkPHThSfRwZGyuqyIeBvf08KSsYXl+abf5HDAPMJIPnbBfXvP2ZC2TfHg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.2.tgz",
+      "integrity": "sha512-Yaf78O/B3Kkh+nKABUF++bvJv5Ijoy9AN1ww904rOXZFLWVc5OLOfL56W+C8F9xn5JQZa3UX6m+IktJnIb1Jjg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.2.tgz",
+      "integrity": "sha512-Iuws0kxo4yusk7sw70Xa2E2imZU5HoixzxfGCdxwBdhiDgt9vX9VUCBhqcwY7/uh//78A1hMkkROMJq9l27oLQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.2.tgz",
+      "integrity": "sha512-sRdU18mcKf7F+YgheI/zGf5alZatMUTKj/jNS6l744f9u3WFu4v7twcUI9vu4mknF4Y9aDlblIie0IM+5xxaqQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@taui-standard/core": {
+      "resolved": "../../taui-core",
+      "link": true
+    },
+    "node_modules/@taui-standard/ink-adapter": {
+      "resolved": "..",
+      "link": true
+    },
+    "node_modules/@taui-standard/validator": {
+      "resolved": "../../taui-validator",
+      "link": true
+    },
+    "node_modules/esbuild": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.2.tgz",
+      "integrity": "sha512-HyNQImnsOC7X9PMNaCIeAm4ISCQXs5a5YasTXVliKv4uuBo1dKrG0A+uQS8M5eXjVMnLg3WgXaKvprHlFJQffw==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.27.2",
+        "@esbuild/android-arm": "0.27.2",
+        "@esbuild/android-arm64": "0.27.2",
+        "@esbuild/android-x64": "0.27.2",
+        "@esbuild/darwin-arm64": "0.27.2",
+        "@esbuild/darwin-x64": "0.27.2",
+        "@esbuild/freebsd-arm64": "0.27.2",
+        "@esbuild/freebsd-x64": "0.27.2",
+        "@esbuild/linux-arm": "0.27.2",
+        "@esbuild/linux-arm64": "0.27.2",
+        "@esbuild/linux-ia32": "0.27.2",
+        "@esbuild/linux-loong64": "0.27.2",
+        "@esbuild/linux-mips64el": "0.27.2",
+        "@esbuild/linux-ppc64": "0.27.2",
+        "@esbuild/linux-riscv64": "0.27.2",
+        "@esbuild/linux-s390x": "0.27.2",
+        "@esbuild/linux-x64": "0.27.2",
+        "@esbuild/netbsd-arm64": "0.27.2",
+        "@esbuild/netbsd-x64": "0.27.2",
+        "@esbuild/openbsd-arm64": "0.27.2",
+        "@esbuild/openbsd-x64": "0.27.2",
+        "@esbuild/openharmony-arm64": "0.27.2",
+        "@esbuild/sunos-x64": "0.27.2",
+        "@esbuild/win32-arm64": "0.27.2",
+        "@esbuild/win32-ia32": "0.27.2",
+        "@esbuild/win32-x64": "0.27.2"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/get-tsconfig": {
+      "version": "4.13.0",
+      "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.13.0.tgz",
+      "integrity": "sha512-1VKTZJCwBrvbd+Wn3AOgQP/2Av+TfTCOlE4AcRJE72W1ksZXbAx8PPBR9RzgTeSPzlPMHrbANMH3LbltH73wxQ==",
+      "license": "MIT",
+      "dependencies": {
+        "resolve-pkg-maps": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
+      }
+    },
+    "node_modules/resolve-pkg-maps": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz",
+      "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
+      }
+    },
+    "node_modules/tsx": {
+      "version": "4.21.0",
+      "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.21.0.tgz",
+      "integrity": "sha512-5C1sg4USs1lfG0GFb2RLXsdpXqBSEhAaA/0kPL01wxzpMqLILNxIxIOKiILz+cdg/pLnOUxFYOR5yhHU666wbw==",
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "~0.27.0",
+        "get-tsconfig": "^4.7.5"
+      },
+      "bin": {
+        "tsx": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      }
+    }
+  }
+}

package/examples/interactive-dashboard/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "example-dashboard",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "tsx index.ts"
+  },
+  "dependencies": {
+    "@taui-standard/core": "0.0.1",
+    "@taui-standard/ink-adapter": "0.0.1",
+    "@taui-standard/validator": "0.0.1",
+    "tsx": "^4.7.0"
+  }
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@taui-standard/ink-adapter",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "Ink adapter for Terminal Agent UI (TAUI)",
+  "main": "dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "author": "Tariq Shams",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@taui-standard/core": "^0.0.1",
+    "@taui-standard/validator": "^0.0.1",
+    "ink": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "@types/react": "^18.2.0",
+    "vitest": "^1.2.1"
+  }
+}

package/src/index.tsx

@@ -0,0 +1,45 @@
+import React from 'react';
+import { render, Box, Text, useFocusManager } from 'ink';
+import { TAUIRuntime } from '@taui-standard/core';
+import { TAUIRenderer } from './renderer.js';
+
+export * from './renderer.js';
+
+export interface TAUIAppProps {
+  runtime: TAUIRuntime;
+}
+
+export const TAUIApp: React.FC<TAUIAppProps> = ({ runtime }) => {
+  const [doc, setDoc] = React.useState(runtime.getDocument());
+  const { focusNext, focusPrevious } = useFocusManager();
+
+  React.useEffect(() => {
+    return runtime.onEvent(() => {
+      setDoc({ ...runtime.getDocument()! });
+    });
+  }, [runtime]);
+
+  // Handle global tab navigation
+  React.useEffect(() => {
+    const handleKey = (input: string, key: any) => {
+      if (key.tab) {
+        if (key.shift) focusPrevious();
+        else focusNext();
+      }
+    };
+    // Note: useInput is inside components, but we could add a global listener here if needed.
+    // However, Ink's focus manager handles Tab by default if components are wrapped in <Box focusable>.
+  }, []);
+
+  if (!doc) return <Text>Loading...</Text>;
+
+  return (
+    <Box flexDirection="column" padding={1}>
+      <TAUIRenderer node={doc.screen} runtime={runtime} />
+    </Box>
+  );
+};
+
+export function startTAUI(runtime: TAUIRuntime) {
+  return render(<TAUIApp runtime={runtime} />);
+}

package/src/renderer.tsx

@@ -0,0 +1,168 @@
+import React from 'react';
+import { Box, Text, useInput, useFocus } from 'ink';
+import TextInput from 'ink-text-input';
+import { TAUINode } from '@taui-standard/validator';
+import { TAUIRuntime } from '@taui-standard/core';
+
+export interface RendererProps {
+  node: TAUINode;
+  runtime: TAUIRuntime;
+}
+
+export const TAUIText: React.FC<RendererProps> = ({ node }) => {
+  if (node.type !== 'Text') return null;
+  return (
+    <Text
+      color={node.style?.color}
+      backgroundColor={node.style?.backgroundColor}
+      bold={node.style?.bold}
+      dimColor={node.style?.dim}
+      italic={node.style?.italic}
+      underline={node.style?.underline}
+    >
+      {node.content}
+    </Text>
+  );
+};
+
+export const TAUIBox: React.FC<RendererProps> = ({ node, runtime }) => {
+  if (!['Box', 'Row', 'Column', 'Grid', 'Panel'].includes(node.type)) return null;
+
+  const flexDirection = node.type === 'Row' ? 'row' : 'column';
+  const borderStyle = node.type === 'Panel' ? (node.borderStyle || 'single') : undefined;
+
+  return (
+    <Box 
+      flexDirection={flexDirection}
+      padding={typeof node.padding === 'number' ? node.padding : undefined}
+      gap={node.gap}
+      borderStyle={borderStyle === 'none' ? undefined : borderStyle as any}
+    >
+      {node.type === 'Panel' && node.title && (
+        <Box position="absolute" marginTop={-1} marginLeft={1} paddingX={1}>
+           <Text bold>{node.title}</Text>
+        </Box>
+      )}
+      {node.children?.map((child: TAUINode, idx: number) => (
+         <TAUIRenderer key={child.id || `${node.type}-${idx}`} node={child} runtime={runtime} />
+      ))}
+    </Box>
+  );
+};
+
+export const TAUIButton: React.FC<RendererProps> = ({ node, runtime }) => {
+  const { isFocused } = useFocus({ id: node.id });
+
+  useInput((input: string, key: any) => {
+    if (isFocused && (key.return || input === ' ')) {
+      runtime.dispatchRawEvent({
+        type: 'action',
+        targetId: node.id,
+        timestamp: new Date().toISOString()
+      });
+    }
+  });
+
+  return (
+    <Box borderStyle="round" borderColor={isFocused ? 'cyan' : 'gray'} paddingX={1}>
+      <Text color={isFocused ? 'cyan' : undefined}>{node.label}</Text>
+    </Box>
+  );
+};
+
+export const TAUIInput: React.FC<RendererProps> = ({ node, runtime }) => {
+  const { isFocused } = useFocus({ id: node.id });
+
+  const onChange = (value: string) => {
+    runtime.dispatchRawEvent({
+      type: 'change',
+      targetId: node.id,
+      payload: { value },
+      timestamp: new Date().toISOString()
+    });
+  };
+
+  return (
+    <Box flexDirection="row" gap={1}>
+      {node.placeholder && <Text dimColor>{node.placeholder}: </Text>}
+      <Box borderStyle="single" borderColor={isFocused ? 'yellow' : 'gray'} paddingX={1} minWidth={10}>
+        {isFocused ? (
+          <TextInput value={node.value || ''} onChange={onChange} mask={node.mask ? '*' : undefined} />
+        ) : (
+          <Text>{node.mask ? '*'.repeat((node.value || '').length) : (node.value || ' ')}</Text>
+        )}
+      </Box>
+    </Box>
+  );
+};
+
+export const TAUIProgress: React.FC<RendererProps> = ({ node }) => {
+  const width = 20;
+  const val = (node as any).value || 0;
+  const completed = Math.round(val * width);
+  const bar = '\u2588'.repeat(completed) + '\u2591'.repeat(width - completed);
+  
+  return (
+    <Box flexDirection="row" gap={1}>
+      {(node as any).label && <Text>{(node as any).label}</Text>}
+      <Text color="cyan">{bar}</Text>
+      <Text>{Math.round(val * 100)}%</Text>
+    </Box>
+  );
+};
+
+export const TAUIKeyBinding: React.FC<RendererProps> = ({ node, runtime }) => {
+  if (node.type !== 'KeyBinding') return null;
+
+  useInput((input: string, key: any) => {
+    const matchesKey = input === node.key || 
+      (key.return && node.key === 'enter') ||
+      (key.backspace && node.key === 'backspace') ||
+      (key.escape && node.key === 'escape') ||
+      (key.tab && node.key === 'tab') ||
+      (key.upArrow && node.key === 'up') ||
+      (key.downArrow && node.key === 'down') ||
+      (key.leftArrow && node.key === 'left') ||
+      (key.rightArrow && node.key === 'right');
+
+    const matchesModifiers = 
+      (!!node.ctrl === key.ctrl) && 
+      (!!node.meta === key.meta) && 
+      (!!node.shift === key.shift);
+
+    if (matchesKey && matchesModifiers) {
+      runtime.dispatchRawEvent({
+        type: 'key',
+        targetId: node.id || 'global',
+        payload: { key: node.key, ctrl: node.ctrl, meta: node.meta, shift: node.shift },
+        timestamp: new Date().toISOString()
+      });
+    }
+  });
+
+  return null;
+};
+
+export const TAUIRenderer: React.FC<RendererProps> = (props) => {
+  const { node } = props;
+  switch (node.type) {
+    case 'Box':
+    case 'Row':
+    case 'Column':
+    case 'Grid':
+    case 'Panel':
+      return <TAUIBox {...props} />;
+    case 'Text':
+      return <TAUIText {...props} />;
+    case 'Button':
+      return <TAUIButton {...props} />;
+    case 'Input':
+      return <TAUIInput {...props} />;
+    case 'Progress':
+      return <TAUIProgress {...props} />;
+    case 'KeyBinding':
+      return <TAUIKeyBinding {...props} />;
+    default:
+      return <Text dimColor>Unsupported node type: {node.type}</Text>;
+  }
+};

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "jsx": "react-jsx",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}