ph-cmd 0.43.13-staging.0 → 0.43.13-staging.2

package/dist/src/commands/setup-globals.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-globals.js","sourceRoot":"","sources":["../../../src/commands/setup-globals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EACL,yBAAyB,EACzB,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,YAAY,GAYrB,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;IACjC,6CAA6C;IAC7C,MAAM,mBAAmB,GAAG,EAAE,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAEjE,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CACT,wCAAwC,qBAAqB,EAAE,CAChE,CAAC;QACF,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAExB,IAAI,CAAC;QACH,MAAM,aAAa,CAAC;YAClB,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC;YAC9B,cAAc,EACZ,OAAO,CAAC,cAAc,IAAI,yBAAyB,CAAC,WAAW,CAAC;SACnE,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CACT,+CAA+C,qBAAqB,EAAE,CACvE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,0BAA0B,CAAC;SACvC,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SACjD,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;SAC9C,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,CAAC;SAClE,MAAM,CACL,eAAe,EACf,wDAAwD,CACzD;SACA,MAAM,CAAC,OAAO,EAAE,8CAA8C,CAAC;SAC/D,MAAM,CAAC,WAAW,EAAE,8CAA8C,CAAC;SACnE,MAAM,CACL,oCAAoC,EACpC,8BAA8B,CAC/B;SACA,MAAM,CAAC,YAAY,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"setup-globals.js","sourceRoot":"","sources":["../../../src/commands/setup-globals.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAYxE,MAAM,CAAC,MAAM,YAAY,GAErB,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;IACjC,MAAM,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,eAAe,GAAG,OAAO;SAC5B,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,0BAA0B,CAAC;SACvC,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SACjD,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;SAC9C,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,CAAC;SAClE,MAAM,CACL,eAAe,EACf,wDAAwD,CACzD;SACA,MAAM,CAAC,OAAO,EAAE,8CAA8C,CAAC;SAC/D,MAAM,CAAC,WAAW,EAAE,8CAA8C,CAAC;SACnE,MAAM,CACL,oCAAoC,EACpC,8BAA8B,CAC/B,CAAC;IAEJ,+DAA+D;IAC/D,OAAO,cAAc,CACnB,eAAe,EACf,YAAY,EACZ,gBAAgB,CACjB,CAAC;AACJ,CAAC"}

package/dist/src/commands/update.d.ts

@@ -1,11 +1,10 @@
 import { type Command } from "commander";
 import { type CommandActionType } from "../types.js";
-export declare const update: CommandActionType<[
-    {
-        force?: string;
-        debug?: boolean;
-        packageManager?: string;
-    }
-]>;
-export declare function updateCommand(program: Command): void;
+export type UpdateOptions = {
+    force?: string;
+    debug?: boolean;
+    packageManager?: string;
+};
+export declare const update: CommandActionType<[UpdateOptions]>;
+export declare function updateCommand(program: Command): Command;
 //# sourceMappingURL=update.d.ts.map

package/dist/src/commands/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAsFrD,eAAO,MAAM,MAAM,EAAE,iBAAiB,CACpC;IACE;QACE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;CACF,CA6DF,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,QA6B7C"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAwFrD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,iBAAiB,CAAC,CAAC,aAAa,CAAC,CA4DrD,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAmBvD"}

package/dist/src/commands/update.js

