@microsoft/apps-cli 0.0.1 → 0.4.0

package/dist/Verbs/RefreshDataSource.js

@@ -0,0 +1,72 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { getPlayerServiceConfig, refreshDataSourceAsync as refreshDataSourceActionsAsync, } from '@microsoft/apps-actions';
+import { getCliLogger, getSettings } from '../CliSettings.js';
+import { promptConfirm, promptText } from '../CliUtils.js';
+import { CLI_BINARY_NAME } from '../Constants/CliConstants.js';
+import { HelpStrings } from '../Constants/HelpStrings.js';
+import { RefreshDataSourceArguments } from './VerbConstants.js';
+export async function refreshDataSourceAsync(argumentProvider) {
+    const settings = getSettings();
+    const { fileConfig, cliFs } = settings;
+    createOptionSchema(argumentProvider);
+    await argumentProvider.runVerb();
+    const playerServiceConfig = getPlayerServiceConfig();
+    const authenticationProvider = argumentProvider.getAuthenticationProvider();
+    const rawDataSourceName = await argumentProvider.getOption('dataSourceName');
+    const dataSourceName = rawDataSourceName || undefined;
+    const config = {
+        vfs: cliFs,
+        authProvider: authenticationProvider,
+        httpClient: argumentProvider.getHttpClient(),
+        region: playerServiceConfig.region,
+        environmentName: playerServiceConfig.environmentName,
+        localFilePaths: {
+            appConfigPath: fileConfig.appConfigPath,
+            schemaPath: fileConfig.schemaPath,
+            codeGenPath: fileConfig.codeGenPath,
+        },
+        logger: getCliLogger(),
+        actionsParams: {
+            dataSourceName,
+        },
+    };
+    const result = await refreshDataSourceActionsAsync(config);
+    for (const dsName of result.succeeded) {
+        console.log(`'${dsName}' refreshed successfully.`);
+    }
+    for (const failure of result.failed) {
+        console.error(`Failed to refresh '${failure.dataSourceName}': ${failure.error}`);
+    }
+    if (result.succeeded.length > 0 && result.failed.length === 0) {
+        console.log(`Hint: Run 'npx ${CLI_BINARY_NAME} run' to test locally, or 'npx ${CLI_BINARY_NAME} push' to deploy.`);
+    }
+}
+function createOptionSchema(argumentProvider) {
+    argumentProvider.setDescription(HelpStrings.app.refresh.description);
+    argumentProvider.addExamples(HelpStrings.app.refresh.examples);
+    argumentProvider.addOptions([
+        {
+            flags: {
+                key: RefreshDataSourceArguments.DataSourceName.name,
+                alias: RefreshDataSourceArguments.DataSourceName.alias,
+            },
+            env: RefreshDataSourceArguments.DataSourceName.envVar,
+            description: HelpStrings.app.refresh.options.dataSourceName,
+            optionalInNonInteractive: true,
+            customPrompt: async () => {
+                const hasSpecificDs = await promptConfirm({
+                    message: 'Do you want to refresh a specific data source? (No to refresh all)',
+                });
+                if (hasSpecificDs) {
+                    return await promptText({
+                        message: RefreshDataSourceArguments.DataSourceName.promptMessage,
+                    });
+                }
+                return '';
+            },
+        },
+    ]);
+}
+//# sourceMappingURL=RefreshDataSource.js.map

package/dist/Verbs/RefreshDataSource.js.map

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

package/dist/Verbs/RemoveFlow.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+/**
+ * Remove a cloud flow from the current app.
+ *
+ * @param {ArgumentProvider} argumentProvider
+ * @returns {Promise<void>}
+ */
+export declare function removeFlowAsync(argumentProvider: ArgumentProvider): Promise<void>;
+//# sourceMappingURL=RemoveFlow.d.ts.map

package/dist/Verbs/RemoveFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoveFlow.d.ts","sourceRoot":"","sources":["../../src/Verbs/RemoveFlow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAO5D;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CvF"}

package/dist/Verbs/RemoveFlow.js

