@unocss/transformer-compile-class 0.33.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-PRESENT Anthony Fu <https://github.com/antfu>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @unocss/transformer-compile-class
+
+<!-- @unocss-ignore -->
+
+Compile group of classes into one class. Inspried by [WindiCSS's compilation mode](https://windicss.org/posts/modes.html#compilation-mode) and [#948](https://github.com/unocss/unocss/issues/948) by [@UltraCakeBakery](https://github.com/UltraCakeBakery).
+
+## Install
+
+```bash
+npm i -D @unocss/transformer-compile-class
+```
+
+```ts
+// uno.config.js
+import { defineConfig } from 'unocss'
+import transformerCompileClass from '@unocss/transformer-compile-class'
+
+export default defineConfig({
+  // ...
+  transformers: [
+    transformerCompileClass(),
+  ],
+})
+```
+
+## Usage
+
+At the begin of your class strings, **add `:uno:` at the begin of the strings** to mark them for compilation. For example:
+
+```html
+<div class=":uno: text-center sm:text-left">
+  <div class=":uno: text-sm font-bold hover:text-red"/>
+</div>
+```
+
+Will be compiled to:
+
+```html
+<div class="uno-qlmcrp">
+  <div class="uno-0qw2gr"/>
+</div>
+```
+
+```css
+.uno-qlmcrp {
+  text-align: center;
+}
+.uno-0qw2gr {
+  font-size: 0.875rem;
+  line-height: 1.25rem;
+  font-weight: 700;
+}
+.uno-0qw2gr:hover {
+  --un-text-opacity: 1;
+  color: rgba(248, 113, 113, var(--un-text-opacity));
+}
+@media (min-width: 640px) {
+  .uno-qlmcrp {
+    text-align: left;
+  }
+}
+```
+
+## Options
+
+You can config the trigger string and prefix for compile class with the options. Refers to [the types](https://github.com/antfu/unocss/blob/main/packages/transformer-compile-class/src/index.ts#L4) for details.
+
+## License
+
+MIT License &copy; 2021-PRESENT [Anthony Fu](https://github.com/antfu)

package/dist/index.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+const core = require('@unocss/core');
+
+function transformerCompileClass(options = {}) {
+  const {
+    trigger = ":uno:",
+    classPrefix = "uno-",
+    hashFn = hash,
+    keepUnknown = true
+  } = options;
+  const regex = new RegExp(`(["'\`])${core.escapeRegExp(trigger)}\\s([^\\1]*?)\\1`, "g");
+  return {
+    name: "compile-class",
+    enforce: "pre",
+    async transform(s, _, { uno }) {
+      const matches = [...s.original.matchAll(regex)];
+      if (!matches.length)
+        return;
+      for (const match of matches) {
+        let body = match[2].trim();
+        const start = match.index;
+        const replacements = [];
+        if (keepUnknown) {
+          const result = await Promise.all(body.split(/\s+/).filter(Boolean).map(async (i) => [i, !!await uno.parseToken(i)]));
+          const known = result.filter(([, matched]) => matched).map(([i]) => i);
+          const unknown = result.filter(([, matched]) => !matched).map(([i]) => i);
+          replacements.push(...unknown);
+          body = known.join(" ");
+        }
+        if (body) {
+          const hash2 = hashFn(body);
+          const className = `${classPrefix}${hash2}`;
+          replacements.unshift(className);
+          uno.config.shortcuts.push([className, body]);
+        }
+        s.overwrite(start + 1, start + match[0].length - 1, replacements.join(" "));
+      }
+    }
+  };
+}
+function hash(str) {
+  let i;
+  let l;
+  let hval = 2166136261;
+  for (i = 0, l = str.length; i < l; i++) {
+    hval ^= str.charCodeAt(i);
+    hval += (hval << 1) + (hval << 4) + (hval << 7) + (hval << 8) + (hval << 24);
+  }
+  return `00000${(hval >>> 0).toString(36)}`.slice(-6);
+}
+
+module.exports = transformerCompileClass;

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { SourceCodeTransformer } from '@unocss/core';
+
+interface CompileClassOptions {
+    /**
+     * Trigger string
+     * @default ':uno:'
+     */
+    trigger?: string;
+    /**
+     * Prefix for compile class name
+     * @default 'uno-'
+     */
+    classPrefix?: string;
+    /**
+     * Hash function
+     */
+    hashFn?: (str: string) => string;
+    /**
+     * Left unknown classes inside the string
+     *
+     * @default true
+     */
+    keepUnknown?: boolean;
+}
+declare function transformerCompileClass(options?: CompileClassOptions): SourceCodeTransformer;
+
+export { CompileClassOptions, transformerCompileClass as default };

package/dist/index.mjs

@@ -0,0 +1,51 @@
+import { escapeRegExp } from '@unocss/core';
+
+function transformerCompileClass(options = {}) {
+  const {
+    trigger = ":uno:",
+    classPrefix = "uno-",
+    hashFn = hash,
+    keepUnknown = true
+  } = options;
+  const regex = new RegExp(`(["'\`])${escapeRegExp(trigger)}\\s([^\\1]*?)\\1`, "g");
+  return {
+    name: "compile-class",
+    enforce: "pre",
+    async transform(s, _, { uno }) {
+      const matches = [...s.original.matchAll(regex)];
+      if (!matches.length)
+        return;
+      for (const match of matches) {
+        let body = match[2].trim();
+        const start = match.index;
+        const replacements = [];
+        if (keepUnknown) {
+          const result = await Promise.all(body.split(/\s+/).filter(Boolean).map(async (i) => [i, !!await uno.parseToken(i)]));
+          const known = result.filter(([, matched]) => matched).map(([i]) => i);
+          const unknown = result.filter(([, matched]) => !matched).map(([i]) => i);
+          replacements.push(...unknown);
+          body = known.join(" ");
+        }
+        if (body) {
+          const hash2 = hashFn(body);
+          const className = `${classPrefix}${hash2}`;
+          replacements.unshift(className);
+          uno.config.shortcuts.push([className, body]);
+        }
+        s.overwrite(start + 1, start + match[0].length - 1, replacements.join(" "));
+      }
+    }
+  };
+}
+function hash(str) {
+  let i;
+  let l;
+  let hval = 2166136261;
+  for (i = 0, l = str.length; i < l; i++) {
+    hval ^= str.charCodeAt(i);
+    hval += (hval << 1) + (hval << 4) + (hval << 7) + (hval << 8) + (hval << 24);
+  }
+  return `00000${(hval >>> 0).toString(36)}`.slice(-6);
+}
+
+export { transformerCompileClass as default };

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@unocss/transformer-compile-class",
+  "version": "0.33.2",
+  "description": "Compile group of classes into one class",
+  "keywords": [
+    "unocss",
+    "unocss-transformer"
+  ],
+  "homepage": "https://github.com/unocss/unocss/tree/main/packages/transformer-compile-class#readme",
+  "bugs": {
+    "url": "https://github.com/unocss/unocss/issues"
+  },
+  "license": "MIT",
+  "author": "Anthony Fu <anthonyfu117@hotmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unocss/unocss.git",
+    "directory": "packages/transformer-compile-class"
+  },
+  "funding": "https://github.com/sponsors/antfu",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@unocss/core": "0.33.2"
+  },
+  "devDependencies": {
+    "magic-string": "^0.26.1"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "stub": "unbuild --stub"
+  }
+}