@human-synthesis/norns-ui 0.0.2 → 0.0.5

package/src/components/DataTable.n

@@ -0,0 +1,61 @@
+.data-table-wrap(class!="{wrapClasses}")
+	table.data-table
+		thead
+			tr
+				+each('columns as col')
+					th(
+						class!="{col.class ?? ''}"
+						style!="{col.width ? `width: ${col.width}` : undefined}"
+					)
+						+if('col.sortable')
+							button.data-table-sort(type="button" onclick!="{() => onSort(col.key)}")
+								span {col.label ?? col.key}
+								Icon(name!="{sortIcon(col.key)}" size="size-3.5" class="text-fg-muted")
+						+if('!col.sortable')
+							| {col.label ?? col.key}
+		tbody
+			+if('rows.length === 0')
+				tr.data-table-empty
+					td(colspan!="{columns.length}")
+						| {emptyMessage}
+			+each('rows as row, i')
+				tr(onclick!="{onrowclick ? () => onrowclick(row, i) : undefined}" class!="{onrowclick ? 'data-table-row-clickable' : ''}")
+					+each('columns as col')
+						td(class!="{col.cellClass ?? ''}")
+							| {row[col.key]}
+
+<script>
+	import { cn } from '@human-synthesis/norns-ui/cn'
+	import Icon from './Icon.n'
+
+	{
+		columns = []
+		rows = []
+		striped = false
+		dense = false
+		stickyHeader = false
+		emptyMessage = 'No data'
+		sortKey = $bindable(undefined)
+		sortDir = $bindable('asc')
+		onrowclick
+		class: extra = ''
+	} .= $props()
+
+	wrapClasses := cn
+		'data-table-root'
+		striped && 'data-table-striped'
+		dense && 'data-table-dense'
+		stickyHeader && 'data-table-sticky'
+		extra
+
+	onSort := (key) =>
+		if sortKey === key
+			sortDir = sortDir === 'asc' ? 'desc' : 'asc'
+		else
+			sortKey = key
+			sortDir = 'asc'
+
+	sortIcon := (key) =>
+		return 'lucide:chevrons-up-down' unless sortKey === key
+		sortDir === 'asc' ? 'lucide:chevron-up' : 'lucide:chevron-down'
+</script>

package/src/components/DatePicker.n

@@ -0,0 +1,68 @@
+PopoverRoot(bind:open)
+	PopoverTrigger.input.date-picker-trigger(
+		type="button"
+		disabled!="{disabled}"
+		id!="{resolvedId}"
+		aria-label!="{label ?? 'Pick a date'}"
+		class!="{hasError ? 'input-err' : ''}"
+	)
+		Icon(name="lucide:calendar" size="size-4" class="text-fg-muted shrink-0")
+		span.flex-1.text-left.truncate
+			| {value ? formatted : placeholder}
+		Icon(name="lucide:chevron-down" size="size-3.5" class="text-fg-muted shrink-0")
+	PopoverPortal
+		PopoverContent.popover-content(
+			class="p-3 w-[20rem]"
+			onOpenAutoFocus!="{(e) => e.preventDefault()}"
+			onCloseAutoFocus!="{(e) => e.preventDefault()}"
+		)
+			Calendar(
+				bind:value
+				min!="{min}"
+				max!="{max}"
+				onchange!="{handleChange}"
+			)
+
+<script>
+	import { Popover } from 'bits-ui'
+	import { getContext } from 'svelte'
+	import Icon from './Icon.n'
+	import Calendar from './Calendar.n'
+
+	{
+		Root: PopoverRoot
+		Trigger: PopoverTrigger
+		Portal: PopoverPortal
+		Content: PopoverContent
+	} := Popover
+
+	{
+		value = $bindable('')
+		open = $bindable(false)
+		min = ''
+		max = ''
+		placeholder = 'Pick a date'
+		disabled = false
+		closeOnSelect = true
+		label
+		name
+		id: providedId
+		error: explicitError = false
+	} .= $props()
+
+	field := getContext 'norns-ui:field'
+	resolvedId := providedId ?? field?.id
+	hasError := explicitError || field?.hasError || false
+
+	formatter := new Intl.DateTimeFormat undefined, { dateStyle: 'medium' }
+
+	formatted := $derived.by =>
+		return '' unless value
+		try
+			formatter.format new Date(`${value}T00:00:00`)
+		catch _
+			value
+
+	handleChange := =>
+		open = false if closeOnSelect
+</script>

