@terminalfour/terminalfour-js 1.0.0-rc.1

package/dist/cjs/media-category-ref.d.ts

@@ -0,0 +1,78 @@
+import { HttpClient } from './http-client.js';
+import { LanguageOption } from './types.js';
+import { MediaCategoryItem } from './models/media-category-item.js';
+/** A media item as returned from the category list endpoint */
+export interface MediaListItem {
+    id: number;
+    name: string;
+    description: string;
+    fileName: string;
+    fileSize: string;
+    mediaType: string;
+    language: string;
+    version: string;
+    status: string;
+    lastModified: Date | null;
+}
+/**
+ * A media category reference scoped to a specific category ID.
+ * Provides listing of media items within the category.
+ *
+ * Usage: `t4.mediaCategory(367).list()`
+ */
+export declare class MediaCategoryRef {
+    private readonly httpClient;
+    private readonly categoryId;
+    constructor(httpClient: HttpClient, categoryId: number);
+    /**
+     * Returns a mutable media category object. Modify properties and call save() to persist.
+     */
+    get(options?: LanguageOption): Promise<MediaCategoryItem>;
+    /**
+     * Lists direct child categories (one level below).
+     */
+    subcategories(options?: LanguageOption): Promise<Array<{
+        id: number;
+        name: string;
+        lastModified: Date | null;
+    }>>;
+    /**
+     * Updates this media category's name. Fetches the current category,
+     * merges the change, and PUTs the full body back.
+     * Returns the updated MediaCategoryItem.
+     */
+    update(data: {
+        name: string;
+    }, options?: LanguageOption): Promise<MediaCategoryItem>;
+    /**
+     * Deletes this media category.
+     */
+    delete(): Promise<void>;
+    /**
+     * Permanently removes this media category.
+     * Call delete() first to deactivate it, then purge() to remove it entirely.
+     */
+    purge(options?: LanguageOption): Promise<void>;
+    /**
+     * Moves this media category under a new parent category.
+     */
+    move(newParentId: number, options?: LanguageOption): Promise<void>;
+    /**
+     * Creates a child media category under this category.
+     * Returns the created child as a mutable MediaCategoryItem.
+     */
+    addCategory(data: {
+        name: string;
+    }, options?: LanguageOption): Promise<MediaCategoryItem>;
+    /**
+     * Lists all media items in this category.
+     * Fetches all items in a single request (up to 10000).
+     */
+    list(options?: LanguageOption): Promise<MediaListItem[]>;
+    /**
+     * Builds the DataTables form body for the list endpoint.
+     * Uses a minimal column definition and requests all items.
+     */
+    private buildListFormBody;
+}
+//# sourceMappingURL=media-category-ref.d.ts.map

package/dist/cjs/media-category-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-category-ref.d.ts","sourceRoot":"","sources":["../../src/media-category-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAapE,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AA4BD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM;IAKtD;;OAEG;IACG,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAS/D;;OAEG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAatH;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwB1F;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;;OAGG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpD;;OAEG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IASxE;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2B/F;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA4B9D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAyB1B"}

