@bettercms-ai/kit 0.1.1 → 2.0.0-next.0

package/dist/controls/date-zone.js

@@ -0,0 +1,278 @@
+import { useKitServices } from "../context.js";
+import * as React from "react";
+//#region src/controls/date-zone.ts
+/**
+* DATE / DATETIME values and time zones (DESIGN 6.4, D43), ported from V2 controls/date.tsx and fitted to what the
+* backend and the value adapters keep (adapters/values.ts datetimeToProd / datetimeFromProd, backend
+* parseDateField / parseDatetimeField).
+*
+* What the control writes, per field (`zonePolicy`):
+*
+*   date (any timezone)          "2026-10-14"                          a prod `date` without includeTime refuses a "T"
+*   datetime, timezone false     "2026-10-14T09:00:00"                 floating wall time
+*   datetime, true / unset       "2026-10-14T09:00:00+05:30"           the zone the editor picked lives in the offset:
+*   datetime, "site"             "2026-10-14T09:00:00-07:00"           prod keeps no [Zone] (the adapter names a kept
+*                                                                       one as lost and the dock refuses the write)
+*   datetime, "fixed:<IANA>"     "2026-10-14T09:00:00-04:00[America/New_York]"   the adapter checks the zone against
+*                                                                       config.timezone, stores the instant, and
+*                                                                       reads it back with the same [Zone]
+*
+* Seconds are always written (prod refuses a seconds-less datetime; the adapter names it "format"). The offset is the
+* zone's offset AT the wall time the author typed (two passes, so it is right on both sides of a clock change), and a
+* wall time that a clock change skips is refused with a named reason, never shifted silently.
+*/
+function validZone(z) {
+	if (typeof z !== "string" || !z) return false;
+	try {
+		new Intl.DateTimeFormat("en-US", { timeZone: z });
+		return true;
+	} catch {
+		return false;
+	}
+}
+/** ICU still lists some zones under their old names; people read the current ones (Kolkata, not Calcutta). */
+var MODERN = {
+	"Asia/Calcutta": "Asia/Kolkata",
+	"Asia/Katmandu": "Asia/Kathmandu",
+	"Asia/Saigon": "Asia/Ho_Chi_Minh",
+	"Asia/Rangoon": "Asia/Yangon",
+	"Europe/Kiev": "Europe/Kyiv",
+	"America/Godthab": "America/Nuuk",
+	"Atlantic/Faeroe": "Atlantic/Faroe",
+	"America/Buenos_Aires": "America/Argentina/Buenos_Aires"
+};
+var modernZone = (z) => MODERN[z] && validZone(MODERN[z]) ? MODERN[z] : z;
+function browserZone() {
+	try {
+		return modernZone(Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC");
+	} catch {
+		return "UTC";
+	}
+}
+/** The zone a new value starts in: the site's, else the browser's. `source` names which one. */
+function useDefaultZone() {
+	const site = useKitServices().siteTimeZone;
+	return React.useMemo(() => validZone(site) ? {
+		zone: site,
+		source: "site"
+	} : {
+		zone: browserZone(),
+		source: "browser"
+	}, [site]);
+}
+/**
+* What the schema allows. A `date` never carries a zone here: prod stores a date as "YYYY-MM-DD" and refuses a time on
+* a date field without includeTime, so a zoned date (V2 allowed one) would be refused at save.
+*/
+function zonePolicy(field) {
+	if (field.type !== "datetime") return { mode: "none" };
+	const t = field.timezone ?? true;
+	if (t === false) return { mode: "none" };
+	if (t === "site") return { mode: "site" };
+	if (typeof t === "string" && t.startsWith("fixed:")) {
+		const z = t.slice(6);
+		return validZone(z) ? {
+			mode: "fixed",
+			zone: z
+		} : { mode: "site" };
+	}
+	return { mode: "pick" };
+}
+var pad = (n) => String(Math.abs(Math.trunc(n))).padStart(2, "0");
+/** The zone's UTC offset in minutes at an instant (+330 for Kolkata). */
+function offsetMinutes(zone, at) {
+	try {
+		const name = new Intl.DateTimeFormat("en-US", {
+			timeZone: zone,
+			timeZoneName: "longOffset"
+		}).formatToParts(at).find((p) => p.type === "timeZoneName")?.value ?? "GMT";
+		const m = /GMT([+\-−])(\d{1,2})(?::?(\d{2}))?/.exec(name);
+		if (!m) return 0;
+		return (m[1] === "+" ? 1 : -1) * (Number(m[2]) * 60 + Number(m[3] ?? 0));
+	} catch {
+		return 0;
+	}
+}
+/** +330 → "+05:30"; 0 → "+00:00". */
+var offsetIso = (min) => `${min < 0 ? "-" : "+"}${pad(Math.floor(Math.abs(min) / 60))}:${pad(Math.abs(min) % 60)}`;
+/** "GMT+5:30", "GMT−7", "GMT" — the short form people read (with a true minus sign). */
+function zoneShortOffset(zone, at = /* @__PURE__ */ new Date()) {
+	const min = offsetMinutes(zone, at);
+	if (min === 0) return "GMT";
+	const h = Math.floor(Math.abs(min) / 60);
+	const m = Math.abs(min) % 60;
+	return `GMT${min < 0 ? "−" : "+"}${h}${m ? `:${pad(m)}` : ""}`;
+}
+var zoneCity = (z) => z === "UTC" || z === "Etc/UTC" ? "UTC" : (z.split("/").pop() ?? z).replace(/_/g, " ");
+/** "GMT+5:30 · Kolkata" */
+var zoneLabel = (zone, at) => `${zoneShortOffset(zone, at)} · ${zoneCity(zone)}`;
+var ymdParts = (ymd) => ymd.split("-").map(Number);
+var hmParts = (time) => time.split(":").map(Number);
+var wallUtc = ({ ymd, time }) => {
+	const [y, mo, d] = ymdParts(ymd);
+	const [h, mi] = hmParts(time);
+	return Date.UTC(y, mo - 1, d, h, mi);
+};
+/** The wall clock an instant shows in a zone. */
+function instantToWall(instant, zone) {
+	const parts = new Intl.DateTimeFormat("en-CA", {
+		timeZone: zone,
+		year: "numeric",
+		month: "2-digit",
+		day: "2-digit",
+		hour: "2-digit",
+		minute: "2-digit",
+		hourCycle: "h23"
+	}).formatToParts(instant);
+	const get = (t) => parts.find((p) => p.type === t)?.value ?? "00";
+	return {
+		ymd: `${get("year")}-${get("month")}-${get("day")}`,
+		time: `${get("hour")}:${get("minute")}`
+	};
+}
+/**
+* The offset of a wall time in a zone, or null when a clock change skips that wall time (it names no instant there).
+* Two passes: the offset at the naive instant, then at the instant that offset gives.
+*/
+function wallOffset(zone, wall) {
+	const naive = wallUtc(wall);
+	const first = offsetMinutes(zone, new Date(naive));
+	const second = offsetMinutes(zone, /* @__PURE__ */ new Date(naive - first * 6e4));
+	for (const off of second === first ? [first] : [second, first]) {
+		const back = instantToWall(/* @__PURE__ */ new Date(naive - off * 6e4), zone);
+		if (back.ymd === wall.ymd && back.time === wall.time) return off;
+	}
+	return null;
+}
+/** The instant a wall time names in a zone (the earlier one when a clock change skips it). */
+var wallInstant = (zone, wall) => /* @__PURE__ */ new Date(wallUtc(wall) - (wallOffset(zone, wall) ?? offsetMinutes(zone, new Date(wallUtc(wall)))) * 6e4);
+var STORED = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::\d{2}(?:\.\d+)?)?(Z|[+-]\d{2}:?\d{2})?)?(?:\[([^\]]+)\])?$/;
+var EMPTY = {
+	wall: null,
+	hasTime: false,
+	readable: true
+};
+function parseStored(v) {
+	if (v == null || v === "") return EMPTY;
+	if (typeof v !== "string") return {
+		...EMPTY,
+		readable: false
+	};
+	const m = STORED.exec(v.trim());
+	if (!m) return {
+		...EMPTY,
+		readable: false
+	};
+	const [, y, mo, d, h, mi, off, zone] = m;
+	const date = new Date(Date.UTC(Number(y), Number(mo) - 1, Number(d)));
+	if (date.getUTCMonth() !== Number(mo) - 1 || date.getUTCDate() !== Number(d)) return {
+		...EMPTY,
+		readable: false
+	};
+	let offset;
+	if (off === "Z") offset = 0;
+	else if (off) {
+		const om = /([+-])(\d{2}):?(\d{2})/.exec(off);
+		offset = (om[1] === "-" ? -1 : 1) * (Number(om[2]) * 60 + Number(om[3]));
+	}
+	return {
+		wall: {
+			ymd: `${y}-${mo}-${d}`,
+			time: h ? `${h}:${mi}` : "09:00"
+		},
+		hasTime: !!h,
+		offset,
+		zone: validZone(zone) ? zone : void 0,
+		readable: true
+	};
+}
+/** A stored value as a JS Date (drops the [Zone] annotation, which `new Date()` can't read). */
+function storedToDate(v) {
+	if (typeof v !== "string" || !v) return null;
+	const d = new Date(v.replace(/\[[^\]]*\]$/, ""));
+	return Number.isNaN(d.getTime()) ? null : d;
+}
+/** Every IANA zone this runtime knows, UTC included. */
+var ALL_ZONES = (() => {
+	const list = typeof Intl.supportedValuesOf === "function" ? Intl.supportedValuesOf("timeZone").map(modernZone) : [];
+	return Array.from(new Set(list.includes("UTC") ? list : [...list, "UTC"]));
+})();
+/** The first zone (in order) whose offset at the instant is `offset`; undefined when none is. */
+function zoneWithOffset(offset, instant, candidates) {
+	for (const z of candidates) if (z && validZone(z) && offsetMinutes(z, instant) === offset) return z;
+}
+/**
+* What the control shows for a stored value: the wall time and the zone it lives in.
+*
+*   - none: the stored wall time, as typed.
+*   - site / fixed: that zone. A stored instant with another offset is shown as THAT instant's wall time in the zone,
+*     so the shown and the saved time never disagree.
+*   - pick: the stored [Zone]; else the zone the editor picked this session, the default, the browser's, then any
+*     zone whose offset matches the stored one (a "+05:30" reads back as Kolkata). A floating time reads in the default.
+*/
+function resolveShown(parsed, mode, zones) {
+	const lockedZone = mode === "fixed" ? zones.fixed : zones.def;
+	if (!parsed.wall) return {
+		wall: null,
+		zone: mode === "pick" ? zones.picked ?? zones.def : lockedZone
+	};
+	if (mode === "none" || parsed.offset === void 0) {
+		const zone = mode === "pick" ? parsed.zone ?? zones.picked ?? zones.def : lockedZone;
+		return {
+			wall: parsed.wall,
+			zone
+		};
+	}
+	const instant = /* @__PURE__ */ new Date(wallUtc(parsed.wall) - parsed.offset * 6e4);
+	if (mode === "pick") {
+		const zone = (parsed.zone && offsetMinutes(parsed.zone, instant) === parsed.offset ? parsed.zone : void 0) ?? zoneWithOffset(parsed.offset, instant, [
+			zones.picked,
+			zones.def,
+			browserZone(),
+			...ALL_ZONES
+		]);
+		if (zone) return {
+			wall: parsed.wall,
+			zone
+		};
+		return {
+			wall: instantToWall(instant, zones.def),
+			zone: zones.def
+		};
+	}
+	return {
+		wall: offsetMinutes(lockedZone, instant) === parsed.offset ? parsed.wall : instantToWall(instant, lockedZone),
+		zone: lockedZone
+	};
+}
+/** The stored string for a wall time under the field's policy (file header). */
+function writeValue(o) {
+	const { withTime, mode, wall, zone } = o;
+	if (!withTime) return {
+		ok: true,
+		value: wall.ymd
+	};
+	const local = `${wall.ymd}T${wall.time}:00`;
+	if (mode === "none") return {
+		ok: true,
+		value: local
+	};
+	const off = wallOffset(zone, wall);
+	if (off === null) return {
+		ok: false,
+		reason: `That local time doesn't exist in ${zoneCity(zone)} (clocks change). Pick another time.`
+	};
+	return {
+		ok: true,
+		value: `${local}${offsetIso(off)}${mode === "fixed" ? `[${zone}]` : ""}`
+	};
+}
+/** Today in a zone (the browser's local day for a floating field). */
+function todayIn(zone, now = /* @__PURE__ */ new Date()) {
+	if (zone) return instantToWall(now, zone).ymd;
+	return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
+}
+//#endregion
+export { ALL_ZONES, browserZone, instantToWall, modernZone, offsetIso, offsetMinutes, parseStored, resolveShown, storedToDate, todayIn, useDefaultZone, validZone, wallInstant, wallOffset, writeValue, zoneCity, zoneLabel, zonePolicy, zoneShortOffset, zoneWithOffset };
+
+//# sourceMappingURL=date-zone.js.map

