@crowdedkingdoms/crowdyjs 9.0.0 → 11.0.0

package/MIGRATION.md

@@ -1,46 +1,68 @@
-# Unpublished next-major migration — local Rust authoring (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:
+# 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
-// Before
-mountLiveCodingIDE(host, {
-  // ...normal live-coding options...
-  languageServiceUrl: import.meta.env.VITE_AUTHORING_LSP_URL,
-  appToken: () => game.session.getToken(),
-});
-
-// After
-mountLiveCodingIDE(host, {
-  // ...normal live-coding options...
+import { mountCrowdyStudio } from '@crowdedkingdoms/crowdyjs/crowdy-studio';
+
+const studio = await mountCrowdyStudio(host, {
+  projectProvider: game.crowdyStudio,
+  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.
+Provider behavior, optimistic saves, target permissions, the credential-free
+worker, full-stack deploy ordering, and stop semantics are unchanged.
+
+# CrowdyJS v10 — project-first authoring (historical)
+
+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.
+
+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.
+
+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

@@ -32,11 +32,14 @@ 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 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
@@ -66,7 +69,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 +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.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`). |
@@ -147,38 +151,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. Crowdy Studio
+hot-swaps only the exact version-keyed artifact returned after a successful
+CLIENT compile.
+
+## Crowdy Studio
+
+`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.
 
 ```ts
-import { mountLiveCodingIDE } from '@crowdedkingdoms/crowdyjs/live-coding';
+import { mountCrowdyStudio } from '@crowdedkingdoms/crowdyjs/crowdy-studio';
 
-const handle = await mountLiveCodingIDE(host, {
+const studio = await mountCrowdyStudio(host, {
+  projectProvider: game.crowdyStudio,
   playerCompute: game.playerCompute,
+  playerWallet: identity.playerWallet,
   appId,
   gridId,
   grid,
@@ -186,26 +180,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 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
+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 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
+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
+
+`CrowdyStudioAPI` implements the transport-neutral
+`CrowdyStudioProjectProvider`; generated GraphQL types remain inside the adapter.
+The committed merged schema and generated operations cover:
+
+- `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 Crowdy Studio's runtime-oriented project kind and
+`REQUIRED | OPTIONAL | NONE` setting. A stale expected `revision` arrives as
+`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. |
 | `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 { CrowdyStudioAPI } from './domains/crowdyStudio.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;
+    /** 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":"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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 { CrowdyStudioAPI } from './domains/crowdyStudio.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.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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"}