@vielzeug/refine 1.1.1

package/dist/headless/date-picker.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-picker.cjs","names":[],"sources":["../../src/headless/date-picker.ts"],"sourcesContent":["import { Temporal, format, parsePlainDate } from '@vielzeug/tempo';\n\n// ── Public ISO helpers (single source of truth for both components) ───────────\n\n/**\n * Parses an ISO 8601 date string (`yyyy-MM-dd`) into a `Temporal.PlainDate`.\n * Returns `null` for any invalid / empty input — never throws.\n */\nexport function parseIso(iso: string | undefined | null): Temporal.PlainDate | null {\n  if (!iso) return null;\n\n  try {\n    return parsePlainDate(iso);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Serialises a `Temporal.PlainDate` (or `null`) to an ISO 8601 string (`yyyy-MM-dd`).\n * Returns `null` when the input is `null`.\n */\nexport function toIsoString(date: Temporal.PlainDate | null): string | null {\n  return date ? date.toString() : null;\n}\n\n/**\n * Formats a `Temporal.PlainDate` for display in a given locale.\n * e.g. \"15 Jun 2025\" (default medium pattern).\n */\nexport function formatDisplayDate(date: Temporal.PlainDate, locale: string): string {\n  return format(date, { intl: { day: 'numeric', month: 'short', year: 'numeric' }, locale, tz: 'UTC' });\n}\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type DatePickerView = 'day' | 'month' | 'year';\n\nexport type DateCell = {\n  /** Day-of-month number (1–31) */\n  day: number;\n  isDisabled: boolean;\n  /** ISO date string yyyy-MM-dd — stable key for rendering */\n  iso: string;\n  isOutsideMonth: boolean;\n  isSelected: boolean;\n  isToday: boolean;\n  plain: Temporal.PlainDate;\n};\n\nexport type MonthCell = {\n  isDisabled: boolean;\n  isSelected: boolean;\n  label: string;\n  /** 1-based month number (Temporal convention: 1 = January … 12 = December) */\n  month: number;\n  shortLabel: string;\n};\n\nexport type YearCell = {\n  isDisabled: boolean;\n  isSelected: boolean;\n  year: number;\n};\n\nexport type DatePickerControlOptions = {\n  /** Locale for day/month names, defaults to `navigator.language` or `'en'` */\n  locale?: string;\n  /** Maximum selectable date (inclusive) */\n  max?: Temporal.PlainDate | null;\n  /** Minimum selectable date (inclusive) */\n  min?: Temporal.PlainDate | null;\n  /** Called when a date is committed by the user */\n  onChange: (date: Temporal.PlainDate | null) => void;\n  /** Currently selected date */\n  value?: Temporal.PlainDate | null;\n  /**\n   * Which days of the week to disable (0 = Sunday … 6 = Saturday).\n   * @example [0, 6] disables weekends\n   */\n  weekendDays?: number[];\n};\n\nexport type DatePickerControl = {\n  /** Ordered day cells for the visible month grid (includes leading/trailing days) */\n  dayCells(): DateCell[];\n  /** Month currently shown in the header (1-indexed, Temporal convention) */\n  displayMonth(): number;\n  /** Year currently shown in the header */\n  displayYear(): number;\n  /** Jump to a specific display month/year without selecting */\n  goTo(year: number, month: number): void;\n  /** All 12 month cells */\n  monthCells(): MonthCell[];\n  /** Move display month forward by one */\n  nextMonth(): void;\n  /** Move display year forward by one */\n  nextYear(): void;\n  /** Move display month backward by one */\n  prevMonth(): void;\n  /** Move display year backward by one */\n  prevYear(): void;\n  /** Select a date. Pass null to clear. */\n  select(date: Temporal.PlainDate | null): void;\n  /** The currently selected date, or null */\n  selected(): Temporal.PlainDate | null;\n  /** Switch the calendar view */\n  setView(view: DatePickerView): void;\n  /** Currently rendered calendar view */\n  view(): DatePickerView;\n  /** Short week-day labels in locale order e.g. [\"Su\",\"Mo\",…] */\n  weekdayLabels(): string[];\n  /** Year cells for the visible decade window */\n  yearCells(): YearCell[];\n};\n\n// ── Internal helpers ──────────────────────────────────────────────────────────\n\n/**\n * Returns today as a `Temporal.PlainDate` in the ISO calendar.\n * @internal\n */\nfunction todayPlain(): Temporal.PlainDate {\n  return Temporal.Now.plainDateISO();\n}\n\n/**\n * Converts a `Temporal.PlainDate.dayOfWeek` value (1=Mon…7=Sun) to the\n * 0-based weekday index (0=Sun…6=Sat) used in the `weekendDays` prop.\n * @internal\n */\nfunction temporalDowToIndex(dow: number): number {\n  // Temporal: 1=Mon, 2=Tue, …, 7=Sun  →  0=Sun, 1=Mon, …, 6=Sat\n  return dow % 7;\n}\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Pure, framework-agnostic date-picker state machine backed by `Temporal.PlainDate`.\n *\n * All state is held in plain mutable variables — suitable for wrapping in any\n * reactive layer (ore `signal`, Vue ref, etc.). The factory returns a stable\n * handle object; callers are responsible for reactivity.\n *\n * Options with getter-based live bindings (e.g. `get min() { ... }`) are read\n * on every call so the control always reflects the latest reactive state.\n *\n * @example\n * ```ts\n * const ctrl = createDatePickerControl({\n *   value: Temporal.PlainDate.from('2025-06-15'),\n *   locale: 'en-US',\n *   onChange: (date) => console.log(date?.toString()),\n * });\n *\n * ctrl.nextMonth();\n * ctrl.select(Temporal.PlainDate.from('2025-07-04'));\n * ```\n */\nexport function createDatePickerControl(options: DatePickerControlOptions): DatePickerControl {\n  // ── Mutable state ─────────────────────────────────────────────────────────\n\n  let _selected: Temporal.PlainDate | null = options.value ?? null;\n  let _view: DatePickerView = 'day';\n\n  const initial = _selected ?? todayPlain();\n\n  let _displayYear = initial.year;\n  let _displayMonth = initial.month; // 1-indexed (Temporal convention)\n\n  // ── Live option accessors (always read from options for reactive compat) ───\n\n  function locale(): string {\n    return options.locale ?? (typeof navigator !== 'undefined' ? navigator.language : 'en');\n  }\n\n  function weekendDays(): number[] {\n    return options.weekendDays ?? [];\n  }\n\n  // ── Range / disabled helpers ───────────────────────────────────────────────\n\n  function isOutOfRange(date: Temporal.PlainDate): boolean {\n    if (options.min && Temporal.PlainDate.compare(date, options.min) < 0) return true;\n\n    if (options.max && Temporal.PlainDate.compare(date, options.max) > 0) return true;\n\n    return false;\n  }\n\n  function isDayDisabled(date: Temporal.PlainDate): boolean {\n    if (isOutOfRange(date)) return true;\n\n    if (weekendDays().includes(temporalDowToIndex(date.dayOfWeek))) return true;\n\n    return false;\n  }\n\n  // ── Grid builders ─────────────────────────────────────────────────────────\n\n  function buildDayCells(): DateCell[] {\n    const todayDate = todayPlain();\n    const firstOfMonth = Temporal.PlainDate.from({ day: 1, month: _displayMonth, year: _displayYear });\n\n    // Sunday-start grid: Temporal dayOfWeek is 1=Mon…7=Sun, convert to 0=Sun offset\n    const startOffset = temporalDowToIndex(firstOfMonth.dayOfWeek);\n    const cells: DateCell[] = [];\n\n    // Leading days from previous month\n    for (let i = startOffset - 1; i >= 0; i--) {\n      const d = firstOfMonth.subtract({ days: i + 1 });\n\n      cells.push({\n        day: d.day,\n        isDisabled: isDayDisabled(d),\n        iso: d.toString(),\n        isOutsideMonth: true,\n        isSelected: _selected !== null && Temporal.PlainDate.compare(d, _selected) === 0,\n        isToday: Temporal.PlainDate.compare(d, todayDate) === 0,\n        plain: d,\n      });\n    }\n\n    // Days in current month\n    const daysInMonth = firstOfMonth.daysInMonth;\n\n    for (let day = 1; day <= daysInMonth; day++) {\n      const d = Temporal.PlainDate.from({ day, month: _displayMonth, year: _displayYear });\n\n      cells.push({\n        day,\n        isDisabled: isDayDisabled(d),\n        iso: d.toString(),\n        isOutsideMonth: false,\n        isSelected: _selected !== null && Temporal.PlainDate.compare(d, _selected) === 0,\n        isToday: Temporal.PlainDate.compare(d, todayDate) === 0,\n        plain: d,\n      });\n    }\n\n    // Trailing days to fill last row (always end at multiple of 7)\n    const remaining = (7 - (cells.length % 7)) % 7;\n    const firstOfNext = firstOfMonth.add({ months: 1 });\n\n    for (let i = 0; i < remaining; i++) {\n      const d = firstOfNext.add({ days: i });\n\n      cells.push({\n        day: d.day,\n        isDisabled: isDayDisabled(d),\n        iso: d.toString(),\n        isOutsideMonth: true,\n        isSelected: _selected !== null && Temporal.PlainDate.compare(d, _selected) === 0,\n        isToday: Temporal.PlainDate.compare(d, todayDate) === 0,\n        plain: d,\n      });\n    }\n\n    return cells;\n  }\n\n  function buildMonthCells(): MonthCell[] {\n    const cells: MonthCell[] = [];\n    const loc = locale();\n\n    for (let m = 1; m <= 12; m++) {\n      const plain = Temporal.PlainDate.from({ day: 1, month: m, year: _displayYear });\n      const lastOfMonth = plain.with({ day: plain.daysInMonth });\n\n      const isDisabled =\n        (options.min !== null && options.min !== undefined\n          ? Temporal.PlainDate.compare(lastOfMonth, options.min) < 0\n          : false) ||\n        (options.max !== null && options.max !== undefined\n          ? Temporal.PlainDate.compare(plain, options.max) > 0\n          : false);\n\n      cells.push({\n        isDisabled,\n        isSelected: _selected !== null && _selected.year === _displayYear && _selected.month === m,\n        label: format(plain, { intl: { month: 'long' }, locale: loc, tz: 'UTC' }),\n        month: m,\n        shortLabel: format(plain, { intl: { month: 'short' }, locale: loc, tz: 'UTC' }),\n      });\n    }\n\n    return cells;\n  }\n\n  function buildYearCells(): YearCell[] {\n    const decadeStart = Math.floor(_displayYear / 10) * 10;\n    const cells: YearCell[] = [];\n\n    for (let y = decadeStart; y < decadeStart + 12; y++) {\n      const firstOfYear = Temporal.PlainDate.from({ day: 1, month: 1, year: y });\n      const lastOfYear = Temporal.PlainDate.from({ day: 31, month: 12, year: y });\n\n      const isDisabled =\n        (options.min !== null && options.min !== undefined\n          ? Temporal.PlainDate.compare(lastOfYear, options.min) < 0\n          : false) ||\n        (options.max !== null && options.max !== undefined\n          ? Temporal.PlainDate.compare(firstOfYear, options.max) > 0\n          : false);\n\n      cells.push({\n        isDisabled,\n        isSelected: _selected !== null && _selected.year === y,\n        year: y,\n      });\n    }\n\n    return cells;\n  }\n\n  function buildWeekdayLabels(): string[] {\n    // 2024-01-07 is a Sunday — use it as the Sunday anchor\n    const sunday = parsePlainDate('2024-01-07');\n    const loc = locale();\n\n    return Array.from({ length: 7 }, (_, i) =>\n      format(sunday.add({ days: i }), { intl: { weekday: 'short' }, locale: loc, tz: 'UTC' }),\n    );\n  }\n\n  // ── Handle ────────────────────────────────────────────────────────────────\n\n  return {\n    dayCells: buildDayCells,\n    displayMonth: () => _displayMonth,\n    displayYear: () => _displayYear,\n\n    goTo(year: number, month: number): void {\n      if (!Number.isFinite(year)) return;\n\n      _displayYear = year;\n      _displayMonth = Math.max(1, Math.min(12, month));\n    },\n\n    monthCells: buildMonthCells,\n\n    nextMonth(): void {\n      if (_displayMonth === 12) {\n        _displayMonth = 1;\n        _displayYear++;\n      } else {\n        _displayMonth++;\n      }\n    },\n\n    nextYear(): void {\n      _displayYear++;\n    },\n\n    prevMonth(): void {\n      if (_displayMonth === 1) {\n        _displayMonth = 12;\n        _displayYear--;\n      } else {\n        _displayMonth--;\n      }\n    },\n\n    prevYear(): void {\n      _displayYear--;\n    },\n\n    select(date: Temporal.PlainDate | null): void {\n      if (date !== null && isDayDisabled(date)) return;\n\n      _selected = date;\n\n      if (_selected) {\n        _displayYear = _selected.year;\n        _displayMonth = _selected.month;\n      }\n\n      options.onChange(_selected);\n    },\n\n    selected: () => _selected,\n\n    setView(view: DatePickerView): void {\n      _view = view;\n    },\n\n    view: () => _view,\n\n    weekdayLabels: buildWeekdayLabels,\n\n    yearCells: buildYearCells,\n  };\n}\n"],"mappings":"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"}

