@kbach/react 1.0.0-beta.8 → 1.0.0-beta.9

package/dist/{chunk-3E26VMLA.mjs → chunk-7JBSTM5D.mjs}

@@ -9,6 +9,7 @@ import {
 // src/vite-plugin/index.ts
 import { readFileSync as readFileSync3, writeFileSync, mkdirSync, existsSync, statSync as statSync2 } from "fs";
 import { join as join4, dirname } from "path";
+import { pathToFileURL } from "url";
 import { createRequire } from "module";
 
 // src/vite-plugin/cssVars.ts
@@ -1262,16 +1263,36 @@ function writeFileEnsuringDir(path, content) {
   mkdirSync(dirname(path), { recursive: true });
   writeFileSync(path, content, "utf-8");
 }
-function loadConfigFile(root) {
-  const path = join4(root, "kbach.config.js");
-  if (!existsSync(path)) return void 0;
+function isEsmRequireFailure(err) {
+  if (!(err instanceof Error)) return false;
+  return err.code === "ERR_REQUIRE_ESM" || /is not defined in ES module scope/.test(err.message);
+}
+async function importConfigModule(path) {
+  const mod = await import(pathToFileURL(path).href);
+  return mod.default ?? mod;
+}
+function requireConfigModule(root, path) {
   const mod = createRequire(root)(path);
   return mod.default ?? mod;
 }
-function resolveEffectiveTheme(root, options) {
+async function loadConfigFile(root) {
+  const cjsPath = join4(root, "kbach.config.cjs");
+  if (existsSync(cjsPath)) return requireConfigModule(root, cjsPath);
+  const mjsPath = join4(root, "kbach.config.mjs");
+  if (existsSync(mjsPath)) return importConfigModule(mjsPath);
+  const jsPath = join4(root, "kbach.config.js");
+  if (!existsSync(jsPath)) return void 0;
+  try {
+    return requireConfigModule(root, jsPath);
+  } catch (err) {
+    if (!isEsmRequireFailure(err)) throw err;
+    return importConfigModule(jsPath);
+  }
+}
+async function resolveEffectiveTheme(root, options) {
   if (options.theme) return options.theme;
   if (options.config) return resolveKbachConfig(options.config);
-  const discovered = loadConfigFile(root);
+  const discovered = await loadConfigFile(root);
   return discovered ? resolveKbachConfig(discovered) : defaultTheme;
 }
 function kbach(options = {}) {
@@ -1306,9 +1327,9 @@ function kbach(options = {}) {
   return {
     name: "kbach",
     enforce: "pre",
-    configResolved(resolved) {
+    async configResolved(resolved) {
       root = resolved.root;
-      theme = resolveEffectiveTheme(root, options);
+      theme = await resolveEffectiveTheme(root, options);
       engine = createKbachStaticCssEngine({ root, theme, themeJson: JSON.stringify(theme), includeDirs, safelist });
       mainCSSFilePath = findMainCSSFile(root, includeDirs, options.cssFile);
     },

package/dist/postcss-plugin.js

@@ -618,6 +618,7 @@ function createKbachStaticCssEngine(options) {
 // src/vite-plugin/index.ts
 var import_fs2 = require("fs");
 var import_path4 = require("path");
+var import_url = require("url");
 var import_module = require("module");
 
 // src/generatedPalette.ts
@@ -1038,16 +1039,36 @@ function resolveKbachConfig(config) {
 
 // src/vite-plugin/index.ts
 var DEFAULT_SCAN_DIRS = ["src", "app", "pages", "components"];
-function loadConfigFile(root) {
-  const path = (0, import_path4.join)(root, "kbach.config.js");
-  if (!(0, import_fs2.existsSync)(path)) return void 0;
+function isEsmRequireFailure(err) {
+  if (!(err instanceof Error)) return false;
+  return err.code === "ERR_REQUIRE_ESM" || /is not defined in ES module scope/.test(err.message);
+}
+async function importConfigModule(path) {
+  const mod = await import((0, import_url.pathToFileURL)(path).href);
+  return mod.default ?? mod;
+}
+function requireConfigModule(root, path) {
   const mod = (0, import_module.createRequire)(root)(path);
   return mod.default ?? mod;
 }
-function resolveEffectiveTheme(root, options) {
+async function loadConfigFile(root) {
+  const cjsPath = (0, import_path4.join)(root, "kbach.config.cjs");
+  if ((0, import_fs2.existsSync)(cjsPath)) return requireConfigModule(root, cjsPath);
+  const mjsPath = (0, import_path4.join)(root, "kbach.config.mjs");
+  if ((0, import_fs2.existsSync)(mjsPath)) return importConfigModule(mjsPath);
+  const jsPath = (0, import_path4.join)(root, "kbach.config.js");
+  if (!(0, import_fs2.existsSync)(jsPath)) return void 0;
+  try {
+    return requireConfigModule(root, jsPath);
+  } catch (err) {
+    if (!isEsmRequireFailure(err)) throw err;
+    return importConfigModule(jsPath);
+  }
+}
+async function resolveEffectiveTheme(root, options) {
   if (options.theme) return options.theme;
   if (options.config) return resolveKbachConfig(options.config);
-  const discovered = loadConfigFile(root);
+  const discovered = await loadConfigFile(root);
   return discovered ? resolveKbachConfig(discovered) : defaultTheme;
 }
 
@@ -1089,9 +1110,9 @@ function spliceGeneratedCss(root, generatedCss) {
 function kbachPostcss(options = {}) {
   return {
     postcssPlugin: "kbach",
-    Once(root, { result }) {
+    async Once(root, { result }) {
       const projectRoot = options.root ?? process.cwd();
-      const theme = resolveEffectiveTheme(projectRoot, options);
+      const theme = await resolveEffectiveTheme(projectRoot, options);
       const includeDirs = options.include ?? DEFAULT_SCAN_DIRS;
       const safelist = options.safelist ?? [];
       const engine = createKbachStaticCssEngine({

package/dist/postcss-plugin.mjs

@@ -2,7 +2,7 @@ import {
   DEFAULT_SCAN_DIRS,
   createKbachStaticCssEngine,
   resolveEffectiveTheme
-} from "./chunk-3E26VMLA.mjs";
+} from "./chunk-7JBSTM5D.mjs";
 import "./chunk-NKR3PSWO.mjs";
 import "./chunk-N5HCQIBB.mjs";
 
@@ -46,9 +46,9 @@ function spliceGeneratedCss(root, generatedCss) {
 function kbachPostcss(options = {}) {
   return {
     postcssPlugin: "kbach",
-    Once(root, { result }) {
+    async Once(root, { result }) {
       const projectRoot = options.root ?? process.cwd();
-      const theme = resolveEffectiveTheme(projectRoot, options);
+      const theme = await resolveEffectiveTheme(projectRoot, options);
       const includeDirs = options.include ?? DEFAULT_SCAN_DIRS;
       const safelist = options.safelist ?? [];
       const engine = createKbachStaticCssEngine({

package/dist/vite-plugin.d.mts

@@ -65,24 +65,40 @@ declare function findMainCSSFile(root: string, includeDirs: string[], explicitCs
 declare const DEFAULT_SCAN_DIRS: string[];
 declare const CSS_SYNC_DEBOUNCE_MS = 50;
 /**
- * Auto-discovers `kbach.config.js` at the project root — `undefined` if it
- * doesn't exist (the common case: most projects have no customization at
+ * Auto-discovers a `kbach.config.*` file at the project root — `undefined`
+ * if none exists (the common case: most projects have no customization at
  * all, so this is a silent, expected no-op, not a warning).
  *
- * Uses `require()` (a real project's `kbach.config.js` is plain CommonJS,
- * `module.exports = {...}`, matching every example in this package's own
- * README), built via `createRequire(root)` rather than
+ * Checks three filenames, in order, mirroring Node's own module-format
+ * conventions rather than assuming one: `kbach.config.cjs` (always
+ * CommonJS, `module.exports = {...}` — the one unambiguous choice
+ * regardless of the project's package.json) and `kbach.config.mjs`
+ * (always real ESM, `export default {...}`) are tried first, each loaded
+ * the one way that's guaranteed correct for that extension. Only the bare
+ * `kbach.config.js` — whose actual meaning depends on the nearest
+ * package.json's `"type"` field, exactly like every other `.js` file in
+ * the project — needs the fallback below: try `require()` first (correct
+ * for `"type": "commonjs"`/no `"type"` field, the more common case), and
+ * only on a failure that specifically indicates an ESM/CJS mismatch (see
+ * `isEsmRequireFailure`), retry via a real dynamic `import()` instead. A
+ * genuine syntax error in an otherwise-correctly-formatted config file is
+ * NOT caught here — it propagates as a real, actionable build failure,
+ * rather than being silently swallowed into a confusing second attempt.
+ *
+ * `require()` is built via `createRequire(root)` rather than
  * `createRequire(import.meta.url)` — this file is written as ESM source,
  * but tsup's CJS build output has no real `import.meta.url` (esbuild
  * leaves it `undefined` there), which would make `createRequire` throw for
  * anyone consuming this package's `require('@kbach/react/vite')` entry.
  * `root` works as `createRequire`'s base in either build: it's always an
- * absolute, already-`existsSync`-validated-by-caller directory, and
- * `require()` given `path` (itself already absolute) doesn't consult the
- * base for resolution anyway — the base only matters for a RELATIVE
- * specifier, which this never passes it.
+ * absolute, already-`existsSync`-validated directory, and `require()`
+ * given an already-absolute `path` doesn't consult the base for
+ * resolution anyway — the base only matters for a relative specifier,
+ * which this never passes it. `import()` needs a real `file://` URL, not
+ * a bare Windows path (`C:\...` isn't a valid ESM specifier) — hence
+ * `pathToFileURL`.
  */
-declare function loadConfigFile(root: string): KbachConfig | undefined;
+declare function loadConfigFile(root: string): Promise<KbachConfig | undefined>;
 /**
  * Resolves the theme to use, applying the same "explicit theme/config
  * always wins over kbach.config.js auto-discovery" precedence both
@@ -91,7 +107,7 @@ declare function loadConfigFile(root: string): KbachConfig | undefined;
 declare function resolveEffectiveTheme(root: string, options: {
     theme?: ThemeConfig;
     config?: KbachConfig;
-}): ThemeConfig;
+}): Promise<ThemeConfig>;
 /**
  * Build-time static CSS generation for Vite — scans source files for
  * Kbach class strings, resolves them through the same Rust engine the

package/dist/vite-plugin.d.ts

@@ -65,24 +65,40 @@ declare function findMainCSSFile(root: string, includeDirs: string[], explicitCs
 declare const DEFAULT_SCAN_DIRS: string[];
 declare const CSS_SYNC_DEBOUNCE_MS = 50;
 /**
- * Auto-discovers `kbach.config.js` at the project root — `undefined` if it
- * doesn't exist (the common case: most projects have no customization at
+ * Auto-discovers a `kbach.config.*` file at the project root — `undefined`
+ * if none exists (the common case: most projects have no customization at
  * all, so this is a silent, expected no-op, not a warning).
  *
- * Uses `require()` (a real project's `kbach.config.js` is plain CommonJS,
- * `module.exports = {...}`, matching every example in this package's own
- * README), built via `createRequire(root)` rather than
+ * Checks three filenames, in order, mirroring Node's own module-format
+ * conventions rather than assuming one: `kbach.config.cjs` (always
+ * CommonJS, `module.exports = {...}` — the one unambiguous choice
+ * regardless of the project's package.json) and `kbach.config.mjs`
+ * (always real ESM, `export default {...}`) are tried first, each loaded
+ * the one way that's guaranteed correct for that extension. Only the bare
+ * `kbach.config.js` — whose actual meaning depends on the nearest
+ * package.json's `"type"` field, exactly like every other `.js` file in
+ * the project — needs the fallback below: try `require()` first (correct
+ * for `"type": "commonjs"`/no `"type"` field, the more common case), and
+ * only on a failure that specifically indicates an ESM/CJS mismatch (see
+ * `isEsmRequireFailure`), retry via a real dynamic `import()` instead. A
+ * genuine syntax error in an otherwise-correctly-formatted config file is
+ * NOT caught here — it propagates as a real, actionable build failure,
+ * rather than being silently swallowed into a confusing second attempt.
+ *
+ * `require()` is built via `createRequire(root)` rather than
  * `createRequire(import.meta.url)` — this file is written as ESM source,
  * but tsup's CJS build output has no real `import.meta.url` (esbuild
  * leaves it `undefined` there), which would make `createRequire` throw for
  * anyone consuming this package's `require('@kbach/react/vite')` entry.
  * `root` works as `createRequire`'s base in either build: it's always an
- * absolute, already-`existsSync`-validated-by-caller directory, and
- * `require()` given `path` (itself already absolute) doesn't consult the
- * base for resolution anyway — the base only matters for a RELATIVE
- * specifier, which this never passes it.
+ * absolute, already-`existsSync`-validated directory, and `require()`
+ * given an already-absolute `path` doesn't consult the base for
+ * resolution anyway — the base only matters for a relative specifier,
+ * which this never passes it. `import()` needs a real `file://` URL, not
+ * a bare Windows path (`C:\...` isn't a valid ESM specifier) — hence
+ * `pathToFileURL`.
  */
-declare function loadConfigFile(root: string): KbachConfig | undefined;
+declare function loadConfigFile(root: string): Promise<KbachConfig | undefined>;
 /**
  * Resolves the theme to use, applying the same "explicit theme/config
  * always wins over kbach.config.js auto-discovery" precedence both
@@ -91,7 +107,7 @@ declare function loadConfigFile(root: string): KbachConfig | undefined;
 declare function resolveEffectiveTheme(root: string, options: {
     theme?: ThemeConfig;
     config?: KbachConfig;
-}): ThemeConfig;
+}): Promise<ThemeConfig>;
 /**
  * Build-time static CSS generation for Vite — scans source files for
  * Kbach class strings, resolves them through the same Rust engine the

package/dist/vite-plugin.js

@@ -30,6 +30,7 @@ __export(vite_plugin_exports, {
 module.exports = __toCommonJS(vite_plugin_exports);
 var import_fs3 = require("fs");
 var import_path4 = require("path");
+var import_url = require("url");
 var import_module = require("module");
 
 // src/vite-plugin/cssVars.ts
@@ -1782,16 +1783,36 @@ function writeFileEnsuringDir(path, content) {
   (0, import_fs3.mkdirSync)((0, import_path4.dirname)(path), { recursive: true });
   (0, import_fs3.writeFileSync)(path, content, "utf-8");
 }
-function loadConfigFile(root) {
-  const path = (0, import_path4.join)(root, "kbach.config.js");
-  if (!(0, import_fs3.existsSync)(path)) return void 0;
+function isEsmRequireFailure(err) {
+  if (!(err instanceof Error)) return false;
+  return err.code === "ERR_REQUIRE_ESM" || /is not defined in ES module scope/.test(err.message);
+}
+async function importConfigModule(path) {
+  const mod = await import((0, import_url.pathToFileURL)(path).href);
+  return mod.default ?? mod;
+}
+function requireConfigModule(root, path) {
   const mod = (0, import_module.createRequire)(root)(path);
   return mod.default ?? mod;
 }
-function resolveEffectiveTheme(root, options) {
+async function loadConfigFile(root) {
+  const cjsPath = (0, import_path4.join)(root, "kbach.config.cjs");
+  if ((0, import_fs3.existsSync)(cjsPath)) return requireConfigModule(root, cjsPath);
+  const mjsPath = (0, import_path4.join)(root, "kbach.config.mjs");
+  if ((0, import_fs3.existsSync)(mjsPath)) return importConfigModule(mjsPath);
+  const jsPath = (0, import_path4.join)(root, "kbach.config.js");
+  if (!(0, import_fs3.existsSync)(jsPath)) return void 0;
+  try {
+    return requireConfigModule(root, jsPath);
+  } catch (err) {
+    if (!isEsmRequireFailure(err)) throw err;
+    return importConfigModule(jsPath);
+  }
+}
+async function resolveEffectiveTheme(root, options) {
   if (options.theme) return options.theme;
   if (options.config) return resolveKbachConfig(options.config);
-  const discovered = loadConfigFile(root);
+  const discovered = await loadConfigFile(root);
   return discovered ? resolveKbachConfig(discovered) : defaultTheme;
 }
 function kbach(options = {}) {
@@ -1826,9 +1847,9 @@ function kbach(options = {}) {
   return {
     name: "kbach",
     enforce: "pre",
-    configResolved(resolved) {
+    async configResolved(resolved) {
       root = resolved.root;
-      theme = resolveEffectiveTheme(root, options);
+      theme = await resolveEffectiveTheme(root, options);
       engine = createKbachStaticCssEngine({ root, theme, themeJson: JSON.stringify(theme), includeDirs, safelist });
       mainCSSFilePath = findMainCSSFile(root, includeDirs, options.cssFile);
     },

package/dist/vite-plugin.mjs

@@ -5,7 +5,7 @@ import {
   kbach,
   loadConfigFile,
   resolveEffectiveTheme
-} from "./chunk-3E26VMLA.mjs";
+} from "./chunk-7JBSTM5D.mjs";
 import "./chunk-NKR3PSWO.mjs";
 import "./chunk-N5HCQIBB.mjs";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kbach/react",
-  "version": "1.0.0-beta.8",
+  "version": "1.0.0-beta.9",
   "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", "react", "tailwind", "utility-first", "wasm", "styling"],
   "license": "MIT",