@pascal-app/core 1.0.3 → 1.0.5

package/dist/agent-operations/index.d.ts

@@ -0,0 +1,489 @@
+import type { AgentOperation } from './types.js';
+export * from './achieved.js';
+export * from './add-column.js';
+export * from './add-fence.js';
+export * from './add-level.js';
+export * from './add-object.js';
+export * from './add-wall.js';
+export * from './apply-changes.js';
+export * from './apply-outcome.js';
+export * from './author-scene.js';
+export * from './authored-scene-merge.js';
+export * from './collections.js';
+export * from './corner-window.js';
+export * from './create-roof.js';
+export * from './create-room.js';
+export * from './create-stair.js';
+export * from './delete-node.js';
+export * from './design-brief.js';
+export * from './designs.js';
+export * from './door-clearance.js';
+export * from './duplicate-level.js';
+export * from './find-by-type.js';
+export * from './furnish-room.js';
+export * from './get-node.js';
+export * from './hosted-services.js';
+export * from './layout-clearance.js';
+export * from './level-height-fill.js';
+export * from './level-reads.js';
+export * from './level-target.js';
+export * from './list-levels.js';
+export * from './material-preset.js';
+export * from './material-refs.js';
+export * from './merge-windows.js';
+export * from './move-roofs.js';
+export * from './node-patch.js';
+export * from './paint.js';
+export * from './place-items.js';
+export * from './plan-geometry.js';
+export * from './point-context.js';
+export * from './project-files.js';
+export * from './roof-writes.js';
+export * from './room-floor-script.js';
+export * from './room-structure.js';
+export * from './scene-materials.js';
+export * from './scene-measure.js';
+export * from './scene-queries.js';
+export * from './scene-view.js';
+export * from './search-assets.js';
+export * from './search-materials.js';
+export * from './site.js';
+export * from './stairs.js';
+export * from './types.js';
+export * from './verify-scene.js';
+export * from './wall-face-script.js';
+export * from './wall-object-observations.js';
+export * from './wall-opening.js';
+export * from './wall-skirting.js';
+/** Each shared agent tool's operation, by tool name: what every surface executes. */
+export declare const AGENT_OPERATIONS: {
+    readonly cut_floor_opening: AgentOperation<{
+        levelId?: string;
+        zoneId?: string;
+        levelIds?: string[];
+        polygon?: number[][];
+        rect?: {
+            x: number;
+            z: number;
+            width: number;
+            depth: number;
+        };
+        drawnOn?: 'floor' | 'ceiling';
+        cutsPrimary?: boolean;
+        cutsAdjacent?: boolean;
+    }>;
+    readonly remove_floor_opening: AgentOperation<{
+        id: string;
+    }>;
+    readonly set_floor_foundation: AgentOperation<{
+        slabId?: string;
+        slabIds?: string[];
+    } & {
+        patch: unknown;
+    }>;
+    readonly set_room_floor_construction: AgentOperation<{
+        zoneId: string;
+        slabId?: string;
+        patch: unknown;
+    }>;
+    readonly rebase_floor_reference: AgentOperation<{
+        slabId?: string;
+        slabIds?: string[];
+    } & {
+        referenceFloorElevation: number | null;
+    }>;
+    readonly create_mezzanine: AgentOperation<{
+        hostZoneId: string;
+        polygon: number[][];
+        elevation?: number;
+        thickness?: number;
+    }>;
+    readonly move_zone: AgentOperation<{
+        zoneId: string;
+        translate?: number[];
+        rotate?: {
+            angle: number;
+            pivot?: number[];
+        };
+        force?: boolean;
+    }>;
+    readonly duplicate_zone: AgentOperation<{
+        zoneId: string;
+        translate?: number[];
+        rotate?: {
+            angle: number;
+            pivot?: number[];
+        };
+        force?: boolean;
+    } & {
+        translate: number[];
+    }>;
+    readonly rotate_zone: AgentOperation<{
+        zoneId: string;
+        quarterTurns: number;
+        gridStep?: number;
+        force?: boolean;
+    }>;
+    readonly lock_outside_faces: AgentOperation<{
+        levelId?: string;
+        zoneIds?: string[];
+    }>;
+    readonly set_zone_intent: AgentOperation<{
+        zoneId: string;
+        patch: unknown;
+    }>;
+    readonly divide_zone: AgentOperation<{
+        zoneId: string;
+        cut?: number[][];
+        path?: number[][];
+        closed?: boolean;
+        startBoundaryId?: string;
+        endBoundaryId?: string;
+    }>;
+    readonly merge_zones: AgentOperation<{
+        zoneIds: string[];
+    }>;
+    readonly delete_zone: AgentOperation<{
+        zoneId: string;
+        contents: 'delete' | 'keep';
+    }>;
+    readonly measure_stair: AgentOperation<{
+        stairId: string;
+        available?: {
+            width: number;
+            length: number;
+        } | undefined;
+    }>;
+    readonly fit_stair: AgentOperation<{
+        stairId: string;
+        fitRun: boolean;
+        layout?: "l" | "straight" | "u" | undefined;
+        turn?: "left" | "right" | undefined;
+        width?: number | undefined;
+        landingDepth?: number | undefined;
+        turningStrategy?: "landing" | "winder" | undefined;
+        innerGap?: number | undefined;
+        walkingLineOffset?: number | undefined;
+        division?: "equal-angle" | "equal-going" | undefined;
+        targets?: {
+            maxRiserHeight?: number | undefined;
+            minimumGoing?: number | undefined;
+            targetGoing?: number | undefined;
+            minimumHeadroom?: number | undefined;
+        } | undefined;
+    }>;
+    readonly list_levels: AgentOperation;
+    readonly get_node: AgentOperation<{
+        id: string;
+    }>;
+    readonly get_level_summary: AgentOperation<import("./level-target.js").LevelTargetInput>;
+    readonly get_walls: AgentOperation<import("./level-target.js").LevelTargetInput>;
+    readonly get_zones: AgentOperation<import("./level-target.js").LevelTargetInput>;
+    readonly duplicate_level: AgentOperation<{
+        levelId?: string;
+        position?: 'above' | 'below';
+        name?: string;
+        preset?: import("../building/index.js").LevelDuplicatePreset;
+    }>;
+    readonly set_ground_level: AgentOperation<{
+        levelId: string;
+    }>;
+    readonly verify_scene: AgentOperation<Readonly<Record<string, unknown>> | undefined>;
+    readonly validate_design: AgentOperation<{
+        design: string | Record<string, unknown>;
+        parameters?: Record<string, number>;
+    }>;
+    readonly place_design: AgentOperation<{
+        design: string | Record<string, unknown>;
+        hostId: string;
+        position: number[];
+        rotation?: number;
+        side?: 'front' | 'back';
+        surfaceId?: string;
+        parameters?: Record<string, number>;
+        slots?: Record<string, string>;
+        name?: string;
+        id?: string;
+    }>;
+    readonly set_checkpoint: AgentOperation<{
+        name: string;
+    }>;
+    readonly design_brief: AgentOperation<{
+        axes?: {
+            action?: {
+                kind: "bounded";
+                quote: string;
+                reading: string;
+                extent?: "exact" | "minimum" | undefined;
+            } | {
+                kind: "open";
+                design: string;
+            } | undefined;
+            size?: {
+                kind: "bounded";
+                quote: string;
+                reading: string;
+                extent?: "exact" | "minimum" | undefined;
+            } | {
+                kind: "open";
+                design: string;
+            } | undefined;
+            pieces?: {
+                kind: "bounded";
+                quote: string;
+                reading: string;
+                extent?: "exact" | "minimum" | undefined;
+            } | {
+                kind: "open";
+                design: string;
+            } | undefined;
+            openings?: {
+                kind: "bounded";
+                quote: string;
+                reading: string;
+                extent?: "exact" | "minimum" | undefined;
+            } | {
+                kind: "open";
+                design: string;
+            } | undefined;
+            style?: {
+                kind: "bounded";
+                quote: string;
+                reading: string;
+                extent?: "exact" | "minimum" | undefined;
+            } | {
+                kind: "open";
+                design: string;
+            } | undefined;
+            materials?: {
+                kind: "bounded";
+                quote: string;
+                reading: string;
+                extent?: "exact" | "minimum" | undefined;
+            } | {
+                kind: "open";
+                design: string;
+            } | undefined;
+            dressing?: {
+                kind: "bounded";
+                quote: string;
+                reading: string;
+                extent?: "exact" | "minimum" | undefined;
+            } | {
+                kind: "open";
+                design: string;
+            } | undefined;
+        } | undefined;
+        source: "brand" | "catalog" | "existing" | "open";
+        sourceQuote?: string | undefined;
+        brand?: string | undefined;
+        vision: string;
+        beyond: {
+            textiles: string[] | {
+                none: string;
+            };
+            light: string[] | {
+                none: string;
+            };
+            windows: string[] | {
+                none: string;
+            };
+            walls: string[] | {
+                none: string;
+            };
+            floor: string[] | {
+                none: string;
+            };
+            plants: string[] | {
+                none: string;
+            };
+            objects: string[] | {
+                none: string;
+            };
+            smallFurniture: string[] | {
+                none: string;
+            };
+        };
+        asIs?: {
+            assetId: string;
+            reason: string;
+        }[] | undefined;
+    }>;
+    readonly add_wall: AgentOperation<import("./level-target.js").LevelTargetInput & {
+        start: number[];
+        end: number[];
+        thickness?: number;
+        height?: number;
+        curveOffset?: number;
+    }>;
+    readonly add_fence: AgentOperation<import("./level-target.js").LevelTargetInput & {
+        points: number[][];
+        closed?: boolean;
+        height?: number;
+        style?: import("../index.js").FenceNode['style'];
+        baseStyle?: import("../index.js").FenceNode['baseStyle'];
+        materialPreset?: string;
+    }>;
+    readonly add_corner_window: AgentOperation<Omit<import("../building/index.js").CornerWindowInput, "levelId"> & import("./level-target.js").LevelTargetInput>;
+    readonly merge_windows: AgentOperation<{
+        windowIds: [string, string];
+    }>;
+    readonly add_level: AgentOperation<{
+        buildingId?: string;
+        position?: 'above' | 'below';
+        name?: string;
+        height?: number;
+    }>;
+    readonly create_stair: AgentOperation<{
+        levelId?: string | undefined;
+        level?: string | undefined;
+        x: number;
+        z: number;
+        rotation?: number | undefined;
+        layout?: "l" | "straight" | "u" | undefined;
+        turn?: "left" | "right" | undefined;
+        lowerSteps?: number | undefined;
+        width?: number | undefined;
+        length?: number | undefined;
+        height?: number | undefined;
+        steps?: number | undefined;
+        toLevelId?: string | null | undefined;
+        railingMode?: "both" | "left" | "none" | "right" | undefined;
+        railingStyle?: "balusters" | "boards" | "cable" | "glass" | "metal" | "post-and-rail" | undefined;
+        railingMaterial?: string | undefined;
+        materialPreset?: string | undefined;
+        name?: string | undefined;
+        createDestinationSlabOpening?: boolean | undefined;
+        createSourceCeilingOpening?: boolean | undefined;
+        destinationSlabId?: string | undefined;
+        sourceCeilingId?: string | undefined;
+        openingWidth?: number | undefined;
+        openingLength?: number | undefined;
+        openingOffset?: number | undefined;
+        openingCenter?: number[] | undefined;
+        openingRotation?: number | undefined;
+    }>;
+    readonly add_column: AgentOperation<import("./add-column.js").AddColumnInput>;
+    readonly create_roof: AgentOperation<{
+        levelId?: string;
+        level?: string;
+        roofSystem?: import("../index.js").RoofSystemType;
+        glazing?: import("../index.js").RoofGlazing;
+        barrelRise?: number;
+        barrelSegments?: number;
+        wallThickness?: number;
+        roofType?: import("../index.js").RoofType;
+        pitch?: number;
+        overhang?: number;
+        wallHeight?: number;
+        width?: number;
+        depth?: number;
+        center?: number[];
+        materialPreset?: string;
+        fasciaHeight?: number;
+        fasciaMaterialPreset?: string;
+        name?: string;
+    }>;
+    readonly move_roofs_to_roof_level: AgentOperation<{
+        levelId: string;
+    }>;
+    readonly place_items: AgentOperation<import("./level-target.js").LevelTargetInput & {
+        items: {
+            assetId: string;
+            x: number;
+            z: number;
+            y?: number;
+            rotation?: number;
+            targetNodeId?: string;
+        }[];
+    }>;
+    readonly delete_node: AgentOperation<{
+        id: string;
+    }>;
+    readonly find_by_type: AgentOperation<import("./find-by-type.js").FindByTypeInput>;
+    readonly create_room: AgentOperation<import("./level-target.js").LevelTargetInput & {
+        name: string;
+        polygon: number[][];
+        color?: string;
+        wallHeight?: number;
+        wallThickness?: number;
+        outdoor?: boolean;
+        rename?: boolean;
+        doors?: {
+            wallIndex: number;
+            t?: number;
+            width?: number;
+            height?: number;
+            sillHeight?: number;
+            hingesSide?: 'left' | 'right';
+            handleSide?: 'left' | 'right';
+            swingDirection?: 'inward' | 'outward';
+            style?: string;
+        }[];
+        windows?: {
+            wallIndex: number;
+            t?: number;
+            width?: number;
+            height?: number;
+            sillHeight?: number;
+            hingesSide?: 'left' | 'right';
+            handleSide?: 'left' | 'right';
+            swingDirection?: 'inward' | 'outward';
+            style?: string;
+        }[];
+    }>;
+    readonly furnish_room: AgentOperation<import("./level-target.js").LevelTargetInput & {
+        zoneId?: string;
+        polygon?: number[][];
+        roomType: "bathroom" | "bedroom" | "dining" | "entry" | "hallway" | "kitchen" | "laundry" | "living" | "storage";
+        doorWallIndex?: number;
+    }>;
+    readonly paint: AgentOperation<{
+        targets: string[];
+        role?: string;
+        color?: string;
+        material?: string | import("../index.js").MaterialSchema;
+        materialName?: string;
+        erase?: true;
+    }>;
+    readonly place_in_room: AgentOperation<import("./place-in-room.js").PlaceInRoomInput>;
+    readonly search_assets: AgentOperation<{
+        queries: {
+            query: string;
+            category?: string;
+        }[];
+    }>;
+    readonly view_assets: AgentOperation<{
+        ids: string[];
+    }>;
+    readonly search_materials: AgentOperation<{
+        queries: {
+            query?: string;
+            kind?: import("../index.js").MaterialCategory;
+            surface?: import("../index.js").MaterialSurface;
+            offset?: number;
+        }[];
+    }>;
+    readonly get_site: AgentOperation<{
+        building?: string;
+        site?: string;
+    }>;
+    readonly place_building: AgentOperation<{
+        building?: string;
+        outline?: number[][];
+        yards?: Partial<Record<import("../index.js").YardKey, number>>;
+        rotationDeg?: number;
+    }>;
+    readonly run_batch: AgentOperation<{
+        calls: {
+            tool: string;
+            input?: Record<string, unknown>;
+        }[];
+        onRefusal?: 'stop' | 'skip';
+    }>;
+};
+export { type AssetViewFacts, type AssetViewIO, type AssetViewLoader, type AssetViewSubject, assetViewNeeds, assetViewsReadCatalog, createAssetViewLoader, createFetchAssetViewIO, readGlbSurfaces, } from './asset-views.js';
+export { type PhotoFacePlan, planPhotoElevation } from './photo-elevation.js';
+export { recordMade } from './record-made.js';
+export { EMPTY_SESSION, keepInSession, madeEntries, parseSessionRecord, type SessionKeep, type SessionRecord, startOfSession, } from './scene-checkpoint.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-operations/index.d.ts.map

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

