@assure-one/design-system 1.47.1 → 1.48.0

package/dist/legacy/index.d.ts

@@ -1,15 +1,16 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import { ReactNode } from 'react';
-import { B as BadgeProps, S as SelectSize, F as FileKind, a as ServiceTone } from '../data-table-view-D9a1_IRF.js';
-export { A as Assignee, D as Dash, M as MoneyCell, b as StagePill, T as TagsCell } from '../data-table-view-D9a1_IRF.js';
+import { B as BadgeProps, S as SelectSize, F as FileKind, a as ServiceTone } from '../data-table-view-CNTfzEyS.js';
+export { A as Assignee, D as Dash, M as MoneyCell, b as StagePill, T as TagsCell } from '../data-table-view-CNTfzEyS.js';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import '../vocab-DornLJbW.js';
 import '../system-DfJIVBlJ.js';
 import '@radix-ui/react-select';
-import '../types-BTHIs2nk.js';
+import '../types-CKpkEBvW.js';
 import '../brand-theme-ZYM867Jz.js';
+import '../option-izy_4w4Z.js';
 
 /**
  * Blockquote — semantic quote with optional attribution. Uses `font-display`

package/dist/legacy/index.js

@@ -1,6 +1,6 @@
 "use client";
-export { AIReceiptPanel, AiDraftCard, Assignee, AttentionItem, Blockquote, BottomNav, CategoryDivider, CategoryTag, ChannelTabs, ClientRailGroupHeader, ClientRailItem, Dash, DashGrid, DocumentChecklist, DocumentFileCard, DocumentFileLine, DocumentFileRow, DocumentRequestCard, DocumentRequestDetail, DocumentRequestField, DocumentRequestUpload, DocumentSourceFilter, DocumentSourceTag, DocumentsWorkspaceLayout, EmailMessageCard, EngagementCard, EngagementTimeline, EngagementTimelineStep, IntentBadge, MissingDocumentsPanel, MoneyCell, NewMenu, Section, SectionHead, SectionHeader, SignatureEditor, StagePill, Stat, StatusPill, SuggestionPills, TagsCell, TeamMemberSelect, TimeLogger, TimeLoggerActions, TimeLoggerBillable, TimeLoggerContextRow, TimeLoggerEntry, TimeLoggerEntryList, TimeLoggerField, TimeLoggerFooter, TimeLoggerHeader, TimeLoggerNotes, TimeLoggerTimer, formatClock, formatCurrency, formatDuration, parseDuration, useStopwatch } from '../chunk-FIRPQWYR.js';
-import '../chunk-IIBDSTOG.js';
+export { AIReceiptPanel, AiDraftCard, Assignee, AttentionItem, Blockquote, BottomNav, CategoryDivider, CategoryTag, ChannelTabs, ClientRailGroupHeader, ClientRailItem, Dash, DashGrid, DocumentChecklist, DocumentFileCard, DocumentFileLine, DocumentFileRow, DocumentRequestCard, DocumentRequestDetail, DocumentRequestField, DocumentRequestUpload, DocumentSourceFilter, DocumentSourceTag, DocumentsWorkspaceLayout, EmailMessageCard, EngagementCard, EngagementTimeline, EngagementTimelineStep, IntentBadge, MissingDocumentsPanel, MoneyCell, NewMenu, Section, SectionHead, SectionHeader, SignatureEditor, StagePill, Stat, StatusPill, SuggestionPills, TagsCell, TeamMemberSelect, TimeLogger, TimeLoggerActions, TimeLoggerBillable, TimeLoggerContextRow, TimeLoggerEntry, TimeLoggerEntryList, TimeLoggerField, TimeLoggerFooter, TimeLoggerHeader, TimeLoggerNotes, TimeLoggerTimer, formatClock, formatCurrency, formatDuration, parseDuration, useStopwatch } from '../chunk-YRFLK7ER.js';
+import '../chunk-HV24JSRN.js';
 import '../chunk-ARCWF2S3.js';
 import '../chunk-YRHRVOLV.js';
 //# sourceMappingURL=index.js.map

package/dist/next/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { D as DesignSystemProviderProps } from '../design-system-provider-C6Tu1vyg.js';
+import { D as DesignSystemProviderProps } from '../design-system-provider-YblRtwYw.js';
 import 'react';
-import '../types-BTHIs2nk.js';
+import '../types-CKpkEBvW.js';
 
 /**
  * Props of `NextDesignSystemProvider`: everything `DesignSystemProvider`

package/dist/option-izy_4w4Z.d.ts

@@ -0,0 +1,64 @@
+import { ReactNode } from 'react';
+
+/**
+ * L1a behaviour primitive (private). Not exported from the package.
+ *
+ * The canonical option model of every list-shaped control (W4-09; target
+ * architecture §32): `Select`, the coming `Combobox` (W4-10) and its
+ * `MultiSelect` preset (W4-11), the `SearchSelect` adapter (W4-12) and the
+ * `PeoplePicker` pattern all read one shape, in place of the six that ship
+ * today (`{value,label}`, `{id,label,group…}`, `{id,label,email}`,
+ * `{id,fullName}`, `{key,label,dot}`, `string[]`).
+ *
+ * Two halves:
+ *
+ * - {@link Option} and its accessors: what a row *is*. Consumers with domain
+ *   objects pass {@link OptionAccessors} (`getOptionValue`/`getOptionLabel`)
+ *   instead of remapping, and {@link toOptions} normalises everything — a
+ *   `string[]`, domain objects, `Option`s — into one array the list renders.
+ * - The selection helpers: what a control's *value* is, discriminated by
+ *   `multiple` (single `TValue | null`, multi `TValue[]`; §32 "Value"). `""`
+ *   keeps meaning empty in 2.x (§32 "Compat"), so {@link normalizeSingleValue}
+ *   folds it to `null` at the boundary.
+ *
+ * No React, no client directive, no DOM: plain functions over plain data, so
+ * the same module serves a Server Component, a test and the keyboard helper.
+ */
+/**
+ * One row of a list-shaped control.
+ *
+ * `value` is never `""`: emptiness is `value === null` on the control, not a
+ * sentinel row (§32). `label` is the string typeahead, filtering and the
+ * accessible name read; `description` and `icon` are rendered, never searched.
+ * `keywords` widen the match without showing. `meta` carries consumer data
+ * through to `renderOption` / `onValueChange` details untouched.
+ *
+ * @experimental
+ */
+interface Option<TValue extends string = string, TMeta = unknown> {
+    value: TValue;
+    label: string;
+    description?: ReactNode;
+    /** Leading visual: icon, avatar, flag, colour swatch. */
+    icon?: ReactNode;
+    disabled?: boolean;
+    group?: string | undefined;
+    keywords?: readonly string[] | undefined;
+    meta?: TMeta;
+}
+/**
+ * How a list reads a consumer's own item type. Only `getOptionValue` and
+ * `getOptionLabel` are required: an item with no `disabled`/`group`/`keywords`
+ * accessor is enabled, ungrouped and matched on its label alone.
+ *
+ * @experimental
+ */
+interface OptionAccessors<TItem, TValue extends string = string> {
+    getOptionValue: (item: TItem) => TValue;
+    getOptionLabel: (item: TItem) => string;
+    getOptionDisabled?: ((item: TItem) => boolean) | undefined;
+    getOptionGroup?: ((item: TItem) => string | undefined) | undefined;
+    getOptionKeywords?: ((item: TItem) => readonly string[] | undefined) | undefined;
+}
+
+export type { Option as O, OptionAccessors as a };