@kbach/react 1.0.0-beta.19 → 1.0.0-beta.20

package/dist/index.d.mts

@@ -120,6 +120,22 @@ type ColorsAPI = {
      * `rgb(var(--kb-color-x))` mode-aware references.
      */
     readonly alpha: (color: string, opacity?: number) => string;
+    /**
+     * Same lookup dot/bracket access does (`colors.get('brand')` ===
+     * `colors.brand`), typed as plain `string` instead of `string |
+     * ColorScale` — use this whenever the result goes somewhere that expects
+     * a real `string` and hits a type error otherwise. The wider union on
+     * every OTHER property here isn't a bug: a flat custom color (`surface`)
+     * and a shade-family prefix (`blue`) are served by the exact same
+     * object, and TypeScript has no way to statically know which one any
+     * given key names — `kbach.config.js`'s colors are plain runtime JS, not
+     * a type declaration this package could inspect ahead of time. A name
+     * with no matching theme entry falls back to the name itself,
+     * unresolved — the same "not a known color name -> literal value"
+     * convention `kbach.config.js`'s own color aliasing already uses (see
+     * `config.ts`'s `resolveColorEntry`), never an error.
+     */
+    readonly get: (name: string) => string;
 };
 /**
  * Resolved theme colors as real values — for anywhere you need an actual
@@ -141,6 +157,7 @@ type ColorsAPI = {
  * colors.blue['6/50'];    // same, at 50% opacity
  * colors.surface;         // "rgb(var(--kb-color-surface))" if defined as { light, dark }
  * colors.alpha(colors.surface, 50); // "rgba(var(--kb-color-surface), 0.5)"
+ * colors.get('surface');  // same value as colors.surface, typed as plain `string`
  * ```
  */
 declare function useColors(): ColorsAPI;

package/dist/index.d.ts

@@ -120,6 +120,22 @@ type ColorsAPI = {
      * `rgb(var(--kb-color-x))` mode-aware references.
      */
     readonly alpha: (color: string, opacity?: number) => string;
+    /**
+     * Same lookup dot/bracket access does (`colors.get('brand')` ===
+     * `colors.brand`), typed as plain `string` instead of `string |
+     * ColorScale` — use this whenever the result goes somewhere that expects
+     * a real `string` and hits a type error otherwise. The wider union on
+     * every OTHER property here isn't a bug: a flat custom color (`surface`)
+     * and a shade-family prefix (`blue`) are served by the exact same
+     * object, and TypeScript has no way to statically know which one any
+     * given key names — `kbach.config.js`'s colors are plain runtime JS, not
+     * a type declaration this package could inspect ahead of time. A name
+     * with no matching theme entry falls back to the name itself,
+     * unresolved — the same "not a known color name -> literal value"
+     * convention `kbach.config.js`'s own color aliasing already uses (see
+     * `config.ts`'s `resolveColorEntry`), never an error.
+     */
+    readonly get: (name: string) => string;
 };
 /**
  * Resolved theme colors as real values — for anywhere you need an actual
@@ -141,6 +157,7 @@ type ColorsAPI = {
  * colors.blue['6/50'];    // same, at 50% opacity
  * colors.surface;         // "rgb(var(--kb-color-surface))" if defined as { light, dark }
  * colors.alpha(colors.surface, 50); // "rgba(var(--kb-color-surface), 0.5)"
+ * colors.get('surface');  // same value as colors.surface, typed as plain `string`
  * ```
  */
 declare function useColors(): ColorsAPI;

package/dist/index.js

@@ -929,11 +929,13 @@ function makeColorsProxy(theme, isDark2) {
       }
     });
   }
-  return new Proxy({ alpha }, {
+  const get = (name) => resolveNamed(name) ?? name;
+  return new Proxy({ alpha, get }, {
     get(_, prop) {
       const key = String(prop);
       if (key === "then") return void 0;
       if (key === "alpha") return alpha;
+      if (key === "get") return get;
       const direct = resolveNamed(key);
       if (direct !== void 0) return direct;
       if (!cache.has(key)) cache.set(key, makeFamilyProxy(key));

package/dist/index.mjs

@@ -118,11 +118,13 @@ function makeColorsProxy(theme, isDark) {
       }
     });
   }
-  return new Proxy({ alpha }, {
+  const get = (name) => resolveNamed(name) ?? name;
+  return new Proxy({ alpha, get }, {
     get(_, prop) {
       const key = String(prop);
       if (key === "then") return void 0;
       if (key === "alpha") return alpha;
+      if (key === "get") return get;
       const direct = resolveNamed(key);
       if (direct !== void 0) return direct;
       if (!cache.has(key)) cache.set(key, makeFamilyProxy(key));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kbach/react",
-  "version": "1.0.0-beta.19",
+  "version": "1.0.0-beta.20",
   "description": "A utility-first styling engine for React, powered by a real Rust/WASM core — Tailwind CSS v4 feature parity with Kbach's own color palette.",
   "keywords": [
     "css",