package/dist/cjs/media-category-ref.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaCategoryRef = void 0;
+const utils_js_1 = require("./utils.js");
+const media_category_item_js_1 = require("./models/media-category-item.js");
+/**
+ * A media category reference scoped to a specific category ID.
+ * Provides listing of media items within the category.
+ *
+ * Usage: `t4.mediaCategory(367).list()`
+ */
+class MediaCategoryRef {
+    constructor(httpClient, categoryId) {
+        this.httpClient = httpClient;
+        this.categoryId = categoryId;
+    }
+    /**
+     * Returns a mutable media category object. Modify properties and call save() to persist.
+     */
+    async get(options) {
+        const language = (0, utils_js_1.resolveLanguage)(options?.language, 'en');
+        const raw = await this.httpClient.request({
+            method: 'GET',
+            path: `/mediacategory/${this.categoryId}/${language}`,
+        });
+        return new media_category_item_js_1.MediaCategoryItem(raw, this.httpClient, language);
+    }
+    /**
+     * Lists direct child categories (one level below).
+     */
+    async subcategories(options) {
+        const language = (0, utils_js_1.resolveLanguage)(options?.language, 'en');
+        const response = await this.httpClient.request({
+            method: 'GET',
+            path: `/hierarchy/${this.categoryId}/${language}/subsections?showAll=false&removeNonTranslated=false`,
+        });
+        return (response.children ?? []).map((child) => ({
+            id: child.id,
+            name: child.name,
+            lastModified: child.lastModified ? new Date(child.lastModified) : null,
+        }));
+    }
+    /**
+     * Updates this media category's name. Fetches the current category,
+     * merges the change, and PUTs the full body back.
+     * Returns the updated MediaCategoryItem.
+     */
+    async update(data, options) {
+        if (!data.name?.trim()) {
+            throw new Error('Media category name is required');
+        }
+        const language = (0, utils_js_1.resolveLanguage)(options?.language, 'en');
+        const category = await this.httpClient.request({
+            method: 'GET',
+            path: `/mediacategory/${this.categoryId}/${language}`,
+        });
+        await this.httpClient.request({
+            method: 'PUT',
+            path: `/mediacategory/${this.categoryId}/${language}`,
+            body: {
+                ...category,
+                name: data.name,
+            },
+        });
+        return this.get(options);
+    }
+    /**
+     * Deletes this media category.
+     */
+    async delete() {
+        await this.httpClient.request({
+            method: 'DELETE',
+            path: `/mediacategory/${this.categoryId}`,
+        });
+    }
+    /**
+     * Permanently removes this media category.
+     * Call delete() first to deactivate it, then purge() to remove it entirely.
+     */
+    async purge(options) {
+        const language = (0, utils_js_1.resolveLanguage)(options?.language, 'en');
+        await this.httpClient.request({
+            method: 'POST',
+            path: '/hierarchy/purge',
+            body: {
+                languageCode: language,
+                contentIds: [String(this.categoryId)],
+            },
+        });
+    }
+    /**
+     * Moves this media category under a new parent category.
+     */
+    async move(newParentId, options) {
+        const language = (0, utils_js_1.resolveLanguage)(options?.language, 'en');
+        await this.httpClient.request({
+            method: 'MOVE',
+            path: `/mediacategory/${this.categoryId}/${newParentId}/${language}`,
+            body: {},
+        });
+    }
+    /**
+     * Creates a child media category under this category.
+     * Returns the created child as a mutable MediaCategoryItem.
+     */
+    async addCategory(data, options) {
+        if (!data.name?.trim()) {
+            throw new Error('Media category name is required');
+        }
+        const language = (0, utils_js_1.resolveLanguage)(options?.language, 'en');
+        const raw = await this.httpClient.request({
+            method: 'POST',
+            path: `/mediacategory/${language}`,
+            body: {
+                parent: String(this.categoryId),
+                name: data.name,
+                description: '',
+                status: '0',
+                workflow: '-2',
+                show: false,
+                eForm: false,
+                archive: false,
+                'output-uri': '',
+            },
+        });
+        const childRef = new MediaCategoryRef(this.httpClient, raw.id);
+        return childRef.get(options);
+    }
+    /**
+     * Lists all media items in this category.
+     * Fetches all items in a single request (up to 10000).
+     */
+    async list(options) {
+        const language = (0, utils_js_1.resolveLanguage)(options?.language, 'en');
+        const formBody = this.buildListFormBody();
+        const response = await this.httpClient.request({
+            method: 'POST',
+            path: `/media/category/${this.categoryId}/${language}/list?showPending=true&showUntranslated=true`,
+            body: formBody,
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+        });
+        return (response.mediaRows ?? []).map((row) => ({
+            id: row.id,
+            name: row.name,
+            description: row.description ?? '',
+            fileName: row.fileName,
+            fileSize: (0, utils_js_1.formatFileSize)(row.fileSize ?? 0),
+            mediaType: row.mediaTypeName,
+            language: row.binaryLanguage ?? row.language,
+            version: row.version,
+            status: utils_js_1.STATUS_MAP[row.status] ?? `unknown (${row.status})`,
+            lastModified: row.lastModified ? new Date(row.lastModified) : null,
+        }));
+    }
+    /**
+     * Builds the DataTables form body for the list endpoint.
+     * Uses a minimal column definition and requests all items.
+     */
+    buildListFormBody() {
+        const params = new URLSearchParams();
+        params.set('draw', '1');
+        params.set('start', '0');
+        params.set('length', '10000');
+        params.set('search[value]', '');
+        params.set('search[regex]', 'false');
+        // Define the 8 columns the API expects
+        for (let i = 0; i < 8; i++) {
+            params.set(`columns[${i}][data]`, String(i));
+            params.set(`columns[${i}][name]`, '');
+            params.set(`columns[${i}][searchable]`, 'true');
+            params.set(`columns[${i}][orderable]`, i >= 1 && i <= 5 ? 'true' : 'false');
+            params.set(`columns[${i}][search][value]`, '');
+            params.set(`columns[${i}][search][regex]`, 'false');
+        }
+        // Sort by lastModified (column 5) descending
+        params.set('order[0][column]', '5');
+        params.set('order[0][dir]', 'desc');
+        return params.toString();
+    }
+}
+exports.MediaCategoryRef = MediaCategoryRef;
+//# sourceMappingURL=media-category-ref.js.map

