@teambit/generator 0.0.0-0207b202349a42efdb1a89d8bcc4a0deb2be689b

package/dist/create.cmd.d.ts

@@ -0,0 +1,36 @@
+import type { Command, CommandOptions } from '@teambit/cli';
+import type { ComponentID } from '@teambit/component';
+import type { 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;
+    force?: boolean;
+};
+export declare class CreateCmd implements Command {
+    private generator;
+    name: string;
+    description: string;
+    extendedDescription: string;
+    alias: string;
+    loader: boolean;
+    helpUrl: string;
+    arguments: {
+        name: string;
+        description: string;
+    }[];
+    examples: {
+        cmd: string;
+        description: string;
+    }[];
+    group: string;
+    options: CommandOptions;
+    constructor(generator: GeneratorMain);
+    report([templateName, componentNames]: [string, string[]], options: Partial<CreateOptions> & {
+        template?: string | ComponentID;
+        force?: boolean;
+    }): Promise<string>;
+}

package/dist/create.cmd.js

@@ -0,0 +1,74 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CreateCmd = void 0;
+function _chalk() {
+  const data = _interopRequireDefault(require("chalk"));
+  _chalk = function () {
+    return data;
+  };
+  return data;
+}
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * CreateOptions combines foundational properties with additional options for creating a component.
+ */
+
+class CreateCmd {
+  constructor(generator) {
+    this.generator = generator;
+    _defineProperty(this, "name", 'create <template-name> <component-names...>');
+    _defineProperty(this, "description", 'scaffold new component(s) from a template (sources, config, and env)');
+    _defineProperty(this, "extendedDescription", "Generates one or more components from a chosen template with ready-to-use source files, configuration, and environment. Use it to quickly scaffold consistent components across your workspace. Run 'bit templates' to discover available templates.");
+    _defineProperty(this, "alias", '');
+    _defineProperty(this, "loader", true);
+    _defineProperty(this, "helpUrl", 'reference/starters/create-starter');
+    _defineProperty(this, "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'
+    }]);
+    _defineProperty(this, "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 module 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 my-org.my-scope/hooks/use-session',
+      description: "creates a component named 'hooks/use-session' with scope 'my-org.my-scope'. \nthe scope is parsed from the component name (bit.cloud scopes contain a dot)."
+    }, {
+      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')."
+    }]);
+    _defineProperty(this, "group", 'component-development');
+    _defineProperty(this, "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)"], ['f', 'force', 'replace existing files at the target location']]);
+  }
+  async report([templateName, componentNames], options) {
+    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().default.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().default.green(title)}\n\n${componentsData}\n\n${footer}`;
+  }
+}
+exports.CreateCmd = CreateCmd;
+
+//# sourceMappingURL=create.cmd.js.map

package/dist/create.cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_chalk","data","_interopRequireDefault","require","e","__esModule","default","_defineProperty","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","CreateCmd","constructor","generator","name","description","cmd","report","templateName","componentNames","options","aspectId","template","results","generateComponentTemplate","title","length","componentsData","map","result","chalk","bold","id","toString","dir","envId","envSetBy","packageName","join","footer","green","exports"],"sources":["create.cmd.ts"],"sourcesContent":["import type { Command, CommandOptions } from '@teambit/cli';\nimport type { ComponentID } from '@teambit/component';\nimport chalk from 'chalk';\nimport type { GeneratorMain } from './generator.main.runtime';\nimport type { BaseComponentTemplateOptions } from './component-template';\n\n/**\n * CreateOptions combines foundational properties with additional options for creating a component.\n */\nexport type CreateOptions = BaseComponentTemplateOptions & {\n  env?: string;\n  aspect?: string;\n  force?: boolean;\n};\n\nexport class CreateCmd implements Command {\n  name = 'create <template-name> <component-names...>';\n  description = 'scaffold new component(s) from a template (sources, config, and env)';\n  extendedDescription =\n    \"Generates one or more components from a chosen template with ready-to-use source files, configuration, and environment. Use it to quickly scaffold consistent components across your workspace. Run 'bit templates' to discover available templates.\";\n  alias = '';\n  loader = true;\n  helpUrl = 'reference/starters/create-starter';\n  arguments = [\n    {\n      name: 'template-name',\n      description:\n        \"the template for generating the component \\n(run 'bit templates' for a list of available templates)\",\n    },\n    {\n      name: 'component-names...',\n      description: 'a list of component names to generate',\n    },\n  ];\n  examples = [\n    {\n      cmd: 'bit create react ui/button --aspect teambit.react/react-env',\n      description: \"creates a component named 'ui/button' using the 'react' template\",\n    },\n    {\n      cmd: 'bit create module utils/is-string utils/is-number --aspect teambit.node/node',\n      description:\n        \"creates two components, 'utils/is-string' and 'utils/is-number' using the 'node' template from the 'node' aspect(env)\",\n    },\n    {\n      cmd: 'bit create mdx docs/create-components --aspect teambit.mdx/mdx-env --scope my-org.my-scope',\n      description:\n        \"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`.\",\n    },\n    {\n      cmd: 'bit create react my-org.my-scope/hooks/use-session',\n      description:\n        \"creates a component named 'hooks/use-session' with scope 'my-org.my-scope'. \\nthe scope is parsed from the component name (bit.cloud scopes contain a dot).\",\n    },\n    {\n      cmd: 'bit create react ui/button --aspect teambit.react/react-env --env teambit.community/envs/community-react@3.0.3',\n      description:\n        \"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').\",\n    },\n  ];\n  group = 'component-development';\n  options = [\n    ['n', 'namespace <string>', `sets the component's namespace and nested dirs inside the scope`],\n    ['s', 'scope <string>', `sets the component's scope-name. if not entered, the default-scope will be used`],\n    ['a', 'aspect <string>', 'aspect-id of the template. helpful when multiple aspects use the same template name'],\n    ['t', 'template <string>', 'env-id of the template. alias for --aspect.'],\n    ['p', 'path <string>', 'relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`'],\n    ['e', 'env <string>', \"set the component's environment. (overrides the env from variants and the template)\"],\n    ['f', 'force', 'replace existing files at the target location'],\n  ] as CommandOptions;\n\n  constructor(private generator: GeneratorMain) {}\n\n  async report(\n    [templateName, componentNames]: [string, string[]],\n    options: Partial<CreateOptions> & {\n      template?: string | ComponentID;\n      force?: boolean;\n    }\n  ) {\n    options.aspectId = options.aspectId ?? options.template;\n    const results = await this.generator.generateComponentTemplate(componentNames, templateName, options);\n    const title = `${results.length} component(s) were created`;\n\n    const componentsData = results\n      .map((result) => {\n        return `${chalk.bold(result.id.toString())}\n    location: ${result.dir}\n    env:      ${result.envId} (set by ${result.envSetBy})\n    package:  ${result.packageName}\n`;\n      })\n      .join('\\n');\n    const footer = `env configuration is according to workspace variants, template config or --env flag.`;\n\n    return `${chalk.green(title)}\\n\\n${componentsData}\\n\\n${footer}`;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm.mjs

