@teambit/snapping 1.0.447 → 1.0.448

package/dist/snap-from-scope.cmd.d.ts

@@ -23,6 +23,7 @@ export type SnapDataPerCompRaw = {
     }>;
     removeDependencies?: string[];
     forkFrom?: string;
+    version?: string;
 };
 type SnapFromScopeOptions = {
     push?: boolean;
@@ -30,6 +31,7 @@ type SnapFromScopeOptions = {
     ignoreIssues?: string;
     disableSnapPipeline?: boolean;
     updateDependents?: boolean;
+    tag?: boolean;
 } & BasicTagSnapParams;
 export declare class SnapFromScopeCmd implements Command {
     private snapping;
@@ -43,7 +45,7 @@ export declare class SnapFromScopeCmd implements Command {
     private: boolean;
     constructor(snapping: SnappingMain, logger: Logger);
     report([data]: [string], options: SnapFromScopeOptions): Promise<string>;
-    json([data]: [string], { push, message, lane, ignoreIssues, build, skipTests, disableSnapPipeline, ignoreBuildErrors, rebuildDepsGraph, updateDependents, }: SnapFromScopeOptions): Promise<{
+    json([data]: [string], { push, message, lane, ignoreIssues, build, skipTests, disableSnapPipeline, ignoreBuildErrors, rebuildDepsGraph, updateDependents, tag, }: SnapFromScopeOptions): Promise<{
         exportedIds: string[] | undefined;
         snappedIds: string[];
     }>;

package/dist/snap-from-scope.cmd.js

@@ -53,13 +53,14 @@ the input data is a stringified JSON of an array of the following object.
   }>;
   removeDependencies?: string[]; // component-id (for components) or package-name (for packages) to remove from the dependencies.
   forkFrom?: string;      // origin id to fork from. the componentId is the new id. (no need to populate isNew prop).
+  version?: string; // relevant when passing "--tag". optionally, specify the semver to tag. default to "patch".
 }
 an example of the final data: '[{"componentId":"ci.remote2/comp-b","message": "first snap"}]'
 `);
     _defineProperty(this, "alias", '');
     _defineProperty(this, "options", [['', 'push', 'export the updated objects to the original scopes once done'], ['m', 'message <message>', 'log message describing the latest changes'], ['', 'lane <lane-id>', 'fetch the components from the given lane'], ['', 'build', 'run the build pipeline'], ['', 'skip-tests', 'skip running component tests during snap process'], ['', 'disable-snap-pipeline', 'skip the snap pipeline'], ['', 'ignore-build-errors', 'run the snap pipeline although the build pipeline failed'], ['', 'rebuild-deps-graph', 'do not reuse the saved dependencies graph, instead build it from scratch'], ['i', 'ignore-issues [issues]', `ignore component issues (shown in "bit status" as "issues found"), issues to ignore:
 [${Object.keys(_componentIssues().IssuesClasses).join(', ')}]
-to ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify "*".`], ['', 'update-dependents', 'when snapped on a lane, mark it as update-dependents so it will be skipped from the workspace'], ['j', 'json', 'output as json format']]);
+to ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify "*".`], ['', 'update-dependents', 'when snapped on a lane, mark it as update-dependents so it will be skipped from the workspace'], ['', 'tag', 'make a tag instead of a snap'], ['', 'stream', 'relevant for --json only. stream loader as json strings'], ['j', 'json', 'output as json format']]);
     _defineProperty(this, "loader", true);
     _defineProperty(this, "private", true);
   }
@@ -83,7 +84,8 @@ to ignore multiple issues, separate them by a comma and wrap with quotes. to ign
     disableSnapPipeline = false,
     ignoreBuildErrors = false,
     rebuildDepsGraph,
