@trackunit/iris-app-build-utilities 2.4.12 → 2.4.13

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## 2.4.13 (2026-08-20)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 2.4.9
+- Updated shared-utils to 1.16.20
+
 ## 2.4.12 (2026-08-20)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app-build-utilities",
-  "version": "2.4.12",
+  "version": "2.4.13",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {
@@ -13,9 +13,9 @@
     "@nx/react": "23.1.0",
     "tslib": "^2.6.2",
     "csp-header": "^6.3.1",
-    "@trackunit/iris-app-api": "2.4.8",
+    "@trackunit/iris-app-api": "2.4.9",
     "@nx/devkit": "23.1.0",
-    "@trackunit/shared-utils": "1.16.19",
+    "@trackunit/shared-utils": "1.16.20",
     "http-proxy-middleware": "3.0.5",
     "marked": "14.1.2",
     "pacote": "^21.0.4",

package/src/checkContentInsetAdoption.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Duplicate of `CUTOFF_VERSION` from
+ * `libs/iris-app-runtime/core-host/src/contentInsetCutoff.ts`.
+ * Build utilities must not depend on core-host (wrong dependency direction);
+ * keep this string in sync with the host constant (GLU-1660).
+ */
+export declare const CUTOFF_VERSION = "2.5.12";
+/**
+ * Advisory warning when an app's resolved SDK version is at/above the content-inset
+ * cutoff but the app source has not adopted `p-content-space`. Matches the
+ * `versionCheck`/`console.warn` tone in `checkPackageVersion` — never throws.
+ *
+ * @param sdkVersion - Installed `@trackunit/iris-app` version (from `resolveSdkVersion`), if any
+ * @param appDir - Absolute path to the Iris app project root
+ */
+export declare const checkContentInsetAdoption: (sdkVersion: string | undefined, appDir: string) => void;

package/src/checkContentInsetAdoption.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkContentInsetAdoption = exports.CUTOFF_VERSION = void 0;
+const semver_1 = require("semver");
+const checkContentSpaceAdoption_1 = require("./checkContentSpaceAdoption");
+/**
+ * Duplicate of `CUTOFF_VERSION` from
+ * `libs/iris-app-runtime/core-host/src/contentInsetCutoff.ts`.
+ * Build utilities must not depend on core-host (wrong dependency direction);
+ * keep this string in sync with the host constant (GLU-1660).
+ */
+exports.CUTOFF_VERSION = "2.5.12";
+/**
+ * Advisory warning when an app's resolved SDK version is at/above the content-inset
+ * cutoff but the app source has not adopted `p-content-space`. Matches the
+ * `versionCheck`/`console.warn` tone in `checkPackageVersion` — never throws.
+ *
+ * @param sdkVersion - Installed `@trackunit/iris-app` version (from `resolveSdkVersion`), if any
+ * @param appDir - Absolute path to the Iris app project root
+ */
+const checkContentInsetAdoption = (sdkVersion, appDir) => {
+    if (sdkVersion === undefined || (0, semver_1.valid)(sdkVersion) === null) {
+        return;
+    }
+    if (!(0, semver_1.gte)(sdkVersion, exports.CUTOFF_VERSION)) {
+        return;
+    }
+    if ((0, checkContentSpaceAdoption_1.checkContentSpaceAdoption)(appDir)) {
+        return;
+    }
+    // eslint-disable-next-line no-console
+    console.warn(`⚠️ Iris App SDK ${sdkVersion} is at/above the content-inset cutoff (${exports.CUTOFF_VERSION}) but this app's source does not reference \`p-content-space\`. 👈\n` +
+        ` Add \`p-content-space\` to own your content inset (or the host will apply none). See the Iris App migration guide for details.\n`);
+};
+exports.checkContentInsetAdoption = checkContentInsetAdoption;
+//# sourceMappingURL=checkContentInsetAdoption.js.map

package/src/checkContentSpaceAdoption.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Best-effort scan of an Iris app's source tree for `p-content-space` adoption.
+ * Mirrors the advisory, never-throws philosophy of `checkCustomFields`: an empty
+ * or unreadable directory is treated as "not adopted" so builds keep running.
+ *
+ * @param appDir - Absolute path to the Iris app project root
+ * @returns {boolean} true when any readable source file references `p-content-space`
+ */
+export declare const checkContentSpaceAdoption: (appDir: string) => boolean;

package/src/checkContentSpaceAdoption.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkContentSpaceAdoption = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const CONTENT_SPACE_TOKEN = "p-content-space";
+const SOURCE_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".jsx", ".css", ".html"]);
+const SKIP_DIR_NAMES = new Set(["node_modules", "dist", "coverage", ".git"]);
+/**
+ * Best-effort scan of an Iris app's source tree for `p-content-space` adoption.
+ * Mirrors the advisory, never-throws philosophy of `checkCustomFields`: an empty
+ * or unreadable directory is treated as "not adopted" so builds keep running.
+ *
+ * @param appDir - Absolute path to the Iris app project root
+ * @returns {boolean} true when any readable source file references `p-content-space`
+ */
+const checkContentSpaceAdoption = (appDir) => {
+    try {
+        return directoryContainsContentSpace(appDir);
+    }
+    catch {
+        return false;
+    }
+};
+exports.checkContentSpaceAdoption = checkContentSpaceAdoption;
+const directoryContainsContentSpace = (dir) => {
+    let entries;
+    try {
+        entries = (0, fs_1.readdirSync)(dir);
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries) {
+        if (SKIP_DIR_NAMES.has(entry)) {
+            continue;
+        }
+        const fullPath = (0, path_1.join)(dir, entry);
+        let stats;
+        try {
+            stats = (0, fs_1.statSync)(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (stats.isDirectory()) {
+            if (directoryContainsContentSpace(fullPath)) {
+                return true;
+            }
+            continue;
+        }
+        if (!stats.isFile() || !SOURCE_EXTENSIONS.has((0, path_1.extname)(entry))) {
+            continue;
+        }
+        try {
+            const contents = (0, fs_1.readFileSync)(fullPath, "utf-8");
+            if (contents.includes(CONTENT_SPACE_TOKEN)) {
+                return true;
+            }
+        }
+        catch {
+            // Unreadable file — skip and keep scanning.
+        }
+    }
+    return false;
+};
+//# sourceMappingURL=checkContentSpaceAdoption.js.map

package/src/index.d.ts

@@ -1,3 +1,5 @@
+export * from "./checkContentInsetAdoption";
+export * from "./checkContentSpaceAdoption";
 export * from "./checkPackageVersion";
 export * from "./createInvokeProxyMiddleware";
 export * from "./enableTsConfigPath";

package/src/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./checkContentInsetAdoption"), exports);
+tslib_1.__exportStar(require("./checkContentSpaceAdoption"), exports);
 tslib_1.__exportStar(require("./checkPackageVersion"), exports);
 tslib_1.__exportStar(require("./createInvokeProxyMiddleware"), exports);
 tslib_1.__exportStar(require("./enableTsConfigPath"), exports);