@marinoscar/platform-web 0.1.0-next.17 → 0.1.0-next.19

package/dist/core/time-zone/store.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The `localStorage` key the chosen zone is cached under, so a reload renders
+ * in the right zone before the settings fetch lands.
+ *
+ * @stability experimental
+ */
+export declare const TIME_ZONE_STORAGE_KEY = "platform.timezone";
+/**
+ * The IANA zone this device reports (`Europe/Paris`), or `'UTC'` when the
+ * runtime does not say.
+ *
+ * @returns the device's zone id.
+ *
+ * @stability experimental
+ */
+export declare function deviceTimeZone(): string;
+/**
+ * The zone the user chose (`profile.timezone`), or `null` when they follow the
+ * device.
+ *
+ * @returns the stored choice.
+ *
+ * @stability experimental
+ */
+export declare function getPreferredTimeZone(): string | null;
+/**
+ * The zone every packaged time is rendered in: the user's choice, else the
+ * device's zone, else `'UTC'`.
+ *
+ * @returns an IANA zone id.
+ *
+ * @stability experimental
+ */
+export declare function getDisplayTimeZone(): string;
+/**
+ * Sets the user's choice (`null` follows the device again) and notifies every
+ * subscriber. An id the runtime does not know is ignored. The value is cached
+ * in `localStorage` (`platform.timezone`) when the browser allows it.
+ *
+ * @param id - an IANA zone id, or `null`.
+ *
+ * @example
+ * ```ts
+ * setPreferredTimeZone(settings.profile.timezone ?? null);
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function setPreferredTimeZone(id: string | null): void;
+/**
+ * Calls `listener` whenever the display zone may have changed.
+ *
+ * @param listener - called with no argument.
+ * @returns the unsubscribe function.
+ *
+ * @stability experimental
+ */
+export declare function subscribeDisplayTimeZone(listener: () => void): () => void;
+/**
+ * The display zone, re-rendering the component when it changes. Use it in a
+ * component that formats times, so a saved profile re-renders them.
+ *
+ * @returns the effective IANA zone id ({@link getDisplayTimeZone}).
+ *
+ * @example
+ * ```tsx
+ * const zone = useDisplayTimeZone();
+ * return <span>{formatDateTime(job.createdAt, { timeZone: zone })}</span>;
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function useDisplayTimeZone(): string;
+/**
+ * The user's stored choice, re-rendering on change (`null`: follow the device).
+ *
+ * @returns the choice ({@link getPreferredTimeZone}).
+ *
+ * @stability experimental
+ */
+export declare function usePreferredTimeZone(): string | null;
+/**
+ * `profile.timezone` out of a settings profile: the id when it is a valid zone,
+ * else `null`.
+ *
+ * @param profile - a stored profile (any shape).
+ * @returns the zone id, or `null`.
+ *
+ * @stability experimental
+ */
+export declare function timeZoneFromProfile(profile: unknown): string | null;
+//# sourceMappingURL=store.d.ts.map

package/dist/core/time-zone/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/core/time-zone/store.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AA2BzD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAWvC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAM5D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAInE"}

package/dist/core/time-zone/store.js

