@persona/design-system 0.1.6 → 0.1.8

package/dist/lib/TruncatedTextWithTooltip.mjs

@@ -1,8 +1,8 @@
 import { useIsOverflow } from "./useIsOverflow.mjs";
 import { OverflowEllipsisSpan } from "./TruncatedText.mjs";
-import { a as Tooltip } from "../Tooltip-CDvOu1UN.mjs";
-import { useRef } from "react";
+import { a as Tooltip } from "../Tooltip-C6AR1xT-.mjs";
 import { jsx } from "react/jsx-runtime";
+import { useRef } from "react";
 //#region lib/TruncatedTextWithTooltip.tsx
 /**
 * Truncates the text if it is too long to fit in the container and shows a tooltip if the text

package/dist/lib/message.d.cts

@@ -1,2 +1,2 @@
-import { t as MessageType } from "../message-CWEGi3Xg.cjs";
+import { t as MessageType } from "../message-BEgtEjQC.cjs";
 export { MessageType };

package/dist/lib/message.d.mts

@@ -1,2 +1,2 @@
-import { t as MessageType } from "../message-SITKO6JZ.mjs";
+import { t as MessageType } from "../message-CMHvlPGn.mjs";
 export { MessageType };

package/dist/lib/pseudoClass.d.mts

@@ -1,4 +1,4 @@
-import { t as PseudoClassProps } from "../PseudoClassProps--MiDp2l2.mjs";
+import { t as PseudoClassProps } from "../PseudoClassProps-DLxPxo7T.mjs";
 
 //#region lib/pseudoClass.d.ts
 declare const isDisabled: ({

package/dist/{message-SITKO6JZ.d.mts → message-BEgtEjQC.d.cts}

@@ -6,4 +6,4 @@ declare enum MessageType {
 }
 //#endregion
 export { MessageType as t };
-//# sourceMappingURL=message-SITKO6JZ.d.mts.map
+//# sourceMappingURL=message-BEgtEjQC.d.cts.map

package/dist/{message-CWEGi3Xg.d.cts → message-CMHvlPGn.d.mts}

@@ -6,4 +6,4 @@ declare enum MessageType {
 }
 //#endregion
 export { MessageType as t };
-//# sourceMappingURL=message-CWEGi3Xg.d.cts.map
+//# sourceMappingURL=message-CMHvlPGn.d.mts.map

package/dist/mixins/focus.d.mts

@@ -1,4 +1,4 @@
-import { t as PseudoClassProps } from "../PseudoClassProps--MiDp2l2.mjs";
+import { t as PseudoClassProps } from "../PseudoClassProps-DLxPxo7T.mjs";
 import * as _$styled_components0 from "styled-components";
 
 //#region mixins/focus.d.ts

package/dist/mixins/hoverable.d.mts

@@ -1,5 +1,5 @@
-import { t as PseudoClassProps } from "../PseudoClassProps--MiDp2l2.mjs";
-import { i as Variant } from "../theme-q9fNLtcA.mjs";
+import { t as PseudoClassProps } from "../PseudoClassProps-DLxPxo7T.mjs";
+import { i as Variant } from "../theme-BzBpJXhO.mjs";
 import * as _$styled_components0 from "styled-components";
 
 //#region mixins/hoverable.d.ts

package/dist/mixins/input.d.cts

@@ -1,2 +1,2 @@
-import { n as InputSizes, r as inputMixin, t as InputMixinProps } from "../input-Bm_anD8X.cjs";
+import { n as InputSizes, r as inputMixin, t as InputMixinProps } from "../input-DPB0cX2m.cjs";
 export { InputMixinProps, InputSizes, inputMixin as default };

package/dist/mixins/input.d.mts

@@ -1,2 +1,2 @@
-import { n as InputSizes, r as inputMixin, t as InputMixinProps } from "../input-FEaQ66an.mjs";
+import { n as InputSizes, r as inputMixin, t as InputMixinProps } from "../input-Bv5fKt5J.mjs";
 export { InputMixinProps, InputSizes, inputMixin as default };

package/dist/mixins/menuItem.d.mts

@@ -1,5 +1,5 @@
-import { t as PseudoClassProps } from "../PseudoClassProps--MiDp2l2.mjs";
-import { i as Variant } from "../theme-q9fNLtcA.mjs";
+import { t as PseudoClassProps } from "../PseudoClassProps-DLxPxo7T.mjs";
+import { i as Variant } from "../theme-BzBpJXhO.mjs";
 import * as _$styled_components0 from "styled-components";
 
 //#region mixins/menuItem.d.ts

package/dist/mixins/text.d.mts

@@ -1,2 +1,2 @@
-import { a as displayMixins, c as paragraphMixins, i as ParagraphSize, n as HeadingSize, o as fontFamilyMixin, r as ParagraphMixinSize, s as headingMixins, t as DisplaySize } from "../text-BEKhEWTa.mjs";
+import { a as displayMixins, c as paragraphMixins, i as ParagraphSize, n as HeadingSize, o as fontFamilyMixin, r as ParagraphMixinSize, s as headingMixins, t as DisplaySize } from "../text-B21s9mRZ.mjs";
 export { DisplaySize, HeadingSize, ParagraphMixinSize, ParagraphSize, displayMixins, fontFamilyMixin, headingMixins, paragraphMixins };

package/dist/operators-1qE2GpC7.d.cts

@@ -0,0 +1,43 @@
+import { a as FilterField, c as FilterOperator, l as FilterRule, s as FilterFieldType, u as FilterRuleValue } from "./types-B_HHNlia.cjs";
+
+//#region components/DataTable/TableControls/FiltersV2/operators.d.ts
+declare function getOperatorsForType(type: FilterFieldType): ReadonlyArray<FilterOperator>;
+/**
+ * Effective operator vocabulary for a concrete field: its `allowedOperators`
+ * allow-list, or the field type's full vocabulary when the allow-list is
+ * absent or empty. An empty allow-list means "unconstrained" rather than
+ * "no operators" — the latter would leave the field selectable in the picker
+ * but incapable of producing a rule that passes validation.
+ *
+ * Prefer this over {@link getOperatorsForType} anywhere a real field is in
+ * hand — the popover's operator dropdown, `FieldRegistry`, validation — so a
+ * field can never surface an operator the host application can't serialize.
+ */
+declare function getOperatorsForField(field: Pick<FilterField, 'type' | 'allowedOperators'>): ReadonlyArray<FilterOperator>;
+declare function getDefaultOperatorForType(type: FilterFieldType): FilterOperator;
+declare function isValuelessOperator(operator: FilterOperator): boolean;
+/**
+ * Whether a concrete field's operator selector should be shown. A field
+ * pinned to one operator renders it as static text rather than a caret that
+ * opens a one-item menu.
+ */
+declare function fieldHasMultipleOperators(field: Pick<FilterField, 'type' | 'allowedOperators'>): boolean;
+declare function getOperatorLabel(operator: FilterOperator, fieldType?: FilterFieldType): string;
+/**
+ * Return a copy of `rule` whose `value` honors the valueless-operator
+ * invariant: any rule whose operator is in the valueless set
+ * (`is_empty`, `is_not_empty`) carries `value: null`. Use this anywhere
+ * a rule's value would otherwise drift out of sync with its operator —
+ * operator-change handlers, field-swap handlers, and defensive coercions
+ * before serialization.
+ */
+declare function withValue(rule: FilterRule, value: FilterRuleValue): FilterRule;
+/**
+ * Empty-but-present value seeded when a rule switches from a valueless operator
+ * (`is_empty`) to one that requires a value. Non-null on purpose: a `null` value
+ * reads as a removal and drops the pill mid-edit.
+ */
+declare function emptyValueForFieldType(type: FilterFieldType): FilterRuleValue;
+//#endregion
+export { getOperatorsForField as a, withValue as c, getOperatorLabel as i, fieldHasMultipleOperators as n, getOperatorsForType as o, getDefaultOperatorForType as r, isValuelessOperator as s, emptyValueForFieldType as t };
+//# sourceMappingURL=operators-1qE2GpC7.d.cts.map

