@pablozaiden/terminatui 0.1.0 → 0.2.0

package/.github/workflows/release-npm-package.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: read
-      packages: write
+      id-token: write
     steps:
       - name: Determine release tag
         id: get_tag
@@ -52,6 +52,11 @@ jobs:
           curl -fsSL https://bun.com/install | bash
           echo "$HOME/.bun/bin" >> $GITHUB_PATH
 
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+
       - name: Set package version
         run: |
           VERSION="${{ steps.get_tag.outputs.version }}"
@@ -73,6 +78,4 @@ jobs:
         run: bun run build
 
       - name: Publish Package
-        run: bun publish --no-build
-        env:
-          BUN_PUBLISH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npm publish --no-build

package/AGENTS.md

@@ -0,0 +1,31 @@
+Default to using Bun instead of Node.js.
+
+- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
+- Use `bun test` instead of `jest` or `vitest`
+- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
+- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
+- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
+- Use `bunx <package> <command>` instead of `npx <package> <command>`
+- Bun automatically loads .env, so don't use dotenv.
+
+## APIs
+
+- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
+- Bun.$`ls` instead of execa.
+
+## Testing
+
+Always run `bun run build` before running tests, to make sure there are no build errors.
+Use `bun run test` to run all the tests.
+
+Always run `bun run test` when you think you are done making changes.
+
+```ts#index.test.ts
+import { test, expect } from "bun:test";
+
+test("hello world", () => {
+  expect(1).toBe(1);
+});
+```
+
+For more information, read the Bun API docs in `node_modules/bun-types/docs/**.mdx`.

package/bun.lock