@@ -0,0 +1,99 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { getPlayerServiceConfig, removeFlowAsync as removeFlowActionAsync, } from '@microsoft/apps-actions';
+import { getCliLogger, getSettings } from '../CliSettings.js';
+import { promptConfirm, promptText } from '../CliUtils.js';
+import { HelpStrings } from '../Constants/HelpStrings.js';
+import { CliFS } from '../FS/CliFs.js';
+import { RemoveFlowArguments } from './VerbConstants.js';
+/**
+ * Remove a cloud flow from the current app.
+ *
+ * @param {ArgumentProvider} argumentProvider
+ * @returns {Promise<void>}
+ */
+export async function removeFlowAsync(argumentProvider) {
+    const settings = getSettings();
+    const { fileConfig } = settings;
+    createOptionSchema(argumentProvider);
+    await argumentProvider.runVerb();
+    const cliFs = new CliFS({
+        cwd: process.cwd(),
+        allowCwdRead: true,
+        allowCwdWrite: true,
+    });
+    const playerServiceConfig = getPlayerServiceConfig();
+    const authenticationProvider = argumentProvider.getAuthenticationProvider();
+    const flowDataSourceName = await argumentProvider.getOption('flowName');
+    const flowId = await argumentProvider.getOption('flowId');
+    const context = {
+        vfs: cliFs,
+        authProvider: authenticationProvider,
+        httpClient: argumentProvider.getHttpClient(),
+        region: playerServiceConfig.region,
+        environmentName: playerServiceConfig.environmentName,
+        actionsParams: {
+            flowDataSourceName,
+            flowId,
+        },
+        localFilePaths: {
+            appConfigPath: fileConfig.appConfigPath,
+            schemaPath: fileConfig.schemaPath,
+            codeGenPath: fileConfig.codeGenPath,
+        },
+        logger: getCliLogger(),
+    };
+    const result = await removeFlowActionAsync(context);
+    const flowIdentifier = flowDataSourceName ?? flowId ?? '';
+    if (!result.found) {
+        console.log(`\nFlow "${flowIdentifier}" was not found in ms.config.`);
+    }
+    else if (result.success) {
+        console.log(`\nFlow "${flowIdentifier}" removed successfully.`);
+    }
+    else {
+        console.error(`\nFailed to remove flow: ${result.error}`);
+    }
+}
+function createOptionSchema(argumentProvider) {
+    argumentProvider.setDescription(HelpStrings.deprecated.Verbs['Remove-flow'].Description);
+    argumentProvider.addOptions([
+        {
+            flags: {
+                key: RemoveFlowArguments.FlowDataSourceName.name,
+                alias: RemoveFlowArguments.FlowDataSourceName.alias,
+            },
+            env: RemoveFlowArguments.FlowDataSourceName.envVar,
+            description: HelpStrings.deprecated.Verbs['Remove-flow'].Options.FlowDataSourceName,
+            optionalInNonInteractive: true,
+            customPrompt: async () => {
+                const useFlowName = await promptConfirm({
+                    message: 'Do you want to remove a flow by name?',
+                });
+                if (useFlowName) {
+                    return await promptText({
+                        message: RemoveFlowArguments.FlowDataSourceName.promptMessage,
+                    });
+                }
+                return undefined;
+            },
+        },
+        {
+            flags: {
+                key: RemoveFlowArguments.FlowId.name,
+                alias: RemoveFlowArguments.FlowId.alias,
+            },
+            env: RemoveFlowArguments.FlowId.envVar,
+            description: HelpStrings.deprecated.Verbs['Remove-flow'].Options.FlowId,
+            optionalInNonInteractive: true,
+            customPrompt: async () => {
+                const existingName = await argumentProvider.getOption('flowName', true);
+                if (existingName)
+                    return undefined;
+                return await promptText({ message: RemoveFlowArguments.FlowId.promptMessage });
+            },
+        },
+    ]);
+}
+//# sourceMappingURL=RemoveFlow.js.map

package/dist/Verbs/RemoveFlow.js.map

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

package/dist/Verbs/SetSetting.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+/**
+ * Update one or more app settings in ms.config.json for the current Power Apps code app.
+ *
+ * @param {ArgumentProvider} argumentProvider
+ * @returns {Promise<void>}
+ */
+export declare function setSettingAsync(argumentProvider: ArgumentProvider): Promise<void>;
+//# sourceMappingURL=SetSetting.d.ts.map

