feat!(core/ast): custom debugger and ast refractor

Author: littledivy

ast/ast.ts

@@ -0,0 +1,10 @@
+import { Rule } from "./node.ts";
+
+type Type = "stylesheet";
+
+export interface AST {
+  type: Type;
+  stylesheet: {
+    rules: Rule[];
+  };
+}

ast/mod.ts

@@ -0,0 +1,3 @@
+export * from "./ast.ts"
+export * from "./node.ts"
+export * from "./token.ts"

ast/node.ts

@@ -0,0 +1,11 @@
+export interface Rule {
+  type: "rule";
+  selectors: string[];
+  declarations: Decl[];
+}
+
+export interface Decl {
+  type?: string;
+  name?: string;
+  value?: string;
+}

ast/token.ts

@@ -0,0 +1,18 @@
+export interface Position {
+  line: number;
+  col: number;
+}
+
+export interface Token {
+  type?: string;
+  start?: Position;
+  end?: Position;
+  position?: {
+    start?: Position;
+    end?: Position;
+  };
+  prefix?: string;
+  name?: string;
+  text?: string;
+  value?: string;
+}

lexer/lexer.ts core/lexer/lexer.tslexer/lexer.ts renamed to core/lexer/lexer.ts

@@ -1,8 +1,5 @@
-var DEBUG = false; // `true` to print debugging info.
-var TIMER = false; // `true` to time calls to `lex()` and print the results.
-
-import dbg from "../debug.js";
-import { Token } from "../types.ts";
+import dbg from "../../debug.js";
+import { Token } from "../../types.ts";
 
 let debug = dbg("lex");
 
@@ -187,7 +184,7 @@ export function lex(css: string): Token[] {
       col: column,
     };
 
-    DEBUG && debug("addToken:", JSON.stringify(token, null, 2));
+    debug("addToken:", JSON.stringify(token, null, 2));
 
     tokens.push(token);
 
@@ -222,10 +219,10 @@ export function lex(css: string): Token[] {
   since the total number of cases is very low.
   */
 
-  TIMER && (start = Date.now());
+  start = Date.now();
 
   while (ch = getCh()) {
-    DEBUG && debug(ch, getState());
+    debug(ch, getState());
 
     // column += 1;
 
@@ -686,7 +683,7 @@ export function lex(css: string): Token[] {
     }
   }
 
-  TIMER && debug("ran in", (Date.now() - start) + "ms");
+  debug("ran in", (Date.now() - start) + "ms");
 
   return tokens;
 }

parser/parser.ts core/parser/parser.tsparser/parser.ts renamed to core/parser/parser.ts

@@ -1,11 +1,8 @@
-var DEBUG = false; // `true` to print debugging info.
-var TIMER = false; // `true` to time calls to `parse()` and print the results.
-
-import dbg from "../debug.js";
+import dbg from "../../debug.js";
 let debug = dbg("parse");
 
 import { lex } from "../lexer/lexer.ts";
-import { AST, Token } from "../types.ts";
+import { AST, Token } from "../../types.ts";
 
 var _comments: boolean; // Whether comments are allowed.
 var _depth: number; // Current block nesting depth.
@@ -36,14 +33,14 @@ export function parse(css: string | any[], options: any): AST {
   var rules = [];
   var token;
 
-  TIMER && (start = Date.now());
+  start = Date.now();
 
   while ((token = next())) {
     rule = parseToken(token);
     rule && rules.push(rule);
   }
 
-  TIMER && debug("ran in", (Date.now() - start) + "ms");
+  debug("ran in", (Date.now() - start) + "ms");
 
   return {
     type: "stylesheet",
@@ -95,7 +92,7 @@ function astNode(token: Token, overrd?: any): Token {
     };
   }
 
-  DEBUG && debug("astNode:", JSON.stringify(node, null, 2));
+  debug("astNode:", JSON.stringify(node, null, 2));
 
   return node;
 }
@@ -107,7 +104,7 @@ function astNode(token: Token, overrd?: any): Token {
  */
 function next() {
   var token = _tokens.shift();
-  DEBUG && debug("next:", JSON.stringify(token, null, 2));
+  debug("next:", JSON.stringify(token, null, 2));
   return token;
 }
 
@@ -249,7 +246,7 @@ function parseToken(token: any): any {
       return parseAtGroup(token);
   }
 
-  DEBUG && debug("parseToken: unexpected token:", JSON.stringify(token));
+  debug("parseToken: unexpected token:", JSON.stringify(token));
 }
 
 // -- Parse Helper Functions ---------------------------------------------------

debug.js

@@ -1,8 +1,9 @@
 function debug(label) {
-  return _debug.bind(null, label);
+    return _debug.bind(null, label);
 }
 
 function _debug(label) {
+  if (!window.DEBUG) return;
   var args = [].slice.call(arguments, 1);
   args.unshift("[" + label + "]");
   Deno.core.print(args.join(" ") + "\n");

example.ts

@@ -0,0 +1,3 @@
+import { parse } from "./core/parser/parser.ts";
+var ast = parse("p { color: black; }", {});
+console.log(ast);