tuiuiu.js 0.1.1 → 0.1.4-next.2b42a16

package/dist/molecules/data-viz/scatter-plot.d.ts

@@ -0,0 +1,97 @@
+/**
+ * ScatterPlot - Two-dimensional scatter plot for correlation analysis
+ *
+ * Features:
+ * - X/Y coordinate plotting
+ * - Configurable marker styles
+ * - Color by value or category
+ * - Size scaling for third dimension
+ * - Legend with distinct marker styles
+ * - Interactive tooltips and selection
+ */
+import type { VNode, ColorValue } from '../../utils/types.js';
+export interface ScatterPoint {
+    /** X coordinate */
+    x: number;
+    /** Y coordinate */
+    y: number;
+    /** Optional value for color mapping */
+    value?: number;
+    /** Optional category for color grouping */
+    category?: string;
+    /** Optional size value */
+    size?: number;
+    /** Optional label */
+    label?: string;
+}
+export type MarkerStyle = 'circle' | 'square' | 'diamond' | 'plus' | 'star' | 'cross';
+export interface AxisOptions {
+    /** Show axis line */
+    show?: boolean;
+    /** Axis label */
+    label?: string;
+    /** Minimum value (auto-detected if not set) */
+    min?: number;
+    /** Maximum value (auto-detected if not set) */
+    max?: number;
+    /** Number of tick marks */
+    ticks?: number;
+    /** Custom tick formatter */
+    formatter?: (value: number) => string;
+}
+export interface ScatterPlotOptions {
+    /** Data points to display */
+    points: ScatterPoint[];
+    /** Chart width in characters */
+    width?: number;
+    /** Chart height in rows */
+    height?: number;
+    /** X-axis options */
+    xAxis?: AxisOptions;
+    /** Y-axis options */
+    yAxis?: AxisOptions;
+    /** Marker style */
+    markerStyle?: MarkerStyle;
+    /** Color by value or category */
+    colorMode?: 'value' | 'category' | 'uniform';
+    /** Color for uniform mode */
+    color?: ColorValue;
+    /** Color scale for value mode */
+    colorScale?: ColorValue[];
+    /** Title */
+    title?: string;
+    /** Show legend */
+    showLegend?: boolean;
+    /** Click handler */
+    onPointClick?: (point: ScatterPoint, index: number) => void;
+}
+export interface ScatterPlotProps extends ScatterPlotOptions {
+}
+/**
+ * ScatterPlot - Two-dimensional scatter plot
+ *
+ * @example
+ * // Basic scatter plot
+ * ScatterPlot({
+ *   points: [
+ *     { x: 1, y: 2 },
+ *     { x: 2, y: 4 },
+ *     { x: 3, y: 6 },
+ *   ],
+ *   width: 50,
+ *   height: 15,
+ * })
+ *
+ * @example
+ * // Scatter plot with color by value
+ * ScatterPlot({
+ *   points: [
+ *     { x: 1, y: 2, value: 10 },
+ *     { x: 2, y: 4, value: 20 },
+ *   ],
+ *   colorMode: 'value',
+ *   colorScale: ['blue', 'cyan', 'green', 'yellow', 'red'],
+ * })
+ */
+export declare function ScatterPlot(props: ScatterPlotProps): VNode;
+//# sourceMappingURL=scatter-plot.d.ts.map

package/dist/molecules/data-viz/scatter-plot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter-plot.d.ts","sourceRoot":"","sources":["../../../src/molecules/data-viz/scatter-plot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQ9D,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtF,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,qBAAqB;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mBAAmB;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,6BAA6B;IAC7B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,iCAAiC;IACjC,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAwGD,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;CAAG;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK,CAqH1D"}

package/dist/molecules/data-viz/scatter-plot.js

