@gooddata/sdk-ui-theme-provider 11.47.0-alpha.4 → 11.47.0

package/esm/ThemeProvider/Context.d.ts

@@ -13,6 +13,15 @@ export interface IThemeContextProviderProps {
      * When undefined, no theme is applied and default styling is used.
      */
     theme: ITheme | undefined;
+    /**
+     * Theme of record for computations that must not depend on application-specific
+     * presentation adjustments (e.g. a stripped complementary palette).
+     *
+     * @remarks
+     * When undefined, the reference from an enclosing provider is inherited,
+     * falling back to the theme itself.
+     */
+    referenceTheme?: ITheme;
     /**
      * Flag telling whether the theme object is being loaded or not
      * @deprecated use themeStatus instead
@@ -40,7 +49,7 @@ export interface IThemeContextProviderProps {
  *
  * @public
  */
-export declare function ThemeContextProvider({ children, theme, themeIsLoading, themeStatus, isScopeThemed }: IThemeContextProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ThemeContextProvider({ children, theme, referenceTheme, themeIsLoading, themeStatus, isScopeThemed }: IThemeContextProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Hook for reaching the theme from context.
  *
@@ -61,6 +70,17 @@ export declare function ThemeContextProvider({ children, theme, themeIsLoading,
  * @public
  */
 export declare const useTheme: (theme?: ITheme | undefined) => ITheme | undefined;
+/**
+ * Hook for reaching the reference theme from context.
+ *
+ * @remarks
+ * The reference theme is the workspace theme prepared with the complementary palette enabled,
+ * regardless of how the application presents itself. Use it for computations that must be
+ * consistent across applications (e.g. color derivation); use {@link useTheme} for presentation.
+ *
+ * @public
+ */
+export declare const useReferenceTheme: () => ITheme | undefined;
 /**
  * Hook that returns whether the current theme is dark
  *

package/esm/ThemeProvider/Context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../src/ThemeProvider/Context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAA6B,MAAM,OAAO,CAAC;AAEtF,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAiBlD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1B;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EACjC,QAAQ,EACR,KAAK,EACL,cAAc,EACd,WAAW,EACX,aAAa,EAChB,EAAE,0BAA0B,2CAU5B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ,oDAGpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,eAG1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,2BAE7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,+BAE1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,2BAE5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,EAClF,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAUjC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,EACrE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAU1C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,EACnE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAUvC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,aAAa,CAAC,CAAC,CAIpE"}
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../src/ThemeProvider/Context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAA6B,MAAM,OAAO,CAAC;AAEtF,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAoBlD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1B;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EACjC,QAAQ,EACR,KAAK,EACL,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EAChB,EAAE,0BAA0B,2CAiB5B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ,oDAGpB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,0BAE7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,eAG1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,2BAE7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,+BAE1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,2BAE5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,EAClF,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAUjC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,EACrE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAU1C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,EACnE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAUvC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,aAAa,CAAC,CAAC,CAIpE"}

package/esm/ThemeProvider/Context.js

@@ -1,10 +1,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-// (C) 2019-2025 GoodData Corporation
+// (C) 2019-2026 GoodData Corporation
 import { createContext, useContext } from "react";
 import { wrapDisplayName } from "@gooddata/sdk-ui";
 import { isDarkTheme } from "./isDarkTheme.js";
 const ThemeContext = createContext(undefined);
 ThemeContext.displayName = "ThemeContext";
+const ThemeReferenceContext = createContext(undefined);
+ThemeReferenceContext.displayName = "ThemeReferenceContext";
 const ThemeIsLoadingContext = createContext(undefined);
 ThemeIsLoadingContext.displayName = "ThemeIsLoadingContext";
 const ThemeIsScopeThemedContext = createContext(undefined);
@@ -16,8 +18,11 @@ ThemeStatusContext.displayName = "ThemeStatusContext";
  *
  * @public
  */
-export function ThemeContextProvider({ children, theme, themeIsLoading, themeStatus, isScopeThemed, }) {
-    return (_jsx(ThemeContext.Provider, { value: theme, children: _jsx(ThemeIsLoadingContext.Provider, { value: themeIsLoading, children: _jsx(ThemeIsScopeThemedContext.Provider, { value: isScopeThemed, children: _jsx(ThemeStatusContext.Provider, { value: themeStatus, children: children }) }) }) }));
+export function ThemeContextProvider({ children, theme, referenceTheme, themeIsLoading, themeStatus, isScopeThemed, }) {
+    // nested providers re-providing only the presentation theme must not shadow
+    // an outer reference theme (e.g. chart internals re-wrap the stripped theme in AD)
+    const outerReferenceTheme = useContext(ThemeReferenceContext);
+    return (_jsx(ThemeContext.Provider, { value: theme, children: _jsx(ThemeReferenceContext.Provider, { value: referenceTheme ?? outerReferenceTheme ?? theme, children: _jsx(ThemeIsLoadingContext.Provider, { value: themeIsLoading, children: _jsx(ThemeIsScopeThemedContext.Provider, { value: isScopeThemed, children: _jsx(ThemeStatusContext.Provider, { value: themeStatus, children: children }) }) }) }) }));
 }
 /**
  * Hook for reaching the theme from context.
@@ -42,6 +47,19 @@ export const useTheme = (theme) => {
     const themeFromContext = useContext(ThemeContext);
     return theme ?? themeFromContext;
 };
+/**
+ * Hook for reaching the reference theme from context.
+ *
+ * @remarks
+ * The reference theme is the workspace theme prepared with the complementary palette enabled,
+ * regardless of how the application presents itself. Use it for computations that must be
+ * consistent across applications (e.g. color derivation); use {@link useTheme} for presentation.
+ *
+ * @public
+ */
+export const useReferenceTheme = () => {
+    return useContext(ThemeReferenceContext);
+};
 /**
  * Hook that returns whether the current theme is dark
  *

package/esm/ThemeProvider/ScopedThemeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScopedThemeProvider.d.ts","sourceRoot":"","sources":["../../src/ThemeProvider/ScopedThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAEpE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAQlD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAKD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAChC,QAAQ,EACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,cAAc,EACzB,QAA0B,EAC1B,0BAAiC,EACjC,0BAAiC,EACpC,EAAE,yBAAyB,2CA6E3B"}
+{"version":3,"file":"ScopedThemeProvider.d.ts","sourceRoot":"","sources":["../../src/ThemeProvider/ScopedThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAEpE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAQlD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAKD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAChC,QAAQ,EACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,cAAc,EACzB,QAA0B,EAC1B,0BAAiC,EACjC,0BAAiC,EACpC,EAAE,yBAAyB,2CAwF3B"}

package/esm/ThemeProvider/ScopedThemeProvider.js

@@ -22,6 +22,7 @@ export function ScopedThemeProvider({ children, theme: themeParam, backend: back
     const workspace = useWorkspace(workspaceParam);
     const [scopeId] = useState(`font${Math.random().toString(36).substring(2, 15)}`);
     const [theme, setTheme] = useState(themeParam ?? {});
+    const [referenceTheme, setReferenceTheme] = useState(themeParam ?? {});
     const [isLoading, setIsLoading] = useState(false);
     const [status, setStatus] = useState("pending");
     const [scope, setScope] = useState();
@@ -32,6 +33,7 @@ export function ScopedThemeProvider({ children, theme: themeParam, backend: back
         if (themeParam) {
             const preparedTheme = prepareTheme(themeParam, enableComplementaryPalette);
             setTheme(preparedTheme);
+            setReferenceTheme(enableComplementaryPalette ? preparedTheme : prepareTheme(themeParam, true));
             setStatus("success");
             clearCssProperties(true, scope ?? undefined, scopeId);
             setCssProperties(preparedTheme, isDarkTheme(preparedTheme), true, scope ?? undefined, scopeId);
@@ -49,6 +51,7 @@ export function ScopedThemeProvider({ children, theme: themeParam, backend: back
                 const modifiedTheme = modifier(selectedTheme);
                 const preparedTheme = prepareTheme(modifiedTheme, enableComplementaryPalette);
                 setTheme(preparedTheme);
+                setReferenceTheme(enableComplementaryPalette ? preparedTheme : prepareTheme(modifiedTheme, true));
                 clearCssProperties(true, scope ?? undefined, scopeId);
                 setCssProperties(preparedTheme, isDarkTheme(preparedTheme), true, scope ?? undefined, scopeId);
                 setIsLoading(false);
@@ -64,7 +67,7 @@ export function ScopedThemeProvider({ children, theme: themeParam, backend: back
             }
         };
     }, [removeGlobalStylesOnUnmout, scope, scopeId]);
-    return (_jsx(ThemeContextProvider, { theme: theme, isScopeThemed: true, themeIsLoading: isLoading, themeStatus: status, children: _jsx("div", { ref: (el) => {
+    return (_jsx(ThemeContextProvider, { theme: theme, referenceTheme: referenceTheme, isScopeThemed: true, themeIsLoading: isLoading, themeStatus: status, children: _jsx("div", { ref: (el) => {
                 if (el) {
                     setScope(el);
                 }

package/esm/ThemeProvider/ThemeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/ThemeProvider/ThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAEpE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAWlD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAC1B,QAAQ,EACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,cAAc,EACzB,QAAmB,EACnB,0BAAiC,EACjC,0BAAiC,EACpC,EAAE,mBAAmB,2CAoFrB"}
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/ThemeProvider/ThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAEpE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAWlD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAC1B,QAAQ,EACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,cAAc,EACzB,QAAmB,EACnB,0BAAiC,EACjC,0BAAiC,EACpC,EAAE,mBAAmB,2CAkGrB"}

package/esm/ThemeProvider/ThemeProvider.js

@@ -22,6 +22,7 @@ export function ThemeProvider({ children, theme: themeParam, backend: backendPar
     const backend = useBackend(backendParam);
     const workspace = useWorkspace(workspaceParam);
     const [theme, setTheme] = useState(themeParam ?? {});
+    const [referenceTheme, setReferenceTheme] = useState(themeParam ?? {});
     const [isLoading, setIsLoading] = useState(false);
     const [status, setStatus] = useState("pending");
     const lastWorkspace = useRef(undefined);
@@ -33,7 +34,13 @@ export function ThemeProvider({ children, theme: themeParam, backend: backendPar
         const applyTheme = (themeToApply) => {
             try {
                 const preparedTheme = prepareTheme(themeToApply, enableComplementaryPalette);
+                // theme of record: always prepared with the complementary palette, so consumers
+                // computing from it get the same values in every application
+                const preparedReferenceTheme = enableComplementaryPalette
+                    ? preparedTheme
+                    : prepareTheme(themeToApply, true);
                 setTheme(preparedTheme);
+                setReferenceTheme(preparedReferenceTheme);
                 clearCssProperties();
                 setCssProperties(preparedTheme, isDarkTheme(preparedTheme));
             }
@@ -42,6 +49,7 @@ export function ThemeProvider({ children, theme: themeParam, backend: backendPar
                 // reset both channels (context theme and global CSS) to the default theme so
                 // context consumers stay consistent with the cleared CSS variables
                 setTheme({});
+                setReferenceTheme({});
                 clearCssProperties();
             }
             finally {
@@ -74,6 +82,7 @@ export function ThemeProvider({ children, theme: themeParam, backend: backendPar
                     // reset both channels (context theme and global CSS) to the default theme so
                     // context consumers stay consistent with the cleared CSS variables
                     setTheme({});
+                    setReferenceTheme({});
                     clearCssProperties();
                     setIsLoading(false);
                     setStatus("success");
@@ -89,5 +98,5 @@ export function ThemeProvider({ children, theme: themeParam, backend: backendPar
             }
         };
     }, [removeGlobalStylesOnUnmout]);
-    return (_jsx(ThemeContextProvider, { theme: theme, themeIsLoading: isLoading, themeStatus: status, children: children }));
+    return (_jsx(ThemeContextProvider, { theme: theme, referenceTheme: referenceTheme, themeIsLoading: isLoading, themeStatus: status, children: children }));
 }

package/esm/index.d.ts

@@ -13,6 +13,6 @@ export { ThemeProvider, type IThemeProviderProps, type ThemeModifier, } from "./
 export { ScopedThemeProvider, type IScopedThemeProviderProps } from "./ThemeProvider/ScopedThemeProvider.js";
 export { ConditionalScopedThemeProvider } from "./ThemeProvider/ConditionalScopedThemeProvider.js";
 export { isDarkTheme } from "./ThemeProvider/isDarkTheme.js";
-export { withTheme, useTheme, useThemeIsLoading, useIsScopeThemed, useThemeStatus, useIsDarkTheme, ThemeContextProvider, type IThemeContextProviderProps, type ThemeStatus, } from "./ThemeProvider/Context.js";
+export { withTheme, useTheme, useReferenceTheme, useThemeIsLoading, useIsScopeThemed, useThemeStatus, useIsDarkTheme, ThemeContextProvider, type IThemeContextProviderProps, type ThemeStatus, } from "./ThemeProvider/Context.js";
 export { isValidThemeColor, findInvalidThemeColors, type IInvalidThemeColor } from "./colorValidation.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EACH,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,KAAK,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAC7G,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EACH,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,KAAK,WAAW,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EACH,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,KAAK,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAC7G,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EACH,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,KAAK,WAAW,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/esm/index.js

@@ -15,5 +15,5 @@ export { ThemeProvider, } from "./ThemeProvider/ThemeProvider.js";
 export { ScopedThemeProvider } from "./ThemeProvider/ScopedThemeProvider.js";
 export { ConditionalScopedThemeProvider } from "./ThemeProvider/ConditionalScopedThemeProvider.js";
 export { isDarkTheme } from "./ThemeProvider/isDarkTheme.js";
-export { withTheme, useTheme, useThemeIsLoading, useIsScopeThemed, useThemeStatus, useIsDarkTheme, ThemeContextProvider, } from "./ThemeProvider/Context.js";
+export { withTheme, useTheme, useReferenceTheme, useThemeIsLoading, useIsScopeThemed, useThemeStatus, useIsDarkTheme, ThemeContextProvider, } from "./ThemeProvider/Context.js";
 export { isValidThemeColor, findInvalidThemeColors } from "./colorValidation.js";

package/esm/sdk-ui-theme-provider.d.ts

@@ -140,6 +140,15 @@ export declare interface IThemeContextProviderProps {
      * When undefined, no theme is applied and default styling is used.
      */
     theme: ITheme | undefined;
+    /**
+     * Theme of record for computations that must not depend on application-specific
+     * presentation adjustments (e.g. a stripped complementary palette).
+     *
+     * @remarks
+     * When undefined, the reference from an enclosing provider is inherited,
+     * falling back to the theme itself.
+     */
+    referenceTheme?: ITheme;
     /**
      * Flag telling whether the theme object is being loaded or not
      * @deprecated use themeStatus instead
@@ -232,7 +241,7 @@ export declare function ScopedThemeProvider({ children, theme: themeParam, backe
  *
  * @public
  */
-export declare function ThemeContextProvider({ children, theme, themeIsLoading, themeStatus, isScopeThemed }: IThemeContextProviderProps): JSX.Element;
+export declare function ThemeContextProvider({ children, theme, referenceTheme, themeIsLoading, themeStatus, isScopeThemed }: IThemeContextProviderProps): JSX.Element;
 
 /**
  * @public
@@ -271,6 +280,18 @@ export declare const useIsDarkTheme: () => boolean;
  */
 export declare const useIsScopeThemed: () => boolean | undefined;
 
+/**
+ * Hook for reaching the reference theme from context.
+ *
+ * @remarks
+ * The reference theme is the workspace theme prepared with the complementary palette enabled,
+ * regardless of how the application presents itself. Use it for computations that must be
+ * consistent across applications (e.g. color derivation); use {@link useTheme} for presentation.
+ *
+ * @public
+ */
+export declare const useReferenceTheme: () => ITheme | undefined;
+
 /**
  * Hook for reaching the theme from context.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-theme-provider",
-  "version": "11.47.0-alpha.4",
+  "version": "11.47.0",
   "description": "GoodData SDK - Theme provider",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -32,10 +32,10 @@
     "postcss-value-parser": "^4.2.0",
     "ts-invariant": "0.10.3",
     "tslib": "2.8.1",
-    "@gooddata/sdk-backend-spi": "11.47.0-alpha.4",
-    "@gooddata/sdk-model": "11.47.0-alpha.4",
-    "@gooddata/sdk-ui": "11.47.0-alpha.4",
-    "@gooddata/util": "11.47.0-alpha.4"
+    "@gooddata/sdk-backend-spi": "11.47.0",
+    "@gooddata/util": "11.47.0",
+    "@gooddata/sdk-model": "11.47.0",
+    "@gooddata/sdk-ui": "11.47.0"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -73,10 +73,10 @@
     "react-dom": "19.1.1",
     "typescript": "5.9.3",
     "vitest": "4.1.8",
-    "@gooddata/eslint-config": "11.47.0-alpha.4",
-    "@gooddata/oxlint-config": "11.47.0-alpha.4",
-    "@gooddata/reference-workspace": "11.47.0-alpha.4",
-    "@gooddata/sdk-backend-mockingbird": "11.47.0-alpha.4"
+    "@gooddata/eslint-config": "11.47.0",
+    "@gooddata/oxlint-config": "11.47.0",
+    "@gooddata/reference-workspace": "11.47.0",
+    "@gooddata/sdk-backend-mockingbird": "11.47.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",