@heyramzi/ui 6.1.0 → 8.0.0

package/src/shadcn/accordion/accordion-trigger.svelte

@@ -2,15 +2,20 @@
 	import { CaretDown } from "phosphor-svelte";
 	import { Accordion as AccordionPrimitive } from "bits-ui";
 	import { cn, type WithoutChild } from "@heyramzi/utils";
+	import type { Snippet } from "svelte";
 
 	let {
 		ref = $bindable(null),
 		class: className,
 		level = 3,
+		indicator,
 		children,
 		...restProps
 	}: WithoutChild<AccordionPrimitive.TriggerProps> & {
 		level?: AccordionPrimitive.HeaderProps["level"];
+		/** Replaces the caret, e.g. a plus that turns into a minus. Style it off
+		 * `group-aria-expanded/accordion-trigger:`. */
+		indicator?: Snippet;
 	} = $props();
 </script>
 
@@ -25,11 +30,15 @@
 		{...restProps}
 	>
 		{@render children?.()}
-		<!-- One caret that turns over, not two that swap. A transform and not a
-		     `d:` path morph, which is Chromium-only. -->
-		<CaretDown
-			data-slot="accordion-trigger-icon"
-			class="cn-accordion-trigger-icon pointer-events-none shrink-0 transition-transform duration-[var(--duration-fast)] ease-[var(--ease-smooth-out)] group-aria-expanded/accordion-trigger:rotate-180 motion-reduce:transition-none"
-		/>
+		{#if indicator}
+			{@render indicator()}
+		{:else}
+			<!-- One caret that turns over, not two that swap. A transform and not a
+			     `d:` path morph, which is Chromium-only. -->
+			<CaretDown
+				data-slot="accordion-trigger-icon"
+				class="cn-accordion-trigger-icon pointer-events-none shrink-0 transition-transform duration-[var(--duration-fast)] ease-[var(--ease-smooth-out)] group-aria-expanded/accordion-trigger:rotate-180 motion-reduce:transition-none"
+			/>
+		{/if}
 	</AccordionPrimitive.Trigger>
 </AccordionPrimitive.Header>

package/src/shadcn/alert/alert.svelte

@@ -26,6 +26,8 @@
 		ref = $bindable(null),
 		class: className,
 		variant = "default",
+		// A caller whose message isn't urgent passes `status`, so a screen reader doesn't interrupt.
+		role = "alert",
 		children,
 		...restProps
 	}: WithElementRef<HTMLAttributes<HTMLDivElement>> & {
@@ -38,7 +40,7 @@
 	data-slot="alert"
 	class={cn(alertVariants({ variant }), className)}
 	{...restProps}
-	role="alert"
+	{role}
 >
 	{@render children?.()}
 </div>

package/src/shadcn/badge/badge.svelte

@@ -4,16 +4,13 @@
 	export const badgeVariants = tv({
 		base: "h-5 gap-1 rounded-full border border-transparent px-2 py-0.5 text-xs font-medium has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&>svg]:size-3! focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive group/badge inline-flex w-fit shrink-0 items-center justify-center overflow-hidden whitespace-nowrap transition-[background-color,border-color,color,box-shadow] focus-visible:ring-[3px] [&>svg]:pointer-events-none",
 		variants: {
-			// Three weights a label can carry: filled, tinted, outlined. Severity is
-			// `StatusBadge` reading `TONE_CLASS`, not a badge colour. `destructive`,
-			// `warning`, `ghost` and `link` went on 4 Sep 2026.
+			// Three weights a label can carry: filled, tinted, outlined. Severity is the
+			// `tone` prop, which reads `TONE_CLASS`, not a variant.
 			variant: {
 				default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
 				secondary: "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
 				outline: "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
-				// Kept when the three weights landed: severity is `StatusBadge` reading its tone, but a consumer outside this workspace still needs one badge that says "this is wrong" without a status
-
-				// scale behind it.
+				// For a consumer that wants one "this is wrong" badge without a tone prop.
 				destructive: "bg-destructive/10 text-destructive [a]:hover:bg-destructive/20",
 			},
 		},
@@ -28,16 +25,20 @@
 <script lang="ts">
 	import type { HTMLAnchorAttributes } from "svelte/elements";
 	import { cn, type WithElementRef } from "@heyramzi/utils";
+	import { TONE_CLASS, type Tone } from "../../lib/tone.js";
 
 	let {
 		ref = $bindable(null),
 		href,
 		class: className,
 		variant = "default",
+		tone,
 		children,
 		...restProps
 	}: WithElementRef<HTMLAnchorAttributes> & {
 		variant?: BadgeVariant;
+		/** The severity scale. Draws an outlined chip in the tone's colours and ignores `variant`. */
+		tone?: Tone;
 	} = $props();
 </script>
 
@@ -46,7 +47,7 @@
 	bind:this={ref}
 	data-slot="badge"
 	{href}
-	class={cn(badgeVariants({ variant }), className)}
+	class={cn(badgeVariants({ variant: tone ? "outline" : variant }), tone && TONE_CLASS[tone], className)}
 	{...restProps}
 >
 	{@render children?.()}

package/src/shadcn/breadcrumb/breadcrumb-ellipsis.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-	import EllipsisIcon from "@lucide/svelte/icons/ellipsis";
+	import { DotsThree } from "phosphor-svelte";
 	import type { HTMLAttributes } from "svelte/elements";
 	import { cn, type WithElementRef, type WithoutChildren } from "@heyramzi/utils";
 
@@ -18,6 +18,6 @@
 	class={cn("flex size-9 items-center justify-center", className)}
 	{...restProps}
 >
-	<EllipsisIcon class="size-4" />
+	<DotsThree class="size-4" />
 	<span class="sr-only">More</span>
 </span>

package/src/shadcn/breadcrumb/breadcrumb-separator.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-	import ChevronRightIcon from "@lucide/svelte/icons/chevron-right";
+	import { CaretRight } from "phosphor-svelte";
 	import { cn, type WithElementRef } from "@heyramzi/utils";
 	import type { HTMLLiAttributes } from "svelte/elements";
 
@@ -22,6 +22,6 @@
 	{#if children}
 		{@render children?.()}
 	{:else}
-		<ChevronRightIcon />
+		<CaretRight />
 	{/if}
 </li>

package/src/shadcn/calendar/calendar-month-select.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">
 	import { Calendar as CalendarPrimitive } from "bits-ui";
 	import { cn, type WithoutChildrenOrChild } from "@heyramzi/utils";
-	import ChevronDownIcon from "@lucide/svelte/icons/chevron-down";
+	import { CaretDown } from "phosphor-svelte";
 
 	let {
 		ref = $bindable(null),
@@ -37,7 +37,7 @@
 				aria-hidden="true"
 			>
 				{monthItems.find((item) => item.value === value)?.label || selectedMonthItem.label}
-				<ChevronDownIcon class="size-4" />
+				<CaretDown class="size-4" />
 			</span>
 		{/snippet}
 	</CalendarPrimitive.MonthSelect>

package/src/shadcn/calendar/calendar-next-button.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
 	import { Calendar as CalendarPrimitive } from "bits-ui";
-	import ChevronRightIcon from "@lucide/svelte/icons/chevron-right";
+	import { CaretRight } from "phosphor-svelte";
 	import { buttonVariants, type ButtonVariant } from "../button/index.js";
 	import { cn } from "@heyramzi/utils";
 
@@ -16,7 +16,7 @@
 </script>
 
 {#snippet Fallback()}
-	<ChevronRightIcon class="size-4" />
+	<CaretRight class="size-4" />
 {/snippet}
 
 <CalendarPrimitive.NextButton

package/src/shadcn/calendar/calendar-prev-button.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
 	import { Calendar as CalendarPrimitive } from "bits-ui";
-	import ChevronLeftIcon from "@lucide/svelte/icons/chevron-left";
+	import { CaretLeft } from "phosphor-svelte";
 	import { buttonVariants, type ButtonVariant } from "../button/index.js";
 	import { cn } from "@heyramzi/utils";
 
@@ -16,7 +16,7 @@
 </script>
 
 {#snippet Fallback()}
-	<ChevronLeftIcon class="size-4" />
+	<CaretLeft class="size-4" />
 {/snippet}
 
 <CalendarPrimitive.PrevButton

package/src/shadcn/calendar/calendar-year-select.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">
 	import { Calendar as CalendarPrimitive } from "bits-ui";
 	import { cn, type WithoutChildrenOrChild } from "@heyramzi/utils";
-	import ChevronDownIcon from "@lucide/svelte/icons/chevron-down";
+	import { CaretDown } from "phosphor-svelte";
 
 	let {
 		ref = $bindable(null),
@@ -36,7 +36,7 @@
 				aria-hidden="true"
 			>
 				{yearItems.find((item) => item.value === value)?.label || selectedYearItem.label}
-				<ChevronDownIcon class="size-4" />
+				<CaretDown class="size-4" />
 			</span>
 		{/snippet}
 	</CalendarPrimitive.YearSelect>

package/src/shadcn/calendar/calendar.svelte

@@ -24,6 +24,10 @@
 		yearFormat = "numeric",
 		day,
 		disableDaysOutsideMonth = false,
+		// Monday first and six rows always: a five-week month would otherwise resize
+		// the popover as the reader pages through the year.
+		weekStartsOn = 1,
+		fixedWeeks = true,
 		...restProps
 	}: WithoutChildrenOrChild<CalendarPrimitive.RootProps> & {
 		buttonVariant?: ButtonVariant;
@@ -52,6 +56,8 @@ get along, so we shut typescript up by casting `value` to `never`.
 	bind:placeholder
 	{weekdayFormat}
 	{disableDaysOutsideMonth}
+	{weekStartsOn}
+	{fixedWeeks}
 	class={cn(
 		"bg-background group/calendar p-3 [--cell-size:--spacing(8)] [[data-slot=card-content]_&]:bg-transparent [[data-slot=popover-content]_&]:bg-transparent",
 		className,

package/src/shadcn/code-block/code-block-actions.svelte

@@ -0,0 +1,23 @@
+<script lang="ts">
+	import { cn, type WithElementRef } from "@heyramzi/utils";
+	import type { HTMLAttributes } from "svelte/elements";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		children,
+		...restProps
+	}: WithElementRef<HTMLAttributes<HTMLDivElement>> = $props();
+</script>
+
+<div
+	bind:this={ref}
+	data-slot="code-block-actions"
+	class={cn(
+		"-my-1 -me-1.5 gap-1 [[data-slot=code-block]>&]:m-0 [[data-slot=code-block]>&]:top-3 [[data-slot=code-block]>&]:end-3 group-data-[size=sm]/code-block:[[data-slot=code-block]>&]:top-2 group-data-[size=sm]/code-block:[[data-slot=code-block]>&]:end-2 [[data-slot=code-block]>&]:*:[button]:bg-background [[data-slot=code-block]>&]:*:[button]:ring-1 [[data-slot=code-block]>&]:*:[button]:ring-foreground/10 ms-auto flex shrink-0 items-center [[data-slot=code-block]>&]:absolute [[data-slot=code-block]>&]:z-10 [[data-slot=code-block]>&]:opacity-0 [[data-slot=code-block]>&]:transition-opacity [[data-slot=code-block]>&]:group-focus-within/code-block:opacity-100 [[data-slot=code-block]>&]:group-hover/code-block:opacity-100 [[data-slot=code-block]>&]:pointer-coarse:opacity-100",
+		className
+	)}
+	{...restProps}
+>
+	{@render children?.()}
+</div>

package/src/shadcn/code-block/code-block-content.svelte

@@ -0,0 +1,55 @@
+<script lang="ts">
+	import { cn, type WithElementRef } from "@heyramzi/utils";
+	import CodeBlockLine from "./code-block-line.svelte";
+	import type { HTMLAttributes } from "svelte/elements";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		style,
+		code,
+		wrap = false,
+		lineNumbers = false,
+		startLine = 1,
+		children,
+		...restProps
+	}: WithElementRef<HTMLAttributes<HTMLPreElement>> & {
+		/** Plain text to render. Split into lines when `lineNumbers` is set. */
+		code?: string;
+		wrap?: boolean;
+		lineNumbers?: boolean;
+		startLine?: number;
+	} = $props();
+
+	// A `code` string is split into lines so each one can be numbered.
+	const lines = $derived(
+		code !== undefined && lineNumbers ? code.replace(/\n$/, "").split("\n") : null
+	);
+</script>
+
+{#snippet content()}
+	<code
+		data-slot="code-block-code"class=" grid min-h-lh min-w-max content-start in-data-numbered:grid-cols-[auto_1fr] in-data-wrap:min-w-0">
+		{#if lines}
+			{#each lines as line, index (index)}
+				<CodeBlockLine code={line} />
+			{/each}
+		{:else if code !== undefined}
+			{code}
+		{:else}
+			{@render children?.()}
+		{/if}
+	</code>
+{/snippet}
+
+<!-- Whitespace inside a <pre> is rendered, so its content is a snippet defined outside it, where Svelte trims whitespace as usual. -->
+<!-- svelte-ignore a11y_no_noninteractive_tabindex -->
+<pre
+	bind:this={ref}
+	data-slot="code-block-content"data-wrap={wrap || undefined}
+	data-numbered={lineNumbers || undefined}
+	dir="ltr"tabindex={0}
+	style="counter-reset: line {startLine - 1};{style ?? ''}"class={cn("px-4 py-4 leading-relaxed group-has-data-[slot=code-block-header]/code-block:pt-2 group-has-data-[slot=code-block-footer]/code-block:pb-2 group-data-[size=sm]/code-block:px-3 group-data-[size=sm]/code-block:py-3 group-data-[size=sm]/code-block:group-has-data-[slot=code-block-header]/code-block:pt-1.5 min-h-0 min-w-0 scroll-fade-x scrollbar-thin overflow-auto text-start font-mono outline-none data-wrap:scroll-fade-y data-wrap:wrap-break-word data-wrap:whitespace-pre-wrap",
+		className
+	)}
+	{...restProps}>{@render content()}</pre>

package/src/shadcn/code-block/code-block-copy-button.svelte

@@ -0,0 +1,10 @@
+<script lang="ts">
+	import type { ComponentProps } from "svelte";
+	import CopyButton from "../../components/copy/copy-button.svelte";
+
+	// WHY this wraps the shared control: the code block's own copy button drew a
+	// second icon swap and a second clipboard write. `md` is the 28px icon Button.
+	let { size = "md", ...restProps }: ComponentProps<typeof CopyButton> = $props();
+</script>
+
+<CopyButton data-slot="code-block-copy-button" {size} {...restProps} />

package/src/shadcn/code-block/code-block-footer.svelte

@@ -0,0 +1,20 @@
+<script lang="ts">
+	import { cn, type WithElementRef } from "@heyramzi/utils";
+	import type { HTMLAttributes } from "svelte/elements";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		children,
+		...restProps
+	}: WithElementRef<HTMLAttributes<HTMLDivElement>> = $props();
+</script>
+
+<div
+	bind:this={ref}
+	data-slot="code-block-footer"
+	class={cn("gap-2 px-4 pb-4 text-muted-foreground group-data-[size=sm]/code-block:px-3 group-data-[size=sm]/code-block:pb-3 flex min-w-0 shrink-0 items-center", className)}
+	{...restProps}
+>
+	{@render children?.()}
+</div>

package/src/shadcn/code-block/code-block-header.svelte

@@ -0,0 +1,23 @@
+<script lang="ts">
+	import { cn, type WithElementRef } from "@heyramzi/utils";
+	import type { HTMLAttributes } from "svelte/elements";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		children,
+		...restProps
+	}: WithElementRef<HTMLAttributes<HTMLDivElement>> = $props();
+</script>
+
+<div
+	bind:this={ref}
+	data-slot="code-block-header"
+	class={cn(
+		"gap-2 px-4 pt-4 text-muted-foreground group-data-[variant=destructive]/code-block:text-destructive group-data-[size=sm]/code-block:px-3 group-data-[size=sm]/code-block:pt-3 flex min-w-0 shrink-0 items-center *:has-[>[data-slot=code-block-title]]:min-w-0",
+		className
+	)}
+	{...restProps}
+>
+	{@render children?.()}
+</div>

package/src/shadcn/code-block/code-block-line.svelte

@@ -0,0 +1,71 @@
+<script lang="ts" module>
+	import { tv, type VariantProps } from "tailwind-variants";
+
+	export const codeBlockLineVariants = tv({
+		base: "-mx-4 px-4 in-data-numbered:gap-x-3 before:min-w-6 before:text-end before:text-muted-foreground after:start-1 after:text-muted-foreground group-data-[size=sm]/code-block:-mx-3 group-data-[size=sm]/code-block:px-3 relative block min-h-lh after:absolute after:top-0 after:select-none in-data-numbered:col-span-2 in-data-numbered:grid in-data-numbered:grid-cols-subgrid in-data-numbered:[counter-increment:line] in-data-numbered:before:content-[counter(line)] in-data-numbered:before:select-none in-data-numbered:supports-[content:counter(line)_/_'']:before:content-[counter(line)_/_'']",
+		variants: {
+			variant: {
+				default: "",
+				added: "bg-muted after:content-['+']",
+				removed: "bg-destructive/10 after:text-destructive after:content-['−']",
+				highlighted: "bg-muted",
+			},
+		},
+		defaultVariants: {
+			variant: "default",
+		},
+	});
+
+	export type CodeBlockLineVariant = VariantProps<typeof codeBlockLineVariants>["variant"];
+
+	// One highlighted token, such as one returned by `useHighlightedCode`.
+	export type CodeBlockLineToken = {
+		content: string;
+		style?: string;
+		class?: string;
+	};
+</script>
+
+<script lang="ts">
+	import { cn, type WithElementRef } from "@heyramzi/utils";
+	import type { HTMLAttributes } from "svelte/elements";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		variant = "default",
+		code,
+		children,
+		...restProps
+	}: WithElementRef<HTMLAttributes<HTMLSpanElement>> & {
+		variant?: CodeBlockLineVariant;
+		/** The line as plain text, or as highlighted tokens. When it is set, `children` is ignored. */
+		code?: string | CodeBlockLineToken[];
+	} = $props();
+
+	const newline = "\n";
+</script>
+
+<!-- An empty line holds a newline so copying a selection keeps blank lines. -->
+<span
+	bind:this={ref}
+	data-slot="code-block-line"data-variant={variant}
+	class={cn(codeBlockLineVariants({ variant }), className)}
+	{...restProps}
+>
+	<span data-slot="code-block-line-content"class="min-w-0">
+		{#if typeof code ==="string"}
+			{code || newline}
+		{:else if code?.length}
+			{#each code as token, index (index)}
+				<span style={token.style} class={token.class}>{token.content}</span>
+			{/each}
+		{:else if code}
+			{newline}
+		{:else if children}
+			{@render children()}
+		{:else}
+			{newline}
+		{/if}
+	</span>
+</span>

package/src/shadcn/code-block/code-block-title.svelte

@@ -0,0 +1,23 @@
+<script lang="ts">
+	import { cn, type WithElementRef } from "@heyramzi/utils";
+	import type { HTMLAttributes } from "svelte/elements";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		children,
+		...restProps
+	}: WithElementRef<HTMLAttributes<HTMLDivElement>> = $props();
+</script>
+
+<div
+	bind:this={ref}
+	data-slot="code-block-title"
+	class={cn(
+		"font-sans text-sm font-medium text-foreground group-data-[variant=destructive]/code-block:text-destructive *:[svg]:me-1.5 [&_svg:not([class*='size-'])]:size-4 group-data-[size=sm]/code-block:text-xs group-data-[size=sm]/code-block:[&_svg:not([class*='size-'])]:size-3.5 min-w-0 truncate [&_svg]:pointer-events-none [&_svg]:inline-block [&_svg]:align-middle",
+		className
+	)}
+	{...restProps}
+>
+	{@render children?.()}
+</div>

package/src/shadcn/code-block/code-block.svelte

@@ -0,0 +1,47 @@
+<script lang="ts" module>
+	import { tv, type VariantProps } from "tailwind-variants";
+
+	export const codeBlockVariants = tv({
+		base: "rounded-lg text-sm data-[size=sm]:text-xs has-[>[data-slot=code-block-content]:focus-visible]:ring-3 has-[>[data-slot=code-block-content]:focus-visible]:ring-ring/50 group/code-block relative flex w-full min-w-0 flex-col overflow-hidden",
+		variants: {
+			variant: {
+				default: "border border-input text-foreground dark:bg-input/30 has-[>[data-slot=code-block-content]:focus-visible]:border-ring",
+				destructive: "border border-destructive/30 text-destructive dark:border-destructive/40",
+			},
+		},
+		defaultVariants: {
+			variant: "default",
+		},
+	});
+
+	export type CodeBlockVariant = VariantProps<typeof codeBlockVariants>["variant"];
+	export type CodeBlockSize = "default" | "sm";
+</script>
+
+<script lang="ts">
+	import { cn, type WithElementRef } from "@heyramzi/utils";
+	import type { HTMLAttributes } from "svelte/elements";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		variant = "default",
+		size = "default",
+		children,
+		...restProps
+	}: WithElementRef<HTMLAttributes<HTMLDivElement>> & {
+		variant?: CodeBlockVariant;
+		size?: CodeBlockSize;
+	} = $props();
+</script>
+
+<div
+	bind:this={ref}
+	data-slot="code-block"
+	data-variant={variant}
+	data-size={size}
+	class={cn(codeBlockVariants({ variant }), className)}
+	{...restProps}
+>
+	{@render children?.()}
+</div>

package/src/shadcn/code-block/index.ts

@@ -0,0 +1,42 @@
+import Actions from "./code-block-actions.svelte";
+import Content from "./code-block-content.svelte";
+import CopyButton from "./code-block-copy-button.svelte";
+import Footer from "./code-block-footer.svelte";
+import Header from "./code-block-header.svelte";
+import Title from "./code-block-title.svelte";
+import Line, {
+  codeBlockLineVariants,
+  type CodeBlockLineToken,
+  type CodeBlockLineVariant,
+} from "./code-block-line.svelte";
+import Root, {
+  codeBlockVariants,
+  type CodeBlockSize,
+  type CodeBlockVariant,
+} from "./code-block.svelte";
+
+export {
+  Root,
+  Header,
+  Title,
+  Actions,
+  CopyButton,
+  Content,
+  Line,
+  Footer,
+  codeBlockVariants,
+  codeBlockLineVariants,
+  type CodeBlockVariant,
+  type CodeBlockSize,
+  type CodeBlockLineVariant,
+  type CodeBlockLineToken,
+  //
+  Root as CodeBlock,
+  Header as CodeBlockHeader,
+  Title as CodeBlockTitle,
+  Actions as CodeBlockActions,
+  CopyButton as CodeBlockCopyButton,
+  Content as CodeBlockContent,
+  Line as CodeBlockLine,
+  Footer as CodeBlockFooter,
+};

package/src/shadcn/command/index.ts

@@ -1,3 +1,4 @@
+import { computeCommandScore } from "bits-ui";
 import Root from "./command.svelte";
 import Loading from "./command-loading.svelte";
 import Dialog from "./command-dialog.svelte";
@@ -10,7 +11,9 @@ import Separator from "./command-separator.svelte";
 import Shortcut from "./command-shortcut.svelte";
 import LinkItem from "./command-link-item.svelte";
 
+// The scorer Command uses by default, for a custom `filter` that wants to rank its own words.
 export {
+  computeCommandScore,
   Root,
   Dialog,
   Empty,

package/src/shadcn/field/index.ts

@@ -8,6 +8,7 @@ import Title from "./field-title.svelte";
 import Description from "./field-description.svelte";
 import Separator from "./field-separator.svelte";
 import Error from "./field-error.svelte";
+import Simple from "./simple-field.svelte";
 
 export {
   Field,
@@ -20,6 +21,7 @@ export {
   Description,
   Separator,
   Error,
+  Simple,
   //
   Set as FieldSet,
   Legend as FieldLegend,
@@ -30,4 +32,5 @@ export {
   Description as FieldDescription,
   Separator as FieldSeparator,
   Error as FieldError,
+  Simple as SimpleField,
 };

package/src/shadcn/field/simple-field.svelte

@@ -0,0 +1,71 @@
+<script lang="ts">
+	import { cn } from "@heyramzi/utils";
+	import type { Snippet } from "svelte";
+	import type { Attachment } from "svelte/attachments";
+	import Field from "./field.svelte";
+	import FieldLabel from "./field-label.svelte";
+	import FieldDescription from "./field-description.svelte";
+	import FieldError from "./field-error.svelte";
+
+	interface Props {
+		label?: string;
+		description?: string;
+		error?: string;
+		/** Id of the control the label binds to. Also picks the control that gets the message link. */
+		for?: string;
+		/** "default" is text-sm foreground; "muted" is a text-xs micro-label. */
+		labelVariant?: "default" | "muted";
+		class?: string;
+		children: Snippet;
+	}
+
+	let {
+		label,
+		description,
+		error,
+		for: htmlFor,
+		labelVariant = "default",
+		class: className,
+		children,
+	}: Props = $props();
+
+	const uid = $props.id();
+	const messageId = `${uid}-message`;
+	let message = $derived(error ?? description);
+
+	// WHY an attachment: the control is the caller's snippet, so the wrapper can't
+	// set its props. Wiring the DOM here means no call site can forget the link.
+	const CONTROL = "input, textarea, select, [role=combobox], [role=switch], [role=checkbox]";
+	const link: Attachment<HTMLElement> = (node) => {
+		if (!message) return;
+		const control =
+			(htmlFor ? node.querySelector<HTMLElement>(`[id="${CSS.escape(htmlFor)}"]`) : null) ??
+			node.querySelector<HTMLElement>(CONTROL);
+		if (!control) return;
+		const before = control.getAttribute("aria-describedby");
+		control.setAttribute("aria-describedby", [before, messageId].filter(Boolean).join(" "));
+		if (error) control.setAttribute("aria-invalid", "true");
+		return () => {
+			if (before === null) control.removeAttribute("aria-describedby");
+			else control.setAttribute("aria-describedby", before);
+			if (error) control.removeAttribute("aria-invalid");
+		};
+	};
+</script>
+
+<Field class={cn("gap-2", className)} data-invalid={error ? "true" : undefined} {@attach link}>
+	{#if label}
+		<FieldLabel
+			for={htmlFor}
+			class={labelVariant === "muted" ? "text-muted-foreground text-xs" : undefined}
+		>
+			{label}
+		</FieldLabel>
+	{/if}
+	{@render children()}
+	{#if error}
+		<FieldError id={messageId} class="text-xs">{error}</FieldError>
+	{:else if description}
+		<FieldDescription id={messageId} class="text-xs">{description}</FieldDescription>
+	{/if}
+</Field>