@spaethtech/svelte-ui 0.20.1-dev.102.3c5719c → 0.20.1-dev.105.894ecae

package/dist/components/Pagination/Pagination.svelte.d.ts

@@ -1,3 +1,4 @@
+import type { HTMLAttributes } from "svelte/elements";
 import type { Variant } from "../../types/variants.js";
 import type { Size } from "../../types/sizes.js";
 import { type Responsive } from "../../types/responsive.js";
@@ -19,7 +20,7 @@ type $$ComponentProps = {
     borderless?: boolean;
     disabled?: boolean;
     class?: string;
-};
+} & Omit<HTMLAttributes<HTMLElement>, "class" | "style">;
 declare const Pagination: import("svelte").Component<$$ComponentProps, {}, "perPage" | "page">;
 type Pagination = ReturnType<typeof Pagination>;
 export default Pagination;

package/dist/components/Popup.svelte

@@ -17,6 +17,7 @@
 -->
 <script lang="ts">
   import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
   import {
     anchored,
     type Side,
@@ -46,6 +47,7 @@
     onclose,
     onplaced,
     children,
+    ...rest
   }: {
     /** The trigger element to position against. */
     anchor: HTMLElement | undefined;
@@ -80,7 +82,11 @@
      *  the box actually landed (e.g. edge-flush borders). */
     onplaced?: (p: Placement) => void;
     children: Snippet;
-  } = $props();
+    // Leftover HTML attributes are forwarded onto the popover box (the top-layer positioner `<div>`,
+    // which is this component's primary content container). `style` omitted — the box computes its own
+    // (the panel border when `surface`). `onclose` omitted — it collides with the DOM `onclose` event
+    // but is this component's own dismissal callback (`() => void`).
+  } & Omit<HTMLAttributes<HTMLDivElement>, "class" | "style" | "onclose"> = $props();
 
   // Themed-panel styling (only used when `surface`). Border tints from the variant token; `borderless`
   // paints it the panel's background. Padding scales with `size`.
@@ -137,6 +143,7 @@
 </script>
 
 <div
+  {...rest}
   bind:this={el}
   popover="manual"
   data-open={open}

package/dist/components/Popup.svelte.d.ts

@@ -1,4 +1,5 @@
 import type { Snippet } from "svelte";
+import type { HTMLAttributes } from "svelte/elements";
 import { type Side, type Align, type Boundary, type Placement } from "../positioning/anchored.js";
 import type { Size } from "../types/sizes.js";
 import { type Responsive } from "../types/responsive.js";
@@ -37,7 +38,7 @@ type $$ComponentProps = {
      *  the box actually landed (e.g. edge-flush borders). */
     onplaced?: (p: Placement) => void;
     children: Snippet;
-};
+} & Omit<HTMLAttributes<HTMLDivElement>, "class" | "style" | "onclose">;
 declare const Popup: import("svelte").Component<$$ComponentProps, {}, "open">;
 type Popup = ReturnType<typeof Popup>;
 export default Popup;

package/dist/components/Query.svelte

@@ -10,6 +10,7 @@
   import { uiI18n } from "../i18n.js";
   const i18n = uiI18n();
   import { tick } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
   import IconSearch from "~icons/mdi/magnify";
   import IconClose from "~icons/mdi/close";
   import IconHelp from "~icons/mdi/help-circle-outline";
@@ -28,6 +29,7 @@
     size = "md",
     variant = "neutral",
     borderless = false,
+    ...rest
   }: {
     dataset: DataSet;
     placeholder?: string;
@@ -35,7 +37,7 @@
     size?: Responsive<Size>;
     variant?: Variant;
     borderless?: boolean;
-  } = $props();
+  } & Omit<HTMLAttributes<HTMLDivElement>, "class"> = $props();
 
   let inputEl = $state<HTMLInputElement>();
   let wrapperEl = $state<HTMLElement>();
@@ -134,7 +136,7 @@
   const bc = "border-[color-mix(in_srgb,var(--ui-color-secondary)_30%,transparent)]";
 </script>
 
