@master/css 2.0.0-beta.184 → 2.0.0-beta.186

package/README.md

@@ -65,12 +65,12 @@ Visit [beta.css.master.co](https://beta.css.master.co) to view the full document
 ## Getting Started
 Check out the [official guides](https://beta.css.master.co/docs) to get started with Master CSS, or walk through the [examples](https://github.com/master-co/css/tree/beta/examples) for a quick overview of integrating with your framework.
 
-## Compilation Modes
-Master CSS provides various [compilation modes](https://beta.css.master.co/docs/compilation), allowing you to choose according to the characteristics and needs of different projects.
+## Rendering Modes
+Master CSS provides various [rendering modes](https://beta.css.master.co/docs/rendering-modes), allowing you to choose according to the characteristics and needs of different projects.
 
-- [Progressive Rendering](https://beta.css.master.co/docs/compilation/progressive-rendering) - Scan the requested HTML on the server side, generate CSS rules, and enable runtime-rendering compilation on the browser side
-- [Runtime Rendering](https://beta.css.master.co/docs/compilation/runtime-rendering) - Observe the DOM tree, manipulate CSS rules according to the changed class name, and synchronize to the running style sheet at runtime
-- [Static Extraction](https://beta.css.master.co/docs/compilation/static-extraction) - Scan source files for class names at build time, extract class names, and generate CSS files/virtual modules, then import them in the entry file
+- [Progressive Rendering](https://beta.css.master.co/docs/rendering-modes/progressive-rendering) - Scan the requested HTML on the server side, generate CSS rules, and enable runtime engine on the browser side
+- [Runtime Rendering](https://beta.css.master.co/docs/rendering-modes/runtime-rendering) - Observe the DOM tree, manipulate CSS rules according to the changed class name, and synchronize to the running style sheet at runtime
+- [Static Extraction](https://beta.css.master.co/docs/rendering-modes/static-extraction) - Scan source files for class names at build time, extract class names, and generate CSS files/virtual modules, then import them in the entry file
 
 ## Ecosystem
 We've built various Master CSS core functionality/integration packages:

package/dist/bin/index.bundle.js

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
-var h=Object.create;var d=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var v=Object.getPrototypeOf,x=Object.prototype.hasOwnProperty;var E=(e,o,t,i)=>{if(o&&typeof o=="object"||typeof o=="function")for(let s of _(o))!x.call(e,s)&&s!==t&&d(e,s,{get:()=>o[s],enumerable:!(i=C(o,s))||i.enumerable});return e};var p=(e,o,t)=>(t=e!=null?h(v(e)):{},E(o||!e||!e.__esModule?d(t,"default",{value:e,enumerable:!0}):t,e));var T=require("commander"),m=p(require("path")),a=p(require("fs"));var S=`/** @type {import('@master/css').Config} */
+var h=Object.create;var d=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var x=Object.getPrototypeOf,E=Object.prototype.hasOwnProperty;var O=(e,o,t,i)=>{if(o&&typeof o=="object"||typeof o=="function")for(let s of _(o))!E.call(e,s)&&s!==t&&d(e,s,{get:()=>o[s],enumerable:!(i=C(o,s))||i.enumerable});return e};var p=(e,o,t)=>(t=e!=null?h(x(e)):{},O(o||!e||!e.__esModule?d(t,"default",{value:e,enumerable:!0}):t,e));var T=require("commander"),m=p(require("path")),a=p(require("fs"));var S=`/** @type {import('@master/css').Config} */
 export default {
     styles: {},
     colors: {},
     rules: {},
     variables: {},
     semantics: {},
-    viewports: {},
     mediaQueries: {},
     animations: {},
     selectors: {},
@@ -19,7 +18,6 @@ module.exports = {
     rules: {},
     variables: {},
     semantics: {},
-    viewports: {},
     mediaQueries: {},
     animations: {},
     selectors: {},
@@ -33,10 +31,9 @@ export default {
     rules: {},
     variables: {},
     semantics: {},
-    viewports: {},
     mediaQueries: {},
     animations: {},
     selectors: {},
     functions: {}
 } as Config
-`;var n=p(require("@techor/log")),l=require("@techor/fs"),{version:O,name:w,description:j}=(0,l.readJSONFileSync)(m.default.resolve(__dirname,"../../package.json")),c=new T.Command;c.name(w).description(j).version(O||"0.0.0");c.command("init").description("Initialize definition files for Master CSS").option("-o, --override","Override existing definition file").option("--esm","ES Module .mjs").option("--ts","TypeScript .ts").option("--cjs","CommonJS .js").action(async function(e){let{esm:o,ts:t,cjs:i}=e;if(!o&&!t&&!i)if(a.default.existsSync("tsconfig.json"))t=!0;else{let{type:r}=(0,l.readJSONFileSync)("./package.json")||{};r==="module"?o=!0:i=!0}let s=(r,f)=>{let u=a.default.existsSync(m.default.join(process.cwd(),r));u?u&&e.override?(a.default.writeFileSync(r,f),n.default.ok`**${r}** file is overridden`):n.default.x`**${r}** file already exists`:(a.default.writeFileSync(r,f),n.default.ok`**${r}** file is created`)};o&&s("master.css.mjs",S),t&&s("master.css.ts",y),i&&s("master.css.js",g)});c.command("render").description("Scans HTML and injects generated CSS rules").argument("<source paths>","The path in glob patterns of the source of the HTML file").option("-c --config <path>","The source path of the Master CSS configuration","master.css.*").option("-a --analyze","Analyze injected CSS and HTML size ( brotli ) without writing to file").action(async function(e,o){try{await require("@master/css-renderer/actions/main")(e,o)}catch(t){t.code==="ERR_MODULE_NOT_FOUND"?n.default.i`Please run **npm** **install** **@master/css-renderer** first`:console.error(t)}});c.command("extract").argument("[source paths]","The glob pattern path to extract sources").option("-w, --watch","Watch file changed and generate CSS rules.").option("-o, --output <path>","Specify your CSS file output path").option("-v, --verbose","Verbose logging 0~N","1").option("--options <path>","Specify your extractor options sources","master.css-extractor.*").action(async function(e,o){try{await require("@master/css-extractor/actions/main")(e,o)}catch(t){t.code==="ERR_MODULE_NOT_FOUND"?n.default.i`Please run **npm** **install** **@master/css-extractor** first`:console.error(t)}});c.parse();
+`;var n=p(require("@techor/log")),l=require("@techor/fs"),{version:v,name:j,description:F}=(0,l.readJSONFileSync)(m.default.resolve(__dirname,"../../package.json")),c=new T.Command;c.name(j).description(F).version(v||"0.0.0");c.command("init").description("Initialize definition files for Master CSS").option("-o, --override","Override existing definition file").option("--esm","ES Module .mjs").option("--ts","TypeScript .ts").option("--cjs","CommonJS .js").action(async function(e){let{esm:o,ts:t,cjs:i}=e;if(!o&&!t&&!i)if(a.default.existsSync("tsconfig.json"))t=!0;else{let{type:r}=(0,l.readJSONFileSync)("./package.json")||{};r==="module"?o=!0:i=!0}let s=(r,f)=>{let u=a.default.existsSync(m.default.join(process.cwd(),r));u?u&&e.override?(a.default.writeFileSync(r,f),n.default.ok`**${r}** file is overridden`):n.default.x`**${r}** file already exists`:(a.default.writeFileSync(r,f),n.default.ok`**${r}** file is created`)};o&&s("master.css.mjs",S),t&&s("master.css.ts",y),i&&s("master.css.js",g)});c.command("render").description("Scans HTML and injects generated CSS rules").argument("<source paths>","The path in glob patterns of the source of the HTML file").option("-c --config <path>","The source path of the Master CSS configuration","master.css.*").option("-a --analyze","Analyze injected CSS and HTML size ( brotli ) without writing to file").action(async function(e,o){try{await require("@master/css-renderer/actions/main")(e,o)}catch(t){t.code==="ERR_MODULE_NOT_FOUND"?n.default.i`Please run **npm** **install** **@master/css-renderer** first`:console.error(t)}});c.command("extract").argument("[source paths]","The glob pattern path to extract sources").option("-w, --watch","Watch file changed and generate CSS rules.").option("-o, --output <path>","Specify your CSS file output path").option("-v, --verbose","Verbose logging 0~N","1").option("--options <path>","Specify your extractor options sources","master.css-extractor.*").action(async function(e,o){try{await require("@master/css-extractor/actions/main")(e,o)}catch(t){t.code==="ERR_MODULE_NOT_FOUND"?n.default.i`Please run **npm** **install** **@master/css-extractor** first`:console.error(t)}});c.parse();

package/dist/config/index.d.ts

@@ -8,40 +8,11 @@ import rules from './rules';
 import functions from './functions';
 import { CSSDeclarations } from '../types/css-declarations';
 import type { Rule } from '../rule';
-import { CoreLayer, Layer } from '../layer';
 declare const config: Config;
 export { config, mediaQueries, colors, selectors, semantics, rules, functions, animations, variables };
-export interface RuleOptions {
-    id?: string;
-    match?: RegExp | [string, string[]?];
-    resolvedMatch?: RegExp;
-    resolvedVariables?: any;
-    variables?: Record<string, string | number> | Array<string | number | Record<string, string | number>>;
-    order?: number;
-    separators?: string[];
-    shorthand?: string;
-    colored?: boolean;
-    numeric?: boolean;
-    unit?: any;
-    native?: boolean;
-    declarations?: CSSDeclarations;
-    resolvedPropName?: string;
-    layer?: Layer | CoreLayer;
-    analyze?(this: Rule, className: string): [valueToken: string, prefixToken?: string];
-    transform?(this: Rule, value: string): string;
-    declare?(this: Rule, value: string, unit: string): CSSDeclarations;
-    delete?(this: Rule, className: string): void;
-    create?(this: Rule, className: string): void;
-    insert?(this: Rule): void;
-}
-type VariableValue = number | string | VariableGroup | (number | string)[];
+type Variable = number | string | (number | string)[];
 type VariableGroup = {
-    [key: string]: VariableValue;
-};
-type Variables = {
-    [key in keyof typeof rules]: VariableGroup;
-} | {
-    [key in string]: VariableGroup | VariableValue;
+    [key: string]: Variable;
 };
 export interface Config {
     extends?: (Config | {
@@ -54,7 +25,7 @@ export interface Config {
         [key: string]: string | Config['colors'];
     };
     mediaQueries?: {
-        [key: string]: number | Config['mediaQueries'];
+        [key: string]: number | string | Config['mediaQueries'];
     };
     selectors?: {
         [key: string]: string | string[] | Config['selectors'];
@@ -64,9 +35,13 @@ export interface Config {
     } & {
         [key: string]: CSSDeclarations;
     };
-    variables?: Variables;
+    variables?: {
+        [key in keyof typeof rules]: VariableGroup;
+    } | {
+        [key in string]: VariableGroup | Variable;
+    };
     rules?: {
-        [key in keyof typeof rules | string]?: RuleOptions;
+        [key in keyof typeof rules | string]?: Rule['options'];
     };
     rootSize?: number;
     scope?: string;