package/src/components/DateRangePicker.n

@@ -0,0 +1,59 @@
+PopoverRoot(bind:open)
+	PopoverTrigger.input.date-picker-trigger(type="button" disabled!="{disabled}" aria-label="Pick a date range")
+		Icon(name="lucide:calendar-range" size="size-4" class="text-fg-muted shrink-0")
+		span.flex-1.text-left.truncate
+			| {label}
+		Icon(name="lucide:chevron-down" size="size-3.5" class="text-fg-muted shrink-0")
+	PopoverPortal
+		PopoverContent.popover-content(
+			class="p-3 w-[20rem]"
+			onOpenAutoFocus!="{(e) => e.preventDefault()}"
+			onCloseAutoFocus!="{(e) => e.preventDefault()}"
+		)
+			Calendar(
+				bind:rangeValue!="{value}"
+				range!="{true}"
+				min!="{min}"
+				max!="{max}"
+			)
+			.flex.justify-end.gap-2.mt-3
+				button.btn.btn-ghost.btn-sm(type="button" onclick!="{clear}") Clear
+				button.btn.btn-primary.btn-sm(type="button" onclick!="{() => open = false}") Done
+
+<script>
+	import { Popover } from 'bits-ui'
+	import Icon from './Icon.n'
+	import Calendar from './Calendar.n'
+
+	{
+		Root: PopoverRoot
+		Trigger: PopoverTrigger
+		Portal: PopoverPortal
+		Content: PopoverContent
+	} := Popover
+
+	{
+		value = $bindable({ start: '', end: '' })
+		open = $bindable(false)
+		min = ''
+		max = ''
+		placeholder = 'Pick a range'
+		disabled = false
+	} .= $props()
+
+	formatter := new Intl.DateTimeFormat undefined, { dateStyle: 'medium' }
+
+	fmt := (s) =>
+		return '' unless s
+		try
+			formatter.format new Date(`${s}T00:00:00`)
+		catch _
+			s
+
+	label := $derived.by =>
+		return placeholder unless value?.start
+		return `${fmt(value.start)} – …` unless value?.end
+		`${fmt(value.start)} – ${fmt(value.end)}`
+
+	clear := => value = { start: '', end: '' }
+</script>

package/src/components/Dialog.n

@@ -0,0 +1,54 @@
+DialogRoot(bind:open)
+	+if('trigger')
+		DialogTrigger(class!="{triggerClass ?? undefined}")
+			| {@render trigger()}
+	DialogPortal
+		DialogOverlay(class!="{overlayClasses}")
+		DialogContent(class!="{contentClasses}")
+			+if('title')
+				DialogTitle.dialog-title
+					| {title}
+			+if('description')
+				DialogDescription.dialog-description
+					| {description}
+			+if('children')
+				.dialog-body
+					| {@render children()}
+			+if('actions')
+				.dialog-actions
+					| {@render actions()}
+			+if('!hideClose')
+				DialogClose.dialog-close(aria-label="Close")
+					| ✕
+
+<script>
+	import { Dialog } from 'bits-ui'
+	import { cn } from '@human-synthesis/norns-ui/cn'
+
+	{
+		Root: DialogRoot
+		Trigger: DialogTrigger
+		Portal: DialogPortal
+		Overlay: DialogOverlay
+		Content: DialogContent
+		Title: DialogTitle
+		Description: DialogDescription
+		Close: DialogClose
+	} := Dialog
+
+	{
+		open = $bindable(false)
+		title
+		description
+		hideClose = false
+		trigger
+		actions
+		children
+		triggerClass
+		overlayClass = ''
+		class: extra = ''
+	} .= $props()
+
+	overlayClasses := cn 'dialog-overlay', overlayClass
+	contentClasses := cn 'dialog-content', extra
+</script>

package/src/components/Drawer.n

