themelia-ui 1.0.0

package/dist/components/features/filters/filters.strings.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Filter copy.
+ *
+ * Interpolating values are FUNCTIONS rather than `"{count} selected"` templates. A
+ * template needs a runtime interpolator, cannot be type-checked, and — the reason that
+ * matters — cannot reorder its parts, which several languages need. A function can.
+ */
+export interface FilterOperatorStrings {
+    contains: string;
+    equals: string;
+    notContains: string;
+    is: string;
+    isNot: string;
+    greaterThan: string;
+    lessThan: string;
+    before: string;
+    after: string;
+    between: string;
+    has: string;
+    hasAny: string;
+    hasAll: string;
+}
+export interface FilterStrings {
+    loading: string;
+    loadingOptions: (filterLabel: string) => string;
+    addFilter: string;
+    clear: string;
+    /** Names the pill's value segment, which opens the editor. */
+    edit: string;
+    confirm: string;
+    clearFilters: string;
+    selectDate: string;
+    searchPlaceholder: (filterLabel: string) => string;
+    noOptionsFound: string;
+    selected: (count: number, filterLabel: string) => string;
+    /** The pill's value segment before anything has been picked. */
+    nothingSelected: string;
+    enterTags: string;
+    searchFilters: string;
+    noFiltersAvailable: string;
+    availableFilters: string;
+    activeFilters: string;
+    backToFilters: string;
+    options: (count: number) => string;
+    operator: string;
+    operators: FilterOperatorStrings;
+    min: string;
+    max: string;
+    fetchError: string;
+    retryFetch: string;
+    minQueryHint: (min: number) => string;
+    searching: string;
+    error: {
+        title: string;
+        describe: (filterKey?: string) => string;
+        retry: string;
+    };
+    validation: {
+        required: string;
+        minValue: (min: number) => string;
+        maxValue: (max: number) => string;
+        invalidFormat: string;
+    };
+}
+export declare const defaultFilterStrings: FilterStrings;

package/dist/components/features/filters/filters.types.d.cts

