@vc-shell/create-vc-app 2.4.0-pr302.99e48e1 → 2.4.0-pr302.b052b38

package/dist/engine/codegen.d.ts

@@ -1,9 +1,12 @@
 /**
- * Add a module import and app.use() call to main.ts
+ * Add a module import and its `app.use()` registration to main.ts.
+ *
+ * Throws when either anchor is missing, so the caller can tell the user what to
+ * add by hand rather than reporting a change it did not make.
  */
 export declare function addModuleToMain(mainTsPath: string, moduleName: string): void;
 /**
- * Add a menu item registration to bootstrap.ts
+ * Add a menu item registration to bootstrap.ts, after the last existing one.
  */
 export declare function addMenuItemToBootstrap(bootstrapPath: string, moduleName: string): void;
 //# sourceMappingURL=codegen.d.ts.map

package/dist/engine/codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/engine/codegen.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAuB5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAsCtF"}
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/engine/codegen.ts"],"names":[],"mappings":"AA6IA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CA2B5E;AAiCD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAsCtF"}

package/dist/engine/codegen.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=codegen.test.d.ts.map

package/dist/engine/codegen.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.test.d.ts","sourceRoot":"","sources":["../../src/engine/codegen.test.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -1,54 +1,54 @@
 #!/usr/bin/env node
-import B from "mri";
-import a from "picocolors";
-import c from "node:path";
-import { exit as O, argv as V } from "node:process";
-import { fileURLToPath as K } from "node:url";
+import K from "mri";
+import r from "picocolors";
+import m from "node:path";
+import { exit as J, argv as Y } from "node:process";
+import { fileURLToPath as Z } from "node:url";
 import P from "prompts";
