zova-cli-set-front 1.2.72 → 1.2.76

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/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;
@@ -2147,50 +2168,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 +2308,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 {
@@ -2780,7 +2713,7 @@ import { constants } from '../config/constants.js';
 `;
   return content;
 }
-async function generateLocale1(modulePath, moduleName) {
+async function generateLocale1(modulePath) {
   const files = await globby('src/config/locale/*.ts', {
     cwd: modulePath
   });
@@ -2795,21 +2728,11 @@ async function generateLocale1(modulePath, moduleName) {
     contentLocales.push(`  '${localeName}': ${className},`);
   }
   // combine
-  const content = `import type { TypeLocaleBase } from 'zova';
-import { useApp, useComputed } from 'zova';
-${contentImports.join('\n')}
+  const content = `${contentImports.join('\n')}
 
 export const locales = {
 ${contentLocales.join('\n')}
 };
-
-export function $useLocale<K extends keyof (typeof locales)[TypeLocaleBase]>(key: K, ...args: any[]) {
-  const app = useApp();
-  const str = \`${moduleName}::\${key}\`;
-  return useComputed(() => {
-    return app.meta.text(str, ...args);
-  });
-}
 `;
   return content;
 }
@@ -3473,7 +3396,7 @@ class CliToolsMetadata extends BeanCliBase {
     const contentConstants = await generateConstant(modulePath);
     content += contentConstants;
     // locale
-    const contentLocales1 = await generateLocale1(modulePath, moduleName);
+    const contentLocales1 = await generateLocale1(modulePath);
     const contentLocales2 = await generateLocale2(contentLocales1);
     content += contentLocales2;
     // error
@@ -3639,8 +3562,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,
@@ -3653,7 +3574,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: {
@@ -3676,7 +3597,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: {

package/dist/lib/bean/toolsMetadata/generateConfig.d.ts

@@ -1,5 +1,5 @@
 export declare function generateConfig(modulePath: string): Promise<"" | "/** config: begin */\nexport * from '../config/config.js';\nimport { config } from '../config/config.js';\n/** config: end */\n">;
 export declare function generateConstant(modulePath: string): Promise<"" | "/** constant: begin */\nexport * from '../config/constants.js';\nimport { constants } from '../config/constants.js';\n/** constant: end */\n">;
-export declare function generateLocale1(modulePath: string, moduleName: string): Promise<string>;
+export declare function generateLocale1(modulePath: string): Promise<string>;
 export declare function generateLocale2(contentLocales: string): Promise<"" | "/** locale: begin */\nimport { locales } from './locales.js';\n/** locale: end */\n">;
 export declare function generateError(modulePath: string): Promise<"" | "/** error: begin */\nexport * from '../config/errors.js';\nimport { errors } from '../config/errors.js';\n/** error: end */\n">;

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zova-cli-set-front",
-  "version": "1.2.72",
-  "gitHead": "7332ce2a4b44504a88c64da981b60336ebef7e9b",
+  "version": "1.2.76",
+  "gitHead": "3380f8c5d3989242b60dc2a34cbb330f74335cbe",
   "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.17",
+    "@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.34"
+    "zova-openapi": "^1.1.17",
+    "zova-vite": "^1.1.38"
   }
 }

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;