threadforge 0.1.0 → 0.2.1

package/dist/core/ForgeHost.d.ts

@@ -0,0 +1,82 @@
+/**
+ * ForgeHost — Multi-Project Hosting Platform
+ *
+ * Wraps Supervisor via composition to manage multiple projects
+ * sharing one machine, one Postgres, one Redis, and one auth system.
+ *
+ * Usage:
+ *
+ *   import { ForgeHost, defineHost } from 'threadforge';
+ *
+ *   const hostConfig = defineHost({ ... });
+ *   const host = new ForgeHost(hostConfig);
+ *   await host.start();
+ */
+import type { HostMeta } from "./host-config.js";
+import { resolveAndDefine } from "./host-config.js";
+import type { RegistryMode } from "./config-enums.js";
+interface SupervisorOptions {
+    cpus?: number;
+    reserved?: number;
+    registryMode?: RegistryMode;
+    host?: string;
+    httpBasePort?: number;
+    evaluationIntervalMs?: number;
+}
+interface StatusGroup {
+    group: string;
+    services: Array<{
+        name: string;
+    }>;
+    workers: number;
+    [key: string]: unknown;
+}
+interface StatusResult {
+    processGroups: StatusGroup[];
+    [key: string]: unknown;
+}
+interface HostStatus extends StatusResult {
+    hostMode: true;
+    domain: string | null;
+    projects: Record<string, ProjectStatus>;
+}
+interface ProjectStatus {
+    domain: string | null;
+    services: number;
+    workers: number;
+    schema: string;
+    keyPrefix: string;
+}
+type HostConfigInput = Parameters<typeof resolveAndDefine>[0];
+export declare class ForgeHost {
+    private _hostConfig;
+    private _options;
+    private _supervisor;
+    private _resolvedConfig;
+    private _hostMeta;
+    constructor(hostConfig: HostConfigInput, options?: SupervisorOptions);
+    /**
+     * Resolve all project configs, merge into one flat config,
+     * and start the Supervisor.
+     */
+    start(): Promise<void>;
+    /**
+     * Gracefully shut down the entire host.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get status with per-project breakdown.
+     */
+    status(): HostStatus | null;
+    /**
+     * Get the list of project IDs.
+     */
+    get projectIds(): string[];
+    /**
+     * Get metadata for a specific project.
+     */
+    getProject(projectId: string): HostMeta | null;
+    private _printHostInfo;
+}
+export {};
+//# sourceMappingURL=ForgeHost.d.ts.map

package/dist/core/ForgeHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgeHost.d.ts","sourceRoot":"","sources":["../../src/core/ForgeHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAA4B,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,YAAY;IACpB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,UAAW,SAAQ,YAAY;IACvC,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACzC;AAED,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9D,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,SAAS,CAAkC;gBAEvC,UAAU,EAAE,eAAe,EAAE,OAAO,GAAE,iBAAsB;IAQxE;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B;;OAEG;IACH,MAAM,IAAI,UAAU,GAAG,IAAI;IA4B3B;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,EAAE,CAEzB;IAED;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAI9C,OAAO,CAAC,cAAc;CAiBvB"}

package/dist/core/ForgeHost.js

