@human-kit/svelte-components 1.0.0-alpha.1 → 1.0.0-alpha.2

package/dist/calendar/README.md

@@ -0,0 +1,65 @@
+# Calendar
+
+## Description
+
+`Calendar` provides single-date and range selection (ISO `YYYY-MM-DD`) with keyboard navigation, controlled/uncontrolled state, and part-based composition.
+
+## Usage Guidelines
+
+- Use `Calendar.Root` as the stateful container.
+- `selectionMode` supports `'single'` (default) and `'range'`.
+- In controlled mode, use `value` with `onChange`; in uncontrolled mode, use `defaultValue`.
+- In `single` mode, `value/defaultValue` is `YYYY-MM-DD`.
+- In `range` mode, `value/defaultValue` is `{ start?: 'YYYY-MM-DD', end?: 'YYYY-MM-DD' }`.
+- `visibleMonths` controls how many months are rendered and how paging behaves.
+- `isDateUnavailable` marks specific days as non-focusable and non-selectable.
+- Use `LocaleProvider` to localize month/day labels and first day of week.
+- Keyboard navigation uses `Arrow` keys for day/week movement and `Home/End` for month edges.
+
+## Accessibility
+
+- Each `grid` exposes an accessible name using the visible month heading.
+- Today exposes `aria-current="date"`.
+- Unavailable cells expose `aria-disabled="true"` and are neither focusable nor selectable.
+
+### Keyboard
+
+- `ArrowRight/ArrowLeft`: move focus by +/- 1 day.
+- `ArrowDown/ArrowUp`: move focus by +/- 7 days.
+- `Home/End`: move focus to first/last day of month.
+- `PageUp/PageDown`: move to previous/next month while trying to preserve day number.
+- `Enter` or `Space`: select the focused date (if selectable).
+- In `selectionMode="range"`, `Arrow/Page/Home/End` extend preview range while a range is pending.
+- In `selectionMode="range"`, `Enter` or `Space` confirm the preview when pending.
+
+## Internal Notes
+
+- `PageUp/PageDown` try to preserve the day when crossing months; if no focusable target exists in the destination month and a range is pending, focus falls back to the reachable edge in the current month (aligned with `Home/End` behavior).
+- In `selectionMode="range"`, the first click starts the range (`start`) and the second click confirms it (`end`), with automatic normalization for reversed selection order.
+- In `selectionMode="range"`, hover updates a live preview before confirmation.
+
+## Anatomy
+
+- `Calendar.Root`
+- `Calendar.TriggerPrevious`
+- `Calendar.Heading`
+- `Calendar.TriggerNext`
+- `Calendar.Grid`
+- `Calendar.GridHeader`
+- `Calendar.HeaderCell`
+- `Calendar.GridBody`
+- `Calendar.BodyCell`
+
+```svelte
+<LocaleProvider locale="es-ES">
+	<Calendar.Root>
+		<Calendar.TriggerPrevious />
+		<Calendar.Heading />
+		<Calendar.TriggerNext />
+		<Calendar.Grid>
+			<Calendar.GridHeader />
+			<Calendar.GridBody />
+		</Calendar.Grid>
+	</Calendar.Root>
+</LocaleProvider>
+```

package/dist/calendar/TODO.md

