@astryxdesign/core 0.7.7 → 0.7.8-canary.07ee4b5

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;AACxD,OAAO,KAAK,EAAC,MAAM,EAAE,YAAY,EAAC,MAAM,SAAS,CAAC;AAwBlD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CAOR;AAcD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,CAAC,EAAE,YAAY,EACf,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAwHR"}
+{"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,MAAM,EAAE,YAAY,EAAC,MAAM,SAAS,CAAC;AAyBlD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,IAAI,CACZ,IAAI,CAAC,mBAAmB,EACxB,aAAa,GAAG,uBAAuB,CACxC,GACA,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,UAAO,GAChB,MAAM,CAmBR;AAcD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,CAAC,EAAE,YAAY,EACf,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA8HR"}

package/dist/PowerSearch/formatFilterValue.js

@@ -13,6 +13,7 @@
 import { truncateCharacters } from "../utils/characters.js";
 import { registerEnglishFallback } from "../i18n/englishFallback.js";
 import english from "../i18n/generated-english/PowerSearch/formatFilterValue.generated.js";
+import { resolveDateZone } from "./powerSearchDateZone.js";
 registerEnglishFallback(english);
 function truncate(str, maxLength) {
   return truncateCharacters(str, maxLength);
@@ -22,38 +23,45 @@ function formatEnumLabel(value, enumValues) {
   return item?.label ?? value;
 }
 function formatNumber(value, locale, units) {
-  const formatted = new Intl.NumberFormat(locale).format(value);
+  const formatted = formatSharedNumber(value, locale);
   return units ? `${formatted} ${units}` : formatted;
 }
-export function formatDateAbsolute(unixSeconds, locale, timezoneID) {
-  const options = {
-    year: 'numeric',
-    month: 'short',
-    day: 'numeric',
-    hour: 'numeric',
-    minute: '2-digit',
-    ...(timezoneID ? {
-      timeZone: timezoneID
-    } : {}),
-    calendar: 'gregory'
-  };
-  return new Intl.DateTimeFormat(locale, options).format(unixSeconds * 1000);
+
+/**
+ * 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 function formatSharedNumber(value, locale, options) {
+  return new Intl.NumberFormat(locale, options).format(value);
 }
 
 /**
- * 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.
+ * 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 function formatDateAbsoluteCompact(unixSeconds, locale) {
-  return new Intl.DateTimeFormat(locale, {
+export function formatDateAbsolute(unixSeconds, locale, timezoneID, isDateOnly = true) {
+  const options = isDateOnly ? {
     year: 'numeric',
     month: 'short',
     day: 'numeric',
+    timeZone: resolveDateZone(timezoneID, true),
     calendar: 'gregory'
-  }).format(unixSeconds * 1000);
+  } : {
+    year: 'numeric',
+    month: 'short',
+    day: 'numeric',
+    hour: 'numeric',
+    minute: '2-digit',
+    timeZone: resolveDateZone(timezoneID, false),
+    calendar: 'gregory'
+  };
+  return new Intl.DateTimeFormat(locale, options).format(unixSeconds * 1000);
 }
 function formatRelativeDate(value) {
   // value is stored as a descriptive string like "7d" or "1w"
@@ -140,7 +148,7 @@ export function formatFilterValue(_config, operatorValue, filterValue, maxLength
     case 'time':
       return filterValue.value;
     case 'date_absolute':
-      return truncate(formatDateAbsolute(filterValue.unixSeconds, locale, timezoneID), maxLength);
+      return truncate(formatDateAbsolute(filterValue.unixSeconds, locale, timezoneID, operatorValue.type !== 'date_absolute' || operatorValue.isDateOnly !== false), maxLength);
     case 'date_relative':
       return formatRelativeDate(filterValue.value);
     case 'date_range':

package/dist/PowerSearch/formatTokenValue.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview The text a PowerSearch filter token shows for a value.
+ *
+ * @input `OperatorValue`, `FilterValue`, a width budget, and the locale.
+ * @output `formatTokenValueText` — one string, or null for an empty value.
+ * @position Shared by the token itself (`PowerSearch.tsx`) and the sheet
+ * presentation's Filters rows and removal announcement
+ * (`PowerSearchBottomSheet.tsx`), so every reading of a value on the field
+ * uses the same words and the same zone handling.
+ */
+import type { OperatorValue, FilterValue } from './types.js';
+import type { Locale, TranslatorFn } from '../i18n/index.js';
+type ListFormatFn = (items: ReadonlyArray<string>) => string;
+/**
+ * The text a filter token shows for a value: the one place that decides how
+ * a value reads on the field, so every other reading of the same value —
+ * the sheet presentation's Filters rows and its removal announcement — can
+ * use the same words and the same zone handling. `maxLength` is the token's
+ * width budget; pass `Number.MAX_SAFE_INTEGER` for the untruncated text.
+ * With `t`, the list, date-range and nested summaries resolve through the
+ * catalog (`@astryx.powersearch.valueEditor.*`); without it they are the
+ * token's own literals. With `formatList` (the provider's list formatter),
+ * several labels join as a list in the locale; without it they join with
+ * the token's literal ", ".
+ */
+export declare function formatTokenValueText(operatorValue: OperatorValue, filterValue: FilterValue, maxLength: number, locale: Locale, t?: TranslatorFn, formatList?: ListFormatFn, timezoneID?: string): string | null;
+export {};
+//# sourceMappingURL=formatTokenValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatTokenValue.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/formatTokenValue.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAE,WAAW,EAAW,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAC,MAAM,EAAE,YAAY,EAAC,MAAM,SAAS,CAAC;AAQlD,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;AA6E7D;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,CAAC,CAAC,EAAE,YAAY,EAChB,UAAU,CAAC,EAAE,YAAY,EACzB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAoGf"}

package/dist/PowerSearch/formatTokenValue.js

@@ -0,0 +1,161 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @fileoverview The text a PowerSearch filter token shows for a value.
+ *
+ * @input `OperatorValue`, `FilterValue`, a width budget, and the locale.
+ * @output `formatTokenValueText` — one string, or null for an empty value.
+ * @position Shared by the token itself (`PowerSearch.tsx`) and the sheet
+ * presentation's Filters rows and removal announcement
+ * (`PowerSearchBottomSheet.tsx`), so every reading of a value on the field
+ * uses the same words and the same zone handling.
+ */
+
+import { truncateCharacters } from "../utils/characters.js";
+import { formatDateAbsolute, formatSharedNumber } from "./formatFilterValue.js";
+import { registerEnglishFallback } from "../i18n/englishFallback.js";
+import english from "../i18n/generated-english/PowerSearch/formatTokenValue.generated.js";
+registerEnglishFallback(english);
+function truncateString(value, limit) {
+  // Same semantics as before — strings within limit + 3 pass through, longer
+  // ones cut to limit + '...' — but counted in characters, not code units.
+  return truncateCharacters(value, limit + 3, '...');
+}
+function getEnumLabel(values, value) {
+  return values.find(v => v.value === value)?.label ?? value;
+}
+
+// Intl's maximum fraction cap: no number the row formats is rounded.
+const MAX_FRACTION_DIGITS = 100;
+
+// Whether a locale writes a number with the token's own numerals: Latin
+// digits and a `.` decimal mark, so `String(value)` is already the locale's
+// reading. Probed once per locale through the shared number helper.
+const tokenNumeralLocales = new Map();
+function usesTokenNumerals(locale) {
+  let uses = tokenNumeralLocales.get(locale);
+  if (uses == null) {
+    uses = formatSharedNumber(1234567.5, locale, {
+      useGrouping: false,
+      maximumFractionDigits: MAX_FRACTION_DIGITS
+    }) === '1234567.5';
+    tokenNumeralLocales.set(locale, uses);
+  }
+  return uses;
+}
+
+// A number as the token reads it. Where the locale writes Latin digits and a
+// `.` decimal mark, use the token's own text, `String(value)`. Elsewhere, use
+// the locale's digits and decimal mark, with no grouping and no rounding: the
+// fraction cap is Intl's maximum, so `1e-21` keeps its digits.
+function formatNumberAsToken(value, locale) {
+  return usesTokenNumerals(locale) ? String(value) : formatSharedNumber(value, locale, {
+    useGrouping: false,
+    maximumFractionDigits: MAX_FRACTION_DIGITS
+  });
+}
+
+// The summaries, lists, and numbers the token writes as English literals, and
+// the locale-aware readings of the same: with a translator (the sheet
+// presentation's rows and announcements) the summaries resolve through the
+// catalog, lists through the provider locale's list format, and numbers
+// through its number format; without one they stay the token's own literals,
+// the released popover token's text. In English the two read identically.
+function itemsSummary(count, t) {
+  return t ? t('@astryx.powersearch.valueEditor.itemsCount', {
+    count
+  }) :
+  // eslint-disable-next-line @astryx/no-hardcoded-i18n-string -- the popover token's released English text; translating it is a separate stable change
+  `${count} items`;
+}
+function formatListText(labels, maxLength, t, formatList) {
+  if (labels.length === 0) {
+    return null;
+  }
+  if (labels.length === 1) {
+    return truncateString(labels[0], maxLength);
+  }
+  const totalLength = labels.reduce((sum, s) => sum + s.length, 0);
+  if (totalLength > maxLength) {
+    return itemsSummary(labels.length, t);
+  }
+  return formatList ? formatList(labels) : labels.join(', ');
+}
+
+/**
+ * The text a filter token shows for a value: the one place that decides how
+ * a value reads on the field, so every other reading of the same value —
+ * the sheet presentation's Filters rows and its removal announcement — can
+ * use the same words and the same zone handling. `maxLength` is the token's
+ * width budget; pass `Number.MAX_SAFE_INTEGER` for the untruncated text.
+ * With `t`, the list, date-range and nested summaries resolve through the
+ * catalog (`@astryx.powersearch.valueEditor.*`); without it they are the
+ * token's own literals. With `formatList` (the provider's list formatter),
+ * several labels join as a list in the locale; without it they join with
+ * the token's literal ", ".
+ */
+export function formatTokenValueText(operatorValue, filterValue, maxLength, locale, t, formatList, timezoneID) {
+  switch (filterValue.type) {
+    case 'empty':
+      return null;
+    case 'string':
+      return truncateString(filterValue.value, maxLength);
+    case 'integer':
+    case 'float':
+      return t ? formatNumberAsToken(filterValue.value, locale) : String(filterValue.value);
+    case 'enum':
+      if (operatorValue.type === 'enum') {
+        return truncateString(getEnumLabel(operatorValue.values, filterValue.value), maxLength);
+      }
+      return truncateString(filterValue.value, maxLength);
+    case 'string_list':
+      return formatListText(filterValue.value, maxLength, t, formatList);
+    case 'enum_list':
+      {
+        const items = filterValue.value;
+        if (items.length === 0) {
+          return null;
+        }
+        if (operatorValue.type === 'enum_list') {
+          return formatListText(items.map(v => getEnumLabel(operatorValue.values, v)), maxLength, t, formatList);
+        }
+        if (items.length === 1) {
+          return truncateString(items[0], maxLength);
+        }
+        return itemsSummary(items.length, t);
+      }
+    case 'entity_list':
+      return formatListText(filterValue.value.map(e => e.label), maxLength, t, formatList);
+    case 'time':
+      return filterValue.value;
+    case 'date_absolute':
+      // The token reads a value in the zone its editor uses.
+      return truncateString(formatDateAbsolute(filterValue.unixSeconds, locale, timezoneID, operatorValue.type !== 'date_absolute' || operatorValue.isDateOnly !== false), maxLength);
+    case 'date_relative':
+      return truncateString(filterValue.value, maxLength);
+    case 'date_range':
+      if (t) {
+        return t('@astryx.powersearch.valueEditor.dateRange');
+      }
+      // eslint-disable-next-line @astryx/no-hardcoded-i18n-string -- the popover token's released English text; translating it is a separate stable change
+      return 'date range';
+    case 'custom':
+      if (operatorValue.type === 'custom') {
+        return truncateString(operatorValue.getString(filterValue.value), maxLength);
+      }
+      return filterValue.value;
+    case 'nested':
+      {
+        const count = filterValue.value.length;
+        if (t) {
+          return t('@astryx.powersearch.valueEditor.filtersCount', {
+            count
+          });
+        }
+        // eslint-disable-next-line @astryx/no-hardcoded-i18n-string -- the popover token's released English text; translating it is a separate stable change
+        return count === 1 ? '1 filter' : `${count} filters`;
+      }
+    default:
+      return null;
+  }
+}

package/dist/PowerSearch/index.d.ts

@@ -7,7 +7,7 @@
  * SYNC: When adding new PowerSearch files, update exports here
  */
 export { PowerSearch } from './PowerSearch.js';
-export type { PowerSearchProps, PowerSearchSize } from './PowerSearch.js';
+export type { PowerSearchPresentation, PowerSearchProps, PowerSearchSize, } from './PowerSearch.js';
 export { PowerSearchToken } from './PowerSearchToken.js';
 export { PowerSearchFilterEditor } from './PowerSearchFilterEditor.js';
 export { resolveOperatorLabel } from './resolveOperatorLabel.js';

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,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"}
+{"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,EACV,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,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/powerSearchDateZone.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file powerSearchDateZone.ts
+ * @input A `date_absolute` or range part's `unixSeconds`, the operator's
+ *   `isDateOnly`, and the PowerSearch `timezoneID`
+ * @output The one zone every reading of such a value uses, and the
+ *   conversions between an instant and the calendar day or wall-clock time
+ *   shown in that zone
+ * @position Shared by the token text, the accessible label, and the value
+ *   editors, so a value reads as the same day everywhere in one field
+ */
+import type { ISODateString } from '../utils/dateTypes.js';
+import type { ISODateTimeString } from '../DateTimeInput/DateTimeInput.js';
+/**
+ * The zone a date value is read and written in. A calendar day is stored as
+ * midnight in `timezoneID`. With no `timezoneID` the day is the UTC day, so
+ * a value written before a zone was given keeps its day. A value with a time
+ * of day shows in `timezoneID`, else in the viewer's zone. `undefined` names
+ * the viewer's zone, because `Intl` and `Date` default to it.
+ */
+export declare function resolveDateZone(timezoneID: string | undefined, isDateOnly: boolean): string | undefined;
+export declare function unixSecondsToISODate(unixSeconds: number, zone: string | undefined): ISODateString;
+export declare function isoDateToUnixSeconds(date: ISODateString, zone: string | undefined): number;
+export declare function unixSecondsToISODateTime(unixSeconds: number, zone: string | undefined): ISODateTimeString;
+export declare function isoDateTimeToUnixSeconds(value: ISODateTimeString, zone: string | undefined): number;
+//# sourceMappingURL=powerSearchDateZone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"powerSearchDateZone.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/powerSearchDateZone.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAC;AAWtE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,EAAE,OAAO,GAClB,MAAM,GAAG,SAAS,CAMpB;AAID,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,aAAa,CAQf;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CAOR;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,iBAAiB,CAGnB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CAaR"}

package/dist/PowerSearch/powerSearchDateZone.js

@@ -0,0 +1,57 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file powerSearchDateZone.ts
+ * @input A `date_absolute` or range part's `unixSeconds`, the operator's
+ *   `isDateOnly`, and the PowerSearch `timezoneID`
+ * @output The one zone every reading of such a value uses, and the
+ *   conversions between an instant and the calendar day or wall-clock time
+ *   shown in that zone
+ * @position Shared by the token text, the accessible label, and the value
+ *   editors, so a value reads as the same day everywhere in one field
+ */
+
+import { getWallClock, plainDateFromDate, plainDateFromInstant, plainDateFromISO, plainDateToDate, plainDateToInstant, plainDateToISO } from "../utils/plainDate.js";
+
+/**
+ * The zone a date value is read and written in. A calendar day is stored as
+ * midnight in `timezoneID`. With no `timezoneID` the day is the UTC day, so
+ * a value written before a zone was given keeps its day. A value with a time
+ * of day shows in `timezoneID`, else in the viewer's zone. `undefined` names
+ * the viewer's zone, because `Intl` and `Date` default to it.
+ */
+export function resolveDateZone(timezoneID, isDateOnly) {
+  // An empty string is no zone, as the formatter always read it.
+  if (timezoneID) {
+    return timezoneID;
+  }
+  return isDateOnly ? 'UTC' : undefined;
+}
+const pad = (n, width = 2) => String(n).padStart(width, '0');
+export function unixSecondsToISODate(unixSeconds, zone) {
+  const instant = unixSeconds * 1000;
+  return plainDateToISO(zone == null ? plainDateFromDate(new Date(instant)) : plainDateFromInstant(instant, zone));
+}
+export function isoDateToUnixSeconds(date, zone) {
+  const plain = plainDateFromISO(date);
+  const instant = zone == null ? plainDateToDate(plain).getTime() : plainDateToInstant(plain, zone);
+  return Math.floor(instant / 1000);
+}
+export function unixSecondsToISODateTime(unixSeconds, zone) {
+  const w = getWallClock(new Date(unixSeconds * 1000), zone);
+  return `${pad(w.year, 4)}-${pad(w.month)}-${pad(w.day)}T${pad(w.hour)}:${pad(w.minute)}`;
+}
+export function isoDateTimeToUnixSeconds(value, zone) {
+  const [datePart, timePart = '00:00'] = value.split('T');
+  const [hour = 0, minute = 0] = timePart.split(':').map(Number);
+  const plain = plainDateFromISO(datePart);
+  let instant;
+  if (zone == null) {
+    const d = plainDateToDate(plain);
+    d.setHours(hour, minute, 0, 0);
+    instant = d.getTime();
+  } else {
+    instant = plainDateToInstant(plain, zone, hour, minute);
+  }
+  return Math.floor(instant / 1000);
+}

package/dist/PowerSearch/powerSearchSheetUtils.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file powerSearchSheetUtils.ts
+ * @input PowerSearch config/filter types and the field typeahead source
+ * @output Pure helpers for the sheet presentation: which operators the
+ *   sheet's own controls edit, field matching, filter identity tracking
+ *   across controlled re-renders, the focus target after a removal, and the
+ *   content search's suggestion source over the field typeahead
+ * @position Helper module; consumed by PowerSearchBottomSheet.tsx and its
+ *   tests
+ */
+import type { SearchSource } from '../Typeahead/types.js';
+import type { InternalConfig } from './useInternalConfig.js';
+import type { PowerSearchField, PowerSearchFilter, PowerSearchItem, PowerSearchOperator } from './types.js';
+/**
+ * Whether the value step edits an operator's value with a sheet-native
+ * control (choice rows, or the popover's editor in its sheet presentation).
+ * A `nested` value is the exception: it is edited by the popover's built-in
+ * NestedEditor, rendered in the step's body,
+ * so every operator opens an editable step and no field is left out.
+ */
+export declare function isSupportedOperator(operator: PowerSearchOperator): boolean;
+export declare function fieldMatchesQuery(field: PowerSearchField, normalizedQuery: string): boolean;
+/** Synchronous suggestion source; the sheet renders results inline. */
+export interface SheetSuggestionSource {
+    search(query: string): PowerSearchItem[];
+    bootstrap(): PowerSearchItem[];
+}
+/**
+ * The field typeahead source as the content search's rows: the popover
+ * presentation's own suggestions, minus any whose field the config no longer
+ * knows. That source resolves synchronously from the config; a promise (none
+ * today) yields no rows rather than a stale list.
+ */
+export declare function createSheetSuggestionSource(config: InternalConfig, source: SearchSource<PowerSearchItem>): SheetSuggestionSource;
+/**
+ * Stable identities for the Filters rows across controlled updates, so a row
+ * keeps its element — and its focus — when the parent reorders the filters or
+ * removes one above it. A filter object seen before keeps its
+ * id; a new object takes the id of a filter from the previous update with the
+ * same signature that no present object claims (a parent that clones its
+ * values on every change); anything else mints a new id. Two equal filters
+ * are told apart by order. Call `next` once per render with the current list.
+ */
+export declare function createFilterIdentities(): {
+    next: (filters: ReadonlyArray<PowerSearchFilter>) => number[];
+};
+/** Structural snapshot of a filter, for parents that clone their values. */
+export declare function filterSignature(filter: PowerSearchFilter): string;
+/**
+ * Finds the filter a step was opened on after the controlled parent may have
+ * reordered, cloned, or removed it: object identity first, then the original
+ * slot when it still holds a structurally equal filter, then a unique
+ * structural match anywhere. Returns null when the target is gone or
+ * ambiguous, so an edit never lands on a different filter.
+ */
+export declare function resolveFilterIdentityIndex(filters: ReadonlyArray<PowerSearchFilter>, sourceFilter: PowerSearchFilter, sourceSignature: string, preferredIndex: number): number | null;
+/**
+ * After removing the filter at `removedIndex`, focus should land on the
+ * nearest remaining row that is a button, preferring the one after it.
+ * `isRowButton` is the Filters sheet's own rule for which rows are buttons:
+ * the field interactive and the filter not read-only (a `nested` or stale
+ * filter's row is a button too).
+ */
+export declare function nearestEditableIndex(nextFilters: ReadonlyArray<PowerSearchFilter>, removedIndex: number, isRowButton?: (filter: PowerSearchFilter) => boolean): number | undefined;
+//# sourceMappingURL=powerSearchSheetUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"powerSearchSheetUtils.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/powerSearchSheetUtils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAMjB;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAE1E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,EACvB,eAAe,EAAE,MAAM,GACtB,OAAO,CAYT;AAED,uEAAuE;AACvE,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IACzC,SAAS,IAAI,eAAe,EAAE,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY,CAAC,eAAe,CAAC,GACpC,qBAAqB,CAevB;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,KAAK,MAAM,EAAE,CAAC;CAC/D,CAkCA;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAOjE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,EACzC,YAAY,EAAE,iBAAiB,EAC/B,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAef;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC7C,YAAY,EAAE,MAAM,EACpB,WAAW,GAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OACxB,GACnB,MAAM,GAAG,SAAS,CAsBpB"}

package/dist/PowerSearch/powerSearchSheetUtils.js

@@ -0,0 +1,168 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file powerSearchSheetUtils.ts
+ * @input PowerSearch config/filter types and the field typeahead source
+ * @output Pure helpers for the sheet presentation: which operators the
+ *   sheet's own controls edit, field matching, filter identity tracking
+ *   across controlled re-renders, the focus target after a removal, and the
+ *   content search's suggestion source over the field typeahead
+ * @position Helper module; consumed by PowerSearchBottomSheet.tsx and its
+ *   tests
+ */
+
+// =============================================================================
+// Operators and fields
+// =============================================================================
+
+/**
+ * Whether the value step edits an operator's value with a sheet-native
+ * control (choice rows, or the popover's editor in its sheet presentation).
+ * A `nested` value is the exception: it is edited by the popover's built-in
+ * NestedEditor, rendered in the step's body,
+ * so every operator opens an editable step and no field is left out.
+ */
+export function isSupportedOperator(operator) {
+  return operator.value.type !== 'nested';
+}
+export function fieldMatchesQuery(field, normalizedQuery) {
+  if (normalizedQuery === '') {
+    return true;
+  }
+  if (field.label.toLowerCase().includes(normalizedQuery)) {
+    return true;
+  }
+  return field.typeaheadAliases?.some(alias => alias.toLowerCase().includes(normalizedQuery)) ?? false;
+}
+
+/** Synchronous suggestion source; the sheet renders results inline. */
+
+/**
+ * The field typeahead source as the content search's rows: the popover
+ * presentation's own suggestions, minus any whose field the config no longer
+ * knows. That source resolves synchronously from the config; a promise (none
+ * today) yields no rows rather than a stale list.
+ */
+export function createSheetSuggestionSource(config, source) {
+  // Every suggestion whose field the config knows is offered: the value step
+  // edits every operator, `nested` included.
+  const isEditable = item => {
+    const aux = item.auxiliaryData;
+    return aux != null && config.getField(aux.fieldKey) != null;
+  };
+  const settle = results => Array.isArray(results) ? results.filter(isEditable) : [];
+  return {
+    search: query => settle(source.search(query)),
+    bootstrap: () => settle(source.bootstrap())
+  };
+}
+
+// =============================================================================
+// Filter identity across controlled updates
+// =============================================================================
+
+function stableSerialize(value) {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableSerialize).join(',')}]`;
+  }
+  if (value != null && typeof value === 'object') {
+    return `{${Object.entries(value).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([key, entry]) => `${JSON.stringify(key)}:${stableSerialize(entry)}`).join(',')}}`;
+  }
+  return JSON.stringify(value) ?? 'undefined';
+}
+
+/**
+ * Stable identities for the Filters rows across controlled updates, so a row
+ * keeps its element — and its focus — when the parent reorders the filters or
+ * removes one above it. A filter object seen before keeps its
+ * id; a new object takes the id of a filter from the previous update with the
+ * same signature that no present object claims (a parent that clones its
+ * values on every change); anything else mints a new id. Two equal filters
+ * are told apart by order. Call `next` once per render with the current list.
+ */
+export function createFilterIdentities() {
+  const byObject = new WeakMap();
+  let previousBySignature = new Map();
+  let nextId = 0;
+  return {
+    next(filters) {
+      const used = new Set();
+      const ids = filters.map(filter => {
+        const known = byObject.get(filter);
+        if (known == null || used.has(known)) {
+          return null;
+        }
+        used.add(known);
+        return known;
+      });
+      const bySignature = new Map();
+      filters.forEach((filter, index) => {
+        const signature = filterSignature(filter);
+        let id = ids[index];
+        if (id == null) {
+          id = previousBySignature.get(signature)?.find(candidate => !used.has(candidate)) ?? nextId++;
+          used.add(id);
+          byObject.set(filter, id);
+          ids[index] = id;
+        }
+        bySignature.set(signature, [...(bySignature.get(signature) ?? []), id]);
+      });
+      previousBySignature = bySignature;
+      return ids;
+    }
+  };
+}
+
+/** Structural snapshot of a filter, for parents that clone their values. */
+export function filterSignature(filter) {
+  return stableSerialize({
+    field: filter.field,
+    operator: filter.operator,
+    value: filter.value,
+    isReadOnly: filter.isReadOnly ?? false
+  });
+}
+
+/**
+ * Finds the filter a step was opened on after the controlled parent may have
+ * reordered, cloned, or removed it: object identity first, then the original
+ * slot when it still holds a structurally equal filter, then a unique
+ * structural match anywhere. Returns null when the target is gone or
+ * ambiguous, so an edit never lands on a different filter.
+ */
+export function resolveFilterIdentityIndex(filters, sourceFilter, sourceSignature, preferredIndex) {
+  const identityIndex = filters.indexOf(sourceFilter);
+  if (identityIndex >= 0) {
+    return identityIndex;
+  }
+  if (filters[preferredIndex] != null && filterSignature(filters[preferredIndex]) === sourceSignature) {
+    return preferredIndex;
+  }
+  const matchingIndices = filters.flatMap((filter, index) => filterSignature(filter) === sourceSignature ? [index] : []);
+  return matchingIndices.length === 1 ? matchingIndices[0] : null;
+}
+
+/**
+ * After removing the filter at `removedIndex`, focus should land on the
+ * nearest remaining row that is a button, preferring the one after it.
+ * `isRowButton` is the Filters sheet's own rule for which rows are buttons:
+ * the field interactive and the filter not read-only (a `nested` or stale
+ * filter's row is a button too).
+ */
+export function nearestEditableIndex(nextFilters, removedIndex, isRowButton = filter => !filter.isReadOnly) {
+  const editableIndices = nextFilters.flatMap((candidate, candidateIndex) => isRowButton(candidate) ? [candidateIndex] : []);
+  return editableIndices.reduce((nearest, candidate) => {
+    if (nearest == null) {
+      return candidate;
+    }
+    const candidateDistance = Math.abs(candidate - removedIndex);
+    const nearestDistance = Math.abs(nearest - removedIndex);
+    if (candidateDistance < nearestDistance) {
+      return candidate;
+    }
+    if (candidateDistance === nearestDistance && candidate >= removedIndex && nearest < removedIndex) {
+      return candidate;
+    }
+    return nearest;
+  }, undefined);
+}

package/dist/PowerSearch/types.d.ts

@@ -47,7 +47,12 @@ export interface TimeOperatorValue {
 }
 export interface DateAbsoluteOperatorValue {
     readonly type: 'date_absolute';
-    /** If true, only show date picker without time. */
+    /**
+     * True or unset: the value is a calendar day, edited with a date picker.
+     * False: the value is an instant with a time of day, edited with a date
+     * picker and a time field and shown with its time in `timezoneID`, else
+     * the viewer's zone.
+     */
     readonly isDateOnly?: boolean;
 }
 export interface DateRelativeOperatorValue {
@@ -294,6 +299,8 @@ export interface PowerSearchTokenProps {
     readonly onClick?: () => void;
     readonly onRemove?: () => void;
     readonly isDisabled?: boolean;
+    /** The zone the field reads date values in; see PowerSearch `timezoneID`. */
+    readonly timezoneID?: string;
 }
 /**
  * Props for a custom Editor component.