@nqmcreative/ui 0.4.1 → 0.4.3

package/dist/styles/matte/Link.svelte

@@ -40,7 +40,7 @@
 
 <a
 	target={external ? '_blank' : undefined}
-	rel={external ? 'noreferrer' : undefined}
+	rel={external ? 'noopener noreferrer' : undefined}
 	class="inline-flex items-center gap-1 font-sans transition-colors duration-150 ease-brand-out
 		{muted ? `text-text-secondary ${toneHoverText[tone]}` : toneText[tone]}
 		{underlines[underline]} {focusRing} {toneRing[tone]} {className}"
@@ -49,5 +49,16 @@
 	{#if icon}<span class={iconSm}>{@render icon()}</span>{/if}
 	{@render children()}
 	{#if iconEnd}<span class={iconSm}>{@render iconEnd()}</span>{/if}
-	{#if external}<span aria-hidden="true" class="text-[0.85em]">↗</span>{/if}
+	{#if external}
+		<svg class="size-[0.85em] shrink-0" viewBox="0 0 14 14" fill="none" aria-hidden="true">
+			<path
+				d="M5.5 2.5h6v6M11.5 2.5 3.5 10.5"
+				stroke="currentColor"
+				stroke-width="1.5"
+				stroke-linecap="round"
+				stroke-linejoin="round"
+			/>
+		</svg>
+		<span class="sr-only">(opens in a new tab)</span>
+	{/if}
 </a>

package/dist/styles/matte/MenuItem.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
 	import type { HTMLButtonAttributes } from 'svelte/elements';
-	import { toneSoftHover, toneText, type Tone } from '../../core/tones.js';
+	import { toneSoft, toneSoftHover, toneText, type Tone } from '../../core/tones.js';
 	import { iconMd } from './icon.js';
 
 	interface Props extends HTMLButtonAttributes {
@@ -28,6 +28,11 @@
 		children,
 		...rest
 	}: Props = $props();
+
+	// A chosen row speaks in the brand, the same as an active nav link — a tick
+	// alone leaves it the same grey as every row above it. An item that already
+	// carries a tone (a red `Delete`) keeps its own.
+	const chosen = $derived(toneSoft[tone === 'neutral' ? 'brand' : tone]);
 </script>
 
 <svelte:element
@@ -39,9 +44,11 @@
 	aria-disabled={disabled ? 'true' : undefined}
 	tabindex={disabled ? undefined : -1}
 	class="flex w-full items-center gap-2.5 px-3 py-1.5 text-left text-[14px] transition-colors duration-100 ease-brand-out focus:outline-none disabled:pointer-events-none disabled:opacity-40
-		{tone === 'neutral'
-		? 'text-text-secondary hover:bg-bg-inset focus-visible:bg-bg-inset'
-		: `${toneText[tone]} ${toneSoftHover[tone]}`}
+		{selected
+		? `${chosen} font-medium`
+		: tone === 'neutral'
+			? 'text-text-secondary hover:bg-bg-inset focus-visible:bg-bg-inset'
+			: `${toneText[tone]} ${toneSoftHover[tone]}`}
 		{className}"
 	{...rest}
 >

package/dist/styles/matte/Modal.svelte

@@ -39,6 +39,8 @@
 		...rest
 	}: Props = $props();
 
+	const uid = $props.id();
+
 	let dialog: HTMLDialogElement | null = $state(null);
 
 	const closable = $derived(showClose ?? dismissible);
@@ -64,12 +66,14 @@
 
 <dialog
 	bind:this={dialog}
+	aria-labelledby={title ? `${uid}-title` : undefined}
+	aria-describedby={description ? `${uid}-description` : undefined}
 	onclose={close}
 	onclick={onBackdrop}
 	oncancel={(event) => {
 		if (!dismissible) event.preventDefault();
 	}}
-	class="m-auto w-[calc(100%-2rem)] border border-hairline bg-bg p-0 text-text backdrop:bg-text/40 {sizes[
+	class="m-auto w-[calc(100%-2rem)] animate-enter border border-hairline bg-bg p-0 text-text backdrop:bg-text/40 {sizes[
 		size
 	]} {className}"
 	{...rest}
@@ -80,10 +84,14 @@
 				{#if icon}<span class={iconLg}>{@render icon()}</span>{/if}
 				<div class="flex min-w-0 flex-1 flex-col gap-1">
 					{#if title}
-						<h2 class="font-heading text-lg font-medium tracking-tight">{title}</h2>
+						<h2 id="{uid}-title" class="font-heading text-lg font-medium tracking-tight">
+							{title}
+						</h2>
 					{/if}
 					{#if description}
-						<p class="font-sans text-sm text-text-secondary">{description}</p>
+						<p id="{uid}-description" class="font-sans text-sm text-text-secondary">
+							{description}
+						</p>
 					{/if}
 				</div>
 				{#if closable}

package/dist/styles/matte/MultiSelect.svelte

@@ -222,7 +222,7 @@
 		id="{id ?? 'multiselect'}-listbox"
 		role="listbox"
 		aria-multiselectable="true"
-		class="z-50 max-h-64 overflow-y-auto border border-hairline bg-bg py-1 font-sans"
+		class="z-50 max-h-64 animate-reveal overflow-y-auto border border-hairline bg-bg py-1 font-sans"
 	>
 		{#if flat.length === 0}
 			<p class="px-3 py-6 text-center text-sm text-text-muted">

package/dist/styles/matte/Navbar.svelte

@@ -109,7 +109,7 @@
 							class="{link} {focusRing} {toneRing[tone]} {item.active
 								? toneText[tone]
 								: 'text-text-secondary hover:text-text'} {item.disabled
-								? 'pointer-events-none opacity-50'
+								? 'pointer-events-none opacity-40'
 								: ''}"
 						>
 							{#if item.icon}<span class={iconMd}>{@render item.icon()}</span>{/if}
@@ -156,7 +156,7 @@
 					aria-current={item.active ? 'page' : undefined}
 					class="flex items-center justify-between gap-3 py-3 font-sans text-[15px] {item.active
 						? toneText[tone]
-						: 'text-text-secondary'} {item.disabled ? 'pointer-events-none opacity-50' : ''}"
+						: 'text-text-secondary'} {item.disabled ? 'pointer-events-none opacity-40' : ''}"
 				>
 					<span class="flex min-w-0 items-center gap-2.5">
 						{#if item.icon}<span class={iconMd}>{@render item.icon()}</span>{/if}

package/dist/styles/matte/Popover.svelte

@@ -77,7 +77,7 @@
 		role="dialog"
 		aria-label={title}
 		tabindex="-1"
-		class="z-50 flex max-w-xs flex-col gap-2 border border-hairline bg-bg p-4 font-sans {className}"
+		class="z-50 flex max-w-xs animate-reveal flex-col gap-2 border border-hairline bg-bg p-4 font-sans {className}"
 	>
 		{#if title}
 			<p class="font-heading text-sm font-medium text-text">{title}</p>

package/dist/styles/matte/Radio.svelte

@@ -24,32 +24,51 @@
 		children,
 		...rest
 	}: Props = $props();
+
+	const uid = $props.id();
 </script>
 
-<label
-	class="group inline-flex items-start gap-3 font-sans text-[15px]
-		{disabled ? 'pointer-events-none opacity-50' : 'cursor-pointer'} {className}"
+<div
+	class="inline-block font-sans text-[15px] {disabled
+		? 'pointer-events-none opacity-50'
+		: ''} {className}"
 >
-	<input type="radio" bind:group {value} {disabled} class="peer sr-only" {...rest} />
-	<span
-		class="mt-0.5 flex size-[18px] shrink-0 items-center justify-center rounded-full border border-hairline-strong bg-bg transition-colors duration-150 ease-brand-out
+	<label class="group inline-flex items-start gap-3 {disabled ? '' : 'cursor-pointer'}">
+		<input
+			type="radio"
+			bind:group
+			{value}
+			{disabled}
+			aria-describedby={description ? `${uid}-description` : undefined}
+			class="peer sr-only"
+			{...rest}
+		/>
+		<span
+			class="mt-0.5 flex size-[18px] shrink-0 items-center justify-center rounded-full border border-hairline-strong bg-bg transition-colors duration-150 ease-brand-out
 			{tonePeerChecked[tone]} {peerFocusRing} {tonePeerFocus[tone]}"
-		aria-hidden="true"
-	>
+			aria-hidden="true"
+		>
+			<span
+				class="size-1.5 rounded-full bg-text-inverse opacity-0 transition-opacity duration-150 group-has-[:checked]:opacity-100"
+			></span>
+		</span>
+		{#if label || children}
+			<span class="flex flex-col gap-0.5">
+				{#if children}
+					{@render children()}
+				{:else if label}
+					<span class="leading-snug text-text">{label}</span>
+				{/if}
+			</span>
+		{/if}
+	</label>
+	{#if description}
+		<!-- ponytail: the indent tracks the 18px dot plus the label's gap; move one, move both. -->
 		<span
-			class="size-1.5 rounded-full bg-text-inverse opacity-0 transition-opacity duration-150 group-has-[:checked]:opacity-100"
-		></span>
-	</span>
-	{#if label || description || children}
-		<span class="flex flex-col gap-0.5">
-			{#if children}
-				{@render children()}
-			{:else if label}
-				<span class="leading-snug text-text">{label}</span>
-			{/if}
-			{#if description}
-				<span class="text-sm leading-snug text-text-muted">{description}</span>
-			{/if}
+			id="{uid}-description"
+			class="mt-0.5 block pl-[30px] text-sm leading-snug text-text-muted"
+		>
+			{description}
 		</span>
 	{/if}
-</label>
+</div>

package/dist/styles/matte/RadioGroup.svelte

@@ -44,13 +44,24 @@
 		children,
 		...rest
 	}: Props = $props();
+
+	const uid = $props.id();
+	// The group's own hint and error sit outside every control in it, so the
+	// fieldset is what has to point at them.
+	const messageId = $derived(error ? `${uid}-error` : hint ? `${uid}-hint` : undefined);
 </script>
 
-<fieldset class="flex flex-col gap-3 border-0 p-0 {className}" {...rest}>
+<fieldset
+	aria-describedby={messageId}
+	class="flex flex-col gap-3 border-0 p-0 {className}"
+	{...rest}
+>
 	{#if legend}
 		<legend class="mb-1 font-sans text-sm font-medium text-text">
 			{legend}
-			{#if required}<span class="text-danger" aria-hidden="true">*</span>{/if}
+			{#if required}<span class="text-danger" aria-hidden="true">*</span><span class="sr-only"
+					>(required)</span
+				>{/if}
 		</legend>
 	{/if}
 
@@ -92,8 +103,8 @@
 	</div>
 
 	{#if error}
-		<p class="font-sans text-sm text-danger">{error}</p>
+		<p id="{uid}-error" role="alert" class="font-sans text-sm text-danger">{error}</p>
 	{:else if hint}
-		<p class="font-sans text-sm text-text-muted">{hint}</p>
+		<p id="{uid}-hint" class="font-sans text-sm text-text-muted">{hint}</p>
 	{/if}
 </fieldset>

package/dist/styles/matte/Select.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
 	import type { HTMLSelectAttributes } from 'svelte/elements';
-	import { toneFocusBorder, type Tone } from '../../core/tones.js';
+	import { focusRing, toneFocusBorder, toneRing, type Tone } from '../../core/tones.js';
 
 	export interface SelectOption {
 		value: string;
@@ -35,7 +35,9 @@
 	<select
 		bind:value
 		aria-invalid={invalid ? 'true' : undefined}
-		class="h-10 w-full appearance-none border bg-bg py-0 pr-10 pl-3.5 font-sans text-[15px] text-text transition-colors duration-150 ease-brand-out focus:outline-none disabled:pointer-events-none disabled:opacity-50
+		class="{focusRing} {toneRing[
+			tone
+		]} h-10 w-full appearance-none border bg-bg py-0 pr-10 pl-3.5 font-sans text-[15px] text-text transition-colors duration-150 ease-brand-out disabled:pointer-events-none disabled:opacity-50
 			{invalid ? 'border-danger' : `border-hairline ${toneFocusBorder[tone]}`} {className}"
 		{...rest}
 	>

package/dist/styles/matte/Skeleton.svelte

@@ -29,7 +29,7 @@
 </script>
 
 {#if variant === 'text' && lines > 1}
-	<div class="flex w-full flex-col gap-2 {className}" {...rest}>
+	<div aria-hidden="true" class="flex w-full flex-col gap-2 {className}" {...rest}>
 		{#each { length: lines }, i (i)}
 			<div
 				class="h-4 animate-pulse bg-bg-inset {i === lines - 1 ? 'w-2/3' : 'w-full'}"
@@ -39,6 +39,7 @@
 	</div>
 {:else}
 	<div
+		aria-hidden="true"
 		class="animate-pulse bg-bg-inset {variants[variant]} {className}"
 		style="{width ? `width:${width};` : ''}{height ? `height:${height};` : ''}"
 		{...rest}

package/dist/styles/matte/Stat.svelte

@@ -32,7 +32,15 @@
 	}: Props = $props();
 
 	const trendTone: Record<StatTrend, Tone> = { up: 'success', down: 'danger', flat: 'neutral' };
-	const trendGlyph: Record<StatTrend, string> = { up: '↑', down: '↓', flat: '→' };
+	// Drawn rather than typed. `↑` renders in whatever face the reader's system
+	// substitutes for it and is announced as "up arrow" or nothing at all, and
+	// the colour beside it says nothing either — so the word ships with it.
+	const trendPath: Record<StatTrend, string> = {
+		up: 'M7 11V3.5M7 3l3.5 3.5M7 3 3.5 6.5',
+		down: 'M7 3v7.5M7 11l3.5-3.5M7 11 3.5 7.5',
+		flat: 'M3 7h7.5M11 7 7.5 3.5M11 7l-3.5 3.5'
+	};
+	const trendWord: Record<StatTrend, string> = { up: 'up', down: 'down', flat: 'no change' };
 </script>
 
 <div class="flex flex-col gap-1 font-sans {className}" {...rest}>
@@ -41,13 +49,29 @@
 	>
 	<div class="flex items-baseline gap-2">
 		<span
-			class="font-heading text-3xl font-medium tracking-tight {tone ? toneText[tone] : 'text-text'}"
+			class="font-heading text-3xl font-medium tracking-tight tabular-nums {tone
+				? toneText[tone]
+				: 'text-text'}"
 		>
 			{value}
 		</span>
 		{#if delta}
 			<span class="font-mono text-xs {toneText[trendTone[trend]]}">
-				{trendGlyph[trend]}
+				<svg
+					class="inline-block size-[1em] align-[-0.115em]"
+					viewBox="0 0 14 14"
+					fill="none"
+					aria-hidden="true"
+				>
+					<path
+						d={trendPath[trend]}
+						stroke="currentColor"
+						stroke-width="1.6"
+						stroke-linecap="round"
+						stroke-linejoin="round"
+					/>
+				</svg>
+				<span class="sr-only">{trendWord[trend]}</span>
 				{delta}
 			</span>
 		{/if}

package/dist/styles/matte/Switch.svelte

@@ -30,6 +30,8 @@
 		md: { track: 'h-6 w-11', thumb: 'size-5', travel: 'translate-x-5' }
 	};
 
+	const uid = $props.id();
+
 	function toggle() {
 		checked = !checked;
 		onchange?.(checked);
@@ -42,6 +44,7 @@
 		role="switch"
 		aria-checked={checked}
 		aria-label={label}
+		aria-describedby={description ? `${uid}-description` : undefined}
 		{disabled}
 		onclick={toggle}
 		class="relative mt-0.5 inline-flex shrink-0 items-center rounded-full p-0.5 transition-colors duration-200 ease-brand-out disabled:pointer-events-none
@@ -57,7 +60,9 @@
 		<span class="flex flex-col gap-0.5 font-sans text-[15px]">
 			{#if label}<span class="leading-snug text-text">{label}</span>{/if}
 			{#if description}
-				<span class="text-sm leading-snug text-text-muted">{description}</span>
+				<span id="{uid}-description" class="text-sm leading-snug text-text-muted"
+					>{description}</span
+				>
 			{/if}
 		</span>
 	{/if}

package/dist/styles/matte/Tabs.svelte

@@ -74,7 +74,7 @@
 			}`;
 		}
 		return `${base} h-9 px-4 ${
-			active ? 'bg-bg font-medium text-text' : 'text-text-secondary hover:text-text'
+			active ? `bg-bg font-medium ${toneText[tone]}` : 'text-text-secondary hover:text-text'
 		}`;
 	}
 </script>

package/dist/styles/matte/Textarea.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
 	import type { HTMLTextareaAttributes } from 'svelte/elements';
-	import { toneFocusBorder, type Tone } from '../../core/tones.js';
+	import { focusRing, toneFocusBorder, toneRing, type Tone } from '../../core/tones.js';
 
 	interface Props extends HTMLTextareaAttributes {
 		value?: string;
@@ -48,7 +48,9 @@
 	bind:value
 	{rows}
 	aria-invalid={invalid ? 'true' : undefined}
-	class="w-full border bg-bg px-3.5 py-2.5 font-sans text-[15px] text-text transition-colors duration-150 ease-brand-out placeholder:text-text-muted focus:outline-none disabled:pointer-events-none disabled:opacity-50
+	class="{focusRing} {toneRing[
+		tone
+	]} w-full border bg-bg px-3.5 py-2.5 font-sans text-[15px] text-text transition-colors duration-150 ease-brand-out placeholder:text-text-muted disabled:pointer-events-none disabled:opacity-50
 		{autoresize ? 'resize-none overflow-hidden' : 'resize-y'}
 		{invalid ? 'border-danger' : `border-hairline ${toneFocusBorder[tone]}`} {className}"
 	{...rest}></textarea>

package/dist/styles/matte/Toaster.svelte

@@ -30,8 +30,24 @@
 	const fromLeft = $derived(position.endsWith('left'));
 	const fromCenter = $derived(position.endsWith('center'));
 
+	/**
+	 * A card sliding in from the edge of the screen, and a stack of them shuffling
+	 * to make room, is exactly the motion this preference exists to stop. Under it
+	 * the toast fades in place and the stack reorders instantly — the state change
+	 * still reads, it just stops travelling.
+	 *
+	 * ponytail: read once at mount. Someone who flips the OS setting mid-session
+	 * gets the new behaviour on the next load; a live listener is the upgrade.
+	 */
+	const stillness =
+		typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;
+
 	const enter = $derived(
-		fromCenter ? { y: fromTop ? -16 : 16, x: 0 } : { x: fromLeft ? -16 : 16, y: 0 }
+		stillness
+			? { x: 0, y: 0 }
+			: fromCenter
+				? { y: fromTop ? -16 : 16, x: 0 }
+				: { x: fromLeft ? -16 : 16, y: 0 }
 	);
 </script>
 
@@ -45,7 +61,7 @@
 >
 	{#each toast.items as item (item.id)}
 		<div
-			animate:flip={{ duration: 200 }}
+			animate:flip={{ duration: stillness ? 0 : 200 }}
 			in:fly={{ ...enter, duration: 220 }}
 			out:fly={{ ...enter, duration: 160 }}
 			role={item.tone === 'danger' ? 'alert' : 'status'}
@@ -75,7 +91,9 @@
 			</span>
 
 			<div class="flex min-w-0 flex-1 flex-col gap-1">
-				<p class="text-[15px] leading-snug font-medium {toneText[item.tone]}">{item.title}</p>
+				<p class="font-heading text-[15px] leading-snug font-medium {toneText[item.tone]}">
+					{item.title}
+				</p>
 				{#if item.description}
 					<p class="text-sm leading-relaxed text-text-secondary">{item.description}</p>
 				{/if}

package/dist/styles/matte/Tooltip.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
+	import { describedBy } from '../../core/trigger.js';
 	import type { HTMLAttributes } from 'svelte/elements';
 
 	export type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
@@ -13,6 +14,11 @@
 
 	let { content, placement = 'top', class: className = '', children, ...rest }: Props = $props();
 
+	const uid = $props.id();
+	let wrapper: HTMLElement | null = $state(null);
+
+	$effect(() => describedBy(wrapper, `${uid}-tip`));
+
 	const placements: Record<TooltipPlacement, string> = {
 		top: 'bottom-full left-1/2 mb-2 -translate-x-1/2',
 		bottom: 'top-full left-1/2 mt-2 -translate-x-1/2',
@@ -21,9 +27,10 @@
 	};
 </script>
 
-<span class="group/tt relative inline-flex" {...rest}>
+<span bind:this={wrapper} class="group/tt relative inline-flex" {...rest}>
 	{@render children()}
 	<span
+		id="{uid}-tip"
 		role="tooltip"
 		class="pointer-events-none invisible absolute z-50 bg-text px-2.5 py-1.5 font-sans text-xs whitespace-nowrap text-text-inverse opacity-0 transition-opacity duration-150 ease-brand-out group-focus-within/tt:visible group-focus-within/tt:opacity-100 group-hover/tt:visible group-hover/tt:opacity-100
 			{placements[placement]} {className}"

package/dist/styles/matte/index.d.ts

@@ -5,7 +5,7 @@
  * `@nqmcreative/ui/core`, re-exported below so this one import covers
  * the whole style.
  */
-export { TONES, focusRing, peerFocusRing, toneBorder, toneBorderLeft, toneBorderSoft, toneFill, toneFocusBorder, toneFocusWithinBorder, toneHoverBorder, toneHoverText, tonePeerChecked, tonePeerFocus, toneRing, toneSoft, toneSoftHover, toneSolid, toneSolidHover, toneSurface, toneText, anchored, clickOutside, focusTrap, focusable, navigateList, portal, toast, applyTheme, storedTheme, toISO, fromISO, today, isSameDay, addDays, addMonths, monthGrid, weekdayNames, monthLabel, isOutOfRange, formatISO, parseFormatted } from '../../core/index.js';
+export { TONES, focusRing, peerFocusRing, toneBorder, toneBorderLeft, toneBorderSoft, toneFill, toneFocusBorder, toneFocusWithinBorder, focusWithinRing, toneFocusWithinRing, toneHoverBorder, toneHoverText, tonePeerChecked, tonePeerFocus, toneRing, toneSoft, toneSoftHover, toneSolid, toneSolidHover, toneSurface, toneText, anchored, clickOutside, focusTrap, focusable, navigateList, portal, toast, applyTheme, storedTheme, toISO, fromISO, today, isSameDay, addDays, addMonths, monthGrid, weekdayNames, monthLabel, isOutOfRange, formatISO, parseFormatted } from '../../core/index.js';
 export type { Tone, Placement, AnchorOptions, ClickOutsideOptions, FocusTrapOptions, Toast, ToastOptions, ToastAction, Theme, DateFormat, TableSort, SortDirection, RejectedFile } from '../../core/index.js';
 export { default as Button } from './Button.svelte';
 export type { ButtonVariant, ButtonSize } from './Button.svelte';

package/dist/styles/matte/index.js

@@ -6,7 +6,7 @@
  * the whole style.
  */
 /* --- shared behaviour --- */
-export { TONES, focusRing, peerFocusRing, toneBorder, toneBorderLeft, toneBorderSoft, toneFill, toneFocusBorder, toneFocusWithinBorder, toneHoverBorder, toneHoverText, tonePeerChecked, tonePeerFocus, toneRing, toneSoft, toneSoftHover, toneSolid, toneSolidHover, toneSurface, toneText, anchored, clickOutside, focusTrap, focusable, navigateList, portal, toast, applyTheme, storedTheme, toISO, fromISO, today, isSameDay, addDays, addMonths, monthGrid, weekdayNames, monthLabel, isOutOfRange, formatISO, parseFormatted } from '../../core/index.js';
+export { TONES, focusRing, peerFocusRing, toneBorder, toneBorderLeft, toneBorderSoft, toneFill, toneFocusBorder, toneFocusWithinBorder, focusWithinRing, toneFocusWithinRing, toneHoverBorder, toneHoverText, tonePeerChecked, tonePeerFocus, toneRing, toneSoft, toneSoftHover, toneSolid, toneSolidHover, toneSurface, toneText, anchored, clickOutside, focusTrap, focusable, navigateList, portal, toast, applyTheme, storedTheme, toISO, fromISO, today, isSameDay, addDays, addMonths, monthGrid, weekdayNames, monthLabel, isOutOfRange, formatISO, parseFormatted } from '../../core/index.js';
 /* --- actions --- */
 export { default as Button } from './Button.svelte';
 export { default as Link } from './Link.svelte';

package/dist/styles/matte/theme.css

@@ -78,9 +78,37 @@
 	--font-heading: 'Sora', ui-sans-serif, system-ui, sans-serif;
 	--font-mono: 'JetBrains Mono', 'Cascadia Code', 'Fira Code', monospace;
 
-	/* --- motion --- */
+	/* --- motion ---
+	 * matte enters by fading and revealing along an axis — never by moving or
+	 * scaling (the style's first law). One token per overlay kind: `enter` for
+	 * dialog panels + backdrops, `reveal` for anchored menus and popovers.
+	 * paper and sprout define these same two names their own way, so an
+	 * overlay's markup never changes between styles — only these values do.
+	 */
 	--ease-brand: cubic-bezier(0.16, 1, 0.3, 1);
 	--ease-brand-out: cubic-bezier(0.25, 1, 0.5, 1);
+	--animate-enter: nqm-fade 150ms var(--ease-brand-out);
+	--animate-reveal: nqm-shutter 160ms var(--ease-brand-out);
+}
+
+/* Enter-only, matching the Drawer: the native <dialog> and the {#if}-mounted
+ * popover each play these once on mount and leave instantly. */
+@keyframes nqm-fade {
+	from {
+		opacity: 0;
+	}
+}
+@keyframes nqm-shutter {
+	from {
+		opacity: 0;
+		clip-path: inset(0 0 100% 0);
+	}
+	to {
+		opacity: 1;
+		/* Both ends must be inset() — animating to `none` (the default) can't
+		 * interpolate and the panel would snap open at the midpoint instead. */
+		clip-path: inset(0 0 0 0);
+	}
 }
 
 /*
@@ -207,3 +235,38 @@
 		--color-neutral-border: #334155;
 	}
 }
+
+/*
+ * The surfaces the browser draws for us.
+ *
+ * A caret and a highlight in the user-agent's blue belong to no design system,
+ * and they are the two the reader touches most: one sits in every field they
+ * type into, the other appears the moment they drag across a paragraph. The
+ * selection is mixed from the brand rather than pinned to a token so it stays
+ * a wash — the text underneath keeps its own colour and its own contrast.
+ */
+@layer base {
+	/* The one overlay surface a class can't reach: every <dialog> backdrop
+	 * fades with its panel. */
+	dialog::backdrop {
+		animation: nqm-fade 150ms var(--ease-brand-out);
+	}
+
+	@media (prefers-reduced-motion: reduce) {
+		.animate-enter,
+		.animate-reveal,
+		dialog::backdrop {
+			animation: none;
+		}
+	}
+
+	::selection {
+		background-color: color-mix(in oklab, var(--color-brand) 24%, transparent);
+	}
+
+	input,
+	textarea,
+	[contenteditable] {
+		caret-color: var(--color-brand);
+	}
+}

package/dist/styles/paper/AccordionItem.svelte

@@ -4,7 +4,7 @@
 	import { toneText, type Tone } from '../../core/tones.js';
 	import { iconMd } from './icon.js';
 
-	interface Props extends HTMLAttributes<HTMLDetailsElement> {
+	interface Props extends HTMLAttributes<HTMLDivElement> {
 		title: string;
 		open?: boolean;
 		tone?: Tone;
@@ -25,27 +25,54 @@
 		children,
 		...rest
 	}: Props = $props();
+
+	const uid = $props.id();
 </script>
 
-<details bind:open class="group border-b border-hairline last:border-b-0 {className}" {...rest}>
-	<summary
-		class="flex cursor-pointer list-none items-center gap-4 px-4 py-3.5 font-sans text-sm font-medium text-text transition-colors duration-150 ease-brand-out select-none hover:bg-bg-alt focus-visible:outline-2 focus-visible:outline-offset-[-2px] focus-visible:outline-current [&::-webkit-details-marker]:hidden"
+<!--
+	A disclosure, not a native <details>: the panel is a grid whose single row
+	animates from 0fr to 1fr, which is the one height animation that works in
+	every browser (auto-height keyframes don't interpolate). The <button> keeps
+	the keyboard and focus behaviour <summary> gave us for free; aria-expanded
+	and the region wiring replace what the open attribute carried.
+-->
+<div class="border-b border-hairline last:border-b-0 {className}" {...rest}>
+	<button
+		type="button"
+		id="{uid}-trigger"
+		aria-expanded={open}
+		aria-controls="{uid}-panel"
+		onclick={() => (open = !open)}
+		class="flex w-full cursor-pointer items-center gap-4 px-4 py-3.5 text-left font-sans text-sm font-medium text-text transition-colors duration-150 ease-brand-out select-none hover:bg-bg-alt focus-visible:outline-2 focus-visible:outline-offset-[-2px] focus-visible:outline-current"
 	>
 		{#if icon}<span class={iconMd}>{@render icon()}</span>{/if}
 		<span class="flex-1">{title}</span>
 		{#if meta}<span class="text-[13px] font-normal text-text-muted">{meta}</span>{/if}
 		<svg
-			class="size-4 shrink-0 transition-transform duration-200 ease-brand-out group-open:rotate-180 {toneText[
-				tone
-			]}"
+			class="size-4 shrink-0 transition-transform duration-200 ease-brand-out {open
+				? 'rotate-180'
+				: ''} {toneText[tone]}"
 			viewBox="0 0 16 16"
 			fill="none"
 			aria-hidden="true"
 		>
 			<path d="m4 6 4 4 4-4" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" />
 		</svg>
-	</summary>
-	<div class="px-4 pb-4 font-sans text-sm leading-relaxed text-text-secondary">
-		{@render children()}
+	</button>
+	<div
+		id="{uid}-panel"
+		role="region"
+		aria-labelledby="{uid}-trigger"
+		inert={!open}
+		class="grid transition-[grid-template-rows] duration-200 ease-brand-out"
+		style:grid-template-rows={open ? '1fr' : '0fr'}
+	>
+		<!-- overflow-hidden gives this grid row a min height of 0 so 0fr can
+			 collapse it fully, and clips the content while it slides. -->
+		<div class="overflow-hidden">
+			<div class="px-4 pb-4 font-sans text-sm leading-relaxed text-text-secondary">
+				{@render children()}
+			</div>
+		</div>
 	</div>
-</details>
+</div>