tuiuiu.js 0.1.1

package/dist/atoms/timer.js

@@ -0,0 +1,355 @@
+/**
+ * Timer Component - Presentation timer
+ *
+ * @layer Atom
+ * @description Countdown and stopwatch timer with formatting
+ *
+ * A flexible timer component for countdowns, stopwatches,
+ * and presentation timing. Supports pause/resume and multiple formats.
+ *
+ * @example
+ * ```typescript
+ * import { Timer, createTimer } from 'tuiuiu.js';
+ *
+ * // Create timer state
+ * const timer = createTimer({
+ *   mode: 'stopwatch',
+ *   onTick: (time) => console.log(time),
+ * });
+ *
+ * // Render
+ * Timer({
+ *   time: timer.elapsed(),
+ *   format: 'mm:ss',
+ *   color: 'cyan',
+ * })
+ *
+ * // Control
+ * timer.start();
+ * timer.pause();
+ * timer.resume();
+ * timer.reset();
+ * ```
+ */
+import { Box, Text } from '../primitives/nodes.js';
+// =============================================================================
+// Time Formatting
+// =============================================================================
+/**
+ * Format milliseconds to string
+ */
+export function formatTime(ms, format) {
+    const totalSeconds = Math.floor(Math.abs(ms) / 1000);
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    const milliseconds = Math.floor((Math.abs(ms) % 1000) / 10);
+    const pad = (n, len = 2) => n.toString().padStart(len, '0');
+    const sign = ms < 0 ? '-' : '';
+    switch (format) {
+        case 'ss':
+            return `${sign}${totalSeconds}`;
+        case 'mm:ss':
+            return `${sign}${pad(minutes)}:${pad(seconds)}`;
+        case 'hh:mm:ss':
+            return `${sign}${pad(hours)}:${pad(minutes)}:${pad(seconds)}`;
+        case 'hh:mm:ss.ms':
+            return `${sign}${pad(hours)}:${pad(minutes)}:${pad(seconds)}.${pad(milliseconds)}`;
+        case 'human': {
+            const parts = [];
+            if (hours > 0)
+                parts.push(`${hours}h`);
+            if (minutes > 0)
+                parts.push(`${minutes}m`);
+            parts.push(`${seconds}s`);
+            return sign + parts.join(' ');
+        }
+        default:
+            return `${sign}${pad(minutes)}:${pad(seconds)}`;
+    }
+}
+/**
+ * Parse time string to milliseconds
+ */
+export function parseTime(timeStr) {
+    // Try hh:mm:ss format
+    const hhmmss = timeStr.match(/^(\d+):(\d+):(\d+)$/);
+    if (hhmmss) {
+        const [, h, m, s] = hhmmss;
+        return (parseInt(h, 10) * 3600 + parseInt(m, 10) * 60 + parseInt(s, 10)) * 1000;
+    }
+    // Try mm:ss format
+    const mmss = timeStr.match(/^(\d+):(\d+)$/);
+    if (mmss) {
+        const [, m, s] = mmss;
+        return (parseInt(m, 10) * 60 + parseInt(s, 10)) * 1000;
+    }
+    // Try human format (1h 30m 45s)
+    const human = timeStr.match(/(?:(\d+)h)?\s*(?:(\d+)m)?\s*(?:(\d+)s)?/);
+    if (human) {
+        const [, h = '0', m = '0', s = '0'] = human;
+        return (parseInt(h, 10) * 3600 + parseInt(m, 10) * 60 + parseInt(s, 10)) * 1000;
+    }
+    // Try seconds only
+    const secs = parseInt(timeStr, 10);
+    if (!isNaN(secs)) {
+        return secs * 1000;
+    }
+    return 0;
+}
+// =============================================================================
+// Timer Component
+// =============================================================================
+/**
+ * Timer Component
+ *
+ * Renders a formatted time display.
+ */
+export function Timer(props) {
+    const { time, format = 'mm:ss', color = 'white', running = false, paused = false, runningIndicator = '●', pausedIndicator = '❚❚', showIndicator = true, label, bold = true, dimWhenPaused = true, } = props;
+    const timeStr = formatTime(time, format);
+    const indicator = running ? runningIndicator : paused ? pausedIndicator : '';
+    const indicatorColor = running ? 'green' : paused ? 'yellow' : 'gray';
+    const children = [];
+    if (label) {
+        children.push(Text({ color: 'gray' }, `${label} `));
+    }
+    if (showIndicator && indicator) {
+        children.push(Text({ color: indicatorColor }, `${indicator} `));
+    }
+    children.push(Text({
+        color,
+        bold,
+        dim: dimWhenPaused && paused,
+    }, timeStr));
+    return Box({ flexDirection: 'row' }, ...children);
+}
+// =============================================================================
+// Timer State Manager
+// =============================================================================
+/**
+ * Create timer state manager
+ *
+ * @example
+ * ```typescript
+ * // Stopwatch
+ * const stopwatch = createTimer({
+ *   mode: 'stopwatch',
+ *   onTick: (elapsed) => setTime(elapsed),
+ * });
+ * stopwatch.start();
+ *
+ * // Countdown
+ * const countdown = createTimer({
+ *   mode: 'countdown',
+ *   initialTime: 60000, // 1 minute
+ *   onComplete: () => console.log('Time up!'),
+ * });
+ * countdown.start();
+ * ```
+ */
+export function createTimer(options = {}) {
+    const { mode = 'stopwatch', initialTime = 0, onTick, onComplete, tickInterval = 1000, autoStart = false, } = options;
+    let elapsed = mode === 'countdown' ? initialTime : 0;
+    let running = false;
+    let paused = false;
+    let startTime = 0;
+    let pausedAt = 0;
+    let intervalId = null;
+    const tick = () => {
+        if (!running || paused)
+            return;
+        const now = Date.now();
+        const delta = now - startTime;
+        if (mode === 'stopwatch') {
+            elapsed = delta;
+        }
+        else {
+            elapsed = Math.max(0, initialTime - delta);
+            if (elapsed === 0) {
+                stop();
+                onComplete?.();
+                return;
+            }
+        }
+        onTick?.(elapsed);
+    };
+    const start = () => {
+        if (running)
+            return;
+        running = true;
+        paused = false;
+        startTime = Date.now();
+        if (mode === 'countdown') {
+            elapsed = initialTime;
+        }
+        else {
+            elapsed = 0;
+        }
+        intervalId = setInterval(tick, tickInterval);
+        tick(); // Immediate first tick
+    };
+    const pause = () => {
+        if (!running || paused)
+            return;
+        paused = true;
+        pausedAt = Date.now();
+        if (intervalId) {
+            clearInterval(intervalId);
+            intervalId = null;
+        }
+    };
+    const resume = () => {
+        if (!running || !paused)
+            return;
+        paused = false;
+        const pauseDuration = Date.now() - pausedAt;
+        startTime += pauseDuration;
+        intervalId = setInterval(tick, tickInterval);
+        tick();
+    };
+    const reset = () => {
+        stop();
+        elapsed = mode === 'countdown' ? initialTime : 0;
+        onTick?.(elapsed);
+    };
+    const toggle = () => {
+        if (!running) {
+            start();
+        }
+        else if (paused) {
+            resume();
+        }
+        else {
+            pause();
+        }
+    };
+    const setTime = (ms) => {
+        elapsed = Math.max(0, ms);
+        if (mode === 'countdown') {
+            startTime = Date.now() - (initialTime - elapsed);
+        }
+        else {
+            startTime = Date.now() - elapsed;
+        }
+        onTick?.(elapsed);
+    };
+    const addTime = (ms) => {
+        setTime(elapsed + ms);
+    };
+    const subtractTime = (ms) => {
+        setTime(elapsed - ms);
+    };
+    const stop = () => {
+        running = false;
+        paused = false;
+        if (intervalId) {
+            clearInterval(intervalId);
+            intervalId = null;
+        }
+    };
+    // Auto-start if requested
+    if (autoStart) {
+        start();
+    }
+    return {
+        elapsed: () => elapsed,
+        isRunning: () => running && !paused,
+        isPaused: () => paused,
+        start,
+        pause,
+        resume,
+        reset,
+        toggle,
+        setTime,
+        addTime,
+        subtractTime,
+        stop,
+    };
+}
+/**
+ * Create a multi-timer manager
+ *
+ * Useful for tracking time per slide/page
+ *
+ * @example
+ * ```typescript
+ * const timers = createMultiTimer();
+ *
+ * // Create timer for each slide
+ * timers.create('slide-1', { mode: 'stopwatch' });
+ * timers.create('slide-2', { mode: 'stopwatch' });
+ *
+ * // When entering a slide
+ * timers.get('slide-1').start();
+ *
+ * // When leaving a slide
+ * timers.get('slide-1').pause();
+ * ```
+ */
+export function createMultiTimer() {
+    const timers = new Map();
+    const get = (id) => {
+        const timer = timers.get(id);
+        if (!timer) {
+            throw new Error(`Timer '${id}' not found`);
+        }
+        return timer;
+    };
+    const create = (id, options = {}) => {
+        if (timers.has(id)) {
+            return timers.get(id);
+        }
+        const timer = createTimer(options);
+        timers.set(id, timer);
+        return timer;
+    };
+    const remove = (id) => {
+        const timer = timers.get(id);
+        if (timer) {
+            timer.stop();
+            timers.delete(id);
+        }
+    };
+    const pauseAll = () => {
+        for (const timer of timers.values()) {
+            timer.pause();
+        }
+    };
+    const resumeAll = () => {
+        for (const timer of timers.values()) {
+            timer.resume();
+        }
+    };
+    const resetAll = () => {
+        for (const timer of timers.values()) {
+            timer.reset();
+        }
+    };
+    const stopAll = () => {
+        for (const timer of timers.values()) {
+            timer.stop();
+        }
+        timers.clear();
+    };
+    const ids = () => [...timers.keys()];
+    const totalElapsed = () => {
+        let total = 0;
+        for (const timer of timers.values()) {
+            total += timer.elapsed();
+        }
+        return total;
+    };
+    return {
+        get,
+        create,
+        remove,
+        pauseAll,
+        resumeAll,
+        resetAll,
+        stopAll,
+        ids,
+        totalElapsed,
+    };
+}
+//# sourceMappingURL=timer.js.map

