@rotifer/playground 0.3.0-alpha.1 → 0.5.0-alpha.1

package/CHANGELOG.md

@@ -5,6 +5,85 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0-alpha.1] - 2026-02-23
+
+### Added
+
+- **Reputation System** — measurable trust signals for genes and developers
+  - Gene reputation R(g) = α·Arena + β·Usage + γ·Stability (weights: 0.5, 0.3, 0.2)
+  - Developer reputation R(d) = avg(gene reputations) + community bonus
+  - Time-based decay (5%/month, floor at 0.01) prevents reputation stagnation
+  - `rotifer reputation <gene-id>` — view gene reputation breakdown
+  - `rotifer reputation --mine` — view your developer reputation
+  - `rotifer reputation --leaderboard` — top developers ranked by reputation
+  - Database migration `003_reputation.sql` with `gene_reputation` and `developer_reputation` tables
+  - Server-side reputation computation via PostgreSQL functions
+  - Reputation leaderboard API (`get_reputation_leaderboard()`)
+
+- **P2P Gene Network Foundation** — groundwork for decentralized gene discovery
+  - P2P type system: `GeneAnnouncement`, `DiscoveryQuery`, `DiscoveryResponse`, `NodeStatus`
+  - Network protocols defined: `/rotifer/gene-discovery/1.0.0`, `/rotifer/gene-announce/1.0.0`
+  - `rotifer network start` — start local P2P node (foundation mode)
+  - `rotifer network peers` — list connected peers
+  - `rotifer network search` — search genes across network (Cloud-first, P2P-augmented)
+  - `rotifer network status` — show network status and configuration
+  - Cloud-first hybrid model: Cloud Registry as primary, P2P as supplement
+
+- **Comprehensive Documentation** — 18 new documentation pages
+  - CLI Command Reference: Gene Lifecycle, Arena, Cloud, Agent (EN + ZH)
+  - Gene Development Guide (EN + ZH)
+  - Composition Patterns Guide with Seq/Par/Cond/Try examples (EN + ZH)
+  - Cloud Binding Guide (EN + ZH)
+  - Architecture Deep-Dive Guide (EN + ZH) — URAA, Fitness, Arena, Agent lifecycle, Bindings
+  - Examples: Hello Gene, HTTP Fetch, Search+Summarize Pipeline, MCP Migration (EN + ZH)
+  - Updated Astro sidebar with Guides, CLI Reference, and Examples sections
+
+### Changed
+
+- CLI now has 20 commands (was 16): added `reputation`, `network start/peers/search/status`
+- `rotifer search` now shows R(g) reputation score column
+- `rotifer arena list --cloud` now shows R(g) reputation alongside F(g) and V(g)
+- Rust core: added `reputation` and `p2p` modules
+- Test count: 114 → 144 (30 new tests for reputation, network, and cloud reputation)
+
+[0.5.0-alpha.1]: https://github.com/rotifer-protocol/rotifer-playground/releases/tag/v0.5.0-alpha.1
+
+## [0.4.0-alpha.1] - 2026-02-23
+
+### Added
+
+- **Cloud Binding** — Cross-developer gene sharing via Supabase-backed REST API
+  - `rotifer login` — GitHub OAuth authentication via PKCE flow
+  - `rotifer logout` — Clear cloud credentials
+  - `rotifer publish <gene>` — Upload gene (phenotype + WASM) to cloud registry, saves `.cloud-manifest.json`
+  - `rotifer search [query]` — Search and browse cloud gene registry
+  - `rotifer install <gene-id>` — Download gene from cloud to local project
+  - Cloud Binding REST API specification (`docs/cloud-binding-api.md`)
+  - Supabase database schema with RLS policies (`supabase/migrations/001_initial.sql`)
+  - Auto-profile creation trigger (`supabase/migrations/002_auto_profile.sql`)
+
+- **Cloud Arena** — Remote Arena competition across developers
+  - `rotifer arena submit --cloud` — Submit gene to cloud Arena
+  - `rotifer arena list --cloud` — View cloud Arena rankings
+  - `rotifer arena watch --cloud` — Real-time cloud ranking updates (polling)
+  - Server-side ranking via PostgreSQL `get_arena_rankings()` function
+
+- **Endpoint-agnostic design** — CLI supports custom Cloud Binding endpoints via `--endpoint` flag or `~/.rotifer/cloud.json` config, enabling multiple deployments (global Supabase + rotifer.cloud China)
+
+- **Supabase CLI integration** — Project linked via `supabase link`, migrations pushed via `supabase db push`
+
+### Fixed
+
+- OAuth login: switched from implicit flow to PKCE for secure token exchange
+- Missing user profile on first login: added DB trigger `handle_new_user()` with backfill
+- `rotifer publish` now saves `.cloud-manifest.json` in source gene dir for `arena submit --cloud` linkage
+- `rotifer publish` graceful error when not logged in (was showing raw stack trace)
+
+### Changed
+
+- CLI description updated from "local development environment" to "development environment" (reflects cloud capabilities)
+- Test count: 91 → 114 (23 new cloud tests)
+
 ## [0.3.0-alpha.1] - 2026-02-17
 
 ### Added

