dom types parsing

Author: sashafirsov

types/TYPES.md

@@ -0,0 +1,18 @@
+# TypeScript and IDE suggestion for CssChain
+
+CssChain.d.ts uses DOM definitions from
+
+# types generation
+## 1. Generate initial CssChain.d.ts 
+[Creating .d.ts Files from .js files](https://www.typescriptlang.org/docs/handbook/declaration-files/dts-from-js.html)
+
+    npx -p typescript tsc src/*.js --declaration --allowJs --emitDeclarationOnly --outDir types
+## 2. combine whole HTMLElement dependency tree 
+From [typescript/lib/lib.dom.d.ts](https://github.com/microsoft/TypeScript/blob/main/lib/lib.dom.d.ts).
+
+1. Traverse over `lib.dom.d.ts` AST and create the inheritance tree for all interfaces.
+2. From inheritance tree collect all related to HTMLElement as collection of names
+3. by iterating over AST, dump out bodies of the interfaces from collection into DomMixinInterface
+
+#links
+* [Using TypeScript compiler](https://github.com/Microsoft/TypeScript/wiki/Using-the-Compiler-API)

types/ast-parse.js

@@ -0,0 +1,86 @@
+import ts from "typescript";
+
+let checker;
+
+function getParents( node /* ts.ClassDeclaration*/ )
+{
+    if( !node.heritageClauses )
+        return [];
+    let ret = [];
+    node.heritageClauses
+        .filter( clause => clause.token == ts.SyntaxKind.ExtendsKeyword
+                           || clause.token == ts.SyntaxKind.ImplementsKeyword )
+        .map( clause =>
+            clause.types.map( t =>
+            {   let symbol = checker.getSymbolAtLocation( t.expression );
+                symbol && ret.push( checker.getFullyQualifiedName( symbol ) );
+            }));
+    return ret;
+}
+
+const mapInterfaceName2deps = {
+    // HTMLElement: // given for sample
+    //     {
+    //         extends: [ 'Element', 'DocumentAndElementEventHandlers', 'ElementCSSInlineStyle', 'ElementContentEditable', 'GlobalEventHandlers', 'HTMLOrSVGElement' ],
+    //         inheritedBy: [ 'HTMLEmbedElement' ]
+    //     }
+};
+
+const assureMemberAsMap = ( o, field ) => o[field] || ( o[field] = { extends: {}, inheritedBy: {} } );
+
+/**
+ * Prints out particular nodes from a source file
+ *
+ * @param file a path to a file
+ */
+function extract( file )
+{
+    // Create a Program to represent the project, then pull out the
+    // source file to parse its AST.
+    let program = ts.createProgram( [ file ], { allowJs: true } );
+    checker = program.getTypeChecker();
+
+    const sourceFile = program.getSourceFile( file );
+    // To print the AST, we'll use TypeScript's printer
+    const printer = ts.createPrinter( { newLine: ts.NewLineKind.LineFeed } );
+    // To give constructive error messages, keep track of found and un-found identifiers
+    const foundNodes = [];
+    // Loop through the root AST nodes of the file
+    // @ts-ignore
+    ts.forEachChild( sourceFile, node =>
+    {
+        let name = "";
+        // This is an incomplete set of AST nodes which could have a top level identifier
+        // it's left to you to expand this list, which you can do by using
+        // https://ts-ast-viewer.com/ to see the AST of a file then use the same patterns
+        // as below
+        if( ts.isFunctionDeclaration( node ) )
+        {
+            // @ts-ignore
+            name = node.name.text;
+            // Hide the method body when printing
+            // @ts-ignore
+            node.body = undefined;
+        }else if( ts.isVariableStatement( node ) )
+        {
+            name = node.declarationList.declarations[ 0 ].name.getText( sourceFile );
+        }else if( ts.isInterfaceDeclaration( node ) )
+        {
+            name = node.name.text;
+            foundNodes.push( [ name, node ] );
+            let deps = assureMemberAsMap( mapInterfaceName2deps, name );
+            const classes = getParents( node );
+            classes.map( c =>
+            {
+                deps.extends[ c ] = 1;
+                assureMemberAsMap( mapInterfaceName2deps, c ).inheritedBy[name]=1;
+            } );
+        }
+    } );
+}
+
+// Run the extract function with the script's arguments
+// extract(process.argv[2], process.argv.slice(3));
+extract( "node_modules/typescript/lib/lib.dom.d.ts" );
+const interfaces = Object.keys(mapInterfaceName2deps);
+console.log( mapInterfaceName2deps );