package/dist/atoms/timer.js.map

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

package/dist/atoms/tooltip.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Tooltip - Hover/focus tooltips and related visual components
+ *
+ * @layer Atom
+ * @description Tooltips, popovers, badges, and info boxes
+ *
+ * Features:
+ * - Position relative to target (top/bottom/left/right)
+ * - Arrow pointer
+ * - Border styles
+ * - Background color
+ * - Show/hide control
+ */
+import type { VNode, ColorValue } from '../utils/types.js';
+type BorderStyle = 'single' | 'double' | 'round' | 'bold' | 'none';
+export type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+export interface TooltipOptions {
+    /** Tooltip content */
+    content: string | VNode;
+    /** Position relative to target */
+    position?: TooltipPosition;
+    /** Show arrow pointer */
+    arrow?: boolean;
+    /** Border style */
+    borderStyle?: BorderStyle;
+    /** Border color */
+    borderColor?: ColorValue;
+    /** Text color */
+    color?: ColorValue;
+    /** Background color */
+    backgroundColor?: ColorValue;
+    /** Is visible */
+    visible?: boolean;
+    /** Max width */
+    maxWidth?: number;
+}
+/**
+ * Tooltip - Tooltip display (position is relative to parent layout)
+ *
+ * @example
+ * // Tooltip above content
+ * Box({ flexDirection: 'column' },
+ *   Tooltip({ content: 'Press Enter to select', position: 'top', visible: focused }),
+ *   Text({}, 'Button')
+ * )
+ *
+ * @example
+ * // Tooltip with arrow
+ * Tooltip({
+ *   content: 'Help text here',
+ *   position: 'right',
+ *   arrow: true,
+ *   borderStyle: 'round',
+ * })
+ */
+export declare function Tooltip(props: TooltipOptions): VNode | null;
+export interface WithTooltipOptions {
+    /** Target element */
+    children: VNode;
+    /** Tooltip content */
+    tooltip: string | VNode;
+    /** Position */
+    position?: TooltipPosition;
+    /** Is focused/hovered */
+    active?: boolean;
+    /** Tooltip props */
+    tooltipProps?: Partial<TooltipOptions>;
+}
+/**
+ * WithTooltip - Wrapper that shows tooltip when active
+ *
+ * @example
+ * WithTooltip({
+ *   children: Button({ label: 'Submit' }),
+ *   tooltip: 'Press Enter to submit the form',
+ *   position: 'top',
+ *   active: isFocused,
+ * })
+ */
+export declare function WithTooltip(props: WithTooltipOptions): VNode;
+export interface HelpTooltipOptions {
+    /** Help text */
+    text: string;
+    /** Position */
+    position?: TooltipPosition;
+    /** Is active/focused */
+    active?: boolean;
+    /** Icon */
+    icon?: string;
+    /** Icon color */
+    iconColor?: ColorValue;
+}
+/**
+ * HelpTooltip - Help icon that shows tooltip when active
+ *
+ * @example
+ * HelpTooltip({
+ *   text: 'Enter your email address',
+ *   position: 'right',
+ *   active: focused,
+ * })
+ */
+export declare function HelpTooltip(props: HelpTooltipOptions): VNode;
+export type InfoBoxType = 'info' | 'warning' | 'error' | 'success' | 'tip';
+export interface InfoBoxOptions {
+    /** Message content */
+    message: string | VNode;
+    /** Box type */
+    type?: InfoBoxType;
+    /** Title (optional) */
+    title?: string;
+    /** Show icon */
+    showIcon?: boolean;
+    /** Width */
+    width?: number;
+}
+/**
+ * InfoBox - Information callout box
+ *
+ * @example
+ * InfoBox({
+ *   type: 'warning',
+ *   title: 'Caution',
+ *   message: 'This action cannot be undone.',
+ * })
+ */
+export declare function InfoBox(props: InfoBoxOptions): VNode;
+export interface PopoverOptions {
+    /** Popover content */
+    content: VNode;
+    /** Position */
+    position?: TooltipPosition;
+    /** Is visible */
+    visible?: boolean;
+    /** Border style */
+    borderStyle?: BorderStyle;
+    /** Border color */
+    borderColor?: ColorValue;
+    /** Width */
+    width?: number;
+    /** Show arrow */
+    arrow?: boolean;
+}
+/**
+ * Popover - Positioned popover content
+ *
+ * @example
+ * Popover({
+ *   content: MenuItems(),
+ *   position: 'bottom',
+ *   visible: isOpen,
+ *   width: 30,
+ * })
+ */
+export declare function Popover(props: PopoverOptions): VNode | null;
+export interface BadgeOptions {
+    /** Badge label text */
+    label?: string;
+    /** Badge color */
+    color?: ColorValue;
+    /** Variant */
+    variant?: 'solid' | 'outline' | 'subtle';
+}
+/**
+ * Badge - Small badge/chip
+ *
+ * @example
+ * Badge({ label: 'NEW', color: 'green' })
+ * Badge({ label: '5', color: 'red', variant: 'solid' })
+ */
+export declare function Badge(props: BadgeOptions): VNode;
+export interface TagOptions {
+    /** Tag label */
+    label: string;
+    /** Tag color */
+    color?: ColorValue;
+    /** Removable */
+    removable?: boolean;
+    /** On remove callback */
+    onRemove?: () => void;
+}
+/**
+ * Tag - Labeled tag with optional remove
+ *
+ * @example
+ * Tag({ label: 'TypeScript', color: 'blue' })
+ * Tag({ label: 'React', color: 'cyan', removable: true })
+ */
+export declare function Tag(props: TagOptions): VNode;
+export {};
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/atoms/tooltip.d.ts.map

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