@bimetal/temporal 0.35.0

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module @bimetal/temporal
+ *
+ * Domain-neutral temporal kernel: time model, durations, grid resolution,
+ * formatting. Stateless, deterministic, pure functions. Shared by every
+ * BIMETAL component family, not just the calendar.
+ * No DOM, no framework dependencies. ZERO external npm dependencies.
+ *
+ * Surface (Surface-Charge B / D3): this barrel exposes only the temporal base
+ * that is actually consumed. The unconsumed half of the duration algebra
+ * (`minutes`/`hours`/`days`/`between`/`duration`/`to*`), the unused unit
+ * constants, and a handful of unused helpers were retracted before the 1.0
+ * freeze — they live in their modules and return additively post-1.0 when a
+ * consumer needs them.
+ */
+export type { CalendarDateTime, TimeRange, Granularity, TimeSlot, Clock, FormatOptions, SnapStrategy, } from './types.js';
+export { Month, monthIndex, Weekday, weekdayIndex } from './vocabulary.js';
+/** Forward-API (P1, post-1.0): the typed-error union is advertised but not yet
+ *  constructed/handled by any consumer. Kept public as the documented error
+ *  contract; the concrete throwers land post-1.0. */
+export type { CalendarError } from './errors.js';
+export { CalendarValidationError } from './errors.js';
+export { MINUTES_PER_HOUR, HOURS_PER_DAY, DAYS_PER_WEEK, MS_PER_EXACT_DAY, } from './constants.js';
+export { createDateTime, fromEpochMs, now, addDays, addWeeks, addMonths, addYears, addHours, addMinutes, startOfDay, endOfDay, getYear, getMonth, getDayOfMonth, getDayOfWeek, getHours, getMinutes, toMinutesOfDay, isSameDay, isBefore, isAfter, isEqual, daysBetween, } from './datetime.js';
+export { toDateStr, parseDateStr } from './date-strings.js';
+export { createTimeRange, overlaps, clipTo, shiftRange, } from './time-range.js';
+export { durationInMinutes, } from './duration.js';
+export { snap, generateSlots, } from './granularity.js';
+export { formatDateTime, formatDayLabel, } from './format.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,QAAQ,EACR,KAAK,EAGL,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG3E;;qDAEqD;AACrD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,cAAc,EAEd,WAAW,EACX,GAAG,EACH,OAAO,EACP,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,cAAc,EACd,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EACL,eAAe,EACf,QAAQ,EACR,MAAM,EACN,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,IAAI,EACJ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+/**
+ * @module @bimetal/temporal
+ *
+ * Domain-neutral temporal kernel: time model, durations, grid resolution,
+ * formatting. Stateless, deterministic, pure functions. Shared by every
+ * BIMETAL component family, not just the calendar.
+ * No DOM, no framework dependencies. ZERO external npm dependencies.
+ *
+ * Surface (Surface-Charge B / D3): this barrel exposes only the temporal base
+ * that is actually consumed. The unconsumed half of the duration algebra
+ * (`minutes`/`hours`/`days`/`between`/`duration`/`to*`), the unused unit
+ * constants, and a handful of unused helpers were retracted before the 1.0
+ * freeze — they live in their modules and return additively post-1.0 when a
+ * consumer needs them.
+ */
+// ── Branded vocabulary (Month / Weekday) — see vocabulary.ts for the freeze rule.
+//    `Month`/`Weekday` are each a value (the constants) AND a type (the brand) via declaration
+//    merging, so this one export line carries both. ──
+export { Month, monthIndex, Weekday, weekdayIndex } from './vocabulary.js';
+export { CalendarValidationError } from './errors.js';
+// ── Time-Unit Constants ─────────────────────────────────────────
+export { MINUTES_PER_HOUR, HOURS_PER_DAY, DAYS_PER_WEEK, MS_PER_EXACT_DAY, } from './constants.js';
+// ── CalendarDateTime ────────────────────────────────────────────
+export { createDateTime, 
+// Documented migration bridge from Date/ISO/epochMs (migration guides) — public API.
+fromEpochMs, now, addDays, addWeeks, addMonths, addYears, addHours, addMinutes, startOfDay, endOfDay, getYear, getMonth, getDayOfMonth, getDayOfWeek, getHours, getMinutes, toMinutesOfDay, isSameDay, isBefore, isAfter, isEqual, daysBetween, } from './datetime.js';
+// ── Date strings (timezone-aware CalendarDateTime ↔ "YYYY-MM-DD") ─
+export { toDateStr, parseDateStr } from './date-strings.js';
+// ── TimeRange ───────────────────────────────────────────────────
+export { createTimeRange, overlaps, clipTo, shiftRange, } from './time-range.js';
+// ── Duration ────────────────────────────────────────────────────
+export { durationInMinutes, } from './duration.js';
+// ── Granularity ─────────────────────────────────────────────────
+export { snap, generateSlots, } from './granularity.js';
+// ── Formatting ──────────────────────────────────────────────────
+export { formatDateTime, formatDayLabel, } from './format.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAeH,mFAAmF;AACnF,+FAA+F;AAC/F,uDAAuD;AACvD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,mEAAmE;AACnE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,mEAAmE;AACnE,OAAO,EACL,cAAc;AACd,qFAAqF;AACrF,WAAW,EACX,GAAG,EACH,OAAO,EACP,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,cAAc,EACd,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,qEAAqE;AACrE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE5D,mEAAmE;AACnE,OAAO,EACL,eAAe,EACf,QAAQ,EACR,MAAM,EACN,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,mEAAmE;AACnE,OAAO,EACL,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,mEAAmE;AACnE,OAAO,EACL,IAAI,EACJ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,mEAAmE;AACnE,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/time-range.d.ts

