@lavalogic/scoria 0.39.2 → 0.40.0

package/dist/Components/ProgressBubble.svelte

@@ -1,109 +1,109 @@
-<svelte:options runes />
-
-<script lang="ts">
-	import { useAsyncFlag } from '../Helpers/AsyncFlag.svelte.js';
-	import { getCanvasContext } from '../Helpers/Helpers.svelte.js';
-	import type { BubbleColour } from './BubbleColour.js';
-	import type { ProgressBubbleProps } from './ProgressBubbleProps.js';
-
-	const { value, colours }: ProgressBubbleProps = $props();
-
-	const current = $derived(value[0]);
-	const total = $derived(value[1]);
-	const progress = $derived(`${current}/${total}`);
-
-	// Clamp the percentage so callers passing `current > total` do not
-	// blow past the bar's edge.
-	const percent = $derived(Math.min((current / total) * 100, 100));
-
-	let progressBarRef: HTMLDivElement | undefined = $state();
-
-	// Observed inline-size of the filled bar. A `ResizeObserver` is used
-	// instead of `getBoundingClientRect()` inside an `$effect`: the latter
-	// forces a synchronous layout flush on every `progress` change, which
-	// is expensive inside a table with many `ProgressBubble` cells. The
-	// observer notifies us only when the bar's actual rendered size
-	// changes, and does so via a microtask scheduled by the browser so we
-	// never force layout ourselves.
-	let barWidth = $state(0);
-	$effect(() => {
-		if (!progressBarRef) {
-			return;
-		}
-		const ro = new ResizeObserver((entries) => {
-			const entry = entries[0];
-			barWidth = entry.borderBoxSize[0]?.inlineSize ?? entry.contentRect.width;
-		});
-		ro.observe(progressBarRef);
-		return () => {
-			ro.disconnect();
-		};
-	});
-
-	// Whether the `current/total` label fits inside the filled bar.
-	// Measured via a memoised offscreen canvas so we do not trigger
-	// layout.
-	const fitsInProgressBar = $derived.by(() => {
-		const textWidth = getCanvasContext()?.measureText(`__${progress}__`).width ?? 0;
-		return barWidth > textWidth;
-	});
-
-	// `colours` may be a bare `BubbleColour`, a Promise resolving to one,
-	// or undefined. Routed through `useAsyncFlag` which (a) cancels stale
-	// Promises via a sequence ticket so the freshest value always wins,
-	// (b) reports errors through `ToastContext` when one is mounted, and
-	// (c) falls back to `undefined` while no resolution is available.
-	const awaitedColoursFlag = useAsyncFlag<BubbleColour | undefined>(() => colours, undefined);
-	const awaitedColours = $derived(awaitedColoursFlag.value);
-
-	// Precompute the wrapper and bar style strings. Each colour comes
-	// from the trusted `Colour` registry (see `Bubble.svelte` security
-	// note) so interpolation into `style="..."` is safe.
-	const wrapperStyle = $derived(
-		awaitedColours
-			? `--bar-background-colour: ${awaitedColours.backgroundColour}; --text-colour: ${awaitedColours.colour};`
-			: ''
-	);
-	const barStyle = $derived(`width: ${percent}%;`);
-</script>
-
-<div
-	class="progress-wrapper"
-	style={wrapperStyle}
->
-	<!--
-		Native `<progress>` is kept as a fallback for assistive tech that
-		ignores ARIA progressbar roles. Visually hidden rather than
-		`display: none` so the element stays in the accessibility tree.
-	-->
-	<progress
-		class="visually-hidden"
-		value={current}
-		max={total}>{progress}</progress
-	>
-
-	<div
-		class="progress-background"
-		role="progressbar"
-		aria-valuenow={current}
-		aria-valuemin={0}
-		aria-valuemax={total}
-		aria-valuetext={progress}
-	>
-		<div
-			class:fits={fitsInProgressBar}
-			class="progress-value"
-			bind:this={progressBarRef}
-			style={barStyle}
-		>
-			<span
-				class:fits={fitsInProgressBar}
-				class="progress-text">{progress}</span
-			>
-		</div>
-	</div>
-</div>
-
+<svelte:options runes />
+
+<script lang="ts">
+	import { useAsyncFlag } from '../Helpers/AsyncFlag.svelte.js';
+	import { getCanvasContext } from '../Helpers/Helpers.svelte.js';
+	import type { BubbleColour } from './BubbleColour.js';
+	import type { ProgressBubbleProps } from './ProgressBubbleProps.js';
+
+	const { value, colours }: ProgressBubbleProps = $props();
+
+	const current = $derived(value[0]);
+	const total = $derived(value[1]);
+	const progress = $derived(`${current}/${total}`);
+
+	// Clamp the percentage so callers passing `current > total` do not
+	// blow past the bar's edge.
+	const percent = $derived(Math.min((current / total) * 100, 100));
+
+	let progressBarRef: HTMLDivElement | undefined = $state();
+
+	// Observed inline-size of the filled bar. A `ResizeObserver` is used
+	// instead of `getBoundingClientRect()` inside an `$effect`: the latter
+	// forces a synchronous layout flush on every `progress` change, which
+	// is expensive inside a table with many `ProgressBubble` cells. The
+	// observer notifies us only when the bar's actual rendered size
+	// changes, and does so via a microtask scheduled by the browser so we
+	// never force layout ourselves.
+	let barWidth = $state(0);
+	$effect(() => {
+		if (!progressBarRef) {
+			return;
+		}
+		const ro = new ResizeObserver((entries) => {
+			const entry = entries[0];
+			barWidth = entry.borderBoxSize[0]?.inlineSize ?? entry.contentRect.width;
+		});
+		ro.observe(progressBarRef);
+		return () => {
+			ro.disconnect();
+		};
+	});
+
+	// Whether the `current/total` label fits inside the filled bar.
+	// Measured via a memoised offscreen canvas so we do not trigger
+	// layout.
+	const fitsInProgressBar = $derived.by(() => {
+		const textWidth = getCanvasContext()?.measureText(`__${progress}__`).width ?? 0;
+		return barWidth > textWidth;
+	});
+
+	// `colours` may be a bare `BubbleColour`, a Promise resolving to one,
+	// or undefined. Routed through `useAsyncFlag` which (a) cancels stale
+	// Promises via a sequence ticket so the freshest value always wins,
+	// (b) reports errors through `ToastContext` when one is mounted, and
+	// (c) falls back to `undefined` while no resolution is available.
+	const awaitedColoursFlag = useAsyncFlag<BubbleColour | undefined>(() => colours, undefined);
+	const awaitedColours = $derived(awaitedColoursFlag.value);
+
+	// Precompute the wrapper and bar style strings. Each colour comes
+	// from the trusted `Colour` registry (see `Bubble.svelte` security
+	// note) so interpolation into `style="..."` is safe.
+	const wrapperStyle = $derived(
+		awaitedColours
+			? `--bar-background-colour: ${awaitedColours.backgroundColour}; --text-colour: ${awaitedColours.colour};`
+			: ''
+	);
+	const barStyle = $derived(`width: ${percent}%;`);
+</script>
+
+<div
+	class="progress-wrapper"
+	style={wrapperStyle}
+>
+	<!--
+		Native `<progress>` is kept as a fallback for assistive tech that
+		ignores ARIA progressbar roles. Visually hidden rather than
+		`display: none` so the element stays in the accessibility tree.
+	-->
+	<progress
+		class="visually-hidden"
+		value={current}
+		max={total}>{progress}</progress
+	>
+
+	<div
+		class="progress-background"
+		role="progressbar"
+		aria-valuenow={current}
+		aria-valuemin={0}
+		aria-valuemax={total}
+		aria-valuetext={progress}
+	>
+		<div
+			class:fits={fitsInProgressBar}
+			class="progress-value"
+			bind:this={progressBarRef}
+			style={barStyle}
+		>
+			<span
+				class:fits={fitsInProgressBar}
+				class="progress-text">{progress}</span
+			>
+		</div>
+	</div>
+</div>
+
 <style>.progress-wrapper {
   width: 100%;
   height: 100%;
@@ -172,4 +172,4 @@
 }
 .progress-text.fits {
   color: var(--text-colour, #3a4952);
-}</style>
+}</style>