beachball 3.0.0-alpha.2 → 3.0.0-alpha.4

package/lib/types/BeachballOptions.d.ts

@@ -2,16 +2,22 @@ import type { AuthType } from './Auth';
 import type { ChangeInfo, ChangeInfoMultiple, ChangeType } from './ChangeInfo';
 import type { ChangeFilePromptOptions } from './ChangeFilePrompt';
 import type { ChangelogOptions } from './ChangelogOptions';
-import type { PackageInfos } from './PackageInfo';
+import type { PackageInfo, PackageInfos } from './PackageInfo';
 export type BeachballOptions = CliOptions & RepoOptions & PackageOptions;
 /** Separate options objects, returned for reuse in `getPackageInfos`. */
 export interface ParsedOptions {
     /** Only the specified CLI options */
     cliOptions: Partial<CliOptions>;
+    /**
+     * Only the repo options (will also include the `branch` filled in).
+     * NOTE: This may include values that have been overridden by CLI options.
+     * This object should only be used when you need to specifically check the config file values.
+     */
+    repoOptions: Partial<RepoOptions>;
     /** Merged repo-level options (includes repo, CLI, and defaults) */
     options: BeachballOptions;
 }
-export interface CliOptions extends Pick<RepoOptions, 'access' | 'authType' | 'branch' | 'bump' | 'bumpDeps' | 'canaryName' | 'changehint' | 'changeDir' | 'commit' | 'concurrency' | 'depth' | 'disallowedChangeTypes' | 'disallowDeletedChangeFiles' | 'fetch' | 'fromRef' | 'gitTags' | 'gitTimeout' | 'keepChangeFiles' | 'message' | 'new' | 'npmReadConcurrency' | 'packToPath' | 'path' | 'prereleasePrefix' | 'publish' | 'push' | 'registry' | 'retries' | 'scope' | 'tag' | 'timeout'> {
+export interface CliOptions extends Pick<RepoOptions, 'access' | 'authType' | 'branch' | 'bump' | 'bumpDeps' | 'canaryName' | 'changehint' | 'changeDir' | 'commit' | 'concurrency' | 'depth' | 'disallowedChangeTypes' | 'disallowDeletedChangeFiles' | 'fetch' | 'fromRef' | 'gitTags' | 'gitTimeout' | 'keepChangeFiles' | 'message' | 'npmReadConcurrency' | 'packToPath' | 'path' | 'prereleasePrefix' | 'publish' | 'push' | 'registry' | 'retries' | 'scope' | 'tag' | 'timeout'> {
     /** Consider all packages to have changed */
     all: boolean;
     command: string;
@@ -58,8 +64,7 @@ export interface RepoOptions {
      * - The default branch is the remote's default branch if defined, falling back to
      *   `git config init.defaultBranch` or `master`.
      *
-     * (In the resolved config used internally, the remote name should *usually* be included,
-     * unless neither a remote name nor `package.json` `repository` was specified.)
+     * (In the resolved config used internally, the remote name will **always** be included.)
      */
     branch: string;
     /**
@@ -127,10 +132,11 @@ export interface RepoOptions {
     fromRef?: string;
     /**
      * Whether to generate changelog files.
-     * - `true` (default) to generate both CHANGELOG.md and CHANGELOG.json
-     * - `false` to skip changelog generation
-     * - `'md'` to generate only CHANGELOG.md
+     * - `'md'` (default) to generate only CHANGELOG.md
      * - `'json'` to generate only CHANGELOG.json
+     * - `true` to generate both CHANGELOG.md and CHANGELOG.json
+     * - `false` to skip changelog generation
+     * @default 'md'
      */
     generateChangelog: boolean | 'md' | 'json';
     /**
@@ -139,10 +145,19 @@ export interface RepoOptions {
      */
     groups?: VersionGroupOptions[];
     /**
-     * Whether to create git tags for published packages
+     * Whether to create git tags for published packages.
+     * Note that `getGitTag` is still respected, overriding this option on a per-package basis.
      * @default true
      */
     gitTags: boolean;
+    /**
+     * Get package-specific git tag(s). Return `null` to skip tagging this package.
+     * If returning an array, the first tag should be the most specific to this package.
+     * (Tags will only be created once if multiple packages return the same tag.)
+     * @param pkg Package being tagged, including the updated version
+     * @param defaultTag The default tag that would be generated for this package (e.g. `pkg_v1.2.3`)
+     */
+    getGitTag?: (pkg: PackageInfo, defaultTag: string) => string | string[] | null;
     /** Custom pre/post publish actions */
     hooks?: HooksOptions;
     /**
@@ -226,17 +241,6 @@ export interface RepoOptions {
     groupChanges?: boolean;
     /** For shallow clones only: Depth of git history to consider when doing fetch */
     depth?: number;
-    /**
-     * For publish: If true, publish all newly added packages in addition to modified packages.
-     * This is rarely needed since new packages *with change files* will always be published
-     * regardless of this option.
-     *
-     * @deprecated This option is not recommended because it will negatively impact perf (it requires
-     * checking the registry for ALL unmodified packages). It also has limited use unless you pushed
-     * new packages directly to the main branch, or your PR build doesn't run `beachball check`.
-     * Normally, `beachball check` will require change files to be created for the new packages.
-     */
-    new: boolean;
 }
 export interface PackageOptions extends Partial<Pick<RepoOptions, 'gitTags' | 'disallowedChangeTypes' | 'defaultNpmTag'>> {
     tag?: string | null;
@@ -310,6 +314,7 @@ export interface HooksOptions {
     /**
      * Runs for each package, after writing changelog and package.json updates
      * to the filesystem. May be called multiple times during publish.
+     * In the `publish` flow, files written in this hook will be committed automatically.
      *
      * @param packagePath The path to the package directory
      * @param name The name of the package as defined in package.json

package/lib/types/BeachballOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BeachballOptions.d.ts","sourceRoot":"","sources":["../../src/types/BeachballOptions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BeachballOptions.d.ts","sourceRoot":"","sources":["../../src/types/BeachballOptions.ts"],"names":[],"mappings":"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"}

package/lib/types/BumpInfo.d.ts

@@ -47,20 +47,25 @@ export type BumpInfo = {
     };
     /** Set of packages that are in scope for this bump */
     scopedPackages: ScopedPackages;
+    /**
+     * Map from package name to the git tag(s) that will be created for it during publish.
+     * It **only** includes the packages valid for tagging per `getPackagesToPublish`
+     * (this includes packages with `shouldPublish: false`).
+     *
+     * - `undefined` or not set for a package means no tag will be created (`gitTags` disabled
+     *   for the package and no `getGitTag` override, or `getGitTag` returned `null`).
+     * - When defined, this is a non-empty array of tag strings. The first entry is the "primary"
+     *   tag used in changelog metadata; all entries are created as git tags by `tagPackages`.
+     *
+     * This is computed once at the end of `bumpInMemory` so that changelog generation and
+     * `tagPackages` agree on what tag(s) will exist.
+     */
+    packageTags: {
+        readonly [pkgName: string]: readonly string[] | undefined;
+    };
 };
 /** Dependents cache (child points to parents): if A depends on B, then `{ B: [A] }` */
 export type PackageDependents = {
     readonly [pkgName: string]: ReadonlyArray<string>;
 };
-/**
- * Bump info with additional property set/used only during publishing (not while calculating
- * packages to bump).
- */
-export type PublishBumpInfo = BumpInfo & {
-    /**
-     * Set of packages detected in this info which weren't previously published and didn't have
-     * change files. (Only populated if `options.new` is set.)
-     */
-    newPackages?: ReadonlyArray<string>;
-};
 //# sourceMappingURL=BumpInfo.d.ts.map

package/lib/types/BumpInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BumpInfo.d.ts","sourceRoot":"","sources":["../../src/types/BumpInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEjF,MAAM,MAAM,QAAQ,GAAG;IACrB;;;OAGG;IACH,qBAAqB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE3C;;;OAGG;IACH,YAAY,EAAE,YAAY,CAAC;IAE3B;;;;;OAKG;IACH,qBAAqB,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAC;IAEzD;;;OAGG;IACH,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAEvC;;;;;;;OAOG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE9B;;;;;;;OAOG;IACH,kBAAkB,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;IAEvD,sDAAsD;IACtD,cAAc,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAEtF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG;IACvC;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACrC,CAAC"}
+{"version":3,"file":"BumpInfo.d.ts","sourceRoot":"","sources":["../../src/types/BumpInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEjF,MAAM,MAAM,QAAQ,GAAG;IACrB;;;OAGG;IACH,qBAAqB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE3C;;;OAGG;IACH,YAAY,EAAE,YAAY,CAAC;IAE3B;;;;;OAKG;IACH,qBAAqB,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAC;IAEzD;;;OAGG;IACH,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAEvC;;;;;;;OAOG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE9B;;;;;;;OAOG;IACH,kBAAkB,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;IAEvD,sDAAsD;IACtD,cAAc,EAAE,cAAc,CAAC;IAE/B;;;;;;;;;;;;OAYG;IACH,WAAW,EAAE;QAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;KAAE,CAAC;CAC5E,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC"}

package/lib/types/ChangeLog.d.ts

@@ -21,7 +21,7 @@ export interface ChangelogEntry {
      * For changelogs generated by beachball versions \>=2.36.0, should be `"not available"` for
      * bump entries, because the correct commit doesn't exist yet (see [issue](https://github.com/microsoft/beachball/issues/901)).
      *
-     * Could also be `"not available"` for other commits if there was an issue determing the hash
+     * Could also be `"not available"` for other commits if there was an issue determining the hash
      * at changelog generation time.
      *
      * Will be undefined if `options.change.includeCommitHashes` is false.
@@ -43,8 +43,15 @@ export interface PackageChangelog {
     date: Date;
     /** Version number (if a grouped changelog, for the primary package) */
     version: string;
-    /** Corresponding git tag name (if a grouped changelog, for the primary package) */
-    tag: string;
+    /**
+     * Corresponding git tag name (if a grouped changelog, for the primary package).
+     *
+     * Will be undefined if no git tag will actually be created for this package — i.e. `gitTags`
+     * is disabled and `getGitTag` is not set (or returned `null`).
+     *
+     * If the package's `getGitTag` returns multiple tags, this is the first ("most specific") one.
+     */
+    tag?: string;
     /** Changes in this version */
     comments: {
         [k in ChangeType]?: ChangelogEntry[];

package/lib/types/ChangeLog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChangeLog.d.ts","sourceRoot":"","sources":["../../src/types/ChangeLog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAE7D,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,QAAQ,EAAE;SAAG,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,cAAc,EAAE;KAAE,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;IACzE,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B"}
+{"version":3,"file":"ChangeLog.d.ts","sourceRoot":"","sources":["../../src/types/ChangeLog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAE7D,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE;SAAG,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,cAAc,EAAE;KAAE,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;IACzE,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "beachball",
-  "version": "3.0.0-alpha.2",
+  "version": "3.0.0-alpha.4",
   "description": "The Sunniest Semantic Version Bumper",
   "type": "commonjs",
   "repository": {
     "type": "git",
-    "url": "https://github.com/microsoft/beachball"
+    "url": "https://github.com/microsoft/beachball",
+    "directory": "packages/beachball"
   },
   "homepage": "https://microsoft.github.io/beachball/",
   "license": "MIT",
@@ -21,7 +22,6 @@
     "lib/!(__*)/**/*"
   ],
   "scripts": {
-    "beachball": "node ./lib/cli.js",
     "build": "yarn run -T tsc --pretty",
     "depcheck": "yarn run -T depcheck .",
     "lint": "yarn run -T eslint --color --max-warnings=0 src",
@@ -39,11 +39,11 @@
     "cosmiconfig": "^9.0.1",
     "execa": "^5.1.1",
     "minimatch": "^3.1.5",
-    "p-graph": "^1.3.0",
+    "p-graph": "^3.0.0-alpha.1",
     "p-limit": "^3.1.0",
     "prompts": "^2.4.2",
     "semver": "^7.7.4",
-    "workspace-tools": "^0.41.6",
+    "workspace-tools": "^0.41.8",
     "yargs-parser": "^21.1.1"
   },
   "devDependencies": {

package/lib/git/generateTag.d.ts

@@ -1,3 +0,0 @@
-/** Get a standardized package version git tag: `${name}_v${version}` */
-export declare function generateTag(name: string, version: string): string;
-//# sourceMappingURL=generateTag.d.ts.map

package/lib/git/generateTag.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generateTag.d.ts","sourceRoot":"","sources":["../../src/git/generateTag.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/lib/git/generateTag.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateTag = generateTag;
-/** Get a standardized package version git tag: `${name}_v${version}` */
-function generateTag(name, version) {
-    return `${name}_v${version}`;
-}
-//# sourceMappingURL=generateTag.js.map

package/lib/git/generateTag.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"generateTag.js","sourceRoot":"","sources":["../../src/git/generateTag.ts"],"names":[],"mappings":";;AACA,kCAEC;AAHD,wEAAwE;AACxE,SAAgB,WAAW,CAAC,IAAY,EAAE,OAAe;IACvD,OAAO,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/lib/publish/getNewPackages.d.ts

@@ -1,9 +0,0 @@
-import type { BumpInfo } from '../types/BumpInfo';
-import type { NpmOptions } from '../types/NpmOptions';
-/**
- * Get package versions from the registry to determine if there are any new packages that didn't
- * have a change file. (This will only fetch packages *not* in `modifiedPackages`.)
- * @returns List of detected new packages
- */
-export declare function getNewPackages(bumpInfo: Pick<BumpInfo, 'modifiedPackages' | 'packageInfos'>, options: NpmOptions): Promise<string[]>;
-//# sourceMappingURL=getNewPackages.d.ts.map

package/lib/publish/getNewPackages.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getNewPackages.d.ts","sourceRoot":"","sources":["../../src/publish/getNewPackages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,kBAAkB,GAAG,cAAc,CAAC,EAC7D,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB"}

package/lib/publish/getNewPackages.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getNewPackages = getNewPackages;
-const listPackageVersions_1 = require("../packageManager/listPackageVersions");
-const bulletedList_1 = require("../logging/bulletedList");
-/**
- * Get package versions from the registry to determine if there are any new packages that didn't
- * have a change file. (This will only fetch packages *not* in `modifiedPackages`.)
- * @returns List of detected new packages
- */
-async function getNewPackages(bumpInfo, options) {
-    const { modifiedPackages, packageInfos } = bumpInfo;
-    const maybeNewPackages = Object.keys(packageInfos).filter(pkg => !modifiedPackages.has(pkg) && !packageInfos[pkg].private);
-    const publishedVersions = await (0, listPackageVersions_1.listPackageVersions)(maybeNewPackages, options);
-    const result = maybeNewPackages.filter(pkg => !publishedVersions[pkg]?.length);
-    if (result.length) {
-        console.log(`New package(s) detected:\n${(0, bulletedList_1.bulletedList)(result)}\n`);
-    }
-    return result;
-}
-//# sourceMappingURL=getNewPackages.js.map

package/lib/publish/getNewPackages.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getNewPackages.js","sourceRoot":"","sources":["../../src/publish/getNewPackages.ts"],"names":[],"mappings":";;AAUA,wCAiBC;AA1BD,+EAA4E;AAE5E,0DAAuD;AAEvD;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAClC,QAA6D,EAC7D,OAAmB;IAEnB,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;IAEpD,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CACvD,GAAG,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,CAChE,CAAC;IAEF,MAAM,iBAAiB,GAAG,MAAM,IAAA,yCAAmB,EAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/E,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAA,2BAAY,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}