package/dist/headless/date-picker.d.ts

@@ -0,0 +1,114 @@
+import { Temporal } from '@vielzeug/tempo';
+/**
+ * Parses an ISO 8601 date string (`yyyy-MM-dd`) into a `Temporal.PlainDate`.
+ * Returns `null` for any invalid / empty input — never throws.
+ */
+export declare function parseIso(iso: string | undefined | null): Temporal.PlainDate | null;
+/**
+ * Serialises a `Temporal.PlainDate` (or `null`) to an ISO 8601 string (`yyyy-MM-dd`).
+ * Returns `null` when the input is `null`.
+ */
+export declare function toIsoString(date: Temporal.PlainDate | null): string | null;
+/**
+ * Formats a `Temporal.PlainDate` for display in a given locale.
+ * e.g. "15 Jun 2025" (default medium pattern).
+ */
+export declare function formatDisplayDate(date: Temporal.PlainDate, locale: string): string;
+export type DatePickerView = 'day' | 'month' | 'year';
+export type DateCell = {
+    /** Day-of-month number (1–31) */
+    day: number;
+    isDisabled: boolean;
+    /** ISO date string yyyy-MM-dd — stable key for rendering */
+    iso: string;
+    isOutsideMonth: boolean;
+    isSelected: boolean;
+    isToday: boolean;
+    plain: Temporal.PlainDate;
+};
+export type MonthCell = {
+    isDisabled: boolean;
+    isSelected: boolean;
+    label: string;
+    /** 1-based month number (Temporal convention: 1 = January … 12 = December) */
+    month: number;
+    shortLabel: string;
+};
+export type YearCell = {
+    isDisabled: boolean;
+    isSelected: boolean;
+    year: number;
+};
+export type DatePickerControlOptions = {
+    /** Locale for day/month names, defaults to `navigator.language` or `'en'` */
+    locale?: string;
+    /** Maximum selectable date (inclusive) */
+    max?: Temporal.PlainDate | null;
+    /** Minimum selectable date (inclusive) */
+    min?: Temporal.PlainDate | null;
+    /** Called when a date is committed by the user */
+    onChange: (date: Temporal.PlainDate | null) => void;
+    /** Currently selected date */
+    value?: Temporal.PlainDate | null;
+    /**
+     * Which days of the week to disable (0 = Sunday … 6 = Saturday).
+     * @example [0, 6] disables weekends
+     */
+    weekendDays?: number[];
+};
+export type DatePickerControl = {
+    /** Ordered day cells for the visible month grid (includes leading/trailing days) */
+    dayCells(): DateCell[];
+    /** Month currently shown in the header (1-indexed, Temporal convention) */
+    displayMonth(): number;
+    /** Year currently shown in the header */
+    displayYear(): number;
+    /** Jump to a specific display month/year without selecting */
+    goTo(year: number, month: number): void;
+    /** All 12 month cells */
+    monthCells(): MonthCell[];
+    /** Move display month forward by one */
+    nextMonth(): void;
+    /** Move display year forward by one */
+    nextYear(): void;
+    /** Move display month backward by one */
+    prevMonth(): void;
+    /** Move display year backward by one */
+    prevYear(): void;
+    /** Select a date. Pass null to clear. */
+    select(date: Temporal.PlainDate | null): void;
+    /** The currently selected date, or null */
+    selected(): Temporal.PlainDate | null;
+    /** Switch the calendar view */
+    setView(view: DatePickerView): void;
+    /** Currently rendered calendar view */
+    view(): DatePickerView;
+    /** Short week-day labels in locale order e.g. ["Su","Mo",…] */
+    weekdayLabels(): string[];
+    /** Year cells for the visible decade window */
+    yearCells(): YearCell[];
+};
+/**
+ * Pure, framework-agnostic date-picker state machine backed by `Temporal.PlainDate`.
+ *
+ * All state is held in plain mutable variables — suitable for wrapping in any
+ * reactive layer (ore `signal`, Vue ref, etc.). The factory returns a stable
+ * handle object; callers are responsible for reactivity.
+ *
+ * Options with getter-based live bindings (e.g. `get min() { ... }`) are read
+ * on every call so the control always reflects the latest reactive state.
+ *
+ * @example
+ * ```ts
+ * const ctrl = createDatePickerControl({
+ *   value: Temporal.PlainDate.from('2025-06-15'),
+ *   locale: 'en-US',
+ *   onChange: (date) => console.log(date?.toString()),
+ * });
+ *
+ * ctrl.nextMonth();
+ * ctrl.select(Temporal.PlainDate.from('2025-07-04'));
+ * ```
+ */
+export declare function createDatePickerControl(options: DatePickerControlOptions): DatePickerControl;
+//# sourceMappingURL=date-picker.d.ts.map

