@box/blueprint-web 14.41.0 → 15.0.0

package/dist/lib-esm/avatar/avatar.module.js

@@ -1,4 +1,4 @@
 import '../index.css';
-var styles = {"avatar":"bp_avatar_module_avatar--7018b","xsmall":"bp_avatar_module_xsmall--7018b","length-1":"bp_avatar_module_length-1--7018b","text":"bp_avatar_module_text--7018b","length-2":"bp_avatar_module_length-2--7018b","small":"bp_avatar_module_small--7018b","medium":"bp_avatar_module_medium--7018b","large":"bp_avatar_module_large--7018b","length-3":"bp_avatar_module_length-3--7018b","length-4":"bp_avatar_module_length-4--7018b","xlarge":"bp_avatar_module_xlarge--7018b","xxlarge":"bp_avatar_module_xxlarge--7018b","badge":"bp_avatar_module_badge--7018b","image":"bp_avatar_module_image--7018b","loading":"bp_avatar_module_loading--7018b","anonymousAvatar":"bp_avatar_module_anonymousAvatar--7018b","iconContainer":"bp_avatar_module_iconContainer--7018b"};
+var styles = {"avatar":"bp_avatar_module_avatar--da0f5","xsmall":"bp_avatar_module_xsmall--da0f5","length-1":"bp_avatar_module_length-1--da0f5","text":"bp_avatar_module_text--da0f5","length-2":"bp_avatar_module_length-2--da0f5","small":"bp_avatar_module_small--da0f5","medium":"bp_avatar_module_medium--da0f5","large":"bp_avatar_module_large--da0f5","length-3":"bp_avatar_module_length-3--da0f5","length-4":"bp_avatar_module_length-4--da0f5","xlarge":"bp_avatar_module_xlarge--da0f5","xxlarge":"bp_avatar_module_xxlarge--da0f5","badge":"bp_avatar_module_badge--da0f5","image":"bp_avatar_module_image--da0f5","loading":"bp_avatar_module_loading--da0f5","anonymousAvatar":"bp_avatar_module_anonymousAvatar--da0f5","iconContainer":"bp_avatar_module_iconContainer--da0f5"};
 
 export { styles as default };

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

@@ -1,26 +1,22 @@
-import { type ReactNode } from 'react';
-declare enum TypographyOption {
-    lato = "lato",
-    inter = "inter"
-}
+import { type BlueprintConfiguration, type BlueprintProviderProps } from './types';
 /**
- * Blueprint configuration options dictionary.
- * Import this to access all available configuration values.
+ * Underlying React context. Prefer `BlueprintProvider` + `useBlueprintConfiguration`
+ * for production code. Exposed for test scenarios that need to inject a fully
+ * resolved `BlueprintConfiguration` (e.g. forcing `componentsWithAnimationEnabled`
+ * to a specific subset that isn't expressible through `configurationOverrides`).
  */
-export declare const BlueprintConfigurationOptions: {
-    readonly typography: typeof TypographyOption;
-};
-export interface BlueprintConfiguration {
-    typography: TypographyOption;
-    componentsWithAnimationEnabled: string[];
-}
 export declare const BlueprintConfigurationContext: import("react").Context<BlueprintConfiguration>;
