@flipdish/ui-library 0.31.4 → 0.31.5

package/dist/utilities/hrefUtils/index.d.ts

@@ -1,19 +1,18 @@
 /**
- * Validates a consumer-supplied `href` for safe use on an anchor.
+ * Validates a consumer-supplied `href` before it reaches an anchor: strips control characters
+ * and rejects schemes outside http, https, mailto and tel, blocking `javascript:` and `data:`
+ * URLs.
  *
- * Strips ASCII control characters, then rejects any explicit scheme outside
- * http/https/mailto/tel — blocking `javascript:`, `data:` and friends. Scheme-less
- * values (relative paths, fragments, bare domains) are allowed.
- *
- * @returns the cleaned href, or `undefined` when the href is not allowed (rendering
- * an anchor with no `href` rather than an executable one).
+ * @param href The value a consumer passed, possibly from user or CMS data.
+ * @returns The cleaned href, or `undefined` when blocked so the anchor renders without one.
  */
 export declare const safeHref: (href: string | undefined) => string | undefined;
 /**
- * Whether an href points at an external site (http/https), for `target="_blank"`
- * decisions. Unlike a bare `startsWith('http')`, this requires a real scheme match on
- * the control-character-stripped value, so `javascript:` never classifies as internal
- * by falling through, and `httpfoo` never classifies as external.
+ * Whether an href points at an external http/https site, for `target="_blank"` decisions,
+ * matched on the real scheme so `javascript:` and `httpfoo` never misclassify.
+ *
+ * @param href The value to classify; control characters are stripped first.
+ * @returns `true` only for an explicit `http:` or `https:` scheme.
  */
 export declare const isExternalHref: (href: string | undefined) => boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/utilities/hrefUtils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/hrefUtils/index.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SAoB5D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,OAAgF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/hrefUtils/index.ts"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SAoB5D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,OAAgF,CAAC"}

package/dist/utilities/hrefUtils/index.js

@@ -8,14 +8,12 @@ const KNOWN_BLOCKED_SCHEMES = ['javascript:', 'data:', 'vbscript:', 'file:', 'bl
 // biome-ignore lint/suspicious/noControlCharactersInRegex: removing control characters is the point
 const CONTROL_CHARACTERS = /[\u0000-\u001F\u007F]/g;
 /**
- * Validates a consumer-supplied `href` for safe use on an anchor.
+ * Validates a consumer-supplied `href` before it reaches an anchor: strips control characters
+ * and rejects schemes outside http, https, mailto and tel, blocking `javascript:` and `data:`
+ * URLs.
  *
- * Strips ASCII control characters, then rejects any explicit scheme outside
- * http/https/mailto/tel — blocking `javascript:`, `data:` and friends. Scheme-less
- * values (relative paths, fragments, bare domains) are allowed.
- *
- * @returns the cleaned href, or `undefined` when the href is not allowed (rendering
- * an anchor with no `href` rather than an executable one).
+ * @param href The value a consumer passed, possibly from user or CMS data.
+ * @returns The cleaned href, or `undefined` when blocked so the anchor renders without one.
  */
 const safeHref = (href) => {
     if (href === undefined) {
@@ -36,10 +34,11 @@ const safeHref = (href) => {
     return cleaned;
 };
 /**
- * Whether an href points at an external site (http/https), for `target="_blank"`
- * decisions. Unlike a bare `startsWith('http')`, this requires a real scheme match on
- * the control-character-stripped value, so `javascript:` never classifies as internal
- * by falling through, and `httpfoo` never classifies as external.
+ * Whether an href points at an external http/https site, for `target="_blank"` decisions,
+ * matched on the real scheme so `javascript:` and `httpfoo` never misclassify.
+ *
+ * @param href The value to classify; control characters are stripped first.
+ * @returns `true` only for an explicit `http:` or `https:` scheme.
  */
 const isExternalHref = (href) => /^https?:/i.test((href ?? '').replace(CONTROL_CHARACTERS, '').trim());
 

package/dist/utilities/hrefUtils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/utilities/hrefUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;AAEhE;AACA,MAAM,qBAAqB,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;AAE7F;AACA;AACA;AACA,MAAM,kBAAkB,GAAG,wBAAwB;AAEnD;;;;;;;;;AASG;AACI,MAAM,QAAQ,GAAG,CAAC,IAAwB,KAAwB;AACvE,IAAA,IAAI,IAAI,KAAK,SAAS,EAAE;AACtB,QAAA,OAAO,SAAS;IAClB;IACA,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;AACpD,IAAA,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE;IAC7E,IAAI,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;;;;;;QAMjD,MAAM,KAAK,GAAG,qBAAqB,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpD,QAAQ,CACN,CAAA,SAAA,EAAY,KAAK,GAAG,MAAM,GAAG,cAAc,CAAA,CAAE,EAC7C,CAAA,8BAAA,EAAiC,KAAK,GAAG,CAAA,mBAAA,EAAsB,MAAM,CAAA,CAAA,CAAG,GAAG,0BAA0B,CAAA,4FAAA,CAA8F,CACpM;AACD,QAAA,OAAO,SAAS;IAClB;AACA,IAAA,OAAO,OAAO;AAChB;AAEA;;;;;AAKG;AACI,MAAM,cAAc,GAAG,CAAC,IAAwB,KAAc,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;;"}
+{"version":3,"file":"index.js","sources":["../../../src/utilities/hrefUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;AAEhE;AACA,MAAM,qBAAqB,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;AAE7F;AACA;AACA;AACA,MAAM,kBAAkB,GAAG,wBAAwB;AAEnD;;;;;;;AAOG;AACI,MAAM,QAAQ,GAAG,CAAC,IAAwB,KAAwB;AACvE,IAAA,IAAI,IAAI,KAAK,SAAS,EAAE;AACtB,QAAA,OAAO,SAAS;IAClB;IACA,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;AACpD,IAAA,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE;IAC7E,IAAI,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;;;;;;QAMjD,MAAM,KAAK,GAAG,qBAAqB,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpD,QAAQ,CACN,CAAA,SAAA,EAAY,KAAK,GAAG,MAAM,GAAG,cAAc,CAAA,CAAE,EAC7C,CAAA,8BAAA,EAAiC,KAAK,GAAG,CAAA,mBAAA,EAAsB,MAAM,CAAA,CAAA,CAAG,GAAG,0BAA0B,CAAA,4FAAA,CAA8F,CACpM;AACD,QAAA,OAAO,SAAS;IAClB;AACA,IAAA,OAAO,OAAO;AAChB;AAEA;;;;;;AAMG;AACI,MAAM,cAAc,GAAG,CAAC,IAAwB,KAAc,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;;"}

package/dist/utilities/localStorageUtils/index.cjs

@@ -14,12 +14,15 @@ var localStorageUtils_constants = require('./localStorageUtils.constants.cjs');
  * — check there for the full list before adding a new one.
  */
 /**
- * Build a typed, failure-safe accessor for a single `localStorage` key.
+ * Builds a typed, failure-safe accessor for a single `localStorage` key.
  *
- * @example
- * const draft = createLocalStorageItem<Draft>('fd-draft');
- * draft.set({ title: 'Hi' });
- * const value = draft.get(); // Draft | null
+ *   const draft = createLocalStorageItem<Draft>('fd-draft'); draft.set({ title: 'Hi' }); draft.get(); // Draft | null
+ *
+ * @param key The storage key; register it in `LOCAL_STORAGE_KEYS` first.
+ * @param options Custom `serialize`/`deserialize` and a `validate` guard; see
+ *   `LocalStorageItemOptions`.
+ * @returns `get`, `set` and `clear` that never throw; `get()` returns `null` when storage is
+ *   unavailable, while `set()` and `clear()` return `void` and ignore failures.
  */
 const createLocalStorageItem = (key, options = {}) => webStorage_utils.createWebStorageItem(() => window.localStorage, key, options);
 /**

package/dist/utilities/localStorageUtils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/utilities/localStorageUtils/index.ts"],"sourcesContent":[null],"names":["createWebStorageItem","LOCAL_STORAGE_KEYS","parseBooleanString","isBoolean","isString"],"mappings":";;;;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;AAOG;AACI,MAAM,sBAAsB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAsC,EAAE,KAC7FA,qCAAoB,CAAC,MAAM,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO;AAE9D;;;AAGG;MACU,uBAAuB,GAAG,sBAAsB,CAAUC,8CAAkB,CAAC,gBAAgB,EAAE;AAC1G,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAKC,mCAAkB,CAAC,GAAG,EAAE,iCAAiC,CAAC;AAChF,IAAA,QAAQ,EAAEC,0BAAS;AACpB,CAAA;AAED;MACa,gBAAgB,GAAG,sBAAsB,CAASF,8CAAkB,CAAC,SAAS,EAAE;AAC3F,IAAA,SAAS,EAAE,MAAM;AACjB,IAAA,WAAW,EAAE,CAAC,GAAG,KAAK,GAAG;AACzB,IAAA,QAAQ,EAAEG,yBAAQ;AACnB,CAAA;;;;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/localStorageUtils/index.ts"],"sourcesContent":[null],"names":["createWebStorageItem","LOCAL_STORAGE_KEYS","parseBooleanString","isBoolean","isString"],"mappings":";;;;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;;;;AAUG;AACI,MAAM,sBAAsB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAsC,EAAE,KAC7FA,qCAAoB,CAAC,MAAM,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO;AAE9D;;;AAGG;MACU,uBAAuB,GAAG,sBAAsB,CAAUC,8CAAkB,CAAC,gBAAgB,EAAE;AAC1G,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAKC,mCAAkB,CAAC,GAAG,EAAE,iCAAiC,CAAC;AAChF,IAAA,QAAQ,EAAEC,0BAAS;AACpB,CAAA;AAED;MACa,gBAAgB,GAAG,sBAAsB,CAASF,8CAAkB,CAAC,SAAS,EAAE;AAC3F,IAAA,SAAS,EAAE,MAAM;AACjB,IAAA,WAAW,EAAE,CAAC,GAAG,KAAK,GAAG;AACzB,IAAA,QAAQ,EAAEG,yBAAQ;AACnB,CAAA;;;;;"}

package/dist/utilities/localStorageUtils/index.d.ts

@@ -27,12 +27,15 @@ export interface LocalStorageItemOptions<T> {
     validate?: (value: unknown) => value is T;
 }
 /**
- * Build a typed, failure-safe accessor for a single `localStorage` key.
+ * Builds a typed, failure-safe accessor for a single `localStorage` key.
  *
- * @example
- * const draft = createLocalStorageItem<Draft>('fd-draft');
- * draft.set({ title: 'Hi' });
- * const value = draft.get(); // Draft | null
+ *   const draft = createLocalStorageItem<Draft>('fd-draft'); draft.set({ title: 'Hi' }); draft.get(); // Draft | null
+ *
+ * @param key The storage key; register it in `LOCAL_STORAGE_KEYS` first.
+ * @param options Custom `serialize`/`deserialize` and a `validate` guard; see
+ *   `LocalStorageItemOptions`.
+ * @returns `get`, `set` and `clear` that never throw; `get()` returns `null` when storage is
+ *   unavailable, while `set()` and `clear()` return `void` and ignore failures.
  */
 export declare const createLocalStorageItem: <T>(key: string, options?: LocalStorageItemOptions<T>) => LocalStorageItem<T>;
 /**

package/dist/utilities/localStorageUtils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/localStorageUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAI9B,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,gFAAgF;IAChF,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChB,wEAAwE;IACxE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAS,uBAAuB,CAAC,CAAC,CAAM,KAAG,gBAAgB,CAAC,CAAC,CACrD,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,2BAIlC,CAAC;AAEH,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,0BAI3B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/localStorageUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAI9B,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,gFAAgF;IAChF,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChB,wEAAwE;IACxE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAS,uBAAuB,CAAC,CAAC,CAAM,KAAG,gBAAgB,CAAC,CAAC,CACrD,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,2BAIlC,CAAC;AAEH,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,0BAI3B,CAAC"}

package/dist/utilities/localStorageUtils/index.js

@@ -12,12 +12,15 @@ import { LOCAL_STORAGE_KEYS } from './localStorageUtils.constants.js';
  * — check there for the full list before adding a new one.
  */
 /**
- * Build a typed, failure-safe accessor for a single `localStorage` key.
+ * Builds a typed, failure-safe accessor for a single `localStorage` key.
  *
- * @example
- * const draft = createLocalStorageItem<Draft>('fd-draft');
- * draft.set({ title: 'Hi' });
- * const value = draft.get(); // Draft | null
+ *   const draft = createLocalStorageItem<Draft>('fd-draft'); draft.set({ title: 'Hi' }); draft.get(); // Draft | null
+ *
+ * @param key The storage key; register it in `LOCAL_STORAGE_KEYS` first.
+ * @param options Custom `serialize`/`deserialize` and a `validate` guard; see
+ *   `LocalStorageItemOptions`.
+ * @returns `get`, `set` and `clear` that never throw; `get()` returns `null` when storage is
+ *   unavailable, while `set()` and `clear()` return `void` and ignore failures.
  */
 const createLocalStorageItem = (key, options = {}) => createWebStorageItem(() => window.localStorage, key, options);
 /**

package/dist/utilities/localStorageUtils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/utilities/localStorageUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;AAOG;AACI,MAAM,sBAAsB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAsC,EAAE,KAC7F,oBAAoB,CAAC,MAAM,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO;AAE9D;;;AAGG;MACU,uBAAuB,GAAG,sBAAsB,CAAU,kBAAkB,CAAC,gBAAgB,EAAE;AAC1G,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAK,kBAAkB,CAAC,GAAG,EAAE,iCAAiC,CAAC;AAChF,IAAA,QAAQ,EAAE,SAAS;AACpB,CAAA;AAED;MACa,gBAAgB,GAAG,sBAAsB,CAAS,kBAAkB,CAAC,SAAS,EAAE;AAC3F,IAAA,SAAS,EAAE,MAAM;AACjB,IAAA,WAAW,EAAE,CAAC,GAAG,KAAK,GAAG;AACzB,IAAA,QAAQ,EAAE,QAAQ;AACnB,CAAA;;"}
+{"version":3,"file":"index.js","sources":["../../../src/utilities/localStorageUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;;;;AAUG;AACI,MAAM,sBAAsB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAsC,EAAE,KAC7F,oBAAoB,CAAC,MAAM,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO;AAE9D;;;AAGG;MACU,uBAAuB,GAAG,sBAAsB,CAAU,kBAAkB,CAAC,gBAAgB,EAAE;AAC1G,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAK,kBAAkB,CAAC,GAAG,EAAE,iCAAiC,CAAC;AAChF,IAAA,QAAQ,EAAE,SAAS;AACpB,CAAA;AAED;MACa,gBAAgB,GAAG,sBAAsB,CAAS,kBAAkB,CAAC,SAAS,EAAE;AAC3F,IAAA,SAAS,EAAE,MAAM;AACjB,IAAA,WAAW,EAAE,CAAC,GAAG,KAAK,GAAG;AACzB,IAAA,QAAQ,EAAE,QAAQ;AACnB,CAAA;;"}

package/dist/utilities/renderUtils/index.cjs

@@ -4,10 +4,11 @@ var React = require('react');
 var importWithRetry_utils = require('./importWithRetry.utils.cjs');
 
 /**
- * Retrieves an environment variable.
+ * Reads an environment variable from `process.env` first (tests, SSR), then Vite's
+ * `import.meta.env`.
  *
- * @param key The key of the environment variable to retrieve.
- * @returns The value of the environment variable.
+ * @param key The variable name, such as `VITE_APPID_OVERRIDE`.
+ * @returns Its value, or an empty string when neither source defines it.
  */
 const getEnvironmentVariable = (key) => {
     // Prefer Node env in tests/SSR
@@ -23,10 +24,10 @@ const getEnvironmentVariable = (key) => {
     return viteEnv?.[key] ?? '';
 };
 /**
- * Retrieves a micro-frontend attribute.
+ * Reads an attribute from the `#flipdish-micro-frontend` container Portal mounts the app into.
  *
- * @param key The key of the attribute to retrieve.
- * @returns The value of the attribute.
+ * @param key The attribute name, such as `data-app-id`.
+ * @returns Its value, or an empty string when there is no document or no such attribute.
  */
 const getMicroFrontendAttribute = (key) => {
     if (typeof document === 'undefined') {
@@ -36,49 +37,42 @@ const getMicroFrontendAttribute = (key) => {
     return microFrontendDiv?.getAttribute(key) || '';
 };
 /**
- * Retrieves the AppId.
+ * Reads the app id: the `VITE_APPID_OVERRIDE` environment variable first, then the container's
+ * `data-app-id` attribute (`data-appid` for portal-library 5.1.0 and below). Read once at call
+ * time; a component will not re-render when the value changes.
  *
- * Attempts to get the value from the environment variable `VITE_APPID_OVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-app-id`.
- * Fallbacks to `data-appid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
- *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns The app id, or an empty string when neither source provides one.
  */
 const getAppId = () => {
     return getEnvironmentVariable('VITE_APPID_OVERRIDE') || getMicroFrontendAttribute('data-app-id') || getMicroFrontendAttribute('data-appid');
 };
 /**
- * Retrieves the OrgId.
- *
- * Attempts to get the value from the environment variable `VITE_ORGID_OVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-org-id`.
- * Fallbacks to `data-orgid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ * Reads the org id: the `VITE_ORGID_OVERRIDE` environment variable first, then the container's
+ * `data-org-id` attribute (`data-orgid` for portal-library 5.1.0 and below). Read once at call
+ * time; a component will not re-render when the value changes.
  *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns The org id, or an empty string when neither source provides one.
  */
 const getOrgId = () => {
     return getEnvironmentVariable('VITE_ORGID_OVERRIDE') || getMicroFrontendAttribute('data-org-id') || getMicroFrontendAttribute('data-orgid');
 };
 /**
- * Retrieves the BrandId.
+ * Reads the brand id: the `VITE_BRANDID_OVERRIDE` environment variable first, then the
+ * container's `data-brand-id` attribute (`data-brandid` for portal-library 5.1.0 and below).
+ * Read once at call time; a component will not re-render when the value changes.
  *
- * Attempts to get the value from the environment variable `VITE_BRANDID_OVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-brand-id`.
- * Fallbacks to `data-brandid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
- *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns The brand id, or an empty string when neither source provides one.
  */
 const getBrandId = () => {
     return getEnvironmentVariable('VITE_BRANDID_OVERRIDE') || getMicroFrontendAttribute('data-brand-id') || getMicroFrontendAttribute('data-brandid');
 };
 /**
- * Retrieves the isFlipdishStaff attribute.
- *
- * Attempts to get the value from the environment variable `VITE_ISFLIPDISHSTAFFOVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-is-flipdish-staff`.
- * Fallbacks to `data-isflipdishstaff` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ * Reads the Flipdish-staff flag: the `VITE_ISFLIPDISHSTAFFOVERRIDE` environment variable
+ * first, then the container's `data-is-flipdish-staff` attribute (`data-isflipdishstaff` for
+ * portal-library 5.1.0 and below). Read once at call time; a component will not re-render when
+ * the value changes.
  *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns `true` when the value reads as true, otherwise `false`.
  */
 const getIsFlipdishStaff = () => {
     const stringValue = getEnvironmentVariable('VITE_ISFLIPDISHSTAFFOVERRIDE') ||
@@ -86,6 +80,13 @@ const getIsFlipdishStaff = () => {
         getMicroFrontendAttribute('data-isflipdishstaff');
     return stringValue?.toString() === 'true';
 };
+/**
+ * `React.lazy` that reloads the page once when a dynamic import fails, on the assumption that
+ * a deploy replaced the chunk; a second failure after the reload is thrown as a real error.
+ *
+ * @param componentImport The `() => import('./Page')` factory you would pass to `React.lazy`.
+ * @returns A lazy component to render inside `Suspense`.
+ */
 // biome-ignore lint/suspicious/noExplicitAny: dynamic import factory shape isn't expressible without `any`; preserved from portal-library implementation
 const lazyWithRetry = (componentImport) => React.lazy(() => importWithRetry_utils.importWithRetry(componentImport));
 

package/dist/utilities/renderUtils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":["lazy","importWithRetry"],"mappings":";;;;;AAIA;;;;;AAKG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;;AAMA,IAAA,MAAM,OAAO,GAAI,SAA6E;AAC9F,IAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;AAC7B;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;;AAQG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KAAKA,UAAI,CAAC,MAAMC,qCAAe,CAAC,eAAe,CAAC;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":["lazy","importWithRetry"],"mappings":";;;;;AAIA;;;;;;AAMG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;;AAMA,IAAA,MAAM,OAAO,GAAI,SAA6E;AAC9F,IAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;AAC7B;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;AAMG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;AAMG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;AAMG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;AAOG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;;;;;;AAMG;AACH;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KAAKA,UAAI,CAAC,MAAMC,qCAAe,CAAC,eAAe,CAAC;;;;;;;;"}

package/dist/utilities/renderUtils/index.d.ts

@@ -1,56 +1,57 @@
 /**
- * Retrieves an environment variable.
+ * Reads an environment variable from `process.env` first (tests, SSR), then Vite's
+ * `import.meta.env`.
  *
- * @param key The key of the environment variable to retrieve.
- * @returns The value of the environment variable.
+ * @param key The variable name, such as `VITE_APPID_OVERRIDE`.
+ * @returns Its value, or an empty string when neither source defines it.
  */
 export declare const getEnvironmentVariable: (key: string) => string;
 /**
- * Retrieves a micro-frontend attribute.
+ * Reads an attribute from the `#flipdish-micro-frontend` container Portal mounts the app into.
  *
- * @param key The key of the attribute to retrieve.
- * @returns The value of the attribute.
+ * @param key The attribute name, such as `data-app-id`.
+ * @returns Its value, or an empty string when there is no document or no such attribute.
  */
 export declare const getMicroFrontendAttribute: (key: string) => string;
 /**
- * Retrieves the AppId.
+ * Reads the app id: the `VITE_APPID_OVERRIDE` environment variable first, then the container's
+ * `data-app-id` attribute (`data-appid` for portal-library 5.1.0 and below). Read once at call
+ * time; a component will not re-render when the value changes.
  *
- * Attempts to get the value from the environment variable `VITE_APPID_OVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-app-id`.
- * Fallbacks to `data-appid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
- *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns The app id, or an empty string when neither source provides one.
  */
 export declare const getAppId: () => string;
 /**
- * Retrieves the OrgId.
- *
- * Attempts to get the value from the environment variable `VITE_ORGID_OVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-org-id`.
- * Fallbacks to `data-orgid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ * Reads the org id: the `VITE_ORGID_OVERRIDE` environment variable first, then the container's
+ * `data-org-id` attribute (`data-orgid` for portal-library 5.1.0 and below). Read once at call
+ * time; a component will not re-render when the value changes.
  *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns The org id, or an empty string when neither source provides one.
  */
 export declare const getOrgId: () => string;
 /**
- * Retrieves the BrandId.
+ * Reads the brand id: the `VITE_BRANDID_OVERRIDE` environment variable first, then the
+ * container's `data-brand-id` attribute (`data-brandid` for portal-library 5.1.0 and below).
+ * Read once at call time; a component will not re-render when the value changes.
  *
- * Attempts to get the value from the environment variable `VITE_BRANDID_OVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-brand-id`.
- * Fallbacks to `data-brandid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
- *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns The brand id, or an empty string when neither source provides one.
  */
 export declare const getBrandId: () => string;
 /**
- * Retrieves the isFlipdishStaff attribute.
- *
- * Attempts to get the value from the environment variable `VITE_ISFLIPDISHSTAFFOVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-is-flipdish-staff`.
- * Fallbacks to `data-isflipdishstaff` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ * Reads the Flipdish-staff flag: the `VITE_ISFLIPDISHSTAFFOVERRIDE` environment variable
+ * first, then the container's `data-is-flipdish-staff` attribute (`data-isflipdishstaff` for
+ * portal-library 5.1.0 and below). Read once at call time; a component will not re-render when
+ * the value changes.
  *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns `true` when the value reads as true, otherwise `false`.
  */
 export declare const getIsFlipdishStaff: () => boolean;
+/**
+ * `React.lazy` that reloads the page once when a dynamic import fails, on the assumption that
+ * a deploy replaced the chunk; a second failure after the reload is thrown as a real error.
+ *
+ * @param componentImport The `() => import('./Page')` factory you would pass to `React.lazy`.
+ * @returns A lazy component to render inside `Suspense`.
+ */
 export declare const lazyWithRetry: (componentImport: () => any) => import("react").LazyExoticComponent<import("react").ComponentType<any>>;
 //# sourceMappingURL=index.d.ts.map

package/dist/utilities/renderUtils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/renderUtils/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAYpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,MAMvD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,QAAO,MAE7B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAO,OAMrC,CAAC;AAGF,eAAO,MAAM,aAAa,GAAI,iBAAiB,MAAM,GAAG,4EAAiD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/renderUtils/index.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAYpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,MAMvD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,QAAO,MAE7B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAO,OAMrC,CAAC;AAEF;;;;;;GAMG;AAEH,eAAO,MAAM,aAAa,GAAI,iBAAiB,MAAM,GAAG,4EAAiD,CAAC"}

package/dist/utilities/renderUtils/index.js

@@ -2,10 +2,11 @@ import { lazy } from 'react';
 import { importWithRetry } from './importWithRetry.utils.js';
 
 /**
- * Retrieves an environment variable.
+ * Reads an environment variable from `process.env` first (tests, SSR), then Vite's
+ * `import.meta.env`.
  *
- * @param key The key of the environment variable to retrieve.
- * @returns The value of the environment variable.
+ * @param key The variable name, such as `VITE_APPID_OVERRIDE`.
+ * @returns Its value, or an empty string when neither source defines it.
  */
 const getEnvironmentVariable = (key) => {
     // Prefer Node env in tests/SSR
@@ -21,10 +22,10 @@ const getEnvironmentVariable = (key) => {
     return viteEnv?.[key] ?? '';
 };
 /**
- * Retrieves a micro-frontend attribute.
+ * Reads an attribute from the `#flipdish-micro-frontend` container Portal mounts the app into.
  *
- * @param key The key of the attribute to retrieve.
- * @returns The value of the attribute.
+ * @param key The attribute name, such as `data-app-id`.
+ * @returns Its value, or an empty string when there is no document or no such attribute.
  */
 const getMicroFrontendAttribute = (key) => {
     if (typeof document === 'undefined') {
@@ -34,49 +35,42 @@ const getMicroFrontendAttribute = (key) => {
     return microFrontendDiv?.getAttribute(key) || '';
 };
 /**
- * Retrieves the AppId.
+ * Reads the app id: the `VITE_APPID_OVERRIDE` environment variable first, then the container's
+ * `data-app-id` attribute (`data-appid` for portal-library 5.1.0 and below). Read once at call
+ * time; a component will not re-render when the value changes.
  *
- * Attempts to get the value from the environment variable `VITE_APPID_OVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-app-id`.
- * Fallbacks to `data-appid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
- *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns The app id, or an empty string when neither source provides one.
  */
 const getAppId = () => {
     return getEnvironmentVariable('VITE_APPID_OVERRIDE') || getMicroFrontendAttribute('data-app-id') || getMicroFrontendAttribute('data-appid');
 };
 /**
- * Retrieves the OrgId.
- *
- * Attempts to get the value from the environment variable `VITE_ORGID_OVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-org-id`.
- * Fallbacks to `data-orgid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ * Reads the org id: the `VITE_ORGID_OVERRIDE` environment variable first, then the container's
+ * `data-org-id` attribute (`data-orgid` for portal-library 5.1.0 and below). Read once at call
+ * time; a component will not re-render when the value changes.
  *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns The org id, or an empty string when neither source provides one.
  */
 const getOrgId = () => {
     return getEnvironmentVariable('VITE_ORGID_OVERRIDE') || getMicroFrontendAttribute('data-org-id') || getMicroFrontendAttribute('data-orgid');
 };
 /**
- * Retrieves the BrandId.
+ * Reads the brand id: the `VITE_BRANDID_OVERRIDE` environment variable first, then the
+ * container's `data-brand-id` attribute (`data-brandid` for portal-library 5.1.0 and below).
+ * Read once at call time; a component will not re-render when the value changes.
  *
- * Attempts to get the value from the environment variable `VITE_BRANDID_OVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-brand-id`.
- * Fallbacks to `data-brandid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
- *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns The brand id, or an empty string when neither source provides one.
  */
 const getBrandId = () => {
     return getEnvironmentVariable('VITE_BRANDID_OVERRIDE') || getMicroFrontendAttribute('data-brand-id') || getMicroFrontendAttribute('data-brandid');
 };
 /**
- * Retrieves the isFlipdishStaff attribute.
- *
- * Attempts to get the value from the environment variable `VITE_ISFLIPDISHSTAFFOVERRIDE`.
- * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-is-flipdish-staff`.
- * Fallbacks to `data-isflipdishstaff` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ * Reads the Flipdish-staff flag: the `VITE_ISFLIPDISHSTAFFOVERRIDE` environment variable
+ * first, then the container's `data-is-flipdish-staff` attribute (`data-isflipdishstaff` for
+ * portal-library 5.1.0 and below). Read once at call time; a component will not re-render when
+ * the value changes.
  *
- * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ * @returns `true` when the value reads as true, otherwise `false`.
  */
 const getIsFlipdishStaff = () => {
     const stringValue = getEnvironmentVariable('VITE_ISFLIPDISHSTAFFOVERRIDE') ||
@@ -84,6 +78,13 @@ const getIsFlipdishStaff = () => {
         getMicroFrontendAttribute('data-isflipdishstaff');
     return stringValue?.toString() === 'true';
 };
+/**
+ * `React.lazy` that reloads the page once when a dynamic import fails, on the assumption that
+ * a deploy replaced the chunk; a second failure after the reload is thrown as a real error.
+ *
+ * @param componentImport The `() => import('./Page')` factory you would pass to `React.lazy`.
+ * @returns A lazy component to render inside `Suspense`.
+ */
 // biome-ignore lint/suspicious/noExplicitAny: dynamic import factory shape isn't expressible without `any`; preserved from portal-library implementation
 const lazyWithRetry = (componentImport) => lazy(() => importWithRetry(componentImport));
 

package/dist/utilities/renderUtils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAIA;;;;;AAKG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;;AAMA,IAAA,MAAM,OAAO,GAAI,MAAM,CAAC,IAAkE,CAAC,GAAG;AAC9F,IAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;AAC7B;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;;AAQG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KAAK,IAAI,CAAC,MAAM,eAAe,CAAC,eAAe,CAAC;;"}
+{"version":3,"file":"index.js","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAIA;;;;;;AAMG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;;AAMA,IAAA,MAAM,OAAO,GAAI,MAAM,CAAC,IAAkE,CAAC,GAAG;AAC9F,IAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;AAC7B;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;AAMG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;AAMG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;AAMG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;AAOG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;;;;;;AAMG;AACH;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KAAK,IAAI,CAAC,MAAM,eAAe,CAAC,eAAe,CAAC;;"}

package/dist/utilities/sessionStorageUtils/index.cjs

@@ -14,12 +14,15 @@ var sessionStorageUtils_constants = require('./sessionStorageUtils.constants.cjs
  * — check there for the full list before adding a new one.
  */
 /**
- * Build a typed, failure-safe accessor for a single `sessionStorage` key.
+ * Builds a typed, failure-safe accessor for a single `sessionStorage` key.
  *
- * @example
- * const draft = createSessionStorageItem<Draft>('fd-draft');
- * draft.set({ title: 'Hi' });
- * const value = draft.get(); // Draft | null
+ *   const draft = createSessionStorageItem<Draft>('fd-draft'); draft.set({ title: 'Hi' }); draft.get(); // Draft | null
+ *
+ * @param key The storage key; register it in `SESSION_STORAGE_KEYS` first.
+ * @param options Custom `serialize`/`deserialize` and a `validate` guard; see
+ *   `SessionStorageItemOptions`.
+ * @returns `get`, `set` and `clear` that never throw; `get()` returns `null` when storage is
+ *   unavailable, while `set()` and `clear()` return `void` and ignore failures.
  */
 const createSessionStorageItem = (key, options = {}) => webStorage_utils.createWebStorageItem(() => window.sessionStorage, key, options);
 /**

package/dist/utilities/sessionStorageUtils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"sourcesContent":[null],"names":["createWebStorageItem","SESSION_STORAGE_KEYS","parseBooleanString","isBoolean"],"mappings":";;;;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;AAOG;AACI,MAAM,wBAAwB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAwC,EAAE,KACjGA,qCAAoB,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO;AAEhE;;;AAGG;MACU,yBAAyB,GAAG,wBAAwB,CAAUC,kDAAoB,CAAC,yBAAyB,EAAE;AACzH,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAKC,mCAAkB,CAAC,GAAG,EAAE,oCAAoC,CAAC;AACnF,IAAA,QAAQ,EAAEC,0BAAS;AACpB,CAAA;;;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"sourcesContent":[null],"names":["createWebStorageItem","SESSION_STORAGE_KEYS","parseBooleanString","isBoolean"],"mappings":";;;;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;;;;AAUG;AACI,MAAM,wBAAwB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAwC,EAAE,KACjGA,qCAAoB,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO;AAEhE;;;AAGG;MACU,yBAAyB,GAAG,wBAAwB,CAAUC,kDAAoB,CAAC,yBAAyB,EAAE;AACzH,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAKC,mCAAkB,CAAC,GAAG,EAAE,oCAAoC,CAAC;AACnF,IAAA,QAAQ,EAAEC,0BAAS;AACpB,CAAA;;;;"}

package/dist/utilities/sessionStorageUtils/index.d.ts

@@ -27,12 +27,15 @@ export interface SessionStorageItemOptions<T> {
     validate?: (value: unknown) => value is T;
 }
 /**
- * Build a typed, failure-safe accessor for a single `sessionStorage` key.
+ * Builds a typed, failure-safe accessor for a single `sessionStorage` key.
  *
- * @example
- * const draft = createSessionStorageItem<Draft>('fd-draft');
- * draft.set({ title: 'Hi' });
- * const value = draft.get(); // Draft | null
+ *   const draft = createSessionStorageItem<Draft>('fd-draft'); draft.set({ title: 'Hi' }); draft.get(); // Draft | null
+ *
+ * @param key The storage key; register it in `SESSION_STORAGE_KEYS` first.
+ * @param options Custom `serialize`/`deserialize` and a `validate` guard; see
+ *   `SessionStorageItemOptions`.
+ * @returns `get`, `set` and `clear` that never throw; `get()` returns `null` when storage is
+ *   unavailable, while `set()` and `clear()` return `void` and ignore failures.
  */
 export declare const createSessionStorageItem: <T>(key: string, options?: SessionStorageItemOptions<T>) => SessionStorageItem<T>;
 /**

package/dist/utilities/sessionStorageUtils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAIhC,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,gFAAgF;IAChF,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChB,wEAAwE;IACxE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAS,yBAAyB,CAAC,CAAC,CAAM,KAAG,kBAAkB,CAAC,CAAC,CACzD,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,6BAIpC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAIhC,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,gFAAgF;IAChF,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChB,wEAAwE;IACxE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAS,yBAAyB,CAAC,CAAC,CAAM,KAAG,kBAAkB,CAAC,CAAC,CACzD,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,6BAIpC,CAAC"}

package/dist/utilities/sessionStorageUtils/index.js

@@ -12,12 +12,15 @@ import { SESSION_STORAGE_KEYS } from './sessionStorageUtils.constants.js';
  * — check there for the full list before adding a new one.
  */
 /**
- * Build a typed, failure-safe accessor for a single `sessionStorage` key.
+ * Builds a typed, failure-safe accessor for a single `sessionStorage` key.
  *
- * @example
- * const draft = createSessionStorageItem<Draft>('fd-draft');
- * draft.set({ title: 'Hi' });
- * const value = draft.get(); // Draft | null
+ *   const draft = createSessionStorageItem<Draft>('fd-draft'); draft.set({ title: 'Hi' }); draft.get(); // Draft | null
+ *
+ * @param key The storage key; register it in `SESSION_STORAGE_KEYS` first.
+ * @param options Custom `serialize`/`deserialize` and a `validate` guard; see
+ *   `SessionStorageItemOptions`.
+ * @returns `get`, `set` and `clear` that never throw; `get()` returns `null` when storage is
+ *   unavailable, while `set()` and `clear()` return `void` and ignore failures.
  */
 const createSessionStorageItem = (key, options = {}) => createWebStorageItem(() => window.sessionStorage, key, options);
 /**

package/dist/utilities/sessionStorageUtils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;AAOG;AACI,MAAM,wBAAwB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAwC,EAAE,KACjG,oBAAoB,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO;AAEhE;;;AAGG;MACU,yBAAyB,GAAG,wBAAwB,CAAU,oBAAoB,CAAC,yBAAyB,EAAE;AACzH,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAK,kBAAkB,CAAC,GAAG,EAAE,oCAAoC,CAAC;AACnF,IAAA,QAAQ,EAAE,SAAS;AACpB,CAAA;;"}
+{"version":3,"file":"index.js","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;;;;AAUG;AACI,MAAM,wBAAwB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAwC,EAAE,KACjG,oBAAoB,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO;AAEhE;;;AAGG;MACU,yBAAyB,GAAG,wBAAwB,CAAU,oBAAoB,CAAC,yBAAyB,EAAE;AACzH,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAK,kBAAkB,CAAC,GAAG,EAAE,oCAAoC,CAAC;AACnF,IAAA,QAAQ,EAAE,SAAS;AACpB,CAAA;;"}