@@ -0,0 +1,49 @@
+DialogRoot(bind:open)
+	+if('trigger')
+		DialogTrigger(class!="{triggerClass ?? undefined}")
+			| {@render trigger()}
+	DialogPortal
+		DialogOverlay.dialog-overlay
+		DialogContent(class!="{contentClasses}" data-side!="{side}")
+			+if('title')
+				DialogTitle.dialog-title
+					| {title}
+			+if('description')
+				DialogDescription.dialog-description
+					| {description}
+			+if('children')
+				.sheet-body
+					| {@render children()}
+			+if('!hideClose')
+				DialogClose.dialog-close(aria-label="Close")
+					| ✕
+
+<script>
+	import { Dialog } from 'bits-ui'
+	import { cn } from '@human-synthesis/norns-ui/cn'
+
+	{
+		Root: DialogRoot
+		Trigger: DialogTrigger
+		Portal: DialogPortal
+		Overlay: DialogOverlay
+		Content: DialogContent
+		Title: DialogTitle
+		Description: DialogDescription
+		Close: DialogClose
+	} := Dialog
+
+	{
+		open = $bindable(false)
+		side = 'left'
+		title
+		description
+		hideClose = false
+		trigger
+		children
+		triggerClass
+		class: extra = ''
+	} .= $props()
+
+	contentClasses := cn 'sheet-content', `sheet-${side}`, extra
+</script>

package/src/components/Dropdown.n

@@ -0,0 +1,41 @@
+MenuRoot(bind:open)
+	+if('trigger')
+		MenuTrigger(class!="{triggerClass ?? undefined}")
+			| {@render trigger()}
+	MenuPortal
+		MenuContent(class!="{contentClasses}" side!="{side}" align!="{align}" sideOffset!="{sideOffset}")
+			+each('items as item, i')
+				+if('item.separator')
+					MenuSeparator.dropdown-separator
+				+if('!item.separator')
+					MenuItem.dropdown-item(disabled!="{item.disabled}" onSelect!="{item.onSelect}")
+						| {item.label}
+			| {@render children?.()}
+
+<script>
+	import { DropdownMenu } from 'bits-ui'
+	import { cn } from '@human-synthesis/norns-ui/cn'
+
+	{
+		Root: MenuRoot
+		Trigger: MenuTrigger
+		Portal: MenuPortal
+		Content: MenuContent
+		Item: MenuItem
+		Separator: MenuSeparator
+	} := DropdownMenu
+
+	{
+		open = $bindable(false)
+		side = 'bottom'
+		align = 'start'
+		sideOffset = 4
+		items = []
+		trigger
+		children
+		triggerClass
+		class: extra = ''
+	} .= $props()
+
+	contentClasses := cn 'dropdown-content', extra
+</script>

package/src/components/Field.n

@@ -1,46 +1,55 @@
 .field(class!="{classes}")
 	+if('label')
-		label.field-label(for!="{ctx.id}")
+		label.field-label(for!="{resolvedId}")
 			| {label}
 			+if('required')
 				span.field-required *
 	| {@render children?.()}
-	+if('error')
-		p.field-error(role="alert" id!="{ctx.id ? `${ctx.id}-error` : undefined}")
-			| {error}
-	+if('!error && help')
-		p.field-help(id!="{ctx.id ? `${ctx.id}-help` : undefined}")
+	+if('resolvedError')
+		p.field-error(role="alert" id!="{resolvedId ? `${resolvedId}-error` : undefined}")
+			| {resolvedError}
+	+if('!resolvedError && help')
+		p.field-help(id!="{resolvedId ? `${resolvedId}-help` : undefined}")
 			| {help}
 
 <script>
 	import { cn } from '@human-synthesis/norns-ui/cn'
-	import { setContext } from 'svelte'
+	import { setContext, getContext } from 'svelte'
 
 	{
 		label
 		help
 		error
+		name
 		required = false
 		id: providedId
 		children
 		class: extra = ''
 	} := $props()
 
-	// Deterministic id derivation:
-	//   1. explicit prop wins
-	//   2. otherwise slugify the label so SSR + hydrate produce the same id
-	//   3. otherwise undefined — without a label, no <label for=> association
-	//      is needed anyway
+	// Error resolution order:
+	//   1. explicit `error` prop wins (caller has full control)
+	//   2. else look up `name` in the parent <Form>'s errors map (auto-wired)
+	//   3. else no error
+	formCtx := getContext 'norns-ui:form'
+	resolvedError := $derived error ?? (name && formCtx?.errors?.[name]) ?? undefined
+
+	// Deterministic id derivation. SSR-safe (no random fallback):
+	//   1. explicit `id` prop wins
+	//   2. else `name` (single source of truth for submission + id)
+	//   3. else slugify the label
+	//   4. else undefined — no label, no <label for=> association needed
 	slugify := (s) => s.toLowerCase().trim().replace(/[^\w]+/g, '-').replace(/^-+|-+$/g, '')
