take4-console 0.25.0 → 0.31.0

package/dist/Screen/VirtualCursor.mjs

@@ -0,0 +1,148 @@
+/** Default on/off durations (ms) for the named blink modes. */
+const BLINK_PRESETS = {
+    slow: { onMs: 600, offMs: 600 },
+    fast: { onMs: 250, offMs: 250 },
+};
+/** Bounds (ms) for the irregular blink mode — each phase picks a random
+ *  duration from its range so the cursor feels "alive" rather than metronomic. */
+const IRREGULAR_ON_MIN = 180;
+const IRREGULAR_ON_MAX = 520;
+const IRREGULAR_OFF_MIN = 90;
+const IRREGULAR_OFF_MAX = 240;
+/** Default glyph used when the consumer does not supply one — a vertical
+ *  bar that reads as a text insertion caret on most monospace fonts. */
+export const DEFAULT_CURSOR_SYMBOL = '▎';
+/** Software cursor model — owns the glyph rendered on screen and the
+ *  on/off blink state. Stateless when `blink.mode === 'off'` or `'steady'`;
+ *  for timed modes the class samples `Date.now()` on every `isVisible()`
+ *  call and advances internal phase state as needed. A caller (typically
+ *  `WindowManager`) is responsible for triggering re-renders on a timer so
+ *  the visual state actually reaches the terminal. */
+export class VirtualCursor {
+    /** Glyph rendered for the cursor when visible. `undefined` means "use
+     *  the legacy inverse-block highlight over the underlying character". */
+    symbol;
+    /** Blink configuration — mode and custom timings. */
+    blink;
+    /** Current phase in the blink timeline. Lazily initialised on first
+     *  `isVisible()` call so construction stays free of side effects. */
+    phase;
+    /** Creates a new cursor with the provided symbol and blink settings.
+     *  Defaults: symbol = `undefined` (inverse-block), blink = `{ mode: 'steady' }`. */
+    constructor(options) {
+        this.symbol = options?.symbol;
+        this.blink = options?.blink ?? { mode: 'steady' };
+        this.phase = null;
+    }
+    /** Returns the caller-supplied glyph, or `DEFAULT_CURSOR_SYMBOL` when
+     *  none was set. Use `hasCustomSymbol()` to distinguish the two cases. */
+    getSymbol() {
+        return this.symbol ?? DEFAULT_CURSOR_SYMBOL;
+    }
+    /** Returns true when a custom glyph was provided; false means the
+     *  caller wants the legacy inverse-block highlight behaviour. */
+    hasCustomSymbol() {
+        return this.symbol !== undefined;
+    }
+    /** Replaces the cursor glyph. Pass `undefined` to revert to inverse-block. */
+    setSymbol(symbol) {
+        this.symbol = symbol;
+    }
+    /** Returns the active blink configuration (for inspection / cloning). */
+    getBlink() {
+        return this.blink;
+    }
+    /** Replaces the blink configuration and resets the phase timer so the
+     *  new mode starts in its "on" phase immediately. */
+    setBlink(blink) {
+        this.blink = blink;
+        this.phase = null;
+    }
+    /** Returns the fastest cadence (in ms) a re-render would need to show
+     *  this cursor's blink faithfully, or `null` when the cursor is static
+     *  (modes `'off'` and `'steady'`). Used by `WindowManager` to pick a
+     *  timer interval. For `irregular` we return the minimum possible
+     *  off-phase duration so quick flicks are not missed. */
+    getTickHintMs() {
+        switch (this.blink.mode) {
+            case 'off':
+            case 'steady':
+                return null;
+            case 'slow':
+                return BLINK_PRESETS.slow.onMs;
+            case 'fast':
+                return BLINK_PRESETS.fast.onMs;
+            case 'irregular':
+                return IRREGULAR_OFF_MIN;
+            case 'custom':
+                return Math.min(this.blink.onMs, this.blink.offMs);
+            default:
+                return null;
+        }
+    }
+    /** Returns whether the cursor should be drawn at the given moment.
+     *  `now` is accepted for deterministic testing; defaults to `Date.now()`. */
+    isVisible(now = Date.now()) {
+        if (this.blink.mode === 'off')
+            return false;
+        if (this.blink.mode === 'steady')
+            return true;
+        if (this.phase === null) {
+            this.phase = { startedAt: now, visible: true, duration: this.firstOnDuration() };
+        }
+        // Walk forward through phases until we land on the one that covers `now`.
+        // Doing this iteratively (vs. a single modulo) is important for
+        // `irregular` mode, where every phase has an independently sampled
+        // duration.
+        while (now - this.phase.startedAt >= this.phase.duration) {
+            const current = this.phase;
+            const nextStart = current.startedAt + current.duration;
+            const nextVisible = !current.visible;
+            this.phase = {
+                startedAt: nextStart,
+                visible: nextVisible,
+                duration: this.phaseDuration(nextVisible),
+            };
+        }
+        return this.phase.visible;
+    }
+    /** Forces the next `isVisible()` sample to begin a fresh "on" phase at
+     *  `now`. Useful for keeping the cursor steady while the user types — a
+     *  blink that vanishes mid-keystroke is jarring. */
+    resetPhase(now = Date.now()) {
+        this.phase = { startedAt: now, visible: true, duration: this.firstOnDuration() };
+    }
+    /** Picks the first "on" phase duration for the current blink mode.
+     *  Split out so tests can assert the expected preset values. */
+    firstOnDuration() {
+        return this.phaseDuration(true);
+    }
+    /** Returns the duration of the upcoming phase given its visibility flag.
+     *  Implements both the named presets and the `custom` / `irregular`
+     *  semantics in one place. */
+    phaseDuration(visible) {
+        switch (this.blink.mode) {
+            case 'off':
+            case 'steady':
+                return Number.POSITIVE_INFINITY;
+            case 'slow':
+                return visible ? BLINK_PRESETS.slow.onMs : BLINK_PRESETS.slow.offMs;
+            case 'fast':
+                return visible ? BLINK_PRESETS.fast.onMs : BLINK_PRESETS.fast.offMs;
+            case 'custom':
+                return visible ? this.blink.onMs : this.blink.offMs;
+            case 'irregular':
+                return visible
+                    ? randomBetween(IRREGULAR_ON_MIN, IRREGULAR_ON_MAX)
+                    : randomBetween(IRREGULAR_OFF_MIN, IRREGULAR_OFF_MAX);
+            default:
+                return Number.POSITIVE_INFINITY;
+        }
+    }
+}
+/** Returns a uniformly distributed integer in the closed range [min, max].
+ *  Kept as a module-private helper so `VirtualCursor` stays compact. */
+function randomBetween(min, max) {
+    return min + Math.floor(Math.random() * (max - min + 1));
+}
+//# sourceMappingURL=VirtualCursor.mjs.map

