@antelopejs/dms 0.11.0 → 0.12.0

package/frontend-vue/layers/dms-layout/app/build/components/layout/DashboardHeader.vue

@@ -9,14 +9,14 @@ import {
   useHeaderActionControls,
 } from "../../composables/layout/useHeaderActionControls";
 import { usePageRecordLabel } from "#dms-core/app/composables/page/usePageRecordLabel";
-import type { CategoryInfo } from "../../../types/page";
+import type { CategoryInfo } from "#dms-core/app/types/page";
 import { resolveModuleLandingSlug } from "../../../utils/moduleLanding";
 import {
   foldBreadcrumb,
   isFoldedCrumbs,
   withParentCrumb,
 } from "../../../utils/breadcrumb";
-import { fillRouteParams } from "../../../utils/pageQuery";
+import { fillRouteParams } from "#dms-core/app/utils/pageQuery";
 
 const HOME_ICON = "i-ph-house-light";
 /** Breadcrumb slot of the folded middle crumbs on small screens. */
@@ -26,8 +26,8 @@ const TOOLBAR_BUTTON_CLASS =
   "text-muted hover:text-highlighted data-[state=open]:text-highlighted";
 /** The crumb naming a row keeps the row's own case (crumbs capitalize). */
 const RECORD_CRUMB_LABEL_CLASS = "first-letter:normal-case";
-// Nuxt UI types an item's `ui` as every breadcrumb slot at once; only the
-// label is restyled here.
+
+// SAFETY: UBreadcrumb reads each item.ui slot optionally; its Pick type requires slots the renderer permits omitting.
 const RECORD_CRUMB_UI = {
   linkLabel: RECORD_CRUMB_LABEL_CLASS,
 } as NonNullable<BreadcrumbItem["ui"]>;
@@ -38,12 +38,8 @@ const { t } = useI18n();
 const appConfig = useDmsAppConfig();
 const { open: sidebarOpen, collapsed: sidebarCollapsed } = useSidebarState();
 
-// Modules register their own header buttons through this generic registry, so
-// core has no knowledge of any specific module.
 const { actions: visibleActions } = useHeaderActions();