@@ -0,0 +1,107 @@
+/**
+ * ForgeHost — Multi-Project Hosting Platform
+ *
+ * Wraps Supervisor via composition to manage multiple projects
+ * sharing one machine, one Postgres, one Redis, and one auth system.
+ *
+ * Usage:
+ *
+ *   import { ForgeHost, defineHost } from 'threadforge';
+ *
+ *   const hostConfig = defineHost({ ... });
+ *   const host = new ForgeHost(hostConfig);
+ *   await host.start();
+ */
+import { resolveAndDefine } from "./host-config.js";
+import { Supervisor } from "./Supervisor.js";
+export class ForgeHost {
+    _hostConfig;
+    _options;
+    _supervisor;
+    _resolvedConfig;
+    _hostMeta;
+    constructor(hostConfig, options = {}) {
+        this._hostConfig = hostConfig;
+        this._options = options;
+        this._supervisor = null;
+        this._resolvedConfig = null;
+        this._hostMeta = null;
+    }
+    /**
+     * Resolve all project configs, merge into one flat config,
+     * and start the Supervisor.
+     */
+    async start() {
+        // Resolve host config → flat service map → defineServices()
+        this._resolvedConfig = await resolveAndDefine(this._hostConfig);
+        this._hostMeta = this._resolvedConfig._hostMeta;
+        // Store host meta as JSON for workers to read
+        this._resolvedConfig._hostMetaJSON = JSON.stringify(this._hostMeta);
+        // Create and start the Supervisor with the merged config
+        this._supervisor = new Supervisor(this._resolvedConfig, this._options);
+        await this._supervisor.start();
+        this._printHostInfo();
+    }
+    /**
+     * Gracefully shut down the entire host.
+     */
+    async shutdown() {
+        if (this._supervisor) {
+            await this._supervisor.shutdown();
+        }
+    }
+    /**
+     * Get status with per-project breakdown.
+     */
+    status() {
+        if (!this._supervisor || !this._hostMeta)
+            return null;
+        const base = this._supervisor._status();
+        const projects = {};
+        for (const [projectId, meta] of Object.entries(this._hostMeta)) {
+            const projectGroups = base.processGroups.filter((pg) => pg.services.some((s) => meta.services.includes(s.name)));
+            projects[projectId] = {
+                domain: meta.domain,
+                services: meta.services.length,
+                workers: projectGroups.reduce((sum, pg) => sum + pg.workers, 0),
+                schema: meta.schema,
+                keyPrefix: meta.keyPrefix,
+            };
+        }
+        return {
+            ...base,
+            hostMode: true,
+            domain: this._resolvedConfig._hostDomain,
+            projects,
+        };
+    }
+    /**
+     * Get the list of project IDs.
+     */
+    get projectIds() {
+        return Object.keys(this._hostMeta ?? {});
+    }
+    /**
+     * Get metadata for a specific project.
+     */
+    getProject(projectId) {
+        return this._hostMeta?.[projectId] ?? null;
+    }
+    _printHostInfo() {
+        console.log(`\n  ForgeHost — Multi-Project Platform`);
+        console.log(`  ─────────────────────────────────────`);
+        if (this._resolvedConfig._hostDomain) {
+            console.log(`  Domain: ${this._resolvedConfig._hostDomain}`);
+        }
+        console.log(`  Projects: ${Object.keys(this._hostMeta).length}`);
+        console.log("");
+        for (const [projectId, meta] of Object.entries(this._hostMeta)) {
+            const domain = meta.domain ? ` (${meta.domain})` : "";
+            console.log(`    ${projectId}${domain}`);
+            console.log(`      Services: ${meta.services.join(", ")}`);
+            console.log(`      Schema:   ${meta.schema}`);
+        }
+        console.log("");
+    }
+}
+//# sourceMappingURL=ForgeHost.js.map

package/dist/core/ForgeHost.js.map

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

package/dist/core/ForgePlatform.d.ts

@@ -0,0 +1,96 @@
+/**
+ * ForgePlatform — Platform Mode Orchestrator
+ *
+ * Wraps ForgeHost to provide a platform-level lifecycle with
+ * domain-based multi-app routing, shared services, and
+ * platform-specific banner output.
+ *
+ * Usage:
+ *
+ *   import { ForgePlatform, definePlatform } from 'threadforge';
+ *
+ *   const config = definePlatform({ ... });
+ *   const platform = new ForgePlatform(config);
+ *   await platform.start();
+ */
+interface PlatformApp {
+    domains?: string[];
+    domain?: string;
+    static?: string | null;
+    [key: string]: unknown;
+}
+interface PlatformBlock {
+    globalAuth?: boolean;
+    apps: Record<string, PlatformApp>;
+    [key: string]: unknown;
+}
+interface RawPlatformConfig {
+    platform: PlatformBlock;
+    [key: string]: unknown;
+}
+interface PlatformConfigWrapped {
+    _isPlatformConfig: true;
+    _raw: RawPlatformConfig;
+    [key: string]: unknown;
+}
+type PlatformConfigInput = PlatformConfigWrapped | RawPlatformConfig;
+interface HostMeta {
+    services: string[];
+    schema: string;
+    domain?: string;
+    [key: string]: unknown;
+}
+interface AppInfo {
+    domains: string[];
+    services: string[];
+    schema: string;
+    static: string | null;
+}
+interface PlatformStatus {
+    platformMode: true;
+    apps: Record<string, AppInfo>;
+    [key: string]: unknown;
+}
+interface SupervisorOptions {
+    [key: string]: unknown;
+}
+export declare class ForgePlatform {
+    private _platformConfig;
+    private _options;
+    private _host;
+    private _resolvedConfig;
+    private _hostMeta;
+    private _platformApps;
+    /**
+     * @param platformConfig - Output from definePlatform() or raw platform config
+     * @param options - Supervisor options override
+     */
+    constructor(platformConfig: PlatformConfigInput, options?: SupervisorOptions);
+    /**
+     * Start the platform: resolve config, create ForgeHost, start.
+     */
+    start(): Promise<void>;
+    /**
+     * Gracefully shut down the platform.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get the apps map: appId -> { domains, services, schema }
+     */
+    get apps(): Record<string, AppInfo>;
+    /**
+     * Get the host metadata (from ForgeHost).
+     */
+    get hostMeta(): Record<string, HostMeta>;
+    /**
+     * Get platform status with per-app breakdown.
+     */
+    status(): PlatformStatus | null;
+    /**
+     * Collect all service names that belong to a project (not shared).
+     */
+    private _collectProjectServiceNames;
+    private _printPlatformBanner;
+}
+export {};
+//# sourceMappingURL=ForgePlatform.d.ts.map

