@portnet/ui 6.0.1 → 6.0.3

package/dist/esm/v2/utils/contrast.js

@@ -1,4 +1,3 @@
-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); }
 /**
  * WCAG 2.1 contrast utilities — Portnet UI v2
  *
@@ -17,13 +16,13 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
 /* ── WCAG AA thresholds (exported for caller readability) ──────── */
 
 /** Normal text contrast ratio threshold (AA). */
-export var WCAG_AA_NORMAL = 4.5;
+export const WCAG_AA_NORMAL = 4.5;
 
 /** Large text (≥ 18pt or ≥ 14pt bold) contrast ratio threshold (AA). */
-export var WCAG_AA_LARGE = 3.0;
+export const WCAG_AA_LARGE = 3.0;
 
 /** UI components & graphical objects contrast ratio threshold (AA 1.4.11). */
-export var WCAG_AA_UI_NON_TEXT = 3.0;
+export const WCAG_AA_UI_NON_TEXT = 3.0;
 
 /* ── Color parsing ───────────────────────── */
 
@@ -45,11 +44,11 @@ export var WCAG_AA_UI_NON_TEXT = 3.0;
  */
 export function parseColor(input) {
   if (typeof input !== "string") return null;
-  var s = input.trim();
+  const s = input.trim();
 
   // Hex (3, 6, or 8 digits; alpha dropped if present)
-  var hexMatch = s.match(/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/);
-  var hex = hexMatch === null || hexMatch === void 0 ? void 0 : hexMatch[1];
+  const hexMatch = s.match(/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/);
+  const hex = hexMatch?.[1];
   if (hex) {
     if (hex.length === 3) {
       return {
@@ -67,17 +66,16 @@ export function parseColor(input) {
   }
 
   // rgb() / rgba() — alpha dropped
-  var rgbMatch = s.match(/^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})/);
+  const rgbMatch = s.match(/^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})/);
   if (rgbMatch) {
-    var _rgbMatch$, _rgbMatch$2, _rgbMatch$3;
-    var r = parseInt((_rgbMatch$ = rgbMatch[1]) !== null && _rgbMatch$ !== void 0 ? _rgbMatch$ : "", 10);
-    var g = parseInt((_rgbMatch$2 = rgbMatch[2]) !== null && _rgbMatch$2 !== void 0 ? _rgbMatch$2 : "", 10);
-    var b = parseInt((_rgbMatch$3 = rgbMatch[3]) !== null && _rgbMatch$3 !== void 0 ? _rgbMatch$3 : "", 10);
+    const r = parseInt(rgbMatch[1] ?? "", 10);
+    const g = parseInt(rgbMatch[2] ?? "", 10);
+    const b = parseInt(rgbMatch[3] ?? "", 10);
     if (Number.isFinite(r) && r >= 0 && r <= 255 && Number.isFinite(g) && g >= 0 && g <= 255 && Number.isFinite(b) && b >= 0 && b <= 255) {
       return {
-        r: r,
-        g: g,
-        b: b
+        r,
+        g,
+        b
       };
     }
   }
