@portnet/ui 5.0.28 → 6.0.0

package/dist/v2/utils/fmtMoney.d.ts

@@ -0,0 +1,28 @@
+/**
+ * fmtMoney — format a number with locale-aware grouping.
+ *
+ * Returns "—" for null / empty / non-finite inputs (graceful empty
+ * cells in tables — never "NaN" or "∞").
+ *
+ * Defaults to "fr-FR" for back-compat with v1 callers; pass `locale`
+ * (BCP-47 tag) to format under any locale supported by the runtime
+ * Intl.NumberFormat. Currency placement is a trailing suffix in the
+ * locale-formatted number; future evolution toward `style:"currency"`
+ * (locale-correct symbol position, proper RTL handling) is deliberately
+ * deferred to avoid breaking consumers that grep on the suffix.
+ *
+ *   fmtMoney(1234567.5)                              → "1 234 567,5"
+ *   fmtMoney(1234567.5, "EUR")                       → "1 234 567,5 EUR"
+ *   fmtMoney(1234567.5, "EUR", { locale: "en-US" })  → "1,234,567.5 EUR"
+ *   fmtMoney(1234.5,    "",    { minimumFractionDigits: 2 })
+ *                                                    → "1 234,50"
+ *   fmtMoney(null) / fmtMoney("abc") / fmtMoney(Infinity) → "—"
+ */
+type FmtMoneyOptions = {
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+};
+export default function fmtMoney(n: number | string | null | undefined, currency?: string, opts?: FmtMoneyOptions): string;
+export {};
+//# sourceMappingURL=fmtMoney.d.ts.map

package/dist/v2/utils/fmtMoney.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fmtMoney.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/utils/fmtMoney.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,KAAK,eAAe,GAAG;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AA+BF,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC9B,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,QAAQ,GAAE,MAAW,EACrB,IAAI,GAAE,eAAoB,GACzB,MAAM,CAgCR"}

package/dist/v2/utils/fmtMoney.js

@@ -0,0 +1,84 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = fmtMoney;
+/**
+ * fmtMoney — format a number with locale-aware grouping.
+ *
+ * Returns "—" for null / empty / non-finite inputs (graceful empty
+ * cells in tables — never "NaN" or "∞").
+ *
+ * Defaults to "fr-FR" for back-compat with v1 callers; pass `locale`
+ * (BCP-47 tag) to format under any locale supported by the runtime
+ * Intl.NumberFormat. Currency placement is a trailing suffix in the
+ * locale-formatted number; future evolution toward `style:"currency"`
+ * (locale-correct symbol position, proper RTL handling) is deliberately
+ * deferred to avoid breaking consumers that grep on the suffix.
+ *
+ *   fmtMoney(1234567.5)                              → "1 234 567,5"
+ *   fmtMoney(1234567.5, "EUR")                       → "1 234 567,5 EUR"
+ *   fmtMoney(1234567.5, "EUR", { locale: "en-US" })  → "1,234,567.5 EUR"
+ *   fmtMoney(1234.5,    "",    { minimumFractionDigits: 2 })
+ *                                                    → "1 234,50"
+ *   fmtMoney(null) / fmtMoney("abc") / fmtMoney(Infinity) → "—"
+ */
+
+/**
+ * The locale every unresolvable request falls back to.
+ *
+ * ── WHY THIS IS NEGOTIATED, NOT JUST CAUGHT ─────────────────────────────
+ *
+ * The previous implementation relied ONLY on `try/catch`, on the assumption that
+ * an unusable locale throws `RangeError`. It does not — and the gap was a live
+ * defect, not a theoretical one:
+ *
+ *   `Intl.NumberFormat` throws only on a STRUCTURALLY INVALID tag. A tag that is
+ *   well-formed but has no data does NOT throw — it negotiates, and with a single
+ *   unmatched tag the negotiation lands on the RUNTIME DEFAULT LOCALE.
+ *
+ * `"not-a-real-locale"` is well-formed: `not` parses as a 3-letter language
+ * subtag and `-a-real-locale` as a singleton `a` extension sequence. So it never
+ * threw, the `catch` never ran, and the result was formatted in whatever locale
+ * the host happened to default to. On a German or Spanish host that renders
+ * `"1.234,5"` — dot grouping — inside a French application.
+ *
+ * That is a real consistency breach (Charter §09: a French UI formats numbers in
+ * French), and it is invisible on a French dev machine, which is exactly why it
+ * survived: the unit test caught it only because CI ran under a non-FR default.
+ *
+ * Listing the fallback as the SECOND preference makes the guarantee explicit:
+ * an unmatched-but-valid tag negotiates down to fr-FR instead of to the host.
+ * The `try/catch` is still required for genuinely malformed input.
+ */
+var FALLBACK_LOCALE = "fr-FR";
+function fmtMoney(n) {
+  var currency = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "";
+  var opts = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  if (n == null || n === "") return "—";
+  var num = typeof n === "number" ? n : Number(n);
+  if (!Number.isFinite(num)) return "—";
+  var locale = opts.locale || FALLBACK_LOCALE;
+  var formatOpts = {};
+  if (opts.minimumFractionDigits != null) {
+    formatOpts.minimumFractionDigits = opts.minimumFractionDigits;
+  }
+  if (opts.maximumFractionDigits != null) {
+    formatOpts.maximumFractionDigits = opts.maximumFractionDigits;
+  }
+  var formatted;
+  try {
+    /* Requested locale first, fr-FR as the declared next preference — see
+     * FALLBACK_LOCALE. A resolvable request ("en-US") still wins outright; an
+     * unmatched-but-well-formed tag lands on fr-FR rather than on the host's
+     * default locale. */
+    formatted = new Intl.NumberFormat([locale, FALLBACK_LOCALE], formatOpts).format(num);
+  } catch (_unused) {
+    /* Reached only for a STRUCTURALLY invalid tag (RangeError) or a non-string
+     * value from an untyped host — negotiation cannot help there. */
+    formatted = new Intl.NumberFormat(FALLBACK_LOCALE, formatOpts).format(num);
+  }
+  return currency ? "".concat(formatted, " ").concat(currency) : formatted;
+}
+//# sourceMappingURL=fmtMoney.js.map

