@flipdish/ui-library 0.4.3 → 0.5.0

package/dist/providers/UIProvider/index.cjs

@@ -1,28 +1,20 @@
 'use strict';
 
 var jsxRuntime = require('react/jsx-runtime');
+var ErrorBoundary = require('@flipdish/ui-library/providers/ErrorBoundary');
 var RouteProvider = require('@flipdish/ui-library/providers/RouteProvider');
 var ThemeProvider = require('@flipdish/ui-library/providers/ThemeProvider');
 var reactRouter = require('react-router');
 
 /**
- * @summary single entry-point provider that composes the Flipdish UI providers (theme, routing, and — soon — translations)
+ * @summary single entry-point provider that composes theme, routing, and an error boundary for consuming apps
  */
-const UIProvider = ({ children, themeModeOverride, withBrowserRouter = true, withRouteProvider = true, }) => {
-    let tree = children;
-    // RouteProvider must sit inside a router; keep it innermost so it can bind to
-    // either our BrowserRouter or a host-owned one.
-    if (withRouteProvider) {
-        tree = jsxRuntime.jsx(RouteProvider.RouteProvider, { children: tree });
-    }
-    if (withBrowserRouter) {
-        tree = jsxRuntime.jsx(reactRouter.BrowserRouter, { children: tree });
-    }
-    // TODO(i18n): wrap `tree` in <TranslationProvider> once the translation layer lands.
-    // It will likely expose an async `useLoadTranslations(languageOverride)` hook (see
-    // FlipdishUI's FlipdishUIProvider) and a `languageOverride` prop forwarded from here.
-    // Order: ThemeProvider > [BrowserRouter > RouteProvider] > TranslationProvider > children.
-    return jsxRuntime.jsx(ThemeProvider.ThemeProvider, { themeModeOverride: themeModeOverride, children: tree });
+const UIProvider = ({ children, themeModeOverride, baseUrl, errorBoundary }) => {
+    // TODO(i18n): add an internal library translation context so ui-library components can
+    // source their own copy (e.g. ErrorBoundary's "Something went wrong") without the
+    // consuming app needing to pass text props. This is purely internal — consuming apps
+    // own their own translation layer and wrap their content inside UIProvider as usual.
+    return (jsxRuntime.jsx(ThemeProvider.ThemeProvider, { themeModeOverride: themeModeOverride, children: jsxRuntime.jsx(reactRouter.BrowserRouter, { basename: baseUrl, children: jsxRuntime.jsx(RouteProvider.RouteProvider, { children: jsxRuntime.jsx(ErrorBoundary.ErrorBoundary, { ...errorBoundary, children: children }) }) }) }));
 };
 
 exports.UIProvider = UIProvider;

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/providers/UIProvider/index.tsx"],"sourcesContent":[null],"names":["_jsx","RouteProvider","BrowserRouter","ThemeProvider"],"mappings":";;;;;;;AA4BA;;AAEG;AACI,MAAM,UAAU,GAAG,CAAC,EACzB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,GAAG,IAAI,EACxB,iBAAiB,GAAG,IAAI,GACW,KAAI;IACvC,IAAI,IAAI,GAAG,QAAQ;;;IAInB,IAAI,iBAAiB,EAAE;AACrB,QAAA,IAAI,GAAGA,cAAA,CAACC,2BAAa,EAAA,EAAA,QAAA,EAAE,IAAI,GAAiB;IAC9C;IAEA,IAAI,iBAAiB,EAAE;AACrB,QAAA,IAAI,GAAGD,cAAA,CAACE,yBAAa,EAAA,EAAA,QAAA,EAAE,IAAI,GAAiB;IAC9C;;;;;IAMA,OAAOF,cAAA,CAACG,2BAAa,EAAA,EAAC,iBAAiB,EAAE,iBAAiB,EAAA,QAAA,EAAG,IAAI,EAAA,CAAiB;AACpF;;;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/providers/UIProvider/index.tsx"],"sourcesContent":[null],"names":["_jsx","ThemeProvider","BrowserRouter","RouteProvider","ErrorBoundary"],"mappings":";;;;;;;;AA4BA;;AAEG;AACI,MAAM,UAAU,GAAG,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,aAAa,EAAsC,KAAI;;;;;AAKxH,IAAA,QACEA,cAAA,CAACC,2BAAa,EAAA,EAAC,iBAAiB,EAAE,iBAAiB,EAAA,QAAA,EACjDD,cAAA,CAACE,yBAAa,EAAA,EAAC,QAAQ,EAAE,OAAO,EAAA,QAAA,EAC9BF,cAAA,CAACG,2BAAa,EAAA,EAAA,QAAA,EACZH,cAAA,CAACI,2BAAa,EAAA,EAAA,GAAK,aAAa,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAiB,EAAA,CAC9C,EAAA,CACF,EAAA,CACF;AAEpB;;;;"}

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

@@ -1,3 +1,4 @@
+import { type ErrorBoundaryProps } from '@flipdish/ui-library/providers/ErrorBoundary';
 import type { PropsWithChildren } from 'react';
 export interface UIProviderProps {
     /**
@@ -6,23 +7,22 @@ export interface UIProviderProps {
      */
     themeModeOverride?: 'light' | 'dark';
     /**
-     * Render a `BrowserRouter`. Set `false` when a host/parent app already owns a
-     * router (e.g. a micro-frontend mounted in a shell, or an app using react-router's
-     * data APIs via `createBrowserRouter`) — a second router would fight over the URL.
-     * @default true
+     * Base URL for the internal router. Use for micro-frontends mounted at a sub-path
+     * (e.g. `getMicroFrontendAttribute('data-portal-base-url') || '/'`).
      */
-    withBrowserRouter?: boolean;
+    baseUrl?: string;
     /**
-     * Wire react-aria-components navigation into react-router (so `<Link>`, etc. use
-     * client-side navigation). Keep `true` even when `withBrowserRouter` is `false`, so
-     * react-aria routing binds to the host's router. Set `false` only for non-routed
-     * surfaces (single-screen apps, some test/Storybook setups).
-     * @default true
+     * Props for the app-level `ErrorBoundary` that wraps children.
+     * At minimum pass `identifier` (e.g. `'app'`) to label the boundary in error
+     * logs. Wire `onError` to your error reporter (Datadog RUM, fdlogger, etc.).
+     *
+     * @example
+     * errorBoundary={{ identifier: 'app', onError: datadogReporter }}
      */
-    withRouteProvider?: boolean;
+    errorBoundary: Omit<ErrorBoundaryProps, 'children'>;
 }
 /**
- * @summary single entry-point provider that composes the Flipdish UI providers (theme, routing, and — soon — translations)
+ * @summary single entry-point provider that composes theme, routing, and an error boundary for consuming apps
  */
-export declare const UIProvider: ({ children, themeModeOverride, withBrowserRouter, withRouteProvider, }: PropsWithChildren<UIProviderProps>) => import("react").JSX.Element;
+export declare const UIProvider: ({ children, themeModeOverride, baseUrl, errorBoundary }: PropsWithChildren<UIProviderProps>) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/UIProvider/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACrC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,wEAKxB,iBAAiB,CAAC,eAAe,CAAC,gCAkBpC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/UIProvider/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAGtG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,aAAa,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,yDAAyD,iBAAiB,CAAC,eAAe,CAAC,gCAcrH,CAAC"}

package/dist/providers/UIProvider/index.js

@@ -1,26 +1,18 @@
 import { jsx } from 'react/jsx-runtime';
+import { ErrorBoundary } from '@flipdish/ui-library/providers/ErrorBoundary';
 import { RouteProvider } from '@flipdish/ui-library/providers/RouteProvider';
 import { ThemeProvider } from '@flipdish/ui-library/providers/ThemeProvider';
 import { BrowserRouter } from 'react-router';
 
 /**
- * @summary single entry-point provider that composes the Flipdish UI providers (theme, routing, and — soon — translations)
+ * @summary single entry-point provider that composes theme, routing, and an error boundary for consuming apps
  */
-const UIProvider = ({ children, themeModeOverride, withBrowserRouter = true, withRouteProvider = true, }) => {
-    let tree = children;
-    // RouteProvider must sit inside a router; keep it innermost so it can bind to
-    // either our BrowserRouter or a host-owned one.
-    if (withRouteProvider) {
-        tree = jsx(RouteProvider, { children: tree });
-    }
-    if (withBrowserRouter) {
-        tree = jsx(BrowserRouter, { children: tree });
-    }
-    // TODO(i18n): wrap `tree` in <TranslationProvider> once the translation layer lands.
-    // It will likely expose an async `useLoadTranslations(languageOverride)` hook (see
-    // FlipdishUI's FlipdishUIProvider) and a `languageOverride` prop forwarded from here.
-    // Order: ThemeProvider > [BrowserRouter > RouteProvider] > TranslationProvider > children.
-    return jsx(ThemeProvider, { themeModeOverride: themeModeOverride, children: tree });
+const UIProvider = ({ children, themeModeOverride, baseUrl, errorBoundary }) => {
+    // TODO(i18n): add an internal library translation context so ui-library components can
+    // source their own copy (e.g. ErrorBoundary's "Something went wrong") without the
+    // consuming app needing to pass text props. This is purely internal — consuming apps
+    // own their own translation layer and wrap their content inside UIProvider as usual.
+    return (jsx(ThemeProvider, { themeModeOverride: themeModeOverride, children: jsx(BrowserRouter, { basename: baseUrl, children: jsx(RouteProvider, { children: jsx(ErrorBoundary, { ...errorBoundary, children: children }) }) }) }));
 };
 
 export { UIProvider };

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/providers/UIProvider/index.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;AA4BA;;AAEG;AACI,MAAM,UAAU,GAAG,CAAC,EACzB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,GAAG,IAAI,EACxB,iBAAiB,GAAG,IAAI,GACW,KAAI;IACvC,IAAI,IAAI,GAAG,QAAQ;;;IAInB,IAAI,iBAAiB,EAAE;AACrB,QAAA,IAAI,GAAGA,GAAA,CAAC,aAAa,EAAA,EAAA,QAAA,EAAE,IAAI,GAAiB;IAC9C;IAEA,IAAI,iBAAiB,EAAE;AACrB,QAAA,IAAI,GAAGA,GAAA,CAAC,aAAa,EAAA,EAAA,QAAA,EAAE,IAAI,GAAiB;IAC9C;;;;;IAMA,OAAOA,GAAA,CAAC,aAAa,EAAA,EAAC,iBAAiB,EAAE,iBAAiB,EAAA,QAAA,EAAG,IAAI,EAAA,CAAiB;AACpF;;;;"}
+{"version":3,"file":"index.js","sources":["../../../src/providers/UIProvider/index.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;;AA4BA;;AAEG;AACI,MAAM,UAAU,GAAG,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,aAAa,EAAsC,KAAI;;;;;AAKxH,IAAA,QACEA,GAAA,CAAC,aAAa,EAAA,EAAC,iBAAiB,EAAE,iBAAiB,EAAA,QAAA,EACjDA,GAAA,CAAC,aAAa,EAAA,EAAC,QAAQ,EAAE,OAAO,EAAA,QAAA,EAC9BA,GAAA,CAAC,aAAa,EAAA,EAAA,QAAA,EACZA,GAAA,CAAC,aAAa,EAAA,EAAA,GAAK,aAAa,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAiB,EAAA,CAC9C,EAAA,CACF,EAAA,CACF;AAEpB;;;;"}

package/package.json

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