@@ -0,0 +1,191 @@
+import { ReactNode } from 'react';
+import { FilterStrings } from './filters.strings.cjs';
+export declare const FilterType: {
+    readonly SELECT: "select";
+    readonly MULTI_SELECT: "multi_select";
+    readonly ASYNC_SELECT: "async_select";
+    readonly SEARCH: "search";
+    readonly RANGE: "range";
+    readonly DATE: "date";
+    readonly TAGS: "tags";
+};
+export type FilterType = (typeof FilterType)[keyof typeof FilterType];
+/** Named rather than a bare union, so a consumer writes `FilterOperator.IN` not `"in"`. */
+export declare const FilterOperator: {
+    readonly EQUALS: "equals";
+    readonly CONTAINS: "contains";
+    readonly IN: "in";
+    readonly NOT_IN: "not_in";
+    readonly NOT: "not";
+    readonly BEFORE: "before";
+    readonly AFTER: "after";
+    readonly BETWEEN: "between";
+    readonly GT: "gt";
+    readonly LT: "lt";
+    readonly GTE: "gte";
+    readonly LTE: "lte";
+    readonly HAS: "has";
+    readonly HAS_ANY: "has_any";
+    readonly HAS_ALL: "has_all";
+};
+export type FilterOperator = (typeof FilterOperator)[keyof typeof FilterOperator];
+export interface OperatorOption {
+    label: string;
+    value: FilterOperator;
+}
+/**
+ * Where a filter lives in the bar.
+ *
+ * `always` keeps its pill on screen even with no value — for the one or two filters a
+ * screen is really about. `collapsed` hides it behind the add button until it has one.
+ * `hidden` keeps it out of the UI entirely while still applying, which is how a screen
+ * scopes a list to the current account.
+ */
+export type FilterDisplay = "always" | "collapsed" | "hidden";
+/** Where the editor was opened from, which decides whether there is a way back. */
+export type FilterTriggerSource = "toolbar" | "chip";
+export interface FilterOption {
+    label: string;
+    value: string;
+    icon?: ReactNode;
+    description?: string;
+    disabled?: boolean;
+}
+export interface DisplayConfig {
+    display?: FilterDisplay;
+    /** Lower sorts earlier in the bar. */
+    priority?: number;
+    hidden?: boolean;
+    className?: string;
+}
+export interface ValidationConfig {
+    min?: number;
+    max?: number;
+    pattern?: RegExp;
+    required?: boolean;
+    /** `true` passes; a string is the message; `false` is a generic failure. */
+    custom?: (value: unknown) => boolean | string;
+}
+/** This filter only applies once another one has a value. */
+export interface FilterDependency {
+    key: string;
+    operator: FilterOperator;
+    value: string | string[];
+}
+export interface FilterErrorContext {
+    phase: "fetch-options" | "apply" | "validate" | "render";
+    filterKey?: string;
+    /** React's component stack, when the error came from a render. */
+    info?: string;
+}
+export type FilterErrorHandler = (error: unknown, context: FilterErrorContext) => void;
+/**
+ * Async options for an `async_select`.
+ *
+ * One channel owning search, caching, abort, and preload — rather than a `loading` prop
+ * and an `options` prop the consumer has to keep in step by hand.
+ */
+export interface AsyncSelectConfig<TItem = unknown> {
+    fetcher: (args: {
+        query: string;
+        limit: number;
+        signal?: AbortSignal;
+    }) => Promise<TItem[]>;
+    /** Turns a fetched item into something the list can draw. */
+    mapToOption: {
+        bivarianceHack(item: TItem): FilterOption;
+    }["bivarianceHack"];
+    limit?: number;
+    /** Below this many characters nothing is fetched. */
+    minQueryLength?: number;
+    /** Fetch with an empty query as soon as the list opens. */
+    preload?: boolean;
+    debounceMs?: number;
+    /** How long a cached result stays fresh. */
+    staleTime?: number;
+}
+/**
+ * Infers the item type once and keeps it across `fetcher` and `mapToOption`.
+ *
+ * Without it a heterogeneous `FilterConfig[]` widens `TItem` to `unknown` and the mapper
+ * loses the shape its own fetcher just returned.
+ */
+export declare function defineAsyncSelectConfig<TItem>(config: AsyncSelectConfig<TItem>): AsyncSelectConfig<TItem>;
+export interface FilterConfig {
+    key: string;
+    label: string;
+    /** Used in "3 statuses selected". Falls back to `label`. */
+    pluralLabel?: string;
+    type: FilterType;
+    description?: string;
+    operator?: FilterOperator;
+    operators?: OperatorOption[];
+    options?: FilterOption[];
+    placeholder?: string;
+    /** Debounce for a `search` filter, in ms. */
+    delay?: number;
+    icon?: ReactNode;
+    displayConfig?: DisplayConfig;
+    defaultValue?: string[];
+    validation?: ValidationConfig;
+    dependencies?: FilterDependency[];
+    multiple?: boolean;
+    /** Closes the editor as soon as one option is picked. Single-select only. */
+    closeOnSelect?: boolean;
+    maxSelected?: number;
+    asyncConfig?: AsyncSelectConfig;
+    dateFormat?: {
+        /** date-fns pattern for the pill. */
+        display?: string;
+        /** date-fns pattern for the stored value — what the server sees. */
+        param?: string;
+    };
+    /** Replaces the default rendering of the value in the pill. */
+    format?: (value: string[]) => string;
+}
+/** One filter, applied. */
+export interface ActiveFilter {
+    id: string;
+    key: string;
+    operator: FilterOperator;
+    value: string[];
+}
+export interface FilterState {
+    [key: string]: string[];
+}
+export interface FilterTabPreset {
+    key: string;
+    value: string[];
+    operator?: FilterOperator;
+}
+/** A saved set of filters, offered as a tab above the bar. */
+export interface FilterTab {
+    id: string;
+    label: string;
+    presets: FilterTabPreset[];
+    count?: number;
+}
+export interface FilterContextValue {
+    activeFilters: ActiveFilter[];
+    filters: FilterConfig[];
+    addFilter: (filter: ActiveFilter) => void;
+    removeFilter: (key: string) => void;
+    updateFilter: (key: string, updates: Partial<ActiveFilter>) => void;
+    clearFilters: () => void;
+    replaceFilters: (filters: ActiveFilter[]) => void;
+    getFilterByKey: (key: string) => FilterConfig | undefined;
+    getFilterValue: (key: string) => string[];
+    setFilterValue: (key: string, value: string[]) => void;
+    isFilterActive: (key: string) => boolean;
+    getFilterOperator: (key: string) => FilterOperator;
+    setFilterOperator: (key: string, operator: FilterOperator) => void;
+    validateFilter: (key: string, value: unknown) => boolean | string;
+    getDependentFilters: (key: string) => FilterConfig[];
+    /** A change is in flight — the bar dims rather than pretending it has applied. */
+    isNavigating: boolean;
+    strings: FilterStrings;
+    /** Remembers labels an async filter resolved, so a pill can name its own value. */
+    cacheAsyncOptions: (filterKey: string, options: FilterOption[]) => void;
+    getAsyncOptionLabel: (filterKey: string, value: string) => string | undefined;
+    reportError: FilterErrorHandler;
+}

