@pindoba/core-calendar 0.0.0-alpha-20260426220647

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright 2025 Eduardo Lopes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { _ as CalendarSlotPassThrough, a as CalendarClasses, b as ConnectCalendarOptions, c as CalendarFeedback, d as CalendarPadding, f as CalendarPassThrough, h as CalendarShadow, i as CalendarBorder, l as CalendarJsInstance, m as CalendarRootProps, n as CalendarBackground, o as CalendarController, p as CalendarRadius, r as CalendarBaseProps, s as CalendarEmphasis, t as CalendarApi, u as CalendarJsOptions, v as CalendarSlotProps, x as ElementAttributes, y as CalendarView } from "./types-C3oj58JZ.js";
+import { calendarDefaults, connectCalendar } from "./src/connect-calendar.js";
+import { createCalendar } from "./src/create-calendar.js";
+import { CalendarSelection, addMonths, formatDay, formatFullDate, formatMonth, formatMonthYear, formatRange, formatSelection, formatYear, toLocalISODate, toUTCDate } from "./src/format-month-year.js";
+import { clearSelectionAttrs, correctTodayAttr, watchToday } from "./src/correct-today.js";
+import { CalendarActions, CalendarMount, MountCalendarOptions, mountCalendar, parseSelection } from "./src/mount-calendar.js";
+export { type CalendarActions, type CalendarApi, type CalendarBackground, type CalendarBaseProps, type CalendarBorder, type CalendarClasses, type CalendarController, type CalendarEmphasis, type CalendarFeedback, type CalendarJsInstance, type CalendarJsOptions, type CalendarMount, type CalendarPadding, type CalendarPassThrough, type CalendarRadius, type CalendarRootProps, type CalendarSelection, type CalendarShadow, type CalendarSlotPassThrough, type CalendarSlotProps, type CalendarView, type ConnectCalendarOptions, type ElementAttributes, type MountCalendarOptions, addMonths, calendarDefaults, clearSelectionAttrs, connectCalendar, correctTodayAttr, createCalendar, formatDay, formatFullDate, formatMonth, formatMonthYear, formatRange, formatSelection, formatYear, mountCalendar, parseSelection, toLocalISODate, toUTCDate, watchToday };

package/dist/index.js

@@ -0,0 +1,6 @@
+import { calendarDefaults, connectCalendar } from "./src/connect-calendar.js";
+import { createCalendar } from "./src/create-calendar.js";
+import { addMonths, formatDay, formatFullDate, formatMonth, formatMonthYear, formatRange, formatSelection, formatYear, toLocalISODate, toUTCDate } from "./src/format-month-year.js";
+import { clearSelectionAttrs, correctTodayAttr, watchToday } from "./src/correct-today.js";
+import { mountCalendar, parseSelection } from "./src/mount-calendar.js";
+export { addMonths, calendarDefaults, clearSelectionAttrs, connectCalendar, correctTodayAttr, createCalendar, formatDay, formatFullDate, formatMonth, formatMonthYear, formatRange, formatSelection, formatYear, mountCalendar, parseSelection, toLocalISODate, toUTCDate, watchToday };

package/dist/src/connect-calendar.d.ts

@@ -0,0 +1,22 @@
+import { b as ConnectCalendarOptions, t as CalendarApi } from "../types-C3oj58JZ.js";
+
+//#region src/connect-calendar.d.ts
+declare const calendarDefaults: {
+  readonly size: "md";
+  readonly background: "surface.soft";
+  readonly feedback: "neutral";
+  readonly accent: false;
+  readonly translucent: false;
+  readonly padding: "sm";
+  readonly radius: "lg";
+  readonly border: "default";
+  readonly shadow: "none";
+  readonly showControls: true;
+  readonly showFooter: true;
+  readonly showToday: true;
+  readonly showReset: false;
+};
+declare function connectCalendar(options: ConnectCalendarOptions): CalendarApi;
+//#endregion
+export { calendarDefaults, connectCalendar };
+//# sourceMappingURL=connect-calendar.d.ts.map

package/dist/src/connect-calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-calendar.d.ts","names":[],"sources":["../../src/connect-calendar.ts"],"mappings":";;;cASa,gBAAA;EAAA;;;;;;;;;;;;;;iBAgBG,eAAA,CAAgB,OAAA,EAAS,sBAAA,GAAyB,WAAA"}

package/dist/src/connect-calendar.js

