@nqmcreative/ui 0.3.0 → 0.4.0

package/dist/styles/sprout/FileInput.svelte

@@ -0,0 +1,205 @@
+<script lang="ts">
+	import { formatSize as toReadableSize, sortFiles, type RejectedFile } from '../../core/files.js';
+	import { useLocale } from '../../core/locale.svelte.js';
+	import { toneFocusWithinBorder, type Tone } from '../../core/tones.js';
+	import { edge } from './lift.js';
+	import type { InputSize } from './Input.svelte';
+
+	interface Props {
+		/** Bindable list of accepted files. */
+		files?: File[];
+		/** Same syntax as the input's `accept` — `'image/*,.pdf'`. */
+		accept?: string;
+		multiple?: boolean;
+		/** Per-file ceiling in bytes. `0` means no limit. */
+		maxSize?: number;
+		/** Cap on how many files may be held at once. `0` means no limit. */
+		maxFiles?: number;
+		disabled?: boolean;
+		size?: InputSize;
+		tone?: Tone;
+		invalid?: boolean;
+		/** Text on the button. Defaults to the locale's `chooseFile`. */
+		label?: string;
+		/** Shown while nothing is chosen. Defaults to the locale's `noFile`. */
+		placeholder?: string;
+		/** Show the list of held files below the row. */
+		showList?: boolean;
+		/** The `name` the hidden input posts under, for a plain form submit. */
+		name?: string;
+		onaccept?: (files: File[]) => void;
+		onreject?: (rejected: RejectedFile[]) => void;
+		class?: string;
+	}
+
+	let {
+		files = $bindable([]),
+		accept,
+		multiple = false,
+		maxSize = 0,
+		maxFiles = 0,
+		disabled = false,
+		size = 'md',
+		tone = 'brand',
+		invalid = false,
+		label,
+		placeholder,
+		showList = true,
+		name,
+		onaccept,
+		onreject,
+		class: className = ''
+	}: Props = $props();
+
+	const t = useLocale();
+
+	let input: HTMLInputElement | null = $state(null);
+	let rejected = $state<RejectedFile[]>([]);
+
+	const formatSize = (bytes: number) => toReadableSize(bytes, t.current.byteUnits);
+
+	/** One file reads as its name and weight; several read as a count. */
+	const summary = $derived.by(() => {
+		if (files.length === 0) return placeholder ?? t.current.noFile;
+		if (files.length === 1) return `${files[0].name} · ${formatSize(files[0].size)}`;
+		return `${files.length} ${t.current.selected}`;
+	});
+
+	function add(incoming: FileList | File[] | null) {
+		if (!incoming || disabled) return;
+
+		const { accepted, rejected: bad } = sortFiles(incoming, {
+			accept,
+			maxSize,
+			maxFiles,
+			multiple,
+			held: files.length
+		});
+
+		rejected = bad;
+		if (bad.length) onreject?.(bad);
+		if (accepted.length === 0) return;
+
+		files = multiple ? [...files, ...accepted] : accepted.slice(0, 1);
+		onaccept?.(accepted);
+	}
+
+	function clear() {
+		files = [];
+		rejected = [];
+		if (input) input.value = '';
+	}
+
+	const reasons: Record<RejectedFile['reason'], string> = $derived({
+		type: t.current.rejectedType,
+		size: t.current.rejectedSize,
+		count: t.current.rejectedCount
+	});
+
+	const sizes: Record<InputSize, string> = {
+		sm: 'h-8 text-[13px]',
+		md: 'h-10 text-sm',
+		lg: 'h-11 text-[15px]'
+	};
+
+	const buttons: Record<InputSize, string> = {
+		sm: 'h-6 px-2 text-[11px]',
+		md: 'h-7 px-2.5 text-xs',
+		lg: 'h-8 px-3 text-xs'
+	};
+</script>
+
+<div class="flex w-full flex-col gap-3 {className}">
+	<span
+		class="inline-flex w-full items-center gap-2 rounded-xl border bg-bg px-1 {edge} transition-colors duration-150 ease-brand-out
+			{sizes[size]}
+			{invalid
+			? 'border-danger focus-within:border-danger'
+			: `border-hairline-strong ${toneFocusWithinBorder[tone]}`}
+			{disabled ? 'pointer-events-none opacity-50' : ''}"
+	>
+		<button
+			type="button"
+			{disabled}
+			onclick={() => input?.click()}
+			class="shrink-0 rounded-lg border border-hairline-strong bg-bg-alt font-sans font-medium text-text-secondary transition-colors duration-150 hover:bg-bg-inset hover:text-text focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-current
+				{buttons[size]}"
+		>
+			{label ?? t.current.chooseFile}
+		</button>
+
+		<span
+			class="min-w-0 flex-1 truncate font-sans {files.length ? 'text-text' : 'text-text-muted'}"
+		>
+			{summary}
+		</span>
+
+		{#if files.length}
+			<button
+				type="button"
+				onclick={clear}
+				aria-label={t.current.remove}
+				class="mr-1 shrink-0 rounded p-1 text-text-muted transition-colors duration-150 hover:bg-bg-inset hover:text-danger focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-danger"
+			>
+				<svg class="size-3.5" viewBox="0 0 14 14" fill="none" aria-hidden="true">
+					<path
+						d="m2 2 10 10M12 2 2 12"
+						stroke="currentColor"
+						stroke-width="1.6"
+						stroke-linecap="round"
+					/>
+				</svg>
+			</button>
+		{/if}
+	</span>
+
+	<input
+		bind:this={input}
+		type="file"
+		{name}
+		{accept}
+		{multiple}
+		{disabled}
+		aria-invalid={invalid ? 'true' : undefined}
+		class="sr-only"
+		onchange={(event) => add(event.currentTarget.files)}
+	/>
+
+	{#if rejected.length}
+		<ul class="flex flex-col gap-1">
+			{#each rejected as item (item.file.name + item.reason)}
+				<li class="font-sans text-sm text-danger">
+					{item.file.name} — {reasons[item.reason]}
+				</li>
+			{/each}
+		</ul>
+	{/if}
+
+	{#if showList && multiple && files.length > 1}
+		<ul class="flex flex-col rounded-[20px] border border-hairline bg-bg {edge}">
+			{#each files as file, i (file.name + file.size + i)}
+				<li
+					class="flex items-center gap-3 border-b border-hairline px-4 py-2.5 font-sans last:border-b-0"
+				>
+					<span class="min-w-0 flex-1 truncate text-sm text-text">{file.name}</span>
+					<span class="shrink-0 text-xs text-text-muted tabular-nums">{formatSize(file.size)}</span>
+					<button
+						type="button"
+						onclick={() => (files = files.filter((_, at) => at !== i))}
+						aria-label="{t.current.remove} {file.name}"
+						class="-m-1 shrink-0 rounded p-1 text-text-muted transition-colors duration-150 hover:bg-bg-inset hover:text-danger focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-danger"
+					>
+						<svg class="size-3.5" viewBox="0 0 14 14" fill="none" aria-hidden="true">
+							<path
+								d="m2 2 10 10M12 2 2 12"
+								stroke="currentColor"
+								stroke-width="1.6"
+								stroke-linecap="round"
+							/>
+						</svg>
+					</button>
+				</li>
+			{/each}
+		</ul>
+	{/if}
+</div>

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

@@ -0,0 +1,32 @@
+import { type RejectedFile } from '../../core/files.js';
+import { type Tone } from '../../core/tones.js';
+import type { InputSize } from './Input.svelte';
+interface Props {
+    /** Bindable list of accepted files. */
+    files?: File[];
+    /** Same syntax as the input's `accept` — `'image/*,.pdf'`. */
+    accept?: string;
+    multiple?: boolean;
+    /** Per-file ceiling in bytes. `0` means no limit. */
+    maxSize?: number;
+    /** Cap on how many files may be held at once. `0` means no limit. */
+    maxFiles?: number;
+    disabled?: boolean;
+    size?: InputSize;
+    tone?: Tone;
+    invalid?: boolean;
+    /** Text on the button. Defaults to the locale's `chooseFile`. */
+    label?: string;
+    /** Shown while nothing is chosen. Defaults to the locale's `noFile`. */
+    placeholder?: string;
+    /** Show the list of held files below the row. */
+    showList?: boolean;
+    /** The `name` the hidden input posts under, for a plain form submit. */
+    name?: string;
+    onaccept?: (files: File[]) => void;
+    onreject?: (rejected: RejectedFile[]) => void;
+    class?: string;
+}
+declare const FileInput: import("svelte").Component<Props, {}, "files">;
+type FileInput = ReturnType<typeof FileInput>;
+export default FileInput;

package/dist/styles/sprout/InputAddon.svelte

@@ -0,0 +1,37 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import type { HTMLAttributes } from 'svelte/elements';
+	import { edge } from './lift.js';
+	import type { InputSize } from './Input.svelte';
+
+	interface Props extends HTMLAttributes<HTMLSpanElement> {
+		/** Match the Input it sits beside — the heights have to agree. */
+		size?: InputSize;
+		/** Paint it like a field instead of a fixed label. */
+		variant?: 'muted' | 'plain';
+		children: Snippet;
+	}
+
+	let {
+		size = 'md',
+		variant = 'muted',
+		class: className = '',
+		children,
+		...rest
+	}: Props = $props();
+
+	const sizes: Record<InputSize, string> = {
+		sm: 'h-8 px-2.5 text-[13px]',
+		md: 'h-10 px-3 text-sm',
+		lg: 'h-11 px-3 text-[15px]'
+	};
+</script>
+
+<span
+	class="inline-flex shrink-0 items-center gap-1.5 rounded-xl border border-hairline-strong font-sans whitespace-nowrap text-text-secondary {edge}
+		{sizes[size]}
+		{variant === 'muted' ? 'bg-bg-alt' : 'bg-bg'} {className}"
+	{...rest}
+>
+	{@render children()}
+</span>

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

@@ -0,0 +1,13 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+import type { InputSize } from './Input.svelte';
+interface Props extends HTMLAttributes<HTMLSpanElement> {
+    /** Match the Input it sits beside — the heights have to agree. */
+    size?: InputSize;
+    /** Paint it like a field instead of a fixed label. */
+    variant?: 'muted' | 'plain';
+    children: Snippet;
+}
+declare const InputAddon: import("svelte").Component<Props, {}, "">;
+type InputAddon = ReturnType<typeof InputAddon>;
+export default InputAddon;

package/dist/styles/sprout/PinInput.svelte

@@ -0,0 +1,138 @@
+<script lang="ts">
+	import { useLocale } from '../../core/locale.svelte.js';
+	import { caretIndex, clearFrom, fillFrom, sanitisePin, type PinMode } from '../../core/pin.js';
+	import { toneFocusBorder, type Tone } from '../../core/tones.js';
+	import { edge } from './lift.js';
+
+	interface Props {
+		/** Bindable code. Shorter than `length` means still incomplete. */
+		value?: string;
+		/** How many boxes. */
+		length?: number;
+		/** What a box accepts. */
+		mode?: PinMode;
+		/** Render the characters as dots. */
+		mask?: boolean;
+		/** Draw a gap after this many boxes — `3` gives `123 456`. */
+		groupAfter?: number;
+		disabled?: boolean;
+		invalid?: boolean;
+		tone?: Tone;
+		/** `name` for a plain form submit — one hidden field holding the code. */
+		name?: string;
+		/** Fires once the last box is filled. */
+		oncomplete?: (value: string) => void;
+		class?: string;
+	}
+
+	let {
+		value = $bindable(''),
+		length = 6,
+		mode = 'numeric',
+		mask = false,
+		groupAfter = 0,
+		disabled = false,
+		invalid = false,
+		tone = 'brand',
+		name,
+		oncomplete,
+		class: className = ''
+	}: Props = $props();
+
+	const t = useLocale();
+
+	let boxes: HTMLInputElement[] = $state([]);
+
+	const chars = $derived(Array.from({ length }, (_, i) => value[i] ?? ''));
+
+	function focusAt(index: number) {
+		boxes[Math.max(0, Math.min(length - 1, index))]?.focus();
+	}
+
+	/**
+	 * The DOM is written back on every keystroke, not only when the value
+	 * changed: a refused character leaves the box holding text the state never
+	 * accepted, and nothing else would clear it.
+	 */
+	function sync(box: HTMLInputElement, index: number) {
+		box.value = value[index] ?? '';
+	}
+
+	function commit(next: string, from: number) {
+		const was = value;
+		value = next;
+		if (value.length === length && was.length < length) oncomplete?.(value);
+		// Land on the first empty box, or the one after whatever was just typed.
+		focusAt(Math.min(Math.max(from, caretIndex(value, length)), length - 1));
+	}
+
+	function onInput(event: Event & { currentTarget: HTMLInputElement }, index: number) {
+		const typed = sanitisePin(event.currentTarget.value, mode);
+		if (!typed) {
+			sync(event.currentTarget, index);
+			return;
+		}
+		const next = fillFrom(value, index, typed, length, mode);
+		commit(next, index + typed.length);
+		for (const [at, box] of boxes.entries()) sync(box, at);
+	}
+
+	function onKeydown(event: KeyboardEvent, index: number) {
+		if (event.key === 'Backspace') {
+			event.preventDefault();
+			// An empty box deletes the one before it, the way a caret would.
+			const target = value[index] ? index : index - 1;
+			if (target < 0) return;
+			value = clearFrom(value, target);
+			for (const [at, box] of boxes.entries()) sync(box, at);
+			focusAt(target);
+		} else if (event.key === 'ArrowLeft') {
+			event.preventDefault();
+			focusAt(index - 1);
+		} else if (event.key === 'ArrowRight') {
+			event.preventDefault();
+			focusAt(index + 1);
+		}
+	}
+
+	function onPaste(event: ClipboardEvent, index: number) {
+		event.preventDefault();
+		const text = event.clipboardData?.getData('text') ?? '';
+		const clean = sanitisePin(text, mode);
+		if (!clean) return;
+		commit(fillFrom(value, index, clean, length, mode), index + clean.length);
+		for (const [at, box] of boxes.entries()) sync(box, at);
+	}
+</script>
+
+<div class="flex items-center gap-2 {className}">
+	{#each chars as char, index (index)}
+		{#if groupAfter && index > 0 && index % groupAfter === 0}
+			<span class="h-px w-2 bg-hairline-strong" aria-hidden="true"></span>
+		{/if}
+		<input
+			bind:this={boxes[index]}
+			value={char}
+			{disabled}
+			type={mask ? 'password' : 'text'}
+			inputmode={mode === 'numeric' ? 'numeric' : 'text'}
+			autocomplete={index === 0 ? 'one-time-code' : 'off'}
+			autocapitalize="characters"
+			spellcheck="false"
+			maxlength={length}
+			aria-label="{t.current.digit} {index + 1}"
+			aria-invalid={invalid ? 'true' : undefined}
+			oninput={(event) => onInput(event, index)}
+			onkeydown={(event) => onKeydown(event, index)}
+			onpaste={(event) => onPaste(event, index)}
+			onfocus={(event) => event.currentTarget.select()}
+			class="size-11 rounded-xl border bg-bg text-center font-sans text-base font-medium text-text tabular-nums {edge} transition-colors duration-150 ease-brand-out focus:outline-none
+				{invalid ? 'border-danger' : `border-hairline-strong ${toneFocusBorder[tone]}`}
+				{disabled ? 'pointer-events-none opacity-50' : ''}"
+		/>
+	{/each}
+
+	{#if name}
+		<input type="hidden" {name} {value} />
+	{/if}
+</div>

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

@@ -0,0 +1,25 @@
+import { type PinMode } from '../../core/pin.js';
+import { type Tone } from '../../core/tones.js';
+interface Props {
+    /** Bindable code. Shorter than `length` means still incomplete. */
+    value?: string;
+    /** How many boxes. */
+    length?: number;
+    /** What a box accepts. */
+    mode?: PinMode;
+    /** Render the characters as dots. */
+    mask?: boolean;
+    /** Draw a gap after this many boxes — `3` gives `123 456`. */
+    groupAfter?: number;
+    disabled?: boolean;
+    invalid?: boolean;
+    tone?: Tone;
+    /** `name` for a plain form submit — one hidden field holding the code. */
+    name?: string;
+    /** Fires once the last box is filled. */
+    oncomplete?: (value: string) => void;
+    class?: string;
+}
+declare const PinInput: import("svelte").Component<Props, {}, "value">;
+type PinInput = ReturnType<typeof PinInput>;
+export default PinInput;

package/dist/styles/sprout/SearchInput.svelte

@@ -0,0 +1,92 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import type { HTMLInputAttributes } from 'svelte/elements';
+	import { useLocale } from '../../core/locale.svelte.js';
+	import type { Tone } from '../../core/tones.js';
+	import Input, { type InputSize } from './Input.svelte';
+
+	interface Props extends Omit<HTMLInputAttributes, 'size' | 'prefix' | 'type'> {
+		value?: string;
+		size?: InputSize;
+		tone?: Tone;
+		invalid?: boolean;
+		/**
+		 * Milliseconds to wait after the last keystroke before `onsearch` fires.
+		 * `0` fires on every one.
+		 */
+		debounce?: number;
+		/** The debounced value. The bound `value` still updates immediately. */
+		onsearch?: (value: string) => void;
+		onclear?: () => void;
+		/** Replaces the magnifier. */
+		icon?: Snippet;
+		class?: string;
+	}
+
+	let {
+		value = $bindable(''),
+		size = 'md',
+		tone = 'brand',
+		invalid = false,
+		disabled = false,
+		debounce = 0,
+		onsearch,
+		onclear,
+		icon,
+		class: className = '',
+		...rest
+	}: Props = $props();
+
+	const t = useLocale();
+
+	// The timer is cleared by the effect's own teardown, so a keystroke that
+	// lands mid-wait restarts the clock rather than queueing a second call.
+	$effect(() => {
+		const next = value;
+		if (!onsearch) return;
+		if (debounce <= 0) {
+			onsearch(next);
+			return;
+		}
+		const timer = setTimeout(() => onsearch(next), debounce);
+		return () => clearTimeout(timer);
+	});
+
+	function clear() {
+		value = '';
+		onclear?.();
+	}
+</script>
+
+<Input bind:value type="search" {size} {tone} {invalid} {disabled} class={className} {...rest}>
+	{#snippet prefix()}
+		{#if icon}
+			{@render icon()}
+		{:else}
+			<svg class="size-4" viewBox="0 0 20 20" fill="none" aria-hidden="true">
+				<circle cx="9" cy="9" r="5.5" stroke="currentColor" stroke-width="1.6" />
+				<path d="m13 13 3.5 3.5" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" />
+			</svg>
+		{/if}
+	{/snippet}
+
+	{#snippet suffix()}
+		{#if value}
+			<button
+				type="button"
+				onclick={clear}
+				aria-label={t.current.clearSearch}
+				class="-mr-1 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"
+			>
+				<svg class="size-3.5" viewBox="0 0 14 14" fill="none" aria-hidden="true">
+					<path
+						d="m2 2 10 10M12 2 2 12"
+						stroke="currentColor"
+						stroke-width="1.6"
+						stroke-linecap="round"
+					/>
+				</svg>
+			</button>
+		{/if}
+	{/snippet}
+</Input>

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

@@ -0,0 +1,24 @@
+import type { Snippet } from 'svelte';
+import type { HTMLInputAttributes } from 'svelte/elements';
+import type { Tone } from '../../core/tones.js';
+import { type InputSize } from './Input.svelte';
+interface Props extends Omit<HTMLInputAttributes, 'size' | 'prefix' | 'type'> {
+    value?: string;
+    size?: InputSize;
+    tone?: Tone;
+    invalid?: boolean;
+    /**
+     * Milliseconds to wait after the last keystroke before `onsearch` fires.
+     * `0` fires on every one.
+     */
+    debounce?: number;
+    /** The debounced value. The bound `value` still updates immediately. */
+    onsearch?: (value: string) => void;
+    onclear?: () => void;
+    /** Replaces the magnifier. */
+    icon?: Snippet;
+    class?: string;
+}
+declare const SearchInput: import("svelte").Component<Props, {}, "value">;
+type SearchInput = ReturnType<typeof SearchInput>;
+export default SearchInput;