@portnet/ui 5.0.28 → 6.0.0

package/dist/v2/__tests__/banned-patterns.test.js

@@ -0,0 +1,272 @@
+"use strict";
+
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+var fs = _interopRequireWildcard(require("fs"));
+var path = _interopRequireWildcard(require("path"));
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator["return"] && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) { if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; } return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) { keys.push(key); } return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) { "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); } }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, "catch": function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
+var _marked = /*#__PURE__*/_regeneratorRuntime().mark(walk);
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; } /* eslint-env node */
+/**
+ * Static-analysis tests guarding against re-introduction of banned
+ * patterns in src/lib/v2/. Pure filesystem scan; no React, no jsdom.
+ *
+ * Each banned pattern has a unique regression history documented in
+ * the per-test comment so future readers know WHY the rule exists,
+ * not just what it forbids.
+ */
+
+var V2_ROOT = path.resolve(__dirname, "..");
+/**
+ * Recursively walk a directory, yielding paths of source files that
+ * are eligible for scanning. Excludes nested __tests__ folders so
+ * test fixtures referencing banned strings as test data don't trigger
+ * the rule. Scans .js/.jsx/.ts/.tsx/.css (ambient .d.ts excluded — no
+ * runtime style/breakpoint literals live there).
+ */
+function walk(dir) {
+  var _iterator, _step, entry, p;
+  return _regeneratorRuntime().wrap(function walk$(_context) {
+    while (1) {
+      switch (_context.prev = _context.next) {
+        case 0:
+          _iterator = _createForOfIteratorHelper(fs.readdirSync(dir, {
+            withFileTypes: true
+          }));
+          _context.prev = 1;
+          _iterator.s();
+        case 3:
+          if ((_step = _iterator.n()).done) {
+            _context.next = 17;
+            break;
+          }
+          entry = _step.value;
+          p = path.join(dir, entry.name);
+          if (!entry.isDirectory()) {
+            _context.next = 12;
+            break;
+          }
+          if (!(entry.name === "__tests__" || entry.name === "node_modules")) {
+            _context.next = 9;
+            break;
+          }
+          return _context.abrupt("continue", 15);
+        case 9:
+          return _context.delegateYield(walk(p), "t0", 10);
+        case 10:
+          _context.next = 15;
+          break;
+        case 12:
+          if (!(entry.isFile() && /\.(?:jsx?|tsx?|css)$/.test(entry.name) && !entry.name.endsWith(".d.ts"))) {
+            _context.next = 15;
+            break;
+          }
+          _context.next = 15;
+          return p;
+        case 15:
+          _context.next = 3;
+          break;
+        case 17:
+          _context.next = 22;
+          break;
+        case 19:
+          _context.prev = 19;
+          _context.t1 = _context["catch"](1);
+          _iterator.e(_context.t1);
+        case 22:
+          _context.prev = 22;
+          _iterator.f();
+          return _context.finish(22);
+        case 25:
+        case "end":
+          return _context.stop();
+      }
+    }
+  }, _marked, null, [[1, 19, 22, 25]]);
+}
+function readAllSourceFiles() {
+  var files = [];
+  var _iterator2 = _createForOfIteratorHelper(walk(V2_ROOT)),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var file = _step2.value;
+      files.push({
+        path: file,
+        content: fs.readFileSync(file, "utf8")
+      });
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  return files;
+}
+function findOffenders(files, predicate) {
+  return files.filter(function (f) {
+    return predicate(f.content);
+  }).map(function (f) {
+    return path.relative(V2_ROOT, f.path);
+  });
+}
+describe("Banned patterns in src/lib/v2/ (regression guard)", function () {
+  var files;
+  beforeAll(function () {
+    files = readAllSourceFiles();
+    // Sanity check — make sure the walker actually found source.
+    // A misconfigured path would silently make every test pass with
+    // an empty input set; this prevents that false-positive.
+    expect(files.length).toBeGreaterThan(20);
+  });
+
+  /**
+   * --fw-black ghost token
+   * History: Batch 1 removed fontWeight.black from the typography
+   * tokens; Batch 2 dropped the matching `--fw-black` line from the
+   * cssVariables emitter. Two regression sites detected later
+   * (KPICard in Batch 6, FormSection in Batch 7) — both silently
+   * lost their bold weight at runtime. The CSS variable was
+   * referenced but resolved to undefined.
+   *
+   * ⚠ THE SCAN IS RAW AND COMMENT-BLIND. DO NOT "FIX" THAT.
+   *
+   * `findOffenders` matches the banned literal anywhere in the file, including
+   * inside comments. That is deliberate: a guard that parses code can be fooled
+   * by anything its parser mishandles, whereas a text scan cannot. The cost is
+   * that DOCUMENTING the banned token — even to record its removal — trips the
+   * rule.
+   *
+   * That is exactly what happened during the procuration-portnet-fe audit: both
+   * `--fw-black` tests failed, and the "offenders" turned out to be explanatory
+   * comments in `KPICard.tsx` and `theme/cssVariables.ts` describing the very
+   * fix this rule enforces. The code was correct; both files already used
+   * `var(--fw-bold)`. The comments were reworded to refer to the token
+   * descriptively instead.
+   *
+   * So: if this fails, read the offending lines BEFORE assuming a regression.
+   * The correct remedy is to reword the prose, never to add comment-stripping
+   * here — that would weaken every rule in this file to fix a documentation
+   * nit.
+   *
+   * `__tests__` is excluded from `walk`, which is why this docstring may name
+   * the token freely.
+   */
+  test("no `--fw-black` references anywhere in src/lib/v2/", function () {
+    var offenders = findOffenders(files, function (c) {
+      return c.includes("--fw-black");
+    });
+    expect(offenders).toEqual([]);
+  });
+  test("no `var(--fw-black)` consumption (paranoid duplicate of the above)", function () {
+    var offenders = findOffenders(files, function (c) {
+      return c.includes("var(--fw-black)");
+    });
+    expect(offenders).toEqual([]);
+  });
+
+  /**
+   * fontWeight: 650
+   * History: Banned by Batch 1 typography refactor — 650 is a
+   * non-standard CSS weight not supported by non-variable fallback
+   * fonts. Re-introduced twice in Batch 6 (Stepper HStepper +
+   * FilterTab). Each time it took a careful read to spot, since
+   * 650 looks "close enough" to semibold (600).
+   */
+  test("no `fontWeight: 650` literal in component sx / inline style", function () {
+    // Match `fontWeight: 650` and `fontWeight:650` (with or without space).
+    // Word boundary on the right so we don't false-match 6500.
+    var re = /fontWeight\s*:\s*650\b/;
+    var offenders = findOffenders(files, function (c) {
+      return re.test(c);
+    });
+    expect(offenders).toEqual([]);
+  });
+
+  /**
+   * Plain CSS form `font-weight: 650`
+   * Same rationale as above but for the kebab-case form used inside
+   * .css files (base.css and friends).
+   */
+  test("no `font-weight: 650` in CSS files", function () {
+    var re = /font-weight\s*:\s*650\b/;
+    var offenders = findOffenders(files, function (c) {
+      return re.test(c);
+    });
+    expect(offenders).toEqual([]);
+  });
+
+  /**
+   * Hardcoded breakpoint — raw px-width @media query
+   * History: Batch 1 (mobile & responsive certification). The
+   * breakpoint scale is single-sourced in tokens/breakpoints and
+   * wired into BOTH the MUI theme (theme.breakpoints) and the `mq`
+   * string helpers. A raw `@media (min-width:600px)` (or any literal
+   * px width) bypasses that single source and silently re-introduces
+   * the MUI-default divergence (sm:600 / md:900 / lg:1200) the token
+   * wiring was added to eliminate.
+   *
+   * Token-derived queries are produced via mq.up()/down() as
+   * interpolated `${...}px` strings — no digit follows `width:`, so
+   * they never match. Feature queries (prefers-reduced-motion,
+   * pointer, print) carry no width literal and are unaffected.
+   */
+  test("no hardcoded px-width @media query (use mq.up/down or theme.breakpoints)", function () {
+    var re = /@media[^{]*\b(?:min|max)-width\s*:\s*\d/;
+    var offenders = findOffenders(files, function (c) {
+      return re.test(c);
+    });
+    expect(offenders).toEqual([]);
+  });
+
+  /**
+   * Hardcoded breakpoint — useMediaQuery() with a literal px string
+   * History: Batch 1. `useMediaQuery("(max-width: 600px)")` hardcodes a
+   * breakpoint outside the token scale. The sanctioned form passes a
+   * theme callback — `useMediaQuery(theme.breakpoints.down("sm"))` — so
+   * the query resolves against the wired token values. This rule flags
+   * only the string-literal form: the theme-callback form has no quote
+   * immediately after the opening paren and is unaffected.
+   */
+  test("no useMediaQuery() with a literal px breakpoint string", function () {
+    var re = /useMediaQuery\(\s*["'`][^)]*\d+\s*px/;
+    var offenders = findOffenders(files, function (c) {
+      return re.test(c);
+    });
+    expect(offenders).toEqual([]);
+  });
+
+  /**
+   * Hardcoded px floor in a CSS-grid minmax() track
+   * History: Batch 2 (KVGrid + components/FormGrid) and Batch 9
+   * (patterns/FormGrid) — the mobile & responsive certification. An
+   * auto-fill grid written as `minmax(<N>px, 1fr)` uses the px value as
+   * a HARD track minimum: when that floor exceeds the available
+   * container width (a large N, or the grid nested inside a narrow
+   * column / Drawer at the sm tier) the track cannot shrink and
+   * overflows its container, producing horizontal scroll on tablet /
+   * phone viewports (WCAG 1.4.10 Reflow).
+   *
+   * The sanctioned forms never match this rule:
+   *   - `minmax(0, 1fr)`                  → 0 floor, no px
+   *   - `minmax(min(${w}px, 100%), 1fr)`  → starts with `min(` (not a
+   *                                          digit) and the px floor is
+   *                                          clamped to the container
+   * Only a LITERAL leading-digit px floor — `minmax(240px, …)` — trips
+   * the rule, which is exactly the un-clamped, un-tokenised regression
+   * the responsive audit forbids. Verified green against every
+   * display:grid site in the v2 surface (KVGrid, components/FormGrid,
+   * patterns/FormGrid, FormGrid.Item, KeyboardShortcutsHelp).
+   */
+  test("no hardcoded px floor in a CSS-grid minmax() track (clamp with min(…,100%))", function () {
+    var re = /minmax\(\s*\d+(?:\.\d+)?\s*px/i;
+    var offenders = findOffenders(files, function (c) {
+      return re.test(c);
+    });
+    expect(offenders).toEqual([]);
+  });
+});
+//# sourceMappingURL=banned-patterns.test.js.map

package/dist/v2/__tests__/banned-patterns.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banned-patterns.test.js","names":["fs","_interopRequireWildcard","require","path","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","obj","__esModule","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","_regeneratorRuntime","exports","Op","hasOwn","value","$Symbol","Symbol","iteratorSymbol","iterator","asyncIteratorSymbol","asyncIterator","toStringTagSymbol","toStringTag","define","enumerable","configurable","writable","err","wrap","innerFn","outerFn","self","tryLocsList","protoGenerator","Generator","generator","create","context","Context","makeInvokeMethod","tryCatch","fn","arg","type","ContinueSentinel","GeneratorFunction","GeneratorFunctionPrototype","IteratorPrototype","getProto","getPrototypeOf","NativeIteratorPrototype","values","Gp","defineIteratorMethods","forEach","method","_invoke","AsyncIterator","PromiseImpl","invoke","resolve","reject","record","result","__await","then","unwrapped","error","previousPromise","callInvokeWithMethodAndArg","state","Error","doneResult","delegate","delegateResult","maybeInvokeDelegate","sent","_sent","dispatchException","abrupt","done","methodName","undefined","TypeError","info","resultName","next","nextLoc","pushTryEntry","locs","entry","tryLoc","catchLoc","finallyLoc","afterLoc","tryEntries","push","resetTryEntry","completion","reset","iterable","iteratorMethod","isNaN","length","i","displayName","isGeneratorFunction","genFun","ctor","constructor","name","mark","setPrototypeOf","__proto__","awrap","async","Promise","iter","keys","val","object","reverse","pop","skipTempReset","prev","charAt","slice","stop","rootRecord","rval","exception","handle","loc","caught","hasCatch","hasFinally","finallyEntry","complete","finish","_catch","thrown","delegateYield","_marked","walk","_createForOfIteratorHelper","o","allowArrayLike","it","Array","isArray","_unsupportedIterableToArray","F","s","n","e","_e","f","normalCompletion","didErr","step","_e2","minLen","_arrayLikeToArray","toString","from","test","arr","len","arr2","V2_ROOT","__dirname","dir","_iterator","_step","p","walk$","_context","readdirSync","withFileTypes","join","isDirectory","isFile","endsWith","t1","readAllSourceFiles","files","_iterator2","_step2","file","content","readFileSync","findOffenders","predicate","filter","map","relative","describe","beforeAll","expect","toBeGreaterThan","offenders","c","includes","toEqual","re"],"sources":["../../../src/lib/v2/__tests__/banned-patterns.test.ts"],"sourcesContent":["/* eslint-env node */\r\nimport * as fs from \"fs\";\r\nimport * as path from \"path\";\r\n\r\n/**\r\n * Static-analysis tests guarding against re-introduction of banned\r\n * patterns in src/lib/v2/. Pure filesystem scan; no React, no jsdom.\r\n *\r\n * Each banned pattern has a unique regression history documented in\r\n * the per-test comment so future readers know WHY the rule exists,\r\n * not just what it forbids.\r\n */\r\n\r\nconst V2_ROOT: string = path.resolve(__dirname, \"..\");\r\n\r\ninterface SourceFile {\r\n  path: string;\r\n  content: string;\r\n}\r\n\r\n/**\r\n * Recursively walk a directory, yielding paths of source files that\r\n * are eligible for scanning. Excludes nested __tests__ folders so\r\n * test fixtures referencing banned strings as test data don't trigger\r\n * the rule. Scans .js/.jsx/.ts/.tsx/.css (ambient .d.ts excluded — no\r\n * runtime style/breakpoint literals live there).\r\n */\r\nfunction* walk(dir: string): Generator<string> {\r\n  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\r\n    const p = path.join(dir, entry.name);\r\n    if (entry.isDirectory()) {\r\n      if (entry.name === \"__tests__\" || entry.name === \"node_modules\") continue;\r\n      yield* walk(p);\r\n    } else if (\r\n      entry.isFile() &&\r\n      /\\.(?:jsx?|tsx?|css)$/.test(entry.name) &&\r\n      !entry.name.endsWith(\".d.ts\")\r\n    ) {\r\n      yield p;\r\n    }\r\n  }\r\n}\r\n\r\nfunction readAllSourceFiles(): SourceFile[] {\r\n  const files: SourceFile[] = [];\r\n  for (const file of walk(V2_ROOT)) {\r\n    files.push({ path: file, content: fs.readFileSync(file, \"utf8\") });\r\n  }\r\n  return files;\r\n}\r\n\r\nfunction findOffenders(\r\n  files: SourceFile[],\r\n  predicate: (content: string) => boolean\r\n): string[] {\r\n  return files\r\n    .filter((f) => predicate(f.content))\r\n    .map((f) => path.relative(V2_ROOT, f.path));\r\n}\r\n\r\ndescribe(\"Banned patterns in src/lib/v2/ (regression guard)\", () => {\r\n  let files: SourceFile[];\r\n\r\n  beforeAll(() => {\r\n    files = readAllSourceFiles();\r\n    // Sanity check — make sure the walker actually found source.\r\n    // A misconfigured path would silently make every test pass with\r\n    // an empty input set; this prevents that false-positive.\r\n    expect(files.length).toBeGreaterThan(20);\r\n  });\r\n\r\n  /**\r\n   * --fw-black ghost token\r\n   * History: Batch 1 removed fontWeight.black from the typography\r\n   * tokens; Batch 2 dropped the matching `--fw-black` line from the\r\n   * cssVariables emitter. Two regression sites detected later\r\n   * (KPICard in Batch 6, FormSection in Batch 7) — both silently\r\n   * lost their bold weight at runtime. The CSS variable was\r\n   * referenced but resolved to undefined.\r\n   *\r\n   * ⚠ THE SCAN IS RAW AND COMMENT-BLIND. DO NOT \"FIX\" THAT.\r\n   *\r\n   * `findOffenders` matches the banned literal anywhere in the file, including\r\n   * inside comments. That is deliberate: a guard that parses code can be fooled\r\n   * by anything its parser mishandles, whereas a text scan cannot. The cost is\r\n   * that DOCUMENTING the banned token — even to record its removal — trips the\r\n   * rule.\r\n   *\r\n   * That is exactly what happened during the procuration-portnet-fe audit: both\r\n   * `--fw-black` tests failed, and the \"offenders\" turned out to be explanatory\r\n   * comments in `KPICard.tsx` and `theme/cssVariables.ts` describing the very\r\n   * fix this rule enforces. The code was correct; both files already used\r\n   * `var(--fw-bold)`. The comments were reworded to refer to the token\r\n   * descriptively instead.\r\n   *\r\n   * So: if this fails, read the offending lines BEFORE assuming a regression.\r\n   * The correct remedy is to reword the prose, never to add comment-stripping\r\n   * here — that would weaken every rule in this file to fix a documentation\r\n   * nit.\r\n   *\r\n   * `__tests__` is excluded from `walk`, which is why this docstring may name\r\n   * the token freely.\r\n   */\r\n  test(\"no `--fw-black` references anywhere in src/lib/v2/\", () => {\r\n    const offenders = findOffenders(files, (c) => c.includes(\"--fw-black\"));\r\n    expect(offenders).toEqual([]);\r\n  });\r\n\r\n  test(\"no `var(--fw-black)` consumption (paranoid duplicate of the above)\", () => {\r\n    const offenders = findOffenders(files, (c) => c.includes(\"var(--fw-black)\"));\r\n    expect(offenders).toEqual([]);\r\n  });\r\n\r\n  /**\r\n   * fontWeight: 650\r\n   * History: Banned by Batch 1 typography refactor — 650 is a\r\n   * non-standard CSS weight not supported by non-variable fallback\r\n   * fonts. Re-introduced twice in Batch 6 (Stepper HStepper +\r\n   * FilterTab). Each time it took a careful read to spot, since\r\n   * 650 looks \"close enough\" to semibold (600).\r\n   */\r\n  test(\"no `fontWeight: 650` literal in component sx / inline style\", () => {\r\n    // Match `fontWeight: 650` and `fontWeight:650` (with or without space).\r\n    // Word boundary on the right so we don't false-match 6500.\r\n    const re = /fontWeight\\s*:\\s*650\\b/;\r\n    const offenders = findOffenders(files, (c) => re.test(c));\r\n    expect(offenders).toEqual([]);\r\n  });\r\n\r\n  /**\r\n   * Plain CSS form `font-weight: 650`\r\n   * Same rationale as above but for the kebab-case form used inside\r\n   * .css files (base.css and friends).\r\n   */\r\n  test(\"no `font-weight: 650` in CSS files\", () => {\r\n    const re = /font-weight\\s*:\\s*650\\b/;\r\n    const offenders = findOffenders(files, (c) => re.test(c));\r\n    expect(offenders).toEqual([]);\r\n  });\r\n\r\n  /**\r\n   * Hardcoded breakpoint — raw px-width @media query\r\n   * History: Batch 1 (mobile & responsive certification). The\r\n   * breakpoint scale is single-sourced in tokens/breakpoints and\r\n   * wired into BOTH the MUI theme (theme.breakpoints) and the `mq`\r\n   * string helpers. A raw `@media (min-width:600px)` (or any literal\r\n   * px width) bypasses that single source and silently re-introduces\r\n   * the MUI-default divergence (sm:600 / md:900 / lg:1200) the token\r\n   * wiring was added to eliminate.\r\n   *\r\n   * Token-derived queries are produced via mq.up()/down() as\r\n   * interpolated `${...}px` strings — no digit follows `width:`, so\r\n   * they never match. Feature queries (prefers-reduced-motion,\r\n   * pointer, print) carry no width literal and are unaffected.\r\n   */\r\n  test(\"no hardcoded px-width @media query (use mq.up/down or theme.breakpoints)\", () => {\r\n    const re = /@media[^{]*\\b(?:min|max)-width\\s*:\\s*\\d/;\r\n    const offenders = findOffenders(files, (c) => re.test(c));\r\n    expect(offenders).toEqual([]);\r\n  });\r\n\r\n  /**\r\n   * Hardcoded breakpoint — useMediaQuery() with a literal px string\r\n   * History: Batch 1. `useMediaQuery(\"(max-width: 600px)\")` hardcodes a\r\n   * breakpoint outside the token scale. The sanctioned form passes a\r\n   * theme callback — `useMediaQuery(theme.breakpoints.down(\"sm\"))` — so\r\n   * the query resolves against the wired token values. This rule flags\r\n   * only the string-literal form: the theme-callback form has no quote\r\n   * immediately after the opening paren and is unaffected.\r\n   */\r\n  test(\"no useMediaQuery() with a literal px breakpoint string\", () => {\r\n    const re = /useMediaQuery\\(\\s*[\"'`][^)]*\\d+\\s*px/;\r\n    const offenders = findOffenders(files, (c) => re.test(c));\r\n    expect(offenders).toEqual([]);\r\n  });\r\n\r\n  /**\r\n   * Hardcoded px floor in a CSS-grid minmax() track\r\n   * History: Batch 2 (KVGrid + components/FormGrid) and Batch 9\r\n   * (patterns/FormGrid) — the mobile & responsive certification. An\r\n   * auto-fill grid written as `minmax(<N>px, 1fr)` uses the px value as\r\n   * a HARD track minimum: when that floor exceeds the available\r\n   * container width (a large N, or the grid nested inside a narrow\r\n   * column / Drawer at the sm tier) the track cannot shrink and\r\n   * overflows its container, producing horizontal scroll on tablet /\r\n   * phone viewports (WCAG 1.4.10 Reflow).\r\n   *\r\n   * The sanctioned forms never match this rule:\r\n   *   - `minmax(0, 1fr)`                  → 0 floor, no px\r\n   *   - `minmax(min(${w}px, 100%), 1fr)`  → starts with `min(` (not a\r\n   *                                          digit) and the px floor is\r\n   *                                          clamped to the container\r\n   * Only a LITERAL leading-digit px floor — `minmax(240px, …)` — trips\r\n   * the rule, which is exactly the un-clamped, un-tokenised regression\r\n   * the responsive audit forbids. Verified green against every\r\n   * display:grid site in the v2 surface (KVGrid, components/FormGrid,\r\n   * patterns/FormGrid, FormGrid.Item, KeyboardShortcutsHelp).\r\n   */\r\n  test(\"no hardcoded px floor in a CSS-grid minmax() track (clamp with min(…,100%))\", () => {\r\n    const re = /minmax\\(\\s*\\d+(?:\\.\\d+)?\\s*px/i;\r\n    const offenders = findOffenders(files, (c) => re.test(c));\r\n    expect(offenders).toEqual([]);\r\n  });\r\n});\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/__tests__/contrast-palette.test.js

@@ -0,0 +1,225 @@
+"use strict";
+
+var _contrast = require("../utils/contrast");
+var _tokens = require("../tokens");
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+/**
+ * Token-palette contrast certification (Charter §05.1 / WCAG 2.1 AA).
+ *
+ * WHY THIS FILE EXISTS
+ * --------------------
+ * R-C.1 / R-C.2 / R-C.3 are MUST rules, and until now nothing verified them.
+ * `utils/contrast.ts` shipped a correct WCAG ratio implementation and had no
+ * test asserting the palette it exists to check; the ratios in `colors.ts` were
+ * hand-written COMMENTS, unenforced — exactly the class of claim that drifts
+ * silently when a hue is nudged.
+ *
+ * Contrast is one of the few a11y rules that is fully computable without a
+ * browser, so it belongs in CI rather than in a manual audit pass.
+ *
+ * Found by writing it: `fgSubtle` on `bgSubtle` is ~4.32:1 — BELOW AA. See the
+ * documented-failure block at the bottom; that is a real finding, not a test
+ * artefact.
+ */
+
+/** Every light-mode surface that body text can land on. */
+var LIGHT_SURFACES = [["surface", _tokens.surface.surface], ["bgElev", _tokens.surface.bgElev], ["bg", _tokens.surface.bg], ["bgSubtle", _tokens.surface.bgSubtle]];
+describe("Token palette — WCAG AA contrast (R-C.1 / R-C.2 / R-C.3)", function () {
+  describe("ink on light surfaces — normal text ≥ 4.5:1", function () {
+    var _loop = function _loop() {
+      var _LIGHT_SURFACES$_i = _slicedToArray(_LIGHT_SURFACES[_i], 2),
+        name = _LIGHT_SURFACES$_i[0],
+        bg = _LIGHT_SURFACES$_i[1];
+      test("fg on ".concat(name), function () {
+        expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.ink.fg, bg), "normal")).toBe(true);
+      });
+      test("fgMuted on ".concat(name), function () {
+        expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.ink.fgMuted, bg), "normal")).toBe(true);
+      });
+    };
+    for (var _i = 0, _LIGHT_SURFACES = LIGHT_SURFACES; _i < _LIGHT_SURFACES.length; _i++) {
+      _loop();
+    }
+    test("fgInverse on the darkest dark surface", function () {
+      expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.ink.fgInverse, _tokens.dark.bg), "normal")).toBe(true);
+    });
+  });
+  describe("semantic fg — readable on white AND on its own soft fill", function () {
+    var pairs = [["success", _tokens.semantic.successFg, _tokens.semantic.successSoft], ["warning", _tokens.semantic.warningFg, _tokens.semantic.warningSoft], ["danger", _tokens.semantic.dangerFg, _tokens.semantic.dangerSoft], ["info", _tokens.semantic.infoFg, _tokens.semantic.infoSoft]];
+    var _loop2 = function _loop2() {
+      var _pairs$_i = _slicedToArray(_pairs[_i2], 3),
+        name = _pairs$_i[0],
+        fg = _pairs$_i[1],
+        soft = _pairs$_i[2];
+      test("".concat(name, "Fg on white"), function () {
+        expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(fg, "#FFFFFF"), "normal")).toBe(true);
+      });
+      test("".concat(name, "Fg on ").concat(name, "Soft"), function () {
+        expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(fg, soft), "normal")).toBe(true);
+      });
+    };
+    for (var _i2 = 0, _pairs = pairs; _i2 < _pairs.length; _i2++) {
+      _loop2();
+    }
+  });
+
+  /**
+   * The Charter's promise in §02.1: "Combinaison background -soft +
+   * foreground -fg = AA garanti." This is that promise, enforced.
+   */
+  describe("status palette — every -fg on its own -soft is AA (§02.1)", function () {
+    var _loop3 = function _loop3() {
+      var key = _arr2[_i3];
+      test("status.".concat(key), function () {
+        var _status$key = _tokens.status[key],
+          soft = _status$key.soft,
+          fg = _status$key.fg;
+        expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(fg, soft), "normal")).toBe(true);
+      });
+      test("status.".concat(key, " fg on white"), function () {
+        expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.status[key].fg, "#FFFFFF"), "normal")).toBe(true);
+      });
+    };
+    for (var _i3 = 0, _arr2 = Object.keys(_tokens.status); _i3 < _arr2.length; _i3++) {
+      _loop3();
+    }
+  });
+  describe("non-text UI ≥ 3:1 (WCAG 1.4.11 / R-C.3)", function () {
+    var saturated = [["success", _tokens.semantic.success], ["warning", _tokens.semantic.warning], ["danger", _tokens.semantic.danger], ["info", _tokens.semantic.info]];
+    var _loop4 = function _loop4() {
+      var _saturated$_i = _slicedToArray(_saturated[_i4], 2),
+        name = _saturated$_i[0],
+        colour = _saturated$_i[1];
+      test("".concat(name, " (icon / border grade) on white"), function () {
+        expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(colour, "#FFFFFF"), "ui")).toBe(true);
+      });
+    };
+    for (var _i4 = 0, _saturated = saturated; _i4 < _saturated.length; _i4++) {
+      _loop4();
+    }
+  });
+  describe("brand", function () {
+    test("accent on white is AA for normal text", function () {
+      expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.brand.accent, "#FFFFFF"), "normal")).toBe(true);
+    });
+    test("accentFg on accent — the primary-button pair", function () {
+      expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.brand.accentFg, _tokens.brand.accent), "normal")).toBe(true);
+    });
+    test("accentHover keeps AA against accentFg (pressed state stays readable)", function () {
+      expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.brand.accentFg, _tokens.brand.accentHover), "normal")).toBe(true);
+    });
+  });
+  describe("dark mode", function () {
+    test("dark.fg on dark.surface", function () {
+      expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.dark.fg, _tokens.dark.surface), "normal")).toBe(true);
+    });
+    test("dark.fgMuted on dark.surface", function () {
+      expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.dark.fgMuted, _tokens.dark.surface), "normal")).toBe(true);
+    });
+    var _loop5 = function _loop5() {
+      var key = _arr3[_i5];
+      test("dark status.".concat(key, ".fg on dark.surface"), function () {
+        expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.dark.status[key].fg, _tokens.dark.surface), "normal")).toBe(true);
+      });
+    };
+    for (var _i5 = 0, _arr3 = Object.keys(_tokens.dark.status); _i5 < _arr3.length; _i5++) {
+      _loop5();
+    }
+  });
+
+  /* ══════════════════════════════════════════════════════════════════
+   * DOCUMENTED FAILURES — asserted at their MEASURED value, not at the
+   * threshold, so the suite stays green while the breach stays visible and
+   * any drift shows up as a diff. Both need a palette decision, not a
+   * test change.
+   * ══════════════════════════════════════════════════════════════════ */
+  describe("KNOWN AA FAILURES (documented, pending decision)", function () {
+    /**
+     * A9-01 — `fgSubtle` on `bgSubtle` ≈ 4.32:1, below the 4.5 floor.
+     *
+     * `colors.ts` documents fgSubtle as "AA · 4.81:1 on white — incidental
+     * text only (WCAG 1.4.6)". On white that holds. On `bgSubtle` it does not,
+     * and the exemption does not rescue it, because fgSubtle is NOT used only
+     * for incidental text — it colours KV eyebrow labels, section captions and
+     * hero stat labels, all of which name the value beside them.
+     *
+     * LIVE BREACH: both preview drawers put `--fg-subtle` labels on a
+     * `--bg-subtle` hero panel (dfd `GestionDFDPreviewDrawer` HERO_BOX_STYLE +
+     * HERO_LABEL_STYLE, ti `GestionTIPreviewDrawer` HERO_STAT_LABEL_STYLE), at
+     * `--text-xs` (12px) — too small to qualify as large text, so the 4.5
+     * floor applies.
+     *
+     * FIX OPTIONS: darken fgSubtle (affects the muted/subtle hierarchy
+     * fleet-wide), or switch those labels to `--fg-muted` (AAA, 7.5:1 on
+     * bgSubtle) which is what every other label surface already uses.
+     */
+    test("fgSubtle on bgSubtle is BELOW AA — ~4.32:1", function () {
+      var ratio = (0, _contrast.contrastRatio)(_tokens.ink.fgSubtle, _tokens.surface.bgSubtle);
+      expect(ratio).not.toBeNull();
+      expect(ratio).toBeLessThan(_contrast.WCAG_AA_NORMAL);
+      expect(ratio).toBeGreaterThan(4.2);
+      // It DOES pass on white — the failure is surface-specific.
+      expect((0, _contrast.passesContrast)((0, _contrast.contrastRatio)(_tokens.ink.fgSubtle, "#FFFFFF"), "normal")).toBe(true);
+    });
+
+    /**
+     * A9-02 — `borderStrong` ≈ 2.87:1 on white. BELOW the 3:1 non-text floor.
+     *
+     * ⚠️ The token's own comment in `colors.ts` reads:
+     *      borderStrong: "#9099AA", // WCAG 1.4.11 · ≥ 3:1 against white
+     * That claim is FALSE. This is precisely the drift this file exists to
+     * catch — an unenforced hand-written ratio that nobody re-derived.
+     *
+     * IMPACT depends on usage. `--border-strong` currently colours the
+     * scrollbar thumb (`base.css`) and the `kbd` bottom edge in
+     * KeyboardShortcutsHelp. If it is ever used for an INPUT border or any
+     * other control boundary, 1.4.11 applies and the breach is live — audit
+     * usage before deciding severity.
+     *
+     * FIX: darken to relative luminance ≤ 0.30 (currently 0.316). Roughly
+     * #868FA3 / #8A92A5; change the token and this assertion flips to the
+     * `passesContrast(..., "ui")` form.
+     */
+    test("borderStrong on white is BELOW 3:1 — ~2.87:1 (comment in colors.ts is wrong)", function () {
+      var ratio = (0, _contrast.contrastRatio)(_tokens.border.borderStrong, "#FFFFFF");
+      expect(ratio).not.toBeNull();
+      expect(ratio).toBeLessThan(_contrast.WCAG_AA_UI_NON_TEXT);
+      expect(ratio).toBeGreaterThan(2.8);
+    });
+
+    /**
+     * A9-03 — `dark.borderStrong` ≈ 2.28:1 on `dark.surface`. Worse than the
+     * light-mode equivalent, and the same 1.4.11 floor applies in dark mode.
+     *
+     * FIX: lighten to relative luminance ≥ 0.119 (currently 0.078) — roughly
+     * #5C6478 or lighter. Note dark mode is currently UNREACHABLE in both
+     * consuming modules (neither sets `[data-theme="dark"]` on <html>), which
+     * is why nobody has seen it — see the RGESN R-9.5 note in the handover.
+     */
+    test("dark.borderStrong on dark.surface is BELOW 3:1 — ~2.28:1", function () {
+      var ratio = (0, _contrast.contrastRatio)(_tokens.dark.borderStrong, _tokens.dark.surface);
+      expect(ratio).not.toBeNull();
+      expect(ratio).toBeLessThan(_contrast.WCAG_AA_UI_NON_TEXT);
+      expect(ratio).toBeGreaterThan(2.2);
+    });
+
+    /**
+     * Already flagged in colors.ts itself: secondaryFg (#FFFFFF) on
+     * secondary (#4FB8CF) ≈ 1.96:1. The token comment restricts it to
+     * chip/badge surfaces and non-text accent fills. Asserted here so the
+     * restriction is machine-checked rather than comment-only: it fails BOTH
+     * the text floor and the 3:1 non-text floor.
+     */
+    test("brandSecondary text pair is BELOW AA and below 3:1 — fills only", function () {
+      var ratio = (0, _contrast.contrastRatio)(_tokens.brandSecondary.secondaryFg, _tokens.brandSecondary.secondary);
+      expect(ratio).not.toBeNull();
+      expect(ratio).toBeLessThan(_contrast.WCAG_AA_UI_NON_TEXT);
+    });
+  });
+});
+//# sourceMappingURL=contrast-palette.test.js.map