@@ -0,0 +1,99 @@
+import { css } from "@pindoba/styled-system/css";
+import { connectPanel } from "@pindoba/core-panel";
+import { calendarStyles } from "@pindoba/styles-calendar";
+//#region src/connect-calendar.ts
+const calendarDefaults = {
+	size: "md",
+	background: "surface.soft",
+	feedback: "neutral",
+	accent: false,
+	translucent: false,
+	padding: "sm",
+	radius: "lg",
+	border: "default",
+	shadow: "none",
+	showControls: true,
+	showFooter: true,
+	showToday: true,
+	showReset: false
+};
+function connectCalendar(options) {
+	const { size = calendarDefaults.size, background = calendarDefaults.background, feedback = calendarDefaults.feedback, emphasis, accent = calendarDefaults.accent, translucent = calendarDefaults.translucent, padding = calendarDefaults.padding, radius = calendarDefaults.radius, border = calendarDefaults.border, shadow = calendarDefaults.shadow, showControls = calendarDefaults.showControls, showFooter = calendarDefaults.showFooter, showToday = calendarDefaults.showToday, showReset = calendarDefaults.showReset, locale, passThrough, class: className, options: _calendarJsOptions, id: _id, ...restProps } = options;
+	const slotClasses = calendarStyles.raw({ size });
+	const panelApi = connectPanel({
+		dataComponent: "calendar",
+		background,
+		feedback,
+		emphasis,
+		accent,
+		translucent,
+		padding,
+		radius,
+		border,
+		shadow,
+		passThrough: { root: {
+			style: css.raw(slotClasses.root, passThrough?.root?.style),
+			props: passThrough?.root?.props
+		} },
+		class: className,
+		...restProps
+	});
+	const headerClass = css(slotClasses.header, passThrough?.header?.style);
+	const labelsClass = css(slotClasses.labels, passThrough?.labels?.style);
+	const navClass = css(slotClasses.nav, passThrough?.nav?.style);
+	const bodyClass = css(slotClasses.body, passThrough?.body?.style);
+	const footerClass = css(slotClasses.footer, passThrough?.footer?.style);
+	const labelClass = css(slotClasses.label, passThrough?.label?.style);
+	return {
+		rootProps: panelApi.rootProps,
+		headerProps: {
+			class: headerClass,
+			"data-calendar-slot": "header",
+			...passThrough?.header?.props
+		},
+		labelsProps: {
+			class: labelsClass,
+			"data-calendar-slot": "labels",
+			...passThrough?.labels?.props
+		},
+		navProps: {
+			class: navClass,
+			"data-calendar-slot": "nav",
+			...passThrough?.nav?.props
+		},
+		bodyProps: {
+			class: bodyClass,
+			"data-calendar-slot": "body",
+			"data-calendar-container": "",
+			...passThrough?.body?.props
+		},
+		footerProps: {
+			class: footerClass,
+			"data-calendar-slot": "footer",
+			...passThrough?.footer?.props
+		},
+		labelProps: {
+			class: labelClass,
+			"data-calendar-slot": "label",
+			...passThrough?.label?.props
+		},
+		classes: {
+			root: panelApi.rootProps.class,
+			header: headerClass,
+			labels: labelsClass,
+			nav: navClass,
+			body: bodyClass,
+			footer: footerClass,
+			label: labelClass
+		},
+		showControls,
+		showFooter,
+		showToday,
+		showReset,
+		locale
+	};
+}
+//#endregion
+export { calendarDefaults, connectCalendar };
+
+//# sourceMappingURL=connect-calendar.js.map

package/dist/src/connect-calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-calendar.js","names":[],"sources":["../../src/connect-calendar.ts"],"sourcesContent":["import { css } from \"@pindoba/styled-system/css\";\nimport { connectPanel } from \"@pindoba/core-panel\";\nimport { calendarStyles } from \"@pindoba/styles-calendar\";\nimport type {\n  CalendarApi,\n  CalendarBaseProps,\n  ConnectCalendarOptions,\n} from \"./types.js\";\n\nexport const calendarDefaults = {\n  size: \"md\",\n  background: \"surface.soft\",\n  feedback: \"neutral\",\n  accent: false,\n  translucent: false,\n  padding: \"sm\",\n  radius: \"lg\",\n  border: \"default\",\n  shadow: \"none\",\n  showControls: true,\n  showFooter: true,\n  showToday: true,\n  showReset: false,\n} as const satisfies Partial<CalendarBaseProps>;\n\nexport function connectCalendar(options: ConnectCalendarOptions): CalendarApi {\n  const {\n    size = calendarDefaults.size,\n    background = calendarDefaults.background,\n    feedback = calendarDefaults.feedback,\n    emphasis,\n    accent = calendarDefaults.accent,\n    translucent = calendarDefaults.translucent,\n    padding = calendarDefaults.padding,\n    radius = calendarDefaults.radius,\n    border = calendarDefaults.border,\n    shadow = calendarDefaults.shadow,\n    showControls = calendarDefaults.showControls,\n    showFooter = calendarDefaults.showFooter,\n    showToday = calendarDefaults.showToday,\n    showReset = calendarDefaults.showReset,\n    locale,\n    passThrough,\n    class: className,\n    // options (calendar.js config) is passed through by the framework wrapper,\n    // not by this connector.\n    options: _calendarJsOptions,\n    id: _id,\n    ...restProps\n  } = options;\n\n  const slotClasses = calendarStyles.raw({ size });\n\n  const panelApi = connectPanel({\n    dataComponent: \"calendar\",\n    background,\n    feedback,\n    emphasis,\n    accent,\n    translucent,\n    padding,\n    radius,\n    border,\n    shadow,\n    passThrough: {\n      root: {\n        style: css.raw(slotClasses.root, passThrough?.root?.style),\n        props: passThrough?.root?.props,\n      },\n    },\n    class: className,\n    ...restProps,\n  });\n\n  const headerClass = css(slotClasses.header, passThrough?.header?.style);\n  const labelsClass = css(slotClasses.labels, passThrough?.labels?.style);\n  const navClass = css(slotClasses.nav, passThrough?.nav?.style);\n  const bodyClass = css(slotClasses.body, passThrough?.body?.style);\n  const footerClass = css(slotClasses.footer, passThrough?.footer?.style);\n  const labelClass = css(slotClasses.label, passThrough?.label?.style);\n\n  return {\n    rootProps: panelApi.rootProps as CalendarApi[\"rootProps\"],\n    headerProps: {\n      class: headerClass,\n      \"data-calendar-slot\": \"header\",\n      ...passThrough?.header?.props,\n    },\n    labelsProps: {\n      class: labelsClass,\n      \"data-calendar-slot\": \"labels\",\n      ...passThrough?.labels?.props,\n    },\n    navProps: {\n      class: navClass,\n      \"data-calendar-slot\": \"nav\",\n      ...passThrough?.nav?.props,\n    },\n    bodyProps: {\n      class: bodyClass,\n      \"data-calendar-slot\": \"body\",\n      \"data-calendar-container\": \"\",\n      ...passThrough?.body?.props,\n    },\n    footerProps: {\n      class: footerClass,\n      \"data-calendar-slot\": \"footer\",\n      ...passThrough?.footer?.props,\n    },\n    labelProps: {\n      class: labelClass,\n      \"data-calendar-slot\": \"label\",\n      ...passThrough?.label?.props,\n    },\n    classes: {\n      root: panelApi.rootProps.class,\n      header: headerClass,\n      labels: labelsClass,\n      nav: navClass,\n      body: bodyClass,\n      footer: footerClass,\n      label: labelClass,\n    },\n    showControls,\n    showFooter,\n    showToday,\n    showReset,\n    locale,\n  };\n}\n"],"mappings":";;;;AASA,MAAa,mBAAmB;CAC9B,MAAM;CACN,YAAY;CACZ,UAAU;CACV,QAAQ;CACR,aAAa;CACb,SAAS;CACT,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,cAAc;CACd,YAAY;CACZ,WAAW;CACX,WAAW;CACZ;AAED,SAAgB,gBAAgB,SAA8C;CAC5E,MAAM,EACJ,OAAO,iBAAiB,MACxB,aAAa,iBAAiB,YAC9B,WAAW,iBAAiB,UAC5B,UACA,SAAS,iBAAiB,QAC1B,cAAc,iBAAiB,aAC/B,UAAU,iBAAiB,SAC3B,SAAS,iBAAiB,QAC1B,SAAS,iBAAiB,QAC1B,SAAS,iBAAiB,QAC1B,eAAe,iBAAiB,cAChC,aAAa,iBAAiB,YAC9B,YAAY,iBAAiB,WAC7B,YAAY,iBAAiB,WAC7B,QACA,aACA,OAAO,WAGP,SAAS,oBACT,IAAI,KACJ,GAAG,cACD;CAEJ,MAAM,cAAc,eAAe,IAAI,EAAE,MAAM,CAAC;CAEhD,MAAM,WAAW,aAAa;EAC5B,eAAe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,aAAa,EACX,MAAM;GACJ,OAAO,IAAI,IAAI,YAAY,MAAM,aAAa,MAAM,MAAM;GAC1D,OAAO,aAAa,MAAM;GAC3B,EACF;EACD,OAAO;EACP,GAAG;EACJ,CAAC;CAEF,MAAM,cAAc,IAAI,YAAY,QAAQ,aAAa,QAAQ,MAAM;CACvE,MAAM,cAAc,IAAI,YAAY,QAAQ,aAAa,QAAQ,MAAM;CACvE,MAAM,WAAW,IAAI,YAAY,KAAK,aAAa,KAAK,MAAM;CAC9D,MAAM,YAAY,IAAI,YAAY,MAAM,aAAa,MAAM,MAAM;CACjE,MAAM,cAAc,IAAI,YAAY,QAAQ,aAAa,QAAQ,MAAM;CACvE,MAAM,aAAa,IAAI,YAAY,OAAO,aAAa,OAAO,MAAM;AAEpE,QAAO;EACL,WAAW,SAAS;EACpB,aAAa;GACX,OAAO;GACP,sBAAsB;GACtB,GAAG,aAAa,QAAQ;GACzB;EACD,aAAa;GACX,OAAO;GACP,sBAAsB;GACtB,GAAG,aAAa,QAAQ;GACzB;EACD,UAAU;GACR,OAAO;GACP,sBAAsB;GACtB,GAAG,aAAa,KAAK;GACtB;EACD,WAAW;GACT,OAAO;GACP,sBAAsB;GACtB,2BAA2B;GAC3B,GAAG,aAAa,MAAM;GACvB;EACD,aAAa;GACX,OAAO;GACP,sBAAsB;GACtB,GAAG,aAAa,QAAQ;GACzB;EACD,YAAY;GACV,OAAO;GACP,sBAAsB;GACtB,GAAG,aAAa,OAAO;GACxB;EACD,SAAS;GACP,MAAM,SAAS,UAAU;GACzB,QAAQ;GACR,QAAQ;GACR,KAAK;GACL,MAAM;GACN,QAAQ;GACR,OAAO;GACR;EACD;EACA;EACA;EACA;EACA;EACD"}

