@nqmcreative/ui 0.2.3 → 0.3.0

package/dist/styles/matte/CheckboxGroup.svelte

@@ -3,10 +3,13 @@
 	import type { HTMLFieldsetAttributes } from 'svelte/elements';
 	import Checkbox from './Checkbox.svelte';
 	import type { Tone } from '../../core/tones.js';
+	import { iconLg } from './icon.js';
 
 	export interface CheckboxOption {
 		value: string;
 		label: string;
+		/** Leading icon, 20px. Drawn in `boxed` mode only. */
+		icon?: Snippet;
 		description?: string;
 		disabled?: boolean;
 	}
@@ -76,6 +79,9 @@
 							{checked ? 'border-text bg-bg-alt' : 'border-hairline hover:border-hairline-strong'}
 							{disabled ? 'pointer-events-none opacity-50' : ''}"
 					>
+						{#if option.icon}
+							<span class={iconLg}>{@render option.icon()}</span>
+						{/if}
 						<Checkbox
 							{checked}
 							{disabled}

package/dist/styles/matte/CheckboxGroup.svelte.d.ts

@@ -4,6 +4,8 @@ import type { Tone } from '../../core/tones.js';
 export interface CheckboxOption {
     value: string;
     label: string;
+    /** Leading icon, 20px. Drawn in `boxed` mode only. */
+    icon?: Snippet;
     description?: string;
     disabled?: boolean;
 }

package/dist/styles/matte/Combobox.svelte

@@ -1,13 +1,17 @@
 <script lang="ts">
+	import type { Snippet } from 'svelte';
 	import { anchored } from '../../core/actions/anchor.js';
 	import { clickOutside, portal } from '../../core/actions/dismissable.js';
 	import { ListCursor, groupItems, matchQuery, revealIndex } from '../../core/list.svelte.js';
 	import { toneFocusWithinBorder, toneSoft, toneText, type Tone } from '../../core/tones.js';
 	import { useLocale } from '../../core/locale.svelte.js';
+	import { iconMd } from './icon.js';
 
 	export interface ComboboxOption {
 		value: string;
 		label: string;
+		/** Leading icon, 16px. */
+		icon?: Snippet;
 		/** Second line under the label. */
 		description?: string;
 		disabled?: boolean;
@@ -234,6 +238,7 @@
 							{index === active ? toneSoft[tone] : 'text-text-secondary'}"
 					>
 						<span class="flex items-center gap-2">
+							{#if option.icon}<span class={iconMd}>{@render option.icon()}</span>{/if}
 							<span class="min-w-0 flex-1 truncate">{option.label}</span>
 							{#if option.value === value}
 								<svg

package/dist/styles/matte/Combobox.svelte.d.ts

@@ -1,7 +1,10 @@
+import type { Snippet } from 'svelte';
 import { type Tone } from '../../core/tones.js';
 export interface ComboboxOption {
     value: string;
     label: string;
+    /** Leading icon, 16px. */
+    icon?: Snippet;
     /** Second line under the label. */
     description?: string;
     disabled?: boolean;

package/dist/styles/matte/CommandPalette.svelte

@@ -1,7 +1,11 @@
 <script module lang="ts">
+	import type { Snippet } from 'svelte';
+
 	export interface CommandItem {
 		id: string;
 		label: string;
+		/** Leading icon, 16px. */
+		icon?: Snippet;
 		/** Second line under the label. */
 		description?: string;
 		/** Items sharing a group are rendered under one heading. */
@@ -22,6 +26,7 @@
 	import { useLocale } from '../../core/locale.svelte.js';
 	import { toneSoft, type Tone } from '../../core/tones.js';
 	import { isTypingTarget } from '../../core/trigger.js';
+	import { iconMd } from './icon.js';
 	import Kbd from './Kbd.svelte';
 
 	interface Props {
@@ -218,6 +223,7 @@
 								{item.disabled ? 'pointer-events-none opacity-40' : ''}
 								{index === active ? toneSoft[tone] : 'text-text-secondary'}"
 						>
+							{#if item.icon}<span class={iconMd}>{@render item.icon()}</span>{/if}
 							<span class="flex min-w-0 flex-1 flex-col gap-0.5">
 								<span class="truncate">{item.label}</span>
 								{#if item.description}

package/dist/styles/matte/CommandPalette.svelte.d.ts

@@ -1,6 +1,9 @@
+import type { Snippet } from 'svelte';
 export interface CommandItem {
     id: string;
     label: string;
+    /** Leading icon, 16px. */
+    icon?: Snippet;
     /** Second line under the label. */
     description?: string;
     /** Items sharing a group are rendered under one heading. */

package/dist/styles/matte/Drawer.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
+	import { iconLg } from './icon.js';
 	import type { HTMLDialogAttributes } from 'svelte/elements';
 	import { useLocale } from '../../core/locale.svelte.js';
 	import { isBackdropClick, syncDialog } from '../../core/dialog.svelte.js';
@@ -15,6 +16,8 @@
 		size?: DrawerSize;
 		title?: string;
 		description?: string;
+		/** Leading icon beside the title. */
+		icon?: Snippet;
 		dismissible?: boolean;
 		footer?: Snippet;
 		onclose?: () => void;
@@ -27,6 +30,7 @@
 		size = 'md',
 		title,
 		description,
+		icon,
 		dismissible = true,
 		footer,
 		onclose,
@@ -92,6 +96,7 @@
 	<div class="flex h-full flex-col">
 		{#if title || dismissible}
 			<div class="flex items-start gap-4 border-b border-hairline px-5 py-4">
+				{#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>

package/dist/styles/matte/Drawer.svelte.d.ts

@@ -10,6 +10,8 @@ interface Props extends HTMLDialogAttributes {
     size?: DrawerSize;
     title?: string;
     description?: string;
+    /** Leading icon beside the title. */
+    icon?: Snippet;
     dismissible?: boolean;
     footer?: Snippet;
     onclose?: () => void;

package/dist/styles/matte/Footer.svelte

@@ -2,6 +2,8 @@
 	export interface FooterLink {
 		label: string;
 		href?: string;
+		/** Leading icon, 14px. */
+		icon?: Snippet;
 		external?: boolean;
 	}
 
@@ -14,6 +16,7 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
 	import { toneHoverText, type Tone } from '../../core/tones.js';
+	import { iconSm } from './icon.js';
 
 	interface Props {
 		columns?: FooterColumn[];
@@ -59,11 +62,12 @@
 												href={item.href}
 												target={item.external ? '_blank' : undefined}
 												rel={item.external ? 'noreferrer' : undefined}
-												class="font-sans text-sm text-text-secondary transition-colors duration-150 ease-brand-out {toneHoverText[
+												class="inline-flex items-center gap-2 font-sans text-sm text-text-secondary transition-colors duration-150 ease-brand-out {toneHoverText[
 													tone
 												]}"
 											>
-												{item.label}
+												{#if item.icon}<span class={iconSm}>{@render item.icon()}</span
+													>{/if}{item.label}
 												{#if item.external}<span aria-hidden="true" class="text-[0.85em]">↗</span
 													>{/if}
 											</a>

package/dist/styles/matte/Footer.svelte.d.ts

@@ -1,6 +1,8 @@
 export interface FooterLink {
     label: string;
     href?: string;
+    /** Leading icon, 14px. */
+    icon?: Snippet;
     external?: boolean;
 }
 export interface FooterColumn {

package/dist/styles/matte/Link.svelte

@@ -2,6 +2,7 @@
 	import type { Snippet } from 'svelte';
 	import type { HTMLAnchorAttributes } from 'svelte/elements';
 	import { focusRing, toneHoverText, toneRing, toneText, type Tone } from '../../core/tones.js';
+	import { iconSm } from './icon.js';
 
 	interface Props extends HTMLAnchorAttributes {
 		tone?: Tone;
@@ -11,6 +12,10 @@
 		external?: boolean;
 		/** Inherit the surrounding text colour instead of the tone. */
 		muted?: boolean;
+		/** Leading icon, 14px. */
+		icon?: Snippet;
+		/** Trailing icon, before the external mark. */
+		iconEnd?: Snippet;
 		children: Snippet;
 	}
 
@@ -19,6 +24,8 @@
 		underline = 'hover',
 		external = false,
 		muted = false,
+		icon,
+		iconEnd,
 		class: className = '',
 		children,
 		...rest
@@ -39,6 +46,8 @@
 		{underlines[underline]} {focusRing} {toneRing[tone]} {className}"
 	{...rest}
 >
+	{#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}
 </a>

package/dist/styles/matte/Link.svelte.d.ts

@@ -9,6 +9,10 @@ interface Props extends HTMLAnchorAttributes {
     external?: boolean;
     /** Inherit the surrounding text colour instead of the tone. */
     muted?: boolean;
+    /** Leading icon, 14px. */
+    icon?: Snippet;
+    /** Trailing icon, before the external mark. */
+    iconEnd?: Snippet;
     children: Snippet;
 }
 declare const Link: import("svelte").Component<Props, {}, "">;

package/dist/styles/matte/MenuItem.svelte

@@ -2,6 +2,7 @@
 	import type { Snippet } from 'svelte';
 	import type { HTMLButtonAttributes } from 'svelte/elements';
 	import { toneSoftHover, toneText, type Tone } from '../../core/tones.js';
+	import { iconMd } from './icon.js';
 
 	interface Props extends HTMLButtonAttributes {
 		/** Renders an `<a>` instead of a `<button>`. */
@@ -49,7 +50,7 @@
 			<path d="m2 7 3.2 3.2L12 3.6" stroke="currentColor" stroke-width="1.6" />
 		</svg>
 	{:else if icon}
-		<span class="flex size-3.5 shrink-0 items-center justify-center">{@render icon()}</span>
+		<span class={iconMd}>{@render icon()}</span>
 	{/if}
 	<span class="min-w-0 flex-1 truncate">{@render children()}</span>
 	{#if shortcut}

package/dist/styles/matte/Modal.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
+	import { iconLg } from './icon.js';
 	import type { HTMLDialogAttributes } from 'svelte/elements';
 	import { useLocale } from '../../core/locale.svelte.js';
 	import { isBackdropClick, syncDialog } from '../../core/dialog.svelte.js';
@@ -11,6 +12,8 @@
 		open?: boolean;
 		title?: string;
 		description?: string;
+		/** Leading icon beside the title. */
+		icon?: Snippet;
 		size?: ModalSize;
 		/** Clicking the backdrop or pressing Escape closes the dialog. */
 		dismissible?: boolean;
@@ -26,6 +29,7 @@
 		open = $bindable(false),
 		title,
 		description,
+		icon,
 		size = 'md',
 		dismissible = true,
 		showClose,
@@ -75,6 +79,7 @@
 	<div class="flex flex-col">
 		{#if title || closable}
 			<div class="flex items-start gap-4 border-b border-hairline px-5 py-4">
+				{#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>

package/dist/styles/matte/Modal.svelte.d.ts

@@ -6,6 +6,8 @@ interface Props extends HTMLDialogAttributes {
     open?: boolean;
     title?: string;
     description?: string;
+    /** Leading icon beside the title. */
+    icon?: Snippet;
     size?: ModalSize;
     /** Clicking the backdrop or pressing Escape closes the dialog. */
     dismissible?: boolean;

package/dist/styles/matte/MultiSelect.svelte

@@ -1,7 +1,11 @@
 <script module lang="ts">
+	import type { Snippet } from 'svelte';
+
 	export interface MultiSelectOption {
 		value: string;
 		label: string;
+		/** Leading icon, 16px. */
+		icon?: Snippet;
 		description?: string;
 		disabled?: boolean;
 		group?: string;
@@ -13,6 +17,7 @@
 	import { clickOutside, portal } from '../../core/actions/dismissable.js';
 	import { ListCursor, groupItems, matchQuery, revealIndex } from '../../core/list.svelte.js';
 	import { useLocale } from '../../core/locale.svelte.js';
+	import { iconMd, iconSm } from './icon.js';
 	import { toneFocusWithinBorder, toneSoft, toneText, type Tone } from '../../core/tones.js';
 
 	interface Props {
@@ -153,7 +158,7 @@
 					tone
 				]}"
 			>
-				{option.label}
+				{#if option.icon}<span class={iconSm}>{@render option.icon()}</span>{/if}{option.label}
 				<button
 					type="button"
 					onclick={() => remove(option)}
@@ -259,6 +264,7 @@
 								</svg>
 							{/if}
 						</span>
+						{#if option.icon}<span class={iconMd}>{@render option.icon()}</span>{/if}
 						<span class="flex min-w-0 flex-1 flex-col gap-0.5">
 							<span class="truncate">{option.label}</span>
 							{#if option.description}

package/dist/styles/matte/MultiSelect.svelte.d.ts

@@ -1,6 +1,9 @@
+import type { Snippet } from 'svelte';
 export interface MultiSelectOption {
     value: string;
     label: string;
+    /** Leading icon, 16px. */
+    icon?: Snippet;
     description?: string;
     disabled?: boolean;
     group?: string;

package/dist/styles/matte/Navbar.svelte

@@ -2,6 +2,8 @@
 	export interface NavItem {
 		label: string;
 		href?: string;
+		/** Leading icon, 16px. */
+		icon?: Snippet;
 		/** Marks the current page — also sets `aria-current`. */
 		active?: boolean;
 		disabled?: boolean;
@@ -15,6 +17,7 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
 	import { useLocale } from '../../core/locale.svelte.js';
+	import { iconMd } from './icon.js';
 	import { focusRing, toneRing, toneText, type Tone } from '../../core/tones.js';
 	import Drawer from './Drawer.svelte';
 	import Dropdown from './Dropdown.svelte';
@@ -82,6 +85,7 @@
 										? toneText[tone]
 										: 'text-text-secondary hover:text-text'}"
 								>
+									{#if item.icon}<span class={iconMd}>{@render item.icon()}</span>{/if}
 									{item.label}
 									<svg class="size-3" viewBox="0 0 16 16" fill="none" aria-hidden="true">
 										<path
@@ -94,7 +98,12 @@
 								</button>
 							{/snippet}
 							{#each item.items as child (child.label)}
-								<MenuItem href={child.href} disabled={child.disabled} selected={child.active}>
+								<MenuItem
+									href={child.href}
+									disabled={child.disabled}
+									selected={child.active}
+									icon={child.icon}
+								>
 									{child.label}
 								</MenuItem>
 							{/each}
@@ -109,6 +118,7 @@
 								? 'pointer-events-none opacity-50'
 								: ''}"
 						>
+							{#if item.icon}<span class={iconMd}>{@render item.icon()}</span>{/if}
 							{item.label}
 							{#if item.badge !== undefined}
 								<span class="font-mono text-[11px] text-text-muted">{item.badge}</span>
@@ -154,7 +164,10 @@
 						? toneText[tone]
 						: 'text-text-secondary'} {item.disabled ? 'pointer-events-none opacity-50' : ''}"
 				>
-					{item.label}
+					<span class="flex min-w-0 items-center gap-2.5">
+						{#if item.icon}<span class={iconMd}>{@render item.icon()}</span>{/if}
+						{item.label}
+					</span>
 					{#if item.badge !== undefined}
 						<span class="font-mono text-[11px] text-text-muted">{item.badge}</span>
 					{/if}
@@ -166,9 +179,10 @@
 								<a
 									href={child.href}
 									onclick={() => (menuOpen = false)}
-									class="block py-2 font-sans text-sm text-text-muted"
+									class="flex items-center gap-2.5 py-2 font-sans text-sm text-text-muted"
 								>
-									{child.label}
+									{#if child.icon}<span class={iconMd}>{@render child.icon()}</span
+										>{/if}{child.label}
 								</a>
 							</li>
 						{/each}

package/dist/styles/matte/Navbar.svelte.d.ts

@@ -1,6 +1,8 @@
 export interface NavItem {
     label: string;
     href?: string;
+    /** Leading icon, 16px. */
+    icon?: Snippet;
     /** Marks the current page — also sets `aria-current`. */
     active?: boolean;
     disabled?: boolean;

package/dist/styles/matte/PricingCard.svelte

@@ -2,6 +2,7 @@
 	import type { Snippet } from 'svelte';
 	import type { HTMLAttributes } from 'svelte/elements';
 	import { toneBorder, toneFill, toneSoft, toneText, type Tone } from '../../core/tones.js';
+	import { iconMd } from './icon.js';
 
 	interface Props extends HTMLAttributes<HTMLDivElement> {
 		name: string;
@@ -12,6 +13,8 @@
 		description?: string;
 		/** One line each. Rendered with a tick. */
 		features?: string[];
+		/** Replaces the tick beside every feature. */
+		featureIcon?: Snippet;
 		/** Pill in the top corner, e.g. "Most popular". */
 		badge?: string;
 		/** Thicker border and a tinted header — for the plan you want chosen. */
@@ -29,6 +32,7 @@
 		period,
 		description,
 		features = [],
+		featureIcon,
 		badge,
 		featured = false,
 		tone = 'brand',
@@ -83,14 +87,18 @@
 		<ul class="flex flex-1 flex-col gap-3 border-t border-hairline p-5">
 			{#each features as feature (feature)}
 				<li class="flex items-start gap-3 font-sans text-sm text-text-secondary">
-					<svg
-						class="mt-0.5 size-4 shrink-0 {toneText[tone]}"
-						viewBox="0 0 16 16"
-						fill="none"
-						aria-hidden="true"
-					>
-						<path d="m3 8 3.2 3.2L13 4.4" stroke="currentColor" stroke-width="1.6" />
-					</svg>
+					{#if featureIcon}
+						<span class="mt-0.5 {iconMd}">{@render featureIcon()}</span>
+					{:else}
+						<svg
+							class="mt-0.5 size-4 shrink-0 {toneText[tone]}"
+							viewBox="0 0 16 16"
+							fill="none"
+							aria-hidden="true"
+						>
+							<path d="m3 8 3.2 3.2L13 4.4" stroke="currentColor" stroke-width="1.6" />
+						</svg>
+					{/if}
 					<span class="leading-snug">{feature}</span>
 				</li>
 			{/each}

package/dist/styles/matte/PricingCard.svelte.d.ts

@@ -10,6 +10,8 @@ interface Props extends HTMLAttributes<HTMLDivElement> {
     description?: string;
     /** One line each. Rendered with a tick. */
     features?: string[];
+    /** Replaces the tick beside every feature. */
+    featureIcon?: Snippet;
     /** Pill in the top corner, e.g. "Most popular". */
     badge?: string;
     /** Thicker border and a tinted header — for the plan you want chosen. */

package/dist/styles/matte/RadioGroup.svelte

@@ -3,10 +3,13 @@
 	import type { HTMLFieldsetAttributes } from 'svelte/elements';
 	import Radio from './Radio.svelte';
 	import type { Tone } from '../../core/tones.js';
+	import { iconLg } from './icon.js';
 
 	export interface RadioOption {
 		value: string;
 		label: string;
+		/** Leading icon, 20px. Drawn in `boxed` mode only. */
+		icon?: Snippet;
 		description?: string;
 		disabled?: boolean;
 	}
@@ -60,6 +63,9 @@
 							{value === option.value ? 'border-text bg-bg-alt' : 'border-hairline hover:border-hairline-strong'}
 							{option.disabled ? 'pointer-events-none opacity-50' : ''}"
 					>
+						{#if option.icon}
+							<span class={iconLg}>{@render option.icon()}</span>
+						{/if}
 						<Radio
 							bind:group={value}
 							value={option.value}

package/dist/styles/matte/RadioGroup.svelte.d.ts

@@ -4,6 +4,8 @@ import type { Tone } from '../../core/tones.js';
 export interface RadioOption {
     value: string;
     label: string;
+    /** Leading icon, 20px. Drawn in `boxed` mode only. */
+    icon?: Snippet;
     description?: string;
     disabled?: boolean;
 }

package/dist/styles/matte/SegmentedControl.svelte

@@ -1,10 +1,14 @@
 <script lang="ts">
+	import type { Snippet } from 'svelte';
 	import type { HTMLAttributes } from 'svelte/elements';
 	import { focusRing, toneRing, toneSoft, type Tone } from '../../core/tones.js';
+	import { iconMd } from './icon.js';
 
 	export interface SegmentOption {
 		value: string;
 		label: string;
+		/** Leading icon, 16px. */
+		icon?: Snippet;
 		disabled?: boolean;
 	}
 
@@ -20,6 +24,8 @@
 		tone?: Tone;
 		/** Spread the segments evenly across the full width. */
 		fullWidth?: boolean;
+		/** Icons only — each option's `label` becomes its accessible name. */
+		iconOnly?: boolean;
 		label?: string;
 		disabled?: boolean;
 		onchange?: (value: string) => void;
@@ -32,6 +38,7 @@
 		size = 'md',
 		tone = 'brand',
 		fullWidth = false,
+		iconOnly = false,
 		label,
 		disabled = false,
 		class: className = '',
@@ -44,6 +51,11 @@
 		md: 'h-9 px-3.5 text-sm'
 	};
 
+	const squares: Record<SegmentedSize, string> = {
+		sm: 'size-8 text-[13px]',
+		md: 'size-9 text-sm'
+	};
+
 	function select(option: SegmentOption) {
 		if (option.disabled || disabled) return;
 		value = option.value;
@@ -74,14 +86,16 @@
 			type="button"
 			role="radio"
 			aria-checked={value === option.value}
+			aria-label={iconOnly ? option.label : undefined}
 			disabled={option.disabled || disabled}
 			tabindex={value === option.value ? 0 : -1}
 			onclick={() => select(option)}
 			class="inline-flex items-center justify-center font-sans whitespace-nowrap transition-colors duration-150 ease-brand-out disabled:pointer-events-none disabled:opacity-40
-				{sizes[size]} {focusRing} {toneRing[tone]}
+				{iconOnly ? squares[size] : sizes[size]} {focusRing} {toneRing[tone]}
 				{value === option.value ? `${toneSoft[tone]} font-medium` : 'text-text-secondary hover:text-text'}"
 		>
-			{option.label}
+			{#if option.icon}<span class={iconMd}>{@render option.icon()}</span>{/if}
+			{#if !iconOnly}{option.label}{/if}
 		</button>
 	{/each}
 	{#if name}<input type="hidden" {name} {value} />{/if}

package/dist/styles/matte/SegmentedControl.svelte.d.ts

@@ -1,8 +1,11 @@
+import type { Snippet } from 'svelte';
 import type { HTMLAttributes } from 'svelte/elements';
 import { type Tone } from '../../core/tones.js';
 export interface SegmentOption {
     value: string;
     label: string;
+    /** Leading icon, 16px. */
+    icon?: Snippet;
     disabled?: boolean;
 }
 export type SegmentedSize = 'sm' | 'md';
@@ -16,6 +19,8 @@ interface Props extends Omit<HTMLAttributes<HTMLDivElement>, 'onchange'> {
     tone?: Tone;
     /** Spread the segments evenly across the full width. */
     fullWidth?: boolean;
+    /** Icons only — each option's `label` becomes its accessible name. */
+    iconOnly?: boolean;
     label?: string;
     disabled?: boolean;
     onchange?: (value: string) => void;

package/dist/styles/matte/Sidebar.svelte

@@ -36,6 +36,7 @@
 
 <script lang="ts">
 	import { useLocale } from '../../core/locale.svelte.js';
+	import { iconMd } from './icon.js';
 	import { focusRing, toneRing, toneSoft, type Tone } from '../../core/tones.js';
 
 	interface Props {
@@ -126,7 +127,7 @@
 <!-- One box for every glyph, so rows line up whether or not an item has one. -->
 {#snippet glyph(item: SidebarItem)}
 	{#if item.icon}
-		<span class="grid size-4 shrink-0 place-items-center *:size-4">{@render item.icon()}</span>
+		<span class={iconMd}>{@render item.icon()}</span>
 	{/if}
 {/snippet}
 

package/dist/styles/matte/Stat.svelte

@@ -1,6 +1,8 @@
 <script lang="ts">
+	import type { Snippet } from 'svelte';
 	import type { HTMLAttributes } from 'svelte/elements';
 	import { toneText, type Tone } from '../../core/tones.js';
+	import { iconMd } from './icon.js';
 
 	export type StatTrend = 'up' | 'down' | 'flat';
 
@@ -11,6 +13,8 @@
 		delta?: string;
 		trend?: StatTrend;
 		hint?: string;
+		/** Leading icon on the label row. */
+		icon?: Snippet;
 		/** Colour of the value itself. Leave unset for plain `text`. */
 		tone?: Tone;
 	}
@@ -21,6 +25,7 @@
 		delta,
 		trend = 'flat',
 		hint,
+		icon,
 		tone,
 		class: className = '',
 		...rest
@@ -31,7 +36,9 @@
 </script>
 
 <div class="flex flex-col gap-1 font-sans {className}" {...rest}>
-	<span class="font-mono text-xs tracking-wide text-text-muted uppercase">{label}</span>
+	<span class="flex items-center gap-2 font-mono text-xs tracking-wide text-text-muted uppercase"
+		>{#if icon}<span class={iconMd}>{@render icon()}</span>{/if}{label}</span
+	>
 	<div class="flex items-baseline gap-2">
 		<span
 			class="font-heading text-3xl font-medium tracking-tight {tone ? toneText[tone] : 'text-text'}"