-<div class="w-full [color:var(--ui-color-text)]">
+<div {...rest} class="w-full [color:var(--ui-color-text)]">
   <!-- Built on the core <Input> so the frame/border/hover/focus glow + themed autofill are shared,
 	     not re-rolled. Search is the left icon; clear + help live in the `actions` slot; the parse
 	     error reuses Input's own validation (danger) styling. -->

package/dist/components/Query.svelte.d.ts

@@ -1,3 +1,4 @@
+import type { HTMLAttributes } from "svelte/elements";
 import type { DataSet } from "../data/dataset.js";
 import type { Size } from "../types/sizes.js";
 import type { Responsive } from "../types/responsive.js";
@@ -9,7 +10,7 @@ type $$ComponentProps = {
     size?: Responsive<Size>;
     variant?: Variant;
     borderless?: boolean;
-};
+} & Omit<HTMLAttributes<HTMLDivElement>, "class">;
 declare const Query: import("svelte").Component<$$ComponentProps, {}, "">;
 type Query = ReturnType<typeof Query>;
 export default Query;

package/dist/components/ScrollArea/ScrollArea.svelte

@@ -6,6 +6,7 @@
 -->
 <script lang="ts">
   import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
   import type { Variant } from "../../types/variants.js";
   import { variantToken } from "../../types/variants.js";
 
@@ -16,6 +17,7 @@
     variant,
     class: cls = "",
     children,
+    ...rest
   }: {
     orientation?: "vertical" | "horizontal" | "both";
     /** Cap the height (any CSS length) — content beyond scrolls. */
@@ -25,7 +27,8 @@
     variant?: Variant;
     class?: string;
     children: Snippet;
-  } = $props();
+    // `style` omitted — the container computes its own (thumb tint vars + height/max-height).
+  } & Omit<HTMLAttributes<HTMLDivElement>, "class" | "style"> = $props();
 
   const overflow = $derived(
     orientation === "horizontal"
@@ -43,7 +46,7 @@
   );
 </script>
 
-<div class="ui-scroll {overflow} {cls}" {style}>
+<div {...rest} class="ui-scroll {overflow} {cls}" {style}>
   {@render children()}
 </div>
 

package/dist/components/ScrollArea/ScrollArea.svelte.d.ts

@@ -1,4 +1,5 @@
 import type { Snippet } from "svelte";
+import type { HTMLAttributes } from "svelte/elements";
 import type { Variant } from "../../types/variants.js";
 type $$ComponentProps = {
     orientation?: "vertical" | "horizontal" | "both";
@@ -9,7 +10,7 @@ type $$ComponentProps = {
     variant?: Variant;
     class?: string;
     children: Snippet;
-};
+} & Omit<HTMLAttributes<HTMLDivElement>, "class" | "style">;
 declare const ScrollArea: import("svelte").Component<$$ComponentProps, {}, "">;
 type ScrollArea = ReturnType<typeof ScrollArea>;
 export default ScrollArea;

package/dist/components/SideBarMenu/SideBarMenu.svelte

@@ -128,6 +128,7 @@
   import IconChevronRight from "~icons/mdi/chevron-right";
   import IconChevronUp from "~icons/mdi/chevron-up";
   import IconChevronDown from "~icons/mdi/chevron-down";
+  import type { HTMLAttributes } from "svelte/elements";
   import type { Placement } from "../../positioning/anchored.js";
   import type { Size } from "../../types/sizes.js";
   import { variantToken, type Variant } from "../../types/variants.js";
@@ -156,6 +157,7 @@
     activeMode = $bindable(),
     publishWidthVar,
     class: additionalClass = "",
+    ...rest
   }: {
     items?: SideBarMenuItem[];
     bottomItems?: SideBarMenuItem[];
@@ -244,7 +246,10 @@
      *  when you run more than one). Unset → nothing published. */
     publishWidthVar?: boolean | string;
     class?: string;