@@ -0,0 +1,8 @@
+// eslint-disable-next-line import/no-unresolved
+import cjsModule from './index.js';
+
+export const GeneratorAspect = cjsModule.GeneratorAspect;
+export const TemplateList = cjsModule.TemplateList;
+export const StarterList = cjsModule.StarterList;
+
+export default cjsModule;

package/dist/exceptions/workspace-path-exists.d.ts

@@ -0,0 +1,5 @@
+import { BitError } from '@teambit/bit-error';
+export declare class WorkspacePathExists extends BitError {
+    readonly path: string;
+    constructor(path: string);
+}

package/dist/exceptions/workspace-path-exists.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.WorkspacePathExists = void 0;
+function _bitError() {
+  const data = require("@teambit/bit-error");
+  _bitError = function () {
+    return data;
+  };
+  return data;
+}
+class WorkspacePathExists extends _bitError().BitError {
+  constructor(path) {
+    super(`unable to create a workspace at "${path}", this path already exists`);
+    this.path = path;
+  }
+}
+exports.WorkspacePathExists = WorkspacePathExists;
+
+//# sourceMappingURL=workspace-path-exists.js.map

package/dist/exceptions/workspace-path-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_bitError","data","require","WorkspacePathExists","BitError","constructor","path","exports"],"sources":["workspace-path-exists.ts"],"sourcesContent":["import { BitError } from '@teambit/bit-error';\n\nexport class WorkspacePathExists extends BitError {\n  constructor(readonly path: string) {\n    super(`unable to create a workspace at \"${path}\", this path already exists`);\n  }\n}\n"],"mappings":";;;;;;AAAA,SAAAA,UAAA;EAAA,MAAAC,IAAA,GAAAC,OAAA;EAAAF,SAAA,YAAAA,CAAA;IAAA,OAAAC,IAAA;EAAA;EAAA,OAAAA,IAAA;AAAA;AAEO,MAAME,mBAAmB,SAASC,oBAAQ,CAAC;EAChDC,WAAWA,CAAUC,IAAY,EAAE;IACjC,KAAK,CAAC,oCAAoCA,IAAI,6BAA6B,CAAC;IAAC,KAD1DA,IAAY,GAAZA,IAAY;EAEjC;AACF;AAACC,OAAA,CAAAJ,mBAAA,GAAAA,mBAAA","ignoreList":[]}