@@ -0,0 +1,205 @@
+/**
+ * ScatterPlot - Two-dimensional scatter plot for correlation analysis
+ *
+ * Features:
+ * - X/Y coordinate plotting
+ * - Configurable marker styles
+ * - Color by value or category
+ * - Size scaling for third dimension
+ * - Legend with distinct marker styles
+ * - Interactive tooltips and selection
+ */
+import { Box, Text } from '../../primitives/nodes.js';
+import { getRenderMode } from '../../core/capabilities.js';
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Get marker character for style
+ */
+function getMarkerChar(style, useAscii) {
+    if (useAscii) {
+        switch (style) {
+            case 'circle':
+                return 'o';
+            case 'square':
+                return '#';
+            case 'diamond':
+                return '*';
+            case 'plus':
+                return '+';
+            case 'star':
+                return '*';
+            case 'cross':
+                return 'x';
+            default:
+                return 'o';
+        }
+    }
+    // Unicode markers
+    switch (style) {
+        case 'circle':
+            return '●';
+        case 'square':
+            return '■';
+        case 'diamond':
+            return '◆';
+        case 'plus':
+            return '✚';
+        case 'star':
+            return '★';
+        case 'cross':
+            return '✕';
+        default:
+            return '●';
+    }
+}
+/**
+ * Calculate bounds from points
+ */
+function calculateBounds(points, xAxis, yAxis) {
+    let xMin = Infinity;
+    let xMax = -Infinity;
+    let yMin = Infinity;
+    let yMax = -Infinity;
+    let valueMin = Infinity;
+    let valueMax = -Infinity;
+    for (const p of points) {
+        xMin = Math.min(xMin, p.x);
+        xMax = Math.max(xMax, p.x);
+        yMin = Math.min(yMin, p.y);
+        yMax = Math.max(yMax, p.y);
+        if (p.value !== undefined) {
+            valueMin = Math.min(valueMin, p.value);
+            valueMax = Math.max(valueMax, p.value);
+        }
+    }
+    // Apply axis overrides
+    if (xAxis?.min !== undefined)
+        xMin = xAxis.min;
+    if (xAxis?.max !== undefined)
+        xMax = xAxis.max;
+    if (yAxis?.min !== undefined)
+        yMin = yAxis.min;
+    if (yAxis?.max !== undefined)
+        yMax = yAxis.max;
+    // Handle edge cases
+    if (!isFinite(xMin))
+        xMin = 0;
+    if (!isFinite(xMax))
+        xMax = 1;
+    if (!isFinite(yMin))
+        yMin = 0;
+    if (!isFinite(yMax))
+        yMax = 1;
+    if (xMin === xMax)
+        xMax = xMin + 1;
+    if (yMin === yMax)
+        yMax = yMin + 1;
+    if (!isFinite(valueMin))
+        valueMin = 0;
+    if (!isFinite(valueMax))
+        valueMax = 1;
+    if (valueMin === valueMax)
+        valueMax = valueMin + 1;
+    return { xMin, xMax, yMin, yMax, valueMin, valueMax };
+}
+/**
+ * Format tick value
+ */
+function formatTick(value, formatter) {
+    if (formatter)
+        return formatter(value);
+    if (Number.isInteger(value))
+        return String(value);
+    return value.toFixed(2);
+}
+/**
+ * ScatterPlot - Two-dimensional scatter plot
+ *
+ * @example
+ * // Basic scatter plot
+ * ScatterPlot({
+ *   points: [
+ *     { x: 1, y: 2 },
+ *     { x: 2, y: 4 },
+ *     { x: 3, y: 6 },
+ *   ],
+ *   width: 50,
+ *   height: 15,
+ * })
+ *
+ * @example
+ * // Scatter plot with color by value
+ * ScatterPlot({
+ *   points: [
+ *     { x: 1, y: 2, value: 10 },
+ *     { x: 2, y: 4, value: 20 },
+ *   ],
+ *   colorMode: 'value',
+ *   colorScale: ['blue', 'cyan', 'green', 'yellow', 'red'],
+ * })
+ */
+export function ScatterPlot(props) {
+    const { points, width = 60, height = 15, xAxis = {}, yAxis = {}, markerStyle = 'circle', colorMode = 'uniform', color = 'cyan', colorScale = ['blue', 'cyan', 'green', 'yellow', 'red'], title, showLegend = false, } = props;
+    const isAscii = getRenderMode() === 'ascii';
+    const marker = getMarkerChar(markerStyle, isAscii);
+    if (points.length === 0) {
+        return Text({ color: 'gray', dim: true }, 'No data');
+    }
+    const bounds = calculateBounds(points, xAxis, yAxis);
+    // Build grid (ASCII mode for now)
+    const grid = Array(height)
+        .fill(null)
+        .map(() => Array(width).fill(' '));
+    // Plot points
+    for (const point of points) {
+        const x = Math.round(((point.x - bounds.xMin) / (bounds.xMax - bounds.xMin)) * (width - 1));
+        const y = Math.round(((point.y - bounds.yMin) / (bounds.yMax - bounds.yMin)) * (height - 1));
+        if (x >= 0 && x < width && y >= 0 && y < height) {
+            grid[height - 1 - y][x] = marker;
+        }
+    }
+    // Render grid
+    const chartRows = [];
+    for (let y = 0; y < height; y++) {
+        const rowStr = grid[y].join('');
+        // Determine row color based on color mode
+        let rowColor = color;
+        if (colorMode === 'value' && colorScale.length > 0) {
+            rowColor = colorScale[0];
+        }
+        chartRows.push(Text({ color: rowColor }, rowStr));
+    }
+    // Build Y-axis labels
+    const yTicks = yAxis.ticks ?? 5;
+    const yLabels = [];
+    for (let i = 0; i <= yTicks; i++) {
+        const value = bounds.yMax - (i / yTicks) * (bounds.yMax - bounds.yMin);
+        const label = formatTick(value, yAxis.formatter);
+        if (i === 0 || i === yTicks || i === Math.floor(yTicks / 2)) {
+            yLabels.push(Box({ height: Math.round(height / yTicks) }, Text({ color: 'gray', dim: true }, label.padStart(6))));
+        }
+    }
+    // Build X-axis labels
+    const xTicks = xAxis.ticks ?? 5;
+    const xLabels = [];
+    for (let i = 0; i <= xTicks; i++) {
+        const value = bounds.xMin + (i / xTicks) * (bounds.xMax - bounds.xMin);
+        const label = formatTick(value, xAxis.formatter);
+        const spacing = Math.floor(width / xTicks);
+        xLabels.push(Box({ width: spacing }, Text({ color: 'gray', dim: true }, label.padStart(spacing))));
+    }
+    // Assemble chart
+    const chartWithYAxis = Box({ flexDirection: 'row' }, yAxis.show !== false ? Box({ flexDirection: 'column' }, ...yLabels.slice(0, 3)) : null, Box({ flexDirection: 'column' }, ...chartRows));
+    const parts = [];
+    if (title) {
+        parts.push(Box({ marginBottom: 1 }, Text({ color: 'white', bold: true }, title)));
+    }
+    parts.push(chartWithYAxis);
+    if (xAxis.show !== false) {
+        parts.push(Box({ flexDirection: 'row', marginLeft: yAxis.show !== false ? 6 : 0 }, ...xLabels));
+    }
+    return Box({ flexDirection: 'column' }, ...parts);
+}
+//# sourceMappingURL=scatter-plot.js.map

