@visulima/tui 1.0.0-alpha.2 → 1.0.0-alpha.20

package/dist/components/diff-view.d.ts

@@ -0,0 +1,85 @@
+import { ReactElement } from 'react';
+type DiffViewMode = "split" | "unified";
+type InlineDiffMode = "chars" | "words";
+type Props = {
+  /**
+  * Number of unchanged context lines around changes.
+  * @default 3
+  */
+  readonly context?: number;
+  /**
+  * Pre-computed unified diff string. If provided, `oldText`/`newText` are ignored.
+  */
+  readonly diff?: string;
+  /**
+  * Enable character-level inline diff highlighting within changed lines.
+  * @default true
+  */
+  readonly inlineDiff?: boolean;
+  /**
+  * Granularity of inline diff highlighting.
+  * - `"chars"` — character-level (best for code)
+  * - `"words"` — word-level (best for prose)
+  * @default "chars"
+  */
+  readonly inlineDiffMode?: InlineDiffMode;
+  /**
+  * Programming language for syntax highlighting within diff lines.
+  * When provided, diff content is highlighted with Shiki.
+  */
+  readonly language?: string;
+  /**
+  * Display mode: unified (interleaved) or split (side-by-side).
+  * @default "unified"
+  */
+  readonly mode?: DiffViewMode;
+  /**
+  * Label for the new version.
+  */
+  readonly newLabel?: string;
+  /**
+  * Modified text ("new" / right side).
+  */
+  readonly newText?: string;
+  /**
+  * Label for the old version.
+  */
+  readonly oldLabel?: string;
+  /**
+  * Original text ("old" / left side).
+  */
+  readonly oldText?: string;
+  /**
+  * Whether to display line numbers.
+  * @default true
+  */
+  readonly showLineNumbers?: boolean;
+  /**
+  * Shiki theme for syntax highlighting.
+  * @default "github-dark-default"
+  */
+  readonly theme?: string;
+};
+/**
+* Display file differences with colored additions/deletions.
+*
+* ```tsx
+* <DiffView oldText="hello" newText="hello world" />
+* <DiffView diff={unifiedDiffString} mode="split" />
+* ```
+*/
+declare function DiffView({
+  context,
+  diff: diffProp,
+  inlineDiff,
+  inlineDiffMode,
+  language,
+  mode,
+  newLabel,
+  newText,
+  oldLabel,
+  oldText,
+  showLineNumbers,
+  theme
+}: Props): ReactElement;
+export { DiffView, DiffViewMode, type Props as DiffViewProps, InlineDiffMode, Props, DiffView as default };

package/dist/components/diff-view.js

@@ -0,0 +1 @@
+var M=Object.defineProperty;var v=(r,i)=>M(r,"name",{value:i,configurable:!0});import{jsx as u,jsxs as g,Fragment as $}from"react/jsx-runtime";import{createPatch as V,parsePatch as W,diffWords as j,diffChars as B}from"diff";import{useMemo as k,useState as U,useRef as q,useEffect as A}from"react";import{r as E,i as F,P as J,g as K,a as O}from"../packem_shared/token-to-elements-BAZpNZsu.js";import R from"../ink/hooks/use-window-size.js";import{Box as p}from"./box.js";import{Text as a}from"./text.js";var X=Object.defineProperty,x=v((r,i)=>X(r,"name",{value:i,configurable:!0}),"y");const L=x((r,i,n,d)=>{if(!i||n===void 0||n<1||n>i.length)return d?u(a,{color:d,children:r}):u(a,{dimColor:!0,children:r});const o=i[n-1];return!o||o.length===0?d?u(a,{color:d,children:r}):u(a,{dimColor:!0,children:r}):O(o)},"renderHighlightedContent"),S=x((r,i,n)=>{const[d,o]=U(null),h=q(!1);return A(()=>{if(h.current=!1,!i){o(null);return}const e=E(i);if(!F(e)){o(null);return}return(async()=>{try{const f=await J([e],n),l=K(f,r,e,n);h.current||o(l.tokens)}catch{h.current||o(null)}})(),()=>{h.current=!0}},[r,i,n]),d},"useHighlightedLines"),z=x((r,i,n="chars")=>{const d=W(r),o=[];for(const h of d)for(const e of h.hunks){const f=`@@ -${e.oldStart},${e.oldLines} +${e.newStart},${e.newLines} @@`,l=[];let s=e.oldStart,c=e.newStart;for(const w of e.lines)w.startsWith("\\")||(w.startsWith("+")?l.push({content:w.slice(1),newLineNum:c++,type:"add"}):w.startsWith("-")?l.push({content:w.slice(1),oldLineNum:s++,type:"del"}):l.push({content:w.slice(1),newLineNum:c++,oldLineNum:s++,type:"context"}));if(i){const w=Q(l);for(const[N,t]of w)if(l[N].type==="del"&&l[t].type==="add"){const m=G(l[N].content,l[t].content,n);l[N].inlineDiff=m??void 0,l[N].pairedIndex=t,l[t].inlineDiff=m??void 0,l[t].pairedIndex=N}}o.push({header:f,lines:l})}return o},"parseDiffLines"),P=500,G=x((r,i,n="chars")=>{if(r.length>P||i.length>P)return null;const d=n==="words"?j(r,i):B(r,i),o=[],h=[];for(const e of d)e.removed?o.push({highlight:!0,value:e.value}):e.added?h.push({highlight:!0,value:e.value}):(o.push({highlight:!1,value:e.value}),h.push({highlight:!1,value:e.value}));return{addParts:h,delParts:o}},"computeInlineDiff"),C=x((r,i,n)=>u($,{children:r.map((d,o)=>d.highlight?u(a,{backgroundColor:n,color:"white",children:d.value},o):u(a,{color:i,children:d.value},o))}),"renderInlineParts"),Q=x(r=>{const i=new Map;let n=0;for(;n<r.length;){const d=n;for(;n<r.length&&r[n].type==="del";)n++;const o=n,h=n;for(;n<r.length&&r[n].type==="add";)n++;const e=n,f=o-d,l=e-h,s=Math.min(f,l);for(let c=0;c<s;c++)i.set(d+c,h+c),i.set(h+c,d+c);n===d&&n++}return i},"findInlinePairs");function H({hunks:r,newHighlighted:i,oldHighlighted:n,showLineNumbers:d}){return u(p,{flexDirection:"column",children:r.map((o,h)=>g(p,{flexDirection:"column",children:[h>0?u(p,{marginBottom:0,marginTop:0,children:u(a,{dimColor:!0,children:"···"})}):void 0,u(a,{color:"cyan",dimColor:!0,children:o.header}),o.lines.map((e,f)=>{let l,s,c;switch(e.type){case"add":{s="+",c="green",l=e.inlineDiff?C(e.inlineDiff.addParts,"green","green"):L(e.content,i,e.newLineNum,"green");break}case"del":{s="-",c="red",l=e.inlineDiff?C(e.inlineDiff.delParts,"red","red"):L(e.content,n,e.oldLineNum,"red");break}default:{s=" ",c=void 0,l=L(e.content,n,e.oldLineNum);break}}return g(p,{children:[d?g(a,{color:c,dimColor:e.type==="context",children:[String(e.oldLineNum??"").padStart(4)," ",String(e.newLineNum??"").padStart(4)," "]}):void 0,u(a,{color:c,children:s}),l]},f)})]},h))})}v(H,"J");x(H,"UnifiedView");function I({hunks:r,newHighlighted:i,oldHighlighted:n,showLineNumbers:d,width:o}){const h=Math.floor(o/2)-1;return u(p,{flexDirection:"column",children:r.map((e,f)=>{const l=f>0?u(p,{marginBottom:0,marginTop:0,children:u(a,{dimColor:!0,children:"···"})}):void 0,s=[],c=[];for(let N=0;N<e.lines.length;N++){const t=e.lines[N];switch(t.type){case"add":{t.pairedIndex===void 0&&(s.push({content:u(a,{dimColor:!0})}),c.push({content:L(t.content,i,t.newLineNum,"green"),lineNum:t.newLineNum}));break}case"context":{s.push({content:L(t.content,n,t.oldLineNum),lineNum:t.oldLineNum}),c.push({content:L(t.content,i,t.newLineNum),lineNum:t.newLineNum});break}case"del":{if(t.pairedIndex===void 0)s.push({content:L(t.content,n,t.oldLineNum,"red"),lineNum:t.oldLineNum}),c.push({content:u(a,{dimColor:!0})});else{const m=e.lines[t.pairedIndex];s.push({content:t.inlineDiff?C(t.inlineDiff.delParts,"red","red"):L(t.content,n,t.oldLineNum,"red"),lineNum:t.oldLineNum}),c.push({content:m.inlineDiff?C(m.inlineDiff.addParts,"green","green"):L(m.content,i,m.newLineNum,"green"),lineNum:m.newLineNum})}break}}}const w=Math.max(s.length,c.length);return g(p,{flexDirection:"column",children:[l,u(a,{color:"cyan",dimColor:!0,children:e.header}),Array.from({length:w},(N,t)=>{const m=s[t],D=c[t];return g(p,{flexDirection:"row",children:[g(p,{width:h,children:[d?g(a,{dimColor:!0,children:[String(m?.lineNum??"").padStart(4)," "]}):void 0,m?.content]}),u(a,{dimColor:!0,children:"│"}),g(p,{width:h,children:[d?g(a,{dimColor:!0,children:[String(D?.lineNum??"").padStart(4)," "]}):void 0,D?.content]})]},t)})]},f)})})}v(I,"K");x(I,"SplitView");function Y({context:r=3,diff:i,inlineDiff:n=!0,inlineDiffMode:d="chars",language:o,mode:h="unified",newLabel:e="new",newText:f="",oldLabel:l="old",oldText:s="",showLineNumbers:c=!0,theme:w="github-dark-default"}){const{columns:N}=R(),t=S(s,o,w),m=S(f,o,w),D=k(()=>i||V("file",s,f,l,e,{context:r}),[i,s,f,l,e,r]),b=k(()=>z(D,n,d),[D,n,d]);if(b.every(T=>T.lines.length===0))return u(p,{children:u(a,{dimColor:!0,children:"No differences found."})});const y=g(p,{flexDirection:"column",children:[g(a,{color:"red",dimColor:!0,children:["---"," ",l]}),g(a,{color:"green",dimColor:!0,children:["+++"," ",e]})]});return h==="split"?g(p,{flexDirection:"column",children:[y,u(I,{hunks:b,newHighlighted:m,oldHighlighted:t,showLineNumbers:c,width:N??80})]}):g(p,{flexDirection:"column",children:[y,u(H,{hunks:b,newHighlighted:m,oldHighlighted:t,showLineNumbers:c})]})}v(Y,"S");x(Y,"DiffView");export{Y as DiffView,Y as default};

