@terminalfour/terminalfour-js 1.0.0-rc.1

package/dist/esm/resources/list-resource.js

@@ -0,0 +1,174 @@
+import { resolveLanguage } from '../utils.js';
+import { decodeHtmlEntities } from '../utils.js';
+/** A mutable list object. Modify properties and call save() to persist. */
+export class List {
+    constructor(raw, httpClient, language) {
+        this.id = raw.id;
+        this.name = decodeHtmlEntities(raw.name);
+        this.description = decodeHtmlEntities(raw.description ?? '');
+        this.isForcedLanguage = raw.isForcedLanguage ?? false;
+        this.isDefaultLanguage = raw.isDefaultLanguage ?? false;
+        this.primaryGroup = raw.primaryGroup?.group?.id ?? raw.primaryGroup?.id ?? 0;
+        this.sharedGroups = (raw.sharedGroups ?? []).map((g) => g.id);
+        this.items = {};
+        for (const item of (raw.items ?? []).sort((a, b) => a.sequence - b.sequence)) {
+            const friendlyName = decodeHtmlEntities(item.name);
+            const mapped = {
+                name: friendlyName,
+                value: item.value,
+                selected: item.isSelected,
+            };
+            if (item.sublist)
+                mapped.sublistId = item.sublist;
+            // Store raw item ID as non-enumerable for save
+            Object.defineProperty(mapped, '_rawId', { value: item.id, enumerable: false });
+            this.items[friendlyName] = mapped;
+        }
+        Object.defineProperty(this, '_httpClient', { value: httpClient, enumerable: false });
+        Object.defineProperty(this, '_language', { value: language, enumerable: false });
+        Object.defineProperty(this, '_rawData', { value: raw, enumerable: false, writable: true });
+    }
+    /** Adds a new item to this list. Takes effect on save(). */
+    addItem(data) {
+        if (!data.name?.trim())
+            throw new Error('List item name is required');
+        if (this.items[data.name])
+            throw new Error(`List item "${data.name}" already exists`);
+        const mapped = {
+            name: data.name,
+            value: data.value,
+            selected: data.selected ?? false,
+        };
+        if (data.sublistId)
+            mapped.sublistId = data.sublistId;
+        // New items get _rawId = 0 so save() sends id: "0" (tells the API to create)
+        Object.defineProperty(mapped, '_rawId', { value: 0, enumerable: false });
+        this.items[data.name] = mapped;
+    }
+    /** Removes a list item by name. Takes effect on save(). */
+    removeItem(itemName) {
+        if (!this.items[itemName])
+            throw new Error(`List item "${itemName}" not found`);
+        delete this.items[itemName];
+    }
+    /** Persists current property values to the server via PUT. */
+    async save() {
+        if (this.isForcedLanguage && this.isDefaultLanguage) {
+            throw new Error('isForcedLanguage and isDefaultLanguage cannot both be true');
+        }
+        const items = Object.values(this.items).map((item, i) => ({
+            id: String(item._rawId ?? 0),
+            name: item.name,
+            value: item.value,
+            isSelected: item.selected,
+            sublist: item.sublistId ? String(item.sublistId) : '0',
+            sequence: i + 1,
+        }));
+        const updated = {
+            ...this._rawData,
+            name: this.name,
+            description: this.description,
+            isForcedLanguage: this.isForcedLanguage,
+            isDefaultLanguage: this.isDefaultLanguage,
+            primaryGroup: { id: this.primaryGroup || 0 },
+            sharedGroups: this.sharedGroups.map((id) => ({ id })),
+            items,
+        };
+        await this._httpClient.request({
+            method: 'PUT',
+            path: `/list/${this.id}/${this._language}?override=false`,
+            body: updated,
+        });
+        this._rawData = updated;
+    }
+}
+/**
+ * Resource for list operations.
+ */
+export class ListResource {
+    constructor(httpClient, defaultLanguage) {
+        this.httpClient = httpClient;
+        this.defaultLanguage = defaultLanguage;
+    }
+    /** Lists all lists. */
+    async list(options) {
+        const language = resolveLanguage(options?.language, this.defaultLanguage);
+        const raw = await this.httpClient.request({
+            method: 'GET',
+            path: `/list/${language}`,
+        });
+        return raw.map((l) => ({
+            id: l.id,
+            name: decodeHtmlEntities(l.name),
+            description: decodeHtmlEntities(l.description ?? ''),
+        }));
+    }
+    /** Gets a single list with its items. Returns a mutable List object. */
+    async get(id, options) {
+        const language = resolveLanguage(options?.language, this.defaultLanguage);
+        const raw = await this.httpClient.request({
+            method: 'GET',
+            path: `/list/${id}/${language}?override=false`,
+        });
+        return new List(raw, this.httpClient, language);
+    }
+    /** Updates a list's properties (immutable pattern). */
+    async update(id, data, options) {
+        const list = await this.get(id, options);
+        if (data.name !== undefined)
+            list.name = data.name;
+        if (data.description !== undefined)
+            list.description = data.description;
+        if (data.isForcedLanguage !== undefined)
+            list.isForcedLanguage = data.isForcedLanguage;
+        if (data.isDefaultLanguage !== undefined)
+            list.isDefaultLanguage = data.isDefaultLanguage;
+        if (data.primaryGroup !== undefined)
+            list.primaryGroup = data.primaryGroup;
+        if (data.sharedGroups !== undefined)
+            list.sharedGroups = data.sharedGroups;
+        await list.save();
+        return list;
+    }
+    /** Deletes a list by ID. */
+    async delete(id) {
+        await this.httpClient.request({
+            method: 'DELETE',
+            path: `/list/${id}?override=false`,
+        });
+    }
+    /** Creates a new list. */
+    async create(data, options) {
+        if (!data.name?.trim()) {
+            throw new Error('List name is required');
+        }
+        if (data.isForcedLanguage && data.isDefaultLanguage) {
+            throw new Error('isForcedLanguage and isDefaultLanguage cannot both be true');
+        }
+        const language = resolveLanguage(options?.language, this.defaultLanguage);
+        const items = (data.items ?? []).map((item, i) => ({
+            id: '0',
+            name: item.name,
+            value: item.value,
+            isSelected: item.selected ?? false,
+            sublist: item.sublistId ? String(item.sublistId) : '',
+            sequence: i + 1,
+        }));
+        const raw = await this.httpClient.request({
+            method: 'POST',
+            path: `/list/${language}?override=false`,
+            body: {
+                name: data.name,
+                description: data.description ?? '',
+                items,
+                isForcedLanguage: data.isForcedLanguage ?? false,
+                isDefaultLanguage: data.isDefaultLanguage ?? false,
+                sharedGroups: (data.sharedGroups ?? []).map((id) => ({ id })),
+                primaryGroup: { id: data.primaryGroup ?? 0 },
+                sortType: 0,
+            },
+        });
+        return new List(raw, this.httpClient, language);
+    }
+}
+//# sourceMappingURL=list-resource.js.map

