@runa-cmd/help 0.1.0

package/dist/ansi/downsample.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @runa-cmd/help — Public API
+ *
+ * Barrel re-exports for the Runa help system.
+ * Layout primitives are independent and usable standalone.
+ */
+export { bold, dim, fg, italic, reset, strip, underline, visibleWidth } from './ansi/codes.js';
+export { detectColorDepth, detectTermWidth, getRenderContext, resetRenderContext, } from './ansi/detect.js';
+export { downsampleColor } from './ansi/downsample.js';
+export { helpPlugin } from './plugin.js';
+export type { BorderStyle, BoxOptions } from './primitives/box.js';
+export { box } from './primitives/box.js';
+export type { ColumnsOptions } from './primitives/columns.js';
+export { columns } from './primitives/columns.js';
+export type { HorizontalAlign, HorizontalJoinOptions, VerticalJoinOptions, } from './primitives/join.js';
+export { join } from './primitives/join.js';
+export type { ListOptions } from './primitives/list.js';
+export { list } from './primitives/list.js';
+export type { StyledOptions } from './primitives/styled.js';
+export { styled } from './primitives/styled.js';
+export type { TableOptions } from './primitives/table.js';
+export { table } from './primitives/table.js';
+export { defaultRenderer } from './render.js';
+export { defaultTheme, resolveTheme } from './theme.js';
+export type { Block, ColorDepth, HelpPluginOptions, RenderContext, RenderFnCtx, ResolvedTheme, Theme, } from './types.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":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,YAAY,EACX,eAAe,EACf,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGxD,YAAY,EACX,KAAK,EACL,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,aAAa,EACb,KAAK,GACL,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * @runa-cmd/help — Public API
+ *
+ * Barrel re-exports for the Runa help system.
+ * Layout primitives are independent and usable standalone.
+ */
+// ─── ANSI utilities ─────────────────────────────────────────
+export { bold, dim, fg, italic, reset, strip, underline, visibleWidth } from './ansi/codes.js';
+export { detectColorDepth, detectTermWidth, getRenderContext, resetRenderContext, } from './ansi/detect.js';
+export { downsampleColor } from './ansi/downsample.js';
+// ─── Plugin ─────────────────────────────────────────────────
+export { helpPlugin } from './plugin.js';
+// ─── Layout Primitives ──────────────────────────────────────
+export { box } from './primitives/box.js';
+export { columns } from './primitives/columns.js';
+export { join } from './primitives/join.js';
+export { list } from './primitives/list.js';
+export { styled } from './primitives/styled.js';
+export { table } from './primitives/table.js';
+// ─── Theme + Renderer ───────────────────────────────────────
+export { defaultRenderer } from './render.js';
+export { defaultTheme, resolveTheme } from './theme.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":"AAAA;;;;;GAKG;AAEH,+DAA+D;AAC/D,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,+DAA+D;AAC/D,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAMlD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,+DAA+D;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @runa-cmd/help — helpPlugin()
+ *
+ * A Runa plugin that adds --help/-h as a global option and renders
+ * help output when the flag is detected. Supports 3 layers:
+ * - Layer 1: Zero-config (beautiful help out of the box)
+ * - Layer 2: Theme customization (custom colors)
+ * - Layer 3: Custom render function (full control)
+ */
+import type { PluginConfig } from '@runa-cmd/core';
+import type { HelpPluginOptions } from './types.js';
+/**
+ * Create a help plugin that intercepts --help/-h and renders help output.
+ *
+ * @param opts - Optional theme or custom render function
+ */
+export declare function helpPlugin(opts?: HelpPluginOptions): PluginConfig;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAyC,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,YAAY,CAyCrE"}

package/dist/plugin.js

