@angriff36/manifest 2.18.0

package/dist/manifest/multi-compiler.js

@@ -0,0 +1,324 @@
+import { Parser } from './parser.js';
+import { IRCompiler, computeIRHash } from './ir-compiler.js';
+import { resolveModuleGraph } from './module-resolver.js';
+import { COMPILER_VERSION, SCHEMA_VERSION } from './version.js';
+/**
+ * Compile multiple .manifest files into a single merged IR.
+ *
+ * Pipeline:
+ * 1. Resolve dependency graph (topological sort, cycle detection)
+ * 2. Compile each file in dependency order via IRCompiler
+ * 3. Validate cross-file references (entity names, relationships)
+ * 4. Merge all IRs into single output with multi-source provenance
+ */
+export async function compileProjectToIR(options) {
+    const { entries, host, useCache = true, basePath = '' } = options;
+    const diagnostics = [];
+    const sources = [];
+    // Phase 1: Resolve module graph
+    const parser = new Parser();
+    const parseFn = (source) => parser.parse(source);
+    const resolution = await resolveModuleGraph(entries, host, parseFn);
+    // Convert resolution diagnostics to IR diagnostics
+    for (const d of resolution.diagnostics) {
+        diagnostics.push({
+            severity: d.severity,
+            message: d.file ? `[${d.file}] ${d.message}` : d.message,
+        });
+    }
+    if (resolution.diagnostics.some(d => d.severity === 'error')) {
+        return { ir: null, diagnostics, sources };
+    }
+    // Phase 1.5: Build a project-wide composition index so that an entity can
+    // `extends` or `mixin` a base declared in a different file. We parse every file
+    // once and collect all entity AST nodes (root + module level) by name. The
+    // per-file compile consults this only for parent/mixin resolution; each file
+    // still emits exactly its own entities, and cross-file duplicates are caught in
+    // Phase 3 below.
+    const compositionContext = {};
+    for (const file of resolution.order) {
+        const { program } = parser.parse(file.source);
+        for (const entity of program.entities) {
+            // First declaration wins for the lookup index; genuine cross-file duplicates
+            // are reported as errors in Phase 3.
+            if (!compositionContext[entity.name])
+                compositionContext[entity.name] = entity;
+        }
+        for (const mod of program.modules) {
+            for (const entity of mod.entities) {
+                if (!compositionContext[entity.name])
+                    compositionContext[entity.name] = entity;
+            }
+        }
+    }
+    // Phase 2: Compile each file in topological order
+    const compiledIRs = [];
+    const compiler = new IRCompiler();
+    for (const file of resolution.order) {
+        const result = await compiler.compileToIR(file.source, {
+            useCache,
+            sourcePath: file.absPath,
+            compositionContext,
+        });
+        for (const d of result.diagnostics) {
+            diagnostics.push({
+                ...d,
+                message: `[${file.absPath}] ${d.message}`,
+            });
+        }
+        if (!result.ir) {
+            return { ir: null, diagnostics, sources };
+        }
+        compiledIRs.push({ ir: result.ir, absPath: file.absPath });
+        sources.push({
+            absPath: file.absPath,
+            contentHash: result.ir.provenance.contentHash,
+        });
+    }
+    // Phase 3: Cross-file validation
+    const entityNames = new Map(); // name → sourceFile
+    const enumNames = new Map();
+    const commandKeys = new Map(); // "entity.command" or "command" → sourceFile
+    let tenantFile;
+    for (const { ir, absPath } of compiledIRs) {
+        // Check entity name uniqueness
+        for (const entity of ir.entities) {
+            const existing = entityNames.get(entity.name);
+            if (existing) {
+                diagnostics.push({
+                    severity: 'error',
+                    message: `Duplicate entity '${entity.name}' declared in '${absPath}' and '${existing}'`,
+                });
+            }
+            else {
+                entityNames.set(entity.name, absPath);
+            }
+        }
+        // Check enum name uniqueness
+        for (const en of ir.enums) {
+            const existing = enumNames.get(en.name);
+            if (existing) {
+                diagnostics.push({
+                    severity: 'error',
+                    message: `Duplicate enum '${en.name}' declared in '${absPath}' and '${existing}'`,
+                });
+            }
+            else {
+                enumNames.set(en.name, absPath);
+            }
+        }
+        // Check command uniqueness (entity-scoped)
+        for (const cmd of ir.commands) {
+            const key = cmd.entity ? `${cmd.entity}.${cmd.name}` : cmd.name;
+            const existing = commandKeys.get(key);
+            if (existing) {
+                diagnostics.push({
+                    severity: 'error',
+                    message: `Duplicate command '${key}' declared in '${absPath}' and '${existing}'`,
+                });
+            }
+            else {
+                commandKeys.set(key, absPath);
+            }
+        }
+        // Check tenant uniqueness
+        if (ir.tenant) {
+            if (tenantFile) {
+                diagnostics.push({
+                    severity: 'error',
+                    message: `Duplicate tenant declaration in '${absPath}' and '${tenantFile}'`,
+                });
+            }
+            else {
+                tenantFile = absPath;
+            }
+        }
+    }
+    if (diagnostics.some(d => d.severity === 'error')) {
+        return { ir: null, diagnostics, sources };
+    }
+    // Cross-file relationship target validation
+    for (const { ir, absPath } of compiledIRs) {
+        for (const entity of ir.entities) {
+            for (const rel of entity.relationships) {
+                if (!entityNames.has(rel.target)) {
+                    diagnostics.push({
+                        severity: 'error',
+                        message: `[${absPath}] Entity '${entity.name}' has relationship '${rel.name}' targeting unknown entity '${rel.target}'`,
+                    });
+                }
+                if (rel.through && !entityNames.has(rel.through)) {
+                    diagnostics.push({
+                        severity: 'error',
+                        message: `[${absPath}] Entity '${entity.name}' has relationship '${rel.name}' with unknown through entity '${rel.through}'`,
+                    });
+                }
+            }
+        }
+        // Validate store entity references
+        for (const store of ir.stores) {
+            if (!entityNames.has(store.entity)) {
+                diagnostics.push({
+                    severity: 'error',
+                    message: `[${absPath}] Store references unknown entity '${store.entity}'`,
+                });
+            }
+        }
+    }
+    if (diagnostics.some(d => d.severity === 'error')) {
+        return { ir: null, diagnostics, sources };
+    }
+    // Phase 4: Merge IRs into single output
+    const mergedIR = mergeIRs(compiledIRs.map(c => c.ir), sources, basePath);
+    // Compute IR hash for the merged result
+    const irHash = await computeIRHash(mergedIR);
+    mergedIR.provenance.irHash = irHash;
+    return { ir: mergedIR, diagnostics, sources };
+}
+/**
+ * Merge multiple already-compiled IRs into a single deterministic IR (public API).
+ *
+ * Thin wrapper over the internal multi-file merge for callers that already hold
+ * compiled IRs (e.g. composing IRs from separately-compiled sources). Provenance
+ * sources are derived from each input IR's provenance. The result's irHash is NOT
+ * recomputed — call computeIRHash(result) if a content hash is required.
+ */
+export function mergeIR(irs) {
+    const sources = irs.flatMap(ir => ir.provenance.sources && ir.provenance.sources.length > 0
+        ? ir.provenance.sources.map(s => ({ absPath: s.path, contentHash: s.contentHash }))
+        : [{ absPath: ir.provenance.contentHash, contentHash: ir.provenance.contentHash }]);
+    return mergeIRs(irs, sources, '');
+}
+/**
+ * Merge multiple IR outputs into a single deterministic IR.
+ * Arrays are concatenated and sorted by name for determinism.
+ * Modules with the same name are merged (union of members).
+ */
+function mergeIRs(irs, sources, basePath) {
+    const entities = [];
+    const enums = [];
+    const stores = [];
+    const events = [];
+    const commands = [];
+    const policies = [];
+    const values = [];
+    const reactions = [];
+    const roles = [];
+    const sagas = [];
+    const webhooks = [];
+    const schedules = [];
+    const moduleMap = new Map();
+    let tenant;
+    for (const ir of irs) {
+        entities.push(...ir.entities);
+        enums.push(...ir.enums);
+        stores.push(...ir.stores);
+        events.push(...ir.events);
+        commands.push(...ir.commands);
+        policies.push(...ir.policies);
+        values.push(...ir.values);
+        if (ir.reactions)
+            reactions.push(...ir.reactions);
+        if (ir.roles)
+            roles.push(...ir.roles);
+        if (ir.sagas)
+            sagas.push(...ir.sagas);
+        if (ir.webhooks)
+            webhooks.push(...ir.webhooks);
+        if (ir.schedules)
+            schedules.push(...ir.schedules);
+        if (ir.tenant && !tenant) {
+            tenant = ir.tenant;
+        }
+        // Merge modules by name
+        for (const mod of ir.modules) {
+            const existing = moduleMap.get(mod.name);
+            if (existing) {
+                existing.entities = [...new Set([...existing.entities, ...mod.entities])].sort();
+                existing.enums = [...new Set([...existing.enums, ...mod.enums])].sort();
+                existing.commands = [...new Set([...existing.commands, ...mod.commands])].sort();
+                existing.stores = [...new Set([...existing.stores, ...mod.stores])].sort();
+                existing.events = [...new Set([...existing.events, ...mod.events])].sort();
+                existing.policies = [...new Set([...existing.policies, ...mod.policies])].sort();
+                if (mod.reactions) {
+                    existing.reactions = [...new Set([...(existing.reactions ?? []), ...mod.reactions])].sort();
+                }
+                if (mod.roles) {
+                    existing.roles = [...new Set([...(existing.roles ?? []), ...mod.roles])].sort();
+                }
+                if (mod.sagas) {
+                    existing.sagas = [...new Set([...(existing.sagas ?? []), ...mod.sagas])].sort();
+                }
+                if (mod.schedules) {
+                    existing.schedules = [...new Set([...(existing.schedules ?? []), ...mod.schedules])].sort();
+                }
+                if (mod.webhooks) {
+                    existing.webhooks = [...new Set([...(existing.webhooks ?? []), ...mod.webhooks])].sort();
+                }
+            }
+            else {
+                moduleMap.set(mod.name, { ...mod });
+            }
+        }
+    }
+    // Sort all arrays by name for determinism
+    entities.sort((a, b) => a.name.localeCompare(b.name));
+    enums.sort((a, b) => a.name.localeCompare(b.name));
+    stores.sort((a, b) => a.entity.localeCompare(b.entity));
+    events.sort((a, b) => a.name.localeCompare(b.name));
+    commands.sort((a, b) => {
+        const aKey = a.entity ? `${a.entity}.${a.name}` : a.name;
+        const bKey = b.entity ? `${b.entity}.${b.name}` : b.name;
+        return aKey.localeCompare(bKey);
+    });
+    policies.sort((a, b) => a.name.localeCompare(b.name));
+    values.sort((a, b) => a.name.localeCompare(b.name));
+    reactions.sort((a, b) => `${a.event}.${a.targetEntity}`.localeCompare(`${b.event}.${b.targetEntity}`));
+    roles.sort((a, b) => a.name.localeCompare(b.name));
+    sagas.sort((a, b) => a.name.localeCompare(b.name));
+    webhooks.sort((a, b) => a.name.localeCompare(b.name));
+    schedules.sort((a, b) => a.name.localeCompare(b.name));
+    const modules = [...moduleMap.values()].sort((a, b) => a.name.localeCompare(b.name));
+    // Create merged provenance
+    const sortedHashes = sources.map(s => s.contentHash).sort();
+    const mergedContentHash = sortedHashes.join(':');
+    const provenanceSources = sources
+        .map(s => ({
+        path: basePath ? s.absPath.replace(basePath, '').replace(/^[/\\]/, '') : s.absPath,
+        contentHash: s.contentHash,
+    }))
+        .sort((a, b) => a.path.localeCompare(b.path));
+    const provenance = {
+        contentHash: mergedContentHash,
+        compilerVersion: COMPILER_VERSION,
+        schemaVersion: SCHEMA_VERSION,
+        compiledAt: new Date().toISOString(),
+        sources: provenanceSources,
+    };
+    const ir = {
+        version: '1.0',
+        provenance,
+        modules,
+        values,
+        entities,
+        enums,
+        stores,
+        events,
+        commands,
+        policies,
+    };
+    if (tenant)
+        ir.tenant = tenant;
+    if (reactions.length > 0)
+        ir.reactions = reactions;
+    if (roles.length > 0)
+        ir.roles = roles;
+    if (sagas.length > 0)
+        ir.sagas = sagas;
+    if (webhooks.length > 0)
+        ir.webhooks = webhooks;
+    if (schedules.length > 0)
+        ir.schedules = schedules;
+    return ir;
+}
+//# sourceMappingURL=multi-compiler.js.map

