@vyriy/dist 0.5.2 → 0.5.4

package/README.md

@@ -14,6 +14,8 @@ Prepare compiled workspace packages for distribution:
 
 ```bash
 vyriy-dist
+vyriy-dist --help
+vyriy-dist --version
 ```
 
 ## API
@@ -24,12 +26,14 @@ Install as a project dependency:
 npm install @vyriy/dist
 ```
 
-Run distribution preparation from code:
+Run distribution preparation and CLI helper from code:
 
 ```ts
-import { dist } from '@vyriy/dist';
+import { dist, runDistCli } from '@vyriy/dist';
 
 const code = await dist();
+
+await runDistCli(['--help']);
 ```
 
 `dist()` copies root package metadata, prepares each `dist/<package>/package.json`, creates export maps, removes empty generated JavaScript files, and returns a process-style exit code.

package/bin/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runDistCli } from '../index.js';
+await runDistCli(process.argv.slice(2));

package/cli.d.ts

@@ -0,0 +1,5 @@
+import type { DistHelpText, ParseDistBinArgs, RunDistCli } from './types.js';
+export declare const distVersion: string;
+export declare const createDistHelpText: DistHelpText;
+export declare const parseDistBinArgs: ParseDistBinArgs;
+export declare const runDistCli: RunDistCli;

package/cli.js

@@ -0,0 +1,42 @@
+import packageJson from './package.json' with { type: 'json' };
+import { dist } from './dist.js';
+export const distVersion = packageJson.version;
+export const createDistHelpText = (command = 'vyriy-dist', alias = 'vd') => {
+    const aliasText = alias ? `  ${alias}                  Alias for ${command}\n` : '';
+    const aliasExampleText = alias ? `\n  ${alias}` : '';
+    return `Vyriy Dist Builder
+
+Usage:
+  ${command}                  Prepare dist package metadata
+${aliasText}\
+  ${command} --help, -h       Show help
+  ${command} --version, -v    Show version
+
+Examples:
+  ${command}${aliasExampleText}`;
+};
+export const parseDistBinArgs = (args) => {
+    if (args.includes('--help') || args.includes('-h')) {
+        return { type: 'help' };
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        return { type: 'version' };
+    }
+    return { type: 'dist' };
+};
+export const runDistCli = async (args = [], command = 'vyriy-dist', alias = 'vd') => {
+    const parsed = parseDistBinArgs(args);
+    switch (parsed.type) {
+        case 'help':
+            console.log(createDistHelpText(command, alias));
+            process.exitCode = 0;
+            break;
+        case 'version':
+            console.log(distVersion);
+            process.exitCode = 0;
+            break;
+        case 'dist':
+            process.exitCode = await dist();
+            break;
+    }
+};

package/index.d.ts

@@ -1,2 +1,3 @@
+export * from './cli.js';
 export * from './dist.js';
 export type * from './types.js';

package/index.js

@@ -1 +1,2 @@
+export * from './cli.js';
 export * from './dist.js';

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@vyriy/dist",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Vyriy distribution build CLI.",
   "type": "module",
   "engines": {
     "node": ">=24.0.0"
   },
-  "bin": "./bin/vyriy-dist.js",
+  "bin": {
+    "vd": "./bin/index.js",
+    "vyriy-dist": "./bin/index.js"
+  },
   "agents": "./AGENTS.md",
   "license": "MIT",
   "repository": {
@@ -52,6 +55,16 @@
       "import": "./cleanup.js",
       "default": "./cleanup.js"
     },
+    "./cli": {
+      "types": "./cli.d.ts",
+      "import": "./cli.js",
+      "default": "./cli.js"
+    },
+    "./cli.js": {
+      "types": "./cli.d.ts",
+      "import": "./cli.js",
+      "default": "./cli.js"
+    },
     "./constants": {
       "types": "./constants.d.ts",
       "import": "./constants.js",

package/types.d.ts

@@ -1,4 +1,10 @@
 export type Command = () => Promise<number>;
+export type DistBinCommand = {
+    readonly type: 'dist' | 'help' | 'version';
+};
+export type ParseDistBinArgs = (args: readonly string[]) => DistBinCommand;
+export type DistHelpText = (command?: string, alias?: false | string) => string;
+export type RunDistCli = (args?: readonly string[], command?: string, alias?: false | string) => Promise<void>;
 export type ExportTarget = {
     readonly default: string;
     readonly import: string;

package/bin/vyriy-dist.js

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-import { dist } from '../index.js';
-process.exitCode = await dist();