@antelopejs/dms 0.11.1 → 0.12.1

package/frontend-vue/layers/dms-ui/app/build/components/containers/modal/DynamicModal.vue

@@ -2,7 +2,10 @@
 import type { Component } from "vue";
 import { DialogDescription, DialogTitle, VisuallyHidden } from "reka-ui";
 import type { ModalSize } from "../../../../types/modal";
-import type { ContainerColor } from "../../../../composables/containers/types";
+import type {
+  ContainerColor,
+  ContainerInstance,
+} from "../../../../composables/containers/types";
 import DmsIconWell from "../../../../components/icon-well/IconWell.vue";
 import {
   CLOSING_OVERLAY_CLASS,
@@ -17,17 +20,19 @@ interface DynamicModalProps {
   size?: ModalSize;
   containerId: string;
   component: Component;
+  // oxlint-disable-next-line anti-slop/no-unsafe-dictionary-type -- ContainerOptions derives VNode props and constrains reserved keys such as key and ref. This legacy component-prop boundary accepts arbitrary values for every string key without validation.
   componentOptions?: Record<string, unknown>;
   /** Mounts the body component anew when it changes. */
   componentKey?: string;
   headerComponent?: Component;
+  // oxlint-disable-next-line anti-slop/no-unsafe-dictionary-type -- ContainerOptions derives VNode props and constrains reserved keys such as key and ref. This legacy header-prop boundary accepts arbitrary values for every string key without validation.
   headerComponentOptions?: Record<string, unknown>;
   icon?: string;
   color?: ContainerColor;
 }
 
 interface DynamicModalEmits {
-  (e: "close", result?: unknown): void;
+  (e: "close", result?: Parameters<ContainerInstance["close"]>[0]): void;
 }
 
 const props = withDefaults(defineProps<DynamicModalProps>(), {
@@ -41,11 +46,8 @@ const props = withDefaults(defineProps<DynamicModalProps>(), {
 });
 const emit = defineEmits<DynamicModalEmits>();
 
-// Let a DmsForm rendered in the body drop its DmsCard (the modal is the surface).
 provide("dmsFormContainer", true);
 
-// UModal has no size variant, so map our ModalSize onto a max-width. Form
-// modals default wider than Nuxt UI's max-w-lg for breathing room.
 const SIZE_ORDER: ModalSize[] = [
   "sm",
   "md",
@@ -68,8 +70,7 @@ const SIZE_CONTENT: Record<ModalSize, string> = {
   "5xl": "sm:max-w-5xl",
   full: "sm:max-w-5xl h-[calc(100dvh-4rem)]",
 };
-// Form modals shouldn't be narrower than this; callers asking for a bigger
-// size are still honored.
+
 const MIN_SIZE: ModalSize = "3xl";
 
 const resolvedSize = computed(() => {
@@ -79,21 +80,18 @@ const resolvedSize = computed(() => {
     : MIN_SIZE;
 });
 
-// A divided head: the body below is a form, not a continuation of the title.
 const modalUi = computed(() => ({
   content: SIZE_CONTENT[resolvedSize.value],
   overlay: CLOSING_OVERLAY_CLASS,
   header: "border-b border-default pb-4 shrink-0",
-  // The body's bottom and side padding: a form's sticky footer sits flush
-  // with the modal's edges (see Form.vue).
+
   body: "[--dms-form-foot-pb:1.25rem] [--dms-form-foot-px:1.25rem]",
 }));
 
 const { executeGuards, clearGuards } = useLeaveGuard();
 
 const isOpen = defineModel<boolean>("open", { default: true });
-// Reka keeps the page's `pointer-events: none` on the body until the modal
-// has scaled out: released as soon as the close starts, a click lands.
+
 const contentProps = computed(() => ({
   disableOutsidePointerEvents: isOpen.value,
 }));
@@ -118,12 +116,8 @@ async function tryClose() {
   closePromise = null;
 }
 
-// A form in the body closes through the guards (its Cancel button) and
-// registers its own under this id, whatever component wraps it.
 provide(DMS_CONTAINER_KEY, { id: props.containerId, close: tryClose });
 
-// Another page (Back, a link): the modal belongs to the one left. Its
-// unsaved changes were already confirmed by the navigation guard.
 const route = useDmsRoute();
 watch(
   () => route.path,
@@ -134,7 +128,7 @@ watch(
   },
 );
 
-function handleSuccess(result?: unknown) {
+function handleSuccess(result?: Parameters<ContainerInstance["close"]>[0]) {
   clearGuards(props.containerId);
   isOpen.value = false;
   emit("close", result);

package/frontend-vue/layers/dms-ui/app/build/components/containers/row/RowHeader.vue

@@ -25,6 +25,7 @@ interface RowHeaderProps {
   subtitleClass?: string;
   /** Drawn under the position line (pills, hints). */
   component?: Component;
+  // oxlint-disable-next-line anti-slop/no-unsafe-dictionary-type -- DrawerRowHeader derives VNode props and constrains reserved keys such as key and ref. This legacy header-prop boundary accepts arbitrary values for every string key without validation.
   componentOptions?: Record<string, unknown>;
 }
 
@@ -45,7 +46,6 @@ const DEFAULT_POSITION_KEY = "side_panel.position";
 const { t, locale } = useI18n();
 const { processI18n } = useTranslation();
 
-// "26 120", not "26120": the figures take the locale's grouping.
 const numberFormat = computed(() => new Intl.NumberFormat(locale.value));
 
 const position = computed(() => {
@@ -59,7 +59,6 @@ const position = computed(() => {
     : t(DEFAULT_POSITION_KEY, params);
 });
 
-// Each segment but the last keeps the separator that follows it.
 const headingSegments = computed(() => {
   const separator = props.headingBreakAfter;
   if (!props.heading || !separator) return undefined;

package/frontend-vue/layers/dms-ui/app/build/components/containers/row/drawerRowHeader.ts

@@ -1,10 +1,9 @@
 import { markRaw } from "vue";
 import type { DrawerRowHeader } from "../../../../composables/containers/types";
 
-// The drawer's header title, as `DynamicDrawer` draws its own.
 const DRAWER_ROW_HEADING_CLASS =
   "text-[17px] leading-[1.3] font-[650] tracking-[-0.02em]";
-// The `data-dms-row-drawer-*` hooks tests and styles find the parts by.
+
 const DRAWER_ROW_HEADER_PART = "dms-row-drawer";
 
 /**
@@ -13,10 +12,7 @@ const DRAWER_ROW_HEADER_PART = "dms-row-drawer";
  *
  * @internal
  */
-export function drawerRowHeaderProps(
-  header: DrawerRowHeader,
-  title: string,
-): Record<string, unknown> {
+export function drawerRowHeaderProps(header: DrawerRowHeader, title: string) {
   return {
     part: DRAWER_ROW_HEADER_PART,
     heading: header.title ?? title,
@@ -28,7 +24,7 @@ export function drawerRowHeaderProps(
     headingBreakAfter: header.titleBreakAfter,
     subtitle: header.subtitle,
     subtitleClass: header.subtitleClass,
-    // Kept out of the overlay's reactive props, as the body component is.
+
     component: header.component && markRaw(header.component),
     componentOptions: header.componentOptions,
   };

package/frontend-vue/layers/dms-ui/app/build/components/form/ChipGroup.vue

@@ -2,11 +2,6 @@
 import { computed } from "vue";
 import { tv } from "tailwind-variants";
 
-// The one row of pill chips of the DMS (v2 .mc-cat): one pick among them
-// (a radio group: the modules' categories) or several (toggles with a check:
-// the roles of an invitation). Attributes (`id`, `aria-describedby`…) go to
-// the group.
-
 /** One chip: its value, its label and, optionally, a mono count after it. */
 export interface ChipGroupItem {
   value: string;
@@ -74,7 +69,6 @@ const ui = (item: ChipGroupItem) =>
     disabled: props.disabled,
   });
 
-// A single pick reads as radios, several as toggle buttons.
 const groupRole = computed(() => (props.multiple ? "group" : "radiogroup"));
 const chipAria = (item: ChipGroupItem) =>
   props.multiple

package/frontend-vue/layers/dms-ui/app/build/components/form/FormEntries.vue

@@ -11,7 +11,7 @@ import {
   entryRowLayout,
   GROUP_MEMBER_CLASSES,
 } from "../../composables/form/formLayout";
-import { combineSaveStates } from "#dms-layout/app/composables/layout/useInstantSaveHeader";
+import { combineSaveStates } from "#dms-ui/app/composables/layout/useInstantSaveHeader";
 import type { SaveStatusState } from "../../../components/save-bar/SaveStatus.vue";
 import DmsFormFieldControl from "./FormFieldControl.vue";
 import DmsFieldRow from "../../../components/field-row/FieldRow.vue";
@@ -43,8 +43,6 @@ function isGroupVisible(group: FieldGroup): boolean {
   return group.fields.some((field) => !context.isFieldHidden(field));
 }
 
-// A description tells how to fill the field ("Left empty, the default rate
-// applies"): a form where nothing can be changed shows only the values.
 function descriptionOf(entry: FormFieldOrGroup): string | undefined {
   return context.isReadOnly.value ? undefined : entry.description;
 }

package/frontend-vue/layers/dms-ui/app/build/components/form/FormErrorSummary.vue

@@ -16,8 +16,6 @@ const props = defineProps<FormErrorSummaryProps>();
 const emit = defineEmits<{ select: [fieldId: string] }>();
 const { t } = useI18n();
 
-// Every field fixed: the summary says so in place, on as many lines, rather
-// than leaving and moving the form up under the pointer.
 const isResolved = computed(() => props.items.length === 0);
 </script>
 

package/frontend-vue/layers/dms-ui/app/build/components/form/FormFieldControl.vue

@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { pageLink } from "../../composables/page/pageUrlValues";
+import { isObject } from "#dms-core/app/utils/type-check";
 import type {
   FormField,
   FormFieldReadonly,
@@ -23,11 +24,10 @@ const { state, initialValues, loading } = context;
 const { processI18n } = useTranslation();
 
 const isDisabled = computed(() => context.isFieldDisabled(props.field));
-// A list of rows reads best as its rows, its own control disabled: the
-// display of a cell only counts them. An empty one still reads "empty".
+
 const READS_AS_CONTROL = new Set(["array", "key_value"]);
-const hasRows = (value: unknown): boolean =>
-  !!value && typeof value === "object" && Object.keys(value).length > 0;
+const hasRows = (value: (typeof state)["value"][string]): boolean =>
+  !!value && isObject(value) && Object.keys(value).length > 0;
 const showsDisplay = computed(
   () =>
     isDisabled.value &&
@@ -41,22 +41,19 @@ const component = computed(() => {
   const name = props.field.component.componentName;
   return name ? resolveDmsComponent(name) || name : null;
 });
-// The hint under the control, which describes it (`aria-describedby`): a
-// read-only field has no control to fill, and no hint telling how.
+
 const hint = computed(() =>
   props.field.hint && !isDisabled.value
     ? processI18n(props.field.hint)
     : undefined,
 );
-// UFormField shows its error slot whenever one is given, in the hint's
-// place: it gets one only while the field holds an error.
+
 const formErrors = inject(formErrorsInjectionKey, null);
 const hasError = computed(() => {
   const pattern = fieldErrorPattern(props.field.id);
   return !!formErrors?.value.some((error) => pattern.test(error.name ?? ""));
 });
-// A read-only relation shows the row the server joined (its label, its
-// avatar), as a table cell does, rather than the id its state holds.
+
 const { getDataType } = useDataTypes();
 const readonlyValue = computed(() =>
   readonlyFieldValue(
@@ -66,9 +63,9 @@ const readonlyValue = computed(() =>
     props.field.component.options,
   ),
 );
-// What a read-only field shows beside its value: a pill, a link.
+
 const readonly = computed<FormFieldReadonly>(() =>
-  typeof props.field.readonly === "object" ? props.field.readonly : {},
+  isObject(props.field.readonly) ? props.field.readonly : {},
 );
 </script>
 
@@ -78,7 +75,7 @@ const readonly = computed<FormFieldReadonly>(() =>
   <div class="grid min-w-0 grid-cols-1 gap-1.5">
     <DmsLocalizedField
       v-if="field.localized"
-      v-model="state[field.id] as Record<string, string> | undefined"
+      v-model="state[field.id]"
       :field
       :initial-values="initialValues"
       :loading

package/frontend-vue/layers/dms-ui/app/build/components/form/FormFieldNotes.vue

@@ -1,5 +1,7 @@
 <script setup lang="ts">
 import { isVNode, type VNodeChild } from "vue";
+import { isString, isNumber } from "#dms-core/app/utils/type-check";
+import type { DataTypeFormatter } from "#dms-core/app/composables/data-types/useDataType";
 import type { FormField } from "../../../composables/form/types/field";
 import {
   isEmptyFormValue,
@@ -20,13 +22,10 @@ const value = computed(() => context.state.value[props.field.id]);
 const baseline = computed(() => context.baselineValue(props.field.id));
 const defaultValue = computed(() => props.field.defaultValue);
 
-// "Changed · was X" while a change waits for its save.
 const showsChange = computed(
   () => context.showsChanges && context.isFieldChanged(props.field.id),
 );
-// "Module default · Use default" on a value that is not the default, for a
-// field that offers it (a setting, not a record's initial value), unless the
-// change line already says what it was.
+
 const showsDefault = computed(
   () =>
     !!props.field.offersDefault &&
@@ -36,20 +35,21 @@ const showsDefault = computed(
     !sameFormValue(baseline.value, defaultValue.value),
 );
 
-// Values that do not fit a line, or must not show: "Changed" alone.
 const UNWORDED_TYPES = new Set(["password", "code", "rich_text"]);
 
 /** A value as the field's type words it, or nothing when it cannot. */
-function wordValue(raw: unknown): VNodeChild | undefined {
+function wordValue(
+  raw: Parameters<DataTypeFormatter>[0],
+): VNodeChild | undefined {
   if (UNWORDED_TYPES.has(props.field.type ?? "")) return undefined;
   const dataType = props.field.type ? getDataType(props.field.type) : undefined;
   if (dataType?.displayComponent && !dataType.formatter) return undefined;
   const formatter = dataType?.formatter?.default;
   if (formatter) {
     const worded = formatter(raw, locale.value, props.field.component.options);
-    return isVNode(worded) || typeof worded === "string" ? worded : undefined;
+    return isVNode(worded) || isString(worded) ? worded : undefined;
   }
-  if (typeof raw === "string" || typeof raw === "number") return String(raw);
+  if (isString(raw) || isNumber(raw)) return String(raw);
   return undefined;
 }
 

package/frontend-vue/layers/dms-ui/app/build/components/form/FormLoadError.vue

@@ -4,9 +4,6 @@ import DmsEmptyState, {
 } from "../../../components/empty-state/EmptyState.vue";
 import type { FormLoadFailure } from "../../composables/form/formRecordLoad";
 
-// What a form shows instead of its fields when the record it edits did not
-// load: empty fields would read as the record, and a save from them would
-// replace values the form never showed.
 interface FormLoadErrorProps {
   failure: FormLoadFailure;
   /** Set while the record is being loaded again. */
@@ -30,8 +27,7 @@ const VARIANTS: Record<FormLoadFailure, EmptyStateVariant> = {
   not_found: "no-result",
   error: "error",
 };
-// A record the address names none of, or one that does not exist, is not
-// read again by trying.
+
 const RETRIES = new Set<FormLoadFailure>(["forbidden", "error"]);
 </script>
 

package/frontend-vue/layers/dms-ui/app/build/components/form/FormSectionNav.vue

@@ -31,8 +31,6 @@ const { processI18n } = useTranslation();
  */
 type FormSectionNavLayout = FormSectionNavVariant | "chipGroups";
 
-// A row of chips with no group keeps its one scrolling line; with groups, the
-// runs wrap, each led by its label.
 const GROUPS_CLASSES: Record<FormSectionNavLayout, string> = {
   list: "flex flex-col gap-4",
   chips: "",
@@ -63,8 +61,6 @@ const ITEM_CLASSES: Record<FormSectionNavVariant, string> = {
     "border-default text-muted hover:text-default flex h-7 shrink-0 items-center gap-1.5 rounded-full border px-3 text-[12.5px]",
 };
 
-// The current section carries a mark of its own, so the entry under the
-// pointer never reads as a second current one.
 const ACTIVE_CLASSES: Record<FormSectionNavVariant, string> = {
   list: "bg-elevated text-highlighted font-[550] shadow-[inset_2px_0_0_var(--ui-primary)]",
   chips: "border-accented bg-elevated text-highlighted",

package/frontend-vue/layers/dms-ui/app/build/components/form/FormSections.vue

@@ -19,14 +19,10 @@ interface FormSectionsProps {
 
 const props = defineProps<FormSectionsProps>();
 
-// A section is current once its top passes this line, a third of the way
-// down the visible area: the one being read, not the one merely peeking in
-// at the bottom.
 const READING_LINE_RATIO = 0.35;
-// A scroll this close to the end is at the end (subpixel rounding).
+
 const END_TOLERANCE_PX = 2;
-// A picked section stays current until the scroll it started has settled:
-// on its way, the smooth scroll passes the sections in between.
+
 const SCROLL_SETTLE_MS = 150;
 
 const activeId = ref(props.layout.sections[0]?.id);
@@ -61,8 +57,6 @@ interface SpyViewport {
   isAtEnd: boolean;
 }
 
-// Scrolled at all, and to the end: a form that fits never scrolls, and its
-// first section stays current.
 function isScrolledToEnd(
   scrollTop: number,
   height: number,
@@ -113,9 +107,6 @@ function updateActiveSection(): void {
 
 let frame: number | undefined;
 
-// Captured on the document: whichever container scrolls the form (the page
-// body, a drawer, the window) reports here, even one that only became
-// scrollable once the form loaded.
 function onScroll(): void {
   if (isPicked) {
     holdPicked();

package/frontend-vue/layers/dms-ui/app/build/components/form/OtpInput.vue

@@ -4,10 +4,6 @@ import DmsFieldError from "../../../components/field-error/FieldError.vue";
 import { fieldErrorId } from "#dms-core/app/composables/useFieldErrors";
 import { focusFirstEmptyCell } from "../../utils/codeCells";
 
-// The one code entry of the DMS (sign-in and e-mail codes, two-factor codes
-// in the security settings): UPinInput cells, the refused code's message
-// under them.
-
 type OtpInputSize = "md" | "lg" | "xl";
 
 interface OtpInputProps {
@@ -29,8 +25,6 @@ interface OtpInputProps {
 
 const DEFAULT_CODE_LENGTH = 6;
 
-// Six cells at their desktop size outgrow a 320px card or modal: on a phone
-// they narrow and close up.
 const PHONE_UI: Record<OtpInputSize, { root: string; base: string }> = {
   md: { root: "max-sm:gap-1", base: "max-sm:w-8" },
   lg: { root: "max-sm:gap-1", base: "max-sm:w-8" },

package/frontend-vue/layers/dms-ui/app/build/components/form/PasswordInput.vue

@@ -1,12 +1,8 @@
 <script setup lang="ts">
 import { computed, useAttrs } from "vue";
+import { isString } from "#dms-core/app/utils/type-check";
 import type { InputProps } from "@nuxt/ui/components/Input.vue";
 
-// The one password input of the DMS (sign-in, new password, security
-// settings, the form's PasswordType): a UInput whose Phosphor eye toggles
-// the value's visibility. Attributes (`id`, `autocomplete`, `placeholder`,
-// `size`, `aria-describedby`, listeners) go to the UInput.
-
 interface PasswordInputProps {
   /** Rings the field in the error ink and marks it invalid. */
   invalid?: boolean;
@@ -41,12 +37,10 @@ const INVALID_BINDINGS = {
 
 const attrs = useAttrs();
 const controlledId = computed(() =>
-  typeof attrs.id === "string" ? attrs.id : undefined,
+  isString(attrs.id) ? attrs.id : undefined,
 );
 const { t } = useI18n();
 
-// Built on the attributes, not after them: a colour or an icon the caller
-// passes stays unless this input has its own.
 const inputBindings = computed(() => ({
   ...attrs,
   type: isVisible.value ? "text" : "password",

package/frontend-vue/layers/dms-ui/app/build/components/form/SearchInput.vue

@@ -13,11 +13,6 @@ import {
   useKeyboardPlatform,
 } from "../../../composables/global/keyboardPlatform";
 
-// The one search field of the DMS (settings menu, pages, lists, tables): a
-// UInput with the magnifier, named by its placeholder, and the keys that
-// focus it as a hint. Attributes (`id`, `size`, `class`, listeners) go to
-// the UInput.
-
 /**
  * The keys that focus the field: `nav` is "/" (the navigation search, one
  * per page), `page` is ⌘ / or Ctrl / (a page's own search).

package/frontend-vue/layers/dms-ui/app/build/components/form/UnsavedStatus.vue

@@ -1,7 +1,4 @@
 <script setup lang="ts">
-// "Unsaved changes" with its amber dot: the save bar's status, and the
-// footer of a form that keeps its own buttons (a security panel).
-
 interface UnsavedStatusProps {
   /** What is unsaved; empty, the line keeps its place (a hidden save bar). */
   text: string;

package/frontend-vue/layers/dms-ui/app/build/components/modal/ModalEscHint.vue

@@ -1,7 +1,4 @@
 <script setup lang="ts">
-// The "Esc to cancel" hint at the start of a modal footer. It takes the room
-// the buttons leave and shows only when it fits there whole: long button
-// labels push it out instead of squeezing it onto two lines past the edge.
 interface ModalEscHintProps {
   label: string;
 }

package/frontend-vue/layers/dms-ui/app/build/components/period/PeriodRangeCalendar.vue

@@ -25,9 +25,6 @@ import {
   isBeyondMaxDays,
 } from "../../composables/period/periodDisplay";
 
-// Two-month range calendar of the period selector (design .cal): a
-// continuous accent strip for the selected range with filled endpoints, and
-// the comparison range painted under it as a violet strip with ringed ends.
 interface Props {
   modelValue: CalendarRange | null;
   compareRange?: CalendarRange | null;
@@ -63,13 +60,8 @@ const WEEKDAY_LABEL_LENGTH = 2;
 
 const todayDate = today(getLocalTimeZone());
 
-// Day being picked: the first click of a new range, until the second lands.
-// shallowRef: a deep ref would unwrap the date classes (losing their private
-// fields) and break their types.
 const pendingStart = shallowRef<CalendarDate | null>(null);
 
-// The range's last month sits on the right, the month before it on its
-// left: a trailing range reads against what came just before.
 function firstVisibleMonth(range: CalendarRange | null): CalendarDate {
   const anchor = (range?.end ?? todayDate).set({ day: 1 });
   return anchor.subtract({ months: props.numberOfMonths - 1 });
@@ -77,8 +69,6 @@ function firstVisibleMonth(range: CalendarRange | null): CalendarDate {
 
 const placeholder = shallowRef<DateValue>(firstVisibleMonth(props.modelValue));
 
-// The view follows the range when it changes from outside (a preset, the
-// date fields), not while the reader pages through months.
 watch(
   () => props.modelValue,
   (range) => {
@@ -103,7 +93,9 @@ const rekaValue = computed<DateRange>(() =>
 );
 
 function onUpdate(value: DateRange | null) {
+  // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- Reka's DateRange admits other DateValue variants; retain unchecked event forwarding without converting or rejecting those variants.
   const start = value?.start as CalendarDate | undefined;
+  // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- Reka's DateRange admits other DateValue variants; retain unchecked event forwarding and read end before testing start.
   const end = value?.end as CalendarDate | undefined;
   if (start && end) {
     pendingStart.value = null;
@@ -118,13 +110,12 @@ function onUpdate(value: DateRange | null) {
 function isDateDisabled(date: DateValue): boolean {
   const picked = pendingStart.value;
   return (
+    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- Reka supplies DateValue while the range helper accepts CalendarDate; preserve unchecked forwarding and short-circuiting instead of adding variant validation.
     !!picked && isBeyondMaxDays(date as CalendarDate, picked, props.maxDays)
   );
 }
 
 function onPlaceholder(value: DateValue) {
-  // Picking a start day re-anchors reka's view on it; with two months on
-  // screen that would shift the grid under the pointer.
   if (pendingStart.value && isSameMonth(value, pendingStart.value)) return;
   placeholder.value = value;
 }
@@ -160,8 +151,6 @@ const selection = computed<CalendarRange | null>(() =>
 const STRIP_RADIUS_START = "rounded-s-lg";
 const STRIP_RADIUS_END = "rounded-e-lg";
 
-// The strip lives on the cell: accent for the range, violet for the
-// comparison, rounded where it starts or breaks (row ends, month ends).
 function cellClass(
   date: DateValue,
   month: DateValue,
@@ -212,6 +201,7 @@ function triggerClass(date: DateValue): (string | false)[] {
   ];
 }
 
+// oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- This public prop remains Number at runtime and accepts unchecked numbers; narrowing its declaration or validating values would change the existing contract.
 const weekStart = computed(() => props.weekStartsOn as WeekStart);
 </script>
 

package/frontend-vue/layers/dms-ui/app/build/components/permission/PermissionVeil.vue

@@ -2,17 +2,6 @@
 import { tv } from "tailwind-variants";
 import { computed } from "vue";
 
-// Block permission veil (v2 card "Locked"): shows what a role would lose on a
-// block without taking the block away.
-// - hidden: the content stays in place but inert under a hatched veil, with a
-//   centred error lock badge.
-// - readonly / limited: the content is untouched; a warning badge sits on the
-//   top-right edge, its tooltip naming what is withheld.
-// - partial (an entry to a page the role opens without all of it, e.g. a
-//   settings card): the content stays usable under a light warning hatch,
-//   with a warning lock badge on the top-right edge.
-// Without a state the slot renders alone, with no wrapper element, unless the
-// veil is `persistent`.
 interface Props {
   state?: "hidden" | "readonly" | "limited" | "partial" | null;
   /** Badge text, e.g. "Hidden for Support". */
@@ -59,14 +48,11 @@ const veil = tv({
           "text-error top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 border-(--dms-error-line) bg-(--dms-error-tint)",
       },
       false: {
-        // On the block's top edge rather than inside it, so it never covers
-        // the block's own toolbar; opaque, so the edge does not show through.
         badge:
           "text-warning -top-3 right-4 border-(--dms-warning-line) [background:linear-gradient(var(--dms-warning-tint),var(--dms-warning-tint)),var(--ui-bg)]",
       },
     },
-    // The content stays reachable: the hatch lets every pointer through and
-    // leaves the text readable (no blur).
+
     partial: {
       true: {
         root: "rounded-(--dms-radius-card)",

package/frontend-vue/layers/dms-ui/app/build/components/skeleton/RowSkeleton.vue

@@ -1,8 +1,4 @@
 <script setup lang="ts">
-// The placeholder of a list row while it loads: an icon well and a few text
-// lines, each sized like the row it stands for so nothing moves once the
-// rows arrive. The padding is the caller's (`class`).
-
 interface RowSkeletonProps {
   /** Classes of the icon well: its size and radius. */
   well: string;

package/frontend-vue/layers/dms-ui/app/build/components/sortable/SortableList.vue

@@ -39,7 +39,10 @@ const props = defineProps<{
 
 const emit = defineEmits<{ change: [change: SortableListChange<Item>] }>();
 
-defineSlots<{ item(props: { element: Item; index: number }): unknown }>();
+defineSlots<{
+  // oxlint-disable-next-line anti-slop/no-unknown-returns -- Vue's Slot return type narrows this existing consumer-provided slot contract; preserve the unrestricted return annotation.
+  item(props: { element: Item; index: number }): unknown;
+}>();
 
 /** What this list reads of SortableJS's events. */
 interface SortableEvent {
@@ -76,7 +79,7 @@ const { option } = useSortable(root, list, {
   disabled: props.disabled,
   handle: props.handle,
   filter: props.filter,
-  // A filtered item still gets its click: a locked card opens like the others.
+
   preventOnFilter: false,
   ghostClass: props.ghostClass,
   dragClass: props.dragClass,
@@ -97,10 +100,11 @@ const { option } = useSortable(root, list, {
     emit("change", { moved: { element, oldIndex, newIndex } });
   },
   onAdd: (event: SortableEvent) => {
+    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- A group can join independently typed lists; this existing cast does not validate the source item's type.
     const element = sharedDragged.get(draggedKey()) as Item | undefined;
     const { newIndex } = event;
     if (element === undefined || newIndex === undefined) return;
-    // The element goes back to the list it left, which removes it below.
+
     event.item.remove();
     const next = [...list.value];
     next.splice(newIndex, 0, element);
@@ -129,9 +133,6 @@ watch(
 </script>
 
 <script lang="ts">
-// The item being dragged, by group. A drop on another list only names the
-// element, which belongs to the list it left: the list it lands in reads the
-// item the other one stored when the drag started.
 const sharedDragged = new Map<string, unknown>();
 </script>