@harborclient/core 0.1.1

package/dist/collectionRunner.js

@@ -0,0 +1,296 @@
+/**
+ * Default collection runner settings for first launch and normalization fallbacks.
+ */
+export const DEFAULT_COLLECTION_RUNNER_CONFIG = {
+    delayMs: 0,
+    stopOnFailure: false,
+    environmentMode: 'active',
+    environmentId: null
+};
+/**
+ * Counts passed, failed, and skipped rows from a result list.
+ *
+ * @param results - Runner result rows, typically from a completed or imported run.
+ * @returns Summary counts for progress display and import hydration.
+ */
+export function summarizeRunnerResults(results) {
+    let passed = 0;
+    let failed = 0;
+    let skipped = 0;
+    for (const result of results) {
+        if (result.status === 'passed') {
+            passed += 1;
+        }
+        else if (result.status === 'failed') {
+            failed += 1;
+        }
+        else if (result.status === 'skipped') {
+            skipped += 1;
+        }
+    }
+    return { passed, failed, skipped };
+}
+/**
+ * Builds a portable run-results export from active runner state and resolved entity metadata.
+ *
+ * @param args - Runner configuration, target names, and completed result rows.
+ * @returns JSON-serializable export payload for save-to-disk.
+ */
+export function buildRunResultsExport(args) {
+    const isRequestRun = args.requestId != null;
+    const exportKind = isRequestRun
+        ? 'request-run-results'
+        : 'collection-run-results';
+    const payload = {
+        harborclientVersion: 1,
+        harborclientExport: exportKind,
+        delay: args.delayMs,
+        stopOnFailure: args.stopOnFailure,
+        environment: {
+            mode: args.environmentMode,
+            id: args.environmentMode === 'override' ? args.environmentId : null,
+            name: args.environmentName
+        },
+        results: args.results
+    };
+    if (args.collectionUuid) {
+        payload.collection = {
+            uuid: args.collectionUuid,
+            name: args.collectionName,
+            ...(args.folderName ? { folderName: args.folderName } : {})
+        };
+    }
+    if (isRequestRun && args.requestUuid && args.requestName && args.requestMethod) {
+        payload.request = {
+            uuid: args.requestUuid,
+            name: args.requestName,
+            method: args.requestMethod
+        };
+    }
+    return payload;
+}
+/**
+ * Builds a default sidebar label from run-results export metadata.
+ *
+ * @param payload - Saved or exported run-results body.
+ * @returns Short human-readable label for list rows.
+ */
+export function buildSavedRunLabel(payload) {
+    const target = payload.request?.name ?? payload.collection?.folderName ?? payload.collection?.name ?? 'Run';
+    const timestamp = new Date().toISOString().replace('T', ' ').slice(0, 19);
+    return `${target} — ${timestamp}`;
+}
+/**
+ * Returns the HTTP method of the first request in a saved run result payload.
+ *
+ * @param payload - Portable run-results export body.
+ * @returns Method of the first result row, or the single-request export method when present.
+ */
+export function firstRunResultMethod(payload) {
+    return payload.results[0]?.requestMethod ?? payload.request?.method ?? null;
+}
+/**
+ * Derives list metadata from a run-results export payload.
+ *
+ * @param payload - Portable export body being saved.
+ * @returns Kind, names, and summary counts for persistence and list views.
+ */
+export function extractSavedRunMetadata(payload) {
+    return {
+        kind: payload.harborclientExport,
+        collectionName: payload.collection?.name ?? null,
+        requestName: payload.request?.name ?? null,
+        summary: summarizeRunnerResults(payload.results)
+    };
+}
+/**
+ * Resolves local collection and request ids from portable uuids in an import file.
+ *
+ * @param data - Parsed run-results export from disk.
+ * @param collections - Collections currently loaded in the workspace.
+ * @param requestsByCollection - Saved requests keyed by collection id.
+ * @returns Local ids when matches exist, or detached placeholders when not found.
+ */
+export function resolveImportedRunnerTargetIds(data, collections, requestsByCollection) {
+    let collectionId = 0;
+    if (data.collection?.uuid) {
+        const collection = collections.find((item) => item.uuid === data.collection?.uuid);
+        if (collection) {
+            collectionId = collection.id;
+        }
+    }
+    let requestId = null;
+    if (data.request?.uuid) {
+        const searchCollectionIds = collectionId > 0 ? [collectionId] : Object.keys(requestsByCollection).map(Number);
+        for (const id of searchCollectionIds) {
+            const match = (requestsByCollection[id] ?? []).find((request) => request.uuid === data.request?.uuid);
+            if (match) {
+                collectionId = id;
+                requestId = match.id;
+                break;
+            }
+        }
+    }
+    return { collectionId, requestId };
+}
+/**
+ * Normalizes persisted or partial collection runner config from storage.
+ *
+ * @param input - Raw config from electron-store or user edits.
+ * @returns Sanitized config with safe defaults applied.
+ */
+export function normalizeCollectionRunnerConfig(input) {
+    const delayMs = Number(input?.delayMs ?? DEFAULT_COLLECTION_RUNNER_CONFIG.delayMs);
+    const environmentMode = input?.environmentMode === 'override'
+        ? 'override'
+        : DEFAULT_COLLECTION_RUNNER_CONFIG.environmentMode;
+    const environmentCandidate = input?.environmentId == null ? null : Number(input.environmentId);
+    const environmentId = environmentMode === 'override' &&
+        Number.isInteger(environmentCandidate) &&
+        environmentCandidate > 0
+        ? environmentCandidate
+        : null;
+    return {
+        delayMs: Number.isFinite(delayMs) && delayMs >= 0 ? Math.floor(delayMs) : 0,
+        stopOnFailure: Boolean(input?.stopOnFailure),
+        environmentMode,
+        environmentId
+    };
+}
+/**
+ * Returns saved requests in sidebar run order for a collection or folder target.
+ *
+ * @param collectionId - Collection whose requests are included.
+ * @param folderId - When set, only requests in that folder; otherwise full collection order.
+ * @param requests - All saved requests for the collection (already loaded in Redux).
+ * @param folders - Folders for the collection (already loaded in Redux).
+ * @returns Requests ordered for sequential execution.
+ */
+export function getRequestsInRunOrder(collectionId, folderId, requests, folders) {
+    const collectionRequests = requests.filter((request) => request.collection_id === collectionId);
+    const sortRequests = (items) => [...items].sort((left, right) => left.sort_order - right.sort_order || left.name.localeCompare(right.name));
+    if (folderId != null) {
+        return sortRequests(collectionRequests.filter((request) => request.folder_id === folderId));
+    }
+    const rootRequests = sortRequests(collectionRequests.filter((request) => request.folder_id == null));
+    const sortedFolders = [...folders]
+        .filter((folder) => folder.collection_id === collectionId)
+        .sort((left, right) => left.sort_order - right.sort_order || left.name.localeCompare(right.name));
+    const nestedRequests = sortedFolders.flatMap((folder) => sortRequests(collectionRequests.filter((request) => request.folder_id === folder.id)));
+    return [...rootRequests, ...nestedRequests];
+}
+/**
+ * Returns saved requests for a collection runner target, optionally scoped to one request.
+ *
+ * @param collectionId - Collection whose requests are included.
+ * @param folderId - When set, only requests in that folder; otherwise full collection order.
+ * @param requestId - When set, returns only that request if it exists in the collection.
+ * @param requests - All saved requests for the collection (already loaded in Redux).
+ * @param folders - Folders for the collection (already loaded in Redux).
+ * @returns Requests ordered for sequential execution.
+ */
+export function getCollectionRunnerRequests(collectionId, folderId, requestId, requests, folders) {
+    if (requestId != null) {
+        const match = requests.find((request) => request.collection_id === collectionId && request.id === requestId);
+        return match ? [match] : [];
+    }
+    return getRequestsInRunOrder(collectionId, folderId, requests, folders);
+}
+/**
+ * Returns saved requests for an explicit id list, preserving caller order.
+ *
+ * @param requestIds - Request database ids in the desired run order.
+ * @param requestsByCollection - Cached requests keyed by collection id.
+ * @returns Matching saved requests, omitting ids that no longer exist.
+ */
+export function getRequestsByIds(requestIds, requestsByCollection) {
+    const byId = new Map();
+    for (const requests of Object.values(requestsByCollection)) {
+        for (const request of requests) {
+            byId.set(request.id, request);
+        }
+    }
+    const ordered = [];
+    for (const requestId of requestIds) {
+        const match = byId.get(requestId);
+        if (match) {
+            ordered.push(match);
+        }
+    }
+    return ordered;
+}
+/**
+ * Returns test pass/fail counts for a script test result list.
+ *
+ * @param testResults - hc.test results from the last send.
+ * @returns Counts of passing and failing assertions.
+ */
+export function countTestResults(testResults) {
+    let testsPassed = 0;
+    let testsFailed = 0;
+    for (const test of testResults) {
+        if (test.passed) {
+            testsPassed += 1;
+        }
+        else {
+            testsFailed += 1;
+        }
+    }
+    return { testsPassed, testsFailed };
+}
+/**
+ * Determines whether a completed send should count as a runner failure.
+ *
+ * @param response - HTTP response from the last send, if any.
+ * @param testResults - hc.test results from pre/post scripts.
+ * @returns True when stop-on-failure should halt the run.
+ */
+export function isCollectionRunnerRequestFailure(response, testResults) {
+    if (response?.error) {
+        return true;
+    }
+    if (response != null && response.status >= 400) {
+        return true;
+    }
+    return testResults.some((test) => !test.passed);
+}
+/**
+ * Builds initial pending result rows for a collection run.
+ *
+ * @param requests - Ordered requests that will be executed.
+ * @returns Pending result rows aligned with run order.
+ */
+export function buildPendingCollectionRunnerResults(requests) {
+    return requests.map((request) => ({
+        requestId: request.id,
+        requestName: request.name,
+        requestMethod: request.method,
+        status: 'pending',
+        testsPassed: 0,
+        testsFailed: 0
+    }));
+}
+/**
+ * Resolves the next request index after a collection runner step.
+ *
+ * @param orderedRequests - Requests in run order for the active target.
+ * @param currentIndex - Index of the request that just finished.
+ * @param nextRequest - Directive from hc.execution.setNextRequest, if any.
+ * @returns Next index to run, or null to stop the run.
+ */
+export function resolveCollectionRunnerNextIndex(orderedRequests, currentIndex, nextRequest) {
+    if (nextRequest === null) {
+        return null;
+    }
+    if (nextRequest === undefined) {
+        const next = currentIndex + 1;
+        return next < orderedRequests.length ? next : null;
+    }
+    const matchIndex = orderedRequests.findIndex((request) => request.name === nextRequest);
+    if (matchIndex >= 0) {
+        return matchIndex;
+    }
+    const fallback = currentIndex + 1;
+    return fallback < orderedRequests.length ? fallback : null;
+}
+//# sourceMappingURL=collectionRunner.js.map