package/dist/core/ForgePlatform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgePlatform.d.ts","sourceRoot":"","sources":["../../src/core/ForgePlatform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,qBAAqB;IAC7B,iBAAiB,EAAE,IAAI,CAAC;IACxB,IAAI,EAAE,iBAAiB,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,mBAAmB,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;AAErE,UAAU,QAAQ;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AASD,UAAU,OAAO;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,UAAU,cAAc;IACtB,YAAY,EAAE,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,iBAAiB;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,aAAa,CAAqC;IAE1D;;;OAGG;gBACS,cAAc,EAAE,mBAAmB,EAAE,OAAO,GAAE,iBAAsB;IAShF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAclC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAEvC;IAED;;OAEG;IACH,MAAM,IAAI,cAAc,GAAG,IAAI;IAW/B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAQnC,OAAO,CAAC,oBAAoB;CA8B7B"}

package/dist/core/ForgePlatform.js

@@ -0,0 +1,136 @@
+/**
+ * ForgePlatform — Platform Mode Orchestrator
+ *
+ * Wraps ForgeHost to provide a platform-level lifecycle with
+ * domain-based multi-app routing, shared services, and
+ * platform-specific banner output.
+ *
+ * Usage:
+ *
+ *   import { ForgePlatform, definePlatform } from 'threadforge';
+ *
+ *   const config = definePlatform({ ... });
+ *   const platform = new ForgePlatform(config);
+ *   await platform.start();
+ */
+import { ForgeHost } from "./ForgeHost.js";
+import { resolveAppDomains, transformToHostConfig } from "./platform-config.js";
+export class ForgePlatform {
+    _platformConfig;
+    _options;
+    _host;
+    _resolvedConfig;
+    _hostMeta;
+    _platformApps;
+    /**
+     * @param platformConfig - Output from definePlatform() or raw platform config
+     * @param options - Supervisor options override
+     */
+    constructor(platformConfig, options = {}) {
+        this._platformConfig = platformConfig;
+        this._options = options;
+        this._host = null;
+        this._resolvedConfig = null;
+        this._hostMeta = null;
+        this._platformApps = null;
+    }
+    /**
+     * Start the platform: resolve config, create ForgeHost, start.
+     */
+    async start() {
+        const raw = "_isPlatformConfig" in this._platformConfig && this._platformConfig._isPlatformConfig
+            ? this._platformConfig._raw
+            : this._platformConfig;
+        const hostConfig = transformToHostConfig(raw);
+        this._platformApps = raw.platform.apps;
+        this._host = new ForgeHost(hostConfig, this._options);
+        await this._host.start();
+        this._resolvedConfig = this._host._resolvedConfig;
+        this._hostMeta = this._resolvedConfig._hostMeta ?? null;
+        this._resolvedConfig._isPlatformMode = true;
+        this._printPlatformBanner();
+    }
+    /**
+     * Gracefully shut down the platform.
+     */
+    async shutdown() {
+        if (this._host) {
+            await this._host.shutdown();
+        }
+    }
+    /**
+     * Get the apps map: appId -> { domains, services, schema }
+     */
+    get apps() {
+        if (!this._platformApps || !this._hostMeta)
+            return {};
+        const result = {};
+        for (const [appId, app] of Object.entries(this._platformApps)) {
+            const meta = this._hostMeta[appId];
+            result[appId] = {
+                domains: resolveAppDomains(app),
+                services: meta?.services ?? [],
+                schema: meta?.schema ?? appId,
+                static: app.static ?? null,
+            };
+        }
+        return result;
+    }
+    /**
+     * Get the host metadata (from ForgeHost).
+     */
+    get hostMeta() {
+        return this._hostMeta ?? {};
+    }
+    /**
+     * Get platform status with per-app breakdown.
+     */
+    status() {
+        if (!this._host)
+            return null;
+        const base = this._host.status();
+        return {
+            ...base,
+            platformMode: true,
+            apps: this.apps,
+        };
+    }
+    /**
+     * Collect all service names that belong to a project (not shared).
+     */
+    _collectProjectServiceNames() {
+        const names = new Set();
+        for (const meta of Object.values(this._hostMeta ?? {})) {
+            for (const svc of meta.services)
+                names.add(svc);
+        }
+        return names;
+    }
+    _printPlatformBanner() {
+        console.log(`\n  ForgePlatform — Multi-App Platform Mode`);
+        console.log(`  ──────────────────────────────────────────`);
+        const apps = this._platformApps;
+        if (!apps)
+            return;
+        console.log(`  Apps: ${Object.keys(apps).length}`);
+        console.log("");
+        for (const [appId, app] of Object.entries(apps)) {
+            const domains = resolveAppDomains(app);
+            const meta = this._hostMeta?.[appId];
+            console.log(`    ${appId}`);
+            console.log(`      Domains:  ${domains.join(", ")}`);
+            if (meta) {
+                console.log(`      Services: ${meta.services.join(", ")}`);
+                console.log(`      Schema:   ${meta.schema}`);
+            }
+        }
+        const projectServices = this._collectProjectServiceNames();
+        const allServices = Object.keys(this._resolvedConfig?.services ?? {});
+        const sharedServices = allServices.filter((s) => !projectServices.has(s));
+        if (sharedServices.length > 0) {
+            console.log(`\n    Shared: ${sharedServices.join(", ")}`);
+        }
+        console.log("");
+    }
+}
+//# sourceMappingURL=ForgePlatform.js.map

