mcdev 9.0.3 → 10.0.0

package/@types/lib/util/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../lib/util/cli.js"],"names":[],"mappings":";yBAca,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;0BAC7C,OAAO,wBAAwB,EAAE,WAAW;;IAQrD;;;;;OAKG;IACH,4BAFa,OAAO,CAAE,MAAM,GAAG,OAAO,CAAC,CAUtC;IAED;;;;;OAKG;IACH,wCAHW,OAAO,GACL,OAAO,CAAE,OAAO,GAAG,MAAM,CAAC,CAkBtC;IAED;;;;OAIG;IACH,+CAHW,MAAM,EAAE,GACN,OAAO,CAAE,OAAO,CAAC,CA6B7B;IAED;;;;;OAKG;IACH,4CAHW,OAAO,GACL,IAAI,CAShB;IAED;;;;;;;;OAQG;IACH,sCALW,OAAO,YACP,MAAM,eACN,OAAO,GACL,OAAO,CAAE,MAAM,GAAG,OAAO,CAAC,CAUtC;IAED;;;;;;;;OAQG;IACH,yCANW,OAAO,UACP,MAAM,qBACN,OAAO,GAAG,MAAM,aAChB,OAAO,GACL,OAAO,CAAE,QAAQ,CAAC,CAuE9B;IAED;;;;;;;;OAQG;IACH,+BANW,OAAO,eACP,MAAM,qBACN,OAAO,aACP,OAAO,GACL,OAAO,CAAE;QAAC,YAAY,EAAC,MAAM,CAAC;QAAC,UAAU,EAAC,MAAM,CAAA;KAAC,CAAC,CA8D9D;IAED;;;;;;;OAOG;IACH,oCALW,OAAO,aACP,MAAM,eACN,OAAO,GACL,OAAO,CAAE,OAAO,GAAG,MAAM,CAAC,CA+DtC;IAED;;;;;;OAMG;IACH,qCAJW,OAAO,aACP,MAAM,GACJ,OAAO,CAAE,MAAM,CAAC,CAwE5B;IAED;;;;;;OAMG;IACH,iCAJW,OAAO,gBACP,MAAM,EAAE,GACN,OAAO,CAAE,IAAI,CAAC,CAgG1B;IAED;;;;OAIG;IACH,yBAFa,WAAW,EAAE,CA0GzB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../lib/util/cli.js"],"names":[],"mappings":";yBAaa,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;0BAC7C,OAAO,wBAAwB,EAAE,WAAW;;IAQrD;;;;;OAKG;IACH,4BAFa,OAAO,CAAE,MAAM,GAAG,OAAO,CAAC,CAUtC;IAED;;;;;OAKG;IACH,wCAHW,OAAO,GACL,OAAO,CAAE,OAAO,GAAG,MAAM,CAAC,CAkBtC;IAED;;;;OAIG;IACH,+CAHW,MAAM,EAAE,GACN,OAAO,CAAE,OAAO,CAAC,CA6B7B;IAED;;;;;OAKG;IACH,4CAHW,OAAO,GACL,IAAI,CAShB;IAED;;;;;;;;OAQG;IACH,sCALW,OAAO,YACP,MAAM,eACN,OAAO,GACL,OAAO,CAAE,MAAM,GAAG,OAAO,CAAC,CAUtC;IAED;;;;;;;;OAQG;IACH,yCANW,OAAO,UACP,MAAM,qBACN,OAAO,GAAG,MAAM,aAChB,OAAO,GACL,OAAO,CAAE,QAAQ,CAAC,CAuE9B;IAED;;;;;;;;OAQG;IACH,+BANW,OAAO,eACP,MAAM,qBACN,OAAO,aACP,OAAO,GACL,OAAO,CAAE;QAAC,YAAY,EAAC,MAAM,CAAC;QAAC,UAAU,EAAC,MAAM,CAAA;KAAC,CAAC,CAgE9D;IAED;;;;;;;OAOG;IACH,oCALW,OAAO,aACP,MAAM,eACN,OAAO,GACL,OAAO,CAAE,OAAO,GAAG,MAAM,CAAC,CA+DtC;IAED;;;;;;OAMG;IACH,qCAJW,OAAO,aACP,MAAM,GACJ,OAAO,CAAE,MAAM,CAAC,CAwE5B;IAED;;;;;;OAMG;IACH,iCAJW,OAAO,gBACP,MAAM,EAAE,GACN,OAAO,CAAE,IAAI,CAAC,CAgG1B;IAED;;;;OAIG;IACH,yBAFa,WAAW,EAAE,CAsGzB"}

package/@types/lib/util/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../lib/util/config.js"],"names":[],"mappings":";yBASa,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;;;IAStD;;;;;;OAMG;IACH,gCAJW,OAAO,WACP,OAAO,GACL,OAAO,CAAE,OAAO,CAAC,CAiE7B;IAED;;;;;;OAMG;IACH,qCAJW,OAAO,WACP,OAAO,GACL,OAAO,CAAE,OAAO,GAAG,MAAM,EAAE,CAAC,CAmMxC;IAED;;;;;OAKG;IACH,iCAFa,OAAO,CAAE,OAAO,CAAC,CAiB7B"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../lib/util/config.js"],"names":[],"mappings":";yBAMa,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;;;IAStD;;;;;;OAMG;IACH,gCAJW,OAAO,WACP,OAAO,GACL,OAAO,CAAE,OAAO,CAAC,CAiE7B;IAED;;;;;;OAMG;IACH,qCAJW,OAAO,WACP,OAAO,GACL,OAAO,CAAE,OAAO,GAAG,MAAM,EAAE,CAAC,CAuMxC;IAED;;;;;OAKG;IACH,iCAFa,OAAO,CAAE,OAAO,CAAC,CAiB7B"}

