@revturbine/sdk 0.7.12 → 0.8.0

package/dist/types/web-sdk/theme/defaults.d.ts

@@ -6,8 +6,49 @@ import type { RevTurbineTheme, RevTurbineThemeInput } from './types';
  */
 export declare const DEFAULT_THEME: Readonly<RevTurbineTheme>;
 /**
- * Deep-merge a partial theme input with the default theme, producing a
- * complete {@link RevTurbineTheme}.
+ * Dark counterpart to {@link DEFAULT_THEME}.
+ *
+ * Plan 233 TASK-6. The SDK had no sanctioned dark story at all, so a customer
+ * running a dark app either lived with white modals or — as the escalated one
+ * did — injected a palette into the Playbook object and re-initialized the SDK
+ * on every toggle. Shipping the palette is what makes `colorScheme` a swap
+ * rather than a rebuild.
+ *
+ * Only the colors differ. Typography, shape and shadows are scheme-independent,
+ * so they are inherited from {@link DEFAULT_THEME} rather than duplicated —
+ * a second copy would drift the moment either is edited.
+ *
+ * Contrast: every text-on-surface pair here clears WCAG AA at body size against
+ * its intended background.
+ *
+ * @public
  */
-export declare function mergeTheme(input?: RevTurbineThemeInput | null): RevTurbineTheme;
+export declare const DARK_THEME: Readonly<RevTurbineTheme>;
+/**
+ * The colour scheme a theme resolves against.
+ *
+ * `'system'` follows the OS/browser `prefers-color-scheme` and keeps following
+ * it as the user changes it.
+ *
+ * @public
+ */
+export type RevTurbineColorScheme = 'light' | 'dark' | 'system';
+/**
+ * The base palette for a resolved scheme.
+ *
+ * @param scheme - `'light'` or `'dark'`. Resolve `'system'` before calling.
+ * @returns The matching base theme.
+ * @public
+ */
+export declare function baseThemeForScheme(scheme: 'light' | 'dark'): Readonly<RevTurbineTheme>;
+/**
+ * Deep-merge a partial theme input with a base theme, producing a complete
+ * {@link RevTurbineTheme}.
+ *
+ * @param input - Partial tokens. Every omitted token falls back to `base`.
+ * @param base - The palette to merge over. Defaults to {@link DEFAULT_THEME};
+ *   pass {@link DARK_THEME} (or use {@link baseThemeForScheme}) to resolve a
+ *   partial brand theme against the dark palette instead.
+ */
+export declare function mergeTheme(input?: RevTurbineThemeInput | null, base?: Readonly<RevTurbineTheme>): RevTurbineTheme;
 //# sourceMappingURL=defaults.d.ts.map

package/dist/types/web-sdk/theme/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../../theme/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,eAAe,CA2ClD,CAAC;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,GAAG,eAAe,CAY/E"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../../theme/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,eAAe,CA2ClD,CAAC;AAGH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,eAAe,CA2B/C,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,CAEtF;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,EACnC,IAAI,GAAE,QAAQ,CAAC,eAAe,CAAiB,GAC9C,eAAe,CAYjB"}

package/dist/types/web-sdk/theme/index.d.ts

@@ -1,6 +1,8 @@
 export type { RevTurbineTheme, RevTurbineThemeInput, RevTurbineThemeColors, RevTurbineThemeTypography, RevTurbineThemeShape, RevTurbineThemeShadows, } from './types';
-export { DEFAULT_THEME, mergeTheme } from './defaults';
+export { DEFAULT_THEME, DARK_THEME, baseThemeForScheme, mergeTheme, } from './defaults';
+export type { RevTurbineColorScheme } from './defaults';
+export { useResolvedColorScheme } from './useColorScheme';
 export { loadTheme, clearPersistedTheme } from './theme-loader';
 export type { ThemeLoaderOptions } from './theme-loader';
-export { RevTurbineThemeProvider, useRevTurbineTheme } from './ThemeContext';
+export { RevTurbineThemeProvider, useRevTurbineTheme, useRevTurbineThemeProviderPresent, } from './ThemeContext';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/web-sdk/theme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../theme/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../theme/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,iCAAiC,GAClC,MAAM,gBAAgB,CAAC"}

package/dist/types/web-sdk/theme/useColorScheme.d.ts

@@ -0,0 +1,14 @@
+import type { RevTurbineColorScheme } from './defaults';
+/**
+ * Resolve a {@link RevTurbineColorScheme} to the concrete scheme to paint.
+ *
+ * `'system'` tracks `prefers-color-scheme` and keeps tracking it: a user
+ * flipping their OS theme updates the resolved value without a remount, which
+ * is the difference between following the system and sampling it once at init.
+ *
+ * @param preference - The requested scheme. `'system'` follows the OS.
+ * @returns `'light'` or `'dark'`.
+ * @public
+ */
+export declare function useResolvedColorScheme(preference: RevTurbineColorScheme): 'light' | 'dark';
+//# sourceMappingURL=useColorScheme.d.ts.map

package/dist/types/web-sdk/theme/useColorScheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useColorScheme.d.ts","sourceRoot":"","sources":["../../../../theme/useColorScheme.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAoBxD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,GAAG,MAAM,CAuC1F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revturbine/sdk",
-  "version": "0.7.12",
+  "version": "0.8.0",
   "description": "RevTurbine customer-facing SDK — placement decisioning, entitlement checks, and usage tracking.",
   "type": "module",
   "packageManager": "pnpm@11.12.0",
@@ -55,9 +55,9 @@
   "devDependencies": {
     "@growthbook/growthbook": "^1.7.0",
     "@optimizely/optimizely-sdk": "^6.5.0",
-    "@revt-eng/core": "0.1.279",
-    "@revt-eng/schema": "0.1.279",
-    "@revt-eng/schema-external": "0.1.279",
+    "@revt-eng/core": "0.1.306",
+    "@revt-eng/schema": "0.1.306",
+    "@revt-eng/schema-external": "0.1.306",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "openapi-fetch": "^0.17.0",