package/dist/components/features/filters/filters.types.d.ts

@@ -0,0 +1,191 @@
+import { ReactNode } from 'react';
+import { FilterStrings } from './filters.strings.js';
+export declare const FilterType: {
+    readonly SELECT: "select";
+    readonly MULTI_SELECT: "multi_select";
+    readonly ASYNC_SELECT: "async_select";
+    readonly SEARCH: "search";
+    readonly RANGE: "range";
+    readonly DATE: "date";
+    readonly TAGS: "tags";
+};
+export type FilterType = (typeof FilterType)[keyof typeof FilterType];
+/** Named rather than a bare union, so a consumer writes `FilterOperator.IN` not `"in"`. */
+export declare const FilterOperator: {
+    readonly EQUALS: "equals";
+    readonly CONTAINS: "contains";
+    readonly IN: "in";
+    readonly NOT_IN: "not_in";
+    readonly NOT: "not";
+    readonly BEFORE: "before";
+    readonly AFTER: "after";
+    readonly BETWEEN: "between";
+    readonly GT: "gt";
+    readonly LT: "lt";
+    readonly GTE: "gte";
+    readonly LTE: "lte";
+    readonly HAS: "has";
+    readonly HAS_ANY: "has_any";
+    readonly HAS_ALL: "has_all";
+};
+export type FilterOperator = (typeof FilterOperator)[keyof typeof FilterOperator];
+export interface OperatorOption {
+    label: string;
+    value: FilterOperator;
+}
+/**
+ * Where a filter lives in the bar.
+ *
+ * `always` keeps its pill on screen even with no value — for the one or two filters a
+ * screen is really about. `collapsed` hides it behind the add button until it has one.
+ * `hidden` keeps it out of the UI entirely while still applying, which is how a screen
+ * scopes a list to the current account.
+ */
+export type FilterDisplay = "always" | "collapsed" | "hidden";
+/** Where the editor was opened from, which decides whether there is a way back. */
+export type FilterTriggerSource = "toolbar" | "chip";
+export interface FilterOption {
+    label: string;
+    value: string;
+    icon?: ReactNode;
+    description?: string;
+    disabled?: boolean;
+}
+export interface DisplayConfig {
+    display?: FilterDisplay;
+    /** Lower sorts earlier in the bar. */
+    priority?: number;
+    hidden?: boolean;
+    className?: string;
+}
+export interface ValidationConfig {
+    min?: number;
+    max?: number;
+    pattern?: RegExp;
+    required?: boolean;
+    /** `true` passes; a string is the message; `false` is a generic failure. */
+    custom?: (value: unknown) => boolean | string;
+}
+/** This filter only applies once another one has a value. */
+export interface FilterDependency {
+    key: string;
+    operator: FilterOperator;
+    value: string | string[];
+}
+export interface FilterErrorContext {
+    phase: "fetch-options" | "apply" | "validate" | "render";
+    filterKey?: string;
+    /** React's component stack, when the error came from a render. */
+    info?: string;
+}
+export type FilterErrorHandler = (error: unknown, context: FilterErrorContext) => void;
+/**
+ * Async options for an `async_select`.
+ *
+ * One channel owning search, caching, abort, and preload — rather than a `loading` prop
+ * and an `options` prop the consumer has to keep in step by hand.
+ */
+export interface AsyncSelectConfig<TItem = unknown> {
+    fetcher: (args: {
+        query: string;
+        limit: number;
+        signal?: AbortSignal;
+    }) => Promise<TItem[]>;
+    /** Turns a fetched item into something the list can draw. */
+    mapToOption: {
+        bivarianceHack(item: TItem): FilterOption;
+    }["bivarianceHack"];
+    limit?: number;
+    /** Below this many characters nothing is fetched. */
+    minQueryLength?: number;
+    /** Fetch with an empty query as soon as the list opens. */
+    preload?: boolean;
+    debounceMs?: number;
+    /** How long a cached result stays fresh. */
+    staleTime?: number;
+}
+/**
+ * Infers the item type once and keeps it across `fetcher` and `mapToOption`.
+ *
+ * Without it a heterogeneous `FilterConfig[]` widens `TItem` to `unknown` and the mapper
+ * loses the shape its own fetcher just returned.
+ */
+export declare function defineAsyncSelectConfig<TItem>(config: AsyncSelectConfig<TItem>): AsyncSelectConfig<TItem>;
+export interface FilterConfig {
+    key: string;
+    label: string;
+    /** Used in "3 statuses selected". Falls back to `label`. */
+    pluralLabel?: string;
+    type: FilterType;
+    description?: string;
+    operator?: FilterOperator;
+    operators?: OperatorOption[];
+    options?: FilterOption[];
+    placeholder?: string;
+    /** Debounce for a `search` filter, in ms. */
+    delay?: number;
+    icon?: ReactNode;
+    displayConfig?: DisplayConfig;
+    defaultValue?: string[];
+    validation?: ValidationConfig;
+    dependencies?: FilterDependency[];
+    multiple?: boolean;
+    /** Closes the editor as soon as one option is picked. Single-select only. */
+    closeOnSelect?: boolean;
+    maxSelected?: number;
+    asyncConfig?: AsyncSelectConfig;
+    dateFormat?: {
+        /** date-fns pattern for the pill. */
+        display?: string;
+        /** date-fns pattern for the stored value — what the server sees. */
+        param?: string;
+    };
+    /** Replaces the default rendering of the value in the pill. */
+    format?: (value: string[]) => string;
+}
+/** One filter, applied. */
+export interface ActiveFilter {
+    id: string;
+    key: string;
+    operator: FilterOperator;
+    value: string[];
+}
+export interface FilterState {
+    [key: string]: string[];
+}
+export interface FilterTabPreset {
+    key: string;
+    value: string[];
+    operator?: FilterOperator;
+}
+/** A saved set of filters, offered as a tab above the bar. */
+export interface FilterTab {
+    id: string;
+    label: string;
+    presets: FilterTabPreset[];
+    count?: number;
+}
+export interface FilterContextValue {
+    activeFilters: ActiveFilter[];
+    filters: FilterConfig[];
+    addFilter: (filter: ActiveFilter) => void;
+    removeFilter: (key: string) => void;
+    updateFilter: (key: string, updates: Partial<ActiveFilter>) => void;
+    clearFilters: () => void;
+    replaceFilters: (filters: ActiveFilter[]) => void;
+    getFilterByKey: (key: string) => FilterConfig | undefined;
+    getFilterValue: (key: string) => string[];
+    setFilterValue: (key: string, value: string[]) => void;
+    isFilterActive: (key: string) => boolean;
+    getFilterOperator: (key: string) => FilterOperator;
+    setFilterOperator: (key: string, operator: FilterOperator) => void;
+    validateFilter: (key: string, value: unknown) => boolean | string;
+    getDependentFilters: (key: string) => FilterConfig[];
+    /** A change is in flight — the bar dims rather than pretending it has applied. */
+    isNavigating: boolean;
+    strings: FilterStrings;
+    /** Remembers labels an async filter resolved, so a pill can name its own value. */
+    cacheAsyncOptions: (filterKey: string, options: FilterOption[]) => void;
+    getAsyncOptionLabel: (filterKey: string, value: string) => string | undefined;
+    reportError: FilterErrorHandler;
+}

