@appport/sdk 1.0.1

package/node_modules/@appport/core/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAuB,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGlG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;QACnD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAGvE;AAmFD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAGzE;AA6CD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,GAAG,mBAAmB,CAMrH;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,mBAAmB,CAyC5F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,mBAAmB,GAAG,GAAG,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAEzF"}

package/node_modules/@appport/core/dist/manifest.js

@@ -0,0 +1,255 @@
+/**
+ * Application Manifest (PR19)
+ *
+ * Canonical application identity and contract description.
+ *
+ * The manifest represents the externally meaningful boundary of an application:
+ * what it provides, what it requires, and the contract metadata.
+ *
+ * CRITICAL: The manifest contains NO implementation details:
+ * - No JavaScript functions
+ * - No handlers
+ * - No runtime closures
+ * - No filesystem paths
+ * - No process information
+ * - No secrets or credentials
+ * - No transport-specific bindings
+ *
+ * This allows the same application contract to be implemented in any language
+ * while maintaining an identical manifest, identity, and fingerprint.
+ */
+import { sha256 } from "./sha256.js";
+/**
+ * Canonical manifest serialization.
+ *
+ * Deterministic JSON representation with:
+ * - Alphabetical property ordering
+ * - Sorted capability lists
+ * - Sorted requirement lists
+ * - Consistent formatting
+ *
+ * Equivalent manifests produce identical serializations.
+ */
+export function serializeManifest(manifest) {
+    const canonical = canonicalizeManifest(manifest);
+    return JSON.stringify(canonical);
+}
+/**
+ * Convert manifest to canonical form for serialization.
+ * Ensures deterministic property and array ordering.
+ */
+function canonicalizeManifest(manifest) {
+    return {
+        protocol: manifest.protocol,
+        application: {
+            id: manifest.application.id,
+            name: manifest.application.name,
+            version: manifest.application.version
+        },
+        ...(manifest.metadata !== undefined ? { metadata: canonicalizeJson(manifest.metadata) } : {}),
+        provides: manifest.provides
+            .slice() // Copy to avoid mutation
+            .sort((a, b) => {
+            const nameComp = a.name.localeCompare(b.name);
+            return nameComp !== 0 ? nameComp : a.version - b.version;
+        })
+            .map(canonicalizeCapabilityManifest),
+        requires: manifest.requires
+            .slice() // Copy to avoid mutation
+            .sort((a, b) => {
+            const nameComp = a.name.localeCompare(b.name);
+            return nameComp !== 0 ? nameComp : a.version - b.version;
+        })
+            .map((r) => ({
+            name: r.name,
+            version: r.version,
+            ...(r.versionConstraint !== undefined ? { versionConstraint: r.versionConstraint } : {}),
+            ...(r.provider !== undefined ? { provider: r.provider } : {})
+        }))
+    };
+}
+function canonicalizeJson(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalizeJson);
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.keys(value).sort().map(key => [key, canonicalizeJson(value[key])]));
+    }
+    return value;
+}
+/**
+ * Canonicalize a capability manifest entry.
+ */
+function canonicalizeCapabilityManifest(cap) {
+    const result = {
+        name: cap.name,
+        version: cap.version,
+        kind: cap.kind,
+        inputSchema: canonicalizeJson(cap.inputSchema),
+        outputSchema: canonicalizeJson(cap.outputSchema),
+        authorization: Array.from(cap.authorization).sort()
+    };
+    if (cap.description !== undefined) {
+        result.description = cap.description;
+    }
+    if (cap.idempotency !== undefined) {
+        result.idempotency = cap.idempotency;
+    }
+    if (cap.concurrency !== undefined) {
+        result.concurrency = {
+            mode: cap.concurrency.mode,
+            ...(cap.concurrency.key !== undefined ? { key: cap.concurrency.key } : {})
+        };
+    }
+    if (cap.timeoutMs !== undefined) {
+        result.timeoutMs = cap.timeoutMs;
+    }
+    result.emits = Array.from(cap.emits).sort();
+    result.deprecated = cap.deprecated;
+    return result;
+}
+/**
+ * Calculate deterministic fingerprint of a manifest.
+ *
+ * The fingerprint is a SHA256 hash of the canonical serialization.
+ * Identical application contracts produce identical fingerprints
+ * regardless of:
+ * - Implementation language
+ * - Declaration order
+ * - Implementation details
+ * - Runtime state
+ *
+ * The fingerprint CHANGES when:
+ * - Capability version changes
+ * - Authorization requirements change
+ * - Input/output schema changes
+ * - Concurrency policy changes
+ * - Timeouts change
+ * - Required capabilities change
+ * - Any contract metadata changes
+ *
+ * The fingerprint DOES NOT CHANGE when:
+ * - Implementation functions change
+ * - Handler logic changes
+ * - Declaration order changes
+ * - Only runtime state changes
+ */
+export function fingerprintManifest(manifest) {
+    const canonical = serializeManifest(manifest);
+    return sha256(canonical);
+}
+/**
+ * Convert a CapabilityDefinition to a CapabilityManifestEntry.
+ *
+ * Extracts contract information while excluding implementation details:
+ * - Excludes handler function
+ * - Excludes implementation binding
+ * - Preserves all contract metadata
+ */
+function capabilityToManifestEntry(capability) {
+    return {
+        name: capability.name,
+        version: capability.version,
+        kind: capability.kind,
+        ...(capability.description ? { description: capability.description } : {}),
+        inputSchema: schemaToJsonValue(capability.input),
+        outputSchema: schemaToJsonValue(capability.output),
+        authorization: capability.authorization,
+        ...(capability.idempotency ? { idempotency: capability.idempotency } : {}),
+        ...(capability.concurrency ? { concurrency: capability.concurrency } : {}),
+        ...(capability.timeoutMs ? { timeoutMs: capability.timeoutMs } : {}),
+        emits: capability.emits,
+        deprecated: capability.deprecated
+    };
+}
+/**
+ * Convert a Schema to a JSON-serializable value.
+ * This is needed because Schema objects are not directly JSON-serializable.
+ */
+function schemaToJsonValue(schema) {
+    // Schemas have a toJSONSchema() method for serialization
+    if (typeof schema === "object" && schema !== null && "toJSONSchema" in schema) {
+        return schema.toJSONSchema();
+    }
+    // Fallback: convert to JSON string and parse (for direct JSON schemas)
+    if (typeof schema === "object" && schema !== null) {
+        return schema;
+    }
+    return schema;
+}
+/**
+ * Generate a canonical ApplicationManifest from a verified ApplicationAssembly.
+ *
+ * IMPORTANT: The assembly must be verified and ready before generating the manifest.
+ * A manifest should represent a coherent, ready-to-run application.
+ *
+ * If you need to generate a manifest from an invalid assembly for debugging,
+ * use generateManifestUnchecked() instead.
+ */
+export function generateManifest(assembly, verification) {
+    if (!verification.ready) {
+        throw new Error("Cannot generate manifest: application is not verified and ready. Call assembly.verify() first.");
+    }
+    return generateManifestUnchecked(assembly);
+}
+/**
+ * Generate an ApplicationManifest from an ApplicationAssembly without verification.
+ *
+ * WARNING: This generates a manifest even if the assembly is invalid.
+ * Only use this for debugging or testing invalid applications.
+ *
+ * For production code, use generateManifest() which requires verification.
+ */
+export function generateManifestUnchecked(assembly) {
+    const provides = [];
+    for (const capability of assembly.provides) {
+        provides.push(capabilityToManifestEntry(capability));
+    }
+    // Sort provides by name then version for determinism
+    provides.sort((a, b) => {
+        const nameComp = a.name.localeCompare(b.name);
+        return nameComp !== 0 ? nameComp : a.version - b.version;
+    });
+    const requires = [];
+    for (const required of assembly.requires) {
+        requires.push({
+            name: required.name,
+            version: required.version,
+            ...(required.versionConstraint ? { versionConstraint: required.versionConstraint } : {}),
+            ...(required.provider ? { provider: required.provider } : {})
+        });
+    }
+    // Sort requires by name then version for determinism
+    requires.sort((a, b) => {
+        const nameComp = a.name.localeCompare(b.name);
+        return nameComp !== 0 ? nameComp : a.version - b.version;
+    });
+    return {
+        protocol: "AppPort/1",
+        application: {
+            id: assembly.identity.id,
+            name: assembly.identity.name,
+            version: assembly.identity.version
+        },
+        ...(assembly.metadata ? { metadata: assembly.metadata } : {}),
+        provides,
+        requires
+    };
+}
+/**
+ * Convert a manifest to a JSON-compatible object suitable for serialization.
+ *
+ * This is equivalent to JSON.parse(serializeManifest(manifest)).
+ */
+export function manifestToJson(manifest) {
+    return JSON.parse(serializeManifest(manifest));
+}
+/**
+ * Verify that two manifests are semantically equivalent.
+ *
+ * Returns true if they describe the same application contract,
+ * regardless of declaration order or other non-semantic differences.
+ */
+export function manifestsAreEqual(a, b) {
+    return fingerprintManifest(a) === fingerprintManifest(b);
+}
+//# sourceMappingURL=manifest.js.map

