@oxyhq/bloom 0.26.0 → 0.27.0

package/lib/typescript/commonjs/design-tokens/color-roles.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Semantic color-role vocabulary for the Oxy Unified Design Language.
+ *
+ * Every role is an ALIAS onto one of Bloom's existing canonical theme tokens
+ * (`--background`, `--surface`, `--primary`, …) — the SINGLE source of resolved
+ * color values produced by `getResolvedTokens` and written to the document root
+ * (web) / `rootVariables` (native) by `BloomThemeProvider`. No color VALUE is
+ * invented here: a role's value is the `var(--canonical)` reference, so it stays
+ * driven by the active light/dark mode and color preset automatically.
+ *
+ * The maps are consumed by the Bloom Tailwind preset (`tailwind-preset.ts`),
+ * which slots them into `theme.extend.{backgroundColor,textColor,borderColor}`.
+ * Because the values are `var(--x)` strings, the SAME class names resolve on
+ * Tailwind (web) and NativeWind (native): web reads the CSS custom property from
+ * `document.documentElement`; native reads it from react-native-css's
+ * `rootVariables` family — both populated by Bloom from one pipeline.
+ *
+ * Web CSS-var contract (see Bloom AGENTS.md): base `--x` tokens already resolve
+ * to a FULL `rgb(...)` color at runtime, so the role values reference them with
+ * `var(--x)` directly — NEVER `hsl(var(--x))`.
+ *
+ * ADDITIVE: these are NEW utility names (`bg-fill`, `text-text-tertiary`,
+ * `border-border-image`, …). They do not touch the existing app-defined color
+ * utilities (`bg-background`, `text-muted-foreground`, …), which keep working.
+ */
+/**
+ * Surface / fill roles → background-color utilities (`bg-<role>`).
+ *
+ * | role              | utility            | canonical token   | rationale                                   |
+ * | ----------------- | ------------------ | ----------------- | ------------------------------------------- |
+ * | bg                | bg-bg              | --background      | the page background                          |
+ * | fill              | bg-fill            | --card            | default raised surface (cards/sheets)        |
+ * | fill-secondary    | bg-fill-secondary  | --muted           | muted/secondary fill                         |
+ * | fill-hover        | bg-fill-hover      | --accent          | hover state of a secondary fill              |
+ * | fill-brand        | bg-fill-brand      | --primary         | brand-colored fill                           |
+ * | fill-brand-hover  | bg-fill-brand-hover| --ring            | hover of brand fill (ring == primary hue)    |
+ * | fill-inverse      | bg-fill-inverse    | --foreground      | inverse (high-contrast) fill                 |
+ * | fill-inverse-hover| bg-fill-inverse-hov| --muted-foreground| hover of inverse fill                        |
+ * | fill-placeholder  | bg-fill-placeholder| --muted           | disabled/placeholder surface                 |
+ */
+export declare const FILL_ROLES: {
+    readonly bg: `var(--${string})`;
+    readonly fill: `var(--${string})`;
+    readonly 'fill-secondary': `var(--${string})`;
+    readonly 'fill-hover': `var(--${string})`;
+    readonly 'fill-brand': `var(--${string})`;
+    readonly 'fill-brand-hover': `var(--${string})`;
+    readonly 'fill-inverse': `var(--${string})`;
+    readonly 'fill-inverse-hover': `var(--${string})`;
+    readonly 'fill-placeholder': `var(--${string})`;
+};
+/**
+ * Text roles → text-color utilities (`text-<role>`).
+ *
+ * Tailwind prefixes text-color utilities with `text-`, so a role literally
+ * named `text` becomes the utility `text-text`, `text-secondary` → the utility
+ * `text-text-secondary`, etc. (matches the namespaced spec).
+ *
+ * | role             | utility               | canonical token       | rationale                          |
+ * | ---------------- | --------------------- | --------------------- | ---------------------------------- |
+ * | text             | text-text             | --foreground          | primary text                        |
+ * | text-secondary   | text-text-secondary   | --muted-foreground    | secondary text                      |
+ * | text-tertiary    | text-text-tertiary    | --muted-foreground    | tertiary/least-emphasis text        |
+ * | text-inverse     | text-text-inverse     | --primary-foreground  | text on a brand fill                |
+ * | text-fixed-light | text-text-fixed-light | --primary-foreground  | always-light text (on brand)        |
+ * | text-placeholder | text-text-placeholder | --muted-foreground    | placeholder/input hint              |
+ */
+export declare const TEXT_ROLES: {
+    readonly text: `var(--${string})`;
+    readonly 'text-secondary': `var(--${string})`;
+    readonly 'text-tertiary': `var(--${string})`;
+    readonly 'text-inverse': `var(--${string})`;
+    readonly 'text-fixed-light': `var(--${string})`;
+    readonly 'text-placeholder': `var(--${string})`;
+};
+/**
+ * Border roles → border-color utilities (`border-<role>`).
+ *
+ * | role               | utility                 | canonical token | rationale                                  |
+ * | ------------------ | ----------------------- | --------------- | ------------------------------------------ |
+ * | border             | border-border           | --border        | default border                              |
+ * | border-image       | border-border-image     | --border        | hairline border color (0.5px width helper)  |
+ * | border-secondary   | border-border-secondary | --input         | secondary/softer border                     |
+ * | border-input       | border-border-input     | --input         | input field border                          |
+ * | border-input-active| border-border-input-active | --ring       | focused input border (== primary)           |
+ *
+ * NOTE: the hairline 0.5px WIDTH for `border-image` is shipped as a separate
+ * `borderWidth` scale entry (`border-hairline`) in the preset; the color role
+ * above only provides the matching color. Consumers compose them:
+ * `border-hairline border-border-image`.
+ */
+export declare const BORDER_ROLES: {
+    readonly border: `var(--${string})`;
+    readonly 'border-image': `var(--${string})`;
+    readonly 'border-secondary': `var(--${string})`;
+    readonly 'border-input': `var(--${string})`;
+    readonly 'border-input-active': `var(--${string})`;
+};
+export type FillRole = keyof typeof FILL_ROLES;
+export type TextRole = keyof typeof TEXT_ROLES;
+export type BorderRole = keyof typeof BORDER_ROLES;
+//# sourceMappingURL=color-roles.d.ts.map

