@lavalogic/scoria 0.35.0 → 0.37.0

package/dist/Components/Checkbox.svelte

@@ -1,71 +1,90 @@
-<svelte:options runes />
-
-<script lang="ts" module>
-	import { generateShortUUID } from '../Helpers/Helpers.svelte.js';
-	import { Size } from '../Types/Internal/Size.js';
-	import type { ChangeEventHandler } from 'svelte/elements';
-	import Icon from './Icon.svelte';
-	import type { IconProps } from './IconProps.js';
-
-	export interface CheckboxProps {
-		value: boolean;
-		id?: string;
-		icon?: IconProps;
-		size?: Size;
-		label?: string;
-		disabled?: boolean;
-		onchange?: ChangeEventHandler<HTMLInputElement>;
-	}
-</script>
-
-<script lang="ts">
-	let {
-		value = false,
-		id = generateShortUUID(),
-		icon,
-		size,
-		label,
-		disabled,
-		onchange
-	}: CheckboxProps = $props();
-</script>
-
-{#if icon}
-	<!-- style="--inner-checkbox-container-width: {(size != undefined ? widths[size] : undefined) ??
-			'2.75rem'};" -->
-	<div
-		class="outer-checkbox-container"
-		class:fill-width={size === Size.FillWidth}
-		class:fill-height={size === Size.FillHeight}
-	>
-		<div class="inner-checkbox-container with-icon" class:disabled>
-			<input
-				{id}
-				name={id}
-				class="with-icon"
-				{onchange}
-				type="checkbox"
-				{disabled}
-				checked={value}
-			/>
-			<label class="icon-label" for={id} class:disabled>
-				<Icon {...icon} size={icon.size ?? size ?? Size.DoubleXLarge} />
-			</label>
-		</div>
-		{#if label}
-			<label class="text-label" for={id}>{label}</label>
-		{/if}
-	</div>
-{:else}
-	<div class="checkbox-container">
-		<input {id} {onchange} type="checkbox" checked={value} {disabled} />
-		{#if label}
-			<label class="text-label" for={id}>{label}</label>
-		{/if}
-	</div>
-{/if}
-
+<svelte:options runes />
+
+<script
+	lang="ts"
+	module
+>
+	import { generateWeakId } from '../Helpers/Helpers.svelte.js';
+	import { Size } from '../Types/Internal/Size.js';
+	import type { CheckboxProps } from './CheckboxProps.js';
+	import Icon from './Icon.svelte';
+</script>
+
+<script lang="ts">
+	let {
+		value = false,
+		id = generateWeakId(),
+		icon,
+		size,
+		label,
+		disabled,
+		onchange,
+	}: CheckboxProps = $props();
+</script>
+
+{#if icon}
+	<div
+		class="outer-checkbox-container"
+		class:fill-width={size === Size.FillWidth}
+		class:fill-height={size === Size.FillHeight}
+	>
+		<div
+			class="inner-checkbox-container with-icon"
+			class:disabled
+		>
+			<input
+				{id}
+				name={id}
+				class="with-icon"
+				{onchange}
+				type="checkbox"
+				{disabled}
+				checked={value}
+			/>
+			<label
+				class="icon-label"
+				for={id}
+				class:disabled
+			>
+				<Icon
+					{...icon}
+					size={icon.size ?? size ?? Size.DoubleXLarge}
+				/>
+			</label>
+		</div>
+		{#if label}
+			<label
+				class="text-label"
+				for={id}>{label}</label
+			>
+		{/if}
+	</div>
+{:else}
+	<div
+		class="checkbox-container"
+		class:compact={size === Size.Tiny ||
+			size === Size.Small ||
+			size === Size.MediumSmall ||
+			size === Size.Medium}
+	>
+		<input
+			{id}
+			{onchange}
+			type="checkbox"
+			checked={value}
+			{disabled}
+		/>
+		{#if label}
+			<label
+				class="text-label"
+				for={id}>{label}</label
+			>
+		{/if}
+	</div>
+{/if}
+
 <style>.outer-checkbox-container {
+  box-sizing: border-box;
   display: flex;
   flex-flow: row nowrap;
   align-items: stretch;
@@ -79,7 +98,7 @@
   height: 100%;
 }
 .outer-checkbox-container:hover div.inner-checkbox-container:not(.disabled) {
-  border: solid 2px #676774;
+  border: solid 2px #5a707f;
 }
 .outer-checkbox-container .icon-label {
   width: 100%;
@@ -99,11 +118,19 @@
   width: 3rem;
   height: 3rem;
 }
+.checkbox-container.compact input {
+  width: 1.25rem;
+  height: 1.25rem;
+}
 
 label.text-label {
   padding-left: 1rem;
 }
 
+.checkbox-container.compact label.text-label {
+  padding-left: 0.5rem;
+}
+
 input {
   cursor: pointer;
   accent-color: var(--colour, #259fc7);
@@ -122,24 +149,25 @@ input.with-icon {
 }
 
 div.inner-checkbox-container {
+  box-sizing: border-box;
   width: 100%;
   height: 100%;
   background-color: #ffffff;
   color: #ffffff;
   fill: #ffffff;
-  border: solid 2px #8f8f9d;
+  border: solid 2px #adbbc5;
   border-radius: 4px;
 }
 div.inner-checkbox-container label:not(.disabled):hover {
   color: #8096a5;
   fill: #8096a5;
 }
-div.inner-checkbox-container input:checked:not([disabled=true]) + label {
+div.inner-checkbox-container input:checked:not([disabled]) + label {
   background-color: #259fc7;
   color: #ffffff;
   fill: #ffffff;
 }
-div.inner-checkbox-container input:checked:not([disabled=true]) + label:hover {
+div.inner-checkbox-container input:checked:not([disabled]) + label:hover {
   color: #1f81a0;
   fill: #1f81a0;
 }
@@ -148,4 +176,4 @@ label {
   display: block;
   cursor: pointer;
   position: relative;
-}</style>
+}</style>

package/dist/Components/Checkbox.svelte.d.ts

@@ -1,15 +1,4 @@
-import { Size } from '../Types/Internal/Size.js';
-import type { ChangeEventHandler } from 'svelte/elements';
-import type { IconProps } from './IconProps.js';
-export interface CheckboxProps {
-    value: boolean;
-    id?: string;
-    icon?: IconProps;
-    size?: Size;
-    label?: string;
-    disabled?: boolean;
-    onchange?: ChangeEventHandler<HTMLInputElement>;
-}
+import type { CheckboxProps } from './CheckboxProps.js';
 declare const Checkbox: import("svelte").Component<CheckboxProps, {}, "">;
 type Checkbox = ReturnType<typeof Checkbox>;
 export default Checkbox;

package/dist/Components/CheckboxProps.d.ts

@@ -0,0 +1,27 @@
+import type { Size } from '../Types/Internal/Size.js';
+import type { ChangeEventHandler } from 'svelte/elements';
+import type { IconProps } from './IconProps.js';
+/**
+ * Props for the {@link Checkbox} component.
+ *
+ * Supports a label-only variant and an icon variant. When `icon` is
+ * provided the native checkbox is visually replaced by the icon, with
+ * the underlying `<input>` kept in the DOM (visually hidden) to retain
+ * keyboard and screen-reader semantics.
+ */
+export interface CheckboxProps {
+    /** Current checked state. */
+    value: boolean;
+    /** `id` on the `<input>`. Defaults to a generated short UUID. */
+    id?: string;
+    /** Optional icon rendered in place of the native checkbox UI. */
+    icon?: IconProps;
+    /** Render size token (drives the visual scale). */
+    size?: Size;
+    /** Visible label next to the checkbox. */
+    label?: string;
+    /** Native `disabled` attribute. */
+    disabled?: boolean;
+    /** Native `change` event handler. */
+    onchange?: ChangeEventHandler<HTMLInputElement>;
+}

package/dist/Components/CheckboxProps.js

@@ -0,0 +1 @@
+export {};

package/dist/Components/CollapsibleCard.svelte

@@ -1,74 +1,82 @@
-<svelte:options runes />
-
-<script lang="ts">
-	import { loadingText } from '../Helpers/Helpers.svelte.js';
-	import { Size } from '../Types/Internal/Size.js';
-	import { Colour } from '../scss/colours.js';
-	import Action from './Action.svelte';
-	import type { CollapsibleCardProps } from './CollapsibleCardProps.js';
-
-	let {
-		title,
-		subtitle,
-		maxHeight: maxHeight,
-		children,
-		grow,
-		isCollapsed = $bindable(false),
-	}: CollapsibleCardProps = $props();
-
-	let cardRef: HTMLDivElement | undefined = $state();
-
-	let cardMaxHeight = $derived(
-		cardRef && maxHeight != undefined && maxHeight > 0 && `${maxHeight}px`
-	);
-</script>
-
-<div
-	class="collapsible-card"
-	bind:this={cardRef}
-	style={cardMaxHeight ? `--card-max-height: ${cardMaxHeight};` : ''}
-	class:is-collapsed={isCollapsed}
-	class:grow
->
-	<div class="heading">
-		<div class="left">
-			<h3>{title}</h3>
-			{#if subtitle}
-				{#await subtitle}
-					<span>{loadingText}</span>
-				{:then subtitle}
-					<span>{subtitle}</span>
-				{/await}
-			{/if}
-		</div>
-		<div class="right">
-			<Action
-				label={isCollapsed ? 'Expand' : 'Collapse'}
-				onclick={() => {
-					isCollapsed = !isCollapsed;
-				}}
-				size={Size.TripleXLarge}
-				icon={{
-					name: isCollapsed ? 'circle-plus' : 'circle-minus',
-					colour: Colour['$ui-blue-5'],
-					size: Size.Medium,
-				}}
-			/>
-		</div>
-	</div>
-
-	<div
-		class="content"
-		class:is-collapsed={isCollapsed}
-	>
-		{#if children}
-			{@render children()}
-		{/if}
-	</div>
-</div>
-
+<svelte:options runes />
+
+<script
+	lang="ts"
+	module
+>
+	import { generateWeakId } from '../Helpers/Helpers.svelte.js';
+</script>
+
+<script lang="ts">
+	import { loadingText } from '../Helpers/Helpers.svelte.js';
+	import { Size } from '../Types/Internal/Size.js';
+	import { Colour } from '../scss/colours.js';
+	import Action from './Action.svelte';
+	import type { CollapsibleCardProps } from './CollapsibleCardProps.js';
+
+	let {
+		title,
+		subtitle,
+		maxHeight,
+		children,
+		grow,
+		isCollapsed = $bindable(false),
+	}: CollapsibleCardProps = $props();
+
+	const contentId = `collapsible-card-${generateWeakId()}`;
+
+	const cardMaxHeight = $derived(maxHeight != null && maxHeight > 0 ? `${maxHeight}px` : undefined);
+</script>
+
+<div
+	class="collapsible-card"
+	style={cardMaxHeight != null ? `--card-max-height: ${cardMaxHeight};` : undefined}
+	class:is-collapsed={isCollapsed}
+	class:grow
+>
+	<div class="heading">
+		<div class="left">
+			<h3>{title}</h3>
+			{#if subtitle}
+				{#await subtitle}
+					<span>{loadingText}</span>
+				{:then resolvedSubtitle}
+					<span>{resolvedSubtitle}</span>
+				{/await}
+			{/if}
+		</div>
+		<div class="right">
+			<Action
+				label={isCollapsed ? 'Expand' : 'Collapse'}
+				aria-expanded={!isCollapsed}
+				aria-controls={contentId}
+				onclick={() => {
+					isCollapsed = !isCollapsed;
+				}}
+				size={Size.TripleXLarge}
+				icon={{
+					name: isCollapsed ? 'circle-plus' : 'circle-minus',
+					colour: Colour['$ui-blue-5'],
+					size: Size.Medium,
+				}}
+			/>
+		</div>
+	</div>
+
+	<div
+		id={contentId}
+		class="content"
+		class:is-collapsed={isCollapsed}
+		aria-hidden={isCollapsed}
+	>
+		{#if children}
+			{@render children()}
+		{/if}
+	</div>
+</div>
+
 <style>.collapsible-card {
-  background-color: white;
+  background-color: #ffffff;
   display: flex;
   flex-flow: column nowrap;
   flex-shrink: 1;
@@ -111,32 +119,55 @@
 }
 .collapsible-card:not(.is-collapsed) .heading {
   margin-bottom: 1rem;
-  border-bottom: solid 1px #e8e8e8;
+  border-bottom: solid 1px #dae0e5;
 }
 
 div.content {
   display: flex;
   flex-flow: column nowrap;
-  transition: max-height ease-out 0.15s 0s, opacity ease-out 0.15s 0.1s;
+}
+@media (prefers-reduced-motion: no-preference) {
+  div.content {
+    transition: max-height ease-out 0.15s 0s, opacity ease-out 0.15s 0.1s;
+  }
+}
+div.content {
   max-height: var(--card-max-height, 100%);
   overflow: auto;
   height: var(--card-max-height);
   opacity: 1;
   width: 100%;
 }
+@media (prefers-reduced-motion: no-preference) {
+  div.content.is-collapsed {
+    animation: accordion ease-out 0.15s 0s forwards;
+  }
+}
 div.content.is-collapsed {
-  animation: accordion ease-out 0.15s 0s forwards;
   max-height: 0px;
+  opacity: 0;
+  overflow: hidden;
 }
-@keyframes accordion {
-  0% {
-    opacity: 1;
-    max-height: var(--card-max-height, 90vh);
-    overflow: auto;
+@media (prefers-reduced-motion: no-preference) {
+  @keyframes accordion {
+    0% {
+      opacity: 1;
+      max-height: var(--card-max-height, 90vh);
+      overflow: auto;
+    }
+    100% {
+      opacity: 0;
+      max-height: 0px;
+      overflow: hidden;
+    }
   }
-  100% {
-    opacity: 0;
-    max-height: 0px;
-    overflow: hidden;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .heading,
+  div.content,
+  div.content.is-collapsed {
+    animation-duration: 0.001ms !important;
+    transition-duration: 0.001ms !important;
   }
-}</style>
+}</style>

package/dist/Components/CollapsibleCardProps.d.ts

@@ -1,9 +1,30 @@
 import type { Snippet } from 'svelte';
+import type { Pixels } from '../Types/Internal/Misc.js';
+/**
+ * Props for the {@link CollapsibleCard} container.
+ */
 export interface CollapsibleCardProps {
+    /** Heading text displayed in the card header. */
     title?: string;
+    /**
+     * Optional subtitle rendered beneath the heading. May be a string or
+     * a `Promise<string>` that resolves asynchronously. When passing a
+     * Promise, callers should memoise the reference so that re-renders
+     * do not re-suspend with a fresh Promise on every update.
+     */
     subtitle?: string | Promise<string>;
+    /** Snippet rendered inside the collapsible body. */
     children?: Snippet;
-    maxHeight?: number;
+    /**
+     * Maximum height of the content area in pixels. When omitted the
+     * card grows to fit its content. Branded as `Pixels` for clarity.
+     */
+    maxHeight?: Pixels;
+    /** Whether the card should flex-grow to fill its container. */
     grow?: boolean;
+    /**
+     * Whether the card is currently collapsed. Bindable so the
+     * collapsed state can be hoisted to the parent and persisted.
+     */
     isCollapsed?: boolean;
 }