package/@types/lib/util/devops.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Suppresses migration-only asset changes while preserving edited destinations.
+ *
+ * @param {DeltaPkgItem[]} files normalized Git changes
+ * @param {string} range compared Git range
+ * @param {Pick<import('./git.js').GitAdapter, 'revparse'>} gitClient Git client
+ * @returns {Promise.<DeltaPkgItem[]>} filtered changes
+ */
+export function filterAssetRegroupingChanges(files: DeltaPkgItem[], range: string, gitClient?: Pick<import("./git.js").GitAdapter, "revparse">): Promise<DeltaPkgItem[]>;
 export default DevOps;
 export type AuthObject = import("../../types/mcdev.d.js").AuthObject;
 export type BuObject = import("../../types/mcdev.d.js").BuObject;

package/@types/lib/util/devops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devops.d.ts","sourceRoot":"","sources":["../../../lib/util/devops.js"],"names":[],"mappings":";yBAea,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;0BAC7C,OAAO,wBAAwB,EAAE,WAAW;;IAOrD;;;;;;;;;;OAUG;IACH,kCAPW,OAAO,UACP,MAAM,oBACN,OAAO,mBACP,MAAM,kBACN,MAAM,GACJ,OAAO,CAAE,YAAY,EAAE,CAAC,CAsXpC;IAED;;;;;;;;OAQG;IACH,2CANW,OAAO,SACP,MAAM,YACN,YAAY,EAAE,kBACd,MAAM,GACJ,OAAO,CAAE,YAAY,EAAE,CAAC,CA+JpC;IAED;;;;;;;OAOG;IACH,6BALW,MAAM,kBACN,MAAM,cACN,MAAM,GACJ,IAAI,CAmChB;IAED;;;;;;;;;OASG;IACH,sCANW,OAAO,YACP,QAAQ,gBACR,MAAM,UACN,MAAM,EAAE,GACN,OAAO,CAAE,MAAM,EAAE,CAAC,CAM9B;IACD;;;;;;;OAOG;IACH,4CALW,YAAY,EAAE,gBACd,MAAM,cACN,OAAO,gBACP,MAAM,QAgGhB"}
+{"version":3,"file":"devops.d.ts","sourceRoot":"","sources":["../../../lib/util/devops.js"],"names":[],"mappings":"AA0BA;;;;;;;GAOG;AACH,oDALW,YAAY,EAAE,SACd,MAAM,cACN,IAAI,CAAC,OAAO,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,GAC7C,OAAO,CAAE,YAAY,EAAE,CAAC,CA8DpC;;yBAGY,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;0BAC7C,OAAO,wBAAwB,EAAE,WAAW;;IAOrD;;;;;;;;;;OAUG;IACH,kCAPW,OAAO,UACP,MAAM,oBACN,OAAO,mBACP,MAAM,kBACN,MAAM,GACJ,OAAO,CAAE,YAAY,EAAE,CAAC,CAmXpC;IAED;;;;;;;;OAQG;IACH,2CANW,OAAO,SACP,MAAM,YACN,YAAY,EAAE,kBACd,MAAM,GACJ,OAAO,CAAE,YAAY,EAAE,CAAC,CAiKpC;IAED;;;;;;;OAOG;IACH,6BALW,MAAM,kBACN,MAAM,cACN,MAAM,GACJ,IAAI,CAqChB;IAED;;;;;;;;;OASG;IACH,sCANW,OAAO,YACP,QAAQ,gBACR,MAAM,UACN,MAAM,EAAE,GACN,OAAO,CAAE,MAAM,EAAE,CAAC,CAM9B;IACD;;;;;;;OAOG;IACH,4CALW,YAAY,EAAE,gBACd,MAAM,cACN,OAAO,gBACP,MAAM,QAkGhB"}

package/@types/lib/util/file.d.ts

@@ -14,11 +14,34 @@ export type MetadataTypeMapObj = import("../../types/mcdev.d.js").MetadataTypeMa
 export type MultiMetadataTypeList = import("../../types/mcdev.d.js").MultiMetadataTypeList;
 export type MultiMetadataTypeMap = import("../../types/mcdev.d.js").MultiMetadataTypeMap;
 export type SoapRequestParams = import("../../types/mcdev.d.js").SoapRequestParams;