package/dist/components/divider.d.ts

@@ -0,0 +1,49 @@
+import { A as AnsiColors } from "../packem_shared/index.server.d-eZWyC2Ku.js";
+import { ReactElement } from 'react';
+import { LiteralUnion } from 'type-fest';
+type Props = {
+  /**
+  * Custom character to use instead of the default line character.
+  */
+  readonly character?: string;
+  /**
+  * Color of the divider line.
+  */
+  readonly color?: LiteralUnion<AnsiColors, string>;
+  /**
+  * Render the divider with dim color.
+  */
+  readonly dimColor?: boolean;
+  /**
+  * Optional label rendered in the middle of a horizontal divider.
+  */
+  readonly label?: string;
+  /**
+  * Padding around the label.
+  * @default 1
+  */
+  readonly labelPadding?: number;
+  /**
+  * Total length of the divider. When omitted, horizontal dividers stretch to
+  * fill the available space and vertical dividers default to one row.
+  */
+  readonly length?: number;
+  /**
+  * Orientation of the divider.
+  * @default "horizontal"
+  */
+  readonly orientation?: "horizontal" | "vertical";
+};
+/**
+* Horizontal or vertical divider line, optionally with a centered label.
+*/
+declare function Divider({
+  character,
+  color,
+  dimColor,
+  label,
+  labelPadding,
+  length,
+  orientation
+}: Props): ReactElement;
+export { Divider, type Props as DividerProps, Props, Divider as default };

package/dist/components/divider.js

@@ -0,0 +1 @@
+var w=Object.defineProperty;var d=(l,r)=>w(l,"name",{value:r,configurable:!0});import{jsx as o,jsxs as p}from"react/jsx-runtime";import C from"../ink/hooks/use-window-size.js";import{Box as i}from"./box.js";import{Text as n}from"./text.js";var g=Object.defineProperty,b=d((l,r)=>g(l,"name",{value:r,configurable:!0}),"m");function G({character:l,color:r,dimColor:t=!1,label:h,labelPadding:u=1,length:e,orientation:m="horizontal"}){const{columns:s}=C(),a=l??(m==="horizontal"?"─":"│");if(m==="vertical"){const x=e??1;return o(i,{flexDirection:"column",height:x,children:Array.from({length:x},(j,v)=>o(n,{color:r,dimColor:t,children:a},`divider-row-${v}`))})}const c=Math.min(500,e??Math.max(s,1));if(h===void 0)return o(i,{flexGrow:e===void 0?1:0,width:e,children:o(n,{color:r,dimColor:t,wrap:"truncate",children:a.repeat(c)})});const f=" ".repeat(u);return p(i,{flexGrow:e===void 0?1:0,width:e,children:[o(i,{flexGrow:1,flexShrink:1,children:o(n,{color:r,dimColor:t,wrap:"truncate",children:a.repeat(c)})}),o(i,{flexShrink:0,children:p(n,{color:r,dimColor:t,children:[f,h,f]})}),o(i,{flexGrow:1,flexShrink:1,children:o(n,{color:r,dimColor:t,wrap:"truncate",children:a.repeat(c)})})]})}d(G,"u");b(G,"Divider");export{G as Divider,G as default};

package/dist/components/file-picker-entry.d.ts

@@ -0,0 +1,104 @@
+import { ReactElement } from 'react';
+/**
+* A single entry (file or directory) returned by the file system hook.
+*/
+type FileEntry = {
+  readonly isDirectory: boolean;
+  readonly isHidden: boolean;
+  readonly name: string;
+  readonly path: string;
+  readonly permissions: string;
+  readonly size: number;
+};
+/**
+* Filter options for the file picker.
+*/
+type FilePickerFilter = {
+  /**
+  * Allowed file extensions (e.g. `[".ts", ".tsx"]`). Empty or omitted means all.
+  */
+  readonly extensions?: ReadonlyArray<string>;
+  /**
+  * Whether to include directories in the list.
+  * @default true
+  */
+  readonly showDirectories?: boolean;
+  /**
+  * Whether to include regular files in the list.
+  * @default true
+  */
+  readonly showFiles?: boolean;
+  /**
+  * Whether to include hidden files (names starting with `.`).
+  * @default false
+  */
+  readonly showHidden?: boolean;
+};
+type Props = {
+  /**
+  * Color for the focused item highlight.
+  * @default "cyan"
+  */
+  readonly accentColor?: string;
+  /**
+  * Color for directory entries.
+  * @default "blue"
+  */
+  readonly directoryColor?: string;
+  /**
+  * Color for file entries.
+  * @default "white"
+  */
+  readonly fileColor?: string;
+  /**
+  * File filter options.
+  */
+  readonly filter?: FilePickerFilter;
+  /**
+  * Starting directory path.
+  * @default process.cwd()
+  */
+  readonly initialPath?: string;
+  /**
+  * Whether keyboard navigation is active.
+  * @default true
+  */
+  readonly isFocused?: boolean;
+  /**
+  * Maximum number of visible items (viewport height).
+  * @default 10
+  */
+  readonly limit?: number;
+  /**
+  * Called when escape is pressed.
+  */
+  readonly onCancel?: () => void;
+  /**
+  * Called when a file is selected (enter on a file entry).
+  */
+  readonly onSelect?: (entry: FileEntry) => void;
+  /**
+  * Show file permissions column.
+  * @default false
+  */
+  readonly showPermissions?: boolean;
+  /**
+  * Show file size column.
+  * @default false
+  */
+  readonly showSize?: boolean;
+};
+declare const FilePicker: ({
+  accentColor,
+  directoryColor,
+  fileColor,
+  filter,
+  initialPath,
+  isFocused,
+  limit,
+  onCancel,
+  onSelect,
+  showPermissions,
+  showSize
+}: Props) => ReactElement;
+export { type FileEntry, FilePicker, type FilePickerFilter, type Props as FilePickerProps, FilePicker as default };