-	resolvedId := providedId ?? (label && `field-${slugify(label)}`) ?? undefined
+	resolvedId := $derived providedId ?? name ?? (label && `field-${slugify(label)}`) ?? undefined
 
-	// Shared with descendants (Input, Textarea, Select, etc.) so they pick up
-	// the id automatically and switch to error styling. $state proxy so
-	// children's reads are reactive when `error` changes.
-	ctx := $state({ id: resolvedId, hasError: !!error })
-	$effect ->
-		ctx.id = resolvedId
-		ctx.hasError = !!error
+	// Shared with descendants. Getters wrap $derived so context reads
+	// remain reactive in both SSR (synchronous) and client (post-mount)
+	// — `$effect` would only fire client-side, leaving SSR with stale
+	// initial values.
+	ctx := {
+		get id() { resolvedId }
+		get hasError() { !!resolvedError }
+	}
 	setContext 'norns-ui:field', ctx
 
 	classes := cn 'field', extra

package/src/components/Form.n

@@ -9,15 +9,37 @@ form(
 
 <script>
 	import { cn } from '@human-synthesis/norns-ui/cn'
+	import { setContext } from 'svelte'
 
 	{
 		method = 'POST'
 		action
 		enctype
 		onsubmit
+		form
 		children
 		class: extra = ''
 	} := $props()
 
+	// Errors-by-name map. Built reactively from the valibot issue list so
+	// descendant Fields can look up their own error by `name` without a
+	// per-page $derived helper.
+	//
+	// $derived (not $state + $effect) is critical for SSR — $effect runs
+	// only client-side, so an effect-based context would produce empty
+	// errors during initial server render.
+	errorsMap := $derived.by =>
+		out := {}
+		if form?.errors
+			for issue of form.errors
+				name := issue.path?.[0]?.key
+				if name && !out[name]
+					out[name] = issue.message
+		out
+
+	// Getter wraps the $derived so context consumers re-evaluate on read.
+	ctx := { get errors() { errorsMap } }
+	setContext 'norns-ui:form', ctx
+
 	classes := cn 'form', extra
 </script>

package/src/components/GradientText.n

@@ -0,0 +1,21 @@
+span(class!="{classes}" style!="{styleStr}")
+	| {@render children?.()}
+
+<script>
+	import { cn } from '@human-synthesis/norns-ui/cn'
+
+	{
+		from = 'var(--color-primary-500)'
+		to = 'var(--color-info-500)'
+		via
+		animate = true
+		angle = 90
+		children
+		class: extra = ''
+	} := $props()
+
+	classes := cn 'gradient-text', animate && 'gradient-text-anim', extra
+
+	stops := $derived via ? `${from}, ${via}, ${to}` : `${from}, ${to}`
+	styleStr := $derived `background-image: linear-gradient(${angle}deg, ${stops})`
+</script>

package/src/components/Header.n

@@ -0,0 +1,23 @@
+header(class!="{classes}")
+	.norns-header-brand
+		| {@render brand?.()}
+	+if('nav')
+		nav.norns-header-nav
+			| {@render nav()}
+	.norns-header-actions
+		| {@render actions?.()}
+
+<script>
+	import { cn } from '@human-synthesis/norns-ui/cn'
+
+	{
+		sticky = false
+		brand
+		nav
+		actions
+		class: extra = ''
+		...rest
+	} := $props()
+
+	classes := cn 'norns-header', sticky && 'norns-header-sticky', extra
+</script>

package/src/components/HeroBanner.n

@@ -0,0 +1,37 @@
+section(class!="{classes}")
+	+if('image')
+		img.hero-image(src!="{image}" alt="" loading="lazy")
+	.relative
+		h1.hero-title
+			+if('gradient')
+				GradientText
+					| {title}
+			+if('!gradient')
+				| {title}
+		+if('description')
+			p.hero-description
+				| {description}
+		+if('children')
+			.mt-4
+				| {@render children()}
+		+if('actions')
+			.hero-actions
+				| {@render actions()}
+
+<script>
+	import { cn } from '@human-synthesis/norns-ui/cn'
+	import GradientText from './GradientText.n'
+
+	{
+		title = ''
+		description
+		image
+		align = 'left'
+		gradient = false
+		actions
+		children
+		class: extra = ''
+	} := $props()
+
+	classes := cn 'hero', align === 'center' && 'hero-center', extra
+</script>

package/src/components/HierarchicalMenu.n

@@ -0,0 +1,38 @@
+nav.nav-menu(class!="{classes}" aria-label!="{label}")
+	ul.nav-menu-list
+		+each('items as item')
+			li.nav-menu-item
+				+if('item.children')
+					button.nav-menu-trigger(type="button" aria-haspopup="true" aria-expanded="false")
+						span {item.label}
+						Icon(name="lucide:chevron-down" size="size-3.5" class="ml-1 nav-menu-chevron")
+					.nav-menu-content
+						ul.flex.flex-col.gap-0.5.p-1(class="min-w-[12rem]")
+							+each('item.children as child')
+								li
+									a.nav-menu-link(href!="{child.href ?? '#'}" onclick!="{(e) => onClickItem(e, child)}")
+										+if('child.icon')
+											Icon(name!="{child.icon}" size="size-4" class="text-fg-muted shrink-0")
+										span.flex-1 {child.label}
+				+if('!item.children')
+					a.nav-menu-trigger(href!="{item.href ?? '#'}" onclick!="{(e) => onClickItem(e, item)}")
+						span {item.label}
+
+<script>
+	import { cn } from '@human-synthesis/norns-ui/cn'
+	import Icon from './Icon.n'
+
+	{
+		items = []
+		label = 'Main navigation'
+		onSelect
+		class: extra = ''
+	} := $props()
+
+	classes := cn '', extra
+
+	onClickItem := (e, item) =>
+		if onSelect
+			e.preventDefault()
+			onSelect item
+</script>

package/src/components/Icon.n

@@ -0,0 +1,16 @@
+IconifyIcon(icon!="{name}" class!="{classes}" flip!="{flip}" rotate!="{rotate}")
+
+<script>
+	import IconifyIcon from '@iconify/svelte'
+	import { cn } from '@human-synthesis/norns-ui/cn'
+
+	{
+		name
+		size = 'size-4'
+		flip
+		rotate
+		class: extra = ''
+	} := $props()
+
+	classes := cn 'inline-block shrink-0 align-[-0.125em]', size, extra
+</script>

package/src/components/Image.n

@@ -0,0 +1,31 @@
+img(
+	src!="{src}"
+	alt!="{alt}"
+	loading!="{loading}"
+	decoding="async"
+	class!="{classes}"
+	width!="{width}"
+	height!="{height}"
+)
+
+<script>
+	import { cn } from '@human-synthesis/norns-ui/cn'
+
+	{
+		src
+		alt = ''
+		loading = 'lazy'
+		fit = 'cover'
+		rounded = false
+		width
+		height
+		class: extra = ''
+	} := $props()
+
+	classes := cn
+		'block max-w-full'
+		fit && `object-${fit}`
+		rounded === true && 'rounded'
+		typeof rounded === 'string' && `rounded-${rounded}`
+		extra
+</script>

package/src/components/MegaMenu.n

@@ -0,0 +1,36 @@
+nav.nav-menu(class!="{classes}" aria-label!="{label}")
+	ul.nav-menu-list
+		+each('sections as section')
+			li.nav-menu-item
+				button.nav-menu-trigger(type="button" aria-haspopup="true" aria-expanded="false")
+					span {section.label}
+					Icon(name="lucide:chevron-down" size="size-3.5" class="ml-1 nav-menu-chevron")
+				.nav-menu-content
+					.mega-menu-grid(class!="{`grid-cols-${section.cols ?? 3}`}")
+						+each('section.columns as column')
+							.mega-menu-column
+								+if('column.title')
+									.mega-menu-title {column.title}
+								ul.flex.flex-col.gap-0.5
+									+each('column.items as item')
+										li
+											a.nav-menu-link(href!="{item.href ?? '#'}")
+												+if('item.icon')
+													Icon(name!="{item.icon}" size="size-4" class="text-fg-muted shrink-0")
+												.flex-1
+													.text-sm.font-medium {item.label}
+													+if('item.description')
+														.text-xs(class="text-fg-muted") {item.description}
+
+<script>
+	import { cn } from '@human-synthesis/norns-ui/cn'
+	import Icon from './Icon.n'
+
+	{
+		sections = []
+		label = 'Site navigation'
+		class: extra = ''
+	} := $props()
+
+	classes := cn '', extra
+</script>