@teambit/workspace 0.0.775 → 0.0.776

package/dist/envs-subcommands/envs-set.cmd.js

@@ -31,6 +31,16 @@ function _chalk() {
   return data;
 }
 
+function _constants() {
+  const data = require("@teambit/legacy/dist/constants");
+
+  _constants = function () {
+    return data;
+  };
+
+  return data;
+}
+
 class EnvsSetCmd {
   constructor(workspace) {
     this.workspace = workspace;
@@ -38,7 +48,7 @@ class EnvsSetCmd {
     (0, _defineProperty2().default)(this, "description", 'Sets one or more components with a development environment (env)');
     (0, _defineProperty2().default)(this, "arguments", [{
       name: 'component-pattern',
-      description: 'component name, component id, or component pattern. use component pattern to select multiple components. \nuse commas to separate patterns and "!" to exclude. e.g. "ui/**, !ui/button"\nwrap the pattern with quotes'
+      description: _constants().COMPONENT_PATTERN_HELP
     }, {
       name: 'env',
       description: "the env's component id (include version for non-core envs. e.g, `teambit.community/envs/community-react@1.95.13`)"

package/dist/envs-subcommands/envs-set.cmd.js.map

@@ -1 +1 @@
-{"version":3,"names":["EnvsSetCmd","constructor","workspace","name","description","cmd","report","pattern","env","envId","resolveComponentId","componentIds","idsByPattern","setEnvToComponents","chalk","bold","toString","map","compId","join"],"sources":["envs-set.cmd.ts"],"sourcesContent":["import { Command } from '@teambit/cli';\nimport chalk from 'chalk';\nimport { Workspace } from '../workspace';\n\nexport class EnvsSetCmd implements Command {\n  name = 'set <component-pattern> <env>';\n  description = 'Sets one or more components with a development environment (env)';\n  arguments = [\n    {\n      name: 'component-pattern',\n      description:\n        'component name, component id, or component pattern. use component pattern to select multiple components. \\nuse commas to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\\nwrap the pattern with quotes',\n    },\n    {\n      name: 'env',\n      description:\n        \"the env's component id (include version for non-core envs. e.g, `teambit.community/envs/community-react@1.95.13`)\",\n    },\n  ];\n  examples = [\n    {\n      cmd: 'set ui/button teambit.react/react',\n      description: \"configures 'ui/button' to use the 'teambit.react/react' env\",\n    },\n    {\n      cmd: 'set ui/button teambit.community/envs/community-mdx@1.95.16',\n      description: \"configures 'ui/button' to use the (non-core) 'teambit.community/envs/community-mdx@1.95.16' env\",\n    },\n    {\n      cmd: 'set \"ui/**\" teambit.react/react',\n      description: \"configures all components that have the 'ui' namespace to use the teambit.react/react env\",\n    },\n  ];\n  options = [];\n  group = 'development';\n\n  constructor(private workspace: Workspace) {}\n\n  async report([pattern, env]: [string, string]) {\n    const envId = await this.workspace.resolveComponentId(env);\n    const componentIds = await this.workspace.idsByPattern(pattern);\n    await this.workspace.setEnvToComponents(envId, componentIds);\n    return `added ${chalk.bold(envId.toString())} env to the following component(s):\n${componentIds.map((compId) => compId.toString()).join('\\n')}`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AACA;EAAA;;EAAA;IAAA;EAAA;;EAAA;AAAA;;AAGO,MAAMA,UAAN,CAAoC;EAgCzCC,WAAW,CAASC,SAAT,EAA+B;IAAA,KAAtBA,SAAsB,GAAtBA,SAAsB;IAAA,8CA/BnC,+BA+BmC;IAAA,qDA9B5B,kEA8B4B;IAAA,mDA7B9B,CACV;MACEC,IAAI,EAAE,mBADR;MAEEC,WAAW,EACT;IAHJ,CADU,EAMV;MACED,IAAI,EAAE,KADR;MAEEC,WAAW,EACT;IAHJ,CANU,CA6B8B;IAAA,kDAjB/B,CACT;MACEC,GAAG,EAAE,mCADP;MAEED,WAAW,EAAE;IAFf,CADS,EAKT;MACEC,GAAG,EAAE,4DADP;MAEED,WAAW,EAAE;IAFf,CALS,EAST;MACEC,GAAG,EAAE,iCADP;MAEED,WAAW,EAAE;IAFf,CATS,CAiB+B;IAAA,iDAHhC,EAGgC;IAAA,+CAFlC,aAEkC;EAAE;;EAEhC,MAANE,MAAM,CAAC,CAACC,OAAD,EAAUC,GAAV,CAAD,EAAmC;IAC7C,MAAMC,KAAK,GAAG,MAAM,KAAKP,SAAL,CAAeQ,kBAAf,CAAkCF,GAAlC,CAApB;IACA,MAAMG,YAAY,GAAG,MAAM,KAAKT,SAAL,CAAeU,YAAf,CAA4BL,OAA5B,CAA3B;IACA,MAAM,KAAKL,SAAL,CAAeW,kBAAf,CAAkCJ,KAAlC,EAAyCE,YAAzC,CAAN;IACA,OAAQ,SAAQG,gBAAA,CAAMC,IAAN,CAAWN,KAAK,CAACO,QAAN,EAAX,CAA6B;AACjD,EAAEL,YAAY,CAACM,GAAb,CAAkBC,MAAD,IAAYA,MAAM,CAACF,QAAP,EAA7B,EAAgDG,IAAhD,CAAqD,IAArD,CAA2D,EADzD;EAED;;AAxCwC"}
+{"version":3,"names":["EnvsSetCmd","constructor","workspace","name","description","COMPONENT_PATTERN_HELP","cmd","report","pattern","env","envId","resolveComponentId","componentIds","idsByPattern","setEnvToComponents","chalk","bold","toString","map","compId","join"],"sources":["envs-set.cmd.ts"],"sourcesContent":["import { Command } from '@teambit/cli';\nimport chalk from 'chalk';\nimport { COMPONENT_PATTERN_HELP } from '@teambit/legacy/dist/constants';\nimport { Workspace } from '../workspace';\n\nexport class EnvsSetCmd implements Command {\n  name = 'set <component-pattern> <env>';\n  description = 'Sets one or more components with a development environment (env)';\n  arguments = [\n    {\n      name: 'component-pattern',\n      description: COMPONENT_PATTERN_HELP,\n    },\n    {\n      name: 'env',\n      description:\n        \"the env's component id (include version for non-core envs. e.g, `teambit.community/envs/community-react@1.95.13`)\",\n    },\n  ];\n  examples = [\n    {\n      cmd: 'set ui/button teambit.react/react',\n      description: \"configures 'ui/button' to use the 'teambit.react/react' env\",\n    },\n    {\n      cmd: 'set ui/button teambit.community/envs/community-mdx@1.95.16',\n      description: \"configures 'ui/button' to use the (non-core) 'teambit.community/envs/community-mdx@1.95.16' env\",\n    },\n    {\n      cmd: 'set \"ui/**\" teambit.react/react',\n      description: \"configures all components that have the 'ui' namespace to use the teambit.react/react env\",\n    },\n  ];\n  options = [];\n  group = 'development';\n\n  constructor(private workspace: Workspace) {}\n\n  async report([pattern, env]: [string, string]) {\n    const envId = await this.workspace.resolveComponentId(env);\n    const componentIds = await this.workspace.idsByPattern(pattern);\n    await this.workspace.setEnvToComponents(envId, componentIds);\n    return `added ${chalk.bold(envId.toString())} env to the following component(s):\n${componentIds.map((compId) => compId.toString()).join('\\n')}`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AACA;EAAA;;EAAA;IAAA;EAAA;;EAAA;AAAA;;AACA;EAAA;;EAAA;IAAA;EAAA;;EAAA;AAAA;;AAGO,MAAMA,UAAN,CAAoC;EA+BzCC,WAAW,CAASC,SAAT,EAA+B;IAAA,KAAtBA,SAAsB,GAAtBA,SAAsB;IAAA,8CA9BnC,+BA8BmC;IAAA,qDA7B5B,kEA6B4B;IAAA,mDA5B9B,CACV;MACEC,IAAI,EAAE,mBADR;MAEEC,WAAW,EAAEC;IAFf,CADU,EAKV;MACEF,IAAI,EAAE,KADR;MAEEC,WAAW,EACT;IAHJ,CALU,CA4B8B;IAAA,kDAjB/B,CACT;MACEE,GAAG,EAAE,mCADP;MAEEF,WAAW,EAAE;IAFf,CADS,EAKT;MACEE,GAAG,EAAE,4DADP;MAEEF,WAAW,EAAE;IAFf,CALS,EAST;MACEE,GAAG,EAAE,iCADP;MAEEF,WAAW,EAAE;IAFf,CATS,CAiB+B;IAAA,iDAHhC,EAGgC;IAAA,+CAFlC,aAEkC;EAAE;;EAEhC,MAANG,MAAM,CAAC,CAACC,OAAD,EAAUC,GAAV,CAAD,EAAmC;IAC7C,MAAMC,KAAK,GAAG,MAAM,KAAKR,SAAL,CAAeS,kBAAf,CAAkCF,GAAlC,CAApB;IACA,MAAMG,YAAY,GAAG,MAAM,KAAKV,SAAL,CAAeW,YAAf,CAA4BL,OAA5B,CAA3B;IACA,MAAM,KAAKN,SAAL,CAAeY,kBAAf,CAAkCJ,KAAlC,EAAyCE,YAAzC,CAAN;IACA,OAAQ,SAAQG,gBAAA,CAAMC,IAAN,CAAWN,KAAK,CAACO,QAAN,EAAX,CAA6B;AACjD,EAAEL,YAAY,CAACM,GAAb,CAAkBC,MAAD,IAAYA,MAAM,CAACF,QAAP,EAA7B,EAAgDG,IAAhD,CAAqD,IAArD,CAA2D,EADzD;EAED;;AAvCwC"}

package/dist/pattern.cmd.d.ts

@@ -6,6 +6,10 @@ export declare class PatternCommand implements Command {
     alias: string;
     description: string;
     extendedDescription: string;
+    examples: {
+        cmd: string;
+        description: string;
+    }[];
     group: string;
     private: boolean;
     options: CommandOptions;

package/dist/pattern.cmd.js

@@ -45,6 +45,22 @@ to exclude, use "!". e.g. "ui/**, !ui/button"
 always wrap the pattern with quotes to avoid collision with shell commands.
 the matching algorithm is done by multimatch (@see https://github.com/sindresorhus/multimatch)
 `);
+    (0, _defineProperty2().default)(this, "examples", [{
+      cmd: 'bit pattern "**"',
+      description: 'matches all components'
+    }, {
+      cmd: 'bit pattern "*/ui/*"',
+      description: 'matches components with any scope-name and the "ui" namespace. e.g. "ui/button" but not "ui/elements/button"'
+    }, {
+      cmd: 'bit pattern "*/ui/**"',
+      description: 'matches components that their namespace starts with "ui/" e.g. "ui/button", "ui/elements/button"'
+    }, {
+      cmd: 'bit pattern "bar, foo"',
+      description: 'matches two components: bar and foo'
+    }, {
+      cmd: 'bit pattern "my-scope.org/**"',
+      description: 'matches all components of the scope "my-scope.org"'
+    }]);
     (0, _defineProperty2().default)(this, "group", 'development');
     (0, _defineProperty2().default)(this, "private", false);
     (0, _defineProperty2().default)(this, "options", [['j', 'json', 'return the output as JSON']]);

package/dist/pattern.cmd.js.map

@@ -1 +1 @@
-{"version":3,"names":["PatternCommand","constructor","workspace","report","pattern","ids","json","title","chalk","green","bold","length","toString","join","idsByPattern"],"sources":["pattern.cmd.ts"],"sourcesContent":["import { Command, CommandOptions } from '@teambit/cli';\nimport chalk from 'chalk';\nimport { Workspace } from './workspace';\n\nexport class PatternCommand implements Command {\n  name = 'pattern <pattern>';\n  alias = '';\n  description = 'list the component ids matching the given pattern';\n  extendedDescription = `this command helps validating a pattern before using it in other commands.\na pattern can be a simple component-id or component-name. e.g. \"ui/button\".\na pattern can be used with wildcards for multiple component ids, e.g. \"org.scope/utils/**\".\nto enter multiple patterns, separate them by a comma, e.g. \"ui/*, lib/*\"\nto exclude, use \"!\". e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nthe matching algorithm is done by multimatch (@see https://github.com/sindresorhus/multimatch)\n`;\n\n  group = 'development';\n  private = false;\n  options = [['j', 'json', 'return the output as JSON']] as CommandOptions;\n\n  constructor(private workspace: Workspace) {}\n\n  async report([pattern]: [string]) {\n    const ids = await this.json([pattern]);\n    const title = chalk.green(`found ${chalk.bold(ids.length.toString())} components matching the pattern`);\n    return `${title}\\n${ids.join('\\n')}`;\n  }\n\n  async json([pattern]: [string]) {\n    return this.workspace.idsByPattern(pattern, false);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AACA;EAAA;;EAAA;IAAA;EAAA;;EAAA;AAAA;;AAGO,MAAMA,cAAN,CAAwC;EAiB7CC,WAAW,CAASC,SAAT,EAA+B;IAAA,KAAtBA,SAAsB,GAAtBA,SAAsB;IAAA,8CAhBnC,mBAgBmC;IAAA,+CAflC,EAekC;IAAA,qDAd5B,mDAc4B;IAAA,6DAbnB;AACzB;AACA;AACA;AACA;AACA;AACA;AACA,CAM4C;IAAA,+CAJlC,aAIkC;IAAA,iDAHhC,KAGgC;IAAA,iDAFhC,CAAC,CAAC,GAAD,EAAM,MAAN,EAAc,2BAAd,CAAD,CAEgC;EAAE;;EAEhC,MAANC,MAAM,CAAC,CAACC,OAAD,CAAD,EAAsB;IAChC,MAAMC,GAAG,GAAG,MAAM,KAAKC,IAAL,CAAU,CAACF,OAAD,CAAV,CAAlB;;IACA,MAAMG,KAAK,GAAGC,gBAAA,CAAMC,KAAN,CAAa,SAAQD,gBAAA,CAAME,IAAN,CAAWL,GAAG,CAACM,MAAJ,CAAWC,QAAX,EAAX,CAAkC,kCAAvD,CAAd;;IACA,OAAQ,GAAEL,KAAM,KAAIF,GAAG,CAACQ,IAAJ,CAAS,IAAT,CAAe,EAAnC;EACD;;EAES,MAAJP,IAAI,CAAC,CAACF,OAAD,CAAD,EAAsB;IAC9B,OAAO,KAAKF,SAAL,CAAeY,YAAf,CAA4BV,OAA5B,EAAqC,KAArC,CAAP;EACD;;AA3B4C"}
+{"version":3,"names":["PatternCommand","constructor","workspace","cmd","description","report","pattern","ids","json","title","chalk","green","bold","length","toString","join","idsByPattern"],"sources":["pattern.cmd.ts"],"sourcesContent":["import { Command, CommandOptions } from '@teambit/cli';\nimport chalk from 'chalk';\nimport { Workspace } from './workspace';\n\nexport class PatternCommand implements Command {\n  name = 'pattern <pattern>';\n  alias = '';\n  description = 'list the component ids matching the given pattern';\n  extendedDescription = `this command helps validating a pattern before using it in other commands.\na pattern can be a simple component-id or component-name. e.g. \"ui/button\".\na pattern can be used with wildcards for multiple component ids, e.g. \"org.scope/utils/**\".\nto enter multiple patterns, separate them by a comma, e.g. \"ui/*, lib/*\"\nto exclude, use \"!\". e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nthe matching algorithm is done by multimatch (@see https://github.com/sindresorhus/multimatch)\n`;\n  examples = [\n    { cmd: 'bit pattern \"**\"', description: 'matches all components' },\n    {\n      cmd: 'bit pattern \"*/ui/*\"',\n      description:\n        'matches components with any scope-name and the \"ui\" namespace. e.g. \"ui/button\" but not \"ui/elements/button\"',\n    },\n    {\n      cmd: 'bit pattern \"*/ui/**\"',\n      description: 'matches components that their namespace starts with \"ui/\" e.g. \"ui/button\", \"ui/elements/button\"',\n    },\n    { cmd: 'bit pattern \"bar, foo\"', description: 'matches two components: bar and foo' },\n    { cmd: 'bit pattern \"my-scope.org/**\"', description: 'matches all components of the scope \"my-scope.org\"' },\n  ];\n  group = 'development';\n  private = false;\n  options = [['j', 'json', 'return the output as JSON']] as CommandOptions;\n\n  constructor(private workspace: Workspace) {}\n\n  async report([pattern]: [string]) {\n    const ids = await this.json([pattern]);\n    const title = chalk.green(`found ${chalk.bold(ids.length.toString())} components matching the pattern`);\n    return `${title}\\n${ids.join('\\n')}`;\n  }\n\n  async json([pattern]: [string]) {\n    return this.workspace.idsByPattern(pattern, false);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AACA;EAAA;;EAAA;IAAA;EAAA;;EAAA;AAAA;;AAGO,MAAMA,cAAN,CAAwC;EA8B7CC,WAAW,CAASC,SAAT,EAA+B;IAAA,KAAtBA,SAAsB,GAAtBA,SAAsB;IAAA,8CA7BnC,mBA6BmC;IAAA,+CA5BlC,EA4BkC;IAAA,qDA3B5B,mDA2B4B;IAAA,6DA1BnB;AACzB;AACA;AACA;AACA;AACA;AACA;AACA,CAmB4C;IAAA,kDAlB/B,CACT;MAAEC,GAAG,EAAE,kBAAP;MAA2BC,WAAW,EAAE;IAAxC,CADS,EAET;MACED,GAAG,EAAE,sBADP;MAEEC,WAAW,EACT;IAHJ,CAFS,EAOT;MACED,GAAG,EAAE,uBADP;MAEEC,WAAW,EAAE;IAFf,CAPS,EAWT;MAAED,GAAG,EAAE,wBAAP;MAAiCC,WAAW,EAAE;IAA9C,CAXS,EAYT;MAAED,GAAG,EAAE,+BAAP;MAAwCC,WAAW,EAAE;IAArD,CAZS,CAkB+B;IAAA,+CAJlC,aAIkC;IAAA,iDAHhC,KAGgC;IAAA,iDAFhC,CAAC,CAAC,GAAD,EAAM,MAAN,EAAc,2BAAd,CAAD,CAEgC;EAAE;;EAEhC,MAANC,MAAM,CAAC,CAACC,OAAD,CAAD,EAAsB;IAChC,MAAMC,GAAG,GAAG,MAAM,KAAKC,IAAL,CAAU,CAACF,OAAD,CAAV,CAAlB;;IACA,MAAMG,KAAK,GAAGC,gBAAA,CAAMC,KAAN,CAAa,SAAQD,gBAAA,CAAME,IAAN,CAAWL,GAAG,CAACM,MAAJ,CAAWC,QAAX,EAAX,CAAkC,kCAAvD,CAAd;;IACA,OAAQ,GAAEL,KAAM,KAAIF,GAAG,CAACQ,IAAJ,CAAS,IAAT,CAAe,EAAnC;EACD;;EAES,MAAJP,IAAI,CAAC,CAACF,OAAD,CAAD,EAAsB;IAC9B,OAAO,KAAKJ,SAAL,CAAec,YAAf,CAA4BV,OAA5B,EAAqC,KAArC,CAAP;EACD;;AAxC4C"}

package/dist/use.cmd.d.ts

@@ -0,0 +1,19 @@
+import { Command, CommandOptions } from '@teambit/cli';
+import { Workspace } from './workspace';
+export declare class UseCmd implements Command {
+    private workspace;
+    name: string;
+    group: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+    }[];
+    alias: string;
+    options: CommandOptions;
+    loader: boolean;
+    migration: boolean;
+    remoteOp: boolean;
+    constructor(workspace: Workspace);
+    report([id]: [string]): Promise<any>;
+}

package/dist/use.cmd.js

@@ -0,0 +1,60 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+require("core-js/modules/es.array.iterator.js");
+
+require("core-js/modules/es.promise.js");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UseCmd = void 0;
+
+function _defineProperty2() {
+  const data = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+  _defineProperty2 = function () {
+    return data;
+  };
+
+  return data;
+}
+
+function _chalk() {
+  const data = _interopRequireDefault(require("chalk"));
+
+  _chalk = function () {
+    return data;
+  };
+
+  return data;
+}
+
+class UseCmd {
+  constructor(workspace) {
+    this.workspace = workspace;
+    (0, _defineProperty2().default)(this, "name", 'use <component-id>');
+    (0, _defineProperty2().default)(this, "group", 'collaborate');
+    (0, _defineProperty2().default)(this, "description", 'set aspects in the workspace/scope config to make them loadable by the workspace/scope');
+    (0, _defineProperty2().default)(this, "arguments", [{
+      name: 'component-id',
+      description: 'the component ID of the aspect'
+    }]);
+    (0, _defineProperty2().default)(this, "alias", '');
+    (0, _defineProperty2().default)(this, "options", []);
+    (0, _defineProperty2().default)(this, "loader", true);
+    (0, _defineProperty2().default)(this, "migration", true);
+    (0, _defineProperty2().default)(this, "remoteOp", true);
+  }
+
+  async report([id]) {
+    const aspectIdAdded = await this.workspace.use(id);
+    return _chalk().default.green(`aspect "${aspectIdAdded}" has been saved into the workspace.jsonc file.`);
+  }
+
+}
+
+exports.UseCmd = UseCmd;
+
+//# sourceMappingURL=use.cmd.js.map

package/dist/use.cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["UseCmd","constructor","workspace","name","description","report","id","aspectIdAdded","use","chalk","green"],"sources":["use.cmd.ts"],"sourcesContent":["import { Command, CommandOptions } from '@teambit/cli';\nimport chalk from 'chalk';\nimport { Workspace } from './workspace';\n\nexport class UseCmd implements Command {\n  name = 'use <component-id>';\n  group = 'collaborate';\n  description = 'set aspects in the workspace/scope config to make them loadable by the workspace/scope';\n  arguments = [{ name: 'component-id', description: 'the component ID of the aspect' }];\n  alias = '';\n  options = [] as CommandOptions;\n  loader = true;\n  migration = true;\n  remoteOp = true;\n\n  constructor(private workspace: Workspace) {}\n\n  async report([id]: [string]): Promise<any> {\n    const aspectIdAdded = await this.workspace.use(id);\n    return chalk.green(`aspect \"${aspectIdAdded}\" has been saved into the workspace.jsonc file.`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AACA;EAAA;;EAAA;IAAA;EAAA;;EAAA;AAAA;;AAGO,MAAMA,MAAN,CAAgC;EAWrCC,WAAW,CAASC,SAAT,EAA+B;IAAA,KAAtBA,SAAsB,GAAtBA,SAAsB;IAAA,8CAVnC,oBAUmC;IAAA,+CATlC,aASkC;IAAA,qDAR5B,wFAQ4B;IAAA,mDAP9B,CAAC;MAAEC,IAAI,EAAE,cAAR;MAAwBC,WAAW,EAAE;IAArC,CAAD,CAO8B;IAAA,+CANlC,EAMkC;IAAA,iDALhC,EAKgC;IAAA,gDAJjC,IAIiC;IAAA,mDAH9B,IAG8B;IAAA,kDAF/B,IAE+B;EAAE;;EAEhC,MAANC,MAAM,CAAC,CAACC,EAAD,CAAD,EAA+B;IACzC,MAAMC,aAAa,GAAG,MAAM,KAAKL,SAAL,CAAeM,GAAf,CAAmBF,EAAnB,CAA5B;IACA,OAAOG,gBAAA,CAAMC,KAAN,CAAa,WAAUH,aAAc,iDAArC,CAAP;EACD;;AAhBoC"}

package/dist/workspace.d.ts

@@ -321,6 +321,7 @@ export declare class Workspace implements ComponentFactory {
      * @param override whether add details to an existing component or re-define it
      */
     add(componentPaths: PathOsBasedRelative[], id?: string, main?: string, override?: boolean): Promise<AddActionResults>;
+    use(aspectIdStr: string): Promise<string>;
     /**
      * add a new component to the .bitmap file.
      * this method only adds the records in memory but doesn't persist to the filesystem.

package/dist/workspace.js

@@ -1247,6 +1247,31 @@ the following envs are used in this workspace: ${availableEnvs.join(', ')}`);
     await this.bitMap.write();
     return addResults;
   }
+
+  async use(aspectIdStr) {
+    const aspectId = await this.resolveComponentId(aspectIdStr);
+    let aspectIdToAdd = aspectId.toStringWithoutVersion();
+
+    if (!(await this.hasId(aspectId))) {
+      const loadedIds = await this.scope.loadAspects([aspectIdStr], true);
+      if (loadedIds[0]) aspectIdToAdd = loadedIds[0];
+    }
+
+    const config = this.harmony.get('teambit.harmony/config').workspaceConfig;
+
+    if (!config) {
+      throw new Error(`use() unable to get the workspace config`);
+    }
+
+    config.setExtension(aspectIdToAdd, {}, {
+      overrideExisting: false,
+      ignoreVersion: false
+    });
+    await config.write({
+      dir: _path2().default.dirname(config.path)
+    });
+    return aspectIdToAdd;
+  }
   /**
    * add a new component to the .bitmap file.
    * this method only adds the records in memory but doesn't persist to the filesystem.