@crowdedkingdoms/crowdyjs 10.0.0 → 11.1.0

package/MIGRATION.md

@@ -1,28 +1,49 @@
-# CrowdyJS v10 — project-first Mod Studio (BREAKING)
-
-This migration is implemented on the feature branch but is **not versioned or
-published yet**.
-
-The session-only live-coding API was removed. There are deliberately no
-compatibility aliases.
-
-Removed exports:
-
-- `mountLiveCodingIDE`
-- `mountLiveCoding`
-- `LiveCodingController`
-- `MountLiveCodingOptions`
-- `PLAYER_CODE_TEMPLATES` / `templateById`
-- the `moduleName` and `draftByDefault` mount options
-- the `@crowdedkingdoms/crowdyjs/live-coding` package subpath
-
-Replace the old mount with a cloud project provider and the new subpath:
+# CrowdyJS v11.1 — responsive Crowdy Studio embedding
+
+Crowdy Studio now sizes to its host instead of imposing a 680-pixel minimum
+height. The mount observes host element resizes and relayouts Monaco, while its
+explorer and settings panes respond to the host's container width rather than
+the browser viewport.
+
+Embedding hosts should provide an explicit width and height for the mount
+element. No project, autosave, deploy, pairing, worker-security, or GraphQL
+behavior changed.
+
+# CrowdyJS v11 — Crowdy Studio rename (BREAKING)
+
+Version 11 removes the previous Mod Studio names completely. There are no
+compatibility exports, client properties, package subpaths, GraphQL operations,
+schema types, or CSS aliases.
+
+Rename imports and API access:
+
+- `@crowdedkingdoms/crowdyjs/mod-studio` →
+  `@crowdedkingdoms/crowdyjs/crowdy-studio`
+- `mountModStudio` → `mountCrowdyStudio`
+- `ModStudioController` → `CrowdyStudioController`
+- `MountModStudioOptions` → `MountCrowdyStudioOptions`
+- `ModStudioHandle` → `CrowdyStudioHandle`
+- every other public `ModStudio*` model, error, diagnostic, and editor type →
+  its `CrowdyStudio*` equivalent
+- `modStudioFileKey`, `modStudioFileUri`, and `normalizeModStudioPath` →
+  `crowdyStudioFileKey`, `crowdyStudioFileUri`, and
+  `normalizeCrowdyStudioPath`
+- `client.playerCodeProjects` → `client.crowdyStudio`
+- `PlayerCodeProjectsAPI` → `CrowdyStudioAPI`
+- CSS classes under `ck-mod-studio*` → `ck-crowdy-studio*`
+
+The matching Game API schema is required. Its project roots changed from
+`playerCodeProjects`, `playerCodeProject`, `playerCodeProjectCreate`,
+`playerCodeProjectSave`, `playerCodeLibraryFiles`, `playerCodeLibrarySave`,
+`playerCodeCommonFiles`, and `playerCodeProjectImportFile` to the corresponding
+`crowdyStudio*` roots. Project, library, common-file, input, and enum schema
+types likewise use `CrowdyStudio` in place of `PlayerCode`.
 
 ```ts
-import { mountModStudio } from '@crowdedkingdoms/crowdyjs/mod-studio';
+import { mountCrowdyStudio } from '@crowdedkingdoms/crowdyjs/crowdy-studio';
 
-const studio = await mountModStudio(host, {
-  projectProvider: game.playerCodeProjects,
+const studio = await mountCrowdyStudio(host, {
+  projectProvider: game.crowdyStudio,
   playerCompute: game.playerCompute,
   playerWallet: identity.playerWallet,
   appId,
@@ -33,36 +54,26 @@ const studio = await mountModStudio(host, {
 });
 ```
 
-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.
+Provider behavior, optimistic saves, target permissions, the credential-free
+worker, full-stack deploy ordering, and stop semantics are unchanged.
 
-Full-stack order is CLIENT compile → SERVER compile → `setRequires` (only after
-both succeed) → SERVER enable → exact-version CLIENT artifact hot-swap.
+# CrowdyJS v10 — project-first authoring (historical)
 
