@crowdedkingdoms/crowdyjs 9.0.0 → 10.0.0

package/MIGRATION.md

@@ -1,46 +1,68 @@
-# Unpublished next-major migration — local Rust authoring (BREAKING)
+# CrowdyJS v10 — project-first Mod Studio (BREAKING)
 
 This migration is implemented on the feature branch but is **not versioned or
 published yet**.
 
-`mountLiveCodingIDE` no longer connects to the WSS authoring service. Remove
-`languageServiceUrl` and `appToken` from every call:
+The session-only live-coding API was removed. There are deliberately no
+compatibility aliases.
 
-```ts
-// Before
-mountLiveCodingIDE(host, {
-  // ...normal live-coding options...
-  languageServiceUrl: import.meta.env.VITE_AUTHORING_LSP_URL,
-  appToken: () => game.session.getToken(),
-});
+Removed exports:
+
+- `mountLiveCodingIDE`
+- `mountLiveCoding`
+- `LiveCodingController`
+- `MountLiveCodingOptions`
+- `PLAYER_CODE_TEMPLATES` / `templateById`
+- the `moduleName` and `draftByDefault` mount options
+- the `@crowdedkingdoms/crowdyjs/live-coding` package subpath
 
-// After
-mountLiveCodingIDE(host, {
-  // ...normal live-coding options...
+Replace the old mount with a cloud project provider and the new subpath:
+
+```ts
+import { mountModStudio } from '@crowdedkingdoms/crowdyjs/mod-studio';
+
+const studio = await mountModStudio(host, {
+  projectProvider: game.playerCodeProjects,
+  playerCompute: game.playerCompute,
+  playerWallet: identity.playerWallet,
+  appId,
+  gridId,
+  grid,
+  workerUrl: playerCodeGlueWorkerUrl,
+  onHostCall,
 });
 ```
 
-The replacement is a lazy browser module worker. It uses local
-`web-tree-sitter`/Rust-grammar WASM assets and never receives a credential or
-opens a language-service connection. Consumers must:
-
-- remove consumer-side monaco-vscode initialization workarounds;
-- use a bundler that emits module workers and dependency `.wasm` assets, or pass
-  `languageWorkerFactory` for their asset pipeline;
-- remove authoring-LSP URL environment variables and token plumbing;
-- consume the embedded game-generated platform index by default (no runtime
-  fetch or BWF option plumbing); and
-- keep the textarea behavior as the only fallback. There is no server fallback.
-
-The Monaco adapter still speaks LSP 3.17 over a standard `vscode-jsonrpc`
-Worker `MessageConnection`. `monaco-languageclient` was removed because its
-current package hard-depends on `vscode-ws-jsonrpc`; direct Monaco providers
-adapt completion/hover/symbol/definition calls to the standard message
-connection without restoring that WSS dependency.
-
-The `@crowdedkingdoms/crowdyjs/live-coding` subpath now exports the IDE,
-platform-index loader/types, VFS limits, and worker transport. The package
-version intentionally remains unchanged until the coordinated major release.
+Custom UIs instantiate `ModStudioController` directly. Move all source state
+into `ModStudioProjectProvider`: project files are typed
+`{ target: 'SERVER' | 'CLIENT', path, content }`, and full-stack files share one
+revision/save. Module names and pairing preference are project settings.
+Do not stringify source maps in callers; Mod Studio creates `sourceFilesJson`
+only at the existing `playerCompute.deploy` wire boundary.
+
+Action semantics are now explicit:
+
+- **Test draft** saves atomically, compiles, and runs with draft egress rules.
+- **Deploy live** saves and runs the live project.
+- **Stop project** attempts `setEnabled(false)`, client broker shutdown, and
+  polling cleanup, and returns partial failures instead of hiding them.
+
+Full-stack order is CLIENT compile → SERVER compile → `setRequires` (only after
+both succeed) → SERVER enable → exact-version CLIENT artifact hot-swap.
+
+The local Rust worker remains credential-free and server-free. Monaco now uses
+target-prefixed URIs and loads project, personal-library, and common Rust files
+for cross-file completion/hover/symbols/definition. If Monaco/Worker/WASM fails,
+`mountModStudio` keeps a target/file-aware textarea inside the same project UI;
+there is no standalone fallback API.
+
+The Game API project contract is exposed through `PlayerCodeProjectsAPI`.
+Generated operations cover `playerCodeProjects`, `playerCodeProject`,
+`playerCodeProjectCreate`, `playerCodeProjectSave`,
+`playerCodeLibraryFiles`, `playerCodeLibrarySave`,
+`playerCodeCommonFiles`, and `playerCodeProjectImportFile`.
+
+This branch is versioned `10.0.0` for the coordinated major release.
 
 # CrowdyJS v8.10 Notes
 

package/README.md

@@ -32,11 +32,11 @@ CrowdyJS v4 targets browsers by default and uses native `fetch`, `WebSocket`, `c
 >
 > **Player-code authoring DX:** `playerCompute.setRequires`,
 > `marketplace.trustGridAuthor`, self-authored `gridClientMods` fields, and
