@flipdish/ui-library 0.10.0 → 0.11.1

package/dist/components/templates/PageLayout/index.d.ts

@@ -26,6 +26,8 @@ export interface PageLayoutProps {
     onError?: (error: Error, info: ErrorInfo) => void;
     /** Extra classes merged onto the root `<main>`. */
     className?: string;
+    /** Overrides the `data-testid` (defaults to `fd-page-layout`). */
+    'data-testid'?: string;
 }
 /**
  * Page-shaped template that standardises the MFE's page chrome: the centered `<main>`
@@ -41,5 +43,5 @@ export interface PageLayoutProps {
  *
  * @summary app-shell page template with a page-scoped error boundary
  */
-export declare const PageLayout: ({ pageName, header, children, renderError, onError, className }: PageLayoutProps) => ReactNode;
+export declare const PageLayout: ({ pageName, header, children, renderError, onError, className, "data-testid": dataTestId, }: PageLayoutProps) => ReactNode;
 //# sourceMappingURL=index.d.ts.map

package/dist/components/templates/PageLayout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/templates/PageLayout/index.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,wDAAwD;IACxD,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC;IACvE,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAcD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,GAAI,iEAAiE,eAAe,KAAG,SAU7G,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/templates/PageLayout/index.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,wDAAwD;IACxD,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC;IACvE,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAcD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,GAAI,6FAQxB,eAAe,KAAG,SAgBpB,CAAC"}

package/dist/components/templates/PageLayout/index.js

@@ -1,13 +1,14 @@
 import { jsxs, jsx } from 'react/jsx-runtime';
 import { ErrorBoundary } from '@flipdish/ui-library/providers/ErrorBoundary';
 import { cx } from '@flipdish/ui-library/utilities/cx';
+import { useResolvedTestId, joinTestId } from '@flipdish/ui-library/utilities/testIdUtils';
 
 /**
  * English defaults, overridable via `renderError` (the consumer owns localisation).
  * TODO(i18n): once ui-library has its own translation layer, source these strings
  * from it instead of hardcoding English (keep `renderError` as a consumer override).
  */
-const DefaultPageError = () => (jsxs("div", { role: "alert", className: "flex w-full max-w-container flex-col items-center gap-2 px-md py-2xl text-center lg:px-2xl", children: [jsx("h2", { className: "text-lg font-semibold text-primary", children: "Something went wrong" }), jsx("p", { className: "text-md text-tertiary", children: "An unexpected error occurred while loading this page." })] }));
+const DefaultPageError = ({ testId }) => (jsxs("div", { role: "alert", "data-testid": testId, className: "flex w-full max-w-container flex-col items-center gap-2 px-md py-2xl text-center lg:px-2xl", children: [jsx("h2", { className: "text-lg font-semibold text-primary", children: "Something went wrong" }), jsx("p", { className: "text-md text-tertiary", children: "An unexpected error occurred while loading this page." })] }));
 /**
  * Page-shaped template that standardises the MFE's page chrome: the centered `<main>`
  * scroll container, an optional header region, and a page-scoped error boundary keyed
@@ -22,8 +23,9 @@ const DefaultPageError = () => (jsxs("div", { role: "alert", className: "flex w-
  *
  * @summary app-shell page template with a page-scoped error boundary
  */