package/dist/src/correct-today.d.ts

@@ -0,0 +1,12 @@
+//#region src/correct-today.d.ts
+interface WatchTodayOptions {
+  getVisibleDate?: () => Date;
+  getSelectedValue?: () => string | number | unknown[] | null;
+}
+declare function stripPhantomSelection(body: HTMLElement, getSelectedValue?: () => string | number | unknown[] | null | undefined): void;
+declare function correctTodayAttr(body: HTMLElement, opts?: WatchTodayOptions): void;
+declare function watchToday(body: HTMLElement, opts?: WatchTodayOptions): () => void;
+declare function clearSelectionAttrs(body: HTMLElement): void;
+//#endregion
+export { WatchTodayOptions, clearSelectionAttrs, correctTodayAttr, stripPhantomSelection, watchToday };
+//# sourceMappingURL=correct-today.d.ts.map

package/dist/src/correct-today.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correct-today.d.ts","names":[],"sources":["../../src/correct-today.ts"],"mappings":";UAAiB,iBAAA;EAKf,cAAA,SAAuB,IAAA;EAIvB,gBAAA;AAAA;AAAA,iBAWc,qBAAA,CACd,IAAA,EAAM,WAAA,EACN,gBAAA;AAAA,iBAqBc,gBAAA,CACd,IAAA,EAAM,WAAA,EACN,IAAA,GAAM,iBAAA;AAAA,iBAuCQ,UAAA,CACd,IAAA,EAAM,WAAA,EACN,IAAA,GAAM,iBAAA;AAAA,iBAwCQ,mBAAA,CAAoB,IAAA,EAAM,WAAA"}

package/dist/src/correct-today.js

