@flipdish/ui-library 0.31.4 → 0.31.6

package/dist/native/components/atoms/Dot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/Dot/index.native.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAU,MAAM,cAAc,CAAC;AAEnE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,GAAI,uDAA6E,QAAQ,gCASxG,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/Dot/index.native.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAU,MAAM,cAAc,CAAC;AAEnE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,GAAI,uDAA6E,QAAQ,gCASxG,CAAC"}

package/dist/native/components/atoms/Dot/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../../../src/components/atoms/Dot/index.native.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;;AAqBA;;;;;;;;;;AAUG;MACU,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,GAAG,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAY,KAAI;AAC3G,IAAA,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5F,IAAA,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;AAEpC,IAAA,QACEA,GAAA,CAAC,IAAI,EAAA,EAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,6BAA6B,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAA,QAAA,EAChHA,IAAC,IAAI,EAAA,EAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAAA,CAAI,EAAA,CACpG;AAEX;;"}
+{"version":3,"file":"index.js","sources":["../../../../../../src/components/atoms/Dot/index.native.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;;AAsBA;;;;;;;;;;AAUG;MACU,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,GAAG,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAY,KAAI;AAC3G,IAAA,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5F,IAAA,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;AAEpC,IAAA,QACEA,GAAA,CAAC,IAAI,EAAA,EAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,6BAA6B,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAA,QAAA,EAChHA,IAAC,IAAI,EAAA,EAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAAA,CAAI,EAAA,CACpG;AAEX;;"}

package/dist/native/utilities/__internal__/componentGuardUtils/componentGuard.utils.d.ts

@@ -12,13 +12,33 @@ type ReactComponent = React.FC<any> | React.ComponentClass<any, any> | React.For
  * (NativeWind). INTERNAL: imported by components as
  * `#internal/utilities/componentGuardUtils/componentGuard.utils`.
  */
-/** Checks if a given value is a function component. */
+/**
+ * Checks if a given value is a function component.
+ *
+ * @param component The value passed where a component or an element is accepted.
+ * @returns `true` for any function, which includes class components.
+ */
 export declare const isFunctionComponent: (component: any) => component is React.FC<any>;
-/** Checks if a given value is a class component. */
+/**
+ * Checks if a given value is a class component.
+ *
+ * @param component The value passed where a component or an element is accepted.
+ * @returns `true` when its prototype marks it as a React class component or it defines `render`.
+ */
 export declare const isClassComponent: (component: any) => component is React.ComponentClass<any, any>;
-/** Checks if a given value is a forward ref component. */
+/**
+ * Checks if a given value is a forward ref component.
+ *
+ * @param component The value passed where a component or an element is accepted.
+ * @returns `true` for an object created by `forwardRef`.
+ */
 export declare const isForwardRefComponent: (component: any) => component is React.ForwardRefExoticComponent<any>;
-/** Checks if a given value is a valid React component (FC, class, or forwardRef). */
+/**
+ * Checks if a given value is a valid React component (FC, class, or forwardRef).
+ *
+ * @param component The value passed where a component or an element is accepted.
+ * @returns `true` when it should be rendered as `<Component />` rather than used as an element.
+ */
 export declare const isReactComponent: (component: any) => component is ReactComponent;
 export {};
 //# sourceMappingURL=componentGuard.utils.d.ts.map

package/dist/native/utilities/__internal__/componentGuardUtils/componentGuard.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"componentGuard.utils.d.ts","sourceRoot":"","sources":["../../../../../src/utilities/__internal__/componentGuardUtils/componentGuard.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,KAAK,cAAc,GAAG,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;AAE5G;;;;;;;;;;;GAWG;AAEH,uDAAuD;AAEvD,eAAO,MAAM,mBAAmB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG,CAE7E,CAAC;AAEF,oDAAoD;AAEpD,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAE3F,CAAC;AAEF,0DAA0D;AAE1D,eAAO,MAAM,qBAAqB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAEtG,CAAC;AAEF,qFAAqF;AAErF,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,cAE9D,CAAC"}
+{"version":3,"file":"componentGuard.utils.d.ts","sourceRoot":"","sources":["../../../../../src/utilities/__internal__/componentGuardUtils/componentGuard.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,KAAK,cAAc,GAAG,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;AAE5G;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AAEH,eAAO,MAAM,mBAAmB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG,CAE7E,CAAC;AAEF;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAE3F,CAAC;AAEF;;;;;GAKG;AAEH,eAAO,MAAM,qBAAqB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAEtG,CAAC;AAEF;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,cAE9D,CAAC"}

package/dist/native/utilities/__internal__/componentGuardUtils/componentGuard.utils.js

@@ -10,22 +10,42 @@
  * (NativeWind). INTERNAL: imported by components as
  * `#internal/utilities/componentGuardUtils/componentGuard.utils`.
  */
-/** Checks if a given value is a function component. */
+/**
+ * Checks if a given value is a function component.
+ *
+ * @param component The value passed where a component or an element is accepted.
+ * @returns `true` for any function, which includes class components.
+ */
 // biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
 const isFunctionComponent = (component) => {
     return typeof component === 'function';
 };
-/** Checks if a given value is a class component. */
+/**
+ * Checks if a given value is a class component.
+ *
+ * @param component The value passed where a component or an element is accepted.
+ * @returns `true` when its prototype marks it as a React class component or it defines `render`.
+ */
 // biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
 const isClassComponent = (component) => {
     return typeof component === 'function' && component.prototype && (!!component.prototype.isReactComponent || !!component.prototype.render);
 };
-/** Checks if a given value is a forward ref component. */
+/**
+ * Checks if a given value is a forward ref component.
+ *
+ * @param component The value passed where a component or an element is accepted.
+ * @returns `true` for an object created by `forwardRef`.
+ */
 // biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
 const isForwardRefComponent = (component) => {
     return typeof component === 'object' && component !== null && component.$$typeof?.toString() === 'Symbol(react.forward_ref)';
 };
-/** Checks if a given value is a valid React component (FC, class, or forwardRef). */
+/**
+ * Checks if a given value is a valid React component (FC, class, or forwardRef).
+ *
+ * @param component The value passed where a component or an element is accepted.
+ * @returns `true` when it should be rendered as `<Component />` rather than used as an element.
+ */
 // biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
 const isReactComponent = (component) => {
     return isFunctionComponent(component) || isForwardRefComponent(component) || isClassComponent(component);

package/dist/native/utilities/__internal__/componentGuardUtils/componentGuard.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"componentGuard.utils.js","sources":["../../../../../../src/utilities/__internal__/componentGuardUtils/componentGuard.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAMA;;;;;;;;;;;AAWG;AAEH;AACA;AACO,MAAM,mBAAmB,GAAG,CAAC,SAAc,KAAgC;AAChF,IAAA,OAAO,OAAO,SAAS,KAAK,UAAU;AACxC;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiD;IAC9F,OAAO,OAAO,SAAS,KAAK,UAAU,IAAI,SAAS,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;AAC3I;AAEA;AACA;AACO,MAAM,qBAAqB,GAAG,CAAC,SAAc,KAAuD;AACzG,IAAA,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,2BAA2B;AAC9H;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiC;AAC9E,IAAA,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC;AAC1G;;"}
+{"version":3,"file":"componentGuard.utils.js","sources":["../../../../../../src/utilities/__internal__/componentGuardUtils/componentGuard.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAMA;;;;;;;;;;;AAWG;AAEH;;;;;AAKG;AACH;AACO,MAAM,mBAAmB,GAAG,CAAC,SAAc,KAAgC;AAChF,IAAA,OAAO,OAAO,SAAS,KAAK,UAAU;AACxC;AAEA;;;;;AAKG;AACH;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiD;IAC9F,OAAO,OAAO,SAAS,KAAK,UAAU,IAAI,SAAS,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;AAC3I;AAEA;;;;;AAKG;AACH;AACO,MAAM,qBAAqB,GAAG,CAAC,SAAc,KAAuD;AACzG,IAAA,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,2BAA2B;AAC9H;AAEA;;;;;AAKG;AACH;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiC;AAC9E,IAAA,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC;AAC1G;;"}

package/dist/native/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/native/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/native/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/native/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/native/utilities/testIdUtils/index.d.ts

@@ -18,19 +18,45 @@
 export declare const TEST_ID_PREFIX = "fd";
 /** Separator placed between hierarchy levels (within a segment, use single `-`). */
 export declare const TEST_ID_SEPARATOR = "--";
-/** Convert an arbitrary string into a kebab-case, testid-safe segment. */
+/**
+ * Converts an arbitrary string into a kebab-case, testid-safe segment.
+ *
+ * @param value A label or id, in any case or punctuation.
+ * @returns Lower-case text with runs of non-alphanumerics collapsed to single hyphens.
+ */
 export declare const slugifyTestId: (value: string) => string;
-/** Build a root-level testid, e.g. `rootTestId('sidebar-navigation')` -> `fd-sidebar-navigation`. */
+/**
+ * Builds a root-level testid, e.g. `rootTestId('sidebar-navigation')` ->
+ * `fd-sidebar-navigation`.
+ *
+ * @param kebabName The component's kebab-case name.
+ * @returns The name prefixed with `fd-`.
+ */
 export declare const rootTestId: (kebabName: string) => string;
-/** Append a child segment to a parent testid, e.g. `joinTestId('fd-x', 'nav-item-orders')` -> `fd-x--nav-item-orders`. */
+/**
+ * Appends a child segment to a parent testid, e.g. `joinTestId('fd-x', 'nav-item-orders')` ->
+ * `fd-x--nav-item-orders`.
+ *
+ * @param prefix The ancestor's resolved testid.
+ * @param segment The child's own segment, already slugified.
+ * @returns The two joined with `--`.
+ */
 export declare const joinTestId: (prefix: string, segment: string) => string;
-/** Return the override when provided, otherwise the fallback (explicit-child case). */
+/**
+ * Returns the override when provided, otherwise the fallback (explicit-child case).
+ *
+ * @param override A consumer-provided `data-testid`, if any.
+ * @param fallback The derived default to use without one.
+ * @returns Whichever applies.
+ */
 export declare const resolveTestId: (override: string | undefined, fallback: string) => string;
 /**
- * Spread helper for the resolved testid. Returns `{ 'data-testid': value }` when
- * a value is present, otherwise an empty object. Centralising this keeps the
- * emitted attribute name in one place (a React Native sibling can map it to
- * `testID` in a follow-up without touching call sites).
+ * Spread helper for a resolved test id: `{ 'data-testid': value }` when present, else an empty
+ * object. Centralising it keeps the attribute name in one place so a React Native sibling can
+ * map it to `testID`.
+ *
+ * @param testId The resolved id, or `undefined` to emit nothing.
+ * @returns Props to spread onto the rendered element.
  */
 export declare const testIdProps: (testId: string | undefined) => {
     "data-testid"?: string;
@@ -39,7 +65,11 @@ export declare const testIdProps: (testId: string | undefined) => {
 export declare const TestIdContext: import("react").Context<string | undefined>;
 /** Provides a resolved testid as the prefix for descendant library components. */
 export declare const TestIdProvider: import("react").Provider<string | undefined>;
-/** Read the testid prefix contributed by an ancestor component (`undefined` at the root). */
+/**
+ * Reads the testid prefix contributed by an ancestor component.
+ *
+ * @returns The ancestor's resolved testid, or `undefined` at the root.
+ */
 export declare const useTestIdPrefix: () => string | undefined;
 export interface UseResolvedTestIdOptions {
     /** Consumer-provided override; wins over any derived value. */
@@ -50,8 +80,12 @@ export interface UseResolvedTestIdOptions {
     rootName: string;
 }
 /**
- * Resolve a component's testid: an explicit override wins; otherwise derive
+ * Resolves a component's testid: an explicit override wins; otherwise derive
  * `<ancestorPrefix>--<segment>` when nested, or `fd-<rootName>` at the root.
+ *
+ * @param options The consumer `testId` override, the component's `segment`, and its
+ *   `rootName`.
+ * @returns The id to render as `data-testid`.
  */
 export declare const useResolvedTestId: ({ testId, segment, rootName }: UseResolvedTestIdOptions) => string;
 //# sourceMappingURL=index.d.ts.map

package/dist/native/utilities/testIdUtils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utilities/testIdUtils/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,sDAAsD;AACtD,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,0EAA0E;AAC1E,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAKlB,CAAC;AAE7B,qGAAqG;AACrG,eAAO,MAAM,UAAU,GAAI,WAAW,MAAM,KAAG,MAA0C,CAAC;AAE1F,0HAA0H;AAC1H,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,SAAS,MAAM,KAAG,MAAmD,CAAC;AAEjH,uFAAuF;AACvF,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,GAAG,SAAS,EAAE,UAAU,MAAM,KAAG,MAA8B,CAAC;AAE9G;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,GAAG,SAAS,KAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAA+C,CAAC;AAEjI,kGAAkG;AAClG,eAAO,MAAM,aAAa,6CAA+C,CAAC;AAE1E,kFAAkF;AAClF,eAAO,MAAM,cAAc,8CAAyB,CAAC;AAErD,6FAA6F;AAC7F,eAAO,MAAM,eAAe,QAAO,MAAM,GAAG,SAAsC,CAAC;AAEnF,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,+BAA+B,wBAAwB,KAAG,MAG3F,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utilities/testIdUtils/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,sDAAsD;AACtD,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAKlB,CAAC;AAE7B;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,WAAW,MAAM,KAAG,MAA0C,CAAC;AAE1F;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,SAAS,MAAM,KAAG,MAAmD,CAAC;AAEjH;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,GAAG,SAAS,EAAE,UAAU,MAAM,KAAG,MAA8B,CAAC;AAE9G;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,GAAG,SAAS,KAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAA+C,CAAC;AAEjI,kGAAkG;AAClG,eAAO,MAAM,aAAa,6CAA+C,CAAC;AAE1E,kFAAkF;AAClF,eAAO,MAAM,cAAc,8CAAyB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAO,MAAM,GAAG,SAAsC,CAAC;AAEnF,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,+BAA+B,wBAAwB,KAAG,MAG3F,CAAC"}

package/dist/native/utilities/testIdUtils/index.js

@@ -20,34 +20,68 @@ import { createContext, useContext } from 'react';
 const TEST_ID_PREFIX = 'fd';
 /** Separator placed between hierarchy levels (within a segment, use single `-`). */
 const TEST_ID_SEPARATOR = '--';
-/** Convert an arbitrary string into a kebab-case, testid-safe segment. */
+/**
+ * Converts an arbitrary string into a kebab-case, testid-safe segment.
+ *
+ * @param value A label or id, in any case or punctuation.
+ * @returns Lower-case text with runs of non-alphanumerics collapsed to single hyphens.
+ */
 const slugifyTestId = (value) => value
     .toLowerCase()
     .trim()
     .replace(/[^a-z0-9]+/g, '-')
     .replace(/^-+|-+$/g, '');
-/** Build a root-level testid, e.g. `rootTestId('sidebar-navigation')` -> `fd-sidebar-navigation`. */
+/**
+ * Builds a root-level testid, e.g. `rootTestId('sidebar-navigation')` ->
+ * `fd-sidebar-navigation`.
+ *
+ * @param kebabName The component's kebab-case name.
+ * @returns The name prefixed with `fd-`.
+ */
 const rootTestId = (kebabName) => `${TEST_ID_PREFIX}-${kebabName}`;
-/** Append a child segment to a parent testid, e.g. `joinTestId('fd-x', 'nav-item-orders')` -> `fd-x--nav-item-orders`. */
+/**
+ * Appends a child segment to a parent testid, e.g. `joinTestId('fd-x', 'nav-item-orders')` ->
+ * `fd-x--nav-item-orders`.
+ *
+ * @param prefix The ancestor's resolved testid.
+ * @param segment The child's own segment, already slugified.
+ * @returns The two joined with `--`.
+ */
 const joinTestId = (prefix, segment) => `${prefix}${TEST_ID_SEPARATOR}${segment}`;
-/** Return the override when provided, otherwise the fallback (explicit-child case). */
+/**
+ * Returns the override when provided, otherwise the fallback (explicit-child case).
+ *
+ * @param override A consumer-provided `data-testid`, if any.
+ * @param fallback The derived default to use without one.
+ * @returns Whichever applies.
+ */
 const resolveTestId = (override, fallback) => override ?? fallback;
 /**
- * Spread helper for the resolved testid. Returns `{ 'data-testid': value }` when
- * a value is present, otherwise an empty object. Centralising this keeps the
- * emitted attribute name in one place (a React Native sibling can map it to
- * `testID` in a follow-up without touching call sites).
+ * Spread helper for a resolved test id: `{ 'data-testid': value }` when present, else an empty
+ * object. Centralising it keeps the attribute name in one place so a React Native sibling can
+ * map it to `testID`.
+ *
+ * @param testId The resolved id, or `undefined` to emit nothing.
+ * @returns Props to spread onto the rendered element.
  */
 const testIdProps = (testId) => (testId ? { 'data-testid': testId } : {});
 /** Context carrying the current resolved testid, used as the prefix for descendant components. */
 const TestIdContext = createContext(undefined);
 /** Provides a resolved testid as the prefix for descendant library components. */
 const TestIdProvider = TestIdContext.Provider;
-/** Read the testid prefix contributed by an ancestor component (`undefined` at the root). */
+/**
+ * Reads the testid prefix contributed by an ancestor component.
+ *
+ * @returns The ancestor's resolved testid, or `undefined` at the root.
+ */
 const useTestIdPrefix = () => useContext(TestIdContext);
 /**
- * Resolve a component's testid: an explicit override wins; otherwise derive
+ * Resolves a component's testid: an explicit override wins; otherwise derive
  * `<ancestorPrefix>--<segment>` when nested, or `fd-<rootName>` at the root.
+ *
+ * @param options The consumer `testId` override, the component's `segment`, and its
+ *   `rootName`.
+ * @returns The id to render as `data-testid`.
  */
 const useResolvedTestId = ({ testId, segment, rootName }) => {
     const prefix = useTestIdPrefix();

package/dist/native/utilities/testIdUtils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../../src/utilities/testIdUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;;;;;;;AAeG;AAEH;AACO,MAAM,cAAc,GAAG;AAE9B;AACO,MAAM,iBAAiB,GAAG;AAEjC;MACa,aAAa,GAAG,CAAC,KAAa,KACzC;AACG,KAAA,WAAW;AACX,KAAA,IAAI;AACJ,KAAA,OAAO,CAAC,aAAa,EAAE,GAAG;AAC1B,KAAA,OAAO,CAAC,UAAU,EAAE,EAAE;AAE3B;AACO,MAAM,UAAU,GAAG,CAAC,SAAiB,KAAa,CAAA,EAAG,cAAc,CAAA,CAAA,EAAI,SAAS;AAEvF;AACO,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe,KAAa,GAAG,MAAM,CAAA,EAAG,iBAAiB,CAAA,EAAG,OAAO;AAE9G;AACO,MAAM,aAAa,GAAG,CAAC,QAA4B,EAAE,QAAgB,KAAa,QAAQ,IAAI;AAErG;;;;;AAKG;AACI,MAAM,WAAW,GAAG,CAAC,MAA0B,MAAkC,MAAM,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE;AAE/H;MACa,aAAa,GAAG,aAAa,CAAqB,SAAS;AAExE;AACO,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C;AACO,MAAM,eAAe,GAAG,MAA0B,UAAU,CAAC,aAAa;AAWjF;;;AAGG;AACI,MAAM,iBAAiB,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAA4B,KAAY;AACnG,IAAA,MAAM,MAAM,GAAG,eAAe,EAAE;IAChC,OAAO,MAAM,KAAK,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;AAChF;;"}
+{"version":3,"file":"index.js","sources":["../../../../../src/utilities/testIdUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;;;;;;;AAeG;AAEH;AACO,MAAM,cAAc,GAAG;AAE9B;AACO,MAAM,iBAAiB,GAAG;AAEjC;;;;;AAKG;MACU,aAAa,GAAG,CAAC,KAAa,KACzC;AACG,KAAA,WAAW;AACX,KAAA,IAAI;AACJ,KAAA,OAAO,CAAC,aAAa,EAAE,GAAG;AAC1B,KAAA,OAAO,CAAC,UAAU,EAAE,EAAE;AAE3B;;;;;;AAMG;AACI,MAAM,UAAU,GAAG,CAAC,SAAiB,KAAa,CAAA,EAAG,cAAc,CAAA,CAAA,EAAI,SAAS;AAEvF;;;;;;;AAOG;AACI,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe,KAAa,GAAG,MAAM,CAAA,EAAG,iBAAiB,CAAA,EAAG,OAAO;AAE9G;;;;;;AAMG;AACI,MAAM,aAAa,GAAG,CAAC,QAA4B,EAAE,QAAgB,KAAa,QAAQ,IAAI;AAErG;;;;;;;AAOG;AACI,MAAM,WAAW,GAAG,CAAC,MAA0B,MAAkC,MAAM,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE;AAE/H;MACa,aAAa,GAAG,aAAa,CAAqB,SAAS;AAExE;AACO,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C;;;;AAIG;AACI,MAAM,eAAe,GAAG,MAA0B,UAAU,CAAC,aAAa;AAWjF;;;;;;;AAOG;AACI,MAAM,iBAAiB,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAA4B,KAAY;AACnG,IAAA,MAAM,MAAM,GAAG,eAAe,EAAE;IAChC,OAAO,MAAM,KAAK,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;AAChF;;"}

package/dist/providers/ErrorBoundary/index.cjs

@@ -5,15 +5,13 @@ var cx = require('@flipdish/ui-library/utilities/cx');
 var reactErrorBoundary = require('react-error-boundary');
 
 /**
- * Thin wrapper around `react-error-boundary` so consuming apps depend on a single
- * ui-library seam instead of importing `react-error-boundary` directly. Inspired by
- * FlipdishUI's `FDErrorBoundary`, minus the MUI styling and the hardcoded web logger
- * (reporting is injected via `onError` to keep the library cross-platform).
+ * Catches render errors in its subtree and shows a fallback instead of crashing the app, as a
+ * thin wrapper around `react-error-boundary` so apps depend on one ui-library seam. Reporting
+ * is injected through `onError`, which keeps the boundary cross-platform.
  *
- * Lives under `providers/` (not the visual atomic ladder) because it's a cross-cutting
- * behavioural wrapper, not a UI primitive. The boundary logic is RN-safe; the default
- * fallback renders a `<div>`, so an `index.native.tsx` sibling is needed before RN use.
+ * @summary render error boundary with a fallback and onError reporting
  */
+// The default fallback renders a <div>, so an index.native.tsx sibling is needed before React Native use.
 const ErrorBoundary = ({ identifier, children, fallback, renderFallback, somethingWentWrongText = 'Something went wrong', onError, className, }) => {
     return (jsxRuntime.jsx(reactErrorBoundary.ErrorBoundary, { fallbackRender: ({ error }) => {
             // Use `undefined` (not nullish) checks so an explicit `null` from

package/dist/providers/ErrorBoundary/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/providers/ErrorBoundary/index.tsx"],"sourcesContent":[null],"names":["_jsx","ReactErrorBoundary","cx"],"mappings":";;;;;;AA0BA;;;;;;;;;AASG;MACU,aAAa,GAAG,CAAC,EAC5B,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,sBAAsB,GAAG,sBAAsB,EAC/C,OAAO,EACP,SAAS,GACU,KAAe;IAClC,QACEA,cAAA,CAACC,gCAAkB,EAAA,EACjB,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,KAAI;;;AAG5B,YAAA,IAAI,cAAc,KAAK,SAAS,EAAE;AAChC,gBAAA,OAAO,cAAc,CAAC,KAAc,CAAC;YACvC;AACA,YAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;AAC1B,gBAAA,OAAO,QAAQ;YACjB;AACA,YAAA,QACED,cAAA,CAAA,KAAA,EAAA,EAAK,IAAI,EAAC,OAAO,EAAC,SAAS,EAAEE,KAAE,CAAC,yEAAyE,EAAE,SAAS,CAAC,YAClH,sBAAsB,EAAA,CACnB;QAEV,CAAC,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,KAAI;;YAEvB,OAAO,CAAC,KAAK,CAAC,CAAA,eAAA,EAAkB,UAAU,CAAA,CAAA,CAAG,EAAE,KAAK,CAAC;AACrD,YAAA,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC;AACxB,QAAA,CAAC,EAAA,QAAA,EAEA,QAAQ,EAAA,CACU;AAEzB;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/providers/ErrorBoundary/index.tsx"],"sourcesContent":[null],"names":["_jsx","ReactErrorBoundary","cx"],"mappings":";;;;;;AA2BA;;;;;;AAMG;AACH;MACa,aAAa,GAAG,CAAC,EAC5B,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,sBAAsB,GAAG,sBAAsB,EAC/C,OAAO,EACP,SAAS,GACU,KAAe;IAClC,QACEA,cAAA,CAACC,gCAAkB,EAAA,EACjB,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,KAAI;;;AAG5B,YAAA,IAAI,cAAc,KAAK,SAAS,EAAE;AAChC,gBAAA,OAAO,cAAc,CAAC,KAAc,CAAC;YACvC;AACA,YAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;AAC1B,gBAAA,OAAO,QAAQ;YACjB;AACA,YAAA,QACED,cAAA,CAAA,KAAA,EAAA,EAAK,IAAI,EAAC,OAAO,EAAC,SAAS,EAAEE,KAAE,CAAC,yEAAyE,EAAE,SAAS,CAAC,YAClH,sBAAsB,EAAA,CACnB;QAEV,CAAC,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,KAAI;;YAEvB,OAAO,CAAC,KAAK,CAAC,CAAA,eAAA,EAAkB,UAAU,CAAA,CAAA,CAAG,EAAE,KAAK,CAAC;AACrD,YAAA,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC;AACxB,QAAA,CAAC,EAAA,QAAA,EAEA,QAAQ,EAAA,CACU;AAEzB;;"}

package/dist/providers/ErrorBoundary/index.d.ts

@@ -2,6 +2,7 @@ import type { ErrorInfo, ReactNode } from 'react';
 export interface ErrorBoundaryProps {
     /** Identifies this boundary in error logs/RUM (e.g. a page or feature name). */
     identifier: string;
+    /** Content guarded by the boundary; replaced by the fallback when it throws during render. */
     children: ReactNode;
     /** Static fallback node. Takes precedence over `somethingWentWrongText`. */
     fallback?: ReactNode;
@@ -19,14 +20,11 @@ export interface ErrorBoundaryProps {
     className?: string;
 }
 /**
- * Thin wrapper around `react-error-boundary` so consuming apps depend on a single
- * ui-library seam instead of importing `react-error-boundary` directly. Inspired by
- * FlipdishUI's `FDErrorBoundary`, minus the MUI styling and the hardcoded web logger
- * (reporting is injected via `onError` to keep the library cross-platform).
+ * Catches render errors in its subtree and shows a fallback instead of crashing the app, as a
+ * thin wrapper around `react-error-boundary` so apps depend on one ui-library seam. Reporting
+ * is injected through `onError`, which keeps the boundary cross-platform.
  *
- * Lives under `providers/` (not the visual atomic ladder) because it's a cross-cutting
- * behavioural wrapper, not a UI primitive. The boundary logic is RN-safe; the default
- * fallback renders a `<div>`, so an `index.native.tsx` sibling is needed before RN use.
+ * @summary render error boundary with a fallback and onError reporting
  */
 export declare const ErrorBoundary: ({ identifier, children, fallback, renderFallback, somethingWentWrongText, onError, className, }: ErrorBoundaryProps) => ReactNode;
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/ErrorBoundary/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/ErrorBoundary/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlD,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC;IAC7C;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,iGAQ3B,kBAAkB,KAAG,SA2BvB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/ErrorBoundary/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlD,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,QAAQ,EAAE,SAAS,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC;IAC7C;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AAEH,eAAO,MAAM,aAAa,GAAI,iGAQ3B,kBAAkB,KAAG,SA2BvB,CAAC"}

package/dist/providers/ErrorBoundary/index.js

@@ -3,15 +3,13 @@ import { cx } from '@flipdish/ui-library/utilities/cx';
 import { ErrorBoundary as ErrorBoundary$1 } from 'react-error-boundary';
 
 /**
- * Thin wrapper around `react-error-boundary` so consuming apps depend on a single
- * ui-library seam instead of importing `react-error-boundary` directly. Inspired by
- * FlipdishUI's `FDErrorBoundary`, minus the MUI styling and the hardcoded web logger
- * (reporting is injected via `onError` to keep the library cross-platform).
+ * Catches render errors in its subtree and shows a fallback instead of crashing the app, as a
+ * thin wrapper around `react-error-boundary` so apps depend on one ui-library seam. Reporting
+ * is injected through `onError`, which keeps the boundary cross-platform.
  *
- * Lives under `providers/` (not the visual atomic ladder) because it's a cross-cutting
- * behavioural wrapper, not a UI primitive. The boundary logic is RN-safe; the default
- * fallback renders a `<div>`, so an `index.native.tsx` sibling is needed before RN use.
+ * @summary render error boundary with a fallback and onError reporting
  */
+// The default fallback renders a <div>, so an index.native.tsx sibling is needed before React Native use.
 const ErrorBoundary = ({ identifier, children, fallback, renderFallback, somethingWentWrongText = 'Something went wrong', onError, className, }) => {
     return (jsx(ErrorBoundary$1, { fallbackRender: ({ error }) => {
             // Use `undefined` (not nullish) checks so an explicit `null` from

package/dist/providers/ErrorBoundary/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/providers/ErrorBoundary/index.tsx"],"sourcesContent":[null],"names":["_jsx","ReactErrorBoundary"],"mappings":";;;;AA0BA;;;;;;;;;AASG;MACU,aAAa,GAAG,CAAC,EAC5B,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,sBAAsB,GAAG,sBAAsB,EAC/C,OAAO,EACP,SAAS,GACU,KAAe;IAClC,QACEA,GAAA,CAACC,eAAkB,EAAA,EACjB,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,KAAI;;;AAG5B,YAAA,IAAI,cAAc,KAAK,SAAS,EAAE;AAChC,gBAAA,OAAO,cAAc,CAAC,KAAc,CAAC;YACvC;AACA,YAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;AAC1B,gBAAA,OAAO,QAAQ;YACjB;AACA,YAAA,QACED,GAAA,CAAA,KAAA,EAAA,EAAK,IAAI,EAAC,OAAO,EAAC,SAAS,EAAE,EAAE,CAAC,yEAAyE,EAAE,SAAS,CAAC,YAClH,sBAAsB,EAAA,CACnB;QAEV,CAAC,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,KAAI;;YAEvB,OAAO,CAAC,KAAK,CAAC,CAAA,eAAA,EAAkB,UAAU,CAAA,CAAA,CAAG,EAAE,KAAK,CAAC;AACrD,YAAA,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC;AACxB,QAAA,CAAC,EAAA,QAAA,EAEA,QAAQ,EAAA,CACU;AAEzB;;"}
+{"version":3,"file":"index.js","sources":["../../../src/providers/ErrorBoundary/index.tsx"],"sourcesContent":[null],"names":["_jsx","ReactErrorBoundary"],"mappings":";;;;AA2BA;;;;;;AAMG;AACH;MACa,aAAa,GAAG,CAAC,EAC5B,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,sBAAsB,GAAG,sBAAsB,EAC/C,OAAO,EACP,SAAS,GACU,KAAe;IAClC,QACEA,GAAA,CAACC,eAAkB,EAAA,EACjB,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,KAAI;;;AAG5B,YAAA,IAAI,cAAc,KAAK,SAAS,EAAE;AAChC,gBAAA,OAAO,cAAc,CAAC,KAAc,CAAC;YACvC;AACA,YAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;AAC1B,gBAAA,OAAO,QAAQ;YACjB;AACA,YAAA,QACED,GAAA,CAAA,KAAA,EAAA,EAAK,IAAI,EAAC,OAAO,EAAC,SAAS,EAAE,EAAE,CAAC,yEAAyE,EAAE,SAAS,CAAC,YAClH,sBAAsB,EAAA,CACnB;QAEV,CAAC,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,KAAI;;YAEvB,OAAO,CAAC,KAAK,CAAC,CAAA,eAAA,EAAkB,UAAU,CAAA,CAAA,CAAG,EAAE,KAAK,CAAC;AACrD,YAAA,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC;AACxB,QAAA,CAAC,EAAA,QAAA,EAEA,QAAQ,EAAA,CACU;AAEzB;;"}

package/dist/providers/PortalContainer/index.cjs

@@ -7,7 +7,7 @@ var reactAria = require('react-aria');
  * Redirects React Aria overlay portals into a specific DOM container instead of
  * `document.body`. Use for micro-frontends and embedded apps with scoped CSS.
  *
- * @summary redirects React Aria overlay portals into a scoped DOM container
+ * @summary portal React Aria overlays into a scoped DOM container
  */
 const PortalContainer = ({ getContainer, children }) => {
     if (!getContainer) {

package/dist/providers/PortalContainer/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/providers/PortalContainer/index.tsx"],"sourcesContent":[null],"names":["_jsx","_Fragment","UNSAFE_PortalProvider"],"mappings":";;;;;AA+BA;;;;;AAKG;AACI,MAAM,eAAe,GAAG,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAwB,KAAI;IAClF,IAAI,CAAC,YAAY,EAAE;QACjB,OAAOA,cAAA,CAAAC,mBAAA,EAAA,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAI;IACxB;IAEA,OAAOD,cAAA,CAACE,+BAAqB,EAAA,EAAC,YAAY,EAAE,YAAY,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAyB;AAC9F;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/providers/PortalContainer/index.tsx"],"sourcesContent":[null],"names":["_jsx","_Fragment","UNSAFE_PortalProvider"],"mappings":";;;;;AAgCA;;;;;AAKG;AACI,MAAM,eAAe,GAAG,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAwB,KAAI;IAClF,IAAI,CAAC,YAAY,EAAE;QACjB,OAAOA,cAAA,CAAAC,mBAAA,EAAA,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAI;IACxB;IAEA,OAAOD,cAAA,CAACE,+BAAqB,EAAA,EAAC,YAAY,EAAE,YAAY,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAyB;AAC9F;;"}

package/dist/providers/PortalContainer/index.d.ts

@@ -24,13 +24,14 @@ export interface PortalContainerProps {
      * </PortalContainer>
      */
     getContainer: (() => HTMLElement | null) | null;
+    /** Subtree whose React Aria overlays portal into the container. */
     children: ReactNode;
 }
 /**
  * Redirects React Aria overlay portals into a specific DOM container instead of
  * `document.body`. Use for micro-frontends and embedded apps with scoped CSS.
  *
- * @summary redirects React Aria overlay portals into a scoped DOM container
+ * @summary portal React Aria overlays into a scoped DOM container
  */
 export declare const PortalContainer: ({ getContainer, children }: PortalContainerProps) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/PortalContainer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/PortalContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,EAAE,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,4BAA4B,oBAAoB,gCAM/E,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/PortalContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,EAAE,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChD,mEAAmE;IACnE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,4BAA4B,oBAAoB,gCAM/E,CAAC"}

package/dist/providers/PortalContainer/index.js

@@ -5,7 +5,7 @@ import { UNSAFE_PortalProvider } from 'react-aria';
  * Redirects React Aria overlay portals into a specific DOM container instead of
  * `document.body`. Use for micro-frontends and embedded apps with scoped CSS.
  *
- * @summary redirects React Aria overlay portals into a scoped DOM container
+ * @summary portal React Aria overlays into a scoped DOM container
  */
 const PortalContainer = ({ getContainer, children }) => {
     if (!getContainer) {

package/dist/providers/PortalContainer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/providers/PortalContainer/index.tsx"],"sourcesContent":[null],"names":["_jsx","_Fragment"],"mappings":";;;AA+BA;;;;;AAKG;AACI,MAAM,eAAe,GAAG,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAwB,KAAI;IAClF,IAAI,CAAC,YAAY,EAAE;QACjB,OAAOA,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAI;IACxB;IAEA,OAAOD,GAAA,CAAC,qBAAqB,EAAA,EAAC,YAAY,EAAE,YAAY,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAyB;AAC9F;;"}
+{"version":3,"file":"index.js","sources":["../../../src/providers/PortalContainer/index.tsx"],"sourcesContent":[null],"names":["_jsx","_Fragment"],"mappings":";;;AAgCA;;;;;AAKG;AACI,MAAM,eAAe,GAAG,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAwB,KAAI;IAClF,IAAI,CAAC,YAAY,EAAE;QACjB,OAAOA,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAI;IACxB;IAEA,OAAOD,GAAA,CAAC,qBAAqB,EAAA,EAAC,YAAY,EAAE,YAAY,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAyB;AAC9F;;"}

package/dist/providers/RouteProvider/index.cjs

@@ -5,7 +5,11 @@ var reactAriaComponents = require('react-aria-components');
 var reactRouter = require('react-router');
 
 /**
- * @summary wires react-aria-components routing into react-router navigation
+ * Connects react-aria-components client-side navigation to react-router, so links and menu
+ * items with `href` route through the router instead of a full page load. Place it inside the
+ * router, around the component tree.
+ *
+ * @summary routes react-aria navigation through react-router
  */
 const RouteProvider = ({ children }) => {
     const navigate = reactRouter.useNavigate();

package/dist/providers/RouteProvider/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/providers/RouteProvider/index.tsx"],"sourcesContent":[null],"names":["useNavigate","_jsx","RouterProvider","useHref"],"mappings":";;;;;;AAaA;;AAEG;MACU,aAAa,GAAG,CAAC,EAAE,QAAQ,EAAqB,KAAI;AAC/D,IAAA,MAAM,QAAQ,GAAGA,uBAAW,EAAE;AAE9B,IAAA,QACEC,cAAA,CAACC,kCAAc,EAAA,EAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAEC,mBAAO,EAAA,QAAA,EACjD,QAAQ,EAAA,CACM;AAErB;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/providers/RouteProvider/index.tsx"],"sourcesContent":[null],"names":["useNavigate","_jsx","RouterProvider","useHref"],"mappings":";;;;;;AAaA;;;;;;AAMG;MACU,aAAa,GAAG,CAAC,EAAE,QAAQ,EAAqB,KAAI;AAC/D,IAAA,MAAM,QAAQ,GAAGA,uBAAW,EAAE;AAE9B,IAAA,QACEC,cAAA,CAACC,kCAAc,EAAA,EAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAEC,mBAAO,EAAA,QAAA,EACjD,QAAQ,EAAA,CACM;AAErB;;"}

package/dist/providers/RouteProvider/index.d.ts

@@ -6,7 +6,11 @@ declare module 'react-aria-components' {
     }
 }
 /**
- * @summary wires react-aria-components routing into react-router navigation
+ * Connects react-aria-components client-side navigation to react-router, so links and menu
+ * items with `href` route through the router instead of a full page load. Place it inside the
+ * router, around the component tree.
+ *
+ * @summary routes react-aria navigation through react-router
  */
 export declare const RouteProvider: ({ children }: PropsWithChildren) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/RouteProvider/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/RouteProvider/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,QAAQ,uBAAuB,CAAC;IACrC,UAAU,YAAY;QACpB,aAAa,EAAE,eAAe,CAAC;KAChC;CACF;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,cAAc,iBAAiB,gCAQ5D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/RouteProvider/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,QAAQ,uBAAuB,CAAC;IACrC,UAAU,YAAY;QACpB,aAAa,EAAE,eAAe,CAAC;KAChC;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,cAAc,iBAAiB,gCAQ5D,CAAC"}

package/dist/providers/RouteProvider/index.js

@@ -3,7 +3,11 @@ import { RouterProvider } from 'react-aria-components';
 import { useNavigate, useHref } from 'react-router';
 
 /**
- * @summary wires react-aria-components routing into react-router navigation
+ * Connects react-aria-components client-side navigation to react-router, so links and menu
+ * items with `href` route through the router instead of a full page load. Place it inside the
+ * router, around the component tree.
+ *
+ * @summary routes react-aria navigation through react-router
  */
 const RouteProvider = ({ children }) => {
     const navigate = useNavigate();

package/dist/providers/RouteProvider/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/providers/RouteProvider/index.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;AAaA;;AAEG;MACU,aAAa,GAAG,CAAC,EAAE,QAAQ,EAAqB,KAAI;AAC/D,IAAA,MAAM,QAAQ,GAAG,WAAW,EAAE;AAE9B,IAAA,QACEA,GAAA,CAAC,cAAc,EAAA,EAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAA,QAAA,EACjD,QAAQ,EAAA,CACM;AAErB;;"}
+{"version":3,"file":"index.js","sources":["../../../src/providers/RouteProvider/index.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;AAaA;;;;;;AAMG;MACU,aAAa,GAAG,CAAC,EAAE,QAAQ,EAAqB,KAAI;AAC/D,IAAA,MAAM,QAAQ,GAAG,WAAW,EAAE;AAE9B,IAAA,QACEA,GAAA,CAAC,cAAc,EAAA,EAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAA,QAAA,EACjD,QAAQ,EAAA,CACM;AAErB;;"}