zova-cli-set-front 1.2.73 → 1.2.77

package/README.md

@@ -1 +1,51 @@
 # zova-cli-set-front
+
+This package contains the authoritative Zova command catalog for frontend-oriented CLI workflows.
+
+## Source of truth
+
+The top-level command-family registry lives in:
+
+- `src/lib/commands.ts`
+
+Inspect this file first when you need to answer:
+
+- which Zova command families exist
+- which command names are registered
+- which command module implements each entry
+
+Current families include:
+
+- `default`
+- `bin`
+- `create`
+- `init`
+- `refactor`
+- `tools`
+- `openapi`
+
+## Command metadata surface
+
+Each command module under `src/lib/command/` provides the main CLI-facing metadata for that command, typically including:
+
+- `bean`
+- `info.title`
+- `info.usage`
+- `options`
+
+Representative example:
+
+- `src/lib/command/tools.metadata.ts`
+
+## Recommended navigation path
+
+1. run `npm run zova`
+2. inspect `../cli/src/bin/zova.ts` for entry dispatch only
+3. inspect `src/lib/commands.ts` for the authoritative family map
+4. inspect the specific command module for usage and options
+
+## Public reference
+
+For the compact top-level overview shared across Vona and Zova, see:
+
+- `../../../cabloy-docs/reference/cli-reference.md`

package/cli/templates/create/module/boilerplate/_package.json

