@rokkit/ui 1.1.18 → 1.1.19

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

@@ -0,0 +1,17 @@
+/**
+     * Tooltip — contextual text revealed on hover or focus.
+     *
+     * Wraps any trigger element. Tooltip appears after a configurable delay
+     * on mouseenter/focusin, hides immediately on mouseleave/focusout/Escape.
+     * Position auto-flips when the preferred side would overflow the viewport.
+     *
+     * Data attributes:
+     *   data-tooltip-root     — wrapper element (position: relative)
+     *   data-tooltip-content  — tooltip bubble
+     *   data-tooltip-position — actual position after auto-flip
+     *   data-tooltip-visible  — "true" while visible
+     */
+import type { TooltipProps } from '../types/tooltip.js';
+declare const Tooltip: import("svelte").Component<TooltipProps, {}, "">;
+type Tooltip = ReturnType<typeof Tooltip>;
+export default Tooltip;

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

@@ -0,0 +1,31 @@
+/**
+     * Tree — Hierarchical data navigation with tree lines and keyboard navigation.
+     *
+     * Architecture:
+     *   LazyWrapper  — owns focusedKey $state + flatView $derived (with lineTypes)
+     *   Navigator    — attaches DOM event handlers, calls wrapper[action](path)
+     *   flatView     — single flat {#each}, connectors rendered from node.lineTypes
+     *
+     * Default item content: icon + label + badge + shortcut (no avatar/description).
+     * Parent nodes hide their icon by default (showIcon=false) so only the
+     * expand/collapse chevron + label are shown, aligning with leaf icon + label.
+     */
+import type { ProxyItem } from '@rokkit/states';
+type $$ComponentProps = {
+    items?: unknown[];
+    fields?: Record<string, string>;
+    value?: unknown;
+    size?: string;
+    lineStyle?: 'none' | 'solid' | 'dashed' | 'dotted';
+    labels?: Record<string, string>;
+    icons?: {
+        opened?: string;
+        closed?: string;
+    };
+    onselect?: (value: unknown, proxy: ProxyItem) => void;
+    class?: string;
+    [key: string]: unknown;
+};
+declare const Tree: import("svelte").Component<$$ComponentProps, {}, "value">;
+type Tree = ReturnType<typeof Tree>;
+export default Tree;

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

@@ -0,0 +1,4 @@
+import type { TreeTableProps } from '../types/tree-table.js';
+declare const TreeTable: import("svelte").Component<TreeTableProps, {}, "values">;
+type TreeTable = ReturnType<typeof TreeTable>;
+export default TreeTable;

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

@@ -0,0 +1,19 @@
+/**
+     * UploadFileStatus — Renders a single file's upload status and action buttons.
+     *
+     * Data attributes:
+     *   data-upload-file-status — root
+     *   data-upload-file-icon   — file type icon
+     *   data-upload-status      — status text badge
+     *   data-upload-bar         — progress bar track
+     *   data-upload-fill        — progress bar fill
+     *   data-upload-actions     — action buttons wrapper
+     *   data-upload-cancel      — cancel button
+     *   data-upload-retry       — retry button
+     *   data-upload-remove      — remove button
+     *   data-status             — status value on root (for CSS theming)
+     */
+import type { UploadFileStatusProps } from '../types/upload-file-status.js';
+declare const UploadFileStatus: import("svelte").Component<UploadFileStatusProps, {}, "">;
+type UploadFileStatus = ReturnType<typeof UploadFileStatus>;
+export default UploadFileStatus;

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

@@ -0,0 +1,7 @@
+import type { UploadProgressProps } from '../types/upload-progress.js';
+type $$ComponentProps = UploadProgressProps & {
+    [key: string]: unknown;
+};
+declare const UploadProgress: import("svelte").Component<$$ComponentProps, {}, "">;
+type UploadProgress = ReturnType<typeof UploadProgress>;
+export default UploadProgress;

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

@@ -0,0 +1,7 @@
+import type { UploadTargetProps } from '../types/upload-target.js';
+type $$ComponentProps = UploadTargetProps & {
+    [key: string]: unknown;
+};
+declare const UploadTarget: import("svelte").Component<$$ComponentProps, {}, "">;
+type UploadTarget = ReturnType<typeof UploadTarget>;
+export default UploadTarget;

