@antelopejs/dms 0.4.6 → 0.4.7

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## v0.4.7
+
+[compare changes](https://github.com/AntelopeJS/dms/compare/v0.4.6...v0.4.7)
+
+### 🚀 Enhancements
+
+- **interface-dms:** Export the password policy for modules ([#70](https://github.com/AntelopeJS/dms/pull/70))
+
+### 🩹 Fixes
+
+- **dms-ui:** Let Escape close modals opened over a table or a tree ([#71](https://github.com/AntelopeJS/dms/pull/71))
+
+### 🏡 Chore
+
+- **release:** @antelopejs/interface-dms v0.2.6 ([67d4e23](https://github.com/AntelopeJS/dms/commit/67d4e23))
+
+### ❤️ Contributors
+
+- Antony Rizzitelli <rizzitelli.antony@pm.me>
+
 ## v0.4.6
 
 [compare changes](https://github.com/AntelopeJS/dms/compare/v0.4.5...v0.4.6)

package/dist/test/unit/interfaces/dms/password-policy.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/interfaces/dms/password-policy.test.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const password_1 = require("@antelopejs/interface-dms/auth/password");
+const COMPLIANT_PASSWORD = "StrongP@ss1";
+const ALLOWED_SPECIAL_CHARS = "@$!%*?&";
+describe("[unit] auth/password policy", () => {
+    it("requires at least 8 characters", () => {
+        (0, chai_1.expect)(password_1.PASSWORD_MIN_LENGTH).to.equal(8);
+    });
+    it("accepts a password meeting every rule", () => {
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)(COMPLIANT_PASSWORD)).to.equal(true);
+    });
+    it("accepts a password of exactly the minimum length", () => {
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)("Abcdef1@")).to.equal(true);
+    });
+    it("accepts every allowed special character", () => {
+        for (const special of ALLOWED_SPECIAL_CHARS) {
+            (0, chai_1.expect)((0, password_1.isPasswordCompliant)(`Abcdef1${special}`), special).to.equal(true);
+        }
+    });
+    it("rejects a password shorter than the minimum length", () => {
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)("Abcde1@")).to.equal(false);
+    });
+    it("rejects a password without an uppercase letter", () => {
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)("weakp@ss1")).to.equal(false);
+    });
+    it("rejects a password without a digit", () => {
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)("Weakpass@")).to.equal(false);
+    });
+    it("rejects a password without a special character", () => {
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)("Weakpass1")).to.equal(false);
+    });
+    it("rejects a character outside the allowed set", () => {
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)("StrongP@ss1#")).to.equal(false);
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)("StrongP@ss1 ")).to.equal(false);
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)("StrongP@ss1é")).to.equal(false);
+    });
+    it("rejects an empty password", () => {
+        (0, chai_1.expect)((0, password_1.isPasswordCompliant)("")).to.equal(false);
+    });
+});
+//# sourceMappingURL=password-policy.test.js.map

package/dist/test/unit/interfaces/dms/password-policy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"password-policy.test.js","sourceRoot":"","sources":["../../../../../src/test/unit/interfaces/dms/password-policy.test.ts"],"names":[],"mappings":";;AAAA,+BAA8B;AAC9B,sEAGiD;AAEjD,MAAM,kBAAkB,GAAG,aAAa,CAAC;AACzC,MAAM,qBAAqB,GAAG,SAAS,CAAC;AAExC,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,IAAA,aAAM,EAAC,8BAAmB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,KAAK,MAAM,OAAO,IAAI,qBAAqB,EAAE,CAAC;YAC5C,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,UAAU,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,IAAA,aAAM,EAAC,IAAA,8BAAmB,EAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/validation/password.d.ts

@@ -1,3 +1,2 @@
 import * as z from "zod";
-export declare const PASSWORD_REGEX: RegExp;
 export declare const passwordSchema: z.ZodString;

package/dist/validation/password.js

@@ -33,8 +33,11 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.passwordSchema = exports.PASSWORD_REGEX = void 0;
+exports.passwordSchema = void 0;
 const z = __importStar(require("zod"));
-exports.PASSWORD_REGEX = /^(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]+$/;
-exports.passwordSchema = z.string().min(8).regex(exports.PASSWORD_REGEX);
+const password_1 = require("@antelopejs/interface-dms/auth/password");
+exports.passwordSchema = z
+    .string()
+    .min(password_1.PASSWORD_MIN_LENGTH)
+    .regex(password_1.PASSWORD_PATTERN);
 //# sourceMappingURL=password.js.map

