take4-console 0.15.0 → 0.25.0

package/dist/Screen/Size.mjs

@@ -1,22 +1,74 @@
 import { Pct } from './Pos.mjs';
+/** Value object describing a flex dimension — `grow` shares positive leftover
+ *  space between siblings, `shrink` soaks up negative leftover, `basis` is the
+ *  starting main-axis size before distribution. Produced via the `flex()`
+ *  factory and accepted anywhere a `Size` constructor expects a dimension. */
+export class FlexDim {
+    grow;
+    shrink;
+    basis;
+    constructor(grow = 1, shrink = 1, basis = 0) {
+        this.grow = grow;
+        this.shrink = shrink;
+        this.basis = basis;
+    }
+}
+/** Singleton marker for content-sized dimensions. Produced via the `content()`
+ *  factory; the layout engine measures the child's natural size (current
+ *  Region dimensions) at layout time. */
+export class ContentDim {
+    static INSTANCE = new ContentDim();
+    constructor() { }
+}
+/** Factory for a flex dimension — shorthand for `new FlexDim(grow, shrink, basis)`. */
+export function flex(grow = 1, shrink = 1, basis = 0) {
+    return new FlexDim(grow, shrink, basis);
+}
+/** Factory for a content-sized dimension. Always returns the singleton. */
+export function content() {
+    return ContentDim.INSTANCE;
+}
+/** Converts a basis literal to the internal FlexBasis representation. */
+function toFlexBasis(v) {
+    if (v instanceof Pct)
+        return { kind: 'pct', value: v.value };
+    return { kind: 'abs', value: v };
+}
 /** Converts a user-supplied dimension value to an internal DimSpec. */
 function toDimSpec(v) {
     if (v instanceof Pct)
         return { mode: 'pct', value: v.value };
+    if (v instanceof FlexDim)
+        return { mode: 'flex', grow: v.grow, shrink: v.shrink, basis: toFlexBasis(v.basis) };
+    if (v instanceof ContentDim)
+        return { mode: 'content' };
     return { mode: 'abs', value: v };
 }
-/** Resolves a single dimension spec to a pixel value. */
+/** Resolves a single dimension spec to a pixel value. For modes whose final
+ *  size is determined by the parent's layout engine (`flex`, `content`) this
+ *  returns a safe fallback that keeps the region non-empty until the layout
+ *  pass overwrites it — `flex` falls back to its basis, `content` to 1. */
 function resolveDim(spec, parentSize) {
-    if (spec.mode === 'pct')
-        return Math.floor(parentSize * spec.value / 100);
-    return spec.value;
+    switch (spec.mode) {
+        case 'abs': return spec.value;
+        case 'pct': return Math.floor(parentSize * spec.value / 100);
+        case 'flex': return spec.basis.kind === 'pct'
+            ? Math.floor(parentSize * spec.basis.value / 100)
+            : spec.basis.value;
+        case 'content': return 1;
+    }
 }
