@hamak/shared-utils 0.4.1

package/dist/core-utils-chrono.d.ts

@@ -0,0 +1,8 @@
+export declare class Chronometre {
+    private start;
+    constructor();
+    duration(): number;
+    restart(): number;
+}
+export declare function chronometre(): Chronometre;
+//# sourceMappingURL=core-utils-chrono.d.ts.map

package/dist/core-utils-chrono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-chrono.d.ts","sourceRoot":"","sources":["../src/core-utils-chrono.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAS;;IAKtB,QAAQ,IAAK,MAAM;IAInB,OAAO,IAAK,MAAM;CAMnB;AAED,wBAAgB,WAAW,gBAE1B"}

package/dist/core-utils-chrono.js

@@ -0,0 +1,16 @@
+export class Chronometre {
+    constructor() {
+        this.start = Date.now();
+    }
+    duration() {
+        return Date.now() - this.start;
+    }
+    restart() {
+        const d = this.duration();
+        this.start = Date.now();
+        return d;
+    }
+}
+export function chronometre() {
+    return new Chronometre();
+}

package/dist/core-utils-comparator.d.ts

@@ -0,0 +1,11 @@
+export type Order = -1 | 0 | 1;
+export type Weighted<T, W> = {
+    value: T;
+    weight: W;
+};
+export type WeightFn<T> = (t: T) => number;
+export type CompareFn<T> = (a: T, b: T, ...fns: [WeightFn<T>, ...WeightFn<T>[]]) => Order;
+export declare function reverseOrder<T>(compareFn: CompareFn<T>): CompareFn<T>;
+export declare function compare<T>(a: T, b: T, ...fns: WeightFn<T>[]): Order;
+export declare const compareDesc: <T>(a: T, b: T, fns_0: WeightFn<T>, ...fns_1: WeightFn<T>[]) => Order;
+//# sourceMappingURL=core-utils-comparator.d.ts.map

package/dist/core-utils-comparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-comparator.d.ts","sourceRoot":"","sources":["../src/core-utils-comparator.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAC9B,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAC,CAAA;AAClD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,EAAG,CAAC,KAAK,MAAM,CAAA;AAC3C,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,EAAG,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,GAAG,GAAG,EAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,KAAK,CAAA;AAC5F,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAG,SAAS,CAAC,CAAC,CAAC,GAAI,SAAS,CAAC,CAAC,CAAC,CAEvE;AACD,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,GAAG,GAAG,EAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAI,KAAK,CAiBvE;AAED,eAAO,MAAM,WAAW,kEAvB+D,KAuBvC,CAAA"}

package/dist/core-utils-comparator.js

@@ -0,0 +1,22 @@
+export function reverseOrder(compareFn) {
+    return (a, b, fns) => -compareFn(a, b, fns);
+}
+export function compare(a, b, ...fns) {
+    if (fns.length === 0) {
+        if (typeof a === "number" && typeof b === "number") {
+            fns = [(x) => x];
+        }
+        else {
+            throw new Error(`Expecting at least one weight function when arguments are not numbers`);
+        }
+    }
+    for (const weightFn of fns) {
+        const aWeight = weightFn(a);
+        const bWeight = weightFn(b);
+        if (aWeight != bWeight) {
+            return a < b ? -1 : 1;
+        }
+    }
+    return 0;
+}
+export const compareDesc = reverseOrder(compare);

package/dist/core-utils-file.d.ts

@@ -0,0 +1,10 @@
+export interface FileInfo {
+    name: string;
+    path: string;
+    isDirectory: boolean;
+    size: number;
+    createdAt: Date;
+    updatedAt: Date;
+    content?: string;
+}
+//# sourceMappingURL=core-utils-file.d.ts.map

package/dist/core-utils-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-file.d.ts","sourceRoot":"","sources":["../src/core-utils-file.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/core-utils-file.js

@@ -0,0 +1 @@
+export {};

package/dist/core-utils-filesystem.d.ts

