@antelopejs/dms 0.11.0 → 0.12.0

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;

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

@@ -1,18 +1,18 @@
 <script setup lang="ts">
 import { formatRelativeTime } from "#dms-core/app/utils/formatter";
 import NotificationCard from "./NotificationCard.vue";
-import { useNavBadges } from "#dms-ui/app/build/composables/navigation/useNavBadges";
+import { useNavBadges } from "#dms-ui/app/entries/composables/navigation/useNavBadges";
 import { settleWidgetRequest } from "./widgetRequest";
 import {
   settledRenderedBellCounts,
   type UserNotification,
 } from "../../../composables/notification/useNotifications";
 import { resolveNotificationTone } from "../pages/settings/notification/notificationDisplay";
-import { DMS_TONE_SOLID, iconWellToneOf } from "#dms-ui/app/build/utils/tone";
-import DmsRowSkeleton from "#dms-ui/app/build/components/skeleton/RowSkeleton.vue";
+import { DMS_TONE_SOLID, iconWellToneOf } from "#dms-ui/app/entries/utils/tone";
+import DmsRowSkeleton from "#dms-ui/app/entries/components/skeleton/RowSkeleton";
 
 const MAX_DISPLAYED_COUNT = 99;
-// Placeholder rows while the list loads: enough to fill the list's height.
+
 const POPOVER_SKELETON_LINES = [
   "mt-[3px] mb-[5px] h-2.5 w-2/5",
   "my-1 h-2 w-11/12",
@@ -38,8 +38,7 @@ const {
 const { setNavBadge } = useNavBadges();
 const isOpen = ref(false);
 const sentinel = ref<HTMLElement | null>(null);
-// Each opening reloads the list from its first page: until it answers, the
-// popover shows placeholder rows, never "No notifications".
+
 const isListLoading = ref(false);
 
 const { isLoadingMore, setupObserver, disconnectObserver } = useInfiniteScroll(
@@ -48,24 +47,17 @@ const { isLoadingMore, setupObserver, disconnectObserver } = useInfiniteScroll(
   hasMore,
 );
 
-// The sender's tone (a warning, a success) colours the icon well, as in the
-// inbox; untoned notifications keep the accent until read.
 const iconWellTone = (notification: UserNotification) =>
   iconWellToneOf(resolveNotificationTone(notification));
 
 const formatCount = (count: number) =>
   count > MAX_DISPLAYED_COUNT ? `${MAX_DISPLAYED_COUNT}+` : String(count);
 
-// The bell's badge counts what is unread, in the tone of the most important
-// unread notification; opening the bell changes neither.
 const displayedCount = computed(() => formatCount(unreadCount.value));
 const badgeToneClass = computed(
   () => DMS_TONE_SOLID[unreadTone.value ?? "neutral"],
 );
 
-// The bell is on every page, so it keeps the badge of the Notifications
-// entry in the navigation current between two menu loads: the same count,
-// in the same tone.
 watch([unreadCount, unreadTone], ([count, tone]) => {
   setNavBadge(
     NOTIFICATIONS_SETTINGS_PAGE,
@@ -81,6 +73,7 @@ const refreshCounts = () =>
   });
 
 const handleFormSubmitSuccess = async (event: Event) => {
+  // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- DOM callbacks infer Event while the form publisher emits CustomEvent. The current handler intentionally projects detail without validating it; a narrower input or runtime guard would change the event boundary.
   const customEvent = event as CustomEvent;
   const submitUrl = customEvent.detail?.data?.submitUrl;
 
@@ -93,14 +86,11 @@ const handleFormSubmitSuccess = async (event: Event) => {
 
 onMounted(async () => {
   if (!loggedIn.value) return;
-  // Read with the page (`useRenderedBellCounts`) unless that read failed.
+
   if (!areCountsLoaded.value) await settledRenderedBellCounts();
   if (!areCountsLoaded.value) await refreshCounts();
 
-  window.addEventListener(
-    FormEvents.SUBMIT_SUCCESS,
-    handleFormSubmitSuccess as EventListener,
-  );
+  window.addEventListener(FormEvents.SUBMIT_SUCCESS, handleFormSubmitSuccess);
 });
 
 onUnmounted(() => {
@@ -108,7 +98,7 @@ onUnmounted(() => {
 
   window.removeEventListener(
     FormEvents.SUBMIT_SUCCESS,
-    handleFormSubmitSuccess as EventListener,
+    handleFormSubmitSuccess,
   );
 });
 

package/frontend-vue/layers/dms-layout/app/build/components/notification/widgetRequest.ts

@@ -7,8 +7,8 @@ const WIDGET_REQUEST_FAILED_MESSAGE = "[dms] Header widget request failed";
  * reaching the app error handler, which would replace the whole page with an
  * error screen.
  */
-export async function settleWidgetRequest(
-  request: () => Promise<unknown>,
+export async function settleWidgetRequest<T>(
+  request: () => Promise<T>,
   onFailure?: () => void,
 ): Promise<void> {
   try {

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleCatalogTile.vue

@@ -11,8 +11,8 @@ import type {
 import type {
   ModuleCatalogEntry,
   ModuleReadoutTone,
-} from "../../../../types/page";
-import type { StoreOperationKind } from "../../../../types/module-store";
+} from "#dms-core/app/types/page";
+import type { StoreOperationKind } from "#dms-core/app/types/module-store";
 import { moduleCategory } from "../../../utils/modules-catalog";
 import {
   type ModuleStoreEntry,
@@ -22,10 +22,6 @@ import {
   storeBlockMessage,
 } from "../../../utils/module-store-catalog";
 
-// An installed module: its state, a live readout, and the one place it is
-// managed. Its button opens it on its landing page, or resumes it while it
-// is paused; the store actions it offers are in its Manage menu.
-
 interface ModuleCatalogTileProps {
   entry: ModuleCatalogEntry;
   /** Where Open leads: the module's landing page, when it has pages. */
@@ -50,15 +46,9 @@ const { t } = useI18n();
 const { processI18n } = useTranslation();
 
 const TOOLTIP_CONTENT = { side: "top", sideOffset: 6 } as const;
-// Takes what the actions leave rather than wrapping them under it: the band
-// stays one line, and only the category is cut when even that is too short.
-// The facts never shrink below the version and the source (the category's
-// zero width keeps its text out of that floor): a tile too narrow for those
-// and the actions drops the actions to a second line rather than run the
-// source under them.
+
 const FOOTER_FACTS_CLASS = "flex grow basis-0 items-center gap-2";
 
-// v2 .module-tile__viz: each readout line opens with a tone glyph.
 const READOUT_STATES: Record<ModuleReadoutTone, CheckListState> = {
   success: "ok",
   info: "info",

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleManageMenu.vue

@@ -4,11 +4,7 @@ import {
   type StoreAction,
   storeBlockMessage,
 } from "../../../utils/module-store-catalog";
-import type { StoreOperationKind } from "../../../../types/module-store";
-
-// The Manage menu of an installed module: the store actions its tile does
-// not show as its button. One that cannot run stays listed, disabled, with
-// why under it.
+import type { StoreOperationKind } from "#dms-core/app/types/module-store";
 
 interface ModuleManageMenuProps {
   entry: ModuleStoreEntry;

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleSourceLabel.vue

@@ -1,10 +1,7 @@
 <script setup lang="ts">
-import type { ModuleSourceKind } from "../../../../types/module-store";
+import type { ModuleSourceKind } from "#dms-core/app/types/module-store";
 import { MODULE_SOURCE_ICONS } from "../../../utils/module-store-catalog";
 
-// Where a module's code comes from, as a tile's footer names it: an icon
-// and a short name (npm, GitHub, GitLab, Git, Local).
-
 interface ModuleSourceLabelProps {
   source: ModuleSourceKind;
 }

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleStoreBanners.vue

@@ -1,13 +1,9 @@
 <script setup lang="ts">
-import { MONO_CHIP_CLASS } from "#dms-ui/app/build/utils/monoChip";
+import { MONO_CHIP_CLASS } from "#dms-ui/app/entries/utils/monoChip";
 import { FRONTEND_BUILD_COMMAND } from "../../../utils/module-store-catalog";
-import type { StoreListing } from "../../../../types/module-store";
+import type { StoreListing } from "#dms-core/app/types/module-store";
 import type { StoreFrontendNotice } from "../../../../composables/page/useModuleStoreActions";
 
-// What keeps the store from changing modules here, and what follows a
-// change while the interface lags behind the backend: shown above the
-// installed modules and the store alike.
-
 interface ModuleStoreBannersProps {
   listing: StoreListing | undefined;
   frontendNotice: StoreFrontendNotice | null;

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleStoreDependencyPicker.vue

@@ -1,6 +1,7 @@
 <script setup lang="ts">
-import { MONO_CHIP_CLASS } from "#dms-ui/app/build/utils/monoChip";
-import type { MissingInterface } from "../../../../types/module-store";
+import type { InputEmits, RadioGroupEmits, TextareaEmits } from "@nuxt/ui";
+import { MONO_CHIP_CLASS } from "#dms-ui/app/entries/utils/monoChip";
+import type { MissingInterface } from "#dms-core/app/types/module-store";
 import {
   type DependencyDraft,
   type DependencyDraftError,
@@ -62,7 +63,10 @@ function errorText(error: DependencyDraftError | undefined) {
 function updateField(
   index: number,
   field: keyof DependencyDraft,
-  value: unknown,
+  value:
+    | InputEmits["update:modelValue"][0]
+    | TextareaEmits["update:modelValue"][0]
+    | RadioGroupEmits["update:modelValue"][0],
 ): void {
   emit("update", index, { [field]: String(value ?? "") });
 }

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleStoreOperation.vue

@@ -3,11 +3,7 @@ import type { ModuleStoreEntry } from "../../../utils/module-store-catalog";
 import type {
   StoreOperationKind,
   StoreOperationStep,
-} from "../../../../types/module-store";
-
-// What the store is doing to a module, on whichever tile shows it: the steps
-// of the running operation, the current one spinning, or the error the last
-// one left.
+} from "#dms-core/app/types/module-store";
 
 interface ModuleStoreOperationProps {
   entry: ModuleStoreEntry;
@@ -37,7 +33,7 @@ const KIND_STEPS: Record<StoreOperationKind, StoreOperationStep[]> = {
   apply: ["load"],
 };
 
-const STEP_ICONS: Record<string, string> = {
+const STEP_ICONS = {
   done: "i-ph-check-circle-fill",
   running: "i-ph-circle-notch",
   todo: "i-ph-circle",
@@ -75,7 +71,7 @@ const steps = computed(() => {
   );
   return kindSteps.map((step) => {
     const index = PROGRESS_STEPS.indexOf(step);
-    const state =
+    const state: keyof typeof STEP_ICONS =
       index < current ? "done" : index === current ? "running" : "todo";
     return { step, state };
   });

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleStoreRequirements.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import DmsCopyButton from "#dms-ui/app/components/copy/CopyButton.vue";
-import type { StoreListingEntry } from "../../../../types/module-store";
+import type { StoreListingEntry } from "#dms-core/app/types/module-store";
 
 interface ModuleStoreRequirementsProps {
   /** The store module whose requirements the tile spells out. */
@@ -18,7 +18,7 @@ const missingInterfaces = computed(() =>
     .map((missing) => missing.interfacePackage)
     .join(LIST_SEPARATOR),
 );
-// A working copy offers no action, so who uses it changes nothing there.
+
 const dependents = computed(() =>
   props.entry.isWorkingCopy ? "" : props.entry.dependents.join(LIST_SEPARATOR),
 );

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleStoreTile.vue

@@ -10,12 +10,7 @@ import {
   storeActions,
   storeBlockMessage,
 } from "../../../utils/module-store-catalog";
-import type { StoreOperationKind } from "../../../../types/module-store";
-
-// A module of the catalog, as the store presents it: what it is, whether it
-// is installed here, and Install when it is not. Everything else about an
-// installed module is managed from its tile among the installed modules,
-// which this one links to.
+import type { StoreOperationKind } from "#dms-core/app/types/module-store";
 
 interface ModuleStoreTileProps {
   /** The store module the tile presents. */

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleTile.vue

@@ -1,14 +1,10 @@
 <script setup lang="ts">
 import { tv } from "tailwind-variants";
+import type { Slot } from "vue";
 import { DmsLink } from "#dms/frontend-module";
-import type { Tone } from "#dms-ui/app/types/tone";
+import type { Tone } from "#dms-core/app/types/tone";
 import type { StatusPillDot } from "#dms-ui/app/components/status-pill/StatusPill.vue";
 
-// v2 .mc-tile, the frame of the Modules page's tiles: an installed module's
-// card (a link into it) or a store module's dashed placeholder. Both read
-// the same: icon and status, name and description, optional content, and a
-// bottom-aligned mono footer band.
-
 /** The status pill of the tile's head. */
 export interface ModuleTileStatus {
   tone: Tone;
@@ -33,15 +29,15 @@ interface ModuleTileProps {
 
 interface ModuleTileSlots {
   /** Under the description (a live readout). */
-  readout?: () => unknown;
+  readout?: Slot;
   /** Under the description (an install command). */
-  default?: () => unknown;
+  default?: Slot;
   /**
    * The footer band's content. The band wraps: a facts group (version,
    * source, category) kept whole, then actions pushed to the end with
    * `ms-auto`, which drop to a second line when both do not fit.
    */
-  footer: () => unknown;
+  footer: Slot;
 }
 
 const props = withDefaults(defineProps<ModuleTileProps>(), {
@@ -63,8 +59,7 @@ const theme = tv({
         root: "group dms-card dms-card--interactive text-inherit",
         footer: "bg-(--dms-bg-muted) py-[9px]",
       },
-      // A dashed, transparent tile with a quiet icon: the module does not
-      // run here.
+
       true: {
         root: "rounded-(--dms-radius-card) border border-dashed border-(--ui-border-accented)",
         footer: "py-[7px]",

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleTileSkeleton.vue

@@ -1,9 +1,4 @@
 <script setup lang="ts">
-// The placeholder of a ModuleTile while the grid loads, block for block the
-// tile's size: the 36px icon well and the 20px pill, the title's 28px line,
-// two description lines, and the footer band with its xs button. Nothing
-// moves once the tiles replace it.
-
 interface ModuleTileSkeletonProps {
   /**
    * A store tile still to install: no status pill, and the 30px npm package

package/frontend-vue/layers/dms-layout/app/build/components/pages/settings/members/MemberRolePicker.vue

@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { inject } from "vue";
+import { isObject } from "#dms-core/app/utils/type-check";
 import {
   formFieldInjectionKey,
   formStateInjectionKey,
@@ -7,7 +8,7 @@ import {
 } from "@nuxt/ui/composables/useFormField";
 import DmsChipGroup, {
   type ChipGroupItem,
-} from "#dms-ui/app/build/components/form/ChipGroup.vue";
+} from "#dms-ui/app/entries/components/form/ChipGroup";
 
 /**
  * The roles of a member as pills, one per role of the workspace, each with
@@ -67,8 +68,7 @@ const props = defineProps<Props>();
 const model = defineModel<string[] | null | undefined>();
 
 const { t } = useI18n();
-// The wrapping UFormField's error ("pick at least one role") marks the group
-// invalid, describes it and rings the pills in the error ink.
+
 const { ariaAttrs } = useFormField();
 const formField = inject(formFieldInjectionKey, undefined);
 const formState = inject(formStateInjectionKey, undefined);
@@ -78,14 +78,11 @@ const isOwner = computed(
   () => !!props.ownerField && formState?.value?.[props.ownerField] === true,
 );
 const isInert = computed(() => props.disabled || isOwner.value);
-// Without an owner field, the form disables the roles for an owner only.
+
 const showsOwnerHint = computed(() =>
   props.ownerField ? isOwner.value : props.disabled,
 );
 
-// Read with the form: a page-mode form renders the pills on the server; a
-// drawer opened again shows the roles at once and reads them again in the
-// background (one may have been added since).
 const roleOptions = useApiData<RoleOptionsResponse>(() => props.rolesUrl);
 const options = computed<RoleOptionsResponse>(
   () => roleOptions.data.value ?? { roles: [], totalPermissions: 0 },
@@ -104,7 +101,7 @@ const roleItems = computed<ChipGroupItem[]>(() =>
 const selectedRoles = computed(() =>
   options.value.roles.filter((role) => selectedIds.value.has(role._id)),
 );
-// An owner holds every permission anyway: no warning then.
+
 const ownerLevelWarning = computed(() => {
   if (isOwner.value) return undefined;
   const names = selectedRoles.value
@@ -141,9 +138,7 @@ const hint = computed(() => {
 function toRoleIds(value: unknown[] | null | undefined): string[] {
   const idKey = props.keyMapping?.value ?? "_id";
   return (value ?? []).map((item) =>
-    item !== null && typeof item === "object"
-      ? String((item as Record<string, unknown>)[idKey])
-      : String(item),
+    item !== null && isObject(item) ? String(item[idKey]) : String(item),
   );
 }
 
@@ -154,7 +149,7 @@ function inLoadedOrder(ids: string[]): string[] {
     const index = loaded.indexOf(id);
     return index === -1 ? loaded.length : index;
   };
-  // A stable sort: ids picked in this form keep the order they were picked in.
+
   return [...ids].sort((left, right) => rank(left) - rank(right));
 }
 

package/frontend-vue/layers/dms-layout/app/build/components/pages/settings/notification/NotificationInboxDisplay.vue

@@ -1,8 +1,8 @@
 <script setup lang="ts">
 import { nextTick } from "vue";
 import { formatRelativeTime } from "#dms-core/app/utils/formatter";
-import TableEmpty from "#dms-ui/app/build/components/table/Empty.vue";
-import TablePagination from "#dms-ui/app/build/components/table/Pagination.vue";
+import TableEmpty from "#dms-ui/app/entries/components/table/Empty";
+import TablePagination from "#dms-ui/app/entries/components/table/Pagination";
 import type { TableViewDisplayContext } from "#dms-ui/app/composables/table-view/types/display";
 import { useConfirm } from "#dms-ui/app/composables/confirm";
 import { useNotificationCatalog } from "../../../../composables/notification/useNotificationCatalog";
@@ -16,11 +16,7 @@ import {
   groupNotificationsByDay,
   type NotificationSourceTag,
 } from "./notificationDisplay";
-import DmsRowSkeleton from "#dms-ui/app/build/components/skeleton/RowSkeleton.vue";
-
-// The `dms:inbox` display of the notifications page's table: the user's feed
-// as v2 inbox rows under day headings. The table brings the tabs, the
-// buttons, the empty states and the infinite pagination.
+import DmsRowSkeleton from "#dms-ui/app/entries/components/skeleton/RowSkeleton";
 
 interface NotificationInboxDisplayProps {
   context: TableViewDisplayContext<UserNotification>;
@@ -66,16 +62,13 @@ const sourceOf = (
   return labelKey ? { label: t(labelKey), isModule: false } : undefined;
 };
 
-// A change made here moves the counts too (the write's answer, then its
-// realtime echo): the watcher below leaves it to the one read that follows it.
 let ownChanges = 0;
 
-// A change of a row is listed again, from the server, once.
-const runThenRefresh = async (action: () => Promise<unknown>) => {
+const runThenRefresh = async (action: () => ReturnType<typeof markAsRead>) => {
   ownChanges++;
   try {
     await action();
-    // What the action changed reaches the watcher before the guard drops.
+
     await nextTick();
   } catch {
     toast.add({ title: t("dms.form.error_title"), color: "error" });
@@ -99,8 +92,6 @@ const toggleRead = (notification: UserNotification) =>
       : markAsRead(notification._id),
   );
 
-// A deletion cannot be undone, and its button sits next to Mark read: it is
-// asked first, as "Delete all" is, with the safe answer focused.
 const removeNotification = async (notification: UserNotification) => {
   const isConfirmed = await confirm({
     title: t("page.settings.notifications.delete_one_title"),
@@ -117,9 +108,6 @@ const removeNotification = async (notification: UserNotification) => {
   }
 };
 
-// What the stream changes elsewhere (a notification arriving, read in
-// another tab) is listed again here: once per change of the count or of the
-// newest notification, not each time the bell's lists are rebuilt.
 watch([unreadCount, () => notifications.value[0]?._id], () => {
   if (ownChanges === 0) void props.context.refresh();
 });

package/frontend-vue/layers/dms-layout/app/build/components/pages/settings/notification/NotificationInboxItem.vue

@@ -32,12 +32,7 @@ const readToggleLabel = computed(() =>
     ? t("page.settings.notifications.mark_read")
     : t("page.settings.notifications.mark_unread"),
 );
-// Row actions stay quiet until the row is hovered or holds focus, then
-// show their labels (v2 C07). The labels only fade in: they keep their room
-// laid out, so the buttons never move under the pointer on the way to one
-// (a label appearing used to slide Delete under a Mark read click). Phones
-// show the icons alone: a tap focuses the row, and the labels would squeeze
-// the text there.
+
 const actionLabelUi = {
   label:
     "hidden sm:inline sm:opacity-0 sm:transition-opacity sm:duration-150 sm:group-hover:opacity-100 sm:group-focus-within:opacity-100",