package/dist/operators-Bo31xlc2.d.mts

@@ -0,0 +1,43 @@
+import { a as FilterField, c as FilterOperator, l as FilterRule, s as FilterFieldType, u as FilterRuleValue } from "./types-D58IoRx6.mjs";
+
+//#region components/DataTable/TableControls/FiltersV2/operators.d.ts
+declare function getOperatorsForType(type: FilterFieldType): ReadonlyArray<FilterOperator>;
+/**
+ * Effective operator vocabulary for a concrete field: its `allowedOperators`
+ * allow-list, or the field type's full vocabulary when the allow-list is
+ * absent or empty. An empty allow-list means "unconstrained" rather than
+ * "no operators" — the latter would leave the field selectable in the picker
+ * but incapable of producing a rule that passes validation.
+ *
+ * Prefer this over {@link getOperatorsForType} anywhere a real field is in
+ * hand — the popover's operator dropdown, `FieldRegistry`, validation — so a
+ * field can never surface an operator the host application can't serialize.
+ */
+declare function getOperatorsForField(field: Pick<FilterField, 'type' | 'allowedOperators'>): ReadonlyArray<FilterOperator>;
+declare function getDefaultOperatorForType(type: FilterFieldType): FilterOperator;
+declare function isValuelessOperator(operator: FilterOperator): boolean;
+/**
+ * Whether a concrete field's operator selector should be shown. A field
+ * pinned to one operator renders it as static text rather than a caret that
+ * opens a one-item menu.
+ */
+declare function fieldHasMultipleOperators(field: Pick<FilterField, 'type' | 'allowedOperators'>): boolean;
+declare function getOperatorLabel(operator: FilterOperator, fieldType?: FilterFieldType): string;
+/**
+ * Return a copy of `rule` whose `value` honors the valueless-operator
+ * invariant: any rule whose operator is in the valueless set
+ * (`is_empty`, `is_not_empty`) carries `value: null`. Use this anywhere
+ * a rule's value would otherwise drift out of sync with its operator —
+ * operator-change handlers, field-swap handlers, and defensive coercions
+ * before serialization.
+ */
+declare function withValue(rule: FilterRule, value: FilterRuleValue): FilterRule;
+/**
+ * Empty-but-present value seeded when a rule switches from a valueless operator
+ * (`is_empty`) to one that requires a value. Non-null on purpose: a `null` value
+ * reads as a removal and drops the pill mid-edit.
+ */
+declare function emptyValueForFieldType(type: FilterFieldType): FilterRuleValue;
+//#endregion
+export { getOperatorsForField as a, withValue as c, getOperatorLabel as i, fieldHasMultipleOperators as n, getOperatorsForType as o, getDefaultOperatorForType as r, isValuelessOperator as s, emptyValueForFieldType as t };
+//# sourceMappingURL=operators-Bo31xlc2.d.mts.map

