pyric 0.1.0-alpha.21 → 0.1.0-alpha.24

package/dist/database/connection-lifecycle.js

@@ -6,6 +6,7 @@ export class RtdbConnectionLifecycle {
     operations = new DisconnectOperationQueue();
     draining = null;
     online = true;
+    connectionListeners = new Set();
     resetGeneration;
     constructor(backend, auth, admin) {
         this.backend = backend;
@@ -14,7 +15,8 @@ export class RtdbConnectionLifecycle {
         this.resetGeneration = backend.connectionResetGeneration;
     }
     synchronizeReset() {
-        if (this.resetGeneration === this.backend.connectionResetGeneration)
+        const isCurrentGeneration = this.resetGeneration === this.backend.connectionResetGeneration;
+        if (isCurrentGeneration)
             return;
         this.operations.clear();
         this.online = true;
@@ -23,12 +25,15 @@ export class RtdbConnectionLifecycle {
     register(operation) {
         this.synchronizeReset();
         try {
-            if (!this.admin) {
-                if (operation.kind === 'update') {
+            const requiresRules = !this.admin;
+            if (requiresRules) {
+                const isUpdate = operation.kind === 'update';
+                if (isUpdate) {
                     this.backend.validateUpdate(this.auth(), operation.path, operation.values);
                 }
                 else {
-                    this.backend.validateSet(this.auth(), operation.path, operation.kind === 'remove' ? null : operation.value);
+                    const isRemove = operation.kind === 'remove';
+                    this.backend.validateSet(this.auth(), operation.path, isRemove ? null : operation.value);
                 }
             }
             this.operations.set(operation);
@@ -49,26 +54,45 @@ export class RtdbConnectionLifecycle {
     }
     goOffline() {
         this.synchronizeReset();
-        if (!this.online)
+        const isOffline = !this.online;
+        if (isOffline)
             return;
-        this.online = false;
+        this.setOnline(false);
         void this.drain().catch(() => undefined);
     }
     goOnline() {
         this.synchronizeReset();
-        this.online = true;
+        this.setOnline(true);
+    }
+    observeConnection(next) {
+        this.synchronizeReset();
+        this.connectionListeners.add(next);
+        next(this.online);
+        return () => { this.connectionListeners.delete(next); };
+    }
+    setOnline(online) {
+        const isUnchanged = this.online === online;
+        if (isUnchanged)
+            return;
+        this.online = online;
+        for (const listener of [...this.connectionListeners])
+            listener(online);
     }
     drain() {
         this.synchronizeReset();
-        if (this.draining)
-            return this.draining;
+        const currentDrain = this.draining;
+        const isDraining = currentDrain !== null;
+        if (isDraining)
+            return currentDrain;
         const queued = this.operations.takeAll();
         this.draining = (async () => {
             const failures = [];
             for (const operation of queued) {
                 try {
-                    if (operation.kind === 'update') {
-                        if (this.admin) {
+                    const isUpdate = operation.kind === 'update';
+                    const isAdmin = this.admin;
+                    if (isUpdate) {
+                        if (isAdmin) {
                             this.backend.adminUpdate(operation.path, operation.values);
                         }
                         else {
@@ -76,11 +100,14 @@ export class RtdbConnectionLifecycle {
                         }
                     }
                     else {
-                        const value = operation.kind === 'remove' ? null : operation.value;
-                        if (operation.kind === 'set' &&
-                            operation.mergeAfterChildRegistration &&
-                            value !== null && typeof value === 'object' && !Array.isArray(value)) {
-                            if (this.admin) {
+                        const isRemove = operation.kind === 'remove';
+                        const value = isRemove ? null : operation.value;
+                        const isSet = operation.kind === 'set';
+                        const mergesAfterChildRegistration = isSet && operation.mergeAfterChildRegistration === true;
+                        const hasObjectValue = value !== null && typeof value === 'object';
+                        const mergesObjectChildren = mergesAfterChildRegistration && hasObjectValue && !Array.isArray(value);
+                        if (mergesObjectChildren) {
+                            if (isAdmin) {
                                 this.backend.adminUpdate(operation.path, value);
                             }
                             else {
@@ -88,17 +115,19 @@ export class RtdbConnectionLifecycle {
                             }
                             continue;
                         }
-                        if (this.admin) {
-                            if (operation.kind === 'set' && operation.priority !== undefined) {
-                                this.backend.adminSetWithPriority(operation.path, value, operation.priority);
+                        const priority = isSet ? operation.priority : undefined;
+                        const hasPriority = priority !== undefined;
+                        if (isAdmin) {
+                            if (hasPriority) {
+                                this.backend.adminSetWithPriority(operation.path, value, priority);
                             }
                             else {
                                 this.backend.adminSet(operation.path, value);
                             }
                         }
                         else {
-                            if (operation.kind === 'set' && operation.priority !== undefined) {
-                                this.backend.setWithPriority(this.auth(), operation.path, value, operation.priority);
+                            if (hasPriority) {
+                                this.backend.setWithPriority(this.auth(), operation.path, value, priority);
                             }
                             else {
                                 this.backend.set(this.auth(), operation.path, value);
@@ -110,9 +139,11 @@ export class RtdbConnectionLifecycle {
                     failures.push(error);
                 }
             }
-            if (failures.length === 1)
+            const hasOneFailure = failures.length === 1;
+            if (hasOneFailure)
                 throw failures[0];
-            if (failures.length > 1)
+            const hasMultipleFailures = failures.length > 1;
+            if (hasMultipleFailures)
                 throw new AggregateError(failures, 'Multiple onDisconnect operations failed');
         })().finally(() => {
             this.draining = null;

package/dist/database/connection-lifecycle.js.map

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

package/dist/database/events.d.ts

@@ -0,0 +1,12 @@
+export declare const RTDB_EVENT_RECORD: {
+    readonly service: "rtdb";
+    readonly operations: readonly ["set", "update", "remove", "transaction", "setPriority"];
+    readonly target: {
+        readonly name: "path";
+        readonly description: "The database path the call targeted, e.g. /rooms/r1/messages.";
+        readonly always: true;
+    };
+};
+/** Every mutation operation the Realtime Database surface emits. */
+export type RtdbEventOperation = (typeof RTDB_EVENT_RECORD)['operations'][number];
+//# sourceMappingURL=events.d.ts.map

package/dist/database/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/database/events.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,iBAAiB;;;;;;;;CAQS,CAAC;AAExC,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/database/events.js

@@ -0,0 +1,10 @@
+export const RTDB_EVENT_RECORD = {
+    service: 'rtdb',
+    operations: ['set', 'update', 'remove', 'transaction', 'setPriority'],
+    target: {
+        name: 'path',
+        description: 'The database path the call targeted, e.g. /rooms/r1/messages.',
+        always: true,
+    },
+};
+//# sourceMappingURL=events.js.map

package/dist/database/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/database/events.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,CAAC;IACrE,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,+DAA+D;QAC5E,MAAM,EAAE,IAAI;KACb;CACoC,CAAC"}

package/dist/database/instances.d.ts

@@ -18,16 +18,16 @@ import { Database, type AppDatabase } from './types.js';
  * console.log(snap.val()); // { text: 'hi' }
  * ```
  */
-export declare function getDatabase(ctx: SandboxContext): Database;
-export declare function getDatabase(sandbox: Sandbox): Database;
-export declare function getDatabase(app: FirebaseApp): AppDatabase;
-export declare function getDatabase(): AppDatabase;
+export declare function getDatabase(ctx: SandboxContext, url?: string): Database;
+export declare function getDatabase(sandbox: Sandbox, url?: string): Database;
+export declare function getDatabase(app: FirebaseApp, url?: string): AppDatabase;
+export declare function getDatabase(url?: string): AppDatabase;
 /**
  * Sandbox-only rules-bypass RTDB handle. Mirrors Firestore's
  * `getAdminFirestore(sandbox)` for Studio/Playground data browsers and
  * controlled admin tools.
  */
-export declare function getAdminDatabase(sandbox: Sandbox): Database;
-export declare function getAdminDatabase(ctx: SandboxContext): Database;
-export declare function getAdminDatabase(app: FirebaseApp): Database;
+export declare function getAdminDatabase(sandbox: Sandbox, url?: string): Database;
+export declare function getAdminDatabase(ctx: SandboxContext, url?: string): Database;
+export declare function getAdminDatabase(app: FirebaseApp, url?: string): Database;
 //# sourceMappingURL=instances.d.ts.map

package/dist/database/instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/database/instances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAIxD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,QAAQ,CAAC;AAC3D,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;AACxD,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAAC;AAC3D,wBAAgB,WAAW,IAAI,WAAW,CAAC;AA8D3C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;AAC7D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,QAAQ,CAAC;AAChE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/database/instances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAIxD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;AACzE,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;AACtE,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;AACzE,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;AAyFvD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;AAC3E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;AAC9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC"}

package/dist/database/instances.js

@@ -1,24 +1,43 @@
 import { SandboxContextImpl } from 'pyric/sandbox';
 import { defaultClientApp, resolveClientApp } from '../sandbox/internal/client-app.js';
-import { getOrCreateBackend } from './sandbox/backend-for.js';
+import { canonicalizeDatabaseUrl, getOrCreateBackend } from './sandbox/backend-for.js';
 import { RtdbConnectionLifecycle } from './connection-lifecycle.js';
 import { Database } from './types.js';
-export function getDatabase(target) {
-    if (target === undefined)
-        return getDatabase(defaultClientApp());
+export function getDatabase(targetOrUrl, url) {
+    let target = targetOrUrl;
+    let effectiveUrl = url;
+    if (typeof targetOrUrl === 'string') {
+        target = defaultClientApp();
+        effectiveUrl = targetOrUrl;
+    }
+    else if (target === undefined) {
+        target = defaultClientApp();
+    }
     // Package resolution already selected the sandbox mirror; the neutral app
     // adapter resolves an associated FirebaseApp to its app-owned runtime.
     const appRuntime = resolveClientApp(target);
     if (appRuntime) {
-        return appRuntime.service('database/default', () => {
+        const app = target;
+        let appDbUrl;
+        try {
+            appDbUrl = app.options?.databaseURL;
+        }
+        catch {
+            // If app is already deleted, reading app.options throws app/app-deleted.
+        }
+        const finalUrl = effectiveUrl ?? appDbUrl;
+        const canonicalKey = canonicalizeDatabaseUrl(finalUrl);
+        return appRuntime.service(`database/${canonicalKey}`, () => {
             const { sandbox, session } = appRuntime;
             let deleted = false;
             appRuntime.onDelete(() => { deleted = true; });
-            const backend = getOrCreateBackend(sandbox);
+            const backend = getOrCreateBackend(sandbox, finalUrl);
             const connection = new RtdbConnectionLifecycle(backend, () => session.currentUser, false);
             appRuntime.onDelete(() => connection.drain().catch(() => undefined));
             const t = {
                 kind: 'sandbox-live',
+                activityApp: app,
+                activityScope: canonicalKey,
                 backend,
                 connection,
                 sandbox,
@@ -31,20 +50,22 @@ export function getDatabase(target) {
                     }
                 },
             };
-            return new Database(t, target);
+            return new Database(t, app);
         });
     }
     if (isSandboxContext(target)) {
-        const backend = getOrCreateBackend(target.sandbox);
+        const backend = getOrCreateBackend(target.sandbox, effectiveUrl);
         const connection = new RtdbConnectionLifecycle(backend, () => target.auth, false);
-        const t = { kind: 'sandbox', backend, auth: target.auth, connection };
+        const t = { kind: 'sandbox', activityApp: target, activityScope: canonicalizeDatabaseUrl(effectiveUrl), backend, auth: target.auth, connection };
         return new Database(t);
     }
     if (isSandbox(target)) {
-        const backend = getOrCreateBackend(target);
+        const backend = getOrCreateBackend(target, effectiveUrl);
         const connection = new RtdbConnectionLifecycle(backend, () => target.currentUser, false);
         const t = {
             kind: 'sandbox-live',
+            activityApp: target,
+            activityScope: canonicalizeDatabaseUrl(effectiveUrl),
             backend,
             connection,
             sandbox: target,
@@ -54,11 +75,12 @@ export function getDatabase(target) {
     }
     throw packageResolutionError();
 }
-export function getAdminDatabase(target) {
+export function getAdminDatabase(target, url) {
     const appRuntime = resolveClientApp(target);
     if (appRuntime) {
         appRuntime.assertAlive();
-        return getAdminDatabase(appRuntime.sandbox);
+        const effectiveUrl = url ?? target.options?.databaseURL;
+        return getAdminDatabase(appRuntime.sandbox, effectiveUrl);
     }
     const sandbox = isSandboxContext(target)
         ? target.sandbox
@@ -67,7 +89,7 @@ export function getAdminDatabase(target) {
             : undefined;
     if (sandbox === undefined)
         throw packageResolutionError();
-    const backend = getOrCreateBackend(sandbox);
+    const backend = getOrCreateBackend(sandbox, url);
     const connection = new RtdbConnectionLifecycle(backend, () => null, true);
     const t = { kind: 'sandbox', backend, auth: null, admin: true, connection };
     return new Database(t);

package/dist/database/instances.js.map

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

package/dist/database/internal/query-projection.d.ts

@@ -0,0 +1,102 @@
+import type { JsonValue } from '../sandbox/data-tree.js';
+/** Ordering selector. Stored as a discriminated union so the executor
+ *  can switch on the kind without re-parsing. */
+export type OrderBy = {
+    kind: 'child';
+    path: string;
+} | {
+    kind: 'key';
+} | {
+    kind: 'priority';
+} | {
+    kind: 'value';
+};
+export type Priority = string | number | null;
+/** Cursor or filter bound. `startAt`/`endAt` are inclusive; the
+ *  `*Exclusive` variants drop the boundary value. `equalTo` collapses
+ *  start + end onto the same value (and is sugar for `startAt(v) +
+ *  endAt(v)` per the SDK docs). */
+export type Bound = {
+    kind: 'startAt';
+    value: JsonValue;
+    key?: string;
+} | {
+    kind: 'startAfter';
+    value: JsonValue;
+    key?: string;
+} | {
+    kind: 'endAt';
+    value: JsonValue;
+    key?: string;
+} | {
+    kind: 'endBefore';
+    value: JsonValue;
+    key?: string;
+} | {
+    kind: 'equalTo';
+    value: JsonValue;
+    key?: string;
+};
+/** Window-size constraint. Mutually exclusive with each other (prod
+ *  rejects setting both — we don't reject here but the executor
+ *  prioritises the last one set, matching `firebase/database`). */
+export type LimitKind = 'limitToFirst' | 'limitToLast';
+/**
+ * A {@link Query} is a ref + a chain of constraints. The chain is
+ * order-independent in terms of declared shape — the executor groups
+ * constraints into {order, bounds, limit} during apply.
+ */
+export interface QuerySpec {
+    /** Active ordering. `null` means Firebase's default priority index. */
+    orderBy: OrderBy | null;
+    /** Range/equality filters. Multiple bounds compose. */
+    bounds: Bound[];
+    /** Optional limit. Last-wins if set more than once. */
+    limit: {
+        kind: LimitKind;
+        n: number;
+    } | null;
+}
+/**
+ * Compare two `JsonValue`s under RTDB's documented type-order rules.
+ * Locked by the upstream contract (Firebase docs: null < false < true
+ * < number < string < object). The sandbox's ordering only needs to
+ * match against same-type-or-null/undefined.
+ *
+ * Returns -1 / 0 / 1.
+ */
+export declare function compareValues(a: JsonValue, b: JsonValue): number;
+/**
+ * Compare two Firebase key names under RTDB's `nameCompare` ordering:
+ * integer-looking keys sort FIRST (numerically; ties broken by string
+ * length so `"01"` follows `"1"`), then non-integer keys sort
+ * lexicographically. Mirrors `nameCompare` (`core/util/util.ts:253-276`).
+ *
+ * This is RTDB's universal key order — it drives `orderByKey()`, the
+ * tie-break for `orderByChild`/`orderByValue`, and the `key` argument of
+ * `startAt(value, key)` / `endAt(value, key)` cursors. Plain
+ * lexicographic compare (DB-B4) put `"10"` before `"2"`.
+ */
+export declare function nameCompare(a: string, b: string): number;
+/**
+ * Extract the value the ordering uses to compare a child. For
+ * `orderByKey()` it's the key string; for `orderByValue()` the child's
+ * raw value; for `orderByChild(path)` the nested field at `path`
+ * (which may itself be missing → `null`).
+ */
+export declare function extractOrderValue(spec: OrderBy | null, key: string, value: JsonValue, priority?: Priority): JsonValue;
+/** Result row — kept minimal so the snap-builder can render it cheaply. */
+export interface QueryRow {
+    key: string;
+    value: JsonValue;
+    priority: Priority;
+}
+/**
+ * Run a {@link QuerySpec} against the data at a path. The caller passes
+ * the raw value at the path (a `Record<string, JsonValue>` if it's a
+ * collection, anything else → empty result).
+ *
+ * Returns an ordered, filtered, limited list of rows.
+ */
+export declare function executeQuery(pathData: JsonValue, spec: QuerySpec, priorityForKey?: (key: string) => Priority): QueryRow[];
+//# sourceMappingURL=query-projection.d.ts.map

package/dist/database/internal/query-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-projection.d.ts","sourceRoot":"","sources":["../../../src/database/internal/query-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;iDACiD;AACjD,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE9C;;;mCAGmC;AACnC,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD;;mEAEmE;AACnE,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,aAAa,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,uDAAuD;IACvD,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,uDAAuD;IACvD,KAAK,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAsChE;AAmCD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBxD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,GAAG,IAAI,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,EAChB,QAAQ,GAAE,QAAe,GACxB,SAAS,CAyBX;AAED,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,SAAS,EACf,cAAc,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,QAAqB,GACrD,QAAQ,EAAE,CAqDZ"}