@astryxdesign/core 0.7.7 → 0.7.8-canary.0d54fd3

package/dist/PowerSearch/PowerSearchValueEditor.js

@@ -4,29 +4,34 @@
 
 /**
  * @file PowerSearchValueEditor.tsx
- * @input OperatorValue, FilterValue, onChange callback
+ * @input OperatorValue, FilterValue, onChange callback, and the presentation
+ *   the editor renders in
  * @output Renders the appropriate editor for a filter value type
- * @position Sub-component; consumed by PowerSearchEditPopover
+ * @position Sub-component; consumed by PowerSearchEditPopover (popover
+ *   presentation) and PowerSearchBottomSheet (sheet presentation, which
+ *   renders the closed vocabularies as rows itself)
  *
  * SYNC: When modified, update:
  * - /packages/core/src/PowerSearch/index.ts
  */
-import React, { useCallback, useMemo, useRef } from 'react';
+import React, { useCallback, useMemo, useRef, useState } from 'react';
 // Lazy import to avoid circular deps — these are all from the same package
 import { TextInput } from "../TextInput/index.js";
 import { NumberInput } from "../NumberInput/index.js";
 import { resolveNumberInputCommit } from "../NumberInput/numberInputCommit.js";
 import { DateInput } from "../DateInput/index.js";
+import { isoDateTimeToUnixSeconds, isoDateToUnixSeconds, resolveDateZone, unixSecondsToISODate, unixSecondsToISODateTime } from "./powerSearchDateZone.js";
+import { HStack } from "../HStack/HStack.js";
 import { DateRangeInput } from "../DateRangeInput/index.js";
 import { resolveDateTimeRangePart } from "./resolveDateTimeRangePart.js";
 import { TimeInput } from "../TimeInput/index.js";
 import { Selector } from "../Selector/index.js";
-import { Tokenizer } from "../Tokenizer/index.js";
+import { Tokenizer } from "../Tokenizer/Tokenizer.js";
 import { Typeahead } from "../Typeahead/index.js";
 import { useLocale } from "../i18n/index.js";
 import { registerEnglishFallback, useComponentTranslator } from "../i18n/useComponentTranslator.js";
 import english from "../i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.js";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 registerEnglishFallback(english);
 // =============================================================================
 // Helpers
@@ -49,8 +54,8 @@ function enumItemsToSearchableItems(values) {
     label: item.label
   }));
 }