package/dist/generator-env-type.d.ts

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

package/dist/generator-env-type.js

@@ -0,0 +1,3 @@
+"use strict";
+
+//# sourceMappingURL=generator-env-type.js.map

package/dist/generator-env-type.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["generator-env-type.ts"],"sourcesContent":["import type { EnvHandler } from '@teambit/envs';\nimport type { TemplateList } from './template-list';\nimport type { StarterList } from './starter-list';\n\nexport interface GeneratorEnv {\n  /**\n   * return a template list instance.\n   */\n  generators(): EnvHandler<TemplateList>;\n  /**\n   * return a starter list instance.\n   */\n  starters(): EnvHandler<StarterList>;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/generator.aspect.d.ts

@@ -0,0 +1,2 @@
+import { Aspect } from '@teambit/harmony';
+export declare const GeneratorAspect: Aspect;

package/dist/generator.aspect.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.GeneratorAspect = void 0;
+function _harmony() {
+  const data = require("@teambit/harmony");
+  _harmony = function () {
+    return data;
+  };
+  return data;
+}
+const GeneratorAspect = exports.GeneratorAspect = _harmony().Aspect.create({
+  id: 'teambit.generator/generator'
+});
+
+//# sourceMappingURL=generator.aspect.js.map

package/dist/generator.aspect.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_harmony","data","require","GeneratorAspect","exports","Aspect","create","id"],"sources":["generator.aspect.ts"],"sourcesContent":["import { Aspect } from '@teambit/harmony';\n\nexport const GeneratorAspect = Aspect.create({\n  id: 'teambit.generator/generator',\n});\n"],"mappings":";;;;;;AAAA,SAAAA,SAAA;EAAA,MAAAC,IAAA,GAAAC,OAAA;EAAAF,QAAA,YAAAA,CAAA;IAAA,OAAAC,IAAA;EAAA;EAAA,OAAAA,IAAA;AAAA;AAEO,MAAME,eAAe,GAAAC,OAAA,CAAAD,eAAA,GAAGE,iBAAM,CAACC,MAAM,CAAC;EAC3CC,EAAE,EAAE;AACN,CAAC,CAAC","ignoreList":[]}

package/dist/generator.composition.d.ts

@@ -0,0 +1 @@
+export declare const Logo: () => import("react/jsx-runtime").JSX.Element;

package/dist/generator.composition.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Logo = void 0;
+function _react() {
+  const data = _interopRequireDefault(require("react"));
+  _react = function () {
+    return data;
+  };
+  return data;
+}
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const Logo = () => /*#__PURE__*/_react().default.createElement("div", {
+  style: {
+    height: '100%',
+    display: 'flex',
+    justifyContent: 'center'
+  }
+}, /*#__PURE__*/_react().default.createElement("img", {
+  style: {
+    width: 70
+  },
+  src: "https://static.bit.dev/extensions-icons/generator-new.svg"
+}));
+exports.Logo = Logo;
+
+//# sourceMappingURL=generator.composition.js.map

package/dist/generator.composition.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","data","_interopRequireDefault","require","e","__esModule","default","Logo","createElement","style","height","display","justifyContent","width","src","exports"],"sources":["generator.composition.tsx"],"sourcesContent":["import React from 'react';\n\nexport const Logo = () => (\n  <div style={{ height: '100%', display: 'flex', justifyContent: 'center' }}>\n    <img style={{ width: 70 }} src=\"https://static.bit.dev/extensions-icons/generator-new.svg\" />\n  </div>\n);\n"],"mappings":";;;;;;AAAA,SAAAA,OAAA;EAAA,MAAAC,IAAA,GAAAC,sBAAA,CAAAC,OAAA;EAAAH,MAAA,YAAAA,CAAA;IAAA,OAAAC,IAAA;EAAA;EAAA,OAAAA,IAAA;AAAA;AAA0B,SAAAC,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAEnB,MAAMG,IAAI,GAAGA,CAAA,kBAClBP,MAAA,GAAAM,OAAA,CAAAE,aAAA;EAAKC,KAAK,EAAE;IAAEC,MAAM,EAAE,MAAM;IAAEC,OAAO,EAAE,MAAM;IAAEC,cAAc,EAAE;EAAS;AAAE,gBACxEZ,MAAA,GAAAM,OAAA,CAAAE,aAAA;EAAKC,KAAK,EAAE;IAAEI,KAAK,EAAE;EAAG,CAAE;EAACC,GAAG,EAAC;AAA2D,CAAE,CACzF,CACN;AAACC,OAAA,CAAAR,IAAA,GAAAA,IAAA","ignoreList":[]}