package/dist/agent-operations/index.js

@@ -0,0 +1,141 @@
+import { AGENT_TOOL_CONTRACTS, BATCHABLE_TOOLS } from '../agent-tools/index.js';
+import { addColumn } from './add-column.js';
+import { addFence } from './add-fence.js';
+import { addLevel } from './add-level.js';
+import { addObjectInBatch } from './add-object.js';
+import { addWall } from './add-wall.js';
+import { viewAssets } from './asset-views.js';
+import { createBatchOperation } from './batch.js';
+import { addCornerWindow } from './corner-window.js';
+import { createRoof } from './create-roof.js';
+import { createRoom } from './create-room.js';
+import { createStair } from './create-stair.js';
+import { deleteNode } from './delete-node.js';
+import { designBrief, gatedByBrief } from './design-brief.js';
+import { placeDesign, validateDesignOperation } from './designs.js';
+import { duplicateLevel } from './duplicate-level.js';
+import { findByType } from './find-by-type.js';
+import { furnishRoom } from './furnish-room.js';
+import { getNode } from './get-node.js';
+import { getLevelSummary, getWalls, getZones } from './level-reads.js';
+import { listLevels } from './list-levels.js';
+import { mergeWindowsOperation } from './merge-windows.js';
+import { moveRoofsToRoofLevel } from './move-roofs.js';
+import { paint } from './paint.js';
+import { placeInRoom } from './place-in-room.js';
+import { placeItems } from './place-items.js';
+import { ROOM_OPERATIONS } from './room-structure.js';
+import { searchAssets } from './search-assets.js';
+import { searchMaterials } from './search-materials.js';
+import { setCheckpoint } from './set-checkpoint.js';
+import { setGroundLevel } from './set-ground-level.js';
+import { getSite, placeBuilding } from './site.js';
+import { fitStair, measureStairOperation } from './stairs.js';
+import { verifyScene } from './verify-scene.js';
+export * from './achieved.js';
+export * from './add-column.js';
+export * from './add-fence.js';
+export * from './add-level.js';
+export * from './add-object.js';
+export * from './add-wall.js';
+export * from './apply-changes.js';
+export * from './apply-outcome.js';
+export * from './author-scene.js';
+export * from './authored-scene-merge.js';
+export * from './collections.js';
+export * from './corner-window.js';
+export * from './create-roof.js';
+export * from './create-room.js';
+export * from './create-stair.js';
+export * from './delete-node.js';
+export * from './design-brief.js';
+export * from './designs.js';
+export * from './door-clearance.js';
+export * from './duplicate-level.js';
+export * from './find-by-type.js';
+export * from './furnish-room.js';
+export * from './get-node.js';
+export * from './hosted-services.js';
+export * from './layout-clearance.js';
+export * from './level-height-fill.js';
+export * from './level-reads.js';
+export * from './level-target.js';
+export * from './list-levels.js';
+export * from './material-preset.js';
+export * from './material-refs.js';
+export * from './merge-windows.js';
+export * from './move-roofs.js';
+export * from './node-patch.js';
+export * from './paint.js';
+export * from './place-items.js';
+export * from './plan-geometry.js';
+export * from './point-context.js';
+export * from './project-files.js';
+export * from './roof-writes.js';
+export * from './room-floor-script.js';
+export * from './room-structure.js';
+export * from './scene-materials.js';
+export * from './scene-measure.js';
+export * from './scene-queries.js';
+export * from './scene-view.js';
+export * from './search-assets.js';
+export * from './search-materials.js';
+export * from './site.js';
+export * from './stairs.js';
+export * from './types.js';
+export * from './verify-scene.js';
+export * from './wall-face-script.js';
+export * from './wall-object-observations.js';
+export * from './wall-opening.js';
+export * from './wall-skirting.js';
+const SINGLE_OPERATIONS = {
+    measure_stair: measureStairOperation,
+    fit_stair: fitStair,
+    list_levels: listLevels,
+    get_node: getNode,
+    get_level_summary: getLevelSummary,
+    get_walls: getWalls,
+    get_zones: getZones,
+    duplicate_level: duplicateLevel,
+    set_ground_level: setGroundLevel,
+    verify_scene: verifyScene,
+    validate_design: validateDesignOperation,
+    place_design: gatedByBrief('place_design', placeDesign),
+    set_checkpoint: setCheckpoint,
+    design_brief: designBrief,
+    add_wall: addWall,
+    add_fence: addFence,
+    add_corner_window: addCornerWindow,
+    merge_windows: mergeWindowsOperation,
+    add_level: addLevel,
+    create_stair: createStair,
+    add_column: addColumn,
+    create_roof: createRoof,
+    move_roofs_to_roof_level: moveRoofsToRoofLevel,
+    place_items: gatedByBrief('place_items', placeItems),
+    delete_node: deleteNode,
+    find_by_type: findByType,
+    create_room: createRoom,
+    furnish_room: gatedByBrief('furnish_room', furnishRoom),
+    paint,
+    place_in_room: gatedByBrief('place_in_room', placeInRoom),
+    search_assets: searchAssets,
+    view_assets: viewAssets,
+    search_materials: searchMaterials,
+    get_site: getSite,
+    place_building: placeBuilding,
+    ...ROOM_OPERATIONS,
+};
+// add_object is no single operation: its host compiles the module first, so it exists here only as
+// the batch's call, which places what the host built.
+const BATCH_OPERATIONS = { ...SINGLE_OPERATIONS, add_object: addObjectInBatch };
+const BATCHED_OPERATIONS = Object.fromEntries(BATCHABLE_TOOLS.map((name) => [name, BATCH_OPERATIONS[name]]));
+/** Each shared agent tool's operation, by tool name: what every surface executes. */
+export const AGENT_OPERATIONS = {
+    ...SINGLE_OPERATIONS,
+    run_batch: createBatchOperation(BATCHED_OPERATIONS, AGENT_TOOL_CONTRACTS),
+};
+export { assetViewNeeds, assetViewsReadCatalog, createAssetViewLoader, createFetchAssetViewIO, readGlbSurfaces, } from './asset-views.js';
+export { planPhotoElevation } from './photo-elevation.js';
+export { recordMade } from './record-made.js';
+export { EMPTY_SESSION, keepInSession, madeEntries, parseSessionRecord, startOfSession, } from './scene-checkpoint.js';