@@ -1,7 +1,8 @@
 import { execSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
-import { findContainerDirectory, getPackageManagerFromLockfile, getProjectInfo, packageManagers, } from "../utils.js";
+import { updateHelp } from "../help.js";
+import { findContainerDirectory, getPackageManagerFromLockfile, getProjectInfo, packageManagers, withCustomHelp, } from "../utils/index.js";
 import { ENV_MAP, PH_PROJECT_DEPENDENCIES, updatePackageJson, } from "./use.js";
 const FILE_PROTOCOL = "file:";
 const LINK_PROTOCOL = "link:";
@@ -45,12 +46,12 @@ const getInstalledDependencies = (projectPath) => {
         .sort(); // Sort dependencies alphabetically
     return installedDeps;
 };
-export const update = (options) => {
+export const update = async (options) => {
     const { force, packageManager, debug } = options;
     if (debug) {
         console.log(">>> options", options);
     }
-    const projectInfo = getProjectInfo();
+    const projectInfo = await getProjectInfo();
     const pkgManagerName = (packageManager ||
         getPackageManagerFromLockfile(projectInfo.path));
     const localDependencyPath = getLocalDependencyPath(projectInfo.path);
@@ -68,7 +69,7 @@ export const update = (options) => {
             throw new Error(`Invalid environment: ${force}, supported envs: ${supportedEnvs.join(", ")}`);
         }
         const env = force;
-        updatePackageJson(env, undefined, pkgManagerName, debug);
+        await updatePackageJson(env, undefined, pkgManagerName, debug);
         return;
     }
     const installedDeps = getInstalledDependencies(projectInfo.path);
@@ -89,22 +90,14 @@ export const update = (options) => {
     });
 };
 export function updateCommand(program) {
-    program
+    const updateCmd = program
         .command("update")
         .alias("up")
         .description("Allows you to update your dependencies to the latest version based on the specified range in package.json. If you want to update to the latest available version, use the --force flag.")
         .option("--force <env>", "Force update to latest available version for the environment specified (dev, prod, latest)")
         .option("--package-manager <packageManager>", "force package manager to use")
-        .option("--debug", "Show additional logs")
-        .addHelpText("after", `
-Examples:
-  $ ph update                          # Update dependencies based on package.json ranges
-  $ ph update --force dev              # Force update to latest dev version available
-  $ ph update --force prod             # Force update to latest stable version available (same as latest)
-  $ ph update --force latest           # Force update to latest stable version available (same as prod)
-  $ ph update --package-manager pnpm   # Specify package manager to use
-  $ ph update --debug                  # Show debug information during update
-    `)
-        .action(update);
+        .option("--debug", "Show additional logs");
+    // Use withCustomHelp instead of withHelpAction and addHelpText
+    return withCustomHelp(updateCmd, update, updateHelp);
 }
 //# sourceMappingURL=update.js.map

package/dist/src/commands/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/use.d.ts

@@ -1,6 +1,6 @@
 import { type Command } from "commander";
 import { type CommandActionType } from "../types.js";
-import { type PackageManager } from "../utils.js";
+import { type PackageManager } from "../utils/index.js";
 export declare const ORG = "@powerhousedao";
 export declare const SPECIAL_PACKAGES: string[];
 export declare const PACKAGES: string[];
@@ -15,19 +15,20 @@ export declare const ENV_MAP: {
     latest: string;
 };
 export type Environment = keyof typeof ENV_MAP;
-export declare const updatePackageJson: (env: Environment, localPath?: string, packageManager?: PackageManager, debug?: boolean) => void;
+export declare const updatePackageJson: (env: Environment, localPath?: string, packageManager?: PackageManager, debug?: boolean) => Promise<void>;
+export type UseOptions = {
+    dev?: boolean;
+    prod?: boolean;
+    local?: string;
+    debug?: boolean;
+    latest?: boolean;
+    force?: boolean;
+    packageManager?: string;
+};
 export declare const use: CommandActionType<[
     string | undefined,
     string | undefined,
-    {
-        dev?: boolean;
-        prod?: boolean;
-        local?: string;
-        debug?: boolean;
-        latest?: boolean;
-        force?: boolean;
-        packageManager?: string;
-    }
+    UseOptions
 ]>;
-export declare function useCommand(program: Command): void;
+export declare function useCommand(program: Command): Command;
 //# sourceMappingURL=use.d.ts.map