@@ -0,0 +1,65 @@
+//#region src/correct-today.ts
+function hasRealSelection(val) {
+	if (val === null || val === void 0 || val === "") return false;
+	if (Array.isArray(val) && val.length === 0) return false;
+	return true;
+}
+function stripPhantomSelection(body, getSelectedValue) {
+	if (!getSelectedValue) return;
+	if (hasRealSelection(getSelectedValue())) return;
+	body.querySelectorAll(".lm-calendar-content > div[data-selected='true']").forEach((el) => el.removeAttribute("data-selected"));
+}
+function correctTodayAttr(body, opts = {}) {
+	const view = body.querySelector(".lm-calendar-container[data-view]")?.getAttribute("data-view") ?? "days";
+	stripPhantomSelection(body, opts.getSelectedValue);
+	body.querySelectorAll(".lm-calendar-content > div[data-today='true']").forEach((c) => c.removeAttribute("data-today"));
+	if (view !== "days") return;
+	const today = /* @__PURE__ */ new Date();
+	const visible = opts.getVisibleDate?.();
+	if (visible && (visible.getFullYear() !== today.getFullYear() || visible.getMonth() !== today.getMonth())) return;
+	const todayDay = String(today.getDate());
+	const match = Array.from(body.querySelectorAll(".lm-calendar-content > div")).find((el) => el.getAttribute("data-grey") !== "true" && el.textContent?.trim() === todayDay);
+	if (match) match.setAttribute("data-today", "true");
+}
+function watchToday(body, opts = {}) {
+	correctTodayAttr(body, opts);
+	let scheduled = false;
+	const run = () => {
+		if (scheduled) return;
+		scheduled = true;
+		queueMicrotask(() => {
+			scheduled = false;
+			correctTodayAttr(body, opts);
+		});
+	};
+	const observer = new MutationObserver(run);
+	observer.observe(body, {
+		childList: true,
+		subtree: true,
+		characterData: true,
+		attributes: true,
+		attributeFilter: [
+			"data-selected",
+			"data-grey",
+			"data-start",
+			"data-end",
+			"data-range",
+			"data-view"
+		]
+	});
+	return () => observer.disconnect();
+}
+function clearSelectionAttrs(body) {
+	const attrs = [
+		"data-selected",
+		"data-start",
+		"data-end",
+		"data-range",
+		"data-last"
+	];
+	body.querySelectorAll(".lm-calendar-content > div").forEach((el) => attrs.forEach((a) => el.removeAttribute(a)));
+}
+//#endregion
+export { clearSelectionAttrs, correctTodayAttr, stripPhantomSelection, watchToday };
+
+//# sourceMappingURL=correct-today.js.map

