@appport/sdk 1.0.1

package/node_modules/@appport/client/dist/duplex.js

@@ -0,0 +1,194 @@
+import { AppPortError, createStreamCancel, createSubscribe, createUnsubscribe, errors, newRequestId, newSubscriptionId, parseServerEnvelope } from "@appport/protocol";
+import { ClientChannel } from "./channel.js";
+import { DEFAULT_FEATURES } from "./transport.js";
+/** Builds an {@link AppTransport} from a {@link DuplexChannel}. */
+export function createDuplexTransport(channel) {
+    const pending = new Map();
+    const subscriptions = new Map();
+    const streamsByRequest = new Map();
+    const streamsById = new Map();
+    let opened = false;
+    let closing = false;
+    let generation = 0;
+    const failAll = (reason) => {
+        for (const request of pending.values())
+            request.reject(reason);
+        pending.clear();
+        for (const stream of streamsById.values())
+            stream.channel.fail(reason);
+        for (const stream of streamsByRequest.values())
+            stream.channel.fail(reason);
+        streamsById.clear();
+        streamsByRequest.clear();
+        subscriptions.clear();
+    };
+    const onEnvelope = (value) => {
+        let envelope;
+        try {
+            envelope = parseServerEnvelope(value);
+        }
+        catch {
+            // A malformed server envelope must not corrupt client state (§57).
+            return;
+        }
+        switch (envelope.type) {
+            case "response": {
+                const request = pending.get(envelope.requestId);
+                if (request) {
+                    pending.delete(envelope.requestId);
+                    request.resolve(envelope);
+                    return;
+                }
+                // A stream request that failed before `stream.start` is answered with a
+                // plain error response; surface it on the stream the caller is holding.
+                const stream = streamsByRequest.get(envelope.requestId);
+                if (stream && !envelope.ok) {
+                    streamsByRequest.delete(envelope.requestId);
+                    stream.channel.fail(new AppPortError(envelope.error.code, envelope.error.message));
+                }
+                return;
+            }
+            case "event": {
+                const handler = envelope.subscriptionId ? subscriptions.get(envelope.subscriptionId) : undefined;
+                if (handler)
+                    handler(envelope);
+                else
+                    for (const listener of subscriptions.values())
+                        listener(envelope);
+                return;
+            }
+            case "stream.start": {
+                const stream = streamsByRequest.get(envelope.requestId);
+                if (!stream)
+                    return;
+                stream.streamId = envelope.streamId;
+                streamsById.set(envelope.streamId, stream);
+                return;
+            }
+            case "stream.chunk": {
+                const stream = streamsById.get(envelope.streamId);
+                if (!stream)
+                    return;
+                if (envelope.sequence !== stream.expectedSequence) {
+                    stream.channel.fail(errors.streamError(`Out-of-order stream chunk: expected ${stream.expectedSequence}, received ${envelope.sequence}`));
+                    return;
+                }
+                stream.expectedSequence += 1;
+                stream.channel.push(envelope.payload);
+                return;
+            }
+            case "stream.end": {
+                const stream = streamsById.get(envelope.streamId);
+                if (!stream)
+                    return;
+                streamsById.delete(envelope.streamId);
+                for (const [requestId, candidate] of streamsByRequest) {
+                    if (candidate === stream)
+                        streamsByRequest.delete(requestId);
+                }
+                if (envelope.error) {
+                    stream.channel.fail(new AppPortError(envelope.error.code, envelope.error.message));
+                }
+                else {
+                    stream.channel.end();
+                }
+                return;
+            }
+        }
+    };
+    const ensureOpen = async () => {
+        if (opened)
+            return;
+        generation += 1;
+        const current = generation;
+        await channel.open({
+            onEnvelope: (value) => {
+                if (current !== generation)
+                    return;
+                onEnvelope(value);
+            },
+            onClose: (reason) => {
+                // Ignore a close from a carrier that has already been superseded.
+                if (current !== generation)
+                    return;
+                opened = false;
+                failAll(reason ?? (closing ? errors.cancelled("Transport closed") : errors.streamError("Transport disconnected")));
+            }
+        });
+        opened = true;
+    };
+    const transport = {
+        kind: channel.kind,
+        features: channel.features ?? DEFAULT_FEATURES,
+        async connect() {
+            await ensureOpen();
+        },
+        async close() {
+            closing = true;
+            generation += 1;
+            if (opened) {
+                opened = false;
+                await channel.close();
+            }
+            failAll(errors.cancelled("Transport closed"));
+            closing = false;
+        },
+        async request(request) {
+            await ensureOpen();
+            return new Promise((resolve, reject) => {
+                pending.set(request.requestId, { resolve, reject });
+                Promise.resolve(channel.send(request)).catch((error) => {
+                    pending.delete(request.requestId);
+                    reject(error);
+                });
+            });
+        },
+        async subscribe(handler, filter) {
+            await ensureOpen();
+            const subscriptionId = newSubscriptionId();
+            const requestId = newRequestId();
+            subscriptions.set(subscriptionId, handler);
+            const ack = new Promise((resolve, reject) => {
+                pending.set(requestId, { resolve, reject });
+            });
+            await channel.send(createSubscribe(requestId, subscriptionId, {
+                name: filter?.name ?? "*",
+                ...(filter?.version !== undefined ? { version: filter.version } : {})
+            }));
+            const response = await ack;
+            if (!response.ok) {
+                subscriptions.delete(subscriptionId);
+                throw new AppPortError(response.error.code, response.error.message);
+            }
+            return () => {
+                subscriptions.delete(subscriptionId);
+                void Promise.resolve(channel.send(createUnsubscribe(newRequestId(), subscriptionId))).catch(() => undefined);
+            };
+        },
+        stream(request) {
+            const stream = { channel: new ClientChannel(), expectedSequence: 0 };
+            streamsByRequest.set(request.requestId, stream);
+            void (async () => {
+                try {
+                    await ensureOpen();
+                    await channel.send(request);
+                }
+                catch (error) {
+                    stream.channel.fail(error);
+                }
+            })();
+            return {
+                cancel(reason) {
+                    const streamId = stream.streamId;
+                    if (streamId) {
+                        void Promise.resolve(channel.send(createStreamCancel(streamId, reason))).catch(() => undefined);
+                    }
+                    stream.channel.fail(errors.cancelled(reason ?? "Cancelled by client"));
+                },
+                [Symbol.asyncIterator]: () => stream.channel[Symbol.asyncIterator]()
+            };
+        }
+    };
+    return transport;
+}
+//# sourceMappingURL=duplex.js.map