package/dist/components/features/filters/index.d.cts

@@ -0,0 +1,21 @@
+export { FilterErrorBoundary, type FilterErrorBoundaryProps, } from './filter-error-boundary.cjs';
+export { FilterProvider, type FilterProviderProps } from './filter-context.cjs';
+export { FilterLayout, type FilterLayoutProps } from './filter-layout.cjs';
+export { FilterPill, type FilterPillProps } from './filter-pill.cjs';
+export { FiltersButton, type FiltersButtonProps } from './filters-button.cjs';
+export { FilterTabs, type FilterTabsProps } from './filter-tabs.cjs';
+export { SearchFilter, SearchFilters, type SearchFilterProps, type SearchFiltersProps, } from './search-filters.cjs';
+export { FilterValueDisplay, type FilterValueDisplayProps, } from './filter-value-display.cjs';
+export { FilterOperatorSelect, type FilterOperatorSelectProps, } from './filter-operator-select.cjs';
+export { AsyncFilterEditor, DateFilterEditor, FilterEditor, RangeFilterEditor, SelectFilterEditor, TagsFilterEditor, type FilterEditorProps, } from './filter-editors.cjs';
+export { useFilterGroups, type UseFilterGroupsOptions, type UseFilterGroupsResult, } from './use-filter-groups.cjs';
+export { createFilterCache, useFilterCache, type FilterCache } from './filter-cache.cjs';
+export { useAsyncOptions, type UseAsyncOptionsResult } from './use-async-options.cjs';
+export { getDateOperators, getDefaultOperatorForType, getNumberOperators, getOperatorsForType, getSelectOperators, getTagsOperators, getTextOperators, } from './filter-operators.cjs';
+export { formatFilterValue, getFilterOption, validateFilterValue } from './filter-utils.cjs';
+export { mergeFilterQuery, parseFiltersFromQuery, serializeFiltersToQuery, type FilterQueryArrayFormat, type FilterQueryInput, type FilterQueryOperatorMode, type FilterQueryOptions, type FilterQueryRecord, type FilterQueryValue, } from './filter-query.cjs';
+export { predicateValidator, zodValidator, type SafeParseSchema, } from './filter-validators.cjs';
+export { defaultFilterStrings, type FilterOperatorStrings, type FilterStrings, } from './filters.strings.cjs';
+export { FilterOperator, FilterType, defineAsyncSelectConfig } from './filters.types.cjs';
+export type { ActiveFilter, AsyncSelectConfig, DisplayConfig, FilterConfig, FilterContextValue, FilterDependency, FilterDisplay, FilterErrorContext, FilterErrorHandler, FilterOption, FilterState, FilterTab, FilterTabPreset, FilterTriggerSource, OperatorOption, ValidationConfig, } from './filters.types.cjs';
+export { useFilters } from './filter-store.cjs';