-  } = $props();
+    // Leftover HTML attributes are forwarded onto the strip's root `<aside>` (the primary content
+    // container; the outer wrapper is `display:contents` in every non-hover-expand mode). `style` is
+    // omitted — the aside computes its own (`--sbm-accent`), as does the wrapper (spacer width).
+  } & Omit<HTMLAttributes<HTMLElement>, "class" | "style"> = $props();
 
   // Per-instance, hydration-stable id prefix so popout DOM ids are unique when more than one
   // SideBarMenu renders on a page (otherwise `sbm-popout-top-1` collides, breaking `aria-controls`
@@ -1174,6 +1179,7 @@
   style="{hoverExpandActive ? `width: ${collapsedW}px;` : ''}"
 >
   <aside
+    {...rest}
     bind:this={asideRef}
     bind:clientHeight={asideH}
     data-sbm-aside={uid}

package/dist/components/SideBarMenu/SideBarMenu.svelte.d.ts

@@ -94,6 +94,7 @@ export type SideBarMenuItem = {
      *  the default `currentPath` segment-boundary match against `link`. */
     activeMatch?: SideBarMenuActiveRule;
 };
+import type { HTMLAttributes } from "svelte/elements";
 import type { Size } from "../../types/sizes.js";
 import { type Variant } from "../../types/variants.js";
 import { type Breakpoint } from "../../types/breakpoints.js";
@@ -186,7 +187,7 @@ type $$ComponentProps = {
      *  when you run more than one). Unset → nothing published. */
     publishWidthVar?: boolean | string;
     class?: string;
-};
+} & Omit<HTMLAttributes<HTMLElement>, "class" | "style">;
 declare const SideBarMenu: import("svelte").Component<$$ComponentProps, {}, "open" | "stepLevel" | "api" | "activeMode">;
 type SideBarMenu = ReturnType<typeof SideBarMenu>;
 export default SideBarMenu;

package/dist/components/Slider/Slider.svelte

@@ -12,6 +12,7 @@
   import { variantToken } from "../../types/variants.js";
   import type { Size } from "../../types/sizes.js";
   import { responsiveClasses, type Responsive } from "../../types/responsive.js";
+  import type { HTMLAttributes } from "svelte/elements";
 
   let {
     value = $bindable(0),
@@ -31,6 +32,7 @@
     required = false,
     id,
     class: cls = "",
+    ...rest
   }: {
     value?: number | [number, number];
     min?: number;
@@ -49,7 +51,7 @@
     required?: boolean;
     id?: string;
     class?: string;
-  } = $props();
+  } & Omit<HTMLAttributes<HTMLDivElement>, "class" | "id"> = $props();
 
   const controlId = id ?? nextFieldId();
   const isRange = $derived(range || Array.isArray(value));