package/dist/molecules/data-viz/scatter-plot.js.map

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

package/dist/molecules/data-viz/time-heatmap.d.ts

@@ -0,0 +1,48 @@
+/**
+ * TimeHeatmap - Calendar-based heatmap for activity visualization
+ *
+ * Features:
+ * - Day/week/month granularity
+ * - Multiple color scales
+ * - Date range support
+ * - Activity level visualization
+ */
+import type { VNode, ColorValue } from '../../utils/types.js';
+export interface TimeHeatmapData {
+    /** Date (ISO 8601 or Date) */
+    date: Date | string;
+    /** Value for color intensity */
+    value: number;
+}
+export type TimeGranularity = 'day' | 'week' | 'month';
+export interface TimeHeatmapOptions {
+    /** Data points */
+    data: TimeHeatmapData[];
+    /** Granularity level */
+    granularity?: TimeGranularity;
+    /** Start date (default: 1 year ago) */
+    startDate?: Date | string;
+    /** End date (default: today) */
+    endDate?: Date | string;
+    /** Color scale */
+    colorScale?: ColorValue[] | 'greens' | 'blues' | 'reds' | 'heat';
+    /** Show legend */
+    showLegend?: boolean;
+    /** Title */
+    title?: string;
+}
+/**
+ * TimeHeatmap - Calendar-based activity heatmap
+ *
+ * @example
+ * TimeHeatmap({
+ *   data: [
+ *     { date: '2024-01-01', value: 5 },
+ *     { date: '2024-01-02', value: 10 },
+ *   ],
+ *   granularity: 'day',
+ *   colorScale: 'greens',
+ * })
+ */
+export declare function TimeHeatmap(props: TimeHeatmapOptions): VNode;
+//# sourceMappingURL=time-heatmap.d.ts.map

