@crowdedkingdoms/crowdyjs 9.0.0 → 10.0.0

package/dist/live-coding/live-coding-controller.js

@@ -1,141 +0,0 @@
-import { PlayerCodeBroker, } from '../player-runtime/player-code-broker.js';
-/**
- * Headless driver for the live-coding deploy loop (08), shared by the DOM
- * panel and any custom host UI. It owns the edit -> deploy -> compile-poll ->
- * (server) enable / (client) fetch+respawn state machine, surfaces compile
- * feedback and the quota/wallet meters, and manages the client broker
- * lifecycle. All IO is injected so it is unit-testable without a browser.
- */
-export class LiveCodingController {
-    constructor(options) {
-        this.options = options;
-        this.broker = null;
-        this.status = { phase: 'idle', target: 'server' };
-    }
-    getStatus() {
-        return this.status;
-    }
-    set(next) {
-        this.status = { ...this.status, ...next };
-        this.options.onStatus?.(this.status);
-    }
-    sleep(ms) {
-        return (this.options.sleep ?? ((d) => new Promise((r) => setTimeout(r, d))))(ms);
-    }
-    /** Refresh the quota/wallet meter for the panel. */
-    async refreshUsage() {
-        const usage = await this.options.playerCompute.usage({
-            appId: this.options.appId,
-        });
-        this.set({
-            usage: {
-                hourUnitsUsed: String(usage.hourUnitsUsed),
-                unitsPerHour: usage.unitsPerHour != null ? String(usage.unitsPerHour) : null,
-                compilesThisHour: usage.compilesThisHour,
-                maxCompilesPerHour: usage.maxCompilesPerHour,
-                gateStatus: usage.gateStatus,
-                gateReason: usage.gateReason ?? null,
-            },
-        });
-    }
-    /**
-     * Deploy source and run it. For server targets: deploy -> poll compile ->
-     * enable. For client targets: deploy -> poll compile -> fetch bytes ->
-     * (re)spawn the broker worker. Draft mode suppresses server egress to other
-     * sessions while iterating.
-     */
-    async deploy(input) {
-        const { name, target } = input;
-        this.set({ phase: 'deploying', target, message: undefined, compileLog: null });
-        let version;
-        try {
-            version = await this.options.playerCompute.deploy({
-                appId: this.options.appId,
-                gridId: this.options.gridId,
-                name,
-                target: target === 'server' ? 'SERVER' : 'CLIENT',
-                sourceFilesJson: input.sourceFilesJson,
-                tickHz: input.tickHz,
-                draft: input.draft,
-            });
-        }
-        catch (err) {
-            // Compile-quota refusals and cap breaches surface here (P2 governor).
-            this.set({ phase: 'error', message: err.message });
-            return;
-        }
-        const compiled = await this.pollCompile(name, version.versionId);
-        if (!compiled.ok) {
-            this.set({
-                phase: 'compile_failed',
-                message: 'compile failed',
-                compileLog: compiled.log,
-            });
-            return;
-        }
-        if (target === 'server') {
-            this.set({ phase: 'enabling' });
-            await this.options.playerCompute.setEnabled({
-                appId: this.options.appId,
-                gridId: this.options.gridId,
-                name,
-                enabled: true,
-            });
-            this.set({ phase: 'running', message: 'server module live' });
-        }
-        else {
-            await this.runClient(name);
-        }
-        await this.refreshUsage().catch(() => { });
-    }
-    async pollCompile(name, versionId) {
-        this.set({ phase: 'compiling' });
-        const pollMs = this.options.pollMs ?? 1500;
-        for (let i = 0; i < 60; i++) {
-            const versions = await this.options.playerCompute.versions({
-                appId: this.options.appId,
-                gridId: this.options.gridId,
-                name,
-            });
-            const v = versions.find((row) => row.versionId === versionId);
-            if (v?.compileStatus === 'succeeded')
-                return { ok: true, log: v.compileLog ?? null };
-            if (v?.compileStatus === 'failed')
-                return { ok: false, log: v.compileLog ?? null };
-            await this.sleep(pollMs);
-        }
-        return { ok: false, log: 'compile timed out' };
-    }
-    async runClient(name) {
-        const artifact = await this.options.playerCompute.artifactBytes({
-            appId: this.options.appId,
-            gridId: this.options.gridId,
-            name,
-        });
-        const options = {
-            workerUrl: this.options.workerUrl,
-            grid: this.options.grid,
-            artifactHash: artifact.artifactHash,
-            fuelPerDispatch: artifact.fuelPerDispatch,
-            onHostCall: this.options.onHostCall,
-            onPresentation: this.options.onPresentation,
-            tickIntervalMs: this.options.clientTickIntervalMs ?? 1000,
-        };
-        const broker = this.options.brokerFactory?.(options) ?? new PlayerCodeBroker(options);
-        if (this.broker) {
-            await broker.start(artifact.bytes);
-            this.broker.stop();
-            this.broker = broker;
-        }
-        else {
-            await broker.start(artifact.bytes);
-            this.broker = broker;
-        }
-        this.set({ phase: 'running', message: 'client module live in the sandbox' });
-    }
-    stop() {
-        this.broker?.stop();
-        this.broker = null;
-        this.set({ phase: 'idle' });
-    }
-}

