@nqmcreative/ui 0.4.1 → 0.4.2

package/dist/styles/sprout/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}>
@@ -49,7 +57,21 @@
 		</span>
 		{#if delta}
 			<span class="text-sm font-medium {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/sprout/Switch.svelte

@@ -31,6 +31,8 @@
 		md: { track: 'h-6 w-11', thumb: 'size-5', travel: 'translate-x-5' }
 	};
 
+	const uid = $props.id();
+
 	function toggle() {
 		checked = !checked;
 		onchange?.(checked);
@@ -43,6 +45,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
@@ -58,7 +61,9 @@
 		<span class="flex flex-col gap-0.5 font-sans text-sm">
 			{#if label}<span class="leading-snug text-text">{label}</span>{/if}
 			{#if description}
-				<span class="text-[13px] leading-snug text-text-muted">{description}</span>
+				<span id="{uid}-description" class="text-[13px] leading-snug text-text-muted"
+					>{description}</span
+				>
 			{/if}
 		</span>
 	{/if}

package/dist/styles/sprout/Table.svelte

@@ -195,7 +195,7 @@
 								<button
 									type="button"
 									onclick={() => toggleSort(column)}
-									class="inline-flex items-center gap-1.5 rounded transition-colors duration-150 hover:text-text focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-current
+									class="inline-flex items-center gap-1.5 rounded-md transition-colors duration-150 hover:text-text focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-current
 									{sort?.key === column.key ? 'text-text' : ''}"
 								>
 									{column.label}

package/dist/styles/sprout/Tabs.svelte

@@ -75,7 +75,7 @@
 			}`;
 		}
 		return `${base} h-8 rounded-xl px-3.5 ${
-			active ? `bg-bg text-text ${edge}` : 'text-text-muted hover:text-text'
+			active ? `bg-bg ${toneText[tone]} ${edge}` : 'text-text-muted hover:text-text'
 		}`;
 	}
 </script>

package/dist/styles/sprout/TagsInput.svelte

@@ -135,7 +135,7 @@
 					type="button"
 					onclick={() => remove(index)}
 					aria-label="Remove {tag}"
-					class="inline-flex size-4 items-center justify-center rounded transition-colors duration-150 hover:bg-bg/70 focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-current"
+					class="inline-flex size-4 items-center justify-center rounded-full transition-colors duration-150 hover:bg-bg/70 focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-current"
 				>
 					<svg class="size-2.5" viewBox="0 0 10 10" fill="none" aria-hidden="true">
 						<path

package/dist/styles/sprout/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';
 	import { edge } from './lift.js';
 
 	interface Props extends HTMLTextareaAttributes {
@@ -49,7 +49,9 @@
 	bind:value
 	{rows}
 	aria-invalid={invalid ? 'true' : undefined}
-	class="w-full rounded-xl border bg-bg px-3 py-2 font-sans text-sm text-text {edge} 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 rounded-xl border bg-bg px-3 py-2 font-sans text-sm text-text {edge} 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-strong ${toneFocusBorder[tone]}`} {className}"
 	{...rest}></textarea>

package/dist/styles/sprout/TimeInput.svelte

@@ -71,7 +71,7 @@
 	}
 
 	const stepper =
-		'grid size-6 place-items-center rounded text-text-secondary transition-colors duration-150 hover:bg-bg-inset hover:text-text focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-current';
+		'grid size-6 place-items-center rounded-lg text-text-secondary transition-colors duration-150 hover:bg-bg-inset hover:text-text focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-current';
 </script>
 
 <Input

package/dist/styles/sprout/Toaster.svelte

@@ -31,8 +31,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>
 
