@promptctl/rich-js 0.17.0 → 0.18.1

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@promptctl/rich-js",
-  "version": "0.17.0",
+  "version": "0.18.1",
   "description": "Rich text and beautiful formatting in the terminal — a TypeScript port of Python's Rich",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brandon-fryslie/rich-js"
+  },
   "type": "module",
   "sideEffects": false,
   "main": "dist/index.js",
@@ -53,7 +57,7 @@
     "THIRD-PARTY-NOTICES"
   ],
   "scripts": {
-    "prepublishOnly": "node scripts/verify-release-tag.mjs",
+    "prepublishOnly": "node scripts/verify-release-tag.mjs && node scripts/verify-entry-points.mjs",
     "build": "npm run clean && tsc",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -66,6 +70,7 @@
     "demo:build": "tsc -p tsconfig.demo.json",
     "sessions": "tsc -p tsconfig.demo.json && node dist-demo/examples/claude-sessions/index.js",
     "strip": "tsc -p tsconfig.demo.json && node dist-demo/examples/rich-strip/index.js",
+    "viewport": "tsc -p tsconfig.demo.json && node dist-demo/examples/rich-viewport/index.js",
     "markup-plugins": "tsc -p tsconfig.demo.json && node dist-demo/examples/rich-markup-plugins/index.js",
     "demo-inputs": "tsc -p tsconfig.demo.json && node dist-demo/examples/rich-config/index.js",
     "demo:dropdown": "tsc -p tsconfig.demo.json && node dist-demo/examples/dropdown-demo/index.js",
@@ -96,9 +101,12 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.63.0",
-    "@promptctl/go-template-js": "^0.9.0",
+    "@promptctl/go-template-js": "^0.10.0",
+    "@types/markdown-it": "^14.2.0",
     "@types/node": "^26.5.1",
     "@types/semver": "^7.8.0",
+    "markdown-it": "^14.3.2",
+    "markdown-it-container": "^4.0.0",
     "mobx": "^7.0.3",
     "semver": "^7.8.5",
     "strip-ansi": "^7.2.0",
@@ -111,7 +119,7 @@
     "string-width": "^8.2.2"
   },
   "peerDependencies": {
-    "@promptctl/go-template-js": "^0.9.0",
+    "@promptctl/go-template-js": "^0.10.0",
     "mobx": "^7.0.3"
   },
   "peerDependenciesMeta": {

package/dist/host/host-stream.d.ts

@@ -1,30 +0,0 @@
-/**
- * hostStream — adapt a `TerminalHost` into the narrow Writable surface that
- * Console (and Live) actually exercise.
- *
- * [LAW:types-are-the-program] The return type matches Console's `ConsoleSink`
- * exactly: a single `.write(chunk)` method whose return value Console never
- * inspects (so the type leaves it as `unknown`; this implementation happens
- * to return `true` to mirror Node's stream contract, but callers may not
- * rely on that). Anything wider would lie about what this adapter
- * implements; anything narrower would force a cast at the call site.
- * Calling `.pipe()`, `.cork()`, `.on('error')`, etc. is a programming error
- * that TypeScript will reject at compile time.
- *
- * [LAW:locality-or-seam] Console + Live access their sink only via `.write()`
- * — verified in src/core/console.ts (one `_file.write` call) and
- * src/renderables/live.ts (every `this._console.file.write(...)` site). So
- * this narrow surface is the entire contract they need.
- */
-import type { ConsoleSink } from "../core/console.js";
-import type { TerminalHost } from "./terminal-host.js";
-/**
- * Wrap a `TerminalHost` so its output can be threaded into `Console` via the
- * existing `file:` option. The returned object implements `.write()` only —
- * exactly the surface Console + Live touch.
- *
- * Pair with `forceTerminal: true` on the Console — without it, Console treats
- * any non-undefined `file` option as non-TTY and disables color, which
- * defeats the point.
- */
-export declare function hostStream(host: TerminalHost): ConsoleSink;

package/dist/host/host-stream.js

@@ -1,35 +0,0 @@
-/**
- * hostStream — adapt a `TerminalHost` into the narrow Writable surface that
- * Console (and Live) actually exercise.
- *
- * [LAW:types-are-the-program] The return type matches Console's `ConsoleSink`
- * exactly: a single `.write(chunk)` method whose return value Console never
- * inspects (so the type leaves it as `unknown`; this implementation happens
- * to return `true` to mirror Node's stream contract, but callers may not
- * rely on that). Anything wider would lie about what this adapter
- * implements; anything narrower would force a cast at the call site.
- * Calling `.pipe()`, `.cork()`, `.on('error')`, etc. is a programming error
- * that TypeScript will reject at compile time.
- *
- * [LAW:locality-or-seam] Console + Live access their sink only via `.write()`
- * — verified in src/core/console.ts (one `_file.write` call) and
- * src/renderables/live.ts (every `this._console.file.write(...)` site). So
- * this narrow surface is the entire contract they need.
- */
-/**
- * Wrap a `TerminalHost` so its output can be threaded into `Console` via the
- * existing `file:` option. The returned object implements `.write()` only —
- * exactly the surface Console + Live touch.
- *
- * Pair with `forceTerminal: true` on the Console — without it, Console treats
- * any non-undefined `file` option as non-TTY and disables color, which
- * defeats the point.
- */
-export function hostStream(host) {
-    return {
-        write(chunk) {
-            host.write(chunk);
-            return true;
-        },
-    };
-}

package/dist/widgets/screen.d.ts

@@ -1,98 +0,0 @@
-/**
- * Screen — owns the render loop and ANSI output for interactive widgets.
- *
- * [LAW:dataflow-not-control-flow] Same pipeline runs every frame: render
- * widgets to Segment[], split into lines, encode to ANSI, write to stdout
- * with cursor-up + overwrite. Variability lives in the values (which widgets
- * are visible, what they render), never in whether the pipeline runs.
- *
- * [LAW:one-source-of-truth] Layout (widget bounds) is computed here and
- * written to widget.bounds. Mouse hit-testing reads the same bounds — the
- * Screen is the single authority on where each widget is drawn.
- *
- * [LAW:single-enforcer] Cursor management lives in one place: `draw()`
- * tracks `lastLineCount` and emits a single `\x1b[<n>A` to reposition.
- * Per-line `\x1b[K` (erase to end of line) overwrites old content without
- * flicker — no clear-and-redraw cycle.
- *
- * Reactivity: `mobx.autorun` re-fires on any observable read during render
- * (label, focused, hovered, active, disabled, visible, the widget list
- * itself). Renders are debounced to a microtask so a burst of state changes
- * within one tick produces one frame.
- *
- * Layout (per-widget Placement):
- *
- *   flow   — vertical stack at x=0; advances the layout cursor by the
- *            widget's measured height. Default placement; preserves the
- *            historical single-column behavior so existing consumers
- *            (and the screen tests) need no migration.
- *   inline — same row as the preceding flow/inline neighbor; x packs
- *            after that neighbor's right edge plus a one-cell gap. The
- *            row's height is the max of its members; the cursor advances
- *            past the tallest member when the next non-inline item is
- *            placed (or at end of frame).
- *   fixed  — absolute (x, y); independent of the cursor. Used for
- *            anchored content like status/log rows that the host wants
- *            placed at a known coordinate regardless of flow growth.
- *
- * The overlay pass (single enforcer) runs after base layout: any widget
- * implementing OverlayRenderable contributes overlay segments anchored
- * directly below its inline footprint, and Screen unions the overlay
- * area into the widget's bounds for hit-testing.
- *
- * Design alternatives considered:
- *   1. Per-widget Placement (chosen) — smallest type that covers the legal
- *      variability; one total switch in computeFrame; back-compat default.
- *   2. Named regions (header/body/status as flow containers) — adds a
- *      two-step API surface (declare regions, then mount into them) and
- *      another concept; rejected as larger than the problem requires.
- *   3. Host-supplied layout function — pushes layout out of Screen,
- *      defeating single-enforcer; rejected.
- */
-import { ColorDepth } from "../core/color.js";
-import type { Screen, InteractiveWidget, FocusManager, MountEntry } from "./types.js";
-import type { TerminalHost } from "../host/terminal-host.js";
-export type ColorSystemSpec = ColorDepth | "auto" | "truecolor" | "256" | "ansi" | "none" | null;
-export interface ScreenOptions {
-    /**
-     * The I/O capability the screen renders against. Construct a
-     * `NodeTerminalHost` for production node demos, or pass a host that
-     * wraps mock streams for tests. The seam is the type — Screen never
-     * reaches for `process.*`.
-     */
-    host: TerminalHost;
-    width?: number;
-    colorSystem?: ColorSystemSpec;
-    focusManager?: FocusManager;
-    /**
-     * When true (default when the host reports `isTTY`), hide the cursor
-     * on start and restore it on stop. Disable for non-TTY output and tests.
-     */
-    manageCursor?: boolean;
-}
-export declare class DefaultScreen implements Screen {
-    readonly focusManager: FocusManager;
-    accessor widgetList: InteractiveWidget[];
-    private readonly placements;
-    private _activeOverlays;
-    private _running;
-    private autorunDispose;
-    private renderScheduled;
-    private pendingFrame;
-    private lastLineCount;
-    private readonly host;
-    private readonly widthOverride;
-    private readonly destination;
-    private readonly manageCursor;
-    constructor(options: ScreenOptions);
-    get running(): boolean;
-    get widgets(): readonly InteractiveWidget[];
-    mount(...entries: MountEntry[]): void;
-    unmount(widget: InteractiveWidget): void;
-    start(): void;
-    stop(): void;
-    private get width();
-    private computeFrame;
-    private scheduleRender;
-    private draw;
-}