@promptctl/rich-js 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,99 @@
+export { cellLen, setCellSize, splitText, chopCells } from "./core/cells.js";
+export { ColorRgba, ColorTable, ColorDepth, ColorSpec, ColorParseError, TerminalTheme, parseRgbHex, parseRgbaHex, blendRgb, resolveColorSystem, detectColorSystem, STANDARD_TABLE, EIGHT_BIT_TABLE, WINDOWS_TABLE, ANSI_COLOR_NAMES, } from "./core/color.js";
+export type { DetectColorOptions } from "./core/color.js";
+export { Palette } from "./themes/palette.js";
+export { PaletteResolver } from "./themes/paletteResolver.js";
+export type { ResolveContext } from "./themes/paletteResolver.js";
+export { buildPalette } from "./themes/buildPalette.js";
+export type { BaseColors } from "./themes/buildPalette.js";
+export { DEFAULT_TERMINAL_THEME, MONOKAI, SVG_EXPORT_THEME, NORD, GRUVBOX, DRACULA, TOKYO_NIGHT, FLEXOKI, CATPPUCCIN_MOCHA, CATPPUCCIN_LATTE, CATPPUCCIN_FRAPPE, CATPPUCCIN_MACCHIATO, SOLARIZED_DARK, SOLARIZED_LIGHT, ROSE_PINE, ROSE_PINE_MOON, ROSE_PINE_DAWN, ATOM_ONE_DARK, ATOM_ONE_LIGHT, } from "./themes/terminalThemes.js";
+export { Style, StyleSyntaxError, StyleStack, Theme, NULL_STYLE, DEFAULT_STYLES, } from "./core/style.js";
+export type { StyleOptions } from "./core/style.js";
+export { Segment, ControlType, } from "./core/segment.js";
+export type { ControlCode } from "./core/segment.js";
+export { Box } from "./core/box.js";
+export type { BoxChars, RowLevel, SubstituteOptions } from "./core/box.js";
+export { ASCII, ASCII2, ASCII_DOUBLE_HEAD, SQUARE, SQUARE_DOUBLE_HEAD, MINIMAL, MINIMAL_HEAVY_HEAD, MINIMAL_DOUBLE_HEAD, SIMPLE, SIMPLE_HEAD, SIMPLE_HEAVY, HORIZONTALS, ROUNDED, HEAVY, HEAVY_EDGE, HEAVY_HEAD, DOUBLE, DOUBLE_EDGE, MARKDOWN, } from "./core/box.js";
+export { isRenderable, isMeasurable, } from "./core/protocol.js";
+export type { RenderOptions, Renderable, Measurable, } from "./core/protocol.js";
+export { Measurement, measureRenderables } from "./core/measure.js";
+export { Span, RichText } from "./core/text.js";
+export type { RichTextOptions } from "./core/text.js";
+export { Strip, StripCell, PowerlineJoiner, CapsuleJoiner, PlainJoiner, GradientJoiner, } from "./core/strip.js";
+export type { StyledRenderable, StripCellPart, Joiner, PowerlineJoinerOptions, CapsuleJoinerOptions, PlainJoinerOptions, GradientJoinerOptions, } from "./core/strip.js";
+export { renderToString, segmentToString, segmentsToString, } from "./core/render.js";
+export type { RenderToStringOptions } from "./core/render.js";
+export { MarkupRegistry, globalMarkupRegistry, registerMarkupTag, unregisterMarkupTag, renderMarkup, } from "./core/markup.js";
+export type { MarkupTagContext, MarkupTagHandler, RenderMarkupOptions, } from "./core/markup.js";
+export { EMOJI, emojiReplace, Emoji, NoEmoji } from "./core/emoji.js";
+export { Tag, MarkupError, escape as escapeMarkup, } from "./core/markup.js";
+export { Highlighter, NullHighlighter, RegexHighlighter, ReprHighlighter, JSONHighlighter, ISO8601Highlighter, } from "./core/highlighter.js";
+export { SPINNERS, DEFAULT_SPINNER } from "./core/spinnerData.js";
+export type { SpinnerData } from "./core/spinnerData.js";
+export { Console } from "./core/console.js";
+export type { ConsoleOptions, PrintOptions } from "./core/console.js";
+export { Constrain } from "./renderables/constrain.js";
+export { Align } from "./renderables/align.js";
+export type { Alignment } from "./renderables/align.js";
+export { Padding } from "./renderables/padding.js";
+export type { PaddingDimensions } from "./renderables/padding.js";
+export { Rule } from "./renderables/rule.js";
+export type { RuleAlign, RuleOptions } from "./renderables/rule.js";
+export { Panel } from "./renderables/panel.js";
+export type { PanelOptions } from "./renderables/panel.js";
+export { Group } from "./renderables/group.js";
+export { ProgressBar } from "./renderables/progressBar.js";
+export type { ProgressBarOptions } from "./renderables/progressBar.js";
+export { Spinner } from "./renderables/spinner.js";
+export type { SpinnerOptions } from "./renderables/spinner.js";
+export { Table, Column } from "./renderables/table.js";
+export type { TableOptions, ColumnOptions } from "./renderables/table.js";
+export { Tree } from "./renderables/tree.js";
+export type { TreeOptions } from "./renderables/tree.js";
+export { JSONRenderable } from "./renderables/json.js";
+export type { JSONOptions } from "./renderables/json.js";
+export { Pretty } from "./renderables/pretty.js";
+export type { PrettyOptions } from "./renderables/pretty.js";
+export { Columns } from "./renderables/columns.js";
+export type { ColumnsOptions } from "./renderables/columns.js";
+export { FlexStrip } from "./renderables/flexStrip.js";
+export type { FlexStripOptions, FlexAlign } from "./renderables/flexStrip.js";
+export { Live } from "./renderables/live.js";
+export type { LiveOptions } from "./renderables/live.js";
+export { Status } from "./renderables/status.js";
+export type { StatusOptions } from "./renderables/status.js";
+export { Progress, TextColumn, BarColumn, TaskProgressColumn, TimeRemainingColumn, TimeElapsedColumn, SpinnerColumn, MofNCompleteColumn, track, } from "./renderables/progress.js";
+export type { ProgressOptions, TaskOptions, TaskUpdateOptions } from "./renderables/progress.js";
+export { Prompt, IntPrompt, FloatPrompt, Confirm } from "./renderables/prompt.js";
+export { Traceback } from "./renderables/traceback.js";
+export type { TracebackOptions } from "./renderables/traceback.js";
+export { Syntax } from "./renderables/syntax.js";
+export type { SyntaxOptions } from "./renderables/syntax.js";
+export { Markdown } from "./renderables/markdown.js";
+export type { MarkdownOptions } from "./renderables/markdown.js";
+export { Layout } from "./renderables/layout.js";
+export type { LayoutOptions } from "./renderables/layout.js";
+export type { KeyEvent, WidgetMouseEvent, WidgetFocusEvent, WidgetBounds, InteractiveWidget, FocusManager, Screen, MountEntry, Placement, Unsubscribe, } from "./widgets/types.js";
+export { FLOW } from "./widgets/types.js";
+export { StaticItem } from "./widgets/static-item.js";
+export type { StaticItemOptions } from "./widgets/static-item.js";
+export { WidgetBase } from "./widgets/widget-base.js";
+export { DefaultFocusManager } from "./widgets/focus-manager.js";
+export { DefaultScreen } from "./widgets/screen.js";
+export type { ScreenOptions, ColorSystemSpec } from "./widgets/screen.js";
+export { Button } from "./widgets/button.js";
+export type { ButtonVariant, ButtonOptions } from "./widgets/button.js";
+export { Checkbox } from "./widgets/checkbox.js";
+export type { CheckboxOptions } from "./widgets/checkbox.js";
+export { Toggle } from "./widgets/toggle.js";
+export type { ToggleVariant, ToggleOptions } from "./widgets/toggle.js";
+export { TextInput } from "./widgets/text-input.js";
+export type { TextInputOptions } from "./widgets/text-input.js";
+export { Dropdown } from "./widgets/dropdown.js";
+export type { DropdownOptions } from "./widgets/dropdown.js";
+export { Slider } from "./widgets/slider.js";
+export type { SliderOptions } from "./widgets/slider.js";
+export { EventRouter } from "./widgets/event-router.js";
+export type { EventRouterOptions } from "./widgets/event-router.js";
+export { createRichTextEngine, richTextFuncs } from "./template-bindings/index.js";
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,72 @@
+// Core primitives
+export { cellLen, setCellSize, splitText, chopCells } from "./core/cells.js";
+export { ColorRgba, ColorTable, ColorDepth, ColorSpec, ColorParseError, TerminalTheme, parseRgbHex, parseRgbaHex, blendRgb, resolveColorSystem, detectColorSystem, STANDARD_TABLE, EIGHT_BIT_TABLE, WINDOWS_TABLE, ANSI_COLOR_NAMES, } from "./core/color.js";
+// Themes — semantic palettes (distinct from ColorTable quantization LUTs)
+export { Palette } from "./themes/palette.js";
+export { PaletteResolver } from "./themes/paletteResolver.js";
+export { buildPalette } from "./themes/buildPalette.js";
+export { DEFAULT_TERMINAL_THEME, MONOKAI, SVG_EXPORT_THEME, NORD, GRUVBOX, DRACULA, TOKYO_NIGHT, FLEXOKI, CATPPUCCIN_MOCHA, CATPPUCCIN_LATTE, CATPPUCCIN_FRAPPE, CATPPUCCIN_MACCHIATO, SOLARIZED_DARK, SOLARIZED_LIGHT, ROSE_PINE, ROSE_PINE_MOON, ROSE_PINE_DAWN, ATOM_ONE_DARK, ATOM_ONE_LIGHT, } from "./themes/terminalThemes.js";
+export { Style, StyleSyntaxError, StyleStack, Theme, NULL_STYLE, DEFAULT_STYLES, } from "./core/style.js";
+export { Segment, ControlType, } from "./core/segment.js";
+export { Box } from "./core/box.js";
+export { ASCII, ASCII2, ASCII_DOUBLE_HEAD, SQUARE, SQUARE_DOUBLE_HEAD, MINIMAL, MINIMAL_HEAVY_HEAD, MINIMAL_DOUBLE_HEAD, SIMPLE, SIMPLE_HEAD, SIMPLE_HEAVY, HORIZONTALS, ROUNDED, HEAVY, HEAVY_EDGE, HEAVY_HEAD, DOUBLE, DOUBLE_EDGE, MARKDOWN, } from "./core/box.js";
+// Protocol
+export { isRenderable, isMeasurable, } from "./core/protocol.js";
+// Measurement
+export { Measurement, measureRenderables } from "./core/measure.js";
+// Text
+export { Span, RichText } from "./core/text.js";
+// Strip + Joiner
+export { Strip, StripCell, PowerlineJoiner, CapsuleJoiner, PlainJoiner, GradientJoiner, } from "./core/strip.js";
+// renderToString — stateless one-shot emission
+export { renderToString, segmentToString, segmentsToString, } from "./core/render.js";
+// Markup plugin tags
+export { MarkupRegistry, globalMarkupRegistry, registerMarkupTag, unregisterMarkupTag, renderMarkup, } from "./core/markup.js";
+// Emoji
+export { EMOJI, emojiReplace, Emoji, NoEmoji } from "./core/emoji.js";
+// Markup
+export { Tag, MarkupError, escape as escapeMarkup, } from "./core/markup.js";
+// Highlighter
+export { Highlighter, NullHighlighter, RegexHighlighter, ReprHighlighter, JSONHighlighter, ISO8601Highlighter, } from "./core/highlighter.js";
+// Spinner data
+export { SPINNERS, DEFAULT_SPINNER } from "./core/spinnerData.js";
+// Console
+export { Console } from "./core/console.js";
+// Renderables
+export { Constrain } from "./renderables/constrain.js";
+export { Align } from "./renderables/align.js";
+export { Padding } from "./renderables/padding.js";
+export { Rule } from "./renderables/rule.js";
+export { Panel } from "./renderables/panel.js";
+export { Group } from "./renderables/group.js";
+export { ProgressBar } from "./renderables/progressBar.js";
+export { Spinner } from "./renderables/spinner.js";
+export { Table, Column } from "./renderables/table.js";
+export { Tree } from "./renderables/tree.js";
+export { JSONRenderable } from "./renderables/json.js";
+export { Pretty } from "./renderables/pretty.js";
+export { Columns } from "./renderables/columns.js";
+export { FlexStrip } from "./renderables/flexStrip.js";
+export { Live } from "./renderables/live.js";
+export { Status } from "./renderables/status.js";
+export { Progress, TextColumn, BarColumn, TaskProgressColumn, TimeRemainingColumn, TimeElapsedColumn, SpinnerColumn, MofNCompleteColumn, track, } from "./renderables/progress.js";
+export { Prompt, IntPrompt, FloatPrompt, Confirm } from "./renderables/prompt.js";
+export { Traceback } from "./renderables/traceback.js";
+export { Syntax } from "./renderables/syntax.js";
+export { Markdown } from "./renderables/markdown.js";
+export { Layout } from "./renderables/layout.js";
+export { FLOW } from "./widgets/types.js";
+export { StaticItem } from "./widgets/static-item.js";
+export { WidgetBase } from "./widgets/widget-base.js";
+export { DefaultFocusManager } from "./widgets/focus-manager.js";
+export { DefaultScreen } from "./widgets/screen.js";
+export { Button } from "./widgets/button.js";
+export { Checkbox } from "./widgets/checkbox.js";
+export { Toggle } from "./widgets/toggle.js";
+export { TextInput } from "./widgets/text-input.js";
+export { Dropdown } from "./widgets/dropdown.js";
+export { Slider } from "./widgets/slider.js";
+export { EventRouter } from "./widgets/event-router.js";
+// Template bindings — register rich-js styling as @promptctl/go-template-js functions
+export { createRichTextEngine, richTextFuncs } from "./template-bindings/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/renderables/align.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Align — wraps a renderable and aligns its output horizontally.
+ */
+import { Segment } from "../core/segment.js";
+import type { Renderable, Measurable, RenderOptions } from "../core/protocol.js";
+export type Alignment = "left" | "center" | "right";
+export declare class Align implements Renderable, Measurable {
+    readonly renderable: Renderable;
+    readonly align: Alignment;
+    constructor(renderable: Renderable, align?: Alignment);
+    render(options: RenderOptions): Iterable<Segment>;
+    measure(options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=align.d.ts.map

package/dist/renderables/align.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"align.d.ts","sourceRoot":"","sources":["../../src/renderables/align.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,qBAAa,KAAM,YAAW,UAAU,EAAE,UAAU;IAClD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;gBAEd,UAAU,EAAE,UAAU,EAAE,KAAK,GAAE,SAAoB;IAK9D,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IA2BlD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAUtE"}

package/dist/renderables/align.js

@@ -0,0 +1,47 @@
+/**
+ * Align — wraps a renderable and aligns its output horizontally.
+ */
+import { Segment } from "../core/segment.js";
+import { Measurement } from "../core/measure.js";
+import { isMeasurable } from "../core/protocol.js";
+export class Align {
+    renderable;
+    align;
+    constructor(renderable, align = "center") {
+        this.renderable = renderable;
+        this.align = align;
+    }
+    *render(options) {
+        const maxWidth = options.maxWidth;
+        const segments = [...this.renderable.render(options)];
+        const lines = Segment.splitLines(segments);
+        for (const line of lines) {
+            const lineWidth = Segment.getLineLength(line);
+            const gap = maxWidth - lineWidth;
+            // [LAW:dataflow-not-control-flow] Always compute padding; gap <= 0 produces empty strings
+            const leftPad = this.align === "right"
+                ? gap
+                : this.align === "center"
+                    ? Math.floor(gap / 2)
+                    : 0;
+            if (leftPad > 0)
+                yield new Segment(" ".repeat(leftPad));
+            yield* line;
+            const rightPad = gap - leftPad;
+            if (rightPad > 0)
+                yield new Segment(" ".repeat(rightPad));
+            yield Segment.line();
+        }
+    }
+    measure(options) {
+        if (isMeasurable(this.renderable)) {
+            const measurement = Measurement.get(options, this.renderable);
+            return {
+                minimum: Math.max(1, measurement.minimum),
+                maximum: measurement.maximum,
+            };
+        }
+        return { minimum: 1, maximum: options.maxWidth };
+    }
+}
+//# sourceMappingURL=align.js.map

package/dist/renderables/align.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"align.js","sourceRoot":"","sources":["../../src/renderables/align.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,OAAO,KAAK;IACP,UAAU,CAAa;IACvB,KAAK,CAAY;IAE1B,YAAY,UAAsB,EAAE,QAAmB,QAAQ;QAC7D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,CAAC,MAAM,CAAC,OAAsB;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,QAAQ,GAAG,SAAS,CAAC;YAEjC,0FAA0F;YAC1F,MAAM,OAAO,GACX,IAAI,CAAC,KAAK,KAAK,OAAO;gBACpB,CAAC,CAAC,GAAG;gBACL,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ;oBACvB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;oBACrB,CAAC,CAAC,CAAC,CAAC;YAEV,IAAI,OAAO,GAAG,CAAC;gBAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YACxD,KAAK,CAAC,CAAC,IAAI,CAAC;YAEZ,MAAM,QAAQ,GAAG,GAAG,GAAG,OAAO,CAAC;YAC/B,IAAI,QAAQ,GAAG,CAAC;gBAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAE1D,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9D,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;gBACzC,OAAO,EAAE,WAAW,CAAC,OAAO;aAC7B,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;IACnD,CAAC;CACF"}

package/dist/renderables/columns.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Columns — arranges renderables in a multi-column layout.
+ */
+import { Segment } from "../core/segment.js";
+import type { PaddingDimensions } from "./padding.js";
+import type { Renderable, Measurable, RenderOptions } from "../core/protocol.js";
+export interface ColumnsOptions {
+    expand?: boolean;
+    equal?: boolean;
+    width?: number;
+    padding?: PaddingDimensions;
+    columnFirst?: boolean;
+}
+export declare class Columns implements Renderable, Measurable {
+    renderables: (Renderable & Partial<Measurable>)[];
+    readonly expand: boolean;
+    readonly equal: boolean;
+    readonly colWidth: number | undefined;
+    readonly columnFirst: boolean;
+    readonly gutterWidth: number;
+    constructor(items?: Iterable<unknown>, options?: ColumnsOptions);
+    render(options: RenderOptions): Iterable<Segment>;
+    measure(options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=columns.d.ts.map

package/dist/renderables/columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/renderables/columns.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AASD,qBAAa,OAAQ,YAAW,UAAU,EAAE,UAAU;IACpD,WAAW,EAAE,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,KAAK,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;IAS9D,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IAiElD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAGtE"}

package/dist/renderables/columns.js

@@ -0,0 +1,92 @@
+/**
+ * Columns — arranges renderables in a multi-column layout.
+ */
+import { Segment } from "../core/segment.js";
+import { Measurement } from "../core/measure.js";
+import { RichText } from "../core/text.js";
+import { isMeasurable } from "../core/protocol.js";
+function toRenderable(item) {
+    if (typeof item === "object" && item !== null && "render" in item) {
+        return item;
+    }
+    return new RichText(String(item ?? ""), { end: "" });
+}
+export class Columns {
+    renderables;
+    expand;
+    equal;
+    colWidth;
+    columnFirst;
+    gutterWidth;
+    constructor(items, options) {
+        this.renderables = items ? [...items].map(toRenderable) : [];
+        this.expand = options?.expand ?? false;
+        this.equal = options?.equal ?? false;
+        this.colWidth = options?.width;
+        this.columnFirst = options?.columnFirst ?? false;
+        this.gutterWidth = 2; // default gutter between columns
+    }
+    *render(options) {
+        const items = this.renderables;
+        if (items.length === 0)
+            return;
+        const maxWidth = options.maxWidth;
+        // Determine column widths
+        let numCols;
+        let colWidths;
+        if (this.colWidth !== undefined) {
+            numCols = Math.max(1, Math.floor((maxWidth + this.gutterWidth) / (this.colWidth + this.gutterWidth)));
+            colWidths = new Array(numCols).fill(this.colWidth);
+        }
+        else if (this.equal) {
+            // Measure all items to find the widest
+            let maxItemWidth = 1;
+            for (const item of items) {
+                if (isMeasurable(item)) {
+                    const m = Measurement.get(options, item);
+                    maxItemWidth = Math.max(maxItemWidth, m.maximum);
+                }
+            }
+            numCols = Math.max(1, Math.floor((maxWidth + this.gutterWidth) / (maxItemWidth + this.gutterWidth)));
+            const equalWidth = Math.floor((maxWidth - this.gutterWidth * (numCols - 1)) / numCols);
+            colWidths = new Array(numCols).fill(equalWidth);
+        }
+        else {
+            // Auto: fit as many columns as possible
+            numCols = Math.min(items.length, Math.max(1, Math.floor(maxWidth / 4)));
+            const colW = Math.floor((maxWidth - this.gutterWidth * (numCols - 1)) / numCols);
+            colWidths = new Array(numCols).fill(colW);
+        }
+        // Layout items into rows
+        const numRows = Math.ceil(items.length / numCols);
+        for (let row = 0; row < numRows; row++) {
+            for (let col = 0; col < numCols; col++) {
+                const idx = this.columnFirst
+                    ? col * numRows + row
+                    : row * numCols + col;
+                if (idx >= items.length) {
+                    if (col < numCols - 1) {
+                        yield new Segment(" ".repeat(colWidths[col] + this.gutterWidth));
+                    }
+                    continue;
+                }
+                const item = items[idx];
+                const cellWidth = colWidths[col];
+                const cellOpts = { ...options, maxWidth: cellWidth };
+                const segs = [...item.render(cellOpts)];
+                const lines = Segment.splitLines(segs);
+                const firstLine = lines[0] ?? [];
+                const adjusted = Segment.adjustLineLength(firstLine, cellWidth);
+                yield* adjusted;
+                if (col < numCols - 1) {
+                    yield new Segment(" ".repeat(this.gutterWidth));
+                }
+            }
+            yield Segment.line();
+        }
+    }
+    measure(options) {
+        return { minimum: 1, maximum: options.maxWidth };
+    }
+}
+//# sourceMappingURL=columns.js.map

package/dist/renderables/columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","sourceRoot":"","sources":["../../src/renderables/columns.ts"],"names":[],"mappings":"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"}

package/dist/renderables/constrain.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Constrain — wraps a renderable and constrains its maximum width.
+ */
+import { Segment } from "../core/segment.js";
+import type { Renderable, Measurable, RenderOptions } from "../core/protocol.js";
+export declare class Constrain implements Renderable, Measurable {
+    readonly renderable: Renderable;
+    readonly width: number | undefined;
+    constructor(renderable: Renderable, width?: number);
+    render(options: RenderOptions): Iterable<Segment>;
+    measure(options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=constrain.d.ts.map

package/dist/renderables/constrain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constrain.d.ts","sourceRoot":"","sources":["../../src/renderables/constrain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAG7B,qBAAa,SAAU,YAAW,UAAU,EAAE,UAAU;IACtD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEvB,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM;IAKjD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IAelD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CActE"}

package/dist/renderables/constrain.js

@@ -0,0 +1,38 @@
+/**
+ * Constrain — wraps a renderable and constrains its maximum width.
+ */
+import { Measurement } from "../core/measure.js";
+import { isMeasurable } from "../core/protocol.js";
+export class Constrain {
+    renderable;
+    width;
+    constructor(renderable, width) {
+        this.renderable = renderable;
+        this.width = width;
+    }
+    *render(options) {
+        // [LAW:dataflow-not-control-flow] Always compute constrainedWidth; undefined means no constraint
+        const constrainedWidth = this.width !== undefined
+            ? Math.min(this.width, options.maxWidth)
+            : options.maxWidth;
+        const innerOptions = {
+            ...options,
+            maxWidth: constrainedWidth,
+        };
+        yield* this.renderable.render(innerOptions);
+    }
+    measure(options) {
+        if (isMeasurable(this.renderable)) {
+            const measurement = Measurement.get(options, this.renderable);
+            const maxWidth = this.width !== undefined
+                ? Math.min(this.width, options.maxWidth)
+                : options.maxWidth;
+            return {
+                minimum: measurement.minimum,
+                maximum: Math.min(measurement.maximum, maxWidth),
+            };
+        }
+        return { minimum: 1, maximum: options.maxWidth };
+    }
+}
+//# sourceMappingURL=constrain.js.map

package/dist/renderables/constrain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constrain.js","sourceRoot":"","sources":["../../src/renderables/constrain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,OAAO,SAAS;IACX,UAAU,CAAa;IACvB,KAAK,CAAqB;IAEnC,YAAY,UAAsB,EAAE,KAAc;QAChD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,CAAC,MAAM,CAAC,OAAsB;QAC5B,iGAAiG;QACjG,MAAM,gBAAgB,GACpB,IAAI,CAAC,KAAK,KAAK,SAAS;YACtB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC;YACxC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QAEvB,MAAM,YAAY,GAAkB;YAClC,GAAG,OAAO;YACV,QAAQ,EAAE,gBAAgB;SAC3B,CAAC;QAEF,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9D,MAAM,QAAQ,GACZ,IAAI,CAAC,KAAK,KAAK,SAAS;gBACtB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC;gBACxC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC;aACjD,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;IACnD,CAAC;CACF"}

package/dist/renderables/flexStrip.d.ts

@@ -0,0 +1,42 @@
+/**
+ * FlexStrip — wrap-to-width horizontal layout for `StyledRenderable` items.
+ *
+ * Pack as many items as fit on a line, then break and continue. Each line is
+ * an independent sub-strip: optional `Joiner` end-caps fire at every line
+ * boundary (not just the strip's first/last position), so a line break looks
+ * the same as an endpoint to the joiner. Composes with the Strip + Joiner
+ * primitive in `core/strip` — same `Joiner` protocol, no new join semantics.
+ *
+ * [LAW:dataflow-not-control-flow] The pack walk is the same shape every
+ * render: measure each item, render every joiner form (start-cap, end-cap,
+ * mid-join) up-front, then sweep items into lines. Line breaks are decided by
+ * width data, not by control-flow special cases.
+ *
+ * [LAW:one-source-of-truth] The Strip primitive owns the join protocol;
+ * FlexStrip reuses it verbatim. There is no second concept of "join."
+ */
+import { Segment } from "../core/segment.js";
+import type { Renderable, Measurable, RenderOptions } from "../core/protocol.js";
+import type { Joiner, StyledRenderable } from "../core/strip.js";
+export type FlexAlign = "left" | "center" | "right" | "justify";
+export interface FlexStripOptions<T extends StyledRenderable> {
+    /** Joiner used between items within a line, and at line endpoints. */
+    joiner?: Joiner<T>;
+    /** Cells of horizontal space inserted on each side of an inter-item joiner (default 0). */
+    gap?: number;
+    /** Line alignment when packed items don't fill the available width (default "left"). */
+    align?: FlexAlign;
+}
+export declare class FlexStrip<T extends StyledRenderable = StyledRenderable> implements Renderable, Measurable {
+    readonly items: readonly T[];
+    readonly joiner: Joiner<T> | undefined;
+    readonly gap: number;
+    readonly align: FlexAlign;
+    constructor(items: readonly T[], options?: FlexStripOptions<T>);
+    render(options: RenderOptions): Iterable<Segment>;
+    measure(options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=flexStrip.d.ts.map

package/dist/renderables/flexStrip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flexStrip.d.ts","sourceRoot":"","sources":["../../src/renderables/flexStrip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,gBAAgB;IAC1D,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,2FAA2F;IAC3F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AA2CD,qBAAa,SAAS,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,CAClE,YAAW,UAAU,EAAE,UAAU;IAEjC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;gBAEd,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAO7D,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IAgIlD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CA4BtE"}