@simplysm/solid 13.0.69 → 13.0.71

package/README.md

@@ -1,10 +1,10 @@
 # @simplysm/solid
 
-A SolidJS UI component library for enterprise back-office applications such as ERP and MES. Provides components for data-intensive forms, tables, and sidebar layouts with Tailwind CSS styling, dark mode, and responsive design.
+A SolidJS UI component library for enterprise back-office applications such as ERP and MES.
 
 ## Installation
 
-```bash
+```
 pnpm add @simplysm/solid
 ```
 
@@ -13,232 +13,205 @@ pnpm add @simplysm/solid
 - `tailwindcss` ^3.4
 
 **Optional Peer Dependencies:**
-- `echarts` ^6.0 -- Required for Echarts chart components
+- `echarts` ^6.0 — Required for Echarts chart components
 
 ## Configuration
 
-### Tailwind CSS
-
-`@simplysm/solid` provides a Tailwind CSS preset. Register it as a preset in your app's `tailwind.config.ts` to automatically apply custom themes including semantic colors, field sizes, and z-index values.
+Register the Tailwind preset in your app's `tailwind.config.ts`:
 
 ```typescript
-// tailwind.config.ts
 import simplysmPreset from "@simplysm/solid/tailwind.config";
-
 export default {
   darkMode: "class",
   presets: [simplysmPreset],
-  content: [
-    "./src/**/*.{ts,tsx}",
-    ...simplysmPreset.content,
-  ],
+  content: ["./src/**/*.{ts,tsx}", ...simplysmPreset.content],
 };
 ```
 
-### Provider Setup
-
-Use `SystemProvider` to wrap your app. It provides all infrastructure providers (config, theme, logger, notification, service client, etc.).
-
-For programmatic dialogs and printing, add `DialogProvider` and/or `PrintProvider` separately. Place them **below your own Providers** if your dialog/print content needs access to them.
-
-```tsx
-import { SystemProvider, DialogProvider, PrintProvider } from "@simplysm/solid";
-
-function App() {
-  return (
-    <SystemProvider clientName="my-app">
-      {/* Your Providers can go here */}
-      <DialogProvider>
-        <PrintProvider>
-          <AppRoot />
-        </PrintProvider>
-      </DialogProvider>
-    </SystemProvider>
-  );
-}
-```
-
-> **Why separate?** `DialogProvider` and `PrintProvider` render user-provided components (via `dialog.show(factory)` / `print.toPrinter(factory)`). By placing them below your Providers, the factory content can access your contexts (e.g., auth, data stores). `SystemProvider` provides infrastructure that doesn't render user components.
-
-| Provider | Required | Must be inside | Description |
-|----------|----------|----------------|-------------|
-| `SystemProvider` | Yes | (root) | Infrastructure: config, theme, logger, notification, busy, service client, shared data |
-| `DialogProvider` | If using `useDialog()` | `SystemProvider` | Programmatic dialog management |
-| `PrintProvider` | If using `usePrint()` | `SystemProvider` | Printing and PDF generation |
-
-```tsx
-import { SystemProvider, DialogProvider, PrintProvider, useServiceClient, useSyncStorage, useLogger, useSharedData } from "@simplysm/solid";
-import { onMount } from "solid-js";
-
-function AppRoot() {
-  const serviceClient = useServiceClient();
-
-  onMount(async () => {
-    await serviceClient.connect("main", { port: 3000 });
-    useSyncStorage()!.configure((origin) => myStorageAdapter);
-    useLogger().configure((origin) => myLogAdapter);
-    useSharedData().configure((origin) => definitions);
-  });
-}
-```
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `clientName` | `string` | (required) | Client identifier (used as storage key prefix) |
-| `busyVariant` | `BusyVariant` | `"spinner"` | Busy overlay display variant (`"spinner"` or `"bar"`) |
-
-**StorageAdapter interface:**
+Import base CSS in your entry point:
 
 ```typescript
-interface StorageAdapter {
-  getItem(key: string): string | null | Promise<string | null>;
-  setItem(key: string, value: string): void | Promise<unknown>;
-  removeItem(key: string): void | Promise<void>;
-}
+import "@simplysm/solid/tailwind.css";
 ```
 
-**LogAdapter interface:**
+Wrap your app with providers:
 
-```typescript
-interface LogAdapter {
-  write(severity: "error" | "warn" | "info" | "log", ...data: any[]): Promise<void> | void;
-}
+```tsx
+import { SystemProvider, DialogProvider, PrintProvider } from "@simplysm/solid";
+<SystemProvider clientName="my-app">
+  <DialogProvider>
+    <PrintProvider>
+      <App />
+    </PrintProvider>
+  </DialogProvider>
+</SystemProvider>
 ```
 
