Add CLI definitions; CLI restructure

cli/asc.d.ts

@@ -0,0 +1,118 @@
+/** Whether this is a webpack bundle or not. */
+export const isBundle: boolean;
+
+/** Whether asc runs the sources directly or not. */
+export const isDev: boolean;
+
+/** AssemblyScript version. */
+export const version: string;
+
+/** Command line option description. */
+export interface OptionDescription {
+  /** Textual description. */
+  description: string | string[];
+  /** Option type, e.g. `string`. */
+  type: string;
+  /** Option aliases, if any. */
+  aliases?: string[];
+}
+
+/** Available CLI options. */
+export const options: { [key: string]: OptionDescription };
+
+/** Common root used in source maps. */
+export var sourceMapRoot: string;
+
+/** Prefix used for library files. */
+export var libraryPrefix: string;
+
+/** Default Binaryen optimization level. */
+export var defaultOptimizeLevel: number;
+
+/** Default Binaryen shrink level. */
+export var defaultShrinkLevel: number;
+
+/** Bundled library files. */
+export const libraryFiles: { [key: string]: string };
+
+/** Bundled definition files. */
+export const definitionFiles: { assembly: string, portable: string };
+
+/** A compatible output stream. */
+export interface OutputStream {
+  /** Writes another chunk of data to the stream. */
+  write(chunk: Uint8Array | string): void;
+  /** Converts the output to a buffer. */
+  toBuffer(): Uint8Array;
+  /** Converts the output to a string. */
+  toString(): string;
+}
+
+/** Compiler API options. */
+interface CompilerOptions {
+  /** Standard output stream to use. */
+  stdout?: OutputStream;
+  /** Standard error stream to use. */
+  stderr?: OutputStream;
+  /** Reads a file from disk (or memory). */
+  readFile?: (name: string) => string | null;
+  /** Writes a file to disk (or memory). */
+  writeFile?: (name: string, contents: Uint8Array) => void;
+  /** Lists all files within a directory. */
+  listFiles?: (dir: string) => string[] | null;
+}
+
+/** Convenience function that parses and compiles source strings directly. */
+export function compileString(sources: { [key: string]: string } | string, options?: CompilerOptions): {
+  /** Standard output. */
+  stdout: OutputStream,
+  /** Standard error. */
+  stderr: OutputStream,
+  /** Emitted binary. */
+  binary: Uint8Array | null,
+  /** Emitted text format. */
+  text: string | null
+}
+
+/** Runs the command line utility using the specified arguments array. */
+export function main(argv: string[], options: CompilerOptions, callback?: (err: Error | null) => number): number;
+export function main(argv: string[], callback?: (err: Error | null) => number): number;
+
+/** Checks diagnostics emitted so far for errors. */
+export function checkDiagnostics(emitter: any, stderr?: OutputStream): boolean;
+
+/** An object of stats for the current task. */
+export interface Stats {
+  readTime: number,
+  readCount: number,
+  writeTime: number,
+  writeCount: number,
+  parseTime: number,
+  parseCount: number,
+  compileTime: number,
+  compileCount: number,
+  emitTime: number,
+  emitCount: number,
+  validateTime: number,
+  validateCount: number,
+  optimizeTime: number,
+  optimizeCount: number
+}
+
+/** Creates an empty set of stats. */
+export function createStats(): Stats;
+
+/** Measures the execution time of the specified function.  */
+export function measure(fn: Function): number;
+
+/** Formats a high resolution time to a human readable string. */
+export function formatTime(time: number): string;
+
+/** Formats and prints out the contents of a set of stats. */
+export function printStats(stats: Stats, output: OutputStream): void;
+
+/** Creates a memory stream that can be used in place of stdout/stderr. */
+export function createMemoryStream(fn?: (chunk: Uint8Array | string) => void): OutputStream;
+
+/** Compatible TypeScript compiler options for syntax highlighting etc. */
+export const tscOptions: { [key: string]: any };