@mauriciobenjamin700/ort-vision-sdk-web 0.2.1

package/dist/preprocess/image.js

@@ -0,0 +1,171 @@
+/**
+ * Composable image preprocessing primitives (resize, normalize, letterbox, layout).
+ *
+ * Mirrors the Python `preprocess.image` module. Operates on the canonical
+ * {@link RGBImage} (HWC RGB uint8) and produces uint8 or float32 buffers
+ * depending on the operation.
+ */
+import * as ortRuntime from "onnxruntime-web";
+import { createCanvas, get2DContext, imageDataToRGB, rgbToImageData, } from "../core/canvas.js";
+import { RGBImage } from "../types.js";
+/** Resize an image to `(targetWidth, targetHeight)` using high-quality canvas resampling. */
+export function resize(image, targetWidth, targetHeight) {
+    if (targetWidth <= 0 || targetHeight <= 0) {
+        throw new Error(`Invalid resize target ${targetWidth}x${targetHeight}.`);
+    }
+    if (targetWidth === image.width && targetHeight === image.height) {
+        return image;
+    }
+    const srcCanvas = createCanvas(image.width, image.height);
+    const srcCtx = get2DContext(srcCanvas);
+    srcCtx.putImageData(rgbToImageData(image), 0, 0);
+    const dstCanvas = createCanvas(targetWidth, targetHeight);
+    const dstCtx = get2DContext(dstCanvas);
+    dstCtx.imageSmoothingEnabled = true;
+    dstCtx.imageSmoothingQuality = "high";
+    dstCtx.drawImage(srcCanvas, 0, 0, targetWidth, targetHeight);
+    const imageData = dstCtx.getImageData(0, 0, targetWidth, targetHeight);
+    return imageDataToRGB(imageData);
+}
+/**
+ * Convert a uint8 image to a normalized float32 array (HWC layout preserved).
+ *
+ * Applies `(pixel * scale - mean) / std` channel-wise.
+ */
+export function normalize(image, mean, std, scale = 1 / 255) {
+    const out = new Float32Array(image.data.length);
+    const data = image.data;
+    const m0 = mean[0];
+    const m1 = mean[1];
+    const m2 = mean[2];
+    const s0 = std[0];
+    const s1 = std[1];
+    const s2 = std[2];
+    for (let i = 0; i < data.length; i += 3) {
+        out[i] = (data[i] * scale - m0) / s0;
+        out[i + 1] = (data[i + 1] * scale - m1) / s1;
+        out[i + 2] = (data[i + 2] * scale - m2) / s2;
+    }
+    return out;
+}
+/** Convert a uint8 image to a `Float32Array` in `[0, 1]` (HWC layout preserved). */
+export function toFloat32(image, scale = 1 / 255) {
+    const out = new Float32Array(image.data.length);
+    const data = image.data;
+    for (let i = 0; i < data.length; i++) {
+        out[i] = data[i] * scale;
+    }
+    return out;
+}
+/**
+ * Transpose interleaved HWC data to planar CHW layout.
+ *
+ * @param hwc Source array of length `width * height * channels`.
+ */
+export function toCHW(hwc, width, height, channels = 3) {
+    const expected = width * height * channels;
+    if (hwc.length !== expected) {
+        throw new Error(`toCHW: expected length ${expected} for ${width}x${height}x${channels}, got ${hwc.length}.`);
+    }
+    const chw = new Float32Array(expected);
+    const plane = width * height;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const hwcBase = (y * width + x) * channels;
+            const planeIdx = y * width + x;
+            for (let c = 0; c < channels; c++) {
+                chw[c * plane + planeIdx] = hwc[hwcBase + c];
+            }
+        }
+    }
+    return chw;
+}
+/** Wrap a Float32 buffer into an `ort.Tensor`. */
+export function toFloat32Tensor(data, dims) {
+    return new ortRuntime.Tensor("float32", data, dims);
+}
+/**
+ * Convert an HWC uint8 image to a CHW `Float32Array` scaled to `[0, 1]`.
+ *
+ * Mirrors `torchvision.transforms.ToTensor()` semantics: HWC → CHW,
+ * `uint8 → float32 / 255`. Useful as input to YOLO-style detectors that
+ * don't require ImageNet normalization.
+ *
+ * @returns CHW `Float32Array` of length `width * height * 3`.
+ */
+export function toTensor(image) {
+    const f32 = toFloat32(image);
+    return toCHW(f32, image.width, image.height, 3);
+}
+/**
+ * Convert an HWC BGR uint8 buffer (OpenCV layout) to the SDK's HWC RGB.
+ *
+ * Use when you receive image bytes from `cv2.imencode` over the wire and
+ * want to feed them to the SDK without going through a canvas decode.
+ *
+ * @param bgr Flat BGR Uint8Array of length `width * height * 3`.
+ */
+export function fromCv2(bgr, width, height) {
+    if (bgr.length !== width * height * 3) {
+        throw new Error(`fromCv2: data length ${bgr.length} does not match width * height * 3 = ${width * height * 3}.`);
+    }
+    const rgb = new Uint8Array(bgr.length);
+    for (let i = 0; i < bgr.length; i += 3) {
+        rgb[i] = bgr[i + 2];
+        rgb[i + 1] = bgr[i + 1];
+        rgb[i + 2] = bgr[i];
+    }
+    return new RGBImage(rgb, width, height);
+}
+/**
+ * Convert the SDK's HWC RGB image to an HWC BGR `Uint8Array` (OpenCV layout).
+ *
+ * Useful for round-tripping data to a Python OpenCV consumer.
+ */
+export function toCv2(image) {
+    const rgb = image.data;
+    const bgr = new Uint8Array(rgb.length);
+    for (let i = 0; i < rgb.length; i += 3) {
+        bgr[i] = rgb[i + 2];
+        bgr[i + 1] = rgb[i + 1];
+        bgr[i + 2] = rgb[i];
+    }
+    return bgr;
+}
+/**
+ * Resize preserving aspect ratio, padding to `(targetWidth, targetHeight)`
+ * with a constant fill color.
+ *
+ * Standard YOLO preprocessing — returning `scale` and `padLeft`/`padTop`
+ * lets callers map detections back to the original image coordinates.
+ */
+export function letterbox(image, targetWidth, targetHeight, fill = [114, 114, 114]) {
+    const scale = Math.min(targetWidth / image.width, targetHeight / image.height);
+    const newW = Math.round(image.width * scale);
+    const newH = Math.round(image.height * scale);
+    const resized = resize(image, newW, newH);
+    const out = new Uint8Array(targetWidth * targetHeight * 3);
+    const f0 = fill[0];
+    const f1 = fill[1];
+    const f2 = fill[2];
+    for (let i = 0; i < out.length; i += 3) {
+        out[i] = f0;
+        out[i + 1] = f1;
+        out[i + 2] = f2;
+    }
+    const padLeft = Math.floor((targetWidth - newW) / 2);
+    const padTop = Math.floor((targetHeight - newH) / 2);
+    const rowBytes = newW * 3;
+    for (let y = 0; y < newH; y++) {
+        const srcOffset = y * rowBytes;
+        const dstOffset = ((padTop + y) * targetWidth + padLeft) * 3;
+        out.set(resized.data.subarray(srcOffset, srcOffset + rowBytes), dstOffset);
+    }
+    return {
+        image: new RGBImage(out, targetWidth, targetHeight),
+        scale,
+        padLeft,
+        padTop,
+    };
+}
+//# sourceMappingURL=image.js.map