package/dist/Screen/VirtualCursor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualCursor.mjs","sourceRoot":"","sources":["../../src/Screen/VirtualCursor.mts"],"names":[],"mappings":"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"}

package/dist/Screen/Window.d.mts

@@ -1,4 +1,4 @@
-import type { Cell, StyleId, WindowBorder, WindowProperties, WriteTextOptions, WriteTextInput, TerminalSize } from './types.mjs';
+import type { Cell, StyleId, WindowBorder, WindowProperties, WriteTextOptions, WriteTextInput, TerminalSize, Margin, DirtyRect } from './types.mjs';
 import { Region } from './Region.mjs';
 import { StyleRegistry } from './StyleRegistry.mjs';
 export declare class Window {
@@ -43,18 +43,83 @@ export declare class Window {
     /** Padding applied inside the border (in addition to the border inset).
      *  Influences `getInnerSize()` / `getInnerOffset()`. */
     private padding;
+    /** Outer spacing reserved around this window inside its parent's layout.
+     *  Consumed by the parent's layout engine (absolute/flex/grid); does not
+     *  influence this window's inner area. */
+    private margin;
     /** Number of columns for `layout: 'grid'`. */
     private gridColumns;
     /** Cross-axis alignment for row/column layouts. */
     private alignItems;
     /** Main-axis distribution of leftover space when no flex-grow child consumes it. */
     private justifyContent;
+    /** Optional identifier — copied from WindowProperties.id. Used by
+     *  `WindowManager.focusById` and by diagnostic tooling. */
+    private id;
+    /** Stacking order among siblings (higher z renders on top). Default: 0. */
+    private zIndex;
+    /** Fires once when focused state flips from false to true. */
+    private onFocusHandler;
+    /** Fires once when focused state flips from true to false. */
+    private onBlurHandler;
+    /** Parent window (set by `addChild`, cleared by `removeChild`). Damage
+     *  tracking walks up this chain to notify the root `Screen` of geometry
+     *  or topology changes that need a full repaint. */
+    protected parent: Window | null;
+    /** Accumulated dirty region in this window's local coordinates.
+     *  - `null`  — nothing changed since the last emit.
+     *  - `'all'` — the whole window area needs to be re-emitted.
+     *  - `DirtyRect` — bounding box of localised writes; `markDirty()` eagerly
+     *    unions new rects so we only ever carry one rect per window.
+     *  Windows start as `'all'` so the very first frame re-emits every cell. */
+    protected dirtyRect: DirtyRect | 'all' | null;
+    /** Depth of nested `Window.render()` calls currently executing. Increments
+     *  at the top of every `render()` and decrements in a `finally`, so
+     *  controls whose `render()` override re-writes content via `this.clear()`
+     *  / `this.writeText(...)` do not re-mark themselves dirty every frame —
+     *  render-time writes deterministically rebuild the display buffer from
+     *  existing state, so marking them as "user-driven dirty" would defeat the
+     *  "skip frame when nothing changed" optimisation. */
+    protected static renderingDepth: number;
     /** Creates a window from the given properties.
      *  For percentage-based sizes, call addChild() before writing content to the window.
      *  Uses the global StyleRegistry set by the Screen constructor. */
     constructor(wp: WindowProperties);
     /** Returns the window dimensions (columns × rows). */
     getSize(): TerminalSize;
+    /** Marks this window (or a sub-rectangle in its local coordinates) as
+     *  dirty. Subsequent `Screen.render()` calls emit ANSI only for cells
+     *  inside the collected dirty rects, skipping untouched regions. When
+     *  `rect` is omitted, the entire window is flagged. Render-time writes
+     *  are ignored so controls' `render()` overrides do not re-mark
+     *  themselves every frame. Safe to call many times between renders —
+     *  new rects are unioned into the existing bounding box. */
+    markDirty(rect?: DirtyRect): void;
+    /** Convenience alias — flags the entire window as dirty. Equivalent to
+     *  calling `markDirty()` with no argument; kept as a named entry point
+     *  so custom controls can invalidate themselves without depending on
+     *  the default-argument behaviour. */
+    invalidate(): void;
+    /** Walks the parent chain up to the root window. Damage tracking uses
+     *  this to bubble a full-invalidation signal to the root `Screen` when
+     *  geometry or tree topology changes, because the cells previously
+     *  occupied by a now-moved / resized / hidden window need to be repainted
+     *  from the content underneath them. `Screen` overrides it to toggle its
+     *  internal full-repaint flag; plain `Window`s forward the call up. */
+    protected markFullInvalidation(): void;
+    /** Appends this window's dirty rect (translated into screen coordinates
+     *  via the running offset) and every descendant's dirty rects to `acc`.
+     *  Hidden subtrees are skipped — invisible windows don't contribute to
+     *  the emit phase, and any state change that flips visibility already
+     *  escalated to a full invalidation so the vacated area repaints. */
+    protected collectDirtyRects(offsetX: number, offsetY: number, acc: DirtyRect[]): void;
+    /** Clears the dirty flag on this window and every descendant. Called by
+     *  `Screen.render()` after the emit phase so the next frame starts from
+     *  a clean slate. */
+    protected clearDirtyRecursive(): void;
+    /** Returns a snapshot of the resolved per-side margin (in cells). The parent's
+     *  layout engine reads this to reserve outer spacing around the child. */
+    getMargin(): Readonly<Margin>;
     /** Returns the number of cells consumed by decorations on each edge.
      *  The explicit 'none' border style is treated as no border (no insets). */
     private borderInset;
@@ -72,8 +137,33 @@ export declare class Window {
     getInnerSize(): TerminalSize;
     /** Sets the active state. Affects border and background appearance on next render(). */
     setActive(active: boolean): void;
-    /** Sets the focused state. Controls use this to change visual appearance on focus. */
+    /** Sets the focused state. Controls use this to change visual appearance on focus.
+     *  Fires `onFocus` / `onBlur` (configured via `WindowProperties`) when the state
+     *  actually changes; a no-op call with the current value does not re-fire them. */
     setFocused(focused: boolean): void;
+    /** Registers (or replaces) the onFocus handler at runtime. Pass `undefined`
+     *  to detach. Fires in `setFocused` on every false → true transition. */
+    setOnFocus(handler: (() => void) | undefined): void;
+    /** Registers (or replaces) the onBlur handler at runtime. Pass `undefined`
+     *  to detach. Fires in `setFocused` on every true → false transition. */
+    setOnBlur(handler: (() => void) | undefined): void;
+    /** Returns the optional identifier set via WindowProperties.id. */
+    getId(): string | undefined;
+    /** Sets (or clears with `undefined`) the window identifier used by
+     *  `WindowManager.focusById` and diagnostic tooling. */
+    setId(id: string | undefined): void;
+    /** Returns the current stacking order. Higher values render on top of
+     *  lower ones among siblings. Default: 0. */
+    getZIndex(): number;
+    /** Updates the stacking order. Siblings are re-sorted on the next render()
+     *  call; call `screen.render()` (or the surrounding window) to see the
+     *  change. Does not affect layout (flex/absolute coordinates are
+     *  independent of z). */
+    setZIndex(zIndex: number): void;
+    /** Returns the direct children of this window in insertion order (a
+     *  read-only view). WindowManager uses this to walk subtrees for
+     *  `trapFocus` and `focusById` without exposing the internal array. */
+    getChildren(): readonly Window[];
     /** Returns whether this window currently has keyboard focus. */
     isFocused(): boolean;
     /** Sets the disabled state and deactivates the window when disabled. */
@@ -167,6 +257,16 @@ export declare class Window {
      * children are also skipped in the loop below.
      */
     render(): void;
+    /** Returns direct children sorted for rendering — stable by (zIndex asc,
+     *  insertion order). Children with higher zIndex paint last, so they
+     *  appear on top of lower-z siblings. Layout is NOT affected: flex and
+     *  absolute positioning run off the insertion-ordered `children` list. */
+    private orderedByZ;
+    /** Renders a single-line "⚠ render error" marker over the child's
+     *  pre-allocated region so a broken subtree never blanks the rest of the
+     *  frame. The child is still blitted onto this window so its geometry
+     *  (borders, siblings) remains visible in the debug layout. */
+    private paintErrorPlaceholder;
     /** Fills the display buffer with the background style. When inactive, adds dim to every cell.
      *  No-op when background is 0 (transparent). */
     private paintBackground;
@@ -203,7 +303,10 @@ export declare class Window {
      *  absolute / row / column / grid implementations based on `layoutMode`. */
     private runLayout;
     /** Absolute layout: each child independently resolves its Pos/Size against
-     *  the parent's inner area — the pre-flex behaviour. */
+     *  the parent's inner area — the pre-flex behaviour. A child's `margin`
+     *  shifts the resolved position by `(marginLeft, marginTop)` without
+     *  altering its size, so callers can push a window away from its declared
+     *  anchor without recomputing coordinates by hand. */
     private layoutAbsolute;
     /** Row / column flex layout. The main axis (width for 'row', height for
      *  'column') is distributed across children: each child starts with its
@@ -215,13 +318,20 @@ export declare class Window {
      *  distribution only when no child consumes slack via flex-grow. Invisible
      *  children are skipped so `setVisible(false)` effectively removes them
      *  from the stack. Children are ordered by `Pos.flex(order)` first, then
-     *  by addChild insertion (stable). */
+     *  by addChild insertion (stable).
+     *
+     *  Each child's `margin` reserves extra cells around it: the main axis
+     *  loses `marginLeft+marginRight` (row) or `marginTop+marginBottom` (column)
+     *  per child before distribution, and the cross axis loses `margin*` per
+     *  child before alignment. Grow/shrink still apply to the inner size so the
+     *  declared margin stays constant even when the child is flex-resized. */
     private layoutFlex;
     /** Grid layout: children are placed row-major into equally sized cells.
      *  Each cell's width is `(innerWidth - gap * (cols - 1)) / cols` (floored);
      *  heights use the same formula with the derived row count. Children are
-     *  resized to the cell dimensions and positioned at the cell's top-left.
-     *  Invisible children are skipped. */
+     *  resized to the cell dimensions minus their own margin and positioned
+     *  at the cell's top-left offset by `(marginLeft, marginTop)`. Invisible
+     *  children are skipped. */
     private layoutGrid;
     /** Returns visible children sorted by Pos.flex(order) ascending; children
      *  without Pos.flex default to order 0. Stable w.r.t. addChild insertion. */

package/dist/Screen/Window.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"Window.d.mts","sourceRoot":"","sources":["../../src/Screen/Window.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Window.d.mts","sourceRoot":"","sources":["../../src/Screen/Window.mts"],"names":[],"mappings":"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"}