@lavalogic/scoria 0.39.2 → 0.40.0

package/dist/Components/Contexts/ContextMenu.svelte

@@ -1,166 +1,166 @@
-<svelte:options runes />
-
-<!--
-@component
-Visual host for `ContextMenuContext`. Renders the fixed-positioned
-`<ul role="menu">` near the `(x, y)` coordinates the context exposes,
-and clamps the position so the menu never spills off the viewport.
-
-Mounted exactly once at the app root by `ContextWrapper`; consumers do
-not render `ContextMenu` directly. Open a menu through the context:
-
-```svelte
-<script lang="ts">
-	import { ContextMenuContext } from '@lavalogic/scoria';
-	import { getContext } from 'svelte';
-
-	const ctx = getContext<ContextMenuContext>(ContextMenuContext.identifier);
-</script>
-
-<button oncontextmenu={(e) => ctx.openContextMenu(e, items)}>
-	Right-click me
-</button>
-```
-
-### Keyboard
-
-`Escape` closes the menu and returns focus to the previously focused
-element; `ArrowUp` / `ArrowDown` cycle focus through the items.
--->
-<script lang="ts">
-	import { ContextMenuContext } from '../../Contexts/ContextMenuContext.svelte.js';
-	import { devCatch } from '../../Helpers/Helpers.svelte.js';
-	import { getContext, tick, untrack } from 'svelte';
-	import { fade } from 'svelte/transition';
-	import { usePrefersReducedMotion } from '../../Helpers/prefersReducedMotion.svelte.js';
-	import ContextMenuOption from './ContextMenuOption.svelte';
-	import type { MaybeFocusable } from './MaybeFocusable.js';
-
-	const contextMenuContext = getContext<ContextMenuContext>(ContextMenuContext.identifier);
-	const reducedMotion = usePrefersReducedMotion();
-	const fadeDuration = $derived(reducedMotion.matches ? 0 : 50);
-
-	let _x: number = $state(0);
-	let _y: number = $state(0);
-
-	$effect(() => {
-		if (contextMenuContext.showMenu) {
-			recalculateCoordinates();
-		}
-	});
-
-	function recalculateCoordinates() {
-		_x = contextMenuContext.x;
-		_y = contextMenuContext.y;
-
-		tick()
-			.then(() => {
-				const rect = menuEl?.getBoundingClientRect();
-				if (!rect) {
-					return;
-				}
-				_x = Math.min(window.innerWidth - rect.width, _x);
-				if (_y > window.innerHeight - rect.height) {
-					_y -= rect.height;
-				}
-			})
-			.catch(devCatch);
-	}
-
-	let menuEl = $state<HTMLUListElement | undefined>();
-	function closeOnClickOutside(e: MouseEvent) {
-		if (!menuEl) {
-			return;
-		}
-		if (e.target === menuEl || menuEl.contains(e.target as Node)) {
-			return;
-		}
-		contextMenuContext.closeMenu();
-	}
-
-	let previousElement = $state<MaybeFocusable | null | undefined>();
-
-	$effect.pre(() => {
-		if (contextMenuContext.showMenu) {
-			untrack(() => {
-				previousElement = document.activeElement as MaybeFocusable;
-			});
-		}
-	});
-
-	function refocusPrevious() {
-		previousElement?.focus?.();
-	}
-
-	function focusNext() {
-		if (!menuEl) {
-			return;
-		}
-		const items = [...menuEl.querySelectorAll<HTMLElement>('[role="menuitem"]')];
-		if (items.length === 0) {
-			return;
-		}
-		const index = items.indexOf(document.activeElement as HTMLElement);
-		items.at((index + 1) % items.length)?.focus();
-	}
-
-	function focusPrev() {
-		if (!menuEl) {
-			return;
-		}
-		const items = [...menuEl.querySelectorAll<HTMLElement>('[role="menuitem"]')];
-		if (items.length === 0) {
-			return;
-		}
-		const index = items.indexOf(document.activeElement as HTMLElement);
-		items.at((index - 1 + items.length) % items.length)?.focus();
-	}
-</script>
-
-<svelte:body onclick={closeOnClickOutside} />
-
-{#if contextMenuContext.showMenu}
-	<ul
-		transition:fade={{ duration: fadeDuration }}
-		bind:this={menuEl}
-		style="top: {_y}px; left: {_x}px;"
-		role="menu"
-		aria-label="Context menu"
-		tabindex="-1"
-		onkeydown={(e) => {
-			if (e.key === 'Escape') {
-				e.stopImmediatePropagation();
-				e.stopPropagation();
-				e.preventDefault();
-				contextMenuContext.closeMenu();
-				refocusPrevious();
-			} else if (e.key == 'ArrowUp') {
-				e.stopImmediatePropagation();
-				e.stopPropagation();
-				e.preventDefault();
-				focusPrev();
-			} else if (e.key == 'ArrowDown') {
-				e.stopImmediatePropagation();
-				e.stopPropagation();
-				e.preventDefault();
-				focusNext();
-			}
-		}}
-	>
-		{#each contextMenuContext.items as item, index (item)}
-			<ContextMenuOption
-				{index}
-				disabled={item.disabled}
-				onclick={() => {
-					void item.callback();
-					contextMenuContext.closeMenu();
-				}}
-				text={item.text}
-			/>
-		{/each}
-	</ul>
-{/if}
-
+<svelte:options runes />
+
+<!--
+@component
+Visual host for `ContextMenuContext`. Renders the fixed-positioned
+`<ul role="menu">` near the `(x, y)` coordinates the context exposes,
+and clamps the position so the menu never spills off the viewport.
+
+Mounted exactly once at the app root by `ContextWrapper`; consumers do
+not render `ContextMenu` directly. Open a menu through the context:
+
+```svelte
+<script lang="ts">
+	import { ContextMenuContext } from '@lavalogic/scoria';
+	import { getContext } from 'svelte';
+
+	const ctx = getContext<ContextMenuContext>(ContextMenuContext.identifier);
+</script>
+
+<button oncontextmenu={(e) => ctx.openContextMenu(e, items)}>
+	Right-click me
+</button>
+```
+
+### Keyboard
+
+`Escape` closes the menu and returns focus to the previously focused
+element; `ArrowUp` / `ArrowDown` cycle focus through the items.
+-->
+<script lang="ts">
+	import { ContextMenuContext } from '../../Contexts/ContextMenuContext.svelte.js';
+	import { devCatch } from '../../Helpers/Helpers.svelte.js';
+	import { getContext, tick, untrack } from 'svelte';
+	import { fade } from 'svelte/transition';
+	import { usePrefersReducedMotion } from '../../Helpers/prefersReducedMotion.svelte.js';
+	import ContextMenuOption from './ContextMenuOption.svelte';
+	import type { MaybeFocusable } from './MaybeFocusable.js';
+
+	const contextMenuContext = getContext<ContextMenuContext>(ContextMenuContext.identifier);
+	const reducedMotion = usePrefersReducedMotion();
+	const fadeDuration = $derived(reducedMotion.matches ? 0 : 50);
+
+	let _x: number = $state(0);
+	let _y: number = $state(0);
+
+	$effect(() => {
+		if (contextMenuContext.showMenu) {
+			recalculateCoordinates();
+		}
+	});
+
+	function recalculateCoordinates() {
+		_x = contextMenuContext.x;
+		_y = contextMenuContext.y;
+
+		tick()
+			.then(() => {
+				const rect = menuEl?.getBoundingClientRect();
+				if (!rect) {
+					return;
+				}
+				_x = Math.min(window.innerWidth - rect.width, _x);
+				if (_y > window.innerHeight - rect.height) {
+					_y -= rect.height;
+				}
+			})
+			.catch(devCatch);
+	}
+
+	let menuEl = $state<HTMLUListElement | undefined>();
+	function closeOnClickOutside(e: MouseEvent) {
+		if (!menuEl) {
+			return;
+		}
+		if (e.target === menuEl || menuEl.contains(e.target as Node)) {
+			return;
+		}
+		contextMenuContext.closeMenu();
+	}
+
+	let previousElement = $state<MaybeFocusable | null | undefined>();
+
+	$effect.pre(() => {
+		if (contextMenuContext.showMenu) {
+			untrack(() => {
+				previousElement = document.activeElement as MaybeFocusable;
+			});
+		}
+	});
+
+	function refocusPrevious() {
+		previousElement?.focus?.();
+	}
+
+	function focusNext() {
+		if (!menuEl) {
+			return;
+		}
+		const items = [...menuEl.querySelectorAll<HTMLElement>('[role="menuitem"]')];
+		if (items.length === 0) {
+			return;
+		}
+		const index = items.indexOf(document.activeElement as HTMLElement);
+		items.at((index + 1) % items.length)?.focus();
+	}
+
+	function focusPrev() {
+		if (!menuEl) {
+			return;
+		}
+		const items = [...menuEl.querySelectorAll<HTMLElement>('[role="menuitem"]')];
+		if (items.length === 0) {
+			return;
+		}
+		const index = items.indexOf(document.activeElement as HTMLElement);
+		items.at((index - 1 + items.length) % items.length)?.focus();
+	}
+</script>
+
+<svelte:body onclick={closeOnClickOutside} />
+
+{#if contextMenuContext.showMenu}
+	<ul
+		transition:fade={{ duration: fadeDuration }}
+		bind:this={menuEl}
+		style="top: {_y}px; left: {_x}px;"
+		role="menu"
+		aria-label="Context menu"
+		tabindex="-1"
+		onkeydown={(e) => {
+			if (e.key === 'Escape') {
+				e.stopImmediatePropagation();
+				e.stopPropagation();
+				e.preventDefault();
+				contextMenuContext.closeMenu();
+				refocusPrevious();
+			} else if (e.key == 'ArrowUp') {
+				e.stopImmediatePropagation();
+				e.stopPropagation();
+				e.preventDefault();
+				focusPrev();
+			} else if (e.key == 'ArrowDown') {
+				e.stopImmediatePropagation();
+				e.stopPropagation();
+				e.preventDefault();
+				focusNext();
+			}
+		}}
+	>
+		{#each contextMenuContext.items as item, index (item)}
+			<ContextMenuOption
+				{index}
+				disabled={item.disabled}
+				onclick={() => {
+					void item.callback();
+					contextMenuContext.closeMenu();
+				}}
+				text={item.text}
+			/>
+		{/each}
+	</ul>
+{/if}
+
 <style>ul {
   padding: 0.375rem;
   position: fixed;
@@ -175,4 +175,4 @@ element; `ArrowUp` / `ArrowDown` cycle focus through the items.
 
 ul:focus {
   outline: none;
-}</style>
+}</style>

package/dist/Components/Contexts/ContextMenuDivider.svelte

@@ -1,19 +1,19 @@
-<svelte:options runes />
-
-<!--
-@component
-Visual separator for {@link ContextMenu}. Renders a thin horizontal
-rule. The native `<hr>` ARIA mapping is `role="separator"`, which is
-the correct semantic inside a `role="menu"` group, so no explicit
-role is set.
-
-Intended for use between groups of `ContextMenuOption` entries inside
-a context menu rendered via the visual host.
--->
-<hr />
-
+<svelte:options runes />
+
+<!--
+@component
+Visual separator for {@link ContextMenu}. Renders a thin horizontal
+rule. The native `<hr>` ARIA mapping is `role="separator"`, which is
+the correct semantic inside a `role="menu"` group, so no explicit
+role is set.
+
+Intended for use between groups of `ContextMenuOption` entries inside
+a context menu rendered via the visual host.
+-->
+<hr />
+
 <style>hr {
   border-top: solid 1px #cbd4da;
   width: 100%;
   margin: 2px 0;
-}</style>
+}</style>

package/dist/Components/Contexts/ContextMenuOption.svelte

@@ -1,62 +1,62 @@
-<svelte:options runes />
-
-<!--
-@component
-A single row inside the {@link ContextMenu} host. Renders a
-`<button role="menuitem">` and assigns a roving `tabindex`: the
-first option (index `0`) receives focus on mount and is the only
-tab stop, all subsequent options carry `tabindex="-1"` so arrow-key
-navigation owns focus traversal within the menu.
-
-Consumers do not usually mount `ContextMenuOption` directly; the
-visual host iterates over `ContextMenuContext.items` and renders one
-option per entry.
--->
-<script lang="ts">
-	import { devCatch } from '../../Helpers/Helpers.svelte.js';
-	import { tick } from 'svelte';
-	import type { ContextMenuOptionProps } from './ContextMenuOptionProps.js';
-
-	let { text = '', index, disabled = false, onclick, children }: ContextMenuOptionProps = $props();
-
-	let element = $state<HTMLButtonElement | undefined>();
-
-	$effect(() => {
-		void element;
-		// Only the first option seeds focus. The check stays inside the
-		// effect (rather than gating registration) so Svelte's reactive
-		// dependency on `index` is recorded.
-		if (index === 0) {
-			tick()
-				.then(() => {
-					element?.focus();
-				})
-				.catch(devCatch);
-		}
-	});
-</script>
-
-<button
-	class="context-menu-item"
-	role="menuitem"
-	class:disabled
-	tabindex={index === 0 ? 0 : -1}
-	aria-disabled={disabled ? 'true' : undefined}
-	bind:this={element}
-	onclick={(e) => {
-		e.stopImmediatePropagation();
-		e.stopPropagation();
-		e.preventDefault();
-		void onclick?.(e);
-	}}
->
-	{#if text}
-		{text}
-	{:else if children}
-		{@render children()}
-	{/if}
-</button>
-
+<svelte:options runes />
+
+<!--
+@component
+A single row inside the {@link ContextMenu} host. Renders a
+`<button role="menuitem">` and assigns a roving `tabindex`: the
+first option (index `0`) receives focus on mount and is the only
+tab stop, all subsequent options carry `tabindex="-1"` so arrow-key
+navigation owns focus traversal within the menu.
+
+Consumers do not usually mount `ContextMenuOption` directly; the
+visual host iterates over `ContextMenuContext.items` and renders one
+option per entry.
+-->
+<script lang="ts">
+	import { devCatch } from '../../Helpers/Helpers.svelte.js';
+	import { tick } from 'svelte';
+	import type { ContextMenuOptionProps } from './ContextMenuOptionProps.js';
+
+	let { text = '', index, disabled = false, onclick, children }: ContextMenuOptionProps = $props();
+
+	let element = $state<HTMLButtonElement | undefined>();
+
+	$effect(() => {
+		void element;
+		// Only the first option seeds focus. The check stays inside the
+		// effect (rather than gating registration) so Svelte's reactive
+		// dependency on `index` is recorded.
+		if (index === 0) {
+			tick()
+				.then(() => {
+					element?.focus();
+				})
+				.catch(devCatch);
+		}
+	});
+</script>
+
+<button
+	class="context-menu-item"
+	role="menuitem"
+	class:disabled
+	tabindex={index === 0 ? 0 : -1}
+	aria-disabled={disabled ? 'true' : undefined}
+	bind:this={element}
+	onclick={(e) => {
+		e.stopImmediatePropagation();
+		e.stopPropagation();
+		e.preventDefault();
+		void onclick?.(e);
+	}}
+>
+	{#if text}
+		{text}
+	{:else if children}
+		{@render children()}
+	{/if}
+</button>
+
 <style>button {
   background-color: #ffffff;
   border: none;
@@ -85,4 +85,4 @@ button.disabled {
 
 button.disabled:hover {
   background: #ffffff;
-}</style>
+}</style>

package/dist/Components/Contexts/Toast.svelte

@@ -1,88 +1,88 @@
-<svelte:options runes />
-
-<!--
-@component
-Single toast rendering. Renders a pill near the bottom-right of the
-viewport via `ToastContainer`, sliding in vertically. The severity of
-the underlying toast drives both the colouring and the live-region
-semantics:
-
-- `Validity.Invalid` -> `role="alert"`, `aria-live="assertive"`.
-- All other severities -> `role="status"`, `aria-live="polite"`.
-
-The slide transition animates the pill's height (the `y` axis) so the
-message keeps its final width for the whole animation — animating the
-`x` axis instead reflows the text from stacked-and-wrapped to a single
-line as the pill widens. It honours `prefers-reduced-motion` through
-the shared `usePrefersReducedMotion` helper; when the user has opted in
-the duration collapses to zero. The copy action is only shown when
-`navigator.clipboard` is present (HTTPS or `localhost`).
--->
-<script
-	lang="ts"
-	module
->
-	import { ColourSet } from '../../scss/colours.js';
-	import { Size } from '../../Types/Internal/Size.js';
-	import { Validity } from '../../Types/Internal/Validity.js';
-	import { slide } from 'svelte/transition';
-	import Action from '../Action.svelte';
-	import Icon from '../Icon.svelte';
-	import type { ToastProps } from './ToastProps.js';
-</script>
-
-<script lang="ts">
-	import { usePrefersReducedMotion } from '../../Helpers/prefersReducedMotion.svelte.js';
-
-	let { toast, copy }: ToastProps = $props();
-
-	const reducedMotion = usePrefersReducedMotion();
-	const slideDuration = $derived(reducedMotion.matches ? 0 : 500);
-</script>
-
-<output
-	role={toast.result == Validity.Invalid ? 'alert' : 'status'}
-	aria-live={toast.result == Validity.Invalid ? 'assertive' : 'polite'}
-	class:info={toast.result == Validity.Info}
-	class:success={toast.result == Validity.Valid}
-	class:warning={toast.result == Validity.Warning}
-	class:error={toast.result == Validity.Invalid}
-	transition:slide={{ axis: 'y', duration: slideDuration }}
->
-	<div>
-		<div class="noshrink">
-			{#if toast.copyable != false && navigator.clipboard}
-				<Action
-					onclick={copy}
-					icon={{ name: 'copy' }}
-					label="Copy to clipboard"
-					size={Size.MediumLarge}
-					colourSet={ColourSet.Auxiliary}
-				/>
-			{:else}
-				<Icon
-					name="info"
-					size={Size.MediumLarge}
-				/>
-			{/if}
-		</div>
-		<span>{toast.message}</span>
-		{#if toast.closeable}
-			<div class="noshrink">
-				<Action
-					size={Size.MediumLarge}
-					icon={{ name: 'cross' }}
-					label="Dismiss"
-					onclick={() => {
-						toast.close?.();
-					}}
-					colourSet={ColourSet.Auxiliary}
-				/>
-			</div>
-		{/if}
-	</div>
-</output>
-
+<svelte:options runes />
+
+<!--
+@component
+Single toast rendering. Renders a pill near the bottom-right of the
+viewport via `ToastContainer`, sliding in vertically. The severity of
+the underlying toast drives both the colouring and the live-region
+semantics:
+
+- `Validity.Invalid` -> `role="alert"`, `aria-live="assertive"`.
+- All other severities -> `role="status"`, `aria-live="polite"`.
+
+The slide transition animates the pill's height (the `y` axis) so the
+message keeps its final width for the whole animation — animating the
+`x` axis instead reflows the text from stacked-and-wrapped to a single
+line as the pill widens. It honours `prefers-reduced-motion` through
+the shared `usePrefersReducedMotion` helper; when the user has opted in
+the duration collapses to zero. The copy action is only shown when
+`navigator.clipboard` is present (HTTPS or `localhost`).
+-->
+<script
+	lang="ts"
+	module
+>
+	import { ColourSet } from '../../scss/colours.js';
+	import { Size } from '../../Types/Internal/Size.js';
+	import { Validity } from '../../Types/Internal/Validity.js';
+	import { slide } from 'svelte/transition';
+	import Action from '../Action.svelte';
+	import Icon from '../Icon.svelte';
+	import type { ToastProps } from './ToastProps.js';
+</script>
+
+<script lang="ts">
+	import { usePrefersReducedMotion } from '../../Helpers/prefersReducedMotion.svelte.js';
+
+	let { toast, copy }: ToastProps = $props();
+
+	const reducedMotion = usePrefersReducedMotion();
+	const slideDuration = $derived(reducedMotion.matches ? 0 : 500);
+</script>
+
+<output
+	role={toast.result == Validity.Invalid ? 'alert' : 'status'}
+	aria-live={toast.result == Validity.Invalid ? 'assertive' : 'polite'}
+	class:info={toast.result == Validity.Info}
+	class:success={toast.result == Validity.Valid}
+	class:warning={toast.result == Validity.Warning}
+	class:error={toast.result == Validity.Invalid}
+	transition:slide={{ axis: 'y', duration: slideDuration }}
+>
+	<div>
+		<div class="noshrink">
+			{#if toast.copyable != false && navigator.clipboard}
+				<Action
+					onclick={copy}
+					icon={{ name: 'copy' }}
+					label="Copy to clipboard"
+					size={Size.MediumLarge}
+					colourSet={ColourSet.Auxiliary}
+				/>
+			{:else}
+				<Icon
+					name="info"
+					size={Size.MediumLarge}
+				/>
+			{/if}
+		</div>
+		<span>{toast.message}</span>
+		{#if toast.closeable}
+			<div class="noshrink">
+				<Action
+					size={Size.MediumLarge}
+					icon={{ name: 'cross' }}
+					label="Dismiss"
+					onclick={() => {
+						toast.close?.();
+					}}
+					colourSet={ColourSet.Auxiliary}
+				/>
+			</div>
+		{/if}
+	</div>
+</output>
+
 <style>output {
   font-weight: 700;
   font-size: 1.125rem;
@@ -116,4 +116,4 @@ output span {
   overflow-wrap: anywhere;
   min-width: 0;
   flex: 1 1 auto;
-}</style>
+}</style>