@assure-one/design-system 1.35.0 → 1.36.0

package/dist/design-system-provider-cPUklDJv.d.ts

@@ -0,0 +1,220 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ComponentType, AnchorHTMLAttributes, Ref, ReactNode, ImgHTMLAttributes } from 'react';
+
+/**
+ * L0 foundation (W5-20, ADR-010). The typed messages catalogue every
+ * design-system component reads its generic strings from (target architecture
+ * §38): accessibility and micro-copy with a universal meaning — Clear, No
+ * results, Loading, optional — never product copy, which is always the
+ * consumer's (`children`, `label`, `placeholder`).
+ *
+ * The catalogue is keyed by component namespace; each namespace is the
+ * `*Messages` interface that component already accepted through its
+ * `messages` prop before the provider existed, so the resolution order is one
+ * rule everywhere: **prop > provider > English default**. A value is a string
+ * or, where a parameter is involved, a function of that parameter (no string
+ * concatenation or pluralisation inside components).
+ *
+ * The English defaults live in `./en.ts`; `./en.json` is generated from it
+ * (`pnpm messages:generate`) so translators start from the full list.
+ */
+/** The copy a `Select` renders. @experimental */
+interface SelectMessages {
+    /** The accessible name of the `clearable` button. Default `"Clear selection"`. */
+    clear: string;
+}
+/** The copy a `SearchInput` renders. @experimental */
+interface SearchInputMessages {
+    /** The accessible name of the clear button. Default `"Clear search"`. */
+    clear: string;
+}
+/** The copy a `Combobox` (and `MultiSelect`) renders. @experimental */
+interface ComboboxMessages {
+    /** The empty state when the query matches nothing. */
+    empty: string;
+    /** The loading state while `loading`. */
+    loading: string;
+    /** The label of the create row for a query. */
+    create: (query: string) => string;
+    /** The accessible name of the clear button. */
+    clear: string;
+    /** The accessible name of the toggle button. */
+    toggle: string;
+    /** The accessible name of a chip's remove button (`multiple`). */
+    remove: (label: string) => string;
+}
+/**
+ * The copy a `Field` renders (target architecture §24.5).
+ *
+ * @experimental
+ */
+interface FieldMessages {
+    /** The indicator after the label of an optional field. Default `"optional"`, rendered in parentheses. */
+    optional: string;
+}
+/** The default dropzone copy a `FileUpload` renders when it has no `children`. @experimental */
+interface FileUploadMessages {
+    /** The emphasised call to action. Default `"Click to upload"`. */
+    prompt: string;
+    /** The rest of the sentence after the prompt. Default `" or drag and drop"`. */
+    dragHint: string;
+    /** The accepted-types line; receives the `accept` list. */
+    accepted: (accept: string) => string;
+    /** The size-limit line; receives the formatted limit (e.g. `"10 MB"`). */
+    maxSize: (size: string) => string;
+}
+/**
+ * The whole catalogue, one namespace per component. This is the type a
+ * consumer's i18n lint can check for completeness.
+ *
+ * @experimental
+ */
+interface DsMessages {
+    select: SelectMessages;
+    searchInput: SearchInputMessages;
+    combobox: ComboboxMessages;
+    field: FieldMessages;
+    fileUpload: FileUploadMessages;
+}
+/** A component namespace of the catalogue. @experimental */
+type DsMessageNamespace = keyof DsMessages;
+/**
+ * What `DesignSystemProvider messages` accepts: any subset of namespaces, each
+ * any subset of its keys. Every omitted key keeps its English default.
+ *
+ * @experimental
+ */
+type DsMessagesOverride = {
+    [N in DsMessageNamespace]?: Partial<DsMessages[N]>;
+};
+
+/**
+ * L0 foundation (W5-21, ADR-010). The adapters through which the design
+ * system renders an application's router link and image component without
+ * importing them itself.
+ *
+ * `LinkButton` and `Logo` read these from `DesignSystemProvider`. Without a
+ * provider they keep their static `next/link` / `next/image` imports (C-NEXT-PEER)
+ * until 2.0, so nothing changes for a Next.js app that renders no provider;
+ * `@assure-one/design-system/next` exports a provider that passes exactly
+ * those two, and a non-Next app passes its own.
+ */
+/** The props a link adapter receives: a plain anchor with an `href`. @experimental */
+interface LinkComponentProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
+    href: string;
+    ref?: Ref<HTMLAnchorElement>;
+    children?: ReactNode;
+}
+/**
+ * A component that renders a link — `next/link`, React Router's `Link`, or a
+ * plain `<a>`. It must forward every anchor attribute and the ref.
+ *
+ * @experimental
+ */
+type LinkComponent = ComponentType<LinkComponentProps>;
+/** The props an image adapter receives: `src`, `alt` and the intrinsic size. @experimental */
+interface ImageComponentProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, "src" | "width" | "height"> {
+    src: string;
+    alt: string;
+    width: number;
+    height: number;
+    /** Load eagerly, above the fold (`next/image` `priority`). */
+    priority?: boolean;
+}
+/**
+ * A component that renders an image — `next/image` or a plain `<img>`.
+ *
+ * @experimental
+ */
+type ImageComponent = ComponentType<ImageComponentProps>;
+
+/** Text direction the provider announces. Context only until components adopt logical properties (W5-22). @experimental */
+type DsDirection = "ltr" | "rtl";
+/**
+ * The resolved messages of one component namespace: the component's own
+ * `messages` prop wins over the provider's catalogue, which wins over the
+ * English default. Works without a provider (English). Stable while the three
+ * inputs are.
+ *
+ * @experimental
+ */
+declare function useDsMessages<N extends DsMessageNamespace>(namespace: N, override?: Partial<DsMessages[N]> | undefined): DsMessages[N];
+
+/**
+ * Props of `DesignSystemProvider` (W5-20, ADR-010, target architecture §43).
+ *
+ * @experimental
+ */
+interface DesignSystemProviderProps {
+    /**
+     * Overrides for the generic strings components render (Clear, No results,
+     * optional…), by component namespace. Any subset; omitted keys keep their
+     * English default. A component's own `messages` prop still wins. The full
+     * list is `DsMessages` (and `messages/en.json` in the package source).
+     */
+    messages?: DsMessagesOverride;
+    /**
+     * The BCP 47 tag locale-aware components format with (dates, numbers).
+     * Default `"en-US"` on the server and on the client (amendment A3): pass the
+     * locale your app already knows server-side; never `navigator.language`
+     * during render.
+     */
+    locale?: string;
+    /** Text direction. Context only for now — components adopt logical properties in W5-22. */
+    dir?: DsDirection;
+    /**
+     * Where portalled content (dialogs, menus, tooltips) mounts. `undefined`
+     * (default) keeps Radix's `document.body`. Read by the shared Portal of the
+     * overlay primitives as they adopt it.
+     */
+    portalContainer?: HTMLElement | null;
+    /**
+     * The application's router link, rendered by `LinkButton` and `Logo`
+     * instead of their static `next/link` import (W5-21). A Next.js app uses
+     * `NextDesignSystemProvider` from `@assure-one/design-system/next`.
+     */
+    linkComponent?: LinkComponent;
+    /** The application's image component, rendered by `Logo` instead of its static `next/image` import. */
+    imageComponent?: ImageComponent;
+    /**
+     * Shared tooltip defaults (`delayDuration`, `skipDelayDuration`,
+     * `disableHoverableContent`) for tooltips built directly on the Radix
+     * root. `false` mounts no `TooltipProvider`. The design system's own
+     * `Tooltip` still wraps its own provider today, so it is unaffected.
+     */
+    tooltip?: TooltipDefaults | false;
+    /**
+     * Mount the toast region (`ToastProvider`) so `useToast()` works anywhere
+     * below. Off by default: an app that already renders `ToastProvider` keeps
+     * its single region (the `aria-label="Notifications"` region consumers
+     * select on, C-TOAST-ARIALABEL, must exist exactly once).
+     */
+    toasts?: boolean;
+    children?: ReactNode;
+}
+/** The Radix `TooltipProvider` props the provider forwards. @experimental */
+interface TooltipDefaults {
+    delayDuration?: number;
+    skipDelayDuration?: number;
+    disableHoverableContent?: boolean;
+}
+/**
+ * The optional application-level provider of the design system (W5-20,
+ * ADR-010). Thin by design: it owns only what CSS cannot — the messages
+ * catalogue, the locale, the text direction, the portal container, the link
+ * and image adapters, shared tooltip defaults and (opt-in) the toast region.
+ * Colour scheme, brand and density stay attributes + CSS on `<html>`.
+ *
+ * Everything works identically without it: every component falls back to
+ * the English catalogue, `"en-US"`, `document.body` and its static `next/*`
+ * import. The provider renders **no DOM wrapper** (only the toast region when
+ * `toasts` is set), so it cannot cause a hydration mismatch.
+ *
+ * Reserved: the `useConfirm` / `usePrompt` host (W5-18) mounts here once it
+ * exists — see the comment in the render tree.
+ *
+ * @experimental
+ */
+declare function DesignSystemProvider({ messages, locale, dir, portalContainer, linkComponent, imageComponent, tooltip, toasts, children, }: DesignSystemProviderProps): react_jsx_runtime.JSX.Element;
+
+export { type ComboboxMessages as C, type DesignSystemProviderProps as D, type FileUploadMessages as F, type ImageComponent as I, type LinkComponent as L, type SearchInputMessages as S, type TooltipDefaults as T, type SelectMessages as a, type FieldMessages as b, DesignSystemProvider as c, type DsDirection as d, type DsMessageNamespace as e, type DsMessages as f, type DsMessagesOverride as g, type ImageComponentProps as h, type LinkComponentProps as i, useDsMessages as u };

