@elaraai/east 1.0.78 → 1.0.80

package/dist/src/serialization/beast2/v5/manifest-writer.spec.js

@@ -0,0 +1,207 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The manifest writer: its directory is the Writer's blob taken apart — the
+ * header and each segment, named by SHA-256 — with a manifest naming them; the
+ * directory reads back as the value; an empty collection is a header and a
+ * manifest of no entries; the directories of three parity values are east-c's
+ * and east-py's to the byte; and a merge writes one too.
+ */
+import { describe, test } from "node:test";
+import assert from "node:assert/strict";
+import { createHash } from "node:crypto";
+import { ArrayType, DictType, IntegerType, RecursiveType, SetType, StringType, StructType, VariantType } from "../../../types.js";
+import { compareFor } from "../../../comparison.js";
+import { isTypeValueEqual, toEastTypeValue } from "../../../type_of_type.js";
+import { SortedMap, SortedSet, variant } from "../../../index.js";
+import { Beast2ManifestWriter, COLLECTION_MANIFEST_KIND, carveBeast2, decodeCollectionManifest, encodeBeast2FenceFor, encodeBeast2PagedFor, mergeBeast2For, openBeast2LazyFor, openBeast2PagesFor, readBeast2Extents, readBeast2Manifest, segmentKeyTypeOf, segmentRuleFor, spliceBeast2, spliceBeast2Segments, } from "../index.js";
+/** Every chunk a splice streams, as one array. */
+async function collect(chunks) {
+    const parts = [];
+    for await (const chunk of chunks)
+        parts.push(chunk);
+    const out = new Uint8Array(parts.reduce((n, part) => n + part.length, 0));
+    let at = 0;
+    for (const part of parts) {
+        out.set(part, at);
+        at += part.length;
+    }
+    return out;
+}
+/** A manifest directory held in memory, and the order its sink was called in. */
+function directory() {
+    const objects = new Map();
+    const calls = [];
+    let manifest = null;
+    return {
+        objects,
+        calls,
+        sink: {
+            object(hash, bytes) {
+                calls.push(hash);
+                objects.set(hash, bytes);
+            },
+            manifest(bytes) {
+                calls.push("manifest");
+                manifest = bytes;
+            },
+        },
+        manifest: () => {
+            assert.ok(manifest !== null, "the manifest was written");
+            return manifest;
+        },
+    };
+}
+const sha256 = (bytes) => createHash("sha256").update(bytes).digest("hex");
+const key = (prefix, i) => `${prefix}${String(i).padStart(7, "0")}`;
+const DictSI = DictType(StringType, IntegerType);
+const SetS = SetType(StringType);
+const ArrayS = ArrayType(StringType);
+const dict = new SortedMap(Array.from({ length: 50_000 }, (_, i) => [key("k", i), BigInt(i)]), compareFor(StringType));
+const set = new SortedSet(Array.from({ length: 50_000 }, (_, i) => key("e", i)), compareFor(StringType));
+const array = Array.from({ length: 50_000 }, (_, i) => key("a", i));
+const cases = [
+    { name: "a Dict", type: DictSI, value: dict, elements: () => dict.entries() },
+    { name: "a Set", type: SetS, value: set, elements: () => set.keys() },
+    { name: "an Array", type: ArrayS, value: array, elements: () => array.values() },
+];
+describe("beast2 v5 manifest writer", () => {
+    for (const { name, type, value, elements } of cases) {
+        test(`writes ${name} as the Writer's blob taken apart, each object under its SHA-256`, async () => {
+            const dir = directory();
+            const writer = new Beast2ManifestWriter(type, dir.sink);
+            for (const element of elements())
+                writer.add(element);
+            writer.finish();
+            const blob = encodeBeast2PagedFor(type)(value);
+            const extents = readBeast2Extents(blob);
+            const manifest = decodeCollectionManifest(dir.manifest());
+            assert.equal(manifest.kind, COLLECTION_MANIFEST_KIND);
+            assert.equal(manifest.level, 0n);
+            assert.equal(manifest.rule, segmentRuleFor(type));
+            assert.deepEqual(manifest.type, extents.typeValue);
+            const header = blob.subarray(0, extents.prefixEnd);
+            assert.equal(manifest.header, sha256(header));
+            assert.deepEqual(dir.objects.get(manifest.header), header);
+            assert.ok(manifest.entries.length > 1, "the value is cut into several segments");
+            assert.equal(manifest.entries.length, extents.offsets.length);
+            const keyType = segmentKeyTypeOf(type);
+            const pages = openBeast2PagesFor(type)(blob);
+            manifest.entries.forEach((entry, i) => {
+                const carved = carveBeast2(blob, i, i + 1, extents);
+                assert.deepEqual(dir.objects.get(entry.hash), carved, `segment ${i}`);
+                assert.equal(entry.hash, sha256(carved));
+                assert.equal(entry.count, BigInt(extents.counts[i]));
+                assert.equal(entry.bytes, BigInt(carved.length));
+                assert.deepEqual(new Uint8Array(entry.fence), keyType === null ? new Uint8Array(0) : encodeBeast2FenceFor(keyType)(pages.fence(i)));
+            });
+            assert.deepEqual(spliceBeast2(manifest.entries.map((entry) => dir.objects.get(entry.hash))), blob);
+            // Streamed under the header the manifest names, as a download splices.
+            assert.deepEqual(await collect(spliceBeast2Segments(header, manifest.entries.map((entry) => dir.objects.get(entry.hash)))), blob);
+        });
+        test(`writes ${name} as a directory that reads back as the value`, () => {
+            const dir = directory();
+            const writer = new Beast2ManifestWriter(type, dir.sink);
+            for (const element of elements())
+                writer.add(element);
+            writer.finish();
+            const manifest = readBeast2Manifest(dir.manifest());
+            assert.ok(manifest !== null);
+            const lazy = openBeast2LazyFor(type, { frozen: true })({
+                manifest,
+                segment: (i) => dir.objects.get(manifest.entries[i].hash),
+            });
+            assert.deepEqual([...(type === DictSI ? lazy.entries() : lazy)], [...elements()]);
+        });
+    }
+    test("splices no segment written under another header", async () => {
+        const segmentsOf = (type, elements) => {
+            const dir = directory();
+            const writer = new Beast2ManifestWriter(type, dir.sink);
+            for (const element of elements)
+                writer.add(element);
+            writer.finish();
+            const manifest = decodeCollectionManifest(dir.manifest());
+            return { header: dir.objects.get(manifest.header), segments: manifest.entries.map((entry) => dir.objects.get(entry.hash)) };
+        };
+        const dicts = segmentsOf(DictSI, dict.entries());
+        const sets = segmentsOf(SetS, set.keys());
+        await assert.rejects(collect(spliceBeast2Segments(dicts.header, [dicts.segments[0], sets.segments[1]])), {
+            message: "beast2 v5: segment 1 was written under another header — the segments of one collection share theirs",
+        });
+        // An empty collection is its header and the tail.
+        const empty = encodeBeast2PagedFor(DictSI)(new SortedMap(undefined, compareFor(StringType)));
+        assert.deepEqual(await collect(spliceBeast2Segments(dicts.header, [])), empty);
+    });
+    test("hands the header over first and the manifest last", () => {
+        const dir = directory();
+        const writer = new Beast2ManifestWriter(DictSI, dir.sink);
+        for (const entry of dict.entries())
+            writer.add(entry);
+        writer.finish();
+        writer.finish();
+        const manifest = decodeCollectionManifest(dir.manifest());
+        assert.deepEqual(dir.calls, [manifest.header, ...manifest.entries.map((entry) => entry.hash), "manifest"]);
+        assert.equal(writer.segments, manifest.entries.length);
+    });
+    test("writes an empty collection as its header and a manifest of no entries", () => {
+        const dir = directory();
+        new Beast2ManifestWriter(DictSI, dir.sink).finish();
+        const manifest = decodeCollectionManifest(dir.manifest());
+        const blob = encodeBeast2PagedFor(DictSI)(new SortedMap(undefined, compareFor(StringType)));
+        const header = blob.subarray(0, readBeast2Extents(blob).prefixEnd);
+        assert.deepEqual(manifest.entries, []);
+        assert.equal(manifest.header, sha256(header));
+        assert.deepEqual([...dir.objects.keys()], [manifest.header]);
+    });
+    test("writes the directories east-c and east-py write", () => {
+        // The same values and digests are pinned in east-c's
+        // `tests/test_beast2_manifest.c` and east-py's `test_beast2_manifest.py`.
+        // A manifest names each object by its SHA-256, so its own digest pins
+        // every segment's bytes too.
+        const manifestOf = (type, elements) => {
+            const dir = directory();
+            const writer = new Beast2ManifestWriter(type, dir.sink);
+            for (const element of elements)
+                writer.add(element);
+            writer.finish();
+            return sha256(dir.manifest());
+        };
+        assert.equal(manifestOf(DictSI, dict.entries()), "5564111725b1962b7ae8c82cf91d24c4e1fb8d2c9613245693757fe4ff4187b0");
+        assert.equal(manifestOf(SetS, set.keys()), "7b2c57db1da82f98ef88018589dc7a4f96bac120472b35e9826dbd60c395789c");
+        assert.equal(manifestOf(ArrayS, array), "127030afceae0c9590ad26ed26521cff170b8024229f28ccd54d647fc218df4c");
+        assert.equal(manifestOf(DictSI, []), "356518ed344e3e210d0a2acb26eef7eff25cd76ba08b1aedd0640af5256cefb0");
+    });
+    test("records a recursive collection type under canonical ids, not this process's", () => {
+        // The ids a runtime gives recursive types are its own; the manifest's
+        // hash names the collection, so the type is recorded renamed — the
+        // wrapper numbered 0 — and east-c records the same (the corpus pins it).
+        const TreeType = RecursiveType((tree) => VariantType({ leaf: IntegerType, node: StructType({ left: tree, right: tree }) }));
+        const type = ArrayType(TreeType);
+        const dir = directory();
+        const writer = new Beast2ManifestWriter(type, dir.sink);
+        writer.add(variant("node", { left: variant("leaf", 1n), right: variant("leaf", 2n) }));
+        writer.finish();
+        const recorded = decodeCollectionManifest(dir.manifest()).type;
+        assert.ok(isTypeValueEqual(recorded, toEastTypeValue(type)));
+        const wrapper = recorded.value.value.value;
+        assert.equal(wrapper.id, 0n);
+    });
+    test("writes what a merge writes as a manifest directory", () => {
+        // Two interleaved halves of the Dict, merged, are the Dict.
+        const half = (parity) => encodeBeast2PagedFor(DictSI)(new SortedMap([...dict.entries()].filter((_, i) => i % 2 === parity), compareFor(StringType)));
+        const merged = directory();
+        const stats = mergeBeast2For(DictSI)([half(0), half(1)], merged.sink);
+        assert.equal(stats.entries, dict.size);
+        const whole = directory();
+        const writer = new Beast2ManifestWriter(DictSI, whole.sink);
+        for (const entry of dict.entries())
+            writer.add(entry);
+        writer.finish();
+        assert.deepEqual(merged.manifest(), whole.manifest());
+        assert.deepEqual(merged.objects, whole.objects);
+    });
+});
+//# sourceMappingURL=manifest-writer.spec.js.map