-/** Encodes window dimensions. Supports absolute pixel values and percentage of parent size. */
+/** Encodes window dimensions. Supports absolute pixel values, percentages of
+ *  the parent, flex slots (`flex(grow, shrink, basis)`), and content-sized
+ *  dimensions (`content()`). Flex and content modes only take effect inside a
+ *  flex-layout parent (`WindowProperties.layout` set to 'row', 'column', or
+ *  'grid'); in 'absolute' layout they degrade to the fallback resolution. */
 export class Size {
     wSpec;
     hSpec;
     /** Creates a size from width and height values.
-     *  Pass a plain number for absolute pixels, or a Pct instance for a percentage of the parent. */
+     *  Accepts plain numbers (absolute pixels), `Pct` (percentage of parent),
+     *  `FlexDim` (via `flex()` factory), or `ContentDim` (via `content()`). */
     constructor(w, h) {
         this.wSpec = toDimSpec(w);
         this.hSpec = toDimSpec(h);
@@ -33,16 +85,38 @@ export class Size {
     static fillHeight(w) {
         return new Size(w, new Pct(100));
     }
+    /** Creates a size that flexes on both axes — shorthand for
+     *  `new Size(flex(grow, shrink, basis), flex(grow, shrink, basis))`. The
+     *  parent's layout engine decides which axis is main vs cross. */
+    static flex(grow = 1, shrink = 1, basis = 0) {
+        return new Size(flex(grow, shrink, basis), flex(grow, shrink, basis));
+    }
+    /** Creates a size where both axes are content-sized. The layout engine
+     *  measures the child's current Region dimensions and uses those. */
+    static content() {
+        return new Size(content(), content());
+    }
     /** Returns true when both dimensions are absolute pixel values (no parent size needed). */
     isAbsolute() {
         return this.wSpec.mode === 'abs' && this.hSpec.mode === 'abs';
     }
-    /** Resolves this size to pixel dimensions given the parent's dimensions. */
+    /** Resolves this size to pixel dimensions given the parent's dimensions.
+     *  Flex/content modes fall back to safe defaults; the layout engine takes
+     *  over when the parent uses a non-'absolute' `layout`. */
     resolve(parentW, parentH) {
         return {
             w: resolveDim(this.wSpec, parentW),
             h: resolveDim(this.hSpec, parentH),
         };
     }
+    /** Returns the raw width spec so the layout engine can inspect the mode
+     *  (abs/pct/flex/content) and route each child accordingly. */
+    getWidthSpec() {
+        return this.wSpec;
+    }
+    /** Returns the raw height spec — companion to getWidthSpec(). */
+    getHeightSpec() {
+        return this.hSpec;
+    }
 }
 //# sourceMappingURL=Size.mjs.map

package/dist/Screen/Size.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Size.mjs","sourceRoot":"","sources":["../../src/Screen/Size.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,uEAAuE;AACvE,SAAS,SAAS,CAAC,CAAe;IACjC,IAAI,CAAC,YAAY,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAClC,CAAC;AAED,yDAAyD;AACzD,SAAS,UAAU,CAAC,IAAa,EAAE,UAAkB;IACpD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,KAAK,CAAC;AACnB,CAAC;AAED,+FAA+F;AAC/F,MAAM,OAAO,IAAI;IACR,KAAK,CAAU;IACf,KAAK,CAAU;IAEvB;qGACiG;IACjG,YAAmB,CAAe,EAAE,CAAe;QAClD,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,uEAAuE;IAChE,MAAM,CAAC,IAAI;QACjB,OAAO,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,8FAA8F;IACvF,MAAM,CAAC,SAAS,CAAC,CAAe;QACtC,OAAO,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,8FAA8F;IACvF,MAAM,CAAC,UAAU,CAAC,CAAe;QACvC,OAAO,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,2FAA2F;IACpF,UAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;IAC/D,CAAC;IAED,4EAA4E;IACrE,OAAO,CAAC,OAAe,EAAE,OAAe;QAC9C,OAAO;YACN,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;YAClC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;SAClC,CAAC;IACH,CAAC;CACD"}
+{"version":3,"file":"Size.mjs","sourceRoot":"","sources":["../../src/Screen/Size.mts"],"names":[],"mappings":"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"}

package/dist/Screen/Window.d.mts

@@ -1,4 +1,4 @@
-import type { Cell, StyleId, WindowBorder, WindowProperties, WriteTextOptions, TerminalSize } from './types.mjs';
+import type { Cell, StyleId, WindowBorder, WindowProperties, WriteTextOptions, WriteTextInput, TerminalSize } from './types.mjs';
 import { Region } from './Region.mjs';
 import { StyleRegistry } from './StyleRegistry.mjs';
 export declare class Window {
@@ -30,20 +30,45 @@ export declare class Window {
     private active;
     private posSpec;
     private sizeSpec;
+    /** Whether this window participates in rendering. When false, the window's own
+     *  render() is a no-op, its region is not blitted onto the parent, and
+     *  `getCell()` throws. Focus-cycle in WindowManager skips invisible focusable
+     *  controls. Default: true. */
+    private visible;
+    /** Layout algorithm applied to direct children. 'absolute' keeps the pre-flex
+     *  behaviour; 'row' / 'column' / 'grid' activate the flex engine. */
+    private layoutMode;
+    /** Spacing (in cells) between adjacent children for flex / grid layouts. */
+    private gap;
+    /** Padding applied inside the border (in addition to the border inset).
+     *  Influences `getInnerSize()` / `getInnerOffset()`. */
+    private padding;
+    /** 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;
     /** 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;
-    /** Returns the number of cells consumed by decorations on each edge. */
+    /** 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;
-    /** Returns the top-left offset of the content area, accounting for decorations such as borders. */
+    /** Returns the combined per-side inset (border + padding) that defines the
+     *  inner content area. Padding stacks on top of the border inset. */
+    private innerInset;
+    /** Returns the top-left offset of the content area, accounting for
+     *  decorations (border) and layout insets (padding). */
     getInnerOffset(): {
         x: number;
         y: number;
     };
-    /** Returns the dimensions of the content area, accounting for decorations such as borders. */
+    /** Returns the dimensions of the content area, accounting for decorations
+     *  (border) and layout insets (padding). */
     getInnerSize(): TerminalSize;
     /** Sets the active state. Affects border and background appearance on next render(). */
     setActive(active: boolean): void;
@@ -55,6 +80,14 @@ export declare class Window {
     setDisabled(disabled: boolean): void;
     /** Returns whether this window is currently disabled. */
     isDisabled(): boolean;
+    /** Shows or hides the window. A hidden window does not paint itself, is not
+     *  blitted onto its parent, and its focusable descendants are skipped by
+     *  `WindowManager.moveFocus / setFocus`. Toggling visibility does not mutate
+     *  the content buffer — previously written cells reappear verbatim on the
+     *  next render after the window is shown again. */
+    setVisible(visible: boolean): void;
+    /** Returns whether this window is currently visible. Default: true. */
+    isVisible(): boolean;
     /** Sets the label text displayed by the control. */
     setLabel(label: string): void;
     /** Returns the current label text. */
@@ -66,12 +99,17 @@ export declare class Window {
      *  Called automatically at the start of render() so subclasses never need to do it manually.
      *  Only updates the color when no explicit color was provided in the original border config. */
     private syncBorderColor;
-    /** Adds a child window. If the child uses percentage-based sizes they are resolved immediately
-     *  against this window's inner dimensions (excluding decorations such as borders).
-     *  Position is resolved relative to the inner area and stored on child.x/y. */
+    /** Adds a child window. The final position and (for non-absolute sizes) the
+     *  final dimensions are computed by the parent's layout engine: in
+     *  'absolute' layout each child resolves its own Pos/Size; in 'row',
+     *  'column', or 'grid' layouts the engine distributes the inner area
+     *  across every visible child. Re-laying out on addChild keeps sibling
+     *  geometry consistent when more children join the stack. */
     addChild(child: Window): void;
     /** Returns a resolved Cell (char + CellAttributes) at (x, y) from the display buffer.
-     *  Throws RangeError if out of bounds. */
+     *  Throws RangeError if out of bounds. Throws Error when the window is
+     *  currently hidden (setVisible(false)) — callers should check isVisible()
+     *  first when the visibility state is uncertain. */
     getCell(x: number, y: number): Cell;
     /** Sets only the character at (x, y) without modifying the style ID. Throws RangeError if out of bounds. */
     setChar(x: number, y: number, char: string): void;
@@ -86,14 +124,47 @@ export declare class Window {
     fill(char: string, styleId?: StyleId): void;
     /** Writes text into the window's content area starting at (x, y) (default 0, 0).
      *  Coordinates are relative to the inner content area (i.e. decorations such as borders are excluded).
-     *  Newline characters move to the next row, resetting x to startX.
-     *  Characters outside the inner bounds are silently clipped.
-     *  When no style is provided, automatically picks disabledStyleId, focusedStyleId, or normalStyleId
-     *  based on the current disabled/focused state. */
-    writeText(text: string, options?: WriteTextOptions): void;
+     *
+     *  Accepts either a plain string (one base style for the whole text) or an array of
+     *  `WriteTextSegment`s so inline rich text can be laid out without separate writeText()
+     *  calls — the cursor flows from one segment into the next on the same row. Each segment
+     *  may pin its own style either as a pre-registered `style: StyleId` or as inline
+     *  `attrs: CellAttributes` (registered on the fly). The segment style is merged on top
+     *  of the base style so global defaults (e.g. foreground) keep applying unless overridden.
+     *
+     *  Behaviour shared with the single-string form:
+     *  - Newline characters move to the next row, resetting x to startX.
+     *  - Characters outside the inner bounds are silently clipped.
+     *  - Wide characters (CJK, emoji, double-width NerdFonts) occupy two consecutive cells;
+     *    the second cell stores '' as a continuation sentinel so terminal cursor advancement
+     *    during render() stays aligned with the buffer indices. Wide chars whose right half
+     *    would overflow the inner area are skipped entirely.
+     *  - Zero-width codepoints (combining marks, format chars, control chars) are skipped.
+     *  - When no style is provided, the base style is auto-picked from disabled / focused /
+     *    normal state. Pass `options.style = 0` to suppress the state-based base style. */
+    writeText(input: WriteTextInput, options?: WriteTextOptions): void;
+    /** Writes a template that embeds named styles from the StyleRegistry.
+     *  Syntax is a mini-markup: `{name}…{/}` wraps an inline region in the style
+     *  registered under `name` (e.g. a built-in name like `builtin:text-focused` or a
+     *  user-registered custom name). Nested tags inherit attributes from their parent
+     *  — the inner style is merged on top of the outer one, so `{red}a{bold}b{/}c{/}`
+     *  renders `a` in red, `b` in red+bold, `c` in red. `{/}` closes the most recently
+     *  opened tag. Unknown names keep the surrounding style unchanged. `{{` and `}}`
+     *  escape literal braces. The template is compiled to an array of
+     *  `WriteTextSegment`s and written via writeText(), so line-wrap, width, and
+     *  clipping rules are inherited. */
+    writeMarkup(template: string, options?: WriteTextOptions): void;
+    /** Returns the display width (in terminal cells) of a string,
+     *  honouring wide characters (CJK, emoji, double-width NerdFonts) and
+     *  ignoring zero-width codepoints. Useful for sizing labels or aligning
+     *  text in custom controls. */
+    getTextWidth(text: string): number;
     /**
      * Builds the display buffer: background → user content → border → children.
      * The result is stored in region and used by blitChild / Screen.render().
+     * A hidden window (setVisible(false)) returns immediately so neither its
+     * own paint stages nor its children contribute to the frame; hidden
+     * children are also skipped in the loop below.
      */
     render(): void;
     /** Fills the display buffer with the background style. When inactive, adds dim to every cell.
@@ -101,20 +172,60 @@ export declare class Window {
     private paintBackground;
     /** Overlays user-written content onto the display buffer, merging with any background already set. */
     private blitContent;
-    /** Draws border characters on the display buffer edges. When inactive, adds dim to border cells. */
+    /** Draws border characters on the display buffer edges. When inactive, adds dim to border cells.
+     *  Uses the glyph table for `border.style`, with optional per-character overrides
+     *  via `border.chars`. The 'none' style is a no-op placeholder. */
     private paintBorder;
-    /** Copies a child's display buffer onto this window's display buffer, clipping to this window's bounds.
-     *  Styles are transferred from the child's registry into this window's registry.
-     *  Position is re-resolved from the child's Pos spec relative to the inner content area on every render. */
+    /** Copies a child's display buffer onto this window's display buffer,
+     *  clipping to this window's bounds. Styles are transferred from the child's
+     *  registry into this window's registry. The child's (x, y) was computed by
+     *  the layout engine on addChild / reflowChildren / setSize, so blit can
+     *  read it directly — this keeps absolute and flex paths on the same code. */
     private blitChild;
     /** Removes a previously added child window. No-op if the child is not found. */
     removeChild(child: Window): void;
     /** Replaces both internal regions with new ones of the given dimensions,
      *  then re-resolves sizes and positions of all direct children against the updated inner area. */
-    private resizeRegions;
-    /** Re-resolves sizes and absolute positions for every direct child against the current inner area.
-     *  Called after this window is resized so that percentage-based children get correct dimensions. */
+    protected resizeRegions(w: number, h: number): void;
+    /** Resizes this window to the given absolute dimensions and reflows every
+     *  descendant whose size or position is percentage-based against the new
+     *  inner area. Existing absolute children keep their declared geometry but
+     *  have their stored x/y refreshed by reflowChildren() so the parent's
+     *  border insets still apply. The previously written content is discarded
+     *  — callers that need to preserve it must redraw after setSize(). */
+    setSize(width: number, height: number): void;
+    /** Re-resolves sizes and absolute positions for every direct child against
+     *  the current inner area. Delegates to the layout engine so percentage
+     *  children, flex children, and grid cells are all updated from the same
+     *  code path. Called after this window is resized or a new child is added. */
     private reflowChildren;
+    /** Runs the layout engine against the current inner area. Dispatches to
+     *  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. */
+    private layoutAbsolute;
+    /** Row / column flex layout. The main axis (width for 'row', height for
+     *  'column') is distributed across children: each child starts with its
+     *  basis (abs → value, pct → fraction of parent, flex → flex basis,
+     *  content → measured natural size), then remaining slack is distributed
+     *  pro rata by `grow`, and negative slack by `shrink`. The cross axis is
+     *  aligned via `alignItems` — 'stretch' expands flex/content children to
+     *  the full inner cross dimension. `justifyContent` governs leftover
+     *  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). */
+    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. */
+    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. */
+    private orderedVisibleChildren;
     /** Returns the flat index for (x, y) in the region buffer (used by getCell). */
     private flatIndex;
 }

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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"}