phpxui 0.0.3 → 0.0.5

package/README.md

@@ -1,4 +1,4 @@
-# **phpxui-cli** — Instant PHPXUI Component Generator 🚀
+# **phpxui‑cli** — Instant PHPXUI Component Generator 🚀
 
 > **Generate fully‑typed PHPXUI components for Prisma PHP right from the terminal.**
 > ⚡ **Single component** → `npx phpxui add Alert`   |   🌌 **Whole library** → `npx phpxui add --all`
@@ -7,13 +7,13 @@
 
 ## ✨ Features
 
-| Feature               | Details                                                                                                  |
-| --------------------- | -------------------------------------------------------------------------------------------------------- |
-| **Bulk install**      | `--all` downloads every component in a single compressed request.                                        |
-| **Ready‑to‑use code** | Each file already contains the `$class` merge logic and `{$attributes}` placeholder for Wave reactivity. |
-| **Clean paths**       | Files are written under `src/Lib/PHPXUI/FancyName.php` with OS‑agnostic separators.                      |
-| **Friendly output**   | Clear green / red summary with relative paths only.                                                      |
-| **Cross‑platform**    | Works equally on Windows, macOS and Linux.                                                               |
+| Feature               | Details                                                                                                      |
+| --------------------- | ------------------------------------------------------------------------------------------------------------ |
+| **Bulk install**      | `--all` downloads every component in one shot.                                                               |
+| **Ready‑to‑use code** | Each file already contains the `$class` merge logic and `{$attributes}` placeholder for **Wave** reactivity. |
+| **Clean paths**       | Files are written under `src/Lib/PHPXUI/FancyName.php` with OS‑agnostic separators.                          |
+| **Friendly output**   | Clear green / red summary with relative paths only.                                                          |
+| **Automatic icons**   | Core **PPIcons** (`x`, `chevron‑down`, `chevron‑right`) are installed on the very first run.                 |
 
 ---
 
