eidotter 0.15.0 → 0.16.1

package/dist/components/Switch/components/Switch.d.ts

@@ -1,51 +1,31 @@
 import React from 'react';
 import './Switch.css';
 export interface SwitchProps {
-    /**
-     * Whether the switch is checked
-     */
+    /** Whether the switch is on (controlled) */
     checked?: boolean;
-    /**
-     * Default checked state (uncontrolled)
-     */
+    /** Default state (uncontrolled) */
     defaultChecked?: boolean;
-    /**
-     * Callback when the switch state changes
-     */
+    /** Callback when state changes */
     onCheckedChange?: (checked: boolean) => void;
-    /**
-     * Whether the switch is disabled
-     */
+    /** Whether the switch is disabled */
     disabled?: boolean;
-    /**
-     * Name for form submission
-     */
+    /** Size variant */
+    size?: 'sm' | 'md';
+    /** Switch type */
+    type?: 'default' | 'slim';
+    /** Label text */
+    label?: string;
+    /** Name for form submission */
     name?: string;
-    /**
-     * Value for form submission
-     */
+    /** Value for form submission */
     value?: string;
-    /**
-     * Additional CSS class name
-     */
+    /** Additional CSS class name */
     className?: string;
-    /**
-     * Accessible label for screen readers
-     */
+    /** Accessible label */
     'aria-label'?: string;
-    /**
-     * ID of element that labels this switch
-     */
-    'aria-labelledby'?: string;
 }
 /**
- * DOS-styled Switch component with authentic terminal aesthetics
- *
- * Features:
- * - Controlled and uncontrolled modes
- * - Disabled state
- * - Full keyboard accessibility
- * - WCAG 2.1 AA compliant
- * - DOS-authentic styling with CGA colors
+ * DOS-styled Switch with phosphor glow toggle effect.
+ * Built on React Aria for accessible toggle behavior.
  */
 export declare const Switch: React.FC<SwitchProps>;

package/dist/components/Tabs/components/Tabs.d.ts

@@ -1,64 +1,33 @@
 import React from 'react';
 import './Tabs.css';
 export interface TabItem {
-    /**
-     * Unique identifier for the tab
-     */
+    /** Unique identifier for the tab */
     id: string;
-    /**
-     * Display label for the tab
-     */
+    /** Display label for the tab */
     label: string;
-    /**
-     * Whether the tab is disabled
-     */
+    /** Whether the tab is disabled */
     disabled?: boolean;
 }
 export interface TabsProps {
-    /**
-     * Array of tab items to display
-     */
+    /** Array of tab items to display */
     tabs: TabItem[];
-    /**
-     * The variant determines the tab styling
-     */
+    /** The variant determines the tab styling */
     variant?: 'underline' | 'pills';
-    /**
-     * The size of the tabs
-     */
-    size?: 'small' | 'medium' | 'large';
-    /**
-     * Currently active tab ID (controlled mode)
-     */
+    /** The size of the tabs */
+    size?: 'sm' | 'md' | 'lg' | 'small' | 'medium' | 'large';
+    /** Currently active tab ID (controlled mode) */
     activeTab?: string;
-    /**
-     * Default active tab ID (uncontrolled mode)
-     */
+    /** Default active tab ID (uncontrolled mode) */
     defaultActiveTab?: string;
-    /**
-     * Callback when active tab changes.
-     * Receives the new tab ID and the previous tab ID,
-     * enabling agents to observe navigation transitions.
-     */
+    /** Callback when active tab changes */
     onTabChange?: (tabId: string, previousTabId: string) => void;
-    /**
-     * Optional CSS class name
-     */
+    /** Optional CSS class name */
     className?: string;
-    /**
-     * Accessible label for the tab list
-     */
+    /** Accessible label for the tab list */
     'aria-label'?: string;
 }
 /**
- * DOS-styled Tabs component for navigation and content switching
- *
- * Features:
- * - Two variants: underline (minimal) and pills (contained)
- * - Three sizes (small, medium, large)
- * - Controlled and uncontrolled modes
- * - Full keyboard navigation (Arrow keys, Home, End)
- * - DOS-authentic styling with CGA colors
- * - WCAG 2.1 AA compliant
+ * DOS-styled Tabs with React Aria keyboard navigation and phosphor indicator.
+ * React Aria handles arrow keys, Home, End, roving tabindex, and ARIA roles.
  */
 export declare const Tabs: React.FC<TabsProps>;

