@proteos/ui 0.55.0 → 0.56.0

package/dist/index.d.cts

@@ -2356,7 +2356,10 @@ type FilterField = {
     /** Parent label for breadcrumb in chips, e.g. `'Owner'`. Omitted for top-level. */
     parentLabel?: string;
     type: FilterFieldType;
-    /** Required when `type === 'enum'`; ignored otherwise. */
+    /** Required when `type === 'enum'`. For `type === 'array'` these are the
+     *  ITEM enum's values (an array of enum items), so the membership editors
+     *  and chips pick from the same list the record editor does. Ignored
+     *  otherwise. */
     options?: ReadonlyArray<FilterFieldOption>;
     /** Hint for `<Input type=…>`. Defaults derived from `type`. */
     inputType?: 'text' | 'number' | 'date' | 'datetime' | 'email';
@@ -2407,7 +2410,7 @@ type FilterFieldRelation = {
     /** Dot-path of the field on the related entity, e.g. `'name'` or `'address.city'`. */
     relatedFieldPath: string;
 };
-type ComparisonOperator = 'eq' | 'gt' | 'lt' | 'gte' | 'lte' | 'ne' | 'in' | 'not_in' | 'contains' | 'starts_with' | 'ends_with' | 'empty' | 'not_empty';
+type ComparisonOperator = 'eq' | 'gt' | 'lt' | 'gte' | 'lte' | 'ne' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'contains_all' | 'starts_with' | 'ends_with' | 'empty' | 'not_empty';
 type LogicalOperator = 'and' | 'or';
 type FilterValue = string | string[] | boolean | null;
 type FilterElement = {

package/dist/index.d.ts

@@ -2356,7 +2356,10 @@ type FilterField = {
     /** Parent label for breadcrumb in chips, e.g. `'Owner'`. Omitted for top-level. */
     parentLabel?: string;
     type: FilterFieldType;
-    /** Required when `type === 'enum'`; ignored otherwise. */
+    /** Required when `type === 'enum'`. For `type === 'array'` these are the
+     *  ITEM enum's values (an array of enum items), so the membership editors
+     *  and chips pick from the same list the record editor does. Ignored
+     *  otherwise. */
     options?: ReadonlyArray<FilterFieldOption>;
     /** Hint for `<Input type=…>`. Defaults derived from `type`. */
     inputType?: 'text' | 'number' | 'date' | 'datetime' | 'email';
@@ -2407,7 +2410,7 @@ type FilterFieldRelation = {
     /** Dot-path of the field on the related entity, e.g. `'name'` or `'address.city'`. */
     relatedFieldPath: string;
 };
-type ComparisonOperator = 'eq' | 'gt' | 'lt' | 'gte' | 'lte' | 'ne' | 'in' | 'not_in' | 'contains' | 'starts_with' | 'ends_with' | 'empty' | 'not_empty';
+type ComparisonOperator = 'eq' | 'gt' | 'lt' | 'gte' | 'lte' | 'ne' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'contains_all' | 'starts_with' | 'ends_with' | 'empty' | 'not_empty';
 type LogicalOperator = 'and' | 'or';
 type FilterValue = string | string[] | boolean | null;
 type FilterElement = {

package/dist/index.js

@@ -6217,7 +6217,8 @@ var OPERATORS = [
       "relation",
       "user",
       "principal",
-      "contact-address"
+      "contact-address",
+      "array"
     ]
   },
   {
@@ -6233,10 +6234,19 @@ var OPERATORS = [
       "relation",
       "user",
       "principal",
-      "contact-address"
+      "contact-address",
+      "array"
     ]
   },
   { id: "contains", label: "contains", arity: 1, types: ["string", "array", "contact-address"] },
+  {
+    id: "not_contains",
+    label: "does not contain",
+    arity: 1,
+    types: ["string", "array", "contact-address"]
+  },
+  // Array-only: "has every one of these". On a scalar the backend rejects it.
+  { id: "contains_all", label: "has all of", arity: "n", types: ["array"] },
   { id: "starts_with", label: "starts with", arity: 1, types: ["string", "contact-address"] },
   { id: "ends_with", label: "ends with", arity: 1, types: ["string", "contact-address"] },
   {
@@ -6299,14 +6309,33 @@ var OP_LABEL_OVERRIDES = {
   integer: { gt: "is greater than", lt: "is less than", eq: "equals", ne: "does not equal" },
   currency: { gt: "is greater than", lt: "is less than", eq: "equals", ne: "does not equal" },
   datetime: { eq: "is on", ne: "is not on", gt: "is after", lt: "is before" },
-  array: { contains: "contains", empty: "is empty", not_empty: "is not empty" },
+  // Arrays filter by set membership, in the words every CRM uses for it.
+  array: {
+    contains: "has",
+    not_contains: "does not have",
+    in: "has any of",
+    not_in: "has none of",
+    contains_all: "has all of",
+    empty: "is empty",
+    not_empty: "is not empty"
+  },
   boolean: { eq: "is", ne: "is not" }
 };
+var OP_ORDER_OVERRIDES = {
+  array: ["contains", "not_contains", "in", "contains_all", "not_in", "empty", "not_empty"]
+};
 function operatorsForType(type) {
-  return OPERATORS.filter((op) => op.types.includes(type)).map((op) => {
+  const ops = OPERATORS.filter((op) => op.types.includes(type)).map((op) => {
     const override = OP_LABEL_OVERRIDES[type]?.[op.id];
     return override ? { ...op, label: override } : op;
   });
+  const order = OP_ORDER_OVERRIDES[type];
+  if (!order) return ops;
+  return [...ops].sort((a, b) => order.indexOf(a.id) - order.indexOf(b.id));
+}
+function isEnumLike(field) {
+  if (field.type === "enum") return true;
+  return field.type === "array" && (field.options?.length ?? 0) > 0;
 }
 function operatorById(id) {
   return OPERATORS.find((o) => o.id === id);
@@ -6378,7 +6407,7 @@ function ChipItem({
     const custom = effectiveRenderer({ field, operator, value });
     if (custom !== void 0) return /* @__PURE__ */ jsx(Fragment, { children: custom });
   }
-  if (field.type === "enum") {
+  if (isEnumLike(field)) {
     const option = findEnumOption(field, value);
     return /* @__PURE__ */ jsx(
       Badge,
@@ -6406,7 +6435,7 @@ function formatValue(field, operator, value) {
   if (arity === "n") {
     const arr = Array.isArray(value) ? value : typeof value === "string" && value.length > 0 ? value.split(",") : [];
     if (arr.length === 0) return "\u2014";
-    if (field.type === "enum") {
+    if (isEnumLike(field)) {
       const labels = arr.map((v) => findEnumOption(field, v)?.label ?? v);
       return labels.length <= 2 ? labels.join(", ") : `${labels[0]}, ${labels[1]} +${labels.length - 2}`;
     }
@@ -6414,7 +6443,7 @@ function formatValue(field, operator, value) {
   }
   if (field.type === "boolean") return value === true || value === "true" ? "true" : "false";
   if (value === "" || value == null) return "\u2014";
-  if (field.type === "enum") {
+  if (isEnumLike(field)) {
     return findEnumOption(field, String(value))?.label ?? String(value);
   }
   if (field.type === "number" || field.type === "integer") {
@@ -6662,7 +6691,7 @@ function FilterValueInput({
   }
   const leaf = (() => {
     if (arity === "n") {
-      if (field.type === "enum") {
+      if (isEnumLike(field)) {
         return /* @__PURE__ */ jsx(
           EnumMultiValue,
           {
@@ -6689,7 +6718,7 @@ function FilterValueInput({
         }
       );
     }
-    if (field.type === "enum") {
+    if (isEnumLike(field)) {
       return /* @__PURE__ */ jsx(
         EnumSingleValue,
         {
@@ -6850,7 +6879,9 @@ function placeholderFor(field, operator) {
   if (field.type === "number" || field.type === "integer" || field.type === "currency") return "0";
   if (operator === "starts_with") return "starts with\u2026";
   if (operator === "ends_with") return "ends with\u2026";
-  if (operator === "contains") return "contains\u2026";
+  if (operator === "contains") return field.type === "array" ? "has\u2026" : "contains\u2026";
+  if (operator === "not_contains")
+    return field.type === "array" ? "does not have\u2026" : "does not contain\u2026";
   return "value";
 }
 function OperatorPicker({