package/dist/molecules/data-viz/time-heatmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-heatmap.d.ts","sourceRoot":"","sources":["../../../src/molecules/data-viz/time-heatmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQ9D,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IACpB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,kBAAkB;IAClB,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,wBAAwB;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,uCAAuC;IACvC,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,gCAAgC;IAChC,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB,kBAAkB;IAClB,UAAU,CAAC,EAAE,UAAU,EAAE,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACjE,kBAAkB;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4ED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,CAsF5D"}

package/dist/molecules/data-viz/time-heatmap.js

@@ -0,0 +1,145 @@
+/**
+ * TimeHeatmap - Calendar-based heatmap for activity visualization
+ *
+ * Features:
+ * - Day/week/month granularity
+ * - Multiple color scales
+ * - Date range support
+ * - Activity level visualization
+ */
+import { Box, Text } from '../../primitives/nodes.js';
+import { getRenderMode } from '../../core/capabilities.js';
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Parse date
+ */
+function parseDate(date) {
+    return typeof date === 'string' ? new Date(date) : date;
+}
+/**
+ * Get date range start of period
+ */
+function getPeriodStart(date, granularity) {
+    const d = new Date(date);
+    switch (granularity) {
+        case 'day':
+            return d;
+        case 'week': {
+            const day = d.getDay();
+            d.setDate(d.getDate() - day);
+            return d;
+        }
+        case 'month': {
+            d.setDate(1);
+            return d;
+        }
+    }
+}
+/**
+ * Format date for display
+ */
+function formatDate(date, granularity) {
+    const options = granularity === 'day'
+        ? { month: 'short', day: 'numeric' }
+        : granularity === 'week'
+            ? { month: 'short', day: 'numeric' }
+            : { month: 'short', year: '2-digit' };
+    return new Intl.DateTimeFormat('en', options).format(date);
+}
+/**
+ * Get color scales
+ */
+function getColorScale(scale) {
+    if (!scale)
+        return ['#161b22', '#0e4429', '#006d32', '#26a641', '#39d353']; // greens
+    if (typeof scale === 'string') {
+        switch (scale) {
+            case 'greens':
+                return ['#161b22', '#0e4429', '#006d32', '#26a641', '#39d353'];
+            case 'blues':
+                return ['#161b22', '#0a3069', '#0969da', '#54aeff', '#79c0ff'];
+            case 'reds':
+                return ['#161b22', '#67060c', '#a61e4d', '#da3633', '#f85149'];
+            case 'heat':
+                return ['blue', 'cyan', 'green', 'yellow', 'red'];
+            default:
+                return ['#161b22', '#0e4429', '#006d32', '#26a641', '#39d353'];
+        }
+    }
+    return scale;
+}
+// =============================================================================
+// Component
+// =============================================================================
+/**
+ * TimeHeatmap - Calendar-based activity heatmap
+ *
+ * @example
+ * TimeHeatmap({
+ *   data: [
+ *     { date: '2024-01-01', value: 5 },
+ *     { date: '2024-01-02', value: 10 },
+ *   ],
+ *   granularity: 'day',
+ *   colorScale: 'greens',
+ * })
+ */
+export function TimeHeatmap(props) {
+    const { data, granularity = 'day', startDate: customStart, endDate: customEnd, colorScale = 'greens', showLegend = true, title, } = props;
+    const isAscii = getRenderMode() === 'ascii';
+    const colors = getColorScale(colorScale);
+    const INTENSITY_BLOCKS = [' ', '░', '▒', '▓', '█'];
+    const ASCII_INTENSITY = [' ', '.', ':', '+', '#'];
+    const intensityChars = isAscii ? ASCII_INTENSITY : INTENSITY_BLOCKS;
+    if (data.length === 0) {
+        return Text({ color: 'gray', dim: true }, 'No data');
+    }
+    // Build data map
+    const dataMap = new Map();
+    let maxValue = 0;
+    for (const item of data) {
+        const d = parseDate(item.date);
+        const periodStart = getPeriodStart(d, granularity);
+        const key = periodStart.toISOString().split('T')[0];
+        const existing = dataMap.get(key) ?? 0;
+        const newValue = existing + item.value;
+        dataMap.set(key, newValue);
+        maxValue = Math.max(maxValue, newValue);
+    }
+    // Build display
+    const displayLines = [];
+    if (title) {
+        displayLines.push(Box({ marginBottom: 1 }, Text({ color: 'white', bold: true }, title)));
+    }
+    // Date labels and values
+    const rows = [];
+    const sortedDates = Array.from(dataMap.entries())
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .slice(0, 12); // Limit to 12 rows
+    for (const [dateStr, value] of sortedDates) {
+        const date = new Date(dateStr + 'T00:00:00');
+        const label = formatDate(date, granularity);
+        const normalized = maxValue > 0 ? value / maxValue : 0;
+        const colorIdx = Math.floor(normalized * (colors.length - 1));
+        const intensity = intensityChars[Math.floor(normalized * (intensityChars.length - 1))];
+        const color = colors[colorIdx] ?? colors[colors.length - 1];
+        const rowItems = [];
+        rowItems.push(Text({ color: 'gray', dim: true }, label.padEnd(12)));
+        rowItems.push(Text({ color }, intensity.repeat(5) + ` ${value}`));
+        rows.push(Box({ flexDirection: 'row', gap: 1 }, ...rowItems));
+    }
+    displayLines.push(Box({ flexDirection: 'column' }, ...rows));
+    // Legend
+    if (showLegend) {
+        const legendItems = [Text({ color: 'gray', dim: true }, 'Low ')];
+        for (const color of colors) {
+            legendItems.push(Text({ color }, '█'));
+        }
+        legendItems.push(Text({ color: 'gray', dim: true }, ' High'));
+        displayLines.push(Box({ flexDirection: 'row', gap: 1, marginTop: 1 }, ...legendItems));
+    }
+    return Box({ flexDirection: 'column' }, ...displayLines);
+}
+//# sourceMappingURL=time-heatmap.js.map