package/lib/typescript/commonjs/design-tokens/color-roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-roles.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/color-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;CAUb,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAC/C,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,YAAY,CAAC"}

package/lib/typescript/commonjs/design-tokens/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `@oxyhq/bloom/design-tokens` — the centralized, semantic design-token
+ * vocabulary for the Oxy Unified Design Language.
+ *
+ * Exposes:
+ *   - `bloomTailwindPreset` — the Tailwind/NativeWind preset (web + native) that
+ *     adds the semantic utility classes (`bg-fill`, `text-text-tertiary`,
+ *     `p-space-8`, `rounded-radius-20`, `text-body`, `font-body`, `shadow-s`).
+ *   - `bloomThemeCss` / `bloomThemeBlock` — the Tailwind v4 `@theme` equivalent
+ *     for CSS-configured web apps.
+ *   - The raw token maps (`FILL_ROLES`, `TEXT_ROLES`, `BORDER_ROLES`, `SPACING`,
+ *     `RADIUS`, `TYPOGRAPHY`, `SHADOW_BOX`) for direct programmatic use.
+ *   - `bloomShadowStyle` — platform-correct shadow style object (web box-shadow /
+ *     native elevation) so a consumer writes one call for both platforms.
+ *
+ * Additive and non-breaking: every export here is NEW. It does not change any
+ * existing Bloom token, theme value, or utility class.
+ */
+export { bloomTailwindPreset } from './tailwind-preset';
+export type { TailwindPreset, TailwindPresetThemeExtend, } from './tailwind-preset';
+export { bloomThemeCss, bloomThemeBlock } from './theme-css';
+export { FILL_ROLES, TEXT_ROLES, BORDER_ROLES, } from './color-roles';
+export type { FillRole, TextRole, BorderRole } from './color-roles';
+export { SPACING, RADIUS, BORDER_WIDTH, TYPOGRAPHY, FONT_FAMILY_VARS, } from './scales';
+export type { TypeRole, TypeRoleName } from './scales';
+export { SHADOW_BOX, bloomShadowStyle } from './shadows';
+export type { ShadowRole } from './shadows';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/design-tokens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,cAAc,EACd,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EACL,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/lib/typescript/commonjs/design-tokens/scales.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Numeric design-token scales for the Oxy Unified Design Language.
+ *
+ * These are platform-agnostic plain numbers / CSS strings consumed by the Bloom
+ * Tailwind preset (`tailwind-preset.ts`). The SAME keys produce the SAME utility
+ * class names on Tailwind (web) and NativeWind (native):
+ *   - spacing  → `p-space-8`, `gap-space-20`, `px-screen-margin`, `m-space-16`
+ *   - radius   → `rounded-radius-20`
+ *   - type     → `font-body` (family/weight) + `text-body` (size/lineHeight)
+ *   - shadow   → `shadow-s`, `shadow-m`
+ *
+ * ADDITIVE: every key is namespaced (`space-*`, `radius-*`, the typography role
+ * names, `shadow-s/m`) and does not collide with Tailwind's built-in numeric
+ * scale (`p-4`, `rounded-lg`, `text-sm`) — those keep working unchanged.
+ */
+/**
+ * Spacing scale (px). Consumed via every Tailwind spacing utility:
+ * `p-space-8`, `px-space-16`, `gap-space-20`, `m-space-24`, `py-space-12`, …
+ *
+ * `screen-margin` is the standard page gutter (left/right inset). Default 20px —
+ * matches Bloom's existing `space.xl` and the `Dialog` default `contentPadding`.
+ */
+export declare const SPACING: {
+    readonly 'space-2': 2;
+    readonly 'space-4': 4;
+    readonly 'space-8': 8;
+    readonly 'space-12': 12;
+    readonly 'space-16': 16;
+    readonly 'space-20': 20;
+    readonly 'space-24': 24;
+    readonly 'space-32': 32;
+    readonly 'screen-margin': 20;
+};
+/**
+ * Corner-radius scale (px). Consumed via `rounded-radius-*`:
+ * `rounded-radius-8`, `rounded-radius-12`, `rounded-radius-20`,
+ * `rounded-radius-28`, `rounded-radius-max` (pill / circle).
+ */
+export declare const RADIUS: {
+    readonly 'radius-8': 8;
+    readonly 'radius-12': 12;
+    readonly 'radius-20': 20;
+    readonly 'radius-28': 28;
+    readonly 'radius-max': 9999;
+};
+/**
+ * Border-width helpers. `border-hairline` is the 0.5px hairline that pairs with
+ * the `border-border-image` color role. (Tailwind's default `border` = 1px
+ * stays untouched.)
+ */
+export declare const BORDER_WIDTH: {
+    readonly hairline: 0.5;
+};
+/**
+ * One typography role. `size`/`lineHeight` are px; `weight` is a CSS font-weight
+ * string; `family` selects the Bloom font CSS var (`sans` = body/UI,
+ * `display` = headings/serif).
+ *
+ * The Tailwind preset splits each role into TWO utilities so a consumer can
+ * apply the size/leading and the family/weight independently or together:
+ *   - `text-<role>`  → `fontSize` + `lineHeight`   (via theme.fontSize)
+ *   - `font-<role>`  → `fontFamily` + `fontWeight` (via theme.fontFamily, which
+ *                       maps a key to a [family, { fontWeight }] tuple)
+ */
+export interface TypeRole {
+    /** Font size in px. */
+    size: number;
+    /** Line height in px. */
+    lineHeight: number;
+    /** CSS font-weight (string for Tailwind/RN parity). */
+    weight: '400' | '500' | '600' | '700';
+    /** Which Bloom font family CSS var to use. */
+    family: 'sans' | 'display';
+}
+/**
+ * The coherent Oxy type scale. Sizes climb 11 → 28; line-heights use a ~1.3–1.5
+ * leading for body roles and tighter leading for large titles.
+ *
+ * | role            | size/line | weight | family  | usage                          |
+ * | --------------- | --------- | ------ | ------- | ------------------------------ |
+ * | caption         | 11 / 14   | 400    | sans    | timestamps, meta, fine print   |
+ * | bodySmall       | 13 / 18   | 400    | sans    | secondary body, captions       |
+ * | bodyTitleSmall  | 13 / 18   | 600    | sans    | small emphasized labels        |
+ * | body            | 15 / 22   | 400    | sans    | default body text              |
+ * | subtitle        | 17 / 24   | 500    | sans    | list subtitles, lead-ins       |
+ * | sectionTitle    | 20 / 26   | 600    | sans    | section headers                |
+ * | headerBold      | 28 / 34   | 700    | display | screen / page titles           |
+ * | buttonLarge     | 17 / 22   | 600    | sans    | primary button label           |
+ */
+export declare const TYPOGRAPHY: {
+    readonly caption: {
+        readonly size: 11;
+        readonly lineHeight: 14;
+        readonly weight: "400";
+        readonly family: "sans";
+    };
+    readonly bodySmall: {
+        readonly size: 13;
+        readonly lineHeight: 18;
+        readonly weight: "400";
+        readonly family: "sans";
+    };
+    readonly bodyTitleSmall: {
+        readonly size: 13;
+        readonly lineHeight: 18;
+        readonly weight: "600";
+        readonly family: "sans";
+    };
+    readonly body: {
+        readonly size: 15;
+        readonly lineHeight: 22;
+        readonly weight: "400";
+        readonly family: "sans";
+    };
+    readonly subtitle: {
+        readonly size: 17;
+        readonly lineHeight: 24;
+        readonly weight: "500";
+        readonly family: "sans";
+    };
+    readonly sectionTitle: {
+        readonly size: 20;
+        readonly lineHeight: 26;
+        readonly weight: "600";
+        readonly family: "sans";
+    };
+    readonly headerBold: {
+        readonly size: 28;
+        readonly lineHeight: 34;
+        readonly weight: "700";
+        readonly family: "display";
+    };
+    readonly buttonLarge: {
+        readonly size: 17;
+        readonly lineHeight: 22;
+        readonly weight: "600";
+        readonly family: "sans";
+    };
+};
+export type TypeRoleName = keyof typeof TYPOGRAPHY;
+/**
+ * Bloom font-family CSS-var stacks, keyed by the `family` field above. Web reads
+ * `var(--bloom-font-*)` (set by `applyFontFaces`); the preset falls back to the
+ * literal stack so utilities still resolve before the vars are injected and on
+ * native (where NativeWind passes the family string straight through).
+ */
+export declare const FONT_FAMILY_VARS: {
+    readonly sans: "var(--bloom-font-sans)";
+    readonly display: "var(--bloom-font-display)";
+    readonly mono: "var(--bloom-font-mono)";
+};
+//# sourceMappingURL=scales.d.ts.map

