@jskit-ai/crud-ui-generator 0.1.2 → 0.1.4

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/crud-ui-generator",
-  version: "0.1.2",
+  version: "0.1.4",
   kind: "generator",
   description: "Generate app-local CRUD UI scaffolds from resource validators.",
   options: {
@@ -15,9 +15,8 @@ export default Object.freeze({
     surface: {
       required: true,
       inputType: "text",
-      defaultFromConfig: "surfaceDefaultId",
       promptLabel: "Target surface",
-      promptHint: "Defaults to config.public.surfaceDefaultId. Must match an enabled surface id."
+      promptHint: "Must match an enabled surface id."
     },
     "resource-file": {
       required: true,
@@ -26,13 +25,6 @@ export default Object.freeze({
       promptLabel: "Resource file",
       promptHint: "Relative path from app root to the resource module."
     },
-    "resource-export": {
-      required: false,
-      inputType: "text",
-      defaultValue: "",
-      promptLabel: "Resource export",
-      promptHint: "Named export in the resource module (defaults to resource-file basename, example: contactResource)."
-    },
     operations: {
       required: true,
       inputType: "text",
@@ -48,18 +40,26 @@ export default Object.freeze({
       promptHint: "Optional comma-separated field keys to render (must exist in selected operation schemas)."
     },
     "api-path": {
-      required: true,
+      required: false,
       inputType: "text",
-      defaultValue: "",
+      defaultFromOptionTemplate: "/${option:namespace|kebab}",
       promptLabel: "API path",
-      promptHint: "Base API path without trailing id (example: /crud/contacts)."
+      promptHint: "Base API path without trailing id (defaults to /<namespace>, example: /contacts)."
     },
     "route-path": {
-      required: true,
+      required: false,
       inputType: "text",
-      defaultValue: "",
+      defaultFromOptionTemplate: "${option:namespace|kebab}",
       promptLabel: "Route path",
-      promptHint: "List route path under the target surface (example: crm/contacts-alt)."
+      promptHint: "List route path under the target surface (defaults to <namespace>, example: contacts)."
+    },
+    container: {
+      required: false,
+      inputType: "text",
+      defaultValue: "",
+      promptLabel: "Container host",
+      promptHint:
+        "Optional container host slug (example: practice). Routes are generated under this prefix and list menu placement defaults to <container>:sub-pages."
     },
     "id-param": {
       required: false,
@@ -74,6 +74,13 @@ export default Object.freeze({
       defaultValue: "",
       promptLabel: "Page directory prefix",
       promptHint: "Optional subpath under the selected surface pages root (example: crm or ops/team-a)."
+    },
+    placement: {
+      required: false,
+      inputType: "text",
+      defaultValue: "",
+      promptLabel: "Menu placement",
+      promptHint: "Optional host:position target (defaults to ShellLayout default outlet)."
     }
   },
   dependsOn: [],
@@ -90,6 +97,13 @@ export default Object.freeze({
     }
   },
   metadata: {
+    generatorPrimarySubcommand: "crud",
+    generatorSubcommands: {
+      field: {
+        entrypoint: "src/server/subcommands/addField.js",
+        export: "runGeneratorSubcommand"
+      }
+    },
     apiSummary: {
       surfaces: [
         {
@@ -106,7 +120,7 @@ export default Object.freeze({
   mutations: {
     dependencies: {
       runtime: {
-        "@jskit-ai/users-web": "0.1.33"
+        "@jskit-ai/users-web": "0.1.35"
       },
       dev: {}
     },
@@ -118,7 +132,7 @@ export default Object.freeze({
       {
         from: "templates/src/pages/admin/ui-generator/ListElement.vue",
         toSurface: "${option:surface|lower}",
-        toSurfacePath: "${option:directory-prefix|pathprefix}${option:route-path|path}/index.vue",
+        toSurfacePath: "${option:directory-prefix|pathprefix}${option:container|pathprefix}${option:route-path|path}/index.vue",
         reason: "Install generated list page.",
         category: "ui-generator",
         id: "ui-generator-page-list-${option:namespace|snake}",
@@ -134,7 +148,8 @@ export default Object.freeze({
       {
         from: "templates/src/pages/admin/ui-generator/ViewElement.vue",
         toSurface: "${option:surface|lower}",
-        toSurfacePath: "${option:directory-prefix|pathprefix}${option:route-path|path}/[${option:id-param|trim}]/index.vue",
+        toSurfacePath:
+          "${option:directory-prefix|pathprefix}${option:container|pathprefix}${option:route-path|path}/[${option:id-param|trim}]/index.vue",
         reason: "Install generated view page.",
         category: "ui-generator",
         id: "ui-generator-page-view-${option:namespace|snake}",
@@ -150,7 +165,7 @@ export default Object.freeze({
       {
         from: "templates/src/pages/admin/ui-generator/NewElement.vue",
         toSurface: "${option:surface|lower}",
-        toSurfacePath: "${option:directory-prefix|pathprefix}${option:route-path|path}/new.vue",
+        toSurfacePath: "${option:directory-prefix|pathprefix}${option:container|pathprefix}${option:route-path|path}/new.vue",
         reason: "Install generated new page.",
         category: "ui-generator",
         id: "ui-generator-page-new-${option:namespace|snake}",
@@ -166,7 +181,8 @@ export default Object.freeze({
       {
         from: "templates/src/pages/admin/ui-generator/EditElement.vue",
         toSurface: "${option:surface|lower}",
-        toSurfacePath: "${option:directory-prefix|pathprefix}${option:route-path|path}/[${option:id-param|trim}]/edit.vue",
+        toSurfacePath:
+          "${option:directory-prefix|pathprefix}${option:container|pathprefix}${option:route-path|path}/[${option:id-param|trim}]/edit.vue",
         reason: "Install generated edit page.",
         category: "ui-generator",
         id: "ui-generator-page-edit-${option:namespace|snake}",
@@ -185,15 +201,28 @@ export default Object.freeze({
         op: "append-text",
         file: "src/placement.js",
         position: "bottom",
-        skipIfContains: "jskit:ui-generator.menu:${option:namespace|kebab}:${option:directory-prefix|path}:${option:route-path|path}",
+        skipIfContains:
+          "jskit:ui-generator.menu:${option:namespace|kebab}:${option:directory-prefix|path}:${option:container|path}:${option:route-path|path}",
         value:
-          "\n// jskit:ui-generator.menu:${option:namespace|kebab}:${option:directory-prefix|path}:${option:route-path|path}\n{\n  addPlacement({\n    id: \"ui-generator.${option:namespace|kebab}.menu\",\n    host: \"shell-layout\",\n    position: \"primary-menu\",\n    surfaces: [\"${option:surface|lower}\"],\n    order: 155,\n    componentToken: \"users.web.shell.surface-aware-menu-link-item\",\n    props: {\n      label: \"${option:namespace|plural|pascal}\",\n      surface: \"${option:surface|lower}\",\n      workspaceSuffix: \"/${option:directory-prefix|pathprefix}${option:route-path|path}\",\n      nonWorkspaceSuffix: \"/${option:directory-prefix|pathprefix}${option:route-path|path}\"\n    },\n    when: ({ auth }) => Boolean(auth?.authenticated)\n  });\n}\n",
+          "\n// jskit:ui-generator.menu:${option:namespace|kebab}:${option:directory-prefix|path}:${option:container|path}:${option:route-path|path}\n{\n  addPlacement({\n    id: \"ui-generator.${option:namespace|kebab}.menu\",\n    host: \"__JSKIT_UI_MENU_PLACEMENT_HOST__\",\n    position: \"__JSKIT_UI_MENU_PLACEMENT_POSITION__\",\n    surfaces: [\"${option:surface|lower}\"],\n    order: 155,\n    componentToken: \"__JSKIT_UI_MENU_COMPONENT_TOKEN__\",\n    props: {\n      label: \"${option:namespace|plural|pascal}\",\n      surface: \"${option:surface|lower}\",\n      workspaceSuffix: \"/${option:directory-prefix|pathprefix}${option:container|pathprefix}${option:route-path|path}\",\n      nonWorkspaceSuffix: \"/${option:directory-prefix|pathprefix}${option:container|pathprefix}${option:route-path|path}\"\n    },\n    when: ({ auth }) => Boolean(auth?.authenticated)\n  });\n}\n",
         reason: "Append generated UI menu placement.",
         category: "ui-generator",
         id: "ui-generator-placement-menu",
+        templateContext: {
+          entrypoint: "src/server/buildTemplateContext.js",
+          export: "buildUiTemplateContext"
+        },
         when: {
-          option: "operations",
-          in: ["list"]
+          all: [
+            {
+              option: "operations",
+              in: ["list"]
+            },
+            {
+              option: "route-path",
+              notContains: "["
+            }
+          ]
         }
       }
     ]

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@jskit-ai/crud-ui-generator",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "scripts": {
     "test": "node --test"
   },
+  "dependencies": {
+    "@jskit-ai/crud-core": "0.1.29",
+    "@jskit-ai/kernel": "0.1.21"
+  },
   "exports": {
     "./server/buildTemplateContext": "./src/server/buildTemplateContext.js"
   }