@@ -0,0 +1,38 @@
+import type { CalendarDateTime, TimeRange } from './types.js';
+/** Create a TimeRange. Throws if start >= end. */
+export declare function createTimeRange(start: CalendarDateTime, end: CalendarDateTime): TimeRange;
+/**
+ * Build a TimeRange for an all-day event with user-facing **inclusive
+ * end** semantics.
+ *
+ * BIMETAL stores all-day events with **exclusive end** internally:
+ * `end = midnight of the day AFTER the last visible day`. Custom dialogs
+ * and importers that hand-build TimeRanges historically tripped over
+ * this — naive `{ start: 2026-04-15T00:00, end: 2026-04-15T23:59 }` looks
+ * right in storage but breaks drag math (degenerate ranges, off-by-one
+ * sums). This helper takes the *inclusive* form (the user picks "from
+ * April 15 to April 17") and normalises both ends:
+ *
+ * - `start` → `startOfDay(start)` — strips any time-of-day component
+ * - `end` → `addDays(startOfDay(end), 1)` — flips inclusive → exclusive
+ *
+ * @example Single-day event ("just today"):
+ *   createAllDayTimeRange(today, today)
+ *   // → { start: today 00:00, end: tomorrow 00:00 }
+ *
+ * @example Multi-day event ("April 15 through April 17 inclusive"):
+ *   createAllDayTimeRange(apr15, apr17)
+ *   // → { start: apr15 00:00, end: apr18 00:00 }
+ */
+export declare function createAllDayTimeRange(startDate: CalendarDateTime, endDate: CalendarDateTime): TimeRange;
+/** Intersection of two ranges. Returns null if they don't overlap. */
+export declare function intersect(a: TimeRange, b: TimeRange): TimeRange | null;
+/** Check if a range contains a point in time. */
+export declare function contains(range: TimeRange, dt: CalendarDateTime): boolean;
+/** Check if two ranges overlap (touching is not overlapping). */
+export declare function overlaps(a: TimeRange, b: TimeRange): boolean;
+/** Clip a range to fit within bounds. Returns null if no overlap. */
+export declare function clipTo(range: TimeRange, bounds: TimeRange): TimeRange | null;
+/** Shift a range to a new start, preserving duration. */
+export declare function shiftRange(range: TimeRange, newStart: CalendarDateTime): TimeRange;
+//# sourceMappingURL=time-range.d.ts.map

package/dist/time-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-range.d.ts","sourceRoot":"","sources":["../src/time-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI9D,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAQzF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,gBAAgB,GACxB,SAAS,CAKX;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAQtE;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAExE;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAE5D;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAE5E;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAMlF"}

package/dist/time-range.js