-### Base CSS
+| Provider | Required | Description |
+|----------|----------|-------------|
+| `SystemProvider` | Yes | Infrastructure: config, theme, logger, notification, busy, service client, shared data |
+| `DialogProvider` | If using `useDialog()` | Programmatic dialog management |
+| `PrintProvider` | If using `usePrint()` | Printing and PDF generation |
+
+## Source Index
+
+### Form Control
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/components/form-control/Button.tsx` | `ButtonProps`, `Button` | Button with ripple effect, theme/variant/size/inset options | `Button.spec.tsx` |
+| `src/components/form-control/select/Select.tsx` | `SelectProps`, `Select` | Dropdown selection with single/multiple mode, search, hierarchical items | `Select.spec.tsx` |
+| `src/components/form-control/combobox/Combobox.tsx` | `ComboboxProps`, `Combobox` | Autocomplete with async search, debounce, and custom value support | `Combobox.spec.tsx` |
+| `src/components/form-control/field/TextInput.tsx` | `TextInputProps`, `TextInput` | Text input with IME support, format mask, prefix slot, validation | `TextInput.spec.tsx` |
+| `src/components/form-control/field/NumberInput.tsx` | `NumberInputProps`, `NumberInput` | Numeric input with thousand-separator, min/max, prefix slot, validation | `NumberInput.spec.tsx` |
+| `src/components/form-control/field/DatePicker.tsx` | `DatePickerProps`, `DatePicker` | Date input supporting year/month/date units (DateOnly type) | `DatePicker.spec.tsx` |
+| `src/components/form-control/field/DateTimePicker.tsx` | `DateTimePickerProps`, `DateTimePicker` | Date-time input supporting minute/second units (DateTime type) | `DateTimePicker.spec.tsx` |
+| `src/components/form-control/field/TimePicker.tsx` | `TimePickerProps`, `TimePicker` | Time input supporting minute/second units (Time type) | `TimePicker.spec.tsx` |
+| `src/components/form-control/field/Textarea.tsx` | `TextareaProps`, `Textarea` | Auto-height textarea with IME support, minRows, validation | `Textarea.spec.tsx` |
+| `src/components/form-control/field/Field.styles.ts` | `FieldSize`, `fieldBaseClass`, `fieldSizeClasses`, `fieldInsetClass`, `fieldInsetHeightClass`, `fieldInsetSizeHeightClasses`, `fieldDisabledClass`, `textAreaBaseClass`, `textAreaSizeClasses`, `fieldInputClass`, `fieldGapClasses`, `getFieldWrapperClass`, `getTextareaWrapperClass` | Shared Tailwind class tokens and wrapper class generators for field components | - |
+| `src/components/form-control/checkbox/Checkbox.tsx` | `CheckboxProps`, `Checkbox` | Checkbox with ripple, controlled/uncontrolled, inset/inline modes | `Checkbox.spec.tsx` |
+| `src/components/form-control/checkbox/Checkbox.styles.ts` | `CheckboxSize`, `checkboxBaseClass`, `indicatorBaseClass`, `checkedClass`, `checkboxSizeClasses`, `checkboxInsetClass`, `checkboxInsetSizeHeightClasses`, `checkboxInlineClass`, `checkboxDisabledClass` | Tailwind class tokens shared by Checkbox and Radio components | - |
+| `src/components/form-control/checkbox/Radio.tsx` | `RadioProps`, `Radio` | Radio button (single-select variant of Checkbox) with ripple effect | `Radio.spec.tsx` |
+| `src/components/form-control/checkbox/CheckboxGroup.tsx` | `CheckboxGroup` | Group of checkboxes with multi-select value binding and validation | `CheckboxGroup.spec.tsx` |
+| `src/components/form-control/checkbox/RadioGroup.tsx` | `RadioGroup` | Group of radio buttons with single-select value binding and validation | `RadioGroup.spec.tsx` |
+| `src/components/form-control/color-picker/ColorPicker.tsx` | `ColorPickerProps`, `ColorPicker` | Native color picker input (#RRGGBB) with size and inset support | `ColorPicker.spec.tsx` |
+| `src/components/form-control/date-range-picker/DateRangePicker.tsx` | `DateRangePeriodType`, `DateRangePickerProps`, `DateRangePicker` | Date range input with day/month/range period type selection | `DateRangePicker.spec.tsx` |
+| `src/components/form-control/editor/RichTextEditor.tsx` | `RichTextEditorProps`, `RichTextEditor` | WYSIWYG rich text editor (Tiptap) with toolbar, table, image support | - |
+| `src/components/form-control/numpad/Numpad.tsx` | `NumpadProps`, `Numpad` | On-screen numeric keypad with optional ENT/minus buttons | `Numpad.spec.tsx` |
+| `src/components/form-control/state-preset/StatePreset.tsx` | `StatePresetProps`, `StatePreset` | Named state preset chips — save, restore, and overwrite arbitrary values | - |
+| `src/components/form-control/ThemeToggle.tsx` | `ThemeToggleProps`, `ThemeToggle` | Icon button that cycles light/system/dark theme modes | - |
+| `src/components/form-control/Invalid.tsx` | `InvalidProps`, `Invalid` | Validation wrapper that shows border or dot indicator with native form validity | `Invalid.spec.tsx` |
 
-Import the base CSS in your entry point:
-
-```typescript
-// entry point (e.g., index.tsx)
-import "@simplysm/solid/tailwind.css";
-```
+### Layout
 
-## Components
-
-### Form Controls
-
-- [`Button`](docs/form-controls.md#button) - Interactive button with Material Design ripple effect
-- [`TextInput`](docs/form-controls.md#textinput) - Text input with format mask and IME composition support
-- [`NumberInput`](docs/form-controls.md#numberinput) - Number input with thousand separators and decimal places
-- [`DatePicker`](docs/form-controls.md#datepicker) - Date input supporting year, month, and date units (`DateOnly` type)
-- [`DateTimePicker`](docs/form-controls.md#datetimepicker) - Date-time input supporting minute and second units (`DateTime` type)
-- [`TimePicker`](docs/form-controls.md#timepicker) - Time input supporting minute and second units (`Time` type)
-- [`DateRangePicker`](docs/form-controls.md#daterangepicker) - Date range input with period type selection (day/month/range)
-- [`Textarea`](docs/form-controls.md#textarea) - Multi-line text input with auto-height and IME support
-- [`Select`](docs/form-controls.md#select) - Dropdown selection with single/multiple, hierarchical items, and compound components
-- [`SelectList`](docs/form-controls.md#selectlist) - List-style single selection with search, pagination, and slot customization
-- [`DataSelectButton`](docs/form-controls.md#dataselectbutton) - Modal-based selection button with key-based loading
-- [`SharedDataSelect`](docs/form-controls.md#shareddataselect) - SharedData-connected Select wrapper
-- [`SharedDataSelectButton`](docs/form-controls.md#shareddataselectbutton) - SharedData-connected DataSelectButton wrapper
-- [`SharedDataSelectList`](docs/form-controls.md#shareddataselectlist) - SharedData-connected SelectList wrapper
-- [`Combobox`](docs/form-controls.md#combobox) - Autocomplete with async search and debouncing
-- [`Checkbox`](docs/form-controls.md#checkbox--radio) / [`Radio`](docs/form-controls.md#checkbox--radio) - Checkbox and radio button
-- [`CheckboxGroup`](docs/form-controls.md#checkboxgroup--radiogroup) / [`RadioGroup`](docs/form-controls.md#checkboxgroup--radiogroup) - Group components for multiple/single selection
-- [`ColorPicker`](docs/form-controls.md#colorpicker) - Color selection component
-- [`ThemeToggle`](docs/form-controls.md#themetoggle) - Dark/light/system theme cycle toggle
-- [`RichTextEditor`](docs/form-controls.md#richtexteditor) - Tiptap-based rich text editor with formatting, tables, images
-- [`Invalid`](docs/form-controls.md#invalid) - Wrapper component for form validation using native browser validation
-- [`Numpad`](docs/form-controls.md#numpad) - Numeric keypad for touch-based input
-- [`StatePreset`](docs/form-controls.md#statepreset) - Save/load screen state as presets
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/components/layout/FormGroup.tsx` | `FormGroupProps`, `FormGroupItemProps`, `FormGroup` | Labeled field group in vertical or inline (horizontal) layout | `FormGroup.spec.tsx` |
+| `src/components/layout/FormTable.tsx` | `FormTableProps`, `FormTable` | Table layout for aligned label/field rows in forms | `FormTable.spec.tsx` |
+| `src/components/layout/sidebar/Sidebar.tsx` | `SidebarProps`, `SidebarContainerProps`, `SidebarMenuProps`, `SidebarUserMenu`, `SidebarUserProps`, `Sidebar` | Collapsible sidebar with slide animation, responsive desktop/mobile behavior | `Sidebar.spec.tsx` |
+| `src/components/layout/sidebar/SidebarContext.ts` | `SM_MEDIA_QUERY`, `SidebarContextValue`, `SidebarContext`, `useSidebarContext`, `useSidebarContextOptional` | Context providing toggle state for Sidebar open/close coordination | - |
+| `src/components/layout/topbar/Topbar.tsx` | `TopbarProps`, `TopbarContainerProps`, `TopbarMenuItem`, `TopbarMenuProps`, `TopbarUserMenu`, `TopbarUserProps`, `Topbar` | App topbar with optional sidebar toggle button and menu/user slots | - |
+| `src/components/layout/topbar/TopbarContext.ts` | `TopbarContextValue`, `TopbarContext`, `useTopbarActionsAccessor`, `createTopbarActions` | Context for injecting page-level action buttons into the topbar | `createTopbarActions.spec.tsx` |
 
 ### Data
 