-> attachment-keyed client artifact fetches require the 2026-07-22 authoring-DX
-> migration. `mountLiveCodingIDE` lazy-loads Monaco plus a browser-native Rust
-> language worker. Authoring sends no token and opens no server connection; if
-> Monaco, Worker, or the local WASM assets are unavailable, it preserves the
-> dependency-free textarea fallback.
+> version-keyed client artifact fetches require the 2026-07-22 authoring-DX
+> migration. The v9 `mountModStudio` surface is project-first: cloud project
+> revisions, target-scoped files, atomic autosave, and explicit draft/live/stop
+> orchestration. Its Rust language worker receives source plus the committed
+> platform index only—never a credential and never a server connection.
 
 > **v8.10 inventory authority:** generated craft/barter transactions work on
 > existing Model servers. Compute-refereed durable commits require Compute SDK
@@ -66,7 +66,7 @@ together whenever the public GraphQL surface changes; `npm run check:schema`
 detects drift in CI/release work.
 
 The browser authoring index follows the same boundary. `npm run build` validates
-only the committed `src/live-coding/assets/browser-authoring-index.json` and its
+only the committed internal `src/live-coding/assets/browser-authoring-index.json` and its
 generated TypeScript copy; it never discovers or reads a sibling game-api
 checkout. Coordinated maintainers compare an explicitly supplied exporter path:
 
