@ai-matrx/design-system 0.12.1 → 0.14.0

package/dist/index.d.cts

@@ -1243,6 +1243,158 @@ interface SegmentedControlProps {
 }
 declare function SegmentedControl({ value, onValueChange, data, name: _name, className, fullWidth, size, }: SegmentedControlProps): React.JSX.Element;
 
+/**
+ * ArchiveFilter — THE platform archive filter control.
+ *
+ * THE ARCHIVED-ITEMS LAW (Arman, 2026-09-09 —
+ * common-docs/policies/archived-items.md): every list surface over an entity
+ * that can be archived carries this control, its default hides archived rows,
+ * and revealing them is ONE click. It is a class, not an instance: agents,
+ * workflows, employees, HR documents, conversations, admin tables — the same
+ * three states, the same words, everywhere.
+ *
+ * The vocabulary is `matrx-frontend/lib/entity-list`'s `ArchivedFilter`
+ * verbatim (`active` | `archived` | `all`, default `active`, labels "Active
+ * only" / "Archived only" / "Active + archived") so a user meets one control,
+ * not one per app. `@ai-matrx/agents/catalog`'s `archFilter` is the same axis
+ * with its own legacy third value (`both`); `ARCHIVE_FILTER_VALUES` is the
+ * canonical set new code binds to.
+ *
+ * The filter is a REQUEST, never a client-side sieve: hand the value to the
+ * reader (an RPC's `p_archived`, an endpoint's `archived=`) so counts, badges
+ * and pagination describe what the list actually renders.
+ */
+
+/** The three states, in display order. */
+declare const ARCHIVE_FILTER_VALUES: readonly ["active", "archived", "all"];
+type ArchiveFilterValue = (typeof ARCHIVE_FILTER_VALUES)[number];
+/** The platform default: a list hides archived rows until asked. */
+declare const DEFAULT_ARCHIVE_FILTER: ArchiveFilterValue;
+/**
+ * The ONE noun for archived rows, platform-wide. Both controls speak it: the
+ * filter's `archived` state ("Archived only") and `ArchivedDisclosure`'s
+ * button ("Archived (N)"). Renaming it in one place renames it in both, which
+ * is the point — a user meets one word, not two.
+ */
+declare const ARCHIVE_LABEL = "Archived";
+/** The one wording. Hosts pass `labels` only to shorten, never to rename. */
+declare const ARCHIVE_FILTER_LABELS: Record<ArchiveFilterValue, string>;
+/**
+ * A disclosure's open/closed state said in the tri-state vocabulary, for the
+ * hosts whose "Archived (N)" toggle IS a server request rather than a nested
+ * render. Closed asks for the platform default (archived hidden); open asks
+ * for `all`, because a disclosure reveals archived rows BESIDE the live ones —
+ * it never replaces the list with the archive.
+ */
+declare function archiveFilterFromDisclosure(open: boolean): ArchiveFilterValue;
+/**
+ * Narrow an untrusted value (a URL param, a stored preference, an API echo)
+ * to the tri-state. Anything unrecognised falls back to the platform default
+ * rather than silently widening a list to archived rows.
+ */
+declare function toArchiveFilter(value: unknown, fallback?: ArchiveFilterValue): ArchiveFilterValue;
+interface ArchiveFilterProps {
+    value: ArchiveFilterValue;
+    onValueChange: (value: ArchiveFilterValue) => void;
+    /**
+     * Per-state row counts, when the reader returns them (a facet query, a
+     * `total_count`). A count that is not honest is worse than none, so pass a
+     * key only when the number describes what the list would actually render.
+     */
+    counts?: Partial<Record<ArchiveFilterValue, number>>;
+    /** Shorter wording for a dense toolbar. Never a different meaning. */
+    labels?: Partial<Record<ArchiveFilterValue, string>>;
+    size?: "sm" | "md" | "lg";
+    className?: string;
+    /** Accessible name for the group. */
+    "aria-label"?: string;
+    disabled?: boolean;
+}
+/**
+ * The control. One click from "Active only" to seeing archived rows.
+ */
+declare function ArchiveFilter({ value, onValueChange, counts, labels, size, className, "aria-label": ariaLabel, disabled, }: ArchiveFilterProps): React.JSX.Element;
+
+/**
+ * ArchivedDisclosure — THE ARCHIVED-ITEMS LAW, card-list half.
+ * (`common-docs/policies/archived-items.md`, Arman 2026-09-09.)
+ *
+ * Every list over an entity that can be archived carries an archive control,
+ * it defaults to HIDING archived rows, and revealing them is one or two
+ * clicks — on the surface itself. There are exactly TWO implementations of
+ * that control in the platform, and both live in THIS package:
+ *
+ *   • `ArchiveFilter` — the tri-state segmented control (Active only /
+ *     Archived only / Active + archived) for table and browse surfaces whose
+ *     reader takes an archive parameter. Prefer it whenever the surface can
+ *     express the request server-side.
+ *   • `ArchivedDisclosure` — THIS component: a one-click "Archived (N)"
+ *     disclosure, closed by default, revealing the archived rows in place
+ *     underneath. For card lists, panels and pickers that are not table
+ *     shaped.
+ *
+ * Never invent a third. The disclosure was proven first in matrx-frontend's
+ * Transcript Studio, lived as `components/official/ArchivedDisclosure` there,
+ * and moved here (0.14.0) verbatim so every client inherits the same control
+ * instead of re-growing it per app.
+ *
+ * Both controls share one vocabulary: `ARCHIVE_LABEL` is the single noun, and
+ * `archiveFilterFromDisclosure(open)` says a disclosure's state in the
+ * tri-state words for a host whose toggle IS a server request.
+ *
+ * Two shapes, one primitive:
+ *
+ *   <ArchivedDisclosure count={n} open={open} onOpenChange={setOpen}>
+ *     …archived rows…
+ *   </ArchivedDisclosure>
+ *
+ * renders the button AND the revealed block. Omit `children` when the caller
+ * merges the archived rows into an existing table/grid itself — the button is
+ * then the whole control.
+ *
+ * The count is ALWAYS the true number of archived rows the surface holds. A
+ * screen never lies: when there is nothing archived the control renders
+ * nothing at all rather than an empty promise. A surface whose archive view is
+ * a SERVER request (the rows below the button are the archived page itself,
+ * not children of it) passes `keepWhileOpen` so the revealed view never loses
+ * its way back.
+ *
+ * `countLabel` exists for the one case a bare integer cannot tell the truth: a
+ * server-side count that hit its cap (render `"12+"`), or a count that has not
+ * landed yet (pass `null` and no parenthetical is printed at all).
+ */
+
+interface ArchivedDisclosureProps {
+    /** True number of archived rows this surface holds. 0 renders nothing. */
+    count: number;
+    /** Whether archived rows are currently revealed. */
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /**
+     * The archived rows. Omit when the host merges them into its own list and
+     * only needs the toggle.
+     */
+    children?: React.ReactNode;
+    /** Noun for the rows, so the button reads in the surface's own words. */
+    label?: string;
+    /**
+     * Override the parenthetical. A string replaces the number (`"12+"` for a
+     * capped server count); `null` prints no parenthetical at all, for a count
+     * that has not arrived yet. Omit it and the honest `count` is printed.
+     */
+    countLabel?: string | null;
+    /**
+     * Keep the control rendered while `open` even at `count === 0`. For surfaces
+     * where opening SWITCHES the list to the archive (a server-side filter)
+     * rather than nesting rows inside this component: without it the way back
+     * would vanish the moment the count read zero or had not landed.
+     */
+    keepWhileOpen?: boolean;
+    className?: string;
+    contentClassName?: string;
+}
+declare function ArchivedDisclosure({ count, open, onOpenChange, children, label, countLabel, keepWhileOpen, className, contentClassName, }: ArchivedDisclosureProps): React.JSX.Element | null;
+
 declare const Select: React.FC<SelectPrimitive.SelectProps>;
 declare const SelectGroup: React.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React.RefAttributes<HTMLDivElement>>;
 declare const SelectValue: React.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>>;
