vona-cli-set-api 1.1.103 → 1.1.106

package/README.md

@@ -1 +1,49 @@
 # vona-cli-set-api
+
+This package contains the authoritative Vona command catalog for backend-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 Vona command families exist
+- which command names are registered
+- which command module implements each entry
+
+Current families include:
+
+- `default`
+- `bin`
+- `create`
+- `init`
+- `tools`
+
+## 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/bin.play.ts`
+
+## Recommended navigation path
+
+1. run `npm run vona`
+2. inspect `../cli/src/bin/vona.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

@@ -22,7 +22,7 @@
   "files": ["assets", "dist", "src"],
   "scripts": {
     "clean": "rimraf dist tsconfig.build.tsbuildinfo",
-    "tsc:publish": "npm run clean && vona :bin:buildModule --sourcemap && tsc -p tsconfig.build.json",
+    "tsc:publish": "npm run clean && node <%=argv.suite?'../../../../../':'../../../'%>packages-cli/cli/src/bin/vona.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

@@ -918,11 +918,7 @@ class CliBinTest extends BeanCliBase {
     // globs
     let patterns;
     if (argv._.length > 0) {
-      patterns = argv._.map(item => {
-        if (item.startsWith('src/')) return item;
-        if (item.startsWith('vona/src/')) return item.substring('vona/'.length);
-        return `src/**/test/**/${item}`;
-      });
+      patterns = this._normalizeTestPatterns(argv._);
     } else {
       patterns = this._combineTestPatterns(projectPath, modulesMeta);
     }
@@ -967,6 +963,19 @@ class CliBinTest extends BeanCliBase {
       });
     });
   }
+  _normalizeTestPatterns(items) {
+    return items.flatMap(item => this._normalizeTestPattern(item));
+  }
+  _normalizeTestPattern(item) {
+    item = item.replaceAll('\\', '/');
+    if (item.startsWith('./')) item = item.substring(2);
+    if (item.startsWith('src/')) return item;
+    if (item.startsWith('vona/src/')) return item.substring('vona/'.length);
+    if (item.includes('/test/')) {
+      return [`src/module/${item}`, `src/**/modules/${item}`];
+    }
+    return `src/**/test/**/${item}`;
+  }
   _combineTestPatterns(projectPath, modulesMeta) {
     const patterns = [];
     for (const moduleName in modulesMeta.modules) {
@@ -2780,8 +2789,8 @@ var binBuild = {
   bean: 'bin.build',
   info: {
     version: '5.0.0',
-    title: 'Cli: Tools: Bin',
-    usage: 'npm run vona :bin:build -- [--workers=] [--flavor=] [--sourcemap=]'
+    title: 'Cli: Bin: Build',
+    usage: 'npm run vona :bin:build -- [--workers=] [--flavor=]'
   },
   options: {
     workers: {
@@ -2799,7 +2808,7 @@ var binBuildGeneral = {
   bean: 'bin.buildGeneral',
   info: {
     version: '5.0.0',
-    title: 'Cli: Tools: Bin',
+    title: 'Cli: Bin: Build General',
     usage: 'npm run vona :bin:buildGeneral -- [--minify] [--sourcemap]'
   },
   options: {
@@ -2818,7 +2827,7 @@ var binBuildModule = {
   bean: 'bin.buildModule',
   info: {
     version: '5.0.0',
-    title: 'Cli: Tools: Bin',
+    title: 'Cli: Bin: Build Module',
     usage: 'npm run vona :bin:buildModule -- [--minify] [--sourcemap]'
   },
   options: {
@@ -2872,7 +2881,7 @@ var binPlay = {
   info: {
     version: '5.0.0',
     title: 'Cli: Bin: Play',
-    usage: 'npm run vona :bin:play [index.ts] -- [--flavor=] [--retainRuntime=] [--attach]'
+    usage: 'npm run vona :bin:play [index.ts] -- [--mode=] [--flavor=] [--retainRuntime] [--attach]'
   },
   options: {
     mode: {
@@ -2900,7 +2909,7 @@ var binTest = {
   info: {
     version: '5.0.0',
     title: 'Cli: Bin: Test',
-    usage: 'npm run vona :bin:test -- [--coverage=] [--flavor=]'
+    usage: 'npm run vona :bin:test -- [--coverage] [--flavor=]'
   },
   options: {
     coverage: {

package/dist/lib/bean/cli.bin.test.d.ts

@@ -12,5 +12,7 @@ export declare class CliBinTest extends BeanCliBase {
     _test(projectPath: string): Promise<void>;
     _run(projectPath: string, modulesMeta: Awaited<ReturnType<typeof glob>>): Promise<void>;
     _outputCoverageReportViewer(projectPath: string): Promise<void>;
+    _normalizeTestPatterns(items: string[]): string[];
+    _normalizeTestPattern(item: string): string | string[];
     _combineTestPatterns(projectPath: string, modulesMeta: Awaited<ReturnType<typeof glob>>): string[];
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vona-cli-set-api",
-  "version": "1.1.103",
-  "gitHead": "7988acec56a1ade34ff3aaea78f152c72957e6af",
+  "version": "1.1.106",
+  "gitHead": "3380f8c5d3989242b60dc2a34cbb330f74335cbe",
   "description": "vona cli-set-api",
   "keywords": [
     "framework",
@@ -32,7 +32,7 @@
   },
   "scripts": {
     "clean": "rimraf dist dist-cli dist-toolsIsolate tsconfig.build.tsbuildinfo tsconfig.cli.tsbuildinfo tsconfig.isolate.tsbuildinfo",
-    "tsc:publish": "npm run clean && vona :bin:buildGeneral && tsc -p tsconfig.build.json && tsc -p tsconfig.cli.json && tsc -p tsconfig.isolate.json",
+    "tsc:publish": "npm run clean && node ../cli/src/bin/vona.ts :bin:buildGeneral && tsc -p tsconfig.build.json && tsc -p tsconfig.cli.json && tsc -p tsconfig.isolate.json",
     "prepublishOnly": "npm run tsc:publish",
     "prepack": "clean-package",
     "postpack": "clean-package restore && npm run clean"
@@ -41,12 +41,12 @@
     "@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/dotenv": "^1.2.5",
-    "@cabloy/extend": "^3.2.5",
-    "@cabloy/module-glob": "^5.3.10",
+    "@cabloy/cli": "^3.1.17",
+    "@cabloy/dotenv": "^1.2.8",
+    "@cabloy/extend": "^3.2.8",
+    "@cabloy/module-glob": "^5.3.13",
     "@cabloy/module-info": "^2.0.0",
-    "@cabloy/utils": "^2.1.19",
+    "@cabloy/utils": "^2.1.22",
     "@cabloy/word-utils": "^2.1.8",
     "@lcov-viewer/cli": "^1.3.0",
     "@rollup/plugin-alias": "^5.1.1",
@@ -73,7 +73,7 @@
     "ts-node-maintained": "^10.9.6",
     "urllib": "^4.9.0",
     "uuid": "^11.1.0",
-    "vona-core": "^5.1.17",
+    "vona-core": "^5.1.20",
     "why-is-node-running": "^3.2.2",
     "yargs-parser": "^22.0.0"
   }