@visulima/tui 1.0.0-alpha.1 → 1.0.0-alpha.10

package/dist/ink/styles.d.ts

@@ -1,369 +0,0 @@
-import type { AnsiColors } from "@visulima/colorize";
-import type { Boxes, BoxStyle } from "cli-boxes";
-import type { LiteralUnion } from "type-fest";
-import type { Node as YogaNode } from "yoga-layout";
-export type Styles = {
-    /**
-     * It defines the alignment along the cross axis when there are multiple lines of flex items (when using flex-wrap).
-     * See [align-content](https://css-tricks.com/almanac/properties/a/align-content/).
-     */
-    readonly alignContent?: "flex-start" | "flex-end" | "center" | "stretch" | "space-between" | "space-around" | "space-evenly";
-    /**
-     * The align-items property defines the default behavior for how items are laid out along the cross axis (perpendicular to the main axis).
-     * See [align-items](https://css-tricks.com/almanac/properties/a/align-items/).
-     */
-    readonly alignItems?: "flex-start" | "center" | "flex-end" | "stretch" | "baseline";
-    /**
-     * It makes possible to override the align-items value for specific flex items.
-     * See [align-self](https://css-tricks.com/almanac/properties/a/align-self/).
-     */
-    readonly alignSelf?: "flex-start" | "center" | "flex-end" | "auto" | "stretch" | "baseline";
-    /**
-     * Defines the aspect ratio (width/height) for the element.
-     *
-     * Use it with at least one size constraint (`width`, `height`, `minHeight`, or `maxHeight`) so Ink can derive the missing dimension.
-     */
-    readonly aspectRatio?: number;
-    /**
-     * Background color for the element.
-     *
-     * Accepts the same values as `color` in the `<Text>` component.
-     */
-    readonly backgroundColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Change border background color. A shorthand for setting `borderTopBackgroundColor`, `borderRightBackgroundColor`, `borderBottomBackgroundColor`, and `borderLeftBackgroundColor`.
-     */
-    readonly borderBackgroundColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Determines whether the bottom border is visible.
-     * @default true
-     */
-    readonly borderBottom?: boolean;
-    /**
-     * Change the bottom border background color. Accepts the same values as `backgroundColor` in `Text` component.
-     */
-    readonly borderBottomBackgroundColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Change the bottom border color. Accepts the same values as `color` in `Text` component.
-     */
-    readonly borderBottomColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Dim the bottom border color.
-     * @default false
-     */
-    readonly borderBottomDimColor?: boolean;
-    /**
-     * Text to display embedded in the bottom border line.
-     * Rendered as: `└─ title ─────────┘`
-     */
-    readonly borderBottomTitle?: string;
-    /**
-     * Alignment of the bottom border title.
-     * @default "left"
-     */
-    readonly borderBottomTitleAlignment?: "center" | "left" | "right";
-    /**
-     * Change border color. A shorthand for setting `borderTopColor`, `borderRightColor`, `borderBottomColor`, and `borderLeftColor`.
-     */
-    readonly borderColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Dim the border color. A shorthand for setting `borderTopDimColor`, `borderBottomDimColor`, `borderLeftDimColor`, and `borderRightDimColor`.
-     * @default false
-     */
-    readonly borderDimColor?: boolean;
-    /**
-     * Determines whether the left border is visible.
-     * @default true
-     */
-    readonly borderLeft?: boolean;
-    /**
-     * Change the left border background color. Accepts the same values as `backgroundColor` in `Text` component.
-     */
-    readonly borderLeftBackgroundColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Change the left border color. Accepts the same values as `color` in `Text` component.
-     */
-    readonly borderLeftColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Dim the left border color.
-     * @default false
-     */
-    readonly borderLeftDimColor?: boolean;
-    /**
-     * Determines whether the right border is visible.
-     * @default true
-     */
-    readonly borderRight?: boolean;
-    /**
-     * Change the right border background color. Accepts the same values as `backgroundColor` in `Text` component.
-     */
-    readonly borderRightBackgroundColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Change the right border color. Accepts the same values as `color` in `Text` component.
-     */
-    readonly borderRightColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Dim the right border color.
-     * @default false
-     */
-    readonly borderRightDimColor?: boolean;
-    /**
-     * Add a border with a specified style. If `borderStyle` is `undefined` (the default), no border will be added.
-     */
-    readonly borderStyle?: keyof Boxes | BoxStyle;
-    /**
-     * Determines whether the top border is visible.
-     * @default true
-     */
-    readonly borderTop?: boolean;
-    /**
-     * Change the top border background color. Accepts the same values as `backgroundColor` in `Text` component.
-     */
-    readonly borderTopBackgroundColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Change the top border color. Accepts the same values as `color` in `Text` component.
-     */
-    readonly borderTopColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Dim the top border color.
-     * @default false
-     */
-    readonly borderTopDimColor?: boolean;
-    /**
-     * Text to display on the right side of the top border line.
-     * Rendered as: `┌─ title ──── rightTitle ─┐`
-     */
-    readonly borderTopRightTitle?: string;
-    /**
-     * Text to display embedded in the top border line.
-     * Rendered as: `┌─ title ─────────┐`
-     */
-    readonly borderTopTitle?: string;
-    /**
-     * Alignment of the top border title.
-     * @default "left"
-     */
-    readonly borderTopTitleAlignment?: "center" | "left" | "right";
-    /**
-     * Bottom offset for positioned elements.
-     */
-    readonly bottom?: number | string;
-    /**
-     * Size of the gap between an element's columns.
-     */
-    readonly columnGap?: number;
-    /**
-     * Set this property to `none` to hide the element.
-     */
-    readonly display?: "flex" | "none";
-    /**
-     * It specifies the initial size of the flex item, before any available space is distributed according to the flex factors.
-     * See [flex-basis](https://css-tricks.com/almanac/properties/f/flex-basis/).
-     */
-    readonly flexBasis?: number | string;
-    /**
-     * It establishes the main-axis, thus defining the direction flex items are placed in the flex container.
-     * See [flex-direction](https://css-tricks.com/almanac/properties/f/flex-direction/).
-     */
-    readonly flexDirection?: "row" | "column" | "row-reverse" | "column-reverse";
-    /**
-     * This property defines the ability for a flex item to grow if necessary.
-     * See [flex-grow](https://css-tricks.com/almanac/properties/f/flex-grow/).
-     */
-    readonly flexGrow?: number;
-    /**
-     * It specifies the “flex shrink factor”, which determines how much the flex item will shrink relative to the rest of the flex items in the flex container when there isn’t enough space on the row.
-     * See [flex-shrink](https://css-tricks.com/almanac/properties/f/flex-shrink/).
-     */
-    readonly flexShrink?: number;
-    /**
-     * It defines whether the flex items are forced in a single line or can be flowed into multiple lines. If set to multiple lines, it also defines the cross-axis which determines the direction new lines are stacked in.
-     * See [flex-wrap](https://css-tricks.com/almanac/properties/f/flex-wrap/).
-     */
-    readonly flexWrap?: "nowrap" | "wrap" | "wrap-reverse";
-    /**
-     * Size of the gap between an element's columns and rows. A shorthand for `columnGap` and `rowGap`.
-     */
-    readonly gap?: number;
-    /**
-     * Height of the element in lines (rows). You can also set it as a percentage, which will calculate the height based on the height of the parent element.
-     */
-    readonly height?: number | string;
-    /**
-     * It defines the alignment along the main axis.
-     * See [justify-content](https://css-tricks.com/almanac/properties/j/justify-content/).
-     */
-    readonly justifyContent?: "flex-start" | "flex-end" | "space-between" | "space-around" | "space-evenly" | "center";
-    /**
-     * Left offset for positioned elements.
-     */
-    readonly left?: number | string;
-    /**
-     * Margin on all sides. Equivalent to setting `marginTop`, `marginBottom`, `marginLeft`, and `marginRight`.
-     */
-    readonly margin?: number;
-    /**
-     * Bottom margin.
-     */
-    readonly marginBottom?: number;
-    /**
-     * Left margin.
-     */
-    readonly marginLeft?: number;
-    /**
-     * Right margin.
-     */
-    readonly marginRight?: number;
-    /**
-     * Top margin.
-     */
-    readonly marginTop?: number;
-    /**
-     * Horizontal margin. Equivalent to setting `marginLeft` and `marginRight`.
-     */
-    readonly marginX?: number;
-    /**
-     * Vertical margin. Equivalent to setting `marginTop` and `marginBottom`.
-     */
-    readonly marginY?: number;
-    /**
-     * Sets a maximum height of the element in lines (rows). You can also set it as a percentage, which will calculate the maximum height based on the height of the parent element.
-     */
-    readonly maxHeight?: number | string;
-    /**
-     * Sets a maximum width of the element.
-     * Percentages aren't supported yet; see https://github.com/facebook/yoga/issues/872.
-     */
-    readonly maxWidth?: number | string;
-    /**
-     * Sets a minimum height of the element in lines (rows). You can also set it as a percentage, which will calculate the minimum height based on the height of the parent element.
-     */
-    readonly minHeight?: number | string;
-    /**
-     * Sets a minimum width of the element.
-     * Percentages aren't supported yet; see https://github.com/facebook/yoga/issues/872.
-     */
-    readonly minWidth?: number | string;
-    /**
-     * Behavior for an element's overflow in both directions.
-     * @default 'visible'
-     */
-    readonly overflow?: "visible" | "hidden" | "scroll";
-    /**
-     * If true, content that is scrolled out of the top of the box (when overflowY is 'scroll')
-     * will be added to the terminal's scrollback history.
-     *
-     * Results are undefined if more than one scrollable region in the app has
-     * overflowToBackbuffer enabled.
-     *
-     * Note: Scroll height tracking is implemented but actual backbuffer writes
-     * require worker-based rendering (not yet ported).
-     * @default false
-     */
-    readonly overflowToBackbuffer?: boolean;
-    /**
-     * Behavior for an element's overflow in the horizontal direction.
-     * @default 'visible'
-     */
-    readonly overflowX?: "visible" | "hidden" | "scroll";
-    /**
-     * Behavior for an element's overflow in the vertical direction.
-     * @default 'visible'
-     */
-    readonly overflowY?: "visible" | "hidden" | "scroll";
-    /**
-     * Padding on all sides. Equivalent to setting `paddingTop`, `paddingBottom`, `paddingLeft`, and `paddingRight`.
-     */
-    readonly padding?: number;
-    /**
-     * Bottom padding.
-     */
-    readonly paddingBottom?: number;
-    /**
-     * Left padding.
-     */
-    readonly paddingLeft?: number;
-    /**
-     * Right padding.
-     */
-    readonly paddingRight?: number;
-    /**
-     * Top padding.
-     */
-    readonly paddingTop?: number;
-    /**
-     * Horizontal padding. Equivalent to setting `paddingLeft` and `paddingRight`.
-     */
-    readonly paddingX?: number;
-    /**
-     * Vertical padding. Equivalent to setting `paddingTop` and `paddingBottom`.
-     */
-    readonly paddingY?: number;
-    /**
-     * Controls how the element is positioned.
-     *
-     * When `position` is `static`, `top`, `right`, `bottom`, and `left` are ignored.
-     */
-    readonly position?: "absolute" | "relative" | "static";
-    /**
-     * Right offset for positioned elements.
-     */
-    readonly right?: number | string;
-    /**
-     * Size of the gap between an element's rows.
-     */
-    readonly rowGap?: number;
-    /**
-     * Color of the scrollbar thumb when overflow is set to 'scroll'.
-     */
-    readonly scrollbarThumbColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Horizontal scroll position (in columns). Only applies when overflowX or overflow is 'scroll'.
-     */
-    readonly scrollLeft?: number;
-    /**
-     * Vertical scroll position (in rows). Only applies when overflowY or overflow is 'scroll'.
-     */
-    readonly scrollTop?: number;
-    /**
-     * If true, and `overflowToBackbuffer` is also enabled, the `scrollHeight` of the box
-     * will never decrease as long as the existing history remains valid.
-     * This prevents the terminal's scrollback from being corrupted when content shrinks.
-     *
-     * Note: Scroll height tracking is implemented but actual backbuffer writes
-     * require worker-based rendering (not yet ported).
-     * @default false
-     */
-    readonly stableScrollback?: boolean;
-    /**
-     * Controls how text wraps when it exceeds the container width.
-     *
-     * - `wrap` (default) — Wrap at word boundaries; break inside words only when a single word exceeds the width.
-     * - `wrap-anywhere` — Break at any character boundary, even when a whitespace break exists earlier.
-     * - `wrap-preserve-words` — Wrap at word boundaries; never break inside words (long words may overflow).
-     * - `wrap-strict` — Enforce exact width; always break at the column limit.
-     * - `hard` — Alias for `wrap-strict`. Fills each line to the full column width, breaking words mid-word as needed.
-     * - `truncate` / `truncate-end` — Truncate at the end with an ellipsis.
-     * - `truncate-start` — Truncate at the start with an ellipsis.
-     * - `truncate-middle` — Truncate in the middle with an ellipsis.
-     */
-    readonly textWrap?: "hard" | "wrap" | "wrap-anywhere" | "wrap-preserve-words" | "wrap-strict" | "end" | "middle" | "truncate-end" | "truncate" | "truncate-middle" | "truncate-start";
-    /**
-     * Top offset for positioned elements.
-     */
-    readonly top?: number | string;
-    /**
-     * Determines whether the user can select text within this element.
-     * - `auto`: Default behavior, text is selectable.
-     * - `none`: Text cannot be selected.
-     * - `text`: Only text can be selected.
-     * - `all`: All content is selected on click.
-     */
-    readonly userSelect?: "auto" | "none" | "text" | "all";
-    /**
-     * Width of the element in spaces. You can also set it as a percentage, which will calculate the width based on the width of the parent element.
-     */
-    readonly width?: number | string;
-};
-declare const styles: (node: YogaNode, style?: Styles, currentStyle?: Styles) => void;
-export default styles;