package/dist/operators.d.cts

@@ -0,0 +1,2 @@
+import { a as getOperatorsForField, c as withValue, i as getOperatorLabel, n as fieldHasMultipleOperators, o as getOperatorsForType, r as getDefaultOperatorForType, s as isValuelessOperator, t as emptyValueForFieldType } from "./operators-1qE2GpC7.cjs";
+export { emptyValueForFieldType, fieldHasMultipleOperators, getDefaultOperatorForType, getOperatorLabel, getOperatorsForField, getOperatorsForType, isValuelessOperator, withValue };

package/dist/operators.d.mts

@@ -0,0 +1,2 @@
+import { a as getOperatorsForField, c as withValue, i as getOperatorLabel, n as fieldHasMultipleOperators, o as getOperatorsForType, r as getDefaultOperatorForType, s as isValuelessOperator, t as emptyValueForFieldType } from "./operators-Bo31xlc2.mjs";
+export { emptyValueForFieldType, fieldHasMultipleOperators, getDefaultOperatorForType, getOperatorLabel, getOperatorsForField, getOperatorsForType, isValuelessOperator, withValue };

package/dist/{text-BEKhEWTa.d.mts → text-B21s9mRZ.d.mts}

@@ -11,4 +11,4 @@ type ParagraphSize = 'lg' | 'md' | 'sm' | 'xs';
 declare const paragraphMixins: Record<ParagraphMixinSize, FlattenInterpolation<ThemeProps<DefaultTheme>>>;
 //#endregion
 export { displayMixins as a, paragraphMixins as c, ParagraphSize as i, HeadingSize as n, fontFamilyMixin as o, ParagraphMixinSize as r, headingMixins as s, DisplaySize as t };
-//# sourceMappingURL=text-BEKhEWTa.d.mts.map
+//# sourceMappingURL=text-B21s9mRZ.d.mts.map

package/dist/{theme-q9fNLtcA.d.mts → theme-BzBpJXhO.d.mts}

@@ -151,4 +151,4 @@ declare const darkTheme: PersonaTheme;
 declare const marketingFontTheme: PersonaTheme;
 //#endregion
 export { darkTheme as a, Variant as i, PersonaTheme as n, defaultTheme as o, TextColors as r, marketingFontTheme as s, BackgroundColors as t };
-//# sourceMappingURL=theme-q9fNLtcA.d.mts.map
+//# sourceMappingURL=theme-BzBpJXhO.d.mts.map

package/dist/theme.d.mts