-    updateDependents
+    updateDependents,
+    tag
   }) {
     const disableTagAndSnapPipelines = disableSnapPipeline;
     if (disableTagAndSnapPipelines && ignoreBuildErrors) {
@@ -103,7 +105,8 @@ to ignore multiple issues, separate them by a comma and wrap with quotes. to ign
       disableTagAndSnapPipelines,
       ignoreBuildErrors,
       rebuildDepsGraph,
-      updateDependents
+      updateDependents,
+      tag
     });
     return {
       exportedIds: results.exportedIds?.map(id => id.toString()),

package/dist/snap-from-scope.cmd.js.map

@@ -1 +1 @@
-{"version":3,"names":["_chalk","data","_interopRequireDefault","require","_componentIssues","_bitError","e","__esModule","default","_defineProperty","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","SnapFromScopeCmd","constructor","snapping","logger","keys","IssuesClasses","join","report","options","results","json","snappedIds","exportedIds","snappedOutput","chalk","bold","exportedOutput","length","push","message","lane","ignoreIssues","build","skipTests","disableSnapPipeline","ignoreBuildErrors","rebuildDepsGraph","updateDependents","disableTagAndSnapPipelines","BitError","snapDataPerCompRaw","parseData","snapFromScope","map","id","toString","dataParsed","JSON","parse","err","Error","Array","isArray","forEach","dataItem","componentId","files","file","path","content","Buffer","from","exports"],"sources":["snap-from-scope.cmd.ts"],"sourcesContent":["import chalk from 'chalk';\nimport { IssuesClasses } from '@teambit/component-issues';\nimport { Command, CommandOptions } from '@teambit/cli';\nimport { BitError } from '@teambit/bit-error';\nimport { Logger } from '@teambit/logger';\nimport { SnappingMain } from './snapping.main.runtime';\nimport { BasicTagSnapParams } from './tag-model-component';\n\nexport type FileData = { path: string; content: string; delete?: boolean };\n\nexport type SnapDataPerCompRaw = {\n  componentId: string;\n  dependencies?: string[];\n  aspects?: Record<string, any>;\n  message?: string;\n  files?: FileData[];\n  isNew?: boolean;\n  mainFile?: string; // relevant when isNew is true. default to \"index.ts\".\n  newDependencies?: Array<{\n    id: string; // component-id or package-name. e.g. \"teambit.react/react\" or \"lodash\".\n    version?: string; // version of the package. e.g. \"2.0.3\". for packages, it is mandatory.\n    isComponent?: boolean; // default true. if false, it's a package dependency\n    type?: 'runtime' | 'dev' | 'peer'; // default \"runtime\".\n  }>;\n  removeDependencies?: string[];\n  forkFrom?: string; // origin id to fork from. the componentId is the new id. (no need to populate isNew prop).\n};\n\ntype SnapFromScopeOptions = {\n  push?: boolean;\n  lane?: string;\n  ignoreIssues?: string;\n  disableSnapPipeline?: boolean;\n  updateDependents?: boolean;\n} & BasicTagSnapParams;\n\nexport class SnapFromScopeCmd implements Command {\n  name = '_snap <data>';\n  description = 'snap components from a bare-scope';\n  extendedDescription = `this command should be running from a new bare scope, it first imports the components it needs and then processes the snap.\nthe input data is a stringified JSON of an array of the following object.\n{\n  componentId: string;     // ids always have scope, so it's safe to parse them from string\n  dependencies?: string[]; // dependencies include versions. for components use component-id. e.g. [teambit.compilation/compiler@1.0.0, lodash@4.17.21]\n  aspects?: Record<string,any> // e.g. { \"teambit.react/react\": {}, \"teambit.envs/envs\": { \"env\": \"teambit.react/react\" } }\n  message?: string;       // tag-message.\n  files?: Array<{path: string, content: string}>; // replace content of specified source-files. the content is base64 encoded.\n  isNew?: boolean;        // if it's new, it'll be generated from the given files. otherwise, it'll be fetched from the scope and updated.\n  mainFile?: string;      // relevant when isNew is true. default to \"index.ts\".\n  newDependencies?: Array<{  // new dependencies (components and packages) to add.\n    id: string;              // component-id or package-name. e.g. \"teambit.react/react\" or \"lodash\".\n    version?: string;        // version of the package. e.g. \"2.0.3\". for packages, it is mandatory.\n    isComponent?: boolean;   // default true. if false, it's a package dependency\n    type?: 'runtime' | 'dev' | 'peer'; // default \"runtime\".\n  }>;\n  removeDependencies?: string[]; // component-id (for components) or package-name (for packages) to remove from the dependencies.\n  forkFrom?: string;      // origin id to fork from. the componentId is the new id. (no need to populate isNew prop).\n}\nan example of the final data: '[{\"componentId\":\"ci.remote2/comp-b\",\"message\": \"first snap\"}]'\n`;\n  alias = '';\n  options = [\n    ['', 'push', 'export the updated objects to the original scopes once done'],\n    ['m', 'message <message>', 'log message describing the latest changes'],\n    ['', 'lane <lane-id>', 'fetch the components from the given lane'],\n    ['', 'build', 'run the build pipeline'],\n    ['', 'skip-tests', 'skip running component tests during snap process'],\n    ['', 'disable-snap-pipeline', 'skip the snap pipeline'],\n    ['', 'ignore-build-errors', 'run the snap pipeline although the build pipeline failed'],\n    ['', 'rebuild-deps-graph', 'do not reuse the saved dependencies graph, instead build it from scratch'],\n    [\n      'i',\n      'ignore-issues [issues]',\n      `ignore component issues (shown in \"bit status\" as \"issues found\"), issues to ignore:\n[${Object.keys(IssuesClasses).join(', ')}]\nto ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify \"*\".`,\n    ],\n    [\n      '',\n      'update-dependents',\n      'when snapped on a lane, mark it as update-dependents so it will be skipped from the workspace',\n    ],\n    ['j', 'json', 'output as json format'],\n  ] as CommandOptions;\n  loader = true;\n  private = true;\n\n  constructor(\n    private snapping: SnappingMain,\n    private logger: Logger\n  ) {}\n\n  async report([data]: [string], options: SnapFromScopeOptions) {\n    const results = await this.json([data], options);\n\n    const { snappedIds, exportedIds } = results;\n\n    const snappedOutput = `${chalk.bold('snapped components')}\\n${snappedIds.join('\\n')}`;\n    const exportedOutput =\n      exportedIds && exportedIds.length ? `\\n\\n${chalk.bold('exported components')}\\n${exportedIds.join('\\n')}` : '';\n\n    return `${snappedOutput}${exportedOutput}`;\n  }\n  async json(\n    [data]: [string],\n    {\n      push = false,\n      message = '',\n      lane,\n      ignoreIssues,\n      build = false,\n      skipTests = false,\n      disableSnapPipeline = false,\n      ignoreBuildErrors = false,\n      rebuildDepsGraph,\n      updateDependents,\n    }: SnapFromScopeOptions\n  ) {\n    const disableTagAndSnapPipelines = disableSnapPipeline;\n    if (disableTagAndSnapPipelines && ignoreBuildErrors) {\n      throw new BitError('you can use either ignore-build-errors or disable-snap-pipeline, but not both');\n    }\n    if (updateDependents && !lane) {\n      throw new BitError('update-dependents flag is only available when snapping from a lane');\n    }\n\n    const snapDataPerCompRaw = this.parseData(data);\n\n    const results = await this.snapping.snapFromScope(snapDataPerCompRaw, {\n      push,\n      message,\n      lane,\n      ignoreIssues,\n      build,\n      skipTests,\n      disableTagAndSnapPipelines,\n      ignoreBuildErrors,\n      rebuildDepsGraph,\n      updateDependents,\n    });\n\n    return {\n      exportedIds: results.exportedIds?.map((id) => id.toString()),\n      snappedIds: results.snappedIds.map((id) => id.toString()),\n    };\n  }\n  private parseData(data: string): SnapDataPerCompRaw[] {\n    let dataParsed: unknown;\n    try {\n      dataParsed = JSON.parse(data);\n    } catch (err: any) {\n      throw new Error(`failed parsing the data entered as JSON. err ${err.message}`);\n    }\n    if (!Array.isArray(dataParsed)) {\n      throw new Error('expect data to be an array');\n    }\n    dataParsed.forEach((dataItem) => {\n      if (!dataItem.componentId) throw new Error('expect data item to have \"componentId\" prop');\n      dataItem.files?.forEach((file) => {\n        if (!file.path) throw new Error('expect file to have \"path\" prop');\n        if (file.content) {\n          file.content = Buffer.from(file.content, 'base64').toString();\n        }\n      });\n    });\n\n    return dataParsed;\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_chalk","data","_interopRequireDefault","require","_componentIssues","_bitError","e","__esModule","default","_defineProperty","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","SnapFromScopeCmd","constructor","snapping","logger","keys","IssuesClasses","join","report","options","results","json","snappedIds","exportedIds","snappedOutput","chalk","bold","exportedOutput","length","push","message","lane","ignoreIssues","build","skipTests","disableSnapPipeline","ignoreBuildErrors","rebuildDepsGraph","updateDependents","tag","disableTagAndSnapPipelines","BitError","snapDataPerCompRaw","parseData","snapFromScope","map","id","toString","dataParsed","JSON","parse","err","Error","Array","isArray","forEach","dataItem","componentId","files","file","path","content","Buffer","from","exports"],"sources":["snap-from-scope.cmd.ts"],"sourcesContent":["import chalk from 'chalk';\nimport { IssuesClasses } from '@teambit/component-issues';\nimport { Command, CommandOptions } from '@teambit/cli';\nimport { BitError } from '@teambit/bit-error';\nimport { Logger } from '@teambit/logger';\nimport { SnappingMain } from './snapping.main.runtime';\nimport { BasicTagSnapParams } from './tag-model-component';\n\nexport type FileData = { path: string; content: string; delete?: boolean };\n\nexport type SnapDataPerCompRaw = {\n  componentId: string;\n  dependencies?: string[];\n  aspects?: Record<string, any>;\n  message?: string;\n  files?: FileData[];\n  isNew?: boolean;\n  mainFile?: string; // relevant when isNew is true. default to \"index.ts\".\n  newDependencies?: Array<{\n    id: string; // component-id or package-name. e.g. \"teambit.react/react\" or \"lodash\".\n    version?: string; // version of the package. e.g. \"2.0.3\". for packages, it is mandatory.\n    isComponent?: boolean; // default true. if false, it's a package dependency\n    type?: 'runtime' | 'dev' | 'peer'; // default \"runtime\".\n  }>;\n  removeDependencies?: string[];\n  forkFrom?: string; // origin id to fork from. the componentId is the new id. (no need to populate isNew prop).\n  version?: string; // relevant when passing \"--tag\". optionally, specify the semver to tag. default to \"patch\".\n};\n\ntype SnapFromScopeOptions = {\n  push?: boolean;\n  lane?: string;\n  ignoreIssues?: string;\n  disableSnapPipeline?: boolean;\n  updateDependents?: boolean;\n  tag?: boolean;\n} & BasicTagSnapParams;\n\nexport class SnapFromScopeCmd implements Command {\n  name = '_snap <data>';\n  description = 'snap components from a bare-scope';\n  extendedDescription = `this command should be running from a new bare scope, it first imports the components it needs and then processes the snap.\nthe input data is a stringified JSON of an array of the following object.\n{\n  componentId: string;     // ids always have scope, so it's safe to parse them from string\n  dependencies?: string[]; // dependencies include versions. for components use component-id. e.g. [teambit.compilation/compiler@1.0.0, lodash@4.17.21]\n  aspects?: Record<string,any> // e.g. { \"teambit.react/react\": {}, \"teambit.envs/envs\": { \"env\": \"teambit.react/react\" } }\n  message?: string;       // tag-message.\n  files?: Array<{path: string, content: string}>; // replace content of specified source-files. the content is base64 encoded.\n  isNew?: boolean;        // if it's new, it'll be generated from the given files. otherwise, it'll be fetched from the scope and updated.\n  mainFile?: string;      // relevant when isNew is true. default to \"index.ts\".\n  newDependencies?: Array<{  // new dependencies (components and packages) to add.\n    id: string;              // component-id or package-name. e.g. \"teambit.react/react\" or \"lodash\".\n    version?: string;        // version of the package. e.g. \"2.0.3\". for packages, it is mandatory.\n    isComponent?: boolean;   // default true. if false, it's a package dependency\n    type?: 'runtime' | 'dev' | 'peer'; // default \"runtime\".\n  }>;\n  removeDependencies?: string[]; // component-id (for components) or package-name (for packages) to remove from the dependencies.\n  forkFrom?: string;      // origin id to fork from. the componentId is the new id. (no need to populate isNew prop).\n  version?: string; // relevant when passing \"--tag\". optionally, specify the semver to tag. default to \"patch\".\n}\nan example of the final data: '[{\"componentId\":\"ci.remote2/comp-b\",\"message\": \"first snap\"}]'\n`;\n  alias = '';\n  options = [\n    ['', 'push', 'export the updated objects to the original scopes once done'],\n    ['m', 'message <message>', 'log message describing the latest changes'],\n    ['', 'lane <lane-id>', 'fetch the components from the given lane'],\n    ['', 'build', 'run the build pipeline'],\n    ['', 'skip-tests', 'skip running component tests during snap process'],\n    ['', 'disable-snap-pipeline', 'skip the snap pipeline'],\n    ['', 'ignore-build-errors', 'run the snap pipeline although the build pipeline failed'],\n    ['', 'rebuild-deps-graph', 'do not reuse the saved dependencies graph, instead build it from scratch'],\n    [\n      'i',\n      'ignore-issues [issues]',\n      `ignore component issues (shown in \"bit status\" as \"issues found\"), issues to ignore:\n[${Object.keys(IssuesClasses).join(', ')}]\nto ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify \"*\".`,\n    ],\n    [\n      '',\n      'update-dependents',\n      'when snapped on a lane, mark it as update-dependents so it will be skipped from the workspace',\n    ],\n    ['', 'tag', 'make a tag instead of a snap'],\n    ['', 'stream', 'relevant for --json only. stream loader as json strings'],\n    ['j', 'json', 'output as json format'],\n  ] as CommandOptions;\n  loader = true;\n  private = true;\n\n  constructor(\n    private snapping: SnappingMain,\n    private logger: Logger\n  ) {}\n\n  async report([data]: [string], options: SnapFromScopeOptions) {\n    const results = await this.json([data], options);\n\n    const { snappedIds, exportedIds } = results;\n\n    const snappedOutput = `${chalk.bold('snapped components')}\\n${snappedIds.join('\\n')}`;\n    const exportedOutput =\n      exportedIds && exportedIds.length ? `\\n\\n${chalk.bold('exported components')}\\n${exportedIds.join('\\n')}` : '';\n\n    return `${snappedOutput}${exportedOutput}`;\n  }\n  async json(\n    [data]: [string],\n    {\n      push = false,\n      message = '',\n      lane,\n      ignoreIssues,\n      build = false,\n      skipTests = false,\n      disableSnapPipeline = false,\n      ignoreBuildErrors = false,\n      rebuildDepsGraph,\n      updateDependents,\n      tag,\n    }: SnapFromScopeOptions\n  ) {\n    const disableTagAndSnapPipelines = disableSnapPipeline;\n    if (disableTagAndSnapPipelines && ignoreBuildErrors) {\n      throw new BitError('you can use either ignore-build-errors or disable-snap-pipeline, but not both');\n    }\n    if (updateDependents && !lane) {\n      throw new BitError('update-dependents flag is only available when snapping from a lane');\n    }\n\n    const snapDataPerCompRaw = this.parseData(data);\n\n    const results = await this.snapping.snapFromScope(snapDataPerCompRaw, {\n      push,\n      message,\n      lane,\n      ignoreIssues,\n      build,\n      skipTests,\n      disableTagAndSnapPipelines,\n      ignoreBuildErrors,\n      rebuildDepsGraph,\n      updateDependents,\n      tag,\n    });\n\n    return {\n      exportedIds: results.exportedIds?.map((id) => id.toString()),\n      snappedIds: results.snappedIds.map((id) => id.toString()),\n    };\n  }\n  private parseData(data: string): SnapDataPerCompRaw[] {\n    let dataParsed: unknown;\n    try {\n      dataParsed = JSON.parse(data);\n    } catch (err: any) {\n      throw new Error(`failed parsing the data entered as JSON. err ${err.message}`);\n    }\n    if (!Array.isArray(dataParsed)) {\n      throw new Error('expect data to be an array');\n    }\n    dataParsed.forEach((dataItem) => {\n      if (!dataItem.componentId) throw new Error('expect data item to have \"componentId\" prop');\n      dataItem.files?.forEach((file) => {\n        if (!file.path) throw new Error('expect file to have \"path\" prop');\n        if (file.content) {\n          file.content = Buffer.from(file.content, 'base64').toString();\n        }\n      });\n    });\n\n    return dataParsed;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -120,12 +120,14 @@ export declare class SnappingMain {
         ignoreIssues?: string;
         lane?: string;
         updateDependents?: boolean;
+        tag?: boolean;
     } & Partial<BasicTagParams>): Promise<SnapFromScopeResults>;
     snapFromScope(snapDataPerCompRaw: SnapDataPerCompRaw[], params: {
         push?: boolean;
         ignoreIssues?: string;
         lane?: string;
         updateDependents?: boolean;
+        tag?: boolean;
     } & Partial<BasicTagParams>): Promise<SnapFromScopeResults>;
     /**
      * save the local changes of a component(s) into the scope. snap can be done on main or on a lane.

package/dist/snapping.main.runtime.js

@@ -611,7 +611,8 @@ if you're willing to lose the history from the head to the specified version, us
           type: dep.type ?? 'runtime'
         })),
         removeDependencies: snapData.removeDependencies,
-        forkFrom: _componentId().ComponentID.fromString(snapData.forkFrom)
+        forkFrom: _componentId().ComponentID.fromString(snapData.forkFrom),
+        version: snapData.version
       };
     });
 
@@ -695,20 +696,23 @@ if you're willing to lose the history from the head to the specified version, us
     const components = await this.workspace.getMany(forkedFromData.map(f => f.componentId));
     const consumerComponents = components.map(c => c.state._consumer);
     const ids = _componentId().ComponentIdList.fromArray(allCompIds);
+    await this.throwForVariousIssues(components, params.ignoreIssues);
+    const shouldTag = Boolean(params.tag);
     const results = await (0, _tagModelComponent().tagModelComponent)(_objectSpread(_objectSpread({}, params), {}, {
       scope: this.scope,
       consumerComponents,
       tagDataPerComp: snapDataPerComp.map(s => ({
         componentId: s.componentId,
         message: s.message,
-        dependencies: []
+        dependencies: [],
+        versionToTag: shouldTag ? s.version || 'patch' : undefined
       })),
       snapping: this,
       builder: this.builder,
       dependencyResolver: this.dependencyResolver,
       skipAutoTag: true,
       persist: true,
-      isSnap: true,
+      isSnap: !shouldTag,
       ids,
       message: params.message,
       updateDependentsOnLane: params.updateDependents
@@ -782,7 +786,8 @@ if you're willing to lose the history from the head to the specified version, us
           isComponent: dep.isComponent ?? true,
           type: dep.type ?? 'runtime'
         })),
-        removeDependencies: snapData.removeDependencies
+        removeDependencies: snapData.removeDependencies,
+        version: snapData.version
       };
     });
 
@@ -850,20 +855,22 @@ if you're willing to lose the history from the head to the specified version, us
     await (0, _pMapSeries().default)(components, async comp => this.scope.executeOnCompAspectReCalcSlot(comp));
     const consumerComponents = components.map(c => c.state._consumer);
     const ids = _componentId().ComponentIdList.fromArray(allCompIds);
+    const shouldTag = Boolean(params.tag);
     const results = await (0, _tagModelComponent().tagModelComponent)(_objectSpread(_objectSpread({}, params), {}, {
       scope: this.scope,
       consumerComponents,
       tagDataPerComp: snapDataPerComp.map(s => ({
         componentId: s.componentId,
         message: s.message,
-        dependencies: []
+        dependencies: [],
+        versionToTag: shouldTag ? s.version || 'patch' : undefined
       })),
       snapping: this,
       builder: this.builder,
       dependencyResolver: this.dependencyResolver,
       skipAutoTag: true,
       persist: true,
-      isSnap: true,
+      isSnap: !shouldTag,
       ids,
       message: params.message,
       updateDependentsOnLane: params.updateDependents