package/dist/ink/terminal-palette.d.ts

@@ -1,25 +0,0 @@
-/**
- * Terminal palette auto-detection via OSC escape sequences.
- *
- * Queries the terminal for its current 16-color palette, foreground,
- * background, and cursor colors using OSC 4/10/11/12 sequences.
- * @see https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Operating-System-Commands
- */
-import type { Writable } from "node:stream";
-export type TerminalPalette = {
-    readonly background: string;
-    readonly colors: ReadonlyArray<string>;
-    readonly cursor: string;
-    readonly foreground: string;
-};
-/**
- * Check if the terminal likely supports OSC palette queries.
- */
-export declare const isTerminalPaletteQuerySupported: () => boolean;
-/**
- * Query the terminal for its current color palette.
- * @param stdin Readable stream (typically process.stdin in raw mode)
- * @param stdout Writable stream (typically process.stdout)
- * @param timeout Per-query timeout in milliseconds (default: 500)
- */
-export declare const queryTerminalPalette: (stdin: NodeJS.ReadableStream, stdout: Writable, timeout?: number) => Promise<Partial<TerminalPalette>>;

package/dist/ink/text-wrap.d.ts

@@ -1,10 +0,0 @@
-/**
- * StyledLine-based text wrapping and truncation.
- *
- * Operates directly on StyledLine objects to preserve ANSI styling through
- * wrap boundaries.
- *
- * Ported from jacob314/ink fork (Google LLC, Apache-2.0).
- */
-import { StyledLine } from "./styled-line.d.ts";
-export declare const wrapOrTruncateStyledLine: (line: StyledLine, maxWidth: number, textWrap?: string) => StyledLine[];