-export interface BlueprintConfigurationProviderProps {
-    children: ReactNode;
-    typography?: TypographyOption;
-    animationsPhase1Enabled?: boolean;
-    animationsPhase2Enabled?: boolean;
-    animationsPhase3Enabled?: boolean;
-}
-export declare const BlueprintConfigurationProvider: ({ children, typography, animationsPhase1Enabled, animationsPhase2Enabled, animationsPhase3Enabled, }: BlueprintConfigurationProviderProps) => import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Provides Blueprint runtime configuration to descendants via React context.
+ * Values supplied in `configurationOverrides` are forced; missing values fall
+ * through to Split.io treatments resolved by the required `useTreatment` hook.
+ *
+ * @example
+ * <BlueprintProvider
+ *     useTreatment={useTreatment}
+ *     configurationOverrides={{ typography: BlueprintConfigurationOptions.typography.inter }}
+ * >
+ *     <App />
+ * </BlueprintProvider>
+ */
+export declare const BlueprintProvider: ({ children, useTreatment, configurationOverrides }: BlueprintProviderProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,38 +1,52 @@
 import { jsx } from 'react/jsx-runtime';
 import { createContext, useMemo } from 'react';
-import { ANIMATED_COMPONENTS_BY_PHASE } from './consts.js';
+import { useAnimationsConfiguration } from './configuration-hooks/useAnimationsConfiguration.js';
+import { useTypographyConfiguration } from './configuration-hooks/useTypographyConfiguration.js';
+import { BLUEPRINT_CONFIGURATION_DEFAULTS } from './consts.js';
 
-var TypographyOption;
-(function (TypographyOption) {
-  TypographyOption["lato"] = "lato";
-  TypographyOption["inter"] = "inter";
-})(TypographyOption || (TypographyOption = {}));
 /**
- * Blueprint configuration options dictionary.
- * Import this to access all available configuration values.
+ * Underlying React context. Prefer `BlueprintProvider` + `useBlueprintConfiguration`
+ * for production code. Exposed for test scenarios that need to inject a fully
+ * resolved `BlueprintConfiguration` (e.g. forcing `componentsWithAnimationEnabled`
+ * to a specific subset that isn't expressible through `configurationOverrides`).
  */
-const BlueprintConfigurationOptions = {
-  typography: TypographyOption
-};
 const BlueprintConfigurationContext = /*#__PURE__*/createContext({
-  typography: BlueprintConfigurationOptions.typography.lato,
+  typography: BLUEPRINT_CONFIGURATION_DEFAULTS.typography,
   componentsWithAnimationEnabled: []
 });
-const BlueprintConfigurationProvider = ({
+/**
+ * Provides Blueprint runtime configuration to descendants via React context.
+ * Values supplied in `configurationOverrides` are forced; missing values fall
+ * through to Split.io treatments resolved by the required `useTreatment` hook.
+ *
+ * @example
+ * <BlueprintProvider
+ *     useTreatment={useTreatment}
+ *     configurationOverrides={{ typography: BlueprintConfigurationOptions.typography.inter }}
+ * >
+ *     <App />
+ * </BlueprintProvider>
+ */
+const BlueprintProvider = ({
   children,
-  typography = BlueprintConfigurationOptions.typography.lato,
-  animationsPhase1Enabled = false,
-  animationsPhase2Enabled = false,
-  animationsPhase3Enabled = false
+  useTreatment,
+  configurationOverrides = {}
 }) => {
+  const typographyConfig = useTypographyConfiguration({
+    overrides: configurationOverrides
+  });
+  const animationsConfig = useAnimationsConfiguration({
+    useTreatment,
+    overrides: configurationOverrides
+  });
   const value = useMemo(() => ({
-    typography,
-    componentsWithAnimationEnabled: [...(animationsPhase1Enabled ? ANIMATED_COMPONENTS_BY_PHASE.phase1 : []), ...(animationsPhase2Enabled ? ANIMATED_COMPONENTS_BY_PHASE.phase2 : []), ...(animationsPhase3Enabled ? ANIMATED_COMPONENTS_BY_PHASE.phase3 : [])]
-  }), [typography, animationsPhase1Enabled, animationsPhase2Enabled, animationsPhase3Enabled]);
+    ...typographyConfig,
+    ...animationsConfig
+  }), [animationsConfig, typographyConfig]);
   return jsx(BlueprintConfigurationContext.Provider, {
     value: value,
     children: children
   });
 };
 
-export { BlueprintConfigurationContext, BlueprintConfigurationOptions, BlueprintConfigurationProvider };
+export { BlueprintConfigurationContext, BlueprintProvider };

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

