@numerum-tech/yeriasdk 1.0.0

package/dist/core/base-view.js

@@ -0,0 +1,426 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseView = void 0;
+const types_1 = require("../types");
+const errors_1 = require("../errors");
+const validators_1 = require("../utils/validators");
+class BaseView {
+    constructor(config) {
+        this.state = {};
+        this.id = config.id;
+        this.type = config.type;
+        this.metadata = config.metadata;
+        // Initialize process context if processId provided
+        if (config.processId) {
+            this.processContext = {
+                processId: config.processId
+            };
+        }
+    }
+    /**
+     * Valide la vue avant de la servir
+     */
+    validate() {
+        const errors = [];
+        const warnings = [];
+        if (!this.id || this.id.trim() === '') {
+            errors.push((0, types_1.createValidationError)('View ID is required'));
+        }
+        if (!this.type) {
+            errors.push((0, types_1.createValidationError)('View type is required'));
+        }
+        if (!this.content) {
+            errors.push((0, types_1.createValidationError)('View content is required'));
+        }
+        // Validation spécifique par type de vue
+        switch (this.type) {
+            case 'Form':
+                if (!this.content ||
+                    !Array.isArray(this.content['fields']) ||
+                    this.content['fields'].length === 0) {
+                    errors.push((0, types_1.createValidationError)('Form must have at least one field'));
+                }
+                else {
+                    // Exclude separator fields from "at least one field" validation
+                    const fields = this.content['fields'];
+                    const nonSeparatorFields = fields.filter((f) => f.fieldType !== 'separator');
+                    if (nonSeparatorFields.length === 0) {
+                        errors.push((0, types_1.createValidationError)('Form must have at least one non-separator field'));
+                    }
+                }
+                break;
+            case 'ActionList':
+            case 'ActionGrid':
+                if (!this.content ||
+                    !Array.isArray(this.content['actions']) ||
+                    this.content['actions'].length === 0) {
+                    errors.push((0, types_1.createValidationError)('Action views must have at least one action'));
+                }
+                break;
+            case 'Reader':
+                if (typeof this.content === 'object' && this.content !== null) {
+                    const readerContent = this.content;
+                    if (!readerContent.title || !readerContent.title.trim()) {
+                        errors.push((0, types_1.createValidationError)('Reader view must have a title'));
+                    }
+                    if (!readerContent.elements || readerContent.elements.length === 0) {
+                        errors.push((0, types_1.createValidationError)('Reader view must contain at least one element'));
+                    }
+                }
+                break;
+            case 'Message':
+                if (typeof this.content === 'object' && this.content !== null) {
+                    const messageContent = this.content;
+                    const hasBody = typeof messageContent.body === 'string' && messageContent.body.trim().length > 0;
+                    const hasIntro = typeof messageContent.intro === 'string' && messageContent.intro.trim().length > 0;
+                    if (!hasBody && !hasIntro) {
+                        errors.push((0, types_1.createValidationError)('Message view must define a body or an intro'));
+                    }
+                    if (!messageContent.confirm) {
+                        errors.push((0, types_1.createValidationError)('Message view must define a primary action'));
+                    }
+                }
+                else {
+                    errors.push((0, types_1.createValidationError)('Message view content is invalid'));
+                }
+                break;
+            case 'Card':
+                if (typeof this.content === 'object' && this.content !== null) {
+                    const card = this.content;
+                    const hasDetail = (typeof card.description === 'string' && card.description.trim().length > 0) ||
+                        (Array.isArray(card.stats) && card.stats.length > 0) ||
+                        (Array.isArray(card.sections) && card.sections.length > 0);
+                    if (!hasDetail) {
+                        errors.push((0, types_1.createValidationError)('Card view requires at least a description, stat, or section'));
+                    }
+                }
+                else {
+                    errors.push((0, types_1.createValidationError)('Card view content is invalid'));
+                }
+                break;
+            case 'Carousel':
+                if (!this.content ||
+                    !Array.isArray(this.content['slides']) ||
+                    this.content['slides'].length === 0) {
+                    errors.push((0, types_1.createValidationError)('Carousel view must contain at least one slide'));
+                }
+                break;
+            case 'Timeline':
+                if (!this.content ||
+                    !Array.isArray(this.content['items']) ||
+                    this.content['items'].length === 0) {
+                    errors.push((0, types_1.createValidationError)('Timeline view must contain at least one entry'));
+                }
+                break;
+            case 'Media':
+                if (!this.content ||
+                    !Array.isArray(this.content['items']) ||
+                    this.content['items'].length === 0) {
+                    errors.push((0, types_1.createValidationError)('Media view must contain at least one resource'));
+                }
+                break;
+            case 'Map': {
+                if (!this.content || typeof this.content !== 'object') {
+                    errors.push((0, types_1.createValidationError)('Map view content is required'));
+                    break;
+                }
+                const mc = this.content;
+                const layers = Array.isArray(mc['layers']) ? mc['layers'] : [];
+                // unique layer ids
+                const seenLayerIds = new Set();
+                for (const l of layers) {
+                    const id = l?.['id'];
+                    if (typeof id !== 'string' || !id.trim()) {
+                        errors.push((0, types_1.createValidationError)('Map layer must have a non-empty id'));
+                    }
+                    else if (seenLayerIds.has(id)) {
+                        errors.push((0, types_1.createValidationError)(`Duplicate map layer id: "${id}"`));
+                    }
+                    else {
+                        seenLayerIds.add(id);
+                    }
+                }
+                const mode = mc['mode'] === 'pick' ? 'pick' : 'view';
+                if (mode === 'pick') {
+                    const pick = mc['pick'];
+                    if (!pick || typeof pick['submitUrl'] !== 'string' || !pick['submitUrl'].trim()) {
+                        errors.push((0, types_1.createValidationError)('Map pick mode requires pick.submitUrl'));
+                    }
+                }
+                else {
+                    // view mode: needs at least one drawable layer OR an emptyMessage
+                    const hasDrawable = layers.some((l) => {
+                        if (l?.['visible'] === false)
+                            return false;
+                        const t = l?.['type'];
+                        if (t === 'markers')
+                            return Array.isArray(l['markers']) && l['markers'].length > 0;
+                        if (t === 'shapes')
+                            return Array.isArray(l['shapes']) && l['shapes'].length > 0;
+                        if (t === 'heatmap')
+                            return Array.isArray(l['points']) && l['points'].length > 0;
+                        if (t === 'tiles')
+                            return typeof l['url'] === 'string';
+                        if (t === 'geojson')
+                            return !!l['data'];
+                        return false;
+                    });
+                    const emptyMsg = mc['emptyMessage'];
+                    const hasEmptyMessage = typeof emptyMsg === 'string' && emptyMsg.trim().length > 0;
+                    if (!hasDrawable && !hasEmptyMessage) {
+                        errors.push((0, types_1.createValidationError)('Map view must contain at least one drawable layer or an emptyMessage'));
+                    }
+                }
+                break;
+            }
+            case 'QRDisplay':
+                if (!this.content ||
+                    !this.content['qrImage'] ||
+                    !this.content['qrTitle'] ||
+                    !this.content['qrDescription']) {
+                    errors.push((0, types_1.createValidationError)('QRDisplay view must have a QR code with image, title, and description'));
+                }
+                break;
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings: warnings.length > 0 ? warnings : undefined
+        };
+    }
+    /**
+     * Sert la vue avec validation
+     */
+    serve() {
+        const validation = this.validate();
+        if (!validation.isValid) {
+            const errorMessages = validation.errors.map(e => e.message);
+            throw new errors_1.ViewValidationError(this.id, this.type, errorMessages);
+        }
+        // Warnings are available in validation result for users to handle
+        const result = {
+            id: this.id,
+            type: this.type,
+            content: this.content,
+        };
+        // Ajouter le contexte de processus si présent (mobile app needs this for URL construction)
+        if (this.processContext) {
+            result['process'] = this.processContext;
+        }
+        // Ajouter les métadonnées si présentes
+        if (this.metadata) {
+            result['metadata'] = this.metadata;
+        }
+        // Ajouter l'état si présent
+        if (Object.keys(this.state).length > 0) {
+            result['state'] = this.state;
+        }
+        // Ajouter la navigation si présente
+        if (this.navigation) {
+            result['nav'] = this.navigation;
+        }
+        return result;
+    }
+    /**
+     * Retourne la représentation JSON de la vue
+     */
+    toJSON() {
+        return this.serve();
+    }
+    /**
+     * Met à jour l'état de la vue
+     */
+    setState(key, value) {
+        this.state[key] = value;
+    }
+    /**
+     * Obtient une valeur de l'état
+     */
+    getState(key) {
+        return this.state[key];
+    }
+    /**
+     * Clone la vue
+     * Uses structuredClone for efficient deep cloning when available, falls back to JSON serialization
+     */
+    clone() {
+        const cloned = Object.create(Object.getPrototypeOf(this));
+        const clonedMetadata = this.metadata
+            ? {
+                ...this.metadata,
+                createdAt: this.metadata.createdAt instanceof Date
+                    ? new Date(this.metadata.createdAt.getTime())
+                    : this.metadata.createdAt
+            }
+            : undefined;
+        // Use structuredClone if available (Node 17+, modern browsers) for better performance
+        // Falls back to JSON serialization for compatibility
+        const cloneContent = typeof structuredClone !== 'undefined'
+            ? structuredClone(this.content)
+            : JSON.parse(JSON.stringify(this.content));
+        const cloneState = typeof structuredClone !== 'undefined'
+            ? structuredClone(this.state)
+            : JSON.parse(JSON.stringify(this.state));
+        Object.assign(cloned, {
+            id: this.id,
+            type: this.type,
+            content: cloneContent,
+            state: cloneState,
+            metadata: clonedMetadata
+        });
+        cloned.navigation = this.navigation ? { ...this.navigation } : undefined;
+        cloned.processContext = this.processContext ? { ...this.processContext } : undefined;
+        return cloned;
+    }
+    /**
+     * Vérifie si la vue est valide
+     */
+    isValid() {
+        return this.validate().isValid;
+    }
+    /**
+     * Valide la vue et retourne le résultat
+     */
+    validateView() {
+        return this.validate();
+    }
+    /**
+     * Obtient les erreurs de validation
+     */
+    getValidationErrors() {
+        return this.validate().errors.map(e => e.message);
+    }
+    /**
+     * Obtient les avertissements de validation
+     */
+    getValidationWarnings() {
+        return (this.validate().warnings || []).map(e => e.message);
+    }
+    /**
+     * Met à jour les métadonnées
+     */
+    updateMetadata(metadata) {
+        if (this.metadata) {
+            this.metadata = { ...this.metadata, ...metadata };
+        }
+        else {
+            this.metadata = metadata;
+        }
+    }
+    /**
+     * Obtient les métadonnées
+     */
+    getMetadata() {
+        return this.metadata;
+    }
+    /**
+     * Protected helper to set intro/note text with strict validation
+     * Child views can expose this as setIntro(), setNote(), etc.
+     * @param fieldName - Name of the content field to set (e.g., 'intro', 'note')
+     * @param value - Text value to set
+     * @throws InvalidParameterError if value is empty or null
+     */
+    setIntroText(fieldName, value) {
+        if (!value || value.trim().length === 0) {
+            throw new errors_1.InvalidParameterError(fieldName, value, `${fieldName} text cannot be empty`);
+        }
+        const trimmedValue = value.trim();
+        if (typeof this.content === 'object' && this.content !== null) {
+            this.content[fieldName] = trimmedValue;
+        }
+        return this;
+    }
+    /**
+     * Définit la vue suivante (navigation)
+     * Validates URL to prevent open redirects and malicious links
+     */
+    setNext(url) {
+        // Validate URL for security
+        const validation = (0, validators_1.validateSubmissionURL)(url, {
+            ...validators_1.DEFAULT_URL_CONFIG,
+            blockLocalhost: false, // Allow localhost for development
+            blockPrivateIPs: false // Allow private IPs for development
+        });
+        if (!validation.isValid) {
+            const errorMessages = validation.errors.map(e => e.message).join('; ');
+            throw new errors_1.InvalidParameterError('url', url, `Invalid navigation URL: ${errorMessages}`);
+        }
+        if (!this.navigation) {
+            this.navigation = {};
+        }
+        this.navigation.next = url;
+        return this;
+    }
+    /**
+     * Définit la vue précédente (navigation)
+     * Validates URL to prevent open redirects and malicious links
+     */
+    setPrev(url) {
+        // Validate URL for security
+        const validation = (0, validators_1.validateSubmissionURL)(url, {
+            ...validators_1.DEFAULT_URL_CONFIG,
+            blockLocalhost: false, // Allow localhost for development
+            blockPrivateIPs: false // Allow private IPs for development
+        });
+        if (!validation.isValid) {
+            const errorMessages = validation.errors.map(e => e.message).join('; ');
+            throw new errors_1.InvalidParameterError('url', url, `Invalid navigation URL: ${errorMessages}`);
+        }
+        if (!this.navigation) {
+            this.navigation = {};
+        }
+        this.navigation.prev = url;
+        return this;
+    }
+    /**
+     * Définit le contexte de processus pour cette vue
+     * @param processId - Identifiant unique du processus
+     * @param context - Contexte additionnel (étapes, nom, etc.)
+     */
+    setProcess(processId, context) {
+        this.processContext = {
+            processId,
+            ...(context || {})
+        };
+        return this;
+    }
+    /**
+     * Obtient le contexte de processus
+     */
+    getProcessContext() {
+        return this.processContext;
+    }
+    /**
+     * Obtient l'identifiant du processus (raccourci)
+     */
+    getProcessId() {
+        return this.processContext?.processId;
+    }
+    /**
+     * Vérifie si cette vue fait partie d'un processus
+     */
+    hasProcess() {
+        return this.processContext !== undefined;
+    }
+    /**
+     * Met à jour le contexte de processus
+     */
+    updateProcessContext(updates) {
+        if (!this.processContext) {
+            throw new errors_1.NoProcessContextError(this.id, 'update');
+        }
+        this.processContext = {
+            ...this.processContext,
+            ...updates
+        };
+        return this;
+    }
+    /**
+     * Nettoie les ressources de la vue
+     */
+    destroy() {
+        this.state = {};
+    }
+}
+exports.BaseView = BaseView;
+//# sourceMappingURL=base-view.js.map