package/dist/cjs/media-category-ref.js.map

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

package/dist/cjs/media-library.d.ts

@@ -0,0 +1,30 @@
+import { HttpClient } from './http-client.js';
+import { LanguageOption } from './types.js';
+/** A node in the media category tree */
+export interface MediaCategoryNode {
+    id: number;
+    name: string;
+    children?: MediaCategoryNode[];
+}
+/**
+ * Provides operations on the media library as a whole.
+ */
+export declare class MediaLibrary {
+    private readonly httpClient;
+    private rootIdPromise;
+    private rootIdExpiresAt;
+    private rootIdEpoch;
+    constructor(httpClient: HttpClient);
+    /**
+     * Returns the full media category tree.
+     * Fetches the media library root, then retrieves the complete tree structure.
+     */
+    tree(options?: LanguageOption & {
+        depth?: number;
+    }): Promise<MediaCategoryNode>;
+    /** Fetches and caches the media library root section ID */
+    private getRootId;
+    /** Recursively maps API tree nodes to clean MediaCategoryNode objects */
+    private mapNode;
+}
+//# sourceMappingURL=media-library.d.ts.map

package/dist/cjs/media-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-library.d.ts","sourceRoot":"","sources":["../../src/media-library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAoBD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,WAAW,CAAM;gBAEb,UAAU,EAAE,UAAU;IAIlC;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuCrF,2DAA2D;IAC3D,OAAO,CAAC,SAAS;IAYjB,yEAAyE;IACzE,OAAO,CAAC,OAAO;CAWhB"}

package/dist/cjs/media-library.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaLibrary = void 0;
+const utils_js_1 = require("./utils.js");
+/**
+ * Provides operations on the media library as a whole.
+ */
+class MediaLibrary {
+    constructor(httpClient) {
+        this.rootIdPromise = null;
+        this.rootIdExpiresAt = 0;
+        this.rootIdEpoch = -1;
+        this.httpClient = httpClient;
+    }
+    /**
+     * Returns the full media category tree.
+     * Fetches the media library root, then retrieves the complete tree structure.
+     */
+    async tree(options) {
+        const language = (0, utils_js_1.resolveLanguage)(options?.language, 'en');
+        const depth = options?.depth ?? 30;
+        const rootId = await this.getRootId();
+        // Get the single child of the root (the "Categorised" node)
+        const subsResponse = await this.httpClient.request({
+            method: 'GET',
+            path: `/hierarchy/${rootId}/${language}/subsections?showAll=false&removeNonTranslated=false`,
+        });
+        const topChild = (subsResponse.children ?? [])[0];
+        if (!topChild) {
+            return { id: rootId, name: 'Media Library' };
+        }
+        // Fetch the full tree from the top child
+        const treeResponse = await this.httpClient.request({
+            method: 'POST',
+            path: '/mediacategory',
+            body: {
+                category: { id: topChild.id, language },
+                recursionDepth: depth,
+                explode: false,
+                activeNode: -1,
+                showInactive: false,
+                showMyMedia: false,
+            },
+        });
+        const rootNode = treeResponse[0];
+        if (!rootNode) {
+            return { id: topChild.id, name: topChild.name };
+        }
+        return this.mapNode(rootNode);
+    }
+    /** Fetches and caches the media library root section ID */
+    getRootId() {
+        if (!this.rootIdPromise || Date.now() > this.rootIdExpiresAt || this.rootIdEpoch < (0, utils_js_1.getCacheEpoch)()) {
+            this.rootIdExpiresAt = Date.now() + utils_js_1.DEFAULT_CACHE_TTL;
+            this.rootIdEpoch = (0, utils_js_1.getCacheEpoch)();
+            this.rootIdPromise = this.httpClient.request({
+                method: 'GET',
+                path: '/config/mediaLibrary.section',
+            }).then((config) => Number(config.value));
+        }
+        return this.rootIdPromise;
+    }
+    /** Recursively maps API tree nodes to clean MediaCategoryNode objects */
+    mapNode(node) {
+        const children = (node.children ?? []).map((child) => this.mapNode(child));
+        const result = {
+            id: node.id,
+            name: (0, utils_js_1.decodeHtmlEntities)(node.name),
+        };
+        if (children.length > 0) {
+            result.children = children;
+        }
+        return result;
+    }
+}
+exports.MediaLibrary = MediaLibrary;
+//# sourceMappingURL=media-library.js.map