@@ -17,7 +17,7 @@
   "files": ["mock", "dist", "src", "icons", "assets"],
   "scripts": {
     "clean": "rimraf dist tsconfig.build.tsbuildinfo",
-    "tsc:publish": "npm run clean && zova :bin:buildModule --sourcemap && tsc -p tsconfig.build.json",
+    "tsc:publish": "npm run clean && node <%=argv.suite?'../../../../../':'../../../'%>packages-cli/cli/src/bin/zova.ts :bin:buildModule --sourcemap && tsc -p tsconfig.build.json",
     "prepublishOnly": "npm run tsc:publish",
     "prepack": "clean-package",
     "postpack": "clean-package restore && npm run clean"

package/cli/templates/init/icon/boilerplate/icons/default/zova.svg

@@ -1,3 +1,3 @@
-<svg width="15" height="19" viewBox="0 0 15 19" fill="none" xmlns="http://www.w3.org/2000/svg">
+<svg width="32" height="32" viewBox="0 0 15 20" fill="none" xmlns="http://www.w3.org/2000/svg">
 <path d="M13.7344 0C13.9844 0 14.1771 0.046875 14.3125 0.140625C14.4479 0.223958 14.5469 0.380208 14.6094 0.609375C14.6823 0.838542 14.7188 1.17188 14.7188 1.60938C14.7188 2.24479 14.599 2.72396 14.3594 3.04688L5.39062 15.1875H11.125V11.7188C11.125 11.3646 11.276 11.1146 11.5781 10.9688C11.8802 10.8125 12.3646 10.7344 13.0312 10.7344C13.6771 10.7344 14.1198 10.8073 14.3594 10.9531C14.599 11.099 14.7188 11.3542 14.7188 11.7188V17.5312C14.7188 17.8854 14.6406 18.1458 14.4844 18.3125C14.3281 18.4688 14.0677 18.5469 13.7031 18.5469H0.984375C0.734375 18.5469 0.541667 18.5052 0.40625 18.4219C0.270833 18.3385 0.166667 18.1823 0.09375 17.9531C0.03125 17.724 0 17.3906 0 16.9531C0 16.2656 0.104167 15.7812 0.3125 15.5L9.28125 3.35938H4.0625V6.51562C4.0625 6.86979 3.91146 7.125 3.60938 7.28125C3.30729 7.42708 2.82292 7.5 2.15625 7.5C1.51042 7.5 1.06771 7.42708 0.828125 7.28125C0.588542 7.13542 0.46875 6.88021 0.46875 6.51562V1.01562C0.46875 0.651042 0.546875 0.390625 0.703125 0.234375C0.869792 0.078125 1.13021 0 1.48438 0H13.7344Z" fill="#FF9300"/>
 </svg>

package/dist/index.js

@@ -395,27 +395,48 @@ async function _extractDepsVersion(projectPath, deps) {
   const parsedLockfile = yaml.parse(lockfileContent);
   const depsVersion = {};
   for (const dep of deps) {
-    let version = getPackageVersionFromLock(parsedLockfile, dep);
-    if (!version) {
-      version = await getPackageVersionFromNodeModules(projectPath, dep);
+    let dependencyRange = getPackageDependencyRangeFromLock(parsedLockfile, dep);
+    if (!dependencyRange) {
+      const version = await getPackageVersionFromNodeModules(projectPath, dep);
+      dependencyRange = version ? `^${version}` : null;
     }
-    if (!version) {
+    if (!dependencyRange) {
       console.warn('dep version not found: ', dep);
       continue;
     }
-    depsVersion[dep] = `^${version}`;
+    depsVersion[dep] = dependencyRange;
   }
   return depsVersion;
 }
-function getPackageVersionFromLock(parsedLockfile, packageName) {
-  const packages = parsedLockfile.packages || {};
-  for (const key in packages) {
-    if (key.startsWith(`${packageName}@`)) {
-      return key.substring(`${packageName}@`.length);
-    }
+function getPackageDependencyRangeFromLock(parsedLockfile, packageName) {
+  const importer = parsedLockfile.importers?.['.'];
+  const sections = ['dependencies', 'devDependencies', 'optionalDependencies'];
+  for (const section of sections) {
+    const dependencyRange = getImporterDependencyRange(importer?.[section]?.[packageName]);
+    if (dependencyRange) return dependencyRange;
   }
   return null;
 }
+function getImporterDependencyRange(importerDependency) {
+  if (!importerDependency) return null;
+  const specifier = importerDependency.specifier;
+  if (specifier?.startsWith('npm:')) return specifier;
+  const version = normalizeLockfileVersion(importerDependency.version);
+  if (!version) return null;
+  return `^${version}`;
+}
+function normalizeLockfileVersion(version) {
+  if (!version) return null;
+  if (version.startsWith('link:') || version.startsWith('file:')) return null;
+  const versionWithoutPeers = version.split('(')[0];
+  if (!versionWithoutPeers) return null;
+  if (/^\d/.test(versionWithoutPeers)) return versionWithoutPeers;
+  const aliasSeparator = versionWithoutPeers.lastIndexOf('@');
+  if (aliasSeparator === -1) return null;
+  const aliasedVersion = versionWithoutPeers.slice(aliasSeparator + 1);
+  if (!aliasedVersion || !/^\d/.test(aliasedVersion)) return null;
+  return aliasedVersion;
+}
 async function getPackageVersionFromNodeModules(projectPath, packageName) {
   const pkgFile = path.join(projectPath, 'node_modules', packageName, 'package.json');
   if (!fse.existsSync(pkgFile)) return null;
@@ -706,6 +727,12 @@ class CliCreateModule extends BeanCliBase {
     if (!argv.vscode && !argv.ci) {
       await this.helper.pnpmInstall();
     }
+    // tools.metadata
+    if (!argv.nometadata) {
+      await this.helper.invokeCli([':tools:metadata', moduleName], {
+        cwd: argv.projectPath
+      });
+    }
   }
 }
 
@@ -2147,50 +2174,6 @@ class CliRefactorAnotherStyle extends BeanCliBase {
   }
 }
 
-class CliRefactorComponentEmits extends BeanCliBase {
-  async execute() {
-    const {
-      argv
-    } = this.context;
-    // super
-    await super.execute();
-    // module name/info
-    const moduleName = argv.module;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
-    // target dir
-    const targetDir = await this.helper.ensureDir(_module.root);
-    // componentName
-    const componentName = argv.componentName;
-    // nameMeta
-    argv.nameMeta = this.helper.parseNameMeta(componentName, ['component']);
-    argv.controllerClassName = `Controller${argv.nameMeta.shortCapitalize}`;
-    argv.controllerFileName = getControllerFileName(_module, 'component', argv.nameMeta.short);
-    // directory
-    const componentDir = path.join(targetDir, 'src/component', argv.nameMeta.short);
-    if (!fs.existsSync(componentDir)) {
-      throw new Error(`component not exists: ${componentDir}`);
-    }
-    // render boilerplate
-    await this.template.renderBoilerplateAndSnippets({
-      targetDir: componentDir,
-      setName: __ThisSetName__,
-      snippetsPath: 'refactor/componentEmits/snippets',
-      boilerplatePath: null
-    });
-    // tools.metadata
-    if (!argv.nometadata) {
-      await this.helper.invokeCli([':tools:metadata', moduleName], {
-        cwd: argv.projectPath
-      });
-    }
-  }
-}
-
 class CliRefactorComponentGeneric extends BeanCliBase {
   async execute() {
     const {
@@ -2331,50 +2314,6 @@ class CliRefactorComponentProps extends BeanCliBase {
   }
 }
 
-class CliRefactorComponentSlots extends BeanCliBase {
-  async execute() {
-    const {
-      argv
-    } = this.context;
-    // super
-    await super.execute();
-    // module name/info
-    const moduleName = argv.module;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
-    // target dir
-    const targetDir = await this.helper.ensureDir(_module.root);
-    // componentName
-    const componentName = argv.componentName;
-    // nameMeta
-    argv.nameMeta = this.helper.parseNameMeta(componentName, ['component']);
-    argv.controllerClassName = `Controller${argv.nameMeta.shortCapitalize}`;
-    argv.controllerFileName = getControllerFileName(_module, 'component', argv.nameMeta.short);
-    // directory
-    const componentDir = path.join(targetDir, 'src/component', argv.nameMeta.short);
-    if (!fs.existsSync(componentDir)) {
-      throw new Error(`component not exists: ${componentDir}`);
-    }
-    // render boilerplate
-    await this.template.renderBoilerplateAndSnippets({
-      targetDir: componentDir,
-      setName: __ThisSetName__,
-      snippetsPath: 'refactor/componentSlots/snippets',
-      boilerplatePath: null
-    });
-    // tools.metadata
-    if (!argv.nometadata) {
-      await this.helper.invokeCli([':tools:metadata', moduleName], {
-        cwd: argv.projectPath
-      });
-    }
-  }
-}
-
 class CliRefactorFirstRender extends BeanCliBase {
   async execute() {
     const {
@@ -3629,8 +3568,6 @@ const beans = {
   'refactor.anotherRender': CliRefactorAnotherRender,
   'refactor.anotherStyle': CliRefactorAnotherStyle,
   'refactor.componentProps': CliRefactorComponentProps,
-  'refactor.componentEmits': CliRefactorComponentEmits,
-  'refactor.componentSlots': CliRefactorComponentSlots,
   'refactor.componentModel': CliRefactorComponentModel,
   'refactor.renameComponent': CliRefactorRenameComponent,
   'tools.metadata': CliToolsMetadata,
@@ -3643,7 +3580,7 @@ var binBuildModule = {
   bean: 'bin.buildModule',
   info: {
     version: '5.0.0',
-    title: 'Cli: Tools: Bin',
+    title: 'Cli: Bin: Build Module',
     usage: 'npm run zova :bin:buildModule -- [--minify] [--sourcemap] [--dts]'
   },
   options: {
@@ -3666,7 +3603,7 @@ var binBuildRest = {
   bean: 'bin.buildRest',
   info: {
     version: '5.0.0',
-    title: 'Cli: Tools: Bin',
+    title: 'Cli: Bin: Build Rest',
     usage: 'npm run zova :bin:buildRest -- [--flavor=]'
   },
   options: {
@@ -3682,12 +3619,16 @@ var createBean = {
   info: {
     version: '5.0.0',
     title: 'Cli: Create Bean',
-    usage: 'npm run zova :create:bean sceneName beanName -- [--module=]'
+    usage: 'npm run zova :create:bean sceneName beanName -- [--module=] [--boilerplate=]'
   },
   options: {
     module: {
       description: 'module name',
       type: 'string'
+    },
+    boilerplate: {
+      description: 'boilerplate',
+      type: 'string'
     }
   },
   groups: {

package/dist/lib/beans.d.ts

@@ -25,11 +25,9 @@ import { CliOpenapiConfig } from './bean/cli.openapi.config.ts';
 import { CliOpenapiGenerate } from './bean/cli.openapi.generate.ts';
 import { CliRefactorAnotherRender } from './bean/cli.refactor.anotherRender.ts';
 import { CliRefactorAnotherStyle } from './bean/cli.refactor.anotherStyle.ts';
-import { CliRefactorComponentEmits } from './bean/cli.refactor.componentEmits.ts';
 import { CliRefactorComponentGeneric } from './bean/cli.refactor.componentGeneric.ts';
 import { CliRefactorComponentModel } from './bean/cli.refactor.componentModel.ts';
 import { CliRefactorComponentProps } from './bean/cli.refactor.componentProps.ts';
-import { CliRefactorComponentSlots } from './bean/cli.refactor.componentSlots.ts';
 import { CliRefactorFirstRender } from './bean/cli.refactor.firstRender.ts';
 import { CliRefactorFirstStyle } from './bean/cli.refactor.firstStyle.ts';
 import { CliRefactorPageParams } from './bean/cli.refactor.pageParams.ts';
@@ -69,8 +67,6 @@ export declare const beans: {
     'refactor.anotherRender': typeof CliRefactorAnotherRender;
     'refactor.anotherStyle': typeof CliRefactorAnotherStyle;
     'refactor.componentProps': typeof CliRefactorComponentProps;
-    'refactor.componentEmits': typeof CliRefactorComponentEmits;
-    'refactor.componentSlots': typeof CliRefactorComponentSlots;
     'refactor.componentModel': typeof CliRefactorComponentModel;
     'refactor.renameComponent': typeof CliRefactorRenameComponent;
     'tools.metadata': typeof CliToolsMetadata;

package/dist/lib/command/create.bean.d.ts

@@ -10,6 +10,10 @@ declare const _default: {
             description: string;
             type: string;
         };
+        boilerplate: {
+            description: string;
+            type: string;
+        };
     };
     groups: {
         default: {

package/dist/lib/commands.d.ts

@@ -232,6 +232,10 @@ export declare const commands: {
                     description: string;
                     type: string;
                 };
+                boilerplate: {
+                    description: string;
+                    type: string;
+                };
             };
             groups: {
                 default: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zova-cli-set-front",
-  "version": "1.2.73",
-  "gitHead": "b2879af32ebdecaf6687854b0f7c1d94918919ef",
+  "version": "1.2.77",
+  "gitHead": "ca10457f38716ad28bf5918dd67c85dd1f7dc9d0",
   "description": "zova cli-set-front",
   "keywords": [
     "framework",
@@ -27,7 +27,7 @@
   },
   "scripts": {
     "clean": "rimraf dist dist-cli tsconfig.build.tsbuildinfo tsconfig.cli.tsbuildinfo",
-    "tsc:publish": "npm run clean && vona :bin:buildGeneral && tsc -p tsconfig.build.json && tsc -p tsconfig.cli.json",
+    "tsc:publish": "npm run clean && node ../../../vona/packages-cli/cli/src/bin/vona.ts :bin:buildGeneral && tsc -p tsconfig.build.json && tsc -p tsconfig.cli.json",
     "prepublishOnly": "npm run tsc:publish",
     "prepack": "clean-package",
     "postpack": "clean-package restore && npm run clean"
@@ -36,11 +36,11 @@
     "@babel/plugin-proposal-decorators": "^7.29.0",
     "@babel/plugin-transform-class-properties": "^7.28.6",
     "@babel/plugin-transform-typescript": "^7.28.6",
-    "@cabloy/cli": "^3.1.14",
-    "@cabloy/extend": "^3.1.0",
+    "@cabloy/cli": "^3.1.18",
+    "@cabloy/extend": "^3.2.8",
     "@cabloy/module-info": "^2.0.0",
     "@cabloy/openapi-typescript": "^7.9.2",
-    "@cabloy/utils": "^2.1.19",
+    "@cabloy/utils": "^2.1.22",
     "@cabloy/vite-plugin-babel": "^1.3.3",
     "@cabloy/vue-babel-plugin-jsx": "^2.0.1",
     "@cabloy/word-utils": "^2.1.14",
@@ -64,7 +64,7 @@
     "urllib": "^4.6.11",
     "vite": "^8.0.14",
     "yaml": "^2.8.3",
-    "zova-openapi": "^1.1.14",
-    "zova-vite": "^1.1.35"
+    "zova-openapi": "^1.1.17",
+    "zova-vite": "^1.1.39"
   }
 }

package/dist/lib/command/init.legacy.d.ts

@@ -1,9 +0,0 @@
-declare const _default: {
-    bean: string;
-    info: {
-        version: string;
-        title: string;
-        usage: string;
-    };
-};
-export default _default;

package/dist/lib/command/refactor.componentEmits.d.ts

@@ -1,34 +0,0 @@
-declare const _default: {
-    bean: string;
-    info: {
-        version: string;
-        title: string;
-        usage: string;
-    };
-    options: {
-        module: {
-            description: string;
-            type: string;
-        };
-    };
-    groups: {
-        default: {
-            questions: {
-                componentName: {
-                    type: string;
-                    message: string;
-                    initial: {
-                        expression: string;
-                    };
-                    required: boolean;
-                };
-                module: {
-                    type: string;
-                    message: string;
-                    required: boolean;
-                };
-            };
-        };
-    };
-};
-export default _default;

package/dist/lib/command/refactor.componentSlots.d.ts

@@ -1,34 +0,0 @@
-declare const _default: {
-    bean: string;
-    info: {
-        version: string;
-        title: string;
-        usage: string;
-    };
-    options: {
-        module: {
-            description: string;
-            type: string;
-        };
-    };
-    groups: {
-        default: {
-            questions: {
-                componentName: {
-                    type: string;
-                    message: string;
-                    initial: {
-                        expression: string;
-                    };
-                    required: boolean;
-                };
-                module: {
-                    type: string;
-                    message: string;
-                    required: boolean;
-                };
-            };
-        };
-    };
-};
-export default _default;