package/dist/live-coding/mount.d.ts

@@ -1,26 +0,0 @@
-import { LiveCodingController, type LiveCodingControllerOptions } from './live-coding-controller.js';
-import { type PlayerCodeTemplate } from './templates.js';
-export interface MountLiveCodingOptions extends Omit<LiveCodingControllerOptions, 'onStatus'> {
-    /** Module name to deploy under; defaults to a per-grid scratch name. */
-    moduleName?: string;
-    /** Templates offered in the picker; defaults to the built-in starter set. */
-    templates?: PlayerCodeTemplate[];
-    /** Deploy in draft mode by default (server egress suppressed while iterating). */
-    draftByDefault?: boolean;
-}
-export interface LiveCodingHandle {
-    controller: LiveCodingController;
-    destroy: () => void;
-}
-/**
- * Mount the live-coding panel into a host element (08 option A). Deliberately
- * dependency-free DOM: a textarea editor, target + template pickers, deploy /
- * draft-deploy / stop buttons, a status+console line, and the quota/wallet
- * meter. Games skin it via the returned nodes or their own CSS; a game that
- * wants a custom UI can drive LiveCodingController directly instead.
- *
- * Safe to import in non-DOM contexts; mounting throws only if called without
- * a document.
- */
-export declare function mountLiveCoding(el: HTMLElement, options: MountLiveCodingOptions): LiveCodingHandle;
-//# sourceMappingURL=mount.d.ts.map

package/dist/live-coding/mount.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/live-coding/mount.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EAEjC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,2BAA2B,EAAE,UAAU,CAAC;IACrD,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,kFAAkF;IAClF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,oBAAoB,CAAC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,sBAAsB,GAC9B,gBAAgB,CAmFlB"}

package/dist/live-coding/mount.js

@@ -1,108 +0,0 @@
-import { LiveCodingController, } from './live-coding-controller.js';
-import { PLAYER_CODE_TEMPLATES, } from './templates.js';
-/**
- * Mount the live-coding panel into a host element (08 option A). Deliberately
- * dependency-free DOM: a textarea editor, target + template pickers, deploy /
- * draft-deploy / stop buttons, a status+console line, and the quota/wallet
- * meter. Games skin it via the returned nodes or their own CSS; a game that
- * wants a custom UI can drive LiveCodingController directly instead.
- *
- * Safe to import in non-DOM contexts; mounting throws only if called without
- * a document.
- */
-export function mountLiveCoding(el, options) {
-    if (typeof document === 'undefined') {
-        throw new Error('mountLiveCoding requires a DOM document');
-    }
-    const templates = options.templates ?? PLAYER_CODE_TEMPLATES;
-    const moduleName = options.moduleName ?? 'scratch-mod';
-    const root = document.createElement('div');
-    root.className = 'ck-live-coding';
-    const targetSelect = document.createElement('select');
-    for (const t of ['server', 'client']) {
-        const opt = document.createElement('option');
-        opt.value = t;
-        opt.textContent = t;
-        targetSelect.appendChild(opt);
-    }
-    const templateSelect = document.createElement('select');
-    const editor = document.createElement('textarea');
-    editor.className = 'ck-live-coding-editor';
-    editor.rows = 20;
-    const refreshTemplates = () => {
-        templateSelect.innerHTML = '';
-        for (const t of templates.filter((t) => t.target === targetSelect.value)) {
-            const opt = document.createElement('option');
-            opt.value = t.id;
-            opt.textContent = t.title;
-            templateSelect.appendChild(opt);
-        }
-        const first = templates.find((t) => t.target === targetSelect.value);
-        if (first)
-            editor.value = first.sourceFilesJson;
-    };
-    templateSelect.addEventListener('change', () => {
-        const t = templates.find((t) => t.id === templateSelect.value);
-        if (t)
-            editor.value = t.sourceFilesJson;
-    });
-    targetSelect.addEventListener('change', refreshTemplates);
-    const deployBtn = button('Deploy');
-    const draftBtn = button('Deploy draft');
-    const stopBtn = button('Stop');
-    const status = document.createElement('pre');
-    status.className = 'ck-live-coding-status';
-    const meter = document.createElement('div');
-    meter.className = 'ck-live-coding-meter';
-    const controller = new LiveCodingController({
-        ...options,
-        onStatus: (s) => renderStatus(status, meter, s),
-    });
-    const doDeploy = (draft) => void controller
-        .deploy({
-        name: moduleName,
-        target: targetSelect.value,
-        sourceFilesJson: editor.value,
-        draft: draft || options.draftByDefault,
-    })
-        .catch((err) => {
-        status.textContent = `error: ${err.message}`;
-    });
-    deployBtn.addEventListener('click', () => doDeploy(false));
-    draftBtn.addEventListener('click', () => doDeploy(true));
-    stopBtn.addEventListener('click', () => controller.stop());
-    const controls = document.createElement('div');
-    controls.className = 'ck-live-coding-controls';
-    controls.append(targetSelect, templateSelect, deployBtn, draftBtn, stopBtn);
-    root.append(controls, editor, status, meter);
-    el.appendChild(root);
-    refreshTemplates();
-    void controller.refreshUsage().catch(() => { });
-    return {
-        controller,
-        destroy: () => {
-            controller.stop();
-            root.remove();
-        },
-    };
-}
-function button(label) {
-    const b = document.createElement('button');
-    b.type = 'button';
-    b.textContent = label;
-    return b;
-}
-function renderStatus(status, meter, s) {
-    const parts = [`[${s.target}] ${s.phase}`];
-    if (s.message)
-        parts.push(s.message);
-    if (s.compileLog)
-        parts.push('\n' + s.compileLog);
-    status.textContent = parts.join(' ');
-    if (s.usage) {
-        const gate = s.usage.gateStatus === 'active'
-            ? 'active'
-            : `${s.usage.gateStatus}${s.usage.gateReason ? ` (${s.usage.gateReason})` : ''}`;
-        meter.textContent = `units ${s.usage.hourUnitsUsed}/${s.usage.unitsPerHour ?? '∞'} · compiles ${s.usage.compilesThisHour}/${s.usage.maxCompilesPerHour} · gate ${gate}`;
-    }
-}

