@blakron/core 0.2.4 → 0.3.1

package/dist/blakron/resource/Resource.d.ts

@@ -0,0 +1,114 @@
+import { ResourceEventType, type ResourceEvent } from './ResourceEvent.js';
+import { AnalyzerBase } from './analyzers/AnalyzerBase.js';
+/**
+ * Progress callback signature.
+ */
+export type ProgressCallback = (loaded: number, total: number) => void;
+/**
+ * Event listener callback signature.
+ */
+export type ResourceEventListener = (event: ResourceEvent) => void;
+/**
+ * Modern resource manager — async/await API, type-safe, module-based.
+ *
+ * @example
+ * ```ts
+ * import { resource } from '@blakron/core';
+ *
+ * await resource.loadConfig('resource.json', 'assets/');
+ * await resource.loadGroup('preload');
+ * const texture = resource.get<Texture>('bg.png');
+ * ```
+ */
+export declare class Resource {
+    private static _instance?;
+    static get instance(): Resource;
+    private config;
+    private loader;
+    private analyzerMap;
+    private eventListeners;
+    private loadedNames;
+    private isConfigLoaded;
+    constructor();
+    /**
+     * Load and parse a resource configuration file.
+     * @param url URL of the resource.json file
+     * @param folder Base URL prefix for resource files (default: '')
+     */
+    loadConfig(url: string, folder?: string): Promise<void>;
+    /**
+     * Add a resource definition directly (without a config file).
+     */
+    addResource(def: {
+        name: string;
+        url: string;
+        type: string;
+    }): void;
+    /**
+     * Load all resources in a group. Returns a promise that resolves when done.
+     * @param groupName Name of the group to load
+     * @param priority Loading priority (higher = loads first)
+     * @param onProgress Optional progress callback
+     */
+    loadGroup(groupName: string, priority?: number, onProgress?: ProgressCallback): Promise<void>;
+    /**
+     * Load a single resource by name. Returns the cached data.
+     */
+    load<T = unknown>(name: string): Promise<T>;
+    /**
+     * Get a cached resource synchronously. Returns undefined if not loaded.
+     */
+    get<T = unknown>(name: string): T | undefined;
+    /**
+     * Check if a resource is loaded and cached.
+     */
+    hasRes(name: string): boolean;
+    /**
+     * Check if a group exists in the config.
+     */
+    hasGroup(name: string): boolean;
+    /**
+     * Get all group names.
+     */
+    getGroupNames(): string[];
+    /**
+     * Destroy a single cached resource by name.
+     */
+    destroy(name: string): boolean;
+    /**
+     * Destroy all resources in a group.
+     */
+    destroyGroup(groupName: string): void;
+    /**
+     * Destroy all cached resources.
+     */
+    destroyAll(): void;
+    /**
+     * Listen for resource events.
+     */
+    on(type: ResourceEventType, listener: ResourceEventListener): void;
+    /**
+     * Remove an event listener.
+     */
+    off(type: ResourceEventType, listener: ResourceEventListener): void;
+    /**
+     * Listen for loading progress on the next loadGroup/load call.
+     * Convenience method — shorthand for on(ResourceEventType.GROUP_PROGRESS, ...).
+     */
+    onProgress(callback: ProgressCallback): void;
+    /**
+     * Register a custom analyzer for a resource type.
+     */
+    registerAnalyzer(type: string, analyzer: AnalyzerBase): void;
+    private registerDefaultAnalyzers;
+    private fetchConfig;
+    private loadResourceList;
+    private getAnalyzer;
+    private isResourceLoaded;
+    private emit;
+}
+/**
+ * Convenience singleton instance.
+ */
+export declare const resource: Resource;
+//# sourceMappingURL=Resource.d.ts.map

