@r2digisolutions/components 0.8.3 → 0.8.5

package/dist/components/molecules/Calendar/Calendar.svelte

@@ -29,6 +29,8 @@
 		dots?: CalendarDot[];
 		/** Show border/shadow chrome. */
 		framed?: boolean;
+		/** BCP 47 locale for weekday and month names. */
+		locale?: string;
 		class?: string;
 		onchange?: (detail: {
 			mode: CalendarMode;
@@ -52,6 +54,7 @@
 		enabledDates,
 		dots = [],
 		framed = true,
+		locale = 'en',
 		class: className = '',
 		onchange
 	}: CalendarProps = $props();
@@ -64,9 +67,15 @@
 	/** Which month column owns the month/year picker when months=2. */
 	let pickerOffset = $state(0);
 
-	const weekDays = ['Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su'];
-	const monthNames = Array.from({ length: 12 }, (_, i) =>
-		new Date(2000, i, 1).toLocaleString('en', { month: 'short' })
+	const weekDays = $derived(
+		Array.from({ length: 7 }, (_, i) =>
+			new Date(2024, 0, 1 + i).toLocaleDateString(locale, { weekday: 'short' })
+		)
+	);
+	const monthNames = $derived(
+		Array.from({ length: 12 }, (_, i) =>
+			new Date(2000, i, 1).toLocaleString(locale, { month: 'short' })
+		)
 	);
 
 	const viewYear = $derived(view.getFullYear());
@@ -253,7 +262,7 @@
 		const isToday = iso === todayIso;
 
 		return [
-			'relative flex aspect-square min-h-9 items-center justify-center rounded-lg text-sm transition-colors',
+			'relative flex size-9 items-center justify-center rounded-lg text-sm transition-colors',
 			'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand-500/30',
 			disabled && 'cursor-not-allowed opacity-30',
 			!disabled && !selected && !mid && 'text-primary hover:bg-surface-overlay',
@@ -294,7 +303,7 @@
 		'max-w-full bg-surface-elevated',
 		framed && 'rounded-2xl border border-border p-3 shadow-sm',
 		!framed && 'p-0.5',
-		dual && panel === 'days' ? 'w-fit' : framed ? 'w-80' : 'w-full',
+		dual && panel === 'days' ? 'w-fit' : 'w-80',
 		className
 	]}
 >
@@ -360,7 +369,7 @@
 					<div class="grid grid-cols-7 gap-1.5">
 						{#each grid.cells as cell, i (cell.date || `e-${grid.offset}-${i}`)}
 							{#if !cell.inMonth}
-								<span class="aspect-square min-h-9"></span>
+								<span class="size-9"></span>
 							{:else}
 								{@const color = dotMap.get(cell.date)}
 								<button

package/dist/components/molecules/Calendar/Calendar.svelte.d.ts

@@ -27,6 +27,8 @@ interface CalendarProps {
     dots?: CalendarDot[];
     /** Show border/shadow chrome. */
     framed?: boolean;
+    /** BCP 47 locale for weekday and month names. */
+    locale?: string;
     class?: string;
     onchange?: (detail: {
         mode: CalendarMode;

package/dist/components/molecules/DatePicker/DatePicker.svelte

@@ -1,8 +1,12 @@
 <script lang="ts">
+	import { on } from 'svelte/events';
 	import Calendar, {
 		type CalendarDot,
 		type CalendarMode
 	} from '../Calendar/Calendar.svelte';
+	import { i18n } from '../../../utils/i18n.svelte.js';
+	import { resolveLocaleTag } from '../../../utils/i18n.js';
+	import { createId } from '../../../utils/id.js';
 
 	export type DatePickerPlacement =
 		| 'auto'
@@ -43,6 +47,8 @@
 		 * alignment from available viewport space.
 		 */
 		placement?: DatePickerPlacement;
+		/** BCP 47 locale for displayed dates. Defaults to the components i18n locale. */
+		locale?: string;
 		class?: string;
 		onchange?: (detail: {
 			mode: CalendarMode;
@@ -76,25 +82,30 @@
 		variant = 'field',
 		closeOnSelect = true,
 		placement = 'auto',
+		locale,
 		class: className = '',
 		onchange
 	}: DatePickerProps = $props();
 
-	let rootEl = $state<HTMLDivElement | null>(null);
+	const dateLocale = $derived(locale || resolveLocaleTag(i18n.locale));
+
+	let triggerEl = $state<HTMLElement | null>(null);
 	let panelEl = $state<HTMLDivElement | null>(null);
+	let panelStyle = $state('margin:0;inset:auto;');
 	let activeField = $state<'start' | 'end' | 'value'>('value');
-	let resolved = $state<{ side: 'top' | 'bottom'; align: 'start' | 'center' | 'end' | 'stretch' }>({
-		side: 'bottom',
-		align: months === 1 ? 'stretch' : 'center'
+	let panelId = $state('');
+
+	$effect(() => {
+		panelId ||= createId('datepicker');
 	});
 
 	function formatIso(iso: string) {
 		if (!iso) return '';
 		const [y, m, d] = iso.split('-').map(Number);
 		const date = new Date(y, m - 1, d);
-		return date.toLocaleDateString('en', {
-			month: 'short',
+		return date.toLocaleDateString(dateLocale, {
 			day: 'numeric',
+			month: 'short',
 			year: 'numeric'
 		});
 	}
@@ -114,100 +125,114 @@
 	function parsePlacement(p: DatePickerPlacement) {
 		if (p === 'auto') return null;
 		const [side, align] = p.split('-') as ['top' | 'bottom', 'start' | 'center' | 'end' | undefined];
-		return {
-			side,
-			align: (align ?? (months === 1 ? 'stretch' : 'center')) as
-				| 'start'
-				| 'center'
-				| 'end'
-				| 'stretch'
-		};
+		return { side, align: align ?? (months === 2 ? 'center' : 'start') };
 	}
 
-	function updatePlacement() {
-		if (!rootEl || !panelEl) return;
+	function positionPanel() {
+		if (!triggerEl || !panelEl) return;
+		if (!panelEl.matches(':popover-open')) return;
 
-		const fixed = parsePlacement(placement);
-		if (fixed) {
-			resolved = {
-				side: fixed.side,
-				align: months === 1 && fixed.align === 'center' ? 'stretch' : fixed.align
-			};
-			return;
-		}
+		const trigger = triggerEl.getBoundingClientRect();
+		if (trigger.width < 2 && trigger.height < 2) return;
 
-		const trigger = rootEl.getBoundingClientRect();
-		const panel = panelEl.getBoundingClientRect();
+		const vv = window.visualViewport;
+		const viewW = vv?.width ?? window.innerWidth;
+		const viewH = vv?.height ?? window.innerHeight;
+		const viewLeft = vv?.offsetLeft ?? 0;
+		const viewTop = vv?.offsetTop ?? 0;
 		const gap = 8;
-		const vw = window.innerWidth;
-		const vh = window.innerHeight;
-
-		const spaceBelow = vh - trigger.bottom - gap;
-		const spaceAbove = trigger.top - gap;
-		const side: 'top' | 'bottom' =
-			spaceBelow < panel.height && spaceAbove > spaceBelow ? 'top' : 'bottom';
-
-		let align: 'start' | 'center' | 'end' | 'stretch' = months === 1 ? 'stretch' : 'center';
-
-		if (months === 2 || align !== 'stretch') {
-			const centerLeft = trigger.left + trigger.width / 2 - panel.width / 2;
-			const startLeft = trigger.left;
-			const endLeft = trigger.right - panel.width;
-
-			const fits = (left: number) => left >= gap && left + panel.width <= vw - gap;
-
-			if (fits(centerLeft)) align = 'center';
-			else if (fits(startLeft)) align = 'start';
-			else if (fits(endLeft)) align = 'end';
-			else {
-				// pick least overflow
-				const overflows = [
-					{ align: 'center' as const, overflow: Math.max(0, -centerLeft) + Math.max(0, centerLeft + panel.width - vw) },
-					{ align: 'start' as const, overflow: Math.max(0, -startLeft) + Math.max(0, startLeft + panel.width - vw) },
-					{ align: 'end' as const, overflow: Math.max(0, -endLeft) + Math.max(0, endLeft + panel.width - vw) }
-				];
-				overflows.sort((a, b) => a.overflow - b.overflow);
-				align = overflows[0].align;
-			}
+		const pad = 8;
+
+		const panelW = Math.min(panelEl.offsetWidth || 320, viewW - pad * 2);
+		const panelH = Math.min(panelEl.offsetHeight || 360, 420);
+
+		const fixed = parsePlacement(placement);
+		let side: 'top' | 'bottom' = fixed?.side ?? 'bottom';
+		if (!fixed) {
+			const spaceBelow = viewTop + viewH - trigger.bottom - gap - pad;
+			const spaceAbove = trigger.top - viewTop - gap - pad;
+			if (spaceBelow < panelH && spaceAbove > spaceBelow) side = 'top';
 		}
 
-		resolved = { side, align };
+		const align = fixed?.align ?? (months === 2 ? 'center' : 'start');
+
+		let top = side === 'bottom' ? trigger.bottom + gap : trigger.top - panelH - gap;
+		let left =
+			align === 'end'
+				? trigger.right - panelW
+				: align === 'center'
+					? trigger.left + trigger.width / 2 - panelW / 2
+					: trigger.left;
+
+		left = Math.min(Math.max(viewLeft + pad, left), viewLeft + viewW - panelW - pad);
+		top = Math.min(Math.max(viewTop + pad, top), viewTop + viewH - panelH - pad);
+
+		panelStyle = [
+			'margin:0',
+			'inset:auto',
+			`top:${Math.round(top)}px`,
+			`left:${Math.round(left)}px`,
+			'right:auto',
+			'bottom:auto',
+			'width:max-content'
+		].join(';');
+	}
+
+	function schedulePosition() {
+		queueMicrotask(() => {
+			positionPanel();
+			requestAnimationFrame(() => {
+				positionPanel();
+				requestAnimationFrame(positionPanel);
+			});
+		});
 	}
 
-	$effect(() => {
-		if (!open) return;
-		const id = requestAnimationFrame(() => updatePlacement());
-		const onWin = () => updatePlacement();
-		window.addEventListener('resize', onWin);
-		window.addEventListener('scroll', onWin, true);
-		return () => {
-			cancelAnimationFrame(id);
-			window.removeEventListener('resize', onWin);
-			window.removeEventListener('scroll', onWin, true);
-		};
-	});
+	function syncNative() {
+		if (!panelEl) return;
+		const isOpen = panelEl.matches(':popover-open');
+		try {
+			if (open && !isOpen) panelEl.showPopover();
+			else if (!open && isOpen) panelEl.hidePopover();
+		} catch {
+			/* ignore */
+		}
+	}
 
 	function setOpen(next: boolean) {
-		if (disabled) return;
+		if (disabled && next) return;
 		open = next;
 	}
 
-	function openField(field: 'start' | 'end' | 'value') {
-		if (disabled) return;
-		activeField = field;
-		open = true;
+	function handleBeforeToggle(event: ToggleEvent) {
+		if (event.newState === 'open' && disabled) {
+			event.preventDefault();
+		}
 	}
 
-	function onDocPointerDown(e: PointerEvent) {
-		if (!open || !rootEl) return;
-		const path = typeof e.composedPath === 'function' ? e.composedPath() : [];
-		if (path.includes(rootEl) || rootEl.contains(e.target as Node)) return;
-		setOpen(false);
+	function handleToggle(event: ToggleEvent) {
+		const next = event.newState === 'open';
+		open = next;
+		if (next) schedulePosition();
 	}
 
-	function onKey(e: KeyboardEvent) {
-		if (e.key === 'Escape' && open) setOpen(false);
-	}
+	$effect(() => {
+		open;
+		queueMicrotask(() => {
+			syncNative();
+			if (open) positionPanel();
+		});
+	});
+
+	$effect(() => {
+		if (!open) return;
+		const offResize = on(window, 'resize', () => positionPanel());
+		const offScroll = on(window, 'scroll', () => positionPanel(), { capture: true });
+		return () => {
+			offResize();
+			offScroll();
+		};
+	});
 
 	function handleChange(detail: {
 		mode: CalendarMode;
@@ -241,46 +266,21 @@
 	}
 
 	const hasValue = $derived(
-		mode === 'single'
-			? !!value
-			: mode === 'multiple'
-				? values.length > 0
-				: !!(start || end)
+		mode === 'single' ? !!value : mode === 'multiple' ? values.length > 0 : !!(start || end)
 	);
 
-	const panelClass = $derived.by(() => {
-		const { side, align } = resolved;
-		const vertical =
-			side === 'bottom' ? 'top-full mt-2' : 'bottom-full mb-2';
-
-		const horizontal =
-			align === 'stretch'
-				? 'left-0 right-0'
-				: align === 'center'
-					? 'left-1/2 -translate-x-1/2'
-					: align === 'end'
-						? 'right-0'
-						: 'left-0';
-
-		return [
-			'absolute z-50 rounded-2xl border border-border bg-surface-elevated p-2 shadow-xl',
-			vertical,
-			horizontal,
-			months === 2 && align !== 'stretch' ? 'w-max max-w-[min(100vw-1rem,42rem)]' : '',
-			months === 1 || align === 'stretch' ? 'w-auto' : ''
-		];
-	});
+	const triggerAction = $derived(variant === 'split' ? 'show' : 'toggle');
 </script>
 
-<svelte:document onpointerdown={onDocPointerDown} onkeydown={onKey} />
-
 <div
 	class={[
-		'relative',
-		months === 2 ? 'w-full max-w-xl' : 'w-full min-w-[18rem] max-w-[20rem]',
+		variant === 'split'
+			? 'w-full'
+			: months === 2
+				? 'w-full max-w-xl'
+				: 'w-full min-w-[18rem] max-w-[20rem]',
 		className
 	]}
-	bind:this={rootEl}
 >
 	{#if label && variant === 'field'}
 		<span class="mb-1.5 block text-sm font-medium text-primary">{label}</span>
@@ -288,6 +288,7 @@
 
 	{#if variant === 'split' && mode === 'range'}
 		<div
+			bind:this={triggerEl}
 			class={[
 				'flex overflow-hidden rounded-xl border border-border bg-surface-elevated',
 				open && 'border-brand-500 ring-2 ring-brand-500/20',
@@ -297,14 +298,21 @@
 			<button
 				type="button"
 				{disabled}
-				onclick={() => openField('start')}
+				popovertarget={panelId}
+				popovertargetaction={triggerAction}
+				onclick={() => {
+					activeField = 'start';
+				}}
+				aria-expanded={open}
+				aria-haspopup="dialog"
+				aria-controls={panelId}
 				class={[
 					'flex min-w-0 flex-1 flex-col gap-0.5 px-3.5 py-2.5 text-left transition-colors',
 					'hover:bg-surface-overlay focus-visible:outline-none',
 					activeField === 'start' && open && 'bg-surface-overlay'
 				]}
 			>
-				<span class="text-[11px] font-medium uppercase tracking-wide text-muted">{startLabel}</span>
+				<span class="text-[11px] font-medium tracking-wide text-muted uppercase">{startLabel}</span>
 				<span class={['truncate text-sm', start ? 'text-primary' : 'text-muted']}>
 					{start ? formatIso(start) : startPlaceholder}
 				</span>
@@ -313,14 +321,21 @@
 			<button
 				type="button"
 				{disabled}
-				onclick={() => openField('end')}
+				popovertarget={panelId}
+				popovertargetaction={triggerAction}
+				onclick={() => {
+					activeField = 'end';
+				}}
+				aria-expanded={open}
+				aria-haspopup="dialog"
+				aria-controls={panelId}
 				class={[
 					'flex min-w-0 flex-1 flex-col gap-0.5 px-3.5 py-2.5 text-left transition-colors',
 					'hover:bg-surface-overlay focus-visible:outline-none',
 					activeField === 'end' && open && 'bg-surface-overlay'
 				]}
 			>
-				<span class="text-[11px] font-medium uppercase tracking-wide text-muted">{endLabel}</span>
+				<span class="text-[11px] font-medium tracking-wide text-muted uppercase">{endLabel}</span>
 				<span class={['truncate text-sm', end ? 'text-primary' : 'text-muted']}>
 					{end ? formatIso(end) : endPlaceholder}
 				</span>
@@ -330,7 +345,7 @@
 					type="button"
 					onclick={clear}
 					class="px-3 text-muted hover:text-primary"
-					aria-label="Clear dates"
+					aria-label={i18n.t('clearAll')}
 				>
 					<svg class="h-4 w-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
 						<path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" />
@@ -340,6 +355,7 @@
 		</div>
 	{:else}
 		<div
+			bind:this={triggerEl}
 			class={[
 				'flex h-10 w-full items-center overflow-hidden rounded-xl border border-border bg-surface-elevated transition-colors',
 				open && 'border-brand-500 ring-2 ring-brand-500/20',
@@ -349,8 +365,14 @@
 			<button
 				type="button"
 				{disabled}
-				onclick={() => (open ? setOpen(false) : openField('value'))}
+				popovertarget={panelId}
+				popovertargetaction="toggle"
+				onclick={() => {
+					activeField = 'value';
+				}}
 				aria-expanded={open}
+				aria-haspopup="dialog"
+				aria-controls={panelId}
 				class={[
 					'flex h-full min-w-0 flex-1 items-center gap-2 px-3.5 text-left text-sm',
 					'hover:bg-surface-overlay focus-visible:outline-none',
@@ -382,7 +404,13 @@
 					class="h-full px-3 text-muted hover:bg-surface-overlay hover:text-primary"
 					aria-label="Clear"
 				>
-					<svg class="h-3.5 w-3.5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+					<svg
+						class="h-3.5 w-3.5"
+						viewBox="0 0 24 24"
+						fill="none"
+						stroke="currentColor"
+						stroke-width="2"
+					>
 						<path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" />
 					</svg>
 				</button>
@@ -390,55 +418,83 @@
 		</div>
 	{/if}
 
-	{#if open}
-		<div
-			bind:this={panelEl}
-			role="dialog"
-			aria-label="Choose date"
-			class={panelClass}
-			onpointerdown={(e) => e.stopPropagation()}
-		>
-			{#if mode === 'single'}
-				<Calendar
-					mode="single"
-					{months}
-					bind:value
-					{min}
-					{max}
-					{disabledDates}
-					{enabledDates}
-					{dots}
-					framed={false}
-					onchange={handleChange}
-				/>
-			{:else if mode === 'multiple'}
-				<Calendar
-					mode="multiple"
-					{months}
-					bind:values
-					{min}
-					{max}
-					{disabledDates}
-					{enabledDates}
-					{dots}
-					framed={false}
-					onchange={handleChange}
-				/>
-			{:else}
-				<Calendar
-					mode="range"
-					{months}
-					bind:start
-					bind:end
-					{min}
-					{max}
-					{disabledDates}
-					{enabledDates}
-					{dots}
-					framed={false}
-					onchange={handleChange}
-				/>
-			{/if}
-		</div>
-	{/if}
+	<!-- Native popover (top layer + light dismiss). Not <dialog>: date picker is non-modal. -->
+	<div
+		bind:this={panelEl}
+		id={panelId}
+		popover="auto"
+		role="dialog"
+		aria-label="Choose date"
+		onbeforetoggle={handleBeforeToggle}
+		ontoggle={handleToggle}
+		style={panelStyle}
+		class={[
+			'datepicker-popover m-0 w-max rounded-2xl border border-border bg-surface-elevated p-2 shadow-xl outline-none',
+			months === 2 ? 'max-w-[min(42rem,calc(100vw-1rem))]' : 'max-w-[20rem]'
+		]}
+	>
+		{#if mode === 'single'}
+			<Calendar
+				mode="single"
+				{months}
+				bind:value
+				{min}
+				{max}
+				{disabledDates}
+				{enabledDates}
+				{dots}
+				framed={false}
+				locale={dateLocale}
+				onchange={handleChange}
+			/>
+		{:else if mode === 'multiple'}
+			<Calendar
+				mode="multiple"
+				{months}
+				bind:values
+				{min}
+				{max}
+				{disabledDates}
+				{enabledDates}
+				{dots}
+				framed={false}
+				locale={dateLocale}
+				onchange={handleChange}
+			/>
+		{:else}
+			<Calendar
+				mode="range"
+				{months}
+				bind:start
+				bind:end
+				{min}
+				{max}
+				{disabledDates}
+				{enabledDates}
+				{dots}
+				framed={false}
+				locale={dateLocale}
+				onchange={handleChange}
+			/>
+		{/if}
+	</div>
 </div>
+
+<style>
+	/* UA popover is inset:0 + margin:auto (viewport-centered and stretched). */
+	.datepicker-popover {
+		position: fixed;
+		inset: unset;
+		margin: 0;
+		width: max-content;
+		height: max-content;
+	}
+
+	.datepicker-popover:popover-open {
+		display: block;
+	}
+
+	.datepicker-popover:not(:popover-open) {
+		display: none;
+	}
+</style>

package/dist/components/molecules/DatePicker/DatePicker.svelte.d.ts

@@ -30,6 +30,8 @@ interface DatePickerProps {
      * alignment from available viewport space.
      */
     placement?: DatePickerPlacement;
+    /** BCP 47 locale for displayed dates. Defaults to the components i18n locale. */
+    locale?: string;
     class?: string;
     onchange?: (detail: {
         mode: CalendarMode;

package/dist/components/molecules/DateRangePicker/DateRangePicker.svelte

@@ -23,6 +23,7 @@
 		variant?: 'field' | 'split';
 		closeOnSelect?: boolean;
 		placement?: DatePickerPlacement;
+		locale?: string;
 		class?: string;
 		onchange?: (detail: { start: string; end: string }) => void;
 	}
@@ -47,6 +48,7 @@
 		variant = 'split',
 		closeOnSelect = true,
 		placement = 'auto',
+		locale,
 		class: className = '',
 		onchange
 	}: DateRangePickerProps = $props();
@@ -73,6 +75,7 @@
 	{variant}
 	{closeOnSelect}
 	{placement}
+	{locale}
 	class={className}
 	onchange={(detail) => onchange?.({ start: detail.start, end: detail.end })}
 />

package/dist/components/molecules/DateRangePicker/DateRangePicker.svelte.d.ts

@@ -21,6 +21,7 @@ interface DateRangePickerProps {
     variant?: 'field' | 'split';
     closeOnSelect?: boolean;
     placement?: DatePickerPlacement;
+    locale?: string;
     class?: string;
     onchange?: (detail: {
         start: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@r2digisolutions/components",
-	"version": "0.8.3",
+	"version": "0.8.5",
 	"private": false,
 	"description": "R2DigiSolutions Svelte 5 component library — Atomic Design, Tailwind 4, Light/Dark mode",
 	"license": "MIT",