@cmorales_/touch 1.0.0

package/README.md

@@ -0,0 +1,103 @@
+# @cmorales/touch
+
+Creating complex file structures has never been easier. `@cmorales/touch` is a powerful CLI tool that allows you to generate nested directories and files using a simple and intuitive syntax.
+
+## Installation
+
+You can use the package directly via `npx` or install it globally.
+
+### Using `npx` (Recommended)
+
+```bash
+npx @cmorales/touch <structure>
+```
+
+### Global Installation
+
+```bash
+npm install -g @cmorales/touch
+# or
+pnpm add -g @cmorales/touch
+# or
+bun add -g @cmorales/touch
+```
+
+## Usage
+
+The basic syntax is:
+
+```bash
+touch <input>
+```
+
+Where `<input>` describes the file and folder structure you want to create.
+
+### Key Features
+
+#### 1. Creating Directories
+To create a directory, simply append a `/` to the name.
+- `app/` -> Creates a folder named `app`.
+- `app/models/` -> Creates an `app` folder and a `models` folder inside it.
+
+#### 2. Grouping
+You can group multiple items at the same level using `{}`, `[]`, or `()`. All work identically and can be used interchangeably.
+
+- **Curly Braces:** `src/{components,utils}`
+- **Square Brackets:** `src/[components,utils]`
+- **Parentheses:** `src/(components,utils)`
+
+All the above commands create `src/components` and `src/utils`.
+
+#### 3. Nesting
+You can nest groups within groups to build complex trees.
+
+```bash
+src/{components/{Button,Input},utils}
+```
+Creates:
+- `src/components/Button`
+- `src/components/Input`
+- `src/utils`
+
+#### 4. Extensions
+You can specify extensions in two ways:
+
+- **Per File:** Directly in the name.
+  `src/{index.ts,styles.css}`
+
+- **Default Extension:** If you provide an extension at the end of a group, it will be applied to all files in that group that don't already have one.
+
+  `src/{components,utils}.ts`
+  Creates:
+  - `src/components.ts`
+  - `src/utils.ts`
+
+### Examples
+
+**React Component Structure:**
+```bash
+src/components/Button/{index.tsx,styles.module.css,types.ts}
+```
+
+**MVC Backend Structure:**
+```bash
+src/{controllers/,models/,routes/,services/}
+```
+
+**Complex Project Setup:**
+```bash
+my-app/{src/{components/,hooks/,utils/},public/,package.json,README.md}
+```
+
+## About the Author
+
+Created by **Cristian Morales**.
+
+- **GitHub:** [Cristian-F-M](https://github.com/Cristian-F-M)
+- **Twitter:** [@Morales_M20](https://x.com/Morales_M20)
+
+## Support
+
+If you find this tool useful, you can support my work!
+
+<a href="https://www.buymeacoffee.com/cmorales" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+declare const NodeTypes: {
+    readonly DIR: "dir";
+    readonly FILE: "file";
+};
+
+type NodeType = typeof NodeTypes
+
+type Node =
+	| { type: NodeType['DIR']; name: string; children: Node[] }
+	| { type: NodeType['FILE']; name: string }
+
+declare function build(tree: Node, base: string, defaultExt?: string): void;
+
+declare function parse(input: string): Node;
+declare function getExtension(input: string): string;
+
+export { build, getExtension, parse };

package/dist/index.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+// src/builder.ts
+import fs from "fs";
+import path from "path";
+
+// src/logger.ts
+import pc from "picocolors";
+var log = (msg) => console.log(pc.green(msg));
+var warn = (msg) => console.log(pc.yellow(msg));
+var success = (msg) => console.log(pc.bold(pc.cyan(msg)));
+
+// src/builder.ts
+function build(tree, base, defaultExt = "") {
+  let files = 0;
+  let dirs = 0;
+  function walk(node, current) {
+    if (node.type === "dir") {
+      const dirPath = path.join(current, node.name);
+      if (fs.existsSync(dirPath)) warn(`exists: ${dirPath}`);
+      if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+        log(`created: ${dirPath}`);
+        dirs++;
+      }
+      node.children?.forEach((c) => walk(c, dirPath));
+      return;
+    }
+    let file = node.name;
+    if (!fs.existsSync(file) && defaultExt && path.extname(file).length <= 1)
+      file += defaultExt;
+    const filePath = path.join(current, file);
+    if (fs.existsSync(filePath)) return warn(`exists: ${filePath}`);
+    fs.writeFileSync(filePath, "");
+    log(`created: ${filePath}`);
+    files++;
+  }
+  walk(tree, base);
+  success(`
+\u2714 Created ${files} files and ${dirs} folders
+`);
+}
+
+// src/constants/symbols.ts
+var OPEN_SYMBOLS = {
+  "{": "{",
+  "(": "(",
+  "[": "["
+};
+var CLOSE_SYMBOLS = {
+  "}": "}",
+  ")": ")",
+  "]": "]"
+};
+var SEPARATOR_SYMBOLS = { ",": "," };
+var FOLDER_INDICATOR_SYMBOLS = { "/": "/", "\\": "\\" };
+var OPEN_CLOSE_PAIRS = {
+  "(": ")",
+  "{": "}",
+  "[": "]"
+};
+
+// src/parser.ts
+function parse(input) {
+  let i = 0;
+  function walk() {
+    let name = "";
+    let char = input[i];
+    while (i < input.length && !Object.hasOwn(
+      Object.assign(
+        {},
+        OPEN_SYMBOLS,
+        CLOSE_SYMBOLS,
+        SEPARATOR_SYMBOLS,
+        FOLDER_INDICATOR_SYMBOLS
+      ),
+      char
+    )) {
+      name += char;
+      char = input[++i];
+    }
+    name = name.trim();
+    if (Object.hasOwn(FOLDER_INDICATOR_SYMBOLS, char ?? "")) {
+      i++;
+      char = input[i];
+      if (!Object.hasOwn(OPEN_SYMBOLS, char ?? "")) {
+        const children = [];
+        if (i < input.length && !Object.hasOwn(SEPARATOR_SYMBOLS, input[i]) && !Object.hasOwn(CLOSE_SYMBOLS, input[i]))
+          children.push(walk());
+        return { type: "dir", name, children };
+      }
+    }
+    if (Object.hasOwn(OPEN_SYMBOLS, char ?? "")) {
+      const opener = input[i++];
+      const closer = OPEN_CLOSE_PAIRS[OPEN_SYMBOLS[opener]];
+      const children = [];
+      char = input[i];
+      while (i < input.length && char !== closer) {
+        children.push(walk());
+        if (input[i] === ",") i++;
+        char = input[i];
+      }
+      i++;
+      return { type: "dir", name, children };
+    }
+    return { type: "file", name };
+  }
+  return walk();
+}
+function getExtension(input) {
+  let s = [];
+  let i = 0;
+  const closes = Object.values(CLOSE_SYMBOLS);
+  while (s.length <= 1 && i < closes.length) {
+    s = input.split(closes[i]);
+    i++;
+  }
+  const ext = s.at(-1);
+  return ext ? `${ext}` : "";
+}
+export {
+  build,
+  getExtension,
+  parse
+};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "version": "1.0.0",
+  "name": "@cmorales_/touch",
+  "module": "/dist/index.js",
+  "type": "module",
+  "private": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest"
+  },
+  "bin": {
+    "touch": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.13",
+    "@types/bun": "latest",
+    "tsup": "^8.5.1",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "picocolors": "^1.1.1"
+  }
+}