@salesforce/b2c-cli 2.4.0 → 2.5.0

package/dist/commands/setup/instance/set-active.js

@@ -6,7 +6,7 @@
 import { Args, ux } from '@oclif/core';
 import { search } from '@inquirer/prompts';
 import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
-import { DwJsonSource } from '@salesforce/b2c-tooling-sdk/config';
+import { createInstanceManager, resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
 import { withDocs } from '../../../i18n/index.js';
 /**
  * Set a B2C Commerce instance as the default (active) instance.
@@ -24,9 +24,9 @@ export default class SetupInstanceSetActive extends BaseCommand {
         ...BaseCommand.baseFlags,
     };
     async run() {
-        const source = new DwJsonSource();
+        const manager = createInstanceManager();
         const configOptions = this.getBaseConfigOptions();
-        const instances = await source.listInstances(configOptions);
+        const instances = await manager.listAllInstances(configOptions);
         let name = this.args.name;
         if (!name) {
             if (instances.length === 0) {
@@ -57,17 +57,18 @@ export default class SetupInstanceSetActive extends BaseCommand {
         // Check if already active
         if (instance.active) {
             // Re-apply the selection so any active marker in the other catalog file is cleared.
-            await source.setActiveInstance(name, configOptions);
+            await manager.setActiveInstance(name, configOptions, instance.source);
             if (!this.jsonEnabled()) {
                 ux.stdout(`Instance "${name}" is already the active instance.`);
             }
+            await this.warnIfNotDefault(name, instance.source);
             return {
                 name,
                 active: true,
             };
         }
         // Set as active
-        await source.setActiveInstance(name, configOptions);
+        await manager.setActiveInstance(name, configOptions, instance.source);
         const result = {
             name,
             active: true,
@@ -75,7 +76,21 @@ export default class SetupInstanceSetActive extends BaseCommand {
         if (!this.jsonEnabled()) {
             ux.stdout(`Instance "${name}" is now the active instance.`);
         }
+        await this.warnIfNotDefault(name, instance.source);
         return result;
     }
+    /**
+     * Each source keeps its own active instance, so a higher-priority source's
+     * active instance can still be the default after this one is activated.
+     */
+    async warnIfNotDefault(name, source) {
+        const { instance: _instance, ...options } = this.getBaseConfigOptions();
+        const resolved = await resolveConfig({}, options);
+        const winner = resolved.values.instanceName;
+        if (!winner || winner === name)
+            return;
+        const winnerSource = resolved.sources.find((s) => s.fields.includes('instanceName'))?.name;
+        this.warn(`"${name}" is active in ${source ?? 'its source'}, but "${winner}"${winnerSource ? ` from ${winnerSource}` : ''} is still the default because that source takes precedence. Deactivate or remove "${winner}" there, or pass --instance ${name}.`);
+    }
 }
 //# sourceMappingURL=set-active.js.map

package/dist/commands/setup/instance/set-active.js.map

