@flyingrobots/bijou-node 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Flying Robots
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @flyingrobots/bijou-node
+
+Node.js adapter for bijou — chalk styling, readline I/O, process runtime.
+
+## Install
+
+```bash
+npm install @flyingrobots/bijou @flyingrobots/bijou-node
+```
+
+## Usage
+
+```typescript
+import { initDefaultContext } from '@flyingrobots/bijou-node';
+import { box, headerBox } from '@flyingrobots/bijou';
+
+// Wire up Node.js adapters and set the default context.
+// Auto-detects TTY, CI, NO_COLOR, and TERM=dumb.
+initDefaultContext();
+
+console.log(headerBox('My CLI', { detail: 'v1.0.0' }));
+```
+
+## What It Provides
+
+`bijou-node` implements the three ports that `@flyingrobots/bijou` requires:
+
+| Port | Implementation | What it does |
+| :--- | :--- | :--- |
+| `RuntimePort` | `nodeRuntime()` | `process.env`, `setTimeout`, exit handling |
+| `IOPort` | `nodeIO()` | `process.stdout/stdin`, readline |
+| `StylePort` | `chalkStyle()` | RGB/hex color via chalk, respects `NO_COLOR` |
+
+### API
+
+```typescript
+// Individual port factories
+import { nodeRuntime, nodeIO, chalkStyle } from '@flyingrobots/bijou-node';
+
+// All-in-one context (most common)
+import { createNodeContext, initDefaultContext } from '@flyingrobots/bijou-node';
+
+// createNodeContext() — returns a BijouContext without setting it as default
+const ctx = createNodeContext();
+
+// initDefaultContext() — creates context AND registers it as the global default
+initDefaultContext();
+```
+
+## Related Packages
+
+- [`@flyingrobots/bijou`](https://www.npmjs.com/package/@flyingrobots/bijou) — Zero-dependency core with all components and theme engine
+- [`@flyingrobots/bijou-tui`](https://www.npmjs.com/package/@flyingrobots/bijou-tui) — TEA runtime for interactive terminal apps
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { BijouContext } from '@flyingrobots/bijou';
+export { nodeRuntime } from './runtime.js';
+export { nodeIO } from './io.js';
+export { chalkStyle } from './style.js';
+export declare function createNodeContext(): BijouContext;
+export declare function _resetInitializedForTesting(): void;
+export declare function initDefaultContext(): BijouContext;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,wBAAgB,iBAAiB,IAAI,YAAY,CAQhD;AAGD,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AACD,wBAAgB,kBAAkB,IAAI,YAAY,CAQjD"}

package/dist/index.js

@@ -0,0 +1,30 @@
+import { createBijou, setDefaultContext } from '@flyingrobots/bijou';
+import { nodeRuntime } from './runtime.js';
+import { nodeIO } from './io.js';
+import { chalkStyle } from './style.js';
+export { nodeRuntime } from './runtime.js';
+export { nodeIO } from './io.js';
+export { chalkStyle } from './style.js';
+export function createNodeContext() {
+    const runtime = nodeRuntime();
+    const noColor = runtime.env('NO_COLOR') !== undefined;
+    return createBijou({
+        runtime,
+        io: nodeIO(),
+        style: chalkStyle(noColor),
+    });
+}
+let initialized = false;
+export function _resetInitializedForTesting() {
+    initialized = false;
+}
+export function initDefaultContext() {
+    if (!initialized) {
+        const ctx = createNodeContext();
+        setDefaultContext(ctx);
+        initialized = true;
+        return ctx;
+    }
+    return createNodeContext();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC;IACtD,OAAO,WAAW,CAAC;QACjB,OAAO;QACP,EAAE,EAAE,MAAM,EAAE;QACZ,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,MAAM,UAAU,2BAA2B;IACzC,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC;AACD,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAChC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACvB,WAAW,GAAG,IAAI,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,3 @@
+import type { IOPort } from '@flyingrobots/bijou';
+export declare function nodeIO(): IOPort;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAA+B,MAAM,qBAAqB,CAAC;AAE/E,wBAAgB,MAAM,IAAI,MAAM,CAwD/B"}

package/dist/io.js

@@ -0,0 +1,55 @@
+import * as readline from 'readline';
+import { readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+export function nodeIO() {
+    return {
+        write(data) {
+            process.stdout.write(data);
+        },
+        question(prompt) {
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            return new Promise((resolve) => {
+                rl.question(prompt, (answer) => {
+                    rl.close();
+                    resolve(answer);
+                });
+            });
+        },
+        rawInput(onKey) {
+            process.stdin.setRawMode(true);
+            process.stdin.resume();
+            const handler = (data) => {
+                onKey(data.toString());
+            };
+            process.stdin.on('data', handler);
+            return {
+                dispose() {
+                    process.stdin.removeListener('data', handler);
+                    process.stdin.setRawMode(false);
+                    process.stdin.pause();
+                },
+            };
+        },
+        setInterval(callback, ms) {
+            const id = globalThis.setInterval(callback, ms);
+            return {
+                dispose() {
+                    clearInterval(id);
+                },
+            };
+        },
+        readFile(path) {
+            return readFileSync(path, 'utf8');
+        },
+        readDir(path) {
+            return readdirSync(path);
+        },
+        joinPath(...segments) {
+            return join(...segments);
+        },
+    };
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,UAAU,MAAM;IACpB,OAAO;QACL,KAAK,CAAC,IAAY;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,QAAQ,CAAC,MAAc;YACrB,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;gBAClC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;gBACrC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;oBAC7B,EAAE,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,KAA4B;YACnC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,CAAC,IAAY,EAAQ,EAAE;gBACrC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzB,CAAC,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAClC,OAAO;gBACL,OAAO;oBACL,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;oBAC9C,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;oBAChC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACxB,CAAC;aACF,CAAC;QACJ,CAAC;QAED,WAAW,CAAC,QAAoB,EAAE,EAAU;YAC1C,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChD,OAAO;gBACL,OAAO;oBACL,aAAa,CAAC,EAAE,CAAC,CAAC;gBACpB,CAAC;aACF,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,IAAY;YACnB,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,CAAC,IAAY;YAClB,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,QAAQ,CAAC,GAAG,QAAkB;YAC5B,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimePort } from '@flyingrobots/bijou';
+export declare function nodeRuntime(): RuntimePort;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,wBAAgB,WAAW,IAAI,WAAW,CAkBzC"}

package/dist/runtime.js

@@ -0,0 +1,20 @@
+export function nodeRuntime() {
+    return {
+        env(key) {
+            return process.env[key];
+        },
+        get stdoutIsTTY() {
+            return process.stdout.isTTY ?? false;
+        },
+        get stdinIsTTY() {
+            return process.stdin.isTTY ?? false;
+        },
+        get columns() {
+            return process.stdout.columns ?? 80;
+        },
+        get rows() {
+            return process.stdout.rows ?? 24;
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,GAAG,CAAC,GAAW;YACb,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,WAAW;YACb,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;QACvC,CAAC;QACD,IAAI,UAAU;YACZ,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;QACtC,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,IAAI,IAAI;YACN,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/style.d.ts

@@ -0,0 +1,3 @@
+import type { StylePort } from '@flyingrobots/bijou';
+export declare function chalkStyle(noColor?: boolean): StylePort;
+//# sourceMappingURL=style.d.ts.map

package/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,qBAAqB,CAAC;AAEjE,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAyCvD"}

package/dist/style.js

@@ -0,0 +1,50 @@
+import chalk from 'chalk';
+export function chalkStyle(noColor) {
+    const isNoColor = noColor ?? false;
+    function applyModifiers(c, modifiers) {
+        if (modifiers === undefined)
+            return c;
+        let result = c;
+        for (const mod of modifiers) {
+            switch (mod) {
+                case 'bold':
+                    result = result.bold;
+                    break;
+                case 'dim':
+                    result = result.dim;
+                    break;
+                case 'strikethrough':
+                    result = result.strikethrough;
+                    break;
+                case 'inverse':
+                    result = result.inverse;
+                    break;
+                default: {
+                    const _exhaustive = mod;
+                    void _exhaustive;
+                }
+            }
+        }
+        return result;
+    }
+    return {
+        styled(token, text) {
+            const base = isNoColor ? chalk : chalk.hex(token.hex);
+            return applyModifiers(base, token.modifiers)(text);
+        },
+        rgb(r, g, b, text) {
+            if (isNoColor)
+                return text;
+            return chalk.rgb(r, g, b)(text);
+        },
+        hex(color, text) {
+            if (isNoColor)
+                return text;
+            return chalk.hex(color)(text);
+        },
+        bold(text) {
+            return chalk.bold(text);
+        },
+    };
+}
+//# sourceMappingURL=style.js.map

package/dist/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA,OAAO,KAA6B,MAAM,OAAO,CAAC;AAGlD,MAAM,UAAU,UAAU,CAAC,OAAiB;IAC1C,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,CAAC;IAEnC,SAAS,cAAc,CAAC,CAAgB,EAAE,SAAmC;QAC3E,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QACtC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,QAAQ,GAAG,EAAE,CAAC;gBACZ,KAAK,MAAM;oBAAW,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;oBAAC,MAAM;gBAClD,KAAK,KAAK;oBAAY,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;oBAAC,MAAM;gBACjD,KAAK,eAAe;oBAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;oBAAC,MAAM;gBAC3D,KAAK,SAAS;oBAAQ,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;oBAAC,MAAM;gBACrD,OAAO,CAAC,CAAC,CAAC;oBACR,MAAM,WAAW,GAAU,GAAG,CAAC;oBAC/B,KAAK,WAAW,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,MAAM,CAAC,KAAiB,EAAE,IAAY;YACpC,MAAM,IAAI,GAAkB,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrE,OAAO,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;QAED,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,IAAY;YAC/C,IAAI,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,GAAG,CAAC,KAAa,EAAE,IAAY;YAC7B,IAAI,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,IAAY;YACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@flyingrobots/bijou-node",
+  "version": "0.1.0",
+  "description": "Node.js adapter for bijou — chalk styling, readline I/O, process runtime.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "prepack": "tsc -b",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@flyingrobots/bijou": "0.1.0",
+    "chalk": "^5.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "cli",
+    "terminal",
+    "bijou",
+    "node",
+    "adapter",
+    "chalk"
+  ],
+  "author": "James Ross <james@flyingrobots.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flyingrobots/bijou.git",
+    "directory": "packages/bijou-node"
+  },
+  "homepage": "https://github.com/flyingrobots/bijou",
+  "bugs": "https://github.com/flyingrobots/bijou/issues",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}