package/dist/ink/token-to-elements.d.ts

@@ -1,22 +0,0 @@
-/**
- * Convert Shiki ThemedToken[][] to Ink React elements for terminal rendering.
- */
-import type { ReactElement } from "react";
-import type { ThemedToken } from "shiki";
-export type TokenRenderOptions = {
-    readonly highlightLines?: ReadonlySet<number>;
-    readonly showLineNumbers?: boolean;
-    readonly startLine?: number;
-};
-/**
- * Render a single ThemedToken as a styled &lt;Text> element.
- */
-export declare const renderToken: (token: ThemedToken, key: number) => ReactElement;
-/**
- * Render a single line of tokens as inline React elements (no Box wrapper).
- */
-export declare const renderTokenLine: (tokens: ThemedToken[]) => ReactElement;
-/**
- * Convert Shiki token lines to Ink React elements with optional line numbers.
- */
-export declare const tokenLinesToElements: (lines: ThemedToken[][], options?: TokenRenderOptions) => ReactElement;

package/dist/ink/utils/format-time.d.ts

@@ -1,4 +0,0 @@
-/**
- * Format a duration in milliseconds to `MM:SS` or `HH:MM:SS` (when hours > 0).
- */
-export declare function formatDuration(ms: number): string;

package/dist/ink/utils.d.ts