package/dist/src/correct-today.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correct-today.js","names":[],"sources":["../../src/correct-today.ts"],"sourcesContent":["export interface WatchTodayOptions {\n  // Returns the month/year currently visible in the calendar. When provided,\n  // today is only marked if it falls in that visible month. Without it we\n  // fall back to \"always mark the matching day number\", which is correct for\n  // the initial view but over-matches after navigation.\n  getVisibleDate?: () => Date;\n  // Returns the calendar's current value (what instance.getValue() returns).\n  // When empty / null, calendar.js's auto-selection of the cursor cell is\n  // phantom — nothing has actually been selected — so we strip data-selected.\n  getSelectedValue?: () => string | number | unknown[] | null;\n}\n\nfunction hasRealSelection(\n  val: string | number | unknown[] | null | undefined,\n): boolean {\n  if (val === null || val === undefined || val === \"\") return false;\n  if (Array.isArray(val) && val.length === 0) return false;\n  return true;\n}\n\nexport function stripPhantomSelection(\n  body: HTMLElement,\n  getSelectedValue?: () => string | number | unknown[] | null | undefined,\n): void {\n  if (!getSelectedValue) return;\n  if (hasRealSelection(getSelectedValue())) return;\n  body\n    .querySelectorAll<HTMLElement>(\n      \".lm-calendar-content > div[data-selected='true']\",\n    )\n    .forEach((el) => el.removeAttribute(\"data-selected\"));\n}\n\n// calendar.js has a timezone bug: its `isToday` check compares local getters\n// against a UTC-offset-adjusted Date, so in timezones offset from UTC the\n// `data-today=\"true\"` attribute lands on the wrong cell. We correct it\n// post-render by re-applying the flag to the cell whose day text matches the\n// user's local today, gated on the visible month matching local today.\n//\n// Separately, calendar.js always initializes its cursor to today and marks\n// that cell as data-selected on mount — even when nothing has been selected.\n// Strip that phantom data-selected so the cell reads as \"today (ring)\" rather\n// than \"selected (filled)\" until the user actually picks a date.\nexport function correctTodayAttr(\n  body: HTMLElement,\n  opts: WatchTodayOptions = {},\n): void {\n  const container = body.querySelector<HTMLElement>(\n    \".lm-calendar-container[data-view]\",\n  );\n  const view = container?.getAttribute(\"data-view\") ?? \"days\";\n\n  stripPhantomSelection(body, opts.getSelectedValue);\n\n  const cells = body.querySelectorAll<HTMLElement>(\n    \".lm-calendar-content > div[data-today='true']\",\n  );\n  cells.forEach((c) => c.removeAttribute(\"data-today\"));\n\n  if (view !== \"days\") return;\n\n  const today = new Date();\n  const visible = opts.getVisibleDate?.();\n  if (\n    visible &&\n    (visible.getFullYear() !== today.getFullYear() ||\n      visible.getMonth() !== today.getMonth())\n  ) {\n    return;\n  }\n\n  const todayDay = String(today.getDate());\n  const all = Array.from(\n    body.querySelectorAll<HTMLElement>(\".lm-calendar-content > div\"),\n  );\n  // data-grey=\"true\" marks leading/trailing cells (previous/next month).\n  const match = all.find(\n    (el) =>\n      el.getAttribute(\"data-grey\") !== \"true\" &&\n      el.textContent?.trim() === todayDay,\n  );\n  if (match) match.setAttribute(\"data-today\", \"true\");\n}\n\nexport function watchToday(\n  body: HTMLElement,\n  opts: WatchTodayOptions = {},\n): () => void {\n  correctTodayAttr(body, opts);\n  let scheduled = false;\n  const run = () => {\n    if (scheduled) return;\n    scheduled = true;\n    queueMicrotask(() => {\n      scheduled = false;\n      correctTodayAttr(body, opts);\n    });\n  };\n  // Observe every mutation type calendar.js performs: it re-uses the same 42\n  // day cells across month navigations, mutating text (`characterData` on the\n  // text node, or childList when a node replaces it) and bound attributes\n  // (`data-selected`, `data-grey`, etc.). Without characterData + attributes\n  // the observer misses re-renders and stale data-today / data-selected\n  // carry over to the wrong cell.\n  const observer = new MutationObserver(run);\n  observer.observe(body, {\n    childList: true,\n    subtree: true,\n    characterData: true,\n    attributes: true,\n    attributeFilter: [\n      \"data-selected\",\n      \"data-grey\",\n      \"data-start\",\n      \"data-end\",\n      \"data-range\",\n      \"data-view\",\n    ],\n  });\n  return () => observer.disconnect();\n}\n\n// calendar.js's reset() / setValue('') falls back to `new Date()` and marks\n// today as the cursor, leaving it visually \"selected\". Call this after reset\n// to strip selection/range flags from every cell so the calendar reads as\n// truly cleared.\nexport function clearSelectionAttrs(body: HTMLElement): void {\n  const attrs = [\n    \"data-selected\",\n    \"data-start\",\n    \"data-end\",\n    \"data-range\",\n    \"data-last\",\n  ];\n  const cells = body.querySelectorAll<HTMLElement>(\n    \".lm-calendar-content > div\",\n  );\n  cells.forEach((el) => attrs.forEach((a) => el.removeAttribute(a)));\n}\n"],"mappings":";AAYA,SAAS,iBACP,KACS;AACT,KAAI,QAAQ,QAAQ,QAAQ,KAAA,KAAa,QAAQ,GAAI,QAAO;AAC5D,KAAI,MAAM,QAAQ,IAAI,IAAI,IAAI,WAAW,EAAG,QAAO;AACnD,QAAO;;AAGT,SAAgB,sBACd,MACA,kBACM;AACN,KAAI,CAAC,iBAAkB;AACvB,KAAI,iBAAiB,kBAAkB,CAAC,CAAE;AAC1C,MACG,iBACC,mDACD,CACA,SAAS,OAAO,GAAG,gBAAgB,gBAAgB,CAAC;;AAazD,SAAgB,iBACd,MACA,OAA0B,EAAE,EACtB;CAIN,MAAM,OAHY,KAAK,cACrB,oCAEoB,EAAE,aAAa,YAAY,IAAI;AAErD,uBAAsB,MAAM,KAAK,iBAAiB;AAEpC,MAAK,iBACjB,gDAEG,CAAC,SAAS,MAAM,EAAE,gBAAgB,aAAa,CAAC;AAErD,KAAI,SAAS,OAAQ;CAErB,MAAM,wBAAQ,IAAI,MAAM;CACxB,MAAM,UAAU,KAAK,kBAAkB;AACvC,KACE,YACC,QAAQ,aAAa,KAAK,MAAM,aAAa,IAC5C,QAAQ,UAAU,KAAK,MAAM,UAAU,EAEzC;CAGF,MAAM,WAAW,OAAO,MAAM,SAAS,CAAC;CAKxC,MAAM,QAJM,MAAM,KAChB,KAAK,iBAA8B,6BAA6B,CAGjD,CAAC,MACf,OACC,GAAG,aAAa,YAAY,KAAK,UACjC,GAAG,aAAa,MAAM,KAAK,SAC9B;AACD,KAAI,MAAO,OAAM,aAAa,cAAc,OAAO;;AAGrD,SAAgB,WACd,MACA,OAA0B,EAAE,EAChB;AACZ,kBAAiB,MAAM,KAAK;CAC5B,IAAI,YAAY;CAChB,MAAM,YAAY;AAChB,MAAI,UAAW;AACf,cAAY;AACZ,uBAAqB;AACnB,eAAY;AACZ,oBAAiB,MAAM,KAAK;IAC5B;;CAQJ,MAAM,WAAW,IAAI,iBAAiB,IAAI;AAC1C,UAAS,QAAQ,MAAM;EACrB,WAAW;EACX,SAAS;EACT,eAAe;EACf,YAAY;EACZ,iBAAiB;GACf;GACA;GACA;GACA;GACA;GACA;GACD;EACF,CAAC;AACF,cAAa,SAAS,YAAY;;AAOpC,SAAgB,oBAAoB,MAAyB;CAC3D,MAAM,QAAQ;EACZ;EACA;EACA;EACA;EACA;EACD;AACa,MAAK,iBACjB,6BAEG,CAAC,SAAS,OAAO,MAAM,SAAS,MAAM,GAAG,gBAAgB,EAAE,CAAC,CAAC"}

package/dist/src/create-calendar.d.ts

@@ -0,0 +1,11 @@
+import { o as CalendarController, u as CalendarJsOptions } from "../types-C3oj58JZ.js";
+//#region src/create-calendar.d.ts
+/**
+ * Instantiate @calendarjs/ce against a container element and return the live
+ * instance plus a teardown helper. Intended to be called from the client only
+ * (Astro + Svelte wrappers call it after hydration).
+ */
+declare function createCalendar(element: HTMLElement, options?: CalendarJsOptions): CalendarController;
+//#endregion
+export { createCalendar };
+//# sourceMappingURL=create-calendar.d.ts.map

package/dist/src/create-calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-calendar.d.ts","names":[],"sources":["../../src/create-calendar.ts"],"mappings":";;;;AAaA;;;iBAAgB,cAAA,CACd,OAAA,EAAS,WAAA,EACT,OAAA,GAAS,iBAAA,GACR,kBAAA"}

package/dist/src/create-calendar.js

@@ -0,0 +1,25 @@
+import calendarjs from "@calendarjs/ce";
+import "@calendarjs/ce/dist/style.css";
+//#region src/create-calendar.ts
+/**
+* Instantiate @calendarjs/ce against a container element and return the live
+* instance plus a teardown helper. Intended to be called from the client only
+* (Astro + Svelte wrappers call it after hydration).
+*/
+function createCalendar(element, options = {}) {
+	const instance = calendarjs.Calendar(element, options);
+	const destroy = () => {
+		try {
+			instance.close?.();
+		} catch {}
+		while (element.firstChild) element.removeChild(element.firstChild);
+	};
+	return {
+		instance,
+		destroy
+	};
+}
+//#endregion
+export { createCalendar };
+
+//# sourceMappingURL=create-calendar.js.map

package/dist/src/create-calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-calendar.js","names":[],"sources":["../../src/create-calendar.ts"],"sourcesContent":["import calendarjs from \"@calendarjs/ce\";\nimport \"@calendarjs/ce/dist/style.css\";\nimport type {\n  CalendarController,\n  CalendarJsInstance,\n  CalendarJsOptions,\n} from \"./types.js\";\n\n/**\n * Instantiate @calendarjs/ce against a container element and return the live\n * instance plus a teardown helper. Intended to be called from the client only\n * (Astro + Svelte wrappers call it after hydration).\n */\nexport function createCalendar(\n  element: HTMLElement,\n  options: CalendarJsOptions = {},\n): CalendarController {\n  const instance = calendarjs.Calendar(\n    element,\n    options as Parameters<typeof calendarjs.Calendar>[1],\n  ) as CalendarJsInstance;\n\n  const destroy = () => {\n    try {\n      instance.close?.();\n    } catch {\n      /* ignore */\n    }\n    while (element.firstChild) {\n      element.removeChild(element.firstChild);\n    }\n  };\n\n  return { instance, destroy };\n}\n"],"mappings":";;;;;;;;AAaA,SAAgB,eACd,SACA,UAA6B,EAAE,EACX;CACpB,MAAM,WAAW,WAAW,SAC1B,SACA,QACD;CAED,MAAM,gBAAgB;AACpB,MAAI;AACF,YAAS,SAAS;UACZ;AAGR,SAAO,QAAQ,WACb,SAAQ,YAAY,QAAQ,WAAW;;AAI3C,QAAO;EAAE;EAAU;EAAS"}