@@ -1,2 +1,2 @@
-import { a as darkTheme, i as Variant, n as PersonaTheme, o as defaultTheme, r as TextColors, s as marketingFontTheme, t as BackgroundColors } from "./theme-q9fNLtcA.mjs";
+import { a as darkTheme, i as Variant, n as PersonaTheme, o as defaultTheme, r as TextColors, s as marketingFontTheme, t as BackgroundColors } from "./theme-BzBpJXhO.mjs";
 export { BackgroundColors, PersonaTheme, TextColors, Variant, darkTheme, defaultTheme as default, marketingFontTheme };

package/dist/types-B_HHNlia.d.cts

@@ -0,0 +1,158 @@
+//#region components/DataTable/TableControls/FiltersV2/types.d.ts
+/**
+ * Filter UI v2 — client-side state shape.
+ *
+ * Conceptual predicate (what the user sees in the bar):
+ *   AND_perField(...topLevelRules) AND OR(...compound.groups)
+ * where each `AndGroup` inside `compound.groups` is itself AND'd internally.
+ *
+ * - Simple pills compose into `topLevelRules`. Pills on DIFFERENT fields
+ *   are AND'd together; multiple pills on the SAME field are OR'd
+ *   together. AND'ing two equality predicates on a single field would
+ *   always return zero rows, so multi-pill-per-field naturally means
+ *   "is any of these values".
+ * - The Rules pill owns `compound.groups` (OR-of-AND / DNF).
+ */
+/** All available field types we render type-aware controls + operators for. */
+type FilterFieldType = 'string' | 'email' | 'choices' | 'multi_choices' | 'boolean' | 'integer' | 'float' | 'date' | 'array' /** OR-of-AND tag conditions (`FilterTagsCondition[][]`). */ | 'tags_conditions' /** ISO date range (`DateRangeFilterValue`). */ | 'date_range';
+/**
+ * Per-rule operator vocabulary.
+ *
+ * Not every operator is valid for every field. See `getOperatorsForField` in
+ * `./operators.ts` for the resolution the UI and `FieldRegistry` use to gate
+ * which operators are pickable in the Filter popover: a field's
+ * `allowedOperators`, or its type's vocabulary when that list is absent.
+ *
+ * Numeric range operators (`gt` / `lt`) are deliberately omitted from this
+ * union. When native `gt` / `lt` support exists, re-add them to this union,
+ * the per-type vocabulary in `operators.ts`, the label map, and the adapter's
+ * `normalizeValue` switch.
+ */
+type FilterOperator = 'is' | 'is_not' | 'contains' | 'does_not_contain' | 'is_empty' | 'is_not_empty' | 'is_true' | 'is_false' | 'before' | 'after';
+/** Whether a field is a system/built-in field or a custom field on a parent record type. */
+type FilterFieldSource = 'system' | 'custom';
+/**
+ * Static metadata for one filterable field, exposed by `FieldRegistry`.
+ *
+ * Shape is mostly derived from the backend's `field_key_to_info` payload.
+ * The registry tolerates missing metadata and falls back to `'string'`.
+ */
+interface FilterField {
+  /** Stable id used by `FilterRule.fieldId`. Backend's `field_key`. */
+  id: string;
+  /** Human-readable label rendered in the filter picker and pill. */
+  label: string;
+  /** Field type that drives operator vocabulary and value control rendering. */
+  type: FilterFieldType;
+  /** System vs custom — drives the popover footer affordance + picker grouping. */
+  source: FilterFieldSource;
+  /**
+   * For `choices` / `multi_choices`, the option list shown in the value control.
+   * Backend metadata `options`.
+   */
+  options?: ReadonlyArray<{
+    label: string;
+    value: string;
+  }>;
+  /**
+   * For `array` fields, the inner item type. Drives whether the value control
+   * is a text input vs. multi-select. Backend metadata `item_type`.
+   */
+  itemType?: FilterFieldType;
+  /**
+   * For custom fields, the human-readable parent-scope label (record type
+   * / Case template name). Display-only: the popover footer
+   * (`ⓘ [label] is a field on [parentRecordType]`) and the picker submenu
+   * grouping/sublabel. Narrowing keys off {@link parentRecordId}, not this
+   * label (labels can collide or carry a suffix). Backend `parent_record_type`.
+   */
+  parentRecordType?: string;
+  /**
+   * For custom fields, the parent scope's token (the public id the
+   * account-type / case-template records expose as `id`) — the
+   * picker-narrowing key. A selector field whose `options[].value`
+   * intersects the registry's `parentRecordId`s is inferred as a scoping
+   * selector, and an `is` pill on it narrows the picker to that scope.
+   * Matching on the token, not the label, keeps narrowing exact. Backend
+   * `parent_record_id`.
+   */
+  parentRecordId?: string;
+  /**
+   * Reserved slot for nested-path filtering (hash subfields). The frontend
+   * never produces a non-empty `path` today; this is shape-stable so that
+   * hash subfield support can land without a state migration once the backend
+   * `SearchAliasMap` decision is made.
+   */
+  path?: ReadonlyArray<string>;
+  /**
+   * Optional operator allow-list, for a field whose host can only serialize
+   * part of its type's vocabulary. When omitted or empty, the full per-type
+   * vocabulary from `operators.ts` applies.
+   */
+  allowedOperators?: ReadonlyArray<FilterOperator>;
+}
+/** ISO calendar-date range for legacy index date filters. */
+interface DateRangeFilterValue {
+  startDate?: string;
+  endDate?: string;
+}
+/** Value shape for a single rule. Matches the union the value controls produce. */
+type FilterRuleValue = string | ReadonlyArray<string> | number | boolean | null | DateRangeFilterValue | ReadonlyArray<ReadonlyArray<Record<string, unknown>>> | ReadonlyArray<ReadonlyArray<unknown>>;
+/** A single field/operator/value triple — one row in the Advanced Filter Rules editor. */
+interface FilterRule {
+  fieldId: string;
+  operator: FilterOperator;
+  value: FilterRuleValue;
+}
+/**
+ * A top-level (simple pill) rule. Carries a stable `id` so multiple
+ * pills for the same field can coexist — the "Add filter" picker
+ * always creates a new id rather than collapsing duplicate field
+ * selections back onto a single existing rule. `id` is local to the
+ * client state; it is not serialized to the backend payload.
+ */
+interface TopLevelFilterRule extends FilterRule {
+  id: string;
+}
+/** One AND group inside the compound expression. Rules inside are AND'd. */
+interface AndGroup {
+  rules: FilterRule[];
+}
+/**
+ * The compound expression owned by the Rules pill.
+ *
+ * Groups are OR'd (DNF). When `groups.length === 0` no compound predicate
+ * applies and the Rules pill still renders in its default `Rules ▾` state.
+ */
+interface CompoundExpression {
+  groups: AndGroup[];
+}
+/** Client-side state shape for the v2 filter UI. */
+interface FilterStateV2 {
+  /**
+   * Simple pills. Multiple pills for the same field remain distinct so
+   * host applications can preserve the user's filter expression.
+   */
+  topLevelRules: TopLevelFilterRule[];
+  /** Rules pill content. Empty `groups` means no compound rules are applied. */
+  compound: CompoundExpression;
+}
+/**
+ * Filter-bar size variant. Drives the size of every nested PDS component
+ * (Button, Input, Combobox, IconButton, etc.) plus the hand-tuned
+ * dimensions of the Filter UI v2 styled primitives (pill heights,
+ * font sizes, icon glyph sizes). Two values supported:
+ *
+ * - `'sm'` — 12px font, 12px icons, 24px-tall inputs/pills. Designed
+ *   for the compact DataTable layout.
+ * - `'md'` (default) — 14px font, 16px icons, 32px-tall inputs/pills. Designed
+ *   for the standard DataTable layout.
+ *
+ * The active default is owned by `FilterBar`'s `size` prop, not this type.
+ */
+type FilterSize = 'sm' | 'md';
+/** The empty state — no filters applied. */
+declare const EMPTY_FILTER_STATE: FilterStateV2;
+//#endregion
+export { FilterField as a, FilterOperator as c, FilterSize as d, FilterStateV2 as f, EMPTY_FILTER_STATE as i, FilterRule as l, CompoundExpression as n, FilterFieldSource as o, TopLevelFilterRule as p, DateRangeFilterValue as r, FilterFieldType as s, AndGroup as t, FilterRuleValue as u };
+//# sourceMappingURL=types-B_HHNlia.d.cts.map

