@salesforce/webapps-features-experimental 1.68.0

package/LICENSE.txt

@@ -0,0 +1,82 @@
+Terms of Use
+
+Copyright 2026 Salesforce, Inc. All rights reserved.
+
+These Terms of Use govern the download, installation, and/or use of this
+software provided by Salesforce, Inc. ("Salesforce") (the "Software"), were
+last updated on April 15, 2025, and constitute a legally binding
+agreement between you and Salesforce. If you do not agree to these Terms of
+Use, do not install or use the Software.
+
+Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free
+copyright license to reproduce, prepare derivative works of, publicly
+display, publicly perform, sublicense, and distribute the Software and
+derivative works subject to these Terms. These Terms shall be included in
+all copies or substantial portions of the Software.
+
+Subject to the limited rights expressly granted hereunder, Salesforce
+reserves all rights, title, and interest in and to all intellectual
+property subsisting in the Software. No rights are granted to you hereunder
+other than as expressly set forth herein. Users residing in countries on
+the United States Office of Foreign Assets Control sanction list, or which
+are otherwise subject to a US export embargo, may not use the Software.
+
+Implementation of the Software may require development work, for which you
+are responsible. The Software may contain bugs, errors and
+incompatibilities and is made available on an AS IS basis without support,
+updates, or service level commitments.
+
+Salesforce reserves the right at any time to modify, suspend, or
+discontinue, the Software (or any part thereof) with or without notice. You
+agree that Salesforce shall not be liable to you or to any third party for
+any modification, suspension, or discontinuance.
+
+You agree to defend Salesforce against any claim, demand, suit or
+proceeding made or brought against Salesforce by a third party arising out
+of or accruing from (a) your use of the Software, and (b) any application
+you develop with the Software that infringes any copyright, trademark,
+trade secret, trade dress, patent, or other intellectual property right of
+any person or defames any person or violates their rights of publicity or
+privacy (each a "Claim Against Salesforce"), and will indemnify Salesforce
+from any damages, attorney fees, and costs finally awarded against
+Salesforce as a result of, or for any amounts paid by Salesforce under a
+settlement approved by you in writing of, a Claim Against Salesforce,
+provided Salesforce (x) promptly gives you written notice of the Claim
+Against Salesforce, (y) gives you sole control of the defense and
+settlement of the Claim Against Salesforce (except that you may not settle
+any Claim Against Salesforce unless it unconditionally releases Salesforce
+of all liability), and (z) gives you all reasonable assistance, at your
+expense.
+
+WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT
+SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES,
+INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL,
+PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA,
+OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN
+CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU
+HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+These Terms of Use shall be governed exclusively by the internal laws of
+the State of California, without regard to its conflicts of laws
+rules. Each party hereby consents to the exclusive jurisdiction of the
+state and federal courts located in San Francisco County, California to
+adjudicate any dispute arising out of or relating to these Terms of Use and
+the download, installation, and/or use of the Software. Except as expressly
+stated herein, these Terms of Use constitute the entire agreement between
+the parties, and supersede all prior and contemporaneous agreements,
+proposals, or representations, written or oral, concerning their subject
+matter. No modification, amendment, or waiver of any provision of these
+Terms of Use shall be effective unless it is by an update to these Terms of
+Use that Salesforce makes available, or is in writing and signed by the
+party against whom the modification, amendment, or waiver is to be
+asserted.
+
+Data Privacy: Salesforce may collect, process, and store device,
+system, and other information related to your use of the Software. This
+information includes, but is not limited to, IP address, user metrics, and
+other data ("Usage Data"). Salesforce may use Usage Data for analytics,
+product development, and marketing purposes. You acknowledge that files
+generated in conjunction with the Software may contain sensitive or
+confidential data, and you are solely responsible for anonymizing and
+protecting such data.

package/README.md

