@dataverse-kit/calendar-kit 0.1.0

package/dist/dataverse.d.cts

@@ -0,0 +1,121 @@
+import { c as CalendarValue, Z as ZoneOffset, a as CalendarEvent, S as SlotSelection, b as CalendarEventChange } from './types-u3Gpxk53.cjs';
+
+/**
+ * Dataverse's three DateTime behaviours, and the FOUR different shapes one value takes on its
+ * way through a model-driven app. Every rule below was MEASURED on a live org (2026-09-26,
+ * `spikes/calendar-view-fc7/FINDINGS.md` in the parent workspace); none is from documentation.
+ *
+ * ★★★ The two write paths are DIFFERENT CONTRACTS. The same text means different things to
+ * `webAPI.updateRecord` and to `navigation.openForm` parameters:
+ *
+ *   | behaviour  | read (dataset getValue)     | Web API write          | form parameter (quick create) |
+ *   |------------|-----------------------------|------------------------|-------------------------------|
+ *   | UserLocal  | `…T06:30:00.000Z` instant   | instant `…Z`           | wall clock, NO `Z`            |
+ *   | DateOnly   | `…T00:00:00.000Z` UTC-midn. | `YYYY-MM-DD`           | `YYYY-MM-DDT00:00:00`, NO `Z` |
+ *   | TZI        | `…T23:30:00.000Z` face+`Z`  | wall clock WITH `Z`    | wall clock, NO `Z`            |
+ *
+ * Measured failures of the obvious choice, each of which a unit test here pins:
+ *  - a DateOnly read through `new Date()` lands on the PREVIOUS day anywhere west of UTC;
+ *  - a bare `YYYY-MM-DD` form parameter was stored as the previous day (Pacific user);
+ *  - a TZI form parameter WITH `Z` was treated as UTC and shifted −7 h.
+ * The first two are why a well-known client control had a "+1 day" hack in its click handler.
+ */
+declare const DateTimeBehavior: {
+    readonly UserLocal: 1;
+    readonly DateOnly: 2;
+    readonly TimeZoneIndependent: 3;
+};
+type DateTimeBehavior = (typeof DateTimeBehavior)[keyof typeof DateTimeBehavior];
+/**
+ * The behaviour of a column, from whatever metadata shape the host produced.
+ *
+ * ★ `getEntityMetadata` in a PCF host answers `Behavior: 1|2|3` (MEASURED). The Web API's
+ *   `EntityDefinitions` answers `DateTimeBehavior: { Value: 'UserLocal' }`. Both are accepted.
+ * ★ A DateOnly column is also recognisable from its PCF `dataType` alone
+ *   (`DateAndTime.DateOnly`). TZI and UserLocal are NOT — both report `DateAndTime.DateAndTime` —
+ *   so without metadata a TZI column is indistinguishable and is treated as UserLocal. Callers
+ *   that can see that ambiguity should surface it (see `adapters/pcf-dataset`).
+ */
+declare function behaviorOf(meta: unknown, dataType?: string): DateTimeBehavior;
+/**
+ * A raw column value (dataset `getValue()`, or a Web API property) → a calendar value.
+ *
+ * ★★★ `getValue()` returns an ISO STRING for all three behaviours, despite
+ * `@types/powerapps-component-framework` declaring `Date`. A `Date` is still accepted, because a
+ * test double or another host may produce one — and it is read through its UTC fields, which is
+ * what the platform's strings encode.
+ */
+declare function readDataverseDate(raw: unknown, behavior: DateTimeBehavior): CalendarValue | null;
+/**
+ * A calendar value → the text `webAPI.updateRecord` / `createRecord` wants for this behaviour.
+ * `zone` is needed only to turn a value of a different kind into this one (e.g. an all-day drop
+ * onto a UserLocal column); same-kind values pass straight through.
+ */
+declare function toWebApiDate(value: CalendarValue, behavior: DateTimeBehavior, zone: ZoneOffset): string;
+/**
+ * A calendar value → the text a `navigation.openForm` form PARAMETER wants (quick create
+ * prefill). Wall clock in the user's zone, never with `Z`.
+ *
+ * ★ UNMEASURED: whether "wall clock" here means the Dynamics USER's zone or the BROWSER's when
+ *   they differ. Measured only with both in Pacific. Pass the user zone; if the org proof shows
+ *   the browser's is used, this is the one function to change.
+ */
+declare function toFormParameterDate(value: CalendarValue, behavior: DateTimeBehavior, zone: ZoneOffset): string;
+/** Dataverse stores an all-day END inclusive; the calendar's is exclusive. */
+declare const inclusiveEndToExclusive: (lastDay: CalendarValue) => CalendarValue;
+declare const exclusiveEndToInclusive: (dayAfter: CalendarValue) => CalendarValue;
+
+/**
+ * Which columns hold what. Logical names. Only `start` is required — that is the whole
+ * genericity story: the same calendar shows Appointments for one client and Orders for another,
+ * because a maker names the columns rather than a developer.
+ */
+interface ColumnMap {
+    start: string;
+    end?: string;
+    title?: string;
+    /** A hex colour column, or a choice column whose option colours `colorOf` resolves. */
+    color?: string;
+    /** Location / staff / queue. Drives `resourceId` and, failing `color`, a group colour. */
+    group?: string;
+    /** A Yes/No column that forces all-day. */
+    allDay?: string;
+}
+/** The minimum a record source must answer — a dataset record, a Web API row, a fixture. */
+interface RecordAccessor {
+    id: string;
+    value(column: string): unknown;
+    formatted(column: string): string;
+}
+interface MapOptions {
+    /** Behaviour per DATE column (logical name). Missing ⇒ UserLocal. */
+    behaviors: Readonly<Record<string, DateTimeBehavior>>;
+    zone: ZoneOffset;
+    /** Resolve a colour column's value (e.g. choice option colours). Return undefined to fall back. */
+    colorOf?: (column: string, raw: unknown, formatted: string) => string | undefined;
+    /** Per-record read-only, e.g. a status that forbids rescheduling. */
+    isReadOnly?: (record: RecordAccessor) => boolean;
+}
+/**
+ * ★★ A Yes/No column's raw value in a PCF dataset is the STRING `"0"` / `"1"` — and
+ * `Boolean("0")` is `true`. MEASURED on a sibling gallery control, where every `false` row
+ * rendered ON. Read the digits, never truthiness.
+ */
+declare function readYesNo(raw: unknown): boolean;
+/** One record → one event, or null when it has no usable start. */
+declare function mapRecordToEvent(record: RecordAccessor, map: ColumnMap, opts: MapOptions): CalendarEvent | null;
+/**
+ * A move/resize → the column values to PATCH through the Web API.
+ * Columns the map does not name are never written.
+ */
+declare function toWebApiPatch(change: CalendarEventChange, map: ColumnMap, opts: Pick<MapOptions, 'behaviors' | 'zone'>): Record<string, string>;
+/**
+ * A selected empty range → quick-create form parameters. `extra` is merged underneath, so a
+ * host can prefill a lookup (the parent record) without it being overwritten by dates.
+ *
+ * ★ The all-day column is set to boolean `true` for an all-day selection. The accepted shape of
+ *   a Yes/No FORM PARAMETER is UNMEASURED; the date shapes are measured.
+ */
+declare function toQuickCreateParameters(selection: SlotSelection, map: ColumnMap, opts: Pick<MapOptions, 'behaviors' | 'zone'>, extra?: Record<string, unknown>): Record<string, unknown>;
+
+export { type ColumnMap, DateTimeBehavior, type MapOptions, type RecordAccessor, behaviorOf, exclusiveEndToInclusive, inclusiveEndToExclusive, mapRecordToEvent, readDataverseDate, readYesNo, toFormParameterDate, toQuickCreateParameters, toWebApiDate, toWebApiPatch };

