@astryxdesign/core 0.1.5 → 0.1.6-canary.02f2602

package/dist/PowerSearch/PowerSearchValueEditor.js

@@ -20,7 +20,8 @@ import { TimeInput } from "../TimeInput/index.js";
 import { Selector } from "../Selector/index.js";
 import { Tokenizer } from "../Tokenizer/index.js";
 import { Typeahead } from "../Typeahead/index.js";
-import { jsxDEV as _jsxDEV, Fragment as _Fragment } from "react/jsx-dev-runtime";
+import { useTranslator } from "../i18n/index.js";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 // =============================================================================
 // Helpers
 // =============================================================================
@@ -53,6 +54,7 @@ function StringEditor({
   onChange,
   onEnter: _onEnter
 }) {
+  const t = useTranslator();
   const currentValue = filterValue?.type === 'string' ? filterValue.value : '';
 
   // When a searchSource is provided, render a typeahead instead of a plain
@@ -62,8 +64,8 @@ function StringEditor({
       id: currentValue,
       label: currentValue
     } : null;
-    return /*#__PURE__*/_jsxDEV(Typeahead, {
-      label: "Value",
+    return /*#__PURE__*/_jsx(Typeahead, {
+      label: t('@astryx.powersearch.valueEditor.value'),
       isLabelHidden: true,
       searchSource: operatorValue.searchSource,
       value: selectedItem,
@@ -80,28 +82,29 @@ function StringEditor({
           });
         }
       },
-      placeholder: "Search...",
+      placeholder: t('@astryx.powersearch.valueEditor.searchPlaceholder'),
       debounceMs: 150
-    }, void 0, false);
+    });
   }
