noph-ui 0.44.0 → 0.45.0

package/dist/date-picker/types.d.ts

@@ -101,11 +101,11 @@ export interface TimeColumnProps extends Omit<HTMLAttributes<HTMLDivElement>, 'o
     value?: number;
     onselect?: (value: number) => void;
 }
-export interface DatePickerDialogProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onchange'>, DatePickerLocaleProps, DatePickerRangeProps, DatePickerCommonLabelProps, MonthStepperLabelProps {
+export interface DatePickerDialogProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'onchange'>, DatePickerLocaleProps, DatePickerRangeProps, DatePickerCommonLabelProps, MonthStepperLabelProps {
     value?: ISODate | null;
     displayMonth?: ISODate;
     open?: boolean;
-    element?: HTMLDivElement;
+    element?: HTMLDialogElement;
     name?: string;
     form?: string;
     title?: string;
@@ -113,6 +113,9 @@ export interface DatePickerDialogProps extends Omit<HTMLAttributes<HTMLDivElemen
     modeToggle?: boolean;
     label?: string;
     supportingText?: string;
+    issues?: {
+        message: string;
+    }[];
     selectYearLabel?: string;
     calendarModeLabel?: string;
     inputModeLabel?: string;
@@ -120,11 +123,15 @@ export interface DatePickerDialogProps extends Omit<HTMLAttributes<HTMLDivElemen
     onconfirm?: (value: ISODate | undefined) => void;
     oncancel?: () => void;
 }