@@ -0,0 +1,69 @@
+import { Path, Pathway } from './core-utils-pathway';
+import { Holder } from './core-utils-types';
+import { PathwayResolver } from './core-utils-pathway-resolver';
+export type FileContentSchema = string | {
+    schemaObject: string;
+    namespace?: string;
+};
+export interface FileSystemState {
+    root: DirectoryNode;
+}
+export interface FileMemoState {
+    originalContent: Holder;
+    modified: boolean;
+}
+export interface FileSystemNodeState {
+    contentLoaded: boolean;
+    contentLoading: boolean;
+    contentLoadError?: {
+        code?: string;
+        message?: string;
+    };
+    memo?: FileMemoState;
+    contentHistory: any[];
+    extensionStates: Record<string, unknown>;
+}
+export declare function fileSystemNodeInitialState(contentPresent?: boolean): FileSystemNodeState;
+export interface FileSystemNodeBase {
+    type: 'directory' | 'file';
+    name: string;
+    state: FileSystemNodeState;
+}
+export interface DirectoryNode extends FileSystemNodeBase {
+    type: 'directory';
+    children: Record<string, FileSystemNode>;
+}
+export interface FileNode<T = any> extends FileSystemNodeBase {
+    type: 'file';
+    content: T;
+    schema: string | FileContentSchema;
+}
+export type FileSystemNode = DirectoryNode | FileNode;
+export declare class DirectoryNodePathwayResolver implements PathwayResolver<FileSystemNode> {
+    readonly root: FileSystemNode;
+    constructor(root: FileSystemNode);
+    resolve(path: string | Pathway | string[]): FileSystemNode | undefined;
+    changeDIr(path: Path): DirectoryNodePathwayResolver;
+}
+declare class FilesystemUtil {
+    createRootDir(children: FileSystemNode[], state?: FileSystemNodeState): DirectoryNode;
+    createDir(name: string, children: FileSystemNode[], state?: FileSystemNodeState): DirectoryNode;
+    createDirs(path: Path, children: FileSystemNode[], state?: FileSystemNodeState): DirectoryNode;
+    createFile(name: string, content: any, schema?: string, state?: FileSystemNodeState): FileNode;
+    resolveFileNode(fromDir: FileSystemNode | undefined, path: Path): FileSystemNode | undefined;
+    asFile<T = any>(fsn: FileSystemNode | undefined): FileNode<T> | undefined;
+    asDirectory(fsn: FileSystemNode | undefined): DirectoryNode | undefined;
+    resolveDescendent(fromDir: FileSystemNode | undefined, path: Path): FileSystemNode | undefined;
+    /**
+     * Set a file node content a specified location. It create intermediary directories and target if missed location.
+     * @param fromDir
+     * @param path
+     * @param content
+     * @param schema
+     * @param state
+     */
+    createDescendent(fromDir: FileSystemNode | undefined, path: Path, content: any, schema?: string, state?: FileSystemNodeState, override?: boolean): FileNode | undefined;
+}
+export declare const fsutils: FilesystemUtil;
+export {};
+//# sourceMappingURL=core-utils-filesystem.d.ts.map

package/dist/core-utils-filesystem.d.ts.map

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

package/dist/core-utils-filesystem.js