-// A `.client` plugin's action is missing from the server markup: drawn while
-// hydrating, its button would be patched onto the next one's node. It joins
-// once the header has mounted.
+
 const isMounted = ref(false);
 onMounted(() => {
   isMounted.value = true;
@@ -54,8 +50,6 @@ const registeredActions = computed(() =>
     : visibleActions.value.filter(isPlainDataHeaderAction),
 );
 
-// The builder button keeps its fixed slot first in the toolbar, and only
-// exists when a module (the Builder) registers the action that drives it.
 const builderAction = computed(() =>
   registeredActions.value.find((action) => action.id === BUILDER_ACTION_ID),
 );
@@ -79,7 +73,7 @@ const homepage = useHomepage();
 const siteLayout = useSiteLayout();
 const { processI18n } = useTranslation();
 const favoritePages = useFavoritePages();
-// The row an edit or details page is about names its last crumb.
+
 const { label: recordLabel } = usePageRecordLabel();
 
 const currentPageInfo = computed((): FavoritePage | null => {
@@ -121,9 +115,7 @@ const toggleCurrentPageFavorite = () => {
 };
 
 /** The page a module's root crumb opens: the module's landing page. */
-function moduleLandingSlug(
-  metadata: CategoryInfo,
-): string | undefined {
+function moduleLandingSlug(metadata: CategoryInfo): string | undefined {
   if (!metadata.isModuleRoot || metadata.hasAccess === false) return undefined;
   const module = siteLayout.modules.value?.[metadata.id];
   if (!module) return undefined;
@@ -150,10 +142,11 @@ const parentCrumb = computed((): BreadcrumbItem | null => {
   const parent = siteLayout.findMatchingRoute(path)?.metadata;
   if (!parent || parent.hasAccess === false) return null;
   const target = buildBreadcrumbTarget(path, parent, route.query);
-  return {
+  const crumb: BreadcrumbItem = {
     label: processI18n(parent.displayName),
-    ...(target ? { to: target } : {}),
   };
+  if (target) crumb.to = target;
+  return crumb;
 });
 
 const breadcrumb = computed((): BreadcrumbItem[] => {
@@ -161,8 +154,6 @@ const breadcrumb = computed((): BreadcrumbItem[] => {
     { icon: HOME_ICON, to: homepage || "/", "aria-label": t("header.home") },
   ];
 
-  // The path only: with the query, the last segment ("data?table=x") matched
-  // no route and the current page dropped out of the breadcrumb.
   if (route.path === (homepage || "/")) {
     return base;
   }
@@ -189,16 +180,16 @@ const breadcrumb = computed((): BreadcrumbItem[] => {
           route.query,
         );
 
-        return {
+        const crumb: BreadcrumbItem = {
           label: processI18n(matchingRoute.metadata?.displayName || path),
-          ...(target ? { to: target } : {}),
         };
+        if (target) crumb.to = target;
+        return crumb;
       })
       .filter((item) => item !== null),
   );
   const crumbs = withParentCrumb(pathCrumbs, parentCrumb.value);
 
-  // Written as the row has it: an email address keeps its lowercase.
   const last = crumbs.at(-1);
   if (recordLabel.value && last && crumbs.length > 1) {
     crumbs[crumbs.length - 1] = {
@@ -210,8 +201,6 @@ const breadcrumb = computed((): BreadcrumbItem[] => {
   return crumbs;
 });
 
-// The middle crumbs fold into a "…" menu (see the `#ellipsis` slot) so a
-// deep page still fits a phone without losing the way back up.
 const mobileBreadcrumb = computed(
   (): (BreadcrumbItem & { children?: DropdownMenuItem[] })[] =>
     foldBreadcrumb(breadcrumb.value, MOBILE_ELLIPSIS_SLOT).map((crumb) => {

package/frontend-vue/layers/dms-layout/app/build/components/layout/DashboardPageBody.vue

@@ -4,7 +4,7 @@ import PageHeader from "./PageHeader.vue";
 import PageHeaderActionsOutlet from "./PageHeaderActionsOutlet.vue";
 import PageSkeleton from "./PageSkeleton.vue";
 import type { LayoutHeaderAction } from "./PageHeaderActionBar.vue";
-import { providePageHeaderActions } from "../../../composables/layout/usePageHeaderActions";
+import { providePageHeaderActions } from "#dms-ui/app/composables/layout/usePageHeaderActions";
 
 interface Props {
   hideHeader?: boolean;
@@ -35,9 +35,6 @@ const props = withDefaults(defineProps<Props>(), {
   headerClass: "pb-6",
 });
 
-// The header renders before the page in the slot: its actions come through
-// an outlet that waits for the page's setup (see usePageHeaderActions), and
-// a marker after the slot says the page has rendered.
 const pageHeaderActions = providePageHeaderActions();
 const PageRendered = defineComponent({
   name: "DmsPageRendered",
@@ -47,11 +44,8 @@ const PageRendered = defineComponent({
   },
 });
 
-// After a client navigation the skeleton stands in for the page until its
-// chunk (and its setup) resolves, so the old page is never kept on screen.
 const isPageLoading = useDmsPageLoading();
-// A reloaded "preview as role" tab holds its page back (pre-paint script, see
-// the permission-preview-prepaint plugin) until the preview veils it.
+
 const PAGE_SKELETON_CLASS =
   "hidden [html[data-dms-role-preview=pending]_&]:block";
 const PAGE_SLOT_CLASS =

package/frontend-vue/layers/dms-layout/app/build/components/layout/DashboardSidePanel.vue

@@ -8,9 +8,9 @@
  * the panel's component.
  */
 import { useMediaQuery } from "@vueuse/core";
-import type { SidePanel } from "../../../composables/useAppSidePanels";
-import { useSidePanel } from "../../../composables/useSidePanel";
-import { sidePanelWidthStyle } from "../../composables/layout/sidePanelState";
+import type { SidePanel } from "#dms-ui/app/composables/useAppSidePanels";
+import { useSidePanel } from "#dms-ui/app/composables/useSidePanel";
+import { sidePanelWidthStyle } from "#dms-ui/app/entries/composables/layout/sidePanelState";
 import { useSidePanelWidth } from "../../composables/layout/useSidePanelWidth";
 
 interface Props {
@@ -19,8 +19,6 @@ interface Props {
 
 const props = defineProps<Props>();
 
-// The panel belongs to the dashboard: a page without its shell (onboarding,
-// an error page) hides it, and keeps it mounted for the way back.
 const HOST_CLASS =
   "contents [body:not(:has([data-dms-persistent-shell]))_&]:hidden";
 const DESKTOP_QUERY = "(min-width: 1024px)";
@@ -52,14 +50,13 @@ const panelComponent = computed(
   () => resolveDmsComponent(props.panel.component) ?? props.panel.component,
 );
 
-// Escape dismisses the sheet only: docked, the panel is part of the page and
-// its component may give the key a meaning of its own.
 function closeSheetOnEscape(event: KeyboardEvent): void {
   if (event.key !== ESCAPE_KEY || isDocked.value) return;
   close();
 }
 
 function startHandleDrag(event: PointerEvent): void {
+  // SAFETY: The template binds this listener directly to the resize handle div, so currentTarget is that HTMLElement during dispatch.
   (event.currentTarget as HTMLElement).setPointerCapture(event.pointerId);
   const renderedWidth = panelEl.value?.getBoundingClientRect().width;
   startDrag(event, renderedWidth || width.value);
@@ -71,8 +68,6 @@ function isFocusInside(): boolean {
   return panelEl.value?.contains(document.activeElement) ?? false;
 }
 
-// The sheet covers the page, so focus moves into it unless the panel's own
-// component already took it; closing gives focus back to where it came from.
 onMounted(() => {
   const active = document.activeElement;
   focusBeforeOpen = active instanceof HTMLElement ? active : null;

package/frontend-vue/layers/dms-layout/app/build/components/layout/DashboardSidebar.vue

@@ -3,7 +3,7 @@ import type { NavigationMenuItem } from "@nuxt/ui";
 import {
   convertSiteLayoutTreeToTreeItems,
   convertSiteLayoutTreeToTreeItemsForModule,
-} from "#dms-ui/app/build/types/tree";
+} from "#dms-ui/app/entries/types/tree";
 import {
   isSidebarWidgetVisible,
   resolveSidebarWidgetPosition,
@@ -15,7 +15,7 @@ import { useMediaQuery } from "@vueuse/core";
 import DmsSidebarUserMenu from "./SidebarUserMenu.vue";
 
 const MODULES_PATH = "/modules";
-// Registered id of the Modules entry, so "Preview as role" can lock it.
+
 const MODULES_FULL_ID = "modules";
 const MODULES_TREE_KEY = "modules";
 const MODULES_ICON = "i-ph-squares-four-light";
@@ -27,8 +27,7 @@ const SIDEBAR_MAX_WIDTH_PX = 320;
 const SIDEBAR_COLLAPSED_WIDTH_PX = 60;
 const SEARCH_SHORTCUT_KEYS = ["meta", "k"];
 const DESKTOP_QUERY = "(min-width: 1024px)";
-// On a short screen the menu overflows the body, which then scrolls: without
-// this the flex column squeezed the search field and widgets instead.
+
 const SIDEBAR_UI = { body: "*:shrink-0" };
 
 const { t } = useI18n();
@@ -37,11 +36,9 @@ const { processI18n } = useTranslation();
 const route = useDmsRoute();
 const { open: sidebarOpen, collapsed: sidebarCollapsed } = useSidebarState();
 const { formatShortcut } = useKeyboardPlatform();
-// The palette's own key (Nuxt UI binds `meta_k`: ⌘ on macOS, Ctrl elsewhere),
-// printed for the platform: "⌘K" or "Ctrl K".
+
 const searchShortcutHint = computed(() => formatShortcut(SEARCH_SHORTCUT_KEYS));
-// The collapsed rail shows only the icon: its tooltip (shown only while
-// collapsed, labelled with the button's label) adds the key.
+
 const searchTooltip = computed(() => ({ kbds: [searchShortcutHint.value] }));
 
 function closeMobileSidebar(event?: KeyboardEvent): void {
@@ -49,30 +46,24 @@ function closeMobileSidebar(event?: KeyboardEvent): void {
   sidebarOpen.value = false;
 }
 
-// The drawer only exists below `lg`: widening past it (a tablet turned to
-// landscape) closes it, so the desktop sidebar never stays pinned as one.
 const isDesktop = useMediaQuery(DESKTOP_QUERY);
 watch(isDesktop, (desktop) => {
   if (desktop) sidebarOpen.value = false;
 });
 
-// Going to a page closes the drawer, wherever the navigation came from (a
-// menu link, the user menu, the palette).
 watch(
   () => route.path,
   () => closeMobileSidebar(),
 );
 
-// A link to the page already shown changes no route: close on the click.
 function closeOnLinkClick(event: MouseEvent): void {
   if (!sidebarOpen.value) return;
+  // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- DOM target is typed EventTarget; keep the existing unchecked closest call, including throws for synthetic non-element targets, instead of adding a filtering guard.
   if ((event.target as Element | null)?.closest("a[href]")) {
     closeMobileSidebar();
   }
 }
 
-// The drawer always shows the full menu, even when the desktop sidebar was
-// collapsed to its rail.
 const isRail = (collapsed: boolean): boolean => collapsed && !sidebarOpen.value;
 
 onMounted(() => window.addEventListener("keydown", closeMobileSidebar));
@@ -92,9 +83,7 @@ const isOwner = useIsOwner();
 const currentModule = useCurrentModule();
 const isInModule = computed(() => currentModule.value !== null);
 const { widgets: sidebarWidgets } = useSidebarWidgets();
-// Scope and position are independent axes: a widget renders where its
-// `position` says, but only while its module — none for a global one — is the
-// one being browsed.
+
 const visibleSidebarWidgets = computed(() =>
   sidebarWidgets.value.filter((widget) =>
     isSidebarWidgetVisible(widget, currentModule.value?.id),
@@ -114,16 +103,11 @@ const widgetsBelowSearchBar = widgetsAtPosition(
 );
 const homepage = useHomepage();
 
-// Use the matched page/category's `fullId` to drive sidebar expansion.
-// URL-based matching would miss hidden pages (registered but not in the menu
-// tree) and custom-pages whose urlSlug escapes the parent category's URL.
 const currentFullId = computed(() => {
   const match = siteLayout.findMatchingRouteOrCategory(route.path);
   return match?.metadata.fullId ?? null;
 });
 
-// Query parameters are part of the highlight: several entries can share one page
-// and only differ by them (`/project?project=<id>`).
 const currentRoute = computed<MenuRouteState>(() => ({
   path: route.path,
   query: route.query,
@@ -162,7 +146,6 @@ const favoriteItems = computed((): NavigationMenuItem[][] => {
         defaultOpen: true,
         children: favoritePages.sortedFavorites.value.map(
           (favorite): DmsMenuItem => ({
-            // The page's registered id, for the preview's locks.
             fullId: siteLayout.findMatchingRoute(
               stripQueryAndHash(favorite.path),
             )?.metadata.fullId,
@@ -185,13 +168,9 @@ const items = computed((): NavigationMenuItem[][] => {
       moduleRootNode.value,
     );
     const translatedItems = translateMenuItems(moduleMenuItems, processI18n);
-    const openItems = addDefaultOpenToMenuItems(
+    return applyMenuRouteState(
       translatedItems,
       currentFullId.value,
-    );
-    return addActiveStateToMenuItems(
-      openItems,
-      currentFullId.value,
       currentRoute.value,
     );
   }
@@ -204,13 +183,9 @@ const items = computed((): NavigationMenuItem[][] => {
     siteLayout.siteLayoutTree.value,
   );
   const translatedItems = translateMenuItems(menuItems, processI18n);
-  const openItems = addDefaultOpenToMenuItems(
+  return applyMenuRouteState(
     translatedItems,
     currentFullId.value,
-  );
-  return addActiveStateToMenuItems(
-    openItems,
-    currentFullId.value,
     currentRoute.value,
   );
 });
@@ -220,7 +195,7 @@ const openCategories = ref<string[]>([]);
 watch(
   () => items.value,
   (menuItems) => {
-    const requiredIds = getExpandedItemIds(menuItems, currentFullId.value);
+    const requiredIds = collectOpenItemIds(menuItems);
     const current = new Set(openCategories.value);
     for (const id of requiredIds) {
       current.add(id);
@@ -251,27 +226,23 @@ const footerItems = computed((): NavigationMenuItem[] => {
     });
   }
 
-  // The settings are reached from the account menu, not from here. Back and
-  // Modules only highlight their destinations, regardless of the router's
-  // default prefix matching.
   if (isOwner.value) {
-    result.push({
+    const moduleItem: NavigationMenuItem = {
       fullId: MODULES_FULL_ID,
       label: t("menu.modules"),
       to: MODULES_PATH,
       icon: MODULES_ICON,
       exact: true,
-      ...(moduleCount.value > 0
-        ? {
-            badge: {
-              label: String(moduleCount.value),
-              color: "neutral",
-              variant: "subtle",
-              size: "sm",
-            },
-          }
-        : {}),
-    });
+    };
+    if (moduleCount.value > 0) {
+      moduleItem.badge = {
+        label: String(moduleCount.value),
+        color: "neutral",
+        variant: "subtle",
+        size: "sm",
+      };
+    }
+    result.push(moduleItem);
   }
 
   return result;

package/frontend-vue/layers/dms-layout/app/build/components/layout/Footer.vue

@@ -29,16 +29,12 @@ function isExternal(to: string): boolean {
   return EXTERNAL_LINK_PATTERN.test(to);
 }
 
-// A signed-in user on a page of this layout (the account switcher) switches
-// their profile's language too: the session applies that one on every load,
-// and the server writes in it, so switching the screen alone would leave the
-// two apart. A visitor's choice lives in the locale cookie.
-async function onLocaleChange(code: unknown) {
+async function onLocaleChange(code: Parameters<typeof changeLanguage>[0]) {
   if (isLoggedIn.value) {
-    await changeLanguage(code as string);
+    await changeLanguage(code);
     return;
   }
-  await setLocale(code as typeof locale.value);
+  await setLocale(code);
 }
 </script>
 

package/frontend-vue/layers/dms-layout/app/build/components/layout/GithubStarPrompt.vue

@@ -1,9 +1,9 @@
 <script setup lang="ts">
 import { computed } from "vue";
-import { useOpenDialog } from "#dms-ui/app/build/composables/containers/closingLayers";
-import { isFloatingSaveBarShown } from "#dms-ui/app/build/composables/form/floatingSaveBars";
+import { useOpenDialog } from "#dms-ui/app/entries/composables/containers/closingLayers";
+import { isFloatingSaveBarShown } from "#dms-ui/app/entries/composables/form/floatingSaveBars";
 import { useGithubStarPrompt } from "../../composables/general/useGithubStarPrompt";
-import { useActiveSidePanel } from "../../composables/layout/sidePanelState";
+import { useActiveSidePanel } from "#dms-ui/app/entries/composables/layout/sidePanelState";
 import { useSidebarState } from "./sidebarState";
 
 const TITLE_ID = "dms-github-star-prompt-title";
@@ -16,18 +16,10 @@ const { open: isSidebarOpen } = useSidebarState();
 const { panel: sidePanel } = useActiveSidePanel();
 const isDialogOpen = useOpenDialog();
 
-// Developers only: a production build, a client's dashboard included, never
-// counts, stores or shows anything. The same flag gates the dev reload.
 const { isDue, snooze, star, dismiss } = useGithubStarPrompt(
   import.meta.env.DEV,
 );
 
-// The toaster stacks in the same corner, a floating save bar sticks to the
-// bottom of the panel, and the phone sidebar keeps its account menu trigger
-// at the bottom of the screen: the prompt steps aside while any is up rather
-// than cover it. The sidebar only opens as a drawer, below `lg`. It waits
-// as well while a drawer, a modal or a side panel is open, whose footer or
-// content it would float over, and comes back once they close.
 const isShown = computed(
   () =>
     isDue.value &&

package/frontend-vue/layers/dms-layout/app/build/components/layout/PageHeader.vue

@@ -4,16 +4,13 @@ import type { ClassNameValue } from "tailwind-merge";
 
 const theme = tv({
   slots: {
-    // Wraps so the actions drop under the title once both no longer fit (the
-    // layout puts them on their own full-width row below `md`).
     root: "flex flex-wrap gap-x-3.5 gap-y-4 items-start",
     badge:
       "mt-px rounded-[9px] bg-primary/10 shrink-0 ring ring-inset ring-primary/35 flex items-center justify-center size-9",
     icon: "text-primary",
 
-    // From `md` the title keeps at least 16rem before the actions wrap.
     content: "flex-1 min-w-0 md:flex-[1_1_16rem]",
-    // v2 .page-header__title: 24px, weight 650, line-height 1.2, -0.03em.
+
     title:
       "text-highlighted text-2xl font-[650] leading-[1.2] tracking-[-0.03em]",
     description: "text-muted text-sm mt-1 max-w-[68ch]",

package/frontend-vue/layers/dms-layout/app/build/components/layout/PageHeaderActionBar.vue

@@ -10,20 +10,21 @@ import {
 } from "#dms-ui/app/types/quick-actions";
 import type { CustomButton } from "#dms-ui/app/composables/table-view/types/custom-button";
 import type { ActionTarget } from "#dms-ui/app/composables/table-view/types/action-target";
-import { usePermissionPreview } from "#dms-core/app/build/composables/auth/usePermissionPreview";
-import { PREVIEW_LOCK_ICON } from "#dms-ui/app/build/utils/permissionPreview";
-import { runMountedQuickAction } from "#dms-ui/app/build/utils/quickActionTargets";
-import { useActionTargets } from "#dms-ui/app/build/composables/actions/useActionTargets";
+import { usePermissionPreview } from "#dms-core/app/entries/composables/auth/usePermissionPreview";
+import { PREVIEW_LOCK_ICON } from "#dms-ui/app/entries/utils/permissionPreview";
+import { runMountedQuickAction } from "#dms-ui/app/entries/utils/quickActionTargets";
+import { useActionTargets } from "#dms-ui/app/entries/composables/actions/useActionTargets";
 import { refreshPageBlocks } from "#dms-ui/app/utils/blockRefresh";
 import {
   hasUrlVariables,
   resolveLinkVariables,
-} from "#dms-ui/app/build/utils/urlVariables";
+} from "#dms-ui/app/entries/utils/urlVariables";
 import {
   dispatchQuickActionTarget,
   findServedQuickAction,
-} from "#dms-ui/app/build/utils/dispatchQuickActionTarget";
-import { DEFAULT_PAGE_HEADER_ACTIONS_ORDER } from "../../../composables/layout/usePageHeaderActions";
+} from "#dms-ui/app/entries/utils/dispatchQuickActionTarget";
+import { DEFAULT_PAGE_HEADER_ACTIONS_ORDER } from "#dms-ui/app/composables/layout/usePageHeaderActions";
+import { isString } from "#dms-core/app/utils/type-check";
 
 /**
  * A button of the page header as the server serves it (`DefaultLayout({
@@ -75,10 +76,6 @@ const route = useDmsRoute();
 const router = useDmsRouter();
 const { $authFetch } = useAuthFetch();
 
-// The page header runs a declared button's target as a table runs its
-// toolbar buttons: confirmation, drawer, modal, API call, export, link. A
-// button that changed something (an API call, a form it opened) changes the
-// record the page shows: its blocks read their data again.
 const { handleCustomButton } = useActionTargets({
   api: $authFetch,
   componentId: "page-header",
@@ -87,28 +84,20 @@ const { handleCustomButton } = useActionTargets({
   handleApiError: (error, title) => useApiError(error, { title }),
 });
 
-// Pressed in place by the component of this page, so what it opens shows on
-// the click. Only a component not mounted (yet) gets it the way a quick
-// action does: through query keys its watcher reads, at the cost of two
-// server visits.
 function pressComponentButton(componentId: string, buttonId?: string) {
   const intent: QuickActionIntent = buttonId
     ? { kind: "button", button: buttonId }
     : { kind: "add" };
   if (runMountedQuickAction(route.path, componentId, intent)) return;
-  void router.replace({
-    query: {
-      ...route.query,
-      [QUICK_ACTION_QUERY_KEY]: buttonId
-        ? QUICK_ACTION_BUTTON
-        : QUICK_ACTION_ADD,
-      [QUICK_ACTION_COMPONENT_KEY]: componentId,
-      ...(buttonId ? { [QUICK_ACTION_BUTTON_KEY]: buttonId } : {}),
-    },
-  });
+  const query: typeof route.query = {
+    ...route.query,
+    [QUICK_ACTION_QUERY_KEY]: buttonId ? QUICK_ACTION_BUTTON : QUICK_ACTION_ADD,
+    [QUICK_ACTION_COMPONENT_KEY]: componentId,
+  };
+  if (buttonId) query[QUICK_ACTION_BUTTON_KEY] = buttonId;
+  void router.replace({ query });
 }
 
-// A neutral action reads as the v2 outline button, any colored one is solid.
 const defaultVariant = (
   color: ButtonProps["color"] | undefined,
 ): ButtonProps["variant"] =>
@@ -117,9 +106,7 @@ const defaultVariant = (
 const orderOf = (action: LayoutHeaderAction): number =>
   action.order ?? DEFAULT_PAGE_HEADER_ACTIONS_ORDER;
 
-// A served label's translation reads the page query as its parameters:
-// `"Download {locale}.json"` names the language of `?locale=`.
-function labelParams(): Record<string, unknown> {
+function labelParams() {
   const { routeParams, routeQuery } = pageUrlValues.value;
   return { ...routeParams, ...routeQuery };
 }
@@ -139,14 +126,12 @@ type LinkTarget = Extract<ActionTarget, { type: "page" | "external" }>;
 type UrlTarget = Extract<ActionTarget, { url: string }>;
 
 const hasTargetUrl = (target: ActionTarget): target is UrlTarget =>
-  typeof (target as Partial<UrlTarget>).url === "string";
+  // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- ActionTarget variants without url are still probed for it at runtime, including malformed variants. A discriminant-only guard would change that behavior.
+  isString((target as Partial<UrlTarget>).url);
 
-// The values of the page a target's URL may name: a button declared once on
-// the page leads to the record the page shows (`{{params.id}}`) or keeps its
-// scope (`?workspace={{query.workspace}}`), following the URL as it changes.
 const pageUrlValues = computed(() => ({
   routeParams: siteLayout.findMatchingRoute(route.path)?.params,
-  routeQuery: route.query as Record<string, unknown>,
+  routeQuery: route.query,
 }));
 
 function withPageValues(action: LayoutHeaderAction): LayoutHeaderAction {
@@ -163,8 +148,6 @@ function withPageValues(action: LayoutHeaderAction): LayoutHeaderAction {
   };
 }
 
-// A link target (without a confirmation) renders as a link: middle click and
-// "open in a new tab" keep working.
 const LINK_TARGETS: Partial<
   Record<ActionTarget["type"], (target: LinkTarget) => ButtonProps>
 > = {
@@ -182,6 +165,7 @@ const LINK_TARGETS: Partial<
 function linkProps(action: LayoutHeaderAction): ButtonProps | undefined {
   const { target } = action;
   if (action.confirm || !target) return undefined;
+  // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- The dispatch table correlates its page/external keys with LinkTarget, which indexed access cannot infer. A discriminant rewrite would alter the existing prototype-key lookup for malformed types.
   return LINK_TARGETS[target.type]?.(target as LinkTarget);
 }
 
@@ -190,7 +174,6 @@ function resolveQuickActionButton(
   base: ButtonProps,
   key: string,
 ): ResolvedHeaderAction | null {
-  // Quick actions are served per user: one missing here is not for them.
   const quickAction = findServedQuickAction(quickActions.value?.actions, key);
   if (!quickAction) return null;
   return {
@@ -202,7 +185,8 @@ function resolveQuickActionButton(
       label: base.label || processI18n(quickAction.displayName),
       onClick: () =>
         action.confirm
-          ? handleCustomButton(action as CustomButton)
+          ? // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- LayoutHeaderAction permits missing label and wider color/variant values than CustomButton. The existing action executor receives the original object; synthesizing a valid CustomButton would change malformed input behavior.
+            handleCustomButton(action as CustomButton)
           : dispatchQuickActionTarget(quickAction.target),
     },
   };
@@ -239,6 +223,7 @@ function resolveAction(
     button: {
       ...base,
       ...(linkProps(action) ?? {
+        // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- The layout action's optional label and ButtonProps styling do not satisfy CustomButton. This unchecked existing handoff preserves the original object instead of inventing defaults or narrowing the public prop.
         onClick: () => handleCustomButton(action as CustomButton),
       }),
     },
@@ -246,9 +231,6 @@ function resolveAction(
   };
 }
 
-// "Preview as role": a button the role would not be shown stays, hatched and
-// locked (the same look as the sidebar's locked entries). Outside a preview
-// nothing is locked: the server and the rules above already left it out.
 const preview = usePermissionPreview();
 const { t } = useI18n();
 const PREVIEW_LOCK_CLASS = "text-muted dms-hatch-locked";
@@ -279,9 +261,6 @@ const resolved = computed(() =>
     .sort((first, second) => first.order - second.order),
 );
 
-// The slot (the page's own actions) goes after every served button of an
-// order up to its own: at an equal order the served ones lead, as they did
-// before `order` existed.
 const SLOT_KEY = "dms-page-header-slot";
 
 interface HeaderBarEntry {