@kosdev-code/kos-ui-cli 2.0.40 → 2.0.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-ui-cli",
-  "version": "2.0.40",
+  "version": "2.0.42",
   "bin": {
     "kosui": "./src/lib/cli.mjs"
   },
@@ -20,7 +20,7 @@
   "main": "./src/index.js",
   "kos": {
     "build": {
-      "gitHash": "e892e3567f1518d84fb37df390a1b23e5bc40ccd"
+      "gitHash": "04ed84eabdd07cebb95c0e356946f1cd36aad247"
     }
   },
   "publishConfig": {

package/src/lib/cli.mjs

@@ -11,16 +11,24 @@ const originalArgs = process.argv.slice(2);
 const parsedArgs = minimist(originalArgs);
 const command = parsedArgs._[0] || "help";
 
-const customFlags = ["--no-cache", "--refresh"];
+const customFlags = ["--no-cache", "--refresh", "--quiet"];
 const hasNoCache = originalArgs.includes("--no-cache");
 const hasRefresh = originalArgs.includes("--refresh");
+const hasQuiet = originalArgs.includes("--quiet");
 
 if (hasNoCache || hasRefresh) {
   process.env.DISABLE_CACHE = "true";
-  console.log("[kos-cli] Cache disabled or refresh forced. Clearing cache...");
+  if (!hasQuiet) {
+    console.log("[kos-cli] Cache disabled or refresh forced. Clearing cache...");
+  }
   clearCache();
 }
 
+if (hasQuiet) {
+  process.env.DISABLE_CLI_BANNER = "true";
+  process.env.KOS_CLI_QUIET = "true";
+}
+
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const configPath = path.join(__dirname, "plopfile.mjs");
 
@@ -47,6 +55,7 @@ async function launch() {
     console.log("\nGlobal Options:");
     console.log("  --no-cache      Disable cache");
     console.log("  --refresh       Clear cache and refresh");
+    console.log("  --quiet         Suppress banner and debug output");
     console.log(
       "  --interactive, -i   Force interactive mode (ignore provided arguments)"
     );
@@ -395,7 +404,7 @@ async function launch() {
 
   const meta = await getGeneratorMetadata(command);
 
-  if (showBanner) {
+  if (showBanner && !hasQuiet) {
     console.log(`--- Running KOS Generator: ${meta?.name || command} ---`);
   }
 
@@ -753,10 +762,12 @@ async function launch() {
 
     const results = await generator.runActions(answers);
 
-    console.log("[kos-cli] Generator completed successfully!");
-    results.changes.forEach((result) => {
-      console.log(result.path || result.message);
-    });
+    if (!hasQuiet) {
+      console.log("[kos-cli] Generator completed successfully!");
+      results.changes.forEach((result) => {
+        console.log(result.path || result.message);
+      });
+    }
 
     results.failures.forEach((fail) => {
       console.error(fail.error || fail.message);

package/src/lib/generators/metadata.json

@@ -14,7 +14,13 @@
     "file": "index.mjs",
     "metadata": {
       "key": "component",
-      "name": "KOS React Component"
+      "name": "KOS React Component",
+      "namedArguments": {
+        "name": "componentName",
+        "componentName": "componentName",
+        "project": "componentProject",
+        "componentProject": "componentProject"
+      }
     }
   },
   {
@@ -30,7 +36,30 @@
     "file": "namespace.mjs",
     "metadata": {
       "key": "i18n:namespace",
-      "name": "KOS i18n Project Namespace"
+      "name": "KOS i18n Project Namespace",
+      "namedArguments": {
+        "name": "name",
+        "locale": "locale",
+        "project": "project"
+      }
+    }
+  },
+  {
+    "category": "model",
+    "file": "add-future.mjs",
+    "metadata": {
+      "key": "add-future",
+      "name": "Add Future Support to Model",
+      "invalidateCache": true,
+      "namedArguments": {
+        "modelName": "modelName",
+        "project": "modelProject",
+        "modelProject": "modelProject",
+        "futureType": "futureType",
+        "updateServices": "updateServices",
+        "dryRun": "dryRun",
+        "interactive": "interactive"
+      }
     }
   },
   {
@@ -38,7 +67,21 @@
     "file": "companion.mjs",
     "metadata": {
       "key": "model:companion",
-      "name": "KOS Companion Model"
+      "name": "KOS Companion Model",
+      "namedArguments": {
+        "name": "modelName",
+        "modelName": "modelName",
+        "project": "modelProject",
+        "modelProject": "modelProject",
+        "companionParent": "companionParent",
+        "companionPattern": "companionPattern",
+        "container": "container",
+        "parentAware": "parentAware",
+        "singleton": "singleton",
+        "dataServices": "dataServices",
+        "dryRun": "dryRun",
+        "interactive": "interactive"
+      }
     }
   },
   {
@@ -46,7 +89,17 @@
     "file": "container.mjs",
     "metadata": {
       "key": "container",
-      "name": "KOS Container Model"
+      "name": "KOS Container Model",
+      "namedArguments": {
+        "modelName": "modelName",
+        "registrationProject": "registrationProject",
+        "container": "container",
+        "parentAware": "parentAware",
+        "singleton": "singleton",
+        "dataServices": "dataServices",
+        "dryRun": "dryRun",
+        "interactive": "interactive"
+      }
     }
   },
   {
@@ -54,7 +107,12 @@
     "file": "context.mjs",
     "metadata": {
       "key": "context",
-      "name": "KOS Model React Context"
+      "name": "KOS Model React Context",
+      "namedArguments": {
+        "modelName": "modelName",
+        "componentProject": "componentProject",
+        "project": "componentProject"
+      }
     }
   },
   {
@@ -62,7 +120,12 @@
     "file": "hook.mjs",
     "metadata": {
       "key": "hook",
-      "name": "KOS Model React Hook"
+      "name": "KOS Model React Hook",
+      "namedArguments": {
+        "modelName": "modelName",
+        "componentProject": "componentProject",
+        "project": "componentProject"
+      }
     }
   },
   {
@@ -71,7 +134,20 @@
     "metadata": {
       "key": "model",
       "name": "KOS Model",
-      "invalidateCache": true
+      "invalidateCache": true,
+      "namedArguments": {
+        "name": "modelName",
+        "modelName": "modelName",
+        "project": "modelProject",
+        "modelProject": "modelProject",
+        "container": "container",
+        "parentAware": "parentAware",
+        "singleton": "singleton",
+        "dataServices": "dataServices",
+        "futureAware": "futureAware",
+        "dryRun": "dryRun",
+        "interactive": "interactive"
+      }
     }
   },
   {
@@ -80,31 +156,75 @@
     "metadata": [
       {
         "key": "pluginComponent",
-        "name": "KOS UI Plugin Component"
+        "name": "KOS UI Plugin Component",
+        "namedArguments": {
+          "name": "componentName",
+          "componentName": "componentName",
+          "project": "componentProject",
+          "componentProject": "componentProject",
+          "extensionPoint": "extensionPoint"
+        }
       },
       {
         "key": "plugin:cui",
-        "name": "KOS UI Plugin CUI Configuration"
+        "name": "KOS UI Plugin CUI Configuration",
+        "namedArguments": {
+          "name": "componentName",
+          "componentName": "componentName",
+          "project": "componentProject",
+          "componentProject": "componentProject"
+        }
       },
       {
         "key": "plugin:setup",
-        "name": "KOS UI Plugin Setup Step"
+        "name": "KOS UI Plugin Setup Step",
+        "namedArguments": {
+          "name": "componentName",
+          "componentName": "componentName",
+          "project": "componentProject",
+          "componentProject": "componentProject"
+        }
       },
       {
         "key": "plugin:utility",
-        "name": "KOS UI Plugin Utility"
+        "name": "KOS UI Plugin Utility",
+        "namedArguments": {
+          "name": "componentName",
+          "componentName": "componentName",
+          "project": "componentProject",
+          "componentProject": "componentProject"
+        }
       },
       {
         "key": "plugin:setting",
-        "name": "KOS UI Plugin Setting"
+        "name": "KOS UI Plugin Setting",
+        "namedArguments": {
+          "name": "componentName",
+          "componentName": "componentName",
+          "project": "componentProject",
+          "componentProject": "componentProject",
+          "group": "group"
+        }
       },
       {
         "key": "plugin:nav",
-        "name": "KOS UI Plugin Navigation View"
+        "name": "KOS UI Plugin Navigation View",
+        "namedArguments": {
+          "name": "componentName",
+          "componentName": "componentName",
+          "project": "componentProject",
+          "componentProject": "componentProject"
+        }
       },
       {
         "key": "plugin:cp",
-        "name": "KOS UI Plugin Control Pour"
+        "name": "KOS UI Plugin Control Pour",
+        "namedArguments": {
+          "name": "componentName",
+          "componentName": "componentName",
+          "project": "componentProject",
+          "componentProject": "componentProject"
+        }
       }
     ]
   },
@@ -114,7 +234,22 @@
     "metadata": {
       "key": "project",
       "name": "KOS UI App Project",
-      "invalidateCache": true
+      "invalidateCache": true,
+      "namedArguments": {
+        "name": "name"
+      }
+    }
+  },
+  {
+    "category": "project",
+    "file": "content.mjs",
+    "metadata": {
+      "key": "content",
+      "name": "KOS Content Project",
+      "invalidateCache": true,
+      "namedArguments": {
+        "name": "name"
+      }
     }
   },
   {
@@ -123,7 +258,10 @@
     "metadata": {
       "key": "i18n",
       "name": "KOS Localization Project",
-      "invalidateCache": true
+      "invalidateCache": true,
+      "namedArguments": {
+        "name": "name"
+      }
     }
   },
   {
@@ -132,7 +270,10 @@
     "metadata": {
       "key": "plugin",
       "name": "KOS Plugin Project",
-      "invalidateCache": true
+      "invalidateCache": true,
+      "namedArguments": {
+        "name": "name"
+      }
     }
   },
   {
@@ -141,7 +282,10 @@
     "metadata": {
       "key": "project:splash",
       "name": "KOS Splash Screen Project",
-      "invalidateCache": true
+      "invalidateCache": true,
+      "namedArguments": {
+        "name": "name"
+      }
     }
   },
   {
@@ -150,7 +294,10 @@
     "metadata": {
       "key": "theme",
       "name": "KOS Theme Project",
-      "invalidateCache": true
+      "invalidateCache": true,
+      "namedArguments": {
+        "name": "name"
+      }
     }
   },
   {
@@ -158,7 +305,37 @@
     "file": "index.mjs",
     "metadata": {
       "key": "workspace",
-      "name": "Create a new KOS UI Workspace"
+      "name": "Create a new KOS UI Workspace",
+      "namedArguments": {
+        "name": "workspaceName",
+        "workspaceName": "workspaceName"
+      }
+    }
+  },
+  {
+    "category": "workspace",
+    "file": "list-models.mjs",
+    "metadata": {
+      "key": "workspace:list-models",
+      "name": "List all available models in the workspace",
+      "description": "List all available models in the workspace",
+      "namedArguments": {
+        "format": "outputFormat"
+      }
+    }
+  },
+  {
+    "category": "workspace",
+    "file": "list-projects.mjs",
+    "metadata": {
+      "key": "workspace:list-projects",
+      "name": "List all available projects in the workspace",
+      "description": "List all available projects in the workspace with optional type filtering",
+      "namedArguments": {
+        "type": "projectType",
+        "format": "outputFormat",
+        "fallback": "includeFallback"
+      }
     }
   }
 ]

package/src/lib/generators/project/content.mjs

@@ -0,0 +1,41 @@
+// generators/project/content.mjs
+import { actionFactory } from "../../utils/action-factory.mjs";
+import { execute } from "../../utils/exec.mjs";
+import { required } from "../../utils/validators.mjs";
+
+export const metadata = {
+  key: "content",
+  name: "KOS Content Project",
+  invalidateCache: true,
+  namedArguments: { name: "name" },
+};
+
+export default async function (plop) {
+  plop.setActionType("createContentProject", async function (answers) {
+    const command = `npx nx generate @kosdev-code/kos-nx-plugin:kos-content-project \
+      --name=${answers.name} \
+      --no-interactive`;
+
+    try {
+      await execute(command);
+    } catch (error) {
+      throw new Error(error);
+    }
+
+    return `Content project ${answers.name} created.`;
+  });
+
+  plop.setGenerator("content", {
+    description:
+      "Create a new KOS Content project for KAB (Kos Asset Bundle) generation",
+    prompts: [
+      {
+        type: "input",
+        name: "name",
+        message: "What is the name of the content project?",
+        validate: required,
+      },
+    ],
+    actions: actionFactory("createContentProject", metadata),
+  });
+}

package/src/lib/generators/workspace/index.mjs

@@ -1,6 +1,8 @@
 // generators/workspace/index.mjs
 import { createWorkspace } from "create-nx-workspace";
 import { required } from "../../utils/validators.mjs";
+import registerListModels from "./list-models.mjs";
+import registerListProjects from "./list-projects.mjs";
 
 export const metadata = {
   key: "workspace",
@@ -31,4 +33,8 @@ export default async function (plop) {
     ],
     actions: () => [{ type: "createWorkspace" }],
   });
+  
+  // Register additional workspace generators
+  await registerListModels(plop);
+  await registerListProjects(plop);
 }

package/src/lib/generators/workspace/list-models.mjs

@@ -0,0 +1,64 @@
+import { getAllModels } from "../../utils/nx-context.mjs";
+
+/**
+ * Generator for listing all models in a workspace
+ */
+export default async function register(plop) {
+  plop.setGenerator("workspace:list-models", {
+    description: "List all available models in the workspace",
+    prompts: [
+      {
+        type: "list",
+        name: "outputFormat",
+        message: "Output format",
+        choices: ["json", "table", "simple"],
+        default: "json",
+      },
+    ],
+    actions: function (answers) {
+      return [
+        async function listModels() {
+          const models = await getAllModels();
+          
+          formatModelOutput(models, answers.outputFormat);
+          
+          return `[ok] Found ${models.length} models in workspace`;
+        },
+      ];
+    },
+  });
+}
+
+
+function formatModelOutput(models, format) {
+  switch (format) {
+    case "json":
+      console.log(JSON.stringify(models, null, 2));
+      break;
+      
+    case "table":
+      console.table(
+        models.map((m) => ({
+          Model: m.model,
+          Project: m.project,
+        }))
+      );
+      break;
+      
+    case "simple":
+      for (const model of models) {
+        console.log(`${model.project}/${model.model}`);
+      }
+      break;
+  }
+}
+
+// Export metadata for CLI integration
+export const metadata = {
+  key: "workspace:list-models",
+  name: "List all available models in the workspace",
+  description: "List all available models in the workspace",
+  namedArguments: {
+    format: "outputFormat",
+  },
+};

package/src/lib/generators/workspace/list-projects.mjs

@@ -0,0 +1,167 @@
+import {
+  getAllProjects,
+  getLibraryProjects,
+  getModelProjects,
+  getModelComponentProjects,
+  getUIProjects,
+  getI18nProjects,
+  getPluginProjects,
+  getModelProjectsWithFallback,
+  getModelComponentProjectsWithFallback,
+  getI18nProjectsWithFallback,
+  getPluginProjectsWithFallback,
+} from "../../utils/nx-context.mjs";
+
+/**
+ * Generator for listing all projects in a workspace
+ */
+export default async function register(plop) {
+  plop.setGenerator("workspace:list-projects", {
+    description: "List all available projects in the workspace",
+    prompts: [
+      {
+        type: "list",
+        name: "projectType",
+        message: "Project type to filter by",
+        choices: [
+          { name: "All projects", value: "all" },
+          { name: "Model projects", value: "model" },
+          { name: "Model component projects", value: "model-component" },
+          { name: "UI projects", value: "ui" },
+          { name: "I18n projects", value: "i18n" },
+          { name: "Plugin projects", value: "plugin" },
+          { name: "Library projects", value: "library" },
+        ],
+        default: "all",
+      },
+      {
+        type: "list",
+        name: "outputFormat",
+        message: "Output format",
+        choices: ["json", "table", "simple"],
+        default: "json",
+      },
+      {
+        type: "confirm",
+        name: "includeFallback",
+        message: "Include fallback projects if no projects of specified type found?",
+        default: true,
+      },
+    ],
+    actions: function (answers) {
+      return [
+        async function listProjects() {
+          const includeFallback = answers.projectType === "all" ? false : (answers.includeFallback ?? true);
+          const projects = await getProjectsByType(
+            answers.projectType,
+            includeFallback
+          );
+          
+          formatProjectOutput(projects, answers.outputFormat, answers.projectType);
+          
+          return `[ok] Found ${projects.length} ${answers.projectType} projects`;
+        },
+      ];
+    },
+  });
+}
+
+// Zone 1: High-level orchestration
+async function getProjectsByType(projectType, includeFallback) {
+  switch (projectType) {
+    case "all":
+      return await getAllProjects();
+    case "model":
+      return includeFallback
+        ? await getModelProjectsWithFallback()
+        : await getModelProjects();
+    case "model-component":
+      return includeFallback
+        ? await getModelComponentProjectsWithFallback()
+        : await getModelComponentProjects();
+    case "ui":
+      return await getUIProjects();
+    case "i18n":
+      return includeFallback
+        ? await getI18nProjectsWithFallback()
+        : await getI18nProjects();
+    case "plugin":
+      return includeFallback
+        ? await getPluginProjectsWithFallback()
+        : await getPluginProjects();
+    case "library":
+      return await getLibraryProjects();
+    default:
+      throw new Error(`Unknown project type: ${projectType}`);
+  }
+}
+
+// Zone 3: Output formatting
+function formatProjectOutput(projects, format, projectType) {
+  const enrichedProjects = enrichProjectData(projects, projectType);
+  
+  switch (format) {
+    case "json":
+      console.log(JSON.stringify(enrichedProjects, null, 2));
+      break;
+      
+    case "table":
+      console.table(
+        enrichedProjects.map((p) => ({
+          Name: p.name,
+          Type: p.type || "unknown",
+        }))
+      );
+      break;
+      
+    case "simple":
+      for (const project of enrichedProjects) {
+        console.log(project.name);
+      }
+      break;
+  }
+}
+
+function enrichProjectData(projects, requestedType) {
+  return projects.map((projectName) => ({
+    name: projectName,
+    type: requestedType === "all" ? inferProjectType(projectName) : requestedType,
+  }));
+}
+
+function inferProjectType(projectName) {
+  const name = projectName.toLowerCase();
+  
+  if (name.includes("model") && !name.includes("component")) {
+    return "model";
+  }
+  if (name.includes("model") && name.includes("component")) {
+    return "model-component";
+  }
+  if (name.includes("ui") || name.includes("app")) {
+    return "ui";
+  }
+  if (name.includes("i18n") || name.includes("localization")) {
+    return "i18n";
+  }
+  if (name.includes("plugin") || name.includes("extension")) {
+    return "plugin";
+  }
+  if (name.includes("lib")) {
+    return "library";
+  }
+  
+  return "unknown";
+}
+
+// Export metadata for CLI integration
+export const metadata = {
+  key: "workspace:list-projects",
+  name: "List all available projects in the workspace",
+  description: "List all available projects in the workspace with optional type filtering",
+  namedArguments: {
+    type: "projectType",
+    format: "outputFormat",
+    fallback: "includeFallback",
+  },
+};

package/src/lib/plopfile.mjs

@@ -16,6 +16,7 @@ import registerCacheGenerators from "./generators/cache/index.mjs";
 import registerEnv from "./generators/env/index.mjs";
 import registerI18nNamespace from "./generators/i18n/namespace.mjs";
 import registerUiProject from "./generators/project/app.mjs";
+import registerContentProject from "./generators/project/content.mjs";
 import registerI18n from "./generators/project/i18n.mjs";
 import registerPluginProject from "./generators/project/plugin.mjs";
 import registerSplashProject from "./generators/project/splash.mjs";
@@ -49,6 +50,7 @@ export default async function (plop) {
   await registerComponent(plop);
   await registerPluginComponent(plop);
   await registerTheme(plop);
+  await registerContentProject(plop);
   await registerUiProject(plop);
   await registerPluginProject(plop);
   await registerSplashProject(plop);

package/src/lib/utils/nx-context.mjs

@@ -104,7 +104,9 @@ export async function getAllKosProjects() {
   const cached = getCached("allKosProjects");
   if (cached) return cached;
 
-  console.warn(`[kos-cli] Discovering KOS projects by scanning .kos.json files...`);
+  if (process.env.KOS_CLI_QUIET !== "true") {
+    console.warn(`[kos-cli] Discovering KOS projects by scanning .kos.json files...`);
+  }
   
   // In an NX workspace, focus on common project directories first
   const projectDirs = ['apps', 'libs', 'packages'];
@@ -127,7 +129,9 @@ export async function getAllKosProjects() {
   
   // If we didn't find any in the common directories, fall back to full scan
   if (kosJsonFiles.length === 0) {
-    console.warn(`[kos-cli] No .kos.json files found in common directories, performing full workspace scan...`);
+    if (process.env.KOS_CLI_QUIET !== "true") {
+      console.warn(`[kos-cli] No .kos.json files found in common directories, performing full workspace scan...`);
+    }
     findKosJsonFiles(workspaceRoot, kosJsonFiles);
   }
   
@@ -181,7 +185,9 @@ export async function getProjectsByType(targetType) {
   const cached = getCached(cacheKey);
   if (cached) return cached;
 
-  console.warn(`[kos-cli] Filtering projects for ${targetType} projectType...`);
+  if (process.env.KOS_CLI_QUIET !== "true") {
+    console.warn(`[kos-cli] Filtering projects for ${targetType} projectType...`);
+  }
   const allKosProjects = await getAllKosProjects();
   const filteredProjects = [];
 
@@ -223,10 +229,14 @@ export async function getProjectsByTypeWithFallback(targetType, fallbackFunction
   const filteredProjects = await getProjectsByType(targetType);
   
   if (filteredProjects.length > 0) {
-    console.warn(`[kos-cli] Found ${filteredProjects.length} ${targetType} projects`);
+    if (process.env.KOS_CLI_QUIET !== "true") {
+      console.warn(`[kos-cli] Found ${filteredProjects.length} ${targetType} projects`);
+    }
     return filteredProjects;
   } else {
-    console.warn(`[kos-cli] No ${targetType} projects found, showing fallback projects`);
+    if (process.env.KOS_CLI_QUIET !== "true") {
+      console.warn(`[kos-cli] No ${targetType} projects found, showing fallback projects`);
+    }
     return await fallbackFunction();
   }
 }
@@ -275,10 +285,14 @@ export async function getComponentCompatibleProjectsWithFallback() {
   const componentProjects = await getComponentCompatibleProjects();
   
   if (componentProjects.length > 0) {
-    console.warn(`[kos-cli] Found ${componentProjects.length} component-compatible projects`);
+    if (process.env.KOS_CLI_QUIET !== "true") {
+      console.warn(`[kos-cli] Found ${componentProjects.length} component-compatible projects`);
+    }
     return componentProjects;
   } else {
-    console.warn(`[kos-cli] No component-compatible projects found, showing all projects`);
+    if (process.env.KOS_CLI_QUIET !== "true") {
+      console.warn(`[kos-cli] No component-compatible projects found, showing all projects`);
+    }
     return await getAllProjects();
   }
 }
@@ -291,14 +305,18 @@ export async function getPluginProjectsWithFallback() {
   // First try type-based filtering
   const pluginProjectsByType = await getProjectsByType("plugin");
   if (pluginProjectsByType.length > 0) {
-    console.warn(`[kos-cli] Found ${pluginProjectsByType.length} plugin projects by type`);
+    if (process.env.KOS_CLI_QUIET !== "true") {
+      console.warn(`[kos-cli] Found ${pluginProjectsByType.length} plugin projects by type`);
+    }
     return pluginProjectsByType;
   }
   
   // Fall back to existing name-based filtering
   const pluginProjectsByName = await getPluginProjects();
   if (pluginProjectsByName.length > 0) {
-    console.warn(`[kos-cli] Found ${pluginProjectsByName.length} plugin projects by name`);
+    if (process.env.KOS_CLI_QUIET !== "true") {
+      console.warn(`[kos-cli] Found ${pluginProjectsByName.length} plugin projects by name`);
+    }
     return pluginProjectsByName;
   }
   
@@ -311,7 +329,9 @@ export async function getAllModels() {
   const cached = getCached("allModels");
   if (cached) return cached;
   
-  console.warn(`[kos-cli] Scanning for models in KOS projects...`);
+  if (process.env.KOS_CLI_QUIET !== "true") {
+    console.warn(`[kos-cli] Scanning for models in KOS projects...`);
+  }
   const allKosProjects = await getAllKosProjects();
   const models = [];