@antelopejs/dms 0.11.1 → 0.12.1

package/frontend-vue/layers/dms-layout/app/build/composables/settings/security/useSecurityFormat.ts

@@ -1,4 +1,5 @@
 import { regionalDateTimeFormat } from "#dms-core/app/utils/regional";
+import { isString } from "#dms-core/app/utils/type-check";
 
 const MS_PER_SECOND = 1000;
 const MS_PER_MINUTE = 60 * MS_PER_SECOND;
@@ -71,9 +72,11 @@ export function useSecurityFormat() {
    * @param error What `$authFetch` threw
    * @param fallbackKey Message used when the error carries no known code
    */
+  // oxlint-disable-next-line anti-slop/no-unknown-parameters -- JavaScript throws arbitrary values. FetchError-derived parameters would reject the boundary inputs this formatter already handles.
   const errorMessage = (error: unknown, fallbackKey: string): string => {
+    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- Unchecked optional property projection preserves primitive and nullish thrown values; this is not a validated FetchError and owner typing cannot guarantee one.
     const code = (error as FetchErrorLike | undefined)?.data;
-    if (typeof code !== "string" || !code.startsWith(ERROR_CODE_PREFIX)) {
+    if (!isString(code) || !code.startsWith(ERROR_CODE_PREFIX)) {
       return t(fallbackKey);
     }
     const ownKey = `${SECURITY_ERRORS_PREFIX}${code.slice(ERROR_CODE_PREFIX.length)}`;
@@ -82,9 +85,11 @@ export function useSecurityFormat() {
   };
 
   /** @returns The error code (`error.xxx`) the API answered with, if any */
+  // oxlint-disable-next-line anti-slop/no-unknown-parameters -- JavaScript throws arbitrary values; a FetchError parameter would narrow this public error boundary.
   const errorCode = (error: unknown): string | undefined => {
+    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- This historical projection is deliberately unchecked, including nullish and primitive errors; inference cannot project data from unknown without changing the boundary.
     const code = (error as FetchErrorLike | undefined)?.data;
-    return typeof code === "string" ? code : undefined;
+    return isString(code) ? code : undefined;
   };
 
   return {

package/frontend-vue/layers/dms-layout/app/build/composables/settings/security/useSecurityOverview.ts

@@ -1,6 +1,6 @@
 import { pageRoutePath } from "#dms-core/app/utils/pageRoutes";
-import { useNavBadges } from "#dms-ui/app/build/composables/navigation/useNavBadges";
-import type { Tone } from "#dms-ui/app/types/tone";
+import { useNavBadges } from "#dms-ui/app/entries/composables/navigation/useNavBadges";
+import type { Tone } from "#dms-core/app/types/tone";
 
 /** Base URL of the Security page API. */
 export const SECURITY_ENDPOINT = pageRoutePath("/settings/user/security");
@@ -78,7 +78,7 @@ const ATTENTION_TONE_ORDER: Tone[] = [
 export function useSecurityOverview() {
   const summary = useApiData<SecurityOverview>(SECURITY_ENDPOINT);
   const overview = computed(() => summary.data.value ?? null);
-  // A retry in progress is not a failure to show.
+
   const isUnavailable = computed(
     () => !!summary.error.value && summary.status.value !== "pending",
   );

package/frontend-vue/layers/dms-layout/app/build/composables/settings/useSettingsNavigation.ts

@@ -1,10 +1,10 @@
 import type { MenuItemStatus } from "#dms-core/app/types/menu";
-import type { SiteLayoutTree } from "../../../types/page";
+import type { SiteLayoutTree } from "#dms-core/app/types/page";
 import {
   listCategoryPages,
   listPagesAmong,
   orderedChildren,
-} from "../../utils/categoryPages";
+} from "#dms-ui/app/entries/utils/categoryPages";
 
 export const SETTINGS_ROOT_ID = "settings";
 const DEFAULT_SETTINGS_ICON = "i-ph-gear-six";

package/frontend-vue/layers/dms-layout/app/build/utils/dev-reload-stream.ts

@@ -2,7 +2,7 @@ import { type Ref, watch } from "vue";
 import {
   type CrossTabEnvironment,
   shareAcrossTabs,
-} from "#dms-core/app/build/utils/crossTab";
+} from "#dms-core/app/entries/utils/crossTab";
 
 const RELOAD_EVENT_NAME = "reload";
 const REOPEN_DELAY_MS = 2000;
@@ -26,8 +26,6 @@ interface StreamState {
   isClosed: boolean;
 }
 
-// The browser fires `error` on every failed retry while the backend is down,
-// so only the first one after a working connection is worth a warning.
 function handleError(state: StreamState): void {
   if (!state.isConnectionLost) {
     state.isConnectionLost = true;
@@ -35,9 +33,7 @@ function handleError(state: StreamState): void {
       "[dms-dev-reload] SSE connection lost, waiting for backend...",
     );
   }
-  // EventSource retries a dropped connection by itself, but gives up for good
-  // on an answer that is not an event stream (a 404 while the module reloads,
-  // a proxy error page): only then does it need a new source.
+
   if (state.source?.readyState !== EventSource.CLOSED) return;
   scheduleReopen(state);
 }

package/frontend-vue/layers/dms-layout/app/build/utils/github-repository.ts

@@ -1,5 +1,5 @@
 /** The DMS repository on GitHub, as `owner/name`. */
 const GITHUB_REPOSITORY = "AntelopeJS/dms";
 
-/** Opened by the dashboard's star prompt. */
+/** The DMS repository page on GitHub. */
 export const GITHUB_REPOSITORY_URL = `https://github.com/${GITHUB_REPOSITORY}`;

package/frontend-vue/layers/dms-layout/app/build/utils/module-store-catalog.ts

@@ -1,12 +1,15 @@
-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";
-import { type ModuleCatalogEntry, MODULE_URL_PREFIX } from "../../types/page";
+import {
+  type ModuleCatalogEntry,
+  MODULE_URL_PREFIX,
+} from "#dms-core/app/types/page";
 import type {
   ModuleSourceKind,
   StoreListingEntry,
   StoreModuleState,
   StoreOperationKind,
-} from "../../types/module-store";
+} from "#dms-core/app/types/module-store";
 import {
   type DisplayResolver,
   compareDisplayNames,
@@ -120,8 +123,7 @@ export function toModuleStoreEntry(
   const registered = registeredModules.find((module) => module.id === entry.id);
   return {
     ...entry,
-    // The registration also names Installed and navigation. Keep the catalog
-    // fallback for unloaded modules, whose translations may not be served.
+
     title: registered?.title ?? entry.title,
     catalogCategory: resolveCatalogCategory(registered, entry),
   };
@@ -208,7 +210,6 @@ export function sortStoreModules<T extends StoreListingEntry>(
  * applying the file otherwise.
  */
 export function storeActions(entry: StoreListingEntry): StoreAction[] {
-  // The developer's working copy is theirs to change in antelope.config.ts.
   if (entry.isWorkingCopy) return [];
   const installed = entry.installedVersion !== undefined;
   const byState: Record<StoreModuleState, StoreOperationKind[]> = {
@@ -271,7 +272,7 @@ export function storeActionBlock(
 ): StoreActionBlock | undefined {
   if (RELEASE_ACTIONS.has(kind)) return releaseBlock(entry, kind);
   if (!TAKE_DOWN_ACTIONS.has(kind)) return undefined;
-  // The project cannot be removed first: only a change to its code frees it.
+
   if (entry.usedByProject) return "used_by_project";
   return entry.dependents.length > 0 ? "dependents" : undefined;
 }
@@ -396,7 +397,7 @@ export function storeOnlyModules(
       description: entry.description,
       icon: entry.icon,
       hasAccess: true,
-      // Nothing to open: the module serves no page.
+
       landingSlug: "",
       catalogCategory: entry.catalogCategory,
       version:

package/frontend-vue/layers/dms-layout/app/build/utils/module-store-install.ts

@@ -2,7 +2,8 @@ import type {
   MissingInterface,
   StoreActionBody,
   StoreDependencyChoice,
-} from "../../types/module-store";
+} from "#dms-core/app/types/module-store";
+import { isObject } from "#dms-core/app/utils/type-check";
 
 /**
  * The radio value of the "Other npm package" choice: not an npm package
@@ -43,7 +44,7 @@ export interface DependencyDraftErrors {
 /** A config as the dialog reads it: absent when left empty. */
 export interface ParsedDependencyConfig {
   isValid: boolean;
-  config?: Record<string, unknown>;
+  config?: StoreDependencyChoice["config"];
 }
 
 export function isNpmPackageName(value: string): boolean {
@@ -52,8 +53,10 @@ export function isNpmPackageName(value: string): boolean {
   );
 }
 
-const isPlainObject = (value: unknown): value is Record<string, unknown> =>
-  typeof value === "object" && value !== null && !Array.isArray(value);
+const isPlainObject = (
+  value: unknown,
+): value is NonNullable<StoreDependencyChoice["config"]> =>
+  isObject(value) && value !== null && !Array.isArray(value);
 
 /** Reads a typed config: empty is no config, anything else a JSON object. */
 export function parseDependencyConfig(text: string): ParsedDependencyConfig {

package/frontend-vue/layers/dms-layout/app/build/utils/modules-catalog.ts

@@ -5,7 +5,7 @@ import type {
   PageInfo,
   SiteLayout,
   SiteLayoutTree,
-} from "../../types/page";
+} from "#dms-core/app/types/page";
 import { resolveModuleLandingSlug } from "../../utils/moduleLanding";
 
 /** The Modules page, which lists and manages the installed modules. */
@@ -39,6 +39,7 @@ export const DEFAULT_MODULE_SORT_MODE: ModuleSortMode = "name";
 const MODULE_SORT_MODES: readonly ModuleSortMode[] = ["name", "recent"];
 
 /** A remembered sort mode, or the default when it is missing or unknown. */
+// oxlint-disable-next-line anti-slop/no-unknown-parameters -- This parser accepts arbitrary persisted values and falls back for invalid ones; ModuleSortMode would remove that public boundary contract.
 export function parseModuleSortMode(value: unknown): ModuleSortMode {
   return (
     MODULE_SORT_MODES.find((mode) => mode === value) ?? DEFAULT_MODULE_SORT_MODE
@@ -218,8 +219,7 @@ type ServedPage = PageInfo & {
 function isOpenablePage(page: ServedPage): boolean {
   if (page.hidden || page.hasAccess === false) return false;
   if (page.type === "label") return false;
-  // A page that needs a URL parameter or a query cannot be opened from a
-  // bare link.
+
   if (page.fullSlug.includes(":")) return false;
   return !page.validation?.requiredQueryParams?.length;
 }
@@ -236,7 +236,8 @@ export function findModulePageMatch(
 ): ModulePageMatch | null {
   const needle = normalizeQuery(query);
   if (!needle || !siteLayout) return null;
-  for (const page of Object.values(siteLayout.pages) as ServedPage[]) {
+  const pages: ServedPage[] = Object.values(siteLayout.pages);
+  for (const page of pages) {
     if (!page.module || !installedModuleIds.has(page.module)) continue;
     if (!isOpenablePage(page)) continue;
     const pageTitle = resolve(page.displayName);

package/frontend-vue/layers/dms-layout/app/build/utils/pageValidationRedirect.ts

@@ -2,8 +2,8 @@ import { parseURL, withoutTrailingSlash } from "ufo";
 import {
   type ReplaceUrlVariablesContext,
   resolveLinkVariables,
-} from "#dms-ui/app/build/utils/urlVariables";
-import type { PageValidation } from "../../types/page";
+} from "#dms-ui/app/entries/utils/urlVariables";
+import type { PageValidation } from "#dms-core/app/types/page";
 
 const ROOT_PATH = "/";
 

package/frontend-vue/layers/dms-layout/app/build/utils/publicErrorMessage.ts

@@ -1,6 +1,3 @@
-// A fetch failure names the request it failed: `[GET] "http://10.0.0.4:5010/
-// dms/page?path=/x": 502 Bad Gateway`. On a server, that is the backend's
-// internal address, which an error page must never show.
 const FETCH_FAILURE = /^\[[A-Z]+\]\s+"[^"]*":\s*(.*)$/s;
 const ABSOLUTE_URL = /\b[a-z][a-z0-9+.-]*:\/\/[^\s"'<>]+/gi;
 const SPACES = /\s{2,}/g;

package/frontend-vue/layers/dms-layout/app/components/layout/DashboardSearch.vue

@@ -22,9 +22,9 @@ const {
 
 const footerRef = useTemplateRef<HTMLElement>("footer");
 const input = { onKeydown: onInputKeydown };
-// The halo eases between the accent ring and the violet assistant ring.
+
 const MODAL_TRANSITION_CLASS = "transition-shadow duration-300";
-// In assistant mode, the empty slot holds the DMS's own padded states.
+
 const ASSISTANT_EMPTY_CLASS = "p-0 text-start";
 const SEARCH_UI = { modal: MODAL_TRANSITION_CLASS };
 const ASSISTANT_UI = {

package/frontend-vue/layers/dms-layout/app/components/navigation/AccordionItemSync.vue

@@ -18,7 +18,6 @@ const emit = defineEmits<{
 const itemContext = injectAccordionItemContext();
 const rootContext = injectAccordionRootContext();
 
-// Push accordion state out (user toggles, initial defaultOpen).
 watch(
   () => itemContext.open.value,
   (open) => {
@@ -27,14 +26,10 @@ watch(
   { immediate: true },
 );
 
-// Pull desired state in (route navigation merges required ids). When the
-// parent says this item should be open/closed but the accordion disagrees,
-// flip it via Reka's own toggle so each nested AccordionRoot stays the
-// source of truth for its own visual state.
 watchEffect(() => {
   const desired = props.isDesiredOpen(props.itemId);
   if (desired !== itemContext.open.value) {
-    rootContext.changeModelValue(itemContext.value.value as string);
+    rootContext.changeModelValue(itemContext.value.value);
   }
 });
 </script>

package/frontend-vue/layers/dms-layout/app/components/navigation/CollapsedMenuItem.vue

@@ -7,9 +7,7 @@ const theme = tv({
       "relative flex items-center justify-center size-8 rounded-md transition-colors hover:bg-elevated",
     link: "flex items-center gap-2 px-2 py-1.5 rounded-md text-sm transition-colors hover:bg-elevated",
     icon: "shrink-0",
-    // The collapsed rail leaves no room for a trailing dot, so a top-level
-    // entry carries it as a badge on the corner of its icon. The ring makes it
-    // readable whatever the icon underneath.
+
     topLevelStatusDot:
       "absolute top-0.5 right-0.5 size-2 rounded-full bg-current ring-2 ring-default",
     statusDot: "ml-auto size-2 shrink-0 rounded-full bg-current",
@@ -20,8 +18,7 @@ const theme = tv({
     childList: "space-y-0.5",
     collapsibleTrigger: "w-full justify-between",
     collapsibleContent: "mt-0.5 space-y-0.5",
-    // "Preview as role" only: the badge the rail puts on a locked entry's
-    // icon, and the lock a nested locked entry ends with (toned by state).
+
     topLevelLock:
       "absolute -top-0.5 -right-0.5 size-3.5 rounded-full bg-default",
     lock: "ml-auto size-3.5 shrink-0",
@@ -38,8 +35,7 @@ const theme = tv({
     isAccent: {
       true: { topLevelButton: "text-primary", link: "text-primary" },
     },
-    // Same hatches as the expanded menu (NavigationMenu.vue): red for an
-    // entry the role could not open, orange for one it opens partially.
+
     previewState: {
       hidden: {
         topLevelButton: "text-muted dms-hatch-locked",
@@ -62,7 +58,7 @@ const theme = tv({
 
 <script setup lang="ts">
 import { DmsLink } from "#dms/frontend-module";
-import { PREVIEW_LOCK_ICON } from "#dms-ui/app/build/utils/permissionPreview";
+import { PREVIEW_LOCK_ICON } from "#dms-ui/app/entries/utils/permissionPreview";
 
 interface Props {
   item: DmsMenuItem;
@@ -83,7 +79,6 @@ const ui = computed(() =>
   }),
 );
 
-// Rendered as a plain dot taking its color from the shared status map.
 const statusClass = computed(() =>
   props.item.status ? MENU_STATUS_TEXT_CLASSES[props.item.status] : undefined,
 );

package/frontend-vue/layers/dms-layout/app/components/navigation/NavigationMenu.vue

@@ -1,13 +1,14 @@
 <script setup lang="ts">
-import type { AvatarProps, NavigationMenuItem } from "@nuxt/ui";
+import type { NavigationMenuItem } from "@nuxt/ui";
 import { MENU_STATUS_CHIP_COLORS } from "#dms-core/app/utils/menu";
-import { useNavBadges } from "#dms-ui/app/build/composables/navigation/useNavBadges";
-import { usePermissionPreview } from "#dms-core/app/build/composables/auth/usePermissionPreview";
-import { PREVIEW_LOCK_ICON } from "#dms-ui/app/build/utils/permissionPreview";
+import { isNumber, isString } from "#dms-core/app/utils/type-check";
+import { useNavBadges } from "#dms-ui/app/entries/composables/navigation/useNavBadges";
+import { usePermissionPreview } from "#dms-core/app/entries/composables/auth/usePermissionPreview";
+import { PREVIEW_LOCK_ICON } from "#dms-ui/app/entries/utils/permissionPreview";
 import {
   applyPreviewEntryStates,
   type PreviewEntryState,
-} from "#dms-core/app/build/utils/permission-preview";
+} from "#dms-core/app/entries/utils/permission-preview";
 
 interface Props {
   items: NavigationMenuItem[] | NavigationMenuItem[][];
@@ -26,9 +27,6 @@ const emit = defineEmits<{
   "update:modelValue": [value: string[]];
 }>();
 
-// When no v-model is bound, leave each AccordionRoot fully uncontrolled —
-// Reka's own defaultOpen handling takes over and we skip the sync component
-// entirely.
 const controlled = computed(() => Array.isArray(props.modelValue));
 
 const isArrayOfArrays = (
@@ -37,8 +35,6 @@ const isArrayOfArrays = (
   return Array.isArray(items[0]);
 };
 
-// Semantic fields declared on a page or by a dynamic menu provider are turned
-// into Nuxt UI item props here, so the registration side never ships classes.
 interface MenuVariantClasses {
   link?: string;
   leadingIcon?: string;
@@ -114,13 +110,11 @@ function buildItemUi(
     : undefined;
 }
 
-// A plain badge value (a page's `badge`) gets the v2 look in its tone; a
-// badge already given as props is the caller's own choice.
 function resolveMenuBadge(
   badge: DmsMenuItem["badge"],
   tone: MenuItemBadgeTone | undefined,
 ): DmsMenuItem["badge"] {
-  if (typeof badge === "string" || typeof badge === "number") {
+  if (isString(badge) || isNumber(badge)) {
     return {
       ...MENU_BADGE_PROPS,
       color: tone ?? DEFAULT_BADGE_TONE,
@@ -130,13 +124,6 @@ function resolveMenuBadge(
   return badge;
 }
 
-// "Preview as role": an entry the previewed role could not open stays in the
-// menu, hatched red and locked, so the preview shows what the role loses
-// instead of a shorter menu; one it opens without all of it (a block or an
-// action of its page, or one of its entries) is hatched orange with the same
-// lock. Labels and parents are drawn too; a parent keeps its trailing slot
-// for the chevron and shows the lock in place of its icon. Outside a preview
-// `entryState` is always null: nothing is ever drawn.
 const preview = usePermissionPreview();
 const { t } = useI18n();
 const PREVIEW_ENTRY_LINK_CLASSES: Record<PreviewEntryState, string> = {
@@ -160,29 +147,26 @@ function drawPreviewEntry(
   const title = t(PREVIEW_ENTRY_TITLES[state], {
     role: preview.session.value?.roleName ?? "",
   });
-  return {
+  const result: DmsMenuItem = {
     ...item,
     previewState: state,
     previewLocked: state === "hidden",
     class: [item.class, PREVIEW_ENTRY_LINK_CLASSES[state]],
     title,
     "aria-label": `${String(item.label ?? "")} · ${title}`,
-    ...(hasChildren
-      ? {}
-      : {
-          trailingIcon: PREVIEW_LOCK_ICON,
-          badge: undefined,
-          ui: {
-            ...UNSET_MENU_ITEM_UI,
-            ...item.ui,
-            linkTrailingIcon: `size-3.5 ${PREVIEW_LOCK_TONES[state]}`,
-          },
-        }),
   };
+  if (!hasChildren) {
+    result.trailingIcon = PREVIEW_LOCK_ICON;
+    result.badge = undefined;
+    result.ui = {
+      ...UNSET_MENU_ITEM_UI,
+      ...item.ui,
+      linkTrailingIcon: `size-3.5 ${PREVIEW_LOCK_TONES[state]}`,
+    };
+  }
+  return result;
 }
 
-// The count a table view published for the page (`navBadge`) is fresher than
-// the one the server counted when the menu loaded; `""` stands for none.
 const { badges: navBadges } = useNavBadges();
 
 function badgeOf(item: DmsMenuItem): DmsMenuItem["badge"] {
@@ -202,22 +186,16 @@ function decorateMenuItem(item: DmsMenuItem): DmsMenuItem {
       : undefined;
   const ui = buildItemUi(item, variant, statusClass);
 
-  return {
-    ...item,
-    // Inertia prefetches the page on hover, the way a `DmsLink` does: the
-    // visit then shows it without a request, and its components load early.
-    ...(item.to ? { prefetch: true } : {}),
-    ...(variant.link ? { class: [item.class, variant.link] } : {}),
-    ...(statusClass ? { trailingIcon: STATUS_DOT_ICON } : {}),
-    badge,
-    ...(ui ? { ui } : {}),
-    children: item.children?.map(decorateMenuItem),
-  };
+  const result: DmsMenuItem = { ...item };
+  if (item.to) result.prefetch = true;
+  if (variant.link) result.class = [item.class, variant.link];
+  if (statusClass) result.trailingIcon = STATUS_DOT_ICON;
+  result.badge = badge;
+  if (ui) result.ui = ui;
+  result.children = item.children?.map(decorateMenuItem);
+  return result;
 }
 
-// Normalized to groups for both renderings: UNavigationMenu wraps a flat list
-// in a single group itself, so one shape serves the expanded and the collapsed
-// branch.
 const groupedItems = computed((): NavigationMenuItem[][] => {
   if (!props.items || props.items.length === 0) {
     return [];
@@ -275,7 +253,7 @@ function onStateChange(id: string, open: boolean): void {
       />
       <UAvatar
         v-if="item.avatar"
-        :size="ui.linkLeadingAvatarSize() as AvatarProps['size']"
+        :size="ui.linkLeadingAvatarSize()"
         v-bind="item.avatar"
         :class="
           ui.linkLeadingAvatar({

package/frontend-vue/layers/dms-layout/app/composables/general/useAccessibilityPreferences.ts

@@ -5,7 +5,7 @@ import {
   parseAccessibilityPreferences,
   type AccessibilityPreferences,
   type ReduceMotionPreference,
-} from "#dms-ui/app/build/utils/accessibilityPreferences";
+} from "#dms-ui/app/entries/utils/accessibilityPreferences";
 
 const ACCESSIBILITY_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
 

package/frontend-vue/layers/dms-layout/app/composables/general/useSystemState.ts

@@ -20,7 +20,7 @@ export const useSystemState = () => {
     key: SYSTEM_STATE_CACHE_KEY,
     lazy: true,
     default: () => ({ ...DEFAULT_SYSTEM_STATE }),
-    // The deployment's state, not the page's data.
+
     refreshOnPageRefresh: false,
   });
 

package/frontend-vue/layers/dms-layout/app/composables/layout/useLayoutBanners.ts

@@ -8,7 +8,6 @@ interface LayoutBannerPresentation {
   icon: string;
 }
 
-// An error interrupts the screen reader; info and warning wait their turn.
 const PRESENTATIONS: Record<LayoutBannerVariant, LayoutBannerPresentation> = {
   info: { role: "status", color: "info", icon: "i-ph-info-light" },
   warning: { role: "status", color: "warning", icon: "i-ph-warning-light" },