@@ -1,9 +0,0 @@
-/**
- * Get the effective terminal dimensions from the given stdout stream.
- *
- * Falls back to `terminal-size` for columns in piped processes where `stdout.columns` is 0, and uses standard defaults (80×24) when dimensions cannot be determined.
- */
-export declare const getWindowSize: (stdout: NodeJS.WriteStream) => {
-    columns: number;
-    rows: number;
-};

package/dist/ink/wrap-text.d.ts

@@ -1,3 +0,0 @@
-import type { Styles } from "./styles.d.ts";
-declare const wrapText: (text: string, maxWidth: number, wrapType: Styles["textWrap"]) => string;
-export default wrapText;

package/dist/ink/write-synchronized.d.ts

@@ -1,4 +0,0 @@
-import type { Writable } from "node:stream";
-export declare const bsu = "\u001B[?2026h";
-export declare const esu = "\u001B[?2026l";
-export declare function shouldSynchronize(stream: Writable, interactive?: boolean): boolean;

package/dist/packem_shared/AccessibilityContext-BLelHhNU.js

@@ -1,7 +0,0 @@
-import { createContext } from 'react';
-
-const accessibilityContext = createContext({
-  isScreenReaderEnabled: false
-});
-
-export { accessibilityContext as a };

package/dist/packem_shared/Alert-Dr3s_LD9.js