package/dist/v2/utils/fmtMoney.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fmtMoney.js","names":["FALLBACK_LOCALE","fmtMoney","n","currency","arguments","length","undefined","opts","num","Number","isFinite","locale","formatOpts","minimumFractionDigits","maximumFractionDigits","formatted","Intl","NumberFormat","format","_unused","concat"],"sources":["../../../src/lib/v2/utils/fmtMoney.ts"],"sourcesContent":["/**\r\n * fmtMoney — format a number with locale-aware grouping.\r\n *\r\n * Returns \"—\" for null / empty / non-finite inputs (graceful empty\r\n * cells in tables — never \"NaN\" or \"∞\").\r\n *\r\n * Defaults to \"fr-FR\" for back-compat with v1 callers; pass `locale`\r\n * (BCP-47 tag) to format under any locale supported by the runtime\r\n * Intl.NumberFormat. Currency placement is a trailing suffix in the\r\n * locale-formatted number; future evolution toward `style:\"currency\"`\r\n * (locale-correct symbol position, proper RTL handling) is deliberately\r\n * deferred to avoid breaking consumers that grep on the suffix.\r\n *\r\n *   fmtMoney(1234567.5)                              → \"1 234 567,5\"\r\n *   fmtMoney(1234567.5, \"EUR\")                       → \"1 234 567,5 EUR\"\r\n *   fmtMoney(1234567.5, \"EUR\", { locale: \"en-US\" })  → \"1,234,567.5 EUR\"\r\n *   fmtMoney(1234.5,    \"\",    { minimumFractionDigits: 2 })\r\n *                                                    → \"1 234,50\"\r\n *   fmtMoney(null) / fmtMoney(\"abc\") / fmtMoney(Infinity) → \"—\"\r\n */\r\ntype FmtMoneyOptions = {\r\n  locale?: string;\r\n  minimumFractionDigits?: number;\r\n  maximumFractionDigits?: number;\r\n};\r\n\r\n/**\r\n * The locale every unresolvable request falls back to.\r\n *\r\n * ── WHY THIS IS NEGOTIATED, NOT JUST CAUGHT ─────────────────────────────\r\n *\r\n * The previous implementation relied ONLY on `try/catch`, on the assumption that\r\n * an unusable locale throws `RangeError`. It does not — and the gap was a live\r\n * defect, not a theoretical one:\r\n *\r\n *   `Intl.NumberFormat` throws only on a STRUCTURALLY INVALID tag. A tag that is\r\n *   well-formed but has no data does NOT throw — it negotiates, and with a single\r\n *   unmatched tag the negotiation lands on the RUNTIME DEFAULT LOCALE.\r\n *\r\n * `\"not-a-real-locale\"` is well-formed: `not` parses as a 3-letter language\r\n * subtag and `-a-real-locale` as a singleton `a` extension sequence. So it never\r\n * threw, the `catch` never ran, and the result was formatted in whatever locale\r\n * the host happened to default to. On a German or Spanish host that renders\r\n * `\"1.234,5\"` — dot grouping — inside a French application.\r\n *\r\n * That is a real consistency breach (Charter §09: a French UI formats numbers in\r\n * French), and it is invisible on a French dev machine, which is exactly why it\r\n * survived: the unit test caught it only because CI ran under a non-FR default.\r\n *\r\n * Listing the fallback as the SECOND preference makes the guarantee explicit:\r\n * an unmatched-but-valid tag negotiates down to fr-FR instead of to the host.\r\n * The `try/catch` is still required for genuinely malformed input.\r\n */\r\nconst FALLBACK_LOCALE = \"fr-FR\";\r\n\r\nexport default function fmtMoney(\r\n  n: number | string | null | undefined,\r\n  currency: string = \"\",\r\n  opts: FmtMoneyOptions = {}\r\n): string {\r\n  if (n == null || n === \"\") return \"—\";\r\n  const num = typeof n === \"number\" ? n : Number(n);\r\n  if (!Number.isFinite(num)) return \"—\";\r\n\r\n  const locale = opts.locale || FALLBACK_LOCALE;\r\n\r\n  const formatOpts: Intl.NumberFormatOptions = {};\r\n  if (opts.minimumFractionDigits != null) {\r\n    formatOpts.minimumFractionDigits = opts.minimumFractionDigits;\r\n  }\r\n  if (opts.maximumFractionDigits != null) {\r\n    formatOpts.maximumFractionDigits = opts.maximumFractionDigits;\r\n  }\r\n\r\n  let formatted: string;\r\n  try {\r\n    /* Requested locale first, fr-FR as the declared next preference — see\r\n     * FALLBACK_LOCALE. A resolvable request (\"en-US\") still wins outright; an\r\n     * unmatched-but-well-formed tag lands on fr-FR rather than on the host's\r\n     * default locale. */\r\n    formatted = new Intl.NumberFormat(\r\n      [locale, FALLBACK_LOCALE],\r\n      formatOpts\r\n    ).format(num);\r\n  } catch {\r\n    /* Reached only for a STRUCTURALLY invalid tag (RangeError) or a non-string\r\n     * value from an untyped host — negotiation cannot help there. */\r\n    formatted = new Intl.NumberFormat(FALLBACK_LOCALE, formatOpts).format(num);\r\n  }\r\n\r\n  return currency ? `${formatted} ${currency}` : formatted;\r\n}\r\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAMA,eAAe,GAAG,OAAO;AAEhB,SAASC,QAAQA,CAC9BC,CAAqC,EAG7B;EAAA,IAFRC,QAAgB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,EAAE;EAAA,IACrBG,IAAqB,GAAAH,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAE1B,IAAIF,CAAC,IAAI,IAAI,IAAIA,CAAC,KAAK,EAAE,EAAE,OAAO,GAAG;EACrC,IAAMM,GAAG,GAAG,OAAON,CAAC,KAAK,QAAQ,GAAGA,CAAC,GAAGO,MAAM,CAACP,CAAC,CAAC;EACjD,IAAI,CAACO,MAAM,CAACC,QAAQ,CAACF,GAAG,CAAC,EAAE,OAAO,GAAG;EAErC,IAAMG,MAAM,GAAGJ,IAAI,CAACI,MAAM,IAAIX,eAAe;EAE7C,IAAMY,UAAoC,GAAG,CAAC,CAAC;EAC/C,IAAIL,IAAI,CAACM,qBAAqB,IAAI,IAAI,EAAE;IACtCD,UAAU,CAACC,qBAAqB,GAAGN,IAAI,CAACM,qBAAqB;EAC/D;EACA,IAAIN,IAAI,CAACO,qBAAqB,IAAI,IAAI,EAAE;IACtCF,UAAU,CAACE,qBAAqB,GAAGP,IAAI,CAACO,qBAAqB;EAC/D;EAEA,IAAIC,SAAiB;EACrB,IAAI;IACF;AACJ;AACA;AACA;IACIA,SAAS,GAAG,IAAIC,IAAI,CAACC,YAAY,CAC/B,CAACN,MAAM,EAAEX,eAAe,CAAC,EACzBY,UACF,CAAC,CAACM,MAAM,CAACV,GAAG,CAAC;EACf,CAAC,CAAC,OAAAW,OAAA,EAAM;IACN;AACJ;IACIJ,SAAS,GAAG,IAAIC,IAAI,CAACC,YAAY,CAACjB,eAAe,EAAEY,UAAU,CAAC,CAACM,MAAM,CAACV,GAAG,CAAC;EAC5E;EAEA,OAAOL,QAAQ,MAAAiB,MAAA,CAAML,SAAS,OAAAK,MAAA,CAAIjB,QAAQ,IAAKY,SAAS;AAC1D","ignoreList":[]}