package/dist/Verbs/SetSetting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SetSetting.d.ts","sourceRoot":"","sources":["../../src/Verbs/SetSetting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAgD5D;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFvF"}

package/dist/Verbs/SetSetting.js

@@ -0,0 +1,142 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { APP_SETTINGS_DEFINITIONS, readRepoConfig, settingNameToOptionKey, writeRepoConfig, } from '@microsoft/apps-actions';
+import { AppConfigFileName } from '@microsoft/apps-common/config';
+import { getCliLogger, getSettings } from '../CliSettings.js';
+import { CLI_BINARY_NAME } from '../Constants/CliConstants.js';
+import { HelpStrings } from '../Constants/HelpStrings.js';
+import { UsageError } from '../Errors/CliError.js';
+import { printInfo, printJsonSuccess } from '../Utils/ConsoleOutput.js';
+/**
+ * Returns the first long flag in process.argv that is neither a known app
+ * setting nor a flag already registered with the argument provider, or null
+ * if all flags are recognised.
+ * Must be called before runVerb() so Commander hasn't had a chance to error
+ * first with its own generic message.
+ */
+function findUnknownSettingFlag(argumentProvider) {
+    const knownSettingFlags = new Set(APP_SETTINGS_DEFINITIONS.map((d) => `--${d.name}`));
+    const globalFlags = argumentProvider.getRegisteredFlags();
+    for (const token of process.argv.slice(2)) {
+        if (!token.startsWith('--'))
+            continue;
+        if (knownSettingFlags.has(token))
+            continue;
+        if (globalFlags.has(token))
+            continue;
+        return token;
+    }
+    return null;
+}
+/**
+ * Returns the name of the first known setting flag that appears more than once
+ * in process.argv, or null if no duplicates exist.
+ */
+function findDuplicateSettingFlag() {
+    for (const def of APP_SETTINGS_DEFINITIONS) {
+        const flag = `--${def.name}`;
+        const count = process.argv.filter((arg) => arg === flag).length;
+        if (count > 1) {
+            return def.name;
+        }
+    }
+    return null;
+}
+// Error messages as specified
+const ERR_INVALID = 'The setting value or name you have input is invalid. Check your input, and try again.';
+const ERR_DUPLICATE = 'You have input duplicate setting flags. Try again with one value per setting.';
+/**
+ * Update one or more app settings in ms.config.json for the current Power Apps code app.
+ *
+ * @param {ArgumentProvider} argumentProvider
+ * @returns {Promise<void>}
+ */
+export async function setSettingAsync(argumentProvider) {
+    const cliSettings = getSettings();
+    if (!cliSettings.appConfig) {
+        throw new UsageError(`No ${AppConfigFileName} found in the current directory. Run "npx ${CLI_BINARY_NAME} app init" first.`);
+    }
+    // Validate flags before Commander parses — it would otherwise emit its own generic error.
+    const unknownFlag = findUnknownSettingFlag(argumentProvider);
+    if (unknownFlag) {
+        throw new UsageError(ERR_INVALID);
+    }
+    const duplicateFlag = findDuplicateSettingFlag();
+    if (duplicateFlag) {
+        throw new UsageError(ERR_DUPLICATE);
+    }
+    createOptionSchema(argumentProvider);
+    await argumentProvider.runVerb();
+    const logger = getCliLogger();
+    const scenario = logger.trackScenario('SetSetting');
+    try {
+        // Collect and validate all provided settings before writing anything (atomic).
+        const updates = {};
+        const invalidSettings = [];
+        for (const def of APP_SETTINGS_DEFINITIONS) {
+            const optionKey = settingNameToOptionKey(def.name);
+            // ignorePrompt = true: settings are never prompted for interactively
+            const rawValue = await argumentProvider.getOption(optionKey, true);
+            if (rawValue === undefined) {
+                continue;
+            }
+            if (def.type === 'boolean') {
+                if (rawValue !== 'true' && rawValue !== 'false') {
+                    invalidSettings.push(def.name);
+                }
+                else {
+                    updates[def.configKey] = rawValue === 'true';
+                }
+            }
+        }
+        if (invalidSettings.length > 0) {
+            throw new UsageError(ERR_INVALID);
+        }
+        if (Object.keys(updates).length === 0) {
+            printInfo(`No settings provided. Use --<setting> <value> to update a setting, e.g. --show-header false.`);
+            printInfo(`Run "npx ${CLI_BINARY_NAME} app get-settings" to see available settings.`);
+            scenario.complete();
+            return;
+        }
+        // Read config fresh, merge updates, write back atomically.
+        const config = await readRepoConfig(cliSettings.fileConfig.appConfigPath);
+        config.appSettings = { ...(config.appSettings ?? {}), ...updates };
+        await writeRepoConfig(cliSettings.fileConfig.appConfigPath, config);
+        scenario.complete();
+        // Print confirmation summary.
+        const jsonMode = argumentProvider.isJsonMode();
+        if (jsonMode) {
+            printJsonSuccess({ settings: updates });
+        }
+        else {
+            for (const def of APP_SETTINGS_DEFINITIONS) {
+                const value = updates[def.configKey];
+                if (value !== undefined) {
+                    printInfo(`${def.name} = ${value}`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        scenario.failure({ error: error instanceof Error ? error.message : String(error) });
+        throw error;
+    }
+}
+// Values must be valid CliEnvVarName members — TypeScript enforces this at compile time.
+// When a new entry is added to APP_SETTINGS_DEFINITIONS, add a corresponding entry here.
+const SETTING_ENV_VARS = {
+    'show-header': 'APP_SHOW_HEADER',
+    'enable-catalyst': 'APP_ENABLE_CATALYST',
+};
+function createOptionSchema(argumentProvider) {
+    argumentProvider.setDescription(HelpStrings.app['set-setting'].description);
+    argumentProvider.addExamples(HelpStrings.app['set-setting'].examples ?? []);
+    const optionDescriptions = HelpStrings.app['set-setting'].options;
+    argumentProvider.addOptions(APP_SETTINGS_DEFINITIONS.map((def) => ({
+        flags: { key: def.name },
+        env: SETTING_ENV_VARS[def.name],
+        description: optionDescriptions?.[def.name] ?? def.description,
+    })));
+}
+//# sourceMappingURL=SetSetting.js.map

package/dist/Verbs/SetSetting.js.map

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

package/dist/Verbs/ShareMaafApp.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+/**
+ * Implements `ms app share` — grants the `Microsoft App Reader` role to the
+ * comma-separated list of AAD principals (users or groups) supplied as the
+ * positional argument. See `MaafAppPermissions.ts` for the shared resolution
+ * and execution pipeline.
+ */
+export declare function shareMaafAppAsync(argumentProvider: ArgumentProvider): Promise<void>;
+//# sourceMappingURL=ShareMaafApp.d.ts.map

package/dist/Verbs/ShareMaafApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareMaafApp.d.ts","sourceRoot":"","sources":["../../src/Verbs/ShareMaafApp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF"}

package/dist/Verbs/ShareMaafApp.js

@@ -0,0 +1,14 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { executeMaafAppPermissionsAsync } from './MaafAppPermissions.js';
+/**
+ * Implements `ms app share` — grants the `Microsoft App Reader` role to the
+ * comma-separated list of AAD principals (users or groups) supplied as the
+ * positional argument. See `MaafAppPermissions.ts` for the shared resolution
+ * and execution pipeline.
+ */
+export async function shareMaafAppAsync(argumentProvider) {
+    await executeMaafAppPermissionsAsync(argumentProvider, 'share');
+}
+//# sourceMappingURL=ShareMaafApp.js.map

package/dist/Verbs/ShareMaafApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareMaafApp.js","sourceRoot":"","sources":["../../src/Verbs/ShareMaafApp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,gBAAkC;IACxE,MAAM,8BAA8B,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/Verbs/ShowMaafApp.d.ts

@@ -0,0 +1,94 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { MaafAppDefinition } from '@microsoft/apps-actions';
+import type { AppConfig } from '@microsoft/apps-common/config';
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+export interface TableEntry {
+    /** Dataset (e.g. `server.db.windows.net,mydb`); omitted for dataverse-style refs that have no dataset. */
+    dataset?: string;
+    table: string;
+}
+export interface ProcedureEntry {
+    dataset: string;
+    procedure: string;
+}
+/**
+ * Per-connector slice rendered by `app show`. Optional fields are omitted from JSON
+ * output when empty so the document stays compact.
+ */
+export interface ConnectorView {
+    /** Logical key from `connectionReferences` (e.g. `shared_office365users`). */
+    connector: string;
+    /** Friendly name from the connector ref (e.g. `Office 365 Users`). */
+    displayName?: string;
+    /** Bound action operation names (e.g. `GetUser`, `ListUsers`). */
+    actions?: string[];
+    /** Tables bound to the app — both tabular-connector tables and dataverse logical names. */
+    tables?: TableEntry[];
+    /** Stored procedures bound to the app (currently only SQL). */
+    procedures?: ProcedureEntry[];
+}
+/**
+ * Discriminated union: `build` is omitted when neither side is configured;
+ * otherwise we emit only the keys that are actually set so the type matches
+ * what JSON consumers see (JSON.stringify drops `undefined` values silently).
+ */
+export type BuildView = {
+    path: string;
+    entryPoint: string;
+} | {
+    path: string;
+} | {
+    entryPoint: string;
+};
+/**
+ * The complete output document for `app show` — used as both the JSON payload and
+ * the input to the human formatter so the two views can never disagree.
+ */
+export interface AppShowView {
+    /** App display name from the server (`MaafAppDefinition.displayName`). */
+    name: string;
+    /** Bare environment ID. */
+    environmentId: string;
+    /** Server-side app identifier — bare GUID (`MaafAppDefinition.id`). */
+    appId: string;
+    /** Short SHA of the deployed commit; omitted when `commitHash` is absent. */
+    commit?: string;
+    /**
+     * Local build output, sourced from `ms.config.json`. Omitted when neither
+     * `buildPath` nor `buildEntryPoint` is configured — `app show` never invents
+     * defaults so the displayed values always match the config file verbatim.
+     */
+    build?: BuildView;
+    /** Connectors bound to the app, in declaration order from the server response. */
+    connectors: ConnectorView[];
+}
+/**
+ * Implements `ms app show` — prints the current app's configuration and bound
+ * resources for the project rooted at the cwd.
+ *
+ * Pipeline:
+ * 1. Register description/examples and run the verb (so `--help` works even
+ *    outside an initialised project).
+ * 2. Require a loaded `ms.config.json` with an `appId`.
+ * 3. Resolve `environmentId` (`--environment-id` flag wins; otherwise from config) and tenantId.
+ * 4. Fetch the live `MaafAppDefinition` payload via `infoAsync` (server is the
+ *    source of truth for displayName, commitHash, and connection references).
+ * 5. Fold local config (build path) + server response into an `AppShowView`.
+ * 6. Emit JSON when `--json` is set, otherwise the human view.
+ */
+export declare function showMaafAppAsync(argumentProvider: ArgumentProvider): Promise<void>;
+/**
+ * Folds the live `App` payload and the local `ms.config.json` into a single
+ * `AppShowView`. Pure function — no I/O, no console — so unit tests can exercise
+ * shape decisions without mocking the API client or stdout.
+ *
+ * @param app - The server-side app payload from `infoAsync`.
+ * @param appConfig - The parsed `ms.config.json` contents (build paths only here).
+ * @param fallbackEnvironmentId - Used when the server response omits `environmentId`
+ *   (defensive — the new MAAF wire contract makes this required, but we keep the
+ *   fallback so this function stays robust to sparse payloads).
+ */
+export declare function buildAppShowView(app: MaafAppDefinition, appConfig: AppConfig, fallbackEnvironmentId: string): AppShowView;
+//# sourceMappingURL=ShowMaafApp.d.ts.map

package/dist/Verbs/ShowMaafApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShowMaafApp.d.ts","sourceRoot":"","sources":["../../src/Verbs/ShowMaafApp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAA0B,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAwB5D,MAAM,WAAW,UAAU;IACzB,0GAA0G;IAC1G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3B;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kFAAkF;IAClF,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCxF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,SAAS,EACpB,qBAAqB,EAAE,MAAM,GAC5B,WAAW,CAab"}