-  return /*#__PURE__*/_jsxDEV(TextInput, {
-    label: "Value",
+  return /*#__PURE__*/_jsx(TextInput, {
+    label: t('@astryx.powersearch.valueEditor.value'),
     isLabelHidden: true,
     value: currentValue,
-    placeholder: "Enter value...",
+    placeholder: t('@astryx.powersearch.valueEditor.enterValuePlaceholder'),
     onChange: value => {
       onChange({
         type: 'string',
         value
       });
     }
-  }, void 0, false);
+  });
 }
 function StringListEditor({
   operatorValue,
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   const currentValue = useMemo(() => {
     if (filterValue?.type !== 'string_list') {
       return [];
@@ -125,8 +128,8 @@ function StringListEditor({
   // Enable creatable mode when no searchSource is provided (free-text tags)
   // or when isArbitraryStringAllowed is explicitly set (#1107).
   const hasCreate = operatorValue.isArbitraryStringAllowed || !operatorValue.searchSource;
-  return /*#__PURE__*/_jsxDEV(Tokenizer, {
-    label: "Values",
+  return /*#__PURE__*/_jsx(Tokenizer, {
+    label: t('@astryx.powersearch.valueEditor.values'),
     isLabelHidden: true,
     searchSource: source,
     value: currentValue,
@@ -136,19 +139,20 @@ function StringListEditor({
         value: items.map(item => item.label)
       });
     },
-    placeholder: "Add values...",
+    placeholder: t('@astryx.powersearch.valueEditor.addValuesPlaceholder'),
     debounceMs: operatorValue.searchSource ? 150 : 0,
     hasCreate: hasCreate
-  }, void 0, false);
+  });
 }
 function IntegerEditor({
   operatorValue,
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   const currentValue = filterValue?.type === 'integer' ? filterValue.value : undefined;
-  return /*#__PURE__*/_jsxDEV(NumberInput, {
-    label: "Value",
+  return /*#__PURE__*/_jsx(NumberInput, {
+    label: t('@astryx.powersearch.valueEditor.value'),
     isLabelHidden: true,
     value: currentValue ?? null,
     onChange: value => {
@@ -161,17 +165,18 @@ function IntegerEditor({
     max: operatorValue.maxValue,
     units: operatorValue.units,
     isIntegerOnly: true,
-    placeholder: "Enter number..."
-  }, void 0, false);
+    placeholder: t('@astryx.powersearch.valueEditor.enterNumberPlaceholder')
+  });
 }
 function FloatEditor({
   operatorValue,
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   const currentValue = filterValue?.type === 'float' ? filterValue.value : undefined;
-  return /*#__PURE__*/_jsxDEV(NumberInput, {
-    label: "Value",
+  return /*#__PURE__*/_jsx(NumberInput, {
+    label: t('@astryx.powersearch.valueEditor.value'),
     isLabelHidden: true,
     value: currentValue ?? null,
     onChange: value => {
@@ -183,17 +188,18 @@ function FloatEditor({
     min: operatorValue.minValue,
     max: operatorValue.maxValue,
     units: operatorValue.units,
-    placeholder: "Enter number..."
-  }, void 0, false);
+    placeholder: t('@astryx.powersearch.valueEditor.enterNumberPlaceholder')
+  });
 }
 function TimeEditor({
   operatorValue,
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   const currentValue = filterValue?.type === 'time' ? filterValue.value : undefined;
-  return /*#__PURE__*/_jsxDEV(TimeInput, {
-    label: "Time",
+  return /*#__PURE__*/_jsx(TimeInput, {
+    label: t('@astryx.powersearch.valueEditor.time'),
     isLabelHidden: true,
     value: currentValue,
     onChange: value => {
@@ -206,12 +212,13 @@ function TimeEditor({
     },
     min: operatorValue.minValue,
     max: operatorValue.maxValue
-  }, void 0, false);
+  });
 }
 function DateAbsoluteEditor({
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   // Convert unixSeconds to ISO date string for the date input
   const currentValue = useMemo(() => {
     if (filterValue?.type !== 'date_absolute') {
@@ -220,8 +227,8 @@ function DateAbsoluteEditor({
     const date = new Date(filterValue.unixSeconds * 1000);
     return date.toISOString().split('T')[0];
   }, [filterValue]);
-  return /*#__PURE__*/_jsxDEV(DateInput, {
-    label: "Date",
+  return /*#__PURE__*/_jsx(DateInput, {
+    label: t('@astryx.powersearch.valueEditor.date'),
     isLabelHidden: true,
     value: currentValue,
     onChange: value => {
@@ -233,13 +240,14 @@ function DateAbsoluteEditor({
         });
       }
     }
-  }, void 0, false);
+  });
 }
 function DateRelativeEditor({
   operatorValue,
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   const currentValue = filterValue?.type === 'date_relative' ? filterValue.value : undefined;
   const options = useMemo(() => {
     const result = [];
@@ -275,8 +283,8 @@ function DateRelativeEditor({
     }
     return result;
   }, [operatorValue.isPastAllowed, operatorValue.isFutureAllowed]);
-  return /*#__PURE__*/_jsxDEV(Selector, {
-    label: "Relative date",
+  return /*#__PURE__*/_jsx(Selector, {
+    label: t('@astryx.powersearch.valueEditor.relativeDate'),
     isLabelHidden: true,
     options: options,
     value: currentValue,
@@ -286,12 +294,13 @@ function DateRelativeEditor({
         value
       }, true);
     }
-  }, void 0, false);
+  });
 }
 function DateRangeEditor({
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   const startValue = useMemo(() => {
     if (filterValue?.type !== 'date_range') {
       return undefined;
@@ -344,32 +353,33 @@ function DateRangeEditor({
       }
     });
   }, [filterValue, onChange]);
-  return /*#__PURE__*/_jsxDEV(_Fragment, {
-    children: [/*#__PURE__*/_jsxDEV(DateInput, {
-      label: "Start date",
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx(DateInput, {
+      label: t('@astryx.powersearch.valueEditor.startDate'),
       isLabelHidden: true,
       value: startValue,
       onChange: handleStartChange
-    }, void 0, false), /*#__PURE__*/_jsxDEV(DateInput, {
-      label: "End date",
+    }), /*#__PURE__*/_jsx(DateInput, {
+      label: t('@astryx.powersearch.valueEditor.endDate'),
       isLabelHidden: true,
       value: endValue,
       onChange: handleEndChange
-    }, void 0, false)]
-  }, void 0, true);
+    })]
+  });
 }
 function EnumEditor({
   operatorValue,
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   const currentValue = filterValue?.type === 'enum' ? filterValue.value : undefined;
   const options = useMemo(() => operatorValue.values.map(item => ({
     value: item.value,
     label: item.label
   })), [operatorValue.values]);
-  return /*#__PURE__*/_jsxDEV(Selector, {
-    label: "Value",
+  return /*#__PURE__*/_jsx(Selector, {
+    label: t('@astryx.powersearch.valueEditor.value'),
     isLabelHidden: true,
     options: options,
     value: currentValue,
@@ -379,13 +389,14 @@ function EnumEditor({
         value
       }, true);
     }
-  }, void 0, false);
+  });
 }
 function EnumListEditor({
   operatorValue,
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   const items = useMemo(() => enumItemsToSearchableItems(operatorValue.values), [operatorValue.values]);
   const source = useMemo(() => createStaticSource(items), [items]);
   const currentValue = useMemo(() => {
@@ -400,8 +411,8 @@ function EnumListEditor({
       };
     });
   }, [filterValue, operatorValue.values]);
-  return /*#__PURE__*/_jsxDEV(Tokenizer, {
-    label: "Values",
+  return /*#__PURE__*/_jsx(Tokenizer, {
+    label: t('@astryx.powersearch.valueEditor.values'),
     isLabelHidden: true,
     searchSource: source,
     value: currentValue,
@@ -411,16 +422,17 @@ function EnumListEditor({
         value: selectedItems.map(item => item.id)
       });
     },
-    placeholder: "Select values...",
+    placeholder: t('@astryx.powersearch.valueEditor.selectValuesPlaceholder'),
     hasEntriesOnFocus: true,
     debounceMs: 0
-  }, void 0, false);
+  });
 }
 function EntityListEditor({
   operatorValue,
   filterValue,
   onChange
 }) {
+  const t = useTranslator();
   const source = useMemo(() => {
     if (operatorValue.searchSource) {
       return operatorValue.searchSource;
@@ -444,8 +456,8 @@ function EntityListEditor({
       } : undefined
     }));
   }, [filterValue]);
-  return /*#__PURE__*/_jsxDEV(Tokenizer, {
-    label: "Entities",
+  return /*#__PURE__*/_jsx(Tokenizer, {
+    label: t('@astryx.powersearch.valueEditor.entities'),
     isLabelHidden: true,
     searchSource: source,
     value: currentValue,
@@ -466,9 +478,9 @@ function EntityListEditor({
       });
     },
     renderItem: operatorValue.renderItem,
-    placeholder: "Search...",
+    placeholder: t('@astryx.powersearch.valueEditor.searchPlaceholder'),
     debounceMs: operatorValue.searchSource ? 150 : 0
-  }, void 0, false);
+  });
 }
 function CustomEditor({
   operatorValue,
@@ -476,9 +488,10 @@ function CustomEditor({
   onChange,
   isDisabled
 }) {
+  const t = useTranslator();
   const currentValue = filterValue?.type === 'custom' ? filterValue.value : null;
   const EditorComponent = operatorValue.Editor;
-  return /*#__PURE__*/_jsxDEV(EditorComponent, {
+  return /*#__PURE__*/_jsx(EditorComponent, {
     isDisabled: isDisabled,
     onChange: value => {
       if (value != null) {
@@ -488,9 +501,9 @@ function CustomEditor({
         });
       }
     },
-    placeholder: "Enter value...",
+    placeholder: t('@astryx.powersearch.valueEditor.enterValuePlaceholder'),
     value: currentValue
-  }, void 0, false);
+  });
 }
 
 // =============================================================================
@@ -508,79 +521,79 @@ export function PowerSearchValueEditor({
     case 'empty':
       return null;
     case 'string':
-      return /*#__PURE__*/_jsxDEV(StringEditor, {
+      return /*#__PURE__*/_jsx(StringEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange,
         onEnter: onEnter
-      }, void 0, false);
+      });
     case 'string_list':
-      return /*#__PURE__*/_jsxDEV(StringListEditor, {
+      return /*#__PURE__*/_jsx(StringListEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'integer':
-      return /*#__PURE__*/_jsxDEV(IntegerEditor, {
+      return /*#__PURE__*/_jsx(IntegerEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'float':
-      return /*#__PURE__*/_jsxDEV(FloatEditor, {
+      return /*#__PURE__*/_jsx(FloatEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'time':
-      return /*#__PURE__*/_jsxDEV(TimeEditor, {
+      return /*#__PURE__*/_jsx(TimeEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'date_absolute':
-      return /*#__PURE__*/_jsxDEV(DateAbsoluteEditor, {
+      return /*#__PURE__*/_jsx(DateAbsoluteEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'date_relative':
-      return /*#__PURE__*/_jsxDEV(DateRelativeEditor, {
+      return /*#__PURE__*/_jsx(DateRelativeEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'date_range':
-      return /*#__PURE__*/_jsxDEV(DateRangeEditor, {
+      return /*#__PURE__*/_jsx(DateRangeEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'enum':
-      return /*#__PURE__*/_jsxDEV(EnumEditor, {
+      return /*#__PURE__*/_jsx(EnumEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'enum_list':
-      return /*#__PURE__*/_jsxDEV(EnumListEditor, {
+      return /*#__PURE__*/_jsx(EnumListEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'entity_list':
-      return /*#__PURE__*/_jsxDEV(EntityListEditor, {
+      return /*#__PURE__*/_jsx(EntityListEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
-      }, void 0, false);
+      });
     case 'custom':
-      return /*#__PURE__*/_jsxDEV(CustomEditor, {
+      return /*#__PURE__*/_jsx(CustomEditor, {
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange,
         isDisabled: isDisabled
-      }, void 0, false);
+      });
     case 'nested':
       // Nested filters are complex — simplified v1 just shows a message
       return null;

package/dist/PowerSearch/formatFilterValue.d.ts

@@ -9,5 +9,6 @@
  */
 import type { OperatorValue, FilterValue } from './types';
 import type { InternalConfig } from './useInternalConfig';
-export declare function formatFilterValue(_config: InternalConfig, operatorValue: OperatorValue, filterValue: FilterValue, maxLength: number, timezoneID?: string): string;
+import type { TranslatorFn } from '../i18n';
+export declare function formatFilterValue(_config: InternalConfig, operatorValue: OperatorValue, filterValue: FilterValue, maxLength: number, t: TranslatorFn, timezoneID?: string): string;
 //# sourceMappingURL=formatFilterValue.d.ts.map

package/dist/PowerSearch/formatFilterValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatFilterValue.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/formatFilterValue.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAE,WAAW,EAAW,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AA2CxD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA8GR"}
+{"version":3,"file":"formatFilterValue.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/formatFilterValue.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAE,WAAW,EAAW,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AA8C1C,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,CAAC,EAAE,YAAY,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAsHR"}

package/dist/PowerSearch/formatFilterValue.js

@@ -41,10 +41,10 @@ function formatRelativeDate(value) {
   // value is stored as a descriptive string like "7d" or "1w"
   return value;
 }
-function formatDateRange(_value) {
-  return 'date range';
+function formatDateRange(_value, t) {
+  return t('@astryx.powersearch.valueEditor.dateRange');
 }
-export function formatFilterValue(_config, operatorValue, filterValue, maxLength, timezoneID) {
+export function formatFilterValue(_config, operatorValue, filterValue, maxLength, t, timezoneID) {
   switch (filterValue.type) {
     case 'empty':
       return '';
@@ -72,7 +72,9 @@ export function formatFilterValue(_config, operatorValue, filterValue, maxLength
         if (joined.length <= maxLength) {
           return joined;
         }
-        return `${items.length} items`;
+        return t('@astryx.powersearch.valueEditor.itemsCount', {
+          count: items.length
+        });
       }
     case 'enum_list':
       {
@@ -89,12 +91,16 @@ export function formatFilterValue(_config, operatorValue, filterValue, maxLength
           if (joined.length <= maxLength) {
             return joined;
           }
-          return `${labels.length} items`;
+          return t('@astryx.powersearch.valueEditor.itemsCount', {
+            count: labels.length
+          });
         }
         if (items.length === 1) {
           return truncate(items[0], maxLength);
         }
-        return `${items.length} items`;
+        return t('@astryx.powersearch.valueEditor.itemsCount', {
+          count: items.length
+        });
       }
     case 'entity_list':
       {
@@ -109,7 +115,9 @@ export function formatFilterValue(_config, operatorValue, filterValue, maxLength
         if (joined.length <= maxLength) {
           return joined;
         }
-        return `${entities.length} entities`;
+        return t('@astryx.powersearch.valueEditor.entitiesCount', {
+          count: entities.length
+        });
       }
     case 'time':
       return filterValue.value;
@@ -118,7 +126,7 @@ export function formatFilterValue(_config, operatorValue, filterValue, maxLength
     case 'date_relative':
       return formatRelativeDate(filterValue.value);
     case 'date_range':
-      return formatDateRange(filterValue.value);
+      return formatDateRange(filterValue.value, t);
     case 'custom':
       if (operatorValue.type === 'custom') {
         return truncate(operatorValue.getString(filterValue.value), maxLength);
@@ -127,7 +135,9 @@ export function formatFilterValue(_config, operatorValue, filterValue, maxLength
     case 'nested':
       {
         const count = filterValue.value.length;
-        return count === 1 ? '1 filter' : `${count} filters`;
+        return t('@astryx.powersearch.valueEditor.filtersCount', {
+          count
+        });
       }
     default:
       return '';

package/dist/PowerSearch/index.d.ts

@@ -10,7 +10,8 @@ export { PowerSearch } from './PowerSearch';
 export type { PowerSearchProps, PowerSearchSize } from './PowerSearch';
 export { PowerSearchToken } from './PowerSearchToken';
 export { PowerSearchFilterEditor } from './PowerSearchFilterEditor';
+export { resolveOperatorLabel } from './resolveOperatorLabel';
 export { createPowerSearchConfig, usePowerSearchConfig, } from './usePowerSearchConfig';
 export type { FieldDefinition, InferData } from './usePowerSearchConfig';
-export type { PowerSearchConfig, PowerSearchField, PowerSearchOperator, OperatorValue, EmptyOperatorValue, StringOperatorValue, StringListOperatorValue, IntegerOperatorValue, FloatOperatorValue, TimeOperatorValue, DateAbsoluteOperatorValue, DateRelativeOperatorValue, DateRangeOperatorValue, EnumOperatorValue, EnumListOperatorValue, EntityListOperatorValue, CustomOperatorValue, NestedOperatorValue, FilterValue, FilterValueEmpty, FilterValueString, FilterValueStringList, FilterValueInteger, FilterValueFloat, FilterValueTime, FilterValueDateAbsolute, FilterValueDateRelative, FilterValueDateRange, FilterValueEnum, FilterValueEnumList, FilterValueEntityList, FilterValueCustom, FilterValueNested, PowerSearchFilter, PartialFilter, EnumItem, PowerSearchEntity, DateTimeRange, DateTimeRangePart, DateRangeFilterPreset, RelativeDateFilterPreset, OperatorTokenizationConfig, PowerSearchChangeType, PowerSearchHandle, PowerSearchTokenProps, PowerSearchEditorProps, PowerSearchComponentOverride, PowerSearchComponents, } from './types';
+export type { PowerSearchConfig, PowerSearchField, PowerSearchOperator, PowerSearchOperatorBase, PowerSearchOperatorWithLabel, PowerSearchOperatorWithI18nKey, OperatorValue, EmptyOperatorValue, StringOperatorValue, StringListOperatorValue, IntegerOperatorValue, FloatOperatorValue, TimeOperatorValue, DateAbsoluteOperatorValue, DateRelativeOperatorValue, DateRangeOperatorValue, EnumOperatorValue, EnumListOperatorValue, EntityListOperatorValue, CustomOperatorValue, NestedOperatorValue, FilterValue, FilterValueEmpty, FilterValueString, FilterValueStringList, FilterValueInteger, FilterValueFloat, FilterValueTime, FilterValueDateAbsolute, FilterValueDateRelative, FilterValueDateRange, FilterValueEnum, FilterValueEnumList, FilterValueEntityList, FilterValueCustom, FilterValueNested, PowerSearchFilter, PartialFilter, EnumItem, PowerSearchEntity, DateTimeRange, DateTimeRangePart, DateRangeFilterPreset, RelativeDateFilterPreset, OperatorTokenizationConfig, PowerSearchChangeType, PowerSearchHandle, PowerSearchTokenProps, PowerSearchEditorProps, PowerSearchComponentOverride, PowerSearchComponents, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/PowerSearch/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAC,gBAAgB,EAAE,eAAe,EAAC,MAAM,eAAe,CAAC;AAErE,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,uBAAuB,EAAC,MAAM,2BAA2B,CAAC;AAElE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAC,eAAe,EAAE,SAAS,EAAC,MAAM,wBAAwB,CAAC;AAEvE,YAAY,EAEV,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EAGnB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EAGnB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAGjB,iBAAiB,EACjB,aAAa,EAGb,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAGjB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAC,gBAAgB,EAAE,eAAe,EAAC,MAAM,eAAe,CAAC;AAErE,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,uBAAuB,EAAC,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAC,eAAe,EAAE,SAAS,EAAC,MAAM,wBAAwB,CAAC;AAEvE,YAAY,EAEV,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAG9B,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EAGnB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAGjB,iBAAiB,EACjB,aAAa,EAGb,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAGjB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/dist/PowerSearch/index.js

@@ -13,4 +13,5 @@
 export { PowerSearch } from "./PowerSearch.js";
 export { PowerSearchToken } from "./PowerSearchToken.js";
 export { PowerSearchFilterEditor } from "./PowerSearchFilterEditor.js";
+export { resolveOperatorLabel } from "./resolveOperatorLabel.js";
 export { createPowerSearchConfig, usePowerSearchConfig } from "./usePowerSearchConfig.js";

package/dist/PowerSearch/resolveOperatorLabel.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file resolveOperatorLabel.ts
+ * @input PowerSearchOperator + translator function
+ * @output Display string for the operator label
+ * @position Shared label-resolution helper used at every render site that
+ *   reads an operator's display text (PowerSearch.tsx, PowerSearchToken.tsx,
+ *   PowerSearchEditPopover.tsx, usePowerSearchSource.ts).
+ *
+ * A PowerSearchOperator is a discriminated union of two variants:
+ *   - `{key, value, label}`     — consumer-supplied raw text (used verbatim)
+ *   - `{key, value, i18nKey}`   — catalog-driven text (looked up via t())
+ *
+ * Astryx's shipped default operators use the i18nKey variant; consumers
+ * writing custom operators typically use the label variant.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/PowerSearch/types.ts (PowerSearchOperator type)
+ * - /packages/core/src/PowerSearch/index.ts (re-export)
+ */
+import type { TranslatorFn } from '../i18n';
+import type { PowerSearchOperator } from './types';
+export declare function resolveOperatorLabel(operator: PowerSearchOperator, t: TranslatorFn): string;
+//# sourceMappingURL=resolveOperatorLabel.d.ts.map

package/dist/PowerSearch/resolveOperatorLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOperatorLabel.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/resolveOperatorLabel.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,SAAS,CAAC;AAEjD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,mBAAmB,EAC7B,CAAC,EAAE,YAAY,GACd,MAAM,CAKR"}

package/dist/PowerSearch/resolveOperatorLabel.js

@@ -0,0 +1,28 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file resolveOperatorLabel.ts
+ * @input PowerSearchOperator + translator function
+ * @output Display string for the operator label
+ * @position Shared label-resolution helper used at every render site that
+ *   reads an operator's display text (PowerSearch.tsx, PowerSearchToken.tsx,
+ *   PowerSearchEditPopover.tsx, usePowerSearchSource.ts).
+ *
+ * A PowerSearchOperator is a discriminated union of two variants:
+ *   - `{key, value, label}`     — consumer-supplied raw text (used verbatim)
+ *   - `{key, value, i18nKey}`   — catalog-driven text (looked up via t())
+ *
+ * Astryx's shipped default operators use the i18nKey variant; consumers
+ * writing custom operators typically use the label variant.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/PowerSearch/types.ts (PowerSearchOperator type)
+ * - /packages/core/src/PowerSearch/index.ts (re-export)
+ */
+
+export function resolveOperatorLabel(operator, t) {
+  if ('label' in operator && operator.label !== undefined) {
+    return operator.label;
+  }
+  return t(operator.i18nKey);
+}

package/dist/PowerSearch/types.d.ts

@@ -195,11 +195,37 @@ export interface RelativeDateFilterPreset {
     readonly label: string;
     readonly value: string;
 }
-export interface PowerSearchOperator {
+export interface PowerSearchOperatorBase {
     readonly key: string;
-    readonly label: string;
     readonly value: OperatorValue;
 }
+/**
+ * Operator variant that provides its label as raw text. The consumer owns
+ * translation of that string. Use this for genuinely custom operator labels
+ * that don't correspond to an entry in astryx's shipped translation catalog
+ * (e.g. `label: 'in my rotations'`).
+ */
+export interface PowerSearchOperatorWithLabel extends PowerSearchOperatorBase {
+    readonly label: string;
+    readonly i18nKey?: never;
+}
+/**
+ * Operator variant that references a translation-catalog key. The library
+ * looks the key up against the active InternationalizationProvider locale.
+ * Use `@astryx.powersearch.operator.*` for astryx's shipped defaults, or a
+ * key from your own catalog registered via InternationalizationProvider
+ * `messages` / `overrides` props.
+ */
+export interface PowerSearchOperatorWithI18nKey extends PowerSearchOperatorBase {
+    readonly i18nKey: string;
+    readonly label?: never;
+}
+/**
+ * A discriminated union: an operator must supply EXACTLY ONE of `label`
+ * (raw text) or `i18nKey` (catalog lookup). The type system prevents
+ * accidental omission — a bare `{key, value}` is a compile error.
+ */
+export type PowerSearchOperator = PowerSearchOperatorWithLabel | PowerSearchOperatorWithI18nKey;
 export interface PowerSearchField {
     readonly key: string;
     readonly label: string;