@oxyhq/bloom 0.19.1 → 0.21.0

package/lib/commonjs/design-tokens/tailwind-preset.js

@@ -0,0 +1,139 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.bloomTailwindPreset = void 0;
+var _colorRoles = require("./color-roles.js");
+var _scales = require("./scales.js");
+var _shadows = require("./shadows");
+/**
+ * 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 }]`. */
+
+/** A Tailwind `fontFamily` value: `[family, { fontWeight }]`. */
+
+const px = n => `${n}px`;
+
+/** `{ 'space-8': 8 }` → `{ 'space-8': '8px' }`. */
+function toPxMap(scale) {
+  const out = {};
+  for (const [key, value] of Object.entries(scale)) {
+    // 9999 (radius-max) and large values are still valid px; pill shapes clamp.
+    out[key] = px(value);
+  }
+  return out;
+}
+
+/** Build the `fontSize` extension: `text-<role>` → `[size, { lineHeight }]`. */
+function buildFontSize() {
+  const out = {};
+  for (const name of Object.keys(_scales.TYPOGRAPHY)) {
+    const role = _scales.TYPOGRAPHY[name];
+    out[name] = [px(role.size), {
+      lineHeight: px(role.lineHeight)
+    }];
+  }
+  return out;
+}
+
+/** Build the `fontFamily` extension: `font-<role>` → `[family, { fontWeight }]`. */
+function buildFontFamily() {
+  const out = {};
+  for (const name of Object.keys(_scales.TYPOGRAPHY)) {
+    const role = _scales.TYPOGRAPHY[name];
+    out[name] = [_scales.FONT_FAMILY_VARS[role.family], {
+      fontWeight: role.weight
+    }];
+  }
+  // Also expose the raw Bloom families directly: `font-bloom-sans`, etc.
+  out['bloom-sans'] = [_scales.FONT_FAMILY_VARS.sans, {
+    fontWeight: '400'
+  }];
+  out['bloom-display'] = [_scales.FONT_FAMILY_VARS.display, {
+    fontWeight: '700'
+  }];
+  out['bloom-mono'] = [_scales.FONT_FAMILY_VARS.mono, {
+    fontWeight: '400'
+  }];
+  return out;
+}
+const SPACING_PX = toPxMap(_scales.SPACING);
+const RADIUS_PX = toPxMap({
+  ..._scales.RADIUS
+});
+const BORDER_WIDTH_PX = toPxMap(_scales.BORDER_WIDTH);
+
+/**
+ * Color roles are exposed via `colors` (so they reach `bg-*`, `text-*`,
+ * `border-*`, `ring-*`, `divide-*`, `fill-*` …) AND via the dedicated
+ * `backgroundColor` / `textColor` / `borderColor` maps (so the namespaced roles
+ * land on exactly the intended utility families even where the role name would
+ * otherwise be ambiguous). All values are `var(--canonical)` references.
+ */
+const COLOR_ROLES = {
+  ..._colorRoles.FILL_ROLES,
+  ..._colorRoles.TEXT_ROLES,
+  ..._colorRoles.BORDER_ROLES
+};
+
+/**
+ * The Bloom Tailwind/NativeWind preset. Frozen so accidental mutation by a
+ * consumer's config merge cannot corrupt the shared vocabulary.
+ */
+const bloomTailwindPreset = exports.bloomTailwindPreset = Object.freeze({
+  theme: {
+    extend: {
+      // Generic color bucket — feeds every color utility family.
+      colors: {
+        ...COLOR_ROLES
+      },
+      // Targeted buckets so the namespaced roles resolve on the right utility.
+      backgroundColor: {
+        ..._colorRoles.FILL_ROLES
+      },
+      textColor: {
+        ..._colorRoles.TEXT_ROLES
+      },
+      borderColor: {
+        ..._colorRoles.BORDER_ROLES
+      },
+      spacing: SPACING_PX,
+      borderRadius: RADIUS_PX,
+      borderWidth: BORDER_WIDTH_PX,
+      fontSize: buildFontSize(),
+      fontFamily: buildFontFamily(),
+      boxShadow: {
+        s: _shadows.SHADOW_BOX.s,
+        m: _shadows.SHADOW_BOX.m
+      }
+    }
+  }
+});
+//# sourceMappingURL=tailwind-preset.js.map