package/node_modules/@appport/client/dist/duplex.js.map

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

package/node_modules/@appport/client/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@appport/client` — the transport-independent application client.
+ *
+ * `await app.documents.save(input)` is valid application code on every runtime.
+ * `if (isElectron) { ... } else { fetch(...) }` is not (§2).
+ */
+export * from "./transport.js";
+export * from "./contract.js";
+export * from "./client.js";
+export * from "./duplex.js";
+export * from "./channel.js";
+export * from "./discovery.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@appport/client/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/node_modules/@appport/client/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * `@appport/client` — the transport-independent application client.
+ *
+ * `await app.documents.save(input)` is valid application code on every runtime.
+ * `if (isElectron) { ... } else { fetch(...) }` is not (§2).
+ */
+export * from "./transport.js";
+export * from "./contract.js";
+export * from "./client.js";
+export * from "./duplex.js";
+export * from "./channel.js";
+export * from "./discovery.js";
+//# sourceMappingURL=index.js.map

package/node_modules/@appport/client/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/node_modules/@appport/client/dist/transport.d.ts

@@ -0,0 +1,42 @@
+import type { AppEventEnvelope, AppRequest, AppResponse, AppStreamRequest } from "@appport/protocol";
+export type Unsubscribe = () => void;
+export type EventHandler = (event: AppEventEnvelope) => void;
+export interface TransportEventFilter {
+    /** Event name, `namespace.*`, or `*` for everything the session may observe. */
+    name: string;
+    version?: number;
+}
+/** A stream of chunks with best-effort cancellation (§21). */
+export interface TransportStream extends AsyncIterable<unknown> {
+    cancel(reason?: string): void;
+}
+/**
+ * The transport contract (specification §22).
+ *
+ * Every transport — in-process, HTTP, WebSocket, Electron IPC, Tauri IPC — is
+ * the same conceptual interface. Application code never sees which one is
+ * mounted; that is the invariant the whole protocol exists to protect (§2).
+ */
+export interface AppTransport {
+    /** `inprocess`, `http`, `websocket`, `ipc`, … */
+    readonly kind: string;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    request(request: AppRequest): Promise<AppResponse>;
+    /**
+     * Subscribes to server events. Transports without a server-initiated channel
+     * (plain HTTP) reject with `STREAM_ERROR`.
+     */
+    subscribe(handler: EventHandler, filter?: TransportEventFilter): Promise<Unsubscribe>;
+    stream(request: AppStreamRequest): TransportStream;
+    /** Advertised optional features, for capability negotiation and diagnostics. */
+    readonly features?: TransportFeatures;
+}
+export interface TransportFeatures {
+    events: boolean;
+    streams: boolean;
+    /** True when the transport keeps a connection open between requests. */
+    persistent: boolean;
+}
+export declare const DEFAULT_FEATURES: TransportFeatures;
+//# sourceMappingURL=transport.d.ts.map

package/node_modules/@appport/client/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErG,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAgB,SAAQ,aAAa,CAAC,OAAO,CAAC;IAC7D,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnD;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAAC;IACnD,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,iBAAqE,CAAC"}

package/node_modules/@appport/client/dist/transport.js

@@ -0,0 +1,2 @@
+export const DEFAULT_FEATURES = { events: true, streams: true, persistent: true };
+//# sourceMappingURL=transport.js.map

package/node_modules/@appport/client/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AA+CA,MAAM,CAAC,MAAM,gBAAgB,GAAsB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC"}

package/node_modules/@appport/client/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@appport/client",
+  "version": "1.0.0",
+  "description": "Transport-independent typed AppPort application client.",
+  "license": "Apache-2.0",
+  "repository": "github:rkendel1/appport",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean"
+  },
+  "dependencies": {
+    "@appport/protocol": "1.0.0"
+  },
+  "peerDependencies": {
+    "@appport/transport-http": "1.0.0",
+    "@appport/transport-websocket": "1.0.0"
+  },
+  "private": true
+}

package/node_modules/@appport/core/README.md

@@ -0,0 +1,91 @@
+# @appport/core
+
+The capability runtime: registry, dispatch pipeline, validation, sessions,
+events, streams, operations and telemetry.
+
+Core knows nothing about HTTP, WebSocket, IPC, or any storage engine.
+
+```ts
+import { createApplication, defineCapability, defineEvent } from "@appport/core";
+import { s } from "@appport/schema";
+
+const application = createApplication({
+  application: { id: "com.example.docs", name: "Docs", version: "1.0.0" },
+  capabilities: [documentsSave],
+  events: [documentsChanged],
+  authorizer: permissionAuthorizer()
+});
+
+const response = await application.handleRequest(envelope, { session, transport: "http" });
+```
+
+## The pipeline
+
+```
+receive -> validate -> authorize -> execute -> serialize -> respond
+```
+
+Authorization always runs before privileged logic. Input is validated before
+authorization, so policies see well-formed input. Output is validated too, so a
+handler cannot silently break its published contract.
+
+## What the runtime provides
+
+- **Registry and manifest** — the application's contract, rendered as JSON Schema.
+- **Application registration** — define an application, verify it, and register for
+  durable tracking with identity, manifest, fingerprint, and verification state.
+- **Events** — at-most-once publication, with payload validation.
+- **Streams** — async iterables or `context.createStream()`, with cancellation.
+- **Sessions** — transport-neutral, pluggable storage.
+- **Idempotency** — replayed responses for capabilities that declare support.
+- **Concurrency** — `parallel`, `serialized`, or `keyed(field)`.
+- **Timeouts** — per capability and per request, clamped by the server.
+- **Operations** — `operations.status`, `operations.cancel`, `operations.events`
+  for work that outlives a request.
+- **Telemetry** — identifiers and outcomes, never credentials or payloads.
+- **Sanitization** — production errors carry no stack traces, paths or secrets.
+
+The reserved `appport.manifest` and `appport.ping` capabilities are registered
+automatically, so discovery works identically on transports that have no URLs.
+
+## Application Registration (PR20)
+
+Define, verify, and register applications for durable tracking:
+
+```ts
+import { defineApplication, ApplicationRegistry, MemoryApplicationStateStore } from "@appport/core";
+
+// 1. Define an application (PR18)
+const application = defineApplication({
+  identity: { id: "invoicing", name: "Invoicing", version: "1.0.0" },
+  provides: [invoiceCreate, invoiceSend],
+  requires: [{ name: "payments.charge", version: 1 }],
+  implementations: { "invoice.create@1": createImpl, "invoice.send@1": sendImpl }
+});
+
+// 2. Verify the application (PR19)
+const verification = application.verify();
+if (!verification.ready) throw new Error("Application verification failed");
+
+// 3. Get the canonical manifest and fingerprint (PR19)
+const manifest = application.manifest();
+const fingerprint = application.fingerprint();
+
+// 4. Register for durable tracking (PR20)
+const store = new MemoryApplicationStateStore();
+const registry = new ApplicationRegistry(store);
+
+const registered = await registry.register({
+  identity: application.identity,
+  manifest,
+  fingerprint,
+  verification
+});
+
+// Tracked application state with identity, manifest, fingerprint, verification
+console.log(registered.id, registered.status, registered.revision);
+```
+
+The registered application state is portable and contains no implementation
+details — only the contract, identity, verification state, and lifecycle.
+

package/node_modules/@appport/core/dist/appboundry-contract.d.ts

@@ -0,0 +1,80 @@
+/**
+ * AppBoundry Application Contract (F6)
+ *
+ * The singular, AppBoundry-owned description of an application: its identity,
+ * its contract revision, its canonical fingerprint, and the capabilities it
+ * provides and requires.
+ *
+ * A repository represents this contract with `appboundry.contract.json`. That
+ * document is an *attestation target*: it is a read-only representation of the
+ * contract AppBoundry owns. It is NOT an independently authored contract and it
+ * is NOT interchangeable with the runtime implementation manifest
+ * (see `runtime-manifest.ts`).
+ *
+ * The document therefore MUST NOT contain authorization grants, bindings,
+ * credentials, runtime process state, provider selections, execution state or
+ * mutable implementation state. Parsing rejects those fields explicitly.
+ */
+import { type ApplicationManifest, type CapabilityManifestEntry, type RequirementManifestEntry } from "./manifest.js";
+import type { JsonValue } from "@appport/protocol";
+/** Protocol identifier of the repository contract representation. */
+export declare const APPBOUNDRY_CONTRACT_PROTOCOL = "AppBoundry/contract/1";
+/** Canonical file name of the repository contract representation. */
+export declare const APPBOUNDRY_CONTRACT_FILE = "appboundry.contract.json";
+/**
+ * Repository representation of the authoritative AppBoundry contract.
+ *
+ * The fingerprint is self-describing: a document whose declared fingerprint
+ * disagrees with its own canonical content is invalid and can never attest.
+ */
+export interface AppBoundryContractDocument {
+    readonly protocol: typeof APPBOUNDRY_CONTRACT_PROTOCOL;
+    readonly application: {
+        readonly id: string;
+        readonly name: string;
+        readonly version: string;
+    };
+    readonly contractRevision: number;
+    readonly contractFingerprint: string;
+    readonly metadata?: Readonly<Record<string, JsonValue>>;
+    readonly provides: readonly CapabilityManifestEntry[];
+    readonly requires: readonly RequirementManifestEntry[];
+}
+export type AppBoundryContractErrorCode = "CONTRACT_DOCUMENT_INVALID" | "CONTRACT_DOCUMENT_NOT_A_CONTRACT" | "CONTRACT_DOCUMENT_FINGERPRINT_INVALID";
+/** Explicit contract-document failure; never silently downgraded to a manifest. */
+export declare class AppBoundryContractError extends Error {
+    readonly code: AppBoundryContractErrorCode;
+    constructor(code: AppBoundryContractErrorCode, message: string);
+}
+/**
+ * Project a contract document onto the canonical manifest shape used for
+ * fingerprinting. The projection exists so the AppBoundry contract and the
+ * authoritative application registration share one fingerprint algorithm
+ * without the two schemas becoming interchangeable.
+ */
+export declare function contractManifestProjection(contract: AppBoundryContractDocument): ApplicationManifest;
+/** Canonical fingerprint of a contract document's own content. */
+export declare function fingerprintAppBoundryContract(contract: AppBoundryContractDocument): string;
+/**
+ * Derive the repository contract representation from the authoritative manifest.
+ *
+ * AppBoundry owns the contract; this only renders it for a repository to commit.
+ */
+export declare function appBoundryContractFromManifest(manifest: ApplicationManifest, contractRevision?: number): AppBoundryContractDocument;
+/** Serialize the contract representation for `appboundry.contract.json`. */
+export declare function serializeAppBoundryContract(contract: AppBoundryContractDocument): string;
+/**
+ * Parse and validate a repository contract representation.
+ *
+ * Anything that is not an AppBoundry contract — most importantly a runtime
+ * implementation manifest — is rejected explicitly rather than coerced.
+ */
+export declare function parseAppBoundryContract(value: unknown): AppBoundryContractDocument;
+/** Canonical key for a capability within a contract or coverage declaration. */
+export declare function capabilityCoverageKey(capability: {
+    readonly name: string;
+    readonly version: number;
+}): string;
+/** Capabilities the contract declares, as canonical coverage keys. */
+export declare function contractProvidedCoverage(contract: AppBoundryContractDocument): readonly string[];
+//# sourceMappingURL=appboundry-contract.d.ts.map

package/node_modules/@appport/core/dist/appboundry-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appboundry-contract.d.ts","sourceRoot":"","sources":["../src/appboundry-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAuB,KAAK,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC3I,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AAEpE,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAmBnE;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,4BAA4B,CAAC;IACvD,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,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,MAAM,MAAM,2BAA2B,GACnC,2BAA2B,GAC3B,kCAAkC,GAClC,uCAAuC,CAAC;AAE5C,mFAAmF;AACnF,qBAAa,uBAAwB,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,2BAA2B;gBAAjC,IAAI,EAAE,2BAA2B,EAAE,OAAO,EAAE,MAAM;CAIxE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,0BAA0B,GAAG,mBAAmB,CAQpG;AAED,kEAAkE;AAClE,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,0BAA0B,GAAG,MAAM,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,mBAAmB,EAC7B,gBAAgB,SAAI,GACnB,0BAA0B,CAc5B;AAED,4EAA4E;AAC5E,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,0BAA0B,GAAG,MAAM,CAExF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CA0DlF;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,UAAU,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE7G;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,SAAS,MAAM,EAAE,CAEhG"}