@@ -0,0 +1,9 @@
+/**
+ * Per-concern configuration hooks composed by `BlueprintProvider`.
+ *
+ * Contract: every hook in this folder MUST return a referentially stable value
+ * via `useMemo`. Otherwise, `BlueprintProvider`'s context value churns on
+ * every render and forces every Blueprint consumer to re-render.
+ */
+export { useAnimationsConfiguration } from './useAnimationsConfiguration';
+export { useTypographyConfiguration } from './useTypographyConfiguration';

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

@@ -0,0 +1,36 @@
+import { type BlueprintProviderProps } from '../types';
+/**
+ * Resolved animations slice of `BlueprintConfiguration`.
+ * Owned by this hook so the animations concern is self-describing — the
+ * aggregate `BlueprintConfiguration` is composed from this slice in
+ * `../types.ts` rather than the other way around.
+ */
+export interface BlueprintConfigurationAnimations {
+    componentsWithAnimationEnabled: string[];
+}
+/**
+ * Caller-supplied overrides for the animations slice. Every field is optional;
+ * missing fields fall through to the `useTreatment`-driven Split.io resolution.
+ * The aggregate `BlueprintConfigurationOverrides` is composed from this slice.
+ */
+export interface AnimationsOverrides {
+    animationsPhase1Enabled?: boolean;
+    animationsPhase2Enabled?: boolean;
+    animationsPhase3Enabled?: boolean;
+}
+/**
+ * Resolves the animations slice of the Blueprint configuration by combining
+ * per-phase override booleans with the `useTreatment`-driven Split.io
+ * treatments.
+ *
+ * Each phase is resolved independently: if the matching override is defined
+ * it forces the value, otherwise the value comes from the corresponding
+ * Split treatment (only `TREATMENT_STATES.ON` enables a phase).
+ *
+ * The return value is referentially stable across renders when the resolved
+ * per-phase enablement flags are unchanged.
+ */
+export declare const useAnimationsConfiguration: ({ useTreatment, overrides, }: {
+    useTreatment: BlueprintProviderProps["useTreatment"];
+    overrides: AnimationsOverrides;
+}) => BlueprintConfigurationAnimations;

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

@@ -0,0 +1,32 @@
+import { useMemo } from 'react';
+import { BLUEPRINT_CONFIGURATION_SPLITS, ANIMATED_COMPONENTS_BY_PHASE } from '../consts.js';
+import { isTreatmentEnabled } from '../utils.js';
+
+/**
+ * Resolves the animations slice of the Blueprint configuration by combining
+ * per-phase override booleans with the `useTreatment`-driven Split.io
+ * treatments.
+ *
+ * Each phase is resolved independently: if the matching override is defined
+ * it forces the value, otherwise the value comes from the corresponding
+ * Split treatment (only `TREATMENT_STATES.ON` enables a phase).
+ *
+ * The return value is referentially stable across renders when the resolved
+ * per-phase enablement flags are unchanged.
+ */
+const useAnimationsConfiguration = ({
+  useTreatment,
+  overrides
+}) => {
+  const phase1Treatment = useTreatment(BLUEPRINT_CONFIGURATION_SPLITS.animationsPhase1);
+  const phase2Treatment = useTreatment(BLUEPRINT_CONFIGURATION_SPLITS.animationsPhase2);
+  const phase3Treatment = useTreatment(BLUEPRINT_CONFIGURATION_SPLITS.animationsPhase3);
+  const phase1Enabled = overrides.animationsPhase1Enabled ?? isTreatmentEnabled(phase1Treatment);
+  const phase2Enabled = overrides.animationsPhase2Enabled ?? isTreatmentEnabled(phase2Treatment);
+  const phase3Enabled = overrides.animationsPhase3Enabled ?? isTreatmentEnabled(phase3Treatment);
+  return useMemo(() => ({
+    componentsWithAnimationEnabled: [...(phase1Enabled ? ANIMATED_COMPONENTS_BY_PHASE.phase1 : []), ...(phase2Enabled ? ANIMATED_COMPONENTS_BY_PHASE.phase2 : []), ...(phase3Enabled ? ANIMATED_COMPONENTS_BY_PHASE.phase3 : [])]
+  }), [phase1Enabled, phase2Enabled, phase3Enabled]);
+};
+
+export { useAnimationsConfiguration };

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