package/dist/src/format-month-year.d.ts

@@ -0,0 +1,45 @@
+//#region src/format-month-year.d.ts
+/** Format the day-of-month portion (e.g. "14") of a date in the given locale. */
+declare function formatDay(date: Date, locale?: string): string;
+/** Format the month portion (e.g. "April") of a date in the given locale. */
+declare function formatMonth(date: Date, locale?: string): string;
+/** Format the year portion (e.g. "2026") of a date in the given locale. */
+declare function formatYear(date: Date, locale?: string): string;
+/** Format a date as "Month YYYY" in the given locale. */
+declare function formatMonthYear(date: Date, locale?: string): string;
+/** Add months to a date, returning a new Date (does not mutate). */
+declare function addMonths(date: Date, delta: number): Date;
+declare function toUTCDate(date?: Date): Date;
+declare function toLocalISODate(date?: Date): string;
+/**
+ * Normalized calendar selection: either nothing is selected, a single date,
+ * or a start/end range. calendar.js stores the raw selection as a string or
+ * a `[startIso, endIso]` array on `instance.value`; consumers should never
+ * have to parse that shape themselves.
+ */
+type CalendarSelection = null | {
+  kind: "single";
+  date: Date;
+} | {
+  kind: "range";
+  start: Date;
+  end: Date;
+};
+/** Format a full date like "April 14, 2026" in the given locale. */
+declare function formatFullDate(date: Date, locale?: string): string;
+/**
+ * Format a date range using Intl.DateTimeFormat.prototype.formatRange(),
+ * which natively collapses same-month / cross-month / cross-year ranges
+ * and respects the locale.
+ */
+declare function formatRange(start: Date, end: Date, locale?: string): string;
+/**
+ * Produce the selection-summary label. Returns an empty string when there
+ * is no selection — the calling component should keep a separate always-on
+ * label for navigation context (focused month/year), and render the result
+ * of this call only when it is non-empty.
+ */
+declare function formatSelection(selection: CalendarSelection, locale?: string): string;
+//#endregion
+export { CalendarSelection, addMonths, formatDay, formatFullDate, formatMonth, formatMonthYear, formatRange, formatSelection, formatYear, toLocalISODate, toUTCDate };
+//# sourceMappingURL=format-month-year.d.ts.map

package/dist/src/format-month-year.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-month-year.d.ts","names":[],"sources":["../../src/format-month-year.ts"],"mappings":";;iBACgB,SAAA,CAAU,IAAA,EAAM,IAAA,EAAM,MAAA;;iBAKtB,WAAA,CAAY,IAAA,EAAM,IAAA,EAAM,MAAA;;iBAKxB,UAAA,CAAW,IAAA,EAAM,IAAA,EAAM,MAAA;;iBAKvB,eAAA,CAAgB,IAAA,EAAM,IAAA,EAAM,MAAA;;iBAQ5B,SAAA,CAAU,IAAA,EAAM,IAAA,EAAM,KAAA,WAAgB,IAAA;AAAA,iBAUtC,SAAA,CAAU,IAAA,GAAM,IAAA,GAAoB,IAAA;AAAA,iBAUpC,cAAA,CAAe,IAAA,GAAM,IAAA;;;;;;;KAazB,iBAAA;EAEN,IAAA;EAAgB,IAAA,EAAM,IAAA;AAAA;EACtB,IAAA;EAAe,KAAA,EAAO,IAAA;EAAM,GAAA,EAAK,IAAA;AAAA;;iBAGvB,cAAA,CAAe,IAAA,EAAM,IAAA,EAAM,MAAA;AA/C3C;;;;;AAAA,iBA4DgB,WAAA,CAAY,KAAA,EAAO,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,MAAA;;;;AApDpD;;;iBAmEgB,eAAA,CACd,SAAA,EAAW,iBAAA,EACX,MAAA"}

package/dist/src/format-month-year.js

