@lateralus-ai/shipping-ui 2.0.0-dev.19 → 2.0.0-dev.21

package/dist/components/Tabs.d.ts

@@ -1,7 +1,7 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import * as TabsPrimitive from "@radix-ui/react-tabs";
 export type TabsType = "tabs" | "pills";
-/** Soft = search filters (filled idle). Solid = workflow shell (ghost idle, blue active). */
+/** Soft = search filters (filled idle, light accent active). Solid = list filters (grey-100 idle, blue-600 active). */
 export type TabsAppearance = "soft" | "solid";
 export type TabsProps = ComponentPropsWithoutRef<typeof TabsPrimitive.Root> & {
     type?: TabsType;

package/dist/domain/Filters/FilterDropdown.d.ts

@@ -0,0 +1,93 @@
+import { ComponentType, CSSProperties, ReactNode } from 'react';
+/** One selectable row at a leaf list. */
+export type FilterOption = {
+    value: string;
+    label: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+};
+export type FilterSelectionMode = "multi" | "single";
+/**
+ * Recursive submenu: options leaf, nested folders, or custom panel (e.g. date range).
+ */
+export type FilterSubmenuContent = {
+    type: "options";
+    /** Key into `selectedValuesBySelectionKey` / `onSelectOption` */
+    selectionKey: string;
+    /** `multi` (default) toggles; `single` is exclusive — still one check slot reserved. */
+    selectionMode?: FilterSelectionMode;
+    options: FilterOption[];
+} | {
+    type: "nested";
+    items: FilterNestedItem[];
+} | {
+    type: "custom";
+    render: () => ReactNode;
+};
+export type FilterNestedItem = {
+    id: string;
+    label: string;
+    content: FilterSubmenuContent;
+};
+/** Left column row that opens a (possibly nested) submenu on the right. */
+export type FilterCategorySubmenuRow = {
+    kind?: "submenu";
+    id: string;
+    label: string;
+    content: FilterSubmenuContent;
+};
+/** Left column row: inline check toggle (no right panel). */
+export type FilterCategoryToggleRow = {
+    kind: "toggle";
+    id: string;
+    label: string;
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+};
+export type FilterCategoryRow = FilterCategorySubmenuRow | FilterCategoryToggleRow;
+type ResolvedSubmenuView = {
+    kind: "folders";
+    items: FilterNestedItem[];
+    trail: string[];
+} | {
+    kind: "options";
+    selectionKey: string;
+    selectionMode: FilterSelectionMode;
+    options: FilterOption[];
+    trail: string[];
+} | {
+    kind: "custom";
+    render: () => ReactNode;
+    trail: string[];
+};
+/** Walk `path` (folder ids) from `content` to the current view. */
+export declare function resolveSubmenuView(content: FilterSubmenuContent, path: string[]): ResolvedSubmenuView;
+export type FilterDropdownProps = {
+    align?: "start" | "center" | "end";
+    sideOffset?: number;
+    /** Left column: submenu roots and/or toggles. */
+    categoryRows: FilterCategoryRow[];
+    selectedValuesBySelectionKey: Record<string, string[] | undefined>;
+    /**
+     * Fired when an option is activated. For `multi`, consumers typically toggle;
+     * for `single`, replace the selection with `[optionValue]`.
+     */
+    onSelectOption: (selectionKey: string, optionValue: string) => void;
+    onResetAll: () => void;
+    resetAllLabel?: string;
+    activeFilterCount: number;
+    getOptionLabelStyle?: (selectionKey: string, optionValue: string) => CSSProperties | undefined;
+    zIndexClass?: string;
+    /** Replace the default FilterPill trigger. */
+    trigger?: ReactNode;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    className?: string;
+};
+/**
+ * Filters trigger + two-column popover (audit-prep pattern).
+ * Supports multi/single option leaves, nested folders, custom panels, and toggles.
+ */
+export declare function FilterDropdown({ align, sideOffset, categoryRows, selectedValuesBySelectionKey, onSelectOption, onResetAll, resetAllLabel, activeFilterCount, getOptionLabelStyle, zIndexClass, trigger, open: openControlled, onOpenChange, className, }: FilterDropdownProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/domain/Filters/FilterPill.d.ts

@@ -1,6 +1,13 @@
-export type FilterPillIndicator = "on" | "off";
-export type FilterPillProps = {
-    indicator?: FilterPillIndicator;
-    className?: string;
+import { ButtonHTMLAttributes } from 'react';
+export type FilterPillProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> & {
+    /** When > 0, trigger uses active (blue) fill and shows a count badge. */
+    activeFilterCount?: number;
 };
-export declare const FilterPill: ({ indicator, className }: FilterPillProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Filter trigger — Figma Filter Pill (6154:149608 / 6154:149599).
+ * Idle: grey-100. Active: accent blue-100 + orange count badge.
+ */
+export declare const FilterPill: import('react').ForwardRefExoticComponent<Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> & {
+    /** When > 0, trigger uses active (blue) fill and shows a count badge. */
+    activeFilterCount?: number;
+} & import('react').RefAttributes<HTMLButtonElement>>;

package/dist/domain/Filters/FilterPills.d.ts

@@ -0,0 +1,21 @@
+import { FilteredPillProps } from './FilteredPill';
+export type FilterPillsItem = {
+    key: string;
+    label: string;
+    onRemove: () => void;
+    removeAriaLabel?: string;
+    classNames?: FilteredPillProps["classNames"];
+};
+export type FilterPillsProps = {
+    chips: FilterPillsItem[];
+    className?: string;
+};
+/**
+ * Partner row for FilterDropdown — active filter pills.
+ * Lives outside the dropdown DOM so callers can place it anywhere
+ * (same row, new row, sticky footer, etc.).
+ *
+ * Multi-select chip *content* (when to show, label format) is owned by the
+ * consumer; use `formatActiveFilterChipLabel` for audit-prep-style labels.
+ */
+export declare const FilterPills: ({ chips, className }: FilterPillsProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/domain/Filters/FilteredPill.d.ts

@@ -1,8 +1,18 @@
-export type FilteredPillState = "idle" | "hover";
 export type FilteredPillProps = {
-    label?: string;
-    count?: number;
-    state?: FilteredPillState;
+    label: string;
+    onRemove: () => void;
+    removeAriaLabel?: string;
     className?: string;
+    /** Optional tone overrides (e.g. criticality-colored chips). */
+    classNames?: {
+        root?: string;
+        label?: string;
+        remove?: string;
+    };
 };
-export declare const FilteredPill: ({ label, count, state, className, }: FilteredPillProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Active filter value pill — Figma Filtered (6154:149787).
+ * Clear control on the left, label on the right. Partner to FilterDropdown;
+ * render via FilterPills outside the dropdown DOM.
+ */
+export declare const FilteredPill: ({ label, onRemove, removeAriaLabel, className, classNames, }: FilteredPillProps) => import("react/jsx-runtime").JSX.Element;

package/dist/domain/Filters/formatActiveFilterChipLabel.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Format the user-visible label for an active-filter chip (audit-prep rules).
+ *
+ * - 0 selected → "" (caller should not render)
+ * - 1 selected → `<filterName> (<value>)`
+ * - 2 selected → `<filterName> (<v1>, <v2>)`
+ * - 3+ selected → `<filterName> (<v1>, <v2>...)` (literal `...`)
+ *
+ * `selectedLabels` are already human-readable, in selection order.
+ */
+export declare function formatActiveFilterChipLabel(filterName: string, selectedLabels: string[]): string;

package/dist/domain/Filters/index.d.ts

@@ -1,3 +1,8 @@
-export { FiltersBar, type FiltersBarFilters, type FiltersBarProps, type FiltersBarTabs } from './FiltersBar';
-export { FilteredPill, type FilteredPillProps, type FilteredPillState } from './FilteredPill';
-export { FilterPill, type FilterPillIndicator, type FilterPillProps } from './FilterPill';
+export { FiltersBar, type FiltersBarFilters, type FiltersBarProps, type FiltersBarTabs, } from './FiltersBar';
+export { FilteredPill, type FilteredPillProps, } from './FilteredPill';
+export { FilterPill, type FilterPillProps, } from './FilterPill';
+export { FilterPills, type FilterPillsItem, type FilterPillsProps, } from './FilterPills';
+export { FilterDropdown, resolveSubmenuView, type FilterCategoryRow, type FilterCategorySubmenuRow, type FilterCategoryToggleRow, type FilterDropdownProps, type FilterNestedItem, type FilterOption, type FilterSelectionMode, type FilterSubmenuContent, } from './FilterDropdown';
+export { formatActiveFilterChipLabel } from './formatActiveFilterChipLabel';
+/** @deprecated Use `activeFilterCount` on FilterPill instead. */
+export type FilterPillIndicator = "on" | "off";