tuiuiu.js 0.1.1

package/dist/index.js

@@ -0,0 +1,334 @@
+/**
+ * Tuiuiu - Zero-dependency Terminal UI library
+ *
+ * A minimal, reactive terminal UI framework with signal-based reactivity,
+ * flexbox layout, and zero external dependencies.
+ *
+ * @example
+ * import { render, Box, Text, useState, useInput } from 'tuiuiu.js';
+ *
+ * function App() {
+ *   const [count, setCount] = useState(0);
+ *
+ *   useInput((input, key) => {
+ *     if (key.upArrow) setCount(c => c + 1);
+ *     if (key.downArrow) setCount(c => c - 1);
+ *   });
+ *
+ *   return Box({ flexDirection: 'column', padding: 1 },
+ *     Text({ color: 'cyan', bold: true }, 'Counter'),
+ *     Text({}, `Count: ${count()}`)
+ *   );
+ * }
+ *
+ * const { waitUntilExit } = render(App);
+ * await waitUntilExit();
+ */
+// =============================================================================
+// Core - Signals, Layout, Rendering, App
+// =============================================================================
+export { 
+// Signals
+createSignal, createEffect, createMemo, batch, untrack, Signal, Effect, createReducer, createRef, createDeferred, createId, resetIdCounter, createPrevious, createThrottled, createDebounced, 
+// Layout
+calculateLayout, getVisibleWidth, measureText, clearTextMeasureCache, 
+// Renderer
+renderToString, OutputBuffer, 
+// App
+render, renderOnce, } from './core/index.js';
+// =============================================================================
+// Hooks - useState, useEffect, useInput, etc.
+// =============================================================================
+export { useState, useEffect, useInput, useApp, useFocus, useFocusManager, parseKeypress, useTerminalSize, useMouse, } from './hooks/index.js';
+// =============================================================================
+// Primitives - Box, Text, Spacer, etc.
+// =============================================================================
+export { 
+// Basic nodes
+Box, Text, Spacer, Newline, Fragment, When, Each, Transform, Static, Divider, Slot, 
+// Canvas
+Canvas, createCanvas, createBrailleBuffer, setBrailleDot, brailleBufferToString, BLOCK_CHARS as CANVAS_BLOCK_CHARS, LINE_CHARS, createBlockBuffer, setBlockPixel, blockBufferToString, bresenhamLine, midpointCircle, filledCircle, midpointEllipse, arcPoints, bezierCurve, quadraticBezier, polygonPoints, filledPolygon, rectanglePoints, filledRectangle, drawSparkline, drawBarChart, drawScatterPlot, } from './primitives/index.js';
+// =============================================================================
+// Atomic Design - Atoms (smallest functional units)
+// =============================================================================
+export * from './atoms/index.js';
+// =============================================================================
+// Atomic Design - Molecules (composed atoms)
+// =============================================================================
+export * from './molecules/index.js';
+// =============================================================================
+// Atomic Design - Organisms (complex self-contained units)
+// =============================================================================
+export * from './organisms/index.js';
+// =============================================================================
+// Atomic Design - Templates (page-level layouts)
+// =============================================================================
+export * from './templates/index.js';
+// =============================================================================
+// Design System - Layout Components
+// =============================================================================
+export { 
+// Stack Layouts
+VStack, HStack, Center, FullScreen, Spacer as DSpacer, Divider as DDivider, 
+// Split Layouts
+SplitPanel as DSSplitPanel, ThreePanel as DSThreePanel, createSplitPanel as DSCreateSplitPanel, 
+// App Layouts
+Page, AppShell, StatusBar, Header, Container, } from './design-system/layout/index.js';
+// =============================================================================
+// Design System - Media Components
+// =============================================================================
+export { 
+// Picture components
+Picture, FramedPicture, ColoredPicture, 
+// Pixel grid utilities
+createPixelGrid, createPixelGridFromColors, renderPixelGrid, 
+// Sprite/animation utilities
+createSprite, getSpriteFrame, nextSpriteFrame, 
+// Effects
+createGradientBar, rainbowText, createShadowedText, 
+// Pre-made patterns
+AsciiPatterns, createBanner, } from './design-system/media/index.js';
+// =============================================================================
+// Core - Global Tick System (synchronized animations)
+// =============================================================================
+export { 
+// Tick control
+startTick, stopTick, pauseTick, resumeTick, resetTick, setTickRate, getTickRate, 
+// Tick state
+getTick, tick, isTickRunning, 
+// Subscriptions
+onTick, 
+// Manual control (for testing/storybook)
+advanceTick, setTickValue, 
+// Animation utilities
+getFrame, getFrameItem, oscillate, getElapsedSeconds, everyNTicks, } from './core/index.js';
+// =============================================================================
+// Core - Theme, Animation, Capabilities
+// =============================================================================
+export { 
+// Theme system
+useTheme, getTheme, setTheme, pushTheme, popTheme, createTheme, themeColor, themeSpacing, resolveColor, detectColorScheme, useSystemTheme, darkTheme, lightTheme, highContrastDarkTheme, monochromeTheme, themes, tw, 
+// Colors - Tailwind CSS palette
+colors, color, parseColor, getShades, listColors, listShades, white, black, transparent, slate, gray, zinc, neutral, stone, red, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink, rose, 
+// Animation system
+useAnimation, useTransition, lerp, lerpColor, requestAnimationFrame, cancelAllAnimationFrames, createSpring, easingFunctions, createHarmonicaSpring, createCompositeTransition, createSwipeTransition, createSlideTransition, 
+// Terminal capabilities and ASCII fallback
+detectTerminalCapabilities, setRenderMode, getRenderModeSetting, getRenderMode, getCapabilities, refreshCapabilities, getChars, char, supports, supportsTrueColor, supports256Colors, getTerminalSize, onResize, unicodeChars, asciiChars, } from './core/index.js';
+// =============================================================================
+// Data Visualization - Charts and Graphs
+// =============================================================================
+export { 
+// Sparkline
+Sparkline, renderSparklineString, SparklineBuffer, createSparklineBuffer, renderBrailleSparkline, BLOCK_CHARS, ASCII_CHARS, 
+// Bar Chart
+BarChart, VerticalBarChart, StackedBarChart, renderBarChartStrings, HORIZONTAL_BLOCKS, VERTICAL_BLOCKS, 
+// Line Chart
+LineChart, AreaChart, renderLineChartStrings, renderMultiSeriesChart, BrailleCanvas, AsciiCanvas, 
+// Gauge
+Gauge, LinearGauge, MeterGauge, ArcGauge, DialGauge, BatteryGauge, renderLinearGaugeString, DEFAULT_ZONES, getZoneColor, 
+// Heatmap
+Heatmap, createHeatmap, ContributionGraph, CalendarHeatmap, CorrelationMatrix, COLOR_SCALES, } from './molecules/data-viz/index.js';
+// =============================================================================
+// Design System - Forms (Advanced)
+// =============================================================================
+export { 
+// Multi-select
+MultiSelect, createMultiSelect, 
+// Autocomplete
+Autocomplete, createAutocomplete, Combobox, TagInput, createTagInput, 
+// Radio Group
+RadioGroup, createRadioGroup, InlineRadio, 
+// Switch
+Switch, createSwitch, ToggleGroup, 
+// Slider
+Slider, createSlider, RangeSlider, createRangeSlider, } from './design-system/forms/index.js';
+// =============================================================================
+// Design System - Data Display
+// =============================================================================
+export { 
+// Tree
+Tree, createTree, DirectoryTree, 
+// DataTable
+DataTable, createDataTable, VirtualDataTable, EditableDataTable, 
+// Calendar
+Calendar, createCalendar, MiniCalendar, DatePicker, createDatePicker, } from './design-system/data-display/index.js';
+// =============================================================================
+// Design System - Layout (Advanced)
+// =============================================================================
+export { 
+// Tabs
+Tabs, createTabs, TabPanel, VerticalTabs, LazyTabs, 
+// Collapsible
+Collapsible, createCollapsible, Accordion, createAccordion, Details, ExpandableText, 
+// ScrollArea
+ScrollArea, createScrollArea, VirtualList, createVirtualList, ScrollableText, LogViewer, 
+// Grid
+Grid, GridCell, SimpleGrid, AutoGrid, MasonryGrid, TemplateGrid, ResponsiveGrid, } from './design-system/layout/index.js';
+// =============================================================================
+// Design System - Visual
+// =============================================================================
+export { 
+// BigText
+BigText, FigletText, BigTitle, Logo, 
+// Digits
+Digits, Clock, Counter, Countdown, Stopwatch, DigitRoll, Score, 
+// Tooltip
+Tooltip, WithTooltip, HelpTooltip, InfoBox, Popover, Tag, } from './design-system/visual/index.js';
+// =============================================================================
+// Utils - Types, Text utilities, Cursor control
+// =============================================================================
+export { BORDER_STYLES, stripAnsi, stringWidth, wrapText, truncateText, sliceAnsi, colorToAnsi, colorize, style, hyperlink, styles, showCursor, hideCursor, toggleCursor, isCursorHidden, cursor, createLogUpdate, createUpdateBatcher, createDebounced as debouncedFn, createThrottled as throttledFn, } from './utils/index.js';
+// =============================================================================
+// Core - Event System
+// =============================================================================
+export { 
+// Event creation
+createEvent, 
+// Event emitter
+EventEmitter, 
+// Global event bus
+getEventBus, 
+// Delegation helpers
+delegate, 
+// Async helpers
+waitForEvent, eventIterator, 
+// Composition helpers
+combineHandlers, conditionalHandler, debounceHandler, throttleHandler, } from './core/index.js';
+// =============================================================================
+// Core - Focus Management
+// =============================================================================
+export { 
+// Zone manager
+getFocusZoneManager, resetFocusZoneManager, 
+// Zone helpers
+createFocusZone, createFocusTrap, 
+// Programmatic focus
+focusElement, focusNext, focusPrevious, focusFirst, focusLast, blurFocus, getActiveId, isFocused, registerFocusable, onFocusChange, } from './core/index.js';
+// =============================================================================
+// Core - Graphics System
+// =============================================================================
+export { 
+// Protocol detection
+detectGraphicsProtocol, setGraphicsProtocol, getGraphicsProtocol, getProtocolCapabilities, resetGraphicsDetection, 
+// Protocol implementations
+kittyGraphics, iterm2Graphics, sixelGraphics, brailleGraphics, 
+// Unified rendering
+renderImage, clearImages, 
+// Image utilities
+createImageData, createSolidImage, createGradientImage, scaleImage, } from './core/index.js';
+// =============================================================================
+// Core - Virtual Scroll
+// =============================================================================
+export { 
+// Core manager
+createVirtualScroll, VirtualScrollManager, 
+// Fixed/variable height helpers
+createFixedHeightVirtualScroll, createVariableHeightVirtualScroll, 
+// Scroll helpers
+getScrollDirection, getVisibleRangePercent, createScrollIndicator, 
+// Infinite scroll
+createInfiniteScroll, } from './core/index.js';
+// =============================================================================
+// Core - Constraint Layout
+// =============================================================================
+export { 
+// Variable creation
+createVariable, 
+// Expression building
+expr, constant, add, subtract, multiply, divide, addConstant, 
+// Constraint creation
+eq, lte, gte, 
+// Element creation
+createElement, 
+// Convenience constraints
+equalWidths, equalHeights, equalSizes, percentWidth, percentHeight, aspectRatio, centerHorizontally, centerVertically, center, pinToEdges, stackHorizontally, stackVertically, alignTops, alignLefts, distributeHorizontally, 
+// Solver
+ConstraintSolver, ConstraintLayoutManager, Solver, } from './core/index.js';
+// =============================================================================
+// Core - Key Bindings
+// =============================================================================
+export { 
+// Parsing
+parseKeyCombo, keyComboToString, keyComboEquals, keyComboFromEvent, formatKeyCombo, formatKeyString, 
+// Registry
+KeyBindingRegistry, getKeyBindingRegistry, resetKeyBindingRegistry, resetBindingIdCounter, 
+// Convenience functions
+registerKeybinding, unregisterKeybinding, setKeyMode, getKeyMode, handleKeyEvent, 
+// Hook
+useKeyBindings, } from './core/index.js';
+// =============================================================================
+// Core - Command Palette
+// =============================================================================
+export { 
+// Fuzzy search
+fuzzyMatch, searchCommands, 
+// Registry
+CommandRegistry, getCommandRegistry, resetCommandRegistry, resetCommandIdCounter, 
+// Convenience functions
+registerCommand, unregisterCommand, executeCommand, searchGlobalCommands, 
+// State management
+createCommandPaletteState, 
+// Helpers
+highlightMatches, formatCommand, groupByCategory, } from './core/index.js';
+// =============================================================================
+// Styling - TCSS (Terminal CSS)
+// =============================================================================
+export { 
+// Tokenizer
+TokenType, Tokenizer, tokenize, tokenizeWithErrors, 
+// Parser
+Parser, parse, parseStrict, visitAST, stringifySelector, stringifyValue, } from './styling/index.js';
+export { 
+// Specificity
+calculateSpecificity, compareSpecificity, specificityToNumber, specificityToString, getSpecificity, 
+// Matching
+matchSelector, 
+// Inheritance
+isInheritable, 
+// Value utilities
+valueToString, 
+// StyleSheet
+StyleSheet, createStyleSheet, 
+// Style application
+resolvedStylesToProps, applyStyles, } from './styling/index.js';
+// =============================================================================
+// Core - Screen Manager
+// =============================================================================
+export { 
+// Manager
+ScreenManager, getScreenManager, resetScreenManager, createScreenManager, 
+// Screen creation
+createScreen, generateScreenId, resetScreenIdCounter, 
+// Convenience navigation
+pushScreen, popScreen, replaceScreen, goBack, 
+// Hooks
+useScreen, useScreenState, } from './core/index.js';
+// =============================================================================
+// Developer Tools - Debugging and Testing Utilities
+// =============================================================================
+export { 
+// Dev mode control
+setDevMode, isDevMode, configureDevTools, getDevToolsConfig, 
+// Layout inspector
+inspectLayout, formatLayoutTree, 
+// Event log
+logEvent, getEventLog, clearEventLog, formatEventLog, 
+// Performance monitor
+startFrame, recordRender, recordLayout, recordSignalUpdate, getPerformanceMetrics, resetPerformanceMetrics, formatPerformanceMetrics, 
+// Component tree
+buildComponentTree, formatComponentTree, findComponentByPath, countComponents, 
+// Signal graph
+registerSignal, updateSignalValue, addSignalDependency, getSignalGraph, formatSignalGraph, clearSignalRegistry, 
+// Debug panel
+getDebugPanelData, 
+// Terminal simulator
+TerminalSimulator, 
+// Snapshot testing
+createSnapshot, compareSnapshots, formatSnapshotDiff, stripAnsi as devStripAnsi, 
+// Event simulation
+createEventSimulator, 
+// Accessibility
+checkAccessibility, formatAccessibilityReport, 
+// Test harness
+createTestHarness, } from './dev-tools/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/molecules/autocomplete.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Autocomplete - Text input with dropdown suggestions
+ *
+ * @layer Molecule
+ * @description Type-ahead input with fuzzy search suggestions
+ *
+ * Features:
+ * - Type-ahead suggestions
+ * - Fuzzy matching
+ * - Keyboard navigation
+ * - Custom filtering
+ * - Async data source support
+ */
+import type { VNode, ColorValue } from '../utils/types.js';
+export interface AutocompleteItem<T = string> {
+    /** Unique value */
+    value: T;
+    /** Display label */
+    label: string;
+    /** Optional description */
+    description?: string;
+    /** Disabled state */
+    disabled?: boolean;
+}
+export interface AutocompleteOptions<T = string> {
+    /** Available items */
+    items: AutocompleteItem<T>[];
+    /** Initial input value */
+    initialValue?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Max suggestions to show */
+    maxSuggestions?: number;
+    /** Min characters before showing suggestions */
+    minChars?: number;
+    /** Custom filter function */
+    filter?: (query: string, items: AutocompleteItem<T>[]) => AutocompleteItem<T>[];
+    /** Allow free text (not in items) */
+    allowFreeText?: boolean;
+    /** Input width */
+    width?: number;
+    /** Expand to fill available width */
+    fullWidth?: boolean;
+    /** Colors */
+    activeColor?: ColorValue;
+    selectedColor?: ColorValue;
+    /** Callbacks */
+    onChange?: (value: string) => void;
+    onSelect?: (item: AutocompleteItem<T>) => void;
+    onSubmit?: (value: string, item?: AutocompleteItem<T>) => void;
+    /** Is active */
+    isActive?: boolean;
+}
+export interface AutocompleteState<T = string> {
+    inputValue: () => string;
+    cursorPos: () => number;
+    suggestions: () => AutocompleteItem<T>[];
+    selectedIndex: () => number;
+    isOpen: () => boolean;
+    setInput: (value: string) => void;
+    insertChar: (char: string) => void;
+    deleteBack: () => void;
+    deleteForward: () => void;
+    moveCursorLeft: () => void;
+    moveCursorRight: () => void;
+    moveCursorHome: () => void;
+    moveCursorEnd: () => void;
+    moveUp: () => void;
+    moveDown: () => void;
+    selectCurrent: () => void;
+    open: () => void;
+    close: () => void;
+    submit: () => void;
+}
+/**
+ * Create an Autocomplete state manager
+ */
+export declare function createAutocomplete<T = string>(options: AutocompleteOptions<T>): AutocompleteState<T>;
+export interface AutocompleteProps<T = string> extends AutocompleteOptions<T> {
+    /** Pre-created state */
+    state?: AutocompleteState<T>;
+    /** Label */
+    label?: string;
+}
+/**
+ * Autocomplete - Text input with dropdown suggestions
+ *
+ * @example
+ * // Basic autocomplete
+ * Autocomplete({
+ *   items: [
+ *     { value: 'react', label: 'React' },
+ *     { value: 'vue', label: 'Vue.js' },
+ *     { value: 'angular', label: 'Angular' },
+ *   ],
+ *   placeholder: 'Search frameworks...',
+ *   onSelect: (item) => console.log(item),
+ * })
+ *
+ * @example
+ * // With custom filter
+ * Autocomplete({
+ *   items: users,
+ *   filter: (query, items) =>
+ *     items.filter(i => i.label.toLowerCase().includes(query.toLowerCase())),
+ *   onSubmit: (value, item) => console.log(value, item),
+ * })
+ */
+export declare function Autocomplete<T = string>(props: AutocompleteProps<T>): VNode;
+export interface ComboboxProps<T = string> extends AutocompleteProps<T> {
+    /** Error message for invalid input */
+    errorMessage?: string;
+}
+/**
+ * Combobox - Autocomplete that requires selection from list
+ */
+export declare function Combobox<T = string>(props: ComboboxProps<T>): VNode;
+export interface TagInputOptions<T = string> {
+    /** Available items */
+    items: AutocompleteItem<T>[];
+    /** Initially selected values */
+    initialValues?: T[];
+    /** Max tags allowed */
+    maxTags?: number;
+    /** Placeholder */
+    placeholder?: string;
+    /** Width */
+    width?: number;
+    /** Expand to fill available width */
+    fullWidth?: boolean;
+    /** Colors */
+    tagColor?: ColorValue;
+    activeColor?: ColorValue;
+    /** Callbacks */
+    onChange?: (values: T[]) => void;
+    /** Is active */
+    isActive?: boolean;
+}
+export interface TagInputState<T = string> {
+    tags: () => T[];
+    inputValue: () => string;
+    suggestions: () => AutocompleteItem<T>[];
+    selectedIndex: () => number;
+    isOpen: () => boolean;
+    addTag: (value: T) => void;
+    removeTag: (value: T) => void;
+    removeLastTag: () => void;
+    setInput: (value: string) => void;
+}
+/**
+ * Create a TagInput state manager
+ */
+export declare function createTagInput<T = string>(options: TagInputOptions<T>): TagInputState<T>;
+/**
+ * TagInput - Multiple tag selection with autocomplete
+ *
+ * @example
+ * TagInput({
+ *   items: skills,
+ *   placeholder: 'Add skills...',
+ *   maxTags: 5,
+ *   onChange: (values) => console.log(values),
+ * })
+ */
+export declare function TagInput<T = string>(props: TagInputOptions<T>): VNode;
+//# sourceMappingURL=autocomplete.d.ts.map

package/dist/molecules/autocomplete.d.ts.map

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