@human-kit/svelte-components 1.0.0-alpha.2 → 1.0.0-alpha.21

package/dist/table/root/table-reorder-test.svelte

@@ -0,0 +1,64 @@
+<script lang="ts">
+	import { Table } from '../index';
+
+	type DemoRow = {
+		id: string;
+		email: string;
+		group: string;
+	};
+
+	type ColumnDefinition = {
+		id: 'email' | 'group';
+		label: string;
+		isRowHeader?: boolean;
+	};
+
+	const rows: DemoRow[] = [
+		{ id: 'danilo', email: 'danilo@example.com', group: 'Developer' },
+		{ id: 'zahra', email: 'zahra@example.com', group: 'Admin' }
+	];
+
+	const baseColumns: ColumnDefinition[] = [
+		{ id: 'email', label: 'Email', isRowHeader: true },
+		{ id: 'group', label: 'Group' }
+	];
+
+	let reversed = $state(false);
+	const orderedColumns = $derived.by(() =>
+		reversed ? [baseColumns[1], baseColumns[0]] : baseColumns
+	);
+
+	function getCellContent(row: DemoRow, columnId: ColumnDefinition['id']) {
+		return row[columnId];
+	}
+</script>
+
+<Table.Root aria-label="Reorder table">
+	<Table.Header>
+		<Table.Row>
+			{#each orderedColumns as column (column.id)}
+				<Table.Column id={column.id} isRowHeader={column.isRowHeader} textValue={column.label}>
+					<Table.ColumnHeaderCell data-testid={`${column.id}-header`}>
+						{column.label}
+					</Table.ColumnHeaderCell>
+				</Table.Column>
+			{/each}
+		</Table.Row>
+	</Table.Header>
+
+	<Table.Body>
+		{#each rows as row (row.id)}
+			<Table.Row id={row.id}>
+				{#each orderedColumns as column (column.id)}
+					<Table.Cell data-testid={`${column.id}-cell-${row.id}`}>
+						{getCellContent(row, column.id)}
+					</Table.Cell>
+				{/each}
+			</Table.Row>
+		{/each}
+	</Table.Body>
+</Table.Root>
+
+<button type="button" data-testid="toggle-order" onclick={() => (reversed = !reversed)}>
+	Toggle order
+</button>

package/dist/table/root/table-reorder-test.svelte.d.ts

@@ -0,0 +1,3 @@
+declare const TableReorderTest: import("svelte").Component<Record<string, never>, {}, "">;
+type TableReorderTest = ReturnType<typeof TableReorderTest>;
+export default TableReorderTest;

package/dist/table/root/table-root.svelte

@@ -0,0 +1,561 @@
+<script module lang="ts">
+	let warnedMissingAccessibleName = false;
+
+	function warnMissingAccessibleName() {
+		if (!import.meta.env.DEV || warnedMissingAccessibleName) return;
+		warnedMissingAccessibleName = true;
+		console.warn(
+			'[Table.Root]: Provide either "aria-label" or "aria-labelledby" so the grid has an accessible name.'
+		);
+	}
+</script>
+
+<script lang="ts">
+	import { tick } from 'svelte';
+	import {
+		shouldShowFocusVisible,
+		trackInteractionModality
+	} from '../../primitives/input-modality';
+	import { visuallyHiddenStyle } from '../utils/visually-hidden-style';
+	import type { TableRootProps } from '../types.js';
+	import {
+		createTableContext,
+		setTableContext,
+		type TableColumnWidth,
+		type TableSelectionKey,
+		type TableSortDescriptor
+	} from './context';
+
+	let {
+		selectionMode = 'none',
+		selectionBehavior = 'toggle',
+		disabledBehavior = 'all',
+		disallowEmptySelection = false,
+		hiddenColumns = $bindable(),
+		defaultHiddenColumns,
+		selectedKeys = $bindable(),
+		defaultSelectedKeys,
+		sortDescriptor = $bindable(),
+		defaultSortDescriptor,
+		columnWidths = $bindable(),
+		defaultColumnWidths,
+		'aria-label': ariaLabel,
+		'aria-labelledby': ariaLabelledby,
+		disabledKeys,
+		onRowAction,
+		onSelectionChange,
+		onSortChange,
+		onColumnWidthsChange,
+		onHiddenColumnsChange,
+		onColumnResizeStart,
+		onColumnResizeEnd,
+		children,
+		class: className = '',
+		context = $bindable(),
+		element = $bindable(),
+		...restProps
+	}: TableRootProps = $props();
+
+	let tableElement = $state<HTMLTableElement | undefined>(undefined);
+	let focusWithin = $state(false);
+	let focusVisible = $state(false);
+	let pendingControlledHiddenColumns = $state<string[] | null>(null);
+	let pendingControlledSelection = $state<Set<TableSelectionKey> | null>(null);
+	let pendingControlledColumnWidths = $state<Map<string, TableColumnWidth> | null>(null);
+	let sortAnnouncement = $state('');
+	let hasObservedSortState = $state(false);
+	let hasInitializedSortSync = $state(false);
+	let hasInitializedColumnWidthsSync = $state(false);
+
+	const ctx = setTableContext(
+		createTableContext({
+			selectionMode: (() => selectionMode)(),
+			selectionBehavior: (() => selectionBehavior)(),
+			disabledBehavior: (() => disabledBehavior)(),
+			disallowEmptySelection: (() => disallowEmptySelection)(),
+			initialHiddenColumns: (() => hiddenColumns ?? defaultHiddenColumns)(),
+			initialSelectedKeys: (() => selectedKeys ?? defaultSelectedKeys)(),
+			initialSortDescriptor: (() => sortDescriptor ?? defaultSortDescriptor)(),
+			initialColumnWidths: (() => columnWidths ?? defaultColumnWidths)(),
+			disabledKeys: (() => disabledKeys)(),
+			onRowAction: (() => onRowAction)(),
+			onHiddenColumnsChange: (columnIds) => {
+				pendingControlledHiddenColumns = [...columnIds];
+				hiddenColumns = [...columnIds];
+				onHiddenColumnsChange?.([...columnIds]);
+			},
+			onSelectionChange: (keys) => {
+				pendingControlledSelection = new Set(keys);
+				selectedKeys = new Set(keys);
+				onSelectionChange?.(new Set(keys));
+			},
+			onSortChange: (descriptor) => {
+				sortDescriptor = descriptor;
+				onSortChange?.(descriptor);
+			},
+			onColumnWidthsChange: (widths) => {
+				pendingControlledColumnWidths = new Map(widths);
+				columnWidths = new Map(widths);
+				// During an active resize drag, skip the external consumer callback
+				// to avoid firing it at ~60 fps. The final widths are reported via
+				// onColumnResizeEnd. The bindable `columnWidths` is always kept in sync.
+				if (!ctx.resizingColumnId) {
+					onColumnWidthsChange?.(new Map(widths));
+				}
+			},
+			onColumnResizeStart: (columnId) => {
+				onColumnResizeStart?.(columnId);
+			},
+			onColumnResizeEnd: (widths) => {
+				onColumnWidthsChange?.(new Map(widths));
+				onColumnResizeEnd?.(new Map(widths));
+			}
+		})
+	);
+
+	function parseSelection(keys: Iterable<TableSelectionKey> | undefined) {
+		return new Set<TableSelectionKey>(keys ?? []);
+	}
+
+	function parseHiddenColumns(columnIds: Iterable<string> | undefined) {
+		return [...new Set(columnIds ?? [])];
+	}
+
+	function hasSameSelection(left: Set<TableSelectionKey>, right: Set<TableSelectionKey>) {
+		if (left.size !== right.size) return false;
+		for (const key of left) {
+			if (!right.has(key)) return false;
+		}
+		return true;
+	}
+
+	function hasSameHiddenColumns(left: string[], right: string[]) {
+		if (left.length !== right.length) return false;
+		const rightSet = new Set(right);
+		for (const columnId of left) {
+			if (!rightSet.has(columnId)) return false;
+		}
+		return true;
+	}
+
+	function hasSameColumnWidths(
+		left: Map<string, TableColumnWidth>,
+		right: Map<string, TableColumnWidth>
+	) {
+		if (left.size !== right.size) return false;
+		for (const [key, value] of left) {
+			if (right.get(key) !== value) return false;
+		}
+		return true;
+	}
+
+	const layoutVersion = ctx.layoutVersion;
+	const sortVersion = ctx.sortVersion;
+	const widthVersion = ctx.widthVersion;
+	const ariaColCount = $derived.by(() => {
+		void $layoutVersion;
+		const columnCount = ctx.getVisibleColumnCount();
+		return columnCount > 0 ? columnCount : undefined;
+	});
+	const ariaRowCount = $derived.by(() => {
+		void $layoutVersion;
+		const rowCount = ctx.getHeaderRowCount() + ctx.getLogicalBodyRowCount();
+		return rowCount > 0 ? rowCount : undefined;
+	});
+
+	const hasResizable = $derived.by(() => {
+		void $layoutVersion;
+		return ctx.hasResizableColumns();
+	});
+
+	const hasDefinedColumnWidths = $derived.by(() => {
+		void $layoutVersion;
+		for (let index = 0; index < ctx.getColumnCount(); index += 1) {
+			const column = ctx.getColumnAt(index);
+			if (!column || ctx.isColumnHidden(column.id)) continue;
+			if (column.width !== undefined || column.defaultWidth !== undefined) {
+				return true;
+			}
+		}
+		return false;
+	});
+
+	const layoutColumns = $derived.by(() => {
+		void $layoutVersion;
+		void $widthVersion;
+
+		const columns: Array<{
+			id: string;
+			width: number | undefined;
+			widthStyle: string | undefined;
+			implicitWidth: boolean;
+			minWidth: number | undefined;
+			maxWidth: number | undefined;
+		}> = [];
+
+		for (let index = 0; index < ctx.getColumnCount(); index += 1) {
+			const column = ctx.getColumnAt(index);
+			if (!column || ctx.isColumnHidden(column.id)) continue;
+
+			columns.push({
+				id: column.id,
+				width: ctx.getColumnWidth(column.id),
+				widthStyle: ctx.getColumnWidthStyle(column.id),
+				implicitWidth: !ctx.hasAuthoredColumnWidthSpec(column.id),
+				minWidth: ctx.getColumnMinWidth(column.id),
+				maxWidth: ctx.getColumnMaxWidth(column.id)
+			});
+		}
+
+		return columns;
+	});
+
+	const minimumTableWidth = $derived.by(() => {
+		if (!hasResizable && !ctx.hasRelativeVisibleColumnWidths()) return undefined;
+
+		let total = 0;
+		let hasMinimumWidth = false;
+		for (const column of layoutColumns) {
+			if (column.minWidth === undefined) continue;
+			total += column.minWidth;
+			hasMinimumWidth = true;
+		}
+
+		return hasMinimumWidth ? total : undefined;
+	});
+
+	const explicitManagedTableWidth = $derived.by(() => {
+		void $layoutVersion;
+		if (ctx.hasRelativeVisibleColumnWidths()) return undefined;
+
+		const widths = columnWidths ?? defaultColumnWidths;
+		if (!widths) return undefined;
+
+		let total = 0;
+		let hasAnyWidth = false;
+		for (const [columnId, width] of widths) {
+			if (ctx.isColumnHidden(columnId)) continue;
+			if (typeof width === 'string' && !width.trim().endsWith('px')) return undefined;
+			const numericWidth = typeof width === 'number' ? width : Number.parseFloat(width);
+			if (!Number.isFinite(numericWidth)) return undefined;
+			total += numericWidth;
+			hasAnyWidth = true;
+		}
+
+		return hasAnyWidth ? total : undefined;
+	});
+
+	const managedTableWidth = $derived.by(() => {
+		void $widthVersion;
+		void $layoutVersion;
+		const widths = ctx.getResolvedVisibleColumnWidths();
+		const columnCount = ctx.getVisibleColumnCount();
+		if (widths.size === 0 || widths.size < columnCount) return undefined;
+		if (ctx.hasRelativeVisibleColumnWidths()) return undefined;
+		let total = 0;
+		for (const w of widths.values()) total += w;
+		return total;
+	});
+
+	const relativeResolvedTableWidth = $derived.by(() => {
+		void $widthVersion;
+		void $layoutVersion;
+		if (!ctx.hasRelativeVisibleColumnWidths()) return undefined;
+
+		const widths = ctx.getResolvedVisibleColumnWidths();
+		const columnCount = ctx.getVisibleColumnCount();
+		if (widths.size === 0 || widths.size < columnCount) return undefined;
+
+		let total = 0;
+		for (const w of widths.values()) total += w;
+		return total;
+	});
+
+	const fallbackRelativeTableWidth = $derived.by(() => {
+		void $layoutVersion;
+		return ctx.hasRelativeVisibleColumnWidths() ? '100%' : undefined;
+	});
+
+	const resolvedTableWidth = $derived(
+		managedTableWidth ?? explicitManagedTableWidth ?? relativeResolvedTableWidth
+	);
+
+	context = ctx;
+
+	function formatColumnAnnouncementLabel(columnId: string) {
+		const normalized = columnId
+			.replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+			.replace(/[-_]+/g, ' ')
+			.trim();
+		if (!normalized) return 'Column';
+		return normalized.charAt(0).toUpperCase() + normalized.slice(1);
+	}
+
+	function getSortAnnouncement(descriptor: TableSortDescriptor | undefined) {
+		if (!descriptor) return 'Sorting cleared.';
+		const label =
+			ctx.getColumnTextValue(descriptor.column)?.trim() ||
+			formatColumnAnnouncementLabel(descriptor.column);
+		return `${label} sorted ${descriptor.direction}.`;
+	}
+
+	async function announceSortChange(descriptor: TableSortDescriptor | undefined) {
+		sortAnnouncement = '';
+		await tick();
+		sortAnnouncement = getSortAnnouncement(descriptor);
+	}
+
+	$effect(() => {
+		element = tableElement;
+	});
+
+	$effect(() => {
+		if (!tableElement) return;
+
+		const resizeTarget = tableElement.parentElement ?? tableElement;
+		let refreshFrame = 0;
+		const scheduleMeasuredLayoutRefresh = () => {
+			if (refreshFrame !== 0) return;
+			refreshFrame = window.requestAnimationFrame(() => {
+				refreshFrame = 0;
+				ctx.refreshMeasuredLayout();
+			});
+		};
+
+		scheduleMeasuredLayoutRefresh();
+
+		window.addEventListener('resize', scheduleMeasuredLayoutRefresh);
+		window.visualViewport?.addEventListener('resize', scheduleMeasuredLayoutRefresh);
+
+		const resizeObserver =
+			typeof ResizeObserver !== 'undefined'
+				? new ResizeObserver(() => {
+						scheduleMeasuredLayoutRefresh();
+					})
+				: null;
+
+		resizeObserver?.observe(resizeTarget);
+
+		return () => {
+			if (refreshFrame !== 0) {
+				window.cancelAnimationFrame(refreshFrame);
+			}
+			window.removeEventListener('resize', scheduleMeasuredLayoutRefresh);
+			window.visualViewport?.removeEventListener('resize', scheduleMeasuredLayoutRefresh);
+			resizeObserver?.disconnect();
+		};
+	});
+
+	$effect(() => {
+		ctx.setSelectionMode(selectionMode);
+	});
+
+	$effect(() => {
+		if (hiddenColumns !== undefined) {
+			const nextHiddenColumns = parseHiddenColumns(hiddenColumns);
+			if (
+				pendingControlledHiddenColumns &&
+				hasSameHiddenColumns(pendingControlledHiddenColumns, nextHiddenColumns)
+			) {
+				pendingControlledHiddenColumns = null;
+				return;
+			}
+			pendingControlledHiddenColumns = null;
+			ctx.setHiddenColumns(nextHiddenColumns);
+			return;
+		}
+
+		ctx.setHiddenColumns(defaultHiddenColumns);
+	});
+
+	$effect(() => {
+		ctx.setSelectionBehavior(selectionBehavior);
+	});
+
+	$effect(() => {
+		ctx.setDisabledBehavior(disabledBehavior);
+	});
+
+	$effect(() => {
+		ctx.setDisallowEmptySelection(disallowEmptySelection);
+	});
+
+	$effect(() => {
+		ctx.setDisabledKeys(disabledKeys);
+	});
+
+	$effect(() => {
+		ctx.setRowActionHandler(onRowAction);
+	});
+
+	$effect(() => {
+		if (selectedKeys !== undefined) {
+			const nextSelection = parseSelection(selectedKeys);
+			if (
+				pendingControlledSelection &&
+				hasSameSelection(pendingControlledSelection, nextSelection)
+			) {
+				pendingControlledSelection = null;
+				return;
+			}
+			pendingControlledSelection = null;
+			ctx.setSelection(nextSelection);
+		}
+	});
+
+	$effect(() => {
+		if (!hasInitializedSortSync) {
+			hasInitializedSortSync = true;
+			if (sortDescriptor === undefined) {
+				return;
+			}
+		}
+
+		ctx.setSortDescriptor(sortDescriptor);
+	});
+
+	$effect(() => {
+		if (!hasInitializedColumnWidthsSync) {
+			hasInitializedColumnWidthsSync = true;
+			if (columnWidths === undefined) {
+				return;
+			}
+		}
+
+		if (columnWidths !== undefined) {
+			const nextWidths = new Map(columnWidths);
+			if (
+				pendingControlledColumnWidths &&
+				hasSameColumnWidths(pendingControlledColumnWidths, nextWidths)
+			) {
+				pendingControlledColumnWidths = null;
+				return;
+			}
+			pendingControlledColumnWidths = null;
+			ctx.setColumnWidths(nextWidths);
+			return;
+		}
+
+		ctx.setColumnWidths(undefined);
+	});
+
+	$effect(() => {
+		void $sortVersion;
+		const descriptor = ctx.sortDescriptor;
+		if (!hasObservedSortState) {
+			hasObservedSortState = true;
+			return;
+		}
+		void announceSortChange(descriptor);
+	});
+
+	if (import.meta.env.DEV) {
+		$effect(() => {
+			if (!ariaLabel && !ariaLabelledby) {
+				warnMissingAccessibleName();
+			}
+		});
+	}
+
+	function syncFocusWithin() {
+		focusWithin =
+			!!tableElement && !!document.activeElement && tableElement.contains(document.activeElement);
+		if (!focusWithin) {
+			focusVisible = false;
+			ctx.setFocusedCell(null);
+		}
+	}
+
+	function handleFocusIn(event: FocusEvent) {
+		focusWithin = true;
+		focusVisible = shouldShowFocusVisible(event.target as HTMLElement | null);
+	}
+
+	function handleFocusOut() {
+		queueMicrotask(syncFocusWithin);
+	}
+
+	function handleMouseDown(event: MouseEvent) {
+		trackInteractionModality(event, event.target as HTMLElement | null);
+		focusVisible = false;
+	}
+
+	function handleKeyDown(event: KeyboardEvent) {
+		trackInteractionModality(event, event.target as HTMLElement | null);
+		if (focusWithin) {
+			focusVisible = true;
+		}
+	}
+</script>
+
+<table
+	bind:this={tableElement}
+	role="grid"
+	class={className}
+	style:--table-visible-column-count={ariaColCount ? `${ariaColCount}` : undefined}
+	style:table-layout={hasResizable || hasDefinedColumnWidths || resolvedTableWidth !== undefined
+		? 'fixed'
+		: undefined}
+	style:width={resolvedTableWidth !== undefined
+		? `${resolvedTableWidth}px`
+		: fallbackRelativeTableWidth}
+	style:min-width={minimumTableWidth !== undefined
+		? `${minimumTableWidth}px`
+		: resolvedTableWidth !== undefined
+			? '0'
+			: undefined}
+	aria-label={ariaLabel}
+	aria-labelledby={ariaLabelledby}
+	aria-colcount={ariaColCount}
+	aria-rowcount={ariaRowCount}
+	aria-multiselectable={selectionMode === 'multiple' ? true : undefined}
+	data-selection-mode={selectionMode}
+	data-selection-behavior={selectionBehavior}
+	data-disabled-behavior={disabledBehavior}
+	data-focus-within={focusWithin || undefined}
+	data-focus-visible={focusVisible || undefined}
+	onfocusin={handleFocusIn}
+	onfocusout={handleFocusOut}
+	onmousedown={handleMouseDown}
+	onkeydown={handleKeyDown}
+	{...restProps}
+>
+	{#if layoutColumns.length > 0}
+		<colgroup>
+			{#each layoutColumns as column (column.id)}
+				<col
+					data-table-implicit-width={column.implicitWidth ? 'true' : undefined}
+					style:width={column.widthStyle}
+					style:min-width={column.minWidth !== undefined ? `${column.minWidth}px` : undefined}
+					style:max-width={column.maxWidth !== undefined ? `${column.maxWidth}px` : undefined}
+				/>
+			{/each}
+		</colgroup>
+	{/if}
+
+	{#if children}
+		{@render children()}
+	{/if}
+</table>
+
+<span role="status" aria-live="polite" aria-atomic="true" style={visuallyHiddenStyle}
+	>{sortAnnouncement}</span
+>
+
+<span id={ctx.selectionUnavailableDescriptionId} style={visuallyHiddenStyle}
+	>Selection unavailable for this row.</span
+>
+
+<style>
+	:global(table[role='grid']:has([data-table-column-resizer='true'])) {
+		table-layout: fixed;
+		width: 100%;
+		min-width: 0;
+	}
+
+	:global(
+		table[role='grid']:has([data-table-column-resizer='true']) col[data-table-implicit-width='true']
+	) {
+		width: calc(100% / var(--table-visible-column-count, 1));
+	}
+</style>

package/dist/table/root/table-root.svelte.d.ts

@@ -0,0 +1,4 @@
+import type { TableRootProps } from '../types.js';
+declare const TableRoot: import("svelte").Component<TableRootProps, {}, "element" | "context" | "hiddenColumns" | "selectedKeys" | "sortDescriptor" | "columnWidths">;
+type TableRoot = ReturnType<typeof TableRoot>;
+export default TableRoot;

package/dist/table/root/table-ssr-wrapper-column.svelte

@@ -0,0 +1,48 @@
+<script lang="ts">
+	import { onDestroy, untrack } from 'svelte';
+	import {
+		useTableSsrWrapperRegistry,
+		type TableSsrWrapperColumn
+	} from './table-ssr-wrapper-context';
+
+	let { id, header }: TableSsrWrapperColumn = $props();
+
+	const registry = useTableSsrWrapperRegistry();
+
+	function getToken() {
+		return `ssr-column-${id}`;
+	}
+
+	let registeredToken = getToken();
+
+	function getColumn() {
+		return { id, header };
+	}
+
+	function syncRegistration() {
+		const nextToken = getToken();
+
+		if (nextToken !== registeredToken) {
+			registry.removeColumn(registeredToken);
+			registeredToken = nextToken;
+		}
+
+		registry.upsertColumn(registeredToken, getColumn());
+	}
+
+	untrack(() => {
+		syncRegistration();
+	});
+
+	$effect(() => {
+		untrack(() => {
+			syncRegistration();
+		});
+	});
+
+	onDestroy(() => {
+		registry.removeColumn(registeredToken);
+	});
+</script>
+
+<span hidden aria-hidden="true" data-ssr-wrapper-column={id}></span>

package/dist/table/root/table-ssr-wrapper-column.svelte.d.ts

@@ -0,0 +1,4 @@
+import { type TableSsrWrapperColumn } from './table-ssr-wrapper-context';
+declare const TableSsrWrapperColumn: any;
+type TableSsrWrapperColumn = ReturnType<typeof TableSsrWrapperColumn>;
+export default TableSsrWrapperColumn;

package/dist/table/root/table-ssr-wrapper-context.d.ts

@@ -0,0 +1,11 @@
+export type TableSsrWrapperColumn = {
+    id: string;
+    header: string;
+};
+type TableSsrWrapperRegistry = {
+    upsertColumn: (token: string, column: TableSsrWrapperColumn) => void;
+    removeColumn: (token: string) => void;
+};
+export declare function setTableSsrWrapperRegistry(registry: TableSsrWrapperRegistry): TableSsrWrapperRegistry;
+export declare function useTableSsrWrapperRegistry(): TableSsrWrapperRegistry;
+export {};