package/dist/components/features/filters/index.d.ts

@@ -0,0 +1,21 @@
+export { FilterErrorBoundary, type FilterErrorBoundaryProps, } from './filter-error-boundary.js';
+export { FilterProvider, type FilterProviderProps } from './filter-context.js';
+export { FilterLayout, type FilterLayoutProps } from './filter-layout.js';
+export { FilterPill, type FilterPillProps } from './filter-pill.js';
+export { FiltersButton, type FiltersButtonProps } from './filters-button.js';
+export { FilterTabs, type FilterTabsProps } from './filter-tabs.js';
+export { SearchFilter, SearchFilters, type SearchFilterProps, type SearchFiltersProps, } from './search-filters.js';
+export { FilterValueDisplay, type FilterValueDisplayProps, } from './filter-value-display.js';
+export { FilterOperatorSelect, type FilterOperatorSelectProps, } from './filter-operator-select.js';
+export { AsyncFilterEditor, DateFilterEditor, FilterEditor, RangeFilterEditor, SelectFilterEditor, TagsFilterEditor, type FilterEditorProps, } from './filter-editors.js';
+export { useFilterGroups, type UseFilterGroupsOptions, type UseFilterGroupsResult, } from './use-filter-groups.js';
+export { createFilterCache, useFilterCache, type FilterCache } from './filter-cache.js';
+export { useAsyncOptions, type UseAsyncOptionsResult } from './use-async-options.js';
+export { getDateOperators, getDefaultOperatorForType, getNumberOperators, getOperatorsForType, getSelectOperators, getTagsOperators, getTextOperators, } from './filter-operators.js';
+export { formatFilterValue, getFilterOption, validateFilterValue } from './filter-utils.js';
+export { mergeFilterQuery, parseFiltersFromQuery, serializeFiltersToQuery, type FilterQueryArrayFormat, type FilterQueryInput, type FilterQueryOperatorMode, type FilterQueryOptions, type FilterQueryRecord, type FilterQueryValue, } from './filter-query.js';
+export { predicateValidator, zodValidator, type SafeParseSchema, } from './filter-validators.js';
+export { defaultFilterStrings, type FilterOperatorStrings, type FilterStrings, } from './filters.strings.js';
+export { FilterOperator, FilterType, defineAsyncSelectConfig } from './filters.types.js';
+export type { ActiveFilter, AsyncSelectConfig, DisplayConfig, FilterConfig, FilterContextValue, FilterDependency, FilterDisplay, FilterErrorContext, FilterErrorHandler, FilterOption, FilterState, FilterTab, FilterTabPreset, FilterTriggerSource, OperatorOption, ValidationConfig, } from './filters.types.js';
+export { useFilters } from './filter-store.js';