package/dist/preprocess/image.js.map

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

package/dist/results.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Per-image result envelopes — Ultralytics-style `Results` for the SDK.
+ *
+ * Each `predict()` call returns a 1-element array of these envelopes,
+ * mirroring `YOLO("img.jpg")`. Each envelope holds:
+ *
+ * - A bulk-array view of the predictions (`Boxes`, `Probs`, `Masks`) with
+ *   the exact attribute names Ultralytics uses (`xyxy`, `xywh`, `xyxyn`,
+ *   `xywhn`, `cls`, `conf`, `data`, `top1`, `top5`).
+ * - Per-instance dataclasses (`DetectionResult`, `SegmentationResult`,
+ *   `ClassProbability`) for callers who prefer the OO interface.
+ * - `names`: `Record<number, string>` matching Ultralytics' `model.names`.
+ * - `origImg` / `origShape` / `path`: provenance for the original input.
+ */
+import { type ClassificationResult, type DetectionResult, type RGBImage, type SegmentationResult } from "./types.js";
+/**
+ * Bulk numpy-style view of detected boxes for a single image.
+ *
+ * Mirrors Ultralytics' `Boxes` interface. Coordinates in {@link xyxy} and
+ * {@link xywh} are absolute pixels in the original image; the `*n` variants
+ * are normalized to `[0, 1]` using `origShape`.
+ */
+export declare class Boxes {
+    readonly xyxy: Float32Array;
+    readonly cls: Int32Array;
+    readonly conf: Float32Array;
+    readonly origShape: readonly [number, number];
+    /**
+     * @param xyxy Flat array of length `4 * N` in `[x1, y1, x2, y2, ...]` order.
+     * @param cls One class index per box, length `N`.
+     * @param conf One confidence per box, length `N`.
+     * @param origShape `[height, width]` of the original image.
+     */
+    constructor(xyxy: Float32Array, cls: Int32Array, conf: Float32Array, origShape: readonly [number, number]);
+    /** Number of detected boxes. */
+    get length(): number;
+    /** `[N, 4]` shape of the `xyxy` view. */
+    get shape(): readonly [number, number];
+    /** Boxes as `[N, 4]` `[cx, cy, w, h]` flat array in absolute pixels. */
+    get xywh(): Float32Array;
+    /** Boxes as `[N, 4]` `[x1, y1, x2, y2]` normalized to `[0, 1]`. */
+    get xyxyn(): Float32Array;
+    /** Boxes as `[N, 4]` `[cx, cy, w, h]` normalized to `[0, 1]`. */
+    get xywhn(): Float32Array;
+    /**
+     * Concatenated `[N, 6]` array of `[x1, y1, x2, y2, conf, cls]`.
+     *
+     * Matches Ultralytics' `boxes.data`.
+     */
+    get data(): Float32Array;
+}
+/**
+ * Top-k classification probabilities for a single image.
+ *
+ * Mirrors Ultralytics' `Probs` interface.
+ */
+export declare class Probs {
+    readonly data: Float32Array;
+    /** @param data `[numClasses]` per-class probabilities, indexed by class id. */
+    constructor(data: Float32Array);
+    /** Number of classes. */
+    get length(): number;
+    /** `[numClasses]` shape of the underlying vector. */
+    get shape(): readonly [number];
+    /** Index of the most probable class. */
+    get top1(): number;
+    /** Probability of the top-1 class. */
+    get top1conf(): number;
+    /** Indices of the top-5 most probable classes, descending. */
+    get top5(): Int32Array;
+    /** Probabilities of the top-5 classes, descending. */
+    get top5conf(): Float32Array;
+    private _topK;
+}
+/**
+ * Per-instance binary masks for a single image.
+ *
+ * Each mask is cropped to its instance's bounding box. To paint masks onto
+ * a full-image canvas, use `xyxy[i]` as the top-left target.
+ */
+export declare class Masks {
+    readonly data: ReadonlyArray<{
+        readonly data: Uint8Array;
+        readonly width: number;
+        readonly height: number;
+    }>;
+    readonly xyxy: Float32Array;
+    readonly origShape: readonly [number, number];
+    /**
+     * @param data Per-instance binary masks (`Mask` objects from `types.ts`).
+     * @param xyxy Flat `[N, 4]` of bounding-box coordinates in original pixels.
+     * @param origShape `[height, width]` of the original image.
+     */
+    constructor(data: ReadonlyArray<{
+        readonly data: Uint8Array;
+        readonly width: number;
+        readonly height: number;
+    }>, xyxy: Float32Array, origShape: readonly [number, number]);
+    /** Number of instance masks. */
+    get length(): number;
+    /** `[N]` shape of the masks collection. */
+    get shape(): readonly [number];
+    [Symbol.iterator](): Iterator<{
+        readonly data: Uint8Array;
+        readonly width: number;
+        readonly height: number;
+    }>;
+}
+/**
+ * Per-image detection envelope (Ultralytics-style `Results`).
+ *
+ * Iterating yields per-instance {@link DetectionResult} entries, so legacy
+ * code that did `for (const d of detector.predict(img))` only needs an
+ * extra `[0]` to bridge:
+ *
+ * ```typescript
+ * for (const d of (await detector.predict(img))[0]) {
+ *   console.log(d.cls, d.conf, d.box.xyxy);
+ * }
+ * ```
+ *
+ * For numpy-style bulk access, use the `boxes` collection.
+ */
+export declare class DetectionResults implements Iterable<DetectionResult> {
+    readonly boxes: Boxes;
+    readonly detections: readonly DetectionResult[];
+    readonly names: Readonly<Record<number, string>>;
+    readonly origImg: RGBImage;
+    readonly origShape: readonly [number, number];
+    readonly path: string | null;
+    readonly speed: Readonly<Record<string, number>>;
+    constructor(boxes: Boxes, detections: readonly DetectionResult[], names: Readonly<Record<number, string>>, origImg: RGBImage, origShape: readonly [number, number], path?: string | null, speed?: Readonly<Record<string, number>>);
+    /** Number of surviving detections. */
+    get length(): number;
+    /** Index into the per-instance detections. */
+    get(index: number): DetectionResult | undefined;
+    [Symbol.iterator](): Iterator<DetectionResult>;
+}
+/**
+ * Per-image classification envelope (Ultralytics-style `Results`).
+ */
+export declare class ClassificationResults {
+    readonly probs: Probs;
+    readonly result: ClassificationResult;
+    readonly names: Readonly<Record<number, string>>;
+    readonly origImg: RGBImage;
+    readonly origShape: readonly [number, number];
+    readonly path: string | null;
+    readonly speed: Readonly<Record<string, number>>;
+    constructor(probs: Probs, result: ClassificationResult, names: Readonly<Record<number, string>>, origImg: RGBImage, origShape: readonly [number, number], path?: string | null, speed?: Readonly<Record<string, number>>);
+    /** Top-1 class index (Ultralytics-style alias). */
+    get cls(): number;
+    /** Top-1 confidence (Ultralytics-style alias). */
+    get conf(): number;
+    /** Top-1 class name. */
+    get name(): string;
+    /** Per-class probability list, sorted descending (legacy field). */
+    get probabilities(): readonly ClassificationResult["probabilities"][number][];
+}
+/**
+ * Per-image instance-segmentation envelope (Ultralytics-style `Results`).
+ *
+ * Iterating yields per-instance {@link SegmentationResult} entries. `boxes`
+ * and `masks` mirror Ultralytics' bulk-array views.
+ */
+export declare class SegmentationResults implements Iterable<SegmentationResult> {
+    readonly boxes: Boxes;
+    readonly masks: Masks;
+    readonly detections: readonly SegmentationResult[];
+    readonly names: Readonly<Record<number, string>>;
+    readonly origImg: RGBImage;
+    readonly origShape: readonly [number, number];
+    readonly path: string | null;
+    readonly speed: Readonly<Record<string, number>>;
+    constructor(boxes: Boxes, masks: Masks, detections: readonly SegmentationResult[], names: Readonly<Record<number, string>>, origImg: RGBImage, origShape: readonly [number, number], path?: string | null, speed?: Readonly<Record<string, number>>);
+    /** Number of surviving instances. */
+    get length(): number;
+    /** Index into the per-instance results. */
+    get(index: number): SegmentationResult | undefined;
+    [Symbol.iterator](): Iterator<SegmentationResult>;
+}
+//# sourceMappingURL=results.d.ts.map