package/dist/types-CCvc590y.d.cts

@@ -0,0 +1,45 @@
+import { a as FilterField, c as FilterOperator, u as FilterRuleValue } from "./types-B_HHNlia.cjs";
+import { ReactElement } from "react";
+
+//#region components/DataTable/TableControls/FiltersV2/value-controls/types.d.ts
+/**
+ * Shared contract for the type-aware value controls rendered inside the
+ * Filter UI v2 editing surfaces.
+ *
+ * One control per value-bearing `FilterFieldType`; boolean fields are
+ * operator-only (`is_true` / `is_false` / emptiness) and do not render a
+ * separate value control. Controls read the active operator and render
+ * nothing (or a disabled placeholder) when the operator is in the valueless
+ * set (`is_empty` / `is_not_empty`). Use `isValuelessOperator` from
+ * `../operators` to decide.
+ */
+interface ValueControlProps {
+  /** Field metadata from `FieldRegistry`. Drives placeholder/options. */
+  field: FilterField;
+  /**
+   * The currently selected operator for this rule. The control should be a
+   * no-op (render nothing or disable itself) when the operator is in the
+   * valueless set.
+   */
+  operator: FilterOperator;
+  /** Current value held by the rule. */
+  value: FilterRuleValue;
+  /** Called when the user commits a new value. */
+  onChange: (value: FilterRuleValue) => void;
+  /** Optional callback for controls that commit a complete selection in one action. */
+  onCommit?: () => void;
+  /** Aria label wired to the popover's labeling. */
+  ariaLabel?: string;
+  /** Optional external trigger that opens dropdown-backed value controls directly. */
+  trigger?: ReactElement;
+  /**
+   * Host surface — forwarded from `resolveValueControl`. `popover` (default)
+   * is the simple-rule `FilterPopover` slot; `inline` is the Advanced Filter
+   * Rules `LogicRow` dropdown. Combobox-backed controls use embedded mode only
+   * on the popover surface so Rules rows get a standard combobox chrome.
+   */
+  layout?: 'popover' | 'inline';
+}
+//#endregion
+export { ValueControlProps as t };
+//# sourceMappingURL=types-CCvc590y.d.cts.map

