@lavalogic/scoria 0.39.2 → 0.40.0

package/dist/Components/MultiSelect.svelte

@@ -1,222 +1,222 @@
-<svelte:options runes />
-
-<script
-	lang="ts"
-	generics="V extends object, VP extends ValueProp<V>"
->
-	import { autoPluralise, generateWeakId, vowels } from '../Helpers/Helpers.svelte.js';
-	import { attachDropdownPortal } from '../Helpers/dropdownPortal.js';
-	import { Colour, ColourSet } from '../scss/colours.js';
-	import type { ValueProp } from '../Types/Internal/Misc.js';
-	import { Size } from '../Types/Internal/Size.js';
-	import Svelecte from 'svelecte';
-	import { SvelteSet } from 'svelte/reactivity';
-	import { onMount } from 'svelte';
-	import Action from './Action.svelte';
-	import Icon from './Icon.svelte';
-	import type { MultiSelectProps } from './MultiSelectProps.js';
-
-	// NOTE selectedValues is mutated by svelecte without asking, so we sometimes have to reverse it without a callback (side effects)
-	const {
-		label,
-		inputId = generateWeakId(),
-		options,
-		labelProp,
-		valueProp,
-		width,
-		valueAsObject = true,
-		height,
-		selectedValues,
-		onchange,
-		collapseSelection = false,
-		name = 'Item',
-		disabled,
-		required,
-		invalid,
-	}: MultiSelectProps<V, VP> = $props();
-
-	const an = $derived(name && vowels.has(name.at(0)?.toLocaleLowerCase() ?? '') ? 'an' : 'a');
-
-	// Pre-computed set of selected primitive keys. Used in the option snippet
-	// to avoid an O(n*m) findIndex sweep per render.
-	const selectedKeys = $derived.by(() => {
-		const s = new SvelteSet<V[VP]>();
-		if (valueAsObject) {
-			for (const v of selectedValues as Array<V>) {
-				s.add(v[valueProp]);
-			}
-		} else {
-			for (const v of selectedValues as Array<V[VP]>) {
-				s.add(v);
-			}
-		}
-		return s;
-	});
-
-	let isExpanded = $state(false);
-
-	onMount(() => {
-		const input = document.getElementById(inputId);
-		const svelecteRoot = input?.closest('div.svelecte') as HTMLElement | null;
-		const dropdownRef =
-			(svelecteRoot?.querySelector('.sv_dropdown') as HTMLElement | null) ?? undefined;
-
-		// HACK callback for is-open on/off; drives the chevron rotation
-		// in the action snippet further down.
-		const observer = new MutationObserver((mutations: Array<MutationRecord>) => {
-			for (let i = mutations.length - 1; i > -1; i--) {
-				const mutation = mutations[i];
-				if (mutation.attributeName === 'class') {
-					isExpanded = dropdownRef?.classList.contains('is-open') ?? false;
-				}
-			}
-		});
-
-		if (dropdownRef) {
-			observer.observe(dropdownRef, { attributes: true });
-		}
-
-		// Teleport the Svelecte dropdown to `document.body` while open
-		// so it escapes every ancestor `overflow` / `transform` /
-		// `z-index` stacking context. See `Helpers/dropdownPortal.ts`
-		// for the rationale and behaviour (auto-flip upwards on tight
-		// viewports, scroll-aware repositioning, viewport-bounded
-		// max-height).
-		const detachPortal = attachDropdownPortal({
-			getTrigger: () => svelecteRoot,
-			getDropdown: () => dropdownRef,
-		});
-
-		return () => {
-			observer.disconnect();
-			detachPortal();
-		};
-	});
-
-	const isInvalid = $derived((required && !selectedValues.length) || invalid);
-</script>
-
-<div
-	class:invalid={isInvalid}
-	class="select-wrapper"
-	style={`${width ? `--input-width: ${width};` : ''}${height ? `--input-height: ${height};` : ''}`}
->
-	{#if label}
-		<label for={inputId}>
-			<span>{label}</span>
-			<span class="border">{label}</span>
-		</label>
-	{/if}
-
-	<Svelecte
-		multiple
-		{valueAsObject}
-		{disabled}
-		{inputId}
-		valueField={valueProp}
-		labelField={labelProp}
-		{options}
-		searchable
-		value={selectedValues}
-		onChange={(e: Array<V>) => {
-			// svelecte always emits the full option objects; normalise to the
-			// shape the variant promised: primitives for AsPrimitive,
-			// objects for AsObject. This is what the discriminated
-			// `onchange` typing now guarantees to consumers.
-			if (valueAsObject) {
-				void (onchange as (v: Array<V>) => void | Promise<void>)(e);
-			} else {
-				const primitives = e.map((it) => it[valueProp]);
-				void (onchange as (v: Array<V[VP]>) => void | Promise<void>)(primitives);
-			}
-		}}
-		{name}
-		selectOnTab
-		keepSelectionInList
-		searchProps={{ keepSelectionInList: true }}
-		creatable={false}
-		collapseSelection={collapseSelection ? 'always' : null}
-		deselectMode="toggle"
-		highlightFirstItem={false}
-		placeholder="Please Select {name ? `${an} ${name}` : ''}"
-		selection={collapseSelection ? selection : undefined}
-	>
-		{#snippet option(opt)}
-			{@const option = opt as V}
-			<span class="dropdown-item">
-				<div
-					class="toggle-icon"
-					class:yes={selectedKeys.has(option[valueProp])}
-				>
-					<Icon
-						name="tick"
-						size={Size.MediumSmall}
-					/>
-				</div>
-				{option[labelProp]}</span
-			>
-		{/snippet}
-
-		{#snippet collapsedSelection(selectedOptions: Array<object> /*_i18n*/)}
-			<span class="selection"
-				>{#if selectedOptions.length}{selectedOptions.length}
-					{#if name}{autoPluralise(name, selectedOptions.length)}{/if} Selected
-				{:else}Please Select {#if name}
-						{an} {name}{/if}
-				{/if}</span
-			>
-		{/snippet}
-
-		{#snippet append()}
-			<div class="icons">
-				<Action
-					{disabled}
-					size={Size.Small}
-					noTabIndex
-					colourSet={ColourSet.Auxiliary}
-					onclick={(e: MouseEvent) => {
-						if (isExpanded) {
-							e.stopPropagation();
-						}
-
-						if (selectedValues.length) {
-							// Empty array satisfies both Array<V> and Array<V[VP]>.
-							void (onchange as (v: Array<V> | Array<V[VP]>) => void | Promise<void>)([]);
-						} else if (valueAsObject) {
-							void (onchange as (v: Array<V>) => void | Promise<void>)(options.concat());
-						} else {
-							const primitives = options.map((it) => it[valueProp]);
-							void (onchange as (v: Array<V[VP]>) => void | Promise<void>)(primitives);
-						}
-					}}
-					icon={{
-						name: selectedValues.length ? 'close-menu-cross' : 'manage-product-group',
-						colour: Colour['$ui-blue-10'],
-					}}
-				/>
-
-				<Action
-					{disabled}
-					size={Size.Small}
-					noTabIndex
-					colourSet={ColourSet.Auxiliary}
-					icon={{
-						name: isExpanded ? 'chevron-up' : 'chevron-down',
-						colour: Colour['$ui-blue-10'],
-					}}
-				/>
-			</div>
-		{/snippet}
-		{#snippet toggleIcon()}
-			<div class="nothing"></div>
-		{/snippet}
-	</Svelecte>
-
-	{#snippet selection(/*_selectedOptions: Array<unknown>*/)}
-		<!-- collapsed selection rendered above -->
-	{/snippet}
-</div>
-
+<svelte:options runes />
+
+<script
+	lang="ts"
+	generics="V extends object, VP extends ValueProp<V>"
+>
+	import { autoPluralise, generateWeakId, vowels } from '../Helpers/Helpers.svelte.js';
+	import { attachDropdownPortal } from '../Helpers/dropdownPortal.js';
+	import { Colour, ColourSet } from '../scss/colours.js';
+	import type { ValueProp } from '../Types/Internal/Misc.js';
+	import { Size } from '../Types/Internal/Size.js';
+	import Svelecte from 'svelecte';
+	import { SvelteSet } from 'svelte/reactivity';
+	import { onMount } from 'svelte';
+	import Action from './Action.svelte';
+	import Icon from './Icon.svelte';
+	import type { MultiSelectProps } from './MultiSelectProps.js';
+
+	// NOTE selectedValues is mutated by svelecte without asking, so we sometimes have to reverse it without a callback (side effects)
+	const {
+		label,
+		inputId = generateWeakId(),
+		options,
+		labelProp,
+		valueProp,
+		width,
+		valueAsObject = true,
+		height,
+		selectedValues,
+		onchange,
+		collapseSelection = false,
+		name = 'Item',
+		disabled,
+		required,
+		invalid,
+	}: MultiSelectProps<V, VP> = $props();
+
+	const an = $derived(name && vowels.has(name.at(0)?.toLocaleLowerCase() ?? '') ? 'an' : 'a');
+
+	// Pre-computed set of selected primitive keys. Used in the option snippet
+	// to avoid an O(n*m) findIndex sweep per render.
+	const selectedKeys = $derived.by(() => {
+		const s = new SvelteSet<V[VP]>();
+		if (valueAsObject) {
+			for (const v of selectedValues as Array<V>) {
+				s.add(v[valueProp]);
+			}
+		} else {
+			for (const v of selectedValues as Array<V[VP]>) {
+				s.add(v);
+			}
+		}
+		return s;
+	});
+
+	let isExpanded = $state(false);
+
+	onMount(() => {
+		const input = document.getElementById(inputId);
+		const svelecteRoot = input?.closest('div.svelecte') as HTMLElement | null;
+		const dropdownRef =
+			(svelecteRoot?.querySelector('.sv_dropdown') as HTMLElement | null) ?? undefined;
+
+		// HACK callback for is-open on/off; drives the chevron rotation
+		// in the action snippet further down.
+		const observer = new MutationObserver((mutations: Array<MutationRecord>) => {
+			for (let i = mutations.length - 1; i > -1; i--) {
+				const mutation = mutations[i];
+				if (mutation.attributeName === 'class') {
+					isExpanded = dropdownRef?.classList.contains('is-open') ?? false;
+				}
+			}
+		});
+
+		if (dropdownRef) {
+			observer.observe(dropdownRef, { attributes: true });
+		}
+
+		// Teleport the Svelecte dropdown to `document.body` while open
+		// so it escapes every ancestor `overflow` / `transform` /
+		// `z-index` stacking context. See `Helpers/dropdownPortal.ts`
+		// for the rationale and behaviour (auto-flip upwards on tight
+		// viewports, scroll-aware repositioning, viewport-bounded
+		// max-height).
+		const detachPortal = attachDropdownPortal({
+			getTrigger: () => svelecteRoot,
+			getDropdown: () => dropdownRef,
+		});
+
+		return () => {
+			observer.disconnect();
+			detachPortal();
+		};
+	});
+
+	const isInvalid = $derived((required && !selectedValues.length) || invalid);
+</script>
+
+<div
+	class:invalid={isInvalid}
+	class="select-wrapper"
+	style={`${width ? `--input-width: ${width};` : ''}${height ? `--input-height: ${height};` : ''}`}
+>
+	{#if label}
+		<label for={inputId}>
+			<span>{label}</span>
+			<span class="border">{label}</span>
+		</label>
+	{/if}
+
+	<Svelecte
+		multiple
+		{valueAsObject}
+		{disabled}
+		{inputId}
+		valueField={valueProp}
+		labelField={labelProp}
+		{options}
+		searchable
+		value={selectedValues}
+		onChange={(e: Array<V>) => {
+			// svelecte always emits the full option objects; normalise to the
+			// shape the variant promised: primitives for AsPrimitive,
+			// objects for AsObject. This is what the discriminated
+			// `onchange` typing now guarantees to consumers.
+			if (valueAsObject) {
+				void (onchange as (v: Array<V>) => void | Promise<void>)(e);
+			} else {
+				const primitives = e.map((it) => it[valueProp]);
+				void (onchange as (v: Array<V[VP]>) => void | Promise<void>)(primitives);
+			}
+		}}
+		{name}
+		selectOnTab
+		keepSelectionInList
+		searchProps={{ keepSelectionInList: true }}
+		creatable={false}
+		collapseSelection={collapseSelection ? 'always' : null}
+		deselectMode="toggle"
+		highlightFirstItem={false}
+		placeholder="Please Select {name ? `${an} ${name}` : ''}"
+		selection={collapseSelection ? selection : undefined}
+	>
+		{#snippet option(opt)}
+			{@const option = opt as V}
+			<span class="dropdown-item">
+				<div
+					class="toggle-icon"
+					class:yes={selectedKeys.has(option[valueProp])}
+				>
+					<Icon
+						name="tick"
+						size={Size.MediumSmall}
+					/>
+				</div>
+				{option[labelProp]}</span
+			>
+		{/snippet}
+
+		{#snippet collapsedSelection(selectedOptions: Array<object> /*_i18n*/)}
+			<span class="selection"
+				>{#if selectedOptions.length}{selectedOptions.length}
+					{#if name}{autoPluralise(name, selectedOptions.length)}{/if} Selected
+				{:else}Please Select {#if name}
+						{an} {name}{/if}
+				{/if}</span
+			>
+		{/snippet}
+
+		{#snippet append()}
+			<div class="icons">
+				<Action
+					{disabled}
+					size={Size.Small}
+					noTabIndex
+					colourSet={ColourSet.Auxiliary}
+					onclick={(e: MouseEvent) => {
+						if (isExpanded) {
+							e.stopPropagation();
+						}
+
+						if (selectedValues.length) {
+							// Empty array satisfies both Array<V> and Array<V[VP]>.
+							void (onchange as (v: Array<V> | Array<V[VP]>) => void | Promise<void>)([]);
+						} else if (valueAsObject) {
+							void (onchange as (v: Array<V>) => void | Promise<void>)(options.concat());
+						} else {
+							const primitives = options.map((it) => it[valueProp]);
+							void (onchange as (v: Array<V[VP]>) => void | Promise<void>)(primitives);
+						}
+					}}
+					icon={{
+						name: selectedValues.length ? 'close-menu-cross' : 'manage-product-group',
+						colour: Colour['$ui-blue-10'],
+					}}
+				/>
+
+				<Action
+					{disabled}
+					size={Size.Small}
+					noTabIndex
+					colourSet={ColourSet.Auxiliary}
+					icon={{
+						name: isExpanded ? 'chevron-up' : 'chevron-down',
+						colour: Colour['$ui-blue-10'],
+					}}
+				/>
+			</div>
+		{/snippet}
+		{#snippet toggleIcon()}
+			<div class="nothing"></div>
+		{/snippet}
+	</Svelecte>
+
+	{#snippet selection(/*_selectedOptions: Array<unknown>*/)}
+		<!-- collapsed selection rendered above -->
+	{/snippet}
+</div>
+
 <style>.select-wrapper {
   min-width: var(--input-min-width, 12rem);
   width: var(--input-width, 100%);
@@ -379,4 +379,4 @@ div.icons {
 }
 :global(.dropdown-item) .toggle-icon.yes {
   opacity: 1;
-}</style>
+}</style>

package/dist/Components/Nav/Nav.svelte

@@ -1,112 +1,112 @@
-<svelte:options runes />
-
-<script
-	lang="ts"
-	generics="T"
->
-	import { afterNavigate } from '$app/navigation';
-	import { Size } from '../../Types/Internal/Size.js';
-	import Icon from '../Icon.svelte';
-	import type { NavProps } from './NavProps.js';
-	import ServicesNav from './ServicesNav.svelte';
-
-	const {
-		userName,
-		extras,
-		userDialog,
-		serviceTabs,
-		selectedServiceTab,
-		brand,
-		// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-arguments
-	}: NavProps<T> = $props();
-
-	const userIcon = $derived.by(() => {
-		const names = userName.split(' ');
-
-		const initials = names.map((it) => it.charAt(0)).slice(0, 2);
-		return initials;
-	});
-
-	const singleLetter = $derived(userIcon.length === 1);
-	const hasLetters = $derived(userIcon.length > 0);
-
-	let showServicesDialog = $state(false);
-	let showUserDialog = $state(false);
-
-	// Close both nav popovers after any navigation. Selecting an item in
-	// the Services menu is a navigation, so the menu must dismiss itself —
-	// without this it only closed when the consumer happened to remount
-	// `<Nav>` (e.g. on a main-area change), leaving it open when the user
-	// picked a sibling item within the same area.
-	afterNavigate(() => {
-		showServicesDialog = false;
-		showUserDialog = false;
-	});
-</script>
-
-<nav class="main-navigation">
-	{#if typeof brand === 'string'}
-		<span class="nav-link brand">{brand}</span>
-	{:else if brand}
-		<span class="nav-link brand">{@render brand()}</span>
-	{/if}
-
-	<div class="nav-link">
-		<button
-			onclick={() => {
-				showServicesDialog = !showServicesDialog;
-			}}
-		>
-			<div class="delimited">
-				<Icon
-					name="block-menu"
-					size={Size.Medium}
-				/>
-				<span>Services</span>
-			</div>
-		</button>
-
-		{#if showServicesDialog}
-			<ServicesNav
-				onclose={() => {
-					showServicesDialog = false;
-				}}
-				{serviceTabs}
-				{selectedServiceTab}
-			/>
-		{/if}
-	</div>
-
-	<div class="nav-search-container"></div>
-	{#if extras}
-		<div class="nav-link spaced selects">
-			{@render extras()}
-		</div>
-	{/if}
-
-	<div>
-		<button
-			onclick={() => {
-				showUserDialog = !showUserDialog;
-			}}
-		>
-			<span class="nav-link padded">
-				<span
-					class="user-icon"
-					class:visible={hasLetters}
-					class:single-letter={singleLetter}>{userIcon}</span
-				>
-				<span class="user-name">{userName}</span>
-			</span>
-		</button>
-		{#if showUserDialog}
-			{@render userDialog(() => {
-				showUserDialog = false;
-			})}
-		{/if}
-	</div>
-</nav>
-
+<svelte:options runes />
+
+<script
+	lang="ts"
+	generics="T"
+>
+	import { afterNavigate } from '$app/navigation';
+	import { Size } from '../../Types/Internal/Size.js';
+	import Icon from '../Icon.svelte';
+	import type { NavProps } from './NavProps.js';
+	import ServicesNav from './ServicesNav.svelte';
+
+	const {
+		userName,
+		extras,
+		userDialog,
+		serviceTabs,
+		selectedServiceTab,
+		brand,
+		// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-arguments
+	}: NavProps<T> = $props();
+
+	const userIcon = $derived.by(() => {
+		const names = userName.split(' ');
+
+		const initials = names.map((it) => it.charAt(0)).slice(0, 2);
+		return initials;
+	});
+
+	const singleLetter = $derived(userIcon.length === 1);
+	const hasLetters = $derived(userIcon.length > 0);
+
+	let showServicesDialog = $state(false);
+	let showUserDialog = $state(false);
+
+	// Close both nav popovers after any navigation. Selecting an item in
+	// the Services menu is a navigation, so the menu must dismiss itself —
+	// without this it only closed when the consumer happened to remount
+	// `<Nav>` (e.g. on a main-area change), leaving it open when the user
+	// picked a sibling item within the same area.
+	afterNavigate(() => {
+		showServicesDialog = false;
+		showUserDialog = false;
+	});
+</script>
+
+<nav class="main-navigation">
+	{#if typeof brand === 'string'}
+		<span class="nav-link brand">{brand}</span>
+	{:else if brand}
+		<span class="nav-link brand">{@render brand()}</span>
+	{/if}
+
+	<div class="nav-link">
+		<button
+			onclick={() => {
+				showServicesDialog = !showServicesDialog;
+			}}
+		>
+			<div class="delimited">
+				<Icon
+					name="block-menu"
+					size={Size.Medium}
+				/>
+				<span>Services</span>
+			</div>
+		</button>
+
+		{#if showServicesDialog}
+			<ServicesNav
+				onclose={() => {
+					showServicesDialog = false;
+				}}
+				{serviceTabs}
+				{selectedServiceTab}
+			/>
+		{/if}
+	</div>
+
+	<div class="nav-search-container"></div>
+	{#if extras}
+		<div class="nav-link spaced selects">
+			{@render extras()}
+		</div>
+	{/if}
+
+	<div>
+		<button
+			onclick={() => {
+				showUserDialog = !showUserDialog;
+			}}
+		>
+			<span class="nav-link padded">
+				<span
+					class="user-icon"
+					class:visible={hasLetters}
+					class:single-letter={singleLetter}>{userIcon}</span
+				>
+				<span class="user-name">{userName}</span>
+			</span>
+		</button>
+		{#if showUserDialog}
+			{@render userDialog(() => {
+				showUserDialog = false;
+			})}
+		{/if}
+	</div>
+</nav>
+
 <style>div.overlay {
   position: fixed;
   top: calc(3.25rem + var(--env-border-height, 0));
@@ -230,4 +230,4 @@ div.delimited {
   align-items: center;
   justify-content: center;
   gap: 0.5rem;
-}</style>
+}</style>