@vc-shell/create-vc-app 2.0.3-pr222.ba0d3c5 → 2.0.3-pr223.4c0ddd9

package/README.md

@@ -5,15 +5,16 @@ Scaffolding tool for VC Shell applications and modules.
 ## Create a New Project
 
 ```bash
-npx @vc-shell/create-vc-app [project-name]
+npx create-vc-app [project-name]
 ```
 
-Interactive prompts guide you through project setup. Two project types are available:
+Interactive prompts guide you through project setup. Three project types are available:
 
 | Type               | Description                                        |
 | ------------------ | -------------------------------------------------- |
 | **Standalone App** | Full application with bundled modules              |
 | **Dynamic Module** | Remote module loaded by host via Module Federation |
+| **Host App**       | Shell that loads dynamic modules at runtime        |
 
 ### Non-Interactive Mode
 
@@ -21,35 +22,38 @@ Pass flags to skip prompts:
 
 ```bash
 # Standalone app with dashboard and sample data
-npx @vc-shell/create-vc-app my-app --type standalone --module-name "Products" --dashboard --mocks
+npx create-vc-app my-app --type standalone --module-name "Products" --dashboard --mocks
 
 # Dynamic module
-npx @vc-shell/create-vc-app my-module --type dynamic-module --module-name "Reviews"
+npx create-vc-app my-module --type dynamic-module --module-name "Reviews"
+
+# Host app with tenant routing and AI agent
+npx create-vc-app my-shell --type host-app --dashboard --tenant-routes --ai-agent
 ```
 
 ### Options
 
-| Option                 | Description                                      | Default                |
-| ---------------------- | ------------------------------------------------ | ---------------------- |
-| `--type <type>`        | Project type: `standalone` \| `dynamic-module` ` | _(prompted)_           |
-| `--name`, `--app-name` | Application name                                 | Directory name         |
-| `--package-name`       | npm package name                                 | App name (validated)   |
-| `--module-name`        | Initial module name                              | App name in title case |
-| `--base-path`          | Base path for the application                    | `/apps/<name>/`        |
-| `--tenant-routes`      | Include tenant routing (`/:tenantId` prefix)     | `false`                |
-| `--ai-agent`           | Include AI Agent configuration                   | `false`                |
-| `--dashboard`          | Include Dashboard with widgets                   | `false`                |
-| `--mocks`              | Include sample module with mock data             | `false`                |
-| `--overwrite`          | Overwrite existing files without confirmation    | `false`                |
-| `--help`, `-h`         | Show help                                        | —                      |
-| `--version`, `-v`      | Show version                                     | —                      |
+| Option                 | Description                                                  | Default                |
+| ---------------------- | ------------------------------------------------------------ | ---------------------- |
+| `--type <type>`        | Project type: `standalone` \| `dynamic-module` \| `host-app` | _(prompted)_           |
+| `--name`, `--app-name` | Application name                                             | Directory name         |
+| `--package-name`       | npm package name                                             | App name (validated)   |
+| `--module-name`        | Initial module name                                          | App name in title case |
+| `--base-path`          | Base path for the application                                | `/apps/<name>/`        |
+| `--tenant-routes`      | Include tenant routing (`/:tenantId` prefix)                 | `false`                |
+| `--ai-agent`           | Include AI Agent configuration                               | `false`                |
+| `--dashboard`          | Include Dashboard with widgets                               | `false`                |
+| `--mocks`              | Include sample module with mock data                         | `false`                |
+| `--overwrite`          | Overwrite existing files without confirmation                | `false`                |
+| `--help`, `-h`         | Show help                                                    | —                      |
+| `--version`, `-v`      | Show version                                                 | —                      |
 
 ## Add a Module to Existing Project
 
 From your project root:
 
 ```bash
