@jskit-ai/crud-ui-generator 0.1.26 → 0.1.28

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/crud-ui-generator",
-  version: "0.1.26",
+  version: "0.1.28",
   kind: "generator",
   description: "Generate CRUD route trees from resource validators at an explicit route root relative to src/pages/.",
   options: {
@@ -168,7 +168,7 @@ export default Object.freeze({
   mutations: {
     dependencies: {
       runtime: {
-        "@jskit-ai/users-web": "0.1.58"
+        "@jskit-ai/users-web": "0.1.60"
       },
       dev: {}
     },

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@jskit-ai/crud-ui-generator",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "type": "module",
   "scripts": {
     "test": "node --test"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.1.51",
-    "@jskit-ai/kernel": "0.1.43"
+    "@jskit-ai/crud-core": "0.1.53",
+    "@jskit-ai/kernel": "0.1.45"
   },
   "exports": {
     "./server/buildTemplateContext": "./src/server/buildTemplateContext.js"

package/src/server/resourceSupport.js

@@ -570,6 +570,14 @@ function resolveFormFieldComponent(fieldType, relation = null) {
   return "text";
 }
 
+function buildDefaultNullableBooleanOptions() {
+  return [
+    { label: "Unset", value: null },
+    { label: "Yes", value: true },
+    { label: "No", value: false }
+  ];
+}
+
 function toPositiveInteger(value) {
   const parsed = Number(value);
   return Number.isInteger(parsed) && parsed > 0 ? parsed : null;
@@ -638,7 +646,17 @@ function createFormFieldDefinitions(
         `resource form field "${key}" defines schema enum values but is missing resource.fieldMeta["${key}"].ui.options.`
       );
     }
-    const selectOptions = relation ? [] : fieldUiOptions;
+    const selectOptions = relation
+      ? []
+      : (
+          fieldUiOptions.length > 0
+            ? fieldUiOptions
+            : (
+                schemaType.type === "boolean" && schemaType.nullable === true
+                  ? buildDefaultNullableBooleanOptions()
+                  : []
+              )
+        );
     const lookupFormControl = relation
       ? checkCrudLookupFormControl(fieldMetaMap?.[key]?.ui?.formControl, {
           context: `resource.fieldMeta["${key}"].ui.formControl`,

package/test/buildTemplateContext.test.js

@@ -126,6 +126,70 @@ const resource = {
 export { resource };
 `;
 
+const NULLABLE_BOOLEAN_RESOURCE_SOURCE = `const customerRecordSchema = {
+  type: "object",
+  properties: {
+    id: { type: "integer" },
+    firstName: { type: "string" },
+    reviewPassed: { type: ["boolean", "null"] }
+  },
+  additionalProperties: false
+};
+
+const customerBodySchema = {
+  type: "object",
+  properties: {
+    firstName: { type: "string", maxLength: 120 },
+    reviewPassed: { type: ["boolean", "null"] }
+  },
+  additionalProperties: false
+};
+
+const resource = {
+  resource: "customers",
+  operations: {
+    list: {
+      outputValidator: {
+        schema: {
+          type: "object",
+          properties: {
+            items: {
+              type: "array",
+              items: customerRecordSchema
+            },
+            nextCursor: { type: ["string", "null"] }
+          },
+          additionalProperties: false
+        }
+      }
+    },
+    view: {
+      outputValidator: {
+        schema: customerRecordSchema
+      }
+    },
+    create: {
+      bodyValidator: {
+        schema: customerBodySchema
+      },
+      outputValidator: {
+        schema: customerRecordSchema
+      }
+    },
+    patch: {
+      bodyValidator: {
+        schema: customerBodySchema
+      },
+      outputValidator: {
+        schema: customerRecordSchema
+      }
+    }
+  }
+};
+
+export { resource };
+`;
+
 const LOOKUP_RESOURCE_SOURCE = `const recordSchema = {
   type: "object",
   properties: {
@@ -269,6 +333,38 @@ test("buildUiTemplateContext derives CRUD placeholders from the explicit target-
   });
 });
 
+test("buildUiTemplateContext keeps non-nullable booleans as switches", async () => {
+  await withTempApp(async (appRoot) => {
+    await writeResource(appRoot, RESOURCE_FILE, FULL_RESOURCE_SOURCE);
+
+    const context = await buildUiTemplateContext({
+      appRoot,
+      options: createOptions()
+    });
+
+    assert.match(context.__JSKIT_UI_CREATE_FORM_COLUMNS__, /<v-switch/);
+    assert.match(context.__JSKIT_UI_CREATE_FORM_COLUMNS__, /formRuntime\.form\.vip/);
+  });
+});
+
+test("buildUiTemplateContext renders nullable booleans as tri-state selects by default", async () => {
+  await withTempApp(async (appRoot) => {
+    await writeResource(appRoot, RESOURCE_FILE, NULLABLE_BOOLEAN_RESOURCE_SOURCE);
+
+    const context = await buildUiTemplateContext({
+      appRoot,
+      options: createOptions()
+    });
+
+    assert.match(context.__JSKIT_UI_CREATE_FORM_FIELDS__, /"key":"reviewPassed"/);
+    assert.match(context.__JSKIT_UI_CREATE_FORM_FIELDS__, /"component":"select"/);
+    assert.match(context.__JSKIT_UI_CREATE_FORM_FIELDS__, /"nullable":true/);
+    assert.match(context.__JSKIT_UI_CREATE_FORM_FIELDS__, /"options":\[\{"label":"Unset","value":null\},\{"label":"Yes","value":true\},\{"label":"No","value":false\}\]/);
+    assert.match(context.__JSKIT_UI_CREATE_FORM_COLUMNS__, /<v-select/);
+    assert.doesNotMatch(context.__JSKIT_UI_CREATE_FORM_COLUMNS__, /<v-switch/);
+  });
+});
+
 test("buildUiTemplateContext derives menu auth visibility from the target surface policy", async () => {
   await withTempApp(async (appRoot) => {
     await writeFile(