package/dist/components/file-picker-entry.js

@@ -0,0 +1 @@
+import{default as f,default as l}from"../packem_shared/FilePicker-tYj_CIau.js";export{f as FilePicker,l as default};

package/dist/components/form.d.ts

@@ -0,0 +1,81 @@
+import { A as AnsiColors } from "../packem_shared/index.server.d-eZWyC2Ku.js";
+import { ReactNode, ReactElement } from 'react';
+import { LiteralUnion } from 'type-fest';
+type FormFieldProps = {
+  /**
+  * The input element (TextInput, Checkbox, Select, …).
+  */
+  readonly children: ReactNode;
+  /**
+  * Optional helper text rendered beneath the input.
+  */
+  readonly description?: string;
+  /**
+  * Validation error — dimmed red below the input.
+  */
+  readonly error?: string;
+  /**
+  * When true, the field's label and description are dim.
+  */
+  readonly isDisabled?: boolean;
+  /**
+  * Label rendered above the input.
+  */
+  readonly label: string;
+  /**
+  * Mark the field as required (adds a trailing `*`).
+  */
+  readonly required?: boolean;
+};
+/**
+* Standard form field wrapper: label + input + helper/error.
+*/
+declare const FormField: ({
+  children,
+  description,
+  error,
+  isDisabled,
+  label,
+  required
+}: FormFieldProps) => ReactElement;
+type Props = {
+  /**
+  * Accent color for the form chrome.
+  * @default "blue"
+  */
+  readonly accentColor?: LiteralUnion<AnsiColors, string>;
+  /**
+  * Render a border around the form.
+  * @default true
+  */
+  readonly bordered?: boolean;
+  /**
+  * Fields composed via `&lt;FormField />`.
+  */
+  readonly children: ReactNode;
+  /**
+  * Optional description rendered under the title.
+  */
+  readonly description?: string;
+  /**
+  * Optional footer rendered below the fields (buttons, hints, summary).
+  */
+  readonly footer?: ReactNode;
+  /**
+  * Optional heading rendered at the top.
+  */
+  readonly title?: string;
+  /**
+  * Fixed width.
+  */
+  readonly width?: number;
+};
+type FormComponent = ((props: Props) => ReactElement) & {
+  Field: typeof FormField;
+};
+/**
+* Stateless form layout. Pair with the `useForm` hook for state management
+* and `FormField` for consistent label/error styling.
+*/
+declare const Form: FormComponent;
+export { Form, FormField, FormFieldProps, type Props as FormProps, Props, Form as default };

package/dist/components/form.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var s=(e,i)=>u(e,"name",{value:i,configurable:!0});import{jsxs as m,jsx as r}from"react/jsx-runtime";import{Box as o}from"./box.js";import{Text as d}from"./text.js";var f=Object.defineProperty,v=s((e,i)=>f(e,"name",{value:i,configurable:!0}),"s");const b=v(({children:e,description:i,error:l,isDisabled:n=!1,label:c,required:t=!1})=>m(o,{flexDirection:"column",marginBottom:1,children:[m(o,{children:[r(d,{bold:!0,dimColor:n,children:c}),t?r(d,{color:"red",children:" *"}):void 0]}),r(o,{marginTop:0,children:e}),l===void 0?i===void 0?void 0:r(d,{dimColor:!0,children:i}):r(d,{color:"red",children:l})]}),"FormField"),F=Object.assign(({accentColor:e="blue",bordered:i=!0,children:l,description:n,footer:c,title:t,width:a})=>{const h=m(o,{flexDirection:"column",children:[t===void 0?void 0:r(o,{marginBottom:1,children:r(d,{bold:!0,color:e,children:t})}),n===void 0?void 0:r(o,{marginBottom:1,children:r(d,{dimColor:!0,children:n})}),r(o,{flexDirection:"column",children:l}),c===void 0?void 0:r(o,{marginTop:1,children:c})]});return i?r(o,{borderColor:e,borderStyle:"round",flexDirection:"column",paddingX:1,paddingY:1,width:a,children:h}):r(o,{flexDirection:"column",width:a,children:h})},{Field:b});export{F as Form,b as FormField,F as default};

package/dist/components/gauge.d.ts

@@ -0,0 +1,87 @@
+import { A as AnsiColors } from "../packem_shared/index.server.d-eZWyC2Ku.js";
+import { ReactElement } from 'react';
+import { LiteralUnion } from 'type-fest';
+type GaugeThreshold = {
+  /**
+  * Color used for the arc segment and, when the current value falls into
+  * this segment, for the value readout.
+  */
+  readonly color: LiteralUnion<AnsiColors, string>;
+  /**
+  * Optional label used by the legend under the gauge.
+  */
+  readonly label?: string;
+  /**
+  * Upper bound of this threshold segment (inclusive). Segments are sorted
+  * ascending and painted in order.
+  */
+  readonly max: number;
+};
+type GaugeSize = "large" | "medium" | "small";
+type Props = {
+  /**
+  * Color of the arc background (the portion beyond `value`).
+  * @default "gray"
+  */
+  readonly backgroundColor?: LiteralUnion<AnsiColors, string>;
+  /**
+  * Format for the numeric readout. Defaults to rounding to an integer.
+  */
+  readonly formatValue?: (value: number) => string;
+  /**
+  * Optional label rendered above the readout.
+  */
+  readonly label?: string;
+  /**
+  * Upper bound of the range.
+  * @default 100
+  */
+  readonly max?: number;
+  /**
+  * Lower bound of the range.
+  * @default 0
+  */
+  readonly min?: number;
+  /**
+  * Show a legend listing thresholds below the gauge.
+  * @default false
+  */
+  readonly showLegend?: boolean;
+  /**
+  * Show a numeric readout in the middle of the gauge.
+  * @default true
+  */
+  readonly showValue?: boolean;
+  /**
+  * Overall dimension preset.
+  * @default "medium"
+  */
+  readonly size?: GaugeSize;
+  /**
+  * Color threshold ramp. When provided, segments of the arc are painted in
+  * the corresponding colors and the value readout picks up the color for
+  * the segment `value` lands in.
+  */
+  readonly thresholds?: ReadonlyArray<GaugeThreshold>;
+  /**
+  * Current value. Clamped into the `[min, max]` range.
+  */
+  readonly value: number;
+};
+/**
+* Semi-circular gauge rendered at 2x4 sub-cell resolution. Supports colored
+* threshold segments and an optional needle.
+*/
+declare function Gauge({
+  backgroundColor,
+  formatValue,
+  label,
+  max,
+  min,
+  showLegend,
+  showValue,
+  size,
+  thresholds,
+  value
+}: Props): ReactElement;
+export { Gauge, type Props as GaugeProps, GaugeSize, GaugeThreshold, Props, Gauge as default };

package/dist/components/gauge.js