@@ -0,0 +1,67 @@
+import { CalendarValidationError } from './errors.js';
+import { addDays, startOfDay } from './datetime.js';
+/** Create a TimeRange. Throws if start >= end. */
+export function createTimeRange(start, end) {
+    if (start.epochMs >= end.epochMs) {
+        throw new CalendarValidationError({
+            type: 'INVALID_TIME_RANGE',
+            message: `start (${start.epochMs}) must be before end (${end.epochMs})`,
+        });
+    }
+    return { start, end };
+}
+/**
+ * Build a TimeRange for an all-day event with user-facing **inclusive
+ * end** semantics.
+ *
+ * BIMETAL stores all-day events with **exclusive end** internally:
+ * `end = midnight of the day AFTER the last visible day`. Custom dialogs
+ * and importers that hand-build TimeRanges historically tripped over
+ * this — naive `{ start: 2026-04-15T00:00, end: 2026-04-15T23:59 }` looks
+ * right in storage but breaks drag math (degenerate ranges, off-by-one
+ * sums). This helper takes the *inclusive* form (the user picks "from
+ * April 15 to April 17") and normalises both ends:
+ *
+ * - `start` → `startOfDay(start)` — strips any time-of-day component
+ * - `end` → `addDays(startOfDay(end), 1)` — flips inclusive → exclusive
+ *
+ * @example Single-day event ("just today"):
+ *   createAllDayTimeRange(today, today)
+ *   // → { start: today 00:00, end: tomorrow 00:00 }
+ *
+ * @example Multi-day event ("April 15 through April 17 inclusive"):
+ *   createAllDayTimeRange(apr15, apr17)
+ *   // → { start: apr15 00:00, end: apr18 00:00 }
+ */
+export function createAllDayTimeRange(startDate, endDate) {
+    return createTimeRange(startOfDay(startDate), addDays(startOfDay(endDate), 1));
+}
+/** Intersection of two ranges. Returns null if they don't overlap. */
+export function intersect(a, b) {
+    const start = Math.max(a.start.epochMs, b.start.epochMs);
+    const end = Math.min(a.end.epochMs, b.end.epochMs);
+    if (start >= end)
+        return null;
+    return {
+        start: { epochMs: start, timezone: a.start.timezone },
+        end: { epochMs: end, timezone: a.start.timezone },
+    };
+}
+/** Check if a range contains a point in time. */
+export function contains(range, dt) {
+    return dt.epochMs >= range.start.epochMs && dt.epochMs < range.end.epochMs;
+}
+/** Check if two ranges overlap (touching is not overlapping). */
+export function overlaps(a, b) {
+    return a.start.epochMs < b.end.epochMs && b.start.epochMs < a.end.epochMs;
+}
+/** Clip a range to fit within bounds. Returns null if no overlap. */
+export function clipTo(range, bounds) {
+    return intersect(range, bounds);
+}
+/** Shift a range to a new start, preserving duration. */
+export function shiftRange(range, newStart) {
+    const durationMs = range.end.epochMs - range.start.epochMs;
+    return createTimeRange(newStart, { epochMs: newStart.epochMs + durationMs, timezone: newStart.timezone });
+}
+//# sourceMappingURL=time-range.js.map