package/dist/cjs/media-library.js.map

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

package/dist/cjs/models/content-item.d.ts

@@ -0,0 +1,80 @@
+import { ContentDTO } from '../types.js';
+import { HttpClient } from '../http-client.js';
+import { ElementResolver, TemplateElement } from '../element-resolver.js';
+import { TypeRegistry } from '../type-registry.js';
+/** Symbol used to restrict _init() access to the factory function in this module */
+declare const INIT: unique symbol;
+/** Clears the group cache for a specific HttpClient instance */
+export declare function clearGroupCache(httpClient: HttpClient): void;
+/**
+ * A mutable content item that exposes read-only metadata and mutable fields.
+ * Fields use friendly names and human-readable list values.
+ * Call save() to persist field changes back to the server.
+ *
+ * When returned from `content.list()`, this is a summary object — only metadata
+ * properties are populated. The `fields` property is not present. Use
+ * `content.get(id)` to retrieve a full item with resolved fields.
+ */
+export declare class ContentItem {
+    readonly id: number;
+    name: string;
+    readonly contentTypeID: number;
+    readonly language: string;
+    readonly version: number;
+    readonly lastModified: Date | null;
+    publishDate: Date | null;
+    expiryDate: Date | null;
+    reviewDate: Date | null;
+    /** Section ID where expired content is archived. `null` if not set. */
+    archiveSection: number | null;
+    /** Resolved fields with friendly names. Not present on summary items from `content.list()`. */
+    fields: Record<string, unknown>;
+    private readonly _httpClient;
+    private readonly _sectionId;
+    private readonly _resolver;
+    private readonly _templateElements;
+    private readonly _typeRegistry;
+    private _keyMap;
+    private _rawDTO;
+    private _status;
+    private _statusDirty;
+    private _dirtyFields;
+    get status(): string;
+    set status(value: string);
+    constructor(data: ContentDTO, httpClient: HttpClient, sectionId: number, resolver?: ElementResolver | null, templateElements?: TemplateElement[] | null, typeRegistry?: TypeRegistry | null);
+    /** Includes getter-based properties (status) in JSON serialisation. */
+    toJSON(): Record<string, unknown>;
+    /** @internal Async initialization — resolves friendly field values. Only callable via the factory. */
+    [INIT](data: ContentDTO): Promise<void>;
+    /**
+     * Persists field and property changes back to the server.
+     *
+     * Status defaults to `'pending'` on save, matching T4's approval workflow
+     * where edits go back through review. To preserve the current status, set
+     * `item.status = 'approved'` before saving, or use `item.approve()` to
+     * save and approve in one step.
+     */
+    save(): Promise<void>;
+    /**
+     * Saves the content item with an approved status.
+     * Shorthand for setting `status = 'approved'` and calling `save()`.
+     * Throws if the content is already approved.
+     */
+    approve(): Promise<void>;
+    /**
+     * Duplicates this content item, optionally into a different section.
+     *
+     * - If `sectionId` is omitted, duplicates within the same section and automatically
+     *   appends `(n)` to the name to avoid collisions.
+     * - If `sectionId` is provided, duplicates into that section with the original name.
+     */
+    duplicate(sectionId?: number): Promise<void>;
+    /**
+     * Moves this content item to a different section.
+     */
+    move(sectionId: number): Promise<void>;
+}
+/** Factory function to create a ContentItem with async field resolution */
+export declare function createContentItem(data: ContentDTO, httpClient: HttpClient, sectionId: number, resolver?: ElementResolver | null, templateElements?: TemplateElement[] | null, typeRegistry?: TypeRegistry | null): Promise<ContentItem>;
+export {};
+//# sourceMappingURL=content-item.d.ts.map

package/dist/cjs/models/content-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-item.d.ts","sourceRoot":"","sources":["../../../src/models/content-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAkB,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,oFAAoF;AACpF,QAAA,MAAM,IAAI,eAA6B,CAAC;AA6JxC,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAE5D;AA0XD;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,uEAAuE;IACvE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+FAA+F;IAC/F,MAAM,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,YAAY,CAA0B;IAE9C,IAAI,MAAM,IAAI,MAAM,CAAyB;IAC7C,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAGvB;gBAGC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,EACjC,gBAAgB,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,EAC3C,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI;IAqCpC,uEAAuE;IACvE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASjC,sGAAsG;IAChG,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC7C;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0I3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;OAMG;IACG,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2ClD;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAW7C;AAED,2EAA2E;AAC3E,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,EACjC,gBAAgB,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,EAC3C,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,GACjC,OAAO,CAAC,WAAW,CAAC,CAItB"}