-npx @vc-shell/create-vc-app add-module <module-name>
+npx create-vc-app add-module <module-name>
 ```
 
 This will:

package/dist/commands/add-module.d.ts

@@ -1,4 +1,2 @@
-import { CLIArgs } from '../types.js';
-
-export declare function addModuleCommand(args: CLIArgs, templateRoot: string): Promise<void>;
+export declare function addModuleCommand(args: Record<string, unknown>, templateRoot: string): Promise<void>;
 //# sourceMappingURL=add-module.d.ts.map

package/dist/commands/add-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-module.d.ts","sourceRoot":"","sources":["../../src/commands/add-module.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFzF"}
+{"version":3,"file":"add-module.d.ts","sourceRoot":"","sources":["../../src/commands/add-module.ts"],"names":[],"mappings":"AAQA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFzG"}

package/dist/commands/init.d.ts

@@ -1,4 +1,2 @@
-import { CLIArgs } from '../types.js';
-
-export declare function initCommand(args: CLIArgs, templateRoot: string): Promise<void>;
+export declare function initCommand(args: Record<string, unknown>, templateRoot: string): Promise<void>;
 //# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAA+B,MAAM,aAAa,CAAC;AAqBxE,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuNpF"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAqBA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkNpG"}

package/dist/index.js

@@ -1,30 +1,30 @@
 #!/usr/bin/env node
 import z from "mri";
-import n from "picocolors";
+import t from "picocolors";
 import c from "node:path";
-import { exit as L, argv as B } from "node:process";
-import { fileURLToPath as F } from "node:url";
+import { exit as U, argv as L } from "node:process";
+import { fileURLToPath as B } from "node:url";
 import A from "prompts";
 import r from "node:fs";
-import E from "ejs";
-const O = "2.0.3", V = {
-  version: O
+import T from "ejs";
+const F = "2.0.3", O = {
+  version: F
 };
 function h(e) {
   return e.trim().replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase().replace(/[^a-z0-9-]/g, "");
 }
 function x(e) {
-  return e.replace(/[-_\s]+(.)?/g, (a, t) => t ? t.toUpperCase() : "").replace(/^(.)/, (a, t) => t.toUpperCase());
+  return e.replace(/[-_\s]+(.)?/g, (n, a) => a ? a.toUpperCase() : "").replace(/^(.)/, (n, a) => a.toUpperCase());
 }
-function Z(e) {
-  const a = x(e);
-  return a.charAt(0).toLowerCase() + a.slice(1);
+function V(e) {
+  const n = x(e);
+  return n.charAt(0).toLowerCase() + n.slice(1);
 }
-function D(e) {
+function E(e) {
   return e.replace(/[-\s]+/g, "_").replace(/([a-z])([A-Z])/g, "$1_$2").toUpperCase();
 }
 function S(e) {
-  return e.replace(/[-_]+/g, " ").replace(/\b\w/g, (a) => a.toUpperCase());
+  return e.replace(/[-_]+/g, " ").replace(/\b\w/g, (n) => n.toUpperCase());
 }
 function k(e) {
   return /^(?:@[a-z0-9-*~][a-z0-9-*._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(e);
@@ -35,19 +35,19 @@ function C(e) {
 function _(e) {
   return e.trim().toLowerCase().replace(/\/+/g, "/").replace(/[^a-z0-9/-]+/g, "/").replace(/\/?$/, "/");
 }
-function R(e) {
-  const a = e.moduleName || "", t = a ? h(a) : "", s = {
+function D(e) {
+  const n = e.moduleName || "", a = n ? h(n) : "", s = {
     hasModule: !!e.moduleName,
-    ModuleName: t,
-    ModuleNamePascalCase: a ? x(a) : "",
-    ModuleNameCamelCase: a ? Z(a) : "",
-    ModuleNameUppercase: t.toUpperCase(),
-    ModuleNameScreamingSnake: a ? D(a) : "",
-    ModuleNameSentenceCase: a ? S(a) : ""
+    ModuleName: a,
+    ModuleNamePascalCase: n ? x(n) : "",
+    ModuleNameCamelCase: n ? V(n) : "",
+    ModuleNameUppercase: a.toUpperCase(),
+    ModuleNameScreamingSnake: n ? E(n) : "",
+    ModuleNameSentenceCase: n ? S(n) : ""
   };
   return e.projectName && (s.AppName = h(e.projectName), s.AppNameSentenceCase = S(e.projectName)), e.packageName !== void 0 && (s.PackageName = e.packageName || "", s.BasePath = e.basePath || "", s.tenantRoutes = e.tenantRoutes || !1, s.aiAgent = e.aiAgent || !1, s.dashboard = e.dashboard || !1, s.mocks = e.mocks || !1), s;
 }
-const J = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".pdf", ".zip"]), K = {
+const Z = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".pdf", ".zip"]), J = {
   _gitignore: ".gitignore",
   "_yarnrc.yml": ".yarnrc.yml",
   _browserslistrc: ".browserslistrc",
@@ -62,97 +62,90 @@ const J = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ic
   _yarn: ".yarn",
   "_package.json": "package.json"
 };
-function Y(e, a, t) {
-  a.endsWith(".ejs") && (a = a.slice(0, -4));
-  const s = c.dirname(a);
+function K(e, n, a) {
+  n.endsWith(".ejs") && (n = n.slice(0, -4));
+  const s = c.dirname(n);
   r.existsSync(s) || r.mkdirSync(s, { recursive: !0 });
   const o = c.extname(e.replace(/\.ejs$/, "")).toLowerCase();
-  if (J.has(o))
-    r.copyFileSync(e, a);
+  if (Z.has(o))
+    r.copyFileSync(e, n);
   else {
-    const d = r.readFileSync(e, "utf-8"), p = E.render(d, t, { filename: e });
-    r.writeFileSync(a, p);
+    const d = r.readFileSync(e, "utf-8"), p = T.render(d, a, { filename: e });
+    r.writeFileSync(n, p);
   }
 }
-function j(e, a, t) {
+function b(e, n, a) {
   if (!r.existsSync(e)) return;
   const s = r.readdirSync(e);
   for (const o of s) {
     const d = c.join(e, o), p = o.endsWith(".ejs") ? o.slice(0, -4) : o;
-    let m = K[p] ?? p;
+    let m = J[p] ?? p;
     try {
-      m = E.render(m, t);
+      m = T.render(m, a);
     } catch {
     }
-    const l = c.join(a, m);
-    r.statSync(d).isDirectory() ? (r.existsSync(l) || r.mkdirSync(l, { recursive: !0 }), j(d, l, t)) : Y(d, l, t);
+    const l = c.join(n, m);
+    r.statSync(d).isDirectory() ? (r.existsSync(l) || r.mkdirSync(l, { recursive: !0 }), b(d, l, a)) : K(d, l, a);
   }
 }
-function q(e) {
+function Y(e) {
   if (r.existsSync(e))
-    for (const a of r.readdirSync(e)) {
-      if (a === ".git") continue;
-      const t = c.join(e, a);
-      r.statSync(t).isDirectory() ? r.rmSync(t, { recursive: !0, force: !0 }) : r.unlinkSync(t);
+    for (const n of r.readdirSync(e)) {
+      if (n === ".git") continue;
+      const a = c.join(e, n);
+      r.statSync(a).isDirectory() ? r.rmSync(a, { recursive: !0, force: !0 }) : r.unlinkSync(a);
     }
 }
 function I(e) {
   if (!r.existsSync(e)) return !0;
-  const a = r.readdirSync(e);
-  return a.length === 0 || a.length === 1 && a[0] === ".git";
+  const n = r.readdirSync(e);
+  return n.length === 0 || n.length === 1 && n[0] === ".git";
 }
-const W = {
+const q = {
   standalone: "Standalone App",
   "dynamic-module": "Dynamic Module"
 };
-function H(e) {
-  const a = W[e.projectType] ?? e.projectType, t = !!e.moduleName;
+function W(e) {
+  const n = q[e.projectType], a = !!e.moduleName;
   console.log(`
