@evalops/maestro 0.10.51 → 0.10.53

package/dist/node_modules/@evalops/tui/dist/components/layout.d.ts

@@ -1,256 +0,0 @@
-/**
- * @fileoverview Layout Components for TUI (Flexbox-like Layout System)
- *
- * This module provides a set of layout primitives inspired by CSS Flexbox,
- * enabling complex terminal UI layouts with automatic sizing and alignment.
- *
- * ## Available Components
- *
- * - **Column**: Vertical stacking (like flex-direction: column)
- * - **Row**: Horizontal layout with weight-based distribution
- * - **Box**: Container with padding, margin, and optional borders
- *
- * ## Layout Algorithm Overview
- *
- * ### Row Layout (Horizontal)
- *
- * 1. Calculate total available width minus gaps
- * 2. Distribute width proportionally by weight
- * 3. Apply min/max constraints
- * 4. Handle overflow by wrapping to new lines (if enabled)
- * 5. Align children vertically within the row
- *
- * ### Box Layout
- *
- * ```
- * ┌─────────────────────────────┐
- * │         margin              │
- * │  ┌─────────────────────┐   │
- * │  │      padding        │   │
- * │  │  ┌───────────────┐  │   │
- * │  │  │    content    │  │   │
- * │  │  └───────────────┘  │   │
- * │  │      padding        │   │
- * │  └─────────────────────┘   │
- * │         margin              │
- * └─────────────────────────────┘
- * ```
- */
-import type { Component } from "../tui.js";
-import { Container } from "../tui.js";
-/**
- * Base options shared by all layout components.
- */
-export interface BaseLayoutOptions {
-    /** Spacing between child components (in lines/characters) */
-    gap?: number;
-}
-/**
- * Vertical layout container that stacks children from top to bottom.
- *
- * This is the simplest layout: each child gets the full available width
- * and children are rendered in order with optional gaps between them.
- *
- * @example
- * ```typescript
- * const layout = new Column([
- *   new Text("Header"),
- *   new Text("Content"),
- *   new Text("Footer"),
- * ], { gap: 1 });
- * ```
- */
-export declare class Column extends Container {
-    /** Number of blank lines between children */
-    private gap;
-    constructor(children?: Component[], opts?: BaseLayoutOptions);
-    /**
-     * Renders all children vertically with gaps.
-     *
-     * @param width - Available width for rendering
-     * @returns Array of rendered lines
-     */
-    render(width: number): string[];
-}
-/**
- * Configuration options for Row layout.
- */
-export interface RowOptions extends BaseLayoutOptions {
-    /** Weight values for proportional width distribution */
-    weights?: number[];
-    /** Minimum widths for each child (in characters) */
-    minWidths?: number[];
-    /** Maximum widths for each child (in characters) */
-    maxWidths?: number[];
-    /** Vertical alignment of children within the row */
-    align?: "start" | "center" | "end";
-    /** Horizontal distribution strategy */
-    justify?: "start" | "center" | "end" | "space-between";
-    /** Whether to wrap to multiple lines if children don't fit */
-    wrap?: boolean;
-}
-/**
- * Per-child layout options for fine-grained control.
- */
-export interface LayoutItemOptions {
-    /** Override row-level weight for this child */
-    weight?: number;
-    /** Override row-level minWidth for this child */
-    minWidth?: number;
-    /** Override row-level maxWidth for this child */
-    maxWidth?: number;
-    /** Override row-level align for this child */
-    alignSelf?: "start" | "center" | "end";
-}
-/**
- * Horizontal layout container with flexbox-like features.
- *
- * Width distribution algorithm:
- * 1. Subtract total gap space from available width
- * 2. Distribute remaining width proportionally by weight
- * 3. Apply min/max constraints, redistributing overflow
- * 4. If wrap is enabled and content overflows, create new rows
- *
- * @example
- * ```typescript
- * // Two columns with 2:1 ratio
- * const layout = new Row([sidebar, content], {
- *   weights: [1, 2],
- *   gap: 2,
- *   align: 'start',
- * });
- *
- * // Three equal columns with wrapping
- * const grid = new Row([a, b, c, d, e, f], {
- *   wrap: true,
- *   minWidths: [20, 20, 20, 20, 20, 20],
- * });
- * ```
- */
-export declare class Row extends Container {
-    /** Horizontal spacing between children */
-    private gap;
-    /** Weight values for proportional sizing */
-    private weights?;
-    /** Minimum width constraints */
-    private minWidths?;
-    /** Maximum width constraints */
-    private maxWidths?;
-    /** Vertical alignment within row */
-    private align;
-    /** Horizontal content distribution */
-    private justify;
-    /** Whether to wrap to multiple lines */
-    private wrap;
-    /** Per-child option overrides */
-    private childOptions;
-    constructor(children?: Component[], opts?: RowOptions);
-    /**
-     * Sets per-child layout options, overriding row-level defaults.
-     */
-    setChildOptions(child: Component, options: LayoutItemOptions): void;
-    /**
-     * Renders the row layout, handling wrapping if enabled.
-     *
-     * The algorithm:
-     * 1. Group children into logical lines based on available width
-     * 2. Each line is rendered independently with proper sizing
-     * 3. Lines are concatenated vertically
-     *
-     * @param width - Available width for the row
-     * @returns Array of rendered lines
-     */
-    render(width: number): string[];
-    /**
-     * Resolves weight values, defaulting to 1 for all children
-     * if weights aren't specified or array length mismatches.
-     */
-    private resolveWeights;
-    /**
-     * Gets effective layout options for a child, merging
-     * per-child overrides with row-level defaults.
-     */
-    private getChildOptions;
-    /**
-     * Gets the minimum width for a child (at least 1 character).
-     */
-    private getMinWidth;
-    /**
-     * Renders a single logical line of the row layout.
-     *
-     * This implements the core width distribution algorithm:
-     *
-     * 1. **Calculate available space**: total width minus gaps
-     * 2. **Proportional distribution**: divide by weight ratios
-     * 3. **Apply constraints**: clamp to min/max widths
-     * 4. **Handle remainder**: distribute leftover pixels evenly
-     * 5. **Render children**: each at its assigned width
-     * 6. **Vertical alignment**: pad shorter children
-     * 7. **Horizontal justification**: apply spacing strategy
-     *
-     * @param items - Children to render on this line
-     * @param width - Total available width
-     * @returns Array of rendered lines
-     */
-    private renderLine;
-}
-/**
- * Configuration options for Box layout.
- */
-export interface BoxOptions {
-    /** Horizontal padding inside the border (left and right) */
-    paddingX?: number;
-    /** Vertical padding inside the border (top and bottom) */
-    paddingY?: number;
-    /** Horizontal margin outside the border (left and right) */
-    marginX?: number;
-    /** Vertical margin outside the border (top and bottom) */
-    marginY?: number;
-    /** Border style: none, single (+|-), double (║═), or rounded (╭╮╰╯) */
-    border?: "none" | "single" | "double" | "rounded";
-    /** Spacing between child components */
-    gap?: number;
-}
-/**
- * Container component with padding, margin, and optional border.
- *
- * The Box provides a structured container for grouping content with
- * visual separation. It handles complex nesting of spacing layers:
- *
- * ```
- * ┌── full width ──────────────────────────┐
- * │                margin                   │
- * │  ┌─────────── innerWidth ──────────┐   │
- * │  │           border                │   │
- * │  │  ┌───── contentWidth ───────┐   │   │
- * │  │  │       padding            │   │   │
- * │  │  │  ┌─ paddedWidth ─────┐   │   │   │
- * │  │  │  │   children        │   │   │   │
- * │  │  │  └───────────────────┘   │   │   │
- * │  │  └──────────────────────────┘   │   │
- * │  └─────────────────────────────────┘   │
- * └────────────────────────────────────────┘
- * ```
- *
- * @example
- * ```typescript
- * const panel = new Box([content], {
- *   border: 'rounded',
- *   paddingX: 2,
- *   paddingY: 1,
- *   marginX: 1,
- * });
- * ```
- */
-export declare class Box extends Container {
-    private paddingX;
-    private paddingY;
-    private marginX;
-    private marginY;
-    private border;
-    private gap;
-    constructor(children?: Component[], options?: BoxOptions);
-    handleInput(data: string): void;
-    render(width: number): string[];
-}
-//# sourceMappingURL=layout.d.ts.map

package/dist/node_modules/@evalops/tui/dist/components/layout.d.ts.map

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