@uxf/scripts 11.107.0 → 11.109.0

package/README.md

@@ -63,6 +63,56 @@ notify-push:
         - uxf-push-notifier --google-chat-webhook-url=$GOOGLE_CHAT_WEBHOOK
 ```
 
+## uxf-dependencies-check
+
+All-in-one dependency health check for projects using `@uxf/*` packages. Runs two checks:
+
+1. **Version conflict detection** — parses the lock file and reports dependencies of `@uxf/*` packages that resolve to multiple versions
+2. **Peer dependency check** — verifies that all `peerDependencies` of installed `@uxf/*` packages are present and version-matched
+
+Supports **yarn**, **npm**, **pnpm**, and **bun**. The package manager is auto-detected from the lock file.
+
+Requires `tsx` or another tool to execute typescript (typically already available in your project's `devDependencies`).
+
+```bash
+Usage:
+  uxf-dependencies-check [options]
+
+Options:
+  --fix           Auto-install missing/mismatched peer dependencies
+  --dry-run       Show what would be installed without changes
+  -e, --exclude   Packages to ignore in conflict check              [array]
+  -h, --help      Show help                                        [boolean]
+```
+
+Build-time dependencies (`yargs`, `fast-glob`) are automatically ignored in the conflict check.
+
+### Examples
+
+```bash
+# Run both checks (exits with code 1 if issues found)
+npx tsx -dependencies-check
+
+# Auto-install missing peer deps
+npx tsx uxf-dependencies-check --fix
+
+# Preview what would be installed
+npx tsx uxf-dependencies-check --dry-run
+
+# Ignore specific packages in conflict check
+npx tsx uxf-dependencies-check --exclude lodash dayjs
+```
+
+### What it checks
+
+- Parses the lock file (yarn.lock / package-lock.json / pnpm-lock.yaml / bun.lock) to detect version conflicts
+- Scans all `@uxf/*` packages in your `dependencies` / `devDependencies`
+- Reads each package's `peerDependencies` from `node_modules`
+- Skips `@uxf/*`, `react`, `react-dom`, and `next` (you manage these yourself)
+- Reports missing dependencies and version mismatches
+- Distinguishes between prod and dev dependencies — peer deps required only by `devDependencies` are installed with `-D`
+- With `--fix`, auto-installs missing peer deps using the detected package manager
+
 ## uxf-lunch
 
 ```bash

package/bin/uxf-dependencies-check.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env tsx
+import cli from "../src/uxf-dependencies-check/cli";
+
+cli()
+    .then((exitCode) => {
+        process.exitCode = exitCode;
+    })
+    .catch((e) => {
+        console.error(e); // eslint-disable-line no-console
+        process.exitCode = 1;
+    });

package/package.json

@@ -1,25 +1,25 @@
 {
     "name": "@uxf/scripts",
-    "version": "11.107.0",
+    "version": "11.109.0",
     "description": "",
     "main": "index.js",
     "bin": {
         "uxf-audit": "bin/uxf-audit.js",
         "uxf-claude-sync": "bin/uxf-claude-sync.js",
+        "uxf-dependencies-check": "bin/uxf-dependencies-check.ts",
+        "uxf-i18n-namespaces-gen": "bin/uxf-i18n-namespaces-gen.js",
         "uxf-lunch": "bin/uxf-lunch.js",
-        "uxf-dependencies-check": "bin/uxf-dependencies-check.js",
         "uxf-push-notifier": "bin/uxf-push-notifier.js",
         "uxf-release": "bin/uxf-release.js",
         "uxf-sitemap-check": "bin/uxf-sitemap-check.js",
         "uxf-sitemap-meta-export": "bin/uxf-sitemap-meta-export.js",
-        "uxf-i18n-namespaces-gen": "bin/uxf-i18n-namespaces-gen.js",
         "uxf-unused": "bin/uxf-unused.js"
     },
     "scripts": {
         "build": "",
-        "typecheck": "",
+        "run:mr-notifier": "GOOGLE_WEBHOOK_URL=<<TODO>> GITLAB_TOKEN=<<TODO>> CI_SERVER_URL=https://gitlab.uxf.cz node ./bin/uxf-merge-requests-notifier.js",
         "test": "./node_modules/.bin/eslint ./bin",
-        "run:mr-notifier": "GOOGLE_WEBHOOK_URL=<<TODO>> GITLAB_TOKEN=<<TODO>> CI_SERVER_URL=https://gitlab.uxf.cz node ./bin/uxf-merge-requests-notifier.js"
+        "typecheck": "tsc --noEmit -p tsconfig.json"
     },
     "publishConfig": {
         "access": "public"
@@ -33,9 +33,9 @@
         "node": ">=24"
     },
     "dependencies": {
-        "axios": "1.13.4",
+        "axios": "^1.13.4",
         "cheerio": "1.2.0",
-        "dayjs": "1.11.19",
+        "dayjs": "^1.11.19",
         "fast-glob": "3.3.3",
         "got": "14.6.6",
         "madge": "8.0.0",
@@ -47,7 +47,7 @@
         "@types/node": "24",
         "@types/react": "18.3.27",
         "@types/react-dom": "18.3.7",
-        "@uxf/core": "11.107.0",
-        "@uxf/ui": "11.107.0"
+        "@uxf/core": "11.108.0",
+        "@uxf/ui": "11.108.0"
     }
 }

package/bin/uxf-dependencies-check.js

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-require("../src/uxf-dependencies-check/cli")()
-    .then((exitCode) => {
-        process.exitCode = exitCode;
-    })
-    .catch(() => {
-        process.exitCode = 1;
-    });

package/src/uxf-dependencies-check/cli.js

@@ -1,32 +0,0 @@
-const { checkUxfDependencies } = require("./index");
-const { argv } = require("process");
-
-module.exports = async () => {
-    const cli = require("yargs")()
-        .command("$0", "UXF Dependencies Check", (yargs) => {
-            yargs.demandCommand(0, 0).usage(`
-            Usage:
-  uxf-dependencies-check [options]`);
-        })
-        .option("e", {
-            alias: "exclude",
-            array: true,
-            default: [],
-            describe: "Seznam balíčků, které budou ignorovány",
-        })
-        .strict(false)
-        .exitProcess(false);
-
-    try {
-        const { help, exclude } = cli.parse(argv.slice(2));
-
-        if (Boolean(help)) {
-            return 0;
-        }
-
-        await checkUxfDependencies(new Set(exclude));
-    } catch (e) {
-        console.error(e);
-        return 1;
-    }
-};

package/src/uxf-dependencies-check/index.js

@@ -1,106 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-
-const yarnLockPath = path.resolve(process.cwd(), "yarn.lock");
-const packageJsonPath = path.resolve(process.cwd(), "package.json");
-
-async function parseLockFile() {
-    const YAML = await import("yaml");
-
-    const content = fs.readFileSync(yarnLockPath, "utf8");
-    return YAML.parse(content);
-}
-
-function parsePackageJson() {
-    const content = fs.readFileSync(packageJsonPath, "utf8");
-    return JSON.parse(content);
-}
-
-function extractPackageName(key) {
-    const match = key.match(/^(@[^/]+\/[^@]+|[^@]+)@/);
-    return match ? match[1] : null;
-}
-
-function findUxfPackagesInDependencies(lockData, packageJson) {
-    const declaredDependencies = new Set(Object.keys(packageJson.dependencies || {}));
-
-    const uxfPackages = [];
-
-    for (const key of Object.keys(lockData)) {
-        const name = extractPackageName(key);
-        if (name?.startsWith("@uxf/") && declaredDependencies.has(name)) {
-            uxfPackages.push(key);
-        }
-    }
-
-    return uxfPackages;
-}
-
-function collectDirectDependencies(packageKeys, lockData) {
-    const found = {};
-
-    for (const key of packageKeys) {
-        const entry = lockData[key];
-        if (!entry) continue;
-
-        const dependencies = entry.dependencies || {};
-
-        for (const depName in dependencies) {
-            const matchingKeys = Object.keys(lockData).filter((lockKey) => extractPackageName(lockKey) === depName);
-
-            for (const matchKey of matchingKeys) {
-                const depEntry = lockData[matchKey];
-                if (!depEntry || !depEntry.version) continue;
-
-                if (!found[depName]) {
-                    found[depName] = new Set();
-                }
-
-                found[depName].add(depEntry.version);
-            }
-        }
-    }
-
-    return found;
-}
-
-function checkMultipleVersions(dependencyMap, excludedPackages = new Set()) {
-    const conflicts = [];
-
-    for (const [name, versions] of Object.entries(dependencyMap)) {
-        if (excludedPackages.has(name)) continue;
-        if (versions.size > 1) {
-            conflicts.push({ name, versions: Array.from(versions) });
-        }
-    }
-
-    return conflicts;
-}
-
-async function checkUxfDependencies(excludedPackages = new Set()) {
-    const lockData = await parseLockFile();
-    const packageJson = parsePackageJson();
-
-    const uxfPackages = findUxfPackagesInDependencies(lockData, packageJson);
-    const dependencies = collectDirectDependencies(uxfPackages, lockData);
-
-    const conflicts = checkMultipleVersions(dependencies, excludedPackages);
-
-    if (conflicts.length > 0) {
-        console.log("Následující balíčky mají více verzí v závislostech UXF balíčků:");
-        for (const { name, versions } of conflicts) {
-            console.log(`- ${name}: ${versions.join(", ")}`);
-        }
-        process.exit(1);
-    } else {
-        console.log("Všechny závislosti UXF balíčků mají jednotnou verzi.");
-        process.exit(0);
-    }
-}
-
-module.exports = {
-    findUxfPackagesInDependencies,
-    collectDirectDependencies,
-    checkMultipleVersions,
-    checkUxfDependencies,
-};

package/src/uxf-dependencies-check/uxf-dependencies-check.test.js

@@ -1,111 +0,0 @@
-const { findUxfPackagesInDependencies, collectDirectDependencies, checkMultipleVersions } = require("./index"); // Adjust the path if needed
-
-describe("findUxfPackagesInDependencies", () => {
-    const lockData = {
-        "@uxf/button@^1.0.0": {},
-        "@uxf/form@^2.1.0": {},
-        "react@^17.0.0": {},
-        "lodash@^4.17.0": {},
-        "classnames@^2.3.1": {},
-    };
-
-    const packageJson = {
-        dependencies: {
-            "@uxf/button": "^1.0.0",
-            "@uxf/form": "^2.1.0",
-            react: "^17.0.0",
-        },
-    };
-
-    it("returns @uxf/* packages that are in package.json dependencies", () => {
-        const result = findUxfPackagesInDependencies(lockData, packageJson);
-        expect(result).toEqual(["@uxf/button@^1.0.0", "@uxf/form@^2.1.0"]);
-    });
-});
-
-describe("collectDirectDependencies", () => {
-    const lockData = {
-        "@uxf/button@^1.0.0": {
-            dependencies: {
-                react: "^17.0.0",
-                lodash: "^4.17.0",
-            },
-        },
-        "@uxf/form@^2.1.0": {
-            dependencies: {
-                react: "^17.0.1", // different version range
-                classnames: "^2.3.1",
-            },
-        },
-        "react@^17.0.0": {
-            version: "17.0.2",
-        },
-        "react@^17.0.1": {
-            version: "17.0.1",
-        },
-        "lodash@^4.17.0": {
-            version: "4.17.21",
-        },
-        "classnames@^2.3.1": {
-            version: "2.3.1",
-        },
-    };
-
-    const packageKeys = ["@uxf/button@^1.0.0", "@uxf/form@^2.1.0"];
-
-    it("collects direct dependencies of multiple UXF packages with shared and unique deps", () => {
-        const result = collectDirectDependencies(packageKeys, lockData);
-
-        expect(result).toEqual({
-            react: new Set(["17.0.2", "17.0.1"]),
-            lodash: new Set(["4.17.21"]),
-            classnames: new Set(["2.3.1"]),
-        });
-    });
-
-    it("handles empty dependencies gracefully", () => {
-        const lockData = {
-            "@uxf/empty@1.0.0": {},
-        };
-
-        const result = collectDirectDependencies(["@uxf/empty@1.0.0"], lockData);
-        expect(result).toEqual({});
-    });
-});
-
-describe("checkMultipleVersions", () => {
-    it("returns empty array when all packages have a single version", () => {
-        const deps = {
-            react: new Set(["17.0.2"]),
-            lodash: new Set(["4.17.21"]),
-        };
-        expect(checkMultipleVersions(deps)).toEqual([]);
-    });
-
-    it("returns conflicts when a package has multiple versions", () => {
-        const deps = {
-            react: new Set(["17.0.2", "18.0.0"]),
-            lodash: new Set(["4.17.21"]),
-        };
-        const conflicts = checkMultipleVersions(deps);
-        expect(conflicts).toHaveLength(1);
-        expect(conflicts[0].name).toBe("react");
-        expect(conflicts[0].versions).toEqual(expect.arrayContaining(["17.0.2", "18.0.0"]));
-    });
-
-    it("excludes packages that are in the excludedPackages set", () => {
-        const deps = {
-            react: new Set(["17.0.2", "18.0.0"]),
-        };
-        const result = checkMultipleVersions(deps, new Set(["react"]));
-        expect(result).toEqual([]);
-    });
-
-    it("returns multiple conflicts when several packages have version mismatches", () => {
-        const deps = {
-            react: new Set(["17.0.2", "18.0.0"]),
-            lodash: new Set(["4.17.0", "4.17.21"]),
-        };
-        expect(checkMultipleVersions(deps)).toHaveLength(2);
-    });
-});