-  ${n.green("╭─────────────────────────────────────────╮")}
-  ${n.green("│")}                                         ${n.green("│")}
-  ${n.green("│")}   ${n.bold("VC Shell App created successfully!")}    ${n.green("│")}
-  ${n.green("│")}                                         ${n.green("│")}
-  ${n.green("│")}   Project: ${n.cyan(e.projectName.padEnd(28))}${n.green("│")}
-  ${n.green("│")}   Type:    ${n.cyan(a.padEnd(28))}${n.green("│")}
-${t && e.moduleName ? `  ${n.green("│")}   Module:  ${n.cyan(e.moduleName.padEnd(28))}${n.green("│")}
-` : ""}  ${n.green("│")}                                         ${n.green("│")}
-  ${n.green("╰─────────────────────────────────────────╯")}
+  ${t.green("╭─────────────────────────────────────────╮")}
+  ${t.green("│")}                                         ${t.green("│")}
+  ${t.green("│")}   ${t.bold("VC Shell App created successfully!")}    ${t.green("│")}
+  ${t.green("│")}                                         ${t.green("│")}
+  ${t.green("│")}   Project: ${t.cyan(e.projectName.padEnd(28))}${t.green("│")}
+  ${t.green("│")}   Type:    ${t.cyan(n.padEnd(28))}${t.green("│")}
+${a && e.moduleName ? `  ${t.green("│")}   Module:  ${t.cyan(e.moduleName.padEnd(28))}${t.green("│")}
+` : ""}  ${t.green("│")}                                         ${t.green("│")}
+  ${t.green("╰─────────────────────────────────────────╯")}
 
