@decaf-ts/cli 0.3.5 → 0.3.7

package/lib/utils.d.ts

@@ -1,49 +1,70 @@
 import { Command } from "commander";
 import { CliModule } from "./types";
 /**
- * @description util class to retrieve versions and other information
+ * @description Utility class for CLI operations
+ * @summary A static utility class that provides methods for loading modules, retrieving package information, and initializing CLI commands
+ *
+ * @example
+ * // Initialize a Command object with package information
+ * const command = new Command();
+ * CLIUtils.initialize(command, './path/to/package');
+ *
+ * // Load a CLI module from a file
+ * const module = await CLIUtils.loadFromFile('./path/to/cli-module.js');
  *
  * @class CLIUtils
- * @static
  */
 export declare class CLIUtils {
     /**
-     * @description Dynamically imports a cjs file into a decaf module
-     * @param {string} path
-     * @static
+     * @description Dynamically imports a module file
+     * @summary Loads a JavaScript file and returns it as a CliModule, handling both ESM and CommonJS formats
+     *
+     * @param {string} path The file path to the module to load
+     * @return {Promise<CliModule>} A promise that resolves to the loaded CliModule
      */
     static loadFromFile(path: string): Promise<CliModule>;
     /**
-     * @description allows safe dynamic imports
-     * @summary property imports JS files regardless of esm status
+     * @description Normalizes module imports to handle both ESM and CommonJS formats
+     * @summary Properly imports JavaScript files regardless of their module format by handling the ESM wrapper for CommonJS modules
      *
-     * @typeParam T
-     * @param {Promise} importPromise
+     * @template T The type of the imported module
+     * @param {Promise<T>} importPromise The promise returned by the dynamic import
+     * @return {Promise<T>} A promise that resolves to the normalized module
      * @private
      */
     static normalizeImport<T>(importPromise: Promise<T>): Promise<T>;
     /**
-     * @description initializes the Cli object
+     * @description Initializes a Command object with package information
+     * @summary Sets up a Commander Command object with the package name, description, and version from the package.json file
      *
-     * @param {Command} command
-     * @param {string} [basePath] defaults to the current working directory
+     * @param {Command} command The Command object to initialize
+     * @param {string} [basePath] The base path where the package.json file is located, defaults to the current working directory
+     * @return {void}
      */
     static initialize(command: Command, basePath: string): void;
     /**
-     * @description retrieves and parses the package.json file
+     * @description Retrieves and parses the package.json file
+     * @summary Reads the package.json file from the specified path and parses it into a JavaScript object
      *
-     * @param {string} basePath
+     * @param {string} basePath The base path where the package.json file is located
+     * @return {Record<string, unknown>} The parsed package.json content as an object
      * @private
      */
     private static getPackage;
     /**
-     * @description returns the package version
-     * @param {string} [basePath] defaults to current working dir
+     * @description Returns the version from package.json
+     * @summary Retrieves the version field from the package.json file at the specified path
+     *
+     * @param {string} basePath The base path where the package.json file is located
+     * @return {string} The package version string
      */
     static packageVersion(basePath: string): string;
     /**
-     * @description returns the package name
-     * @param {string} [basePath] defaults to current working dir
+     * @description Returns the name from package.json
+     * @summary Retrieves the name field from the package.json file at the specified path and extracts the package name without the scope
+     *
+     * @param {string} basePath The base path where the package.json file is located
+     * @return {string} The package name without the scope (e.g., "cli" from "@decaf-ts/cli")
      */
     static packageName(basePath: string): string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/cli",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "cli for decaf-ts projects",
   "type": "module",
   "exports": {
@@ -29,13 +29,21 @@
     "coverage": "rimraf ./workdocs/reports/data/*.json && npm run test:all -- --coverage --config=./workdocs/reports/jest.coverage.config.ts",
     "lint": "eslint .",
     "lint-fix": "eslint --fix .",
+    "prepare-pr": "npm run repo:pr && npm run lint-fix && npm run build:prod && npm run coverage && npm run docs",
     "prepare-release": "npm run lint-fix && npm run build:prod && npm run coverage && npm run docs",
     "release": "./bin/tag-release.sh",
     "clean-publish": "npx clean-publish",
     "drawings": "for FILE in workdocs/drawings/*.drawio; do echo \"converting $FILE to image...\" && docker run --rm -v $(pwd):/data rlespinasse/drawio-export --format png $FILE; done && cp -rf workdocs/drawings/export/* workdocs/resources/",
     "uml": "cd workdocs/uml && for FILE in ./*.puml; do docker run --rm -v $(pwd):/work -w /work miy4/plantuml -DPLANTUML_LIMIT_SIZE=8192 -tpng $FILE; done && cd ../.. && cp -fr workdocs/uml/*.png workdocs/resources/",
     "docs": "npx rimraf ./docs && mkdir docs && npx build-scripts --docs",
-    "publish-docs": "docker run -it --rm --user $(id -u):$(id -g) -v \"$(pwd)/workdocs/confluence:/content\" -e ATLASSIAN_API_TOKEN=$(cat .confluence-token) ghcr.io/markdown-confluence/publish:latest"
+    "publish-docs": "docker run -it --rm --user $(id -u):$(id -g) -v \"$(pwd)/workdocs/confluence:/content\" -e ATLASSIAN_API_TOKEN=$(cat .confluence-token) ghcr.io/markdown-confluence/publish:latest",
+    "repo:init": "codex exec \"$(cat ./.codex/prompts/repo-setup.md)\nbase_path is `./`, initialize the repository\"",
+    "repo:setup": "codex exec \"$(cat ./.codex/prompts/repo-setup.md)\nbase_path is ./\"",
+    "repo:doc": "codex exec \"$(cat ./.codex/prompts/doc.md) $(cat ./.codex/prompts/bulk-docs.md)\nbase_path is ./\"",
+    "repo:tests": "codex exec \"$(cat ./.codex/prompts/bulk-tests.md)\nbase_path is ./ and coverage is 95%\" -s workspace-write",
+    "repo:readme": "codex exec \"$(cat ./.codex/prompts/update-readme.md)\nbase_path is ./\"",
+    "repo:pr": "npm run repo:doc && npm run repo:tests && npm run repo:readme",
+    "sync-codex": "./bin/sync-codex.sh"
   },
   "repository": {
     "type": "git",
@@ -67,8 +75,8 @@
     "typescript",
     "ts"
   ],
-  "author": "Tiago Venceslau",
-  "license": "LGPL-3.0-or-later",
+  "author": "Tiago Venceslau and Contributors",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/decaf-ts/cli/issues"
   },