package/dist/collectionRunner.js.map

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

package/dist/contrast.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Computes WCAG 2.x relative luminance for a hex color.
+ *
+ * @param hex - Six-digit sRGB hex color.
+ * @returns Relative luminance between 0 and 1.
+ */
+export declare function relativeLuminance(hex: string): number;
+/**
+ * Computes the WCAG contrast ratio between two hex colors.
+ *
+ * @param foreground - Foreground hex color.
+ * @param background - Background hex color.
+ * @returns Contrast ratio between 1 and 21.
+ */
+export declare function contrastRatio(foreground: string, background: string): number;
+//# sourceMappingURL=contrast.d.ts.map

package/dist/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../src/contrast.ts"],"names":[],"mappings":"AA6BA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK5E"}

package/dist/contrast.js

@@ -0,0 +1,51 @@
+/**
+ * Parses a six-digit hex color into sRGB channel values in the 0–1 range.
+ *
+ * @param hex - Color such as `#ffffff` or `ffffff`.
+ * @returns Normalized red, green, and blue channels.
+ */
+function parseHex(hex) {
+    const normalized = hex.replace('#', '').trim();
+    if (normalized.length !== 6) {
+        throw new Error(`Expected 6-digit hex color, received "${hex}"`);
+    }
+    const r = Number.parseInt(normalized.slice(0, 2), 16) / 255;
+    const g = Number.parseInt(normalized.slice(2, 4), 16) / 255;
+    const b = Number.parseInt(normalized.slice(4, 6), 16) / 255;
+    return { r, g, b };
+}
+/**
+ * Applies the WCAG relative luminance transfer function to a single sRGB channel.
+ *
+ * @param channel - Normalized sRGB channel value between 0 and 1.
+ * @returns Linearized luminance component.
+ */
+function linearizeChannel(channel) {
+    return channel <= 0.03928 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;
+}
+/**
+ * Computes WCAG 2.x relative luminance for a hex color.
+ *
+ * @param hex - Six-digit sRGB hex color.
+ * @returns Relative luminance between 0 and 1.
+ */
+export function relativeLuminance(hex) {
+    const { r, g, b } = parseHex(hex);
+    const red = linearizeChannel(r);
+    const green = linearizeChannel(g);
+    const blue = linearizeChannel(b);
+    return 0.2126 * red + 0.7152 * green + 0.0722 * blue;
+}
+/**
+ * Computes the WCAG contrast ratio between two hex colors.
+ *
+ * @param foreground - Foreground hex color.
+ * @param background - Background hex color.
+ * @returns Contrast ratio between 1 and 21.
+ */
+export function contrastRatio(foreground, background) {
+    const lighter = Math.max(relativeLuminance(foreground), relativeLuminance(background));
+    const darker = Math.min(relativeLuminance(foreground), relativeLuminance(background));
+    return (lighter + 0.05) / (darker + 0.05);
+}
+//# sourceMappingURL=contrast.js.map