-- [`Table`](docs/data-components.md#table) - Basic HTML table wrapper with consistent styling
-- [`DataSheet`](docs/data-components.md#datasheet) - Advanced data table with sorting, pagination, selection, tree expansion, column resize, drag reorder
-- [`List`](docs/data-components.md#list) - Tree-view list with keyboard navigation
-- [`Pagination`](docs/data-components.md#pagination) - Page navigation component
-- [`Calendar`](docs/data-components.md#calendar) - Calendar-style data display
-- [`PermissionTable`](docs/data-components.md#permissiontable) - Hierarchical permission management table with cascading checks
-- [`CrudSheet`](docs/data-components.md#crudsheet) - CRUD data sheet with search, inline/modal editing, Excel import/export, and select mode
-- [`CrudDetail`](docs/data-components.md#cruddetail) - CRUD detail form with load, save, delete, and topbar action integration
-- [`Kanban`](docs/layout.md#kanban) - Kanban board with drag-and-drop, lane collapse, multi-select
-
-### Layout
-
-- [`Sidebar`](docs/layout.md#sidebar) - Sidebar navigation with responsive mobile overlay
-- [`Topbar`](docs/layout.md#topbar) - Top navigation bar with menus, user dropdown, and actions slot
-- [`FormGroup`](docs/layout.md#formgroup) - Form fields layout with labels (vertical/inline)
-- [`FormTable`](docs/layout.md#formtable) - Table-based form layout
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/components/data/Table.tsx` | `TableProps`, `Table` | Simple bordered HTML table with optional inset (borderless) style | `Table.spec.tsx` |
+| `src/components/data/list/List.tsx` | `ListProps`, `List` | Keyboard-navigable list container with tree expand/collapse support | `List.spec.tsx` |
+| `src/components/data/list/ListContext.ts` | `ListContextValue`, `ListContext`, `useListContext` | Context carrying nesting level for recursive List rendering | - |
+| `src/components/data/list/ListItem.styles.ts` | `listItemBaseClass`, `listItemSizeClasses`, `listItemSelectedClass`, `listItemDisabledClass`, `listItemReadonlyClass`, `listItemIndentGuideClass`, `listItemContentClass`, `getListItemSelectedIconClass` | Tailwind class tokens for ListItem states (selected, disabled, readonly, indent) | - |
+| `src/components/data/Pagination.tsx` | `PaginationProps`, `Pagination` | Page navigation bar with first/prev/next/last buttons | `Pagination.spec.tsx` |
+| `src/components/data/sheet/DataSheet.tsx` | `DataSheet` | Feature-rich data grid with sorting, selection, tree expand, reorder, pagination | `DataSheet.spec.tsx` |
+| `src/components/data/sheet/DataSheet.styles.ts` | `dataSheetContainerClass`, `tableClass`, `thClass`, `thContentClass`, `tdClass`, `summaryThClass`, `insetContainerClass`, `insetTableClass`, `defaultContainerClass`, `sortableThClass`, `sortIconClass`, `toolbarClass`, `fixedClass`, `fixedLastClass`, `resizerClass`, `resizeIndicatorClass`, `featureThClass`, `featureTdClass`, `expandIndentGuideClass`, `expandIndentGuideLineClass`, `expandToggleClass`, `selectSingleClass`, `selectSingleSelectedClass`, `selectSingleUnselectedClass`, `reorderHandleClass`, `reorderIndicatorClass`, `featureCellWrapperClass`, `featureCellBodyWrapperClass`, `featureCellClickableClass`, `featureCellBodyClickableClass`, `reorderCellWrapperClass`, `configButtonClass` | Tailwind class tokens for all DataSheet internal visual elements | - |
+| `src/components/data/sheet/types.ts` | `DataSheetProps`, `DataSheetColumnProps`, `DataSheetCellContext`, `SortingDef`, `DataSheetConfig`, `DataSheetConfigColumn`, `DataSheetColumnDef`, `HeaderDef`, `FlatItem`, `DataSheetDragPosition`, `DataSheetReorderEvent`, `DataSheetConfigColumnInfo` | TypeScript types and interfaces for DataSheet props, column defs, and internal structures | - |
+| `src/components/data/calendar/Calendar.tsx` | `CalendarProps`, `Calendar` | Monthly calendar grid that renders arbitrary items on their DateOnly date | - |
+| `src/components/data/kanban/Kanban.tsx` | `KanbanCardProps`, `KanbanLaneProps`, `KanbanProps`, `Kanban` | Kanban board with drag-and-drop card reordering and multi-select | `Kanban.selection.spec.tsx` |
+| `src/components/data/kanban/KanbanContext.ts` | `KanbanCardRef`, `KanbanDropInfo`, `KanbanDropTarget`, `KanbanContextValue`, `KanbanContext`, `useKanbanContext`, `KanbanLaneContextValue`, `KanbanLaneContext`, `useKanbanLaneContext` | Contexts sharing drag state and selection state between Kanban board and lanes | - |
 
 ### Display
 
-- [`Card`](docs/display.md#card) - Container with shadow effect
-- [`Tag`](docs/display.md#tag) - Inline tag/badge component
-- [`Link`](docs/display.md#link) - Inline text link
-- [`Alert`](docs/display.md#alert) - Block-level alert/notice component
-- [`Icon`](docs/display.md#icon) - Tabler Icons wrapper (scales with surrounding text)
-- [`Progress`](docs/display.md#progress) - Progress indicator
-- [`Barcode`](docs/display.md#barcode) - Barcode/QR code rendering (100+ barcode types)
-- [`Echarts`](docs/display.md#echarts) - Apache ECharts chart wrapper
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/components/display/Barcode.tsx` | `BarcodeType`, `BarcodeProps`, `Barcode` | Barcode/QR code renderer using bwip-js with many format options | `Barcode.spec.tsx` |
+| `src/components/display/Card.tsx` | `CardProps`, `Card` | Elevated card container with shadow and fade-in animation | `Card.spec.tsx` |
+| `src/components/display/Echarts.tsx` | `EchartsProps`, `Echarts` | Apache ECharts wrapper with resize observer and busy overlay support | - |
+| `src/components/display/Icon.tsx` | `IconProps`, `Icon` | Wrapper for Tabler icon components with size normalization | - |
+| `src/components/display/Tag.tsx` | `TagTheme`, `TagProps`, `Tag` | Inline colored badge/tag with semantic theme options | `Tag.spec.tsx` |
+| `src/components/display/Link.tsx` | `LinkTheme`, `LinkProps`, `Link` | Themed anchor link with disabled state support | `Link.spec.tsx` |
+| `src/components/display/Alert.tsx` | `AlertTheme`, `AlertProps`, `Alert` | Block alert box with semantic theme background colors | `Alert.spec.tsx` |
 
 ### Disclosure
 
-- [`Tabs`](docs/disclosure.md#tabs) - Tab navigation component
-- [`Collapse`](docs/disclosure.md#collapse) - Content collapse/expand animation
-- [`Dropdown`](docs/disclosure.md#dropdown) - Positioned dropdown popup
-- [`Dialog`](docs/disclosure.md#dialog) - Modal dialog with drag, resize, floating mode, and programmatic `useDialog`
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/components/disclosure/Collapse.tsx` | `CollapseProps`, `Collapse` | Animated height-based expand/collapse container | `Collapse.spec.tsx` |
+| `src/components/disclosure/Dropdown.tsx` | `DropdownProps`, `Dropdown` | Positioned floating dropdown with Portal rendering and keyboard navigation | `Dropdown.spec.tsx` |
+| `src/components/disclosure/Dialog.tsx` | `DialogProps`, `Dialog` | Modal dialog with draggable/resizable/closable options and backdrop | `Dialog.spec.tsx` |
+| `src/components/disclosure/DialogContext.ts` | `DialogDefaults`, `DialogShowOptions`, `DialogContextValue`, `DialogDefaultsContext`, `DialogContext`, `useDialog` | Context and hook for opening programmatic dialogs imperatively | - |
+| `src/components/disclosure/DialogInstanceContext.ts` | `DialogInstance`, `DialogInstanceContext`, `useDialogInstance` | Context providing close() to components rendered inside a dialog | - |
+| `src/components/disclosure/DialogProvider.tsx` | `DialogProviderProps`, `DialogProvider` | Provider that manages programmatic dialog stack via useDialog() | `DialogProvider.spec.tsx` |
+| `src/components/disclosure/Tabs.tsx` | `Tabs` | Tab bar with controlled/uncontrolled active tab selection | `Tabs.spec.tsx` |
 
 ### Feedback
 
-- [`Notification`](docs/feedback.md#notification) - Notification system with banner and bell (`useNotification`)
-- [`Busy`](docs/feedback.md#busy) - Busy overlay with spinner/bar variants (`useBusy`)
-- [`Print`](docs/feedback.md#print--useprint) - Browser printing and PDF generation (`usePrint`)
-
-## Hooks
-
-- [`useTheme`](docs/hooks.md#usetheme) - Dark/light/system theme state access
-- [`useLocalStorage`](docs/hooks.md#uselocalstorage) - Local-only persistent storage (never syncs)
-- [`useSyncConfig`](docs/hooks.md#usesyncconfig) - Syncable config storage (cross-device sync support)
-- [`useLogger`](docs/hooks.md#uselogger) - Logging with optional remote adapter
-- [`useConfig`](docs/hooks.md#useconfig) - App-wide configuration access
-- [`useNotification`](docs/hooks.md#usenotification) - Notification system access
-- [`useBusy`](docs/hooks.md#usebusy) - Busy overlay control
-- [`usePrint`](docs/hooks.md#useprint) - Printing and PDF generation
-- [`useServiceClient`](docs/hooks.md#useserviceclient) - WebSocket RPC client access
-- [`useSharedData`](docs/hooks.md#useshareddata) - Shared server-side data access
-- [`useDialog`](docs/disclosure.md#dialog) - Programmatic dialog opening
-- [`useDialogInstance`](docs/disclosure.md#dialog) - Access dialog instance for closing from inside dialog content
-- [`createControllableSignal`](docs/hooks.md#createcontrollablesignal) - Controlled/Uncontrolled signal pattern
-- [`createControllableStore`](docs/hooks.md#createcontrollablestore) - Controlled/Uncontrolled store pattern (for objects/arrays)
-- [`createMountTransition`](docs/hooks.md#createmounttransition) - Mount/unmount CSS animation hook
-- [`createIMEHandler`](docs/hooks.md#createimehandler) - IME composition delay handler
-- [`createSlotSignal`](docs/hooks.md#createslotsignal) - Slot registration signal for compound components
-- [`createTopbarActions`](docs/layout.md#topbar-actions-slot) - Register actions in nearest Topbar.Container scope
-- [`useTopbarActionsAccessor`](docs/layout.md#topbar-actions-slot) - Direct access to topbar actions accessor
-- [`useRouterLink`](docs/hooks.md#userouterlink) - Navigation with Ctrl/Shift+click support
-
-## Providers
-
-- [`SystemProvider`](docs/providers.md#systemprovider) - Infrastructure provider (config, theme, logger, notification, busy, service client, shared data)
-- [`DialogProvider`](docs/providers.md#dialogprovider) - Programmatic dialog provider (`useDialog`)
-- [`PrintProvider`](docs/providers.md#printprovider) - Printing and PDF generation provider (`usePrint`)
-
-## Styling
-
-- [Semantic Colors](docs/styling.md#semantic-colors) - primary, info, success, warning, danger, base
-- [Custom Sizes](docs/styling.md#custom-sizes) - Field height classes (h-field, h-field-xs, h-field-sm, h-field-lg, h-field-xl)
-- [z-index Layers](docs/styling.md#z-index-layers) - Sidebar, dropdown, modal z-index values
-- [Dark Mode](docs/styling.md#dark-mode) - Class-based dark mode with auto-toggle
-- [Styling Patterns](docs/styling.md#styling-patterns) - clsx + twMerge usage patterns
-- [Exported Style Tokens](docs/styling.md#exported-style-tokens) - TypeScript style constants (ComponentSize, SemanticTheme, themeTokens, fieldSurface, etc.)
-
-## Helpers & Directives
-
-- [`mergeStyles`](docs/helpers.md#mergestyles) - Merge inline style strings and CSSProperties objects
-- [`ripple`](docs/helpers.md#ripple-directive) - Material Design ripple effect directive
-- [`createAppStructure`](docs/hooks.md#createappstructure) - Declarative app structure (routing, menus, permissions)
-
----
-
-## Demo
-
-Check out real-world usage examples of all components in the `solid-demo` package:
-
-```bash
-pnpm dev
-# http://localhost:40081 (port may vary)
-```
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/components/feedback/notification/NotificationContext.ts` | `NotificationTheme`, `NotificationAction`, `NotificationItem`, `NotificationOptions`, `NotificationUpdateOptions`, `NotificationContextValue`, `NotificationContext`, `useNotification` | Context and hook for creating/updating/removing toast notifications | `NotificationContext.spec.tsx` |
+| `src/components/feedback/notification/NotificationBell.tsx` | `NotificationBellProps`, `NotificationBell` | Bell icon button that shows notification history dropdown | `NotificationBell.spec.tsx` |
+| `src/components/feedback/notification/NotificationBanner.tsx` | `NotificationBanner` | Fixed top-right banner that displays incoming notifications | `NotificationBanner.spec.tsx` |
+| `src/components/feedback/busy/BusyContext.ts` | `BusyVariant`, `BusyContextValue`, `BusyContext`, `useBusy` | Context and hook for showing/hiding spinner or progress bar overlay | - |
+| `src/components/feedback/busy/BusyContainer.tsx` | `BusyContainerProps`, `BusyContainer` | Container that overlays a spinner or progress bar while busy | `BusyContainer.spec.tsx` |
+| `src/components/feedback/print/PrintContext.ts` | `PrintOptions`, `PrintContextValue`, `PrintContext`, `usePrint` | Context and hook for sending content to printer or exporting as PDF | - |
+| `src/components/feedback/print/PrintProvider.tsx` | `PrintProvider` | Provider that implements toPrinter() and toPdf() via jsPDF and html-to-image | - |
+| `src/components/feedback/print/Print.tsx` | `Print` | Declarative print content wrapper with Print.Page sub-component | `Print.spec.tsx` |
+| `src/components/feedback/print/PrintInstanceContext.ts` | `PrintInstance`, `PrintInstanceContext`, `usePrintInstance` | Context providing ready() callback to print content components | - |
+| `src/components/feedback/Progress.tsx` | `ProgressTheme`, `ProgressProps`, `Progress` | Horizontal progress bar with theme and size options | - |
+
+### Providers
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/providers/ConfigContext.tsx` | `AppConfig`, `ConfigContext`, `useConfig`, `ConfigProvider` | App-wide configuration provider (clientName as storage key prefix) | `ConfigContext.spec.tsx` |
+| `src/providers/SyncStorageContext.tsx` | `StorageAdapter`, `SyncStorageContextValue`, `SyncStorageContext`, `useSyncStorage`, `SyncStorageProvider` | Pluggable storage adapter provider (localStorage by default, swappable) | `SyncStorageContext.spec.tsx` |
+| `src/providers/LoggerContext.tsx` | `LogAdapter`, `LoggerContextValue`, `LoggerContext`, `LoggerProvider` | Logger provider with chainable adapter decoration (consola by default) | `LoggerContext.spec.tsx` |
+| `src/providers/ThemeContext.tsx` | `ThemeMode`, `ResolvedTheme`, `useTheme`, `ThemeProvider` | Theme provider managing light/dark/system mode with OS detection | - |
+| `src/providers/ServiceClientContext.ts` | `ServiceClientContextValue`, `ServiceClientContext`, `useServiceClient` | Context for managing named WebSocket service client connections | `ServiceClientContext.spec.tsx` |
+| `src/providers/shared-data/SharedDataContext.ts` | `SharedDataDefinition`, `SharedDataAccessor`, `SharedDataValue`, `SharedDataContext`, `useSharedData` | Context for reactive server-synced shared data with live-update subscriptions | `SharedDataProvider.spec.tsx` |
+| `src/providers/shared-data/SharedDataChangeEvent.ts` | `SharedDataChangeEvent` | Service event definition for broadcasting shared data changes | - |
+| `src/providers/SystemProvider.tsx` | `BusyVariant`, `SystemProvider` | Composite root provider that composes all infrastructure providers | - |
+| `src/providers/i18n/I18nContext.tsx` | `useI18n`, `useI18nOptional`, `I18nProvider` | Internationalization provider with t(), locale management, and localStorage persistence | `I18nContext.spec.tsx` |
+| `src/providers/i18n/I18nContext.types.ts` | `I18nContextValue`, `I18nConfigureOptions`, `FlatDict` | TypeScript types for I18n context value, configure options, and flat dict | - |
+
+### Hooks
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/hooks/useLocalStorage.ts` | `useLocalStorage` | Reactive localStorage signal with clientName-prefixed keys | `useLocalStorage.spec.tsx` |
+| `src/hooks/useSyncConfig.ts` | `useSyncConfig` | Persistent config signal synced via SyncStorageProvider (falls back to localStorage) | `useSyncConfig.spec.tsx` |
+| `src/hooks/useLogger.ts` | `Logger`, `useLogger` | Logger hook that delegates to LoggerContext adapter (consola fallback) | `useLogger.spec.tsx` |
+| `src/hooks/createControllableSignal.ts` | `createControllableSignal` | Controlled/uncontrolled signal pattern hook supporting functional setters | `createControllableSignal.spec.ts` |
+| `src/hooks/createControllableStore.ts` | `createControllableStore` | Controlled/uncontrolled store pattern hook for object/array state | - |
+| `src/hooks/createIMEHandler.ts` | `createIMEHandler` | IME composition handler that delays value commit to prevent Korean input breakage | `createIMEHandler.spec.ts` |
+| `src/hooks/createMountTransition.ts` | `createMountTransition` | Mount/unmount animation hook providing mounted and animating signals | `createMountTransition.spec.ts` |
+| `src/hooks/createSlotSignal.ts` | `SlotAccessor`, `createSlotSignal` | Signal factory for registering JSX slot content from child components | - |
+| `src/hooks/useRouterLink.ts` | `RouterLinkOptions`, `useRouterLink` | Router navigation hook with Shift+click new-window support | `useRouterLink.spec.tsx` |
+
+### Styles
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/styles/tokens.styles.ts` | `borderDefault`, `borderSubtle`, `bgSurface`, `textDefault`, `textMuted`, `textPlaceholder`, `disabledOpacity`, `ComponentSize`, `ComponentSizeCompact`, `paddingXs`, `paddingSm`, `paddingLg`, `paddingXl`, `SemanticTheme`, `themeTokens` | Design token constants (colors, sizes, themes) as Tailwind class strings | - |
+| `src/styles/patterns.styles.ts` | `iconButtonBase`, `insetFocusOutline`, `insetFocusOutlineSelf`, `insetBase`, `fieldSurface`, `inputBase` | Reusable Tailwind class patterns for icon buttons, inset fields, and input elements | - |
+
+### Directives
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/directives/ripple.ts` | `ripple` | SolidJS directive that adds a Material-style ripple effect on click | `ripple.spec.tsx` |
+
+### Helpers
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/helpers/mergeStyles.ts` | `mergeStyles` | Merges multiple JSX style objects or strings into a single style object | `mergeStyles.spec.ts` |
+| `src/helpers/createAppStructure.ts` | `AppStructureGroupItem`, `AppStructureLeafItem`, `AppStructureItem`, `AppStructureSubPerm`, `AppMenu`, `AppPerm`, `AppFlatPerm`, `AppRoute`, `AppFlatMenu`, `AppStructure`, `createAppStructure` | Builds typed app route/menu/permission structures from a nested definition tree | `createAppStructure.spec.tsx` |
+| `src/helpers/createSlotComponent.ts` | `createSlotComponent` | Factory for creating slot registration sub-components that inject into parent context | - |
+
+### Features
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/components/features/address/AddressSearch.tsx` | `AddressSearchResult`, `AddressSearchContent` | Daum Postcode address search dialog content component | `AddressSearch.spec.tsx` |
+| `src/components/features/shared-data/SharedDataSelect.tsx` | `SharedDataSelectProps`, `SharedDataSelect` | Select dropdown bound to a SharedDataAccessor with search and edit action | - |
+| `src/components/features/shared-data/SharedDataSelectButton.tsx` | `SharedDataSelectButtonProps`, `SharedDataSelectButton` | Button-trigger selector bound to a SharedDataAccessor via modal list | - |
+| `src/components/features/shared-data/SharedDataSelectList.tsx` | `SharedDataSelectListProps`, `SharedDataSelectListComponent`, `SharedDataSelectList` | Paginated list for selecting a single item from a SharedDataAccessor | `SharedDataSelectList.spec.tsx` |
+| `src/components/features/data-select-button/DataSelectButton.tsx` | `DataSelectModalResult`, `DataSelectButtonProps`, `DataSelectButton` | Button that opens a modal dialog for selecting items from an async data source | `DataSelectButton.spec.tsx` |
+| `src/components/features/crud-sheet/CrudSheet.tsx` | `CrudSheet` | Full CRUD data grid with inline/modal edit, Excel import/export, search | `CrudSheet.spec.tsx` |
+| `src/components/features/crud-sheet/types.ts` | `SearchResult`, `InlineEditConfig`, `ModalEditConfig`, `ExcelConfig`, `SelectResult`, `CrudSheetCellContext`, `CrudSheetContext`, `CrudSheetProps`, `CrudSheetColumnDef`, `CrudSheetColumnProps`, `CrudSheetFilterDef`, `CrudSheetToolsDef`, `CrudSheetHeaderDef` | TypeScript types and interfaces for CrudSheet configuration and callbacks | - |
+| `src/components/features/crud-detail/CrudDetail.tsx` | `CrudDetail` | Detail form panel with load/save/refresh lifecycle and change tracking | `CrudDetail.spec.tsx` |
+| `src/components/features/crud-detail/types.ts` | `CrudDetailInfo`, `CrudDetailContext`, `CrudDetailProps`, `CrudDetailToolsDef`, `CrudDetailBeforeDef`, `CrudDetailAfterDef` | TypeScript types and interfaces for CrudDetail props and context | - |
+| `src/components/features/permission-table/PermissionTable.tsx` | `PermissionTableProps`, `collectAllPerms`, `filterByModules`, `changePermCheck`, `PermissionTable` | Permission matrix table for managing role-based access per module/action | `PermissionTable.spec.tsx` |
 
 ## License
 

package/dist/components/data/calendar/Calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Calendar.d.ts","sourceRoot":"","sources":["..\\..\\..\\..\\src\\components\\data\\calendar\\Calendar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,GAAG,EAAc,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKjD,MAAM,WAAW,aAAa,CAAC,MAAM,CAAE,SAAQ,IAAI,CACjD,GAAG,CAAC,cAAc,CAAC,gBAAgB,CAAC,EACpC,UAAU,CACX;IACC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC;IACvD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;IACzD,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA4BD,iBAAS,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,eAyGzD;AAED,eAAO,MAAM,QAAQ,qBAAe,CAAC"}
+{"version":3,"file":"Calendar.d.ts","sourceRoot":"","sources":["..\\..\\..\\..\\src\\components\\data\\calendar\\Calendar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,GAAG,EAAc,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMjD,MAAM,WAAW,aAAa,CAAC,MAAM,CAAE,SAAQ,IAAI,CACjD,GAAG,CAAC,cAAc,CAAC,gBAAgB,CAAC,EACpC,UAAU,CACX;IACC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC;IACvD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;IACzD,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA0BD,iBAAS,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,eAgHzD;AAED,eAAO,MAAM,QAAQ,qBAAe,CAAC"}

package/dist/components/data/calendar/Calendar.js

@@ -11,7 +11,7 @@ import { DateOnly } from "@simplysm/core-common";
 import clsx from "clsx";
 import { twMerge } from "tailwind-merge";
 import { createControllableSignal } from "../../../hooks/createControllableSignal.js";
-const WEEKS = ["\uC77C", "\uC6D4", "\uD654", "\uC218", "\uBAA9", "\uAE08", "\uD1A0"];
+import { useI18nOptional } from "../../../providers/i18n/I18nContext.js";
 const baseClass = clsx(
   "w-full",
   "border-separate border-spacing-0",
@@ -39,11 +39,24 @@ function CalendarBase(props) {
     value: () => local.yearMonth ?? new DateOnly().setDay(1),
     onChange: () => local.onYearMonthChange
   });
+  const i18n = useI18nOptional();
+  const weekNames = ["sun", "mon", "tue", "wed", "thu", "fri", "sat"];
   const weekHeaders = createMemo(() => {
     const start = weekStartDay();
     return Array.from({
       length: 7
-    }, (_, i) => WEEKS[(start + i) % 7]);
+    }, (_, i) => {
+      const key = weekNames[(start + i) % 7];
+      return (i18n == null ? void 0 : i18n.t(`calendar.weeks.${key}`)) ?? {
+        sun: "Sun",
+        mon: "Mon",
+        tue: "Tue",
+        wed: "Wed",
+        thu: "Thu",
+        fri: "Fri",
+        sat: "Sat"
+      }[key];
+    });
   });
   const dataTable = createMemo(() => {
     const ym = yearMonth();

package/dist/components/data/calendar/Calendar.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/components/data/calendar/Calendar.tsx"],
-  "mappings": "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",
-  "names": ["createMemo", "For", "splitProps", "DateOnly", "clsx", "twMerge", "createControllableSignal", "WEEKS", "baseClass", "notCurrentClass", "dayClass", "notCurrentDayClass", "contentClass", "CalendarBase", "props", "local", "rest", "weekStartDay", "minDaysInFirstWeek", "yearMonth", "value", "setDay", "onChange", "onYearMonthChange", "weekHeaders", "start", "Array", "from", "length", "_", "i", "dataTable", "ym", "items", "getDate", "getItemDate", "itemMap", "Map", "date", "key", "tick", "arr", "get", "push", "item", "index", "set", "firstDate", "getWeekSeqStartDate", "result", "r", "row", "c", "addDays", "getClassName", "class", "_el$", "_tmpl$", "_el$2", "firstChild", "_el$3", "_el$4", "nextSibling", "_$spread", "_$mergeProps", "_$insert", "_$createComponent", "each", "children", "header", "_el$5", "_tmpl$2", "_el$6", "_tmpl$3", "cell", "_el$7", "_tmpl$4", "_el$8", "_el$9", "day", "_$className", "entry", "renderItem", "_$effect", "_p$", "_v$", "month", "_v$2", "e", "t", "undefined", "Calendar"]
+  "mappings": "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",
+  "names": ["createMemo", "For", "splitProps", "DateOnly", "clsx", "twMerge", "createControllableSignal", "useI18nOptional", "baseClass", "notCurrentClass", "dayClass", "notCurrentDayClass", "contentClass", "CalendarBase", "props", "local", "rest", "weekStartDay", "minDaysInFirstWeek", "yearMonth", "value", "setDay", "onChange", "onYearMonthChange", "i18n", "weekNames", "weekHeaders", "start", "Array", "from", "length", "_", "i", "key", "t", "sun", "mon", "tue", "wed", "thu", "fri", "sat", "dataTable", "ym", "items", "getDate", "getItemDate", "itemMap", "Map", "date", "tick", "arr", "get", "push", "item", "index", "set", "firstDate", "getWeekSeqStartDate", "result", "r", "row", "c", "addDays", "getClassName", "class", "_el$", "_tmpl$", "_el$2", "firstChild", "_el$3", "_el$4", "nextSibling", "_$spread", "_$mergeProps", "_$insert", "_$createComponent", "each", "children", "header", "_el$5", "_tmpl$2", "_el$6", "_tmpl$3", "cell", "_el$7", "_tmpl$4", "_el$8", "_el$9", "day", "_$className", "entry", "renderItem", "_$effect", "_p$", "_v$", "month", "_v$2", "e", "undefined", "Calendar"]
 }

package/dist/components/data/kanban/KanbanContext.js

@@ -3,7 +3,7 @@ const KanbanContext = createContext();
 function useKanbanContext() {
   const context = useContext(KanbanContext);
   if (!context) {
-    throw new Error("useKanbanContext\uB294 Kanban \uB0B4\uBD80\uC5D0\uC11C\uB9CC \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4");
+    throw new Error("useKanbanContext can only be used inside Kanban");
   }
   return context;
 }
@@ -11,7 +11,7 @@ const KanbanLaneContext = createContext();
 function useKanbanLaneContext() {
   const context = useContext(KanbanLaneContext);
   if (!context) {
-    throw new Error("useKanbanLaneContext\uB294 Kanban.Lane \uB0B4\uBD80\uC5D0\uC11C\uB9CC \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4");
+    throw new Error("useKanbanLaneContext can only be used inside Kanban.Lane");
   }
   return context;
 }

package/dist/components/data/kanban/KanbanContext.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/components/data/kanban/KanbanContext.ts"],
-  "mappings": "AAAA,SAAS,eAAe,kBAA8C;AAyC/D,MAAM,gBAAgB,cAAkC;AAExD,SAAS,mBAAuC;AACrD,QAAM,UAAU,WAAW,aAAa;AACxC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,iHAA2C;AAAA,EAC7D;AACA,SAAO;AACT;AAkBO,MAAM,oBAAoB,cAAsC;AAEhE,SAAS,uBAA+C;AAC7D,QAAM,UAAU,WAAW,iBAAiB;AAC5C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,0HAAoD;AAAA,EACtE;AACA,SAAO;AACT;",
+  "mappings": "AAAA,SAAS,eAAe,kBAA8C;AAyC/D,MAAM,gBAAgB,cAAkC;AAExD,SAAS,mBAAuC;AACrD,QAAM,UAAU,WAAW,aAAa;AACxC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACnE;AACA,SAAO;AACT;AAkBO,MAAM,oBAAoB,cAAsC;AAEhE,SAAS,uBAA+C;AAC7D,QAAM,UAAU,WAAW,iBAAiB;AAC5C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,SAAO;AACT;",
   "names": []
 }

package/dist/components/data/list/List.d.ts

@@ -2,19 +2,19 @@ import { type JSX, type ParentComponent } from "solid-js";
 import { ListItem } from "./ListItem";
 export interface ListProps extends JSX.HTMLAttributes<HTMLDivElement> {
     /**
-     * 투명 배경 스타일 적용
+     * Apply transparent background style
      */
     inset?: boolean;
 }
 /**
- * ListItem들을 담는 컨테이너 컴포넌트
+ * Container component for ListItems
  *
- * 트리뷰 스타일 키보드 네비게이션 지원:
- * - `Space`/`Enter`: 현재 항목 토글
- * - `ArrowUp`/`ArrowDown`: 이전/다음 항목으로 포커스 이동
- * - `Home`/`End`: 첫 번째/마지막 항목으로 포커스 이동
- * - `ArrowRight`: 닫혀있으면 열기, 열려있으면 첫 번째 자식으로 포커스
- * - `ArrowLeft`: 열려있으면 닫기, 닫혀있으면 부모로 포커스
+ * Supports tree-view style keyboard navigation:
+ * - `Space`/`Enter`: toggle current item
+ * - `ArrowUp`/`ArrowDown`: move focus to previous/next item
+ * - `Home`/`End`: move focus to first/last item
+ * - `ArrowRight`: open if closed, or focus first child if open
+ * - `ArrowLeft`: close if open, or focus parent if closed
  *
  * @example
  * ```tsx

package/dist/components/data/list/ListContext.d.ts

@@ -1,5 +1,5 @@
 /**
- * List context - 중첩 level 전달용
+ * List context - for passing nested level
  */
 export interface ListContextValue {
     level: number;