@@ -47,6 +47,10 @@ npx phpxui add --all
 CLI output example:
 
 ```bash
+📦 Installing ppicons CLI…
+✨ Installing default icons: x chevron-down chevron-right
+✔ Icons installed in src/Lib/PPIcons
+
 ✔ Alert   → src/Lib/PHPXUI/Alert.php
 ✔ Dialog  → src/Lib/PHPXUI/Dialog.php
 ✔ Badge   → src/Lib/PHPXUI/Badge.php
@@ -84,9 +88,23 @@ class Alert extends PHPX
 | --------------- | -------------------------------------------------------- |
 | `<component …>` | One or more component names separated by space or comma. |
 | `--all`         | Download the full catalogue in one request.              |
-| `--out <dir>`   | Destination folder (default `src/Lib/PHPXUI`).           |
 | `--force`       | Overwrite existing files.                                |
 
+> **Note:** The CLI automatically installs a default set of core icons (such as `x`, `chevron-down`, `chevron-right`) on first use. Extra icons are not yet selectable via `phpxui` directly.
+
+---
+
+## 🎨 Using Additional Icons
+
+Need more icons? Use the **PPIcons** CLI directly:
+
+```bash
+npx ppicons add menu chevron-left arrow-right
+```
+
+This will place the requested icons under `src/Lib/PPIcons` with full PHPXUI typings.
+Browse the complete icon catalogue and usage docs at **[https://ppicons.tsnc.tech/](https://ppicons.tsnc.tech/)**.
+
 ---
 
 ## 📚 Documentation
@@ -97,19 +115,19 @@ Full guides and examples live at the [PHPXUI documentation site](https://phpxui.
 
 ## 💡 Contributing
 
-We welcome contributions to improve **phpxui-cli**. If you have ideas, found bugs, or want to add features, open an issue or submit a pull request.
+We welcome contributions to improve **phpxui‑cli**. If you have ideas, find bugs, or want to add features, open an issue or submit a pull request.
 
 ---
 
 ## 📄 License
 
-`phpxui-cli` is released under the MIT License. See `LICENSE` for details.
+`phpxui‑cli` is released under the MIT License. See `LICENSE` for details.
 
 ---
 
 ## 👤 Author
 
-This project is developed and maintained by [The Steel Ninja Code](https://thesteelninjacode.com/), continuously pushing the boundaries of PHP development.
+This project is developed and maintained by **The Steel Ninja Code**, continuously pushing the boundaries of PHP development.
 
 ---
 

package/dist/commands/icons.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installIcons = installIcons;
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const load_config_1 = require("../utils/load-config");
+async function installIcons(iconList, config) {
+    try {
+        console.log(chalk_1.default.blue("📦 Installing ppicons CLI..."));
+        (0, child_process_1.execSync)("npm install -g ppicons", { stdio: "inherit" });
+        const args = iconList.join(" ");
+        console.log(chalk_1.default.blue(`✨ Installing default icons: ${args}`));
+        (0, child_process_1.execSync)(`npx ppicons add ${args}`, { stdio: "inherit" });
+        console.log(chalk_1.default.green("✔ Icons installed in src/Lib/PPIcons"));
+        config.iconsInstalled = true;
+        (0, load_config_1.savePhpXUIConfig)(config); // ⬅️ persist change
+    }
+    catch (err) {
+        console.error(chalk_1.default.red("✖ Failed to install icons:"), err.message);
+        process.exit(1);
+    }
+}

package/dist/index.js

@@ -11,17 +11,16 @@ const php_component_1 = require("./generators/php-component");
 const php_components_bulk_1 = require("./generators/php-components-bulk");
 const ensure_package_1 = require("./generators/ensure-package");
 const copy_tailwind_1 = require("./generators/copy-tailwind");
+const load_config_1 = require("./utils/load-config");
+const icons_1 = require("./commands/icons");
 (async () => {
-    /* ─────────────────────────────────────────────
-     * 1.  Parse command & flags
-     * ──────────────────────────────────────────── */
     const args = process.argv.slice(2);
     const [command, ...rest] = args;
     if (command !== "add") {
-        console.log(chalk_1.default.blue("Usage: phpxui add [--all] [--out <dir>] [--force] <component…>"));
+        console.log(chalk_1.default.blue("Usage: phpxui add [--all] [--force] <component…>"));
         process.exit(0);
     }
-    const flags = { all: false, force: false, out: null };
+    const flags = { all: false, force: false };
     const names = [];
     for (let i = 0; i < rest.length; i++) {
         const tok = rest[i];
@@ -32,36 +31,55 @@ const copy_tailwind_1 = require("./generators/copy-tailwind");
             case "--force":
                 flags.force = true;
                 break;
-            case "--out":
-                flags.out = rest[++i] || null;
-                break;
             default:
                 names.push(tok);
         }
     }
-    /* ─────────────────────────────────────────────
-     * 2.  Housekeeping steps (always run)
-     * ──────────────────────────────────────────── */
-    // 2.a Ensure tw-animate-css is installed
+    /* 2) Load config + detect first run */
+    const { config, isFirstRun } = (0, load_config_1.loadPhpXUIConfig)();
+    if (!config.iconsInstalled) {
+        await (0, icons_1.installIcons)([
+            "chevron-down",
+            "x",
+            "chevron-right",
+            "ellipsis",
+            "chevron-left",
+            "arrow-left",
+            "arrow-right",
+            "check",
+            "chevrons-up-down",
+            "search",
+            "circle",
+            "calendar",
+            "minus",
+            "chevron-up",
+            "panel-left",
+        ], config);
+    }
+    /* 3) Housekeeping */
     (0, ensure_package_1.ensurePackageInstalled)("tw-animate-css");
-    // 2.b Keep Tailwind theme up‑to‑date in the project
-    const cssUpdated = (0, copy_tailwind_1.copyTailwindCss)(flags.force);
+    // ⬇️ IMPORTANT:
+    // Tailwind base CSS should only be *forced* on *first run*.
+    // Later runs: copy only if missing (no overwrite), even if --force.
+    const cssUpdated = (0, copy_tailwind_1.copyTailwindCss)(isFirstRun /* ignore flags.force here */);
     if (cssUpdated) {
         const relCss = path_1.default
             .relative(process.cwd(), "src/app/css/tailwind.css")
             .replace(/\\/g, "/");
-        console.log(chalk_1.default.green(`✔ Updated Tailwind CSS → ${relCss}`));
+        console.log(chalk_1.default.green(isFirstRun
+            ? `✔ Installed base Tailwind CSS → ${relCss}`
+            : `✔ Added Tailwind CSS (missing) → ${relCss}`));
     }
-    /* ─────────────────────────────────────────────
-     * 3.  Destination directory for components
-     * ──────────────────────────────────────────── */
-    const targetDir = path_1.default.resolve(flags.out ?? "src/Lib/PHPXUI");
+    /* 4) Resolve output directory */
+    const targetDir = path_1.default.resolve(config.outputDir || "src/Lib/PHPXUI");
     try {
-        /* ─────────────────────────────────────────
-         * 4.  Bulk mode  (--all)
-         * ───────────────────────────────────────── */
+        // ⬇️ Components overwrite policy:
+        // - First run: force overwrite (replace everything)
+        // - Otherwise: only overwrite when --force is passed
+        const componentForce = isFirstRun || flags.force;
+        /* 5) Bulk mode */
         if (flags.all) {
-            const { ok, fail } = await (0, php_components_bulk_1.generateAllComponents)(targetDir, flags.force);
+            const { ok, fail } = await (0, php_components_bulk_1.generateAllComponents)(targetDir, componentForce);
             console.log(chalk_1.default.green(`\n✔ Generated ${ok.length} components in ${path_1.default.relative(process.cwd(), targetDir)}`));
             if (fail.length) {
                 console.log(chalk_1.default.red(`✖ ${fail.length} failures:`));
@@ -69,23 +87,26 @@ const copy_tailwind_1 = require("./generators/copy-tailwind");
             }
             process.exit(fail.length ? 1 : 0);
         }
-        /* ─────────────────────────────────────────
-         * 5.  Interactive prompt if no names given
-         * ───────────────────────────────────────── */
+        /* 6) Interactive prompt if no names given */
         if (names.length === 0) {
             const { componentList } = await (0, prompts_1.default)({
                 type: "text",
                 name: "componentList",
-                message: "Which components do you want to add? (space‑ or comma‑separated)",
+                message: "Which components do you want to add? (space- or comma-separated)",
                 validate: (v) => (v.trim() ? true : "Enter at least one name"),
             });
             names.push(...componentList.split(/[\s,]+/));
         }
-        /* ─────────────────────────────────────────
-         * 6.  Generate each requested component
-         * ───────────────────────────────────────── */
+        /* 6.5) First-run: ensure core 'Slot' is installed (unless --all) */
+        if (isFirstRun && !flags.all) {
+            const hasSlot = names.some((n) => n.toLowerCase() === "slot");
+            if (!hasSlot) {
+                names.unshift("Slot"); // put it first so it logs clearly
+            }
+        }
+        /* 7) Generate each requested component */
         for (const name of names) {
-            const saved = await (0, php_component_1.generateComponent)(name, targetDir, flags.force);
+            const saved = await (0, php_component_1.generateComponent)(name, targetDir, componentForce);
             const paths = Array.isArray(saved) ? saved : [saved];
             for (const abs of paths) {
                 const rel = path_1.default.relative(process.cwd(), abs).replace(/\\/g, "/");

package/dist/utils/load-config.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPhpXUIConfig = loadPhpXUIConfig;
+exports.savePhpXUIConfig = savePhpXUIConfig;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const defaultConfig = {
+    style: "new-york",
+    force: false,
+    outputDir: "src/Lib/PHPXUI",
+    iconsInstalled: false,
+    tailwind: {
+        css: "src/app/css/tailwind.css",
+        baseColor: "neutral",
+        cssVariables: true,
+        prefix: "",
+    },
+    psr4: {
+        Components: "src/Lib/PHPXUI/",
+        Icons: "src/Lib/PPIcons/",
+    },
+    iconLibrary: "ppicons",
+};
+// ⬇️ CHANGED: return { config, isFirstRun }
+function loadPhpXUIConfig() {
+    const configPath = path_1.default.resolve("phpxui.json");
+    const existed = fs_1.default.existsSync(configPath);
+    if (!existed) {
+        fs_1.default.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
+        console.log("📦 Created default phpxui.json");
+    }
+    const content = fs_1.default.readFileSync(configPath, "utf-8");
+    return { config: JSON.parse(content), isFirstRun: !existed };
+}
+function savePhpXUIConfig(config) {
+    const configPath = path_1.default.resolve("phpxui.json");
+    fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phpxui",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "A package for generating Prisma PHP components with a CLI interface.",
   "main": "index.js",
   "scripts": {