@@ -0,0 +1 @@
+var Z=Object.defineProperty;var x=(o,e)=>Z(o,"name",{value:e,configurable:!0});import{jsxs as j,jsx as h}from"react/jsx-runtime";import{useMemo as A}from"react";import{c as _}from"../packem_shared/braille-BBjIoaN0.js";import{Box as d}from"./box.js";import{Canvas as $}from"./canvas.js";import{Text as w}from"./text.js";var q=Object.defineProperty,v=x((o,e)=>q(o,"name",{value:e,configurable:!0}),"f");const J={large:{cols:40,rows:10},medium:{cols:24,rows:6},small:{cols:16,rows:4}},R=.9,oo=2,ro=v(o=>String(Math.round(o)),"defaultFormat"),G=v((o,e,s,a)=>{const t=e+(s-e)*a;for(const f of o)if(t<=f.max)return f;return o[o.length-1]},"thresholdAtRatio");function to({backgroundColor:o="gray",formatValue:e=ro,label:s,max:a=100,min:t=0,showLegend:f=!1,showValue:P=!0,size:B="medium",thresholds:n,value:D}){const{cols:O,rows:T}=J[B],F=Math.max(t,Math.min(a,D)),E=a-t||1,M=(F-t)/E,m=A(()=>{if(!(n===void 0||n.length===0))return[...n].toSorted((r,c)=>r.max-c.max)},[n]),I=A(()=>{if(m!==void 0)return G(m,t,a,M)},[m,t,a,M]),H=e(F);return j(d,{flexDirection:"column",children:[h($,{draw:x(r=>{r.clear();const c=r.width*2,L=r.height*4,y=c/2,C=L-1,K=c/2-1,N=L-1,g=Math.max(1,Math.min(K,N)),b=new Map,S=v(i=>{const l=b.get(i);if(l!==void 0)return l;const u=_(r.width,r.height);return b.set(i,u),u},"gridFor"),V=Math.max(32,Math.round(Math.PI*g)*oo);for(let i=0;i<=V;i+=1){const l=i/V,u=Math.PI*(1-l),X=Math.round(y+g*Math.cos(u)),Y=Math.round(C-g*Math.sin(u));let p;l>M?p=o:m?p=G(m,t,a,l)?.color??"cyan":p="cyan",S(p).plotPoint(X,Y)}const k=g*R,z=Math.PI*(1-M),Q=Math.round(y+k*Math.cos(z)),U=Math.round(C-k*Math.sin(z)),W=I?.color??"white";S(W).plotLine(Math.round(y),Math.round(C),Q,U);for(const[i,l]of b)l.flush(r,{color:i})},"draw"),height:T,version:[D,t,a,B,n,o],width:O}),P||s?j(d,{flexDirection:"column",children:[s===void 0?void 0:h(d,{justifyContent:"center",children:h(w,{dimColor:!0,children:s})}),P?h(d,{justifyContent:"center",children:h(w,{bold:!0,color:I?.color??"white",children:H})}):void 0]}):void 0,f&&n&&n.length>0?h(d,{gap:2,justifyContent:"center",marginTop:1,children:n.map((r,c)=>j(d,{gap:1,children:[h(w,{color:r.color,children:"●"}),h(w,{dimColor:!0,children:r.label??`≤ ${r.max}`})]},c))}):void 0]})}x(to,"j");v(to,"Gauge");export{to as Gauge,to as default};

package/dist/components/gradient.d.ts

@@ -0,0 +1,59 @@
+import { ReactNode, ReactElement } from 'react';
+type ColorValueHex = `#${string}`;
+type CssColorName = "aliceblue" | "antiquewhite" | "aqua" | "aquamarine" | "azure" | "beige" | "bisque" | "black" | "blanchedalmond" | "blue" | "blueviolet" | "brown" | "burlywood" | "cadetblue" | "chartreuse" | "chocolate" | "coral" | "cornflowerblue" | "cornsilk" | "crimson" | "cyan" | "darkblue" | "darkcyan" | "darkgoldenrod" | "darkgray" | "darkgreen" | "darkgrey" | "darkkhaki" | "darkmagenta" | "darkolivegreen" | "darkorange" | "darkorchid" | "darkred" | "darksalmon" | "darkseagreen" | "darkslateblue" | "darkslategray" | "darkslategrey" | "darkturquoise" | "darkviolet" | "deeppink" | "deepskyblue" | "dimgray" | "dimgrey" | "dodgerblue" | "firebrick" | "floralwhite" | "forestgreen" | "fuchsia" | "gainsboro" | "ghostwhite" | "gold" | "goldenrod" | "gray" | "green" | "greenyellow" | "grey" | "honeydew" | "hotpink" | "indianred" | "indigo" | "ivory" | "khaki" | "lavender" | "lavenderblush" | "lawngreen" | "lemonchiffon" | "lightblue" | "lightcoral" | "lightcyan" | "lightgoldenrodyellow" | "lightgray" | "lightgreen" | "lightgrey" | "lightpink" | "lightsalmon" | "lightseagreen" | "lightskyblue" | "lightslategray" | "lightslategrey" | "lightsteelblue" | "lightyellow" | "lime" | "limegreen" | "linen" | "magenta" | "maroon" | "mediumaquamarine" | "mediumblue" | "mediumorchid" | "mediumpurple" | "mediumseagreen" | "mediumslateblue" | "mediumspringgreen" | "mediumturquoise" | "mediumvioletred" | "midnightblue" | "mintcream" | "mistyrose" | "moccasin" | "navajowhite" | "navy" | "oldlace" | "olive" | "olivedrab" | "orange" | "orangered" | "orchid" | "palegoldenrod" | "palegreen" | "paleturquoise" | "palevioletred" | "papayawhip" | "peachpuff" | "peru" | "pink" | "plum" | "powderblue" | "purple" | "rebeccapurple" | "red" | "rosybrown" | "royalblue" | "saddlebrown" | "salmon" | "sandybrown" | "seagreen" | "seashell" | "sienna" | "silver" | "skyblue" | "slateblue" | "slategray" | "slategrey" | "snow" | "springgreen" | "steelblue" | "tan" | "teal" | "thistle" | "tomato" | "turquoise" | "violet" | "wheat" | "white" | "whitesmoke" | "yellow" | "yellowgreen";
+type StopInput = {
+  color?: ColorValueHex | CssColorName | RGB | [number, number, number];
+  colorLess?: boolean;
+  position: number;
+};
+type RGB = {
+  b: number;
+  g: number;
+  r: number;
+};
+declare const multilineGradient: (stops: (ColorValueHex | CssColorName | RGB | StopInput | [number, number, number])[], options?: {
+  hsvSpin?: "long" | "short";
+  interpolation?: "hsv" | "rgb";
+  loop?: boolean;
+  reverse?: boolean;
+}) => (string_: string) => string;
+/**
+* A color stop for the gradient — hex string, CSS color name, RGB tuple, RGB object, or positioned stop.
+*/
+type GradientStop = Parameters<typeof multilineGradient>[0][number];
+/**
+* Built-in gradient presets.
+*/
+type GradientName = "atlas" | "cristal" | "fruit" | "instagram" | "mind" | "morning" | "pastel" | "passion" | "rainbow" | "retro" | "summer" | "teen" | "vice";
+/**
+* Custom gradient colors — an array of color stops accepted by `@visulima/colorize`'s gradient API.
+*/
+type GradientColors = GradientStop[];
+type Props = {
+  /**
+  * The content to colorize.
+  *
+  * Multiple `&lt;Text>` children are treated as separate nodes, which preserves layout when `&lt;Gradient>` is placed inside a `&lt;Box flexDirection="column">`.
+  *
+  * If you want a continuous gradient across multiple lines, pass a single string or a single `&lt;Text>` with `\n`.
+  */
+  readonly children: ReactNode;
+  /**
+  * [Colors to use to make the gradient.](https://visulima.com/packages/colorize)
+  *
+  * Mutually exclusive with `name`.
+  */
+  readonly colors?: GradientColors;
+  /**
+  * The name of a built-in gradient preset.
+  *
+  * Mutually exclusive with `colors`.
+  */
+  readonly name?: GradientName;
+};
+declare function Gradient({
+  children,
+  colors,
+  name
+}: Props): ReactElement | null;
+export { Gradient, type GradientColors, type GradientName, type Props as GradientProps, Props, Gradient as default };

package/dist/components/gradient.js