package/dist/core/ForgePlatform.js.map

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

package/dist/core/ForgeWebSocket.d.ts

@@ -0,0 +1,56 @@
+import { EventEmitter } from "node:events";
+import type { Socket } from "node:net";
+import type { RequestContext } from "./RequestContext.js";
+export interface WsOptions {
+    auth?: string;
+    allowedOrigins?: string[];
+    pingInterval?: number;
+    [key: string]: unknown;
+}
+/**
+ * Minimal WebSocket implementation (RFC 6455 framing).
+ * No external dependencies. Handles text frames, ping/pong, close.
+ */
+export declare class ForgeWebSocket extends EventEmitter {
+    socket: Socket;
+    ctx: RequestContext;
+    _closed: boolean;
+    _closeSent: boolean;
+    _closeTimer: ReturnType<typeof setTimeout> | null;
+    _bufferChunks: Buffer[];
+    _bufferTotalLen: number;
+    _fragments: Buffer[];
+    _fragmentOpcode: number;
+    _fragmentsTotalSize: number;
+    _totalBuffered: number;
+    _outboundBuffered: number;
+    _pingTimer: ReturnType<typeof setInterval> | null;
+    _lastPong: number;
+    constructor(socket: Socket, rctx: RequestContext, options?: WsOptions);
+    send(data: string | Buffer): void;
+    sendBinary(data: Buffer | Uint8Array): void;
+    /**
+     * Write a frame to the socket while tracking outbound backpressure.
+     * Increments _outboundBuffered on write; decrements on drain/callback
+     * so _totalBuffered reflects actual pending bytes, not lifetime total.
+     */
+    _trackOutboundWrite(frame: Buffer): void;
+    close(code?: number, reason?: string): void;
+    /**
+     * P7: Consolidate buffer chunks into a single Buffer only when needed.
+     */
+    _consolidateBuffer(): void;
+    /**
+     * Get the current buffer as a single Buffer (consolidating if needed).
+     */
+    get _buffer(): Buffer;
+    /**
+     * Set the buffer (replaces all chunks).
+     */
+    set _buffer(buf: Buffer);
+    _onData(buf: Buffer): void;
+    _encodeFrame(payload: Buffer, opcode: number): Buffer;
+    _onClose(): void;
+    _startPingInterval(intervalMs: number): void;
+}
+//# sourceMappingURL=ForgeWebSocket.d.ts.map

package/dist/core/ForgeWebSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgeWebSocket.d.ts","sourceRoot":"","sources":["../../src/core/ForgeWebSocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAClD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;gBAEN,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,GAAE,SAAc;IA8BzE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAO3C;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBxC,KAAK,CAAC,IAAI,GAAE,MAAa,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI;IA0BrD;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAW1B;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAKpB;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,GAAG,EAAE,MAAM,EAQtB;IAED,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA2N1B,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAqBrD,QAAQ,IAAI,IAAI;IAgBhB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAoB7C"}