package/lib/typescript/commonjs/design-tokens/scales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scales.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/scales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;CAUV,CAAC;AAMX;;;;GAIG;AACH,eAAO,MAAM,MAAM;;;;;;CAMT,CAAC;AAMX;;;;GAIG;AACH,eAAO,MAAM,YAAY;;CAEf,CAAC;AAMX;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAQ;IACvB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IACtC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASsB,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,UAAU,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC"}

package/lib/typescript/commonjs/design-tokens/shadows.d.ts

@@ -0,0 +1,34 @@
+import { type ViewStyle } from 'react-native';
+/**
+ * Elevation / shadow tokens for the Oxy Unified Design Language.
+ *
+ * Two roles: `shadow-s` (subtle raise — cards, chips) and `shadow-m` (overlays —
+ * menus, popovers, dialogs). Consumers write ONE class (`shadow-s` / `shadow-m`)
+ * and Bloom owns the platform split:
+ *   - Web: the Bloom Tailwind preset registers `boxShadow.s` / `boxShadow.m`
+ *     (the `SHADOW_BOX` strings below) → `shadow-s` / `shadow-m` utilities.
+ *   - Native: NativeWind cannot translate a multi-layer web `box-shadow` to RN
+ *     elevation reliably, so apps that need the shadow on a React Native surface
+ *     apply the matching style object from `bloomShadowStyle('s' | 'm')` (this
+ *     module is platform-forked: `.native.ts` returns RN `shadow*`/`elevation`).
+ *
+ * This default file is the WEB / consumer-tsc variant. Metro selects the sibling
+ * `shadows.native.ts` on iOS/Android. Web bundlers and a consumer's `tsc` see
+ * this file (the `box-shadow` CSS string path), matching Bloom's existing
+ * `.native`/`.web` split convention.
+ */
+export type ShadowRole = 's' | 'm';
+/**
+ * Web `box-shadow` strings. Subtle, brand-neutral elevation that reads on both
+ * light and dark surfaces. Registered by the Tailwind preset as `boxShadow.s/m`.
+ */
+export declare const SHADOW_BOX: Record<ShadowRole, string>;
+/**
+ * Return the platform-appropriate shadow style for a role.
+ *
+ * On WEB this returns a `{ boxShadow }` style object (so it can also be applied
+ * inline without Tailwind). The `.native.ts` fork returns RN
+ * `shadowColor/shadowOffset/shadowOpacity/shadowRadius/elevation`.
+ */
+export declare function bloomShadowStyle(role: ShadowRole): ViewStyle;
+//# sourceMappingURL=shadows.d.ts.map