@@ -0,0 +1,31 @@
+import { type TypographyOption } from '../types';
+/**
+ * Resolved typography slice of `BlueprintConfiguration`.
+ * Owned by this hook so the typography concern is self-describing — the
+ * aggregate `BlueprintConfiguration` is composed from this slice in
+ * `../types.ts` rather than the other way around.
+ */
+export interface BlueprintConfigurationTypography {
+    typography: TypographyOption;
+}
+/**
+ * Caller-supplied overrides for the typography slice. Every field is optional;
+ * missing fields fall through to `BLUEPRINT_CONFIGURATION_DEFAULTS.typography`.
+ * The aggregate `BlueprintConfigurationOverrides` is composed from this slice.
+ */
+export interface TypographyOverrides {
+    typography?: TypographyOption;
+}
+/**
+ * Resolves the typography slice of the Blueprint configuration.
+ *
+ * If `overrides.typography` is provided it is used verbatim; otherwise the
+ * value falls back to `BLUEPRINT_CONFIGURATION_DEFAULTS.typography`.
+ *
+ * The return value is referentially stable across renders when the resolved
+ * typography value is unchanged so that consumers can safely use it as a
+ * `useMemo` dependency.
+ */
+export declare const useTypographyConfiguration: ({ overrides, }: {
+    overrides: TypographyOverrides;
+}) => BlueprintConfigurationTypography;

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

@@ -0,0 +1,25 @@
+import { useMemo } from 'react';
+import { BLUEPRINT_CONFIGURATION_DEFAULTS } from '../consts.js';
+
+/**
+ * Resolves the typography slice of the Blueprint configuration.
+ *
+ * If `overrides.typography` is provided it is used verbatim; otherwise the
+ * value falls back to `BLUEPRINT_CONFIGURATION_DEFAULTS.typography`.
+ *
+ * The return value is referentially stable across renders when the resolved
+ * typography value is unchanged so that consumers can safely use it as a
+ * `useMemo` dependency.
+ */
+const useTypographyConfiguration = ({
+  overrides
+}) => {
+  const {
+    typography
+  } = overrides;
+  return useMemo(() => ({
+    typography: typography ?? BLUEPRINT_CONFIGURATION_DEFAULTS.typography
+  }), [typography]);
+};
+
+export { useTypographyConfiguration };

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

@@ -1,3 +1,35 @@
+import { TypographyOption } from './types';
+/**
+ * Blueprint configuration options dictionary.
+ * Import this to access all available configuration values.
+ */
+export declare const BlueprintConfigurationOptions: {
+    readonly typography: typeof TypographyOption;
+};
+/**
+ * Mirror of `@box/split-io`'s `TREATMENT_STATES` constant. Inlined rather than
+ * imported because `@box/split-io` is an internal, unpublished workspace
+ * package — depending on it would break `npm install @box/blueprint-web` for
+ * any external consumer (e.g. BUIE, 3rd-party apps).
+ *
+ * The values are Split.io's own wire protocol (the strings their SDK returns
+ * from `getTreatment`), not a Box abstraction, so they are safe to duplicate.
+ * If Split.io ever changes these values, update both this constant and
+ * `packages/split-io/src/constants.ts`.
+ */
+export declare const TREATMENT_STATES: {
+    readonly CONTROL: "control";
+    readonly ON: "on";
+    readonly OFF: "off";
+};
+/**
+ * List of Split.io flags used for Blueprint features release process
+ */
+export declare const BLUEPRINT_CONFIGURATION_SPLITS: {
+    readonly animationsPhase1: "launchpad_blueprint_animations_phase_1";
+    readonly animationsPhase2: "launchpad_blueprint_animations_phase_2";
+    readonly animationsPhase3: "launchpad_blueprint_animations_phase_3";
+};
 /**
  * List of components by animations phase:
  * phase1: defined in LXP-104
@@ -9,3 +41,11 @@ export declare const ANIMATED_COMPONENTS_BY_PHASE: {
     readonly phase2: readonly ["DropdownTrigger", "Switch", "Checkbox", "TextInput", "Select", "Datepicker", "TextArea", "Combobox", "PasswordInput", "ComboboxGroup"];
     readonly phase3: readonly [];
 };
+/**
+ * Default values for Blueprint configuration properties that are not driven by
+ * a Split.io treatment. Read by the per-concern configuration hooks when no
+ * `configurationOverrides` value is supplied.
+ */
+export declare const BLUEPRINT_CONFIGURATION_DEFAULTS: {
+    readonly typography: TypographyOption.lato;
+};

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