@@ -166,7 +168,7 @@
 
 <FieldChrome {label} {aside} {error} {description} {required} {controlId} {size} class={cls}>
   {#snippet control({ describedBy })}
-    <div class="flex items-center gap-3 select-none">
+    <div {...rest} class="flex items-center gap-3 select-none">
       <!-- The track is the click-to-position surface; the thumbs below carry role="slider". -->
       <!-- svelte-ignore a11y_no_static_element_interactions -->
       <!-- Disabled keeps pointer events (so the not-allowed cursor shows) but every handler no-ops on

package/dist/components/Slider/Slider.svelte.d.ts

@@ -2,6 +2,7 @@ import type { Snippet } from "svelte";
 import type { Variant } from "../../types/variants.js";
 import type { Size } from "../../types/sizes.js";
 import { type Responsive } from "../../types/responsive.js";
+import type { HTMLAttributes } from "svelte/elements";
 type $$ComponentProps = {
     value?: number | [number, number];
     min?: number;
@@ -20,7 +21,7 @@ type $$ComponentProps = {
     required?: boolean;
     id?: string;
     class?: string;
-};
+} & Omit<HTMLAttributes<HTMLDivElement>, "class" | "id">;
 declare const Slider: import("svelte").Component<$$ComponentProps, {}, "value">;
 type Slider = ReturnType<typeof Slider>;
 export default Slider;

package/dist/components/Spinner/Spinner.svelte

@@ -8,6 +8,7 @@
  */
 -->
 <script lang="ts">
+  import type { HTMLAttributes } from "svelte/elements";
   import type { Variant } from "../../types/variants.js";
   import { variantToken } from "../../types/variants.js";
   import type { Size } from "../../types/sizes.js";
@@ -18,6 +19,7 @@
     size = "md",
     label = "Loading",
     class: cls = "",
+    ...rest
   }: {
     /** Colour accent. Omit to inherit `currentColor` (e.g. inside a filled Button). */
     variant?: Variant;
@@ -25,7 +27,7 @@
     /** Accessible label (visually hidden). */
     label?: string;
     class?: string;
-  } = $props();
+  } & Omit<HTMLAttributes<HTMLSpanElement>, "class" | "style"> = $props();
 
   // 16 / 20 / 24px rings on the shared size axis.
   const sizeClass: Record<Size, string> = {
@@ -46,6 +48,7 @@
 <span
   role="status"
   aria-live="polite"
+  {...rest}
   class="inline-block shrink-0 animate-spin rounded-full border-solid align-[-0.125em] {responsiveClasses(
     size,
     sizeClass,

package/dist/components/Spinner/Spinner.svelte.d.ts

@@ -1,3 +1,4 @@
+import type { HTMLAttributes } from "svelte/elements";
 import type { Variant } from "../../types/variants.js";
 import type { Size } from "../../types/sizes.js";
 import { type Responsive } from "../../types/responsive.js";
@@ -8,7 +9,7 @@ type $$ComponentProps = {
     /** Accessible label (visually hidden). */
     label?: string;
     class?: string;
-};
+} & Omit<HTMLAttributes<HTMLSpanElement>, "class" | "style">;
 declare const Spinner: import("svelte").Component<$$ComponentProps, {}, "">;
 type Spinner = ReturnType<typeof Spinner>;
 export default Spinner;

package/dist/components/Splitter/Splitter.svelte

@@ -9,6 +9,7 @@
   import type { Snippet } from "svelte";
   import type { Variant } from "../../types/variants.js";
   import { variantToken } from "../../types/variants.js";
+  import type { HTMLAttributes } from "svelte/elements";
 
   let {
     start,
@@ -21,6 +22,7 @@
     variant = "primary",
     disabled = false,
     class: cls = "",
+    ...rest
   }: {
     start: Snippet;
     end: Snippet;
@@ -33,7 +35,7 @@
     variant?: Variant;
     disabled?: boolean;
     class?: string;
-  } = $props();
+  } & Omit<HTMLAttributes<HTMLDivElement>, "class" | "style"> = $props();
 
   const isH = $derived(orientation === "horizontal");
   const token = $derived(variantToken[variant]);
@@ -82,6 +84,7 @@
 </script>
 
 <div
+  {...rest}
   bind:this={containerEl}
   class="flex {isH ? 'flex-row' : 'flex-col'} {cls}"
   style={dragging ? "user-select: none;" : ""}

package/dist/components/Splitter/Splitter.svelte.d.ts

@@ -1,5 +1,6 @@
 import type { Snippet } from "svelte";
 import type { Variant } from "../../types/variants.js";
+import type { HTMLAttributes } from "svelte/elements";
 type $$ComponentProps = {
     start: Snippet;
     end: Snippet;
@@ -12,7 +13,7 @@ type $$ComponentProps = {
     variant?: Variant;
     disabled?: boolean;
     class?: string;
-};
+} & Omit<HTMLAttributes<HTMLDivElement>, "class" | "style">;
 declare const Splitter: import("svelte").Component<$$ComponentProps, {}, "size">;
 type Splitter = ReturnType<typeof Splitter>;
 export default Splitter;

package/dist/components/Stepper/Stepper.svelte

@@ -18,6 +18,7 @@
   import { variantToken } from "../../types/variants.js";
   import type { Size } from "../../types/sizes.js";
   import { responsiveClasses, type Responsive } from "../../types/responsive.js";
