@box/blueprint-web 15.5.1 → 15.5.3

package/dist/lib-esm/blueprint-configuration-context/blueprint-configuration-context.d.ts

@@ -19,4 +19,4 @@ export declare const BlueprintConfigurationContext: import("react").Context<Blue
  *     <App />
  * </BlueprintProvider>
  */
-export declare const BlueprintProvider: ({ children, useTreatment, configurationOverrides }: BlueprintProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const BlueprintProvider: ({ children, useTreatment: givenUseTreatment, configurationOverrides, }: BlueprintProviderProps) => import("react/jsx-runtime").JSX.Element;

package/dist/lib-esm/blueprint-configuration-context/blueprint-configuration-context.js

@@ -1,7 +1,9 @@
 import { jsx } from 'react/jsx-runtime';
-import { createContext, useMemo } from 'react';
+import { createContext, useEffect, useMemo } from 'react';
+import { isProduction } from '../utils/isProduction.js';
 import { useAnimationsConfiguration } from './configuration-hooks/useAnimationsConfiguration.js';
 import { useTypographyConfiguration } from './configuration-hooks/useTypographyConfiguration.js';
+import { isUseTreatmentHook, useNoopTreatment } from './utils.js';
 import { BLUEPRINT_CONFIGURATION_DEFAULTS } from './consts.js';
 
 /**
@@ -29,9 +31,23 @@ const BlueprintConfigurationContext = /*#__PURE__*/createContext({
  */
 const BlueprintProvider = ({
   children,
-  useTreatment,
+  useTreatment: givenUseTreatment,
   configurationOverrides = {}
 }) => {
+  // `useTreatment` is a required prop, but callers (or misconfigured consumers) may omit it
+  // or pass a non-callable value. Fall back to the no-op hook unless we received an actual
+  // function so the provider degrades gracefully instead of throwing at call time.
+  const isUseTreatmentValid = isUseTreatmentHook(givenUseTreatment);
+  const useTreatment = isUseTreatmentValid ? givenUseTreatment : useNoopTreatment;
+  const givenUseTreatmentType = typeof givenUseTreatment;
+  // Surface the misconfiguration to developers without breaking the app (stripped from production bundles).
+  useEffect(() => {
+    if (isUseTreatmentValid || isProduction()) {
+      return;
+    }
+    // eslint-disable-next-line no-console
+    console.error(`BlueprintProvider: \`useTreatment\` must be a function, but received \`${givenUseTreatmentType}\`. Falling back to the no-op treatment, so all Split.io-driven configuration will resolve to its disabled default.`);
+  }, [isUseTreatmentValid, givenUseTreatmentType]);
   const typographyConfig = useTypographyConfiguration({
     overrides: configurationOverrides
   });

package/dist/lib-esm/blueprint-configuration-context/utils.d.ts

@@ -1,3 +1,13 @@
+import { type BlueprintProviderProps } from './types';
+/**
+ * Runtime type guard for `BlueprintProvider`'s `useTreatment` prop.
+ *
+ * `useTreatment` is statically typed as a required function, but callers (or
+ * misconfigured consumers) can still omit it or pass a non-callable value. This
+ * guard narrows an `unknown` to the hook type so the provider can fall back to
+ * `useNoopTreatment` instead of throwing at call time.
+ */
+export declare const isUseTreatmentHook: (value: unknown) => value is BlueprintProviderProps["useTreatment"];
 export declare const isValidTreatment: (treatment: string) => boolean;
 export declare const isTreatmentEnabled: (treatment: string) => treatment is "on";
 export declare const getTreatmentValue: (treatment: string, defaultValue: string) => string;

package/dist/lib-esm/blueprint-configuration-context/utils.js

@@ -1,5 +1,14 @@
 import { TREATMENT_STATES } from './consts.js';
 
+/**
+ * Runtime type guard for `BlueprintProvider`'s `useTreatment` prop.
+ *
+ * `useTreatment` is statically typed as a required function, but callers (or
+ * misconfigured consumers) can still omit it or pass a non-callable value. This
+ * guard narrows an `unknown` to the hook type so the provider can fall back to
+ * `useNoopTreatment` instead of throwing at call time.
+ */
+const isUseTreatmentHook = value => typeof value === 'function';
 const isTreatmentEnabled = treatment => treatment === TREATMENT_STATES.ON;
 /**
  * No-op `useTreatment` implementation that always resolves to
@@ -13,4 +22,4 @@ const isTreatmentEnabled = treatment => treatment === TREATMENT_STATES.ON;
  */
 const useNoopTreatment = () => TREATMENT_STATES.CONTROL;
 
-export { isTreatmentEnabled, useNoopTreatment };
+export { isTreatmentEnabled, isUseTreatmentHook, useNoopTreatment };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@box/blueprint-web",
-    "version": "15.5.1",
+    "version": "15.5.3",
     "type": "module",
     "license": "SEE LICENSE IN LICENSE",
     "publishConfig": {
@@ -47,7 +47,7 @@
     "dependencies": {
         "@ariakit/react": "0.4.21",
         "@ariakit/react-core": "0.4.21",
-        "@box/blueprint-web-assets": "^4.122.0",
+        "@box/blueprint-web-assets": "^4.123.1",
         "@internationalized/date": "^3.12.0",
         "@radix-ui/react-accordion": "1.1.2",
         "@radix-ui/react-checkbox": "1.0.4",
@@ -77,7 +77,7 @@
         "type-fest": "^3.2.0"
     },
     "devDependencies": {
-        "@box/storybook-utils": "^0.20.9",
+        "@box/storybook-utils": "^0.20.11",
         "@figma/code-connect": "1.4.4",
         "@types/react": "^18.0.0",
         "@types/react-dom": "^18.0.0",