package/dist/generator.docs.mdx

@@ -0,0 +1,8 @@
+---
+description: A simple interface for generating component templates.
+labels: ['generator', 'templates']
+---
+
+import { Generator } from '@teambit/generator.aspect-docs.generator';
+
+<Generator />

package/dist/generator.graphql.d.ts

@@ -0,0 +1,7 @@
+import type { Schema } from '@teambit/graphql';
+import type { GeneratorMain } from './generator.main.runtime';
+import type { CreateOptions } from './create.cmd';
+export type CreateQueryOptions = CreateOptions & {
+    templateName: string;
+};
+export declare function generatorSchema(generator: GeneratorMain): Schema;

package/dist/generator.graphql.js

@@ -0,0 +1,85 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.generatorSchema = generatorSchema;
+function _graphqlTag() {
+  const data = require("graphql-tag");
+  _graphqlTag = function () {
+    return data;
+  };
+  return data;
+}
+const _excluded = ["name", "templateName"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
+function generatorSchema(generator) {
+  return {
+    typeDefs: (0, _graphqlTag().gql)`
+      type GenerateResult {
+        id: String
+        dir: String
+        files: [String]
+      }
+
+      type Mutation {
+        # create Component by template
+        createComponent(
+          name: String!
+          templateName: String!
+          scope: String
+          namespace: String
+          aspect: String
+        ): [GenerateResult]
+      }
+
+      type TemplateDescriptor {
+        aspectId: String!
+        name: String!
+      }
+
+      type Generator {
+        templates: [TemplateDescriptor]
+      }
+
+      type Query {
+        generator: Generator
+      }
+    `,
+    resolvers: {
+      Mutation: {
+        createComponent: async (req, _ref) => {
+          let {
+              name,
+              templateName
+            } = _ref,
+            options = _objectWithoutProperties(_ref, _excluded);
+          const res = await generator.generateComponentTemplate([name], templateName, _objectSpread({
+            name
+          }, options));
+          return res.map(component => ({
+            id: component.id.toString(),
+            dir: component.dir,
+            files: component.files
+          }));
+        }
+      },
+      Generator: {
+        templates: async () => {
+          return generator.listTemplates();
+        }
+      },
+      Query: {
+        generator: () => generator
+      }
+    }
+  };
+}
+
+//# sourceMappingURL=generator.graphql.js.map

package/dist/generator.graphql.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_graphqlTag","data","require","_excluded","ownKeys","e","r","t","Object","keys","getOwnPropertySymbols","o","filter","getOwnPropertyDescriptor","enumerable","push","apply","_objectSpread","arguments","length","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","defineProperty","_toPropertyKey","value","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","_objectWithoutProperties","_objectWithoutPropertiesLoose","n","indexOf","propertyIsEnumerable","hasOwnProperty","generatorSchema","generator","typeDefs","gql","resolvers","Mutation","createComponent","req","_ref","name","templateName","options","res","generateComponentTemplate","map","component","id","toString","dir","files","Generator","templates","listTemplates","Query"],"sources":["generator.graphql.ts"],"sourcesContent":["import type { Schema } from '@teambit/graphql';\nimport { gql } from 'graphql-tag';\nimport type { GeneratorMain } from './generator.main.runtime';\nimport type { CreateOptions } from './create.cmd';\n\nexport type CreateQueryOptions = CreateOptions & { templateName: string };\n\nexport function generatorSchema(generator: GeneratorMain): Schema {\n  return {\n    typeDefs: gql`\n      type GenerateResult {\n        id: String\n        dir: String\n        files: [String]\n      }\n\n      type Mutation {\n        # create Component by template\n        createComponent(\n          name: String!\n          templateName: String!\n          scope: String\n          namespace: String\n          aspect: String\n        ): [GenerateResult]\n      }\n\n      type TemplateDescriptor {\n        aspectId: String!\n        name: String!\n      }\n\n      type Generator {\n        templates: [TemplateDescriptor]\n      }\n\n      type Query {\n        generator: Generator\n      }\n    `,\n    resolvers: {\n      Mutation: {\n        createComponent: async (req: any, { name, templateName, ...options }: CreateQueryOptions) => {\n          const res = await generator.generateComponentTemplate([name], templateName, { name, ...options });\n          return res.map((component) => ({\n            id: component.id.toString(),\n            dir: component.dir,\n            files: component.files,\n          }));\n        },\n      },\n      Generator: {\n        templates: async () => {\n          return generator.listTemplates();\n        },\n      },\n      Query: {\n        generator: () => generator,\n      },\n    },\n  };\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,212 @@
+import type { GraphqlMain } from '@teambit/graphql';
+import type { CLIMain } from '@teambit/cli';
+import type { Workspace } from '@teambit/workspace';
+import type { EnvDefinition, EnvsMain } from '@teambit/envs';
+import type { WorkspaceConfigFilesMain } from '@teambit/workspace-config-files';
+import type { ComponentMain, Component } from '@teambit/component';
+import type { Harmony, SlotRegistry } from '@teambit/harmony';
+import type { GitMain } from '@teambit/git';
+import type { AspectLoaderMain } from '@teambit/aspect-loader';
+import type { TrackerMain } from '@teambit/tracker';
+import type { NewComponentHelperMain } from '@teambit/new-component-helper';
+import type { Logger, LoggerMain } from '@teambit/logger';
+import type { DeprecationMain } from '@teambit/deprecation';
+import type { ComponentTemplate, GetComponentTemplates, PromptResults } from './component-template';
+import type { CreateOptions } from './create.cmd';
+import type { GenerateResult, InstallOptions, OnComponentCreateFn } from './component-generator';
+import type { WorkspaceTemplate } from './workspace-template';
+import type { NewOptions } from './new.cmd';
+export type ComponentTemplateSlot = SlotRegistry<ComponentTemplate[] | GetComponentTemplates>;
+export type WorkspaceTemplateSlot = SlotRegistry<WorkspaceTemplate[]>;
+export type OnComponentCreateSlot = SlotRegistry<OnComponentCreateFn>;
+export type TemplateDescriptor = {
+    aspectId: string;
+    titlePrefix?: string;
+    name: string;
+    description?: string;
+    hidden?: boolean;
+};
+type TemplateWithId = {
+    id: string;
+    envName?: string;
+};
+type WorkspaceTemplateWithId = TemplateWithId & {
+    template: WorkspaceTemplate;
+};
+type ComponentTemplateWithId = TemplateWithId & {
+    template: ComponentTemplate;
+};
+type LegacyGlobal = {
+    classInstance: any;
+    methodName: string;
+    value: any;
+    empty: any;
+};
+export type BitApi = {
+    isCoreAspect: (id: string) => boolean;
+    loadBit: (path?: string) => Promise<Harmony>;
+    restoreGlobalsFromSnapshot: (globals: LegacyGlobal[]) => void;
+    takeLegacyGlobalsSnapshot: () => LegacyGlobal[];
+};
+export type GenerateWorkspaceTemplateResult = {
+    workspacePath: string;
+    appName?: string;
+};
+export type GeneratorConfig = {
+    /**
+     * array of aspects to include in the list of templates.
+     */
+    aspects: string[];
+    /**
+     * by default core templates are shown.
+     * use this to hide them unless `--show-all` flag of `bit templates` was used
+     */
+    hideCoreTemplates: boolean;
+    /**
+     * default envs.
+     */
+    envs?: string[];
+};
+export declare class GeneratorMain {
+    private componentTemplateSlot;
+    private workspaceTemplateSlot;
+    private onComponentCreateSlot;
+    private config;
+    private workspace;
+    private envs;
+    private aspectLoader;
+    private newComponentHelper;
+    private componentAspect;
+    private tracker;
+    private logger;
+    private git;
+    private wsConfigFiles;
+    private deprecation;
+    private aspectLoaded;
+    private bitApi;
+    constructor(componentTemplateSlot: ComponentTemplateSlot, workspaceTemplateSlot: WorkspaceTemplateSlot, onComponentCreateSlot: OnComponentCreateSlot, config: GeneratorConfig, workspace: Workspace, envs: EnvsMain, aspectLoader: AspectLoaderMain, newComponentHelper: NewComponentHelperMain, componentAspect: ComponentMain, tracker: TrackerMain, logger: Logger, git: GitMain, wsConfigFiles: WorkspaceConfigFilesMain, deprecation: DeprecationMain);
+    setBitApi(bitApi: BitApi): void;
+    /**
+     * register a new component template.
+     * @param templates array of component templates or a function that returns an array of component templates.
+     * prefer to use the function to improve performance by loading the templates only when needed.
+     */
+    registerComponentTemplate(templates: ComponentTemplate[] | GetComponentTemplates): this;
+    /**
+     * register a new workspace starter.
+     */
+    registerWorkspaceTemplate(templates: WorkspaceTemplate[]): this;
+    registerOnComponentCreate(fn: OnComponentCreateFn): this;
+    /**
+     * list all component templates registered in the workspace or workspace templates in case the
+     * workspace is not available
+     */
+    listTemplates({ aspect }?: {
+        aspect?: string;
+    }): Promise<TemplateDescriptor[]>;
+    private getTemplateDescriptor;
+    /**
+     * @deprecated use this.listTemplates()
+     */
+    listComponentTemplates(opts: {
+        aspect?: string;
+    }): Promise<TemplateDescriptor[]>;
+    isRunningInsideWorkspace(): boolean;
+    /**
+     * get all component templates registered by a specific aspect ID.
+     */
+    getComponentTemplateByAspect(aspectId: string): ComponentTemplate[];
+    /**
+     * returns a specific component template.
+     */
+    getComponentTemplate(name: string, aspectId?: string): Promise<ComponentTemplateWithId | undefined>;
+    private findTemplateByAspectIdAndName;
+    /**
+     * get or create a global scope, import the non-core aspects, load bit from that scope, create
+     * capsules for the aspects and load them from the capsules.
+     */
+    private loadAspectsFromGlobalScope;
+    /**
+     * Get the generator aspect and the envs aspect from an harmony instance of the global scope
+     */
+    private getGlobalGeneratorEnvs;
+    /**
+     * in the case the aspect-id is given and this aspect doesn't exist locally, import it to the
+     * global scope and load it from the capsule
+     */
+    findWorkspaceTemplateInGlobalScope(aspectId: string, name?: string): Promise<{
+        workspaceTemplate?: WorkspaceTemplate;
+        aspect?: Component;
+    }>;
+    findTemplateInOtherWorkspace(workspacePath: string, name: string, aspectId?: string): Promise<{
+        workspaceTemplate: WorkspaceTemplate | undefined;
+        aspect: Component;
+    }>;
+    /**
+     * returns a specific workspace template.
+     */
+    getWorkspaceTemplate(name: string, aspectId?: string): Promise<{
+        workspaceTemplate: WorkspaceTemplate;
+        aspect?: Component;
+    }>;
+    searchRegisteredWorkspaceTemplate(name?: string, aspectId?: string, remoteEnvsAspect?: EnvsMain): Promise<WorkspaceTemplate | undefined>;
+    getTemplateWithId(templateName: string, aspect?: string): Promise<ComponentTemplateWithId>;
+    /**
+     * Parse the scope from a component name if provided in the format: scope/name
+     * This only works for bit.cloud scopes (containing a dot), e.g., "my-org.my-scope/hooks/use-session"
+     * Local bare-scopes don't contain a dot, so we can't distinguish between scope/name and namespace/name.
+     * @returns { scope, name } where scope is the extracted scope (or undefined) and name is the remaining component name
+     */
+    private parseScopeFromComponentIdStr;
+    generateComponentTemplate(componentNames: string[], templateName: string, options: Partial<CreateOptions>, installOptions?: InstallOptions, promptResults?: PromptResults): Promise<GenerateResult[]>;
+    private getEnvIdFromTemplateWithId;
+    generateWorkspaceTemplate(workspaceName: string, templateName: string, options: NewOptions & {
+        aspect?: string;
+        currentDir?: boolean;
+    }): Promise<GenerateWorkspaceTemplateResult>;
+    private warnAboutDeprecation;
+    private getAllComponentTemplatesDescriptorsFlattened;
+    private getAllComponentTemplatesFlattened;
+    private getAllWorkspaceTemplatesDescriptorFlattened;
+    private getAllWorkspaceTemplatesFlattened;
+    /**
+     * list all starter templates registered by an env.
+     */
+    listEnvWorkspaceTemplates(envId: string, remoteEnvsAspect?: EnvsMain): Promise<Array<WorkspaceTemplateWithId>>;
+    /**
+     * list all component templates registered by an env.
+     */
+    listEnvComponentTemplateDescriptors(ids?: string[], aspectId?: string): Promise<TemplateDescriptor[]>;
+    getConfiguredEnvs(): string[];
+    listEnvComponentTemplates(ids?: string[], aspectId?: string): Promise<Array<ComponentTemplateWithId>>;
+    loadEnvs(ids?: string[], remoteEnvsAspect?: EnvsMain): Promise<EnvDefinition[]>;
+    loadAspects(): Promise<void>;
+    /**
+     * Reload the generator config when workspace config changes.
+     * This ensures that changes to envs configuration in workspace.jsonc are reflected
+     * in long-running processes like "bit server".
+     */
+    onWorkspaceConfigChange(): Promise<void>;
+    static slots: (((registerFn: () => string) => SlotRegistry<ComponentTemplate[]>) | ((registerFn: () => string) => SlotRegistry<WorkspaceTemplate[]>) | ((registerFn: () => string) => SlotRegistry<OnComponentCreateFn>))[];
+    static dependencies: import("@teambit/harmony").Aspect[];
+    static runtime: import("@teambit/harmony").RuntimeDefinition;
+    static provider([workspace, cli, graphql, envs, aspectLoader, newComponentHelper, componentAspect, tracker, loggerMain, git, wsConfigFiles, deprecation,]: [
+        Workspace,
+        CLIMain,
+        GraphqlMain,
+        EnvsMain,
+        AspectLoaderMain,
+        NewComponentHelperMain,
+        ComponentMain,
+        TrackerMain,
+        LoggerMain,
+        GitMain,
+        WorkspaceConfigFilesMain,
+        DeprecationMain
+    ], config: GeneratorConfig, [componentTemplateSlot, workspaceTemplateSlot, onComponentCreateSlot]: [
+        ComponentTemplateSlot,
+        WorkspaceTemplateSlot,
+        OnComponentCreateSlot
+    ]): Promise<GeneratorMain>;
+}
+export {};