-export interface DateRangePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onchange'>, DatePickerLocaleProps, DatePickerRangeProps, DatePickerCommonLabelProps {
+export interface DateRangePickerProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'onchange'>, DatePickerLocaleProps, DatePickerRangeProps, DatePickerCommonLabelProps {
     value?: DateRange;
     open?: boolean;
-    element?: HTMLDivElement;
+    element?: HTMLDialogElement;
     title?: string;
+    headline?: string;
+    name?: string;
+    endName?: string;
+    form?: string;
     startLabel?: string;
     endLabel?: string;
     onchange?: (value: DateRange) => void;

package/dist/dialog/Dialog.svelte

@@ -1,9 +1,11 @@
 <script lang="ts">
 	import Divider from '../divider/Divider.svelte'
+	import { syncOpenEffect } from '../popover.svelte.js'
 	import type { DialogProps } from './types.js'
 
 	let {
 		element = $bindable(),
+		open = $bindable(),
 		quick = false,
 		children,
 		headline,
@@ -12,82 +14,63 @@
 		actions,
 		divider,
 		ontoggle,
-		// Naming attributes belong on the element that carries role="dialog", not on the popover
-		// container the rest of the attributes are spread onto.
-		'aria-label': ariaLabel,
 		'aria-labelledby': ariaLabelledby,
 		...attributes
 	}: DialogProps = $props()
 
 	const uid = $props.id()
 
-	let dialogEl: HTMLDivElement | undefined = $state()
-	let previouslyFocused: HTMLElement | undefined
-	let inerted: HTMLElement[] = []
-
-	export const showPopover = () => {
-		element?.showPopover()
-	}
-
-	export const hidePopover = () => {
-		element?.hidePopover()
+	/*
+	 * A modal dialog can only be opened from script or from a `command` button; `<dialog open>` on
+	 * its own is the non-modal kind, with no focus trap and no backdrop.
+	 */
+	export const show = () => {
+		if (element && !element.open) element.showModal()
 	}
 
-	const trapFocus = () => {
-		if (!element) return
-		previouslyFocused = document.activeElement as HTMLElement | undefined
-		for (let node: HTMLElement | null = element; node && node !== document.body;) {
-			const parent: HTMLElement | null = node.parentElement
-			if (!parent) break
-			for (const sibling of parent.children) {
-				if (sibling === node || !(sibling instanceof HTMLElement) || sibling.inert) continue
-				sibling.inert = true
-				inerted.push(sibling)
-			}
-			node = parent
-		}
-		dialogEl?.focus()
+	export const close = () => {
+		element?.close()
 	}
 
-	const releaseFocus = () => {
-		for (const node of inerted) node.inert = false
-		inerted = []
-		previouslyFocused?.focus?.()
-		previouslyFocused = undefined
-	}
+	syncOpenEffect(
+		() => element,
+		() => open,
+		show,
+		close,
+	)
 </script>
 
-<div
+<!--
+	A `dialog`, not a popover. `showModal()` keeps everything outside inert for as long as the dialog
+	is open, including anything added to the page while it is open, and hands focus back on close.
+	`::backdrop` is the scrim and `closedby="any"` the click-outside-to-close. Where `closedby` is
+	unsupported the click handler below covers it: a click on the backdrop is reported against the
+	dialog itself.
+-->
+<dialog
 	bind:this={element}
 	{...attributes}
-	popover="auto"
+	tabindex="-1"
+	closedby="any"
+	aria-labelledby={ariaLabelledby ?? (headline ? `${uid}-dialog-headline` : undefined)}
+	aria-describedby={supportingText ? `${uid}-dialog-supporting-text` : undefined}
+	class={['np-dialog-container', !quick && 'np-animate', attributes.class]}
 	ontoggle={(event) => {
-		if (event.newState === 'open') {
-			trapFocus()
-		} else {
-			releaseFocus()
-		}
+		open = event.newState === 'open'
+		/*
+		 * Without this the browser autofocuses the first focusable descendant, one of the actions,
+		 * which can be a destructive one. Focus the dialog itself instead, so nothing is focused
+		 * that the user didn't choose to interact with.
+		 */
+		if (event.newState === 'open') element?.focus()
 		ontoggle?.(event)
 	}}
-	class={['np-dialog-container', !quick && 'np-animate', attributes.class]}
+	onclick={(event) => {
+		attributes.onclick?.(event)
+		if (event.target === element) close()
+	}}
 >
-	<div
-		role="none"
-		class="np-backdrop"
-		onclick={() => {
-			hidePopover()
-		}}
-	></div>
-	<div
-		bind:this={dialogEl}
-		class="np-dialog"
-		role="dialog"
-		tabindex="-1"
-		aria-modal="true"
-		aria-label={ariaLabel}
-		aria-labelledby={ariaLabelledby ?? (headline ? `${uid}-dialog-headline` : undefined)}
-		aria-describedby={supportingText ? `${uid}-dialog-supporting-text` : undefined}
-	>
+	<div class="np-dialog">
 		{#if icon}
 			<div class="np-dialog-icon">
 				{@render icon()}
@@ -119,19 +102,36 @@
 			</div>
 		{/if}
 	</div>
-</div>
+</dialog>
 
 <style>
 	.np-dialog-container {
 		background: transparent;
 		border: none;
+		/* Focus lands here on open only to stay off the actions, not as something to show. */
+		outline: none;
 		margin: auto;
 		padding: var(--np-dialog-inset, 2rem 1rem);
 		box-sizing: border-box;
 		min-width: var(--np-dialog-container-min-width, 19.5rem);
 		width: var(--np-dialog-container-width, 37rem);
 		max-width: 100%;
+		max-height: none;
+		overflow: visible;
+		color: var(--np-color-on-surface);
+	}
+	/* A closed dialog is `display: none` from the user agent, which the enter transition needs. */
+	.np-dialog-container:not([open]) {
+		display: none;
 	}
+	/*
+	 * The exit transition holds the dialog in the top layer after it has closed, where it would go on
+	 * taking the clicks meant for the page behind it.
+	 */
+	.np-animate:not([open]) {
+		pointer-events: none;
+	}
+
 	.np-dialog {
 		border: 0;
 		background-color: var(--np-dialog-container-color, var(--np-color-surface));
@@ -154,27 +154,36 @@
 		flex-direction: column;
 	}
 
-	.np-animate[popover] {
+	.np-dialog-container::backdrop {
+		background-color: var(--np-color-scrim);
+		opacity: 0.32;
+	}
+
+	.np-animate {
 		transition:
 			opacity var(--np-motion-expressive-slow-effects),
 			display var(--np-motion-expressive-slow-effects) allow-discrete,
 			overlay var(--np-motion-expressive-slow-effects) allow-discrete;
 		opacity: 0;
 	}
-	.np-animate[popover]:popover-open {
+	.np-animate[open] {
 		opacity: 1;
 		@starting-style {
 			opacity: 0;
 		}
 	}
-	.np-dialog-container[popover] .np-backdrop {
-		inset: 0;
-		position: fixed;
-		background-color: var(--np-color-scrim);
-		opacity: 0.32;
+	.np-animate::backdrop {
+		transition:
+			opacity var(--np-motion-expressive-slow-effects),
+			display var(--np-motion-expressive-slow-effects) allow-discrete,
+			overlay var(--np-motion-expressive-slow-effects) allow-discrete;
+		opacity: 0;
 	}
-	.np-dialog:focus-visible {
-		outline: none;
+	.np-animate[open]::backdrop {
+		opacity: 0.32;
+		@starting-style {
+			opacity: 0;
+		}
 	}
 
 	.np-dialog-icon {

package/dist/dialog/Dialog.svelte.d.ts

@@ -1,7 +1,7 @@
 import type { DialogProps } from './types.ts';
 declare const Dialog: import("svelte").Component<DialogProps, {
-    showPopover: () => void;
-    hidePopover: () => void;
-}, "element">;
+    show: () => void;
+    close: () => void;
+}, "element" | "open">;
 type Dialog = ReturnType<typeof Dialog>;
 export default Dialog;

package/dist/dialog/types.d.ts

@@ -1,11 +1,13 @@
 import type { Snippet } from 'svelte';
-import type { HTMLAttributes } from 'svelte/elements';
-export interface DialogProps extends Omit<HTMLAttributes<HTMLDivElement>, 'popover'> {
+import type { HTMLDialogAttributes } from 'svelte/elements';
+export interface DialogProps extends Omit<HTMLDialogAttributes, 'open'> {
     icon?: Snippet;
     headline?: string;
     supportingText?: string;
     divider?: boolean;
     actions?: Snippet;
     quick?: boolean;
-    element?: HTMLElement;
+    element?: HTMLDialogElement;
+    /** Bindable. Whether the dialog is showing. */
+    open?: boolean;
 }

package/dist/fab/ExtendedFab.svelte

@@ -0,0 +1,281 @@
+<script lang="ts">
+	import '../internal/focus-ring.css'
+	import { pressMorph } from '../press.svelte.js'
+	import Ripple from '../ripple/Ripple.svelte'
+	import Tooltip from '../tooltip/Tooltip.svelte'
+	import type { HTMLButtonAttributes } from 'svelte/elements'
+	import type { ExtendedFabProps } from './types.js'
+
+	let {
+		variant = 'primary-container',
+		size = 's',
+		shape = 'round',
+		lowered = false,
+		disabled = false,
+		collapsed = false,
+		icon,
+		label,
+		element = $bindable(),
+		...attributes
+	}: ExtendedFabProps = $props()
+
+	const uid = $props.id()
+
+	const isLink = $derived(attributes.href != null && !disabled)
+	// Collapsed, the text is hidden, so the label has to be announced some other way.
+	const tooltipId = $derived(collapsed && label && !disabled ? uid : undefined)
+
+	const morph = pressMorph()
+	morph.supersededBy(() => shape)
+
+	const handlePress = () => {
+		if (disabled) return
+		morph.press()
+	}
+
+	const classes = $derived([
+		'np-extended-fab',
+		'np-focus-ring',
+		`np-fab-${variant}`,
+		size,
+		shape,
+		lowered && 'np-fab-lowered',
+		collapsed && 'np-fab-collapsed',
+		morph.pressed && 'pressed',
+		attributes.class,
+	])
+</script>
+
+{#snippet content()}
+	{#if !disabled}
+		<Ripple forElement={element} />
+	{/if}
+	{#if icon}
+		<span class="np-fab-icon">{@render icon()}</span>
+	{/if}
+	{#if label}
+		<span class="np-fab-label">{label}</span>
+	{/if}
+{/snippet}
+
+{#if isLink}
+	<a
+		{...attributes}
+		onclick={(event) => {
+			handlePress()
+			attributes.onclick?.(event)
+		}}
+		bind:this={element}
+		aria-describedby={tooltipId ?? attributes['aria-describedby']}
+		interestfor={tooltipId ?? attributes['interestfor']}
+		aria-label={collapsed ? label || attributes['aria-label'] : attributes['aria-label']}
+		class={classes}
+	>
+		{@render content()}
+	</a>
+{:else}
+	<button
+		{...attributes as HTMLButtonAttributes}
+		onclick={(event) => {
+			handlePress()
+			attributes.onclick?.(event)
+		}}
+		bind:this={element}
+		aria-describedby={tooltipId ?? attributes['aria-describedby']}
+		interestfor={tooltipId ?? attributes['interestfor']}
+		aria-label={collapsed ? label || attributes['aria-label'] : attributes['aria-label']}
+		type={(attributes['type'] as HTMLButtonAttributes['type']) ?? 'button'}
+		{disabled}
+		class={classes}
+	>
+		{@render content()}
+	</button>
+{/if}
+
+{#if tooltipId}
+	<Tooltip id={tooltipId}>{label}</Tooltip>
+{/if}
+
+<style>
+	/*
+	 * `interpolate-size` lets the intrinsic width animate, so collapsing is a plain CSS
+	 * transition on `width` rather than a measured pixel value.
+	 */
+	.np-extended-fab {
+		interpolate-size: allow-keywords;
+		position: relative;
+		display: inline-flex;
+		align-items: center;
+		justify-content: flex-start;
+		box-sizing: border-box;
+		border-width: 0;
+		cursor: pointer;
+		font: inherit;
+		font-weight: 500;
+		text-decoration: none;
+		white-space: nowrap;
+		overflow: hidden;
+		-webkit-tap-highlight-color: transparent;
+		box-shadow: var(--np-fab-elevation, var(--np-elevation-3));
+		background-color: var(--np-fab-container-color, var(--_container-color));
+		color: var(--np-fab-icon-color, var(--_icon-color));
+		--np-ripple-hover-color: var(--np-fab-icon-color, var(--_icon-color));
+		--np-ripple-pressed-color: var(--np-fab-icon-color, var(--_icon-color));
+		width: auto;
+		min-width: var(--_height);
+		height: var(--_height);
+		gap: var(--_gap);
+		padding-inline: var(--_padding);
+	}
+
+	/*
+	 * `calc(var(--_height) / 2)` renders identically to `--np-shape-corner-full` (9999px) at
+	 * rest, since border-radius clamps an oversized radius down to exactly half the height
+	 * anyway. It matters for the pressed transition: animating from a huge fixed value spends
+	 * nearly the whole transition on radii that still render as fully round, so the morph never
+	 * becomes visible during a normal, brief click. `50%` isn't a substitute here, since the box
+	 * isn't square, it would resolve to an elliptical corner rather than a round pill end.
+	 */
+	.round {
+		border-radius: var(--np-fab-shape, calc(var(--_height) / 2));
+	}
+	.square {
+		border-radius: var(--np-fab-shape, var(--_square-radius));
+	}
+	/*
+	 * A press morphs the corner towards the other shape. `:active` alone drops the moment the
+	 * pointer lifts, which on a normal click is long before the morph has played, so the short
+	 * `pressed` class holds the shape until the whole round trip is visible, the way Button does
+	 * it. Both are gated on the motion preference, since without the transition below this is
+	 * only an instant snap.
+	 */
+	@media (prefers-reduced-motion: no-preference) {
+		.round:not(:disabled):is(:active, .pressed) {
+			border-radius: var(--np-fab-pressed-shape, var(--_square-radius));
+		}
+		.square:not(:disabled):is(:active, .pressed) {
+			border-radius: var(--np-fab-pressed-shape, calc(var(--_height) / 2));
+		}
+	}
+
+	/* The same three sizes as `Fab`, which is what M3 Expressive aligned the two on. */
+	.s {
+		--_height: 3.5rem;
+		--_square-radius: 1rem;
+		--_gap: 0.75rem;
+		--_padding: 1rem;
+		font-size: 1rem;
+		--np-icon-size: 1.5rem;
+	}
+	.m {
+		--_height: 5rem;
+		--_square-radius: 1.25rem;
+		--_gap: 1rem;
+		--_padding: 1.5rem;
+		font-size: 1.375rem;
+		--np-icon-size: 1.75rem;
+	}
+	.l {
+		--_height: 6rem;
+		--_square-radius: 1.75rem;
+		--_gap: 1rem;
+		--_padding: 2rem;
+		font-size: 1.5rem;
+		--np-icon-size: 2.25rem;
+	}
+
+	/* Collapsed is the icon-only FAB: square box, no text, no padding around the label. */
+	.np-fab-collapsed {
+		width: var(--_height);
+		padding-inline: 0;
+		justify-content: center;
+		gap: 0;
+	}
+	.np-fab-collapsed .np-fab-label {
+		opacity: 0;
+		max-width: 0;
+	}
+
+	.np-fab-label {
+		max-width: 20rem;
+		overflow: hidden;
+		text-overflow: ellipsis;
+	}
+
+	@media (prefers-reduced-motion: no-preference) {
+		.np-extended-fab {
+			transition:
+				width var(--np-motion-expressive-default-spatial),
+				gap var(--np-motion-expressive-default-spatial),
+				padding-inline var(--np-motion-expressive-default-spatial),
+				border-radius var(--np-motion-expressive-default-spatial),
+				box-shadow var(--np-motion-expressive-fast-effects),
+				background-color var(--np-motion-expressive-fast-effects);
+		}
+		.np-fab-label {
+			transition:
+				opacity var(--np-motion-expressive-fast-effects),
+				max-width var(--np-motion-expressive-default-spatial);
+		}
+	}
+
+	/*
+	 * M3's colour styles, named after the tokens they map to. The tone styles are the stronger
+	 * pair, the container styles the softer one. The surface style M3 Expressive dropped is gone.
+	 */
+	.np-fab-primary {
+		--_container-color: var(--np-color-primary);
+		--_icon-color: var(--np-color-on-primary);
+	}
+	.np-fab-secondary {
+		--_container-color: var(--np-color-secondary);
+		--_icon-color: var(--np-color-on-secondary);
+	}
+	.np-fab-tertiary {
+		--_container-color: var(--np-color-tertiary);
+		--_icon-color: var(--np-color-on-tertiary);
+	}
+	.np-fab-primary-container {
+		--_container-color: var(--np-color-primary-container);
+		--_icon-color: var(--np-color-on-primary-container);
+	}
+	.np-fab-secondary-container {
+		--_container-color: var(--np-color-secondary-container);
+		--_icon-color: var(--np-color-on-secondary-container);
+	}
+	.np-fab-tertiary-container {
+		--_container-color: var(--np-color-tertiary-container);
+		--_icon-color: var(--np-color-on-tertiary-container);
+	}
+
+	.np-fab-lowered {
+		box-shadow: var(--np-fab-elevation, var(--np-elevation-1));
+	}
+
+	@media (hover: hover) {
+		.np-extended-fab:not(:disabled):hover {
+			background-color: color-mix(
+				in srgb,
+				var(--np-fab-icon-color, var(--_icon-color)) 8%,
+				var(--np-fab-container-color, var(--_container-color))
+			);
+		}
+		.np-fab-lowered:not(:disabled):hover {
+			box-shadow: var(--np-fab-elevation, var(--np-elevation-2));
+		}
+	}
+
+	.np-extended-fab:disabled {
+		cursor: default;
+		box-shadow: none;
+		background-color: color-mix(in srgb, var(--np-color-on-surface) 12%, transparent);
+		color: color-mix(in srgb, var(--np-color-on-surface) 38%, transparent);
+	}
+
+	.np-fab-icon {
+		display: flex;
+		flex: none;
+		fill: currentColor;
+		pointer-events: none;
+	}
+</style>

package/dist/fab/ExtendedFab.svelte.d.ts

@@ -0,0 +1,5 @@
+import '../internal/focus-ring.css';
+import type { ExtendedFabProps } from './types.ts';
+declare const ExtendedFab: import("svelte").Component<ExtendedFabProps, {}, "element">;
+type ExtendedFab = ReturnType<typeof ExtendedFab>;
+export default ExtendedFab;