@jskit-ai/users-web 0.1.165 → 0.1.168

package/src/client/composables/crud/crudSchemaFormHelpers.js

@@ -69,12 +69,20 @@ function toTimeInputValue(value) {
     return "";
   }
 
-  const twentyFourHourMatch = normalized.match(/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/u);
+  const twentyFourHourMatch = normalized.match(/^(\d{1,2}):(\d{2})(?::(\d{2})(\.\d+)?)?$/u);
   if (twentyFourHourMatch) {
     const hours = Number(twentyFourHourMatch[1]);
     const minutes = Number(twentyFourHourMatch[2]);
-    if (hours >= 0 && hours <= 23 && minutes >= 0 && minutes <= 59) {
-      return `${padDateTimePart(hours)}:${padDateTimePart(minutes)}`;
+    const seconds = Number(twentyFourHourMatch[3] || 0);
+    if (
+      hours >= 0 && hours <= 23 &&
+      minutes >= 0 && minutes <= 59 &&
+      seconds >= 0 && seconds <= 59
+    ) {
+      const secondsValue = twentyFourHourMatch[3]
+        ? `:${padDateTimePart(seconds)}${twentyFourHourMatch[4] || ""}`
+        : "";
+      return `${padDateTimePart(hours)}:${padDateTimePart(minutes)}${secondsValue}`;
     }
     return normalized;
   }
@@ -103,16 +111,30 @@ function toDateTimeLocalInputValue(value) {
     return "";
   }
 
+  const sourceText = typeof value === "string" ? value.trim() : "";
+  const sourceFraction = sourceText.match(/T\d{2}:\d{2}:\d{2}\.(\d+)/u)?.[1] || "";
   const date = value instanceof Date ? value : new Date(value);
   if (Number.isNaN(date.getTime())) {
     return String(value);
   }
 
-  return [
+  const minuteValue = [
     date.getFullYear(),
     padDateTimePart(date.getMonth() + 1),
     padDateTimePart(date.getDate())
   ].join("-") + `T${padDateTimePart(date.getHours())}:${padDateTimePart(date.getMinutes())}`;
+  if (sourceFraction && !/^0+$/u.test(sourceFraction)) {
+    return `${minuteValue}:${padDateTimePart(date.getSeconds())}.${sourceFraction}`;
+  }
+
+  const milliseconds = date.getMilliseconds();
+  if (milliseconds > 0) {
+    return `${minuteValue}:${padDateTimePart(date.getSeconds())}.${String(milliseconds).padStart(3, "0")}`;
+  }
+  if (date.getSeconds() > 0) {
+    return `${minuteValue}:${padDateTimePart(date.getSeconds())}`;
+  }
+  return minuteValue;
 }
 
 function toDateInputValue(value) {
@@ -146,7 +168,31 @@ function toDateInputValue(value) {
   return normalized;
 }
 
-function toIsoUtcDateTimeValue(value) {
+function applyDateTimePrecision(isoValue, temporalPrecision) {
+  if (!Number.isInteger(temporalPrecision) || temporalPrecision < 0) {
+    return isoValue;
+  }
+
+  const match = String(isoValue || "").match(/^(.*?)(?:\.(\d+))?Z$/u);
+  if (!match?.[2]) {
+    return isoValue;
+  }
+
+  const fraction = match[2];
+  if (fraction.length <= temporalPrecision) {
+    return isoValue;
+  }
+
+  const excess = fraction.slice(temporalPrecision);
+  if (!/^0+$/u.test(excess)) {
+    return isoValue;
+  }
+
+  const retained = fraction.slice(0, temporalPrecision);
+  return `${match[1]}${retained ? `.${retained}` : ""}Z`;
+}
+
+function toIsoUtcDateTimeValue(value, temporalPrecision) {
   const normalized = String(value ?? "").trim();
   if (!normalized) {
     return "";
@@ -157,7 +203,12 @@ function toIsoUtcDateTimeValue(value) {
     return normalized;
   }
 
-  return date.toISOString();
+  const sourceFraction = normalized.match(/T\d{2}:\d{2}:\d{2}\.(\d+)/u)?.[1] || "";
+  const dateIsoValue = date.toISOString();
+  const preciseIsoValue = sourceFraction
+    ? dateIsoValue.replace(/\.\d{3}Z$/u, `.${sourceFraction}Z`)
+    : dateIsoValue;
+  return applyDateTimePrecision(preciseIsoValue, temporalPrecision);
 }
 
 function resolveFormFieldInitialValue(field = {}) {
@@ -278,7 +329,7 @@ function buildCrudFormPayload(fields = [], model = {}) {
     }
 
     if (fieldFormat === "date-time") {
-      const normalizedValue = toIsoUtcDateTimeValue(rawValue);
+      const normalizedValue = toIsoUtcDateTimeValue(rawValue, field.temporalPrecision);
       if (!normalizedValue) {
         if (clearAsNull) {
           payload[fieldKey] = null;

package/src/client/composables/useCrudDeleteAction.js

@@ -0,0 +1,160 @@
+import { computed, proxyRefs, ref, unref } from "vue";
+import { useRouter } from "vue-router";
+import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
+import { resolveCrudJsonApiTransport } from "./crud/crudJsonApiTransportSupport.js";
+import { toQueryErrorMessage } from "./support/errorMessageHelpers.js";
+import { useCommand } from "./useCommand.js";
+
+function requireCrudDeleteOperation(resource = null) {
+  const operation = resource?.operations?.delete;
+  if (!operation || typeof operation !== "object" || Array.isArray(operation)) {
+    throw new TypeError("useCrudDeleteAction requires resource.operations.delete.");
+  }
+  if (normalizeText(operation.method).toUpperCase() !== "DELETE") {
+    throw new TypeError("useCrudDeleteAction requires resource.operations.delete.method to be DELETE.");
+  }
+  return operation;
+}
+
+function requireCrudViewScreen(screen = null) {
+  if (!screen || typeof screen !== "object" || typeof screen?.view?.resolveParams !== "function") {
+    throw new TypeError("useCrudDeleteAction requires a useCrudViewScreen() result.");
+  }
+  return screen;
+}
+
+function resolveDeleteApiSuffix(screen, apiUrlTemplate = "") {
+  const template = normalizeText(unref(apiUrlTemplate));
+  return template ? normalizeText(screen.view.resolveParams(template)) : "";
+}
+
+function resolveListLocation(screen) {
+  return unref(screen?.listLocation) || null;
+}
+
+function useCrudDeleteAction({
+  screen = null,
+  resource = null,
+  resourceNamespace = "",
+  apiUrlTemplate = "",
+  access = "auto",
+  client = null,
+  router: routerOverride = null,
+  fallbackDeleteError = "Unable to delete record."
+} = {}) {
+  const resolvedScreen = requireCrudViewScreen(screen);
+  const deleteOperation = requireCrudDeleteOperation(resource);
+  const namespace = normalizeText(resourceNamespace, {
+    fallback: resource?.namespace
+  });
+  if (!namespace) {
+    throw new TypeError("useCrudDeleteAction requires resourceNamespace or resource.namespace.");
+  }
+
+  const activeRouter = routerOverride || useRouter();
+  if (!activeRouter || typeof activeRouter.push !== "function") {
+    throw new TypeError("useCrudDeleteAction requires an installed Vue Router.");
+  }
+
+  const isOpen = ref(false);
+  const error = ref("");
+  const deleteApiSuffix = computed(() => resolveDeleteApiSuffix(resolvedScreen, apiUrlTemplate));
+
+  async function handleDeleteSuccess(_response, context = {}) {
+    await context?.queryClient?.invalidateQueries?.({
+      queryKey: ["ui-generator", namespace]
+    });
+
+    const listLocation = resolveListLocation(resolvedScreen);
+    if (!listLocation) {
+      throw new Error("Deleted the record, but the generated list route is unavailable.");
+    }
+
+    isOpen.value = false;
+    await activeRouter.push(listLocation);
+  }
+
+  function handleDeleteError(cause) {
+    error.value = toQueryErrorMessage(
+      cause,
+      fallbackDeleteError,
+      "Unable to delete record."
+    );
+  }
+
+  const command = useCommand({
+    access,
+    apiSuffix: deleteApiSuffix,
+    writeMethod: deleteOperation.method,
+    client,
+    transport: resolveCrudJsonApiTransport(undefined, resource, {
+      mode: "delete"
+    }),
+    placementSource: `ui-generator.${namespace}.view.delete`,
+    fallbackRunError: fallbackDeleteError,
+    onRunSuccess: handleDeleteSuccess,
+    onRunError: handleDeleteError,
+    suppressSuccessMessage: true
+  });
+
+  const isDeleting = computed(() => Boolean(command.isRunning));
+  const canDelete = computed(() => {
+    const view = resolvedScreen.view;
+    return Boolean(
+      command.canRun &&
+      deleteApiSuffix.value &&
+      resolveListLocation(resolvedScreen) &&
+      unref(view.recordId) &&
+      unref(view.record) &&
+      !unref(view.isLoading) &&
+      !unref(view.isNotFound)
+    );
+  });
+
+  function request() {
+    if (!canDelete.value) {
+      return false;
+    }
+    error.value = "";
+    isOpen.value = true;
+    return true;
+  }
+
+  function cancel() {
+    if (isDeleting.value) {
+      return false;
+    }
+    error.value = "";
+    isOpen.value = false;
+    return true;
+  }
+
+  async function confirm() {
+    if (!isOpen.value || !canDelete.value || isDeleting.value) {
+      return null;
+    }
+
+    error.value = "";
+    try {
+      return await command.run();
+    } catch {
+      return null;
+    }
+  }
+
+  return proxyRefs({
+    isOpen,
+    isDeleting,
+    canDelete,
+    error,
+    request,
+    cancel,
+    confirm
+  });
+}
+
+export {
+  requireCrudDeleteOperation,
+  resolveDeleteApiSuffix,
+  useCrudDeleteAction
+};

package/src/client/index.js

@@ -3,6 +3,7 @@ import { UsersWebClientProvider } from "./providers/UsersWebClientProvider.js";
 export { UsersWebClientProvider } from "./providers/UsersWebClientProvider.js";
 export { default as AccountSettingsClientElement } from "./components/AccountSettingsClientElement.vue";
 export { default as CrudAddEditScreen } from "./components/CrudAddEditScreen.vue";
+export { default as CrudDeleteAction } from "./components/CrudDeleteAction.vue";
 export { default as CrudListBulkActionSurface } from "./components/CrudListBulkActionSurface.vue";
 export { default as CrudListFilterSurface } from "./components/CrudListFilterSurface.vue";
 export { default as CrudListScreen } from "./components/CrudListScreen.vue";
@@ -11,6 +12,7 @@ export {
   normalizeCrudApiAccess,
   resolveCrudHttpClient
 } from "./composables/crud/crudHttpClientSupport.js";
+export { useCrudDeleteAction } from "./composables/useCrudDeleteAction.js";
 
 const clientProviders = Object.freeze([UsersWebClientProvider]);
 

package/test/crudJsonApiTransportSupport.test.js

@@ -69,6 +69,19 @@ test("inferCrudJsonApiTransport infers record request/response transport for CRU
   );
 });
 
+test("inferCrudJsonApiTransport infers record response transport for CRUD delete", () => {
+  assert.deepEqual(
+    inferCrudJsonApiTransport(resource, {
+      mode: "delete"
+    }),
+    {
+      kind: "jsonapi-resource",
+      responseType: "pets",
+      responseKind: "record"
+    }
+  );
+});
+
 test("inferCrudLookupJsonApiTransport infers collection transport from lookup namespace", () => {
   assert.deepEqual(
     inferCrudLookupJsonApiTransport({

package/test/crudListDateFilterSurface.browser.test.js

@@ -1,99 +1,22 @@
 import assert from "node:assert/strict";
-import { spawn } from "node:child_process";
-import net from "node:net";
 import path from "node:path";
 import process from "node:process";
 import test from "node:test";
 import { fileURLToPath } from "node:url";
 import { chromium } from "@playwright/test";
+import {
+  createChromiumLaunchOptions,
+  startViteFixture,
+  stopProcess
+} from "../../../tooling/testUtils/browserFixture.mjs";
 
 const TEST_DIRECTORY = path.dirname(fileURLToPath(import.meta.url));
-const REPOSITORY_ROOT = path.resolve(TEST_DIRECTORY, "../../..");
 const PACKAGE_ROOT = path.resolve(TEST_DIRECTORY, "..");
 const FIXTURE_ROOT = path.join(PACKAGE_ROOT, "fixtures", "crud-list-date-filters");
-const VITE_CLI = path.join(REPOSITORY_ROOT, "node_modules", "vite", "bin", "vite.js");
 const RUN_BROWSER_TEST = process.env.JSKIT_USERS_WEB_DATE_FILTER_VISUAL_INTEGRATION === "1";
 const VIEWPORT_WIDTHS = Object.freeze([375, 768, 1280, 1440]);
 const QUERY = "?status=active&submittedOn=2026-04-18&arrivalDate=2026-05-04..2026-05-10";
 
-function startCapturedProcess(command, args, { cwd } = {}) {
-  const child = spawn(command, args, {
-    cwd,
-    stdio: ["ignore", "pipe", "pipe"],
-    env: {
-      ...process.env,
-      NO_COLOR: "1",
-      FORCE_COLOR: "0"
-    }
-  });
-  let output = "";
-
-  child.stdout.on("data", (chunk) => {
-    output += chunk.toString("utf8");
-  });
-  child.stderr.on("data", (chunk) => {
-    output += chunk.toString("utf8");
-  });
-
-  function waitFor(pattern, timeout = 30_000) {
-    return new Promise((resolve, reject) => {
-      const startedAt = Date.now();
-      const timer = setInterval(() => {
-        if (pattern.test(output)) {
-          clearInterval(timer);
-          resolve();
-          return;
-        }
-        if (child.exitCode !== null) {
-          clearInterval(timer);
-          reject(new Error(`Vite exited before ${pattern}.\n${output}`));
-          return;
-        }
-        if (Date.now() - startedAt >= timeout) {
-          clearInterval(timer);
-          reject(new Error(`Timed out waiting for ${pattern}.\n${output}`));
-        }
-      }, 50);
-    });
-  }
-
-  return {
-    child,
-    readOutput: () => output,
-    waitFor
-  };
-}
-
-async function stopProcess(runtime) {
-  const child = runtime?.child;
-  if (!child || child.exitCode !== null || child.signalCode !== null) {
-    return;
-  }
-
-  await new Promise((resolve) => {
-    const forceTimer = setTimeout(() => child.kill("SIGKILL"), 5_000);
-    child.once("exit", () => {
-      clearTimeout(forceTimer);
-      resolve();
-    });
-    child.kill("SIGTERM");
-  });
-}
-
-async function reservePort() {
-  const server = net.createServer();
-  await new Promise((resolve, reject) => {
-    server.once("error", reject);
-    server.listen(0, "127.0.0.1", resolve);
-  });
-  const address = server.address();
-  assert.ok(address && typeof address === "object");
-  await new Promise((resolve, reject) => {
-    server.close((error) => error ? reject(error) : resolve());
-  });
-  return address.port;
-}
-
 async function readContract(page) {
   return JSON.parse(await page.getByTestId("date-filter-contract").textContent());
 }
@@ -108,7 +31,7 @@ async function openCompactFilters(page) {
 
 async function assertResponsiveDateControls(page, width) {
   await page.setViewportSize({ width, height: 900 });
-  await page.goto(`http://127.0.0.1:${page.__jskitPort}/${QUERY}`, {
+  await page.goto(`/${QUERY}`, {
     waitUntil: "networkidle"
   });
   await openCompactFilters(page);
@@ -158,37 +81,23 @@ test("CRUD date filters render and operate without clipping across responsive la
     : "set JSKIT_USERS_WEB_DATE_FILTER_VISUAL_INTEGRATION=1 to run the browser visual regression",
   timeout: 180_000
 }, async () => {
-  const port = await reservePort();
-  const viteRuntime = startCapturedProcess(process.execPath, [
-    VITE_CLI,
-    "--config",
-    path.join(FIXTURE_ROOT, "vite.config.mjs"),
-    "--port",
-    String(port),
-    "--clearScreen",
-    "false"
-  ], { cwd: FIXTURE_ROOT });
+  const viteRuntime = await startViteFixture({ fixtureRoot: FIXTURE_ROOT });
   let browser = null;
 
   try {
-    await viteRuntime.waitFor(new RegExp(`http://127\\.0\\.0\\.1:${port}/`, "u"));
-    const chromiumExecutablePath = String(
-      process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH || ""
-    ).trim();
-    browser = await chromium.launch({
-      headless: true,
-      ...(chromiumExecutablePath ? { executablePath: chromiumExecutablePath } : {})
+    browser = await chromium.launch(createChromiumLaunchOptions());
+    const context = await browser.newContext({
+      baseURL: viteRuntime.baseURL,
+      locale: "en-US"
     });
-    const context = await browser.newContext({ locale: "en-US" });
     const page = await context.newPage();
-    page.__jskitPort = port;
 
     for (const width of VIEWPORT_WIDTHS) {
       await assertResponsiveDateControls(page, width);
     }
 
     await page.setViewportSize({ width: 1280, height: 900 });
-    await page.goto(`http://127.0.0.1:${port}/${QUERY}`, { waitUntil: "networkidle" });
+    await page.goto(`/${QUERY}`, { waitUntil: "networkidle" });
     assert.deepEqual(await readContract(page), {
       values: {
         submittedOn: "2026-04-18",

package/test/crudScreenComponents.test.js

@@ -19,6 +19,7 @@ test("CRUD screen components own generated list/view/form chrome centrally", asy
   const listSource = await readComponent("CrudListScreen.vue");
   const viewSource = await readComponent("CrudViewScreen.vue");
   const addEditSource = await readComponent("CrudAddEditScreen.vue");
+  const deleteActionSource = await readComponent("CrudDeleteAction.vue");
 
   assert.match(listSource, /CrudListBulkActionSurface/);
   assert.match(listSource, /CrudListFilterSurface/);
@@ -36,7 +37,10 @@ test("CRUD screen components own generated list/view/form chrome centrally", asy
   );
   assert.match(listSource, /button-label="More"/);
   assert.match(listSource, /selectableRows/);
-  assert.match(listSource, /min-height:\s*48px/);
+  assert.match(
+    listSource,
+    /\.ui-generator-list-element :deep\(\.v-btn\)\s*\{\s*min-height:\s*48px;/
+  );
   assert.match(listSource, /<slot[\s\S]*name="card-fields"/);
   assert.match(listSource, /<slot name="table-header"/);
   assert.match(listSource, /<slot[\s\S]*name="table-row"/);
@@ -45,6 +49,7 @@ test("CRUD screen components own generated list/view/form chrome centrally", asy
   assert.match(viewSource, /generated-ui-screen generated-ui-screen--operator ui-generator-view-element/);
   assert.match(viewSource, /ui-generator-view-panel/);
   assert.match(viewSource, /@click="view\.refresh"/);
+  assert.match(viewSource, /<slot name="actions" :screen="screen" :view="view" \/>/);
   assert.match(viewSource, /<slot name="before-fields"/);
   assert.match(viewSource, /<slot name="fields"/);
   assert.match(viewSource, /<slot name="after-fields"/);
@@ -54,6 +59,11 @@ test("CRUD screen components own generated list/view/form chrome centrally", asy
   assert.match(addEditSource, /addEdit\.canRetryLoad/);
   assert.match(addEditSource, /@click="addEdit\.refresh"/);
   assert.match(addEditSource, /<slot[\s\S]*name="fields"/);
+
+  assert.match(deleteActionSource, /@click="action\.request"/);
+  assert.match(deleteActionSource, /@click="action\.confirm"/);
+  assert.match(deleteActionSource, /@click="closeDialog"/);
+  assert.doesNotMatch(deleteActionSource, /\bactivator=/);
 });
 
 test("CRUD screen composables expose generated page extension inputs", async () => {
@@ -87,13 +97,15 @@ test("CRUD screen composables are importable package APIs", async () => {
     viewModule,
     addEditModule,
     rowActionsModule,
-    rowActionsRuntimeModule
+    rowActionsRuntimeModule,
+    deleteActionModule
   ] = await Promise.all([
     import("@jskit-ai/users-web/client/composables/useCrudListScreen"),
     import("@jskit-ai/users-web/client/composables/useCrudViewScreen"),
     import("@jskit-ai/users-web/client/composables/useCrudAddEditScreen"),
     import("@jskit-ai/users-web/client/rowActions"),
-    import("@jskit-ai/users-web/client/composables/useCrudListRowActions")
+    import("@jskit-ai/users-web/client/composables/useCrudListRowActions"),
+    import("@jskit-ai/users-web/client/composables/useCrudDeleteAction")
   ]);
 
   assert.equal(typeof listModule.useCrudListScreen, "function");
@@ -101,4 +113,5 @@ test("CRUD screen composables are importable package APIs", async () => {
   assert.equal(typeof addEditModule.useCrudAddEditScreen, "function");
   assert.equal(typeof rowActionsModule.defineCrudListRowActions, "function");
   assert.equal(typeof rowActionsRuntimeModule.useCrudListRowActions, "function");
+  assert.equal(typeof deleteActionModule.useCrudDeleteAction, "function");
 });

package/test/exportsContract.test.js

@@ -17,6 +17,7 @@ test("users-web exports are explicit and aligned with production/template usage"
       "./client",
       "./client/components/AccountSettingsClientElement",
       "./client/components/CrudAddEditScreen",
+      "./client/components/CrudDeleteAction",
       "./client/components/CrudListBulkActionSurface",
       "./client/components/CrudListFilterSurface",
       "./client/components/CrudListScreen",
@@ -33,6 +34,7 @@ test("users-web exports are explicit and aligned with production/template usage"
       "./client/composables/useView",
       "./client/composables/useCrudAddEdit",
       "./client/composables/useCrudAddEditScreen",
+      "./client/composables/useCrudDeleteAction",
       "./client/composables/useCrudListBulkActions",
       "./client/composables/useCrudListRowActions",
       "./client/composables/useCrudListFilterLookups",

package/test/{packageDescriptorOwnership.test.js → packageMetadataOwnership.test.js}

@@ -1,6 +1,8 @@
 import assert from "node:assert/strict";
 import test from "node:test";
-import descriptor from "../package.descriptor.mjs";
+import packageJson from "../package.json" with { type: "json" };
+
+const packageMetadata = packageJson.jskit;
 
 test("users-web leaves account surface scaffolds app-owned", () => {
   const expectedIds = [
@@ -11,7 +13,7 @@ test("users-web leaves account surface scaffolds app-owned", () => {
   ];
 
   for (const id of expectedIds) {
-    const mutation = descriptor.mutations.files.find((entry) => entry.id === id);
+    const mutation = packageMetadata.mutations.files.find((entry) => entry.id === id);
     assert.ok(mutation, `Missing users-web scaffold mutation ${id}.`);
     assert.equal(mutation.ownership, "app", `${id} must remain app-owned across package updates.`);
   }

package/test/settingsPlacementContract.test.js

@@ -4,13 +4,15 @@ import test from "node:test";
 import { readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { assertGeneratedUiSourceContract } from "@jskit-ai/kernel/shared/support/generatedUiContract";
-import descriptor from "../package.descriptor.mjs";
+import packageJson from "../package.json" with { type: "json" };
+
+const packageMetadata = packageJson.jskit;
 
 const TEST_DIRECTORY = path.dirname(fileURLToPath(import.meta.url));
 const PACKAGE_DIR = path.resolve(TEST_DIRECTORY, "..");
 
 function readOutlets(host = "") {
-  const outlets = descriptor?.metadata?.ui?.placements?.outlets;
+  const outlets = packageMetadata?.metadata?.ui?.placements?.outlets;
   const normalizedTarget = String(host || "").trim();
   return Array.isArray(outlets)
     ? outlets.filter((entry) => String(entry?.target || "").trim() === normalizedTarget)
@@ -18,7 +20,7 @@ function readOutlets(host = "") {
 }
 
 function findTopology(id, owner = "") {
-  const placements = descriptor?.metadata?.ui?.placements?.topology?.placements;
+  const placements = packageMetadata?.metadata?.ui?.placements?.topology?.placements;
   const normalizedId = String(id || "").trim();
   const normalizedOwner = String(owner || "").trim();
   return Array.isArray(placements)
@@ -31,28 +33,28 @@ function findTopology(id, owner = "") {
 }
 
 function findContribution(id) {
-  const contributions = descriptor?.metadata?.ui?.placements?.contributions;
+  const contributions = packageMetadata?.metadata?.ui?.placements?.contributions;
   return Array.isArray(contributions)
     ? contributions.find((entry) => String(entry?.id || "").trim() === id) || null
     : null;
 }
 
 function findTextMutation(id) {
-  const textMutations = descriptor?.mutations?.text;
+  const textMutations = packageMetadata?.mutations?.text;
   return Array.isArray(textMutations)
     ? textMutations.find((entry) => String(entry?.id || "").trim() === id) || null
     : null;
 }
 
 function findSourceMutation(id) {
-  const sourceMutations = descriptor?.mutations?.source;
+  const sourceMutations = packageMetadata?.mutations?.source;
   return Array.isArray(sourceMutations)
     ? sourceMutations.find((entry) => String(entry?.id || "").trim() === id) || null
     : null;
 }
 
 function findFileMutation(id) {
-  const fileMutations = descriptor?.mutations?.files;
+  const fileMutations = packageMetadata?.mutations?.files;
   return Array.isArray(fileMutations)
     ? fileMutations.find((entry) => String(entry?.id || "").trim() === id) || null
     : null;
@@ -197,7 +199,7 @@ test("users-web account settings section templates use direct settings panels",
   }
 });
 
-test("users-web descriptor metadata advertises home cog outlet and standard home settings placements", () => {
+test("users-web packageMetadata metadata advertises home cog outlet and standard home settings placements", () => {
   assert.deepEqual(
     readOutlets("home-cog:primary-menu"),
     [