@svgrid/grid 2.1.22 → 2.2.0

package/dist/filtering/excel-filters.js

@@ -13,6 +13,30 @@ export function normalizeForFilter(s, locale) {
         ? stripped.toLocaleLowerCase(locale)
         : stripped.toLowerCase();
 }
+/**
+ * Delimiter used to serialise the `in` / `notIn` value list into the single
+ * `value` string that the filter model carries. A newline is used because it
+ * (unlike a comma) practically never appears inside a typed token, so tokens
+ * survive the round-trip unescaped. The chip input in the filter row reads and
+ * writes with the same separator via {@link splitInTokens} / {@link joinInTokens}.
+ */
+export const IN_TOKEN_SEP = '\n';
+/**
+ * Split a serialised `in` / `notIn` value into its individual tokens. Accepts
+ * both the newline separator the chip input writes and a plain comma-separated
+ * string (what a raw text field, e.g. the tool-panel filter, produces), so the
+ * same value round-trips through either UI.
+ */
+export function splitInTokens(value) {
+    return String(value ?? '')
+        .split(/[\n,]/)
+        .map((t) => t.trim())
+        .filter((t) => t.length > 0);
+}
+/** Serialise a list of tokens back into the single `in` / `notIn` value. */
+export function joinInTokens(tokens) {
+    return tokens.map((t) => t.trim()).filter((t) => t.length > 0).join(IN_TOKEN_SEP);
+}
 export function applyExcelFilter(cellValue, filter, options) {
     const text = String(cellValue ?? '');
     const normalizedText = normalizeForFilter(text, options?.locale);
@@ -20,10 +44,40 @@ export function applyExcelFilter(cellValue, filter, options) {
     switch (filter.operator) {
         case 'contains':
             return normalizedText.includes(normalizedValue);
+        case 'notContains':
+            // An empty needle is no constraint (mirrors `contains` returning true),
+            // so nothing is excluded until the user types something.
+            return normalizedValue === '' || !normalizedText.includes(normalizedValue);
         case 'equals':
             return normalizedText === normalizedValue;
+        case 'notEquals':
+            return normalizedValue === '' || normalizedText !== normalizedValue;
         case 'startsWith':
             return normalizedText.startsWith(normalizedValue);
+        case 'endsWith':
+            return normalizedText.endsWith(normalizedValue);
+        case 'regex': {
+            // Case-insensitive by default (matches the accent/case-folded feel of
+            // the other text operators). An invalid pattern matches nothing rather
+            // than throwing, so a half-typed regex never crashes the row model.
+            const pattern = String(filter.value ?? '');
+            if (!pattern)
+                return true;
+            try {
+                return new RegExp(pattern, 'i').test(text);
+            }
+            catch {
+                return false;
+            }
+        }
+        case 'in':
+        case 'notIn': {
+            const tokens = splitInTokens(filter.value);
+            if (tokens.length === 0)
+                return true;
+            const hit = tokens.some((t) => normalizeForFilter(t, options?.locale) === normalizedText);
+            return filter.operator === 'in' ? hit : !hit;
+        }
         case 'greaterThan': {
             const a = Number(cellValue);
             const b = Number(filter.value);
@@ -60,5 +114,7 @@ export function applyExcelFilter(cellValue, filter, options) {
         }
         case 'isBlank':
             return text.trim().length === 0;
+        case 'isNotBlank':
+            return text.trim().length > 0;
     }
 }

package/dist/form-field.d.ts

@@ -0,0 +1,73 @@
+import type { Validator } from './validators';
+/**
+ * Field descriptor for <SvForm> and the headless `createForm` core. Kept in a
+ * plain `.ts` module so the core can import the type without pulling in the
+ * `.svelte` component (which would create a `.svelte.ts` -> `.svelte` import
+ * cycle Vite's dev import-analysis fails to resolve).
+ */
+export type FormFieldType = 'text' | 'email' | 'tel' | 'textarea' | 'number' | 'password' | 'select' | 'checkbox' | 'switch' | 'date' | 'color' | 'rating' | 'array';
+export type FormField = {
+    name: string;
+    label: string;
+    type?: FormFieldType;
+    required?: boolean;
+    placeholder?: string;
+    options?: Array<{
+        value: string | number;
+        label: string;
+        color?: string;
+    }>;
+    /** Declarative validation rules (see `rules` - email/pattern/min/compare...). */
+    rules?: ReadonlyArray<Validator>;
+    /** Return an error message, or null/undefined when valid. */
+    validate?: (value: any, values: Record<string, any>) => string | null | undefined;
+    /**
+     * Async validator (e.g. "is this username taken?"). Runs after the sync checks
+     * pass, debounced (`asyncDebounce`, default 300ms) and stale-guarded so only the
+     * latest result wins. While it runs, `form.isValidating(name)` is true and the
+     * field shows a checking indicator. Submit waits for all async validators.
+     */
+    asyncValidate?: (value: any, values: Record<string, any>) => Promise<string | null | undefined>;
+    /** Debounce (ms) before `asyncValidate` runs on edit. Default 300. */
+    asyncDebounce?: number;
+    /** Span full width in the grid. */
+    full?: boolean;
+    /**
+     * Show the field only when this is `true` / returns `true` (default: always).
+     * A field derived from other values, e.g. `visible: (v) => v.hasAddress`.
+     * Hidden fields are skipped in validation and excluded from the submitted values.
+     */
+    visible?: boolean | ((values: Record<string, any>) => boolean);
+    /** Disable the field, statically or derived from other values. */
+    disabled?: boolean | ((values: Record<string, any>) => boolean);
+    /**
+     * For `type: 'array'` - the fields of each repeatable item. The value is an
+     * array of item objects; each item's fields validate against that item (so
+     * cross-field rules within a row work). `required`/`minItems`/`maxItems` gate
+     * the array length.
+     */
+    itemFields?: ReadonlyArray<FormField>;
+    /** Label for the "add item" button of an array field. Default "+ Add". */
+    addLabel?: string;
+    /** Min / max item count for an array field. */
+    minItems?: number;
+    maxItems?: number;
+};
+/**
+ * A group of fields rendered as a titled fieldset - and, when `<SvForm stepper>`
+ * is set, as one step of a wizard. Use in place of a plain `FormField` inside the
+ * `fields` array; the schema may freely mix flat fields and sections.
+ */
+export type FormSection = {
+    section: string;
+    description?: string;
+    fields: ReadonlyArray<FormField>;
+    /** Column count for this section's grid (defaults to the form's `columns`). */
+    columns?: number;
+};
+/** An entry in a form schema: either a single field or a titled section/step. */
+export type FormEntry = FormField | FormSection;
+/** Narrow a schema entry to a section (has a `fields` array). */
+export declare function isFormSection(e: FormEntry): e is FormSection;
+/** Flatten a mixed schema (fields + sections) to the flat list of fields. */
+export declare function flattenFields(entries: ReadonlyArray<FormEntry>): FormField[];

package/dist/form-field.js

@@ -0,0 +1,15 @@
+/** Narrow a schema entry to a section (has a `fields` array). */
+export function isFormSection(e) {
+    return Array.isArray(e.fields);
+}
+/** Flatten a mixed schema (fields + sections) to the flat list of fields. */
+export function flattenFields(entries) {
+    const out = [];
+    for (const e of entries) {
+        if (isFormSection(e))
+            out.push(...e.fields);
+        else
+            out.push(e);
+    }
+    return out;
+}

package/dist/index.d.ts

@@ -7,9 +7,12 @@ 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 type { SchedulerConfig, SchedulerDrawerConfig, SchedulerEventMoveEvent, SchedulerEventResizeEvent, SchedulerEventCommitEvent, SchedulerRangeSelection, SchedulerView, SchedulerResource, SchedulerCollisionMode, SchedulerException, SchedulerEditScope, SchedulerOccurrenceChangeEvent, } from './SvGrid.types';
+export { registerSchedulerView, getSchedulerView, hasSchedulerView } from './scheduler-view.svelte';
+export { resolveEvents, hasConflict, overlapCount, overlapsBands, workingIntervals, withinWorking, type WorkingWindow, eventsOnDay, layoutDayEvents, monthWeekSegments, agendaGroups, rangeForView, daysForView, navigateAnchor, timelineAxis, timelineGeom, timelineRows, type ResolvedEvent, type EventSpec, type RecurrenceException, type PositionedEvent, type OverflowMarker, type DayLayout, type LayoutOptions, type MonthSegment, type AgendaGroup, type TimelineTick, type TimelineMajor, type TimelineAxis, type TimelineRow, } from './scheduler-model';
 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 { matchesRecurrence, expandRecurrence, describeRecurrence, type RecurrenceRule, type RecurrenceFreq, type RecurrenceLabels, } from './recurrence';
 export { default as SvTimePicker, type TimeValue } from './SvTimePicker.svelte';
 export { default as SvDateTimePicker, type DateTimeValue } from './SvDateTimePicker.svelte';
 export { default as SvDateRangeInput, type DateRangeValue } from './SvDateRangeInput.svelte';
@@ -20,12 +23,22 @@ export { FOCUSABLE_SELECTOR, getFocusable, createFocusTrap, type FocusTrap, type
 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 { createOverlay, type Overlay, type OverlayConfig, type DialogProps } from './createOverlay.svelte';
+export { createTooltip, type Tooltip, type TooltipConfig, type TooltipAnchorProps, type TooltipProps } from './createTooltip.svelte';
+export { createPagination, type Pagination, type PaginationConfig } from './createPagination';
+export { createStepper, type Stepper, type StepperConfig, type StepStatus } from './createStepper';
+export { createCarousel, type Carousel, type CarouselConfig } from './createCarousel.svelte';
+export { createCommand, type Command, type CommandConfig } from './createCommand.svelte';
+export { createForm, type Form, type FormConfig } from './createForm.svelte';
 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';
+export { createPopoverSelect, type PopoverSelect, type PopoverSelectConfig } from './createPopoverSelect.svelte';
+export { createMenu, type Menu, type MenuConfig, type MenuItemProps } from './createMenu.svelte';
+export { enabledIndices, wrapMove } from './list-nav';
 export { createAutocomplete, type Autocomplete, type AutocompleteConfig } from './createAutocomplete.svelte';
 export { createTagsInput, type TagsInput, type TagsInputConfig } from './createTagsInput.svelte';
 export { createCountryInput, type CountryInput, type CountryInputConfig } from './createCountryInput.svelte';
@@ -89,6 +102,10 @@ export { default as SvAccordion, type AccordionItem, type AccordionExpandMode }
 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 SvDockLayout } from './SvDockLayout.svelte';
+export { default as SvDockManager, type DockManagerApi, type DockEvent } from './SvDockManager.svelte';
+export { dockPane, dockTabs, dockGroup, removePane, movePane, dockInto, reorderPane, removeLeaf, dockLeafToEdge, setActive as dockSetActive, setSizes as dockSetSizes, normalize as dockNormalize, findTabsWithPane, allPaneIds, type DockNode, type DockGroup, type DockTabs, type DockPane, type DockZone, } from './dock-model';
+export { floatPane, dockPaneOnto, dockWindowOnto, dockPaneToEmptyMain, reorderTab, autoHideLeaf, autoHidePaneToSide, pinAutoHidden, setAutoHideSize, closePane as dockManagerClosePane, moveWindow, resizeWindow, bringToFront, setWindowMinimized, toggleWindowMaximized, closeWindow, autoHideWindow, toggleMaximizeLeaf, findLeafById, addPaneToMain, resizeGroup as dockManagerResizeGroup, setManagerActive, locatePane, surfaceOfTabs, allManagerPaneIds, allManagerIds, dedupeManagerNodeIds, type DockManagerState, type FloatWindow, type AutoHideEntry, type DockSide, type PaneLocation, } from './dock-manager-model';
 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';
@@ -123,15 +140,18 @@ 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 SvMenuList } from './SvMenuList.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 { default as SvForm, type FormField, type FormFieldType, type FormSection, type FormEntry } 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 { toDate, startOfDay, startOfWeek, startOfMonth, addDays, addMonths, addYears, clampDate, isSameDay, monthMatrix, weekdayOrder, isoWeek, decadeRange, withTime, snapMinute, type DateLike, } from './datetime/date-core';
 export { formatDate, parseDate, tokenizeMask } from './datetime/date-format';
+export { toICS, fromICS, ruleToRRule, rruleToRule, type ICalEvent } from './scheduler-ical';
+export { zoneParts, zoneOffsetMs, toZonedLocal, fromZonedLocal, instantFromWallClock, zoneAbbr, normalizeTimeZone, type ZoneParts, } from './datetime/timezone';
 export { selectDate, rangeDays, isSelected, isMultiSelectMode, emptySelection, type SelectionMode, type SelectionState, } from './datetime/date-selection';
 export { isDisabledDay, isOutOfRange, isRestricted, isImportant, type RestrictOptions, } from './datetime/date-restrict';
 export { default as FlexRender } from './FlexRender.svelte';
@@ -154,7 +174,7 @@ export { createServerGroupModel, serverGroupRows, serverGroupNav, type ServerGro
 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 { resolveCellFormat, computeColumnStat, lerpColor, rgba, contrastText, formatNeedsStats, formatsNeedingStats, type ConditionalFormat, type ConditionalFormatSpec, type ColorScaleFormat, type ColorScaleStop, type ScaleBounds, type DataBarFormat, type IconSetFormat, type RuleFormat, type ResolvedCellFormat, } from './conditional-formatting';
 export { getKeyboardIntent, getNextActiveCell, type GridKeyboardIntent } from './keyboard';
 export { createVirtualizer } from './virtualization/virtualizer';
 export { createSvelteVirtualizer } from './virtualization/svelte-virtualizer.svelte';
@@ -162,7 +182,7 @@ export { createColumnVirtualizer } from './virtualization/column-virtualizer';
 export type { VirtualItem, VirtualizerOptions, VirtualizerState } from './virtualization/types';
 export type { SvGridApi, SvGridFilterOperator, SvGridWrapperProps } from './svgrid-wrapper.types';
 export { parseEditorValue, normalizeEditorOptions, type CellEditorType, type CellEditorOption, } from './editors/cell-editors';
-export { applyExcelFilter, normalizeForFilter, type ExcelFilter, type ExcelFilterOperator, type ExcelFilterOptions, } from './filtering/excel-filters';
+export { applyExcelFilter, normalizeForFilter, splitInTokens, joinInTokens, type ExcelFilter, type ExcelFilterOperator, type ExcelFilterOptions, } from './filtering/excel-filters';
 export { getGridCellDomId, getGridCellA11yProps, getGridHeaderA11yProps, getGridRootA11yProps, getGridRowA11yProps, type GridCellA11yInput, type GridColumnA11yInput, type GridSortDirection, } from './a11y';
 /**
  * Compatibility alias for teams migrating from `createTable`.

package/dist/index.js

@@ -6,9 +6,13 @@ 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 { registerSchedulerView, getSchedulerView, hasSchedulerView } from './scheduler-view.svelte';
+// Pure scheduler layout/model helpers (framework-free, like recurrence/date-core).
+// The calendar RENDERER that consumes these ships in @svgrid/enterprise.
+export { resolveEvents, hasConflict, overlapCount, overlapsBands, workingIntervals, withinWorking, eventsOnDay, layoutDayEvents, monthWeekSegments, agendaGroups, rangeForView, daysForView, navigateAnchor, timelineAxis, timelineGeom, timelineRows, } from './scheduler-model';
 export { default as SvGridDropdown } from './SvGridDropdown.svelte';
 export { default as SvCalendar } from './SvCalendar.svelte';
-export { matchesRecurrence, expandRecurrence } from './recurrence';
+export { matchesRecurrence, expandRecurrence, describeRecurrence, } from './recurrence';
 export { default as SvTimePicker } from './SvTimePicker.svelte';
 export { default as SvDateTimePicker } from './SvDateTimePicker.svelte';
 export { default as SvDateRangeInput } from './SvDateRangeInput.svelte';
@@ -20,6 +24,23 @@ export { FOCUSABLE_SELECTOR, getFocusable, createFocusTrap, } from './a11y/focus
 export { lockScroll, scrollLockDepth } from './a11y/scroll-lock';
 export { createDismissableLayer, dismissableDepth, } from './a11y/dismissable';
 export { announce } from './a11y/live-region';
+// Dialog-overlay core (SvModal / SvDrawer): open -> focus-trap + scroll-lock +
+// Escape/backdrop dismissal -> restore, on the primitives above.
+export { createOverlay } from './createOverlay.svelte';
+// Tooltip core (SvTooltip): hover/focus open with a show delay, Escape-to-hide,
+// and aria-describedby / role=tooltip wiring. (Toasts are already headless: see
+// the toastStore / toast() exports below.)
+export { createTooltip } from './createTooltip.svelte';
+// Navigation cores: pager (SvPagination), wizard steps (SvStepper), slideshow
+// (SvCarousel). Pagination + stepper are pure/rune-free; carousel owns autoplay.
+export { createPagination } from './createPagination';
+export { createStepper } from './createStepper';
+export { createCarousel } from './createCarousel.svelte';
+// Command palette core (SvCommand): fuzzy filter + roving + hotkey. Pair with
+// createOverlay for the focus-trap/scroll-lock/dismissal lifecycle.
+export { createCommand } from './createCommand.svelte';
+// Schema-driven form core (SvForm): values/errors/touched + validation + submit.
+export { createForm } from './createForm.svelte';
 // 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';
@@ -30,6 +51,14 @@ export { createListbox, toSelectedArray, } from './createListbox.svelte';
 // Selection family cores
 export { createCombobox } from './createCombobox.svelte';
 export { createDropdownList } from './createDropdownList.svelte';
+// Shared engine behind the anchored-panel selects (SvMultiSelect / SvTreeSelect /
+// SvGridSelect): open/close, positioning, dismissal, roving active index, ARIA.
+export { createPopoverSelect } from './createPopoverSelect.svelte';
+// Menu family core (SvMenu / SvMenuList / SvContextMenu): roving focus, submenus,
+// keyboard. `MenuItem` also re-exported from SvMenuList for back-compat.
+export { createMenu } from './createMenu.svelte';
+// Pure roving-focus navigation math shared by the cores above.
+export { enabledIndices, wrapMove } from './list-nav';
 export { createAutocomplete } from './createAutocomplete.svelte';
 export { createTagsInput } from './createTagsInput.svelte';
 export { createCountryInput } from './createCountryInput.svelte';
@@ -102,6 +131,10 @@ 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 SvDockLayout } from './SvDockLayout.svelte';
+export { default as SvDockManager } from './SvDockManager.svelte';
+export { dockPane, dockTabs, dockGroup, removePane, movePane, dockInto, reorderPane, removeLeaf, dockLeafToEdge, setActive as dockSetActive, setSizes as dockSetSizes, normalize as dockNormalize, findTabsWithPane, allPaneIds, } from './dock-model';
+export { floatPane, dockPaneOnto, dockWindowOnto, dockPaneToEmptyMain, reorderTab, autoHideLeaf, autoHidePaneToSide, pinAutoHidden, setAutoHideSize, closePane as dockManagerClosePane, moveWindow, resizeWindow, bringToFront, setWindowMinimized, toggleWindowMaximized, closeWindow, autoHideWindow, toggleMaximizeLeaf, findLeafById, addPaneToMain, resizeGroup as dockManagerResizeGroup, setManagerActive, locatePane, surfaceOfTabs, allManagerPaneIds, allManagerIds, dedupeManagerNodeIds, } from './dock-manager-model';
 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
@@ -136,6 +169,7 @@ 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 SvMenuList } from './SvMenuList.svelte';
 export { default as SvNavPane } from './SvNavPane.svelte';
 export { default as SvProgress } from './SvProgress.svelte';
 export { default as SvCircularProgress } from './SvCircularProgress.svelte';
@@ -143,8 +177,10 @@ 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 { toDate, startOfDay, startOfWeek, startOfMonth, addDays, addMonths, addYears, clampDate, isSameDay, monthMatrix, weekdayOrder, isoWeek, decadeRange, withTime, snapMinute, } from './datetime/date-core';
 export { formatDate, parseDate, tokenizeMask } from './datetime/date-format';
+export { toICS, fromICS, ruleToRRule, rruleToRule } from './scheduler-ical';
+export { zoneParts, zoneOffsetMs, toZonedLocal, fromZonedLocal, instantFromWallClock, zoneAbbr, normalizeTimeZone, } from './datetime/timezone';
 export { selectDate, rangeDays, isSelected, isMultiSelectMode, emptySelection, } from './datetime/date-selection';
 export { isDisabledDay, isOutOfRange, isRestricted, isImportant, } from './datetime/date-restrict';
 export { default as FlexRender } from './FlexRender.svelte';
@@ -166,13 +202,13 @@ export { createServerGroupModel, serverGroupRows, serverGroupNav, } from './serv
 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 { resolveCellFormat, computeColumnStat, lerpColor, rgba, contrastText, formatNeedsStats, formatsNeedingStats, } from './conditional-formatting';
 export { getKeyboardIntent, getNextActiveCell } from './keyboard';
 export { createVirtualizer } from './virtualization/virtualizer';
 export { createSvelteVirtualizer } from './virtualization/svelte-virtualizer.svelte';
 export { createColumnVirtualizer } from './virtualization/column-virtualizer';
 export { parseEditorValue, normalizeEditorOptions, } from './editors/cell-editors';
-export { applyExcelFilter, normalizeForFilter, } from './filtering/excel-filters';
+export { applyExcelFilter, normalizeForFilter, splitInTokens, joinInTokens, } from './filtering/excel-filters';
 export { getGridCellDomId, getGridCellA11yProps, getGridHeaderA11yProps, getGridRootA11yProps, getGridRowA11yProps, } from './a11y';
 /**
  * Compatibility alias for teams migrating from `createTable`.

package/dist/list-nav.d.ts

@@ -0,0 +1,18 @@
+/**
+ * list-nav - the pure, framework-free navigation math shared by the roving-focus
+ * cores (createListbox, createPopoverSelect, createMenu). No runes, no DOM - just
+ * index arithmetic, so it is unit-testable on its own and behaves identically
+ * everywhere. The cores wrap these in `$state`.
+ */
+/** Indices of items that can take roving focus / selection - i.e. the ones the
+ *  caller does not mark disabled. `count` is the total item count; `isDisabled`
+ *  is consulted per index (a separator counts as disabled to the caller). */
+export declare function enabledIndices(count: number, isDisabled?: (index: number) => boolean): number[];
+/**
+ * The next index when moving `delta` steps through `list`, wrapping around the
+ * ends. `current` need not be in `list` (it may sit on a disabled item): when it
+ * is absent we start just before the head so `delta: 1` lands on the first entry
+ * and `delta: -1` on the last-but-one - the same behaviour every existing core
+ * already had. Returns `-1` for an empty list.
+ */
+export declare function wrapMove(list: readonly number[], current: number, delta: number): number;

package/dist/list-nav.js

@@ -0,0 +1,30 @@
+/**
+ * list-nav - the pure, framework-free navigation math shared by the roving-focus
+ * cores (createListbox, createPopoverSelect, createMenu). No runes, no DOM - just
+ * index arithmetic, so it is unit-testable on its own and behaves identically
+ * everywhere. The cores wrap these in `$state`.
+ */
+/** Indices of items that can take roving focus / selection - i.e. the ones the
+ *  caller does not mark disabled. `count` is the total item count; `isDisabled`
+ *  is consulted per index (a separator counts as disabled to the caller). */
+export function enabledIndices(count, isDisabled) {
+    const out = [];
+    for (let i = 0; i < count; i++)
+        if (!isDisabled?.(i))
+            out.push(i);
+    return out;
+}
+/**
+ * The next index when moving `delta` steps through `list`, wrapping around the
+ * ends. `current` need not be in `list` (it may sit on a disabled item): when it
+ * is absent we start just before the head so `delta: 1` lands on the first entry
+ * and `delta: -1` on the last-but-one - the same behaviour every existing core
+ * already had. Returns `-1` for an empty list.
+ */
+export function wrapMove(list, current, delta) {
+    const len = list.length;
+    if (len === 0)
+        return -1;
+    const pos = list.indexOf(current);
+    return list[(pos + delta + len) % len];
+}

package/dist/list-option.d.ts

@@ -5,6 +5,8 @@ export type ListOption = {
     disabled?: boolean;
     /** Optional group heading this option belongs under. */
     group?: string;
+    /** Optional color swatch (any CSS color) shown before the label. */
+    color?: string;
 };
 /** Case-insensitive substring filter over option labels. */
 export declare function filterOptions(options: ReadonlyArray<ListOption>, query: string): ListOption[];

package/dist/menu-item.d.ts

@@ -0,0 +1,20 @@
+import type { Snippet } from 'svelte';
+/**
+ * A single item in a menu (SvMenu / SvMenuList / SvContextMenu) and the headless
+ * `createMenu` core. Kept in a plain `.ts` module so the core can import the type
+ * without pulling in the `.svelte` component - which would create a
+ * `.svelte.ts` -> `.svelte` -> `.svelte.ts` import cycle that Vite's dev-time
+ * import-analysis fails to resolve.
+ */
+export type MenuItem = {
+    /** Item text. Omit + set `separator` for a divider. */
+    label?: string;
+    separator?: boolean;
+    icon?: Snippet;
+    /** Right-aligned hint, e.g. a keyboard shortcut. */
+    shortcut?: string;
+    disabled?: boolean;
+    /** Nested submenu items (renders a flyout). */
+    children?: MenuItem[];
+    onSelect?: () => void;
+};

package/dist/menu-item.js

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

package/dist/menus.d.ts

@@ -6,9 +6,14 @@ export declare function createMenus<TFeatures extends TableFeatures = TableFeatu
     updateFilterOperator: (columnId: string, operator: FilterOperator) => void;
     updateFilterMenuValue: (columnId: string, value: string) => void;
     updateFilterMenuValueTo: (columnId: string, valueTo: string) => void;
+    addFilterToken: (columnId: string, token: string) => void;
+    removeFilterToken: (columnId: string, token: string) => void;
+    toggleFilterToken: (columnId: string, token: string) => void;
     toggleCheckboxWithKeyboard: (event: KeyboardEvent, toggle: () => void) => void;
     isColumnFiltered: (columnId: string) => boolean;
     closeMenus: () => void;
+    openInSuggest: (anchor: HTMLElement, columnId: string) => void;
+    closeInSuggest: () => void;
     openChooseColumns: (event: MouseEvent) => void;
     openColumnMenu: (event: MouseEvent, columnId: string) => void;
     openFilterMenu: (event: MouseEvent, columnId: string) => void;

package/dist/menus.js

@@ -1,5 +1,7 @@
 import "./sv-grid-scrollbar";
+import { untrack } from "svelte";
 import { clampMenuX, cssEscape, } from "./SvGrid.helpers";
+import { splitInTokens, joinInTokens } from "./filtering/excel-filters";
 export function createMenus(ctx) {
     function updateFilterRow(columnId, value) {
         ctx.filterRowValues = { ...ctx.filterRowValues, [columnId]: value };
@@ -46,6 +48,31 @@ export function createMenus(ctx) {
             [columnId]: { ...current, valueTo },
         };
     }
+    /** Current `in` / `notIn` token list for a column (from the filter-row value). */
+    function filterTokens(columnId) {
+        return splitInTokens(ctx.filterRowValues[columnId] ?? "");
+    }
+    /** Add a value to a column's `in` / `notIn` list (no-op if already present). */
+    function addFilterToken(columnId, token) {
+        const t = token.trim();
+        if (!t)
+            return;
+        const tokens = filterTokens(columnId);
+        if (!tokens.includes(t))
+            tokens.push(t);
+        updateFilterRow(columnId, joinInTokens(tokens));
+    }
+    /** Remove a value from a column's `in` / `notIn` list. */
+    function removeFilterToken(columnId, token) {
+        updateFilterRow(columnId, joinInTokens(filterTokens(columnId).filter((t) => t !== token)));
+    }
+    /** Toggle a value in a column's `in` / `notIn` list (checklist behaviour). */
+    function toggleFilterToken(columnId, token) {
+        if (filterTokens(columnId).includes(token))
+            removeFilterToken(columnId, token);
+        else
+            addFilterToken(columnId, token);
+    }
     function toggleCheckboxWithKeyboard(event, toggle) {
         if (event.key !== "Enter" && event.key !== " ")
             return;
@@ -57,14 +84,28 @@ export function createMenus(ctx) {
             return true;
         const menuFilter = ctx.filterMenuValues[columnId];
         return Boolean(menuFilter &&
-            (menuFilter.operator === "isBlank" || menuFilter.value.trim()));
+            (menuFilter.operator === "isBlank" ||
+                menuFilter.operator === "isNotBlank" ||
+                menuFilter.value.trim()));
     }
     function closeMenus() {
         ctx.columnMenuFor = null;
         ctx.filterMenuFor = null;
         ctx.operatorMenuFor = null;
+        ctx.inSuggestFor = null;
         ctx.chooseColumnsPos = null;
     }
+    /** Open the `in` / `notIn` value-suggestions dropdown under a chip input. */
+    function openInSuggest(anchor, columnId) {
+        const rect = anchor.getBoundingClientRect();
+        ctx.inSuggestPos = { x: clampMenuX(rect.left, 220), y: rect.bottom + 4 };
+        ctx.inSuggestQuery = "";
+        ctx.inSuggestFor = columnId;
+    }
+    function closeInSuggest() {
+        ctx.inSuggestFor = null;
+        ctx.inSuggestQuery = "";
+    }
     function openChooseColumns(event) {
         event.stopPropagation();
         // Submenu behavior: keep the parent operations menu open and float the
@@ -200,21 +241,27 @@ export function createMenus(ctx) {
         }
     }
     function clearColumnFilter(columnId) {
-        if (ctx.valueFilters[columnId]) {
-            const next = { ...ctx.valueFilters };
-            delete next[columnId];
-            ctx.valueFilters = next;
-        }
-        if (ctx.filterMenuValues[columnId]) {
-            const next = { ...ctx.filterMenuValues };
-            delete next[columnId];
-            ctx.filterMenuValues = next;
-        }
-        if (ctx.filterRowValues[columnId]) {
-            const next = { ...ctx.filterRowValues };
-            delete next[columnId];
-            ctx.filterRowValues = next;
-        }
+        // `untrack`: read-modify-write on the filter maps. Keeps the method safe to
+        // call from a consumer's reactive `$effect` (e.g. via `api.clearFilter`)
+        // without capturing these reads as a dependency and looping. See
+        // `build-api`'s `setFilter` for the full rationale.
+        untrack(() => {
+            if (ctx.valueFilters[columnId]) {
+                const next = { ...ctx.valueFilters };
+                delete next[columnId];
+                ctx.valueFilters = next;
+            }
+            if (ctx.filterMenuValues[columnId]) {
+                const next = { ...ctx.filterMenuValues };
+                delete next[columnId];
+                ctx.filterMenuValues = next;
+            }
+            if (ctx.filterRowValues[columnId]) {
+                const next = { ...ctx.filterRowValues };
+                delete next[columnId];
+                ctx.filterRowValues = next;
+            }
+        });
     }
     // External pagination is controlled: emit the requested page/size and let
     // the consumer fetch + update props. Never mutate local pagination state.
@@ -385,9 +432,14 @@ export function createMenus(ctx) {
         updateFilterOperator,
         updateFilterMenuValue,
         updateFilterMenuValueTo,
+        addFilterToken,
+        removeFilterToken,
+        toggleFilterToken,
         toggleCheckboxWithKeyboard,
         isColumnFiltered,
         closeMenus,
+        openInSuggest,
+        closeInSuggest,
         openChooseColumns,
         openColumnMenu,
         openFilterMenu,

package/dist/panel-resize.d.ts

@@ -0,0 +1,25 @@
+/**
+ * panel-resize - the drag math behind a dropdown panel's bottom resize grip
+ * (the "····" handle). Rune-free and DOM-only so every popover select can reuse
+ * it: on the grip's `pointerdown` it tracks the pointer and reports a clamped
+ * height as it moves, releasing its listeners on `pointerup`.
+ *
+ * The grip is only meaningful when the panel opens DOWNWARD (it grows toward the
+ * bottom of the screen); components hide it on an upward flip, where there is no
+ * room below to grow into.
+ */
+export type PanelResizeOptions = {
+    /** Panel height (px) at the moment the drag starts. */
+    startHeight: number;
+    /** Smallest height the panel may shrink to. Default 80. */
+    min?: number;
+    /** Largest height the panel may grow to - the live viewport ceiling. */
+    max: () => number;
+    /** Called with the new clamped height on each pointer move. */
+    onHeight: (height: number) => void;
+};
+/**
+ * Begin a vertical resize from a grip `pointerdown`. Returns nothing; the drag
+ * ends itself on `pointerup`. Safe to call from an `onpointerdown` handler.
+ */
+export declare function startPanelResize(event: PointerEvent, opts: PanelResizeOptions): void;