@@ -0,0 +1,156 @@
+import { Pathway } from './core-utils-pathway';
+export function fileSystemNodeInitialState(contentPresent = true) {
+    return {
+        contentLoaded: contentPresent,
+        contentLoading: false,
+        contentLoadError: undefined,
+        contentHistory: [],
+        extensionStates: {}
+    };
+}
+function isRoot(node) {
+    switch (node.type) {
+        case "directory": {
+            return node.name === null || node.name === undefined || node.name.trim() === "" || node.name.trim() === "/";
+        }
+        case "file": {
+            return false;
+        }
+    }
+}
+export class DirectoryNodePathwayResolver {
+    constructor(root) {
+        this.root = root;
+    }
+    resolve(path) {
+        return fsutils.resolveFileNode(this.root, path);
+    }
+    changeDIr(path) {
+        const fileNode = this.resolve(path);
+        if (fileNode === undefined) {
+            throw new Error(`No such directory: ${Pathway.asString(path)}`);
+        }
+        else {
+            switch (fileNode.type) {
+                case "directory": return new DirectoryNodePathwayResolver(fileNode);
+                case "file": throw new Error(`Path is not directory: ${Pathway.asString(path)}`);
+            }
+        }
+    }
+}
+class FilesystemUtil {
+    createRootDir(children, state = fileSystemNodeInitialState()) {
+        return this.createDir("", children, state);
+    }
+    createDir(name, children, state = fileSystemNodeInitialState()) {
+        return {
+            type: "directory", name, state,
+            children: children.reduce((acc, child) => ({ ...acc, [child.name]: child }), {})
+        };
+    }
+    createDirs(path, children, state = fileSystemNodeInitialState()) {
+        const pathway = Pathway.of(path);
+        const dir = pathway.getSegments().reverse().reduce((acc, segment) => {
+            return this.createDir(segment, acc === undefined ? children : [acc]);
+        }, undefined);
+        if (dir === undefined) {
+            throw new Error(`Unable de create dir '${path}'`);
+        }
+        return pathway.isAbsolute() ? this.createRootDir([dir]) : dir;
+    }
+    createFile(name, content, schema = "xs:any", state = fileSystemNodeInitialState()) {
+        return { type: "file", name, content, schema, state };
+    }
+    resolveFileNode(fromDir, path) {
+        if (fromDir === undefined) {
+            return undefined;
+        }
+        const pathway = Pathway.of(path);
+        if (pathway.isAbsolute() && !isRoot(fromDir)) {
+            return undefined;
+        }
+        const result = pathway.getSegments().reduce((acc, segment) => {
+            if (acc === undefined) {
+                return undefined;
+            }
+            else {
+                switch (acc.type) {
+                    case "directory":
+                        {
+                            return acc.children?.[segment];
+                        }
+                        break;
+                    case "file":
+                        {
+                            return undefined;
+                        }
+                        break;
+                    default: {
+                        return undefined;
+                    }
+                }
+            }
+        }, fromDir);
+        return result;
+    }
+    asFile(fsn) {
+        return fsn?.type === "file" ? fsn : undefined;
+    }
+    asDirectory(fsn) {
+        return fsn?.type === "directory" ? fsn : undefined;
+    }
+    resolveDescendent(fromDir, path) {
+        const pathway = Pathway.of(path);
+        return pathway.isCurrentDir() ? undefined : this.resolveFileNode(fromDir, pathway);
+    }
+    /**
+     * Set a file node content a specified location. It create intermediary directories and target if missed location.
+     * @param fromDir
+     * @param path
+     * @param content
+     * @param schema
+     * @param state
+     */
+    createDescendent(fromDir, path, content, schema = "xs:any", state = fileSystemNodeInitialState(), override = false) {
+        if (!fromDir)
+            return undefined;
+        const pathway = Pathway.of(path);
+        if (pathway.isCurrentDir())
+            return undefined;
+        const segments = pathway.getSegments();
+        if (segments.length === 0)
+            return undefined;
+        if (fromDir.type !== "directory") {
+            throw new Error("Cannot create descendent on a non-directory node.");
+        }
+        let currentDir = fromDir;
+        for (let i = 0; i < segments.length - 1; i++) {
+            const segment = segments[i];
+            let nextNode = currentDir.children[segment];
+            if (!nextNode) {
+                // Create intermediate directory
+                const newDir = this.createDir(segment, []);
+                currentDir.children[segment] = newDir;
+                nextNode = newDir;
+            }
+            if (nextNode.type !== "directory") {
+                throw new Error(`Path conflict: '${segment}' is a file, expected a directory.`);
+            }
+            currentDir = nextNode;
+        }
+        const fileName = segments[segments.length - 1];
+        const existingNode = currentDir.children[fileName];
+        if (existingNode) {
+            if (existingNode.type !== "file") {
+                throw new Error(`Path conflict: '${fileName}' exists and is not a file.`);
+            }
+            if (!override) {
+                throw new Error(`File '${fileName}' already exists and override is disabled.`);
+            }
+        }
+        const fileNode = this.createFile(fileName, content, schema, state);
+        currentDir.children[fileName] = fileNode;
+        return fileNode;
+    }
+}
+export const fsutils = new FilesystemUtil();

package/dist/core-utils-fqn.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unresolved qualified name by either namespace of prefix
+ */
+export declare class LexicalQualifiedName {
+    readonly namespace: string | undefined;
+    readonly prefix: string | undefined;
+    readonly name: string;
+    constructor(namespace: string | undefined, prefix: string | undefined, name: string);
+    isEqualTo(other: LexicalQualifiedName): boolean;
+}
+//# sourceMappingURL=core-utils-fqn.d.ts.map

