@outfitter/tui 0.2.0

package/dist/shared/@outfitter/tui-zcspg6z6.d.ts

@@ -0,0 +1,190 @@
+import { BoxOptions } from "./tui-x3yg0887";
+import { LayoutContext, WidthMode } from "./tui-75bztyfp";
+/**
+* Gets the current terminal width.
+*
+* Returns `process.stdout.columns` if available, otherwise falls back to 80
+* (standard terminal width).
+*
+* @returns Terminal width in characters
+*
+* @example
+* ```typescript
+* import { getTerminalWidth } from "@outfitter/tui/render";
+*
+* const width = getTerminalWidth();
+* console.log(`Terminal is ${width} columns wide`);
+* ```
+*/
+declare function getTerminalWidth(): number;
+/**
+* Calculates box overhead (borders + padding) for each axis.
+*
+* Returns the total character/line count consumed by borders and padding,
+* separate from content.
+*
+* @param options - Box options (padding, borders)
+* @returns Object with horizontal and vertical overhead
+*
+* @example
+* ```typescript
+* import { getBoxOverhead } from "@outfitter/tui/render";
+*
+* const overhead = getBoxOverhead({ padding: 1, border: "single" });
+* // { horizontal: 4, vertical: 2 }
+* // horizontal: left border (1) + left padding (1) + right padding (1) + right border (1)
+* // vertical: top border (1) + bottom border (1)
+* ```
+*/
+declare function getBoxOverhead(options: BoxOptions): {
+	horizontal: number;
+	vertical: number;
+};
+/**
+* Calculates available content width inside a box.
+*
+* Accounts for borders and padding to determine how much space remains
+* for content. Use this to size nested components appropriately.
+*
+* @param options - Box options (width, padding, borders)
+* @returns Available width in characters for content
+*
+* @example
+* ```typescript
+* import { getContentWidth, createBox, renderProgress } from "@outfitter/tui/render";
+*
+* const boxOpts = { width: 40, padding: 1, border: "single" };
+* const available = getContentWidth(boxOpts); // → 36
+*
+* const progress = renderProgress(0.5, { width: available });
+* const box = createBox(progress, boxOpts);
+* ```
+*/
+declare function getContentWidth(options: BoxOptions): number;
+/**
+* Resolves a width mode to a concrete character width.
+*
+* Width modes allow flexible sizing relative to terminal or container:
+* - `"text"` → 0 (content-sized, no constraint)
+* - `"full"` → terminal width
+* - `"container"` → container width (requires context)
+* - `number` → fixed width
+* - `"${number}%"` → percentage of container/terminal
+*
+* @param mode - Width specification
+* @param ctx - Layout context for container-relative modes
+* @returns Resolved width in characters
+* @throws Error if "container" mode used without context
+*
+* @example
+* ```typescript
+* import { resolveWidth, createLayoutContext } from "@outfitter/tui/render";
+*
+* resolveWidth("full");           // → 120 (terminal width)
+* resolveWidth(50);               // → 50
+* resolveWidth("50%");            // → 60 (half of terminal)
+*
+* const ctx = createLayoutContext({ width: 80, padding: 1 });
+* resolveWidth("50%", ctx);       // → 38 (half of context width)
+* resolveWidth("container", ctx); // → 76 (context width)
+* ```
+*/
+declare function resolveWidth(mode: WidthMode, ctx?: LayoutContext): number;
+/**
+* Creates a layout context from box options.
+*
+* Layout contexts propagate width information through nested components,
+* enabling relative sizing like `"50%"` or `"container"`.
+*
+* @param options - Box options defining the container
+* @param parent - Parent context for chained calculations
+* @returns New layout context with calculated content width
+*
+* @example
+* ```typescript
+* import { createLayoutContext, resolveWidth, createBox } from "@outfitter/tui/render";
+*
+* // Outer container
+* const outerOpts = { width: 80, padding: 1 };
+* const outerCtx = createLayoutContext(outerOpts);
+* // outerCtx.width = 76 (80 - 4 overhead)
+*
+* // Nested component at 50% width
+* const innerWidth = resolveWidth("50%", outerCtx);
+* const innerOpts = { width: innerWidth, padding: 1 };
+* const innerCtx = createLayoutContext(innerOpts, outerCtx);
+* // innerCtx.width = 34 (38 - 4 overhead)
+* ```
+*/
+declare function createLayoutContext(options: BoxOptions, parent?: LayoutContext): LayoutContext;
+/**
+* Vertical alignment for horizontal layout.
+*/
+type Alignment = "top" | "center" | "bottom";
+/**
+* Options for horizontal layout.
+*/
+interface HorizontalLayoutOptions {
+	/** Gap (in characters) between blocks */
+	gap?: number;
+	/** Vertical alignment of blocks */
+	align?: Alignment;
+}
+/**
+* Options for vertical layout.
+*/
+interface VerticalLayoutOptions {
+	/** Gap (in lines) between blocks */
+	gap?: number;
+}
+/**
+* Joins multiple text blocks horizontally (side by side).
+*
+* Handles blocks of different heights by aligning them according
+* to the `align` option. Blocks are padded to maintain alignment.
+*
+* @param blocks - Array of text blocks to join
+* @param options - Layout options
+* @returns Combined string with blocks side by side
+*
+* @example
+* ```typescript
+* import { joinHorizontal } from "@outfitter/tui/render";
+* import { renderBox } from "@outfitter/tui/render";
+*
+* const left = renderBox({ content: "Left", borderStyle: "single" });
+* const right = renderBox({ content: "Right", borderStyle: "single" });
+*
+* console.log(joinHorizontal([left, right], { gap: 2 }));
+* // ┌──────┐  ┌───────┐
+* // │ Left │  │ Right │
+* // └──────┘  └───────┘
+* ```
+*/
+declare function joinHorizontal(blocks: string[], options?: HorizontalLayoutOptions): string;
+/**
+* Joins multiple text blocks vertically (stacked).
+*
+* @param blocks - Array of text blocks to stack
+* @param options - Layout options
+* @returns Combined string with blocks stacked
+*
+* @example
+* ```typescript
+* import { joinVertical, renderHeading, renderSeparator } from "@outfitter/tui/render";
+*
+* const heading = renderHeading("Section Title");
+* const separator = renderSeparator({ width: 20 });
+* const content = "Some content here.";
+*
+* console.log(joinVertical([heading, separator, content], { gap: 1 }));
+* // SECTION TITLE
+* // =============
+* //
+* // ────────────────────
+* //
+* // Some content here.
+* ```
+*/
+declare function joinVertical(blocks: string[], options?: VerticalLayoutOptions): string;
+export { getTerminalWidth, getBoxOverhead, getContentWidth, resolveWidth, createLayoutContext, Alignment, HorizontalLayoutOptions, VerticalLayoutOptions, joinHorizontal, joinVertical };