package/dist/components/index.d.ts

@@ -0,0 +1,54 @@
+export { default as Button } from './Button.svelte';
+export { default as ButtonGroup } from './ButtonGroup.svelte';
+export { default as Code } from './Code.svelte';
+export { default as CodeBlock } from './CodeBlock.svelte';
+export { default as CodeGroup } from './CodeGroup.svelte';
+export { default as Frame } from './Frame.svelte';
+export { default as Menu } from './Menu.svelte';
+export { default as Dropdown } from './Dropdown.svelte';
+export { default as Select } from './Select.svelte';
+export { default as MultiSelect } from './MultiSelect.svelte';
+export { default as Toolbar } from './Toolbar.svelte';
+export { default as ToolbarGroup } from './ToolbarGroup.svelte';
+export { default as Tabs } from './Tabs.svelte';
+export { default as Toggle } from './Toggle.svelte';
+export { default as Swatch } from './Swatch.svelte';
+export { default as List } from './List.svelte';
+export { default as Tree } from './Tree.svelte';
+export { default as LazyTree } from './LazyTree.svelte';
+export { default as Connector } from './Connector.svelte';
+export { default as ItemContent } from './ItemContent.svelte';
+export { default as FloatingAction } from './FloatingAction.svelte';
+export { default as PaletteManager } from './PaletteManager.svelte';
+export { default as Tilt } from './Tilt.svelte';
+export { default as Shine } from './Shine.svelte';
+export { default as BreadCrumbs } from './BreadCrumbs.svelte';
+export { default as Card } from './Card.svelte';
+export { default as ProgressBar } from './ProgressBar.svelte';
+export { default as Carousel } from './Carousel.svelte';
+export { default as CommandPalette } from './CommandPalette.svelte';
+export { default as Pill } from './Pill.svelte';
+export { default as Rating } from './Rating.svelte';
+export { default as Stepper } from './Stepper.svelte';
+export { default as Switch } from './Switch.svelte';
+export { default as Table } from './Table.svelte';
+export { default as TreeTable } from './TreeTable.svelte';
+export { default as SearchFilter } from './SearchFilter.svelte';
+export { default as Range } from './Range.svelte';
+export { default as Timeline } from './Timeline.svelte';
+export { default as Reveal } from './Reveal.svelte';
+export { default as Grid } from './Grid.svelte';
+export { default as UploadTarget } from './UploadTarget.svelte';
+export { default as UploadFileStatus } from './UploadFileStatus.svelte';
+export { default as UploadProgress } from './UploadProgress.svelte';
+export { default as FloatingNavigation } from './FloatingNavigation.svelte';
+export { default as StatusList } from './StatusList.svelte';
+export { default as Message } from './Message.svelte';
+export { default as AlertList } from './AlertList.svelte';
+export { default as Divider } from './Divider.svelte';
+export { default as Stack } from './Stack.svelte';
+export { default as Badge } from './Badge.svelte';
+export { default as Avatar } from './Avatar.svelte';
+export { default as Tooltip } from './Tooltip.svelte';
+export { default as NavContent } from './NavContent.svelte';
+export { default as ResponsiveGrid } from './ResponsiveGrid.svelte';

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Button, ButtonGroup, Code, CodeBlock, CodeGroup, Frame, Menu, Dropdown, Select, MultiSelect, Toolbar, ToolbarGroup, Tabs, Toggle, Swatch, List, Tree, LazyTree, FloatingAction, FloatingNavigation, PaletteManager, Tilt, Shine, BreadCrumbs, Card, ProgressBar, Carousel, Pill, Rating, Connector, ItemContent, Stepper, Switch, Table, TreeTable, SearchFilter, Range, Timeline, Reveal, Grid, UploadTarget, UploadFileStatus, UploadProgress, StatusList, Message, AlertList, Divider, Stack, Badge, Avatar, Tooltip, NavContent, ResponsiveGrid, CommandPalette } from './components/index.js';
+export { default as MarkdownRenderer } from './MarkdownRenderer.svelte';
+export type { MarkdownPlugin } from './markdown-plugin.js';
+export { highlightCode, preloadHighlighter, getSupportedLanguages } from './utils/shiki.js';
+export * from './utils/palette.js';
+export * from './types/index.js';