-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.
+Version 10 replaced the session-only live-coding API with cloud projects. It
+removed `mountLiveCodingIDE`, `mountLiveCoding`, `LiveCodingController`,
+`MountLiveCodingOptions`, `PLAYER_CODE_TEMPLATES`, `templateById`, the
+`moduleName` and `draftByDefault` mount options, and the
+`@crowdedkingdoms/crowdyjs/live-coding` package subpath.
 
-The Game API project contract is exposed through `PlayerCodeProjectsAPI`.
-Generated operations cover `playerCodeProjects`, `playerCodeProject`,
-`playerCodeProjectCreate`, `playerCodeProjectSave`,
-`playerCodeLibraryFiles`, `playerCodeLibrarySave`,
-`playerCodeCommonFiles`, and `playerCodeProjectImportFile`.
+Projects introduced one shared optimistic revision for SERVER and CLIENT files,
+project metadata and module names, personal-library/common-file imports, atomic
+autosave, and explicit **Test draft**, **Deploy live**, and **Stop project**
+actions. Full-stack deployment was ordered CLIENT compile → SERVER compile →
+`setRequires` → SERVER enable → exact-version CLIENT artifact hot-swap.
 
-This branch is versioned `10.0.0` for the coordinated major release.
+The browser Rust worker remained credential-free and server-free. Monaco used
+target-prefixed URIs for cross-file language features and retained the
+target/file-aware textarea fallback.
 
 # CrowdyJS v8.10 Notes
 

package/README.md

@@ -33,10 +33,13 @@ 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
 > version-keyed client artifact fetches require the 2026-07-22 authoring-DX
-> migration. The v9 `mountModStudio` surface is project-first: cloud project
+> migration. The v11 `mountCrowdyStudio` 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.
+> CrowdyJS 11 requires the matching Crowdy Studio Game API schema; the previous
+> package subpath, exports, client property, GraphQL roots, and schema types were
+> removed without aliases.
 
 > **v8.10 inventory authority:** generated craft/barter transactions work on
 > existing Model servers. Compute-refereed durable commits require Compute SDK
@@ -140,7 +143,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.crowdyStudio` | Cloud project, personal-library, and common-file APIs for Crowdy 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`). |
@@ -151,23 +154,28 @@ If `managementUrl` is omitted, the SDK falls back to `httpUrl` for backwards-com
 `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. Mod Studio
+grid before the normal SDK path reaches server authorization. Crowdy Studio
 hot-swaps only the exact version-keyed artifact returned after a successful
 CLIENT compile.
 
-## Player-code Mod Studio
+## Crowdy Studio
 
-`mountModStudio` is the project-first SERVER/CLIENT Rust authoring surface. A
+`mountCrowdyStudio` 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.
 
+The mount fills its host and observes host element resizes, so games can embed
+it in draggable docks or split panes without manually relaying window resize
+events. Give the host an explicit width and height; Crowdy Studio relayouts
+Monaco and collapses secondary panes from its own container width.
+
 ```ts
-import { mountModStudio } from '@crowdedkingdoms/crowdyjs/mod-studio';
+import { mountCrowdyStudio } from '@crowdedkingdoms/crowdyjs/crowdy-studio';
 
