@getdom/studio 0.1.0 → 0.2.0

package/src/pages/lib/vue/index.d.ts

@@ -2,6 +2,34 @@
 // Generated by scripts/generate-types.mjs. Do not edit by hand.
 import type { ComputedRef, DefineSetupFnComponent, Directive, InjectionKey, Ref, SlotsType } from 'vue';
 
+/** An application-owned row command. Full-swipe execution is opt-in. */
+export interface SwipeAction {
+	value: string | number;
+	label: string;
+	icon?: string;
+	variant?: 'default' | 'success' | 'danger';
+	disabled?: boolean;
+	fullSwipe?: boolean;
+	[key: string]: unknown;
+}
+/** Action requested by a revealed button, explicit menu, or full swipe. */
+export interface SwipeActionPayload { action: SwipeAction; side: 'start' | 'end'; source: 'button' | 'swipe'; }
+/** An application-owned video with a stable identity and an optional caption track. */
+export interface VideoFeedItem {
+	id: string | number;
+	src: string;
+	title: string;
+	poster?: string;
+	creator?: string;
+	description?: string;
+	objectPosition?: string;
+	tracks?: Array<VideoFeedTrack>;
+	[key: string]: unknown;
+}
+/** WebVTT captions served from the same origin or with appropriate CORS headers. */
+export interface VideoFeedTrack { src: string; srclang: string; label: string; default?: boolean; }
+export interface ChartDateRange { start: string; end: string; }
+export interface ChartSeries { key: string; label?: string; color?: string; dashed?: boolean; }
 export type JsonPrimitive = string | number | boolean | null;
 export type JsonValue = JsonPrimitive | { [key: string]: JsonValue } | Array<JsonValue>;
 export type DomUnknownRecord = Record<string, unknown>;
@@ -32,6 +60,38 @@ export interface FilterBarQuery {
 	search: string;
 	filters: Record<string, unknown>;
 }