@@ -140,6 +140,7 @@ If `managementUrl` is omitted, the SDK falls back to `httpUrl` for backwards-com
 | `client.gameModel` | Abstract game model: containers, properties, functions (incl. model-driven `notify_*` effects), sessions, and **automations / NPCs** (`upsertAutomation`, `runAutomation`, `automationRuns`, `automationStats`, …). |
 | `client.compute` | **Compute Modules** — server-side Rust/WASM logic: author + deploy source (`upsertModule`, `deployVersion`, `waitForCompile`), triggers + policy, synchronous `invoke`, and monitoring (`moduleRuns`, `moduleStats`, `moduleLogs`, `appDiagnostics`). Modules run server-only; see [Compute Modules docs](https://docs.crowdedkingdoms.com/game-api/compute-modules). |
 | `client.playerCompute` | Player-authored SERVER/CLIENT Rust/WASM bound to player-owned grids: deploy source, activate/deactivate, list modules/versions, and delete self-authored modules. |
+| `client.playerCodeProjects` | Cloud project, personal-library, and common-file APIs for Mod Studio: target-scoped files, metadata/module names, pairing preference, optimistic revisions, copy-by-value imports, and atomic metadata/file saves. Generated operations are pinned to the committed merged SDL. |
 | `client.playerModel` | Player-owned flexible model containers and grid-confined automations (`containers`, `createContainer`, `setProperty`, `automations`, `createAutomation`, …). |
 | `client.marketplace` | Player-code store/install/consent flows plus player-authorized grid claims: `claimGridOwnership` preserves the existing-grid policy flow, while `claimGridChunk` atomically creates and owns one chunk under `SELF_CLAIM` and `releaseClaimedGrid` releases an eligible owner-created claim. |
 | `client.udp` | UDP proxy subscriptions + spatial mutations (`sendActorUpdate`, `sendVoxelUpdate`, `sendAudioPacket`, `sendTextPacket`, `sendClientEvent`). |
@@ -147,38 +148,28 @@ If `managementUrl` is omitted, the SDK falls back to `httpUrl` for backwards-com
 | `client.refreshGameplayToken()` | Safely rotates an active game client's app token: disconnects the old-token UDP proxy, refreshes/stores the token, and opens the new-token proxy while existing realtime handlers resubscribe in place. |
 | `client.world(appId)` | Higher-level helpers for browser games (`actor.join`, `actor.sendState`, `actor.sendText`). |
 
-`PlayerCodeBroker` is the P1 page-side browser security skeleton: it transfers
+`PlayerCodeBroker` transfers
 compiled client artifacts to a platform-owned worker, keeps tokens on the page,
 allow-lists host calls, and locally clamps chunk-targeted effects to the owned
-grid before the normal SDK path reaches server authorization. P3 adds the
-platform worker glue/live-coding presentation UI.
-
-## Browser Rust live-coding IDE
-
-`mountLiveCodingIDE` creates one Monaco editor and one module Web Worker. The
-worker runs `web-tree-sitter` with the pinned VS Code Rust grammar asset and a
-bounded in-memory workspace. It implements LSP initialize/shutdown, full/incremental
-document sync, diagnostics, completion, hover, document symbols, and definitions
-within the open workspace. It does not run rustc or rust-analyzer, and deploys
-still use the platform compiler.
-
-The mount initializes the required monaco-vscode base/editor services once
-before creating any editor. Consumers must not provide a separate Monaco
-initialization workaround; concurrent mounts share services but receive
-isolated model roots, and destroyed roots are reusable by later mounts.
-
-The worker speaks the LSP 3.17 subset above over a standard
-`vscode-jsonrpc` `MessageConnection` and Worker `MessageReader`/`MessageWriter`.
-Small direct Monaco providers adapt editor actions to that connection.
-`monaco-languageclient` is intentionally absent: its current release hard-depends
-on the forbidden `vscode-ws-jsonrpc` WSS adapter and boots a much larger VS Code
-service stack. Removing it does not replace LSP with ad-hoc messages.
+grid before the normal SDK path reaches server authorization. Mod Studio
+hot-swaps only the exact version-keyed artifact returned after a successful
+CLIENT compile.
+
+## Player-code Mod Studio
+
+`mountModStudio` is the project-first SERVER/CLIENT Rust authoring surface. A
+project has one cloud revision, target-scoped files, project metadata, separate
+server/client module names, and a pairing preference. Full-stack edits autosave
+as one optimistic-concurrency write; the UI renders **Saving**, **Saved**,
+**Conflict**, or **Offline**, with retry and conflict-resolution actions.
 
 ```ts
-import { mountLiveCodingIDE } from '@crowdedkingdoms/crowdyjs/live-coding';
+import { mountModStudio } from '@crowdedkingdoms/crowdyjs/mod-studio';
 
-const handle = await mountLiveCodingIDE(host, {
+const studio = await mountModStudio(host, {
+  projectProvider: game.playerCodeProjects,
   playerCompute: game.playerCompute,
+  playerWallet: identity.playerWallet,
   appId,
   gridId,
   grid,
@@ -186,26 +177,68 @@ const handle = await mountLiveCodingIDE(host, {
   onHostCall,
 });
 
-// Terminates the language worker and the player-code runtime.
-handle.destroy();
+// Stops editor/runtime polling, the Rust worker, and any client broker owned
+// by this mount. It does not implicitly disable a deliberately live server.
+studio.destroy();
 ```
 
-Modern bundlers must preserve `new Worker(new URL(..., import.meta.url),
-{ type: 'module' })` and package `.wasm` assets. If a host needs custom worker
-loading (tests, a strict CSP, or a bespoke asset pipeline), pass
-`languageWorkerFactory: () => new Worker(yourUrl, { type: 'module' })`.
-`languageServiceUrl` and `appToken` are not IDE options; no server fallback
-exists.
-
-The embedded platform index is a byte-identical copy of the game export
-(`schemaVersion: 2`, Rust 1.97.1, SDK 0.1.5, ABI 0, 725 symbols, content hash
-`3f5f39d4…18ffb`). Its strict top-level fields are `schemaVersion`,
-`rustVersion`, `sdkVersion`, `abiVersion`, `contentHash`, `crates`, and
-`symbols`; every crate records its bounded `name`, `version`, and source hash,
-and each symbol has exactly `module`, `name`, `kind`, `signature`, and `docs`.
-BWF uses this embedded default and does not fetch or pass the artifact at runtime.
-`platformIndex` remains injectable for tests or coordinated future indexes;
-schema or unknown-field failures intentionally fall back to the textarea.
+Use `new ModStudioController(options)` for a custom/headless presentation. Its
+public edits are file operations (`addFile`, `renameFile`, `deleteFile`,
+`updateFile`) and project settings—there is no session-only source blob, fixed
+module name, or template JSON API. The deploy conversion to the Game API's
+legacy `sourceFilesJson` input happens only inside the controller's
+`playerCompute.deploy` call.
+
+The built-in UI provides a project switcher/new-project wizard
+(server/client/full-stack), target explorer, personal library/common files,
+tabs, settings, Problems/Build/Logs/Runs/Invoke panels, and explicit **Test
+draft**, **Deploy live**, and **Stop project** actions. Full-stack deployment is
+ordered: save once → compile CLIENT → compile SERVER → set/clear the pairing
+requirement only after both compiles → enable SERVER → hot-swap the exact
+version-keyed CLIENT artifact. Partial compile failures never write a new
+requirement. Stop always attempts both server disable and client/poll cleanup
+and reports each failure.
+
+Monaco uses target-prefixed model URIs (`.../server/Cargo.toml` and
+`.../client/Cargo.toml`) and opens every loaded project/library/common Rust file
+in one bounded local worker workspace. Completion, hover, symbols, and
+definition therefore work across loaded files; lifecycle snippets and hover
+notes distinguish SERVER platform execution from CLIENT broker host calls.
+Local tree-sitter markers are labeled advisory. Platform rustc output is parsed
+separately into authoritative path/line/column markers and remains visible in
+Build.
+
+The Rust worker receives source files and the strict embedded platform index
+only. It receives no credential, opens no socket/fetch path, and never falls
+back to a server language service. If Monaco, Worker, a WASM asset, or a custom
+platform index fails, the same Mod Studio mount keeps project/target tabs and
+uses one file-aware textarea—never a raw JSON blob.
+
+Modern bundlers must preserve module workers and package `.wasm` assets. Custom
+pipelines can pass `languageWorkerFactory` and `editorWorkerFactory`. The
+embedded index remains the byte-identical game export (`schemaVersion: 2`, Rust
+1.97.1, SDK 0.1.5, ABI 0, 725 symbols, content hash
+`3f5f39d4…18ffb`).
+
+### Game API project contract
+
+`PlayerCodeProjectsAPI` implements the transport-neutral
+`ModStudioProjectProvider`; generated GraphQL types remain inside the adapter.
+The committed merged schema and generated operations cover:
+
+- `playerCodeProjects(appId)` / `playerCodeProject(appId, projectId)`
+- `playerCodeProjectCreate(input)`
+- `playerCodeProjectSave(input)` for one atomic metadata/file delta
+- `playerCodeLibraryFiles(appId)` / `playerCodeLibrarySave(input)`
+- `playerCodeCommonFiles(appId)`
+- `playerCodeProjectImportFile(input)` for copy-by-value imports
+
+The adapter maps the API's `PAIRED | INDEPENDENT | SERVER_ONLY | CLIENT_ONLY`
+presentation enum to Mod Studio's runtime-oriented project kind and
+`REQUIRED | OPTIONAL | NONE` setting. A stale expected `revision` arrives as
+`CONFLICT` with `PLAYER_CODE_REVISION_CONFLICT` in the message and becomes a
+`ModStudioRevisionConflictError` with the latest cloud project when that
+follow-up read succeeds.
 
 | `createWorldSession(client, appId, config)` (from `@crowdedkingdoms/crowdyjs/stores`) | World Stores: opt-in, SDK-managed game state — typed codecs (`structCodec` binary DSL), your own actor with a 5 Hz send loop (`session.self`), a remote-actor registry with lanes/history/staleness (`session.actors`), attributed send errors (`session.errors`), a chunk/voxel cache with realtime merge + worldgen write-back (`session.chunks`), channel/direct-message inboxes + a typed event router, host tracking, typed save/avatar state, and a game-model container mirror. Only configured stores exist (compile-time + runtime); unimported stores tree-shake away. |
 | `client.kit(appId)` | Game Kit: ready-made mappings of game concepts onto the game model — `kit.inventory`, `kit.objects` (lockable doors/chests with custom permissions), `kit.npcs`, `kit.plots` (buy/rent land with transactional, replication-enforced grid grants), and the genre layers `kit.economy` (wallets/shops/trades/market), `kit.progression` (xp/skills/achievements/rating), `kit.loot`, `kit.quests`, `kit.combat`, `kit.matches` (session lobbies/turns/scores with notify-to-pull channels), `kit.decks` (hidden hands), `kit.worldsim` (clock/nodes/crops/waves), `kit.social` (parties/guilds/chat over teams+channels), `kit.leaderboards`, `kit.features` (tier gates), and the engine-aware helpers `kit.mobs` (refereed attacks, defs/slots, contact-damage parsing), `kit.pets` (adopt/summon/dismiss/rename), `kit.instances` (private world slices, seeded runs), `kit.director` (encounter runs), `kit.matchmaking` (queues/proposals/rating), `kit.minigames` (invoke-loop wrapper), `kit.economy.orderBook` (escrowed bid/ask market), engine paths on `kit.matches`/`kit.decks`/`kit.leaderboards`, `kit.quests` tutorial sequencing, `kit.engines` (compute capability detection) with `kit/wire` (the engine pose codec, `engineLanes()`, and the 77/90/91/92/93 event parsers) — plus blueprint builders + `kit.deploy(...)` for the admin "load the rules" step. |

package/dist/crowdy-client.d.ts

@@ -59,6 +59,7 @@ import { UdpAPI } from './domains/udp.js';
 import { GameModelAPI } from './domains/gameModel.js';
 import { ComputeAPI } from './domains/compute.js';
 import { PlayerComputeAPI } from './domains/playerCompute.js';
+import { PlayerCodeProjectsAPI } from './domains/playerCodeProjects.js';
 import { PlayerWalletAPI } from './domains/playerWallet.js';
 import { MarketplaceAPI } from './domains/marketplace.js';
 import { PlayerModelAPI } from './domains/playerModel.js';
@@ -197,6 +198,8 @@ export declare class CrowdyClient {
     readonly compute: ComputeAPI;
     /** Player-authored Rust/WASM bound to player-owned grids. */
     readonly playerCompute: PlayerComputeAPI;
+    /** Cloud source projects consumed by the project-first Mod Studio. */
+    readonly playerCodeProjects: PlayerCodeProjectsAPI;
     /** P4a marketplace (free mode): store, installs, consent, claim flows. */
     readonly marketplace: MarketplaceAPI;
     /** Player wallet, spend caps, hourly usage charges, and player policy (P2). */

package/dist/crowdy-client.d.ts.map

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

package/dist/crowdy-client.js

@@ -58,6 +58,7 @@ import { UdpAPI } from './domains/udp.js';
 import { GameModelAPI } from './domains/gameModel.js';
 import { ComputeAPI } from './domains/compute.js';
 import { PlayerComputeAPI } from './domains/playerCompute.js';
+import { PlayerCodeProjectsAPI } from './domains/playerCodeProjects.js';
 import { PlayerWalletAPI } from './domains/playerWallet.js';
 import { MarketplaceAPI } from './domains/marketplace.js';
 import { PlayerModelAPI } from './domains/playerModel.js';
@@ -120,6 +121,7 @@ export class CrowdyClient {
         });
         this.compute = new ComputeAPI(this.graphql);
         this.playerCompute = new PlayerComputeAPI(this.graphql);
+        this.playerCodeProjects = new PlayerCodeProjectsAPI(this.graphql);
         this.playerWallet = new PlayerWalletAPI(this.management);
         this.marketplace = new MarketplaceAPI(this.graphql, this.management);
         this.playerModel = new PlayerModelAPI(this.graphql);

package/dist/domains/playerCodeProjects.d.ts

@@ -0,0 +1,25 @@
+import type { GraphQLClient } from '../client.js';
+import { type CreateModStudioProjectInput, type ImportModStudioReferenceFileInput, type ModStudioProject, type ModStudioProjectProvider, type ModStudioProjectScope, type ModStudioProjectSummary, type ModStudioReferenceFile, type SaveModStudioLibraryFileInput, type SaveModStudioProjectInput } from '../mod-studio/models.js';
+/**
+ * Typed Game API adapter for private Mod Studio projects and reusable files.
+ * Mutable projects remain separate from immutable player-compute versions;
+ * only the controller's deploy path converts target files to sourceFilesJson.
+ */
+export declare class PlayerCodeProjectsAPI implements ModStudioProjectProvider {
+    private readonly graphql;
+    private readonly baselines;
+    constructor(graphql: GraphQLClient);
+    listProjects(scope: ModStudioProjectScope): Promise<ModStudioProjectSummary[]>;
+    getProject(input: ModStudioProjectScope & {
+        projectId: string;
+    }): Promise<ModStudioProject>;
+    createProject(input: CreateModStudioProjectInput): Promise<ModStudioProject>;
+    saveProject(input: SaveModStudioProjectInput): Promise<ModStudioProject>;
+    listPersonalLibraryFiles(scope: ModStudioProjectScope): Promise<ModStudioReferenceFile[]>;
+    savePersonalLibraryFile(input: SaveModStudioLibraryFileInput): Promise<ModStudioReferenceFile>;
+    listCommonFiles(scope: ModStudioProjectScope): Promise<ModStudioReferenceFile[]>;
+    importReferenceFile(input: ImportModStudioReferenceFileInput): Promise<ModStudioProject>;
+    private remember;
+    private request;
+}
+//# sourceMappingURL=playerCodeProjects.d.ts.map

package/dist/domains/playerCodeProjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playerCodeProjects.d.ts","sourceRoot":"","sources":["../../src/domains/playerCodeProjects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQlD,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,iCAAiC,EAEtC,KAAK,gBAAgB,EAErB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AA0BjC;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,wBAAwB;IAGxD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;gBAEpC,OAAO,EAAE,aAAa;IAE7C,YAAY,CAChB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAU/B,UAAU,CACd,KAAK,EAAE,qBAAqB,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GACnD,OAAO,CAAC,gBAAgB,CAAC;IAQtB,aAAa,CACjB,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,gBAAgB,CAAC;IAoBtB,WAAW,CACf,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAwDtB,wBAAwB,CAC5B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAU9B,uBAAuB,CAC3B,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,sBAAsB,CAAC;IAc5B,eAAe,CACnB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAS9B,mBAAmB,CACvB,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,gBAAgB,CAAC;IAuB5B,OAAO,CAAC,QAAQ;YAKF,OAAO;CAiBtB"}