package/dist/esm/resources/list-resource.js.map

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

package/dist/esm/resources/media-resource.d.ts

@@ -0,0 +1,69 @@
+import { HttpClient } from '../http-client.js';
+import { MediaItem, MediaFileInput } from '../models/media-item.js';
+import { LanguageOption } from '../types.js';
+/**
+ * Resource for media operations: get, create, update, upload, delete.
+ */
+export declare class MediaResource {
+    private readonly httpClient;
+    private mediaTypesPromise;
+    private mediaTypesExpiresAt;
+    private mediaTypesEpoch;
+    constructor(httpClient: HttpClient);
+    /**
+     * Retrieves a single media item by ID.
+     * Defaults to language 'smxx' (language-independent).
+     */
+    get(id: number, options?: LanguageOption): Promise<MediaItem>;
+    /**
+     * Creates a new media item in a category.
+     *
+     * The media type is auto-detected from the file extension using `GET /mediaType`.
+     * Syntax type is auto-detected for non-binary media (CSS, JS, PHP, etc.).
+     *
+     * Returns the new media item.
+     */
+    create(data: {
+        file: MediaFileInput;
+        name: string;
+        category: number;
+        description?: string;
+        mediaTypeId?: number;
+        fields?: Record<string, unknown>;
+        language?: string;
+    }): Promise<MediaItem>;
+    /**
+     * Updates a media item's properties (immutable pattern).
+     * Fetches the item, applies changes, and saves.
+     */
+    update(id: number, data: {
+        name?: string;
+        description?: string;
+        mediaTypeId?: number;
+        fields?: Record<string, unknown>;
+        file?: MediaFileInput;
+        content?: string;
+        syntaxType?: string;
+    }, options?: LanguageOption): Promise<MediaItem>;
+    /**
+     * Deletes a media item.
+     *
+     * If the media item belongs to a single category, the category is auto-selected.
+     * If it belongs to multiple categories, pass `categoryId` to specify which one,
+     * or the SDK throws with the valid options.
+     */
+    delete(id: number, options?: {
+        categoryId?: number;
+    } & LanguageOption): Promise<void>;
+    /**
+     * Permanently removes a media item. The item must be deleted (inactive) first.
+     */
+    purge(id: number, options?: LanguageOption): Promise<void>;
+    /**
+     * Fetches and caches the media types.
+     */
+    private getMediaTypes;
+    /** Extracts the media type ID from the raw elements */
+    private extractMediaTypeId;
+}
+//# sourceMappingURL=media-resource.d.ts.map