package/dist/components/features/filters/search-filters.d.cts

@@ -0,0 +1,11 @@
+import { FilterConfig } from './filters.types.cjs';
+export interface SearchFilterProps {
+    filter: FilterConfig;
+    className?: string;
+}
+export declare function SearchFilter({ filter, className }: SearchFilterProps): import("react").JSX.Element;
+export interface SearchFiltersProps {
+    filters: FilterConfig[];
+    className?: string;
+}
+export declare function SearchFilters({ filters, className }: SearchFiltersProps): import("react").JSX.Element | null;

package/dist/components/features/filters/search-filters.d.ts

@@ -0,0 +1,11 @@
+import { FilterConfig } from './filters.types.js';
+export interface SearchFilterProps {
+    filter: FilterConfig;
+    className?: string;
+}
+export declare function SearchFilter({ filter, className }: SearchFilterProps): import("react").JSX.Element;
+export interface SearchFiltersProps {
+    filters: FilterConfig[];
+    className?: string;
+}
+export declare function SearchFilters({ filters, className }: SearchFiltersProps): import("react").JSX.Element | null;

package/dist/components/features/filters/use-async-options.d.cts

@@ -0,0 +1,16 @@
+import { FilterConfig, FilterErrorHandler, FilterOption } from './filters.types.cjs';
+export interface UseAsyncOptionsResult {
+    options: FilterOption[];
+    /** The first load, with nothing to show yet. */
+    isLoading: boolean;
+    /** Any load, including a refresh over results already on screen. */
+    isFetching: boolean;
+    isError: boolean;
+    refetch: () => void;
+    /** The query is too short to search on. */
+    isBelowMinQuery: boolean;
+    minQueryLength: number;
+}
+export declare function useAsyncOptions(filter: FilterConfig, search: string, isActive: boolean, options?: {
+    onError?: FilterErrorHandler;
+}): UseAsyncOptionsResult;

package/dist/components/features/filters/use-async-options.d.ts

@@ -0,0 +1,16 @@
+import { FilterConfig, FilterErrorHandler, FilterOption } from './filters.types.js';
+export interface UseAsyncOptionsResult {
+    options: FilterOption[];
+    /** The first load, with nothing to show yet. */
+    isLoading: boolean;
+    /** Any load, including a refresh over results already on screen. */
+    isFetching: boolean;
+    isError: boolean;
+    refetch: () => void;
+    /** The query is too short to search on. */
+    isBelowMinQuery: boolean;
+    minQueryLength: number;
+}
+export declare function useAsyncOptions(filter: FilterConfig, search: string, isActive: boolean, options?: {
+    onError?: FilterErrorHandler;
+}): UseAsyncOptionsResult;

package/dist/components/features/filters/use-filter-groups.d.cts

@@ -0,0 +1,18 @@
+import { FilterConfig } from './filters.types.cjs';
+export interface UseFilterGroupsOptions {
+    /** Swaps a filter's options at render time, for options loaded by the parent. */
+    dynamicFilterOptions?: Record<string, FilterConfig["options"]>;
+}
+export interface UseFilterGroupsResult {
+    processedFilters: FilterConfig[];
+    /** Always inline, never in a pill — a search box IS its own control. */
+    searchFilters: FilterConfig[];
+    /** `display: "always"`, and currently empty. */
+    alwaysVisibleFilters: FilterConfig[];
+    activeFilters: FilterConfig[];
+    /** Everything else that is empty: behind the add button. */
+    popoverFilters: FilterConfig[];
+    activeFilterKeys: string[];
+    hasActive: boolean;
+}
+export declare function useFilterGroups({ dynamicFilterOptions, }?: UseFilterGroupsOptions): UseFilterGroupsResult;

package/dist/components/features/filters/use-filter-groups.d.ts

