@nqmcreative/ui 0.1.1 → 0.2.0

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

@@ -0,0 +1,16 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+import { type Tone } from '../../core/tones.js';
+export type BadgeVariant = 'soft' | 'solid' | 'outline';
+export type BadgeSize = 'sm' | 'md';
+interface Props extends HTMLAttributes<HTMLSpanElement> {
+    tone?: Tone;
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    /** Small filled circle before the label. */
+    dot?: boolean;
+    children: Snippet;
+}
+declare const Badge: import("svelte").Component<Props, {}, "">;
+type Badge = ReturnType<typeof Badge>;
+export default Badge;

package/dist/styles/paper/Breadcrumb.svelte

@@ -0,0 +1,49 @@
+<script lang="ts">
+	import type { HTMLAttributes } from 'svelte/elements';
+	import { toneHoverText, type Tone } from '../../core/tones.js';
+	import { useLocale } from '../../core/locale.svelte.js';
+
+	export interface BreadcrumbItem {
+		label: string;
+		href?: string;
+	}
+
+	interface Props extends HTMLAttributes<HTMLElement> {
+		items: BreadcrumbItem[];
+		separator?: string;
+		tone?: Tone;
+	}
+
+	let { items, separator = '/', tone = 'brand', class: className = '', ...rest }: Props = $props();
+
+	const t = useLocale();
+</script>
+
+<nav aria-label={t.current.breadcrumb} class="font-sans text-sm {className}" {...rest}>
+	<ol class="flex flex-wrap items-center gap-1.5">
+		{#each items as item, i (item.label)}
+			<li class="flex items-center gap-1.5">
+				{#if i > 0}
+					<span class="text-hairline-strong select-none" aria-hidden="true">{separator}</span>
+				{/if}
+				{#if item.href && i < items.length - 1}
+					<a
+						href={item.href}
+						class="rounded px-1 py-0.5 text-text-muted transition-colors duration-150 ease-brand-out hover:bg-bg-inset {toneHoverText[
+							tone
+						]}"
+					>
+						{item.label}
+					</a>
+				{:else}
+					<span
+						class="px-1 py-0.5 font-medium text-text"
+						aria-current={i === items.length - 1 ? 'page' : undefined}
+					>
+						{item.label}
+					</span>
+				{/if}
+			</li>
+		{/each}
+	</ol>
+</nav>

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

@@ -0,0 +1,14 @@
+import type { HTMLAttributes } from 'svelte/elements';
+import { type Tone } from '../../core/tones.js';
+export interface BreadcrumbItem {
+    label: string;
+    href?: string;
+}
+interface Props extends HTMLAttributes<HTMLElement> {
+    items: BreadcrumbItem[];
+    separator?: string;
+    tone?: Tone;
+}
+declare const Breadcrumb: import("svelte").Component<Props, {}, "">;
+type Breadcrumb = ReturnType<typeof Breadcrumb>;
+export default Breadcrumb;

package/dist/styles/paper/Button.svelte

@@ -0,0 +1,96 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import type { HTMLButtonAttributes } from 'svelte/elements';
+	import Spinner from './Spinner.svelte';
+	import {
+		focusRing,
+		toneBorderSoft,
+		toneRing,
+		toneSoft,
+		toneSoftHover,
+		toneSolid,
+		toneSolidHover,
+		toneText,
+		type Tone
+	} from '../../core/tones.js';
+
+	export type ButtonVariant = 'solid' | 'soft' | 'outline' | 'ghost' | 'link' | 'primary';
+	export type ButtonSize = 'sm' | 'md' | 'lg' | 'xl';
+
+	interface Props extends HTMLButtonAttributes {
+		variant?: ButtonVariant;
+		tone?: Tone;
+		size?: ButtonSize;
+		/** Renders an `<a>` instead of a `<button>`. */
+		href?: string;
+		target?: string;
+		rel?: string;
+		loading?: boolean;
+		/** Stretch to the container's full width. */
+		block?: boolean;
+		children: Snippet;
+	}
+
+	let {
+		variant = 'solid',
+		tone = 'brand',
+		size = 'md',
+		href,
+		loading = false,
+		block = false,
+		disabled = false,
+		type = 'button',
+		class: className = '',
+		children,
+		...rest
+	}: Props = $props();
+
+	const base =
+		'inline-flex items-center justify-center gap-2 rounded-md border font-sans font-medium whitespace-nowrap transition-colors duration-150 ease-brand-out disabled:opacity-50 disabled:pointer-events-none aria-disabled:opacity-50 aria-disabled:pointer-events-none';
+
+	const sizes: Record<ButtonSize, string> = {
+		sm: 'h-8 px-3 text-[13px]',
+		md: 'h-10 px-4 text-sm',
+		lg: 'h-11 px-5 text-[15px]',
+		xl: 'h-12 px-6 text-base'
+	};
+
+	const variantClass = $derived.by(() => {
+		switch (variant) {
+			case 'primary':
+			case 'solid':
+				return `border-transparent shadow-xs ${toneSolid[tone]} ${toneSolidHover[tone]}`;
+			case 'soft':
+				return `border-transparent ${toneSoft[tone]} ${toneSoftHover[tone]}`;
+			// Outline keeps its own colours on hover here — swapping to a solid
+			// fill is matte's move, and it fights paper's quieter surfaces.
+			case 'outline':
+				return `bg-bg shadow-xs ${toneText[tone]} ${toneBorderSoft[tone]} hover:bg-bg-alt`;
+			case 'ghost':
+				return `border-transparent bg-transparent ${toneText[tone]} ${toneSoftHover[tone]}`;
+			case 'link':
+				return `border-transparent ${toneText[tone]} h-auto p-0 text-sm underline-offset-4 hover:underline`;
+		}
+	});
+
+	const isLink = $derived(variant === 'link');
+	const inert = $derived(disabled || loading);
+</script>
+
+<svelte:element
+	this={href ? 'a' : 'button'}
+	{href}
+	type={href ? undefined : type}
+	disabled={href ? undefined : inert}
+	aria-disabled={href && inert ? 'true' : undefined}
+	aria-busy={loading ? 'true' : undefined}
+	role={href ? 'button' : undefined}
+	class="{base} {focusRing} {toneRing[tone]} {variantClass} {isLink ? '' : sizes[size]}
+		{block ? 'w-full' : ''} {className}"
+	{...rest}
+>
+	{#if loading}
+		<Spinner size={size === 'sm' ? 'xs' : 'sm'} label="" />
+	{/if}
+	{@render children()}
+</svelte:element>

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

@@ -0,0 +1,21 @@
+import type { Snippet } from 'svelte';
+import type { HTMLButtonAttributes } from 'svelte/elements';
+import { type Tone } from '../../core/tones.js';
+export type ButtonVariant = 'solid' | 'soft' | 'outline' | 'ghost' | 'link' | 'primary';
+export type ButtonSize = 'sm' | 'md' | 'lg' | 'xl';
+interface Props extends HTMLButtonAttributes {
+    variant?: ButtonVariant;
+    tone?: Tone;
+    size?: ButtonSize;
+    /** Renders an `<a>` instead of a `<button>`. */
+    href?: string;
+    target?: string;
+    rel?: string;
+    loading?: boolean;
+    /** Stretch to the container's full width. */
+    block?: boolean;
+    children: Snippet;
+}
+declare const Button: import("svelte").Component<Props, {}, "">;
+type Button = ReturnType<typeof Button>;
+export default Button;

package/dist/styles/paper/CTASection.svelte

@@ -0,0 +1,76 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import type { HTMLAttributes } from 'svelte/elements';
+	import { toneBorderSoft, toneSolid, toneSurface, type Tone } from '../../core/tones.js';
+
+	export type CTAVariant = 'tinted' | 'solid' | 'outline';
+
+	interface Props extends HTMLAttributes<HTMLElement> {
+		title: string;
+		description?: string;
+		tone?: Tone;
+		variant?: CTAVariant;
+		/** Side by side on wide screens instead of stacked and centred. */
+		inline?: boolean;
+		/** The buttons. */
+		actions?: Snippet;
+		children?: Snippet;
+	}
+
+	let {
+		title,
+		description,
+		tone = 'brand',
+		variant = 'tinted',
+		inline = false,
+		actions,
+		class: className = '',
+		children,
+		...rest
+	}: Props = $props();
+
+	const variants = $derived({
+		tinted: `${toneSurface[tone]} border ${toneBorderSoft[tone]}`,
+		solid: `${toneSolid[tone]} shadow-lg`,
+		outline: `bg-bg border ${toneBorderSoft[tone]} shadow-xs`
+	});
+
+	const onSolid = $derived(variant === 'solid');
+</script>
+
+<section class="w-full px-6 py-16 {className}" {...rest}>
+	<div
+		class="mx-auto flex w-full max-w-6xl gap-8 rounded-xl p-10 sm:p-14 {variants[variant]}
+			{inline
+			? 'flex-col lg:flex-row lg:items-center lg:justify-between'
+			: 'flex-col items-center text-center'}"
+	>
+		<div class="flex min-w-0 flex-col gap-3 {inline ? '' : 'items-center'}">
+			<h2
+				class="max-w-2xl font-heading text-3xl font-semibold tracking-tight text-balance {onSolid
+					? 'text-text-inverse'
+					: 'text-text'}"
+			>
+				{title}
+			</h2>
+			{#if description}
+				<p
+					class="max-w-xl font-sans leading-relaxed text-pretty {onSolid
+						? 'text-text-inverse/80'
+						: 'text-text-secondary'}"
+				>
+					{description}
+				</p>
+			{/if}
+			{#if children}
+				{@render children()}
+			{/if}
+		</div>
+
+		{#if actions}
+			<div class="flex shrink-0 flex-wrap items-center gap-3 {inline ? '' : 'justify-center'}">
+				{@render actions()}
+			</div>
+		{/if}
+	</div>
+</section>

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

@@ -0,0 +1,18 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+import { type Tone } from '../../core/tones.js';
+export type CTAVariant = 'tinted' | 'solid' | 'outline';
+interface Props extends HTMLAttributes<HTMLElement> {
+    title: string;
+    description?: string;
+    tone?: Tone;
+    variant?: CTAVariant;
+    /** Side by side on wide screens instead of stacked and centred. */
+    inline?: boolean;
+    /** The buttons. */
+    actions?: Snippet;
+    children?: Snippet;
+}
+declare const CTASection: import("svelte").Component<Props, {}, "">;
+type CTASection = ReturnType<typeof CTASection>;
+export default CTASection;

package/dist/styles/paper/Calendar.svelte

@@ -0,0 +1,202 @@
+<script lang="ts">
+	import {
+		addMonths,
+		fromISO,
+		isOutOfRange,
+		isSameDay,
+		monthGrid,
+		monthLabel,
+		toISO,
+		today,
+		weekdayNames
+	} from '../../core/date.js';
+	import { calendarKeyMove } from '../../core/calendar.js';
+	import { useLocale } from '../../core/locale.svelte.js';
+	import {
+		focusRing,
+		toneFill,
+		toneRing,
+		toneSoft,
+		toneText,
+		type Tone
+	} from '../../core/tones.js';
+
+	interface Props {
+		/** Bindable `YYYY-MM-DD`, or `''` for nothing selected. */
+		value?: string;
+		/** Bindable `YYYY-MM-DD` inside the month on show. */
+		month?: string;
+		/** Inclusive bounds, `YYYY-MM-DD`. */
+		min?: string;
+		max?: string;
+		/** Return true to grey out a specific day — weekends, holidays. */
+		isDisabled?: (date: Date) => boolean;
+		/** 1 = Monday (default), 0 = Sunday. */
+		weekStart?: 0 | 1;
+		tone?: Tone;
+		/** Show the "Today" shortcut under the grid. */
+		showToday?: boolean;
+		onselect?: (value: string) => void;
+		class?: string;
+	}
+
+	let {
+		value = $bindable(''),
+		month = $bindable(''),
+		min,
+		max,
+		isDisabled,
+		weekStart = 1,
+		tone = 'brand',
+		showToday = true,
+		onselect,
+		class: className = ''
+	}: Props = $props();
+
+	const t = useLocale();
+
+	const selected = $derived(fromISO(value));
+	const now = today();
+
+	let view = $state(fromISO(month) ?? fromISO(value) ?? today());
+	/** The day the arrow keys are on — not necessarily the selected one. */
+	let focused = $state(fromISO(value) ?? today());
+	let grid: HTMLElement | null = $state(null);
+
+	// Follow the bound `month`/`value` when the parent changes them.
+	$effect(() => {
+		const next = fromISO(month) ?? fromISO(value);
+		if (next && (next.getMonth() !== view.getMonth() || next.getFullYear() !== view.getFullYear()))
+			view = next;
+	});
+
+	const days = $derived(monthGrid(view, weekStart));
+	const weekdays = $derived(weekdayNames(t.current.dateLocale, weekStart));
+
+	function blocked(date: Date) {
+		return isOutOfRange(date, min, max) || (isDisabled?.(date) ?? false);
+	}
+
+	function show(next: Date) {
+		view = next;
+		month = toISO(new Date(next.getFullYear(), next.getMonth(), 1));
+	}
+
+	function pick(date: Date) {
+		if (blocked(date)) return;
+		value = toISO(date);
+		focused = date;
+		if (date.getMonth() !== view.getMonth()) show(date);
+		onselect?.(value);
+	}
+
+	function moveFocus(next: Date) {
+		focused = next;
+		if (next.getMonth() !== view.getMonth() || next.getFullYear() !== view.getFullYear())
+			show(next);
+		queueMicrotask(() => grid?.querySelector<HTMLElement>('[data-focused="true"]')?.focus());
+	}
+
+	function onKeydown(event: KeyboardEvent) {
+		const next = calendarKeyMove(event.key, focused, weekStart, event.shiftKey);
+		if (next) {
+			event.preventDefault();
+			moveFocus(next);
+			return;
+		}
+		if (event.key === 'Enter' || event.key === ' ') {
+			event.preventDefault();
+			pick(focused);
+		}
+	}
+
+	const arrow =
+		'inline-flex size-8 items-center justify-center rounded-md text-text-secondary transition-colors duration-150 hover:bg-bg-inset hover:text-text';
+</script>
+
+<div class="flex w-[18rem] flex-col gap-3 p-3 font-sans {className}">
+	<div class="flex items-center justify-between gap-2">
+		<button
+			type="button"
+			onclick={() => show(addMonths(view, -1))}
+			aria-label={t.current.previousMonth}
+			class="{arrow} {focusRing} {toneRing[tone]}"
+		>
+			<svg class="size-4" viewBox="0 0 16 16" fill="none" aria-hidden="true">
+				<path d="m10 4-4 4 4 4" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" />
+			</svg>
+		</button>
+
+		<span aria-live="polite" class="text-sm font-semibold text-text">
+			{monthLabel(view, t.current.dateLocale)}
+		</span>
+
+		<button
+			type="button"
+			onclick={() => show(addMonths(view, 1))}
+			aria-label={t.current.nextMonth}
+			class="{arrow} {focusRing} {toneRing[tone]}"
+		>
+			<svg class="size-4" viewBox="0 0 16 16" fill="none" aria-hidden="true">
+				<path d="m6 4 4 4-4 4" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" />
+			</svg>
+		</button>
+	</div>
+
+	<div class="grid grid-cols-7 gap-0.5">
+		{#each weekdays as name, i (i)}
+			<span class="pb-1 text-center text-[11px] font-medium text-text-muted">{name}</span>
+		{/each}
+	</div>
+
+	<!-- Roving tabindex: the grid itself is never a tab stop, the focused day is. -->
+	<div
+		bind:this={grid}
+		role="grid"
+		tabindex="-1"
+		aria-label={t.current.selectDate}
+		onkeydown={onKeydown}
+		class="grid grid-cols-7 gap-0.5 focus:outline-none"
+	>
+		{#each days as day (toISO(day))}
+			{@const outside = day.getMonth() !== view.getMonth()}
+			{@const off = blocked(day)}
+			{@const isSelected = isSameDay(day, selected)}
+			{@const isFocused = isSameDay(day, focused)}
+			<button
+				type="button"
+				role="gridcell"
+				data-focused={isFocused}
+				tabindex={isFocused ? 0 : -1}
+				disabled={off}
+				aria-selected={isSelected}
+				aria-current={isSameDay(day, now) ? 'date' : undefined}
+				onclick={() => pick(day)}
+				class="flex h-9 items-center justify-center rounded-md text-[13px] tabular-nums transition-colors duration-100 disabled:pointer-events-none disabled:opacity-30 {focusRing} {toneRing[
+					tone
+				]}
+					{isSelected
+					? `${toneFill[tone]} font-semibold text-text-inverse`
+					: outside
+						? 'text-text-muted/60 hover:bg-bg-inset'
+						: 'text-text-secondary hover:bg-bg-inset hover:text-text'}
+					{!isSelected && isSameDay(day, now) ? `${toneSoft[tone]} font-semibold` : ''}"
+			>
+				{day.getDate()}
+			</button>
+		{/each}
+	</div>
+
+	{#if showToday}
+		<button
+			type="button"
+			onclick={() => pick(now)}
+			disabled={blocked(now)}
+			class="self-start rounded px-1 text-[13px] font-medium transition-colors duration-150 disabled:pointer-events-none disabled:opacity-40 {toneText[
+				tone
+			]} hover:underline hover:underline-offset-2 {focusRing} {toneRing[tone]}"
+		>
+			{t.current.today}
+		</button>
+	{/if}
+</div>

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

@@ -0,0 +1,22 @@
+import { type Tone } from '../../core/tones.js';
+interface Props {
+    /** Bindable `YYYY-MM-DD`, or `''` for nothing selected. */
+    value?: string;
+    /** Bindable `YYYY-MM-DD` inside the month on show. */
+    month?: string;
+    /** Inclusive bounds, `YYYY-MM-DD`. */
+    min?: string;
+    max?: string;
+    /** Return true to grey out a specific day — weekends, holidays. */
+    isDisabled?: (date: Date) => boolean;
+    /** 1 = Monday (default), 0 = Sunday. */
+    weekStart?: 0 | 1;
+    tone?: Tone;
+    /** Show the "Today" shortcut under the grid. */
+    showToday?: boolean;
+    onselect?: (value: string) => void;
+    class?: string;
+}
+declare const Calendar: import("svelte").Component<Props, {}, "month" | "value">;
+type Calendar = ReturnType<typeof Calendar>;
+export default Calendar;

package/dist/styles/paper/Card.svelte

@@ -0,0 +1,78 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import type { HTMLAttributes } from 'svelte/elements';
+	import { toneBorderLeft, toneHoverBorder, toneSurface, type Tone } from '../../core/tones.js';
+
+	export type CardVariant = 'outline' | 'filled' | 'tinted';
+
+	interface Props extends HTMLAttributes<HTMLDivElement> {
+		variant?: CardVariant;
+		tone?: Tone;
+		/** Draws a tone-coloured rule down the left edge. */
+		accent?: boolean;
+		/** Lifts the card on hover — use for clickable cards. */
+		interactive?: boolean;
+		padded?: boolean;
+		title?: string;
+		eyebrow?: string;
+		header?: Snippet;
+		footer?: Snippet;
+		children: Snippet;
+	}
+
+	let {
+		variant = 'outline',
+		tone = 'brand',
+		accent = false,
+		interactive = false,
+		padded = true,
+		title,
+		eyebrow,
+		header,
+		footer,
+		class: className = '',
+		children,
+		...rest
+	}: Props = $props();
+
+	const variants = $derived({
+		outline: 'border border-hairline bg-bg shadow-xs',
+		filled: 'border border-hairline bg-bg-alt',
+		tinted: `border border-transparent ${toneSurface[tone]}`
+	});
+</script>
+
+<div
+	class="flex flex-col rounded-lg {variants[variant]}
+		{accent ? `border-l-4 ${toneBorderLeft[tone]}` : ''}
+		{interactive
+		? `transition-shadow duration-150 ease-brand-out hover:shadow-md ${toneHoverBorder[tone]}`
+		: ''}
+		{className}"
+	{...rest}
+>
+	{#if header || title || eyebrow}
+		<div class="flex flex-col gap-1 {padded ? 'px-5 pt-5' : ''}">
+			{#if header}
+				{@render header()}
+			{:else}
+				{#if eyebrow}
+					<span class="font-sans text-xs font-semibold text-text-muted">{eyebrow}</span>
+				{/if}
+				{#if title}
+					<h3 class="font-heading text-base font-semibold text-text">{title}</h3>
+				{/if}
+			{/if}
+		</div>
+	{/if}
+
+	<div class="flex-1 {padded ? (header || title || eyebrow ? 'px-5 pt-3 pb-5' : 'p-5') : ''}">
+		{@render children()}
+	</div>
+
+	{#if footer}
+		<div class="rounded-b-lg border-t border-hairline bg-bg-alt {padded ? 'px-5 py-3.5' : ''}">
+			{@render footer()}
+		</div>
+	{/if}
+</div>

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

@@ -0,0 +1,21 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+import { type Tone } from '../../core/tones.js';
+export type CardVariant = 'outline' | 'filled' | 'tinted';
+interface Props extends HTMLAttributes<HTMLDivElement> {
+    variant?: CardVariant;
+    tone?: Tone;
+    /** Draws a tone-coloured rule down the left edge. */
+    accent?: boolean;
+    /** Lifts the card on hover — use for clickable cards. */
+    interactive?: boolean;
+    padded?: boolean;
+    title?: string;
+    eyebrow?: string;
+    header?: Snippet;
+    footer?: Snippet;
+    children: Snippet;
+}
+declare const Card: import("svelte").Component<Props, {}, "">;
+type Card = ReturnType<typeof Card>;
+export default Card;