+  import type { HTMLAttributes } from "svelte/elements";
 
   let {
     steps,
@@ -27,6 +28,7 @@
     size = "md",
     onstep,
     class: cls = "",
+    ...rest
   }: {
     steps: StepItem[];
     current?: number;
@@ -35,7 +37,7 @@
     size?: Responsive<Size>;
     onstep?: (index: number) => void;
     class?: string;
-  } = $props();
+  } & Omit<HTMLAttributes<HTMLElement>, "class"> = $props();
 
   const token = $derived(variantToken[variant]);
   const isH = $derived(orientation === "horizontal");
@@ -62,6 +64,7 @@
 </script>
 
 <ol
+  {...rest}
   class="flex {isH ? 'flex-row items-start' : 'flex-col'} {cls}"
   aria-label={i18n.messages.progress}
 >

package/dist/components/Stepper/Stepper.svelte.d.ts

@@ -7,6 +7,7 @@ export type StepItem = {
 import type { Variant } from "../../types/variants.js";
 import type { Size } from "../../types/sizes.js";
 import { type Responsive } from "../../types/responsive.js";
+import type { HTMLAttributes } from "svelte/elements";
 type $$ComponentProps = {
     steps: StepItem[];
     current?: number;
@@ -15,7 +16,7 @@ type $$ComponentProps = {
     size?: Responsive<Size>;
     onstep?: (index: number) => void;
     class?: string;
-};
+} & Omit<HTMLAttributes<HTMLElement>, "class">;
 declare const Stepper: import("svelte").Component<$$ComponentProps, {}, "current">;
 type Stepper = ReturnType<typeof Stepper>;
 export default Stepper;

package/dist/components/ThemeSelector.svelte

@@ -5,10 +5,18 @@
   import type { Size } from "../types/sizes.js";
   import { responsiveClasses, type Responsive } from "../types/responsive.js";
   import type { Variant } from "../types/variants.js";
+  import type { HTMLAttributes } from "svelte/elements";
   import { applyTheme, readStoredTheme, type ThemeValue } from "./theme.js";
 
   // Shared axes, forwarded to the underlying Select (and the label text tracks size).
-  let { size = "md", variant }: { size?: Responsive<Size>; variant?: Variant } = $props();
+  let {
+    size = "md",
+    variant,
+    ...rest
+  }: { size?: Responsive<Size>; variant?: Variant } & Omit<
+    HTMLAttributes<HTMLDivElement>,
+    "class"
+  > = $props();
   const labelText: Record<Size, string> = { sm: "text-xs", md: "text-sm", lg: "text-base" };
   const labelClass = $derived(responsiveClasses(size, labelText));
 
@@ -33,7 +41,7 @@
   });
 </script>
 
-<div class="flex items-center gap-2">
+<div {...rest} class="flex items-center gap-2">
   <label for="theme-selector" class="{labelClass} font-medium text-[var(--ui-color-text)]"
     >Theme:</label
   >

package/dist/components/ThemeSelector.svelte.d.ts

@@ -1,10 +1,11 @@
 import type { Size } from "../types/sizes.js";
 import { type Responsive } from "../types/responsive.js";
 import type { Variant } from "../types/variants.js";
+import type { HTMLAttributes } from "svelte/elements";
 type $$ComponentProps = {
     size?: Responsive<Size>;
     variant?: Variant;
-};
+} & Omit<HTMLAttributes<HTMLDivElement>, "class">;
 declare const ThemeSelector: import("svelte").Component<$$ComponentProps, {}, "">;
 type ThemeSelector = ReturnType<typeof ThemeSelector>;
 export default ThemeSelector;

package/dist/components/ThemeToggle.svelte

@@ -9,12 +9,18 @@
   import type { Size } from "../types/sizes.js";
   import type { Variant } from "../types/variants.js";
   import type { Responsive } from "../types/responsive.js";
