@teambit/generator 1.0.109 → 1.0.110

package/artifacts/preview/teambit_generator_generator-preview.js

@@ -0,0 +1 @@
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["teambit.generator/generator-preview"]=t():e["teambit.generator/generator-preview"]=t()}(self,(()=>(()=>{"use strict";var e={65574:(e,t,n)=>{var o={id:"teambit.generator/generator@1.0.110",homepage:"https://bit.cloud/teambit/generator/generator",exported:!0};function a(){const e=r(n(87363));return a=function(){return e},e}function r(e){return e&&e.__esModule?e:{default:e}}Object.defineProperty(t,"__esModule",{value:!0}),t.Logo=void 0,a.__bit_component=o,r.__bit_component=o;const l=()=>a().default.createElement("div",{style:{height:"100%",display:"flex",justifyContent:"center"}},a().default.createElement("img",{style:{width:70},src:"https://static.bit.dev/extensions-icons/generator-new.svg"}));l.__bit_component=o,t.Logo=l},28859:(e,t,n)=>{var o={id:"teambit.generator/aspect-docs/generator@0.0.169",homepage:"https://bit.cloud/teambit/generator/aspect-docs/generator",exported:!0};Object.defineProperty(t,"__esModule",{value:!0}),t.default=c,l(n(87363));var a=n(40040),r=["components"];function l(e){return e&&e.__esModule?e:{default:e}}function p(){return p=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var o in n)Object.prototype.hasOwnProperty.call(n,o)&&(e[o]=n[o])}return e},p.apply(this,arguments)}function m(e,t){if(null==e)return{};var n,o,a=i(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(o=0;o<r.length;o++)n=r[o],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}function i(e,t){if(null==e)return{};var n,o,a={},r=Object.keys(e);for(o=0;o<r.length;o++)n=r[o],t.indexOf(n)>=0||(a[n]=e[n]);return a}l.__bit_component=o,p.__bit_component=o,m.__bit_component=o,i.__bit_component=o;var s={},d="wrapper";function c(e){var t=e.components,n=m(e,r);return(0,a.mdx)(d,p({},s,n,{components:t,mdxType:"MDXLayout"}),(0,a.mdx)("p",null,"Generator extension enable generating new components by pre-defined templates"),(0,a.mdx)("h3",null,"Component location"),(0,a.mdx)("p",null,"Component location in the workspace directory tree is defined with the ",(0,a.mdx)("inlineCode",{parentName:"p"},"bit create")," command (see below). For example, a component named ",(0,a.mdx)("inlineCode",{parentName:"p"},"ShoppingCart")," created in the ",(0,a.mdx)("inlineCode",{parentName:"p"},"acme.shopper")," and the namespace ",(0,a.mdx)("inlineCode",{parentName:"p"},"ui")," will be generated in the following directory:"),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre"},"acme.shopper/ui/shopping-cart\n")),(0,a.mdx)("h3",null,"Component name"),(0,a.mdx)("p",null,"When using templates Bit will use CamelCasing for passing the component-name to the template, but generated file structure should be in kebab-case, for better cross-operating-system compatibility of the component."),(0,a.mdx)("h3",null,"Automatically ",(0,a.mdx)("inlineCode",{parentName:"h3"},"add")," component"),(0,a.mdx)("p",null,"Bit should automatically register the new component to the ",(0,a.mdx)("inlineCode",{parentName:"p"},".bitmap")," file with a symmetrical name to the component-location in the workspace."),(0,a.mdx)("h2",null,"Register a template"),(0,a.mdx)("p",null,"Any aspect (include envs) can register templates. Each template should have a name and a list of files. Each file has a relative-path to the component-dir and template content. See the ",(0,a.mdx)("inlineCode",{parentName:"p"},"component-template.ts")," file for more info about the exact API."),(0,a.mdx)("ul",null,(0,a.mdx)("li",{parentName:"ul"},"Component name should be available as a param for the file-content-template."),(0,a.mdx)("li",{parentName:"ul"},"TBD: An environment must have a default template (if not set, use first template in array?).")),(0,a.mdx)("p",null,"To register a template, use the Generator API: ",(0,a.mdx)("inlineCode",{parentName:"p"},"registerComponentTemplate(templates: ComponentTemplate[])"),"."),(0,a.mdx)("p",null,"To make the templates of an aspect available on a workspace, they need to be added to the workspace.jsonc. For example:"),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-json"},'"teambit.generator/generator": {\n    "aspects": [\n      "teambit.harmony/aspect"\n    ]\n  },\n')),(0,a.mdx)("p",null,"In the example above, the aspect ",(0,a.mdx)("inlineCode",{parentName:"p"},"teambit.harmony/aspect")," is configured to be available for the generator."),(0,a.mdx)("h2",null,"Show all available templates"),(0,a.mdx)("p",null,"Introduce a new command ",(0,a.mdx)("inlineCode",{parentName:"p"},"bit templates"),", which groups all available templates by aspects."),(0,a.mdx)("h2",null,"Hide core templates"),(0,a.mdx)("p",null,"Configure the Generator aspect to hide core templates when running ",(0,a.mdx)("inlineCode",{parentName:"p"},"bit templates"),". They'll be only shown when using ",(0,a.mdx)("inlineCode",{parentName:"p"},"--show-all")," flag."),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-json"},'"teambit.generator/generator": {\n    "hideCoreTemplates": true\n  },\n')),(0,a.mdx)("h2",null,"Generate a template from CLI"),(0,a.mdx)("p",null,"Introduce a ",(0,a.mdx)("inlineCode",{parentName:"p"},"create")," command to use templates."),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-sh"},"bit create <template-name> <component-name...> [--scope | -s] [--namespace | -n] [--aspect | -a]\n")),(0,a.mdx)("h3",null,"Args"),(0,a.mdx)("h4",null,(0,a.mdx)("inlineCode",{parentName:"h4"},"<component name>")),(0,a.mdx)("p",null,"Name of the component to create. Will be used as the component's dir name and fed to the component template."),(0,a.mdx)("p",null,(0,a.mdx)("strong",{parentName:"p"},"generated file structure should use kebab-case, while the template itself be in camel case"),"."),(0,a.mdx)("h3",null,"Options"),(0,a.mdx)("h4",null,(0,a.mdx)("inlineCode",{parentName:"h4"},"[--scope | -s]")),(0,a.mdx)("p",null,"Sets the component's scope and base directory. If not defined, use the ",(0,a.mdx)("inlineCode",{parentName:"p"},"defaultScope")," from ",(0,a.mdx)("inlineCode",{parentName:"p"},"teambit.workspace/workspace")," config."),(0,a.mdx)("h4",null,(0,a.mdx)("inlineCode",{parentName:"h4"},"[--namespace | -n]")),(0,a.mdx)("p",null,"Sets the component's namespace and nested dirs inside the scope. If not define, use empty string."),(0,a.mdx)("h4",null,(0,a.mdx)("inlineCode",{parentName:"h4"},"[--aspect | -a]")),(0,a.mdx)("p",null,"Aspect ID that registered this template, required only if there are two templates with the same name from several aspects in the workspace."),(0,a.mdx)("h2",null,"Creating a custom template generator"),(0,a.mdx)("p",null,"See our ",(0,a.mdx)("a",{parentName:"p",href:"https://harmony-docs.bit.dev/extending-bit/creating-a-custom-generator"},"tutorial")," on how to Create your own custom component generator."))}c.__bit_component=o,c.isMDXComponent=!0},44207:(e,t,n)=>{Object.defineProperty(t,"R",{enumerable:!0,get:function(){return o.default}});var o=a(n(28859));function a(e){return e&&e.__esModule?e:{default:e}}a.__bit_component={id:"teambit.generator/aspect-docs/generator@0.0.169",homepage:"https://bit.cloud/teambit/generator/aspect-docs/generator",exported:!0}},40040:e=>{e.exports=MdxJsReact},87363:e=>{e.exports=React}},t={};function n(o){var a=t[o];if(void 0!==a)return a.exports;var r=t[o]={exports:{}};return e[o](r,r.exports,n),r.exports}n.d=(e,t)=>{for(var o in t)n.o(t,o)&&!n.o(e,o)&&Object.defineProperty(e,o,{enumerable:!0,get:t[o]})},n.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),n.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var o={};return(()=>{n.r(o),n.d(o,{compositions:()=>c,compositions_metadata:()=>h,overview:()=>u});var e={};n.r(e),n.d(e,{default:()=>d});var t=n(65574),a=(n(87363),n(40040));const r=TeambitMdxUiMdxScopeContext;var l=n(44207),p=["components"];function m(){return m=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var o in n)Object.prototype.hasOwnProperty.call(n,o)&&(e[o]=n[o])}return e},m.apply(this,arguments)}var i={},s="wrapper";function d(e){var t=e.components,n=function(e,t){if(null==e)return{};var n,o,a=function(e,t){if(null==e)return{};var n,o,a={},r=Object.keys(e);for(o=0;o<r.length;o++)n=r[o],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(o=0;o<r.length;o++)n=r[o],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}(e,p);return(0,a.mdx)(s,m({},i,n,{components:t,mdxType:"MDXLayout"}),(0,a.mdx)(r.MDXScopeProvider,{components:{Generator:l.R},mdxType:"MDXScopeProvider"},(0,a.mdx)(l.R,{mdxType:"Generator"})))}d.isMDXComponent=!0;const c=[t],u=[e],h={compositions:[{displayName:"Logo",identifier:"Logo"}]}})(),o})()));

