@trokky/trokky 2.0.3

package/dist/core/fields/conditional.js

@@ -0,0 +1,296 @@
+/**
+ * Conditional logic evaluation error
+ */
+export class ConditionalEvaluationError extends Error {
+    expression;
+    constructor(message, expression) {
+        super(message);
+        this.expression = expression;
+        this.name = 'ConditionalEvaluationError';
+    }
+}
+/**
+ * Evaluates conditional expressions for field logic
+ */
+export class ConditionalEvaluator {
+    /**
+     * Evaluate a conditional expression against a field context
+     */
+    static evaluate(expression, context) {
+        try {
+            return this.evaluateExpression(expression, context);
+        }
+        catch (error) {
+            throw new ConditionalEvaluationError(`Failed to evaluate conditional expression: ${error instanceof Error ? error.message : String(error)}`, expression);
+        }
+    }
+    /**
+     * Internal expression evaluation
+     */
+    static evaluateExpression(expression, context) {
+        // Handle logical operators first
+        if (expression.and) {
+            return expression.and.every(exp => this.evaluateExpression(exp, context));
+        }
+        if (expression.or) {
+            return expression.or.some(exp => this.evaluateExpression(exp, context));
+        }
+        if (expression.not) {
+            return !this.evaluateExpression(expression.not, context);
+        }
+        // Handle field-based conditions
+        const fieldValue = context.getValue(expression.field);
+        const operator = expression.operator || 'equals';
+        switch (operator) {
+            case 'equals':
+                return this.equals(fieldValue, expression.value);
+            case 'notEquals':
+                return !this.equals(fieldValue, expression.value);
+            case 'in':
+                return this.isIn(fieldValue, expression.values);
+            case 'notIn':
+                return !this.isIn(fieldValue, expression.values);
+            case 'exists':
+                return this.exists(fieldValue);
+            case 'empty':
+                return this.isEmpty(fieldValue);
+            case 'gt':
+                return this.greaterThan(fieldValue, expression.value);
+            case 'lt':
+                return this.lessThan(fieldValue, expression.value);
+            case 'gte':
+                return this.greaterThanOrEqual(fieldValue, expression.value);
+            case 'lte':
+                return this.lessThanOrEqual(fieldValue, expression.value);
+            default:
+                throw new Error(`Unknown conditional operator: ${operator}`);
+        }
+    }
+    /**
+     * Check equality with type coercion
+     */
+    static equals(fieldValue, expectedValue) {
+        // Handle null/undefined
+        if (fieldValue == null && expectedValue == null)
+            return true;
+        if (fieldValue == null || expectedValue == null)
+            return false;
+        // Handle arrays
+        if (Array.isArray(fieldValue) && Array.isArray(expectedValue)) {
+            return fieldValue.length === expectedValue.length &&
+                fieldValue.every((val, index) => this.equals(val, expectedValue[index]));
+        }
+        // Handle objects
+        if (typeof fieldValue === 'object' && typeof expectedValue === 'object') {
+            const fieldKeys = Object.keys(fieldValue);
+            const expectedKeys = Object.keys(expectedValue);
+            return fieldKeys.length === expectedKeys.length &&
+                fieldKeys.every(key => this.equals(fieldValue[key], expectedValue[key]));
+        }
+        // Handle primitives
+        return fieldValue === expectedValue;
+    }
+    /**
+     * Check if value is in array
+     */
+    static isIn(fieldValue, values = []) {
+        return values.some(value => this.equals(fieldValue, value));
+    }
+    /**
+     * Check if value exists (not null or undefined)
+     */
+    static exists(fieldValue) {
+        return fieldValue != null;
+    }
+    /**
+     * Check if value is empty
+     */
+    static isEmpty(fieldValue) {
+        if (fieldValue == null)
+            return true;
+        if (typeof fieldValue === 'string')
+            return fieldValue.trim() === '';
+        if (Array.isArray(fieldValue))
+            return fieldValue.length === 0;
+        if (typeof fieldValue === 'object')
+            return Object.keys(fieldValue).length === 0;
+        return false;
+    }
+    /**
+     * Numeric comparison: greater than
+     */
+    static greaterThan(fieldValue, compareValue) {
+        const fieldNum = this.toNumber(fieldValue);
+        const compareNum = this.toNumber(compareValue);
+        return fieldNum != null && compareNum != null && fieldNum > compareNum;
+    }
+    /**
+     * Numeric comparison: less than
+     */
+    static lessThan(fieldValue, compareValue) {
+        const fieldNum = this.toNumber(fieldValue);
+        const compareNum = this.toNumber(compareValue);
+        return fieldNum != null && compareNum != null && fieldNum < compareNum;
+    }
+    /**
+     * Numeric comparison: greater than or equal
+     */
+    static greaterThanOrEqual(fieldValue, compareValue) {
+        const fieldNum = this.toNumber(fieldValue);
+        const compareNum = this.toNumber(compareValue);
+        return fieldNum != null && compareNum != null && fieldNum >= compareNum;
+    }
+    /**
+     * Numeric comparison: less than or equal
+     */
+    static lessThanOrEqual(fieldValue, compareValue) {
+        const fieldNum = this.toNumber(fieldValue);
+        const compareNum = this.toNumber(compareValue);
+        return fieldNum != null && compareNum != null && fieldNum <= compareNum;
+    }
+    /**
+     * Convert value to number for numeric comparisons
+     */
+    static toNumber(value) {
+        if (typeof value === 'number')
+            return value;
+        if (typeof value === 'string') {
+            const num = parseFloat(value);
+            return isNaN(num) ? null : num;
+        }
+        if (value instanceof Date)
+            return value.getTime();
+        return null;
+    }
+}
+/**
+ * Utility functions for working with conditional expressions
+ */
+export class ConditionalUtils {
+    /**
+     * Create a simple equals condition
+     */
+    static equals(field, value) {
+        return { field, operator: 'equals', value };
+    }
+    /**
+     * Create a simple not equals condition
+     */
+    static notEquals(field, value) {
+        return { field, operator: 'notEquals', value };
+    }
+    /**
+     * Create an 'in' condition
+     */
+    static isIn(field, values) {
+        return { field, operator: 'in', values };
+    }
+    /**
+     * Create an 'exists' condition
+     */
+    static exists(field) {
+        return { field, operator: 'exists' };
+    }
+    /**
+     * Create an 'empty' condition
+     */
+    static empty(field) {
+        return { field, operator: 'empty' };
+    }
+    /**
+     * Create an AND condition
+     */
+    static and(...expressions) {
+        return { field: '', and: expressions };
+    }
+    /**
+     * Create an OR condition
+     */
+    static or(...expressions) {
+        return { field: '', or: expressions };
+    }
+    /**
+     * Create a NOT condition
+     */
+    static not(expression) {
+        return { field: '', not: expression };
+    }
+    /**
+     * Create a greater than condition
+     */
+    static gt(field, value) {
+        return { field, operator: 'gt', value };
+    }
+    /**
+     * Create a less than condition
+     */
+    static lt(field, value) {
+        return { field, operator: 'lt', value };
+    }
+    /**
+     * Create a greater than or equal condition
+     */
+    static gte(field, value) {
+        return { field, operator: 'gte', value };
+    }
+    /**
+     * Create a less than or equal condition
+     */
+    static lte(field, value) {
+        return { field, operator: 'lte', value };
+    }
+    /**
+     * Validate a conditional expression structure
+     */
+    static validate(expression) {
+        const errors = [];
+        // Check for logical operators
+        if (expression.and || expression.or || expression.not) {
+            if (expression.and) {
+                if (!Array.isArray(expression.and) || expression.and.length === 0) {
+                    errors.push('AND condition must have at least one expression');
+                }
+                else {
+                    expression.and.forEach((exp, index) => {
+                        const subErrors = this.validate(exp);
+                        errors.push(...subErrors.map(err => `AND[${index}]: ${err}`));
+                    });
+                }
+            }
+            if (expression.or) {
+                if (!Array.isArray(expression.or) || expression.or.length === 0) {
+                    errors.push('OR condition must have at least one expression');
+                }
+                else {
+                    expression.or.forEach((exp, index) => {
+                        const subErrors = this.validate(exp);
+                        errors.push(...subErrors.map(err => `OR[${index}]: ${err}`));
+                    });
+                }
+            }
+            if (expression.not) {
+                const subErrors = this.validate(expression.not);
+                errors.push(...subErrors.map(err => `NOT: ${err}`));
+            }
+        }
+        else {
+            // Field-based condition
+            if (!expression.field || typeof expression.field !== 'string') {
+                errors.push('Field name is required and must be a string');
+            }
+            const operator = expression.operator || 'equals';
+            const requiresValue = ['equals', 'notEquals', 'gt', 'lt', 'gte', 'lte'];
+            const requiresValues = ['in', 'notIn'];
+            if (requiresValue.includes(operator) && expression.value === undefined) {
+                errors.push(`Operator '${operator}' requires a value`);
+            }
+            if (requiresValues.includes(operator)) {
+                if (!Array.isArray(expression.values) || expression.values.length === 0) {
+                    errors.push(`Operator '${operator}' requires a non-empty values array`);
+                }
+            }
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=conditional.js.map

package/dist/core/fields/conditional.js.map

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

package/dist/core/fields/field-type.d.ts

@@ -0,0 +1,218 @@
+import type { User, Permission, UserRole } from '../types/user.js';
+import type { ValidationResult } from '../types/index.js';
+/**
+ * Field categories for organizing field types in the Studio
+ */
+export declare enum FieldCategory {
+    TEXT = "text",
+    NUMBER = "number",
+    DATE = "date",
+    BOOLEAN = "boolean",
+    MEDIA = "media",
+    REFERENCE = "reference",
+    STRUCTURE = "structure",
+    SPECIALIZED = "specialized",
+    EXTERNAL = "external",
+    CUSTOM = "custom"
+}
+/**
+ * Context provided to field types for validation, rendering, and conditional logic
+ */
+export interface FieldContext {
+    document: Record<string, any>;
+    parentPath?: string[];
+    fieldPath: string[];
+    user: User;
+    permissions: Permission[];
+    userRole: UserRole;
+    httpClient: HttpClient;
+    apiClient: ApiClient;
+    getValue(path: string): any;
+    setValue(path: string, value: any): void;
+    getFieldConfig(path: string): FieldDefinition | undefined;
+    errors: ValidationError[];
+    touched: Record<string, boolean>;
+    isStudio: boolean;
+    isPreview: boolean;
+    studioConfig?: Record<string, any>;
+    emit(event: FieldEvent): void;
+    on(event: string, handler: Function): void;
+}
+/**
+ * HTTP client interface for external API access
+ */
+export interface HttpClient {
+    get<T>(url: string, config?: RequestConfig): Promise<T>;
+    post<T>(url: string, data?: any, config?: RequestConfig): Promise<T>;
+    put<T>(url: string, data?: any, config?: RequestConfig): Promise<T>;
+    delete<T>(url: string, config?: RequestConfig): Promise<T>;
+}
+/**
+ * API client interface for Trokky operations
+ */
+export interface ApiClient {
+    checkUnique(fieldPath: string, value: any): Promise<boolean>;
+    search(collection: string, query: string): Promise<any[]>;
+    upload(file: File): Promise<{
+        id: string;
+        url: string;
+    }>;
+}
+/**
+ * Request configuration for HTTP client
+ */
+export interface RequestConfig {
+    headers?: Record<string, string>;
+    timeout?: number;
+    params?: Record<string, any>;
+}
+/**
+ * Validation error structure
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+    code?: string;
+}
+/**
+ * Field event for the event system
+ */
+export interface FieldEvent {
+    type: string;
+    field: string;
+    data?: any;
+}
+/**
+ * Conditional expression for field logic
+ */
+export interface ConditionalExpression {
+    field: string;
+    operator?: 'equals' | 'notEquals' | 'in' | 'notIn' | 'exists' | 'empty' | 'gt' | 'lt' | 'gte' | 'lte';
+    value?: any;
+    values?: any[];
+    and?: ConditionalExpression[];
+    or?: ConditionalExpression[];
+    not?: ConditionalExpression;
+}
+/**
+ * Validation rule definition
+ */
+export interface ValidationRule {
+    rule: string;
+    value?: any;
+    message?: string;
+    async?: boolean;
+    dependsOn?: string[];
+    validate?: (value: any, context: FieldContext) => boolean | Promise<boolean>;
+}
+/**
+ * Field definition interface used in schemas
+ */
+export interface FieldDefinition<TConfig = any> {
+    name: string;
+    type: string;
+    title?: string;
+    description?: string;
+    required?: boolean | ((context: FieldContext) => boolean | Promise<boolean>);
+    readOnly?: boolean | ((context: FieldContext) => boolean | Promise<boolean>);
+    hidden?: boolean | ((context: FieldContext) => boolean | Promise<boolean>);
+    disabled?: boolean | ((context: FieldContext) => boolean | Promise<boolean>);
+    config?: TConfig;
+    validation?: ValidationRule[];
+    placeholder?: string;
+    helpText?: string;
+    group?: string;
+    showIf?: ConditionalExpression;
+    hideIf?: ConditionalExpression;
+    requiredIf?: ConditionalExpression;
+    defaultValue?: any | ((context: FieldContext) => any);
+    dependsOn?: string[];
+    affects?: string[];
+}
+/**
+ * React component type for field components
+ */
+export interface ReactComponentType<P = {}> {
+    (props: P): any;
+}
+/**
+ * Props passed to field components in the Studio
+ */
+export interface FieldProps<TConfig = any, TValue = any> {
+    field: FieldDefinition<TConfig>;
+    value: TValue;
+    onChange: (value: TValue) => void;
+    context: FieldContext;
+    readOnly?: boolean;
+    disabled?: boolean;
+    error?: string;
+}
+/**
+ * Props for field preview components
+ */
+export interface PreviewProps<TValue = any> {
+    value: TValue;
+    config?: any;
+    compact?: boolean;
+}
+/**
+ * Core field type interface that all field types must implement
+ */
+export interface FieldType<TConfig = any, TValue = any> {
+    name: string;
+    category?: FieldCategory;
+    validate(value: TValue, config: TConfig, context: FieldContext): ValidationResult | Promise<ValidationResult>;
+    serialize(value: TValue, config: TConfig): any;
+    deserialize(data: any, config: TConfig): TValue;
+    defaultValue?: TValue | ((config: TConfig, context: FieldContext) => TValue | Promise<TValue>);
+    component?: ReactComponentType<FieldProps<TConfig, TValue>>;
+    preview?: ReactComponentType<PreviewProps<TValue>>;
+    hidden?(config: TConfig, context: FieldContext): boolean | Promise<boolean>;
+    readOnly?(config: TConfig, context: FieldContext): boolean | Promise<boolean>;
+    disabled?(config: TConfig, context: FieldContext): boolean | Promise<boolean>;
+    description?: string;
+    icon?: string;
+    examples?: Array<{
+        title: string;
+        config: TConfig;
+        value: TValue;
+    }>;
+}
+/**
+ * Migration configuration for field types
+ */
+export interface FieldMigration {
+    from: string;
+    to: string;
+    transform: (value: any, context: MigrationContext) => any;
+}
+/**
+ * Context for field migrations
+ */
+export interface MigrationContext {
+    document: Record<string, any>;
+    fieldPath: string[];
+    version: {
+        from: string;
+        to: string;
+    };
+}
+/**
+ * Field type registration options
+ */
+export interface FieldTypeRegistrationOptions {
+    override?: boolean;
+    migrations?: FieldMigration[];
+}
+/**
+ * Field type metadata
+ */
+export interface FieldTypeMetadata {
+    name: string;
+    category: FieldCategory;
+    description?: string;
+    icon?: string;
+    version: string;
+    migrations: FieldMigration[];
+}
+//# sourceMappingURL=field-type.d.ts.map

package/dist/core/fields/field-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-type.d.ts","sourceRoot":"","sources":["../../../src/core/fields/field-type.ts"],"names":[],"mappings":"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"}

package/dist/core/fields/field-type.js

@@ -0,0 +1,17 @@
+/**
+ * Field categories for organizing field types in the Studio
+ */
+export var FieldCategory;
+(function (FieldCategory) {
+    FieldCategory["TEXT"] = "text";
+    FieldCategory["NUMBER"] = "number";
+    FieldCategory["DATE"] = "date";
+    FieldCategory["BOOLEAN"] = "boolean";
+    FieldCategory["MEDIA"] = "media";
+    FieldCategory["REFERENCE"] = "reference";
+    FieldCategory["STRUCTURE"] = "structure";
+    FieldCategory["SPECIALIZED"] = "specialized";
+    FieldCategory["EXTERNAL"] = "external";
+    FieldCategory["CUSTOM"] = "custom";
+})(FieldCategory || (FieldCategory = {}));
+//# sourceMappingURL=field-type.js.map

package/dist/core/fields/field-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-type.js","sourceRoot":"","sources":["../../../src/core/fields/field-type.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAN,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,8BAAa,CAAA;IACb,oCAAmB,CAAA;IACnB,gCAAe,CAAA;IACf,wCAAuB,CAAA;IACvB,wCAAuB,CAAA;IACvB,4CAA2B,CAAA;IAC3B,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;AACnB,CAAC,EAXW,aAAa,KAAb,aAAa,QAWxB"}

package/dist/core/fields/helpers.d.ts

@@ -0,0 +1,86 @@
+import { FieldDefinition, FieldContext } from './field-type.js';
+/**
+ * Helper function to define a field with TypeScript support
+ */
+export declare function defineField<T = any>(definition: FieldDefinition<T>): FieldDefinition<T>;
+/**
+ * Helper function to define a document type with fields
+ */
+export declare function defineType(definition: {
+    name: string;
+    type: 'document' | 'singleton';
+    title?: string;
+    description?: string;
+    fields: Record<string, FieldDefinition>;
+    [key: string]: any;
+}): {
+    fields: {
+        [k: string]: FieldDefinition<any>;
+    };
+    name: string;
+    type: "document" | "singleton";
+    title?: string;
+    description?: string;
+};
+/**
+ * Utility class for field configuration helpers
+ */
+export declare class FieldUtils {
+    /**
+     * Evaluate if a field should be hidden based on conditional logic
+     */
+    static isHidden(field: FieldDefinition, context: FieldContext): Promise<boolean>;
+    /**
+     * Evaluate if a field should be read-only
+     */
+    static isReadOnly(field: FieldDefinition, context: FieldContext): Promise<boolean>;
+    /**
+     * Evaluate if a field should be disabled
+     */
+    static isDisabled(field: FieldDefinition, context: FieldContext): Promise<boolean>;
+    /**
+     * Evaluate if a field is required
+     */
+    static isRequired(field: FieldDefinition, context: FieldContext): Promise<boolean>;
+    /**
+     * Get the default value for a field
+     */
+    static getDefaultValue(field: FieldDefinition, context: FieldContext): Promise<any>;
+    /**
+     * Check if a field has conditional logic
+     */
+    static hasConditionalLogic(field: FieldDefinition): boolean;
+    /**
+     * Get all field dependencies for conditional logic
+     */
+    static getFieldDependencies(field: FieldDefinition): string[];
+    /**
+     * Extract field dependencies from conditional expressions
+     */
+    private static extractConditionalDependencies;
+    /**
+     * Create a field context for testing/validation
+     */
+    static createMockContext(overrides?: Partial<FieldContext>): FieldContext;
+}
+/**
+ * Validation rule builder (Sanity-style)
+ */
+export declare class Rule {
+    private rules;
+    required(message?: string): this;
+    min(value: number, message?: string): this;
+    max(value: number, message?: string): this;
+    length(value: number, message?: string): this;
+    email(message?: string): this;
+    url(message?: string): this;
+    pattern(regex: RegExp, message?: string): this;
+    custom(validate: (value: any, context: FieldContext) => boolean | Promise<boolean>, message?: string): this;
+    unique(message?: string): this;
+    getRules(): any[];
+}
+/**
+ * Create a validation rule builder instance
+ */
+export declare function rule(): Rule;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/core/fields/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/core/fields/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAyB,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGtF;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CASvF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,GAAG,WAAW,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;;;;UANO,MAAM;UACN,UAAU,GAAG,WAAW;YACtB,MAAM;kBACA,MAAM;EAarB;AAaD;;GAEG;AACH,qBAAa,UAAU;IACrB;;OAEG;WACU,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBtF;;OAEG;WACU,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAYxF;;OAEG;WACU,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAYxF;;OAEG;WACU,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBxF;;OAEG;WACU,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAQzF;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IAY3D;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE;IAwB7D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IAqB7C;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY;CA0C9E;AAED;;GAEG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,KAAK,CAAY;IAEzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM;IAKzB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAKnC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAKnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAKtC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM;IAKtB,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM;IAKpB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAKvC,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM;IAKpG,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM;IAKvB,QAAQ;CAGT;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAE3B"}