package/dist/shared/@outfitter/tui-zhbsnj7w.js

@@ -0,0 +1 @@
+// @bun

package/dist/streaming/ansi.d.ts

@@ -0,0 +1,2 @@
+import { ANSI } from "../shared/@outfitter/tui-yw9n5h6q";
+export { ANSI };

package/dist/streaming/ansi.js

@@ -0,0 +1,8 @@
+// @bun
+import {
+  ANSI
+} from "../shared/@outfitter/tui-2wfat6jb.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  ANSI
+};

package/dist/streaming/index.d.ts

@@ -0,0 +1,4 @@
+import { Spinner, SpinnerOptions, SpinnerStyle, createSpinner } from "../shared/@outfitter/tui-ykzs6v4v";
+import { ANSI } from "../shared/@outfitter/tui-yw9n5h6q";
+import { StreamWriter, StreamWriterOptions, WritableStream, createStreamWriter } from "../shared/@outfitter/tui-b14ry1j1";
+export { createStreamWriter, createSpinner, WritableStream, StreamWriterOptions, StreamWriter, SpinnerStyle, SpinnerOptions, Spinner, ANSI };

package/dist/streaming/index.js

@@ -0,0 +1,17 @@
+// @bun
+import {
+  createSpinner
+} from "../shared/@outfitter/tui-dh15zwg0.js";
+import {
+  createStreamWriter
+} from "../shared/@outfitter/tui-rgkerz72.js";
+import {
+  ANSI
+} from "../shared/@outfitter/tui-2wfat6jb.js";
+import"../shared/@outfitter/tui-pdwbbzwr.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  createStreamWriter,
+  createSpinner,
+  ANSI
+};