@@ -0,0 +1,170 @@
+// The display time zone: one module-level store, so a pure formatter, a hook
+// and code outside React all read the same answer. The user's choice comes
+// from `profile.timezone` (pushed here by `UserTimeZoneSync` of the timezone
+// slice and by `useUserSettings` of the settings slice); without one, the
+// device's zone. It lives in `core`, not in the timezone slice, because every
+// slice renders dates (identity included, which the timezone slice depends
+// on): core is the one place all of them may import without a cycle. The
+// timezone slice re-exports it from `/timezone/headless`.
+import { isValidTimeZone } from '@marinoscar/platform-contract/settings';
+import { useSyncExternalStore } from 'react';
+/**
+ * The `localStorage` key the chosen zone is cached under, so a reload renders
+ * in the right zone before the settings fetch lands.
+ *
+ * @stability experimental
+ */
+export const TIME_ZONE_STORAGE_KEY = 'platform.timezone';
+const listeners = new Set();
+function readCache() {
+    try {
+        const cached = globalThis.localStorage?.getItem(TIME_ZONE_STORAGE_KEY) ?? null;
+        return isValidTimeZone(cached) ? cached : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(id) {
+    try {
+        const storage = globalThis.localStorage;
+        if (!storage)
+            return;
+        if (id === null)
+            storage.removeItem(TIME_ZONE_STORAGE_KEY);
+        else
+            storage.setItem(TIME_ZONE_STORAGE_KEY, id);
+    }
+    catch {
+        // Private mode or blocked storage: the choice still applies to this page.
+    }
+}
+let preferred = readCache();
+let device;
+/**
+ * The IANA zone this device reports (`Europe/Paris`), or `'UTC'` when the
+ * runtime does not say.
+ *
+ * @returns the device's zone id.
+ *
+ * @stability experimental
+ */
+export function deviceTimeZone() {
+    if (device !== undefined)
+        return device;
+    let zone = 'UTC';
+    try {
+        const resolved = new Intl.DateTimeFormat().resolvedOptions().timeZone;
+        if (isValidTimeZone(resolved))
+            zone = resolved;
+    }
+    catch {
+        // An engine without Intl time zone support: UTC.
+    }
+    device = zone;
+    return zone;
+}
+/**
+ * The zone the user chose (`profile.timezone`), or `null` when they follow the
+ * device.
+ *
+ * @returns the stored choice.
+ *
+ * @stability experimental
+ */
+export function getPreferredTimeZone() {
+    return preferred;
+}
+/**
+ * The zone every packaged time is rendered in: the user's choice, else the
+ * device's zone, else `'UTC'`.
+ *
+ * @returns an IANA zone id.
+ *
+ * @stability experimental
+ */
+export function getDisplayTimeZone() {
+    return preferred ?? deviceTimeZone();
+}
+/**
+ * Sets the user's choice (`null` follows the device again) and notifies every
+ * subscriber. An id the runtime does not know is ignored. The value is cached
+ * in `localStorage` (`platform.timezone`) when the browser allows it.
+ *
+ * @param id - an IANA zone id, or `null`.
+ *
+ * @example
+ * ```ts
+ * setPreferredTimeZone(settings.profile.timezone ?? null);
+ * ```
+ *
+ * @stability experimental
+ */
+export function setPreferredTimeZone(id) {
+    if (id !== null && !isValidTimeZone(id))
+        return;
+    if (id === preferred)
+        return;
+    preferred = id;
+    writeCache(id);
+    for (const listener of [...listeners])
+        listener();
+}
+/**
+ * Calls `listener` whenever the display zone may have changed.
+ *
+ * @param listener - called with no argument.
+ * @returns the unsubscribe function.
+ *
+ * @stability experimental
+ */
+export function subscribeDisplayTimeZone(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/**
+ * The display zone, re-rendering the component when it changes. Use it in a
+ * component that formats times, so a saved profile re-renders them.
+ *
+ * @returns the effective IANA zone id ({@link getDisplayTimeZone}).
+ *
+ * @example
+ * ```tsx
+ * const zone = useDisplayTimeZone();
+ * return <span>{formatDateTime(job.createdAt, { timeZone: zone })}</span>;
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function useDisplayTimeZone() {
+    return useSyncExternalStore(subscribeDisplayTimeZone, getDisplayTimeZone, getDisplayTimeZone);
+}
+/**
+ * The user's stored choice, re-rendering on change (`null`: follow the device).
+ *
+ * @returns the choice ({@link getPreferredTimeZone}).
+ *
+ * @stability experimental
+ */
+export function usePreferredTimeZone() {
+    return useSyncExternalStore(subscribeDisplayTimeZone, getPreferredTimeZone, getPreferredTimeZone);
+}
+/**
+ * `profile.timezone` out of a settings profile: the id when it is a valid zone,
+ * else `null`.
+ *
+ * @param profile - a stored profile (any shape).
+ * @returns the zone id, or `null`.
+ *
+ * @stability experimental
+ */
+export function timeZoneFromProfile(profile) {
+    if (!profile || typeof profile !== 'object')
+        return null;
+    const value = profile.timezone;
+    return isValidTimeZone(value) ? value : null;
+}
+//# sourceMappingURL=store.js.map

package/dist/core/time-zone/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/core/time-zone/store.ts"],"names":[],"mappings":"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"}

package/dist/credentials/headless/saved-secret.d.ts

@@ -31,7 +31,7 @@ export interface SavedSecretHelperTextOptions {
     /**
      * Formats the last-change date.
      *
-     * @defaultValue `date.toLocaleDateString()`
+     * @defaultValue the numeric date (`toLocaleDateString()`'s fields) in the display time zone
      */
     readonly formatDate?: (date: Date) => string;
 }

package/dist/credentials/headless/saved-secret.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saved-secret.d.ts","sourceRoot":"","sources":["../../../src/credentials/headless/saved-secret.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,GAAG;IAC1C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CAC3C,CAAC;AAEJ;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;CAC9C;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACxC,OAAO,GAAE,4BAAiC,GACzC,MAAM,CASR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE"}
+{"version":3,"file":"saved-secret.d.ts","sourceRoot":"","sources":["../../../src/credentials/headless/saved-secret.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAGnF;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,GAAG;IAC1C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CAC3C,CAAC;AAEJ;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;CAC9C;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACxC,OAAO,GAAE,4BAAiC,GACzC,MAAM,CASR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE"}

package/dist/credentials/headless/saved-secret.js

@@ -12,6 +12,7 @@
 // stored", which is what the sentence tells the user and what
 // `secretForSubmit` sends.
 // =============================================================================
+import { NUMERIC_DATE, formatDate } from '../../core/index.js';
 /** `a key`, `an access key`. */
 function withArticle(noun) {
     return /^[aeiou]/i.test(noun) ? `An ${noun}` : `A ${noun}`;
@@ -41,7 +42,7 @@ export function savedSecretHelperText(info, options = {}) {
         return options.emptyHelp ?? `No ${noun} is saved yet.`;
     const which = info.hint ? ` (${info.hint})` : '';
     const date = info.updatedAt ? new Date(info.updatedAt) : null;
-    const format = options.formatDate ?? ((d) => d.toLocaleDateString());
+    const format = options.formatDate ?? ((d) => formatDate(d, NUMERIC_DATE));
     const when = date && !Number.isNaN(date.getTime()) ? `, updated ${format(date)}` : '';
     return `${withArticle(noun)} is saved${which}${when}. Leave this blank to keep it, or type a new one to replace it.`;
 }

package/dist/credentials/headless/saved-secret.js.map

@@ -1 +1 @@
-{"version":3,"file":"saved-secret.js","sourceRoot":"","sources":["../../../src/credentials/headless/saved-secret.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wDAAwD;AACxD,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,gFAAgF;AAChF,oEAAoE;AACpE,EAAE;AACF,sEAAsE;AACtE,8EAA8E;AAC9E,8DAA8D;AAC9D,2BAA2B;AAC3B,gFAAgF;AA2ChF,gCAAgC;AAChC,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAwC,EACxC,UAAwC,EAAE;IAE1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC,SAAS,IAAI,MAAM,IAAI,gBAAgB,CAAC;IAElE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,CAAO,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,KAAK,GAAG,IAAI,iEAAiE,CAAC;AACvH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"saved-secret.js","sourceRoot":"","sources":["../../../src/credentials/headless/saved-secret.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wDAAwD;AACxD,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,gFAAgF;AAChF,oEAAoE;AACpE,EAAE;AACF,sEAAsE;AACtE,8EAA8E;AAC9E,8DAA8D;AAC9D,2BAA2B;AAC3B,gFAAgF;AAGhF,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAyC/D,gCAAgC;AAChC,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAwC,EACxC,UAAwC,EAAE;IAE1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC,SAAS,IAAI,MAAM,IAAI,gBAAgB,CAAC;IAElE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,CAAO,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,KAAK,GAAG,IAAI,iEAAiE,CAAC;AACvH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1C,CAAC"}

package/dist/credentials/ui/secret-field.d.ts

@@ -20,7 +20,7 @@ export interface SecretFieldProps {
     emptyHelp?: string;
     /** What the secret is called in the helper text; default `'key'`. */
     noun?: string;
-    /** Formats the last-change date; default `toLocaleDateString()`. */
+    /** Formats the last-change date; default the numeric date in the display time zone. */
     formatDate?: SavedSecretHelperTextOptions['formatDate'];
     /** Disables the input (a viewer without the write permission). */
     disabled?: boolean;

package/dist/credentials/ui/secret-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"secret-field.d.ts","sourceRoot":"","sources":["../../../src/credentials/ui/secret-field.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE1F;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,wFAAwF;IACxF,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,UAAU,CAAC,EAAE,4BAA4B,CAAC,YAAY,CAAC,CAAC;IACxD,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC;CAC1E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CA4BjE"}
+{"version":3,"file":"secret-field.d.ts","sourceRoot":"","sources":["../../../src/credentials/ui/secret-field.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG1F;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,wFAAwF;IACxF,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,UAAU,CAAC,EAAE,4BAA4B,CAAC,YAAY,CAAC,CAAC;IACxD,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC;CAC1E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CA6BjE"}

package/dist/credentials/ui/secret-field.js

@@ -13,6 +13,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { TextField } from '@mui/material';
 import { useId } from 'react';
 import { savedSecretHelperText } from '../headless/index.js';
+import { useDisplayTimeZone } from '../../core/index.js';
 /**
  * A write-only secret input with the unified "saved secret" helper text.
  *
@@ -34,6 +35,7 @@ import { savedSecretHelperText } from '../headless/index.js';
  * @stability experimental
  */
 export function SecretField(props) {
+    useDisplayTimeZone(); // "updated" renders in the display zone.
     const generatedId = useId();
     const id = props.id ?? `secret-field-${generatedId.replace(/[^A-Za-z0-9_-]/g, '')}`;
     const helper = props.error ??

package/dist/credentials/ui/secret-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"secret-field.js","sourceRoot":"","sources":["../../../src/credentials/ui/secret-field.tsx"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAChF,EAAE;AACF,0EAA0E;AAC1E,+EAA+E;AAC/E,wEAAwE;AACxE,8EAA8E;AAC9E,4EAA4E;AAC5E,4DAA4D;AAC5D,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAG9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAmD7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,gBAAgB,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,EAAE,CAAC;IACpF,MAAM,MAAM,GACV,KAAK,CAAC,KAAK;QACX,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE;YACjC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC,CAAC;IAEL,OAAO,CACL,KAAC,SAAS,IACR,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAC3B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAC,cAAc,EAC3B,SAAS,QACT,EAAE,EAAE,KAAK,CAAC,EAAE,KACR,KAAK,CAAC,KAAK,EAAE,SAAS,EAC1B,IAAI,EAAC,UAAU,EACf,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GACvD,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"secret-field.js","sourceRoot":"","sources":["../../../src/credentials/ui/secret-field.tsx"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAChF,EAAE;AACF,0EAA0E;AAC1E,+EAA+E;AAC/E,wEAAwE;AACxE,8EAA8E;AAC9E,4EAA4E;AAC5E,4DAA4D;AAC5D,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAG9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAkDzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,kBAAkB,EAAE,CAAC,CAAC,yCAAyC;IAC/D,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,gBAAgB,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,EAAE,CAAC;IACpF,MAAM,MAAM,GACV,KAAK,CAAC,KAAK;QACX,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE;YACjC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC,CAAC;IAEL,OAAO,CACL,KAAC,SAAS,IACR,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAC3B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAC,cAAc,EAC3B,SAAS,QACT,EAAE,EAAE,KAAK,CAAC,EAAE,KACR,KAAK,CAAC,KAAK,EAAE,SAAS,EAC1B,IAAI,EAAC,UAAU,EACf,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GACvD,CACH,CAAC;AACJ,CAAC"}

package/dist/datatable/headless/export/exportModel.d.ts

@@ -109,10 +109,16 @@ export declare function slugifyExportName(name: string | undefined | null): stri
  *
  * Dated because an export is a snapshot: two files downloaded a week apart must
  * not collide in a Downloads folder, and `jobs (3).csv` tells nobody anything.
+ * The date is today in the viewer's display zone (`zonedDateKey`), so a file
+ * saved at 9 PM in Costa Rica is named for that day, not tomorrow's UTC date.
+ *
+ * @param base - the table's name; slugified.
+ * @param now - the instant of the export; default now.
+ * @param timeZone - the zone the date is read in; default the display zone.
  *
  * @stability experimental
  */
-export declare function exportFilename(base: string | undefined | null, now?: Date): string;
+export declare function exportFilename(base: string | undefined | null, now?: Date, timeZone?: string): string;
 /**
  * Hand a CSV string to the browser as a file download.
  *

package/dist/datatable/headless/export/exportModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exportModel.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/export/exportModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAQ7E;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,MAAM,CAAC;AASrD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,OAAO,CAE7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAC/B,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACrC,eAAe,CAAC,GAAG,CAAC,EAAE,CAKxB;AAMD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mDAAmD;IACnD,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EACnC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,IAAI,EAAE,SAAS,GAAG,EAAE,GACnB,YAAY,CAKd;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EACjC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACrC,MAAM,CAIR;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAOzE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAG9F;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoBtE;AAMD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB,CAAC,GAAG;IACxC,6EAA6E;IAC7E,SAAS,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,GAAG;IACvC,0BAA0B;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,EACxC,SAAS,EACT,QAA4C,EAC5C,OAAoC,EACpC,UAAU,EACV,MAAM,GACP,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CA6BjE"}
+{"version":3,"file":"exportModel.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/export/exportModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAS7E;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,MAAM,CAAC;AASrD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,OAAO,CAE7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAC/B,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACrC,eAAe,CAAC,GAAG,CAAC,EAAE,CAKxB;AAMD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mDAAmD;IACnD,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EACnC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,IAAI,EAAE,SAAS,GAAG,EAAE,GACnB,YAAY,CAKd;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EACjC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACrC,MAAM,CAIR;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAOzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAC/B,GAAG,GAAE,IAAiB,EACtB,QAAQ,GAAE,MAA6B,GACtC,MAAM,CAIR;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoBtE;AAMD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB,CAAC,GAAG;IACxC,6EAA6E;IAC7E,SAAS,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,GAAG;IACvC,0BAA0B;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,EACxC,SAAS,EACT,QAA4C,EAC5C,OAAoC,EACpC,UAAU,EACV,MAAM,GACP,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CA6BjE"}

package/dist/datatable/headless/export/exportModel.js

@@ -22,6 +22,7 @@
  *    page's OWN fetch callback, so it is subject to exactly the same
  *    authorization and the same active filters as the table itself.
  */
+import { getDisplayTimeZone, zonedDateKey } from '../../../core/index.js';
 import { extractColumnValue } from '../columns.js';
 import { toCsvFile } from './csv.js';
 // ---------------------------------------------------------------------------
@@ -130,11 +131,18 @@ export function slugifyExportName(name) {
  *
  * Dated because an export is a snapshot: two files downloaded a week apart must
  * not collide in a Downloads folder, and `jobs (3).csv` tells nobody anything.
+ * The date is today in the viewer's display zone (`zonedDateKey`), so a file
+ * saved at 9 PM in Costa Rica is named for that day, not tomorrow's UTC date.
+ *
+ * @param base - the table's name; slugified.
+ * @param now - the instant of the export; default now.
+ * @param timeZone - the zone the date is read in; default the display zone.
  *
  * @stability experimental
  */
-export function exportFilename(base, now = new Date()) {
-    const iso = Number.isNaN(now.getTime()) ? '' : `-${now.toISOString().slice(0, 10)}`;
+export function exportFilename(base, now = new Date(), timeZone = getDisplayTimeZone()) {
+    const day = zonedDateKey(now, timeZone);
+    const iso = day === null ? '' : `-${day}`;
     return `${slugifyExportName(base)}${iso}.csv`;
 }
 // ---------------------------------------------------------------------------

package/dist/datatable/headless/export/exportModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"exportModel.js","sourceRoot":"","sources":["../../../../src/datatable/headless/export/exportModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exportModel.js","sourceRoot":"","sources":["../../../../src/datatable/headless/export/exportModel.ts"],"names":[],"mappings":"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"}

package/dist/datatable/headless/filter/dateRange.d.ts

@@ -0,0 +1,40 @@
+/**
+ * What {@link zonedDayRangeToInstants} returns: a half-open instant range.
+ *
+ * @stability experimental
+ */
+export interface ZonedDayInstantRange {
+    /** Local midnight at the start of the first day, ISO 8601 (inclusive). */
+    from: string;
+    /** Local midnight at the start of the day after the last day, ISO 8601 (exclusive). */
+    to: string;
+}
+/**
+ * The ISO instants that bound the calendar days `fromKey` to `toKey`
+ * (inclusive) in `tz`: `from` is local midnight at the start of `fromKey`,
+ * `to` is local midnight at the start of the day after `toKey`, so a server
+ * filters `createdAt >= from AND createdAt < to`. DST-safe: a 23- or 25-hour
+ * day is covered exactly, and a skipped midnight starts at the first instant
+ * after the gap.
+ *
+ * Use it to turn a `date` filter (`between`, `after`, `before`) into server
+ * query parameters, rather than sending the bare days (which a server would
+ * read in its own zone) or `new Date(key)` (which is UTC midnight).
+ *
+ * @param fromKey - the first day, `YYYY-MM-DD`.
+ * @param toKey - the last day included, `YYYY-MM-DD`; default `fromKey` (one day).
+ * @param tz - an IANA zone id; default the display zone. An unknown zone reads as UTC.
+ * @returns the half-open range as ISO 8601 instants.
+ * @throws RangeError when a key is not a real `YYYY-MM-DD` day.
+ *
+ * @example
+ * ```ts
+ * // A "between 2026-10-01 and 2026-10-31" filter, for a viewer in Costa Rica:
+ * zonedDayRangeToInstants('2026-10-01', '2026-10-31', 'America/Costa_Rica');
+ * // { from: '2026-10-01T06:00:00.000Z', to: '2026-11-01T06:00:00.000Z' }
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function zonedDayRangeToInstants(fromKey: string, toKey?: string, tz?: string): ZonedDayInstantRange;
+//# sourceMappingURL=dateRange.d.ts.map

package/dist/datatable/headless/filter/dateRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateRange.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/filter/dateRange.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAgB,EACvB,EAAE,GAAE,MAA6B,GAChC,oBAAoB,CActB"}

package/dist/datatable/headless/filter/dateRange.js

@@ -0,0 +1,53 @@
+// Mapping a date filter onto a server query. A DataTable date filter carries
+// calendar days (`YYYY-MM-DD`); a server filters instants. The honest mapping
+// is the half-open instant range [start of `from`, start of the day after
+// `to`) in the viewer's zone, computed with the contract's DST-safe
+// `zonedDayStart`, the same function the API uses to cut days.
+import { addDaysToDateKey, isDateKey, zonedDayStart } from '@marinoscar/platform-contract/timezone';
+import { getDisplayTimeZone } from '../../../core/index.js';
+/**
+ * The ISO instants that bound the calendar days `fromKey` to `toKey`
+ * (inclusive) in `tz`: `from` is local midnight at the start of `fromKey`,
+ * `to` is local midnight at the start of the day after `toKey`, so a server
+ * filters `createdAt >= from AND createdAt < to`. DST-safe: a 23- or 25-hour
+ * day is covered exactly, and a skipped midnight starts at the first instant
+ * after the gap.
+ *
+ * Use it to turn a `date` filter (`between`, `after`, `before`) into server
+ * query parameters, rather than sending the bare days (which a server would
+ * read in its own zone) or `new Date(key)` (which is UTC midnight).
+ *
+ * @param fromKey - the first day, `YYYY-MM-DD`.
+ * @param toKey - the last day included, `YYYY-MM-DD`; default `fromKey` (one day).
+ * @param tz - an IANA zone id; default the display zone. An unknown zone reads as UTC.
+ * @returns the half-open range as ISO 8601 instants.
+ * @throws RangeError when a key is not a real `YYYY-MM-DD` day.
+ *
+ * @example
+ * ```ts
+ * // A "between 2026-10-01 and 2026-10-31" filter, for a viewer in Costa Rica:
+ * zonedDayRangeToInstants('2026-10-01', '2026-10-31', 'America/Costa_Rica');
+ * // { from: '2026-10-01T06:00:00.000Z', to: '2026-11-01T06:00:00.000Z' }
+ * ```
+ *
+ * @stability experimental
+ */
+export function zonedDayRangeToInstants(fromKey, toKey = fromKey, tz = getDisplayTimeZone()) {
+    if (!isDateKey(fromKey))
+        throw new RangeError(`Not a YYYY-MM-DD day: ${fromKey}`);
+    if (!isDateKey(toKey))
+        throw new RangeError(`Not a YYYY-MM-DD day: ${toKey}`);
+    const start = (day) => {
+        try {
+            return zonedDayStart(day, tz);
+        }
+        catch {
+            return zonedDayStart(day, 'UTC');
+        }
+    };
+    return {
+        from: start(fromKey).toISOString(),
+        to: start(addDaysToDateKey(toKey, 1)).toISOString(),
+    };
+}
+//# sourceMappingURL=dateRange.js.map

package/dist/datatable/headless/filter/dateRange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateRange.js","sourceRoot":"","sources":["../../../../src/datatable/headless/filter/dateRange.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,oEAAoE;AACpE,+DAA+D;AAE/D,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAc5D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,QAAgB,OAAO,EACvB,KAAa,kBAAkB,EAAE;IAEjC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;IAClF,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,CAAC,GAAW,EAAQ,EAAE;QAClC,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;QAClC,EAAE,EAAE,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;KACpD,CAAC;AACJ,CAAC"}

package/dist/datatable/headless/filter/filterTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filterTypes.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/filter/filterTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EAEV,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAC1F,uGAAuG;IACvG,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAChD,kFAAkF;IAClF,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC;CAC/F;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAA0B,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAkBvF,CAAC;AAyBH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAoBnF;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,sBAAsB,GAAG,SAAS,CAEpG;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,sBAAsB,EAAE,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,CAE1E;AAID;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,GAAG,IAAI,CAW9F"}
+{"version":3,"file":"filterTypes.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/filter/filterTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C,OAAO,KAAK,EAEV,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAC1F,uGAAuG;IACvG,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAChD,kFAAkF;IAClF,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC;CAC/F;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAA0B,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAkBvF,CAAC;AAyBH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAoBnF;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,sBAAsB,GAAG,SAAS,CAEpG;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,sBAAsB,EAAE,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,CAE1E;AAID;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,GAAG,IAAI,CAW9F"}

package/dist/datatable/headless/filter/filterTypes.js

@@ -14,6 +14,7 @@
  * first render), exactly like the settings and doctor registries of this
  * package.
  */
+import { zonedDateKey } from '../../../core/index.js';
 /**
  * What a filter type id looks like: lower case letters and digits, 2 to 32
  * characters, starting with a letter.
@@ -173,6 +174,23 @@ export function learnColumnOperators(operators) {
 const text = (value) => (value === null || value === undefined ? '' : String(value));
 const isEmptyValue = (value) => value === null || value === undefined || value === '';
 const asList = (operand) => (Array.isArray(operand) ? operand : operand === null ? [] : [operand]);
+/** A bare `YYYY-MM-DD` (no time part): a calendar day, not an instant. */
+const BARE_DAY = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * The calendar day a filter value names: a bare `YYYY-MM-DD` as is; an instant
+ * (ISO string with a time, epoch milliseconds, a `Date`) as its day in the
+ * display zone; anything unparsable by its first ten characters, as before.
+ */
+function calendarDayOf(value) {
+    if (typeof value === 'string' && BARE_DAY.test(value))
+        return value;
+    if (typeof value === 'string' || typeof value === 'number' || value instanceof Date) {
+        const key = zonedDateKey(value);
+        if (key !== null)
+            return key;
+    }
+    return text(value).slice(0, 10);
+}
 function matchesEmptiness(value, operator) {
     if (operator === 'isEmpty')
         return isEmptyValue(value);
@@ -255,13 +273,15 @@ const BUILTIN_TYPES = [
                 return empty;
             if (isEmptyValue(value))
                 return false;
-            // Dates travel as YYYY-MM-DD; a datetime value compares by its day.
-            const day = text(value).slice(0, 10);
+            // Operands travel as YYYY-MM-DD days. A bare day compares as is; an
+            // instant compares by the calendar day it falls on in the display zone
+            // (never its UTC `.slice(0, 10)`, which is the wrong day near midnight).
+            const day = calendarDayOf(value);
             if (operator === 'between') {
-                const [from, to] = asList(operand).map(String);
+                const [from, to] = asList(operand).map(calendarDayOf);
                 return from !== undefined && to !== undefined && day >= from && day <= to;
             }
-            const other = text(operand).slice(0, 10);
+            const other = calendarDayOf(operand);
             if (operator === 'before')
                 return day < other;
             if (operator === 'after')