package/lib/typescript/commonjs/design-tokens/shadows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/shadows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAGjD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAE5D"}

package/lib/typescript/commonjs/design-tokens/shadows.native.d.ts

@@ -0,0 +1,19 @@
+import { type ViewStyle } from 'react-native';
+/**
+ * NATIVE variant of the shadow tokens (see `shadows.ts` for the rationale and
+ * the web `box-shadow` path). Metro selects this file on iOS/Android.
+ *
+ * The `SHADOW_BOX` map is kept identical to the web file so any code that reads
+ * the raw string (e.g. to feed a NativeWind `boxShadow` utility on a host that
+ * supports it) stays in lockstep; the canonical native styling path is
+ * `bloomShadowStyle`, which returns RN elevation + shadow props tuned to match
+ * the web `shadow-s` / `shadow-m` visual weight.
+ */
+export type ShadowRole = 's' | 'm';
+export declare const SHADOW_BOX: Record<ShadowRole, string>;
+/**
+ * RN shadow/elevation style matching the web `shadow-<role>` weight. Apply to a
+ * React Native `View`/surface: `style={bloomShadowStyle('m')}`.
+ */
+export declare function bloomShadowStyle(role: ShadowRole): ViewStyle;
+//# sourceMappingURL=shadows.native.d.ts.map