@@ -0,0 +1,63 @@
+import { definePlugin } from '@runa-cmd/core';
+import { z } from 'zod';
+import { getRenderContext } from './ansi/detect.js';
+import { defaultRenderer } from './render.js';
+import { resolveTheme } from './theme.js';
+/**
+ * Create a help plugin that intercepts --help/-h and renders help output.
+ *
+ * @param opts - Optional theme or custom render function
+ */
+export function helpPlugin(opts = {}) {
+    return definePlugin({
+        meta: {
+            name: '@runa-cmd/help',
+            version: '0.1.0',
+            description: 'Built-in help system with layout primitives and theming',
+        },
+        capabilities: { addGlobalOptions: true },
+        setup(api) {
+            // Add --help, -h as a global boolean option
+            api.addGlobalOption('help', z.boolean().optional().default(false).describe('Show help'), {
+                alias: ['-h'],
+            });
+            // Intercept via onGlobalFlags hook
+            api.hook('onGlobalFlags', (ctx) => {
+                if (!ctx.globalOptions?.help)
+                    return;
+                const schema = api.getSchema();
+                const renderCtx = getRenderContext();
+                const theme = resolveTheme(opts.theme, renderCtx);
+                // Detect active subcommand from rawArgs positionals
+                const target = resolveTarget(schema, ctx.rawArgs);
+                const renderer = opts.render ?? defaultRenderer;
+                const output = renderer({
+                    schema: target,
+                    theme,
+                    colorDepth: renderCtx.colorDepth,
+                    termWidth: renderCtx.termWidth,
+                });
+                process.stdout.write(`${output}\n`);
+                // Stop further lifecycle execution
+                ctx.shortCircuit?.();
+                process.exit(0);
+            });
+        },
+    });
+}
+// ─── Internal Helpers ───────────────────────────────────────
+/**
+ * Find the target schema for help rendering.
+ * Looks at rawArgs positionals to find a matching subcommand.
+ * Falls back to the root CLI schema if no match.
+ */
+function resolveTarget(schema, rawArgs) {
+    // Find first positional arg (not a flag)
+    const subName = rawArgs.find((a) => !a.startsWith('-'));
+    if (!subName)
+        return schema;
+    // Search top-level commands
+    const match = schema.commands.find((cmd) => cmd.name === subName);
+    return match ?? schema;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B,EAAE;IACtD,OAAO,YAAY,CAAC;QACnB,IAAI,EAAE;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,yDAAyD;SACtE;QACD,YAAY,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE;QACxC,KAAK,CAAC,GAAG;YACR,4CAA4C;YAC5C,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;gBACxF,KAAK,EAAE,CAAC,IAAI,CAAC;aACb,CAAC,CAAC;YAEH,mCAAmC;YACnC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,GAAgB,EAAE,EAAE;gBAC9C,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI;oBAAE,OAAO;gBAErC,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;gBAC/B,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAElD,oDAAoD;gBACpD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBAElD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC;gBAChD,MAAM,MAAM,GAAG,QAAQ,CAAC;oBACvB,MAAM,EAAE,MAAM;oBACd,KAAK;oBACL,UAAU,EAAE,SAAS,CAAC,UAAU;oBAChC,SAAS,EAAE,SAAS,CAAC,SAAS;iBAC9B,CAAC,CAAC;gBAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;gBAEpC,mCAAmC;gBACnC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC;QACJ,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED,+DAA+D;AAE/D;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAiB,EAAE,OAAiB;IAC1D,yCAAyC;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAE5B,4BAA4B;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAClE,OAAO,KAAK,IAAI,MAAM,CAAC;AACxB,CAAC"}

package/dist/primitives/box.d.ts

@@ -0,0 +1,23 @@
+import type { Block, RenderContext } from '../types.js';
+export type BorderStyle = 'single' | 'double' | 'rounded' | 'none';
+/** Options for box() */
+export interface BoxOptions {
+    /** Content string to place inside the box */
+    content: string;
+    /** Border style (default: 'single') */
+    border?: BorderStyle;
+    /** Border color — hex or named (default: none) */
+    borderColor?: string;
+    /** Inner padding [vertical, horizontal] or [top, right, bottom, left] (default: [0, 1]) */
+    padding?: [number, number] | [number, number, number, number];
+    /** Fixed width (auto-fit to content if omitted) */
+    width?: number;
+}
+/**
+ * Render a bordered box with optional padding and color.
+ *
+ * @param opts - Box options
+ * @param ctx - Optional RenderContext override
+ */
+export declare function box(opts: BoxOptions, ctx?: RenderContext): Block;
+//# sourceMappingURL=box.d.ts.map

package/dist/primitives/box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../src/primitives/box.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKxD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAkBnE,wBAAwB;AACxB,MAAM,WAAW,UAAU;IAC1B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,KAAK,CAmDhE"}

package/dist/primitives/box.js

@@ -0,0 +1,76 @@
+/**
+ * @runa-cmd/help — box() primitive
+ *
+ * Renders a bordered container with configurable border style,
+ * border color, padding, and optional width constraint.
+ * Content is word-wrapped to fit within the box.
+ */
+import { reset } from '../ansi/codes.js';
+import { getRenderContext } from '../ansi/detect.js';
+import { downsampleColor } from '../ansi/downsample.js';
+import { wrapText } from './wrap.js';
+const BORDERS = {
+    single: { tl: '┌', tr: '┐', bl: '└', br: '┘', h: '─', v: '│' },
+    double: { tl: '╔', tr: '╗', bl: '╚', br: '╝', h: '═', v: '║' },
+    rounded: { tl: '╭', tr: '╮', bl: '╰', br: '╯', h: '─', v: '│' },
+    none: { tl: ' ', tr: ' ', bl: ' ', br: ' ', h: ' ', v: ' ' },
+};
+/**
+ * Render a bordered box with optional padding and color.
+ *
+ * @param opts - Box options
+ * @param ctx - Optional RenderContext override
+ */
+export function box(opts, ctx) {
+    const renderCtx = ctx ?? getRenderContext();
+    const border = opts.border ?? 'single';
+    const chars = BORDERS[border];
+    const [padTop, padRight, padBottom, padLeft] = normalizePadding(opts.padding ?? [0, 1]);
+    // Determine inner width
+    const borderWidth = 2; // left + right border chars
+    const hPadding = padLeft + padRight;
+    let innerWidth;
+    if (opts.width) {
+        innerWidth = opts.width - borderWidth - hPadding;
+        if (innerWidth < 1)
+            innerWidth = 1;
+    }
+    else {
+        // Auto-fit: find longest content line
+        const rawLines = opts.content.split('\n');
+        const maxContentWidth = rawLines.reduce((max, line) => Math.max(max, line.length), 0);
+        innerWidth = maxContentWidth;
+    }
+    // Word-wrap content to inner width
+    const wrappedLines = wrapText(opts.content, innerWidth);
+    // Pad each content line to full inner width
+    const contentLines = wrappedLines.map((line) => `${' '.repeat(padLeft)}${line.padEnd(innerWidth)}${' '.repeat(padRight)}`);
+    // Add vertical padding lines
+    const totalInner = innerWidth + hPadding;
+    const emptyLine = ' '.repeat(totalInner);
+    const topPadLines = Array.from({ length: padTop }, () => emptyLine);
+    const bottomPadLines = Array.from({ length: padBottom }, () => emptyLine);
+    const allContentLines = [...topPadLines, ...contentLines, ...bottomPadLines];
+    // Resolve border color
+    let colorAnsi = '';
+    let colorReset = '';
+    if (opts.borderColor) {
+        colorAnsi = downsampleColor(opts.borderColor, renderCtx.colorDepth);
+        if (colorAnsi)
+            colorReset = reset;
+    }
+    // Assemble the box
+    const bc = (ch) => (colorAnsi ? `${colorAnsi}${ch}${colorReset}` : ch);
+    const topBorder = `${bc(chars.tl)}${bc(chars.h.repeat(totalInner))}${bc(chars.tr)}`;
+    const bottomBorder = `${bc(chars.bl)}${bc(chars.h.repeat(totalInner))}${bc(chars.br)}`;
+    const bodyLines = allContentLines.map((line) => `${bc(chars.v)}${line}${bc(chars.v)}`);
+    return [topBorder, ...bodyLines, bottomBorder].join('\n');
+}
+// ─── Internal Helpers ───────────────────────────────────────
+function normalizePadding(padding) {
+    if (padding.length === 4)
+        return padding;
+    const [v, h] = padding;
+    return [v, h, v, h];
+}
+//# sourceMappingURL=box.js.map

package/dist/primitives/box.js.map

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

package/dist/primitives/columns.d.ts

@@ -0,0 +1,15 @@
+import type { Block, RenderContext } from '../types.js';
+/** Options for columns() */
+export interface ColumnsOptions {
+    /** Gap between columns in spaces (default: 2) */
+    gap?: number;
+}
+/**
+ * Render blocks as evenly-spaced columns across terminal width.
+ *
+ * @param blocks - Array of content blocks
+ * @param opts - Column options
+ * @param ctx - Optional RenderContext override
+ */
+export declare function columns(blocks: Block[], opts?: ColumnsOptions, ctx?: RenderContext): Block;
+//# sourceMappingURL=columns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/primitives/columns.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIxD,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC9B,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,GAAE,cAAmB,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,KAAK,CAsB9F"}

package/dist/primitives/columns.js

@@ -0,0 +1,37 @@
+/**
+ * @runa-cmd/help — columns() primitive
+ *
+ * Distributes blocks evenly across terminal width with auto-calculated
+ * column widths and word-wrapping per column.
+ */
+import { getRenderContext } from '../ansi/detect.js';
+import { join } from './join.js';
+import { wrapText } from './wrap.js';
+/**
+ * Render blocks as evenly-spaced columns across terminal width.
+ *
+ * @param blocks - Array of content blocks
+ * @param opts - Column options
+ * @param ctx - Optional RenderContext override
+ */
+export function columns(blocks, opts = {}, ctx) {
+    const renderCtx = ctx ?? getRenderContext();
+    const gap = opts.gap ?? 2;
+    const numCols = blocks.length;
+    if (numCols === 0)
+        return '';
+    if (numCols === 1)
+        return blocks[0];
+    // Calculate column width: (termWidth - gaps) / numCols
+    const totalGaps = gap * (numCols - 1);
+    const colWidth = Math.floor((renderCtx.termWidth - totalGaps) / numCols);
+    if (colWidth < 1) {
+        // Terminal too narrow for multi-column — stack vertically
+        return join.vertical(blocks, { gap: 1 });
+    }
+    // Word-wrap each block to column width
+    const wrappedBlocks = blocks.map((block) => wrapText(block, colWidth).join('\n'));
+    // Use horizontal join to place side-by-side
+    return join.horizontal(wrappedBlocks, { gap, align: 'top' });
+}
+//# sourceMappingURL=columns.js.map

package/dist/primitives/columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","sourceRoot":"","sources":["../../src/primitives/columns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAQrC;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,MAAe,EAAE,OAAuB,EAAE,EAAE,GAAmB;IACtF,MAAM,SAAS,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IAE9B,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAEpC,uDAAuD;IACvD,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC;IAEzE,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAClB,0DAA0D;QAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,uCAAuC;IACvC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAElF,4CAA4C;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/primitives/join.d.ts

@@ -0,0 +1,32 @@
+import type { Block } from '../types.js';
+export interface VerticalJoinOptions {
+    /** Number of blank lines between blocks (default: 0) */
+    gap?: number;
+}
+/**
+ * Stack blocks top-to-bottom.
+ *
+ * @param blocks - Array of Blocks to stack
+ * @param opts - Options (gap between blocks)
+ */
+declare function vertical(blocks: Block[], opts?: VerticalJoinOptions): Block;
+export type HorizontalAlign = 'top' | 'center' | 'bottom';
+export interface HorizontalJoinOptions {
+    /** Space between columns (default: 1) */
+    gap?: number;
+    /** Vertical alignment of blocks (default: 'top') */
+    align?: HorizontalAlign;
+}
+/**
+ * Place blocks side-by-side with alignment.
+ *
+ * @param blocks - Array of Blocks to place horizontally
+ * @param opts - Options (gap, alignment)
+ */
+declare function horizontal(blocks: Block[], opts?: HorizontalJoinOptions): Block;
+export declare const join: {
+    readonly vertical: typeof vertical;
+    readonly horizontal: typeof horizontal;
+};
+export {};
+//# sourceMappingURL=join.d.ts.map

package/dist/primitives/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../src/primitives/join.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,WAAW,mBAAmB;IACnC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,GAAE,mBAAwB,GAAG,KAAK,CAIxE;AAID,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACrC,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,CAAC,EAAE,eAAe,CAAC;CACxB;AAED;;;;;GAKG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,GAAE,qBAA0B,GAAG,KAAK,CA0C5E;AAID,eAAO,MAAM,IAAI;;;CAGP,CAAC"}

package/dist/primitives/join.js

@@ -0,0 +1,89 @@
+/**
+ * @runa-cmd/help — join primitive
+ *
+ * Compose blocks vertically (stacked) or horizontally (side-by-side).
+ * Returns a Block (string).
+ */
+import { visibleWidth } from '../ansi/codes.js';
+/**
+ * Stack blocks top-to-bottom.
+ *
+ * @param blocks - Array of Blocks to stack
+ * @param opts - Options (gap between blocks)
+ */
+function vertical(blocks, opts = {}) {
+    const gap = opts.gap ?? 0;
+    const separator = '\n'.repeat(gap + 1);
+    return blocks.filter((b) => b !== '').join(separator);
+}
+/**
+ * Place blocks side-by-side with alignment.
+ *
+ * @param blocks - Array of Blocks to place horizontally
+ * @param opts - Options (gap, alignment)
+ */
+function horizontal(blocks, opts = {}) {
+    const gap = opts.gap ?? 1;
+    const align = opts.align ?? 'top';
+    if (blocks.length === 0)
+        return '';
+    if (blocks.length === 1)
+        return blocks[0];
+    // Split each block into lines
+    const blockLines = blocks.map((b) => b.split('\n'));
+    // Find max height
+    const maxHeight = blockLines.reduce((max, lines) => Math.max(max, lines.length), 0);
+    // Find the visible width of each block (max across its lines)
+    const blockWidths = blockLines.map((lines) => lines.reduce((max, line) => Math.max(max, visibleWidth(line)), 0));
+    // Pad each block to maxHeight according to alignment
+    const paddedBlocks = blockLines.map((lines) => padToHeight(lines, maxHeight, align));
+    // Zip line-by-line
+    const separator = ' '.repeat(gap);
+    const resultLines = [];
+    for (let row = 0; row < maxHeight; row++) {
+        const parts = [];
+        for (let col = 0; col < paddedBlocks.length; col++) {
+            const line = paddedBlocks[col][row] ?? '';
+            if (col < paddedBlocks.length - 1) {
+                // Pad line to block width so columns align
+                const padded = line + ' '.repeat(Math.max(0, blockWidths[col] - visibleWidth(line)));
+                parts.push(padded);
+            }
+            else {
+                // Last column — no trailing padding
+                parts.push(line);
+            }
+        }
+        resultLines.push(parts.join(separator));
+    }
+    return resultLines.join('\n');
+}
+// ─── Public API ─────────────────────────────────────────────
+export const join = {
+    vertical,
+    horizontal,
+};
+// ─── Internal Helpers ───────────────────────────────────────
+function padToHeight(lines, maxHeight, align) {
+    const padCount = maxHeight - lines.length;
+    if (padCount === 0)
+        return lines;
+    const emptyLine = '';
+    const padLines = Array.from({ length: padCount }, () => emptyLine);
+    switch (align) {
+        case 'top':
+            return [...lines, ...padLines];
+        case 'bottom':
+            return [...padLines, ...lines];
+        case 'center': {
+            const topPad = Math.floor(padCount / 2);
+            const bottomPad = padCount - topPad;
+            return [
+                ...Array.from({ length: topPad }, () => emptyLine),
+                ...lines,
+                ...Array.from({ length: bottomPad }, () => emptyLine),
+            ];
+        }
+    }
+}
+//# sourceMappingURL=join.js.map

package/dist/primitives/join.js.map

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

package/dist/primitives/list.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @runa-cmd/help — list() primitive
+ *
+ * Renders a bulleted list with configurable bullet and indent.
+ * Handles multi-line items with continuation line alignment.
+ */
+import type { Block } from '../types.js';
+/** Options for list() */
+export interface ListOptions {
+    /** Bullet character (default: '•') */
+    bullet?: string;
+    /** Left indent in spaces (default: 2) */
+    indent?: number;
+}
+/**
+ * Render a bulleted list.
+ *
+ * @param items - Array of items (may contain newlines for multi-line items)
+ * @param opts - List options
+ */
+export declare function list(items: string[], opts?: ListOptions): Block;
+//# sourceMappingURL=list.d.ts.map

package/dist/primitives/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/primitives/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,yBAAyB;AACzB,MAAM,WAAW,WAAW;IAC3B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,KAAK,CAqBnE"}

package/dist/primitives/list.js

@@ -0,0 +1,25 @@
+/**
+ * Render a bulleted list.
+ *
+ * @param items - Array of items (may contain newlines for multi-line items)
+ * @param opts - List options
+ */
+export function list(items, opts = {}) {
+    const bullet = opts.bullet ?? '•';
+    const indent = opts.indent ?? 2;
+    const indentStr = ' '.repeat(indent);
+    // Continuation lines align after "bullet " (bullet + 1 space)
+    const continuationIndent = ' '.repeat(indent + bullet.length + 1);
+    const resultLines = [];
+    for (const item of items) {
+        const lines = item.split('\n');
+        // First line: indent + bullet + space + text
+        resultLines.push(`${indentStr}${bullet} ${lines[0]}`);
+        // Continuation lines: aligned after bullet
+        for (let i = 1; i < lines.length; i++) {
+            resultLines.push(`${continuationIndent}${lines[i]}`);
+        }
+    }
+    return resultLines.join('\n');
+}
+//# sourceMappingURL=list.js.map

package/dist/primitives/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/primitives/list.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,KAAe,EAAE,OAAoB,EAAE;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAEhC,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,8DAA8D;IAC9D,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAElE,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,6CAA6C;QAC7C,WAAW,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtD,2CAA2C;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,WAAW,CAAC,IAAI,CAAC,GAAG,kBAAkB,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACF,CAAC;IAED,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/primitives/styled.d.ts

@@ -0,0 +1,28 @@
+import type { Block, RenderContext } from '../types.js';
+/** Options for styled() */
+export interface StyledOptions {
+    /** Apply bold */
+    bold?: boolean;
+    /** Apply dim */
+    dim?: boolean;
+    /** Apply italic */
+    italic?: boolean;
+    /** Apply underline */
+    underline?: boolean;
+    /** Foreground color — hex (#RRGGBB) or named ANSI ('red', 'dim', etc.) */
+    color?: string;
+    /**
+     * Padding as spaces.
+     * [vertical, horizontal] or [top, right, bottom, left]
+     */
+    padding?: [number, number] | [number, number, number, number];
+}
+/**
+ * Apply text styles, color, and padding.
+ *
+ * @param text - The text to style
+ * @param opts - Styling options
+ * @param ctx - Optional RenderContext override (uses lazy singleton if omitted)
+ */
+export declare function styled(text: string, opts?: StyledOptions, ctx?: RenderContext): Block;
+//# sourceMappingURL=styled.d.ts.map

package/dist/primitives/styled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styled.d.ts","sourceRoot":"","sources":["../../src/primitives/styled.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExD,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC7B,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gBAAgB;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9D;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,KAAK,CAoCzF"}

package/dist/primitives/styled.js

@@ -0,0 +1,59 @@
+/**
+ * @runa-cmd/help — styled() primitive
+ *
+ * Apply text styles (bold, dim, italic, underline), foreground color, and padding.
+ * Returns a Block (string). Does NOT word-wrap — that's the caller's responsibility.
+ */
+import { bold, dim, fg, italic, underline } from '../ansi/codes.js';
+import { getRenderContext } from '../ansi/detect.js';
+import { downsampleColor } from '../ansi/downsample.js';
+/**
+ * Apply text styles, color, and padding.
+ *
+ * @param text - The text to style
+ * @param opts - Styling options
+ * @param ctx - Optional RenderContext override (uses lazy singleton if omitted)
+ */
+export function styled(text, opts = {}, ctx) {
+    const renderCtx = ctx ?? getRenderContext();
+    let result = text;
+    // Apply color first (innermost)
+    if (opts.color) {
+        const ansiColor = downsampleColor(opts.color, renderCtx.colorDepth);
+        result = fg(result, ansiColor);
+    }
+    // Apply styles in consistent order: bold → dim → italic → underline
+    if (opts.bold)
+        result = bold(result);
+    if (opts.dim)
+        result = dim(result);
+    if (opts.italic)
+        result = italic(result);
+    if (opts.underline)
+        result = underline(result);
+    // Apply padding
+    if (opts.padding) {
+        const [top, right, bottom, left] = normalizePadding(opts.padding);
+        const hPad = ' '.repeat(left);
+        const hPadRight = ' '.repeat(right);
+        // Split into lines to apply padding per-line
+        const lines = result.split('\n');
+        const paddedLines = lines.map((line) => `${hPad}${line}${hPadRight}`);
+        // Add vertical padding (empty lines of same width)
+        const lineWidth = hPad.length + hPadRight.length;
+        const emptyLine = ' '.repeat(lineWidth);
+        const topLines = Array.from({ length: top }, () => emptyLine);
+        const bottomLines = Array.from({ length: bottom }, () => emptyLine);
+        result = [...topLines, ...paddedLines, ...bottomLines].join('\n');
+    }
+    return result;
+}
+// ─── Internal Helpers ───────────────────────────────────────
+function normalizePadding(padding) {
+    if (padding.length === 4) {
+        return padding;
+    }
+    const [v, h] = padding;
+    return [v, h, v, h];
+}
+//# sourceMappingURL=styled.js.map

package/dist/primitives/styled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styled.js","sourceRoot":"","sources":["../../src/primitives/styled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAsBxD;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,OAAsB,EAAE,EAAE,GAAmB;IACjF,MAAM,SAAS,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC5C,IAAI,MAAM,GAAG,IAAI,CAAC;IAElB,gCAAgC;IAChC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;QACpE,MAAM,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,oEAAoE;IACpE,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,GAAG;QAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,SAAS;QAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAE/C,gBAAgB;IAChB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEpC,6CAA6C;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC,CAAC;QAEtE,mDAAmD;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QACjD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9D,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAEpE,MAAM,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED,+DAA+D;AAE/D,SAAS,gBAAgB,CACxB,OAA4D;IAE5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC;IACvB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC"}