@vobs/ui 0.3.0 → 1.1.0

package/dist/data-display.d.ts

@@ -1,1094 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/ui
- */
-import { type UiAttributes, type UiButtonVariant, type UiControlSize, type UiDomPlan } from './primitives.js';
-export type BadgeTone = 'brand' | 'neutral' | 'success' | 'warning' | 'error';
-export type TagTone = 'brand' | 'danger' | 'neutral' | 'success' | 'warning';
-export type TagVariant = 'chip' | 'tag';
-export type NoteTone = 'error' | 'info' | 'success' | 'warning';
-export type PanelTone = 'default' | 'elevated' | 'subtle';
-export type ProgressStatus = 'idle' | 'success' | 'warning' | 'error';
-export type TypographyVariant = 'body' | 'body-sm' | 'caption' | 'code' | 'heading-lg' | 'heading-md' | 'heading-sm' | 'link' | 'muted';
-export type TypographyRichContentSource = 'markdown' | 'rich-text';
-export type TypographyRichContentDensity = 'comfortable' | 'compact';
-export type TypographyRichContentState = 'empty' | 'ready';
-export type TypographyRichContentBlockKind = 'code' | 'heading' | 'list' | 'paragraph' | 'quote' | 'table';
-export type DividerOrientation = 'horizontal' | 'vertical';
-export type DividerSectionHeadingLevel = 2 | 3 | 4;
-export type DividerSectionHeadingState = 'current' | 'idle';
-export type ShortcutPlatform = 'generic' | 'linux' | 'macos' | 'windows';
-export type ShortcutDisplayState = 'aliased' | 'empty' | 'ready';
-export type NoteRichContentKind = 'callout' | 'note';
-export type NoteRichContentState = 'empty' | 'ready';
-export type NoteRichContentControlState = 'disabled' | 'hidden' | 'ready';
-export type PanelCardKind = 'card' | 'panel';
-export type PanelCardMediaState = 'empty' | 'ready';
-export type PanelCardMediaPlacement = 'start' | 'top';
-export type PanelCardActionState = 'disabled' | 'hidden' | 'ready';
-export type PanelCardSelectionState = 'idle' | 'selected';
-export type ListGroupedState = 'empty' | 'grouped' | 'partial' | 'plain';
-export type ListGroupSelectionState = 'all' | 'empty' | 'none' | 'partial';
-export type ListItemActionState = 'disabled' | 'hidden' | 'ready';
-export type CarouselState = 'empty' | 'ready';
-export type CarouselPlaybackState = 'paused' | 'playing';
-export type CarouselNavigationState = 'disabled' | 'ready';
-export type AvatarSize = 'lg' | 'md' | 'sm';
-export type AvatarStatus = 'away' | 'busy' | 'offline' | 'online';
-export type AvatarImageState = 'empty' | 'error' | 'fallback' | 'loaded' | 'loading';
-export type AvatarPresenceSource = 'manual' | 'realtime' | 'sync' | 'unknown';
-export type AvatarCacheState = 'hit' | 'miss' | 'stale' | 'unbound';
-export type PaginationItemKind = 'ellipsis' | 'page';
-export type ListSelectionMode = 'multiple' | 'none' | 'single';
-export type TableDensity = 'comfortable' | 'compact';
-export type TableSortDirection = 'ascending' | 'descending' | 'none';
-export type TableToolbarDataMode = 'local' | 'remote';
-export type TableColumnPreferenceState = 'customized' | 'default' | 'empty';
-export type TableToolbarState = 'empty' | 'filtered' | 'loading' | 'ready' | 'selected';
-export type TableCellRenderKind = 'action' | 'custom' | 'number' | 'status' | 'text';
-export type TableCellState = 'disabled' | 'error' | 'interactive' | 'loading' | 'readonly';
-export type TableBatchActionState = 'available' | 'disabled' | 'hidden' | 'pending';
-export type TableSelectionSummaryState = 'all' | 'empty' | 'partial';
-export type DataToolbarActionTone = 'danger' | 'primary' | 'secondary';
-export type DataToolbarDensity = 'comfortable' | 'compact';
-export type FilterChipTone = 'brand' | 'danger' | 'neutral' | 'success' | 'warning';
-export type SplitWorkspaceAreaRole = 'auxiliary' | 'inspector' | 'primary' | 'secondary';
-export type SplitWorkspaceTabletFallback = 'collapse' | 'drawer' | 'keep' | 'master-detail' | 'stack' | 'tabs';
-export type ResultStatus = 'empty' | 'error' | 'info' | 'success' | 'warning';
-export type StatTrendDirection = 'down' | 'flat' | 'up';
-export type LoadingOverlayMode = 'blocking' | 'inline';
-export interface TableColumn {
-    readonly id: string;
-    readonly label?: string;
-    readonly align?: 'center' | 'end' | 'start';
-    readonly width?: string;
-    readonly minWidth?: string;
-    readonly sticky?: 'end' | 'start';
-    readonly sortable?: boolean;
-    readonly sortDirection?: TableSortDirection;
-    readonly hidden?: boolean;
-}
-export interface TableRow {
-    readonly id: string;
-    readonly selected?: boolean;
-    readonly checked?: boolean;
-    readonly disabled?: boolean;
-    readonly expanded?: boolean;
-}
-export interface TablePlans {
-    readonly root: UiDomPlan<'table'>;
-    readonly caption: UiDomPlan<'caption'> | undefined;
-    readonly selectionHeader: UiDomPlan<'th'> | undefined;
-    readonly headers: readonly UiDomPlan<'th'>[];
-    readonly rows: readonly UiDomPlan<'tr'>[];
-    readonly selectionCells: readonly UiDomPlan<'td'>[];
-    readonly cells: readonly UiDomPlan<'td'>[];
-}
-export interface TablePlanOptions {
-    readonly id?: string;
-    readonly columns: readonly TableColumn[];
-    readonly rows: readonly TableRow[];
-    readonly captionId?: string;
-    readonly selectable?: boolean;
-    readonly density?: TableDensity;
-    readonly stickyHeader?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface FilterChipItem {
-    readonly id: string;
-    readonly label: string;
-    readonly value?: string;
-    readonly active?: boolean;
-    readonly removable?: boolean;
-    readonly disabled?: boolean;
-    readonly tone?: FilterChipTone;
-}
-export interface FilterBarPlanOptions {
-    readonly id?: string;
-    readonly filters: readonly FilterChipItem[];
-    readonly label?: string;
-    readonly density?: DataToolbarDensity;
-    readonly clearLabel?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface FilterBarPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly chips: readonly UiDomPlan<'button'>[];
-    readonly clear: UiDomPlan<'button'> | undefined;
-}
-export interface DataToolbarAction {
-    readonly id: string;
-    readonly label: string;
-    readonly tone?: DataToolbarActionTone;
-    readonly disabled?: boolean;
-    readonly pressed?: boolean;
-}
-export interface DataToolbarPlanOptions {
-    readonly id?: string;
-    readonly searchValue?: string;
-    readonly searchPlaceholder?: string;
-    readonly searchLabel?: string;
-    readonly filters?: readonly FilterChipItem[];
-    readonly actions?: readonly DataToolbarAction[];
-    readonly totalCount?: number;
-    readonly filteredCount?: number;
-    readonly selectedCount?: number;
-    readonly density?: DataToolbarDensity;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface DataToolbarPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly search: UiDomPlan<'input'> | undefined;
-    readonly filterBar: FilterBarPlans;
-    readonly summary: UiDomPlan<'output'>;
-    readonly actions: readonly UiDomPlan<'button'>[];
-}
-export interface TableToolbarStateContractOptions {
-    readonly mode?: TableToolbarDataMode;
-    readonly query?: string;
-    readonly filters?: readonly FilterChipItem[];
-    readonly sortColumnId?: string;
-    readonly sortDirection?: TableSortDirection;
-    readonly selectedIds?: ReadonlySet<string> | readonly string[];
-    readonly totalCount?: number;
-    readonly filteredCount?: number;
-    readonly loading?: boolean;
-}
-export interface TableToolbarStateContract {
-    readonly mode: TableToolbarDataMode;
-    readonly state: TableToolbarState;
-    readonly query: string;
-    readonly activeFilterIds: readonly string[];
-    readonly activeFilterCount: number;
-    readonly sortColumnId: string;
-    readonly sortDirection: TableSortDirection;
-    readonly selectedIds: readonly string[];
-    readonly selectedCount: number;
-    readonly totalCount: number | undefined;
-    readonly filteredCount: number | undefined;
-    readonly summary: string;
-    readonly attrs: UiAttributes;
-}
-export interface TableColumnPreferenceStateContractOptions {
-    readonly columns: readonly TableColumn[];
-    readonly visibleIds?: readonly string[];
-    readonly hiddenIds?: readonly string[];
-    readonly orderIds?: readonly string[];
-    readonly stickyStartIds?: readonly string[];
-    readonly stickyEndIds?: readonly string[];
-    readonly density?: TableDensity;
-    readonly defaultDensity?: TableDensity;
-}
-export interface TableColumnPreferenceColumnContract {
-    readonly id: string;
-    readonly label: string;
-    readonly visible: boolean;
-    readonly order: number;
-    readonly sticky: 'end' | 'start' | undefined;
-    readonly attrs: UiAttributes;
-}
-export interface TableColumnPreferenceStateContract {
-    readonly state: TableColumnPreferenceState;
-    readonly density: TableDensity;
-    readonly columnCount: number;
-    readonly visibleCount: number;
-    readonly hiddenCount: number;
-    readonly orderedIds: readonly string[];
-    readonly visibleIds: readonly string[];
-    readonly hiddenIds: readonly string[];
-    readonly stickyStartIds: readonly string[];
-    readonly stickyEndIds: readonly string[];
-    readonly columns: readonly TableColumn[];
-    readonly columnContracts: readonly TableColumnPreferenceColumnContract[];
-    readonly attrs: UiAttributes;
-}
-export interface TableCellStateContractOptions {
-    readonly rowId: string;
-    readonly columnId: string;
-    readonly kind?: TableCellRenderKind;
-    readonly intent?: string;
-    readonly value?: number | string;
-    readonly label?: string;
-    readonly tone?: BadgeTone;
-    readonly interactive?: boolean;
-    readonly disabled?: boolean;
-    readonly loading?: boolean;
-    readonly error?: boolean;
-    readonly truncate?: boolean;
-    readonly describedBy?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface TableCellStateContract {
-    readonly rowId: string;
-    readonly columnId: string;
-    readonly kind: TableCellRenderKind;
-    readonly state: TableCellState;
-    readonly intent: string;
-    readonly attrs: UiAttributes;
-}
-export interface TableBatchActionItem {
-    readonly id: string;
-    readonly label: string;
-    readonly tone?: DataToolbarActionTone;
-    readonly requiresSelection?: boolean;
-    readonly disabled?: boolean;
-    readonly hidden?: boolean;
-    readonly pending?: boolean;
-    readonly reason?: string;
-}
-export interface TableBatchActionContract {
-    readonly id: string;
-    readonly label: string;
-    readonly state: TableBatchActionState;
-    readonly reason: string;
-    readonly attrs: UiAttributes;
-}
-export interface TableBatchActionStateContractOptions {
-    readonly selectedIds?: ReadonlySet<string> | readonly string[];
-    readonly totalCount?: number;
-    readonly eligibleCount?: number;
-    readonly actions?: readonly TableBatchActionItem[];
-}
-export interface TableBatchActionStateContract {
-    readonly selectionState: TableSelectionSummaryState;
-    readonly selectedIds: readonly string[];
-    readonly selectedCount: number;
-    readonly totalCount: number | undefined;
-    readonly eligibleCount: number | undefined;
-    readonly selectionSummary: string;
-    readonly actionContracts: readonly TableBatchActionContract[];
-    readonly availableActionIds: readonly string[];
-    readonly disabledActionIds: readonly string[];
-    readonly pendingActionIds: readonly string[];
-    readonly hiddenActionIds: readonly string[];
-    readonly attrs: UiAttributes;
-}
-export interface EmptyPlanOptions {
-    readonly id?: string;
-    readonly label?: string;
-    readonly status?: ResultStatus;
-    readonly titleId?: string;
-    readonly descriptionId?: string;
-    readonly action?: DataDisplayAction;
-    readonly icon?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface EmptyPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly icon?: UiDomPlan<'span'>;
-    readonly title?: UiDomPlan<'strong'>;
-    readonly description?: UiDomPlan<'p'>;
-    readonly actionButton?: UiDomPlan<'button'>;
-}
-export interface ResultPlanOptions {
-    readonly id?: string;
-    readonly status?: ResultStatus;
-    readonly titleId?: string;
-    readonly descriptionId?: string;
-    readonly action?: DataDisplayAction;
-    readonly closeLabel?: string;
-    readonly icon?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface ResultPlans {
-    readonly root: UiDomPlan<'section'>;
-    readonly icon?: UiDomPlan<'span'>;
-    readonly title?: UiDomPlan<'h3'>;
-    readonly description?: UiDomPlan<'p'>;
-    readonly actionButton?: UiDomPlan<'button'>;
-    readonly closeButton?: UiDomPlan<'button'>;
-}
-export interface BadgePlanOptions {
-    readonly tone?: BadgeTone;
-    readonly label?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export type BadgeCountOverflowState = 'count' | 'dot' | 'empty' | 'overflow';
-export interface BadgeCountOverflowContractOptions {
-    readonly count?: number;
-    readonly max?: number;
-    readonly dot?: boolean;
-    readonly label?: string;
-}
-export interface BadgeCountOverflowContract {
-    readonly state: BadgeCountOverflowState;
-    readonly count: number;
-    readonly max: number;
-    readonly displayValue: string;
-    readonly overflow: boolean;
-    readonly dot: boolean;
-    readonly attrs: UiAttributes;
-}
-export interface TagPlanOptions {
-    readonly id?: string;
-    readonly label: string;
-    readonly value?: string;
-    readonly tone?: TagTone;
-    readonly variant?: TagVariant;
-    readonly selected?: boolean;
-    readonly removable?: boolean;
-    readonly disabled?: boolean;
-    readonly icon?: boolean;
-    readonly count?: number;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface TagPlans {
-    readonly root: UiDomPlan<'button' | 'span'>;
-    readonly icon?: UiDomPlan<'span'>;
-    readonly label: UiDomPlan<'span'>;
-    readonly value?: UiDomPlan<'span'>;
-    readonly count?: UiDomPlan<'span'>;
-    readonly removeButton?: UiDomPlan<'button'>;
-}
-export interface DataDisplayAction {
-    readonly id: string;
-    readonly label: string;
-    readonly disabled?: boolean;
-    readonly tone?: 'danger' | 'default' | 'primary';
-}
-export interface NotePlanOptions {
-    readonly id?: string;
-    readonly tone?: NoteTone;
-    readonly titleId?: string;
-    readonly descriptionId?: string;
-    readonly action?: DataDisplayAction;
-    readonly closeLabel?: string;
-    readonly icon?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface NotePlans {
-    readonly root: UiDomPlan<'aside'>;
-    readonly icon?: UiDomPlan<'span'>;
-    readonly content: UiDomPlan<'div'>;
-    readonly title?: UiDomPlan<'strong'>;
-    readonly description?: UiDomPlan<'p'>;
-    readonly actionButton?: UiDomPlan<'button'>;
-    readonly closeButton?: UiDomPlan<'button'>;
-}
-export interface NoteRichContentStateContractOptions {
-    readonly kind: NoteRichContentKind;
-    readonly density?: TypographyRichContentDensity;
-    readonly blocks?: readonly TypographyRichContentBlock[];
-    readonly actionId?: string;
-    readonly actionDisabled?: boolean;
-    readonly closeAvailable?: boolean;
-    readonly closeDisabled?: boolean;
-}
-export interface NoteRichContentBlockContract extends TypographyRichContentBlock {
-    readonly attrs: UiAttributes;
-}
-export interface NoteRichContentStateContract {
-    readonly kind: NoteRichContentKind;
-    readonly density: TypographyRichContentDensity;
-    readonly state: NoteRichContentState;
-    readonly actionState: NoteRichContentControlState;
-    readonly closeState: NoteRichContentControlState;
-    readonly blockCount: number;
-    readonly blockIds: readonly string[];
-    readonly blocks: readonly NoteRichContentBlockContract[];
-    readonly attrs: UiAttributes;
-    readonly contentAttrs: UiAttributes;
-    readonly actionAttrs: UiAttributes;
-    readonly closeAttrs: UiAttributes;
-}
-export interface PanelPlanOptions {
-    readonly id?: string;
-    readonly titleId?: string;
-    readonly descriptionId?: string;
-    readonly tone?: PanelTone;
-    readonly interactive?: boolean;
-    readonly selected?: boolean;
-    readonly actions?: readonly DataDisplayAction[];
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface PanelPlans {
-    readonly root: UiDomPlan<'article' | 'section'>;
-    readonly header?: UiDomPlan<'header'>;
-    readonly title?: UiDomPlan<'h3'>;
-    readonly description?: UiDomPlan<'p'>;
-    readonly body: UiDomPlan<'div'>;
-    readonly footer?: UiDomPlan<'footer'>;
-    readonly actions: readonly UiDomPlan<'button'>[];
-}
-export interface PanelCardMediaActionStateContractOptions {
-    readonly kind: PanelCardKind;
-    readonly mediaId?: string;
-    readonly mediaLabel?: string;
-    readonly mediaPlacement?: PanelCardMediaPlacement;
-    readonly actions?: readonly DataDisplayAction[];
-    readonly hiddenActionIds?: readonly string[];
-    readonly selected?: boolean;
-    readonly selectedEmphasis?: boolean;
-}
-export interface PanelCardActionContract {
-    readonly id: string;
-    readonly state: PanelCardActionState;
-    readonly attrs: UiAttributes;
-}
-export interface PanelCardMediaActionStateContract {
-    readonly kind: PanelCardKind;
-    readonly mediaState: PanelCardMediaState;
-    readonly mediaPlacement: PanelCardMediaPlacement;
-    readonly selectionState: PanelCardSelectionState;
-    readonly selectedEmphasis: boolean;
-    readonly actionCount: number;
-    readonly readyActionIds: readonly string[];
-    readonly disabledActionIds: readonly string[];
-    readonly hiddenActionIds: readonly string[];
-    readonly attrs: UiAttributes;
-    readonly mediaAttrs: UiAttributes;
-    readonly actionContracts: readonly PanelCardActionContract[];
-}
-export interface PageHeaderPlanOptions {
-    readonly id?: string;
-    readonly titleId: string;
-    readonly subtitleId?: string;
-    readonly breadcrumbLabel?: string;
-    readonly actions?: readonly DataDisplayAction[];
-    readonly tabsId?: string;
-    readonly density?: DataToolbarDensity;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface PageHeaderPlans {
-    readonly root: UiDomPlan<'header'>;
-    readonly breadcrumbSlot?: UiDomPlan<'nav'>;
-    readonly content: UiDomPlan<'div'>;
-    readonly title: UiDomPlan<'h1'>;
-    readonly subtitle?: UiDomPlan<'p'>;
-    readonly actionsSlot?: UiDomPlan<'div'>;
-    readonly actions: readonly UiDomPlan<'button'>[];
-    readonly tabsSlot?: UiDomPlan<'div'>;
-}
-export interface StatCardPlanOptions {
-    readonly id?: string;
-    readonly titleId: string;
-    readonly descriptionId?: string;
-    readonly value?: string | number;
-    readonly unit?: string;
-    readonly trend?: string;
-    readonly trendDirection?: StatTrendDirection;
-    readonly tone?: BadgeTone;
-    readonly loading?: boolean;
-    readonly action?: DataDisplayAction;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface StatCardPlans {
-    readonly root: UiDomPlan<'article'>;
-    readonly header: UiDomPlan<'header'>;
-    readonly title: UiDomPlan<'h3'>;
-    readonly value: UiDomPlan<'output'>;
-    readonly unit?: UiDomPlan<'span'>;
-    readonly trend?: UiDomPlan<'span'>;
-    readonly description?: UiDomPlan<'p'>;
-    readonly actionButton?: UiDomPlan<'button'>;
-}
-export interface TablePanelPlanOptions extends Omit<TablePlanOptions, 'attrs' | 'className' | 'id'> {
-    readonly id?: string;
-    readonly titleId?: string;
-    readonly descriptionId?: string;
-    readonly toolbarLabel?: string;
-    readonly actions?: readonly DataDisplayAction[];
-    readonly loading?: boolean;
-    readonly empty?: EmptyPlanOptions | boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-    readonly tableAttrs?: UiAttributes;
-}
-export interface TablePanelPlans {
-    readonly root: UiDomPlan<'section'>;
-    readonly header?: UiDomPlan<'header'>;
-    readonly title?: UiDomPlan<'h3'>;
-    readonly description?: UiDomPlan<'p'>;
-    readonly toolbarSlot?: UiDomPlan<'div'>;
-    readonly actions: readonly UiDomPlan<'button'>[];
-    readonly body: UiDomPlan<'div'>;
-    readonly scroller: UiDomPlan<'div'>;
-    readonly table: TablePlans;
-    readonly empty?: UiDomPlan<'div'>;
-}
-export interface SkeletonScreenPlanOptions {
-    readonly id?: string;
-    readonly label?: string;
-    readonly rows?: number;
-    readonly density?: DataToolbarDensity;
-    readonly animated?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface SkeletonScreenPlans {
-    readonly root: UiDomPlan<'section'>;
-    readonly rows: readonly UiDomPlan<'span'>[];
-}
-export interface SpinOverlayPlanOptions {
-    readonly id?: string;
-    readonly label?: string;
-    readonly mode?: LoadingOverlayMode;
-    readonly open?: boolean;
-    readonly targetId?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface SpinOverlayPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly spinner: UiDomPlan<'span'>;
-}
-export interface ButtonLoadingPlanOptions {
-    readonly id?: string;
-    readonly label: string;
-    readonly loading?: boolean;
-    readonly disabled?: boolean;
-    readonly variant?: UiButtonVariant;
-    readonly size?: UiControlSize;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface ButtonLoadingPlans {
-    readonly root: UiDomPlan<'button'>;
-    readonly indicator?: UiDomPlan<'span'>;
-    readonly label: UiDomPlan<'span'>;
-}
-export interface TypographyPlanOptions {
-    readonly id?: string;
-    readonly variant?: TypographyVariant;
-    readonly as?: 'a' | 'code' | 'h1' | 'h2' | 'h3' | 'p' | 'span';
-    readonly label?: string;
-    readonly href?: string;
-    readonly truncate?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface TypographyRichContentBlock {
-    readonly id: string;
-    readonly kind: TypographyRichContentBlockKind;
-}
-export interface TypographyRichContentStateContractOptions {
-    readonly source?: TypographyRichContentSource;
-    readonly density?: TypographyRichContentDensity;
-    readonly label?: string;
-    readonly blocks?: readonly TypographyRichContentBlock[];
-}
-export interface TypographyRichContentBlockContract extends TypographyRichContentBlock {
-    readonly attrs: UiAttributes;
-}
-export interface TypographyRichContentStateContract {
-    readonly source: TypographyRichContentSource;
-    readonly density: TypographyRichContentDensity;
-    readonly state: TypographyRichContentState;
-    readonly blockCount: number;
-    readonly headingCount: number;
-    readonly blockIds: readonly string[];
-    readonly blocks: readonly TypographyRichContentBlockContract[];
-    readonly attrs: UiAttributes;
-}
-export interface DividerPlanOptions {
-    readonly id?: string;
-    readonly orientation?: DividerOrientation;
-    readonly inset?: boolean | 'end' | 'start';
-    readonly label?: string;
-    readonly labelId?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface DividerPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly label?: UiDomPlan<'span'>;
-}
-export interface DividerSectionHeadingStateContractOptions {
-    readonly headingId: string;
-    readonly sectionId: string;
-    readonly level?: DividerSectionHeadingLevel;
-    readonly descriptionId?: string;
-    readonly current?: boolean;
-}
-export interface DividerSectionHeadingStateContract {
-    readonly state: DividerSectionHeadingState;
-    readonly headingId: string;
-    readonly sectionId: string;
-    readonly level: DividerSectionHeadingLevel;
-    readonly attrs: UiAttributes;
-    readonly headingAttrs: UiAttributes;
-    readonly sectionAttrs: UiAttributes;
-}
-export interface AvatarPlanOptions {
-    readonly id?: string;
-    readonly name: string;
-    readonly src?: string;
-    readonly alt?: string;
-    readonly initials?: string;
-    readonly size?: AvatarSize;
-    readonly status?: AvatarStatus;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface AvatarPlans {
-    readonly root: UiDomPlan<'span'>;
-    readonly image?: UiDomPlan<'img'>;
-    readonly fallback: UiDomPlan<'span'>;
-    readonly status?: UiDomPlan<'span'>;
-}
-export interface AvatarGroupPlanOptions {
-    readonly id?: string;
-    readonly avatars: readonly AvatarPlanOptions[];
-    readonly maxVisible?: number;
-    readonly size?: AvatarSize;
-    readonly label?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface AvatarGroupPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly avatars: readonly AvatarPlans[];
-    readonly overflow?: UiDomPlan<'span'>;
-}
-export interface AvatarImagePresenceStateContractOptions {
-    readonly name: string;
-    readonly src?: string;
-    readonly imageState?: AvatarImageState;
-    readonly imageError?: string;
-    readonly status?: AvatarStatus;
-    readonly presenceSource?: AvatarPresenceSource;
-    readonly presenceUpdatedAt?: string;
-    readonly cacheKey?: string;
-    readonly cacheState?: AvatarCacheState;
-    readonly cachedAt?: string;
-    readonly fallbackInitials?: string;
-}
-export interface AvatarImagePresenceStateContract {
-    readonly imageState: AvatarImageState;
-    readonly presenceSource: AvatarPresenceSource;
-    readonly cacheState: AvatarCacheState;
-    readonly fallbackInitials: string;
-    readonly attrs: UiAttributes;
-}
-export interface KbdPlanOptions {
-    readonly key: string;
-    readonly label?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface ShortcutPlanOptions {
-    readonly keys: readonly string[];
-    readonly label?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface ShortcutPlans {
-    readonly root: UiDomPlan<'span'>;
-    readonly keys: readonly UiDomPlan<'kbd'>[];
-    readonly separators: readonly UiDomPlan<'span'>[];
-}
-export interface ShortcutDisplayStateContractOptions {
-    readonly keys: readonly string[];
-    readonly platform?: ShortcutPlatform;
-    readonly modifierAliases?: Readonly<Record<string, string>>;
-    readonly label?: string;
-}
-export interface ShortcutDisplayKeyContract {
-    readonly key: string;
-    readonly displayKey: string;
-    readonly aliased: boolean;
-    readonly attrs: UiAttributes;
-}
-export interface ShortcutDisplayStateContract {
-    readonly platform: ShortcutPlatform;
-    readonly state: ShortcutDisplayState;
-    readonly keys: readonly string[];
-    readonly displayKeys: readonly string[];
-    readonly aliasedKeys: readonly string[];
-    readonly label: string;
-    readonly keyContracts: readonly ShortcutDisplayKeyContract[];
-    readonly attrs: UiAttributes;
-}
-export interface PaginationPlanOptions {
-    readonly id?: string;
-    readonly page: number;
-    readonly pageCount?: number;
-    readonly pageSize?: number;
-    readonly totalItems?: number;
-    readonly siblingCount?: number;
-    readonly boundaryCount?: number;
-    readonly label?: string;
-    readonly previousLabel?: string;
-    readonly nextLabel?: string;
-    readonly pageLabel?: (page: number) => string;
-    readonly summary?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface PaginationItem {
-    readonly kind: PaginationItemKind;
-    readonly page?: number;
-    readonly current?: boolean;
-}
-export interface PaginationPlans {
-    readonly root: UiDomPlan<'nav'>;
-    readonly list: UiDomPlan<'ol'>;
-    readonly previous: UiDomPlan<'button'>;
-    readonly pages: readonly UiDomPlan<'button' | 'span'>[];
-    readonly next: UiDomPlan<'button'>;
-    readonly summary: UiDomPlan<'output'>;
-    readonly model: PaginationModel;
-}
-export interface PaginationModel {
-    readonly rootId: string;
-    readonly rootClassName: string;
-    readonly page: number;
-    readonly pageCount: number;
-    readonly totalItems: number;
-    readonly previousClassName: string;
-    readonly previousLabel: string;
-    readonly previousPage: number;
-    readonly previousDisabled: boolean;
-    readonly listClassName: string;
-    readonly pages: readonly PaginationItemModel[];
-    readonly nextClassName: string;
-    readonly nextLabel: string;
-    readonly nextPage: number;
-    readonly nextDisabled: boolean;
-    readonly summaryClassName: string;
-    readonly summary: string;
-}
-export interface PaginationItemModel {
-    readonly id: string;
-    readonly className: string;
-    readonly kind: PaginationItemKind;
-    readonly page: number;
-    readonly state: 'current' | 'idle' | 'ellipsis';
-    readonly current: 'page' | undefined;
-    readonly label: string;
-}
-export interface ListItemPlanOptions {
-    readonly id: string;
-    readonly label?: string;
-    readonly description?: string;
-    readonly meta?: string;
-    readonly icon?: boolean;
-    readonly selected?: boolean;
-    readonly disabled?: boolean;
-    readonly actionLabel?: string;
-}
-export interface ListPlanOptions {
-    readonly id?: string;
-    readonly items: readonly ListItemPlanOptions[];
-    readonly ordered?: boolean;
-    readonly selectionMode?: ListSelectionMode;
-    readonly density?: DataToolbarDensity;
-    readonly label?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface ListPlans {
-    readonly root: UiDomPlan<'ol' | 'ul'>;
-    readonly items: readonly UiDomPlan<'li'>[];
-    readonly icons: readonly (UiDomPlan<'span'> | undefined)[];
-    readonly labels: readonly UiDomPlan<'span'>[];
-    readonly descriptions: readonly (UiDomPlan<'p'> | undefined)[];
-    readonly metas: readonly (UiDomPlan<'span'> | undefined)[];
-    readonly actions: readonly (UiDomPlan<'button'> | undefined)[];
-}
-export interface ListGroupStateContractOptions {
-    readonly id: string;
-    readonly headingId: string;
-    readonly label: string;
-    readonly itemIds: readonly string[];
-}
-export interface ListGroupedItemActionStateContractOptions {
-    readonly items: readonly ListItemPlanOptions[];
-    readonly groups?: readonly ListGroupStateContractOptions[];
-    readonly actionDisabledIds?: readonly string[];
-    readonly actionHiddenIds?: readonly string[];
-}
-export interface ListGroupStateContract {
-    readonly id: string;
-    readonly label: string;
-    readonly itemIds: readonly string[];
-    readonly itemCount: number;
-    readonly selectedCount: number;
-    readonly selectionState: ListGroupSelectionState;
-    readonly attrs: UiAttributes;
-    readonly headingAttrs: UiAttributes;
-}
-export interface ListGroupedItemActionContract {
-    readonly id: string;
-    readonly groupId: string;
-    readonly actionState: ListItemActionState;
-    readonly attrs: UiAttributes;
-    readonly actionAttrs: UiAttributes;
-}
-export interface ListGroupedItemActionStateContract {
-    readonly state: ListGroupedState;
-    readonly itemCount: number;
-    readonly groupCount: number;
-    readonly groupedItemCount: number;
-    readonly actionCount: number;
-    readonly groupIds: readonly string[];
-    readonly readyActionIds: readonly string[];
-    readonly disabledActionIds: readonly string[];
-    readonly hiddenActionIds: readonly string[];
-    readonly attrs: UiAttributes;
-    readonly groups: readonly ListGroupStateContract[];
-    readonly items: readonly ListGroupedItemActionContract[];
-}
-export interface CarouselSlidePlanOptions {
-    readonly id: string;
-    readonly label: string;
-}
-export interface CarouselPlanOptions {
-    readonly id?: string;
-    readonly label: string;
-    readonly slides: readonly CarouselSlidePlanOptions[];
-    readonly currentSlideId?: string;
-    readonly playback?: CarouselPlaybackState;
-    readonly previousLabel?: string;
-    readonly nextLabel?: string;
-    readonly playLabel?: string;
-    readonly pauseLabel?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface CarouselPlans {
-    readonly state: CarouselState;
-    readonly playbackState: CarouselPlaybackState;
-    readonly currentSlideId: string;
-    readonly currentSlidePosition: number;
-    readonly slideCount: number;
-    readonly root: UiDomPlan<'section'>;
-    readonly viewport: UiDomPlan<'div'>;
-    readonly track: UiDomPlan<'div'>;
-    readonly slides: readonly UiDomPlan<'article'>[];
-    readonly controls: UiDomPlan<'div'>;
-    readonly previous: UiDomPlan<'button'>;
-    readonly next: UiDomPlan<'button'>;
-    readonly playback: UiDomPlan<'button'>;
-    readonly indicators: UiDomPlan<'div'>;
-    readonly indicatorButtons: readonly UiDomPlan<'button'>[];
-}
-export interface ProgressPlanOptions {
-    readonly value: number;
-    readonly max?: number;
-    readonly status?: ProgressStatus;
-    readonly label?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface SplitWorkspaceArea {
-    readonly id: string;
-    readonly role: SplitWorkspaceAreaRole;
-    readonly minWidth?: string;
-    readonly fallback?: SplitWorkspaceTabletFallback;
-}
-export interface SplitWorkspacePlans {
-    readonly root: UiDomPlan<'section'>;
-    readonly areas: readonly UiDomPlan<'section'>[];
-}
-export interface SplitWorkspacePlanOptions {
-    readonly id?: string;
-    readonly areas: readonly SplitWorkspaceArea[];
-    readonly tabletFallback?: SplitWorkspaceTabletFallback;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createTablePlans(options: TablePlanOptions): TablePlans;
-export declare function getNextTableSortDirection(current: TableSortDirection | undefined, cycle?: 'binary' | 'tri-state'): TableSortDirection;
-export declare function toggleTableRowSelection(selectedIds: ReadonlySet<string>, rowId: string, multiselect?: boolean): ReadonlySet<string>;
-export declare function createTableToolbarStateContract(options?: TableToolbarStateContractOptions): TableToolbarStateContract;
-export declare function createTableColumnPreferenceStateContract(options: TableColumnPreferenceStateContractOptions): TableColumnPreferenceStateContract;
-export declare function createTableCellStateContract(options: TableCellStateContractOptions): TableCellStateContract;
-export declare function createTableBatchActionStateContract(options?: TableBatchActionStateContractOptions): TableBatchActionStateContract;
-export declare function createFilterBarPlans(options: FilterBarPlanOptions): FilterBarPlans;
-export declare function createDataToolbarPlans(options?: DataToolbarPlanOptions): DataToolbarPlans;
-export declare function formatDataToolbarSummary(options: Pick<DataToolbarPlanOptions, 'filteredCount' | 'selectedCount' | 'totalCount'>): string;
-export declare function createEmptyPlan(options?: EmptyPlanOptions): UiDomPlan<'div'>;
-export declare function createEmptyPlans(options?: EmptyPlanOptions): EmptyPlans;
-export declare function createResultPlans(options?: ResultPlanOptions): ResultPlans;
-export declare function createBadgePlan(options?: BadgePlanOptions): UiDomPlan<'span'>;
-export declare function createBadgeCountOverflowContract(options?: BadgeCountOverflowContractOptions): BadgeCountOverflowContract;
-export declare function createTagPlans(options: TagPlanOptions): TagPlans;
-export declare function createChipPlans(options: Omit<TagPlanOptions, 'variant'>): TagPlans;
-export declare function createNotePlans(options?: NotePlanOptions): NotePlans;
-export declare function createCalloutPlans(options?: NotePlanOptions): NotePlans;
-export declare function createNoteRichContentStateContract(options: NoteRichContentStateContractOptions): NoteRichContentStateContract;
-export declare function createPanelPlans(options?: PanelPlanOptions): PanelPlans;
-export declare function createCardPlans(options?: PanelPlanOptions): PanelPlans;
-export declare function createPanelCardMediaActionStateContract(options: PanelCardMediaActionStateContractOptions): PanelCardMediaActionStateContract;
-export declare function createPageHeaderPlans(options: PageHeaderPlanOptions): PageHeaderPlans;
-export declare function createStatCardPlans(options: StatCardPlanOptions): StatCardPlans;
-export declare function createTablePanelPlans(options: TablePanelPlanOptions): TablePanelPlans;
-export declare function createProgressPlan(options: ProgressPlanOptions): UiDomPlan<'div'>;
-export declare function createTypographyPlan(options?: TypographyPlanOptions): UiDomPlan<'a' | 'code' | 'h1' | 'h2' | 'h3' | 'p' | 'span'>;
-export declare function createTypographyRichContentStateContract(options?: TypographyRichContentStateContractOptions): TypographyRichContentStateContract;
-export declare function createDividerPlans(options?: DividerPlanOptions): DividerPlans;
-export declare function createDividerSectionHeadingStateContract(options: DividerSectionHeadingStateContractOptions): DividerSectionHeadingStateContract;
-export declare function createAvatarPlans(options: AvatarPlanOptions): AvatarPlans;
-export declare function createAvatarGroupPlans(options: AvatarGroupPlanOptions): AvatarGroupPlans;
-export declare function createAvatarImagePresenceStateContract(options: AvatarImagePresenceStateContractOptions): AvatarImagePresenceStateContract;
-export declare function createKbdPlan(options: KbdPlanOptions): UiDomPlan<'kbd'>;
-export declare function createShortcutPlans(options: ShortcutPlanOptions): ShortcutPlans;
-export declare function createShortcutDisplayStateContract(options: ShortcutDisplayStateContractOptions): ShortcutDisplayStateContract;
-export declare function createPaginationPlans(options: PaginationPlanOptions): PaginationPlans;
-export declare function createPaginationItems(options: Pick<PaginationPlanOptions, 'boundaryCount' | 'page' | 'pageCount' | 'siblingCount'>): readonly PaginationItem[];
-export declare function formatPaginationSummary(options: Pick<PaginationPlanOptions, 'page' | 'pageCount' | 'pageSize' | 'totalItems'>): string;
-export declare function createListPlans(options: ListPlanOptions): ListPlans;
-export declare function createListGroupedItemActionStateContract(options: ListGroupedItemActionStateContractOptions): ListGroupedItemActionStateContract;
-export declare function createCarouselPlans(options: CarouselPlanOptions): CarouselPlans;
-export declare function createSplitWorkspacePlans(options: SplitWorkspacePlanOptions): SplitWorkspacePlans;
-export declare function createSkeletonScreenPlans(options?: SkeletonScreenPlanOptions): SkeletonScreenPlans;
-export declare function createSpinOverlayPlans(options?: SpinOverlayPlanOptions): SpinOverlayPlans;
-export declare function createButtonLoadingPlans(options: ButtonLoadingPlanOptions): ButtonLoadingPlans;
-/**
- * Descriptions plans — read-only info display on detail pages (dl/dt/dd semantics).
- * Spec source: common enterprise-backend component set (no UIStyle spec, this is an out-of-spec component).
- */
-export type DescriptionsLayout = 'horizontal' | 'vertical';
-export interface DescriptionsItemInput {
-    readonly id: string;
-    readonly label: string;
-    /** Value (carried via data-value, filled at render time). */
-    readonly value?: string;
-    /** Column span (column layout). */
-    readonly span?: number;
-}
-export interface DescriptionsItemPlan {
-    readonly itemId: string;
-    readonly label: UiDomPlan<'dt'>;
-    readonly value: UiDomPlan<'dd'>;
-}
-export interface DescriptionsPlans {
-    readonly root: UiDomPlan<'dl'>;
-    readonly items: readonly DescriptionsItemPlan[];
-}
-export interface DescriptionsPlanOptions {
-    readonly id: string;
-    readonly items: readonly DescriptionsItemInput[];
-    readonly layout?: DescriptionsLayout;
-    readonly bordered?: boolean;
-    readonly column?: number;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createDescriptionsPlans(options: DescriptionsPlanOptions): DescriptionsPlans;
-/**
- * Timeline plans — history/process records (ul/li semantics + node states).
- * Spec source: common enterprise-backend component set (no UIStyle spec, this is an out-of-spec component).
- */
-export type TimelineItemState = 'default' | 'error' | 'success' | 'warning';
-export interface TimelineItemInput {
-    readonly id: string;
-    readonly title: string;
-    readonly description?: string;
-    readonly time?: string;
-    readonly state?: TimelineItemState;
-}
-export interface TimelineItemPlan {
-    readonly itemId: string;
-    /** Derived state (data-state). */
-    readonly state: TimelineItemState;
-    readonly title: UiDomPlan<'div'>;
-    readonly description: UiDomPlan<'div'>;
-    readonly time: UiDomPlan<'div'>;
-}
-export interface TimelinePlans {
-    readonly root: UiDomPlan<'ul'>;
-    readonly items: readonly TimelineItemPlan[];
-}
-export interface TimelinePlanOptions {
-    readonly id: string;
-    readonly items: readonly TimelineItemInput[];
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createTimelinePlans(options: TimelinePlanOptions): TimelinePlans;
-/**
- * Image plans — image display + optional zoom preview (overlay + close + caption).
- * Spec source: common enterprise-backend component set (avatar/product image/screenshot viewing).
- */
-export interface ImagePlans {
-    readonly root: UiDomPlan<'figure'>;
-    readonly image: UiDomPlan<'img'>;
-    /** Zoom-preview overlay (present when preview=true, hidden by default). */
-    readonly overlay: UiDomPlan<'div'>;
-    readonly close: UiDomPlan<'button'>;
-    readonly caption: UiDomPlan<'figcaption'>;
-}
-export interface ImagePlanOptions {
-    readonly id: string;
-    readonly src?: string;
-    readonly alt?: string;
-    readonly caption?: string;
-    /** Whether the image can be clicked to open the zoom preview (default false). */
-    readonly preview?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createImagePlans(options: ImagePlanOptions): ImagePlans;
-/**
- * Back Top plans — fixed-position back-to-top button.
- * Spec source: common enterprise-backend component set (long lists/long pages).
- */
-export interface BackTopPlans {
-    readonly root: UiDomPlan<'button'>;
-}
-export interface BackTopPlanOptions {
-    readonly id: string;
-    /** Visibility (default false; the app controls the scroll threshold). */
-    readonly visible?: boolean;
-    readonly disabled?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createBackTopPlans(options: BackTopPlanOptions): BackTopPlans;
-/**
- * Text highlight (Highlight) — search/filter hit marking.
- * Core is a pure splitter function (no DOM dependency, testable): splits text into plain/highlight segments by query;
- * the app wraps highlighted segments in <mark class="kui-highlight"> at render time.
- * Spec source: common enterprise-backend component set (search-result keyword location).
- */
-export interface HighlightSegment {
-    readonly text: string;
-    readonly highlighted: boolean;
-}
-/**
- * Splits text into highlight/plain segments by query.
- * - Case-insensitive; supports multiple keywords (array); empty query/text returns a single plain segment.
- * - Overlapping hits are resolved by the earliest position (no nesting).
- */
-export declare function splitHighlightSegments(text: string, query: string | readonly string[]): readonly HighlightSegment[];
-/** Highlight-mark plan (used by the app for highlighted segments at render time). */
-export declare function createHighlightMark(text: string, id?: string): UiDomPlan<'mark'>;
-/**
- * Code Block plans — structure + language marker + copy button + optional line numbers.
- * Syntax highlighting is not built in (heavy engines go through the adapter-shiki path) — plans provide a data-language marker and a code container.
- * Spec source: common enterprise-backend component set (docs/work-order code display).
- */
-export interface CodeBlockPlans {
-    readonly root: UiDomPlan<'figure'>;
-    readonly header: UiDomPlan<'div'>;
-    readonly language: UiDomPlan<'span'>;
-    readonly copy: UiDomPlan<'button'>;
-    /** Code content container (data-code carries the source; apps/adapters render highlighted HTML). */
-    readonly code: UiDomPlan<'pre'>;
-    /** Line-numbers container (present when showLineNumbers=true; numbers are rendered by the app). */
-    readonly lineNumbers?: UiDomPlan<'div'>;
-}
-export interface CodeBlockPlanOptions {
-    readonly id: string;
-    readonly code?: string;
-    /** Language identifier ('ts'/'css'/...), used for the label and highlighting-engine selection. */
-    readonly language?: string;
-    readonly showLineNumbers?: boolean;
-    readonly copyable?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createCodeBlockPlans(options: CodeBlockPlanOptions): CodeBlockPlans;