package/dist/src/commands/use.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../../src/commands/use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,GAAG,mBAAmB,CAAC;AAGpC,eAAO,MAAM,gBAAgB,UAAuC,CAAC;AAGrE,eAAO,MAAM,QAAQ,UAapB,CAAC;AAEF,eAAO,MAAM,IAAI,UAAuB,CAAC;AAEzC,eAAO,MAAM,IAAI,UAA6B,CAAC;AAE/C,eAAO,MAAM,uBAAuB,UAOnC,CAAC;AAEF,eAAO,MAAM,6BAA6B,UAIzC,CAAC;AAEF,eAAO,MAAM,OAAO;;;;;CAKnB,CAAC;AAGF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,OAAO,CAAC;AAE/C,eAAO,MAAM,iBAAiB,GAC5B,KAAK,WAAW,EAChB,YAAY,MAAM,EAClB,iBAAiB,cAAc,EAC/B,QAAQ,OAAO,SAgEhB,CAAC;AAEF,eAAO,MAAM,GAAG,EAAE,iBAAiB,CACjC;IACE,MAAM,GAAG,SAAS;IAClB,MAAM,GAAG,SAAS;IAClB;QACE,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;CACF,CA4BF,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,QAqB1C"}
+{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../../src/commands/use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,GAAG,mBAAmB,CAAC;AAGpC,eAAO,MAAM,gBAAgB,UAAuC,CAAC;AAGrE,eAAO,MAAM,QAAQ,UAapB,CAAC;AAEF,eAAO,MAAM,IAAI,UAAuB,CAAC;AAEzC,eAAO,MAAM,IAAI,UAA6B,CAAC;AAE/C,eAAO,MAAM,uBAAuB,UAOnC,CAAC;AAEF,eAAO,MAAM,6BAA6B,UAIzC,CAAC;AAEF,eAAO,MAAM,OAAO;;;;;CAKnB,CAAC;AAGF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,OAAO,CAAC;AAE/C,eAAO,MAAM,iBAAiB,GAC5B,KAAK,WAAW,EAChB,YAAY,MAAM,EAClB,iBAAiB,cAAc,EAC/B,QAAQ,OAAO,kBAgEhB,CAAC;AAGF,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,GAAG,EAAE,iBAAiB,CACjC;IAAC,MAAM,GAAG,SAAS;IAAE,MAAM,GAAG,SAAS;IAAE,UAAU;CAAC,CAiCrD,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAuCpD"}

package/dist/src/commands/use.js

@@ -1,6 +1,7 @@
 import { readFileSync } from "node:fs";
 import path from "node:path";
-import { getPackageManagerFromLockfile, getProjectInfo, installDependency, } from "../utils.js";
+import { useHelp } from "../help.js";
+import { getPackageManagerFromLockfile, getProjectInfo, installDependency, withCustomHelp, } from "../utils/index.js";
 export const ORG = "@powerhousedao";
 // Special packages that don't use the @powerhousedao organization
 export const SPECIAL_PACKAGES = ["document-model", "document-drive"];
@@ -38,8 +39,8 @@ export const ENV_MAP = {
     prod: "latest",
     latest: "latest",
 };
-export const updatePackageJson = (env, localPath, packageManager, debug) => {
-    const projectInfo = getProjectInfo();
+export const updatePackageJson = async (env, localPath, packageManager, debug) => {
+    const projectInfo = await getProjectInfo();
     const pkgManager = packageManager || getPackageManagerFromLockfile(projectInfo.path);
     if (debug) {
         console.log(">>> projectInfo", projectInfo);
@@ -92,7 +93,7 @@ export const updatePackageJson = (env, localPath, packageManager, debug) => {
         throw error;
     }
 };
-export const use = (environment, localPath, options) => {
+export const use = async (environment, localPath, options) => {
     if (!environment ||
         (!options.force &&
             environment !== "local" &&
@@ -107,17 +108,28 @@ export const use = (environment, localPath, options) => {
     if (debug) {
         console.log(">>> options", options);
     }
-    updatePackageJson(env, localPath, packageManager, debug);
+    await updatePackageJson(env, localPath, packageManager, debug);
 };
 export function useCommand(program) {
-    program
+    const useCmd = program
         .command("use")
         .description("Allows you to change your environment (latest, development, production, local)")
-        .argument("<environment>", "The environment to use (latest, dev, prod, local)")
+        .argument("[environment]", "The environment to use (latest, dev, prod, local)")
         .argument("[localPath]", "The path to the local environment (you have to specify the path to the local environment)")
         .option("--force", "force environment to use")
         .option("--package-manager <packageManager>", "force package manager to use")
-        .option("--debug", "Show additional logs")
-        .action(use);
+        .option("--debug", "Show additional logs");
+    // Use withCustomHelp instead of withHelpAction and addHelpText
+    return withCustomHelp(useCmd, use, useHelp, 
+    // Pre-check function to validate environment before running the action
+    (environment) => {
+        if (!environment &&
+            !process.argv.includes("--help") &&
+            !process.argv.includes("-h")) {
+            console.error('Error: Missing required argument "environment"');
+            process.exit(1);
+            return false;
+        }
+    });
 }
 //# sourceMappingURL=use.js.map

package/dist/src/commands/use.js.map

@@ -1 +1 @@
-{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../src/commands/use.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../src/commands/use.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/version.d.ts

@@ -0,0 +1,4 @@
+import { type Command } from "commander";
+export declare const customVersionHandler: () => Promise<void>;
+export declare function versionOption(program: Command): Command;
+//# sourceMappingURL=version.d.ts.map

package/dist/src/commands/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/commands/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,eAAO,MAAM,oBAAoB,qBA6BhC,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAMvD"}

package/dist/src/commands/version.js

@@ -0,0 +1,25 @@
+import { forwardPHCommand, getPackageManagerFromLockfile, getProjectInfo, } from "../utils/index.js";
+import { version } from "../version.js";
+// Custom version handler
+export const customVersionHandler = async () => {
+    const projectInfo = await getProjectInfo(undefined, false);
+    console.log("PH CMD version: ", version);
+    if (projectInfo.available) {
+        const packageManager = getPackageManagerFromLockfile(projectInfo.path);
+        const versionOutput = forwardPHCommand(packageManager, projectInfo.path, "--version", false, true);
+        const cleanedOutput = versionOutput.replace(/\n/g, "");
+        console.log("PH CLI version: ", cleanedOutput);
+        console.log("-------------------------------------");
+        console.log("PH CLI path: ", projectInfo.path);
+        console.log("PH CLI isGlobalProject: ", projectInfo.isGlobal);
+        console.log("PH CLI packageManager: ", packageManager);
+    }
+    else {
+        console.log("-------------------------------------");
+        console.log("PH CLI is not available, please run `ph init` to generate the default global project");
+    }
+};
+export function versionOption(program) {
+    return program.option("-v, --version", "Display version information", customVersionHandler);
+}
+//# sourceMappingURL=version.js.map

package/dist/src/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/commands/version.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,6BAA6B,EAC7B,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,yBAAyB;AACzB,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,IAAI,EAAE;IAC7C,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAE3D,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAEzC,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;QAC1B,MAAM,cAAc,GAAG,6BAA6B,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEvE,MAAM,aAAa,GAAG,gBAAgB,CACpC,cAAc,EACd,WAAW,CAAC,IAAI,EAChB,WAAW,EACX,KAAK,EACL,IAAI,CACL,CAAC;QAEF,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAEvD,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,cAAc,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CACT,sFAAsF,CACvF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,OAAO,CAAC,MAAM,CACnB,eAAe,EACf,6BAA6B,EAC7B,oBAAoB,CACrB,CAAC;AACJ,CAAC"}

package/dist/src/help.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Help text for CLI commands
+ * This file centralizes all help text to keep command files clean
+ */
+/**
+ * Help text for the update command
+ */
+export declare const updateHelp = "\nCommand Overview:\n  The update command helps you manage and update Powerhouse dependencies in your project. It provides\n  an efficient way to keep your project up-to-date with the latest versions of Powerhouse packages.\n  \n  This command:\n  1. Updates all Powerhouse dependencies based on the semver ranges specified in your package.json\n  2. Can force update all dependencies to a specific environment version (dev, prod, latest)\n  3. Automatically builds any local dependencies before updating\n  4. Works with all dependencies with @powerhousedao/ prefix and special packages like document-model\n\nOptions:\n  --force <env>         Force update to the latest available version for the environment specified.\n                        Valid environments: dev, prod, latest.\n                        - dev: Uses @dev tag for all dependencies\n                        - prod/latest: Uses @latest tag for all dependencies\n                        \n  --package-manager     Override the auto-detected package manager with the specified one.\n                        \n  --debug               Show additional logs while executing the command.\n\nSpecial Cases:\n  - Local Dependencies: If you have dependencies linked from a local monorepo (using file: or link:\n    protocols), the command will detect the monorepo root, build affected packages, then update.\n  \n  - No Dependencies: If no Powerhouse dependencies are found in your project, the command will\n    display a message and exit without making changes.\n\nExamples:\n  $ ph update                          # Update dependencies based on package.json ranges\n  $ ph update --force dev              # Force update to latest dev version available\n  $ ph update --force prod             # Force update to latest stable version available (same as latest)\n  $ ph update --force latest           # Force update to latest stable version available (same as prod)\n  $ ph update --package-manager pnpm   # Specify package manager to use\n  $ ph update --debug                  # Show debug information during update\n";
+/**
+ * Help text for the use command
+ */
+export declare const useHelp = "\nCommand Overview:\n  The use command allows you to quickly switch between different environments for all Powerhouse\n  dependencies in your project. It provides a convenient way to toggle between development,\n  production, and local versions of the packages.\n\n  This command:\n  1. Updates all installed Powerhouse dependencies to the specified environment\n  2. Can link to local dependencies from a monorepo for development\n  3. Only updates dependencies that are already present in your package.json\n  4. Supports special packages without the @powerhousedao prefix\n\nArguments:\n  <environment>         Required. The environment to use. Valid options:\n                        - dev: Use development versions (@dev tag)\n                        - prod/latest: Use production versions (@latest tag)\n                        - local: Use local filesystem versions (requires localPath)\n                        \n  [localPath]           Path to the local monorepo. Required when environment is 'local'.\n                        This should be the root of your Powerhouse monorepo.\n\nOptions:\n  --force               Force environment to use, even if not in the predefined list\n                        \n  --package-manager     Override the auto-detected package manager with the specified one.\n                        \n  --debug               Show additional logs during execution for troubleshooting.\n\nSpecial Cases:\n  - Local Development: When using the 'local' environment, dependencies are linked directly\n    to local filesystem paths, allowing for real-time development and testing.\n  \n  - Missing Dependencies: The command only updates Powerhouse dependencies that are already\n    installed in your project. It won't add new ones.\n\nExamples:\n  $ ph use dev                       # Switch all dependencies to development versions\n  $ ph use prod                      # Switch all dependencies to production versions\n  $ ph use latest                    # Same as 'prod', use latest production versions\n  $ ph use local /path/to/monorepo   # Link to local versions in the specified monorepo\n  $ ph use dev --package-manager npm # Use npm instead of the auto-detected package manager\n  $ ph use dev --debug               # Show debug information during execution\n";
+/**
+ * Help text for the setup-globals command
+ */
+export declare const setupGlobalsHelp = "\nCommand Overview:\n  The setup-globals command initializes a new Powerhouse project with the necessary global \n  configuration. It helps you set up a project quickly with proper defaults and dependencies.\n\n  This command:\n  1. Creates a new project with the specified name or in the current directory\n  2. Sets up all required Powerhouse dependencies\n  3. Configures the project with appropriate settings\n  4. Can run in interactive mode to guide you through the setup process\n\nArguments:\n  [project-name]        Optional. Name of the project to create. If not provided,\n                        the command will use the current directory.\n\nOptions:\n  -p, --project         Specify the name of the project to create.\n                        \n  -i, --interactive     Run the command in interactive mode, which will guide you\n                        through the setup process with questions and prompts.\n                        \n  -v, --version         Specify the development version to use. Defaults to \"main\".\n                        \n  --dev                 Use the \"development\" version of the boilerplate.\n                        \n  --staging             Use the \"staging\" version of the boilerplate.\n                        \n  --package-manager     Override the auto-detected package manager with the specified one.\n\nProject Structure:\n  The command will set up a project with the following structure:\n  - Proper configuration files for TypeScript and ESLint\n  - Dependencies for Powerhouse packages\n  - Build and development scripts\n\nExamples:\n  $ ph setup-globals my-project          # Create a new project named \"my-project\"\n  $ ph setup-globals                     # Set up a project in the current directory\n  $ ph setup-globals -i                  # Run setup in interactive mode\n  $ ph setup-globals --dev               # Use development version\n  $ ph setup-globals -v beta             # Use specific version\n  $ ph setup-globals --package-manager npm   # Use npm as package manager\n";
+/**
+ * Help text for the init command
+ */
+export declare const initHelp = "\nCommand Overview:\n  The init command creates a new Powerhouse project with optimal defaults. It sets up a fully \n  configured project structure with all necessary dependencies, configurations, and boilerplate.\n\n  This command:\n  1. Creates a new project with the specified name\n  2. Installs all required dependencies for Powerhouse development\n  3. Sets up a proper project structure and configuration files\n  4. Can run in interactive mode for customized setup\n\nArguments:\n  [project-name]        Optional. Name of the project to create. If not provided,\n                        you'll be prompted to provide a name, or the current directory \n                        will be used if in interactive mode.\n\nOptions:\n  -p, --project         Specify the name of the project to create.\n                        \n  -i, --interactive     Run the command in interactive mode, which will guide you\n                        through the project setup with customizable options.\n                        \n  -v, --version         Specify the development version to use. Defaults to \"main\".\n                        \n  --dev                 Use the \"development\" version of the boilerplate.\n                        \n  --staging             Use the \"staging\" version of the boilerplate.\n                        \n  --package-manager     Override the auto-detected package manager with the specified one.\n\nProject Structure:\n  The command will create a complete project with:\n  - Properly configured TypeScript and build settings\n  - Powerhouse document-model integration\n  - All necessary package.json dependencies\n  - Development scripts and tooling\n\nExamples:\n  $ ph init my-awesome-project                                # Create a new project named \"my-awesome-project\"\n  $ ph init -i                                                # Create a project in interactive mode\n  $ ph init -p my-project                                     # Same as ph init my-project\n  $ ph init --dev                                             # Use development version of boilerplate\n  $ ph init -v beta                                           # Use specific version\n  $ ph init --package-manager yarn                            # Use yarn as package manager\n  $ ph init my-awesome-project --dev --package-manager pnpm   # Create a project with Powerhouse dev packages and pnpm as package manager\n";
+//# sourceMappingURL=help.d.ts.map

package/dist/src/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,miEAmCtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,6vEA0CnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,kgEA0C5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,y3EA6CpB,CAAC"}

package/dist/src/help.js

@@ -0,0 +1,186 @@
+/**
+ * Help text for CLI commands
+ * This file centralizes all help text to keep command files clean
+ */
+/**
+ * Help text for the update command
+ */
+export const updateHelp = `
+Command Overview:
+  The update command helps you manage and update Powerhouse dependencies in your project. It provides
+  an efficient way to keep your project up-to-date with the latest versions of Powerhouse packages.
+  
+  This command:
+  1. Updates all Powerhouse dependencies based on the semver ranges specified in your package.json
+  2. Can force update all dependencies to a specific environment version (dev, prod, latest)
+  3. Automatically builds any local dependencies before updating
+  4. Works with all dependencies with @powerhousedao/ prefix and special packages like document-model
+
+Options:
+  --force <env>         Force update to the latest available version for the environment specified.
+                        Valid environments: dev, prod, latest.
+                        - dev: Uses @dev tag for all dependencies
+                        - prod/latest: Uses @latest tag for all dependencies
+                        
+  --package-manager     Override the auto-detected package manager with the specified one.
+                        
+  --debug               Show additional logs while executing the command.
+
+Special Cases:
+  - Local Dependencies: If you have dependencies linked from a local monorepo (using file: or link:
+    protocols), the command will detect the monorepo root, build affected packages, then update.
+  
+  - No Dependencies: If no Powerhouse dependencies are found in your project, the command will
+    display a message and exit without making changes.
+
+Examples:
+  $ ph update                          # Update dependencies based on package.json ranges
+  $ ph update --force dev              # Force update to latest dev version available
+  $ ph update --force prod             # Force update to latest stable version available (same as latest)
+  $ ph update --force latest           # Force update to latest stable version available (same as prod)
+  $ ph update --package-manager pnpm   # Specify package manager to use
+  $ ph update --debug                  # Show debug information during update
+`;
+/**
+ * Help text for the use command
+ */
+export const useHelp = `
+Command Overview:
+  The use command allows you to quickly switch between different environments for all Powerhouse
+  dependencies in your project. It provides a convenient way to toggle between development,
+  production, and local versions of the packages.
+
+  This command:
+  1. Updates all installed Powerhouse dependencies to the specified environment
+  2. Can link to local dependencies from a monorepo for development
+  3. Only updates dependencies that are already present in your package.json
+  4. Supports special packages without the @powerhousedao prefix
+
+Arguments:
+  <environment>         Required. The environment to use. Valid options:
+                        - dev: Use development versions (@dev tag)
+                        - prod/latest: Use production versions (@latest tag)
+                        - local: Use local filesystem versions (requires localPath)
+                        
+  [localPath]           Path to the local monorepo. Required when environment is 'local'.
+                        This should be the root of your Powerhouse monorepo.
+
+Options:
+  --force               Force environment to use, even if not in the predefined list
+                        
+  --package-manager     Override the auto-detected package manager with the specified one.
+                        
+  --debug               Show additional logs during execution for troubleshooting.
+
+Special Cases:
+  - Local Development: When using the 'local' environment, dependencies are linked directly
+    to local filesystem paths, allowing for real-time development and testing.
+  
+  - Missing Dependencies: The command only updates Powerhouse dependencies that are already
+    installed in your project. It won't add new ones.
+
+Examples:
+  $ ph use dev                       # Switch all dependencies to development versions
+  $ ph use prod                      # Switch all dependencies to production versions
+  $ ph use latest                    # Same as 'prod', use latest production versions
+  $ ph use local /path/to/monorepo   # Link to local versions in the specified monorepo
+  $ ph use dev --package-manager npm # Use npm instead of the auto-detected package manager
+  $ ph use dev --debug               # Show debug information during execution
+`;
+/**
+ * Help text for the setup-globals command
+ */
+export const setupGlobalsHelp = `
+Command Overview:
+  The setup-globals command initializes a new Powerhouse project with the necessary global 
+  configuration. It helps you set up a project quickly with proper defaults and dependencies.
+
+  This command:
+  1. Creates a new project with the specified name or in the current directory
+  2. Sets up all required Powerhouse dependencies
+  3. Configures the project with appropriate settings
+  4. Can run in interactive mode to guide you through the setup process
+
+Arguments:
+  [project-name]        Optional. Name of the project to create. If not provided,
+                        the command will use the current directory.
+
+Options:
+  -p, --project         Specify the name of the project to create.
+                        
+  -i, --interactive     Run the command in interactive mode, which will guide you
+                        through the setup process with questions and prompts.
+                        
+  -v, --version         Specify the development version to use. Defaults to "main".
+                        
+  --dev                 Use the "development" version of the boilerplate.
+                        
+  --staging             Use the "staging" version of the boilerplate.
+                        
+  --package-manager     Override the auto-detected package manager with the specified one.
+
+Project Structure:
+  The command will set up a project with the following structure:
+  - Proper configuration files for TypeScript and ESLint
+  - Dependencies for Powerhouse packages
+  - Build and development scripts
+
+Examples:
+  $ ph setup-globals my-project          # Create a new project named "my-project"
+  $ ph setup-globals                     # Set up a project in the current directory
+  $ ph setup-globals -i                  # Run setup in interactive mode
+  $ ph setup-globals --dev               # Use development version
+  $ ph setup-globals -v beta             # Use specific version
+  $ ph setup-globals --package-manager npm   # Use npm as package manager
+`;
+/**
+ * Help text for the init command
+ */
+export const initHelp = `
+Command Overview:
+  The init command creates a new Powerhouse project with optimal defaults. It sets up a fully 
+  configured project structure with all necessary dependencies, configurations, and boilerplate.
+
+  This command:
+  1. Creates a new project with the specified name
+  2. Installs all required dependencies for Powerhouse development
+  3. Sets up a proper project structure and configuration files
+  4. Can run in interactive mode for customized setup
+
+Arguments:
+  [project-name]        Optional. Name of the project to create. If not provided,
+                        you'll be prompted to provide a name, or the current directory 
+                        will be used if in interactive mode.
+
+Options:
+  -p, --project         Specify the name of the project to create.
+                        
+  -i, --interactive     Run the command in interactive mode, which will guide you
+                        through the project setup with customizable options.
+                        
+  -v, --version         Specify the development version to use. Defaults to "main".
+                        
+  --dev                 Use the "development" version of the boilerplate.
+                        
+  --staging             Use the "staging" version of the boilerplate.
+                        
+  --package-manager     Override the auto-detected package manager with the specified one.
+
+Project Structure:
+  The command will create a complete project with:
+  - Properly configured TypeScript and build settings
+  - Powerhouse document-model integration
+  - All necessary package.json dependencies
+  - Development scripts and tooling
+
+Examples:
+  $ ph init my-awesome-project                                # Create a new project named "my-awesome-project"
+  $ ph init -i                                                # Create a project in interactive mode
+  $ ph init -p my-project                                     # Same as ph init my-project
+  $ ph init --dev                                             # Use development version of boilerplate
+  $ ph init -v beta                                           # Use specific version
+  $ ph init --package-manager yarn                            # Use yarn as package manager
+  $ ph init my-awesome-project --dev --package-manager pnpm   # Create a project with Powerhouse dev packages and pnpm as package manager
+`;
+// Add other command help texts here as needed
+//# sourceMappingURL=help.js.map

package/dist/src/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCzB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CtB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C/B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CvB,CAAC;AAEF,8CAA8C"}

package/dist/src/index.d.ts

@@ -1,3 +1,3 @@
 export * from "./commands/index.js";
-export * from "./utils.js";
+export * from "./utils/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/src/index.js

@@ -1,3 +1,3 @@
 export * from "./commands/index.js";
-export * from "./utils.js";
+export * from "./utils/index.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/src/utils/help-formatting.d.ts

@@ -0,0 +1,35 @@
+import { type Command } from "commander";
+export declare const HELP_FORMATTING_CONFIG: {
+    FIXED_COLUMN_WIDTH: number;
+    COMMANDS_TO_PAD: string[];
+    DESCRIPTION_PADDING: string;
+};
+/**
+ * Merges CLI help text with the forwarded PH CLI help text
+ * @param {string} cliHelp - Commander-generated help text
+ * @param {string} forwardedHelp - Help text from the PH CLI
+ * @returns {string} Merged help text
+ */
+export declare function mergeHelp(cliHelp: string, forwardedHelp: string): string;
+/**
+ * Applies padding to command descriptions for better alignment
+ * @param {Command} program - Commander program instance
+ */
+export declare function applyCommandPadding(program: Command): void;
+/**
+ * Restores original command descriptions after generating help
+ * @param {Command} program - Commander program instance
+ */
+export declare function restoreCommandDescriptions(program: Command): void;
+/**
+ * Captures Commander help output as a string
+ * @param {Command} program - Commander program instance
+ * @returns {string} Help text as a string
+ */
+export declare function captureCommanderHelp(program: Command): string;
+/**
+ * Generates and displays the merged help output
+ * @param {Command} program - Commander program instance
+ */
+export declare function generateMergedHelp(program: Command): Promise<void>;
+//# sourceMappingURL=help-formatting.d.ts.map

package/dist/src/utils/help-formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-formatting.d.ts","sourceRoot":"","sources":["../../../src/utils/help-formatting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,eAAO,MAAM,sBAAsB;;;;CAOlC,CAAC;AAiEF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CA2DxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS1D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAOjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAe7D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BxE"}