@@ -0,0 +1,154 @@
+# @salesforce/webapps-features-experimental
+
+CLI tool for installing UI features into Salesforce webapps.
+
+## Installation
+
+### Using npx (Recommended)
+
+```bash
+npx @salesforce/webapps-features-experimental <command>
+```
+
+## Usage
+
+### List Available Features
+
+```bash
+npx @salesforce/webapps-features-experimental list
+```
+
+Search for specific features:
+
+```bash
+npx @salesforce/webapps-features-experimental list --search "auth"
+```
+
+### Describe a Feature
+
+Get detailed information about a specific feature:
+
+```bash
+npx @salesforce/webapps-features-experimental describe authentication
+```
+
+This shows:
+
+- Full description
+- Dependencies (feature and npm packages)
+- Files that will be copied
+- Integration examples
+- Components and capabilities
+
+### Install a Feature
+
+```bash
+npx @salesforce/webapps-features-experimental install <feature-name> --webapp-dir <path>
+```
+
+Example:
+
+```bash
+npx @salesforce/webapps-features-experimental install authentication --webapp-dir force-app/main/default/webapplications/mywebapp
+```
+
+#### Installation Options
+
+- `--webapp-dir <path>` - **Required**. Path to the webapp directory
+- `--sfdx-root <path>` - Optional. SFDX metadata root (default: `force-app/main/default`)
+- `--dry-run` - Preview changes without making them
+- `--verbose` or `-v` - Show detailed output
+- `--yes` or `-y` - Skip conflicts (non-destructive)
+- `--on-conflict <mode>` - Conflict resolution mode: `error`, `skip`, `overwrite`, or `prompt` (default)
+- `--conflict-resolution <file>` - JSON file with per-file conflict resolutions
+
+### Handling Conflicts
+
+The recommended workflow for LLMs and automated tools:
+
+1. **First, detect conflicts:**
+
+   ```bash
+   npx @salesforce/webapps-features-experimental install authentication \
+     --webapp-dir force-app/main/default/webapplications/mywebapp \
+     --on-conflict error
+   ```
+
+2. **If conflicts are detected**, create a resolution file:
+
+   ```json
+   {
+     "path/to/file1": "overwrite",
+     "path/to/file2": "skip",
+     "path/to/file3": "overwrite"
+   }
+   ```
+
+3. **Rerun with resolution file:**
+   ```bash
+   npx @salesforce/webapps-features-experimental install authentication \
+     --webapp-dir force-app/main/default/webapplications/mywebapp \
+     --conflict-resolution resolution.json
+   ```
+
+### Integration Examples
+
+After installation, the CLI will list any `__example__` files that need manual integration:
+
+```
+Example files to integrate:
+  src/__example__auth-app.tsx → Integrate into: src/app.tsx
+```
+
+For each example file:
+
+1. Read the example file to see the integration pattern
+2. Apply the pattern to your target file
+3. Delete the example file after integration
+
+## Available Features
+
+Run `npx @salesforce/webapps-features-experimental list` to see all available features.
+
+Common features:
+
+- **authentication** - Complete auth system with login, registration, password reset
+- **shadcn** - UI component library based on shadcn/ui
+- **global-search** - Salesforce object search
+- **nav-menu** - Navigation menu layout
+- **charts** - Analytics charts with Recharts
+- **graphql** - GraphQL integration
+- **agentforce** - AI-powered conversation interface
+
+## Local Development
+
+### Building
+
+```bash
+npm run build
+```
+
+### Running locally
+
+```bash
+npm run dev -- <command>
+```
+
+Example:
+
+```bash
+npm run dev -- list
+npm run dev -- install authentication --webapp-dir /path/to/webapp
+```
+
+### Global install from local build
+
+```bash
+npm run build && npm link
+```
+
+Then use `webapps-features-experimental <command>` directly without `npx`.
+
+## License
+
+SEE LICENSE IN LICENSE.txt

