@antelopejs/dms 0.9.8 → 0.11.0

package/frontend-vue/layers/dms-layout/app/pages/[...slug].vue

@@ -4,7 +4,9 @@ import { holdPageHeaderActions } from "../composables/layout/usePageHeaderAction
 import { useDevReloading } from "../build/composables/dev-reload/useDevReloadHolder";
 import { usePageLiveHost } from "#dms-ui/app/build/composables/live/usePageLiveHost";
 import { usePageDataRefresh } from "#dms-ui/app/build/composables/live/usePageDataRefresh";
+import { usePageRecordDeletion } from "../composables/page/usePageRecordDeletion";
 import { pageValidationRedirect } from "../build/utils/pageValidationRedirect";
+import { resolveComponentChildren } from "#dms-ui/app/utils/componentTree";
 
 defineOptions({ inheritAttrs: false });
 
@@ -215,9 +217,10 @@ if (import.meta.env.DEV) {
 
 const { pageLayout } = await usePageLayout();
 
-watch(pageLayout, (layout) => preloadPageLayoutComponents(layout), {
-  immediate: true,
-});
+// A client navigation shows the page once its blocks' code is there: a lazy
+// block draws nothing until its chunk lands, then pushes the page down.
+await preloadPageLayoutComponents(pageLayout.value);
+watch(pageLayout, (layout) => void preloadPageLayoutComponents(layout));
 
 const { refreshIfStale: refreshPermissionsIfStale } = usePermissions();
 
@@ -249,6 +252,12 @@ usePageLiveHost(
 );
 // The page's `useApiData` reads follow its refreshes and its realtime events.
 usePageDataRefresh(realtime);
+// A detail page leaves for its list once its record is deleted.
+usePageRecordDeletion({
+  pageLayout: () => pageLayout.value,
+  pageTopics: realtime.pageTopics,
+  subscribe: realtime.subscribe,
+});
 
 function buildPageSetupContext(
   pageInfo: PageInfo,
@@ -345,24 +354,6 @@ watch(
 onMounted(runPageSetup);
 onUnmounted(tearDownPageSetup);
 
-const processChildren = (
-  children: ComponentChild[],
-): ResolvedComponentInfo[] => {
-  return children.map((child) => {
-    const { id, component, ...additionalProps } = child;
-    return {
-      id,
-      options: component.options,
-      component: component.componentName
-        ? resolveDmsComponent(component.componentName) || "div"
-        : "div",
-      componentName: component.componentName,
-      children: component.children ? processChildren(component.children) : [],
-      ...additionalProps,
-    };
-  });
-};
-
 const components = computed(() =>
   Object.keys(pageLayout.value?.components || {}).map((field) => {
     const componentInfo = pageLayout.value?.components[field];
@@ -374,7 +365,7 @@ const components = computed(() =>
         : "div",
       componentName: componentInfo?.componentName,
       children: componentInfo?.children
-        ? processChildren(componentInfo.children)
+        ? resolveComponentChildren(componentInfo.children)
         : [],
     } as ResolvedComponentInfo;
   }),

package/frontend-vue/layers/dms-layout/app/plugins/command-palette-navigation.client.ts

@@ -13,16 +13,17 @@ function isHiddenFromNavigation(node: SiteLayoutTree): boolean {
 function collectNavigationItems(
   node: SiteLayoutTree,
   ancestors: string[],
-  translate: I18nTranslate,
+  translation: AppTranslation,
   items: CommandPaletteItem[],
 ): void {
   for (const childId of node.childrenOrders) {
     const child = node.children[childId];
     if (!child || isHiddenFromNavigation(child)) continue;
 
-    const label = resolveI18nKey(translate, child.displayName);
+    const label = translation.processI18n(child.displayName);
     const to = buildMenuItemTarget(child);
-    if (to && child.fullSlug) {
+    // The account entries (Settings, Profile) are the session group's.
+    if (to && child.fullSlug && !isAccountMenuRoute(to)) {
       items.push({
         label,
         suffix:
@@ -32,40 +33,40 @@ function collectNavigationItems(
         icon: child.icon ?? DEFAULT_PAGE_ICON,
         to,
         [COMMAND_PALETTE_SEARCH_TEXT_KEY]: resolveOptionalI18nKey(
-          translate,
+          translation.t,
           child.description,
         ),
       });
     }
-    collectNavigationItems(child, [...ancestors, label], translate, items);
+    collectNavigationItems(child, [...ancestors, label], translation, items);
   }
 }
 
 function buildNavigationGroups(
   tree: SiteLayoutTree | undefined,
-  translate: I18nTranslate,
+  translation: AppTranslation,
 ): CommandPaletteGroup[] {
   if (!tree) return [];
 
   const items: CommandPaletteItem[] = [];
-  collectNavigationItems(tree, [], translate, items);
+  collectNavigationItems(tree, [], translation, items);
   if (items.length === 0) return [];
 
   return [
     {
       id: NAVIGATION_GROUP_ID,
-      label: translate("commandPalette.groups.navigation", {}),
+      label: translation.t("commandPalette.groups.navigation"),
       items,
     },
   ];
 }
 
 export default defineDmsPlugin(() => {
-  const { translate } = getPluginI18n();
+  const translation = getAppTranslation();
   const { siteLayoutTree } = useSiteLayout();
 
   const groups = computed<CommandPaletteGroup[]>(() =>
-    buildNavigationGroups(siteLayoutTree.value, translate),
+    buildNavigationGroups(siteLayoutTree.value, translation),
   );
 
   registerCommandPaletteSource({

package/frontend-vue/layers/dms-layout/app/plugins/command-palette-personal-pages.client.ts

@@ -1,90 +1,60 @@
-import type { CommandPaletteGroup, CommandPaletteItem } from "@nuxt/ui";
+import type { CommandPaletteGroup } from "@nuxt/ui";
+import {
+  type RecentModule,
+  recentModules,
+} from "../build/utils/modules-catalog";
 
 const PERSONAL_PAGES_SOURCE_ID = "dms-personal-pages";
 const PERSONAL_PAGES_SOURCE_ORDER = 20;
 const FAVORITES_GROUP_ID = "favorite-pages";
 const RECENT_MODULES_GROUP_ID = "recent-modules";
 
-type AccessibleModules = Record<string, ModuleWithAccess> | undefined;
-
-type PathLabelResolver = (path: string) => string | undefined;
-
 function buildFavoritesGroup(
   favorites: FavoritePage[],
-  translate: I18nTranslate,
+  translation: AppTranslation,
 ): CommandPaletteGroup | null {
   if (favorites.length === 0) return null;
 
   return {
     id: FAVORITES_GROUP_ID,
-    label: translate("menu.favorites", {}),
+    label: translation.t("menu.favorites"),
     items: favorites.map((favorite) => ({
-      label: resolveI18nKey(translate, favorite.title),
+      label: translation.processI18n(favorite.title),
       icon: favorite.icon ?? DEFAULT_PAGE_ICON,
       to: favorite.path,
     })),
   };
 }
 
-function buildRecentModuleItem(
-  entry: ModuleHistoryEntry,
-  modules: AccessibleModules,
-  translate: I18nTranslate,
-  resolvePathLabel: PathLabelResolver,
-): CommandPaletteItem | null {
-  const module = modules?.[entry.moduleId];
-  if (!module?.hasAccess) return null;
-
-  return {
-    label: resolveI18nKey(translate, module.title),
-    suffix: resolvePathLabel(entry.path),
-    icon: module.icon,
-    to: entry.path,
-  };
-}
-
 function buildRecentModulesGroup(
-  entries: ModuleHistoryEntry[],
-  modules: AccessibleModules,
-  translate: I18nTranslate,
-  resolvePathLabel: PathLabelResolver,
+  modules: RecentModule[],
+  translation: AppTranslation,
 ): CommandPaletteGroup | null {
-  const items = entries
-    .slice()
-    .reverse()
-    .map((entry) =>
-      buildRecentModuleItem(entry, modules, translate, resolvePathLabel),
-    )
-    .filter((item): item is CommandPaletteItem => item !== null);
-  if (items.length === 0) return null;
+  if (modules.length === 0) return null;
 
   return {
     id: RECENT_MODULES_GROUP_ID,
-    label: translate("commandPalette.groups.recentModules", {}),
-    items,
+    label: translation.t("commandPalette.groups.recentModules"),
+    items: modules.map((module) => ({
+      label: translation.processI18n(module.title),
+      icon: module.icon,
+      to: module.to,
+    })),
   };
 }
 
 export default defineDmsPlugin(() => {
-  const { translate } = getPluginI18n();
+  const translation = getAppTranslation();
   const { sortedFavorites } = useFavoritePages();
   const { entries } = useModuleHistory();
-  const { modules, findMatchingRoute } = useSiteLayout();
-
-  const resolvePathLabel: PathLabelResolver = (path) => {
-    const match = findMatchingRoute(path);
-    if (!match) return undefined;
-    return resolveI18nKey(translate, match.metadata.displayName);
-  };
+  const { modules, siteLayoutTree } = useSiteLayout();
 
   const groups = computed<CommandPaletteGroup[]>(() =>
     [
-      buildFavoritesGroup(sortedFavorites.value, translate),
+      buildFavoritesGroup(sortedFavorites.value, translation),
       buildRecentModulesGroup(
-        entries.value,
-        modules.value,
-        translate,
-        resolvePathLabel,
+        recentModules(entries.value, modules.value, siteLayoutTree.value),
+        translation,
       ),
     ].filter((group): group is CommandPaletteGroup => group !== null),
   );

package/frontend-vue/layers/dms-layout/app/plugins/command-palette-quick-actions.client.ts

@@ -6,10 +6,10 @@ const QUICK_ACTIONS_GROUP_PREFIX = "quick-actions";
 
 function buildActionItem(
   action: QuickActionInfo,
-  translate: I18nTranslate,
+  translation: AppTranslation,
 ): CommandPaletteItem {
   return {
-    label: resolveI18nKey(translate, action.displayName),
+    label: translation.processI18n(action.displayName),
     icon: action.icon,
     onSelect: () => {
       void dispatchQuickActionTarget(action.target);
@@ -19,21 +19,21 @@ function buildActionItem(
 
 function buildQuickActionGroups(
   categoryGroups: QuickActionCategoryGroup[],
-  translate: I18nTranslate,
+  translation: AppTranslation,
 ): CommandPaletteGroup[] {
   return categoryGroups.map((group) => ({
     id: `${QUICK_ACTIONS_GROUP_PREFIX}-${group.category.id}`,
-    label: resolveI18nKey(translate, group.category.displayName),
-    items: group.actions.map((action) => buildActionItem(action, translate)),
+    label: translation.processI18n(group.category.displayName),
+    items: group.actions.map((action) => buildActionItem(action, translation)),
   }));
 }
 
 export default defineDmsPlugin(() => {
-  const { translate } = getPluginI18n();
+  const translation = getAppTranslation();
   const { categoryGroups } = useQuickActions();
 
   const groups = computed<CommandPaletteGroup[]>(() =>
-    buildQuickActionGroups(categoryGroups.value, translate),
+    buildQuickActionGroups(categoryGroups.value, translation),
   );
 
   registerCommandPaletteSource({

package/frontend-vue/layers/dms-layout/app/plugins/command-palette-session.client.ts

@@ -22,16 +22,17 @@ function uniqueByCode<T extends LocaleOption>(locales: T[]): T[] {
   });
 }
 
-function buildAccountItems(translate: I18nTranslate): CommandPaletteItem[] {
+function buildAccountItems(t: AppTranslation["t"]): CommandPaletteItem[] {
   return ACCOUNT_MENU_ENTRIES.map((entry) => ({
-    label: translate(entry.labelKey, {}),
+    label: t(entry.labelKey),
     icon: entry.icon,
     to: entry.to,
   }));
 }
 
 export default defineDmsPlugin(() => {
-  const { i18n, translate } = getPluginI18n();
+  const { $i18n: i18n } = useDmsApp();
+  const { t } = getAppTranslation();
   const toast = useToast();
   const { logout } = useLogout();
   const { changeLanguage } = useUserLanguage();
@@ -49,10 +50,10 @@ export default defineDmsPlugin(() => {
   async function copyCurrentUrl(): Promise<void> {
     try {
       await copy(window.location.href);
-      toast.add({ title: translate("commandPalette.session.urlCopied", {}) });
+      toast.add({ title: t("commandPalette.session.urlCopied") });
     } catch {
       toast.add({
-        title: translate("commandPalette.session.copyFailed", {}),
+        title: t("commandPalette.session.copyFailed"),
         color: "error",
       });
     }
@@ -61,23 +62,23 @@ export default defineDmsPlugin(() => {
   function buildSessionGroup(): CommandPaletteGroup {
     return {
       id: SESSION_GROUP_ID,
-      label: translate("commandPalette.groups.session", {}),
+      label: t("commandPalette.groups.session"),
       items: [
-        ...buildAccountItems(translate),
+        ...buildAccountItems(t),
         {
-          label: translate("commandPalette.session.changeLanguage", {}),
+          label: t("commandPalette.session.changeLanguage"),
           icon: LANGUAGE_ICON,
           children: localeItems(),
         },
         {
-          label: translate("commandPalette.session.copyUrl", {}),
+          label: t("commandPalette.session.copyUrl"),
           icon: COPY_URL_ICON,
           onSelect: () => {
             void copyCurrentUrl();
           },
         },
         {
-          label: translate("button.logout", {}),
+          label: t("button.logout"),
           icon: LOGOUT_ICON,
           onSelect: () => {
             void logout();

package/frontend-vue/layers/dms-layout/app/plugins/dms-dev-reload.client.ts

@@ -1,5 +1,5 @@
 import { useDevReloadHolder } from "../build/composables/dev-reload/useDevReloadHolder";
-import { openDevReloadStream } from "../build/utils/dev-reload-stream";
+import { followDevReload } from "../build/utils/dev-reload-stream";
 
 const RELOAD_ENDPOINT_PATH = "/dms/dev/reload";
 
@@ -11,7 +11,7 @@ function resolveBackendBase(): string | null {
 }
 
 /**
- * Dev-only: turn the backend's `reload` stream into a soft refresh.
+ * Dev-only: turn the backend's reload signal into a soft refresh.
  *
  * All the waiting lives in the dev-reload coordinator (see `useDevReloadHolder`), so
  * this plugin and the `useDevReload().awaitRoute` module frontends call
@@ -25,14 +25,19 @@ export default defineDmsPlugin(() => {
 
   const endpoint = `${backendBase}${RELOAD_ENDPOINT_PATH}`;
   const { coordinator } = useDevReloadHolder();
-  const stream = openDevReloadStream({
-    endpoint,
-    onReload: () => {
-      void coordinator.requestRefresh().catch((err: unknown) => {
-        console.error("[dms-dev-reload] Reload handler failed:", err);
-      });
+  // Carried by the user's realtime stream while it is open, by a stream of
+  // its own otherwise (the sign-in page).
+  const stream = followDevReload(
+    {
+      endpoint,
+      onReload: () => {
+        void coordinator.requestRefresh().catch((err: unknown) => {
+          console.error("[dms-dev-reload] Reload handler failed:", err);
+        });
+      },
     },
-  });
+    useUserRealtime(),
+  );
 
   if (import.meta.hot) {
     import.meta.hot.dispose(() => {

package/frontend-vue/layers/dms-layout/app/theme/actions.ts

@@ -330,14 +330,15 @@ const tabsTheme = {
     trigger: "data-[state=active]:font-semibold",
     // Counts as mono chips, tinted with the accent on the active tab.
     trailingBadge:
-      "font-mono text-[10.5px] h-4 px-[5px] rounded-[4px] ring-0 bg-elevated text-dimmed group-data-[state=active]:bg-(--dms-accent-tint) group-data-[state=active]:text-primary",
+      "font-mono text-[10.5px] h-4 px-[5px] rounded-(--dms-radius-tab-badge) ring-0 bg-elevated text-dimmed group-data-[state=active]:bg-(--dms-accent-tint) group-data-[state=active]:text-primary",
   },
   variants: {
     variant: {
       pill: {
-        list: "bg-(--dms-bg-muted) ring ring-inset ring-default p-[3px] gap-0.5 rounded-[10px]",
-        indicator: "ring ring-accented shadow-(--shadow-sm) rounded-[7px]",
-        trigger: "rounded-[7px] before:rounded-[7px]",
+        list: "bg-(--dms-bg-muted) ring ring-inset ring-default p-[3px] gap-0.5 rounded-(--dms-radius-tab-list)",
+        indicator:
+          "ring ring-accented shadow-(--shadow-sm) rounded-(--dms-radius-tab)",
+        trigger: "rounded-(--dms-radius-tab) before:rounded-(--dms-radius-tab)",
       },
     },
     // A vertical list sits at the top of its panel, not centred beside it.

package/frontend-vue/layers/dms-layout/app/theme/form-controls.ts

@@ -117,11 +117,16 @@ const inputTheme = {
   ],
 };
 
-/** Select-like triggers: the input scale with explicit line heights. */
+/**
+ * Select-like triggers: the input scale with explicit line heights, so a
+ * select is as tall as the text field beside it. Below md they keep the
+ * input's 16px (14px for sm), as a text field does, so a form on a phone
+ * reads in one size.
+ */
 const SELECT_TRIGGER_SIZES = {
-  sm: { base: "px-2 text-[12.5px]/4" },
-  md: { base: "text-[13px]/5" },
-  xl: { base: "text-[15px]/6" },
+  sm: { base: "px-2 text-sm/4 md:text-[12.5px]/4" },
+  md: { base: "text-base/5 md:text-[13px]/5" },
+  xl: { base: "text-base/6 md:text-[15px]/6" },
 };
 
 /**

package/frontend-vue/layers/dms-layout/app/theme/surfaces.ts

@@ -9,6 +9,10 @@
  */
 
 import { EYEBROW_CLASS } from "#dms-ui/app/build/utils/eyebrow";
+import {
+  CLOSING_OVERLAY_CLASS,
+  UNCOVERED_PANEL_CLASS,
+} from "#dms-ui/app/build/components/containers/constants";
 
 /** Floating panels (menus, popovers, toasts): accented hairline and the pop shadow. */
 const FLOATING_SURFACE =
@@ -18,7 +22,15 @@ const FLOATING_SURFACE =
 const OVERLAY_SURFACE =
   "bg-default ring-(--dms-border-top) shadow-(--dms-shadow-modal)";
 
-const BACKDROP = "bg-(--dms-overlay) backdrop-blur-[2px]";
+/**
+ * Every modal, slideover and drawer, the DMS's or a module's: its backdrop
+ * lets clicks through as soon as it starts closing and fades out quickly,
+ * and the panel animating out no longer catches them either (reka keeps
+ * `pointer-events: auto` inline on both). The panel a closing dialog
+ * uncovered (a drawer under a confirm) takes clicks again at once.
+ */
+const BACKDROP = `bg-(--dms-overlay) backdrop-blur-[2px] ${CLOSING_OVERLAY_CLASS}`;
+const CLOSING_PANEL = `data-[state=closed]:pointer-events-none! ${UNCOVERED_PANEL_CLASS}`;
 
 const cardTheme = {
   slots: {
@@ -90,7 +102,7 @@ const tooltipTheme = {
 
 const modalTheme = {
   slots: {
-    content: "bg-default divide-y-0",
+    content: `bg-default divide-y-0 ${CLOSING_PANEL}`,
     header: "items-start gap-3 min-h-0 px-5 pt-[18px] pb-0 sm:px-5",
     title: "text-[17px] leading-[1.3] font-[650] tracking-[-0.02em]",
     description: "mt-1 text-[13px]",
@@ -116,7 +128,7 @@ const modalTheme = {
 const slideoverTheme = {
   slots: {
     overlay: BACKDROP,
-    content: `${OVERLAY_SURFACE} sm:shadow-(--dms-shadow-modal)`,
+    content: `${OVERLAY_SURFACE} sm:shadow-(--dms-shadow-modal) ${CLOSING_PANEL}`,
     header: "px-5 sm:px-5",
     title: "text-[17px] leading-[1.3] font-[650] tracking-[-0.02em]",
     description: "text-[13px]",
@@ -138,7 +150,7 @@ const DRAWER_EDGE_COMPOUNDS = [
 const drawerTheme = {
   slots: {
     overlay: BACKDROP,
-    content: OVERLAY_SURFACE,
+    content: `${OVERLAY_SURFACE} ${CLOSING_PANEL}`,
   },
   compoundVariants: DRAWER_EDGE_COMPOUNDS,
 };
@@ -178,7 +190,10 @@ const toastTheme = {
  * New toasts rise 16px into place instead of sliding in from a full toast
  * height below: that slide started off-screen, so a toast whose animation
  * had not run yet (background tab, throttled frame) sat cut off under the
- * bottom edge.
+ * bottom edge. A bottom stack rises above a save bar on the bottom edge (the
+ * floating bar, a drawer's footer band): the bar sets how far it reaches
+ * (`--dms-toaster-clearance`, see `toasterClearance.ts`), so a toast never
+ * covers its buttons, and the stack drops back once the bar hides.
  */
 const toasterTheme = {
   slots: {
@@ -203,7 +218,8 @@ const toasterTheme = {
     {
       position: ["bottom-left", "bottom-center", "bottom-right"],
       class: {
-        viewport: "bottom-5",
+        viewport:
+          "bottom-[calc(var(--dms-toaster-clearance,0px)+1.25rem)] transition-[bottom] duration-200 ease-out motion-reduce:transition-none",
         base: "data-[state=open]:animate-none starting:translate-y-4",
       },
     },

package/frontend-vue/layers/dms-layout/app/types/module-store.ts

@@ -10,6 +10,9 @@ export type StoreModuleState =
   | "error"
   | "pending";
 
+/** Where a module's code comes from (`ModuleSourceKind` on the backend). */
+export type ModuleSourceKind = "npm" | "github" | "gitlab" | "git" | "local";
+
 export type StoreFrontendState = "none" | "synced" | "pending" | "unknown";
 
 export type StoreOperationKind =
@@ -86,6 +89,10 @@ export interface StoreListingEntry {
   description: string;
   state: StoreModuleState;
   installedVersion?: string;
+  /** Where its code comes from. */
+  source: ModuleSourceKind;
+  /** Runs from a local or git working copy: active, but no store action. */
+  isWorkingCopy?: boolean;
   /** The version range antelope.config.ts declares. */
   declaredRange?: string;
   latestVersion?: string;
@@ -103,6 +110,8 @@ export interface StoreListingEntry {
   missingInterfaces: MissingInterface[];
   /** Running modules that need an interface only this one implements. */
   dependents: string[];
+  /** The project's own code needs an interface only this module implements. */
+  usedByProject: boolean;
 }
 
 export interface StoreListing {

package/frontend-vue/layers/dms-layout/app/types/page.ts

@@ -1,6 +1,7 @@
 import type { BlockText } from "#dms-core/app/types/composed-text";
 import type { BlockAction } from "#dms-ui/app/build/components/blocks/BlockActions.vue";
 import type { PageLiveOptions } from "#dms-ui/app/types/live";
+import type { ModuleSourceKind } from "./module-store";
 
 export type MenuItemType = "label" | "link";
 // MenuItemVariant / MenuItemStatus / MenuItemQuery live in dms-core, the layer
@@ -88,12 +89,19 @@ export type ModuleCatalogEntry = ModuleWithAccess & {
   landingSlug: string;
   status?: ModuleStatus;
   readout?: ModuleReadoutLine[];
+  /**
+   * Where its code comes from, read from the module store; absent for a
+   * module the store does not list.
+   */
+  source?: ModuleSourceKind;
 };
 
 export const MODULE_URL_PREFIX = "/modules";
 
 export interface PageInfo extends Omit<CategoryInfo, "category"> {
   layoutUrl: string;
+  /** Full slug of the page this one is a detail of (`MenuOptions.parent`). */
+  parentSlug?: string;
 }
 
 export type SiteLayoutTree = Omit<PageInfo, "layoutUrl"> & {
@@ -107,15 +115,21 @@ export type SiteLayoutTree = Omit<PageInfo, "layoutUrl"> & {
 // Mirror of LayoutBannerVariant from @antelopejs/interface-dms/layout-banners.
 export type LayoutBannerVariant = "info" | "warning" | "error";
 
+// Mirror of LayoutBannerScope from @antelopejs/interface-dms/layout-banners.
+export type LayoutBannerScope = "app" | "modules" | "everywhere";
+
 /**
  * Mirror of the backend's serialized layout banner. The payload only carries
  * the banners whose visibility resolver passed for this request, so there is
- * nothing left to decide here but the user's own dismissals.
+ * nothing left to decide here but the current route against `scope` and the
+ * user's own dismissals.
  */
 export interface LayoutBanner {
   key: string;
   variant: LayoutBannerVariant;
   order: number;
+  /** The pages it shows on, the backend's `app` unless it says otherwise. */
+  scope: LayoutBannerScope;
   dismissible: boolean;
   icon?: string;
   /** A string (`$` for an i18n key) or a composed text. */

package/frontend-vue/layers/dms-layout/app/utils/account-menu.ts

@@ -5,6 +5,8 @@ export interface AccountMenuEntry {
 }
 
 export const PROFILE_ROUTE = "/settings/user/profile";
+// The account menu is the only way to the settings: the sidebar footer has no
+// Settings entry, so this one opens all of them, not just the user's own.
 export const SETTINGS_ROUTE = "/settings";
 export const SWITCH_ACCOUNT_ROUTE = "/auth/accounts";
 
@@ -26,3 +28,12 @@ export const ACCOUNT_MENU_ENTRIES: AccountMenuEntry[] = [
     to: SWITCH_ACCOUNT_ROUTE,
   },
 ];
+
+/**
+ * Whether `to` is the destination of an account menu entry. The command
+ * palette lists those entries in its session group, so its navigation group
+ * skips their pages instead of offering the same destination twice.
+ */
+export function isAccountMenuRoute(to: string): boolean {
+  return ACCOUNT_MENU_ENTRIES.some((entry) => entry.to === to);
+}