package/dist/icons/index.d.ts

@@ -1,3 +1,3 @@
-export { A as AlertCircleIcon, a as AlertTriangleIcon, b as AlertTriangleSolidIcon, c as ArchiveIcon, d as ArrowDownIcon, e as ArrowLeftIcon, f as ArrowRightIcon, g as ArrowRightSmallIcon, h as ArrowUpIcon, i as AtSignIcon, B as BarChartIcon, j as BellIcon, k as BoldIcon, l as BrainIcon, m as BriefcaseIcon, n as Building2Icon, o as BuildingIcon, p as CalendarIcon, q as ChatBubbleIcon, r as CheckCircle2Icon, s as CheckCircleSolidIcon, t as CheckIcon, u as ChevronDownIcon, v as ChevronLeftIcon, w as ChevronRightIcon, x as ChevronUpIcon, y as ChevronsDownUpIcon, z as ChevronsUpDownIcon, D as CircleDotIcon, E as CircleIcon, F as ClipboardCheckIcon, G as ClockIcon, H as CloseIcon, J as CommandIcon, K as CopyIcon, L as CornerDownLeftIcon, M as CreditCardIcon, N as DocumentIcon, O as DollarSignIcon, P as DownloadIcon, Q as ExternalLinkIcon, R as ExtractIcon, T as EyeIcon, U as EyeOffIcon, W as FileIcon, X as FileReturnIcon, Y as FileTextIcon, Z as FilterIcon, _ as FlagIcon, $ as FolderClosedIcon, a0 as FolderOpenIcon, a1 as FolderPlusIcon, a2 as FolderUpIcon, a3 as GlobeIcon, a4 as GoogleBrandIcon, a5 as GripVerticalIcon, a6 as HelpCircleIcon, a7 as HistoryIcon, a8 as HomeIcon, a9 as IconComponent, aa as IconDefinition, ab as IconProps, ac as IconSize, ad as InboxIcon, ae as InfoCircleSolidIcon, af as InfoIcon, ag as ItalicIcon, ah as KanbanIcon, ai as KeyIcon, aj as LandmarkIcon, ak as LayersIcon, al as LayoutDashboardIcon, am as LayoutGridIcon, an as LayoutListIcon, ao as LightningIcon, ap as Link2Icon, aq as LinkIcon, ar as ListChecksIcon, as as ListIcon, at as ListOrderedIcon, au as LoaderIcon, av as LockIcon, aw as LockKeyholeIcon, ax as LockOpenIcon, ay as LogOutIcon, az as MailIcon, aA as MapPinIcon, aB as MaximizeIcon, aC as MenuIcon, aD as MessageCircleIcon, aE as MessageCircleWarningIcon, aF as MicIcon, aG as MicrosoftBrandIcon, aH as MinimizeIcon, aI as MinusIcon, aJ as MonitorIcon, aK as MoonIcon, aL as MoreHorizontalIcon, aM as MoveIcon, aN as PaletteIcon, aO as PanelLeftCloseIcon, aP as PanelLeftIcon, aQ as PanelRightIcon, aR as PaperclipIcon, aS as PauseIcon, aT as PenSignIcon, aU as PenToolIcon, aV as PencilIcon, aW as PhoneIcon, aX as PlayIcon, aY as PlusIcon, aZ as ReceiptIcon, a_ as RefreshCwIcon, a$ as ReplyIcon, b0 as RotateCcwIcon, b1 as SaveIcon, b2 as SearchIcon, b3 as SendIcon, b4 as SettingsIcon, b5 as ShieldIcon, b6 as SigmaIcon, b7 as SlashIcon, b8 as SmartphoneIcon, b9 as SparkleIcon, ba as SparklesIcon, bb as StarIcon, bc as StopIcon, bd as StrikethroughIcon, be as SunIcon, bf as TableIcon, bg as TagIcon, bh as TeamIcon, bi as ThumbsDownIcon, bj as ThumbsUpIcon, bk as TimerIcon, bl as Trash2Icon, bm as TrashIcon, bn as TrashSolidIcon, bo as TrendingDownIcon, bp as TrendingUpIcon, bq as UnderlineIcon, br as UploadIcon, bs as UserCircleIcon, bt as UserIcon, bu as UsersIcon, bv as VideoIcon, bw as Volume2Icon, bx as VolumeXIcon, by as WorkflowIcon, bz as XCircleSolidIcon, bA as XIcon, bB as ZoomInIcon, bC as ZoomOutIcon, bD as createIcon } from '../index-B3OiMlQv.js';
-import '../system-lyhOUTpa.js';
+export { A as AlertCircleIcon, a as AlertTriangleIcon, b as AlertTriangleSolidIcon, c as ArchiveIcon, d as ArrowDownIcon, e as ArrowLeftIcon, f as ArrowRightIcon, g as ArrowRightSmallIcon, h as ArrowUpIcon, i as AtSignIcon, B as BarChartIcon, j as BellIcon, k as BoldIcon, l as BrainIcon, m as BriefcaseIcon, n as Building2Icon, o as BuildingIcon, p as CalendarIcon, q as ChatBubbleIcon, r as CheckCircle2Icon, s as CheckCircleSolidIcon, t as CheckIcon, u as ChevronDownIcon, v as ChevronLeftIcon, w as ChevronRightIcon, x as ChevronUpIcon, y as ChevronsDownUpIcon, z as ChevronsUpDownIcon, D as CircleDotIcon, E as CircleIcon, F as ClipboardCheckIcon, G as ClockIcon, H as CloseIcon, J as CommandIcon, K as CopyIcon, L as CornerDownLeftIcon, M as CreditCardIcon, N as DocumentIcon, O as DollarSignIcon, P as DownloadIcon, Q as ExternalLinkIcon, R as ExtractIcon, T as EyeIcon, U as EyeOffIcon, W as FileIcon, X as FileReturnIcon, Y as FileTextIcon, Z as FilterIcon, _ as FlagIcon, $ as FolderClosedIcon, a0 as FolderOpenIcon, a1 as FolderPlusIcon, a2 as FolderUpIcon, a3 as GlobeIcon, a4 as GoogleBrandIcon, a5 as GripVerticalIcon, a6 as HelpCircleIcon, a7 as HistoryIcon, a8 as HomeIcon, a9 as IconComponent, aa as IconDefinition, ab as IconProps, ac as IconSize, ad as InboxIcon, ae as InfoCircleSolidIcon, af as InfoIcon, ag as ItalicIcon, ah as KanbanIcon, ai as KeyIcon, aj as LandmarkIcon, ak as LayersIcon, al as LayoutDashboardIcon, am as LayoutGridIcon, an as LayoutListIcon, ao as LightningIcon, ap as Link2Icon, aq as LinkIcon, ar as ListChecksIcon, as as ListIcon, at as ListOrderedIcon, au as LoaderIcon, av as LockIcon, aw as LockKeyholeIcon, ax as LockOpenIcon, ay as LogOutIcon, az as MailIcon, aA as MapPinIcon, aB as MaximizeIcon, aC as MenuIcon, aD as MessageCircleIcon, aE as MessageCircleWarningIcon, aF as MicIcon, aG as MicrosoftBrandIcon, aH as MinimizeIcon, aI as MinusIcon, aJ as MonitorIcon, aK as MoonIcon, aL as MoreHorizontalIcon, aM as MoveIcon, aN as PaletteIcon, aO as PanelLeftCloseIcon, aP as PanelLeftIcon, aQ as PanelRightIcon, aR as PaperclipIcon, aS as PauseIcon, aT as PenSignIcon, aU as PenToolIcon, aV as PencilIcon, aW as PhoneIcon, aX as PlayIcon, aY as PlusIcon, aZ as ReceiptIcon, a_ as RefreshCwIcon, a$ as ReplyIcon, b0 as RotateCcwIcon, b1 as SaveIcon, b2 as SearchIcon, b3 as SendIcon, b4 as SettingsIcon, b5 as ShieldIcon, b6 as SigmaIcon, b7 as SlashIcon, b8 as SmartphoneIcon, b9 as SparkleIcon, ba as SparklesIcon, bb as StarIcon, bc as StopIcon, bd as StrikethroughIcon, be as SunIcon, bf as TableIcon, bg as TagIcon, bh as TeamIcon, bi as ThumbsDownIcon, bj as ThumbsUpIcon, bk as TimerIcon, bl as Trash2Icon, bm as TrashIcon, bn as TrashSolidIcon, bo as TrendingDownIcon, bp as TrendingUpIcon, bq as UnderlineIcon, br as UploadIcon, bs as UserCircleIcon, bt as UserIcon, bu as UsersIcon, bv as VideoIcon, bw as Volume2Icon, bx as VolumeXIcon, by as WorkflowIcon, bz as XCircleSolidIcon, bA as XIcon, bB as ZoomInIcon, bC as ZoomOutIcon, bD as createIcon } from '../index-CQwzTm0v.js';
+import '../system-BDU18fVg.js';
 import 'react/jsx-runtime';

package/dist/{index-B3OiMlQv.d.ts → index-CQwzTm0v.d.ts}

@@ -1,4 +1,4 @@
-import { S as SystemTokens, i as iconSizes } from './system-lyhOUTpa.js';
+import { S as SystemTokens, i as iconSizes } from './system-BDU18fVg.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**