package/node_modules/@appport/core/dist/manifest.js.map

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

package/node_modules/@appport/core/dist/memory-application-data-store.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Memory Application Data Store (Testing)
+ *
+ * In-memory implementation of ApplicationDataStore for testing.
+ * Do NOT use in production.
+ */
+import type { ApplicationStateTransaction, ApplicationDataStore, CreateTransactionOptions } from "./state-context.js";
+/**
+ * Memory-backed application data store for testing.
+ *
+ * Provides in-memory transaction management without persistence.
+ * Use only for testing and development.
+ */
+export declare class MemoryApplicationDataStore implements ApplicationDataStore {
+    #private;
+    createTransaction(options: CreateTransactionOptions): Promise<ApplicationStateTransaction>;
+    getTransaction(transactionId: string): Promise<ApplicationStateTransaction | undefined>;
+}
+//# sourceMappingURL=memory-application-data-store.d.ts.map

package/node_modules/@appport/core/dist/memory-application-data-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-application-data-store.d.ts","sourceRoot":"","sources":["../src/memory-application-data-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,2BAA2B,EAE3B,oBAAoB,EACpB,wBAAwB,EAEzB,MAAM,oBAAoB,CAAC;AAO5B;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,oBAAoB;;IAI/D,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAa1F,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC;CAG9F"}