package/dist/{preview-1703647408454.js → preview-1703698405864.js}

@@ -1,5 +1,5 @@
-import * as compositions_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.generator_generator@1.0.109/dist/generator.composition.js';
-import * as overview_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.generator_generator@1.0.109/dist/generator.docs.mdx';
+import * as compositions_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.generator_generator@1.0.110/dist/generator.composition.js';
+import * as overview_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.generator_generator@1.0.110/dist/generator.docs.mdx';
 
 export const compositions = [compositions_0];
 export const overview = [overview_0];

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@teambit/generator",
-  "version": "1.0.109",
+  "version": "1.0.110",
   "homepage": "https://bit.cloud/teambit/generator/generator",
   "main": "dist/index.js",
   "componentId": {
     "scope": "teambit.generator",
     "name": "generator",
-    "version": "1.0.109"
+    "version": "1.0.110"
   },
   "dependencies": {
     "camelcase": "6.2.0",
@@ -21,25 +21,25 @@
     "@teambit/component-id": "1.2.0",
     "@teambit/harmony": "0.4.6",
     "@teambit/git.modules.git-ignore": "1.0.2",
-    "@teambit/envs": "1.0.108",
-    "@teambit/logger": "0.0.933",
-    "@teambit/new-component-helper": "1.0.108",
-    "@teambit/tracker": "1.0.108",
-    "@teambit/workspace-config-files": "1.0.108",
-    "@teambit/workspace.modules.node-modules-linker": "0.0.158",
-    "@teambit/workspace": "1.0.108",
-    "@teambit/component": "1.0.108",
-    "@teambit/cli": "0.0.840",
-    "@teambit/graphql": "1.0.108",
-    "@teambit/aspect-loader": "1.0.108",
-    "@teambit/bit": "1.6.1",
-    "@teambit/git": "1.0.108",
-    "@teambit/compiler": "1.0.108",
-    "@teambit/forking": "1.0.108",
-    "@teambit/importer": "1.0.108",
-    "@teambit/install": "1.0.108",
-    "@teambit/ui": "1.0.108",
-    "@teambit/config": "0.0.859"
+    "@teambit/envs": "1.0.109",
+    "@teambit/logger": "0.0.934",
+    "@teambit/new-component-helper": "1.0.109",
+    "@teambit/tracker": "1.0.109",
+    "@teambit/workspace-config-files": "1.0.109",
+    "@teambit/workspace.modules.node-modules-linker": "0.0.159",
+    "@teambit/workspace": "1.0.109",
+    "@teambit/component": "1.0.109",
+    "@teambit/cli": "0.0.841",
+    "@teambit/graphql": "1.0.109",
+    "@teambit/aspect-loader": "1.0.109",
+    "@teambit/bit": "1.6.2",
+    "@teambit/git": "1.0.109",
+    "@teambit/compiler": "1.0.109",
+    "@teambit/forking": "1.0.109",
+    "@teambit/importer": "1.0.109",
+    "@teambit/install": "1.0.109",
+    "@teambit/ui": "1.0.109",
+    "@teambit/config": "0.0.860"
   },
   "devDependencies": {
     "@types/fs-extra": "9.0.7",
@@ -47,7 +47,7 @@
     "@types/mocha": "9.1.0",
     "@types/jest": "^29.2.2",
     "@types/testing-library__jest-dom": "^5.9.5",
-    "@teambit/harmony.envs.core-aspect-env": "0.0.13",
+    "@teambit/harmony.envs.core-aspect-env": "0.0.14",
     "@teambit/generator.aspect-docs.generator": "0.0.169"
   },
   "peerDependencies": {

package/component-generator.ts

@@ -1,284 +0,0 @@
-import Vinyl from 'vinyl';
-import fs from 'fs-extra';
-import pMapSeries from 'p-map-series';
-import path from 'path';
-import { Workspace } from '@teambit/workspace';
-import EnvsAspect, { EnvsMain } from '@teambit/envs';
-import camelcase from 'camelcase';
-import { BitError } from '@teambit/bit-error';
-import { Logger } from '@teambit/logger';
-import { TrackerMain } from '@teambit/tracker';
-import { linkToNodeModulesByIds } from '@teambit/workspace.modules.node-modules-linker';
-import { PathOsBasedRelative } from '@teambit/legacy/dist/utils/path';
-import { AbstractVinyl } from '@teambit/legacy/dist/consumer/component/sources';
-import componentIdToPackageName from '@teambit/legacy/dist/utils/bit/component-id-to-package-name';
-import DataToPersist from '@teambit/legacy/dist/consumer/component/sources/data-to-persist';
-import { NewComponentHelperMain } from '@teambit/new-component-helper';
-import { ComponentID } from '@teambit/component-id';
-import { WorkspaceConfigFilesMain } from '@teambit/workspace-config-files';
-
-import { ComponentTemplate, ComponentFile, ComponentConfig } from './component-template';
-import { CreateOptions } from './create.cmd';
-import { OnComponentCreateSlot } from './generator.main.runtime';
-
-export type GenerateResult = {
-  id: ComponentID;
-  dir: string;
-  files: string[];
-  envId: string;
-  envSetBy: string;
-  packageName: string;
-  isApp?: boolean;
-  isEnv?: boolean;
-  dependencies?: string[];
-  installMissingDependencies?: boolean;
-};
-
-export type OnComponentCreateFn = (generateResults: GenerateResult[]) => Promise<void>;
-
-export class ComponentGenerator {
-  constructor(
-    private workspace: Workspace,
-    private componentIds: ComponentID[],
-    private options: Partial<CreateOptions>,
-    private template: ComponentTemplate,
-    private envs: EnvsMain,
-    private newComponentHelper: NewComponentHelperMain,
-    private tracker: TrackerMain,
-    private wsConfigFiles: WorkspaceConfigFilesMain,
-    private logger: Logger,
-    private onComponentCreateSlot: OnComponentCreateSlot,
-    private aspectId: string,
-    private envId?: ComponentID
-  ) {}
-
-  async generate(): Promise<GenerateResult[]> {
-    const dirsToDeleteIfFailed: string[] = [];
-    const generateResults = await pMapSeries(this.componentIds, async (componentId) => {
-      try {
-        const componentPath = this.newComponentHelper.getNewComponentPath(
-          componentId,
-          this.options.path,
-          this.componentIds.length
-        );
-        if (fs.existsSync(path.join(this.workspace.path, componentPath))) {
-          throw new BitError(`unable to create a component at "${componentPath}", this path already exist`);
-        }
-        if (await this.workspace.hasName(componentId.fullName)) {
-          throw new BitError(
-            `unable to create a component "${componentId.fullName}", a component with the same name already exist`
-          );
-        }
-        dirsToDeleteIfFailed.push(componentPath);
-        return await this.generateOneComponent(componentId, componentPath);
-      } catch (err: any) {
-        await this.deleteGeneratedComponents(dirsToDeleteIfFailed);
-        throw err;
-      }
-    });
-
-    await this.workspace.bitMap.write(`create (${this.componentIds.length} components)`);
-
-    const ids = generateResults.map((r) => r.id);
-    await this.tryLinkToNodeModules(ids);
-    await this.runOnComponentCreateHook(generateResults);
-    // We are running this after the runOnComponentCreateHook as it require
-    // the env to be installed to work properly, and the hook might install
-    // the env.
-    await this.tryWriteConfigFiles(ids);
-
-    return generateResults;
-  }
-
-  private async tryLinkToNodeModules(ids: ComponentID[]) {
-    try {
-      await linkToNodeModulesByIds(
-        this.workspace,
-        ids.map((id) => id)
-      );
-    } catch (err: any) {
-      this.logger.consoleFailure(
-        `failed linking the new components to node_modules, please run "bit link" manually. error: ${err.message}`
-      );
-    }
-  }
-
-  private async runOnComponentCreateHook(generateResults: GenerateResult[]) {
-    const fns = this.onComponentCreateSlot.values();
-    if (!fns.length) return;
-    await Promise.all(fns.map((fn) => fn(generateResults)));
-  }
-
-  /**
-   * The function `tryWriteConfigFiles` attempts to write workspace config files, and if it fails, it logs an error
-   * message.
-   * @returns If the condition `!shouldWrite` is true, then nothing is being returned. Otherwise, if the `writeConfigFiles`
-   * function is successfully executed, nothing is being returned. If an error occurs during the execution of
-   * `writeConfigFiles`, an error message is being returned.
-   */
-  private async tryWriteConfigFiles(ids: ComponentID[]) {
-    const shouldWrite = this.wsConfigFiles.isWorkspaceConfigWriteEnabled();
-    if (!shouldWrite) return;
-    ids.map((id) => this.workspace.clearComponentCache(id));
-    const { err } = await this.wsConfigFiles.writeConfigFiles({
-      clean: true,
-      silent: true,
-      dedupe: true,
-      throw: false,
-    });
-    if (err) {
-      this.logger.consoleFailure(
-        `failed generating workspace config files, please run "bit ws-config write" manually. error: ${err.message}`
-      );
-    }
-  }
-
-  private async deleteGeneratedComponents(dirs: string[]) {
-    await Promise.all(
-      dirs.map(async (dir) => {
-        const absoluteDir = path.join(this.workspace.path, dir);
-        try {
-          await fs.remove(absoluteDir);
-        } catch (err: any) {
-          if (err.code !== 'ENOENT') {
-            // if not exist, it's fine
-            throw err;
-          }
-        }
-      })
-    );
-  }
-
-  private async generateOneComponent(componentId: ComponentID, componentPath: string): Promise<GenerateResult> {
-    const name = componentId.name;
-    const namePascalCase = camelcase(name, { pascalCase: true });
-    const nameCamelCase = camelcase(name);
-    const aspectId = ComponentID.fromString(this.aspectId);
-
-    const files = await this.template.generateFiles({
-      name,
-      namePascalCase,
-      nameCamelCase,
-      componentId,
-      aspectId,
-      envId: this.envId,
-    });
-    const mainFile = files.find((file) => file.isMain);
-    await this.writeComponentFiles(componentPath, files);
-    const addResults = await this.tracker.track({
-      rootDir: componentPath,
-      mainFile: mainFile?.relativePath,
-      componentName: componentId.fullName,
-      defaultScope: this.options.scope,
-    });
-    const component = await this.workspace.get(componentId);
-    const hasEnvConfiguredOriginally = this.envs.hasEnvConfigured(component);
-    if (this.template.isApp) {
-      await this.workspace.use(componentId.toString());
-    }
-    const envBeforeConfigChanges = this.envs.getEnv(component);
-    let config = this.template.config;
-    if (config && typeof config === 'function') {
-      const boundConfig = this.template.config?.bind(this.template);
-      config = boundConfig({ aspectId: this.aspectId });
-    }
-
-    const userEnv = this.options.env;
-
-    if (!config && this.envId && !userEnv) {
-      const isInWorkspace = this.workspace.exists(this.envId);
-      config = {
-        [isInWorkspace ? this.envId.toStringWithoutVersion() : this.envId.toString()]: {},
-        'teambit.envs/envs': {
-          env: this.envId.toStringWithoutVersion(),
-        },
-      };
-    }
-
-    const templateEnv = config?.[EnvsAspect.id]?.env;
-
-    if (config && templateEnv && hasEnvConfiguredOriginally) {
-      // remove the env we got from the template.
-      delete config[templateEnv];
-      delete config[EnvsAspect.id].env;
-      if (Object.keys(config[EnvsAspect.id]).length === 0) delete config[EnvsAspect.id];
-      if (Object.keys(config).length === 0) config = undefined;
-    }
-
-    const configWithEnv = await this.addEnvIfProvidedByFlag(config);
-    if (configWithEnv) this.workspace.bitMap.setEntireConfig(component.id, configWithEnv);
-
-    const getEnvData = () => {
-      const envFromFlag = this.options.env; // env entered by the user when running `bit create --env`
-      const envFromTemplate = config?.[EnvsAspect.id]?.env;
-      if (envFromFlag) {
-        return {
-          envId: envFromFlag,
-          setBy: '--env flag',
-        };
-      }
-      if (envFromTemplate) {
-        return {
-          envId: envFromTemplate,
-          setBy: 'template',
-        };
-      }
-      return {
-        envId: envBeforeConfigChanges.id,
-        setBy: hasEnvConfiguredOriginally ? 'workspace variants' : '<default>',
-      };
-    };
-    const { envId, setBy } = getEnvData();
-    return {
-      id: componentId,
-      dir: componentPath,
-      files: addResults.files,
-      packageName: componentIdToPackageName(component.state._consumer),
-      envId,
-      envSetBy: setBy,
-      isApp: this.template.isApp,
-      isEnv: this.template.isEnv,
-      dependencies: this.template.dependencies,
-      installMissingDependencies: this.template.installMissingDependencies,
-    };
-  }
-
-  private async addEnvIfProvidedByFlag(config?: ComponentConfig): Promise<ComponentConfig | undefined> {
-    const userEnv = this.options.env; // env entered by the user when running `bit create --env`
-    const templateEnv = config?.[EnvsAspect.id]?.env;
-    if (!userEnv || userEnv === templateEnv) {
-      return config;
-    }
-    config = config || {};
-    if (templateEnv) {
-      // the component template has an env and the user wants a different env.
-      delete config[templateEnv];
-    }
-    await this.tracker.addEnvToConfig(userEnv, config);
-
-    return config;
-  }
-
-  /**
-   * writes the generated template files to the default directory set in the workspace config
-   */
-  private async writeComponentFiles(
-    componentPath: string,
-    templateFiles: ComponentFile[]
-  ): Promise<PathOsBasedRelative[]> {
-    const dataToPersist = new DataToPersist();
-    const vinylFiles = templateFiles.map((templateFile) => {
-      const templateFileVinyl = new Vinyl({
-        base: componentPath,
-        path: path.join(componentPath, templateFile.relativePath),
-        contents: Buffer.from(templateFile.content),
-      });
-      return AbstractVinyl.fromVinyl(templateFileVinyl);
-    });
-    const results = vinylFiles.map((v) => v.path);
-    dataToPersist.addManyFiles(vinylFiles);
-    dataToPersist.addBasePath(this.workspace.path);
-    await dataToPersist.persistAllToFS();
-    return results;
-  }
-}

package/component-template.ts

@@ -1,152 +0,0 @@
-import { ComponentID } from '@teambit/component';
-
-/**
- * BaseComponentTemplateOptions describes the foundational properties for components.
- */
-export interface BaseComponentTemplateOptions {
-  /**
-   * component-name as entered by the user, e.g. `use-date`.
-   * without the scope and the namespace.
-   */
-  name: string;
-
-  /**
-   * component-name as upper camel case, e.g. `use-date` becomes `UseDate`.
-   * useful when generating the file content, for example for a class name.
-   */
-  namePascalCase: string;
-
-  /**
-   * component-name as lower camel case, e.g. `use-date` becomes `useDate`.
-   * useful when generating the file content, for example for a function/variable name.
-   */
-  nameCamelCase: string;
-
-  /**
-   * component id.
-   * the name is the name+namespace. the scope is the scope entered by --scope flag or the defaultScope
-   */
-  componentId: ComponentID;
-
-  /**
-   * aspect id of the aspect that register the template itself
-   */
-  aspectId: ComponentID | string;
-
-  /**
-   * env id of the env that register the template itself.
-   * This will be usually identical to the aspectId but aspectId will always exist,
-   * while envId will be undefined if the template is not registered by an env.
-   */
-  envId?: ComponentID;
-
-  /**
-   * path of the component.
-   */
-  path?: string;
-  /**
-   * scope of the component.
-   */
-  scope?: string;
-  /**
-   * namespace of the component.
-   */
-  namespace?: string;
-}
-
-/**
- * ComponentContext represents foundational properties for a component context.
- */
-export type ComponentContext = BaseComponentTemplateOptions;
-
-export interface ComponentFile {
-  /**
-   * relative path of the file within the component.
-   */
-  relativePath: string;
-
-  /**
-   * file content
-   */
-  content: string;
-
-  /**
-   * whether this file will be tracked as the main file
-   */
-  isMain?: boolean;
-}
-
-export interface ConfigContext {
-  /**
-   * Aspect id of the aspect that register the template itself
-   */
-  aspectId: string;
-}
-
-export type ComponentConfig = { [aspectName: string]: any };
-
-export interface ComponentTemplateOptions {
-  /**
-   * name of the component template. for example: `hook`, `react-component` or `module`.
-   */
-  name?: string;
-
-  /**
-   * short description of the template. shown in the `bit templates` command.
-   */
-  description?: string;
-
-  /**
-   * hide this template so that it is not listed with `bit templates`
-   */
-  hidden?: boolean;
-
-  /**
-   * env to use for the generated component.
-   */
-  env?: string;
-
-  /**
-   * adds a metadata that the component that this template creates is of type env.
-   * This will be used later to do further configuration for example:
-   * - ensure to create the .bit_root for it
-   */
-  isEnv?: boolean;
-
-  /**
-   * adds a metadata that the component that this template creates is of type app.
-   * This will be used later to do further configuration for example:
-   * - add it to the workspace.jsonc as app
-   * - ensure to create the .bit_root for it
-   */
-  isApp?: boolean;
-
-  /**
-   * list of dependencies to install when the component is created.
-   */
-  dependencies?: string[];
-
-  /**
-   * Perform installation of missing dependencies after component generation.
-   * This is the same as of running `bit install --add-missing-deps` after component generation.
-   */
-  installMissingDependencies?: boolean;
-}
-
-export interface ComponentTemplate extends ComponentTemplateOptions {
-  name: string;
-
-  /**
-   * template function for generating the file of a certain component.,
-   */
-  generateFiles(context: ComponentContext): Promise<ComponentFile[]> | ComponentFile[];
-
-  /**
-   * component config. gets saved in the .bitmap file and it overrides the workspace.jsonc config.
-   * for example, you can set the env that will be used for this component as follows:
-   * "teambit.envs/envs": {
-   *    "env": "teambit.harmony/aspect"
-   * },
-   */
-  config?: ComponentConfig | ((context: ConfigContext) => ComponentConfig);
-}

package/create.cmd.ts

@@ -1,88 +0,0 @@
-import { Command, CommandOptions } from '@teambit/cli';
-import { ComponentID } from '@teambit/component';
-import chalk from 'chalk';
-import { GeneratorMain } from './generator.main.runtime';
-import type { BaseComponentTemplateOptions } from './component-template';
-
-/**
- * CreateOptions combines foundational properties with additional options for creating a component.
- */
-export type CreateOptions = BaseComponentTemplateOptions & {
-  env?: string;
-  aspect?: string;
-};
-
-export class CreateCmd implements Command {
-  name = 'create <template-name> <component-names...>';
-  description = 'create a new component (source files and config) using a template.';
-  alias = '';
-  loader = true;
-  helpUrl = 'reference/starters/create-starter';
-  arguments = [
-    {
-      name: 'template-name',
-      description:
-        "the template for generating the component \n(run 'bit templates' for a list of available templates)",
-    },
-    {
-      name: 'component-names...',
-      description: 'a list of component names to generate',
-    },
-  ];
-  examples = [
-    {
-      cmd: 'bit create react ui/button --aspect teambit.react/react-env',
-      description: "creates a component named 'ui/button' using the 'react' template",
-    },
-    {
-      cmd: 'bit create node utils/is-string utils/is-number --aspect teambit.node/node',
-      description:
-        "creates two components, 'utils/is-string' and 'utils/is-number' using the 'node' template from the 'node' aspect(env)",
-    },
-    {
-      cmd: 'bit create mdx docs/create-components --aspect teambit.mdx/mdx-env --scope my-org.my-scope',
-      description:
-        "creates an mdx component named 'docs/create-components' and sets it scope to 'my-org.my-scope'. \nby default, the scope is the `defaultScope` value, configured in your `workspace.jsonc`.",
-    },
-    {
-      cmd: 'bit create react ui/button --aspect teambit.react/react-env --env teambit.community/envs/community-react@3.0.3',
-      description:
-        "creates a component named 'ui/button' from the teambit.react/react-env env and sets it to use the 'community-react' env. \n(the template's default env is 'teambit.react/react-env').",
-    },
-  ];
-  group = 'development';
-  options = [
-    ['n', 'namespace <string>', `sets the component's namespace and nested dirs inside the scope`],
-    ['s', 'scope <string>', `sets the component's scope-name. if not entered, the default-scope will be used`],
-    ['a', 'aspect <string>', 'aspect-id of the template. helpful when multiple aspects use the same template name'],
-    ['t', 'template <string>', 'env-id of the template. alias for --aspect.'],
-    ['p', 'path <string>', 'relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`'],
-    ['e', 'env <string>', "set the component's environment. (overrides the env from variants and the template)"],
-  ] as CommandOptions;
-
-  constructor(private generator: GeneratorMain) {}
-
-  async report(
-    [templateName, componentNames]: [string, string[]],
-    options: Partial<CreateOptions> & {
-      template?: string | ComponentID;
-    }
-  ) {
-    options.aspectId = options.aspectId ?? options.template;
-    const results = await this.generator.generateComponentTemplate(componentNames, templateName, options);
-    const title = `${results.length} component(s) were created`;
-
-    const componentsData = results
-      .map((result) => {
-        return `${chalk.bold(result.id.toString())}
-    location: ${result.dir}
-    env:      ${result.envId} (set by ${result.envSetBy})
-    package:  ${result.packageName}
-`;
-      })
-      .join('\n');
-    const footer = `env configuration is according to workspace variants, template config or --env flag.`;
-
-    return `${chalk.green(title)}\n\n${componentsData}\n\n${footer}`;
-  }
-}

package/generator-env-type.ts

@@ -1,14 +0,0 @@
-import { EnvHandler } from '@teambit/envs';
-import { TemplateList } from './template-list';
-import { StarterList } from './starter-list';
-
-export interface GeneratorEnv {
-  /**
-   * return a template list instance.
-   */
-  generators(): EnvHandler<TemplateList>;
-  /**
-   * return a starter list instance.
-   */
-  starters(): EnvHandler<StarterList>;
-}

package/generator.aspect.ts

@@ -1,5 +0,0 @@
-import { Aspect } from '@teambit/harmony';
-
-export const GeneratorAspect = Aspect.create({
-  id: 'teambit.generator/generator',
-});