@@ -0,0 +1,18 @@
+import { FilterConfig } from './filters.types.js';
+export interface UseFilterGroupsOptions {
+    /** Swaps a filter's options at render time, for options loaded by the parent. */
+    dynamicFilterOptions?: Record<string, FilterConfig["options"]>;
+}
+export interface UseFilterGroupsResult {
+    processedFilters: FilterConfig[];
+    /** Always inline, never in a pill — a search box IS its own control. */
+    searchFilters: FilterConfig[];
+    /** `display: "always"`, and currently empty. */
+    alwaysVisibleFilters: FilterConfig[];
+    activeFilters: FilterConfig[];
+    /** Everything else that is empty: behind the add button. */
+    popoverFilters: FilterConfig[];
+    activeFilterKeys: string[];
+    hasActive: boolean;
+}
+export declare function useFilterGroups({ dynamicFilterOptions, }?: UseFilterGroupsOptions): UseFilterGroupsResult;

package/dist/components/features/global-search/global-search-dialog.d.cts

@@ -0,0 +1,9 @@
+import { GlobalSearchProps } from './global-search.types.cjs';
+export interface GlobalSearchDialogProps<TGroup extends string = string> extends Omit<GlobalSearchProps<TGroup>, "onClose"> {
+    open: boolean;
+    /** Fires on Escape, on a backdrop click, and after a result is chosen. */
+    onOpenChange: (open: boolean) => void;
+    /** Merged onto the dialog surface that positions the palette. */
+    contentClassName?: string;
+}
+export declare function GlobalSearchDialog<TGroup extends string = string>({ open, onOpenChange, contentClassName, className, strings, autoFocus, ...search }: GlobalSearchDialogProps<TGroup>): import("react").JSX.Element;

package/dist/components/features/global-search/global-search-dialog.d.ts

@@ -0,0 +1,9 @@
+import { GlobalSearchProps } from './global-search.types.js';
+export interface GlobalSearchDialogProps<TGroup extends string = string> extends Omit<GlobalSearchProps<TGroup>, "onClose"> {
+    open: boolean;
+    /** Fires on Escape, on a backdrop click, and after a result is chosen. */
+    onOpenChange: (open: boolean) => void;
+    /** Merged onto the dialog surface that positions the palette. */
+    contentClassName?: string;
+}
+export declare function GlobalSearchDialog<TGroup extends string = string>({ open, onOpenChange, contentClassName, className, strings, autoFocus, ...search }: GlobalSearchDialogProps<TGroup>): import("react").JSX.Element;

package/dist/components/features/global-search/global-search-empty-state.d.cts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+export interface GlobalSearchEmptyStateProps {
+    title: ReactNode;
+    /** One line of guidance. A dead end with no next move is the worst empty state. */
+    hint?: ReactNode;
+    className?: string;
+}
+export declare function GlobalSearchEmptyState({ title, hint, className }: GlobalSearchEmptyStateProps): import("react").JSX.Element;

package/dist/components/features/global-search/global-search-empty-state.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+export interface GlobalSearchEmptyStateProps {
+    title: ReactNode;
+    /** One line of guidance. A dead end with no next move is the worst empty state. */
+    hint?: ReactNode;
+    className?: string;
+}
+export declare function GlobalSearchEmptyState({ title, hint, className }: GlobalSearchEmptyStateProps): import("react").JSX.Element;

package/dist/components/features/global-search/global-search-footer.d.cts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+export interface GlobalSearchFooterProps {
+    navigateLabel: ReactNode;
+    openLabel: ReactNode;
+    closeLabel: ReactNode;
+    /** The Escape key's cap. Its two neighbours are glyphs; this one is a word. */
+    escKey: ReactNode;
+    /** Right-aligned content — the result count. */
+    trailing?: ReactNode;
+    className?: string;
+}
+export declare function GlobalSearchFooter({ navigateLabel, openLabel, closeLabel, escKey, trailing, className, }: GlobalSearchFooterProps): import("react").JSX.Element;

package/dist/components/features/global-search/global-search-footer.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+export interface GlobalSearchFooterProps {
+    navigateLabel: ReactNode;
+    openLabel: ReactNode;
+    closeLabel: ReactNode;
+    /** The Escape key's cap. Its two neighbours are glyphs; this one is a word. */
+    escKey: ReactNode;
+    /** Right-aligned content — the result count. */
+    trailing?: ReactNode;
+    className?: string;
+}
+export declare function GlobalSearchFooter({ navigateLabel, openLabel, closeLabel, escKey, trailing, className, }: GlobalSearchFooterProps): import("react").JSX.Element;