package/dist/molecules/data-viz/time-heatmap.js.map

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

package/dist/molecules/select.d.ts

@@ -16,6 +16,7 @@
  * - Descriptions and hints
  */
 import type { VNode } from '../utils/types.js';
+import { type Key } from '../hooks/index.js';
 export interface SelectItem<T = any> {
     /** Unique value */
     value: T;
@@ -92,6 +93,7 @@ export declare function createSelect<T = any>(options: SelectOptions<T>): {
     moveUp: () => void;
     moveDown: () => void;
     selectIndex: (index: number) => void;
+    handleInput: (input: string, key: Key) => void;
 };
 /**
  * Render a select component

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

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

package/dist/molecules/select.js

@@ -258,10 +258,8 @@ export function createSelect(options) {
             updateSearch(input);
         }
     };
-    // Register input handler
-    // Note: We always register and check isActive dynamically in handleInput
+    // handleInput is exposed to be registered during render phase
     // This allows isActive to be a reactive getter function
-    useInput(handleInput);
     // Select specific index (for mouse clicks)
     const selectIndex = (index) => {
         const filtered = getFilteredItems();
@@ -307,6 +305,7 @@ export function createSelect(options) {
         moveUp,
         moveDown,
         selectIndex,
+        handleInput, // Expose handler to be registered during render
     };
 }
 /**
@@ -316,6 +315,8 @@ export function renderSelect(state, options) {
     const chars = getChars();
     const isAscii = getRenderMode() === 'ascii';
     const { multiple = false, cursorIndicator = chars.arrows.right, selectedIndicator = chars.radio.selected, checkedIndicator = chars.checkbox.checked, uncheckedIndicator = chars.checkbox.unchecked, activeColor = themeColor('info'), selectedColor = themeColor('success'), disabledColor = themeColor('mutedForeground'), showCount = true, searchable = false, searchPlaceholder = 'Type to search...', fullWidth = false, } = options;
+    // Register input handler during render phase
+    useInput(state.handleInput);
     const { items: visibleItems, startIndex } = state.getVisibleItems();
     const filtered = state.getFilteredItems();
     const selected = state.selected();