package/dist/conflict-detector.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { ConflictResolution, InstallationContext } from "./types.js";
+/**
+ * Check if a path already exists (file or directory)
+ * For directories, we don't consider them conflicts - only individual files
+ */
+export declare function hasConflict(path: string): boolean;
+/**
+ * Resolve a conflict based on the context's conflict mode
+ */
+export declare function resolveConflict(path: string, context: InstallationContext): Promise<ConflictResolution>;
+/**
+ * Collect all conflicts for error mode
+ * Returns a list of conflicting paths
+ *
+ * For directory operations, we need the source path to check individual files
+ */
+export declare function collectConflicts(operations: {
+    from: string;
+    to: string;
+    sourcePath: string;
+}[]): string[];
+/**
+ * Output error message with conflict list and instructions
+ */
+export declare function outputConflictError(conflicts: string[]): void;
+//# sourceMappingURL=conflict-detector.d.ts.map

package/dist/conflict-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detector.d.ts","sourceRoot":"","sources":["../src/conflict-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBjD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CA6B7B;AAwBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,GAC5D,MAAM,EAAE,CASV;AAkDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CA8B7D"}

package/dist/conflict-detector.js

@@ -0,0 +1,153 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { existsSync, readdirSync, statSync } from "fs";
+import { join } from "path";
+import inquirer from "inquirer";
+/**
+ * Check if a path already exists (file or directory)
+ * For directories, we don't consider them conflicts - only individual files
+ */
+export function hasConflict(path) {
+    if (!existsSync(path)) {
+        return false;
+    }
+    // If it's a file, it's a conflict
+    try {
+        const stats = statSync(path);
+        if (stats.isFile()) {
+            return true;
+        }
+        // If it's a directory, it's not a conflict - we can merge into it
+        return false;
+    }
+    catch (_error) {
+        // If we can't stat it, assume no conflict
+        return false;
+    }
+}
+/**
+ * Resolve a conflict based on the context's conflict mode
+ */
+export async function resolveConflict(path, context) {
+    // Check if we already have a resolution for this path
+    if (context.conflictResolutions[path]) {
+        return context.conflictResolutions[path];
+    }
+    const mode = context.conflictMode;
+    const logger = context.logger;
+    switch (mode) {
+        case "prompt":
+            return await promptForResolution(path);
+        case "error":
+            // In error mode, we don't resolve - just return 'cancel' to stop
+            return "cancel";
+        case "skip":
+            logger.debug(`Auto-skipping conflict: ${path}`);
+            return "skip";
+        case "overwrite":
+            logger.debug(`Auto-overwriting conflict: ${path}`);
+            return "overwrite";
+        default:
+            throw new Error(`Unknown conflict mode: ${mode}`);
+    }
+}
+/**
+ * Prompt user interactively for conflict resolution
+ */
+async function promptForResolution(path) {
+    console.warn(`[WARN] Destination already exists: ${path}`);
+    const answer = await inquirer.prompt([
+        {
+            type: "list",
+            name: "resolution",
+            message: `File/directory already exists: ${path}. What would you like to do?`,
+            choices: [
+                { name: "Skip (keep existing)", value: "skip" },
+                { name: "Overwrite (loses customizations)", value: "overwrite" },
+                { name: "Cancel installation", value: "cancel" },
+            ],
+        },
+    ]);
+    return answer.resolution;
+}
+/**
+ * Collect all conflicts for error mode
+ * Returns a list of conflicting paths
+ *
+ * For directory operations, we need the source path to check individual files
+ */
+export function collectConflicts(operations) {
+    const conflicts = [];
+    for (const op of operations) {
+        const fileConflicts = getConflictsForOperation(op.sourcePath, op.to);
+        conflicts.push(...fileConflicts);
+    }
+    return conflicts;
+}
+/**
+ * Get all conflicting files for a single copy operation
+ * Handles both file and directory copies
+ */
+function getConflictsForOperation(sourcePath, destPath) {
+    const conflicts = [];
+    // Check if destination exists
+    if (!existsSync(destPath)) {
+        return conflicts;
+    }
+    try {
+        const sourceStats = statSync(sourcePath);
+        const destStats = statSync(destPath);
+        // If source is a file and dest is a file, it's a conflict
+        if (sourceStats.isFile() && destStats.isFile()) {
+            conflicts.push(destPath);
+            return conflicts;
+        }
+        // If source is a directory and dest is a file, it's a conflict
+        if (sourceStats.isDirectory() && destStats.isFile()) {
+            conflicts.push(destPath);
+            return conflicts;
+        }
+        // If source is a directory and dest is a directory, check contents recursively
+        if (sourceStats.isDirectory() && destStats.isDirectory()) {
+            const sourceFiles = readdirSync(sourcePath);
+            for (const file of sourceFiles) {
+                const sourceFile = join(sourcePath, file);
+                const destFile = join(destPath, file);
+                // Recursively check for conflicts in subdirectories
+                const subConflicts = getConflictsForOperation(sourceFile, destFile);
+                conflicts.push(...subConflicts);
+            }
+        }
+    }
+    catch (_error) {
+        // If we can't stat, no conflict
+        return conflicts;
+    }
+    return conflicts;
+}
+/**
+ * Output error message with conflict list and instructions
+ */
+export function outputConflictError(conflicts) {
+    console.error("[ERROR] Conflicts detected during installation");
+    console.log("\nConflicts found:");
+    conflicts.forEach((path, index) => {
+        console.log(`${index + 1}. ${path} (${existsSync(path) ? "already exists" : "unknown"})`);
+    });
+    console.log("\nTo resolve, create a conflict resolution file:\n");
+    console.log("Example conflict-resolution.json:");
+    const exampleResolutions = {};
+    conflicts.forEach((path) => {
+        exampleResolutions[path] = "overwrite"; // or 'skip'
+    });
+    console.log(JSON.stringify(exampleResolutions, null, 2));
+    console.log("\nThen run:");
+    console.log("npx @salesforce/webapps-features-experimental install <feature> --conflict-resolution conflict-resolution.json");
+    console.log("\nOr use automatic modes:");
+    console.log("npx @salesforce/webapps-features-experimental install <feature> --on-conflict skip (keeps all existing files)");
+    console.log("npx @salesforce/webapps-features-experimental install <feature> --on-conflict overwrite (replaces all files - destructive)");
+}
+//# sourceMappingURL=conflict-detector.js.map

