vue-dockable-desktop 1.8.0 → 1.8.2

package/CHANGELOG.md

@@ -11,6 +11,82 @@ correspondence lives, alongside the feature-by-feature map in [docs/PARITY.md](d
 
 ## [Unreleased]
 
+## [1.8.2] — 2026-10-06
+
+**Parity: react-dockable-desktop 7.7.3** (code health). Neither of rdd's last two releases needs a
+port: 7.7.2 fixed panels re-rendering on every workspace change, which vdd never did (each panel
+host reads only its own entry), and 7.7.3 is rdd's own lint and dead-code tooling. This release is
+vdd's matching lint cleanup. No API or behaviour change; the built code differs only in the
+explicit `undefined` prop defaults below.
+
+### Internal
+
+- **A lint warning now fails the gate.** ESLint runs with `--max-warnings 0` in the standing gate
+  (CI), `npm run verify` and `npm run lint`. Warnings never failed anything before, and 721 had
+  built up.
+- **Template-layout rules are off.** `vue/max-attributes-per-line` and five other Vue
+  template-formatting rules accounted for 706 of the 721: they only reflow markup, and the
+  templates keep their own consistent layout.
+- The 12 optional props without a default (`VddAlert`'s `okLabel`, `VddConfirm`'s callbacks, the
+  icon props, and others) declare `undefined` explicitly in `withDefaults`, as `icon` already did.
+  Their behaviour is unchanged.
+- The demo's Markdown preview: the `v-html` lint exemption now covers the right line, and its
+  comment no longer calls the output sanitised. It isn't: `rehype-raw` passes raw HTML through,
+  which is acceptable in a demo that renders only what is typed into its own editor.
+
+## [1.8.1] — 2026-10-05
+
+**Parity: react-dockable-desktop 7.7.1.** Two desktops on one page no longer strip each other's
+skin.
+
+### Fixed
+
+- **Unmounting one desktop stripped `<html>` of the other's skin, animations opt-out and stacking
+  base** (`data-vdd-skin`, `vdd-no-animations`, `--vdd-z-base`), and each desktop overwrote the
+  other's while both were mounted. The most recently mounted desktop now decides these, and
+  unmounting it hands them back to the others instead of removing them. Teleported chrome (menus,
+  toasts, flyouts, modals) therefore follows the newest desktop's skin when two desktops use
+  different skins.
+
+rdd 7.7.1 also fixed panel DOM, sizes and lifecycle handlers shared between workspaces. None of it
+applied here: vdd's panel cache has been per desktop from the start.
+
+### Internal
+
+Faster checks, the same checks. Nothing in the published package changes.
+
+- **`npm run verify`** — types, lint and the test suite, about a minute: the check to run while
+  working. **`npm run gate:release`** — the coverage sweep, then every milestone gate M1–M17 in
+  one call: the check to run before a release.
+- **`npm run gate -- M13 M15 M16`** runs several milestones on one standing gate (types, lint,
+  tests, build…) instead of repeating it for each. Each step's time is recorded in
+  `artifacts/M<n>/gate.json`.
+- **The branding gates wait for the page to be still instead of sleeping.** A scene, the overlays
+  and each hover now wait until nothing is animating or changing, with the old sleep as the
+  ceiling; the wait after the pointer leaves a control stays fixed, since the timers it starts are
+  invisible to such a check. M16 checks its three corner scales on one page per scene, and no
+  longer runs the hover walk for corners, which never read it. M15 captures a scene twice only
+  for an unexpected difference. Rewriting both baselines with the new code gave byte-identical
+  fixtures.
+- **The baselines key elements by library class, not position**, so a new wrapper element no
+  longer renames everything after it (this release's dialog row renamed a whole modal). Both
+  fixtures were regenerated once: every scene has the same entries with identical values, under
+  the new keys.
+- **`gate:selftest` leaves the tree fresh**: it rebuilds `dist/` and re-runs the coverage sweep at
+  the end, so a following M13 never reads the report a seeded violation left behind.
+- **Three stale milestone rules updated** ([0020](docs/decisions/0020-stale-milestone-rules.md)):
+  M2 still required `src/core/rtl.ts`, deleted at M13 as dead code; M5 looked for the window clamp
+  where it no longer lives; M6 expected the pre-1.1.2 side for an RTL tab drop. Each keeps its
+  intent and checks today's code, and the new M2 and M5 rules have seeded violations in the
+  selftest (100 rules).
+
+| | before | after |
+|---|---|---|
+| every gate, M1–M17 | ≈26 min (17 standing gates) | ≈9 min (one) |
+| M16 browser gate | 435 s | 137–145 s |
+| M15 browser gate | 236 s | 173–183 s |
+| while working | a gate run | `npm run verify`, ≈1 min |
+
 ## [1.8.0] — 2026-10-05
 
 **Parity: react-dockable-desktop 7.7.0.** Ready-made dialogs: the confirmation shows an icon,

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

@@ -14,6 +14,8 @@ type __VLS_Props = {
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     icon: Component | null;
     alertType: AlertType;
+    onSettled: () => void;
+    okLabel: Label;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -19,8 +19,12 @@ type __VLS_Props = {
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     icon: Component | null;
+    alert: string;
     alertType: AlertType;
+    onCancel: () => void;
     yesNo: boolean;
+    onOk: () => void;
+    onSettled: (ok: boolean) => void;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -23,6 +23,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     skin: string;
     animations: boolean;
     taskbar: TaskbarVisibility;
+    defaultPanelIcon: undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -45,6 +45,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
 }>, {
     width: number;
     height: number;
+    icon: Component;
     stretchable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

@@ -15,6 +15,7 @@ type __VLS_Slots = {} & {
 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;
+    buttonSize: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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

@@ -12,6 +12,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     onContextMenu?: ((panelId: string, event: MouseEvent | PointerEvent) => any) | undefined;
 }>, {
     visibility: TaskbarVisibility;
+    defaultIcon: undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -25,6 +25,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     width: number;
     position: ToastPosition;
     animation: "slide" | "fade" | "none";
+    adapter: ToastAdapter;
     pauseOnHover: boolean;
     defaultDuration: number;
     defaultClosable: boolean;

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

@@ -21,6 +21,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onSelect?: ((result: SearchResult) => any) | undefined;
 }>, {
+    placeholder: string;
     debounce: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/core/documentMirror.d.ts

@@ -0,0 +1,30 @@
+/**
+ * What a desktop mirrors onto `<html>`: its skin, its animations opt-out and its stacking base.
+ *
+ * Chrome teleported to `document.body` (menus, toasts, flyouts, modals) can only inherit these from
+ * the document, so they are written there. The document is shared by every desktop on the page, which
+ * is why this module keeps state at module level, per document — and why it is a stack of owners
+ * rather than a plain write: with two desktops mounted, each used to overwrite the other, and
+ * unmounting either one removed the values for the one still on screen.
+ *
+ * Each field shows the most recently mounted owner that claims it. Releasing the last claim of a field
+ * removes it from `<html>`, as a single desktop always did. A field nobody claims is never touched, so
+ * a value the page set itself survives. rdd 7.7.1's `src/utils/documentMirror.ts` is the same rule.
+ */
+export interface DocumentMirrorValues {
+    /** `data-vdd-skin`. An empty value claims "no skin attribute". */
+    skin?: string | null;
+    /** The `vdd-no-animations` class. */
+    noAnimations?: boolean;
+    /** `--vdd-z-base`. */
+    zBase?: number;
+}
+type Field = keyof DocumentMirrorValues;
+/**
+ * Claims (or updates) `owner`'s values. A first claim puts the owner on top; an update keeps its
+ * place, so changing one desktop's skin never lets it jump over a desktop mounted after it.
+ */
+export declare function claimDocumentMirror(owner: object, values: DocumentMirrorValues, doc?: Document): void;
+/** Releases `owner`'s claim on `fields`; the owner leaves the stack once it claims nothing. */
+export declare function releaseDocumentMirror(owner: object, fields?: readonly Field[], doc?: Document): void;
+export {};