package/dist/v2/utils/index.d.ts

@@ -0,0 +1,8 @@
+export { cx } from "./cx";
+export { default as fmtMoney } from "./fmtMoney";
+export { downloadBase64File, getMimeType, openBase64FileInTab, downloadBlobFile, } from "./fileDownload";
+export * as contrast from "./contrast";
+export { getApiErrorMessage, getApiErrorDetail, getApiErrorStatus, DEFAULT_API_ERROR_MESSAGE, } from "./apiError";
+export { networkStatus, createNetworkStatus } from "./networkStatus";
+export type { NetworkStatus, NetworkStatusListener } from "./networkStatus";
+//# sourceMappingURL=index.d.ts.map

package/dist/v2/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAuB,MAAM,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMjD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAavC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/v2/utils/index.js

@@ -0,0 +1,90 @@
+"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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "DEFAULT_API_ERROR_MESSAGE", {
+  enumerable: true,
+  get: function get() {
+    return _apiError.DEFAULT_API_ERROR_MESSAGE;
+  }
+});
+exports.contrast = void 0;
+Object.defineProperty(exports, "createNetworkStatus", {
+  enumerable: true,
+  get: function get() {
+    return _networkStatus.createNetworkStatus;
+  }
+});
+Object.defineProperty(exports, "cx", {
+  enumerable: true,
+  get: function get() {
+    return _cx.cx;
+  }
+});
+Object.defineProperty(exports, "downloadBase64File", {
+  enumerable: true,
+  get: function get() {
+    return _fileDownload.downloadBase64File;
+  }
+});
+Object.defineProperty(exports, "downloadBlobFile", {
+  enumerable: true,
+  get: function get() {
+    return _fileDownload.downloadBlobFile;
+  }
+});
+Object.defineProperty(exports, "fmtMoney", {
+  enumerable: true,
+  get: function get() {
+    return _fmtMoney["default"];
+  }
+});
+Object.defineProperty(exports, "getApiErrorDetail", {
+  enumerable: true,
+  get: function get() {
+    return _apiError.getApiErrorDetail;
+  }
+});
+Object.defineProperty(exports, "getApiErrorMessage", {
+  enumerable: true,
+  get: function get() {
+    return _apiError.getApiErrorMessage;
+  }
+});
+Object.defineProperty(exports, "getApiErrorStatus", {
+  enumerable: true,
+  get: function get() {
+    return _apiError.getApiErrorStatus;
+  }
+});
+Object.defineProperty(exports, "getMimeType", {
+  enumerable: true,
+  get: function get() {
+    return _fileDownload.getMimeType;
+  }
+});
+Object.defineProperty(exports, "networkStatus", {
+  enumerable: true,
+  get: function get() {
+    return _networkStatus.networkStatus;
+  }
+});
+Object.defineProperty(exports, "openBase64FileInTab", {
+  enumerable: true,
+  get: function get() {
+    return _fileDownload.openBase64FileInTab;
+  }
+});
+var _cx = require("./cx");
+var _fmtMoney = _interopRequireDefault(require("./fmtMoney"));
+var _fileDownload = require("./fileDownload");
+var _contrast = _interopRequireWildcard(require("./contrast"));
+exports.contrast = _contrast;
+var _apiError = require("./apiError");
+var _networkStatus = require("./networkStatus");
+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 _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+//# sourceMappingURL=index.js.map