package/dist/core-utils-fqn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-fqn.d.ts","sourceRoot":"","sources":["../src/core-utils-fqn.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,oBAAoB;aACH,SAAS,EAAE,MAAM,GAAG,SAAS;aAAkB,MAAM,EAAG,MAAM,GAAG,SAAS;aAAkB,IAAI,EAAG,MAAM;gBAAzG,SAAS,EAAE,MAAM,GAAG,SAAS,EAAkB,MAAM,EAAG,MAAM,GAAG,SAAS,EAAkB,IAAI,EAAG,MAAM;IAGrI,SAAS,CAAC,KAAK,EAAG,oBAAoB,GAAI,OAAO;CASlD"}

package/dist/core-utils-fqn.js

@@ -0,0 +1,19 @@
+/**
+ * Unresolved qualified name by either namespace of prefix
+ */
+export class LexicalQualifiedName {
+    constructor(namespace, prefix, name) {
+        this.namespace = namespace;
+        this.prefix = prefix;
+        this.name = name;
+    }
+    isEqualTo(other) {
+        if ((this.name === undefined && other.name === undefined)
+            || (this.name === null && other.name === null)) {
+            return false;
+        }
+        else {
+            return this.namespace === other.namespace && this.prefix === other.prefix && this.name === other.name;
+        }
+    }
+}

package/dist/core-utils-pathway-resolver.d.ts

@@ -0,0 +1,20 @@
+import { Path, Pathway } from "./core-utils-pathway";
+export interface PathwayResolver<T> {
+    resolve(path: string | string[] | Pathway): T | undefined;
+}
+export declare class RecordPathwayResolver<T> implements PathwayResolver<T> {
+    readonly record: Record<string, T>;
+    constructor(record: Record<string, T>);
+    resolve(path: string | string[] | Pathway): T | undefined;
+}
+export declare class EmptyPathwayResolver<T> implements PathwayResolver<T> {
+    resolve(path: string | string[] | Pathway): T | undefined;
+}
+export declare class RelativePathwayResolver<T> implements PathwayResolver<T> {
+    readonly parentResolver: PathwayResolver<T>;
+    readonly path: Path;
+    private relativePathway;
+    constructor(parentResolver: PathwayResolver<T>, path: Path);
+    resolve(path: string | string[] | Pathway): T | undefined;
+}
+//# sourceMappingURL=core-utils-pathway-resolver.d.ts.map

package/dist/core-utils-pathway-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-pathway-resolver.d.ts","sourceRoot":"","sources":["../src/core-utils-pathway-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,EAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAI,CAAC,GAAG,SAAS,CAAA;CAC5D;AAED,qBAAa,qBAAqB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAA1B,MAAM,EAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAG/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,GAAG,SAAS;CAI1D;AAED,qBAAa,oBAAoB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,GAAG,SAAS;CAG1D;AAED,qBAAa,uBAAuB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAEvD,QAAQ,CAAC,cAAc,EAAG,eAAe,CAAC,CAAC,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAG,IAAI;IAD9E,OAAO,CAAC,eAAe,CAAU;gBACZ,cAAc,EAAG,eAAe,CAAC,CAAC,CAAC,EAAW,IAAI,EAAG,IAAI;IAG9E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,GAAG,SAAS;CAQ1D"}

package/dist/core-utils-pathway-resolver.js

@@ -0,0 +1,31 @@
+import { Pathway } from "./core-utils-pathway";
+export class RecordPathwayResolver {
+    constructor(record) {
+        this.record = record;
+    }
+    resolve(path) {
+        const key = Pathway.asString(path);
+        return this.record[key];
+    }
+}
+export class EmptyPathwayResolver {
+    resolve(path) {
+        return undefined;
+    }
+}
+export class RelativePathwayResolver {
+    constructor(parentResolver, path) {
+        this.parentResolver = parentResolver;
+        this.path = path;
+        this.relativePathway = Pathway.of(path);
+    }
+    resolve(path) {
+        const pathway = Pathway.of(path);
+        if (pathway.isAbsolute()) {
+            return this.parentResolver.resolve(path);
+        }
+        else {
+            return this.parentResolver.resolve(this.relativePathway.resolve(pathway));
+        }
+    }
+}

