vue-dockable-desktop 1.0.0

package/dist/core/sidebarTypes.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Sidebar configuration shapes.
+ *
+ * `renderContent` is gone: content comes from a `#tab-<id>` slot or a `component` field
+ * (docs/decisions/0007-slots-over-render-props.md). Everything else keeps rdd's names.
+ */
+import type { Component, InjectionKey, Ref } from 'vue';
+/** One tab in the activity bar. */
+export interface SidebarTab {
+    id: string;
+    label: string;
+    /** Required unless `hidden` — a hidden tab renders no rail button, so it has no icon to show. */
+    icon?: Component;
+    /**
+     * Render no rail button, while the tab stays fully openable through `v-model:active-tab-id`
+     * or `useSidebar().openTab()`. For menu-driven panels with no permanent icon.
+     * @default false
+     */
+    hidden?: boolean;
+    /** Mount as soon as the sidebar renders, not on first open. Implies `preserveState`. @default false */
+    eagerMount?: boolean;
+    /** Keep the content alive behind `display: none` when closed, instead of unmounting it. @default false */
+    preserveState?: boolean;
+    /** Content, when it comes from data rather than a slot. A `#tab-<id>` slot wins over this. */
+    component?: Component;
+    /** Props for `component`. */
+    props?: Record<string, unknown>;
+}
+/** A rail button that does not toggle the drawer — a hamburger, say. */
+export interface SidebarActionButton {
+    /** Needed only inside an array, for the key. */
+    id?: string;
+    icon: Component;
+    /** Tooltip and accessible name. */
+    label: string;
+    onClick: () => void;
+    disabled?: boolean;
+}
+/** A rail entry the caller renders entirely themselves. */
+export interface SidebarCustomEntry {
+    id?: string;
+    /** Rendered as-is, unwrapped, so the caller's own styling and behaviour are untouched. */
+    component: Component;
+    props?: Record<string, unknown>;
+    /** Marks this as a custom entry rather than a tab, since both carry `component`. */
+    custom: true;
+}
+/**
+ * An entry in the header or footer area of the rail: a plain button, a caller-rendered
+ * component, or a real tab that behaves exactly like one from the main list.
+ */
+export type SidebarRailEntry = SidebarTab | SidebarActionButton | SidebarCustomEntry;
+export declare const isCustomEntry: (entry: SidebarRailEntry) => entry is SidebarCustomEntry;
+export declare const isTabEntry: (entry: SidebarRailEntry) => entry is SidebarTab;
+export declare const isActionButton: (entry: SidebarRailEntry) => entry is SidebarActionButton;
+/** Normalise the single-or-array shape both areas accept. */
+export declare const toRailArray: (value: SidebarRailEntry | SidebarRailEntry[] | undefined) => SidebarRailEntry[];
+/**
+ * `<VddSidebar>`'s props, declared here so `<VddSecondarySidebar>` can forward them with
+ * their types intact. Forwarding through `$attrs` alone works at runtime but throws the
+ * types away, which is most of the point of declaring them.
+ *
+ * The four two-way values — the open tab, visibility, strip visibility and width — are
+ * models rather than props, so they are not listed here.
+ */
+export interface SidebarProps {
+    /** Which edge the bar and drawer sit on. @default 'right' */
+    position?: 'left' | 'right';
+    tabs: SidebarTab[];
+    /** Entries above the tabs, in their own area. A single entry or an array. */
+    headerAction?: SidebarRailEntry | SidebarRailEntry[];
+    /** Entries pinned below the tabs. */
+    footerAction?: SidebarRailEntry | SidebarRailEntry[];
+    minWidth?: number;
+    maxWidth?: number;
+    /** Show an "X" in the drawer header. No effect once the default header is suppressed. @default false */
+    showCloseButton?: boolean;
+    /** Suppress the library's own drawer header for every tab. @default false */
+    hideDefaultHeader?: boolean;
+    /** @internal set by `<VddSecondarySidebar>`. */
+    isSecondary?: boolean;
+}
+/** What `useSidebar()` returns: control of the drawer from anywhere inside it. */
+export interface SidebarContext {
+    openTab: (id: string) => void;
+    closeDrawer: () => void;
+    /** The open tab, or `null`. Reactive. */
+    activeTabId: Ref<string | null>;
+    position: 'left' | 'right';
+    /** True for a `<VddSecondarySidebar>`. */
+    isSecondary: boolean;
+}
+/** What `useSidebarTab()` returns: control scoped to the tab you are inside. */
+export interface SidebarTabContext {
+    tabId: string;
+    open: () => void;
+    close: () => void;
+    /** Switch to another tab. */
+    openTab: (id: string) => void;
+}
+export declare const SIDEBAR_KEY: InjectionKey<SidebarContext>;
+export declare const SIDEBAR_TAB_KEY: InjectionKey<SidebarTabContext>;

