@valyrianjs/terminal 0.1.1 → 0.2.0

package/dist/render.js

@@ -1,6 +1,29 @@
-import { borderFrame, createFrame, cropFrame, fitFrame, getFrameHeight, getFrameWidth, mergeHorizontal, mergeVertical, padFrame, shiftFrame } from "./layout.js";
+import { constrainFrame, createFrame, cropFrame, fitFrame, getFrameHeight, getFrameWidth, mergeHorizontal, mergeVertical, overlayFrame, shiftFrame } from "./layout.js";
 import { getSelectionRange, normalizeInputState } from "./events.js";
-import { isFocusable, resolveRoot, textContent } from "./tree.js";
+import { createEditorState } from "./editor-state.js";
+import { isFocusable, textContent } from "./tree.js";
+import { renderValyrianTerminal } from "./runtime.js";
+import { plainText } from "./text.js";
+import { resolveTerminalStyle } from "./theme.js";
+function validateRenderContextDimension(name, value) {
+    if (!Number.isInteger(value) || value < 1) {
+        throw new RangeError(`Invalid render context ${name}: expected an integer >= 1`);
+    }
+    return value;
+}
+function validateRenderContext(context) {
+    if (typeof context === "undefined") {
+        return undefined;
+    }
+    return {
+        cols: validateRenderContextDimension("cols", context.cols),
+        rows: validateRenderContextDimension("rows", context.rows),
+        theme: context.theme
+    };
+}
+const VISUAL_STATE_ORDER = [
+    "disabled", "readonly", "loading", "empty", "muted", "error", "warning", "success", "invalid", "valid", "placeholder", "selection", "selected", "current", "expanded", "collapsed", "checked", "unchecked", "indeterminate", "editing", "submitted", "dragging", "dropTarget", "capturing", "focus", "hover", "pressed"
+];
 function numeric(value, fallback = 0) {
     const result = Number(value);
     return Number.isFinite(result) ? result : fallback;
@@ -14,35 +37,412 @@ function addFocusableHitbox(frame, node) {
     frame.hitboxes.unshift({ id: node.props.id, tag: node.tag, x1: 1, x2: width, y1: 1, y2: height });
     return frame;
 }
-function decorateContainerFrame(frame, node) {
+function positiveDimension(value, prop) {
+    if (typeof value === "undefined") {
+        return undefined;
+    }
+    const size = Number(value);
+    if (!Number.isFinite(size) || size <= 0) {
+        throw new RangeError(`${prop} must be greater than zero`);
+    }
+    return size;
+}
+function positiveInteger(value, prop) {
+    const size = Number(value);
+    if (!Number.isFinite(size) || !Number.isInteger(size) || size <= 0) {
+        throw new RangeError(`${prop} must be a positive finite integer`);
+    }
+    return size;
+}
+function nonNegativeInteger(value, prop) {
+    const size = typeof value === "undefined" ? 0 : Number(value);
+    if (!Number.isFinite(size) || !Number.isInteger(size) || size < 0) {
+        throw new RangeError(`${prop} must be a non-negative finite integer`);
+    }
+    return size;
+}
+function normalizeSpacing(value, prop) {
+    if (typeof value === "undefined")
+        return { top: 0, right: 0, bottom: 0, left: 0 };
+    if (typeof value === "number") {
+        const size = nonNegativeInteger(value, prop);
+        return { top: size, right: size, bottom: size, left: size };
+    }
+    const x = nonNegativeInteger(value.x, `${prop}.x`);
+    const y = nonNegativeInteger(value.y, `${prop}.y`);
+    return {
+        top: typeof value.top === "undefined" ? y : nonNegativeInteger(value.top, `${prop}.top`),
+        right: typeof value.right === "undefined" ? x : nonNegativeInteger(value.right, `${prop}.right`),
+        bottom: typeof value.bottom === "undefined" ? y : nonNegativeInteger(value.bottom, `${prop}.bottom`),
+        left: typeof value.left === "undefined" ? x : nonNegativeInteger(value.left, `${prop}.left`)
+    };
+}
+function normalizeBorder(value) {
+    if (value === true)
+        return { top: true, right: true, bottom: true, left: true, style: "solid" };
+    if (typeof value === "string")
+        return { top: true, right: true, bottom: true, left: true, style: value };
+    if (value && typeof value === "object") {
+        return { top: value.top === true, right: value.right === true, bottom: value.bottom === true, left: value.left === true, style: value.style || "solid", color: value.color };
+    }
+    return { top: false, right: false, bottom: false, left: false, style: "solid" };
+}
+function borderChars(style) {
+    if (style === "solid")
+        return { topLeft: "┌", topRight: "┐", bottomLeft: "└", bottomRight: "┘", horizontal: "─", vertical: "│" };
+    if (style === "dotted")
+        return { topLeft: "+", topRight: "+", bottomLeft: "+", bottomRight: "+", horizontal: "·", vertical: "⋮" };
+    if (style === "double")
+        return { topLeft: "╔", topRight: "╗", bottomLeft: "╚", bottomRight: "╝", horizontal: "═", vertical: "║" };
+    throw new RangeError(`Unknown terminal border style: ${style}`);
+}
+function mergeStyleDefinitions(base, next) {
+    return { ...base, ...next };
+}
+function styleSpan(kind, style) {
+    return typeof style === "undefined" ? { kind } : { kind, style };
+}
+const BASE_STYLE_KIND_BY_TAG = {
+    "terminal-button": "button.base",
+    "terminal-input": "input.base",
+    "terminal-editor": "editor.base",
+    "terminal-list": "list.base",
+    "terminal-scroll": "scroll.base",
+    "terminal-log-view": "log.base",
+    "terminal-overlay": "overlay.base"
+};
+function baseStyleKindForNode(node) {
+    return BASE_STYLE_KIND_BY_TAG[node.tag];
+}
+function nodeStates(node) {
+    const declared = Array.isArray(node.props.state) ? node.props.state : typeof node.props.state === "string" ? [node.props.state] : [];
+    const states = new Set();
+    for (const state of declared)
+        states.add(state);
+    if (node.props.disabled === true)
+        states.add("disabled");
+    if (node.props.pressed === true)
+        states.add("pressed");
+    if (node.props.__focused === true)
+        states.add("focus");
+    if (typeof node.props.__hoveredIndex === "number" || typeof node.props.__hoveredRow === "number")
+        states.add("hover");
+    if (Array.isArray(node.props.items) && node.props.items.length === 0)
+        states.add("empty");
+    if (Array.isArray(node.props.entries) && node.props.entries.length === 0)
+        states.add("empty");
+    return VISUAL_STATE_ORDER.filter((state) => states.has(state));
+}
+function resolveLayoutStyle(baseKind, node, context) {
+    return mergeStyleDefinitions(resolveTerminalStyle(baseKind, context?.theme), resolveTerminalStyle(node.props.style, context?.theme));
+}
+function resolveNodeLayoutStyle(node, context) {
+    return mergeStyleDefinitions(resolveTerminalStyle(baseStyleKindForNode(node), context?.theme), resolveTerminalStyle(node.props.style, context?.theme));
+}
+function decoratedControlFrame(content, style) {
+    const padding = normalizeSpacing(style?.padding, "Control padding");
+    const border = normalizeBorder(style?.border);
+    return addBorder(padFrameSides(createFrame(content), padding), border);
+}
+function fullFrameSpans(kinds, width, height) {
+    const spans = [];
+    for (const kind of kinds) {
+        for (let y = 1; y <= height; y += 1) {
+            spans.push({ kind, x1: 1, x2: width + 1, y });
+        }
+    }
+    return spans;
+}
+function resolveNodeStyle(node, context, options = {}) {
+    const baseKind = options.includeBase === false ? undefined : baseStyleKindForNode(node);
+    let style = resolveTerminalStyle(baseKind, context?.theme);
+    const spanKinds = typeof baseKind === "undefined" ? [] : [styleSpan(baseKind)];
+    const explicitStyle = resolveTerminalStyle(node.props.style, context?.theme);
+    if (typeof node.props.style === "string") {
+        spanKinds.push(styleSpan(node.props.style));
+    }
+    else if (explicitStyle) {
+        spanKinds.push(styleSpan("#style", explicitStyle));
+    }
+    style = mergeStyleDefinitions(style, explicitStyle);
+    for (const state of nodeStates(node)) {
+        const stateStyle = node.props.styles?.[state];
+        if (stateStyle) {
+            const resolvedStateStyle = resolveTerminalStyle(stateStyle, context?.theme);
+            style = mergeStyleDefinitions(style, resolvedStateStyle);
+            spanKinds.push(typeof stateStyle === "string" ? styleSpan(stateStyle) : styleSpan("#style", resolvedStateStyle));
+        }
+    }
+    return { style, spanKinds };
+}
+function padFrameSides(frame, padding) {
+    if (!padding.top && !padding.right && !padding.bottom && !padding.left)
+        return frame;
+    const width = Math.max(1, getFrameWidth(frame));
+    const contentWidth = width + padding.left + padding.right;
+    const topLines = new Array(padding.top).fill(" ".repeat(contentWidth));
+    const bottomLines = new Array(padding.bottom).fill(" ".repeat(contentWidth));
+    const lines = [
+        ...topLines,
+        ...frame.lines.map((line) => `${" ".repeat(padding.left)}${line.padEnd(width, " ")}${" ".repeat(padding.right)}`),
+        ...bottomLines
+    ];
+    return shiftFrame(createFrame(lines, frame.hitboxes, frame.cursor, frame.spans), padding.left, padding.top);
+}
+function addBorder(frame, border) {
+    if (!border.top && !border.right && !border.bottom && !border.left)
+        return frame;
+    const chars = borderChars(border.style);
+    const innerWidth = getFrameWidth(frame);
+    const left = border.left ? 1 : 0;
+    const right = border.right ? 1 : 0;
+    const width = innerWidth + left + right;
+    const lines = [];
+    if (border.top) {
+        lines.push(`${border.left ? chars.topLeft : chars.horizontal}${chars.horizontal.repeat(Math.max(0, width - left - right))}${border.right ? chars.topRight : chars.horizontal}`.slice(0, width));
+    }
+    for (const line of frame.lines) {
+        lines.push(`${border.left ? chars.vertical : ""}${line.padEnd(innerWidth, " ")}${border.right ? chars.vertical : ""}`);
+    }
+    if (border.bottom) {
+        lines.push(`${border.left ? chars.bottomLeft : chars.horizontal}${chars.horizontal.repeat(Math.max(0, width - left - right))}${border.right ? chars.bottomRight : chars.horizontal}`.slice(0, width));
+    }
+    return shiftFrame(createFrame(lines, frame.hitboxes, frame.cursor, frame.spans), left, border.top ? 1 : 0);
+}
+function containerDecorationSize(node, context) {
+    const layoutStyle = resolveNodeLayoutStyle(node, context);
+    const padding = normalizeSpacing(layoutStyle?.padding ?? node.props.padding, `${node.tag} padding`);
+    const border = normalizeBorder(layoutStyle?.border);
+    return {
+        horizontal: padding.left + padding.right + (border.left ? 1 : 0) + (border.right ? 1 : 0),
+        vertical: padding.top + padding.bottom + (border.top ? 1 : 0) + (border.bottom ? 1 : 0)
+    };
+}
+function addFullFrameSpans(frame, kinds) {
+    const width = Math.max(1, getFrameWidth(frame));
+    const height = getFrameHeight(frame);
+    if (width <= 0 || height <= 0 || kinds.length === 0)
+        return frame;
+    const spans = frame.spans.slice();
+    for (const span of kinds) {
+        for (let y = 1; y <= height; y += 1) {
+            spans.push({ ...span, x1: 1, x2: width + 1, y });
+        }
+    }
+    return createFrame(frame.lines, frame.hitboxes, frame.cursor, spans);
+}
+function listVirtualRange(node, itemCount, selectedIndex, context) {
+    if (!node.props.virtualized) {
+        return { start: 0, end: itemCount };
+    }
+    if (typeof node.props.itemHeight !== "undefined" && node.props.itemHeight !== 1) {
+        throw new RangeError("List itemHeight must be 1");
+    }
+    const overscan = nonNegativeInteger(node.props.overscan, "List overscan");
+    const viewportSourceRows = context?.rows ?? (itemCount || 1);
+    const viewportRows = Math.max(1, Math.min(itemCount || 1, positiveInteger(viewportSourceRows, "List viewport height")));
+    const selected = Math.max(0, Math.min(itemCount - 1, selectedIndex));
+    const visibleStart = Math.max(0, Math.min(selected, selected - viewportRows + 1));
+    const start = Math.max(0, visibleStart - overscan);
+    const end = Math.min(itemCount, visibleStart + viewportRows + overscan);
+    return { start, end };
+}
+function fixedPosition(value) {
+    if (value === "top" || value === "bottom" || value === "left" || value === "right") {
+        return value;
+    }
+    throw new RangeError("Fixed position must be top, bottom, left, or right");
+}
+function fillContextDimension(context, prop, label) {
+    if (!context) {
+        throw new RangeError(`${label} fill requires render context to resolve ${prop}`);
+    }
+    return positiveInteger(prop === "width" ? context.cols : context.rows, `${label} ${prop}`);
+}
+function resolveLayoutDimension(node, prop, label, context) {
+    const explicit = positiveDimension(node.props[prop], prop);
+    if (typeof explicit !== "undefined") {
+        return explicit;
+    }
+    if (node.props.fill === true) {
+        return fillContextDimension(context, prop, label);
+    }
+    return undefined;
+}
+function resolveLayoutDimensions(node, label, context) {
+    return {
+        width: resolveLayoutDimension(node, "width", label, context),
+        height: resolveLayoutDimension(node, "height", label, context)
+    };
+}
+function contextBackedDimension(context, prop, label) {
+    if (!context) {
+        return undefined;
+    }
+    return positiveInteger(prop === "width" ? context.cols : context.rows, `${label} ${prop}`);
+}
+function resolveBlockLayoutDimensions(node, label, context, options = {}) {
+    const explicitWidth = positiveDimension(node.props.width, "width");
+    const explicitHeight = positiveDimension(node.props.height, "height");
+    return {
+        width: typeof explicitWidth !== "undefined"
+            ? explicitWidth
+            : node.props.fill === true
+                ? fillContextDimension(context, "width", label)
+                : contextBackedDimension(context, "width", label),
+        height: typeof explicitHeight !== "undefined"
+            ? explicitHeight
+            : node.props.fill === true
+                ? fillContextDimension(context, "height", label)
+                : options.exactHeightFromContext === true
+                    ? contextBackedDimension(context, "height", label)
+                    : undefined
+    };
+}
+function resolveSplitDimension(node, prop, context) {
+    const explicit = positiveDimension(node.props[prop], prop);
+    if (typeof explicit !== "undefined") {
+        return explicit;
+    }
+    if (node.props.fill === true) {
+        return fillContextDimension(context, prop, "Split");
+    }
+    const fromContext = contextBackedDimension(context, prop, "Split");
+    if (typeof fromContext !== "undefined") {
+        return fromContext;
+    }
+    throw new RangeError("Split requires width/height or render context");
+}
+function decorateContainerFrame(frame, node, options = {}, context) {
     let next = frame;
-    next = fitFrame(next, numeric(node.props.width, 0), numeric(node.props.height, 0));
-    if (node.props.padding) {
-        next = padFrame(next, numeric(node.props.padding, 0));
+    const resolved = resolveNodeStyle(node, context);
+    const layoutStyle = resolveNodeLayoutStyle(node, context);
+    const padding = normalizeSpacing(layoutStyle?.padding ?? node.props.padding, `${node.tag} padding`);
+    const border = normalizeBorder(layoutStyle?.border);
+    const decoration = containerDecorationSize(node, context);
+    if (!options.constrain) {
+        next = fitFrame(next, numeric(options.width ?? node.props.width, 0), numeric(options.height ?? node.props.height, 0));
+    }
+    else if (node.tag === "terminal-pane" && (typeof node.props.width !== "undefined" || typeof node.props.height !== "undefined")) {
+        const width = typeof node.props.width === "undefined" || typeof options.width === "undefined" ? undefined : options.width - decoration.horizontal;
+        const height = typeof node.props.height === "undefined" || typeof options.height === "undefined" ? undefined : options.height - decoration.vertical;
+        if ((typeof width === "number" && width > 0) || (typeof height === "number" && height > 0)) {
+            next = constrainFrame(next, {
+                width: typeof width === "number" && width > 0 ? width : undefined,
+                height: typeof height === "number" && height > 0 ? height : undefined
+            });
+        }
     }
-    if (node.props.border) {
-        next = borderFrame(next);
+    next = padFrameSides(next, padding);
+    next = addBorder(next, border);
+    if (options.constrain) {
+        next = constrainFrame(next, {
+            width: typeof options.width === "undefined" ? positiveDimension(node.props.width, "width") : options.width,
+            height: typeof options.height === "undefined" ? positiveDimension(node.props.height, "height") : options.height
+        });
     }
+    next = addContainerStyleSpans(next, node, resolved);
     if (node.props.id && isFocusable(node)) {
         next = addFocusableHitbox(next, node);
     }
     return next;
 }
-function renderInputLine(value, inputState) {
+function addContainerStyleSpans(frame, node, resolved = resolveNodeStyle(node)) {
+    const width = getFrameWidth(frame);
+    const height = getFrameHeight(frame);
+    if (width <= 0 || height <= 0) {
+        return frame;
+    }
+    const spans = frame.spans.slice();
+    const containerSpans = resolved.spanKinds.slice();
+    const border = normalizeBorder(resolved.style?.border);
+    if (!resolved.style?.color && border.color) {
+        containerSpans.push(styleSpan("#style", { color: border.color }));
+    }
+    for (const span of containerSpans) {
+        for (let y = 1; y <= height; y += 1) {
+            spans.push({ ...span, x1: 1, x2: width + 1, y });
+        }
+    }
+    if (node.props.__focused && isFocusable(node)) {
+        for (let y = 1; y <= height; y += 1) {
+            spans.push({ kind: "focus", x1: 1, x2: width + 1, y });
+        }
+    }
+    return createFrame(frame.lines, frame.hitboxes, frame.cursor, spans);
+}
+function decoratedContentDimension(node, prop, outer, context) {
+    positiveInteger(outer, `Pane ${prop}`);
+    const decoration = containerDecorationSize(node, context);
+    const inner = outer - (prop === "width" ? decoration.horizontal : decoration.vertical);
+    if (!Number.isFinite(inner) || !Number.isInteger(inner) || inner <= 0) {
+        throw new RangeError(`Pane ${prop} leaves no room for Fixed content`);
+    }
+    return inner;
+}
+function resolveContainerChildContext(node, dimensions, context) {
+    if (typeof dimensions.width !== "number" && typeof dimensions.height !== "number") {
+        return context;
+    }
+    return {
+        cols: typeof dimensions.width === "number" ? decoratedContentDimension(node, "width", dimensions.width, context) : context?.cols ?? 1,
+        rows: typeof dimensions.height === "number" ? decoratedContentDimension(node, "height", dimensions.height, context) : context?.rows ?? 1,
+        theme: context?.theme
+    };
+}
+function renderInputLine(value, inputState, padding = { top: 0, right: 0, bottom: 0, left: 0 }) {
     const state = normalizeInputState(inputState, value.length);
     const { start, end } = getSelectionRange(state);
+    const line = `${value.slice(0, state.cursor)}|${value.slice(state.cursor)}`;
+    const paddedLine = `${" ".repeat(padding.left)}${line}${" ".repeat(padding.right)}`;
+    const textStart = padding.left + 1;
     return {
-        line: `> ${value.slice(0, state.cursor)}|${value.slice(state.cursor)}`,
-        cursor: { x: 3 + state.cursor, y: 1 },
-        spans: start === end ? [] : [{ kind: "selection", x1: 3 + start, x2: 3 + end, y: 1 }]
+        line: paddedLine,
+        cursor: { x: textStart + state.cursor, y: 1 },
+        spans: start === end ? [] : [{ kind: "input.selection", x1: textStart + start, x2: textStart + end, y: 1 }]
     };
 }
-function renderTableFrame(node) {
+function renderEditorFrame(node) {
+    const value = typeof node.props.value !== "undefined" ? plainText(node.props.value) : "";
+    const placeholder = typeof node.props.placeholder !== "undefined" ? plainText(node.props.placeholder) : "";
+    const displayValue = value.length === 0 && !node.props.__focused && placeholder ? placeholder : value;
+    const state = createEditorState(displayValue, node.props.__editorState?.cursor);
+    const focusedState = createEditorState(value, node.props.__editorState?.cursor);
+    const focusedLine = focusedState.cursor.line;
+    const focusedColumn = focusedState.cursor.column;
+    const lines = state.lines.map((line, index) => {
+        if (!node.props.__focused || index !== focusedLine) {
+            return `  ${line}`;
+        }
+        return `> ${line.slice(0, focusedColumn)}|${line.slice(focusedColumn)}`;
+    });
+    const width = lines.reduce((max, line) => Math.max(max, line.length), 0);
+    const cursor = node.props.__focused ? { x: 3 + focusedColumn, y: focusedLine + 1 } : null;
+    const spans = node.props.__focused ? [{ kind: "focus", x1: 1, x2: Math.max(2, lines[focusedLine].length + 1), y: focusedLine + 1 }] : [];
+    const height = typeof node.props.height === "undefined" ? undefined : positiveDimension(node.props.height, "height");
+    const frame = createFrame(lines, [], cursor, spans);
+    const scrollOffset = node.props.__focused && typeof height !== "undefined"
+        ? Math.min(Math.max(0, focusedLine - height + 1), Math.max(0, lines.length - height))
+        : 0;
+    const constrainedFrame = typeof height === "undefined"
+        ? frame
+        : constrainFrame(scrollOffset > 0 ? cropFrame(frame, scrollOffset, height) : frame, { height });
+    if (!node.props.id) {
+        return constrainedFrame;
+    }
+    return createFrame(constrainedFrame.lines, [{ id: node.props.id, tag: node.tag, x1: 1, x2: Math.max(1, getFrameWidth(constrainedFrame), width), y1: 1, y2: getFrameHeight(constrainedFrame), textStartX: 3, textLength: value.length }], constrainedFrame.cursor, constrainedFrame.spans);
+}
+function notifyLayoutContextProbe(node, context) {
+    if (context && typeof node.props.__layoutContextProbe === "function") {
+        node.props.__layoutContextProbe(context);
+    }
+}
+function renderTableFrame(node, context) {
     const rowNodes = node.children.filter((child) => child.type === "element");
     if (!rowNodes.length) {
         return createFrame([""]);
     }
-    const rowFrames = rowNodes.map((row) => row.children.map(renderTerminalFrame));
+    const rowFrames = rowNodes.map((row) => row.children.map((child) => renderTerminalFrame(child, context)));
     const columnCount = rowFrames.reduce((max, row) => Math.max(max, row.length), 0);
     const columnWidths = new Array(columnCount).fill(0);
     for (const row of rowFrames) {
@@ -82,6 +482,407 @@ function renderTableFrame(node) {
     }
     return createFrame(lines, hitboxes, cursor, spans);
 }
+function resolveSplitBreakpoint(node, width, height) {
+    const breakpoints = Array.isArray(node.props.breakpoints) ? node.props.breakpoints : [];
+    for (const breakpoint of breakpoints) {
+        if (typeof breakpoint.maxCols === "number" && width > breakpoint.maxCols)
+            continue;
+        if (typeof breakpoint.maxRows === "number" && height > breakpoint.maxRows)
+            continue;
+        return breakpoint;
+    }
+    return undefined;
+}
+function parseSplitSize(value, index) {
+    if (typeof value === "number") {
+        return { type: "absolute", value: positiveInteger(value, `Split sizes[${index}]`) };
+    }
+    if (typeof value !== "string") {
+        throw new RangeError(`Split sizes[${index}] must be a number, percent, or fr value`);
+    }
+    const percent = value.match(/^([+-]?\d+(?:\.\d+)?)%$/);
+    if (percent) {
+        const amount = Number(percent[1]);
+        if (!Number.isFinite(amount) || amount <= 0)
+            throw new RangeError(`Split sizes[${index}] percent must be greater than zero`);
+        return { type: "percent", value: amount };
+    }
+    const fraction = value.match(/^([+-]?\d+(?:\.\d+)?)fr$/);
+    if (fraction) {
+        const amount = Number(fraction[1]);
+        if (!Number.isFinite(amount) || amount <= 0)
+            throw new RangeError(`Split sizes[${index}] fr must be greater than zero`);
+        return { type: "fr", value: amount };
+    }
+    throw new RangeError(`Invalid Split sizes[${index}]: ${value}`);
+}
+function allocateDecimals(ideals, total) {
+    const sizes = ideals.map((value) => Math.floor(value));
+    let remainder = total - sizes.reduce((sum, value) => sum + value, 0);
+    const order = ideals.map((value, index) => ({ index, fraction: value - Math.floor(value) }))
+        .sort((a, b) => b.fraction - a.fraction || a.index - b.index);
+    for (let index = 0; index < order.length && remainder > 0; index += 1) {
+        sizes[order[index].index] += 1;
+        remainder -= 1;
+    }
+    return sizes;
+}
+function resolveSplitSizes(sizesInput, childCount, available) {
+    if (!Array.isArray(sizesInput)) {
+        const base = Math.floor(available / childCount);
+        const remainder = available % childCount;
+        const sizes = new Array(childCount);
+        for (let index = 0; index < childCount; index += 1)
+            sizes[index] = base + (index < remainder ? 1 : 0);
+        return sizes;
+    }
+    if (sizesInput.length !== childCount)
+        throw new RangeError("Split sizes length must match child count");
+    const parsed = sizesInput.map(parseSplitSize);
+    const percentTotal = parsed.reduce((sum, size) => sum + (size.type === "percent" ? size.value : 0), 0);
+    if (percentTotal > 100)
+        throw new RangeError("Split percentage sizes must not exceed 100%");
+    const ideals = new Array(childCount).fill(0);
+    let absoluteUsed = 0;
+    for (let index = 0; index < parsed.length; index += 1) {
+        const size = parsed[index];
+        if (size.type === "absolute") {
+            ideals[index] = size.value;
+            absoluteUsed += size.value;
+        }
+        else if (size.type === "percent") {
+            ideals[index] = available * (size.value / 100);
+        }
+    }
+    const percentUsed = ideals.reduce((sum, value, index) => sum + (parsed[index].type === "percent" ? value : 0), 0);
+    const remaining = available - absoluteUsed - percentUsed;
+    if (remaining < -0.000001)
+        throw new RangeError("Split sizes plus gaps must fit within the major axis");
+    const frTotal = parsed.reduce((sum, size) => sum + (size.type === "fr" ? size.value : 0), 0);
+    for (let index = 0; index < parsed.length; index += 1) {
+        const size = parsed[index];
+        if (size.type === "fr")
+            ideals[index] = frTotal > 0 ? remaining * (size.value / frTotal) : 0;
+    }
+    const allocationTotal = frTotal > 0 ? available : Math.round(ideals.reduce((sum, value) => sum + value, 0));
+    const allocated = allocateDecimals(ideals, allocationTotal);
+    if (allocated.reduce((sum, size) => sum + size, 0) > available)
+        throw new RangeError("Split sizes plus gaps must fit within the major axis");
+    return allocated;
+}
+function isDirectSplitLayoutContainer(node) {
+    return node.type === "element" && (node.tag === "terminal-pane" || node.tag === "terminal-box" || node.tag === "terminal-view" || node.tag === "terminal-scroll");
+}
+function renderSplitChildFrame(child, cellWidth, cellHeight, context) {
+    const childContext = { cols: cellWidth, rows: cellHeight, theme: context?.theme };
+    if (!isDirectSplitLayoutContainer(child)) {
+        return renderTerminalFrame(child, childContext);
+    }
+    const props = { ...child.props };
+    if (typeof props.width === "undefined" && props.fill !== true) {
+        props.width = cellWidth;
+    }
+    if (typeof props.height === "undefined" && props.fill !== true) {
+        props.height = cellHeight;
+    }
+    return renderTerminalFrame({ ...child, props }, childContext);
+}
+function renderSplitFrame(node, context) {
+    const width = resolveSplitDimension(node, "width", context);
+    const height = resolveSplitDimension(node, "height", context);
+    const breakpoint = resolveSplitBreakpoint(node, width, height);
+    const gap = nonNegativeInteger(breakpoint?.gap ?? node.props.gap, "Split gap");
+    const direction = (breakpoint?.direction ?? node.props.direction) === "column" ? "column" : "row";
+    const childCount = node.children.length;
+    if (!childCount) {
+        const frame = createFrame(new Array(height).fill(" ".repeat(width)));
+        return node.props.id && isFocusable(node) ? addFocusableHitbox(frame, node) : frame;
+    }
+    const majorSize = direction === "row" ? width : height;
+    const available = majorSize - gap * (childCount - 1);
+    if (available < 0) {
+        throw new RangeError("Split gap leaves insufficient space for children");
+    }
+    const sizes = resolveSplitSizes(breakpoint?.sizes ?? node.props.sizes, childCount, available);
+    const frames = [];
+    for (let index = 0; index < childCount; index += 1) {
+        const cellWidth = direction === "row" ? sizes[index] : width;
+        const cellHeight = direction === "row" ? height : sizes[index];
+        if (cellWidth <= 0 || cellHeight <= 0) {
+            continue;
+        }
+        frames.push(constrainFrame(renderSplitChildFrame(node.children[index], cellWidth, cellHeight, context), { width: cellWidth, height: cellHeight }));
+    }
+    const frame = frames.length
+        ? direction === "row" ? mergeHorizontal(frames, { gap }) : mergeVertical(frames, { gap })
+        : createFrame(new Array(height).fill(" ".repeat(width)));
+    const constrained = constrainFrame(frame, { width, height });
+    return node.props.id && isFocusable(node) ? addFocusableHitbox(constrained, node) : constrained;
+}
+function hasDirectFixedChildren(node) {
+    return node.children.some((child) => child.type === "element" && child.tag === "terminal-fixed");
+}
+function hasDirectOverlayChildren(node) {
+    return node.children.some((child) => child.type === "element" && child.tag === "terminal-overlay");
+}
+function splitOverlayChildren(children) {
+    const baseChildren = [];
+    const overlays = [];
+    for (const child of children) {
+        if (child.type === "element" && child.tag === "terminal-overlay") {
+            overlays.push(child);
+        }
+        else {
+            baseChildren.push(child);
+        }
+    }
+    return { baseChildren, overlays };
+}
+function renderBodyFrame(children, props, context) {
+    const direction = props.direction === "row" ? "row" : "column";
+    const gap = numeric(props.gap, 0);
+    const frames = children.map((child) => renderTerminalFrame(child, context));
+    return direction === "row" ? mergeHorizontal(frames, { gap }) : mergeVertical(frames, { gap });
+}
+function renderFixedChildFrame(node, width, height) {
+    return constrainFrame(renderBodyFrame(node.children, {}, { cols: width, rows: height }), { width, height });
+}
+function renderFixedCompositionFrame(node, width, height) {
+    if (!Number.isFinite(width) || !Number.isInteger(width) || width <= 0 || !Number.isFinite(height) || !Number.isInteger(height) || height <= 0) {
+        throw new RangeError("Fixed composition requires exact positive parent dimensions");
+    }
+    const fixedNodes = { top: [], bottom: [], left: [], right: [] };
+    const bodyChildren = [];
+    for (const child of node.children) {
+        if (child.type === "element" && child.tag === "terminal-fixed") {
+            fixedNodes[fixedPosition(child.props.position)].push(child);
+        }
+        else if (child.type === "element" && child.tag === "terminal-overlay") {
+            continue;
+        }
+        else {
+            bodyChildren.push(child);
+        }
+    }
+    const topSize = fixedNodes.top.reduce((total, fixed) => total + positiveInteger(fixed.props.size, "Fixed size"), 0);
+    const bottomSize = fixedNodes.bottom.reduce((total, fixed) => total + positiveInteger(fixed.props.size, "Fixed size"), 0);
+    const middleHeight = height - topSize - bottomSize;
+    if (middleHeight < 0) {
+        throw new RangeError("Fixed top and bottom regions exceed parent height");
+    }
+    const leftSize = fixedNodes.left.reduce((total, fixed) => total + positiveInteger(fixed.props.size, "Fixed size"), 0);
+    const rightSize = fixedNodes.right.reduce((total, fixed) => total + positiveInteger(fixed.props.size, "Fixed size"), 0);
+    const bodyWidth = width - leftSize - rightSize;
+    if (bodyWidth < 0) {
+        throw new RangeError("Fixed left and right regions exceed parent width");
+    }
+    const topFrames = fixedNodes.top.map((fixed) => renderFixedChildFrame(fixed, width, positiveInteger(fixed.props.size, "Fixed size")));
+    const bottomFrames = fixedNodes.bottom.map((fixed) => renderFixedChildFrame(fixed, width, positiveInteger(fixed.props.size, "Fixed size")));
+    const middleFrames = [];
+    if (middleHeight > 0) {
+        const leftFrames = fixedNodes.left.map((fixed) => renderFixedChildFrame(fixed, positiveInteger(fixed.props.size, "Fixed size"), middleHeight));
+        const rightFrames = fixedNodes.right.map((fixed) => renderFixedChildFrame(fixed, positiveInteger(fixed.props.size, "Fixed size"), middleHeight));
+        const bodyFrames = bodyWidth > 0
+            ? [constrainFrame(renderBodyFrame(bodyChildren, node.props, { cols: bodyWidth, rows: middleHeight }), { width: bodyWidth, height: middleHeight })]
+            : [];
+        middleFrames.push(constrainFrame(mergeHorizontal([...leftFrames, ...bodyFrames, ...rightFrames]), { width, height: middleHeight }));
+    }
+    const frame = mergeVertical([...topFrames, ...middleFrames, ...bottomFrames]);
+    return constrainFrame(frame, { width, height });
+}
+function renderStandaloneFixedFrame(node, context) {
+    const position = fixedPosition(node.props.position);
+    const size = positiveInteger(node.props.size, "Fixed size");
+    const frame = renderBodyFrame(node.children, {}, context);
+    return position === "top" || position === "bottom"
+        ? constrainFrame(frame, { height: size })
+        : constrainFrame(frame, { width: size });
+}
+function overlayMarginValue(value, axisSize, label) {
+    if (typeof value === "number") {
+        if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+            throw new RangeError(`${label} must be a non-negative finite integer or percentage string`);
+        }
+        return value;
+    }
+    if (typeof value === "string") {
+        const match = value.match(/^(\d+(?:\.\d+)?)%$/);
+        if (!match) {
+            throw new RangeError(`${label} must be a non-negative finite integer or percentage string`);
+        }
+        const percent = Number(match[1]);
+        if (!Number.isFinite(percent) || percent < 0) {
+            throw new RangeError(`${label} must be a non-negative finite integer or percentage string`);
+        }
+        return Math.round(axisSize * percent / 100);
+    }
+    throw new RangeError(`${label} must be a non-negative finite integer or percentage string`);
+}
+function overlayMargins(margin, width, height) {
+    if (typeof margin === "number" || typeof margin === "string") {
+        const x = overlayMarginValue(margin, width, "Overlay margin");
+        const y = overlayMarginValue(margin, height, "Overlay margin");
+        return { x, y };
+    }
+    if (margin && typeof margin === "object" && !Array.isArray(margin)) {
+        const axes = margin;
+        return {
+            x: overlayMarginValue(axes.x, width, "Overlay margin x"),
+            y: overlayMarginValue(axes.y, height, "Overlay margin y")
+        };
+    }
+    throw new RangeError("Overlay margin is required");
+}
+function overlayGeometry(node, width, height) {
+    const margin = overlayMargins(node.props.margin, width, height);
+    const overlayWidth = width - margin.x * 2;
+    const overlayHeight = height - margin.y * 2;
+    if (overlayWidth < 1 || overlayHeight < 1) {
+        throw new RangeError("Overlay margin leaves no renderable area");
+    }
+    return {
+        x: margin.x + 1,
+        y: margin.y + 1,
+        width: overlayWidth,
+        height: overlayHeight
+    };
+}
+function renderOverlayChildFrame(node, width, height, context) {
+    const geometry = overlayGeometry(node, width, height);
+    let frame = constrainFrame(renderBodyFrame(node.children, {}, { cols: geometry.width, rows: geometry.height, theme: context?.theme }), { width: geometry.width, height: geometry.height });
+    frame = addContainerStyleSpans(frame, node, resolveNodeStyle(node, context));
+    if (node.props.id && isFocusable(node)) {
+        frame = addFocusableHitbox(frame, node);
+    }
+    return { frame, geometry };
+}
+function applyDirectOverlays(base, overlays, context) {
+    let frame = base;
+    const width = Math.max(1, getFrameWidth(base));
+    const height = Math.max(1, getFrameHeight(base));
+    for (const overlay of overlays) {
+        const rendered = renderOverlayChildFrame(overlay, width, height, context);
+        frame = overlayFrame(frame, rendered.frame, rendered.geometry);
+    }
+    return frame;
+}
+function renderScreenFrame(node, context) {
+    const { baseChildren, overlays } = splitOverlayChildren(node.children);
+    let base;
+    if (hasDirectFixedChildren(node)) {
+        if (!context) {
+            throw new RangeError("Screen with direct Fixed children requires exact render context dimensions");
+        }
+        if (node.props.title) {
+            const title = constrainFrame(createFrame([plainText(node.props.title)]), { width: context.cols, height: 1 });
+            const remainingRows = context.rows - 1;
+            base = remainingRows > 0
+                ? constrainFrame(mergeVertical([title, renderFixedCompositionFrame(node, context.cols, remainingRows)]), { width: context.cols, height: context.rows })
+                : constrainFrame(title, { width: context.cols, height: context.rows });
+        }
+        else {
+            base = renderFixedCompositionFrame(node, context.cols, context.rows);
+        }
+    }
+    else {
+        const parts = [];
+        if (node.props.title) {
+            parts.push(createFrame([plainText(node.props.title)]));
+        }
+        const childContext = context && node.props.title
+            ? { cols: context.cols, rows: context.rows - 1, theme: context.theme }
+            : context;
+        if (!context || !node.props.title || context.rows > 1) {
+            parts.push(...baseChildren.map((child) => renderTerminalFrame(child, childContext)));
+        }
+        base = mergeVertical(parts);
+        if (context && overlays.length) {
+            base = constrainFrame(base, { width: context.cols, height: context.rows });
+        }
+    }
+    return overlays.length ? applyDirectOverlays(base, overlays, context) : base;
+}
+function renderPaneFrame(node, context) {
+    const { baseChildren, overlays } = splitOverlayChildren(node.children);
+    const dimensions = resolveBlockLayoutDimensions(node, "Pane", context, { exactHeightFromContext: hasDirectFixedChildren(node) });
+    let frame;
+    if (hasDirectFixedChildren(node)) {
+        const width = decoratedContentDimension(node, "width", dimensions.width ?? positiveInteger(node.props.width, "Pane width"), context);
+        const height = decoratedContentDimension(node, "height", dimensions.height ?? positiveInteger(node.props.height, "Pane height"), context);
+        frame = renderFixedCompositionFrame(node, width, height);
+        frame = decorateContainerFrame(frame, node, { constrain: true, ...dimensions }, context);
+    }
+    else {
+        const childContext = resolveContainerChildContext(node, dimensions, context);
+        frame = renderBodyFrame(baseChildren, node.props, childContext);
+        frame = decorateContainerFrame(frame, node, { constrain: true, ...dimensions }, context);
+    }
+    return overlays.length ? applyDirectOverlays(frame, overlays, context) : frame;
+}
+function renderStandaloneOverlayFrame(node, context) {
+    if (!context) {
+        throw new RangeError("Standalone Overlay requires exact render context dimensions");
+    }
+    const rendered = renderOverlayChildFrame(node, context.cols, context.rows, context);
+    return rendered.frame;
+}
+function renderLogViewFrame(node, context) {
+    const dimensions = resolveLayoutDimensions(node, "LogView", context);
+    const entries = Array.isArray(node.props.entries) ? node.props.entries : [];
+    const lines = [];
+    if (entries.length === 0) {
+        lines.push(plainText(node.props.emptyText ?? ""));
+    }
+    else {
+        for (let index = 0; index < entries.length; index += 1) {
+            const entry = entries[index];
+            const value = typeof node.props.renderEntry === "function"
+                ? node.props.renderEntry(entry, index)
+                : entry?.content ?? "";
+            lines.push(...plainText(value).split("\n"));
+        }
+    }
+    const resolved = resolveNodeStyle(node, context);
+    const layoutStyle = resolveNodeLayoutStyle(node, context);
+    const padding = normalizeSpacing(layoutStyle?.padding ?? node.props.padding, "LogView padding");
+    const border = normalizeBorder(layoutStyle?.border);
+    const horizontalDecoration = padding.left + padding.right + (border.left ? 1 : 0) + (border.right ? 1 : 0);
+    const verticalDecoration = padding.top + padding.bottom + (border.top ? 1 : 0) + (border.bottom ? 1 : 0);
+    const innerWidth = typeof dimensions.width === "undefined" ? undefined : dimensions.width - horizontalDecoration;
+    const innerHeight = typeof dimensions.height === "undefined" ? undefined : dimensions.height - verticalDecoration;
+    let frame = createFrame(lines);
+    if ((typeof innerWidth === "number" && innerWidth <= 0) || (typeof innerHeight === "number" && innerHeight <= 0)) {
+        frame = createFrame([""]);
+    }
+    else {
+        if (typeof innerHeight !== "undefined") {
+            const offset = node.props.followTail === true ? Math.max(0, getFrameHeight(frame) - innerHeight) : 0;
+            frame = cropFrame(frame, offset, innerHeight);
+            while (getFrameHeight(frame) < innerHeight) {
+                frame = createFrame([...frame.lines, ""], frame.hitboxes, frame.cursor, frame.spans);
+            }
+        }
+        if (typeof innerWidth !== "undefined") {
+            frame = constrainFrame(frame, { width: innerWidth, height: innerHeight });
+        }
+    }
+    frame = padFrameSides(frame, padding);
+    frame = addBorder(frame, border);
+    if (typeof dimensions.width !== "undefined") {
+        frame = constrainFrame(frame, { width: dimensions.width, height: dimensions.height });
+    }
+    else if (typeof dimensions.height !== "undefined") {
+        frame = cropFrame(frame, 0, dimensions.height);
+        while (typeof dimensions.height !== "undefined" && getFrameHeight(frame) < dimensions.height) {
+            frame = createFrame([...frame.lines, ""], frame.hitboxes, frame.cursor, frame.spans);
+        }
+    }
+    frame = addContainerStyleSpans(frame, node, resolved);
+    if (node.props.id && isFocusable(node)) {
+        frame = addFocusableHitbox(frame, node);
+    }
+    return frame;
+}
 function renderSeparatedRowFrame(frames, separator = " | ") {
     if (!frames.length) {
         return createFrame([""]);
@@ -112,28 +913,33 @@ function renderSeparatedRowFrame(frames, separator = " | ") {
     }
     return createFrame(lines, hitboxes, cursor, spans);
 }
-function renderElementFrame(node) {
+function renderElementFrame(node, context) {
+    notifyLayoutContextProbe(node, context);
     switch (node.tag) {
         case "terminal-screen": {
-            const parts = [];
-            if (node.props.title) {
-                parts.push(createFrame([String(node.props.title)]));
-            }
-            parts.push(...node.children.map(renderTerminalFrame));
-            return mergeVertical(parts);
+            return renderScreenFrame(node, context);
         }
         case "terminal-box":
         case "terminal-view":
+        case "terminal-pane":
         case "terminal-scroll": {
-            const direction = node.props.direction === "row" ? "row" : "column";
-            const gap = numeric(node.props.gap, 0);
-            let frame = direction === "row"
-                ? mergeHorizontal(node.children.map(renderTerminalFrame), { gap })
-                : mergeVertical(node.children.map(renderTerminalFrame), { gap });
-            frame = decorateContainerFrame(frame, node);
+            let frame;
+            if (node.tag === "terminal-pane" && (hasDirectFixedChildren(node) || hasDirectOverlayChildren(node))) {
+                return renderPaneFrame(node, context);
+            }
+            const label = node.tag === "terminal-box" ? "Box" : node.tag === "terminal-view" ? "View" : node.tag === "terminal-scroll" ? "ScrollView" : "Pane";
+            const dimensions = node.tag === "terminal-scroll"
+                ? resolveLayoutDimensions(node, label, context)
+                : resolveBlockLayoutDimensions(node, label, context);
+            const childContext = resolveContainerChildContext(node, dimensions, context);
+            frame = renderBodyFrame(node.children, node.props, childContext);
+            frame = decorateContainerFrame(frame, node, { constrain: node.tag === "terminal-box" || node.tag === "terminal-view" || node.tag === "terminal-pane", ...dimensions }, context);
             if (node.tag === "terminal-scroll") {
                 const offset = numeric(node.props.__scrollOffset, 0);
-                const height = numeric(node.props.height, getFrameHeight(frame));
+                if (typeof dimensions.width !== "undefined") {
+                    frame = constrainFrame(frame, { width: dimensions.width });
+                }
+                const height = numeric(dimensions.height ?? node.props.height, getFrameHeight(frame));
                 frame = cropFrame(frame, offset, height || getFrameHeight(frame));
                 const highlightRows = Array.isArray(node.props.highlightRows) ? node.props.highlightRows.map((value) => Number(value)) : [];
                 const hoveredRow = typeof node.props.__hoveredRow === "number" ? Number(node.props.__hoveredRow) : -1;
@@ -152,77 +958,126 @@ function renderElementFrame(node) {
             }
             return frame;
         }
+        case "terminal-split":
+            return renderSplitFrame(node, context);
+        case "terminal-fixed":
+            return renderStandaloneFixedFrame(node, context);
+        case "terminal-overlay":
+            return renderStandaloneOverlayFrame(node, context);
+        case "terminal-log-view":
+            return renderLogViewFrame(node, context);
         case "terminal-list": {
             const items = Array.isArray(node.props.items) ? node.props.items : [];
             const selectedIndex = numeric(node.props.__selectedIndex, 0);
             const hoveredIndex = typeof node.props.__hoveredIndex === "number" ? Number(node.props.__hoveredIndex) : -1;
-            const lines = items.map((item, index) => {
-                const label = typeof node.props.renderItem === "function" ? String(node.props.renderItem(item, index)) : String(item);
-                return index === selectedIndex ? `> ${label}` : `  ${label}`;
-            });
+            const range = listVirtualRange(node, items.length, selectedIndex, context);
+            const lines = [];
+            for (let index = range.start; index < range.end; index += 1) {
+                const item = items[index];
+                const label = typeof node.props.renderItem === "function" ? plainText(node.props.renderItem(item, index)) : plainText(item);
+                lines.push(label);
+            }
+            const visibleLines = lines.length ? lines : [""];
+            const layoutStyle = resolveLayoutStyle("list.base", node, context);
+            const padding = normalizeSpacing(layoutStyle.padding, "List padding");
+            const border = normalizeBorder(layoutStyle.border);
+            const decorated = addBorder(padFrameSides(createFrame(visibleLines), padding), border);
+            const width = Math.max(1, getFrameWidth(decorated));
+            const height = Math.max(1, getFrameHeight(decorated));
+            const itemY = 1 + (border.top ? 1 : 0) + padding.top;
             const spans = [];
-            for (let index = 0; index < lines.length; index += 1) {
-                const width = lines[index].length + 1;
-                if (index === selectedIndex) {
-                    spans.push({ kind: "current-row", x1: 1, x2: width, y: index + 1 });
+            for (let index = 0; index < visibleLines.length; index += 1) {
+                const sourceIndex = range.start + index;
+                const y = itemY + index;
+                spans.push({ kind: "list.base", x1: 1, x2: width + 1, y });
+                if (sourceIndex === selectedIndex) {
+                    spans.push({ kind: "list.current", x1: 1, x2: width + 1, y });
                 }
-                if (index === hoveredIndex) {
-                    spans.push({ kind: "hover", x1: 1, x2: width, y: index + 1 });
+                if (sourceIndex === hoveredIndex) {
+                    spans.push({ kind: "list.hover", x1: 1, x2: width + 1, y });
                 }
             }
-            const frame = createFrame(lines.length ? lines : [""], [], null, spans);
-            return node.props.id ? addFocusableHitbox(frame, node) : frame;
+            const frame = createFrame(decorated.lines, [], decorated.cursor, spans);
+            const styled = addFullFrameSpans(frame, resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
+            if (!node.props.id) {
+                return styled;
+            }
+            return createFrame(styled.lines, [{ id: node.props.id, tag: node.tag, x1: 1, x2: width, y1: 1, y2: height, itemOffset: range.start }], styled.cursor, styled.spans);
         }
         case "terminal-table":
-            return renderTableFrame(node);
+            return renderTableFrame(node, context);
         case "terminal-row":
-            return renderSeparatedRowFrame(node.children.map(renderTerminalFrame), String(node.props.separator || " | "));
+            return renderSeparatedRowFrame(node.children.map((child) => renderTerminalFrame(child, context)), plainText(node.props.separator || " | "));
         case "terminal-td": {
-            const frame = mergeVertical(node.children.map(renderTerminalFrame));
-            return node.props.padding ? padFrame(frame, numeric(node.props.padding, 0)) : frame;
+            const frame = mergeVertical(node.children.map((child) => renderTerminalFrame(child, context)));
+            const resolved = resolveNodeStyle(node, context);
+            const layoutStyle = resolveNodeLayoutStyle(node, context);
+            const padding = normalizeSpacing(layoutStyle?.padding ?? node.props.padding, "Td padding");
+            const border = normalizeBorder(layoutStyle?.border);
+            return addFullFrameSpans(addBorder(padFrameSides(frame, padding), border), resolved.spanKinds);
         }
         case "terminal-text": {
-            const value = typeof node.props.value !== "undefined" ? String(node.props.value) : node.children.map(textContent).join("");
-            return createFrame(value.split("\n"));
+            const value = typeof node.props.value !== "undefined" ? plainText(node.props.value) : plainText(node.children.map(textContent).join(""));
+            const frame = createFrame(value.split("\n"));
+            return addFullFrameSpans(frame, resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
         }
         case "terminal-input": {
             const value = typeof node.props.value !== "undefined" ? node.props.value : node.props.placeholder || "";
-            const stringValue = String(value);
+            const stringValue = plainText(value);
             const displayValue = !node.props.__focused && stringValue.length === 0 && typeof node.props.placeholder !== "undefined"
-                ? String(node.props.placeholder)
+                ? plainText(node.props.placeholder)
                 : stringValue;
+            const layoutStyle = resolveLayoutStyle("input.base", node, context);
+            const inputPadding = normalizeSpacing(layoutStyle.padding, "Input padding");
+            const inputBorder = normalizeBorder(layoutStyle.border);
+            const textStartX = (inputBorder.left ? 1 : 0) + inputPadding.left + 1;
             if (!node.props.__focused) {
-                const line = `  ${displayValue}`;
-                const hitboxes = node.props.id ? [{ id: node.props.id, tag: node.tag, x1: 1, x2: Math.max(2, line.length), y1: 1, y2: 1, textStartX: 3, textLength: stringValue.length }] : [];
-                return createFrame([line], hitboxes, null, []);
+                const line = `${" ".repeat(inputPadding.left)}${displayValue}${" ".repeat(inputPadding.right)}`;
+                const decorated = addBorder(createFrame([line]), inputBorder);
+                const width = Math.max(1, getFrameWidth(decorated));
+                const height = Math.max(1, getFrameHeight(decorated));
+                const hitboxes = node.props.id ? [{ id: node.props.id, tag: node.tag, x1: 1, x2: width, y1: 1, y2: height, textStartX, textLength: stringValue.length }] : [];
+                const spans = fullFrameSpans(["input.base"], width, height);
+                return addFullFrameSpans(createFrame(decorated.lines, hitboxes, decorated.cursor, spans), resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
             }
-            const rendered = renderInputLine(stringValue, node.props.__inputState || { cursor: stringValue.length, anchor: stringValue.length });
-            const hitboxes = node.props.id ? [{ id: node.props.id, tag: node.tag, x1: 1, x2: Math.max(2, stringValue.length + 2), y1: 1, y2: 1, textStartX: 3, textLength: stringValue.length }] : [];
-            return createFrame([rendered.line], hitboxes, rendered.cursor, rendered.spans);
+            const rendered = renderInputLine(stringValue, node.props.__inputState || { cursor: stringValue.length, anchor: stringValue.length }, inputPadding);
+            const decorated = addBorder(createFrame([rendered.line], [], rendered.cursor, rendered.spans), inputBorder);
+            const width = Math.max(1, getFrameWidth(decorated));
+            const height = Math.max(1, getFrameHeight(decorated));
+            const hitboxes = node.props.id ? [{ id: node.props.id, tag: node.tag, x1: 1, x2: width, y1: 1, y2: height, textStartX, textLength: stringValue.length }] : [];
+            const spans = [...fullFrameSpans(["input.base", "input.focus"], width, height), ...decorated.spans];
+            return addFullFrameSpans(createFrame(decorated.lines, hitboxes, decorated.cursor, spans), resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
         }
+        case "terminal-editor":
+            return addFullFrameSpans(renderEditorFrame(node), resolveNodeStyle(node, context).spanKinds);
         case "terminal-button": {
-            const label = typeof node.props.label !== "undefined" ? node.props.label : node.children.map(textContent).join("");
-            const line = node.props.__focused ? `[> ${String(label)} <]` : `[ ${String(label)} ]`;
-            const hitboxes = node.props.id ? [{ id: node.props.id, tag: node.tag, x1: 1, x2: Math.max(1, line.length), y1: 1, y2: 1 }] : [];
-            const spans = node.props.__focused ? [{ kind: "focus", x1: 4, x2: 4 + String(label).length, y: 1 }] : [];
-            return createFrame([line], hitboxes, null, spans);
+            const label = typeof node.props.label !== "undefined" ? plainText(node.props.label) : plainText(node.children.map(textContent).join(""));
+            const layoutStyle = resolveLayoutStyle("button.base", node, context);
+            const decorated = decoratedControlFrame([String(label)], layoutStyle);
+            const width = Math.max(1, getFrameWidth(decorated));
+            const height = Math.max(1, getFrameHeight(decorated));
+            const hitboxes = node.props.id ? [{ id: node.props.id, tag: node.tag, x1: 1, x2: width, y1: 1, y2: height }] : [];
+            const kinds = ["button.base", ...nodeStates(node).map((state) => `button.${state}`)];
+            const spans = fullFrameSpans(kinds, width, height);
+            return addFullFrameSpans(createFrame(decorated.lines, hitboxes, decorated.cursor, spans), resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
         }
         default:
-            return mergeVertical(node.children.map(renderTerminalFrame));
+            return mergeVertical(node.children.map((child) => renderTerminalFrame(child, context)));
     }
 }
-export function renderTerminalFrame(node) {
+export function renderTerminalFrame(node, context) {
     if (node.type === "text") {
-        return createFrame([node.value]);
+        return createFrame([plainText(node.value)]);
     }
-    return renderElementFrame(node);
+    return renderElementFrame(node, context);
 }
-export function renderTerminalNode(node) {
-    return renderTerminalFrame(node).lines.join("\n");
+export function renderTerminalNode(node, context) {
+    return renderTerminalFrame(node, context).lines.join("\n");
 }
-export function renderTerminal(input) {
-    return resolveRoot(input)
-        .map(renderTerminalNode)
+export function renderTerminal(input, context) {
+    const renderContext = validateRenderContext(context);
+    return renderValyrianTerminal(input)
+        .map((node) => renderTerminalNode(node, renderContext))
         .filter(Boolean)
         .join("\n")
         .trimEnd();