@onecx/accelerator 7.11.0 → 7.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onecx/accelerator",
-  "version": "7.11.0",
+  "version": "7.12.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

package/src/index.d.ts

@@ -11,3 +11,4 @@ export * from './lib/utils/get-normalized-browser-locales.utils';
 export * from './lib/utils/gatherer';
 export * from './lib/utils/ensure-property.utils';
 export * from './lib/utils/get-onecx-shared-recommendations';
+export * from './lib/utils/get-onecx-shared-library-config';

package/src/index.js

@@ -14,4 +14,5 @@ tslib_1.__exportStar(require("./lib/utils/get-normalized-browser-locales.utils")
 tslib_1.__exportStar(require("./lib/utils/gatherer"), exports);
 tslib_1.__exportStar(require("./lib/utils/ensure-property.utils"), exports);
 tslib_1.__exportStar(require("./lib/utils/get-onecx-shared-recommendations"), exports);
+tslib_1.__exportStar(require("./lib/utils/get-onecx-shared-library-config"), exports);
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/accelerator/src/index.ts"],"names":[],"mappings":";;;AAAA,4DAAiC;AACjC,uEAA4C;AAC5C,mFAAwD;AACxD,qEAA0C;AAC1C,sEAA2C;AAC3C,iEAAsC;AACtC,iEAAsC;AACtC,oEAAyC;AACzC,8EAAmD;AACnD,2FAAgE;AAChE,+DAAoC;AACpC,4EAAiD;AACjD,uFAA4D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/accelerator/src/index.ts"],"names":[],"mappings":";;;AAAA,4DAAiC;AACjC,uEAA4C;AAC5C,mFAAwD;AACxD,qEAA0C;AAC1C,sEAA2C;AAC3C,iEAAsC;AACtC,iEAAsC;AACtC,oEAAyC;AACzC,8EAAmD;AACnD,2FAAgE;AAChE,+DAAoC;AACpC,4EAAiD;AACjD,uFAA4D;AAC5D,sFAA2D"}

package/src/lib/utils/get-onecx-shared-library-config.d.ts

@@ -0,0 +1,101 @@
+import { SharedLibraryConfig } from "./get-onecx-shared-recommendations";
+/**
+ * @deprecated This interface is deprecated and will be moved to `@onecx/build-utils` in v9.
+ *
+ * Callbacks that can be passed to the SharedLibraryConfigOptions function to customize its behavior.
+ * @property {function} configCallback - A function that receives the package name and current shared configuration, returning a modified configuration. Must return a SharedLibraryConfig object.
+ * @property {function} packageFilterCallback - A function that takes a package name and returns a boolean. Return true to EXCLUDE the package, false to INCLUDE it, use onecxPackageFilter to use default blacklist.
+*/
+export interface SharedLibraryConfigOptions {
+    configCallback?: (packageName: string, currentConfig: SharedLibraryConfig) => SharedLibraryConfig;
+    packageFilterCallback?: (packageName: string) => boolean | undefined;
+}
+/**
+ * @deprecated This helper is deprecated and will be moved to `@onecx/build-utils` in v9.
+ *
+ * onecxPackageFilter is the default OneCX package filter.
+ * @param {string} packageName - The full package name to check against the default blacklist.
+ * @returns {boolean} - Returns `true` if the package is on the default blacklist, `false` otherwise.
+ */
+export declare function onecxPackageFilter(packageName: string): boolean;
+/**
+ * @deprecated This helper is deprecated and will be moved to `@onecx/build-utils` in v9.
+ *
+ * Generates a shared library configuration object for all dependencies (main + subpackages if needed).
+ * @param {Record<string, string>} dependencies - Map of dependency names to versions
+ * @param {boolean} shouldGenerateSubDeps - Flag indicating whether to include subpackages based on exports
+ * @param {SharedLibraryConfigOptions} options - Optional callbacks for customizing the configuration generation process. Includes:
+ *   - configCallback: A function that receives the package name and current shared configuration, returning a modified configuration.
+ *      configCallback?: (packageName: string, currentConfig: SharedLibraryConfig) => SharedLibraryConfig;
+ *   - packageFilterCallback: A function that takes a package name and returns a boolean. Return true to EXCLUDE the package, false to INCLUDE it.
+ *      packageFilterCallback?: (packageName: string) => boolean | undefined;
+ * @returns {Record<string, SharedLibraryConfig>} A map of package names to their shared library configuration
+ *
+ * @example
+ * **Recommended usage for @module-federation/enhanced:**
+ * ```js
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, true);
+ * const config = {
+ *   name: 'onecx-test-project-ui',
+ *   filename: 'remoteEntry.js',
+ *   shared: sharedEntries,
+ *   shareScope: 'angular_21'
+ * }
+ * ```
+ *
+ * **Recommended usage for @angular-architects/module-federation:**
+ * The share function is from @angular-architects/module-federation.
+ * ```js
+ * function customConfigCallback(packageName: string, currentConfig: SharedLibraryConfig): SharedLibraryConfig {
+ *   currentConfig[includeSecondaries]=true
+ *   currentConfig[requiredVersion]='auto'
+ *   return currentConfig
+ * }
+ *
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, false, { configCallback: customConfigCallback });
+ * const config = withModuleFederationPlugin({
+ *   name: 'onecx-<%= remoteModuleFileName %>-ui',
+ *   filename: 'remoteEntryOneCX.js',
+ *   exposes: {
+ *     './OneCX<%= remoteModuleName %>Module': './src/main.ts'
+ *   },
+ *   shared: share(sharedEntries),
+ * });
+ * ```
+ * \
+ * **With options (custom filter and config override) you can customize the behavior as follows:**
+ * ```js
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, true, {
+ *   packageFilterCallback: customPackageFilter,
+ *   configCallback: customConfigCallback,
+ * });
+ * ```
+ * \
+ * Following are some Custom Implementation:
+ * 1. Adding Custom Config or overiding default config
+ *```js
+ * function customConfigCallback(packageName: string, currentConfig: SharedLibraryConfig): SharedLibraryConfig {
+ *   currentConfig[singleton]=true
+ *   return currentConfig
+ * }
+ * ```
+ *
+ * 2. Custom Package without using onecxPckageFilter
+ * ```js
+ * function customPackageFilter(packageName: string): boolean {
+ *   if (packageName.startsWith('@internal/')) return true;
+ *   return false;
+ * }
+ * ```
+ *
+ * 3. Custom Package using onecxPckageFilter as defaut:
+ * ```js
+ * function customPackageFilter(packageName: string): boolean {
+ *   if (packageName.startsWith('@internal/')) return true;
+ *   return onecxPackageFilter(packageName);
+ * }
+ *
+ * ```
+ *
+ */
+export declare function getOneCXSharedLibraryConfig(dependencies: Record<string, string>, shouldGenerateSubDeps: boolean, options?: SharedLibraryConfigOptions): Record<string, SharedLibraryConfig>;

package/src/lib/utils/get-onecx-shared-library-config.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onecxPackageFilter = onecxPackageFilter;
+exports.getOneCXSharedLibraryConfig = getOneCXSharedLibraryConfig;
+const get_onecx_shared_recommendations_1 = require("./get-onecx-shared-recommendations");
+const angularCore = '@angular/core';
+/**
+ * As we have { platform: 'browser'} in accelerator's & integration-interface project.json.
+ * We use dynamic require (provided by Node.js) to read package.json of dependencies, which is not supported in browser environment.
+ * Resolved lazily on first call so that merely importing this module from a browser bundle does not throw.
+ * Only `getOneCXSharedLibraryConfig` (build-time webpack config) calls into the file system helpers below.
+ */
+function getNodeRequire() {
+    try {
+        if (typeof process !== 'undefined' && process?.versions?.node) {
+            return eval('require');
+        }
+    }
+    catch {
+        console.log(`Node require is not available.`);
+    }
+    return null;
+}
+/**
+ * Blacklist of export paths to exclude when generating subpackage entries.
+ */
+const EXPORTS_BLACKLIST = ['.', './package.json'];
+/**
+ * Patterns for identifying dependencies that should be blacklisted.
+ */
+const DEFAULT_DEPENDENCY_BLACKLIST = [
+    /^@nx(\/.*)?$/,
+    /^@module-federation(\/.*)?$/,
+    /^@onecx\/build-utils(\/.*)?$/,
+];
+/**
+ * For identifying full package paths that should be blacklisted.
+ */
+const DEFAULT_FULL_PACKAGE_BLACKLIST = [
+    '@angular/common/locales/global/*',
+    '@angular/common/locales/*',
+    '@angular/common/upgrade',
+    '@angular/core/schematics/*',
+    '@angular/core/event-dispatch-contract.min.js',
+    '@angular/service-worker/ngsw-worker.js',
+    '@angular/service-worker/safety-worker.js',
+    '@angular/service-worker/config/schema.json',
+    '@angular/router/upgrade',
+    '@angular/localize/tools',
+    'rxjs/internal/*',
+    'primeng/resources/',
+    'primeng/editor',
+    '@onecx/angular-accelerator/testing',
+    '@onecx/angular-accelerator/migrations.json',
+];
+/**
+ * Removes the './' prefix from a string, typically used for export paths in package.json files.
+ * @param {string} str - The string from which to remove the './' prefix.
+ * @returns {string} The string without the './' prefix.
+ */
+function removeExportPrefix(str) {
+    return str.replace('./', '');
+}
+/**
+ * @deprecated This helper is deprecated and will be moved to `@onecx/build-utils` in v9.
+ *
+ * onecxPackageFilter is the default OneCX package filter.
+ * @param {string} packageName - The full package name to check against the default blacklist.
+ * @returns {boolean} - Returns `true` if the package is on the default blacklist, `false` otherwise.
+ */
+function onecxPackageFilter(packageName) {
+    if (isDependencyBlacklisted(packageName)) {
+        return true;
+    }
+    return DEFAULT_FULL_PACKAGE_BLACKLIST.includes(packageName);
+}
+/**
+ * Check whether a dependency matches any blacklist entry. Supports RegExp entries and exact string matches.
+ */
+function isDependencyBlacklisted(dependency) {
+    return DEFAULT_DEPENDENCY_BLACKLIST.some((entry) => {
+        if (entry instanceof RegExp) {
+            return entry.test(dependency);
+        }
+        return entry === dependency;
+    });
+}
+/**
+ * Resolves and reads a dependency's package.json file.
+ * Handles module resolution across npm/yarn/pnpm layouts.
+ * @param {string} dependency - Package name to resolve
+ * @returns {Object|null} Parsed package.json or null if not found
+ */
+function readDependencyPackageJson(dependency) {
+    const nodeRequire = getNodeRequire();
+    if (!nodeRequire)
+        return null;
+    let packagePath;
+    try {
+        packagePath = nodeRequire.resolve(`${dependency}/package.json`);
+    }
+    catch {
+        return null;
+    }
+    const fs = nodeRequire('fs');
+    if (!fs.existsSync(packagePath)) {
+        return null;
+    }
+    const packageContent = fs.readFileSync(packagePath, 'utf-8');
+    return JSON.parse(packageContent);
+}
+/**
+ * Generates subpackages from a dependency's export entries. Reads the dependency's package.json to find all exported subpackages
+ * and creates fully qualified package names.
+ * @param {string} dependency - Package name
+ * @param {string} version - Package version
+ * @param {function} packageFilterCallback - Optional callback to filter out specific subpackages. Should return true to exclude a package, false to include it.
+ * @returns {Array} Array of subpackage objects with name and version
+ */
+function generateSubPackageConfig(dependency, version, packageFilterCallback) {
+    const subpackages = [];
+    const dependencyPackage = readDependencyPackageJson(dependency);
+    if (!dependencyPackage?.exports) {
+        return subpackages;
+    }
+    const exportKeys = Object.keys(dependencyPackage.exports);
+    for (const exportKey of exportKeys) {
+        if (EXPORTS_BLACKLIST.includes(exportKey))
+            continue;
+        const subpackageName = `${dependency}/${removeExportPrefix(exportKey)}`;
+        if (packageFilterCallback?.(subpackageName))
+            continue;
+        subpackages.push({ name: subpackageName, requiredVersion: version });
+    }
+    return subpackages;
+}
+/**
+ * Generates all shared packages (main + subpackages) for a given dependency.
+ * Includes the main package plus all exported subpackages.
+ * @param {Object} versionMap - Map of dependency names to versions
+ * @param {string} dependency - Package name to generate packages for
+ * @param {boolean} shouldGenerateSubDeps - Flag indicating whether to include subpackages based on exports
+ * @param {function} packageFilterCallback - Optional callback to filter out specific packages. Should return true to exclude a package, false to include it.
+ * @returns {Array} Array of all packages (main + subpackages)
+ */
+function generatePackageConfig(versionMap, dependency, shouldGenerateSubDeps, packageFilterCallback = onecxPackageFilter) {
+    if (packageFilterCallback(dependency)) {
+        return [];
+    }
+    const allPackages = [];
+    const version = versionMap[dependency];
+    allPackages.push({ name: dependency, requiredVersion: version });
+    if (shouldGenerateSubDeps) {
+        const subpackages = generateSubPackageConfig(dependency, version, packageFilterCallback);
+        allPackages.push(...subpackages);
+    }
+    return allPackages;
+}
+/**
+ * @deprecated This helper is deprecated and will be moved to `@onecx/build-utils` in v9.
+ *
+ * Generates a shared library configuration object for all dependencies (main + subpackages if needed).
+ * @param {Record<string, string>} dependencies - Map of dependency names to versions
+ * @param {boolean} shouldGenerateSubDeps - Flag indicating whether to include subpackages based on exports
+ * @param {SharedLibraryConfigOptions} options - Optional callbacks for customizing the configuration generation process. Includes:
+ *   - configCallback: A function that receives the package name and current shared configuration, returning a modified configuration.
+ *      configCallback?: (packageName: string, currentConfig: SharedLibraryConfig) => SharedLibraryConfig;
+ *   - packageFilterCallback: A function that takes a package name and returns a boolean. Return true to EXCLUDE the package, false to INCLUDE it.
+ *      packageFilterCallback?: (packageName: string) => boolean | undefined;
+ * @returns {Record<string, SharedLibraryConfig>} A map of package names to their shared library configuration
+ *
+ * @example
+ * **Recommended usage for @module-federation/enhanced:**
+ * ```js
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, true);
+ * const config = {
+ *   name: 'onecx-test-project-ui',
+ *   filename: 'remoteEntry.js',
+ *   shared: sharedEntries,
+ *   shareScope: 'angular_21'
+ * }
+ * ```
+ *
+ * **Recommended usage for @angular-architects/module-federation:**
+ * The share function is from @angular-architects/module-federation.
+ * ```js
+ * function customConfigCallback(packageName: string, currentConfig: SharedLibraryConfig): SharedLibraryConfig {
+ *   currentConfig[includeSecondaries]=true
+ *   currentConfig[requiredVersion]='auto'
+ *   return currentConfig
+ * }
+ *
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, false, { configCallback: customConfigCallback });
+ * const config = withModuleFederationPlugin({
+ *   name: 'onecx-<%= remoteModuleFileName %>-ui',
+ *   filename: 'remoteEntryOneCX.js',
+ *   exposes: {
+ *     './OneCX<%= remoteModuleName %>Module': './src/main.ts'
+ *   },
+ *   shared: share(sharedEntries),
+ * });
+ * ```
+ * \
+ * **With options (custom filter and config override) you can customize the behavior as follows:**
+ * ```js
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, true, {
+ *   packageFilterCallback: customPackageFilter,
+ *   configCallback: customConfigCallback,
+ * });
+ * ```
+ * \
+ * Following are some Custom Implementation:
+ * 1. Adding Custom Config or overiding default config
+ *```js
+ * function customConfigCallback(packageName: string, currentConfig: SharedLibraryConfig): SharedLibraryConfig {
+ *   currentConfig[singleton]=true
+ *   return currentConfig
+ * }
+ * ```
+ *
+ * 2. Custom Package without using onecxPckageFilter
+ * ```js
+ * function customPackageFilter(packageName: string): boolean {
+ *   if (packageName.startsWith('@internal/')) return true;
+ *   return false;
+ * }
+ * ```
+ *
+ * 3. Custom Package using onecxPckageFilter as defaut:
+ * ```js
+ * function customPackageFilter(packageName: string): boolean {
+ *   if (packageName.startsWith('@internal/')) return true;
+ *   return onecxPackageFilter(packageName);
+ * }
+ *
+ * ```
+ *
+ */
+function getOneCXSharedLibraryConfig(dependencies, shouldGenerateSubDeps, options) {
+    const allDependencies = Object.keys(dependencies).flatMap((dependency) => {
+        return generatePackageConfig(dependencies, dependency, shouldGenerateSubDeps, options?.packageFilterCallback);
+    });
+    const sharedEntries = allDependencies.reduce((acc, packageEntry) => {
+        const sharedLibConfig = {};
+        sharedLibConfig['requiredVersion'] = packageEntry.requiredVersion;
+        sharedLibConfig['shareScope'] = 'default';
+        const angularCoreVersion = (dependencies[angularCore] || '').split('.')[0].replace('^', '');
+        if (angularCoreVersion && Number.parseInt(angularCoreVersion, 10) >= 21) {
+            const shareScope = ('angular_').concat(angularCoreVersion);
+            sharedLibConfig['shareScope'] = shareScope;
+        }
+        const onecxRecommendation = (0, get_onecx_shared_recommendations_1.getOneCXSharedRecommendations)(packageEntry.name, sharedLibConfig);
+        if (!onecxRecommendation) {
+            return acc;
+        }
+        // Apply configCallback if provided to current config overriding the recommendation
+        const configFromCallback = options?.configCallback ? options.configCallback(packageEntry.name, onecxRecommendation) : undefined;
+        if (configFromCallback && typeof configFromCallback === 'object') {
+            Object.assign(onecxRecommendation, configFromCallback);
+        }
+        return {
+            ...acc,
+            [packageEntry.name]: {
+                ...onecxRecommendation,
+            },
+        };
+    }, {});
+    return sharedEntries;
+}
+//# sourceMappingURL=get-onecx-shared-library-config.js.map

package/src/lib/utils/get-onecx-shared-library-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-onecx-shared-library-config.js","sourceRoot":"","sources":["../../../../../../libs/accelerator/src/lib/utils/get-onecx-shared-library-config.ts"],"names":[],"mappings":"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"}

package/src/lib/utils/get-onecx-shared-recommendations.d.ts

@@ -5,5 +5,16 @@ export interface SharedLibraryConfig {
     requiredVersion?: string | false;
     version?: string;
     includeSecondaries?: boolean;
+    shareScope?: string;
 }
+/**
+ * @deprecated This helper is deprecated and will be moved to `@onecx/build-utils` in v9. Use `getOneCXSharedLibraryConfig` to generate the shared config instead.
+ *
+ * Provides recommendations for shared library configurations for specific OneCX-related libraries.
+ * If the library name matches certain patterns (e.g., Angular, OneCX, RxJS, PrimeNG, ngx-translate, ngrx), it modifies the shared configuration to set singleton, strictVersion, and eager to false.
+ * For non-matching libraries, it returns false and does not modify the configuration.
+ * @param {string} libraryName - The name of the library being shared.
+ * @param {SharedLibraryConfig} sharedConfig - The existing shared configuration for the library, which may be modified if recommendations are applied.
+ * @returns {false | SharedLibraryConfig} - Returns the modified shared configuration if recommendations are applied, or false if no recommendations are applicable.
+ */
 export declare function getOneCXSharedRecommendations(libraryName: string, sharedConfig: SharedLibraryConfig): false | SharedLibraryConfig;

package/src/lib/utils/get-onecx-shared-recommendations.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOneCXSharedRecommendations = getOneCXSharedRecommendations;
+/**
+ * Patterns for identifying shared libraries that should have specific configuration recommendations.
+ */
 const sharedLibraryPatterns = [
     /^@angular.*$/,
     /^@onecx.*$/,
@@ -9,6 +12,16 @@ const sharedLibraryPatterns = [
     /^@ngx-translate.*$/,
     /^@ngrx.*$/,
 ];
+/**
+ * @deprecated This helper is deprecated and will be moved to `@onecx/build-utils` in v9. Use `getOneCXSharedLibraryConfig` to generate the shared config instead.
+ *
+ * Provides recommendations for shared library configurations for specific OneCX-related libraries.
+ * If the library name matches certain patterns (e.g., Angular, OneCX, RxJS, PrimeNG, ngx-translate, ngrx), it modifies the shared configuration to set singleton, strictVersion, and eager to false.
+ * For non-matching libraries, it returns false and does not modify the configuration.
+ * @param {string} libraryName - The name of the library being shared.
+ * @param {SharedLibraryConfig} sharedConfig - The existing shared configuration for the library, which may be modified if recommendations are applied.
+ * @returns {false | SharedLibraryConfig} - Returns the modified shared configuration if recommendations are applied, or false if no recommendations are applicable.
+ */
 function getOneCXSharedRecommendations(libraryName, sharedConfig) {
     if (!sharedLibraryPatterns.some((pattern) => pattern.test(libraryName))) {
         return false;

package/src/lib/utils/get-onecx-shared-recommendations.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-onecx-shared-recommendations.js","sourceRoot":"","sources":["../../../../../../libs/accelerator/src/lib/utils/get-onecx-shared-recommendations.ts"],"names":[],"mappings":";;AAkBA,sEAYC;AArBD,MAAM,qBAAqB,GAAa;IACtC,cAAc;IACd,YAAY;IACZ,UAAU;IACV,aAAa;IACb,oBAAoB;IACpB,WAAW;CACZ,CAAA;AAED,SAAgB,6BAA6B,CAC3C,WAAmB,EACnB,YAAiC;IAEjC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,KAAK,CAAA;IACd,CAAC;IAED,YAAY,CAAC,SAAS,GAAG,KAAK,CAAA;IAC9B,YAAY,CAAC,aAAa,GAAG,KAAK,CAAA;IAClC,YAAY,CAAC,KAAK,GAAG,KAAK,CAAA;IAC1B,OAAO,YAAY,CAAA;AACrB,CAAC"}
+{"version":3,"file":"get-onecx-shared-recommendations.js","sourceRoot":"","sources":["../../../../../../libs/accelerator/src/lib/utils/get-onecx-shared-recommendations.ts"],"names":[],"mappings":";;AAgCA,sEAYC;AAlCD;;GAEG;AACH,MAAM,qBAAqB,GAAa;IACtC,cAAc;IACd,YAAY;IACZ,UAAU;IACV,aAAa;IACb,oBAAoB;IACpB,WAAW;CACZ,CAAA;AAED;;;;;;;;;GASG;AACH,SAAgB,6BAA6B,CAC3C,WAAmB,EACnB,YAAiC;IAEjC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,KAAK,CAAA;IACd,CAAC;IAED,YAAY,CAAC,SAAS,GAAG,KAAK,CAAA;IAC9B,YAAY,CAAC,aAAa,GAAG,KAAK,CAAA;IAClC,YAAY,CAAC,KAAK,GAAG,KAAK,CAAA;IAC1B,OAAO,YAAY,CAAA;AACrB,CAAC"}