@@ -0,0 +1,4 @@
+var ke=Object.defineProperty;var $=(e,r)=>ke(e,"name",{value:r,configurable:!0});import{jsx as S,Fragment as Oe}from"react/jsx-runtime";import{s as Be}from"../packem_shared/strip-C6HQYmlg.js";import{B as je}from"../packem_shared/colorize-gy_cY-wC.js";import{useMemo as Se,Children as q,isValidElement as he,cloneElement as C}from"react";import{Box as ge}from"./box.js";import{Text as W}from"./text.js";import{Transform as G}from"./transform.js";var xe=Object.defineProperty,Pe=$((e,r)=>xe(e,"name",{value:r,configurable:!0}),"b$3"),Me=Object.defineProperty,Ee=Pe((e,r)=>Me(e,"name",{value:r,configurable:!0}),"s"),Ne=Object.defineProperty,Re=Ee((e,r)=>Ne(e,"name",{value:r,configurable:!0}),"a");const Ae=/([a-f\d]{3,6})/i,I=Re(e=>{let[,r]=Ae.exec(e)??[];const o=r?r.length:0;if(o===3){const t=r.charAt(0),s=r.charAt(1),i=r.charAt(2);r=t+t+s+s+i+i}else if(o!==6)return[0,0,0];const n=Number.parseInt(r,16);return[n>>16&255,n>>8&255,n&255]},"convertHexToRgb");var Te=Object.defineProperty,Ce=$((e,r)=>Te(e,"name",{value:r,configurable:!0}),"o$2"),Ge=Object.defineProperty,qe=Ce((e,r)=>Ge(e,"name",{value:r,configurable:!0}),"s"),Ie=Object.defineProperty,V=qe((e,r)=>Ie(e,"name",{value:r,configurable:!0}),"e");const pe=V((e,r,o)=>e===r&&r===o?e<8?16:e>248?231:Math.round((e-8)/247*24)+232:16+36*Math.round(e/51)+6*Math.round(r/51)+Math.round(o/51),"rgbToAnsi256"),H=V(e=>{let r,o,n;if(e<8)return 30+e;if(e<16)return 90+(e-8);if(e>=232)r=o=n=((e-232)*10+8)/255;else{e-=16;const i=e%36;r=Math.floor(e/36)/5,o=Math.floor(i/6)/5,n=i%6/5}const t=Math.max(r,o,n)*2;if(t===0)return 30;const s=30+(Math.round(n)<<2|Math.round(o)<<1|Math.round(r));return t===2?s+60:s},"ansi256To16"),Z=V((e,r,o)=>H(pe(e,r,o)),"rgbToAnsi16");var He=Object.defineProperty,fe=$((e,r)=>He(e,"name",{value:r,configurable:!0}),"m$2"),ze=Object.defineProperty,B=fe((e,r)=>ze(e,"name",{value:r,configurable:!0}),"u"),Fe=Object.defineProperty,Le=B((e,r)=>Fe(e,"name",{value:r,configurable:!0}),"e");function A({onlyFirst:e=!1}={}){const r="(?:\\u001B\\][\\s\\S]*?(?:\\u0007|\\u001B\\u005C|\\u009C))|[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]";return new RegExp(r,e?void 0:"g")}$(A,"$$1");fe(A,"j");B(A,"t$1");Le(A,"ansiRegex");var De=Object.defineProperty,Ke=B((e,r)=>De(e,"name",{value:r,configurable:!0}),"n$1");const k=Ke((e,r,o)=>r>e?r:Math.min(e,o),"clamp");var Ye=Object.defineProperty,m=B((e,r)=>Ye(e,"name",{value:r,configurable:!0}),"b");const b=39,d=49,J=10,z=je(),be={close:"",open:""},a=z>0?(e,r)=>({close:`\x1B[${String(r)}m`,open:`\x1B[${String(e)}m`}):()=>be,Q=m(e=>(r,o,n)=>e(pe(Number(r),Number(o),Number(n))),"createRgbFunction"),U=m(e=>r=>{const[o,n,t]=I(r);return e(o,n,t)},"createHexFunction");let F=m(e=>a(`38;5;${String(e)}`,b),"createAnsi256"),L=m(e=>a(`48;5;${String(e)}`,d),"createBgAnsi256"),N=m((e,r,o)=>a(`38;2;${String(e)};${String(r)};${String(o)}`,b),"createRgb"),R=m((e,r,o)=>a(`48;2;${String(e)};${String(r)};${String(o)}`,d),"createBgRgb");z===1?(F=m(e=>a(H(Number(e)),b),"createAnsi256"),L=m(e=>a(H(Number(e))+J,d),"createBgAnsi256"),N=m((e,r,o)=>a(Z(Number(e),Number(r),Number(o)),b),"createRgb"),R=m((e,r,o)=>a(Z(Number(e),Number(r),Number(o))+J,d),"createBgRgb")):z===2&&(N=Q(F),R=Q(L));const X={bold:a(1,22),dim:a(2,22),hidden:a(8,28),inverse:a(7,27),italic:a(3,23),overline:a(53,55),reset:a(0,0),strike:a(9,29),strikethrough:a(9,29),underline:a(4,24),visible:be},_={bgBlack:a(40,d),bgBlackBright:a(100,d),bgBlue:a(44,d),bgBlueBright:a(104,d),bgCyan:a(46,d),bgCyanBright:a(106,d),bgGray:a(100,d),bgGreen:a(42,d),bgGreenBright:a(102,d),bgGrey:a(100,d),bgMagenta:a(45,d),bgMagentaBright:a(105,d),bgRed:a(41,d),bgRedBright:a(101,d),bgWhite:a(47,d),bgWhiteBright:a(107,d),bgYellow:a(43,d),bgYellowBright:a(103,d),black:a(30,b),blackBright:a(90,b),blue:a(34,b),blueBright:a(94,b),cyan:a(36,b),cyanBright:a(96,b),gray:a(90,b),green:a(32,b),greenBright:a(92,b),grey:a(90,b),magenta:a(35,b),magentaBright:a(95,b),red:a(31,b),redBright:a(91,b),white:a(37,b),whiteBright:a(97,b),yellow:a(33,b),yellowBright:a(93,b)},ee={bg:m(e=>L(k(e,0,255)),"bg"),bgHex:U(R),bgRgb:m((e,r,o)=>R(k(e,0,255),k(r,0,255),k(o,0,255)),"bgRgb"),fg:m(e=>F(k(e,0,255)),"fg"),hex:U(N),rgb:m((e,r,o)=>N(k(e,0,255),k(r,0,255),k(o,0,255)),"rgb")};var Ve=Object.defineProperty,We=B((e,r)=>Ve(e,"name",{value:r,configurable:!0}),"s");const Ze=We((e,r,o)=>{if(r==="")return e;let n=e.indexOf(r);if(n<0)return e;const t=r.length;let s=0,i="";for(;~n;)i+=e.slice(s,n)+o,s=n+t,n=e.indexOf(r,s);return i+e.slice(s)},"stringReplaceAll");var Je=Object.defineProperty,x=B((e,r)=>Je(e,"name",{value:r,configurable:!0}),"a");const O={};let D=null;const Qe=x((e,r,o)=>{if(!e)return"";let n;if(e.raw===void 0?n=String(e):n=String.raw(e,...r),n.includes("\x1B"))for(let t=o;t;t=t.props)n=Ze(n,t.close,t.open);return n.includes(`
+`)&&(n=n.replace(/(\r*\n)/g,`${o.closeStack}$1${o.openStack}`)),o.openStack+n+o.closeStack},"wrapText"),K=x(({props:e},{close:r,open:o})=>{const n=(e?.openStack??"")+o,t=r+(e?.closeStack??""),s=x((i,...u)=>Qe(i,u,s.props),"style");return Object.setPrototypeOf(s,D),s.props={close:r,closeStack:t,open:o,openStack:n,props:e},s.open=n,s.close=t,s},"createStyle"),Ue=x(function(){const e=x(r=>String(r),"self");e.strip=r=>r.replaceAll(A(),"");for(const r in _)O[r]={get(){const o=K(this,_[r]);return Object.defineProperty(this,r,{value:o}),o}};for(const r in X)O[r]={get(){const o=K(this,X[r]);return Object.defineProperty(this,r,{value:o}),o}};return D=Object.defineProperties({},O),Object.setPrototypeOf(e,D),e},"Colorize");for(const e in ee)O[e]={get(){return(...r)=>K(this,ee[e](...r))}};O.ansi256=O.fg;O.bgAnsi256=O.bg;var Xe=Object.defineProperty,de=$((e,r)=>Xe(e,"name",{value:r,configurable:!0}),"y$1"),_e=Object.defineProperty,j=de((e,r)=>_e(e,"name",{value:r,configurable:!0}),"u");const re={aliceblue:[240,248,255],antiquewhite:[250,235,215],aqua:[0,255,255],aquamarine:[127,255,212],azure:[240,255,255],beige:[245,245,220],bisque:[255,228,196],black:[0,0,0],blanchedalmond:[255,235,205],blue:[0,0,255],blueviolet:[138,43,226],brown:[165,42,42],burlywood:[222,184,135],cadetblue:[95,158,160],chartreuse:[127,255,0],chocolate:[210,105,30],coral:[255,127,80],cornflowerblue:[100,149,237],cornsilk:[255,248,220],crimson:[220,20,60],cyan:[0,255,255],darkblue:[0,0,139],darkcyan:[0,139,139],darkgoldenrod:[184,134,11],darkgray:[169,169,169],darkgreen:[0,100,0],darkgrey:[169,169,169],darkkhaki:[189,183,107],darkmagenta:[139,0,139],darkolivegreen:[85,107,47],darkorange:[255,140,0],darkorchid:[153,50,204],darkred:[139,0,0],darksalmon:[233,150,122],darkseagreen:[143,188,143],darkslateblue:[72,61,139],darkslategray:[47,79,79],darkslategrey:[47,79,79],darkturquoise:[0,206,209],darkviolet:[148,0,211],deeppink:[255,20,147],deepskyblue:[0,191,255],dimgray:[105,105,105],dimgrey:[105,105,105],dodgerblue:[30,144,255],firebrick:[178,34,34],floralwhite:[255,250,240],forestgreen:[34,139,34],fuchsia:[255,0,255],gainsboro:[220,220,220],ghostwhite:[248,248,255],gold:[255,215,0],goldenrod:[218,165,32],gray:[128,128,128],green:[0,128,0],greenyellow:[173,255,47],grey:[128,128,128],honeydew:[240,255,240],hotpink:[255,105,180],indianred:[205,92,92],indigo:[75,0,130],ivory:[255,255,240],khaki:[240,230,140],lavender:[230,230,250],lavenderblush:[255,240,245],lawngreen:[124,252,0],lemonchiffon:[255,250,205],lightblue:[173,216,230],lightcoral:[240,128,128],lightcyan:[224,255,255],lightgoldenrodyellow:[250,250,210],lightgray:[211,211,211],lightgreen:[144,238,144],lightgrey:[211,211,211],lightpink:[255,182,193],lightsalmon:[255,160,122],lightseagreen:[32,178,170],lightskyblue:[135,206,250],lightslategray:[119,136,153],lightslategrey:[119,136,153],lightsteelblue:[176,196,222],lightyellow:[255,255,224],lime:[0,255,0],limegreen:[50,205,50],linen:[250,240,230],magenta:[255,0,255],maroon:[128,0,0],mediumaquamarine:[102,205,170],mediumblue:[0,0,205],mediumorchid:[186,85,211],mediumpurple:[147,112,219],mediumseagreen:[60,179,113],mediumslateblue:[123,104,238],mediumspringgreen:[0,250,154],mediumturquoise:[72,209,204],mediumvioletred:[199,21,133],midnightblue:[25,25,112],mintcream:[245,255,250],mistyrose:[255,228,225],moccasin:[255,228,181],navajowhite:[255,222,173],navy:[0,0,128],oldlace:[253,245,230],olive:[128,128,0],olivedrab:[107,142,35],orange:[255,165,0],orangered:[255,69,0],orchid:[218,112,214],palegoldenrod:[238,232,170],palegreen:[152,251,152],paleturquoise:[175,238,238],palevioletred:[219,112,147],papayawhip:[255,239,213],peachpuff:[255,218,185],peru:[205,133,63],pink:[255,192,203],plum:[221,160,221],powderblue:[176,224,230],purple:[128,0,128],rebeccapurple:[102,51,153],red:[255,0,0],rosybrown:[188,143,143],royalblue:[65,105,225],saddlebrown:[139,69,19],salmon:[250,128,114],sandybrown:[244,164,96],seagreen:[46,139,87],seashell:[255,245,238],sienna:[160,82,45],silver:[192,192,192],skyblue:[135,206,235],slateblue:[106,90,205],slategray:[112,128,144],slategrey:[112,128,144],snow:[255,250,250],springgreen:[0,255,127],steelblue:[70,130,180],tan:[210,180,140],teal:[0,128,128],thistle:[216,191,216],tomato:[255,99,71],turquoise:[64,224,208],violet:[238,130,238],wheat:[245,222,179],white:[255,255,255],whitesmoke:[245,245,245],yellow:[255,255,0],yellowgreen:[154,205,50]};var er=Object.defineProperty,rr=j((e,r)=>er(e,"name",{value:r,configurable:!0}),"i");const oe=rr((e,r)=>{const o=e.length;if(r=Number.parseInt(r.toString(),10),Number.isNaN(r)||r<2)throw new Error("Invalid number of steps (< 2)");if(r<o)throw new Error("Number of steps cannot be inferior to number of stops");const n=[];for(let s=1;s<o;s+=1){const i=(r-1)*(e[s].position-e[s-1].position);n.push(Math.max(1,Math.round(i)))}let t=1;for(let s=o-2;s>=0;s-=1)t+=n[s];for(;t!==r;)if(t<r){const s=Math.min(...n),i=n.indexOf(s);n[i]=n[i]+1,t+=1}else{const s=Math.max(...n),i=n.indexOf(s);n[i]=n[i]-1,t-=1}return n},"computeSubSteps");var or=Object.defineProperty,tr=j((e,r)=>or(e,"name",{value:r,configurable:!0}),"c$1");const nr=tr((e,r,o)=>{let n=0,t=0,s=0;const i=Math.floor(e/60),u=e/60-i,c=o*(1-r),h=o*(1-u*r),l=o*(1-(1-u)*r);return i%6===0?(n=o,t=l,s=c):i%6===1?(n=h,t=o,s=c):i%6===2?(n=c,t=o,s=l):i%6===3?(n=c,t=h,s=o):i%6===4?(n=l,t=c,s=o):i%6===5&&(n=o,t=c,s=h),{b:Math.round(s*255),g:Math.round(t*255),r:Math.round(n*255)}},"hsvToRgb");var sr=Object.defineProperty,te=j((e,r)=>sr(e,"name",{value:r,configurable:!0}),"b");const ne=te(({b:e,g:r,r:o})=>{let n,t,s,i=0,u=0;o/=255,r/=255,e/=255;const c=Math.max(o,r,e),h=c-Math.min(o,r,e),l=te(p=>(c-p)/6/h+1/2,"diffc");return h!==0&&(u=h/c,n=l(o),t=l(r),s=l(e),c===o?i=s-t:c===r?i=.3333333333333333+n-s:c===e&&(i=.6666666666666666+t-n),i<0?i+=1:i>1&&(i-=1)),{h:i*360,s:u,v:c}},"rgbToHsv");var ir=Object.defineProperty,T=j((e,r)=>ir(e,"name",{value:r,configurable:!0}),"c");const ar={b:256,g:256,r:256},lr={h:360,s:1,v:1},me=T((e,r,o)=>{const n={};for(const t in e)Object.hasOwn(e,t)&&(n[t]=o===0?0:(r[t]-e[t])/o);return n},"calculateStepSize"),ve=T((e,r,o,n)=>{const t={};for(const s in r)if(Object.hasOwn(r,s)){let i=e[s]*o+r[s];i<0?i+=n[s]:n[s]!==1&&(i%=n[s]),t[s]=i}return t},"interpolate"),Y=T((e,r,o)=>{const n={b:e.color[2],g:e.color[1],r:e.color[0]},t={b:r.color[2],g:r.color[1],r:r.color[0]},s=me(n,t,o),i=[{...n}];for(let u=1;u<o;u+=1){const c=ve(s,n,u,ar);i.push({b:Math.floor(c.b),g:Math.floor(c.g),r:Math.floor(c.r)})}return i},"interpolateRgb"),se=T((e,r,o,n)=>{const t=ne({b:e.color[2],g:e.color[1],r:e.color[0]}),s=ne({b:r.color[2],g:r.color[1],r:r.color[0]});if(t.s===0||s.s===0)return Y(e,r,o);let i;if(typeof n=="boolean")i=n;else{const l=t.h<s.h&&s.h-t.h<180||t.h>s.h&&t.h-s.h>180;i=n==="long"&&l||n==="short"&&!l}const u=me(t,s,o),c=[{b:e.color[2],g:e.color[1],r:e.color[0]}];let h;t.h<=s.h&&!i||t.h>=s.h&&i?h=s.h-t.h:i?h=360-s.h+t.h:h=360-t.h+s.h,u.h=(-1)**(i?1:0)*Math.abs(h)/o;for(let l=1;l<o;l+=1){const p=ve(u,t,l,lr);c.push(nr(p.h,p.s,p.v))}return c},"interpolateHsv");var cr=Object.defineProperty,ur=j((e,r)=>cr(e,"name",{value:r,configurable:!0}),"d");class P{static{$(this,"f")}static{de(this,"v")}static{j(this,"GradientBuilder")}static{ur(this,"GradientBuilder")}#e;stops;constructor(r,o){if(this.#e=r,this.stops=[],o.length<2)throw new Error("Invalid number of stops (< 2)");const n=o[0].position!==void 0;let t=o.length,s=-1,i=!1;for(const[h,l]of o.entries()){let p;const w=l.position!==void 0;if(n!==w)throw new Error("Cannot mix positioned and non-positioned color stops");if(w){const f=l,g=f.color!==void 0;if(!g&&(i||h===0||h===t-1))throw new Error("Cannot define two consecutive position-only stops");i=!g;let v;if(g&&(Array.isArray(f.color)?v=f.color:typeof f.color=="string"?v=f.color.includes("#")?I(f.color):re[f.color]:f.color&&"r"in f.color&&"g"in f.color&&"b"in f.color&&(v=[f.color.r,f.color.g,f.color.b])),p={color:v,colorLess:!g,position:f.position},p.position<0||p.position>1)throw new Error("Color stops positions must be between 0 and 1");if(p.position<s)throw new Error("Color stops positions are not ordered");s=p.position}else if(Array.isArray(l))p={color:l,position:h/(t-1)};else if(typeof l=="string")p={color:l.includes("#")?I(l):re[l],position:h/(t-1)};else if(l?.r!==void 0&&l?.g!==void 0&&l?.b!==void 0)p={color:[l.r,l.g,l.b],position:h/(t-1)};else throw new Error("Invalid color stop");this.stops.push(p)}const u=this.stops[0];u.position!==0&&(this.stops.unshift({color:u.color,position:0}),t+=1);const c=this.stops[t-1];c.position!==1&&this.stops.push({color:c.color,position:1})}reverse(){const r=[];for(const o of this.stops){const n={...o,position:1-o.position};r.push(n)}return new P(this.#e,r.toReversed())}loop(){const r=[],o=[];for(const n of this.stops)r.push({color:n.color,position:(n.position||0)/2});for(const n of this.stops.slice(0,-1))o.push({color:n.color,position:1-(n.position||0)/2});return new P(this.#e,[...r,...o.toReversed()])}rgb(r){const o=oe(this.stops,r),n=[];this.stops.forEach((t,s)=>{if(t.colorLess){const i=Y(this.stops[s-1],this.stops[s+1],2);t.color=[i[1].r,i[1].g,i[1].b]}});for(let t=0,s=this.stops.length;t<s-1;t+=1){const i=Y(this.stops[t],this.stops[t+1],o[t]);n.splice(n.length,0,...i.map(u=>this.#e.rgb(u.r,u.g,u.b)))}return n.push(this.#e.rgb(...this.stops.at(-1).color)),n}hsv(r,o=!1){const n=oe(this.stops,r),t=[];this.stops.forEach((s,i)=>{if(s.colorLess){const u=se(this.stops[i-1],this.stops[i+1],2,o);s.color=[u[1].r,u[1].g,u[1].b]}});for(let s=0,i=this.stops.length;s<i-1;s+=1){const u=se(this.stops[s],this.stops[s+1],n[s],o);t.splice(t.length,0,...u.map(c=>this.#e.rgb(c.r,c.g,c.b)))}return t.push(this.#e.rgb(...this.stops.at(-1).color)),t}}var hr=Object.defineProperty,gr=$((e,r)=>hr(e,"name",{value:r,configurable:!0}),"u"),pr=Object.defineProperty,fr=gr((e,r)=>pr(e,"name",{value:r,configurable:!0}),"u"),br=Object.defineProperty,ye=fr((e,r)=>br(e,"name",{value:r,configurable:!0}),"h");const we=new Ue,dr=/\s/g,$e=/\s/;ye((e,r)=>{const{hsvSpin:o="short",interpolation:n="rgb"}=r??{};let t=new P(we,e);return r?.loop?t=t.loop():r?.reverse&&(t=t.reverse()),s=>{const i=s.replaceAll(dr,""),u=Math.max(i.length,t.stops.length),c=n==="rgb"?t.rgb(u):t.hsv(u,o);let h="";for(const l of s)if($e.test(l))h+=l;else{const p=c.shift();h+=p(l)}return h}},"gradient");const ie=ye((e,r)=>{const{hsvSpin:o="short",interpolation:n="rgb"}=r??{};let t=new P(we,e);return r?.loop?t=t.loop():r?.reverse&&(t=t.reverse()),s=>{const i=s.split(`
+`),u=Reflect.apply(Math.max,void 0,[...i.map(l=>l.length),t.stops.length]),c=n==="rgb"?t.rgb(u):t.hsv(u,o),h=[];for(const l of i){const p=[...c];let w="";for(const f of l)w+=$e.test(f)?f:p.shift()(f);h.push(w)}return h.join(`
+`)}},"multilineGradient");var mr=Object.defineProperty,y=$((e,r)=>mr(e,"name",{value:r,configurable:!0}),"o");const ae={atlas:{colors:["#feac5e","#c779d0","#4bc0c8"]},cristal:{colors:["#bdfff3","#4ac29a"]},fruit:{colors:["#ff4e50","#f9d423"]},instagram:{colors:["#833ab4","#fd1d1d","#fcb045"]},mind:{colors:["#473b7b","#3584a7","#30d2be"]},morning:{colors:["#ff5f6d","#ffc371"],options:{interpolation:"hsv"}},passion:{colors:["#f43b47","#453a94"]},pastel:{colors:["#74ebd5","#74ecd5"],options:{hsvSpin:"long",interpolation:"hsv"}},rainbow:{colors:["#ff0000","#ff0100"],options:{hsvSpin:"long",interpolation:"hsv"}},retro:{colors:["#3f51b1","#5a55ae","#7b5fac","#8f6aae","#a86aa4","#cc6b8e","#f18271","#f3a469","#f7c978"]},summer:{colors:["#fdbb2d","#22c1c3"]},teen:{colors:["#77a1d3","#79cbca","#e684ae"]},vice:{colors:["#5ee7df","#b490ca"],options:{interpolation:"hsv"}}},le=y(e=>{let r=!1;const o=y(n=>{q.forEach(n,t=>{if(r||!he(t))return;if(t.type===ge){r=!0;return}const s=t.props;Object.hasOwn(s,"children")&&o(s.children)})},"search");return o(e),r},"containsBoxDescendant"),ce=y(e=>Object.hasOwn(e,"children"),"hasChildrenProp"),ue=y(e=>typeof e=="string"||typeof e=="number","isPlainTextNode"),vr=y(e=>e==null||typeof e=="boolean","isNonRenderableChild");function yr({children:e,colors:r,name:o}){if(o&&r)throw new Error("The `name` and `colors` props are mutually exclusive");if(!o&&!r)throw new Error("Either `name` or `colors` prop must be provided");const n=Se(()=>o?ie(ae[o].colors,ae[o].options):ie(r??[]),[o,r]),t=y(u=>n(Be(u)),"applyGradient"),s=q.count(e);if(ue(e))return S(G,{transform:t,children:e});if(s===1&&!le(e))return S(G,{transform:t,children:e});const i=y(u=>{const c=[];let h="",l=0;const p=y(()=>{const g=`gradient-node-${String(l)}`;return l+=1,g},"createKey"),w=y((g,v)=>{c.push(S(G,{transform:t,children:g},v))},"pushTransformed"),f=y(()=>{if(h==="")return;const g=h;h="",w(S(W,{children:g}),p())},"flushText");return q.forEach(u,g=>{if(!vr(g)){if(ue(g)){h+=String(g);return}if(f(),he(g)){const v=g.key??p(),M=g.props;if(g.type===W){w(g,v);return}if(g.type===ge){if(ce(M)){const E=M.children;c.push(C(g,{key:v},i(E)));return}c.push(C(g,{key:v}));return}if(ce(M)){const E=M.children;if(!le(E)){w(g,v);return}c.push(C(g,{key:v},i(E)));return}w(g,v);return}c.push(g)}}),f(),c},"applyGradientToChildren");return S(Oe,{children:i(e)})}$(yr,"K");y(yr,"Gradient");export{yr as Gradient,yr as default};

package/dist/components/heading.d.ts

@@ -0,0 +1,33 @@
+import { A as AnsiColors } from "../packem_shared/index.server.d-eZWyC2Ku.js";
+import { ReactNode, ReactElement } from 'react';
+import { LiteralUnion } from 'type-fest';
+type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+type Props = {
+  /**
+  * Heading content.
+  */
+  readonly children: ReactNode;
+  /**
+  * Explicit color. By default the color is derived from the level.
+  */
+  readonly color?: LiteralUnion<AnsiColors, string>;
+  /**
+  * Heading level controls decoration and color.
+  * @default 1
+  */
+  readonly level?: HeadingLevel;
+  /**
+  * When true, renders an underline on a second line.
+  */
+  readonly underline?: boolean;
+};
+/**
+* Semantic heading with level-based styling.
+*/
+declare function Heading({
+  children,
+  color,
+  level,
+  underline
+}: Props): ReactElement;
+export { Heading, HeadingLevel, type Props as HeadingProps, Props, Heading as default };

package/dist/components/heading.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var o=(e,r)=>l(e,"name",{value:r,configurable:!0});import{jsx as a,jsxs as c}from"react/jsx-runtime";import{Box as s}from"./box.js";import{Text as d}from"./text.js";var u=Object.defineProperty,f=o((e,r)=>u(e,"name",{value:r,configurable:!0}),"t");const g={1:"blueBright",2:"cyanBright",3:"magentaBright",4:"yellowBright",5:"green",6:"white"},m={1:"# ",2:"## ",3:"### ",4:"#### ",5:"##### ",6:"###### "};function h({children:e,color:r,level:n=1,underline:t=!1}){const i=r??g[n];return a(s,{flexDirection:"column",children:c(d,{bold:n<=2,color:i,underline:t,children:[m[n],e]})})}o(h,"n");f(h,"Heading");export{h as Heading,h as default};

package/dist/components/heatmap.d.ts

@@ -0,0 +1,62 @@
+import { A as AnsiColors } from "../packem_shared/index.server.d-eZWyC2Ku.js";
+import { ReactElement } from 'react';
+import { LiteralUnion } from 'type-fest';
+type HeatmapProps = {
+  /**
+  * Width of each cell in character columns.
+  * @default 2
+  */
+  readonly cellWidth?: number;
+  /**
+  * Glyph used to paint each heatmap cell. Defaults to `█` so the
+  * background color fills the cell.
+  * @default "█" (full block)
+  */
+  readonly character?: string;
+  /**
+  * Column labels rendered below the grid.
+  */
+  readonly columnLabels?: ReadonlyArray<string>;
+  /**
+  * 2D matrix, rows × cols.
+  */
+  readonly data: ReadonlyArray<ReadonlyArray<number>>;
+  /**
+  * Fixed maximum (for consistent scales across multiple heatmaps).
+  */
+  readonly max?: number;
+  /**
+  * Fixed minimum.
+  */
+  readonly min?: number;
+  /**
+  * Color palette, lowest-to-highest intensity. Values are mapped into the
+  * palette by their position in the [min, max] range.
+  * @default ["#0b1e4f", "#1f3b96", "#3258c8", "#4e84ec", "#78b0ff"]
+  */
+  readonly palette?: ReadonlyArray<string>;
+  /**
+  * Row labels rendered to the left of the grid.
+  */
+  readonly rowLabels?: ReadonlyArray<string>;
+  /**
+  * Foreground color override (rarely needed since the character is a full block).
+  */
+  readonly textColor?: LiteralUnion<AnsiColors, string>;
+};
+/**
+* 2D heatmap. Each cell's background color is derived from its value's
+* position in the [min, max] range mapped into `palette`.
+*/
+declare function Heatmap({
+  cellWidth,
+  character,
+  columnLabels,
+  data,
+  max: maxOverride,
+  min: minOverride,
+  palette,
+  rowLabels,
+  textColor
+}: HeatmapProps): ReactElement;
+export { Heatmap, HeatmapProps, Heatmap as default };

package/dist/components/heatmap.js

@@ -0,0 +1 @@
+var T=Object.defineProperty;var v=(r,l)=>T(r,"name",{value:l,configurable:!0});import{jsxs as j,jsx as c}from"react/jsx-runtime";import{useMemo as k}from"react";import{Box as s}from"./box.js";import{Canvas as B}from"./canvas.js";import{Text as y}from"./text.js";var E=Object.defineProperty,O=v((r,l)=>E(r,"name",{value:l,configurable:!0}),"A");const P=["#0b1e4f","#1f3b96","#3258c8","#4e84ec","#78b0ff"];function R({cellWidth:r=2,character:l="█",columnLabels:g,data:n,max:d,min:m,palette:x=P,rowLabels:w,textColor:D}){const{cols:C,colWidth:f,extent:L,rows:p}=k(()=>{const t=n.length,e=n.reduce((a,o)=>Math.max(a,o.length),0);let i=m??1/0,h=d??-1/0;if(m===void 0||d===void 0)for(const a of n)for(const o of a)m===void 0&&o<i&&(i=o),d===void 0&&o>h&&(h=o);return{cols:e,colWidth:r,extent:{max:h,min:i},rows:t}},[n,m,d,r]),W=C*f,A=p;return j(s,{children:[w===void 0?void 0:c(s,{flexDirection:"column",marginRight:1,children:Array.from({length:p},(t,e)=>c(y,{dimColor:!0,children:w[e]??""},e))}),j(s,{flexDirection:"column",children:[c(B,{draw:v(t=>{t.clear();const{max:e,min:i}=L,h=e-i||1,a=x.length-1;for(let o=0;o<p;o+=1)for(let u=0;u<C;u+=1){const M=n[o]?.[u],H=M===void 0?void 0:x[Math.max(0,Math.min(a,Math.round((M-i)/h*a)))];for(let b=0;b<f;b+=1)t.setCell(u*f+b,o,l,{background:H,color:D})}},"draw"),height:A,version:[n,x,r,m,d],width:W}),g===void 0?void 0:c(s,{children:g.map((t,e)=>c(s,{width:f,children:c(y,{dimColor:!0,wrap:"truncate-end",children:t})},e))})]})]})}v(R,"T");O(R,"Heatmap");export{R as Heatmap,R as default};