@js-lib/cli

# Execute the CLI tool
npx @js-lib/cli [command] [options]

// Not recommended - internal APIs may change
const { checkProjectExists } = require('@js-lib/cli/util/file');
const { init } = require('@js-lib/cli/util/log');

# Interactive project creation
npx @js-lib/cli new my-awesome-lib
# Follow the interactive prompts to configure:
# - Project name
# - NPM package name
# - UMD name
# - GitHub username  
# - Template type (JavaScript or TypeScript)
# - Package manager preference

cd my-awesome-lib
npm install
npm run build
npm test

// File existence checking
function checkProjectExists(cmdPath: string, name: string): boolean;

// Template processing and file operations
function copyDir(from: string, to: string, options?: object): void;
function copyFile(from: string, to: string, opt?: {cover: boolean}): void;
function copyTmpl(from: string, to: string, data?: object, opt?: {cover: boolean}): void;
function readTmpl(from: string, data?: object): string;
function readJSON(from: string): object;

// JSON manipulation
function mergeObj2JSON(object: object, to: string): void;
function mergeJSON2JSON(from: string, to: string): void;
function mergeTmpl2JSON(from: string, to: string, data?: object): void;
function deleteJSONKeys(keysObj: object, to: string): void;

// File content manipulation
function replaceFileLine(filepath: string, match: RegExp, to: string): void;
function deleteFileLine(filepath: string, match: RegExp): void;
function replaceFileText(filepath: string, replacerList: Array<{from: RegExp|string, to: string|Function}>): void;
function insertText2File(text: string, filepath: string, line?: number): void;

// Directory operations
function deleteFile(filePath: string): void;
function deleteDir(dirPath: string): void;

jslib new [projectname] [options]
jslib n [projectname] [options]

Options:
  --force, -f              Force create (overwrite existing)
  --config, -c             Initialize only configuration file  
  --npmname, -n <name>     NPM package name
  --umdname, --umd <name>  UMD name for package
  --username, -u <name>    GitHub username
  --type, -t <type>        Template type (js/ts)
  --manager, -m <manager>  Package manager (npm/no install)

jslib update
jslib u

Requirements:
- Must be run in directory containing jslib.json
- Project must have been created with @js-lib/cli

# Interactive prompts are automatically triggered when:
# - Required information is not provided via command line options
# - Creating a new project without all necessary parameters

# The CLI will prompt for:
# - Project name (if not provided as argument)
# - NPM package name (with validation)  
# - UMD global variable name
# - GitHub username
# - Template type (JavaScript or TypeScript)
# - Package manager preference (npm or no install)

// Template variables available during project creation
interface TemplateVariables {
  name: string;        // Project display name
  npmname: string;     // NPM package name  
  umdname: string;     // UMD global variable name
  username: string;    // GitHub username
  type: 'js' | 'ts';  // Template type (JavaScript or TypeScript)
  manager: 'npm' | null; // Package manager
  version: string;     // CLI version
  pathname: string;    // Directory name
}

// Template files use EJS-style syntax:
// <%=variable%>     - Output variable value
// <% if (condition) { %> - Conditional blocks  
// <% for (var i=0; i<items.length; i++) { %> - Loop constructs

// Module initialization and update functions
interface ProjectModule {
  init(cmdPath: string, name: string, option: ProjectOptions): void | Promise<void>;
  update?(cmdPath: string, option: ProjectOptions): void;
}

// Available modules:
// - config: Project configuration (jslib.json)
// - root: Root files (README, LICENSE, etc.)
// - lint: ESLint and Prettier configuration
// - packagejson: package.json generation and updates
// - demo: Demo files and usage examples
// - build: Rollup build configuration
// - test: Mocha testing setup
// - manager: Package manager integration (npm install)

/**
 * Initialize git repository and install dependencies
 * @param cmdPath - Base directory path
 * @param name - Project directory name
 * @param option - Project configuration including manager preference
 * @returns Promise that resolves when installation completes
 */
function managerInit(
  cmdPath: string, 
  name: string, 
  option: ProjectOptions
): Promise<void>;

// Manager options:
// - 'npm': Run npm install after project creation
// - null: Skip dependency installation

// Project initialization options
interface ProjectOptions {
  pathname: string;    // Directory name to create
  name: string;        // Project display name
  npmname: string;     // NPM package name
  umdname: string;     // UMD global variable name  
  username: string;    // GitHub username
  type: 'js' | 'ts';  // Template type
  manager: 'npm' | null; // Package manager
  version: string;     // CLI version
}

// Command line arguments structure
interface CLIArguments {
  _: string[];         // Positional arguments
  force?: boolean;     // Force overwrite flag
  config?: boolean;    // Config-only flag
  npmname?: string;    // NPM name option
  umdname?: string;    // UMD name option  
  username?: string;   // Username option
  type?: string;       // Type option
  manager?: string;    // Manager option
}