@teambit/compiler 0.0.553 → 0.0.557

package/dist/compiler.main.runtime.d.ts

@@ -5,6 +5,7 @@ import { Component } from '@teambit/component';
 import { EnvsMain } from '@teambit/envs';
 import { BitId } from '@teambit/legacy-bit-id';
 import { LoggerMain } from '@teambit/logger';
+import { GeneratorMain } from '@teambit/generator';
 import { PubsubMain } from '@teambit/pubsub';
 import { UiMain } from '@teambit/ui';
 import { Workspace } from '@teambit/workspace';
@@ -18,13 +19,24 @@ export declare class CompilerMain {
     private envs;
     private builder;
     constructor(pubsub: PubsubMain, workspaceCompiler: WorkspaceCompiler, envs: EnvsMain, builder: BuilderMain);
-    compileOnWorkspace(componentsIds?: string[] | BitId[], options?: CompileOptions): Promise<import("./workspace-compiler").BuildResult[]>;
+    /**
+     * Run compilation on `bit new` and when new components are imported
+     */
+    compileOnWorkspace(componentsIds?: string[] | BitId[], // when empty, it compiles all
+    options?: CompileOptions): Promise<import("./workspace-compiler").BuildResult[]>;
+    /**
+     * API to create a new compiler task, it facilitates the usage of multiple compilers.
+     * with this method you can create any number of compilers and add them to the buildPipeline.
+     */
     createTask(name: string, compiler: Compiler): CompilerTask;
+    /**
+     * find the compiler configured on the workspace and ask for the dist path.
+     */
     getDistPathBySrcPath(component: Component, srcPath: string): string | null;
     getDistsFiles(component: Component): Promise<DistArtifact>;
     static runtime: import("@teambit/harmony").RuntimeDefinition;
     static dependencies: import("@teambit/harmony").Aspect[];
-    static provider([cli, workspace, envs, loggerMain, pubsub, aspectLoader, builder, ui]: [
+    static provider([cli, workspace, envs, loggerMain, pubsub, aspectLoader, builder, ui, generator]: [
         CLIMain,
         Workspace,
         EnvsMain,
@@ -32,6 +44,7 @@ export declare class CompilerMain {
         PubsubMain,
         AspectLoaderMain,
         BuilderMain,
-        UiMain
+        UiMain,
+        GeneratorMain
     ]): Promise<CompilerMain>;
 }

package/dist/compiler.main.runtime.js

@@ -81,6 +81,16 @@ function _logger() {
   return data;
 }
 
+function _generator() {
+  const data = require("@teambit/generator");
+
+  _generator = function () {
+    return data;
+  };
+
+  return data;
+}
+
 function _pubsub() {
   const data = require("@teambit/pubsub");
 
@@ -191,6 +201,16 @@ function _workspaceCompiler() {
   return data;
 }
 
+function _compiler5() {
+  const data = require("./templates/compiler");
+
+  _compiler5 = function () {
+    return data;
+  };
+
+  return data;
+}
+
 class CompilerMain {
   constructor(pubsub, workspaceCompiler, envs, builder) {
     this.pubsub = pubsub;
@@ -238,12 +258,13 @@ class CompilerMain {
     return new (_distArtifact().DistArtifact)(artifacts);
   }
 
-  static async provider([cli, workspace, envs, loggerMain, pubsub, aspectLoader, builder, ui]) {
+  static async provider([cli, workspace, envs, loggerMain, pubsub, aspectLoader, builder, ui, generator]) {
     const logger = loggerMain.createLogger(_compiler().CompilerAspect.id);
     const workspaceCompiler = new (_workspaceCompiler().WorkspaceCompiler)(workspace, envs, pubsub, aspectLoader, ui, logger);
     envs.registerService(new (_compiler3().CompilerService)());
     const compilerMain = new CompilerMain(pubsub, workspaceCompiler, envs, builder);
     cli.register(new (_compiler2().CompileCmd)(workspaceCompiler, logger, pubsub));
+    generator.registerComponentTemplate([_compiler5().compilerTemplate]);
     _manyComponentsWriter().default.externalCompiler = compilerMain.compileOnWorkspace.bind(compilerMain);
     return compilerMain;
   }
@@ -252,7 +273,7 @@ class CompilerMain {
 
 exports.CompilerMain = CompilerMain;
 (0, _defineProperty2().default)(CompilerMain, "runtime", _cli().MainRuntime);
-(0, _defineProperty2().default)(CompilerMain, "dependencies", [_cli().CLIAspect, _workspace().WorkspaceAspect, _envs().EnvsAspect, _logger().LoggerAspect, _pubsub().PubsubAspect, _aspectLoader().default, _builder().BuilderAspect, _ui().default]);
+(0, _defineProperty2().default)(CompilerMain, "dependencies", [_cli().CLIAspect, _workspace().WorkspaceAspect, _envs().EnvsAspect, _logger().LoggerAspect, _pubsub().PubsubAspect, _aspectLoader().default, _builder().BuilderAspect, _ui().default, _generator().GeneratorAspect]);
 
 _compiler().CompilerAspect.addRuntime(CompilerMain);
 

package/dist/compiler.main.runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["compiler.main.runtime.ts"],"names":["CompilerMain","constructor","pubsub","workspaceCompiler","envs","builder","compileOnWorkspace","componentsIds","options","initiator","CompilationInitiator","ComponentAdded","compileComponents","createTask","name","compiler","CompilerTask","CompilerAspect","id","getDistPathBySrcPath","component","srcPath","environment","getEnv","env","compilerInstance","getCompiler","getDistsFiles","artifacts","getArtifactsVinylByExtension","length","DistArtifactNotFound","DistArtifact","provider","cli","workspace","loggerMain","aspectLoader","ui","logger","createLogger","WorkspaceCompiler","registerService","CompilerService","compilerMain","register","CompileCmd","ManyComponentsWriter","externalCompiler","bind","MainRuntime","CLIAspect","WorkspaceAspect","EnvsAspect","LoggerAspect","PubsubAspect","AspectLoaderAspect","BuilderAspect","UIAspect","addRuntime"],"mappings":"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","sourcesContent":["import AspectLoaderAspect, { AspectLoaderMain } from '@teambit/aspect-loader';\nimport { BuilderAspect, BuilderMain } from '@teambit/builder';\nimport { CLIAspect, CLIMain, MainRuntime } from '@teambit/cli';\nimport { Component } from '@teambit/component';\nimport { EnvsAspect, EnvsMain } from '@teambit/envs';\nimport { BitId } from '@teambit/legacy-bit-id';\n\nimport ManyComponentsWriter from '@teambit/legacy/dist/consumer/component-ops/many-components-writer';\nimport { LoggerAspect, LoggerMain } from '@teambit/logger';\nimport { PubsubAspect, PubsubMain } from '@teambit/pubsub';\nimport UIAspect, { UiMain } from '@teambit/ui';\nimport { Workspace, WorkspaceAspect } from '@teambit/workspace';\nimport { CompilerAspect } from './compiler.aspect';\nimport { CompileCmd } from './compiler.cmd';\nimport { CompilerService } from './compiler.service';\nimport { CompilerTask } from './compiler.task';\nimport { DistArtifact } from './dist-artifact';\nimport { DistArtifactNotFound } from './exceptions';\nimport { CompilationInitiator, Compiler } from './types';\nimport { CompileOptions, WorkspaceCompiler } from './workspace-compiler';\n\nexport class CompilerMain {\n  constructor(\n    private pubsub: PubsubMain,\n    private workspaceCompiler: WorkspaceCompiler,\n    private envs: EnvsMain,\n    private builder: BuilderMain\n  ) {}\n\n  /**\n   * Run compilation on `bit new` and when new components are imported\n   */\n  compileOnWorkspace(\n    componentsIds: string[] | BitId[] = [], // when empty, it compiles all\n    options: CompileOptions = { initiator: CompilationInitiator.ComponentAdded }\n  ) {\n    return this.workspaceCompiler.compileComponents(componentsIds, options);\n  }\n  /**\n   * API to create a new compiler task, it facilitates the usage of multiple compilers.\n   * with this method you can create any number of compilers and add them to the buildPipeline.\n   */\n  createTask(name: string, compiler: Compiler): CompilerTask {\n    return new CompilerTask(CompilerAspect.id, name, compiler);\n  }\n\n  /**\n   * find the compiler configured on the workspace and ask for the dist path.\n   */\n  getDistPathBySrcPath(component: Component, srcPath: string): string | null {\n    const environment = this.envs.getEnv(component).env;\n    const compilerInstance = environment.getCompiler?.();\n    if (!compilerInstance) return null;\n    return compilerInstance.getDistPathBySrcPath(srcPath);\n  }\n\n  async getDistsFiles(component: Component): Promise<DistArtifact> {\n    const artifacts = await this.builder.getArtifactsVinylByExtension(component, CompilerAspect.id);\n    if (!artifacts.length) throw new DistArtifactNotFound(component.id);\n\n    return new DistArtifact(artifacts);\n  }\n\n  static runtime = MainRuntime;\n\n  static dependencies = [\n    CLIAspect,\n    WorkspaceAspect,\n    EnvsAspect,\n    LoggerAspect,\n    PubsubAspect,\n    AspectLoaderAspect,\n    BuilderAspect,\n    UIAspect,\n  ];\n\n  static async provider([cli, workspace, envs, loggerMain, pubsub, aspectLoader, builder, ui]: [\n    CLIMain,\n    Workspace,\n    EnvsMain,\n    LoggerMain,\n    PubsubMain,\n    AspectLoaderMain,\n    BuilderMain,\n    UiMain\n  ]) {\n    const logger = loggerMain.createLogger(CompilerAspect.id);\n    const workspaceCompiler = new WorkspaceCompiler(workspace, envs, pubsub, aspectLoader, ui, logger);\n    envs.registerService(new CompilerService());\n    const compilerMain = new CompilerMain(pubsub, workspaceCompiler, envs, builder);\n    cli.register(new CompileCmd(workspaceCompiler, logger, pubsub));\n\n    ManyComponentsWriter.externalCompiler = compilerMain.compileOnWorkspace.bind(compilerMain);\n\n    return compilerMain;\n  }\n}\n\nCompilerAspect.addRuntime(CompilerMain);\n"]}
+{"version":3,"sources":["compiler.main.runtime.ts"],"names":["CompilerMain","constructor","pubsub","workspaceCompiler","envs","builder","compileOnWorkspace","componentsIds","options","initiator","CompilationInitiator","ComponentAdded","compileComponents","createTask","name","compiler","CompilerTask","CompilerAspect","id","getDistPathBySrcPath","component","srcPath","environment","getEnv","env","compilerInstance","getCompiler","getDistsFiles","artifacts","getArtifactsVinylByExtension","length","DistArtifactNotFound","DistArtifact","provider","cli","workspace","loggerMain","aspectLoader","ui","generator","logger","createLogger","WorkspaceCompiler","registerService","CompilerService","compilerMain","register","CompileCmd","registerComponentTemplate","compilerTemplate","ManyComponentsWriter","externalCompiler","bind","MainRuntime","CLIAspect","WorkspaceAspect","EnvsAspect","LoggerAspect","PubsubAspect","AspectLoaderAspect","BuilderAspect","UIAspect","GeneratorAspect","addRuntime"],"mappings":"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","sourcesContent":["import AspectLoaderAspect, { AspectLoaderMain } from '@teambit/aspect-loader';\nimport { BuilderAspect, BuilderMain } from '@teambit/builder';\nimport { CLIAspect, CLIMain, MainRuntime } from '@teambit/cli';\nimport { Component } from '@teambit/component';\nimport { EnvsAspect, EnvsMain } from '@teambit/envs';\nimport { BitId } from '@teambit/legacy-bit-id';\n\nimport ManyComponentsWriter from '@teambit/legacy/dist/consumer/component-ops/many-components-writer';\nimport { LoggerAspect, LoggerMain } from '@teambit/logger';\nimport { GeneratorAspect, GeneratorMain } from '@teambit/generator';\nimport { PubsubAspect, PubsubMain } from '@teambit/pubsub';\nimport UIAspect, { UiMain } from '@teambit/ui';\nimport { Workspace, WorkspaceAspect } from '@teambit/workspace';\nimport { CompilerAspect } from './compiler.aspect';\nimport { CompileCmd } from './compiler.cmd';\nimport { CompilerService } from './compiler.service';\nimport { CompilerTask } from './compiler.task';\nimport { DistArtifact } from './dist-artifact';\nimport { DistArtifactNotFound } from './exceptions';\nimport { CompilationInitiator, Compiler } from './types';\nimport { CompileOptions, WorkspaceCompiler } from './workspace-compiler';\nimport { compilerTemplate } from './templates/compiler';\n\nexport class CompilerMain {\n  constructor(\n    private pubsub: PubsubMain,\n    private workspaceCompiler: WorkspaceCompiler,\n    private envs: EnvsMain,\n    private builder: BuilderMain\n  ) {}\n\n  /**\n   * Run compilation on `bit new` and when new components are imported\n   */\n  compileOnWorkspace(\n    componentsIds: string[] | BitId[] = [], // when empty, it compiles all\n    options: CompileOptions = { initiator: CompilationInitiator.ComponentAdded }\n  ) {\n    return this.workspaceCompiler.compileComponents(componentsIds, options);\n  }\n  /**\n   * API to create a new compiler task, it facilitates the usage of multiple compilers.\n   * with this method you can create any number of compilers and add them to the buildPipeline.\n   */\n  createTask(name: string, compiler: Compiler): CompilerTask {\n    return new CompilerTask(CompilerAspect.id, name, compiler);\n  }\n\n  /**\n   * find the compiler configured on the workspace and ask for the dist path.\n   */\n  getDistPathBySrcPath(component: Component, srcPath: string): string | null {\n    const environment = this.envs.getEnv(component).env;\n    const compilerInstance = environment.getCompiler?.();\n    if (!compilerInstance) return null;\n    return compilerInstance.getDistPathBySrcPath(srcPath);\n  }\n\n  async getDistsFiles(component: Component): Promise<DistArtifact> {\n    const artifacts = await this.builder.getArtifactsVinylByExtension(component, CompilerAspect.id);\n    if (!artifacts.length) throw new DistArtifactNotFound(component.id);\n\n    return new DistArtifact(artifacts);\n  }\n\n  static runtime = MainRuntime;\n\n  static dependencies = [\n    CLIAspect,\n    WorkspaceAspect,\n    EnvsAspect,\n    LoggerAspect,\n    PubsubAspect,\n    AspectLoaderAspect,\n    BuilderAspect,\n    UIAspect,\n    GeneratorAspect\n  ];\n\n  static async provider([cli, workspace, envs, loggerMain, pubsub, aspectLoader, builder, ui, generator]: [\n    CLIMain,\n    Workspace,\n    EnvsMain,\n    LoggerMain,\n    PubsubMain,\n    AspectLoaderMain,\n    BuilderMain,\n    UiMain,\n    GeneratorMain\n  ]) {\n    const logger = loggerMain.createLogger(CompilerAspect.id);\n    const workspaceCompiler = new WorkspaceCompiler(workspace, envs, pubsub, aspectLoader, ui, logger);\n    envs.registerService(new CompilerService());\n    const compilerMain = new CompilerMain(pubsub, workspaceCompiler, envs, builder);\n    cli.register(new CompileCmd(workspaceCompiler, logger, pubsub));\n    generator.registerComponentTemplate([compilerTemplate]);\n    ManyComponentsWriter.externalCompiler = compilerMain.compileOnWorkspace.bind(compilerMain);\n\n    return compilerMain;\n  }\n}\n\nCompilerAspect.addRuntime(CompilerMain);\n"]}

package/dist/compiler.task.d.ts

@@ -1,6 +1,9 @@
 import { BuildContext, BuiltTaskResult, BuildTask, TaskResultsList } from '@teambit/builder';
 import { Capsule } from '@teambit/isolator';
 import { Compiler } from './types';
+/**
+ * compiler build task. Allows to compile components during component build.
+ */
 export declare class CompilerTask implements BuildTask {
     readonly aspectId: string;
     readonly name: string;

package/dist/templates/compiler/files/aspect-file.d.ts

@@ -0,0 +1,2 @@
+import { ComponentContext } from '@teambit/generator';
+export declare function aspectFile({ namePascalCase, componentId }: ComponentContext): string;

package/dist/templates/compiler/files/aspect-file.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.aspectFile = aspectFile;
+
+function aspectFile({
+  namePascalCase,
+  componentId
+}) {
+  return `import { Aspect } from '@teambit/harmony';
+
+export const ${namePascalCase}Aspect = Aspect.create({
+  id: '${componentId}',
+});
+  `;
+}
+
+//# sourceMappingURL=aspect-file.js.map

package/dist/templates/compiler/files/aspect-file.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["aspect-file.ts"],"names":["aspectFile","namePascalCase","componentId"],"mappings":";;;;;;;AAEO,SAASA,UAAT,CAAoB;AAAEC,EAAAA,cAAF;AAAkBC,EAAAA;AAAlB,CAApB,EAAuE;AAC5E,SAAQ;AACV;AACA,eAAeD,cAAe;AAC9B,SAASC,WAAY;AACrB;AACA,GALE;AAMD","sourcesContent":["import { ComponentContext } from '@teambit/generator';\n\nexport function aspectFile({ namePascalCase, componentId }: ComponentContext) {\n  return `import { Aspect } from '@teambit/harmony';\n\nexport const ${namePascalCase}Aspect = Aspect.create({\n  id: '${componentId}',\n});\n  `;\n}\n"]}

package/dist/templates/compiler/files/compiler-file.d.ts

@@ -0,0 +1,2 @@
+import { ComponentContext } from '@teambit/generator';
+export declare function compilerFile({ namePascalCase }: ComponentContext): string;

package/dist/templates/compiler/files/compiler-file.js

@@ -0,0 +1,84 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.compilerFile = compilerFile;
+
+function compilerFile({
+  namePascalCase
+}) {
+  return `import {
+  BuildContext,
+  BuiltTaskResult,
+  ComponentResult,
+} from '@teambit/builder';
+import {
+  Compiler,
+  CompilerMain,
+  TranspileFileParams,
+  TranspileFileOutput,
+} from '@teambit/compiler';
+
+export class ${namePascalCase} implements Compiler {
+
+    constructor(readonly id: string, readonly distDir, private compiler: CompilerMain) {}
+
+    /**
+     * Detemines whether unsupported files (such as assets)
+     * should be copied by Compiler aspect into the 'dist' directory
+     */
+    shouldCopyNonSupportedFiles = true;
+
+    /* The name of the compiler being used. For example, TypeScript, Babel, etc. */
+    displayName = '';
+
+    /* The version of the compiler being used. For example '1.0.0' */
+    version(): string {};
+
+    /**
+     * Use this for compilation in the workspace.
+     * This will compile one file content at a time (alternatively, use 'transpileComponent') */
+    transpileFile( fileContent: string, transpileFileParams: TranspileFileParams): TranspileFileOutput {}
+
+
+    async build(context: BuildContext): Promise<BuiltTaskResult> {
+        let componentsResults: ComponentResult[] = [];
+        return {
+            /* Sets the files to persist as the Component's artifacts,
+            and describes them. */
+            artifacts: [
+                {
+                    generatedBy: this.id,
+                    name: 'compilation output',
+                    globPatterns: [\`\${this.distDir}/**\`],
+                },
+            ],
+             componentsResults,
+        };
+    }
+
+    /* This is optional but recommended.
+    Not using it will require consumers of your compiler to use two APIs and have two depndencies
+    to their Envs - your compiler
+    */
+    createTask() {
+        return this.compiler.createTask('${namePascalCase}', this);
+    }
+
+    /**
+     * Given a source file, return its parallel in the dists. e.g. index.ts => dist/index.js.
+     * Needed by aspects such as Pkg to determine the main prop.
+     */
+    getDistPathBySrcPath(srcPath: string): string {}
+
+    /**
+     * Returns a boolean indicating whether a file is supported by the compiler or not.
+     * For example, this API is used by Compiler aspect to copy unsupported files to the dist directory.
+     */
+    isFileSupported(filePath: string): boolean {}
+}
+  `;
+}
+
+//# sourceMappingURL=compiler-file.js.map

package/dist/templates/compiler/files/compiler-file.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["compiler-file.ts"],"names":["compilerFile","namePascalCase"],"mappings":";;;;;;;AAEO,SAASA,YAAT,CAAsB;AAAEC,EAAAA;AAAF,CAAtB,EAA4D;AACjE,SAAQ;AACV;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAeA,cAAe;AAC9B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,2CAA2CA,cAAe;AAC1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,GAtEE;AAuED","sourcesContent":["import { ComponentContext } from '@teambit/generator';\n\nexport function compilerFile({ namePascalCase }: ComponentContext) {\n  return `import {\n  BuildContext,\n  BuiltTaskResult,\n  ComponentResult,\n} from '@teambit/builder';\nimport {\n  Compiler,\n  CompilerMain,\n  TranspileFileParams,\n  TranspileFileOutput,\n} from '@teambit/compiler';\n\nexport class ${namePascalCase} implements Compiler {\n\n    constructor(readonly id: string, readonly distDir, private compiler: CompilerMain) {}\n\n    /**\n     * Detemines whether unsupported files (such as assets)\n     * should be copied by Compiler aspect into the 'dist' directory\n     */\n    shouldCopyNonSupportedFiles = true;\n\n    /* The name of the compiler being used. For example, TypeScript, Babel, etc. */\n    displayName = '';\n\n    /* The version of the compiler being used. For example '1.0.0' */\n    version(): string {};\n\n    /**\n     * Use this for compilation in the workspace.\n     * This will compile one file content at a time (alternatively, use 'transpileComponent') */\n    transpileFile( fileContent: string, transpileFileParams: TranspileFileParams): TranspileFileOutput {}\n\n\n    async build(context: BuildContext): Promise<BuiltTaskResult> {\n        let componentsResults: ComponentResult[] = [];\n        return {\n            /* Sets the files to persist as the Component's artifacts,\n            and describes them. */\n            artifacts: [\n                {\n                    generatedBy: this.id,\n                    name: 'compilation output',\n                    globPatterns: [\\`\\${this.distDir}/**\\`],\n                },\n            ],\n             componentsResults,\n        };\n    }\n\n    /* This is optional but recommended.\n    Not using it will require consumers of your compiler to use two APIs and have two depndencies\n    to their Envs - your compiler\n    */\n    createTask() {\n        return this.compiler.createTask('${namePascalCase}', this);\n    }\n\n    /**\n     * Given a source file, return its parallel in the dists. e.g. index.ts => dist/index.js.\n     * Needed by aspects such as Pkg to determine the main prop.\n     */\n    getDistPathBySrcPath(srcPath: string): string {}\n\n    /**\n     * Returns a boolean indicating whether a file is supported by the compiler or not.\n     * For example, this API is used by Compiler aspect to copy unsupported files to the dist directory.\n     */\n    isFileSupported(filePath: string): boolean {}\n}\n  `;\n}\n"]}

package/dist/templates/compiler/files/index-file.d.ts

@@ -0,0 +1,2 @@
+import { ComponentContext } from '@teambit/generator';
+export declare function indexFile({ namePascalCase, name }: ComponentContext): string;

package/dist/templates/compiler/files/index-file.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.indexFile = indexFile;
+
+function indexFile({
+  namePascalCase,
+  name
+}) {
+  return `import { ${namePascalCase}Aspect } from './${name}.aspect';
+
+export type { ${namePascalCase}Main } from './${name}.main.runtime';
+export default ${namePascalCase}Aspect;
+export { ${namePascalCase}Aspect };
+`;
+}
+
+//# sourceMappingURL=index-file.js.map

package/dist/templates/compiler/files/index-file.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["index-file.ts"],"names":["indexFile","namePascalCase","name"],"mappings":";;;;;;;AAEO,SAASA,SAAT,CAAmB;AAAEC,EAAAA,cAAF;AAAkBC,EAAAA;AAAlB,CAAnB,EAA+D;AACpE,SAAQ,YAAWD,cAAe,oBAAmBC,IAAK;AAC5D;AACA,gBAAgBD,cAAe,kBAAiBC,IAAK;AACrD,iBAAiBD,cAAe;AAChC,WAAWA,cAAe;AAC1B,CALE;AAMD","sourcesContent":["import { ComponentContext } from '@teambit/generator';\n\nexport function indexFile({ namePascalCase, name }: ComponentContext) {\n  return `import { ${namePascalCase}Aspect } from './${name}.aspect';\n\nexport type { ${namePascalCase}Main } from './${name}.main.runtime';\nexport default ${namePascalCase}Aspect;\nexport { ${namePascalCase}Aspect };\n`;\n}\n"]}

package/dist/templates/compiler/files/main-runtime-file.d.ts

@@ -0,0 +1,2 @@
+import { ComponentContext } from '@teambit/generator';
+export declare function mainRuntimeFile({ name, namePascalCase }: ComponentContext): string;

package/dist/templates/compiler/files/main-runtime-file.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.mainRuntimeFile = mainRuntimeFile;
+
+function mainRuntimeFile({
+  name,
+  namePascalCase
+}) {
+  return `import { MainRuntime } from '@teambit/cli';
+import { CompilerAspect, CompilerMain } from '@teambit/compiler';
+import { ${namePascalCase} } from './${name}.compiler';
+import { ${namePascalCase}Aspect } from './${name}.aspect';
+
+export class ${namePascalCase}Main {
+  constructor(private compiler: CompilerMain) {}
+
+  static slots = [];
+  static dependencies = [CompilerAspect];
+  static runtime = MainRuntime;
+
+  distDir = 'dist';
+
+  /* Set the main property of the component's package with
+  the relative output path for the main file */
+  getPackageJsonProps() {
+    return {
+      main: '\${this.distDir}/{main}.js',
+    };
+  }
+
+  createCompiler(): ${namePascalCase} {
+    return new ${namePascalCase}(${namePascalCase}Aspect.id, this.distDir, this.compiler);
+  }
+
+  static async provider([compiler]: [CompilerMain]) {
+    return new ${namePascalCase}Main(compiler);
+  }
+}
+
+${namePascalCase}Aspect.addRuntime(${namePascalCase}Main);
+`;
+}
+
+//# sourceMappingURL=main-runtime-file.js.map

package/dist/templates/compiler/files/main-runtime-file.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["main-runtime-file.ts"],"names":["mainRuntimeFile","name","namePascalCase"],"mappings":";;;;;;;AAEO,SAASA,eAAT,CAAyB;AAAEC,EAAAA,IAAF;AAAQC,EAAAA;AAAR,CAAzB,EAAqE;AAC1E,SAAQ;AACV;AACA,WAAWA,cAAe,cAAaD,IAAK;AAC5C,WAAWC,cAAe,oBAAmBD,IAAK;AAClD;AACA,eAAeC,cAAe;AAC9B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,sBAAsBA,cAAe;AACrC,iBAAiBA,cAAe,IAAGA,cAAe;AAClD;AACA;AACA;AACA,iBAAiBA,cAAe;AAChC;AACA;AACA;AACA,EAAEA,cAAe,qBAAoBA,cAAe;AACpD,CAhCE;AAiCD","sourcesContent":["import { ComponentContext } from '@teambit/generator';\n\nexport function mainRuntimeFile({ name, namePascalCase }: ComponentContext) {\n  return `import { MainRuntime } from '@teambit/cli';\nimport { CompilerAspect, CompilerMain } from '@teambit/compiler';\nimport { ${namePascalCase} } from './${name}.compiler';\nimport { ${namePascalCase}Aspect } from './${name}.aspect';\n\nexport class ${namePascalCase}Main {\n  constructor(private compiler: CompilerMain) {}\n\n  static slots = [];\n  static dependencies = [CompilerAspect];\n  static runtime = MainRuntime;\n\n  distDir = 'dist';\n\n  /* Set the main property of the component's package with\n  the relative output path for the main file */\n  getPackageJsonProps() {\n    return {\n      main: '\\${this.distDir}/{main}.js',\n    };\n  }\n\n  createCompiler(): ${namePascalCase} {\n    return new ${namePascalCase}(${namePascalCase}Aspect.id, this.distDir, this.compiler);\n  }\n\n  static async provider([compiler]: [CompilerMain]) {\n    return new ${namePascalCase}Main(compiler);\n  }\n}\n\n${namePascalCase}Aspect.addRuntime(${namePascalCase}Main);\n`;\n}\n"]}

package/dist/templates/compiler/index.d.ts

@@ -0,0 +1,2 @@
+import { ComponentTemplate } from '@teambit/generator';
+export declare const compilerTemplate: ComponentTemplate;

package/dist/templates/compiler/index.js

@@ -0,0 +1,71 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.compilerTemplate = void 0;
+
+function _indexFile() {
+  const data = require("./files/index-file");
+
+  _indexFile = function () {
+    return data;
+  };
+
+  return data;
+}
+
+function _aspectFile() {
+  const data = require("./files/aspect-file");
+
+  _aspectFile = function () {
+    return data;
+  };
+
+  return data;
+}
+
+function _mainRuntimeFile() {
+  const data = require("./files/main-runtime-file");
+
+  _mainRuntimeFile = function () {
+    return data;
+  };
+
+  return data;
+}
+
+function _compilerFile() {
+  const data = require("./files/compiler-file");
+
+  _compilerFile = function () {
+    return data;
+  };
+
+  return data;
+}
+
+const compilerTemplate = {
+  name: 'compiler',
+  description: 'A compiler implementation',
+  hidden: true,
+  generateFiles: context => {
+    return [{
+      relativePath: 'index.ts',
+      content: (0, _indexFile().indexFile)(context),
+      isMain: true
+    }, {
+      relativePath: `${context.name}.aspect.ts`,
+      content: (0, _aspectFile().aspectFile)(context)
+    }, {
+      relativePath: `${context.name}.compiler.ts`,
+      content: (0, _compilerFile().compilerFile)(context)
+    }, {
+      relativePath: `${context.name}.main.runtime.ts`,
+      content: (0, _mainRuntimeFile().mainRuntimeFile)(context)
+    }];
+  }
+};
+exports.compilerTemplate = compilerTemplate;
+
+//# sourceMappingURL=index.js.map

package/dist/templates/compiler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["index.ts"],"names":["compilerTemplate","name","description","hidden","generateFiles","context","relativePath","content","isMain"],"mappings":";;;;;;;AACA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;;AACA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;;AACA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;;AACA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;;AAEO,MAAMA,gBAAmC,GAAG;AACjDC,EAAAA,IAAI,EAAE,UAD2C;AAEjDC,EAAAA,WAAW,EAAE,2BAFoC;AAGjDC,EAAAA,MAAM,EAAE,IAHyC;AAIjDC,EAAAA,aAAa,EAAGC,OAAD,IAA+B;AAC5C,WAAO,CACL;AACEC,MAAAA,YAAY,EAAE,UADhB;AAEEC,MAAAA,OAAO,EAAE,4BAAUF,OAAV,CAFX;AAGEG,MAAAA,MAAM,EAAE;AAHV,KADK,EAML;AACEF,MAAAA,YAAY,EAAG,GAAED,OAAO,CAACJ,IAAK,YADhC;AAEEM,MAAAA,OAAO,EAAE,8BAAWF,OAAX;AAFX,KANK,EAUL;AACEC,MAAAA,YAAY,EAAG,GAAED,OAAO,CAACJ,IAAK,cADhC;AAEEM,MAAAA,OAAO,EAAE,kCAAaF,OAAb;AAFX,KAVK,EAcL;AACEC,MAAAA,YAAY,EAAG,GAAED,OAAO,CAACJ,IAAK,kBADhC;AAEEM,MAAAA,OAAO,EAAE,wCAAgBF,OAAhB;AAFX,KAdK,CAAP;AAmBD;AAxBgD,CAA5C","sourcesContent":["import { ComponentContext, ComponentTemplate } from '@teambit/generator';\nimport { indexFile } from './files/index-file';\nimport { aspectFile } from './files/aspect-file';\nimport { mainRuntimeFile } from './files/main-runtime-file';\nimport { compilerFile } from './files/compiler-file';\n\nexport const compilerTemplate: ComponentTemplate = {\n  name: 'compiler',\n  description: 'A compiler implementation',\n  hidden: true,\n  generateFiles: (context: ComponentContext) => {\n    return [\n      {\n        relativePath: 'index.ts',\n        content: indexFile(context),\n        isMain: true,\n      },\n      {\n        relativePath: `${context.name}.aspect.ts`,\n        content: aspectFile(context),\n      },\n      {\n        relativePath: `${context.name}.compiler.ts`,\n        content: compilerFile(context),\n      },\n      {\n        relativePath: `${context.name}.main.runtime.ts`,\n        content: mainRuntimeFile(context),\n      },\n    ];\n  },\n};\n"]}

package/dist/types.d.ts

@@ -26,24 +26,88 @@ export declare type TranspileFileOutput = {
     outputPath: string;
 }[] | null;
 export interface CompilerOptions {
+    /**
+     * name of the compiler.
+     */
     name?: string;
+    /**
+     * relative path of the dist directory inside the capsule. e.g. "dist".
+     */
     distDir: string;
+    /**
+     * determines which ones of the generated files will be saved in the bit objects when tagging.
+     * e.g. distGlobPatterns = [`${this.distDir}/**`, `!${this.distDir}/tsconfig.tsbuildinfo`];
+     * see https://github.com/mrmlnc/fast-glob for the supported glob patters syntax.
+     */
     distGlobPatterns?: string[];
+    /**
+     * whether or not unsupported files (such as assets) should be copied into the dist directory
+     */
     shouldCopyNonSupportedFiles?: boolean;
+    /**
+     * optional. default to "dist".
+     * useful when the build pipeline has multiple compiler tasks of the same compiler.
+     * e.g. using the same Babel compiler for two different tasks, one for creating "es5" files, and
+     * the second for creating "esm". the artifact names would be "es5" and "esm" accordingly.
+     */
     artifactName?: string;
 }
 export interface Compiler extends CompilerOptions {
+    /**
+     * id of the compiler.
+     */
     id: string;
+    /**
+     * serialized config of the compiler.
+     */
     displayConfig?(): string;
+    /**
+     * transpile a single file that gets saved into the workspace, used by `bit compile` and during
+     * development
+     */
     transpileFile?: (fileContent: string, params: TranspileFileParams) => TranspileFileOutput;
+    /**
+     * transpile all the files of a component, use this when you can't use `transpileFile`
+     */
     transpileComponent?: (params: TranspileComponentParams) => Promise<void>;
+    /**
+     * compile components inside isolated capsules. this being used during tag for the release.
+     * meaning, the final package of the component has the dists generated by this method.
+     */
     build(context: BuildContext): Promise<BuiltTaskResult>;
+    /**
+     * given a source file, return its parallel in the dists. e.g. "index.ts" => "dist/index.js"
+     * both, the return path and the given path are relative paths.
+     */
     getDistPathBySrcPath(srcPath: string): string;
+    /**
+     * given a component, returns the path to the source folder to use for the preview, uses the one
+     * in node_modules by default
+     */
     getPreviewComponentRootPath?(component: Component): string;
+    /**
+     * only supported files matching get compiled. others, are copied to the dist dir.
+     */
     isFileSupported(filePath: string): boolean;
+    /**
+     * sugar to create a Compiler task via the concrete compiler
+     */
     createTask?(name?: string): BuildTask;
+    /**
+     * run before the build pipeline has started. this is useful when some preparation are needed to
+     * be done on all envs before the build starts.
+     */
     preBuild?(context: BuildContext): Promise<void>;
+    /**
+     * run after the build pipeline completed for all envs. useful for some cleanups
+     */
     postBuild?(context: BuildContext, tasksResults: TaskResultsList): Promise<void>;
+    /**
+     * returns the version of the current compiler instance (e.g. '4.0.1').
+     */
     version(): string;
+    /**
+     * returns the display name of the current compiler instance (e.g. 'TypeScript')
+     */
     displayName: string;
 }

package/dist/workspace-compiler.d.ts

@@ -17,6 +17,11 @@ export declare type BuildResult = {
 export declare type CompileOptions = {
     changed?: boolean;
     verbose?: boolean;
+    /**
+     * whether the dist root dir should be deleted before writing new dists.
+     * defaults to true for `bit compile` and false everywhere else, such as `bit watch` and `bit
+     * start` to avoid webpack "EINTR" error.
+     */
     deleteDistDir?: boolean;
     initiator: CompilationInitiator;
 };
@@ -55,6 +60,7 @@ export declare class WorkspaceCompiler {
     }, id: ComponentID): Promise<boolean>;
     onComponentChange(component: Component, files: string[], initiator?: CompilationInitiator): Promise<SerializableResults>;
     onPreWatch(components: Component[], watchOpts: WatchOptions): Promise<void>;
-    compileComponents(componentsIds: string[] | BitId[], options: CompileOptions, noThrow?: boolean): Promise<BuildResult[]>;
+    compileComponents(componentsIds: string[] | BitId[], // when empty, it compiles new+modified (unless options.all is set),
+    options: CompileOptions, noThrow?: boolean): Promise<BuildResult[]>;
     private getIdsToCompile;
 }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@teambit/compiler",
-  "version": "0.0.553",
+  "version": "0.0.557",
   "homepage": "https://bit.dev/teambit/compilation/compiler",
   "main": "dist/index.js",
   "componentId": {
     "scope": "teambit.compilation",
     "name": "compiler",
-    "version": "0.0.553"
+    "version": "0.0.557"
   },
   "dependencies": {
     "@teambit/harmony": "0.2.11",
@@ -18,18 +18,19 @@
     "p-map-series": "2.1.0",
     "@babel/runtime": "7.12.18",
     "core-js": "^3.0.0",
-    "@teambit/cli": "0.0.384",
-    "@teambit/logger": "0.0.469",
-    "@teambit/pubsub": "0.0.553",
-    "@teambit/aspect-loader": "0.0.553",
-    "@teambit/builder": "0.0.553",
-    "@teambit/component": "0.0.553",
-    "@teambit/envs": "0.0.553",
-    "@teambit/legacy-bit-id": "0.0.373",
-    "@teambit/ui": "0.0.553",
-    "@teambit/workspace": "0.0.553",
-    "@teambit/isolator": "0.0.553",
-    "@teambit/bit-error": "0.0.370"
+    "@teambit/cli": "0.0.388",
+    "@teambit/logger": "0.0.473",
+    "@teambit/pubsub": "0.0.557",
+    "@teambit/aspect-loader": "0.0.557",
+    "@teambit/builder": "0.0.557",
+    "@teambit/component": "0.0.557",
+    "@teambit/envs": "0.0.557",
+    "@teambit/generator": "0.0.557",
+    "@teambit/legacy-bit-id": "0.0.377",
+    "@teambit/ui": "0.0.557",
+    "@teambit/workspace": "0.0.557",
+    "@teambit/isolator": "0.0.557",
+    "@teambit/bit-error": "0.0.374"
   },
   "devDependencies": {
     "@types/react": "^17.0.8",
@@ -39,10 +40,10 @@
     "@types/jest": "^26.0.0",
     "@types/react-dom": "^17.0.5",
     "@types/node": "12.20.4",
-    "@teambit/compilation.aspect-docs.compiler": "0.0.103"
+    "@teambit/compilation.aspect-docs.compiler": "0.0.107"
   },
   "peerDependencies": {
-    "@teambit/legacy": "1.0.170",
+    "@teambit/legacy": "1.0.174",
     "react-dom": "^16.8.0 || ^17.0.0",
     "react": "^16.8.0 || ^17.0.0"
   },
@@ -70,12 +71,20 @@
         "react": "-"
       },
       "peerDependencies": {
-        "@teambit/legacy": "1.0.170",
+        "@teambit/legacy": "1.0.174",
         "react-dom": "^16.8.0 || ^17.0.0",
         "react": "^16.8.0 || ^17.0.0"
       }
     }
   },
+  "files": [
+    "dist",
+    "!dist/tsconfig.tsbuildinfo",
+    "README.md",
+    "README.mdx",
+    "*.js",
+    "*.json"
+  ],
   "private": false,
   "engines": {
     "node": ">=12.22.0"