package/dist/components/Tag/components/Tag.d.ts

@@ -5,11 +5,11 @@ export interface TagProps {
     children: React.ReactNode;
     /** Visual variant */
     variant?: 'default' | 'outlined' | 'filled';
-    /** The size of the tag */
-    size?: 'small' | 'medium';
-    /** CGA color token for border and text (e.g. '--color-cga-bright-cyan') */
+    /** Size */
+    size?: 'sm' | 'md' | 'lg' | 'small' | 'medium';
+    /** CGA color token for border and text */
     color?: string;
-    /** Whether the tag appears in selected/active state */
+    /** Whether the tag is selected/active */
     selected?: boolean;
     /** Whether to show a close button */
     closeable?: boolean;
@@ -17,25 +17,15 @@ export interface TagProps {
     disabled?: boolean;
     /** Click handler for the tag body */
     onClick?: (event: React.MouseEvent<HTMLElement>) => void;
-    /** Close handler, called after dismiss animation completes */
+    /** Close handler, called after dismiss animation */
     onClose?: () => void;
     /** Additional CSS class name */
     className?: string;
-    /** Accessible label for the tag */
+    /** Accessible label */
     'aria-label'?: string;
 }
 /**
- * DOS-styled Tag component for interactive labels
- *
- * Extends Badge's display-only approach with click, close, and selection
- * behaviors. Use for content labels, category indicators, and filter chips.
- *
- * Features:
- * - Three visual variants (default, outlined, filled)
- * - Optional close button with DOS-authentic [x]
- * - Toggle-able selected state
- * - Custom CGA color support via CSS custom property
- * - Keyboard accessible (Enter/Space to click, Delete/Backspace to close)
- * - WCAG 2.1 AA compliant
+ * DOS-styled Tag for interactive labels with click, close, and selection.
+ * Extends Badge with interaction behaviors. Uses useAnimatedDismiss for phosphor exit.
  */
 export declare const Tag: React.FC<TagProps>;

package/dist/components/TimelineContainer/components/TimelineContainer.d.ts

@@ -14,7 +14,7 @@ export interface TimelineContainerProps extends React.HTMLAttributes<HTMLDivElem
     mode?: 'interactive' | 'static';
     /**
      * Controlled zoom level — overrides internal state when provided.
-     * Use with `onZoomChange` for full control.
+     * Use with `onZoomChange` for full control. Disables drill-down navigation.
      */
     zoomLevel?: ZoomLevel;
     /**
@@ -56,9 +56,10 @@ export interface TimelineContainerProps extends React.HTMLAttributes<HTMLDivElem
  * TimelineContainer - Interactive multi-level zoom timeline
  *
  * A composite timeline component with 4 zoom levels (year, month, day, hour),
- * entry selection, keyboard shortcuts, and scroll-to-zoom. Uses DOS/CGA
- * aesthetic with eidotter primitives (TimelineNode, Card, Badge, Tag).
+ * entry selection, keyboard shortcuts, scroll-to-zoom, and drill-down navigation.
+ * Uses DOS/CGA aesthetic with eidotter primitives.
  *
  * Supports both controlled and uncontrolled patterns for zoom and selection.
+ * When zoom is uncontrolled, clicking a bucket drills down into that time period.
  */
 export declare const TimelineContainer: React.FC<TimelineContainerProps>;

package/dist/components/TimelineContainer/components/TimelineEntryCard.d.ts

@@ -1,16 +1,20 @@
 import React from 'react';
 import type { TimelineEntryData } from './types';
-import '../../TimelineEntry/components/TimelineEntry.css';
+import './TimelineEntryCard.css';
 export interface TimelineEntryCardProps {
     entry: TimelineEntryData;
     isSelected: boolean;
+    isExpanded?: boolean;
     onSelect?: (id: string) => void;
     footer?: React.ReactNode;
-    children: React.ReactNode;
+    children?: React.ReactNode;
 }
 /**
- * Selectable entry card for TimelineContainer views.
- * Uses TimelineEntry's card CSS for visual consistency with static timelines.
- * Adds selection behavior (aria-pressed, glow variant on select).
+ * Selectable, expandable entry card for TimelineContainer views.
+ *
+ * Uses trigger+panel structure: the button handles click-to-toggle,
+ * the body is a sibling region (not nested inside the button).
+ * This prevents invalid HTML when expanded ReactNode content
+ * contains interactive elements (links, buttons).
  */
 export declare const TimelineEntryCard: React.NamedExoticComponent<TimelineEntryCardProps>;

package/dist/components/TimelineContainer/components/ZoomControls.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { DrillDownEntry } from './useDrillDown';
 import type { ZoomLevel } from './types';
 import './ZoomControls.css';
 export interface ZoomControlsProps {
@@ -8,5 +9,7 @@ export interface ZoomControlsProps {
     onZoomIn: () => void;
     onZoomOut: () => void;
     onReset: () => void;
+    breadcrumbs?: readonly DrillDownEntry[];
+    onBreadcrumbClick?: (index: number) => void;
 }
 export declare const ZoomControls: React.FC<ZoomControlsProps>;

package/dist/components/TimelineContainer/components/index.d.ts

@@ -2,3 +2,4 @@ export { TimelineContainer } from './TimelineContainer';
 export type { TimelineContainerProps } from './TimelineContainer';
 export { ZOOM_LEVELS } from './types';
 export type { TimelineEntry, TimelineEntryData, DateBucket, ZoomLevel } from './types';
+export type { DrillDownEntry, UseDrillDownReturn } from './useDrillDown';

package/dist/components/TimelineContainer/components/timelineUtils.d.ts

@@ -5,6 +5,17 @@
 import type { TimelineEntry, DateBucket, ZoomLevel } from './types';
 /** Format a full timestamp: "Mar 15, 2024 at 2:30pm" */
 export declare function formatTimestamp(iso: string): string;
+/**
+ * Filter buckets to only those within a drilled-into period.
+ * Uses ISO string prefix matching: a year prefix "2024" matches
+ * any periodStart starting with "2024", etc.
+ *
+ * @param buckets - All buckets at the current zoom level
+ * @param periodStart - The parent period's periodStart, or null for no filter
+ * @param parentZoomLevel - The zoom level of the parent period
+ * @returns Filtered buckets (or all buckets if no filter applies)
+ */
+export declare function filterBucketsByPeriod(buckets: readonly DateBucket[], periodStart: string | null, parentZoomLevel: ZoomLevel): readonly DateBucket[];
 /**
  * Group timeline entries into DateBuckets based on the current zoom level.
  */

package/dist/components/TimelineContainer/components/useDrillDown.d.ts

@@ -0,0 +1,42 @@
+import type { ZoomLevel } from './types';
+export interface DrillDownEntry {
+    /** ISO period start for this drill-down level */
+    periodStart: string;
+    /** Human-readable label for breadcrumb display */
+    label: string;
+}
+export interface UseDrillDownOptions {
+    /** Controlled zoom level (from parent). When provided, drill-down is disabled. */
+    zoomLevel?: ZoomLevel;
+    /** Default zoom level for uncontrolled mode */
+    defaultZoomLevel?: ZoomLevel;
+    /** Callback when zoom level changes */
+    onZoomChange?: (level: ZoomLevel) => void;
+}
+export interface UseDrillDownReturn {
+    /** Current zoom level */
+    zoomLevel: ZoomLevel;
+    /** Whether zooming in further is possible */
+    canZoomIn: boolean;
+    /** Whether zooming out further is possible */
+    canZoomOut: boolean;
+    /** Breadcrumb stack of drill-down entries */
+    breadcrumbs: readonly DrillDownEntry[];
+    /** Current drilled-into period start, or null if at root */
+    currentPeriod: string | null;
+    /** Whether drill-down navigation is active (false when zoom is controlled) */
+    isDrillDownEnabled: boolean;
+    /** Drill into a specific period */
+    drillDown: (periodStart: string, label: string) => void;
+    /** Go up one level in the drill-down stack */
+    drillUp: () => void;
+    /** Reset to root level (year) and clear breadcrumbs */
+    reset: () => void;
+}
+/**
+ * Manages drill-down navigation with a breadcrumb stack.
+ * When zoom is uncontrolled, maintains its own zoom state so that
+ * reset() can go directly to 'year' (the outermost level).
+ * When zoom is controlled externally, drill-down is disabled.
+ */
+export declare function useDrillDown({ zoomLevel: controlledLevel, defaultZoomLevel, onZoomChange, }?: UseDrillDownOptions): UseDrillDownReturn;

package/dist/components/TimelineContainer/components/useDrillDown.test.d.ts

@@ -0,0 +1 @@
+export {};