package/dist/markdown-plugin.d.ts

@@ -0,0 +1,13 @@
+import type { Component } from 'svelte';
+/**
+ * A plugin that renders a fenced code block as a Svelte component.
+ * The component receives { code: string } as props.
+ */
+export interface MarkdownPlugin {
+    /** Fenced code block language to match (e.g. 'plot', 'table', 'sparkline') */
+    language: string;
+    /** Svelte component to render the block. Receives { code: string } */
+    component: Component<{
+        code: string;
+    }>;
+}

package/dist/types/alert-list.d.ts

@@ -0,0 +1,19 @@
+/**
+ * AlertList Component Types
+ *
+ * Renders a portalled toast stack at a screen-edge position, reading from
+ * the shared `alerts` state.
+ */
+/**
+ * Screen position for the toast stack.
+ */
+export type AlertListPosition = 'top-right' | 'top-center' | 'top-left' | 'bottom-right' | 'bottom-center' | 'bottom-left';
+/**
+ * Props for the AlertList component.
+ */
+export interface AlertListProps {
+    /** Screen position for the toast stack. */
+    position?: AlertListPosition;
+    /** Additional CSS class. */
+    class?: string;
+}

package/dist/types/avatar.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Avatar Component Types
+ */
+/** Avatar size scale. */
+export type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** Avatar shape. */
+export type AvatarShape = 'circle' | 'square';
+/** Online presence status. */
+export type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
+/**
+ * Props for the Avatar component.
+ */
+export interface AvatarProps {
+    /** Image source URL. */
+    src?: string;
+    /** Alt text for the image. */
+    alt?: string;
+    /** Explicit initials to display as fallback. */
+    initials?: string;
+    /** Full name — auto-derives initials if `initials` prop not provided. */
+    name?: string;
+    /** Size variant. */
+    size?: AvatarSize;
+    /** Online presence status. */
+    status?: AvatarStatus;
+    /** Shape variant. */
+    shape?: AvatarShape;
+    /** Additional CSS class. */
+    class?: string;
+}

package/dist/types/badge.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Badge Component Types
+ */
+import type { Snippet } from 'svelte';
+/** Semantic color variant for a badge. */
+export type BadgeVariant = 'default' | 'primary' | 'success' | 'warning' | 'error';
+/**
+ * Props for the Badge component.
+ *
+ * Badge can be used standalone or wrapped around a child via the `children`
+ * snippet, in which case it positions itself absolutely over the child.
+ */
+export interface BadgeProps {
+    /** Numeric count to display. */
+    count?: number;
+    /** Maximum count before rendering as `${max}+`. Default `99`. */
+    max?: number;
+    /** Visual variant. */
+    variant?: BadgeVariant;
+    /** Render as a small dot without content. */
+    dot?: boolean;
+    /**
+     * Content to wrap. When provided, the badge positions absolutely over
+     * the rendered child.
+     */
+    children?: Snippet;
+    /** Additional CSS class. */
+    class?: string;
+}

package/dist/types/breadcrumbs.d.ts

@@ -0,0 +1,34 @@
+/**
+ * BreadCrumbs Component Types
+ */
+import type { Snippet } from 'svelte';
+import type { ProxyItem } from '@rokkit/states';
+/**
+ * Icon overrides for the BreadCrumbs component.
+ */
+export interface BreadCrumbsIcons {
+    /** Icon class used for the separator between crumbs. */
+    separator?: string;
+}
+/**
+ * Props for the BreadCrumbs component.
+ */
+export interface BreadCrumbsProps {
+    /** Array of breadcrumb items. */
+    items?: unknown[];
+    /** Custom field mappings used by the internal `ProxyItem`. */
+    fields?: Record<string, string>;
+    /** Accessible label for the surrounding `<nav>`. */
+    label?: string;
+    /** Custom icon overrides. */
+    icons?: BreadCrumbsIcons;
+    /** Called when a crumb is clicked. */
+    onclick?: (value: unknown, item: unknown) => void;
+    /**
+     * Custom snippet for rendering each crumb. Receives the crumb's
+     * `ProxyItem` and a flag indicating whether it is the last (current) crumb.
+     */
+    crumb?: Snippet<[ProxyItem, boolean]>;
+    /** Additional CSS class. */
+    class?: string;
+}