package/dist/agent-operations/item-space.d.ts

@@ -0,0 +1,22 @@
+import { type AnyNode, type ItemNode } from '../schema/index.js';
+import { type PlanAabb } from './door-clearance.js';
+/**
+ * Where an item stands in its level's frame when it is hosted by another item (a lamp on a
+ * nightstand): its position is local to the host, so the plan checks read it through the host
+ * chain, each host's yaw turning the offset. An item hosted by a wall keeps wall-local
+ * coordinates and is read by the wall observations instead, so this answers nothing for it.
+ */
+export declare function itemLevelPose(node: ItemNode, byId: Map<string, AnyNode>): {
+    position: [number, number, number];
+    yawDeg: number;
+} | null;
+/** The item's plan footprint in its level's frame, or null when it is wall-hosted or malformed. */
+export declare function itemPlanAabbInLevel(node: ItemNode, byId: Map<string, AnyNode>): PlanAabb | null;
+/** The item's bottom and top above its level's floor, from its pose and scaled height. */
+export declare function itemLevelHeightRange(node: ItemNode, byId: Map<string, AnyNode>): {
+    min: number;
+    max: number;
+} | null;
+/** Every item above this one in its host chain: a thing and what it rests on are stacked by design, not colliding. */
+export declare function itemHosts(node: AnyNode, byId: Map<string, AnyNode>): Set<string>;
+//# sourceMappingURL=item-space.d.ts.map

package/dist/agent-operations/item-space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-space.d.ts","sourceRoot":"","sources":["../../src/agent-operations/item-space.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC5E,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAElE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GACzB;IAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqB/D;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,GAAG,IAAI,CAQ/F;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GACzB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWrC;AAED,sHAAsH;AACtH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAQhF"}