package/lib/commonjs/design-tokens/tailwind-preset.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_colorRoles","require","_scales","_shadows","px","n","toPxMap","scale","out","key","value","Object","entries","buildFontSize","name","keys","TYPOGRAPHY","role","size","lineHeight","buildFontFamily","FONT_FAMILY_VARS","family","fontWeight","weight","sans","display","mono","SPACING_PX","SPACING","RADIUS_PX","RADIUS","BORDER_WIDTH_PX","BORDER_WIDTH","COLOR_ROLES","FILL_ROLES","TEXT_ROLES","BORDER_ROLES","bloomTailwindPreset","exports","freeze","theme","extend","colors","backgroundColor","textColor","borderColor","spacing","borderRadius","borderWidth","fontSize","fontFamily","boxShadow","s","SHADOW_BOX","m"],"sourceRoot":"../../../src","sources":["design-tokens/tailwind-preset.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/design-tokens/theme-css.js

@@ -0,0 +1,98 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.bloomThemeBlock = bloomThemeBlock;
+exports.bloomThemeCss = bloomThemeCss;
+var _colorRoles = require("./color-roles.js");
+var _scales = require("./scales.js");
+var _shadows = require("./shadows");
+/**
+ * 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>;`
+ */
+function bloomThemeCss() {
+  const lines = [];
+
+  // Color roles.
+  for (const [role, value] of Object.entries({
+    ..._colorRoles.FILL_ROLES,
+    ..._colorRoles.TEXT_ROLES,
+    ..._colorRoles.BORDER_ROLES
+  })) {
+    lines.push(`  --color-${role}: ${value};`);
+  }
+
+  // Spacing.
+  for (const [key, value] of Object.entries(_scales.SPACING)) {
+    lines.push(`  --spacing-${key}: ${value}px;`);
+  }
+
+  // Radius.
+  for (const [key, value] of Object.entries(_scales.RADIUS)) {
+    lines.push(`  --radius-${key}: ${value}px;`);
+  }
+
+  // Hairline border width.
+  for (const [key, value] of Object.entries(_scales.BORDER_WIDTH)) {
+    lines.push(`  --border-width-${key}: ${value}px;`);
+  }
+
+  // Typography: size + line-height + family per role.
+  for (const name of Object.keys(_scales.TYPOGRAPHY)) {
+    const role = _scales.TYPOGRAPHY[name];
+    lines.push(`  --text-${name}: ${role.size}px;`);
+    lines.push(`  --text-${name}--line-height: ${role.lineHeight}px;`);
+    lines.push(`  --text-${name}--font-weight: ${role.weight};`);
+    lines.push(`  --font-${name}: ${_scales.FONT_FAMILY_VARS[role.family]};`);
+  }
+
+  // Bloom raw families.
+  lines.push(`  --font-bloom-sans: ${_scales.FONT_FAMILY_VARS.sans};`);
+  lines.push(`  --font-bloom-display: ${_scales.FONT_FAMILY_VARS.display};`);
+  lines.push(`  --font-bloom-mono: ${_scales.FONT_FAMILY_VARS.mono};`);
+
+  // Shadows.
+  lines.push(`  --shadow-s: ${_shadows.SHADOW_BOX.s};`);
+  lines.push(`  --shadow-m: ${_shadows.SHADOW_BOX.m};`);
+  return lines.join('\n');
+}
+
+/** The full `@theme { … }` block, ready to inject into a v4 stylesheet. */
+function bloomThemeBlock() {
+  return `@theme {\n${bloomThemeCss()}\n}`;
+}
+//# sourceMappingURL=theme-css.js.map

