@jskit-ai/kernel 0.1.66 → 0.1.67

package/shared/support/generatedUiContract.test.js

@@ -0,0 +1,208 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import {
+  GENERATED_UI_NAVIGATION_ROLE_OPTION,
+  GENERATED_UI_NAVIGATION_ROLE_VALUES,
+  GENERATED_UI_SURFACE_PROFILES,
+  assertGeneratedUiSourceContract,
+  buildGeneratedUiScreenClassName,
+  collectGeneratedUiSourceContractIssues,
+  inferGeneratedUiNavigationRole,
+  isGeneratedUiNoLinkNavigationRole,
+  normalizeGeneratedUiNavigationRole,
+  resolveGeneratedUiSurfaceProfile,
+  resolveGeneratedUiNavigationRoleLinkPlacement,
+  shouldCreateGeneratedUiNavigationLink
+} from "./generatedUiContract.js";
+
+test("generated UI navigation role metadata is descriptor-ready", () => {
+  assert.deepEqual(
+    GENERATED_UI_NAVIGATION_ROLE_VALUES,
+    ["primary", "secondary", "utility", "detail", "workflow", "none"]
+  );
+  assert.equal(GENERATED_UI_NAVIGATION_ROLE_OPTION.validationType, "enum");
+  assert.deepEqual(GENERATED_UI_NAVIGATION_ROLE_OPTION.allowedValues, GENERATED_UI_NAVIGATION_ROLE_VALUES);
+  assert.equal(GENERATED_UI_NAVIGATION_ROLE_OPTION.defaultValue, "");
+});
+
+test("generated UI surface profiles map app, operator, and settings density", () => {
+  assert.deepEqual(Object.keys(GENERATED_UI_SURFACE_PROFILES), ["task", "operator", "settings"]);
+  assert.equal(resolveGeneratedUiSurfaceProfile("").id, "task");
+  assert.equal(resolveGeneratedUiSurfaceProfile("operator").id, "operator");
+  assert.equal(resolveGeneratedUiSurfaceProfile("operator").density, "compact");
+  assert.equal(resolveGeneratedUiSurfaceProfile("settings").id, "settings");
+  assert.equal(
+    buildGeneratedUiScreenClassName("generated-page-screen d-flex", {
+      surfaceProfile: "operator"
+    }),
+    "generated-ui-screen generated-ui-screen--operator generated-page-screen d-flex"
+  );
+});
+
+test("normalizeGeneratedUiNavigationRole defaults and validates roles", () => {
+  assert.equal(normalizeGeneratedUiNavigationRole(""), "primary");
+  assert.equal(normalizeGeneratedUiNavigationRole(" Secondary "), "secondary");
+  assert.throws(
+    () => normalizeGeneratedUiNavigationRole("drawer"),
+    /navigation-role must be one of: primary, secondary, utility, detail, workflow, none/
+  );
+});
+
+test("generated UI navigation roles resolve semantic link placements", () => {
+  assert.equal(resolveGeneratedUiNavigationRoleLinkPlacement({}), "");
+  assert.equal(resolveGeneratedUiNavigationRoleLinkPlacement({ "navigation-role": "secondary" }), "shell.secondary-nav");
+  assert.equal(resolveGeneratedUiNavigationRoleLinkPlacement({ "navigation-role": "utility" }), "shell.global-actions");
+  assert.equal(
+    resolveGeneratedUiNavigationRoleLinkPlacement({
+      "navigation-role": "secondary",
+      "link-placement": "settings.sections"
+    }),
+    "settings.sections"
+  );
+});
+
+test("generated UI navigation role inference keeps detail and workflow routes out of primary nav", () => {
+  assert.equal(inferGeneratedUiNavigationRole({}, { routePath: "/reports" }), "primary");
+  assert.equal(inferGeneratedUiNavigationRole({}, { routePath: "/reports/[reportId]" }), "detail");
+  assert.equal(inferGeneratedUiNavigationRole({}, { routePath: "/reports/[reportId]/activity" }), "primary");
+  assert.equal(
+    inferGeneratedUiNavigationRole({}, {
+      dynamicRoutePolicy: "any",
+      routePath: "/reports/[reportId]/activity"
+    }),
+    "detail"
+  );
+  assert.equal(inferGeneratedUiNavigationRole({}, { routePath: "/reports/new" }), "workflow");
+  assert.equal(
+    inferGeneratedUiNavigationRole({ "navigation-role": "primary" }, { routePath: "/reports/[reportId]" }),
+    "primary"
+  );
+  assert.equal(
+    shouldCreateGeneratedUiNavigationLink({}, {
+      allowLinkTo: true,
+      routePath: "/reports/[reportId]"
+    }),
+    false
+  );
+  assert.equal(
+    shouldCreateGeneratedUiNavigationLink({ "navigation-role": "primary" }, {
+      allowLinkTo: true,
+      routePath: "/reports/[reportId]"
+    }),
+    true
+  );
+  assert.equal(
+    shouldCreateGeneratedUiNavigationLink({ "link-placement": "shell.secondary-nav" }, {
+      allowLinkTo: true,
+      routePath: "/reports/[reportId]"
+    }),
+    true
+  );
+});
+
+test("generated UI no-link roles reject conflicting link options", () => {
+  assert.equal(isGeneratedUiNoLinkNavigationRole("detail"), true);
+  assert.equal(shouldCreateGeneratedUiNavigationLink({ "navigation-role": "workflow" }), false);
+  assert.equal(shouldCreateGeneratedUiNavigationLink({ "navigation-role": "primary" }), true);
+  assert.throws(
+    () => shouldCreateGeneratedUiNavigationLink({
+      "navigation-role": "detail",
+      "link-placement": "shell.primary-nav"
+    }),
+    /navigation-role "detail" cannot be combined with --link-placement/
+  );
+  assert.throws(
+    () => shouldCreateGeneratedUiNavigationLink({
+      "navigation-role": "none",
+      "link-to": "./details"
+    }, {
+      allowLinkTo: true
+    }),
+    /navigation-role "none" cannot be combined with --link-placement or --link-to/
+  );
+});
+
+test("generated UI source contract flags placeholder copy and missing profile hooks", () => {
+  const issues = collectGeneratedUiSourceContractIssues(
+    `<template>
+  <section>
+    <v-card>Replace this content</v-card>
+  </section>
+</template>`,
+    {
+      profile: "page"
+    }
+  );
+
+  assert.deepEqual(
+    issues.map((issue) => issue.id),
+    [
+      "replace-this-copy",
+      "vuetify-card-shell",
+      "shared-screen-class",
+      "page-screen-title",
+      "page-empty-state-sheet",
+      "page-responsive-title-type",
+      "page-compact-rules"
+    ]
+  );
+});
+
+test("generated UI source contract accepts compact-first CRUD detail structure", () => {
+  assert.doesNotThrow(() => assertGeneratedUiSourceContract(
+    `<template>
+  <CrudAddEditScreen :screen="screen">
+    <template #fields="{ formState, addEdit, resolveFieldErrors }"></template>
+  </CrudAddEditScreen>
+</template>
+
+<script setup>
+const screen = useCrudAddEditScreen({
+  title: "New Customer",
+  resource: uiResource
+});
+</script>`,
+    {
+      profile: "crud-detail",
+      sourceName: "NewElement.vue"
+    }
+  ));
+});
+
+test("generated UI source contract accepts compact-first CRUD list structure", () => {
+  assert.doesNotThrow(() => assertGeneratedUiSourceContract(
+    `<template>
+  <CrudListScreen
+    :screen="screen"
+    empty-title="__JSKIT_UI_LIST_EMPTY_TITLE__"
+    load-error-title="__JSKIT_UI_LIST_LOAD_ERROR_TITLE__"
+  >
+    <template #card-fields="{ record, records, formatListCardValue }"></template>
+    <template #table-header></template>
+    <template #table-row="{ record, records }"></template>
+  </CrudListScreen>
+</template>
+
+<script setup>
+const screen = useCrudListScreen({
+  resource: uiResource,
+  listFilters,
+  listBulkActions
+});
+</script>`,
+    {
+      profile: "crud-list",
+      sourceName: "ListElement.vue"
+    }
+  ));
+});
+
+test("generated UI responsive smoke profile requires compact medium expanded checks", () => {
+  assert.throws(
+    () => assertGeneratedUiSourceContract("const width = 390; const selector = 'generated-ui-screen';", {
+      profile: "responsive-smoke",
+      sourceName: "tests/e2e/example.spec.ts"
+    }),
+    /missing:medium-viewport/
+  );
+});