package/dist/esm/resources/media-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/media-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAe,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA4B7C;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,eAAe,CAAM;gBAEjB,UAAU,EAAE,UAAU;IAIlC;;;OAGG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAiBnE;;;;;;;OAOG;IACG,MAAM,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,cAAc,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,SAAS,CAAC;IA2EtB;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,cAAc,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAahD;;;;;;OAMG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B3F;;OAEG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhE;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB,uDAAuD;IACvD,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/esm/resources/media-resource.js

@@ -0,0 +1,206 @@
+import { MediaItem } from '../models/media-item.js';
+import { resolveLanguage, resolveFileToBlob, deriveFilename, DEFAULT_CACHE_TTL, getCacheEpoch } from '../utils.js';
+/** Extension → syntax type mapping for non-binary media */
+const EXTENSION_SYNTAX_MAP = {
+    js: 1,
+    css: 2,
+    html: 3,
+    htm: 3,
+    php: 4,
+    java: 5,
+};
+/** Extracts the extension from a filename (lowercase, no dot) */
+function getExtension(filename) {
+    const dotIndex = filename.lastIndexOf('.');
+    return dotIndex >= 0 ? filename.slice(dotIndex + 1).toLowerCase() : '';
+}
+/**
+ * Resource for media operations: get, create, update, upload, delete.
+ */
+export class MediaResource {
+    constructor(httpClient) {
+        this.mediaTypesPromise = null;
+        this.mediaTypesExpiresAt = 0;
+        this.mediaTypesEpoch = -1;
+        this.httpClient = httpClient;
+    }
+    /**
+     * Retrieves a single media item by ID.
+     * Defaults to language 'smxx' (language-independent).
+     */
+    async get(id, options) {
+        const language = resolveLanguage(options?.language, 'smxx');
+        const [raw, mediaTypes] = await Promise.all([
+            this.httpClient.request({
+                method: 'GET',
+                path: `/media/${id}/${language}`,
+            }),
+            this.getMediaTypes(),
+        ]);
+        const mediaTypeMap = new Map(mediaTypes.map((t) => [t.id, t.name]));
+        const mediaTypeName = raw.typeName ?? mediaTypeMap.get(this.extractMediaTypeId(raw)) ?? 'Unknown';
+        return new MediaItem(raw, mediaTypeName, this.httpClient);
+    }
+    /**
+     * Creates a new media item in a category.
+     *
+     * The media type is auto-detected from the file extension using `GET /mediaType`.
+     * Syntax type is auto-detected for non-binary media (CSS, JS, PHP, etc.).
+     *
+     * Returns the new media item.
+     */
+    async create(data) {
+        if (!data.name?.trim())
+            throw new Error('Media name is required');
+        if (!data.category)
+            throw new Error('Media category is required');
+        const language = data.language ?? 'smxx';
+        const filename = deriveFilename(data.file);
+        const ext = getExtension(filename);
+        // Resolve the file to a Blob
+        const rawFile = typeof data.file === 'object' && !(data.file instanceof Blob) && 'file' in data.file
+            ? data.file.file
+            : data.file;
+        const blob = await resolveFileToBlob(rawFile);
+        // Resolve media type from extension if not explicitly provided
+        const mediaTypes = await this.getMediaTypes();
+        let mediaTypeId = data.mediaTypeId;
+        let isBinary = true;
+        if (mediaTypeId === undefined) {
+            const matched = mediaTypes.find((t) => t.permittedExtensionsFormatted.some((e) => e.toLowerCase() === ext));
+            if (!matched) {
+                const validTypes = mediaTypes.map((t) => `${t.name} (${t.permittedExtensionsFormatted.join(', ')})`).join('; ');
+                throw new Error(`Cannot determine media type for extension "${ext}". ` +
+                    `Available types: ${validTypes}`);
+            }
+            mediaTypeId = matched.id;
+            isBinary = matched.binary;
+        }
+        else {
+            const matched = mediaTypes.find((t) => t.id === mediaTypeId);
+            isBinary = matched?.binary ?? true;
+        }
+        // Resolve syntax type for non-binary media
+        const syntaxType = !isBinary ? (EXTENSION_SYNTAX_MAP[ext] ?? 0) : 0;
+        // Build elements JSON from user fields
+        const elementsObj = {};
+        if (data.fields) {
+            // For create, we don't have the content type template yet, so use raw keys
+            // The API accepts friendly element names with undefined IDs on create
+            for (const [key, value] of Object.entries(data.fields)) {
+                elementsObj[key] = value;
+            }
+        }
+        const formData = new FormData();
+        formData.append('name', data.name);
+        formData.append('description', data.description ?? '');
+        formData.append('type', String(mediaTypeId));
+        formData.append('syntaxType', String(syntaxType));
+        formData.append('myMedia', '0');
+        formData.append('elements', JSON.stringify(elementsObj));
+        formData.append('version', '');
+        formData.append('binaryLanguage', language);
+        formData.append('language', language);
+        formData.append('categories', String(data.category));
+        formData.append('file', blob, filename);
+        formData.append('fileName', filename);
+        const newId = await this.httpClient.request({
+            method: 'POST',
+            path: '/media',
+            multipart: true,
+            formData,
+        });
+        return this.get(newId);
+    }
+    /**
+     * Updates a media item's properties (immutable pattern).
+     * Fetches the item, applies changes, and saves.
+     */
+    async update(id, data, options) {
+        const item = await this.get(id, options);
+        if (data.name !== undefined)
+            item.name = data.name;
+        if (data.description !== undefined)
+            item.description = data.description;
+        if (data.mediaTypeId !== undefined)
+            item.mediaTypeId = data.mediaTypeId;
+        if (data.fields !== undefined)
+            Object.assign(item.fields, data.fields);
+        if (data.file !== undefined)
+            item.file = data.file;
+        if (data.content !== undefined)
+            item.content = data.content;
+        if (data.syntaxType !== undefined)
+            item.syntaxType = data.syntaxType;
+        await item.save();
+        return item;
+    }
+    /**
+     * Deletes a media item.
+     *
+     * If the media item belongs to a single category, the category is auto-selected.
+     * If it belongs to multiple categories, pass `categoryId` to specify which one,
+     * or the SDK throws with the valid options.
+     */
+    async delete(id, options) {
+        const language = resolveLanguage(options?.language, 'smxx');
+        let categoryId = options?.categoryId;
+        if (categoryId === undefined) {
+            const item = await this.get(id);
+            const categories = item.categories;
+            if (categories.length === 0) {
+                throw new Error(`Cannot delete media ${id} — it has no category assigned.`);
+            }
+            else if (categories.length === 1) {
+                categoryId = categories[0];
+            }
+            else {
+                const catList = categories.join(', ');
+                throw new Error(`Media ${id} belongs to multiple categories (${catList}). ` +
+                    `Pass a categoryId to specify which category to delete from.`);
+            }
+        }
+        await this.httpClient.request({
+            method: 'DELETE',
+            path: `/media/category/${categoryId}/id/${id}/${language}`,
+        });
+    }
+    /**
+     * Permanently removes a media item. The item must be deleted (inactive) first.
+     */
+    async purge(id, options) {
+        const language = resolveLanguage(options?.language, 'en');
+        await this.httpClient.request({
+            method: 'POST',
+            path: '/content/purge',
+            body: {
+                languageCode: language,
+                contentIds: [String(id)],
+            },
+        });
+    }
+    /**
+     * Fetches and caches the media types.
+     */
+    getMediaTypes() {
+        if (!this.mediaTypesPromise || Date.now() > this.mediaTypesExpiresAt || this.mediaTypesEpoch < getCacheEpoch()) {
+            this.mediaTypesExpiresAt = Date.now() + DEFAULT_CACHE_TTL;
+            this.mediaTypesEpoch = getCacheEpoch();
+            this.mediaTypesPromise = this.httpClient.request({
+                method: 'GET',
+                path: '/mediaType',
+            });
+        }
+        return this.mediaTypesPromise;
+    }
+    /** Extracts the media type ID from the raw elements */
+    extractMediaTypeId(raw) {
+        for (const [key, value] of Object.entries(raw.elements ?? {})) {
+            if (key.toLowerCase().startsWith('mediatype#')) {
+                return typeof value === 'number' ? value : Number(value) || 0;
+            }
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=media-resource.js.map

package/dist/esm/resources/media-resource.js.map

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

package/dist/esm/resources/media-type-resource.d.ts

@@ -0,0 +1,70 @@
+import { HttpClient } from '../http-client.js';
+/** Layout (formatter) for a media type */
+export interface MediaTypeLayout {
+    name: string;
+    default: boolean;
+}
+/** Data exposed on a MediaType model */
+export interface MediaTypeData {
+    id: number;
+    name: string;
+    extensions: string[];
+    binary: boolean;
+    parseForTags: boolean;
+    maxSize: string | null;
+    layouts: MediaTypeLayout[];
+    defaultLayout: string;
+}
+/**
+ * A mutable media type object. Modify properties and call save() to persist.
+ */
+export declare class MediaType implements MediaTypeData {
+    readonly id: number;
+    name: string;
+    extensions: string[];
+    binary: boolean;
+    parseForTags: boolean;
+    maxSize: string | null;
+    layouts: MediaTypeLayout[];
+    defaultLayout: string;
+    private readonly _httpClient;
+    constructor(data: MediaTypeData, httpClient: HttpClient);
+    /** Persists current property values to the server via PUT. */
+    save(): Promise<void>;
+}
+/** Size input: number (bytes), string ('2 KB'), or null (unlimited) */
+type SizeInput = number | string | null;
+/**
+ * Resource for media type operations.
+ * Accessible via `t4.mediaTypes`.
+ */
+export declare class MediaTypeResource {
+    private readonly httpClient;
+    constructor(httpClient: HttpClient);
+    /** Lists all media types. */
+    list(): Promise<MediaType[]>;
+    /** Gets a single media type by ID. Returns a mutable MediaType object. */
+    get(id: number): Promise<MediaType>;
+    /** Updates a media type's properties (immutable pattern). */
+    update(id: number, data: {
+        name?: string;
+        extensions?: string[];
+        binary?: boolean;
+        parseForTags?: boolean;
+        maxSize?: SizeInput;
+        layouts?: MediaTypeLayout[];
+        defaultLayout?: string;
+    }): Promise<MediaType>;
+    /** Creates a new media type. */
+    create(data: {
+        name: string;
+        extensions: string[];
+        binary: boolean;
+        parseForTags?: boolean;
+        maxSize?: SizeInput;
+        layouts: MediaTypeLayout[];
+        defaultLayout?: string;
+    }): Promise<MediaType>;
+}
+export {};
+//# sourceMappingURL=media-type-resource.d.ts.map

package/dist/esm/resources/media-type-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-type-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/media-type-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AA0BD,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAwDD;;GAEG;AACH,qBAAa,SAAU,YAAW,aAAa;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU;IAYvD,8DAA8D;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B5B;AAED,uEAAuE;AACvE,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAExC;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,UAAU,EAAE,UAAU;IAIlC,6BAA6B;IACvB,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAQlC,0EAA0E;IACpE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAQzC,6DAA6D;IACvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,SAAS,CAAC;QACpB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,SAAS,CAAC;IAatB,gCAAgC;IAC1B,MAAM,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,EAAE,OAAO,CAAC;QAChB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,SAAS,CAAC;QACpB,OAAO,EAAE,eAAe,EAAE,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,SAAS,CAAC;CAsDvB"}