package/dist/streaming/spinner.d.ts

@@ -0,0 +1,3 @@
+import { Spinner, SpinnerOptions, SpinnerStyle, createSpinner } from "../shared/@outfitter/tui-ykzs6v4v";
+import "../shared/@outfitter/tui-b14ry1j1";
+export { createSpinner, SpinnerStyle, SpinnerOptions, Spinner };

package/dist/streaming/spinner.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  createSpinner
+} from "../shared/@outfitter/tui-dh15zwg0.js";
+import"../shared/@outfitter/tui-2wfat6jb.js";
+import"../shared/@outfitter/tui-pdwbbzwr.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  createSpinner
+};

package/dist/streaming/writer.d.ts

@@ -0,0 +1,2 @@
+import { StreamWriter, StreamWriterOptions, WritableStream, createStreamWriter } from "../shared/@outfitter/tui-b14ry1j1";
+export { createStreamWriter, WritableStream, StreamWriterOptions, StreamWriter };

package/dist/streaming/writer.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  createStreamWriter
+} from "../shared/@outfitter/tui-rgkerz72.js";
+import"../shared/@outfitter/tui-2wfat6jb.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  createStreamWriter
+};

package/dist/table/index.d.ts

@@ -0,0 +1,4 @@
+import "../shared/@outfitter/tui-tpzgdv89";
+import { TableOptions, renderTable } from "../shared/@outfitter/tui-8ejx8gq5";
+import "../shared/@outfitter/tui-1qh888th";
+export { renderTable, TableOptions };

package/dist/table/index.js

@@ -0,0 +1,10 @@
+// @bun
+import"../shared/@outfitter/tui-a8nkrbds.js";
+import {
+  renderTable
+} from "../shared/@outfitter/tui-t1a9xgbd.js";
+import"../shared/@outfitter/tui-2pwhzg55.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  renderTable
+};

package/dist/theme/context.d.ts

@@ -0,0 +1,9 @@
+import { ThemedContextOptions, ThemedLayoutContext, createThemedContext, getContextTheme } from "../shared/@outfitter/tui-qn1rgz9v";
+import "../shared/@outfitter/tui-75bztyfp";
+import "../shared/@outfitter/tui-8j1gbehy";
+import "../shared/@outfitter/tui-wfnnq0zq";
+import "../shared/@outfitter/tui-3dyxg62j";
+import "../shared/@outfitter/tui-9h1kdd98";
+import "../shared/@outfitter/tui-c6ft5w6q";
+import "../shared/@outfitter/tui-1qh888th";
+export { getContextTheme, createThemedContext, ThemedLayoutContext, ThemedContextOptions };

package/dist/theme/context.js

@@ -0,0 +1,12 @@
+// @bun
+import {
+  createThemedContext,
+  getContextTheme
+} from "../shared/@outfitter/tui-kc4nxak0.js";
+import"../shared/@outfitter/tui-0mpqnyc1.js";
+import"../shared/@outfitter/tui-2pwhzg55.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  getContextTheme,
+  createThemedContext
+};

package/dist/theme/create.d.ts

@@ -0,0 +1,8 @@
+import { CreateVisualThemeOptions, createVisualTheme } from "../shared/@outfitter/tui-ve0083wa";
+import "../shared/@outfitter/tui-8j1gbehy";
+import "../shared/@outfitter/tui-wfnnq0zq";
+import "../shared/@outfitter/tui-3dyxg62j";
+import "../shared/@outfitter/tui-9h1kdd98";
+import "../shared/@outfitter/tui-c6ft5w6q";
+import "../shared/@outfitter/tui-1qh888th";
+export { createVisualTheme, CreateVisualThemeOptions };