+  import type { HTMLButtonAttributes } from "svelte/elements";
   import { applyTheme, readStoredTheme, resolveTheme, type ThemeValue } from "./theme.js";
   import IconSun from "~icons/mdi/weather-sunny";
   import IconMoon from "~icons/mdi/weather-night";
 
   // Shared axes, forwarded to the underlying Button. Icon-only, so it defaults to the chromeless ghost.
-  let { size = "md", variant = "ghost" }: { size?: Responsive<Size>; variant?: Variant } = $props();
+  let {
+    size = "md",
+    variant = "ghost",
+    ...rest
+  }: { size?: Responsive<Size>; variant?: Variant } & Omit<HTMLButtonAttributes, "class"> =
+    $props();
 
   // The stored value ("auto" until the user picks) and the tracked system preference.
   let theme = $state<ThemeValue>("auto");
@@ -44,7 +50,10 @@
   }
 </script>
 
+<!-- rest is fully typed on this component's own Props (below); the cast only sidesteps a TS
+     "union too complex" limit when spreading a wide attrs type into Button's ButtonProps|AnchorProps. -->
 <Button
+  {...rest as Record<string, unknown>}
   {size}
   {variant}
   onclick={toggle}

package/dist/components/ThemeToggle.svelte.d.ts

@@ -1,10 +1,11 @@
 import type { Size } from "../types/sizes.js";
 import type { Variant } from "../types/variants.js";
 import type { Responsive } from "../types/responsive.js";
+import type { HTMLButtonAttributes } from "svelte/elements";
 type $$ComponentProps = {
     size?: Responsive<Size>;
     variant?: Variant;
-};
+} & Omit<HTMLButtonAttributes, "class">;
 declare const ThemeToggle: import("svelte").Component<$$ComponentProps, {}, "">;
 type ThemeToggle = ReturnType<typeof ThemeToggle>;
 export default ThemeToggle;

package/dist/components/TokenInput/TokenInput.svelte

@@ -8,6 +8,7 @@
 -->
 <script lang="ts">
   import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
   import FieldChrome, { nextFieldId } from "../FieldChrome.svelte";
   import Chip from "../Chip/Chip.svelte";
   import type { Variant } from "../../types/variants.js";
@@ -30,6 +31,7 @@
     id,
     required = false,
     class: cls = "",
+    ...rest
   }: {
     values?: string[];
     allowDuplicates?: boolean;
@@ -45,7 +47,9 @@
     id?: string;
     required?: boolean;
     class?: string;
-  } = $props();
+    // Forwarded onto the field frame (`<label class="tok-field">`). `style` omitted — that frame
+    // computes its own (`--tok-border` vars). `class` goes to FieldChrome's chrome stack (existing).
+  } & Omit<HTMLAttributes<HTMLLabelElement>, "class" | "style"> = $props();
 
   const controlId = id ?? nextFieldId();
   const token = $derived(variantToken[variant]);
@@ -108,6 +112,7 @@
   {#snippet control({ describedBy })}
     <!-- A <label> so clicking anywhere in the field focuses the input natively (no JS handler). -->
     <label
+      {...rest}
       for={controlId}
       class="tok-field flex flex-wrap items-center rounded-[var(--ui-border-radius)] border transition-colors {responsiveClasses(
         size,

package/dist/components/TokenInput/TokenInput.svelte.d.ts

@@ -1,4 +1,5 @@
 import type { Snippet } from "svelte";
+import type { HTMLAttributes } from "svelte/elements";
 import type { Variant } from "../../types/variants.js";
 import type { Size } from "../../types/sizes.js";
 import { type Responsive } from "../../types/responsive.js";
@@ -17,7 +18,7 @@ type $$ComponentProps = {
     id?: string;
     required?: boolean;
     class?: string;
-};
+} & Omit<HTMLAttributes<HTMLLabelElement>, "class" | "style">;
 declare const TokenInput: import("svelte").Component<$$ComponentProps, {}, "values">;
 type TokenInput = ReturnType<typeof TokenInput>;
 export default TokenInput;

package/dist/components/Tree/Tree.svelte

@@ -19,6 +19,7 @@
 
 <script lang="ts">
   import IconChevronRight from "~icons/mdi/chevron-right";