@@ -1,13 +1,55 @@
+import { deepFreeze } from './deep-freeze.js';
+import { TypographyOption } from './types.js';
+
+/**
+ * Blueprint configuration options dictionary.
+ * Import this to access all available configuration values.
+ */
+const BlueprintConfigurationOptions = deepFreeze({
+  typography: TypographyOption
+});
+/**
+ * Mirror of `@box/split-io`'s `TREATMENT_STATES` constant. Inlined rather than
+ * imported because `@box/split-io` is an internal, unpublished workspace
+ * package — depending on it would break `npm install @box/blueprint-web` for
+ * any external consumer (e.g. BUIE, 3rd-party apps).
+ *
+ * The values are Split.io's own wire protocol (the strings their SDK returns
+ * from `getTreatment`), not a Box abstraction, so they are safe to duplicate.
+ * If Split.io ever changes these values, update both this constant and
+ * `packages/split-io/src/constants.ts`.
+ */
+const TREATMENT_STATES = deepFreeze({
+  CONTROL: 'control',
+  ON: 'on',
+  OFF: 'off'
+});
+/**
+ * List of Split.io flags used for Blueprint features release process
+ */
+const BLUEPRINT_CONFIGURATION_SPLITS = deepFreeze({
+  animationsPhase1: 'launchpad_blueprint_animations_phase_1',
+  animationsPhase2: 'launchpad_blueprint_animations_phase_2',
+  animationsPhase3: 'launchpad_blueprint_animations_phase_3'
+});
 /**
  * List of components by animations phase:
  * phase1: defined in LXP-104
  * phase2: defined in LXP-1118
  * phase3: defined in LXP-1196 (pending)
  */
-const ANIMATED_COMPONENTS_BY_PHASE = {
+const ANIMATED_COMPONENTS_BY_PHASE = deepFreeze({
   phase1: ['Button', 'IconButton', 'DropdownMenu', 'Tooltip', 'Popover', 'SplitButton', 'CardTooltip', 'NavigationMenu', 'Modal', 'TextButton', 'ContextMenu'],
   phase2: ['DropdownTrigger', 'Switch', 'Checkbox', 'TextInput', 'Select', 'Datepicker', 'TextArea', 'Combobox', 'PasswordInput', 'ComboboxGroup'],
   phase3: []
-};
+});
+/**
+ * Default values for Blueprint configuration properties that are not driven by
+ * a Split.io treatment. Read by the per-concern configuration hooks when no
+ * `configurationOverrides` value is supplied.
+ */
+const BLUEPRINT_CONFIGURATION_DEFAULTS = deepFreeze({
+  typography: BlueprintConfigurationOptions.typography.lato
+});
 
-export { ANIMATED_COMPONENTS_BY_PHASE };
+export { ANIMATED_COMPONENTS_BY_PHASE, BLUEPRINT_CONFIGURATION_DEFAULTS, BLUEPRINT_CONFIGURATION_SPLITS, BlueprintConfigurationOptions, TREATMENT_STATES };

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

