@kbach/react 0.6.51 → 1.0.0-beta.1

package/dist/jsx-runtime.mjs

@@ -1,17 +1,12 @@
-'use client';
 import {
   Fragment,
-  _invalidateDefaultFontCache,
   jsx,
   jsxs
-} from "./chunk-LIUJPOTS.mjs";
-import {
-  registerWebElement
-} from "./chunk-KRRGLJLA.mjs";
+} from "./chunk-AD3G6RHY.mjs";
+import "./chunk-ROZXCQSM.mjs";
+import "./chunk-FOQWQDF4.mjs";
 export {
   Fragment,
-  _invalidateDefaultFontCache,
   jsx,
-  jsxs,
-  registerWebElement
+  jsxs
 };

package/dist/theme-BKAb78KP.d.mts

@@ -0,0 +1,20 @@
+/** A plain hex color, or a mode-aware pair auto-expanded into a light/dark class pair by the Rust engine. */
+type ColorEntry = string | {
+    light: string;
+    dark: string;
+};
+type DarkModeStrategy = 'attribute' | 'class' | 'media';
+interface ThemeConfig {
+    /** e.g. "blue-6" -> "#2563eb", or "surface" -> { light, dark } */
+    colors: Record<string, ColorEntry>;
+    /** e.g. "4" -> 16 (px) */
+    spacing: Record<string, number>;
+    /** e.g. "sm" -> 640 (min-width px) */
+    screens: Record<string, number>;
+    darkMode: DarkModeStrategy;
+}
+declare const defaultTheme: ThemeConfig;
+declare function setTheme(theme: ThemeConfig): void;
+declare function getTheme(): ThemeConfig;
+
+export { type ThemeConfig as T, defaultTheme as d, getTheme as g, setTheme as s };

package/dist/theme-BKAb78KP.d.ts

@@ -0,0 +1,20 @@
+/** A plain hex color, or a mode-aware pair auto-expanded into a light/dark class pair by the Rust engine. */
+type ColorEntry = string | {
+    light: string;
+    dark: string;
+};
+type DarkModeStrategy = 'attribute' | 'class' | 'media';
+interface ThemeConfig {
+    /** e.g. "blue-6" -> "#2563eb", or "surface" -> { light, dark } */
+    colors: Record<string, ColorEntry>;
+    /** e.g. "4" -> 16 (px) */
+    spacing: Record<string, number>;
+    /** e.g. "sm" -> 640 (min-width px) */
+    screens: Record<string, number>;
+    darkMode: DarkModeStrategy;
+}
+declare const defaultTheme: ThemeConfig;
+declare function setTheme(theme: ThemeConfig): void;
+declare function getTheme(): ThemeConfig;
+
+export { type ThemeConfig as T, defaultTheme as d, getTheme as g, setTheme as s };

package/dist/vite-plugin.d.mts

@@ -1,155 +1,28 @@
 import { Plugin } from 'vite';
+import { T as ThemeConfig } from './theme-BKAb78KP.mjs';
 