@@ -0,0 +1,67 @@
+//#region src/format-month-year.ts
+/** Format the day-of-month portion (e.g. "14") of a date in the given locale. */
+function formatDay(date, locale) {
+	return new Intl.DateTimeFormat(locale, { day: "numeric" }).format(date);
+}
+/** Format the month portion (e.g. "April") of a date in the given locale. */
+function formatMonth(date, locale) {
+	return new Intl.DateTimeFormat(locale, { month: "long" }).format(date);
+}
+/** Format the year portion (e.g. "2026") of a date in the given locale. */
+function formatYear(date, locale) {
+	return new Intl.DateTimeFormat(locale, { year: "numeric" }).format(date);
+}
+/** Format a date as "Month YYYY" in the given locale. */
+function formatMonthYear(date, locale) {
+	return new Intl.DateTimeFormat(locale, {
+		month: "long",
+		year: "numeric"
+	}).format(date);
+}
+/** Add months to a date, returning a new Date (does not mutate). */
+function addMonths(date, delta) {
+	const next = new Date(date.getTime());
+	next.setMonth(next.getMonth() + delta);
+	return next;
+}
+function toUTCDate(date = /* @__PURE__ */ new Date()) {
+	return new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+}
+function toLocalISODate(date = /* @__PURE__ */ new Date()) {
+	return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+}
+/** Format a full date like "April 14, 2026" in the given locale. */
+function formatFullDate(date, locale) {
+	return new Intl.DateTimeFormat(locale, {
+		year: "numeric",
+		month: "long",
+		day: "numeric"
+	}).format(date);
+}
+/**
+* Format a date range using Intl.DateTimeFormat.prototype.formatRange(),
+* which natively collapses same-month / cross-month / cross-year ranges
+* and respects the locale.
+*/
+function formatRange(start, end, locale) {
+	return new Intl.DateTimeFormat(locale, {
+		year: "numeric",
+		month: "long",
+		day: "numeric"
+	}).formatRange(start, end);
+}
+/**
+* Produce the selection-summary label. Returns an empty string when there
+* is no selection — the calling component should keep a separate always-on
+* label for navigation context (focused month/year), and render the result
+* of this call only when it is non-empty.
+*/
+function formatSelection(selection, locale) {
+	if (selection === null) return "";
+	if (selection.kind === "single") return formatFullDate(selection.date, locale);
+	return formatRange(selection.start, selection.end, locale);
+}
+//#endregion
+export { addMonths, formatDay, formatFullDate, formatMonth, formatMonthYear, formatRange, formatSelection, formatYear, toLocalISODate, toUTCDate };
+
+//# sourceMappingURL=format-month-year.js.map

