@antelopejs/dms 0.11.1 → 0.12.1

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,15 +50,15 @@ 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 {
-  (event.currentTarget as HTMLElement).setPointerCapture(event.pointerId);
+  const handle = event.currentTarget;
+  if (!(handle instanceof HTMLElement)) return;
+  handle.setPointerCapture(event.pointerId);
   const renderedWidth = panelEl.value?.getBoundingClientRect().width;
   startDrag(event, renderedWidth || width.value);
 }
@@ -71,8 +69,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,
@@ -243,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

@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import type { SelectItem } from "@nuxt/ui";
+import { GITHUB_REPOSITORY_URL } from "../../utils/github-repository";
 
 const EXTERNAL_LINK_PATTERN = /^https?:\/\//;
 const DEFAULT_COPYRIGHT = "Antelope";
@@ -29,16 +30,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>
 
@@ -69,6 +66,19 @@ async function onLocaleChange(code: unknown) {
       </DmsLink>
     </template>
 
+    <a
+      :href="GITHUB_REPOSITORY_URL"
+      target="_blank"
+      rel="noopener noreferrer"
+      :aria-label="t('empty_layout.footer.github_star_label')"
+      :title="t('empty_layout.footer.github_star_label')"
+      class="border-default text-muted hover:text-highlighted hover:border-accented hover:bg-elevated inline-flex h-6 items-center gap-1.5 rounded-md border px-2 font-medium transition-colors max-sm:h-8"
+    >
+      <UIcon name="i-ph-github-logo" class="size-3.5" aria-hidden="true" />
+      <UIcon name="i-ph-star" class="size-3" aria-hidden="true" />
+      {{ t("empty_layout.footer.github_star") }}
+    </a>
+
     <USelect
       v-if="showsLocaleSwitcher"
       :model-value="locale"

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 {

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

@@ -3,7 +3,7 @@ import { onServerPrefetch } from "vue";
 import PageHeaderActionBar, {
   type LayoutHeaderAction,
 } from "./PageHeaderActionBar.vue";
-import { injectPageHeaderActionsHost } from "../../../composables/layout/usePageHeaderActions";
+import { injectPageHeaderActionsHost } from "#dms-ui/app/composables/layout/usePageHeaderActions";
 import { useServedHeaderActions } from "../../../composables/layout/useServedHeaderActions";
 
 interface PageHeaderActionsOutletProps {
@@ -27,15 +27,12 @@ const actions = useServedHeaderActions({
 });
 
 const ROOT_SELECTOR = "[data-dms-page-header-actions]";
-// The actions take their own full-width row below `md`, the end of the
-// header row from there on.
+
 const ROOT_CLASS =
   "flex w-full flex-wrap items-center gap-2 md:ms-auto md:w-auto";
 
 const host = injectPageHeaderActionsHost();
 
-// The server render waits here for the page's actions (the rest of the page
-// keeps rendering meanwhile), so the header's markup carries them.
 onServerPrefetch(() => host?.whenReady());
 
 const pageActions = computed(() => host?.actions.value ?? null);
@@ -43,11 +40,12 @@ const hasActions = computed(
   () => actions.value.length > 0 || !!pageActions.value,
 );
 
-// Hydrating before the page has set up: its actions are not known yet, but
-// the server rendered them. The outlet keeps that markup untouched (same
-// HTML, so nothing moves and hydration matches) until the page is ready,
-// then renders the live actions in its place. The markup is the element's
-// own, rendered by the server and read back from the page.
+/**
+ * This outlet's own server-rendered DOM HTML, read back during hydration
+ * before the page has registered its actions. Reused by `v-html` only until
+ * the host is ready so hydration matches without moving the buttons. This
+ * is not an input for arbitrary HTML supplied by a caller.
+ */
 const serverMarkup =
   !import.meta.env.SSR && host && !host.isReady.value
     ? (document.querySelector(ROOT_SELECTOR)?.innerHTML ?? null)

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

@@ -1,8 +1,4 @@
 <script setup lang="ts">
-// Neutral stand-in for a page whose chunk is still loading after a client
-// navigation: one content card, so the switch to the page's own skeletons
-// changes little. It only fades in once the wait passes the delay set by
-// `.dms-page-skeleton` (main.css): a fast navigation shows nothing at all.
 interface PageSkeletonProps {
   /** Draws the page title too (when the layout shows no page header). */
   withTitle?: boolean;

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

@@ -1,20 +1,17 @@
 <script setup lang="ts">
 import type { DropdownMenuItem } from "@nuxt/ui";
-import { usePermissionPreview } from "#dms-core/app/build/composables/auth/usePermissionPreview";
-import { EYEBROW_CLASS } from "#dms-ui/app/build/utils/eyebrow";
-import { PREVIEW_LOCK_ICON } from "#dms-ui/app/build/utils/permissionPreview";
-import { quickActionKey } from "#dms-core/app/build/utils/permission-preview";
+import { usePermissionPreview } from "#dms-core/app/entries/composables/auth/usePermissionPreview";
+import { EYEBROW_CLASS } from "#dms-ui/app/entries/utils/eyebrow";
+import { PREVIEW_LOCK_ICON } from "#dms-ui/app/entries/utils/permissionPreview";
+import { quickActionKey } from "#dms-core/app/entries/utils/permission-preview";
 
 const { t } = useI18n();
 const { processI18n } = useTranslation();
 const { categoryGroups } = useQuickActions();
 
-// v2 quick actions menu: a plain title over mono-eyebrow category groups.
 const TITLE_GROUP_CLASS =
   "font-sans text-[13px] font-semibold text-highlighted normal-case tracking-normal px-2.5 pt-1.5 pb-2";
 
-// "Preview as role": an action the role would not be served stays listed,
-// hatched and locked. Never outside a preview.
 const preview = usePermissionPreview();
 const PREVIEW_LOCK_CLASS = "text-muted dms-hatch-locked";
 

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

@@ -1,10 +1,7 @@
 <script setup lang="ts">
-import { usePermissionPreview } from "#dms-core/app/build/composables/auth/usePermissionPreview";
-import { listPreviewablePages } from "#dms-core/app/build/utils/permission-preview";
+import { usePermissionPreview } from "#dms-core/app/entries/composables/auth/usePermissionPreview";
+import { listPreviewablePages } from "#dms-core/app/entries/utils/permission-preview";
 
-// v2 .cs-asbar: "Previewing <page> as <role> · unsaved changes included ·
-// Exit preview", pinned under the dashboard header while a tab previews a
-// role. The page name doubles as a picker to look at another page.
 const preview = usePermissionPreview();
 const siteLayout = useSiteLayout();
 const route = useDmsRoute();
@@ -41,7 +38,7 @@ const roleName = computed(
     preview.session.value?.roleName || t("page.settings.roles.editor.untitled"),
 );
 const pageHidden = computed(() => preview.result.value?.page?.hidden === true);
-// The page opens for the role, without some of its blocks or actions.
+
 const pagePartial = computed(
   () => preview.entryState(preview.result.value?.page?.fullId) === "partial",
 );

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

@@ -7,7 +7,7 @@
  * Keyed by panel id, so each panel keeps its own focus bookkeeping.
  */
 import DashboardSidePanel from "./DashboardSidePanel.vue";
-import { useActiveSidePanel } from "../../composables/layout/sidePanelState";
+import { useActiveSidePanel } from "#dms-ui/app/entries/composables/layout/sidePanelState";
 
 const { panel } = useActiveSidePanel();
 </script>

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

@@ -36,8 +36,6 @@ const { uniqueLocales } = useUniqueLocales();
 const { changeLanguage } = useUserLanguage();
 const { open: sidebarOpen } = useSidebarState();
 
-// The picture the profile saved, read from the session user: a profile save
-// refreshes that user, so a new picture shows here at once.
 const avatarUrls = useFileReadUrls();
 const avatarKey = computed(() => user.value?.avatar?.key);
 const avatarSrc = computed(() =>
@@ -47,16 +45,12 @@ watch(avatarKey, (key) => key && void avatarUrls.resolve(key), {
   immediate: true,
 });
 
-// The settings have no sidebar entry: their only way in is this menu, so its
-// trigger is drawn active while a settings page is open.
 const isOnSettings = computed(
   () =>
     route.path === SETTINGS_ROUTE ||
     route.path.startsWith(`${SETTINGS_ROUTE}/`),
 );
 
-// v2 user menu: account links, then the per-user preferences as submenus,
-// then logging out.
 const preferenceItems = computed<DropdownMenuItem[]>(() => [
   {
     label: t("page.settings.appearance.theme_title"),
@@ -89,8 +83,7 @@ const menuItems = computed<DropdownMenuItem[][]>(() => [
     label: t(entry.labelKey),
     icon: entry.icon,
     to: entry.to,
-    // The menu renders in a portal, outside the sidebar whose link clicks
-    // close the phone drawer: its own entries close it themselves.
+
     onSelect: () => {
       sidebarOpen.value = false;
     },

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

@@ -1,10 +1,6 @@
 <script setup lang="ts">
 import type { AvatarProps } from "@nuxt/ui";
 
-// The signed-in user as the shell shows them: their picture (initials
-// without one), name, then the e-mail in mono (the sidebar menu's trigger and
-// its header).
-
 interface UserIdentityProps {
   name?: string;
   email?: string;