package/dist/{types-CmnKGG5I.d.cts → types-CkiXVJeR.d.cts}

@@ -7,4 +7,4 @@ interface PaginationParams {
 }
 //#endregion
 export { PaginationParams as t };
-//# sourceMappingURL=types-CmnKGG5I.d.cts.map
+//# sourceMappingURL=types-CkiXVJeR.d.cts.map

package/dist/types-D58IoRx6.d.mts

@@ -0,0 +1,158 @@
+//#region components/DataTable/TableControls/FiltersV2/types.d.ts
+/**
+ * Filter UI v2 — client-side state shape.
+ *
+ * Conceptual predicate (what the user sees in the bar):
+ *   AND_perField(...topLevelRules) AND OR(...compound.groups)
+ * where each `AndGroup` inside `compound.groups` is itself AND'd internally.
+ *
+ * - Simple pills compose into `topLevelRules`. Pills on DIFFERENT fields
+ *   are AND'd together; multiple pills on the SAME field are OR'd
+ *   together. AND'ing two equality predicates on a single field would
+ *   always return zero rows, so multi-pill-per-field naturally means
+ *   "is any of these values".
+ * - The Rules pill owns `compound.groups` (OR-of-AND / DNF).
+ */
+/** All available field types we render type-aware controls + operators for. */
+type FilterFieldType = 'string' | 'email' | 'choices' | 'multi_choices' | 'boolean' | 'integer' | 'float' | 'date' | 'array' /** OR-of-AND tag conditions (`FilterTagsCondition[][]`). */ | 'tags_conditions' /** ISO date range (`DateRangeFilterValue`). */ | 'date_range';
+/**
+ * Per-rule operator vocabulary.
+ *
+ * Not every operator is valid for every field. See `getOperatorsForField` in
+ * `./operators.ts` for the resolution the UI and `FieldRegistry` use to gate
+ * which operators are pickable in the Filter popover: a field's
+ * `allowedOperators`, or its type's vocabulary when that list is absent.
+ *
+ * Numeric range operators (`gt` / `lt`) are deliberately omitted from this
+ * union. When native `gt` / `lt` support exists, re-add them to this union,
+ * the per-type vocabulary in `operators.ts`, the label map, and the adapter's
+ * `normalizeValue` switch.
+ */
+type FilterOperator = 'is' | 'is_not' | 'contains' | 'does_not_contain' | 'is_empty' | 'is_not_empty' | 'is_true' | 'is_false' | 'before' | 'after';
+/** Whether a field is a system/built-in field or a custom field on a parent record type. */
+type FilterFieldSource = 'system' | 'custom';
+/**
+ * Static metadata for one filterable field, exposed by `FieldRegistry`.
+ *
+ * Shape is mostly derived from the backend's `field_key_to_info` payload.
+ * The registry tolerates missing metadata and falls back to `'string'`.
+ */
+interface FilterField {
+  /** Stable id used by `FilterRule.fieldId`. Backend's `field_key`. */
+  id: string;
+  /** Human-readable label rendered in the filter picker and pill. */
+  label: string;
+  /** Field type that drives operator vocabulary and value control rendering. */
+  type: FilterFieldType;
+  /** System vs custom — drives the popover footer affordance + picker grouping. */
+  source: FilterFieldSource;
+  /**
+   * For `choices` / `multi_choices`, the option list shown in the value control.
+   * Backend metadata `options`.
+   */
+  options?: ReadonlyArray<{
+    label: string;
+    value: string;
+  }>;
+  /**
+   * For `array` fields, the inner item type. Drives whether the value control
+   * is a text input vs. multi-select. Backend metadata `item_type`.
+   */
+  itemType?: FilterFieldType;
+  /**
+   * For custom fields, the human-readable parent-scope label (record type
+   * / Case template name). Display-only: the popover footer
+   * (`ⓘ [label] is a field on [parentRecordType]`) and the picker submenu
+   * grouping/sublabel. Narrowing keys off {@link parentRecordId}, not this
+   * label (labels can collide or carry a suffix). Backend `parent_record_type`.
+   */
+  parentRecordType?: string;
+  /**
+   * For custom fields, the parent scope's token (the public id the
+   * account-type / case-template records expose as `id`) — the
+   * picker-narrowing key. A selector field whose `options[].value`
+   * intersects the registry's `parentRecordId`s is inferred as a scoping
+   * selector, and an `is` pill on it narrows the picker to that scope.
+   * Matching on the token, not the label, keeps narrowing exact. Backend
+   * `parent_record_id`.
+   */
+  parentRecordId?: string;
+  /**
+   * Reserved slot for nested-path filtering (hash subfields). The frontend
+   * never produces a non-empty `path` today; this is shape-stable so that
+   * hash subfield support can land without a state migration once the backend
+   * `SearchAliasMap` decision is made.
+   */
+  path?: ReadonlyArray<string>;
+  /**
+   * Optional operator allow-list, for a field whose host can only serialize
+   * part of its type's vocabulary. When omitted or empty, the full per-type
+   * vocabulary from `operators.ts` applies.
+   */
+  allowedOperators?: ReadonlyArray<FilterOperator>;
+}
+/** ISO calendar-date range for legacy index date filters. */
+interface DateRangeFilterValue {
+  startDate?: string;
+  endDate?: string;
+}
+/** Value shape for a single rule. Matches the union the value controls produce. */
+type FilterRuleValue = string | ReadonlyArray<string> | number | boolean | null | DateRangeFilterValue | ReadonlyArray<ReadonlyArray<Record<string, unknown>>> | ReadonlyArray<ReadonlyArray<unknown>>;
+/** A single field/operator/value triple — one row in the Advanced Filter Rules editor. */
+interface FilterRule {
+  fieldId: string;
+  operator: FilterOperator;
+  value: FilterRuleValue;
+}
+/**
+ * A top-level (simple pill) rule. Carries a stable `id` so multiple
+ * pills for the same field can coexist — the "Add filter" picker
+ * always creates a new id rather than collapsing duplicate field
+ * selections back onto a single existing rule. `id` is local to the
+ * client state; it is not serialized to the backend payload.
+ */
+interface TopLevelFilterRule extends FilterRule {
+  id: string;
+}
+/** One AND group inside the compound expression. Rules inside are AND'd. */
+interface AndGroup {
+  rules: FilterRule[];
+}
+/**
+ * The compound expression owned by the Rules pill.
+ *
+ * Groups are OR'd (DNF). When `groups.length === 0` no compound predicate
+ * applies and the Rules pill still renders in its default `Rules ▾` state.
+ */
+interface CompoundExpression {
+  groups: AndGroup[];
+}
+/** Client-side state shape for the v2 filter UI. */
+interface FilterStateV2 {
+  /**
+   * Simple pills. Multiple pills for the same field remain distinct so
+   * host applications can preserve the user's filter expression.
+   */
+  topLevelRules: TopLevelFilterRule[];
+  /** Rules pill content. Empty `groups` means no compound rules are applied. */
+  compound: CompoundExpression;
+}
+/**
+ * Filter-bar size variant. Drives the size of every nested PDS component
+ * (Button, Input, Combobox, IconButton, etc.) plus the hand-tuned
+ * dimensions of the Filter UI v2 styled primitives (pill heights,
+ * font sizes, icon glyph sizes). Two values supported:
+ *
+ * - `'sm'` — 12px font, 12px icons, 24px-tall inputs/pills. Designed
+ *   for the compact DataTable layout.
+ * - `'md'` (default) — 14px font, 16px icons, 32px-tall inputs/pills. Designed
+ *   for the standard DataTable layout.
+ *
+ * The active default is owned by `FilterBar`'s `size` prop, not this type.
+ */
+type FilterSize = 'sm' | 'md';
+/** The empty state — no filters applied. */
+declare const EMPTY_FILTER_STATE: FilterStateV2;
+//#endregion
+export { FilterField as a, FilterOperator as c, FilterSize as d, FilterStateV2 as f, EMPTY_FILTER_STATE as i, FilterRule as l, CompoundExpression as n, FilterFieldSource as o, TopLevelFilterRule as p, DateRangeFilterValue as r, FilterFieldType as s, AndGroup as t, FilterRuleValue as u };
+//# sourceMappingURL=types-D58IoRx6.d.mts.map

