@blukavantui/community 0.0.0-stage → 1.1.0

package/dist/types.d.ts

@@ -0,0 +1,1284 @@
+/** Names and visual variants match the existing BluUI component contracts. */
+import type { ComponentColor } from "./colors.js";
+export type { ComponentColor } from "./colors.js";
+export type Callback<T extends unknown[] = []> = (...args: T) => void | Promise<void>;
+export type Slot = Node | string;
+export interface Component<P> {
+    /** Root owned by this instance. Dispose before removing its host. */
+    readonly element: HTMLElement;
+    update(patch: Partial<P>): void;
+    destroy(): void;
+}
+export interface CommonOptions {
+    ExtendedClass?: string;
+}
+export interface ButtonOptions extends CommonOptions {
+    /** Accessible name; keep the visible Label in this name. */
+    AccessibleLabel?: string;
+    IsExpandable?: boolean;
+    IsExpanded?: boolean;
+    ControlsId?: string;
+    IsCurrentPage?: boolean;
+    Label: string;
+    Color?: ComponentColor;
+    Variant?: "Filled" | "Outlined" | "Ghost";
+    Size?: "Small" | "Medium" | "Large";
+    IsDisabled?: boolean;
+    IsLoading?: boolean;
+    IsFullWidth?: boolean;
+}
+export interface ButtonEvents {
+    Click?: Callback<[event: MouseEvent]>;
+}
+export interface BadgeOptions extends CommonOptions {
+    Label: string;
+    Color?: ComponentColor;
+}
+export interface ChipOptions extends BadgeOptions {
+    IsSelected?: boolean;
+    IsSelectable?: boolean;
+    IsRemovable?: boolean;
+    IsDisabled?: boolean;
+}
+export interface ChipEvents {
+    SelectionChanged?: Callback<[selected: boolean]>;
+    Removed?: Callback;
+}
+export interface CardOptions extends CommonOptions {
+    Title?: string;
+    Description?: string;
+    HeadingLevel?: 2 | 3 | 4 | 5 | 6;
+    IsBodyPadded?: boolean;
+    Content?: Slot;
+    Actions?: Slot;
+    Footer?: Slot;
+}
+export interface SkeletonOptions extends CommonOptions {
+    Shape?: "Text" | "Circle" | "Rectangle";
+    Width?: string;
+    Height?: string;
+    IsAnimated?: boolean;
+    AccessibleLabel?: string;
+}
+export interface ChipGroupOptions extends CommonOptions {
+    Content?: Slot;
+    AccessibleLabel?: string;
+}
+export interface EmptyStateOptions extends CommonOptions {
+    Title?: string;
+    Description?: string;
+    IsCompact?: boolean;
+    Kind?: string;
+    Actions?: Slot;
+}
+export interface FloatButtonOptions {
+    Label?: string;
+    Icon?: 'Chat' | 'Help' | 'Plus' | 'Up' | 'Feedback';
+    /** SVG or image asset URL (relative or HTTP(S)). Overrides Icon; empty or failed URLs fall back to Icon. */
+    IconUrl?: string;
+    Color?: ComponentColor;
+    Shape?: 'Circle' | 'Square';
+    ShowLabel?: boolean;
+    BadgeCount?: number;
+    Position?: 'Viewport' | 'Container';
+    Placement?: 'BottomRight' | 'BottomLeft' | 'TopRight' | 'TopLeft';
+    Offset?: number;
+    IsDisabled?: boolean;
+    Animate?: boolean;
+    ExtendedClass?: string;
+}
+export interface FloatButtonEvents {
+    Click?: () => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface Breadcrumb {
+    Label: string;
+    Url?: string;
+}
+export interface BreadcrumbsOptions extends CommonOptions {
+    Items: Breadcrumb[];
+    AccessibleLabel?: string;
+}
+export interface PageHeaderOptions extends CommonOptions {
+    Title: string;
+    Description?: string;
+    SectionLabel?: string;
+    HeadingLevel?: 1 | 2 | 3;
+    Actions?: Slot;
+    Breadcrumbs?: Breadcrumb[];
+}
+export interface NavigationItem {
+    Key: string;
+    Label: string;
+    Url?: string;
+    IconUrl?: string;
+    IsGroup?: boolean;
+    IsDisabled?: boolean;
+}
+export interface SidebarOptions extends CommonOptions {
+    Items?: NavigationItem[];
+    Content?: Slot;
+    ActiveKey?: string;
+    IsOpen?: boolean;
+    AccessibleLabel?: string;
+}
+export interface SidebarEvents {
+    Navigate?: Callback<[key: string, event: MouseEvent]>;
+}
+export interface PaginationOptions {
+    /** Controlled one-based page. Assign OnPageChanged.CurrentPage back to this input. */
+    CurrentPage?: number;
+    /** Records per page; positive integer. Assign OnPageChanged.PageSize back. */
+    PageSize?: number;
+    /** Total matching records, not the size of the current page. */
+    TotalCount?: number;
+    /** JSON array of positive page sizes. */
+    PageSizes?: number[];
+    /** Displays the page-size selector. */
+    ShowPageSize?: boolean;
+    /** Displays an accessible page-number input. */
+    ShowQuickJump?: boolean;
+    /** Uses previous/next controls and a page summary. */
+    IsCompact?: boolean;
+    /** Disables paging during a request. */
+    IsDisabled?: boolean;
+    /** Accessible navigation label. */
+    AccessibleLabel?: string;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+}
+export interface PaginationEvents {
+    PageChanged?: (currentPage: number, pageSize: number) => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface StatisticOptions {
+    /** Metric label. */
+    Label?: string;
+    /** Numeric value to format. */
+    Value?: number;
+    /** Fraction digits, from 0 to 8. */
+    Precision?: number;
+    /** Text before the value, such as a currency symbol. */
+    Prefix?: string;
+    /** Text after the value, such as %. */
+    Suffix?: string;
+    /** BCP 47 number-formatting locale. */
+    Locale?: string;
+    /** Supporting trend or comparison text. */
+    Trend?: string;
+    /** Up, Down or Neutral. Arrow direction does not determine semantic color. */
+    TrendDirection?: string;
+    /** Semantic color from the shared ComponentColor entity. */
+    Color?: ComponentColor;
+    /** Shows a loading placeholder and announces busy state. */
+    IsLoading?: boolean;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+}
+export interface StatisticEvents {
+    Error?: (message: string) => unknown;
+}
+export interface BluTimelineItem {
+    /** Unique activity identifier. */
+    Key: string;
+    /** Activity heading. */
+    Title: string;
+    /** Supporting activity text. */
+    Description?: string;
+    /** Consumer-formatted date or time. */
+    Timestamp?: string;
+    /** Shared ComponentColor code, for example Success or Processing. */
+    Color?: string;
+    /** Optional short text or symbol inside the marker. */
+    Icon?: string;
+    /** Optional action caption; emits OnItemClick. */
+    ActionLabel?: string;
+}
+export interface TimelineOptions {
+    /** Ordered activity records. Keys must be unique; list order is display order. */
+    Items: BluTimelineItem[];
+    /** Displays the most recent list item first. */
+    IsReversed?: boolean;
+    /** Uses compact spacing. */
+    IsCompact?: boolean;
+    /** Accessible name of the timeline. */
+    AccessibleLabel?: string;
+    /** Message for an empty list. */
+    EmptyText?: string;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+}
+export interface TimelineEvents {
+    ItemClick?: (key: string) => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface BluDescriptionItem {
+    /** Unique detail identifier. */
+    Key: string;
+    /** Field caption. */
+    Label: string;
+    /** Display value, rendered as text. */
+    Value: string;
+    /** Number of columns occupied (1–3). */
+    Span?: number;
+    /** Shared ComponentColor code for the value. */
+    Color?: string;
+    /** Optional action caption; emits OnItemClick. */
+    ActionLabel?: string;
+}
+export interface DescriptionsOptions {
+    /** Ordered label/value records with stable keys. */
+    Items: BluDescriptionItem[];
+    /** Optional section heading. */
+    Title?: string;
+    /** Requested columns, 1–3; narrow screens collapse automatically. */
+    Columns?: number;
+    /** Shows cell borders and tinted labels. */
+    IsBordered?: boolean;
+    /** Message for an empty list. */
+    EmptyText?: string;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+}
+export interface DescriptionsEvents {
+    ItemClick?: (key: string) => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface DrawerOptions {
+    /** Controlled visibility. Assign OnOpenChanged.IsOpen back to this input. */
+    IsOpen?: boolean;
+    /** Visible heading and accessible dialog name. */
+    Title?: string;
+    /** Optional supporting text beneath the heading. */
+    Description?: string;
+    /** Small, Medium or Large. */
+    Size?: string;
+    /** Allows Escape to request closing. */
+    CloseOnEscape?: boolean;
+    /** Allows a click on the backdrop to request closing. */
+    CloseOnBackdrop?: boolean;
+    /** Shows a working state and disables Confirm. Close and Cancel remain available; Escape and backdrop follow their settings. Closing does not cancel background work. */
+    IsBusy?: boolean;
+    /** Displays footer content and the default actions. */
+    ShowFooter?: boolean;
+    /** Displays built-in Cancel and Confirm buttons. */
+    ShowDefaultActions?: boolean;
+    /** Built-in confirm caption. */
+    ConfirmLabel?: string;
+    /** Built-in cancel caption. */
+    CancelLabel?: string;
+    /** Drawer edge: Left, Right or Bottom. */
+    Placement?: string;
+    /** Optional business key emitted with Confirm. */
+    InstanceKey?: string;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+    Content?: Slot;
+    Footer?: Slot;
+}
+export interface DrawerEvents {
+    OpenChanged?: (isOpen: boolean, reason: string) => unknown;
+    Confirm?: (key: string) => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface BluChatMessage {
+    Key: string;
+    Role: 'User' | 'Assistant' | 'System';
+    Content: string;
+    Name?: string;
+    AvatarUrl?: string;
+    Timestamp?: string;
+}
+export interface BluChatSuggestion {
+    Key: string;
+    Label: string;
+    Text: string;
+}
+export type ChatStatus = 'Idle' | 'Waiting' | 'Streaming' | 'Error';
+export interface ChatOptions {
+    Messages?: BluChatMessage[];
+    Suggestions?: BluChatSuggestion[];
+    Title?: string;
+    Subtitle?: string;
+    AssistantName?: string;
+    AccessibleLabel?: string;
+    WelcomeTitle?: string;
+    WelcomeMessage?: string;
+    Placeholder?: string;
+    Height?: number;
+    MaxLength?: number;
+    Status?: ChatStatus;
+    ErrorMessage?: string;
+    /** Echo the request ID from Send/Retry for every response update. Stale IDs are ignored. */
+    ResponseRequestId?: string;
+    /** Change this to load a different conversation and invalidate pending responses. */
+    ResetKey?: string;
+    ShowHeader?: boolean;
+    ShowAvatars?: boolean;
+    ShowTimestamps?: boolean;
+    EnableMarkdown?: boolean;
+    AllowCopy?: boolean;
+    IsDisabled?: boolean;
+    Animate?: boolean;
+    ExtendedClass?: string;
+}
+export interface ChatEvents {
+    Send?: (requestId: string, text: string) => unknown;
+    Retry?: (requestId: string, text: string) => unknown;
+    Stop?: (requestId: string) => unknown;
+    Copy?: (messageKey: string) => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface ChatWidgetOptions extends ChatOptions {
+    IsOpen?: boolean;
+    IsExpanded?: boolean;
+    UnreadCount?: number;
+    LauncherLabel?: string;
+    Position?: 'Viewport' | 'Container';
+    Placement?: 'BottomRight' | 'BottomLeft';
+    Offset?: number;
+    Color?: ComponentColor;
+}
+export interface ChatWidgetEvents extends ChatEvents {
+    OpenChanged?: (isOpen: boolean, reason: 'Launcher' | 'Close' | 'Escape') => unknown;
+    ExpandedChanged?: (isExpanded: boolean) => unknown;
+}
+export interface UploadManagerOptions {
+    UploadUrl: string;
+    Headers?: Record<string, string>;
+    FieldName?: string;
+    WithCredentials?: boolean;
+    Accept?: string;
+    MaxFiles?: number;
+    MaxFileSizeMB?: number;
+    ConcurrentUploads?: number;
+    IsDisabled?: boolean;
+}
+export interface ErrorEvents {
+    Error?: Callback<[message: string]>;
+}
+export interface UploadItem {
+    Key: string;
+    Name: string;
+    Size: number;
+    Status: "queued" | "uploading" | "uploaded" | "error" | "canceled";
+    Progress: number;
+    ErrorMessage: string;
+}
+export interface UploadManagerEvents extends ErrorEvents {
+    QueueChanged?: Callback<[queue: UploadItem[]]>;
+    Uploaded?: Callback<[key: string, name: string, responseText: string]>;
+}
+export interface TransferItem {
+    Key: string;
+    Label: string;
+    Description?: string;
+    IsDisabled?: boolean;
+}
+export interface TransferListOptions {
+    Items: TransferItem[];
+    SelectedKeys?: string[];
+    ShowSearch?: boolean;
+    IsDisabled?: boolean;
+    AvailableLabel?: string;
+    SelectedLabel?: string;
+}
+export interface TransferListEvents {
+    SelectionChanged?: Callback<[keys: string[]]>;
+}
+export interface TreeNode {
+    Key: string;
+    Label: string;
+    ParentKey?: string;
+    IsDisabled?: boolean;
+}
+export interface TreeSelectOptions {
+    Nodes: TreeNode[];
+    SelectedKeys?: string[];
+    IsMultiple?: boolean;
+    LeavesOnly?: boolean;
+    IsDisabled?: boolean;
+    Placeholder?: string;
+    AccessibleLabel?: string;
+    EmptyText?: string;
+}
+export interface TreeSelectEvents extends ErrorEvents {
+    SelectionChanged?: Callback<[keys: string[]]>;
+}
+export interface CascaderOptions {
+    /** Complete flat hierarchy. Keys must be unique; ParentKey references another item or is empty. */
+    Nodes: TreeNode[];
+    /** Controlled selected key. Assign OnSelectionChanged.Key back. */
+    SelectedKey?: string;
+    /** Requires selection of a leaf; otherwise branches can also be selected. */
+    LeavesOnly?: boolean;
+    /** Disables the picker. */
+    IsDisabled?: boolean;
+    /** Allows clearing the selection. */
+    IsClearable?: boolean;
+    /** Empty-selection prompt. */
+    Placeholder?: string;
+    /** Accessible name of the picker. */
+    AccessibleLabel?: string;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+}
+export interface CascaderEvents {
+    SelectionChanged?: (key: string, pathKeys: string[], pathLabels: string[]) => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface BluDashboardPanel {
+    /** Unique stable key matching a DashboardPanel instance. */
+    Key: string;
+    /** Panel heading. */
+    Title: string;
+    /** Width in grid columns; clamped to the canvas column count. */
+    ColumnSpan?: number;
+    /** Height in row units, from 1 to 12. */
+    RowSpan?: number;
+    /** Hides the panel without destroying its content. */
+    IsHidden?: boolean;
+}
+/** Arrange, resize and show or hide real component panels; serialize the layout for application-owned persistence. */
+export interface DashboardCanvasOptions {
+    /** Ordered panel definitions; echo OnLayoutChanged.LayoutJson back to this list. */
+    Panels: BluDashboardPanel[];
+    /** Desktop grid column count, 1 to 12. Default: 12. */
+    Columns?: number;
+    /** Grid row height in CSS pixels, 60 to 320. Default: 100. */
+    RowHeight?: number;
+    /** Shows layout editing controls. Default: True. */
+    AllowEditing?: boolean;
+    /** Disables layout changes. Default: False. */
+    IsDisabled?: boolean;
+    /** Echo the latest OnSaveRequested.RequestId after persistence finishes. Default: "". */
+    SaveResultRequestId?: string;
+    /** True accepts the submitted snapshot; False retains editable changes. Default: False. */
+    SaveResultSuccess?: boolean;
+    /** Success or failure feedback for the matching request. Default: "". */
+    SaveResultMessage?: string;
+    /** Change this value to reload the supplied data and discard local history when not saving. Default: "". */
+    ResetKey?: string;
+    /** Accessible component name; empty uses the component default. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional CSS classes on the Block root. Default: "". */
+    ExtendedClass?: string;
+    Content: Slot;
+}
+export interface DashboardCanvasEvents {
+    LayoutChanged?: (layout: BluDashboardPanel[]) => void | Promise<void>;
+    SaveRequested?: (requestId: string, layout: BluDashboardPanel[]) => void | Promise<void>;
+    Error?: (message: string) => void | Promise<void>;
+}
+export interface DashboardPanelOptions {
+    PanelKey: string;
+    Content: Slot;
+    ExtendedClass?: string;
+}
+export interface Command {
+    Key: string;
+    Label: string;
+    Description?: string;
+    Group?: string;
+    Keywords?: string;
+    Shortcut?: string;
+    IsDisabled?: boolean;
+}
+export interface CommandPaletteOptions {
+    Commands: Command[];
+    IsOpen?: boolean;
+    ShowTrigger?: boolean;
+    TriggerLabel?: string;
+    EnableShortcut?: boolean;
+    IsDisabled?: boolean;
+    EmptyText?: string;
+}
+export interface CommandPaletteEvents extends ErrorEvents {
+    OpenChanged?: Callback<[open: boolean]>;
+    Command?: Callback<[key: string]>;
+}
+export interface SplitterOptions {
+    PrimaryContent: Slot;
+    SecondaryContent: Slot;
+    PrimarySize?: number;
+    MinPrimarySize?: number;
+    MaxPrimarySize?: number;
+    IsVertical?: boolean;
+    IsCollapsible?: boolean;
+    IsCollapsed?: boolean;
+    IsDisabled?: boolean;
+    Height?: string;
+    PrimaryLabel?: string;
+    SecondaryLabel?: string;
+}
+export interface SplitterEvents extends ErrorEvents {
+    LayoutChanged?: Callback<[size: number, collapsed: boolean]>;
+}
+export interface TreeViewOptions {
+    Nodes: TreeNode[];
+    SelectedKey?: string;
+    InitialExpandedKeys?: string[];
+    AccessibleLabel?: string;
+    EmptyText?: string;
+    IsDisabled?: boolean;
+}
+export interface TreeViewEvents extends ErrorEvents {
+    SelectionChanged?: Callback<[key: string]>;
+    ExpandedChanged?: Callback<[keys: string[]]>;
+}
+export interface BluNotificationMessage {
+    /** Stable unique key. Reusing it updates a message. */
+    Key: string;
+    /** Message heading. */
+    Title: string;
+    /** Supporting message text. */
+    Description?: string;
+    /** Shared ComponentColor code. Error and Danger are assertively announced. */
+    Color?: string;
+    /** Visible seconds; default 0 stays until dismissed. Use a timed message only when its information is also available persistently. Pauses on hover and focus. */
+    Duration?: number;
+    /** Optional action caption; emits OnAction then dismisses. */
+    ActionLabel?: string;
+}
+export interface ModalOptions {
+    /** Controlled visibility. Assign OnOpenChanged.IsOpen back to this input. */
+    IsOpen?: boolean;
+    /** Visible heading and accessible dialog name. */
+    Title?: string;
+    /** Optional supporting text beneath the heading. */
+    Description?: string;
+    /** Small, Medium or Large. */
+    Size?: string;
+    /** Allows Escape to request closing. */
+    CloseOnEscape?: boolean;
+    /** Allows a click on the backdrop to request closing. */
+    CloseOnBackdrop?: boolean;
+    /** Shows a working state and disables Confirm. Close and Cancel remain available; Escape and backdrop follow their settings. Closing does not cancel background work. */
+    IsBusy?: boolean;
+    /** Displays footer content and the default actions. */
+    ShowFooter?: boolean;
+    /** Displays built-in Cancel and Confirm buttons. */
+    ShowDefaultActions?: boolean;
+    /** Built-in confirm caption. */
+    ConfirmLabel?: string;
+    /** Built-in cancel caption. */
+    CancelLabel?: string;
+    /** Optional business key emitted with Confirm. */
+    InstanceKey?: string;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+    Content?: Slot;
+    Footer?: Slot;
+}
+export interface ModalEvents {
+    OpenChanged?: (isOpen: boolean, reason: string) => unknown;
+    Confirm?: (key: string) => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface NotificationOptions {
+    /** Unique key used by Notification_Show, Notification_Update and Notification_Dismiss. Use one host per key. */
+    HostKey?: string;
+    /** TopRight, TopLeft, BottomRight or BottomLeft. */
+    Placement?: string;
+    /** Maximum visible messages (1–10). Older messages are dismissed when exceeded. */
+    MaxVisible?: number;
+    /** Accessible name of the message region. */
+    AccessibleLabel?: string;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+}
+export interface NotificationEvents {
+    Action?: (key: string) => unknown;
+    Dismissed?: (key: string, reason: string) => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface QRCodeOptions {
+    /** Text or URL to encode. Empty displays an empty state. */
+    Value?: string;
+    /** Code size including quiet zone, in CSS pixels (96–512). */
+    Size?: number;
+    /** L, M, Q or H error correction. */
+    ErrorCorrection?: string;
+    /** Active, Loading or Expired. */
+    Status?: string;
+    /** Displays SVG and PNG download controls when active. */
+    ShowDownload?: boolean;
+    /** Safe base filename for downloads. */
+    FileName?: string;
+    /** Accessible image label. Do not expose secret data in this caption. */
+    AccessibleLabel?: string;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+}
+export interface QRCodeEvents {
+    Refresh?: (key: string) => unknown;
+    Error?: (message: string) => unknown;
+}
+export interface BluTourStep {
+    /** Unique step identifier. */
+    Key: string;
+    /** Step heading. */
+    Title: string;
+    /** Step explanation. */
+    Description?: string;
+    /** Actual target DOM id. Empty or unavailable targets show a centered step. */
+    TargetId?: string;
+    /** Preferred placement: Bottom, Top, Left or Right; clamped to viewport. */
+    Placement?: string;
+}
+export interface TourOptions {
+    /** Ordered tour steps. Use actual widget Id values for TargetId. */
+    Steps: BluTourStep[];
+    /** Controlled visibility. Assign OnOpenChanged.IsOpen back. */
+    IsOpen?: boolean;
+    /** Controlled one-based step. Assign OnStepChanged.CurrentStep back. */
+    CurrentStep?: number;
+    /** Caption on the final step action. */
+    FinishLabel?: string;
+    /** Caption for ending before completion. */
+    SkipLabel?: string;
+    /** Additional CSS classes on the component root. */
+    ExtendedClass?: string;
+}
+export interface TourEvents {
+    OpenChanged?: (isOpen: boolean, reason: string) => unknown;
+    StepChanged?: (currentStep: number, key: string) => unknown;
+    Completed?: (key: string) => unknown;
+    Error?: (message: string) => unknown;
+}
+/** One ordered numeric observation. */
+export interface BluSparklinePoint {
+    Label?: string;
+    Value: number;
+}
+export interface SparklineOptions {
+    Points: BluSparklinePoint[];
+    Height?: number;
+    Color?: ComponentColor;
+    /** One soft five-second line glow; defaults to false. Respects reduced motion. */
+    AnimateGlow?: boolean;
+    ShowArea?: boolean;
+    ShowEndMarker?: boolean;
+    ShowDataTable?: boolean;
+    AccessibleLabel?: string;
+    SummaryText?: string;
+    EmptyText?: string;
+    ExtendedClass?: string;
+}
+export interface SparklineEvents {
+    Error?(message: string): unknown;
+}
+export interface AppLayoutOptions {
+    IsNavigationOpen?: boolean;
+    FitViewport?: boolean;
+    ShowFooter?: boolean;
+    AccessibleLabel?: string;
+    ExtendedClass?: string;
+    Header?: Slot;
+    Navigation: Slot;
+    Content: Slot;
+    Footer?: Slot;
+}
+export interface AppLayoutEvents extends SparklineEvents {
+    NavigationOpenChanged?(isOpen: boolean): unknown;
+}
+export interface PageLayoutOptions {
+    Variant?: "Standard" | "Aside" | "Workspace";
+    AsideWidth?: number;
+    ShowFooter?: boolean;
+    ExtendedClass?: string;
+    Header?: Slot;
+    Content: Slot;
+    Aside?: Slot;
+    Footer?: Slot;
+}
+export interface BluInboxItem {
+    /** Unique notification key. */
+    Key: string;
+    /** Notification heading. */
+    Title: string;
+    /** Plain-text message body. */
+    Description?: string;
+    /** Optional category used by the filter. */
+    Category?: string;
+    /** ISO 8601 date/time including timezone; empty hides the timestamp. */
+    Timestamp?: string;
+    /** Shared ComponentColor code, such as Primary, Success or Warning. */
+    Color?: ComponentColor;
+    /** Whether this notification has been read. */
+    IsRead?: boolean;
+    /** Whether this notification is archived. */
+    IsArchived?: boolean;
+    /** Optional action button caption; OnAction returns this item key. */
+    ActionLabel?: string;
+}
+/** A notification inbox with unread count, search, categories, archive actions and optional bell popover. */
+export interface NotificationCenterOptions {
+    /** Application-owned notifications; echo OnItemsChanged.ItemsJson back after local changes. */
+    Items: BluInboxItem[];
+    /** Popover renders a bell and anchored inbox; Inline renders the full inbox. Default: "Popover". */
+    DisplayMode?: string;
+    /** Requested popover visibility; echo OnOpenChanged.IsOpen back. Default: False. */
+    IsOpen?: boolean;
+    /** Shows loading feedback and prevents repeated load requests. Default: False. */
+    IsLoading?: boolean;
+    /** Displays Load more; the application supplies additional records. Default: False. */
+    HasMore?: boolean;
+    /** Disables inbox mutation and action controls. Default: False. */
+    IsDisabled?: boolean;
+    /** Inbox heading. Default: "Notifications". */
+    Title?: string;
+    /** Accessible component name; empty uses the component default. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional CSS classes on the Block root. Default: "". */
+    ExtendedClass?: string;
+}
+export interface NotificationCenterEvents {
+    ItemsChanged?: (items: BluInboxItem[], key: string, reason: string) => void | Promise<void>;
+    OpenChanged?: (isOpen: boolean) => void | Promise<void>;
+    Action?: (key: string) => void | Promise<void>;
+    LoadMore?: (loadedCount: number) => void | Promise<void>;
+    Error?: (message: string) => void | Promise<void>;
+}
+/** Responsive self-hosted video with themed controls, captions and optional viewing analytics. */
+export interface VideoPlayerOptions {
+    /** Shared color for video buttons, timeline and volume: ComponentColor name or #RGB/#RRGGBB. Default: Primary. */
+    ControlColor?: ComponentColor | `#${string}`;
+    /** Show a subtle frosted overlay while paused; hidden during playback. Default: True. */
+    ShowPauseGlass?: boolean;
+    /** Self-hosted video URL. Metadata is loaded for the controls; playback starts only on user action. Default: "". */
+    SourceUrl?: string;
+    /** Image shown before playback. Default: "". */
+    PosterUrl?: string;
+    /** WebVTT captions URL; cross-origin media requires the appropriate CORS response. Default: "". */
+    CaptionsUrl?: string;
+    /** BCP 47 language code for the captions. Default: "en". */
+    CaptionLanguage?: string;
+    /** Accessible player and lightbox title. Default: "Video". */
+    Title?: string;
+    /** Repeat after playback ends; no automatic playback on page load. Default: False. */
+    IsLooping?: boolean;
+    /** Initial muted state. Player controls allow changing it. Default: False. */
+    IsMuted?: boolean;
+    /** Positive width / height ratio of the media frame. Default: "16 / 9". */
+    AspectRatio?: string;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+    /** Use rounded corners on the video frame. Square by default. Default: False. */
+    IsRounded?: boolean;
+    /** Stable application-owned media identifier included in viewing events. Default: "". */
+    MediaId?: string;
+    /** Show the supplied aggregate viewing curve on hover or keyboard focus. Default: False. */
+    ShowViewingHeatmap?: boolean;
+    /** Ordered non-overlapping aggregate ranges, up to 500. The host stores and calculates these. */
+    ViewingHeatmap?: BluVideoHeatmapBin[];
+    /** Display picture-in-picture when the browser supports it. Default: True. */
+    AllowPictureInPicture?: boolean;
+}
+export interface VideoPlayerEvents {
+    /** Synchronously invoked before cleanup on Destroy. Async persistence is not awaited; also handle Hidden/Progress. */
+    ViewingActivity?: (activity: BluVideoViewingActivity) => void | Promise<void>;
+    PlaybackChanged?: (state: string) => void | Promise<void>;
+    Error?: (message: string) => void | Promise<void>;
+}
+/** Open a video from a poster or compact play control; closing pauses playback and restores focus. */
+export interface VideoLightboxOptions {
+    /** Shared color for video buttons, timeline and volume: ComponentColor name or #RGB/#RRGGBB. Default: Primary. */
+    ControlColor?: ComponentColor | `#${string}`;
+    /** Show a subtle frosted overlay while paused; hidden during playback. Default: True. */
+    ShowPauseGlass?: boolean;
+    /** Self-hosted video URL. Metadata is loaded for the controls; playback starts only on user action. Default: "". */
+    SourceUrl?: string;
+    /** Image shown before playback. Default: "". */
+    PosterUrl?: string;
+    /** WebVTT captions URL; cross-origin media requires the appropriate CORS response. Default: "". */
+    CaptionsUrl?: string;
+    /** BCP 47 language code for the captions. Default: "en". */
+    CaptionLanguage?: string;
+    /** Accessible player and lightbox title. Default: "Video". */
+    Title?: string;
+    /** Repeat after playback ends; no automatic playback on page load. Default: False. */
+    IsLooping?: boolean;
+    /** Initial muted state. Player controls allow changing it. Default: False. */
+    IsMuted?: boolean;
+    /** Positive width / height ratio of the media frame. Default: "16 / 9". */
+    AspectRatio?: string;
+    /** Controlled open state; echo OnOpenChanged.IsOpen. Default: False. */
+    IsOpen?: boolean;
+    /** Visible play button label. Default: "Watch the film". */
+    PlayLabel?: string;
+    /** Display the poster behind the play control. Default: True. */
+    ShowPoster?: boolean;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+    /** Use rounded corners on the video frame. Square by default. Default: False. */
+    IsRounded?: boolean;
+    /** Stable application-owned media identifier included in viewing events. Default: "". */
+    MediaId?: string;
+    /** Show the supplied aggregate viewing curve on hover or keyboard focus. Default: False. */
+    ShowViewingHeatmap?: boolean;
+    /** Ordered non-overlapping aggregate ranges, up to 500. The host stores and calculates these. */
+    ViewingHeatmap?: BluVideoHeatmapBin[];
+    /** Display picture-in-picture when the browser supports it. Default: True. */
+    AllowPictureInPicture?: boolean;
+}
+export interface VideoLightboxEvents {
+    PlaybackChanged?: (state: string) => void | Promise<void>;
+    /** Incremental checkpoint; Closed and Destroy include the final known position. */
+    ViewingActivity?: (activity: BluVideoViewingActivity) => void | Promise<void>;
+    OpenChanged?: (isOpen: boolean) => void | Promise<void>;
+    Error?: (message: string) => void | Promise<void>;
+}
+/** Responsive cropped photography with optional zoom, caption and an accessible enlarged view. */
+export interface MediaImageOptions {
+    /** Image URL, including a same-origin resource path. Default: "". */
+    ImageUrl?: string;
+    /** Alternative text; empty marks a decorative image. Default: "". */
+    ImageDescription?: string;
+    /** CSS object position, for example 30% 50%; image always covers its frame. Default: "50% 50%". */
+    FocalPoint?: string;
+    /** Positive width / height ratio. Default: "4 / 3". */
+    AspectRatio?: string;
+    /** Gentle hover zoom; suppressed for reduced motion. Default: True. */
+    EnableZoom?: boolean;
+    /** Adds a keyboard-accessible image enlargement button. Default: False. */
+    AllowEnlarge?: boolean;
+    /** Optional visible image caption. Default: "". */
+    Caption?: string;
+    /** Use eager loading for an image above the fold. Default: False. */
+    IsEager?: boolean;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+}
+export interface MediaImageEvents {
+    Error?: (message: string) => void | Promise<void>;
+}
+/** An image-led content card with below-image or overlay copy and an optional destination. */
+export interface MediaCardOptions {
+    /** Image URL, including a same-origin resource path. Default: "". */
+    ImageUrl?: string;
+    /** Alternative text; empty marks a decorative image. Default: "". */
+    ImageDescription?: string;
+    /** CSS object position, for example 30% 50%; image always covers its frame. Default: "50% 50%". */
+    FocalPoint?: string;
+    /** Short category above the title. Default: "". */
+    Eyebrow?: string;
+    /** Card heading. Default: "Card title". */
+    Title?: string;
+    /** Supporting plain text. Default: "". */
+    Description?: string;
+    /** Visible action caption when Url is supplied. Default: "Explore". */
+    ActionLabel?: string;
+    /** Optional destination; relative, HTTP(S) and fragment links are supported. Default: "". */
+    Url?: string;
+    /** Below or Overlay. Default: "Below". */
+    Variant?: "Below" | "Overlay";
+    /** Positive width / height ratio. Default: "4 / 3". */
+    AspectRatio?: string;
+    /** Gentle image zoom on pointer hover and keyboard focus. Default: True. */
+    EnableZoom?: boolean;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+    /** Consumer-owned content, preserved during updates. */
+    Content?: Slot;
+}
+export interface MediaCardEvents {
+    Error?: (message: string) => void | Promise<void>;
+}
+/** Compare two images with an accessible range control, pointer dragging and step buttons. */
+export interface ImageCompareOptions {
+    /** Before image URL. Default: "". */
+    BeforeUrl?: string;
+    /** After image URL. Default: "". */
+    AfterUrl?: string;
+    /** Visible and accessible before label. Default: "Before". */
+    BeforeLabel?: string;
+    /** Visible and accessible after label. Default: "After". */
+    AfterLabel?: string;
+    /** Description of the images being compared. Default: "Image comparison". */
+    ImageDescription?: string;
+    /** Divider percentage, from 0 to 100; echo OnPositionChanged.Position. Default: 50. */
+    Position?: number;
+    /** Horizontal or Vertical divider movement. Default: "Horizontal". */
+    Orientation?: "Horizontal" | "Vertical";
+    /** Positive width / height ratio. Default: "16 / 9". */
+    AspectRatio?: string;
+    /** Disables divider interaction. Default: False. */
+    IsDisabled?: boolean;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+}
+export interface ImageCompareEvents {
+    PositionChanged?: (position: number) => void | Promise<void>;
+    Error?: (message: string) => void | Promise<void>;
+}
+/** Emphasized text with a marker, underline, circle or hand-drawn accent. */
+export interface TextHighlightOptions {
+    /** Text to highlight. Default: "Something worth noticing". */
+    Text?: string;
+    /** Marker, Half, Underline, Circle or Scribble. Default: "Marker". */
+    Style?: "Marker" | "Half" | "Underline" | "Circle" | "Scribble";
+    /** Shared ComponentColor code. Default: "Primary". */
+    Color?: ComponentColor;
+    /** Draw the accent once when it enters view; reduced motion skips animation. Default: False. */
+    IsAnimated?: boolean;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+}
+export interface TextHighlightEvents {
+    Error?: (message: string) => void | Promise<void>;
+}
+/** A responsive horizontal strip of arbitrary content with swipe, arrows and position indicators. */
+export interface ContentCarouselOptions {
+    /** Desktop items per viewport, from 1 to 6; adapts to smaller containers. Default: 3. */
+    ItemsVisible?: number;
+    /** Space between items in CSS pixels, from 0 to 64. Default: 24. */
+    Gap?: number;
+    /** Display previous and next buttons. Default: True. */
+    ShowArrows?: boolean;
+    /** Display a position indicator and progress track. Default: True. */
+    ShowIndicators?: boolean;
+    /** Leave part of the next item visible. Default: True. */
+    PeekNext?: boolean;
+    /** Zero-based requested first item; echo OnIndexChanged.Index. Default: 0. */
+    ActiveIndex?: number;
+    /** Accessible label prefix for slide positions. Default: "Item". */
+    ItemLabel?: string;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+    /** Consumer-owned content, preserved during updates. */
+    Content?: Slot;
+}
+export interface ContentCarouselEvents {
+    IndexChanged?: (index: number) => void | Promise<void>;
+    Error?: (message: string) => void | Promise<void>;
+}
+/** A portrait, role and biography with an optional accessible expanded profile. */
+export interface ProfileCardOptions {
+    /** Image URL, including a same-origin resource path. Default: "". */
+    ImageUrl?: string;
+    /** Alternative text; empty marks a decorative image. Default: "". */
+    ImageDescription?: string;
+    /** CSS object position, for example 30% 50%; image always covers its frame. Default: "50% 50%". */
+    FocalPoint?: string;
+    /** Person name. Default: "Alex Morgan". */
+    Name?: string;
+    /** Person role. Default: "Creative director". */
+    Role?: string;
+    /** Plain-text biography. Default: "". */
+    Biography?: string;
+    /** Below or Overlay. Default: "Below". */
+    Variant?: "Below" | "Overlay";
+    /** Show Read profile when a biography is supplied. Default: True. */
+    AllowExpand?: boolean;
+    /** Optional full profile destination. Default: "". */
+    ProfileUrl?: string;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+    /** Consumer-owned content, preserved during updates. */
+    Links?: Slot;
+}
+export interface ProfileCardEvents {
+    Error?: (message: string) => void | Promise<void>;
+}
+/** A testimonial with clear attribution, optional portrait and rating. */
+export interface QuoteCardOptions {
+    /** Testimonial text. Default: "Good work starts with a conversation.". */
+    Quote?: string;
+    /** Attribution name. Default: "Alex Morgan". */
+    Name?: string;
+    /** Attribution role or company. Default: "". */
+    Role?: string;
+    /** Optional portrait URL. Default: "". */
+    AvatarUrl?: string;
+    /** Optional organization logo. Default: "". */
+    LogoUrl?: string;
+    /** Optional rating from 1 to 5; zero hides the rating. Default: 0. */
+    Rating?: number;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+}
+export interface QuoteCardEvents {
+    Error?: (message: string) => void | Promise<void>;
+}
+/** Responsive grid, staggered or masonry presentation for arbitrary native or web content. */
+export interface CollectionLayoutOptions {
+    /** Grid, Staggered or Masonry. Reading order always follows content order. Default: "Grid". */
+    Variant?: "Grid" | "Staggered" | "Masonry";
+    /** Maximum desktop columns, from 1 to 6. Default: 3. */
+    Columns?: number;
+    /** Space between items in CSS pixels, from 0 to 64. Default: 24. */
+    Gap?: number;
+    /** Minimum desired card width; smaller containers automatically reduce columns. Default: 240. */
+    MinItemWidth?: number;
+    /** Smoothly move Masonry items during reflow. Respects reduced motion; Grid and Staggered are unchanged. Default: true. */
+    AnimateResize?: boolean;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+    /** Consumer-owned content, preserved during updates. */
+    Content?: Slot;
+}
+export interface CollectionLayoutEvents {
+    Error?: (message: string) => void | Promise<void>;
+}
+/** A full-width, cover-image hero with focal-point cropping, readable overlay and native content slots. */
+export interface HeroSectionOptions {
+    /** Image URL, including a same-origin resource path. Default: "". */
+    ImageUrl?: string;
+    /** Alternative text; empty marks a decorative image. Default: "". */
+    ImageDescription?: string;
+    /** CSS object position, for example 30% 50%; image always covers its frame. Default: "50% 50%". */
+    FocalPoint?: string;
+    /** Small introductory label. Default: "". */
+    Eyebrow?: string;
+    /** Main hero heading. Default: "Ideas made extraordinary.". */
+    Title?: string;
+    /** Supporting copy. Default: "". */
+    Description?: string;
+    /** Minimum height in CSS pixels; content may increase it. Default: 640. */
+    MinHeight?: number;
+    /** Dark overlay strength from 0 to 90; choose sufficient contrast for your image. Default: 55. */
+    OverlayOpacity?: number;
+    /** Left or Center. Default: "Left". */
+    Alignment?: "Left" | "Center";
+    /** Center or Bottom. Default: "Center". */
+    VerticalAlignment?: "Center" | "Bottom";
+    /** Semantic heading level, 1 to 6. Default: 1. */
+    HeadingLevel?: number;
+    /** Wide or Narrow content measure. Default: "Wide". */
+    ContentWidth?: "Wide" | "Narrow";
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+    /** Consumer-owned content, preserved during updates. */
+    Navigation?: Slot;
+    /** Consumer-owned content, preserved during updates. */
+    Actions?: Slot;
+    /** Consumer-owned content, preserved during updates. */
+    Content?: Slot;
+}
+export interface HeroSectionEvents {
+    Error?: (message: string) => void | Promise<void>;
+}
+/** An editorial media-and-copy section with reversible order and responsive stacking. */
+export interface SplitSectionOptions {
+    /** Small section label. Default: "". */
+    Eyebrow?: string;
+    /** Section heading. Default: "A different perspective.". */
+    Title?: string;
+    /** Supporting copy. Default: "". */
+    Description?: string;
+    /** Left or Right; DOM reading order remains meaningful. Default: "Left". */
+    MediaSide?: "Left" | "Right";
+    /** Default, Muted or Contrast. Default: "Default". */
+    Surface?: "Default" | "Muted" | "Contrast";
+    /** Semantic heading level, 1 to 6. Default: 2. */
+    HeadingLevel?: number;
+    /** Compact or Comfortable section padding. Default: "Comfortable". */
+    Spacing?: "Compact" | "Comfortable";
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+    /** Consumer-owned content, preserved during updates. */
+    Media?: Slot;
+    /** Consumer-owned content, preserved during updates. */
+    Content?: Slot;
+    /** Consumer-owned content, preserved during updates. */
+    Actions?: Slot;
+}
+export interface SplitSectionEvents {
+    Error?: (message: string) => void | Promise<void>;
+}
+export interface BluLogoItem {
+    /** Unique stable logo key. */
+    Key: string;
+    /** Organization name; used as the accessible label. */
+    Name: string;
+    /** Logo image URL. Empty renders the organization name. */
+    ImageUrl?: string;
+    /** Optional image for Dark mode; empty uses ImageUrl. */
+    DarkImageUrl?: string;
+    /** Optional destination URL. */
+    Url?: string;
+}
+/** A responsive collection of organization logos with optional destinations. */
+export interface LogoCloudOptions {
+    /** Ordered logo records; every logo needs a meaningful Name. */
+    Items: BluLogoItem[];
+    /** Optional section caption. Default: "Trusted by ambitious teams". */
+    Title?: string;
+    /** Maximum columns, from 2 to 8. Default: 5. */
+    Columns?: number;
+    /** Render logos in grayscale without changing source assets. Default: False. */
+    IsMonochrome?: boolean;
+    /** Maximum logo height in CSS pixels, from 20 to 80. Default: 40. */
+    LogoHeight?: number;
+    /** Optional accessible name; empty uses a sensible component label. Default: "". */
+    AccessibleLabel?: string;
+    /** Additional classes on the component root. Default: "". */
+    ExtendedClass?: string;
+}
+export interface LogoCloudEvents {
+    Error?: (message: string) => void | Promise<void>;
+}
+export interface PickerOptions extends CommonOptions {
+    Label?: string;
+    IsDisabled?: boolean;
+    IsReadOnly?: boolean;
+    IsRequired?: boolean;
+    Placeholder?: string;
+    ShowClear?: boolean;
+    /** Inclusive bounds, in the same stored format as Value. */
+    Min?: string;
+    Max?: string;
+}
+/** Calendar date strings are YYYY-MM-DD; local date-times are YYYY-MM-DDTHH:mm. */
+export interface BluDisabledDate {
+    Date: string;
+}
+export interface CalendarOptions {
+    Locale?: string;
+    DateFormat?: 'YYYY-MM-DD' | 'MM/DD/YYYY' | 'DD/MM/YYYY';
+    /** Sunday=0, Monday=1. Default 1. */
+    FirstDayOfWeek?: number;
+    ShowToday?: boolean;
+    DisabledDates?: BluDisabledDate[];
+}
+export interface DatePickerOptions extends PickerOptions, CalendarOptions {
+    Value?: string;
+}
+export interface PickerEvents {
+    Change?: Callback<[value: string]>;
+    ValidationChanged?: Callback<[isValid: boolean, message: string]>;
+    OpenChanged?: Callback<[isOpen: boolean]>;
+    Error?: Callback<[message: string]>;
+}
+export interface ClockOptions {
+    HourCycle?: 12 | 24;
+    /** 1–60. Controls offered minute choices; typed off-interval values are preserved. */
+    MinuteStep?: number;
+}
+export interface TimePickerOptions extends PickerOptions, ClockOptions {
+    Value?: string;
+}
+export interface DateTimePickerOptions extends PickerOptions, CalendarOptions, ClockOptions {
+    Value?: string;
+}
+export interface BluDateRangePreset {
+    Label: string;
+    StartDate: string;
+    EndDate: string;
+}
+export interface DateRangePickerOptions extends PickerOptions, CalendarOptions {
+    StartDate?: string;
+    EndDate?: string;
+    Presets?: BluDateRangePreset[];
+    /** Inclusive number of calendar days. Zero means no additional limit. */
+    MinRangeDays?: number;
+    MaxRangeDays?: number;
+}
+export interface DateRangePickerEvents extends Omit<PickerEvents, 'Change'> {
+    Change?: Callback<[startDate: string, endDate: string]>;
+}
+export type FontPreset = 'System sans' | 'System serif' | 'System monospace' | 'Inter' | 'Roboto' | 'Source Sans 3' | 'DM Sans' | 'Manrope' | 'Montserrat' | 'Lora' | 'Merriweather' | 'Playfair Display' | 'IBM Plex Mono' | 'JetBrains Mono' | 'Custom';
+/** Additional custom font weights, italics or Unicode subsets. Role must use Custom. */
+export interface BluFontFace {
+    Role: 'Body' | 'Heading';
+    Url: string;
+    Weight?: string;
+    Style?: 'normal' | 'italic' | 'oblique';
+    UnicodeRange?: string;
+}
+export interface FontProviderOptions extends CommonOptions {
+    BodyFont?: FontPreset;
+    HeadingFont?: FontPreset | 'Inherit';
+    BodyFontFamily?: string;
+    HeadingFontFamily?: string;
+    BodyFontUrl?: string;
+    HeadingFontUrl?: string;
+    /** CSS weight descriptor: e.g. 400 for static or 100 900 for a variable file. */
+    BodyFontWeight?: string;
+    HeadingFontWeight?: string;
+    BodyFallback?: string;
+    HeadingFallback?: string;
+    FontFaces?: BluFontFace[];
+    Scope?: 'Page' | 'Container';
+    /** Container scope uses this element ID, or its Content slot when empty. */
+    TargetId?: string;
+    Content?: Slot;
+    /** Defaults to the package's bundled fonts directory. Copy that directory when bundling. */
+    PresetBaseUrl?: string;
+}
+export interface FontProviderEvents {
+    Loaded?: Callback<[bodyFamily: string, headingFamily: string]>;
+    Error?: Callback<[message: string]>;
+}
+export interface ShapeMaskOptions extends CommonOptions {
+    Content: Slot;
+    Shape?: 'None' | 'Circle' | 'Oval' | 'Diamond' | 'Hexagon' | 'Arch' | 'Organic' | 'Custom';
+    /** SVG or image alpha mask. Relative or HTTP(S), including OutSystems Resource URLs. */
+    MaskUrl?: string;
+    AspectRatio?: string;
+    MaskSize?: number;
+    PositionX?: number;
+    PositionY?: number;
+    Rotation?: number;
+    FlipHorizontal?: boolean;
+    FlipVertical?: boolean;
+    Animation?: 'None' | 'Reveal' | 'Zoom';
+    AnimationDuration?: number;
+    /** Change to replay the finite effect. Reduced motion always overrides it. */
+    AnimationKey?: string;
+}
+export interface ShapeMaskEvents {
+    Loaded?: Callback<[url: string]>;
+    Error?: Callback<[message: string]>;
+}
+export interface EmptyStateEvents {
+    Error?: (message: string) => unknown;
+}
+/** One aggregated viewing range. Ranges must be ordered and not overlap. */
+export interface BluVideoHeatmapBin {
+    StartSeconds: number;
+    EndSeconds: number;
+    Views: number;
+}
+export interface BluVideoWatchedSegment {
+    StartSeconds: number;
+    EndSeconds: number;
+}
+/** Incremental playback checkpoint. Deduplicate by SessionId + Sequence before aggregation. */
+export interface BluVideoViewingActivity {
+    Version: 1;
+    SessionId: string;
+    Sequence: number;
+    MediaId: string;
+    Reason: "Paused" | "Ended" | "Seek" | "Progress" | "Hidden" | "SourceChanged" | "Closed" | "Destroy";
+    PositionSeconds: number;
+    /** Zero until a finite duration is known. */
+    DurationSeconds: number;
+    /** Played ranges since the previous checkpoint. Seeking gaps are excluded. */
+    Segments: BluVideoWatchedSegment[];
+}