@@ -88,7 +86,7 @@ export function parseColor(input) {
 
 /** sRGB channel → linear-light conversion per WCAG 2.1. */
 function srgbChannelToLinear(c) {
-  var cs = c / 255;
+  const cs = c / 255;
   return cs <= 0.03928 ? cs / 12.92 : Math.pow((cs + 0.055) / 1.055, 2.4);
 }
 
@@ -98,14 +96,16 @@ function srgbChannelToLinear(c) {
  * Returns a number in 0..1, or null if input is invalid.
  */
 export function relativeLuminance(rgb) {
-  if (!rgb || _typeof(rgb) !== "object") return null;
-  var r = rgb.r,
-    g = rgb.g,
-    b = rgb.b;
+  if (!rgb || typeof rgb !== "object") return null;
+  const {
+    r,
+    g,
+    b
+  } = rgb;
   if (!Number.isFinite(r) || !Number.isFinite(g) || !Number.isFinite(b)) return null;
-  var R = srgbChannelToLinear(r);
-  var G = srgbChannelToLinear(g);
-  var B = srgbChannelToLinear(b);
+  const R = srgbChannelToLinear(r);
+  const G = srgbChannelToLinear(g);
+  const B = srgbChannelToLinear(b);
   return 0.2126 * R + 0.7152 * G + 0.0722 * B;
 }
 
@@ -117,13 +117,13 @@ export function relativeLuminance(rgb) {
  * [1.0, 21.0], or null if either input is unparseable.
  */
 export function contrastRatio(c1, c2) {
-  var rgb1 = typeof c1 === "string" ? parseColor(c1) : c1;
-  var rgb2 = typeof c2 === "string" ? parseColor(c2) : c2;
-  var L1 = relativeLuminance(rgb1);
-  var L2 = relativeLuminance(rgb2);
+  const rgb1 = typeof c1 === "string" ? parseColor(c1) : c1;
+  const rgb2 = typeof c2 === "string" ? parseColor(c2) : c2;
+  const L1 = relativeLuminance(rgb1);
+  const L2 = relativeLuminance(rgb2);
   if (L1 == null || L2 == null) return null;
-  var lighter = Math.max(L1, L2);
-  var darker = Math.min(L1, L2);
+  const lighter = Math.max(L1, L2);
+  const darker = Math.min(L1, L2);
   return (lighter + 0.05) / (darker + 0.05);
 }
 
@@ -136,10 +136,9 @@ export function contrastRatio(c1, c2) {
  * `level` accepts "normal" | "large" | "ui". Unknown levels default
  * to the strictest threshold.
  */
-export function passesContrast(ratio) {
-  var level = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "normal";
+export function passesContrast(ratio, level = "normal") {
   if (ratio == null || !Number.isFinite(ratio)) return false;
-  var threshold;
+  let threshold;
   switch (level) {
     case "large":
       threshold = WCAG_AA_LARGE;

package/dist/esm/v2/utils/contrast.js.map

@@ -1 +1 @@
-{"version":3,"file":"contrast.js","names":["WCAG_AA_NORMAL","WCAG_AA_LARGE","WCAG_AA_UI_NON_TEXT","parseColor","input","s","trim","hexMatch","match","hex","length","r","parseInt","charAt","g","b","slice","rgbMatch","_rgbMatch$","_rgbMatch$2","_rgbMatch$3","Number","isFinite","srgbChannelToLinear","c","cs","Math","pow","relativeLuminance","rgb","_typeof","R","G","B","contrastRatio","c1","c2","rgb1","rgb2","L1","L2","lighter","max","darker","min","passesContrast","ratio","level","arguments","undefined","threshold"],"sources":["../../../../src/lib/v2/utils/contrast.ts"],"sourcesContent":["/**\r\n * WCAG 2.1 contrast utilities — Portnet UI v2\r\n *\r\n * Reference: https://www.w3.org/TR/WCAG21/#dfn-contrast-ratio\r\n *\r\n * Pure functions, framework-agnostic, no deps. Reusable by any\r\n * host module that needs to validate a runtime brand override\r\n * against WCAG 1.4.3 AA (typical scenario: a host-shell event\r\n * injects a tenant brand and the consumer wants to dev-warn when\r\n * the resulting accent/foreground pair drops below 4.5:1).\r\n *\r\n * Also used by the dark-mode work (F29) to audit dual-mode token\r\n * pairs and by Storybook contrast stories.\r\n */\r\n\r\n/* ── WCAG AA thresholds (exported for caller readability) ──────── */\r\n\r\n/** Normal text contrast ratio threshold (AA). */\r\nexport const WCAG_AA_NORMAL = 4.5;\r\n\r\n/** Large text (≥ 18pt or ≥ 14pt bold) contrast ratio threshold (AA). */\r\nexport const WCAG_AA_LARGE = 3.0;\r\n\r\n/** UI components & graphical objects contrast ratio threshold (AA 1.4.11). */\r\nexport const WCAG_AA_UI_NON_TEXT = 3.0;\r\n\r\n/* ── Color parsing ───────────────────────── */\r\n\r\ntype RGB = { r: number; g: number; b: number };\r\n\r\n/**\r\n * Parse a CSS color string into an { r, g, b } object with 0..255\r\n * channels. Returns null for unparseable input.\r\n *\r\n * Supported formats:\r\n *   - \"#RGB\"      (3-digit hex shorthand)\r\n *   - \"#RRGGBB\"   (6-digit hex)\r\n *   - \"#RRGGBBAA\" (8-digit hex; alpha channel is dropped)\r\n *   - \"rgb(r, g, b)\"\r\n *   - \"rgba(r, g, b, a)\" (alpha dropped)\r\n *\r\n * HSL / HWB / LAB / named-colors are NOT supported — the v2 token\r\n * surface and observed host-shell brand payloads are always hex\r\n * or rgb(). A wider parser can be swapped in later without\r\n * changing the public API of this function.\r\n */\r\nexport function parseColor(input: unknown): RGB | null {\r\n  if (typeof input !== \"string\") return null;\r\n  const s = input.trim();\r\n\r\n  // Hex (3, 6, or 8 digits; alpha dropped if present)\r\n  const hexMatch = s.match(/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/);\r\n  const hex = hexMatch?.[1];\r\n  if (hex) {\r\n    if (hex.length === 3) {\r\n      return {\r\n        r: parseInt(hex.charAt(0) + hex.charAt(0), 16),\r\n        g: parseInt(hex.charAt(1) + hex.charAt(1), 16),\r\n        b: parseInt(hex.charAt(2) + hex.charAt(2), 16),\r\n      };\r\n    }\r\n    // 6 or 8 digit — first 6 chars are RGB\r\n    return {\r\n      r: parseInt(hex.slice(0, 2), 16),\r\n      g: parseInt(hex.slice(2, 4), 16),\r\n      b: parseInt(hex.slice(4, 6), 16),\r\n    };\r\n  }\r\n\r\n  // rgb() / rgba() — alpha dropped\r\n  const rgbMatch = s.match(\r\n    /^rgba?\\(\\s*(\\d{1,3})\\s*,\\s*(\\d{1,3})\\s*,\\s*(\\d{1,3})/\r\n  );\r\n  if (rgbMatch) {\r\n    const r = parseInt(rgbMatch[1] ?? \"\", 10);\r\n    const g = parseInt(rgbMatch[2] ?? \"\", 10);\r\n    const b = parseInt(rgbMatch[3] ?? \"\", 10);\r\n    if (\r\n      Number.isFinite(r) && r >= 0 && r <= 255 &&\r\n      Number.isFinite(g) && g >= 0 && g <= 255 &&\r\n      Number.isFinite(b) && b >= 0 && b <= 255\r\n    ) {\r\n      return { r, g, b };\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/* ── Luminance & ratio ───────────────────── */\r\n\r\n/** sRGB channel → linear-light conversion per WCAG 2.1. */\r\nfunction srgbChannelToLinear(c: number): number {\r\n  const cs = c / 255;\r\n  return cs <= 0.03928 ? cs / 12.92 : Math.pow((cs + 0.055) / 1.055, 2.4);\r\n}\r\n\r\n/**\r\n * Compute relative luminance of an sRGB color per WCAG 2.1.\r\n * Accepts an { r, g, b } object (channels in 0..255).\r\n * Returns a number in 0..1, or null if input is invalid.\r\n */\r\nexport function relativeLuminance(rgb: RGB | null | undefined): number | null {\r\n  if (!rgb || typeof rgb !== \"object\") return null;\r\n  const { r, g, b } = rgb;\r\n  if (\r\n    !Number.isFinite(r) || !Number.isFinite(g) || !Number.isFinite(b)\r\n  ) return null;\r\n  const R = srgbChannelToLinear(r);\r\n  const G = srgbChannelToLinear(g);\r\n  const B = srgbChannelToLinear(b);\r\n  return 0.2126 * R + 0.7152 * G + 0.0722 * B;\r\n}\r\n\r\n/**\r\n * WCAG contrast ratio between two colors.\r\n *\r\n * Accepts either CSS color strings (parsed via parseColor) or\r\n * already-parsed { r, g, b } objects. Returns a number in\r\n * [1.0, 21.0], or null if either input is unparseable.\r\n */\r\nexport function contrastRatio(\r\n  c1: string | RGB,\r\n  c2: string | RGB\r\n): number | null {\r\n  const rgb1 = typeof c1 === \"string\" ? parseColor(c1) : c1;\r\n  const rgb2 = typeof c2 === \"string\" ? parseColor(c2) : c2;\r\n  const L1 = relativeLuminance(rgb1);\r\n  const L2 = relativeLuminance(rgb2);\r\n  if (L1 == null || L2 == null) return null;\r\n  const lighter = Math.max(L1, L2);\r\n  const darker  = Math.min(L1, L2);\r\n  return (lighter + 0.05) / (darker + 0.05);\r\n}\r\n\r\n/**\r\n * Verdict helper — `passesContrast(ratio, \"normal\")` returns true\r\n * if the ratio meets the requested WCAG AA threshold. Returns\r\n * false on null ratios so callers can treat unparseable inputs as\r\n * failures.\r\n *\r\n * `level` accepts \"normal\" | \"large\" | \"ui\". Unknown levels default\r\n * to the strictest threshold.\r\n */\r\nexport function passesContrast(\r\n  ratio: number | null | undefined,\r\n  level: \"normal\" | \"large\" | \"ui\" = \"normal\"\r\n): boolean {\r\n  if (ratio == null || !Number.isFinite(ratio)) return false;\r\n  let threshold: number;\r\n  switch (level) {\r\n    case \"large\":\r\n      threshold = WCAG_AA_LARGE;\r\n      break;\r\n    case \"ui\":\r\n      threshold = WCAG_AA_UI_NON_TEXT;\r\n      break;\r\n    case \"normal\":\r\n    default:\r\n      threshold = WCAG_AA_NORMAL;\r\n      break;\r\n  }\r\n  return ratio >= threshold;\r\n}\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"contrast.js","names":["WCAG_AA_NORMAL","WCAG_AA_LARGE","WCAG_AA_UI_NON_TEXT","parseColor","input","s","trim","hexMatch","match","hex","length","r","parseInt","charAt","g","b","slice","rgbMatch","Number","isFinite","srgbChannelToLinear","c","cs","Math","pow","relativeLuminance","rgb","R","G","B","contrastRatio","c1","c2","rgb1","rgb2","L1","L2","lighter","max","darker","min","passesContrast","ratio","level","threshold"],"sources":["../../../../src/lib/v2/utils/contrast.ts"],"sourcesContent":["/**\r\n * WCAG 2.1 contrast utilities — Portnet UI v2\r\n *\r\n * Reference: https://www.w3.org/TR/WCAG21/#dfn-contrast-ratio\r\n *\r\n * Pure functions, framework-agnostic, no deps. Reusable by any\r\n * host module that needs to validate a runtime brand override\r\n * against WCAG 1.4.3 AA (typical scenario: a host-shell event\r\n * injects a tenant brand and the consumer wants to dev-warn when\r\n * the resulting accent/foreground pair drops below 4.5:1).\r\n *\r\n * Also used by the dark-mode work (F29) to audit dual-mode token\r\n * pairs and by Storybook contrast stories.\r\n */\r\n\r\n/* ── WCAG AA thresholds (exported for caller readability) ──────── */\r\n\r\n/** Normal text contrast ratio threshold (AA). */\r\nexport const WCAG_AA_NORMAL = 4.5;\r\n\r\n/** Large text (≥ 18pt or ≥ 14pt bold) contrast ratio threshold (AA). */\r\nexport const WCAG_AA_LARGE = 3.0;\r\n\r\n/** UI components & graphical objects contrast ratio threshold (AA 1.4.11). */\r\nexport const WCAG_AA_UI_NON_TEXT = 3.0;\r\n\r\n/* ── Color parsing ───────────────────────── */\r\n\r\ntype RGB = { r: number; g: number; b: number };\r\n\r\n/**\r\n * Parse a CSS color string into an { r, g, b } object with 0..255\r\n * channels. Returns null for unparseable input.\r\n *\r\n * Supported formats:\r\n *   - \"#RGB\"      (3-digit hex shorthand)\r\n *   - \"#RRGGBB\"   (6-digit hex)\r\n *   - \"#RRGGBBAA\" (8-digit hex; alpha channel is dropped)\r\n *   - \"rgb(r, g, b)\"\r\n *   - \"rgba(r, g, b, a)\" (alpha dropped)\r\n *\r\n * HSL / HWB / LAB / named-colors are NOT supported — the v2 token\r\n * surface and observed host-shell brand payloads are always hex\r\n * or rgb(). A wider parser can be swapped in later without\r\n * changing the public API of this function.\r\n */\r\nexport function parseColor(input: unknown): RGB | null {\r\n  if (typeof input !== \"string\") return null;\r\n  const s = input.trim();\r\n\r\n  // Hex (3, 6, or 8 digits; alpha dropped if present)\r\n  const hexMatch = s.match(/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/);\r\n  const hex = hexMatch?.[1];\r\n  if (hex) {\r\n    if (hex.length === 3) {\r\n      return {\r\n        r: parseInt(hex.charAt(0) + hex.charAt(0), 16),\r\n        g: parseInt(hex.charAt(1) + hex.charAt(1), 16),\r\n        b: parseInt(hex.charAt(2) + hex.charAt(2), 16),\r\n      };\r\n    }\r\n    // 6 or 8 digit — first 6 chars are RGB\r\n    return {\r\n      r: parseInt(hex.slice(0, 2), 16),\r\n      g: parseInt(hex.slice(2, 4), 16),\r\n      b: parseInt(hex.slice(4, 6), 16),\r\n    };\r\n  }\r\n\r\n  // rgb() / rgba() — alpha dropped\r\n  const rgbMatch = s.match(\r\n    /^rgba?\\(\\s*(\\d{1,3})\\s*,\\s*(\\d{1,3})\\s*,\\s*(\\d{1,3})/\r\n  );\r\n  if (rgbMatch) {\r\n    const r = parseInt(rgbMatch[1] ?? \"\", 10);\r\n    const g = parseInt(rgbMatch[2] ?? \"\", 10);\r\n    const b = parseInt(rgbMatch[3] ?? \"\", 10);\r\n    if (\r\n      Number.isFinite(r) && r >= 0 && r <= 255 &&\r\n      Number.isFinite(g) && g >= 0 && g <= 255 &&\r\n      Number.isFinite(b) && b >= 0 && b <= 255\r\n    ) {\r\n      return { r, g, b };\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/* ── Luminance & ratio ───────────────────── */\r\n\r\n/** sRGB channel → linear-light conversion per WCAG 2.1. */\r\nfunction srgbChannelToLinear(c: number): number {\r\n  const cs = c / 255;\r\n  return cs <= 0.03928 ? cs / 12.92 : Math.pow((cs + 0.055) / 1.055, 2.4);\r\n}\r\n\r\n/**\r\n * Compute relative luminance of an sRGB color per WCAG 2.1.\r\n * Accepts an { r, g, b } object (channels in 0..255).\r\n * Returns a number in 0..1, or null if input is invalid.\r\n */\r\nexport function relativeLuminance(rgb: RGB | null | undefined): number | null {\r\n  if (!rgb || typeof rgb !== \"object\") return null;\r\n  const { r, g, b } = rgb;\r\n  if (\r\n    !Number.isFinite(r) || !Number.isFinite(g) || !Number.isFinite(b)\r\n  ) return null;\r\n  const R = srgbChannelToLinear(r);\r\n  const G = srgbChannelToLinear(g);\r\n  const B = srgbChannelToLinear(b);\r\n  return 0.2126 * R + 0.7152 * G + 0.0722 * B;\r\n}\r\n\r\n/**\r\n * WCAG contrast ratio between two colors.\r\n *\r\n * Accepts either CSS color strings (parsed via parseColor) or\r\n * already-parsed { r, g, b } objects. Returns a number in\r\n * [1.0, 21.0], or null if either input is unparseable.\r\n */\r\nexport function contrastRatio(\r\n  c1: string | RGB,\r\n  c2: string | RGB\r\n): number | null {\r\n  const rgb1 = typeof c1 === \"string\" ? parseColor(c1) : c1;\r\n  const rgb2 = typeof c2 === \"string\" ? parseColor(c2) : c2;\r\n  const L1 = relativeLuminance(rgb1);\r\n  const L2 = relativeLuminance(rgb2);\r\n  if (L1 == null || L2 == null) return null;\r\n  const lighter = Math.max(L1, L2);\r\n  const darker  = Math.min(L1, L2);\r\n  return (lighter + 0.05) / (darker + 0.05);\r\n}\r\n\r\n/**\r\n * Verdict helper — `passesContrast(ratio, \"normal\")` returns true\r\n * if the ratio meets the requested WCAG AA threshold. Returns\r\n * false on null ratios so callers can treat unparseable inputs as\r\n * failures.\r\n *\r\n * `level` accepts \"normal\" | \"large\" | \"ui\". Unknown levels default\r\n * to the strictest threshold.\r\n */\r\nexport function passesContrast(\r\n  ratio: number | null | undefined,\r\n  level: \"normal\" | \"large\" | \"ui\" = \"normal\"\r\n): boolean {\r\n  if (ratio == null || !Number.isFinite(ratio)) return false;\r\n  let threshold: number;\r\n  switch (level) {\r\n    case \"large\":\r\n      threshold = WCAG_AA_LARGE;\r\n      break;\r\n    case \"ui\":\r\n      threshold = WCAG_AA_UI_NON_TEXT;\r\n      break;\r\n    case \"normal\":\r\n    default:\r\n      threshold = WCAG_AA_NORMAL;\r\n      break;\r\n  }\r\n  return ratio >= threshold;\r\n}\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/utils/cx.js

@@ -1,35 +1,15 @@
-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 _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; }
-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); }
-function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-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; }
 /**
  * cx — minimal classnames composer
  *
  *   cx("a", cond && "b", { "c": isC })  →  "a b c"
  */
 
-export function cx() {
-  var out = [];
-  for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-    args[_key] = arguments[_key];
-  }
-  for (var _i = 0, _args = args; _i < _args.length; _i++) {
-    var a = _args[_i];
+export function cx(...args) {
+  const out = [];
+  for (const a of args) {
     if (!a) continue;
-    if (typeof a === "string" || typeof a === "number") out.push(String(a));else if (Array.isArray(a)) out.push(cx.apply(void 0, _toConsumableArray(a)));else if (_typeof(a) === "object") {
-      for (var _i2 = 0, _Object$entries = Object.entries(a); _i2 < _Object$entries.length; _i2++) {
-        var _Object$entries$_i = _slicedToArray(_Object$entries[_i2], 2),
-          k = _Object$entries$_i[0],
-          v = _Object$entries$_i[1];
-        if (v) out.push(k);
-      }
+    if (typeof a === "string" || typeof a === "number") out.push(String(a));else if (Array.isArray(a)) out.push(cx(...a));else if (typeof a === "object") {
+      for (const [k, v] of Object.entries(a)) if (v) out.push(k);
     }
   }
   return out.join(" ");

package/dist/esm/v2/utils/cx.js.map

@@ -1 +1 @@
-{"version":3,"file":"cx.js","names":["cx","out","_len","arguments","length","args","Array","_key","_i","_args","a","push","String","isArray","apply","_toConsumableArray","_typeof","_i2","_Object$entries","Object","entries","_Object$entries$_i","_slicedToArray","k","v","join"],"sources":["../../../../src/lib/v2/utils/cx.ts"],"sourcesContent":["/**\r\n * cx — minimal classnames composer\r\n *\r\n *   cx(\"a\", cond && \"b\", { \"c\": isC })  →  \"a b c\"\r\n */\r\ntype ClassValue =\r\n  | string\r\n  | number\r\n  | null\r\n  | undefined\r\n  | boolean\r\n  | ClassValue[]\r\n  | Record<string, unknown>;\r\n\r\nexport function cx(...args: ClassValue[]): string {\r\n  const out: string[] = [];\r\n  for (const a of args) {\r\n    if (!a) continue;\r\n    if (typeof a === \"string\" || typeof a === \"number\") out.push(String(a));\r\n    else if (Array.isArray(a)) out.push(cx(...a));\r\n    else if (typeof a === \"object\") {\r\n      for (const [k, v] of Object.entries(a)) if (v) out.push(k);\r\n    }\r\n  }\r\n  return out.join(\" \");\r\n}\r\n\r\nexport default cx;\r\n"],"mappings":";;;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;;AAUA,OAAO,SAASA,EAAEA,CAAA,EAAgC;EAChD,IAAMC,GAAa,GAAG,EAAE;EAAC,SAAAC,IAAA,GAAAC,SAAA,CAAAC,MAAA,EADLC,IAAI,OAAAC,KAAA,CAAAJ,IAAA,GAAAK,IAAA,MAAAA,IAAA,GAAAL,IAAA,EAAAK,IAAA;IAAJF,IAAI,CAAAE,IAAA,IAAAJ,SAAA,CAAAI,IAAA;EAAA;EAExB,SAAAC,EAAA,MAAAC,KAAA,GAAgBJ,IAAI,EAAAG,EAAA,GAAAC,KAAA,CAAAL,MAAA,EAAAI,EAAA,IAAE;IAAjB,IAAME,CAAC,GAAAD,KAAA,CAAAD,EAAA;IACV,IAAI,CAACE,CAAC,EAAE;IACR,IAAI,OAAOA,CAAC,KAAK,QAAQ,IAAI,OAAOA,CAAC,KAAK,QAAQ,EAAET,GAAG,CAACU,IAAI,CAACC,MAAM,CAACF,CAAC,CAAC,CAAC,CAAC,KACnE,IAAIJ,KAAK,CAACO,OAAO,CAACH,CAAC,CAAC,EAAET,GAAG,CAACU,IAAI,CAACX,EAAE,CAAAc,KAAA,SAAAC,kBAAA,CAAIL,CAAC,EAAC,CAAC,CAAC,KACzC,IAAIM,OAAA,CAAON,CAAC,MAAK,QAAQ,EAAE;MAC9B,SAAAO,GAAA,MAAAC,eAAA,GAAqBC,MAAM,CAACC,OAAO,CAACV,CAAC,CAAC,EAAAO,GAAA,GAAAC,eAAA,CAAAd,MAAA,EAAAa,GAAA;QAAjC,IAAAI,kBAAA,GAAAC,cAAA,CAAAJ,eAAA,CAAAD,GAAA;UAAOM,CAAC,GAAAF,kBAAA;UAAEG,CAAC,GAAAH,kBAAA;QAAwB,IAAIG,CAAC,EAAEvB,GAAG,CAACU,IAAI,CAACY,CAAC,CAAC;MAAC;IAC7D;EACF;EACA,OAAOtB,GAAG,CAACwB,IAAI,CAAC,GAAG,CAAC;AACtB;AAEA,eAAezB,EAAE","ignoreList":[]}
+{"version":3,"file":"cx.js","names":["cx","args","out","a","push","String","Array","isArray","k","v","Object","entries","join"],"sources":["../../../../src/lib/v2/utils/cx.ts"],"sourcesContent":["/**\r\n * cx — minimal classnames composer\r\n *\r\n *   cx(\"a\", cond && \"b\", { \"c\": isC })  →  \"a b c\"\r\n */\r\ntype ClassValue =\r\n  | string\r\n  | number\r\n  | null\r\n  | undefined\r\n  | boolean\r\n  | ClassValue[]\r\n  | Record<string, unknown>;\r\n\r\nexport function cx(...args: ClassValue[]): string {\r\n  const out: string[] = [];\r\n  for (const a of args) {\r\n    if (!a) continue;\r\n    if (typeof a === \"string\" || typeof a === \"number\") out.push(String(a));\r\n    else if (Array.isArray(a)) out.push(cx(...a));\r\n    else if (typeof a === \"object\") {\r\n      for (const [k, v] of Object.entries(a)) if (v) out.push(k);\r\n    }\r\n  }\r\n  return out.join(\" \");\r\n}\r\n\r\nexport default cx;\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;;AAUA,OAAO,SAASA,EAAEA,CAAC,GAAGC,IAAkB,EAAU;EAChD,MAAMC,GAAa,GAAG,EAAE;EACxB,KAAK,MAAMC,CAAC,IAAIF,IAAI,EAAE;IACpB,IAAI,CAACE,CAAC,EAAE;IACR,IAAI,OAAOA,CAAC,KAAK,QAAQ,IAAI,OAAOA,CAAC,KAAK,QAAQ,EAAED,GAAG,CAACE,IAAI,CAACC,MAAM,CAACF,CAAC,CAAC,CAAC,CAAC,KACnE,IAAIG,KAAK,CAACC,OAAO,CAACJ,CAAC,CAAC,EAAED,GAAG,CAACE,IAAI,CAACJ,EAAE,CAAC,GAAGG,CAAC,CAAC,CAAC,CAAC,KACzC,IAAI,OAAOA,CAAC,KAAK,QAAQ,EAAE;MAC9B,KAAK,MAAM,CAACK,CAAC,EAAEC,CAAC,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACR,CAAC,CAAC,EAAE,IAAIM,CAAC,EAAEP,GAAG,CAACE,IAAI,CAACI,CAAC,CAAC;IAC5D;EACF;EACA,OAAON,GAAG,CAACU,IAAI,CAAC,GAAG,CAAC;AACtB;AAEA,eAAeZ,EAAE","ignoreList":[]}

package/dist/esm/v2/utils/fileDownload.js

@@ -27,7 +27,7 @@
  * browser download the file rather than attempt to render it — the safe
  * default for an unknown payload.
  */
-var MIME_TYPES = Object.freeze({
+const MIME_TYPES = Object.freeze({
   // Documents
   pdf: "application/pdf",
   doc: "application/msword",
@@ -56,8 +56,7 @@ var MIME_TYPES = Object.freeze({
  * @returns The mapped MIME type, or "application/octet-stream".
  */
 export function getMimeType(extension) {
-  var _MIME_TYPES$extension;
-  return (_MIME_TYPES$extension = MIME_TYPES[extension.toLowerCase()]) !== null && _MIME_TYPES$extension !== void 0 ? _MIME_TYPES$extension : "application/octet-stream";
+  return MIME_TYPES[extension.toLowerCase()] ?? "application/octet-stream";
 }
 
 /**
@@ -81,15 +80,15 @@ export function downloadBase64File(base64Data, fileName, extension) {
   if (typeof document === "undefined" || typeof atob === "undefined") {
     return false;
   }
-  var url = null;
-  var link = null;
+  let url = null;
+  let link = null;
   try {
-    var binary = atob(base64Data);
-    var bytes = new Uint8Array(binary.length);
-    for (var i = 0; i < binary.length; i += 1) {
+    const binary = atob(base64Data);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1) {
       bytes[i] = binary.charCodeAt(i);
     }
-    var blob = new Blob([bytes], {
+    const blob = new Blob([bytes], {
       type: getMimeType(extension)
     });
     url = URL.createObjectURL(blob);
@@ -120,7 +119,7 @@ export function downloadBase64File(base64Data, fileName, extension) {
  * revoking early shows the user a blank tab, while being late costs one
  * short-lived blob.
  */
-var PREVIEW_REVOKE_DELAY_MS = 60000;
+const PREVIEW_REVOKE_DELAY_MS = 60_000;
 
 /**
  * Decode a base64 payload and open it in a new tab for preview.
@@ -150,22 +149,20 @@ export function openBase64FileInTab(base64Data, extension) {
   if (typeof window === "undefined" || typeof atob === "undefined") {
     return false;
   }
-  var url = null;
+  let url = null;
   try {
-    var binary = atob(base64Data);
-    var bytes = new Uint8Array(binary.length);
-    for (var i = 0; i < binary.length; i += 1) {
+    const binary = atob(base64Data);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1) {
       bytes[i] = binary.charCodeAt(i);
     }
-    var blob = new Blob([bytes], {
+    const blob = new Blob([bytes], {
       type: getMimeType(extension)
     });
     url = URL.createObjectURL(blob);
     window.open(url, "_blank", "noopener,noreferrer");
-    var revokeTarget = url;
-    window.setTimeout(function () {
-      return URL.revokeObjectURL(revokeTarget);
-    }, PREVIEW_REVOKE_DELAY_MS);
+    const revokeTarget = url;
+    window.setTimeout(() => URL.revokeObjectURL(revokeTarget), PREVIEW_REVOKE_DELAY_MS);
     return true;
   } catch (error) {
     // Revoke straight away here: nothing consumed the URL on this path.
@@ -197,8 +194,8 @@ export function downloadBlobFile(blob, fileName) {
   if (typeof document === "undefined" || typeof URL === "undefined") {
     return false;
   }
-  var url = null;
-  var link = null;
+  let url = null;
+  let link = null;
   try {
     url = URL.createObjectURL(blob);
     link = document.createElement("a");
@@ -216,11 +213,11 @@ export function downloadBlobFile(blob, fileName) {
     if (url) URL.revokeObjectURL(url);
   }
 }
-var fileDownloadApi = {
-  getMimeType: getMimeType,
-  downloadBase64File: downloadBase64File,
-  openBase64FileInTab: openBase64FileInTab,
-  downloadBlobFile: downloadBlobFile
+const fileDownloadApi = {
+  getMimeType,
+  downloadBase64File,
+  openBase64FileInTab,
+  downloadBlobFile
 };
 export default fileDownloadApi;
 //# sourceMappingURL=fileDownload.js.map

package/dist/esm/v2/utils/fileDownload.js.map

@@ -1 +1 @@
-{"version":3,"file":"fileDownload.js","names":["MIME_TYPES","Object","freeze","pdf","doc","docx","xls","xlsx","csv","txt","png","jpg","jpeg","gif","bmp","webp","svg","ico","tiff","tif","getMimeType","extension","_MIME_TYPES$extension","toLowerCase","downloadBase64File","base64Data","fileName","document","atob","url","link","binary","bytes","Uint8Array","length","i","charCodeAt","blob","Blob","type","URL","createObjectURL","createElement","href","download","body","appendChild","click","error","console","parentNode","removeChild","revokeObjectURL","PREVIEW_REVOKE_DELAY_MS","openBase64FileInTab","window","open","revokeTarget","setTimeout","downloadBlobFile","fileDownloadApi"],"sources":["../../../../src/lib/v2/utils/fileDownload.ts"],"sourcesContent":["/**\r\n * File download utilities — Portnet UI v2\r\n *\r\n * Turns a base64 payload from the API into a browser download. Every GU\r\n * module that lets a user retrieve an attached document needs this, and\r\n * before this file each one carried its own copy of the same\r\n * atob → Uint8Array → Blob → anchor sequence plus its own MIME map.\r\n *\r\n * DEPENDENCY-FREE ON PURPOSE. Multi-file (zip) bundling is deliberately NOT\r\n * here: it needs a zip library, and making that a hard dependency of the\r\n * design system would put it in every module's bundle against the\r\n * R-8.2 budget (180 KB gz initial JS) for a capability only\r\n * document-heavy modules use. If it is promoted later it belongs behind an\r\n * OPTIONAL peer dependency, the way PdfViewer sits behind pdfjs-dist and\r\n * @react-pdf-viewer/* in peerDependenciesMeta.\r\n *\r\n * Charter ref: §09.3 — the caller owns the user-facing message; these\r\n * return a boolean rather than throwing so a failure surfaces as copy\r\n * (R-4.4) instead of an unhandled rejection.\r\n */\r\n\r\n/**\r\n * Extension → MIME type for the formats the platform accepts as\r\n * attachments.\r\n *\r\n * Anything unmapped resolves to application/octet-stream, which makes the\r\n * browser download the file rather than attempt to render it — the safe\r\n * default for an unknown payload.\r\n */\r\nconst MIME_TYPES: Readonly<Record<string, string>> = Object.freeze({\r\n  // Documents\r\n  pdf: \"application/pdf\",\r\n  doc: \"application/msword\",\r\n  docx: \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\r\n  xls: \"application/vnd.ms-excel\",\r\n  xlsx: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\r\n  csv: \"text/csv\",\r\n  txt: \"text/plain\",\r\n\r\n  // Images\r\n  png: \"image/png\",\r\n  jpg: \"image/jpeg\",\r\n  jpeg: \"image/jpeg\",\r\n  gif: \"image/gif\",\r\n  bmp: \"image/bmp\",\r\n  webp: \"image/webp\",\r\n  svg: \"image/svg+xml\",\r\n  ico: \"image/x-icon\",\r\n  tiff: \"image/tiff\",\r\n  tif: \"image/tiff\",\r\n});\r\n\r\n/**\r\n * Resolve the MIME type for a file extension.\r\n *\r\n * @param extension - Extension WITHOUT a leading dot. Case-insensitive.\r\n * @returns The mapped MIME type, or \"application/octet-stream\".\r\n */\r\nexport function getMimeType(extension: string): string {\r\n  return MIME_TYPES[extension.toLowerCase()] ?? \"application/octet-stream\";\r\n}\r\n\r\n/**\r\n * Decode a base64 payload and hand it to the browser as a download.\r\n *\r\n * @param base64Data - Base64 WITHOUT a `data:` prefix, as the getFile /\r\n *                     downloadFile endpoints return it.\r\n * @param fileName   - Filename offered to the user. The extension is NOT\r\n *                     appended automatically; pass it already suffixed if\r\n *                     you want one.\r\n * @param extension  - Used only to resolve the Blob's MIME type.\r\n * @returns true on success; false if decoding failed or there is no DOM.\r\n *\r\n * @example\r\n * const ok = downloadBase64File(body.content, body.fileName, body.extension);\r\n * if (!ok) toast(\"Le téléchargement a échoué. Veuillez réessayer.\", \"error\");\r\n */\r\nexport function downloadBase64File(\r\n  base64Data: string,\r\n  fileName: string,\r\n  extension: string,\r\n): boolean {\r\n  // Guarded rather than assumed: this runs in jsdom under test and could be\r\n  // reached during SSR. The host modules' copies of this threw in both.\r\n  if (typeof document === \"undefined\" || typeof atob === \"undefined\") {\r\n    return false;\r\n  }\r\n\r\n  let url: string | null = null;\r\n  let link: HTMLAnchorElement | null = null;\r\n\r\n  try {\r\n    const binary = atob(base64Data);\r\n    const bytes = new Uint8Array(binary.length);\r\n    for (let i = 0; i < binary.length; i += 1) {\r\n      bytes[i] = binary.charCodeAt(i);\r\n    }\r\n\r\n    const blob = new Blob([bytes], { type: getMimeType(extension) });\r\n\r\n    url = URL.createObjectURL(blob);\r\n    link = document.createElement(\"a\");\r\n    link.href = url;\r\n    link.download = fileName;\r\n    document.body.appendChild(link);\r\n    link.click();\r\n    return true;\r\n  } catch (error) {\r\n    // eslint-disable-next-line no-console\r\n    console.error(\"[@portnet/ui] downloadBase64File failed:\", error);\r\n    return false;\r\n  } finally {\r\n    // finally, not the happy path: the host copies leaked both the anchor\r\n    // and the object URL whenever click() or appendChild threw.\r\n    if (link && link.parentNode) link.parentNode.removeChild(link);\r\n    if (url) URL.revokeObjectURL(url);\r\n  }\r\n}\r\n\r\n/**\r\n * Delay before revoking a preview's object URL.\r\n *\r\n * It CANNOT be revoked synchronously: the newly opened tab still has to fetch\r\n * the blob. There is no portable \"that tab finished loading\" signal for a blob\r\n * URL, so a timeout is the only cross-browser option. Deliberately generous:\r\n * revoking early shows the user a blank tab, while being late costs one\r\n * short-lived blob.\r\n */\r\nconst PREVIEW_REVOKE_DELAY_MS = 60_000;\r\n\r\n/**\r\n * Decode a base64 payload and open it in a new tab for preview.\r\n *\r\n * Companion to downloadBase64File: every document-bearing GU module offers a\r\n * « Visualiser » action next to « Télécharger », and each carried its own copy of\r\n * this atob -> Uint8Array -> Blob -> window.open sequence. NONE of those copies\r\n * revoked the object URL, so every preview leaked a blob for the lifetime of the\r\n * page.\r\n *\r\n * RETURN VALUE — read this before relying on it. `window.open` returns null BY\r\n * SPECIFICATION when \"noopener\" is set, so a blocked popup is indistinguishable\r\n * from a successful one. `true` therefore means \"decoded and the open call was\r\n * issued without throwing\" — NOT \"the tab is on screen\". Do not use it to claim\r\n * success to the user; use `false` to report a genuine failure (bad payload, no\r\n * DOM). Dropping \"noopener\" would make blocked-popup detection possible but\r\n * would hand the opened tab a window.opener reference — not a trade worth making\r\n * for a diagnostic.\r\n *\r\n * @param base64Data - Base64 WITHOUT a `data:` prefix.\r\n * @param extension  - Resolves the Blob MIME type. Required for inline\r\n *                     rendering: with the wrong type the browser downloads the\r\n *                     file instead of displaying it.\r\n * @returns false if there is no DOM or the payload could not be decoded.\r\n */\r\nexport function openBase64FileInTab(base64Data: string, extension: string): boolean {\r\n  if (typeof window === \"undefined\" || typeof atob === \"undefined\") {\r\n    return false;\r\n  }\r\n  let url: string | null = null;\r\n  try {\r\n    const binary = atob(base64Data);\r\n    const bytes = new Uint8Array(binary.length);\r\n    for (let i = 0; i < binary.length; i += 1) {\r\n      bytes[i] = binary.charCodeAt(i);\r\n    }\r\n    const blob = new Blob([bytes], { type: getMimeType(extension) });\r\n    url = URL.createObjectURL(blob);\r\n    window.open(url, \"_blank\", \"noopener,noreferrer\");\r\n    const revokeTarget = url;\r\n    window.setTimeout(() => URL.revokeObjectURL(revokeTarget), PREVIEW_REVOKE_DELAY_MS);\r\n    return true;\r\n  } catch (error) {\r\n    // Revoke straight away here: nothing consumed the URL on this path.\r\n    if (url) URL.revokeObjectURL(url);\r\n    // eslint-disable-next-line no-console\r\n    console.error(\"[@portnet/ui] openBase64FileInTab failed:\", error);\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Hand an already-materialised Blob to the browser as a download.\r\n *\r\n * Companion to downloadBase64File for endpoints that return a binary body\r\n * directly (axios `responseType: \"blob\"`) instead of base64 — Excel exports,\r\n * server-generated PDFs. Host modules built the anchor by hand for this too,\r\n * and every copy found so far never revoked the object URL.\r\n *\r\n * Revoked synchronously in `finally`, unlike openBase64FileInTab: a download is\r\n * snapshotted by the browser at click() time, so nothing needs the URL\r\n * afterwards — only a preview in another tab does.\r\n *\r\n * @param blob     - The payload. Its own `type` is used as-is; no MIME lookup,\r\n *                   the server already declared it.\r\n * @param fileName - Filename offered to the user, extension included.\r\n * @returns true on success; false if there is no DOM.\r\n */\r\nexport function downloadBlobFile(blob: Blob, fileName: string): boolean {\r\n  if (typeof document === \"undefined\" || typeof URL === \"undefined\") {\r\n    return false;\r\n  }\r\n  let url: string | null = null;\r\n  let link: HTMLAnchorElement | null = null;\r\n  try {\r\n    url = URL.createObjectURL(blob);\r\n    link = document.createElement(\"a\");\r\n    link.href = url;\r\n    link.download = fileName;\r\n    document.body.appendChild(link);\r\n    link.click();\r\n    return true;\r\n  } catch (error) {\r\n    // eslint-disable-next-line no-console\r\n    console.error(\"[@portnet/ui] downloadBlobFile failed:\", error);\r\n    return false;\r\n  } finally {\r\n    if (link && link.parentNode) link.parentNode.removeChild(link);\r\n    if (url) URL.revokeObjectURL(url);\r\n  }\r\n}\r\n\r\nconst fileDownloadApi = {\r\n  getMimeType,\r\n  downloadBase64File,\r\n  openBase64FileInTab,\r\n  downloadBlobFile,\r\n};\r\nexport default fileDownloadApi;\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"fileDownload.js","names":["MIME_TYPES","Object","freeze","pdf","doc","docx","xls","xlsx","csv","txt","png","jpg","jpeg","gif","bmp","webp","svg","ico","tiff","tif","getMimeType","extension","toLowerCase","downloadBase64File","base64Data","fileName","document","atob","url","link","binary","bytes","Uint8Array","length","i","charCodeAt","blob","Blob","type","URL","createObjectURL","createElement","href","download","body","appendChild","click","error","console","parentNode","removeChild","revokeObjectURL","PREVIEW_REVOKE_DELAY_MS","openBase64FileInTab","window","open","revokeTarget","setTimeout","downloadBlobFile","fileDownloadApi"],"sources":["../../../../src/lib/v2/utils/fileDownload.ts"],"sourcesContent":["/**\r\n * File download utilities — Portnet UI v2\r\n *\r\n * Turns a base64 payload from the API into a browser download. Every GU\r\n * module that lets a user retrieve an attached document needs this, and\r\n * before this file each one carried its own copy of the same\r\n * atob → Uint8Array → Blob → anchor sequence plus its own MIME map.\r\n *\r\n * DEPENDENCY-FREE ON PURPOSE. Multi-file (zip) bundling is deliberately NOT\r\n * here: it needs a zip library, and making that a hard dependency of the\r\n * design system would put it in every module's bundle against the\r\n * R-8.2 budget (180 KB gz initial JS) for a capability only\r\n * document-heavy modules use. If it is promoted later it belongs behind an\r\n * OPTIONAL peer dependency, the way PdfViewer sits behind pdfjs-dist and\r\n * @react-pdf-viewer/* in peerDependenciesMeta.\r\n *\r\n * Charter ref: §09.3 — the caller owns the user-facing message; these\r\n * return a boolean rather than throwing so a failure surfaces as copy\r\n * (R-4.4) instead of an unhandled rejection.\r\n */\r\n\r\n/**\r\n * Extension → MIME type for the formats the platform accepts as\r\n * attachments.\r\n *\r\n * Anything unmapped resolves to application/octet-stream, which makes the\r\n * browser download the file rather than attempt to render it — the safe\r\n * default for an unknown payload.\r\n */\r\nconst MIME_TYPES: Readonly<Record<string, string>> = Object.freeze({\r\n  // Documents\r\n  pdf: \"application/pdf\",\r\n  doc: \"application/msword\",\r\n  docx: \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\r\n  xls: \"application/vnd.ms-excel\",\r\n  xlsx: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\r\n  csv: \"text/csv\",\r\n  txt: \"text/plain\",\r\n\r\n  // Images\r\n  png: \"image/png\",\r\n  jpg: \"image/jpeg\",\r\n  jpeg: \"image/jpeg\",\r\n  gif: \"image/gif\",\r\n  bmp: \"image/bmp\",\r\n  webp: \"image/webp\",\r\n  svg: \"image/svg+xml\",\r\n  ico: \"image/x-icon\",\r\n  tiff: \"image/tiff\",\r\n  tif: \"image/tiff\",\r\n});\r\n\r\n/**\r\n * Resolve the MIME type for a file extension.\r\n *\r\n * @param extension - Extension WITHOUT a leading dot. Case-insensitive.\r\n * @returns The mapped MIME type, or \"application/octet-stream\".\r\n */\r\nexport function getMimeType(extension: string): string {\r\n  return MIME_TYPES[extension.toLowerCase()] ?? \"application/octet-stream\";\r\n}\r\n\r\n/**\r\n * Decode a base64 payload and hand it to the browser as a download.\r\n *\r\n * @param base64Data - Base64 WITHOUT a `data:` prefix, as the getFile /\r\n *                     downloadFile endpoints return it.\r\n * @param fileName   - Filename offered to the user. The extension is NOT\r\n *                     appended automatically; pass it already suffixed if\r\n *                     you want one.\r\n * @param extension  - Used only to resolve the Blob's MIME type.\r\n * @returns true on success; false if decoding failed or there is no DOM.\r\n *\r\n * @example\r\n * const ok = downloadBase64File(body.content, body.fileName, body.extension);\r\n * if (!ok) toast(\"Le téléchargement a échoué. Veuillez réessayer.\", \"error\");\r\n */\r\nexport function downloadBase64File(\r\n  base64Data: string,\r\n  fileName: string,\r\n  extension: string,\r\n): boolean {\r\n  // Guarded rather than assumed: this runs in jsdom under test and could be\r\n  // reached during SSR. The host modules' copies of this threw in both.\r\n  if (typeof document === \"undefined\" || typeof atob === \"undefined\") {\r\n    return false;\r\n  }\r\n\r\n  let url: string | null = null;\r\n  let link: HTMLAnchorElement | null = null;\r\n\r\n  try {\r\n    const binary = atob(base64Data);\r\n    const bytes = new Uint8Array(binary.length);\r\n    for (let i = 0; i < binary.length; i += 1) {\r\n      bytes[i] = binary.charCodeAt(i);\r\n    }\r\n\r\n    const blob = new Blob([bytes], { type: getMimeType(extension) });\r\n\r\n    url = URL.createObjectURL(blob);\r\n    link = document.createElement(\"a\");\r\n    link.href = url;\r\n    link.download = fileName;\r\n    document.body.appendChild(link);\r\n    link.click();\r\n    return true;\r\n  } catch (error) {\r\n    // eslint-disable-next-line no-console\r\n    console.error(\"[@portnet/ui] downloadBase64File failed:\", error);\r\n    return false;\r\n  } finally {\r\n    // finally, not the happy path: the host copies leaked both the anchor\r\n    // and the object URL whenever click() or appendChild threw.\r\n    if (link && link.parentNode) link.parentNode.removeChild(link);\r\n    if (url) URL.revokeObjectURL(url);\r\n  }\r\n}\r\n\r\n/**\r\n * Delay before revoking a preview's object URL.\r\n *\r\n * It CANNOT be revoked synchronously: the newly opened tab still has to fetch\r\n * the blob. There is no portable \"that tab finished loading\" signal for a blob\r\n * URL, so a timeout is the only cross-browser option. Deliberately generous:\r\n * revoking early shows the user a blank tab, while being late costs one\r\n * short-lived blob.\r\n */\r\nconst PREVIEW_REVOKE_DELAY_MS = 60_000;\r\n\r\n/**\r\n * Decode a base64 payload and open it in a new tab for preview.\r\n *\r\n * Companion to downloadBase64File: every document-bearing GU module offers a\r\n * « Visualiser » action next to « Télécharger », and each carried its own copy of\r\n * this atob -> Uint8Array -> Blob -> window.open sequence. NONE of those copies\r\n * revoked the object URL, so every preview leaked a blob for the lifetime of the\r\n * page.\r\n *\r\n * RETURN VALUE — read this before relying on it. `window.open` returns null BY\r\n * SPECIFICATION when \"noopener\" is set, so a blocked popup is indistinguishable\r\n * from a successful one. `true` therefore means \"decoded and the open call was\r\n * issued without throwing\" — NOT \"the tab is on screen\". Do not use it to claim\r\n * success to the user; use `false` to report a genuine failure (bad payload, no\r\n * DOM). Dropping \"noopener\" would make blocked-popup detection possible but\r\n * would hand the opened tab a window.opener reference — not a trade worth making\r\n * for a diagnostic.\r\n *\r\n * @param base64Data - Base64 WITHOUT a `data:` prefix.\r\n * @param extension  - Resolves the Blob MIME type. Required for inline\r\n *                     rendering: with the wrong type the browser downloads the\r\n *                     file instead of displaying it.\r\n * @returns false if there is no DOM or the payload could not be decoded.\r\n */\r\nexport function openBase64FileInTab(base64Data: string, extension: string): boolean {\r\n  if (typeof window === \"undefined\" || typeof atob === \"undefined\") {\r\n    return false;\r\n  }\r\n  let url: string | null = null;\r\n  try {\r\n    const binary = atob(base64Data);\r\n    const bytes = new Uint8Array(binary.length);\r\n    for (let i = 0; i < binary.length; i += 1) {\r\n      bytes[i] = binary.charCodeAt(i);\r\n    }\r\n    const blob = new Blob([bytes], { type: getMimeType(extension) });\r\n    url = URL.createObjectURL(blob);\r\n    window.open(url, \"_blank\", \"noopener,noreferrer\");\r\n    const revokeTarget = url;\r\n    window.setTimeout(() => URL.revokeObjectURL(revokeTarget), PREVIEW_REVOKE_DELAY_MS);\r\n    return true;\r\n  } catch (error) {\r\n    // Revoke straight away here: nothing consumed the URL on this path.\r\n    if (url) URL.revokeObjectURL(url);\r\n    // eslint-disable-next-line no-console\r\n    console.error(\"[@portnet/ui] openBase64FileInTab failed:\", error);\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Hand an already-materialised Blob to the browser as a download.\r\n *\r\n * Companion to downloadBase64File for endpoints that return a binary body\r\n * directly (axios `responseType: \"blob\"`) instead of base64 — Excel exports,\r\n * server-generated PDFs. Host modules built the anchor by hand for this too,\r\n * and every copy found so far never revoked the object URL.\r\n *\r\n * Revoked synchronously in `finally`, unlike openBase64FileInTab: a download is\r\n * snapshotted by the browser at click() time, so nothing needs the URL\r\n * afterwards — only a preview in another tab does.\r\n *\r\n * @param blob     - The payload. Its own `type` is used as-is; no MIME lookup,\r\n *                   the server already declared it.\r\n * @param fileName - Filename offered to the user, extension included.\r\n * @returns true on success; false if there is no DOM.\r\n */\r\nexport function downloadBlobFile(blob: Blob, fileName: string): boolean {\r\n  if (typeof document === \"undefined\" || typeof URL === \"undefined\") {\r\n    return false;\r\n  }\r\n  let url: string | null = null;\r\n  let link: HTMLAnchorElement | null = null;\r\n  try {\r\n    url = URL.createObjectURL(blob);\r\n    link = document.createElement(\"a\");\r\n    link.href = url;\r\n    link.download = fileName;\r\n    document.body.appendChild(link);\r\n    link.click();\r\n    return true;\r\n  } catch (error) {\r\n    // eslint-disable-next-line no-console\r\n    console.error(\"[@portnet/ui] downloadBlobFile failed:\", error);\r\n    return false;\r\n  } finally {\r\n    if (link && link.parentNode) link.parentNode.removeChild(link);\r\n    if (url) URL.revokeObjectURL(url);\r\n  }\r\n}\r\n\r\nconst fileDownloadApi = {\r\n  getMimeType,\r\n  downloadBase64File,\r\n  openBase64FileInTab,\r\n  downloadBlobFile,\r\n};\r\nexport default fileDownloadApi;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/utils/fileValidation.js

@@ -0,0 +1,209 @@
+/**
+ * fileValidation — is this file allowed to be uploaded?
+ *
+ *   const POLICY = { extensions: ["pdf", "png", "jpg", "jpeg", "doc", "docx"] };
+ *
+ *   const rejection = getFileRejection(file, POLICY);
+ *   if (rejection) toast(rejection.message, "error");
+ *
+ *   <Dropzone accept={toAcceptAttribute(POLICY.extensions)} … />
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-52)
+ *
+ * `Dropzone` takes an `accept` attribute and reports `DropzoneRejection`, but it
+ * validates nothing: the browser's `accept` is a FILE-PICKER FILTER, not a
+ * control. It is trivially bypassed — drag and drop ignores it, and so does
+ * "All files" in the picker on most platforms. So the library asked every host
+ * to decide, itself, whether a dropped file is acceptable, and every host wrote:
+ *
+ *   - an extension allow-list (business policy — rightly theirs), AND
+ *   - a deny-list of executables and scripts, AND
+ *   - an extension↔MIME cross-check with its browser tolerances.
+ *
+ * The last two are NOT business policy. They are one security decision, and a
+ * security decision copied into every module is a security decision that WILL
+ * drift: the day a file type has to be added to the deny-list, nobody can say
+ * which of the fifteen GU modules received it. Worse, divergence here is
+ * SILENT — a module missing an entry looks exactly like a module that has it,
+ * until something gets uploaded.
+ *
+ * So the split this file draws: the HOST owns which extensions its business
+ * accepts; the LIBRARY owns the executable deny-list and the MIME cross-check.
+ *
+ * Raised from `autorisation-admis-pour-conforme-fe` (Area 5), which carried a
+ * 21-entry executable deny-list and a six-extension MIME table locally.
+ *
+ * NOT A SUBSTITUTE FOR SERVER-SIDE VALIDATION, and this must stay written down:
+ * everything here runs in a browser the user controls. Its purpose is to give a
+ * CLEAR, IMMEDIATE reason (R-4.1, R-4.4) instead of a server rejection after a
+ * full upload. The back-end remains the authority.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+
+/**
+ * Executables, scripts and installers — refused whatever the host's policy says.
+ *
+ * Checked FIRST, and the order carries meaning: a `.exe` gets a message naming
+ * it as a dangerous file, not a vague "unsupported type", because those are not
+ * the same information for the person at the screen.
+ *
+ * Windows-centric because GU workstations are: PE binaries, the cmd/PowerShell
+ * script families, installer packages, and the HTML-application and
+ * control-panel shims that are executable despite innocuous extensions.
+ */
+const EXECUTABLE_EXTENSIONS = new Set(["exe", "dll", "bat", "cmd", "com", "pif", "scr", "msi", "msu", "msp", "vbs", "vbe", "jse", "wsf", "wsh", "ps1", "psm1", "psc1", "cpl", "msc", "hta"]);
+
+/**
+ * Accepted MIME types per extension.
+ *
+ * DELIBERATELY NOT `getMimeType` from ./fileDownload, though both map
+ * extensions to MIME types. That one answers "what type should I stamp on this
+ * Blob" — ONE canonical value. This one answers "what types may a browser
+ * plausibly report for this extension" — a SET, including variants no canonical
+ * table would contain (`image/jpg` is not a registered type, and browsers send
+ * it anyway). Collapsing the two would reject valid files.
+ */
+const MIME_BY_EXTENSION = Object.freeze({
+  pdf: ["application/pdf"],
+  png: ["image/png"],
+  jpg: ["image/jpeg", "image/jpg"],
+  jpeg: ["image/jpeg", "image/jpg"],
+  gif: ["image/gif"],
+  webp: ["image/webp"],
+  tif: ["image/tiff"],
+  tiff: ["image/tiff"],
+  txt: ["text/plain"],
+  csv: ["text/csv", "application/csv", "text/plain"],
+  doc: ["application/msword"],
+  docx: ["application/vnd.openxmlformats-officedocument.wordprocessingml.document"],
+  xls: ["application/vnd.ms-excel"],
+  xlsx: ["application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"],
+  ppt: ["application/vnd.ms-powerpoint"],
+  pptx: ["application/vnd.openxmlformats-officedocument.presentationml.presentation"]
+});
+
+/**
+ * Extensions whose reported MIME type cannot be trusted, so
+ * `application/octet-stream` is tolerated for them.
+ *
+ * WITHOUT THIS TOLERANCE A LEGITIMATE `.docx` IS REFUSED on some machines —
+ * Office documents are frequently reported as `application/octet-stream`
+ * depending on browser and OS, and the refusal would be INTERMITTENT, which is
+ * the hardest kind to diagnose from a support ticket. The extension has already
+ * been checked against the host's allow-list at that point, so the tolerance
+ * does not widen what is accepted, only what is believed.
+ */
+const UNRELIABLE_MIME_EXTENSIONS = new Set(["doc", "docx", "xls", "xlsx", "ppt", "pptx", "csv"]);
+
+/** Why a file was refused. `reason` is for branching and logs, not for display. */
+
+const DEFAULT_EXECUTABLE_MESSAGE = "Les fichiers exécutables, scripts et installeurs ne sont pas autorisés.";
+
+/** Lowercased extension of a file name, or `""` when there is none. */
+const extensionOf = fileName => {
+  if (!fileName) return "";
+  const parts = fileName.split(".");
+  /* A name with no dot has no extension: "rapport" must not be read as having
+     extension "rapport", which a bare `pop()` would do. */
+  if (parts.length < 2) return "";
+  return (parts[parts.length - 1] ?? "").toLowerCase();
+};
+
+/**
+ * Human list of the accepted types — "PDF, PNG, JPG, JPEG, DOC, DOCX."
+ *
+ * Order is the host's: the list is read by a person, and a host lists its most
+ * common format first for a reason. Sorting it here would silently reorder
+ * copy the host wrote deliberately.
+ */
+export function describeAcceptedTypes(extensions) {
+  return `${extensions.map(ext => ext.toUpperCase()).join(", ")}.`;
+}
+
+/**
+ * The `accept` attribute for an input or `Dropzone` — ".pdf,.png,.jpg".
+ *
+ * A picker filter, never a control: see the note on server-side validation in
+ * the file header.
+ */
+export function toAcceptAttribute(extensions) {
+  return extensions.map(ext => `.${ext.toLowerCase()}`).join(",");
+}
+
+/**
+ * Is this an executable, a script or an installer?
+ *
+ * Exported on its own because a host may want to refuse those EARLIER than its
+ * own policy check — on a bulk drop, for instance, where one dangerous file
+ * should stop the whole batch rather than be listed among type mismatches.
+ *
+ * Permissive parameter type on purpose: callers routinely pass an item pulled
+ * out of a `FileList` without having checked it.
+ */
+export function isForbiddenExecutable(file) {
+  const ext = extensionOf(file?.name);
+  return ext !== "" && EXECUTABLE_EXTENSIONS.has(ext);
+}
+
+/** Does the file satisfy `policy` (and the library's own deny-list)? */
+export function isAcceptedFile(file, policy) {
+  return getFileRejection(file, policy) === null;
+}
+
+/**
+ * Why this file cannot be uploaded, or `null` when it can.
+ *
+ * Order of checks is load-bearing:
+ *   1. executable / script / installer — named as such;
+ *   2. extension against the host's allow-list;
+ *   3. reported MIME type against the extension.
+ *
+ * MIME RULES, both deliberate: an EMPTY type is accepted (some browsers report
+ * none, and the extension has just been checked), and `application/octet-stream`
+ * is accepted for the extensions listed in `UNRELIABLE_MIME_EXTENSIONS`. An
+ * extension with no entry in the MIME table is accepted on its extension alone
+ * — the table is a cross-check, not a second allow-list, and a host adding a
+ * format to its policy must not have it refused by a table it cannot see.
+ */
+export function getFileRejection(file, policy) {
+  const executableMessage = policy.labels?.executable ?? DEFAULT_EXECUTABLE_MESSAGE;
+  const typeMessage = policy.labels?.type ?? `Types autorisés : ${describeAcceptedTypes(policy.extensions)}`;
+  if (isForbiddenExecutable(file)) {
+    return {
+      reason: "executable",
+      message: executableMessage
+    };
+  }
+  const ext = extensionOf(file?.name);
+  if (ext === "") return {
+    reason: "extension",
+    message: typeMessage
+  };
+  const accepted = policy.extensions.some(allowed => allowed.toLowerCase() === ext);
+  if (!accepted) return {
+    reason: "extension",
+    message: typeMessage
+  };
+  const mime = (file?.type ?? "").trim().toLowerCase();
+  if (mime === "") return null;
+  if (mime === "application/octet-stream" && UNRELIABLE_MIME_EXTENSIONS.has(ext)) {
+    return null;
+  }
+  const expected = MIME_BY_EXTENSION[ext];
+  if (expected === undefined) return null;
+  if (expected.includes(mime)) return null;
+  return {
+    reason: "mime",
+    message: typeMessage
+  };
+}
+const fileValidationApi = {
+  isForbiddenExecutable,
+  isAcceptedFile,
+  getFileRejection,
+  describeAcceptedTypes,
+  toAcceptAttribute
+};
+export default fileValidationApi;
+//# sourceMappingURL=fileValidation.js.map