package/dist/theme/create.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  createVisualTheme
+} from "../shared/@outfitter/tui-nce7fgtf.js";
+import"../shared/@outfitter/tui-0mpqnyc1.js";
+import"../shared/@outfitter/tui-2pwhzg55.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  createVisualTheme
+};

package/dist/theme/index.d.ts

@@ -0,0 +1,17 @@
+import "../shared/@outfitter/tui-zcmvhwd6";
+import { resolveGlyph, resolveStateMarker } from "../shared/@outfitter/tui-ajp1153q";
+import "../shared/@outfitter/tui-tz4ejrey";
+import { roundedTheme } from "../shared/@outfitter/tui-34q2aenf";
+import { boldTheme } from "../shared/@outfitter/tui-011579t8";
+import { minimalTheme } from "../shared/@outfitter/tui-sv2xmh3w";
+import { defaultTheme } from "../shared/@outfitter/tui-2tkva96b";
+import { ThemedContextOptions, ThemedLayoutContext, createThemedContext, getContextTheme } from "../shared/@outfitter/tui-qn1rgz9v";
+import "../shared/@outfitter/tui-75bztyfp";
+import { CreateVisualThemeOptions, createVisualTheme } from "../shared/@outfitter/tui-ve0083wa";
+import { GlyphPair, MarkerSpec, PartialVisualTheme, SemanticState, ThemeColors, ThemeSpacing, VisualTheme } from "../shared/@outfitter/tui-8j1gbehy";
+import "../shared/@outfitter/tui-wfnnq0zq";
+import "../shared/@outfitter/tui-3dyxg62j";
+import "../shared/@outfitter/tui-9h1kdd98";
+import "../shared/@outfitter/tui-c6ft5w6q";
+import "../shared/@outfitter/tui-1qh888th";
+export { roundedTheme, resolveStateMarker, resolveGlyph, minimalTheme, getContextTheme, defaultTheme, createVisualTheme, createThemedContext, boldTheme, VisualTheme, ThemedLayoutContext, ThemedContextOptions, ThemeSpacing, ThemeColors, SemanticState, PartialVisualTheme, MarkerSpec, GlyphPair, CreateVisualThemeOptions };

package/dist/theme/index.js

@@ -0,0 +1,40 @@
+// @bun
+import"../shared/@outfitter/tui-zhbsnj7w.js";
+import {
+  resolveGlyph,
+  resolveStateMarker
+} from "../shared/@outfitter/tui-x9vvtfkk.js";
+import"../shared/@outfitter/tui-pdwbbzwr.js";
+import"../shared/@outfitter/tui-0b85rht7.js";
+import {
+  roundedTheme
+} from "../shared/@outfitter/tui-esc46z2v.js";
+import {
+  boldTheme
+} from "../shared/@outfitter/tui-rwpdjrt3.js";
+import {
+  minimalTheme
+} from "../shared/@outfitter/tui-mch672g9.js";
+import {
+  createThemedContext,
+  getContextTheme
+} from "../shared/@outfitter/tui-kc4nxak0.js";
+import {
+  createVisualTheme
+} from "../shared/@outfitter/tui-nce7fgtf.js";
+import {
+  defaultTheme
+} from "../shared/@outfitter/tui-0mpqnyc1.js";
+import"../shared/@outfitter/tui-2pwhzg55.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  roundedTheme,
+  resolveStateMarker,
+  resolveGlyph,
+  minimalTheme,
+  getContextTheme,
+  defaultTheme,
+  createVisualTheme,
+  createThemedContext,
+  boldTheme
+};

package/dist/theme/presets/bold.d.ts