package/dist/dataverse.d.ts

@@ -0,0 +1,121 @@
+import { c as CalendarValue, Z as ZoneOffset, a as CalendarEvent, S as SlotSelection, b as CalendarEventChange } from './types-u3Gpxk53.js';
+
+/**
+ * Dataverse's three DateTime behaviours, and the FOUR different shapes one value takes on its
+ * way through a model-driven app. Every rule below was MEASURED on a live org (2026-09-26,
+ * `spikes/calendar-view-fc7/FINDINGS.md` in the parent workspace); none is from documentation.
+ *
+ * ★★★ The two write paths are DIFFERENT CONTRACTS. The same text means different things to
+ * `webAPI.updateRecord` and to `navigation.openForm` parameters:
+ *
+ *   | behaviour  | read (dataset getValue)     | Web API write          | form parameter (quick create) |
+ *   |------------|-----------------------------|------------------------|-------------------------------|
+ *   | UserLocal  | `…T06:30:00.000Z` instant   | instant `…Z`           | wall clock, NO `Z`            |
+ *   | DateOnly   | `…T00:00:00.000Z` UTC-midn. | `YYYY-MM-DD`           | `YYYY-MM-DDT00:00:00`, NO `Z` |
+ *   | TZI        | `…T23:30:00.000Z` face+`Z`  | wall clock WITH `Z`    | wall clock, NO `Z`            |
+ *
+ * Measured failures of the obvious choice, each of which a unit test here pins:
+ *  - a DateOnly read through `new Date()` lands on the PREVIOUS day anywhere west of UTC;
+ *  - a bare `YYYY-MM-DD` form parameter was stored as the previous day (Pacific user);
+ *  - a TZI form parameter WITH `Z` was treated as UTC and shifted −7 h.
+ * The first two are why a well-known client control had a "+1 day" hack in its click handler.
+ */
+declare const DateTimeBehavior: {
+    readonly UserLocal: 1;
+    readonly DateOnly: 2;
+    readonly TimeZoneIndependent: 3;
+};
+type DateTimeBehavior = (typeof DateTimeBehavior)[keyof typeof DateTimeBehavior];
+/**
+ * The behaviour of a column, from whatever metadata shape the host produced.
+ *
+ * ★ `getEntityMetadata` in a PCF host answers `Behavior: 1|2|3` (MEASURED). The Web API's
+ *   `EntityDefinitions` answers `DateTimeBehavior: { Value: 'UserLocal' }`. Both are accepted.
+ * ★ A DateOnly column is also recognisable from its PCF `dataType` alone
+ *   (`DateAndTime.DateOnly`). TZI and UserLocal are NOT — both report `DateAndTime.DateAndTime` —
+ *   so without metadata a TZI column is indistinguishable and is treated as UserLocal. Callers
+ *   that can see that ambiguity should surface it (see `adapters/pcf-dataset`).
+ */
+declare function behaviorOf(meta: unknown, dataType?: string): DateTimeBehavior;
+/**
+ * A raw column value (dataset `getValue()`, or a Web API property) → a calendar value.
+ *
+ * ★★★ `getValue()` returns an ISO STRING for all three behaviours, despite
+ * `@types/powerapps-component-framework` declaring `Date`. A `Date` is still accepted, because a
+ * test double or another host may produce one — and it is read through its UTC fields, which is
+ * what the platform's strings encode.
+ */
+declare function readDataverseDate(raw: unknown, behavior: DateTimeBehavior): CalendarValue | null;
+/**
+ * A calendar value → the text `webAPI.updateRecord` / `createRecord` wants for this behaviour.
+ * `zone` is needed only to turn a value of a different kind into this one (e.g. an all-day drop
+ * onto a UserLocal column); same-kind values pass straight through.
+ */
+declare function toWebApiDate(value: CalendarValue, behavior: DateTimeBehavior, zone: ZoneOffset): string;
+/**
+ * A calendar value → the text a `navigation.openForm` form PARAMETER wants (quick create
+ * prefill). Wall clock in the user's zone, never with `Z`.
+ *
+ * ★ UNMEASURED: whether "wall clock" here means the Dynamics USER's zone or the BROWSER's when
+ *   they differ. Measured only with both in Pacific. Pass the user zone; if the org proof shows
+ *   the browser's is used, this is the one function to change.
+ */
+declare function toFormParameterDate(value: CalendarValue, behavior: DateTimeBehavior, zone: ZoneOffset): string;
+/** Dataverse stores an all-day END inclusive; the calendar's is exclusive. */
+declare const inclusiveEndToExclusive: (lastDay: CalendarValue) => CalendarValue;
+declare const exclusiveEndToInclusive: (dayAfter: CalendarValue) => CalendarValue;
+
+/**
+ * Which columns hold what. Logical names. Only `start` is required — that is the whole
+ * genericity story: the same calendar shows Appointments for one client and Orders for another,
+ * because a maker names the columns rather than a developer.
+ */
+interface ColumnMap {
+    start: string;
+    end?: string;
+    title?: string;
+    /** A hex colour column, or a choice column whose option colours `colorOf` resolves. */
+    color?: string;
+    /** Location / staff / queue. Drives `resourceId` and, failing `color`, a group colour. */
+    group?: string;
+    /** A Yes/No column that forces all-day. */
+    allDay?: string;
+}
+/** The minimum a record source must answer — a dataset record, a Web API row, a fixture. */
+interface RecordAccessor {
+    id: string;
+    value(column: string): unknown;
+    formatted(column: string): string;
+}
+interface MapOptions {
+    /** Behaviour per DATE column (logical name). Missing ⇒ UserLocal. */
+    behaviors: Readonly<Record<string, DateTimeBehavior>>;
+    zone: ZoneOffset;
+    /** Resolve a colour column's value (e.g. choice option colours). Return undefined to fall back. */
+    colorOf?: (column: string, raw: unknown, formatted: string) => string | undefined;
+    /** Per-record read-only, e.g. a status that forbids rescheduling. */
+    isReadOnly?: (record: RecordAccessor) => boolean;
+}
+/**
+ * ★★ A Yes/No column's raw value in a PCF dataset is the STRING `"0"` / `"1"` — and
+ * `Boolean("0")` is `true`. MEASURED on a sibling gallery control, where every `false` row
+ * rendered ON. Read the digits, never truthiness.
+ */
+declare function readYesNo(raw: unknown): boolean;
+/** One record → one event, or null when it has no usable start. */
+declare function mapRecordToEvent(record: RecordAccessor, map: ColumnMap, opts: MapOptions): CalendarEvent | null;
+/**
+ * A move/resize → the column values to PATCH through the Web API.
+ * Columns the map does not name are never written.
+ */
+declare function toWebApiPatch(change: CalendarEventChange, map: ColumnMap, opts: Pick<MapOptions, 'behaviors' | 'zone'>): Record<string, string>;
+/**
+ * A selected empty range → quick-create form parameters. `extra` is merged underneath, so a
+ * host can prefill a lookup (the parent record) without it being overwritten by dates.
+ *
+ * ★ The all-day column is set to boolean `true` for an all-day selection. The accepted shape of
+ *   a Yes/No FORM PARAMETER is UNMEASURED; the date shapes are measured.
+ */
+declare function toQuickCreateParameters(selection: SlotSelection, map: ColumnMap, opts: Pick<MapOptions, 'behaviors' | 'zone'>, extra?: Record<string, unknown>): Record<string, unknown>;
+
+export { type ColumnMap, DateTimeBehavior, type MapOptions, type RecordAccessor, behaviorOf, exclusiveEndToInclusive, inclusiveEndToExclusive, mapRecordToEvent, readDataverseDate, readYesNo, toFormParameterDate, toQuickCreateParameters, toWebApiDate, toWebApiPatch };

