@nqmcreative/ui 0.2.2 → 0.3.0

package/dist/styles/paper/Table.svelte

@@ -32,6 +32,16 @@
 		/** Header stays put while the body scrolls — pair with a `max-h-*` class. */
 		stickyHeader?: boolean;
 
+		/** Bar above the table — a title, a search field, a filter row. */
+		header?: Snippet;
+		/** Bar below the table — pagination, a total, a summary line. */
+		footer?: Snippet;
+		/**
+		 * Shown in place of `header` while rows are ticked, after the count and the
+		 * clear button. Passing it is what turns the bulk bar on.
+		 */
+		bulkActions?: Snippet<[{ selected: string[]; clear: () => void }]>;
+
 		/** Bindable. Set it to sort; leave `sortable` columns to drive it. */
 		sort?: TableSort | null;
 		/** Sort the rows here rather than refetching them server-side. Default true. */
@@ -57,6 +67,9 @@
 		hoverable = true,
 		compact = false,
 		stickyHeader = false,
+		header,
+		footer,
+		bulkActions,
 		sort = $bindable(null),
 		sortLocally = true,
 		onsort,
@@ -106,112 +119,155 @@
 		selected = toggleKey(selected, keyOf(row));
 		onselect?.(selected);
 	}
+
+	function clearSelection() {
+		selected = [];
+		onselect?.(selected);
+	}
+
+	/** The bulk bar takes the header's place, so only one of the two is up. */
+	const bulkBar = $derived(selectable && bulkActions !== undefined && selected.length > 0);
 </script>
 
 <div
-	class="w-full overflow-auto rounded-lg border border-hairline bg-bg shadow-xs {className}"
+	class="flex w-full flex-col overflow-hidden rounded-lg border border-hairline bg-bg shadow-xs {className}"
 	{...rest}
 >