@@ -0,0 +1,13 @@
+/**
+ * Recursively freezes `value` and all of its nested object/array members.
+ * Used to back the runtime immutability of the module-level configuration
+ * constants on top of the compile-time `readonly` guarantees that `as const`
+ * already provides — guarding against mutation via `as any` casts, pure-JS
+ * consumers, and accidental shared-reference writes (e.g. tests monkey-patching
+ * a default).
+ *
+ * Lives in its own file (rather than `utils.ts`) so that `consts.ts` can
+ * depend on it without forming a cycle with `utils.ts`, which itself needs
+ * to import constants from `consts.ts`.
+ */
+export declare const deepFreeze: <T>(value: T) => T;

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

@@ -0,0 +1,21 @@
+/**
+ * Recursively freezes `value` and all of its nested object/array members.
+ * Used to back the runtime immutability of the module-level configuration
+ * constants on top of the compile-time `readonly` guarantees that `as const`
+ * already provides — guarding against mutation via `as any` casts, pure-JS
+ * consumers, and accidental shared-reference writes (e.g. tests monkey-patching
+ * a default).
+ *
+ * Lives in its own file (rather than `utils.ts`) so that `consts.ts` can
+ * depend on it without forming a cycle with `utils.ts`, which itself needs
+ * to import constants from `consts.ts`.
+ */
+const deepFreeze = value => {
+  if (value && typeof value === 'object' && !Object.isFrozen(value)) {
+    Object.values(value).forEach(deepFreeze);
+    Object.freeze(value);
+  }
+  return value;
+};
+
+export { deepFreeze };

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

@@ -1,2 +1,5 @@
-export { BlueprintConfigurationOptions, BlueprintConfigurationProvider } from './blueprint-configuration-context';
+export { BlueprintConfigurationContext, BlueprintProvider } from './blueprint-configuration-context';
+export { BlueprintConfigurationOptions } from './consts';
 export { useBlueprintConfiguration } from './useBlueprintConfiguration';
+export { useNoopTreatment } from './utils';
+export type { BlueprintConfigurationOverrides, BlueprintProviderProps } from './types';

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

@@ -0,0 +1,41 @@
+import { type ReactNode } from 'react';
+import { type AnimationsOverrides, type BlueprintConfigurationAnimations } from './configuration-hooks/useAnimationsConfiguration';
+import { type BlueprintConfigurationTypography, type TypographyOverrides } from './configuration-hooks/useTypographyConfiguration';
+export type SplitAttributes = Record<string, string | number | boolean | string[] | number[]>;
+export declare enum TypographyOption {
+    lato = "lato",
+    inter = "inter"
+}
+/**
+ * Aggregate Blueprint configuration exposed via React context. Composed from
+ * the per-concern slices owned by each configuration hook so this module stays
+ * decoupled from the internals of any single slice.
+ */
+export type BlueprintConfiguration = BlueprintConfigurationTypography & BlueprintConfigurationAnimations;
+/**
+ * Aggregate overrides accepted by `BlueprintProvider`'s `configurationOverrides`
+ * prop. Composed from the per-concern override slices owned by each
+ * configuration hook; adding a new concern means adding its slice to this
+ * intersection (no per-key knowledge lives here).
+ */
+export type BlueprintConfigurationOverrides = TypographyOverrides & AnimationsOverrides;
+export interface BlueprintProviderProps {
+    children: ReactNode;
+    /**
+     * React hook used to read Split.io treatments.
+     * Must be a stable function reference and follow the Rules of Hooks (called
+     * unconditionally on every render).
+     *
+     * Consumers that don't want Split.io-driven behavior (tests, Storybook
+     * stories, or apps that force all values via `configurationOverrides`)
+     * should pass the exported `useNoopTreatment`, which always resolves to
+     * `TREATMENT_STATES.CONTROL`.
+     */
+    useTreatment: (splitName: string, attributes?: SplitAttributes) => string;
+    /**
+     * Optional overrides for the resolved Blueprint configuration. Any property
+     * supplied here forces that value and bypasses the corresponding
+     * `useTreatment`-driven resolution.
+     */
+    configurationOverrides?: BlueprintConfigurationOverrides;
+}

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