package/dist/manifest/multi-compiler.js.map

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

package/dist/manifest/outbox/outbox-store.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Outbox store contract.
+ *
+ * Where transactional persistence is supported, state mutation and semantic
+ * event persistence share the same transaction boundary. The `OutboxStore`
+ * adapter is the contract the runtime calls inside its mutation transaction
+ * to durably enqueue emitted events.
+ *
+ * This module defines the contract only. Concrete stores (Memory, Postgres)
+ * land in a follow-on. Wire-in via RuntimeOptions.outboxStore.
+ */
+import type { EmittedEvent } from '../runtime-engine';
+export type OutboxEntryStatus = 'pending' | 'delivered' | 'failed';
+export interface OutboxEntry {
+    /** Stable id assigned by the store on enqueue. */
+    entryId: string;
+    /** Timestamp the entry was enqueued (ms since epoch). */
+    enqueuedAt: number;
+    /** The event payload to be delivered. */
+    event: EmittedEvent;
+    /** Current delivery status. */
+    status: OutboxEntryStatus;
+    /** Number of delivery attempts. */
+    attempts: number;
+    /** Last error message, when status === 'failed'. */
+    lastError?: string;
+}
+/**
+ * OutboxStore: enqueues semantic events for at-least-once delivery to
+ * downstream consumers. The runtime calls `enqueue` inside the same
+ * transaction that mutates entity state, so a successful command either
+ * writes both the state change AND the outbox entries, or rolls back both.
+ *
+ * The `tx` parameter is intentionally typed `unknown` to keep the contract
+ * adapter-agnostic; Prisma/PgClient transactions are the typical concrete
+ * type.
+ */
+export interface OutboxStore {
+    /**
+     * Enqueue one or more outbox entries. MUST participate in the supplied
+     * transaction; if `tx` is undefined the store MAY enqueue independently
+     * (best-effort) and SHOULD warn about reduced durability guarantees.
+     */
+    enqueue(entries: OutboxEntry[], tx?: unknown): Promise<void>;
+    /**
+     * Claim up to `batchSize` pending entries for delivery. Implementations
+     * SHOULD use database-level locking (e.g. SELECT … FOR UPDATE SKIP LOCKED)
+     * so multiple workers can dispatch concurrently.
+     */
+    claim(batchSize: number): Promise<OutboxEntry[]>;
+    /** Mark entries delivered. Called by the dispatcher worker. */
+    markDelivered(entryIds: string[]): Promise<void>;
+    /** Mark entries failed with a reason. Caller decides retry semantics. */
+    markFailed(entryIds: string[], error: string): Promise<void>;
+}
+//# sourceMappingURL=outbox-store.d.ts.map