package/dist/blakron/resource/Resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../../src/blakron/resource/Resource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAW3D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IAGpB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAW;IAEpC,WAAkB,QAAQ,IAAI,QAAQ,CAKrC;IAID,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,WAAW,CAA8D;IACjF,OAAO,CAAC,cAAc,CAA0F;IAChH,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,cAAc,CAAS;;IAU/B;;;;OAIG;IACU,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhE;;OAEG;IACI,WAAW,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM1E;;;;;OAKG;IACU,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,UAAU,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrG;;OAEG;IACU,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA0BxD;;OAEG;IACI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IASpD;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOpC;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACI,aAAa,IAAI,MAAM,EAAE;IAMhC;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUrC;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO5C;;OAEG;IACI,UAAU,IAAI,IAAI;IAUzB;;OAEG;IACI,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IASzE;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAO1E;;;OAGG;IACI,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAQnD;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAOnE,OAAO,CAAC,wBAAwB;YAqBlB,WAAW;IAkDzB,OAAO,CAAC,gBAAgB;IAqExB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,IAAI;CAYZ;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAyB,CAAC"}

package/dist/blakron/resource/Resource.js

@@ -0,0 +1,363 @@
+import { ResourceType } from './ResourceItem.js';
+import { ResourceConfig } from './ResourceConfig.js';
+import { ResourceLoader } from './ResourceLoader.js';
+import { ResourceEventType } from './ResourceEvent.js';
+import { ImageAnalyzer } from './analyzers/ImageAnalyzer.js';
+import { JsonAnalyzer } from './analyzers/JsonAnalyzer.js';
+import { TextAnalyzer } from './analyzers/TextAnalyzer.js';
+import { SoundAnalyzer } from './analyzers/SoundAnalyzer.js';
+import { SheetAnalyzer } from './analyzers/SheetAnalyzer.js';
+import { HttpRequest } from '../net/HttpRequest.js';
+import { HttpResponseType } from '../net/HttpResponseType.js';
+import { Event } from '../events/Event.js';
+import { IOErrorEvent } from '../events/IOErrorEvent.js';
+/**
+ * Modern resource manager — async/await API, type-safe, module-based.
+ *
+ * @example
+ * ```ts
+ * import { resource } from '@blakron/core';
+ *
+ * await resource.loadConfig('resource.json', 'assets/');
+ * await resource.loadGroup('preload');
+ * const texture = resource.get<Texture>('bg.png');
+ * ```
+ */
+export class Resource {
+    // ── Singleton ────────────────────────────────────────────────────────────
+    static _instance;
+    static get instance() {
+        if (!Resource._instance) {
+            Resource._instance = new Resource();
+        }
+        return Resource._instance;
+    }
+    // ── Instance fields ──────────────────────────────────────────────────────
+    config = new ResourceConfig();
+    loader = new ResourceLoader();
+    analyzerMap = new Map();
+    eventListeners = new Map();
+    loadedNames = new Set();
+    isConfigLoaded = false;
+    // ── Constructor ──────────────────────────────────────────────────────────
+    constructor() {
+        this.registerDefaultAnalyzers();
+    }
+    // ── Config ───────────────────────────────────────────────────────────────
+    /**
+     * Load and parse a resource configuration file.
+     * @param url URL of the resource.json file
+     * @param folder Base URL prefix for resource files (default: '')
+     */
+    async loadConfig(url, folder = '') {
+        const data = await this.fetchConfig(url);
+        this.config.parseConfig(data, folder);
+        this.isConfigLoaded = true;
+        this.emit({
+            type: ResourceEventType.CONFIG_COMPLETE,
+            groupName: '',
+            itemsLoaded: 0,
+            itemsTotal: 0,
+        });
+    }
+    /**
+     * Add a resource definition directly (without a config file).
+     */
+    addResource(def) {
+        this.config.addItem(def);
+    }
+    // ── Group loading ────────────────────────────────────────────────────────
+    /**
+     * Load all resources in a group. Returns a promise that resolves when done.
+     * @param groupName Name of the group to load
+     * @param priority Loading priority (higher = loads first)
+     * @param onProgress Optional progress callback
+     */
+    async loadGroup(groupName, priority = 0, onProgress) {
+        const items = this.config.getGroupByName(groupName);
+        if (items.length === 0) {
+            throw new Error(`Resource group "${groupName}" not found or is empty.`);
+        }
+        // Filter out already-loaded items
+        const toLoad = items.filter(item => !this.isResourceLoaded(item.name));
+        if (toLoad.length === 0)
+            return;
+        await this.loadResourceList(toLoad, groupName, priority, onProgress);
+    }
+    // ── Single resource loading ──────────────────────────────────────────────
+    /**
+     * Load a single resource by name. Returns the cached data.
+     */
+    async load(name) {
+        // Check cache
+        const cached = this.get(name);
+        if (cached !== undefined)
+            return cached;
+        const item = this.config.getResourceItem(name);
+        if (!item) {
+            throw new Error(`Resource "${name}" not found in config.`);
+        }
+        const analyzer = this.getAnalyzer(item.type);
+        if (!analyzer) {
+            throw new Error(`No analyzer registered for type "${item.type}".`);
+        }
+        const result = await analyzer.loadFile(item);
+        if (!result.loaded) {
+            throw new Error(`Failed to load resource "${name}" from "${item.url}".`);
+        }
+        this.loadedNames.add(name);
+        return this.get(name);
+    }
+    // ── Cache access ─────────────────────────────────────────────────────────
+    /**
+     * Get a cached resource synchronously. Returns undefined if not loaded.
+     */
+    get(name) {
+        // Try each analyzer
+        for (const analyzer of this.analyzerMap.values()) {
+            const data = analyzer.getRes(name);
+            if (data !== undefined)
+                return data;
+        }
+        return undefined;
+    }
+    /**
+     * Check if a resource is loaded and cached.
+     */
+    hasRes(name) {
+        for (const analyzer of this.analyzerMap.values()) {
+            if (analyzer.hasRes(name))
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Check if a group exists in the config.
+     */
+    hasGroup(name) {
+        return this.config.hasGroup(name);
+    }
+    /**
+     * Get all group names.
+     */
+    getGroupNames() {
+        return this.config.getGroupNames();
+    }
+    // ── Resource destruction ─────────────────────────────────────────────────
+    /**
+     * Destroy a single cached resource by name.
+     */
+    destroy(name) {
+        for (const analyzer of this.analyzerMap.values()) {
+            if (analyzer.destroyRes(name)) {
+                this.loadedNames.delete(name);
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Destroy all resources in a group.
+     */
+    destroyGroup(groupName) {
+        const items = this.config.getGroupByName(groupName);
+        for (const item of items) {
+            this.destroy(item.name);
+        }
+    }
+    /**
+     * Destroy all cached resources.
+     */
+    destroyAll() {
+        const names = Array.from(this.loadedNames);
+        for (const name of names) {
+            this.destroy(name);
+        }
+        this.loadedNames.clear();
+    }
+    // ── Events ───────────────────────────────────────────────────────────────
+    /**
+     * Listen for resource events.
+     */
+    on(type, listener) {
+        let set = this.eventListeners.get(type);
+        if (!set) {
+            set = new Set();
+            this.eventListeners.set(type, set);
+        }
+        set.add(listener);
+    }
+    /**
+     * Remove an event listener.
+     */
+    off(type, listener) {
+        const set = this.eventListeners.get(type);
+        if (set) {
+            set.delete(listener);
+        }
+    }
+    /**
+     * Listen for loading progress on the next loadGroup/load call.
+     * Convenience method — shorthand for on(ResourceEventType.GROUP_PROGRESS, ...).
+     */
+    onProgress(callback) {
+        this.on(ResourceEventType.GROUP_PROGRESS, event => {
+            callback(event.itemsLoaded, event.itemsTotal);
+        });
+    }
+    // ── Custom analyzer registration ─────────────────────────────────────────
+    /**
+     * Register a custom analyzer for a resource type.
+     */
+    registerAnalyzer(type, analyzer) {
+        this.analyzerMap.set(type, analyzer);
+        this.loader.registerAnalyzer(type, analyzer);
+    }
+    // ── Private methods ──────────────────────────────────────────────────────
+    registerDefaultAnalyzers() {
+        const imageAnalyzer = new ImageAnalyzer();
+        const jsonAnalyzer = new JsonAnalyzer();
+        const textAnalyzer = new TextAnalyzer();
+        const soundAnalyzer = new SoundAnalyzer();
+        const sheetAnalyzer = new SheetAnalyzer();
+        this.analyzerMap.set(ResourceType.Image, imageAnalyzer);
+        this.analyzerMap.set(ResourceType.Json, jsonAnalyzer);
+        this.analyzerMap.set(ResourceType.Text, textAnalyzer);
+        this.analyzerMap.set(ResourceType.Sound, soundAnalyzer);
+        this.analyzerMap.set(ResourceType.Sheet, sheetAnalyzer);
+        // Also register with loader
+        this.loader.registerAnalyzer(ResourceType.Image, imageAnalyzer);
+        this.loader.registerAnalyzer(ResourceType.Json, jsonAnalyzer);
+        this.loader.registerAnalyzer(ResourceType.Text, textAnalyzer);
+        this.loader.registerAnalyzer(ResourceType.Sound, soundAnalyzer);
+        this.loader.registerAnalyzer(ResourceType.Sheet, sheetAnalyzer);
+    }
+    async fetchConfig(url) {
+        return new Promise((resolve, reject) => {
+            const request = new HttpRequest();
+            request.responseType = HttpResponseType.TEXT;
+            const onComplete = () => {
+                cleanup();
+                const response = request.response;
+                if (!response) {
+                    const error = new Error(`Failed to load config from "${url}"`);
+                    this.emit({
+                        type: ResourceEventType.CONFIG_LOAD_ERROR,
+                        groupName: '',
+                        itemsLoaded: 0,
+                        itemsTotal: 0,
+                    });
+                    reject(error);
+                    return;
+                }
+                try {
+                    resolve(JSON.parse(response));
+                }
+                catch (e) {
+                    reject(e);
+                }
+            };
+            const onError = () => {
+                cleanup();
+                const error = new Error(`Failed to fetch config from "${url}"`);
+                this.emit({
+                    type: ResourceEventType.CONFIG_LOAD_ERROR,
+                    groupName: '',
+                    itemsLoaded: 0,
+                    itemsTotal: 0,
+                });
+                reject(error);
+            };
+            const cleanup = () => {
+                request.removeEventListener(Event.COMPLETE, onComplete);
+                request.removeEventListener(IOErrorEvent.IO_ERROR, onError);
+            };
+            request.addEventListener(Event.COMPLETE, onComplete);
+            request.addEventListener(IOErrorEvent.IO_ERROR, onError);
+            request.open(url);
+            request.send();
+        });
+    }
+    loadResourceList(list, groupName, _priority, onProgress) {
+        return new Promise((resolve, reject) => {
+            let loadedCount = 0;
+            const totalCount = list.length;
+            let hasError = false;
+            this.loader.loadResourceList(list);
+            this.loader.onComplete = (item) => {
+                loadedCount++;
+                this.loadedNames.add(item.name);
+                this.emit({
+                    type: ResourceEventType.GROUP_PROGRESS,
+                    groupName,
+                    item,
+                    itemsLoaded: loadedCount,
+                    itemsTotal: totalCount,
+                });
+                if (onProgress) {
+                    onProgress(loadedCount, totalCount);
+                }
+            };
+            this.loader.onError = (item) => {
+                hasError = true;
+                this.emit({
+                    type: ResourceEventType.ITEM_LOAD_ERROR,
+                    groupName,
+                    item,
+                    itemsLoaded: loadedCount,
+                    itemsTotal: totalCount,
+                });
+            };
+            this.loader.onProgress = (_loaded, _total) => {
+                // Additional progress tracking if needed
+            };
+            this.loader.start().then(() => {
+                this.loader.onComplete = undefined;
+                this.loader.onError = undefined;
+                this.loader.onProgress = undefined;
+                if (hasError) {
+                    this.emit({
+                        type: ResourceEventType.GROUP_LOAD_ERROR,
+                        groupName,
+                        itemsLoaded: loadedCount,
+                        itemsTotal: totalCount,
+                    });
+                    reject(new Error(`Failed to load some resources in group "${groupName}".`));
+                }
+                else {
+                    this.emit({
+                        type: ResourceEventType.GROUP_COMPLETE,
+                        groupName,
+                        itemsLoaded: loadedCount,
+                        itemsTotal: totalCount,
+                    });
+                    resolve();
+                }
+            });
+        });
+    }
+    getAnalyzer(type) {
+        return this.analyzerMap.get(type);
+    }
+    isResourceLoaded(name) {
+        return this.hasRes(name);
+    }
+    emit(event) {
+        const set = this.eventListeners.get(event.type);
+        if (set) {
+            for (const listener of set) {
+                try {
+                    listener(event);
+                }
+                catch {
+                    // swallow listener errors
+                }
+            }
+        }
+    }
+}
+/**
+ * Convenience singleton instance.
+ */
+export const resource = new Resource();
+//# sourceMappingURL=Resource.js.map

package/dist/blakron/resource/Resource.js.map

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

package/dist/blakron/resource/ResourceConfig.d.ts

@@ -0,0 +1,71 @@
+import { ResourceItem } from './ResourceItem.js';
+/**
+ * Raw resource config file format.
+ */
+export interface ResourceConfigData {
+    resources: ResourceConfigEntry[];
+    groups: ResourceGroupEntry[];
+}
+export interface ResourceConfigEntry {
+    name: string;
+    type: string;
+    url: string;
+    subkeys?: string;
+    [key: string]: unknown;
+}
+export interface ResourceGroupEntry {
+    name: string;
+    keys: string;
+}
+/**
+ * Parses and manages resource configuration data.
+ * Maintains key→item mapping and group→item[] mapping.
+ */
+export declare class ResourceConfig {
+    private keyMap;
+    private groupDic;
+    /**
+     * Parse a config JSON object.
+     * @param data The parsed JSON data from resource.json
+     * @param folder URL prefix for relative paths
+     */
+    parseConfig(data: ResourceConfigData, folder: string): void;
+    /**
+     * Get a list of ResourceItem objects for a group.
+     */
+    getGroupByName(name: string): ResourceItem[];
+    /**
+     * Create a custom resource group from a list of keys.
+     * @param name Group name
+     * @param keys Resource keys or existing group names to include
+     * @param override Whether to overwrite an existing group
+     */
+    createGroup(name: string, keys: string[], override?: boolean): boolean;
+    /**
+     * Add a resource config entry directly.
+     */
+    addItem(item: ResourceConfigEntry): void;
+    /**
+     * Get the type of a resource by key.
+     */
+    getType(key: string): string;
+    /**
+     * Get a ResourceItem by key.
+     */
+    getResourceItem(key: string): ResourceItem | undefined;
+    /**
+     * Check if a key exists in the config.
+     */
+    hasKey(key: string): boolean;
+    /**
+     * Check if a group exists.
+     */
+    hasGroup(name: string): boolean;
+    /**
+     * Get all group names.
+     */
+    getGroupNames(): string[];
+    private addItemToKeyMap;
+    private parseResourceItem;
+}
+//# sourceMappingURL=ResourceConfig.d.ts.map

package/dist/blakron/resource/ResourceConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceConfig.d.ts","sourceRoot":"","sources":["../../../src/blakron/resource/ResourceConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,QAAQ,CAA4C;IAE5D;;;;OAIG;IACI,WAAW,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA+BlE;;OAEG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE;IAOnD;;;;;OAKG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,UAAQ,GAAG,OAAO;IA+B3E;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAI/C;;OAEG;IACI,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKnC;;OAEG;IACI,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAM7D;;OAEG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACI,aAAa,IAAI,MAAM,EAAE;IAMhC,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,iBAAiB;CAGzB"}