@svgrid/grid 1.2.33 → 2.0.0

package/dist/editor-registry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * editor-registry - the extension point that opens up the grid's cell editors.
+ *
+ * Historically SvGrid rendered cell editors through a fixed `{#if editorType ===
+ * ...}` chain over a closed `CellEditorType` union. This registry lets any
+ * component - a built-in `Sv*` editor or one you author - be mounted for a
+ * column by name, wired to one uniform in-cell contract (change / commit /
+ * cancel). Register once at module load:
+ *
+ * ```ts
+ * import { registerCellEditor } from '@svgrid/grid'
+ * import StarRating from './StarRating.svelte'
+ * registerCellEditor('stars', StarRating)
+ * // then: columns = [{ field: 'score', editorType: 'stars' }]
+ * ```
+ *
+ * The registered component receives the {@link CellEditorContext} as props
+ * (value + onChange/onCommit/onCancel), or a custom mapping via `props`.
+ * Framework-light: this file only holds the Map + helpers; the grid does the
+ * mounting.
+ */
+import type { Component } from 'svelte';
+/** Context the grid hands a cell editor when it mounts one for an edit. */
+export type CellEditorContext<T = unknown> = {
+    /** The value currently being edited. */
+    value: T;
+    /** Id of the row being edited. */
+    rowId: string;
+    /** Id of the column being edited. */
+    columnId: string;
+    /** Update the in-progress value WITHOUT ending the edit. */
+    onChange: (value: T) => void;
+    /** Commit the value and stop editing (optionally pass a final value). */
+    onCommit: (value?: T) => void;
+    /** Discard changes and stop editing (returns focus to the grid). */
+    onCancel: () => void;
+};
+/** How a registered component is mounted and wired for a cell edit. */
+export type CellEditorRegistration = {
+    /** The Svelte component to mount in the editing cell. */
+    component: Component<any>;
+    /**
+     * Map the editing context to the component's props. Defaults to
+     * {@link defaultEditorProps} (value + onChange/onCommit/onCancel).
+     */
+    props?: (ctx: CellEditorContext) => Record<string, unknown>;
+    /** Hint that the editor should open its popover immediately on mount. */
+    autoOpen?: boolean;
+};
+/**
+ * Register a cell editor under `type`. Pass a component (uses the default prop
+ * mapping) or a full {@link CellEditorRegistration} for custom prop mapping.
+ * Re-registering the same type replaces it.
+ */
+export declare function registerCellEditor(type: string, registration: CellEditorRegistration | Component<any>): void;
+/** Look up a registered cell editor by type. */
+export declare function getCellEditor(type: string): CellEditorRegistration | undefined;
+/** Whether a custom editor is registered for `type`. */
+export declare function hasCellEditor(type: string): boolean;
+/** Remove a registered cell editor. */
+export declare function unregisterCellEditor(type: string): void;
+/** All registered custom editor type names. */
+export declare function registeredCellEditorTypes(): string[];
+/** The default context → props mapping used when a registration has no `props`. */
+export declare function defaultEditorProps(ctx: CellEditorContext): Record<string, unknown>;
+/** Resolve the props to spread onto a registered editor for a given context. */
+export declare function resolveEditorProps(registration: CellEditorRegistration, ctx: CellEditorContext): Record<string, unknown>;

package/dist/editor-registry.js

@@ -0,0 +1,38 @@
+const registry = new Map();
+/**
+ * Register a cell editor under `type`. Pass a component (uses the default prop
+ * mapping) or a full {@link CellEditorRegistration} for custom prop mapping.
+ * Re-registering the same type replaces it.
+ */
+export function registerCellEditor(type, registration) {
+    registry.set(type, typeof registration === 'function' ? { component: registration } : registration);
+}
+/** Look up a registered cell editor by type. */
+export function getCellEditor(type) {
+    return registry.get(type);
+}
+/** Whether a custom editor is registered for `type`. */
+export function hasCellEditor(type) {
+    return registry.has(type);
+}
+/** Remove a registered cell editor. */
+export function unregisterCellEditor(type) {
+    registry.delete(type);
+}
+/** All registered custom editor type names. */
+export function registeredCellEditorTypes() {
+    return [...registry.keys()];
+}
+/** The default context → props mapping used when a registration has no `props`. */
+export function defaultEditorProps(ctx) {
+    return {
+        value: ctx.value,
+        onChange: ctx.onChange,
+        onCommit: ctx.onCommit,
+        onCancel: ctx.onCancel,
+    };
+}
+/** Resolve the props to spread onto a registered editor for a given context. */
+export function resolveEditorProps(registration, ctx) {
+    return registration.props ? registration.props(ctx) : defaultEditorProps(ctx);
+}

package/dist/editors/cell-editors.d.ts

