@jskit-ai/users-web 0.1.31 → 0.1.33

package/src/client/runtime/bootstrapPlacementRuntime.js

@@ -1,10 +1,3 @@
-import {
-  CLIENT_MODULE_ROUTER_TOKEN,
-  CLIENT_MODULE_VUE_APP_TOKEN
-} from "@jskit-ai/kernel/client/moduleBootstrap";
-import { WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN } from "@jskit-ai/shell-web/client/placement";
-import { REALTIME_SOCKET_CLIENT_TOKEN } from "@jskit-ai/realtime/client/tokens";
-import { USERS_BOOTSTRAP_CHANGED_EVENT } from "@jskit-ai/users-core/shared/events/usersEvents";
 import {
   findWorkspaceBySlug,
   normalizeWorkspaceList,
@@ -20,8 +13,6 @@ import {
 } from "../lib/theme.js";
 import { createBootstrapPlacementRouteGuards } from "./bootstrapPlacementRouteGuards.js";
 import {
-  BOOTSTRAP_PLACEMENT_SOURCE,
-  USERS_WEB_BOOTSTRAP_PLACEMENT_RUNTIME_TOKEN,
   WORKSPACE_BOOTSTRAP_STATUS_ERROR,
   WORKSPACE_BOOTSTRAP_STATUS_FORBIDDEN,
   WORKSPACE_BOOTSTRAP_STATUS_NOT_FOUND,
@@ -44,7 +35,7 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
   if (!app || typeof app.has !== "function" || typeof app.make !== "function") {
     throw new Error("createBootstrapPlacementRuntime requires application has()/make().");
   }
-  if (!app.has(WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN)) {
+  if (!app.has("runtime.web-placement.client")) {
     throw new Error("createBootstrapPlacementRuntime requires shell-web placement runtime.");
   }
   if (typeof fetchBootstrap !== "function") {
@@ -52,12 +43,12 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
   }
 
   const runtimeLogger = logger || createProviderLogger(app);
-  const placementRuntime = app.make(WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN);
-  const router = app.has(CLIENT_MODULE_ROUTER_TOKEN) ? app.make(CLIENT_MODULE_ROUTER_TOKEN) : null;
+  const placementRuntime = app.make("runtime.web-placement.client");
+  const router = app.has("jskit.client.router") ? app.make("jskit.client.router") : null;
   let vuetifyThemeController = resolveVuetifyThemeController(
-    app.has(CLIENT_MODULE_VUE_APP_TOKEN) ? app.make(CLIENT_MODULE_VUE_APP_TOKEN) : null
+    app.has("jskit.client.vue.app") ? app.make("jskit.client.vue.app") : null
   );
-  const socket = app.has(REALTIME_SOCKET_CLIENT_TOKEN) ? app.make(REALTIME_SOCKET_CLIENT_TOKEN) : null;
+  const socket = app.has("runtime.realtime.client.socket") ? app.make("runtime.realtime.client.socket") : null;
   const cleanup = [];
   let refreshQueue = Promise.resolve();
   let shutdownRequested = false;
@@ -78,7 +69,7 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
     routeGuards.shutdown();
   });
 
-  function setWorkspaceBootstrapStatus(workspaceSlug = "", status = "", source = BOOTSTRAP_PLACEMENT_SOURCE) {
+  function setWorkspaceBootstrapStatus(workspaceSlug = "", status = "", source = "users-web.bootstrap-placement") {
     const workspaceSlugKey = normalizeWorkspaceSlugKey(workspaceSlug);
     const normalizedStatus = normalizeWorkspaceBootstrapStatus(status);
     if (!workspaceSlugKey || !normalizedStatus) {
@@ -103,7 +94,7 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
     const payload = Object.freeze({
       workspaceSlug: workspaceSlugKey,
       status: normalizedStatus,
-      source: String(source || BOOTSTRAP_PLACEMENT_SOURCE).trim() || BOOTSTRAP_PLACEMENT_SOURCE
+      source: String(source || "users-web.bootstrap-placement").trim() || "users-web.bootstrap-placement"
     });
     for (const listener of workspaceBootstrapStatusListeners) {
       try {
@@ -131,7 +122,7 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
     };
   }
 
-  function writePlacementContext(payload = {}, state = {}, source = BOOTSTRAP_PLACEMENT_SOURCE) {
+  function writePlacementContext(payload = {}, state = {}, source = "users-web.bootstrap-placement") {
     const availableWorkspaces = normalizeWorkspaceList(payload?.workspaces);
     const currentWorkspace = findWorkspaceBySlug(availableWorkspaces, state.workspaceSlug);
     const workspaceSettings =
@@ -162,7 +153,7 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
     applyWorkspaceColorFromPlacementContext("write");
   }
 
-  function clearPlacementContext(source = BOOTSTRAP_PLACEMENT_SOURCE) {
+  function clearPlacementContext(source = "users-web.bootstrap-placement") {
     placementRuntime.setContext(
       {
         workspace: null,
@@ -186,11 +177,11 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
     if (vuetifyThemeController) {
       return vuetifyThemeController;
     }
-    if (!app.has(CLIENT_MODULE_VUE_APP_TOKEN)) {
+    if (!app.has("jskit.client.vue.app")) {
       return null;
     }
 
-    vuetifyThemeController = resolveVuetifyThemeController(app.make(CLIENT_MODULE_VUE_APP_TOKEN));
+    vuetifyThemeController = resolveVuetifyThemeController(app.make("jskit.client.vue.app"));
     return vuetifyThemeController;
   }
 
@@ -267,7 +258,7 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
     }
 
     const stateAtStart = resolveRouteState(placementRuntime, router);
-    const source = `${BOOTSTRAP_PLACEMENT_SOURCE}.${String(reason || "manual").trim() || "manual"}`;
+    const source = `users-web.bootstrap-placement.${String(reason || "manual").trim() || "manual"}`;
     try {
       const payload = await fetchBootstrap(stateAtStart.workspaceSlug);
       const stateAtApply = resolveRouteState(placementRuntime, router);
@@ -433,10 +424,10 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
       const handleBootstrapChanged = () => {
         void queueRefresh("realtime");
       };
-      socket.on(USERS_BOOTSTRAP_CHANGED_EVENT, handleBootstrapChanged);
+      socket.on("users.bootstrap.changed", handleBootstrapChanged);
       cleanup.push(() => {
         if (typeof socket.off === "function") {
-          socket.off(USERS_BOOTSTRAP_CHANGED_EVENT, handleBootstrapChanged);
+          socket.off("users.bootstrap.changed", handleBootstrapChanged);
         }
       });
     }
@@ -463,7 +454,6 @@ function createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap =
 }
 
 export {
-  USERS_WEB_BOOTSTRAP_PLACEMENT_RUNTIME_TOKEN,
   WORKSPACE_BOOTSTRAP_STATUS_RESOLVED,
   WORKSPACE_BOOTSTRAP_STATUS_NOT_FOUND,
   WORKSPACE_BOOTSTRAP_STATUS_FORBIDDEN,

package/src/client/runtime/bootstrapPlacementRuntimeConstants.js

@@ -1,5 +1,3 @@
-const USERS_WEB_BOOTSTRAP_PLACEMENT_RUNTIME_TOKEN = "users.web.bootstrap-placement.runtime";
-const BOOTSTRAP_PLACEMENT_SOURCE = "users-web.bootstrap-placement";
 const WORKSPACE_BOOTSTRAP_STATUS_RESOLVED = "resolved";
 const WORKSPACE_BOOTSTRAP_STATUS_NOT_FOUND = "not_found";
 const WORKSPACE_BOOTSTRAP_STATUS_FORBIDDEN = "forbidden";
@@ -18,9 +16,7 @@ const WORKSPACE_BOOTSTRAP_STATUSES = new Set([
 ]);
 
 export {
-  BOOTSTRAP_PLACEMENT_SOURCE,
   SHELL_GUARD_EVALUATOR_KEY,
-  USERS_WEB_BOOTSTRAP_PLACEMENT_RUNTIME_TOKEN,
   WORKSPACE_BOOTSTRAP_STATUSES,
   WORKSPACE_BOOTSTRAP_STATUS_ERROR,
   WORKSPACE_BOOTSTRAP_STATUS_FORBIDDEN,

package/test/addEditUiRuntime.test.js

@@ -0,0 +1,75 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { ref } from "vue";
+import { createAddEditUiRuntime } from "../src/client/composables/addEditUiRuntime.js";
+
+test("createAddEditUiRuntime resolves api/list/cancel paths from route params", () => {
+  const runtime = createAddEditUiRuntime({
+    recordIdParam: "addressId",
+    routeParams: ref({
+      contactId: "7",
+      addressId: "42"
+    }),
+    routePath: ref("/contacts/7/addresses/new"),
+    apiUrlTemplate: "/crud/contacts/:contactId/addresses/:addressId",
+    viewUrlTemplate: "../:addressId",
+    listUrlTemplate: ".."
+  });
+
+  assert.equal(runtime.recordId.value, "42");
+  assert.equal(runtime.apiSuffix.value, "/crud/contacts/7/addresses/42");
+  assert.equal(runtime.listUrl.value, "/contacts/7/addresses");
+  assert.equal(runtime.cancelUrl.value, "/contacts/7/addresses/42");
+  assert.equal(runtime.resolveParams("../:addressId"), "/contacts/7/addresses/42");
+});
+
+test("createAddEditUiRuntime resolves view urls for saved payload ids with nested params", () => {
+  const runtime = createAddEditUiRuntime({
+    recordIdParam: "addressId",
+    routeParams: ref({
+      contactId: "7"
+    }),
+    viewUrlTemplate: "/contacts/:contactId/addresses/:addressId"
+  });
+
+  assert.equal(runtime.resolveSavedViewUrl({ id: 99 }), "/contacts/7/addresses/99");
+});
+
+test("createAddEditUiRuntime resolves edit-page relative list and cancel links", () => {
+  const runtime = createAddEditUiRuntime({
+    recordIdParam: "addressId",
+    routeParams: ref({
+      contactId: "7",
+      addressId: "42"
+    }),
+    routePath: ref("/contacts/7/addresses/42/edit"),
+    viewUrlTemplate: "..",
+    listUrlTemplate: "../.."
+  });
+
+  assert.equal(runtime.listUrl.value, "/contacts/7/addresses");
+  assert.equal(runtime.cancelUrl.value, "/contacts/7/addresses/42");
+});
+
+test("createAddEditUiRuntime supports custom saved-record selector", () => {
+  const runtime = createAddEditUiRuntime({
+    recordIdParam: "addressId",
+    routeParams: ref({
+      contactId: "7"
+    }),
+    viewUrlTemplate: "/contacts/:contactId/addresses/:addressId",
+    saveRecordIdSelector: (payload = {}) => payload.uuid
+  });
+
+  assert.equal(runtime.resolveSavedViewUrl({ uuid: "abc-123" }), "/contacts/7/addresses/abc-123");
+});
+
+test("createAddEditUiRuntime validates route parameter names", () => {
+  assert.throws(
+    () =>
+      createAddEditUiRuntime({
+        recordIdParam: "record-id"
+      }),
+    /recordIdParam "record-id" is invalid/
+  );
+});

package/test/bootstrapPlacementRuntime.test.js

@@ -1,12 +1,5 @@
 import assert from "node:assert/strict";
 import test from "node:test";
-import {
-  CLIENT_MODULE_ROUTER_TOKEN,
-  CLIENT_MODULE_VUE_APP_TOKEN
-} from "@jskit-ai/kernel/client/moduleBootstrap";
-import { WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN } from "@jskit-ai/shell-web/client/placement";
-import { REALTIME_SOCKET_CLIENT_TOKEN } from "@jskit-ai/realtime/client/tokens";
-import { USERS_BOOTSTRAP_CHANGED_EVENT } from "@jskit-ai/users-core/shared/events/usersEvents";
 import { resolveWorkspaceThemePalette } from "@jskit-ai/users-core/shared/settings";
 import { ThemeSymbol } from "vuetify/lib/composables/theme.js";
 import {
@@ -244,8 +237,8 @@ test("bootstrap placement runtime writes user/workspace/permissions into placeme
   const fetchCalls = [];
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async (workspaceSlug) => {
       fetchCalls.push(workspaceSlug);
@@ -304,8 +297,8 @@ test("bootstrap placement runtime resolves workspace slug from pathname when sur
   const fetchCalls = [];
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async (workspaceSlug) => {
       fetchCalls.push(workspaceSlug);
@@ -348,8 +341,8 @@ test("bootstrap placement runtime does not mutate placement auth context", async
   const router = createRouterStub("/w/acme/dashboard");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       return {
@@ -385,9 +378,9 @@ test("bootstrap placement runtime refetches on route changes and users.bootstrap
   const fetchCalls = [];
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router,
-      [REALTIME_SOCKET_CLIENT_TOKEN]: socket
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router,
+      ["runtime.realtime.client.socket"]: socket
     }),
     fetchBootstrap: async (workspaceSlug) => {
       fetchCalls.push(workspaceSlug);
@@ -424,7 +417,7 @@ test("bootstrap placement runtime refetches on route changes and users.bootstrap
   await flushTasks();
   assert.deepEqual(fetchCalls, ["acme", "zen"]);
 
-  socket.emit(USERS_BOOTSTRAP_CHANGED_EVENT, {});
+  socket.emit("users.bootstrap.changed", {});
   await flushTasks();
   assert.deepEqual(fetchCalls, ["acme", "zen", "zen"]);
 });
@@ -435,8 +428,8 @@ test("bootstrap placement runtime refetches when auth context changes", async ()
   const fetchCalls = [];
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async (workspaceSlug) => {
       fetchCalls.push(workspaceSlug);
@@ -497,9 +490,9 @@ test("bootstrap placement runtime applies persisted theme preference for unauthe
   };
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router,
-      [CLIENT_MODULE_VUE_APP_TOKEN]: createVueAppWithThemeController(themeController)
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router,
+      ["jskit.client.vue.app"]: createVueAppWithThemeController(themeController)
     }),
     fetchBootstrap: async () => {
       return {
@@ -532,10 +525,10 @@ test("bootstrap placement runtime reapplies theme when bootstrap payload changes
   let fetchCount = 0;
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router,
-      [REALTIME_SOCKET_CLIENT_TOKEN]: socket,
-      [CLIENT_MODULE_VUE_APP_TOKEN]: createVueAppWithThemeController(themeController)
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router,
+      ["runtime.realtime.client.socket"]: socket,
+      ["jskit.client.vue.app"]: createVueAppWithThemeController(themeController)
     }),
     fetchBootstrap: async (workspaceSlug) => {
       fetchCount += 1;
@@ -563,7 +556,7 @@ test("bootstrap placement runtime reapplies theme when bootstrap payload changes
   await runtime.initialize();
   assert.equal(themeController.global.name.value, "workspace-dark");
 
-  socket.emit(USERS_BOOTSTRAP_CHANGED_EVENT, {});
+  socket.emit("users.bootstrap.changed", {});
   await flushTasks();
   assert.equal(themeController.global.name.value, "workspace-light");
 });
@@ -574,9 +567,9 @@ test("bootstrap placement runtime applies workspace palette via Vuetify workspac
   const themeController = createVuetifyThemeController("light");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router,
-      [CLIENT_MODULE_VUE_APP_TOKEN]: createVueAppWithThemeController(themeController)
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router,
+      ["jskit.client.vue.app"]: createVueAppWithThemeController(themeController)
     }),
     fetchBootstrap: async (workspaceSlug) => {
       return {
@@ -646,8 +639,8 @@ test("bootstrap placement runtime marks workspace slug as not_found and clears w
 
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: createRouterStub("/w/acme/dashboard")
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: createRouterStub("/w/acme/dashboard")
     }),
     fetchBootstrap: async () => {
       const error = new Error("Workspace not found.");
@@ -674,8 +667,8 @@ test("bootstrap placement runtime updates status per workspace slug across route
   const router = createRouterStub("/w/acme/dashboard");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async (workspaceSlug) => {
       if (workspaceSlug === "zen") {
@@ -721,8 +714,8 @@ test("bootstrap placement runtime uses requestedWorkspace status and keeps globa
   const router = createRouterStub("/w/tonymobily");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       return {
@@ -763,8 +756,8 @@ test("bootstrap placement runtime uses requestedWorkspace=not_found without forc
   const router = createRouterStub("/w/missing");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       return {
@@ -811,8 +804,8 @@ test("bootstrap placement runtime guard wrapper preserves delegated deny outcome
 
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       return {
@@ -854,8 +847,8 @@ test("bootstrap placement runtime guard wrapper blocks forbidden workspace route
 
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       return {
@@ -899,8 +892,8 @@ test("bootstrap placement runtime guard wrapper redirects nested not_found route
   const router = createRouterStub("/w/acme/dashboard");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       const error = new Error("Not found");
@@ -957,8 +950,8 @@ test("bootstrap placement runtime redirects admin nested route to admin root whe
   const router = createRouterStub("/w/acme/admin/workspace/settings");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       const error = new Error("Not found");
@@ -977,8 +970,8 @@ test("bootstrap placement runtime redirects forbidden workspace route to workspa
   const router = createRouterStub("/w/acme/admin/workspace/settings?tab=general");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       const error = new Error("Forbidden");
@@ -1032,8 +1025,8 @@ test("bootstrap placement runtime enforces surface access policies after bootstr
   const router = createRouterStub("/console");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       return {
@@ -1059,8 +1052,8 @@ test("bootstrap placement runtime captures guard evaluator assignments after ini
   const router = createRouterStub("/w/acme/dashboard");
   const runtime = createBootstrapPlacementRuntime({
     app: createAppStub({
-      [WEB_PLACEMENT_RUNTIME_CLIENT_TOKEN]: placementRuntime,
-      [CLIENT_MODULE_ROUTER_TOKEN]: router
+      ["runtime.web-placement.client"]: placementRuntime,
+      ["jskit.client.router"]: router
     }),
     fetchBootstrap: async () => {
       return {

package/test/listUiRuntime.test.js

@@ -0,0 +1,81 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { ref } from "vue";
+import { createListUiRuntime } from "../src/client/composables/listUiRuntime.js";
+
+test("createListUiRuntime resolves row keys and relative route templates from string record ids", () => {
+  const items = ref([{ uuid: "abc 123" }]);
+  const runtime = createListUiRuntime({
+    items,
+    isInitialLoading: ref(false),
+    recordIdParam: "contactId",
+    recordIdSelector: (item) => item.uuid,
+    routePath: ref("/w/acme/admin/contacts"),
+    viewUrlTemplate: "./:contactId",
+    editUrlTemplate: "./:contactId/edit"
+  });
+
+  assert.equal(runtime.actionColumnCount, 2);
+  assert.equal(runtime.resolveRowKey(items.value[0], 0), "abc 123");
+  assert.equal(runtime.resolveParams("./new"), "/w/acme/admin/contacts/new");
+  assert.equal(runtime.resolveViewUrl(items.value[0]), "/w/acme/admin/contacts/abc%20123");
+  assert.equal(runtime.resolveEditUrl(items.value[0]), "/w/acme/admin/contacts/abc%20123/edit");
+});
+
+test("createListUiRuntime resolves templates that depend on existing route params", () => {
+  const runtime = createListUiRuntime({
+    items: ref([{ id: 42 }]),
+    isInitialLoading: ref(false),
+    recordIdParam: "addressId",
+    recordIdSelector: (item) => item.id,
+    routeParams: ref({ contactId: "7" }),
+    viewUrlTemplate: "/contacts/:contactId/addresses/:addressId",
+    editUrlTemplate: "/contacts/:contactId/addresses/:addressId/edit"
+  });
+
+  assert.equal(runtime.resolveViewUrl({ id: 42 }), "/contacts/7/addresses/42");
+  assert.equal(runtime.resolveEditUrl({ id: 42 }), "/contacts/7/addresses/42/edit");
+});
+
+test("createListUiRuntime returns empty urls and fallback row keys when record id is missing", () => {
+  const runtime = createListUiRuntime({
+    items: ref([]),
+    isInitialLoading: ref(false),
+    recordIdParam: "recordId",
+    recordIdSelector: () => "",
+    viewUrlTemplate: "./:recordId",
+    editUrlTemplate: "./:recordId/edit"
+  });
+
+  assert.equal(runtime.resolveRowKey({}, 5), "row-5");
+  assert.equal(runtime.resolveViewUrl({}), "");
+  assert.equal(runtime.resolveEditUrl({}), "");
+});
+
+test("createListUiRuntime computes list skeleton state from loading and item count", () => {
+  const items = ref([]);
+  const isInitialLoading = ref(true);
+  const runtime = createListUiRuntime({
+    items,
+    isInitialLoading
+  });
+
+  assert.equal(runtime.showListSkeleton.value, true);
+  items.value = [{}];
+  assert.equal(runtime.showListSkeleton.value, false);
+  items.value = [];
+  isInitialLoading.value = false;
+  assert.equal(runtime.showListSkeleton.value, false);
+});
+
+test("createListUiRuntime validates route parameter names", () => {
+  assert.throws(
+    () =>
+      createListUiRuntime({
+        items: ref([]),
+        isInitialLoading: ref(false),
+        recordIdParam: "record-id"
+      }),
+    /recordIdParam "record-id" is invalid/
+  );
+});

package/test/useCrudSchemaForm.test.js

@@ -0,0 +1,141 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { reactive } from "vue";
+import { Type } from "typebox";
+import {
+  normalizeCrudFormFields,
+  createCrudFormModel,
+  buildCrudFormPayload,
+  applyCrudPayloadToForm,
+  resolveCrudFieldErrors,
+  parseCrudResourceOperationInput
+} from "../src/client/composables/crudSchemaFormHelpers.js";
+
+test("normalizeCrudFormFields trims keys, removes invalid entries, and deduplicates", () => {
+  const fields = normalizeCrudFormFields([
+    { key: " name ", type: "string" },
+    { key: "name", type: "string" },
+    { key: "", type: "string" },
+    null,
+    { key: "active", type: "boolean" }
+  ]);
+
+  assert.deepEqual(fields.map((field) => field.key), ["name", "active"]);
+});
+
+test("createCrudFormModel resolves defaults and supports explicit initial values", () => {
+  const model = createCrudFormModel([
+    { key: "name", type: "string" },
+    { key: "active", type: "boolean" },
+    { key: "role", type: "string", initialValue: "member" }
+  ]);
+
+  assert.deepEqual(model, {
+    name: "",
+    active: false,
+    role: "member"
+  });
+});
+
+test("buildCrudFormPayload normalizes booleans and numbers while skipping empty numeric values", () => {
+  const payload = buildCrudFormPayload(
+    [
+      { key: "name", type: "string" },
+      { key: "active", type: "boolean" },
+      { key: "age", type: "integer" },
+      { key: "score", type: "number" }
+    ],
+    {
+      name: "Ada",
+      active: 1,
+      age: "42",
+      score: ""
+    }
+  );
+
+  assert.deepEqual(payload, {
+    name: "Ada",
+    active: true,
+    age: 42
+  });
+});
+
+test("applyCrudPayloadToForm maps payload values into reactive form model", () => {
+  const form = reactive({
+    name: "",
+    active: false,
+    age: ""
+  });
+  applyCrudPayloadToForm(
+    [
+      { key: "name", type: "string" },
+      { key: "active", type: "boolean" },
+      { key: "age", type: "integer" }
+    ],
+    form,
+    {
+      name: "Grace",
+      active: 1,
+      age: 33
+    }
+  );
+
+  assert.deepEqual(form, {
+    name: "Grace",
+    active: true,
+    age: "33"
+  });
+});
+
+test("resolveCrudFieldErrors returns Vuetify-compatible error arrays", () => {
+  assert.deepEqual(resolveCrudFieldErrors({ name: "Name is required." }, "name"), ["Name is required."]);
+  assert.deepEqual(resolveCrudFieldErrors({ name: "Name is required." }, "email"), []);
+});
+
+test("parseCrudResourceOperationInput validates and normalizes operation body payloads", () => {
+  const resource = {
+    operations: {
+      create: {
+        bodyValidator: {
+          schema: Type.Object(
+            {
+              name: Type.String({ minLength: 1 }),
+              age: Type.Integer({ minimum: 1 })
+            },
+            { additionalProperties: false }
+          ),
+          normalize(payload = {}) {
+            return {
+              name: String(payload.name || "").trim(),
+              age: Number(payload.age)
+            };
+          }
+        }
+      }
+    }
+  };
+
+  const validResult = parseCrudResourceOperationInput({
+    resource,
+    operationName: "create",
+    rawPayload: {
+      name: "  Ada  ",
+      age: "2"
+    }
+  });
+  assert.equal(validResult.ok, true);
+  assert.deepEqual(validResult.value, {
+    name: "Ada",
+    age: 2
+  });
+
+  const invalidResult = parseCrudResourceOperationInput({
+    resource,
+    operationName: "create",
+    rawPayload: {
+      name: "   ",
+      age: "0"
+    }
+  });
+  assert.equal(invalidResult.ok, false);
+});