@@ -0,0 +1,109 @@
+# Calendar TODO
+
+## MVP v1
+
+- [x] Controlled/uncontrolled root (`value`, `defaultValue`, `onChange`)
+- [x] Paginated navigation via `visibleMonths`
+- [x] Single-date selection
+- [x] `isDisabled`, `isReadOnly`, `isDateUnavailable` states
+- [x] Keyboard-accessible grid (baseline)
+- [x] Exports + docs page + initial tests
+
+## Future
+
+- [x] Range selection
+- [ ] Multi-select
+- [ ] Non-Gregorian calendar configuration
+- [ ] Advanced unavailable API (ranges/collections)
+
+### Advanced unavailable API (details)
+
+Goal: evolve from `isDateUnavailable?: (date) => boolean` to an expressive, composable, and performant API for blocking dates in real-world scenarios.
+
+#### 1) Functional requirements
+
+- [ ] Keep compatibility with the current `isDateUnavailable`.
+- [ ] Support `Set` of specific dates (`YYYY-MM-DD`) with O(1) lookup.
+- [ ] Support closed ranges `{ start, end }`.
+- [ ] Support recurring rules (for example: weekends, weekdays, dayOfWeek, dayOfMonth).
+- [ ] Support rule composition:
+  - [ ] `anyOf` (OR)
+  - [ ] `allOf` (AND)
+  - [ ] `except` (subtract dates/ranges)
+- [ ] Support combined usage (function + set + ranges + recurring rules).
+
+#### 2) Public API proposal
+
+- [ ] Add optional `unavailable` prop in `Calendar.Root`.
+- [ ] Base type design:
+  - [ ] `CalendarDateSet = Set<CalendarDateValue> | CalendarDateValue[]`
+  - [ ] `CalendarDateRange = { start: CalendarDateValue; end: CalendarDateValue }`
+  - [ ] `CalendarRecurringRule`
+  - [ ] `CalendarUnavailableRule = CalendarDateSet | CalendarDateRange | CalendarRecurringRule | ((date) => boolean)`
+  - [ ] `CalendarUnavailableConfig = CalendarUnavailableRule | { anyOf?: ...; allOf?: ...; except?: ... }`
+- [ ] Document precedence rules:
+  - [ ] `except` first
+  - [ ] then `allOf`
+  - [ ] then `anyOf`
+  - [ ] fallback to `false`
+- [ ] Clearly define how `unavailable` coexists with `isDateUnavailable` (for example: final OR for backward compatibility).
+
+#### 3) Validation and normalization
+
+- [ ] Validate invalid dates and reversed ranges in a robust way.
+- [ ] Normalize ranges (`start <= end`).
+- [ ] Silently ignore invalid entries or expose a dev warning (decide strategy).
+- [ ] Avoid runtime throws for partial input; prefer tolerant behavior.
+
+#### 4) Performance and caching
+
+- [ ] Compile `unavailable` to an internal predicate once per config change.
+- [ ] Cache results per visible date (`Map<CalendarDateValue, boolean>`).
+- [ ] Invalidate cache only when these change:
+  - [ ] locale
+  - [ ] visibleMonths
+  - [ ] `isDateUnavailable`
+  - [ ] `unavailable`
+- [ ] Avoid expensive recomputation during pending range selection.
+- [ ] Keep low complexity in `isDateDisabled` (prefer amortized O(1)).
+
+#### 5) Range mode integration
+
+- [ ] `isRangePathSelectable` must use the same unavailable source of truth.
+- [ ] If `except` exists, ensure endpoints and intermediate days follow the final composed rule.
+- [ ] Keep mouse hover preview and keyboard preview consistent.
+
+#### 6) Testing
+
+- [ ] Unit tests for unavailable parser/normalizer.
+- [ ] Compatibility tests with legacy `isDateUnavailable`.
+- [ ] Tests by type:
+  - [ ] date sets
+  - [ ] ranges
+  - [ ] recurring rules
+  - [ ] `anyOf`/`allOf`/`except` composition
+- [ ] Interaction tests (click/keyboard/range preview/confirm/cancel).
+- [ ] Performance tests (no unnecessary recomputation during selection and focus).
+
+#### 7) Documentation
+
+- [ ] Calendar README section for "Advanced unavailable".
+- [ ] Usage examples:
+  - [ ] block weekends
+  - [ ] block holidays (set)
+  - [ ] blackout by range
+  - [ ] composition with exceptions
+- [ ] Migration notes from current `isDateUnavailable`.
+
+#### 8) Demo
+
+- [ ] Extend docs demo with unavailable strategy selector.
+- [ ] Show derived state (active rule + visible blocked dates).
+- [ ] Include composition example (`anyOf` + `except`).
+
+#### 9) Completion criteria
+
+- [ ] `bun typecheck` passes without errors.
+- [ ] Calendar test suite is green.
+- [ ] Backward compatibility is verified.
+- [ ] API is documented with real examples.

package/dist/calendar/body-cell/calendar-body-cell.svelte