package/dist/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../src/results.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,qBAAa,KAAK;aAQE,IAAI,EAAE,YAAY;aAClB,GAAG,EAAE,UAAU;aACf,IAAI,EAAE,YAAY;aAClB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAVtD;;;;;OAKG;gBAEe,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAGtD,gCAAgC;IAChC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,yCAAyC;IACzC,IAAI,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAErC;IAED,wEAAwE;IACxE,IAAI,IAAI,IAAI,YAAY,CAavB;IAED,mEAAmE;IACnE,IAAI,KAAK,IAAI,YAAY,CAWxB;IAED,iEAAiE;IACjE,IAAI,KAAK,IAAI,YAAY,CAWxB;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,YAAY,CAWvB;CACF;AAED;;;;GAIG;AACH,qBAAa,KAAK;aAEY,IAAI,EAAE,YAAY;IAD9C,+EAA+E;gBACnD,IAAI,EAAE,YAAY;IAE9C,yBAAyB;IACzB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,qDAAqD;IACrD,IAAI,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC,CAE7B;IAED,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAYjB;IAED,sCAAsC;IACtC,IAAI,QAAQ,IAAI,MAAM,CAGrB;IAED,8DAA8D;IAC9D,IAAI,IAAI,IAAI,UAAU,CAErB;IAED,sDAAsD;IACtD,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,OAAO,CAAC,KAAK;CAad;AAED;;;;;GAKG;AACH,qBAAa,KAAK;aAOE,IAAI,EAAE,aAAa,CAAC;QAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;aACc,IAAI,EAAE,YAAY;aAClB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAZtD;;;;OAIG;gBAEe,IAAI,EAAE,aAAa,CAAC;QAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC,EACc,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAGtD,gCAAgC;IAChC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2CAA2C;IAC3C,IAAI,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC,CAE7B;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;QAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CAGH;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAiB,YAAW,QAAQ,CAAC,eAAe,CAAC;aAE9C,KAAK,EAAE,KAAK;aACZ,UAAU,EAAE,SAAS,eAAe,EAAE;aACtC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aACvC,OAAO,EAAE,QAAQ;aACjB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;aACpC,IAAI,EAAE,MAAM,GAAG,IAAI;aACnB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBANvC,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACvC,OAAO,EAAE,QAAQ,EACjB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,IAAI,GAAE,MAAM,GAAG,IAAW,EAC1B,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAG9D,sCAAsC;IACtC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,8CAA8C;IAC9C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI/C,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,eAAe,CAAC;CAG/C;AAED;;GAEG;AACH,qBAAa,qBAAqB;aAEd,KAAK,EAAE,KAAK;aACZ,MAAM,EAAE,oBAAoB;aAC5B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aACvC,OAAO,EAAE,QAAQ;aACjB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;aACpC,IAAI,EAAE,MAAM,GAAG,IAAI;aACnB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBANvC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACvC,OAAO,EAAE,QAAQ,EACjB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,IAAI,GAAE,MAAM,GAAG,IAAW,EAC1B,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAG9D,mDAAmD;IACnD,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,kDAAkD;IAClD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wBAAwB;IACxB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oEAAoE;IACpE,IAAI,aAAa,IAAI,SAAS,oBAAoB,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,CAE5E;CACF;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,QAAQ,CAAC,kBAAkB,CAAC;aAEpD,KAAK,EAAE,KAAK;aACZ,KAAK,EAAE,KAAK;aACZ,UAAU,EAAE,SAAS,kBAAkB,EAAE;aACzC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aACvC,OAAO,EAAE,QAAQ;aACjB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;aACpC,IAAI,EAAE,MAAM,GAAG,IAAI;aACnB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAPvC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACvC,OAAO,EAAE,QAAQ,EACjB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,IAAI,GAAE,MAAM,GAAG,IAAW,EAC1B,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAG9D,qCAAqC;IACrC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2CAA2C;IAC3C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIlD,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,kBAAkB,CAAC;CAGlD"}