@@ -0,0 +1,8 @@
+import { boldTheme } from "../../shared/@outfitter/tui-011579t8";
+import "../../shared/@outfitter/tui-8j1gbehy";
+import "../../shared/@outfitter/tui-wfnnq0zq";
+import "../../shared/@outfitter/tui-3dyxg62j";
+import "../../shared/@outfitter/tui-9h1kdd98";
+import "../../shared/@outfitter/tui-c6ft5w6q";
+import "../../shared/@outfitter/tui-1qh888th";
+export { boldTheme };

package/dist/theme/presets/bold.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  boldTheme
+} from "../../shared/@outfitter/tui-rwpdjrt3.js";
+import"../../shared/@outfitter/tui-0mpqnyc1.js";
+import"../../shared/@outfitter/tui-2pwhzg55.js";
+import"../../shared/@outfitter/tui-hescagw2.js";
+export {
+  boldTheme
+};

package/dist/theme/presets/default.d.ts

@@ -0,0 +1,8 @@
+import { defaultTheme } from "../../shared/@outfitter/tui-2tkva96b";
+import "../../shared/@outfitter/tui-8j1gbehy";
+import "../../shared/@outfitter/tui-wfnnq0zq";
+import "../../shared/@outfitter/tui-3dyxg62j";
+import "../../shared/@outfitter/tui-9h1kdd98";
+import "../../shared/@outfitter/tui-c6ft5w6q";
+import "../../shared/@outfitter/tui-1qh888th";
+export { defaultTheme };

package/dist/theme/presets/default.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  defaultTheme
+} from "../../shared/@outfitter/tui-0mpqnyc1.js";
+import"../../shared/@outfitter/tui-2pwhzg55.js";
+import"../../shared/@outfitter/tui-hescagw2.js";
+export {
+  defaultTheme
+};

package/dist/theme/presets/index.d.ts

@@ -0,0 +1,12 @@
+import "../../shared/@outfitter/tui-tz4ejrey";
+import { roundedTheme } from "../../shared/@outfitter/tui-34q2aenf";
+import { boldTheme } from "../../shared/@outfitter/tui-011579t8";
+import { minimalTheme } from "../../shared/@outfitter/tui-sv2xmh3w";
+import { defaultTheme } from "../../shared/@outfitter/tui-2tkva96b";
+import "../../shared/@outfitter/tui-8j1gbehy";
+import "../../shared/@outfitter/tui-wfnnq0zq";
+import "../../shared/@outfitter/tui-3dyxg62j";
+import "../../shared/@outfitter/tui-9h1kdd98";
+import "../../shared/@outfitter/tui-c6ft5w6q";
+import "../../shared/@outfitter/tui-1qh888th";
+export { roundedTheme, minimalTheme, defaultTheme, boldTheme };

package/dist/theme/presets/index.js

@@ -0,0 +1,22 @@
+// @bun
+import"../../shared/@outfitter/tui-0b85rht7.js";
+import {
+  roundedTheme
+} from "../../shared/@outfitter/tui-esc46z2v.js";
+import {
+  boldTheme
+} from "../../shared/@outfitter/tui-rwpdjrt3.js";
+import {
+  minimalTheme
+} from "../../shared/@outfitter/tui-mch672g9.js";
+import {
+  defaultTheme
+} from "../../shared/@outfitter/tui-0mpqnyc1.js";
+import"../../shared/@outfitter/tui-2pwhzg55.js";
+import"../../shared/@outfitter/tui-hescagw2.js";
+export {
+  roundedTheme,
+  minimalTheme,
+  defaultTheme,
+  boldTheme
+};

package/dist/theme/presets/minimal.d.ts

@@ -0,0 +1,8 @@
+import { minimalTheme } from "../../shared/@outfitter/tui-sv2xmh3w";
+import "../../shared/@outfitter/tui-8j1gbehy";
+import "../../shared/@outfitter/tui-wfnnq0zq";
+import "../../shared/@outfitter/tui-3dyxg62j";
+import "../../shared/@outfitter/tui-9h1kdd98";
+import "../../shared/@outfitter/tui-c6ft5w6q";
+import "../../shared/@outfitter/tui-1qh888th";
+export { minimalTheme };