@@ -0,0 +1,7 @@
+var TypographyOption;
+(function (TypographyOption) {
+  TypographyOption["lato"] = "lato";
+  TypographyOption["inter"] = "inter";
+})(TypographyOption || (TypographyOption = {}));
+
+export { TypographyOption };

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

@@ -1 +1,5 @@
-export declare const useBlueprintConfiguration: () => import("./blueprint-configuration-context").BlueprintConfiguration;
+/**
+ * Reads the Blueprint configuration from the nearest `BlueprintProvider`.
+ * Returns the default configuration when used outside of any provider.
+ */
+export declare const useBlueprintConfiguration: () => import("./types").BlueprintConfiguration;

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

@@ -1,6 +1,10 @@
 import { useContext } from 'react';
 import { BlueprintConfigurationContext } from './blueprint-configuration-context.js';
 
+/**
+ * Reads the Blueprint configuration from the nearest `BlueprintProvider`.
+ * Returns the default configuration when used outside of any provider.
+ */
 const useBlueprintConfiguration = () => {
   return useContext(BlueprintConfigurationContext);
 };

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

@@ -0,0 +1,14 @@
+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;
+/**
+ * No-op `useTreatment` implementation that always resolves to
+ * `TREATMENT_STATES.CONTROL`. Because `isTreatmentEnabled` maps CONTROL to
+ * `false`, passing this as `BlueprintProvider`'s `useTreatment` prop disables
+ * every treatment-driven phase by default.
+ *
+ * Use this in tests, Storybook stories, and any consumer that intentionally
+ * drives `BlueprintProvider` via explicit `configurationOverrides` values
+ * rather than Split.io.
+ */
+export declare const useNoopTreatment: () => "control";

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

@@ -0,0 +1,16 @@
+import { TREATMENT_STATES } from './consts.js';
+
+const isTreatmentEnabled = treatment => treatment === TREATMENT_STATES.ON;
+/**
+ * No-op `useTreatment` implementation that always resolves to
+ * `TREATMENT_STATES.CONTROL`. Because `isTreatmentEnabled` maps CONTROL to
+ * `false`, passing this as `BlueprintProvider`'s `useTreatment` prop disables
+ * every treatment-driven phase by default.
+ *
+ * Use this in tests, Storybook stories, and any consumer that intentionally
+ * drives `BlueprintProvider` via explicit `configurationOverrides` values
+ * rather than Split.io.
+ */
+const useNoopTreatment = () => TREATMENT_STATES.CONTROL;
+
+export { isTreatmentEnabled, useNoopTreatment };

package/dist/lib-esm/card-tooltip/card-tooltip.js

@@ -3,6 +3,7 @@ import * as Ariakit from '@ariakit/react';
 import clsx from 'clsx';
 import { forwardRef, useRef, useLayoutEffect, useCallback } from 'react';
 import '../blueprint-configuration-context/blueprint-configuration-context.js';
+import '../blueprint-configuration-context/consts.js';
 import { useBlueprintConfiguration } from '../blueprint-configuration-context/useBlueprintConfiguration.js';
 import { useBlueprintModernization } from '../blueprint-modernization-context/useBlueprintModernization.js';
 import { Card } from '../card/card.js';

package/dist/lib-esm/combobox-group/combobox-group-combobox.js

@@ -4,6 +4,7 @@ import { forwardRef, useCallback, useEffect } from 'react';
 import '@box/blueprint-web-assets/tokens/px-tokens';
 import '@radix-ui/react-tooltip';
 import '../blueprint-configuration-context/blueprint-configuration-context.js';
+import '../blueprint-configuration-context/consts.js';
 import { Combobox } from '../combobox/combobox.js';
 import { useComboboxGroupContext } from './combobox-group-context.js';
 import styles from './combobox-group.module.js';