package/dist/manifest/outbox/outbox-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-store.d.ts","sourceRoot":"","sources":["../../../src/manifest/outbox/outbox-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,KAAK,EAAE,YAAY,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEjD,+DAA+D;IAC/D,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,yEAAyE;IACzE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D"}

package/dist/manifest/outbox/outbox-store.js

@@ -0,0 +1,13 @@
+/**
+ * Outbox store contract.
+ *
+ * Where transactional persistence is supported, state mutation and semantic
+ * event persistence share the same transaction boundary. The `OutboxStore`
+ * adapter is the contract the runtime calls inside its mutation transaction
+ * to durably enqueue emitted events.
+ *
+ * This module defines the contract only. Concrete stores (Memory, Postgres)
+ * land in a follow-on. Wire-in via RuntimeOptions.outboxStore.
+ */
+export {};
+//# sourceMappingURL=outbox-store.js.map

package/dist/manifest/outbox/outbox-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-store.js","sourceRoot":"","sources":["../../../src/manifest/outbox/outbox-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/manifest/outbox/stores/dynamodb.d.ts

@@ -0,0 +1,100 @@
+/**
+ * DynamoDBOutboxStore — OutboxStore adapter backed by AWS DynamoDB.
+ *
+ * The outbox pattern requires a transactional guarantee: when a command
+ * mutates entity state, the semantic event must be persisted atomically
+ * with that state change. DynamoDB provides this via TransactWriteItems,
+ * which groups up to 100 actions (Put / Update / Delete / ConditionCheck)
+ * into a single ACID transaction.
+ *
+ * Concurrency model for `claim`: dispatchers scan the table for pending
+ * entries and atomically update each to "claimed" via a conditional
+ * UpdateItem with `ConditionExpression: status = 'pending'`. The first
+ * worker to win the condition race claims the entry; the rest get a
+ * `ConditionalCheckFailedException` and move on. This provides safe
+ * concurrent dispatch without explicit row locks.
+ *
+ * Stream integration: the companion `manifest_outbox_table` is configured
+ * with DynamoDB Streams. A Lambda or Kinesis consumer can process the
+ * stream for at-least-once delivery to downstream sinks (SNS, SQS, EventBridge).
+ * The `claim`/`markDelivered`/`markFailed` methods are the pull-based
+ * alternative; stream consumers implement their own tracking.
+ *
+ * Item shape:
+ *   {
+ *     pk:         "OUTBOX#<entryId>",   // partition key
+ *     sk:         "META",                // sort key (single-table friendly)
+ *     entry_id:   string,
+ *     enqueued_at: number,               // ms since epoch
+ *     event:      object,                // EmittedEvent payload
+ *     status:     "pending" | "delivered" | "failed",
+ *     attempts:   number,
+ *     last_error: string | null,
+ *     claimed_at: number | null,
+ *     delivered_at: number | null,
+ *     failed_at:   number | null,
+ *     subject_entity: string | null,     // optional projection
+ *     subject_id:     string | null,
+ *   }
+ *
+ * DO NOT import this file in browser code — it requires the AWS SDK.
+ */
+import type { OutboxEntry, OutboxStore } from '../outbox-store';
+export interface DynamoDBOutboxStoreOptions {
+    /**
+     * An initialized DynamoDB DocumentClient. The store does NOT own the
+     * client's lifecycle. The caller is responsible for configuration
+     * (region, endpoint, credentials).
+     */
+    client: any;
+    /** Table name. Default: `manifest_outbox_table`. */
+    tableName?: string;
+    /** Partition key attribute name. Default: `pk`. */
+    partitionKey?: string;
+    /** Sort key attribute name. Default: `sk`. */
+    sortKey?: string;
+    /**
+     * When true, project `event.subject.entity` and `event.subject.id` into
+     * separate attributes. Useful for query patterns that filter by subject.
+     * Default: false.
+     */
+    projectSubject?: boolean;
+}
+export declare class DynamoDBOutboxStore implements OutboxStore {
+    private client;
+    private tableName;
+    private partitionKey;
+    private sortKey;
+    private projectSubject;
+    constructor(opts: DynamoDBOutboxStoreOptions);
+    private buildKey;
+    /**
+     * Enqueue entries. The DynamoDB adapter batches up to 100 items per
+     * TransactWriteItems call. The `tx` parameter is accepted for contract
+     * compatibility with other outbox stores (e.g. Postgres), but DynamoDB
+     * transactions are scoped to a single client invocation and cannot be
+     * shared across separate API calls. Therefore, the transactional
+     * guarantee is always within a single `enqueue` call: either all
+     * entries in the batch are persisted, or none are.
+     *
+     * If you need to atomically enqueue entries together with entity state
+     * mutations, use the `TransactWriteItems` API directly and group the
+     * outbox PutItems with the entity PutItems in a single call.
+     */
+    enqueue(entries: OutboxEntry[], tx?: unknown): Promise<void>;
+    /**
+     * Claim up to `batchSize` pending entries. Scans the table for
+     * 'pending' entries and atomically transitions each to 'claimed'
+     * via a conditional UpdateItem. The first worker to win the
+     * condition race claims the entry.
+     *
+     * Note: Scan is used here for simplicity. For high-volume outboxes,
+     * maintain a GSI on `status` to enable efficient Query.
+     */
+    claim(batchSize: number): Promise<OutboxEntry[]>;
+    /** Mark entries delivered. */
+    markDelivered(entryIds: string[]): Promise<void>;
+    /** Mark entries failed with a reason. */
+    markFailed(entryIds: string[], error: string): Promise<void>;
+}
+//# sourceMappingURL=dynamodb.d.ts.map

package/dist/manifest/outbox/stores/dynamodb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb.d.ts","sourceRoot":"","sources":["../../../../src/manifest/outbox/stores/dynamodb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IAEH,MAAM,EAAE,GAAG,CAAC;IACZ,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAkCD,qBAAa,mBAAoB,YAAW,WAAW;IAErD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAU;gBAEpB,IAAI,EAAE,0BAA0B;IAQ5C,OAAO,CAAC,QAAQ;IAIhB;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA8ClE;;;;;;;;OAQG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0DtD,8BAA8B;IACxB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBtD,yCAAyC;IACnC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BnE"}