@@ -46,12 +62,12 @@
 >
 	{#each toast.items as item (item.id)}
 		<!--
-			sprout puts every toast on the same cream card and lets the glyph
+			sprout puts every toast on the same white card and lets the glyph
 			carry the tone. matte tints the whole surface; here a tinted block
 			would fight the warm page underneath.
 		-->
 		<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'}
@@ -93,7 +109,7 @@
 			</span>
 
 			<div class="flex min-w-0 flex-1 flex-col gap-1">
-				<p class="text-sm leading-snug font-semibold text-text">{item.title}</p>
+				<p class="font-heading text-sm leading-snug font-semibold text-text">{item.title}</p>
 				{#if item.description}
 					<p class="text-[13px] leading-relaxed text-text-secondary">{item.description}</p>
 				{/if}
@@ -104,7 +120,7 @@
 							item.action?.onclick();
 							toast.dismiss(item.id);
 						}}
-						class="mt-1 self-start rounded font-sans text-[13px] font-semibold underline underline-offset-2 {toneText[
+						class="mt-1 self-start rounded-md font-sans text-[13px] font-semibold underline underline-offset-2 {toneText[
 							item.tone
 						]}"
 					>
@@ -117,7 +133,7 @@
 				type="button"
 				onclick={() => toast.dismiss(item.id)}
 				aria-label="Dismiss"
-				class="-m-1 shrink-0 rounded p-1 text-text-muted transition-colors duration-150 hover:bg-bg-inset hover:text-text focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-current"
+				class="-m-1 shrink-0 rounded-xl p-1 text-text-muted transition-colors duration-150 hover:bg-bg-inset hover:text-text focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-current"
 			>
 				<svg class="size-3.5" viewBox="0 0 14 14" fill="none" aria-hidden="true">
 					<path

package/dist/styles/sprout/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';
 	import { soft } from './lift.js';
 
@@ -14,6 +15,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-1.5 -translate-x-1/2',
 		bottom: 'top-full left-1/2 mt-1.5 -translate-x-1/2',
@@ -22,9 +28,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 rounded-xl bg-text px-2 py-1 font-sans text-xs font-medium whitespace-nowrap text-text-inverse opacity-0 {soft} 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/sprout/index.d.ts

@@ -1,11 +1,11 @@
 /**
- * Sprout — Warm and fully rounded — leaf green on cream, pill buttons, and a round display face. For school, community and family sites.
+ * Sprout — Warm and fully rounded — leaf green on white, pill buttons, and a round display face. For school, community and family sites.
  *
  * Generated by `bun run index`. Behaviour comes from
  * `@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/sprout/index.js

@@ -1,12 +1,12 @@
 /**
- * Sprout — Warm and fully rounded — leaf green on cream, pill buttons, and a round display face. For school, community and family sites.
+ * Sprout — Warm and fully rounded — leaf green on white, pill buttons, and a round display face. For school, community and family sites.
  *
  * Generated by `bun run index`. Behaviour comes from
  * `@nqmcreative/ui/core`, re-exported below so this one import covers
  * 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/sprout/lift.d.ts

@@ -36,5 +36,19 @@ export declare const float = "shadow-[0_6px_0_0_rgba(20,83,45,0.09),0_28px_60px_
  * reads as one pressed object.
  */
 export declare const lift: Record<Tone, string>;
+/**
+ * The quiet lip, for a button that is not a solid fill: `soft` and `outline`.
+ *
+ * Drawn in the tone's own border colour — the line `outline` already carries —
+ * so the bottom reads as that border thickening rather than as a shadow stuck
+ * underneath. `soft` has no border of its own, so pairing the two here is what
+ * gives both variants the same edge: the only difference left between them is
+ * the face above it.
+ *
+ * Shortens by the same 3px the button travels, exactly like `lift`. Without
+ * that second step a pressed button just slides down with its shadow attached
+ * and never reads as pressed at all.
+ */
+export declare const liftSoft: Record<Tone, string>;
 /** The same lip at 3px, for things too small to travel: icon tiles, dots. */
 export declare const liftSm: Record<Tone, string>;

package/dist/styles/sprout/lift.js