+/** Application-owned row and exclusive interval requested by DomGantt. */
+export interface GanttRangePayload {
+	row: DomUnknownRecord;
+	rowKey: ResourceKey;
+	startDate: Date;
+	endDate: Date;
+	durationMinutes: number;
+	event: Event;
+}
+/** Source records and resolved dates supplied when a Gantt item is activated. */
+export interface GanttItemPayload {
+	item: DomUnknownRecord;
+	row: DomUnknownRecord;
+	rowKey: ResourceKey;
+	startDate: Date;
+	endDate: Date;
+	event: Event;
+}
+/** Application-owned move or resize proposal; source records are never mutated. */
+export interface GanttItemChangePayload {
+	item: DomUnknownRecord;
+	sourceRow: DomUnknownRecord;
+	targetRow: DomUnknownRecord;
+	sourceRowKey: ResourceKey;
+	targetRowKey: ResourceKey;
+	previousStartDate: Date;
+	previousEndDate: Date;
+	startDate: Date;
+	endDate: Date;
+	durationMinutes: number;
+	event: Event;
+}
 /** Resolved presentation contract supplied to activity-timeline slots. */
 export interface ActivityTimelineRecord {
 	row: DomUnknownRecord;
@@ -188,6 +248,21 @@ export interface IconSelectorItem {
 	component?: DomVueComponent;
 	[key: string]: unknown;
 }
+/** A contained menu page, route link, or application-owned action. */
+export interface MenuStackItem {
+	id: string;
+	label?: string;
+	title?: string;
+	description?: string;
+	meta?: string;
+	disabled?: boolean;
+	children?: Array<MenuStackItem>;
+	component?: DomVueComponent;
+	props?: Record<string, unknown>;
+	slot?: string;
+	to?: string | Record<string, unknown>;
+	href?: string;
+}
 export interface DomMenuItemRecord {
 	label?: string;
 	value?: string | number;
@@ -906,6 +981,26 @@ export interface ToastApi {
 	dismiss(id: string): void;
 	clear(): void;
 }
+export type InAppNotificationSeverity = 'info' | 'success' | 'warning' | 'error';
+export type InAppNotificationPresentation = 'inbox' | 'toast' | 'banner';
+export interface InAppNotificationAction { label: string; href: string; }
+export interface InAppNotificationMessage {
+	title: string;
+	body: string;
+	severity?: InAppNotificationSeverity;
+	presentation?: InAppNotificationPresentation;
+	action?: InAppNotificationAction;
+}
+export interface InAppNotificationItem {
+	id: string;
+	type: string;
+	message: InAppNotificationMessage;
+	createdAt: string;
+	readAt: string | null;
+	dismissedAt: string | null;
+	archivedAt: string | null;
+}
+export interface NotificationToastOptions { duration?: number; dismissible?: boolean; }
 export type DialogTone = 'default' | 'danger' | string;
 export type DialogType = 'dialog' | 'confirm' | 'form' | string;
 export type DialogFormSchema = Array<DomFormNode>;
@@ -1010,6 +1105,10 @@ export interface DomButtonProps {
 	 * Five balanced sizes.
 	 */
 	size?: "xs" | "sm" | "md" | "lg" | "xl";
+	/**
+	 * Show native press feedback for an external activation, such as a keyboard shortcut. Does not represent toggle selection.
+	 */
+	pressed?: boolean;
 	/**
 	 * Show a spinner and block interaction.
 	 */
@@ -1046,6 +1145,10 @@ export interface DomIconButtonProps {
 	 * Show active/selected state.
 	 */
 	active?: boolean;
+	/**
+	 * Show native press feedback for an external activation, such as a keyboard shortcut. Does not represent toggle selection.
+	 */
+	pressed?: boolean;
 	/**
 	 * Show a loading spinner and block interaction.
 	 */
@@ -1302,6 +1405,22 @@ export interface DomDialogProps {
 	 * Show the footer region and default Close action when no footer slot is provided.
 	 */
 	footer?: boolean;
+	/**
+	 * Whether the optional companion slot is visible.
+	 */
+	companionOpen?: boolean;
+	/**
+	 * Desktop width of the companion surface.
+	 */
+	companionWidth?: string | number;
+	/**
+	 * Viewport width at which the companion switches from a side-by-side surface to a covering dialog.
+	 */
+	companionBreakpoint?: string | number;
+	/**
+	 * Accessible name for the companion surface.
+	 */
+	companionLabel?: string;
 }
 export declare const DomDialog: DomComponent<DomDialogProps>;
 
@@ -1362,6 +1481,123 @@ export interface DomLightboxProps {
 }
 export declare const DomLightbox: DomComponent<DomLightboxProps>;
 
+/** VideoFeedItem, VideoFeedTrack payload types are exported from this module. */
+export interface DomVideoFeedProps {
+	/**
+	 * Video records with a unique id, src, and title. Optional poster, creator, description, objectPosition, and WebVTT tracks.
+	 */
+	items?: Array<VideoFeedItem>;
+	/**
+	 * Active item index; supports v-model:index.
+	 */
+	index?: number;
+	/**
+	 * Feed height. Use a CSS length, or 100% inside an explicitly sized parent.
+	 */
+	height?: string;
+	/**
+	 * Initial sound preference; supports v-model:muted. Muted playback is most compatible with autoplay.
+	 */
+	muted?: boolean;
+	/**
+	 * Play the visible item automatically, except when reduced motion or data saving is requested.
+	 */
+	autoplay?: boolean;
+	/**
+	 * Loop the active video. Does not wrap feed navigation.
+	 */
+	loop?: boolean;
+	/**
+	 * Fill the portrait frame or preserve the complete source image.
+	 */
+	fit?: 'cover' | 'contain';
+	/**
+	 * Accessible name of the feed.
+	 */
+	label?: string;
+}
+export declare const DomVideoFeed: DomComponent<DomVideoFeedProps>;
+
+export interface DomAudioControlsProps {
+	/**
+	 * Button label before microphone capture starts.
+	 */
+	label?: string;
+	/**
+	 * Input device ID, or empty for system default. Supports v-model:deviceId.
+	 */
+	deviceId?: string;
+	/**
+	 * Mute the capture track while keeping its device open. Supports v-model:muted.
+	 */
+	muted?: boolean;
+	/**
+	 * Optional audio MediaTrackConstraints applied at start/selection. deviceId is controlled separately.
+	 */
+	constraints?: MediaTrackConstraints | null;
+}
+export declare const DomAudioControls: DomComponent<DomAudioControlsProps>;
+
+export interface DomAudioInputProps {
+	/**
+	 * Microphone device ID, or empty for the system default. Supports v-model:deviceId.
+	 */
+	deviceId?: string;
+	/**
+	 * Mute current and future tracks without releasing the microphone. Supports v-model:muted.
+	 */
+	muted?: boolean;
+	/**
+	 * Optional audio MediaTrackConstraints, applied at start or selection. deviceId is controlled separately.
+	 */
+	constraints?: MediaTrackConstraints | null;
+	/**
+	 * Setup heading and device picker label.
+	 */
+	label?: string;
+}
+export declare const DomAudioInput: DomComponent<DomAudioInputProps>;
+
+export interface DomCameraInputProps {
+	/**
+	 * Camera device ID, or empty for system default. Supports v-model:deviceId.
+	 */
+	deviceId?: string;
+	/**
+	 * Optional video MediaTrackConstraints such as facingMode or ideal width. Applied at start or selection.
+	 */
+	constraints?: MediaTrackConstraints | null;
+	/**
+	 * Mirror only the local preview for a front-facing camera. The emitted stream is unchanged.
+	 */
+	mirror?: boolean;
+	/**
+	 * Setup heading and camera picker label.
+	 */
+	label?: string;
+}
+export declare const DomCameraInput: DomComponent<DomCameraInputProps>;
+
+export interface DomAudioVisualizerProps {
+	/**
+	 * Application-owned MediaStream. The visualizer never stops its tracks.
+	 */
+	stream?: MediaStream | null;
+	/**
+	 * Show a flat baseline while the input is muted.
+	 */
+	muted?: boolean;
+	/**
+	 * Number of rounded bars, clamped to 8–64.
+	 */
+	bars?: number;
+	/**
+	 * Accessible name for the live input meter.
+	 */
+	label?: string;
+}
+export declare const DomAudioVisualizer: DomComponent<DomAudioVisualizerProps>;
+
 export interface DomTabsProps {
 	modelValue?: string;
 	tabs: Array<unknown>;
@@ -1417,6 +1653,30 @@ export interface DomAccordionProps {
 }
 export declare const DomAccordion: DomComponent<DomAccordionProps>;
 
+export interface DomMenuStackProps {
+	/**
+	 * Nested items: unique id, label, description, meta, disabled, children, component, props, slot, to, or href. Page items open their children; use a leaf for a route or action.
+	 */
+	items?: Array<MenuStackItem>;
+	/**
+	 * Root page heading.
+	 */
+	title?: string;
+	/**
+	 * Bounded container height. Use 100% in an explicitly sized parent.
+	 */
+	height?: string;
+	/**
+	 * Controlled path of page ids starting with root. Bind with v-model:path.
+	 */
+	path?: Array<string> | null;
+	/**
+	 * Enable sliding transitions; reduced-motion preferences are respected.
+	 */
+	animate?: boolean;
+}
+export declare const DomMenuStack: DomComponent<DomMenuStackProps>;
+
 export interface DomMenuProps {
 	/**
 	 * Menu rows. Use separator: true for dividers.
@@ -1826,6 +2086,86 @@ export interface DomToastItemProps {
 }
 export declare const DomToastItem: DomComponent<DomToastItemProps>;
 
+export interface DomNotificationInboxProps {
+	/**
+	 * Application-owned durable notification items. The shape matches db3.ai InAppItem records.
+	 */
+	items?: Array<InAppNotificationItem>;
+	/**
+	 * Authoritative unread count for the full scoped inbox. Omit to count unread supplied items.
+	 */
+	unreadCount?: number;
+	/**
+	 * Show initial inbox loading placeholders when no items are available.
+	 */
+	loading?: boolean;
+	/**
+	 * Show refresh progress without replacing already loaded items.
+	 */
+	refreshing?: boolean;
+	/**
+	 * Show progress on the pagination action.
+	 */
+	loadingMore?: boolean;
+	/**
+	 * Item IDs with a durable state transition currently in flight.
+	 */
+	updatingIds?: Array<string>;
+	/**
+	 * Show a control that requests the next application-owned page.
+	 */
+	hasMore?: boolean;
+	/**
+	 * Compact recoverable error shown above the notification list.
+	 */
+	error?: string;
+	/**
+	 * Inbox panel heading.
+	 */
+	title?: string;
+	/**
+	 * Accessible label for the default bell trigger.
+	 */
+	triggerLabel?: string;
+	/**
+	 * Empty-state heading.
+	 */
+	emptyTitle?: string;
+	/**
+	 * Empty-state supporting copy.
+	 */
+	emptyDescription?: string;
+	/**
+	 * Pagination action label.
+	 */
+	loadMoreLabel?: string;
+	/**
+	 * Show the application-owned refresh action in the default header.
+	 */
+	showRefresh?: boolean;
+	/**
+	 * Show an archive action for every default notification row.
+	 */
+	showArchive?: boolean;
+	/**
+	 * Optional formatter receiving createdAt and the complete item.
+	 */
+	formatTimestamp?: (createdAt: string, item: InAppNotificationItem) => string;
+	/**
+	 * Preferred popover placement around the trigger.
+	 */
+	position?: "bottom-end" | "bottom-start" | "top-end" | "top-start";
+	/**
+	 * Tailwind width utilities applied to the popover panel.
+	 */
+	panelWidth?: string;
+	/**
+	 * CSS maximum height for the scrolling notification list.
+	 */
+	maxHeight?: string;
+}
+export declare const DomNotificationInbox: DomComponent<DomNotificationInboxProps>;
+
 export interface DomCommandPaletteProps {
 	/**
 	 * Whether the palette is open.
@@ -2295,6 +2635,22 @@ export interface DomMonthCalendarProps {
 	 * Render weekday headers.
 	 */
 	dayHeaders?: boolean;
+	/**
+	 * Pin weekday headers to the active scrollport, below sticky month titles. When omitted, enabled in continuous mode and disabled in separated months.
+	 */
+	stickyDayHeaders?: boolean;
+	/**
+	 * Show the weekday name beside the date inside each day cell, including the mobile day list.
+	 */
+	showDayNames?: boolean;
+	/**
+	 * Highlight today with a cell outline, a coloured circle behind the date, or no visual indicator.
+	 */
+	todayIndicator?: "cell" | "circle" | "none";
+	/**
+	 * Classes for today’s date circle. Replaces the default primary background and foreground colours when todayIndicator is circle.
+	 */
+	todayDateClass?: string | Array<unknown> | Record<string, unknown> | ((...args: Array<unknown>) => unknown);
 	/**
 	 * Extra classes, or a function that receives a day cell and returns classes for the day cell.
 	 */
@@ -2443,6 +2799,91 @@ export interface DomWeekPlannerProps {
 }
 export declare const DomWeekPlanner: DomComponent<DomWeekPlannerProps>;
 
+/** GanttRangePayload, GanttItemPayload, GanttItemChangePayload payload types are exported from this module. */
+export interface DomGanttProps {
+	/**
+	 * Application-owned people, projects, or feature rows.
+	 */
+	rows?: Array<DomUnknownRecord>;
+	/**
+	 * Application-owned scheduled items. Multiple items may share a row.
+	 */
+	items?: Array<DomUnknownRecord>;
+	rowKey?: ResourceKeyResolver;
+	rowLabelKey?: ResourceFieldResolver;
+	itemKey?: ResourceKeyResolver;
+	itemRowKey?: ResourceFieldResolver;
+	titleKey?: ResourceFieldResolver;
+	startKey?: ResourceFieldResolver;
+	endKey?: ResourceFieldResolver;
+	durationKey?: ResourceFieldResolver;
+	toneKey?: ResourceFieldResolver;
+	/**
+	 * Whole local calendar days, or elapsed hours/minutes. An explicit end wins.
+	 */
+	durationUnit?: "days" | "hours" | "minutes";
+	/**
+	 * First local date of the scrollable range. Supply a stable value for SSR.
+	 */
+	startDate?: string | Date | number;
+	/**
+	 * Scrollable range in calendar days, from 1 to 3660. Change this or startDate to load another window.
+	 */
+	days?: number;
+	/**
+	 * Initial or v-model zoom. Days displays individual hours.
+	 */
+	zoom?: "months" | "weeks" | "days";
+	/**
+	 * Enable named row creation and pointer/keyboard time selection.
+	 */
+	planMode?: boolean;
+	/**
+	 * Allow items to move through time. Emits item-move; the application saves the change.
+	 */
+	draggableItems?: boolean;
+	/**
+	 * Allow moving items between rows when draggableItems is enabled. Enable for resource bookings; leave off for feature-based Gantt rows.
+	 */
+	allowRowChange?: boolean;
+	/**
+	 * Show a right-edge grip for shortening or extending an item. Emits item-resize.
+	 */
+	resizableItems?: boolean;
+	/**
+	 * Local start and exclusive end hour, e.g. [6, 18]. Outside hours are muted in day zoom.
+	 */
+	workingHours?: [number, number];
+	/**
+	 * Non-working weekdays: Sunday = 0, Saturday = 6. Muted, still selectable.
+	 */
+	weekendDays?: Array<number>;
+	/**
+	 * Compress out-of-hours time in day zoom. The toolbar can expand it again.
+	 */
+	hideNonWorkingHours?: boolean;
+	/**
+	 * Compress configured non-working weekdays at every zoom.
+	 */
+	hideWeekends?: boolean;
+	/**
+	 * Hourly-view selection snap in minutes (1–60). Other views snap to visible calendar days.
+	 */
+	selectionStep?: number;
+	/**
+	 * Minimum row height in pixels. Overlapping items expand the row.
+	 */
+	rowHeight?: number;
+	viewportHeight?: number;
+	rowHeading?: string;
+	addRowLabel?: string;
+	showToolbar?: boolean;
+	showCurrentTime?: boolean;
+	loading?: boolean;
+	ariaLabel?: string;
+}
+export declare const DomGantt: DomComponent<DomGanttProps>;
+
 /** MediaBrowserItem, MediaBrowserBreadcrumb, MediaBrowserDroppedFile, MediaBrowserSelectionPayload, MediaBrowserMovePayload, MediaBrowserUploadPayload, MediaBrowserDetailPayload payload types are exported from this module. */
 export interface DomMediaBrowserProps {
 	/**
@@ -4911,7 +5352,7 @@ export interface DomTextareaComposerProps {
 	 */
 	submitting?: boolean;
 	/**
-	 * Submit on Enter while Shift + Enter continues to add a new line.
+	 * When enabled, Enter submits and Shift + Enter adds a new line. When disabled, Enter adds a new line and Shift + Enter submits.
 	 */
 	submitOnEnter?: boolean;
 	/**
@@ -5082,8 +5523,17 @@ export interface DomNumberInputProps {
 	 * Render default field chrome, or hide chrome while keeping form state wiring.
 	 */
 	chrome?: "field" | "none" | false;
+	/**
+	 * Minimum accepted number and native spinbutton boundary.
+	 */
 	min?: number;
+	/**
+	 * Maximum accepted number and native spinbutton boundary.
+	 */
 	max?: number;
+	/**
+	 * Increment used by the browser spin buttons and arrow keys.
+	 */
 	step?: number;
 }
 export declare const DomNumberInput: DomComponent<DomNumberInputProps>;
@@ -5361,6 +5811,10 @@ export interface DomRangeInputProps {
 	 * Classes applied to the visual range track.
 	 */
 	trackClass?: string | Array<unknown> | Record<string, unknown>;
+	/**
+	 * Classes applied to the interactive track area, including its touch target height.
+	 */
+	controlClass?: string | Array<unknown> | Record<string, unknown>;
 	/**
 	 * Classes applied to the filled range track.
 	 */
@@ -6512,27 +6966,67 @@ export interface DomAppListItemProps {
 }
 export declare const DomAppListItem: DomComponent<DomAppListItemProps>;
 
-export interface DomAppShellProps {
+export interface DomAppProfileProps {
 	/**
-	 * Use app for full-screen app views and card for inset surfaces.
+	 * Account holder name; also supplies initials if the image is unavailable.
 	 */
-	variant?: "app" | "card";
+	name: string;
+	/**
+	 * Optional account email shown below the name.
+	 */
+	email?: string;
+	/**
+	 * Profile image URL. Falls back to initials if it cannot load.
+	 */
+	src?: string;
+	/**
+	 * Profile action label. Set to an empty string to hide the default action.
+	 */
+	actionLabel?: string;
 }
-export declare const DomAppShell: DomComponent<DomAppShellProps>;
+export declare const DomAppProfile: DomComponent<DomAppProfileProps>;
 
-export interface DomAppTopBarProps {
+export interface DomAppShellProps {
 	/**
-	 * Primary title shown in the app bar.
+	 * Resize to the visible viewport while editing. Use none when the native host owns keyboard layout.
 	 */
-	title?: string;
+	keyboardBehavior?: "resize" | "none";
 	/**
-	 * Optional supporting text below the title.
+	 * Optional native keyboard height in CSS pixels. Leave null to detect viewport changes; zero explicitly means closed.
 	 */
-	subtitle?: string;
+	keyboardInset?: number | null;
 	/**
-	 * Show a bottom divider.
+	 * Hide bottom navigation while the keyboard is visible. Leave false for a persistent reply composer.
 	 */
-	border?: boolean;
+	hideBottomOnKeyboard?: boolean;
+	/**
+	 * App height as a CSS length. Use 100dvh standalone, 36rem for an embedded app, or 100% inside a sized parent.
+	 */
+	height?: string;
+	/**
+	 * Let the main region scroll. Disable when a nested stack or split-pane layout owns scrolling.
+	 */
+	contentScroll?: boolean;
+	/**
+	 * Use app for full-screen app views and card for inset surfaces.
+	 */
+	variant?: "app" | "card";
+}
+export declare const DomAppShell: DomComponent<DomAppShellProps>;
+
+export interface DomAppTopBarProps {
+	/**
+	 * Primary title shown in the app bar.
+	 */
+	title?: string;
+	/**
+	 * Optional supporting text below the title.
+	 */
+	subtitle?: string;
+	/**
+	 * Show a bottom divider.
+	 */
+	border?: boolean;
 	/**
 	 * Use larger title sizing and padding.
 	 */
@@ -6541,6 +7035,10 @@ export interface DomAppTopBarProps {
 export declare const DomAppTopBar: DomComponent<DomAppTopBarProps>;
 
 export interface DomActionSheetProps {
+	/**
+	 * Defaults to contained inside DomAppShell, viewport otherwise. Explicit true requires a positioned, sized parent; prefer the shell overlay slot.
+	 */
+	contained?: boolean;
 	/**
 	 * Whether the action sheet is open.
 	 */
@@ -6554,7 +7052,7 @@ export interface DomActionSheetProps {
 	 */
 	description?: string;
 	/**
-	 * Action rows: { label, description, value, variant }.
+	 * Action rows: { label, description, value, variant, disabled }.
 	 */
 	actions?: Array<unknown>;
 	/**
@@ -6564,6 +7062,75 @@ export interface DomActionSheetProps {
 }
 export declare const DomActionSheet: DomComponent<DomActionSheetProps>;
 
+export interface DomBottomSheetProps {
+	/**
+	 * Whether the modal sheet is open.
+	 */
+	modelValue?: boolean;
+	/**
+	 * Visible title and accessible dialog name.
+	 */
+	title?: string;
+	/**
+	 * Accessible dialog name when supplying a custom header without a title.
+	 */
+	label?: string;
+	/**
+	 * Fractions of the available height, from 0 to 1. Include 0 to allow drag dismissal.
+	 */
+	snapPoints?: Array<number>;
+	/**
+	 * Preferred height on each open, rounded to the nearest non-zero stop.
+	 */
+	initialSnapPoint?: number;
+	/**
+	 * Optional controlled height. Use v-model:snapPoint; null uses internal state.
+	 */
+	snapPoint?: number | null;
+	/**
+	 * Defaults to contained in DomAppShell, viewport otherwise. Use the shell overlay slot.
+	 */
+	contained?: boolean;
+	/**
+	 * Disable backdrop dismissal. Close and Escape remain available; omit zero from snapPoints to disable drag dismissal.
+	 */
+	static?: boolean;
+	/**
+	 * Optional native keyboard inset for standalone sheets. Contained sheets inherit the resized shell.
+	 */
+	keyboardInset?: number | null;
+}
+export declare const DomBottomSheet: DomComponent<DomBottomSheetProps>;
+
+/** SwipeAction, SwipeActionPayload payload types are exported from this module. */
+export interface DomSwipeActionsProps {
+	/**
+	 * Row name used in the accessible Actions button label.
+	 */
+	label?: string;
+	/**
+	 * Leading actions: { value, label, icon, variant, disabled, fullSwipe }. icon is an SVG path.
+	 */
+	startActions?: Array<SwipeAction>;
+	/**
+	 * Trailing actions with the same shape as startActions.
+	 */
+	endActions?: Array<SwipeAction>;
+	/**
+	 * Allow the first action on each side to run after a full swipe only when that action also has fullSwipe: true.
+	 */
+	fullSwipe?: boolean;
+	/**
+	 * Disable gestures and all action controls.
+	 */
+	disabled?: boolean;
+	/**
+	 * Opening a row closes other rows in this group in the same document.
+	 */
+	group?: string;
+}
+export declare const DomSwipeActions: DomComponent<DomSwipeActionsProps>;
+
 export interface DomSafeAreaProps {
 	/**
 	 * Safe-area edges to apply: top, bottom, left, right.
@@ -6573,6 +7140,14 @@ export interface DomSafeAreaProps {
 export declare const DomSafeArea: DomComponent<DomSafeAreaProps>;
 
 export interface DomAppStackProps {
+	/**
+	 * Bounded stack height. Use 100% inside DomAppShell with content-scroll disabled, or a CSS length for an embedded stack.
+	 */
+	height?: string;
+	/**
+	 * Show the mobile back button and current screen title.
+	 */
+	showHeader?: boolean;
 	/**
 	 * Controlled stack path. Use v-model:path for two-way navigation.
 	 */
@@ -6594,7 +7169,7 @@ export interface DomAppStackProps {
 	 */
 	desktopBreakpoint?: string;
 	/**
-	 * Render the default breadcrumb bar, or provide the breadcrumb slot.
+	 * Show desktop breadcrumbs. Mobile uses the current title and back button; showHeader controls that header.
 	 */
 	showBreadcrumbs?: boolean;
 	/**
@@ -6693,6 +7268,558 @@ export interface DomRendererProps {
 }
 export declare const DomRenderer: DomComponent<DomRendererProps>;
 
+export interface DomLineChartProps {
+	/**
+	 * Application-owned records. Missing measurements remain gaps; zero is valid.
+	 */
+	rows?: Array<DomUnknownRecord>;
+	/**
+	 * Field keys or { key, label, color, dashed } definitions. Keep keys stable when filtering.
+	 */
+	series?: Array<string | ChartSeries>;
+	/**
+	 * Record field used for category or horizontal axis values.
+	 */
+	xKey?: string;
+	/**
+	 * Category preserves row order; time and number use proportional, sorted coordinates.
+	 */
+	xType?: "category" | "time" | "number";
+	/**
+	 * Visible title and accessible chart name.
+	 */
+	title?: string;
+	/**
+	 * Supporting context, units, or reporting period.
+	 */
+	description?: string;
+	/**
+	 * Plot height in pixels; width responds to its container.
+	 */
+	height?: number;
+	/**
+	 * Value format. Percent expects fractions, such as 0.25 for 25%.
+	 */
+	format?: "number" | "compact" | "currency" | "percent";
+	/**
+	 * ISO currency code for currency formatting.
+	 */
+	currency?: string;
+	/**
+	 * Locale used for number and date labels.
+	 */
+	locale?: string;
+	/**
+	 * Optional (value) => string override shared by axes, tooltips, and tables.
+	 */
+	valueFormatter?: (value: number) => string;
+	/**
+	 * Optional (value) => string override for category/date labels.
+	 */
+	xFormatter?: (value: unknown) => string;
+	/**
+	 * Optional (value) => string for value-axis ticks only. Tooltips and tables keep the full valueFormatter output.
+	 */
+	yFormatter?: (value: number) => string;
+	/**
+	 * Show a loading state in the reserved plot space.
+	 */
+	loading?: boolean;
+	/**
+	 * Show an application-owned error with a retry action.
+	 */
+	error?: string;
+	/**
+	 * Message when no finite measurements are available.
+	 */
+	emptyLabel?: string;
+	/**
+	 * Show buttons to toggle series without changing their colours.
+	 */
+	legend?: boolean;
+	/**
+	 * Offer an accessible, server-rendered table of the chart data.
+	 */
+	showTable?: boolean;
+	/**
+	 * Show subtle value-axis grid lines.
+	 */
+	grid?: boolean;
+	/**
+	 * Line interpolation. Linear avoids implying unobserved smooth changes.
+	 */
+	curve?: "linear" | "monotoneX" | "step";
+}
+export declare const DomLineChart: DomComponent<DomLineChartProps>;
+
+export interface DomAreaChartProps {
+	/**
+	 * Application-owned records. Missing measurements remain gaps; zero is valid.
+	 */
+	rows?: Array<DomUnknownRecord>;
+	/**
+	 * Field keys or { key, label, color, dashed } definitions. Keep keys stable when filtering.
+	 */
+	series?: Array<string | ChartSeries>;
+	/**
+	 * Record field used for category or horizontal axis values.
+	 */
+	xKey?: string;
+	/**
+	 * Category preserves row order; time and number use proportional, sorted coordinates.
+	 */
+	xType?: "category" | "time" | "number";
+	/**
+	 * Visible title and accessible chart name.
+	 */
+	title?: string;
+	/**
+	 * Supporting context, units, or reporting period.
+	 */
+	description?: string;
+	/**
+	 * Plot height in pixels; width responds to its container.
+	 */
+	height?: number;
+	/**
+	 * Value format. Percent expects fractions, such as 0.25 for 25%.
+	 */
+	format?: "number" | "compact" | "currency" | "percent";
+	/**
+	 * ISO currency code for currency formatting.
+	 */
+	currency?: string;
+	/**
+	 * Locale used for number and date labels.
+	 */
+	locale?: string;
+	/**
+	 * Optional (value) => string override shared by axes, tooltips, and tables.
+	 */
+	valueFormatter?: (value: number) => string;
+	/**
+	 * Optional (value) => string override for category/date labels.
+	 */
+	xFormatter?: (value: unknown) => string;
+	/**
+	 * Optional (value) => string for value-axis ticks only. Tooltips and tables keep the full valueFormatter output.
+	 */
+	yFormatter?: (value: number) => string;
+	/**
+	 * Show a loading state in the reserved plot space.
+	 */
+	loading?: boolean;
+	/**
+	 * Show an application-owned error with a retry action.
+	 */
+	error?: string;
+	/**
+	 * Message when no finite measurements are available.
+	 */
+	emptyLabel?: string;
+	/**
+	 * Show buttons to toggle series without changing their colours.
+	 */
+	legend?: boolean;
+	/**
+	 * Offer an accessible, server-rendered table of the chart data.
+	 */
+	showTable?: boolean;
+	/**
+	 * Show subtle value-axis grid lines.
+	 */
+	grid?: boolean;
+	/**
+	 * Line interpolation. Linear avoids implying unobserved smooth changes.
+	 */
+	curve?: "linear" | "monotoneX" | "step";
+	/**
+	 * Stack visible series on a shared baseline.
+	 */
+	stacked?: boolean;
+}
+export declare const DomAreaChart: DomComponent<DomAreaChartProps>;
+
+export interface DomBarChartProps {
+	/**
+	 * Application-owned records. Missing measurements remain gaps; zero is valid.
+	 */
+	rows?: Array<DomUnknownRecord>;
+	/**
+	 * Field keys or { key, label, color, dashed } definitions. Keep keys stable when filtering.
+	 */
+	series?: Array<string | ChartSeries>;
+	/**
+	 * Record field used for category or horizontal axis values.
+	 */
+	xKey?: string;
+	/**
+	 * Category preserves row order; time and number use proportional, sorted coordinates.
+	 */
+	xType?: "category" | "time" | "number";
+	/**
+	 * Visible title and accessible chart name.
+	 */
+	title?: string;
+	/**
+	 * Supporting context, units, or reporting period.
+	 */
+	description?: string;
+	/**
+	 * Plot height in pixels; width responds to its container.
+	 */
+	height?: number;
+	/**
+	 * Value format. Percent expects fractions, such as 0.25 for 25%.
+	 */
+	format?: "number" | "compact" | "currency" | "percent";
+	/**
+	 * ISO currency code for currency formatting.
+	 */
+	currency?: string;
+	/**
+	 * Locale used for number and date labels.
+	 */
+	locale?: string;
+	/**
+	 * Optional (value) => string override shared by axes, tooltips, and tables.
+	 */
+	valueFormatter?: (value: number) => string;
+	/**
+	 * Optional (value) => string override for category/date labels.
+	 */
+	xFormatter?: (value: unknown) => string;
+	/**
+	 * Optional (value) => string for value-axis ticks only. Tooltips and tables keep the full valueFormatter output.
+	 */
+	yFormatter?: (value: number) => string;
+	/**
+	 * Show a loading state in the reserved plot space.
+	 */
+	loading?: boolean;
+	/**
+	 * Show an application-owned error with a retry action.
+	 */
+	error?: string;
+	/**
+	 * Message when no finite measurements are available.
+	 */
+	emptyLabel?: string;
+	/**
+	 * Show buttons to toggle series without changing their colours.
+	 */
+	legend?: boolean;
+	/**
+	 * Offer an accessible, server-rendered table of the chart data.
+	 */
+	showTable?: boolean;
+	/**
+	 * Show subtle value-axis grid lines.
+	 */
+	grid?: boolean;
+	/**
+	 * Line interpolation. Linear avoids implying unobserved smooth changes.
+	 */
+	curve?: "linear" | "monotoneX" | "step";
+	/**
+	 * Stack series within each category.
+	 */
+	stacked?: boolean;
+	/**
+	 * Normalize non-negative visible series to a 100% stack.
+	 */
+	percentage?: boolean;
+	/**
+	 * Place category labels down the left side.
+	 */
+	horizontal?: boolean;
+}
+export declare const DomBarChart: DomComponent<DomBarChartProps>;
+
+export interface DomDonutChartProps {
+	/**
+	 * Application-owned records. Missing measurements remain gaps; zero is valid.
+	 */
+	rows?: Array<unknown>;
+	/**
+	 * Visible title and accessible chart name.
+	 */
+	title?: string;
+	/**
+	 * Supporting context, units, or reporting period.
+	 */
+	description?: string;
+	/**
+	 * Plot height in pixels; width responds to its container.
+	 */
+	height?: number;
+	/**
+	 * Value format. Percent expects fractions, such as 0.25 for 25%.
+	 */
+	format?: "number" | "compact" | "currency" | "percent";
+	/**
+	 * ISO currency code for currency formatting.
+	 */
+	currency?: string;
+	/**
+	 * Locale used for number and date labels.
+	 */
+	locale?: string;
+	/**
+	 * Optional (value) => string override shared by axes, tooltips, and tables.
+	 */
+	valueFormatter?: ((...args: Array<unknown>) => unknown);
+	/**
+	 * Show a loading state in the reserved plot space.
+	 */
+	loading?: boolean;
+	/**
+	 * Show an application-owned error with a retry action.
+	 */
+	error?: string;
+	/**
+	 * Message when no finite measurements are available.
+	 */
+	emptyLabel?: string;
+	/**
+	 * Show buttons to toggle series without changing their colours.
+	 */
+	legend?: boolean;
+	/**
+	 * Offer an accessible, server-rendered table of the chart data.
+	 */
+	showTable?: boolean;
+	/**
+	 * Unique category label field; supply one row per category.
+	 */
+	labelKey?: string;
+	/**
+	 * Non-negative measurement field.
+	 */
+	valueKey?: string;
+	/**
+	 * Optional field containing a semantic token or CSS colour.
+	 */
+	colorKey?: string;
+	/**
+	 * Caption beneath the sum of visible categories.
+	 */
+	totalLabel?: string;
+	/**
+	 * Ring thickness in pixels.
+	 */
+	arcWidth?: number;
+}
+export declare const DomDonutChart: DomComponent<DomDonutChartProps>;
+
+export interface DomSparklineProps {
+	/**
+	 * Application-owned records. Missing measurements remain gaps; zero is valid.
+	 */
+	rows?: Array<DomUnknownRecord>;
+	/**
+	 * Field keys or { key, label, color, dashed } definitions. Keep keys stable when filtering.
+	 */
+	series?: Array<string | ChartSeries>;
+	/**
+	 * Record field used for category or horizontal axis values.
+	 */
+	xKey?: string;
+	/**
+	 * Category preserves row order; time and number use proportional, sorted coordinates.
+	 */
+	xType?: "category" | "time" | "number";
+	title?: string;
+	/**
+	 * Supporting context, units, or reporting period.
+	 */
+	description?: string;
+	height?: number;
+	/**
+	 * Value format. Percent expects fractions, such as 0.25 for 25%.
+	 */
+	format?: "number" | "compact" | "currency" | "percent";
+	/**
+	 * ISO currency code for currency formatting.
+	 */
+	currency?: string;
+	/**
+	 * Locale used for number and date labels.
+	 */
+	locale?: string;
+	/**
+	 * Optional (value) => string override shared by axes, tooltips, and tables.
+	 */
+	valueFormatter?: (value: number) => string;
+	/**
+	 * Optional (value) => string override for category/date labels.
+	 */
+	xFormatter?: (value: unknown) => string;
+	/**
+	 * Optional (value) => string for value-axis ticks only. Tooltips and tables keep the full valueFormatter output.
+	 */
+	yFormatter?: (value: number) => string;
+	/**
+	 * Show a loading state in the reserved plot space.
+	 */
+	loading?: boolean;
+	/**
+	 * Show an application-owned error with a retry action.
+	 */
+	error?: string;
+	/**
+	 * Message when no finite measurements are available.
+	 */
+	emptyLabel?: string;
+	legend?: boolean;
+	showTable?: boolean;
+	/**
+	 * Show subtle value-axis grid lines.
+	 */
+	grid?: boolean;
+	/**
+	 * Line interpolation. Linear avoids implying unobserved smooth changes.
+	 */
+	curve?: "linear" | "monotoneX" | "step";
+}
+export declare const DomSparkline: DomComponent<DomSparklineProps>;
+
+export interface DomMetricCardProps {
+	/**
+	 * Metric name.
+	 */
+	label?: string;
+	/**
+	 * Current value. Null is unavailable; zero remains zero.
+	 */
+	value?: number;
+	format?: "number" | "compact" | "currency" | "percent";
+	currency?: string;
+	locale?: string;
+	/**
+	 * Relative change as a fraction, e.g. 0.12 for +12%. Calculated by the application.
+	 */
+	change?: number;
+	comparisonLabel?: string;
+	/**
+	 * Whether an increase or decrease represents improvement.
+	 */
+	trend?: "up-good" | "down-good" | "neutral";
+	loading?: boolean;
+	/**
+	 * Optional sparkline records.
+	 */
+	rows?: Array<unknown>;
+	xKey?: string;
+	valueKey?: string;
+	color?: string;
+}
+export declare const DomMetricCard: DomComponent<DomMetricCardProps>;
+
+export interface DomDateRangePickerProps {
+	/**
+	 * Controlled inclusive { start, end } dates in YYYY-MM-DD format.
+	 */
+	modelValue?: ChartDateRange;
+	comparison?: 'none' | 'previous-period' | 'previous-year';
+	showComparison?: boolean;
+	label?: string;
+	disabled?: boolean;
+	min?: string;
+	max?: string;
+	/**
+	 * Preset reference date. Defaults to browser-local today after mount; supply a reporting-timezone date for deterministic presets.
+	 */
+	anchorDate?: string;
+	locale?: string;
+}
+export declare const DomDateRangePicker: DomComponent<DomDateRangePickerProps>;
+
+export interface DomChartContainerProps {
+	title?: string;
+	description?: string;
+	height?: number;
+	loading?: boolean;
+	error?: string;
+	empty?: boolean;
+	emptyLabel?: string;
+	compact?: boolean;
+}
+export declare const DomChartContainer: DomComponent<DomChartContainerProps>;
+
+export interface DomChartLegendProps {
+	items?: Array<unknown>;
+	hiddenKeys?: Array<unknown>;
+}
+export declare const DomChartLegend: DomComponent<DomChartLegendProps>;
+
+export interface DomChartTooltipProps {
+	label?: string;
+	items?: Array<unknown>;
+}
+export declare const DomChartTooltip: DomComponent<DomChartTooltipProps>;
+
+export interface DomDesignerFrameProps {
+	as?: string;
+	layout?: Partial<DesignerFrameLayout>;
+}
+export declare const DomDesignerFrame: DomComponent<DomDesignerFrameProps>;
+
+export interface DomFrameLayoutEditorProps {
+	modelValue?: DesignerFrameLayout;
+}
+export declare const DomFrameLayoutEditor: DomComponent<DomFrameLayoutEditorProps>;
+
+export interface DomColorSwatchProps {
+	modelValue?: string;
+	label?: string;
+}
+export declare const DomColorSwatch: DomComponent<DomColorSwatchProps>;
+
+export interface DomShadowEditorProps {
+	modelValue?: Array<DesignerShadowLayer>;
+	title?: string;
+}
+export declare const DomShadowEditor: DomComponent<DomShadowEditorProps>;
+
+export type DomDesignerLayersProps = DomTreeViewProps;
+export declare const DomDesignerLayers: typeof DomTreeView;
+
+export interface DomDesignerStageProps {
+	modelValue?: string;
+	positioning?: boolean;
+	interactive?: boolean;
+	snapping?: boolean;
+	/**
+	 * Repeat horizontal and vertical layer gaps while dragging. Independent of alignment snapping; disabled by default.
+	 */
+	spacingSnapping?: boolean;
+	/**
+	 * Only move children of an absolute data-designer-frame. Snap to that frame and its direct children.
+	 */
+	frameScoped?: boolean;
+}
+export declare const DomDesignerStage: DomComponent<DomDesignerStageProps>;
+
+export interface DomBorderEditorProps {
+	modelValue?: Record<string, unknown>;
+	title?: string;
+	maxWidth?: number;
+}
+export declare const DomBorderEditor: DomComponent<DomBorderEditorProps>;
+
+export interface DomBackgroundEditorProps {
+	modelValue?: Record<string, unknown>;
+	title?: string;
+}
+export declare const DomBackgroundEditor: DomComponent<DomBackgroundEditorProps>;
+
+export interface DomBackdropEditorProps {
+	modelValue?: Record<string, unknown>;
+	title?: string;
+}
+export declare const DomBackdropEditor: DomComponent<DomBackdropEditorProps>;
+
 export declare const popoverProps: DomRuntimeProps;
 export declare const calendarProps: DomRuntimeProps;
 export declare const filterBarProps: DomRuntimeProps;
@@ -6702,6 +7829,7 @@ export declare const breadcrumbsProps: DomRuntimeProps;
 export declare const kanbanProps: DomRuntimeProps;
 export declare const monthCalendarProps: DomRuntimeProps;
 export declare const weekPlannerProps: DomRuntimeProps;
+export declare const ganttProps: DomRuntimeProps;
 export declare const agentChatShellProps: DomRuntimeProps;
 export declare const agentConversationProps: DomRuntimeProps;
 export declare const agentConversationListProps: DomRuntimeProps;
@@ -6722,6 +7850,23 @@ export declare const themeModeValues: Array<DomThemeMode>;
 export declare const resolvedTheme: ComputedRef<DomResolvedTheme>;
 export declare const vDomTooltip: Directive<HTMLElement, DomTooltipDirectiveValue>;
 
+export interface DesignerFrameLayout { mode: 'flow' | 'flex' | 'grid' | 'absolute'; direction: 'row' | 'column' | 'row-reverse' | 'column-reverse'; wrap: 'nowrap' | 'wrap'; gap: number; padding: number; justify: 'start' | 'center' | 'end' | 'space-between' | 'space-around' | 'space-evenly'; align: 'start' | 'center' | 'end' | 'stretch' | 'baseline'; justifyItems: 'start' | 'center' | 'end' | 'stretch'; autoFlow: 'row' | 'column' | 'row dense' | 'column dense'; columns: string; rows: string; }
+export declare function createFrameLayout(value?: Partial<DesignerFrameLayout>): DesignerFrameLayout;
+export declare function frameLayoutStyle(value?: Partial<DesignerFrameLayout>): Record<string, string>;
+export interface DesignerShadowLayer { id: string; enabled: boolean; open?: boolean; kind: 'drop' | 'inset' | 'ring'; color: string; alpha: number; x: number; y: number; blur: number; spread: number; }
+export interface DesignerBackdrop { enabled: boolean; blur: number; saturate: number; open?: boolean; }
+export interface DesignerFill { id: string; enabled: boolean; open?: boolean; kind: string; color: string; alpha: number; gradientFrom: string; gradientTo: string; gradientFromAlpha: number; gradientToAlpha: number; gradientAngle: number; gradientFromStop: number; gradientToStop: number; }
+export interface DesignerBackground { enabled: boolean; open?: boolean; blendMode?: string; fills: DesignerFill[]; }
+export declare function createBackdrop(overrides?: Partial<DesignerBackdrop>): DesignerBackdrop;
+export declare function backdropToCss(backdrop?: DesignerBackdrop): string;
+export declare function createFill(overrides?: Partial<DesignerFill>): DesignerFill;
+export declare function createBackgroundState(overrides?: Omit<Partial<DesignerBackground>, "fills"> & { fills?: Partial<DesignerFill>[] }, options?: { allowEmpty?: boolean }): DesignerBackground;
+export declare function backgroundImageToCss(background?: DesignerBackground): string;
+export interface DesignerBorder { enabled: boolean; width: number; style: string; color: string; }
+export declare function createDesignerBorder(overrides?: Partial<DesignerBorder>): DesignerBorder;
+export declare function borderToCss(border?: DesignerBorder): string;
+export declare function createShadow(overrides?: Partial<DesignerShadowLayer>): DesignerShadowLayer;
+export declare function shadowListToCss(layers: Array<DesignerShadowLayer>): string;
 export declare function normalizeThemeMode(value: unknown): DomThemeMode;
 export declare function resolveThemeMode(value?: unknown, prefersDark?: boolean): DomResolvedTheme;
 export declare function readThemeMode(): DomThemeMode;
@@ -6731,6 +7876,8 @@ export declare function cycleThemeMode(): DomResolvedTheme;
 export declare function applyThemeMode(value?: unknown): DomResolvedTheme;
 export declare function useTheme(): DomThemeApi;
 export declare function useToasts(defaults?: ToastOptions): ToastApi;
+export declare function notificationTone(severity?: InAppNotificationSeverity | 'danger' | null): 'info' | 'success' | 'warning' | 'danger';
+export declare function notificationToast(item: InAppNotificationItem, options?: NotificationToastOptions): ToastOptions & { id: string };
 export declare function useDialogs(defaults?: DialogOptions): DialogApi;
 export declare function defineAgentChatStore(storeId?: string, options?: AgentChatStoreOptions): Function;
 export declare function createAgentChatRestApi(options?: AgentChatStoreOptions): Record<string, Function>;