package/dist/headless/date-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-picker.d.ts","sourceRoot":"","sources":["../../src/headless/date-picker.ts"],"names":[],"mappings":"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"}

package/dist/headless/date-picker.js

@@ -0,0 +1,184 @@
+import { Temporal as e, format as t, parsePlainDate as n } from "@vielzeug/tempo";
+//#region src/headless/date-picker.ts
+function r(e) {
+	if (!e) return null;
+	try {
+		return n(e);
+	} catch {
+		return null;
+	}
+}
+function i(e) {
+	return e ? e.toString() : null;
+}
+function a(e, n) {
+	return t(e, {
+		intl: {
+			day: "numeric",
+			month: "short",
+			year: "numeric"
+		},
+		locale: n,
+		tz: "UTC"
+	});
+}
+function o() {
+	return e.Now.plainDateISO();
+}
+function s(e) {
+	return e % 7;
+}
+function c(r) {
+	let i = r.value ?? null, a = "day", c = i ?? o(), l = c.year, u = c.month;
+	function d() {
+		return r.locale ?? (typeof navigator < "u" ? navigator.language : "en");
+	}
+	function f() {
+		return r.weekendDays ?? [];
+	}
+	function p(t) {
+		return !!(r.min && e.PlainDate.compare(t, r.min) < 0 || r.max && e.PlainDate.compare(t, r.max) > 0);
+	}
+	function m(e) {
+		return !!(p(e) || f().includes(s(e.dayOfWeek)));
+	}
+	function h() {
+		let t = o(), n = e.PlainDate.from({
+			day: 1,
+			month: u,
+			year: l
+		}), r = s(n.dayOfWeek), a = [];
+		for (let o = r - 1; o >= 0; o--) {
+			let r = n.subtract({ days: o + 1 });
+			a.push({
+				day: r.day,
+				isDisabled: m(r),
+				iso: r.toString(),
+				isOutsideMonth: !0,
+				isSelected: i !== null && e.PlainDate.compare(r, i) === 0,
+				isToday: e.PlainDate.compare(r, t) === 0,
+				plain: r
+			});
+		}
+		let c = n.daysInMonth;
+		for (let n = 1; n <= c; n++) {
+			let r = e.PlainDate.from({
+				day: n,
+				month: u,
+				year: l
+			});
+			a.push({
+				day: n,
+				isDisabled: m(r),
+				iso: r.toString(),
+				isOutsideMonth: !1,
+				isSelected: i !== null && e.PlainDate.compare(r, i) === 0,
+				isToday: e.PlainDate.compare(r, t) === 0,
+				plain: r
+			});
+		}
+		let d = (7 - a.length % 7) % 7, f = n.add({ months: 1 });
+		for (let n = 0; n < d; n++) {
+			let r = f.add({ days: n });
+			a.push({
+				day: r.day,
+				isDisabled: m(r),
+				iso: r.toString(),
+				isOutsideMonth: !0,
+				isSelected: i !== null && e.PlainDate.compare(r, i) === 0,
+				isToday: e.PlainDate.compare(r, t) === 0,
+				plain: r
+			});
+		}
+		return a;
+	}
+	function g() {
+		let n = [], a = d();
+		for (let o = 1; o <= 12; o++) {
+			let s = e.PlainDate.from({
+				day: 1,
+				month: o,
+				year: l
+			}), c = s.with({ day: s.daysInMonth }), u = (r.min !== null && r.min !== void 0 ? e.PlainDate.compare(c, r.min) < 0 : !1) || (r.max !== null && r.max !== void 0 ? e.PlainDate.compare(s, r.max) > 0 : !1);
+			n.push({
+				isDisabled: u,
+				isSelected: i !== null && i.year === l && i.month === o,
+				label: t(s, {
+					intl: { month: "long" },
+					locale: a,
+					tz: "UTC"
+				}),
+				month: o,
+				shortLabel: t(s, {
+					intl: { month: "short" },
+					locale: a,
+					tz: "UTC"
+				})
+			});
+		}
+		return n;
+	}
+	function _() {
+		let t = Math.floor(l / 10) * 10, n = [];
+		for (let a = t; a < t + 12; a++) {
+			let t = e.PlainDate.from({
+				day: 1,
+				month: 1,
+				year: a
+			}), o = e.PlainDate.from({
+				day: 31,
+				month: 12,
+				year: a
+			}), s = (r.min !== null && r.min !== void 0 ? e.PlainDate.compare(o, r.min) < 0 : !1) || (r.max !== null && r.max !== void 0 ? e.PlainDate.compare(t, r.max) > 0 : !1);
+			n.push({
+				isDisabled: s,
+				isSelected: i !== null && i.year === a,
+				year: a
+			});
+		}
+		return n;
+	}
+	function v() {
+		let e = n("2024-01-07"), r = d();
+		return Array.from({ length: 7 }, (n, i) => t(e.add({ days: i }), {
+			intl: { weekday: "short" },
+			locale: r,
+			tz: "UTC"
+		}));
+	}
+	return {
+		dayCells: h,
+		displayMonth: () => u,
+		displayYear: () => l,
+		goTo(e, t) {
+			Number.isFinite(e) && (l = e, u = Math.max(1, Math.min(12, t)));
+		},
+		monthCells: g,
+		nextMonth() {
+			u === 12 ? (u = 1, l++) : u++;
+		},
+		nextYear() {
+			l++;
+		},
+		prevMonth() {
+			u === 1 ? (u = 12, l--) : u--;
+		},
+		prevYear() {
+			l--;
+		},
+		select(e) {
+			e !== null && m(e) || (i = e, i && (l = i.year, u = i.month), r.onChange(i));
+		},
+		selected: () => i,
+		setView(e) {
+			a = e;
+		},
+		view: () => a,
+		weekdayLabels: v,
+		yearCells: _
+	};
+}
+//#endregion
+export { c as createDatePickerControl, a as formatDisplayDate, r as parseIso, i as toIsoString };
+
+//# sourceMappingURL=date-picker.js.map