package/dist/validation/password.js.map

@@ -1 +1 @@
-{"version":3,"file":"password.js","sourceRoot":"","sources":["../../src/validation/password.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AAEZ,QAAA,cAAc,GACzB,wDAAwD,CAAC;AAE9C,QAAA,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAc,CAAC,CAAC"}
+{"version":3,"file":"password.js","sourceRoot":"","sources":["../../src/validation/password.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,sEAGiD;AAEpC,QAAA,cAAc,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,GAAG,CAAC,8BAAmB,CAAC;KACxB,KAAK,CAAC,2BAAgB,CAAC,CAAC"}

package/frontend-vue/layers/dms-core/i18n/locales/core-en-GB.json

@@ -44,6 +44,10 @@
       "title": "Restoring your session...",
       "description": "Your session has expired. Refreshing your access and reloading the page."
     },
+    "network": {
+      "title": "Connection lost",
+      "description": "The server could not be reached. Check your connection and try again."
+    },
     "switch_account_failed": "Failed to switch account",
     "email_already_used": "This email address is already used.",
     "user_not_found": "No user found with this email address.",

package/frontend-vue/layers/dms-core/i18n/locales/core-fr-FR.json

@@ -44,6 +44,10 @@
       "title": "Restauration de votre session...",
       "description": "Votre session a expiré. Renouvellement de l'accès et rechargement de la page."
     },
+    "network": {
+      "title": "Connexion perdue",
+      "description": "Le serveur est injoignable. Vérifiez votre connexion et réessayez."
+    },
     "switch_account_failed": "Échec du changement de compte",
     "email_already_requested": "Cette adresse e-mail a déjà été demandée. Veuillez attendre avant de réessayer.",
     "email_already_used": "Cette adresse e-mail est déjà utilisée.",

package/frontend-vue/layers/dms-ui/app/components/table-view/TableView.vue

@@ -7,7 +7,7 @@ import type {
   Table,
   VisibilityState,
 } from "@tanstack/vue-table";
-import { refDebounced, watchDebounced } from "@vueuse/core";
+import { refDebounced, useActiveElement, watchDebounced } from "@vueuse/core";
 import {
   QUICK_ACTION_BUTTON_KEY,
   QUICK_ACTION_COMPONENT_KEY,
@@ -1010,6 +1010,7 @@ defineShortcuts(
     globalFilter,
     rowSelect,
     data: shownData,
+    activeElement: useActiveElement(),
   }),
 );
 

package/frontend-vue/layers/dms-ui/app/components/tree/Tree.vue

