@visulima/tui 2.0.0 → 3.0.0

package/dist/packem_shared/styles.d-CKGQFfm4.d.ts

@@ -0,0 +1,485 @@
+import { AnsiColors } from '@visulima/colorize';
+import { LiteralUnion } from 'type-fest';
+import 'yoga-layout';
+/**
+Style of the box border.
+*/
+type BoxStyle = {
+  readonly topLeft: string;
+  readonly top: string;
+  readonly topRight: string;
+  readonly right: string;
+  readonly bottomRight: string;
+  readonly bottom: string;
+  readonly bottomLeft: string;
+  readonly left: string;
+};
+/**
+All box styles.
+*/
+type Boxes = {
+  /**
+	@example
+	```
+	┌────┐
+	│    │
+	└────┘
+	```
+	*/
+  readonly single: BoxStyle;
+  /**
+	@example
+	```
+	╔════╗
+	║    ║
+	╚════╝
+	```
+	*/
+  readonly double: BoxStyle;
+  /**
+	@example
+	```
+	╭────╮
+	│    │
+	╰────╯
+	```
+	*/
+  readonly round: BoxStyle;
+  /**
+	@example
+	```
+	┏━━━━┓
+	┃    ┃
+	┗━━━━┛
+	```
+	*/
+  readonly bold: BoxStyle;
+  /**
+	@example
+	```
+	╓────╖
+	║    ║
+	╙────╜
+	```
+	*/
+  readonly singleDouble: BoxStyle;
+  /**
+	@example
+	```
+	╒════╕
+	│    │
+	╘════╛
+	```
+	*/
+  readonly doubleSingle: BoxStyle;
+  /**
+	@example
+	```
+	+----+
+	|    |
+	+----+
+	```
+	*/
+  readonly classic: BoxStyle;
+  /**
+	@example
+	```
+	↘↓↓↓↓↙
+	→    ←
+	↗↑↑↑↑↖
+	```
+	*/
+  readonly arrow: BoxStyle;
+};
+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;
+  /**
+   * Caps how far the stable scroll height is allowed to grow beyond the
+   * content currently in the box, in rows. Only applies when both
+   * `stableScrollback` and `overflowToBackbuffer` are enabled.
+   *
+   * Without a cap, `scrollHeight` for a stable-scrollback box never shrinks
+   * and grows monotonically for the lifetime of the box (long-running logs,
+   * streaming output). That makes the scrollbar/scrollTop math treat an
+   * ever-growing region as scrollable even after the content is gone. This
+   * bounds the retained history to at most `maxScrollbackLength` rows past
+   * the current content. Omit for the previous unbounded behavior.
+   *
+   * It also bounds a single-frame backbuffer burst to at most this many rows
+   * on a large `scrollTop` jump. A value of `0` therefore disables
+   * terminal-scrollback emission entirely (scrolled-off lines are still
+   * clipped from the live view, just not flushed to history) — use it to
+   * cap growth without keeping any backbuffer, or omit it for unbounded
+   * retention.
+   */
+  readonly maxScrollbackLength?: number;
+  /**
+   * 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')
+   * is flushed into the terminal emulator's real scrollback history instead
+   * of being clipped and discarded. Scrolling back up in the terminal reveals
+   * the original lines.
+   *
+   * Constraints:
+   * - Inline mode only. In alternate-screen mode the terminal has no
+   *   scrollback, so this is a no-op. Non-TTY/piped output is also a no-op
+   *   (content is clipped as before).
+   * - Exactly one scrollable region in the app may enable
+   *   `overflowToBackbuffer`. Results are undefined with more than one.
+   *
+   * Each scrolled-off line is emitted exactly once; scrolling back up never
+   * re-emits. Pair with `stableScrollback` to keep `scrollTop` math stable as
+   * history accumulates, and `maxScrollbackLength` to bound a single-frame
+   * burst on a large `scrollTop` jump.
+   * @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.
+   *
+   * Growth is bounded by `maxScrollbackLength` (if set); otherwise the stable
+   * height grows monotonically for the lifetime of the box.
+   * @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;
+};
+export { Styles as S };

package/dist/packem_shared/{terminal-palette.d-D2SQjfn-.d.ts → terminal-palette.d-JbWHISW-.d.ts}

@@ -6,14 +6,14 @@ type TerminalPalette = {
   readonly foreground: string;
 };
 /**
-* Check if the terminal likely supports OSC palette queries.
-*/
+ * Check if the terminal likely supports OSC palette queries.
+ */
 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)
-*/
+ * 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)
+ */
 declare const queryTerminalPalette: (stdin: NodeJS.ReadableStream, stdout: Writable, timeout?: number) => Promise<Partial<TerminalPalette>>;
 export { TerminalPalette as T, isTerminalPaletteQuerySupported as i, queryTerminalPalette as q };

package/dist/packem_shared/utils-CVgM8kTn.js

@@ -0,0 +1 @@
+import{createRequire as w}from"node:module";let _;const b=e=>(_??=w(import.meta.url))(e),o=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,m=e=>{if(typeof o<"u"&&o.versions&&o.versions.node){const[r,s]=o.versions.node.split(".").map(Number);if(r>22||r===22&&s>=3||r===20&&s>=16)return o.getBuiltinModule(e)}return b(e)},n=o,{execFileSync:g}=m("node:child_process"),c=m("node:fs"),h=m("node:tty"),d=80,p=24,a=(e,r,{shell:s,env:t}={})=>g(e,r,{encoding:"utf8",stdio:["ignore","pipe","ignore"],timeout:500,shell:s,env:t}).trim(),u=(e,r)=>({columns:Number.parseInt(e,10),rows:Number.parseInt(r,10)}),N=(e,r)=>{const{columns:s,rows:t}=u(e,r);if(!(Number.isNaN(s)||Number.isNaN(t))&&!(s===d&&t===p))return{columns:s,rows:t}},y=()=>{if(n.platform!=="linux")return!0;try{const e=c.readFileSync("/proc/self/stat","utf8"),r=e.lastIndexOf(") ");if(r===-1)return!1;const s=e.slice(r+2).trim().split(/\s+/),t=Number.parseInt(s[2],10),i=Number.parseInt(s[5],10);return Number.isNaN(t)||Number.isNaN(i)||i<=0?!1:t===i}catch{return!1}};function v(){const{env:e,stdout:r,stderr:s}=n;if(r?.columns&&r?.rows)return u(r.columns,r.rows);if(s?.columns&&s?.rows)return u(s.columns,s.rows);if(e.COLUMNS&&e.LINES)return u(e.COLUMNS,e.LINES);const t={columns:d,rows:p};return n.platform==="win32"?l()??t:n.platform==="darwin"?f()??l()??t:f()??l()??O()??t}const f=()=>{try{const e=n.platform==="darwin"?c.constants.O_EVTONLY|c.constants.O_NONBLOCK:c.constants.O_NONBLOCK,{columns:r,rows:s}=h.WriteStream(c.openSync("/dev/tty",e));return{columns:r,rows:s}}catch{}},l=()=>{try{const e=a("tput",["cols"],{env:{TERM:"dumb",...n.env}}),r=a("tput",["lines"],{env:{TERM:"dumb",...n.env}});if(e&&r)return N(e,r)}catch{}},O=()=>{try{if(!y())return;const e=a("resize",["-u"]).match(/\d+/g);if(e.length===2)return N(e[0],e[1])}catch{}},I=e=>{const{columns:r,rows:s}=e;if(r&&s)return{columns:r,rows:s};const t=v();return{columns:r||t.columns||80,rows:s||t.rows||24}};export{I as g};