package/dist/headless/date-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-picker.js","names":[],"sources":["../../src/headless/date-picker.ts"],"sourcesContent":["import { Temporal, format, parsePlainDate } from '@vielzeug/tempo';\n\n// ── Public ISO helpers (single source of truth for both components) ───────────\n\n/**\n * Parses an ISO 8601 date string (`yyyy-MM-dd`) into a `Temporal.PlainDate`.\n * Returns `null` for any invalid / empty input — never throws.\n */\nexport function parseIso(iso: string | undefined | null): Temporal.PlainDate | null {\n  if (!iso) return null;\n\n  try {\n    return parsePlainDate(iso);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Serialises a `Temporal.PlainDate` (or `null`) to an ISO 8601 string (`yyyy-MM-dd`).\n * Returns `null` when the input is `null`.\n */\nexport function toIsoString(date: Temporal.PlainDate | null): string | null {\n  return date ? date.toString() : null;\n}\n\n/**\n * Formats a `Temporal.PlainDate` for display in a given locale.\n * e.g. \"15 Jun 2025\" (default medium pattern).\n */\nexport function formatDisplayDate(date: Temporal.PlainDate, locale: string): string {\n  return format(date, { intl: { day: 'numeric', month: 'short', year: 'numeric' }, locale, tz: 'UTC' });\n}\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type DatePickerView = 'day' | 'month' | 'year';\n\nexport type DateCell = {\n  /** Day-of-month number (1–31) */\n  day: number;\n  isDisabled: boolean;\n  /** ISO date string yyyy-MM-dd — stable key for rendering */\n  iso: string;\n  isOutsideMonth: boolean;\n  isSelected: boolean;\n  isToday: boolean;\n  plain: Temporal.PlainDate;\n};\n\nexport type MonthCell = {\n  isDisabled: boolean;\n  isSelected: boolean;\n  label: string;\n  /** 1-based month number (Temporal convention: 1 = January … 12 = December) */\n  month: number;\n  shortLabel: string;\n};\n\nexport type YearCell = {\n  isDisabled: boolean;\n  isSelected: boolean;\n  year: number;\n};\n\nexport type DatePickerControlOptions = {\n  /** Locale for day/month names, defaults to `navigator.language` or `'en'` */\n  locale?: string;\n  /** Maximum selectable date (inclusive) */\n  max?: Temporal.PlainDate | null;\n  /** Minimum selectable date (inclusive) */\n  min?: Temporal.PlainDate | null;\n  /** Called when a date is committed by the user */\n  onChange: (date: Temporal.PlainDate | null) => void;\n  /** Currently selected date */\n  value?: Temporal.PlainDate | null;\n  /**\n   * Which days of the week to disable (0 = Sunday … 6 = Saturday).\n   * @example [0, 6] disables weekends\n   */\n  weekendDays?: number[];\n};\n\nexport type DatePickerControl = {\n  /** Ordered day cells for the visible month grid (includes leading/trailing days) */\n  dayCells(): DateCell[];\n  /** Month currently shown in the header (1-indexed, Temporal convention) */\n  displayMonth(): number;\n  /** Year currently shown in the header */\n  displayYear(): number;\n  /** Jump to a specific display month/year without selecting */\n  goTo(year: number, month: number): void;\n  /** All 12 month cells */\n  monthCells(): MonthCell[];\n  /** Move display month forward by one */\n  nextMonth(): void;\n  /** Move display year forward by one */\n  nextYear(): void;\n  /** Move display month backward by one */\n  prevMonth(): void;\n  /** Move display year backward by one */\n  prevYear(): void;\n  /** Select a date. Pass null to clear. */\n  select(date: Temporal.PlainDate | null): void;\n  /** The currently selected date, or null */\n  selected(): Temporal.PlainDate | null;\n  /** Switch the calendar view */\n  setView(view: DatePickerView): void;\n  /** Currently rendered calendar view */\n  view(): DatePickerView;\n  /** Short week-day labels in locale order e.g. [\"Su\",\"Mo\",…] */\n  weekdayLabels(): string[];\n  /** Year cells for the visible decade window */\n  yearCells(): YearCell[];\n};\n\n// ── Internal helpers ──────────────────────────────────────────────────────────\n\n/**\n * Returns today as a `Temporal.PlainDate` in the ISO calendar.\n * @internal\n */\nfunction todayPlain(): Temporal.PlainDate {\n  return Temporal.Now.plainDateISO();\n}\n\n/**\n * Converts a `Temporal.PlainDate.dayOfWeek` value (1=Mon…7=Sun) to the\n * 0-based weekday index (0=Sun…6=Sat) used in the `weekendDays` prop.\n * @internal\n */\nfunction temporalDowToIndex(dow: number): number {\n  // Temporal: 1=Mon, 2=Tue, …, 7=Sun  →  0=Sun, 1=Mon, …, 6=Sat\n  return dow % 7;\n}\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Pure, framework-agnostic date-picker state machine backed by `Temporal.PlainDate`.\n *\n * All state is held in plain mutable variables — suitable for wrapping in any\n * reactive layer (ore `signal`, Vue ref, etc.). The factory returns a stable\n * handle object; callers are responsible for reactivity.\n *\n * Options with getter-based live bindings (e.g. `get min() { ... }`) are read\n * on every call so the control always reflects the latest reactive state.\n *\n * @example\n * ```ts\n * const ctrl = createDatePickerControl({\n *   value: Temporal.PlainDate.from('2025-06-15'),\n *   locale: 'en-US',\n *   onChange: (date) => console.log(date?.toString()),\n * });\n *\n * ctrl.nextMonth();\n * ctrl.select(Temporal.PlainDate.from('2025-07-04'));\n * ```\n */\nexport function createDatePickerControl(options: DatePickerControlOptions): DatePickerControl {\n  // ── Mutable state ─────────────────────────────────────────────────────────\n\n  let _selected: Temporal.PlainDate | null = options.value ?? null;\n  let _view: DatePickerView = 'day';\n\n  const initial = _selected ?? todayPlain();\n\n  let _displayYear = initial.year;\n  let _displayMonth = initial.month; // 1-indexed (Temporal convention)\n\n  // ── Live option accessors (always read from options for reactive compat) ───\n\n  function locale(): string {\n    return options.locale ?? (typeof navigator !== 'undefined' ? navigator.language : 'en');\n  }\n\n  function weekendDays(): number[] {\n    return options.weekendDays ?? [];\n  }\n\n  // ── Range / disabled helpers ───────────────────────────────────────────────\n\n  function isOutOfRange(date: Temporal.PlainDate): boolean {\n    if (options.min && Temporal.PlainDate.compare(date, options.min) < 0) return true;\n\n    if (options.max && Temporal.PlainDate.compare(date, options.max) > 0) return true;\n\n    return false;\n  }\n\n  function isDayDisabled(date: Temporal.PlainDate): boolean {\n    if (isOutOfRange(date)) return true;\n\n    if (weekendDays().includes(temporalDowToIndex(date.dayOfWeek))) return true;\n\n    return false;\n  }\n\n  // ── Grid builders ─────────────────────────────────────────────────────────\n\n  function buildDayCells(): DateCell[] {\n    const todayDate = todayPlain();\n    const firstOfMonth = Temporal.PlainDate.from({ day: 1, month: _displayMonth, year: _displayYear });\n\n    // Sunday-start grid: Temporal dayOfWeek is 1=Mon…7=Sun, convert to 0=Sun offset\n    const startOffset = temporalDowToIndex(firstOfMonth.dayOfWeek);\n    const cells: DateCell[] = [];\n\n    // Leading days from previous month\n    for (let i = startOffset - 1; i >= 0; i--) {\n      const d = firstOfMonth.subtract({ days: i + 1 });\n\n      cells.push({\n        day: d.day,\n        isDisabled: isDayDisabled(d),\n        iso: d.toString(),\n        isOutsideMonth: true,\n        isSelected: _selected !== null && Temporal.PlainDate.compare(d, _selected) === 0,\n        isToday: Temporal.PlainDate.compare(d, todayDate) === 0,\n        plain: d,\n      });\n    }\n\n    // Days in current month\n    const daysInMonth = firstOfMonth.daysInMonth;\n\n    for (let day = 1; day <= daysInMonth; day++) {\n      const d = Temporal.PlainDate.from({ day, month: _displayMonth, year: _displayYear });\n\n      cells.push({\n        day,\n        isDisabled: isDayDisabled(d),\n        iso: d.toString(),\n        isOutsideMonth: false,\n        isSelected: _selected !== null && Temporal.PlainDate.compare(d, _selected) === 0,\n        isToday: Temporal.PlainDate.compare(d, todayDate) === 0,\n        plain: d,\n      });\n    }\n\n    // Trailing days to fill last row (always end at multiple of 7)\n    const remaining = (7 - (cells.length % 7)) % 7;\n    const firstOfNext = firstOfMonth.add({ months: 1 });\n\n    for (let i = 0; i < remaining; i++) {\n      const d = firstOfNext.add({ days: i });\n\n      cells.push({\n        day: d.day,\n        isDisabled: isDayDisabled(d),\n        iso: d.toString(),\n        isOutsideMonth: true,\n        isSelected: _selected !== null && Temporal.PlainDate.compare(d, _selected) === 0,\n        isToday: Temporal.PlainDate.compare(d, todayDate) === 0,\n        plain: d,\n      });\n    }\n\n    return cells;\n  }\n\n  function buildMonthCells(): MonthCell[] {\n    const cells: MonthCell[] = [];\n    const loc = locale();\n\n    for (let m = 1; m <= 12; m++) {\n      const plain = Temporal.PlainDate.from({ day: 1, month: m, year: _displayYear });\n      const lastOfMonth = plain.with({ day: plain.daysInMonth });\n\n      const isDisabled =\n        (options.min !== null && options.min !== undefined\n          ? Temporal.PlainDate.compare(lastOfMonth, options.min) < 0\n          : false) ||\n        (options.max !== null && options.max !== undefined\n          ? Temporal.PlainDate.compare(plain, options.max) > 0\n          : false);\n\n      cells.push({\n        isDisabled,\n        isSelected: _selected !== null && _selected.year === _displayYear && _selected.month === m,\n        label: format(plain, { intl: { month: 'long' }, locale: loc, tz: 'UTC' }),\n        month: m,\n        shortLabel: format(plain, { intl: { month: 'short' }, locale: loc, tz: 'UTC' }),\n      });\n    }\n\n    return cells;\n  }\n\n  function buildYearCells(): YearCell[] {\n    const decadeStart = Math.floor(_displayYear / 10) * 10;\n    const cells: YearCell[] = [];\n\n    for (let y = decadeStart; y < decadeStart + 12; y++) {\n      const firstOfYear = Temporal.PlainDate.from({ day: 1, month: 1, year: y });\n      const lastOfYear = Temporal.PlainDate.from({ day: 31, month: 12, year: y });\n\n      const isDisabled =\n        (options.min !== null && options.min !== undefined\n          ? Temporal.PlainDate.compare(lastOfYear, options.min) < 0\n          : false) ||\n        (options.max !== null && options.max !== undefined\n          ? Temporal.PlainDate.compare(firstOfYear, options.max) > 0\n          : false);\n\n      cells.push({\n        isDisabled,\n        isSelected: _selected !== null && _selected.year === y,\n        year: y,\n      });\n    }\n\n    return cells;\n  }\n\n  function buildWeekdayLabels(): string[] {\n    // 2024-01-07 is a Sunday — use it as the Sunday anchor\n    const sunday = parsePlainDate('2024-01-07');\n    const loc = locale();\n\n    return Array.from({ length: 7 }, (_, i) =>\n      format(sunday.add({ days: i }), { intl: { weekday: 'short' }, locale: loc, tz: 'UTC' }),\n    );\n  }\n\n  // ── Handle ────────────────────────────────────────────────────────────────\n\n  return {\n    dayCells: buildDayCells,\n    displayMonth: () => _displayMonth,\n    displayYear: () => _displayYear,\n\n    goTo(year: number, month: number): void {\n      if (!Number.isFinite(year)) return;\n\n      _displayYear = year;\n      _displayMonth = Math.max(1, Math.min(12, month));\n    },\n\n    monthCells: buildMonthCells,\n\n    nextMonth(): void {\n      if (_displayMonth === 12) {\n        _displayMonth = 1;\n        _displayYear++;\n      } else {\n        _displayMonth++;\n      }\n    },\n\n    nextYear(): void {\n      _displayYear++;\n    },\n\n    prevMonth(): void {\n      if (_displayMonth === 1) {\n        _displayMonth = 12;\n        _displayYear--;\n      } else {\n        _displayMonth--;\n      }\n    },\n\n    prevYear(): void {\n      _displayYear--;\n    },\n\n    select(date: Temporal.PlainDate | null): void {\n      if (date !== null && isDayDisabled(date)) return;\n\n      _selected = date;\n\n      if (_selected) {\n        _displayYear = _selected.year;\n        _displayMonth = _selected.month;\n      }\n\n      options.onChange(_selected);\n    },\n\n    selected: () => _selected,\n\n    setView(view: DatePickerView): void {\n      _view = view;\n    },\n\n    view: () => _view,\n\n    weekdayLabels: buildWeekdayLabels,\n\n    yearCells: buildYearCells,\n  };\n}\n"],"mappings":"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"}

