@kbach/react 0.5.6 → 0.5.8

package/README.md

@@ -329,7 +329,7 @@ Available families: slate, gray, zinc, neutral, stone, red, orange, amber, yello
 | Category | Examples |
 |---|---|
 | Background | `bg-white`, `bg-gray-10`, `bg-blue-6`, `bg-[#fff]` |
-| Text | `text-sm`, `text-2xl`, `text-gray-10`, `font-bold` |
+| Text | `text-sm`, `text-2xl`, `text-gray-10`, `font-bold`, `font-sans` |
 | Text wrap | `text-balance`, `text-pretty`, `text-nowrap`, `text-wrap` |
 | Line clamp | `line-clamp-3`, `line-clamp-none` |
 | Padding | `p-4`, `px-6`, `py-3` |
@@ -389,3 +389,44 @@ import { updateConfig } from '@kbach/react';
 
 updateConfig({ extend: { theme: { colors: { brand: { 6: '#6366f1' } } } } });
 ```
+
+### Font Family
+
+Define custom font families and use them with `font-<name>`:
+
+```js
+// kbach.config.js
+module.exports = {
+  extend: {
+    fontFamily: {
+      // shorthand: extend.fontFamily is equivalent to extend.theme.fontFamily
+      sans:        'CormorantGaramond_400Regular',
+      'sans-md':   'CormorantGaramond_500Medium',
+      'sans-semi': 'CormorantGaramond_600SemiBold',
+      'sans-bold': 'CormorantGaramond_700Bold',
+    },
+  },
+};
+```
+
+Use them as utilities:
+
+```jsx
+<Text className="font-sans">Regular</Text>
+<Text className="font-sans-md">Medium</Text>
+<Text className="font-sans-bold">Bold</Text>
+```
+
+**Global default font (web only):** When you set `fontFamily.sans` to anything other than `'System'`, Kbach automatically injects `body { font-family: <your-font> }` into the page — all text inherits it without needing `font-sans` on every element.
+
+**React Native:** CSS inheritance does not exist in RN. Apply `font-sans` (or your base font utility) to each `Text` component, or use `styled()` to create a pre-styled text component:
+
+```jsx
+// Define once
+const Body = styled(Text, 'font-sans');
+const Heading = styled(Text, 'font-sans-bold text-2xl');
+
+// Use everywhere
+<Body>Regular text</Body>
+<Heading>Title</Heading>
+```

package/dist/{chunk-BQJS4P2Z.mjs → chunk-3VPBKWUE.mjs}

@@ -8,7 +8,7 @@ import {
   resolve,
   useConditionalWidth,
   useGlobalDarkMode
-} from "./chunk-MNDU7U43.mjs";
+} from "./chunk-4R2AILNR.mjs";
 
 // src/jsx-runtime.tsx
 import { jsx as _jsx, jsxs as _jsxs, Fragment } from "react/jsx-runtime";

package/dist/{chunk-MNDU7U43.mjs → chunk-4R2AILNR.mjs}

@@ -2988,6 +2988,10 @@ function getActiveBreakpoints(width) {
 
 // src/core/resolver.ts
 var styleCache = new LRUCache(1e4);
+var _defaultFontFamily;
+function setDefaultFontFamily(font) {
+  _defaultFontFamily = font;
+}
 var _styleEl = null;
 var _injectedRules = /* @__PURE__ */ new Set();
 function getStyleEl() {
@@ -3005,6 +3009,24 @@ function injectRule(rule) {
   } catch {
   }
 }
+var _globalStyleEl = null;
+function getGlobalStyleEl() {
+  if (_globalStyleEl) return _globalStyleEl;
+  _globalStyleEl = document.createElement("style");
+  _globalStyleEl.setAttribute("data-kbach-global", "");
+  document.head.insertBefore(_globalStyleEl, getStyleEl());
+  return _globalStyleEl;
+}
+function injectGlobalStyles(theme) {
+  if (typeof document === "undefined") return;
+  const rules = [];
+  const ff = theme.fontFamily;
+  if (ff.sans && ff.sans !== "System") {
+    const family = Array.isArray(ff.sans) ? ff.sans.join(", ") : ff.sans;
+    rules.push(`body { font-family: ${family}; }`);
+  }
+  getGlobalStyleEl().textContent = rules.join("\n");
+}
 var MODIFIER_TO_PSEUDO = {
   hover: ":hover",
   focus: ":focus",
@@ -3238,6 +3260,7 @@ function resolve(classString, theme, darkMode = "attribute") {
 }
 function flatten(resolved, isDark, state = {}, breakpoints = /* @__PURE__ */ new Set()) {
   const result = {};
+  if (_defaultFontFamily) result.fontFamily = _defaultFontFamily;
   const entries = Object.entries(resolved);
   entries.sort((a, b) => {
     const pa = a[0] === "base" ? -1 : a[0].split(":").length;
@@ -3414,6 +3437,10 @@ function buildConfig(userConfig) {
   for (const plugin of resolved.plugins) {
     plugin(pluginAPI);
   }
+  const rawSans = theme.fontFamily.sans;
+  const sansFontValue = Array.isArray(rawSans) ? rawSans[0] : rawSans;
+  setDefaultFontFamily(sansFontValue && sansFontValue !== "System" ? sansFontValue : void 0);
+  injectGlobalStyles(resolved.theme);
   return resolved;
 }
 function makePluginAPI(theme) {

package/dist/index.js

@@ -3118,6 +3118,10 @@ function getActiveBreakpoints(width) {
 
 // src/core/resolver.ts
 var styleCache = new LRUCache(1e4);
+var _defaultFontFamily;
+function setDefaultFontFamily(font) {
+  _defaultFontFamily = font;
+}
 var _styleEl = null;
 var _injectedRules = /* @__PURE__ */ new Set();
 function getStyleEl() {
@@ -3135,6 +3139,24 @@ function injectRule(rule) {
   } catch {
   }
 }
+var _globalStyleEl = null;
+function getGlobalStyleEl() {
+  if (_globalStyleEl) return _globalStyleEl;
+  _globalStyleEl = document.createElement("style");
+  _globalStyleEl.setAttribute("data-kbach-global", "");
+  document.head.insertBefore(_globalStyleEl, getStyleEl());
+  return _globalStyleEl;
+}
+function injectGlobalStyles(theme) {
+  if (typeof document === "undefined") return;
+  const rules = [];
+  const ff = theme.fontFamily;
+  if (ff.sans && ff.sans !== "System") {
+    const family = Array.isArray(ff.sans) ? ff.sans.join(", ") : ff.sans;
+    rules.push(`body { font-family: ${family}; }`);
+  }
+  getGlobalStyleEl().textContent = rules.join("\n");
+}
 var MODIFIER_TO_PSEUDO = {
   hover: ":hover",
   focus: ":focus",
@@ -3368,6 +3390,7 @@ function resolve(classString, theme, darkMode = "attribute") {
 }
 function flatten(resolved, isDark, state = {}, breakpoints = /* @__PURE__ */ new Set()) {
   const result = {};
+  if (_defaultFontFamily) result.fontFamily = _defaultFontFamily;
   const entries = Object.entries(resolved);
   entries.sort((a, b) => {
     const pa = a[0] === "base" ? -1 : a[0].split(":").length;
@@ -3544,6 +3567,10 @@ function buildConfig(userConfig) {
   for (const plugin of resolved.plugins) {
     plugin(pluginAPI);
   }
+  const rawSans = theme.fontFamily.sans;
+  const sansFontValue = Array.isArray(rawSans) ? rawSans[0] : rawSans;
+  setDefaultFontFamily(sansFontValue && sansFontValue !== "System" ? sansFontValue : void 0);
+  injectGlobalStyles(resolved.theme);
   return resolved;
 }
 function makePluginAPI(theme) {

package/dist/index.mjs

@@ -23,7 +23,7 @@ import {
   useConditionalWidth,
   useGlobalDarkMode,
   useGlobalWidth
-} from "./chunk-MNDU7U43.mjs";
+} from "./chunk-4R2AILNR.mjs";
 
 // src/context.tsx
 import { createContext, useContext } from "react";

package/dist/jsx-dev-runtime.js

@@ -3009,6 +3009,10 @@ function getActiveBreakpoints(width) {
 
 // src/core/resolver.ts
 var styleCache = new LRUCache(1e4);
+var _defaultFontFamily;
+function setDefaultFontFamily(font) {
+  _defaultFontFamily = font;
+}
 var _styleEl = null;
 var _injectedRules = /* @__PURE__ */ new Set();
 function getStyleEl() {
@@ -3026,6 +3030,24 @@ function injectRule(rule) {
   } catch {
   }
 }
+var _globalStyleEl = null;
+function getGlobalStyleEl() {
+  if (_globalStyleEl) return _globalStyleEl;
+  _globalStyleEl = document.createElement("style");
+  _globalStyleEl.setAttribute("data-kbach-global", "");
+  document.head.insertBefore(_globalStyleEl, getStyleEl());
+  return _globalStyleEl;
+}
+function injectGlobalStyles(theme) {
+  if (typeof document === "undefined") return;
+  const rules = [];
+  const ff = theme.fontFamily;
+  if (ff.sans && ff.sans !== "System") {
+    const family = Array.isArray(ff.sans) ? ff.sans.join(", ") : ff.sans;
+    rules.push(`body { font-family: ${family}; }`);
+  }
+  getGlobalStyleEl().textContent = rules.join("\n");
+}
 var MODIFIER_TO_PSEUDO = {
   hover: ":hover",
   focus: ":focus",
@@ -3259,6 +3281,7 @@ function resolve(classString, theme, darkMode = "attribute") {
 }
 function flatten(resolved, isDark, state = {}, breakpoints = /* @__PURE__ */ new Set()) {
   const result = {};
+  if (_defaultFontFamily) result.fontFamily = _defaultFontFamily;
   const entries = Object.entries(resolved);
   entries.sort((a, b) => {
     const pa = a[0] === "base" ? -1 : a[0].split(":").length;
@@ -3427,6 +3450,10 @@ function buildConfig(userConfig) {
   for (const plugin of resolved.plugins) {
     plugin(pluginAPI);
   }
+  const rawSans = theme.fontFamily.sans;
+  const sansFontValue = Array.isArray(rawSans) ? rawSans[0] : rawSans;
+  setDefaultFontFamily(sansFontValue && sansFontValue !== "System" ? sansFontValue : void 0);
+  injectGlobalStyles(resolved.theme);
   return resolved;
 }
 function makePluginAPI(theme) {

package/dist/jsx-dev-runtime.mjs

@@ -2,8 +2,8 @@ import {
   Fragment,
   jsx,
   jsxs
-} from "./chunk-BQJS4P2Z.mjs";
-import "./chunk-MNDU7U43.mjs";
+} from "./chunk-3VPBKWUE.mjs";
+import "./chunk-4R2AILNR.mjs";
 
 // src/jsx-dev-runtime.tsx
 function jsxDEV(type, props, key, isStaticChildren, _source, _self) {

package/dist/jsx-runtime.js

@@ -3008,6 +3008,10 @@ function getActiveBreakpoints(width) {
 
 // src/core/resolver.ts
 var styleCache = new LRUCache(1e4);
+var _defaultFontFamily;
+function setDefaultFontFamily(font) {
+  _defaultFontFamily = font;
+}
 var _styleEl = null;
 var _injectedRules = /* @__PURE__ */ new Set();
 function getStyleEl() {
@@ -3025,6 +3029,24 @@ function injectRule(rule) {
   } catch {
   }
 }
+var _globalStyleEl = null;
+function getGlobalStyleEl() {
+  if (_globalStyleEl) return _globalStyleEl;
+  _globalStyleEl = document.createElement("style");
+  _globalStyleEl.setAttribute("data-kbach-global", "");
+  document.head.insertBefore(_globalStyleEl, getStyleEl());
+  return _globalStyleEl;
+}
+function injectGlobalStyles(theme) {
+  if (typeof document === "undefined") return;
+  const rules = [];
+  const ff = theme.fontFamily;
+  if (ff.sans && ff.sans !== "System") {
+    const family = Array.isArray(ff.sans) ? ff.sans.join(", ") : ff.sans;
+    rules.push(`body { font-family: ${family}; }`);
+  }
+  getGlobalStyleEl().textContent = rules.join("\n");
+}
 var MODIFIER_TO_PSEUDO = {
   hover: ":hover",
   focus: ":focus",
@@ -3258,6 +3280,7 @@ function resolve(classString, theme, darkMode = "attribute") {
 }
 function flatten(resolved, isDark, state = {}, breakpoints = /* @__PURE__ */ new Set()) {
   const result = {};
+  if (_defaultFontFamily) result.fontFamily = _defaultFontFamily;
   const entries = Object.entries(resolved);
   entries.sort((a, b) => {
     const pa = a[0] === "base" ? -1 : a[0].split(":").length;
@@ -3426,6 +3449,10 @@ function buildConfig(userConfig) {
   for (const plugin of resolved.plugins) {
     plugin(pluginAPI);
   }
+  const rawSans = theme.fontFamily.sans;
+  const sansFontValue = Array.isArray(rawSans) ? rawSans[0] : rawSans;
+  setDefaultFontFamily(sansFontValue && sansFontValue !== "System" ? sansFontValue : void 0);
+  injectGlobalStyles(resolved.theme);
   return resolved;
 }
 function makePluginAPI(theme) {

package/dist/jsx-runtime.mjs

@@ -2,8 +2,8 @@ import {
   Fragment,
   jsx,
   jsxs
-} from "./chunk-BQJS4P2Z.mjs";
-import "./chunk-MNDU7U43.mjs";
+} from "./chunk-3VPBKWUE.mjs";
+import "./chunk-4R2AILNR.mjs";
 export {
   Fragment,
   jsx,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kbach/react",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "React / React Native components and hooks for the Kbach framework",
   "source": "./src/index.ts",
   "main": "./dist/index.js",