package/lib/typescript/commonjs/design-tokens/shadows.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.native.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/shadows.native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;GASG;AAEH,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC;AAEnC,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAGjD,CAAC;AAmBF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAE5D"}

package/lib/typescript/commonjs/design-tokens/tailwind-preset.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The Bloom Tailwind / NativeWind preset — the SINGLE opt-in that gives every
+ * Oxy app the same semantic design-token utility classes.
+ *
+ * Consumers add it to their Tailwind config:
+ *
+ *   // tailwind.config.js  (web Tailwind v3/v4 AND native NativeWind)
+ *   const { bloomTailwindPreset } = require('@oxyhq/bloom/tailwind-preset');
+ *   module.exports = {
+ *     presets: [bloomTailwindPreset],
+ *     content: [ ...existing globs ],
+ *     theme: { extend: { ...existing app overrides } },
+ *   };
+ *
+ * The preset only EXTENDS `theme` (everything lives under `theme.extend`), so it
+ * is purely additive: existing Tailwind built-ins (`p-4`, `rounded-lg`,
+ * `text-sm`) and the app's own `var(--x)`-backed color utilities keep working.
+ *
+ * Cross-platform: NativeWind reads the same `tailwind.config.js`, so the SAME
+ * class names (`bg-fill`, `text-text-tertiary`, `p-space-8`, `rounded-radius-20`,
+ * `text-body`, `font-body`, `shadow-s`) resolve on web (Tailwind → CSS) and
+ * native (NativeWind → react-native-css). Color roles are `var(--x)` references
+ * that Bloom's `BloomThemeProvider` populates at runtime on both platforms.
+ *
+ * Type: returned as a `TailwindPreset` (a structural subset of Tailwind's
+ * `Config`) so Bloom does not need to depend on `tailwindcss` types.
+ */
+/** A Tailwind `fontSize` value: `[size, { lineHeight }]`. */
+type FontSizeValue = [string, {
+    lineHeight: string;
+}];
+/** A Tailwind `fontFamily` value: `[family, { fontWeight }]`. */
+type FontFamilyValue = [string, {
+    fontWeight: string;
+}];
+export interface TailwindPresetThemeExtend {
+    colors: Record<string, string>;
+    backgroundColor: Record<string, string>;
+    textColor: Record<string, string>;
+    borderColor: Record<string, string>;
+    spacing: Record<string, string>;
+    borderRadius: Record<string, string>;
+    borderWidth: Record<string, string>;
+    fontSize: Record<string, FontSizeValue>;
+    fontFamily: Record<string, FontFamilyValue>;
+    boxShadow: Record<string, string>;
+}
+export interface TailwindPreset {
+    theme: {
+        extend: TailwindPresetThemeExtend;
+    };
+}
+/**
+ * The Bloom Tailwind/NativeWind preset. Frozen so accidental mutation by a
+ * consumer's config merge cannot corrupt the shared vocabulary.
+ */
+export declare const bloomTailwindPreset: TailwindPreset;
+export {};
+//# sourceMappingURL=tailwind-preset.d.ts.map

