@autobe/agent 0.18.0 → 0.20.0

package/lib/agent/src/orchestrate/interface/orchestrateInterfaceSchemasReview.js.map

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

package/lib/agent/src/orchestrate/interface/structures/IAutoBeInterfaceComplementApplication.d.ts

@@ -17,6 +17,44 @@ export interface IAutoBeInterfaceComplementApplication {
 }
 export declare namespace IAutoBeInterfaceComplementApplication {
     interface IProps {
+        /**
+         * TypeScript draft code for complement schema definitions.
+         *
+         * This property contains TypeScript interface definitions for missing schema
+         * types that were referenced but not defined in the initial schema generation.
+         * Similar to the main schema draft, this serves as a preliminary TypeScript
+         * representation before converting to JSON Schema format.
+         *
+         * The draft helps ensure that complementary schemas maintain consistency with
+         * the existing type system and follow the same conventions as the primary schemas.
+         *
+         * This draft typically includes:
+         * - Missing entity interfaces referenced via $ref
+         * - Nested object types used within other schemas
+         * - Shared utility types or enumerations
+         * - Any transitively referenced types
+         *
+         * The final schemas in the `schemas` property should be validated against and
+         * derived from this TypeScript draft to ensure type safety and consistency
+         * across the entire API specification.
+         *
+         * Example complement draft:
+         * ```typescript
+         * interface IUserProfile {
+         *   id: string;
+         *   userId: string;
+         *   displayName: string;
+         *   avatarUrl?: string;
+         * }
+         *
+         * interface IAddress {
+         *   street: string;
+         *   city: string;
+         *   postalCode: string;
+         * }
+         * ```
+         */
+        draft: string;
         /**
          * A collection of missing schema definitions that need to be added to the
          * OpenAPI document's `components.schemas` section.

package/lib/agent/src/orchestrate/interface/structures/IAutoBeInterfaceGroupApplication.d.ts

@@ -4,10 +4,10 @@ export interface IAutoBeInterfaceGroupApplication {
      * Generate logical groups for organizing API endpoint creation based on
      * Prisma schema structure.
      *
-     * Groups MUST be derived from Prisma schema organization (namespaces, file
-     * structure, table prefixes) rather than arbitrary business domains. Only
-     * create new groups when existing schema structure cannot adequately cover
-     * all requirements.
+     * DO: Derive groups from Prisma schema organization (namespaces, file
+     * structure, table prefixes) rather than arbitrary business domains.
+     * DO: Create new groups only when existing schema structure cannot adequately
+     * cover all requirements.
      *
      * @param props Properties containing the groups to be created for API
      *   organization
@@ -19,8 +19,8 @@ export declare namespace IAutoBeInterfaceGroupApplication {
         /**
          * Array of API endpoint groups for organizing development.
          *
-         * Groups MUST be organized around existing Prisma schema structure and
-         * provide complete coverage of all entities and requirements without
+         * DO: Organize groups around existing Prisma schema structure.
+         * DO: Provide complete coverage of all entities and requirements without
          * overlap.
          */
         groups: IGroup[] & tags.MinItems<1>;
@@ -31,10 +31,11 @@ export declare namespace IAutoBeInterfaceGroupApplication {
      *
      * **SCHEMA-BASED GROUP REQUIREMENTS:**
      *
-     * Groups MUST be derived from the Prisma schema structure rather than
-     * arbitrary business domain names. This ensures consistency with the
-     * underlying data model and prevents misalignment between API organization
-     * and database structure.
+     * DO: Derive groups from the Prisma schema structure rather than arbitrary
+     * business domain names.
+     *
+     * This ensures consistency with the underlying data model and prevents
+     * misalignment between API organization and database structure.
      *
      * **Primary Group Sources (in order of priority):**
      *
@@ -48,12 +49,11 @@ export declare namespace IAutoBeInterfaceGroupApplication {
      *
      * **Group Creation Guidelines:**
      *
-     * - Each group must cover specific Prisma schema entities without overlap
+     * - Each group covers specific Prisma schema entities without overlap
      * - Size groups appropriately for manageable endpoint generation cycles
      * - Maintain clear boundaries based on schema organization
      * - Ensure complete coverage of all database entities and requirements
-     * - Related database tables within the same schema area should be grouped
-     *   together
+     * - Related database tables within the same schema area are grouped together
      *
      * **When to Create Schema-Independent Groups:**
      *
@@ -68,14 +68,14 @@ export declare namespace IAutoBeInterfaceGroupApplication {
      * **Naming Standards:**
      *
      * - Use PascalCase format (e.g., "Shopping", "BBS", "UserManagement")
-     * - Names MUST directly reflect Prisma schema structure
+     * - Names directly reflect Prisma schema structure
      * - Keep names concise and schema-derived
      * - Avoid arbitrary business domain names
      * - Maintain consistency with schema organization
      *
      * **Quality Requirements:**
      *
-     * - Groups collectively must cover ALL entities and requirements
+     * - Groups collectively cover ALL entities and requirements
      * - Each database entity belongs to exactly one group
      * - Clear mapping to specific Prisma schema elements
      * - Balance group sizes within schema constraints
@@ -85,7 +85,7 @@ export declare namespace IAutoBeInterfaceGroupApplication {
         /**
          * Unique identifier name derived from Prisma schema structure.
          *
-         * Must correspond to schema namespaces, file names, table prefixes, or
+         * DO: Correspond to schema namespaces, file names, table prefixes, or
          * organizational annotations rather than arbitrary business domain names.
          */
         name: string & tags.MinLength<1>;

package/lib/agent/src/orchestrate/interface/structures/IAutoBeInterfaceOperationApplication.d.ts

@@ -22,7 +22,7 @@ export declare namespace IAutoBeInterfaceOperationApplication {
         /**
          * Array of API operations to generate.
          *
-         * Each operation in this array must include:
+         * Each operation in this array includes:
          *
          * - Specification: Detailed API specification with clear purpose and
          *   functionality
@@ -37,7 +37,7 @@ export declare namespace IAutoBeInterfaceOperationApplication {
          *   components.schemas
          * - ResponseBody: With typeName referencing appropriate response type
          *
-         * All operations must follow strict quality standards:
+         * All operations follow strict quality standards:
          *
          * 1. Detailed descriptions referencing Prisma schema comments
          * 2. Accurate parameter definitions matching path parameters
@@ -64,11 +64,10 @@ export declare namespace IAutoBeInterfaceOperationApplication {
      * reason and description fields, making it clear why the API was designed and
      * how it should be used.
      *
-     * All request bodies and responses for this operation must be object types
-     * and must reference named types defined in the components section. The
-     * content-type is always `application/json`. For file upload/download
-     * operations, use `string & tags.Format<"uri">` in the appropriate schema
-     * instead of binary data formats.
+     * DO: Use object types for all request bodies and responses. DO: Reference
+     * named types defined in the components section. DO: Use `application/json`
+     * as the content-type. DO: Use `string & tags.Format<"uri">` in the schema
+     * for file upload/download operations instead of binary data formats.
      *
      * In OpenAPI, this might represent:
      *
@@ -85,7 +84,45 @@ export declare namespace IAutoBeInterfaceOperationApplication {
      * }
      * ```
      */
-    interface IOperation extends Omit<AutoBeOpenApi.IOperation, "authorizationRole"> {
+    interface IOperation extends Omit<AutoBeOpenApi.IOperation, "authorizationRole" | "authorizationType"> {
+        /**
+         * Prisma schema models relevant to this operation.
+         *
+         * Contains the complete Prisma schema definitions for all entities involved
+         * in this operation, including their fields, relations, and database
+         * constraints. This enables comprehensive validation and schema-aware
+         * operation design.
+         *
+         * The schema information serves multiple critical purposes:
+         *
+         * - **Field Verification**: Ensures all referenced fields actually exist in
+         *   the database schema and have the correct types
+         * - **Relationship Validation**: Confirms that entity relationships are
+         *   properly defined and can support the operation's data access patterns
+         * - **Soft-Delete Detection**: For DELETE operations, identifies whether
+         *   entities have soft-delete fields (deleted_at, is_deleted, etc.) to
+         *   determine if the operation should perform logical deletion instead of
+         *   physical removal
+         * - **Constraint Awareness**: Understands unique constraints, required
+         *   fields, and default values to generate accurate request/response
+         *   schemas
+         *
+         * Example content might include:
+         *
+         * ```prisma
+         * model User {
+         *   id         String    @id @default(uuid())
+         *   email      String    @unique
+         *   name       String
+         *   deleted_at DateTime? // Indicates soft-delete capability
+         *   posts      Post[]
+         * }
+         * ```
+         *
+         * This schema context ensures operations are fully aligned with the actual
+         * database structure and business logic requirements.
+         */
+        prisma_schemas: string;
         /**
          * Authorization roles required to access this API operation.
          *
@@ -93,16 +130,47 @@ export declare namespace IAutoBeInterfaceOperationApplication {
          * endpoint. Multiple roles can be specified to allow different types of
          * users to access the same endpoint.
          *
+         * ## ⚠️ CRITICAL: Role Multiplication Effect
+         *
+         * **EACH ROLE IN THIS ARRAY GENERATES A SEPARATE ENDPOINT**
+         *
+         * - If you specify `["admin", "moderator", "member"]`, this creates 3
+         *   separate endpoints
+         * - Total generated endpoints = operations × average roles.length
+         * - Example: 100 operations with 3 roles each = 300 actual endpoints
+         *
+         * ## 🔴 AVOID OVER-GENERATION
+         *
+         * **DO NOT create role-specific endpoints when a public endpoint would
+         * suffice:**
+         *
+         * - ❌ BAD: Separate GET endpoints for admin, member, moderator to view the
+         *   same public data
+         * - ✅ GOOD: Single public endpoint `[]` with role-based filtering in business
+         *   logic
+         *
+         * **DO NOT enumerate all possible roles when the Prisma schema uses a
+         * single User table:**
+         *
+         * - If Prisma has a User table with role/permission fields, you likely only
+         *   need `["user"]`
+         * - Avoid listing `["admin", "seller", "buyer", "moderator", ...]`
+         *   unnecessarily
+         * - The actual role checking happens in business logic, not at the endpoint
+         *   level
+         *
          * ## Naming Convention
          *
-         * All role names MUST use camelCase.
+         * DO: Use camelCase for all role names.
          *
          * ## Important Guidelines
          *
          * - Set to empty array `[]` for public endpoints that require no
          *   authentication
          * - Set to array with role strings for role-restricted endpoints
-         * - The role names MUST match exactly with the user type/role defined in the
+         * - **MINIMIZE the number of roles per endpoint to prevent explosion**
+         * - Consider if the endpoint can be public with role-based filtering instead
+         * - The role names match exactly with the user type/role defined in the
          *   database
          * - This will be used by the Realize Agent to generate appropriate decorator
          *   and authorization logic in the provider functions
@@ -111,11 +179,26 @@ export declare namespace IAutoBeInterfaceOperationApplication {
          *
          * ## Examples
          *
-         * - `[]` - Public endpoint, no authentication required
-         * - `["user"]` - Any authenticated user can access
-         * - `["admin"]` - Only admin users can access
+         * - `[]` - Public endpoint, no authentication required (PREFERRED for read
+         *   operations)
+         * - `["user"]` - Any authenticated user can access (PREFERRED for
+         *   user-specific operations)
+         * - `["admin"]` - Only admin users can access (USE SPARINGLY)
          * - `["admin", "moderator"]` - Both admin and moderator users can access
-         * - `["seller"]` - Only seller users can access
+         *   (AVOID if possible)
+         * - `["seller"]` - Only seller users can access (ONLY if Seller is a separate
+         *   table)
+         *
+         * ## Best Practices
+         *
+         * 1. **Start with public `[]` for all read operations** unless sensitive data
+         *    is involved
+         * 2. **Use single role `["user"]` for authenticated operations** and handle
+         *    permissions in business logic
+         * 3. **Only use multiple roles when absolutely necessary** for different
+         *    business logic paths
+         * 4. **Remember: Fewer roles = Fewer endpoints = Better performance and
+         *    maintainability**
          *
          * Note: The actual authentication/authorization implementation will be
          * handled by decorators at the controller level, and the provider function

package/lib/agent/src/orchestrate/interface/structures/IAutoBeInterfaceOperationsReviewApplication.d.ts

@@ -91,6 +91,80 @@ export declare namespace IAutoBeInterfaceOperationsReviewApplication {
          * operations unchanged. These operations are validated and ready for schema
          * generation and subsequent implementation phases.
          */
-        content: AutoBeOpenApi.IOperation[];
+        content: IOperation[];
+    }
+    /**
+     * Operation of the Restful API.
+     *
+     * This interface defines a single API endpoint with its HTTP {@link method},
+     * {@link path}, {@link parameters path parameters},
+     * {@link requestBody request body}, and {@link responseBody} structure. It
+     * corresponds to an individual operation in the paths section of an OpenAPI
+     * document.
+     *
+     * Each operation requires a detailed explanation of its purpose through the
+     * reason and description fields, making it clear why the API was designed and
+     * how it should be used.
+     *
+     * All request bodies and responses for this operation must be object types
+     * and must reference named types defined in the components section. The
+     * content-type is always `application/json`. For file upload/download
+     * operations, use `string & tags.Format<"uri">` in the appropriate schema
+     * instead of binary data formats.
+     *
+     * In OpenAPI, this might represent:
+     *
+     * ```json
+     * {
+     *   "/shoppings/customers/orders": {
+     *     "post": {
+     *       "description": "Create a new order application from shopping cart...",
+     *       "parameters": [...],
+     *       "requestBody": {...},
+     *       "responses": {...}
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    interface IOperation extends Omit<AutoBeOpenApi.IOperation, "authorizationType"> {
+        /**
+         * Prisma schema models relevant to this operation.
+         *
+         * Contains the complete Prisma schema definitions for all entities involved
+         * in this operation, including their fields, relations, and database
+         * constraints. This enables comprehensive validation and schema-aware
+         * operation design.
+         *
+         * The schema information serves multiple critical purposes:
+         *
+         * - **Field Verification**: Ensures all referenced fields actually exist in
+         *   the database schema and have the correct types
+         * - **Relationship Validation**: Confirms that entity relationships are
+         *   properly defined and can support the operation's data access patterns
+         * - **Soft-Delete Detection**: For DELETE operations, identifies whether
+         *   entities have soft-delete fields (deleted_at, is_deleted, etc.) to
+         *   determine if the operation should perform logical deletion instead of
+         *   physical removal
+         * - **Constraint Awareness**: Understands unique constraints, required
+         *   fields, and default values to generate accurate request/response
+         *   schemas
+         *
+         * Example content might include:
+         *
+         * ```prisma
+         * model User {
+         *   id         String    @id @default(uuid())
+         *   email      String    @unique
+         *   name       String
+         *   deleted_at DateTime? // Indicates soft-delete capability
+         *   posts      Post[]
+         * }
+         * ```
+         *
+         * This schema context ensures operations are fully aligned with the actual
+         * database structure and business logic requirements.
+         */
+        prisma_schemas: string;
     }
 }

package/lib/agent/src/orchestrate/interface/structures/IAutoBeInterfaceSchemaApplication.d.ts

@@ -13,10 +13,9 @@ export interface IAutoBeInterfaceSchemaApplication {
      * creation. This ensures that the final OpenAPI document has complete type
      * coverage for all operations.
      *
-     * CRITICAL: All schema definitions must follow the established naming
-     * conventions (IEntityName, IEntityName.ICreate, etc.) and must be thoroughly
-     * documented with descriptions that reference the original Prisma schema
-     * comments.
+     * DO: Follow established naming conventions (IEntityName,
+     * IEntityName.ICreate, etc.) DO: Document thoroughly with descriptions that
+     * reference the original Prisma schema comments.
      *
      * @param props Properties containing components to generate.
      */
@@ -24,6 +23,39 @@ export interface IAutoBeInterfaceSchemaApplication {
 }
 export declare namespace IAutoBeInterfaceSchemaApplication {
     interface IProps {
+        /**
+         * TypeScript draft code for schema definitions.
+         *
+         * This property contains TypeScript interface definitions that serve as a
+         * preliminary draft before generating the final JSON schema components.
+         * The draft allows for initial design and validation of the schema structure
+         * using TypeScript's type system before converting to OpenAPI/JSON Schema format.
+         *
+         * The draft typically includes:
+         * - Entity interfaces matching the Prisma models
+         * - Operation-specific variants (ICreate, IUpdate, etc.)
+         * - Utility types and enumerations
+         * - Type relationships and constraints
+         *
+         * This TypeScript draft serves as the foundation for the subsequent schema
+         * generation, ensuring type safety and consistency. The final schemas in the
+         * `schemas` property should be derived from and validated against this draft.
+         *
+         * Example draft structure:
+         * ```typescript
+         * interface IUser {
+         *   id: string;
+         *   email: string;
+         *   profile: IUserProfile;
+         * }
+         *
+         * namespace IUser {
+         *   interface ICreate extends Omit<IUser, "id"> {}
+         *   interface IUpdate extends Partial<ICreate> {}
+         * }
+         * ```
+         */
+        draft: string;
         /**
          * Complete set of schema components for the OpenAPI specification.
          *
@@ -31,23 +63,23 @@ export declare namespace IAutoBeInterfaceSchemaApplication {
          * the system. It is the central repository of all named schema types that
          * will be used throughout the API specification.
          *
-         * CRITICAL REQUIREMENT: All object types MUST be defined as named types in
-         * the components.schemas section. Inline anonymous object definitions are
-         * strictly prohibited.
+         * DO: Define all object types as named types in the components.schemas
+         * section. DO NOT: Use inline anonymous object definitions.
          *
-         * This components object should include:
+         * This components object includes:
          *
          * - Main entity types (IEntityName)
          * - Operation-specific variants (.ICreate, .IUpdate, .ISummary, etc.)
          * - Container types (IPage<T> for pagination)
          * - Enumeration types
          *
-         * All schema definitions must include detailed descriptions that reference
-         * the original Prisma schema comments and thoroughly document each
-         * property. Every property that references an object must use a $ref to a
-         * named type in the components.schemas section. This applies to all objects
-         * in request bodies, response bodies, and properties that are objects or
-         * arrays of objects.
+         * DO: Include detailed descriptions that reference the original Prisma
+         * schema comments and thoroughly document each property. DO: Use a $ref to
+         * a named type in the components.schemas section for every property that
+         * references an object.
+         *
+         * This applies to all objects in request bodies, response bodies, and
+         * properties that are objects or arrays of objects.
          *
          * Example structure:
          *

package/lib/agent/src/orchestrate/interface/structures/IAutobeInterfaceSchemasReviewApplication.d.ts

@@ -30,19 +30,16 @@ export declare namespace IAutoBeInterfaceSchemasReviewApplication {
         /**
          * Issues and problems found during schema analysis.
          *
-         * IMPORTANT: Only document problems that need fixing. Do NOT include:
-         *
-         * - Positive feedback about what's already correct
-         * - Compliments about well-structured schemas
-         * - Confirmation that certain aspects meet standards
+         * DO: Document only problems that need fixing.
+         * DO NOT: Include positive feedback, compliments, or confirmations
          *
          * Focus exclusively on issues organized by severity:
          *
-         * - CRITICAL: Security vulnerabilities (exposed passwords, missing auth
-         *   boundaries)
-         * - HIGH: Missing required variants, incorrect type mappings
-         * - MEDIUM: Missing format specifications, incomplete relationships
-         * - LOW: Documentation improvements, style consistency
+         * Severity levels:
+         * - Security vulnerabilities (exposed passwords, missing auth boundaries)
+         * - Missing required variants, incorrect type mappings
+         * - Missing format specifications, incomplete relationships
+         * - Documentation improvements, style consistency
          *
          * Each issue must include the specific schema name and what needs to be
          * fixed. If there are no issues at all, simply state: "No issues found."
@@ -66,21 +63,18 @@ export declare namespace IAutoBeInterfaceSchemasReviewApplication {
         /**
          * Final validated and enhanced schemas ready for production use.
          *
-         * CRITICAL REQUIREMENTS:
-         *
-         * - MUST NEVER be an empty object {}
-         * - MUST contain valid OpenAPI schema definitions
-         * - MUST include all entities that were in the original input
-         * - If original schemas have critical issues, MUST contain fixed versions
-         * - If entity names are wrong, MUST contain renamed correct versions
-         * - If schemas are missing variants, MUST include the created variants
-         *
-         * FORBIDDEN:
+         * DO:
+         * - Include valid OpenAPI schema definitions
+         * - Include all entities that were in the original input
+         * - Provide fixed versions if original schemas have issues
+         * - Rename entities correctly if names are wrong
+         * - Include created variants if schemas are missing them
          *
-         * - Empty object {} will cause all schemas to be deleted
-         * - Returning undefined or null
-         * - Including explanations or excuses in schema descriptions
-         * - Leaving broken schemas unfixed
+         * DO NOT:
+         * - Return an empty object {} (this will delete all schemas)
+         * - Return undefined or null
+         * - Include explanations or excuses in schema descriptions
+         * - Leave broken schemas unfixed
          *
          * When original schemas are beyond repair, recreate them properly based on
          * entity names and context. This field becomes the final schemas used by

package/lib/agent/src/orchestrate/interface/utils/validateAuthorizationSchema.d.ts

@@ -0,0 +1,7 @@
+import { AutoBeOpenApi } from "@autobe/interface";
+import { IValidation } from "typia";
+export declare const validateAuthorizationSchema: (props: {
+    errors: IValidation.IError[];
+    schemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>;
+    path: string;
+}) => void;

package/lib/agent/src/orchestrate/interface/utils/validateAuthorizationSchema.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAuthorizationSchema = void 0;
+const validateAuthorizationSchema = (props) => {
+    var _a, _b;
+    for (const [key, value] of Object.entries(props.schemas)) {
+        if (!key.endsWith(".IAuthorized"))
+            continue;
+        // Check if it's an object type
+        if (!isObjectSchema(value)) {
+            props.errors.push({
+                path: `${props.path}.${key}`,
+                expected: `AutoBeOpenApi.IJsonSchemaDescriptive<AutoBeOpenApi.IJsonSchema.IObject>`,
+                value: value,
+                description: `${key} must be an object type for authorization responses`,
+            });
+            continue;
+        }
+        // Check if token property exists
+        (_a = value.properties) !== null && _a !== void 0 ? _a : (value.properties = {});
+        value.properties["token"] = {
+            $ref: "#/components/schemas/IAuthorizationToken",
+            description: "JWT token information for authentication",
+        };
+        (_b = value.required) !== null && _b !== void 0 ? _b : (value.required = []);
+        if (value.required.includes("token") === false) {
+            value.required.push("token");
+        }
+    }
+};
+exports.validateAuthorizationSchema = validateAuthorizationSchema;
+const isObjectSchema = (schema) => {
+    return "type" in schema && schema.type === "object";
+};
+//# sourceMappingURL=validateAuthorizationSchema.js.map

package/lib/agent/src/orchestrate/interface/utils/validateAuthorizationSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAuthorizationSchema.js","sourceRoot":"","sources":["../../../../../../src/orchestrate/interface/utils/validateAuthorizationSchema.ts"],"names":[],"mappings":";;;AAGO,MAAM,2BAA2B,GAAG,CAAC,KAI3C,EAAQ,EAAE;;IACT,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;YAAE,SAAS;QAE5C,+BAA+B;QAC/B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE;gBAC5B,QAAQ,EAAE,yEAAyE;gBACnF,KAAK,EAAE,KAAK;gBACZ,WAAW,EAAE,GAAG,GAAG,qDAAqD;aACzE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,iCAAiC;QACjC,MAAA,KAAK,CAAC,UAAU,oCAAhB,KAAK,CAAC,UAAU,GAAK,EAAE,EAAC;QACxB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG;YAC1B,IAAI,EAAE,0CAA0C;YAChD,WAAW,EAAE,0CAA0C;SACsB,CAAC;QAEhF,MAAA,KAAK,CAAC,QAAQ,oCAAd,KAAK,CAAC,QAAQ,GAAK,EAAE,EAAC;QACtB,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC;YAC/C,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AA/BW,QAAA,2BAA2B,+BA+BtC;AAEF,MAAM,cAAc,GAAG,CACrB,MAA4C,EACuC,EAAE;IACrF,OAAO,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AACtD,CAAC,CAAC"}