package/dist/types/button.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Button Component Types
+ *
+ * Provides types for the Button and ButtonGroup components.
+ * Supports variants, styles, sizes, loading state, link buttons, and custom content.
+ */
+import type { Snippet } from 'svelte';
+import type { HTMLButtonAttributes } from 'svelte/elements';
+/** Semantic color variant */
+export type ButtonVariant = 'default' | 'primary' | 'secondary' | 'accent' | 'danger';
+/** Visual style treatment */
+export type ButtonStyle = 'default' | 'outline' | 'ghost' | 'gradient' | 'link';
+/**
+ * Props for the Button component.
+ *
+ * Extends native `<button>` attributes so consumers can pass `aria-*`,
+ * `onclick`, `title`, `name`, `form`, etc. The native `style` and `type`
+ * keys are omitted because this component repurposes `style` (visual
+ * treatment) and narrows `type` to the valid button types.
+ */
+export interface ButtonProps extends Omit<HTMLButtonAttributes, 'style' | 'type'> {
+    /** Semantic color variant */
+    variant?: ButtonVariant;
+    /** Visual style treatment */
+    style?: ButtonStyle;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** HTML button type */
+    type?: 'button' | 'submit' | 'reset';
+    /** Button label text */
+    label?: string;
+    /** Leading icon class */
+    icon?: string;
+    /** Trailing icon class */
+    iconRight?: string;
+    /** Navigates as link instead of button */
+    href?: string;
+    /** Link target (when href is set) */
+    target?: string;
+    /** Native tooltip shown on hover */
+    title?: string;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Loading state — shows spinner, disables interaction */
+    loading?: boolean;
+    /** Additional CSS classes */
+    class?: string;
+    /** Click handler */
+    onclick?: (event: MouseEvent) => void;
+    /** Custom content snippet */
+    children?: Snippet;
+}
+/**
+ * Props for the ButtonGroup component
+ */
+export interface ButtonGroupProps {
+    /** Size applied to all buttons in the group */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes */
+    class?: string;
+    /** Content snippet (buttons) */
+    children?: Snippet;
+}

package/dist/types/card.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Card Component Types
+ */
+import type { Snippet } from 'svelte';
+/** Semantic color variant for a card. */
+export type CardVariant = 'default' | 'primary' | 'secondary' | 'tertiary';
+/**
+ * Props for the Card component.
+ *
+ * When `href` is provided the card renders as an anchor. When `onclick` is
+ * provided (and no `href`) it renders as a button. Otherwise it renders as
+ * a plain container.
+ */
+export interface CardProps {
+    /** Optional href — renders the card as an `<a>` link. */
+    href?: string;
+    /** Click handler — applies only when no `href` is provided. */
+    onclick?: () => void;
+    /** Visual variant. */
+    variant?: CardVariant;
+    /** Additional CSS class. */
+    class?: string;
+    /** Card header snippet. */
+    header?: Snippet;
+    /** Card footer snippet. */
+    footer?: Snippet;
+    /** Card body content. */
+    children?: Snippet;
+}

package/dist/types/carousel.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Carousel Component Types
+ */
+import type { Snippet } from 'svelte';
+/** Transition effect between carousel slides. */
+export type CarouselTransition = 'slide' | 'fade' | 'none';
+/**
+ * Props for the Carousel component.
+ */
+export interface CarouselProps {
+    /** Number of slides (required when using the `children` snippet). */
+    count?: number;
+    /** Current slide index (bindable). */
+    current?: number;
+    /** Auto-advance slides. */
+    autoplay?: boolean;
+    /** Autoplay interval in milliseconds. Default `5000`. */
+    interval?: number;
+    /** Wrap around at the ends. Default `true`. */
+    loop?: boolean;
+    /** Show navigation dots. Default `true`. */
+    showDots?: boolean;
+    /** Show prev / next arrow buttons. Default `true`. */
+    showArrows?: boolean;
+    /** Transition effect. Default `'slide'`. */
+    transition?: CarouselTransition;
+    /** Accessible label overrides for built-in controls. */
+    labels?: Record<string, string>;
+    /** Additional CSS class. */
+    class?: string;
+    /** Slide content — receives `(index, current)`. */
+    slide?: Snippet<[number, number]>;
+    /** Children snippet (alternative to `slide`). */
+    children?: Snippet;
+}