package/dist/headless/dialog-focus.cjs

@@ -0,0 +1,2 @@
+const e=require("./focus.cjs"),t=require("./focus-trap.cjs");var n=n=>{let r=t.createFocusTrap(n.getContainer,{enabled:n.trapEnabled}),i=e.createFocusManager({getInitialFocusSelector:n.getInitialFocusSelector,getReturnFocus:n.getReturnFocus,host:n.host});return{activate(){i.captureReturnFocus(),r.activate(),i.applyInitialFocus()},deactivate(){i.cancelInitialFocus(),r.deactivate(),i.restoreFocus()}}};exports.createDialogFocusControl=n;
+//# sourceMappingURL=dialog-focus.cjs.map

package/dist/headless/dialog-focus.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-focus.cjs","names":[],"sources":["../../src/headless/dialog-focus.ts"],"sourcesContent":["import { createFocusManager } from './focus';\nimport { createFocusTrap } from './focus-trap';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type DialogFocusControlOptions = {\n  /** Returns the container element (dialog or shadow root) for focus trapping. */\n  getContainer: () => HTMLElement | ShadowRoot | null;\n  /** Returns the CSS selector for the element to focus on open (e.g. `'[autofocus]'`). */\n  getInitialFocusSelector: () => string | undefined;\n  /** Returns whether focus should be restored to the trigger on close. */\n  getReturnFocus: () => boolean | undefined;\n  /** Host element used to resolve `getInitialFocusSelector`. */\n  host: HTMLElement;\n  /** When provided, the trap only intercepts Tab when this returns `true`. */\n  trapEnabled?: () => boolean;\n};\n\nexport type DialogFocusControl = {\n  /** Capture return focus, activate the trap, and apply initial focus. */\n  activate(): void;\n  /** Deactivate the trap and restore focus. */\n  deactivate(): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Combines {@link createFocusTrap} and {@link createFocusManager} into a single\n * `activate / deactivate` API suited for modal dialogs and drawers.\n *\n * @example\n * ```ts\n * const focusCtrl = createDialogFocusControl({\n *   getContainer: () => dialog,\n *   getInitialFocusSelector: () => props['initial-focus'].value,\n *   getReturnFocus: () => props['return-focus'].value !== false,\n *   host: el,\n * });\n *\n * // On open:\n * focusCtrl.activate();\n *\n * // On close:\n * focusCtrl.deactivate();\n * ```\n */\nexport const createDialogFocusControl = (options: DialogFocusControlOptions): DialogFocusControl => {\n  const trap = createFocusTrap(options.getContainer, { enabled: options.trapEnabled });\n\n  const manager = createFocusManager({\n    getInitialFocusSelector: options.getInitialFocusSelector,\n    getReturnFocus: options.getReturnFocus,\n    host: options.host,\n  });\n\n  return {\n    activate() {\n      manager.captureReturnFocus();\n      trap.activate();\n      manager.applyInitialFocus();\n    },\n\n    deactivate() {\n      manager.cancelInitialFocus();\n      trap.deactivate();\n      manager.restoreFocus();\n    },\n  };\n};\n"],"mappings":"6DA+CA,IAAa,EAA4B,GAA2D,CAClG,IAAM,EAAO,EAAA,gBAAgB,EAAQ,aAAc,CAAE,QAAS,EAAQ,WAAY,CAAC,EAE7E,EAAU,EAAA,mBAAmB,CACjC,wBAAyB,EAAQ,wBACjC,eAAgB,EAAQ,eACxB,KAAM,EAAQ,IAChB,CAAC,EAED,MAAO,CACL,UAAW,CACT,EAAQ,mBAAmB,EAC3B,EAAK,SAAS,EACd,EAAQ,kBAAkB,CAC5B,EAEA,YAAa,CACX,EAAQ,mBAAmB,EAC3B,EAAK,WAAW,EAChB,EAAQ,aAAa,CACvB,CACF,CACF"}

package/dist/headless/dialog-focus.d.ts

@@ -0,0 +1,40 @@
+export type DialogFocusControlOptions = {
+    /** Returns the container element (dialog or shadow root) for focus trapping. */
+    getContainer: () => HTMLElement | ShadowRoot | null;
+    /** Returns the CSS selector for the element to focus on open (e.g. `'[autofocus]'`). */
+    getInitialFocusSelector: () => string | undefined;
+    /** Returns whether focus should be restored to the trigger on close. */
+    getReturnFocus: () => boolean | undefined;
+    /** Host element used to resolve `getInitialFocusSelector`. */
+    host: HTMLElement;
+    /** When provided, the trap only intercepts Tab when this returns `true`. */
+    trapEnabled?: () => boolean;
+};
+export type DialogFocusControl = {
+    /** Capture return focus, activate the trap, and apply initial focus. */
+    activate(): void;
+    /** Deactivate the trap and restore focus. */
+    deactivate(): void;
+};
+/**
+ * Combines {@link createFocusTrap} and {@link createFocusManager} into a single
+ * `activate / deactivate` API suited for modal dialogs and drawers.
+ *
+ * @example
+ * ```ts
+ * const focusCtrl = createDialogFocusControl({
+ *   getContainer: () => dialog,
+ *   getInitialFocusSelector: () => props['initial-focus'].value,
+ *   getReturnFocus: () => props['return-focus'].value !== false,
+ *   host: el,
+ * });
+ *
+ * // On open:
+ * focusCtrl.activate();
+ *
+ * // On close:
+ * focusCtrl.deactivate();
+ * ```
+ */
+export declare const createDialogFocusControl: (options: DialogFocusControlOptions) => DialogFocusControl;
+//# sourceMappingURL=dialog-focus.d.ts.map

package/dist/headless/dialog-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-focus.d.ts","sourceRoot":"","sources":["../../src/headless/dialog-focus.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,yBAAyB,GAAG;IACtC,gFAAgF;IAChF,YAAY,EAAE,MAAM,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;IACpD,wFAAwF;IACxF,uBAAuB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAClD,wEAAwE;IACxE,cAAc,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1C,8DAA8D;IAC9D,IAAI,EAAE,WAAW,CAAC;IAClB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wEAAwE;IACxE,QAAQ,IAAI,IAAI,CAAC;IACjB,6CAA6C;IAC7C,UAAU,IAAI,IAAI,CAAC;CACpB,CAAC;AAIF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,yBAAyB,KAAG,kBAsB7E,CAAC"}

package/dist/headless/dialog-focus.js

@@ -0,0 +1,22 @@
+import { createFocusManager as e } from "./focus.js";
+import { createFocusTrap as t } from "./focus-trap.js";
+//#region src/headless/dialog-focus.ts
+var n = (n) => {
+	let r = t(n.getContainer, { enabled: n.trapEnabled }), i = e({
+		getInitialFocusSelector: n.getInitialFocusSelector,
+		getReturnFocus: n.getReturnFocus,
+		host: n.host
+	});
+	return {
+		activate() {
+			i.captureReturnFocus(), r.activate(), i.applyInitialFocus();
+		},
+		deactivate() {
+			i.cancelInitialFocus(), r.deactivate(), i.restoreFocus();
+		}
+	};
+};
+//#endregion
+export { n as createDialogFocusControl };
+
+//# sourceMappingURL=dialog-focus.js.map

package/dist/headless/dialog-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-focus.js","names":[],"sources":["../../src/headless/dialog-focus.ts"],"sourcesContent":["import { createFocusManager } from './focus';\nimport { createFocusTrap } from './focus-trap';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type DialogFocusControlOptions = {\n  /** Returns the container element (dialog or shadow root) for focus trapping. */\n  getContainer: () => HTMLElement | ShadowRoot | null;\n  /** Returns the CSS selector for the element to focus on open (e.g. `'[autofocus]'`). */\n  getInitialFocusSelector: () => string | undefined;\n  /** Returns whether focus should be restored to the trigger on close. */\n  getReturnFocus: () => boolean | undefined;\n  /** Host element used to resolve `getInitialFocusSelector`. */\n  host: HTMLElement;\n  /** When provided, the trap only intercepts Tab when this returns `true`. */\n  trapEnabled?: () => boolean;\n};\n\nexport type DialogFocusControl = {\n  /** Capture return focus, activate the trap, and apply initial focus. */\n  activate(): void;\n  /** Deactivate the trap and restore focus. */\n  deactivate(): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Combines {@link createFocusTrap} and {@link createFocusManager} into a single\n * `activate / deactivate` API suited for modal dialogs and drawers.\n *\n * @example\n * ```ts\n * const focusCtrl = createDialogFocusControl({\n *   getContainer: () => dialog,\n *   getInitialFocusSelector: () => props['initial-focus'].value,\n *   getReturnFocus: () => props['return-focus'].value !== false,\n *   host: el,\n * });\n *\n * // On open:\n * focusCtrl.activate();\n *\n * // On close:\n * focusCtrl.deactivate();\n * ```\n */\nexport const createDialogFocusControl = (options: DialogFocusControlOptions): DialogFocusControl => {\n  const trap = createFocusTrap(options.getContainer, { enabled: options.trapEnabled });\n\n  const manager = createFocusManager({\n    getInitialFocusSelector: options.getInitialFocusSelector,\n    getReturnFocus: options.getReturnFocus,\n    host: options.host,\n  });\n\n  return {\n    activate() {\n      manager.captureReturnFocus();\n      trap.activate();\n      manager.applyInitialFocus();\n    },\n\n    deactivate() {\n      manager.cancelInitialFocus();\n      trap.deactivate();\n      manager.restoreFocus();\n    },\n  };\n};\n"],"mappings":";;;AA+CA,IAAa,KAA4B,MAA2D;CAClG,IAAM,IAAO,EAAgB,EAAQ,cAAc,EAAE,SAAS,EAAQ,YAAY,CAAC,GAE7E,IAAU,EAAmB;EACjC,yBAAyB,EAAQ;EACjC,gBAAgB,EAAQ;EACxB,MAAM,EAAQ;CAChB,CAAC;CAED,OAAO;EACL,WAAW;GAGT,AAFA,EAAQ,mBAAmB,GAC3B,EAAK,SAAS,GACd,EAAQ,kBAAkB;EAC5B;EAEA,aAAa;GAGX,AAFA,EAAQ,mBAAmB,GAC3B,EAAK,WAAW,GAChB,EAAQ,aAAa;EACvB;CACF;AACF"}

package/dist/headless/direction.cjs

@@ -0,0 +1,2 @@
+function e(e){let t=e;for(;t;){let e=t.getAttribute(`dir`);if(e===`rtl`||e===`ltr`)return e;t=t.parentElement}return e!==null&&getComputedStyle(e).direction===`rtl`?`rtl`:`ltr`}exports.elementDirection=e;
+//# sourceMappingURL=direction.cjs.map

package/dist/headless/direction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction.cjs","names":[],"sources":["../../src/headless/direction.ts"],"sourcesContent":["/**\n * Resolves the effective text direction for an element.\n *\n * The closest ancestor with an explicit `dir=\"ltr\"` or `dir=\"rtl\"` attribute wins — this\n * supports locally-scoped RTL sections (e.g. a single `dir=\"rtl\"` panel inside an otherwise\n * LTR page). When no explicit `dir` attribute is found up the tree, falls back to the\n * computed `direction` CSS property (e.g. set via a `direction: rtl` style rule with no\n * `dir` attribute). Defaults to `'ltr'` when `el` is `null`.\n */\nexport function elementDirection(el: Element | null): 'ltr' | 'rtl' {\n  let node: Element | null = el;\n\n  while (node) {\n    const dir = node.getAttribute('dir');\n\n    if (dir === 'rtl' || dir === 'ltr') return dir;\n\n    node = node.parentElement;\n  }\n\n  return el !== null && getComputedStyle(el).direction === 'rtl' ? 'rtl' : 'ltr';\n}\n"],"mappings":"AASA,SAAgB,EAAiB,EAAmC,CAClE,IAAI,EAAuB,EAE3B,KAAO,GAAM,CACX,IAAM,EAAM,EAAK,aAAa,KAAK,EAEnC,GAAI,IAAQ,OAAS,IAAQ,MAAO,OAAO,EAE3C,EAAO,EAAK,aACd,CAEA,OAAO,IAAO,MAAQ,iBAAiB,CAAE,CAAC,CAAC,YAAc,MAAQ,MAAQ,KAC3E"}

package/dist/headless/direction.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolves the effective text direction for an element.
+ *
+ * The closest ancestor with an explicit `dir="ltr"` or `dir="rtl"` attribute wins — this
+ * supports locally-scoped RTL sections (e.g. a single `dir="rtl"` panel inside an otherwise
+ * LTR page). When no explicit `dir` attribute is found up the tree, falls back to the
+ * computed `direction` CSS property (e.g. set via a `direction: rtl` style rule with no
+ * `dir` attribute). Defaults to `'ltr'` when `el` is `null`.
+ */
+export declare function elementDirection(el: Element | null): 'ltr' | 'rtl';
+//# sourceMappingURL=direction.d.ts.map

package/dist/headless/direction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction.d.ts","sourceRoot":"","sources":["../../src/headless/direction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAYlE"}

package/dist/headless/direction.js

@@ -0,0 +1,14 @@
+//#region src/headless/direction.ts
+function e(e) {
+	let t = e;
+	for (; t;) {
+		let e = t.getAttribute("dir");
+		if (e === "rtl" || e === "ltr") return e;
+		t = t.parentElement;
+	}
+	return e !== null && getComputedStyle(e).direction === "rtl" ? "rtl" : "ltr";
+}
+//#endregion
+export { e as elementDirection };
+
+//# sourceMappingURL=direction.js.map

package/dist/headless/direction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction.js","names":[],"sources":["../../src/headless/direction.ts"],"sourcesContent":["/**\n * Resolves the effective text direction for an element.\n *\n * The closest ancestor with an explicit `dir=\"ltr\"` or `dir=\"rtl\"` attribute wins — this\n * supports locally-scoped RTL sections (e.g. a single `dir=\"rtl\"` panel inside an otherwise\n * LTR page). When no explicit `dir` attribute is found up the tree, falls back to the\n * computed `direction` CSS property (e.g. set via a `direction: rtl` style rule with no\n * `dir` attribute). Defaults to `'ltr'` when `el` is `null`.\n */\nexport function elementDirection(el: Element | null): 'ltr' | 'rtl' {\n  let node: Element | null = el;\n\n  while (node) {\n    const dir = node.getAttribute('dir');\n\n    if (dir === 'rtl' || dir === 'ltr') return dir;\n\n    node = node.parentElement;\n  }\n\n  return el !== null && getComputedStyle(el).direction === 'rtl' ? 'rtl' : 'ltr';\n}\n"],"mappings":";AASA,SAAgB,EAAiB,GAAmC;CAClE,IAAI,IAAuB;CAE3B,OAAO,IAAM;EACX,IAAM,IAAM,EAAK,aAAa,KAAK;EAEnC,IAAI,MAAQ,SAAS,MAAQ,OAAO,OAAO;EAE3C,IAAO,EAAK;CACd;CAEA,OAAO,MAAO,QAAQ,iBAAiB,CAAE,CAAC,CAAC,cAAc,QAAQ,QAAQ;AAC3E"}

package/dist/headless/field-base.cjs

@@ -0,0 +1,2 @@
+let e=require("@vielzeug/ore"),t=require("@vielzeug/ripple");var n=e=>(0,t.computed)(()=>({errorText:e.error?.value??``,helperText:e.helper?.value??``})),r=e=>(0,t.computed)(()=>{let t=e.value?.value??``,n=e.maxLength?.value,r=Number(n),i=Number.isFinite(r)&&r>0?r:null,a=i!==null,o=a?`${t.length} / ${i}`:``,s=a?t.length/i:0;return{counterAtLimit:a?s>=1:!1,counterNearLimit:a?s>=.9&&s<1:!1,counterText:o}}),i=r=>{let i=(0,t.computed)(()=>!!r.disabled?.value),a=r.validateOn,o=r.id??(0,e.createStableId)(r.prefix??`field`),s=(0,e.createStableId)(`helper`),c=e=>{a?.value===e&&r.getFormField?.()?.reportValidity()},l=(0,e.createStableId)(`label`),u=(0,e.createStableId)(`error`),d=r.label??(0,t.computed)(()=>void 0),f=r.hasLabel??(0,t.computed)(()=>!!d.value),p=n({error:r.error,helper:r.helper}),m=(0,t.computed)(()=>p.value.errorText||p.value.helperText?s:null),h=(0,t.computed)(()=>p.value.errorText?u:null),g=(0,t.computed)(()=>p.value.errorText?`true`:null),_=(0,t.computed)(()=>f.value?l:null);return{ariaDescribedBy:m,ariaErrorMessage:h,ariaInvalid:g,ariaLabelledBy:_,ariaProps:()=>({"aria-describedby":m.value,"aria-errormessage":h.value,"aria-invalid":g.value,"aria-labelledby":_.value}),assistiveId:s,disabled:i,errorId:u,errorText:(0,t.computed)(()=>p.value.errorText),fieldId:o,helperText:(0,t.computed)(()=>p.value.helperText),labelId:l,labelVisible:f,triggerValidation:c}};exports.createCounterState=r,exports.createErrorHelperState=n,exports.createField=i;
+//# sourceMappingURL=field-base.cjs.map

package/dist/headless/field-base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-base.cjs","names":[],"sources":["../../src/headless/field-base.ts"],"sourcesContent":["import { createStableId } from '@vielzeug/ore';\nimport { computed, type Readable } from '@vielzeug/ripple';\n\n// ── Validation / context types ────────────────────────────────────────────────\n\nexport type ValidationTrigger = 'blur' | 'change' | 'input' | 'submit';\nexport type ControlValidationMode = ValidationTrigger | undefined;\n\n// ── Field options + handle ───────────────────────────────────────────────────\n\n/** Options shared by both `createTextField` and `createChoiceField`. */\nexport type FieldOptions = {\n  disabled?: Readable<boolean | undefined>;\n  error?: Readable<string | undefined>;\n  /**\n   * Returns the underlying form field object used for validation triggering.\n   * Called lazily — safe to return `null` before the first render.\n   */\n  getFormField?: () => { reportValidity(): void } | null;\n  /**\n   * Override for label visibility that takes precedence over deriving it from\n   * the `label` text signal. Pass a computed signal that checks both prop and\n   * slot presence to enable slot-first composition.\n   *\n   * @example\n   * ```ts\n   * const hasLabel = computed(() => !!props.label.value || slots.has('label').value);\n   * const field = createField({ ...options, hasLabel });\n   * ```\n   */\n  hasLabel?: Readable<boolean>;\n  helper?: Readable<string | undefined>;\n  /**\n   * When provided, used directly as `fieldId` instead of generating one via\n   * `createStableId`. Useful in tests for deterministic ID assertions.\n   */\n  id?: string;\n  /**\n   * Label text signal. When provided, `labelVisible` and `ariaLabelledBy` are\n   * computed reactively from this value (see `hasLabel` for the slot-first override).\n   */\n  label?: Readable<string | undefined>;\n  /**\n   * Label placement signal. Defaults to `'inset'`.\n   *\n   * Not currently consumed by `createField()` itself — visibility is driven\n   * solely by `hasLabel`/`label`. Threaded through so component authors can\n   * apply placement-specific styling (`label-placement` attribute) without a\n   * second prop; if placement-dependent visibility is ever needed, wire it\n   * into `labelVisible$` in `createField()` instead of adding a new option.\n   */\n  labelPlacement?: Readable<LabelPlacement>;\n  prefix?: string;\n  validateOn?: Readable<ControlValidationMode>;\n};\n\n// ── Error/helper assistive state ──────────────────────────────────────────────\n\nexport type ErrorHelperState = {\n  errorText: string;\n  helperText: string;\n};\n\nexport type ErrorHelperOptions = {\n  error?: Readable<string | undefined>;\n  helper?: Readable<string | undefined>;\n};\n\nexport const createErrorHelperState = (options: ErrorHelperOptions): Readable<ErrorHelperState> =>\n  computed(() => ({\n    errorText: options.error?.value ?? '',\n    helperText: options.helper?.value ?? '',\n  }));\n\n// ── Counter state (opt-in) ─────────────────────────────────────────────────────\n\n/** Counter state for text fields with `maxLength`. */\nexport type CounterState = {\n  counterAtLimit: boolean;\n  counterNearLimit: boolean;\n  counterText: string;\n};\n\nexport type CounterOptions = {\n  maxLength?: Readable<number | undefined>;\n  value: Readable<string | undefined>;\n};\n\n/**\n * Creates a reactive counter state signal for text fields with `maxLength`.\n * Only call this when `maxLength` may be set — the state is genuinely opt-in.\n *\n * @example\n * ```ts\n * const counter = createCounterState({ value: tf.value, maxLength: props.maxlength });\n * ```\n */\nexport const createCounterState = (options: CounterOptions): Readable<CounterState> =>\n  computed<CounterState>(() => {\n    const value = options.value?.value ?? '';\n    const maxLength = options.maxLength?.value;\n    const parsedMaxLength = Number(maxLength);\n    const validMaxLength = Number.isFinite(parsedMaxLength) && parsedMaxLength > 0 ? parsedMaxLength : null;\n    const hasCounter = validMaxLength !== null;\n    const counterText = hasCounter ? `${value.length} / ${validMaxLength}` : '';\n    const ratio = hasCounter ? value.length / validMaxLength : 0;\n\n    return {\n      counterAtLimit: hasCounter ? ratio >= 1 : false,\n      counterNearLimit: hasCounter ? ratio >= 0.9 && ratio < 1 : false,\n      counterText,\n    };\n  });\n\n// ── Label placement ───────────────────────────────────────────────────────────\n\nexport type LabelPlacement = 'inset' | 'outside' | undefined;\n\n// ── Field handle ──────────────────────────────────────────────────────────────\n\n/**\n * Common handle returned by `createField` — the base for both `TextFieldHandle`\n * and `ChoiceFieldHandle`.\n *\n * ARIA signals and label state are flat on the handle — no nested `aria` or\n * `label` sub-objects.\n *\n * @example\n * ```html\n * <label id=\"${labelId}\" ?hidden=\"${() => !labelVisible.value}\">...</label>\n * <input\n *   :aria-labelledby=\"${ariaLabelledBy}\"\n *   :aria-describedby=\"${ariaDescribedBy}\"\n *   :aria-invalid=\"${ariaInvalid}\" />\n * ```\n */\n/** Flat ARIA attribute bag ready to spread into a template bind call. */\nexport type AriaProps = {\n  'aria-describedby': string | null;\n  'aria-errormessage': string | null;\n  'aria-invalid': 'true' | null;\n  'aria-labelledby': string | null;\n};\n\nexport type FieldHandle = {\n  /** `aria-describedby` value. Non-null when helper or error text is present. */\n  ariaDescribedBy: Readable<string | null>;\n  /** `aria-errormessage` value. Non-null when error text is present. */\n  ariaErrorMessage: Readable<string | null>;\n  /** `aria-invalid` value. `'true'` when error text is present, otherwise `null`. */\n  ariaInvalid: Readable<'true' | null>;\n  /** `aria-labelledby` value. Non-null when a label is visible. */\n  ariaLabelledBy: Readable<string | null>;\n  /**\n   * Returns a snapshot of the four ARIA attributes as a plain object.\n   * Spread into a template bind call to avoid repeating each signal individually.\n   *\n   * @example\n   * ```ts\n   * bind(inputEl, { attr: field.ariaProps() });\n   * ```\n   */\n  ariaProps(): AriaProps;\n  /**\n   * The stable `id` used for `aria-describedby` on the input. Points at the\n   * assistive-text region (covers both helper text and error text per WAI-ARIA).\n   */\n  assistiveId: string;\n  disabled: Readable<boolean>;\n  /** Stable `id` for the inline error message element (`aria-errormessage`). */\n  errorId: string;\n  /** Reactive error text. Empty string when no error is set. */\n  errorText: Readable<string>;\n  fieldId: string;\n  /** Reactive helper text. Empty string when no helper is set. */\n  helperText: Readable<string>;\n  /** Stable `id` for the label element. Stamp this on your `<label id=\"...\">`. */\n  labelId: string;\n  /** Whether the label should be visible. Use to toggle `hidden` on the `<label>`. */\n  labelVisible: Readable<boolean>;\n  triggerValidation: (on: Extract<ValidationTrigger, 'blur' | 'change'>) => void;\n};\n\n/**\n * Composes the field triad — IDs, assistive state, and label state — into a\n * single `FieldHandle`. Both `createTextField` and `createChoiceField` build\n * on top of this.\n */\nexport const createField = (options: FieldOptions): FieldHandle => {\n  // ── Core ──────────────────────────────────────────────────────────────────\n  const disabled = computed(() => Boolean(options.disabled?.value));\n  const validateOn = options.validateOn;\n  const fieldId = options.id ?? createStableId(options.prefix ?? 'field');\n  const assistiveId = createStableId('helper');\n\n  const triggerValidation = (on: Extract<ValidationTrigger, 'blur' | 'change'>): void => {\n    if (validateOn?.value === on) options.getFormField?.()?.reportValidity();\n  };\n\n  // ── Label + ARIA state ────────────────────────────────────────────────────\n  const labelId = createStableId('label');\n  const errorId = createStableId('error');\n\n  const label$ = options.label ?? computed(() => undefined);\n\n  // Slot-first composition: if the caller provides `hasLabel`, use it instead\n  // of deriving visibility purely from the label text signal. This allows\n  // components with a `<slot name=\"label\">` to stay visible even when the\n  // `label` prop is empty but a slotted label element is present.\n  const labelVisible$ = options.hasLabel ?? computed(() => Boolean(label$.value));\n\n  const resolvedAssistive = createErrorHelperState({ error: options.error, helper: options.helper });\n\n  const ariaDescribedBy = computed(() =>\n    resolvedAssistive.value.errorText || resolvedAssistive.value.helperText ? assistiveId : null,\n  );\n  const ariaErrorMessage = computed(() => (resolvedAssistive.value.errorText ? errorId : null));\n  const ariaInvalid = computed<'true' | null>(() => (resolvedAssistive.value.errorText ? 'true' : null));\n  const ariaLabelledBy = computed(() => (labelVisible$.value ? labelId : null));\n\n  return {\n    ariaDescribedBy,\n    ariaErrorMessage,\n    ariaInvalid,\n    ariaLabelledBy,\n    ariaProps: () => ({\n      'aria-describedby': ariaDescribedBy.value,\n      'aria-errormessage': ariaErrorMessage.value,\n      'aria-invalid': ariaInvalid.value,\n      'aria-labelledby': ariaLabelledBy.value,\n    }),\n    assistiveId,\n    disabled,\n    errorId,\n    errorText: computed(() => resolvedAssistive.value.errorText),\n    fieldId,\n    helperText: computed(() => resolvedAssistive.value.helperText),\n    labelId,\n    labelVisible: labelVisible$,\n    triggerValidation,\n  };\n};\n"],"mappings":"6DAoEA,IAAa,EAA0B,IAAA,EAAA,EAAA,SAAA,MACrB,CACd,UAAW,EAAQ,OAAO,OAAS,GACnC,WAAY,EAAQ,QAAQ,OAAS,EACvC,EAAE,EAyBS,EAAsB,IAAA,EAAA,EAAA,SAAA,KACJ,CAC3B,IAAM,EAAQ,EAAQ,OAAO,OAAS,GAChC,EAAY,EAAQ,WAAW,MAC/B,EAAkB,OAAO,CAAS,EAClC,EAAiB,OAAO,SAAS,CAAe,GAAK,EAAkB,EAAI,EAAkB,KAC7F,EAAa,IAAmB,KAChC,EAAc,EAAa,GAAG,EAAM,OAAO,KAAK,IAAmB,GACnE,EAAQ,EAAa,EAAM,OAAS,EAAiB,EAE3D,MAAO,CACL,eAAgB,EAAa,GAAS,EAAI,GAC1C,iBAAkB,EAAa,GAAS,IAAO,EAAQ,EAAI,GAC3D,aACF,CACF,CAAC,EA4EU,EAAe,GAAuC,CAEjE,IAAM,GAAA,EAAA,EAAA,SAAA,KAA0B,EAAQ,EAAQ,UAAU,KAAM,EAC1D,EAAa,EAAQ,WACrB,EAAU,EAAQ,KAAA,EAAA,EAAA,eAAA,CAAqB,EAAQ,QAAU,OAAO,EAChE,GAAA,EAAA,EAAA,eAAA,CAA6B,QAAQ,EAErC,EAAqB,GAA4D,CACjF,GAAY,QAAU,GAAI,EAAQ,eAAe,CAAC,EAAE,eAAe,CACzE,EAGM,GAAA,EAAA,EAAA,eAAA,CAAyB,OAAO,EAChC,GAAA,EAAA,EAAA,eAAA,CAAyB,OAAO,EAEhC,EAAS,EAAQ,QAAA,EAAA,EAAA,SAAA,KAAwB,IAAA,EAAS,EAMlD,EAAgB,EAAQ,WAAA,EAAA,EAAA,SAAA,KAA2B,EAAQ,EAAO,KAAM,EAExE,EAAoB,EAAuB,CAAE,MAAO,EAAQ,MAAO,OAAQ,EAAQ,MAAO,CAAC,EAE3F,GAAA,EAAA,EAAA,SAAA,KACJ,EAAkB,MAAM,WAAa,EAAkB,MAAM,WAAa,EAAc,IAC1F,EACM,GAAA,EAAA,EAAA,SAAA,KAAmC,EAAkB,MAAM,UAAY,EAAU,IAAK,EACtF,GAAA,EAAA,EAAA,SAAA,KAA6C,EAAkB,MAAM,UAAY,OAAS,IAAK,EAC/F,GAAA,EAAA,EAAA,SAAA,KAAiC,EAAc,MAAQ,EAAU,IAAK,EAE5E,MAAO,CACL,kBACA,mBACA,cACA,iBACA,eAAkB,CAChB,mBAAoB,EAAgB,MACpC,oBAAqB,EAAiB,MACtC,eAAgB,EAAY,MAC5B,kBAAmB,EAAe,KACpC,GACA,cACA,WACA,UACA,WAAA,EAAA,EAAA,SAAA,KAA0B,EAAkB,MAAM,SAAS,EAC3D,UACA,YAAA,EAAA,EAAA,SAAA,KAA2B,EAAkB,MAAM,UAAU,EAC7D,UACA,aAAc,EACd,mBACF,CACF"}