@@ -1,17 +0,0 @@
-import { jsxs, jsx } from 'react/jsx-runtime';
-import Box from './Box-D_pSJ9Jp.js';
-import Text from './Text-DvAUdZcK.js';
-import { V as VARIANT_CONFIG } from './variant-config-DSZoX5TM.js';
-
-function Alert({ children, title, variant }) {
-  const { color, icon } = VARIANT_CONFIG[variant];
-  return jsxs(Box, { borderColor: color, borderStyle: "round", flexGrow: 1, gap: 1, paddingX: 1, children: [
-    jsx(Box, { flexShrink: 0, children: jsx(Text, { color, children: icon }) }),
-    jsxs(Box, { flexDirection: "column", flexGrow: 1, flexShrink: 1, gap: 1, minWidth: 0, children: [
-      title ? jsx(Text, { bold: true, children: title }) : void 0,
-      jsx(Text, { children })
-    ] })
-  ] });
-}
-
-export { Alert as default };

package/dist/packem_shared/AnimationContext-BcJg8Jr6.js

@@ -1,15 +0,0 @@
-import { createContext } from 'react';
-
-const animationContext = createContext({
-  renderThrottleMs: 0,
-  subscribe() {
-    return {
-      startTime: 0,
-      unsubscribe() {
-      }
-    };
-  }
-});
-animationContext.displayName = "InternalAnimationContext";
-
-export { animationContext as a };

package/dist/packem_shared/AppContext-CP0U6H7O.js

@@ -1,11 +0,0 @@
-import { createContext } from 'react';
-
-const AppContext = createContext({
-  exit() {
-  },
-  async waitUntilRenderFlush() {
-  }
-});
-AppContext.displayName = "InternalAppContext";
-
-export { AppContext as A };