-export type TemplateMap = import("../../types/mcdev.d.js").TemplateMap;
 export type TypeKeyCombo = import("../../types/mcdev.d.js").TypeKeyCombo;
 declare const FileFs: typeof fs & {
     prettierConfig: any;
     prettierConfigFileType: any;
+    prettierConfigCache: Map<any, any>;
+    /**
+     * Loads and caches formatting packages after formatting has been confirmed enabled.
+     *
+     * @returns {Promise.<{prettier: import('prettier'), prettierPluginSfmc: object}>} formatter modules
+     */
+    _loadPrettierModules(): Promise<{
+        prettier: typeof import("prettier");
+        prettierPluginSfmc: object;
+    }>;
+    /**
+     * Maps mcdev file extensions to Prettier parser names.
+     *
+     * @param {string} filetype file extension without dot
+     * @returns {string | undefined} parser name when mcdev has an explicit mapping
+     */
+    _getPrettierParser(filetype: string): string | undefined;
+    /**
+     * Checks whether formatting is enabled by CLI or project configuration.
+     *
+     * @param {Mcdevrc} properties project configuration
+     * @returns {boolean} whether formatting should run
+     */
+    _isFormattingEnabled(properties: Mcdevrc): boolean;
     /**
      * copies a file from one path to another
      *
@@ -76,26 +99,16 @@ declare const FileFs: typeof fs & {
      * @param {string} filename name of the file without suffix
      * @param {string} filetype filetype ie. JSON or SSJS
      * @param {string} content filecontent
-     * @param {TemplateMap} [templateVariables] templating variables to be replaced in the metadata
      * @returns {Promise.<boolean>} Promise
      */
-    writePrettyToFile: (directory: string | string[], filename: string, filetype: string, content: string, templateVariables?: TemplateMap) => Promise<boolean>;
+    writePrettyToFile: (directory: string | string[], filename: string, filetype: string, content: string) => Promise<boolean>;
     /**
-     * helper that applies beautyAmp onto given stringified content; strongly typed for strings only
+     * Formats extracted Transactional SMS content when formatting is enabled.
      *
-     * @param {string} content code
-     * @param {boolean} [formatHTML] applies formatting to html and ampscript if true
-     * @returns {Promise.<string>} formatted code
-     */
-    _beautify_beautyAmp_beautify: (content: string, formatHTML?: boolean) => Promise<string>;
-    /**
-     * helper for {@link File.writePrettyToFile}, applying beautyAmp onto given stringified content
-     *
-     * @param {string} content filecontent
-     * @param {boolean} formatHTML should we format HTML or not via prettier included in beautyAmp
-     * @returns {Promise.<string>} original string on error; formatted string on success
+     * @param {string} content extracted AMPscript content
+     * @returns {Promise.<string>} original string when disabled or on error; formatted string on success
      */
-    beautify_beautyAmp: (content: string, formatHTML?: boolean) => Promise<string>;
+    _formatTransactionalSmsContent: (content: string) => Promise<string>;
     /**
      * helper for {@link File.writePrettyToFile}, applying prettier onto given stringified content
      * ! Important: run 'await File.initPrettier()' in your MetadataType.retrieve() once before hitting this
@@ -166,9 +179,10 @@ declare const FileFs: typeof fs & {
      * helper that splits the config back into auth & config parts to save them separately
      *
      * @param {Mcdevrc} properties central properties object
-     * @returns {Promise.<void>} -
+     * @param {string} [version] version to persist; defaults to the current mcdev version
+     * @returns {Promise.<boolean>} whether the config file was saved successfully
      */
-    saveConfigFile(properties: Mcdevrc): Promise<void>;
+    saveConfigFile(properties: Mcdevrc, version?: string): Promise<boolean>;
     /**
      * Initalises Prettier formatting lib async.
      *

package/@types/lib/util/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../lib/util/file.js"],"names":[],"mappings":";yBAWa,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;AAykB1D;;;IAvjBI;;;;;;OAMG;yBAHQ,MAAM,MACN,MAAM,GACJ,OAAO,CAAE;QAAC,MAAM,EAAC,IAAI,GAAC,SAAS,GAAC,QAAQ,CAAC;QAAC,aAAa,EAAC,MAAM,CAAC;QAAC,IAAI,EAAC,MAAM,CAAA;KAAC,CAAC;IAkB1F;;;;;OAKG;iCAFQ,MAAM,GACJ,MAAM;IAiCnB;;;;;OAKG;qCAFQ,MAAM,GACJ,MAAM;IA2BnB;;;;;OAKG;4CAFQ,MAAM,GACJ,MAAM;IAMnB;;;;;OAKG;sCAFQ,MAAM,GAAC,MAAM,EAAE,KACb,MAAM;IAcnB;;;;;;;OAOG;iCAJQ,MAAM,GAAC,MAAM,EAAE,YACf,MAAM,WACN,MAAM;IAcjB;;;;;;;;;;OAUG;mCANQ,MAAM,GAAC,MAAM,EAAE,YACf,MAAM,YACN,MAAM,WACN,MAAM,sBACN,WAAW,KACT,OAAO,CAAE,OAAO,CAAC;IAuB9B;;;;;;OAMG;4CAHQ,MAAM,eACN,OAAO,KACL,OAAO,CAAE,MAAM,CAAC;IAW7B;;;;;;OAMG;kCAHQ,MAAM,eACN,OAAO,KACL,OAAO,CAAE,MAAM,CAAC;IAyB7B;;;;;;;;;OASG;oCALQ,MAAM,GAAC,MAAM,EAAE,YACf,MAAM,YACN,MAAM,WACN,MAAM,KACJ,OAAO,CAAE,MAAM,CAAC;IA+F7B;;;;;;;;;OASG;6BANQ,MAAM,GAAC,MAAM,EAAE,YACf,MAAM,YACN,MAAM,WACN,MAAM,aACN,MAAM,KACJ,OAAO,CAAE,OAAO,CAAC;IAoB9B;;;;;;;OAOG;8BAJQ,MAAM,GAAG,MAAM,EAAE,YACjB,MAAM,aACN,OAAO,KACL,OAAO,CAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IA0B7C;;;;;;;;OAQG;sCALQ,MAAM,GAAG,MAAM,EAAE,YACjB,MAAM,YACN,MAAM,aACN,MAAM,KACJ,OAAO,CAAE,MAAM,CAAC;IAc7B;;;;;;;;;;OAUG;iCALQ,MAAM,SACN,MAAM,gBACN,OAAO,gBACP,MAAM,KACJ,OAAO,CAAE,MAAM,EAAE,CAAC;IA6C/B;;;;;;;;;;;OAWG;qCALQ,MAAM,UACN,MAAM,gBACN,OAAO,gBACP,MAAM,KACJ,MAAM,EAAE,GAAG,IAAI;IA4C5B;;;;;OAKG;+BAFQ,OAAO,GACL,OAAO,CAAE,IAAI,CAAC;IAU3B;;;;;OAKG;4BAFQ,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC;EAyCK;eAnmBxB,UAAU"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../lib/util/file.js"],"names":[],"mappings":";yBAQa,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;2BAClD,OAAO,wBAAwB,EAAE,YAAY;AA2lB1D;;;;IA7kBI;;;;OAIG;4BADU,OAAO,CAAE;QAAC,QAAQ,EAAE,yBAAkB,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAC,CAAC;IAejF;;;;;OAKG;iCAFQ,MAAM,GACJ,MAAM,GAAG,SAAS;IAmD/B;;;;;OAKG;qCAFQ,OAAO,GACL,OAAO;IASpB;;;;;;OAMG;yBAHQ,MAAM,MACN,MAAM,GACJ,OAAO,CAAE;QAAC,MAAM,EAAC,IAAI,GAAC,SAAS,GAAC,QAAQ,CAAC;QAAC,aAAa,EAAC,MAAM,CAAC;QAAC,IAAI,EAAC,MAAM,CAAA;KAAC,CAAC;IAkB1F;;;;;OAKG;iCAFQ,MAAM,GACJ,MAAM;IAiCnB;;;;;OAKG;qCAFQ,MAAM,GACJ,MAAM;IA2BnB;;;;;OAKG;4CAFQ,MAAM,GACJ,MAAM;IAMnB;;;;;OAKG;sCAFQ,MAAM,GAAC,MAAM,EAAE,KACb,MAAM;IAYnB;;;;;;;OAOG;iCAJQ,MAAM,GAAC,MAAM,EAAE,YACf,MAAM,WACN,MAAM;IAgBjB;;;;;;;;;OASG;mCALQ,MAAM,GAAC,MAAM,EAAE,YACf,MAAM,YACN,MAAM,WACN,MAAM,KACJ,OAAO,CAAE,OAAO,CAAC;IAU9B;;;;;OAKG;8CAFQ,MAAM,KACJ,OAAO,CAAE,MAAM,CAAC;IAU7B;;;;;;;;;OASG;oCALQ,MAAM,GAAC,MAAM,EAAE,YACf,MAAM,YACN,MAAM,WACN,MAAM,KACJ,OAAO,CAAE,MAAM,CAAC;IA0D7B;;;;;;;;;OASG;6BANQ,MAAM,GAAC,MAAM,EAAE,YACf,MAAM,YACN,MAAM,WACN,MAAM,aACN,MAAM,KACJ,OAAO,CAAE,OAAO,CAAC;IAoB9B;;;;;;;OAOG;8BAJQ,MAAM,GAAG,MAAM,EAAE,YACjB,MAAM,aACN,OAAO,KACL,OAAO,CAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IA0B7C;;;;;;;;OAQG;sCALQ,MAAM,GAAG,MAAM,EAAE,YACjB,MAAM,YACN,MAAM,aACN,MAAM,KACJ,OAAO,CAAE,MAAM,CAAC;IAc7B;;;;;;;;;;OAUG;iCALQ,MAAM,SACN,MAAM,gBACN,OAAO,gBACP,MAAM,KACJ,OAAO,CAAE,MAAM,EAAE,CAAC;IA8C/B;;;;;;;;;;;OAWG;qCALQ,MAAM,UACN,MAAM,gBACN,OAAO,gBACP,MAAM,KACJ,MAAM,EAAE,GAAG,IAAI;IA8C5B;;;;;;OAMG;+BAHQ,OAAO,YACP,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC;IAoB9B;;;;;OAKG;4BAFQ,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC;EA8CK;eAjnBxB,UAAU"}

package/@types/lib/util/git.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Creates a Git adapter rooted at the supplied directory.
+ *
+ * @param {{cwd?: string, gitBinary?: string, run?: typeof execFileAsync}} [options] client options
+ * @returns {GitAdapter} shell-free Git client
+ */
+export function createGit(options?: {
+    cwd?: string;
+    gitBinary?: string;
+    run?: typeof execFileAsync;
+}): GitAdapter;
+/**
+ * Error raised when Git cannot start or returns a non-zero status.
+ */
+export class GitCommandError extends Error {
+    /**
+     * Creates an actionable Git command failure.
+     *
+     * @param {string} message human-readable failure summary
+     * @param {{args: string[], cwd: string, cause: Error & {code?: string | number}, stderr: string}} details command context
+     */
+    constructor(message: string, details: {
+        args: string[];
+        cwd: string;
+        cause: Error & {
+            code?: string | number;
+        };
+        stderr: string;
+    });
+    args: string[];
+    cwd: string;
+    code: string | number;
+    stderr: string;
+}
+/**
+ * Narrow asynchronous Git client with return shapes compatible with mcdev's former call sites.
+ */
+export class GitAdapter {
+    /**
+     * Creates a client. The executable override exists for deterministic missing-Git tests.
+     *
+     * @param {{cwd?: string, gitBinary?: string, run?: typeof execFileAsync}} [options] process options
+     */
+    constructor(options?: {
+        cwd?: string;
+        gitBinary?: string;
+        run?: typeof execFileAsync;
+    });
+    cwd: string;
+    gitBinary: string;
+    run: typeof execFile.__promisify__;
+    /**
+     * Executes Git directly and returns decoded stdout.
+     *
+     * @param {string[]} args exact Git arguments; shell syntax is never accepted or evaluated
+     * @returns {Promise.<string>} UTF-8 stdout with its trailing newline preserved
+     * @throws {GitCommandError} when Git is unavailable or the command fails
+     */
+    execute(args: string[]): Promise<string>;
+    /**
+     * Reads commit history using caller-provided Git log options.
+     *
+     * @param {string[]} [args] supported `git log` selection arguments
+     * @returns {Promise.<{all: {hash: string, date: string, message: string, author_name: string}[]}>} commits in Git order
+     */
+    log(args?: string[]): Promise<{
+        all: {
+            hash: string;
+            date: string;
+            message: string;
+            author_name: string;
+        }[];
+    }>;
+    /**
+     * Returns name/status changes for a revision range using NUL delimiters for filename safety.
+     *
+     * @param {string[]} args revision/path arguments passed after the fixed diff options
+     * @returns {Promise.<({file: string, status: string, from?: string, changes: number, insertions: number, deletions: number, binary: false})[]>} changes in Git order
+     */
+    diffNameStatus(args: string[]): Promise<({
+        file: string;
+        status: string;
+        from?: string;
+        changes: number;
+        insertions: number;
+        deletions: number;
+        binary: false;
+    })[]>;
+    /**
+     * Returns the file-list subset of the former `simple-git` diff summary shape.
+     *
+     * @param {string[]} args revision/path arguments
+     * @returns {Promise.<{files: ({file: string, status: string, from?: string, changes: number, insertions: number, deletions: number, binary: false})[]}>} summary consumed by mcdev
+     */
+    diffSummary(args: string[]): Promise<{
+        files: ({
+            file: string;
+            status: string;
+            from?: string;
+            changes: number;
+            insertions: number;
+            deletions: number;
+            binary: false;
+        })[];
+    }>;
+    /**
+     * Resolves a revision, object, or `<revision>:<path>` specification.
+     *
+     * @param {string[]} args revision arguments
+     * @returns {Promise.<string>} resolved value without trailing whitespace
+     */
+    revparse(args: string[]): Promise<string>;
+    /**
+     * Lists remotes and their fetch/push URLs, preserving first-seen remote order.
+     *
+     * @param {boolean} [verbose] retained for call-site parity; URLs are always returned
+     * @returns {Promise.<{name: string, refs: {fetch?: string, push?: string}}[]>} remotes
+     */
+    getRemotes(verbose?: boolean): Promise<{
+        name: string;
+        refs: {
+            fetch?: string;
+            push?: string;
+        };
+    }[]>;
+    /**
+     * Fetches configured remotes without a shell or interactive stdin.
+     *
+     * @param {string[]} [args] optional fetch arguments
+     * @returns {Promise.<string>} Git fetch stdout
+     */
+    fetch(args?: string[]): Promise<string>;
+    /**
+     * Lists remote-tracking branches in Git order.
+     *
+     * @param {string[]} [args] branch options; only `-r` is used by mcdev
+     * @returns {Promise.<{all: string[]}>} branch names
+     */
+    branch(args?: string[]): Promise<{
+        all: string[];
+    }>;
+    /**
+     * Reads the effective Git configuration value visible from the working directory.
+     *
+     * @param {string} key Git config key
+     * @returns {Promise.<{value: string | null}>} value, or null when the key is unset
+     */
+    getConfig(key: string): Promise<{
+        value: string | null;
+    }>;
+}
+declare const execFileAsync: typeof execFile.__promisify__;
+import { execFile } from 'node:child_process';
+export {};
+//# sourceMappingURL=git.d.ts.map

package/@types/lib/util/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../lib/util/git.js"],"names":[],"mappings":"AA6QA;;;;;GAKG;AACH,oCAHW;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,aAAa,CAAA;CAAC,GAC5D,UAAU,CAItB;AAnQD;;GAEG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,WACN;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,GAAG;YAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;SAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,EAShG;IAJG,eAAwB;IACxB,YAAsB;IACtB,sBAA8B;IAC9B,eAA4B;CAEnC;AA6DD;;GAEG;AACH;IACI;;;;OAIG;IACH,sBAFW;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,aAAa,CAAA;KAAC,EAMxE;IAHG,YAAqD;IACrD,kBAA2C;IAC3C,mCAAuC;IAG3C;;;;;;OAMG;IACH,cAJW,MAAM,EAAE,GACN,OAAO,CAAE,MAAM,CAAC,CA0B5B;IAED;;;;;OAKG;IACH,WAHW,MAAM,EAAE,GACN,OAAO,CAAE;QAAC,GAAG,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAC,EAAE,CAAA;KAAC,CAAC,CAoBjG;IAED;;;;;OAKG;IACH,qBAHW,MAAM,EAAE,GACN,OAAO,CAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,CAAA;KAAC,CAAC,EAAE,CAAC,CAY9I;IAED;;;;;OAKG;IACH,kBAHW,MAAM,EAAE,GACN,OAAO,CAAE;QAAC,KAAK,EAAE,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,KAAK,CAAA;SAAC,CAAC,EAAE,CAAA;KAAC,CAAC,CAIvJ;IAED;;;;;OAKG;IACH,eAHW,MAAM,EAAE,GACN,OAAO,CAAE,MAAM,CAAC,CAI5B;IAED;;;;;OAKG;IACH,qBAHW,OAAO,GACL,OAAO,CAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,EAAE,CAAC,CAgB7E;IAED;;;;;OAKG;IACH,aAHW,MAAM,EAAE,GACN,OAAO,CAAE,MAAM,CAAC,CAI5B;IAED;;;;;OAKG;IACH,cAHW,MAAM,EAAE,GACN,OAAO,CAAE;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAC,CAAC,CAKrC;IAED;;;;;OAKG;IACH,eAHW,MAAM,GACJ,OAAO,CAAE;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,CAAC,CAW5C;CACJ;AA3PD,2DAA0C;yBAJjB,oBAAoB"}

package/@types/lib/util/init.config.d.ts

@@ -21,16 +21,44 @@ declare namespace Init {
      * helper method for this.upgradeProject that upgrades project config if needed
      *
      * @param {Mcdevrc} properties config file's json
+     * @param {string} [versionToPersist] version to store while saving config migrations
      * @returns {Promise.<boolean>} returns true if worked without errors
      */
-    function fixMcdevConfig(properties: Mcdevrc): Promise<boolean>;
+    function fixMcdevConfig(properties: Mcdevrc, versionToPersist?: string): Promise<boolean>;
     /**
-     * handles creation/update of all config file from the boilerplate
+     * handles creation/update of all config files from the boilerplate, one at a time
      *
      * @param {string} versionBeforeUpgrade 'x.y.z'
      * @returns {Promise.<boolean>} status of config file creation
      */
     function createIdeConfigFiles(versionBeforeUpgrade: string): Promise<boolean>;
+    /**
+     * Prompt for an ordinary configuration override.
+     *
+     * @param {string} message selection to present
+     * @param {boolean} [defaultValue] initial selection
+     * @returns {Promise.<boolean>} user's selection
+     */
+    function promptConfirmation(message: string, defaultValue?: boolean): Promise<boolean>;
+    /**
+     * Compare, optionally back up, and write one configuration file.
+     *
+     * @param {string} fileName destination path
+     * @param {{updates:string[],deletes:string[]}} forced version-gated replacements and retirements
+     * @param {string} content boilerplate contents
+     * @returns {Promise.<boolean>} success, including a declined override
+     */
+    function _createIdeConfigFile(fileName: string, forced: {
+        updates: string[];
+        deletes: string[];
+    }, content: string): Promise<boolean>;
+    /**
+     * Check entry occupancy without following links or hiding access errors.
+     *
+     * @param {string} fileName destination or backup path
+     * @returns {Promise.<boolean>} whether the directory entry exists
+     */
+    function _hasDirectoryEntry(fileName: string): Promise<boolean>;
     /**
      * recursive helper for {@link Init.fixMcdevConfig} that adds missing settings
      *
@@ -50,18 +78,6 @@ declare namespace Init {
         updates: string[];
         deletes: string[];
     }>;
-    /**
-     * handles creation/update of one config file from the boilerplate at a time
-     *
-     * @param {string[]} fileNameArr 0: path, 1: filename, 2: extension with dot
-     * @param {{updates:string[],deletes:string[]}} relevantForced if fileNameArr is in this list we require an override
-     * @param {string} [boilerplateFileContent] in case we cannot copy files 1:1 this can be used to pass in content
-     * @returns {Promise.<boolean>} install successful or error occured
-     */
-    function _createIdeConfigFile(fileNameArr: string[], relevantForced: {
-        updates: string[];
-        deletes: string[];
-    }, boilerplateFileContent?: string): Promise<boolean>;
     /**
      * handles deletion of no longer needed config files
      *

package/@types/lib/util/init.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.config.d.ts","sourceRoot":"","sources":["../../../lib/util/init.config.js"],"names":[],"mappings":";yBAYa,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;;IAQtD;;;;;OAKG;IACH,oCAHW,OAAO,GACL,OAAO,CAAE,OAAO,CAAC,CAmP7B;IAED;;;;;OAKG;IACH,oDAHW,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CAmE7B;IAED;;;;;;;OAOG;IACH,qCALW,MAAM,mBACN,MAAM,aACN,MAAM,GACJ,OAAO,CAyBnB;IAED;;;;;OAKG;IACH,8CAHW,MAAM,GACJ,OAAO,CAAE;QAAC,OAAO,EAAC,MAAM,EAAE,CAAC;QAAA,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,CAAC,CA+BzD;IAED;;;;;;;OAOG;IACH,2CALW,MAAM,EAAE,kBACR;QAAC,OAAO,EAAC,MAAM,EAAE,CAAC;QAAA,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,2BACnC,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CAwF7B;IAED;;;;;OAKG;IACH,+CAHW;QAAC,OAAO,EAAC,MAAM,EAAE,CAAC;QAAA,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,GACjC,OAAO,CAAE,OAAO,CAAC,CAc7B;IAED;;;;OAIG;IACH,4BAFa,OAAO,CAAE,OAAO,CAAC,CAyB7B"}
+{"version":3,"file":"init.config.d.ts","sourceRoot":"","sources":["../../../lib/util/init.config.js"],"names":[],"mappings":";yBAUa,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;;IAQtD;;;;;;OAMG;IACH,oCAJW,OAAO,qBACP,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CAyP7B;IAED;;;;;OAKG;IACH,oDAHW,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CAkD7B;IAED;;;;;;OAMG;IACH,qCAJW,MAAM,iBACN,OAAO,GACL,OAAO,CAAE,OAAO,CAAC,CAI7B;IAED;;;;;;;OAOG;IACH,wCALW,MAAM,UACN;QAAC,OAAO,EAAC,MAAM,EAAE,CAAC;QAAA,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,WACnC,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CAgD7B;IAED;;;;;OAKG;IACH,sCAHW,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CAY7B;IAED;;;;;;;OAOG;IACH,qCALW,MAAM,mBACN,MAAM,aACN,MAAM,GACJ,OAAO,CAyBnB;IAED;;;;;OAKG;IACH,8CAHW,MAAM,GACJ,OAAO,CAAE;QAAC,OAAO,EAAC,MAAM,EAAE,CAAC;QAAA,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,CAAC,CAgCzD;IAED;;;;;OAKG;IACH,+CAHW;QAAC,OAAO,EAAC,MAAM,EAAE,CAAC;QAAA,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,GACjC,OAAO,CAAE,OAAO,CAAC,CAgB7B;IAED;;;;OAIG;IACH,4BAFa,OAAO,CAAE,OAAO,CAAC,CAyB7B"}

package/@types/lib/util/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../lib/util/init.js"],"names":[],"mappings":";yBAaa,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;;IAQtD;;;;;;;OAOG;IACH,iCALW,OAAO,mBACP,MAAM,eACN,OAAO,GACL,OAAO,CAAE,IAAI,CAAC,CAwK1B;IAED;;;;OAIG;IACH,wBAFa,OAAO,CAAE,IAAI,CAAC,CAoE1B;IAED;;OAEG;IACH,uCAmDC;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,aACN,MAAM,GACJ,OAAO,CAAE,IAAI,CAAC,CA8B1B;IAED;;;;;;;OAOG;IACH,oCALW,OAAO,YACP,OAAO,aACP,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CAuC7B;IAED;;;;;OAKG;IACH,+BAFa,OAAO,CAAE,OAAO,CAAC,CA8C7B;IAED;;;;;;OAMG;IACH,4CAHW,OAAO,GACL,MAAM,EAAE,CAyBpB"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../lib/util/init.js"],"names":[],"mappings":";yBAaa,OAAO,wBAAwB,EAAE,UAAU;uBAC3C,OAAO,wBAAwB,EAAE,QAAQ;oBACzC,OAAO,wBAAwB,EAAE,KAAK;0BACtC,OAAO,wBAAwB,EAAE,WAAW;8BAC5C,OAAO,wBAAwB,EAAE,eAAe;2BAChD,OAAO,wBAAwB,EAAE,YAAY;sBAC7C,OAAO,wBAAwB,EAAE,OAAO;+BACxC,OAAO,wBAAwB,EAAE,gBAAgB;mCACjD,OAAO,wBAAwB,EAAE,oBAAoB;kCACrD,OAAO,wBAAwB,EAAE,mBAAmB;8BACpD,OAAO,wBAAwB,EAAE,eAAe;iCAChD,OAAO,wBAAwB,EAAE,kBAAkB;oCACnD,OAAO,wBAAwB,EAAE,qBAAqB;mCACtD,OAAO,wBAAwB,EAAE,oBAAoB;gCACrD,OAAO,wBAAwB,EAAE,iBAAiB;0BAClD,OAAO,wBAAwB,EAAE,WAAW;2BAC5C,OAAO,wBAAwB,EAAE,YAAY;;IAQtD;;;;;;;OAOG;IACH,iCALW,OAAO,mBACP,MAAM,eACN,OAAO,GACL,OAAO,CAAE,IAAI,CAAC,CAwK1B;IAED;;;;OAIG;IACH,wBAFa,OAAO,CAAE,IAAI,CAAC,CAoE1B;IAED;;OAEG;IACH,uCAmDC;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,aACN,MAAM,GACJ,OAAO,CAAE,IAAI,CAAC,CA8B1B;IAED;;;;;;;OAOG;IACH,oCALW,OAAO,YACP,OAAO,aACP,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CA8C7B;IAED;;;;;OAKG;IACH,+BAFa,OAAO,CAAE,OAAO,CAAC,CAgD7B;IAED;;;;;;OAMG;IACH,4CAHW,OAAO,GACL,MAAM,EAAE,CAyBpB"}

package/@types/lib/util/init.git.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Checks whether Git can be executed without invoking a shell.
+ *
+ * @param {(command: string, args: string[], options: object) => {error?: Error, status: number | null}} [run] synchronous process runner
+ * @returns {boolean} true when `git --version` succeeds
+ */
+export function isGitInstalled(run?: (command: string, args: string[], options: object) => {
+    error?: Error;
+    status: number | null;
+}): boolean;
 export default Init;
 declare namespace Init {
     /**

package/@types/lib/util/init.git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.git.d.ts","sourceRoot":"","sources":["../../../lib/util/init.git.js"],"names":[],"mappings":";;IAcI;;;;OAIG;IACH,wBAFa,OAAO,CAAE;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAAC,CA4DxD;IAED;;;;OAIG;IACH,oBAFa,OAAO,CAAE,IAAI,CAAC,CAsC1B;IAED;;;;OAIG;IACH,0BAFa,OAAO,CAAE,MAAM,CAAC,CA2C5B;IAED;;;;OAIG;IACH,iCAFa,OAAO,CAAE,IAAI,CAAC,CAiE1B;IAED;;;;OAIG;IACH,8BAFa,OAAO,CAAE;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAC,CAAC,CAOjE"}
+{"version":3,"file":"init.git.d.ts","sourceRoot":"","sources":["../../../lib/util/init.git.js"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,qCAHW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,KAAK;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAC,GAC1F,OAAO,CAKnB;;;IAOG;;;;OAIG;IACH,wBAFa,OAAO,CAAE;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAAC,CA4DxD;IAED;;;;OAIG;IACH,oBAFa,OAAO,CAAE,IAAI,CAAC,CAyC1B;IAED;;;;OAIG;IACH,0BAFa,OAAO,CAAE,MAAM,CAAC,CA2C5B;IAED;;;;OAIG;IACH,iCAFa,OAAO,CAAE,IAAI,CAAC,CA+D1B;IAED;;;;OAIG;IACH,8BAFa,OAAO,CAAE;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAC,CAAC,CAQjE"}

package/@types/lib/util/init.npm.d.ts

@@ -1,24 +1,19 @@
 export default Init;
 declare namespace Init {
     /**
-     * initiates npm project and then
-     * takes care of loading the pre-configured dependency list
-     * from the boilerplate directory to them as dev-dependencies
+     * Update project tooling defaults and install dependencies.
      *
-     * @param {string} [repoName] if git URL was provided earlier, the repo name was extracted to use it for npm init
-     * @returns {Promise.<boolean>} install successful or error occured
+     * @param {string} [repoName] optional initial project name
+     * @param {string} [versionBeforeUpgrade] original project version for retirement gating
+     * @returns {Promise.<boolean>} whether installation succeeded
      */
-    function installDependencies(repoName?: string): Promise<boolean>;
+    function installDependencies(repoName?: string, versionBeforeUpgrade?: string): Promise<boolean>;
     /**
-     * ensure we have certain default values in our config
+     * Apply owned defaults while retaining unrelated project settings.
      *
-     * @param {object} [currentContent] what was read from existing package.json file
-     * @returns {Promise.<{script: object, author: string, license: string}>} extended currentContent
+     * @param {object} currentContent existing package contents
+     * @returns {object} updated package contents
      */
-    function _getDefaultPackageJson(currentContent?: object): Promise<{
-        script: object;
-        author: string;
-        license: string;
-    }>;
+    function _getDefaultPackageJson(currentContent: object): object;
 }
 //# sourceMappingURL=init.npm.d.ts.map

package/@types/lib/util/init.npm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.npm.d.ts","sourceRoot":"","sources":["../../../lib/util/init.npm.js"],"names":[],"mappings":";;IAcI;;;;;;;OAOG;IACH,wCAHW,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CA4G7B;IAED;;;;;OAKG;IACH,iDAHW,MAAM,GACJ,OAAO,CAAE;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CA8BvE"}
+{"version":3,"file":"init.npm.d.ts","sourceRoot":"","sources":["../../../lib/util/init.npm.js"],"names":[],"mappings":";;IAsBI;;;;;;OAMG;IACH,wCAJW,MAAM,yBACN,MAAM,GACJ,OAAO,CAAE,OAAO,CAAC,CA2F7B;IAED;;;;;OAKG;IACH,gDAHW,MAAM,GACJ,MAAM,CAuBlB"}

package/@types/lib/util/isDeepEqual.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compares arrays and plain objects recursively while allowing scalar type coercion.
+ *
+ * @param {unknown} left first value
+ * @param {unknown} right second value
+ * @returns {boolean} whether both values are equivalent
+ */
+export function isDeepEqual(left: unknown, right: unknown): boolean;
+//# sourceMappingURL=isDeepEqual.d.ts.map

package/@types/lib/util/isDeepEqual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDeepEqual.d.ts","sourceRoot":"","sources":["../../../lib/util/isDeepEqual.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,kCAJW,OAAO,SACP,OAAO,GACL,OAAO,CA0BnB"}

package/@types/lib/util/jsonToTable.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Converts one object or an array of objects into rows with flattened headers.
+ * Empty input produces a table containing one empty header row.
+ *
+ * @param {object | object[]} input object or objects to tabulate
+ * @returns {unknown[][]} header row followed by value rows
+ */
+export default function jsonToTable(input: object | object[]): unknown[][];
+//# sourceMappingURL=jsonToTable.d.ts.map

package/@types/lib/util/jsonToTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonToTable.d.ts","sourceRoot":"","sources":["../../../lib/util/jsonToTable.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,2CAHW,MAAM,GAAG,MAAM,EAAE,GACf,OAAO,EAAE,EAAE,CAkCvB"}

package/@types/lib/util/migrations/assetV10.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Finds the current group for an asset in a historical group.
+ *
+ * @param {string} assetTypeName owner JSON assetType.name
+ * @param {string} oldGroup historical asset group
+ * @returns {string | null} current group or null when no migration applies
+ */
+export function getCurrentAssetGroup(assetTypeName: string, oldGroup: string): string | null;
+/**
+ * Converts one historical asset path to its current-group path.
+ *
+ * @param {string} filePath normalized repository path
+ * @param {string} oldGroup historical asset group
+ * @param {string} currentGroup current asset group
+ * @returns {string | null} mapped path or null when the path is outside that group
+ */
+export function mapAssetPath(filePath: string, oldGroup: string, currentGroup: string): string | null;
+/**
+ * Checks whether two asset paths form an allowlisted historical-to-current grouping pair.
+ *
+ * @param {string} oldPath historical path
+ * @param {string} newPath current path
+ * @returns {boolean} whether the paths are a structural regrouping pair
+ */
+export function isAssetRegroupingPair(oldPath: string, newPath: string): boolean;
+/**
+ * @typedef {object} AssetV10MigrationReport
+ * @property {string[]} moved destination paths of the asset files that were relocated
+ * @property {string[]} conflicts owner paths left in place because their move set collided
+ * @property {string[]} skipped owner paths whose metadata JSON could not be read
+ * @property {Object.<string, string[]>} unmapped owner paths without a current group, keyed by assetType.name
+ * @property {string[]} unremovedEmptyDirs directories that hold only empty subdirectories or no entries but the OS did not allow removing
+ * @property {string[]} unremovedNonEmptyDirs directories that still hold non-directory entries (including links and special entries) and must not be deleted
+ */
+/**
+ * Migrates historical asset groupings inside one selected BU retrieve tree.
+ *
+ * @param {string} assetRoot selected BU retrieve asset directory
+ * @returns {Promise.<AssetV10MigrationReport>} migration report
+ */
+export function migrateAssetV10Tree(assetRoot: string): Promise<AssetV10MigrationReport>;
+export type AssetV10MigrationReport = {
+    /**
+     * destination paths of the asset files that were relocated
+     */
+    moved: string[];
+    /**
+     * owner paths left in place because their move set collided
+     */
+    conflicts: string[];
+    /**
+     * owner paths whose metadata JSON could not be read
+     */
+    skipped: string[];
+    /**
+     * owner paths without a current group, keyed by assetType.name
+     */
+    unmapped: {
+        [x: string]: string[];
+    };
+    /**
+     * directories that hold only empty subdirectories or no entries but the OS did not allow removing
+     */
+    unremovedEmptyDirs: string[];
+    /**
+     * directories that still hold non-directory entries (including links and special entries) and must not be deleted
+     */
+    unremovedNonEmptyDirs: string[];
+};
+//# sourceMappingURL=assetV10.d.ts.map

package/@types/lib/util/migrations/assetV10.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetV10.d.ts","sourceRoot":"","sources":["../../../../lib/util/migrations/assetV10.js"],"names":[],"mappings":"AAuCA;;;;;;GAMG;AACH,oDAJW,MAAM,YACN,MAAM,GACJ,MAAM,GAAG,IAAI,CASzB;AAED;;;;;;;GAOG;AACH,uCALW,MAAM,YACN,MAAM,gBACN,MAAM,GACJ,MAAM,GAAG,IAAI,CAWzB;AAED;;;;;;GAMG;AACH,+CAJW,MAAM,WACN,MAAM,GACJ,OAAO,CAanB;AA6ID;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,+CAHW,MAAM,GACJ,OAAO,CAAE,uBAAuB,CAAC,CAuH7C;;;;;WAnIa,MAAM,EAAE;;;;eACR,MAAM,EAAE;;;;aACR,MAAM,EAAE;;;;;;;;;;wBAER,MAAM,EAAE;;;;2BACR,MAAM,EAAE"}