-const studio = await mountModStudio(host, {
-  projectProvider: game.playerCodeProjects,
+const studio = await mountCrowdyStudio(host, {
+  projectProvider: game.crowdyStudio,
   playerCompute: game.playerCompute,
   playerWallet: identity.playerWallet,
   appId,
@@ -182,7 +190,7 @@ const studio = await mountModStudio(host, {
 studio.destroy();
 ```
 
-Use `new ModStudioController(options)` for a custom/headless presentation. Its
+Use `new CrowdyStudioController(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
@@ -211,7 +219,7 @@ 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
+platform index fails, the same Crowdy 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
@@ -222,22 +230,22 @@ embedded index remains the byte-identical game export (`schemaVersion: 2`, Rust
 
 ### Game API project contract
 
-`PlayerCodeProjectsAPI` implements the transport-neutral
-`ModStudioProjectProvider`; generated GraphQL types remain inside the adapter.
+`CrowdyStudioAPI` implements the transport-neutral
+`CrowdyStudioProjectProvider`; 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
+- `crowdyStudioProjects(appId)` / `crowdyStudioProject(appId, projectId)`
+- `crowdyStudioProjectCreate(input)`
+- `crowdyStudioProjectSave(input)` for one atomic metadata/file delta
+- `crowdyStudioLibraryFiles(appId)` / `crowdyStudioLibrarySave(input)`
+- `crowdyStudioCommonFiles(appId)`
+- `crowdyStudioProjectImportFile(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
+presentation enum to Crowdy 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
+`CONFLICT` with `CROWDY_STUDIO_REVISION_CONFLICT` in the message and becomes a
+`CrowdyStudioRevisionConflictError` 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. |

package/dist/crowdy-client.d.ts

@@ -59,7 +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 { CrowdyStudioAPI } from './domains/crowdyStudio.js';
 import { PlayerWalletAPI } from './domains/playerWallet.js';
 import { MarketplaceAPI } from './domains/marketplace.js';
 import { PlayerModelAPI } from './domains/playerModel.js';
@@ -198,8 +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;
+    /** Crowdy Studio cloud projects, libraries, and common source files. */
+    readonly crowdyStudio: CrowdyStudioAPI;
     /** 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":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IAEjC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAGnC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,EAAE;QACT,4EAA4E;QAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iDAAiD;QACjD,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,8EAA8E;QAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,+EAA+E;QAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,oBAAoB,CAA0C;IAEtE,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IAGnC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACjD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAGzB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,wEAAwE;IACxE,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IAEvC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;gBAEnB,MAAM,GAAE,kBAAuB;IAmG3C,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIpC,0DAA0D;IAC1D,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAczC,2BAA2B;IAczC;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAIjC;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa;IAS3D,gEAAgE;IAChE,KAAK,IAAI,IAAI;CAId;AAED,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,kBAAuB,GAC9B,YAAY,CAEd"}

package/dist/crowdy-client.js

@@ -58,7 +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 { CrowdyStudioAPI } from './domains/crowdyStudio.js';
 import { PlayerWalletAPI } from './domains/playerWallet.js';
 import { MarketplaceAPI } from './domains/marketplace.js';
 import { PlayerModelAPI } from './domains/playerModel.js';
@@ -121,7 +121,7 @@ export class CrowdyClient {
         });
         this.compute = new ComputeAPI(this.graphql);
         this.playerCompute = new PlayerComputeAPI(this.graphql);
-        this.playerCodeProjects = new PlayerCodeProjectsAPI(this.graphql);
+        this.crowdyStudio = new CrowdyStudioAPI(this.graphql);
         this.playerWallet = new PlayerWalletAPI(this.management);
         this.marketplace = new MarketplaceAPI(this.graphql, this.management);
         this.playerModel = new PlayerModelAPI(this.graphql);

package/dist/crowdy-studio/controller.d.ts

@@ -0,0 +1,188 @@
+import { type PlayerCodeBrokerOptions, type PlayerCodeGridBounds } from '../player-runtime/player-code-broker.js';
+import type { PlayerComputeAPI } from '../domains/playerCompute.js';
+import type { PlayerWalletAPI } from '../domains/playerWallet.js';
+import { type CrowdyStudioDiagnostic } from './diagnostics.js';
+import { type CrowdyStudioFileRef, type CrowdyStudioPairingPreference, type CrowdyStudioProject, type CrowdyStudioProjectMetadata, type CrowdyStudioProjectProvider, type CrowdyStudioProjectSummary, type CrowdyStudioReferenceFile, type CrowdyStudioSaveState, type CrowdyStudioTarget } from './models.js';
+import { type CrowdyStudioNewProjectOptions } from './starter-projects.js';
+export type CrowdyStudioPhase = 'IDLE' | 'TESTING_DRAFT' | 'DEPLOYING_LIVE' | 'COMPILING' | 'ENABLING' | 'RUNNING' | 'COMPILE_FAILED' | 'STOPPING' | 'STOPPED' | 'PARTIAL_FAILURE' | 'ERROR';
+export type CrowdyStudioPolledSurface = 'runs' | 'logs' | 'usage';
+export interface CrowdyStudioRuntimeStatus {
+    phase: CrowdyStudioPhase;
+    target?: CrowdyStudioTarget;
+    message?: string;
+}
+export interface CrowdyStudioUsageSnapshot {
+    hourUnitsUsed: string;
+    dayUnitsUsed: string;
+    unitsPerHour: string | null;
+    unitsPerDay: string | null;
+    compilesThisHour: number;
+    maxCompilesPerHour: number;
+    gateStatus: string;
+    gateReason: string | null;
+}
+export interface CrowdyStudioWalletSnapshot {
+    balanceCents: string;
+    currency: string;
+}
+export interface CrowdyStudioRun {
+    runId: string;
+    moduleName: string;
+    triggerSource: string;
+    startedAt: string;
+    durationUs: number;
+    fuelUsed: string;
+    success: boolean;
+    errorMessage?: string | null;
+}
+export interface CrowdyStudioInvokeResult {
+    resultBase64?: string | null;
+    resultJson?: string | null;
+    fuelUsed?: string;
+    durationUs?: number;
+}
+export interface CrowdyStudioState {
+    projects: readonly CrowdyStudioProjectSummary[];
+    project: CrowdyStudioProject | null;
+    personalLibraryFiles: readonly CrowdyStudioReferenceFile[];
+    commonFiles: readonly CrowdyStudioReferenceFile[];
+    openFiles: readonly CrowdyStudioFileRef[];
+    activeFile: CrowdyStudioFileRef | null;
+    saveState: CrowdyStudioSaveState;
+    saveMessage?: string;
+    runtime: CrowdyStudioRuntimeStatus;
+    buildOutput: string;
+    authoritativeDiagnostics: readonly CrowdyStudioDiagnostic[];
+    localDiagnostics: readonly CrowdyStudioDiagnostic[];
+    runs: readonly CrowdyStudioRun[];
+    logs: readonly CrowdyStudioRun[];
+    usage: CrowdyStudioUsageSnapshot | null;
+    wallet: CrowdyStudioWalletSnapshot | null;
+    invokeResult: CrowdyStudioInvokeResult | null;
+}
+export type CrowdyStudioPlayerCompute = Pick<PlayerComputeAPI, 'deploy' | 'versions' | 'setEnabled' | 'setRequires' | 'artifactBytes' | 'usage' | 'runs' | 'logs' | 'invoke'>;
+export type CrowdyStudioPlayerWallet = Pick<PlayerWalletAPI, 'balance'>;
+export interface CrowdyStudioBroker {
+    start(bytes: ArrayBuffer): Promise<void>;
+    stop(): void;
+}
+export interface CrowdyStudioControllerOptions {
+    projectProvider: CrowdyStudioProjectProvider;
+    playerCompute: CrowdyStudioPlayerCompute;
+    playerWallet?: CrowdyStudioPlayerWallet;
+    appId: string;
+    gridId: string;
+    initialProjectId?: string;
+    /** Required only when a project has a CLIENT target. */
+    grid?: PlayerCodeGridBounds;
+    /** Platform-owned glue worker; required only for CLIENT execution. */
+    workerUrl?: string | URL;
+    /** Page-side allow-listed host-call router; required only for CLIENT execution. */
+    onHostCall?: PlayerCodeBrokerOptions['onHostCall'];
+    onPresentation?: PlayerCodeBrokerOptions['onPresentation'];
+    /** Host-visible effective permissions; server authorization remains final. */
+    targetPermissions?: Partial<Record<CrowdyStudioTarget, {
+        canWrite: boolean;
+        canRun: boolean;
+    }>>;
+    clientTickIntervalMs?: number;
+    autosaveMs?: number;
+    retryMs?: number;
+    compilePollMs?: number;
+    compilePollLimit?: number;
+    monitorPollMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+    brokerFactory?: (options: PlayerCodeBrokerOptions) => CrowdyStudioBroker;
+    isOnline?: () => boolean;
+    onStateChange?: (state: CrowdyStudioState) => void;
+}
+export interface CrowdyStudioStopResult {
+    serverStopped: boolean | null;
+    clientStopped: boolean | null;
+    failures: string[];
+}
+/**
+ * Headless project-first Crowdy Studio driver. It owns optimistic project saves,
+ * file CRUD, deployment ordering, runtime polling, and client hot swaps; the
+ * DOM mount is only a view over this state.
+ */
+export declare class CrowdyStudioController {
+    private readonly options;
+    private state;
+    private readonly listeners;
+    private autosaveTimer;
+    private retryTimer;
+    private savePromise;
+    private editGeneration;
+    private persistedGeneration;
+    private conflictRemote;
+    private broker;
+    private operationGeneration;
+    private readonly visibleSurfaces;
+    private readonly surfaceTimers;
+    private pageVisible;
+    private destroyed;
+    constructor(options: CrowdyStudioControllerOptions);
+    getState(): CrowdyStudioState;
+    subscribe(listener: (state: CrowdyStudioState) => void): () => void;
+    canTarget(target: CrowdyStudioTarget, action: 'write' | 'run'): boolean;
+    initialize(): Promise<void>;
+    createProject(options: Omit<CrowdyStudioNewProjectOptions, 'appId' | 'gridId'>): Promise<CrowdyStudioProject>;
+    switchProject(projectId: string): Promise<void>;
+    private loadProject;
+    private installProject;
+    openFile(ref: CrowdyStudioFileRef): void;
+    closeFile(ref: CrowdyStudioFileRef): void;
+    fileContent(ref: CrowdyStudioFileRef): string;
+    addFile(target: CrowdyStudioTarget, path: string, content?: string): void;
+    renameFile(target: CrowdyStudioTarget, path: string, nextPath: string): void;
+    deleteFile(target: CrowdyStudioTarget, path: string): void;
+    importReferenceFile(reference: CrowdyStudioReferenceFile, destinationPath?: string): Promise<void>;
+    saveProjectFileToLibrary(target: CrowdyStudioTarget, path: string, title?: string): Promise<CrowdyStudioReferenceFile>;
+    updateFile(target: CrowdyStudioTarget, path: string, content: string): void;
+    updateSettings(patch: Partial<Pick<CrowdyStudioProjectMetadata, 'name' | 'description' | 'serverModuleName' | 'clientModuleName' | 'pairingPreference'>>): void;
+    setPairingPreference(preference: CrowdyStudioPairingPreference): void;
+    setLocalDiagnostics(diagnostics: readonly CrowdyStudioDiagnostic[]): void;
+    /**
+     * Flush all edits in one optimistic-concurrency save. If edits arrive while
+     * the request is in flight, a second atomic save follows with the new
+     * revision instead of overwriting local content with the earlier response.
+     */
+    saveNow(): Promise<boolean>;
+    retrySave(): Promise<boolean>;
+    acceptRemoteConflict(): Promise<void>;
+    overwriteConflict(): Promise<boolean>;
+    testDraft(): Promise<void>;
+    deployLive(): Promise<void>;
+    private deployProject;
+    private compileTarget;
+    private recordBuild;
+    private enableServer;
+    private runClient;
+    stopProject(): Promise<CrowdyStudioStopResult>;
+    invoke(exportName: string, paramsJson?: string): Promise<CrowdyStudioInvokeResult>;
+    setSurfaceVisible(surface: CrowdyStudioPolledSurface, visible: boolean): void;
+    setPageVisible(visible: boolean): void;
+    refreshSurface(surface: CrowdyStudioPolledSurface): Promise<void>;
+    destroy(): void;
+    private performSaveLoop;
+    private markEdited;
+    private scheduleRetry;
+    private scheduleSurfacePoll;
+    private restartVisibleSurfacePolling;
+    private stopSurfacePolling;
+    private clearSurfaceTimer;
+    private clearSaveTimers;
+    private clearTimer;
+    private clientRuntimeOptions;
+    private checkOperation;
+    private sleep;
+    private requireProject;
+    private requireFile;
+    private assertProjectTarget;
+    private scope;
+    private setRuntime;
+    private update;
+    private ensureAlive;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/crowdy-studio/controller.d.ts.map

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