@l3mpire/ui 2.12.0 → 2.13.0

package/USAGE.md

@@ -956,6 +956,29 @@ import {
 
 **Advanced filter shortcut:** the PropertySelector footer shows an "Advanced filter · N rule(s)" item. Clicking it closes the property selector and opens the advanced popover directly in its initial empty state — where the user picks the first property inline via a "Where | [Select property ▾]" draft row. When no advanced filters exist yet, clicking this shortcut makes the AdvancedChip appear with the popover already open; closing without adding a filter removes the chip automatically.
 
+**Dynamic options ("Me", "Unassigned", …):** enum/tags/relation properties accept a `dynamicOptions` array. Each entry is `{ value, label, description?, icon? }` and is rendered at the top of the SingleSelect / MultiSelect dropdown with a divider separating it from the regular options. The `value` is a sentinel string stored on `FilterCondition.value` — the DS only renders, the consuming app resolves it at query time (e.g. `"__me__"` → `currentUser.id`). This keeps session/business logic out of the DS while still getting a consistent visual treatment.
+
+```tsx
+{
+  id: "contact_owner",
+  label: "Contact owner",
+  type: "enum",
+  icon: faUserOutline,
+  group: "contact",
+  groupLabel: "Contact",
+  options: ["Quentin", "Simon", "Philippe"],
+  dynamicOptions: [
+    {
+      value: "__me__",
+      label: "Me",
+      description: "This value is dynamically applied to the current user",
+      icon: faBoltOutline,
+    },
+    { value: "__deactivated__", label: "All deactivated and removed owners", icon: faBoltOutline },
+  ],
+}
+```
+
 | Utility | Purpose |
 |---|---|
 | `OPERATORS_BY_TYPE` | Operators for each DataType |

package/dist/index.d.mts

@@ -676,12 +676,28 @@ declare const FilterChip: React.ForwardRefExoticComponent<FilterChipProps & Reac
 type DataType = "text" | "number" | "date" | "enum" | "tags" | "boolean" | "relation";
 type TextOperator = "contains" | "does not contain" | "is" | "is not" | "starts with" | "ends with" | "is empty" | "is not empty";
 type NumberOperator = "=" | "≠" | ">" | "<" | "≥" | "≤" | "is between" | "is empty" | "is not empty";
-type DateOperator = "is" | "is before" | "is after" | "is on or before" | "is on or after" | "is between" | "is relative" | "is empty" | "is not empty";
+type DateOperator = "is" | "is before" | "is after" | "is on or before" | "is on or after" | "is between" | "is empty" | "is not empty";
 type EnumOperator = "is" | "is not" | "is any of" | "is none of" | "is empty" | "is not empty";
 type TagsOperator = "contains" | "does not contain" | "contains any of" | "contains all of" | "is empty" | "is not empty";
 type BooleanOperator = "is true" | "is false";
 type RelationOperator = "is" | "is not" | "is any of" | "is none of" | "is empty" | "is not empty";
 type OperatorType = TextOperator | NumberOperator | DateOperator | EnumOperator | TagsOperator | BooleanOperator | RelationOperator;
+/**
+ * A "smart" / dynamic option shown at the top of a relation or enum selector
+ * (e.g. "Me", "My team", "Unassigned"). The value is a sentinel string that
+ * the consuming app resolves at query time (e.g. `__me__` → `currentUser.id`).
+ *
+ * The design system only handles the rendering (icon + label + description +
+ * divider above the regular options). Resolving the sentinels is an app
+ * concern.
+ */
+interface DynamicOption {
+    /** Sentinel value stored on FilterCondition.value (e.g. "__me__"). */
+    value: string;
+    label: string;
+    description?: string;
+    icon?: _l3mpire_icons.IconDefinition;
+}
 interface PropertyDefinition {
     id: string;
     label: string;
@@ -690,6 +706,12 @@ interface PropertyDefinition {
     group: string;
     groupLabel: string;
     options?: string[];
+    /**
+     * Dynamic/smart options rendered at the top of the value selector with a
+     * divider. Only used for enum, tags, and relation types. The app resolves
+     * the sentinel values at query time.
+     */
+    dynamicOptions?: DynamicOption[];
     relationConfig?: {
         entity: string;
         displayProperty: string;
@@ -814,6 +836,8 @@ interface ValueInputProps {
     onChange: (value: FilterValue) => void;
     onSubmit?: () => void;
     options?: string[];
+    /** Dynamic/smart entries rendered at the top with a divider. */
+    dynamicOptions?: DynamicOption[];
     className?: string;
 }
 declare const ValueInput: React.FC<ValueInputProps>;

package/dist/index.d.ts

@@ -676,12 +676,28 @@ declare const FilterChip: React.ForwardRefExoticComponent<FilterChipProps & Reac
 type DataType = "text" | "number" | "date" | "enum" | "tags" | "boolean" | "relation";
 type TextOperator = "contains" | "does not contain" | "is" | "is not" | "starts with" | "ends with" | "is empty" | "is not empty";
 type NumberOperator = "=" | "≠" | ">" | "<" | "≥" | "≤" | "is between" | "is empty" | "is not empty";
-type DateOperator = "is" | "is before" | "is after" | "is on or before" | "is on or after" | "is between" | "is relative" | "is empty" | "is not empty";
+type DateOperator = "is" | "is before" | "is after" | "is on or before" | "is on or after" | "is between" | "is empty" | "is not empty";
 type EnumOperator = "is" | "is not" | "is any of" | "is none of" | "is empty" | "is not empty";
 type TagsOperator = "contains" | "does not contain" | "contains any of" | "contains all of" | "is empty" | "is not empty";
 type BooleanOperator = "is true" | "is false";
 type RelationOperator = "is" | "is not" | "is any of" | "is none of" | "is empty" | "is not empty";
 type OperatorType = TextOperator | NumberOperator | DateOperator | EnumOperator | TagsOperator | BooleanOperator | RelationOperator;
+/**
+ * A "smart" / dynamic option shown at the top of a relation or enum selector
+ * (e.g. "Me", "My team", "Unassigned"). The value is a sentinel string that
+ * the consuming app resolves at query time (e.g. `__me__` → `currentUser.id`).
+ *
+ * The design system only handles the rendering (icon + label + description +
+ * divider above the regular options). Resolving the sentinels is an app
+ * concern.
+ */
+interface DynamicOption {
+    /** Sentinel value stored on FilterCondition.value (e.g. "__me__"). */
+    value: string;
+    label: string;
+    description?: string;
+    icon?: _l3mpire_icons.IconDefinition;
+}
 interface PropertyDefinition {
     id: string;
     label: string;
@@ -690,6 +706,12 @@ interface PropertyDefinition {
     group: string;
     groupLabel: string;
     options?: string[];
+    /**
+     * Dynamic/smart options rendered at the top of the value selector with a
+     * divider. Only used for enum, tags, and relation types. The app resolves
+     * the sentinel values at query time.
+     */
+    dynamicOptions?: DynamicOption[];
     relationConfig?: {
         entity: string;
         displayProperty: string;
@@ -814,6 +836,8 @@ interface ValueInputProps {
     onChange: (value: FilterValue) => void;
     onSubmit?: () => void;
     options?: string[];
+    /** Dynamic/smart entries rendered at the top with a divider. */
+    dynamicOptions?: DynamicOption[];
     className?: string;
 }
 declare const ValueInput: React.FC<ValueInputProps>;