package/dist/core/stretch.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The stretch algebra for docked inner widgets.
+ *
+ * A docked widget normally pins one end of each axis and carries an explicit size. A
+ * *stretched* axis pins **both** ends and carries no size at all, so the widget tracks its
+ * panel as the panel resizes — with no ResizeObserver and no JavaScript, because CSS
+ * already does exactly this. "Full width" is not a width; it is a second pin.
+ *
+ * Pure functions over two values, so the nine placements (three inline states × three
+ * block states, minus the impossible) are testable without a DOM.
+ */
+import type { FloatAnchor } from '../types';
+/** Which axes span the panel instead of carrying a size. */
+export type Stretch = 'width' | 'height' | 'both';
+/** Where a docked widget sits: its corner, plus which axes span. Reported as one unit
+ *  because a single gesture can change both, and reporting separately would surface a
+ *  state that is never valid. */
+export interface PanelFloatPlacement {
+    anchor: FloatAnchor;
+    stretch: Stretch | null;
+}
+export declare const stretchesInline: (s: Stretch | null) => boolean;
+export declare const stretchesBlock: (s: Stretch | null) => boolean;
+/** Add one axis, keeping whatever was already stretched. */
+export declare const addAxis: (s: Stretch | null, axis: "inline" | "block") => Stretch;
+/** Drop one axis, keeping the other. */
+export declare const releaseAxis: (s: Stretch | null, axis: "inline" | "block") => Stretch | null;
+export declare const ANCHORS: readonly FloatAnchor[];
+/**
+ * Which stacking buckets a placement occupies.
+ *
+ * The four corner buckets are a proxy for *"do these overlap on the inline axis?"* — two
+ * widgets in one corner overlap and stack; opposite corners sit side by side and do not. A
+ * full-width strip overlaps everything on its edge, so it belongs to **both** buckets of
+ * that edge and pushes whatever is stacked in either.
+ *
+ * A block-stretched widget spans the very axis stacking uses to separate siblings, so it
+ * cannot participate at all and occupies no bucket — z-order decides any overlap.
+ *
+ * Computing true inline overlap was considered and rejected: widths change continuously
+ * during a resize drag, so widgets would reshuffle mid-gesture.
+ */
+export declare const bucketsFor: (anchor: FloatAnchor, stretch: Stretch | null) => FloatAnchor[];
+/** Replace the inline half of a corner, leaving the block half alone. */
+export declare const withInlineHalf: (a: FloatAnchor, half: "left" | "right") => FloatAnchor;
+/** Replace the block half of a corner, leaving the inline half alone. */
+export declare const withBlockHalf: (a: FloatAnchor, half: "top" | "bottom") => FloatAnchor;

package/dist/core/toast.d.ts