package/dist/dataverse.mjs

@@ -0,0 +1,263 @@
+// src/core/datetime.ts
+var DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+var FLOATING_RE = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,9})?)?$/;
+var INSTANT_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,9})?)?(?:Z|[+-]\d{2}:?\d{2})$/i;
+var pad = (n, w = 2) => String(n).padStart(w, "0");
+function kindOf(value) {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) throw new RangeError("Invalid Date");
+    return "instant";
+  }
+  const local = DATE_RE.test(value) ? "date" : FLOATING_RE.test(value) ? "floating" : null;
+  if (local) {
+    const m = FLOATING_RE.exec(value) ?? DATE_RE.exec(value);
+    const [, y, mo, d, h = "0", mi = "0", sec = "0"] = m;
+    const t = new Date(Date.UTC(+y, +mo - 1, +d, +h, +mi, +sec));
+    if (t.getUTCFullYear() !== +y || t.getUTCMonth() !== +mo - 1 || t.getUTCDate() !== +d || +h > 23 || +mi > 59 || +sec > 59) {
+      throw new RangeError(`Not a real calendar date or time: ${JSON.stringify(value)}`);
+    }
+    return local;
+  }
+  if (INSTANT_RE.test(value) && !Number.isNaN(new Date(value).getTime())) return "instant";
+  throw new RangeError(`Not an ISO-8601 date, wall-clock time or instant: ${JSON.stringify(value)}`);
+}
+function toInstant(value) {
+  if (value instanceof Date) return value.toISOString();
+  if (kindOf(value) !== "instant") throw new RangeError(`Not an instant: ${value}`);
+  return new Date(value).toISOString();
+}
+function wallMillis(wall) {
+  const m = FLOATING_RE.exec(wall) ?? DATE_RE.exec(wall);
+  if (!m) throw new RangeError(`Not a date or wall-clock time: ${wall}`);
+  const [, y, mo, d, h = "0", mi = "0", s = "0"] = m;
+  return Date.UTC(+y, +mo - 1, +d, +h, +mi, +s);
+}
+function formatWall(ms) {
+  const d = new Date(ms);
+  return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}T${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}:${pad(d.getUTCSeconds())}`;
+}
+function toWall(instant, zone) {
+  const at = instant instanceof Date ? instant : new Date(toInstant(instant));
+  return formatWall(at.getTime() + zone(at) * 6e4);
+}
+function fromWall(wall, zone) {
+  const w = wallMillis(wall);
+  const before = zone(new Date(w - 864e5));
+  const after = zone(new Date(w + 864e5));
+  const fits = (offset) => {
+    const t2 = w - offset * 6e4;
+    return zone(new Date(t2)) === offset ? t2 : null;
+  };
+  const candidates = [fits(before), fits(after)].filter((t2) => t2 !== null);
+  const t = candidates.length > 0 ? Math.min(...candidates) : w - before * 6e4;
+  return new Date(t).toISOString();
+}
+function toDate(value, zone) {
+  const k = kindOf(value);
+  if (k === "date") return value;
+  if (k === "floating") return value.slice(0, 10);
+  return toWall(value, zone).slice(0, 10);
+}
+function addDays(date, days) {
+  if (kindOf(date) !== "date") throw new RangeError(`addDays needs a date, got ${date}`);
+  return formatWall(wallMillis(date) + days * 864e5).slice(0, 10);
+}
+function normaliseFloating(value) {
+  return formatWall(wallMillis(value));
+}
+
+// src/dataverse/dates.ts
+var DateTimeBehavior = {
+  UserLocal: 1,
+  DateOnly: 2,
+  TimeZoneIndependent: 3
+};
+function behaviorOf(meta, dataType) {
+  const m = meta ?? {};
+  if (m.Behavior === 1 || m.Behavior === 2 || m.Behavior === 3) return m.Behavior;
+  const named = typeof m.DateTimeBehavior === "string" ? m.DateTimeBehavior : m.DateTimeBehavior?.Value;
+  if (named === "DateOnly") return DateTimeBehavior.DateOnly;
+  if (named === "TimeZoneIndependent") return DateTimeBehavior.TimeZoneIndependent;
+  if (named === "UserLocal") return DateTimeBehavior.UserLocal;
+  if (dataType === "DateAndTime.DateOnly") return DateTimeBehavior.DateOnly;
+  return DateTimeBehavior.UserLocal;
+}
+function rawText(raw) {
+  if (raw === null || raw === void 0 || raw === "") return null;
+  if (raw instanceof Date) return Number.isNaN(raw.getTime()) ? null : raw.toISOString();
+  if (typeof raw === "string") return raw;
+  return null;
+}
+function readDataverseDate(raw, behavior) {
+  const s = rawText(raw);
+  if (s === null) return null;
+  switch (behavior) {
+    case DateTimeBehavior.DateOnly:
+      return s.slice(0, 10);
+    case DateTimeBehavior.TimeZoneIndependent:
+      return normaliseFloating(s.replace(/(\.\d+)?(Z|[+-]\d{2}:?\d{2})$/i, ""));
+    default:
+      return toInstant(s);
+  }
+}
+function toWebApiDate(value, behavior, zone) {
+  const k = kindOf(value);
+  switch (behavior) {
+    case DateTimeBehavior.DateOnly:
+      return toDate(value, zone);
+    case DateTimeBehavior.TimeZoneIndependent:
+      return `${k === "instant" ? toWall(value, zone) : k === "date" ? `${value}T00:00:00` : normaliseFloating(value)}Z`;
+    default:
+      return k === "instant" ? toInstant(value) : fromWall(k === "date" ? `${value}T00:00:00` : value, zone);
+  }
+}
+function toFormParameterDate(value, behavior, zone) {
+  const k = kindOf(value);
+  if (behavior === DateTimeBehavior.DateOnly) return `${toDate(value, zone)}T00:00:00`;
+  if (k === "instant") return toWall(value, zone);
+  if (k === "date") return `${value}T00:00:00`;
+  return normaliseFloating(value);
+}
+var inclusiveEndToExclusive = (lastDay) => addDays(lastDay, 1);
+var exclusiveEndToInclusive = (dayAfter) => addDays(dayAfter, -1);
+
+// src/core/colors.ts
+var GROUP_PALETTE = [
+  "#0f6cbd",
+  // blue
+  "#107c10",
+  // green
+  "#c50f1f",
+  // red
+  "#8764b8",
+  // lavender
+  "#ae4b00",
+  // dark orange
+  "#03787c",
+  // teal
+  "#4f52b2",
+  // indigo
+  "#8a5b00",
+  // dark gold
+  "#c0077d",
+  // magenta
+  "#5c2e91"
+  // purple
+];
+function hash(key) {
+  let h = 2166136261;
+  for (let i = 0; i < key.length; i++) {
+    h ^= key.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return h >>> 0;
+}
+function groupColor(key, palette = GROUP_PALETTE) {
+  return palette[hash(key) % palette.length];
+}
+function parseHex(color) {
+  const m = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(color.trim());
+  if (!m) return null;
+  const h = m[1].length === 3 ? m[1].replace(/./g, (c) => c + c) : m[1];
+  return [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16));
+}
+
+// src/dataverse/mapping.ts
+var behaviorFor = (opts, column) => opts.behaviors[column] ?? DateTimeBehavior.UserLocal;
+function readYesNo(raw) {
+  if (typeof raw === "boolean") return raw;
+  if (typeof raw === "number") return raw === 1;
+  if (typeof raw === "string") return raw === "1" || raw.toLowerCase() === "true";
+  return false;
+}
+function utcDayOf(value) {
+  return kindOf(value) === "instant" ? toInstant(value).slice(0, 10) : value.slice(0, 10);
+}
+function utcExclusiveDayOf(end) {
+  const text = kindOf(end) === "instant" ? toInstant(end) : end;
+  return text.length > 10 && text.slice(11, 19) !== "00:00:00" ? addDays(text.slice(0, 10), 1) : text.slice(0, 10);
+}
+function exclusiveDayOf(end, zone) {
+  const day = toDate(end, zone);
+  const wall = kindOf(end) === "instant" ? toWall(end, zone) : end;
+  return wall.length > 10 && wall.slice(11, 19) === "00:00:00" ? day : addDays(day, 1);
+}
+function mapRecordToEvent(record, map, opts) {
+  const startBehavior = behaviorFor(opts, map.start);
+  let start = readDataverseDate(record.value(map.start), startBehavior);
+  if (start === null) return null;
+  const endBehavior = map.end ? behaviorFor(opts, map.end) : startBehavior;
+  let end = map.end ? readDataverseDate(record.value(map.end), endBehavior) : null;
+  const forcedAllDay = map.allDay ? readYesNo(record.value(map.allDay)) : false;
+  const allDay = forcedAllDay || kindOf(start) === "date";
+  if (allDay) {
+    const flagged = forcedAllDay && startBehavior !== DateTimeBehavior.DateOnly;
+    start = flagged ? utcDayOf(start) : toDate(start, opts.zone);
+    if (end !== null) {
+      end = endBehavior === DateTimeBehavior.DateOnly ? inclusiveEndToExclusive(end) : flagged ? utcExclusiveDayOf(end) : exclusiveDayOf(end, opts.zone);
+    }
+    if (end !== null && end <= start) end = addDays(start, 1);
+  } else if (end !== null && kindOf(end) !== kindOf(start)) {
+    end = null;
+  } else if (end !== null && end <= start) {
+    end = null;
+  }
+  const title = (map.title ? record.formatted(map.title) : "") || "(untitled)";
+  const groupKey = map.group ? record.formatted(map.group) || void 0 : void 0;
+  let color;
+  if (map.color) {
+    const raw = record.value(map.color);
+    const formatted = record.formatted(map.color);
+    color = opts.colorOf?.(map.color, raw, formatted);
+    if (!color && typeof raw === "string" && parseHex(raw)) color = raw;
+  }
+  if (!color && groupKey) color = groupColor(groupKey);
+  return {
+    id: record.id,
+    start,
+    end: end ?? void 0,
+    title,
+    color,
+    resourceId: groupKey,
+    allDay,
+    readOnly: opts.isReadOnly?.(record) ?? false
+  };
+}
+function toWebApiPatch(change, map, opts) {
+  const patch = {};
+  const write = (value, behavior) => change.allDay && behavior !== DateTimeBehavior.DateOnly && kindOf(value) === "date" ? `${value}T00:00:00Z` : toWebApiDate(value, behavior, opts.zone);
+  const sb = behaviorFor(opts, map.start);
+  patch[map.start] = write(change.start, sb);
+  if (map.end && change.end !== void 0) {
+    const eb = behaviorFor(opts, map.end);
+    const end = change.allDay && eb === DateTimeBehavior.DateOnly ? exclusiveEndToInclusive(change.end) : change.end;
+    patch[map.end] = write(end, eb);
+  }
+  return patch;
+}
+function toQuickCreateParameters(selection, map, opts, extra = {}) {
+  const params = { ...extra };
+  const sb = behaviorFor(opts, map.start);
+  params[map.start] = toFormParameterDate(selection.start, sb, opts.zone);
+  if (map.end) {
+    const eb = behaviorFor(opts, map.end);
+    const end = selection.allDay && eb === DateTimeBehavior.DateOnly ? exclusiveEndToInclusive(selection.end) : selection.end;
+    params[map.end] = toFormParameterDate(end, eb, opts.zone);
+  }
+  if (map.allDay && selection.allDay) params[map.allDay] = true;
+  return params;
+}
+export {
+  DateTimeBehavior,
+  behaviorOf,
+  exclusiveEndToInclusive,
+  inclusiveEndToExclusive,
+  mapRecordToEvent,
+  readDataverseDate,
+  readYesNo,
+  toFormParameterDate,
+  toQuickCreateParameters,
+  toWebApiDate,
+  toWebApiPatch
+};
+//# sourceMappingURL=dataverse.mjs.map

package/dist/dataverse.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/datetime.ts","../src/dataverse/dates.ts","../src/core/colors.ts","../src/dataverse/mapping.ts"],"sourcesContent":["import type { CalendarValue, ValueKind, ZoneOffset } from './types';\n\n/**\n * Value-kind detection and zone conversion.\n *\n * ★★ Nothing in this file may read the PROCESS time zone. Every `Date` is built and read through\n *    its UTC fields, so the same input gives the same output on a laptop in Auckland and a CI\n *    runner in UTC. `npm test` runs the suite under three TZ values to prove it — a single-zone\n *    run cannot see a leak, because the developer's zone is the one the code was written in.\n */\n\nconst DATE_RE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst FLOATING_RE = /^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d{1,9})?)?$/;\nconst INSTANT_RE = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?(?:Z|[+-]\\d{2}:?\\d{2})$/i;\n\nconst pad = (n: number, w = 2): string => String(n).padStart(w, '0');\n\n/** The browser's own zone, east-positive. The default when a host supplies none. */\nexport const browserZone: ZoneOffset = (instant) => -instant.getTimezoneOffset();\n\n/** A fixed zone (no daylight saving). Mostly for tests and demos. */\nexport const fixedZone =\n  (minutesEast: number): ZoneOffset =>\n  () =>\n    minutesEast;\n\nexport function kindOf(value: CalendarValue | Date): ValueKind {\n  if (value instanceof Date) {\n    if (Number.isNaN(value.getTime())) throw new RangeError('Invalid Date');\n    return 'instant';\n  }\n  const local = DATE_RE.test(value) ? 'date' : FLOATING_RE.test(value) ? 'floating' : null;\n  if (local) {\n    // ★ The regex accepts `2026-02-31`; Date.UTC would silently roll it to March 3rd. Reject\n    //   any date whose fields do not survive a round trip.\n    const m = (FLOATING_RE.exec(value) ?? DATE_RE.exec(value))!;\n    const [, y, mo, d, h = '0', mi = '0', sec = '0'] = m;\n    const t = new Date(Date.UTC(+y, +mo - 1, +d, +h, +mi, +sec));\n    if (t.getUTCFullYear() !== +y || t.getUTCMonth() !== +mo - 1 || t.getUTCDate() !== +d || +h > 23 || +mi > 59 || +sec > 59) {\n      throw new RangeError(`Not a real calendar date or time: ${JSON.stringify(value)}`);\n    }\n    return local;\n  }\n  if (INSTANT_RE.test(value) && !Number.isNaN(new Date(value).getTime())) return 'instant';\n  throw new RangeError(`Not an ISO-8601 date, wall-clock time or instant: ${JSON.stringify(value)}`);\n}\n\n/** An instant as canonical UTC ISO text (`…T…Z`, milliseconds kept). */\nexport function toInstant(value: CalendarValue | Date): CalendarValue {\n  if (value instanceof Date) return value.toISOString();\n  if (kindOf(value) !== 'instant') throw new RangeError(`Not an instant: ${value}`);\n  return new Date(value).toISOString();\n}\n\n/** `Date.UTC` from wall-clock fields — i.e. the wall clock treated AS IF it were UTC. */\nfunction wallMillis(wall: string): number {\n  const m = FLOATING_RE.exec(wall) ?? DATE_RE.exec(wall);\n  if (!m) throw new RangeError(`Not a date or wall-clock time: ${wall}`);\n  const [, y, mo, d, h = '0', mi = '0', s = '0'] = m;\n  return Date.UTC(+y, +mo - 1, +d, +h, +mi, +s);\n}\n\nfunction formatWall(ms: number): string {\n  const d = new Date(ms);\n  return (\n    `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}` +\n    `T${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}:${pad(d.getUTCSeconds())}`\n  );\n}\n\n/** The wall-clock reading of an instant in `zone`, as floating text (`YYYY-MM-DDTHH:mm:ss`). */\nexport function toWall(instant: CalendarValue | Date, zone: ZoneOffset): CalendarValue {\n  const at = instant instanceof Date ? instant : new Date(toInstant(instant));\n  return formatWall(at.getTime() + zone(at) * 60_000);\n}\n\n/**\n * The instant at which `zone`'s clocks read `wall`.\n *\n * The offset depends on the instant being solved for, so this takes the offset in force a day\n * BEFORE and a day AFTER the wall reading (no zone changes offset twice in 48 h) and tries both:\n *  - an ordinary time: both give the same instant;\n *  - a wall time that exists TWICE (fall-back): both round-trip, and the EARLIER is returned;\n *  - a wall time that DOES NOT EXIST (spring-forward gap): neither round-trips, and the\n *    pre-transition offset is used, which pushes it forward by the gap (02:30 → 03:30), as JS\n *    `Date` does. What Dataverse does with one is UNMEASURED.\n *\n * ★ A reviewer caught the first version returning the LATER occurrence east of UTC (Berlin) and\n *   the earlier one west of it (Pacific): the two-pass guess settled on whichever offset the\n *   first guess happened to land in. Tests now pin both hemispheres with synthetic zones.\n */\nexport function fromWall(wall: CalendarValue, zone: ZoneOffset): CalendarValue {\n  const w = wallMillis(wall);\n  const before = zone(new Date(w - 86_400_000));\n  const after = zone(new Date(w + 86_400_000));\n  const fits = (offset: number): number | null => {\n    const t = w - offset * 60_000;\n    return zone(new Date(t)) === offset ? t : null;\n  };\n  const candidates = [fits(before), fits(after)].filter((t): t is number => t !== null);\n  const t = candidates.length > 0 ? Math.min(...candidates) : w - before * 60_000;\n  return new Date(t).toISOString();\n}\n\n/** The calendar day (`YYYY-MM-DD`) of any value, in `zone` for instants. */\nexport function toDate(value: CalendarValue | Date, zone: ZoneOffset): CalendarValue {\n  const k = kindOf(value);\n  if (k === 'date') return value as string;\n  if (k === 'floating') return (value as string).slice(0, 10);\n  return toWall(value, zone).slice(0, 10);\n}\n\n/** Calendar-day arithmetic on a `YYYY-MM-DD` value (no zone involved). */\nexport function addDays(date: CalendarValue, days: number): CalendarValue {\n  if (kindOf(date) !== 'date') throw new RangeError(`addDays needs a date, got ${date}`);\n  return formatWall(wallMillis(date) + days * 86_400_000).slice(0, 10);\n}\n\n/**\n * The UTC fields of a `Date` as floating text. For reading a `Date` that some library has\n * produced in a \"UTC-as-wall-clock\" convention (FullCalendar with `timeZone: 'UTC'`).\n */\nexport function utcFieldsToWall(d: Date): CalendarValue {\n  return formatWall(d.getTime());\n}\n\n/** Normalise floating text to seconds precision (`…T09:00` → `…T09:00:00`). */\nexport function normaliseFloating(value: CalendarValue): CalendarValue {\n  return formatWall(wallMillis(value));\n}\n","import { addDays, fromWall, kindOf, normaliseFloating, toDate, toInstant, toWall } from '../core/datetime';\nimport type { CalendarValue, ZoneOffset } from '../core/types';\n\n/**\n * Dataverse's three DateTime behaviours, and the FOUR different shapes one value takes on its\n * way through a model-driven app. Every rule below was MEASURED on a live org (2026-09-26,\n * `spikes/calendar-view-fc7/FINDINGS.md` in the parent workspace); none is from documentation.\n *\n * ★★★ The two write paths are DIFFERENT CONTRACTS. The same text means different things to\n * `webAPI.updateRecord` and to `navigation.openForm` parameters:\n *\n *   | behaviour  | read (dataset getValue)     | Web API write          | form parameter (quick create) |\n *   |------------|-----------------------------|------------------------|-------------------------------|\n *   | UserLocal  | `…T06:30:00.000Z` instant   | instant `…Z`           | wall clock, NO `Z`            |\n *   | DateOnly   | `…T00:00:00.000Z` UTC-midn. | `YYYY-MM-DD`           | `YYYY-MM-DDT00:00:00`, NO `Z` |\n *   | TZI        | `…T23:30:00.000Z` face+`Z`  | wall clock WITH `Z`    | wall clock, NO `Z`            |\n *\n * Measured failures of the obvious choice, each of which a unit test here pins:\n *  - a DateOnly read through `new Date()` lands on the PREVIOUS day anywhere west of UTC;\n *  - a bare `YYYY-MM-DD` form parameter was stored as the previous day (Pacific user);\n *  - a TZI form parameter WITH `Z` was treated as UTC and shifted −7 h.\n * The first two are why a well-known client control had a \"+1 day\" hack in its click handler.\n */\nexport const DateTimeBehavior = {\n  UserLocal: 1,\n  DateOnly: 2,\n  TimeZoneIndependent: 3,\n} as const;\nexport type DateTimeBehavior = (typeof DateTimeBehavior)[keyof typeof DateTimeBehavior];\n\n/**\n * The behaviour of a column, from whatever metadata shape the host produced.\n *\n * ★ `getEntityMetadata` in a PCF host answers `Behavior: 1|2|3` (MEASURED). The Web API's\n *   `EntityDefinitions` answers `DateTimeBehavior: { Value: 'UserLocal' }`. Both are accepted.\n * ★ A DateOnly column is also recognisable from its PCF `dataType` alone\n *   (`DateAndTime.DateOnly`). TZI and UserLocal are NOT — both report `DateAndTime.DateAndTime` —\n *   so without metadata a TZI column is indistinguishable and is treated as UserLocal. Callers\n *   that can see that ambiguity should surface it (see `adapters/pcf-dataset`).\n */\nexport function behaviorOf(meta: unknown, dataType?: string): DateTimeBehavior {\n  const m = (meta ?? {}) as { Behavior?: unknown; DateTimeBehavior?: { Value?: unknown } | string };\n  if (m.Behavior === 1 || m.Behavior === 2 || m.Behavior === 3) return m.Behavior;\n  const named = typeof m.DateTimeBehavior === 'string' ? m.DateTimeBehavior : m.DateTimeBehavior?.Value;\n  if (named === 'DateOnly') return DateTimeBehavior.DateOnly;\n  if (named === 'TimeZoneIndependent') return DateTimeBehavior.TimeZoneIndependent;\n  if (named === 'UserLocal') return DateTimeBehavior.UserLocal;\n  if (dataType === 'DateAndTime.DateOnly') return DateTimeBehavior.DateOnly;\n  return DateTimeBehavior.UserLocal;\n}\n\nfunction rawText(raw: unknown): string | null {\n  if (raw === null || raw === undefined || raw === '') return null;\n  if (raw instanceof Date) return Number.isNaN(raw.getTime()) ? null : raw.toISOString();\n  if (typeof raw === 'string') return raw;\n  return null;\n}\n\n/**\n * A raw column value (dataset `getValue()`, or a Web API property) → a calendar value.\n *\n * ★★★ `getValue()` returns an ISO STRING for all three behaviours, despite\n * `@types/powerapps-component-framework` declaring `Date`. A `Date` is still accepted, because a\n * test double or another host may produce one — and it is read through its UTC fields, which is\n * what the platform's strings encode.\n */\nexport function readDataverseDate(raw: unknown, behavior: DateTimeBehavior): CalendarValue | null {\n  const s = rawText(raw);\n  if (s === null) return null;\n  switch (behavior) {\n    case DateTimeBehavior.DateOnly:\n      // `2026-09-29T00:00:00.000Z` (dataset) or `2026-09-29` (Web API): the first ten characters\n      // ARE the day. Never through `new Date()`.\n      return s.slice(0, 10);\n    case DateTimeBehavior.TimeZoneIndependent:\n      // Face value with a misleading `Z`: the digits are the wall clock. Strip the offset rather\n      // than slicing a fixed width — `…T23:30Z` (no seconds) would keep its `Z` at 19 chars.\n      return normaliseFloating(s.replace(/(\\.\\d+)?(Z|[+-]\\d{2}:?\\d{2})$/i, ''));\n    default:\n      return toInstant(s);\n  }\n}\n\n/**\n * A calendar value → the text `webAPI.updateRecord` / `createRecord` wants for this behaviour.\n * `zone` is needed only to turn a value of a different kind into this one (e.g. an all-day drop\n * onto a UserLocal column); same-kind values pass straight through.\n */\nexport function toWebApiDate(value: CalendarValue, behavior: DateTimeBehavior, zone: ZoneOffset): string {\n  const k = kindOf(value);\n  switch (behavior) {\n    case DateTimeBehavior.DateOnly:\n      return toDate(value, zone);\n    case DateTimeBehavior.TimeZoneIndependent:\n      // MEASURED: `…T13:00:00Z` stored and read back as a 1 PM face value.\n      return `${k === 'instant' ? toWall(value, zone) : k === 'date' ? `${value}T00:00:00` : normaliseFloating(value)}Z`;\n    default:\n      return k === 'instant' ? toInstant(value) : fromWall(k === 'date' ? `${value}T00:00:00` : value, zone);\n  }\n}\n\n/**\n * A calendar value → the text a `navigation.openForm` form PARAMETER wants (quick create\n * prefill). Wall clock in the user's zone, never with `Z`.\n *\n * ★ UNMEASURED: whether \"wall clock\" here means the Dynamics USER's zone or the BROWSER's when\n *   they differ. Measured only with both in Pacific. Pass the user zone; if the org proof shows\n *   the browser's is used, this is the one function to change.\n */\nexport function toFormParameterDate(value: CalendarValue, behavior: DateTimeBehavior, zone: ZoneOffset): string {\n  const k = kindOf(value);\n  if (behavior === DateTimeBehavior.DateOnly) return `${toDate(value, zone)}T00:00:00`;\n  if (k === 'instant') return toWall(value, zone);\n  if (k === 'date') return `${value}T00:00:00`;\n  return normaliseFloating(value);\n}\n\n/** Dataverse stores an all-day END inclusive; the calendar's is exclusive. */\nexport const inclusiveEndToExclusive = (lastDay: CalendarValue): CalendarValue => addDays(lastDay, 1);\nexport const exclusiveEndToInclusive = (dayAfter: CalendarValue): CalendarValue => addDays(dayAfter, -1);\n","/**\n * Event colours.\n *\n * ★ Without FullCalendar Premium there are no resource lanes, so \"appointments by location\"\n *   is expressed as ONE COLOUR PER GROUP. `groupColor` is deterministic (same key → same colour\n *   on every load and every machine), which is what lets a person learn the legend.\n * ★ Every palette entry carries white text at >= 4.5:1 (WCAG AA, normal text) — asserted by a\n *   test, not by eye. Host-supplied colours (Dataverse option colours are often pale) get their\n *   text colour from `readableTextOn` instead of assuming white; a well-known client control\n *   hard-coded white on yellow, which is ~1.4:1.\n */\nexport const GROUP_PALETTE: readonly string[] = [\n  '#0f6cbd', // blue\n  '#107c10', // green\n  '#c50f1f', // red\n  '#8764b8', // lavender\n  '#ae4b00', // dark orange\n  '#03787c', // teal\n  '#4f52b2', // indigo\n  '#8a5b00', // dark gold\n  '#c0077d', // magenta\n  '#5c2e91', // purple\n];\n\n/** FNV-1a — tiny, stable across engines, good enough spread for a 10-colour palette. */\nfunction hash(key: string): number {\n  let h = 0x811c9dc5;\n  for (let i = 0; i < key.length; i++) {\n    h ^= key.charCodeAt(i);\n    h = Math.imul(h, 0x01000193);\n  }\n  return h >>> 0;\n}\n\nexport function groupColor(key: string, palette: readonly string[] = GROUP_PALETTE): string {\n  return palette[hash(key) % palette.length];\n}\n\n/** `#rgb` / `#rrggbb` → [r, g, b] 0-255, or null for anything else (named colours, var()). */\nexport function parseHex(color: string): [number, number, number] | null {\n  const m = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(color.trim());\n  if (!m) return null;\n  const h = m[1].length === 3 ? m[1].replace(/./g, (c) => c + c) : m[1];\n  return [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16)) as [number, number, number];\n}\n\nfunction luminance([r, g, b]: [number, number, number]): number {\n  const lin = (c: number): number => {\n    const s = c / 255;\n    return s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;\n  };\n  return 0.2126 * lin(r) + 0.7152 * lin(g) + 0.0722 * lin(b);\n}\n\n/** WCAG contrast ratio between two hex colours, or null if either cannot be parsed. */\nexport function contrastRatio(a: string, b: string): number | null {\n  const pa = parseHex(a);\n  const pb = parseHex(b);\n  if (!pa || !pb) return null;\n  const [hi, lo] = [luminance(pa), luminance(pb)].sort((x, y) => y - x);\n  return (hi + 0.05) / (lo + 0.05);\n}\n\n/**\n * Black or white text, whichever reads better on `background`. Unparseable backgrounds\n * (a CSS variable, a named colour) get `undefined`, i.e. the theme's own event text colour.\n */\nexport function readableTextOn(background: string): '#000000' | '#ffffff' | undefined {\n  const onWhite = contrastRatio(background, '#ffffff');\n  const onBlack = contrastRatio(background, '#000000');\n  if (onWhite === null || onBlack === null) return undefined;\n  return onWhite >= onBlack ? '#ffffff' : '#000000';\n}\n","import { groupColor, parseHex } from '../core/colors';\nimport { addDays, kindOf, toDate, toInstant, toWall } from '../core/datetime';\nimport type { CalendarEvent, CalendarEventChange, CalendarValue, SlotSelection, ZoneOffset } from '../core/types';\nimport {\n  DateTimeBehavior,\n  exclusiveEndToInclusive,\n  inclusiveEndToExclusive,\n  readDataverseDate,\n  toFormParameterDate,\n  toWebApiDate,\n} from './dates';\n\n/**\n * Which columns hold what. Logical names. Only `start` is required — that is the whole\n * genericity story: the same calendar shows Appointments for one client and Orders for another,\n * because a maker names the columns rather than a developer.\n */\nexport interface ColumnMap {\n  start: string;\n  end?: string;\n  title?: string;\n  /** A hex colour column, or a choice column whose option colours `colorOf` resolves. */\n  color?: string;\n  /** Location / staff / queue. Drives `resourceId` and, failing `color`, a group colour. */\n  group?: string;\n  /** A Yes/No column that forces all-day. */\n  allDay?: string;\n}\n\n/** The minimum a record source must answer — a dataset record, a Web API row, a fixture. */\nexport interface RecordAccessor {\n  id: string;\n  value(column: string): unknown;\n  formatted(column: string): string;\n}\n\nexport interface MapOptions {\n  /** Behaviour per DATE column (logical name). Missing ⇒ UserLocal. */\n  behaviors: Readonly<Record<string, DateTimeBehavior>>;\n  zone: ZoneOffset;\n  /** Resolve a colour column's value (e.g. choice option colours). Return undefined to fall back. */\n  colorOf?: (column: string, raw: unknown, formatted: string) => string | undefined;\n  /** Per-record read-only, e.g. a status that forbids rescheduling. */\n  isReadOnly?: (record: RecordAccessor) => boolean;\n}\n\nconst behaviorFor = (opts: Pick<MapOptions, 'behaviors'>, column: string): DateTimeBehavior =>\n  opts.behaviors[column] ?? DateTimeBehavior.UserLocal;\n\n/**\n * ★★ A Yes/No column's raw value in a PCF dataset is the STRING `\"0\"` / `\"1\"` — and\n * `Boolean(\"0\")` is `true`. MEASURED on a sibling gallery control, where every `false` row\n * rendered ON. Read the digits, never truthiness.\n */\nexport function readYesNo(raw: unknown): boolean {\n  if (typeof raw === 'boolean') return raw;\n  if (typeof raw === 'number') return raw === 1;\n  if (typeof raw === 'string') return raw === '1' || raw.toLowerCase() === 'true';\n  return false;\n}\n\n/**\n * ★★★ MEASURED (appointment, 2026-09-27): an event FLAGGED all-day on date-time columns stores its\n * calendar date at UTC MIDNIGHT — `2026-10-01T00:00:00Z`→`2026-10-02T00:00:00Z` for \"Oct 1\",\n * even though the columns are UserLocal and the user is in Pacific. The platform's own formatted\n * value then reads \"9/30 5:00 PM\"; the form shows Oct 1. Reading it through the user's zone put\n * a one-day appointment on Wed AND Thu. So a flagged all-day value's DAY is its UTC date.\n */\nfunction utcDayOf(value: CalendarValue): CalendarValue {\n  return kindOf(value) === 'instant' ? toInstant(value).slice(0, 10) : value.slice(0, 10);\n}\nfunction utcExclusiveDayOf(end: CalendarValue): CalendarValue {\n  const text = kindOf(end) === 'instant' ? toInstant(end) : end;\n  return text.length > 10 && text.slice(11, 19) !== '00:00:00' ? addDays(text.slice(0, 10), 1) : text.slice(0, 10);\n}\n\n/** A date-time end → the exclusive day after the event, for an all-day rendering. */\nfunction exclusiveDayOf(end: CalendarValue, zone: ZoneOffset): CalendarValue {\n  const day = toDate(end, zone);\n  const wall = kindOf(end) === 'instant' ? toWall(end, zone) : end;\n  // Ending exactly at midnight already means \"up to, not including, this day\".\n  return wall.length > 10 && wall.slice(11, 19) === '00:00:00' ? day : addDays(day, 1);\n}\n\n/** One record → one event, or null when it has no usable start. */\nexport function mapRecordToEvent(record: RecordAccessor, map: ColumnMap, opts: MapOptions): CalendarEvent | null {\n  const startBehavior = behaviorFor(opts, map.start);\n  let start = readDataverseDate(record.value(map.start), startBehavior);\n  if (start === null) return null;\n\n  const endBehavior = map.end ? behaviorFor(opts, map.end) : startBehavior;\n  let end = map.end ? readDataverseDate(record.value(map.end), endBehavior) : null;\n\n  const forcedAllDay = map.allDay ? readYesNo(record.value(map.allDay)) : false;\n  const allDay = forcedAllDay || kindOf(start) === 'date';\n\n  if (allDay) {\n    const flagged = forcedAllDay && startBehavior !== DateTimeBehavior.DateOnly;\n    start = flagged ? utcDayOf(start) : toDate(start, opts.zone);\n    if (end !== null) {\n      end =\n        endBehavior === DateTimeBehavior.DateOnly\n          ? inclusiveEndToExclusive(end)\n          : flagged\n            ? utcExclusiveDayOf(end)\n            : exclusiveDayOf(end, opts.zone);\n    }\n    if (end !== null && end <= start) end = addDays(start, 1);\n  } else if (end !== null && kindOf(end) !== kindOf(start)) {\n    // A timed start with a date-only end (mixed behaviours): not renderable as one span.\n    end = null;\n  } else if (end !== null && end <= start) {\n    // A zero or negative duration renders as nothing in a time grid. Use the default length.\n    end = null;\n  }\n\n  const title = (map.title ? record.formatted(map.title) : '') || '(untitled)';\n  const groupKey = map.group ? record.formatted(map.group) || undefined : undefined;\n\n  let color: string | undefined;\n  if (map.color) {\n    const raw = record.value(map.color);\n    const formatted = record.formatted(map.color);\n    color = opts.colorOf?.(map.color, raw, formatted);\n    if (!color && typeof raw === 'string' && parseHex(raw)) color = raw;\n  }\n  if (!color && groupKey) color = groupColor(groupKey);\n\n  return {\n    id: record.id,\n    start,\n    end: end ?? undefined,\n    title,\n    color,\n    resourceId: groupKey,\n    allDay,\n    readOnly: opts.isReadOnly?.(record) ?? false,\n  };\n}\n\n/**\n * A move/resize → the column values to PATCH through the Web API.\n * Columns the map does not name are never written.\n */\nexport function toWebApiPatch(\n  change: CalendarEventChange,\n  map: ColumnMap,\n  opts: Pick<MapOptions, 'behaviors' | 'zone'>\n): Record<string, string> {\n  const patch: Record<string, string> = {};\n  // ★★★ An all-day change on DATE-TIME columns is written at UTC midnight (the platform's own\n  //     convention for flagged all-day events — see utcDayOf), never at the user's midnight.\n  const write = (value: CalendarValue, behavior: DateTimeBehavior): string =>\n    change.allDay && behavior !== DateTimeBehavior.DateOnly && kindOf(value) === 'date'\n      ? `${value}T00:00:00Z`\n      : toWebApiDate(value, behavior, opts.zone);\n  const sb = behaviorFor(opts, map.start);\n  patch[map.start] = write(change.start, sb);\n  if (map.end && change.end !== undefined) {\n    const eb = behaviorFor(opts, map.end);\n    const end = change.allDay && eb === DateTimeBehavior.DateOnly ? exclusiveEndToInclusive(change.end) : change.end;\n    patch[map.end] = write(end, eb);\n  }\n  return patch;\n}\n\n/**\n * A selected empty range → quick-create form parameters. `extra` is merged underneath, so a\n * host can prefill a lookup (the parent record) without it being overwritten by dates.\n *\n * ★ The all-day column is set to boolean `true` for an all-day selection. The accepted shape of\n *   a Yes/No FORM PARAMETER is UNMEASURED; the date shapes are measured.\n */\nexport function toQuickCreateParameters(\n  selection: SlotSelection,\n  map: ColumnMap,\n  opts: Pick<MapOptions, 'behaviors' | 'zone'>,\n  extra: Record<string, unknown> = {}\n): Record<string, unknown> {\n  const params: Record<string, unknown> = { ...extra };\n  const sb = behaviorFor(opts, map.start);\n  params[map.start] = toFormParameterDate(selection.start, sb, opts.zone);\n  if (map.end) {\n    const eb = behaviorFor(opts, map.end);\n    const end =\n      selection.allDay && eb === DateTimeBehavior.DateOnly ? exclusiveEndToInclusive(selection.end) : selection.end;\n    params[map.end] = toFormParameterDate(end, eb, opts.zone);\n  }\n  if (map.allDay && selection.allDay) params[map.allDay] = true;\n  return params;\n}\n"],"mappings":"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","names":["t"]}