-import r from "node:fs";
-import D from "ejs";
-import C from "prettier";
-const Z = "2.4.0-pr302.99e48e1", J = {
-  version: Z
+import i from "node:fs";
+import F from "ejs";
+import I from "prettier";
+const q = "2.4.0-pr302.b052b38", W = {
+  version: q
 };
-function h(e) {
+function v(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, (n, t) => t ? t.toUpperCase() : "").replace(/^(.)/, (n, t) => t.toUpperCase());
+function M(e) {
+  return e.replace(/[-_\s]+(.)?/g, (t, n) => n ? n.toUpperCase() : "").replace(/^(.)/, (t, n) => n.toUpperCase());
 }
-function Y(e) {
-  const n = x(e);
-  return n.charAt(0).toLowerCase() + n.slice(1);
+function G(e) {
+  const t = M(e);
+  return t.charAt(0).toLowerCase() + t.slice(1);
 }
-function R(e) {
+function O(e) {
   return e.replace(/[-\s]+/g, "_").replace(/([a-z])([A-Z])/g, "$1_$2").toUpperCase();
 }
-function j(e) {
-  return e.replace(/[-_]+/g, " ").replace(/\b\w/g, (n) => n.toUpperCase());
+function x(e) {
+  return e.replace(/[-_]+/g, " ").replace(/\b\w/g, (t) => t.toUpperCase());
 }
-function k(e) {
+function N(e) {
   return /^(?:@[a-z0-9-*~][a-z0-9-*._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(e);
 }
-function _(e) {
+function A(e) {
   return e.trim().toLowerCase().replace(/\s+/g, "-").replace(/^[._]/, "").replace(/[^a-z0-9-~]+/g, "-");
 }
-function I(e) {
+function E(e) {
   return e.trim().toLowerCase().replace(/\/+/g, "/").replace(/[^a-z0-9/-]+/g, "/").replace(/\/?$/, "/");
 }
-function F(e) {
-  const n = e.moduleName || "", t = n ? h(n) : "", s = {
+function U(e) {
+  const t = e.moduleName || "", n = t ? v(t) : "", o = {
     hasModule: !!e.moduleName,
-    ModuleName: t,
-    ModuleNamePascalCase: n ? x(n) : "",
-    ModuleNameCamelCase: n ? Y(n) : "",
-    ModuleNameUppercase: t.toUpperCase(),
-    ModuleNameScreamingSnake: n ? R(n) : "",
-    ModuleNameSentenceCase: n ? j(n) : ""
+    ModuleName: n,
+    ModuleNamePascalCase: t ? M(t) : "",
+    ModuleNameCamelCase: t ? G(t) : "",
+    ModuleNameUppercase: n.toUpperCase(),
+    ModuleNameScreamingSnake: t ? O(t) : "",
+    ModuleNameSentenceCase: t ? x(t) : ""
   };
-  return e.projectName && (s.AppName = h(e.projectName), s.AppNameSentenceCase = j(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;
+  return e.projectName && (o.AppName = v(e.projectName), o.AppNameSentenceCase = x(e.projectName)), e.packageName !== void 0 && (o.PackageName = e.packageName || "", o.BasePath = e.basePath || "", o.tenantRoutes = e.tenantRoutes || !1, o.aiAgent = e.aiAgent || !1, o.dashboard = e.dashboard || !1, o.mocks = e.mocks || !1), o;
 }
-const q = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".pdf", ".zip"]), W = {
+const H = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".pdf", ".zip"]), X = {
   _gitignore: ".gitignore",
   "_yarnrc.yml": ".yarnrc.yml",
   _browserslistrc: ".browserslistrc",
@@ -63,177 +63,177 @@ const q = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ic
   _yarn: ".yarn",
   "_package.json": "package.json"
 };
-function G(e, n, t) {
-  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 (q.has(o))
-    r.copyFileSync(e, n);
+function Q(e, t, n) {
+  t.endsWith(".ejs") && (t = t.slice(0, -4));
+  const o = m.dirname(t);
+  i.existsSync(o) || i.mkdirSync(o, { recursive: !0 });
+  const a = m.extname(e.replace(/\.ejs$/, "")).toLowerCase();
+  if (H.has(a))
+    i.copyFileSync(e, t);
   else {
-    const d = r.readFileSync(e, "utf-8"), p = D.render(d, t, { filename: e });
-    r.writeFileSync(n, p);
+    const l = i.readFileSync(e, "utf-8"), s = F.render(l, n, { filename: e });
+    i.writeFileSync(t, s);
   }
 }
-function b(e, n, t) {
-  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 = W[p] ?? p;
+function j(e, t, n) {
+  if (!i.existsSync(e)) return;
+  const o = i.readdirSync(e);
+  for (const a of o) {
+    const l = m.join(e, a), s = a.endsWith(".ejs") ? a.slice(0, -4) : a;
+    let c = X[s] ?? s;
     try {
-      m = D.render(m, t);
+      c = F.render(c, n);
     } catch {
     }
-    const i = c.join(n, m);
-    r.statSync(d).isDirectory() ? (r.existsSync(i) || r.mkdirSync(i, { recursive: !0 }), b(d, i, t)) : G(d, i, t);
+    const d = m.join(t, c);
+    i.statSync(l).isDirectory() ? (i.existsSync(d) || i.mkdirSync(d, { recursive: !0 }), j(l, d, n)) : Q(l, d, n);
   }
 }
-function H(e) {
-  if (r.existsSync(e))
-    for (const n of r.readdirSync(e)) {
-      if (n === ".git") continue;
-      const t = c.join(e, n);
-      r.statSync(t).isDirectory() ? r.rmSync(t, { recursive: !0, force: !0 }) : r.unlinkSync(t);
+function ee(e) {
+  if (i.existsSync(e))
+    for (const t of i.readdirSync(e)) {
+      if (t === ".git") continue;
+      const n = m.join(e, t);
+      i.statSync(n).isDirectory() ? i.rmSync(n, { recursive: !0, force: !0 }) : i.unlinkSync(n);
     }
 }
-function A(e) {
-  if (!r.existsSync(e)) return !0;
-  const n = r.readdirSync(e);
-  return n.length === 0 || n.length === 1 && n[0] === ".git";
+function T(e) {
+  if (!i.existsSync(e)) return !0;
+  const t = i.readdirSync(e);
+  return t.length === 0 || t.length === 1 && t[0] === ".git";
 }
-const X = /* @__PURE__ */ new Set(["node_modules", ".git", ".yarn", "dist"]);
-function U(e, n = []) {
-  if (!r.existsSync(e)) return n;
-  if (!r.statSync(e).isDirectory())
-    return n.push(e), n;
-  for (const t of r.readdirSync(e))
-    X.has(t) || U(c.join(e, t), n);
-  return n;
+const te = /* @__PURE__ */ new Set(["node_modules", ".git", ".yarn", "dist"]);
+function L(e, t = []) {
+  if (!i.existsSync(e)) return t;
+  if (!i.statSync(e).isDirectory())
+    return t.push(e), t;
+  for (const n of i.readdirSync(e))
+    te.has(n) || L(m.join(e, n), t);
+  return t;
 }
 async function z(e) {
-  const n = e.flatMap((s) => U(s));
-  let t = 0;
-  for (const s of n)
+  const t = e.flatMap((o) => L(o));
+  let n = 0;
+  for (const o of t)
     try {
-      const o = await C.getFileInfo(s, { resolveConfig: !0 });
-      if (!o.inferredParser || o.ignored) continue;
-      const d = r.readFileSync(s, "utf-8"), p = await C.resolveConfig(s, { editorconfig: !0 }), m = await C.format(d, { ...p, filepath: s });
-      m !== d && (r.writeFileSync(s, m), t++);
+      const a = await I.getFileInfo(o, { resolveConfig: !0 });
+      if (!a.inferredParser || a.ignored) continue;
+      const l = i.readFileSync(o, "utf-8"), s = await I.resolveConfig(o, { editorconfig: !0 }), c = await I.format(l, { ...s, filepath: o });
+      c !== l && (i.writeFileSync(o, c), n++);
     } catch {
     }
-  return t;
+  return n;
 }
-const Q = {
+const ne = {
   standalone: "Standalone App",
   "dynamic-module": "Dynamic Module"
 };
-function ee(e) {
-  const n = Q[e.projectType] ?? e.projectType, t = !!e.moduleName;
+function oe(e) {
+  const t = ne[e.projectType] ?? e.projectType, n = !!e.moduleName;
   console.log(`
-  ${a.green("╭─────────────────────────────────────────╮")}
-  ${a.green("│")}                                         ${a.green("│")}
-  ${a.green("│")}   ${a.bold("VC Shell App created successfully!")}    ${a.green("│")}
-  ${a.green("│")}                                         ${a.green("│")}
-  ${a.green("│")}   Project: ${a.cyan(e.projectName.padEnd(28))}${a.green("│")}
-  ${a.green("│")}   Type:    ${a.cyan(n.padEnd(28))}${a.green("│")}
-${t && e.moduleName ? `  ${a.green("│")}   Module:  ${a.cyan(e.moduleName.padEnd(28))}${a.green("│")}
-` : ""}  ${a.green("│")}                                         ${a.green("│")}
-  ${a.green("╰─────────────────────────────────────────╯")}
+  ${r.green("╭─────────────────────────────────────────╮")}
+  ${r.green("│")}                                         ${r.green("│")}
+  ${r.green("│")}   ${r.bold("VC Shell App created successfully!")}    ${r.green("│")}
+  ${r.green("│")}                                         ${r.green("│")}
+  ${r.green("│")}   Project: ${r.cyan(e.projectName.padEnd(28))}${r.green("│")}
+  ${r.green("│")}   Type:    ${r.cyan(t.padEnd(28))}${r.green("│")}
+${n && e.moduleName ? `  ${r.green("│")}   Module:  ${r.cyan(e.moduleName.padEnd(28))}${r.green("│")}
+` : ""}  ${r.green("│")}                                         ${r.green("│")}
+  ${r.green("╰─────────────────────────────────────────╯")}
 
-  ${a.bold("Next steps:")}
+  ${r.bold("Next steps:")}
 
   1. cd ${e.projectName}
   2. yarn install
   3. yarn serve
-${t && e.moduleName ? `
+${n && e.moduleName ? `
   Module is ready at:
-  src/modules/${te(e.moduleName)}/
+  src/modules/${ae(e.moduleName)}/
 ` : ""}
-  ${a.dim("Docs: https://docs.virtocommerce.org/platform/developer-guide/latest/custom-apps-development/vc-shell/vc-shell-overview/")}
+  ${r.dim("Docs: https://docs.virtocommerce.org/platform/developer-guide/latest/custom-apps-development/vc-shell/vc-shell-overview/")}
 `);
 }
-function te(e) {
+function ae(e) {
   return e.trim().replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase().replace(/[^a-z0-9-]/g, "");
 }
-const T = [
+const D = [
   { 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 ne(e) {
-  return typeof e == "string" && T.some((n) => n.value === e);
+function re(e) {
+  return typeof e == "string" && D.some((t) => t.value === e);
 }
-async function ae(e, n) {
-  const t = 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 i;
-  if (m) {
-    o = o || d;
-    const f = c.resolve(t, o);
-    if (!ne(e.type)) {
-      const N = T.map((S) => S.value).join(", ");
-      console.error(a.red(`Unknown project type: "${e.type}". Valid types: ${N}`)), process.exit(1);
+async function se(e, t) {
+  const n = process.cwd();
+  let a = e._?.[0] || e.name || e["app-name"];
+  const l = a || "vc-app", s = () => a === "." ? m.basename(m.resolve()) : a, c = !!(a && e.type);
+  let d;
+  if (c) {
+    a = a || l;
+    const y = m.resolve(n, a);
+    if (!re(e.type)) {
+      const S = D.map(($) => $.value).join(", ");
+      console.error(r.red(`Unknown project type: "${e.type}". Valid types: ${S}`)), process.exit(1);
     }
-    r.existsSync(f) && !A(f) && !e.overwrite && (console.error(a.red(`Target directory "${o}" is not empty. Use --overwrite to overwrite.`)), process.exit(1));
-    const u = p(), y = e.type, g = e["module-name"], $ = y === "dynamic-module" ? g || j(u) : g || void 0;
-    i = {
-      projectName: h(u),
-      packageName: e["package-name"] || (k(u) ? u : _(u)),
-      projectType: y,
-      moduleName: $,
-      basePath: e["base-path"] || I(`/apps/${h(u)}/`),
+    i.existsSync(y) && !T(y) && !e.overwrite && (console.error(r.red(`Target directory "${a}" is not empty. Use --overwrite to overwrite.`)), process.exit(1));
+    const f = s(), h = e.type, g = e["module-name"], b = h === "dynamic-module" ? g || x(f) : g || void 0;
+    d = {
+      projectName: v(f),
+      packageName: e["package-name"] || (N(f) ? f : A(f)),
+      projectType: h,
+      moduleName: b,
+      basePath: e["base-path"] || E(`/apps/${v(f)}/`),
       tenantRoutes: e["tenant-routes"] || !1,
       aiAgent: e["ai-agent"] || !1,
       dashboard: e.dashboard || !1,
       mocks: e.mocks || !1
     };
   } else {
-    const f = () => {
-      throw new Error(a.red("✖") + " Creation cancelled");
+    const y = () => {
+      throw new Error(r.red("✖") + " Creation cancelled");
     };
     try {
-      const u = await P(
+      const f = await P(
         [
           {
             name: "projectName",
-            type: o ? null : "text",
-            message: a.reset("Project name:"),
-            initial: d,
+            type: a ? null : "text",
+            message: r.reset("Project name:"),
+            initial: l,
             onState: (w) => {
-              o = h(String(w.value).trim()) || d;
+              a = v(String(w.value).trim()) || l;
             },
-            format: (w) => h(String(w).trim())
+            format: (w) => v(String(w).trim())
           },
           {
-            type: () => !r.existsSync(c.resolve(t, o)) || A(c.resolve(t, o)) ? null : "confirm",
+            type: () => !i.existsSync(m.resolve(n, a)) || T(m.resolve(n, a)) ? null : "confirm",
             name: "overwrite",
-            message: () => (o === "." ? "Current directory" : `Target directory "${o}"`) + " is not empty. Remove existing files and continue?"
+            message: () => (a === "." ? "Current directory" : `Target directory "${a}"`) + " is not empty. Remove existing files and continue?"
           },
           {
-            type: (w, { overwrite: M }) => {
-              if (M === !1)
-                throw new Error(a.red("✖") + " Operation cancelled");
+            type: (w, { overwrite: _ }) => {
+              if (_ === !1)
+                throw new Error(r.red("✖") + " Operation cancelled");
               return null;
             },
             name: "overwriteChecker"
           },
           {
             name: "packageName",
-            type: () => k(p()) ? null : "text",
-            message: a.reset("Package name:"),
-            initial: () => _(p()),
-            validate: (w) => k(w) || "Invalid package.json name"
+            type: () => N(s()) ? null : "text",
+            message: r.reset("Package name:"),
+            initial: () => A(s()),
+            validate: (w) => N(w) || "Invalid package.json name"
           },
           {
             type: "select",
             name: "projectType",
-            message: a.reset("Project type:"),
-            choices: T
+            message: r.reset("Project type:"),
+            choices: D
           }
         ],
-        { onCancel: f }
-      ), y = o ? h(o) : u.projectName, g = u.projectType || "standalone", $ = j(y), N = "/apps/" + h(y) + "/", S = await P(
+        { onCancel: y }
+      ), h = a ? v(a) : f.projectName, g = f.projectType || "standalone", b = x(h), S = "/apps/" + v(h) + "/", $ = await P(
         [
           {
             name: "includeModule",
@@ -243,17 +243,17 @@ async function ae(e, n) {
           },
           {
             name: "moduleName",
-            type: (w, M) => g === "standalone" && !M.includeModule ? null : "text",
-            message: a.reset("Module name:"),
-            initial: $,
+            type: (w, _) => g === "standalone" && !_.includeModule ? null : "text",
+            message: r.reset("Module name:"),
+            initial: b,
             format: (w) => String(w).trim()
           },
           {
             name: "basePath",
             type: g === "dynamic-module" ? null : "text",
-            message: a.reset("Base path:"),
-            initial: N,
-            format: (w) => I(String(w).trim())
+            message: r.reset("Base path:"),
+            initial: S,
+            format: (w) => E(String(w).trim())
           },
           {
             type: g === "dynamic-module" ? null : "confirm",
@@ -280,139 +280,213 @@ async function ae(e, n) {
             initial: !1
           }
         ],
-        { onCancel: f }
+        { onCancel: y }
       );
-      i = {
-        projectName: y,
-        packageName: u.packageName || (k(y) ? y : _(y)),
+      d = {
+        projectName: h,
+        packageName: f.packageName || (N(h) ? h : A(h)),
         projectType: g,
-        moduleName: S.moduleName || (S.includeModule !== !1 ? $ : void 0),
-        basePath: S.basePath || I(N),
-        tenantRoutes: S.tenantRoutes || !1,
-        aiAgent: S.aiAgent || !1,
-        dashboard: S.dashboard ?? !0,
-        mocks: S.mocks || !1
+        moduleName: $.moduleName || ($.includeModule !== !1 ? b : void 0),
+        basePath: $.basePath || E(S),
+        tenantRoutes: $.tenantRoutes || !1,
+        aiAgent: $.aiAgent || !1,
+        dashboard: $.dashboard ?? !0,
+        mocks: $.mocks || !1
       };
-    } catch (u) {
-      console.log(u.message), process.exit(1);
+    } catch (f) {
+      console.log(f.message), process.exit(1);
     }
   }
-  const l = c.resolve(t, o);
-  r.existsSync(l) && !A(l) ? H(l) : r.existsSync(l) || r.mkdirSync(l, { recursive: !0 }), console.log(`
-  Scaffolding ${a.cyan(i.projectType)} in ${a.green(l)}...
+  const p = m.resolve(n, a);
+  i.existsSync(p) && !T(p) ? ee(p) : i.existsSync(p) || i.mkdirSync(p, { recursive: !0 }), console.log(`
+  Scaffolding ${r.cyan(d.projectType)} in ${r.green(p)}...
 `);
-  const v = F(i);
-  if (b(c.join(n, i.projectType), l, v), i.moduleName) {
-    const f = h(i.moduleName), u = i.projectType === "dynamic-module" ? c.join(l, "src/modules") : c.join(l, "src/modules", f);
-    b(c.join(n, "module"), u, v);
+  const u = U(d);
+  if (j(m.join(t, d.projectType), p, u), d.moduleName) {
+    const y = v(d.moduleName), f = d.projectType === "dynamic-module" ? m.join(p, "src/modules") : m.join(p, "src/modules", y);
+    j(m.join(t, "module"), f, u);
+  }
+  d.mocks && j(m.join(t, "sample-module"), m.join(p, "src/modules/sample"), u), await z([p]), oe(d);
+}
+function k(e, { strings: t = !0 } = {}) {
+  const n = e.split("");
+  let o = 0;
+  const a = (l, s) => {
+    for (let c = l; c < s && c < e.length; c++)
+      n[c] !== `
+` && (n[c] = " ");
+  };
+  for (; o < e.length; ) {
+    const l = e[o];
+    if (l === "/" && e[o + 1] === "/") {
+      const s = e.indexOf(`
+`, o), c = s === -1 ? e.length : s;
+      a(o, c), o = c;
+      continue;
+    }
+    if (l === "/" && e[o + 1] === "*") {
+      const s = e.indexOf("*/", o + 2), c = s === -1 ? e.length : s + 2;
+      a(o, c), o = c;
+      continue;
+    }
+    if (l === '"' || l === "'" || l === "`") {
+      let s = o + 1;
+      for (; s < e.length; ) {
+        if (e[s] === "\\") {
+          s += 2;
+          continue;
+        }
+        if (e[s] === l) break;
+        s++;
+      }
+      t && a(o + 1, s), o = s + 1;
+      continue;
+    }
+    o++;
   }
-  i.mocks && b(c.join(n, "sample-module"), c.join(l, "src/modules/sample"), v), await z([l]), ee(i);
+  return n.join("");
 }
-function L(e, n) {
-  const t = /^import\s.+$/gm;
-  let s = null, o;
-  for (; (o = t.exec(e)) !== null; )
-    s = o;
-  if (s) {
-    const d = s.index + s[0].length;
-    return e.slice(0, d) + `
-` + n + e.slice(d);
+function ie(e, t) {
+  let n = 0;
+  for (let o = t; o < e.length; o++) {
+    const a = e[o];
+    if (a === "(" || a === "[" || a === "{")
+      n++;
+    else if ((a === ")" || a === "]" || a === "}") && (n--, n === 0))
+      return e[o + 1] === ";" ? o + 2 : o + 1;
   }
-  return n + `
-` + e;
+  return -1;
 }
-function oe(e, n) {
-  let t = r.readFileSync(e, "utf-8");
-  const s = x(n), o = h(n);
-  t = L(t, `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; )
-    p = m;
-  if (p) {
-    const i = p.index + p[0].length, l = `
-    .use(${s}, { router })`;
-    t = t.slice(0, i) + l + t.slice(i);
+function ce(e, t) {
+  const n = new RegExp(`\\b${t}\\s*\\(`, "g"), o = [];
+  let a;
+  for (; (a = n.exec(e)) !== null; ) {
+    const l = o[o.length - 1];
+    if (l && a.index < l.end) continue;
+    const s = ie(e, a.index + a[0].length - 1);
+    if (s === -1) break;
+    o.push({ start: a.index, end: s });
   }
-  r.writeFileSync(e, t);
+  return o;
 }
-function re(e, n) {
-  let t = r.readFileSync(e, "utf-8");
-  const s = h(n), o = R(n);
-  if (!t.includes("addMenuItem")) {
-    const v = /import\s*\{([^}]+)\}\s*from\s*["']@vc-shell\/framework["']/.exec(t);
-    if (v) {
-      const f = v[1].trim() + ", addMenuItem";
-      t = t.replace(v[0], `import { ${f} } from "@vc-shell/framework"`);
-    } else
-      t = L(t, 'import { addMenuItem } from "@vc-shell/framework";');
+function B(e) {
+  const t = /^[ \t]*import(?=[\s{"'])/gm;
+  let n = -1, o;
+  for (; (o = t.exec(e)) !== null; ) {
+    const a = e.indexOf(";", o.index);
+    if (a === -1) break;
+    n = a + 1, t.lastIndex = n;
   }
-  const d = /addMenuItem\(\{[\s\S]*?\}\);/g;
-  let p = null, m;
-  for (; (m = d.exec(t)) !== null; )
-    p = m;
-  const i = `
-  addMenuItem({
-    title: "${o}.MENU.TITLE",
-    icon: "lucide-box",
-    priority: 10,
-    url: "/${s}",
-  });`;
-  if (p) {
-    const l = p.index + p[0].length;
-    t = t.slice(0, l) + `
-` + i + t.slice(l);
-  } else {
-    const l = t.lastIndexOf("}");
-    l !== -1 && (t = t.slice(0, l) + i + `
-` + t.slice(l));
+  return n;
+}
+function V(e, t) {
+  const n = e.lastIndexOf(`
+`, t - 1) + 1;
+  return /^[ \t]*/.exec(e.slice(n, t))?.[0] ?? "";
+}
+function C(e, t) {
+  return [...t].sort((n, o) => o.at - n.at).reduce((n, { at: o, text: a }) => n.slice(0, o) + a + n.slice(o), e);
+}
+function le(e, t) {
+  const n = i.readFileSync(e, "utf-8"), o = k(n), a = M(t), l = v(t), s = /^[ \t]*app\.use\(\s*router\s*\)\s*;/m.exec(o);
+  if (!s)
+    throw new Error("Could not find `app.use(router)` in main.ts");
+  const c = B(o);
+  if (c === -1)
+    throw new Error("Could not find an import statement in main.ts");
+  const d = V(n, s.index + s[0].length);
+  i.writeFileSync(
+    e,
+    C(n, [
+      { at: c, text: `
+import ${a} from "./modules/${l}";` },
+      { at: s.index, text: `${d}app.use(${a});
+` }
+    ])
+  );
+}
+function me(e) {
+  const t = k(e);
+  if (/\baddMenuItem\b/.test(t)) return e;
+  const n = /import\s*\{([^}]*)\}\s*from\s*["']@vc-shell\/framework["']/.exec(
+    k(e, { strings: !1 })
+  );
+  if (n) {
+    const l = n[1].trim().replace(/,$/, ""), s = n.index + n[0].length;
+    return e.slice(0, n.index) + `import { ${l}, addMenuItem } from "@vc-shell/framework"` + e.slice(s);
+  }
+  const o = 'import { addMenuItem } from "@vc-shell/framework";', a = B(t);
+  return a === -1 ? `${o}
+${e}` : C(e, [{ at: a, text: `
+${o}` }]);
+}
+function de(e, t) {
+  const n = v(t), o = O(t), a = me(i.readFileSync(e, "utf-8")), l = k(a), s = (u) => [
+    `${u}addMenuItem({`,
+    `${u}  title: "${o}.MENU.TITLE",`,
+    `${u}  icon: "lucide-box",`,
+    `${u}  priority: 10,`,
+    `${u}  url: "/${n}",`,
+    `${u}});`
+  ].join(`
+`), c = ce(l, "addMenuItem"), d = c[c.length - 1];
+  if (d) {
+    const u = V(a, d.start);
+    i.writeFileSync(e, C(a, [{ at: d.end, text: `
+
+${s(u)}` }]));
+    return;
   }
-  r.writeFileSync(e, t);
+  const p = l.lastIndexOf("}");
+  if (p === -1)
+    throw new Error("Could not find the bootstrap function body in bootstrap.ts");
+  i.writeFileSync(e, C(a, [{ at: p, text: `${s("  ")}
+` }]));
 }
-async function se(e, n) {
-  const t = process.cwd(), s = e._?.[1], o = c.join(t, "package.json");
-  r.existsSync(o) || (console.error(a.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(a.red("Error: Not a vc-shell project (@vc-shell/framework not found in dependencies).")), process.exit(1));
-  let m = s;
-  m || (m = (await P({
+async function pe(e, t) {
+  const n = process.cwd(), o = e._?.[1], a = m.join(n, "package.json");
+  i.existsSync(a) || (console.error(r.red("Error: No package.json found. Run this command from a vc-shell project root.")), process.exit(1));
+  const l = JSON.parse(i.readFileSync(a, "utf-8"));
+  ({ ...l.dependencies, ...l.devDependencies })["@vc-shell/framework"] || (console.error(r.red("Error: Not a vc-shell project (@vc-shell/framework not found in dependencies).")), process.exit(1));
+  let c = o;
+  c || (c = (await P({
     type: "text",
     name: "moduleName",
     message: "Module name:",
-    validate: (N) => N.trim().length > 0 || "Module name is required"
-  })).moduleName), m || (console.error(a.red("Module name is required.")), process.exit(1));
-  const i = h(m), l = x(m), v = c.join(t, "src/modules"), f = c.join(v, i);
-  r.existsSync(v) || r.mkdirSync(v, { recursive: !0 }), r.existsSync(f) && (console.error(a.red(`Error: Module "${i}" already exists at ${c.relative(t, f)}`)), process.exit(1));
-  const u = F({ moduleName: m, projectName: c.basename(t) });
-  b(c.join(n, "module"), f, u), console.log(a.green(`  ✔ Created ${c.relative(t, f)}/`));
-  const y = c.join(t, "src/main.ts");
-  if (r.existsSync(y))
+    validate: (S) => S.trim().length > 0 || "Module name is required"
+  })).moduleName), c || (console.error(r.red("Module name is required.")), process.exit(1));
+  const d = v(c), p = M(c), u = m.join(n, "src/modules"), y = m.join(u, d);
+  i.existsSync(u) || i.mkdirSync(u, { recursive: !0 }), i.existsSync(y) && (console.error(r.red(`Error: Module "${d}" already exists at ${m.relative(n, y)}`)), process.exit(1));
+  const f = U({ moduleName: c, projectName: m.basename(n) });
+  j(m.join(t, "module"), y, f), console.log(r.green(`  ✔ Created ${m.relative(n, y)}/`));
+  const h = m.join(n, "src/main.ts");
+  if (i.existsSync(h))
     try {
-      oe(y, m), console.log(a.green(`  ✔ Updated src/main.ts — added import & app.use(${l})`));
+      le(h, c), console.log(r.green(`  ✔ Updated src/main.ts — added import & app.use(${p})`));
     } catch {
-      console.warn(a.yellow("  ⚠ Could not auto-update src/main.ts. Add manually:")), console.warn(a.yellow(`    import ${l} from "./modules/${i}";`)), console.warn(a.yellow(`    app.use(${l}, { router });`));
+      console.warn(r.yellow("  ⚠ Could not auto-update src/main.ts. Add manually:")), console.warn(r.yellow(`    import ${p} from "./modules/${d}";`)), console.warn(r.yellow(`    app.use(${p}, { router });`));
     }
-  const g = c.join(t, "src/bootstrap.ts");
-  if (r.existsSync(g))
+  const g = m.join(n, "src/bootstrap.ts");
+  if (i.existsSync(g))
     try {
-      re(g, m), console.log(a.green(`  ✔ Updated src/bootstrap.ts — added menu item "${j(m)}"`));
+      de(g, c), console.log(r.green(`  ✔ Updated src/bootstrap.ts — added menu item "${x(c)}"`));
     } catch {
-      console.warn(a.yellow("  ⚠ Could not auto-update src/bootstrap.ts. Add addMenuItem() manually."));
+      console.warn(r.yellow("  ⚠ Could not auto-update src/bootstrap.ts. Add addMenuItem() manually."));
     }
-  await z([f, y, g]), console.log(`
-  Module "${i}" is ready! Run ${a.bold(a.green("yarn serve"))} to see it.
+  await z([y, h, g]), console.log(`
+  Module "${d}" is ready! Run ${r.bold(r.green("yarn serve"))} to see it.
 `);
 }
-const E = c.resolve(K(import.meta.url), "..", "templates");
-function ce() {
+const R = m.resolve(Z(import.meta.url), "..", "templates");
+function ue() {
   console.log(`
-${a.bold(a.green("create-vc-app"))} — Create VC Shell applications and modules
+${r.bold(r.green("create-vc-app"))} — Create VC Shell applications and modules
 
-${a.bold("Usage:")}
+${r.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
 
-${a.bold("Options (create):")}
+${r.bold("Options (create):")}
   --type <type>              Project type: standalone | dynamic-module
   --name, --app-name <name>  Application name
   --package-name <name>      npm package name
@@ -426,31 +500,31 @@ ${a.bold("Options (create):")}
   --help, -h                 Show this help
   --version, -v              Show version
 
-${a.bold("Examples:")}
+${r.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
 
-${a.bold("Docs:")} https://docs.virtocommerce.org/platform/developer-guide/latest/custom-apps-development/vc-shell/vc-shell-overview/
+${r.bold("Docs:")} https://docs.virtocommerce.org/platform/developer-guide/latest/custom-apps-development/vc-shell/vc-shell-overview/
 `);
 }
-async function ie() {
-  const e = B(V.slice(2), {
+async function fe() {
+  const e = K(Y.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) {
-    ce();
+    ue();
     return;
   }
   if (e.version) {
-    console.log(`create-vc-app v${J.version}`);
+    console.log(`create-vc-app v${W.version}`);
     return;
   }
-  e._[0] === "add-module" ? await se(e, E) : await ae(e, E);
+  e._[0] === "add-module" ? await pe(e, R) : await se(e, R);
 }
-ie().catch((e) => {
-  console.error(a.red(e.message || String(e))), O(1);
+fe().catch((e) => {
+  console.error(r.red(e.message || String(e))), J(1);
 });

package/dist/templates/module/composables/useDetails.ts.ejs

@@ -4,6 +4,7 @@ import { useAsync, useLoading } from "@vc-shell/framework";
 export default function use<%- ModuleNamePascalCase %>Details() {
   const item = ref<Record<string, any>>({});
 
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars -- used by the TODO API call below
   const { loading: itemLoading, action: fetchItem } = useAsync(async (id?: string) => {
     // TODO: Replace with real API call
     // const result = await apiClient.getById(id);

package/dist/templates/module/composables/useList.ts.ejs

@@ -8,11 +8,11 @@ export interface <%- ModuleNamePascalCase %>ListQuery {
   take?: number;
 }
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export default function use<%- ModuleNamePascalCase %>List() {
   const data: Ref<Record<string, any>[]> = ref([]);
   const totalCount = ref(0);
 
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars -- used by the TODO API call below
   const { loading: itemsLoading, action: getItems } = useAsync<<%- ModuleNamePascalCase %>ListQuery>(async (query) => {
     // TODO: Replace with real API call
     // const result = await apiClient.search({
@@ -25,6 +25,7 @@ export default function use<%- ModuleNamePascalCase %>List() {
     // totalCount.value = result.totalCount ?? 0;
   });
 
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars -- used by the TODO API call below
   const { loading: deleteLoading, action: removeItems } = useAsync(async (ids?: string[]) => {
     // TODO: Replace with real API call
     // await Promise.all((ids ?? []).map((id) => apiClient.delete(id)));

package/dist/templates/standalone/src/bootstrap.ts.ejs

@@ -1,7 +1,6 @@
-import { App } from "vue";
+import { App<% if (dashboard) { %>, markRaw<% } %> } from "vue";
 <% if (dashboard) { -%>
 import { addMenuItem, registerDashboardWidget } from "@vc-shell/framework";
-import { markRaw } from "vue";
 import Welcome from "./components/dashboard-widgets/Welcome.vue";
 <% } -%>
 

package/dist/templates/standalone/src/pages/App.vue.ejs

@@ -18,6 +18,7 @@ const isReady = ref(false);
 const version = import.meta.env.PACKAGE_VERSION;
 
 const { isAuthenticated } = useUser();
+// eslint-disable-next-line @typescript-eslint/no-unused-vars -- used by the TODO example below
 const { setBroadcastFilter } = useBroadcastFilter();
 
 onMounted(async () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vc-shell/create-vc-app",
   "description": "Application scaffolding",
-  "version": "2.4.0-pr302.99e48e1",
+  "version": "2.4.0-pr302.b052b38",
   "type": "module",
   "bin": "./dist/index.js",
   "files": [
@@ -16,7 +16,7 @@
   "devDependencies": {
     "@types/ejs": "^3.1.5",
     "@types/prompts": "^2.4.4",
-    "@vc-shell/ts-config": "2.4.0-pr302.99e48e1",
+    "@vc-shell/ts-config": "2.4.0-pr302.b052b38",
     "copyfiles": "^2.4.1",
     "cross-env": "^7.0.3",
     "shx": "^0.3.4",
@@ -24,7 +24,6 @@
   },
   "dependencies": {
     "ejs": "^3.1.10",
-    "magicast": "^0.3.5",
     "mri": "^1.2.0",
     "picocolors": "^1.1.1",
     "prettier": "^3.6.2",