@solid-tui/runtime 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 solid-tui contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# @solid-tui/runtime
+
+Core Solid renderer and terminal primitives for `solid-tui`.
+
+## Install
+
+```sh
+npm install @solid-tui/runtime solid-js
+```
+
+## Usage
+
+```tsx
+import { Box, Text, createApp } from "@solid-tui/runtime";
+
+function App() {
+  return (
+    <Box>
+      <Text>Hello from solid-tui</Text>
+    </Box>
+  );
+}
+
+createApp(App).mount();
+```
+
+For Vite-based apps with HMR and production builds, use `@solid-tui/vite`.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,317 @@
+import { $ as createSignal, B as Accessor, E as kittyModifiers, G as batch, H as JSX, J as createContext, K as catchError, Q as createRoot, S as KittyKeyboardOptions, T as kittyFlags, U as JSXElement, V as Component, W as Setter, X as createMemo, Y as createEffect, Z as createRenderEffect, _ as TuiApp, b as KittyFlagName, et as on, f as RenderToStringOptions, g as MountOptions, it as useContext, j as TuiNode, nt as splitProps, p as renderToString, q as children, rt as untrack, tt as onCleanup, v as createApp, z as CursorPosition } from "./internal-BBq9eUYH.mjs";
+import cliBoxes from "cli-boxes";
+import { JSX as JSX$1 } from "solid-js";
+
+//#region src/renderer.d.ts
+declare const createElement: (tag: string) => TuiNode;
+declare const createTextNode: (value: string) => TuiNode;
+declare const insertNode: (parent: TuiNode, node: TuiNode, anchor?: TuiNode | undefined) => void;
+declare const insert: <T>(parent: TuiNode, accessor: T | (() => T), marker?: TuiNode | null | undefined, initial?: unknown) => TuiNode;
+declare const spread: <T>(node: TuiNode, accessor: T | (() => T), skipChildren?: boolean) => void;
+declare const setProp: <T>(node: TuiNode, name: string, value: T, prev?: T | undefined) => T;
+declare const mergeProps: (...sources: unknown[]) => unknown;
+declare const effect: <T>(fn: (prev?: T) => T, init?: T) => void;
+declare const memo: <T>(fn: () => T, equal?: boolean) => () => T;
+declare const createComponent: <T>(component: (props: T) => unknown, props: T) => JSX$1.Element;
+declare const use: <A, T>(fn: (element: TuiNode, arg: A) => T, element: TuiNode, arg: A) => T;
+//#endregion
+//#region src/components/box-props.d.ts
+type Spacing = number;
+type FlexDirection = "row" | "row-reverse" | "column" | "column-reverse";
+type FlexWrap = "nowrap" | "wrap" | "wrap-reverse";
+type Align = "flex-start" | "center" | "flex-end" | "stretch" | "baseline";
+type AlignSelf = "auto" | "flex-start" | "center" | "flex-end" | "stretch" | "baseline";
+type AlignContent = "flex-start" | "center" | "flex-end" | "stretch" | "space-between" | "space-around" | "space-evenly";
+type Justify = "flex-start" | "center" | "flex-end" | "space-between" | "space-around" | "space-evenly";
+type BorderStyle = "single" | "double" | "round" | "bold" | "singleDouble" | "doubleSingle" | "classic" | "arrow";
+type BoxStyle = (typeof cliBoxes)[keyof cliBoxes.Boxes];
+type AriaRole = "button" | "checkbox" | "combobox" | "list" | "listbox" | "listitem" | "menu" | "menuitem" | "option" | "progressbar" | "radio" | "radiogroup" | "tab" | "tablist" | "table" | "textbox" | "timer" | "toolbar";
+interface AriaState {
+  busy?: boolean;
+  checked?: boolean;
+  disabled?: boolean;
+  expanded?: boolean;
+  multiline?: boolean;
+  multiselectable?: boolean;
+  readonly?: boolean;
+  required?: boolean;
+  selected?: boolean;
+}
+interface BoxProps {
+  children?: JSX.Element;
+  ref?: (node: unknown) => void;
+  flexDirection?: FlexDirection;
+  flexGrow?: number;
+  flexShrink?: number;
+  flexBasis?: number | string;
+  flexWrap?: FlexWrap;
+  alignItems?: Align;
+  alignSelf?: AlignSelf;
+  justifyContent?: Justify;
+  gap?: number;
+  columnGap?: number;
+  rowGap?: number;
+  width?: number | string;
+  height?: number | string;
+  minWidth?: number | string;
+  minHeight?: number | string;
+  maxWidth?: number | string;
+  maxHeight?: number | string;
+  aspectRatio?: number;
+  alignContent?: AlignContent;
+  position?: "absolute" | "relative" | "static";
+  top?: number | string;
+  right?: number | string;
+  bottom?: number | string;
+  left?: number | string;
+  margin?: Spacing;
+  marginX?: number;
+  marginY?: number;
+  marginTop?: number;
+  marginBottom?: number;
+  marginLeft?: number;
+  marginRight?: number;
+  padding?: number;
+  paddingX?: number;
+  paddingY?: number;
+  paddingTop?: number;
+  paddingBottom?: number;
+  paddingLeft?: number;
+  paddingRight?: number;
+  borderStyle?: BorderStyle | BoxStyle;
+  borderColor?: string;
+  borderDimColor?: boolean;
+  borderTopDimColor?: boolean;
+  borderBottomDimColor?: boolean;
+  borderLeftDimColor?: boolean;
+  borderRightDimColor?: boolean;
+  borderTop?: boolean;
+  borderBottom?: boolean;
+  borderLeft?: boolean;
+  borderRight?: boolean;
+  borderTopColor?: string;
+  borderBottomColor?: string;
+  borderLeftColor?: string;
+  borderRightColor?: string;
+  borderBackgroundColor?: string;
+  borderTopBackgroundColor?: string;
+  borderBottomBackgroundColor?: string;
+  borderLeftBackgroundColor?: string;
+  borderRightBackgroundColor?: string;
+  backgroundColor?: string;
+  overflow?: "visible" | "hidden";
+  overflowX?: "visible" | "hidden";
+  overflowY?: "visible" | "hidden";
+  display?: "flex" | "none";
+  ariaLabel?: string;
+  ariaHidden?: boolean;
+  ariaRole?: AriaRole;
+  ariaState?: AriaState;
+}
+type BoxLayoutStyle = Pick<BoxProps, "flexDirection" | "flexGrow" | "flexShrink" | "flexBasis" | "flexWrap" | "alignItems" | "alignSelf" | "justifyContent" | "gap" | "columnGap" | "rowGap" | "width" | "height" | "minWidth" | "minHeight" | "maxWidth" | "maxHeight" | "aspectRatio" | "alignContent" | "position" | "top" | "right" | "bottom" | "left" | "margin" | "marginX" | "marginY" | "marginTop" | "marginBottom" | "marginLeft" | "marginRight" | "padding" | "paddingX" | "paddingY" | "paddingTop" | "paddingBottom" | "paddingLeft" | "paddingRight" | "overflow" | "overflowX" | "overflowY" | "display">;
+//#endregion
+//#region src/components/box.d.ts
+declare function Box(props: BoxProps): JSX.Element;
+//#endregion
+//#region src/components/text-props.d.ts
+type WrapMode = "wrap" | "hard" | "truncate" | "truncate-end" | "truncate-middle" | "truncate-start";
+interface TextProps {
+  children?: JSX.Element;
+  ref?: (node: unknown) => void;
+  color?: string;
+  backgroundColor?: string;
+  dimColor?: boolean;
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+  strikethrough?: boolean;
+  inverse?: boolean;
+  wrap?: WrapMode;
+  ariaLabel?: string;
+  ariaHidden?: boolean;
+}
+//#endregion
+//#region src/components/text.d.ts
+declare function Text(props: TextProps): JSX.Element;
+//#endregion
+//#region src/components/newline-props.d.ts
+interface NewlineProps {
+  count?: number;
+}
+//#endregion
+//#region src/components/newline.d.ts
+declare function Newline(props: NewlineProps): TuiNode;
+//#endregion
+//#region src/components/spacer-props.d.ts
+interface SpacerProps {
+  children?: never;
+}
+//#endregion
+//#region src/components/spacer.d.ts
+declare function Spacer(_props: SpacerProps): TuiNode;
+//#endregion
+//#region src/components/static-props.d.ts
+interface StaticSlotProps<T = unknown> {
+  item: T;
+  index: number;
+}
+type StaticSlot<T = unknown> = (props: StaticSlotProps<T>) => JSX.Element;
+type StaticChildren<T = unknown> = StaticSlot<T>;
+type StaticStyle = BoxLayoutStyle;
+interface StaticProps<T = unknown> {
+  items: T[];
+  style?: StaticStyle;
+  children?: StaticChildren<T>;
+}
+//#endregion
+//#region src/components/static.d.ts
+declare function Static<T = unknown>(props: StaticProps<T>): JSX.Element;
+//#endregion
+//#region src/components/transform.d.ts
+type TransformFn = (line: string, lineIndex: number) => string;
+interface TransformProps {
+  transform: TransformFn;
+  accessibilityLabel?: string;
+  children?: JSX.Element;
+}
+declare function Transform(props: TransformProps): JSX.Element;
+//#endregion
+//#region src/hooks/useApp.d.ts
+interface UseAppReturn {
+  readonly exit: (errorOrResult?: unknown) => void;
+  readonly waitUntilRenderFlush: () => Promise<void>;
+}
+declare function useApp(): UseAppReturn;
+//#endregion
+//#region src/hooks/useInput.d.ts
+interface Key {
+  upArrow: boolean;
+  downArrow: boolean;
+  leftArrow: boolean;
+  rightArrow: boolean;
+  pageDown: boolean;
+  pageUp: boolean;
+  home: boolean;
+  end: boolean;
+  return: boolean;
+  escape: boolean;
+  ctrl: boolean;
+  shift: boolean;
+  tab: boolean;
+  backspace: boolean;
+  delete: boolean;
+  meta: boolean;
+  super: boolean;
+  hyper: boolean;
+  capsLock: boolean;
+  numLock: boolean;
+  eventType?: "press" | "repeat" | "release";
+}
+interface UseInputOptions {
+  isActive?: boolean | (() => boolean);
+}
+type InputHandler = (input: string, key: Key) => void;
+declare function useInput(handler: InputHandler, options?: UseInputOptions): void;
+//#endregion
+//#region src/hooks/usePaste.d.ts
+interface UsePasteOptions {
+  isActive?: boolean | (() => boolean);
+}
+type PasteHandler = (text: string) => void;
+declare function usePaste(handler: PasteHandler, options?: UsePasteOptions): void;
+//#endregion
+//#region src/hooks/useFocus.d.ts
+interface UseFocusOptions {
+  autoFocus?: boolean | (() => boolean);
+  isActive?: boolean | (() => boolean);
+  id?: string | (() => string | undefined);
+}
+declare function useFocus(options?: UseFocusOptions): {
+  isFocused: Accessor<boolean>;
+  focus: (id: string) => void;
+};
+//#endregion
+//#region src/hooks/useFocusManager.d.ts
+declare function useFocusManager(): {
+  enableFocus: () => void;
+  disableFocus: () => void;
+  focusNext: () => void;
+  focusPrevious: () => void;
+  focus: (id: string) => void;
+  activeId: Accessor<string | null>;
+};
+//#endregion
+//#region src/hooks/useStdin.d.ts
+interface UseStdinReturn {
+  readonly stdin: NodeJS.ReadStream;
+  readonly setRawMode: (mode: boolean) => void;
+  readonly isRawModeSupported: boolean;
+}
+declare function useStdin(): UseStdinReturn;
+//#endregion
+//#region src/hooks/useStdout.d.ts
+interface UseStdoutReturn {
+  readonly stdout: NodeJS.WriteStream;
+  readonly write: (data: string) => void;
+}
+declare function useStdout(): UseStdoutReturn;
+//#endregion
+//#region src/hooks/useStderr.d.ts
+interface UseStderrReturn {
+  readonly stderr: NodeJS.WriteStream;
+  readonly write: (data: string) => void;
+}
+declare function useStderr(): UseStderrReturn;
+//#endregion
+//#region src/hooks/useWindowSize.d.ts
+interface WindowSize {
+  readonly columns: number;
+  readonly rows: number;
+}
+declare function useWindowSize(): {
+  columns: Accessor<number>;
+  rows: Accessor<number>;
+};
+//#endregion
+//#region src/hooks/useCursor.d.ts
+declare function useCursor(): {
+  setCursorPosition: import("solid-js/types/reactive/signal.js").Setter<CursorPosition | undefined>;
+};
+//#endregion
+//#region src/hooks/useIsScreenReaderEnabled.d.ts
+declare function useIsScreenReaderEnabled(): boolean;
+//#endregion
+//#region src/hooks/useAnimation.d.ts
+interface UseAnimationOptions {
+  interval?: number | (() => number | undefined);
+  isActive?: boolean | (() => boolean);
+}
+interface UseAnimationReturn {
+  readonly frame: Accessor<number>;
+  readonly time: Accessor<number>;
+  readonly delta: Accessor<number>;
+  readonly reset: () => void;
+}
+declare function useAnimation(options?: UseAnimationOptions): UseAnimationReturn;
+//#endregion
+//#region src/hooks/useBoxMetrics.d.ts
+interface BoxMetrics {
+  readonly width: number;
+  readonly height: number;
+  readonly left: number;
+  readonly top: number;
+}
+interface UseBoxMetricsReturn {
+  readonly width: Accessor<number>;
+  readonly height: Accessor<number>;
+  readonly left: Accessor<number>;
+  readonly top: Accessor<number>;
+  readonly hasMeasured: Accessor<boolean>;
+}
+declare function measureElement(node: unknown): {
+  width: number;
+  height: number;
+};
+declare function useBoxMetrics(ref: Accessor<unknown>): UseBoxMetricsReturn;
+//#endregion
+export { type Accessor, type AriaRole, type AriaState, Box, type BoxLayoutStyle, type BoxMetrics, type BoxProps, type BoxStyle, type Component, type CursorPosition, type JSX, type JSXElement, type Key, type KittyFlagName, type KittyKeyboardOptions, type MountOptions, Newline, type NewlineProps, type RenderToStringOptions, type Setter, Spacer, type SpacerProps, Static, type StaticChildren, type StaticProps, type StaticSlot, type StaticSlotProps, type StaticStyle, Text, type TextProps, Transform, type TransformProps, type TuiApp, type UseAnimationOptions, type UseAnimationReturn, type UseAppReturn, type UseBoxMetricsReturn, type UseFocusOptions, type UseInputOptions, type UsePasteOptions, type UseStderrReturn, type UseStdinReturn, type UseStdoutReturn, type WindowSize, batch, catchError, children, createApp, createComponent, createContext, createEffect, createElement, createMemo, createRenderEffect, createRoot, createSignal, createTextNode, effect, insert, insertNode, kittyFlags, kittyModifiers, measureElement, memo, mergeProps, on, onCleanup, renderToString, setProp, splitProps, spread, untrack, use, useAnimation, useApp, useBoxMetrics, useContext, useCursor, useFocus, useFocusManager, useInput, useIsScreenReaderEnabled, usePaste, useStderr, useStdin, useStdout, useWindowSize };