-  ${n.bold("Next steps:")}
+  ${t.bold("Next steps:")}
 
   1. cd ${e.projectName}
   2. yarn install
   3. yarn serve
-${t && e.moduleName ? `
+${a && e.moduleName ? `
   Module is ready at:
-  src/modules/${X(e.moduleName)}/
+  src/modules/${H(e.moduleName)}/
 ` : ""}
-  ${n.dim("Docs: https://docs.virtocommerce.org/platform/developer-guide/latest/custom-apps-development/vc-shell/vc-shell-overview/")}
+  ${t.dim("Docs: https://docs.virtocommerce.org/platform/developer-guide/latest/custom-apps-development/vc-shell/vc-shell-overview/")}
 `);
 }
-function X(e) {
+function H(e) {
   return e.trim().replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase().replace(/[^a-z0-9-]/g, "");
 }
-const P = [
+const X = [
   { title: "Standalone App — full application with bundled modules", value: "standalone" },
   { title: "Dynamic Module — remote module loaded by host via Module Federation", value: "dynamic-module" }
 ];
-function G(e) {
-  return typeof e == "string" && P.some((a) => a.value === e);
-}
-async function Q(e, a) {
-  const t = process.cwd();
+async function G(e, n) {
+  const a = process.cwd();
   let o = e._?.[0] || e.name || e["app-name"];
   const d = o || "vc-app", p = () => o === "." ? c.basename(c.resolve()) : o, m = !!(o && e.type);
   let l;
   if (m) {
     o = o || d;
-    const f = c.resolve(t, o);
-    if (!G(e.type)) {
-      const b = P.map(($) => $.value).join(", ");
-      console.error(n.red(`Unknown project type: "${e.type}". Valid types: ${b}`)), process.exit(1);
-    }
-    r.existsSync(f) && !I(f) && !e.overwrite && (console.error(n.red(`Target directory "${o}" is not empty. Use --overwrite to overwrite.`)), process.exit(1));
+    const f = c.resolve(a, o);
+    r.existsSync(f) && !I(f) && !e.overwrite && (console.error(t.red(`Target directory "${o}" is not empty. Use --overwrite to overwrite.`)), process.exit(1));
     const u = p(), y = e.type, g = e["module-name"], N = y === "dynamic-module" ? g || S(u) : g || void 0;
     l = {
       projectName: h(u),
@@ -167,7 +160,7 @@ async function Q(e, a) {
     };
   } else {
     const f = () => {
-      throw new Error(n.red("✖") + " Creation cancelled");
+      throw new Error(t.red("✖") + " Creation cancelled");
     };
     try {
       const u = await A(
@@ -175,7 +168,7 @@ async function Q(e, a) {
           {
             name: "projectName",
             type: o ? null : "text",
-            message: n.reset("Project name:"),
+            message: t.reset("Project name:"),
             initial: d,
             onState: (w) => {
               o = h(String(w.value).trim()) || d;
@@ -183,14 +176,14 @@ async function Q(e, a) {
             format: (w) => h(String(w).trim())
           },
           {
-            type: () => !r.existsSync(c.resolve(t, o)) || I(c.resolve(t, o)) ? null : "confirm",
+            type: () => !r.existsSync(c.resolve(a, o)) || I(c.resolve(a, o)) ? null : "confirm",
             name: "overwrite",
             message: () => (o === "." ? "Current directory" : `Target directory "${o}"`) + " is not empty. Remove existing files and continue?"
           },
           {
             type: (w, { overwrite: M }) => {
               if (M === !1)
-                throw new Error(n.red("✖") + " Operation cancelled");
+                throw new Error(t.red("✖") + " Operation cancelled");
               return null;
             },
             name: "overwriteChecker"
@@ -198,19 +191,19 @@ async function Q(e, a) {
           {
             name: "packageName",
             type: () => k(p()) ? null : "text",
-            message: n.reset("Package name:"),
+            message: t.reset("Package name:"),
             initial: () => C(p()),
             validate: (w) => k(w) || "Invalid package.json name"
           },
           {
             type: "select",
             name: "projectType",
-            message: n.reset("Project type:"),
-            choices: P
+            message: t.reset("Project type:"),
+            choices: X
           }
         ],
         { onCancel: f }
-      ), y = o ? h(o) : u.projectName, g = u.projectType || "standalone", N = S(y), b = "/apps/" + h(y) + "/", $ = await A(
+      ), y = o ? h(o) : u.projectName, g = u.projectType || "standalone", N = S(y), j = "/apps/" + h(y) + "/", $ = await A(
         [
           {
             name: "includeModule",
@@ -221,15 +214,15 @@ async function Q(e, a) {
           {
             name: "moduleName",
             type: (w, M) => g === "standalone" && !M.includeModule ? null : "text",
-            message: n.reset("Module name:"),
+            message: t.reset("Module name:"),
             initial: N,
             format: (w) => String(w).trim()
           },
           {
             name: "basePath",
             type: g === "dynamic-module" ? null : "text",
-            message: n.reset("Base path:"),
-            initial: b,
+            message: t.reset("Base path:"),
+            initial: j,
             format: (w) => _(String(w).trim())
           },
           {
@@ -264,7 +257,7 @@ async function Q(e, a) {
         packageName: u.packageName || (k(y) ? y : C(y)),
         projectType: g,
         moduleName: $.moduleName || ($.includeModule !== !1 ? N : void 0),
-        basePath: $.basePath || _(b),
+        basePath: $.basePath || _(j),
         tenantRoutes: $.tenantRoutes || !1,
         aiAgent: $.aiAgent || !1,
         dashboard: $.dashboard ?? !0,
@@ -274,59 +267,59 @@ async function Q(e, a) {
       console.log(u.message), process.exit(1);
     }
   }
-  const i = c.resolve(t, o);
-  r.existsSync(i) && !I(i) ? q(i) : r.existsSync(i) || r.mkdirSync(i, { recursive: !0 }), console.log(`
-  Scaffolding ${n.cyan(l.projectType)} in ${n.green(i)}...
+  const i = c.resolve(a, o);
+  r.existsSync(i) && !I(i) ? Y(i) : r.existsSync(i) || r.mkdirSync(i, { recursive: !0 }), console.log(`
+  Scaffolding ${t.cyan(l.projectType)} in ${t.green(i)}...
 `);
-  const v = R(l);
-  if (j(c.join(a, l.projectType), i, v), l.moduleName) {
+  const v = D(l);
+  if (b(c.join(n, l.projectType), i, v), l.moduleName) {
     const f = h(l.moduleName), u = l.projectType === "dynamic-module" ? c.join(i, "src/modules") : c.join(i, "src/modules", f);
-    j(c.join(a, "module"), u, v);
+    b(c.join(n, "module"), u, v);
   }
-  l.mocks && j(c.join(a, "sample-module"), c.join(i, "src/modules/sample"), v), H(l);
+  l.mocks && b(c.join(n, "sample-module"), c.join(i, "src/modules/sample"), v), W(l);
 }
-function U(e, a) {
-  const t = /^import\s.+$/gm;
+function R(e, n) {
+  const a = /^import\s.+$/gm;
   let s = null, o;
-  for (; (o = t.exec(e)) !== null; )
+  for (; (o = a.exec(e)) !== null; )
     s = o;
   if (s) {
     const d = s.index + s[0].length;
     return e.slice(0, d) + `
-` + a + e.slice(d);
+` + n + e.slice(d);
   }
-  return a + `
+  return n + `
 ` + e;
 }
-function ee(e, a) {
-  let t = r.readFileSync(e, "utf-8");
-  const s = x(a), o = h(a);
-  t = U(t, `import ${s} from "./modules/${o}";`);
+function Q(e, n) {
+  let a = r.readFileSync(e, "utf-8");
+  const s = x(n), o = h(n);
+  a = R(a, `import ${s} from "./modules/${o}";`);
   const d = /\.use\([A-Z]\w+,\s*\{\s*router\s*\}\)/g;
   let p = null, m;
-  for (; (m = d.exec(t)) !== null; )
+  for (; (m = d.exec(a)) !== null; )
     p = m;
   if (p) {
     const l = p.index + p[0].length, i = `
     .use(${s}, { router })`;
-    t = t.slice(0, l) + i + t.slice(l);
+    a = a.slice(0, l) + i + a.slice(l);
   }
-  r.writeFileSync(e, t);
+  r.writeFileSync(e, a);
 }
-function te(e, a) {
-  let t = r.readFileSync(e, "utf-8");
-  const s = h(a), o = D(a);
-  if (!t.includes("addMenuItem")) {
-    const v = /import\s*\{([^}]+)\}\s*from\s*["']@vc-shell\/framework["']/.exec(t);
+function ee(e, n) {
+  let a = r.readFileSync(e, "utf-8");
+  const s = h(n), o = E(n);
+  if (!a.includes("addMenuItem")) {
+    const v = /import\s*\{([^}]+)\}\s*from\s*["']@vc-shell\/framework["']/.exec(a);
     if (v) {
       const f = v[1].trim() + ", addMenuItem";
-      t = t.replace(v[0], `import { ${f} } from "@vc-shell/framework"`);
+      a = a.replace(v[0], `import { ${f} } from "@vc-shell/framework"`);
     } else
-      t = U(t, 'import { addMenuItem } from "@vc-shell/framework";');
+      a = R(a, 'import { addMenuItem } from "@vc-shell/framework";');
   }
   const d = /addMenuItem\(\{[\s\S]*?\}\);/g;
   let p = null, m;
-  for (; (m = d.exec(t)) !== null; )
+  for (; (m = d.exec(a)) !== null; )
     p = m;
   const l = `
   addMenuItem({
@@ -337,59 +330,59 @@ function te(e, a) {
   });`;
   if (p) {
     const i = p.index + p[0].length;
-    t = t.slice(0, i) + `
-` + l + t.slice(i);
+    a = a.slice(0, i) + `
+` + l + a.slice(i);
   } else {
-    const i = t.lastIndexOf("}");
-    i !== -1 && (t = t.slice(0, i) + l + `
-` + t.slice(i));
+    const i = a.lastIndexOf("}");
+    i !== -1 && (a = a.slice(0, i) + l + `
+` + a.slice(i));
   }
-  r.writeFileSync(e, t);
+  r.writeFileSync(e, a);
 }
-async function ae(e, a) {
-  const t = process.cwd(), s = e._?.[1], o = c.join(t, "package.json");
-  r.existsSync(o) || (console.error(n.red("Error: No package.json found. Run this command from a vc-shell project root.")), process.exit(1));
+async function ae(e, n) {
+  const a = process.cwd(), s = e._?.[1], o = c.join(a, "package.json");
+  r.existsSync(o) || (console.error(t.red("Error: No package.json found. Run this command from a vc-shell project root.")), process.exit(1));
   const d = JSON.parse(r.readFileSync(o, "utf-8"));
-  ({ ...d.dependencies, ...d.devDependencies })["@vc-shell/framework"] || (console.error(n.red("Error: Not a vc-shell project (@vc-shell/framework not found in dependencies).")), process.exit(1));
+  ({ ...d.dependencies, ...d.devDependencies })["@vc-shell/framework"] || (console.error(t.red("Error: Not a vc-shell project (@vc-shell/framework not found in dependencies).")), process.exit(1));
   let m = s;
   m || (m = (await A({
     type: "text",
     name: "moduleName",
     message: "Module name:",
-    validate: (b) => b.trim().length > 0 || "Module name is required"
-  })).moduleName), m || (console.error(n.red("Module name is required.")), process.exit(1));
-  const l = h(m), i = x(m), v = c.join(t, "src/modules"), f = c.join(v, l);
-  r.existsSync(v) || r.mkdirSync(v, { recursive: !0 }), r.existsSync(f) && (console.error(n.red(`Error: Module "${l}" already exists at ${c.relative(t, f)}`)), process.exit(1));
-  const u = R({ moduleName: m, projectName: c.basename(t) });
-  j(c.join(a, "module"), f, u), console.log(n.green(`  ✔ Created ${c.relative(t, f)}/`));
-  const y = c.join(t, "src/main.ts");
+    validate: (j) => j.trim().length > 0 || "Module name is required"
+  })).moduleName), m || (console.error(t.red("Module name is required.")), process.exit(1));
+  const l = h(m), i = x(m), v = c.join(a, "src/modules"), f = c.join(v, l);
+  r.existsSync(v) || r.mkdirSync(v, { recursive: !0 }), r.existsSync(f) && (console.error(t.red(`Error: Module "${l}" already exists at ${c.relative(a, f)}`)), process.exit(1));
+  const u = D({ moduleName: m, projectName: c.basename(a) });
+  b(c.join(n, "module"), f, u), console.log(t.green(`  ✔ Created ${c.relative(a, f)}/`));
+  const y = c.join(a, "src/main.ts");
   if (r.existsSync(y))
     try {
-      ee(y, m), console.log(n.green(`  ✔ Updated src/main.ts — added import & app.use(${i})`));
+      Q(y, m), console.log(t.green(`  ✔ Updated src/main.ts — added import & app.use(${i})`));
     } catch {
-      console.warn(n.yellow("  ⚠ Could not auto-update src/main.ts. Add manually:")), console.warn(n.yellow(`    import ${i} from "./modules/${l}";`)), console.warn(n.yellow(`    app.use(${i}, { router });`));
+      console.warn(t.yellow("  ⚠ Could not auto-update src/main.ts. Add manually:")), console.warn(t.yellow(`    import ${i} from "./modules/${l}";`)), console.warn(t.yellow(`    app.use(${i}, { router });`));
     }
-  const g = c.join(t, "src/bootstrap.ts");
+  const g = c.join(a, "src/bootstrap.ts");
   if (r.existsSync(g))
     try {
-      te(g, m), console.log(n.green(`  ✔ Updated src/bootstrap.ts — added menu item "${S(m)}"`));
+      ee(g, m), console.log(t.green(`  ✔ Updated src/bootstrap.ts — added menu item "${S(m)}"`));
     } catch {
-      console.warn(n.yellow("  ⚠ Could not auto-update src/bootstrap.ts. Add addMenuItem() manually."));
+      console.warn(t.yellow("  ⚠ Could not auto-update src/bootstrap.ts. Add addMenuItem() manually."));
     }
   console.log(`
-  Module "${l}" is ready! Run ${n.bold(n.green("yarn serve"))} to see it.
+  Module "${l}" is ready! Run ${t.bold(t.green("yarn serve"))} to see it.
 `);
 }
-const T = c.resolve(F(import.meta.url), "..", "templates");
-function ne() {
+const P = c.resolve(B(import.meta.url), "..", "templates");
+function te() {
   console.log(`
-${n.bold(n.green("create-vc-app"))} — Create VC Shell applications and modules
+${t.bold(t.green("create-vc-app"))} — Create VC Shell applications and modules
 
-${n.bold("Usage:")}
+${t.bold("Usage:")}
   create-vc-app [project-name] [options]     Create a new project
   create-vc-app add-module <module-name>     Add a module to existing project
 
-${n.bold("Options (create):")}
+${t.bold("Options (create):")}
   --type <type>              Project type: standalone | dynamic-module
   --name, --app-name <name>  Application name
   --package-name <name>      npm package name
@@ -403,31 +396,31 @@ ${n.bold("Options (create):")}
   --help, -h                 Show this help
   --version, -v              Show version
 
-${n.bold("Examples:")}
+${t.bold("Examples:")}
   create-vc-app my-app
   create-vc-app my-app --type standalone --dashboard --mocks
   create-vc-app my-module --type dynamic-module --module-name "Reviews"
   create-vc-app add-module orders
 
-${n.bold("Docs:")} https://docs.virtocommerce.org/platform/developer-guide/latest/custom-apps-development/vc-shell/vc-shell-overview/
+${t.bold("Docs:")} https://docs.virtocommerce.org/platform/developer-guide/latest/custom-apps-development/vc-shell/vc-shell-overview/
 `);
 }
-async function oe() {
-  const e = z(B.slice(2), {
+async function ne() {
+  const e = z(L.slice(2), {
     alias: { h: "help", v: "version" },
     boolean: ["help", "version", "mocks", "overwrite", "tenant-routes", "ai-agent", "dashboard"],
     string: ["type", "name", "app-name", "package-name", "module-name", "base-path"]
   });
   if (e.help) {
-    ne();
+    te();
     return;
   }
   if (e.version) {
-    console.log(`create-vc-app v${V.version}`);
+    console.log(`create-vc-app v${O.version}`);
     return;
   }
-  e._[0] === "add-module" ? await ae(e, T) : await Q(e, T);
+  e._[0] === "add-module" ? await ae(e, P) : await G(e, P);
 }
-oe().catch((e) => {
-  console.error(n.red(e.message || String(e))), L(1);
+ne().catch((e) => {
+  console.error(t.red(e.message || String(e))), U(1);
 });

package/dist/templates/host-app/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) Virto Solutions LTD. All rights reserved.
+
+Licensed under the Virto Commerce Open Software License (the "License"); you
+may not use this file except in compliance with the License. You may
+obtain a copy of the License at
+
+https://virtocommerce.com/open-source-license
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied.