@flipdish/ui-library 0.31.4 → 0.31.6

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webStorage.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qFAAqF;AACrF,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC;AA+BrC,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,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,qBAAqB,CAAC,CAAC;IACtC,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,oDAAoD;AACpD,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAqC,CAAC;AAE1F,mDAAmD;AACnD,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAEvF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,EAAE,cAAc,MAAM,KAAG,OAItE,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,YAAY,eAAe,EAAE,KAAK,MAAM,EAAE,UAAS,qBAAqB,CAAC,CAAC,CAAM,KAAG,cAAc,CAAC,CAAC,CAgC1I,CAAC"}
+{"version":3,"file":"webStorage.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qFAAqF;AACrF,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC;AA+BrC,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,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,qBAAqB,CAAC,CAAC;IACtC,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;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAqC,CAAC;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAEvF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,EAAE,cAAc,MAAM,KAAG,OAItE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,YAAY,eAAe,EAAE,KAAK,MAAM,EAAE,UAAS,qBAAqB,CAAC,CAAC,CAAM,KAAG,cAAc,CAAC,CAAC,CAgC1I,CAAC"}

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.js

@@ -41,14 +41,28 @@ const safeRemove = (getStorage, key) => {
         return false;
     }
 };
-/** Reusable `validate` guard for a boolean item. */
+/**
+ * Reusable `validate` guard for a boolean item.
+ *
+ * @param value The deserialised stored value.
+ * @returns `true` when the stored value is a boolean.
+ */
 const isBoolean = (value) => typeof value === 'boolean';
-/** Reusable `validate` guard for a string item. */
+/**
+ * Reusable `validate` guard for a string item.
+ *
+ * @param value The deserialised stored value.
+ * @returns `true` when the stored value is a string.
+ */
 const isString = (value) => typeof value === 'string';
 /**
  * Parse a plain `'true'`/`'false'` string (not JSON) into a boolean; throws
  * `errorMessage` for anything else so `WebStorageItem.get()` treats it as
  * invalid data and returns `null`.
+ *
+ * @param raw The string read from storage.
+ * @param errorMessage The message thrown when `raw` is neither `'true'` nor `'false'`.
+ * @returns The boolean the string spells.
  */
 const parseBooleanString = (raw, errorMessage) => {
     if (raw === 'true')
@@ -57,7 +71,14 @@ const parseBooleanString = (raw, errorMessage) => {
         return false;
     throw new Error(errorMessage);
 };
-/** Build a typed, failure-safe accessor for a single key in the given storage. */
+/**
+ * Build a typed, failure-safe accessor for a single key in the given storage.
+ *
+ * @param getStorage Returns the backing store on each access, so a throwing `window.*Storage` getter is caught.
+ * @param key The storage key the item reads and writes.
+ * @param options How values are serialised and validated, described on `WebStorageItemOptions`.
+ * @returns An accessor whose `get`, `set` and `clear` never throw.
+ */
 const createWebStorageItem = (getStorage, key, options = {}) => {
     const { serialize = JSON.stringify, deserialize = JSON.parse, validate } = options;
     return {

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"webStorage.utils.js","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;AAUG;AAKH,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAmB;IAC1E,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,IAAI;AAC9C,IAAA,IAAI;AACF,QAAA,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAClC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,EAAE,KAAa,KAAa;IACnF,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;QACF,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;AAChC,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAa;IACvE,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;AACF,QAAA,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;AAC5B,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAoBD;AACO,MAAM,SAAS,GAAG,CAAC,KAAc,KAAuB,OAAO,KAAK,KAAK;AAEhF;AACO,MAAM,QAAQ,GAAG,CAAC,KAAc,KAAsB,OAAO,KAAK,KAAK;AAE9E;;;;AAIG;MACU,kBAAkB,GAAG,CAAC,GAAW,EAAE,YAAoB,KAAa;IAC/E,IAAI,GAAG,KAAK,MAAM;AAAE,QAAA,OAAO,IAAI;IAC/B,IAAI,GAAG,KAAK,OAAO;AAAE,QAAA,OAAO,KAAK;AACjC,IAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;AAC/B;AAEA;AACO,MAAM,oBAAoB,GAAG,CAAI,UAA2B,EAAE,GAAW,EAAE,OAAA,GAAoC,EAAE,KAAuB;AAC7I,IAAA,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC,KAA2B,EAAE,QAAQ,EAAE,GAAG,OAAO;IAExG,OAAO;QACL,GAAG,GAAA;YACD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;YACpC,IAAI,GAAG,IAAI,IAAI;AAAE,gBAAA,OAAO,IAAI;AAC5B,YAAA,IAAI;AACF,gBAAA,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC;AAC9B,gBAAA,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AAAE,oBAAA,OAAO,IAAI;AAC7C,gBAAA,OAAO,KAAK;YACd;AAAE,YAAA,MAAM;AACN,gBAAA,OAAO,IAAI;YACb;QACF,CAAC;AACD,QAAA,GAAG,CAAC,KAAK,EAAA;AACP,YAAA,IAAI;AACF,gBAAA,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC;;;;gBAInC,IAAI,OAAO,UAAU,KAAK,QAAQ;oBAAE;AACpC,gBAAA,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC;YACtC;AAAE,YAAA,MAAM;;;YAGR;QACF,CAAC;QACD,KAAK,GAAA;AACH,YAAA,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC;QAC7B,CAAC;KACF;AACH;;"}
+{"version":3,"file":"webStorage.utils.js","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;AAUG;AAKH,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAmB;IAC1E,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,IAAI;AAC9C,IAAA,IAAI;AACF,QAAA,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAClC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,EAAE,KAAa,KAAa;IACnF,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;QACF,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;AAChC,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAa;IACvE,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;AACF,QAAA,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;AAC5B,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAoBD;;;;;AAKG;AACI,MAAM,SAAS,GAAG,CAAC,KAAc,KAAuB,OAAO,KAAK,KAAK;AAEhF;;;;;AAKG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAc,KAAsB,OAAO,KAAK,KAAK;AAE9E;;;;;;;;AAQG;MACU,kBAAkB,GAAG,CAAC,GAAW,EAAE,YAAoB,KAAa;IAC/E,IAAI,GAAG,KAAK,MAAM;AAAE,QAAA,OAAO,IAAI;IAC/B,IAAI,GAAG,KAAK,OAAO;AAAE,QAAA,OAAO,KAAK;AACjC,IAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;AAC/B;AAEA;;;;;;;AAOG;AACI,MAAM,oBAAoB,GAAG,CAAI,UAA2B,EAAE,GAAW,EAAE,OAAA,GAAoC,EAAE,KAAuB;AAC7I,IAAA,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC,KAA2B,EAAE,QAAQ,EAAE,GAAG,OAAO;IAExG,OAAO;QACL,GAAG,GAAA;YACD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;YACpC,IAAI,GAAG,IAAI,IAAI;AAAE,gBAAA,OAAO,IAAI;AAC5B,YAAA,IAAI;AACF,gBAAA,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC;AAC9B,gBAAA,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AAAE,oBAAA,OAAO,IAAI;AAC7C,gBAAA,OAAO,KAAK;YACd;AAAE,YAAA,MAAM;AACN,gBAAA,OAAO,IAAI;YACb;QACF,CAAC;AACD,QAAA,GAAG,CAAC,KAAK,EAAA;AACP,YAAA,IAAI;AACF,gBAAA,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC;;;;gBAInC,IAAI,OAAO,UAAU,KAAK,QAAQ;oBAAE;AACpC,gBAAA,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC;YACtC;AAAE,YAAA,MAAM;;;YAGR;QACF,CAAC;QACD,KAAK,GAAA;AACH,YAAA,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC;QAC7B,CAAC;KACF;AACH;;"}

package/dist/utilities/cssScopeUtils/index.cjs

@@ -45,13 +45,14 @@ const KEYFRAME_STEP = /^(from|to|\d+(\.\d+)?%)$/;
 /** Escape a string for safe use as a literal inside a `RegExp`. */
 const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 /**
- * Build the `transform` callback for `postcss-prefix-selector` that scopes Tailwind v4 output
+ * Builds the `transform` callback for `postcss-prefix-selector` that scopes Tailwind v4 output
  * under `scopeSelector`.
  *
- * @param scopeSelector The selector every rule is scoped under (e.g. `'#flipdish-micro-frontend'`
- *   or `'[data-tailwind]'`). Must match the `prefix` passed to `postcss-prefix-selector`.
- * @param options Behavioural toggles — see {@link ScopedPrefixTransformOptions}.
- * @returns A `(prefix, selector, prefixedSelector, filePath?) => string` transform.
+ * @param scopeSelector The selector every rule is scoped under, such as
+ *   `'#flipdish-micro-frontend'`; must match the `prefix` passed to `postcss-prefix-selector`.
+ * @param options Behavioural toggles; see `ScopedPrefixTransformOptions`.
+ * @returns The `(prefix, selector, prefixedSelector, filePath?) => string` transform to pass
+ *   to the plugin.
  */
 function createScopedPrefixTransform(scopeSelector, options = {}) {
     const { shouldScope, scopeBody = false, matchRootElement = false } = options;

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/utilities/cssScopeUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCG;AA4BH;AACA,MAAM,aAAa,GAAG,0BAA0B;AAEhD;AACA,MAAM,YAAY,GAAG,CAAC,KAAa,KAAa,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;AAE5F;;;;;;;;AAQG;SACa,2BAA2B,CACzC,aAAqB,EACrB,UAAwC,EAAE,EAAA;AAE1C,IAAA,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,KAAK,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO;AAE5E,IAAA,MAAM,uBAAuB,GAAG,aAAa,CAAC,IAAI,EAAE;IACpD,IAAI,CAAC,uBAAuB,EAAE;AAC5B,QAAA,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC;IAC/F;;;;;AAMA,IAAA,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,CAAA,CAAA,EAAI,YAAY,CAAC,uBAAuB,CAAC,CAAA,qBAAA,CAAuB,CAAC;IAElG,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,KAAI;;QAEtD,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;AACzC,YAAA,OAAO,QAAQ;QACjB;;QAGA,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE;AAC5C,YAAA,OAAO,QAAQ;QACjB;;;;QAKA,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,EAAE;AAC/C,YAAA,OAAO,MAAM;QACf;;AAGA,QAAA,IAAI,QAAQ,KAAK,OAAO,EAAE;AACxB,YAAA,OAAO,QAAQ;QACjB;;;AAIA,QAAA,IAAI,QAAQ,KAAK,MAAM,EAAE;YACvB,OAAO,SAAS,GAAG,MAAM,GAAG,QAAQ;QACtC;;QAGA,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE;AACvC,YAAA,OAAO,QAAQ;QACjB;;;QAIA,IAAI,gBAAgB,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;AAChD,YAAA,OAAO,GAAG,MAAM,CAAA,EAAG,QAAQ,CAAA,EAAA,EAAK,gBAAgB,EAAE;QACpD;;;AAIA,QAAA,OAAO,gBAAgB;AACzB,IAAA,CAAC;AACH;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/cssScopeUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCG;AA4BH;AACA,MAAM,aAAa,GAAG,0BAA0B;AAEhD;AACA,MAAM,YAAY,GAAG,CAAC,KAAa,KAAa,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;AAE5F;;;;;;;;;AASG;SACa,2BAA2B,CACzC,aAAqB,EACrB,UAAwC,EAAE,EAAA;AAE1C,IAAA,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,KAAK,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO;AAE5E,IAAA,MAAM,uBAAuB,GAAG,aAAa,CAAC,IAAI,EAAE;IACpD,IAAI,CAAC,uBAAuB,EAAE;AAC5B,QAAA,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC;IAC/F;;;;;AAMA,IAAA,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,CAAA,CAAA,EAAI,YAAY,CAAC,uBAAuB,CAAC,CAAA,qBAAA,CAAuB,CAAC;IAElG,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,KAAI;;QAEtD,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;AACzC,YAAA,OAAO,QAAQ;QACjB;;QAGA,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE;AAC5C,YAAA,OAAO,QAAQ;QACjB;;;;QAKA,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,EAAE;AAC/C,YAAA,OAAO,MAAM;QACf;;AAGA,QAAA,IAAI,QAAQ,KAAK,OAAO,EAAE;AACxB,YAAA,OAAO,QAAQ;QACjB;;;AAIA,QAAA,IAAI,QAAQ,KAAK,MAAM,EAAE;YACvB,OAAO,SAAS,GAAG,MAAM,GAAG,QAAQ;QACtC;;QAGA,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE;AACvC,YAAA,OAAO,QAAQ;QACjB;;;QAIA,IAAI,gBAAgB,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;AAChD,YAAA,OAAO,GAAG,MAAM,CAAA,EAAG,QAAQ,CAAA,EAAA,EAAK,gBAAgB,EAAE;QACpD;;;AAIA,QAAA,OAAO,gBAAgB;AACzB,IAAA,CAAC;AACH;;"}

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

@@ -64,13 +64,14 @@ export interface ScopedPrefixTransformOptions {
     matchRootElement?: boolean;
 }
 /**
- * Build the `transform` callback for `postcss-prefix-selector` that scopes Tailwind v4 output
+ * Builds the `transform` callback for `postcss-prefix-selector` that scopes Tailwind v4 output
  * under `scopeSelector`.
  *
- * @param scopeSelector The selector every rule is scoped under (e.g. `'#flipdish-micro-frontend'`
- *   or `'[data-tailwind]'`). Must match the `prefix` passed to `postcss-prefix-selector`.
- * @param options Behavioural toggles — see {@link ScopedPrefixTransformOptions}.
- * @returns A `(prefix, selector, prefixedSelector, filePath?) => string` transform.
+ * @param scopeSelector The selector every rule is scoped under, such as
+ *   `'#flipdish-micro-frontend'`; must match the `prefix` passed to `postcss-prefix-selector`.
+ * @param options Behavioural toggles; see `ScopedPrefixTransformOptions`.
+ * @returns The `(prefix, selector, prefixedSelector, filePath?) => string` transform to pass
+ *   to the plugin.
  */
 export declare function createScopedPrefixTransform(scopeSelector: string, options?: ScopedPrefixTransformOptions): (prefix: string, selector: string, prefixedSelector: string, filePath?: string) => string;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/cssScopeUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,MAAM,WAAW,4BAA4B;IAC3C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;IACxD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAQD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,4BAAiC,GACzC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CA0D3F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/cssScopeUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,MAAM,WAAW,4BAA4B;IAC3C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;IACxD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAQD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,4BAAiC,GACzC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CA0D3F"}

package/dist/utilities/cssScopeUtils/index.js

@@ -43,13 +43,14 @@ const KEYFRAME_STEP = /^(from|to|\d+(\.\d+)?%)$/;
 /** Escape a string for safe use as a literal inside a `RegExp`. */
 const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 /**
- * Build the `transform` callback for `postcss-prefix-selector` that scopes Tailwind v4 output
+ * Builds the `transform` callback for `postcss-prefix-selector` that scopes Tailwind v4 output
  * under `scopeSelector`.
  *
- * @param scopeSelector The selector every rule is scoped under (e.g. `'#flipdish-micro-frontend'`
- *   or `'[data-tailwind]'`). Must match the `prefix` passed to `postcss-prefix-selector`.
- * @param options Behavioural toggles — see {@link ScopedPrefixTransformOptions}.
- * @returns A `(prefix, selector, prefixedSelector, filePath?) => string` transform.
+ * @param scopeSelector The selector every rule is scoped under, such as
+ *   `'#flipdish-micro-frontend'`; must match the `prefix` passed to `postcss-prefix-selector`.
+ * @param options Behavioural toggles; see `ScopedPrefixTransformOptions`.
+ * @returns The `(prefix, selector, prefixedSelector, filePath?) => string` transform to pass
+ *   to the plugin.
  */
 function createScopedPrefixTransform(scopeSelector, options = {}) {
     const { shouldScope, scopeBody = false, matchRootElement = false } = options;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/utilities/cssScopeUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCG;AA4BH;AACA,MAAM,aAAa,GAAG,0BAA0B;AAEhD;AACA,MAAM,YAAY,GAAG,CAAC,KAAa,KAAa,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;AAE5F;;;;;;;;AAQG;SACa,2BAA2B,CACzC,aAAqB,EACrB,UAAwC,EAAE,EAAA;AAE1C,IAAA,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,KAAK,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO;AAE5E,IAAA,MAAM,uBAAuB,GAAG,aAAa,CAAC,IAAI,EAAE;IACpD,IAAI,CAAC,uBAAuB,EAAE;AAC5B,QAAA,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC;IAC/F;;;;;AAMA,IAAA,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,CAAA,CAAA,EAAI,YAAY,CAAC,uBAAuB,CAAC,CAAA,qBAAA,CAAuB,CAAC;IAElG,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,KAAI;;QAEtD,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;AACzC,YAAA,OAAO,QAAQ;QACjB;;QAGA,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE;AAC5C,YAAA,OAAO,QAAQ;QACjB;;;;QAKA,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,EAAE;AAC/C,YAAA,OAAO,MAAM;QACf;;AAGA,QAAA,IAAI,QAAQ,KAAK,OAAO,EAAE;AACxB,YAAA,OAAO,QAAQ;QACjB;;;AAIA,QAAA,IAAI,QAAQ,KAAK,MAAM,EAAE;YACvB,OAAO,SAAS,GAAG,MAAM,GAAG,QAAQ;QACtC;;QAGA,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE;AACvC,YAAA,OAAO,QAAQ;QACjB;;;QAIA,IAAI,gBAAgB,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;AAChD,YAAA,OAAO,GAAG,MAAM,CAAA,EAAG,QAAQ,CAAA,EAAA,EAAK,gBAAgB,EAAE;QACpD;;;AAIA,QAAA,OAAO,gBAAgB;AACzB,IAAA,CAAC;AACH;;"}
+{"version":3,"file":"index.js","sources":["../../../src/utilities/cssScopeUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCG;AA4BH;AACA,MAAM,aAAa,GAAG,0BAA0B;AAEhD;AACA,MAAM,YAAY,GAAG,CAAC,KAAa,KAAa,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;AAE5F;;;;;;;;;AASG;SACa,2BAA2B,CACzC,aAAqB,EACrB,UAAwC,EAAE,EAAA;AAE1C,IAAA,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,KAAK,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO;AAE5E,IAAA,MAAM,uBAAuB,GAAG,aAAa,CAAC,IAAI,EAAE;IACpD,IAAI,CAAC,uBAAuB,EAAE;AAC5B,QAAA,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC;IAC/F;;;;;AAMA,IAAA,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,CAAA,CAAA,EAAI,YAAY,CAAC,uBAAuB,CAAC,CAAA,qBAAA,CAAuB,CAAC;IAElG,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,KAAI;;QAEtD,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;AACzC,YAAA,OAAO,QAAQ;QACjB;;QAGA,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE;AAC5C,YAAA,OAAO,QAAQ;QACjB;;;;QAKA,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,EAAE;AAC/C,YAAA,OAAO,MAAM;QACf;;AAGA,QAAA,IAAI,QAAQ,KAAK,OAAO,EAAE;AACxB,YAAA,OAAO,QAAQ;QACjB;;;AAIA,QAAA,IAAI,QAAQ,KAAK,MAAM,EAAE;YACvB,OAAO,SAAS,GAAG,MAAM,GAAG,QAAQ;QACtC;;QAGA,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE;AACvC,YAAA,OAAO,QAAQ;QACjB;;;QAIA,IAAI,gBAAgB,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;AAChD,YAAA,OAAO,GAAG,MAAM,CAAA,EAAG,QAAQ,CAAA,EAAA,EAAK,gBAAgB,EAAE;QACpD;;;AAIA,QAAA,OAAO,gBAAgB;AACzB,IAAA,CAAC;AACH;;"}

package/dist/utilities/cx/index.cjs

@@ -18,21 +18,21 @@ const twMerge = tailwindMerge.extendTailwindMerge({
     },
 });
 /**
- * Merge Tailwind class strings, resolving conflicts (last value wins). Accepts the
- * same inputs as tailwind-merge — strings, arrays, and falsy values for
- * conditionals — so it composes cleanly:
+ * Merges Tailwind class strings so the last conflicting value wins; accepts strings, arrays
+ * and falsy values like tailwind-merge, and is pure JS so it works on web and React Native.
  *
  *   cx('px-2', isActive && 'bg-primary', ['text-sm', null]);
  *
- * Pure JS with no DOM dependency, so the same helper works on web (PostCSS) and
- * React Native (NativeWind). Imported by components as
- * `@flipdish/ui-library/utilities/cx`.
+ * @param inputs Class strings, arrays of them, or falsy values for conditionals.
+ * @returns One class string with conflicts resolved and falsy inputs dropped.
  */
 const cx = twMerge;
 /**
- * Identity helper that exists only so Tailwind IntelliSense recognises and sorts
- * the class strings held inside style-config objects (the `*.styles.ts` sortCx
- * maps components use). Returns its argument unchanged.
+ * Identity helper so Tailwind IntelliSense recognises and sorts the class strings inside
+ * `*.styles.ts` maps.
+ *
+ * @param classes A style map of literal Tailwind class strings.
+ * @returns The same object, unchanged.
  */
 const sortCx = (classes) => classes;
 

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/utilities/cx/index.ts"],"sourcesContent":[null],"names":["extendTailwindMerge"],"mappings":";;;;AAEA;;;;;;;AAOG;AACH,MAAM,OAAO,GAAGA,iCAAmB,CAAC;AAClC,IAAA,MAAM,EAAE;AACN,QAAA,KAAK,EAAE;AACL,YAAA,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC;AAC5F,SAAA;AACF,KAAA;AACF,CAAA,CAAC;AAEF;;;;;;;;;;AAUG;AACI,MAAM,EAAE,GAAG;AAKlB;;;;AAIG;AACI,MAAM,MAAM,GAAG,CAA4B,OAAU,KAAQ;;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/cx/index.ts"],"sourcesContent":[null],"names":["extendTailwindMerge"],"mappings":";;;;AAEA;;;;;;;AAOG;AACH,MAAM,OAAO,GAAGA,iCAAmB,CAAC;AAClC,IAAA,MAAM,EAAE;AACN,QAAA,KAAK,EAAE;AACL,YAAA,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC;AAC5F,SAAA;AACF,KAAA;AACF,CAAA,CAAC;AAEF;;;;;;;;AAQG;AACI,MAAM,EAAE,GAAG;AAKlB;;;;;;AAMG;AACI,MAAM,MAAM,GAAG,CAA4B,OAAU,KAAQ;;;"}

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

@@ -1,21 +1,21 @@
 /**
- * Merge Tailwind class strings, resolving conflicts (last value wins). Accepts the
- * same inputs as tailwind-merge — strings, arrays, and falsy values for
- * conditionals — so it composes cleanly:
+ * Merges Tailwind class strings so the last conflicting value wins; accepts strings, arrays
+ * and falsy values like tailwind-merge, and is pure JS so it works on web and React Native.
  *
  *   cx('px-2', isActive && 'bg-primary', ['text-sm', null]);
  *
- * Pure JS with no DOM dependency, so the same helper works on web (PostCSS) and
- * React Native (NativeWind). Imported by components as
- * `@flipdish/ui-library/utilities/cx`.
+ * @param inputs Class strings, arrays of them, or falsy values for conditionals.
+ * @returns One class string with conflicts resolved and falsy inputs dropped.
  */
 export declare const cx: (...classLists: import("tailwind-merge").ClassNameValue[]) => string;
 type ClassValue = string | number;
 type ClassDefinition = Record<string, ClassValue | Record<string, ClassValue | Record<string, ClassValue>>>;
 /**
- * Identity helper that exists only so Tailwind IntelliSense recognises and sorts
- * the class strings held inside style-config objects (the `*.styles.ts` sortCx
- * maps components use). Returns its argument unchanged.
+ * Identity helper so Tailwind IntelliSense recognises and sorts the class strings inside
+ * `*.styles.ts` maps.
+ *
+ * @param classes A style map of literal Tailwind class strings.
+ * @returns The same object, unchanged.
  */
 export declare const sortCx: <T extends ClassDefinition>(classes: T) => T;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/cx/index.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,EAAE,sEAAU,CAAC;AAE1B,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAClC,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AAE5G;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,eAAe,EAAE,SAAS,CAAC,KAAG,CAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/cx/index.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,eAAO,MAAM,EAAE,sEAAU,CAAC;AAE1B,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAClC,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AAE5G;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,eAAe,EAAE,SAAS,CAAC,KAAG,CAAY,CAAC"}

package/dist/utilities/cx/index.js

@@ -16,21 +16,21 @@ const twMerge = extendTailwindMerge({
     },
 });
 /**
- * Merge Tailwind class strings, resolving conflicts (last value wins). Accepts the
- * same inputs as tailwind-merge — strings, arrays, and falsy values for
- * conditionals — so it composes cleanly:
+ * Merges Tailwind class strings so the last conflicting value wins; accepts strings, arrays
+ * and falsy values like tailwind-merge, and is pure JS so it works on web and React Native.
  *
  *   cx('px-2', isActive && 'bg-primary', ['text-sm', null]);
  *
- * Pure JS with no DOM dependency, so the same helper works on web (PostCSS) and
- * React Native (NativeWind). Imported by components as
- * `@flipdish/ui-library/utilities/cx`.
+ * @param inputs Class strings, arrays of them, or falsy values for conditionals.
+ * @returns One class string with conflicts resolved and falsy inputs dropped.
  */
 const cx = twMerge;
 /**
- * Identity helper that exists only so Tailwind IntelliSense recognises and sorts
- * the class strings held inside style-config objects (the `*.styles.ts` sortCx
- * maps components use). Returns its argument unchanged.
+ * Identity helper so Tailwind IntelliSense recognises and sorts the class strings inside
+ * `*.styles.ts` maps.
+ *
+ * @param classes A style map of literal Tailwind class strings.
+ * @returns The same object, unchanged.
  */
 const sortCx = (classes) => classes;
 

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/utilities/cx/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;AAOG;AACH,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAClC,IAAA,MAAM,EAAE;AACN,QAAA,KAAK,EAAE;AACL,YAAA,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC;AAC5F,SAAA;AACF,KAAA;AACF,CAAA,CAAC;AAEF;;;;;;;;;;AAUG;AACI,MAAM,EAAE,GAAG;AAKlB;;;;AAIG;AACI,MAAM,MAAM,GAAG,CAA4B,OAAU,KAAQ;;"}
+{"version":3,"file":"index.js","sources":["../../../src/utilities/cx/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;AAOG;AACH,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAClC,IAAA,MAAM,EAAE;AACN,QAAA,KAAK,EAAE;AACL,YAAA,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC;AAC5F,SAAA;AACF,KAAA;AACF,CAAA,CAAC;AAEF;;;;;;;;AAQG;AACI,MAAM,EAAE,GAAG;AAKlB;;;;;;AAMG;AACI,MAAM,MAAM,GAAG,CAA4B,OAAU,KAAQ;;"}

package/dist/utilities/hrefUtils/index.cjs

@@ -10,14 +10,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) {
@@ -38,10 +36,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.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/utilities/hrefUtils/index.ts"],"sourcesContent":[null],"names":["warnOnce"],"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;QACpDA,kBAAQ,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.cjs","sources":["../../../src/utilities/hrefUtils/index.ts"],"sourcesContent":[null],"names":["warnOnce"],"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;QACpDA,kBAAQ,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/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/importWithRetry.utils.cjs

@@ -7,6 +7,9 @@ var sessionStorageUtils = require('@flipdish/ui-library/utilities/sessionStorage
  * sibling module (not re-exported from `index.ts`) so it's directly unit-testable
  * without reaching into `React.lazy()` internals, while staying internal glue —
  * see the atomic-design rule's "Public API vs private sub-components".
+ *
+ * @param componentImport The dynamic `import()` call for the lazy module.
+ * @returns The imported module; never settles while a reload is under way, and rethrows when the import fails after one reload.
  */
 // biome-ignore lint/suspicious/noExplicitAny: dynamic import factory shape isn't expressible without `any`; preserved from portal-library implementation
 const importWithRetry = async (componentImport) => {

package/dist/utilities/renderUtils/importWithRetry.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"importWithRetry.utils.cjs","sources":["../../../src/utilities/renderUtils/importWithRetry.utils.ts"],"sourcesContent":[null],"names":["pageForceRefreshedStorage"],"mappings":";;;;AAEA;;;;;AAKG;AACH;MACa,eAAe,GAAG,OAAO,eAA0B,KAAI;IAClE,MAAM,gCAAgC,GAAGA,6CAAyB,CAAC,GAAG,EAAE,KAAK,IAAI;AAEjF,IAAA,IAAI,SAAsD;AAC1D,IAAA,IAAI;AACF,QAAA,SAAS,GAAG,MAAM,eAAe,EAAE;IACrC;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,gCAAgC,EAAE;;;AAGrC,YAAAA,6CAAyB,CAAC,GAAG,CAAC,IAAI,CAAC;AACnC,YAAA,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;;;YAGxB,OAAO,IAAI,OAAO,CAAQ,MAAK,EAAE,CAAC,CAAC;QACrC;;;;AAKA,QAAA,MAAM,KAAK;IACb;;;AAIA,IAAAA,6CAAyB,CAAC,GAAG,CAAC,KAAK,CAAC;AACpC,IAAA,OAAO,SAAS;AAClB;;"}
+{"version":3,"file":"importWithRetry.utils.cjs","sources":["../../../src/utilities/renderUtils/importWithRetry.utils.ts"],"sourcesContent":[null],"names":["pageForceRefreshedStorage"],"mappings":";;;;AAEA;;;;;;;;AAQG;AACH;MACa,eAAe,GAAG,OAAO,eAA0B,KAAI;IAClE,MAAM,gCAAgC,GAAGA,6CAAyB,CAAC,GAAG,EAAE,KAAK,IAAI;AAEjF,IAAA,IAAI,SAAsD;AAC1D,IAAA,IAAI;AACF,QAAA,SAAS,GAAG,MAAM,eAAe,EAAE;IACrC;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,gCAAgC,EAAE;;;AAGrC,YAAAA,6CAAyB,CAAC,GAAG,CAAC,IAAI,CAAC;AACnC,YAAA,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;;;YAGxB,OAAO,IAAI,OAAO,CAAQ,MAAK,EAAE,CAAC,CAAC;QACrC;;;;AAKA,QAAA,MAAM,KAAK;IACb;;;AAIA,IAAAA,6CAAyB,CAAC,GAAG,CAAC,KAAK,CAAC;AACpC,IAAA,OAAO,SAAS;AAClB;;"}

package/dist/utilities/renderUtils/importWithRetry.utils.d.ts

@@ -3,6 +3,9 @@
  * sibling module (not re-exported from `index.ts`) so it's directly unit-testable
  * without reaching into `React.lazy()` internals, while staying internal glue —
  * see the atomic-design rule's "Public API vs private sub-components".
+ *
+ * @param componentImport The dynamic `import()` call for the lazy module.
+ * @returns The imported module; never settles while a reload is under way, and rethrows when the import fails after one reload.
  */
 export declare const importWithRetry: (componentImport: () => any) => Promise<any>;
 //# sourceMappingURL=importWithRetry.utils.d.ts.map

package/dist/utilities/renderUtils/importWithRetry.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"importWithRetry.utils.d.ts","sourceRoot":"","sources":["../../../src/utilities/renderUtils/importWithRetry.utils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,GAAU,iBAAiB,MAAM,GAAG,iBA2B/D,CAAC"}
+{"version":3,"file":"importWithRetry.utils.d.ts","sourceRoot":"","sources":["../../../src/utilities/renderUtils/importWithRetry.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,eAAO,MAAM,eAAe,GAAU,iBAAiB,MAAM,GAAG,iBA2B/D,CAAC"}

package/dist/utilities/renderUtils/importWithRetry.utils.js

@@ -5,6 +5,9 @@ import { pageForceRefreshedStorage } from '@flipdish/ui-library/utilities/sessio
  * sibling module (not re-exported from `index.ts`) so it's directly unit-testable
  * without reaching into `React.lazy()` internals, while staying internal glue —
  * see the atomic-design rule's "Public API vs private sub-components".
+ *
+ * @param componentImport The dynamic `import()` call for the lazy module.
+ * @returns The imported module; never settles while a reload is under way, and rethrows when the import fails after one reload.
  */
 // biome-ignore lint/suspicious/noExplicitAny: dynamic import factory shape isn't expressible without `any`; preserved from portal-library implementation
 const importWithRetry = async (componentImport) => {

package/dist/utilities/renderUtils/importWithRetry.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"importWithRetry.utils.js","sources":["../../../src/utilities/renderUtils/importWithRetry.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;AAKG;AACH;MACa,eAAe,GAAG,OAAO,eAA0B,KAAI;IAClE,MAAM,gCAAgC,GAAG,yBAAyB,CAAC,GAAG,EAAE,KAAK,IAAI;AAEjF,IAAA,IAAI,SAAsD;AAC1D,IAAA,IAAI;AACF,QAAA,SAAS,GAAG,MAAM,eAAe,EAAE;IACrC;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,gCAAgC,EAAE;;;AAGrC,YAAA,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC;AACnC,YAAA,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;;;YAGxB,OAAO,IAAI,OAAO,CAAQ,MAAK,EAAE,CAAC,CAAC;QACrC;;;;AAKA,QAAA,MAAM,KAAK;IACb;;;AAIA,IAAA,yBAAyB,CAAC,GAAG,CAAC,KAAK,CAAC;AACpC,IAAA,OAAO,SAAS;AAClB;;"}
+{"version":3,"file":"importWithRetry.utils.js","sources":["../../../src/utilities/renderUtils/importWithRetry.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;;AAQG;AACH;MACa,eAAe,GAAG,OAAO,eAA0B,KAAI;IAClE,MAAM,gCAAgC,GAAG,yBAAyB,CAAC,GAAG,EAAE,KAAK,IAAI;AAEjF,IAAA,IAAI,SAAsD;AAC1D,IAAA,IAAI;AACF,QAAA,SAAS,GAAG,MAAM,eAAe,EAAE;IACrC;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,gCAAgC,EAAE;;;AAGrC,YAAA,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC;AACnC,YAAA,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;;;YAGxB,OAAO,IAAI,OAAO,CAAQ,MAAK,EAAE,CAAC,CAAC;QACrC;;;;AAKA,QAAA,MAAM,KAAK;IACb;;;AAIA,IAAA,yBAAyB,CAAC,GAAG,CAAC,KAAK,CAAC;AACpC,IAAA,OAAO,SAAS;AAClB;;"}