@uxf/scripts 11.109.1 → 11.109.2

package/README.md

@@ -101,6 +101,21 @@ npx uxf-dependencies-check --dry-run
 npx uxf-dependencies-check --exclude lodash dayjs
 ```
 
+### Ignoring known conflicts
+
+Some version conflicts are caused by third-party packages and cannot be resolved (e.g. `@udecode/plate-floating` pulling an old `@floating-ui/react`). Each `@uxf/*` package can declare known conflicts in its own `package.json`:
+
+```json
+{
+  "name": "@uxf/wysiwyg",
+  "uxf": {
+    "ignoredConflicts": ["@floating-ui/react"]
+  }
+}
+```
+
+Ignored conflicts are still printed as informational output but do **not** cause a non-zero exit code. The `--exclude` CLI flag hides packages completely (not printed at all).
+
 ### What it checks
 
 - Parses the lock file (yarn.lock / package-lock.json / pnpm-lock.yaml / bun.lock) to detect version conflicts

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uxf/scripts",
-    "version": "11.109.1",
+    "version": "11.109.2",
     "description": "",
     "main": "index.js",
     "bin": {

package/src/uxf-dependencies-check/conflict-check.d.ts

@@ -1,7 +1,15 @@
 import type { Conflict, LockData } from "./types";
+export interface UxfDepsInfo {
+    depNames: Set<string>;
+    ignoredConflicts: Set<string>;
+}
 /**
- * Collect the set of package names that are direct dependencies of any installed @uxf/* package.
- * Only these are relevant for version conflict detection.
+ * Collect the set of package names that are direct dependencies of any installed @uxf/* package,
+ * and the set of ignored conflicts declared via `uxf.ignoredConflicts` in each package's package.json.
  */
-export declare function collectUxfDependencyNames(uxfPackages: string[], nodeModulesPath: string): Set<string>;
-export declare function checkMultipleVersions(lockData: LockData, relevantPackages: Set<string>, excludedPackages?: Set<string>): Conflict[];
+export declare function collectUxfDepsInfo(uxfPackages: string[], nodeModulesPath: string): UxfDepsInfo;
+export interface ConflictCheckResult {
+    conflicts: Conflict[];
+    ignoredConflicts: Conflict[];
+}
+export declare function checkMultipleVersions(lockData: LockData, relevantPackages: Set<string>, excludedPackages?: Set<string>, ignoredPackages?: Set<string>): ConflictCheckResult;

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

@@ -3,19 +3,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.collectUxfDependencyNames = collectUxfDependencyNames;
+exports.collectUxfDepsInfo = collectUxfDepsInfo;
 exports.checkMultipleVersions = checkMultipleVersions;
 const path_1 = __importDefault(require("path"));
 const types_1 = require("./types");
 /** Build-time / CLI-only dependencies that cannot cause runtime conflicts */
 const IGNORED_PACKAGES = new Set(["yargs", "fast-glob"]);
 /**
- * Collect the set of package names that are direct dependencies of any installed @uxf/* package.
- * Only these are relevant for version conflict detection.
+ * Collect the set of package names that are direct dependencies of any installed @uxf/* package,
+ * and the set of ignored conflicts declared via `uxf.ignoredConflicts` in each package's package.json.
  */
-function collectUxfDependencyNames(uxfPackages, nodeModulesPath) {
-    var _a, _b;
+function collectUxfDepsInfo(uxfPackages, nodeModulesPath) {
+    var _a, _b, _c;
     const depNames = new Set();
+    const ignoredConflicts = new Set();
     for (const uxfPkg of uxfPackages) {
         const pkgJsonPath = path_1.default.join(nodeModulesPath, uxfPkg, "package.json");
         const pkgJson = (0, types_1.readPackageJson)(pkgJsonPath);
@@ -28,20 +29,33 @@ function collectUxfDependencyNames(uxfPackages, nodeModulesPath) {
         for (const name of Object.keys((_b = pkgJson.peerDependencies) !== null && _b !== void 0 ? _b : {})) {
             depNames.add(name);
         }
+        const pkgIgnored = (_c = pkgJson.uxf) === null || _c === void 0 ? void 0 : _c.ignoredConflicts;
+        if (Array.isArray(pkgIgnored)) {
+            for (const name of pkgIgnored) {
+                ignoredConflicts.add(name);
+            }
+        }
     }
-    return depNames;
+    return { depNames, ignoredConflicts };
 }
-function checkMultipleVersions(lockData, relevantPackages, excludedPackages = new Set()) {
+function checkMultipleVersions(lockData, relevantPackages, excludedPackages = new Set(), ignoredPackages = new Set()) {
     const allExcluded = new Set([...IGNORED_PACKAGES, ...excludedPackages]);
     const conflicts = [];
+    const ignoredConflicts = [];
     for (const name of relevantPackages) {
         if (allExcluded.has(name)) {
             continue;
         }
         const versions = lockData.get(name);
         if (versions && versions.size > 1) {
-            conflicts.push({ name, versions: Array.from(versions) });
+            const conflict = { name, versions: Array.from(versions) };
+            if (ignoredPackages.has(name)) {
+                ignoredConflicts.push(conflict);
+            }
+            else {
+                conflicts.push(conflict);
+            }
         }
     }
-    return conflicts;
+    return { conflicts, ignoredConflicts };
 }

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

@@ -43,8 +43,8 @@ async function checkUxfDependencies(options) {
     // Only check dependencies of @uxf/* packages, not the entire lock file
     try {
         const lockData = await (0, lock_parsers_1.parseLockFile)(pm, cwd);
-        const relevantDeps = (0, conflict_check_1.collectUxfDependencyNames)(uxfPackages, nodeModulesPath);
-        const conflicts = (0, conflict_check_1.checkMultipleVersions)(lockData, relevantDeps, new Set(options.exclude));
+        const { depNames, ignoredConflicts: packageIgnored } = (0, conflict_check_1.collectUxfDepsInfo)(uxfPackages, nodeModulesPath);
+        const { conflicts, ignoredConflicts } = (0, conflict_check_1.checkMultipleVersions)(lockData, depNames, new Set(options.exclude), packageIgnored);
         if (conflicts.length > 0) {
             console.log("Dependency version conflicts in @uxf/* packages:"); // eslint-disable-line no-console
             for (const { name, versions } of conflicts) {
@@ -53,7 +53,14 @@ async function checkUxfDependencies(options) {
             console.log(); // eslint-disable-line no-console
             hasIssues = true;
         }
-        else {
+        if (ignoredConflicts.length > 0) {
+            console.log("Ignored conflicts (configured in package.json):"); // eslint-disable-line no-console
+            for (const { name, versions } of ignoredConflicts) {
+                console.log(`  ${name}: ${versions.join(", ")}`); // eslint-disable-line no-console
+            }
+            console.log(); // eslint-disable-line no-console
+        }
+        if (conflicts.length === 0 && ignoredConflicts.length === 0) {
             console.log("No dependency version conflicts found.\n"); // eslint-disable-line no-console
         }
     }

package/src/uxf-dependencies-check/types.d.ts

@@ -3,6 +3,9 @@ export interface PackageJson {
     dependencies?: Partial<Record<string, string>>;
     devDependencies?: Partial<Record<string, string>>;
     peerDependencies?: Partial<Record<string, string>>;
+    uxf?: {
+        ignoredConflicts?: string[];
+    };
 }
 export interface DepInfo {
     isDev: boolean;