package/dist/time-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-range.js","sourceRoot":"","sources":["../src/time-range.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpD,kDAAkD;AAClD,MAAM,UAAU,eAAe,CAAC,KAAuB,EAAE,GAAqB;IAC5E,IAAI,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,uBAAuB,CAAC;YAChC,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,UAAU,KAAK,CAAC,OAAO,yBAAyB,GAAG,CAAC,OAAO,GAAG;SACxE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAA2B,EAC3B,OAAyB;IAEzB,OAAO,eAAe,CACpB,UAAU,CAAC,SAAS,CAAC,EACrB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,SAAS,CAAC,CAAY,EAAE,CAAY;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO;QACL,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE;QACrD,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE;KAClD,CAAC;AACJ,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,QAAQ,CAAC,KAAgB,EAAE,EAAoB;IAC7D,OAAO,EAAE,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;AAC7E,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,CAAY,EAAE,CAAY;IACjD,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;AAC5E,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,MAAM,CAAC,KAAgB,EAAE,MAAiB;IACxD,OAAO,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,QAA0B;IACrE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;IAC3D,OAAO,eAAe,CACpB,QAAQ,EACR,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CACxE,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Core — Temporal Type Definitions
+ *
+ * Domain-neutral time model: points in time, ranges, durations, grid
+ * resolution, formatting. All types are immutable (readonly properties).
+ * No framework dependencies. No DOM. No calendar-domain concepts.
+ */
+/** A point in time with timezone context. */
+export interface CalendarDateTime {
+    readonly epochMs: number;
+    readonly timezone: string;
+}
+/** A span between two points in time. Invariant: start < end. */
+export interface TimeRange {
+    readonly start: CalendarDateTime;
+    readonly end: CalendarDateTime;
+}
+/** A duration in milliseconds. */
+export interface Duration {
+    readonly ms: number;
+}
+/** Time grid resolution. */
+export interface Granularity {
+    readonly minutes: number;
+}
+/** A discrete slot in a time grid. */
+export interface TimeSlot {
+    readonly range: TimeRange;
+    readonly index: number;
+}
+/**
+ * Injectable time source. Used for "now" semantics and by event-sourced
+ * stores for event timestamps.
+ *
+ * Defined locally — structurally identical to `@bimetal/event-sourcing`'s
+ * `Clock`. TypeScript's structural typing keeps the two interchangeable
+ * without coupling `@bimetal/temporal` to the event-sourcing layer.
+ */
+export interface Clock {
+    now(): number;
+}
+/** Options for Intl-based formatting. */
+export interface FormatOptions {
+    readonly locale: string;
+    readonly dateStyle?: 'full' | 'long' | 'medium' | 'short';
+    readonly timeStyle?: 'full' | 'long' | 'medium' | 'short';
+}
+/** Snap rounding strategy. */
+export type SnapStrategy = 'floor' | 'ceil' | 'round';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;CAChC;AAED,kCAAkC;AAClC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAOD;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,MAAM,CAAC;CACf;AAID,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC3D;AAID,8BAA8B;AAC9B,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Core — Temporal Type Definitions
+ *
+ * Domain-neutral time model: points in time, ranges, durations, grid
+ * resolution, formatting. All types are immutable (readonly properties).
+ * No framework dependencies. No DOM. No calendar-domain concepts.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/vocabulary.d.ts

@@ -0,0 +1,40 @@
+declare const MonthBrand: unique symbol;
+/** Calendar month, 0-based (January = 0 … December = 11). House convention. */
+export type Month = number & {
+    readonly [MonthBrand]: 'Month';
+};
+export declare const Month: {
+    readonly January: Month;
+    readonly February: Month;
+    readonly March: Month;
+    readonly April: Month;
+    readonly May: Month;
+    readonly June: Month;
+    readonly July: Month;
+    readonly August: Month;
+    readonly September: Month;
+    readonly October: Month;
+    readonly November: Month;
+    readonly December: Month;
+};
+/** Brand a COMPUTED month value. Validates integer 0..11 (January=0 … December=11); throws otherwise. */
+export declare function monthIndex(n: number): Month;
+declare const WeekdayBrand: unique symbol;
+/** Day of week, 0-based Monday (Monday = 0 … Sunday = 6). A HOUSE convention — NOT ISO-8601 (1–7)
+ *  and NOT JS `Date.getDay()` (0 = Sunday). */
+export type Weekday = number & {
+    readonly [WeekdayBrand]: 'Weekday';
+};
+export declare const Weekday: {
+    readonly Monday: Weekday;
+    readonly Tuesday: Weekday;
+    readonly Wednesday: Weekday;
+    readonly Thursday: Weekday;
+    readonly Friday: Weekday;
+    readonly Saturday: Weekday;
+    readonly Sunday: Weekday;
+};
+/** Brand a COMPUTED weekday value. Validates integer 0..6 (Monday=0 … Sunday=6); throws otherwise. */
+export declare function weekdayIndex(n: number): Weekday;
+export {};
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"AAeA,OAAO,CAAC,MAAM,UAAU,EAAE,OAAO,MAAM,CAAC;AACxC,+EAA+E;AAC/E,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAChE,eAAO,MAAM,KAAK;sBACF,KAAK;uBAAiB,KAAK;oBAAc,KAAK;oBAAc,KAAK;kBACrE,KAAK;mBAAa,KAAK;mBAAa,KAAK;qBAAe,KAAK;wBACvD,KAAK;sBAAgB,KAAK;uBAAkB,KAAK;uBAAkB,KAAK;CAChF,CAAC;AAEX,yGAAyG;AACzG,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAK3C;AAED,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAC1C;+CAC+C;AAC/C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AACtE,eAAO,MAAM,OAAO;qBACL,OAAO;sBAAgB,OAAO;wBAAkB,OAAO;uBAAiB,OAAO;qBAC/E,OAAO;uBAAiB,OAAO;qBAAe,OAAO;CAC1D,CAAC;AAEX,sGAAsG;AACtG,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAK/C"}