@@ -0,0 +1,155 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import type { HTMLAttributes } from 'svelte/elements';
+	import { useCalendarContext } from '../root/context';
+	import { getCalendarMonthIndex } from '../grid/month-scope';
+	import { formatCalendarDate, getTodayUtcDate, parseCalendarDate } from '../root/date-utils';
+
+	type CalendarBodyCellProps = Omit<HTMLAttributes<HTMLTableCellElement>, 'children'> & {
+		date: string;
+		children?: Snippet<[string]>;
+	};
+
+	let { date, children, class: className = '', ...restProps }: CalendarBodyCellProps = $props();
+
+	const calendar = useCalendarContext();
+	const layoutVersion = calendar.layoutVersion;
+	const selectionVersion = calendar.selectionVersion;
+	const monthIndex = getCalendarMonthIndex();
+
+	const parsedDate = $derived(parseCalendarDate(date));
+	const dayLabel = $derived(parsedDate ? String(parsedDate.getUTCDate()) : '');
+	const isSelected = $derived.by(() => {
+		void $layoutVersion;
+		void $selectionVersion;
+		if (calendar.isDisabled || calendar.isReadOnly) return false;
+		return calendar.isSelected(date);
+	});
+	const isRangeStart = $derived.by(() => {
+		void $layoutVersion;
+		void $selectionVersion;
+		if (calendar.isDisabled || calendar.isReadOnly) return false;
+		return calendar.isRangeStart(date);
+	});
+	const isRangeEnd = $derived.by(() => {
+		void $layoutVersion;
+		void $selectionVersion;
+		if (calendar.isDisabled || calendar.isReadOnly) return false;
+		return calendar.isRangeEnd(date);
+	});
+	const isInRange = $derived.by(() => {
+		void $layoutVersion;
+		void $selectionVersion;
+		if (calendar.isDisabled || calendar.isReadOnly) return false;
+		return calendar.isInRange(date);
+	});
+	const isFocused = $derived.by(() => {
+		void $selectionVersion;
+		return calendar.focusedValue === date;
+	});
+	const isDisabled = $derived.by(() => {
+		void $layoutVersion;
+		void $selectionVersion;
+		return calendar.isDateDisabled(date);
+	});
+	const isUnavailable = $derived.by(() => {
+		void $layoutVersion;
+		return calendar.isDateUnavailable(date);
+	});
+	const isOutsideMonth = $derived.by(() => {
+		void $layoutVersion;
+		return calendar.isOutsideVisibleRange(date, monthIndex);
+	});
+	const todayDate = formatCalendarDate(getTodayUtcDate());
+	const isToday = $derived(date === todayDate);
+
+	let gridCellElement: HTMLDivElement | undefined;
+
+	$effect(() => {
+		if (!isFocused || isDisabled) return;
+		if (!gridCellElement) return;
+		if (document.activeElement === gridCellElement) return;
+		gridCellElement.focus();
+	});
+
+	$effect(() => {
+		if (!isDisabled) return;
+		if (!gridCellElement) return;
+		if (document.activeElement !== gridCellElement) return;
+		gridCellElement.blur();
+	});
+
+	function handleClick() {
+		if (isDisabled) return;
+		calendar.setFocusedValue(date);
+		calendar.selectDate(date);
+	}
+
+	function handleFocus() {
+		if (isDisabled) return;
+		calendar.setFocusedValue(date);
+	}
+
+	function handleMousedown(event: MouseEvent) {
+		if (!isDisabled) return;
+		event.preventDefault();
+	}
+
+	function handleMouseenter() {
+		if (isDisabled) return;
+		calendar.setHoveredValue(date);
+	}
+
+	function handleMouseleave() {
+		if (isDisabled) return;
+		calendar.setHoveredValue(undefined);
+	}
+
+	function handleKeydown(event: KeyboardEvent) {
+		calendar.handleCellKeydown(event, date);
+	}
+</script>
+
+<td
+	role="presentation"
+	data-selected={isSelected || undefined}
+	data-focused={isFocused || undefined}
+	data-disabled={isDisabled || undefined}
+	data-unavailable={isUnavailable || undefined}
+	data-outside-month={isOutsideMonth || undefined}
+	data-range-start={isRangeStart || undefined}
+	data-range-end={isRangeEnd || undefined}
+	data-in-range={isInRange || undefined}
+	{...restProps}
+>
+	<div
+		bind:this={gridCellElement}
+		class={className}
+		role="gridcell"
+		tabindex={isDisabled ? -1 : isFocused ? 0 : -1}
+		data-selected={isSelected || undefined}
+		data-focused={isFocused || undefined}
+		data-disabled={isDisabled || undefined}
+		data-unavailable={isUnavailable || undefined}
+		data-outside-month={isOutsideMonth || undefined}
+		data-range-start={isRangeStart || undefined}
+		data-range-end={isRangeEnd || undefined}
+		data-in-range={isInRange || undefined}
+		aria-selected={isSelected}
+		aria-disabled={isDisabled || undefined}
+		aria-current={isToday ? 'date' : undefined}
+		aria-label={date}
+		onmousedown={handleMousedown}
+		onmouseenter={handleMouseenter}
+		onmouseleave={handleMouseleave}
+		onclick={handleClick}
+		onfocus={handleFocus}
+		onkeydown={handleKeydown}
+	>
+		{#if children}
+			{@render children(date)}
+		{:else}
+			{dayLabel}
+		{/if}
+	</div>
+</td>

package/dist/calendar/body-cell/calendar-body-cell.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+type CalendarBodyCellProps = Omit<HTMLAttributes<HTMLTableCellElement>, 'children'> & {
+    date: string;
+    children?: Snippet<[string]>;
+};
+declare const CalendarBodyCell: import("svelte").Component<CalendarBodyCellProps, {}, "">;
+type CalendarBodyCell = ReturnType<typeof CalendarBodyCell>;
+export default CalendarBodyCell;

package/dist/calendar/grid/calendar-grid-month-scope.svelte

@@ -0,0 +1,16 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import { setCalendarMonthIndex } from './month-scope';
+
+	type CalendarGridMonthScopeProps = {
+		monthIndex: number;
+		children?: Snippet;
+	};
+
+	const props: CalendarGridMonthScopeProps = $props();
+	setCalendarMonthIndex(props.monthIndex);
+</script>
+
+{#if props.children}
+	{@render props.children()}
+{/if}

package/dist/calendar/grid/calendar-grid-month-scope.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { Snippet } from 'svelte';
+type CalendarGridMonthScopeProps = {
+    monthIndex: number;
+    children?: Snippet;
+};
+declare const CalendarGridMonthScope: import("svelte").Component<CalendarGridMonthScopeProps, {}, "">;
+type CalendarGridMonthScope = ReturnType<typeof CalendarGridMonthScope>;
+export default CalendarGridMonthScope;

package/dist/calendar/grid/calendar-grid.svelte

@@ -0,0 +1,45 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import { useCalendarContext } from '../root/context';
+	import CalendarGridMonthScope from './calendar-grid-month-scope.svelte';
+
+	type CalendarGridProps = {
+		children?: Snippet;
+		class?: string;
+	};
+
+	let { children, class: className = '' }: CalendarGridProps = $props();
+	const calendar = useCalendarContext();
+	const layoutVersion = calendar.layoutVersion;
+	const months = $derived.by(() => {
+		void $layoutVersion;
+		return calendar.months;
+	});
+	const selectionMode = $derived.by(() => {
+		void $layoutVersion;
+		return calendar.selectionMode;
+	});
+	const isReadOnly = $derived.by(() => {
+		void $layoutVersion;
+		return calendar.isReadOnly;
+	});
+</script>
+
+<div class={className} data-calendar-grid>
+	{#each months as month (month.monthIndex)}
+		<div role="group" aria-label={month.heading} data-calendar-month={month.monthIndex}>
+			<CalendarGridMonthScope monthIndex={month.monthIndex}>
+				<table
+					role="grid"
+					aria-label={month.heading}
+					aria-readonly={isReadOnly || undefined}
+					aria-multiselectable={selectionMode === 'range' ? true : undefined}
+				>
+					{#if children}
+						{@render children()}
+					{/if}
+				</table>
+			</CalendarGridMonthScope>
+		</div>
+	{/each}
+</div>

package/dist/calendar/grid/calendar-grid.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { Snippet } from 'svelte';
+type CalendarGridProps = {
+    children?: Snippet;
+    class?: string;
+};
+declare const CalendarGrid: import("svelte").Component<CalendarGridProps, {}, "">;
+type CalendarGrid = ReturnType<typeof CalendarGrid>;
+export default CalendarGrid;

package/dist/calendar/grid/month-scope.d.ts

@@ -0,0 +1,2 @@
+export declare function setCalendarMonthIndex(monthIndex: number): void;
+export declare function getCalendarMonthIndex(): number;

package/dist/calendar/grid/month-scope.js

@@ -0,0 +1,8 @@
+import { getContext, setContext } from 'svelte';
+const MONTH_SCOPE_KEY = Symbol('calendar-month-scope');
+export function setCalendarMonthIndex(monthIndex) {
+    setContext(MONTH_SCOPE_KEY, monthIndex);
+}
+export function getCalendarMonthIndex() {
+    return getContext(MONTH_SCOPE_KEY) ?? 0;
+}

package/dist/calendar/grid-body/calendar-grid-body-custom-test.svelte

@@ -0,0 +1,13 @@
+<script lang="ts">
+	import Calendar from '../index';
+</script>
+
+<Calendar.Root defaultValue="2026-02-10" aria-label="Body custom test">
+	<Calendar.Grid>
+		<Calendar.GridBody>
+			{#snippet children(date)}
+				<Calendar.BodyCell {date}>{date}</Calendar.BodyCell>
+			{/snippet}
+		</Calendar.GridBody>
+	</Calendar.Grid>
+</Calendar.Root>

package/dist/calendar/grid-body/calendar-grid-body-custom-test.svelte.d.ts

@@ -0,0 +1,18 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const CalendarGridBodyCustomTest: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type CalendarGridBodyCustomTest = InstanceType<typeof CalendarGridBodyCustomTest>;
+export default CalendarGridBodyCustomTest;

package/dist/calendar/grid-body/calendar-grid-body.svelte

@@ -0,0 +1,36 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import { useCalendarContext } from '../root/context';
+	import { getCalendarMonthIndex } from '../grid/month-scope';
+	import CalendarBodyCell from '../body-cell/calendar-body-cell.svelte';
+
+	type CalendarGridBodyProps = {
+		children?: Snippet<[string]>;
+		class?: string;
+	};
+
+	let { children, class: className = '' }: CalendarGridBodyProps = $props();
+
+	const calendar = useCalendarContext();
+	const layoutVersion = calendar.layoutVersion;
+	const monthIndex = getCalendarMonthIndex();
+	const month = $derived.by(() => {
+		void $layoutVersion;
+		return calendar.months[monthIndex];
+	});
+	const weeks = $derived(month?.weeks ?? []);
+</script>
+
+<tbody class={className}>
+	{#each weeks as week, weekIndex (weekIndex)}
+		<tr data-week={weekIndex}>
+			{#each week as day (day.date)}
+				{#if children}
+					{@render children(day.date)}
+				{:else}
+					<CalendarBodyCell date={day.date} />
+				{/if}
+			{/each}
+		</tr>
+	{/each}
+</tbody>

package/dist/calendar/grid-body/calendar-grid-body.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { Snippet } from 'svelte';
+type CalendarGridBodyProps = {
+    children?: Snippet<[string]>;
+    class?: string;
+};
+declare const CalendarGridBody: import("svelte").Component<CalendarGridBodyProps, {}, "">;
+type CalendarGridBody = ReturnType<typeof CalendarGridBody>;
+export default CalendarGridBody;

package/dist/calendar/grid-header/calendar-grid-header-custom-test.svelte

@@ -0,0 +1,13 @@
+<script lang="ts">
+	import Calendar from '../index';
+</script>
+
+<Calendar.Root defaultValue="2026-02-10" aria-label="Header custom test">
+	<Calendar.Grid>
+		<Calendar.GridHeader>
+			{#snippet children(day)}
+				<Calendar.HeaderCell>DAY-{day}</Calendar.HeaderCell>
+			{/snippet}
+		</Calendar.GridHeader>
+	</Calendar.Grid>
+</Calendar.Root>

package/dist/calendar/grid-header/calendar-grid-header-custom-test.svelte.d.ts

@@ -0,0 +1,18 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const CalendarGridHeaderCustomTest: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type CalendarGridHeaderCustomTest = InstanceType<typeof CalendarGridHeaderCustomTest>;
+export default CalendarGridHeaderCustomTest;

package/dist/calendar/grid-header/calendar-grid-header.svelte

@@ -0,0 +1,31 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import { useCalendarContext } from '../root/context';
+	import CalendarHeaderCell from '../header-cell/calendar-header-cell.svelte';
+
+	type CalendarGridHeaderProps = {
+		children?: Snippet<[string]>;
+		class?: string;
+	};
+
+	let { children, class: className = '' }: CalendarGridHeaderProps = $props();
+
+	const calendar = useCalendarContext();
+	const layoutVersion = calendar.layoutVersion;
+	const weekdays = $derived.by(() => {
+		void $layoutVersion;
+		return calendar.weekdayLabels;
+	});
+</script>
+
+<thead class={className}>
+	<tr>
+		{#each weekdays as day (day)}
+			{#if children}
+				{@render children(day)}
+			{:else}
+				<CalendarHeaderCell>{day}</CalendarHeaderCell>
+			{/if}
+		{/each}
+	</tr>
+</thead>

package/dist/calendar/grid-header/calendar-grid-header.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { Snippet } from 'svelte';
+type CalendarGridHeaderProps = {
+    children?: Snippet<[string]>;
+    class?: string;
+};
+declare const CalendarGridHeader: import("svelte").Component<CalendarGridHeaderProps, {}, "">;
+type CalendarGridHeader = ReturnType<typeof CalendarGridHeader>;
+export default CalendarGridHeader;

package/dist/calendar/header-cell/calendar-header-cell-test.svelte

@@ -0,0 +1,11 @@
+<script lang="ts">
+	import Calendar from '../index';
+</script>
+
+<table>
+	<thead>
+		<tr>
+			<Calendar.HeaderCell>Mon</Calendar.HeaderCell>
+		</tr>
+	</thead>
+</table>

package/dist/calendar/header-cell/calendar-header-cell-test.svelte.d.ts

@@ -0,0 +1,18 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const CalendarHeaderCellTest: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type CalendarHeaderCellTest = InstanceType<typeof CalendarHeaderCellTest>;
+export default CalendarHeaderCellTest;

package/dist/calendar/header-cell/calendar-header-cell.svelte

@@ -0,0 +1,16 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import type { HTMLAttributes } from 'svelte/elements';
+
+	type CalendarHeaderCellProps = Omit<HTMLAttributes<HTMLTableCellElement>, 'children'> & {
+		children?: Snippet;
+	};
+
+	let { children, class: className = '', ...restProps }: CalendarHeaderCellProps = $props();
+</script>
+
+<th role="columnheader" class={className} {...restProps}>
+	{#if children}
+		{@render children()}
+	{/if}
+</th>

package/dist/calendar/header-cell/calendar-header-cell.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+type CalendarHeaderCellProps = Omit<HTMLAttributes<HTMLTableCellElement>, 'children'> & {
+    children?: Snippet;
+};
+declare const CalendarHeaderCell: import("svelte").Component<CalendarHeaderCellProps, {}, "">;
+type CalendarHeaderCell = ReturnType<typeof CalendarHeaderCell>;
+export default CalendarHeaderCell;

package/dist/calendar/heading/calendar-heading.svelte

@@ -0,0 +1,17 @@
+<script lang="ts">
+	import type { HTMLAttributes } from 'svelte/elements';
+	import { useCalendarContext } from '../root/context';
+
+	type CalendarHeadingProps = Omit<HTMLAttributes<HTMLHeadingElement>, 'children'>;
+
+	let { class: className = '', ...restProps }: CalendarHeadingProps = $props();
+
+	const calendar = useCalendarContext();
+	const layoutVersion = calendar.layoutVersion;
+	const heading = $derived.by(() => {
+		void $layoutVersion;
+		return calendar.headingLabel;
+	});
+</script>
+
+<h2 class={className} aria-live="polite" {...restProps}>{heading}</h2>