package/dist/v2/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_cx","require","_fmtMoney","_interopRequireDefault","_fileDownload","_contrast","_interopRequireWildcard","exports","contrast","_apiError","_networkStatus","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","obj","__esModule","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set"],"sources":["../../../src/lib/v2/utils/index.ts"],"sourcesContent":["export { cx }                  from \"./cx\";\r\nexport { default as fmtMoney } from \"./fmtMoney\";\r\n\r\n// Base64 → browser download, plus the extension→MIME map it uses.\r\n// Flat named exports (not a namespace like contrast below): two\r\n// independent functions with no shared state, and downloadBase64File\r\n// is the common call site — qualifying it would only add noise.\r\nexport {\r\n  downloadBase64File,\r\n  getMimeType,\r\n  openBase64FileInTab,\r\n  downloadBlobFile,\r\n} from \"./fileDownload\";\r\n\r\n// WCAG 2.1 contrast utilities. Re-exported under a namespace at\r\n// the public barrel (v2.contrast.*) so the named API is grouped\r\n// and self-describing for callers — used to validate runtime\r\n// brand overrides against WCAG 1.4.3 and to audit dark-mode\r\n// token pairs (F29).\r\nexport * as contrast from \"./contrast\";\r\n\r\n// `unknown`-rejection narrowing. Mandated by the platform's own\r\n// `useUnknownInCatchVariables` flag, which makes `catch (e)` bind `unknown` in\r\n// every consuming saga while `any` and unsafe assertions stay forbidden — the\r\n// library previously left no sanctioned route between those two rules, and the\r\n// modules that filled the gap filled it with the forbidden construct.\r\n// Raised as capability gap G-04 (procuration-portnet-fe Area 5).\r\n//\r\n// `getApiErrorDetail` is the LOGGING counterpart added with G-07: since\r\n// `getApiErrorMessage` now suppresses axios transport phrasings so they cannot\r\n// reach a user (Charter §09.3), operators still need the unfiltered string for a\r\n// console or an APM breadcrumb. Display one, log the other.\r\nexport {\r\n  getApiErrorMessage,\r\n  getApiErrorDetail,\r\n  getApiErrorStatus,\r\n  DEFAULT_API_ERROR_MESSAGE,\r\n} from \"./apiError\";\r\n\r\n// The feed behind NetworkErrorBanner. The banner was exported without the\r\n// plumbing that decides when it shows, so every module rebuilt the same\r\n// subscribe/report/clear channel. Raised as capability gap G-03\r\n// (procuration-portnet-fe Area 5).\r\nexport { networkStatus, createNetworkStatus } from \"./networkStatus\";\r\nexport type { NetworkStatus, NetworkStatusListener } from \"./networkStatus\";\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,GAAA,GAAAC,OAAA;AACA,IAAAC,SAAA,GAAAC,sBAAA,CAAAF,OAAA;AAMA,IAAAG,aAAA,GAAAH,OAAA;AAKwB,IAAAI,SAAA,GAAAC,uBAAA,CAAAL,OAAA;AAAAM,OAAA,CAAAC,QAAA,GAAAH,SAAA;AAoBxB,IAAAI,SAAA,GAAAR,OAAA;AAWA,IAAAS,cAAA,GAAAT,OAAA;AAAqE,SAAAU,yBAAAC,WAAA,eAAAC,OAAA,kCAAAC,iBAAA,OAAAD,OAAA,QAAAE,gBAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,yBAAAC,WAAA,WAAAA,WAAA,GAAAG,gBAAA,GAAAD,iBAAA,KAAAF,WAAA;AAAA,SAAAN,wBAAAU,GAAA,EAAAJ,WAAA,SAAAA,WAAA,IAAAI,GAAA,IAAAA,GAAA,CAAAC,UAAA,WAAAD,GAAA,QAAAA,GAAA,aAAAE,OAAA,CAAAF,GAAA,yBAAAA,GAAA,uCAAAA,GAAA,UAAAG,KAAA,GAAAR,wBAAA,CAAAC,WAAA,OAAAO,KAAA,IAAAA,KAAA,CAAAC,GAAA,CAAAJ,GAAA,YAAAG,KAAA,CAAAE,GAAA,CAAAL,GAAA,SAAAM,MAAA,WAAAC,qBAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,GAAA,IAAAX,GAAA,QAAAW,GAAA,kBAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAd,GAAA,EAAAW,GAAA,SAAAI,IAAA,GAAAR,qBAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAV,GAAA,EAAAW,GAAA,cAAAI,IAAA,KAAAA,IAAA,CAAAV,GAAA,IAAAU,IAAA,CAAAC,GAAA,KAAAR,MAAA,CAAAC,cAAA,CAAAH,MAAA,EAAAK,GAAA,EAAAI,IAAA,YAAAT,MAAA,CAAAK,GAAA,IAAAX,GAAA,CAAAW,GAAA,SAAAL,MAAA,cAAAN,GAAA,MAAAG,KAAA,IAAAA,KAAA,CAAAa,GAAA,CAAAhB,GAAA,EAAAM,MAAA,YAAAA,MAAA;AAAA,SAAAnB,uBAAAa,GAAA,WAAAA,GAAA,IAAAA,GAAA,CAAAC,UAAA,GAAAD,GAAA,gBAAAA,GAAA","ignoreList":[]}