package/dist/types-D7ppqnNj.d.mts

@@ -0,0 +1,45 @@
+import { a as FilterField, c as FilterOperator, u as FilterRuleValue } from "./types-D58IoRx6.mjs";
+import { ReactElement } from "react";
+
+//#region components/DataTable/TableControls/FiltersV2/value-controls/types.d.ts
+/**
+ * Shared contract for the type-aware value controls rendered inside the
+ * Filter UI v2 editing surfaces.
+ *
+ * One control per value-bearing `FilterFieldType`; boolean fields are
+ * operator-only (`is_true` / `is_false` / emptiness) and do not render a
+ * separate value control. Controls read the active operator and render
+ * nothing (or a disabled placeholder) when the operator is in the valueless
+ * set (`is_empty` / `is_not_empty`). Use `isValuelessOperator` from
+ * `../operators` to decide.
+ */
+interface ValueControlProps {
+  /** Field metadata from `FieldRegistry`. Drives placeholder/options. */
+  field: FilterField;
+  /**
+   * The currently selected operator for this rule. The control should be a
+   * no-op (render nothing or disable itself) when the operator is in the
+   * valueless set.
+   */
+  operator: FilterOperator;
+  /** Current value held by the rule. */
+  value: FilterRuleValue;
+  /** Called when the user commits a new value. */
+  onChange: (value: FilterRuleValue) => void;
+  /** Optional callback for controls that commit a complete selection in one action. */
+  onCommit?: () => void;
+  /** Aria label wired to the popover's labeling. */
+  ariaLabel?: string;
+  /** Optional external trigger that opens dropdown-backed value controls directly. */
+  trigger?: ReactElement;
+  /**
+   * Host surface — forwarded from `resolveValueControl`. `popover` (default)
+   * is the simple-rule `FilterPopover` slot; `inline` is the Advanced Filter
+   * Rules `LogicRow` dropdown. Combobox-backed controls use embedded mode only
+   * on the popover surface so Rules rows get a standard combobox chrome.
+   */
+  layout?: 'popover' | 'inline';
+}
+//#endregion
+export { ValueControlProps as t };
+//# sourceMappingURL=types-D7ppqnNj.d.mts.map

