vue-dockable-desktop 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Every release states which `react-dockable-desktop` release it corresponds to, as a
+**Parity** line. The two libraries version independently — a shared number would break the
+first time either needed a breaking change the other did not — so this is where the
+correspondence lives, alongside the feature-by-feature map in [docs/PARITY.md](docs/PARITY.md).
+
+## [Unreleased]
+
+## [1.0.0] — 2026-09-16
+
+**Parity: react-dockable-desktop 6.3.0.**
+
+First release. 1.0.0 rather than 0.x because the API is not speculative: it is a deliberate
+port of an API that has been through six majors of real use, and it is pinned by
+`api-surface.json`, so it cannot drift by accident.
+
+### Added
+
+- **A Vue 3 port of [react-dockable-desktop](https://github.com/felipecarrillo100/react-dockable-desktop).**
+  A window manager and dockable layout engine: split-docking grid, tabbed groups, workspace
+  edge docking, floating resizable windows with corner anchoring and stacking, a taskbar with
+  live previews, sidebars, toolbars, per-panel overlays with anchored toolbars and floating
+  widgets, side panels, a modal stack, toasts, context menus, panel contributions, theming,
+  and internationalisation with RTL.
+
+  Written as a native Vue library rather than a transliteration: `createWorkspace()` is a
+  plugin in the shape of `createPinia()`, two-way state is `v-model`, subscriptions are refs,
+  render props are slots, and panel persistence is one cache element per panel plus a
+  `<Teleport>`. The reasoning for each is recorded in [`docs/decisions/`](docs/decisions/).
+
+- **Layout compatibility with rdd, in both directions.** `saveLayout()` output is byte-compatible
+  with `react-dockable-desktop`'s `SerializedLayout`, so a layout saved by either library loads
+  in the other. Asserted against fixtures captured from rdd, and exercised in the demo's
+  browser walkthrough by restoring a layout written by hand in rdd's format.
+
+- **A floating widget's title can be a message descriptor, not just a string.** `ManagedWidget.title`
+  — the object `useFloatingWidgets().open()` stores — and `<VddFloatingWidget title>` are both
+  `Label` (`string | MessageDescriptor`), resolved through `ws.format()` on every render. A
+  descriptor therefore follows a locale change with no reopen, which a resolved string cannot:
+  the library stores that object, so it has no way to resolve the text again.
+
+  This closes the last gap in the rule that **every title the library stores is a `Label`** —
+  panel titles, side panels, modals, context menus and the unsaved-changes dialog were already
+  covered. Two M12 gate rules and PO28–PO30 keep it closed. The same defect was
+  [reported against rdd 6.2.0](https://github.com/felipecarrillo100/react-dockable-desktop) and
+  is fixed there in 6.3.0; recorded here as divergence **D16** in
+  [`docs/PARITY.md`](docs/PARITY.md).
+
+### Notes
+
+- Sixteen behaviours deliberately differ from rdd 6.2.0 — fifteen of them defects vdd does not
+  reproduce, each with a test and a gate rule. They are listed with their evidence in
+  [`docs/PARITY.md`](docs/PARITY.md), which also carries the full API and test maps.
+- The published surface is pinned by `api-surface.json`; the gate fails if an export appears or
+  disappears without that file changing, so nothing can leak into the API by accident.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Felipe Carrillo Romero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# vue-dockable-desktop
+
+[![npm version](https://img.shields.io/npm/v/vue-dockable-desktop.svg?color=blue)](https://www.npmjs.com/package/vue-dockable-desktop)
+[![Vue 3](https://img.shields.io/badge/Vue-3.4%2B-42b883.svg)](https://vuejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-first-3178c6.svg)](https://www.typescriptlang.org/)
+[![parity](https://img.shields.io/badge/parity-react--dockable--desktop%206.3.0-orange.svg)](docs/PARITY.md)
+[![license](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A window manager and dockable layout engine for **Vue 3**. Fluid grid splits, tabbed
+groups, floating resizable windows, zero-unmount state preservation, side panels and
+modals, toasts, context menus, per-panel overlays, and internationalisation.
+
+**[Live demo](https://felipecarrillo100.github.io/vue-dockable-desktop/demo/)**  | 
+**[Users manual](docs/manual/)**  | 
+**[Design decisions](docs/decisions/)**  | 
+**[Parity with the React version](docs/PARITY.md)**
+
+Written as a native Vue library — plugins, composables, `v-model`, slots — not as a
+transliteration of its React sibling. It reads and writes the **same serialised layout
+format** as [`react-dockable-desktop`](https://github.com/felipecarrillo100/react-dockable-desktop),
+so a layout saved by either library loads in the other.
+
+> **Versioning.** vdd follows its own semver, independently of `react-dockable-desktop`:
+> matching the two numbers would be a promise that breaks the first time either library needs
+> a breaking change the other does not. Which rdd release a given version corresponds to is
+> stated per release in [CHANGELOG.md](CHANGELOG.md) — this one tracks **rdd 6.3.0** — and
+> feature by feature in [docs/PARITY.md](docs/PARITY.md).
+
+## Install
+
+```bash
+npm install vue-dockable-desktop
+```
+
+Requires Vue 3.4+. No other runtime dependencies. The published package is
+[`vue-dockable-desktop`](https://www.npmjs.com/package/vue-dockable-desktop); the public API
+is pinned by `api-surface.json` and covered by 725 tests.
+
+## Quick start
+
+```ts
+// main.ts
+import { createApp } from 'vue'
+import { createWorkspace } from 'vue-dockable-desktop'
+import 'vue-dockable-desktop/styles.css'          // required
+import App from './App.vue'
+import MapPanel from './panels/MapPanel.vue'
+import EditorPanel from './panels/EditorPanel.vue'
+
+const workspace = createWorkspace({
+  panels: {
+    map:    { component: MapPanel,    defaultOptions: { title: 'Map' } },
+    editor: { component: EditorPanel, defaultOptions: { title: 'Editor' } },
+  },
+})
+
+createApp(App).use(workspace).mount('#app')
+```
+
+```vue
+<!-- App.vue -->
+<script setup lang="ts">
+// Components are imported, not registered globally, so a build only carries the ones it uses.
+import { VddDesktop, VddModals, VddSidePanels, VddToasts } from 'vue-dockable-desktop'
+</script>
+
+<template>
+  <div class="app">
+    <VddDesktop />
+    <VddModals />
+    <VddSidePanels />
+    <VddToasts />
+  </div>
+</template>
+
+<style>
+.app { height: 100vh; overflow: hidden; }
+</style>
+```
+
+`createWorkspace()` returns a Vue plugin — the same shape as `createPinia()` or
+`createRouter()` — so `app.use(workspace)` makes `useWorkspace()` available anywhere:
+
+```ts
+import { useWorkspace } from 'vue-dockable-desktop'
+
+const ws = useWorkspace()
+// openPanel(instanceId, panelKey, options?) — the id is yours, the key is from `panels`.
+ws.openPanel('overview', 'map', { title: 'Overview' })
+localStorage.setItem('layout', ws.saveLayout())
+```
+
+## Features
+
+- **Split-docking grid** — drag a panel to any zone to split it into rows or columns, or
+  drop it onto a tab strip to group it
+- **Floating windows** — 8-direction resize, maximise, minimise, and corner anchoring with
+  automatic stacking
+- **Zero-unmount persistence** — panel DOM is moved, never destroyed, across docking,
+  floating and tab switching, so maps, WebGL contexts and editors keep their state
+- **Sidebar and toolbar** — primary and secondary sidebars, a declarative toolbar, and
+  per-panel contributions that follow the active panel
+- **Panel overlay** — anchored toolbars and floating widgets inside a single panel
+- **Overlays** — side panels, a modal stack, dirty-close confirmation, and toasts
+- **Layout serialisation** — save and restore the whole workspace as a JSON string
+- **Theming** — built-in skins, light/dark colour schemes, all `--vdd-*` CSS variables
+- **i18n and RTL** — every string is a message key; `dir="rtl"` flips the whole workspace
+- **TypeScript-first** — complete types, no separate `@types` package
+
+## Documentation
+
+| | |
+|---|---|
+| [Live demo](https://felipecarrillo100.github.io/vue-dockable-desktop/demo/) | Every capability in one application — published from `demo/` by GitHub Pages on each push to `main` |
+| [`docs/manual/`](docs/manual/) | Users manual — 13 chapters, start with [Getting started](docs/manual/01-getting-started.md) |
+| [`docs/decisions/`](docs/decisions/) | ADRs — why the Vue design diverges from the React one |
+| [`docs/PARITY.md`](docs/PARITY.md) | Feature-by-feature parity with `react-dockable-desktop`, and the 16 deliberate divergences |
+| [`docs/IMPLEMENTATION_PLAN.md`](docs/IMPLEMENTATION_PLAN.md) | The milestone plan and its gates |
+| [`docs/PROGRESS.md`](docs/PROGRESS.md) | One row per gate run |
+| [`CHANGELOG.md`](CHANGELOG.md) | What has changed, newest first |
+
+## Repository layout
+
+```
+src/            the library — core/ (framework-free logic), components/, composables/
+test/           Vitest suites; the executable specification
+demo/           full sample application (maps, Monaco, Markdown, 16 panels)
+playground/     minimal harness used by the browser gates
+docs/           manual, ADRs, parity and plan
+scripts/gates/  the verification gates
+docs/evidence/  a written record per milestone gate (the gate's own output is not committed)
+```
+
+## Development
+
+```bash
+npm install
+
+npm test                # Vitest
+npm run typecheck       # vue-tsc
+npm run lint            # ESLint
+npm run build           # library build + .d.ts + styles.css
+
+npm run demo            # the demo app
+npm run playground      # the minimal harness
+
+npm run gate -- M14     # the full standing gate for a milestone
+npm run gate:selftest   # prove every gate rule is non-vacuous
+npm run gate:sweep      # coverage + non-vacuity sweep
+```
+
+`npm run gate -- M<n>` runs types, lint, tests, build, test counts, the CSS-prefix and
+API-surface checks, the docs/API cross-check, the demo build, the milestone's own rules,
+and a real-Chrome browser gate. Gates are never edited to make a run pass.
+
+## Continuous integration
+
+Two workflows, both on Node 22 (vitest 5 will not run on Node 20):
+
+- [`.github/workflows/gate.yml`](.github/workflows/gate.yml) runs `npm run gate -- M14` on
+  every push and pull request, browser gate included — the runner image already ships
+  Chrome — and keeps the gate's evidence as a build artifact.
+- [`.github/workflows/pages.yml`](.github/workflows/pages.yml) builds the demo and publishes
+  it to GitHub Pages on each push to `main`: the landing page at the site root, the demo
+  under `/demo/`. The demo's `base` is relative, so no deployment path is baked into the build.
+
+## License
+
+MIT

package/dist/components/VddConfirm.vue.d.ts

@@ -0,0 +1,19 @@
+import type { AlertType, Label } from '../types';
+type __VLS_Props = {
+    message: Label;
+    /** An extra banner above the message — which fields are invalid, say. */
+    alert?: string;
+    alertType?: AlertType;
+    /** Label the buttons "Yes"/"No" rather than "OK"/"Cancel". */
+    yesNo?: boolean;
+    onOk?: () => void;
+    onCancel?: () => void;
+    /** Called exactly once, whichever way the dialog closes. `ok` says which. */
+    onSettled?: (ok: boolean) => void;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    alertType: AlertType;
+    yesNo: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddContextMenu.vue.d.ts

@@ -0,0 +1,35 @@
+import type { ContextMenuItem } from '../core/contextMenu';
+type __VLS_Props = {
+    /** Visual theme hook, mirrored onto the menu's class. @default 'dark' */
+    theme?: string;
+};
+type __VLS_Slots = {
+    /**
+     * Render the whole menu yourself, with your own UI kit.
+     *
+     * Replaces rdd's `ContextMenuAdapter`, whose single field was a component to swap in — a
+     * slot is the Vue spelling of exactly that (docs/decisions/0007-slots-over-render-props.md),
+     * and it needs no provider, no ref handshake and no adapter object.
+     *
+     * `items` is the pending menu, `x`/`y` the requested position, and `close` dismisses it.
+     * Positioning and dismissal are then yours: the built-in clamping, Escape handling and
+     * outside-click handling belong to the built-in markup this replaces.
+     */
+    default?: (props: {
+        items: ContextMenuItem[];
+        x: number;
+        y: number;
+        close: () => void;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    theme: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/VddDesktop.vue.d.ts

@@ -0,0 +1,28 @@
+import type { TaskbarVisibility } from './VddTaskbar.vue';
+type __VLS_Props = {
+    /** Built-in skin, or a name you scope your own tokens to. @default 'vscode' */
+    skin?: string;
+    /** Enable the library's own transitions. Never affects the host app's animations. @default true */
+    animations?: boolean;
+    /**
+     * When the minimised-panel taskbar is shown.
+     * - `'always'` — a permanent strip
+     * - `'compact'` — only while something is minimised
+     * - `'autohide'` — an overlay collapsed to an 8px peek strip, expanding on hover
+     * @default 'always'
+     */
+    taskbar?: TaskbarVisibility;
+    /** Fallback icon for panels that register none. */
+    defaultPanelIcon?: unknown;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    taskbarContextMenu: (panelId: string, event: MouseEvent | PointerEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onTaskbarContextMenu?: ((panelId: string, event: MouseEvent | PointerEvent) => any) | undefined;
+}>, {
+    skin: string;
+    animations: boolean;
+    taskbar: TaskbarVisibility;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddDragGhost.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddDropZones.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    leafId: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddEdgeZones.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddFloatingWidget.vue.d.ts

@@ -0,0 +1,51 @@
+import type { Component } from 'vue';
+import type { PanelFloatPlacement } from '../core/stretch';
+import type { Label } from '../types';
+type __VLS_Props = {
+    /** Unique within this panel's overlay. Drives z-order and stack membership. */
+    widgetId: string;
+    /** Header text: plain, or a localisable descriptor resolved on every render. */
+    title: Label;
+    icon?: Component;
+    /** Width in pixels. Ignored while the inline axis is stretched, and returned to on release. */
+    width?: number;
+    /** Height in pixels. Ignored while the block axis is stretched, and returned to on release. */
+    height?: number;
+    /** `false` disables resize-to-stretch snapping, for content that needs a bounded size. @default true */
+    stretchable?: boolean;
+};
+type __VLS_ModelProps = {
+    /** Whether the widget is mounted. `v-model:open` replaces rdd's `usePanelFloatingWindow()`. */
+    'open'?: boolean;
+    /**
+     * Where the widget sits: its corner, and which axes span the panel.
+     *
+     * Bind it and the caller owns placement — which is also the only way to persist it, since the
+     * library serialises nothing about inner widgets. Leave it off and the widget keeps its own.
+     */
+    'placement'?: PanelFloatPlacement;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_6: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => any;
+    "update:placement": (value: PanelFloatPlacement) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    "onUpdate:placement"?: ((value: PanelFloatPlacement) => any) | undefined;
+}>, {
+    width: number;
+    height: number;
+    stretchable: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/VddFloatingWindow.vue.d.ts

@@ -0,0 +1,12 @@
+import type { FloatingWindow } from '../types';
+type __VLS_Props = {
+    window: FloatingWindow;
+    /** The workspace's measured size, for the clamps. */
+    viewport: {
+        width: number;
+        height: number;
+    };
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddLeafGroup.vue.d.ts

@@ -0,0 +1,7 @@
+import type { LayoutLeafNode } from '../types';
+type __VLS_Props = {
+    leaf: LayoutLeafNode;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddModalHost.vue.d.ts

@@ -0,0 +1,9 @@
+import type { OverlayInstance } from '../core/overlays';
+type __VLS_Props = {
+    instance: OverlayInstance;
+    /** Depth in the stack, which is what separates the modals' z-indexes. */
+    index: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddModals.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddOverlayFrame.vue.d.ts

@@ -0,0 +1,28 @@
+import type { Component } from 'vue';
+type __VLS_Props = {
+    block: 'side-panel' | 'modal';
+    title: string;
+    icon: Component | null;
+    /** `false` hides the close button entirely — a modal opened with `closable: false`. */
+    closable: boolean;
+    closeLabel: string;
+    /** Body padding, or `undefined` to leave it to the stylesheet. */
+    bodyPadding?: string;
+};
+declare var __VLS_6: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/VddPanelMount.vue.d.ts

@@ -0,0 +1,8 @@
+import type { PanelDomCache } from '../core/panelDom';
+type __VLS_Props = {
+    panelId: string;
+    cache: PanelDomCache;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddPanelOverlay.vue.d.ts

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/VddPanelSlot.vue.d.ts

@@ -0,0 +1,9 @@
+type __VLS_Props = {
+    /** The panel to show here. */
+    panelId: string;
+    /** Extra class for the host box. */
+    hostClass?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddPanelToolbar.vue.d.ts

@@ -0,0 +1,26 @@
+import type { ButtonVariant, ToolbarPosition, ToolbarVariant } from '../core/panelOverlay';
+type __VLS_Props = {
+    position: ToolbarPosition;
+    /** @default 'transparent' */
+    variant?: ToolbarVariant;
+    /** Inherited by this toolbar's buttons unless they override it. @default 'ghost' */
+    buttonVariant?: ButtonVariant;
+    /** Icon button size in pixels. Left to the stylesheet when unset. */
+    buttonSize?: number;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    variant: ToolbarVariant;
+    buttonVariant: ButtonVariant;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/VddSecondarySidebar.vue.d.ts

@@ -0,0 +1,16 @@
+import type { SidebarProps } from '../core/sidebarTypes';
+/** Everything the primary accepts, except the two it decides for itself. */
+type __VLS_Props = Omit<SidebarProps, 'position' | 'isSecondary'>;
+declare var __VLS_10: string, __VLS_11: any;
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_10>]?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/VddSidePanelHost.vue.d.ts

@@ -0,0 +1,10 @@
+import type { OverlayInstance } from '../core/overlays';
+type __VLS_Props = {
+    instance: OverlayInstance;
+    position: 'left' | 'right';
+    /** Used when the instance did not ask for a width. */
+    defaultWidth: number | string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddSidePanels.vue.d.ts

@@ -0,0 +1,12 @@
+type __VLS_Props = {
+    /** Applied when `openLeftPanel`/`openRightPanel` did not specify a width. @default 400 */
+    defaultWidth?: number | string;
+    /** Which edges this instance is responsible for. @default 'both' */
+    sides?: 'both' | 'left' | 'right';
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    defaultWidth: number | string;
+    sides: "both" | "left" | "right";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VddSidebar.vue.d.ts

@@ -0,0 +1,54 @@
+import type { SidebarProps, SidebarTab } from '../core/sidebarTypes';
+type __VLS_Props = SidebarProps;
+type __VLS_Slots = {
+    default?: () => unknown;
+    /** Replaces the library's drawer header, for whichever tab is open. */
+    header?: (props: {
+        tab: SidebarTab;
+        close: () => void;
+        open: () => void;
+    }) => unknown;
+    /** Content for one tab, by id: `#tab-layers`. */
+    [key: `tab-${string}`]: (props: {
+        tab: SidebarTab;
+        close: () => void;
+        open: () => void;
+    }) => unknown;
+};
+type __VLS_ModelProps = {
+    /** The open tab, or `null` when the drawer is closed. */
+    'activeTabId'?: string | null;
+    /** Whether the whole sidebar — strip and drawer — is shown. */
+    'visible'?: boolean;
+    /** Whether the activity strip is shown. The drawer is unaffected. */
+    'stripVisible'?: boolean;
+    /** Drawer width in pixels. */
+    'width'?: number;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:activeTabId": (value: string | null) => any;
+    "update:visible": (value: boolean) => any;
+    "update:stripVisible": (value: boolean) => any;
+    "update:width": (value: number) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:activeTabId"?: ((value: string | null) => any) | undefined;
+    "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+    "onUpdate:stripVisible"?: ((value: boolean) => any) | undefined;
+    "onUpdate:width"?: ((value: number) => any) | undefined;
+}>, {
+    position: "left" | "right";
+    minWidth: number;
+    maxWidth: number;
+    showCloseButton: boolean;
+    hideDefaultHeader: boolean;
+    isSecondary: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};