package/dist/v2/utils/networkStatus.d.ts

@@ -0,0 +1,88 @@
+/**
+ * networkStatus — the feed behind `NetworkErrorBanner`.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-03)
+ *
+ * The library shipped `NetworkErrorBanner` — a presentational component — but
+ * not the plumbing that decides when it appears. Charter R-A.3 / R-4.3 make the
+ * banner MANDATORY ("erreur réseau → bandeau persistant top, bouton
+ * « Réessayer »"), so every consuming module had to invent the same
+ * subscribe / report / clear singleton and the same transport-interceptor
+ * bridge. Two audited modules (`procuration-portnet-fe`, `procuration-fe`) had
+ * each written their own.
+ *
+ * A presentational component whose trigger contract is left to consumers
+ * guarantees divergence in precisely the state users encounter least often and
+ * trust least — the offline path.
+ *
+ * NOT a redux slice, deliberately
+ * -------------------------------
+ * This state is presentation-only and high-frequency on a flaky link. Crossing a
+ * dispatch boundary on every retry would slow the alert path for no benefit, and
+ * would force the library to take an opinion on the host's store.
+ *
+ * Late subscribers are hydrated on subscribe, so a banner that mounts after the
+ * failure (lazy route, remount) still shows the current state instead of missing
+ * the edge.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Wiring (once, at the app root):
+ *
+ *   const [netError, setNetError] = useState<string | null>(null);
+ *   useEffect(() => networkStatus.subscribe(setNetError), []);
+ *
+ *   <NetworkErrorBanner
+ *     visible={Boolean(netError)}
+ *     message={netError ?? ""}
+ *     onRetry={() => { networkStatus.clear(); window.location.reload(); }}
+ *   />
+ *
+ * And in the transport layer:
+ *
+ *   instance.interceptors.response.use(
+ *     (response) => { networkStatus.clear(); return response; },
+ *     (error: unknown) => {
+ *       if (getApiErrorStatus(error) === undefined) {
+ *         networkStatus.report("Connexion perdue. Vérifiez votre réseau, puis réessayez.");
+ *       }
+ *       return Promise.reject(error);
+ *     }
+ *   );
+ *
+ * A status-less failure is the network case (offline, DNS, ingress timeout); a
+ * failure WITH a status is a server error and belongs in a toast (R-A.4).
+ */
+/** Receives the latest banner message, or `null` when the banner should clear. */
+export type NetworkStatusListener = (message: string | null) => void;
+/** Public shape of a network-status channel. */
+export interface NetworkStatus {
+    /**
+     * Subscribe to changes. The listener is invoked immediately with the current
+     * state when that state is non-null, so a late-mounting banner hydrates
+     * instead of missing the transition. Returns an unsubscribe function suitable
+     * for returning directly from `useEffect`.
+     */
+    subscribe(listener: NetworkStatusListener): () => void;
+    /** Report a global network failure. `null` (or omitted) clears. */
+    report(message?: string | null): void;
+    /** Clear the banner. Equivalent to `report(null)`. */
+    clear(): void;
+    /** Current message, or `null`. Useful in tests and for SSR snapshots. */
+    current(): string | null;
+}
+/**
+ * Create an independent network-status channel.
+ *
+ * Exported alongside the shared singleton so tests can use an isolated instance
+ * — a module-level singleton shared between test cases leaks state across them.
+ * Application code should normally use the `networkStatus` export below.
+ */
+export declare function createNetworkStatus(): NetworkStatus;
+/**
+ * The shared channel. One per bundle, which is the right granularity: the
+ * transport layer and the banner must agree, and both live in the same app.
+ */
+export declare const networkStatus: NetworkStatus;
+export default networkStatus;
+//# sourceMappingURL=networkStatus.d.ts.map

