@cnpx/cnpx 0.0.4-dev.20260403235918 → 0.0.4-dev.20260404115856

package/README.md

@@ -1,107 +1,333 @@
-# @cnpx/cnpx
+# cnpx — Project Scaffolder
 
-`@cnpx/cnpx` is an interactive CLI that scaffolds projects from the
-[`xcfio/template`](https://github.com/xcfio/template) repository.
+An interactive CLI tool for creating new projects from curated templates hosted on GitHub. Pick a category, pick a template, and get coding.
 
-It fetches available categories and templates from GitHub, clones your selected
-template into a local directory, and prints the next commands to run.
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [CLI Flags](#cli-flags)
+- [Interactive Flow](#interactive-flow)
+- [Templates](#templates)
+- [Package Manager Detection](#package-manager-detection)
+- [Auto-Update Check](#auto-update-check)
+- [Validation](#validation)
+- [Dependencies](#dependencies)
+- [Development](#development)
+- [Links & Community](#links--community)
+
+---
+
+## Installation
+
+Install globally to use the `cnpx` command from anywhere.
 
-## Features
+**pnpm**
 
-- Interactive prompts for project name, category, and template
-- Live template discovery from `xcfio/template`
-- Automatic package manager detection (`pnpm`, `yarn`, then `npm`)
-- Update notification when a newer package version exists on npm
+```bash
+pnpm install -g @cnpx/cnpx
+```
 
-## Requirements
+**npm**
 
-- Node.js 22+
-- Internet access (GitHub API + npm registry)
+```bash
+npm install -g @cnpx/cnpx
+```
+
+**yarn**
+
+```bash
+yarn global add @cnpx/cnpx
+```
 
-## Usage
+> **Requires Node.js 22.5 or later.** Check your version with `node --version`.
 
-Run directly without installing globally:
+Alternatively, run without installing:
 
 ```bash
 npx @cnpx/cnpx
-# or
-pnpm dlx @cnpx/cnpx
-# or
-yarn dlx @cnpx/cnpx
 ```
 
-Then follow the prompts:
+---
+
+## Quick Start
+
+> **Important:** The `cnpx` command works only if `@cnpx/cnpx` is installed globally. If you have not installed it globally, use `npx @cnpx/cnpx` instead.
 
-1. Enter project name
-2. Select a category (for example: `backend`, `frontend`)
-3. Select a template
-4. Confirm creation
+Run `cnpx` with no arguments to launch the fully interactive prompt wizard:
+
+```bash
+cnpx
+```
 
-After scaffold, the CLI prints:
+Or skip straight to a known template with flags:
 
 ```bash
-cd <project-name>
-<detected-package-manager> install
-node --run dev
+cnpx --name my-app --template nextjs/starter
 ```
 
-## Global Install (Optional)
+---
+
+## CLI Flags
+
+All flags are optional. Any omitted value is collected interactively.
+
+| Flag               | Type      | Description                                                                                                                                   |
+| ------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `-n`, `--name`     | `string`  | Output directory / project name. Validated against filesystem rules — see [Validation](#validation).                                          |
+| `-c`, `--category` | `string`  | Template category (top-level directory in the template repo). Skips the category selection prompt.                                            |
+| `-t`, `--template` | `string`  | Template name. Accepts bare name (`starter`) or `category/template` slash syntax. Slash syntax also sets `--category`.                        |
+| `-f`, `--force`    | `boolean` | Overwrite a non-empty target directory without prompting. Skips both the overwrite confirmation and the final "create project?" confirmation. |
+| `-h`, `--help`     | `boolean` | Print the help message and exit. Also triggered by passing `help` as a bare argument.                                                         |
+
+### Examples
 
 ```bash
-npm i -g @cnpx/cnpx
+# Fully interactive
 cnpx
+
+# Name only — prompts for category and template
+cnpx --name my-project
+
+# Slash syntax — sets both category and template
+cnpx -t nextjs/starter
+
+# Category and template as separate flags
+cnpx --category nextjs --template starter
+
+# All flags — no prompts at all
+cnpx -n my-app -t nextjs/starter -f
+
+# Print help
+cnpx --help
+```
+
+> **Note:** Unknown flags are silently ignored (`strict: false` parse mode). Only the flags listed above have any effect.
+
+---
+
+## Interactive Flow
+
+When flags are omitted the CLI walks through a series of prompts in order:
+
 ```
+update check → project name → overwrite? → category → template → confirm → clone
+```
+
+1. **Update check** — silently queries the npm registry. If a newer version of `@cnpx/cnpx` exists, a note is shown with the upgrade command. Non-blocking.
+
+2. **Project name** — free-text prompt with default `my-project`. Validated in real-time. Skipped when `--name` is provided.
 
-## Programmatic API
+3. **Overwrite confirmation** — shown only when the target directory already exists _and_ is non-empty. Cancelling aborts. Skipped when `--force` is set.
 
-This package also exports utility functions:
+4. **Category selection** — fetches top-level directories from the GitHub template repo and presents a `select` list. Skipped when `--category` or a slash-template is provided.
 
-- `main()`
-- `checkForUpdate()`
-- `clone(name, category, template)`
-- `getCategories()`
-- `getTemplates(category)`
-- `getPackageManager()`
-- `get(url)`
+5. **Template selection** — fetches sub-directories for the chosen category. Skipped when `--template` is provided.
 
-Type exports:
+6. **Final confirmation** — summarises name, category, and template before cloning. Skipped when `--force` is set.
 
-- `FilteredGithubResponse`
-- `GithubAPIResponse`
+7. **Clone** — degit clones the template into the target directory, caching the result locally for faster re-runs.
+
+> Pressing `Ctrl+C` at any prompt cancels cleanly with an "Operation cancelled" message and exits with code `0`.
+
+---
+
+## Templates
+
+All templates live in the [xcfio/template](https://github.com/xcfio/template) GitHub repository. The directory structure is:
+
+```
+xcfio/template
+├── <category>/
+│   ├── <template-name>/
+│   │   └── ... template files
+│   └── <template-name>/
+└── <category>/
+    └── ...
+```
+
+The following top-level directories are always excluded from the category list:
+
+- `.github`
+- `cnpx`
+
+Templates are cloned using **degit** with `cache: true`, so repeated clones of the same template are served from a local cache instead of re-downloading from GitHub.
+
+> **API rate limits:** Template lists are fetched live from the GitHub Contents API. If you encounter `API rate limit exceeded`, wait a few minutes and try again. Authenticated requests are not currently supported.
+
+---
+
+## Package Manager Detection
+
+cnpx auto-detects the best available package manager by probing in priority order:
+
+```
+pnpm → yarn → npm
+```
+
+Detection runs `pnpm --version` and `yarn --version` via `execSync`. The first one that succeeds wins. The result is cached after the first call so subsequent lookups are free.
+
+The detected package manager is used in:
+
+- The update-available note (`run: <pm> i -g @cnpx/cnpx`)
+- The post-clone "get started" instructions
+
+---
+
+## Auto-Update Check
+
+At startup, cnpx fetches the latest version from the npm registry:
+
+```
+GET https://registry.npmjs.org/@cnpx/cnpx/latest
+```
+
+Versions are compared with a custom semver parser that handles pre-release identifiers correctly (numeric parts compared numerically, string parts lexicographically). If the remote version is _newer_ than the running version, a note is displayed:
+
+```
+┌  Update available ───────────────╮
+│                                  │
+│  Current: 0.0.4 → Latest: 0.0.5  │
+│  Run: pnpm i -g @cnpx/cnpx       │
+│                                  │
+└──────────────────────────────────╯
+```
+
+The check is non-blocking — any error (network failure, rate limit) is silently swallowed so it never interrupts the main flow.
+
+---
+
+## Validation
+
+### Directory name rules
+
+The project name is validated before any I/O happens. The following conditions cause an error:
+
+| Rule                                                                        | Error message                                            |
+| --------------------------------------------------------------------------- | -------------------------------------------------------- |
+| Empty or only whitespace                                                    | `Directory name cannot be empty`                         |
+| Longer than 255 characters                                                  | `Directory name is too long`                             |
+| Contains `< > : " / \ \| ? *` or control characters                         | `Directory name contains invalid characters`             |
+| Starts or ends with `.` or a space                                          | `Directory name cannot start or end with a dot or space` |
+| Windows reserved names (`CON`, `PRN`, `AUX`, `NUL`, `COM0`–`9`, `LPT0`–`9`) | `Directory name is a reserved name`                      |
+
+### Target path rules
+
+After name validation, the resolved path is checked:
+
+| Condition                        | Behaviour                                                        |
+| -------------------------------- | ---------------------------------------------------------------- |
+| Path does not exist              | Proceeds normally                                                |
+| Path is an empty directory       | Proceeds normally (no overwrite prompt)                          |
+| Path is a non-empty directory    | Overwrite confirmation prompt (or auto-continues with `--force`) |
+| Path is a file (not a directory) | Hard error — exits with code `1`                                 |
+
+### Exit codes
+
+| Code | Meaning                                                                       |
+| ---- | ----------------------------------------------------------------------------- |
+| `0`  | Success or user-cancelled                                                     |
+| `1`  | Validation error, target-is-file error, API rate limit, or uncaught exception |
+
+---
+
+## Dependencies
+
+### Runtime
+
+| Package          | Version   | Purpose                                                                            |
+| ---------------- | --------- | ---------------------------------------------------------------------------------- |
+| `@clack/prompts` | `^1.2.0`  | Beautiful interactive prompts — text, select, confirm, spinner, note, outro        |
+| `colorette`      | `^2.0.20` | Zero-dependency terminal colour helpers (`blue`, `green`, `bold`, `dim`, `yellow`) |
+| `degit`          | `^2.8.4`  | Fast git-based scaffolding without cloning full history; supports local caching    |
+
+### Dev / Build
+
+| Package        | Version   | Purpose                                                              |
+| -------------- | --------- | -------------------------------------------------------------------- |
+| `tsup`         | `^8.5.1`  | Zero-config TypeScript bundler; outputs CJS (`.js`) and ESM (`.mjs`) |
+| `@types/degit` | `^2.8.6`  | TypeScript types for degit                                           |
+| `@types/node`  | `^25.5.2` | TypeScript types for Node.js built-in APIs                           |
+
+All runtime dependencies are pure-JS and work without native addons.
+
+---
 
 ## Development
 
-From `cnpx/cnpx`:
+### Project structure
 
-```bash
-node --run install
-node --run dev
-node --run build
-node --run test
+```
+src/
+├── bin.ts                  # Entry point — wires showHelp + main
+├── main.ts                 # Orchestrates the full interactive flow
+├── clone.ts                # Wraps degit clone with a spinner
+├── checkForUpdate.ts       # npm registry version check + semver comparison
+├── getCategories.ts        # GitHub API → category list
+├── getTemplates.ts         # GitHub API → template list for a category
+├── getPackageManager.ts    # pnpm / yarn / npm detection (cached)
+├── isInvalidPath.ts        # Target path existence and type checks
+├── isValidDirectoryName.ts # Name validation logic
+├── fetch.ts                # Thin fetch wrapper returning typed JSON
+└── showHelp.ts             # --help output
 ```
 
-Available scripts:
+### npm scripts
 
-- `node --run fmt` - format source with Prettier
-- `node --run lint` - check formatting
-- `node --run dev` - build in watch mode with tsup
-- `node --run build` - production build
-- `node --run test` - type-check with `tsc --noEmit`
+| Script             | What it does                                             |
+| ------------------ | -------------------------------------------------------- |
+| `node --run dev`   | Runs `tsup --watch` — rebuilds on every file change      |
+| `node --run build` | Runs `tsup` — produces the `out/` directory              |
+| `node --run test`  | Runs `tsc --noEmit` — type-checks without emitting files |
+| `node --run lint`  | Checks formatting with Prettier                          |
+| `node --run fmt`   | Auto-formats all source files with Prettier              |
 
-## Notes and Limitations
+### Module format
 
-- The CLI is currently fully interactive and does not expose command-line flags.
-- GitHub API rate limits can block category/template loading.
+The package sets `"type": "commonjs"` but ships both CJS (`index.js`) and ESM (`index.mjs`) via the `exports` map, so it works with both `require()` and `import`.
 
-## Support
+```json
+"exports": {
+  ".": {
+    "import": "./out/index.mjs",
+    "require": "./out/index.js"
+  }
+}
+```
 
-- Issues: [GitHub Issues](https://github.com/xcfio/template/issues)
-- Discord: [Discord Server](https://discord.gg/FaCCaFM74Q)
+### Publishing
 
-## License
+The package is published publicly to npm under the `latest` tag:
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+```json
+"publishConfig": {
+  "access": "public",
+  "tag": "latest"
+}
+```
+
+---
+
+## Links & Community
+
+| Resource          | URL                                                          |
+| ----------------- | ------------------------------------------------------------ |
+| GitHub repository | https://github.com/xcfio/template                            |
+| npm package       | https://www.npmjs.com/package/@cnpx/cnpx                     |
+| Homepage          | https://github.com/xcfio/template/tree/main/cnpx/cnpx#readme |
+| Bug reports       | https://github.com/xcfio/template/issues                     |
+| Bug report email  | omarfaruksxp@gmail.com                                       |
+
+### Discord
+
+Join the community on Discord for help, template sharing, and discussion:
+
+**https://discord.gg/FaCCaFM74Q**
 
 ---
 
 Made with ❤️ by [xcfio](https://github.com/xcfio)
+
+_If cnpx saves you time, consider leaving a star on the [GitHub repo](https://github.com/xcfio/template)._

package/out/bin.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-'use strict';var main=require('./main');var o=(r,e)=>()=>(e||r((e={exports:{}}).exports,e),e.exports);var s=o(()=>{process.removeAllListeners("warning"),main.main().catch(r=>{console.error(r),process.exit(1);});});var bin = s();module.exports=bin;
+'use strict';var showHelp=require('./showHelp'),main=require('./main');var s=(r,e)=>()=>(e||r((e={exports:{}}).exports,e),e.exports);var i=s(()=>{process.removeAllListeners("warning"),(process.argv.includes("help")||process.argv.includes("--help")||process.argv.includes("-h"))&&showHelp.showHelp(),main.main().catch(r=>{console.error(r),process.exit(1);});});var bin = i();module.exports=bin;

package/out/bin.mjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import {a}from'./chunk-A7RKGLUR.mjs';import {main}from'./main';var n=a(()=>{process.removeAllListeners("warning"),main().catch(e=>{console.error(e),process.exit(1);});});var bin = n();export{bin as default};
+import {a}from'./chunk-A7RKGLUR.mjs';import {showHelp}from'./showHelp';import {main}from'./main';var c=a(()=>{process.removeAllListeners("warning"),(process.argv.includes("help")||process.argv.includes("--help")||process.argv.includes("-h"))&&showHelp(),main().catch(e=>{console.error(e),process.exit(1);});});var bin = c();export{bin as default};

package/out/checkForUpdate.d.mts

@@ -1,3 +1,8 @@
+import { ParsedSemver } from './type.mjs';
+
+declare function parseSemver(value: string): ParsedSemver | null;
+declare function compareIdentifier(left: string, right: string): number;
+declare function compareSemver(left: string, right: string): number;
 declare function checkForUpdate(): Promise<void>;
 
-export { checkForUpdate };
+export { checkForUpdate, compareIdentifier, compareSemver, parseSemver };

package/out/checkForUpdate.d.ts

@@ -1,3 +1,8 @@
+import { ParsedSemver } from './type.js';
+
+declare function parseSemver(value: string): ParsedSemver | null;
+declare function compareIdentifier(left: string, right: string): number;
+declare function compareSemver(left: string, right: string): number;
 declare function checkForUpdate(): Promise<void>;
 
-export { checkForUpdate };
+export { checkForUpdate, compareIdentifier, compareSemver, parseSemver };

package/out/checkForUpdate.js

@@ -1,2 +1,2 @@
-'use strict';var getPackageManager=require('./getPackageManager'),package_json=require('../package.json'),prompts=require('@clack/prompts'),colorette=require('colorette'),fetch=require('./fetch');function f(n){const t=/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(n);return t?{major:Number(t[1]),minor:Number(t[2]),patch:Number(t[3]),pre:t[4]?t[4].split("."):[]}:null}function h(n,t){const r=/^\d+$/.test(n),e=/^\d+$/.test(t);if(r&&e){const o=Number(n),i=Number(t);return o<i?-1:o>i?1:0}return r&&!e?-1:!r&&e?1:n<t?-1:n>t?1:0}function b(n,t){const r=f(n),e=f(t);if(!r||!e)return n.localeCompare(t,void 0,{numeric:true,sensitivity:"base"});if(r.major!==e.major)return r.major<e.major?-1:1;if(r.minor!==e.minor)return r.minor<e.minor?-1:1;if(r.patch!==e.patch)return r.patch<e.patch?-1:1;if(r.pre.length===0&&e.pre.length===0)return 0;if(r.pre.length===0)return 1;if(e.pre.length===0)return  -1;const o=Math.max(r.pre.length,e.pre.length);for(let i=0;i<o;i++){const u=r.pre[i],a=e.pre[i];if(u===void 0)return  -1;if(a===void 0)return 1;const m=h(u,a);if(m!==0)return m}return 0}async function P(){try{const{data:n}=await fetch.get(`https://registry.npmjs.org/${package_json.name}/latest`);if(b(n.version,package_json.version)<=0)return;prompts.note(`Current: ${colorette.bold(package_json.version)} \u2192 Latest: ${colorette.bold(n.version)}
-Run: ${getPackageManager.getPackageManager()} i -g ${package_json.name}`,"Update available");}catch{}}exports.checkForUpdate=P;
+'use strict';var getPackageManager=require('./getPackageManager'),package_json=require('../package.json'),prompts=require('@clack/prompts'),colorette=require('colorette'),fetch=require('./fetch');function f(n){const r=/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(n);return r?{major:Number(r[1]),minor:Number(r[2]),patch:Number(r[3]),pre:r[4]?r[4].split("."):[]}:null}function b(n,r){const e=/^\d+$/.test(n),t=/^\d+$/.test(r);if(e&&t){const o=Number(n),i=Number(r);return o<i?-1:o>i?1:0}return e&&!t?-1:!e&&t?1:n<r?-1:n>r?1:0}function v(n,r){const e=f(n),t=f(r);if(!e||!t)return n.localeCompare(r,void 0,{numeric:true,sensitivity:"base"});if(e.major!==t.major)return e.major<t.major?-1:1;if(e.minor!==t.minor)return e.minor<t.minor?-1:1;if(e.patch!==t.patch)return e.patch<t.patch?-1:1;if(e.pre.length===0&&t.pre.length===0)return 0;if(e.pre.length===0)return 1;if(t.pre.length===0)return  -1;const o=Math.max(e.pre.length,t.pre.length);for(let i=0;i<o;i++){const a=e.pre[i],u=t.pre[i];if(a===void 0)return  -1;if(u===void 0)return 1;const m=b(a,u);if(m!==0)return m}return 0}async function k(){const n=prompts.spinner();n.start("Checking for updates");try{const{data:r}=await fetch.get(`https://registry.npmjs.org/${package_json.name}/latest`);if(v(r.version,package_json.version)<=0)return;prompts.note(`Current: ${colorette.bold(package_json.version)} \u2192 Latest: ${colorette.bold(r.version)}
+Run: ${getPackageManager.getPackageManager()} i -g ${package_json.name}`,"Update available");}catch{}finally{n.clear();}}exports.checkForUpdate=k;exports.compareIdentifier=b;exports.compareSemver=v;exports.parseSemver=f;

package/out/checkForUpdate.mjs

@@ -1,2 +1,2 @@
-import'./chunk-A7RKGLUR.mjs';import {getPackageManager}from'./getPackageManager';import {name,version}from'../package.json';import {note}from'@clack/prompts';import {bold}from'colorette';import {get}from'./fetch';function f(n){const t=/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(n);return t?{major:Number(t[1]),minor:Number(t[2]),patch:Number(t[3]),pre:t[4]?t[4].split("."):[]}:null}function h(n,t){const r=/^\d+$/.test(n),e=/^\d+$/.test(t);if(r&&e){const o=Number(n),i=Number(t);return o<i?-1:o>i?1:0}return r&&!e?-1:!r&&e?1:n<t?-1:n>t?1:0}function b(n,t){const r=f(n),e=f(t);if(!r||!e)return n.localeCompare(t,void 0,{numeric:true,sensitivity:"base"});if(r.major!==e.major)return r.major<e.major?-1:1;if(r.minor!==e.minor)return r.minor<e.minor?-1:1;if(r.patch!==e.patch)return r.patch<e.patch?-1:1;if(r.pre.length===0&&e.pre.length===0)return 0;if(r.pre.length===0)return 1;if(e.pre.length===0)return  -1;const o=Math.max(r.pre.length,e.pre.length);for(let i=0;i<o;i++){const u=r.pre[i],a=e.pre[i];if(u===void 0)return  -1;if(a===void 0)return 1;const m=h(u,a);if(m!==0)return m}return 0}async function P(){try{const{data:n}=await get(`https://registry.npmjs.org/${name}/latest`);if(b(n.version,version)<=0)return;note(`Current: ${bold(version)} \u2192 Latest: ${bold(n.version)}
-Run: ${getPackageManager()} i -g ${name}`,"Update available");}catch{}}export{P as checkForUpdate};
+import'./chunk-A7RKGLUR.mjs';import {getPackageManager}from'./getPackageManager';import {name,version}from'../package.json';import {spinner,note}from'@clack/prompts';import {bold}from'colorette';import {get}from'./fetch';function f(n){const r=/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(n);return r?{major:Number(r[1]),minor:Number(r[2]),patch:Number(r[3]),pre:r[4]?r[4].split("."):[]}:null}function b(n,r){const e=/^\d+$/.test(n),t=/^\d+$/.test(r);if(e&&t){const o=Number(n),i=Number(r);return o<i?-1:o>i?1:0}return e&&!t?-1:!e&&t?1:n<r?-1:n>r?1:0}function v(n,r){const e=f(n),t=f(r);if(!e||!t)return n.localeCompare(r,void 0,{numeric:true,sensitivity:"base"});if(e.major!==t.major)return e.major<t.major?-1:1;if(e.minor!==t.minor)return e.minor<t.minor?-1:1;if(e.patch!==t.patch)return e.patch<t.patch?-1:1;if(e.pre.length===0&&t.pre.length===0)return 0;if(e.pre.length===0)return 1;if(t.pre.length===0)return  -1;const o=Math.max(e.pre.length,t.pre.length);for(let i=0;i<o;i++){const a=e.pre[i],u=t.pre[i];if(a===void 0)return  -1;if(u===void 0)return 1;const m=b(a,u);if(m!==0)return m}return 0}async function k(){const n=spinner();n.start("Checking for updates");try{const{data:r}=await get(`https://registry.npmjs.org/${name}/latest`);if(v(r.version,version)<=0)return;note(`Current: ${bold(version)} \u2192 Latest: ${bold(r.version)}
+Run: ${getPackageManager()} i -g ${name}`,"Update available");}catch{}finally{n.clear();}}export{k as checkForUpdate,b as compareIdentifier,v as compareSemver,f as parseSemver};

package/out/clone.d.mts

@@ -1,3 +1,3 @@
-declare function clone(name: string, type: string, template: string, force: boolean): Promise<void>;
+declare function clone(name: string, template: string, force: boolean): Promise<void>;
 
 export { clone };

package/out/clone.d.ts

@@ -1,3 +1,3 @@
-declare function clone(name: string, type: string, template: string, force: boolean): Promise<void>;
+declare function clone(name: string, template: string, force: boolean): Promise<void>;
 
 export { clone };

package/out/clone.js

@@ -1 +1 @@
-'use strict';var prompts=require('@clack/prompts'),s=require('degit');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var s__default=/*#__PURE__*/_interopDefault(s);async function a(e,o,n,r){const t=prompts.spinner();t.start("Cloning repository"),await s__default.default(`xcfio/template/${o}/${n}`,{force:r,cache:true,verbose:true}).clone(e),t.stop("Template cloned successfully");}exports.clone=a;
+'use strict';var prompts=require('@clack/prompts'),i=require('degit');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var i__default=/*#__PURE__*/_interopDefault(i);async function p(t,o,n){const e=prompts.spinner();e.start("Cloning repository"),await i__default.default(`xcfio/template/${o}`,{force:n,cache:true,verbose:true}).clone(t),e.stop("Template cloned successfully");}exports.clone=p;

package/out/clone.mjs

@@ -1 +1 @@
-import'./chunk-A7RKGLUR.mjs';import {spinner}from'@clack/prompts';import s from'degit';async function a(e,o,n,r){const t=spinner();t.start("Cloning repository"),await s(`xcfio/template/${o}/${n}`,{force:r,cache:true,verbose:true}).clone(e),t.stop("Template cloned successfully");}export{a as clone};
+import'./chunk-A7RKGLUR.mjs';import {spinner}from'@clack/prompts';import i from'degit';async function p(t,o,n){const e=spinner();e.start("Cloning repository"),await i(`xcfio/template/${o}`,{force:n,cache:true,verbose:true}).clone(t),e.stop("Template cloned successfully");}export{p as clone};

package/out/getPackageManager.d.mts

@@ -1,3 +1,4 @@
+declare let packageManager: "npm" | "yarn" | "pnpm";
 declare function getPackageManager(): "npm" | "yarn" | "pnpm";
 
-export { getPackageManager };
+export { getPackageManager, packageManager };

package/out/getPackageManager.d.ts

@@ -1,3 +1,4 @@
+declare let packageManager: "npm" | "yarn" | "pnpm";
 declare function getPackageManager(): "npm" | "yarn" | "pnpm";
 
-export { getPackageManager };
+export { getPackageManager, packageManager };

package/out/getPackageManager.js

@@ -1 +1 @@
-'use strict';var node_child_process=require('node:child_process');let n;function p(){if(n)return n;try{return node_child_process.execSync("pnpm --version",{stdio:"ignore"}),n="pnpm","pnpm"}catch{}try{return node_child_process.execSync("yarn --version",{stdio:"ignore"}),n="yarn","yarn"}catch{}return n="npm","npm"}exports.getPackageManager=p;
+'use strict';var node_child_process=require('node:child_process');exports.packageManager=void 0;function p(){if(exports.packageManager)return exports.packageManager;try{return node_child_process.execSync("pnpm --version",{stdio:"ignore"}),exports.packageManager="pnpm","pnpm"}catch{}try{return node_child_process.execSync("yarn --version",{stdio:"ignore"}),exports.packageManager="yarn","yarn"}catch{}return exports.packageManager="npm","npm"}exports.getPackageManager=p;

package/out/getPackageManager.mjs

@@ -1 +1 @@
-import'./chunk-A7RKGLUR.mjs';import {execSync}from'node:child_process';let n;function p(){if(n)return n;try{return execSync("pnpm --version",{stdio:"ignore"}),n="pnpm","pnpm"}catch{}try{return execSync("yarn --version",{stdio:"ignore"}),n="yarn","yarn"}catch{}return n="npm","npm"}export{p as getPackageManager};
+import'./chunk-A7RKGLUR.mjs';import {execSync}from'node:child_process';let n;function p(){if(n)return n;try{return execSync("pnpm --version",{stdio:"ignore"}),n="pnpm","pnpm"}catch{}try{return execSync("yarn --version",{stdio:"ignore"}),n="yarn","yarn"}catch{}return n="npm","npm"}export{p as getPackageManager,n as packageManager};

package/out/index.d.mts

@@ -1,11 +1,14 @@
-export { checkForUpdate } from './checkForUpdate.mjs';
+export { checkForUpdate, compareIdentifier, compareSemver, parseSemver } from './checkForUpdate.mjs';
 export { clone } from './clone.mjs';
 export { get } from './fetch.mjs';
 export { IgnoredDirectory, getCategories } from './getCategories.mjs';
-export { getPackageManager } from './getPackageManager.mjs';
+export { getPackageManager, packageManager } from './getPackageManager.mjs';
 export { getTemplates } from './getTemplates.mjs';
+export { isInvalidPath } from './isInvalidPath.mjs';
+export { isValidDirectoryName } from './isValidDirectoryName.mjs';
 export { main } from './main.mjs';
-export { FilteredGithubResponse, GithubAPIResponse } from './type.mjs';
+export { showHelp } from './showHelp.mjs';
+export { FilteredGithubResponse, GithubAPIResponse, ParsedSemver } from './type.mjs';
 
 var version = "0.0.4";
 

package/out/index.d.ts

@@ -1,11 +1,14 @@
-export { checkForUpdate } from './checkForUpdate.js';
+export { checkForUpdate, compareIdentifier, compareSemver, parseSemver } from './checkForUpdate.js';
 export { clone } from './clone.js';
 export { get } from './fetch.js';
 export { IgnoredDirectory, getCategories } from './getCategories.js';
-export { getPackageManager } from './getPackageManager.js';
+export { getPackageManager, packageManager } from './getPackageManager.js';
 export { getTemplates } from './getTemplates.js';
+export { isInvalidPath } from './isInvalidPath.js';
+export { isValidDirectoryName } from './isValidDirectoryName.js';
 export { main } from './main.js';
-export { FilteredGithubResponse, GithubAPIResponse } from './type.js';
+export { showHelp } from './showHelp.js';
+export { FilteredGithubResponse, GithubAPIResponse, ParsedSemver } from './type.js';
 
 var version = "0.0.4";
 

package/out/index.js

@@ -1 +1 @@
-'use strict';var package_json=require('../package.json'),checkForUpdate=require('./checkForUpdate'),clone=require('./clone'),fetch=require('./fetch'),getCategories=require('./getCategories'),getPackageManager=require('./getPackageManager'),getTemplates=require('./getTemplates'),main=require('./main'),type=require('./type');Object.defineProperty(exports,"version",{enumerable:true,get:function(){return package_json.version}});Object.keys(checkForUpdate).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return checkForUpdate[k]}})});Object.keys(clone).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return clone[k]}})});Object.keys(fetch).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return fetch[k]}})});Object.keys(getCategories).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return getCategories[k]}})});Object.keys(getPackageManager).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return getPackageManager[k]}})});Object.keys(getTemplates).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return getTemplates[k]}})});Object.keys(main).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return main[k]}})});Object.keys(type).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return type[k]}})});
+'use strict';var package_json=require('../package.json'),checkForUpdate=require('./checkForUpdate'),clone=require('./clone'),fetch=require('./fetch'),getCategories=require('./getCategories'),getPackageManager=require('./getPackageManager'),getTemplates=require('./getTemplates'),isInvalidPath=require('./isInvalidPath'),isValidDirectoryName=require('./isValidDirectoryName'),main=require('./main'),showHelp=require('./showHelp'),type=require('./type');Object.defineProperty(exports,"version",{enumerable:true,get:function(){return package_json.version}});Object.keys(checkForUpdate).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return checkForUpdate[k]}})});Object.keys(clone).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return clone[k]}})});Object.keys(fetch).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return fetch[k]}})});Object.keys(getCategories).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return getCategories[k]}})});Object.keys(getPackageManager).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return getPackageManager[k]}})});Object.keys(getTemplates).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return getTemplates[k]}})});Object.keys(isInvalidPath).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return isInvalidPath[k]}})});Object.keys(isValidDirectoryName).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return isValidDirectoryName[k]}})});Object.keys(main).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return main[k]}})});Object.keys(showHelp).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return showHelp[k]}})});Object.keys(type).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return type[k]}})});

package/out/index.mjs

@@ -1 +1 @@
-import'./chunk-A7RKGLUR.mjs';export{version}from'../package.json';export*from'./checkForUpdate';export*from'./clone';export*from'./fetch';export*from'./getCategories';export*from'./getPackageManager';export*from'./getTemplates';export*from'./main';export*from'./type';
+import'./chunk-A7RKGLUR.mjs';export{version}from'../package.json';export*from'./checkForUpdate';export*from'./clone';export*from'./fetch';export*from'./getCategories';export*from'./getPackageManager';export*from'./getTemplates';export*from'./isInvalidPath';export*from'./isValidDirectoryName';export*from'./main';export*from'./showHelp';export*from'./type';

package/out/isValidDirectoryName.d.mts

@@ -0,0 +1,3 @@
+declare function isValidDirectoryName(name: string): boolean | string;
+
+export { isValidDirectoryName };

package/out/isValidDirectoryName.d.ts

@@ -0,0 +1,3 @@
+declare function isValidDirectoryName(name: string): boolean | string;
+
+export { isValidDirectoryName };

package/out/isValidDirectoryName.js

@@ -0,0 +1 @@
+'use strict';function t(r){return !r||!r.trim()?"Directory name cannot be empty":r.length>255?"Directory name is too long":/[<>:"/\\|?*\x00-\x1f]/.test(r)?"Directory name contains invalid characters":/^[. ]|[. ]$/.test(r)?"Directory name cannot start or end with a dot or space":/^(con|prn|aux|nul|com[0-9]|lpt[0-9])$/i.test(r)?"Directory name is a reserved name":true}exports.isValidDirectoryName=t;

package/out/isValidDirectoryName.mjs

@@ -0,0 +1 @@
+import'./chunk-A7RKGLUR.mjs';function t(r){return !r||!r.trim()?"Directory name cannot be empty":r.length>255?"Directory name is too long":/[<>:"/\\|?*\x00-\x1f]/.test(r)?"Directory name contains invalid characters":/^[. ]|[. ]$/.test(r)?"Directory name cannot start or end with a dot or space":/^(con|prn|aux|nul|com[0-9]|lpt[0-9])$/i.test(r)?"Directory name is a reserved name":true}export{t as isValidDirectoryName};

package/out/main.js

@@ -1,4 +1,4 @@
-'use strict';var prompts=require('@clack/prompts'),getPackageManager=require('./getPackageManager'),colorette=require('colorette'),checkForUpdate=require('./checkForUpdate'),isInvalidPath=require('./isInvalidPath'),getCategories=require('./getCategories'),getTemplates=require('./getTemplates'),clone=require('./clone'),node_path=require('node:path');async function q(){prompts.intro(colorette.blue("Create a new project"));const c=prompts.spinner();c.start("Checking for updates"),await checkForUpdate.checkForUpdate(),c.clear();const t=await prompts.text({message:"Project Name",placeholder:"my-project",defaultValue:"my-project"});if(prompts.isCancel(t))return prompts.cancel("Operation cancelled"),process.exit(0);const s=isInvalidPath.isInvalidPath(node_path.join(process.cwd(),t));let m=false;if(s!==null)if(s){const e=await prompts.confirm({message:`Directory ${colorette.green(t)} already exists. Do you want to overwrite it?`});if(prompts.isCancel(e)||!e)return prompts.cancel("Operation cancelled"),process.exit(0);m=true;}else return prompts.cancel(`${colorette.green(t)} is a file. Please choose a different project name.`),process.exit(1);const d=await getCategories.getCategories(),r=await prompts.select({message:"Select a category",options:d.map(e=>({name:e.name,value:e.name}))});if(prompts.isCancel(r))return prompts.cancel("Operation cancelled"),process.exit(0);const g=await getTemplates.getTemplates(r),n=await prompts.select({message:"Select a template",options:g.map(e=>({name:e.name,value:e.name}))});if(prompts.isCancel(n))return prompts.cancel("Operation cancelled"),process.exit(0);const l=await prompts.confirm({message:`Create project with name: ${colorette.bold(t)}, category: ${colorette.bold(r)}, template: ${colorette.bold(n)}?`});if(prompts.isCancel(l)||!l)return prompts.cancel("Operation cancelled"),process.exit(0);await clone.clone(t,r,n,m),prompts.note(`cd ${t}
+'use strict';var prompts=require('@clack/prompts'),isValidDirectoryName=require('./isValidDirectoryName'),getPackageManager=require('./getPackageManager'),colorette=require('colorette'),checkForUpdate=require('./checkForUpdate'),isInvalidPath=require('./isInvalidPath'),getCategories=require('./getCategories'),getTemplates=require('./getTemplates'),node_util=require('node:util'),clone=require('./clone'),node_path=require('node:path');async function B(){prompts.intro(colorette.blue("cnpx - Create a new project from a template"));const r=["",""],{values:t}=node_util.parseArgs({args:process.argv.slice(2),strict:false,options:{category:{type:"string",short:"c"},template:{type:"string",short:"t"},name:{type:"string",short:"n"},force:{type:"boolean",short:"f"},help:{type:"boolean",short:"h"}}});if(typeof t.name=="string"){const e=isValidDirectoryName.isValidDirectoryName(t.name);if(typeof e=="string")return prompts.cancel(e),process.exit(1)}if(typeof t.category=="string"&&(r[0]=t.category),typeof t.template=="string")if(t.template.includes("/")){const[e,n]=t.template.split("/");r[0]=e,r[1]=n;}else r[1]=t.template;await checkForUpdate.checkForUpdate();const o=typeof t.name=="string"?t.name:await prompts.text({message:"Project Name",placeholder:"my-project",defaultValue:"my-project",validate:e=>{if(!e)return;const n=isValidDirectoryName.isValidDirectoryName(e);if(typeof n=="string")return new Error(n)}});if(prompts.isCancel(o))return prompts.cancel("Operation cancelled"),process.exit(0);const p=isInvalidPath.isInvalidPath(node_path.join(process.cwd(),o));let l=typeof t.force=="boolean"?t.force:false;if(p!==null)if(p){if(t.force!==true){const e=await prompts.confirm({message:`Directory ${colorette.green(o)} already exists. Do you want to overwrite it?`});if(prompts.isCancel(e)||!e)return prompts.cancel("Operation cancelled"),process.exit(0)}l=true;}else return prompts.cancel(`${colorette.green(o)} is a file. Please choose a different project name.`),process.exit(1);const d=await getCategories.getCategories(),s=r[0]||await prompts.select({message:"Select a category",options:d.map(e=>({name:e.name,value:e.name}))});if(prompts.isCancel(s))return prompts.cancel("Operation cancelled"),process.exit(0);r[0]=s;const w=await getTemplates.getTemplates(s),m=r[1]||await prompts.select({message:"Select a template",options:w.map(e=>({name:e.name,value:e.name}))});if(prompts.isCancel(m))return prompts.cancel("Operation cancelled"),process.exit(0);if(r[1]=m,t.force!==true){const e=await prompts.confirm({message:`Create project with name: ${colorette.bold(o)}, category: ${colorette.bold(r[0])}, template: ${colorette.bold(r[1])}?`});if(prompts.isCancel(e)||!e)return prompts.cancel("Operation cancelled"),process.exit(0)}await clone.clone(o,`${r.join("/")}`,l),prompts.note(`cd ${o}
 ${getPackageManager.getPackageManager()} install
-node --run dev`,"To get started, run:"),prompts.outro(`Thanks for using template! \u2B50 Give a ${colorette.yellow("star")} on GitHub: https://github.com/xcfio/template`);}
-exports.main=q;
+node --run dev`,"To get started, run:"),prompts.outro(`Thanks for using cnpx! \u2B50 Give a ${colorette.yellow("star")} on GitHub: https://github.com/xcfio/template`);}
+exports.main=B;

package/out/main.mjs

@@ -1,4 +1,4 @@
-import'./chunk-A7RKGLUR.mjs';import {intro,spinner,text,isCancel,cancel,confirm,select,note,outro}from'@clack/prompts';import {getPackageManager}from'./getPackageManager';import {blue,green,bold,yellow}from'colorette';import {checkForUpdate}from'./checkForUpdate';import {isInvalidPath}from'./isInvalidPath';import {getCategories}from'./getCategories';import {getTemplates}from'./getTemplates';import {clone}from'./clone';import {join}from'node:path';async function q(){intro(blue("Create a new project"));const c=spinner();c.start("Checking for updates"),await checkForUpdate(),c.clear();const t=await text({message:"Project Name",placeholder:"my-project",defaultValue:"my-project"});if(isCancel(t))return cancel("Operation cancelled"),process.exit(0);const s=isInvalidPath(join(process.cwd(),t));let m=false;if(s!==null)if(s){const e=await confirm({message:`Directory ${green(t)} already exists. Do you want to overwrite it?`});if(isCancel(e)||!e)return cancel("Operation cancelled"),process.exit(0);m=true;}else return cancel(`${green(t)} is a file. Please choose a different project name.`),process.exit(1);const d=await getCategories(),r=await select({message:"Select a category",options:d.map(e=>({name:e.name,value:e.name}))});if(isCancel(r))return cancel("Operation cancelled"),process.exit(0);const g=await getTemplates(r),n=await select({message:"Select a template",options:g.map(e=>({name:e.name,value:e.name}))});if(isCancel(n))return cancel("Operation cancelled"),process.exit(0);const l=await confirm({message:`Create project with name: ${bold(t)}, category: ${bold(r)}, template: ${bold(n)}?`});if(isCancel(l)||!l)return cancel("Operation cancelled"),process.exit(0);await clone(t,r,n,m),note(`cd ${t}
+import'./chunk-A7RKGLUR.mjs';import {intro,cancel,text,isCancel,confirm,select,note,outro}from'@clack/prompts';import {isValidDirectoryName}from'./isValidDirectoryName';import {getPackageManager}from'./getPackageManager';import {blue,green,bold,yellow}from'colorette';import {checkForUpdate}from'./checkForUpdate';import {isInvalidPath}from'./isInvalidPath';import {getCategories}from'./getCategories';import {getTemplates}from'./getTemplates';import {parseArgs}from'node:util';import {clone}from'./clone';import {join}from'node:path';async function B(){intro(blue("cnpx - Create a new project from a template"));const r=["",""],{values:t}=parseArgs({args:process.argv.slice(2),strict:false,options:{category:{type:"string",short:"c"},template:{type:"string",short:"t"},name:{type:"string",short:"n"},force:{type:"boolean",short:"f"},help:{type:"boolean",short:"h"}}});if(typeof t.name=="string"){const e=isValidDirectoryName(t.name);if(typeof e=="string")return cancel(e),process.exit(1)}if(typeof t.category=="string"&&(r[0]=t.category),typeof t.template=="string")if(t.template.includes("/")){const[e,n]=t.template.split("/");r[0]=e,r[1]=n;}else r[1]=t.template;await checkForUpdate();const o=typeof t.name=="string"?t.name:await text({message:"Project Name",placeholder:"my-project",defaultValue:"my-project",validate:e=>{if(!e)return;const n=isValidDirectoryName(e);if(typeof n=="string")return new Error(n)}});if(isCancel(o))return cancel("Operation cancelled"),process.exit(0);const p=isInvalidPath(join(process.cwd(),o));let l=typeof t.force=="boolean"?t.force:false;if(p!==null)if(p){if(t.force!==true){const e=await confirm({message:`Directory ${green(o)} already exists. Do you want to overwrite it?`});if(isCancel(e)||!e)return cancel("Operation cancelled"),process.exit(0)}l=true;}else return cancel(`${green(o)} is a file. Please choose a different project name.`),process.exit(1);const d=await getCategories(),s=r[0]||await select({message:"Select a category",options:d.map(e=>({name:e.name,value:e.name}))});if(isCancel(s))return cancel("Operation cancelled"),process.exit(0);r[0]=s;const w=await getTemplates(s),m=r[1]||await select({message:"Select a template",options:w.map(e=>({name:e.name,value:e.name}))});if(isCancel(m))return cancel("Operation cancelled"),process.exit(0);if(r[1]=m,t.force!==true){const e=await confirm({message:`Create project with name: ${bold(o)}, category: ${bold(r[0])}, template: ${bold(r[1])}?`});if(isCancel(e)||!e)return cancel("Operation cancelled"),process.exit(0)}await clone(o,`${r.join("/")}`,l),note(`cd ${o}
 ${getPackageManager()} install
-node --run dev`,"To get started, run:"),outro(`Thanks for using template! \u2B50 Give a ${yellow("star")} on GitHub: https://github.com/xcfio/template`);}
-export{q as main};
+node --run dev`,"To get started, run:"),outro(`Thanks for using cnpx! \u2B50 Give a ${yellow("star")} on GitHub: https://github.com/xcfio/template`);}
+export{B as main};

package/out/showHelp.d.mts

@@ -0,0 +1,3 @@
+declare function showHelp(): never;
+
+export { showHelp };

package/out/showHelp.d.ts

@@ -0,0 +1,3 @@
+declare function showHelp(): never;
+
+export { showHelp };

package/out/showHelp.js

@@ -0,0 +1,10 @@
+'use strict';var colorette=require('colorette');function p(){console.log(`
+  ${colorette.blue(colorette.bold("cnpx"))} - Create a new project from a template
+
+  ${colorette.bold("Options:")}
+    ${colorette.green("-n, --name")}      ${colorette.dim("Project name")}
+    ${colorette.green("-c, --category")}  ${colorette.dim("Template category")}
+    ${colorette.green("-t, --template")}  ${colorette.dim("Template name")}
+    ${colorette.green("-f, --force")}     ${colorette.dim("Overwrite existing directory")}
+    ${colorette.green("-h, --help")}      ${colorette.dim("Show help")}
+`),process.exit(0);}exports.showHelp=p;

package/out/showHelp.mjs

@@ -0,0 +1,10 @@
+import'./chunk-A7RKGLUR.mjs';import {blue,bold,green,dim}from'colorette';function p(){console.log(`
+  ${blue(bold("cnpx"))} - Create a new project from a template
+
+  ${bold("Options:")}
+    ${green("-n, --name")}      ${dim("Project name")}
+    ${green("-c, --category")}  ${dim("Template category")}
+    ${green("-t, --template")}  ${dim("Template name")}
+    ${green("-f, --force")}     ${dim("Overwrite existing directory")}
+    ${green("-h, --help")}      ${dim("Show help")}
+`),process.exit(0);}export{p as showHelp};

package/out/type.d.mts

@@ -1,3 +1,9 @@
+type ParsedSemver = {
+    major: number;
+    minor: number;
+    patch: number;
+    pre: string[];
+};
 type FilteredGithubResponse = Array<{
     name: string;
     url: string;
@@ -21,4 +27,4 @@ type GithubAPIResponse = {
     };
 }>;
 
-export type { FilteredGithubResponse, GithubAPIResponse };
+export type { FilteredGithubResponse, GithubAPIResponse, ParsedSemver };

package/out/type.d.ts

@@ -1,3 +1,9 @@
+type ParsedSemver = {
+    major: number;
+    minor: number;
+    patch: number;
+    pre: string[];
+};
 type FilteredGithubResponse = Array<{
     name: string;
     url: string;
@@ -21,4 +27,4 @@ type GithubAPIResponse = {
     };
 }>;
 
-export type { FilteredGithubResponse, GithubAPIResponse };
+export type { FilteredGithubResponse, GithubAPIResponse, ParsedSemver };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cnpx/cnpx",
-  "version": "0.0.4-dev.20260403235918",
-  "description": "A simple CLI to scaffold projects from remote templates",
+  "version": "0.0.4-dev.20260404115856",
+  "description": "An interactive CLI tool for creating new projects from curated templates hosted on GitHub. Pick a category, pick a template, and get coding.",
   "author": "xcfio",
   "homepage": "https://github.com/xcfio/template/tree/main/cnpx/cnpx#readme",
   "type": "commonjs",
@@ -29,14 +29,13 @@
     "url": "https://github.com/xcfio/template/issues",
     "email": "omarfaruksxp@gmail.com"
   },
-  "funding": {
-    "type": "patreon",
-    "url": "https://www.patreon.com/xcfio"
-  },
   "publishConfig": {
     "access": "public",
     "tag": "latest"
   },
+  "engines": {
+    "node": ">=22.5"
+  },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
     "colorette": "^2.0.20",
@@ -48,10 +47,10 @@
     "tsup": "^8.5.1"
   },
   "scripts": {
-    "fmt": "prettier --config=.prettierrc --write src",
     "lint": "prettier --config=.prettierrc --check src",
-    "build": "tsup",
+    "fmt": "prettier --config=.prettierrc --write src",
+    "test": "tsc --noEmit",
     "dev": "tsup --watch",
-    "test": "tsc --noEmit"
+    "build": "tsup"
   }
 }