@@ -1 +1 @@
-{"version":3,"file":"set-active.js","sourceRoot":"","sources":["../../../../src/commands/setup/instance/set-active.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"set-active.js","sourceRoot":"","sources":["../../../../src/commands/setup/instance/set-active.ts"],"names":[],"mappings":"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"}

package/dist/commands/setup/set.d.ts

@@ -0,0 +1,37 @@
+import { ConfigFieldCommand } from '../../utils/setup/config-field-command.js';
+interface SetupSetResponse {
+    key: string;
+    field: string;
+    value: unknown;
+    source: string;
+    location: string;
+    instance?: string;
+}
+/**
+ * Set a configuration value in the source that supplies it.
+ */
+export default class SetupSet extends ConfigFieldCommand<typeof SetupSet> {
+    static args: {
+        key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        value: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        jsonl: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dotenv-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'project-directory': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<SetupSetResponse>;
+}
+export {};

package/dist/commands/setup/set.js

@@ -0,0 +1,87 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { isDeepStrictEqual } from 'node:util';
+import { Args } from '@oclif/core';
+import { isSensitiveConfigField, locateConfigField, parseConfigValue, resolveConfigKey, writeConfigField, } from '@salesforce/b2c-tooling-sdk/config';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { t, withDocs } from '../../i18n/index.js';
+import { ConfigFieldCommand, formatConfigValue } from '../../utils/setup/config-field-command.js';
+/**
+ * Set a configuration value in the source that supplies it.
+ */
+export default class SetupSet extends ConfigFieldCommand {
+    static args = {
+        key: Args.string({
+            description: 'Configuration key (dw.json name, e.g. code-version), or key=value',
+            required: true,
+        }),
+        value: Args.string({ description: 'Value; JSON for non-string keys (true, ["a","b"], {...})' }),
+    };
+    static description = withDocs(t('commands.setup.set.description', 'Set a configuration value in the dw.json entry or .env file that supplies it'), '/cli/setup.html#b2c-setup-set');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> code-version version2',
+        '<%= config.bin %> <%= command.id %> scapi-schemas=./scapi-schemas',
+        '<%= config.bin %> <%= command.id %> cartridges \'["app_custom","app_storefront_base"]\'',
+        '<%= config.bin %> <%= command.id %> safety \'{"level":"NO_DELETE"}\' --instance production',
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        let input = this.args.key;
+        let raw = this.args.value;
+        if (raw === undefined) {
+            const separator = input.indexOf('=');
+            if (separator === -1) {
+                this.error(t('commands.setup.set.missingValue', 'Provide a value: setup set <key> <value> or <key>=<value>.'));
+            }
+            raw = input.slice(separator + 1);
+            input = input.slice(0, separator);
+        }
+        if (raw === '') {
+            this.error(t('commands.setup.set.emptyValue', 'Empty value for {{key}}. To remove it, run: b2c setup unset {{key}}', {
+                key: input,
+            }));
+        }
+        let result;
+        let key;
+        let value;
+        try {
+            key = resolveConfigKey(input);
+            value = parseConfigValue(key, raw);
+            result = await writeConfigField(this.resolvedConfig, key.field, value);
+        }
+        catch (error) {
+            this.failWith(error);
+        }
+        const response = {
+            key: key.key,
+            field: key.field,
+            value: isSensitiveConfigField(key.field) ? formatConfigValue(key.field, value, false) : value,
+            ...result,
+        };
+        // Confirm the write took effect; a source that can't be re-read is reported, not hidden.
+        const reloaded = await this.loadConfiguration();
+        const effective = isDeepStrictEqual(reloaded.values[key.field], value);
+        if (!effective) {
+            const { supplier } = locateConfigField(reloaded, key.field);
+            this.warn(t('commands.setup.set.notEffective', '{{key}} was written, but the resolved value comes from {{source}}.', {
+                key: key.key,
+                source: supplier?.name ?? 'another source',
+            }));
+        }
+        if (this.jsonEnabled())
+            return response;
+        this.log(t('commands.setup.set.done', 'Set {{key}} = {{value}} in {{location}}', {
+            key: key.key,
+            value: formatConfigValue(key.field, value, false),
+            location: result.instance ? `${result.location} (instance ${result.instance})` : result.location,
+        }));
+        return response;
+    }
+}
+//# sourceMappingURL=set.js.map

package/dist/commands/setup/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/commands/setup/set.ts"],"names":[],"mappings":"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"}

package/dist/commands/setup/unset.d.ts

@@ -0,0 +1,37 @@
+import { ConfigFieldCommand } from '../../utils/setup/config-field-command.js';
+interface SetupUnsetResponse {
+    key: string;
+    field: string;
+    source: string;
+    location: string;
+    instance?: string;
+    /** Source supplying the field after removal, if any */
+    fallback?: string;
+}
+/**
+ * Remove a configuration value from the source that supplies it.
+ */
+export default class SetupUnset extends ConfigFieldCommand<typeof SetupUnset> {
+    static args: {
+        key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        jsonl: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dotenv-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'project-directory': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<SetupUnsetResponse>;
+}
+export {};

package/dist/commands/setup/unset.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args } from '@oclif/core';
+import { locateConfigField, removeConfigField, resolveConfigKey } from '@salesforce/b2c-tooling-sdk/config';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { t, withDocs } from '../../i18n/index.js';
+import { ConfigFieldCommand } from '../../utils/setup/config-field-command.js';
+/**
+ * Remove a configuration value from the source that supplies it.
+ */
+export default class SetupUnset extends ConfigFieldCommand {
+    static args = {
+        key: Args.string({ description: 'Configuration key (dw.json name, e.g. code-version)', required: true }),
+    };
+    static description = withDocs(t('commands.setup.unset.description', 'Remove a configuration value from the dw.json entry or .env file that supplies it'), '/cli/setup.html#b2c-setup-unset');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> scapi-schemas',
+        '<%= config.bin %> <%= command.id %> code-version --instance staging',
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        let key;
+        let result;
+        try {
+            key = resolveConfigKey(this.args.key);
+            result = await removeConfigField(this.resolvedConfig, key.field);
+        }
+        catch (error) {
+            this.failWith(error);
+        }
+        const reloaded = await this.loadConfiguration();
+        const fallback = reloaded.values[key.field] === undefined ? undefined : locateConfigField(reloaded, key.field).supplier;
+        const response = { key: key.key, field: key.field, ...result, fallback: fallback?.name };
+        if (this.jsonEnabled())
+            return response;
+        this.log(t('commands.setup.unset.done', 'Removed {{key}} from {{location}}', {
+            key: key.key,
+            location: result.instance ? `${result.location} (instance ${result.instance})` : result.location,
+        }));
+        if (fallback) {
+            this.log(t('commands.setup.unset.fallback', '{{key}} is still set by {{source}}.', {
+                key: key.key,
+                source: fallback.location ? `${fallback.name} (${fallback.location})` : fallback.name,
+            }));
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=unset.js.map

package/dist/commands/setup/unset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unset.js","sourceRoot":"","sources":["../../../src/commands/setup/unset.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAC,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAC,MAAM,oCAAoC,CAAC;AAC1G,OAAO,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAC,kBAAkB,EAAC,MAAM,2CAA2C,CAAC;AAY7E;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,kBAAqC;IAC3E,MAAM,CAAC,IAAI,GAAG;QACZ,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,qDAAqD,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KACvG,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CACC,kCAAkC,EAClC,mFAAmF,CACpF,EACD,iCAAiC,CAClC,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,mDAAmD;QACnD,qEAAqE;KACtE,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,WAAW,CAAC,SAAS;KACzB,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,GAAG,CAAC;QACR,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAChD,MAAM,QAAQ,GACZ,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;QACzG,MAAM,QAAQ,GAAuB,EAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;QAC3G,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,QAAQ,CAAC;QAExC,IAAI,CAAC,GAAG,CACN,CAAC,CAAC,2BAA2B,EAAE,mCAAmC,EAAE;YAClE,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,cAAc,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ;SACjG,CAAC,CACH,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CACN,CAAC,CAAC,+BAA+B,EAAE,qCAAqC,EAAE;gBACxE,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI;aACtF,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC"}

package/dist/utils/setup/config-field-command.d.ts

@@ -0,0 +1,25 @@
+import type { Command } from '@oclif/core';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type ConfigSource, type ResolvedB2CConfig } from '@salesforce/b2c-tooling-sdk/config';
+/**
+ * Sources for SFCC_* variables, split so that values from the shell and from
+ * the .env file are reported (and written) separately.
+ *
+ * The .env file is re-read rather than taken from `process.env`, so edits made
+ * during this command are visible to a reload. Shell variables still win.
+ */
+export declare function createEnvironmentSources(envFile?: {
+    keys: string[];
+    path: string;
+}): ConfigSource[];
+/** Format a value for display, masking sensitive fields unless `unmask`. */
+export declare function formatConfigValue(field: string, value: unknown, unmask: boolean): string;
+/**
+ * Base for `setup get/set/unset`: resolves configuration with the shell
+ * environment and .env file as sources, like `setup inspect`.
+ */
+export declare abstract class ConfigFieldCommand<T extends typeof Command> extends BaseCommand<T> {
+    /** Report config errors without a stack trace. */
+    protected failWith(error: unknown): never;
+    protected loadConfiguration(): Promise<ResolvedB2CConfig>;
+}

package/dist/utils/setup/config-field-command.js

@@ -0,0 +1,41 @@
+import { BaseCommand, loadConfig } from '@salesforce/b2c-tooling-sdk/cli';
+import { ConfigWriteError, DotenvFileSource, EnvSource, isSensitiveConfigField, maskConfigValue, readEnvFile, } from '@salesforce/b2c-tooling-sdk/config';
+/**
+ * Sources for SFCC_* variables, split so that values from the shell and from
+ * the .env file are reported (and written) separately.
+ *
+ * The .env file is re-read rather than taken from `process.env`, so edits made
+ * during this command are visible to a reload. Shell variables still win.
+ */
+export function createEnvironmentSources(envFile) {
+    const fileKeys = new Set(envFile?.keys ?? []);
+    const shellEnvironment = Object.fromEntries(Object.entries(process.env).filter(([key]) => !fileKeys.has(key)));
+    const sources = [new EnvSource(shellEnvironment)];
+    if (envFile) {
+        const fileEnvironment = Object.fromEntries(Object.entries(readEnvFile(envFile.path)).filter(([key]) => shellEnvironment[key] === undefined));
+        sources.push(new DotenvFileSource(envFile.path, fileEnvironment));
+    }
+    return sources;
+}
+/** Format a value for display, masking sensitive fields unless `unmask`. */
+export function formatConfigValue(field, value, unmask) {
+    if (typeof value === 'string')
+        return !unmask && isSensitiveConfigField(field) ? maskConfigValue(value) : value;
+    return JSON.stringify(value);
+}
+/**
+ * Base for `setup get/set/unset`: resolves configuration with the shell
+ * environment and .env file as sources, like `setup inspect`.
+ */
+export class ConfigFieldCommand extends BaseCommand {
+    /** Report config errors without a stack trace. */
+    failWith(error) {
+        if (error instanceof ConfigWriteError)
+            this.error(error.message, { code: error.code });
+        this.error(error instanceof Error ? error.message : String(error));
+    }
+    async loadConfiguration() {
+        return loadConfig({}, this.getBaseConfigOptions(), { before: createEnvironmentSources(this.envFile) });
+    }
+}
+//# sourceMappingURL=config-field-command.js.map

package/dist/utils/setup/config-field-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-field-command.js","sourceRoot":"","sources":["../../../src/utils/setup/config-field-command.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,WAAW,EAAE,UAAU,EAAC,MAAM,iCAAiC,CAAC;AACxE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,WAAW,GAGZ,MAAM,oCAAoC,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAwC;IAC/E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/G,MAAM,OAAO,GAAmB,CAAC,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAClE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CACxC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CACjG,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,KAAc,EAAE,MAAe;IAC9E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,MAAM,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,OAAgB,kBAA6C,SAAQ,WAAc;IACvF,kDAAkD;IACxC,QAAQ,CAAC,KAAc;QAC/B,IAAI,KAAK,YAAY,gBAAgB;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAC,CAAC,CAAC;QACrF,IAAI,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC;IAEkB,KAAK,CAAC,iBAAiB;QACxC,OAAO,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,oBAAoB,EAAE,EAAE,EAAC,MAAM,EAAE,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAC,CAAC,CAAC;IACvG,CAAC;CACF"}