package/dist/vocabulary.js

@@ -0,0 +1,38 @@
+/**
+ * Branded calendar vocabulary — `Month` and `Weekday`.
+ *
+ * WHY BRANDED (freeze rule, V1_PUBLIC_CONTRACT): a numeric parameter gets a branded vocabulary
+ * exactly when several LIVE conventions compete for the same number. `month` (0- vs 1-based) and
+ * `weekday` (0=Mon vs 0=Sun vs ISO 1–7) both qualify; `day` (always 1-based) and `hour`/`minute`
+ * (clock convention) do NOT. The brand makes a naked number a COMPILE error where a Month/Weekday is
+ * expected — a numeric enum/union would silently accept in-range literals and NOT close the trap.
+ *
+ * The internal representation is UNCHANGED (Month 0-based, Weekday 0=Monday) — this is a vocabulary,
+ * not a semantic flip. Use `Month.January`…`Month.December` / `Weekday.Monday`…`Weekday.Sunday` for
+ * literals, or `monthIndex(n)` / `weekdayIndex(n)` for COMPUTED values (they validate + brand).
+ */
+import { CalendarValidationError } from './errors.js';
+export const Month = {
+    January: 0, February: 1, March: 2, April: 3,
+    May: 4, June: 5, July: 6, August: 7,
+    September: 8, October: 9, November: 10, December: 11,
+};
+/** Brand a COMPUTED month value. Validates integer 0..11 (January=0 … December=11); throws otherwise. */
+export function monthIndex(n) {
+    if (!Number.isInteger(n) || n < 0 || n > 11) {
+        throw new CalendarValidationError({ type: 'INVALID_EVENT', field: 'month', message: `month must be an integer 0-11 (January=0 … December=11), got ${n}` });
+    }
+    return n;
+}
+export const Weekday = {
+    Monday: 0, Tuesday: 1, Wednesday: 2, Thursday: 3,
+    Friday: 4, Saturday: 5, Sunday: 6,
+};
+/** Brand a COMPUTED weekday value. Validates integer 0..6 (Monday=0 … Sunday=6); throws otherwise. */
+export function weekdayIndex(n) {
+    if (!Number.isInteger(n) || n < 0 || n > 6) {
+        throw new CalendarValidationError({ type: 'INVALID_EVENT', field: 'weekday', message: `weekday must be an integer 0-6 (Monday=0 … Sunday=6), got ${n}` });
+    }
+    return n;
+}
+//# sourceMappingURL=vocabulary.js.map

package/dist/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAKtD,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,CAAU,EAAE,QAAQ,EAAE,CAAU,EAAE,KAAK,EAAE,CAAU,EAAE,KAAK,EAAE,CAAU;IAC/E,GAAG,EAAE,CAAU,EAAE,IAAI,EAAE,CAAU,EAAE,IAAI,EAAE,CAAU,EAAE,MAAM,EAAE,CAAU;IACvE,SAAS,EAAE,CAAU,EAAE,OAAO,EAAE,CAAU,EAAE,QAAQ,EAAE,EAAW,EAAE,QAAQ,EAAE,EAAW;CAChF,CAAC;AAEX,yGAAyG;AACzG,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,uBAAuB,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gEAAgE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7J,CAAC;IACD,OAAO,CAAU,CAAC;AACpB,CAAC;AAMD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE,CAAY,EAAE,OAAO,EAAE,CAAY,EAAE,SAAS,EAAE,CAAY,EAAE,QAAQ,EAAE,CAAY;IAC5F,MAAM,EAAE,CAAY,EAAE,QAAQ,EAAE,CAAY,EAAE,MAAM,EAAE,CAAY;CAC1D,CAAC;AAEX,sGAAsG;AACtG,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,uBAAuB,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,6DAA6D,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5J,CAAC;IACD,OAAO,CAAY,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@bimetal/temporal",
+  "version": "0.35.0",
+  "description": "Domain-neutral temporal kernel: time model, durations, grid resolution, formatting. Shared across all BIMETAL component families.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.1"
+  },
+  "sideEffects": false,
+  "license": "Apache-2.0",
+  "author": "Andreas Biederbeck",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bimetal/bimetal.git",
+    "directory": "packages/engine/temporal"
+  },
+  "keywords": [
+    "datetime",
+    "timezone",
+    "duration",
+    "temporal",
+    "headless"
+  ]
+}