package/dist/core/base-view.js.map

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

package/dist/core/card-view.d.ts

@@ -0,0 +1,24 @@
+import { BaseView } from './base-view';
+import { CardContent, CardActionVariant, HttpMethod } from '../types';
+export declare class CardView extends BaseView {
+    constructor(viewId: string, title: string, processId?: string);
+    setSubtitle(subtitle: string): this;
+    setDescription(description: string): this;
+    setBadge(badge: string | undefined): this;
+    setImage(url: string, alt?: string): this;
+    clearImage(): this;
+    addStat(label: string, value: string): this;
+    clearStats(): this;
+    addSection(heading: string, body: string): this;
+    clearSections(): this;
+    addAction(text: string, method?: HttpMethod, options?: {
+        confirmMessage?: string;
+        href?: string;
+        icon?: string;
+        variant?: CardActionVariant;
+    }): this;
+    clearActions(): this;
+    setMetadata(meta: Record<string, unknown>): this;
+    getContent(): CardContent;
+}
+//# sourceMappingURL=card-view.d.ts.map

package/dist/core/card-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-view.d.ts","sourceRoot":"","sources":["../../src/core/card-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACH,WAAW,EAKX,iBAAiB,EACjB,UAAU,EACb,MAAM,UAAU,CAAC;AAKlB,qBAAa,QAAS,SAAQ,QAAQ;gBACtB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAyB7D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMnC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAMzC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAezC,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgB3C,UAAU,IAAI,IAAI;IAMlB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAe/C,aAAa,IAAI,IAAI;IAMrB,SAAS,CACL,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,UAAmB,EAC3B,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;KAAO,GACrG,IAAI;IAmBP,YAAY,IAAI,IAAI;IAMpB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKhD,UAAU,IAAI,WAAW;CAG5B"}