package/lib/commonjs/design-tokens/theme-css.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_colorRoles","require","_scales","_shadows","bloomThemeCss","lines","role","value","Object","entries","FILL_ROLES","TEXT_ROLES","BORDER_ROLES","push","key","SPACING","RADIUS","BORDER_WIDTH","name","keys","TYPOGRAPHY","size","lineHeight","weight","FONT_FAMILY_VARS","family","sans","display","mono","SHADOW_BOX","s","m","join","bloomThemeBlock"],"sourceRoot":"../../../src","sources":["design-tokens/theme-css.ts"],"mappings":";;;;;;;AAyBA,IAAAA,WAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAQA,IAAAE,QAAA,GAAAF,OAAA;AAlCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,aAAaA,CAAA,EAAW;EACtC,MAAMC,KAAe,GAAG,EAAE;;EAE1B;EACA,KAAK,MAAM,CAACC,IAAI,EAAEC,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAAC;IACzC,GAAGC,sBAAU;IACb,GAAGC,sBAAU;IACb,GAAGC;EACL,CAAC,CAAC,EAAE;IACFP,KAAK,CAACQ,IAAI,CAAC,aAAaP,IAAI,KAAKC,KAAK,GAAG,CAAC;EAC5C;;EAEA;EACA,KAAK,MAAM,CAACO,GAAG,EAAEP,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACM,eAAO,CAAC,EAAE;IAClDV,KAAK,CAACQ,IAAI,CAAC,eAAeC,GAAG,KAAKP,KAAK,KAAK,CAAC;EAC/C;;EAEA;EACA,KAAK,MAAM,CAACO,GAAG,EAAEP,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACO,cAAM,CAAC,EAAE;IACjDX,KAAK,CAACQ,IAAI,CAAC,cAAcC,GAAG,KAAKP,KAAK,KAAK,CAAC;EAC9C;;EAEA;EACA,KAAK,MAAM,CAACO,GAAG,EAAEP,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACQ,oBAAY,CAAC,EAAE;IACvDZ,KAAK,CAACQ,IAAI,CAAC,oBAAoBC,GAAG,KAAKP,KAAK,KAAK,CAAC;EACpD;;EAEA;EACA,KAAK,MAAMW,IAAI,IAAIV,MAAM,CAACW,IAAI,CAACC,kBAAU,CAAC,EAAoB;IAC5D,MAAMd,IAAI,GAAGc,kBAAU,CAACF,IAAI,CAAC;IAC7Bb,KAAK,CAACQ,IAAI,CAAC,YAAYK,IAAI,KAAKZ,IAAI,CAACe,IAAI,KAAK,CAAC;IAC/ChB,KAAK,CAACQ,IAAI,CAAC,YAAYK,IAAI,kBAAkBZ,IAAI,CAACgB,UAAU,KAAK,CAAC;IAClEjB,KAAK,CAACQ,IAAI,CAAC,YAAYK,IAAI,kBAAkBZ,IAAI,CAACiB,MAAM,GAAG,CAAC;IAC5DlB,KAAK,CAACQ,IAAI,CAAC,YAAYK,IAAI,KAAKM,wBAAgB,CAAClB,IAAI,CAACmB,MAAM,CAAC,GAAG,CAAC;EACnE;;EAEA;EACApB,KAAK,CAACQ,IAAI,CAAC,wBAAwBW,wBAAgB,CAACE,IAAI,GAAG,CAAC;EAC5DrB,KAAK,CAACQ,IAAI,CAAC,2BAA2BW,wBAAgB,CAACG,OAAO,GAAG,CAAC;EAClEtB,KAAK,CAACQ,IAAI,CAAC,wBAAwBW,wBAAgB,CAACI,IAAI,GAAG,CAAC;;EAE5D;EACAvB,KAAK,CAACQ,IAAI,CAAC,iBAAiBgB,mBAAU,CAACC,CAAC,GAAG,CAAC;EAC5CzB,KAAK,CAACQ,IAAI,CAAC,iBAAiBgB,mBAAU,CAACE,CAAC,GAAG,CAAC;EAE5C,OAAO1B,KAAK,CAAC2B,IAAI,CAAC,IAAI,CAAC;AACzB;;AAEA;AACO,SAASC,eAAeA,CAAA,EAAW;EACxC,OAAO,aAAa7B,aAAa,CAAC,CAAC,KAAK;AAC1C","ignoreList":[]}