@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { useActiveElement } from "@vueuse/core";
 import type { TreeNode, TreeProps } from "../../composables/tree/types";
 import {
   TreeSelectionBehavior,
@@ -120,15 +121,15 @@ function navigateTree(direction: TreeNavigationDirection) {
   navigationHandlers[direction]();
 }
 
-const shortcutHandlers: Record<string, () => void> = (
-  buildTreeShortcuts as (...args: unknown[]) => Record<string, () => void>
-)({
-  navigateTree,
-  props,
-  items,
-  selected,
-});
-defineShortcuts(shortcutHandlers as Record<string, (() => void) | undefined>);
+defineShortcuts(
+  buildTreeShortcuts({
+    navigateTree,
+    props,
+    items,
+    selected,
+    activeElement: useActiveElement(),
+  }),
+);
 </script>
 
 <template>

package/frontend-vue/layers/dms-ui/app/composables/table-view/shortcuts/index.ts

@@ -1,4 +1,4 @@
-import type { ShallowRef } from "vue";
+import { computed, type ComputedRef, type ShallowRef } from "vue";
 import type { RowSelectionState } from "@tanstack/vue-table";
 import type {
   TableRowActionOptions,
@@ -15,6 +15,7 @@ import {
 import {
   TABLE_VIEW_ESCAPE_METADATA,
   createTableViewEscapeShortcut,
+  isTableViewEscapeActive,
 } from "./tableViewEscape";
 import {
   TABLE_VIEW_SHIFT_A_METADATA,
@@ -42,8 +43,11 @@ interface BuildTableViewShortcutsParams<T extends Data> {
   globalFilter: ShallowRef<string | undefined>;
   rowSelect: Ref<RowSelectionState>;
   data: Ref<{ results: T[] } | null | undefined>;
+  activeElement: Ref<Element | null | undefined>;
 }
 
+type TableViewShortcuts = Record<string, (() => void) | undefined>;
+
 export function buildTableViewShortcuts<T extends Data>({
   refresh,
   tableProps,
@@ -51,11 +55,20 @@ export function buildTableViewShortcuts<T extends Data>({
   globalFilter,
   rowSelect,
   data,
-}: BuildTableViewShortcutsParams<T>): Record<string, () => void> {
-  return {
+  activeElement,
+}: BuildTableViewShortcutsParams<T>): ComputedRef<TableViewShortcuts> {
+  const shortcuts = {
     meta_r: createTableViewMetaRShortcut(refresh),
     shift_n: createTableViewShiftNShortcut(tableProps, newRow),
-    escape: createTableViewEscapeShortcut(globalFilter, rowSelect),
     shift_a: createTableViewShiftAShortcut(tableProps, data, rowSelect),
   };
+  const escape = createTableViewEscapeShortcut(globalFilter, rowSelect);
+  // An unregistered key is left untouched by `defineShortcuts`, so Escape
+  // reaches overlays whenever the table has nothing to clear.
+  return computed(() => ({
+    ...shortcuts,
+    escape: isTableViewEscapeActive(globalFilter, rowSelect, activeElement)
+      ? escape
+      : undefined,
+  }));
 }

package/frontend-vue/layers/dms-ui/app/composables/table-view/shortcuts/tableViewEscape.ts

@@ -1,12 +1,34 @@
 import type { ShallowRef } from "vue";
 import type { RowSelectionState } from "@tanstack/vue-table";
+import { isFocusInsideOverlay } from "../../../utils/overlayFocus";
 
 export const TABLE_VIEW_ESCAPE_METADATA: ShortcutMetadata = {
   key: ["$keyboard.escape"],
   descriptionKey: "$dms.shortcuts.tableview.escape.description",
   component: "$dms.components.tableview",
+  condition: {
+    descriptionKey: "$dms.shortcuts.tableview.escape.condition",
+  },
 };
 
+/**
+ * Nuxt UI's `defineShortcuts` calls `preventDefault()` on every key it
+ * handles, and reka-ui's DismissableLayer ignores a prevented Escape. The
+ * shortcut is therefore only registered when there is a search or a
+ * selection to clear, and never while focus sits inside an overlay, so the
+ * overlay above the table keeps closing on Escape.
+ */
+export function isTableViewEscapeActive(
+  globalFilter: ShallowRef<string | undefined>,
+  rowSelect: Ref<RowSelectionState>,
+  activeElement: Ref<Element | null | undefined>,
+): boolean {
+  if (isFocusInsideOverlay(activeElement.value)) return false;
+  return (
+    globalFilter.value !== undefined || Object.keys(rowSelect.value).length > 0
+  );
+}
+
 export function createTableViewEscapeShortcut(
   globalFilter: ShallowRef<string | undefined>,
   rowSelect: Ref<RowSelectionState>,

package/frontend-vue/layers/dms-ui/app/composables/tree/shortcuts/index.ts

@@ -1,3 +1,4 @@
+import { computed, type ComputedRef } from "vue";
 import {
   TREE_ARROW_DOWN_METADATA,
   createTreeArrowDownShortcut,
@@ -11,7 +12,11 @@ import { TREE_SPACE_METADATA, createTreeSpaceShortcut } from "./treeSpace";
 import { TREE_HOME_METADATA, createTreeHomeShortcut } from "./treeHome";
 import { TREE_END_METADATA, createTreeEndShortcut } from "./treeEnd";
 import { TREE_SHIFT_A_METADATA, createTreeShiftAShortcut } from "./treeShiftA";
-import { TREE_ESCAPE_METADATA, createTreeEscapeShortcut } from "./treeEscape";
+import {
+  TREE_ESCAPE_METADATA,
+  createTreeEscapeShortcut,
+  isTreeEscapeActive,
+} from "./treeEscape";
 
 export const TREE_SHORTCUTS_METADATA = [
   TREE_ARROW_DOWN_METADATA,
@@ -29,15 +34,19 @@ interface BuildTreeShortcutsParams {
   props: TreeProps;
   items: ComputedRef<TreeNode[]>;
   selected: Ref<TreeNode | TreeNode[] | undefined>;
+  activeElement: Ref<Element | null | undefined>;
 }
 
+type TreeShortcuts = Record<string, (() => void) | undefined>;
+
 export function buildTreeShortcuts({
   navigateTree,
   props,
   items,
   selected,
-}: BuildTreeShortcutsParams): Record<string, () => void> {
-  return {
+  activeElement,
+}: BuildTreeShortcutsParams): ComputedRef<TreeShortcuts> {
+  const shortcuts = {
     arrowdown: createTreeArrowDownShortcut(navigateTree),
     arrowup: createTreeArrowUpShortcut(navigateTree),
     enter: createTreeEnterShortcut(navigateTree),
@@ -45,6 +54,12 @@ export function buildTreeShortcuts({
     home: createTreeHomeShortcut(navigateTree),
     end: createTreeEndShortcut(navigateTree),
     shift_a: createTreeShiftAShortcut(props, items, selected),
-    escape: createTreeEscapeShortcut(props, selected),
   };
+  const escape = createTreeEscapeShortcut(props, selected);
+  // An unregistered key is left untouched by `defineShortcuts`, so Escape
+  // reaches overlays whenever the tree has nothing to clear.
+  return computed(() => ({
+    ...shortcuts,
+    escape: isTreeEscapeActive(selected, activeElement) ? escape : undefined,
+  }));
 }

package/frontend-vue/layers/dms-ui/app/composables/tree/shortcuts/treeEscape.ts

@@ -1,9 +1,30 @@
+import { isFocusInsideOverlay } from "../../../utils/overlayFocus";
+
 export const TREE_ESCAPE_METADATA: ShortcutMetadata = {
   key: ["$keyboard.escape"],
   descriptionKey: "$dms.shortcuts.tree.escape.description",
   component: "$dms.components.tree",
+  condition: {
+    descriptionKey: "$dms.shortcuts.tree.escape.condition",
+  },
 };
 
+/**
+ * Nuxt UI's `defineShortcuts` calls `preventDefault()` on every key it
+ * handles, and reka-ui's DismissableLayer ignores a prevented Escape. The
+ * shortcut is therefore only registered when there is a selection to clear,
+ * and never while focus sits inside an overlay, so the overlay above the tree
+ * keeps closing on Escape.
+ */
+export function isTreeEscapeActive(
+  selected: Ref<TreeNode | TreeNode[] | undefined>,
+  activeElement: Ref<Element | null | undefined>,
+): boolean {
+  if (isFocusInsideOverlay(activeElement.value)) return false;
+  const value = selected.value;
+  return Array.isArray(value) ? value.length > 0 : value != null;
+}
+
 export function createTreeEscapeShortcut(
   props: TreeProps,
   selected: Ref<TreeNode | TreeNode[] | undefined>,

package/frontend-vue/layers/dms-ui/app/utils/overlayFocus.ts

@@ -0,0 +1,16 @@
+// Overlays reka-ui dismisses on Escape (modals, slideovers, popovers, menus,
+// selects). They move focus inside themselves while open.
+const OVERLAY_SELECTOR =
+  '[role="dialog"], [role="alertdialog"], [role="menu"], [role="listbox"]';
+
+/**
+ * Nuxt UI's `defineShortcuts` calls `preventDefault()` on every key it
+ * handles, and reka-ui's DismissableLayer ignores a prevented Escape. A
+ * component-level Escape shortcut must therefore stay unregistered while
+ * focus sits inside an overlay, so the overlay keeps closing on Escape.
+ */
+export function isFocusInsideOverlay(
+  activeElement: Element | null | undefined,
+): boolean {
+  return Boolean(activeElement?.closest(OVERLAY_SELECTOR));
+}

package/frontend-vue/layers/dms-ui/i18n/locales/ui-en-GB.json

@@ -292,7 +292,8 @@
           "description": "Refresh table data"
         },
         "escape": {
-          "description": "Close search or deselect rows"
+          "description": "Close search or deselect rows",
+          "condition": "Only when a search or a row selection is active and no dialog is open"
         },
         "shift_n": {
           "description": "Create new row",
@@ -330,7 +331,8 @@
           "description": "Go to last node"
         },
         "escape": {
-          "description": "Deselect all nodes"
+          "description": "Deselect all nodes",
+          "condition": "Only when nodes are selected and no dialog is open"
         },
         "shift_a": {
           "description": "Select all nodes recursively",

package/frontend-vue/layers/dms-ui/i18n/locales/ui-fr-FR.json

@@ -293,7 +293,8 @@
           "description": "Actualiser les données du tableau"
         },
         "escape": {
-          "description": "Fermer la recherche ou désélectionner les lignes"
+          "description": "Fermer la recherche ou désélectionner les lignes",
+          "condition": "Uniquement quand une recherche ou une sélection est active et qu'aucune fenêtre n'est ouverte"
         },
         "shift_n": {
           "description": "Créer une nouvelle ligne",
@@ -331,7 +332,8 @@
           "description": "Aller au dernier nœud"
         },
         "escape": {
-          "description": "Désélectionner tous les nœuds"
+          "description": "Désélectionner tous les nœuds",
+          "condition": "Uniquement quand des nœuds sont sélectionnés et qu'aucune fenêtre n'est ouverte"
         },
         "shift_a": {
           "description": "Sélectionner tous les nœuds récursivement",

package/frontend-vue/package.json

@@ -59,7 +59,7 @@
   },
   "devDependencies": {
     "@antelopejs/core": ">=1.9.1 <2",
-    "@antelopejs/dms-frontend": ">=0.2.8 <1.0.0",
+    "@antelopejs/dms-frontend": ">=0.3.2 <1.0.0",
     "@eslint/js": "^8.57.0",
     "@inertiajs/vue3": "^3.7.0",
     "@nuxt/ui": "4.10.0",

package/frontend-vue/pnpm-lock.yaml

@@ -124,8 +124,8 @@ importers:
         specifier: '>=1.9.1 <2'
         version: 1.9.1(@types/node@24.8.1)
       '@antelopejs/dms-frontend':
-        specifier: '>=0.2.8 <1.0.0'
-        version: 0.2.8(@antelopejs/core@1.9.1(@types/node@24.8.1))
+        specifier: '>=0.3.2 <1.0.0'
+        version: 0.3.2(@antelopejs/core@1.9.1(@types/node@24.8.1))
       '@eslint/js':
         specifier: ^8.57.0
         version: 8.57.0
@@ -200,8 +200,8 @@ packages:
     resolution: {integrity: sha512-MPLJak0rPluV4lgsdsO5ba03sgTxIGSncajBcoaoppuppQmksdpaemojIHiVLJ4LiG0iiH21Roaed8XXy1XkYQ==}
     hasBin: true
 
-  '@antelopejs/dms-frontend@0.2.8':
-    resolution: {integrity: sha512-7qrlf2M3J26DZxGZVvM/3qjPDeDfoRMrE7HEPFxWav8Pe1QFct7LtgY7NmKup9XdrRyUw4nqckxvW8UZDSjpeg==}
+  '@antelopejs/dms-frontend@0.3.2':
+    resolution: {integrity: sha512-BNqLqW3UbfeOMnd4RkEynr/1mMWFhwB8dt1JbggaGte8/KrJQ3MQ5TOovnACMmrqAD7FxsMLBsNqjzGjX4O4ZA==}
     engines: {node: '>=20.12.0'}
     hasBin: true
     peerDependencies:
@@ -4331,7 +4331,7 @@ snapshots:
     transitivePeerDependencies:
       - '@types/node'
 
-  '@antelopejs/dms-frontend@0.2.8(@antelopejs/core@1.9.1(@types/node@24.8.1))':
+  '@antelopejs/dms-frontend@0.3.2(@antelopejs/core@1.9.1(@types/node@24.8.1))':
     dependencies:
       boxen: 5.1.2
       chalk: 4.1.2

package/frontend-vue/tests/table-view-escape-shortcut.test.ts

@@ -0,0 +1,141 @@
+// @vitest-environment jsdom
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  computed,
+  createApp,
+  defineComponent,
+  nextTick,
+  ref,
+  shallowRef,
+  type App,
+  type Ref,
+  type ShallowRef,
+} from "vue";
+import { useActiveElement } from "@vueuse/core";
+import type { RowSelectionState } from "@tanstack/vue-table";
+import { defineShortcuts } from "@nuxt/ui/runtime/composables/defineShortcuts.js";
+import {
+  TABLE_VIEW_SHORTCUTS_METADATA,
+  buildTableViewShortcuts,
+} from "../layers/dms-ui/app/composables/table-view/shortcuts";
+
+let app: App;
+let host: HTMLDivElement;
+let globalFilter: ShallowRef<string | undefined>;
+let rowSelect: Ref<RowSelectionState>;
+
+function mountTableShortcuts() {
+  const Harness = defineComponent({
+    setup() {
+      defineShortcuts(
+        buildTableViewShortcuts({
+          refresh: () => {},
+          tableProps: computed(() => ({})),
+          newRow: () => {},
+          globalFilter,
+          rowSelect,
+          data: ref(null),
+          activeElement: useActiveElement(),
+        }),
+      );
+      return () => null;
+    },
+  });
+  app = createApp(Harness);
+  app.mount(host);
+}
+
+function pressEscape(target: EventTarget = document.body): KeyboardEvent {
+  const event = new KeyboardEvent("keydown", {
+    key: "Escape",
+    code: "Escape",
+    bubbles: true,
+    cancelable: true,
+  });
+  target.dispatchEvent(event);
+  return event;
+}
+
+beforeEach(() => {
+  host = document.createElement("div");
+  document.body.appendChild(host);
+  globalFilter = shallowRef<string | undefined>(undefined);
+  rowSelect = ref<RowSelectionState>({});
+});
+
+afterEach(() => {
+  app.unmount();
+  document.body.innerHTML = "";
+});
+
+describe("TableView Escape shortcut", () => {
+  it("leaves Escape to overlays when there is nothing to clear", async () => {
+    mountTableShortcuts();
+    await nextTick();
+
+    expect(pressEscape().defaultPrevented).toBe(false);
+  });
+
+  it("closes the search when a global filter is set", async () => {
+    globalFilter.value = "acme";
+    mountTableShortcuts();
+    await nextTick();
+
+    expect(pressEscape().defaultPrevented).toBe(true);
+    expect(globalFilter.value).toBeUndefined();
+  });
+
+  it("clears the row selection when no search is open", async () => {
+    rowSelect.value = { a: true, b: true };
+    mountTableShortcuts();
+    await nextTick();
+
+    expect(pressEscape().defaultPrevented).toBe(true);
+    expect(rowSelect.value).toEqual({});
+  });
+
+  it("closes the search before touching the selection", async () => {
+    globalFilter.value = "";
+    rowSelect.value = { a: true };
+    mountTableShortcuts();
+    await nextTick();
+
+    pressEscape();
+    expect(globalFilter.value).toBeUndefined();
+    expect(rowSelect.value).toEqual({ a: true });
+  });
+
+  it("stops handling Escape once the filter is cleared", async () => {
+    globalFilter.value = "acme";
+    mountTableShortcuts();
+    await nextTick();
+
+    pressEscape();
+    await nextTick();
+    expect(pressEscape().defaultPrevented).toBe(false);
+  });
+
+  it("lets an open dialog take Escape even with a filter set", async () => {
+    globalFilter.value = "acme";
+    mountTableShortcuts();
+    const dialog = document.createElement("div");
+    dialog.setAttribute("role", "dialog");
+    const button = document.createElement("button");
+    dialog.appendChild(button);
+    document.body.appendChild(dialog);
+    button.focus();
+    await nextTick();
+
+    expect(pressEscape(button).defaultPrevented).toBe(false);
+    expect(globalFilter.value).toBe("acme");
+  });
+
+  it("describes when the shortcut applies in the help list", () => {
+    const escape = TABLE_VIEW_SHORTCUTS_METADATA.find((metadata) =>
+      metadata.key.includes("$keyboard.escape"),
+    );
+    expect(escape?.condition?.descriptionKey).toBe(
+      "$dms.shortcuts.tableview.escape.condition",
+    );
+  });
+});

package/frontend-vue/tests/tree-escape-shortcut.test.ts

@@ -0,0 +1,138 @@
+// @vitest-environment jsdom
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  computed,
+  createApp,
+  defineComponent,
+  nextTick,
+  ref,
+  type App,
+  type Ref,
+} from "vue";
+import { useActiveElement } from "@vueuse/core";
+import { defineShortcuts } from "@nuxt/ui/runtime/composables/defineShortcuts.js";
+import {
+  TREE_SHORTCUTS_METADATA,
+  buildTreeShortcuts,
+} from "../layers/dms-ui/app/composables/tree/shortcuts";
+import type {
+  TreeNode,
+  TreeProps,
+} from "../layers/dms-ui/app/composables/tree/types";
+
+let app: App;
+let host: HTMLDivElement;
+let selected: Ref<TreeNode | TreeNode[] | undefined>;
+
+const nodeA = { label: "A", value: "a" } as TreeNode;
+const nodeB = { label: "B", value: "b" } as TreeNode;
+
+function mountTreeShortcuts(multiple = false) {
+  const Harness = defineComponent({
+    setup() {
+      defineShortcuts(
+        buildTreeShortcuts({
+          navigateTree: () => {},
+          props: { multiple } as TreeProps,
+          items: computed(() => [nodeA, nodeB]),
+          selected,
+          activeElement: useActiveElement(),
+        }),
+      );
+      return () => null;
+    },
+  });
+  app = createApp(Harness);
+  app.mount(host);
+}
+
+function pressEscape(target: EventTarget = document.body): KeyboardEvent {
+  const event = new KeyboardEvent("keydown", {
+    key: "Escape",
+    code: "Escape",
+    bubbles: true,
+    cancelable: true,
+  });
+  target.dispatchEvent(event);
+  return event;
+}
+
+beforeEach(() => {
+  host = document.createElement("div");
+  document.body.appendChild(host);
+  selected = ref<TreeNode | TreeNode[] | undefined>(undefined);
+});
+
+afterEach(() => {
+  app.unmount();
+  document.body.innerHTML = "";
+});
+
+describe("Tree Escape shortcut", () => {
+  it("leaves Escape to overlays when nothing is selected", async () => {
+    mountTreeShortcuts();
+    await nextTick();
+
+    expect(pressEscape().defaultPrevented).toBe(false);
+  });
+
+  it("leaves Escape to overlays when a multiple selection is empty", async () => {
+    selected.value = [];
+    mountTreeShortcuts(true);
+    await nextTick();
+
+    expect(pressEscape().defaultPrevented).toBe(false);
+  });
+
+  it("deselects the node in single selection mode", async () => {
+    selected.value = nodeA;
+    mountTreeShortcuts();
+    await nextTick();
+
+    expect(pressEscape().defaultPrevented).toBe(true);
+    expect(selected.value).toBeUndefined();
+  });
+
+  it("clears every node in multiple selection mode", async () => {
+    selected.value = [nodeA, nodeB];
+    mountTreeShortcuts(true);
+    await nextTick();
+
+    expect(pressEscape().defaultPrevented).toBe(true);
+    expect(selected.value).toEqual([]);
+  });
+
+  it("stops handling Escape once the selection is cleared", async () => {
+    selected.value = [nodeA];
+    mountTreeShortcuts(true);
+    await nextTick();
+
+    pressEscape();
+    await nextTick();
+    expect(pressEscape().defaultPrevented).toBe(false);
+  });
+
+  it("lets an open dialog take Escape even with a selection", async () => {
+    selected.value = nodeA;
+    mountTreeShortcuts();
+    const dialog = document.createElement("div");
+    dialog.setAttribute("role", "dialog");
+    const button = document.createElement("button");
+    dialog.appendChild(button);
+    document.body.appendChild(dialog);
+    button.focus();
+    await nextTick();
+
+    expect(pressEscape(button).defaultPrevented).toBe(false);
+    expect(selected.value).toStrictEqual(nodeA);
+  });
+
+  it("describes when the shortcut applies in the help list", () => {
+    const escape = TREE_SHORTCUTS_METADATA.find((metadata) =>
+      metadata.key.includes("$keyboard.escape"),
+    );
+    expect(escape?.condition?.descriptionKey).toBe(
+      "$dms.shortcuts.tree.escape.condition",
+    );
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AntelopeJS/dms.git"
@@ -36,7 +36,7 @@
     "@antelopejs/interface-data-api": ">=0.1.9 <1.0.0",
     "@antelopejs/interface-database": ">=0.1.7 <1.0.0",
     "@antelopejs/interface-database-decorators": ">=0.1.6 <1.0.0",
-    "@antelopejs/interface-dms": ">=0.2.5 <1.0.0",
+    "@antelopejs/interface-dms": ">=0.2.6 <1.0.0",
     "@antelopejs/interface-email": ">=0.0.5 <1.0.0",
     "@antelopejs/interface-file-storage": ">=0.1.3 <1.0.0",
     "archiver": "^7.0.1",