@nqmcreative/ui 0.3.0 → 0.4.0

package/dist/styles/matte/TagsInput.svelte

@@ -0,0 +1,173 @@
+<script lang="ts">
+	import { useLocale } from '../../core/locale.svelte.js';
+	import { addTag, splitTags, type TagRejection } from '../../core/tags.js';
+	import { toneFocusWithinBorder, toneSoft, type Tone } from '../../core/tones.js';
+
+	interface Props {
+		/** Bindable list of tags, in the order they were added. */
+		tags?: string[];
+		placeholder?: string;
+		/** Cap on how many may be held. `0` means no limit. */
+		max?: number;
+		/** Shortest a tag may be, after trimming. */
+		minLength?: number;
+		/** Keys that commit the tag under the caret, besides Enter. */
+		separators?: string[];
+		/** Refuse a tag that differs from an existing one only in case. */
+		caseInsensitive?: boolean;
+		/** Commit whatever is half-typed when the field loses focus. */
+		commitOnBlur?: boolean;
+		disabled?: boolean;
+		invalid?: boolean;
+		tone?: Tone;
+		/** `name` for a plain form submit — one hidden field, comma-joined. */
+		name?: string;
+		onadd?: (tag: string) => void;
+		onremove?: (tag: string) => void;
+		onreject?: (reason: TagRejection, raw: string) => void;
+		class?: string;
+	}
+
+	let {
+		tags = $bindable([]),
+		placeholder,
+		max = 0,
+		minLength = 1,
+		separators = [','],
+		caseInsensitive = true,
+		commitOnBlur = true,
+		disabled = false,
+		invalid = false,
+		tone = 'brand',
+		name,
+		onadd,
+		onremove,
+		onreject,
+		class: className = ''
+	}: Props = $props();
+
+	const t = useLocale();
+
+	let draft = $state('');
+	let field: HTMLInputElement | null = $state(null);
+	/** The last refusal, cleared as soon as the next keystroke lands. */
+	let refused = $state<TagRejection | null>(null);
+
+	const full = $derived(max > 0 && tags.length >= max);
+	const rules = $derived({ max, minLength, caseInsensitive });
+
+	function commit(raw: string) {
+		const { tags: next, rejected } = addTag(tags, raw, rules);
+		if (rejected) {
+			// An empty commit is the Enter key on an empty field, not a mistake.
+			if (rejected !== 'empty') {
+				refused = rejected;
+				onreject?.(rejected, raw);
+			}
+			return false;
+		}
+		tags = next;
+		onadd?.(next[next.length - 1]);
+		return true;
+	}
+
+	function remove(index: number) {
+		const [gone] = tags.slice(index, index + 1);
+		tags = tags.filter((_, at) => at !== index);
+		if (gone !== undefined) onremove?.(gone);
+	}
+
+	function onKeydown(event: KeyboardEvent) {
+		refused = null;
+
+		if (event.key === 'Enter' || separators.includes(event.key)) {
+			event.preventDefault();
+			if (commit(draft)) draft = '';
+			return;
+		}
+
+		// Empty field: Backspace peels the last chip off, the way chips behave
+		// everywhere else in this library.
+		if (event.key === 'Backspace' && draft === '' && tags.length) {
+			event.preventDefault();
+			remove(tags.length - 1);
+		}
+	}
+
+	function onPaste(event: ClipboardEvent) {
+		const text = event.clipboardData?.getData('text') ?? '';
+		const parts = splitTags(text, separators);
+		if (parts.length <= 1) return;
+
+		event.preventDefault();
+		for (const part of parts) commit(part);
+		draft = '';
+	}
+
+	function onBlur() {
+		if (commitOnBlur && draft.trim() && commit(draft)) draft = '';
+	}
+
+	const messages: Record<TagRejection, string> = $derived({
+		empty: '',
+		short: `${minLength}+`,
+		duplicate: t.current.duplicateTag,
+		full: `${t.current.selected} ${tags.length}/${max}`
+	});
+</script>
+
+<div class="flex w-full flex-col gap-1.5 {className}">
+	<!-- svelte-ignore a11y_click_events_have_key_events, a11y_no_static_element_interactions -->
+	<div
+		onclick={() => field?.focus()}
+		class="flex w-full flex-wrap items-center gap-1.5 border bg-bg py-1.5 pr-1.5 pl-2 transition-colors duration-150 ease-brand-out
+			{invalid
+			? 'border-danger focus-within:border-danger'
+			: `border-hairline ${toneFocusWithinBorder[tone]}`}
+			{disabled ? 'pointer-events-none opacity-50' : ''}"
+	>
+		{#each tags as tag, index (tag)}
+			<span
+				class="inline-flex items-center gap-1.5 rounded-full py-1 pr-1 pl-2.5 font-mono text-xs {toneSoft[
+					tone
+				]}"
+			>
+				{tag}
+				<button
+					type="button"
+					onclick={() => remove(index)}
+					aria-label="{t.current.removeItem} {tag}"
+					class="inline-flex size-4 items-center justify-center rounded-full transition-colors duration-150 hover:bg-bg 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 d="m1.5 1.5 7 7M8.5 1.5l-7 7" stroke="currentColor" stroke-width="1.5" />
+					</svg>
+				</button>
+			</span>
+		{/each}
+
+		<input
+			bind:this={field}
+			bind:value={draft}
+			{disabled}
+			readonly={full}
+			placeholder={tags.length === 0 ? (placeholder ?? t.current.addTag) : ''}
+			aria-label={placeholder ?? t.current.addTag}
+			aria-invalid={invalid ? 'true' : undefined}
+			onkeydown={onKeydown}
+			onpaste={onPaste}
+			onblur={onBlur}
+			class="h-7 min-w-24 flex-1 bg-transparent font-sans text-[15px] text-text placeholder:text-text-muted focus:outline-none"
+		/>
+
+		{#if name}
+			<input type="hidden" {name} value={tags.join(',')} />
+		{/if}
+	</div>
+
+	{#if refused && messages[refused]}
+		<span class="font-mono text-xs text-danger">{messages[refused]}</span>
+	{:else if max}
+		<span class="font-mono text-xs text-text-muted">{tags.length}/{max}</span>
+	{/if}
+</div>

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

@@ -0,0 +1,29 @@
+import { type TagRejection } from '../../core/tags.js';
+import { type Tone } from '../../core/tones.js';
+interface Props {
+    /** Bindable list of tags, in the order they were added. */
+    tags?: string[];
+    placeholder?: string;
+    /** Cap on how many may be held. `0` means no limit. */
+    max?: number;
+    /** Shortest a tag may be, after trimming. */
+    minLength?: number;
+    /** Keys that commit the tag under the caret, besides Enter. */
+    separators?: string[];
+    /** Refuse a tag that differs from an existing one only in case. */
+    caseInsensitive?: boolean;
+    /** Commit whatever is half-typed when the field loses focus. */
+    commitOnBlur?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    tone?: Tone;
+    /** `name` for a plain form submit — one hidden field, comma-joined. */
+    name?: string;
+    onadd?: (tag: string) => void;
+    onremove?: (tag: string) => void;
+    onreject?: (reason: TagRejection, raw: string) => void;
+    class?: string;
+}
+declare const TagsInput: import("svelte").Component<Props, {}, "tags">;
+type TagsInput = ReturnType<typeof TagsInput>;
+export default TagsInput;

package/dist/styles/matte/TimeInput.svelte

@@ -0,0 +1,129 @@
+<script lang="ts">
+	import type { HTMLInputAttributes } from 'svelte/elements';
+	import { useLocale } from '../../core/locale.svelte.js';
+	import { clampTime, formatTime, parseTime, stepTime } from '../../core/time.js';
+	import type { Tone } from '../../core/tones.js';
+	import Input, { type InputSize } from './Input.svelte';
+
+	interface Props extends Omit<
+		HTMLInputAttributes,
+		'size' | 'prefix' | 'suffix' | 'min' | 'max' | 'step'
+	> {
+		/** Bindable `HH:MM`, or `''` for empty. */
+		value?: string;
+		/** Inclusive bounds, `HH:MM`. */
+		min?: string;
+		max?: string;
+		/** Minutes one press of a stepper moves, and what typing snaps to. */
+		step?: number;
+		size?: InputSize;
+		tone?: Tone;
+		invalid?: boolean;
+		/** Hide the steppers and let the field be typed into only. */
+		steppers?: boolean;
+		class?: string;
+	}
+
+	let {
+		value = $bindable(''),
+		min,
+		max,
+		step = 15,
+		size = 'md',
+		tone = 'brand',
+		invalid = false,
+		disabled = false,
+		steppers = true,
+		class: className = '',
+		...rest
+	}: Props = $props();
+
+	const t = useLocale();
+
+	// Typed text and the bound value are separate until the field settles:
+	// `9` is a valid thing to be halfway through typing and an invalid time.
+	let text = $state('');
+	let editing = $state(false);
+
+	$effect(() => {
+		if (!editing) text = value;
+	});
+
+	function settle() {
+		editing = false;
+		const minutes = parseTime(text);
+		value = minutes === null ? '' : formatTime(clampTime(minutes, min, max, step));
+		text = value;
+	}
+
+	function nudge(direction: 1 | -1) {
+		value = stepTime(value, direction, step, min, max);
+		text = value;
+	}
+
+	function onKeydown(event: KeyboardEvent) {
+		if (event.key === 'ArrowUp') {
+			event.preventDefault();
+			nudge(1);
+		} else if (event.key === 'ArrowDown') {
+			event.preventDefault();
+			nudge(-1);
+		} else if (event.key === 'Enter') {
+			settle();
+		}
+	}
+
+	const stepper =
+		'grid size-6 place-items-center 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
+	bind:value={text}
+	{size}
+	{tone}
+	{invalid}
+	{disabled}
+	inputmode="numeric"
+	placeholder="--:--"
+	onfocus={() => (editing = true)}
+	onblur={settle}
+	onkeydown={onKeydown}
+	class="[&_input]:tabular-nums {className}"
+	{...rest}
+>
+	{#snippet prefix()}
+		<svg class="size-4" viewBox="0 0 20 20" fill="none" aria-hidden="true">
+			<circle cx="10" cy="10" r="6.5" stroke="currentColor" stroke-width="1.5" />
+			<path d="M10 6.5V10l2.5 1.5" stroke="currentColor" stroke-width="1.5" />
+		</svg>
+	{/snippet}
+
+	{#snippet suffix()}
+		{#if steppers}
+			<span class="-mr-2 flex flex-col">
+				<button
+					type="button"
+					class={stepper}
+					{disabled}
+					onclick={() => nudge(1)}
+					aria-label={t.current.increase}
+				>
+					<svg class="size-3" viewBox="0 0 12 12" fill="none" aria-hidden="true">
+						<path d="m3 7.5 3-3 3 3" stroke="currentColor" stroke-width="1.5" />
+					</svg>
+				</button>
+				<button
+					type="button"
+					class={stepper}
+					{disabled}
+					onclick={() => nudge(-1)}
+					aria-label={t.current.decrease}
+				>
+					<svg class="size-3" viewBox="0 0 12 12" fill="none" aria-hidden="true">
+						<path d="m3 4.5 3 3 3-3" stroke="currentColor" stroke-width="1.5" />
+					</svg>
+				</button>
+			</span>
+		{/if}
+	{/snippet}
+</Input>

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

@@ -0,0 +1,21 @@
+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' | 'suffix' | 'min' | 'max' | 'step'> {
+    /** Bindable `HH:MM`, or `''` for empty. */
+    value?: string;
+    /** Inclusive bounds, `HH:MM`. */
+    min?: string;
+    max?: string;
+    /** Minutes one press of a stepper moves, and what typing snaps to. */
+    step?: number;
+    size?: InputSize;
+    tone?: Tone;
+    invalid?: boolean;
+    /** Hide the steppers and let the field be typed into only. */
+    steppers?: boolean;
+    class?: string;
+}
+declare const TimeInput: import("svelte").Component<Props, {}, "value">;
+type TimeInput = ReturnType<typeof TimeInput>;
+export default TimeInput;

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

@@ -30,6 +30,14 @@ export type { CheckboxOption } from './CheckboxGroup.svelte';
 export { default as SegmentedControl } from './SegmentedControl.svelte';
 export type { SegmentOption, SegmentedSize } from './SegmentedControl.svelte';
 export { default as InputGroup } from './InputGroup.svelte';
+export { default as InputAddon } from './InputAddon.svelte';
+export { default as SearchInput } from './SearchInput.svelte';
+export { default as PinInput } from './PinInput.svelte';
+export { default as TagsInput } from './TagsInput.svelte';
+export { default as CurrencyInput } from './CurrencyInput.svelte';
+export { default as TimeInput } from './TimeInput.svelte';
+export { default as ColorInput } from './ColorInput.svelte';
+export { default as FileInput } from './FileInput.svelte';
 export { default as Combobox } from './Combobox.svelte';
 export type { ComboboxOption } from './Combobox.svelte';
 export { default as MultiSelect } from './MultiSelect.svelte';

package/dist/styles/matte/index.js

@@ -26,6 +26,14 @@ export { default as RadioGroup } from './RadioGroup.svelte';
 export { default as CheckboxGroup } from './CheckboxGroup.svelte';
 export { default as SegmentedControl } from './SegmentedControl.svelte';
 export { default as InputGroup } from './InputGroup.svelte';
+export { default as InputAddon } from './InputAddon.svelte';
+export { default as SearchInput } from './SearchInput.svelte';
+export { default as PinInput } from './PinInput.svelte';
+export { default as TagsInput } from './TagsInput.svelte';
+export { default as CurrencyInput } from './CurrencyInput.svelte';
+export { default as TimeInput } from './TimeInput.svelte';
+export { default as ColorInput } from './ColorInput.svelte';
+export { default as FileInput } from './FileInput.svelte';
 export { default as Combobox } from './Combobox.svelte';
 export { default as MultiSelect } from './MultiSelect.svelte';
 export { default as DatePicker } from './DatePicker.svelte';

package/dist/styles/paper/ColorInput.svelte

@@ -0,0 +1,112 @@
+<script lang="ts">
+	import type { HTMLInputAttributes } from 'svelte/elements';
+	import { normaliseHex } from '../../core/color.js';
+	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' | 'suffix' | 'type'> {
+		/** Bindable `#rrggbb`. Shorthand and alpha are normalised away on blur. */
+		value?: string;
+		size?: InputSize;
+		tone?: Tone;
+		invalid?: boolean;
+		/** Fixed choices under the field. Empty hides the row. */
+		swatches?: string[];
+		class?: string;
+	}
+
+	let {
+		value = $bindable('#000000'),
+		size = 'md',
+		tone = 'brand',
+		invalid = false,
+		disabled = false,
+		swatches = [],
+		class: className = '',
+		...rest
+	}: Props = $props();
+
+	const t = useLocale();
+
+	// The text can be mid-typing (`#a2`) while the swatch needs a real colour,
+	// so the swatch follows the last value that parsed rather than the field.
+	let text = $state('');
+	let editing = $state(false);
+
+	$effect(() => {
+		if (!editing) text = value;
+	});
+
+	const resolved = $derived(normaliseHex(text) ?? normaliseHex(value) ?? '#000000');
+
+	// Same reason as CurrencyInput: at input time the bound `text` is one
+	// keystroke behind, so the element is the only current source.
+	function onText(event: Event & { currentTarget: HTMLInputElement }) {
+		const hex = normaliseHex(event.currentTarget.value);
+		if (hex) value = hex;
+	}
+
+	function settle() {
+		editing = false;
+		value = normaliseHex(text) ?? value;
+		text = value;
+	}
+
+	function choose(hex: string) {
+		value = normaliseHex(hex) ?? value;
+		text = value;
+	}
+</script>
+
+<div class="flex w-full flex-col gap-2 {className}">
+	<Input
+		bind:value={text}
+		{size}
+		{tone}
+		{invalid}
+		{disabled}
+		spellcheck="false"
+		autocapitalize="none"
+		placeholder="#000000"
+		oninput={onText}
+		onfocus={() => (editing = true)}
+		onblur={settle}
+		class="[&_input]:uppercase [&_input]:tabular-nums"
+		{...rest}
+	>
+		{#snippet prefix()}
+			<span
+				class="relative grid size-5 place-items-center overflow-hidden rounded border border-hairline-strong"
+			>
+				<span class="absolute inset-0" style="background-color: {resolved}"></span>
+				<input
+					type="color"
+					value={resolved}
+					{disabled}
+					aria-label={t.current.pickColour}
+					oninput={(event) => choose(event.currentTarget.value)}
+					class="absolute inset-0 cursor-pointer opacity-0 disabled:cursor-not-allowed"
+				/>
+			</span>
+		{/snippet}
+	</Input>
+
+	{#if swatches.length}
+		<div class="flex flex-wrap gap-1.5">
+			{#each swatches as swatch (swatch)}
+				<button
+					type="button"
+					{disabled}
+					onclick={() => choose(swatch)}
+					title={swatch}
+					aria-label={swatch}
+					aria-pressed={resolved === normaliseHex(swatch)}
+					class="size-6 rounded-md border transition-transform duration-150 hover:-translate-y-0.5 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-current disabled:pointer-events-none disabled:opacity-50
+						{resolved === normaliseHex(swatch) ? 'border-text' : 'border-hairline-strong'}"
+					style="background-color: {swatch}"
+				></button>
+			{/each}
+		</div>
+	{/if}
+</div>

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

@@ -0,0 +1,16 @@
+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' | 'suffix' | 'type'> {
+    /** Bindable `#rrggbb`. Shorthand and alpha are normalised away on blur. */
+    value?: string;
+    size?: InputSize;
+    tone?: Tone;
+    invalid?: boolean;
+    /** Fixed choices under the field. Empty hides the row. */
+    swatches?: string[];
+    class?: string;
+}
+declare const ColorInput: import("svelte").Component<Props, {}, "value">;
+type ColorInput = ReturnType<typeof ColorInput>;
+export default ColorInput;

package/dist/styles/paper/CurrencyInput.svelte

@@ -0,0 +1,108 @@
+<script lang="ts">
+	import type { HTMLInputAttributes } from 'svelte/elements';
+	import { formatGrouped, parseGrouped } from '../../core/number.js';
+	import type { Tone } from '../../core/tones.js';
+	import Input, { type InputSize } from './Input.svelte';
+
+	interface Props extends Omit<
+		HTMLInputAttributes,
+		'size' | 'prefix' | 'suffix' | 'value' | 'min' | 'max'
+	> {
+		/** Bindable amount. `null` is an empty field, which is not the same as 0. */
+		value?: number | null;
+		min?: number;
+		max?: number;
+		/** Thousands separator. */
+		group?: string;
+		/** Decimal separator. */
+		decimal?: string;
+		/** Decimal places the amount settles to when the field loses focus. */
+		precision?: number;
+		/** Leading mark — `Rp`, `$`, `€`. */
+		currency?: string;
+		/** Trailing mark instead, for the locales that write it that way. */
+		unit?: string;
+		size?: InputSize;
+		tone?: Tone;
+		invalid?: boolean;
+		class?: string;
+	}
+
+	let {
+		value = $bindable(null),
+		min,
+		max,
+		group = ',',
+		decimal = '.',
+		precision = 2,
+		currency,
+		unit,
+		size = 'md',
+		tone = 'brand',
+		invalid = false,
+		disabled = false,
+		class: className = '',
+		...rest
+	}: Props = $props();
+
+	const options = $derived({ group, decimal, precision });
+
+	/**
+	 * What the field shows. Two states on purpose: grouped and padded while the
+	 * caret is elsewhere, and exactly what was typed while it is not — grouping
+	 * a number as it is typed moves the caret out from under the fingers.
+	 */
+	let text = $state('');
+	let editing = $state(false);
+
+	$effect(() => {
+		if (editing) return;
+		text = value === null || value === undefined ? '' : formatGrouped(value, options);
+	});
+
+	// Read off the element, not off `text`: the binding that feeds `text` has
+	// not flushed yet when this fires, so it still holds the previous keystroke.
+	function onInput(event: Event & { currentTarget: HTMLInputElement }) {
+		const parsed = parseGrouped(event.currentTarget.value, options);
+		value = parsed === null ? null : clamp(parsed);
+	}
+
+	function clamp(amount: number) {
+		if (min !== undefined && amount < min) return min;
+		if (max !== undefined && amount > max) return max;
+		return amount;
+	}
+
+	function settle() {
+		editing = false;
+		const parsed = parseGrouped(text, options);
+		value = parsed === null ? null : clamp(parsed);
+		text = value === null ? '' : formatGrouped(value, options);
+	}
+</script>
+
+<Input
+	bind:value={text}
+	{size}
+	{tone}
+	{invalid}
+	{disabled}
+	inputmode="decimal"
+	oninput={onInput}
+	onfocus={() => (editing = true)}
+	onblur={settle}
+	class={className}
+	{...rest}
+>
+	{#snippet prefix()}
+		{#if currency}
+			<span class="text-xs font-medium text-text-muted">{currency}</span>
+		{/if}
+	{/snippet}
+
+	{#snippet suffix()}
+		{#if unit}
+			<span class="text-xs font-medium text-text-muted">{unit}</span>
+		{/if}
+	{/snippet}
+</Input>

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

@@ -0,0 +1,26 @@
+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' | 'suffix' | 'value' | 'min' | 'max'> {
+    /** Bindable amount. `null` is an empty field, which is not the same as 0. */
+    value?: number | null;
+    min?: number;
+    max?: number;
+    /** Thousands separator. */
+    group?: string;
+    /** Decimal separator. */
+    decimal?: string;
+    /** Decimal places the amount settles to when the field loses focus. */
+    precision?: number;
+    /** Leading mark — `Rp`, `$`, `€`. */
+    currency?: string;
+    /** Trailing mark instead, for the locales that write it that way. */
+    unit?: string;
+    size?: InputSize;
+    tone?: Tone;
+    invalid?: boolean;
+    class?: string;
+}
+declare const CurrencyInput: import("svelte").Component<Props, {}, "value">;
+type CurrencyInput = ReturnType<typeof CurrencyInput>;
+export default CurrencyInput;