-/**
- * Unified modifier registry — single source of truth for ALL modifier behavior.
- *
- * Adding a new modifier requires editing ONLY this file:
- *   1. Add an entry to BUILTIN_MODIFIERS with its CSS and JS behavior.
- *   2. Done — parser, resolver, CSS generator, and JSX runtime all derive
- *      their behavior from this data automatically.
- *
- * Plugin authors can register custom modifiers via registerModifier().
- */
-interface ModifierDef {
-    /**
-     * Cascade priority for CSS rule ORDER — NOT specificity. Two rules that
-     * differ only by modifier (e.g. `.hover\:bg-blue-6:hover` and
-     * `.focus\:bg-red-6:focus`) have equal CSS specificity, so when both
-     * conditions are true at once (hovering AND focused), the winner is
-     * whichever rule appears LATER in the stylesheet — CSS's normal same-
-     * specificity tiebreak. Without a fixed priority, "later" would depend on
-     * encounter order (whichever class the app happens to render/scan first),
-     * making the winner effectively random and inconsistent across reloads/
-     * builds. `order` fixes that: rules are emitted/injected sorted by this
-     * value (ascending — higher wins ties), regardless of source order, so
-     * e.g. `disabled:` always beats `hover:` on the same element no matter
-     * which one was written first in the className or rendered first in the
-     * app. Omit for the default (0). See getModifierOrder() below.
-     */
-    order?: number;
-    /** CSS pseudo-class or pseudo-element appended to the selector (e.g. ':hover', '::before') */
-    pseudo?: string;
-    /** Ancestor selector prefix INCLUDING trailing space (e.g. '.group:hover ', '.peer:focus ~ ') */
-    ancestorSelector?: string;
-    /** Directionality attribute selector prefix INCLUDING trailing space (e.g. '[dir="rtl"] ') */
-    dirSelector?: string;
-    /** @media query body WITHOUT the '@media ' prefix (e.g. 'print', '(orientation: landscape)') */
-    mediaQuery?: string;
-    /** Dark/light mode scheme — triggers the configured darkMode strategy in CSS output */
-    darkScheme?: 'dark' | 'light';
-    /** True for responsive modifiers — wraps in @media (min-width: theme.screens[name]) */
-    isResponsive?: boolean;
-    /**
-     * Forces !important on all declarations in the generated CSS rule.
-     * Applied automatically for structural / ancestor / media modifiers that must
-     * win over base inline styles.
-     */
-    forcesImportant?: boolean;
-    /**
-     * How the JSX runtime routes this modifier:
-     *   'interactive'  — managed by InteractiveWrapper (hover, focus, pressed, …)
-     *   'mode'         — managed by DarkWrapper (dark, light, not-dark, …)
-     *   'responsive'   — managed by DarkWrapper (sm, md, lg, xl, 2xl)
-     *   'css-only'     — CSS injection only; matchModifier always returns false
-     */
-    jsBehavior: 'interactive' | 'mode' | 'responsive' | 'css-only';
-    /**
-     * Evaluates whether this modifier's condition is met at runtime.
-     * Omit for 'css-only' modifiers — they never apply as inline styles.
-     */
-    jsMatch?: (isDark: boolean, state: Record<string, boolean | undefined>, breakpoints: Set<string>) => boolean;
-}
-
-interface StyleValue {
-    [key: string]: string | number | undefined | null | StyleValue | StyleValue[];
-}
-/**
- * A color value is either a plain string (hex/rgb/alias-to-another-color-name)
- * or a mode-aware pair — resolved to `light` or `dark` per the active theme
- * mode wherever it's actually used (className resolution, useColors()).
- */
-type ColorValue = string | {
-    light: string;
-    dark: string;
-};
-type ColorShades = Record<string, ColorValue>;
-type ThemeColors = Record<string, ColorValue | ColorShades>;
-type ThemeSpacing = Record<string, number | string>;
-interface ThemeConfig {
-    colors: ThemeColors;
-    spacing: ThemeSpacing;
-    fontSize: Record<string, number | string>;
-    fontFamily: Record<string, string | string[]>;
-    fontWeight: Record<string, string | number>;
-    borderRadius: Record<string, number | string>;
-    borderWidth: Record<string, number>;
-    opacity: Record<string, number>;
-    lineHeight: Record<string, number | string>;
-    letterSpacing: Record<string, number | string>;
-    zIndex: Record<string, number | string>;
-    flex: Record<string, number | string>;
-    shadow: Record<string, StyleValue>;
-    screens: Record<string, string | number>;
-    /**
-     * Custom @keyframes, web only. Each key is a keyframe name, its value maps
-     * percentage/from/to selectors to a plain CSS declaration object (camelCase
-     * properties, same shape as an inline style object):
-     *   keyframes: { wiggle: { '0%, 100%': { transform: 'rotate(-3deg)' }, '50%': { transform: 'rotate(3deg)' } } }
-     * Referenced from `animation` below, or directly via animate-[wiggle_1s_ease-in-out].
-     */
-    keyframes: Record<string, Record<string, StyleValue>>;
+interface KbachPluginOptions {
+    /** Defaults to the same defaultTheme the runtime uses — pass your own to keep both in sync. */
+    theme?: ThemeConfig;
+    /** Directories to scan for class strings (relative to Vite root). */
+    include?: string[];
     /**
-     * Named animation shorthands built on `keyframes` above, referenced via
-     * animate-{name} (e.g. animate-wiggle):
-     *   animation: { wiggle: 'wiggle 1s ease-in-out infinite' }
-     * The first word must match a `keyframes` key so its @keyframes rule can be
-     * injected alongside the animation — a name with no matching keyframes entry
-     * still sets the `animation` CSS property, it just won't animate anything.
+     * Class names to always include in the generated kbach.css, even if no
+     * scan finds them literally in your source — for dynamically-built class
+     * strings static extraction can't see (e.g. `` `bg-${color}-6` ``). Same
+     * purpose as Tailwind's `safelist`.
      */
-    animation: Record<string, string>;
-    [key: string]: unknown;
+    safelist?: string[];
 }
 /**
- * 'class'     — toggles .dark class on <html>
- * 'media'     — uses prefers-color-scheme media query
- * 'attribute' — uses data-theme="dark" attribute on <html>
+ * Build-time static CSS generation for Vite — scans source files for
+ * Kbach class strings, resolves them through the same Rust engine the
+ * runtime uses (via the Node-target WASM build, see wasmNode.ts), and
+ * writes a real kbach.css. Simplified vs old-kbach's version: expects
+ * `src/kbach.css` to exist at a fixed conventional path (create it with
+ * `/* kbach:start *\/` / `/* kbach:end *\/` markers) rather than scanning
+ * the whole project for a file named kbach.css.
  */
-type DarkMode = 'attribute' | 'class' | 'media';
-interface PluginAPI {
-    addUtility(name: string, styles: StyleValue): void;
-    /**
-     * Register a custom variant.
-     *
-     * Pass a CSS selector string for simple cases — it is automatically
-     * converted into a ModifierDef that generates correct CSS rules:
-     *   addVariant('hocus', ':hover, :focus')  // pseudo
-     *   addVariant('supports-grid', '@media (display: grid)')  // media
-     *   addVariant('dark-green', '.dark-green')  // ancestor selector
-     *
-     * Pass a full ModifierDef object for advanced control (e.g. JS-trackable
-     * interactive variants with custom jsMatch logic).
-     */
-    addVariant(name: string, selectorOrDef: string | ModifierDef): void;
-    theme(path: string, defaultValue?: unknown): unknown;
-    e(className: string): string;
-}
-interface FrameworkConfig {
-    darkMode?: DarkMode;
-    theme?: Partial<ThemeConfig>;
-    /** Additive theme extension — accepts either `extend.theme.X` or `extend.X` directly. */
-    extend?: {
-        theme?: Partial<ThemeConfig>;
-    } & Partial<ThemeConfig>;
-    plugins?: Array<(api: PluginAPI) => void>;
-    content?: string[];
-}
-
-declare function formatKbachCSS(tokenCSS: Map<string, string>, theme: ThemeConfig, responsiveRe: RegExp): string;
-interface KbachPluginOptions {
-    framework?: FrameworkConfig;
-    /** Directories to scan for class strings (relative to Vite root). Defaults to common source dirs. */
-    include?: string[];
-}
-declare function kbach(userConfigOrOptions?: FrameworkConfig | KbachPluginOptions): Plugin;
+declare function kbach(options?: KbachPluginOptions): Plugin;
 
-export { type KbachPluginOptions, formatKbachCSS, kbach };
+export { type KbachPluginOptions, kbach };

package/dist/vite-plugin.d.ts

@@ -1,155 +1,28 @@
 import { Plugin } from 'vite';
+import { T as ThemeConfig } from './theme-BKAb78KP.js';
 
-/**
- * Unified modifier registry — single source of truth for ALL modifier behavior.
- *
- * Adding a new modifier requires editing ONLY this file:
- *   1. Add an entry to BUILTIN_MODIFIERS with its CSS and JS behavior.
- *   2. Done — parser, resolver, CSS generator, and JSX runtime all derive
- *      their behavior from this data automatically.
- *
- * Plugin authors can register custom modifiers via registerModifier().
- */
-interface ModifierDef {
-    /**
-     * Cascade priority for CSS rule ORDER — NOT specificity. Two rules that
-     * differ only by modifier (e.g. `.hover\:bg-blue-6:hover` and
-     * `.focus\:bg-red-6:focus`) have equal CSS specificity, so when both
-     * conditions are true at once (hovering AND focused), the winner is
-     * whichever rule appears LATER in the stylesheet — CSS's normal same-
-     * specificity tiebreak. Without a fixed priority, "later" would depend on
-     * encounter order (whichever class the app happens to render/scan first),
-     * making the winner effectively random and inconsistent across reloads/
-     * builds. `order` fixes that: rules are emitted/injected sorted by this
-     * value (ascending — higher wins ties), regardless of source order, so
-     * e.g. `disabled:` always beats `hover:` on the same element no matter
-     * which one was written first in the className or rendered first in the
-     * app. Omit for the default (0). See getModifierOrder() below.
-     */
-    order?: number;
-    /** CSS pseudo-class or pseudo-element appended to the selector (e.g. ':hover', '::before') */
-    pseudo?: string;
-    /** Ancestor selector prefix INCLUDING trailing space (e.g. '.group:hover ', '.peer:focus ~ ') */
-    ancestorSelector?: string;
-    /** Directionality attribute selector prefix INCLUDING trailing space (e.g. '[dir="rtl"] ') */
-    dirSelector?: string;
-    /** @media query body WITHOUT the '@media ' prefix (e.g. 'print', '(orientation: landscape)') */
-    mediaQuery?: string;
-    /** Dark/light mode scheme — triggers the configured darkMode strategy in CSS output */
-    darkScheme?: 'dark' | 'light';
-    /** True for responsive modifiers — wraps in @media (min-width: theme.screens[name]) */
-    isResponsive?: boolean;
-    /**
-     * Forces !important on all declarations in the generated CSS rule.
-     * Applied automatically for structural / ancestor / media modifiers that must
-     * win over base inline styles.
-     */
-    forcesImportant?: boolean;
-    /**
-     * How the JSX runtime routes this modifier:
-     *   'interactive'  — managed by InteractiveWrapper (hover, focus, pressed, …)
-     *   'mode'         — managed by DarkWrapper (dark, light, not-dark, …)
-     *   'responsive'   — managed by DarkWrapper (sm, md, lg, xl, 2xl)
-     *   'css-only'     — CSS injection only; matchModifier always returns false
-     */
-    jsBehavior: 'interactive' | 'mode' | 'responsive' | 'css-only';
-    /**
-     * Evaluates whether this modifier's condition is met at runtime.
-     * Omit for 'css-only' modifiers — they never apply as inline styles.
-     */
-    jsMatch?: (isDark: boolean, state: Record<string, boolean | undefined>, breakpoints: Set<string>) => boolean;
-}
-
-interface StyleValue {
-    [key: string]: string | number | undefined | null | StyleValue | StyleValue[];
-}
-/**
- * A color value is either a plain string (hex/rgb/alias-to-another-color-name)
- * or a mode-aware pair — resolved to `light` or `dark` per the active theme
- * mode wherever it's actually used (className resolution, useColors()).
- */
-type ColorValue = string | {
-    light: string;
-    dark: string;
-};
-type ColorShades = Record<string, ColorValue>;
-type ThemeColors = Record<string, ColorValue | ColorShades>;
-type ThemeSpacing = Record<string, number | string>;
-interface ThemeConfig {
-    colors: ThemeColors;
-    spacing: ThemeSpacing;
-    fontSize: Record<string, number | string>;
-    fontFamily: Record<string, string | string[]>;
-    fontWeight: Record<string, string | number>;
-    borderRadius: Record<string, number | string>;
-    borderWidth: Record<string, number>;
-    opacity: Record<string, number>;
-    lineHeight: Record<string, number | string>;
-    letterSpacing: Record<string, number | string>;
-    zIndex: Record<string, number | string>;
-    flex: Record<string, number | string>;
-    shadow: Record<string, StyleValue>;
-    screens: Record<string, string | number>;
-    /**
-     * Custom @keyframes, web only. Each key is a keyframe name, its value maps
-     * percentage/from/to selectors to a plain CSS declaration object (camelCase
-     * properties, same shape as an inline style object):
-     *   keyframes: { wiggle: { '0%, 100%': { transform: 'rotate(-3deg)' }, '50%': { transform: 'rotate(3deg)' } } }
-     * Referenced from `animation` below, or directly via animate-[wiggle_1s_ease-in-out].
-     */
-    keyframes: Record<string, Record<string, StyleValue>>;
+interface KbachPluginOptions {
+    /** Defaults to the same defaultTheme the runtime uses — pass your own to keep both in sync. */
+    theme?: ThemeConfig;
+    /** Directories to scan for class strings (relative to Vite root). */
+    include?: string[];
     /**
-     * Named animation shorthands built on `keyframes` above, referenced via
-     * animate-{name} (e.g. animate-wiggle):
-     *   animation: { wiggle: 'wiggle 1s ease-in-out infinite' }
-     * The first word must match a `keyframes` key so its @keyframes rule can be
-     * injected alongside the animation — a name with no matching keyframes entry
-     * still sets the `animation` CSS property, it just won't animate anything.
+     * Class names to always include in the generated kbach.css, even if no
+     * scan finds them literally in your source — for dynamically-built class
+     * strings static extraction can't see (e.g. `` `bg-${color}-6` ``). Same
+     * purpose as Tailwind's `safelist`.
      */
-    animation: Record<string, string>;
-    [key: string]: unknown;
+    safelist?: string[];
 }
 /**
- * 'class'     — toggles .dark class on <html>
- * 'media'     — uses prefers-color-scheme media query
- * 'attribute' — uses data-theme="dark" attribute on <html>
+ * Build-time static CSS generation for Vite — scans source files for
+ * Kbach class strings, resolves them through the same Rust engine the
+ * runtime uses (via the Node-target WASM build, see wasmNode.ts), and
+ * writes a real kbach.css. Simplified vs old-kbach's version: expects
+ * `src/kbach.css` to exist at a fixed conventional path (create it with
+ * `/* kbach:start *\/` / `/* kbach:end *\/` markers) rather than scanning
+ * the whole project for a file named kbach.css.
  */
-type DarkMode = 'attribute' | 'class' | 'media';
-interface PluginAPI {
-    addUtility(name: string, styles: StyleValue): void;
-    /**
-     * Register a custom variant.
-     *
-     * Pass a CSS selector string for simple cases — it is automatically
-     * converted into a ModifierDef that generates correct CSS rules:
-     *   addVariant('hocus', ':hover, :focus')  // pseudo
-     *   addVariant('supports-grid', '@media (display: grid)')  // media
-     *   addVariant('dark-green', '.dark-green')  // ancestor selector
-     *
-     * Pass a full ModifierDef object for advanced control (e.g. JS-trackable
-     * interactive variants with custom jsMatch logic).
-     */
-    addVariant(name: string, selectorOrDef: string | ModifierDef): void;
-    theme(path: string, defaultValue?: unknown): unknown;
-    e(className: string): string;
-}
-interface FrameworkConfig {
-    darkMode?: DarkMode;
-    theme?: Partial<ThemeConfig>;
-    /** Additive theme extension — accepts either `extend.theme.X` or `extend.X` directly. */
-    extend?: {
-        theme?: Partial<ThemeConfig>;
-    } & Partial<ThemeConfig>;
-    plugins?: Array<(api: PluginAPI) => void>;
-    content?: string[];
-}
-
-declare function formatKbachCSS(tokenCSS: Map<string, string>, theme: ThemeConfig, responsiveRe: RegExp): string;
-interface KbachPluginOptions {
-    framework?: FrameworkConfig;
-    /** Directories to scan for class strings (relative to Vite root). Defaults to common source dirs. */
-    include?: string[];
-}
-declare function kbach(userConfigOrOptions?: FrameworkConfig | KbachPluginOptions): Plugin;
+declare function kbach(options?: KbachPluginOptions): Plugin;
 
-export { type KbachPluginOptions, formatKbachCSS, kbach };
+export { type KbachPluginOptions, kbach };