package/dist/core-utils-pathway.d.ts

@@ -0,0 +1,84 @@
+export type Path = string | string[] | Pathway;
+/**
+ * Class representing a normalized pathway.
+ */
+export declare class Pathway {
+    private segments;
+    private isAbsolutePath;
+    /**
+     * Creates a Pathway instance.
+     * @param path - The pathway to normalize, either as a string or an array of strings.
+     *                An empty array or "." represents the current directory.
+     */
+    constructor(path: string | string[] | null | undefined);
+    /**
+     * Factory method to create a Pathway instance.
+     * @param path - The pathway to normalize, either as a string or an array of strings.
+     * @returns A new Pathway instance.
+     */
+    static of(path: string | string[] | null | undefined | Pathway): Pathway;
+    /**
+     * Normalizes a pathway by converting it into an array of segments.
+     * @param path - The pathway to normalize, either as a string or an array of strings.
+     * @returns An array of normalized path segments, or an empty array if the input is null or undefined.
+     */
+    private normalizePath;
+    /**
+     * Returns the normalized path segments.
+     * @returns An array of normalized path segments.
+     */
+    getSegments(): string[];
+    isCurrentDir(): boolean;
+    /**
+     * Converts the normalized path segments back to a string.
+     * @returns The normalized path as a string.
+     */
+    toString(): string;
+    /**
+     * Checks if the pathway is absolute.
+     * @returns True if the pathway is absolute, false otherwise.
+     */
+    isAbsolute(): boolean;
+    /**
+     * Checks if the pathway is relative.
+     * @returns True if the pathway is relative, false otherwise.
+     */
+    isRelative(): boolean;
+    /**
+     * Resolves the current pathway with another pathway or string.
+     * @param otherPath - The other pathway or string to resolve against.
+     * @returns A new Pathway instance representing the resolved path.
+     */
+    resolve(otherPath: Pathway | string | string[]): Pathway;
+    /**
+     * Gets the parent directory of the current pathway.
+     * @returns A new Pathway instance representing the parent directory.
+     */
+    getParent(): Pathway;
+    /**
+     * Gets the current directory of the pathway.
+     * @returns The current directory as a string.
+     */
+    getCurrentDirectory(): string;
+    /**
+     * Static method to get the absolute path of the root.
+     * @returns A new Pathway instance representing the root path.
+     */
+    static ofRoot(): Pathway;
+    /**
+     * Determines the relative path from this pathway to another pathway.
+     * @param otherPath - The other pathway to relativize against.
+     * @returns A new Pathway instance representing the relative path.
+     */
+    relativize(otherPath: Pathway | string | string[]): Pathway;
+    /**
+     * Checks if the given path is a descendant of the current pathway.
+     * @param otherPath - The other pathway to check.
+     * @returns True if the given path is a descendant, false otherwise.
+     */
+    isDescendant(otherPath: Pathway | string | string[]): boolean;
+    static isRelativePath(path: Path): boolean;
+    static asString(path: Path): string;
+    static getName(path: string | string[] | Pathway): string;
+}
+//# sourceMappingURL=core-utils-pathway.d.ts.map

package/dist/core-utils-pathway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-pathway.d.ts","sourceRoot":"","sources":["../src/core-utils-pathway.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAA;AAC9C;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,cAAc,CAAU;IAEhC;;;;OAIG;gBACS,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS;IAUtD;;;;OAIG;WACW,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO;IAQ/E;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;OAGG;IACI,WAAW,IAAI,MAAM,EAAE;IAIvB,YAAY;IAInB;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;OAGG;IACI,UAAU,IAAI,OAAO;IAI5B;;;OAGG;IACI,UAAU,IAAI,OAAO;IAI5B;;;;OAIG;IACI,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAuB/D;;;OAGG;IACI,SAAS,IAAI,OAAO;IAQ3B;;;OAGG;IACI,mBAAmB,IAAI,MAAM;IAOpC;;;OAGG;WACW,MAAM,IAAI,OAAO;IAI/B;;;;OAIG;IACI,UAAU,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAsBlE;;;;OAIG;IACI,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAiBpE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAG,IAAI,GAAI,OAAO;IAK5C,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,IAAI,GAAI,MAAM;IASrC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;CAgBjD"}