CoLI

Computer Language Interface (node, dart, css, html, python) An AST Builder / Parser

design file available here

Installation

yarn add coli

Supported platforms

• NodeJS

Builders

Read BUILDERS.md

Supported gen target languages

• JSX / TSX
• JS / TS
• Dart (+ Flutter)
• CSS
• SCSS
• XML
• HTML

Try the demo

CoLI Node implementation.

jsx building

div(div("content"))

>>> <div>
>>>   <div>
>>>     content
>>>   </div>
>>> </div>

dart variable declaration

const file = new File("main.dart")
file.add(Variable.const("someVariable", "hi there!", CoLITypes.String))

// main.dart
>>> final String someVariable = "hi there!";

to check work around for generating flutter code - checkout @flutter-builder

Function

build function with coli syntax

// 1.

function thisIsNativeFunction() {}

const coliFunc = coli.function(thisIsNativeFunction);

coliFunc.toDart();
// > void thisIsNativeFunction(){}
coliFunc.toPython({ followConvention: true });
// > def this_is_native_function(): ...
coliFunc.toJavascript();
// > function thisIsNativeFunction(){}

// 2.
const coliFunc = new coli.Function({
  returns: coli.Types.void,
  name: "thisIsGeneratedFunction",
  params: {
    first: {
      required: false,
      type: coli.Types.any,
    },
  },
  executable: coli.Executable.fromStatic("console.log('hi there.');"),
});
coliFunc.toJavascript();
// > function thisIsGeneratedFunction(first){ console.log('hi there.'); }

Development

# packs the workspace
yarn
# runs the editor webapp
yarn editor

Building - coli use lerna to build packages. running yarn build will build individual packages.

yarn build

References

• https://astexplorer.net/
• https://github.com/acornjs/acorn
• ts-ast-viewer.com
• https://github.com/benjamn/ast-types
• https://en.wikipedia.org/wiki/Abstract-Type_and_Scheme-Definition_Language
• https://docs.python.org/3/library/ast.html
• https://github.com/estree/estree
• https://github.com/benjamn/ast-types
• https://github.com/tc39/proposals
• https://doc.esdoc.org/github.com/mason-lang/esast/class/src/ast.js~ImportSpecifier.html
• https://github.com/facebook/jsx/blob/master/AST.md
• https://github.com/acornjs/acorn-jsx
• https://www.typescriptlang.org/docs/handbook/jsx.html
• https://github.com/github/codeql
• https://github.com/csstree/csstree
• https://github.com/davidbonnet/astring
• https://shift-ast.org/
• https://github.com/estree/estree/blob/master/es5.md
• https://github.com/csstree/csstree/blob/master/docs/generate.md#generateast-options
• https://github.com/frenic/csstype
• https://github.com/mdn/data
• https://pub.dev/documentation/analyzer/latest/dart_ast_ast_factory/dart_ast_ast_factory-library.html
• https://pub.dev/documentation/analyzer/latest/dart_ast_ast/dart_ast_ast-library.html
• https://github.com/Microsoft/TypeScript/wiki/Using-the-Compiler-API
• https://github.com/ktsn/ts-compiler-api-examples
• https://learning-notes.mistermicheels.com/javascript/typescript/compiler-api/
• https://github.com/grommet/jsx-to-string
• https://github.com/babel/babel
• https://github.com/unifiedjs/unified
• https://github.com/remarkjs/remark