@barocss/kit 0.0.2 → 0.0.3

package/dist/index.d.ts

@@ -72,6 +72,87 @@ export declare type AstNode = {
 
  export declare function atRule(name: string, params: string, nodes: AstNode[], source?: string): AstNode;
 
+ /**
+  * The structured input format for BaroCSS engine.
+  * Designed to be easily generated by AI models.
+  */
+ export declare type BaroJsonInput = {
+     /**
+      * The core utility to apply.
+      * Corresponds to the utility class name in Tailwind (e.g., 'bg-red-500', 'p-4').
+      */
+     utility: {
+         /**
+          * The utility prefix.
+          * @example 'bg', 'text', 'p', 'm', 'flex', 'hidden'
+          */
+         name: string;
+         /**
+          * The value of the utility.
+          * Optional for boolean utilities like 'flex', 'hidden'.
+          * @example 'red-500', '4', 'lg', '#123456'
+          */
+         value?: string;
+         /**
+          * Whether the value is an arbitrary value (JIT).
+          * @default false
+          * @example true for 'bg-[#123456]'
+          */
+         arbitrary?: boolean;
+         /**
+          * Whether the value is negative.
+          * @default false
+          * @example true for '-m-4'
+          */
+         negative?: boolean;
+         /**
+          * Opacity modifier for colors.
+          * @example '50' for 'bg-red-500/50'
+          */
+         opacity?: string;
+         /**
+          * Whether the value is a custom property.
+          * @default false
+          * @example true for 'bg-(--my-bg)'
+          */
+         customProperty?: boolean;
+         /**
+          * Whether the utility is marked as important (!).
+          * @default false
+          * @example true for '!bg-red-500'
+          */
+         important?: boolean;
+     };
+     /**
+      * List of variants/modifiers to apply.
+      * Applied from outside to inside (left to right in string format).
+      * @example ['hover', 'focus'] for 'hover:focus:bg-red-500'
+      */
+     variants?: Array<string | BaroVariant>;
+ };
+
+ /**
+  * Detailed configuration for a variant.
+  */
+ export declare type BaroVariant = {
+     /**
+      * The name of the variant.
+      * @example 'hover', 'focus', 'sm', 'data', 'group-hover'
+      */
+     name: string;
+     /**
+      * The value for parameterized variants.
+      * @example 'open' for 'data-[state=open]'
+      */
+     value?: string;
+     /**
+      * Whether the variant is arbitrary.
+      * @default false
+      * @example true for 'min-[320px]'
+      */
+     arbitrary?: boolean;
+ };
+
  /**
   * Clear all caches (for context changes or testing)
   */
@@ -407,6 +488,18 @@ export declare type AstNode = {
       dedup?: boolean;
   }): string;
 