package/dist/types/code.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Code component types — Code, CodeBlock, CodeGroup
+ */
+import type { Snippet } from 'svelte';
+import { DEFAULT_STATE_ICONS } from '@rokkit/core';
+/** Supported themes for code highlighting */
+export type CodeTheme = 'light' | 'dark';
+/**
+ * Icons configuration for code action states.
+ * Keys match the naming convention in @rokkit/core DEFAULT_STATE_ICONS.
+ */
+export interface CodeStateIcons {
+    /** Icon class for copy button */
+    copy?: string;
+    /** Icon class for copy success state */
+    copysuccess?: string;
+}
+/**
+ * Default state icons — uses semantic names from @rokkit/core
+ * that get resolved to actual icon classes via UnoCSS shortcuts.
+ */
+export declare const defaultCodeStateIcons: CodeStateIcons;
+/** Props for the Code component */
+export interface CodeProps {
+    /** The code string to display and highlight */
+    code: string;
+    /** Programming language for syntax highlighting */
+    language?: string;
+    /** Color theme for the code block */
+    theme?: CodeTheme;
+    /** Whether to show line numbers */
+    showLineNumbers?: boolean;
+    /** Whether to show the copy button */
+    showCopyButton?: boolean;
+    /** Icons for copy action states */
+    icons?: CodeStateIcons;
+    /** Additional CSS class */
+    class?: string;
+}
+/**
+ * Shiki theme mode for CodeBlock.
+ *
+ * `'auto'` follows `body[data-mode]` (light / dark). Pass `'light'` or
+ * `'dark'` to force a theme.
+ */
+export type CodeBlockTheme = 'auto' | 'light' | 'dark';
+/**
+ * Props for the CodeBlock component.
+ *
+ * Wraps a Shiki-highlighted code body in a Frame whose header carries the
+ * filename + language chip and optional action buttons.
+ */
+export interface CodeBlockProps {
+    /** The code body. */
+    code: string;
+    /** Language label shown as a chip in the header and used for highlighting. */
+    language?: string;
+    /** Filename label shown in the header. */
+    filename?: string;
+    /** Max height (CSS length) of the scrollable code area. No cap when unset. */
+    height?: string;
+    /** Shiki theme mode. Default `'auto'`. */
+    theme?: CodeBlockTheme;
+    /** Show the copy-to-clipboard button. Default `false`. */
+    allowCopy?: boolean;
+    /** Show the download-as-file button. Default `false`. */
+    allowDownload?: boolean;
+    /** Optional extra-actions slot rendered after copy / download. */
+    actions?: Snippet;
+}
+/**
+ * One file in a CodeGroup.
+ *
+ * The `path` doubles as id and tree placement (e.g. `src/lib/Button.svelte`).
+ * Intermediate segments become folder nodes; the final segment becomes a
+ * file leaf.
+ */
+export interface CodeGroupFile {
+    /** Full path used as id and for tree placement. */
+    path: string;
+    /** Shiki language id. */
+    language: string;
+    /** Source code. */
+    code: string;
+    /** Display name override — defaults to the path's last segment. */
+    name?: string;
+    /** File icon override (full icon class) — defaults to extension lookup. */
+    icon?: string;
+}
+/**
+ * Icon overrides for the CodeGroup component, grouped by semantic category.
+ */
+export interface CodeGroupIconOverrides {
+    doc?: Partial<typeof DEFAULT_STATE_ICONS.doc>;
+    folder?: Partial<typeof DEFAULT_STATE_ICONS.folder>;
+    view?: Partial<typeof DEFAULT_STATE_ICONS.view>;
+    action?: Partial<typeof DEFAULT_STATE_ICONS.action>;
+}
+/**
+ * Props for the CodeGroup component.
+ *
+ * Renders a hierarchical tree picker over multiple files with an optional
+ * collapsible preview panel.
+ */
+export interface CodeGroupProps {
+    /** Files rendered in the group. */
+    files: CodeGroupFile[];
+    /** Path of the file selected on first render. Defaults to the first file. */
+    initialFile?: string;
+    /** Additional CSS class. */
+    class?: string;
+    /** Icon overrides per semantic category. */
+    icons?: CodeGroupIconOverrides;
+    /** Optional preview content — toggled by a "Show preview" action. */
+    preview?: Snippet;
+    /** Show the copy button on the inner CodeBlock. Default `true`. */
+    showCopyButton?: boolean;
+}