-const PageLayout = ({ pageName, header, children, renderError, onError, className }) => {
-    return (jsxs("main", { className: cx('flex w-full flex-col items-center gap-xl py-2xl lg:gap-2xl lg:pb-3xl', className), children: [header, jsx(ErrorBoundary, { identifier: pageName, onError: onError, renderFallback: (error) => renderError?.({ error, pageName }) ?? jsx(DefaultPageError, {}), children: children })] }));
+const PageLayout = ({ pageName, header, children, renderError, onError, className, 'data-testid': dataTestId, }) => {
+    const pageLayoutTestId = useResolvedTestId({ testId: dataTestId, segment: 'page-layout', rootName: 'page-layout' });
+    return (jsxs("main", { "data-testid": pageLayoutTestId, className: cx('flex w-full flex-col items-center gap-xl py-2xl lg:gap-2xl lg:pb-3xl', className), children: [header, jsx(ErrorBoundary, { identifier: pageName, onError: onError, renderFallback: (error) => renderError?.({ error, pageName }) ?? jsx(DefaultPageError, { testId: joinTestId(pageLayoutTestId, 'error') }), children: children })] }));
 };
 
 export { PageLayout };

package/dist/components/templates/PageLayout/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/components/templates/PageLayout/index.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx"],"mappings":";;;;AAgCA;;;;AAIG;AACH,MAAM,gBAAgB,GAAG,OACvBA,IAAA,CAAA,KAAA,EAAA,EAAK,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,4FAA4F,EAAA,QAAA,EAAA,CACtHC,GAAA,CAAA,IAAA,EAAA,EAAI,SAAS,EAAC,oCAAoC,EAAA,QAAA,EAAA,sBAAA,EAAA,CAA0B,EAC5EA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,uBAAuB,EAAA,QAAA,EAAA,uDAAA,EAAA,CAA0D,CAAA,EAAA,CAC1F,CACP;AAED;;;;;;;;;;;;;AAaG;AACI,MAAM,UAAU,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAmB,KAAe;IACxH,QACED,eAAM,SAAS,EAAE,EAAE,CAAC,sEAAsE,EAAE,SAAS,CAAC,EAAA,QAAA,EAAA,CACnG,MAAM,EAEPC,GAAA,CAAC,aAAa,EAAA,EAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,KAAK,KAAK,WAAW,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAIA,GAAA,CAAC,gBAAgB,EAAA,EAAA,CAAG,YACzI,QAAQ,EAAA,CACK,CAAA,EAAA,CACX;AAEX;;;;"}
+{"version":3,"file":"index.js","sources":["../../../../src/components/templates/PageLayout/index.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx"],"mappings":";;;;;AAmCA;;;;AAIG;AACH,MAAM,gBAAgB,GAAG,CAAC,EAAE,MAAM,EAAuB,MACvDA,IAAA,CAAA,KAAA,EAAA,EAAK,IAAI,EAAC,OAAO,iBAAc,MAAM,EAAE,SAAS,EAAC,4FAA4F,EAAA,QAAA,EAAA,CAC3IC,GAAA,CAAA,IAAA,EAAA,EAAI,SAAS,EAAC,oCAAoC,EAAA,QAAA,EAAA,sBAAA,EAAA,CAA0B,EAC5EA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,uBAAuB,EAAA,QAAA,EAAA,uDAAA,EAAA,CAA0D,CAAA,EAAA,CAC1F,CACP;AAED;;;;;;;;;;;;;AAaG;MACU,UAAU,GAAG,CAAC,EACzB,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,WAAW,EACX,OAAO,EACP,SAAS,EACT,aAAa,EAAE,UAAU,GACT,KAAe;AAC/B,IAAA,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AAEnH,IAAA,QACED,IAAA,CAAA,MAAA,EAAA,EAAA,aAAA,EAAmB,gBAAgB,EAAE,SAAS,EAAE,EAAE,CAAC,sEAAsE,EAAE,SAAS,CAAC,EAAA,QAAA,EAAA,CAClI,MAAM,EAEPC,GAAA,CAAC,aAAa,EAAA,EACZ,UAAU,EAAE,QAAQ,EACpB,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,CAAC,KAAK,KAAK,WAAW,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAIA,GAAA,CAAC,gBAAgB,EAAA,EAAC,MAAM,EAAE,UAAU,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAA,CAAI,EAAA,QAAA,EAEnI,QAAQ,EAAA,CACK,CAAA,EAAA,CACX;AAEX;;;;"}

package/dist/utilities/testIdUtils/index.cjs

@@ -0,0 +1,70 @@
+'use strict';
+
+var React = require('react');
+
+/**
+ * Test-id convention for `@flipdish/ui-library`.
+ *
+ * Every component exposes an overridable `data-testid`. When omitted, a default
+ * is derived so automated tests always have a stable hook:
+ *
+ * - Root components default to `fd-<kebab-name>` (e.g. `fd-sidebar-navigation`).
+ * - Nested components inherit the ancestor's *resolved* testid as their prefix
+ *   and append `--<segment>`, so the `fd-` prefix appears exactly once at the
+ *   front: `fd-sidebar-navigation--nav-item-orders`.
+ * - A consumer-provided `data-testid` always wins and re-roots the prefix for
+ *   everything beneath it.
+ *
+ * Pure React (no DOM / react-aria dependency), so it is safe to import from any
+ * layer. Consumed as `@flipdish/ui-library/utilities/testIdUtils`.
+ */
+/** Namespace prepended to every root-level testid. */
+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. */
+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`. */
+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`. */
+const joinTestId = (prefix, segment) => `${prefix}${TEST_ID_SEPARATOR}${segment}`;
+/** Return the override when provided, otherwise the fallback (explicit-child case). */
+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).
+ */
+const testIdProps = (testId) => (testId ? { 'data-testid': testId } : {});
+/** Context carrying the current resolved testid, used as the prefix for descendant components. */
+const TestIdContext = React.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). */
+const useTestIdPrefix = () => React.useContext(TestIdContext);
+/**
+ * Resolve a component's testid: an explicit override wins; otherwise derive
+ * `<ancestorPrefix>--<segment>` when nested, or `fd-<rootName>` at the root.
+ */
+const useResolvedTestId = ({ testId, segment, rootName }) => {
+    const prefix = useTestIdPrefix();
+    return testId ?? (prefix ? joinTestId(prefix, segment) : rootTestId(rootName));
+};
+
+exports.TEST_ID_PREFIX = TEST_ID_PREFIX;
+exports.TEST_ID_SEPARATOR = TEST_ID_SEPARATOR;
+exports.TestIdContext = TestIdContext;
+exports.TestIdProvider = TestIdProvider;
+exports.joinTestId = joinTestId;
+exports.resolveTestId = resolveTestId;
+exports.rootTestId = rootTestId;
+exports.slugifyTestId = slugifyTestId;
+exports.testIdProps = testIdProps;
+exports.useResolvedTestId = useResolvedTestId;
+exports.useTestIdPrefix = useTestIdPrefix;
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/testIdUtils/index.ts"],"sourcesContent":[null],"names":["createContext","useContext"],"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,GAAGA,mBAAa,CAAqB,SAAS;AAExE;AACO,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C;AACO,MAAM,eAAe,GAAG,MAA0BC,gBAAU,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;;;;;;;;;;;;;;"}

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