@@ -0,0 +1,236 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@pablozaiden/terminatui",
+      "dependencies": {
+        "@opentui/react": "0.1.68",
+        "tslog": "^4.9.3",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+        "@types/react": "^19",
+        "typescript": "5.9.3",
+      },
+      "peerDependencies": {
+        "typescript": "5.9.3",
+      },
+    },
+  },
+  "packages": {
+    "@dimforge/rapier2d-simd-compat": ["@dimforge/rapier2d-simd-compat@0.17.3", "", {}, "sha512-bijvwWz6NHsNj5e5i1vtd3dU2pDhthSaTUZSh14DUGGKJfw8eMnlWZsxwHBxB/a3AXVNDjL9abuHw1k9FGR+jg=="],
+
+    "@jimp/core": ["@jimp/core@1.6.0", "", { "dependencies": { "@jimp/file-ops": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "await-to-js": "^3.0.0", "exif-parser": "^0.1.12", "file-type": "^16.0.0", "mime": "3" } }, "sha512-EQQlKU3s9QfdJqiSrZWNTxBs3rKXgO2W+GxNXDtwchF3a4IqxDheFX1ti+Env9hdJXDiYLp2jTRjlxhPthsk8w=="],
+
+    "@jimp/diff": ["@jimp/diff@1.6.0", "", { "dependencies": { "@jimp/plugin-resize": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "pixelmatch": "^5.3.0" } }, "sha512-+yUAQ5gvRC5D1WHYxjBHZI7JBRusGGSLf8AmPRPCenTzh4PA+wZ1xv2+cYqQwTfQHU5tXYOhA0xDytfHUf1Zyw=="],
+
+    "@jimp/file-ops": ["@jimp/file-ops@1.6.0", "", {}, "sha512-Dx/bVDmgnRe1AlniRpCKrGRm5YvGmUwbDzt+MAkgmLGf+jvBT75hmMEZ003n9HQI/aPnm/YKnXjg/hOpzNCpHQ=="],
+
+    "@jimp/js-bmp": ["@jimp/js-bmp@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "bmp-ts": "^1.0.9" } }, "sha512-FU6Q5PC/e3yzLyBDXupR3SnL3htU7S3KEs4e6rjDP6gNEOXRFsWs6YD3hXuXd50jd8ummy+q2WSwuGkr8wi+Gw=="],
+
+    "@jimp/js-gif": ["@jimp/js-gif@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/types": "1.6.0", "gifwrap": "^0.10.1", "omggif": "^1.0.10" } }, "sha512-N9CZPHOrJTsAUoWkWZstLPpwT5AwJ0wge+47+ix3++SdSL/H2QzyMqxbcDYNFe4MoI5MIhATfb0/dl/wmX221g=="],
+
+    "@jimp/js-jpeg": ["@jimp/js-jpeg@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/types": "1.6.0", "jpeg-js": "^0.4.4" } }, "sha512-6vgFDqeusblf5Pok6B2DUiMXplH8RhIKAryj1yn+007SIAQ0khM1Uptxmpku/0MfbClx2r7pnJv9gWpAEJdMVA=="],
+
+    "@jimp/js-png": ["@jimp/js-png@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/types": "1.6.0", "pngjs": "^7.0.0" } }, "sha512-AbQHScy3hDDgMRNfG0tPjL88AV6qKAILGReIa3ATpW5QFjBKpisvUaOqhzJ7Reic1oawx3Riyv152gaPfqsBVg=="],
+
+    "@jimp/js-tiff": ["@jimp/js-tiff@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/types": "1.6.0", "utif2": "^4.1.0" } }, "sha512-zhReR8/7KO+adijj3h0ZQUOiun3mXUv79zYEAKvE0O+rP7EhgtKvWJOZfRzdZSNv0Pu1rKtgM72qgtwe2tFvyw=="],
+
+    "@jimp/plugin-blit": ["@jimp/plugin-blit@1.6.0", "", { "dependencies": { "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "zod": "^3.23.8" } }, "sha512-M+uRWl1csi7qilnSK8uxK4RJMSuVeBiO1AY0+7APnfUbQNZm6hCe0CCFv1Iyw1D/Dhb8ph8fQgm5mwM0eSxgVA=="],
+
+    "@jimp/plugin-blur": ["@jimp/plugin-blur@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/utils": "1.6.0" } }, "sha512-zrM7iic1OTwUCb0g/rN5y+UnmdEsT3IfuCXCJJNs8SZzP0MkZ1eTvuwK9ZidCuMo4+J3xkzCidRwYXB5CyGZTw=="],
+
+    "@jimp/plugin-circle": ["@jimp/plugin-circle@1.6.0", "", { "dependencies": { "@jimp/types": "1.6.0", "zod": "^3.23.8" } }, "sha512-xt1Gp+LtdMKAXfDp3HNaG30SPZW6AQ7dtAtTnoRKorRi+5yCJjKqXRgkewS5bvj8DEh87Ko1ydJfzqS3P2tdWw=="],
+
+    "@jimp/plugin-color": ["@jimp/plugin-color@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "tinycolor2": "^1.6.0", "zod": "^3.23.8" } }, "sha512-J5q8IVCpkBsxIXM+45XOXTrsyfblyMZg3a9eAo0P7VPH4+CrvyNQwaYatbAIamSIN1YzxmO3DkIZXzRjFSz1SA=="],
+
+    "@jimp/plugin-contain": ["@jimp/plugin-contain@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/plugin-blit": "1.6.0", "@jimp/plugin-resize": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "zod": "^3.23.8" } }, "sha512-oN/n+Vdq/Qg9bB4yOBOxtY9IPAtEfES8J1n9Ddx+XhGBYT1/QTU/JYkGaAkIGoPnyYvmLEDqMz2SGihqlpqfzQ=="],
+
+    "@jimp/plugin-cover": ["@jimp/plugin-cover@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/plugin-crop": "1.6.0", "@jimp/plugin-resize": "1.6.0", "@jimp/types": "1.6.0", "zod": "^3.23.8" } }, "sha512-Iow0h6yqSC269YUJ8HC3Q/MpCi2V55sMlbkkTTx4zPvd8mWZlC0ykrNDeAy9IJegrQ7v5E99rJwmQu25lygKLA=="],
+
+    "@jimp/plugin-crop": ["@jimp/plugin-crop@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "zod": "^3.23.8" } }, "sha512-KqZkEhvs+21USdySCUDI+GFa393eDIzbi1smBqkUPTE+pRwSWMAf01D5OC3ZWB+xZsNla93BDS9iCkLHA8wang=="],
+
+    "@jimp/plugin-displace": ["@jimp/plugin-displace@1.6.0", "", { "dependencies": { "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "zod": "^3.23.8" } }, "sha512-4Y10X9qwr5F+Bo5ME356XSACEF55485j5nGdiyJ9hYzjQP9nGgxNJaZ4SAOqpd+k5sFaIeD7SQ0Occ26uIng5Q=="],
+
+    "@jimp/plugin-dither": ["@jimp/plugin-dither@1.6.0", "", { "dependencies": { "@jimp/types": "1.6.0" } }, "sha512-600d1RxY0pKwgyU0tgMahLNKsqEcxGdbgXadCiVCoGd6V6glyCvkNrnnwC0n5aJ56Htkj88PToSdF88tNVZEEQ=="],
+
+    "@jimp/plugin-fisheye": ["@jimp/plugin-fisheye@1.6.0", "", { "dependencies": { "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "zod": "^3.23.8" } }, "sha512-E5QHKWSCBFtpgZarlmN3Q6+rTQxjirFqo44ohoTjzYVrDI6B6beXNnPIThJgPr0Y9GwfzgyarKvQuQuqCnnfbA=="],
+
+    "@jimp/plugin-flip": ["@jimp/plugin-flip@1.6.0", "", { "dependencies": { "@jimp/types": "1.6.0", "zod": "^3.23.8" } }, "sha512-/+rJVDuBIVOgwoyVkBjUFHtP+wmW0r+r5OQ2GpatQofToPVbJw1DdYWXlwviSx7hvixTWLKVgRWQ5Dw862emDg=="],
+
+    "@jimp/plugin-hash": ["@jimp/plugin-hash@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/js-bmp": "1.6.0", "@jimp/js-jpeg": "1.6.0", "@jimp/js-png": "1.6.0", "@jimp/js-tiff": "1.6.0", "@jimp/plugin-color": "1.6.0", "@jimp/plugin-resize": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "any-base": "^1.1.0" } }, "sha512-wWzl0kTpDJgYVbZdajTf+4NBSKvmI3bRI8q6EH9CVeIHps9VWVsUvEyb7rpbcwVLWYuzDtP2R0lTT6WeBNQH9Q=="],
+
+    "@jimp/plugin-mask": ["@jimp/plugin-mask@1.6.0", "", { "dependencies": { "@jimp/types": "1.6.0", "zod": "^3.23.8" } }, "sha512-Cwy7ExSJMZszvkad8NV8o/Z92X2kFUFM8mcDAhNVxU0Q6tA0op2UKRJY51eoK8r6eds/qak3FQkXakvNabdLnA=="],
+
+    "@jimp/plugin-print": ["@jimp/plugin-print@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/js-jpeg": "1.6.0", "@jimp/js-png": "1.6.0", "@jimp/plugin-blit": "1.6.0", "@jimp/types": "1.6.0", "parse-bmfont-ascii": "^1.0.6", "parse-bmfont-binary": "^1.0.6", "parse-bmfont-xml": "^1.1.6", "simple-xml-to-json": "^1.2.2", "zod": "^3.23.8" } }, "sha512-zarTIJi8fjoGMSI/M3Xh5yY9T65p03XJmPsuNet19K/Q7mwRU6EV2pfj+28++2PV2NJ+htDF5uecAlnGyxFN2A=="],
+
+    "@jimp/plugin-quantize": ["@jimp/plugin-quantize@1.6.0", "", { "dependencies": { "image-q": "^4.0.0", "zod": "^3.23.8" } }, "sha512-EmzZ/s9StYQwbpG6rUGBCisc3f64JIhSH+ncTJd+iFGtGo0YvSeMdAd+zqgiHpfZoOL54dNavZNjF4otK+mvlg=="],
+
+    "@jimp/plugin-resize": ["@jimp/plugin-resize@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/types": "1.6.0", "zod": "^3.23.8" } }, "sha512-uSUD1mqXN9i1SGSz5ov3keRZ7S9L32/mAQG08wUwZiEi5FpbV0K8A8l1zkazAIZi9IJzLlTauRNU41Mi8IF9fA=="],
+
+    "@jimp/plugin-rotate": ["@jimp/plugin-rotate@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/plugin-crop": "1.6.0", "@jimp/plugin-resize": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "zod": "^3.23.8" } }, "sha512-JagdjBLnUZGSG4xjCLkIpQOZZ3Mjbg8aGCCi4G69qR+OjNpOeGI7N2EQlfK/WE8BEHOW5vdjSyglNqcYbQBWRw=="],
+
+    "@jimp/plugin-threshold": ["@jimp/plugin-threshold@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/plugin-color": "1.6.0", "@jimp/plugin-hash": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "zod": "^3.23.8" } }, "sha512-M59m5dzLoHOVWdM41O8z9SyySzcDn43xHseOH0HavjsfQsT56GGCC4QzU1banJidbUrePhzoEdS42uFE8Fei8w=="],
+
+    "@jimp/types": ["@jimp/types@1.6.0", "", { "dependencies": { "zod": "^3.23.8" } }, "sha512-7UfRsiKo5GZTAATxm2qQ7jqmUXP0DxTArztllTcYdyw6Xi5oT4RaoXynVtCD4UyLK5gJgkZJcwonoijrhYFKfg=="],
+
+    "@jimp/utils": ["@jimp/utils@1.6.0", "", { "dependencies": { "@jimp/types": "1.6.0", "tinycolor2": "^1.6.0" } }, "sha512-gqFTGEosKbOkYF/WFj26jMHOI5OH2jeP1MmC/zbK6BF6VJBf8rIC5898dPfSzZEbSA0wbbV5slbntWVc5PKLFA=="],
+
+    "@opentui/core": ["@opentui/core@0.1.68", "", { "dependencies": { "bun-ffi-structs": "0.1.2", "diff": "8.0.2", "jimp": "1.6.0", "yoga-layout": "3.2.1" }, "optionalDependencies": { "@dimforge/rapier2d-simd-compat": "^0.17.3", "@opentui/core-darwin-arm64": "0.1.68", "@opentui/core-darwin-x64": "0.1.68", "@opentui/core-linux-arm64": "0.1.68", "@opentui/core-linux-x64": "0.1.68", "@opentui/core-win32-arm64": "0.1.68", "@opentui/core-win32-x64": "0.1.68", "bun-webgpu": "0.1.4", "planck": "^1.4.2", "three": "0.177.0" }, "peerDependencies": { "web-tree-sitter": "0.25.10" } }, "sha512-SZz5qNO+2lJ8jDEoTSieyXH23t49myu6NetLex+xzqOf67XsU6QKlDcw5oMmc3zrKvETXhgbBvlSnbyJNQoBMg=="],
+
+    "@opentui/core-darwin-arm64": ["@opentui/core-darwin-arm64@0.1.68", "", { "os": "darwin", "cpu": "arm64" }, "sha512-ipPX2gavBLVtw3d8L4ZPJDLlEwIjIRNdlNlxu07rqSEGSfxD5s29yc+33wLAlYXbmnJDajOqm0Dx6HnlY1Y9Fg=="],
+
+    "@opentui/core-darwin-x64": ["@opentui/core-darwin-x64@0.1.68", "", { "os": "darwin", "cpu": "x64" }, "sha512-9dW0S9HINnuVjvC9QLj+S+329H7qEBQQtyJ9WHpykemokiJ5k4rnuDkfws5FxgTHIf/ddoYYTyPoGCS7WN5gsQ=="],
+
+    "@opentui/core-linux-arm64": ["@opentui/core-linux-arm64@0.1.68", "", { "os": "linux", "cpu": "arm64" }, "sha512-/el6TbSQriBUfPhIa6SBfCCc7tjU98Bnhf2+w0zKwQFBjf3F3kmnI42++YxedMGFmL7bRt3EUawGOkQRZZzFAg=="],
+
+    "@opentui/core-linux-x64": ["@opentui/core-linux-x64@0.1.68", "", { "os": "linux", "cpu": "x64" }, "sha512-9NzVI3GZzmICoIu3YhWBdkEt0KvY27m++tu/MqW+xb6fnvN74jZkRWzlgjTdM70obL4eUGQdvU08sDHgZjsIJw=="],
+
+    "@opentui/core-win32-arm64": ["@opentui/core-win32-arm64@0.1.68", "", { "os": "win32", "cpu": "arm64" }, "sha512-wrAeotyotOplUjQVBSxOGA8GCr9FWXSd6xCEo1PEGo/NjuAOtvHmKoENzyFEP0GzFsjvoUOyy2dZb987oFAn9A=="],
+
+    "@opentui/core-win32-x64": ["@opentui/core-win32-x64@0.1.68", "", { "os": "win32", "cpu": "x64" }, "sha512-w0yBjvzs/oMIwVdWICL4XlUrfsPoVXd4+RDqiuu+Xi/zD0UgANSTRY2asXca+gPe5zPHLsxvz1bAG0Z7uGtmyw=="],
+
+    "@opentui/react": ["@opentui/react@0.1.68", "", { "dependencies": { "@opentui/core": "0.1.68", "react-reconciler": "^0.32.0" }, "peerDependencies": { "react": ">=19.0.0", "react-devtools-core": "^7.0.1", "ws": "^8.18.0" } }, "sha512-dN2I60zINykyty31fFt0q8oZuod3O3LTygzdLPmXl0m4FLLYTiINqtvJqt12z4ikRnwMW+t2Ia4C17LnZn19Hw=="],
+
+    "@tokenizer/token": ["@tokenizer/token@0.3.0", "", {}, "sha512-OvjF+z51L3ov0OyAU0duzsYuvO01PH7x4t6DJx+guahgTnBHkhJdG7soQeTSFLWN3efnHyibZ4Z8l2EuWwJN3A=="],
+
+    "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],
+
+    "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
+
+    "@types/react": ["@types/react@19.2.7", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-MWtvHrGZLFttgeEj28VXHxpmwYbor/ATPYbBfSFZEIRK0ecCFLl2Qo55z52Hss+UV9CRN7trSeq1zbgx7YDWWg=="],
+
+    "@webgpu/types": ["@webgpu/types@0.1.68", "", {}, "sha512-3ab1B59Ojb6RwjOspYLsTpCzbNB3ZaamIAxBMmvnNkiDoLTZUOBXZ9p5nAYVEkQlDdf6qAZWi1pqj9+ypiqznA=="],
+
+    "abort-controller": ["abort-controller@3.0.0", "", { "dependencies": { "event-target-shim": "^5.0.0" } }, "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg=="],
+
+    "any-base": ["any-base@1.1.0", "", {}, "sha512-uMgjozySS8adZZYePpaWs8cxB9/kdzmpX6SgJZ+wbz1K5eYk5QMYDVJaZKhxyIHUdnnJkfR7SVgStgH7LkGUyg=="],
+
+    "await-to-js": ["await-to-js@3.0.0", "", {}, "sha512-zJAaP9zxTcvTHRlejau3ZOY4V7SRpiByf3/dxx2uyKxxor19tpmpV2QRsTKikckwhaPmr2dVpxxMr7jOCYVp5g=="],
+
+    "base64-js": ["base64-js@1.5.1", "", {}, "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="],
+
+    "bmp-ts": ["bmp-ts@1.0.9", "", {}, "sha512-cTEHk2jLrPyi+12M3dhpEbnnPOsaZuq7C45ylbbQIiWgDFZq4UVYPEY5mlqjvsj/6gJv9qX5sa+ebDzLXT28Vw=="],
+
+    "buffer": ["buffer@6.0.3", "", { "dependencies": { "base64-js": "^1.3.1", "ieee754": "^1.2.1" } }, "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA=="],
+
+    "bun-ffi-structs": ["bun-ffi-structs@0.1.2", "", { "peerDependencies": { "typescript": "^5" } }, "sha512-Lh1oQAYHDcnesJauieA4UNkWGXY9hYck7OA5IaRwE3Bp6K2F2pJSNYqq+hIy7P3uOvo3km3oxS8304g5gDMl/w=="],
+
+    "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
+
+    "bun-webgpu": ["bun-webgpu@0.1.4", "", { "dependencies": { "@webgpu/types": "^0.1.60" }, "optionalDependencies": { "bun-webgpu-darwin-arm64": "^0.1.4", "bun-webgpu-darwin-x64": "^0.1.4", "bun-webgpu-linux-x64": "^0.1.4", "bun-webgpu-win32-x64": "^0.1.4" } }, "sha512-Kw+HoXl1PMWJTh9wvh63SSRofTA8vYBFCw0XEP1V1fFdQEDhI8Sgf73sdndE/oDpN/7CMx0Yv/q8FCvO39ROMQ=="],
+
+    "bun-webgpu-darwin-arm64": ["bun-webgpu-darwin-arm64@0.1.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-eDgLN9teKTfmvrCqgwwmWNsNszxYs7IZdCqk0S1DCarvMhr4wcajoSBlA/nQA0/owwLduPTS8xxCnQp4/N/gDg=="],
+
+    "bun-webgpu-darwin-x64": ["bun-webgpu-darwin-x64@0.1.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-X+PjwJUWenUmdQBP8EtdItMyieQ6Nlpn+BH518oaouDiSnWj5+b0Y7DNDZJq7Ezom4EaxmqL/uGYZK3aCQ7CXg=="],
+
+    "bun-webgpu-linux-x64": ["bun-webgpu-linux-x64@0.1.4", "", { "os": "linux", "cpu": "x64" }, "sha512-zMLs2YIGB+/jxrYFXaFhVKX/GBt05UTF45lc9srcHc9JXGjEj+12CIo1CHLTAWatXMTqt0Jsu6ukWEoWVT/ayA=="],
+
+    "bun-webgpu-win32-x64": ["bun-webgpu-win32-x64@0.1.4", "", { "os": "win32", "cpu": "x64" }, "sha512-Z5yAK28xrcm8Wb5k7TZ8FJKpOI/r+aVCRdlHYAqI2SDJFN3nD4mJs900X6kNVmG/xFzb5yOuKVYWGg+6ZXWbyA=="],
+
+    "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="],
+
+    "diff": ["diff@8.0.2", "", {}, "sha512-sSuxWU5j5SR9QQji/o2qMvqRNYRDOcBTgsJ/DeCf4iSN4gW+gNMXM7wFIP+fdXZxoNiAnHUTGjCr+TSWXdRDKg=="],
+
+    "event-target-shim": ["event-target-shim@5.0.1", "", {}, "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ=="],
+
+    "events": ["events@3.3.0", "", {}, "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q=="],
+
+    "exif-parser": ["exif-parser@0.1.12", "", {}, "sha512-c2bQfLNbMzLPmzQuOr8fy0csy84WmwnER81W88DzTp9CYNPJ6yzOj2EZAh9pywYpqHnshVLHQJ8WzldAyfY+Iw=="],
+
+    "file-type": ["file-type@16.5.4", "", { "dependencies": { "readable-web-to-node-stream": "^3.0.0", "strtok3": "^6.2.4", "token-types": "^4.1.1" } }, "sha512-/yFHK0aGjFEgDJjEKP0pWCplsPFPhwyfwevf/pVxiN0tmE4L9LmwWxWukdJSHdoCli4VgQLehjJtwQBnqmsKcw=="],
+
+    "gifwrap": ["gifwrap@0.10.1", "", { "dependencies": { "image-q": "^4.0.0", "omggif": "^1.0.10" } }, "sha512-2760b1vpJHNmLzZ/ubTtNnEx5WApN/PYWJvXvgS+tL1egTTthayFYIQQNi136FLEDcN/IyEY2EcGpIITD6eYUw=="],
+
+    "ieee754": ["ieee754@1.2.1", "", {}, "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="],
+
+    "image-q": ["image-q@4.0.0", "", { "dependencies": { "@types/node": "16.9.1" } }, "sha512-PfJGVgIfKQJuq3s0tTDOKtztksibuUEbJQIYT3by6wctQo+Rdlh7ef4evJ5NCdxY4CfMbvFkocEwbl4BF8RlJw=="],
+
+    "jimp": ["jimp@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/diff": "1.6.0", "@jimp/js-bmp": "1.6.0", "@jimp/js-gif": "1.6.0", "@jimp/js-jpeg": "1.6.0", "@jimp/js-png": "1.6.0", "@jimp/js-tiff": "1.6.0", "@jimp/plugin-blit": "1.6.0", "@jimp/plugin-blur": "1.6.0", "@jimp/plugin-circle": "1.6.0", "@jimp/plugin-color": "1.6.0", "@jimp/plugin-contain": "1.6.0", "@jimp/plugin-cover": "1.6.0", "@jimp/plugin-crop": "1.6.0", "@jimp/plugin-displace": "1.6.0", "@jimp/plugin-dither": "1.6.0", "@jimp/plugin-fisheye": "1.6.0", "@jimp/plugin-flip": "1.6.0", "@jimp/plugin-hash": "1.6.0", "@jimp/plugin-mask": "1.6.0", "@jimp/plugin-print": "1.6.0", "@jimp/plugin-quantize": "1.6.0", "@jimp/plugin-resize": "1.6.0", "@jimp/plugin-rotate": "1.6.0", "@jimp/plugin-threshold": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0" } }, "sha512-YcwCHw1kiqEeI5xRpDlPPBGL2EOpBKLwO4yIBJcXWHPj5PnA5urGq0jbyhM5KoNpypQ6VboSoxc9D8HyfvngSg=="],
+
+    "jpeg-js": ["jpeg-js@0.4.4", "", {}, "sha512-WZzeDOEtTOBK4Mdsar0IqEU5sMr3vSV2RqkAIzUEV2BHnUfKGyswWFPFwK5EeDo93K3FohSHbLAjj0s1Wzd+dg=="],
+
+    "mime": ["mime@3.0.0", "", { "bin": { "mime": "cli.js" } }, "sha512-jSCU7/VB1loIWBZe14aEYHU/+1UMEHoaO7qxCOVJOw9GgH72VAWppxNcjU+x9a2k3GSIBXNKxXQFqRvvZ7vr3A=="],
+
+    "omggif": ["omggif@1.0.10", "", {}, "sha512-LMJTtvgc/nugXj0Vcrrs68Mn2D1r0zf630VNtqtpI1FEO7e+O9FP4gqs9AcnBaSEeoHIPm28u6qgPR0oyEpGSw=="],
+
+    "pako": ["pako@1.0.11", "", {}, "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw=="],
+
+    "parse-bmfont-ascii": ["parse-bmfont-ascii@1.0.6", "", {}, "sha512-U4RrVsUFCleIOBsIGYOMKjn9PavsGOXxbvYGtMOEfnId0SVNsgehXh1DxUdVPLoxd5mvcEtvmKs2Mmf0Mpa1ZA=="],
+
+    "parse-bmfont-binary": ["parse-bmfont-binary@1.0.6", "", {}, "sha512-GxmsRea0wdGdYthjuUeWTMWPqm2+FAd4GI8vCvhgJsFnoGhTrLhXDDupwTo7rXVAgaLIGoVHDZS9p/5XbSqeWA=="],
+
+    "parse-bmfont-xml": ["parse-bmfont-xml@1.1.6", "", { "dependencies": { "xml-parse-from-string": "^1.0.0", "xml2js": "^0.5.0" } }, "sha512-0cEliVMZEhrFDwMh4SxIyVJpqYoOWDJ9P895tFuS+XuNzI5UBmBk5U5O4KuJdTnZpSBI4LFA2+ZiJaiwfSwlMA=="],
+
+    "peek-readable": ["peek-readable@4.1.0", "", {}, "sha512-ZI3LnwUv5nOGbQzD9c2iDG6toheuXSZP5esSHBjopsXH4dg19soufvpUGA3uohi5anFtGb2lhAVdHzH6R/Evvg=="],
+
+    "pixelmatch": ["pixelmatch@5.3.0", "", { "dependencies": { "pngjs": "^6.0.0" }, "bin": { "pixelmatch": "bin/pixelmatch" } }, "sha512-o8mkY4E/+LNUf6LzX96ht6k6CEDi65k9G2rjMtBe9Oo+VPKSvl+0GKHuH/AlG+GA5LPG/i5hrekkxUc3s2HU+Q=="],
+
+    "planck": ["planck@1.4.2", "", { "peerDependencies": { "stage-js": "^1.0.0-alpha.12" } }, "sha512-mNbhnV3g8X2rwGxzcesjmN8BDA6qfXgQxXVMkWau9MCRlQY0RLNEkyHlVp6yFy/X6qrzAXyNONCnZ1cGDLrNew=="],
+
+    "pngjs": ["pngjs@7.0.0", "", {}, "sha512-LKWqWJRhstyYo9pGvgor/ivk2w94eSjE3RGVuzLGlr3NmD8bf7RcYGze1mNdEHRP6TRP6rMuDHk5t44hnTRyow=="],
+
+    "process": ["process@0.11.10", "", {}, "sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A=="],
+
+    "react": ["react@19.2.3", "", {}, "sha512-Ku/hhYbVjOQnXDZFv2+RibmLFGwFdeeKHFcOTlrt7xplBnya5OGn/hIRDsqDiSUcfORsDC7MPxwork8jBwsIWA=="],
+
+    "react-devtools-core": ["react-devtools-core@7.0.1", "", { "dependencies": { "shell-quote": "^1.6.1", "ws": "^7" } }, "sha512-C3yNvRHaizlpiASzy7b9vbnBGLrhvdhl1CbdU6EnZgxPNbai60szdLtl+VL76UNOt5bOoVTOz5rNWZxgGt+Gsw=="],
+
+    "react-reconciler": ["react-reconciler@0.32.0", "", { "dependencies": { "scheduler": "^0.26.0" }, "peerDependencies": { "react": "^19.1.0" } }, "sha512-2NPMOzgTlG0ZWdIf3qG+dcbLSoAc/uLfOwckc3ofy5sSK0pLJqnQLpUFxvGcN2rlXSjnVtGeeFLNimCQEj5gOQ=="],
+
+    "readable-stream": ["readable-stream@4.7.0", "", { "dependencies": { "abort-controller": "^3.0.0", "buffer": "^6.0.3", "events": "^3.3.0", "process": "^0.11.10", "string_decoder": "^1.3.0" } }, "sha512-oIGGmcpTLwPga8Bn6/Z75SVaH1z5dUut2ibSyAMVhmUggWpmDn2dapB0n7f8nwaSiRtepAsfJyfXIO5DCVAODg=="],
+
+    "readable-web-to-node-stream": ["readable-web-to-node-stream@3.0.4", "", { "dependencies": { "readable-stream": "^4.7.0" } }, "sha512-9nX56alTf5bwXQ3ZDipHJhusu9NTQJ/CVPtb/XHAJCXihZeitfJvIRS4GqQ/mfIoOE3IelHMrpayVrosdHBuLw=="],
+
+    "safe-buffer": ["safe-buffer@5.2.1", "", {}, "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ=="],
+
+    "sax": ["sax@1.4.4", "", {}, "sha512-1n3r/tGXO6b6VXMdFT54SHzT9ytu9yr7TaELowdYpMqY/Ao7EnlQGmAQ1+RatX7Tkkdm6hONI2owqNx2aZj5Sw=="],
+
+    "scheduler": ["scheduler@0.26.0", "", {}, "sha512-NlHwttCI/l5gCPR3D1nNXtWABUmBwvZpEQiD4IXSbIDq8BzLIK/7Ir5gTFSGZDUu37K5cMNp0hFtzO38sC7gWA=="],
+
+    "shell-quote": ["shell-quote@1.8.3", "", {}, "sha512-ObmnIF4hXNg1BqhnHmgbDETF8dLPCggZWBjkQfhZpbszZnYur5DUljTcCHii5LC3J5E0yeO/1LIMyH+UvHQgyw=="],
+
+    "simple-xml-to-json": ["simple-xml-to-json@1.2.3", "", {}, "sha512-kWJDCr9EWtZ+/EYYM5MareWj2cRnZGF93YDNpH4jQiHB+hBIZnfPFSQiVMzZOdk+zXWqTZ/9fTeQNu2DqeiudA=="],
+
+    "stage-js": ["stage-js@1.0.0-alpha.17", "", {}, "sha512-AzlMO+t51v6cFvKZ+Oe9DJnL1OXEH5s9bEy6di5aOrUpcP7PCzI/wIeXF0u3zg0L89gwnceoKxrLId0ZpYnNXw=="],
+
+    "string_decoder": ["string_decoder@1.3.0", "", { "dependencies": { "safe-buffer": "~5.2.0" } }, "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA=="],
+
+    "strtok3": ["strtok3@6.3.0", "", { "dependencies": { "@tokenizer/token": "^0.3.0", "peek-readable": "^4.1.0" } }, "sha512-fZtbhtvI9I48xDSywd/somNqgUHl2L2cstmXCCif0itOf96jeW18MBSyrLuNicYQVkvpOxkZtkzujiTJ9LW5Jw=="],
+
+    "three": ["three@0.177.0", "", {}, "sha512-EiXv5/qWAaGI+Vz2A+JfavwYCMdGjxVsrn3oBwllUoqYeaBO75J63ZfyaQKoiLrqNHoTlUc6PFgMXnS0kI45zg=="],
+
+    "tinycolor2": ["tinycolor2@1.6.0", "", {}, "sha512-XPaBkWQJdsf3pLKJV9p4qN/S+fm2Oj8AIPo1BTUhg5oxkvm9+SVEGFdhyOz7tTdUTfvxMiAs4sp6/eZO2Ew+pw=="],
+
+    "token-types": ["token-types@4.2.1", "", { "dependencies": { "@tokenizer/token": "^0.3.0", "ieee754": "^1.2.1" } }, "sha512-6udB24Q737UD/SDsKAHI9FCRP7Bqc9D/MQUV02ORQg5iskjtLJlZJNdN4kKtcdtwCeWIwIHDGaUsTsCCAa8sFQ=="],
+
+    "tslog": ["tslog@4.10.2", "", {}, "sha512-XuELoRpMR+sq8fuWwX7P0bcj+PRNiicOKDEb3fGNURhxWVyykCi9BNq7c4uVz7h7P0sj8qgBsr5SWS6yBClq3g=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "utif2": ["utif2@4.1.0", "", { "dependencies": { "pako": "^1.0.11" } }, "sha512-+oknB9FHrJ7oW7A2WZYajOcv4FcDR4CfoGB0dPNfxbi4GO05RRnFmt5oa23+9w32EanrYcSJWspUiJkLMs+37w=="],
+
+    "web-tree-sitter": ["web-tree-sitter@0.25.10", "", { "peerDependencies": { "@types/emscripten": "^1.40.0" }, "optionalPeers": ["@types/emscripten"] }, "sha512-Y09sF44/13XvgVKgO2cNDw5rGk6s26MgoZPXLESvMXeefBf7i6/73eFurre0IsTW6E14Y0ArIzhUMmjoc7xyzA=="],
+
+    "ws": ["ws@8.19.0", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg=="],
+
+    "xml-parse-from-string": ["xml-parse-from-string@1.0.1", "", {}, "sha512-ErcKwJTF54uRzzNMXq2X5sMIy88zJvfN2DmdoQvy7PAFJ+tPRU6ydWuOKNMyfmOjdyBQTFREi60s0Y0SyI0G0g=="],
+
+    "xml2js": ["xml2js@0.5.0", "", { "dependencies": { "sax": ">=0.6.0", "xmlbuilder": "~11.0.0" } }, "sha512-drPFnkQJik/O+uPKpqSgr22mpuFHqKdbS835iAQrUC73L2F5WkboIRd63ai/2Yg6I1jzifPFKH2NTK+cfglkIA=="],
+
+    "xmlbuilder": ["xmlbuilder@11.0.1", "", {}, "sha512-fDlsI/kFEx7gLvbecc0/ohLG50fugQp8ryHzMTuW9vSa1GJ0XYWKnhsUx7oie3G98+r56aTQIUB4kht42R3JvA=="],
+
+    "yoga-layout": ["yoga-layout@3.2.1", "", {}, "sha512-0LPOt3AxKqMdFBZA3HBAt/t/8vIKq7VaQYbuA8WxCgung+p9TVyKRYdpvCb80HcdTN2NkbIKbhNwKUfm3tQywQ=="],
+
+    "zod": ["zod@3.25.76", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
+
+    "image-q/@types/node": ["@types/node@16.9.1", "", {}, "sha512-QpLcX9ZSsq3YYUUnD3nFDY8H7wctAhQj/TFKL8Ya8v5fMm3CFXxo8zStsLAl780ltoYoo1WvKUVGBQK+1ifr7g=="],
+
+    "pixelmatch/pngjs": ["pngjs@6.0.0", "", {}, "sha512-TRzzuFRRmEoSW/p1KVAmiOgPco2Irlah+bGFCeNfJXxxYGwSw7YwAOAcd7X28K/m5bjBWKsC29KyoMfHbypayg=="],
+
+    "react-devtools-core/ws": ["ws@7.5.10", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": "^5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ=="],
+  }
+}

package/examples/tui-app/commands/config/app/get.ts

@@ -0,0 +1,66 @@
+import { 
+    Command, 
+    type AppContext, 
+    type OptionSchema, 
+    type OptionValues,
+    type CommandResult 
+} from "../../../../../src/index.ts";
+
+const options = {
+    key: {
+        type: "string",
+        description: "Application configuration key to get",
+        required: true,
+        label: "Key",
+        order: 1,
+        group: "Required",
+        placeholder: "e.g., port, debug, logLevel",
+    },
+} as const satisfies OptionSchema;
+
+export class AppGetCommand extends Command<typeof options> {
+    readonly name = "get";
+    override displayName = "Get App Config";
+    readonly description = "Get an application configuration value";
+    readonly options = options;
+
+    override readonly actionLabel = "Get Value";
+
+    override readonly examples = [
+        { command: "config app get --key port", description: "Get app port" },
+        { command: "config app get --key logLevel", description: "Get log level" },
+    ];
+
+    override async execute(ctx: AppContext, opts: OptionValues<typeof options>): Promise<CommandResult> {
+        // Simulated app config store
+        const appConfig: Record<string, string | number | boolean> = {
+            port: 3000,
+            debug: true,
+            logLevel: "info",
+            maxConnections: 100,
+            timeout: 30000,
+        };
+
+        const value = appConfig[opts.key];
+        
+        if (value === undefined) {
+            ctx.logger.warn(`Key "${opts.key}" not found in application configuration`);
+            return {
+                success: false,
+                message: `Key "${opts.key}" not found`,
+            };
+        }
+
+        ctx.logger.info(`Retrieved app.${opts.key} = ${value}`);
+        return {
+            success: true,
+            data: { key: opts.key, value },
+        };
+    }
+
+    override renderResult(result: CommandResult): string {
+        if (!result.success) return result.message || "Error";
+        const data = result.data as { key: string; value: string | number | boolean };
+        return `app.${data.key} = ${JSON.stringify(data.value)}`;
+    }
+}

package/examples/tui-app/commands/config/app/index.ts

@@ -0,0 +1,27 @@
+import { 
+    Command, 
+    type AppContext,
+    type CommandResult 
+} from "../../../../../src/index.ts";
+import { AppGetCommand } from "./get.ts";
+import { AppSetCommand } from "./set.ts";
+
+export class AppConfigCommand extends Command {
+    readonly name = "app";
+    override displayName = "App Settings";
+    readonly description = "Manage application configuration";
+    readonly options = {};
+
+    override readonly subCommands = [
+        new AppGetCommand(),
+        new AppSetCommand(),
+    ];
+
+    override execute(_ctx: AppContext): CommandResult {
+        console.log("Use 'config app <command>' for application configuration.");
+        console.log("Available: get, set");
+        return { success: true };
+    }
+}
+
+export { AppGetCommand, AppSetCommand };

package/examples/tui-app/commands/config/app/set.ts

@@ -0,0 +1,86 @@
+import { 
+    Command, 
+    type AppContext, 
+    type OptionSchema, 
+    type OptionValues,
+    type CommandResult 
+} from "../../../../../src/index.ts";
+
+const options = {
+    key: {
+        type: "string",
+        description: "Application configuration key to set",
+        required: true,
+        label: "Key",
+        order: 1,
+        group: "Required",
+        placeholder: "e.g., port, debug, logLevel",
+    },
+    value: {
+        type: "string",
+        description: "Value to set",
+        required: true,
+        label: "Value",
+        order: 2,
+        group: "Required",
+        placeholder: "Enter value...",
+    },
+    type: {
+        type: "string",
+        description: "Value type for parsing",
+        enum: ["string", "number", "boolean"] as const,
+        default: "string",
+        label: "Value Type",
+        order: 3,
+        group: "Options",
+    },
+} as const satisfies OptionSchema;
+
+export class AppSetCommand extends Command<typeof options> {
+    readonly name = "set";
+    override displayName = "Set App Config";
+    readonly description = "Set an application configuration value";
+    readonly options = options;
+
+    override readonly actionLabel = "Set Value";
+
+    override readonly examples = [
+        { command: "config app set --key port --value 8080 --type number", description: "Set app port" },
+        { command: "config app set --key debug --value false --type boolean", description: "Disable debug" },
+    ];
+
+    override async execute(ctx: AppContext, opts: OptionValues<typeof options>): Promise<CommandResult> {
+        let parsedValue: string | number | boolean = opts.value;
+        
+        // Parse value based on type
+        if (opts.type === "number") {
+            parsedValue = Number(opts.value);
+            if (isNaN(parsedValue)) {
+                ctx.logger.error(`Invalid number value: "${opts.value}"`);
+                return {
+                    success: false,
+                    message: `Invalid number: "${opts.value}"`,
+                };
+            }
+        } else if (opts.type === "boolean") {
+            parsedValue = opts.value.toLowerCase() === "true";
+        }
+
+        ctx.logger.info(`Setting app.${opts.key} = ${JSON.stringify(parsedValue)}`);
+        
+        // Simulate setting the value
+        await new Promise(resolve => setTimeout(resolve, 300));
+        
+        ctx.logger.info(`Successfully updated application configuration`);
+        return {
+            success: true,
+            data: { key: opts.key, value: parsedValue, type: opts.type },
+        };
+    }
+
+    override renderResult(result: CommandResult): string {
+        if (!result.success) return result.message || "Error";
+        const data = result.data as { key: string; value: string | number | boolean; type: string };
+        return `✓ Set app.${data.key} = ${JSON.stringify(data.value)} (${data.type})`;
+    }
+}

package/examples/tui-app/commands/config/index.ts

@@ -0,0 +1,32 @@
+import { 
+    Command, 
+    type AppContext,
+    type CommandResult 
+} from "../../../../src/index.ts";
+import { UserConfigCommand } from "./user/index.ts";
+import { AppConfigCommand } from "./app/index.ts";
+
+export class ConfigCommand extends Command {
+    readonly name = "config";
+    override displayName = "Config";
+    readonly description = "Manage configuration (user and app settings)";
+    readonly options = {};
+
+    override readonly subCommands = [
+        new UserConfigCommand(),
+        new AppConfigCommand(),
+    ];
+
+    override readonly examples = [
+        { command: "config user get --key name", description: "Get user name" },
+        { command: "config user set --key theme --value dark", description: "Set user theme" },
+        { command: "config app get --key port", description: "Get app port" },
+        { command: "config app set --key debug --value true --type boolean", description: "Enable debug mode" },
+    ];
+
+    override execute(_ctx: AppContext): CommandResult {
+        console.log("Use 'config <category> <command>' to manage settings.");
+        console.log("Categories: user, app");
+        return { success: true };
+    }
+}

package/examples/tui-app/commands/config/user/get.ts

@@ -0,0 +1,65 @@
+import { 
+    Command, 
+    type AppContext, 
+    type OptionSchema, 
+    type OptionValues,
+    type CommandResult 
+} from "../../../../../src/index.ts";
+
+const options = {
+    key: {
+        type: "string",
+        description: "Configuration key to get",
+        required: true,
+        label: "Key",
+        order: 1,
+        group: "Required",
+        placeholder: "e.g., name, email, theme",
+    },
+} as const satisfies OptionSchema;
+
+export class UserGetCommand extends Command<typeof options> {
+    readonly name = "get";
+    override displayName = "Get User Config";
+    readonly description = "Get a user configuration value";
+    readonly options = options;
+
+    override readonly actionLabel = "Get Value";
+
+    override readonly examples = [
+        { command: "config user get --key name", description: "Get user name" },
+        { command: "config user get --key email", description: "Get user email" },
+    ];
+
+    override async execute(ctx: AppContext, opts: OptionValues<typeof options>): Promise<CommandResult> {
+        // Simulated user config store
+        const userConfig: Record<string, string> = {
+            name: "John Doe",
+            email: "john@example.com",
+            theme: "dark",
+            language: "en",
+        };
+
+        const value = userConfig[opts.key];
+        
+        if (value === undefined) {
+            ctx.logger.warn(`Key "${opts.key}" not found in user configuration`);
+            return {
+                success: false,
+                message: `Key "${opts.key}" not found`,
+            };
+        }
+
+        ctx.logger.info(`Retrieved user.${opts.key} = ${value}`);
+        return {
+            success: true,
+            data: { key: opts.key, value },
+        };
+    }
+
+    override renderResult(result: CommandResult): string {
+        if (!result.success) return result.message || "Error";
+        const data = result.data as { key: string; value: string };
+        return `user.${data.key} = "${data.value}"`;
+    }
+}

package/examples/tui-app/commands/config/user/index.ts

@@ -0,0 +1,27 @@
+import { 
+    Command, 
+    type AppContext,
+    type CommandResult 
+} from "../../../../../src/index.ts";
+import { UserGetCommand } from "./get.ts";
+import { UserSetCommand } from "./set.ts";
+
+export class UserConfigCommand extends Command {
+    readonly name = "user";
+    override displayName = "User Settings";
+    readonly description = "Manage user configuration";
+    readonly options = {};
+
+    override readonly subCommands = [
+        new UserGetCommand(),
+        new UserSetCommand(),
+    ];
+
+    override execute(_ctx: AppContext): CommandResult {
+        console.log("Use 'config user <command>' for user configuration.");
+        console.log("Available: get, set");
+        return { success: true };
+    }
+}
+
+export { UserGetCommand, UserSetCommand };

package/examples/tui-app/commands/config/user/set.ts

@@ -0,0 +1,61 @@
+import { 
+    Command, 
+    type AppContext, 
+    type OptionSchema, 
+    type OptionValues,
+    type CommandResult 
+} from "../../../../../src/index.ts";
+
+const options = {
+    key: {
+        type: "string",
+        description: "Configuration key to set",
+        required: true,
+        label: "Key",
+        order: 1,
+        group: "Required",
+        placeholder: "e.g., name, email, theme",
+    },
+    value: {
+        type: "string",
+        description: "Value to set",
+        required: true,
+        label: "Value",
+        order: 2,
+        group: "Required",
+        placeholder: "Enter value...",
+    },
+} as const satisfies OptionSchema;
+
+export class UserSetCommand extends Command<typeof options> {
+    readonly name = "set";
+    override displayName = "Set User Config";
+    readonly description = "Set a user configuration value";
+    readonly options = options;
+
+    override readonly actionLabel = "Set Value";
+
+    override readonly examples = [
+        { command: "config user set --key name --value 'Jane Doe'", description: "Set user name" },
+        { command: "config user set --key theme --value light", description: "Set theme" },
+    ];
+
+    override async execute(ctx: AppContext, opts: OptionValues<typeof options>): Promise<CommandResult> {
+        ctx.logger.info(`Setting user.${opts.key} = "${opts.value}"`);
+        
+        // Simulate setting the value
+        await new Promise(resolve => setTimeout(resolve, 300));
+        
+        ctx.logger.info(`Successfully updated user configuration`);
+        return {
+            success: true,
+            data: { key: opts.key, value: opts.value },
+        };
+    }
+
+    override renderResult(result: CommandResult): string {
+        if (!result.success) return result.message || "Error";
+        const data = result.data as { key: string; value: string };
+        return `✓ Set user.${data.key} = "${data.value}"`;
+    }
+}

package/examples/tui-app/commands/greet.ts

@@ -37,6 +37,7 @@ const greetOptions = {
 
 export class GreetCommand extends Command<typeof greetOptions> {
     readonly name = "greet";
+    override displayName = "Greet";
     readonly description = "Greet someone with a friendly message";
     readonly options = greetOptions;
 

package/examples/tui-app/commands/index.ts

@@ -1,3 +1,4 @@
 export { GreetCommand } from "./greet.ts";
 export { MathCommand } from "./math.ts";
 export { StatusCommand } from "./status.ts";
+export { ConfigCommand } from "./config/index.ts";

package/examples/tui-app/commands/math.ts

@@ -44,6 +44,7 @@ const mathOptions = {
 
 export class MathCommand extends Command<typeof mathOptions> {
     readonly name = "math";
+    override displayName = "Math Operations";
     readonly description = "Perform basic math operations";
     readonly options = mathOptions;
 

package/examples/tui-app/commands/status.ts

@@ -12,12 +12,14 @@ const statusOptions = {
         description: "Show detailed status",
         default: false,
         label: "Detailed",
+        alias: "d",
         order: 1,
     },
 } as const satisfies OptionSchema;
 
 export class StatusCommand extends Command<typeof statusOptions> {
     readonly name = "status";
+    override displayName = "Status";
     readonly description = "Show application status";
     readonly options = statusOptions;
 
@@ -39,7 +41,7 @@ export class StatusCommand extends Command<typeof statusOptions> {
             `  Uptime:   ${data.uptime}`,
             `  Memory:   ${data.memory}`,
             `  Platform: ${data.platform}`,
-            `  Node:     ${data.version}`,
+            `  Bun:      ${data.version}`,
         ].join("\n");
     }
 

package/examples/tui-app/index.ts

@@ -13,7 +13,7 @@
  */
 
 import { TuiApplication } from "../../src/index.ts";
-import { GreetCommand, MathCommand, StatusCommand } from "./commands/index.ts";
+import { GreetCommand, MathCommand, StatusCommand, ConfigCommand } from "./commands/index.ts";
 
 class ExampleApp extends TuiApplication {
     constructor() {
@@ -24,6 +24,7 @@ class ExampleApp extends TuiApplication {
                 new GreetCommand(),
                 new MathCommand(),
                 new StatusCommand(),
+                new ConfigCommand(),
             ],
             enableTui: true,
         });

package/guides/07-async-cancellation.md

@@ -246,58 +246,7 @@ export class DownloadCommand extends Command<typeof options, DownloadConfig> {
 }
 ```
 
-## Step 4: Add Result Rendering
-
-```typescript
-import React from "react";
-import { Text, Box } from "ink";
-
-export class DownloadCommand extends Command<typeof options, DownloadConfig> {
-  // ... previous code ...
-
-  /**
-   * Custom TUI result display
-   */
-  override renderResult(result: CommandResult): React.ReactNode {
-    if (!result.success && result.data?.cancelled) {
-      return (
-        <Box flexDirection="column">
-          <Text color="yellow">⚠ Download Cancelled</Text>
-          {result.data?.downloadedBytes > 0 && (
-            <Text dimColor>
-              Partial: {(result.data.downloadedBytes / 1024 / 1024).toFixed(2)} MB
-            </Text>
-          )}
-        </Box>
-      );
-    }
-
-    if (!result.success) {
-      return <Text color="red">✗ {result.message}</Text>;
-    }
-
-    return (
-      <Box flexDirection="column">
-        <Text color="green">✓ Download Complete</Text>
-        <Text>File: {result.data?.file}</Text>
-        <Text>Size: {(result.data?.size / 1024 / 1024).toFixed(2)} MB</Text>
-      </Box>
-    );
-  }
-
-  /**
-   * Copy file path to clipboard
-   */
-  override getClipboardContent(result: CommandResult): string | undefined {
-    if (result.success && result.data?.file) {
-      return result.data.file;
-    }
-    return undefined;
-  }
-}
-```
-
-## Step 5: Create the Application
+## Step 4: Create the Application
 
 Create `src/index.ts`:
 
@@ -381,7 +330,6 @@ try {
 - Pass signal to `fetch` and other async APIs
 - Clean up resources on cancellation
 - Return meaningful results for cancelled operations
-- Render different UI for cancelled vs success vs error
 
 ## Next Steps
 

package/guides/08-complete-application.md

@@ -149,8 +149,6 @@ export class NotificationService {
 Create `src/commands/add.ts`:
 
 ```typescript
-import React from "react";
-import { Text, Box } from "ink";
 import {
   Command,
   ConfigValidationError,
@@ -231,49 +229,12 @@ export class AddCommand extends Command<typeof options, AddConfig> {
       message: `Created task: ${task.title} (${task.id})`,
     };
   }
-
-  override renderResult(result: CommandResult): React.ReactNode {
-    if (!result.success) {
-      return <Text color="red">✗ {result.message}</Text>;
-    }
-
-    const task = result.data as Task;
-    const priorityColor = {
-      high: "red",
-      medium: "yellow",
-      low: "green",
-    }[task.priority] as "red" | "yellow" | "green";
-
-    return (
-      <Box flexDirection="column" gap={1}>
-        <Text color="green">✓ Task Created</Text>
-        <Box>
-          <Text dimColor>ID: </Text>
-          <Text>{task.id}</Text>
-        </Box>
-        <Box>
-          <Text dimColor>Title: </Text>
-          <Text>{task.title}</Text>
-        </Box>
-        <Box>
-          <Text dimColor>Priority: </Text>
-          <Text color={priorityColor}>{task.priority}</Text>
-        </Box>
-      </Box>
-    );
-  }
-
-  override getClipboardContent(result: CommandResult): string | undefined {
-    return result.data?.id;
-  }
 }
 ```
 
 Create `src/commands/list.ts`:
 
 ```typescript
-import React from "react";
-import { Text, Box } from "ink";
 import {
   Command,
   type AppContext,
@@ -344,45 +305,12 @@ export class ListCommand extends Command<typeof options, ListConfig> {
       message: `Found ${tasks.length} tasks`,
     };
   }
-
-  override renderResult(result: CommandResult): React.ReactNode {
-    const tasks = (result.data as Task[]) ?? [];
-
-    if (tasks.length === 0) {
-      return <Text dimColor>No tasks found</Text>;
-    }
-
-    const priorityColor = (p: string) =>
-      ({ high: "red", medium: "yellow", low: "green" })[p] as "red" | "yellow" | "green";
-
-    return (
-      <Box flexDirection="column" gap={1}>
-        <Text bold>Tasks ({tasks.length})</Text>
-        {tasks.map((task) => (
-          <Box key={task.id} gap={2}>
-            <Text dimColor>[{task.id}]</Text>
-            <Text color={task.status === "completed" ? "gray" : undefined}>
-              {task.status === "completed" ? "✓" : "○"} {task.title}
-            </Text>
-            <Text color={priorityColor(task.priority)}>{task.priority}</Text>
-          </Box>
-        ))}
-      </Box>
-    );
-  }
-
-  override getClipboardContent(result: CommandResult): string | undefined {
-    const tasks = result.data as Task[];
-    return tasks?.map((t) => `${t.id}: ${t.title}`).join("\n");
-  }
 }
 ```
 
 Create `src/commands/complete.ts`:
 
 ```typescript
-import React from "react";
-import { Text, Box } from "ink";
 import {
   Command,
   ConfigValidationError,
@@ -451,31 +379,12 @@ export class CompleteCommand extends Command<typeof options, CompleteConfig> {
       message: `Completed: ${task.title}`,
     };
   }
-
-  override renderResult(result: CommandResult): React.ReactNode {
-    if (!result.success) {
-      return <Text color="red">✗ {result.message}</Text>;
-    }
-
-    const task = result.data as Task;
-    return (
-      <Box flexDirection="column">
-        <Text color="green">✓ Task Completed</Text>
-        <Text>{task.title}</Text>
-        <Text dimColor>
-          Completed at: {task.completedAt?.toLocaleString()}
-        </Text>
-      </Box>
-    );
-  }
 }
 ```
 
 Create `src/commands/stats.ts`:
 
 ```typescript
-import React from "react";
-import { Text, Box } from "ink";
 import {
   Command,
   type AppContext,
@@ -510,50 +419,6 @@ export class StatsCommand extends Command<typeof options> {
       message: `Total: ${stats.total}, Pending: ${stats.pending}, Completed: ${stats.completed}`,
     };
   }
-
-  override renderResult(result: CommandResult): React.ReactNode {
-    const stats = result.data as TaskStats;
-
-    const completionRate = stats.total > 0
-      ? Math.round((stats.completed / stats.total) * 100)
-      : 0;
-
-    return (
-      <Box flexDirection="column" gap={1}>
-        <Text bold>📊 Task Statistics</Text>
-        
-        <Box flexDirection="column">
-          <Box gap={2}>
-            <Text dimColor>Total:</Text>
-            <Text>{stats.total}</Text>
-          </Box>
-          <Box gap={2}>
-            <Text dimColor>Pending:</Text>
-            <Text color="yellow">{stats.pending}</Text>
-          </Box>
-          <Box gap={2}>
-            <Text dimColor>Completed:</Text>
-            <Text color="green">{stats.completed}</Text>
-          </Box>
-          <Box gap={2}>
-            <Text dimColor>Completion Rate:</Text>
-            <Text color={completionRate >= 50 ? "green" : "yellow"}>
-              {completionRate}%
-            </Text>
-          </Box>
-        </Box>
-
-        <Box flexDirection="column" marginTop={1}>
-          <Text bold>By Priority:</Text>
-          <Box gap={2}>
-            <Text color="red">High: {stats.byPriority.high}</Text>
-            <Text color="yellow">Medium: {stats.byPriority.medium}</Text>
-            <Text color="green">Low: {stats.byPriority.low}</Text>
-          </Box>
-        </Box>
-      </Box>
-    );
-  }
 }
 ```
 
@@ -647,7 +512,6 @@ bun start --verbose add "Debug task" --priority low
 | Display Names | `displayName = "Add Task"` |
 | Action Labels | `actionLabel = "Create Task"` |
 | Immediate Execution | `immediateExecution = true` |
-| Custom Results | `renderResult()` |
 | Clipboard Support | `getClipboardContent()` |
 
 ## What You Learned
@@ -655,7 +519,7 @@ bun start --verbose add "Debug task" --priority low
 - **Project Structure**: Organize code into commands, services, types
 - **Shared Services**: Database and notification services
 - **Command Groups**: Organize commands in TUI sidebar
-- **Full TUI Integration**: Custom rendering, clipboard, immediate execution
+- **Full TUI Integration**: Clipboard, immediate execution
 - **Lifecycle Hooks**: `onBeforeRun` and `onAfterRun`
 - **Production Patterns**: Error handling, validation, logging
 

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@pablozaiden/terminatui",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Terminal UI and Command Line Application Framework",
+  "repository": {
+    "url": "https://github.com/PabloZaiden/terminatui"
+  },
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/builtins/help.ts

@@ -33,6 +33,13 @@ export class HelpCommand extends Command<OptionSchema> {
     this.appVersion = config.appVersion;
   }
 
+  /**
+   * Help command is CLI-only (auto-injected for CLI use, not shown in TUI).
+   */
+  override supportsTui(): boolean {
+    return false;
+  }
+
   override async execute(_ctx: AppContext): Promise<void> {
     let helpText: string;
 

package/src/tui/TuiApp.tsx

@@ -91,6 +91,7 @@ function TuiAppContent({
     const [selectedCommand, setSelectedCommand] = useState<AnyCommand | null>(null);
     const [commandPath, setCommandPath] = useState<string[]>([]);
     const [commandSelectorIndex, setCommandSelectorIndex] = useState(0);
+    const [selectorIndexStack, setSelectorIndexStack] = useState<number[]>([]);
     const [selectedFieldIndex, setSelectedFieldIndex] = useState(0);
     const [editingField, setEditingField] = useState<string | null>(null);
     const [focusedSection, setFocusedSection] = useState<FocusedSection>(FocusedSection.Config);
@@ -133,9 +134,27 @@ function TuiAppContent({
         return buildCliCommand(name, commandPath, selectedCommand.options, configValues as OptionValues<OptionSchema>);
     }, [name, commandPath, selectedCommand, configValues]);
 
+    // Build breadcrumb with display names by traversing the command path
     const breadcrumb = useMemo(() => {
-        return commandPath.length > 0 ? commandPath : undefined;
-    }, [commandPath]);
+        if (commandPath.length === 0) return undefined;
+        
+        const displayNames: string[] = [];
+        let current: AnyCommand[] = commands;
+        
+        for (const pathPart of commandPath) {
+            const found = current.find((c) => c.name === pathPart);
+            if (found) {
+                displayNames.push(found.displayName ?? found.name);
+                if (found.subCommands) {
+                    current = found.subCommands;
+                }
+            } else {
+                displayNames.push(pathPart);
+            }
+        }
+        
+        return displayNames;
+    }, [commandPath, commands]);
 
     // Initialize config values when command changes
     const initializeConfigValues = useCallback((cmd: AnyCommand) => {
@@ -178,10 +197,22 @@ function TuiAppContent({
         setConfigValues(merged);
     }, [customFields, name]);
 
+    /**
+     * Check if a command has navigable subcommands (excluding commands that don't support TUI).
+     */
+    const hasNavigableSubCommands = useCallback((cmd: AnyCommand): boolean => {
+        if (!cmd.subCommands || cmd.subCommands.length === 0) return false;
+        // Filter out commands that don't support TUI
+        const navigable = cmd.subCommands.filter((sub) => sub.supportsTui());
+        return navigable.length > 0;
+    }, []);
+
     // Handlers
     const handleCommandSelect = useCallback((cmd: AnyCommand) => {
-        // Check if command has subcommands to navigate into
-        if (cmd.subCommands && cmd.subCommands.length > 0 && !cmd.supportsTui() && !cmd.supportsCli()) {
+        // Check if command has navigable subcommands (container commands)
+        if (hasNavigableSubCommands(cmd)) {
+            // Push current selection index to stack before navigating
+            setSelectorIndexStack((prev) => [...prev, commandSelectorIndex]);
             // Navigate into subcommands
             setCommandPath((prev) => [...prev, cmd.name]);
             setCommandSelectorIndex(0);
@@ -201,7 +232,7 @@ function TuiAppContent({
         } else {
             setMode(Mode.Config);
         }
-    }, [initializeConfigValues]);
+    }, [initializeConfigValues, hasNavigableSubCommands, commandSelectorIndex]);
 
     const handleBack = useCallback(() => {
         if (mode === Mode.Running) {
@@ -242,12 +273,15 @@ function TuiAppContent({
             }
             resetExecutor();
         } else if (mode === Mode.CommandSelect && commandPath.length > 0) {
+            // Pop from selector index stack to restore previous selection
+            const previousIndex = selectorIndexStack[selectorIndexStack.length - 1] ?? 0;
+            setSelectorIndexStack((prev) => prev.slice(0, -1));
+            setCommandSelectorIndex(previousIndex);
             setCommandPath((prev) => prev.slice(0, -1));
-            setCommandSelectorIndex(0);
         } else {
             onExit();
         }
-    }, [mode, commandPath, selectedCommand, cancel, onExit, resetExecutor]);
+    }, [mode, commandPath, selectedCommand, selectorIndexStack, cancel, onExit, resetExecutor]);
 
     const handleRunCommand = useCallback(async (cmd?: AnyCommand) => {
         const cmdToRun = cmd ?? selectedCommand;
@@ -413,18 +447,21 @@ function TuiAppContent({
         { enabled: !editingField && !cliModalVisible }
     );
 
-    // Get current commands for selector
+    // Get current commands for selector (excluding commands that don't support TUI)
     const currentCommands = useMemo(() => {
         if (commandPath.length === 0) {
-            return commands;
+            return commands.filter((cmd) => cmd.supportsTui());
         }
 
-        // Navigate to current path
+        // Navigate through the full path to find current level's subcommands
         let current: AnyCommand[] = commands;
-        for (const pathPart of commandPath.slice(0, -1)) {
+        for (const pathPart of commandPath) {
             const found = current.find((c) => c.name === pathPart);
             if (found?.subCommands) {
-                current = found.subCommands;
+                // Filter out commands that don't support TUI
+                current = found.subCommands.filter((sub) => sub.supportsTui());
+            } else {
+                break; // Path invalid or command has no subcommands
             }
         }
         return current;
@@ -477,7 +514,7 @@ function TuiAppContent({
                         onSelectionChange={setCommandSelectorIndex}
                         onSelect={handleCommandSelect}
                         onExit={handleBack}
-                        breadcrumb={commandPath.length > 0 ? commandPath : undefined}
+                        breadcrumb={breadcrumb}
                     />
                 );
 
@@ -486,7 +523,7 @@ function TuiAppContent({
                 return (
                     <box flexDirection="column" flexGrow={1}>
                         <ConfigForm
-                            title={`Configure: ${selectedCommand.name}`}
+                            title={`Configure: ${selectedCommand.displayName ?? selectedCommand.name}`}
                             fieldConfigs={fieldConfigs}
                             values={configValues}
                             selectedIndex={selectedFieldIndex}

package/src/tui/components/CommandSelector.tsx

@@ -146,9 +146,16 @@ export function CommandSelector({
 }
 
 /**
- * Get mode indicator for a command (e.g., "[cli]", "[tui]", "[cli/tui]").
+ * Get mode indicator for a command (e.g., "[cli]", "[tui]", "→" for subcommands).
  */
 function getModeIndicator(command: Command): string {
+    // Show navigation indicator for container commands with navigable subcommands
+    // (excluding commands that don't support TUI)
+    const navigableSubCommands = command.subCommands?.filter((sub) => sub.supportsTui()) ?? [];
+    if (navigableSubCommands.length > 0) {
+        return "→";
+    }
+    
     const cli = command.supportsCli();
     const tui = command.supportsTui();