fluentui-svelte 0.2.0 → 0.3.0

package/dist/components/table/types.d.ts

@@ -0,0 +1,287 @@
+import type { FSContext } from '../../internal/index.js';
+import type { PolymorphicProps } from '../../types/index.js';
+import type { Component, Snippet } from 'svelte';
+import type { CheckboxProps } from '../checkbox/types.ts';
+import type { RadioButtonProps } from '../radio-button/types.ts';
+export type TableSize = 'extra-small' | 'small' | 'medium';
+export type CellFocusMode = 'cell' | 'group' | 'none';
+export type TableRowAppearance = 'none' | 'brand' | 'neutral';
+export type SortDirection = 'ascending' | 'descending';
+export type SelectionType = 'checkbox' | 'radio';
+export type TableDOM = {
+    table: HTMLTableElement;
+    thead: HTMLTableSectionElement;
+    tbody: HTMLTableSectionElement;
+    tr: HTMLTableRowElement;
+    th: HTMLTableCellElement;
+    td: HTMLTableCellElement;
+    div: HTMLDivElement;
+};
+/** @propsmith TableProps */
+export type TableProps<Tag extends 'table' | 'div' = 'table'> = {
+    /** The HTML element to render the table as. Defaults to a `div` when `noNativeElements` is set.
+     * @type 'table' | 'div'
+     * @default 'table'
+     */
+    as?: Tag;
+    /** The DOM reference of the table element.
+     * @type HTMLTableElement | HTMLDivElement
+     * @bindable
+     */
+    ref?: TableDOM[Tag] | HTMLDivElement;
+    /** Affects the sizes of all table subcomponents.
+     * @default 'medium'
+     */
+    size?: TableSize;
+    /** Renders every table part as a `div` instead of a semantic table element. The layout switches
+     * from `display: table` to `display: flex`, which virtualization and sticky headers need.
+     * @default false
+     */
+    noNativeElements?: boolean;
+    /** Turns every header cell into a sort button. Individual cells can still opt in on their own.
+     * @default false
+     */
+    sortable?: boolean;
+    /** Drops the line that separates one row from the next.
+     * @default false
+     */
+    noRowBorders?: boolean;
+    /** Moves the focus between cells with the arrow keys, through a single tab stop. It also
+     * switches the table over to the `role="grid"` pattern, which that navigation requires.
+     * @default false
+     */
+    enableTabspot?: boolean;
+    /** Lets the arrow keys reach rows a windowed list has not rendered. Only read when
+     * `enableTabspot` is set, and the rows need an `aria-rowindex` for it to find them again.
+     * @type TableVirtualizer
+     */
+    virtualizer?: TableVirtualizer;
+    /** Gives every header cell a handle that drags its column wider or narrower. It also pins the
+     * table to a fixed layout, so a column keeps the width it was given.
+     * @default false
+     */
+    resizableColumns?: boolean;
+    /** The width of each column in pixels, by column position. Columns left out keep their own size.
+     * @bindable
+     */
+    columnWidths?: number[];
+    /** Per column limits, by column position.
+     * @type ColumnSizing[]
+     */
+    columnSizing?: ColumnSizing[];
+    /** Called whenever a column is dragged or nudged to a new width.
+     * @type (e: Event, data: { index: number; width: number }) => void
+     */
+    onColumnResize?: (e: Event, data: {
+        index: number;
+        width: number;
+    }) => void;
+} & PolymorphicProps<Tag>;
+export type ColumnSizing = {
+    /** Narrowest the column may be dragged, in pixels.
+     * @default 40
+     */
+    minWidth?: number;
+    /** Width the column starts at, in pixels. Without it the browser sizes the column. */
+    defaultWidth?: number;
+};
+export type TableVirtualizer = {
+    /** Total number of real rows, the whole data set rather than the rendered window. */
+    size: number;
+    /** Scroll so the row at `index` renders. May be async. */
+    scrollToIndex?: (index: number) => void | Promise<void>;
+};
+/** @propsmith TableHeaderProps */
+export type TableHeaderProps<Tag extends 'thead' | 'div' = 'thead'> = {
+    /** The HTML element to render the header as. Inherited from the table by default.
+     * @type 'thead' | 'div'
+     * @default 'thead'
+     */
+    as?: Tag;
+    /** The DOM reference of the header element.
+     * @type HTMLTableSectionElement | HTMLDivElement
+     * @bindable
+     */
+    ref?: TableDOM[Tag] | HTMLDivElement;
+} & PolymorphicProps<Tag>;
+/** @propsmith TableHeaderCellProps */
+export type TableHeaderCellProps<Tag extends 'th' | 'div' = 'th'> = {
+    /** The HTML element to render the header cell as. Inherited from the table by default.
+     * @type 'th' | 'div'
+     * @default 'th'
+     */
+    as?: Tag;
+    /** The DOM reference of the header cell element.
+     * @type HTMLTableCellElement | HTMLDivElement
+     * @bindable
+     */
+    ref?: TableDOM[Tag] | HTMLDivElement;
+    /** Whether the column is sortable. Inherited from the table by default. */
+    sortable?: boolean;
+    /** The direction the column is currently sorted in. Also sets `aria-sort`. */
+    sortDirection?: SortDirection;
+    /** The indicator rendered next to the label of a sortable column.
+     * @type Snippet | Component
+     */
+    sortIcon?: Snippet<[{
+        class: string;
+    }]> | Component<{
+        class: string;
+    }>;
+    /** Content placed after the label, outside the sort button.
+     * @type Snippet | Component
+     */
+    aside?: Snippet<[{
+        class: string;
+    }]> | Component<{
+        class: string;
+    }>;
+    /** How the arrow keys treat the cell. `'group'` holds the focusable content of the cell out of
+     * the tab order until `Enter` steps in, and `Escape` steps back out. `'none'` skips the cell
+     * altogether. Only read when the table sets `enableTabspot`. A resizable header cell defaults to
+     * `'group'`, so the arrows reach its handle instead of leaving the column behind.
+     * @default 'cell'
+     */
+    focusMode?: CellFocusMode;
+    /** Whether the column can be resized. Inherited from the table by default. */
+    resizable?: boolean;
+    /** The accessible name of the resize handle. Give it a translated, and ideally per column, string
+     * — the attributes of the cell reach the cell, never the handle inside it.
+     * @default 'Resize column'
+     */
+    resizeLabel?: string;
+} & PolymorphicProps<Tag>;
+/** @propsmith TableBodyProps */
+export type TableBodyProps<Tag extends 'tbody' | 'div' = 'tbody'> = {
+    /** The HTML element to render the body as. Inherited from the table by default.
+     * @type 'tbody' | 'div'
+     * @default 'tbody'
+     */
+    as?: Tag;
+    /** The DOM reference of the body element.
+     * @type HTMLTableSectionElement | HTMLDivElement
+     * @bindable
+     */
+    ref?: TableDOM[Tag] | HTMLDivElement;
+} & PolymorphicProps<Tag>;
+/** @propsmith TableRowProps */
+export type TableRowProps<Tag extends 'tr' | 'div' = 'tr'> = {
+    /** The HTML element to render the row as. Inherited from the table by default.
+     * @type 'tr' | 'div'
+     * @default 'tr'
+     */
+    as?: Tag;
+    /** The DOM reference of the row element.
+     * @type HTMLTableRowElement | HTMLDivElement
+     * @bindable
+     */
+    ref?: TableDOM[Tag] | HTMLDivElement;
+    /** How the row is filled. Intended to mark a selected row.
+     * @default 'none'
+     */
+    appearance?: TableRowAppearance;
+} & PolymorphicProps<Tag>;
+/** @propsmith TableCellProps */
+export type TableCellProps<Tag extends 'td' | 'div' = 'td'> = {
+    /** The HTML element to render the cell as. Inherited from the table by default.
+     * @type 'td' | 'div'
+     * @default 'td'
+     */
+    as?: Tag;
+    /** The DOM reference of the cell element.
+     * @type HTMLTableCellElement | HTMLDivElement
+     * @bindable
+     */
+    ref?: TableDOM[Tag] | HTMLDivElement;
+    /** How the arrow keys treat the cell. `'group'` holds the focusable content of the cell out of
+     * the tab order until `Enter` steps in, and `Escape` steps back out. `'none'` skips the cell
+     * altogether. Only read when the table sets `enableTabspot`.
+     * @default 'cell'
+     */
+    focusMode?: CellFocusMode;
+} & PolymorphicProps<Tag>;
+/** @propsmith TableSelectionCellProps */
+export type TableSelectionCellProps<Tag extends 'td' | 'div' = 'td'> = {
+    /** The HTML element to render the cell as. Inherited from the table by default.
+     * @type 'td' | 'div'
+     * @default 'td'
+     */
+    as?: Tag;
+    /** The DOM reference of the cell element.
+     * @type HTMLTableCellElement | HTMLDivElement
+     * @bindable
+     */
+    ref?: TableDOM[Tag] | HTMLDivElement;
+    /** A table can have two kinds of selection modes.
+     * @default 'checkbox'
+     */
+    type?: SelectionType;
+    /** Whether the row is selected. `'mixed'` renders the indeterminate state.
+     * @type boolean | 'mixed'
+     * @default false
+     */
+    checked?: boolean | 'mixed';
+    /** Only shows the indicator when it is checked, or the row is hovered or focused.
+     * @default false
+     */
+    subtle?: boolean;
+    /** Hides the indicator while it keeps taking up the same space.
+     * @default false
+     */
+    invisible?: boolean;
+    /** The props to spread on the checkbox rendered when `type` is `'checkbox'`.
+     * @type CheckboxProps
+     */
+    checkboxIndicator?: Omit<CheckboxProps<'div'>, 'wrapperAs' | 'checked' | 'indeterminate' | 'children'>;
+    /** The props to spread on the radio button rendered when `type` is `'radio'`.
+     * @type RadioButtonProps
+     */
+    radioIndicator?: Omit<RadioButtonProps, 'checked' | 'group'>;
+} & PolymorphicProps<Tag>;
+/** @propsmith TableCellLayoutProps */
+export type TableCellLayoutProps = {
+    /** The DOM reference of the layout element.
+     * @bindable
+     */
+    ref?: HTMLDivElement;
+    /** An icon, an avatar or any other visual element placed before the main content.
+     * @type Snippet | Component
+     */
+    media?: Snippet<[{
+        class: string;
+    }]> | Component<{
+        class: string;
+    }>;
+    /** A second line of text that describes or complements the main content. */
+    description?: string;
+    /** Emphasizes the cell by enlarging the media and bolding the main content. */
+    appearance?: 'primary';
+    /** Clips the content with an ellipsis instead of letting it wrap. */
+    truncate?: boolean;
+} & PolymorphicProps<'div'>;
+/** @propsmith TableCellActionsProps */
+export type TableCellActionsProps = {
+    /** The DOM reference of the actions element.
+     * @bindable
+     */
+    ref?: HTMLDivElement;
+    /** Keeps the actions on screen instead of waiting for the row to be hovered or focused. */
+    visible?: boolean;
+} & PolymorphicProps<'div'>;
+export type TableContextConfig = {
+    size: TableSize;
+    noNativeElements: boolean;
+    sortable: boolean;
+    enableTabspot: boolean;
+    resizableColumns: boolean;
+};
+export type TableContextState = {
+    columnWidths: number[];
+};
+export type TableContextMethods = {
+    /** The width a column should render at, or `undefined` to let the browser decide. */
+    getColumnWidth: (index: number) => number | undefined;
+    /** Records a new width for a column, clamped to the minimum it was given. */
+    resizeColumn: (e: Event, index: number, width: number) => void;
+};
+export type TableContext = FSContext<TableContextConfig, TableContextState, null, TableContextMethods>;