+  import type { HTMLAttributes } from "svelte/elements";
   import type { Variant } from "../../types/variants.js";
   import { variantToken } from "../../types/variants.js";
   import type { Size } from "../../types/sizes.js";
@@ -32,6 +33,7 @@
     variant = "primary",
     size = "md",
     class: cls = "",
+    ...rest
   }: {
     items: TreeNode[];
     /** Keys of expanded nodes (bindable). */
@@ -42,7 +44,9 @@
     variant?: Variant;
     size?: Responsive<Size>;
     class?: string;
-  } = $props();
+    // `style` omitted — rows compute their own inline style (indent + active tint). `onselect` omitted
+    // too: it collides with the DOM `onselect` in HTMLAttributes but has this component's own signature.
+  } & Omit<HTMLAttributes<HTMLElement>, "class" | "style" | "onselect"> = $props();
 
   const token = $derived(variantToken[variant]);
   const rowH: Record<Size, string> = { sm: "h-7 text-xs", md: "h-8 text-sm", lg: "h-10 text-base" };
@@ -137,7 +141,12 @@
 </script>
 
 <!-- svelte-ignore a11y_no_noninteractive_element_interactions -->
-<ul role="tree" class="flex flex-col {responsiveClasses(size, iconCls)} {cls}" onkeydown={onKeydown}>
+<ul
+  {...rest}
+  role="tree"
+  class="flex flex-col {responsiveClasses(size, iconCls)} {cls}"
+  onkeydown={onKeydown}
+>
   {#each flat as f (f.key)}
     {@const active = selected === f.key}
     <li role="none" class="list-none">

package/dist/components/Tree/Tree.svelte.d.ts

@@ -7,6 +7,7 @@ export type TreeNode = {
     children?: TreeNode[];
     disabled?: boolean;
 };
+import type { HTMLAttributes } from "svelte/elements";
 import type { Variant } from "../../types/variants.js";
 import type { Size } from "../../types/sizes.js";
 import { type Responsive } from "../../types/responsive.js";
@@ -20,7 +21,7 @@ type $$ComponentProps = {
     variant?: Variant;
     size?: Responsive<Size>;
     class?: string;
-};
+} & Omit<HTMLAttributes<HTMLElement>, "class" | "style" | "onselect">;
 declare const Tree: import("svelte").Component<$$ComponentProps, {}, "selected" | "expanded">;
 type Tree = ReturnType<typeof Tree>;
 export default Tree;

package/docs/components.md

@@ -17,6 +17,18 @@ Most sizeable/themeable components share two props (defined in `types/variants.t
 - **`size`** — `sm` (24px), `md` (32px, **default**), `lg` (40px). Tied to the theme's
   `--ui-height-sm` / `--ui-height` / `--ui-height-lg`.
 
+## HTML attribute passthrough
+
+Components forward the standard HTML attributes you pass — **`class`** (merged onto the root, appended
+last so your classes win), **`data-*`** (e.g. a stable `data-testid` for e2e), **`aria-*`**, **`id`**,
+**`title`**, and event handlers — onto their root element, typed against the matching `HTML*Attributes`.
+So `<Badge data-testid="status" class="ml-2">` or `<Card onmouseenter={…}>` just work and type-check.
+
+Exceptions: components that compute their own root **`style`** (themed `color-mix`, dimensions, drag
+transforms — e.g. `Badge`, `Alert`, `Skeleton`, `DataTable`) do **not** accept a `style` override —
+use `class`. Field-shaped components (`Input`, the specialized inputs, `Slider`, `TokenInput`,
+`FileUpload`) route `class` to their outer field wrapper and land other attributes on the control.
+
 ## Field chrome (shared)
 
 Every field-shaped component — `Input`, `Select`, `TextArea`, `Checkbox`, `Toggle` (and the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaethtech/svelte-ui",
-  "version": "0.20.1-dev.102.3c5719c",
+  "version": "0.20.1-dev.105.894ecae",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/spaethtech/svelte-ui.git"