@@ -1976,4 +2128,4 @@ declare const ALL_MOTION_CLASSES: readonly ["matrx-motion-overlay", "matrx-motio
  */
 declare const FORBIDDEN_HOST_MOTION_UTILITIES: readonly ["animate-in", "animate-out", "fade-in", "fade-out", "zoom-in", "zoom-out", "slide-in-from", "slide-out-to", "animate-accordion", "animate-slide-down", "animate-slide-up", "animate-pulse", "animate-spin"];
 
-export { ALL_MOTION_CLASSES, Accordion, AccordionContent, AccordionItem, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogContentPrimitive, type AlertDialogContentProps, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, Avatar, AvatarFallback, AvatarImage, type AvatarProps, type AvatarSize, Badge, type BadgeProps, BasicInput, BasicTextarea, BottomSheet, BottomSheetBody, type BottomSheetBodyProps, BottomSheetFooter, type BottomSheetFooterProps, BottomSheetHeader, type BottomSheetHeaderProps, type BottomSheetProps, Button, type ButtonProps, CENTERED_DIALOG, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSize, CardTitle, Checkbox, type CheckboxProps, type CheckboxSize, Collapsible, CollapsibleContent, type CollapsibleContentProps, CollapsibleTrigger, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmDialog, ConfirmDialogHost, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, type ContextMenuContentProps, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type CreatableOption, CreatablePicker, type CreatablePickerProps, DEFAULT_SCORE_THRESHOLDS, Dialog, DialogClose, DialogContent, DialogContentPrimitive, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerContentPrimitive, type DrawerContentProps, DrawerDescription, type DrawerDirection, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, type DrawerProps, type DrawerSize, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EditableLabel, type EditableLabelActivation, type EditableLabelCommitMode, type EditableLabelProps, EnterInput, type EnterInputProps, FORBIDDEN_HOST_MOTION_UTILITIES, HoverCard, HoverCardContent, type HoverCardContentProps, HoverCardTrigger, Input, type InputProps, type InputVariant, InputWithPrefix, type InputWithPrefixProps, Label, MOBILE_BREAKPOINT, MOTION_BOTTOM_SHEET, MOTION_DIALOG, MOTION_OVERLAY, MOTION_POPPER, MOTION_PULSE, MOTION_SHEET, MOTION_SPIN, OrganizationAbbreviation, OrganizationPicker, type OrganizationPickerOrganization, type OrganizationPickerProps, OverflowToolbar, type OverflowToolbarProps, POPPER_OFFSET, type PickerIcon, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, PortalContainerProvider, type PortalContainerProviderProps, Progress, type ProgressProps, type ProgressTone, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSize, RadixDialogModalProvider, type RadixDialogModalProviderProps, ResizableHandle, type ResizableHandleProps, type ResizableHandleSize, ResizablePanel, ResizablePanelGroup, ScoreRing, type ScoreRingProps, type ScoreThresholds, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollFadeState, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Switch, type SwitchProps, type SwitchSize, TabbedBottomSheet, type TabbedBottomSheetProps, type TabbedBottomSheetTab, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableSize, Tabs, TabsContent, TabsList, TabsTrigger, TabsTriggerCore, Textarea, type TextareaProps, TextareaWithPrefix, type TextareaWithPrefixProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, type ToolbarAction, type ToolbarActionTone, type ToolbarIcon, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseScrollFadeResult, alertVariants, badgeVariants, buttonVariants, cn, scoreAccentBgClasses, scoreRingColorClasses, selectTriggerVariants, sheetVariants, toggleVariants, useAccordionSize, useCardSize, useDialogContainer, useDrawerDirection, useIsMobile, usePortalContainer, useRadixDialogModal, useScrollFade, useTableSize };
+export { ALL_MOTION_CLASSES, ARCHIVE_FILTER_LABELS, ARCHIVE_FILTER_VALUES, ARCHIVE_LABEL, Accordion, AccordionContent, AccordionItem, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogContentPrimitive, type AlertDialogContentProps, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, ArchiveFilter, type ArchiveFilterProps, type ArchiveFilterValue, ArchivedDisclosure, type ArchivedDisclosureProps, Avatar, AvatarFallback, AvatarImage, type AvatarProps, type AvatarSize, Badge, type BadgeProps, BasicInput, BasicTextarea, BottomSheet, BottomSheetBody, type BottomSheetBodyProps, BottomSheetFooter, type BottomSheetFooterProps, BottomSheetHeader, type BottomSheetHeaderProps, type BottomSheetProps, Button, type ButtonProps, CENTERED_DIALOG, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSize, CardTitle, Checkbox, type CheckboxProps, type CheckboxSize, Collapsible, CollapsibleContent, type CollapsibleContentProps, CollapsibleTrigger, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmDialog, ConfirmDialogHost, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, type ContextMenuContentProps, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type CreatableOption, CreatablePicker, type CreatablePickerProps, DEFAULT_ARCHIVE_FILTER, DEFAULT_SCORE_THRESHOLDS, Dialog, DialogClose, DialogContent, DialogContentPrimitive, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerContentPrimitive, type DrawerContentProps, DrawerDescription, type DrawerDirection, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, type DrawerProps, type DrawerSize, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EditableLabel, type EditableLabelActivation, type EditableLabelCommitMode, type EditableLabelProps, EnterInput, type EnterInputProps, FORBIDDEN_HOST_MOTION_UTILITIES, HoverCard, HoverCardContent, type HoverCardContentProps, HoverCardTrigger, Input, type InputProps, type InputVariant, InputWithPrefix, type InputWithPrefixProps, Label, MOBILE_BREAKPOINT, MOTION_BOTTOM_SHEET, MOTION_DIALOG, MOTION_OVERLAY, MOTION_POPPER, MOTION_PULSE, MOTION_SHEET, MOTION_SPIN, OrganizationAbbreviation, OrganizationPicker, type OrganizationPickerOrganization, type OrganizationPickerProps, OverflowToolbar, type OverflowToolbarProps, POPPER_OFFSET, type PickerIcon, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, PortalContainerProvider, type PortalContainerProviderProps, Progress, type ProgressProps, type ProgressTone, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSize, RadixDialogModalProvider, type RadixDialogModalProviderProps, ResizableHandle, type ResizableHandleProps, type ResizableHandleSize, ResizablePanel, ResizablePanelGroup, ScoreRing, type ScoreRingProps, type ScoreThresholds, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollFadeState, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Switch, type SwitchProps, type SwitchSize, TabbedBottomSheet, type TabbedBottomSheetProps, type TabbedBottomSheetTab, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableSize, Tabs, TabsContent, TabsList, TabsTrigger, TabsTriggerCore, Textarea, type TextareaProps, TextareaWithPrefix, type TextareaWithPrefixProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, type ToolbarAction, type ToolbarActionTone, type ToolbarIcon, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseScrollFadeResult, alertVariants, archiveFilterFromDisclosure, badgeVariants, buttonVariants, cn, scoreAccentBgClasses, scoreRingColorClasses, selectTriggerVariants, sheetVariants, toArchiveFilter, toggleVariants, useAccordionSize, useCardSize, useDialogContainer, useDrawerDirection, useIsMobile, usePortalContainer, useRadixDialogModal, useScrollFade, useTableSize };

package/dist/index.d.ts

@@ -1243,6 +1243,158 @@ interface SegmentedControlProps {
 }
 declare function SegmentedControl({ value, onValueChange, data, name: _name, className, fullWidth, size, }: SegmentedControlProps): React.JSX.Element;
 
+/**
+ * ArchiveFilter — THE platform archive filter control.
+ *
+ * THE ARCHIVED-ITEMS LAW (Arman, 2026-09-09 —
+ * common-docs/policies/archived-items.md): every list surface over an entity
+ * that can be archived carries this control, its default hides archived rows,
+ * and revealing them is ONE click. It is a class, not an instance: agents,
+ * workflows, employees, HR documents, conversations, admin tables — the same
+ * three states, the same words, everywhere.
+ *
+ * The vocabulary is `matrx-frontend/lib/entity-list`'s `ArchivedFilter`
+ * verbatim (`active` | `archived` | `all`, default `active`, labels "Active
+ * only" / "Archived only" / "Active + archived") so a user meets one control,
+ * not one per app. `@ai-matrx/agents/catalog`'s `archFilter` is the same axis
+ * with its own legacy third value (`both`); `ARCHIVE_FILTER_VALUES` is the
+ * canonical set new code binds to.
+ *
+ * The filter is a REQUEST, never a client-side sieve: hand the value to the
+ * reader (an RPC's `p_archived`, an endpoint's `archived=`) so counts, badges
+ * and pagination describe what the list actually renders.
+ */
+
+/** The three states, in display order. */
+declare const ARCHIVE_FILTER_VALUES: readonly ["active", "archived", "all"];
+type ArchiveFilterValue = (typeof ARCHIVE_FILTER_VALUES)[number];
+/** The platform default: a list hides archived rows until asked. */
+declare const DEFAULT_ARCHIVE_FILTER: ArchiveFilterValue;
+/**
+ * The ONE noun for archived rows, platform-wide. Both controls speak it: the
+ * filter's `archived` state ("Archived only") and `ArchivedDisclosure`'s
+ * button ("Archived (N)"). Renaming it in one place renames it in both, which
+ * is the point — a user meets one word, not two.
+ */
+declare const ARCHIVE_LABEL = "Archived";
+/** The one wording. Hosts pass `labels` only to shorten, never to rename. */
+declare const ARCHIVE_FILTER_LABELS: Record<ArchiveFilterValue, string>;
+/**
+ * A disclosure's open/closed state said in the tri-state vocabulary, for the
+ * hosts whose "Archived (N)" toggle IS a server request rather than a nested
+ * render. Closed asks for the platform default (archived hidden); open asks
+ * for `all`, because a disclosure reveals archived rows BESIDE the live ones —
+ * it never replaces the list with the archive.
+ */
+declare function archiveFilterFromDisclosure(open: boolean): ArchiveFilterValue;
+/**
+ * Narrow an untrusted value (a URL param, a stored preference, an API echo)
+ * to the tri-state. Anything unrecognised falls back to the platform default
+ * rather than silently widening a list to archived rows.
+ */
+declare function toArchiveFilter(value: unknown, fallback?: ArchiveFilterValue): ArchiveFilterValue;
+interface ArchiveFilterProps {
+    value: ArchiveFilterValue;
+    onValueChange: (value: ArchiveFilterValue) => void;
+    /**
+     * Per-state row counts, when the reader returns them (a facet query, a
+     * `total_count`). A count that is not honest is worse than none, so pass a
+     * key only when the number describes what the list would actually render.
+     */
+    counts?: Partial<Record<ArchiveFilterValue, number>>;
+    /** Shorter wording for a dense toolbar. Never a different meaning. */
+    labels?: Partial<Record<ArchiveFilterValue, string>>;
+    size?: "sm" | "md" | "lg";
+    className?: string;
+    /** Accessible name for the group. */
+    "aria-label"?: string;
+    disabled?: boolean;
+}
+/**
+ * The control. One click from "Active only" to seeing archived rows.
+ */
+declare function ArchiveFilter({ value, onValueChange, counts, labels, size, className, "aria-label": ariaLabel, disabled, }: ArchiveFilterProps): React.JSX.Element;
+
+/**
+ * ArchivedDisclosure — THE ARCHIVED-ITEMS LAW, card-list half.
+ * (`common-docs/policies/archived-items.md`, Arman 2026-09-09.)
+ *
+ * Every list over an entity that can be archived carries an archive control,
+ * it defaults to HIDING archived rows, and revealing them is one or two
+ * clicks — on the surface itself. There are exactly TWO implementations of
+ * that control in the platform, and both live in THIS package:
+ *
+ *   • `ArchiveFilter` — the tri-state segmented control (Active only /
+ *     Archived only / Active + archived) for table and browse surfaces whose
+ *     reader takes an archive parameter. Prefer it whenever the surface can
+ *     express the request server-side.
+ *   • `ArchivedDisclosure` — THIS component: a one-click "Archived (N)"
+ *     disclosure, closed by default, revealing the archived rows in place
+ *     underneath. For card lists, panels and pickers that are not table
+ *     shaped.
+ *
+ * Never invent a third. The disclosure was proven first in matrx-frontend's
+ * Transcript Studio, lived as `components/official/ArchivedDisclosure` there,
+ * and moved here (0.14.0) verbatim so every client inherits the same control
+ * instead of re-growing it per app.
+ *
+ * Both controls share one vocabulary: `ARCHIVE_LABEL` is the single noun, and
+ * `archiveFilterFromDisclosure(open)` says a disclosure's state in the
+ * tri-state words for a host whose toggle IS a server request.
+ *
+ * Two shapes, one primitive:
+ *
+ *   <ArchivedDisclosure count={n} open={open} onOpenChange={setOpen}>
+ *     …archived rows…
+ *   </ArchivedDisclosure>
+ *
+ * renders the button AND the revealed block. Omit `children` when the caller
+ * merges the archived rows into an existing table/grid itself — the button is
+ * then the whole control.
+ *
+ * The count is ALWAYS the true number of archived rows the surface holds. A
+ * screen never lies: when there is nothing archived the control renders
+ * nothing at all rather than an empty promise. A surface whose archive view is
+ * a SERVER request (the rows below the button are the archived page itself,
+ * not children of it) passes `keepWhileOpen` so the revealed view never loses
+ * its way back.
+ *
+ * `countLabel` exists for the one case a bare integer cannot tell the truth: a
+ * server-side count that hit its cap (render `"12+"`), or a count that has not
+ * landed yet (pass `null` and no parenthetical is printed at all).
+ */
+
+interface ArchivedDisclosureProps {
+    /** True number of archived rows this surface holds. 0 renders nothing. */
+    count: number;
+    /** Whether archived rows are currently revealed. */
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /**
+     * The archived rows. Omit when the host merges them into its own list and
+     * only needs the toggle.
+     */
+    children?: React.ReactNode;
+    /** Noun for the rows, so the button reads in the surface's own words. */
+    label?: string;
+    /**
+     * Override the parenthetical. A string replaces the number (`"12+"` for a
+     * capped server count); `null` prints no parenthetical at all, for a count
+     * that has not arrived yet. Omit it and the honest `count` is printed.
+     */
+    countLabel?: string | null;
+    /**
+     * Keep the control rendered while `open` even at `count === 0`. For surfaces
+     * where opening SWITCHES the list to the archive (a server-side filter)
+     * rather than nesting rows inside this component: without it the way back
+     * would vanish the moment the count read zero or had not landed.
+     */
+    keepWhileOpen?: boolean;
+    className?: string;
+    contentClassName?: string;
+}
+declare function ArchivedDisclosure({ count, open, onOpenChange, children, label, countLabel, keepWhileOpen, className, contentClassName, }: ArchivedDisclosureProps): React.JSX.Element | null;
+
 declare const Select: React.FC<SelectPrimitive.SelectProps>;
 declare const SelectGroup: React.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React.RefAttributes<HTMLDivElement>>;
 declare const SelectValue: React.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>>;
@@ -1976,4 +2128,4 @@ declare const ALL_MOTION_CLASSES: readonly ["matrx-motion-overlay", "matrx-motio
  */
 declare const FORBIDDEN_HOST_MOTION_UTILITIES: readonly ["animate-in", "animate-out", "fade-in", "fade-out", "zoom-in", "zoom-out", "slide-in-from", "slide-out-to", "animate-accordion", "animate-slide-down", "animate-slide-up", "animate-pulse", "animate-spin"];
 
-export { ALL_MOTION_CLASSES, Accordion, AccordionContent, AccordionItem, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogContentPrimitive, type AlertDialogContentProps, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, Avatar, AvatarFallback, AvatarImage, type AvatarProps, type AvatarSize, Badge, type BadgeProps, BasicInput, BasicTextarea, BottomSheet, BottomSheetBody, type BottomSheetBodyProps, BottomSheetFooter, type BottomSheetFooterProps, BottomSheetHeader, type BottomSheetHeaderProps, type BottomSheetProps, Button, type ButtonProps, CENTERED_DIALOG, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSize, CardTitle, Checkbox, type CheckboxProps, type CheckboxSize, Collapsible, CollapsibleContent, type CollapsibleContentProps, CollapsibleTrigger, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmDialog, ConfirmDialogHost, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, type ContextMenuContentProps, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type CreatableOption, CreatablePicker, type CreatablePickerProps, DEFAULT_SCORE_THRESHOLDS, Dialog, DialogClose, DialogContent, DialogContentPrimitive, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerContentPrimitive, type DrawerContentProps, DrawerDescription, type DrawerDirection, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, type DrawerProps, type DrawerSize, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EditableLabel, type EditableLabelActivation, type EditableLabelCommitMode, type EditableLabelProps, EnterInput, type EnterInputProps, FORBIDDEN_HOST_MOTION_UTILITIES, HoverCard, HoverCardContent, type HoverCardContentProps, HoverCardTrigger, Input, type InputProps, type InputVariant, InputWithPrefix, type InputWithPrefixProps, Label, MOBILE_BREAKPOINT, MOTION_BOTTOM_SHEET, MOTION_DIALOG, MOTION_OVERLAY, MOTION_POPPER, MOTION_PULSE, MOTION_SHEET, MOTION_SPIN, OrganizationAbbreviation, OrganizationPicker, type OrganizationPickerOrganization, type OrganizationPickerProps, OverflowToolbar, type OverflowToolbarProps, POPPER_OFFSET, type PickerIcon, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, PortalContainerProvider, type PortalContainerProviderProps, Progress, type ProgressProps, type ProgressTone, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSize, RadixDialogModalProvider, type RadixDialogModalProviderProps, ResizableHandle, type ResizableHandleProps, type ResizableHandleSize, ResizablePanel, ResizablePanelGroup, ScoreRing, type ScoreRingProps, type ScoreThresholds, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollFadeState, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Switch, type SwitchProps, type SwitchSize, TabbedBottomSheet, type TabbedBottomSheetProps, type TabbedBottomSheetTab, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableSize, Tabs, TabsContent, TabsList, TabsTrigger, TabsTriggerCore, Textarea, type TextareaProps, TextareaWithPrefix, type TextareaWithPrefixProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, type ToolbarAction, type ToolbarActionTone, type ToolbarIcon, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseScrollFadeResult, alertVariants, badgeVariants, buttonVariants, cn, scoreAccentBgClasses, scoreRingColorClasses, selectTriggerVariants, sheetVariants, toggleVariants, useAccordionSize, useCardSize, useDialogContainer, useDrawerDirection, useIsMobile, usePortalContainer, useRadixDialogModal, useScrollFade, useTableSize };
+export { ALL_MOTION_CLASSES, ARCHIVE_FILTER_LABELS, ARCHIVE_FILTER_VALUES, ARCHIVE_LABEL, Accordion, AccordionContent, AccordionItem, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogContentPrimitive, type AlertDialogContentProps, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, ArchiveFilter, type ArchiveFilterProps, type ArchiveFilterValue, ArchivedDisclosure, type ArchivedDisclosureProps, Avatar, AvatarFallback, AvatarImage, type AvatarProps, type AvatarSize, Badge, type BadgeProps, BasicInput, BasicTextarea, BottomSheet, BottomSheetBody, type BottomSheetBodyProps, BottomSheetFooter, type BottomSheetFooterProps, BottomSheetHeader, type BottomSheetHeaderProps, type BottomSheetProps, Button, type ButtonProps, CENTERED_DIALOG, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSize, CardTitle, Checkbox, type CheckboxProps, type CheckboxSize, Collapsible, CollapsibleContent, type CollapsibleContentProps, CollapsibleTrigger, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmDialog, ConfirmDialogHost, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, type ContextMenuContentProps, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type CreatableOption, CreatablePicker, type CreatablePickerProps, DEFAULT_ARCHIVE_FILTER, DEFAULT_SCORE_THRESHOLDS, Dialog, DialogClose, DialogContent, DialogContentPrimitive, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerContentPrimitive, type DrawerContentProps, DrawerDescription, type DrawerDirection, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, type DrawerProps, type DrawerSize, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EditableLabel, type EditableLabelActivation, type EditableLabelCommitMode, type EditableLabelProps, EnterInput, type EnterInputProps, FORBIDDEN_HOST_MOTION_UTILITIES, HoverCard, HoverCardContent, type HoverCardContentProps, HoverCardTrigger, Input, type InputProps, type InputVariant, InputWithPrefix, type InputWithPrefixProps, Label, MOBILE_BREAKPOINT, MOTION_BOTTOM_SHEET, MOTION_DIALOG, MOTION_OVERLAY, MOTION_POPPER, MOTION_PULSE, MOTION_SHEET, MOTION_SPIN, OrganizationAbbreviation, OrganizationPicker, type OrganizationPickerOrganization, type OrganizationPickerProps, OverflowToolbar, type OverflowToolbarProps, POPPER_OFFSET, type PickerIcon, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, PortalContainerProvider, type PortalContainerProviderProps, Progress, type ProgressProps, type ProgressTone, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSize, RadixDialogModalProvider, type RadixDialogModalProviderProps, ResizableHandle, type ResizableHandleProps, type ResizableHandleSize, ResizablePanel, ResizablePanelGroup, ScoreRing, type ScoreRingProps, type ScoreThresholds, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollFadeState, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Switch, type SwitchProps, type SwitchSize, TabbedBottomSheet, type TabbedBottomSheetProps, type TabbedBottomSheetTab, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableSize, Tabs, TabsContent, TabsList, TabsTrigger, TabsTriggerCore, Textarea, type TextareaProps, TextareaWithPrefix, type TextareaWithPrefixProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, type ToolbarAction, type ToolbarActionTone, type ToolbarIcon, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseScrollFadeResult, alertVariants, archiveFilterFromDisclosure, badgeVariants, buttonVariants, cn, scoreAccentBgClasses, scoreRingColorClasses, selectTriggerVariants, sheetVariants, toArchiveFilter, toggleVariants, useAccordionSize, useCardSize, useDialogContainer, useDrawerDirection, useIsMobile, usePortalContainer, useRadixDialogModal, useScrollFade, useTableSize };