package/dist/controls/date-zone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-zone.js","names":[],"sources":["../../src/controls/date-zone.ts"],"sourcesContent":["/**\n * DATE / DATETIME values and time zones (DESIGN 6.4, D43), ported from V2 controls/date.tsx and fitted to what the\n * backend and the value adapters keep (adapters/values.ts datetimeToProd / datetimeFromProd, backend\n * parseDateField / parseDatetimeField).\n *\n * What the control writes, per field (`zonePolicy`):\n *\n *   date (any timezone)          \"2026-10-14\"                          a prod `date` without includeTime refuses a \"T\"\n *   datetime, timezone false     \"2026-10-14T09:00:00\"                 floating wall time\n *   datetime, true / unset       \"2026-10-14T09:00:00+05:30\"           the zone the editor picked lives in the offset:\n *   datetime, \"site\"             \"2026-10-14T09:00:00-07:00\"           prod keeps no [Zone] (the adapter names a kept\n *                                                                       one as lost and the dock refuses the write)\n *   datetime, \"fixed:<IANA>\"     \"2026-10-14T09:00:00-04:00[America/New_York]\"   the adapter checks the zone against\n *                                                                       config.timezone, stores the instant, and\n *                                                                       reads it back with the same [Zone]\n *\n * Seconds are always written (prod refuses a seconds-less datetime; the adapter names it \"format\"). The offset is the\n * zone's offset AT the wall time the author typed (two passes, so it is right on both sides of a clock change), and a\n * wall time that a clock change skips is refused with a named reason, never shifted silently.\n */\nimport * as React from \"react\";\nimport { useKitServices } from \"../context\";\nimport type { FieldSchema } from \"../schema/types\";\n\n/* ── The site zone (a host service) ───────────────────────────────────── */\ndeclare module \"../context\" {\n  interface KitServices {\n    /**\n     * The site's IANA zone (Project.localeConfig.timeZone, Settings › General): where a new date/time value starts and\n     * what timezone \"site\" locks to. The dock passes `useSiteTimeZone().zone` when its source is \"site\". Absent or not\n     * a zone → the viewer's browser zone, which the picker names \"Your time zone\".\n     */\n    siteTimeZone?: string;\n  }\n}\n\nexport type ZoneSource = \"site\" | \"browser\";\n\nexport function validZone(z: unknown): z is string {\n  if (typeof z !== \"string\" || !z) return false;\n  try {\n    new Intl.DateTimeFormat(\"en-US\", { timeZone: z });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** ICU still lists some zones under their old names; people read the current ones (Kolkata, not Calcutta). */\nconst MODERN: Readonly<Record<string, string>> = {\n  \"Asia/Calcutta\": \"Asia/Kolkata\",\n  \"Asia/Katmandu\": \"Asia/Kathmandu\",\n  \"Asia/Saigon\": \"Asia/Ho_Chi_Minh\",\n  \"Asia/Rangoon\": \"Asia/Yangon\",\n  \"Europe/Kiev\": \"Europe/Kyiv\",\n  \"America/Godthab\": \"America/Nuuk\",\n  \"Atlantic/Faeroe\": \"Atlantic/Faroe\",\n  \"America/Buenos_Aires\": \"America/Argentina/Buenos_Aires\",\n};\nexport const modernZone = (z: string) => (MODERN[z] && validZone(MODERN[z]) ? MODERN[z] : z);\n\nexport function browserZone(): string {\n  try {\n    return modernZone(Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\");\n  } catch {\n    return \"UTC\";\n  }\n}\n\n/** The zone a new value starts in: the site's, else the browser's. `source` names which one. */\nexport function useDefaultZone(): { zone: string; source: ZoneSource } {\n  const site = useKitServices().siteTimeZone;\n  return React.useMemo(() => (validZone(site) ? { zone: site, source: \"site\" as const } : { zone: browserZone(), source: \"browser\" as const }), [site]);\n}\n\n/* ── Policy ───────────────────────────────────────────────────────────── */\nexport type ZoneMode = \"pick\" | \"site\" | \"fixed\" | \"none\";\n/**\n * What the schema allows. A `date` never carries a zone here: prod stores a date as \"YYYY-MM-DD\" and refuses a time on\n * a date field without includeTime, so a zoned date (V2 allowed one) would be refused at save.\n */\nexport function zonePolicy(field: Pick<FieldSchema, \"type\" | \"timezone\">): { mode: ZoneMode; zone?: string } {\n  if (field.type !== \"datetime\") return { mode: \"none\" };\n  const t = field.timezone ?? true;\n  if (t === false) return { mode: \"none\" };\n  if (t === \"site\") return { mode: \"site\" };\n  if (typeof t === \"string\" && t.startsWith(\"fixed:\")) {\n    const z = t.slice(6);\n    return validZone(z) ? { mode: \"fixed\", zone: z } : { mode: \"site\" };\n  }\n  return { mode: \"pick\" };\n}\n\n/* ── Offsets ──────────────────────────────────────────────────────────── */\nconst pad = (n: number) => String(Math.abs(Math.trunc(n))).padStart(2, \"0\");\n\n/** The zone's UTC offset in minutes at an instant (+330 for Kolkata). */\nexport function offsetMinutes(zone: string, at: Date): number {\n  try {\n    const name = new Intl.DateTimeFormat(\"en-US\", { timeZone: zone, timeZoneName: \"longOffset\" }).formatToParts(at).find((p) => p.type === \"timeZoneName\")?.value ?? \"GMT\";\n    const m = /GMT([+\\-−])(\\d{1,2})(?::?(\\d{2}))?/.exec(name);\n    if (!m) return 0;\n    const sign = m[1] === \"+\" ? 1 : -1;\n    return sign * (Number(m[2]) * 60 + Number(m[3] ?? 0));\n  } catch {\n    return 0;\n  }\n}\n\n/** +330 → \"+05:30\"; 0 → \"+00:00\". */\nexport const offsetIso = (min: number) => `${min < 0 ? \"-\" : \"+\"}${pad(Math.floor(Math.abs(min) / 60))}:${pad(Math.abs(min) % 60)}`;\n\n/** \"GMT+5:30\", \"GMT−7\", \"GMT\" — the short form people read (with a true minus sign). */\nexport function zoneShortOffset(zone: string, at = new Date()): string {\n  const min = offsetMinutes(zone, at);\n  if (min === 0) return \"GMT\";\n  const h = Math.floor(Math.abs(min) / 60);\n  const m = Math.abs(min) % 60;\n  return `GMT${min < 0 ? \"−\" : \"+\"}${h}${m ? `:${pad(m)}` : \"\"}`;\n}\n\nexport const zoneCity = (z: string) => (z === \"UTC\" || z === \"Etc/UTC\" ? \"UTC\" : (z.split(\"/\").pop() ?? z).replace(/_/g, \" \"));\n/** \"GMT+5:30 · Kolkata\" */\nexport const zoneLabel = (zone: string, at?: Date) => `${zoneShortOffset(zone, at)} · ${zoneCity(zone)}`;\n\n/* ── Wall time ↔ instant ──────────────────────────────────────────────── */\nexport interface Wall {\n  /** \"YYYY-MM-DD\" */\n  ymd: string;\n  /** \"HH:mm\" */\n  time: string;\n}\nconst ymdParts = (ymd: string) => ymd.split(\"-\").map(Number) as [number, number, number];\nconst hmParts = (time: string) => time.split(\":\").map(Number) as [number, number];\nconst wallUtc = ({ ymd, time }: Wall) => {\n  const [y, mo, d] = ymdParts(ymd);\n  const [h, mi] = hmParts(time);\n  return Date.UTC(y, mo - 1, d, h, mi);\n};\n\n/** The wall clock an instant shows in a zone. */\nexport function instantToWall(instant: Date, zone: string): Wall {\n  const parts = new Intl.DateTimeFormat(\"en-CA\", { timeZone: zone, year: \"numeric\", month: \"2-digit\", day: \"2-digit\", hour: \"2-digit\", minute: \"2-digit\", hourCycle: \"h23\" }).formatToParts(instant);\n  const get = (t: string) => parts.find((p) => p.type === t)?.value ?? \"00\";\n  return { ymd: `${get(\"year\")}-${get(\"month\")}-${get(\"day\")}`, time: `${get(\"hour\")}:${get(\"minute\")}` };\n}\n\n/**\n * The offset of a wall time in a zone, or null when a clock change skips that wall time (it names no instant there).\n * Two passes: the offset at the naive instant, then at the instant that offset gives.\n */\nexport function wallOffset(zone: string, wall: Wall): number | null {\n  const naive = wallUtc(wall);\n  const first = offsetMinutes(zone, new Date(naive));\n  const second = offsetMinutes(zone, new Date(naive - first * 60_000));\n  for (const off of second === first ? [first] : [second, first]) {\n    const back = instantToWall(new Date(naive - off * 60_000), zone);\n    if (back.ymd === wall.ymd && back.time === wall.time) return off;\n  }\n  return null;\n}\n\n/** The instant a wall time names in a zone (the earlier one when a clock change skips it). */\nexport const wallInstant = (zone: string, wall: Wall) => new Date(wallUtc(wall) - (wallOffset(zone, wall) ?? offsetMinutes(zone, new Date(wallUtc(wall)))) * 60_000);\n\n/* ── Stored value → parts ─────────────────────────────────────────────── */\nexport interface ParsedValue {\n  /** the day as stored (wall clock), or null when empty */\n  wall: Wall | null;\n  hasTime: boolean;\n  /** the stated offset in minutes (\"Z\" → 0); undefined for a floating time */\n  offset?: number;\n  /** an RFC 9557 [Zone] suffix, when valid */\n  zone?: string;\n  /** false: a value this control cannot read (an object, a word); it is shown and never overwritten by accident */\n  readable: boolean;\n}\n\nconst STORED = /^(\\d{4})-(\\d{2})-(\\d{2})(?:[T ](\\d{2}):(\\d{2})(?::\\d{2}(?:\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?(?:\\[([^\\]]+)\\])?$/;\nconst EMPTY: ParsedValue = { wall: null, hasTime: false, readable: true };\n\nexport function parseStored(v: unknown): ParsedValue {\n  if (v == null || v === \"\") return EMPTY;\n  if (typeof v !== \"string\") return { ...EMPTY, readable: false };\n  const m = STORED.exec(v.trim());\n  if (!m) return { ...EMPTY, readable: false };\n  const [, y, mo, d, h, mi, off, zone] = m;\n  const date = new Date(Date.UTC(Number(y), Number(mo) - 1, Number(d)));\n  if (date.getUTCMonth() !== Number(mo) - 1 || date.getUTCDate() !== Number(d)) return { ...EMPTY, readable: false };\n  let offset: number | undefined;\n  if (off === \"Z\") offset = 0;\n  else if (off) {\n    const om = /([+-])(\\d{2}):?(\\d{2})/.exec(off)!;\n    offset = (om[1] === \"-\" ? -1 : 1) * (Number(om[2]) * 60 + Number(om[3]));\n  }\n  return { wall: { ymd: `${y}-${mo}-${d}`, time: h ? `${h}:${mi}` : \"09:00\" }, hasTime: !!h, offset, zone: validZone(zone) ? zone : undefined, readable: true };\n}\n\n/** A stored value as a JS Date (drops the [Zone] annotation, which `new Date()` can't read). */\nexport function storedToDate(v: unknown): Date | null {\n  if (typeof v !== \"string\" || !v) return null;\n  const d = new Date(v.replace(/\\[[^\\]]*\\]$/, \"\"));\n  return Number.isNaN(d.getTime()) ? null : d;\n}\n\n/* ── Zones ────────────────────────────────────────────────────────────── */\n/** Every IANA zone this runtime knows, UTC included. */\nexport const ALL_ZONES: readonly string[] = (() => {\n  const list = typeof Intl.supportedValuesOf === \"function\" ? Intl.supportedValuesOf(\"timeZone\").map(modernZone) : [];\n  return Array.from(new Set(list.includes(\"UTC\") ? list : [...list, \"UTC\"]));\n})();\n\n/** The first zone (in order) whose offset at the instant is `offset`; undefined when none is. */\nexport function zoneWithOffset(offset: number, instant: Date, candidates: readonly (string | undefined)[]): string | undefined {\n  for (const z of candidates) if (z && validZone(z) && offsetMinutes(z, instant) === offset) return z;\n  return undefined;\n}\n\n/**\n * What the control shows for a stored value: the wall time and the zone it lives in.\n *\n *   - none: the stored wall time, as typed.\n *   - site / fixed: that zone. A stored instant with another offset is shown as THAT instant's wall time in the zone,\n *     so the shown and the saved time never disagree.\n *   - pick: the stored [Zone]; else the zone the editor picked this session, the default, the browser's, then any\n *     zone whose offset matches the stored one (a \"+05:30\" reads back as Kolkata). A floating time reads in the default.\n */\nexport function resolveShown(parsed: ParsedValue, mode: ZoneMode, zones: { fixed?: string; def: string; picked?: string }): { wall: Wall | null; zone: string } {\n  const lockedZone = mode === \"fixed\" ? zones.fixed! : zones.def;\n  if (!parsed.wall) return { wall: null, zone: mode === \"pick\" ? (zones.picked ?? zones.def) : lockedZone };\n  if (mode === \"none\" || parsed.offset === undefined) {\n    const zone = mode === \"pick\" ? (parsed.zone ?? zones.picked ?? zones.def) : lockedZone;\n    return { wall: parsed.wall, zone };\n  }\n  const instant = new Date(wallUtc(parsed.wall) - parsed.offset * 60_000);\n  if (mode === \"pick\") {\n    const zone = (parsed.zone && offsetMinutes(parsed.zone, instant) === parsed.offset ? parsed.zone : undefined) ?? zoneWithOffset(parsed.offset, instant, [zones.picked, zones.def, browserZone(), ...ALL_ZONES]);\n    if (zone) return { wall: parsed.wall, zone };\n    return { wall: instantToWall(instant, zones.def), zone: zones.def };\n  }\n  return { wall: offsetMinutes(lockedZone, instant) === parsed.offset ? parsed.wall : instantToWall(instant, lockedZone), zone: lockedZone };\n}\n\n/* ── Parts → stored value ─────────────────────────────────────────────── */\nexport type WriteResult = { ok: true; value: string } | { ok: false; reason: string };\n\n/** The stored string for a wall time under the field's policy (file header). */\nexport function writeValue(o: { withTime: boolean; mode: ZoneMode; wall: Wall; zone: string }): WriteResult {\n  const { withTime, mode, wall, zone } = o;\n  if (!withTime) return { ok: true, value: wall.ymd };\n  const local = `${wall.ymd}T${wall.time}:00`;\n  if (mode === \"none\") return { ok: true, value: local };\n  const off = wallOffset(zone, wall);\n  if (off === null) return { ok: false, reason: `That local time doesn't exist in ${zoneCity(zone)} (clocks change). Pick another time.` };\n  return { ok: true, value: `${local}${offsetIso(off)}${mode === \"fixed\" ? `[${zone}]` : \"\"}` };\n}\n\n/** Today in a zone (the browser's local day for a floating field). */\nexport function todayIn(zone: string | undefined, now = new Date()): string {\n  if (zone) return instantToWall(now, zone).ymd;\n  return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;\n}\n"],"mappings":"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"}

package/dist/controls/date.d.ts

@@ -0,0 +1,7 @@
+import type { ControlProps } from "../types";
+export declare function MiniCalendar({ value, today, onSelect }: {
+    value: string | null;
+    today: string;
+    onSelect: (ymd: string) => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function DateControl({ field, value, onChange, readOnly, id, invalid }: ControlProps): import("react/jsx-runtime").JSX.Element;