package/README.md

@@ -5,10 +5,11 @@
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
 [![Protocol](https://img.shields.io/badge/Protocol-v2.9%20Frozen-orange)](https://github.com/rotifer-protocol/rotifer-spec)
+[![Discord](https://img.shields.io/discord/placeholder?label=Discord&logo=discord&color=5865F2)](https://discord.gg/6d4JrfMr)
 
-Local development environment for the **Rotifer Protocol** — build genes, run Arena competitions, and simulate agent evolution.
+Development environment for the **Rotifer Protocol** — build genes, compete in Arenas, share via Cloud, and simulate agent evolution.
 
-> **Status:** Alpha (v0.3.0-alpha.1). Core gene lifecycle, IR compiler pipeline, parallel algebra, **TS→WASM auto-compilation (Javy)**, and live Arena watching are functional.
+> **Status:** Alpha (v0.5.0-alpha.1). Core gene lifecycle, IR compiler, **Cloud Binding**, **Reputation System**, **P2P Network Foundation**, and comprehensive documentation are functional.
 
 ---
 
@@ -117,12 +118,14 @@ playground/
 │   ├── rotifer-core/        Rust: types, sandbox, arena, algebra, fitness, storage
 │   └── rotifer-napi/        napi-rs bridge: Rust ↔ Node.js FFI
 ├── src/                     TypeScript CLI (commander.js)
-│   ├── commands/            11 CLI commands
+│   ├── commands/            16 CLI commands
+│   ├── cloud/               Cloud Binding client (auth, API, types)
 │   ├── utils/               Config, display, NAPI binding, Javy compiler
 │   └── errors/              Rust-style error formatting
 ├── genes/                   5 Genesis genes (bundled)
+├── supabase/                Cloud Binding database migrations
 ├── templates/               Gene + composition scaffolds
-└── tests/                   Unit + E2E test suites (91 tests)
+└── tests/                   Unit + E2E test suites (114 tests)
 ```
 
 ### Layers
@@ -144,9 +147,14 @@ playground/
 | `rotifer wrap <name>` | Wrap a function as a Rotifer gene |
 | `rotifer test [name]` | Test a gene in L2 sandbox |
 | `rotifer compile [name]` | Compile gene to Rotifer IR (auto TS→WASM via Javy) |
-| `rotifer arena submit <name>` | Submit a gene to the Arena |
-| `rotifer arena list` | List Arena rankings |
-| `rotifer arena watch <domain>` | Watch Arena rankings (MVP: placeholder) |
+| `rotifer arena submit <name>` | Submit a gene to the Arena (`--cloud` for Cloud Arena) |
+| `rotifer arena list` | List Arena rankings (`--cloud` for Cloud Arena) |
+| `rotifer arena watch <domain>` | Watch Arena rankings live (`--cloud` for Cloud Arena) |
+| `rotifer login` | Log in to Rotifer Cloud via GitHub OAuth |
+| `rotifer logout` | Log out from Rotifer Cloud |
+| `rotifer publish <name>` | Publish a gene to Rotifer Cloud |
+| `rotifer search [query]` | Search genes on Rotifer Cloud |
+| `rotifer install <gene-id>` | Install a gene from Rotifer Cloud |
 | `rotifer agent create <name>` | Create an Agent with a genome |
 | `rotifer agent list` | List all agents |
 | `rotifer agent run <name>` | Execute an agent's genome pipeline |
@@ -192,7 +200,7 @@ cd playground
 # TypeScript CLI
 npm install
 npm run build          # Build to dist/
-npm test               # Run 91 TypeScript tests
+npm test               # Run 114 TypeScript tests
 npm run lint           # Type check only
 
 # Rust Core (requires Rust toolchain)
@@ -224,10 +232,16 @@ Changes driven by implementation feedback are proposed through the ADR process.
 - [x] **v0.1.0-alpha.1** — Core CLI + Genesis genes + Arena
 - [x] **v0.2.0-alpha.1** — IR compiler pipeline, live Arena watching, NAPI bridge, end-to-end demo loop
 - [x] **v0.3.0-alpha.1** — Frontend SDK: TS→WASM auto-compilation via Javy, WASI sandbox support
+- [x] **v0.4.0-alpha.1** — Cloud Binding: publish/search/install genes, Cloud Arena, GitHub OAuth
 - [ ] **v1.0.0** — Full protocol compliance, multi-binding support, P2P HLT
 
 ---
 
+## Community
+
+- [Discord](https://discord.gg/6d4JrfMr) — Join the conversation
+- [GitHub Discussions](https://github.com/rotifer-protocol/rotifer-playground/discussions) — Questions and proposals
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.

package/README.zh.md

@@ -5,10 +5,11 @@
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
 [![Protocol](https://img.shields.io/badge/Protocol-v2.9%20Frozen-orange)](https://github.com/rotifer-protocol/rotifer-spec)
+[![Discord](https://img.shields.io/discord/placeholder?label=Discord&logo=discord&color=5865F2)](https://discord.gg/6d4JrfMr)
 
-**Rotifer Protocol** 的本地开发环境——构建基因、运行 Arena 竞争、模拟代理进化。
+**Rotifer Protocol** 的开发环境——构建基因、运行 Arena 竞争、通过 Cloud 共享、模拟代理进化。
 
-> **状态：** Alpha (v0.3.0-alpha.1)。核心基因生命周期、IR 编译器管线、并行代数、**TS→WASM 自动编译 (Javy)**、实时 Arena 观察已可用。
+> **状态：** Alpha (v0.5.0-alpha.1)。核心基因生命周期、IR 编译器、**Cloud Binding**、**声誉系统**、**P2P 网络基础**及完整文档已可用。
 
 ---
 
@@ -228,6 +229,11 @@ bash demo.sh
 
 ---
 
+## 社区
+
+- [Discord](https://discord.gg/6d4JrfMr) — 加入讨论
+- [GitHub Discussions](https://github.com/rotifer-protocol/rotifer-playground/discussions) — 问题与提案
+
 ## 参与贡献
 
 开发指南请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。

package/dist/cloud/auth.d.ts

@@ -0,0 +1,14 @@
+import type { CloudCredentials } from "./types.js";
+export declare function loadCredentials(): CloudCredentials | null;
+export declare function saveCredentials(creds: CloudCredentials): void;
+export declare function clearCredentials(): void;
+export declare function isLoggedIn(): boolean;
+export declare function requireAuth(): CloudCredentials;
+export declare function generateCodeVerifier(): string;
+export declare function generateCodeChallenge(verifier: string): string;
+/**
+ * Start a local HTTP server to receive the OAuth callback.
+ * Handles both PKCE flow (?code=...) and implicit flow (#access_token=...).
+ */
+export declare function waitForOAuthCallback(port?: number): Promise<string>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/cloud/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/cloud/auth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkBnD,wBAAgB,eAAe,IAAI,gBAAgB,GAAG,IAAI,CAazD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAK7D;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAgB,WAAW,IAAI,gBAAgB,CAQ9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,MAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DzE"}

package/dist/cloud/auth.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCredentials = loadCredentials;
+exports.saveCredentials = saveCredentials;
+exports.clearCredentials = clearCredentials;
+exports.isLoggedIn = isLoggedIn;
+exports.requireAuth = requireAuth;
+exports.generateCodeVerifier = generateCodeVerifier;
+exports.generateCodeChallenge = generateCodeChallenge;
+exports.waitForOAuthCallback = waitForOAuthCallback;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_http_1 = require("node:http");
+const node_crypto_1 = require("node:crypto");
+const types_js_1 = require("./types.js");
+const ROTIFER_HOME = (0, node_path_1.join)(process.env.HOME || process.env.USERPROFILE || "/tmp", ".rotifer");
+function ensureRotiferHome() {
+    if (!(0, node_fs_1.existsSync)(ROTIFER_HOME)) {
+        (0, node_fs_1.mkdirSync)(ROTIFER_HOME, { recursive: true });
+    }
+}
+function credentialsPath() {
+    return (0, node_path_1.join)(ROTIFER_HOME, types_js_1.CREDENTIALS_FILE);
+}
+function loadCredentials() {
+    const path = credentialsPath();
+    if (!(0, node_fs_1.existsSync)(path))
+        return null;
+    try {
+        const data = JSON.parse((0, node_fs_1.readFileSync)(path, "utf-8"));
+        if (data.expires_at && Date.now() > data.expires_at) {
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+function saveCredentials(creds) {
+    ensureRotiferHome();
+    (0, node_fs_1.writeFileSync)(credentialsPath(), JSON.stringify(creds, null, 2) + "\n", {
+        mode: 0o600,
+    });
+}
+function clearCredentials() {
+    const path = credentialsPath();
+    if ((0, node_fs_1.existsSync)(path)) {
+        (0, node_fs_1.writeFileSync)(path, "", { mode: 0o600 });
+        require("node:fs").unlinkSync(path);
+    }
+}
+function isLoggedIn() {
+    return loadCredentials() !== null;
+}
+function requireAuth() {
+    const creds = loadCredentials();
+    if (!creds) {
+        throw new Error("Not logged in. Run 'rotifer login' first.");
+    }
+    return creds;
+}
+function generateCodeVerifier() {
+    return (0, node_crypto_1.randomBytes)(32).toString("base64url");
+}
+function generateCodeChallenge(verifier) {
+    return (0, node_crypto_1.createHash)("sha256").update(verifier).digest("base64url");
+}
+/**
+ * Start a local HTTP server to receive the OAuth callback.
+ * Handles both PKCE flow (?code=...) and implicit flow (#access_token=...).
+ */
+function waitForOAuthCallback(port = 9876) {
+    return new Promise((resolve, reject) => {
+        const server = (0, node_http_1.createServer)((req, res) => {
+            const url = new URL(req.url || "/", `http://localhost:${port}`);
+            if (url.pathname === "/callback/token") {
+                const token = url.searchParams.get("access_token");
+                const refresh = url.searchParams.get("refresh_token");
+                if (token) {
+                    res.writeHead(200, { "Content-Type": "text/html" });
+                    res.end("<html><body><h2>Login successful!</h2>" +
+                        "<p>You can close this window and return to the terminal.</p>" +
+                        "</body></html>");
+                    server.close();
+                    resolve(`implicit:${token}:${refresh || ""}`);
+                    return;
+                }
+            }
+            const code = url.searchParams.get("code");
+            if (code) {
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end("<html><body><h2>Login successful!</h2>" +
+                    "<p>You can close this window and return to the terminal.</p>" +
+                    "</body></html>");
+                server.close();
+                resolve(code);
+            }
+            else {
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end(`<html><body><script>
+if (window.location.hash) {
+  var params = new URLSearchParams(window.location.hash.substring(1));
+  var token = params.get('access_token');
+  var refresh = params.get('refresh_token');
+  if (token) {
+    window.location.href = '/callback/token?access_token=' + encodeURIComponent(token) + '&refresh_token=' + encodeURIComponent(refresh || '');
+  } else {
+    document.body.innerHTML = '<h2>Login failed</h2><p>No token received.</p>';
+  }
+} else {
+  document.body.innerHTML = '<h2>Login failed</h2><p>Missing authorization data.</p>';
+}
+</script><noscript>Enable JavaScript to complete login.</noscript></body></html>`);
+            }
+        });
+        server.listen(port, () => {
+            // Server ready
+        });
+        server.on("error", (err) => {
+            reject(new Error(`Failed to start callback server: ${err.message}`));
+        });
+        setTimeout(() => {
+            server.close();
+            reject(new Error("Login timed out after 120 seconds"));
+        }, 120_000);
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/cloud/auth.js.map

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

package/dist/cloud/client.d.ts

@@ -0,0 +1,57 @@
+import type { CloudConfig, CloudGene, CloudGeneListResponse, CloudArenaRankings, CloudArenaEntry, FitnessReport } from "./types.js";
+export declare function loadCloudConfig(): CloudConfig;
+export declare function listGenes(options: {
+    domain?: string;
+    query?: string;
+    owner?: string;
+    fidelity?: string;
+    sort?: string;
+    page?: number;
+    perPage?: number;
+}): Promise<CloudGeneListResponse>;
+export declare function getGene(id: string): Promise<CloudGene>;
+export declare function publishGene(opts: {
+    name: string;
+    domain: string;
+    version: string;
+    fidelity: string;
+    description: string;
+    phenotype: Record<string, unknown>;
+    wasmBytes: Buffer | null;
+}): Promise<CloudGene>;
+export declare function unpublishGene(id: string): Promise<void>;
+export declare function downloadGeneWasm(wasmUrl: string): Promise<Buffer>;
+export declare function arenaSubmit(geneId: string, fitness: FitnessReport): Promise<CloudArenaEntry>;
+export declare function arenaRankings(options: {
+    domain?: string;
+    page?: number;
+    perPage?: number;
+}): Promise<CloudArenaRankings>;
+export interface GeneReputationResponse {
+    gene_name: string;
+    score: number;
+    arena_score: number;
+    usage_score: number;
+    stability_score: number;
+    epoch: number;
+    computed_at: string;
+}
+export interface DeveloperReputationResponse {
+    score: number;
+    genes_published: number;
+    total_downloads: number;
+    arena_wins: number;
+    community_bonus: number;
+}
+export interface LeaderboardEntry {
+    username: string;
+    avatar_url: string | null;
+    score: number;
+    genes_published: number;
+    total_downloads: number;
+    arena_wins: number;
+}
+export declare function getGeneReputation(geneId: string): Promise<GeneReputationResponse>;
+export declare function getDeveloperReputation(userId: string): Promise<DeveloperReputationResponse>;
+export declare function getReputationLeaderboard(limit?: number): Promise<LeaderboardEntry[]>;
+//# sourceMappingURL=client.d.ts.map

package/dist/cloud/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cloud/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AASpB,wBAAgB,eAAe,IAAI,WAAW,CAa7C;AAgDD,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA4CjC;AAED,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAkC5D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC,SAAS,CAAC,CA2ErB;AAED,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7D;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvE;AAID,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2C9B;AAID,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA0CvF;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAkCjG;AAED,wBAAsB,wBAAwB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgB9F"}