package/dist/{types-BG21GgBe.d.cts → types-DEh_pXgS.d.mts}

@@ -22,4 +22,4 @@ interface BaseActiveFilter<TFilter extends BaseFilterConfig = BaseFilterConfig>
 }
 //#endregion
 export { BaseActiveFilter as n, BaseFilterConfig as r, AttributeColumn as t };
-//# sourceMappingURL=types-BG21GgBe.d.cts.map
+//# sourceMappingURL=types-DEh_pXgS.d.mts.map

package/dist/{types-ChCqSD9N.d.mts → types-SYSKcZKW.d.cts}

@@ -22,4 +22,4 @@ interface BaseActiveFilter<TFilter extends BaseFilterConfig = BaseFilterConfig>
 }
 //#endregion
 export { BaseActiveFilter as n, BaseFilterConfig as r, AttributeColumn as t };
-//# sourceMappingURL=types-ChCqSD9N.d.mts.map
+//# sourceMappingURL=types-SYSKcZKW.d.cts.map

package/dist/{types-DMjr-u_o.d.mts → types-TV9nVfSe.d.mts}

@@ -7,4 +7,4 @@ interface PaginationParams {
 }
 //#endregion
 export { PaginationParams as t };
-//# sourceMappingURL=types-DMjr-u_o.d.mts.map
+//# sourceMappingURL=types-TV9nVfSe.d.mts.map

package/dist/types.d.cts

@@ -1,2 +1,2 @@
-import { n as BaseActiveFilter, r as BaseFilterConfig, t as AttributeColumn } from "./types-BG21GgBe.cjs";
+import { n as BaseActiveFilter, r as BaseFilterConfig, t as AttributeColumn } from "./types-SYSKcZKW.cjs";
 export { AttributeColumn, BaseActiveFilter, BaseFilterConfig };