@crowdedkingdoms/crowdyjs 17.13.0-dev.1 → 17.14.0-dev.1

package/dist/crowdy-studio/controller.js

@@ -1,4 +1,5 @@
 import { PlayerCodeBroker, } from '../player-runtime/player-code-broker.js';
+import { CrowdyError, CrowdyGraphQLError } from '../errors.js';
 import { digestCanonicalJson, sha256Digest, } from '../player-host/json-schema.js';
 import { parseRustcDiagnostics } from './diagnostics.js';
 import { githubNewRepositoryUrl, githubRepositorySlug } from './github/new-repo.js';
@@ -204,6 +205,7 @@ export class CrowdyStudioController {
             ...options,
             ...this.scope(),
             ...(modStarter ? { modStarter } : {}),
+            engine: this.state.serverEngine,
         });
         const project = await this.options.projectProvider.createProject(input);
         this.installProject(project);
@@ -982,8 +984,10 @@ export class CrowdyStudioController {
                 message: `Submitting ${name}`,
             },
         });
-        if (target === 'SERVER' && this.mods) {
-            return this.buildMod(name, files, operation);
+        if (this.mods) {
+            return target === 'SERVER'
+                ? this.buildMod(name, files, operation)
+                : this.buildClientHalf(name, files, operation);
         }
         // The server resolves the source from the project itself: the saved
         // files at the project revision, or — for a GITHUB project — the rust at
@@ -1041,34 +1045,69 @@ export class CrowdyStudioController {
      */
     async buildMod(name, files, operation) {
         const mods = this.mods;
-        if (!MOD_NAME.test(name)) {
-            throw new Error(`The server module name '${name}' must be 1-48 lowercase letters, digits, - or _ to run as a mod`);
-        }
+        const problem = modNameProblem(this.requireProject());
+        if (problem)
+            throw new Error(problem);
         const { appId, gridId } = this.scope();
         const queued = await mods.modBuild(appId, {
-            name: CRATE_NAME.test(name) ? name : `mod-${name}`,
-            files: files
-                .filter((file) => isModCrateFile(file.path))
-                .map((file) => ({ path: file.path, content: file.content })),
+            name: crateName(name),
+            files: crateFiles(files),
+        });
+        this.checkOperation(operation);
+        const built = await this.awaitModBuild('SERVER', name, queued.buildId, operation);
+        if (!built)
+            return null;
+        const mod = await mods.modDeploy(appId, gridId, name, built.buildId);
+        this.checkOperation(operation);
+        return { target: 'SERVER', name, versionId: String(mod.version) };
+    }
+    /**
+     * The CLIENT target as a ck-exec mod's CLIENT half: the project's `crowdy-client-sdk` crate,
+     * built on the platform (`modClientBuild`, a build of `kind` `client`). It is attached to the
+     * project's mod when the project runs ({@link attachClientHalf}).
+     */
+    async buildClientHalf(name, files, operation) {
+        const problem = modNameProblem(this.requireProject());
+        if (problem)
+            throw new Error(problem);
+        const cargo = files.find((file) => file.path === 'Cargo.toml')?.content ?? '';
+        if (/^\s*crowdy-compute-sdk\s*=/m.test(cargo)) {
+            this.recordBuild('CLIENT', LEGACY_CLIENT_CRATE);
+            this.update({
+                runtime: {
+                    phase: 'COMPILE_FAILED',
+                    target: 'CLIENT',
+                    message: `${name} is a legacy player compute crate; a CLIENT half builds on crowdy-client-sdk`,
+                },
+            });
+            return null;
+        }
+        const queued = await this.mods.modClientBuild(this.options.appId, {
+            name: crateName(name),
+            files: crateFiles(files),
         });
         this.checkOperation(operation);
+        const built = await this.awaitModBuild('CLIENT', name, queued.buildId, operation);
+        return built ? { target: 'CLIENT', name, versionId: built.buildId } : null;
+    }
+    /** Polls a mod build, a mod's or a CLIENT half's, recording its log; null when it did not succeed. */
+    async awaitModBuild(target, name, buildId, operation) {
+        const mods = this.mods;
         const limit = this.options.compilePollLimit ?? 60;
         const pollMs = this.options.compilePollMs ?? 1500;
         for (let attempt = 0; attempt < limit; attempt++) {
-            const b = await mods.modBuildStatus(appId, queued.buildId);
+            const b = await mods.modBuildStatus(this.options.appId, buildId);
             this.checkOperation(operation);
             if (b.status === 'succeeded') {
-                this.recordBuild('SERVER', b.log ?? '');
-                const mod = await mods.modDeploy(appId, gridId, name, b.buildId);
-                this.checkOperation(operation);
-                return { target: 'SERVER', name, versionId: String(mod.version) };
+                this.recordBuild(target, b.log ?? '');
+                return b;
             }
             if (b.status === 'failed') {
-                this.recordBuild('SERVER', b.log ?? 'Compilation failed without output');
+                this.recordBuild(target, b.log ?? 'Compilation failed without output');
                 this.update({
                     runtime: {
                         phase: 'COMPILE_FAILED',
-                        target: 'SERVER',
+                        target,
                         message: `${name} failed to compile`,
                     },
                 });
@@ -1078,12 +1117,106 @@ export class CrowdyStudioController {
             this.checkOperation(operation);
         }
         const timeout = `Compilation timed out after ${limit} polls`;
-        this.recordBuild('SERVER', timeout);
+        this.recordBuild(target, timeout);
         this.update({
-            runtime: { phase: 'COMPILE_FAILED', target: 'SERVER', message: timeout },
+            runtime: { phase: 'COMPILE_FAILED', target, message: timeout },
         });
         return null;
     }
+    /**
+     * Attaches a built CLIENT half to the project's mod, consents to it as its author (the API
+     * serves a CLIENT half only to a player who consented or trusts its author, the author too) and
+     * fetches the served module for this browser's preview. A CLIENT-only project first makes sure
+     * the mod it rides is the player's and switched on.
+     */
+    async attachClientHalf(compiled, operation) {
+        const mods = this.mods;
+        const { appId, gridId } = this.scope();
+        const project = this.requireProject();
+        const modName = projectModName(project);
+        if (!projectTargets(project.kind).includes('SERVER')) {
+            await this.ensureClientOnlyMod(modName, operation);
+        }
+        this.update({
+            runtime: { phase: 'ENABLING', target: 'CLIENT', message: `Attaching ${compiled.name} to ${modName}` },
+        });
+        const attached = await mods.modClientDeploy(appId, gridId, modName, compiled.versionId);
+        this.checkOperation(operation);
+        await mods.consentClientMod(appId, attached.modId, attached.capabilityHash);
+        this.checkOperation(operation);
+        this.recordNote('CLIENT', `Attached to mod '${modName}' as CLIENT version ${attached.clientVersion} (capabilities ` +
+            `${attached.capabilityHash}; ticks every ${attached.tickIntervalMs} ms). Visitors of grid ` +
+            `${gridId} run it once they consent to it or trust you; you consented to it as its author.`);
+        let artifact;
+        try {
+            artifact = await mods.modClientArtifactBytes(appId, attached.modId);
+        }
+        catch (error) {
+            if (error instanceof CrowdyGraphQLError && error.code === 'NOT_FOUND') {
+                throw new CrowdyError({
+                    message: `${compiled.name} is attached to mod '${modName}', but its preview did not load: the ` +
+                        'API serves a CLIENT half only while its mod is switched on and not held, to a player ' +
+                        `with run_client_code who stands in grid ${gridId}`,
+                    cause: error,
+                });
+            }
+            if (error instanceof CrowdyGraphQLError && error.code === 'RATE_LIMITED') {
+                throw new CrowdyError({
+                    message: `${compiled.name} is attached to mod '${modName}', but its preview was fetched too ` +
+                        'often (12 a minute); deploy again in a minute',
+                    cause: error,
+                });
+            }
+            throw error;
+        }
+        this.checkOperation(operation);
+        if (artifact.digest !== attached.digest || artifact.clientVersion !== attached.clientVersion) {
+            throw new Error('The served CLIENT half is not the one just attached; deploy again');
+        }
+        return artifact;
+    }
+    /**
+     * A CLIENT half rides a mod: without a mod of this name running as the player on the grid,
+     * the mod starter's server half is deployed under it first, and the log says so. The mod is
+     * switched on, since only a running mod's CLIENT half is served.
+     */
+    async ensureClientOnlyMod(name, operation) {
+        const mods = this.mods;
+        const { appId, gridId } = this.scope();
+        const mine = (await mods.myMods(appId)).find((mod) => String(mod.gridId) === gridId && mod.name === name);
+        this.checkOperation(operation);
+        if (!mine) {
+            if (!this.canTarget('SERVER', 'write') || !this.canTarget('SERVER', 'run')) {
+                throw new Error(`A CLIENT half rides a mod, and grid ${gridId} has no mod '${name}' of yours; deploying one needs SERVER write and run permissions here`);
+            }
+            this.update({
+                runtime: { phase: 'COMPILING', target: 'SERVER', message: `Deploying the mod starter as ${name}` },
+            });
+            const starter = await mods.modStarter(appId);
+            this.checkOperation(operation);
+            const queued = await mods.modBuild(appId, { name: crateName(name), files: starter.files });
+            this.checkOperation(operation);
+            const built = await this.awaitModBuild('SERVER', name, queued.buildId, operation);
+            if (!built) {
+                throw new Error(`The mod starter did not build, so the CLIENT half has no mod '${name}' to ride`);
+            }
+            await mods.modDeploy(appId, gridId, name, built.buildId);
+            this.checkOperation(operation);
+            this.recordNote('SERVER', `Grid ${gridId} had no mod '${name}' of yours, and a CLIENT half rides a mod: deployed the ` +
+                `ck-exec mod starter (${starter.crate}) as '${name}', its server half.`);
+        }
+        if (!mine?.enabled) {
+            await mods.modSetEnabled(appId, gridId, name, true);
+            this.checkOperation(operation);
+            if (mine)
+                this.recordNote('SERVER', `Switched mod '${name}' on, so its CLIENT half is served.`);
+        }
+    }
+    recordNote(target, note) {
+        this.update({
+            buildOutput: [this.state.buildOutput, `## ${target}\n${note}`].filter(Boolean).join('\n\n'),
+        });
+    }
     recordBuild(target, log) {
         const section = `## ${target}\n${log || 'Compiled successfully.'}`;
         const authoritativeDiagnostics = [
@@ -1122,28 +1255,47 @@ export class CrowdyStudioController {
             throw new Error(`${compiled.name} compiled successfully, but run_client_code is unavailable on this grid`);
         }
         const runtime = this.clientRuntimeOptions();
-        const artifact = await this.options.playerCompute.artifactBytes({
-            ...this.scope(),
-            name: compiled.name,
-            versionId: compiled.versionId,
-        });
-        this.checkOperation(operation);
-        if (artifact.versionId !== compiled.versionId ||
-            !artifact.artifactHash ||
-            artifact.bytes.byteLength === 0) {
-            throw new Error('Client artifact did not match the compiled project version');
-        }
-        const brokerOptions = {
-            ...runtime,
-            artifactHash: artifact.artifactHash,
-            fuelPerDispatch: artifact.fuelPerDispatch,
-            onPresentation: this.options.onPresentation,
-            tickIntervalMs: this.options.clientTickIntervalMs ??
-                parseClientTickIntervalMs(this.requireProject().files.find((file) => file.target === 'CLIENT' && file.path === 'Cargo.toml')?.content),
-        };
+        let brokerOptions;
+        let bytes;
+        if (this.mods) {
+            const half = await this.attachClientHalf(compiled, operation);
+            bytes = half.bytes;
+            brokerOptions = {
+                ...runtime,
+                engine: 'ck-exec',
+                moduleName: half.name,
+                artifactHash: half.digest,
+                fuelPerDispatch: half.fuelPerDispatch,
+                consentedHostCalls: half.capabilitySummary.hostFunctions,
+                onPresentation: this.options.onPresentation,
+                tickIntervalMs: this.options.clientTickIntervalMs ?? half.tickIntervalMs,
+            };
+        }
+        else {
+            const artifact = await this.options.playerCompute.artifactBytes({
+                ...this.scope(),
+                name: compiled.name,
+                versionId: compiled.versionId,
+            });
+            this.checkOperation(operation);
+            if (artifact.versionId !== compiled.versionId ||
+                !artifact.artifactHash ||
+                artifact.bytes.byteLength === 0) {
+                throw new Error('Client artifact did not match the compiled project version');
+            }
+            bytes = artifact.bytes;
+            brokerOptions = {
+                ...runtime,
+                artifactHash: artifact.artifactHash,
+                fuelPerDispatch: artifact.fuelPerDispatch,
+                onPresentation: this.options.onPresentation,
+                tickIntervalMs: this.options.clientTickIntervalMs ??
+                    parseClientTickIntervalMs(this.requireProject().files.find((file) => file.target === 'CLIENT' && file.path === 'Cargo.toml')?.content),
+            };
+        }
         const broker = this.options.brokerFactory?.(brokerOptions) ??
             new PlayerCodeBroker(brokerOptions);
-        await broker.start(artifact.bytes);
+        await broker.start(bytes);
         this.checkOperation(operation);
         const previous = this.broker;
         this.broker = broker;
@@ -1170,10 +1322,12 @@ export class CrowdyStudioController {
                 this.broker = null;
             }
         }
-        if (projectTargets(project.kind).includes('SERVER')) {
+        // On ck-exec a CLIENT-only project's CLIENT half rides a mod too: switched off, it is no
+        // longer served to visitors.
+        if (projectTargets(project.kind).includes('SERVER') || this.mods) {
             serverStopped = false;
             try {
-                await this.setServerEnabled(moduleNameFor(project, 'SERVER'), false);
+                await this.setServerEnabled(this.mods ? projectModName(project) : moduleNameFor(project, 'SERVER'), false);
                 serverStopped = true;
             }
             catch (error) {
@@ -1289,12 +1443,13 @@ export class CrowdyStudioController {
                 this.update({ runs: [] });
                 return;
             }
-            const lines = serverName?.trim()
-                ? await this.mods.modLogs(this.options.appId, this.options.gridId, serverName.trim(), {
+            const modName = projectModNameOrNull(this.state.project);
+            const lines = modName
+                ? await this.mods.modLogs(this.options.appId, this.options.gridId, modName, {
                     limit: 50,
                 })
                 : [];
-            this.update({ logs: lines.map((line) => modLogRow(serverName.trim(), line)) });
+            this.update({ logs: lines.map((line) => modLogRow(modName, line)) });
             return;
         }
         if (surface === 'runs') {
@@ -1318,10 +1473,9 @@ export class CrowdyStudioController {
             });
             return;
         }
-        // Player compute's units and compile quota: with a mod, only a CLIENT target spends them.
-        const legacyUsage = !this.mods || projectTargets(this.state.project.kind).includes('CLIENT');
+        // Player compute's units and compile quota, which nothing spends on ck-exec.
         const [usage, wallet] = await Promise.all([
-            legacyUsage
+            !this.mods
                 ? this.options.playerCompute.usage({ appId: this.options.appId })
                 : Promise.resolve(null),
             this.options.playerWallet?.balance() ?? Promise.resolve(null),
@@ -1593,6 +1747,43 @@ function isModCrateFile(path) {
         path === 'README.md' ||
         (path.startsWith('src/') && path.endsWith('.rs')));
 }
+function crateFiles(files) {
+    return files
+        .filter((file) => isModCrateFile(file.path))
+        .map((file) => ({ path: file.path, content: file.content }));
+}
+/** A build's crate name for a module: its own when it is one, else `mod-<name>`. */
+function crateName(name) {
+    return CRATE_NAME.test(name) ? name : `mod-${name}`;
+}
+/**
+ * The mod a ck-exec project runs as: its SERVER module's name, or for a CLIENT-only project the
+ * CLIENT module's, which names the mod its CLIENT half rides.
+ */
+function projectModName(project) {
+    return moduleNameFor(project, projectTargets(project.kind).includes('SERVER') ? 'SERVER' : 'CLIENT');
+}
+function projectModNameOrNull(project) {
+    try {
+        return projectModName(project);
+    }
+    catch {
+        return null;
+    }
+}
+/** Why a ck-exec project's mod name cannot be a mod's, or null. */
+function modNameProblem(project) {
+    const name = projectModName(project);
+    if (MOD_NAME.test(name))
+        return null;
+    return projectTargets(project.kind).includes('SERVER')
+        ? `The server module name '${name}' must be 1-48 lowercase letters, digits, - or _ to run as a mod`
+        : `The CLIENT module name '${name}' names the mod its CLIENT half rides, so it must be 1-48 lowercase letters, digits, - or _`;
+}
+const LEGACY_CLIENT_CRATE = 'This CLIENT crate depends on crowdy-compute-sdk, legacy player compute. On ck-exec a CLIENT ' +
+    'target is a mod\u2019s CLIENT half, one crowdy-client-sdk crate: in Cargo.toml replace the ' +
+    'crowdy-compute-sdk line with crowdy-client-sdk = "0.1.0", and in src/ use crowdy_client_sdk ' +
+    'in place of crowdy_compute_sdk. Its host calls are the same, less the Game Model and sessions.';
 function modLogRow(moduleName, line) {
     const level = LOG_LEVELS[line.level] ?? 'debug';
     return {

package/dist/crowdy-studio/dom-shell.d.ts.map

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

package/dist/crowdy-studio/dom-shell.js

@@ -903,7 +903,9 @@ export class CrowdyStudioDomShell {
         setInputUnlessFocused(this.clientModuleName, project.metadata.clientModuleName ?? '');
         this.serverModuleName.disabled = !projectTargets(project.kind).includes('SERVER');
         this.clientModuleName.disabled = !projectTargets(project.kind).includes('CLIENT');
-        this.pairing.disabled = project.kind !== 'FULL_STACK';
+        // A mod has no pairing: its CLIENT half rides it.
+        this.pairing.disabled =
+            project.kind !== 'FULL_STACK' || state.serverEngine === 'ck-exec';
         this.pairing.value = project.metadata.pairingPreference;
     }
     renderProblems(state) {

package/dist/crowdy-studio/embed/hud-layer.d.ts

@@ -1,5 +1,6 @@
 /**
- * A persistent, game-owned HUD layer for player-compute CLIENT mods. A
+ * A persistent, game-owned HUD layer for CLIENT mods (ck-exec CLIENT halves
+ * and legacy player-compute CLIENT modules). A
  * running client mod never touches the game DOM; it emits `hud_set` payloads
  * that the broker forwards here. This layer lives outside the studio panel so
  * a mod's HUD survives panel re-renders and keeps rendering after the coding

package/dist/crowdy-studio/embed/hud-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hud-layer.d.ts","sourceRoot":"","sources":["../../../src/crowdy-studio/embed/hud-layer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,OAAO,CAAC,UAAU;IAUlB,+DAA+D;IAC/D,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAKtC,oEAAoE;IACpE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI;IAShE,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,SAAS;IAajB,mEAAmE;IACnE,OAAO,CAAC,QAAQ;CAQjB"}
+{"version":3,"file":"hud-layer.d.ts","sourceRoot":"","sources":["../../../src/crowdy-studio/embed/hud-layer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,OAAO,CAAC,UAAU;IAUlB,+DAA+D;IAC/D,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAKtC,oEAAoE;IACpE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI;IAShE,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,SAAS;IAajB,mEAAmE;IACnE,OAAO,CAAC,QAAQ;CAQjB"}

package/dist/crowdy-studio/embed/panel.d.ts

@@ -19,7 +19,7 @@ export interface CrowdyStudioEmbedServices {
     playerWallet?: CrowdyStudioPlayerWallet;
     /** GitHub repository loop; omission hides the card. `CrowdyClient` provides it. */
     crowdyStudioGitHub?: CrowdyStudioGitHubTransport;
-    /** ck-exec, the default SERVER engine when present. `CrowdyClient` provides it. */
+    /** ck-exec, the default engine for both targets when present. `CrowdyClient` provides it. */
     exec?: CrowdyStudioMods;
 }
 export interface CrowdyStudioEmbedTargetPermission {
@@ -70,11 +70,12 @@ export interface CrowdyStudioEmbedOptions {
      */
     github?: CrowdyStudioGitHubTransport;
     /**
-     * What runs the SERVER target: a ck-exec mod on the grid, built from the project's
-     * `ckx-sdk` crate (`client.exec`), or legacy player compute, which the platform is
-     * switching off. Defaults to `'ck-exec'` when the client has `exec` (every `CrowdyClient`
-     * does), else `'player-compute'`. Pass `'player-compute'` to stay on the legacy engine
-     * until it is removed.
+     * What runs the project: a ck-exec mod on the grid, built from the project's `ckx-sdk`
+     * crate, with the CLIENT target as its `crowdy-client-sdk` CLIENT half (`client.exec`), or
+     * legacy player compute for both targets, which the platform is switching off. Defaults to
+     * `'ck-exec'` when the client has `exec` (every `CrowdyClient` does), else
+     * `'player-compute'`. Pass `'player-compute'` to stay on the legacy engine until 18.0
+     * removes it.
      */
     serverEngine?: CrowdyStudioServerEngine;
     /**

package/dist/crowdy-studio/embed/panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../src/crowdy-studio/embed/panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAKL,KAAK,4BAA4B,EAClC,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAO1D,MAAM,MAAM,4BAA4B,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,2BAA2B,CAAC;IAC1C,aAAa,EAAE,yBAAyB,CAAC;IACzC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,2BAA2B,CAAC;IACjD,mFAAmF;IACnF,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,iCAAiC,CAAC;IAC1C,MAAM,EAAE,iCAAiC,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;AAEpF,+DAA+D;AAC/D,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,yBAAyB,CAAC;IAClC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAC/B,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,2BAA2B,CAAC;IAClC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC;;;OAGG;IACH,qBAAqB,CAAC,IAAI,MAAM,IAAI,CAAC;IACrC,sEAAsE;IACtE,cAAc,CAAC,IAAI,IAAI,CAAC;IACxB,sFAAsF;IACtF,cAAc,CAAC,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACvD,kBAAkB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,gBAAgB,CAAC,IAAI,IAAI,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,IAAI,CAAC;IAClB,WAAW,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAClD,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACtD;AAED,6EAA6E;AAC7E,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,iBAAiB,EAAE,kCAAkC,CAAC;IACtD,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,UAAU,CAAC,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,wEAAwE;IACxE,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,mEAAmE;IACnE,cAAc,CAAC,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5D,+DAA+D;IAC/D,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;CACnD;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAehB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAdpC,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;gBAEhB,OAAO,EAAE,wBAAwB;IAS9D,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,IAAI,IAAI,4BAA4B,GAAG,IAAI,CAE9C;IAED,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAK/C,OAAO,IAAI,IAAI;IAKf,KAAK,IAAI,IAAI;IAqCb,OAAO,CAAC,IAAI;IA6DZ;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAqCd;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAmEd,OAAO,CAAC,YAAY;YAgBN,WAAW;IAkDzB,sEAAsE;YACxD,cAAc;IAoE5B,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE7B;IAEF,OAAO,CAAC,iBAAiB;IAyCzB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG9B;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAO5B;IAEF,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,OAAO;IAsBf,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAEhC;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAI5B;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;CACH;AAED,2DAA2D;AAC3D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAEnB"}
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../src/crowdy-studio/embed/panel.ts"],"names":[],"mappings":"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"}

package/dist/crowdy-studio/starter-projects.d.ts

@@ -1,3 +1,4 @@
+import type { CrowdyStudioServerEngine } from './controller.js';
 import { type CreateCrowdyStudioProjectInput, type CrowdyStudioProjectKind } from './models.js';
 /** ck-exec's mod starter crate (`client.exec.modStarter(appId)`). */
 export interface CrowdyStudioModStarter {
@@ -19,6 +20,13 @@ export interface CrowdyStudioNewProjectOptions {
      * client pairing, so a full-stack project records `NONE`.
      */
     modStarter?: CrowdyStudioModStarter;
+    /**
+     * `'ck-exec'`: the project is a ck-exec mod. Its SERVER target starts from `modStarter`
+     * (required with one), its CLIENT target from a `crowdy-client-sdk` crate, the mod's CLIENT
+     * half, and both module names fit a mod's. Default `'player-compute'`, where the CLIENT target
+     * is a legacy compute SDK crate.
+     */
+    engine?: CrowdyStudioServerEngine;
 }
 /** Create a compile-oriented starter without introducing a raw JSON source map. */
 export declare function createCrowdyStudioStarterProject(options: CrowdyStudioNewProjectOptions): CreateCrowdyStudioProjectInput;

package/dist/crowdy-studio/starter-projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"starter-projects.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/starter-projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,8BAA8B,EAEnC,KAAK,uBAAuB,EAG7B,MAAM,aAAa,CAAC;AAOrB,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,KAAK,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,uBAAuB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC;AAED,mFAAmF;AACnF,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,6BAA6B,GACrC,8BAA8B,CA+BhC"}
+{"version":3,"file":"starter-projects.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/starter-projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAEL,KAAK,8BAA8B,EAEnC,KAAK,uBAAuB,EAG7B,MAAM,aAAa,CAAC;AASrB,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,KAAK,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,uBAAuB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED,mFAAmF;AACnF,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,6BAA6B,GACrC,8BAA8B,CAqChC"}

package/dist/crowdy-studio/starter-projects.js

@@ -1,12 +1,18 @@
 import { projectTargets, } from './models.js';
 const SDK_VERSION = '0.1.8';
+/** crowdy-client-sdk, what a ck-exec mod's CLIENT half builds on; the build points it at the platform's copy. */
+const CLIENT_SDK_VERSION = '0.1.0';
 /** A mod's name is at most 48 characters, and the SERVER module name is `<base>-server`. */
 const MOD_BASE_MAX = 48 - '-server'.length;
 /** Create a compile-oriented starter without introducing a raw JSON source map. */
 export function createCrowdyStudioStarterProject(options) {
     const mod = options.modStarter;
-    const base = mod ? modModuleBase(options.name) : moduleName(options.name);
+    const exec = options.engine === 'ck-exec';
     const targets = projectTargets(options.kind);
+    if (exec && targets.includes('SERVER') && !mod) {
+        throw new Error('A ck-exec SERVER target starts from the mod starter (client.exec.modStarter)');
+    }
+    const base = mod || exec ? modModuleBase(options.name) : moduleName(options.name);
     const metadata = {
         name: options.name.trim() || 'Untitled mod',
         ...(options.description?.trim()
@@ -18,7 +24,7 @@ export function createCrowdyStudioStarterProject(options) {
         ...(targets.includes('CLIENT')
             ? { clientModuleName: `${base}-client` }
             : {}),
-        pairingPreference: options.kind === 'FULL_STACK' && !mod ? 'REQUIRED' : 'NONE',
+        pairingPreference: options.kind === 'FULL_STACK' && !mod && !exec ? 'REQUIRED' : 'NONE',
     };
     return {
         appId: options.appId,
@@ -29,9 +35,77 @@ export function createCrowdyStudioStarterProject(options) {
             ? mod
                 ? modStarterFiles(mod, metadata.serverModuleName)
                 : starterFiles(target, metadata.serverModuleName)
-            : starterFiles(target, metadata.clientModuleName)),
+            : exec
+                ? clientHalfStarterFiles(metadata.clientModuleName)
+                : starterFiles(target, metadata.clientModuleName)),
     };
 }
+/**
+ * A ck-exec mod's CLIENT half: one `crowdy-client-sdk` crate within the build's rules (only
+ * `[package]`, `[lib]` as a cdylib, the SDK and serde dependencies, and
+ * `[package.metadata.crowdy] tick_interval_ms`).
+ */
+function clientHalfStarterFiles(name) {
+    return [
+        {
+            target: 'CLIENT',
+            path: 'Cargo.toml',
+            content: `[package]
+name = "${name}"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+crate-type = ["cdylib"]
+
+# How often visitors' browsers call tick (clamped 16–1000 ms).
+# 1000 = HUD/text. 50 = physics minigames (pool). 16 = shooters, if a tick stays cheap.
+[package.metadata.crowdy]
+tick_interval_ms = 1000
+
+[dependencies]
+crowdy-client-sdk = "${CLIENT_SDK_VERSION}"
+serde_json = "1"
+`,
+        },
+        {
+            target: 'CLIENT',
+            path: 'src/lib.rs',
+            content: `use crowdy_client_sdk as crowdy;
+
+fn init() {
+    // Runs once in each visitor's browser, after they consent to this CLIENT half
+    // (or trust you) and while they stand in this grid.
+    crowdy::log(1, "ready");
+}
+
+fn tick(_dt_ms: u32) {
+    // Every tick_interval_ms (Cargo.toml). The state blob lasts as long as the page's worker.
+    let ticks = u32::from_le_bytes(crowdy::state_get().try_into().unwrap_or([0; 4])).wrapping_add(1);
+    crowdy::state_set(&ticks.to_le_bytes());
+    // Host calls cross the page's broker as the visiting player, inside this grid: the HUD and
+    // overlay, chunk and actor reads, voxel writes, spatial and channel sends, grid events.
+    // Type "crowdy::api::" for the rest. The page's DOM and tokens are never reachable.
+    let _ = crowdy::api::hud_set(serde_json::json!({ "text": format!("Ticks here: {ticks}") }));
+    //
+    // Mouse (holodeck canvas only; Studio chrome is omitted). Drain every tick:
+    //   let data = crowdy::api::pointer_clicks().unwrap_or(serde_json::json!({}));
+    // data["clicks"] = [{ "t": "down"|"up", "button": 0, "atMs", "heldMs", "nx", "ny" }]
+}
+
+fn invoke(payload: &[u8]) -> Vec<u8> {
+    payload.to_vec()
+}
+
+fn event(_payload: &[u8]) {
+    // Grid events from the other CLIENT halves on this page (crowdy::api::emit_event).
+}
+
+crowdy::register_module!(init: init, tick: tick, invoke: invoke, event: event);
+`,
+        },
+    ];
+}
 function modStarterFiles(starter, name) {
     const paths = new Set(starter.files.map((file) => file.path));
     if (!paths.has('Cargo.toml') || !paths.has('src/lib.rs')) {
@@ -66,8 +140,8 @@ function renamePackage(manifest, name) {
         .join('\n');
 }
 /**
- * A mod module base: short enough for `<base>-server` to be a mod name, and starting with a
- * letter, as a build's crate names must.
+ * A mod module base: short enough for `<base>-server` and `<base>-client` to be mod names, and
+ * starting with a letter, as a build's crate names must.
  */
 function modModuleBase(value) {
     const slug = slugModuleName(value);