package/dist/types/connector.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Connector Component Types
+ *
+ * The `Connector` component renders tree-line connectors used by hierarchical
+ * visualizations (Tree, lists with indent guides). The underlying connector
+ * type values are defined in `./tree.ts` and re-exported here for ergonomics.
+ */
+import type { ConnectorType } from './tree.js';
+export type { ConnectorType } from './tree.js';
+/**
+ * Props for the Connector component.
+ */
+export interface ConnectorProps {
+    /** The type of connector to render. Default `'empty'`. */
+    type?: ConnectorType;
+    /** Right-to-left layout support. */
+    rtl?: boolean;
+}

package/dist/types/divider.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Divider Component Types
+ */
+/** Divider orientation. */
+export type DividerOrientation = 'horizontal' | 'vertical';
+/**
+ * Props for the Divider component.
+ */
+export interface DividerProps {
+    /** Orientation of the divider. */
+    orientation?: DividerOrientation;
+    /** Optional label text rendered inline with the divider. */
+    label?: string;
+    /** Additional CSS class. */
+    class?: string;
+}

package/dist/types/floating-action.d.ts

@@ -0,0 +1,89 @@
+import type { Snippet } from 'svelte';
+/**
+ * Field mapping for FloatingAction items
+ */
+export type FloatingActionFields = Record<string, string>;
+/**
+ * Default field mappings
+ */
+export declare const defaultFloatingActionFields: Required<Pick<FloatingActionFields, 'text' | 'value' | 'icon' | 'label' | 'disabled'>>;
+/**
+ * A single action item
+ */
+export type FloatingActionItem = Record<string, unknown>;
+/**
+ * Event handlers passed to custom snippets
+ */
+export interface FloatingActionItemHandlers {
+    onclick: () => void;
+    onkeydown: (event: KeyboardEvent) => void;
+}
+/**
+ * Custom snippet for rendering an action item
+ */
+export type FloatingActionItemSnippet = Snippet<[
+    item: FloatingActionItem,
+    fields: FloatingActionFields,
+    handlers: FloatingActionItemHandlers
+]>;
+/**
+ * Position options for the FAB
+ */
+export type FloatingActionPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+/**
+ * Expansion direction for action items
+ */
+export type FloatingActionExpand = 'radial' | 'vertical' | 'horizontal';
+/**
+ * Alignment for action items in the menu
+ */
+export type FloatingActionItemAlign = 'start' | 'center' | 'end';
+/**
+ * Icons for the FloatingAction trigger button
+ */
+export interface FloatingActionIcons {
+    /** Icon for the main trigger (add action) */
+    add?: string;
+    /** Icon shown when menu is open (close action) */
+    close?: string;
+}
+/**
+ * Props for the FloatingAction component
+ */
+export interface FloatingActionProps {
+    /** Array of action items */
+    items?: FloatingActionItem[];
+    /** Field mapping configuration */
+    fields?: FloatingActionFields;
+    /** Custom icons for the trigger button */
+    icons?: FloatingActionIcons;
+    /** Accessible label for the trigger */
+    label?: string;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Position on screen */
+    position?: FloatingActionPosition;
+    /** How items expand when opened */
+    expand?: FloatingActionExpand;
+    /** Alignment of items in the menu (start/center/end) */
+    itemAlign?: FloatingActionItemAlign;
+    /** Disable the FAB */
+    disabled?: boolean;
+    /** Whether the menu is open (bindable) */
+    open?: boolean;
+    /** Show backdrop overlay when open */
+    backdrop?: boolean;
+    /** Position relative to nearest positioned ancestor instead of viewport */
+    contained?: boolean;
+    /** Called when an action is selected */
+    onselect?: (value: unknown, item: FloatingActionItem) => void;
+    /** Called when menu opens */
+    onopen?: () => void;
+    /** Called when menu closes */
+    onclose?: () => void;
+    /** Additional CSS classes */
+    class?: string;
+    /** Custom snippet for rendering action items */
+    item?: FloatingActionItemSnippet;
+}
+export { getSnippet } from './menu.js';