package/dist/theme/presets/minimal.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  minimalTheme
+} from "../../shared/@outfitter/tui-mch672g9.js";
+import"../../shared/@outfitter/tui-0mpqnyc1.js";
+import"../../shared/@outfitter/tui-2pwhzg55.js";
+import"../../shared/@outfitter/tui-hescagw2.js";
+export {
+  minimalTheme
+};

package/dist/theme/presets/rounded.d.ts

@@ -0,0 +1,8 @@
+import { roundedTheme } from "../../shared/@outfitter/tui-34q2aenf";
+import "../../shared/@outfitter/tui-8j1gbehy";
+import "../../shared/@outfitter/tui-wfnnq0zq";
+import "../../shared/@outfitter/tui-3dyxg62j";
+import "../../shared/@outfitter/tui-9h1kdd98";
+import "../../shared/@outfitter/tui-c6ft5w6q";
+import "../../shared/@outfitter/tui-1qh888th";
+export { roundedTheme };

package/dist/theme/presets/rounded.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  roundedTheme
+} from "../../shared/@outfitter/tui-esc46z2v.js";
+import"../../shared/@outfitter/tui-0mpqnyc1.js";
+import"../../shared/@outfitter/tui-2pwhzg55.js";
+import"../../shared/@outfitter/tui-hescagw2.js";
+export {
+  roundedTheme
+};

package/dist/theme/resolve.d.ts

@@ -0,0 +1,8 @@
+import { resolveGlyph, resolveStateMarker } from "../shared/@outfitter/tui-ajp1153q";
+import "../shared/@outfitter/tui-8j1gbehy";
+import "../shared/@outfitter/tui-wfnnq0zq";
+import "../shared/@outfitter/tui-3dyxg62j";
+import "../shared/@outfitter/tui-9h1kdd98";
+import "../shared/@outfitter/tui-c6ft5w6q";
+import "../shared/@outfitter/tui-1qh888th";
+export { resolveStateMarker, resolveGlyph };

package/dist/theme/resolve.js

@@ -0,0 +1,11 @@
+// @bun
+import {
+  resolveGlyph,
+  resolveStateMarker
+} from "../shared/@outfitter/tui-x9vvtfkk.js";
+import"../shared/@outfitter/tui-pdwbbzwr.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  resolveStateMarker,
+  resolveGlyph
+};

package/dist/theme/types.d.ts

@@ -0,0 +1,7 @@
+import { GlyphPair, MarkerSpec, PartialVisualTheme, SemanticState, ThemeColors, ThemeSpacing, VisualTheme } from "../shared/@outfitter/tui-8j1gbehy";
+import "../shared/@outfitter/tui-wfnnq0zq";
+import "../shared/@outfitter/tui-3dyxg62j";
+import "../shared/@outfitter/tui-9h1kdd98";
+import "../shared/@outfitter/tui-c6ft5w6q";
+import "../shared/@outfitter/tui-1qh888th";
+export { VisualTheme, ThemeSpacing, ThemeColors, SemanticState, PartialVisualTheme, MarkerSpec, GlyphPair };

package/dist/theme/types.js

@@ -0,0 +1 @@
+// @bun

package/dist/tree/index.d.ts

@@ -0,0 +1,3 @@
+import "../shared/@outfitter/tui-cjz6v74c";
+import { TREE_GUIDES, TreeGuideStyle, TreeOptions, renderTree } from "../shared/@outfitter/tui-3dyxg62j";
+export { renderTree, TreeOptions, TreeGuideStyle, TREE_GUIDES };

package/dist/tree/index.js

@@ -0,0 +1,11 @@
+// @bun
+import"../shared/@outfitter/tui-sk05ye6g.js";
+import {
+  TREE_GUIDES,
+  renderTree
+} from "../shared/@outfitter/tui-kydbggmj.js";
+import"../shared/@outfitter/tui-hescagw2.js";
+export {
+  renderTree,
+  TREE_GUIDES
+};