package/node_modules/@appport/core/dist/memory-application-data-store.js

@@ -0,0 +1,161 @@
+/**
+ * Memory Application Data Store (Testing)
+ *
+ * In-memory implementation of ApplicationDataStore for testing.
+ * Do NOT use in production.
+ */
+import { randomUUID } from "crypto";
+import { ApplicationStateTransactionState as TransactionState, StateOperationError, TransactionStateError } from "./state-context.js";
+/**
+ * Memory-backed application data store for testing.
+ *
+ * Provides in-memory transaction management without persistence.
+ * Use only for testing and development.
+ */
+export class MemoryApplicationDataStore {
+    #data = new Map();
+    #transactions = new Map();
+    async createTransaction(options) {
+        const transactionId = randomUUID();
+        const transaction = new MemoryStateTransaction(transactionId, options.applicationId, options.invocationId, this.#data, options.authorization);
+        this.#transactions.set(transactionId, transaction);
+        return transaction;
+    }
+    async getTransaction(transactionId) {
+        return this.#transactions.get(transactionId);
+    }
+}
+/**
+ * Memory-backed state transaction.
+ */
+class MemoryStateTransaction {
+    #transactionId;
+    #applicationId;
+    #invocationId;
+    #appData;
+    #authorization;
+    #state = TransactionState.OPEN;
+    #writes = new Map();
+    #deletes = new Set();
+    constructor(transactionId, applicationId, invocationId, appData, authorization) {
+        this.#transactionId = transactionId;
+        this.#applicationId = applicationId;
+        this.#invocationId = invocationId;
+        this.#appData = appData;
+        this.#authorization = authorization;
+    }
+    get transactionId() {
+        return this.#transactionId;
+    }
+    get state() {
+        return this.#state;
+    }
+    get applicationId() {
+        return this.#applicationId;
+    }
+    get invocationId() {
+        return this.#invocationId;
+    }
+    async get(key) {
+        if (this.#state !== TransactionState.OPEN) {
+            throw new TransactionStateError(this.#state, "get");
+        }
+        if (!this.#authorization?.read) {
+            throw new StateOperationError("Read denied by authorization", "unauthorized");
+        }
+        if (this.#deletes.has(key)) {
+            return undefined;
+        }
+        if (this.#writes.has(key)) {
+            return this.#writes.get(key);
+        }
+        const appState = this.#appData.get(this.#applicationId);
+        return appState?.get(key);
+    }
+    async set(key, value) {
+        if (this.#state !== TransactionState.OPEN) {
+            throw new TransactionStateError(this.#state, "set");
+        }
+        if (!this.#authorization?.write) {
+            throw new StateOperationError("Write denied by authorization", "unauthorized");
+        }
+        if (typeof key !== "string" || !key) {
+            throw new StateOperationError("Key must be a non-empty string", "invalid_key");
+        }
+        this.#writes.set(key, value);
+        this.#deletes.delete(key);
+    }
+    async delete(key) {
+        if (this.#state !== TransactionState.OPEN) {
+            throw new TransactionStateError(this.#state, "delete");
+        }
+        if (!this.#authorization?.delete) {
+            throw new StateOperationError("Delete denied by authorization", "unauthorized");
+        }
+        if (typeof key !== "string" || !key) {
+            throw new StateOperationError("Key must be a non-empty string", "invalid_key");
+        }
+        this.#deletes.add(key);
+        this.#writes.delete(key);
+    }
+    async query(pattern, limit) {
+        if (this.#state !== TransactionState.OPEN) {
+            throw new TransactionStateError(this.#state, "query");
+        }
+        if (!(this.#authorization?.query || this.#authorization?.read)) {
+            throw new StateOperationError("Query denied by authorization", "unauthorized");
+        }
+        const results = [];
+        const appState = this.#appData.get(this.#applicationId) ?? new Map();
+        // From durable storage
+        for (const [key, value] of appState) {
+            if (key.startsWith(pattern) && !this.#deletes.has(key)) {
+                const displayValue = this.#writes.has(key) ? this.#writes.get(key) : value;
+                results.push({ key, value: displayValue });
+            }
+        }
+        // Add new writes not yet in durable storage
+        for (const [key, value] of this.#writes) {
+            if (key.startsWith(pattern) && !appState.has(key) && !this.#deletes.has(key)) {
+                results.push({ key, value });
+            }
+        }
+        if (limit) {
+            return results.slice(0, limit);
+        }
+        return results;
+    }
+    async commit() {
+        if (this.#state === TransactionState.COMMITTED) {
+            return;
+        }
+        if (this.#state === TransactionState.ABORTED) {
+            throw new TransactionStateError(this.#state, "commit");
+        }
+        // Persist writes
+        let appState = this.#appData.get(this.#applicationId);
+        if (!appState) {
+            appState = new Map();
+            this.#appData.set(this.#applicationId, appState);
+        }
+        for (const [key, value] of this.#writes) {
+            appState.set(key, value);
+        }
+        for (const key of this.#deletes) {
+            appState.delete(key);
+        }
+        this.#state = TransactionState.COMMITTED;
+    }
+    async abort() {
+        if (this.#state === TransactionState.ABORTED) {
+            return;
+        }
+        if (this.#state === TransactionState.COMMITTED) {
+            throw new TransactionStateError(this.#state, "abort");
+        }
+        this.#writes.clear();
+        this.#deletes.clear();
+        this.#state = TransactionState.ABORTED;
+    }
+}
+//# sourceMappingURL=memory-application-data-store.js.map

package/node_modules/@appport/core/dist/memory-application-data-store.js.map

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

package/node_modules/@appport/core/dist/operations.d.ts

@@ -0,0 +1,61 @@
+import { type JsonValue, type OperationRecord, type OperationRef, type OperationStatus } from "@appport/protocol";
+import { type AnyCapability } from "./capability.js";
+/**
+ * Long-running operations (specification §47).
+ *
+ * A capability that cannot finish inside one request/response exchange returns
+ * an {@link OperationRef}; progress is then observed through the standard
+ * `operations.*` capabilities instead of by holding a transport open.
+ */
+export interface CreateOperationInput {
+    capability: string;
+    attributes?: Record<string, JsonValue>;
+    operationId?: string;
+}
+export type OperationPatch = Partial<Pick<OperationRecord, "status" | "progress" | "result" | "error" | "attributes">>;
+export type OperationListener = (record: OperationRecord) => void;
+export interface OperationStore {
+    create(input: CreateOperationInput): Promise<OperationRecord>;
+    get(operationId: string): Promise<OperationRecord | undefined>;
+    update(operationId: string, patch: OperationPatch): Promise<OperationRecord>;
+    list(): Promise<OperationRecord[]>;
+    /** Notifies on every state change; used by `operations.events`. */
+    subscribe(listener: OperationListener): () => void;
+}
+export declare class MemoryOperationStore implements OperationStore {
+    #private;
+    create(input: CreateOperationInput): Promise<OperationRecord>;
+    get(operationId: string): Promise<OperationRecord | undefined>;
+    update(operationId: string, patch: OperationPatch): Promise<OperationRecord>;
+    list(): Promise<OperationRecord[]>;
+    subscribe(listener: OperationListener): () => void;
+}
+/**
+ * Runs work in the background against an {@link OperationStore}, returning the
+ * reference a capability should answer with.
+ */
+export declare class OperationRunner {
+    #private;
+    constructor(store: OperationStore);
+    get store(): OperationStore;
+    start(capability: string, work: (context: {
+        operationId: string;
+        signal: AbortSignal;
+        progress: (value: number) => Promise<void>;
+    }) => Promise<JsonValue | void>, options?: {
+        attributes?: Record<string, JsonValue>;
+    }): Promise<OperationRef>;
+    /** Best-effort cancellation (§21). */
+    cancel(operationId: string): Promise<OperationStatus>;
+}
+export interface OperationCapabilityOptions {
+    /** Permission required to observe and cancel operations. */
+    authorization?: readonly string[];
+}
+/**
+ * The standard `operations.status`, `operations.cancel` and `operations.events`
+ * capabilities (§47). Registering them makes long-running work observable
+ * through the same protocol as everything else.
+ */
+export declare function createOperationCapabilities(runner: OperationRunner, options?: OperationCapabilityOptions): AnyCapability[];
+//# sourceMappingURL=operations.d.ts.map

package/node_modules/@appport/core/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI/F;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC;AAEvH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9D,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAC/D,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7E,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACnC,mEAAmE;IACnE,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAAC;CACpD;AAED,qBAAa,oBAAqB,YAAW,cAAc;;IAInD,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAe7D,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAI9D,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAa5E,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIxC,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;CAcnD;AAED;;;GAGG;AACH,qBAAa,eAAe;;gBAId,KAAK,EAAE,cAAc;IAIjC,IAAI,KAAK,IAAI,cAAc,CAE1B;IAEK,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,CAAC,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,EACtI,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;KAAO,GACvD,OAAO,CAAC,YAAY,CAAC;IAyCxB,sCAAsC;IAChC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAQ5D;AAqBD,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,0BAA+B,GACvC,aAAa,EAAE,CAuEjB"}