package/dist/core/card-view.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardView = void 0;
+const base_view_1 = require("./base-view");
+const errors_1 = require("../errors");
+// CardView is a compact "product sheet" view that highlights a single item with stats, sections and actions.
+class CardView extends base_view_1.BaseView {
+    constructor(viewId, title, processId) {
+        super({
+            id: viewId,
+            type: 'Card',
+            processId,
+            metadata: {
+                version: '1.0.0',
+                createdAt: new Date()
+            }
+        });
+        this.content = {
+            title,
+            subtitle: '',
+            description: '',
+            badge: undefined,
+            image: undefined,
+            stats: [],
+            sections: [],
+            actions: [],
+            meta: undefined
+        };
+    }
+    // Sets the small subtitle displayed under the main title.
+    setSubtitle(subtitle) {
+        this.content.subtitle = subtitle.trim();
+        return this;
+    }
+    // Provides the long-form description for the card body.
+    setDescription(description) {
+        this.content.description = description.trim();
+        return this;
+    }
+    // Displays a compact badge (e.g., "Nouveau") above the title.
+    setBadge(badge) {
+        this.content.badge = badge?.trim() || undefined;
+        return this;
+    }
+    // Attaches a hero image to the card header.
+    setImage(url, alt) {
+        const trimmedUrl = url.trim();
+        if (!trimmedUrl) {
+            throw new errors_1.InvalidParameterError('url', url, 'Image URL cannot be empty');
+        }
+        const image = {
+            url: trimmedUrl,
+            alt: alt?.trim()
+        };
+        this.content.image = image;
+        return this;
+    }
+    clearImage() {
+        this.content.image = undefined;
+        return this;
+    }
+    // Adds a key metric row (label/value) in the highlight area.
+    addStat(label, value) {
+        const trimmedLabel = label.trim();
+        const trimmedValue = value.trim();
+        if (!trimmedLabel || !trimmedValue) {
+            throw new errors_1.MissingRequiredParameterError('label and value');
+        }
+        this.content.stats.push({
+            label: trimmedLabel,
+            value: trimmedValue
+        });
+        return this;
+    }
+    clearStats() {
+        this.content.stats = [];
+        return this;
+    }
+    // Inserts a descriptive section below the highlights.
+    addSection(heading, body) {
+        const trimmedHeading = heading.trim();
+        const trimmedBody = body.trim();
+        if (!trimmedHeading || !trimmedBody) {
+            throw new errors_1.MissingRequiredParameterError('heading and body');
+        }
+        this.content.sections.push({
+            heading: trimmedHeading,
+            body: trimmedBody
+        });
+        return this;
+    }
+    clearSections() {
+        this.content.sections = [];
+        return this;
+    }
+    // Registers an action button displayed in the footer.
+    addAction(text, method = 'POST', options = {}) {
+        const trimmedText = text.trim();
+        if (!trimmedText) {
+            throw new errors_1.InvalidParameterError('text', text, 'Action text cannot be empty');
+        }
+        const action = {
+            text: trimmedText,
+            method,
+            confirmMessage: options.confirmMessage,
+            href: options.href?.trim(),
+            icon: options.icon?.trim(),
+            variant: options.variant
+        };
+        this.content.actions.push(action);
+        return this;
+    }
+    clearActions() {
+        this.content.actions = [];
+        return this;
+    }
+    // Stores arbitrary metadata the client may need.
+    setMetadata(meta) {
+        this.content.meta = { ...meta };
+        return this;
+    }
+    getContent() {
+        return this.content;
+    }
+}
+exports.CardView = CardView;
+//# sourceMappingURL=card-view.js.map