package/dist/v2/utils/networkStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStatus.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/utils/networkStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,kFAAkF;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAErE,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAC;IACvD,mEAAmE;IACnE,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,sDAAsD;IACtD,KAAK,IAAI,IAAI,CAAC;IACd,yEAAyE;IACzE,OAAO,IAAI,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CA2CnD;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,aAAqC,CAAC;AAElE,eAAe,aAAa,CAAC"}

package/dist/v2/utils/networkStatus.js

@@ -0,0 +1,121 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createNetworkStatus = createNetworkStatus;
+exports.networkStatus = exports["default"] = void 0;
+/**
+ * networkStatus — the feed behind `NetworkErrorBanner`.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-03)
+ *
+ * The library shipped `NetworkErrorBanner` — a presentational component — but
+ * not the plumbing that decides when it appears. Charter R-A.3 / R-4.3 make the
+ * banner MANDATORY ("erreur réseau → bandeau persistant top, bouton
+ * « Réessayer »"), so every consuming module had to invent the same
+ * subscribe / report / clear singleton and the same transport-interceptor
+ * bridge. Two audited modules (`procuration-portnet-fe`, `procuration-fe`) had
+ * each written their own.
+ *
+ * A presentational component whose trigger contract is left to consumers
+ * guarantees divergence in precisely the state users encounter least often and
+ * trust least — the offline path.
+ *
+ * NOT a redux slice, deliberately
+ * -------------------------------
+ * This state is presentation-only and high-frequency on a flaky link. Crossing a
+ * dispatch boundary on every retry would slow the alert path for no benefit, and
+ * would force the library to take an opinion on the host's store.
+ *
+ * Late subscribers are hydrated on subscribe, so a banner that mounts after the
+ * failure (lazy route, remount) still shows the current state instead of missing
+ * the edge.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Wiring (once, at the app root):
+ *
+ *   const [netError, setNetError] = useState<string | null>(null);
+ *   useEffect(() => networkStatus.subscribe(setNetError), []);
+ *
+ *   <NetworkErrorBanner
+ *     visible={Boolean(netError)}
+ *     message={netError ?? ""}
+ *     onRetry={() => { networkStatus.clear(); window.location.reload(); }}
+ *   />
+ *
+ * And in the transport layer:
+ *
+ *   instance.interceptors.response.use(
+ *     (response) => { networkStatus.clear(); return response; },
+ *     (error: unknown) => {
+ *       if (getApiErrorStatus(error) === undefined) {
+ *         networkStatus.report("Connexion perdue. Vérifiez votre réseau, puis réessayez.");
+ *       }
+ *       return Promise.reject(error);
+ *     }
+ *   );
+ *
+ * A status-less failure is the network case (offline, DNS, ingress timeout); a
+ * failure WITH a status is a server error and belongs in a toast (R-A.4).
+ */
+
+/** Receives the latest banner message, or `null` when the banner should clear. */
+
+/** Public shape of a network-status channel. */
+
+/**
+ * Create an independent network-status channel.
+ *
+ * Exported alongside the shared singleton so tests can use an isolated instance
+ * — a module-level singleton shared between test cases leaks state across them.
+ * Application code should normally use the `networkStatus` export below.
+ */
+function createNetworkStatus() {
+  var subscribers = new Set();
+  var lastError = null;
+  var channel = {
+    subscribe: function subscribe(listener) {
+      subscribers.add(listener);
+      if (lastError !== null) listener(lastError);
+      return function () {
+        subscribers["delete"](listener);
+      };
+    },
+    report: function report(message) {
+      var next = message || null;
+      /* De-duplicated: a flaky link can fail many times per second, and
+       * re-notifying an unchanged message would re-render every subscriber for
+       * no visible difference. */
+      if (lastError === next) return;
+      lastError = next;
+      subscribers.forEach(function (listener) {
+        try {
+          listener(lastError);
+        } catch (e) {
+          /* One bad subscriber must not stop the others from being notified,
+           * and must not propagate into the transport layer that reported the
+           * failure. */
+          // eslint-disable-next-line no-console
+          console.error("[@portnet/ui networkStatus] subscriber threw:", e);
+        }
+      });
+    },
+    clear: function clear() {
+      channel.report(null);
+    },
+    current: function current() {
+      return lastError;
+    }
+  };
+  return channel;
+}
+
+/**
+ * The shared channel. One per bundle, which is the right granularity: the
+ * transport layer and the banner must agree, and both live in the same app.
+ */
+var networkStatus = exports.networkStatus = createNetworkStatus();
+var _default = exports["default"] = networkStatus;
+//# sourceMappingURL=networkStatus.js.map