package/shared/support/shellLayoutTargets.js

@@ -328,7 +328,13 @@ function normalizeShellOutletTargetRecord(
   });
 }
 
-function discoverShellOutletTargetsFromVueSource(source = "", { context = "shell layout" } = {}) {
+function discoverShellOutletTargetsFromVueSource(
+  source = "",
+  {
+    context = "shell layout",
+    enforceSingleDefault = true
+  } = {}
+) {
   const sourceText = String(source || "");
   const resolvedContext = normalizeText(context) || "shell layout";
   const targetById = new Map();
@@ -347,12 +353,14 @@ function discoverShellOutletTargetsFromVueSource(source = "", { context = "shell
     }
 
     if (normalizedTarget.default) {
-      if (defaultTargetId) {
+      if (enforceSingleDefault === true && defaultTargetId) {
         throw new Error(
           `${resolvedContext} defines multiple default ShellOutlet targets: "${defaultTargetId}" and "${normalizedTarget.id}".`
         );
       }
-      defaultTargetId = normalizedTarget.id;
+      if (!defaultTargetId) {
+        defaultTargetId = normalizedTarget.id;
+      }
     }
 
     targetById.set(normalizedTarget.id, normalizedTarget);

package/shared/support/shellLayoutTargets.test.js

@@ -74,6 +74,26 @@ test("discoverShellOutletTargetsFromVueSource throws for multiple defaults", ()
   );
 });
 
+test("discoverShellOutletTargetsFromVueSource can collect source hints without enforcing one default", () => {
+  const source = `
+    <template>
+      <ShellOutlet target="shell-layout:primary-menu" default />
+      <ShellOutlet target="shell-layout:primary-bottom-nav" default />
+    </template>
+  `;
+
+  const discovered = discoverShellOutletTargetsFromVueSource(source, {
+    context: "ShellLayout.vue",
+    enforceSingleDefault: false
+  });
+
+  assert.equal(discovered.defaultTargetId, "shell-layout:primary-menu");
+  assert.deepEqual(
+    discovered.targets.map((entry) => entry.id),
+    ["shell-layout:primary-menu", "shell-layout:primary-bottom-nav"]
+  );
+});
+
 test("discoverShellOutletTargetsFromVueSource ignores disabled default markers", () => {
   const source = `
     <template>