@teambit/tracker 1.0.1174 → 1.0.1176

package/dist/add-cmd.d.ts

@@ -9,6 +9,7 @@ type AddFlags = {
     scope?: string;
     env?: string;
     override: boolean;
+    root?: boolean;
 };
 type AddResults = {
     addedComponents: Array<{
@@ -29,6 +30,6 @@ export declare class AddCmd implements Command {
     loader: boolean;
     constructor(tracker: TrackerMain);
     report([paths]: [string[]], addFlags: AddFlags): Promise<string>;
-    json([paths]: [string[]], { id, main, namespace, scope, env, override }: AddFlags): Promise<AddResults>;
+    json([paths]: [string[]], { id, main, namespace, scope, env, override, root }: AddFlags): Promise<AddResults>;
 }
 export {};

package/dist/add-cmd.js

@@ -53,7 +53,7 @@ class AddCmd {
     _defineProperty(this, "extendedDescription", 'Registers one or more directories as Bit components without changing your files. Each provided path becomes a component root tracked by Bit.');
     _defineProperty(this, "helpUrl", 'reference/workspace/component-directory');
     _defineProperty(this, "alias", 'a');
-    _defineProperty(this, "options", [['i', 'id <name>', 'manually set component id'], ['m', 'main <file>', 'define component entry point'], ['n', 'namespace <namespace>', 'organize component in a namespace'], ['o', 'override <boolean>', 'override existing component if exists (default = false)'], ['s', 'scope <string>', `sets the component's scope. if not entered, the default-scope from workspace.jsonc will be used`], ['e', 'env <string>', "set the component's environment. (overrides the env from variants if exists)"], ['j', 'json', 'output as json format']]);
+    _defineProperty(this, "options", [['i', 'id <name>', 'manually set component id'], ['m', 'main <file>', 'define component entry point'], ['n', 'namespace <namespace>', 'organize component in a namespace'], ['o', 'override <boolean>', 'override existing component if exists (default = false)'], ['s', 'scope <string>', `sets the component's scope. if not entered, the default-scope from workspace.jsonc will be used`], ['e', 'env <string>', "set the component's environment. (overrides the env from variants if exists)"], ['', 'root', 'track the workspace root itself as a component, which owns every file no other component claims'], ['j', 'json', 'output as json format']]);
     _defineProperty(this, "loader", true);
   }
   async report([paths = []], addFlags) {
@@ -91,7 +91,8 @@ class AddCmd {
     namespace,
     scope,
     env,
-    override = false
+    override = false,
+    root = false
   }) {
     if (namespace && id) {
       throw new (_bitError().BitError)('please use either [id] or [namespace] to add a particular component - they cannot be used together');
@@ -109,7 +110,8 @@ class AddCmd {
       namespace,
       defaultScope: scope,
       override,
-      env
+      env,
+      root
     });
     return {
       addedComponents: addedComponents.map(added => ({

package/dist/add-cmd.js.map

@@ -1 +1 @@
-{"version":3,"names":["_cli","data","require","_chalk","_interopRequireDefault","path","_interopRequireWildcard","_bitError","_legacy","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","_defineProperty","_toPropertyKey","value","enumerable","configurable","writable","_toPrimitive","Symbol","toPrimitive","TypeError","String","Number","AddCmd","constructor","tracker","report","paths","addFlags","addedComponents","warnings","json","paintWarning","alreadyUsedOutput","alreadyUsedWarning","keys","alreadyUsed","map","key","formatItem","chalk","bold","join","warnSymbol","filter","x","emptyDirectoryOutput","emptyDirectory","length","items","dir","formatTitle","formatSuccessSummary","joinSections","result","files","errorSymbol","id","title","file","main","namespace","scope","env","override","BitError","normalizedPaths","p","pathNormalizeToLinux","normalize","addForCLI","componentPaths","undefined","defaultScope","added","toString","relativePath","exports"],"sources":["add-cmd.ts"],"sourcesContent":["import type { Command, CommandOptions } from '@teambit/cli';\nimport { formatTitle, formatItem, formatSuccessSummary, warnSymbol, errorSymbol, joinSections } from '@teambit/cli';\nimport chalk from 'chalk';\nimport * as path from 'path';\nimport { BitError } from '@teambit/bit-error';\nimport type { PathLinux, PathOsBased } from '@teambit/legacy.utils';\nimport { pathNormalizeToLinux } from '@teambit/legacy.utils';\nimport type { AddActionResults, Warnings } from './add-components';\nimport type { TrackerMain } from './tracker.main.runtime';\n\ntype AddFlags = {\n  id: string | null | undefined;\n  main: string | null | undefined;\n  namespace: string | null | undefined;\n  scope?: string;\n  env?: string;\n  override: boolean;\n};\n\ntype AddResults = {\n  addedComponents: Array<{ id: string; files: PathLinux[] }>;\n  warnings: Warnings;\n};\n\nexport class AddCmd implements Command {\n  name = 'add [path...]';\n  description = 'track existing directory contents as new components in the workspace';\n  group = 'component-development';\n  extendedDescription =\n    'Registers one or more directories as Bit components without changing your files. Each provided path becomes a component root tracked by Bit.';\n  helpUrl = 'reference/workspace/component-directory';\n  alias = 'a';\n  options = [\n    ['i', 'id <name>', 'manually set component id'],\n    ['m', 'main <file>', 'define component entry point'],\n    ['n', 'namespace <namespace>', 'organize component in a namespace'],\n    ['o', 'override <boolean>', 'override existing component if exists (default = false)'],\n    [\n      's',\n      'scope <string>',\n      `sets the component's scope. if not entered, the default-scope from workspace.jsonc will be used`,\n    ],\n    ['e', 'env <string>', \"set the component's environment. (overrides the env from variants if exists)\"],\n    ['j', 'json', 'output as json format'],\n  ] as CommandOptions;\n  loader = true;\n\n  constructor(private tracker: TrackerMain) {}\n\n  async report([paths = []]: [string[]], addFlags: AddFlags) {\n    const { addedComponents, warnings }: AddResults = await this.json([paths], addFlags);\n\n    const paintWarning = () => {\n      const alreadyUsedOutput = () => {\n        const alreadyUsedWarning = Object.keys(warnings.alreadyUsed)\n          .map((key) =>\n            formatItem(\n              `files ${chalk.bold(warnings.alreadyUsed[key].join(', '))} already used by component: ${key}`,\n              warnSymbol\n            )\n          )\n          .filter((x) => x)\n          .join('\\n');\n        return alreadyUsedWarning ? `${alreadyUsedWarning}\\n` : '';\n      };\n      const emptyDirectoryOutput = () => {\n        if (!warnings.emptyDirectory.length) return '';\n        const items = warnings.emptyDirectory.map((dir) => formatItem(chalk.bold(dir), warnSymbol));\n        return `${formatTitle(`${warnSymbol} empty or excluded directories`)}\\n${items.join('\\n')}\\n`;\n      };\n      return alreadyUsedOutput() + emptyDirectoryOutput();\n    };\n\n    if (addedComponents.length > 1) {\n      return paintWarning() + formatSuccessSummary(`tracking ${addedComponents.length} new components`);\n    }\n\n    return joinSections([\n      paintWarning(),\n      ...addedComponents.map((result) => {\n        if (result.files.length === 0) {\n          return `${errorSymbol} could not track component ${chalk.bold(result.id)}: no files to track`;\n        }\n        const title = formatTitle(`tracking component ${chalk.bold(result.id)}`);\n        const files = result.files.map((file) => formatItem(`added ${file}`));\n        return `${title}\\n${files.join('\\n')}`;\n      }),\n    ]);\n  }\n\n  async json(\n    [paths = []]: [string[]],\n    { id, main, namespace, scope, env, override = false }: AddFlags\n  ): Promise<AddResults> {\n    if (namespace && id) {\n      throw new BitError(\n        'please use either [id] or [namespace] to add a particular component - they cannot be used together'\n      );\n    }\n\n    const normalizedPaths: PathOsBased[] = paths.map((p) => pathNormalizeToLinux(path.normalize(p)));\n    const { addedComponents, warnings }: AddActionResults = await this.tracker.addForCLI({\n      componentPaths: normalizedPaths,\n      // @ts-ignore AUTO-ADDED-AFTER-MIGRATION-PLEASE-FIX!\n      id,\n      main: main ? pathNormalizeToLinux(path.normalize(main)) : undefined,\n      // @ts-ignore AUTO-ADDED-AFTER-MIGRATION-PLEASE-FIX!\n      namespace,\n      defaultScope: scope,\n      override,\n      env,\n    });\n    return {\n      addedComponents: addedComponents.map((added) => ({\n        id: added.id.toString(),\n        files: added.files.map((f) => f.relativePath),\n      })),\n      warnings,\n    };\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_cli","data","require","_chalk","_interopRequireDefault","path","_interopRequireWildcard","_bitError","_legacy","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","_defineProperty","_toPropertyKey","value","enumerable","configurable","writable","_toPrimitive","Symbol","toPrimitive","TypeError","String","Number","AddCmd","constructor","tracker","report","paths","addFlags","addedComponents","warnings","json","paintWarning","alreadyUsedOutput","alreadyUsedWarning","keys","alreadyUsed","map","key","formatItem","chalk","bold","join","warnSymbol","filter","x","emptyDirectoryOutput","emptyDirectory","length","items","dir","formatTitle","formatSuccessSummary","joinSections","result","files","errorSymbol","id","title","file","main","namespace","scope","env","override","root","BitError","normalizedPaths","p","pathNormalizeToLinux","normalize","addForCLI","componentPaths","undefined","defaultScope","added","toString","relativePath","exports"],"sources":["add-cmd.ts"],"sourcesContent":["import type { Command, CommandOptions } from '@teambit/cli';\nimport { formatTitle, formatItem, formatSuccessSummary, warnSymbol, errorSymbol, joinSections } from '@teambit/cli';\nimport chalk from 'chalk';\nimport * as path from 'path';\nimport { BitError } from '@teambit/bit-error';\nimport type { PathLinux, PathOsBased } from '@teambit/legacy.utils';\nimport { pathNormalizeToLinux } from '@teambit/legacy.utils';\nimport type { AddActionResults, Warnings } from './add-components';\nimport type { TrackerMain } from './tracker.main.runtime';\n\ntype AddFlags = {\n  id: string | null | undefined;\n  main: string | null | undefined;\n  namespace: string | null | undefined;\n  scope?: string;\n  env?: string;\n  override: boolean;\n  root?: boolean;\n};\n\ntype AddResults = {\n  addedComponents: Array<{ id: string; files: PathLinux[] }>;\n  warnings: Warnings;\n};\n\nexport class AddCmd implements Command {\n  name = 'add [path...]';\n  description = 'track existing directory contents as new components in the workspace';\n  group = 'component-development';\n  extendedDescription =\n    'Registers one or more directories as Bit components without changing your files. Each provided path becomes a component root tracked by Bit.';\n  helpUrl = 'reference/workspace/component-directory';\n  alias = 'a';\n  options = [\n    ['i', 'id <name>', 'manually set component id'],\n    ['m', 'main <file>', 'define component entry point'],\n    ['n', 'namespace <namespace>', 'organize component in a namespace'],\n    ['o', 'override <boolean>', 'override existing component if exists (default = false)'],\n    [\n      's',\n      'scope <string>',\n      `sets the component's scope. if not entered, the default-scope from workspace.jsonc will be used`,\n    ],\n    ['e', 'env <string>', \"set the component's environment. (overrides the env from variants if exists)\"],\n    ['', 'root', 'track the workspace root itself as a component, which owns every file no other component claims'],\n    ['j', 'json', 'output as json format'],\n  ] as CommandOptions;\n  loader = true;\n\n  constructor(private tracker: TrackerMain) {}\n\n  async report([paths = []]: [string[]], addFlags: AddFlags) {\n    const { addedComponents, warnings }: AddResults = await this.json([paths], addFlags);\n\n    const paintWarning = () => {\n      const alreadyUsedOutput = () => {\n        const alreadyUsedWarning = Object.keys(warnings.alreadyUsed)\n          .map((key) =>\n            formatItem(\n              `files ${chalk.bold(warnings.alreadyUsed[key].join(', '))} already used by component: ${key}`,\n              warnSymbol\n            )\n          )\n          .filter((x) => x)\n          .join('\\n');\n        return alreadyUsedWarning ? `${alreadyUsedWarning}\\n` : '';\n      };\n      const emptyDirectoryOutput = () => {\n        if (!warnings.emptyDirectory.length) return '';\n        const items = warnings.emptyDirectory.map((dir) => formatItem(chalk.bold(dir), warnSymbol));\n        return `${formatTitle(`${warnSymbol} empty or excluded directories`)}\\n${items.join('\\n')}\\n`;\n      };\n      return alreadyUsedOutput() + emptyDirectoryOutput();\n    };\n\n    if (addedComponents.length > 1) {\n      return paintWarning() + formatSuccessSummary(`tracking ${addedComponents.length} new components`);\n    }\n\n    return joinSections([\n      paintWarning(),\n      ...addedComponents.map((result) => {\n        if (result.files.length === 0) {\n          return `${errorSymbol} could not track component ${chalk.bold(result.id)}: no files to track`;\n        }\n        const title = formatTitle(`tracking component ${chalk.bold(result.id)}`);\n        const files = result.files.map((file) => formatItem(`added ${file}`));\n        return `${title}\\n${files.join('\\n')}`;\n      }),\n    ]);\n  }\n\n  async json(\n    [paths = []]: [string[]],\n    { id, main, namespace, scope, env, override = false, root = false }: AddFlags\n  ): Promise<AddResults> {\n    if (namespace && id) {\n      throw new BitError(\n        'please use either [id] or [namespace] to add a particular component - they cannot be used together'\n      );\n    }\n\n    const normalizedPaths: PathOsBased[] = paths.map((p) => pathNormalizeToLinux(path.normalize(p)));\n    const { addedComponents, warnings }: AddActionResults = await this.tracker.addForCLI({\n      componentPaths: normalizedPaths,\n      // @ts-ignore AUTO-ADDED-AFTER-MIGRATION-PLEASE-FIX!\n      id,\n      main: main ? pathNormalizeToLinux(path.normalize(main)) : undefined,\n      // @ts-ignore AUTO-ADDED-AFTER-MIGRATION-PLEASE-FIX!\n      namespace,\n      defaultScope: scope,\n      override,\n      env,\n      root,\n    });\n    return {\n      addedComponents: addedComponents.map((added) => ({\n        id: added.id.toString(),\n        files: added.files.map((f) => f.relativePath),\n      })),\n      warnings,\n    };\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/add-components.d.ts

@@ -2,7 +2,7 @@ import { ComponentID } from '@teambit/component-id';
 import type { BitMap, ComponentMapFile, Config } from '@teambit/legacy.bit-map';
 import { ComponentMap } from '@teambit/legacy.bit-map';
 import type { Consumer } from '@teambit/legacy.consumer';
-import type { PathLinux, PathOsBased } from '@teambit/legacy.utils';
+import type { PathLinux, PathLinuxRelative, PathOsBased } from '@teambit/legacy.utils';
 import type { Workspace } from '@teambit/workspace';
 import type { ResolvedTrackData } from './tracker.main.runtime';
 export type AddResult = {
@@ -42,6 +42,11 @@ export type AddProps = {
     config?: Config;
     shouldHandleOutOfSync?: boolean;
     env?: string;
+    /**
+     * spells out the intent to track the workspace root itself. required for it and only for it, see
+     * AddComponents.throwForWorkspaceRootFlagMismatch.
+     */
+    root?: boolean;
 };
 export type AddContext = {
     workspace: Workspace;
@@ -63,7 +68,27 @@ export default class AddComponents {
     defaultScope?: string;
     config?: Config;
     shouldHandleOutOfSync?: boolean;
+    root?: boolean;
     constructor(context: AddContext, addProps: AddProps);
+    /**
+     * tracking the workspace root turns the workspace itself into a component: it owns every file no
+     * other component claims, `.bitmap` included, and every other component becomes a member of it.
+     * "bit add ." is one keystroke away from "git add .", which means something else entirely, so the
+     * intent is spelled out rather than inferred from the path.
+     *
+     * only the workspace root needs the flag, and it is the only thing the flag does: "bit add ." from
+     * a sub-directory names that directory, not the root, and is tracked like any other path.
+     *
+     * a workspace that already has a root does not ask again. what the flag guards against is creating
+     * one by accident, and there is none to create here - the add either refreshes the root that exists
+     * or names a second owner for ".", which has its own message saying who holds it.
+     */
+    /**
+     * the paths reach here as the user typed them - relative to the cwd, or absolute - so the workspace
+     * root arrives as ".", as "", or as the workspace path itself, depending on where the command ran.
+     */
+    private isWorkspaceRootPath;
+    private throwForWorkspaceRootFlagMismatch;
     add(): Promise<AddActionResults>;
     /**
      * @param {string[]} files - array of file-paths from which it should search for the dsl patterns.
@@ -125,7 +150,7 @@ export default class AddComponents {
      * e.g. bar/foo.js, the id would be bar/foo.
      * in case bitmap has already the same id, the complete id is taken from bitmap (see _getIdAccordingToExistingComponent)
      */
-    addOneComponent(componentPath: PathOsBased): Promise<AddedComponent>;
+    addOneComponent(componentPath: PathOsBased, batchRootDirs?: PathLinuxRelative[]): Promise<AddedComponent>;
     getIgnoreList(): Promise<string[]>;
     linkComponents(ids: ComponentID[]): Promise<void>;
     addMultipleComponents(componentPathsStats: PathsStats): Promise<void>;
@@ -140,5 +165,13 @@ export default class AddComponents {
     _tryAddingMultiple(componentPathsStats: PathsStats): Promise<AddedComponent[]>;
     _throwForOutsideConsumer(relativeToConsumerPath: PathOsBased): void;
 }
+/**
+ * the workspace-root component (rootDir ".") is a bag of config files, not a source component:
+ * nothing compiles it, nothing tests it, and nothing imports it as a package. the regular default
+ * env would give it a compiler and a dependency policy it can never satisfy, so it is tracked with
+ * the empty env - as explicit config, so every path that resolves an env or a dependency policy
+ * sees the same answer. an env configured by the caller, or set later with "bit env set", wins.
+ */
+export declare function configForWorkspaceRoot(existingConfig?: Config, addedConfig?: Config): Config;
 export declare function addMultipleFromResolvedTrackData(workspace: Workspace, trackData: ResolvedTrackData[]): Promise<ComponentID[]>;
 export {};