themelia-ui 1.0.0

package/dist/components/base/combobox/combobox.d.ts

@@ -0,0 +1,52 @@
+import { Combobox as ComboboxPrimitive } from '@base-ui/react/combobox';
+import { ReactNode } from 'react';
+/**
+ * The Base UI combobox anatomy, tokenized.
+ *
+ * This is the ANATOMY, not a recipe: it re-exports every part with the kit's surface
+ * applied and no opinion about how they go together. The searchable, single- and
+ * multi-select recipes compose these.
+ *
+ * The field parts carry `data-field-control` / `data-field-shell`, so they wear the same
+ * height, border, focus ring, and invalid state as Input, Textarea, and Select. That is
+ * the point: a combobox that looks almost like an input is worse than one that looks
+ * nothing like it.
+ */
+export declare const ComboboxRoot: typeof ComboboxPrimitive.Root;
+export declare const ComboboxPortal: import('react').ForwardRefExoticComponent<Omit<import('@base-ui/react').AutocompletePortalProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export declare const ComboboxCollection: typeof ComboboxPrimitive.Collection;
+export declare function ComboboxInput({ className, ...props }: ComboboxPrimitive.Input.Props): import("react").JSX.Element;
+/**
+ * The input with its trailing chevron, and optionally a clear button — the shape a
+ * searchable combobox almost always wants, with the padding that keeps the text clear of
+ * both computed rather than guessed.
+ */
+export declare function ComboboxInputTrigger({ className, showClear, invalid, ...props }: ComboboxPrimitive.Input.Props & {
+    showClear?: boolean;
+    invalid?: boolean;
+}): import("react").JSX.Element;
+/** The whole field as one trigger — a select-like combobox with no free text. */
+export declare function ComboboxTrigger({ className, children, ...props }: ComboboxPrimitive.Trigger.Props): import("react").JSX.Element;
+export declare function ComboboxValue({ placeholder, ...props }: ComboboxPrimitive.Value.Props & {
+    placeholder?: ReactNode;
+}): import("react").JSX.Element;
+export declare function ComboboxClear({ className, children, ...props }: ComboboxPrimitive.Clear.Props): import("react").JSX.Element;
+export declare function ComboboxPositioner({ className, sideOffset, ...props }: ComboboxPrimitive.Positioner.Props): import("react").JSX.Element;
+export declare function ComboboxPopup({ className, ...props }: ComboboxPrimitive.Popup.Props): import("react").JSX.Element;
+export declare function ComboboxList({ className, ...props }: ComboboxPrimitive.List.Props): import("react").JSX.Element;
+export declare function ComboboxItem({ className, children, ...props }: ComboboxPrimitive.Item.Props): import("react").JSX.Element;
+/** The indicator on its own, for a row that lays its parts out differently. */
+export declare function ComboboxItemIndicator({ className, children, ...props }: ComboboxPrimitive.ItemIndicator.Props): import("react").JSX.Element;
+export declare function ComboboxEmpty({ className, ...props }: ComboboxPrimitive.Empty.Props): import("react").JSX.Element;
+/** Async status — "Searching…", "12 of 340". Hidden while empty. */
+export declare function ComboboxStatus({ className, ...props }: ComboboxPrimitive.Status.Props): import("react").JSX.Element;
+export declare function ComboboxGroup({ className, ...props }: ComboboxPrimitive.Group.Props): import("react").JSX.Element;
+export declare function ComboboxGroupLabel({ className, ...props }: ComboboxPrimitive.GroupLabel.Props): import("react").JSX.Element;
+export declare function ComboboxSeparator({ className, ...props }: ComboboxPrimitive.Separator.Props): import("react").JSX.Element;
+export declare function ComboboxChips({ className, invalid, ...props }: ComboboxPrimitive.Chips.Props & {
+    invalid?: boolean;
+}): import("react").JSX.Element;
+export declare function ComboboxChip({ className, children, ...props }: ComboboxPrimitive.Chip.Props): import("react").JSX.Element;
+export declare function ComboboxChipsInput({ className, ...props }: ComboboxPrimitive.Input.Props): import("react").JSX.Element;
+export declare function ComboboxBackdrop({ className, ...props }: ComboboxPrimitive.Backdrop.Props): import("react").JSX.Element;
+export declare function ComboboxArrow({ className, ...props }: ComboboxPrimitive.Arrow.Props): import("react").JSX.Element;