package/dist/src/serialization/beast2/v5/manifest-writer.spec.js.map

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

package/dist/src/serialization/beast2/v5/manifest.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The segment manifest: a collection held as N standalone segment blobs plus
+ * a small object naming them in order.
+ *
+ * A v5 collection blob is already `header · tag · segment frames · terminator ·
+ * index · footer`, and each segment frame is a self-contained piece of the
+ * canonical value. A manifest takes the last step and lets each segment be its
+ * own blob, so a store can address them individually: equal values then name
+ * equal segments, a one-row edit re-cuts one of them, and two values diff by
+ * comparing hashes rather than by decoding anything.
+ *
+ * This type lives here, beside the container it describes, because **every
+ * runtime must read it**. A task input staged as a manifest is one file naming
+ * sibling segment files, and a body that iterates it, or reads one key from it,
+ * pays for the segments it touches rather than for a splice of the whole value
+ * — which is the difference between a 2 GB input costing 2 GB and costing the
+ * rows it reads. {@link Beast2ManifestSource} is what a reader hands
+ * {@link Beast2Pages} to get that.
+ *
+ * Nothing about the manifest changes what a segment is, so any reader in any
+ * runtime still opens a segment blob on its own, and splicing the segments
+ * back under their shared header reproduces the single-blob form exactly.
+ */
+import { ArrayType, BlobType, IntegerType, StringType, StructType, type ValueTypeOf } from "../../../types.js";
+import { type EastTypeValue } from "../../../type_of_type.js";
+import { type Beast2SyncRangeReader } from "./range.js";
+/** The `kind` tag every segment manifest carries — what tells a reader that an
+ *  object naming other objects describes a collection, and the handle a
+ *  garbage collector recognizes it by. */
+export declare const COLLECTION_MANIFEST_KIND = "$segments";
+/** One entry of a {@link CollectionManifestType}: a segment blob at level 0, a
+ *  child manifest above it. */
+export declare const CollectionManifestEntryType: StructType<{
+    /** The segment (or child manifest) object's content hash. */
+    readonly hash: StringType;
+    /** The entry's first key, in the canonical bare encoding
+     *  `encodeBeast2FenceFor` produces; empty for an Array root, which has no
+     *  key order to bisect. */
+    readonly fence: BlobType;
+    /** Elements (pairs, for a Dict root) in the segment or subtree. */
+    readonly count: IntegerType;
+    /** The object's size in bytes, so a reader budgets without a stat. */
+    readonly bytes: IntegerType;
+}>;
+export type CollectionManifestEntryType = typeof CollectionManifestEntryType;
+export type CollectionManifestEntry = ValueTypeOf<typeof CollectionManifestEntryType>;
+/**
+ * A collection's manifest: the value an object holds in place of the blob when
+ * the collection is stored as segment objects.
+ *
+ * @remarks
+ * `level` and the nesting it allows are carried from the first version on
+ * purpose. Struct encoding is positional, so a field appended later is another
+ * dual-decode tier on every reader in three runtimes — and a second index
+ * level is exactly what a manifest too large to hold whole would need. The
+ * byte is paid now.
+ */
+export declare const CollectionManifestType: StructType<{
+    /** Always {@link COLLECTION_MANIFEST_KIND}. */
+    readonly kind: StringType;
+    /** `0` when entries name segment blobs; `n` when they name level `n - 1`
+     *  manifests. */
+    readonly level: IntegerType;
+    /** The root collection type — the manifest is self-describing about what it
+     *  holds, exactly as a blob's type section is. */
+    readonly type: import("../../../types.js").RecursiveType<import("../../../types.js").VariantType<{
+        readonly Never: import("../../../types.js").NullType;
+        readonly Null: import("../../../types.js").NullType;
+        readonly Boolean: import("../../../types.js").NullType;
+        readonly Integer: import("../../../types.js").NullType;
+        readonly Float: import("../../../types.js").NullType;
+        readonly String: import("../../../types.js").NullType;
+        readonly DateTime: import("../../../types.js").NullType;
+        readonly Blob: import("../../../types.js").NullType;
+        readonly Ref: import("../../../types.js").RecursiveTypeMarker;
+        readonly Array: import("../../../types.js").RecursiveTypeMarker;
+        readonly Set: import("../../../types.js").RecursiveTypeMarker;
+        readonly Dict: StructType<{
+            readonly key: import("../../../types.js").RecursiveTypeMarker;
+            readonly value: import("../../../types.js").RecursiveTypeMarker;
+        }>;
+        readonly Struct: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("../../../types.js").RecursiveTypeMarker;
+        }>>;
+        readonly Variant: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("../../../types.js").RecursiveTypeMarker;
+        }>>;
+        readonly Recursive: import("../../../types.js").VariantType<{
+            readonly ref: IntegerType;
+            readonly wrapper: StructType<{
+                readonly id: IntegerType;
+                readonly inner: import("../../../types.js").RecursiveTypeMarker;
+            }>;
+        }>;
+        readonly Function: StructType<{
+            readonly inputs: ArrayType<import("../../../types.js").RecursiveTypeMarker>;
+            readonly output: import("../../../types.js").RecursiveTypeMarker;
+        }>;
+        readonly AsyncFunction: StructType<{
+            readonly inputs: ArrayType<import("../../../types.js").RecursiveTypeMarker>;
+            readonly output: import("../../../types.js").RecursiveTypeMarker;
+        }>;
+        readonly Vector: import("../../../types.js").RecursiveTypeMarker;
+        readonly Matrix: import("../../../types.js").RecursiveTypeMarker;
+    }>>;
+    /** The boundary-rule id the segments were cut under (`segmentRuleFor`), so a
+     *  reader knows whether they are cut the way this build cuts. */
+    readonly rule: StringType;
+    /** Hash of the canonical header bytes every segment is written under — what
+     *  makes the segments spliceable into one blob. */
+    readonly header: StringType;
+    /** The segments, in canonical order. */
+    readonly entries: ArrayType<StructType<{
+        /** The segment (or child manifest) object's content hash. */
+        readonly hash: StringType;
+        /** The entry's first key, in the canonical bare encoding
+         *  `encodeBeast2FenceFor` produces; empty for an Array root, which has no
+         *  key order to bisect. */
+        readonly fence: BlobType;
+        /** Elements (pairs, for a Dict root) in the segment or subtree. */
+        readonly count: IntegerType;
+        /** The object's size in bytes, so a reader budgets without a stat. */
+        readonly bytes: IntegerType;
+    }>>;
+}>;
+export type CollectionManifestType = typeof CollectionManifestType;
+export type CollectionManifest = ValueTypeOf<typeof CollectionManifestType>;
+/**
+ * Whether a decoded object's root type is a {@link CollectionManifestType}.
+ *
+ * @remarks
+ * Matched on the **exact** field set. Arbitrary user values flow through the
+ * same dispatch — a record's state is any struct the author chose — and a
+ * name-subset match would classify one as a manifest and read its fields as
+ * object hashes. The `kind` field is checked separately, after a decode, by
+ * {@link isCollectionManifest}.
+ *
+ * @param typeValue - the object's decoded root type
+ * @returns whether the type is exactly the manifest struct
+ */
+export declare function isCollectionManifestType(typeValue: EastTypeValue): boolean;
+/**
+ * Whether a decoded value is a segment manifest — its type is the manifest
+ * struct and its `kind` is {@link COLLECTION_MANIFEST_KIND}.
+ *
+ * @param typeValue - the object's decoded root type
+ * @param value - the decoded value
+ * @returns whether the object is a manifest
+ */
+export declare function isCollectionManifest(typeValue: EastTypeValue, value: unknown): boolean;
+/**
+ * Encodes a segment manifest.
+ *
+ * @param manifest - the manifest
+ * @returns the beast2 bytes
+ *
+ * @remarks
+ * The collection type is written with its recursive types renamed
+ * canonically ({@link canonicalTypeValue}): the ids a runtime gives them are
+ * its own, and a manifest's hash names the collection in a store, so one
+ * collection must have one manifest whichever runtime writes it.
+ */
+export declare function encodeCollectionManifest(manifest: CollectionManifest): Uint8Array;
+/**
+ * Decodes a segment manifest.
+ *
+ * @param data - the stored bytes
+ * @returns the manifest
+ * @throws {Error} When the bytes are not a manifest, or its `kind` is not
+ *   {@link COLLECTION_MANIFEST_KIND} — a struct of the right shape carrying
+ *   another tag is a different object that must not be read as segments.
+ */
+export declare function decodeCollectionManifest(data: Uint8Array): CollectionManifest;
+/**
+ * The total element (pair) count a manifest describes.
+ *
+ * @param manifest - the manifest
+ * @returns the sum of its entries' counts
+ */
+export declare function manifestElementCount(manifest: CollectionManifest): number;
+/**
+ * The total byte size of the segment objects a manifest names.
+ *
+ * @param manifest - the manifest
+ * @returns the sum of its entries' byte sizes
+ */
+export declare function manifestByteSize(manifest: CollectionManifest): number;
+/**
+ * The manifest a blob holds, or `null` when it holds something else.
+ *
+ * @remarks
+ * Costs one head read through a ranged source: a blob declares its root type up
+ * front, and a manifest is recognized by that type's exact field set, so
+ * nothing more is read for a blob that turns out to be a value.
+ *
+ * @param source - the blob, or ranged access to it
+ * @returns the decoded manifest, or `null`
+ */
+export declare function readBeast2Manifest(source: Uint8Array | Beast2SyncRangeReader): CollectionManifest | null;
+/**
+ * A collection presented to a reader as its manifest plus access to each
+ * segment — the form {@link Beast2Pages} opens when the segments are separate
+ * blobs rather than runs of one.
+ *
+ * @remarks
+ * The reader never asks for a segment it does not decode, and never asks for a
+ * fence at all: a manifest carries every fence already, so a keyed read is one
+ * bisect over decoded keys and one segment. That is what makes a keyed read of
+ * a 1.5-million-entry input cost one segment on every runtime.
+ *
+ * @example
+ * ```ts
+ * const source: Beast2ManifestSource = {
+ *   manifest,
+ *   segment: (i) => readFileSync(`${path}.segments/${manifest.entries[i].hash}.beast2`),
+ * };
+ * const rows = openBeast2LazyFor(manifest.type, { frozen: true })(source);
+ * ```
+ */
+export interface Beast2ManifestSource {
+    /** The manifest describing the collection. */
+    readonly manifest: CollectionManifest;
+    /**
+     * Segment `i`'s standalone blob — its bytes, or ranged access to them.
+     *
+     * @param i - zero-based segment index
+     * @returns the segment blob
+     */
+    segment(i: number): Uint8Array | Beast2SyncRangeReader;
+}
+/** Whether `source` is a {@link Beast2ManifestSource} rather than a blob or a
+ *  range reader — judged by shape, since a value from another realm fails
+ *  `instanceof`. */
+export declare function isBeast2ManifestSource(source: unknown): source is Beast2ManifestSource;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/src/serialization/beast2/v5/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../../src/serialization/beast2/v5/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,SAAS,EACT,QAAQ,EACR,WAAW,EACX,UAAU,EACV,UAAU,EACV,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAqD,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIjH,OAAO,EAAsC,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE5F;;0CAE0C;AAC1C,eAAO,MAAM,wBAAwB,cAAc,CAAC;AAEpD;+BAC+B;AAC/B,eAAO,MAAM,2BAA2B;IACtC,6DAA6D;;IAE7D;;+BAE2B;;IAE3B,mEAAmE;;IAEnE,sEAAsE;;EAEtE,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAC;AAC7E,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEtF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB;IACjC,+CAA+C;;IAE/C;qBACiB;;IAEjB;sDACkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAElD;qEACiE;;IAEjE;uDACmD;;IAEnD,wCAAwC;;QAxCxC,6DAA6D;;QAE7D;;mCAE2B;;QAE3B,mEAAmE;;QAEnE,sEAAsE;;;EAkCtE,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAO5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAK1E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAGtF;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,UAAU,CAEjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,kBAAkB,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAIzE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAIrE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,IAAI,CAoBxG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,qBAAqB,CAAC;CACxD;AAED;;oBAEoB;AACpB,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,oBAAoB,CAItF"}