+  /**
+   * Generates CSS from a list of BaroJsonInput objects.
+   *
+   * @param inputs Array of BaroJsonInput
+   * @param ctx Context
+   * @param opts Options (minify, etc.)
+   * @returns CSS string
+   */
+  export declare function generateCssFromJson(inputs: BaroJsonInput[], ctx: Context, opts?: {
+      minify?: boolean;
+  }): string;
+
   /**
    * Returns an array of optimized results for multiple class names with dedup/filter.
    * - Each object: { cls, ast, css }
@@ -664,6 +757,16 @@ export declare type AstNode = {
        getProcessedClasses(): string[];
    }
 
+   /**
+    * Converts a single BaroJsonInput object into an AST tree.
+    * Bypasses string parsing and directly invokes utility/modifier handlers.
+    *
+    * @param input BaroJsonInput object
+    * @param ctx Context
+    * @returns AstNode[]
+    */
+   export declare function jsonToAst(input: BaroJsonInput, ctx: Context): AstNode[];
+
    /**
     * mergeAstTreeList
     * Takes a list of declPathToAst results (AstNode[][]), merges same at-rule(name, params) etc., and returns the final AST tree.

package/dist/index.js

@@ -2442,6 +2442,179 @@ function createContext(configObj) {
   };
   return ctx;
 }
+function jsonToAst(input, ctx) {
+  let utilReg = getUtility().find((u) => u.name === input.utility.name);
+  if (input.utility.value && !input.utility.arbitrary && !input.utility.customProperty) {
+    const fullName = `${input.utility.name}-${input.utility.value}`;
+    const exactMatch = getUtility().find((u) => u.name === fullName);
+    if (exactMatch) {
+      utilReg = exactMatch;
+    }
+  }
+  if (!utilReg) {
+    console.warn(`[jsonToAst] Unknown utility: "${input.utility.name}"`);
+    return [];
+  }
+  const parsedUtility = {
+    prefix: input.utility.name,
+    value: input.utility.value,
+    arbitrary: input.utility.arbitrary,
+    negative: input.utility.negative,
+    opacity: input.utility.opacity,
+    important: input.utility.important,
+    customProperty: input.utility.customProperty,
+    category: utilReg.category,
+    priority: utilReg.priority
+  };
+  let value = input.utility.value;
+  if (input.utility.negative && value) {
+    value = "-" + value;
+  }
+  let ast = utilReg.handler(value || "", ctx, parsedUtility, utilReg) || [];
+  if (input.variants && input.variants.length > 0) {
+    const wrappers = [];
+    const selector = "&";
+    for (let i = input.variants.length - 1; i >= 0; i--) {
+      const variantInput = input.variants[i];
+      const variantName = typeof variantInput === "string" ? variantInput : variantInput.name;
+      const variantValue = typeof variantInput === "string" ? void 0 : variantInput.value;
+      const variantArbitrary = typeof variantInput === "string" ? false : variantInput.arbitrary;
+      const parsedModifier = {
+        type: variantName,
+        value: variantValue,
+        arbitrary: variantArbitrary
+      };
+      let matchKey = variantName;
+      if (variantArbitrary && variantValue) {
+        if (variantName) {
+          matchKey = `${variantName}-[${variantValue}]`;
+          parsedModifier.type = matchKey;
+        } else {
+          matchKey = `[${variantValue}]`;
+          parsedModifier.type = matchKey;
+        }
+      } else if (variantValue) {
+        matchKey = `${variantName}-[${variantValue}]`;
+        parsedModifier.type = matchKey;
+      }
+      const plugin = getModifier().find((p) => p.match(matchKey, ctx));
+      if (!plugin) {
+        console.warn(`[jsonToAst] Unknown variant: "${matchKey}"`);
+        continue;
+      }
+      if (plugin.wrap) {
+        const items = plugin.wrap(parsedModifier, ctx);
+        wrappers.push({
+          type: "wrap",
+          items
+        });
+        continue;
+      }
+      if (plugin.modifySelector) {
+        const result = plugin.modifySelector({
+          selector,
+          fullClassName: "JSON_GENERATED",
+          // Placeholder
+          mod: parsedModifier,
+          context: ctx,
+          variantChain: [],
+          // We might need to pass the full chain if needed
+          index: i
+        });
+        if (typeof result === "string" && result.includes("&")) {
+          wrappers.push({ type: "rule", selector: result });
+        } else if (typeof result === "object" && !Array.isArray(result) && result.selector) {
+          const r = result;
+          const wrappingType = r.wrappingType || "rule";
+          wrappers.push({
+            type: wrappingType,
+            selector: r.selector,
+            flatten: r.flatten,
+            source: r.source
+          });
+        } else if (Array.isArray(result)) {
+          wrappers.push({
+            type: "wrap",
+            items: result.map((r) => ({
+              type: r.wrappingType || "rule",
+              selector: r.selector,
+              source: r.source,
+              nodes: []
+              // Placeholder, will be filled when wrapping
+            }))
+          });
+        }
+      }
+    }
+    for (let i = 0; i < wrappers.length; i++) {
+      const wrap = wrappers[i];
+      if (wrap.type === "wrap") {
+        ast = wrap.items.map((item) => ({
+          ...item,
+          nodes: Array.isArray(ast) ? ast : [ast]
+        }));
+      } else if (wrap.type === "style-rule") {
+        ast = [
+          {
+            type: "style-rule",
+            selector: wrap.selector,
+            source: wrap.source,
+            nodes: Array.isArray(ast) ? ast : [ast]
+          }
+        ];
+      } else if (wrap.type === "at-rule") {
+        ast = [
+          {
+            type: "at-rule",
+            name: wrap.name || "media",
+            params: wrap.params,
+            source: wrap.source,
+            nodes: Array.isArray(ast) ? ast : [ast]
+          }
+        ];
+      } else if (wrap.type === "rule") {
+        ast = [
+          {
+            type: "rule",
+            selector: wrap.selector,
+            source: wrap.source,
+            nodes: Array.isArray(ast) ? ast : [ast]
+          }
+        ];
+      }
+    }
+  }
+  return ast;
+}
+function generateCssFromJson(inputs, ctx, opts) {
+  const allAtRootNodes = [];
+  const cssList = [];
+  inputs.forEach((input) => {
+    const ast = jsonToAst(input, ctx);
+    const cleanAst = optimizeAst(ast);
+    cleanAst.forEach((node) => {
+      if (node.type === "at-root") {
+        allAtRootNodes.push(...node.nodes);
+      }
+    });
+    let reconstructedName = input.utility.name;
+    if (input.utility.value) reconstructedName += `-${input.utility.value}`;
+    if (input.utility.arbitrary) reconstructedName = `${input.utility.name}-[${input.utility.value}]`;
+    if (input.variants) {
+      const variantsStr = input.variants.map((v) => typeof v === "string" ? v : v.name).join(":");
+      reconstructedName = `${variantsStr}:${reconstructedName}`;
+    }
+    const hasStyleRule = cleanAst.some((node) => node.type === "style-rule");
+    const css = astToCss(cleanAst, hasStyleRule ? void 0 : `.${reconstructedName.replace(/[^a-zA-Z0-9-_]/g, "\\$&")}`, {
+      minify: opts?.minify,
+      important: input.utility.important ?? false
+    });
+    if (css) cssList.push(css);
+  });
+  const rootCss = rootToCss(allAtRootNodes);
+  const finalCss = `${rootCss ? `:root,:host {${rootCss}}` : ""}${cssList.join(opts?.minify ? "" : "\n")}`;
+  return finalCss;
+}
 function parseFraction(input) {
   if (input.includes("/")) {
     const [num, denom] = input.split("/").map(Number);
@@ -7735,11 +7908,13 @@ export {
   functionalModifier,
   functionalUtility,
   generateCss,
+  generateCssFromJson,
   generateCssRules,
   getModifier,
   getPreflightCSS,
   getUtility,
   hasPreset,
+  jsonToAst,
   mergeAstTreeList,
   modifierRegistry,
   optimizeAst,