package/dist/components/base/combobox/combobox.strings.d.cts

@@ -0,0 +1,14 @@
+export interface ComboboxStrings {
+    /** Accessible name for the field's clear control. */
+    clear: string;
+    /** Accessible name for the control that opens the list. */
+    toggle: string;
+    /**
+     * Accessible name for a chip's remove control.
+     *
+     * Takes the chip's own text, because "Remove" repeated down a row of eight chips tells
+     * a screen-reader user which control they are on and nothing about what it removes.
+     */
+    removeChip: (label: string) => string;
+}
+export declare const defaultComboboxStrings: ComboboxStrings;

package/dist/components/base/combobox/combobox.strings.d.ts

@@ -0,0 +1,14 @@
+export interface ComboboxStrings {
+    /** Accessible name for the field's clear control. */
+    clear: string;
+    /** Accessible name for the control that opens the list. */
+    toggle: string;
+    /**
+     * Accessible name for a chip's remove control.
+     *
+     * Takes the chip's own text, because "Remove" repeated down a row of eight chips tells
+     * a screen-reader user which control they are on and nothing about what it removes.
+     */
+    removeChip: (label: string) => string;
+}
+export declare const defaultComboboxStrings: ComboboxStrings;

package/dist/components/base/combobox/index.d.cts

@@ -0,0 +1,3 @@
+export { ComboboxArrow, ComboboxBackdrop, ComboboxChip, ComboboxChips, ComboboxChipsInput, ComboboxClear, ComboboxCollection, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel, ComboboxInput, ComboboxInputTrigger, ComboboxItem, ComboboxItemIndicator, ComboboxList, ComboboxPopup, ComboboxPortal, ComboboxPositioner, ComboboxRoot, ComboboxSeparator, ComboboxStatus, ComboboxTrigger, ComboboxValue, } from './combobox.cjs';
+export { defaultComboboxStrings, type ComboboxStrings } from './combobox.strings.cjs';
+export { useComboboxFilter } from './combobox-filter.cjs';

package/dist/components/base/combobox/index.d.ts

@@ -0,0 +1,3 @@
+export { ComboboxArrow, ComboboxBackdrop, ComboboxChip, ComboboxChips, ComboboxChipsInput, ComboboxClear, ComboboxCollection, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel, ComboboxInput, ComboboxInputTrigger, ComboboxItem, ComboboxItemIndicator, ComboboxList, ComboboxPopup, ComboboxPortal, ComboboxPositioner, ComboboxRoot, ComboboxSeparator, ComboboxStatus, ComboboxTrigger, ComboboxValue, } from './combobox.js';
+export { defaultComboboxStrings, type ComboboxStrings } from './combobox.strings.js';
+export { useComboboxFilter } from './combobox-filter.js';

package/dist/components/base/command/command.d.cts

