@adobe/data 0.5.11 → 0.5.13

package/dist/samples/todo/services/state-service/create-todo-store.d.ts

@@ -1,13 +1,13 @@
 export declare const todoStoreSchemaVersion = 1;
 export declare const createTodoStore: () => import("../../../../ecs/index.js").Store<{
-    todo: true;
     name: string;
     order: number;
+    todo: true;
     complete: boolean;
     dragPosition: number | null;
 }, {
     displayCompleted: boolean;
 }, {
-    Todo: ("todo" | "name" | "order" | "complete" | "dragPosition")[];
+    Todo: ("name" | "order" | "todo" | "complete" | "dragPosition")[];
 }>;
 export type TodoStore = ReturnType<typeof createTodoStore>;

package/dist/schema/schema.d.ts

@@ -2,6 +2,7 @@ import { TypedBuffer } from "../typed-buffer/typed-buffer.js";
 import { DeepReadonly } from "../types/types.js";
 type JSONPath = string;
 type JSONMergePatch = unknown;
+export type Layout = "std140" | "packed";
 /**
  * Conditional patch applied to the path when the enclosing schema branch is active
  * and `match` is not present or validates against the root.
@@ -57,6 +58,20 @@ export interface Schema {
     allOf?: readonly Schema[];
     const?: any;
     enum?: readonly any[];
+    layout?: Layout;
+    /**
+     * Classification of data according to privacy regulations and cookie consent frameworks.
+     * Used to categorize data collection and processing for privacy compliance.
+     * Useful resource:
+     * https://www.onetrust.com/products/cookie-consent/
+     *
+     * @remarks
+     * - `strictlyNecessary`: Essential data required for basic functionality and security
+     * - `performance`: Data used for analytics, performance monitoring, and site optimization
+     * - `functional`: Data used for enhanced features and user experience improvements
+     * - `advertising`: Data used for advertising, marketing, and personalized content
+     */
+    privacy?: 'strictlyNecessary' | 'performance' | 'functional' | 'advertising';
 }
 export type FromSchemas<T> = {
     [K in keyof T]: FromSchema<T[K]>;

package/dist/schema/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AA4NX,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrB,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;KACvB;IACD,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACpB,oBAAoB,EAAE,KAAK;CACF,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AA4OX,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrB,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;KACvB;IACD,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACpB,oBAAoB,EAAE,KAAK;CACF,CAAC"}

package/dist/schema/to-vertex-buffer-layout.d.ts

@@ -0,0 +1,56 @@
+import { Layout, Schema } from "./schema.js";
+export interface GPUVertexBufferLayout {
+    arrayStride: number;
+    stepMode?: 'vertex' | 'instance';
+    attributes: GPUVertexAttributeDescriptor[];
+}
+export interface GPUVertexAttributeDescriptor {
+    format: GPUVertexFormat;
+    offset: number;
+    shaderLocation: number;
+}
+export type GPUVertexFormat = 'uint8x2' | 'uint8x8' | 'sint8x2' | 'sint8x8' | 'unorm8x2' | 'unorm8x8' | 'snorm8x2' | 'snorm8x8' | 'uint16x2' | 'uint16x4' | 'sint16x2' | 'sint16x4' | 'unorm16x2' | 'unorm16x4' | 'snorm16x2' | 'snorm16x4' | 'float16x2' | 'float16x4' | 'float32' | 'float32x2' | 'float32x3' | 'float32x4' | 'uint32' | 'uint32x2' | 'uint32x3' | 'uint32x4' | 'sint32' | 'sint32x2' | 'sint32x3' | 'sint32x4';
+/**
+ * Options for configuring vertex buffer layout generation
+ */
+export interface VertexBufferLayoutOptions {
+    /** Layout mode to use (defaults to schema.layout or "packed") */
+    layout?: Layout;
+    /** Custom shader location mapping for fields */
+    shaderLocations?: Partial<Record<string, number>>;
+    /** Step mode for vertex buffer (default: 'vertex') */
+    stepMode?: 'vertex' | 'instance';
+}
+/**
+ * Converts a Schema to a WebGPU GPUVertexBufferLayout descriptor
+ *
+ * @param schema - Schema defining the vertex structure
+ * @param options - Configuration options for layout generation
+ * @returns GPUVertexBufferLayout descriptor ready for WebGPU pipeline creation
+ *
+ * @example
+ * ```typescript
+ * const vertexLayout = schemaToVertexBufferLayout(positionColorNormalVertexSchema, {
+ *     shaderLocations: { position: 0, color: 8, normal: 9 }
+ * });
+ *
+ * const pipeline = device.createRenderPipeline({
+ *     vertex: {
+ *         module: shaderModule,
+ *         entryPoint: 'vs_main',
+ *         buffers: [{ ...vertexLayout }]
+ *     },
+ *     // ...
+ * });
+ * ```
+ */
+export declare function schemaToVertexBufferLayout<S extends Schema>(schema: S, options?: VertexBufferLayoutOptions): GPUVertexBufferLayout;
+/**
+ * Type-safe helper to generate vertex buffer layout for a specific schema type
+ *
+ * @example
+ * ```typescript
+ * const positionColorLayout = positionColorNormalVertexSchema |> schemaToVertexBufferLayoutForType;
+ * ```
+ */
+export declare function schemaToVertexBufferLayoutForType<T extends Schema>(schema: T, options?: VertexBufferLayoutOptions): GPUVertexBufferLayout;

package/dist/schema/to-vertex-buffer-layout.js

@@ -0,0 +1,129 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { getStructLayout } from "../typed-buffer/structs/get-struct-layout.js";
+/**
+ * Converts a struct field layout to equivalent WebGPU vertex format
+ */
+function fieldLayoutToVertexFormat(fieldLayout) {
+    if (typeof fieldLayout === "string") {
+        // Handle primitive types
+        switch (fieldLayout) {
+            case "f32": return "float32";
+            case "i32": return "sint32";
+            case "u32": return "uint32";
+        }
+    }
+    if (typeof fieldLayout === "object" && fieldLayout.type === "array") {
+        // Handle array/vector types
+        const size = fieldLayout.size;
+        const elementCount = getVectorElementCount(fieldLayout);
+        switch (elementCount) {
+            case 1: return "float32"; // f32
+            case 2: return "float32x2"; // vec2
+            case 3: return "float32x3"; // vec3  
+            case 4: return "float32x4"; // vec4
+        }
+    }
+    throw new Error(`Unsupported field layout for vertex buffer: ${JSON.stringify(fieldLayout)}`);
+}
+/**
+ * Determines the number of elements in a vector from field layout
+ */
+function getVectorElementCount(fieldLayout) {
+    // For fixed-size arrays like Vec3/Vec4, count the fields
+    const fieldCount = Object.keys(fieldLayout.fields).length;
+    if (fieldCount >= 1 && fieldCount <= 4) {
+        return fieldCount;
+    }
+    throw new Error(`Vector dimensions must be 1-4 elements, got ${fieldCount}`);
+}
+/**
+ * Converts a Schema to a WebGPU GPUVertexBufferLayout descriptor
+ *
+ * @param schema - Schema defining the vertex structure
+ * @param options - Configuration options for layout generation
+ * @returns GPUVertexBufferLayout descriptor ready for WebGPU pipeline creation
+ *
+ * @example
+ * ```typescript
+ * const vertexLayout = schemaToVertexBufferLayout(positionColorNormalVertexSchema, {
+ *     shaderLocations: { position: 0, color: 8, normal: 9 }
+ * });
+ *
+ * const pipeline = device.createRenderPipeline({
+ *     vertex: {
+ *         module: shaderModule,
+ *         entryPoint: 'vs_main',
+ *         buffers: [{ ...vertexLayout }]
+ *     },
+ *     // ...
+ * });
+ * ```
+ */
+export function schemaToVertexBufferLayout(schema, options = {}) {
+    // Determine layout to use
+    const layoutMode = options.layout ?? schema.layout ?? "packed";
+    // Get struct layout information
+    const structLayout = getStructLayout({ ...schema, layout: layoutMode }, true);
+    if (!structLayout) {
+        throw new Error("Schema is not a valid vertex buffer layout - must be a struct schema");
+    }
+    const attributes = [];
+    let nextShaderLocation = 0;
+    // Generate attributes for each field
+    for (const [fieldName, fieldLayout] of Object.entries(structLayout.fields)) {
+        const shaderLocation = options.shaderLocations?.[fieldName] ?? nextShaderLocation;
+        try {
+            const format = fieldLayoutToVertexFormat(fieldLayout.type);
+            attributes.push({
+                format,
+                offset: fieldLayout.offset,
+                shaderLocation
+            });
+        }
+        catch (error) {
+            throw new Error(`Field "${fieldName}" cannot be converted to vertex format: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!options.shaderLocations?.[fieldName]) {
+            nextShaderLocation++;
+        }
+    }
+    // Sort attributes by shader location for logical ordering
+    attributes.sort((a, b) => a.shaderLocation - b.shaderLocation);
+    return {
+        arrayStride: structLayout.size,
+        stepMode: options.stepMode ?? 'vertex',
+        attributes
+    };
+}
+/**
+ * Type-safe helper to generate vertex buffer layout for a specific schema type
+ *
+ * @example
+ * ```typescript
+ * const positionColorLayout = positionColorNormalVertexSchema |> schemaToVertexBufferLayoutForType;
+ * ```
+ */
+export function schemaToVertexBufferLayoutForType(schema, options) {
+    return schemaToVertexBufferLayout(schema, options);
+}
+//# sourceMappingURL=to-vertex-buffer-layout.js.map

package/dist/schema/to-vertex-buffer-layout.js.map

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

package/dist/schema/to-vertex-buffer-layout.test.d.ts

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

package/dist/schema/to-vertex-buffer-layout.test.js

@@ -0,0 +1,247 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { describe, it, expect } from "vitest";
+import { schemaToVertexBufferLayout, schemaToVertexBufferLayoutForType } from "./to-vertex-buffer-layout.js";
+describe("schemaToVertexBufferLayout", () => {
+    describe("position-color-normal vertex schema", () => {
+        const positionColorNormalSchema = {
+            type: "object",
+            properties: {
+                position: {
+                    type: "array",
+                    items: { type: "number", precision: 1 },
+                    minItems: 3,
+                    maxItems: 3
+                },
+                color: {
+                    type: "array",
+                    items: { type: "number", precision: 1 },
+                    minItems: 4,
+                    maxItems: 4
+                },
+                normal: {
+                    type: "array",
+                    items: { type: "number", precision: 1 },
+                    minItems: 3,
+                    maxItems: 3
+                }
+            },
+            layout: "packed"
+        };
+        it("should generate correct packed layout for position-color-normal", () => {
+            const layout = schemaToVertexBufferLayout(positionColorNormalSchema);
+            expect(layout.arrayStride).toBe(40); // 3 + 4 + 3 = 10 floats × 4 bytes = 40 bytes
+            expect(layout.stepMode).toBe("vertex");
+            expect(layout.attributes).toHaveLength(3);
+            // Position: Vec3 at offset 0
+            expect(layout.attributes[0]).toEqual({
+                format: "float32x3",
+                offset: 0,
+                shaderLocation: 0
+            });
+            // Color: Vec4 at offset 12
+            expect(layout.attributes[1]).toEqual({
+                format: "float32x4",
+                offset: 12,
+                shaderLocation: 1
+            });
+            // Normal: Vec3 at offset 28
+            expect(layout.attributes[2]).toEqual({
+                format: "float32x3",
+                offset: 28,
+                shaderLocation: 2
+            });
+        });
+        it("should allow custom shader locations", () => {
+            const layout = schemaToVertexBufferLayout(positionColorNormalSchema, {
+                shaderLocations: {
+                    position: 0,
+                    color: 8,
+                    normal: 9
+                }
+            });
+            expect(layout.attributes.find(a => a.shaderLocation === 0)?.offset).toBe(0);
+            expect(layout.attributes.find(a => a.shaderLocation === 8)?.offset).toBe(12);
+            expect(layout.attributes.find(a => a.shaderLocation === 9)?.offset).toBe(28);
+        });
+        it("should support instance step mode", () => {
+            const layout = schemaToVertexBufferLayout(positionColorNormalSchema, {
+                stepMode: "instance"
+            });
+            expect(layout.stepMode).toBe("instance");
+        });
+    });
+    describe("simple position schema", () => {
+        const positionSchema = {
+            type: "object",
+            properties: {
+                position: {
+                    type: "array",
+                    items: { type: "number", precision: 1 },
+                    minItems: 3,
+                    maxItems: 3
+                }
+            },
+            layout: "packed"
+        };
+        it("should generate minimal vertex layout", () => {
+            const layout = schemaToVertexBufferLayout(positionSchema);
+            expect(layout.arrayStride).toBe(12); // Vec3 = 12 bytes
+            expect(layout.attributes).toHaveLength(1);
+            expect(layout.attributes[0]).toEqual({
+                format: "float32x3",
+                offset: 0,
+                shaderLocation: 0
+            });
+        });
+    });
+    describe("primitive type schemas", () => {
+        it("should handle single float", () => {
+            const schema = {
+                type: "object",
+                properties: {
+                    weight: { type: "number", precision: 1 }
+                },
+                layout: "packed"
+            };
+            const layout = schemaToVertexBufferLayout(schema);
+            expect(layout.arrayStride).toBe(4);
+            expect(layout.attributes[0]).toEqual({
+                format: "float32",
+                offset: 0,
+                shaderLocation: 0
+            });
+        });
+        it("should handle integer types", () => {
+            const schema = {
+                type: "object",
+                properties: {
+                    id: { type: "integer", minimum: 0, maximum: 65535 }
+                },
+                layout: "packed"
+            };
+            const layout = schemaToVertexBufferLayout(schema);
+            expect(layout.arrayStride).toBe(4);
+            expect(layout.attributes[0]).toEqual({
+                format: "uint32",
+                offset: 0,
+                shaderLocation: 0
+            });
+        });
+    });
+    describe("error handling", () => {
+        it("should throw error for non-struct schemas", () => {
+            const arraySchema = {
+                type: "array",
+                items: { type: "number" }
+            };
+            expect(() => {
+                schemaToVertexBufferLayout(arraySchema);
+            }).toThrow(/Array must have fixed length/);
+        });
+        it("should throw error for unsupported field types", () => {
+            const schema = {
+                type: "object",
+                properties: {
+                    name: { type: "string" }
+                },
+                layout: "packed"
+            };
+            expect(() => {
+                schemaToVertexBufferLayout(schema);
+            }).toThrow(/not a valid struct type/);
+        });
+        it("should throw error for oversized vectors", () => {
+            const schema = {
+                type: "object",
+                properties: {
+                    values: {
+                        type: "array",
+                        items: { type: "number", precision: 1 },
+                        minItems: 5,
+                        maxItems: 5
+                    }
+                },
+                layout: "packed"
+            };
+            expect(() => {
+                schemaToVertexBufferLayout(schema);
+            }).toThrow(/dimensions must be 1-4 elements/);
+        });
+    });
+    describe("layout mode handling", () => {
+        it("should use schema layout by default", () => {
+            const schema = {
+                type: "object",
+                properties: {
+                    position: {
+                        type: "array",
+                        items: { type: "number", precision: 1 },
+                        minItems: 3,
+                        maxItems: 3
+                    }
+                },
+                layout: "packed"
+            };
+            const layout = schemaToVertexBufferLayout(schema);
+            expect(layout.arrayStride).toBe(12); // Packed: tight packing
+        });
+        it("should override schema layout when specified", () => {
+            const schema = {
+                type: "object",
+                properties: {
+                    position: {
+                        type: "array",
+                        items: { type: "number", precision: 1 },
+                        minItems: 3,
+                        maxItems: 3
+                    }
+                },
+                layout: "packed"
+            };
+            const layout = schemaToVertexBufferLayout(schema, {
+                layout: "std140"
+            });
+            expect(layout.arrayStride).toBe(16); // std140: 16-byte alignment
+        });
+    });
+    describe("type-safe helper", () => {
+        it("should work with schemaToVertexBufferLayoutForType", () => {
+            const testSchema = {
+                type: "object",
+                properties: {
+                    position: {
+                        type: "array",
+                        items: { type: "number", precision: 1 },
+                        minItems: 2,
+                        maxItems: 2
+                    }
+                },
+                layout: "packed"
+            };
+            const layout = schemaToVertexBufferLayoutForType(testSchema);
+            expect(layout.arrayStride).toBe(8); // Vec2 = 8 bytes
+            expect(layout.attributes[0].format).toBe("float32x2");
+        });
+    });
+});
+//# sourceMappingURL=to-vertex-buffer-layout.test.js.map

package/dist/schema/to-vertex-buffer-layout.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-vertex-buffer-layout.test.js","sourceRoot":"","sources":["../../src/schema/to-vertex-buffer-layout.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AAG7G,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACxC,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;QACjD,MAAM,yBAAyB,GAAW;YACtC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,QAAQ,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;oBACvC,QAAQ,EAAE,CAAC;oBACX,QAAQ,EAAE,CAAC;iBACd;gBACD,KAAK,EAAE;oBACH,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;oBACvC,QAAQ,EAAE,CAAC;oBACX,QAAQ,EAAE,CAAC;iBACd;gBACD,MAAM,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;oBACvC,QAAQ,EAAE,CAAC;oBACX,QAAQ,EAAE,CAAC;iBACd;aACJ;YACD,MAAM,EAAE,QAAQ;SACnB,CAAC;QAEF,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACvE,MAAM,MAAM,GAAG,0BAA0B,CAAC,yBAAyB,CAAC,CAAC;YAErE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,6CAA6C;YAClF,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAE1C,6BAA6B;YAC7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACjC,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,CAAC;gBACT,cAAc,EAAE,CAAC;aACpB,CAAC,CAAC;YAEH,2BAA2B;YAC3B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACjC,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,EAAE;gBACV,cAAc,EAAE,CAAC;aACpB,CAAC,CAAC;YAEH,4BAA4B;YAC5B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACjC,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,EAAE;gBACV,cAAc,EAAE,CAAC;aACpB,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC5C,MAAM,MAAM,GAAG,0BAA0B,CAAC,yBAAyB,EAAE;gBACjE,eAAe,EAAE;oBACb,QAAQ,EAAE,CAAC;oBACX,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,CAAC;iBACZ;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5E,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7E,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YACzC,MAAM,MAAM,GAAG,0BAA0B,CAAC,yBAAyB,EAAE;gBACjE,QAAQ,EAAE,UAAU;aACvB,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACpC,MAAM,cAAc,GAAW;YAC3B,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,QAAQ,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;oBACvC,QAAQ,EAAE,CAAC;oBACX,QAAQ,EAAE,CAAC;iBACd;aACJ;YACD,MAAM,EAAE,QAAQ;SACnB,CAAC;QAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC7C,MAAM,MAAM,GAAG,0BAA0B,CAAC,cAAc,CAAC,CAAC;YAE1D,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB;YACvD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACjC,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,CAAC;gBACT,cAAc,EAAE,CAAC;aACpB,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YAClC,MAAM,MAAM,GAAW;gBACnB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;iBAC3C;gBACD,MAAM,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;YAElD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACjC,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,CAAC;gBACT,cAAc,EAAE,CAAC;aACpB,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACnC,MAAM,MAAM,GAAW;gBACnB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;iBACtD;gBACD,MAAM,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;YAElD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACjC,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,CAAC;gBACT,cAAc,EAAE,CAAC;aACpB,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACjD,MAAM,WAAW,GAAW;gBACxB,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC5B,CAAC;YAEF,MAAM,CAAC,GAAG,EAAE;gBACR,0BAA0B,CAAC,WAAW,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACtD,MAAM,MAAM,GAAW;gBACnB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3B;gBACD,MAAM,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,CAAC,GAAG,EAAE;gBACR,0BAA0B,CAAC,MAAM,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAChD,MAAM,MAAM,GAAW;gBACnB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,MAAM,EAAE;wBACJ,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;wBACvC,QAAQ,EAAE,CAAC;wBACX,QAAQ,EAAE,CAAC;qBACd;iBACJ;gBACD,MAAM,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,CAAC,GAAG,EAAE;gBACR,0BAA0B,CAAC,MAAM,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC3C,MAAM,MAAM,GAAW;gBACnB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,QAAQ,EAAE;wBACN,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;wBACvC,QAAQ,EAAE,CAAC;wBACX,QAAQ,EAAE,CAAC;qBACd;iBACJ;gBACD,MAAM,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,wBAAwB;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACpD,MAAM,MAAM,GAAW;gBACnB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,QAAQ,EAAE;wBACN,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;wBACvC,QAAQ,EAAE,CAAC;wBACX,QAAQ,EAAE,CAAC;qBACd;iBACJ;gBACD,MAAM,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,EAAE;gBAC9C,MAAM,EAAE,QAAQ;aACnB,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,4BAA4B;QACrE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC1D,MAAM,UAAU,GAAW;gBACvB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,QAAQ,EAAE;wBACN,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;wBACvC,QAAQ,EAAE,CAAC;wBACX,QAAQ,EAAE,CAAC;qBACd;iBACJ;gBACD,MAAM,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,iCAAiC,CAAC,UAAU,CAAC,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB;YACrD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}