@@ -0,0 +1,57 @@
+/**
+ * Test-id convention for `@flipdish/ui-library`.
+ *
+ * Every component exposes an overridable `data-testid`. When omitted, a default
+ * is derived so automated tests always have a stable hook:
+ *
+ * - Root components default to `fd-<kebab-name>` (e.g. `fd-sidebar-navigation`).
+ * - Nested components inherit the ancestor's *resolved* testid as their prefix
+ *   and append `--<segment>`, so the `fd-` prefix appears exactly once at the
+ *   front: `fd-sidebar-navigation--nav-item-orders`.
+ * - A consumer-provided `data-testid` always wins and re-roots the prefix for
+ *   everything beneath it.
+ *
+ * Pure React (no DOM / react-aria dependency), so it is safe to import from any
+ * layer. Consumed as `@flipdish/ui-library/utilities/testIdUtils`.
+ */
+/** Namespace prepended to every root-level testid. */
+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. */
+export declare const slugifyTestId: (value: string) => string;
+/** Build a root-level testid, e.g. `rootTestId('sidebar-navigation')` -> `fd-sidebar-navigation`. */
+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`. */
+export declare const joinTestId: (prefix: string, segment: string) => string;
+/** Return the override when provided, otherwise the fallback (explicit-child case). */
+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).
+ */
+export declare const testIdProps: (testId: string | undefined) => {
+    "data-testid"?: string;
+};
+/** Context carrying the current resolved testid, used as the prefix for descendant components. */
+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). */
+export declare const useTestIdPrefix: () => string | undefined;
+export interface UseResolvedTestIdOptions {
+    /** Consumer-provided override; wins over any derived value. */
+    testId?: string;
+    /** Segment appended to the inherited prefix when nested. */
+    segment: string;
+    /** Kebab component name used to build the root default when not nested. */
+    rootName: string;
+}
+/**
+ * Resolve a component's testid: an explicit override wins; otherwise derive
+ * `<ancestorPrefix>--<segment>` when nested, or `fd-<rootName>` at the root.
+ */
+export declare const useResolvedTestId: ({ testId, segment, rootName }: UseResolvedTestIdOptions) => string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/utilities/testIdUtils/index.js

@@ -0,0 +1,58 @@
+import { createContext, useContext } from 'react';
+
+/**
+ * Test-id convention for `@flipdish/ui-library`.
+ *
+ * Every component exposes an overridable `data-testid`. When omitted, a default
+ * is derived so automated tests always have a stable hook:
+ *
+ * - Root components default to `fd-<kebab-name>` (e.g. `fd-sidebar-navigation`).
+ * - Nested components inherit the ancestor's *resolved* testid as their prefix
+ *   and append `--<segment>`, so the `fd-` prefix appears exactly once at the
+ *   front: `fd-sidebar-navigation--nav-item-orders`.
+ * - A consumer-provided `data-testid` always wins and re-roots the prefix for
+ *   everything beneath it.
+ *
+ * Pure React (no DOM / react-aria dependency), so it is safe to import from any
+ * layer. Consumed as `@flipdish/ui-library/utilities/testIdUtils`.
+ */
+/** Namespace prepended to every root-level testid. */
+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. */
+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`. */
+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`. */
+const joinTestId = (prefix, segment) => `${prefix}${TEST_ID_SEPARATOR}${segment}`;
+/** Return the override when provided, otherwise the fallback (explicit-child case). */
+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).
+ */
+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). */
+const useTestIdPrefix = () => useContext(TestIdContext);
+/**
+ * Resolve a component's testid: an explicit override wins; otherwise derive
+ * `<ancestorPrefix>--<segment>` when nested, or `fd-<rootName>` at the root.
+ */
+const useResolvedTestId = ({ testId, segment, rootName }) => {
+    const prefix = useTestIdPrefix();
+    return testId ?? (prefix ? joinTestId(prefix, segment) : rootTestId(rootName));
+};
+
+export { TEST_ID_PREFIX, TEST_ID_SEPARATOR, TestIdContext, TestIdProvider, joinTestId, resolveTestId, rootTestId, slugifyTestId, testIdProps, useResolvedTestId, useTestIdPrefix };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flipdish/ui-library",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Flipdish Design System — atomic-design component library (Tailwind v4 + UntitledUI + React Aria).",
   "type": "module",
   "sideEffects": [