@@ -0,0 +1,474 @@
+import type { Component } from 'vue';
+export type ToastType = 'info' | 'success' | 'warning' | 'error';
+export type ToastPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+/** Per-toast options. Anything omitted falls back to the `<VddToasts>` defaults. */
+export interface ToastOptions {
+    /** @default 'info' — set for you by the `toast.info`/`success`/… shorthands. */
+    type?: ToastType;
+    /** Auto-dismiss delay in ms. `0` never auto-dismisses. @default from the container */
+    duration?: number;
+    /** Supply to deduplicate: calling again with the same id updates that toast in place. */
+    id?: string;
+    /** @default from the container */
+    closable?: boolean;
+    /** Replaces the built-in type icon. */
+    icon?: Component;
+    /** Replaces the message string with a component. */
+    content?: Component;
+    /** Props for `content`. */
+    contentProps?: Record<string, unknown>;
+    /** Called on dismissal by timer, close button or `toast.dismiss()`. */
+    onClose?: () => void;
+}
+/** A toast's options with every default filled in. What an adapter receives. */
+export interface ResolvedToastOptions extends Required<Pick<ToastOptions, 'id' | 'type' | 'duration' | 'closable'>> {
+    icon?: Component;
+    content?: Component;
+    contentProps?: Record<string, unknown>;
+    onClose?: () => void;
+}
+/** One toast in the store. */
+export interface ToastRecord {
+    id: string;
+    message: string;
+    options: ToastOptions & {
+        id: string;
+    };
+    /** Set while the exit transition runs; an exiting toast no longer counts as visible. */
+    exiting: boolean;
+    /** Bumped whenever the toast is updated, so a watcher can restart its timer. */
+    revision: number;
+}
+/** Messages for `toast.promise()`. The settled forms may be functions of the value. */
+export interface ToastPromiseMessages<T> {
+    pending: string;
+    success: string | ((result: T) => string);
+    error: string | ((error: unknown) => string);
+}
+/**
+ * Hand every `toast.*` call to another notification library instead.
+ *
+ * `component` is rendered by `<VddToasts>` in place of the built-in list; `null` means the
+ * adapter owns its own DOM and `<VddToasts>` renders nothing at all.
+ */
+export interface ToastAdapter {
+    show(id: string, message: string, options: ResolvedToastOptions): void;
+    update(id: string, message: string, patch: Partial<ResolvedToastOptions>): void;
+    /** With no id, dismiss everything. */
+    dismiss(id?: string): void;
+    component: Component | null;
+}
+/** The live queue. Exported for `<VddToasts>` and for tests; applications use `toast`. */
+export declare const toastQueue: {
+    items: {
+        id: string;
+        message: string;
+        options: {
+            type?: ToastType
+            /** Auto-dismiss delay in ms. `0` never auto-dismisses. @default from the container */
+             | undefined;
+            duration?: number
+            /** Supply to deduplicate: calling again with the same id updates that toast in place. */
+             | undefined;
+            id: string;
+            closable?: boolean
+            /** Replaces the built-in type icon. */
+             | undefined;
+            icon?: import("vue").FunctionalComponent<any, {}, any, {}> | {
+                new (...args: any[]): any;
+                __isFragment?: never;
+                __isTeleport?: never;
+                __isSuspense?: never;
+            } | {
+                [x: string]: any;
+                setup?: ((this: void, props: import("@vue/shared").LooseRequired<any>, ctx: {
+                    attrs: import("vue").Attrs;
+                    slots: Readonly<{
+                        [name: string]: import("vue").Slot<any> | undefined;
+                    }>;
+                    emit: ((event: unknown, ...args: any[]) => void) | ((event: string, ...args: any[]) => void);
+                    expose: <Exposed extends Record<string, any> = Record<string, any>>(exposed?: Exposed) => void;
+                }) => any) | undefined;
+                name?: string | undefined;
+                template?: string | object | undefined;
+                render?: Function | undefined;
+                components?: Record<string, Component<any, any, any, import("vue").ComputedOptions, import("vue").MethodOptions, {}, any>> | undefined;
+                directives?: Record<string, import("vue").Directive<any, any, string, any>> | undefined;
+                inheritAttrs?: boolean | undefined;
+                emits?: any;
+                slots?: {} | undefined;
+                expose?: string[] | undefined;
+                serverPrefetch?: (() => void | Promise<any>) | undefined;
+                compilerOptions?: {
+                    isCustomElement?: ((tag: string) => boolean) | undefined;
+                    whitespace?: "preserve" | "condense" | undefined;
+                    comments?: boolean | undefined;
+                    delimiters?: [string, string] | undefined;
+                } | undefined;
+                call?: ((this: unknown, ...args: unknown[]) => never) | undefined;
+                __isFragment?: never | undefined;
+                __isTeleport?: never | undefined;
+                __isSuspense?: never | undefined;
+                __defaults?: {} | undefined;
+                compatConfig?: {
+                    GLOBAL_MOUNT?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_MOUNT_CONTAINER?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_EXTEND?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_PROTOTYPE?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_SET?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_DELETE?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_OBSERVABLE?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_PRIVATE_UTIL?: boolean | "suppress-warning" | undefined;
+                    CONFIG_SILENT?: boolean | "suppress-warning" | undefined;
+                    CONFIG_DEVTOOLS?: boolean | "suppress-warning" | undefined;
+                    CONFIG_KEY_CODES?: boolean | "suppress-warning" | undefined;
+                    CONFIG_PRODUCTION_TIP?: boolean | "suppress-warning" | undefined;
+                    CONFIG_IGNORED_ELEMENTS?: boolean | "suppress-warning" | undefined;
+                    CONFIG_WHITESPACE?: boolean | "suppress-warning" | undefined;
+                    CONFIG_OPTION_MERGE_STRATS?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_SET?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_DELETE?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_DESTROY?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_EVENT_EMITTER?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_EVENT_HOOKS?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_CHILDREN?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_LISTENERS?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_SCOPED_SLOTS?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_ATTRS_CLASS_STYLE?: boolean | "suppress-warning" | undefined;
+                    OPTIONS_DATA_FN?: boolean | "suppress-warning" | undefined;
+                    OPTIONS_DATA_MERGE?: boolean | "suppress-warning" | undefined;
+                    OPTIONS_BEFORE_DESTROY?: boolean | "suppress-warning" | undefined;
+                    OPTIONS_DESTROYED?: boolean | "suppress-warning" | undefined;
+                    WATCH_ARRAY?: boolean | "suppress-warning" | undefined;
+                    PROPS_DEFAULT_THIS?: boolean | "suppress-warning" | undefined;
+                    V_ON_KEYCODE_MODIFIER?: boolean | "suppress-warning" | undefined;
+                    CUSTOM_DIR?: boolean | "suppress-warning" | undefined;
+                    ATTR_FALSE_VALUE?: boolean | "suppress-warning" | undefined;
+                    ATTR_ENUMERATED_COERCION?: boolean | "suppress-warning" | undefined;
+                    TRANSITION_CLASSES?: boolean | "suppress-warning" | undefined;
+                    TRANSITION_GROUP_ROOT?: boolean | "suppress-warning" | undefined;
+                    COMPONENT_ASYNC?: boolean | "suppress-warning" | undefined;
+                    COMPONENT_FUNCTIONAL?: boolean | "suppress-warning" | undefined;
+                    COMPONENT_V_MODEL?: boolean | "suppress-warning" | undefined;
+                    RENDER_FUNCTION?: boolean | "suppress-warning" | undefined;
+                    FILTERS?: boolean | "suppress-warning" | undefined;
+                    PRIVATE_APIS?: boolean | "suppress-warning" | undefined;
+                    MODE?: 2 | 3 | ((comp: Component | null) => 2 | 3) | undefined;
+                } | undefined;
+                data?: ((this: any, vm: any) => any) | undefined;
+                computed?: import("vue").ComputedOptions | undefined;
+                methods?: import("vue").MethodOptions | undefined;
+                watch?: {
+                    [x: string]: (string | import("vue").WatchCallback | ({
+                        handler: import("vue").WatchCallback | string;
+                    } & import("vue").WatchOptions<boolean>)) | (string | import("vue").WatchCallback | ({
+                        handler: import("vue").WatchCallback | string;
+                    } & import("vue").WatchOptions<boolean>))[];
+                } | undefined;
+                provide?: import("vue").ComponentProvideOptions | undefined;
+                inject?: {} | string[] | undefined;
+                filters?: Record<string, Function> | undefined;
+                mixins?: any[] | undefined;
+                extends?: any;
+                beforeCreate?: (() => any) | undefined;
+                created?: (() => any) | undefined;
+                beforeMount?: (() => any) | undefined;
+                mounted?: (() => any) | undefined;
+                beforeUpdate?: (() => any) | undefined;
+                updated?: (() => any) | undefined;
+                activated?: (() => any) | undefined;
+                deactivated?: (() => any) | undefined;
+                beforeDestroy?: (() => any) | undefined;
+                beforeUnmount?: (() => any) | undefined;
+                destroyed?: (() => any) | undefined;
+                unmounted?: (() => any) | undefined;
+                renderTracked?: ((e: import("vue").DebuggerEvent) => void) | undefined;
+                renderTriggered?: ((e: import("vue").DebuggerEvent) => void) | undefined;
+                errorCaptured?: ((err: unknown, instance: import("vue").ComponentPublicInstance | null, info: string) => boolean | void) | undefined;
+                delimiters?: [string, string] | undefined;
+                __differentiator?: string | number | symbol | undefined;
+                __isBuiltIn?: boolean | undefined;
+                __file?: string | undefined;
+                __name?: string | undefined;
+            } | undefined;
+            content?: import("vue").FunctionalComponent<any, {}, any, {}> | {
+                new (...args: any[]): any;
+                __isFragment?: never;
+                __isTeleport?: never;
+                __isSuspense?: never;
+            } | {
+                [x: string]: any;
+                setup?: ((this: void, props: import("@vue/shared").LooseRequired<any>, ctx: {
+                    attrs: import("vue").Attrs;
+                    slots: Readonly<{
+                        [name: string]: import("vue").Slot<any> | undefined;
+                    }>;
+                    emit: ((event: unknown, ...args: any[]) => void) | ((event: string, ...args: any[]) => void);
+                    expose: <Exposed extends Record<string, any> = Record<string, any>>(exposed?: Exposed) => void;
+                }) => any) | undefined;
+                name?: string | undefined;
+                template?: string | object | undefined;
+                render?: Function | undefined;
+                components?: Record<string, Component<any, any, any, import("vue").ComputedOptions, import("vue").MethodOptions, {}, any>> | undefined;
+                directives?: Record<string, import("vue").Directive<any, any, string, any>> | undefined;
+                inheritAttrs?: boolean | undefined;
+                emits?: any;
+                slots?: {} | undefined;
+                expose?: string[] | undefined;
+                serverPrefetch?: (() => void | Promise<any>) | undefined;
+                compilerOptions?: {
+                    isCustomElement?: ((tag: string) => boolean) | undefined;
+                    whitespace?: "preserve" | "condense" | undefined;
+                    comments?: boolean | undefined;
+                    delimiters?: [string, string] | undefined;
+                } | undefined;
+                call?: ((this: unknown, ...args: unknown[]) => never) | undefined;
+                __isFragment?: never | undefined;
+                __isTeleport?: never | undefined;
+                __isSuspense?: never | undefined;
+                __defaults?: {} | undefined;
+                compatConfig?: {
+                    GLOBAL_MOUNT?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_MOUNT_CONTAINER?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_EXTEND?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_PROTOTYPE?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_SET?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_DELETE?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_OBSERVABLE?: boolean | "suppress-warning" | undefined;
+                    GLOBAL_PRIVATE_UTIL?: boolean | "suppress-warning" | undefined;
+                    CONFIG_SILENT?: boolean | "suppress-warning" | undefined;
+                    CONFIG_DEVTOOLS?: boolean | "suppress-warning" | undefined;
+                    CONFIG_KEY_CODES?: boolean | "suppress-warning" | undefined;
+                    CONFIG_PRODUCTION_TIP?: boolean | "suppress-warning" | undefined;
+                    CONFIG_IGNORED_ELEMENTS?: boolean | "suppress-warning" | undefined;
+                    CONFIG_WHITESPACE?: boolean | "suppress-warning" | undefined;
+                    CONFIG_OPTION_MERGE_STRATS?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_SET?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_DELETE?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_DESTROY?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_EVENT_EMITTER?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_EVENT_HOOKS?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_CHILDREN?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_LISTENERS?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_SCOPED_SLOTS?: boolean | "suppress-warning" | undefined;
+                    INSTANCE_ATTRS_CLASS_STYLE?: boolean | "suppress-warning" | undefined;
+                    OPTIONS_DATA_FN?: boolean | "suppress-warning" | undefined;
+                    OPTIONS_DATA_MERGE?: boolean | "suppress-warning" | undefined;
+                    OPTIONS_BEFORE_DESTROY?: boolean | "suppress-warning" | undefined;
+                    OPTIONS_DESTROYED?: boolean | "suppress-warning" | undefined;
+                    WATCH_ARRAY?: boolean | "suppress-warning" | undefined;
+                    PROPS_DEFAULT_THIS?: boolean | "suppress-warning" | undefined;
+                    V_ON_KEYCODE_MODIFIER?: boolean | "suppress-warning" | undefined;
+                    CUSTOM_DIR?: boolean | "suppress-warning" | undefined;
+                    ATTR_FALSE_VALUE?: boolean | "suppress-warning" | undefined;
+                    ATTR_ENUMERATED_COERCION?: boolean | "suppress-warning" | undefined;
+                    TRANSITION_CLASSES?: boolean | "suppress-warning" | undefined;
+                    TRANSITION_GROUP_ROOT?: boolean | "suppress-warning" | undefined;
+                    COMPONENT_ASYNC?: boolean | "suppress-warning" | undefined;
+                    COMPONENT_FUNCTIONAL?: boolean | "suppress-warning" | undefined;
+                    COMPONENT_V_MODEL?: boolean | "suppress-warning" | undefined;
+                    RENDER_FUNCTION?: boolean | "suppress-warning" | undefined;
+                    FILTERS?: boolean | "suppress-warning" | undefined;
+                    PRIVATE_APIS?: boolean | "suppress-warning" | undefined;
+                    MODE?: 2 | 3 | ((comp: Component | null) => 2 | 3) | undefined;
+                } | undefined;
+                data?: ((this: any, vm: any) => any) | undefined;
+                computed?: import("vue").ComputedOptions | undefined;
+                methods?: import("vue").MethodOptions | undefined;
+                watch?: {
+                    [x: string]: (string | import("vue").WatchCallback | ({
+                        handler: import("vue").WatchCallback | string;
+                    } & import("vue").WatchOptions<boolean>)) | (string | import("vue").WatchCallback | ({
+                        handler: import("vue").WatchCallback | string;
+                    } & import("vue").WatchOptions<boolean>))[];
+                } | undefined;
+                provide?: import("vue").ComponentProvideOptions | undefined;
+                inject?: {} | string[] | undefined;
+                filters?: Record<string, Function> | undefined;
+                mixins?: any[] | undefined;
+                extends?: any;
+                beforeCreate?: (() => any) | undefined;
+                created?: (() => any) | undefined;
+                beforeMount?: (() => any) | undefined;
+                mounted?: (() => any) | undefined;
+                beforeUpdate?: (() => any) | undefined;
+                updated?: (() => any) | undefined;
+                activated?: (() => any) | undefined;
+                deactivated?: (() => any) | undefined;
+                beforeDestroy?: (() => any) | undefined;
+                beforeUnmount?: (() => any) | undefined;
+                destroyed?: (() => any) | undefined;
+                unmounted?: (() => any) | undefined;
+                renderTracked?: ((e: import("vue").DebuggerEvent) => void) | undefined;
+                renderTriggered?: ((e: import("vue").DebuggerEvent) => void) | undefined;
+                errorCaptured?: ((err: unknown, instance: import("vue").ComponentPublicInstance | null, info: string) => boolean | void) | undefined;
+                delimiters?: [string, string] | undefined;
+                __differentiator?: string | number | symbol | undefined;
+                __isBuiltIn?: boolean | undefined;
+                __file?: string | undefined;
+                __name?: string | undefined;
+            } | undefined;
+            contentProps?: Record<string, unknown>
+            /** Called on dismissal by timer, close button or `toast.dismiss()`. */
+             | undefined;
+            onClose?: (() => void) | undefined;
+        };
+        exiting: boolean;
+        revision: number;
+    }[];
+    adapter: {
+        show: (id: string, message: string, options: ResolvedToastOptions) => void;
+        update: (id: string, message: string, patch: Partial<ResolvedToastOptions>) => void;
+        dismiss: (id?: string) => void;
+        component: import("vue").FunctionalComponent<any, {}, any, {}> | {
+            new (...args: any[]): any;
+            __isFragment?: never;
+            __isTeleport?: never;
+            __isSuspense?: never;
+        } | {
+            [x: string]: any;
+            setup?: ((this: void, props: import("@vue/shared").LooseRequired<any>, ctx: {
+                attrs: import("vue").Attrs;
+                slots: Readonly<{
+                    [name: string]: import("vue").Slot<any> | undefined;
+                }>;
+                emit: ((event: unknown, ...args: any[]) => void) | ((event: string, ...args: any[]) => void);
+                expose: <Exposed extends Record<string, any> = Record<string, any>>(exposed?: Exposed) => void;
+            }) => any) | undefined;
+            name?: string | undefined;
+            template?: string | object | undefined;
+            render?: Function | undefined;
+            components?: Record<string, Component<any, any, any, import("vue").ComputedOptions, import("vue").MethodOptions, {}, any>> | undefined;
+            directives?: Record<string, import("vue").Directive<any, any, string, any>> | undefined;
+            inheritAttrs?: boolean | undefined;
+            emits?: any;
+            slots?: {} | undefined;
+            expose?: string[] | undefined;
+            serverPrefetch?: (() => void | Promise<any>) | undefined;
+            compilerOptions?: {
+                isCustomElement?: ((tag: string) => boolean) | undefined;
+                whitespace?: "preserve" | "condense" | undefined;
+                comments?: boolean | undefined;
+                delimiters?: [string, string] | undefined;
+            } | undefined;
+            call?: ((this: unknown, ...args: unknown[]) => never) | undefined;
+            __isFragment?: never | undefined;
+            __isTeleport?: never | undefined;
+            __isSuspense?: never | undefined;
+            __defaults?: {} | undefined;
+            compatConfig?: {
+                GLOBAL_MOUNT?: boolean | "suppress-warning" | undefined;
+                GLOBAL_MOUNT_CONTAINER?: boolean | "suppress-warning" | undefined;
+                GLOBAL_EXTEND?: boolean | "suppress-warning" | undefined;
+                GLOBAL_PROTOTYPE?: boolean | "suppress-warning" | undefined;
+                GLOBAL_SET?: boolean | "suppress-warning" | undefined;
+                GLOBAL_DELETE?: boolean | "suppress-warning" | undefined;
+                GLOBAL_OBSERVABLE?: boolean | "suppress-warning" | undefined;
+                GLOBAL_PRIVATE_UTIL?: boolean | "suppress-warning" | undefined;
+                CONFIG_SILENT?: boolean | "suppress-warning" | undefined;
+                CONFIG_DEVTOOLS?: boolean | "suppress-warning" | undefined;
+                CONFIG_KEY_CODES?: boolean | "suppress-warning" | undefined;
+                CONFIG_PRODUCTION_TIP?: boolean | "suppress-warning" | undefined;
+                CONFIG_IGNORED_ELEMENTS?: boolean | "suppress-warning" | undefined;
+                CONFIG_WHITESPACE?: boolean | "suppress-warning" | undefined;
+                CONFIG_OPTION_MERGE_STRATS?: boolean | "suppress-warning" | undefined;
+                INSTANCE_SET?: boolean | "suppress-warning" | undefined;
+                INSTANCE_DELETE?: boolean | "suppress-warning" | undefined;
+                INSTANCE_DESTROY?: boolean | "suppress-warning" | undefined;
+                INSTANCE_EVENT_EMITTER?: boolean | "suppress-warning" | undefined;
+                INSTANCE_EVENT_HOOKS?: boolean | "suppress-warning" | undefined;
+                INSTANCE_CHILDREN?: boolean | "suppress-warning" | undefined;
+                INSTANCE_LISTENERS?: boolean | "suppress-warning" | undefined;
+                INSTANCE_SCOPED_SLOTS?: boolean | "suppress-warning" | undefined;
+                INSTANCE_ATTRS_CLASS_STYLE?: boolean | "suppress-warning" | undefined;
+                OPTIONS_DATA_FN?: boolean | "suppress-warning" | undefined;
+                OPTIONS_DATA_MERGE?: boolean | "suppress-warning" | undefined;
+                OPTIONS_BEFORE_DESTROY?: boolean | "suppress-warning" | undefined;
+                OPTIONS_DESTROYED?: boolean | "suppress-warning" | undefined;
+                WATCH_ARRAY?: boolean | "suppress-warning" | undefined;
+                PROPS_DEFAULT_THIS?: boolean | "suppress-warning" | undefined;
+                V_ON_KEYCODE_MODIFIER?: boolean | "suppress-warning" | undefined;
+                CUSTOM_DIR?: boolean | "suppress-warning" | undefined;
+                ATTR_FALSE_VALUE?: boolean | "suppress-warning" | undefined;
+                ATTR_ENUMERATED_COERCION?: boolean | "suppress-warning" | undefined;
+                TRANSITION_CLASSES?: boolean | "suppress-warning" | undefined;
+                TRANSITION_GROUP_ROOT?: boolean | "suppress-warning" | undefined;
+                COMPONENT_ASYNC?: boolean | "suppress-warning" | undefined;
+                COMPONENT_FUNCTIONAL?: boolean | "suppress-warning" | undefined;
+                COMPONENT_V_MODEL?: boolean | "suppress-warning" | undefined;
+                RENDER_FUNCTION?: boolean | "suppress-warning" | undefined;
+                FILTERS?: boolean | "suppress-warning" | undefined;
+                PRIVATE_APIS?: boolean | "suppress-warning" | undefined;
+                MODE?: 2 | 3 | ((comp: Component | null) => 2 | 3) | undefined;
+            } | undefined;
+            data?: ((this: any, vm: any) => any) | undefined;
+            computed?: import("vue").ComputedOptions | undefined;
+            methods?: import("vue").MethodOptions | undefined;
+            watch?: {
+                [x: string]: (string | import("vue").WatchCallback | ({
+                    handler: import("vue").WatchCallback | string;
+                } & import("vue").WatchOptions<boolean>)) | (string | import("vue").WatchCallback | ({
+                    handler: import("vue").WatchCallback | string;
+                } & import("vue").WatchOptions<boolean>))[];
+            } | undefined;
+            provide?: import("vue").ComponentProvideOptions | undefined;
+            inject?: {} | string[] | undefined;
+            filters?: Record<string, Function> | undefined;
+            mixins?: any[] | undefined;
+            extends?: any;
+            beforeCreate?: (() => any) | undefined;
+            created?: (() => any) | undefined;
+            beforeMount?: (() => any) | undefined;
+            mounted?: (() => any) | undefined;
+            beforeUpdate?: (() => any) | undefined;
+            updated?: (() => any) | undefined;
+            activated?: (() => any) | undefined;
+            deactivated?: (() => any) | undefined;
+            beforeDestroy?: (() => any) | undefined;
+            beforeUnmount?: (() => any) | undefined;
+            destroyed?: (() => any) | undefined;
+            unmounted?: (() => any) | undefined;
+            renderTracked?: ((e: import("vue").DebuggerEvent) => void) | undefined;
+            renderTriggered?: ((e: import("vue").DebuggerEvent) => void) | undefined;
+            errorCaptured?: ((err: unknown, instance: import("vue").ComponentPublicInstance | null, info: string) => boolean | void) | undefined;
+            delimiters?: [string, string] | undefined;
+            __differentiator?: string | number | symbol | undefined;
+            __isBuiltIn?: boolean | undefined;
+            __file?: string | undefined;
+            __name?: string | undefined;
+        } | null;
+    } | null;
+};
+/** Begin the exit transition. `<VddToasts>` removes the record when it finishes. */
+export declare function startExit(id: string): void;
+/** Drop a record outright — called once its exit transition has ended. */
+export declare function removeToast(id: string): void;
+export interface ToastFunction {
+    (message: string, options?: ToastOptions): string;
+    info(message: string, options?: ToastOptions): string;
+    success(message: string, options?: ToastOptions): string;
+    warning(message: string, options?: ToastOptions): string;
+    error(message: string, options?: ToastOptions): string;
+    /** Dismiss one toast, or all of them when called with no id. */
+    dismiss(id?: string): void;
+    /**
+     * Track a promise: a sticky "pending" toast immediately, updated in place on settlement.
+     * Returns the same promise, so it can be dropped into an existing chain.
+     */
+    promise<T>(promise: Promise<T>, messages: ToastPromiseMessages<T>, options?: ToastOptions): Promise<T>;
+}
+/**
+ * Show a notification, from anywhere — a component, a store, a service, an interceptor.
+ *
+ * Mount `<VddToasts>` once to render them. Calling with none mounted is not an error: the
+ * toast sits in the queue and appears if a container mounts later.
+ *
+ * ```ts
+ * toast.success('Layout saved')
+ * toast.error('Upload failed', { duration: 0 })     // sticky
+ * await toast.promise(save(), { pending: 'Saving…', success: 'Saved', error: 'Failed' })
+ * ```
+ */
+export declare const toast: ToastFunction;
+/** Empty the queue with no animation. For tests and for a full application teardown. */
+export declare function resetToasts(): void;

package/dist/core/toolbarState.d.ts

@@ -0,0 +1,13 @@
+export interface ToolbarState {
+    /** The active item in a radio group, or `null`. */
+    activeInGroup: (group: string) => string | null;
+    /** Set the active item in a group. `null` clears it. */
+    setActiveInGroup: (group: string, id: string | null) => void;
+    /** Whether a toggle is on. */
+    isToggled: (id: string) => boolean;
+    /** Set a toggle explicitly. */
+    setToggled: (id: string, on: boolean) => void;
+    /** Flip a toggle. */
+    toggle: (id: string) => void;
+}
+export declare function createToolbarState(): ToolbarState;