@simplysm/solid 13.0.72 → 13.0.74

package/README.md

@@ -1,218 +1,225 @@
 # @simplysm/solid
 
-A SolidJS UI component library for enterprise back-office applications such as ERP and MES.
+SolidJS component library for the Simplysm framework. Provides form controls, layout components, data display, disclosure, feedback, providers, hooks, styles, directives, helpers, and feature-level composite components.
 
 ## Installation
 
-```
+```bash
 pnpm add @simplysm/solid
 ```
 
-**Peer Dependencies:**
-- `solid-js` ^1.9
-- `tailwindcss` ^3.4
+## Table of Contents
+
+- [Form Control](docs/form-control.md) — Input and selection components
+- [Layout](docs/layout.md) — Page scaffolding and form layout
+- [Data](docs/data.md) — Tables, lists, calendars, and kanban boards
+- [Display](docs/display.md) — Visual presentation components
+- [Disclosure](docs/disclosure.md) — Show/hide patterns (collapse, dropdown, dialog, tabs)
+- [Feedback](docs/feedback.md) — Notifications, busy states, print, and progress
+- [Providers](docs/providers.md) — Application-level context providers
+- [Hooks](docs/hooks.md) — Reactive primitives and utility hooks
+- [Styles, Directives, Helpers](docs/styles.md) — Design tokens, CSS patterns, directives, and utilities
+- [Features](docs/features.md) — High-level composite components (CRUD, permissions, address search)
+
+---
+
+## Form Control
+
+Input and selection components for user data entry. All field components support `required`, `validate`, `disabled`, `inset`, `size`, and `touchMode` unless noted.
+
+See [docs/form-control.md](docs/form-control.md) for full signatures and props.
+
+| Component | Description |
+|-----------|-------------|
+| [`Button`](docs/form-control.md#button) | Interactive button with semantic themes and variants |
+| [`Select`](docs/form-control.md#select) | Dropdown supporting single/multiple selection and hierarchical items |
+| [`Combobox`](docs/form-control.md#combobox) | Async search combo box with optional free-text input |
+| [`TextInput`](docs/form-control.md#textinput) | Text/password/email input with format transformation |
+| [`NumberInput`](docs/form-control.md#numberinput) | Number input with comma formatting and min/max constraints |
+| [`DatePicker`](docs/form-control.md#datepicker) | Date picker with configurable granularity (year/month/date) |
+| [`DateTimePicker`](docs/form-control.md#datetimepicker) | Date-time picker (minute/second granularity) |
+| [`TimePicker`](docs/form-control.md#timepicker) | Time picker (minute/second granularity) |
+| [`Textarea`](docs/form-control.md#textarea) | Multi-line text input with auto-grow |
+| [`Checkbox`](docs/form-control.md#checkbox) | Boolean checkbox input |
+| [`Radio`](docs/form-control.md#radio) | Boolean radio input |
+| [`CheckboxGroup`](docs/form-control.md#checkboxgroup) | Group of checkboxes for multi-value selection |
+| [`RadioGroup`](docs/form-control.md#radiogroup) | Group of radio buttons for single-value selection |
+| [`ColorPicker`](docs/form-control.md#colorpicker) | Color picker returning `#RRGGBB` hex strings |
+| [`DateRangePicker`](docs/form-control.md#daterangepicker) | Date range picker with period type (day/month/range) |
+| [`RichTextEditor`](docs/form-control.md#richtexteditor) | Rich text editor powered by Tiptap, outputs HTML |
+| [`Numpad`](docs/form-control.md#numpad) | On-screen numeric keypad for touch input |
+| [`StatePreset`](docs/form-control.md#statepreset) | Named state snapshot save/restore backed by SyncConfig |
+| [`ThemeToggle`](docs/form-control.md#themetoggle) | Button cycling through light/system/dark themes |
+| [`Invalid`](docs/form-control.md#invalid) | Validation wrapper with error indicator |
+| [`Field.styles`](docs/form-control.md#field-styles-fieldstyles) | Style utilities for custom field components |
+| [`Checkbox.styles`](docs/form-control.md#checkbox-styles-checkboxstyles) | Style utilities for custom checkbox/radio components |
 
-**Optional Peer Dependencies:**
-- `echarts` ^6.0 — Required for Echarts chart components
+---
 
-## Configuration
+## Layout
 
-Register the Tailwind preset in your app's `tailwind.config.ts`:
+Structural layout components for page scaffolding and form organization.
+
+See [docs/layout.md](docs/layout.md) for full details.
+
+| Component | Description |
+|-----------|-------------|
+| [`FormGroup`](docs/layout.md#formgroup) | Responsive form layout with label-field pairs |
+| [`FormTable`](docs/layout.md#formtable) | Styled HTML table for form layouts |
+| [`Sidebar`](docs/layout.md#sidebar) | Responsive sidebar navigation |
+| [`SidebarContext`](docs/layout.md#sidebarcontext) | Context and utilities for the Sidebar |
+| [`Topbar`](docs/layout.md#topbar) | Top navigation bar with actions, menu, and user slots |
+| [`TopbarContext`](docs/layout.md#topbarcontext) | Context for injecting page-level topbar actions |
+
+---
+
+## Data
+
+Components for displaying and managing tabular, list, calendar, and kanban data.
 
-```typescript
-import simplysmPreset from "@simplysm/solid/tailwind.config";
-export default {
-  darkMode: "class",
-  presets: [simplysmPreset],
-  content: ["./src/**/*.{ts,tsx}", ...simplysmPreset.content],
-};
-```
+See [docs/data.md](docs/data.md) for full details.
+
+| Component | Description |
+|-----------|-------------|
+| [`Table`](docs/data.md#table) | Styled HTML table |
+| [`List`](docs/data.md#list) | Keyboard-navigable list with tree support |
+| [`ListContext`](docs/data.md#listcontext) | Context for tracking nesting level in List |
+| [`ListItem.styles`](docs/data.md#listitemstyles) | Style constants for custom list item implementations |
+| [`Pagination`](docs/data.md#pagination) | Page navigation control |
+| [`DataSheet`](docs/data.md#datasheet) | Feature-rich data grid with sorting, pagination, selection, tree, and reorder |
+| [`Calendar`](docs/data.md#calendar) | Monthly calendar view rendering items on dates |
+| [`Kanban`](docs/data.md#kanban) | Kanban board with drag-and-drop card reordering |
+| [`KanbanContext`](docs/data.md#kanbancontext) | Internal context and types for Kanban |
+
+---
+
+## Display
+
+Visual presentation components for rendering data, media, and decorative elements.
 
-Import base CSS in your entry point:
+See [docs/display.md](docs/display.md) for full details.
+
+| Component | Description |
+|-----------|-------------|
+| [`Barcode`](docs/display.md#barcode) | Renders barcodes using bwip-js |
+| [`Card`](docs/display.md#card) | White surface card with shadow and hover animation |
+| [`Echarts`](docs/display.md#echarts) | Apache ECharts chart with lazy loading and auto-resize |
+| [`Icon`](docs/display.md#icon) | Renders a Tabler icon SVG |
+| [`Tag`](docs/display.md#tag) | Inline badge/tag with semantic color theming |
+| [`Link`](docs/display.md#link) | Styled anchor with theme and disabled support |
+| [`Alert`](docs/display.md#alert) | Styled alert/callout block |
 
-```typescript
-import "@simplysm/solid/tailwind.css";
-```
+---
 
-Wrap your app with providers:
-
-```tsx
-import { SystemProvider, DialogProvider, PrintProvider } from "@simplysm/solid";
-<SystemProvider clientName="my-app">
-  <DialogProvider>
-    <PrintProvider>
-      <App />
-    </PrintProvider>
-  </DialogProvider>
-</SystemProvider>
-```
+## Disclosure
+
+Components for showing and hiding content.
+
+See [docs/disclosure.md](docs/disclosure.md) for full details.
+
+| Component | Description |
+|-----------|-------------|
+| [`Collapse`](docs/disclosure.md#collapse) | Animated height-collapse panel |
+| [`Dropdown`](docs/disclosure.md#dropdown) | Popup dropdown with trigger/content slots |
+| [`Dialog`](docs/disclosure.md#dialog) | Dialog with header, actions, resize/move support |
+| [`DialogContext`](docs/disclosure.md#dialogcontext) | Hook for programmatic dialog management |
+| [`DialogProvider`](docs/disclosure.md#dialogprovider) | Provider enabling `useDialog()` |
+| [`DialogInstanceContext`](docs/disclosure.md#dialoginstancecontext) | Context for dialog result communication |
+| [`Tabs`](docs/disclosure.md#tabs) | Tab navigation component |
+
+---
+
+## Feedback
+
+Components for user feedback.
+
+See [docs/feedback.md](docs/feedback.md) for full details.
+
+| Component | Description |
+|-----------|-------------|
+| [`NotificationContext`](docs/feedback.md#notificationcontext) | Hook for in-app notifications |
+| [`NotificationBell`](docs/feedback.md#notificationbell) | Bell icon with unread count |
+| [`NotificationBanner`](docs/feedback.md#notificationbanner) | Portal-based notification banner |
+| [`BusyContext`](docs/feedback.md#busycontext) | Hook for global busy state overlays |
+| [`BusyContainer`](docs/feedback.md#busycontainer) | Container with spinner/bar loading overlay |
+| [`PrintContext`](docs/feedback.md#printcontext) | Hook for print and PDF generation |
+| [`PrintProvider`](docs/feedback.md#printprovider) | Provider enabling `usePrint()` |
+| [`Print`](docs/feedback.md#print) | Printable content layout with pages |
+| [`PrintInstanceContext`](docs/feedback.md#printinstancecontext) | Context for print component communication |
+| [`Progress`](docs/feedback.md#progress) | Progress bar component |
+
+---
+
+## Providers
+
+Application-level context providers for configuration, storage, theming, i18n, and shared data.
+
+See [docs/providers.md](docs/providers.md) for full details.
+
+| Provider | Description |
+|----------|-------------|
+| [`ConfigContext`](docs/providers.md#configcontext) | Application-wide configuration context |
+| [`SyncStorageContext`](docs/providers.md#syncstoragecontext) | Persistent key-value storage with pluggable adapter |
+| [`LoggerContext`](docs/providers.md#loggercontext) | Structured logging with pluggable adapter |
+| [`ThemeContext`](docs/providers.md#themecontext) | Light/dark/system theme management |
+| [`ServiceClientContext`](docs/providers.md#serviceclientcontext) | WebSocket service client context |
+| [`SystemProvider`](docs/providers.md#systemprovider) | Composite root provider for applications |
+| [`SharedDataContext`](docs/providers.md#shareddatacontext) | Shared data synchronized with the server |
+| [`SharedDataChangeEvent`](docs/providers.md#shareddatachangeevent) | Event class for shared data change notifications |
+| [`I18nContext`](docs/providers.md#i18ncontext) | Internationalization with built-in EN/KO dictionaries |
+
+---
+
+## Hooks
+
+Reactive primitives and utility hooks.
+
+See [docs/hooks.md](docs/hooks.md) for full details.
+
+| Hook | Description |
+|------|-------------|
+| [`useLocalStorage`](docs/hooks.md#uselocalstorage) | Reactive localStorage accessor with SSR safety |
+| [`useSyncConfig`](docs/hooks.md#usesyncconfig) | Persistent configuration backed by SyncStorage |
+| [`useLogger`](docs/hooks.md#uselogger) | Structured logger from the logger context |
+| [`createControllableSignal`](docs/hooks.md#createcontrollablesignal) | Signal for controlled/uncontrolled patterns |
+| [`createControllableStore`](docs/hooks.md#createcontrollablestore) | Store for controlled/uncontrolled patterns |
+| [`createIMEHandler`](docs/hooks.md#createimehandler) | IME composition handlers for CJK input |
+| [`createMountTransition`](docs/hooks.md#createmounttransition) | Mount/unmount lifecycle with animation support |
+| [`createSlotSignal`](docs/hooks.md#createslotsignal) | Slot registration for compound components |
+| [`useRouterLink`](docs/hooks.md#userouterlink) | SolidJS Router navigation click handler |
+
+---
+
+## Styles, Directives, Helpers
+
+Design tokens, CSS class patterns, directives, and utilities.
+
+See [docs/styles.md](docs/styles.md) for full details.
+
+| Export | Description |
+|--------|-------------|
+| [`tokens.styles`](docs/styles.md#tokensstyles) | Design token constants and type definitions |
+| [`patterns.styles`](docs/styles.md#patternsstyles) | Reusable Tailwind class patterns |
+| [`ripple`](docs/styles.md#ripple-directive) | Material-style ripple click effect directive |
+| [`mergeStyles`](docs/styles.md#mergestyles) | Merge multiple CSS style values into one object |
+
+---
+
+## Features
+
+High-level composite components combining multiple primitives into application-ready patterns.
+
+See [docs/features.md](docs/features.md) for full details.
 
-| 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` |
-
-### Layout
-
-| 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
-
-| 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
-
-| 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
-
-| 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
-
-| 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
-
-Apache-2.0
+| Component | Description |
+|-----------|-------------|
+| [`AddressSearchContent`](docs/features.md#addresssearchcontent) | Korean address search dialog via Daum Postcode API |
+| [`SharedDataSelect`](docs/features.md#shareddataselect) | Select pre-wired to a SharedDataAccessor |
+| [`SharedDataSelectButton`](docs/features.md#shareddataselectbutton) | DataSelectButton pre-wired to a SharedDataAccessor |
+| [`SharedDataSelectList`](docs/features.md#shareddataselectlist) | Searchable list with pagination for SharedDataAccessor |
+| [`DataSelectButton`](docs/features.md#dataselectbutton) | Generic trigger button opening a selection dialog |
+| [`CrudSheet`](docs/features.md#crudsheet) | Full CRUD data grid with inline/dialog edit and Excel support |
+| [`CrudDetail`](docs/features.md#cruddetail) | Detail form with load/save/delete lifecycle |
+| [`PermissionTable`](docs/features.md#permissiontable) | Permission editor grid with cascading checkbox logic |
+| [`createAppStructure`](docs/features.md#createappstructure) | Typed app structure builder (routes, menus, permissions) |
+| [`createSlotComponent`](docs/features.md#createslotcomponent) | Factory for slot registration in compound components |

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;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"}
+{"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,eA+GzD;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";
-import { useI18nOptional } from "../../../providers/i18n/I18nContext.js";
+import { useI18n } from "../../../providers/i18n/I18nContext.js";
 const baseClass = clsx(
   "w-full",
   "border-separate border-spacing-0",
@@ -39,7 +39,7 @@ function CalendarBase(props) {
     value: () => local.yearMonth ?? new DateOnly().setDay(1),
     onChange: () => local.onYearMonthChange
   });
-  const i18n = useI18nOptional();
+  const i18n = useI18n();
   const weekNames = ["sun", "mon", "tue", "wed", "thu", "fri", "sat"];
   const weekHeaders = createMemo(() => {
     const start = weekStartDay();
@@ -47,15 +47,7 @@ function CalendarBase(props) {
       length: 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];
+      return i18n.t(`calendar.weeks.${key}`);
     });
   });
   const dataTable = createMemo(() => {

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", "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"]
+  "mappings": "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",
+  "names": ["createMemo", "For", "splitProps", "DateOnly", "clsx", "twMerge", "createControllableSignal", "useI18n", "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", "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/sheet/DataSheet.js

@@ -25,13 +25,13 @@ import { Checkbox } from "../../form-control/checkbox/Checkbox.js";
 import { Pagination } from "../Pagination.js";
 import { useSyncConfig } from "../../../hooks/useSyncConfig.js";
 import { DialogContext } from "../../disclosure/DialogContext.js";
-import { useI18nOptional } from "../../../providers/i18n/I18nContext.js";
+import { useI18n } from "../../../providers/i18n/I18nContext.js";
 import "./DataSheet.css";
 import { configButtonClass, defaultContainerClass, expandIndentGuideClass, expandIndentGuideLineClass, expandToggleClass, featureCellBodyClickableClass, featureCellBodyWrapperClass, featureCellClickableClass, featureCellWrapperClass, featureTdClass, featureThClass, fixedClass, fixedLastClass, insetContainerClass, insetTableClass, reorderCellWrapperClass, reorderHandleClass, reorderIndicatorClass, resizeIndicatorClass, resizerClass, selectSingleClass, selectSingleSelectedClass, selectSingleUnselectedClass, dataSheetContainerClass, sortableThClass, sortIconClass, summaryThClass, tableClass, tdClass, thClass, thContentClass, toolbarClass } from "./DataSheet.styles.js";
 const DataSheet = (props) => {
   const [local] = splitProps(props, ["items", "persistKey", "hideConfigBar", "inset", "contentStyle", "sorts", "onSortsChange", "autoSort", "page", "onPageChange", "totalPageCount", "itemsPerPage", "displayPageCount", "expandedItems", "onExpandedItemsChange", "getChildren", "selectMode", "selectedItems", "onSelectedItemsChange", "autoSelect", "isItemSelectable", "cellClass", "cellStyle", "onItemsReorder", "class", "children"]);
-  const modal = useContext(DialogContext);
-  const i18n = useI18nOptional();
+  const dialog = useContext(DialogContext);
+  const i18n = useI18n();
   const resolved = children(() => local.children);
   const columnDefs = createMemo(() => resolved.toArray().filter(isDataSheetColumnDef));
   const [config, setConfig] = local.persistKey != null && local.persistKey !== "" ? useSyncConfig(`sheet.${local.persistKey}`, {
@@ -75,8 +75,8 @@ const DataSheet = (props) => {
       columnRecord: record
     });
   }
-  async function openConfigModal() {
-    if (!modal) return;
+  async function openConfigDialog() {
+    if (!dialog) return;
     const {
       DataSheetConfigDialog
     } = await import("./DataSheetConfigDialog");
@@ -90,7 +90,7 @@ const DataSheet = (props) => {
       width: col.width
     }));
     const currentConfig = config();
-    const result = await modal.show(() => _$createComponent(DataSheetConfigDialog, {
+    const result = await dialog.show(() => _$createComponent(DataSheetConfigDialog, {
       columnInfos,
       currentConfig
     }), {
@@ -526,7 +526,7 @@ const DataSheet = (props) => {
     var _el$ = _tmpl$5(), _el$5 = _el$.firstChild, _el$6 = _el$5.firstChild, _el$7 = _el$6.firstChild, _el$1 = _el$7.nextSibling, _el$11 = _el$1.nextSibling, _el$12 = _el$6.nextSibling, _el$13 = _el$12.nextSibling;
     _$insert(_el$, _$createComponent(Show, {
       get when() {
-        return _$memo(() => !!!local.hideConfigBar)() && (modal != null || effectivePageCount() > 1);
+        return _$memo(() => !!!local.hideConfigBar)() && (dialog != null || effectivePageCount() > 1);
       },
       get children() {
         var _el$2 = _tmpl$2(), _el$3 = _el$2.firstChild;
@@ -552,10 +552,10 @@ const DataSheet = (props) => {
           }
         }), _el$3);
         _$insert(_el$2, _$createComponent(Show, {
-          when: modal != null,
+          when: dialog != null,
           get children() {
             var _el$4 = _tmpl$();
-            _el$4.$$click = openConfigModal;
+            _el$4.$$click = openConfigDialog;
             _$className(_el$4, configButtonClass);
             _$insert(_el$4, _$createComponent(Icon, {
               icon: IconSettings,
@@ -634,7 +634,7 @@ const DataSheet = (props) => {
               }
             }));
             _$effect((_p$) => {
-              var _v$7 = twMerge(featureThClass, fixedClass, "z-[5]", isExpandColLastFixed() ? fixedLastClass : void 0), _v$8 = featureHeaderRowspan(), _v$9 = isAllExpanded() ? (i18n == null ? void 0 : i18n.t("dataSheet.collapseAll")) ?? "Collapse all" : (i18n == null ? void 0 : i18n.t("dataSheet.expandAll")) ?? "Expand all";
+              var _v$7 = twMerge(featureThClass, fixedClass, "z-[5]", isExpandColLastFixed() ? fixedLastClass : void 0), _v$8 = featureHeaderRowspan(), _v$9 = isAllExpanded() ? i18n.t("dataSheet.collapseAll") : i18n.t("dataSheet.expandAll");
               _v$7 !== _p$.e && _$className(_el$16, _p$.e = _v$7);
               _v$8 !== _p$.t && _$setAttribute(_el$16, "rowspan", _p$.t = _v$8);
               _v$9 !== _p$.a && _$setAttribute(_el$18, "title", _p$.a = _v$9);