@@ -0,0 +1,27 @@
+import { Command as CommandPrimitive } from 'cmdk';
+import { Dialog } from '../dialog/index.cjs';
+import { CommandStrings } from './command.strings.cjs';
+import * as React from "react";
+export type CommandProps = React.ComponentProps<typeof CommandPrimitive>;
+declare function Command({ className, ...props }: CommandProps): React.JSX.Element;
+export type CommandDialogProps = Omit<React.ComponentProps<typeof Dialog>, "children"> & {
+    /** Shorthands for the matching `strings` key. */
+    title?: string;
+    description?: string;
+    /** Overrides this palette's own copy. All of it is hidden from view. */
+    strings?: Partial<CommandStrings>;
+    /** Filtering, keyboard loop, and other cmdk root behavior. */
+    commandProps?: CommandProps;
+    className?: string;
+    showCloseButton?: boolean;
+    children: React.ReactNode;
+};
+declare function CommandDialog({ title, description, strings, commandProps, children, className, showCloseButton, ...props }: CommandDialogProps): React.JSX.Element;
+declare function CommandInput({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Input>): React.JSX.Element;
+declare function CommandList({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.List>): React.JSX.Element;
+declare function CommandEmpty({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Empty>): React.JSX.Element;
+declare function CommandGroup({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Group>): React.JSX.Element;
+declare function CommandSeparator({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Separator>): React.JSX.Element;
+declare function CommandItem({ className, children, ...props }: React.ComponentProps<typeof CommandPrimitive.Item>): React.JSX.Element;
+declare function CommandShortcut({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
+export { Command, CommandDialog, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem, CommandShortcut, CommandSeparator, };

package/dist/components/base/command/command.d.ts

@@ -0,0 +1,27 @@
+import { Command as CommandPrimitive } from 'cmdk';
+import { Dialog } from '../dialog/index.js';
+import { CommandStrings } from './command.strings.js';
+import * as React from "react";
+export type CommandProps = React.ComponentProps<typeof CommandPrimitive>;
+declare function Command({ className, ...props }: CommandProps): React.JSX.Element;
+export type CommandDialogProps = Omit<React.ComponentProps<typeof Dialog>, "children"> & {
+    /** Shorthands for the matching `strings` key. */
+    title?: string;
+    description?: string;
+    /** Overrides this palette's own copy. All of it is hidden from view. */
+    strings?: Partial<CommandStrings>;
+    /** Filtering, keyboard loop, and other cmdk root behavior. */
+    commandProps?: CommandProps;
+    className?: string;
+    showCloseButton?: boolean;
+    children: React.ReactNode;
+};
+declare function CommandDialog({ title, description, strings, commandProps, children, className, showCloseButton, ...props }: CommandDialogProps): React.JSX.Element;
+declare function CommandInput({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Input>): React.JSX.Element;
+declare function CommandList({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.List>): React.JSX.Element;
+declare function CommandEmpty({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Empty>): React.JSX.Element;
+declare function CommandGroup({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Group>): React.JSX.Element;
+declare function CommandSeparator({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Separator>): React.JSX.Element;
+declare function CommandItem({ className, children, ...props }: React.ComponentProps<typeof CommandPrimitive.Item>): React.JSX.Element;
+declare function CommandShortcut({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
+export { Command, CommandDialog, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem, CommandShortcut, CommandSeparator, };

package/dist/components/base/command/command.strings.d.cts

@@ -0,0 +1,9 @@
+export interface CommandStrings {
+    /** Names the dialog. Hidden from view — the palette's field is the visible label. */
+    title: string;
+    /** Describes it to assistive technology, also hidden. */
+    description: string;
+    /** Shown when the query matches nothing. */
+    empty: string;
+}
+export declare const defaultCommandStrings: CommandStrings;

package/dist/components/base/command/command.strings.d.ts

@@ -0,0 +1,9 @@
+export interface CommandStrings {
+    /** Names the dialog. Hidden from view — the palette's field is the visible label. */
+    title: string;
+    /** Describes it to assistive technology, also hidden. */
+    description: string;
+    /** Shown when the query matches nothing. */
+    empty: string;
+}
+export declare const defaultCommandStrings: CommandStrings;

package/dist/components/base/command/index.d.cts

@@ -0,0 +1,3 @@
+export { Command, CommandDialog, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem, CommandShortcut, CommandSeparator, } from './command.cjs';
+export type { CommandDialogProps, CommandProps } from './command.cjs';
+export { defaultCommandStrings, type CommandStrings } from './command.strings.cjs';

package/dist/components/base/command/index.d.ts

@@ -0,0 +1,3 @@
+export { Command, CommandDialog, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem, CommandShortcut, CommandSeparator, } from './command.js';
+export type { CommandDialogProps, CommandProps } from './command.js';
+export { defaultCommandStrings, type CommandStrings } from './command.strings.js';

package/dist/components/base/context-menu/context-menu.d.cts

@@ -0,0 +1,33 @@
+import { ContextMenu as ContextMenuPrimitive } from '@base-ui/react/context-menu';
+import { Menu as MenuPrimitive } from '@base-ui/react/menu';
+import { DropdownMenuCheckboxItem, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger } from '../dropdown-menu/index.cjs';
+import { UIPortalContainer } from '../../../lib/ui-provider/index.cjs';
+import type * as React from "react";
+declare function ContextMenu({ ...props }: ContextMenuPrimitive.Root.Props): React.JSX.Element;
+/** The region a right-click opens the menu over. */
+declare function ContextMenuTrigger({ ...props }: ContextMenuPrimitive.Trigger.Props): React.JSX.Element;
+/** The portal, for a caller placing the surface itself. The content portals already. */
+declare const ContextMenuPortal: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuPortalProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare function ContextMenuContent({ container, className, ...props }: MenuPrimitive.Popup.Props & {
+    className?: string;
+    /**
+     * Where the popup renders.
+     *
+     * Defaults to the nearest `UIPortalHost`, and to the primitive's own target when there
+     * is none — so a scope reaches its popups without every call site knowing about it.
+     */
+    container?: UIPortalContainer;
+}): React.JSX.Element;
+declare const ContextMenuItem: typeof DropdownMenuItem;
+declare const ContextMenuCheckboxItem: typeof DropdownMenuCheckboxItem;
+declare const ContextMenuRadioGroup: typeof DropdownMenuRadioGroup;
+declare const ContextMenuRadioItem: typeof DropdownMenuRadioItem;
+declare const ContextMenuLabel: typeof DropdownMenuLabel;
+declare const ContextMenuGroup: typeof DropdownMenuGroup;
+declare const ContextMenuSeparator: typeof DropdownMenuSeparator;
+declare const ContextMenuShortcut: typeof DropdownMenuShortcut;
+declare const ContextMenuSub: typeof DropdownMenuSub;
+declare const ContextMenuSubTrigger: typeof DropdownMenuSubTrigger;
+declare const ContextMenuSubContent: typeof DropdownMenuSubContent;
+export type ContextMenuProps = React.ComponentProps<typeof ContextMenu>;
+export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuPortal, ContextMenuItem, ContextMenuCheckboxItem, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuLabel, ContextMenuGroup, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubTrigger, ContextMenuSubContent, };

package/dist/components/base/context-menu/context-menu.d.ts

@@ -0,0 +1,33 @@
+import { ContextMenu as ContextMenuPrimitive } from '@base-ui/react/context-menu';
+import { Menu as MenuPrimitive } from '@base-ui/react/menu';
+import { DropdownMenuCheckboxItem, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger } from '../dropdown-menu/index.js';
+import { UIPortalContainer } from '../../../lib/ui-provider/index.js';
+import type * as React from "react";
+declare function ContextMenu({ ...props }: ContextMenuPrimitive.Root.Props): React.JSX.Element;
+/** The region a right-click opens the menu over. */
+declare function ContextMenuTrigger({ ...props }: ContextMenuPrimitive.Trigger.Props): React.JSX.Element;
+/** The portal, for a caller placing the surface itself. The content portals already. */
+declare const ContextMenuPortal: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuPortalProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare function ContextMenuContent({ container, className, ...props }: MenuPrimitive.Popup.Props & {
+    className?: string;
+    /**
+     * Where the popup renders.
+     *
+     * Defaults to the nearest `UIPortalHost`, and to the primitive's own target when there
+     * is none — so a scope reaches its popups without every call site knowing about it.
+     */
+    container?: UIPortalContainer;
+}): React.JSX.Element;
+declare const ContextMenuItem: typeof DropdownMenuItem;
+declare const ContextMenuCheckboxItem: typeof DropdownMenuCheckboxItem;
+declare const ContextMenuRadioGroup: typeof DropdownMenuRadioGroup;
+declare const ContextMenuRadioItem: typeof DropdownMenuRadioItem;
+declare const ContextMenuLabel: typeof DropdownMenuLabel;
+declare const ContextMenuGroup: typeof DropdownMenuGroup;
+declare const ContextMenuSeparator: typeof DropdownMenuSeparator;
+declare const ContextMenuShortcut: typeof DropdownMenuShortcut;
+declare const ContextMenuSub: typeof DropdownMenuSub;
+declare const ContextMenuSubTrigger: typeof DropdownMenuSubTrigger;
+declare const ContextMenuSubContent: typeof DropdownMenuSubContent;
+export type ContextMenuProps = React.ComponentProps<typeof ContextMenu>;
+export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuPortal, ContextMenuItem, ContextMenuCheckboxItem, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuLabel, ContextMenuGroup, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubTrigger, ContextMenuSubContent, };

package/dist/components/base/context-menu/index.d.cts

@@ -0,0 +1 @@
+export * from './context-menu.cjs';

package/dist/components/base/context-menu/index.d.ts

@@ -0,0 +1 @@
+export * from './context-menu.js';

package/dist/components/base/copyable/copyable.d.cts

@@ -0,0 +1,31 @@
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+import { ButtonProps } from '../buttons/index.cjs';
+import { CopyableStrings } from './copyable.strings.cjs';
+export interface CopyableProps extends Omit<ComponentPropsWithoutRef<"span">, "children" | "onCopy" | "onError"> {
+    /** Value written to the clipboard. */
+    value: string;
+    /** Display content, when it differs from the copied value. */
+    displayValue?: ReactNode;
+    /** Monospace the display content. For ids, keys, and hashes. */
+    mono?: boolean;
+    /** Truncates the display content at the width the caller allots. */
+    truncate?: boolean;
+    /**
+     * Sizes the trigger to the TEXT rather than to a control.
+     *
+     * A copy button is a control, and a control is 36px tall — which is right beside a
+     * field and wrong inside a list row, where the value is a description under a title.
+     * At full height the affordance was twice the height of the line it belonged to, and
+     * the row's own rhythm bent around it. Compact keeps every behaviour, and gives up only
+     * the pointer target a standalone control is entitled to.
+     */
+    compact?: boolean;
+    /** Overrides this control's own copy. */
+    strings?: Partial<CopyableStrings>;
+    /** Suppresses the toasts. The copied state on the control is the confirmation then. */
+    silent?: boolean;
+    buttonProps?: Omit<ButtonProps, "children" | "onClick" | "type">;
+    onCopy?: (value: string) => void;
+    onError?: (error: unknown) => void;
+}
+export declare const Copyable: import('react').ForwardRefExoticComponent<CopyableProps & import('react').RefAttributes<HTMLSpanElement>>;

package/dist/components/base/copyable/copyable.d.ts

@@ -0,0 +1,31 @@
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+import { ButtonProps } from '../buttons/index.js';
+import { CopyableStrings } from './copyable.strings.js';
+export interface CopyableProps extends Omit<ComponentPropsWithoutRef<"span">, "children" | "onCopy" | "onError"> {
+    /** Value written to the clipboard. */
+    value: string;
+    /** Display content, when it differs from the copied value. */
+    displayValue?: ReactNode;
+    /** Monospace the display content. For ids, keys, and hashes. */
+    mono?: boolean;
+    /** Truncates the display content at the width the caller allots. */
+    truncate?: boolean;
+    /**
+     * Sizes the trigger to the TEXT rather than to a control.
+     *
+     * A copy button is a control, and a control is 36px tall — which is right beside a
+     * field and wrong inside a list row, where the value is a description under a title.
+     * At full height the affordance was twice the height of the line it belonged to, and
+     * the row's own rhythm bent around it. Compact keeps every behaviour, and gives up only
+     * the pointer target a standalone control is entitled to.
+     */
+    compact?: boolean;
+    /** Overrides this control's own copy. */
+    strings?: Partial<CopyableStrings>;
+    /** Suppresses the toasts. The copied state on the control is the confirmation then. */
+    silent?: boolean;
+    buttonProps?: Omit<ButtonProps, "children" | "onClick" | "type">;
+    onCopy?: (value: string) => void;
+    onError?: (error: unknown) => void;
+}
+export declare const Copyable: import('react').ForwardRefExoticComponent<CopyableProps & import('react').RefAttributes<HTMLSpanElement>>;

package/dist/components/base/copyable/copyable.strings.d.cts

@@ -0,0 +1,11 @@
+export interface CopyableStrings {
+    /** Accessible name for the control before it has been used. */
+    copy: string;
+    /** Accessible name while the copied state is showing. The name IS the state here. */
+    copied: string;
+    /** Toast raised on success. `null` on the prop suppresses the toast entirely. */
+    success: string;
+    /** Toast raised when the clipboard write is refused — no permission, no secure context. */
+    error: string;
+}
+export declare const defaultCopyableStrings: CopyableStrings;

package/dist/components/base/copyable/copyable.strings.d.ts

@@ -0,0 +1,11 @@
+export interface CopyableStrings {
+    /** Accessible name for the control before it has been used. */
+    copy: string;
+    /** Accessible name while the copied state is showing. The name IS the state here. */
+    copied: string;
+    /** Toast raised on success. `null` on the prop suppresses the toast entirely. */
+    success: string;
+    /** Toast raised when the clipboard write is refused — no permission, no secure context. */
+    error: string;
+}
+export declare const defaultCopyableStrings: CopyableStrings;

package/dist/components/base/copyable/index.d.cts

@@ -0,0 +1,3 @@
+export { Copyable, type CopyableProps } from './copyable.cjs';
+export { defaultCopyableStrings, type CopyableStrings } from './copyable.strings.cjs';
+export { useCopyToClipboard, type UseCopyToClipboardOptions, type UseCopyToClipboardResult, } from './use-copy-to-clipboard.cjs';

package/dist/components/base/copyable/index.d.ts

@@ -0,0 +1,3 @@
+export { Copyable, type CopyableProps } from './copyable.js';
+export { defaultCopyableStrings, type CopyableStrings } from './copyable.strings.js';
+export { useCopyToClipboard, type UseCopyToClipboardOptions, type UseCopyToClipboardResult, } from './use-copy-to-clipboard.js';

package/dist/components/base/copyable/use-copy-to-clipboard.d.cts

@@ -0,0 +1,35 @@
+/**
+ * Copy a value, confirm it, and reset — the behaviour five surfaces had written out.
+ *
+ * `Copyable` owned a careful version of this and four other places re-implemented it:
+ * both AI-chat surfaces, the theme tweaker's export panel, and the docs site's code block.
+ * They disagreed, and the disagreements were defects — the docs block wrote to the
+ * clipboard without checking there is one, never caught the rejection when there is not,
+ * and set state from a timeout it never cleared.
+ *
+ * ── Why a counter and not a boolean ──────────────────────────────────────────────────
+ * Setting a boolean that is already `true` is a no-op: React bails out, the effect never
+ * re-runs, and the second copy inherits whatever was left of the first one's window.
+ * Copying twice in a row then flashes the confirmation for a fraction of a second. A
+ * counter changes on every copy, so each one restarts the window.
+ */
+export interface UseCopyToClipboardOptions {
+    /** How long the confirmation stands. */
+    confirmMs?: number;
+    /**
+     * Where the value goes, when it is not the platform clipboard.
+     *
+     * The theme tweaker takes a writer from its caller so an embedding app can handle the
+     * environments where `navigator.clipboard` is absent — a webview, an insecure origin.
+     */
+    write?: (value: string) => void | Promise<void>;
+    onCopy?: (value: string) => void;
+    onError?: (error: unknown) => void;
+}
+export interface UseCopyToClipboardResult {
+    /** True from the moment the copy succeeds until the window closes. */
+    copied: boolean;
+    /** Resolves `true` when the value was written, `false` when it was not. */
+    copy: (value: string) => Promise<boolean>;
+}
+export declare function useCopyToClipboard({ confirmMs, write, onCopy, onError, }?: UseCopyToClipboardOptions): UseCopyToClipboardResult;

package/dist/components/base/copyable/use-copy-to-clipboard.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copy a value, confirm it, and reset — the behaviour five surfaces had written out.
+ *
+ * `Copyable` owned a careful version of this and four other places re-implemented it:
+ * both AI-chat surfaces, the theme tweaker's export panel, and the docs site's code block.
+ * They disagreed, and the disagreements were defects — the docs block wrote to the
+ * clipboard without checking there is one, never caught the rejection when there is not,
+ * and set state from a timeout it never cleared.
+ *
+ * ── Why a counter and not a boolean ──────────────────────────────────────────────────
+ * Setting a boolean that is already `true` is a no-op: React bails out, the effect never
+ * re-runs, and the second copy inherits whatever was left of the first one's window.
+ * Copying twice in a row then flashes the confirmation for a fraction of a second. A
+ * counter changes on every copy, so each one restarts the window.
+ */
+export interface UseCopyToClipboardOptions {
+    /** How long the confirmation stands. */
+    confirmMs?: number;
+    /**
+     * Where the value goes, when it is not the platform clipboard.
+     *
+     * The theme tweaker takes a writer from its caller so an embedding app can handle the
+     * environments where `navigator.clipboard` is absent — a webview, an insecure origin.
+     */
+    write?: (value: string) => void | Promise<void>;
+    onCopy?: (value: string) => void;
+    onError?: (error: unknown) => void;
+}
+export interface UseCopyToClipboardResult {
+    /** True from the moment the copy succeeds until the window closes. */
+    copied: boolean;
+    /** Resolves `true` when the value was written, `false` when it was not. */
+    copy: (value: string) => Promise<boolean>;
+}
+export declare function useCopyToClipboard({ confirmMs, write, onCopy, onError, }?: UseCopyToClipboardOptions): UseCopyToClipboardResult;

package/dist/components/base/date-pickers/calendar.d.cts

@@ -0,0 +1,19 @@
+import { CalendarStrings } from './date-pickers.strings.cjs';
+import { CalendarConstraints, DateRangeValue, DateSelectionMode } from './calendar.types.cjs';
+export interface CalendarProps extends CalendarConstraints {
+    /** Overrides this calendar's own copy — the three caption controls. */
+    strings?: Partial<CalendarStrings>;
+    mode?: DateSelectionMode;
+    /** The selection, in the shape the mode uses. */
+    value?: Date | Date[] | DateRangeValue;
+    onValueChange?: (value: Date | Date[] | DateRangeValue | undefined) => void;
+    /** The month shown. Uncontrolled unless supplied. */
+    month?: Date;
+    onMonthChange?: (month: Date) => void;
+    /** How many months to show side by side. Two is the usual range picker. */
+    numberOfMonths?: number;
+    /** 0 is Sunday. Falls back to the provider's formatting config. */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    className?: string;
+}
+export declare function Calendar({ strings, mode, value, onValueChange, month: monthProp, onMonthChange, numberOfMonths, weekStartsOn, className, ...constraints }: CalendarProps): import("react").JSX.Element;

package/dist/components/base/date-pickers/calendar.d.ts

@@ -0,0 +1,19 @@
+import { CalendarStrings } from './date-pickers.strings.js';
+import { CalendarConstraints, DateRangeValue, DateSelectionMode } from './calendar.types.js';
+export interface CalendarProps extends CalendarConstraints {
+    /** Overrides this calendar's own copy — the three caption controls. */
+    strings?: Partial<CalendarStrings>;
+    mode?: DateSelectionMode;
+    /** The selection, in the shape the mode uses. */
+    value?: Date | Date[] | DateRangeValue;
+    onValueChange?: (value: Date | Date[] | DateRangeValue | undefined) => void;
+    /** The month shown. Uncontrolled unless supplied. */
+    month?: Date;
+    onMonthChange?: (month: Date) => void;
+    /** How many months to show side by side. Two is the usual range picker. */
+    numberOfMonths?: number;
+    /** 0 is Sunday. Falls back to the provider's formatting config. */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    className?: string;
+}
+export declare function Calendar({ strings, mode, value, onValueChange, month: monthProp, onMonthChange, numberOfMonths, weekStartsOn, className, ...constraints }: CalendarProps): import("react").JSX.Element;

package/dist/components/base/date-pickers/calendar.types.d.cts

@@ -0,0 +1,18 @@
+export type DateSelectionMode = "single" | "multiple" | "range";
+export interface DateRangeValue {
+    from?: Date;
+    to?: Date;
+}
+export interface CalendarConstraints {
+    /** Earliest selectable day, inclusive. */
+    minDate?: Date;
+    /** Latest selectable day, inclusive. */
+    maxDate?: Date;
+    /** Refuses individual days — weekends, holidays, days already booked. */
+    disabledDates?: (date: Date) => boolean;
+}
+export interface DatePreset {
+    label: string;
+    /** Returns the value the preset selects, in whatever shape the mode uses. */
+    value: () => Date | Date[] | DateRangeValue;
+}

package/dist/components/base/date-pickers/calendar.types.d.ts

@@ -0,0 +1,18 @@
+export type DateSelectionMode = "single" | "multiple" | "range";
+export interface DateRangeValue {
+    from?: Date;
+    to?: Date;
+}
+export interface CalendarConstraints {
+    /** Earliest selectable day, inclusive. */
+    minDate?: Date;
+    /** Latest selectable day, inclusive. */
+    maxDate?: Date;
+    /** Refuses individual days — weekends, holidays, days already booked. */
+    disabledDates?: (date: Date) => boolean;
+}
+export interface DatePreset {
+    label: string;
+    /** Returns the value the preset selects, in whatever shape the mode uses. */
+    value: () => Date | Date[] | DateRangeValue;
+}

package/dist/components/base/date-pickers/date-picker-bands.d.cts

@@ -0,0 +1,16 @@
+import { ComponentProps, ReactNode } from 'react';
+export interface DatePickerHeaderProps extends Omit<ComponentProps<"div">, "title"> {
+    title?: ReactNode;
+    /** A second line — the range's length, the constraint in force. */
+    description?: ReactNode;
+    /** A control at the trailing edge — a mode switch, a clear. */
+    action?: ReactNode;
+}
+export declare function DatePickerHeader({ title, description, action, className, children, ...props }: DatePickerHeaderProps): import("react").JSX.Element | null;
+export interface DatePickerFooterProps extends ComponentProps<"div"> {
+    /** A summary of what is chosen — "3 – 7 March, 5 days". */
+    summary?: ReactNode;
+    /** Controls at the trailing edge. */
+    actions?: ReactNode;
+}
+export declare function DatePickerFooter({ summary, actions, className, children, ...props }: DatePickerFooterProps): import("react").JSX.Element | null;

package/dist/components/base/date-pickers/date-picker-bands.d.ts

@@ -0,0 +1,16 @@
+import { ComponentProps, ReactNode } from 'react';
+export interface DatePickerHeaderProps extends Omit<ComponentProps<"div">, "title"> {
+    title?: ReactNode;
+    /** A second line — the range's length, the constraint in force. */
+    description?: ReactNode;
+    /** A control at the trailing edge — a mode switch, a clear. */
+    action?: ReactNode;
+}
+export declare function DatePickerHeader({ title, description, action, className, children, ...props }: DatePickerHeaderProps): import("react").JSX.Element | null;
+export interface DatePickerFooterProps extends ComponentProps<"div"> {
+    /** A summary of what is chosen — "3 – 7 March, 5 days". */
+    summary?: ReactNode;
+    /** Controls at the trailing edge. */
+    actions?: ReactNode;
+}
+export declare function DatePickerFooter({ summary, actions, className, children, ...props }: DatePickerFooterProps): import("react").JSX.Element | null;

package/dist/components/base/date-pickers/date-picker.d.cts

@@ -0,0 +1,40 @@
+import { ReactNode } from 'react';
+import { DatePickerStrings } from './date-pickers.strings.cjs';
+import { CalendarConstraints, DatePreset, DateRangeValue, DateSelectionMode } from './calendar.types.cjs';
+export interface DatePickerProps extends CalendarConstraints {
+    /**
+     * Applied to the TRIGGER, which is the only labelable element this renders.
+     *
+     * It matters more here than for a text field: the trigger takes its accessible name
+     * from the chosen date, so without the caption reaching it the control announces a
+     * value and never says what the value is for.
+     */
+    id?: string;
+    mode?: DateSelectionMode;
+    value?: Date | Date[] | DateRangeValue;
+    onValueChange?: (value: Date | Date[] | DateRangeValue | undefined) => void;
+    /** How the chosen value is written in the trigger. */
+    displayFormat?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Adds a clear control to the trigger once something is chosen. */
+    clearable?: boolean;
+    /** Overrides this picker's own copy — the clear control and the calendar's captions. */
+    strings?: Partial<DatePickerStrings>;
+    /** Shortcuts down the side — "Last 30 days", "This month". */
+    presets?: DatePreset[];
+    numberOfMonths?: number;
+    /** Closes the popup as soon as a complete value is chosen. */
+    closeOnSelect?: boolean;
+    /** A band above the calendar — a title, a mode switch. Use `DatePickerHeader`. */
+    header?: ReactNode;
+    /** A band below it — a summary, Clear and Apply. Use `DatePickerFooter`. */
+    footer?: ReactNode;
+    className?: string;
+    contentClassName?: string;
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+}
+export declare function DatePicker({ id, mode, value, onValueChange, displayFormat, placeholder, disabled, invalid, clearable, strings, presets, numberOfMonths, closeOnSelect, header, footer, className, contentClassName, minDate, maxDate, disabledDates, ...aria }: DatePickerProps): import("react").JSX.Element;