@jolly-pixel/engine 1.0.0

package/README.md

@@ -0,0 +1,209 @@
+<p align="center"><h1 align="center">
+  engine
+</h1>
+
+<p align="center">
+  JollyPixel Three.js engine
+</p>
+
+## 📌 About
+
+Minimal and opinionated [ECS](https://en.wikipedia.org/wiki/Entity_component_system) built on top of Three.js.
+
+> [!NOTE]
+> JollyPixel is heavily inspired by [Superpowers](https://github.com/superpowers) for the naming (such as Actor instead of Entity).
+
+## 💡 Features
+
+- Actor/Component architecture with scene tree
+- Godot-like [Signals](https://docs.godotengine.org/en/stable/getting_started/step_by_step/signals.html) for Actors and Components
+- Behavior scripts
+- Input controls (mouse, keyboard, gamepads, touchpad)
+- Built-in renderers (3D models, 3D text, sprites, …)
+- Asset management
+- Audio (background music, sound library, spatial audio)
+
+## 💃 Getting Started
+
+This package is available in the Node Package Repository and can be easily installed with [npm](https://docs.npmjs.com/getting-started/what-is-npm) or [yarn](https://yarnpkg.com).
+
+```bash
+$ npm i @jolly-pixel/engine
+# or
+$ yarn add @jolly-pixel/engine
+```
+
+## 📚 API
+
+### ⚙️ Systems
+
+Systems are responsible for driving the game loop, orchestrating rendering, and managing shared
+resources such as assets. They operate on actors and their components
+each frame.
+
+- [GameInstance](./docs/systems/game-instance.md) — top-level orchestrator that ties the renderer, scene,
+  input, and audio into a unified game loop.
+  - [GameRenderer](./docs/systems/game-renderer.md) — abstracts the Three.js render pipeline and supports
+    direct and post-processing render strategies.
+  - [Scene](./docs/systems/scene.md) — the ECS world manager that owns the actor tree and drives
+    per-frame lifecycle (awake → start → update → destroy).
+- [Asset](./docs/asset.md) — lazy-loading asset pipeline with a
+  registry of loaders, a queue, and a cache.
+
+```ts
+import { Systems, Actor } from "@jolly-pixel/engine";
+
+const scene = new Systems.SceneEngine();
+const renderer = new Systems.ThreeRenderer(canvas, {
+  scene,
+  renderMode: "direct"
+});
+const game = new Systems.GameInstance(renderer, {
+  enableOnExit: true,
+  scene
+});
+
+game.connect();
+```
+
+> [!TIP]
+> [@jolly-pixel/runtime](../runtime/README.md) manage most of that for you
+
+### 🎭 Actor
+
+An Actor is a named node in the scene tree that holds a Transform, a list of Components, and a
+dictionary of Behaviors. The engine uses the name *Actor* (inspired by
+[Superpowers](https://github.com/superpowers)) instead of the
+traditional *Entity* term.
+
+- [ActorTree](./docs/actor/actor-tree.md) — tree structure that
+  manages parent-child actor relationships and provides pattern-based
+  lookups.
+- [Actor](./docs/actor/actor.md) — the entity itself, holding its
+  transform, components, and behaviors.
+  - [Transform](./docs/actor/actor-transform.md) — built-in component
+    wrapping a Three.js Object3D and exposing a complete local/global
+    transform API (position, orientation, scale, movement).
+
+```ts
+const player = new Actor(gameInstance, { name: "player" });
+player.transform.setLocalPosition(0, 1, 0);
+
+const child = new Actor(gameInstance, {
+  name: "weapon",
+  parent: player
+});
+```
+
+### 🧩 Components
+
+Components are pure data and logic units attached to an Actor. They come in three flavours:
+
+- [ActorComponent](./docs/actor/actor-component.md) — the base class all components extend (behaviors and renderers are ActorComponent).
+- [Renderers](./docs/components/renderers.md) — visual components (sprites, models, text, tiled maps) that know how to draw themselves.
+  - [Camera Controls](./docs/components/camera-3d-controls.md)
+- [Behavior](./docs/components/behavior.md) — script components with a property system and decorator-driven initialization.
+  - [Signals](./docs/components/signal.md) — lightweight pub/sub event emitter for actor-level communication (Godot-inspired signals).
+
+```ts
+import {
+  Behavior, ModelRenderer, Input,
+  Signal, SceneProperty, type SignalEvent
+} from "@jolly-pixel/engine";
+
+class PlayerBehavior extends Behavior {
+  @Signal()
+  onHit: SignalEvent;
+
+  @SceneProperty({ type: "number" })
+  speed = 0.05;
+
+  @Input.listen("keyboard.down")
+  onKeyDown() {
+    console.log("key pressed");
+  }
+
+  update() {
+    if (this.actor.gameInstance.input.isKeyDown("ArrowUp")) {
+      this.actor.transform.moveForward(this.speed);
+    }
+  }
+}
+
+new Actor(gameInstance, { name: "player" })
+  .registerComponent(ModelRenderer, { path: "models/Player.glb" })
+  .registerComponent(PlayerBehavior);
+```
+
+### 🎮 Device Controls
+
+Aggregates all physical devices (mouse, keyboard, gamepads, touchpad, screen) behind a unified
+query API so that behaviors can react to player actions without
+coupling to a specific device.
+
+- [Input](./docs/controls/input.md) — central input manager
+  - [Mouse](./docs/controls/mouse.md)
+  - [Keyboard](./docs/controls/keyboard.md)
+  - [Gamepad](./docs/controls/gamepad.md)
+  - [Touchpad](./docs/controls/touchpad.md)
+  - [Screen](./docs/controls/screen.md)
+- [CombinedInput](./docs/controls/combinedinput.md) — composable input conditions (AND, OR, NOT, sequence)
+  for complex key bindings.
+
+```ts
+import { InputCombination } from "@jolly-pixel/engine";
+
+const { input } = gameInstance;
+
+if (input.isKeyDown("Space")) {
+  console.log("jump!");
+}
+
+const dashCombo = InputCombination.all(
+  InputCombination.key("ShiftLeft"),
+  InputCombination.key("ArrowRight")
+);
+if (dashCombo.evaluate(input)) {
+  console.log("dash!");
+}
+```
+
+### 🔊 Audio
+
+Manages sound playback across the engine. It provides a global volume controller, a factory for creating audio sources, and a playlist-based background music manager.
+
+- [Audio](./docs/audio/audio.md) — global audio controller owning the
+  AudioContext and master volume.
+  - [AudioBackground](./docs/audio/audio-background.md) —
+    playlist-based background music with sequential track playback,
+    pause/resume/stop, and playlist chaining.
+
+```ts
+import { GlobalAudioManager, AudioBackground } from "@jolly-pixel/engine";
+
+const audioManager = GlobalAudioManager.fromGameInstance(gameInstance);
+const bg = new AudioBackground({
+  audioManager,
+  autoPlay: true,
+  playlists: [{
+    name: "main",
+    onEnd: "loop",
+    tracks: [
+      { name: "theme", path: "audio/theme.mp3" }
+    ]
+  }]
+});
+
+gameInstance.audio.observe(bg);
+gameInstance.audio.volume = 0.5;
+```
+
+### 🔨 Internals
+
+- [Adapters](./docs/internals/adapters.md)
+- [Audio](./docs/internals/audio.md)
+- [FixedTimeStep](./docs/internals/fixed-time-step.md)
+
+## License
+
+MIT

package/dist/actor/Actor.d.ts

@@ -0,0 +1,39 @@
+import * as THREE from "three";
+import { type GameInstance } from "../systems/GameInstance.ts";
+import { ActorTree } from "./ActorTree.ts";
+import { Transform } from "./Transform.ts";
+import type { Behavior } from "../components/script/Behavior.ts";
+import type { Component } from "../components/types.ts";
+type ComponentConstructor = new (actor: Actor, ...args: any[]) => Component;
+type RequiresOptions<T extends ComponentConstructor> = T extends new (actor: Actor, options: infer O, ...args: any[]) => any ? undefined extends O ? false : true : false;
+export interface ActorOptions {
+    name: string;
+    parent?: Actor | null;
+    visible?: boolean;
+    layer?: number | number[];
+}
+export declare class Actor extends ActorTree {
+    gameInstance: GameInstance;
+    name: string;
+    awoken: boolean;
+    parent: Actor | null;
+    components: Component[];
+    behaviors: Record<string, Behavior<any>[]>;
+    transform: Transform;
+    pendingForDestruction: boolean;
+    threeObject: THREE.Group<THREE.Object3DEventMap>;
+    constructor(gameInstance: GameInstance, options: ActorOptions);
+    registerComponent<T extends ComponentConstructor>(componentClass: T, ...args: RequiresOptions<T> extends true ? [options: ConstructorParameters<T>[1], callback?: (component: InstanceType<T>) => void] : [options?: ConstructorParameters<T>[1], callback?: (component: InstanceType<T>) => void]): this;
+    registerComponentAndGet<T extends ComponentConstructor>(componentClass: T, ...args: RequiresOptions<T> extends true ? [options: ConstructorParameters<T>[1]] : [options?: ConstructorParameters<T>[1]]): InstanceType<T>;
+    awake(): void;
+    update(deltaTime: number): void;
+    isDestroyed(): boolean;
+    destroy(): void;
+    markDestructionPending(): void;
+    addBehavior<T extends new (...args: any) => Behavior>(behaviorClass: T, properties?: ConstructorParameters<T>[0]): Behavior<Record<string, import("../components/script/Behavior.ts").BehaviorPropertiesValue>>;
+    getBehavior<T extends new (...args: any) => any>(behaviorClass: T): InstanceType<T> | null;
+    getBehaviors<T extends new (...args: any) => any>(behaviorClass: T): IterableIterator<InstanceType<T>>;
+    setParent(newParent: Actor, keepLocal?: boolean): void;
+}
+export {};
+//# sourceMappingURL=Actor.d.ts.map

package/dist/actor/Actor.d.ts.map

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

package/dist/actor/Actor.js

@@ -0,0 +1,171 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+// Import Internal Dependencies
+import {} from "../systems/GameInstance.js";
+import { ActorTree } from "./ActorTree.js";
+import { Transform } from "./Transform.js";
+export class Actor extends ActorTree {
+    gameInstance;
+    name;
+    awoken = false;
+    parent = null;
+    components = [];
+    behaviors = {};
+    transform;
+    pendingForDestruction = false;
+    threeObject = new THREE.Group();
+    constructor(gameInstance, options) {
+        super();
+        const { name, parent = null, visible = true, layer } = options;
+        if (parent !== null && parent.pendingForDestruction) {
+            throw new Error("Cannot add actor to a parent that is pending for destruction.");
+        }
+        this.gameInstance = gameInstance;
+        this.name = name;
+        this.parent = parent;
+        this.threeObject.visible = visible;
+        this.threeObject.name = this.name;
+        this.threeObject.userData.isActor = true;
+        if (layer) {
+            const layers = Array.isArray(layer) ? layer : [layer];
+            for (const layer of layers) {
+                this.threeObject.layers.enable(layer);
+                this.gameInstance.scene.getSource().layers.enable(layer);
+            }
+        }
+        this.transform = new Transform(this.threeObject);
+        if (parent) {
+            parent.add(this);
+            parent.threeObject.add(this.threeObject);
+            this.threeObject.updateMatrixWorld(false);
+        }
+        else {
+            this.gameInstance.scene.tree.add(this);
+        }
+    }
+    registerComponent(componentClass, ...args) {
+        const [options, callback] = args;
+        const component = new componentClass(this, options);
+        if (this.components.indexOf(component) === -1) {
+            this.components.push(component);
+        }
+        const index = this.gameInstance.scene.componentsToBeStarted.indexOf(component);
+        if (index === -1) {
+            this.gameInstance.scene.componentsToBeStarted.push(component);
+        }
+        callback?.(component);
+        if (this.awoken) {
+            component.awake?.();
+        }
+        return this;
+    }
+    registerComponentAndGet(componentClass, ...args) {
+        const [options] = args;
+        const component = new componentClass(this, options);
+        if (this.components.indexOf(component) === -1) {
+            this.components.push(component);
+        }
+        const index = this.gameInstance.scene.componentsToBeStarted.indexOf(component);
+        if (index === -1) {
+            this.gameInstance.scene.componentsToBeStarted.push(component);
+        }
+        if (this.awoken) {
+            component.awake?.();
+        }
+        return component;
+    }
+    awake() {
+        this.components.forEach((component) => component.awake?.());
+    }
+    update(deltaTime) {
+        if (!this.pendingForDestruction) {
+            this.components.forEach((component) => component.update?.(deltaTime));
+        }
+    }
+    isDestroyed() {
+        return this.pendingForDestruction;
+    }
+    destroy() {
+        this.components.forEach((component) => component.destroy?.());
+        if (this.parent === null) {
+            this.gameInstance.scene.tree.remove(this);
+        }
+        else {
+            this.parent.threeObject.remove(this.threeObject);
+            this.parent.remove(this);
+        }
+        this.threeObject.clear();
+    }
+    markDestructionPending() {
+        this.pendingForDestruction = true;
+        this.destroyAllActors();
+    }
+    addBehavior(behaviorClass, properties = Object.create(null)) {
+        const behavior = new behaviorClass(this);
+        for (const [propertyName, value] of Object.entries(properties)) {
+            behavior.setProperty(propertyName, value);
+        }
+        if (this.awoken) {
+            // @ts-ignore
+            behavior.awake?.();
+        }
+        return behavior;
+    }
+    getBehavior(behaviorClass) {
+        for (const behaviorName in this.behaviors) {
+            if (!Object.hasOwn(this.behaviors, behaviorName)) {
+                continue;
+            }
+            for (const behavior of this.behaviors[behaviorName]) {
+                if (behavior instanceof behaviorClass &&
+                    !behavior.isDestroyed()) {
+                    return behavior;
+                }
+            }
+        }
+        return null;
+    }
+    *getBehaviors(behaviorClass) {
+        for (const behaviorName in this.behaviors) {
+            if (!Object.hasOwn(this.behaviors, behaviorName)) {
+                continue;
+            }
+            for (const behavior of this.behaviors[behaviorName]) {
+                if (behavior instanceof behaviorClass &&
+                    !behavior.isDestroyed()) {
+                    yield behavior;
+                }
+            }
+        }
+    }
+    setParent(newParent, keepLocal = false) {
+        if (this.pendingForDestruction) {
+            throw new Error("Cannot set parent of destroyed actor");
+        }
+        if (newParent !== null && newParent.pendingForDestruction) {
+            throw new Error("Cannot reparent actor to destroyed actor");
+        }
+        if (!keepLocal) {
+            this.transform.getGlobalMatrix(Transform.Matrix);
+        }
+        const oldSiblings = (this.parent === null) ? this.gameInstance.scene.tree : this.parent;
+        oldSiblings.remove(this);
+        this.threeObject.parent?.remove(this.threeObject);
+        this.parent = newParent;
+        const siblings = (newParent === null) ?
+            this.gameInstance.scene.tree :
+            newParent;
+        siblings.add(this);
+        const threeParent = (newParent === null) ?
+            this.gameInstance.scene.getSource() :
+            newParent.threeObject;
+        threeParent.add(this.threeObject);
+        if (keepLocal) {
+            this.threeObject.updateMatrixWorld(false);
+        }
+        else {
+            this.transform.setGlobalMatrix(Transform.Matrix);
+        }
+    }
+}
+//# sourceMappingURL=Actor.js.map

package/dist/actor/Actor.js.map

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

package/dist/actor/ActorComponent.d.ts

@@ -0,0 +1,19 @@
+import { EventEmitter } from "@posva/event-emitter";
+import { Actor } from "./Actor.ts";
+import type { Component, FreeComponentEnum } from "../components/types.ts";
+export interface ActorComponentOptions {
+    actor: Actor;
+    typeName: FreeComponentEnum;
+}
+export type ActorComponentEvents = {
+    metadataInitialized: [];
+};
+export declare class ActorComponent extends EventEmitter<ActorComponentEvents> implements Component {
+    actor: Actor;
+    typeName: FreeComponentEnum;
+    pendingForDestruction: boolean;
+    constructor(options: ActorComponentOptions);
+    isDestroyed(): boolean;
+    destroy(): void;
+}
+//# sourceMappingURL=ActorComponent.d.ts.map

package/dist/actor/ActorComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorComponent.d.ts","sourceRoot":"","sources":["../../src/actor/ActorComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,mBAAmB,EAAE,EAAE,CAAC;CACzB,CAAC;AAEF,qBAAa,cAAe,SAAQ,YAAY,CAAC,oBAAoB,CAAE,YAAW,SAAS;IACzF,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,qBAAqB,UAAS;gBAG5B,OAAO,EAAE,qBAAqB;IAUhC,WAAW;IAIX,OAAO;CAWR"}

package/dist/actor/ActorComponent.js

@@ -0,0 +1,30 @@
+// Import Third-party Dependencies
+import { EventEmitter } from "@posva/event-emitter";
+// Import Internal Dependencies
+import { Actor } from "./Actor.js";
+export class ActorComponent extends EventEmitter {
+    actor;
+    typeName;
+    pendingForDestruction = false;
+    constructor(options) {
+        super();
+        this.actor = options.actor;
+        this.typeName = options.typeName;
+        this.actor.components.push(this);
+        this.actor.gameInstance.scene.componentsToBeStarted.push(this);
+    }
+    isDestroyed() {
+        return this.pendingForDestruction;
+    }
+    destroy() {
+        const startIndex = this.actor.gameInstance.scene.componentsToBeStarted.indexOf(this);
+        if (startIndex !== -1) {
+            this.actor.gameInstance.scene.componentsToBeStarted.splice(startIndex, 1);
+        }
+        const index = this.actor.components.indexOf(this);
+        if (index !== -1) {
+            this.actor.components.splice(index, 1);
+        }
+    }
+}
+//# sourceMappingURL=ActorComponent.js.map

package/dist/actor/ActorComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorComponent.js","sourceRoot":"","sources":["../../src/actor/ActorComponent.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,+BAA+B;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAenC,MAAM,OAAO,cAAe,SAAQ,YAAkC;IACpE,KAAK,CAAQ;IACb,QAAQ,CAAoB;IAE5B,qBAAqB,GAAG,KAAK,CAAC;IAE9B,YACE,OAA8B;QAE9B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAEjC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED,OAAO;QACL,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrF,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/actor/ActorTree.d.ts

@@ -0,0 +1,31 @@
+import { Actor } from "./Actor.ts";
+export type ActorTreeNode = {
+    actor: Actor;
+    parent?: Actor;
+};
+export interface ActorTreeOptions {
+    addCallback?: (actor: Actor) => void;
+    removeCallback?: (actor: Actor) => void;
+}
+export declare class ActorTree {
+    #private;
+    children: Actor[];
+    constructor(options?: ActorTreeOptions);
+    add(actor: Actor): void;
+    remove(actor: Actor): void;
+    getActors(pattern: string): IterableIterator<Actor>;
+    /**
+     * @example
+     * const player = actor.children.getActor("player");
+     * const playerPhysicsBox = actor.children.getActor("player/physics_box");
+     */
+    getActor(name: string): Actor | null;
+    getRootActors(): IterableIterator<Actor>;
+    getAllActors(): IterableIterator<Actor>;
+    destroyActor(actor: Actor): void;
+    destroyAllActors(): void;
+    walk(): IterableIterator<ActorTreeNode>;
+    walkFromNode(rootNode: Actor): IterableIterator<ActorTreeNode>;
+    [Symbol.iterator](): IterableIterator<Actor>;
+}
+//# sourceMappingURL=ActorTree.d.ts.map

package/dist/actor/ActorTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorTree.d.ts","sourceRoot":"","sources":["../../src/actor/ActorTree.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACrC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzC;AAED,qBAAa,SAAS;;IAIpB,QAAQ,EAAE,KAAK,EAAE,CAAM;gBAGrB,OAAO,GAAE,gBAAqB;IAMhC,GAAG,CACD,KAAK,EAAE,KAAK,GACX,IAAI;IAKP,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAQxB,SAAS,CACT,OAAO,EAAE,MAAM,GACd,gBAAgB,CAAC,KAAK,CAAC;IAuF1B;;;;OAIG;IACH,QAAQ,CACN,IAAI,EAAE,MAAM,GACX,KAAK,GAAG,IAAI;IAqCb,aAAa,IAAI,gBAAgB,CAAC,KAAK,CAAC;IAQxC,YAAY,IAAI,gBAAgB,CAAC,KAAK,CAAC;IAMzC,YAAY,CACV,KAAK,EAAE,KAAK;IAOd,gBAAgB;IAiBd,IAAI,IAAI,gBAAgB,CAAC,aAAa,CAAC;IAMvC,YAAY,CACZ,QAAQ,EAAE,KAAK,GACd,gBAAgB,CAAC,aAAa,CAAC;IAMhC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC;CAO/C"}