package/dist/core/card-view.js.map

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

package/dist/core/carousel-view.d.ts

@@ -0,0 +1,22 @@
+import { BaseView } from './base-view';
+import { CarouselContent, CarouselSettings, CarouselSlide, CardAction, HttpMethod } from '../types';
+export declare class CarouselView extends BaseView {
+    constructor(viewId: string, title: string, processId?: string);
+    setSubtitle(subtitle: string): this;
+    setSettings(settings: CarouselSettings): this;
+    addSlide(slide: CarouselSlide): this;
+    createSlide(id: string, title: string, description?: string, options?: {
+        imageUrl?: string;
+        imageAlt?: string;
+        badge?: string;
+    }): CarouselSlide;
+    addSlideAction(slideId: string, text: string, method?: HttpMethod, options?: {
+        confirmMessage?: string;
+        href?: string;
+        icon?: string;
+        variant?: CardAction['variant'];
+    }): this;
+    clearSlides(): this;
+    getContent(): CarouselContent;
+}
+//# sourceMappingURL=carousel-view.d.ts.map

package/dist/core/carousel-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carousel-view.d.ts","sourceRoot":"","sources":["../../src/core/carousel-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAKpG,qBAAa,YAAa,SAAQ,QAAQ;gBAC1B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAyB7D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAM7C,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAiBpC,WAAW,CACP,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GACvE,aAAa;IAkBhB,cAAc,CACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,UAAmB,EAC3B,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;KAAO,GACzG,IAAI;IAuBP,WAAW,IAAI,IAAI;IAMnB,UAAU,IAAI,eAAe;CAGhC"}