package/dist/conflict-detector.js.map

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

package/dist/dependency-resolver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { FileCopySchema, InstallationContext } from "./types.js";
+/**
+ * Resolve and install feature dependencies recursively
+ * Follows the exact workflow: install package -> load schema -> recursively process
+ */
+export declare function resolveFeatureDependencies(dependencies: string[], context: InstallationContext): Promise<void>;
+/**
+ * Process the "own" operations for a feature (package deps + copies),
+ * excluding recursive feature dependency resolution.
+ * Used by install-feature.ts for the main feature's section.
+ */
+export declare function processFeatureOwnOperations(schema: FileCopySchema, packageName: string, context: InstallationContext): Promise<void>;
+//# sourceMappingURL=dependency-resolver.d.ts.map

package/dist/dependency-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../src/dependency-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtE;;;GAGG;AACH,wBAAsB,0BAA0B,CAC/C,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAIf;AAuED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/dependency-resolver.js

@@ -0,0 +1,90 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { getFeatureMetadata } from "./feature-metadata.js";
+import { executeCopyOperations } from "./file-copier.js";
+import { installPackage, installPackageDependencies, isPackageInstalled, } from "./package-manager.js";
+import { loadSchemaFromNodeModules } from "./schema-loader.js";
+/**
+ * Resolve and install feature dependencies recursively
+ * Follows the exact workflow: install package -> load schema -> recursively process
+ */
+export async function resolveFeatureDependencies(dependencies, context) {
+    for (const dependency of dependencies) {
+        await installFeatureDependency(dependency, context);
+    }
+}
+/**
+ * Install a single feature dependency with section-delimited output
+ */
+async function installFeatureDependency(featureName, context) {
+    const logger = context.logger;
+    // Resolve feature name to package name
+    const feature = getFeatureMetadata(featureName);
+    const packageName = feature?.package ?? featureName;
+    const displayName = feature ? featureName : packageName;
+    // Check if already installed
+    if (context.installedFeatures.has(packageName)) {
+        logger.debug(`Feature dependency already installed: ${packageName}`);
+        return;
+    }
+    // Step 1: Install the package (before opening section, so npm output is suppressed)
+    if (!isPackageInstalled(packageName, context.webappDir)) {
+        await installPackage(packageName, true, context.webappDir, context.dryRun, context.verbose);
+    }
+    else {
+        logger.debug(`Package already in node_modules: ${packageName}`);
+    }
+    // Mark as installed to prevent duplicate processing
+    context.installedFeatures.add(packageName);
+    if (context.dryRun) {
+        logger.info(`[DRY RUN] Would process feature dependency schema: ${packageName}`);
+        return;
+    }
+    // Step 2: Load its schema
+    const schema = loadSchemaFromNodeModules(packageName, context.webappDir, context.logger);
+    if (!schema) {
+        logger.warn(`No features.json found for dependency: ${packageName}`);
+        return;
+    }
+    logger.debug(`Processing schema for dependency: ${packageName}`);
+    // Step 3: Install sub-dependencies first (they get their own sections)
+    if (schema.featureDependencies && schema.featureDependencies.length > 0) {
+        await resolveFeatureDependencies(schema.featureDependencies, context);
+    }
+    // Step 4: Open section for THIS dependency
+    logger.section(`Installing dependency: ${displayName}`);
+    logger.plain(`Installing package: ${packageName}`);
+    // Step 5: Install package dependencies (inside section)
+    if (schema.packageDependencies || schema.packageDevDependencies) {
+        logger.blank();
+        await installPackageDependencies(schema, context);
+    }
+    // Step 6: Execute copy operations (inside section)
+    if (schema.copy && schema.copy.length > 0) {
+        logger.blank();
+        await executeCopyOperations(schema.copy, packageName, context);
+    }
+    logger.sectionEnd(`Dependency installed: ${displayName}`);
+}
+/**
+ * Process the "own" operations for a feature (package deps + copies),
+ * excluding recursive feature dependency resolution.
+ * Used by install-feature.ts for the main feature's section.
+ */
+export async function processFeatureOwnOperations(schema, packageName, context) {
+    const logger = context.logger;
+    // Install packageDependencies
+    if (schema.packageDependencies || schema.packageDevDependencies) {
+        logger.blank();
+        await installPackageDependencies(schema, context);
+    }
+    // Execute copy operations
+    if (schema.copy && schema.copy.length > 0) {
+        logger.blank();
+        await executeCopyOperations(schema.copy, packageName, context);
+    }
+}
+//# sourceMappingURL=dependency-resolver.js.map

