@unocss/core 0.11.3 → 0.12.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 declare class UnoGenerator {
     userConfig: UserConfig;
     defaults: UserConfigDefaults;
+    version: string;
     private _cache;
     config: ResolvedConfig;
     blocked: Set<string>;
@@ -12,10 +13,10 @@ declare class UnoGenerator {
     matchVariants(raw: string, current?: string): VariantMatchedResult;
     applyVariants(parsed: ParsedUtil, variantHandlers?: VariantHandler[], raw?: string): readonly [string, CSSEntries, string | undefined];
     constructCustomCSS(context: Readonly<RuleContext>, body: CSSObject | CSSEntries, overrideSelector?: string): string;
-    parseUtil(input: string | VariantMatchedResult): Promise<ParsedUtil | RawUtil | undefined>;
+    parseUtil(input: string | VariantMatchedResult, context: RuleContext, internal?: boolean): Promise<ParsedUtil | RawUtil | undefined>;
     stringifyUtil(parsed?: ParsedUtil | RawUtil): StringifiedUtil | undefined;
-    expandShortcut(processed: string, depth?: number): [string[], RuleMeta | undefined] | undefined;
-    stringifyShortcuts(parent: VariantMatchedResult, expanded: string[], meta?: RuleMeta): Promise<StringifiedUtil[] | undefined>;
+    expandShortcut(processed: string, context: RuleContext, depth?: number): [string[], RuleMeta | undefined] | undefined;
+    stringifyShortcuts(parent: VariantMatchedResult, context: RuleContext, expanded: string[], meta?: RuleMeta): Promise<StringifiedUtil[] | undefined>;
     isBlocked(raw: string): boolean;
 }
 declare function createGenerator(config?: UserConfig, defaults?: UserConfigDefaults): UnoGenerator;
@@ -73,18 +74,27 @@ interface Extractor {
     order?: number;
 }
 interface RuleMeta {
+    /**
+     * The layer name of this rule.
+     * @default 'default'
+     */
     layer?: string;
+    /**
+     * Internal rules will only be matched for shortcuts but not the user code.
+     * @default false
+     */
+    internal?: boolean;
 }
 declare type DynamicMatcher<Theme extends {} = {}> = ((match: string[], context: Readonly<RuleContext<Theme>>) => Awaitable<CSSObject | CSSEntries | string | undefined>);
 declare type DynamicRule<Theme extends {} = {}> = [RegExp, DynamicMatcher<Theme>] | [RegExp, DynamicMatcher<Theme>, RuleMeta];
 declare type StaticRule = [string, CSSObject | CSSEntries] | [string, CSSObject | CSSEntries, RuleMeta];
 declare type Rule<Theme extends {} = {}> = DynamicRule<Theme> | StaticRule;
-declare type DynamicShortcutMatcher = ((match: string[]) => (string | string[] | undefined));
-declare type DynamicShortcut = [RegExp, DynamicShortcutMatcher] | [RegExp, DynamicShortcutMatcher, RuleMeta];
+declare type DynamicShortcutMatcher<Theme extends {} = {}> = ((match: string[], context: Readonly<RuleContext<Theme>>) => (string | string[] | undefined));
 declare type StaticShortcut = [string, string | string[]] | [string, string | string[], RuleMeta];
 declare type StaticShortcutMap = Record<string, string | string[]>;
-declare type UserShortcuts = StaticShortcutMap | (StaticShortcut | DynamicShortcut | StaticShortcutMap)[];
-declare type Shortcut = StaticShortcut | DynamicShortcut;
+declare type DynamicShortcut<Theme extends {} = {}> = [RegExp, DynamicShortcutMatcher<Theme>] | [RegExp, DynamicShortcutMatcher<Theme>, RuleMeta];
+declare type UserShortcuts<Theme extends {} = {}> = StaticShortcutMap | (StaticShortcut | DynamicShortcut<Theme> | StaticShortcutMap)[];
+declare type Shortcut<Theme extends {} = {}> = StaticShortcut | DynamicShortcut<Theme>;
 interface Preflight {
     getCSS: () => string | undefined;
     layer?: string;

package/dist/index.js

@@ -304,11 +304,15 @@ function resolveConfig(userConfig = {}, defaults = {}) {
   };
 }
 
+// package.json
+var version = "0.12.0";
+
 // src/generator/index.ts
 var UnoGenerator = class {
   constructor(userConfig = {}, defaults = {}) {
     this.userConfig = userConfig;
     this.defaults = defaults;
+    this.version = version;
     this._cache = new Map();
     this.blocked = new Set();
     this.parentOrders = new Map();
@@ -387,13 +391,21 @@ var UnoGenerator = class {
       const applied = this.matchVariants(raw, current);
       if (!applied || this.isBlocked(applied[1]))
         return block(raw);
-      const expanded = this.expandShortcut(applied[1]);
+      const context = {
+        rawSelector: raw,
+        currentSelector: applied[1],
+        theme: this.config.theme,
+        generator: this,
+        variantHandlers: applied[2],
+        constructCSS: (...args) => this.constructCustomCSS(context, ...args)
+      };
+      const expanded = this.expandShortcut(applied[1], context);
       if (expanded) {
-        const utils = await this.stringifyShortcuts(applied, expanded[0], expanded[1]);
+        const utils = await this.stringifyShortcuts(applied, context, expanded[0], expanded[1]);
         if (utils == null ? void 0 : utils.length)
           return hit(raw, utils);
       } else {
-        const util = this.stringifyUtil(await this.parseUtil(applied));
+        const util = this.stringifyUtil(await this.parseUtil(applied, context));
         if (util)
           return hit(raw, [util]);
       }
@@ -512,24 +524,22 @@ var UnoGenerator = class {
       return `${mediaQuery}{${cssBody}}`;
     return cssBody;
   }
-  async parseUtil(input) {
-    const { theme, rulesStaticMap, rulesDynamic, rulesSize } = this.config;
+  async parseUtil(input, context, internal = false) {
+    var _a, _b;
     const [raw, processed, variantHandlers] = typeof input === "string" ? this.matchVariants(input) : input;
-    const staticMatch = rulesStaticMap[processed];
-    if (staticMatch == null ? void 0 : staticMatch[1])
-      return [staticMatch[0], raw, normalizeEntries(staticMatch[1]), staticMatch[2], variantHandlers];
-    const context = {
-      rawSelector: raw,
-      currentSelector: processed,
-      theme,
-      generator: this,
-      variantHandlers,
-      constructCSS: (...args) => this.constructCustomCSS(context, ...args)
-    };
+    const staticMatch = this.config.rulesStaticMap[processed];
+    if (staticMatch) {
+      if (staticMatch[1] && (internal || !((_a = staticMatch[2]) == null ? void 0 : _a.internal)))
+        return [staticMatch[0], raw, normalizeEntries(staticMatch[1]), staticMatch[2], variantHandlers];
+    }
+    context.variantHandlers = variantHandlers;
+    const { rulesDynamic, rulesSize } = this.config;
     for (let i = rulesSize; i >= 0; i--) {
       const rule = rulesDynamic[i];
       if (!rule)
         continue;
+      if (((_b = rule[2]) == null ? void 0 : _b.internal) && !internal)
+        continue;
       const [matcher, handler, meta] = rule;
       const match = processed.match(matcher);
       if (!match)
@@ -555,7 +565,7 @@ var UnoGenerator = class {
       return;
     return [parsed[0], selector, body, mediaQuery, parsed[3]];
   }
-  expandShortcut(processed, depth = 3) {
+  expandShortcut(processed, context, depth = 3) {
     if (depth === 0)
       return;
     let meta;
@@ -570,7 +580,7 @@ var UnoGenerator = class {
       } else {
         const match = processed.match(s[0]);
         if (match)
-          result = s[1](match);
+          result = s[1](match, context);
         if (result) {
           meta = meta || s[2];
           break;
@@ -584,14 +594,14 @@ var UnoGenerator = class {
     return [
       result.flatMap((r) => {
         var _a;
-        return ((_a = this.expandShortcut(r, depth - 1)) == null ? void 0 : _a[0]) || [r];
+        return ((_a = this.expandShortcut(r, context, depth - 1)) == null ? void 0 : _a[0]) || [r];
       }),
       meta
     ];
   }
-  async stringifyShortcuts(parent, expanded, meta = { layer: this.config.shortcutsLayer }) {
+  async stringifyShortcuts(parent, context, expanded, meta = { layer: this.config.shortcutsLayer }) {
     const selectorMap = new TwoKeyMap();
-    const parsed = (await Promise.all(uniq(expanded).map((i) => this.parseUtil(i)))).filter(Boolean).sort((a, b) => a[0] - b[0]);
+    const parsed = (await Promise.all(uniq(expanded).map((i) => this.parseUtil(i, context, true)))).filter(Boolean).sort((a, b) => a[0] - b[0]);
     const [raw, , parentVariants] = parent;
     for (const item of parsed) {
       if (isRawUtil(item))

package/dist/index.mjs

@@ -267,11 +267,15 @@ function resolveConfig(userConfig = {}, defaults = {}) {
   };
 }
 
+// package.json
+var version = "0.12.0";
+
 // src/generator/index.ts
 var UnoGenerator = class {
   constructor(userConfig = {}, defaults = {}) {
     this.userConfig = userConfig;
     this.defaults = defaults;
+    this.version = version;
     this._cache = new Map();
     this.blocked = new Set();
     this.parentOrders = new Map();
@@ -350,13 +354,21 @@ var UnoGenerator = class {
       const applied = this.matchVariants(raw, current);
       if (!applied || this.isBlocked(applied[1]))
         return block(raw);
-      const expanded = this.expandShortcut(applied[1]);
+      const context = {
+        rawSelector: raw,
+        currentSelector: applied[1],
+        theme: this.config.theme,
+        generator: this,
+        variantHandlers: applied[2],
+        constructCSS: (...args) => this.constructCustomCSS(context, ...args)
+      };
+      const expanded = this.expandShortcut(applied[1], context);
       if (expanded) {
-        const utils = await this.stringifyShortcuts(applied, expanded[0], expanded[1]);
+        const utils = await this.stringifyShortcuts(applied, context, expanded[0], expanded[1]);
         if (utils == null ? void 0 : utils.length)
           return hit(raw, utils);
       } else {
-        const util = this.stringifyUtil(await this.parseUtil(applied));
+        const util = this.stringifyUtil(await this.parseUtil(applied, context));
         if (util)
           return hit(raw, [util]);
       }
@@ -475,24 +487,22 @@ var UnoGenerator = class {
       return `${mediaQuery}{${cssBody}}`;
     return cssBody;
   }
-  async parseUtil(input) {
-    const { theme, rulesStaticMap, rulesDynamic, rulesSize } = this.config;
+  async parseUtil(input, context, internal = false) {
+    var _a, _b;
     const [raw, processed, variantHandlers] = typeof input === "string" ? this.matchVariants(input) : input;
-    const staticMatch = rulesStaticMap[processed];
-    if (staticMatch == null ? void 0 : staticMatch[1])
-      return [staticMatch[0], raw, normalizeEntries(staticMatch[1]), staticMatch[2], variantHandlers];
-    const context = {
-      rawSelector: raw,
-      currentSelector: processed,
-      theme,
-      generator: this,
-      variantHandlers,
-      constructCSS: (...args) => this.constructCustomCSS(context, ...args)
-    };
+    const staticMatch = this.config.rulesStaticMap[processed];
+    if (staticMatch) {
+      if (staticMatch[1] && (internal || !((_a = staticMatch[2]) == null ? void 0 : _a.internal)))
+        return [staticMatch[0], raw, normalizeEntries(staticMatch[1]), staticMatch[2], variantHandlers];
+    }
+    context.variantHandlers = variantHandlers;
+    const { rulesDynamic, rulesSize } = this.config;
     for (let i = rulesSize; i >= 0; i--) {
       const rule = rulesDynamic[i];
       if (!rule)
         continue;
+      if (((_b = rule[2]) == null ? void 0 : _b.internal) && !internal)
+        continue;
       const [matcher, handler, meta] = rule;
       const match = processed.match(matcher);
       if (!match)
@@ -518,7 +528,7 @@ var UnoGenerator = class {
       return;
     return [parsed[0], selector, body, mediaQuery, parsed[3]];
   }
-  expandShortcut(processed, depth = 3) {
+  expandShortcut(processed, context, depth = 3) {
     if (depth === 0)
       return;
     let meta;
@@ -533,7 +543,7 @@ var UnoGenerator = class {
       } else {
         const match = processed.match(s[0]);
         if (match)
-          result = s[1](match);
+          result = s[1](match, context);
         if (result) {
           meta = meta || s[2];
           break;
@@ -547,14 +557,14 @@ var UnoGenerator = class {
     return [
       result.flatMap((r) => {
         var _a;
-        return ((_a = this.expandShortcut(r, depth - 1)) == null ? void 0 : _a[0]) || [r];
+        return ((_a = this.expandShortcut(r, context, depth - 1)) == null ? void 0 : _a[0]) || [r];
       }),
       meta
     ];
   }
-  async stringifyShortcuts(parent, expanded, meta = { layer: this.config.shortcutsLayer }) {
+  async stringifyShortcuts(parent, context, expanded, meta = { layer: this.config.shortcutsLayer }) {
     const selectorMap = new TwoKeyMap();
-    const parsed = (await Promise.all(uniq(expanded).map((i) => this.parseUtil(i)))).filter(Boolean).sort((a, b) => a[0] - b[0]);
+    const parsed = (await Promise.all(uniq(expanded).map((i) => this.parseUtil(i, context, true)))).filter(Boolean).sort((a, b) => a[0] - b[0]);
     const [raw, , parentVariants] = parent;
     for (const item of parsed) {
       if (isRawUtil(item))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unocss/core",
-  "version": "0.11.3",
+  "version": "0.12.0",
   "description": "The instant on-demand Atomic CSS engine.",
   "keywords": [
     "unocss",