package/dist/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","sourceRoot":"","sources":["../src/contrast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IAC5D,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IAC5D,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IAE5D,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAEjC,OAAO,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,UAAkB;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAEtF,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/cookies/CookieJar.d.ts

@@ -0,0 +1,151 @@
+import type { ICookieJar } from '../interfaces';
+import type { KeyValue } from '../types';
+/**
+ * Minimal persistence contract required by the portable cookie jar.
+ *
+ * GUI storage, CLI configuration, and test fakes can all provide this adapter
+ * without coupling the HTTP engine to a database implementation.
+ */
+export interface CookieJarStorage {
+    /**
+     * Reads a persisted value by key.
+     *
+     * @param key - Storage key to read.
+     * @returns Stored string, or undefined when no value has been written.
+     */
+    getSetting(key: string): string | undefined;
+    /**
+     * Persists a value by key.
+     *
+     * @param key - Storage key to write.
+     * @param value - Serialized value to persist.
+     */
+    setSetting(key: string, value: string): void;
+}
+/**
+ * Persists cookies by hostname in the local registry and builds Cookie headers
+ * for outbound HTTP requests.
+ */
+export declare class CookieJar implements ICookieJar {
+    private readonly storage;
+    /**
+     * @param storage - Persistence adapter used to store the jar map.
+     */
+    constructor(storage: CookieJarStorage);
+    /**
+     * Extracts the hostname from a URL string.
+     *
+     * @param url - Absolute or relative URL.
+     * @returns Hostname or null when parsing fails.
+     */
+    static hostFromUrl(url: string): string | null;
+    /**
+     * Returns cookies stored for a hostname.
+     *
+     * @param domain - Hostname to query.
+     */
+    getCookiesForDomain(domain: string): KeyValue[];
+    /**
+     * Returns persisted cookie domains in a stable order for management UIs.
+     *
+     * @returns Sorted hostnames with at least one stored cookie.
+     */
+    listDomains(): string[];
+    /**
+     * Persists cookies for a hostname.
+     *
+     * @param domain - Hostname to update.
+     * @param cookies - Cookie rows to store.
+     */
+    setCookiesForDomain(domain: string, cookies: KeyValue[]): void;
+    /**
+     * Builds a Cookie header value for enabled cookies on the request host.
+     *
+     * @param url - Request URL used to resolve the host.
+     * @returns Semicolon-delimited cookie header value, or null when none apply.
+     */
+    buildCookieHeader(url: string): string | null;
+    /**
+     * Upserts or removes cookies from the jar based on Set-Cookie response headers.
+     *
+     * @param url - Request URL used to resolve the host.
+     * @param setCookieHeaders - Set-Cookie header values from the response.
+     */
+    captureSetCookies(url: string, setCookieHeaders: string[] | undefined): void;
+    /**
+     * Returns whether a cookie name or value contains characters unsafe for Cookie
+     * header serialization, such as control characters or semicolons that could
+     * inject attribute-like segments (e.g. `; Secure`).
+     *
+     * @param value - Cookie name or value to inspect.
+     */
+    private hasUnsafeCookieChars;
+    /**
+     * Reads persisted cookies keyed by hostname.
+     */
+    private getJarMap;
+    /**
+     * Persists the cookie jar map to the local registry.
+     *
+     * @param jar - Domain to cookies map.
+     */
+    private persistJarMap;
+    /**
+     * Normalizes a hostname for cookie storage lookup.
+     *
+     * @param domain - Raw hostname or URL host.
+     */
+    private normalizeDomain;
+    /**
+     * Filters out rows with both key and value empty.
+     *
+     * @param cookies - Cookie rows to normalize.
+     * @param existing - Previously stored cookies used to preserve the secure flag.
+     */
+    private normalizeCookieRows;
+    /**
+     * Returns stored cookies for a hostname, including internal metadata.
+     *
+     * @param domain - Hostname to query.
+     */
+    private getStoredCookiesForDomain;
+    /**
+     * Persists stored cookies for a hostname.
+     *
+     * @param domain - Hostname to update.
+     * @param cookies - Cookie rows to store.
+     */
+    private setStoredCookiesForDomain;
+    /**
+     * Extracts the URL scheme from a URL string.
+     *
+     * @param url - Absolute or relative URL.
+     * @returns Scheme including trailing colon, or null when parsing fails.
+     */
+    private schemeFromUrl;
+    /**
+     * Parses the name and value from a Set-Cookie header value.
+     *
+     * @param header - Raw Set-Cookie header string.
+     */
+    private parseSetCookieNameValue;
+    /**
+     * Parses Set-Cookie attributes from a header value.
+     *
+     * @param header - Raw Set-Cookie header string.
+     */
+    private parseSetCookieAttributes;
+    /**
+     * Returns whether a Set-Cookie header indicates the cookie should be deleted.
+     *
+     * @param header - Raw Set-Cookie header string.
+     */
+    private isSetCookieExpired;
+    /**
+     * Returns whether a Set-Cookie header marks the cookie as Secure.
+     *
+     * @param header - Raw Set-Cookie header string.
+     */
+    private isSetCookieSecure;
+}
+//# sourceMappingURL=CookieJar.d.ts.map

package/dist/cookies/CookieJar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieJar.d.ts","sourceRoot":"","sources":["../../src/cookies/CookieJar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAQzC;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAE5C;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED;;;GAGG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C;;OAEG;gBACS,OAAO,EAAE,gBAAgB;IAIrC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAe9C;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE;IAQ/C;;;;OAIG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI;IAS9D;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAqB7C;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI;IAkC5E;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAUjC;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAerB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAchC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CAG1B"}