package/dist/dependency-resolver.js.map

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

package/dist/feature-metadata.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { FeatureMetadata } from "./types.js";
+/**
+ * Get all available features
+ */
+export declare function getAllFeatures(): Record<string, FeatureMetadata>;
+/**
+ * Resolve a feature name to its canonical (registry) key, matching case-insensitively.
+ * Returns the canonical key or null if no match is found.
+ */
+export declare function resolveFeatureName(featureName: string): string | null;
+/**
+ * Get metadata for a specific feature (case-insensitive).
+ */
+export declare function getFeatureMetadata(featureName: string): FeatureMetadata | null;
+/**
+ * Suggest similar feature names for a given input.
+ * Uses prefix matching and Levenshtein distance.
+ * Returns up to `max` suggestions sorted by relevance.
+ */
+export declare function suggestSimilarFeatures(input: string, max?: number): string[];
+export { searchFeatures } from "./feature-search.js";
+/**
+ * Get feature name from package name
+ */
+export declare function getFeatureNameFromPackage(packageName: string): string | null;
+/**
+ * Check if a feature has complete schema information
+ */
+export declare function isFeatureReady(featureName: string): boolean;
+//# sourceMappingURL=feature-metadata.d.ts.map

package/dist/feature-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-metadata.d.ts","sourceRoot":"","sources":["../src/feature-metadata.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,YAAY,CAAC;AA0BpE;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAGhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAK9E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,EAAE,CA0BvE;AA0BD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAM3D"}