@@ -1,4 +1,4 @@
-export type CellEditorType = 'text' | 'number' | 'date' | 'datetime' | 'time' | 'date-native' | 'datetime-native' | 'time-native' | 'password' | 'checkbox' | 'list' | 'chips' | 'select' | 'rich-select' | 'autocomplete' | 'textarea' | 'color' | 'rating';
+export type CellEditorType = 'text' | 'number' | 'date' | 'datetime' | 'time' | 'date-native' | 'datetime-native' | 'time-native' | 'password' | 'checkbox' | 'list' | 'chips' | 'select' | 'rich-select' | 'autocomplete' | 'textarea' | 'color' | 'rating' | (string & {});
 /** Normalized option used by list/chips editors. The optional `color`
  *  paints the chip - both in the in-cell readonly chips render and in
  *  the dropdown trigger when `renderChipsInTrigger` is on. Any CSS

package/dist/editors/cell-editors.js

@@ -1,3 +1,4 @@
+import { hasCellEditor } from '../editor-registry';
 /** Normalize the loose `editorOptions` ColumnDef prop into a uniform shape.
  *  Dynamic (function) editorOptions are resolved before reaching here. */
 export function normalizeEditorOptions(options) {
@@ -80,6 +81,10 @@ export function parseEditorValue(rawType, value, opts) {
     if (type === 'textarea') {
         return String(value ?? '');
     }
+    // Custom registered editors own their value shape (like list/chips), so pass
+    // whatever the editor committed through unchanged instead of stringifying it.
+    if (hasCellEditor(type))
+        return value;
     if (type === 'list' || type === 'chips') {
         // The editor manages the value shape: a scalar for single-select, an
         // array for multi-select. Trust what the editor handed us, just coerce

package/dist/fuzzy.d.ts

@@ -0,0 +1,3 @@
+export declare function fuzzyScore(text: string, query: string): number | null;
+/** Whether `query` fuzzy-matches `text`. */
+export declare function fuzzyMatch(text: string, query: string): boolean;

package/dist/fuzzy.js

@@ -0,0 +1,41 @@
+/**
+ * fuzzy - a tiny subsequence fuzzy matcher for command palettes / quick filters.
+ * `fuzzyScore(text, query)` returns a score (higher = better) when every query
+ * character appears in order in `text`, or `null` when it doesn't. Contiguous
+ * runs, word-boundary starts and early matches score higher. Case-insensitive,
+ * pure, dependency-free.
+ */
+const BOUNDARY = /[\s\-_/.]/;
+export function fuzzyScore(text, query) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return 0;
+    const t = text.toLowerCase();
+    let from = 0;
+    let score = 0;
+    let run = 0;
+    let prev = -2;
+    for (const ch of q) {
+        const idx = t.indexOf(ch, from);
+        if (idx < 0)
+            return null;
+        if (idx === prev + 1) {
+            run += 1;
+            score += 5 + run * 2; // contiguous run
+        }
+        else {
+            run = 0;
+            score += 1;
+        }
+        if (idx === 0 || BOUNDARY.test(t[idx - 1] ?? ''))
+            score += 8; // word start
+        score += Math.max(0, 3 - Math.floor(idx / 4)); // earliness
+        prev = idx;
+        from = idx + 1;
+    }
+    return score;
+}
+/** Whether `query` fuzzy-matches `text`. */
+export function fuzzyMatch(text, query) {
+    return fuzzyScore(text, query) !== null;
+}

package/dist/grid-select.d.ts

@@ -0,0 +1,9 @@
+/**
+ * grid-select - pure helper behind <SvGridSelect>: filter option rows by a
+ * free-text query across a set of fields (case-insensitive substring match).
+ * Framework-free + pure so it is unit-tested directly.
+ */
+export type Row = Record<string, unknown>;
+/** Rows where ANY of `fields` contains `query` (case-insensitive). Blank query
+ *  returns every row. */
+export declare function filterGridRows<T extends Row>(rows: ReadonlyArray<T>, fields: ReadonlyArray<string>, query: string): T[];

package/dist/grid-select.js

@@ -0,0 +1,8 @@
+/** Rows where ANY of `fields` contains `query` (case-insensitive). Blank query
+ *  returns every row. */
+export function filterGridRows(rows, fields, query) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return [...rows];
+    return rows.filter((row) => fields.some((f) => String(row[f] ?? '').toLowerCase().includes(q)));
+}

package/dist/index.d.ts

@@ -5,11 +5,24 @@ export { createGrid, createSvGrid, type SvelteGrid } from './createGrid.svelte';
 export { createGridState, createSvGridState } from './createGridState.svelte';
 export { subscribeGrid, subscribeSvGrid } from './subscribe';
 export { default as SvGrid } from './SvGrid.svelte';
+export { default as SvGridBoard } from './SvGridBoard.svelte';
+export type { BoardConfig, BoardLane, BoardCardMoveEvent, BoardCardCommitEvent, BoardLayout, BoardSubtask, BoardComment, BoardMenuContext, BoardLaneMenuContext, BoardDrawerConfig } from './SvGrid.types';
 export { default as SvGridDropdown } from './SvGridDropdown.svelte';
 export { default as SvCalendar, type CalendarValue, type CalendarPreset, type CalendarAnimation } from './SvCalendar.svelte';
+export { matchesRecurrence, expandRecurrence, type RecurrenceRule, type RecurrenceFreq } from './recurrence';
 export { default as SvTimePicker, type TimeValue } from './SvTimePicker.svelte';
 export { default as SvDateTimePicker, type DateTimeValue } from './SvDateTimePicker.svelte';
-export { editorAria, editorErrorId, type SvEditorProps, type EditorSize, type EditorAriaState } from './editor-contract';
+export { default as SvDateRangeInput, type DateRangeValue } from './SvDateRangeInput.svelte';
+export { default as SvButtonGroup, type ButtonGroupItem, type ButtonGroupMode, type ButtonGroupValue } from './SvButtonGroup.svelte';
+export { editorAria, editorErrorId, editorHintId, nextEditorId, resolveMessages, type SvEditorProps, type EditorSize, type EditorDir, type EditorAriaState, } from './editor-contract';
+export { type EditorInteraction } from './editor-contract';
+export { FOCUSABLE_SELECTOR, getFocusable, createFocusTrap, type FocusTrap, type FocusTrapOptions, } from './a11y/focus-trap';
+export { lockScroll, scrollLockDepth } from './a11y/scroll-lock';
+export { createDismissableLayer, dismissableDepth, type DismissableLayer, type DismissableOptions, } from './a11y/dismissable';
+export { announce, type AnnounceOptions } from './a11y/live-region';
+export { registerCellEditor, getCellEditor, hasCellEditor, unregisterCellEditor, registeredCellEditorTypes, defaultEditorProps, resolveEditorProps, type CellEditorContext, type CellEditorRegistration, } from './editor-registry';
+export { registerBuiltinEditors } from './builtin-editors';
+export { default as SvField } from './SvField.svelte';
 export { createListbox, toSelectedArray, type Listbox, type ListboxConfig, type ListboxValue, type ListboxRootProps, type OptionProps, } from './createListbox.svelte';
 export { createCombobox, type Combobox, type ComboboxConfig, type ComboboxValue } from './createCombobox.svelte';
 export { createDropdownList, type DropdownList, type DropdownListConfig, type DropdownValue } from './createDropdownList.svelte';
@@ -18,7 +31,7 @@ export { createTagsInput, type TagsInput, type TagsInputConfig } from './createT
 export { createCountryInput, type CountryInput, type CountryInputConfig } from './createCountryInput.svelte';
 export { createNumberInput, type NumberInputConfig, type NumberInputCore } from './createNumberInput.svelte';
 export { createMaskedInput, type MaskedInputConfig, type MaskedInputCore } from './createMaskedInput.svelte';
-export { createPhoneInput, type PhoneInputConfig, type PhoneInputCore } from './createPhoneInput.svelte';
+export { createPhoneInput, type PhoneInputConfig, type PhoneInputCore, type PhoneParts } from './createPhoneInput.svelte';
 export { createColorInput, normalizeHex, type ColorInputConfig, type ColorInputCore } from './createColorInput.svelte';
 export { createPasswordInput, passwordStrength, STRENGTH_LABELS, type PasswordInputConfig, type PasswordInputCore } from './createPasswordInput.svelte';
 export { createToggle, type Toggle, type ToggleConfig, type ToggleButtonProps } from './createToggle.svelte';
@@ -30,9 +43,10 @@ export { createCalendar, normalizeCalendarValue, type Calendar, type CalendarCon
 export { createTimePicker, parseTimeValue, type TimePicker, type TimePickerConfig, type TimeSelection, type TimeFormat, type DialTick } from './createTimePicker.svelte';
 export { createDateTimePicker, type DateTimePicker, type DateTimePickerConfig, type DropDownDisplayMode, type DateTimeTab } from './createDateTimePicker.svelte';
 export { createTabs, type Tabs, type TabsConfig, type TabsOrientation, type TabsActivation } from './createTabs.svelte';
-export { createTree, treeDescendantIds, treeCheckState, type Tree, type TreeConfig, type TreeRow, type CheckState } from './createTree.svelte';
+export { createTree, treeDescendantIds, treeCheckState, moveTreeNode, sortTreeNodes, treeContains, type Tree, type TreeConfig, type TreeRow, type CheckState, type TreeDropPosition } from './createTree.svelte';
 export { createSlider, type Slider, type SliderConfig, type SliderValue, type SliderOrientation, type SliderThumb, type SliderPoint } from './createSlider.svelte';
 export { createGauge, type Gauge, type GaugeConfig, type GaugePoint } from './createGauge.svelte';
+export { createButtonGroup, toGroupArray, type ButtonGroup, type ButtonGroupConfig } from './createButtonGroup.svelte';
 export { default as SvButton } from './SvButton.svelte';
 export { default as SvRepeatButton } from './SvRepeatButton.svelte';
 export { default as SvToggleButton } from './SvToggleButton.svelte';
@@ -40,25 +54,81 @@ export { default as SvSwitchButton } from './SvSwitchButton.svelte';
 export { default as SvCheckBox } from './SvCheckBox.svelte';
 export { default as SvRadioGroup, type RadioOption } from './SvRadioGroup.svelte';
 export { default as SvRating } from './SvRating.svelte';
+export { default as SvTextInput } from './SvTextInput.svelte';
+export { default as SvTextArea } from './SvTextArea.svelte';
+export { default as SvOtpInput } from './SvOtpInput.svelte';
+export { sanitizeOtp, otpCells, isOtpComplete } from './otp';
+export { default as SvDurationInput } from './SvDurationInput.svelte';
+export { parseDuration, formatDuration } from './duration';
 export { default as SvNumberInput } from './SvNumberInput.svelte';
 export { default as SvPasswordInput } from './SvPasswordInput.svelte';
 export { default as SvMaskedInput } from './SvMaskedInput.svelte';
 export { default as SvPhoneInput } from './SvPhoneInput.svelte';
 export { default as SvColorInput } from './SvColorInput.svelte';
 export { applyMask, unmask, isMaskComplete } from './datetime/mask';
-export { COUNTRIES, COUNTRY_BY_CODE, flagEmoji, type Country } from './countries';
+export { COUNTRIES, COUNTRY_BY_CODE, flagEmoji, phoneDigitsValid, PHONE_NATIONAL_LENGTHS, type Country } from './countries';
 export { default as SvListBox } from './SvListBox.svelte';
 export { default as SvDropDownList } from './SvDropDownList.svelte';
 export { default as SvComboBox } from './SvComboBox.svelte';
 export { default as SvAutoComplete } from './SvAutoComplete.svelte';
 export { default as SvTagsInput } from './SvTagsInput.svelte';
+export { default as SvMultiSelect, type MultiSelectOption } from './SvMultiSelect.svelte';
+export { debounce, type Debounced } from './debounce';
+export { default as SvTreeSelect, type TreeSelectNode } from './SvTreeSelect.svelte';
+export { flattenVisible, findNodePath, branchValues, type FlatRow } from './tree-select';
+export { default as SvGridSelect, type GridSelectColumn } from './SvGridSelect.svelte';
+export { filterGridRows } from './grid-select';
 export { default as SvCountryInput } from './SvCountryInput.svelte';
-export { filterOptions, type ListOption } from './list-option';
+export { filterOptions, groupOptions, hasGroups, nextTypeaheadIndex, createTypeaheadBuffer, isTypeaheadKey, type ListOption, type IndexedOption, type OptionGroup, } from './list-option';
+export { virtualRange, scrollToIndex, type VirtualRange, type VirtualParams } from './virtual';
 export { default as SvSlider } from './SvSlider.svelte';
 export { default as SvGauge } from './SvGauge.svelte';
 export { default as SvTabs, type TabItem } from './SvTabs.svelte';
 export { default as SvTree, type TreeNode as SvTreeNode } from './SvTree.svelte';
+export { default as SvAccordion, type AccordionItem, type AccordionExpandMode } from './SvAccordion.svelte';
+export { createAccordion, type Accordion, type AccordionConfig } from './createAccordion.svelte';
+export { default as SvSplitter, type SplitterOrientation } from './SvSplitter.svelte';
+export { createSplitter, type Splitter, type SplitterConfig, type SplitterPoint } from './createSplitter.svelte';
+export { default as SvFileUpload, type FileRejection, type FileRejectReason } from './SvFileUpload.svelte';
+export { createFileUpload, fileMatchesAccept, type FileUpload, type FileUploadConfig } from './createFileUpload.svelte';
+export { default as SvPopover } from './SvPopover.svelte';
+export { default as SvTooltip } from './SvTooltip.svelte';
+export { default as SvModal } from './SvModal.svelte';
+export { default as SvDrawer } from './SvDrawer.svelte';
+export type DrawerSide = 'right' | 'left' | 'top' | 'bottom';
+export { default as SvToaster } from './SvToaster.svelte';
+export { default as SvBadge } from './SvBadge.svelte';
+export { default as SvSkeleton } from './SvSkeleton.svelte';
+export { default as SvCard } from './SvCard.svelte';
+export { default as SvAlert } from './SvAlert.svelte';
+export { default as SvEmptyState } from './SvEmptyState.svelte';
+export { default as SvDivider } from './SvDivider.svelte';
+export { default as SvChip } from './SvChip.svelte';
+export { default as SvStat } from './SvStat.svelte';
+export { default as SvTimeline, type TimelineItem } from './SvTimeline.svelte';
+export { default as SvSparkline } from './SvSparkline.svelte';
+export { default as SvScrollArea } from './SvScrollArea.svelte';
+export { default as SvAvatarGroup } from './SvAvatarGroup.svelte';
+export { default as SvCommand, type CommandItem } from './SvCommand.svelte';
+export { fuzzyScore, fuzzyMatch } from './fuzzy';
+export { default as SvRichText, type RichTextTool } from './SvRichText.svelte';
+export { default as SvCarousel } from './SvCarousel.svelte';
+export { default as SvTour, type TourStep } from './SvTour.svelte';
+export { default as SvPagination } from './SvPagination.svelte';
+export { paginationRange, type PaginationItem, type PaginationRangeOptions } from './paginate';
+export { default as SvBreadcrumb, type BreadcrumbItem } from './SvBreadcrumb.svelte';
+export { default as SvStepper, type StepItem } from './SvStepper.svelte';
+export { default as SvAvatar } from './SvAvatar.svelte';
+export { avatarInitials, avatarColorHue } from './avatar';
+export { default as SvContextMenu } from './SvContextMenu.svelte';
+export { toast, dismissToast, clearToasts, pauseToast, resumeToast, toastStore, type Toast, type ToastVariant, type ToastOptions, type ToastFn, } from './toast-store.svelte';
+export { default as SvMenu, type MenuItem } from './SvMenu.svelte';
+export { default as SvNavPane, type NavItem, type NavSection, type NavModule } from './SvNavPane.svelte';
+export { default as SvProgress } from './SvProgress.svelte';
+export { default as SvCircularProgress } from './SvCircularProgress.svelte';
+export { popIn } from './popover';
 export { default as SvForm, type FormField, type FormFieldType } from './SvForm.svelte';
+export { rules, runRules, isEmptyValue, type Validator, type RuleOptions, type CompareOp } from './validators';
 export { anchoredRect, portalToBody, PANEL_THEME_VARS, type AnchoredRect } from './popover';
 export { toDate, startOfDay, addDays, addMonths, addYears, clampDate, isSameDay, monthMatrix, isoWeek, decadeRange, withTime, snapMinute, type DateLike, } from './datetime/date-core';
 export { formatDate, parseDate, tokenizeMask } from './datetime/date-format';
@@ -77,7 +147,10 @@ export { resolveColumnTypes, inferCellDataType, type CellDataType } from './colu
 export { computeColumnGroupMeta, hiddenLeavesForCollapse, type ColumnGroupMeta, type ColumnGroupShow, } from './column-groups';
 export { createHyperFormulaSheet, type HyperFormulaSheet, type HyperFormulaSheetConfig, type HyperFormulaInstance, } from './hyperformula-adapter';
 export { createCollaboration, broadcastChannelTransport, type CollabUser, type CollabCell, type CollabPresence, type CollabMessage, type CollabTransport, type Collaboration, } from './collaboration';
-export { createServerDataSource, type ServerDataSource, type ServerRequest, type ServerResult, type ServerController, type ServerState, type ServerSortModel, type ServerFilterModel, } from './server-data-source';
+export { createServerDataSource, type ServerDataSource, type ServerRequest, type ServerResult, type ServerController, type ServerState, type ServerSortModel, type ServerFilterModel, type ServerAggregation, type ServerGroupRow, type ServerLeafRow, type ServerMoreRow, type ServerFooterRow, type ServerSkeletonRow, type ServerDisplayRow, } from './server-data-source';
+export { createServerGroupModel, serverGroupRows, serverGroupNav, type ServerGroupController, type ServerGroupControllerOptions, type ServerGroupState, type ServerGroupGridRow, } from './server-group-model';
+export { default as SvGroupCell } from './SvGroupCell.svelte';
+export { default as SvRowGroupPanel } from './SvRowGroupPanel.svelte';
 export { createNamedViews, memoryViews, localStorageViews, attachAutoSavedView, type SavedView, type ViewStorage, type NamedViews, type AutoSavedViewOptions, } from './named-views';
 export { resolveCellFormat, computeColumnStat, lerpColor, contrastText, type ConditionalFormat, type ConditionalFormatSpec, type ColorScaleFormat, type DataBarFormat, type IconSetFormat, type RuleFormat, type ResolvedCellFormat, } from './conditional-formatting';
 export { getKeyboardIntent, getNextActiveCell, type GridKeyboardIntent } from './keyboard';

package/dist/index.js

@@ -5,12 +5,26 @@ export { createGrid, createSvGrid } from './createGrid.svelte';
 export { createGridState, createSvGridState } from './createGridState.svelte';
 export { subscribeGrid, subscribeSvGrid } from './subscribe';
 export { default as SvGrid } from './SvGrid.svelte';
+export { default as SvGridBoard } from './SvGridBoard.svelte';
 export { default as SvGridDropdown } from './SvGridDropdown.svelte';
 export { default as SvCalendar } from './SvCalendar.svelte';
+export { matchesRecurrence, expandRecurrence } from './recurrence';
 export { default as SvTimePicker } from './SvTimePicker.svelte';
 export { default as SvDateTimePicker } from './SvDateTimePicker.svelte';
+export { default as SvDateRangeInput } from './SvDateRangeInput.svelte';
+export { default as SvButtonGroup } from './SvButtonGroup.svelte';
 // UI kit - shared editor contract (common props + a11y wiring for every editor)
-export { editorAria, editorErrorId } from './editor-contract';
+export { editorAria, editorErrorId, editorHintId, nextEditorId, resolveMessages, } from './editor-contract';
+// UI kit - shared a11y primitives (focus trap, scroll lock, dismissable layers, live region)
+export { FOCUSABLE_SELECTOR, getFocusable, createFocusTrap, } from './a11y/focus-trap';
+export { lockScroll, scrollLockDepth } from './a11y/scroll-lock';
+export { createDismissableLayer, dismissableDepth, } from './a11y/dismissable';
+export { announce } from './a11y/live-region';
+// UI kit - custom cell-editor registry (register any component as a grid editor)
+export { registerCellEditor, getCellEditor, hasCellEditor, unregisterCellEditor, registeredCellEditorTypes, defaultEditorProps, resolveEditorProps, } from './editor-registry';
+export { registerBuiltinEditors } from './builtin-editors';
+// UI kit - shared field chrome (label + hint + error + direction wrapper)
+export { default as SvField } from './SvField.svelte';
 // UI kit - headless cores (state + prop-getters you render yourself, like createSvGrid)
 export { createListbox, toSelectedArray, } from './createListbox.svelte';
 // Selection family cores
@@ -37,9 +51,10 @@ export { createTimePicker, parseTimeValue } from './createTimePicker.svelte';
 export { createDateTimePicker } from './createDateTimePicker.svelte';
 // Layout & range family cores
 export { createTabs } from './createTabs.svelte';
-export { createTree, treeDescendantIds, treeCheckState } from './createTree.svelte';
+export { createTree, treeDescendantIds, treeCheckState, moveTreeNode, sortTreeNodes, treeContains } from './createTree.svelte';
 export { createSlider } from './createSlider.svelte';
 export { createGauge } from './createGauge.svelte';
+export { createButtonGroup, toGroupArray } from './createButtonGroup.svelte';
 // UI kit - Group B (buttons & toggles)
 export { default as SvButton } from './SvButton.svelte';
 export { default as SvRepeatButton } from './SvRepeatButton.svelte';
@@ -49,28 +64,84 @@ export { default as SvCheckBox } from './SvCheckBox.svelte';
 export { default as SvRadioGroup } from './SvRadioGroup.svelte';
 export { default as SvRating } from './SvRating.svelte';
 // UI kit - Group C (text inputs)
+export { default as SvTextInput } from './SvTextInput.svelte';
+export { default as SvTextArea } from './SvTextArea.svelte';
+export { default as SvOtpInput } from './SvOtpInput.svelte';
+export { sanitizeOtp, otpCells, isOtpComplete } from './otp';
+export { default as SvDurationInput } from './SvDurationInput.svelte';
+export { parseDuration, formatDuration } from './duration';
 export { default as SvNumberInput } from './SvNumberInput.svelte';
 export { default as SvPasswordInput } from './SvPasswordInput.svelte';
 export { default as SvMaskedInput } from './SvMaskedInput.svelte';
 export { default as SvPhoneInput } from './SvPhoneInput.svelte';
 export { default as SvColorInput } from './SvColorInput.svelte';
 export { applyMask, unmask, isMaskComplete } from './datetime/mask';
-export { COUNTRIES, COUNTRY_BY_CODE, flagEmoji } from './countries';
+export { COUNTRIES, COUNTRY_BY_CODE, flagEmoji, phoneDigitsValid, PHONE_NATIONAL_LENGTHS } from './countries';
 // UI kit - Group D (selection overlays)
 export { default as SvListBox } from './SvListBox.svelte';
 export { default as SvDropDownList } from './SvDropDownList.svelte';
 export { default as SvComboBox } from './SvComboBox.svelte';
 export { default as SvAutoComplete } from './SvAutoComplete.svelte';
 export { default as SvTagsInput } from './SvTagsInput.svelte';
+export { default as SvMultiSelect } from './SvMultiSelect.svelte';
+export { debounce } from './debounce';
+export { default as SvTreeSelect } from './SvTreeSelect.svelte';
+export { flattenVisible, findNodePath, branchValues } from './tree-select';
+export { default as SvGridSelect } from './SvGridSelect.svelte';
+export { filterGridRows } from './grid-select';
 export { default as SvCountryInput } from './SvCountryInput.svelte';
-export { filterOptions } from './list-option';
+export { filterOptions, groupOptions, hasGroups, nextTypeaheadIndex, createTypeaheadBuffer, isTypeaheadKey, } from './list-option';
+export { virtualRange, scrollToIndex } from './virtual';
 // UI kit - Group E (range & feedback)
 export { default as SvSlider } from './SvSlider.svelte';
 export { default as SvGauge } from './SvGauge.svelte';
 // UI kit - Group F (composite / layout)
 export { default as SvTabs } from './SvTabs.svelte';
 export { default as SvTree } from './SvTree.svelte';
+export { default as SvAccordion } from './SvAccordion.svelte';
+export { createAccordion } from './createAccordion.svelte';
+export { default as SvSplitter } from './SvSplitter.svelte';
+export { createSplitter } from './createSplitter.svelte';
+export { default as SvFileUpload } from './SvFileUpload.svelte';
+export { createFileUpload, fileMatchesAccept } from './createFileUpload.svelte';
+// UI kit - overlays (popover / tooltip / modal), sharing the popover.ts positioning + animation
+export { default as SvPopover } from './SvPopover.svelte';
+export { default as SvTooltip } from './SvTooltip.svelte';
+export { default as SvModal } from './SvModal.svelte';
+export { default as SvDrawer } from './SvDrawer.svelte';
+export { default as SvToaster } from './SvToaster.svelte';
+export { default as SvBadge } from './SvBadge.svelte';
+export { default as SvSkeleton } from './SvSkeleton.svelte';
+export { default as SvCard } from './SvCard.svelte';
+export { default as SvAlert } from './SvAlert.svelte';
+export { default as SvEmptyState } from './SvEmptyState.svelte';
+export { default as SvDivider } from './SvDivider.svelte';
+export { default as SvChip } from './SvChip.svelte';
+export { default as SvStat } from './SvStat.svelte';
+export { default as SvTimeline } from './SvTimeline.svelte';
+export { default as SvSparkline } from './SvSparkline.svelte';
+export { default as SvScrollArea } from './SvScrollArea.svelte';
+export { default as SvAvatarGroup } from './SvAvatarGroup.svelte';
+export { default as SvCommand } from './SvCommand.svelte';
+export { fuzzyScore, fuzzyMatch } from './fuzzy';
+export { default as SvRichText } from './SvRichText.svelte';
+export { default as SvCarousel } from './SvCarousel.svelte';
+export { default as SvTour } from './SvTour.svelte';
+export { default as SvPagination } from './SvPagination.svelte';
+export { paginationRange } from './paginate';
+export { default as SvBreadcrumb } from './SvBreadcrumb.svelte';
+export { default as SvStepper } from './SvStepper.svelte';
+export { default as SvAvatar } from './SvAvatar.svelte';
+export { avatarInitials, avatarColorHue } from './avatar';
+export { default as SvContextMenu } from './SvContextMenu.svelte';
+export { toast, dismissToast, clearToasts, pauseToast, resumeToast, toastStore, } from './toast-store.svelte';
+export { default as SvMenu } from './SvMenu.svelte';
+export { default as SvNavPane } from './SvNavPane.svelte';
+export { default as SvProgress } from './SvProgress.svelte';
+export { default as SvCircularProgress } from './SvCircularProgress.svelte';
+export { popIn } from './popover';
 export { default as SvForm } from './SvForm.svelte';
+export { rules, runRules, isEmptyValue } from './validators';
 export { anchoredRect, portalToBody, PANEL_THEME_VARS } from './popover';
 export { toDate, startOfDay, addDays, addMonths, addYears, clampDate, isSameDay, monthMatrix, isoWeek, decadeRange, withTime, snapMinute, } from './datetime/date-core';
 export { formatDate, parseDate, tokenizeMask } from './datetime/date-format';
@@ -90,6 +161,9 @@ export { computeColumnGroupMeta, hiddenLeavesForCollapse, } from './column-group
 export { createHyperFormulaSheet, } from './hyperformula-adapter';
 export { createCollaboration, broadcastChannelTransport, } from './collaboration';
 export { createServerDataSource, } from './server-data-source';
+export { createServerGroupModel, serverGroupRows, serverGroupNav, } from './server-group-model';
+export { default as SvGroupCell } from './SvGroupCell.svelte';
+export { default as SvRowGroupPanel } from './SvRowGroupPanel.svelte';
 export { createNamedViews, memoryViews, localStorageViews, attachAutoSavedView, } from './named-views';
 export { resolveCellFormat, computeColumnStat, lerpColor, contrastText, } from './conditional-formatting';
 export { getKeyboardIntent, getNextActiveCell } from './keyboard';

package/dist/keyboard-handlers.js

@@ -103,6 +103,25 @@ export function createKeyboard(ctx) {
             return;
         }
         event.preventDefault();
+        // Server-side group / tree navigation, built into the grid: ArrowRight
+        // expands a collapsed group row, ArrowLeft collapses an expanded one,
+        // instead of moving the active cell (treegrid-style). Leaves fall through
+        // to normal navigation.
+        const serverGroup = ctx.props.serverGroup;
+        if (serverGroup && (intent === "moveRight" || intent === "moveLeft")) {
+            const data = ctx.allRows[current.rowIndex]?.original;
+            if (data !== undefined && serverGroup.isGroup(data)) {
+                const expanded = serverGroup.expanded?.(data) ?? false;
+                if (intent === "moveRight" && !expanded) {
+                    serverGroup.onToggle(data);
+                    return;
+                }
+                if (intent === "moveLeft" && expanded) {
+                    serverGroup.onToggle(data);
+                    return;
+                }
+            }
+        }
         if (intent === "clearCells") {
             // Excel `Delete` - clear contents of every cell in the selection
             // (or the active cell if no range). Formatting is left alone, only

package/dist/list-option.d.ts

@@ -8,3 +8,39 @@ export type ListOption = {
 };
 /** Case-insensitive substring filter over option labels. */
 export declare function filterOptions(options: ReadonlyArray<ListOption>, query: string): ListOption[];
+/** An option carrying its position in the flat source array (for prop-getters). */
+export type IndexedOption = ListOption & {
+    index: number;
+};
+/** A section of options that share a `group` heading (null = ungrouped). */
+export type OptionGroup = {
+    group: string | null;
+    options: IndexedOption[];
+};
+/**
+ * Bucket options by their `group` heading, preserving each option's flat index
+ * so grouped rendering still drives `optionProps(index)` etc. Groups appear in
+ * first-seen order. When no option sets `group`, the result is a single
+ * `group: null` section (render it flat).
+ */
+export declare function groupOptions(options: ReadonlyArray<ListOption>): OptionGroup[];
+/** Whether any option declares a `group` (so headings are worth rendering). */
+export declare function hasGroups(options: ReadonlyArray<ListOption>): boolean;
+/**
+ * Next enabled option index whose label starts with `buffer` (type-ahead),
+ * searching forward from just after `from` and wrapping. Returns -1 for no
+ * match / empty buffer. Case-insensitive.
+ */
+export declare function nextTypeaheadIndex(options: ReadonlyArray<ListOption>, buffer: string, from: number): number;
+/**
+ * A tiny type-ahead buffer: accumulates printable characters within `timeout`
+ * ms of each other, then resets. Frameworkfree; the caller supplies scheduling.
+ */
+export declare function createTypeaheadBuffer(timeout?: number): {
+    readonly value: string;
+    /** Append a character and (re)arm the reset timer. Returns the new buffer. */
+    push(char: string): string;
+    clear(): void;
+};
+/** Whether a keydown is a bare printable character (a type-ahead candidate). */
+export declare function isTypeaheadKey(e: KeyboardEvent): boolean;

package/dist/list-option.js

@@ -5,3 +5,71 @@ export function filterOptions(options, query) {
         return [...options];
     return options.filter((o) => o.label.toLowerCase().includes(q));
 }
+/**
+ * Bucket options by their `group` heading, preserving each option's flat index
+ * so grouped rendering still drives `optionProps(index)` etc. Groups appear in
+ * first-seen order. When no option sets `group`, the result is a single
+ * `group: null` section (render it flat).
+ */
+export function groupOptions(options) {
+    const groups = [];
+    const byName = new Map();
+    options.forEach((o, index) => {
+        const key = o.group ?? null;
+        let g = byName.get(key);
+        if (!g) {
+            g = { group: key, options: [] };
+            byName.set(key, g);
+            groups.push(g);
+        }
+        g.options.push({ ...o, index });
+    });
+    return groups;
+}
+/** Whether any option declares a `group` (so headings are worth rendering). */
+export function hasGroups(options) {
+    return options.some((o) => o.group != null);
+}
+/**
+ * Next enabled option index whose label starts with `buffer` (type-ahead),
+ * searching forward from just after `from` and wrapping. Returns -1 for no
+ * match / empty buffer. Case-insensitive.
+ */
+export function nextTypeaheadIndex(options, buffer, from) {
+    const b = buffer.trim().toLowerCase();
+    if (!b || !options.length)
+        return -1;
+    const n = options.length;
+    for (let k = 1; k <= n; k++) {
+        const i = (from + k) % n;
+        const o = options[i];
+        if (o && !o.disabled && o.label.toLowerCase().startsWith(b))
+            return i;
+    }
+    return -1;
+}
+/**
+ * A tiny type-ahead buffer: accumulates printable characters within `timeout`
+ * ms of each other, then resets. Frameworkfree; the caller supplies scheduling.
+ */
+export function createTypeaheadBuffer(timeout = 600) {
+    let buffer = '';
+    let timer;
+    return {
+        get value() { return buffer; },
+        /** Append a character and (re)arm the reset timer. Returns the new buffer. */
+        push(char) {
+            buffer += char;
+            if (timer)
+                clearTimeout(timer);
+            timer = setTimeout(() => { buffer = ''; }, timeout);
+            return buffer;
+        },
+        clear() { buffer = ''; if (timer)
+            clearTimeout(timer); },
+    };
+}
+/** Whether a keydown is a bare printable character (a type-ahead candidate). */
+export function isTypeaheadKey(e) {
+    return e.key.length === 1 && !e.ctrlKey && !e.metaKey && !e.altKey && e.key !== ' ';
+}

package/dist/otp.d.ts

@@ -0,0 +1,16 @@
+/**
+ * otp - pure helpers behind <SvOtpInput>: sanitize/spread a raw string across N
+ * segments (used on paste and per-cell input) and detect completion.
+ * Framework-free + pure so they are unit-tested directly.
+ */
+/**
+ * Keep only the characters allowed for `numeric` mode (digits) or any
+ * non-whitespace otherwise, then clamp to `length`. Returns the cleaned string
+ * (<= length chars).
+ */
+export declare function sanitizeOtp(raw: string, length: number, numeric: boolean): string;
+/** Split a value into exactly `length` single-char cells (padding with ''). */
+export declare function otpCells(value: string, length: number): string[];
+/** Whether `value` fills every cell (a joined OTP has no internal gaps, so an
+ *  exact-length string is complete). */
+export declare function isOtpComplete(value: string, length: number): boolean;