package/dist/packem_shared/BackgroundContext-BAUaxfOb.js

@@ -1,5 +0,0 @@
-import { createContext } from 'react';
-
-const backgroundContext = createContext(void 0);
-
-export { backgroundContext as b };

package/dist/packem_shared/Badge-Dk7EGGM6.js

@@ -1,13 +0,0 @@
-import { jsxs, jsx } from 'react/jsx-runtime';
-import Text from './Text-DvAUdZcK.js';
-
-function Badge({ children, color = "magenta" }) {
-  const formattedChildren = typeof children === "string" ? children.toUpperCase() : children;
-  return jsxs(Text, { backgroundColor: color, children: [
-    " ",
-    jsx(Text, { color: "black", children: formattedChildren }),
-    " "
-  ] });
-}
-
-export { Badge as default };

package/dist/packem_shared/BigText-CjMdY63X.js

@@ -1,24 +0,0 @@
-import { jsx } from 'react/jsx-runtime';
-import CFonts from 'cfonts';
-import { useMemo } from 'react';
-import Text from './Text-DvAUdZcK.js';
-
-const defaults = {
-  align: "left",
-  backgroundColor: "transparent",
-  colors: ["system"],
-  font: "block",
-  letterSpacing: 1,
-  lineHeight: 1,
-  maxLength: 0,
-  space: true
-};
-function BigText({ align, backgroundColor, colors, font, letterSpacing, lineHeight, maxLength, space, text }) {
-  const rendered = useMemo(
-    () => CFonts.render(text, { ...defaults, align, backgroundColor, colors, font, letterSpacing, lineHeight, maxLength, space }),
-    [text, align, backgroundColor, colors, font, letterSpacing, lineHeight, maxLength, space]
-  );
-  return jsx(Text, { children: rendered && rendered.string });
-}
-
-export { BigText as default };

package/dist/packem_shared/Box-D_pSJ9Jp.js

@@ -1,73 +0,0 @@
-import { jsx, jsxs } from 'react/jsx-runtime';
-import { forwardRef, useContext } from 'react';
-import { a as accessibilityContext } from './AccessibilityContext-BLelHhNU.js';
-import { b as backgroundContext } from './BackgroundContext-BAUaxfOb.js';
-
-const BOX_BASE_STYLE = {
-  flexDirection: "row",
-  flexGrow: 0,
-  flexShrink: 1,
-  flexWrap: "nowrap"
-};
-const Box = forwardRef(
-  ({
-    "aria-hidden": ariaHidden,
-    "aria-label": ariaLabel,
-    "aria-role": role,
-    "aria-state": ariaState,
-    backgroundColor,
-    children,
-    opaque,
-    scrollbar,
-    sticky,
-    stickyChildren,
-    ...style
-  }, ref) => {
-    const { isScreenReaderEnabled } = useContext(accessibilityContext);
-    const label = ariaLabel ? jsx("ink-text", { children: ariaLabel }) : void 0;
-    if (isScreenReaderEnabled && ariaHidden) {
-      return null;
-    }
-    const boxElement = jsxs(
-      "ink-box",
-      {
-        internal_accessibility: {
-          role,
-          state: ariaState
-        },
-        opaque,
-        ref,
-        scrollbar,
-        sticky,
-        style: {
-          ...BOX_BASE_STYLE,
-          ...style,
-          backgroundColor,
-          overflowX: style.overflowX ?? style.overflow ?? "visible",
-          overflowY: style.overflowY ?? style.overflow ?? "visible"
-        },
-        children: [
-          isScreenReaderEnabled && label ? label : children,
-          sticky && stickyChildren && !isScreenReaderEnabled ? jsx(
-            "ink-box",
-            {
-              internalStickyAlternate: true,
-              style: {
-                position: "absolute",
-                ...style
-              },
-              children: stickyChildren
-            }
-          ) : null
-        ]
-      }
-    );
-    if (backgroundColor) {
-      return jsx(backgroundContext.Provider, { value: backgroundColor, children: boxElement });
-    }
-    return boxElement;
-  }
-);
-Box.displayName = "Box";
-
-export { Box as default };