@@ -23,6 +23,29 @@ export const lift = {
     danger: 'shadow-[0_5px_0_0_color-mix(in_oklab,var(--color-danger)_72%,black)] active:shadow-[0_2px_0_0_color-mix(in_oklab,var(--color-danger)_72%,black)]',
     neutral: 'shadow-[0_5px_0_0_color-mix(in_oklab,var(--color-neutral)_72%,black)] active:shadow-[0_2px_0_0_color-mix(in_oklab,var(--color-neutral)_72%,black)]'
 };
+/**
+ * The quiet lip, for a button that is not a solid fill: `soft` and `outline`.
+ *
+ * Drawn in the tone's own border colour — the line `outline` already carries —
+ * so the bottom reads as that border thickening rather than as a shadow stuck
+ * underneath. `soft` has no border of its own, so pairing the two here is what
+ * gives both variants the same edge: the only difference left between them is
+ * the face above it.
+ *
+ * Shortens by the same 3px the button travels, exactly like `lift`. Without
+ * that second step a pressed button just slides down with its shadow attached
+ * and never reads as pressed at all.
+ */
+export const liftSoft = {
+    brand: 'shadow-[0_5px_0_0_var(--color-brand-border)] active:shadow-[0_2px_0_0_var(--color-brand-border)]',
+    accent: 'shadow-[0_5px_0_0_var(--color-accent-border)] active:shadow-[0_2px_0_0_var(--color-accent-border)]',
+    violet: 'shadow-[0_5px_0_0_var(--color-violet-border)] active:shadow-[0_2px_0_0_var(--color-violet-border)]',
+    info: 'shadow-[0_5px_0_0_var(--color-info-border)] active:shadow-[0_2px_0_0_var(--color-info-border)]',
+    success: 'shadow-[0_5px_0_0_var(--color-success-border)] active:shadow-[0_2px_0_0_var(--color-success-border)]',
+    warning: 'shadow-[0_5px_0_0_var(--color-warning-border)] active:shadow-[0_2px_0_0_var(--color-warning-border)]',
+    danger: 'shadow-[0_5px_0_0_var(--color-danger-border)] active:shadow-[0_2px_0_0_var(--color-danger-border)]',
+    neutral: 'shadow-[0_5px_0_0_var(--color-neutral-border)] active:shadow-[0_2px_0_0_var(--color-neutral-border)]'
+};
 /** The same lip at 3px, for things too small to travel: icon tiles, dots. */
 export const liftSm = {
     brand: 'shadow-[0_3px_0_0_color-mix(in_oklab,var(--color-brand)_72%,black)]',

package/dist/styles/sprout/theme.css

@@ -1,7 +1,7 @@
 /*
  * sprout — design tokens.
  *
- * The warm one: leaf green on cream, fully rounded corners, and a display face
+ * The warm one: leaf green on white, fully rounded corners, and a display face
  * with round terminals. Built for school, community and family sites, where the
  * reader is a parent on a phone rather than an operator at a desk. Import this
  * after `@import "tailwindcss";` in your app's CSS entry point.
@@ -17,16 +17,21 @@
  */
 @theme {
 	/*
-	 * Surfaces are cream rather than white, and the greys are green-cast. A
-	 * neutral grey next to this much foliage reads as a printing error, so every
-	 * step of the scale carries a little of the brand hue.
+	 * Surfaces are white, and the greys under them are near-neutral with only a
+	 * hair of warmth. The green belongs to the brand, not to the paper: a page
+	 * whose every secondary surface and every hover is tinted reads as tiring
+	 * long before it reads as warm, so the neutrals stay out of the way.
+	 *
+	 * `--color-bg` is the face of a card; `--color-bg-alt` is the ground it sits
+	 * on. Put `bg-bg-alt` on the body and cards float as white, which is the
+	 * layering this style was drawn from.
 	 */
 	/* --- surfaces --- */
-	--color-bg: #fffefb;
-	--color-bg-alt: #f0fdf4;
-	--color-bg-inset: #e3f6e9;
-	--color-hairline: #ecefe7;
-	--color-hairline-strong: #d3e0d1;
+	--color-bg: #ffffff;
+	--color-bg-alt: #f7f7f4;
+	--color-bg-inset: #edede8;
+	--color-hairline: #e6e6e0;
+	--color-hairline-strong: #cfcfc7;
 
 	/* --- text --- */
 	--color-text: #1a3a1f;
@@ -136,25 +141,25 @@
  * Every utility built on these tokens follows automatically, so components
  * need no `dark:` classes of their own.
  *
- * The dark palette is a night garden rather than a neutral slate: the surfaces
- * keep the green cast, and every hue lifts a step or two so it still reads
- * against them.
+ * The dark palette is lamplight rather than a neutral slate: the surfaces carry
+ * the same honey cast as the light ones, and every hue lifts a step or two so
+ * it still reads against them.
  */
 @custom-variant dark (&:where(.dark, .dark *));
 
 .dark {
 	color-scheme: dark;
 
-	--color-bg: #0e1a11;
-	--color-bg-alt: #14251a;
-	--color-bg-inset: #1b3020;
-	--color-hairline: #1e3524;
-	--color-hairline-strong: #2f4a36;
+	--color-bg: #17140e;
+	--color-bg-alt: #211c13;
+	--color-bg-inset: #2d261a;
+	--color-hairline: #2a2317;
+	--color-hairline-strong: #453a27;
 
 	--color-text: #f0f7f0;
 	--color-text-secondary: #cadfcd;
 	--color-text-muted: #94ad99;
-	--color-text-inverse: #0e1a11;
+	--color-text-inverse: #17140e;
 
 	--color-brand: #4ade80;
 	--color-brand-hover: #86efac;
@@ -201,16 +206,16 @@
 	:root:not(.light) {
 		color-scheme: dark;
 
-		--color-bg: #0e1a11;
-		--color-bg-alt: #14251a;
-		--color-bg-inset: #1b3020;
-		--color-hairline: #1e3524;
-		--color-hairline-strong: #2f4a36;
+		--color-bg: #17140e;
+		--color-bg-alt: #211c13;
+		--color-bg-inset: #2d261a;
+		--color-hairline: #2a2317;
+		--color-hairline-strong: #453a27;
 
 		--color-text: #f0f7f0;
 		--color-text-secondary: #cadfcd;
 		--color-text-muted: #94ad99;
-		--color-text-inverse: #0e1a11;
+		--color-text-inverse: #17140e;
 
 		--color-brand: #4ade80;
 		--color-brand-hover: #86efac;
@@ -253,3 +258,24 @@
 		--color-neutral-border: #2f4a36;
 	}
 }
+
+/*
+ * 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 {
+	::selection {
+		background-color: color-mix(in oklab, var(--color-brand) 24%, transparent);
+	}
+
+	input,
+	textarea,
+	[contenteditable] {
+		caret-color: var(--color-brand);
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nqmcreative/ui",
-	"version": "0.4.1",
+	"version": "0.4.2",
 	"description": "Svelte 5 + Tailwind CSS v4 component library — three styles (matte, paper, sprout), 70 components each, one shared behaviour core. No runtime dependencies.",
 	"scripts": {
 		"dev": "vite dev",

package/registry.json

@@ -21,7 +21,7 @@
 		{
 			"name": "sprout",
 			"title": "Sprout",
-			"description": "Warm and fully rounded — leaf green on cream, pill buttons, and a round display face. For school, community and family sites.",
+			"description": "Warm and fully rounded — leaf green on white, pill buttons, and a round display face. For school, community and family sites.",
 			"fonts": true,
 			"extra": []
 		}
@@ -1122,7 +1122,9 @@
 				"sprout": "@nqmcreative/ui/sprout/tooltip"
 			},
 			"uses": [],
-			"modules": []
+			"modules": [
+				"trigger"
+			]
 		}
 	]
 }