package/dist/v2/utils/networkStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStatus.js","names":["createNetworkStatus","subscribers","Set","lastError","channel","subscribe","listener","add","report","message","next","forEach","e","console","error","clear","current","networkStatus","exports","_default"],"sources":["../../../src/lib/v2/utils/networkStatus.ts"],"sourcesContent":["/**\r\n * networkStatus — the feed behind `NetworkErrorBanner`.\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-03)\r\n *\r\n * The library shipped `NetworkErrorBanner` — a presentational component — but\r\n * not the plumbing that decides when it appears. Charter R-A.3 / R-4.3 make the\r\n * banner MANDATORY (\"erreur réseau → bandeau persistant top, bouton\r\n * « Réessayer »\"), so every consuming module had to invent the same\r\n * subscribe / report / clear singleton and the same transport-interceptor\r\n * bridge. Two audited modules (`procuration-portnet-fe`, `procuration-fe`) had\r\n * each written their own.\r\n *\r\n * A presentational component whose trigger contract is left to consumers\r\n * guarantees divergence in precisely the state users encounter least often and\r\n * trust least — the offline path.\r\n *\r\n * NOT a redux slice, deliberately\r\n * -------------------------------\r\n * This state is presentation-only and high-frequency on a flaky link. Crossing a\r\n * dispatch boundary on every retry would slow the alert path for no benefit, and\r\n * would force the library to take an opinion on the host's store.\r\n *\r\n * Late subscribers are hydrated on subscribe, so a banner that mounts after the\r\n * failure (lazy route, remount) still shows the current state instead of missing\r\n * the edge.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * Wiring (once, at the app root):\r\n *\r\n *   const [netError, setNetError] = useState<string | null>(null);\r\n *   useEffect(() => networkStatus.subscribe(setNetError), []);\r\n *\r\n *   <NetworkErrorBanner\r\n *     visible={Boolean(netError)}\r\n *     message={netError ?? \"\"}\r\n *     onRetry={() => { networkStatus.clear(); window.location.reload(); }}\r\n *   />\r\n *\r\n * And in the transport layer:\r\n *\r\n *   instance.interceptors.response.use(\r\n *     (response) => { networkStatus.clear(); return response; },\r\n *     (error: unknown) => {\r\n *       if (getApiErrorStatus(error) === undefined) {\r\n *         networkStatus.report(\"Connexion perdue. Vérifiez votre réseau, puis réessayez.\");\r\n *       }\r\n *       return Promise.reject(error);\r\n *     }\r\n *   );\r\n *\r\n * A status-less failure is the network case (offline, DNS, ingress timeout); a\r\n * failure WITH a status is a server error and belongs in a toast (R-A.4).\r\n */\r\n\r\n/** Receives the latest banner message, or `null` when the banner should clear. */\r\nexport type NetworkStatusListener = (message: string | null) => void;\r\n\r\n/** Public shape of a network-status channel. */\r\nexport interface NetworkStatus {\r\n  /**\r\n   * Subscribe to changes. The listener is invoked immediately with the current\r\n   * state when that state is non-null, so a late-mounting banner hydrates\r\n   * instead of missing the transition. Returns an unsubscribe function suitable\r\n   * for returning directly from `useEffect`.\r\n   */\r\n  subscribe(listener: NetworkStatusListener): () => void;\r\n  /** Report a global network failure. `null` (or omitted) clears. */\r\n  report(message?: string | null): void;\r\n  /** Clear the banner. Equivalent to `report(null)`. */\r\n  clear(): void;\r\n  /** Current message, or `null`. Useful in tests and for SSR snapshots. */\r\n  current(): string | null;\r\n}\r\n\r\n/**\r\n * Create an independent network-status channel.\r\n *\r\n * Exported alongside the shared singleton so tests can use an isolated instance\r\n * — a module-level singleton shared between test cases leaks state across them.\r\n * Application code should normally use the `networkStatus` export below.\r\n */\r\nexport function createNetworkStatus(): NetworkStatus {\r\n  const subscribers = new Set<NetworkStatusListener>();\r\n  let lastError: string | null = null;\r\n\r\n  const channel: NetworkStatus = {\r\n    subscribe(listener) {\r\n      subscribers.add(listener);\r\n      if (lastError !== null) listener(lastError);\r\n      return () => {\r\n        subscribers.delete(listener);\r\n      };\r\n    },\r\n\r\n    report(message) {\r\n      const next = message || null;\r\n      /* De-duplicated: a flaky link can fail many times per second, and\r\n       * re-notifying an unchanged message would re-render every subscriber for\r\n       * no visible difference. */\r\n      if (lastError === next) return;\r\n      lastError = next;\r\n      subscribers.forEach((listener) => {\r\n        try {\r\n          listener(lastError);\r\n        } catch (e) {\r\n          /* One bad subscriber must not stop the others from being notified,\r\n           * and must not propagate into the transport layer that reported the\r\n           * failure. */\r\n          // eslint-disable-next-line no-console\r\n          console.error(\"[@portnet/ui networkStatus] subscriber threw:\", e);\r\n        }\r\n      });\r\n    },\r\n\r\n    clear() {\r\n      channel.report(null);\r\n    },\r\n\r\n    current() {\r\n      return lastError;\r\n    },\r\n  };\r\n\r\n  return channel;\r\n}\r\n\r\n/**\r\n * The shared channel. One per bundle, which is the right granularity: the\r\n * transport layer and the banner must agree, and both live in the same app.\r\n */\r\nexport const networkStatus: NetworkStatus = createNetworkStatus();\r\n\r\nexport default networkStatus;\r\n"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAGA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,mBAAmBA,CAAA,EAAkB;EACnD,IAAMC,WAAW,GAAG,IAAIC,GAAG,CAAwB,CAAC;EACpD,IAAIC,SAAwB,GAAG,IAAI;EAEnC,IAAMC,OAAsB,GAAG;IAC7BC,SAAS,WAAAA,UAACC,QAAQ,EAAE;MAClBL,WAAW,CAACM,GAAG,CAACD,QAAQ,CAAC;MACzB,IAAIH,SAAS,KAAK,IAAI,EAAEG,QAAQ,CAACH,SAAS,CAAC;MAC3C,OAAO,YAAM;QACXF,WAAW,UAAO,CAACK,QAAQ,CAAC;MAC9B,CAAC;IACH,CAAC;IAEDE,MAAM,WAAAA,OAACC,OAAO,EAAE;MACd,IAAMC,IAAI,GAAGD,OAAO,IAAI,IAAI;MAC5B;AACN;AACA;MACM,IAAIN,SAAS,KAAKO,IAAI,EAAE;MACxBP,SAAS,GAAGO,IAAI;MAChBT,WAAW,CAACU,OAAO,CAAC,UAACL,QAAQ,EAAK;QAChC,IAAI;UACFA,QAAQ,CAACH,SAAS,CAAC;QACrB,CAAC,CAAC,OAAOS,CAAC,EAAE;UACV;AACV;AACA;UACU;UACAC,OAAO,CAACC,KAAK,CAAC,+CAA+C,EAAEF,CAAC,CAAC;QACnE;MACF,CAAC,CAAC;IACJ,CAAC;IAEDG,KAAK,WAAAA,MAAA,EAAG;MACNX,OAAO,CAACI,MAAM,CAAC,IAAI,CAAC;IACtB,CAAC;IAEDQ,OAAO,WAAAA,QAAA,EAAG;MACR,OAAOb,SAAS;IAClB;EACF,CAAC;EAED,OAAOC,OAAO;AAChB;;AAEA;AACA;AACA;AACA;AACO,IAAMa,aAA4B,GAAAC,OAAA,CAAAD,aAAA,GAAGjB,mBAAmB,CAAC,CAAC;AAAC,IAAAmB,QAAA,GAAAD,OAAA,cAEnDD,aAAa","ignoreList":[]}