package/dist/live-coding/templates.d.ts

@@ -1,17 +0,0 @@
-/**
- * Starter templates for the live-coding panel (08 §5). These are minimal,
- * compile-ready single-file mods written against the public host surface —
- * the panel seeds them and games (BWF) supply their own richer set. Each
- * value is the JSON source map playerComputeDeploy expects.
- */
-export interface PlayerCodeTemplate {
-    id: string;
-    title: string;
-    target: 'server' | 'client';
-    description: string;
-    /** JSON string: { "Cargo.toml": "...", "src/lib.rs": "..." } */
-    sourceFilesJson: string;
-}
-export declare const PLAYER_CODE_TEMPLATES: PlayerCodeTemplate[];
-export declare function templateById(id: string): PlayerCodeTemplate | undefined;
-//# sourceMappingURL=templates.d.ts.map

package/dist/live-coding/templates.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/live-coding/templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;CACzB;AAoBD,eAAO,MAAM,qBAAqB,EAAE,kBAAkB,EAiDrD,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEvE"}

package/dist/live-coding/templates.js

@@ -1,59 +0,0 @@
-function cargo(name) {
-    return `[package]
-name = "${name}"
-version = "0.1.0"
-edition = "2021"
-
-[lib]
-crate-type = ["cdylib"]
-
-[dependencies]
-crowdy-compute-sdk = "0.1.5"
-`;
-}
-function src(name, lib) {
-    return JSON.stringify({ 'Cargo.toml': cargo(name), 'src/lib.rs': lib });
-}
-export const PLAYER_CODE_TEMPLATES = [
-    {
-        id: 'server-ticker',
-        title: 'Grid ticker (server)',
-        target: 'server',
-        description: 'A low-rate server tick you can grow into an auto-farm or spawner.',
-        sourceFilesJson: src('grid-ticker', `fn on_init() {}
-fn on_tick(_dt: u32) {
-    // Runs on the server as the grid owner while someone is in the grid.
-    // Read/write only inside your grid; egress is grid-clamped.
-}
-fn on_invoke(_payload: &[u8]) -> Vec<u8> { Vec::new() }
-crowdy_compute_sdk::register_module!(init: on_init, tick: on_tick, invoke: on_invoke);`),
-    },
-    {
-        id: 'server-invoke',
-        title: 'Invoke tool (server)',
-        target: 'server',
-        description: 'A callable export a client tool or automation can invoke as you.',
-        sourceFilesJson: src('invoke-tool', `fn on_init() {}
-fn on_tick(_dt: u32) {}
-fn on_invoke(_payload: &[u8]) -> Vec<u8> {
-    b"{\\"ok\\":true}".to_vec()
-}
-crowdy_compute_sdk::register_module!(init: on_init, tick: on_tick, invoke: on_invoke);`),
-    },
-    {
-        id: 'client-hud',
-        title: 'Grid HUD (client)',
-        target: 'client',
-        description: 'A browser mod that draws a HUD panel for your grid via the presentation hook.',
-        sourceFilesJson: src('grid-hud', `fn on_init() {}
-fn on_tick(_dt: u32) {
-    // Client-side, runs as you in the browser sandbox. Use the hud_set host
-    // call (via the SDK) to render into the game's mod HUD region.
-}
-fn on_invoke(_payload: &[u8]) -> Vec<u8> { Vec::new() }
-crowdy_compute_sdk::register_module!(init: on_init, tick: on_tick, invoke: on_invoke);`),
-    },
-];
-export function templateById(id) {
-    return PLAYER_CODE_TEMPLATES.find((t) => t.id === id);
-}