@oxyhq/bloom 0.89.0 → 1.0.1

package/lib/typescript/module/theme/color-scope/ColorScope.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+import type { AppColorName } from '../color-presets';
+export interface BloomColorScopeProps {
+    /**
+     * Preset to apply within this subtree. When `undefined`, the scope is a
+     * no-op and children inherit the parent scope's preset unchanged.
+     */
+    colorPreset: AppColorName | undefined;
+    /**
+     * When `true`, do not render a wrapping `<View>`. The single child is cloned
+     * with the scope's CSS vars merged into its `style` prop (Radix-style).
+     */
+    asChild?: boolean;
+    /** Additional style applied to the wrapping `<View>` (or merged into the cloned child with `asChild`). */
+    style?: StyleProp<ViewStyle>;
+    children: React.ReactNode;
+}
+export declare function BloomColorScope({ colorPreset, asChild, style, children, }: BloomColorScopeProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Escape hatch for advanced cases where the wrapping element is owned by the
+ * caller. Returns a stable native style object carrying the preset's CSS vars
+ * via NativeWind's `vars()`. Returns `undefined` on web or when `nativewind`
+ * is not installed.
+ *
+ * NOTE: subject to the react-native-css@3 limitation — the returned style only
+ * propagates vars to descendants when applied to an interop className component
+ * (the runtime gates propagation on matched className style rules). It is a
+ * no-op on a plain `<View>` with no `className`. For the common case prefer
+ * `<BloomColorScope>`, which wraps children in `VariableContextProvider`.
+ */
+export declare function useColorScopeStyle(colorPreset: AppColorName): StyleProp<ViewStyle>;
+//# sourceMappingURL=ColorScope.d.ts.map

package/lib/typescript/module/theme/color-scope/ColorScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScope.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/ColorScope.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAC3F,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAMD,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,oBAAoB,2CA4DtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC,SAAS,CAAC,CAYlF"}

package/lib/typescript/module/theme/color-scope/ColorScope.web.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { AppColorName } from '../color-presets';
+export interface BloomColorScopeProps {
+    /**
+     * Preset to apply within this subtree. When `undefined`, the scope is a
+     * no-op and children inherit the parent scope's preset unchanged.
+     */
+    colorPreset: AppColorName | undefined;
+    /**
+     * When `true`, do not render a wrapping `<div>`. The single child is cloned
+     * with the scope's CSS vars merged into its `style` prop (Radix-style).
+     */
+    asChild?: boolean;
+    /** Additional style applied to the wrapping `<div>` (or merged into the cloned child with `asChild`). */
+    style?: React.CSSProperties;
+    children: React.ReactNode;
+}
+export declare function BloomColorScope({ colorPreset, asChild, style, children, }: BloomColorScopeProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Escape hatch for advanced cases where the wrapping element is owned by the
+ * caller. Returns a stable React style object carrying the preset's CSS vars.
+ */
+export declare function useColorScopeStyle(colorPreset: AppColorName): React.CSSProperties;
+//# sourceMappingURL=ColorScope.web.d.ts.map

package/lib/typescript/module/theme/color-scope/ColorScope.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScope.web.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/ColorScope.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAI3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgBrD,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yGAAyG;IACzG,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAuBD,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,oBAAoB,2CAoDtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,YAAY,GAAG,KAAK,CAAC,aAAa,CAYjF"}

package/lib/typescript/module/theme/color-scope/index.d.ts

@@ -1,33 +1,3 @@
-import React from 'react';
-import { type StyleProp, type ViewStyle } from 'react-native';
-import type { AppColorName } from '../color-presets';
-export interface BloomColorScopeProps {
-    /**
-     * Preset to apply within this subtree. When `undefined`, the scope is a
-     * no-op and children inherit the parent scope's preset unchanged.
-     */
-    colorPreset: AppColorName | undefined;
-    /**
-     * When `true`, do not render a wrapping `<View>`. The single child is cloned
-     * with the scope's CSS vars merged into its `style` prop (Radix-style).
-     */
-    asChild?: boolean;
-    /** Additional style applied to the wrapping `<View>` (or merged into the cloned child with `asChild`). */
-    style?: StyleProp<ViewStyle>;
-    children: React.ReactNode;
-}
-export declare function BloomColorScope({ colorPreset, asChild, style, children, }: BloomColorScopeProps): import("react/jsx-runtime").JSX.Element;
-/**
- * Escape hatch for advanced cases where the wrapping element is owned by the
- * caller. Returns a stable native style object carrying the preset's CSS vars
- * via NativeWind's `vars()`. Returns `undefined` on web or when `nativewind`
- * is not installed.
- *
- * NOTE: subject to the react-native-css@3 limitation — the returned style only
- * propagates vars to descendants when applied to an interop className component
- * (the runtime gates propagation on matched className style rules). It is a
- * no-op on a plain `<View>` with no `className`. For the common case prefer
- * `<BloomColorScope>`, which wraps children in `VariableContextProvider`.
- */
-export declare function useColorScopeStyle(colorPreset: AppColorName): StyleProp<ViewStyle>;
+export { BloomColorScope, useColorScopeStyle } from './ColorScope';
+export type { BloomColorScopeProps } from './ColorScope';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/theme/color-scope/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAC3F,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAMD,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,oBAAoB,2CA4DtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC,SAAS,CAAC,CAYlF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/lib/typescript/module/theme/color-scope/index.web.d.ts

@@ -1,24 +1,3 @@
-import React from 'react';
-import type { AppColorName } from '../color-presets';
-export interface BloomColorScopeProps {
-    /**
-     * Preset to apply within this subtree. When `undefined`, the scope is a
-     * no-op and children inherit the parent scope's preset unchanged.
-     */
-    colorPreset: AppColorName | undefined;
-    /**
-     * When `true`, do not render a wrapping `<div>`. The single child is cloned
-     * with the scope's CSS vars merged into its `style` prop (Radix-style).
-     */
-    asChild?: boolean;
-    /** Additional style applied to the wrapping `<div>` (or merged into the cloned child with `asChild`). */
-    style?: React.CSSProperties;
-    children: React.ReactNode;
-}
-export declare function BloomColorScope({ colorPreset, asChild, style, children, }: BloomColorScopeProps): import("react/jsx-runtime").JSX.Element;
-/**
- * Escape hatch for advanced cases where the wrapping element is owned by the
- * caller. Returns a stable React style object carrying the preset's CSS vars.
- */
-export declare function useColorScopeStyle(colorPreset: AppColorName): React.CSSProperties;
+export { BloomColorScope, useColorScopeStyle } from './ColorScope.web';
+export type { BloomColorScopeProps } from './ColorScope.web';
 //# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/module/theme/color-scope/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/index.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAI3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgBrD,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yGAAyG;IACzG,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAuBD,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,oBAAoB,2CAoDtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,YAAY,GAAG,KAAK,CAAC,aAAa,CAYjF"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/index.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/typescript/module/theme/color-utils.d.ts

@@ -15,12 +15,31 @@ export interface RgbChannels {
     g: number;
     b: number;
 }
+/** RGB channels plus the alpha they were written with, 0..1. */
+export interface RgbaChannels extends RgbChannels {
+    a: number;
+}
 /**
- * Parse a color string into its RGB channels, or `null` if it can't be parsed.
+ * Parse a color string into its RGB channels AND its alpha, or `null` if it
+ * can't be parsed.
  *
  * Accepts Bloom's canonical space-separated `rgb(r g b)` output, legacy
- * comma-separated `rgb(r, g, b)` / `rgba(...)`, and `#rgb` / `#rrggbb` hex.
- * Anything else yields `null` so callers can fall back to the original value.
+ * comma-separated `rgb(r, g, b)` / `rgba(r, g, b, a)`, the slash form
+ * `rgb(r g b / a)` with a decimal or percentage alpha, and `#rgb` / `#rrggbb`
+ * hex. Anything else yields `null` so callers can fall back to the original
+ * value. A color with no alpha component reads back as `a: 1`.
+ *
+ * The alpha matters because half the palette carries one: the `*Subtle` tints
+ * resolve to `rgba(r, g, b, 0.13)` in light and `0.24` in dark, so anything
+ * compositing onto a tint has to know it is compositing onto something
+ * translucent — dropping the alpha silently turns a tint into an opaque fill.
+ */
+export declare function parseRgba(color: string): RgbaChannels | null;
+/**
+ * Parse a color string into its RGB channels, or `null` if it can't be parsed.
+ *
+ * Discards any alpha the string carried — use {@link parseRgba} when the alpha
+ * is part of what you are computing.
  */
 export declare function parseRgb(color: string): RgbChannels | null;
 /** Compose `color` at `alpha`; returns the input unchanged if it can't parse. */

package/lib/typescript/module/theme/color-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-utils.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAoB1D;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D"}
+{"version":3,"file":"color-utils.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA0B5D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAI1D;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D"}

package/lib/typescript/module/theme/glass-colors.d.ts

@@ -0,0 +1,192 @@
+/**
+ * How much of the caller's own brand fill the pane carries — the reference's
+ * `rgba(212, 116, 101, 0.85)`.
+ *
+ * ── THE GLASS IS THE SHEEN, NOT THE WASH ────────────────────────────────────
+ *
+ * This shipped once at 0.25, and 0.25 is a WASH: the backdrop dominates, the
+ * pane has no body, and the brand reads as a pale stain. What makes a pane read
+ * as glass is the lit top rim, the vertical sheen, the hairline in the fill's
+ * own hue and the blur behind the few percent that do get through — not the
+ * amount you can see through it. At 0.85 the pane is a nearly-solid tinted
+ * surface that you can just sense the backdrop behind, which is what the
+ * reference is and what the earlier value was not.
+ *
+ * ── WHAT 0.85 COSTS, STATED RATHER THAN HIDDEN ──────────────────────────────
+ *
+ * The 15% that bleeds through moves the pane TOWARD the surface under it, and
+ * in light mode that means lighter — which is the direction a white label can
+ * least afford. Measured over 34 presets x 2 modes x 5 Bloom surfaces:
+ *
+ *   `Button` primary     38 of 340 rows fall below WCAG AA, in the band
+ *                        4.17..4.49, ALL of them in LIGHT mode, across fourteen
+ *                        presets (blue, faircoin, green, lagoon, lavender, mint,
+ *                        olive, orange, pine, plum, pumpkin, rose, sky, yellow).
+ *   `Button` destructive 0 of 340. Worst 5.32.
+ *
+ * As a SOLID fill all 680 Button rows pass. The original 18 presets retain
+ * their exact 30/180 shipped failure set; all eight added failures belong to
+ * the new recipes. A browser helper briefly reported 45 only because it parsed
+ * the structured `GLASS_SHEEN.bottom` stop as CSS; that was measurement drift,
+ * never the shipped oracle and never a threshold being relaxed.
+ *
+ * The alpha at which the failures reach zero is **0.89** (worst 4.52), and the
+ * curve between is steep: 0.86 -> 25 rows, 0.87 -> 14, 0.88 -> 5, 0.89 -> 0.
+ * So AA compliance costs four hundredths of alpha. 0.85 is kept because it is
+ * the reference's own value and matching the reference is the requirement;
+ * `glass-colors.test.ts` pins the compromise as an EXACT failure count and an
+ * exact worst ratio rather than as a loosened threshold, so moving the alpha in
+ * either direction fails the suite and has to be a decision rather than a
+ * drift.
+ */
+export declare const GLASS_FILL_ALPHA = 0.85;
+/**
+ * The sheen: simulated light from above, white at the top edge fading to nothing
+ * by 40% and a trace of black at the bottom.
+ *
+ * These are the reference's `#ffffff05` and `#00000005` — 5/255 ≈ 2%. White and
+ * black at 2% are light, not palette: there is no themed "colour of a
+ * highlight", and tinting the sheen with the accent would make it a second fill
+ * rather than a specular.
+ *
+ * ── WHY THE OPACITY IS A SEPARATE FIELD, NOT AN `rgba()` STRING ──────────────
+ *
+ * These stops feed TWO renderers with different models of where alpha lives. A
+ * CSS `linear-gradient` takes it inside the colour; SVG has separate
+ * `stop-color` and `stop-opacity` properties and `react-native-svg` follows SVG
+ * — it parses `stopColor` for its RGB and DISCARDS the alpha channel.
+ *
+ * So an `rgba(255, 255, 255, 0.02)` stop is correct on web and renders OPAQUE
+ * WHITE on native. Measured on an Android emulator (API 37) before this shape
+ * existed: the pane ran a solid white-to-black wipe from 255 at the top to 12 at
+ * the bottom, with the break at exactly 40% — {@link GLASS_SHEEN.middleStop} —
+ * and the brand fill under it was not visible at ANY pixel, R=G=B throughout.
+ * The glass button was achromatic on Android and correct on web.
+ *
+ * Nothing threw, and no gate saw it: the token was shared, the gradient was
+ * built from it, and both forks agreed about every VALUE. Only the SVG
+ * renderer's reading of that value differed. Holding the opacity in its own
+ * field removes the representation that can be silently half-read — the web
+ * string is derived below, and native passes the two fields to the two props
+ * SVG actually defines.
+ */
+export declare const GLASS_SHEEN: {
+    readonly top: {
+        readonly color: "rgb(255, 255, 255)";
+        readonly opacity: 0.02;
+    };
+    readonly middle: {
+        readonly color: "rgb(255, 255, 255)";
+        readonly opacity: 0;
+    };
+    readonly bottom: {
+        readonly color: "rgb(0, 0, 0)";
+        readonly opacity: 0.02;
+    };
+    /** Where the top stop has faded out completely, 0..1 down the surface. */
+    readonly middleStop: 0.4;
+};
+/** One sheen stop as a CSS colour, for the fork whose gradient carries alpha inline. */
+export type GlassSheenStop = {
+    readonly color: string;
+    readonly opacity: number;
+};
+/** A stop as a single CSS `rgba()` — the web gradient's form. */
+export declare function glassSheenCss(stop: GlassSheenStop): string;
+/**
+ * The lit rim: a 1px hairline of white along the top edge.
+ *
+ * A different thing from {@link GLASS_SHEEN}, not a stronger version of it — the
+ * rim is a hard edge where the light catches the lip of the pane, the sheen is
+ * the soft falloff across its face. The reference carries both.
+ *
+ * It is not part of the `glass` shadow role because an inset shadow paints above
+ * an element's own background but BELOW its children, and a native glass surface
+ * is a stack of absolutely-positioned children — so an inset on the outer box is
+ * covered by the first layer that lands on it. `GlassSurface` paints this as the
+ * TOP layer of its own stack, which a caller-applied shadow role cannot reach.
+ * The web fork has no such stack and composes it into one `box-shadow` list.
+ */
+export declare const GLASS_RIM_HIGHLIGHT = "inset 0 1px 0 0 rgba(255, 255, 255, 0.2)";
+/** The reference's `blur(10px)` — the radius of the material, on both platforms. */
+export declare const GLASS_BLUR_RADIUS_PX = 10;
+/**
+ * The web material, as a `backdrop-filter` value.
+ *
+ * The reference's filter verbatim: a blur and nothing else. No `saturate()` —
+ * that is `expo-blur`'s addition, not the reference's, and the two are visibly
+ * different over a colourful backdrop.
+ */
+export declare const GLASS_BLUR_FILTER = "blur(10px)";
+/**
+ * The sheen as one CSS `linear-gradient`, for a fork that renders a raw DOM
+ * element and sets `background-image` directly.
+ *
+ * Derived from {@link GLASS_SHEEN} rather than written out, so the web fork and
+ * the native `Svg` gradient cannot drift to different stops. Note what that
+ * guarantee does and does not cover: it pins the two to the same VALUES, which
+ * is why it stayed green while native rendered them opaque — see the alpha note
+ * on {@link GLASS_SHEEN}. Sharing a token is not the same as agreeing about it.
+ */
+export declare const GLASS_SHEEN_GRADIENT: string;
+/**
+ * Intensity handed to `expo-blur`'s `BlurView` on NATIVE, derived from
+ * {@link GLASS_BLUR_RADIUS_PX} through the `intensity * 0.2` px radius its web
+ * build computes.
+ *
+ * KNOWN PLATFORM DIFFERENCE, stated rather than papered over: `expo-blur` cannot
+ * be asked for a blur radius WITHOUT also painting a tint of its own — one
+ * `intensity` drives both, at `intensity/100 * 0.78` — whereas CSS
+ * `backdrop-filter` is a pure blur. So the native pane carries one extra neutral
+ * layer the web pane does not.
+ *
+ * At 0.85 that extra layer is almost nothing, and the measurement says so: it
+ * sits UNDER a fill that already covers 85%, so it can only tint the 15% that
+ * gets through. Across the whole matrix the worst per-channel difference
+ * between the web pane and the native pane is **2.35** of 255, and the two
+ * legibility floors are 4.17 (web) and 4.19 (native).
+ *
+ * That is a real change from the 0.25 material, where the same layer moved the
+ * two stacks visibly apart — the more opaque the fill, the less the platform
+ * difference can matter. It is measured on every release rather than assumed,
+ * because it is the kind of gap that widens the moment the alpha moves.
+ */
+export declare const GLASS_BLUR_INTENSITY: number;
+export interface GlassColors {
+    /** The translucent pane — the caller's brand fill at {@link GLASS_FILL_ALPHA}. */
+    fill: string;
+    /** The hairline: the SAME fill at full strength — the reference's `border` hue. */
+    hairline: string;
+    /** Width of that hairline. `0.5` on web; see `GlassSurface` for the native note. */
+    hairlineWidth: number;
+}
+/**
+ * Resolve the PANE around one opaque brand fill.
+ *
+ * `fill` is a resolved token the caller already holds — `colors.primary`,
+ * `colors.negative`, `colors.success` — rather than a tone name, because the
+ * caller is the only one who knows which token its variant means. `Button`'s
+ * `destructive` is `colors.negative` (the engine's error ROLE) and not
+ * `colors.error` (the fixed status seed): measured, those two differ in all 68
+ * preset x mode combinations and by as much as `rgb(255 180 171)` against
+ * `rgb(209 45 50)` on `teal`/dark, so a tone vocabulary here would have
+ * silently repainted every destructive button on the way past.
+ *
+ * ── THE LABEL IS NOT RETURNED, AND THAT IS THE POINT ────────────────────────
+ *
+ * A glass pane's label is the fill's OWN on-colour — `primaryForeground` for
+ * `primary`, `negativeForeground` for `destructive` — which the caller is
+ * already holding beside the fill it passed in. Returning it would be a
+ * pass-through pretending to be a decision.
+ *
+ * It is worth writing down WHY it is that token, because at 0.25 it was
+ * `colors.text` and that was correct THEN: a pane that is three-quarters
+ * backdrop takes its luminance from the page, so it needed the page's reading
+ * colour. At 0.85 the pane is the fill, so it takes the fill's own label: on
+ * the complete 2040-row matrix (34 presets x 2 modes x 6 tones x 5 surfaces),
+ * `colors.text` fails AA on 1714 rows (worst 1.21) against the on-fill token's
+ * 305 (worst 4.17). Neither count is permanent; the gate re-measures and pins
+ * both on every alpha or surface change.
+ */
+export declare function resolveGlassColors(fill: string): GlassColors;
+//# sourceMappingURL=glass-colors.d.ts.map

package/lib/typescript/module/theme/glass-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass-colors.d.ts","sourceRoot":"","sources":["../../../../src/theme/glass-colors.ts"],"names":[],"mappings":"AAyEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;IAItB,0EAA0E;;CAElE,CAAC;AAEX,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,6CAA6C,CAAC;AAE9E,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,eAAoC,CAAC;AAEnE;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,QAA4K,CAAC;AAE9M;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,QAA6B,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAM5D"}

package/lib/typescript/module/theme/index.d.ts

@@ -4,10 +4,8 @@ export { BloomColorScope, useColorScopeStyle } from './color-scope';
 export type { BloomColorScopeProps } from './color-scope';
 export { BloomSeedScope } from './seed-scope';
 export type { BloomSeedScopeProps } from './seed-scope';
-export { buildSeedScopeVars, roleColorsToPresetTokens } from './color-scope/seed-scope';
-export type { SeedScopeOptions } from './color-scope/seed-scope';
-export { generateRoleColors, seedHexFromImagePixels, seedsFromImagePixels, quantizeImage, argbFromHex, hexFromArgb, argbFromRgb, redFromArgb, greenFromArgb, blueFromArgb, } from './color-engine';
-export type { RoleColors, GenerateOptions, RoleName, SchemeVariant, AccentSources } from './color-engine';
+export { roleColorsToPresetTokens } from './color-scope/seed-scope';
+export * as ColorEngine from './color-engine';
 export { buildTheme, STATUS_COLORS } from './build-theme';
 export { buildThemeFromSeed, buildColorsFromSeed } from './build-theme-from-seed';
 export type { SeedAccents } from './build-theme-from-seed';
@@ -18,12 +16,14 @@ export type { AmbientThemeState, AmbientThemeApi, AmbientAccents, UseAmbientThem
 export { useNavigationTheme } from './use-navigation-theme';
 export type { NavigationTheme, NavigationThemeFont } from './use-navigation-theme';
 export type { Theme, ThemeColors, ThemeMode, ThemeGradient, ThemeGradients } from './types';
-export type { AppColorName, AppColorPreset, ColorPresetGate, PresetTokens } from './color-presets';
-export { APP_COLOR_NAMES, FREE_COLOR_NAMES, HANDLE_COLOR_NAMES, PREMIUM_COLOR_NAMES, APP_COLOR_PRESETS, HEX_TO_APP_COLOR, hexToAppColorName, } from './color-presets';
-export { parseRgb, withAlpha } from './color-utils';
-export type { RgbChannels } from './color-utils';
-export { getPresetVars, applyPresetVarsToDocument } from './preset-vars';
-export type { ExplicitAccents } from './preset-vars';
+export type { AppColorName, AppColorPreset, ColorPresetFamily, ColorPresetFamilyDefinition, ColorPresetGate, ColorPresetGroup, ColorPresetPairing, ColorPresetRecipe, PresetTokens, } from './color-presets';
+export { APP_COLOR_NAMES, COLOR_PLAYGROUND_NAMES, COLOR_PRESET_FAMILIES, COLOR_PRESET_FAMILY_REGISTRY, COLOR_PRESET_GROUPS, COLOR_PRESET_REGISTRY, FREE_COLOR_NAMES, HANDLE_COLOR_NAMES, PREMIUM_COLOR_NAMES, APP_COLOR_PRESETS, HEX_TO_APP_COLOR, hexToAppColorName, } from './color-presets';
+export { parseRgb, parseRgba, withAlpha } from './color-utils';
+export type { RgbChannels, RgbaChannels } from './color-utils';
+export { pressedSurface, PRESS_LAYER_ALPHA } from './press-colors';
+export { resolveAccentColors } from './accent-colors';
+export type { AccentColors, AccentFill, AccentTone } from './accent-colors';
+export { applyPresetVarsToDocument } from './preset-vars';
 export { applyDarkClass } from './apply-dark-class';
 export { setColorSchemeSafe } from './set-color-scheme-safe';
 export { initCssInteropDarkMode } from './init-css-interop';

package/lib/typescript/module/theme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5F,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAepE,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5F,YAAY,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAK/D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/lib/typescript/module/theme/index.web.d.ts

@@ -0,0 +1,32 @@
+export { BloomThemeProvider } from './BloomThemeProvider';
+export type { BloomThemeProviderProps, BloomThemeContextValue, } from './BloomThemeProvider';
+export { BloomColorScope, useColorScopeStyle } from './color-scope/index.web';
+export type { BloomColorScopeProps } from './color-scope/index.web';
+export { BloomSeedScope } from './seed-scope/index.web';
+export type { BloomSeedScopeProps } from './seed-scope/index.web';
+export { roleColorsToPresetTokens } from './color-scope/seed-scope';
+export * as ColorEngine from './color-engine';
+export { buildTheme, STATUS_COLORS } from './build-theme';
+export { buildThemeFromSeed, buildColorsFromSeed } from './build-theme-from-seed';
+export type { SeedAccents } from './build-theme-from-seed';
+export { THEME_GRADIENTS } from './gradients';
+export { useTheme, useThemeColor, useBloomTheme } from './use-theme';
+export { useAmbientTheme, ambientTheme } from './ambient-store';
+export type { AmbientThemeState, AmbientThemeApi, AmbientAccents, UseAmbientThemeOptions, } from './ambient-store';
+export { useNavigationTheme } from './use-navigation-theme';
+export type { NavigationTheme, NavigationThemeFont } from './use-navigation-theme';
+export type { Theme, ThemeColors, ThemeMode, ThemeGradient, ThemeGradients } from './types';
+export type { AppColorName, AppColorPreset, ColorPresetFamily, ColorPresetFamilyDefinition, ColorPresetGate, ColorPresetGroup, ColorPresetPairing, ColorPresetRecipe, PresetTokens, } from './color-presets';
+export { APP_COLOR_NAMES, COLOR_PLAYGROUND_NAMES, COLOR_PRESET_FAMILIES, COLOR_PRESET_FAMILY_REGISTRY, COLOR_PRESET_GROUPS, COLOR_PRESET_REGISTRY, FREE_COLOR_NAMES, HANDLE_COLOR_NAMES, PREMIUM_COLOR_NAMES, APP_COLOR_PRESETS, HEX_TO_APP_COLOR, hexToAppColorName, } from './color-presets';
+export { parseRgb, parseRgba, withAlpha } from './color-utils';
+export type { RgbChannels, RgbaChannels } from './color-utils';
+export { pressedSurface, PRESS_LAYER_ALPHA } from './press-colors';
+export { resolveAccentColors } from './accent-colors';
+export type { AccentColors, AccentFill, AccentTone } from './accent-colors';
+export { applyPresetVarsToDocument } from './preset-vars';
+export { applyDarkClass } from './apply-dark-class';
+export { setColorSchemeSafe } from './set-color-scheme-safe';
+export { initCssInteropDarkMode } from './init-css-interop';
+export type { BloomThemeStorage, PersistedThemeState } from './persistence';
+export { webLocalStorage } from './persistence';
+//# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/module/theme/index.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/theme/index.web.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAepE,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5F,YAAY,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAK/D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/lib/typescript/module/theme/press-colors.d.ts

@@ -0,0 +1,25 @@
+import type { ThemeColors } from './types';
+/**
+ * Opacity of the pressed state layer, Material 3's value for the pressed state.
+ *
+ * One number for the whole library. A press is the loudest of the three
+ * interaction states, so nothing else may exceed it: `SubtleHover` and the
+ * hover rules sit below.
+ */
+export declare const PRESS_LAYER_ALPHA = 0.12;
+/**
+ * The background a control paints while it is held.
+ *
+ * @param colors - The resolved palette, for the unfilled case's neutral wash.
+ * @param surface - What the control paints at REST. `'transparent'` — or
+ *   anything unparseable — means it has no fill of its own.
+ * @param layer - The control's own label/icon colour, used as the state layer.
+ *
+ * Both fallbacks land on `contrast50` rather than returning `surface` unchanged,
+ * because "no press feedback at all" is the failure this whole change exists to
+ * remove, and an unparseable colour is exactly what a caller-supplied one
+ * (`Checkbox`'s `color`, `Radio`'s `color`) can be — a CSS keyword parses to
+ * neither.
+ */
+export declare function pressedSurface(colors: ThemeColors, surface: string, layer: string): string;
+//# sourceMappingURL=press-colors.d.ts.map

package/lib/typescript/module/theme/press-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"press-colors.d.ts","sourceRoot":"","sources":["../../../../src/theme/press-colors.ts"],"names":[],"mappings":"AA2CA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAuBtC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR"}

package/lib/typescript/module/theme/seed-scope/SeedScope.d.ts

@@ -0,0 +1,45 @@
+import React from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+import type { SchemeVariant } from '../color-engine';
+export interface BloomSeedScopeProps {
+    /**
+     * The seed colour (`#rrggbb`) to derive this subtree's palette from. When
+     * `undefined`, the scope is a no-op and children inherit the parent scope
+     * unchanged — pass `undefined` to fall back to the app preset (e.g. on
+     * mouse-leave/blur when restoring the default theme).
+     */
+    seed: string | undefined;
+    /**
+     * Optional explicit secondary-accent seed (`#rrggbb`). Pins the secondary
+     * palette to a distinct brand/artwork colour instead of the derived rotation —
+     * e.g. pass `seedsFromImagePixels(pixels)[1]` for a richer artwork theme.
+     */
+    secondarySeed?: string;
+    /** Optional explicit tertiary-accent seed (`#rrggbb`). Same semantics. */
+    tertiarySeed?: string;
+    /** Tonal scheme variant. Defaults to `'vibrant'` (matches Bloom presets). */
+    variant?: SchemeVariant;
+    /** −1 (low) … 0 (normal) … 1 (high). Defaults to 0. */
+    contrastLevel?: number;
+    /**
+     * When `true`, do not render a wrapping `<View>`. The single child is cloned
+     * with the caller's `style` merged into its `style` prop (Radix-style).
+     */
+    asChild?: boolean;
+    /** Additional style applied to the wrapping `<View>` (or merged into the cloned child with `asChild`). */
+    style?: StyleProp<ViewStyle>;
+    children: React.ReactNode;
+}
+/**
+ * Native `<BloomSeedScope>`: scopes a subtree to an ARBITRARY seed colour's
+ * palette (the dynamic counterpart of `<BloomColorScope>`, which takes a named
+ * preset). Feeds the seed through the colour engine and (1) provides the
+ * resulting canonical CSS vars to descendants via react-native-css's
+ * `VariableContext` — so `bg-background` / `bg-card` / `var(--primary)` resolve
+ * against the seed inside this subtree — and (2) publishes a matching JS `theme`
+ * on `BloomThemeContext`, so `useTheme()`/`useBloomTheme()` consumers inside the
+ * subtree also re-theme. The `colorPreset` field is left as the parent's (a seed
+ * is not a named preset).
+ */
+export declare function BloomSeedScope({ seed, secondarySeed, tertiarySeed, variant, contrastLevel, asChild, style, children, }: BloomSeedScopeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SeedScope.d.ts.map

package/lib/typescript/module/theme/seed-scope/SeedScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedScope.d.ts","sourceRoot":"","sources":["../../../../../src/theme/seed-scope/SeedScope.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAC3F,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAMpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,OAAO,EACP,aAAa,EACb,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,mBAAmB,2CAiDrB"}

package/lib/typescript/module/theme/seed-scope/SeedScope.web.d.ts

@@ -0,0 +1,43 @@
+import React from 'react';
+import type { SchemeVariant } from '../color-engine';
+export interface BloomSeedScopeProps {
+    /**
+     * The seed colour (`#rrggbb`) to derive this subtree's palette from. When
+     * `undefined`, the scope is a no-op and children inherit the parent scope
+     * unchanged — pass `undefined` to fall back to the app preset (e.g. on
+     * mouse-leave/blur when restoring the default theme).
+     */
+    seed: string | undefined;
+    /**
+     * Optional explicit secondary-accent seed (`#rrggbb`). Pins the secondary
+     * palette to a distinct brand/artwork colour instead of the derived rotation —
+     * e.g. pass `seedsFromImagePixels(pixels)[1]` for a richer artwork theme.
+     */
+    secondarySeed?: string;
+    /** Optional explicit tertiary-accent seed (`#rrggbb`). Same semantics. */
+    tertiarySeed?: string;
+    /** Tonal scheme variant. Defaults to `'vibrant'` (matches Bloom presets). */
+    variant?: SchemeVariant;
+    /** −1 (low) … 0 (normal) … 1 (high). Defaults to 0. */
+    contrastLevel?: number;
+    /**
+     * When `true`, do not render a wrapping `<div>`. The single child is cloned
+     * with the scope's CSS vars merged into its `style` prop (Radix-style).
+     */
+    asChild?: boolean;
+    /** Additional style applied to the wrapping `<div>` (or merged into the cloned child with `asChild`). */
+    style?: React.CSSProperties;
+    children: React.ReactNode;
+}
+/**
+ * Web `<BloomSeedScope>`: scopes a subtree to an ARBITRARY seed colour's palette
+ * (the dynamic counterpart of `<BloomColorScope>`). It (1) writes every canonical
+ * `--x` token plus the Tailwind v4 `--color-x` aliases (already resolved to
+ * `rgb(...)`) onto the wrapping element's inline `style`, so NativeWind classes
+ * inside resolve against the seed palette instead of the document root, and
+ * (2) publishes a matching JS `theme` on `BloomThemeContext` so
+ * `useTheme()`/`useBloomTheme()` consumers inside the subtree re-theme too. The
+ * `colorPreset` field is left as the parent's (a seed is not a named preset).
+ */
+export declare function BloomSeedScope({ seed, secondarySeed, tertiarySeed, variant, contrastLevel, asChild, style, children, }: BloomSeedScopeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SeedScope.web.d.ts.map

package/lib/typescript/module/theme/seed-scope/SeedScope.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedScope.web.d.ts","sourceRoot":"","sources":["../../../../../src/theme/seed-scope/SeedScope.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAK3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yGAAyG;IACzG,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,OAAO,EACP,aAAa,EACb,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,mBAAmB,2CA+CrB"}