-	<table class="w-full border-collapse font-sans text-sm">
-		{#if caption}
-			<caption
-				class="border-b border-hairline px-4 py-3 text-left font-sans text-[13px] text-text-muted"
+	{#if bulkBar}
+		<div
+			class="flex flex-wrap items-center gap-3 border-b border-hairline bg-brand-light px-4 py-3"
+		>
+			<span class="font-sans text-[13px] font-semibold text-text">
+				{selected.length}
+				{t.current.selected}
+			</span>
+			<button
+				type="button"
+				onclick={clearSelection}
+				class="rounded font-sans text-[13px] font-medium text-text-muted transition-colors duration-150 hover:text-text focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-current"
 			>
-				{caption}
-			</caption>
-		{/if}
-		<thead class={stickyHeader ? 'sticky top-0 z-10' : ''}>
-			<tr class="border-b border-hairline bg-bg-alt">
-				{#if selectable}
-					<th scope="col" class="w-10 {pad}">
-						<Checkbox
-							checked={allSelected}
-							indeterminate={someSelected}
-							{tone}
-							aria-label={t.current.selectAllRows}
-							onchange={toggleAll}
-						/>
-					</th>
-				{/if}
-				{#each columns as column (column.key)}
-					<th
-						scope="col"
-						aria-sort={sort?.key === column.key
-							? sort.direction === 'asc'
-								? 'ascending'
-								: 'descending'
-							: undefined}
-						class="text-[13px] font-semibold text-text-muted {pad} {aligns[
-							column.align ?? 'left'
-						]} {column.class ?? ''}"
-					>
-						{#if column.sortable}
-							<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
+				{t.current.clear}
+			</button>
+			<div class="ml-auto flex flex-wrap items-center gap-2">
+				{@render bulkActions?.({ selected, clear: clearSelection })}
+			</div>
+		</div>
+	{:else if header}
+		<div
+			class="flex flex-wrap items-center gap-3 border-b border-hairline px-4 py-3 font-sans text-[13px] text-text-secondary"
+		>
+			{@render header()}
+		</div>
+	{/if}
+	<div class="min-h-0 w-full flex-1 overflow-auto">
+		<table class="w-full border-collapse font-sans text-sm">
+			{#if caption}
+				<caption
+					class="border-b border-hairline px-4 py-3 text-left font-sans text-[13px] text-text-muted"
+				>
+					{caption}
+				</caption>
+			{/if}
+			<thead class={stickyHeader ? 'sticky top-0 z-10' : ''}>
+				<tr class="border-b border-hairline bg-bg-alt">
+					{#if selectable}
+						<th scope="col" class="w-10 {pad}">
+							<Checkbox
+								checked={allSelected}
+								indeterminate={someSelected}
+								{tone}
+								aria-label={t.current.selectAllRows}
+								onchange={toggleAll}
+							/>
+						</th>
+					{/if}
+					{#each columns as column (column.key)}
+						<th
+							scope="col"
+							aria-sort={sort?.key === column.key
+								? sort.direction === 'asc'
+									? 'ascending'
+									: 'descending'
+								: undefined}
+							class="text-[13px] font-semibold text-text-muted {pad} {aligns[
+								column.align ?? 'left'
+							]} {column.class ?? ''}"
+						>
+							{#if column.sortable}
+								<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
 									{sort?.key === column.key ? 'text-text' : ''}"
-							>
+								>
+									{column.label}
+									<span class="text-[9px] leading-none" aria-hidden="true">
+										{#if sort?.key === column.key}
+											{sort.direction === 'asc' ? '▲' : '▼'}
+										{:else}
+											⇅
+										{/if}
+									</span>
+								</button>
+							{:else}
 								{column.label}
-								<span class="text-[9px] leading-none" aria-hidden="true">
-									{#if sort?.key === column.key}
-										{sort.direction === 'asc' ? '▲' : '▼'}
-									{:else}
-										⇅
-									{/if}
-								</span>
-							</button>
-						{:else}
-							{column.label}
-						{/if}
-					</th>
-				{/each}
-			</tr>
-		</thead>
-		<tbody>
-			{#if sorted.length === 0}
-				<tr>
-					<td
-						colspan={columns.length + (selectable ? 1 : 0)}
-						class="px-4 py-10 text-center text-sm text-text-muted"
-					>
-						{#if empty}{@render empty()}{:else}{t.current.noData}{/if}
-					</td>
+							{/if}
+						</th>
+					{/each}
 				</tr>
-			{:else}
-				{#each sorted as row, i (selectable ? keyOf(row) : i)}
-					{@const isSelected = selectable && selected.includes(keyOf(row))}
-					<tr
-						aria-selected={selectable ? isSelected : undefined}
-						class="border-b border-hairline last:border-b-0
+			</thead>
+			<tbody>
+				{#if sorted.length === 0}
+					<tr>
+						<td
+							colspan={columns.length + (selectable ? 1 : 0)}
+							class="px-4 py-10 text-center text-sm text-text-muted"
+						>
+							{#if empty}{@render empty()}{:else}{t.current.noData}{/if}
+						</td>
+					</tr>
+				{:else}
+					{#each sorted as row, i (selectable ? keyOf(row) : i)}
+						{@const isSelected = selectable && selected.includes(keyOf(row))}
+						<tr
+							aria-selected={selectable ? isSelected : undefined}
+							class="border-b border-hairline last:border-b-0
 							{isSelected ? 'bg-brand-light' : striped && i % 2 === 1 ? 'bg-bg-alt' : ''}
 							{hoverable ? 'transition-colors duration-150 hover:bg-bg-alt' : ''}"
-					>
-						{#if selectable}
-							<td class={pad}>
-								<Checkbox
-									checked={isSelected}
-									{tone}
-									aria-label={t.current.selectRow}
-									onchange={() => toggleRow(row)}
-								/>
-							</td>
-						{/if}
-						{#each columns as column (column.key)}
-							<td
-								class="text-text-secondary {pad} {aligns[column.align ?? 'left']} {column.class ??
-									''}"
-							>
-								{#if cell}
-									{@render cell({ row, column, value: row[column.key] })}
-								{:else}
-									{row[column.key] ?? ''}
-								{/if}
-							</td>
-						{/each}
-					</tr>
-				{/each}
-			{/if}
-		</tbody>
-	</table>
+						>
+							{#if selectable}
+								<td class={pad}>
+									<Checkbox
+										checked={isSelected}
+										{tone}
+										aria-label={t.current.selectRow}
+										onchange={() => toggleRow(row)}
+									/>
+								</td>
+							{/if}
+							{#each columns as column (column.key)}
+								<td
+									class="text-text-secondary {pad} {aligns[column.align ?? 'left']} {column.class ??
+										''}"
+								>
+									{#if cell}
+										{@render cell({ row, column, value: row[column.key] })}
+									{:else}
+										{row[column.key] ?? ''}
+									{/if}
+								</td>
+							{/each}
+						</tr>
+					{/each}
+				{/if}
+			</tbody>
+		</table>
+	</div>
+	{#if footer}
+		<div
+			class="flex flex-wrap items-center gap-3 border-t border-hairline px-4 py-3 font-sans text-[13px] text-text-secondary"
+		>
+			{@render footer()}
+		</div>
+	{/if}
 </div>

package/dist/styles/paper/Table.svelte.d.ts

@@ -29,6 +29,18 @@ declare function $$render<T extends Record<string, unknown>>(): {
         compact?: boolean;
         /** Header stays put while the body scrolls — pair with a `max-h-*` class. */
         stickyHeader?: boolean;
+        /** Bar above the table — a title, a search field, a filter row. */
+        header?: Snippet;
+        /** Bar below the table — pagination, a total, a summary line. */
+        footer?: Snippet;
+        /**
+         * Shown in place of `header` while rows are ticked, after the count and the
+         * clear button. Passing it is what turns the bulk bar on.
+         */
+        bulkActions?: Snippet<[{
+            selected: string[];
+            clear: () => void;
+        }]>;
         /** Bindable. Set it to sort; leave `sortable` columns to drive it. */
         sort?: TableSort | null;
         /** Sort the rows here rather than refetching them server-side. Default true. */

package/dist/styles/paper/Tabs.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import type { Snippet } from 'svelte';
 	import type { HTMLAttributes } from 'svelte/elements';
 	import {
 		focusRing,
@@ -8,10 +9,13 @@
 		toneText,
 		type Tone
 	} from '../../core/tones.js';
+	import { iconMd } from './icon.js';
 
 	export interface TabItem {
 		value: string;
 		label: string;
+		/** Leading icon, 16px. */
+		icon?: Snippet;
 		disabled?: boolean;
 		/** Small count/label rendered after the tab title. */
 		badge?: string | number;
@@ -89,6 +93,7 @@
 			onclick={() => select(item)}
 			class={tabClass(value === item.value)}
 		>
+			{#if item.icon}<span class={iconMd}>{@render item.icon()}</span>{/if}
 			{item.label}
 			{#if item.badge !== undefined}
 				<span

package/dist/styles/paper/Tabs.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 TabItem {
     value: string;
     label: string;
+    /** Leading icon, 16px. */
+    icon?: Snippet;
     disabled?: boolean;
     /** Small count/label rendered after the tab title. */
     badge?: string | number;

package/dist/styles/paper/Toaster.svelte

@@ -4,6 +4,7 @@
 	import { portal } from '../../core/actions/dismissable.js';
 	import { toast } from '../../core/toast.svelte.js';
 	import { toneText } from '../../core/tones.js';
+	import { iconMd } from './icon.js';
 	import Spinner from './Spinner.svelte';
 	import { useLocale } from '../../core/locale.svelte.js';
 
@@ -61,6 +62,8 @@
 			<span class="mt-0.5 shrink-0 {toneText[item.tone]}">
 				{#if item.loading}
 					<Spinner size="sm" label="" />
+				{:else if item.icon}
+					<span class={iconMd}>{@render item.icon()}</span>
 				{:else if item.tone === 'success'}
 					<svg class="size-4" viewBox="0 0 16 16" fill="none" aria-hidden="true">
 						<circle cx="8" cy="8" r="6.5" stroke="currentColor" stroke-width="1.5" />

package/dist/styles/paper/fonts.css

@@ -1,8 +1,8 @@
 /*
- * Optional: Plus Jakarta Sans, the face paper is designed around. Import this
- * only if your project doesn't already self-host or load it another way —
- * without it the tokens fall back to the system stack, which works but reads
- * harder and colder.
+ * Optional: the two faces paper is designed around — Plus Jakarta Sans
+ * (headings) and Work Sans (body). Import this only if your project doesn't
+ * already self-host or load them another way — without it the tokens fall back
+ * to the system stack, which works but reads harder and colder.
  *
  * These are plain `@font-face` rules rather than an `@import` of the Google
  * stylesheet on purpose: `@import` is only valid before every other rule, so a
@@ -11,13 +11,13 @@
  * you put it, and it skips the CSS-to-CSS round trip before the font files
  * start downloading.
  *
- * Two rules rather than matte's eight: this is a variable font, so one file per
- * subset covers every weight from 400 to 700. Latin and Latin Extended only —
- * around 49 kB in total. Add
+ * Four rules for two families: both are variable fonts, so one file per subset
+ * covers every weight from 400 to 700. Latin and Latin Extended only. Add
  * `<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>` to
  * your document head to open the connection earlier.
  */
 
+/* --- Plus Jakarta Sans --- */
 /* latin */
 @font-face {
 	font-family: 'Plus Jakarta Sans';
@@ -44,3 +44,30 @@
 		U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F,
 		U+A720-A7FF;
 }
+
+/* --- Work Sans --- */
+/* latin */
+@font-face {
+	font-family: 'Work Sans';
+	font-style: normal;
+	font-weight: 400 700;
+	font-display: swap;
+	src: url(https://fonts.gstatic.com/s/worksans/v24/QGYsz_wNahGAdqQ43Rh_fKDp.woff2) format('woff2');
+	unicode-range:
+		U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329,
+		U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+/* latin-ext */
+@font-face {
+	font-family: 'Work Sans';
+	font-style: normal;
+	font-weight: 400 700;
+	font-display: swap;
+	src: url(https://fonts.gstatic.com/s/worksans/v24/QGYsz_wNahGAdqQ43Rh_cqDpp_k.woff2)
+		format('woff2');
+	unicode-range:
+		U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329,
+		U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F,
+		U+A720-A7FF;
+}

package/dist/styles/paper/icon.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The box a consumer-supplied icon renders into.
+ *
+ * Every icon in the library is a `Snippet` the app writes — the package ships
+ * no icon set and no runtime dependency — so the component has to size the
+ * glyph rather than trust it. The `*:` variant hits the snippet's own element,
+ * which is what keeps a bare `<svg viewBox="0 0 16 16">` from laying out at its
+ * intrinsic 300×150.
+ *
+ * Kept per style rather than in `core/`: an app only `@source`s the style
+ * folder it installed, so a class string living outside it would never be
+ * generated by Tailwind.
+ */
+/** 14px — menu rows, chips, anything sitting on one line of small text. */
+export declare const iconSm = "grid size-3.5 shrink-0 place-items-center *:size-3.5";
+/** 16px — the default: nav items, tabs, buttons, list rows. */
+export declare const iconMd = "grid size-4 shrink-0 place-items-center *:size-4";
+/** 20px — headers, stats, anything sitting beside a heading. */
+export declare const iconLg = "grid size-5 shrink-0 place-items-center *:size-5";
+/** 24px — dialog and empty-state marks. */
+export declare const iconXl = "grid size-6 shrink-0 place-items-center *:size-6";

package/dist/styles/paper/icon.js

@@ -0,0 +1,21 @@
+/**
+ * The box a consumer-supplied icon renders into.
+ *
+ * Every icon in the library is a `Snippet` the app writes — the package ships
+ * no icon set and no runtime dependency — so the component has to size the
+ * glyph rather than trust it. The `*:` variant hits the snippet's own element,
+ * which is what keeps a bare `<svg viewBox="0 0 16 16">` from laying out at its
+ * intrinsic 300×150.
+ *
+ * Kept per style rather than in `core/`: an app only `@source`s the style
+ * folder it installed, so a class string living outside it would never be
+ * generated by Tailwind.
+ */
+/** 14px — menu rows, chips, anything sitting on one line of small text. */
+export const iconSm = 'grid size-3.5 shrink-0 place-items-center *:size-3.5';
+/** 16px — the default: nav items, tabs, buttons, list rows. */
+export const iconMd = 'grid size-4 shrink-0 place-items-center *:size-4';
+/** 20px — headers, stats, anything sitting beside a heading. */
+export const iconLg = 'grid size-5 shrink-0 place-items-center *:size-5';
+/** 24px — dialog and empty-state marks. */
+export const iconXl = 'grid size-6 shrink-0 place-items-center *:size-6';

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

@@ -22,8 +22,6 @@ export { default as Switch } from './Switch.svelte';
 export type { SwitchSize } from './Switch.svelte';
 export { default as Field } from './Field.svelte';
 export { default as Label } from './Label.svelte';
-export { default as PasswordInput } from './PasswordInput.svelte';
-export { default as NumberInput } from './NumberInput.svelte';
 export { default as Slider } from './Slider.svelte';
 export { default as RadioGroup } from './RadioGroup.svelte';
 export type { RadioOption } from './RadioGroup.svelte';
@@ -76,7 +74,7 @@ export type { StepItem } from './Steps.svelte';
 export { default as Navbar } from './Navbar.svelte';
 export type { NavItem } from './Navbar.svelte';
 export { default as Sidebar } from './Sidebar.svelte';
-export type { SidebarItem, SidebarSection } from './Sidebar.svelte';
+export type { SidebarVariant, SidebarItem, SidebarSection } from './Sidebar.svelte';
 export { default as Footer } from './Footer.svelte';
 export type { FooterLink, FooterColumn } from './Footer.svelte';
 export { default as HeroSection } from './HeroSection.svelte';

package/dist/styles/paper/index.js

@@ -21,8 +21,6 @@ export { default as Radio } from './Radio.svelte';
 export { default as Switch } from './Switch.svelte';
 export { default as Field } from './Field.svelte';
 export { default as Label } from './Label.svelte';
-export { default as PasswordInput } from './PasswordInput.svelte';
-export { default as NumberInput } from './NumberInput.svelte';
 export { default as Slider } from './Slider.svelte';
 export { default as RadioGroup } from './RadioGroup.svelte';
 export { default as CheckboxGroup } from './CheckboxGroup.svelte';

package/dist/styles/paper/theme.css

@@ -78,16 +78,19 @@
 
 	/* --- type --- */
 	/*
-	 * Plus Jakarta Sans: rounded terminals, open counters, low contrast. Softer
-	 * than a system stack, which lands on Segoe UI for most readers and gives
-	 * paper's generous spacing nothing warm to sit in.
+	 * Work Sans sets running text in every style, so a project that swaps the
+	 * word after `@nqmcreative/ui/` keeps the same reading rhythm and only the
+	 * headings change voice.
 	 *
-	 * One variable file covers 400 to 700, so this costs a single request per
-	 * subset — see `fonts.css`. Everything degrades to the system stack if that
-	 * file is not imported, so the webfont stays optional.
+	 * Plus Jakarta Sans keeps the headings: rounded terminals, open counters,
+	 * low contrast — softer than a system stack, which lands on Segoe UI for
+	 * most readers and gives paper's generous spacing nothing warm to sit in.
+	 *
+	 * Both are variable files, one request per subset — see `fonts.css`.
+	 * Everything degrades to the system stack if that file is not imported, so
+	 * the webfonts stay optional.
 	 */
-	--font-sans:
-		'Plus Jakarta Sans', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
+	--font-sans: 'Work Sans', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
 	--font-heading:
 		'Plus Jakarta Sans', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
 	--font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace;

package/dist/styles/sprout/AccordionItem.svelte

@@ -2,6 +2,7 @@
 	import type { Snippet } from 'svelte';
 	import type { HTMLAttributes } from 'svelte/elements';
 	import { toneText, type Tone } from '../../core/tones.js';
+	import { iconMd } from './icon.js';
 
 	interface Props extends HTMLAttributes<HTMLDetailsElement> {
 		title: string;
@@ -9,6 +10,8 @@
 		tone?: Tone;
 		/** Short text on the right of the summary row. */
 		meta?: string;
+		/** Leading icon on the summary row. */
+		icon?: Snippet;
 		children: Snippet;
 	}
 
@@ -17,6 +20,7 @@
 		open = $bindable(false),
 		tone = 'brand',
 		meta,
+		icon,
 		class: className = '',
 		children,
 		...rest
@@ -27,6 +31,7 @@
 	<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"
 	>
+		{#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

package/dist/styles/sprout/AccordionItem.svelte.d.ts

@@ -7,6 +7,8 @@ interface Props extends HTMLAttributes<HTMLDetailsElement> {
     tone?: Tone;
     /** Short text on the right of the summary row. */
     meta?: string;
+    /** Leading icon on the summary row. */
+    icon?: Snippet;
     children: Snippet;
 }
 declare const AccordionItem: import("svelte").Component<Props, {}, "open">;

package/dist/styles/sprout/Avatar.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import type { Snippet } from 'svelte';
 	import type { HTMLAttributes } from 'svelte/elements';
 	import { toneSoft, type Tone } from '../../core/tones.js';
 
@@ -13,6 +14,8 @@
 		tone?: Tone;
 		/** Rounded square instead of the default circle. */
 		squared?: boolean;
+		/** Drawn instead of the initials when there is no `src` — a user mark. */
+		fallback?: Snippet;
 	}
 
 	let {
@@ -22,6 +25,7 @@
 		size = 'md',
 		tone = 'brand',
 		squared = false,
+		fallback,
 		class: className = '',
 		...rest
 	}: Props = $props();
@@ -34,6 +38,15 @@
 		xl: 'size-16 text-lg'
 	};
 
+	// The mark tracks the initials: about half the circle, whatever the size.
+	const glyphs: Record<AvatarSize, string> = {
+		xs: 'grid place-items-center *:size-3',
+		sm: 'grid place-items-center *:size-4',
+		md: 'grid place-items-center *:size-5',
+		lg: 'grid place-items-center *:size-6',
+		xl: 'grid place-items-center *:size-8'
+	};
+
 	const initials = $derived(
 		name
 			.trim()
@@ -54,6 +67,8 @@
 >
 	{#if src}
 		<img {src} alt={alt ?? name} class="size-full object-cover" />
+	{:else if fallback}
+		<span class={glyphs[size]}>{@render fallback()}</span>
 	{:else}
 		{initials}
 	{/if}

package/dist/styles/sprout/Avatar.svelte.d.ts

@@ -1,3 +1,4 @@
+import type { Snippet } from 'svelte';
 import type { HTMLAttributes } from 'svelte/elements';
 import { type Tone } from '../../core/tones.js';
 export type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
@@ -10,6 +11,8 @@ interface Props extends HTMLAttributes<HTMLSpanElement> {
     tone?: Tone;
     /** Rounded square instead of the default circle. */
     squared?: boolean;
+    /** Drawn instead of the initials when there is no `src` — a user mark. */
+    fallback?: Snippet;
 }
 declare const Avatar: import("svelte").Component<Props, {}, "">;
 type Avatar = ReturnType<typeof Avatar>;

package/dist/styles/sprout/Badge.svelte

@@ -9,6 +9,7 @@
 		toneText,
 		type Tone
 	} from '../../core/tones.js';
+	import { iconSm } from './icon.js';
 
 	export type BadgeVariant = 'soft' | 'solid' | 'outline';
 	export type BadgeSize = 'sm' | 'md';
@@ -19,6 +20,8 @@
 		size?: BadgeSize;
 		/** Small filled circle before the label. */
 		dot?: boolean;
+		/** Leading icon, 14px — sits where the dot would. */
+		icon?: Snippet;
 		children: Snippet;
 	}
 
@@ -27,6 +30,7 @@
 		variant = 'soft',
 		size = 'md',
 		dot = false,
+		icon,
 		class: className = '',
 		children,
 		...rest
@@ -54,5 +58,6 @@
 			class="size-1.5 shrink-0 rounded-full {variant === 'solid' ? 'bg-current' : toneFill[tone]}"
 		></span>
 	{/if}
+	{#if icon}<span class={iconSm}>{@render icon()}</span>{/if}
 	{@render children()}
 </span>