package/lib/typescript/commonjs/design-tokens/tailwind-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-preset.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/tailwind-preset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAaH,6DAA6D;AAC7D,KAAK,aAAa,GAAG,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACtD,iEAAiE;AACjE,KAAK,eAAe,GAAG,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAExD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE;QAAE,MAAM,EAAE,yBAAyB,CAAA;KAAE,CAAC;CAC9C;AAuDD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAoBhC,CAAC"}

package/lib/typescript/commonjs/design-tokens/theme-css.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Tailwind v4 `@theme` block generator for the Oxy Unified Design Language.
+ *
+ * Tailwind v4 web apps (auth, console, website) configure their design tokens in
+ * CSS via `@theme { --color-X: var(--X); … }` rather than a JS preset. This
+ * module produces the exact `@theme` body that mirrors `bloomTailwindPreset`, so
+ * a v4 app gets the SAME semantic utilities (`bg-fill`, `text-text-tertiary`,
+ * `p-space-8`, `rounded-radius-20`, `text-body`, `font-body`, `shadow-s`) as the
+ * NativeWind/Tailwind-v3 apps that consume the JS preset.
+ *
+ * Each color role is emitted as a `--color-<role>: var(--canonical)` alias.
+ * Per Bloom's web CSS-var contract, the canonical `--x` token already resolves
+ * to a full `rgb(...)` color at runtime, so the alias is a direct `var(--x)`
+ * reference — NEVER `hsl(var(--x))`.
+ *
+ * Usage (web Tailwind v4, in the app's global stylesheet):
+ *
+ *   import { bloomThemeCss } from '@oxyhq/bloom/design-tokens';
+ *   // build-time: write `@theme { ${bloomThemeCss()} }` into global.css, OR
+ *   // paste the generated block once (see docs/design-tokens.md).
+ *
+ * A consumer that prefers a static stylesheet can copy the output of
+ * `bloomThemeCss()` directly into their `@theme { … }` — the values are stable.
+ */
+/**
+ * Produce the BODY of a Tailwind v4 `@theme` block (no surrounding braces) that
+ * registers the full Bloom semantic vocabulary.
+ *
+ * - Colors → `--color-<role>: var(--canonical);`
+ * - Spacing → `--spacing-<key>: <px>;`
+ * - Radius  → `--radius-<key>: <px>;`
+ * - Type    → `--text-<role>: <size>; --text-<role>--line-height: <lh>;`
+ *             `--font-<role>: var(--bloom-font-*);` (+ weight via utility doc)
+ * - Shadow  → `--shadow-<s|m>: <box-shadow>;`
+ */
+export declare function bloomThemeCss(): string;
+/** The full `@theme { … }` block, ready to inject into a v4 stylesheet. */
+export declare function bloomThemeBlock(): string;
+//# sourceMappingURL=theme-css.d.ts.map

package/lib/typescript/commonjs/design-tokens/theme-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-css.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/theme-css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAaH;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,MAAM,CA8CtC;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/lib/typescript/commonjs/dialog/BloomDialogProvider.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+/**
+ * Mounts the imperative `alert()` host inside your app.
+ *
+ * Wrap your app root once (after `BloomThemeProvider`, so the dialog's
+ * colours come from the active theme) and you can call `alert()` from
+ * anywhere — including from code that runs before the provider mounts
+ * (alerts are queued and drained on subscribe).
+ *
+ * ```tsx
+ * import { BloomDialogProvider } from '@oxyhq/bloom';
+ *
+ * <BloomThemeProvider mode="system" colorPreset="oxy">
+ *   <BloomDialogProvider>
+ *     <App />
+ *   </BloomDialogProvider>
+ * </BloomThemeProvider>
+ * ```
+ *
+ * Alerts are presented one at a time. While one is on screen, subsequent
+ * `alert()` calls enqueue and present in FIFO order once their predecessor
+ * has finished closing.
+ */
+export declare function BloomDialogProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BloomDialogProvider.d.ts.map

package/lib/typescript/commonjs/dialog/BloomDialogProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BloomDialogProvider.d.ts","sourceRoot":"","sources":["../../../../src/dialog/BloomDialogProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAUnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAgB9E"}

package/lib/typescript/commonjs/dialog/BloomDialogProvider.web.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+/**
+ * Web variant of `BloomDialogProvider`. Identical surface area to the
+ * native version — it just uses the web-fork `Dialog` (`Dialog.web.tsx`)
+ * underneath instead of the bottom-sheet variant.
+ *
+ * See the native file (`./BloomDialogProvider.tsx`) for the full design
+ * notes; this fork exists purely so the bundler's `browser` condition can
+ * resolve to a `Dialog` that doesn't pull in the native gesture-handler /
+ * reanimated stack.
+ */
+export declare function BloomDialogProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BloomDialogProvider.web.d.ts.map

package/lib/typescript/commonjs/dialog/BloomDialogProvider.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BloomDialogProvider.web.d.ts","sourceRoot":"","sources":["../../../../src/dialog/BloomDialogProvider.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAUnD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAa9E"}

package/lib/typescript/commonjs/dialog/Dialog.d.ts

@@ -0,0 +1,40 @@
+import { DIALOG_SHEET_BACKDROP_TESTID } from './placement';
+import type { DialogAction, DialogProps } from './types';
+export { DIALOG_SHEET_BACKDROP_TESTID };
+/**
+ * Native variant of `<Dialog>`.
+ *
+ * Open/close is driven by EITHER the imperative `control` (legacy) OR the
+ * controlled `open` prop. When `open` is provided it wins.
+ *
+ * `placement` selects the surface:
+ *
+ *   - `'center'` (default) / `'bottom'` — bloom's `BottomSheet` (`detached`
+ *     for center: a floating, content-hugging card that degrades from sheet to
+ *     centered card via the 500px cap; flush for bottom: a full-width sheet
+ *     with a drag handle). Default behavior is unchanged.
+ *   - `'left'` / `'right'` — an anchored side-sheet/drawer driven by
+ *     reanimated. Exit animations are safe on native.
+ *
+ * The component accepts three rendering modes simultaneously:
+ *
+ *   1. Declarative — `title`, `description`, `actions`.
+ *   2. Custom children — caller passes JSX, bloom renders the chrome.
+ *   3. Pure children — no `title`/`description`/`actions`.
+ */
+export declare function Dialog({ placement, ...rest }: DialogProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Helper used by the imperative `alert()` API. Mounts a `<Dialog>` against
+ * a fresh control and presents it immediately. `onResolve` is invoked
+ * exactly once when the dialog finishes closing (regardless of how the
+ * dismissal happened).
+ *
+ * Kept private to the dialog module — `alert()` is the public surface.
+ */
+export declare function AutoMountedDialog({ title, description, actions, onResolve, }: {
+    title?: string;
+    description?: string;
+    actions: DialogAction[];
+    onResolve: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Dialog.d.ts.map

package/lib/typescript/commonjs/dialog/Dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dialog.d.ts","sourceRoot":"","sources":["../../../../src/dialog/Dialog.tsx"],"names":[],"mappings":"AAgCA,OAAO,EAIL,4BAA4B,EAK7B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,YAAY,EAGZ,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,4BAA4B,EAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CAAC,EACrB,SAAS,EACT,GAAG,IAAI,EACR,EAAE,WAAW,2CAab;AAqZD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,WAAW,EACX,OAAO,EACP,SAAS,GACV,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB,2CAoBA"}

package/lib/typescript/commonjs/dialog/Dialog.web.d.ts

@@ -0,0 +1,55 @@
+import { DIALOG_SHEET_BACKDROP_TESTID } from './placement';
+import type { DialogAction, DialogProps } from './types';
+/**
+ * Web variant of `<Dialog>`.
+ *
+ * A centered modal card (default) rendered into the bloom Portal at the end of
+ * `document.body`, an anchored side-sheet for `left`/`right`, or — for
+ * `bottom` — bloom's cross-platform `BottomSheet` (the SAME component native
+ * uses), so the bottom placement drags-to-dismiss on web too. Same prop API as
+ * native, so call sites are platform agnostic.
+ *
+ * Open/close is driven by EITHER the imperative `control` (legacy) OR the
+ * controlled `open` prop. When `open` is provided it wins.
+ *
+ * Accessibility: the panel has `role="dialog"` and the `title`/`description`
+ * props (when provided) become the `aria-labelledby` / `aria-describedby`
+ * targets. Pressing the backdrop dismisses. Pressing `Escape` dismisses.
+ * Focus is locked inside the dialog while it's open.
+ *
+ * Web motion never uses reanimated `exiting` (which throws `removeChild` on
+ * concurrent React unmounts): the centered card uses CSS keyframes and the
+ * side modes use self-contained CSS transitions on a mounted-through-exit
+ * node. The bottom placement animates via `BottomSheet`'s shared-value/gesture
+ * animation (no `exiting` layout animation).
+ */
+export declare function Dialog({ placement, ...rest }: DialogProps): import("react/jsx-runtime").JSX.Element;
+export { DIALOG_SHEET_BACKDROP_TESTID };
+/**
+ * Inline imperative dialog used by `alert()`. Mounts and immediately
+ * presents; resolves the host's `onResolve` once the dialog has finished
+ * its exit animation.
+ */
+export declare function AutoMountedDialog({ title, description, actions, onResolve, }: {
+    title?: string;
+    description?: string;
+    actions: DialogAction[];
+    onResolve: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * CSS keyframes required for web dialog animations.
+ * Consumers should inject this string into a <style> tag or their global CSS:
+ *
+ * ```css
+ * @keyframes bloomDialogFadeIn { from { opacity: 0; } to { opacity: 1; } }
+ * @keyframes bloomDialogFadeOut { from { opacity: 1; } to { opacity: 0; } }
+ * @keyframes bloomDialogZoomFadeIn { from { opacity: 0; transform: scale(0.95); } to { opacity: 1; transform: scale(1); } }
+ * @keyframes bloomDialogZoomFadeOut { from { opacity: 1; transform: scale(1); } to { opacity: 0; transform: scale(0.95); } }
+ * ```
+ *
+ * The `left`/`right` placements do NOT depend on this — they animate via
+ * self-contained inline CSS transitions and need no keyframe injection. The
+ * `bottom` placement uses bloom's `BottomSheet` (reanimated) and needs none.
+ */
+export declare const BLOOM_DIALOG_CSS = "\n@keyframes bloomDialogFadeIn { from { opacity: 0; } to { opacity: 1; } }\n@keyframes bloomDialogFadeOut { from { opacity: 1; } to { opacity: 0; } }\n@keyframes bloomDialogZoomFadeIn { from { opacity: 0; transform: scale(0.95); } to { opacity: 1; transform: scale(1); } }\n@keyframes bloomDialogZoomFadeOut { from { opacity: 1; transform: scale(1); } to { opacity: 0; transform: scale(0.95); } }\n";
+//# sourceMappingURL=Dialog.web.d.ts.map

package/lib/typescript/commonjs/dialog/Dialog.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dialog.web.d.ts","sourceRoot":"","sources":["../../../../src/dialog/Dialog.web.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAML,4BAA4B,EAM7B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,YAAY,EAGZ,WAAW,EACZ,MAAM,SAAS,CAAC;AASjB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,WAAW,2CAazD;AAoSD,OAAO,EAAE,4BAA4B,EAAE,CAAC;AAqNxC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,WAAW,EACX,OAAO,EACP,SAAS,GACV,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB,2CAgBA;AA6BD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,mZAK5B,CAAC"}