package/dist/components/table/types.js

@@ -0,0 +1 @@
+export {};

package/dist/components/text-box/docs/llms.md

@@ -67,20 +67,26 @@ The `onClear` event is triggered when the input is cleared, allowing you to hand
 
 ## Component Props
 
-| Name                | Type                                                      | Description                                                                                                                  |
-| ------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| `type`              | `string`                                                  | The type of the input element. Possible values: `'text'`, `'search'`, `'email'`, `'url'`, `'tel'`, `'password'`, `'number'`. |
-| `ref`               | `HTMLInputElement`                                        | The DOM reference of the input element.                                                                                      |
-| `wrapperRef`        | `HTMLDivElement`                                          | The DOM reference of the wrapper element.                                                                                    |
-| `wrapperAttributes` | `HTMLAttributes<HTMLDivElement>`                          | Additional attributes forwarded to the wrapper element.                                                                      |
-| `size`              | `'small' \| 'medium' \| 'large'`                          | The size of the input.                                                                                                       |
-| `readonly`          | `boolean`                                                 | Whether the input is read-only.                                                                                              |
-| `placeholder`       | `string`                                                  | The placeholder text for the input.                                                                                          |
-| `hideActionButtons` | `boolean`                                                 | Whether to hide the extra action buttons in the input.                                                                       |
-| `justify`           | `boolean`                                                 | Whether the input fills the full width of the container.                                                                     |
-| `contentBefore`     | `string \| Snippet \| Component`                          | Content rendered before the input (e.g. an icon).                                                                            |
-| `contentAfter`      | `string \| Snippet \| Component`                          | Content rendered after the input (e.g. an icon).                                                                             |
-| `textChanged`       | `(e: InputEvent, text: string) => void`                   | Event triggered when content changes in the text box.                                                                        |
-| `querySubmitted`    | `(e: MouseEvent \| KeyboardEvent, query: string) => void` | Event triggered when a query is submitted (Enter or search icon click on `type="search"`).                                   |
-| `onClear`           | `(e: MouseEvent) => void`                                 | Event triggered when the input is cleared.                                                                                   |
-| `children`          | `Snippet`                                                 | The children elements to render inside the input.                                                                            |
+<!-- DO NOT EDIT THIS SECTION (propsmith generated) -->
+<!-- props:TextBoxProps -->
+
+| Name                                 | Type                                                                   | Default            | Description                                                                                                                                      |
+| ------------------------------------ | ---------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `type`                               | [`TextBoxTypes`](https://fluentui-svelte.dev/docs/types/#textboxtypes) | `'text'`           | The type of the input element.                                                                                                                   |
+| `value` _bindable_                   | `string` &#124; `number`                                               |                    | The current value of the input.                                                                                                                  |
+| `wrapperRef` _bindable_              | `HTMLDivElement`                                                       |                    | The DOM reference of the wrapper element.                                                                                                        |
+| `ref` _bindable_                     | `HTMLInputElement`                                                     |                    | The DOM reference of the input element.                                                                                                          |
+| `placeholder`                        | `string`                                                               | `'Fluent TextBox'` | The placeholder text for the input.                                                                                                              |
+| `hideActionButtons`                  | `boolean`                                                              |                    | Whether to hide the extra action buttons in the input.                                                                                           |
+| `justify`                            | `boolean`                                                              |                    | Make the input fill the full width of the container.                                                                                             |
+| `contentBefore`                      | `string` &#124; `Snippet` &#124; `Component`                           |                    | Content rendered before the input, inside the wrapper.                                                                                           |
+| `contentAfter`                       | `string` &#124; `Snippet` &#124; `Component`                           |                    | Content rendered after the input, inside the wrapper.                                                                                            |
+| `size`                               | `'small'` &#124; `'medium'` &#124; `'large'`                           | `'medium'`         | The size of the input element.                                                                                                                   |
+| `textChanged`                        | `(e: InputEvent, text: string) => void`                                |                    | Occurs when content changes in the text box.                                                                                                     |
+| `querySubmitted`                     | `(e: MouseEvent` &#124; `KeyboardEvent, query: string) => void`        |                    | The QuerySubmitted event occurs when: 1. The input type is 'search'. 2. While the focus is in the text box, press Enter or click the query icon. |
+| `onClear`                            | `(e: MouseEvent) => void`                                              |                    | Occurs when the clear button is clicked.                                                                                                         |
+| `children`                           | `Snippet`                                                              |                    | The children elements to render inside the input.                                                                                                |
+| `wrapperAttributes`                  | `HTMLAttributes`                                                       |                    | The attributes to apply to the wrapper element.                                                                                                  |
+| `HTMLInputAttributes` without `size` |                                                                        |                    |                                                                                                                                                  |
+
+<!-- /props:TextBoxProps -->

package/dist/components/textarea/docs/llms.md

@@ -46,10 +46,19 @@ The `onChange` event is triggered whenever the content of the textarea changes.
 
 ## Component Props
 
-| Name               | Type       | Description                                                                                                        |
-| ------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------ |
-| `placeholder`      | `string`   | The placeholder text for the textarea.                                                                             |
-| `resize`           | `string`   | Controls the resizing behavior of the textarea. Possible values: `'none'`, `'both'`, `'horizontal'`, `'vertical'`. |
-| `onChange`         | `function` | Event handler for when the content of the textarea changes.                                                        |
-| `element`          |            | The DOM reference of the textarea element.                                                                         |
-| Element Attributes |            | All other attributes that can be applied to the textarea element.                                                  |
+<!-- DO NOT EDIT THIS SECTION (propsmith generated) -->
+<!-- props:TextAreaProps -->
+
+| Name                             | Type                                                               | Default      | Description                                      |
+| -------------------------------- | ------------------------------------------------------------------ | ------------ | ------------------------------------------------ |
+| `value` _bindable_               | `string`                                                           | `''`         | The current value of the textarea.               |
+| `ref` _bindable_                 | `HTMLElement`                                                      |              | The DOM reference of the textarea element.       |
+| `placeholder`                    | `string`                                                           |              | The placeholder text for the textarea.           |
+| `resize`                         | `'none'` &#124; `'both'` &#124; `'horizontal'` &#124; `'vertical'` | `'vertical'` | Configures the resize behavior of the textarea.  |
+| `onChange`                       | `(e: Event) => void`                                               |              | Callback function for the change event.          |
+| `disabled`                       | `boolean`                                                          | `false`      | Disables the user interaction.                   |
+| `wrapperAttributes`              | `HTMLAttributes`                                                   |              | The attributes to spread on the wrapper element. |
+| `wrapperRef` _bindable_          | `HTMLDivElement`                                                   |              | The DOM reference of the wrapper element.        |
+| `SvelteHTMLElements['textarea']` |                                                                    |              |                                                  |
+
+<!-- /props:TextAreaProps -->

package/dist/components/time-picker/docs/llms.md

@@ -35,13 +35,23 @@ Use `hideHours`, `hideMinutes`, or `hideSeconds` to hide individual columns. By
 
 ## Component Props
 
-| Name           | Type                        | Description                                                                     |
-| -------------- | --------------------------- | ------------------------------------------------------------------------------- |
-| `value`        | bindable `string`           | Selected time as 24h `HH:mm` or `HH:mm:ss` (matches `<input type="time">`).     |
-| `format`       | `12 \| 24`                  | Clock format: `24` (00–23) or `12` (01–12 with an AM/PM column). Default: `24`. |
-| `open`         | bindable `boolean`          | Whether the picker flyout is open.                                              |
-| `hideHours`    | `boolean`                   | Hide the hours column.                                                          |
-| `hideMinutes`  | `boolean`                   | Hide the minutes column.                                                        |
-| `hideSeconds`  | `boolean`                   | Hide the seconds column.                                                        |
-| `element`      | bindable `HTMLElement`      | The DOM reference of the time picker root element.                              |
-| `inputElement` | bindable `HTMLInputElement` | The DOM reference of the underlying input element.                              |
+<!-- DO NOT EDIT THIS SECTION (propsmith generated) -->
+<!-- props:TimePickerProps -->
+
+| Name                          | Type                  | Default           | Description                                                                                         |
+| ----------------------------- | --------------------- | ----------------- | --------------------------------------------------------------------------------------------------- |
+| `value` _bindable_            | `string`              | `''`              | Selected time as 24h `HH:mm` or `HH:mm:ss` (matches `<input type="time">`).                         |
+| `format`                      | `12` &#124; `24`      | `24`              | Clock format: `24` (00-23) or `12` (01-12 with an AM/PM column).                                    |
+| `open` _bindable_             | `boolean`             | `false`           | Controls the open state of the picker.                                                              |
+| `hideHours`                   | `boolean`             | `false`           | Removes the hour column.                                                                            |
+| `hideMinutes`                 | `boolean`             | `false`           | Removes the minute column.                                                                          |
+| `hideSeconds`                 | `boolean`             | `false`           | Removes the second column.                                                                          |
+| `element` _bindable_          | `HTMLButtonElement`   |                   | The DOM reference of the trigger button.                                                            |
+| `wrapperRef` _bindable_       | `HTMLDivElement`      |                   | The DOM reference of the element wrapping the trigger and its input.                                |
+| `wrapperAttributes`           | `HTMLAttributes`      |                   | The attributes to spread on the wrapper element.                                                    |
+| `inputElement` _bindable_     | `HTMLInputElement`    |                   | The DOM reference of the underlying input element.                                                  |
+| `inputProps`                  | `HTMLInputAttributes` |                   | HTML attributes for the underlying input element. Give it a `name` to submit the value with a form. |
+| `popupLabel`                  | `string`              | `'Choose a time'` | The accessible name of the popup, which is announced as a dialog.                                   |
+| Element Attributes (`button`) |                       |                   |                                                                                                     |
+
+<!-- /props:TimePickerProps -->

package/dist/components/toggle-switch/docs/llms.md

@@ -28,12 +28,16 @@ A toggle switch can be labeled, checked, or disabled.
 
 ## Component Props
 
-| Name               | Type                  | Description                                                  |
-| ------------------ | --------------------- | ------------------------------------------------------------ |
-| `ref`              | `HTMLInputElement`    | Get the DOM reference of the input element.                  |
-| `label`            | `string`              | The label for the toggle switch.                             |
-| `labelAttributes`  | `HTMLLabelAttributes` | Attributes to be spread on the label wrapper element.        |
-| `labelElement`     | `HTMLLabelElement`    | Get the DOM reference of the label element.                  |
-| `disabled`         | `boolean`             | Whether the toggle switch is disabled.                       |
-| `checked`          | `boolean`             | Whether the toggle switch is checked (on).                   |
-| Element Attributes | `object`              | Additional attributes to apply to the toggle switch element. |
+<!-- DO NOT EDIT THIS SECTION (propsmith generated) -->
+<!-- props:ToggleSwitchProps -->
+
+| Name                          | Type                  | Default | Description                                                |
+| ----------------------------- | --------------------- | ------- | ---------------------------------------------------------- |
+| `checked` _bindable_          | `boolean`             |         | Whether the switch is on.                                  |
+| `ref` _bindable_              | `HTMLInputElement`    |         | The DOM reference of the input element.                    |
+| `label`                       | `string`              |         | The label displayed next to the input element.             |
+| `labelAttributes`             | `HTMLLabelAttributes` |         | The attributes to spread on the label wrapping the switch. |
+| `labelElement`                | `HTMLLabelElement`    |         | The DOM reference of the label element.                    |
+| `SvelteHTMLElements['input']` |                       |         |                                                            |
+
+<!-- /props:ToggleSwitchProps -->

package/dist/components/tooltip/docs/llms.md

@@ -62,13 +62,27 @@ The relationship prop allows you to specify the relationship between the tooltip
 
 ## Component Props
 
-| Name               | Type                             | Description                                                                                                     |
-| ------------------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------- |
-| `content`          | `string \| Snippet \| Component` | The content to be displayed in the tooltip. This can be a string, a Svelte component, or a Snippet.             |
-| `positionConfig`   | `Partial<ComputePositionConfig>` | The position configuration of the tooltip. This allows you to define custom offsets, middleware, and more.      |
-| `withArrow`        | `boolean`                        | Whether the tooltip should display an arrow pointing towards the target element.                                |
-| `openDelay`        | `number`                         | The delay, in milliseconds, before the tooltip is shown after the user hovers over the target element.          |
-| `hideDelay`        | `number`                         | The delay, in milliseconds, before the tooltip is hidden after the user stops hovering over the target element. |
-| `onVisibleChange`  | `(visible: boolean) => void`     | A callback function that is called whenever the visibility of the tooltip changes.                              |
-| `element`          | `HTMLElement`                    | The DOM reference of the tooltip element.                                                                       |
-| Element Attributes |                                  | All other attributes that can be applied to the tooltip element.                                                |
+<!-- DO NOT EDIT THIS SECTION (propsmith generated) -->
+<!-- props:TooltipProps -->
+
+| Name                                                | Type                                                     | Default            | Description                                                                                              |
+| --------------------------------------------------- | -------------------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------- |
+| `content`                                           | `string` &#124; `Snippet` &#124; `Component`             | `'I am a tooltip'` | The content to display in the tooltip.                                                                   |
+| `class`                                             | `string`                                                 |                    | The class to apply to the tooltip.                                                                       |
+| `ref` _bindable_                                    | `HTMLElement`                                            |                    | The DOM reference of the tooltip element.                                                                |
+| `target`                                            | `HTMLElement`                                            |                    | The element the tooltip is anchored to. Falls back to the rendered children.                             |
+| `open` _bindable_                                   | `boolean`                                                | `false`            | Controls the open state of the tooltip.                                                                  |
+| `withArrow`                                         | `boolean`                                                | `false`            | Whether the tooltip has an arrow pointing at its target.                                                 |
+| `positionConfig`                                    | `ComputePositionConfig`                                  |                    | The position configuration handed over to floating-ui.                                                   |
+| `openDelay`                                         | `number`                                                 | `100`              | The delay in milliseconds before the tooltip is shown.                                                   |
+| `hideDelay`                                         | `number`                                                 | `300`              | The delay in milliseconds before the tooltip is hidden.                                                  |
+| `onVisibleChange`                                   | `(visible: boolean) => void`                             |                    | Callback function that is called when the visibility of the tooltip changes.                             |
+| `relationship`                                      | `'label'` &#124; `'description'` &#124; `'inaccessible'` | `'label'`          | The relationship of the tooltip to its target, which decides how it is announced.                        |
+| `placement`                                         | `Placement`                                              |                    | Where the tooltip is placed relative to its target.                                                      |
+| `id`                                                | `string`                                                 |                    | The id of the tooltip element, referenced by the target. Falls back to a generated id.                   |
+| `preventClose` _bindable_                           | `boolean`                                                | `false`            | Keeps the tooltip open until it is closed by hand.                                                       |
+| `animationFrame`                                    | `boolean`                                                | `false`            | Repositions the tooltip on every animation frame, for a target that keeps moving.                        |
+| `children`                                          | `Snippet`                                                |                    | The target of the tooltip. It receives the ARIA attributes and the attachment to spread on your element. |
+| `HTMLAttributes<HTMLDivElement>` without `children` |                                                          |                    |                                                                                                          |
+
+<!-- /props:TooltipProps -->

package/dist/components/tree-view/docs/llms.md

@@ -74,44 +74,62 @@ Use the bindable `openItems` and `checkedItems` props on the root `TreeView` to
 
 ## Component Props (TreeView)
 
-| Name              | Type                                         | Description                                                                                                     |
-| ----------------- | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
-| `ref`             | `HTMLUListElement`                           | Bindable DOM reference of the root ul element.                                                                  |
-| `size`            | `'small' \| 'medium' \| 'large'`             | Visual size of the tree. Default is 'medium'.                                                                   |
-| `navigationMode`  | `'tree' \| 'treegrid'`                       | Keyboard navigation mode. Default is 'tree'.                                                                    |
-| `selectionMode`   | `'single' \| 'multiple'`                     | Selection mode for checkable items. Default is 'multiple'.                                                      |
-| `openItems`       | `string[] \| SvelteSet<string>`              | Bindable list or set of open item ids. Uses SvelteSet when a virtualizer is provided.                           |
-| `checkedItems`    | `string[] \| SvelteSet<string>`              | Bindable list or set of checked item ids. Uses SvelteSet when a virtualizer is provided.                        |
-| `onOpenChange`    | `(e: Event, openItems: string[]) => void`    | Callback fired when an item is expanded or collapsed.                                                           |
-| `onCheckedChange` | `(e: Event, checkedItems: string[]) => void` | Callback fired when an item is checked or unchecked.                                                            |
-| `virtualizer`     | `TreeViewVirtualizer`                        | Optional adapter for windowing or virtual list libraries. When provided, only the rendered slice is in the DOM. |
-| `children`        | `Snippet`                                    | The TreeViewItem children of the tree.                                                                          |
+<!-- DO NOT EDIT THIS SECTION (propsmith generated) -->
+<!-- props:TreeViewProps -->
+
+| Name                                                | Type                                         | Default      | Description                                                                          |
+| --------------------------------------------------- | -------------------------------------------- | ------------ | ------------------------------------------------------------------------------------ |
+| `ref` _bindable_                                    | `HTMLUListElement`                           |              | The DOM reference of the tree element.                                               |
+| `size`                                              | `'small'` &#124; `'medium'` &#124; `'large'` | `'medium'`   | The size of every item in the tree.                                                  |
+| `navigationMode`                                    | `'tree'` &#124; `'treegrid'`                 | `'tree'`     | Whether the tree takes a single tab stop, or every row is reachable on its own.      |
+| `onOpenChange`                                      | `(e: Event, openItems: string[]) => void`    |              | Called whenever a branch opens or closes.                                            |
+| `selectionMode`                                     | `'single'` &#124; `'multiple'`               | `'multiple'` | How many items can be checked at a time.                                             |
+| `onCheckedChange`                                   | `(e: Event, checkedItems: string[]) => void` |              | Called whenever an item is checked or unchecked.                                     |
+| `virtualizer`                                       | `TreeViewVirtualizer`                        |              | Bridge to a windowing library. Only the rendered slice of items lives in the DOM.    |
+| `openItems` _bindable_                              | `string[]` &#124; `SvelteSet<string>`        |              | The ids of the open branches. A `SvelteSet` is required when a `virtualizer` is set. |
+| `checkedItems` _bindable_                           | `string[]` &#124; `SvelteSet<string>`        |              | The ids of the checked items. A `SvelteSet` is required when a `virtualizer` is set. |
+| `children`                                          | `Snippet`                                    |              | The items of the tree.                                                               |
+| `TreeViewVirtualProps` &#124; `TreeViewStaticProps` |                                              |              |                                                                                      |
+| Element Attributes (`ul`)                           |                                              |              |                                                                                      |
+
+<!-- /props:TreeViewProps -->
 
 ## Component Props (TreeViewItem)
 
-| Name              | Type                                                         | Description                                                                         |
-| ----------------- | ------------------------------------------------------------ | ----------------------------------------------------------------------------------- |
-| `id`              | `string`                                                     | Unique identifier of the item. Required for open and checked state tracking.        |
-| `type`            | `'item' \| 'branch'`                                         | Whether the item is a leaf ('item') or a branch that can contain a nested TreeView. |
-| `ref`             | `HTMLLIElement`                                              | Bindable DOM reference of the li element.                                           |
-| `value`           | `string \| number`                                           | Optional value associated with the item.                                            |
-| `text`            | `string`                                                     | Optional accessible text label used by the tree.                                    |
-| `open`            | `boolean`                                                    | Bindable open state for type='branch' items.                                        |
-| `checked`         | `boolean`                                                    | Bindable checked state for selectable items.                                        |
-| `indeterminate`   | `boolean`                                                    | Whether the item is in an indeterminate check state.                                |
-| `disabled`        | `boolean`                                                    | Disables the item.                                                                  |
-| `index`           | `number`                                                     | Explicit index — used with a virtualizer to keep keyboard navigation in sync.       |
-| `onOpenChange`    | `(e: Event, data: { id: string; open: boolean }) => void`    | Callback fired when this item is expanded or collapsed.                             |
-| `onCheckedChange` | `(e: Event, data: { id: string; checked: boolean }) => void` | Callback fired when this item is checked or unchecked.                              |
+<!-- DO NOT EDIT THIS SECTION (propsmith generated) -->
+<!-- props:TreeViewItemProps -->
+
+| Name                      | Type                                                         | Default  | Description                                                                            |
+| ------------------------- | ------------------------------------------------------------ | -------- | -------------------------------------------------------------------------------------- |
+| `id`                      | `string`                                                     |          | The id of the item, used by the tree to track its state. Falls back to a generated id. |
+| `type`                    | `'item'` &#124; `'branch'`                                   | `'item'` | Whether the item holds children, and can therefore be opened.                          |
+| `ref`                     | `HTMLLIElement`                                              |          | The DOM reference of the item element.                                                 |
+| `value`                   | `string` &#124; `number`                                     | `id`     | The value reported by the tree events. Falls back to the id of the item.               |
+| `text`                    | `string`                                                     |          | The label of the item, used by the type-ahead navigation.                              |
+| `open`                    | `boolean`                                                    |          | Whether the branch is open.                                                            |
+| `checked`                 | `boolean`                                                    |          | Whether the item is checked.                                                           |
+| `indeterminate`           | `boolean`                                                    |          | Renders the checkbox in its mixed state, when only some children are checked.          |
+| `disabled`                | `boolean`                                                    |          | Disables the user interaction.                                                         |
+| `index`                   | `number`                                                     |          | The real index of the item in the data set. Required when the tree is virtualized.     |
+| `onOpenChange`            | `(e: Event, data: { id: string; open: boolean }) => void`    |          | Called when this branch opens or closes.                                               |
+| `onCheckedChange`         | `(e: Event, data: { id: string; checked: boolean }) => void` |          | Called when this item is checked or unchecked.                                         |
+| Element Attributes (`li`) |                                                              |          |                                                                                        |
+
+<!-- /props:TreeViewItemProps -->
 
 ## Component Props (TreeViewItemContent)
 
-| Name         | Type                   | Description                                                 |
-| ------------ | ---------------------- | ----------------------------------------------------------- |
-| `ref`        | `HTMLDivElement`       | Bindable DOM reference of the layout element.               |
-| `expandIcon` | `Snippet \| Component` | Custom icon rendered for the expand or collapse affordance. |
-| `iconBefore` | `Snippet \| Component` | Icon rendered before the item text.                         |
-| `iconAfter`  | `Snippet \| Component` | Icon rendered after the item text.                          |
-| `aside`      | `Snippet \| Component` | Content rendered on the trailing side of the row.           |
-| `actions`    | `Snippet \| Component` | Interactive actions rendered on hover or focus.             |
-| `children`   | `Snippet`              | The item label content.                                     |
+<!-- DO NOT EDIT THIS SECTION (propsmith generated) -->
+<!-- props:TreeViewItemLayoutProps -->
+
+| Name                       | Type                         | Default | Description                                                           |
+| -------------------------- | ---------------------------- | ------- | --------------------------------------------------------------------- |
+| `ref`                      | `HTMLDivElement`             |         | The DOM reference of the layout element.                              |
+| `expandIcon`               | `Snippet` &#124; `Component` |         | Custom icon for the control that opens a branch.                      |
+| `iconBefore`               | `Snippet` &#124; `Component` |         | Content rendered before the label.                                    |
+| `iconAfter`                | `Snippet` &#124; `Component` |         | Content rendered after the label.                                     |
+| `aside`                    | `Snippet` &#124; `Component` |         | Content pinned to the end of the row.                                 |
+| `actions`                  | `Snippet` &#124; `Component` |         | Content pinned to the end of the row, revealed on hover and on focus. |
+| Element Attributes (`div`) |                              |         |                                                                       |
+
+<!-- /props:TreeViewItemLayoutProps -->