-function dateRangePartToISO(part, nowSeconds) {
-  return new Date(resolveDateTimeRangePart(part, nowSeconds) * 1000).toISOString().split('T')[0];
+function dateRangePartToISO(part, nowSeconds, zone) {
+  return unixSecondsToISODate(resolveDateTimeRangePart(part, nowSeconds), zone);
 }
 
 // =============================================================================
@@ -63,9 +68,11 @@ function StringEditor({
   onChange,
   onEnter: _onEnter,
   maxMenuItems,
-  isDisabled
+  isDisabled,
+  presentation
 }) {
   const t = useComponentTranslator();
+  const width = presentation === 'bottom-sheet' ? '100%' : undefined;
   const currentValue = filterValue?.type === 'string' ? filterValue.value : '';
 
   // When a searchSource is provided, render a typeahead instead of a plain
@@ -96,7 +103,8 @@ function StringEditor({
       },
       placeholder: t('@astryx.powersearch.valueEditor.searchPlaceholder'),
       debounceMs: 150,
-      maxMenuItems: maxMenuItems
+      maxMenuItems: maxMenuItems,
+      width: width
     });
   }
   return /*#__PURE__*/_jsx(TextInput, {
@@ -110,7 +118,8 @@ function StringEditor({
         type: 'string',
         value
       });
-    }
+    },
+    width: width
   });
 }
 function StringListEditor({
@@ -118,9 +127,12 @@ function StringListEditor({
   filterValue,
   onChange,
   maxMenuItems,
-  isDisabled
+  isDisabled,
+  presentation,
+  fieldLabel
 }) {
   const t = useComponentTranslator();
+  const isSheet = presentation === 'bottom-sheet';
   const currentValue = useMemo(() => {
     if (filterValue?.type !== 'string_list') {
       return [];
@@ -144,8 +156,12 @@ 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;
+
+  // In the sheet presentation the list value edits through the Tokenizer's
+  // own sheet, titled with the field's label; a popover menu inside a sheet
+  // would stack a second anchored layer on a surface the person is already in.
   return /*#__PURE__*/_jsx(Tokenizer, {
-    label: t('@astryx.powersearch.valueEditor.values'),
+    label: isSheet && fieldLabel != null ? fieldLabel : t('@astryx.powersearch.valueEditor.values'),
     isLabelHidden: true,
     isDisabled: isDisabled,
     searchSource: source,
@@ -159,7 +175,9 @@ function StringListEditor({
     placeholder: t('@astryx.powersearch.valueEditor.addValuesPlaceholder'),
     debounceMs: operatorValue.searchSource ? 150 : 0,
     hasCreate: hasCreate,
-    maxMenuItems: maxMenuItems
+    maxMenuItems: maxMenuItems,
+    width: isSheet ? '100%' : undefined,
+    presentation: isSheet ? 'bottom-sheet' : 'popover'
   });
 }
 function useNumberEditorHandlers({
@@ -168,7 +186,9 @@ function useNumberEditorHandlers({
   max,
   isIntegerOnly,
   onChange,
-  onEnter
+  onEnter,
+  onUnstage,
+  stagesAsTyped
 }) {
   const locale = useLocale();
   const pendingDecisionRef = useRef(null);
@@ -186,14 +206,23 @@ function useNumberEditorHandlers({
     pendingDecisionRef.current = null;
   }, []);
   const handleInput = useCallback(event => {
-    pendingDecisionRef.current = resolveNumberInputCommit(event.currentTarget.value, {
+    const decision = resolveNumberInputCommit(event.currentTarget.value, {
       min,
       max,
       isIntegerOnly,
       locale,
       hasClear: false
     });
-  }, [isIntegerOnly, locale, max, min]);
+    pendingDecisionRef.current = decision;
+    if (stagesAsTyped) {
+      if (decision.type === 'commit') {
+        onChange(toFilterValue(decision.value));
+      } else {
+        // Cleared, or not a number: nothing stands to confirm.
+        onUnstage?.();
+      }
+    }
+  }, [isIntegerOnly, locale, max, min, onChange, onUnstage, stagesAsTyped, toFilterValue]);
   const handleEnter = useCallback(() => {
     const decision = pendingDecisionRef.current;
     pendingDecisionRef.current = null;
@@ -221,7 +250,9 @@ function IntegerEditor({
   filterValue,
   onChange,
   onEnter,
-  isDisabled
+  onUnstage,
+  isDisabled,
+  presentation
 }) {
   const t = useComponentTranslator();
   const currentValue = filterValue?.type === 'integer' ? filterValue.value : undefined;
@@ -231,7 +262,9 @@ function IntegerEditor({
     max: operatorValue.maxValue,
     isIntegerOnly: true,
     onChange,
-    onEnter
+    onEnter,
+    onUnstage,
+    stagesAsTyped: presentation === 'bottom-sheet'
   });
   return /*#__PURE__*/_jsx(NumberInput, {
     label: t('@astryx.powersearch.valueEditor.value'),
@@ -247,7 +280,8 @@ function IntegerEditor({
     max: operatorValue.maxValue,
     units: operatorValue.units,
     isIntegerOnly: true,
-    placeholder: t('@astryx.powersearch.valueEditor.enterNumberPlaceholder')
+    placeholder: t('@astryx.powersearch.valueEditor.enterNumberPlaceholder'),
+    width: presentation === 'bottom-sheet' ? '100%' : undefined
   });
 }
 function FloatEditor({
@@ -255,7 +289,9 @@ function FloatEditor({
   filterValue,
   onChange,
   onEnter,
-  isDisabled
+  onUnstage,
+  isDisabled,
+  presentation
 }) {
   const t = useComponentTranslator();
   const currentValue = filterValue?.type === 'float' ? filterValue.value : undefined;
@@ -265,7 +301,9 @@ function FloatEditor({
     max: operatorValue.maxValue,
     isIntegerOnly: false,
     onChange,
-    onEnter
+    onEnter,
+    onUnstage,
+    stagesAsTyped: presentation === 'bottom-sheet'
   });
   return /*#__PURE__*/_jsx(NumberInput, {
     label: t('@astryx.powersearch.valueEditor.value'),
@@ -280,14 +318,16 @@ function FloatEditor({
     min: operatorValue.minValue,
     max: operatorValue.maxValue,
     units: operatorValue.units,
-    placeholder: t('@astryx.powersearch.valueEditor.enterNumberPlaceholder')
+    placeholder: t('@astryx.powersearch.valueEditor.enterNumberPlaceholder'),
+    width: presentation === 'bottom-sheet' ? '100%' : undefined
   });
 }
 function TimeEditor({
   operatorValue,
   filterValue,
   onChange,
-  isDisabled
+  isDisabled,
+  presentation
 }) {
   const t = useComponentTranslator();
   const currentValue = filterValue?.type === 'time' ? filterValue.value : undefined;
@@ -305,39 +345,173 @@ function TimeEditor({
       }
     },
     min: operatorValue.minValue,
-    max: operatorValue.maxValue
+    max: operatorValue.maxValue,
+    width: presentation === 'bottom-sheet' ? '100%' : undefined
+  });
+}
+
+/**
+ * A value with a time of day: its wall-clock time in `zone`, read and written
+ * as one instant through a date picker beside a time field.
+ */
+function DateTimeEditor({
+  label,
+  isDisabled,
+  presentation,
+  unixSeconds,
+  zone,
+  onChange
+}) {
+  const t = useComponentTranslator();
+  const [datePart, timePart] = useMemo(() => {
+    if (unixSeconds == null) {
+      return [undefined, undefined];
+    }
+    const [date, time] = unixSecondsToISODateTime(unixSeconds, zone).split('T');
+    return [date, time];
+  }, [unixSeconds, zone]);
+  // A part picked first waits for the other. The editor writes the instant
+  // once both parts exist.
+  const [pendingDate, setPendingDate] = useState();
+  const [pendingTime, setPendingTime] = useState();
+  const date = datePart ?? pendingDate;
+  const time = timePart ?? pendingTime;
+  const commit = (nextDate, nextTime) => {
+    if (nextDate == null || nextTime == null) {
+      return;
+    }
+    onChange({
+      type: 'date_absolute',
+      unixSeconds: isoDateTimeToUnixSeconds(`${nextDate}T${nextTime}`, zone)
+    });
+  };
+  const width = presentation === 'bottom-sheet' ? '100%' : undefined;
+  // A nested sub-filter row keeps its selectors' widths, so the pair wraps
+  // where the value cell is narrower than the two inputs.
+  return /*#__PURE__*/_jsxs(HStack, {
+    gap: 2,
+    wrap: "wrap",
+    children: [/*#__PURE__*/_jsx(DateInput, {
+      label: label,
+      isLabelHidden: true,
+      isDisabled: isDisabled,
+      value: date,
+      onChange: value => {
+        setPendingDate(value);
+        commit(value, time);
+      },
+      width: width
+    }), /*#__PURE__*/_jsx(TimeInput, {
+      label: t('@astryx.powersearch.valueEditor.time'),
+      isLabelHidden: true,
+      isDisabled: isDisabled,
+      value: time,
+      onChange: value => {
+        setPendingTime(value);
+        commit(date, value);
+      },
+      width: width
+    })]
   });
 }
 function DateAbsoluteEditor({
+  operatorValue,
   filterValue,
   onChange,
-  isDisabled
+  isDisabled,
+  presentation,
+  timezoneID
 }) {
   const t = useComponentTranslator();
-  // Convert unixSeconds to ISO date string for the date input
-  const currentValue = useMemo(() => {
-    if (filterValue?.type !== 'date_absolute') {
-      return undefined;
-    }
-    const date = new Date(filterValue.unixSeconds * 1000);
-    return date.toISOString().split('T')[0];
-  }, [filterValue]);
+  const label = t('@astryx.powersearch.valueEditor.date');
+  const unixSeconds = filterValue?.type === 'date_absolute' ? filterValue.unixSeconds : undefined;
+  if (operatorValue.isDateOnly === false) {
+    return /*#__PURE__*/_jsx(DateTimeEditor, {
+      label: label,
+      isDisabled: isDisabled,
+      presentation: presentation,
+      unixSeconds: unixSeconds,
+      zone: resolveDateZone(timezoneID, false),
+      onChange: onChange
+    });
+  }
+
+  // A calendar day edits in the one zone the token and the label read it in.
+  const zone = resolveDateZone(timezoneID, true);
   return /*#__PURE__*/_jsx(DateInput, {
-    label: t('@astryx.powersearch.valueEditor.date'),
+    label: label,
     isLabelHidden: true,
     isDisabled: isDisabled,
-    value: currentValue,
+    value: unixSeconds == null ? undefined : unixSecondsToISODate(unixSeconds, zone),
     onChange: value => {
       if (value != null) {
-        const unixSeconds = Math.floor(new Date(value).getTime() / 1000);
         onChange({
           type: 'date_absolute',
-          unixSeconds
+          unixSeconds: isoDateToUnixSeconds(value, zone)
         });
       }
-    }
+    },
+    width: presentation === 'bottom-sheet' ? '100%' : undefined
   });
 }
+const RELATIVE_DATE_UNITS = [{
+  unit: 'day',
+  plural: 'days',
+  amounts: [1, 3, 7, 14, 30],
+  ago: '@astryx.powersearch.sheet.relativeDaysAgo',
+  fromNow: '@astryx.powersearch.sheet.relativeDaysFromNow'
+}, {
+  unit: 'week',
+  plural: 'weeks',
+  amounts: [1, 2, 4],
+  ago: '@astryx.powersearch.sheet.relativeWeeksAgo',
+  fromNow: '@astryx.powersearch.sheet.relativeWeeksFromNow'
+}, {
+  unit: 'month',
+  plural: 'months',
+  amounts: [1, 3, 6, 12],
+  ago: '@astryx.powersearch.sheet.relativeMonthsAgo',
+  fromNow: '@astryx.powersearch.sheet.relativeMonthsFromNow'
+}];
+
+/**
+ * The relative-date choices an operator offers, in display order. Shared by
+ * the popover's Selector and the sheet presentation's rows so both list the
+ * same values. With `t` the labels resolve through the catalog's ICU plural
+ * messages (the sheet presentation's rows); without it they are the popover
+ * editor's own literals. In English the two read identically.
+ */
+export function buildRelativeDateOptions(operatorValue, t) {
+  const result = [];
+  for (const {
+    unit,
+    plural,
+    amounts,
+    ago,
+    fromNow
+  } of RELATIVE_DATE_UNITS) {
+    for (const amount of amounts) {
+      const unitWord = amount === 1 ? unit : plural;
+      if (operatorValue.isPastAllowed !== false) {
+        result.push({
+          value: `${amount}${unit[0]}_ago`,
+          label: t ? t(ago, {
+            count: amount
+          }) : `${amount} ${unitWord} ago`
+        });
+      }
+      if (operatorValue.isFutureAllowed !== false) {
+        result.push({
+          value: `${amount}${unit[0]}_from_now`,
+          label: t ? t(fromNow, {
+            count: amount
+          }) : `${amount} ${unitWord} from now`
+        });
+      }
+    }
+  }
+  return result;
+}
 function DateRelativeEditor({
   operatorValue,
   filterValue,
@@ -346,40 +520,18 @@ function DateRelativeEditor({
 }) {
   const t = useComponentTranslator();
   const currentValue = filterValue?.type === 'date_relative' ? filterValue.value : undefined;
-  const options = useMemo(() => {
-    const result = [];
-    const units = [{
-      unit: 'day',
-      plural: 'days'
-    }, {
-      unit: 'week',
-      plural: 'weeks'
-    }, {
-      unit: 'month',
-      plural: 'months'
-    }];
-    for (const {
-      unit,
-      plural
-    } of units) {
-      const amounts = unit === 'day' ? [1, 3, 7, 14, 30] : unit === 'week' ? [1, 2, 4] : [1, 3, 6, 12];
-      for (const amount of amounts) {
-        if (operatorValue.isPastAllowed !== false) {
-          result.push({
-            value: `${amount}${unit[0]}_ago`,
-            label: `${amount} ${amount === 1 ? unit : plural} ago`
-          });
-        }
-        if (operatorValue.isFutureAllowed !== false) {
-          result.push({
-            value: `${amount}${unit[0]}_from_now`,
-            label: `${amount} ${amount === 1 ? unit : plural} from now`
-          });
-        }
-      }
-    }
-    return result;
-  }, [operatorValue.isPastAllowed, operatorValue.isFutureAllowed]);
+
+  // The choices depend on the two flags only; a config that rebuilds its
+  // operator objects per render keeps the same memoized list.
+  const {
+    isPastAllowed,
+    isFutureAllowed
+  } = operatorValue;
+  const options = useMemo(() => buildRelativeDateOptions({
+    type: 'date_relative',
+    isPastAllowed,
+    isFutureAllowed
+  }), [isPastAllowed, isFutureAllowed]);
   return /*#__PURE__*/_jsx(Selector, {
     label: t('@astryx.powersearch.valueEditor.relativeDate'),
     isLabelHidden: true,
@@ -397,9 +549,13 @@ function DateRelativeEditor({
 function DateRangeEditor({
   filterValue,
   onChange,
-  isDisabled
+  isDisabled,
+  presentation,
+  timezoneID
 }) {
   const t = useComponentTranslator();
+  // A range part is a calendar day, read and written as a date-only value is.
+  const zone = resolveDateZone(timezoneID, true);
   const currentValue = useMemo(() => {
     if (filterValue?.type !== 'date_range') {
       return null;
@@ -410,10 +566,10 @@ function DateRangeEditor({
     } = filterValue.value;
     const nowSeconds = Date.now() / 1000;
     return {
-      start: dateRangePartToISO(start, nowSeconds),
-      end: dateRangePartToISO(end, nowSeconds)
+      start: dateRangePartToISO(start, nowSeconds, zone),
+      end: dateRangePartToISO(end, nowSeconds, zone)
     };
-  }, [filterValue]);
+  }, [filterValue, zone]);
   const handleChange = useCallback(range => {
     if (range == null) {
       return;
@@ -423,15 +579,15 @@ function DateRangeEditor({
       value: {
         start: {
           type: 'ABSOLUTE',
-          unixSeconds: Date.parse(`${range.start}T00:00:00Z`) / 1000
+          unixSeconds: isoDateToUnixSeconds(range.start, zone)
         },
         end: {
           type: 'ABSOLUTE',
-          unixSeconds: Date.parse(`${range.end}T00:00:00Z`) / 1000
+          unixSeconds: isoDateToUnixSeconds(range.end, zone)
         }
       }
     });
-  }, [onChange]);
+  }, [onChange, zone]);
   const handleKeyDown = useCallback(event => {
     // DateRangeInput owns an inner popover. Its Enter activation must not reach
     // the parent PowerSearch shortcut before the focused button's click runs.
@@ -448,6 +604,10 @@ function DateRangeEditor({
       value: currentValue,
       onChange: handleChange,
       hasClear: false
+      // A phone-wide sheet fits one month; the popover keeps the default.
+      ,
+      numberOfMonths: presentation === 'bottom-sheet' ? 1 : undefined,
+      width: presentation === 'bottom-sheet' ? '100%' : undefined
     })
   });
 }
@@ -517,7 +677,8 @@ function EnumListEditor({
     // all of them instead of BaseTypeahead's 10-suggestion default, which
     // would silently drop valid choices with no way to reach them.
     ,
-    maxMenuItems: items.length
+    maxMenuItems: items.length,
+    presentation: "popover"
   });
 }
 function EntityListEditor({
@@ -525,9 +686,12 @@ function EntityListEditor({
   filterValue,
   onChange,
   maxMenuItems,
-  isDisabled
+  isDisabled,
+  presentation,
+  fieldLabel
 }) {
   const t = useComponentTranslator();
+  const isSheet = presentation === 'bottom-sheet';
   const source = useMemo(() => {
     if (operatorValue.searchSource) {
       return operatorValue.searchSource;
@@ -551,8 +715,11 @@ function EntityListEditor({
       } : undefined
     }));
   }, [filterValue]);
+
+  // Sheet presentation: the Tokenizer's own sheet, titled with the field
+  // label, as for string_list.
   return /*#__PURE__*/_jsx(Tokenizer, {
-    label: t('@astryx.powersearch.valueEditor.entities'),
+    label: isSheet && fieldLabel != null ? fieldLabel : t('@astryx.powersearch.valueEditor.entities'),
     isLabelHidden: true,
     isDisabled: isDisabled,
     searchSource: source,
@@ -576,7 +743,9 @@ function EntityListEditor({
     renderItem: operatorValue.renderItem,
     placeholder: t('@astryx.powersearch.valueEditor.searchPlaceholder'),
     debounceMs: operatorValue.searchSource ? 150 : 0,
-    maxMenuItems: maxMenuItems
+    maxMenuItems: maxMenuItems,
+    width: isSheet ? '100%' : undefined,
+    presentation: isSheet ? 'bottom-sheet' : 'popover'
   });
 }
 function CustomEditor({
@@ -613,7 +782,11 @@ export function PowerSearchValueEditor({
   onChange,
   onEnter,
   maxMenuItems,
-  isDisabled
+  isDisabled,
+  onUnstage,
+  presentation = 'popover',
+  fieldLabel,
+  timezoneID
 }) {
   switch (operatorValue.type) {
     case 'empty':
@@ -621,6 +794,7 @@ export function PowerSearchValueEditor({
     case 'string':
       return /*#__PURE__*/_jsx(StringEditor, {
         isDisabled: isDisabled,
+        presentation: presentation,
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange,
@@ -630,6 +804,8 @@ export function PowerSearchValueEditor({
     case 'string_list':
       return /*#__PURE__*/_jsx(StringListEditor, {
         isDisabled: isDisabled,
+        presentation: presentation,
+        fieldLabel: fieldLabel,
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange,
@@ -638,6 +814,8 @@ export function PowerSearchValueEditor({
     case 'integer':
       return /*#__PURE__*/_jsx(IntegerEditor, {
         isDisabled: isDisabled,
+        presentation: presentation,
+        onUnstage: onUnstage,
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange,
@@ -646,6 +824,8 @@ export function PowerSearchValueEditor({
     case 'float':
       return /*#__PURE__*/_jsx(FloatEditor, {
         isDisabled: isDisabled,
+        presentation: presentation,
+        onUnstage: onUnstage,
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange,
@@ -654,6 +834,7 @@ export function PowerSearchValueEditor({
     case 'time':
       return /*#__PURE__*/_jsx(TimeEditor, {
         isDisabled: isDisabled,
+        presentation: presentation,
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange
@@ -661,9 +842,11 @@ export function PowerSearchValueEditor({
     case 'date_absolute':
       return /*#__PURE__*/_jsx(DateAbsoluteEditor, {
         isDisabled: isDisabled,
+        presentation: presentation,
         operatorValue: operatorValue,
         filterValue: filterValue,
-        onChange: onChange
+        onChange: onChange,
+        timezoneID: timezoneID
       });
     case 'date_relative':
       return /*#__PURE__*/_jsx(DateRelativeEditor, {
@@ -675,9 +858,11 @@ export function PowerSearchValueEditor({
     case 'date_range':
       return /*#__PURE__*/_jsx(DateRangeEditor, {
         isDisabled: isDisabled,
+        presentation: presentation,
         operatorValue: operatorValue,
         filterValue: filterValue,
-        onChange: onChange
+        onChange: onChange,
+        timezoneID: timezoneID
       });
     case 'enum':
       return /*#__PURE__*/_jsx(EnumEditor, {
@@ -696,6 +881,8 @@ export function PowerSearchValueEditor({
     case 'entity_list':
       return /*#__PURE__*/_jsx(EntityListEditor, {
         isDisabled: isDisabled,
+        presentation: presentation,
+        fieldLabel: fieldLabel,
         operatorValue: operatorValue,
         filterValue: filterValue,
         onChange: onChange,

package/dist/PowerSearch/formatFilterValue.d.ts

@@ -10,14 +10,21 @@
 import type { OperatorValue, FilterValue } from './types.js';
 import type { InternalConfig } from './useInternalConfig.js';
 import type { Locale, TranslatorFn } from '../i18n/index.js';
-export declare function formatDateAbsolute(unixSeconds: number, locale: Locale, timezoneID?: string): string;
 /**
- * Compact date-only rendering (no time-of-day) for the token pill's inline
- * value display, which has less room than the editor's full summary. Kept
- * separate from {@link formatDateAbsolute} rather than reusing it with
- * different options threaded through a param, since the two callers want
- * genuinely different shapes, not a parameterization of the same one.
+ * A number in the provider locale's digits, decimal mark, and — unless the
+ * options say otherwise — grouping. The shared number helper for
+ * PowerSearch's own readings of a value — this module owns the raw `Intl`
+ * access.
  */
-export declare function formatDateAbsoluteCompact(unixSeconds: number, locale: Locale): string;
+export declare function formatSharedNumber(value: number, locale: Locale, options?: Pick<Intl.NumberFormatOptions, 'useGrouping' | 'maximumFractionDigits'>): string;
+/**
+ * The one reading of a calendar-day `date_absolute` value: its day in the
+ * zone `resolveDateZone` names. The token text and the accessible label share
+ * it; the editors read the same zone through `resolveDateZone`, so a value
+ * never reads as two days in one field. A value whose operator sets
+ * `isDateOnly: false` is an instant: its date and time in `timezoneID`,
+ * else the viewer's zone, the time its editor reads and writes.
+ */
+export declare function formatDateAbsolute(unixSeconds: number, locale: Locale, timezoneID: string | undefined, isDateOnly?: boolean): string;
 export declare function formatFilterValue(_config: InternalConfig, operatorValue: OperatorValue, filterValue: FilterValue, maxLength: number, t: TranslatorFn, locale: Locale, timezoneID?: string): string;
 //# sourceMappingURL=formatFilterValue.d.ts.map