package/dist/src/format-month-year.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-month-year.js","names":[],"sources":["../../src/format-month-year.ts"],"sourcesContent":["/** Format the day-of-month portion (e.g. \"14\") of a date in the given locale. */\nexport function formatDay(date: Date, locale?: string): string {\n  return new Intl.DateTimeFormat(locale, { day: \"numeric\" }).format(date);\n}\n\n/** Format the month portion (e.g. \"April\") of a date in the given locale. */\nexport function formatMonth(date: Date, locale?: string): string {\n  return new Intl.DateTimeFormat(locale, { month: \"long\" }).format(date);\n}\n\n/** Format the year portion (e.g. \"2026\") of a date in the given locale. */\nexport function formatYear(date: Date, locale?: string): string {\n  return new Intl.DateTimeFormat(locale, { year: \"numeric\" }).format(date);\n}\n\n/** Format a date as \"Month YYYY\" in the given locale. */\nexport function formatMonthYear(date: Date, locale?: string): string {\n  return new Intl.DateTimeFormat(locale, {\n    month: \"long\",\n    year: \"numeric\",\n  }).format(date);\n}\n\n/** Add months to a date, returning a new Date (does not mutate). */\nexport function addMonths(date: Date, delta: number): Date {\n  const next = new Date(date.getTime());\n  next.setMonth(next.getMonth() + delta);\n  return next;\n}\n\n// calendar.js reads dates via UTC getters (getUTCFullYear/Month/Date) and ISO\n// strings, so a plain `new Date()` in timezones offset from UTC can resolve to\n// the wrong calendar day. Wrap the local date into a Date whose *UTC* fields\n// match the user's local Y/M/D, so calendar.js renders the correct \"today\".\nexport function toUTCDate(date: Date = new Date()): Date {\n  return new Date(\n    Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()),\n  );\n}\n\n// calendar.js's setValue does `new Date(v + '  GMT+0')`, which stringifies a\n// Date using LOCAL time and then mis-parses it — so Date arguments land on the\n// wrong day in offset timezones. Passing an ISO date string (YYYY-MM-DD) makes\n// that concat parse cleanly as UTC midnight, giving the selection we intended.\nexport function toLocalISODate(date: Date = new Date()): string {\n  const y = date.getFullYear();\n  const m = String(date.getMonth() + 1).padStart(2, \"0\");\n  const d = String(date.getDate()).padStart(2, \"0\");\n  return `${y}-${m}-${d}`;\n}\n\n/**\n * Normalized calendar selection: either nothing is selected, a single date,\n * or a start/end range. calendar.js stores the raw selection as a string or\n * a `[startIso, endIso]` array on `instance.value`; consumers should never\n * have to parse that shape themselves.\n */\nexport type CalendarSelection =\n  | null\n  | { kind: \"single\"; date: Date }\n  | { kind: \"range\"; start: Date; end: Date };\n\n/** Format a full date like \"April 14, 2026\" in the given locale. */\nexport function formatFullDate(date: Date, locale?: string): string {\n  return new Intl.DateTimeFormat(locale, {\n    year: \"numeric\",\n    month: \"long\",\n    day: \"numeric\",\n  }).format(date);\n}\n\n/**\n * Format a date range using Intl.DateTimeFormat.prototype.formatRange(),\n * which natively collapses same-month / cross-month / cross-year ranges\n * and respects the locale.\n */\nexport function formatRange(start: Date, end: Date, locale?: string): string {\n  const formatter = new Intl.DateTimeFormat(locale, {\n    year: \"numeric\",\n    month: \"long\",\n    day: \"numeric\",\n  });\n  return formatter.formatRange(start, end);\n}\n\n/**\n * Produce the selection-summary label. Returns an empty string when there\n * is no selection — the calling component should keep a separate always-on\n * label for navigation context (focused month/year), and render the result\n * of this call only when it is non-empty.\n */\nexport function formatSelection(\n  selection: CalendarSelection,\n  locale?: string,\n): string {\n  if (selection === null) return \"\";\n  if (selection.kind === \"single\")\n    return formatFullDate(selection.date, locale);\n  return formatRange(selection.start, selection.end, locale);\n}\n"],"mappings":";;AACA,SAAgB,UAAU,MAAY,QAAyB;AAC7D,QAAO,IAAI,KAAK,eAAe,QAAQ,EAAE,KAAK,WAAW,CAAC,CAAC,OAAO,KAAK;;;AAIzE,SAAgB,YAAY,MAAY,QAAyB;AAC/D,QAAO,IAAI,KAAK,eAAe,QAAQ,EAAE,OAAO,QAAQ,CAAC,CAAC,OAAO,KAAK;;;AAIxE,SAAgB,WAAW,MAAY,QAAyB;AAC9D,QAAO,IAAI,KAAK,eAAe,QAAQ,EAAE,MAAM,WAAW,CAAC,CAAC,OAAO,KAAK;;;AAI1E,SAAgB,gBAAgB,MAAY,QAAyB;AACnE,QAAO,IAAI,KAAK,eAAe,QAAQ;EACrC,OAAO;EACP,MAAM;EACP,CAAC,CAAC,OAAO,KAAK;;;AAIjB,SAAgB,UAAU,MAAY,OAAqB;CACzD,MAAM,OAAO,IAAI,KAAK,KAAK,SAAS,CAAC;AACrC,MAAK,SAAS,KAAK,UAAU,GAAG,MAAM;AACtC,QAAO;;AAOT,SAAgB,UAAU,uBAAa,IAAI,MAAM,EAAQ;AACvD,QAAO,IAAI,KACT,KAAK,IAAI,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,CAAC,CAC9D;;AAOH,SAAgB,eAAe,uBAAa,IAAI,MAAM,EAAU;AAI9D,QAAO,GAHG,KAAK,aAGJ,CAAC,GAFF,OAAO,KAAK,UAAU,GAAG,EAAE,CAAC,SAAS,GAAG,IAElC,CAAC,GADP,OAAO,KAAK,SAAS,CAAC,CAAC,SAAS,GAAG,IACxB;;;AAevB,SAAgB,eAAe,MAAY,QAAyB;AAClE,QAAO,IAAI,KAAK,eAAe,QAAQ;EACrC,MAAM;EACN,OAAO;EACP,KAAK;EACN,CAAC,CAAC,OAAO,KAAK;;;;;;;AAQjB,SAAgB,YAAY,OAAa,KAAW,QAAyB;AAM3E,QAAO,IALe,KAAK,eAAe,QAAQ;EAChD,MAAM;EACN,OAAO;EACP,KAAK;EACN,CACe,CAAC,YAAY,OAAO,IAAI;;;;;;;;AAS1C,SAAgB,gBACd,WACA,QACQ;AACR,KAAI,cAAc,KAAM,QAAO;AAC/B,KAAI,UAAU,SAAS,SACrB,QAAO,eAAe,UAAU,MAAM,OAAO;AAC/C,QAAO,YAAY,UAAU,OAAO,UAAU,KAAK,OAAO"}

package/dist/src/mount-calendar.d.ts

@@ -0,0 +1,31 @@
+import { l as CalendarJsInstance, u as CalendarJsOptions, y as CalendarView } from "../types-C3oj58JZ.js";
+import { CalendarSelection } from "./format-month-year.js";
+
+//#region src/mount-calendar.d.ts
+interface MountCalendarOptions {
+  initialDate?: Date;
+  locale?: string;
+  calendarOptions?: CalendarJsOptions;
+  onDisplayDateChange?: (date: Date) => void;
+  onViewChange?: (view: CalendarView) => void;
+  onSelectionChange?: (selection: CalendarSelection) => void;
+}
+declare function parseSelection(raw: unknown): CalendarSelection;
+interface CalendarActions {
+  prev: () => void;
+  next: () => void;
+  today: () => void;
+  reset: () => void;
+  setView: (view: CalendarView) => void;
+}
+interface CalendarMount {
+  instance: CalendarJsInstance;
+  actions: CalendarActions;
+  getDisplayDate: () => Date;
+  getView: () => CalendarView;
+  destroy: () => void;
+}
+declare function mountCalendar(body: HTMLElement, options?: MountCalendarOptions): CalendarMount;
+//#endregion
+export { CalendarActions, CalendarMount, MountCalendarOptions, mountCalendar, parseSelection };
+//# sourceMappingURL=mount-calendar.d.ts.map

package/dist/src/mount-calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-calendar.d.ts","names":[],"sources":["../../src/mount-calendar.ts"],"mappings":";;;;UAUiB,oBAAA;EACf,WAAA,GAAc,IAAA;EACd,MAAA;EACA,eAAA,GAAkB,iBAAA;EAClB,mBAAA,IAAuB,IAAA,EAAM,IAAA;EAC7B,YAAA,IAAgB,IAAA,EAAM,YAAA;EACtB,iBAAA,IAAqB,SAAA,EAAW,iBAAA;AAAA;AAAA,iBAQlB,cAAA,CAAe,GAAA,YAAe,iBAAA;AAAA,UA+E7B,eAAA;EACf,IAAA;EACA,IAAA;EACA,KAAA;EACA,KAAA;EACA,OAAA,GAAU,IAAA,EAAM,YAAA;AAAA;AAAA,UAGD,aAAA;EACf,QAAA,EAAU,kBAAA;EACV,OAAA,EAAS,eAAA;EACT,cAAA,QAAsB,IAAA;EACtB,OAAA,QAAe,YAAA;EACf,OAAA;AAAA;AAAA,iBA+Cc,aAAA,CACd,IAAA,EAAM,WAAA,EACN,OAAA,GAAS,oBAAA,GACR,aAAA"}