@crowdedkingdoms/crowdyjs 8.17.0 → 8.19.0

package/dist/live-coding/ide.js

@@ -0,0 +1,399 @@
+import { LiveCodingController, } from './live-coding-controller.js';
+import { mountLiveCoding, } from './mount.js';
+import { PLAYER_CODE_TEMPLATES, } from './templates.js';
+let vscodeServicesPromise = null;
+/**
+ * Lazy Monaco live-coding IDE. Monaco and the language-client stack stay out
+ * of the importing game's hot bundle until this async mount is called.
+ * Missing LSP configuration degrades to the dependency-free textarea panel.
+ */
+export async function mountLiveCodingIDE(el, options) {
+    const token = resolveToken(options.appToken);
+    if (!options.languageServiceUrl || !token) {
+        return mountLiveCoding(el, options);
+    }
+    if (options.editorWorkerFactory) {
+        globalThis.MonacoEnvironment = { getWorker: options.editorWorkerFactory };
+    }
+    try {
+        const [monaco, languageClientModule, wsJsonRpc, vscodeWrapperModule, workerFactoryModule,] = await Promise.all([
+            import('@codingame/monaco-vscode-editor-api'),
+            import('monaco-languageclient'),
+            import('vscode-ws-jsonrpc'),
+            import('monaco-languageclient/vscodeApiWrapper'),
+            import('monaco-languageclient/workerFactory'),
+        ]);
+        if (!vscodeServicesPromise) {
+            const wrapper = new vscodeWrapperModule.MonacoVscodeApiWrapper({
+                $type: 'classic',
+                viewsConfig: { $type: 'EditorService' },
+                userConfiguration: {
+                    json: JSON.stringify({
+                        'workbench.colorTheme': 'Default Dark Modern',
+                        'editor.wordBasedSuggestions': 'off',
+                    }),
+                },
+                monacoWorkerFactory: workerFactoryModule.configureDefaultWorkerFactory,
+            });
+            vscodeServicesPromise = wrapper.start();
+        }
+        await vscodeServicesPromise;
+        monaco.languages.register({ id: 'rust', extensions: ['.rs'] });
+        installRustSyntaxHighlighting(monaco);
+        monaco.languages.register({ id: 'toml', extensions: ['.toml'] });
+        const templates = options.templates ?? PLAYER_CODE_TEMPLATES;
+        const root = document.createElement('div');
+        root.className = 'ck-live-coding ck-live-coding-ide';
+        root.style.cssText =
+            'display:grid;grid-template-rows:auto auto minmax(320px,1fr) auto auto;' +
+                'gap:6px;min-height:520px;';
+        const controls = document.createElement('div');
+        controls.className = 'ck-live-coding-controls';
+        const target = select(['server', 'client']);
+        const template = document.createElement('select');
+        const deploy = button('Deploy');
+        const draft = button('Deploy draft');
+        const stop = button('Stop');
+        controls.append(target, template, deploy, draft, stop);
+        const tabs = document.createElement('div');
+        tabs.className = 'ck-live-coding-tabs';
+        tabs.style.cssText = 'display:flex;gap:4px;flex-wrap:wrap;';
+        const editorHost = document.createElement('div');
+        editorHost.className = 'ck-live-coding-monaco';
+        editorHost.style.cssText = 'min-height:320px;border:1px solid #333;';
+        const problems = document.createElement('div');
+        problems.className = 'ck-live-coding-problems';
+        const status = document.createElement('pre');
+        status.className = 'ck-live-coding-status';
+        const meter = document.createElement('div');
+        meter.className = 'ck-live-coding-meter';
+        root.append(controls, tabs, editorHost, problems, status, meter);
+        el.appendChild(root);
+        const controller = new LiveCodingController({
+            ...options,
+            onStatus: (value) => renderStatus(status, meter, value),
+        });
+        const editor = monaco.editor.create(editorHost, {
+            automaticLayout: true,
+            minimap: { enabled: false },
+            theme: 'vs-dark',
+            fontSize: 14,
+            tabSize: 2,
+        });
+        let models = [];
+        let languageClient = null;
+        let socket = null;
+        let modelRootUri = 'file:///player-mod';
+        const sourceJson = () => JSON.stringify(Object.fromEntries(models.map(({ path, model }) => [path, model.getValue()])));
+        const showModel = (path) => {
+            const found = models.find((entry) => entry.path === path);
+            if (found)
+                editor.setModel(found.model);
+            for (const child of Array.from(tabs.children)) {
+                child.dataset.active =
+                    child.dataset.path === path ? 'true' : 'false';
+            }
+        };
+        const setFiles = (sourceFilesJson) => {
+            for (const entry of models)
+                entry.model.dispose();
+            models = [];
+            tabs.replaceChildren();
+            const files = parseFiles(sourceFilesJson);
+            for (const [path, content] of Object.entries(files)) {
+                const uri = monaco.Uri.parse(`${modelRootUri}/${path}`);
+                const model = monaco.editor.createModel(content, path.endsWith('.rs') ? 'rust' : path.endsWith('.toml') ? 'toml' : 'plaintext', uri);
+                models.push({ path, model });
+                const tab = button(path);
+                tab.dataset.path = path;
+                tab.addEventListener('click', () => showModel(path));
+                tabs.appendChild(tab);
+            }
+            const preferred = models.find((entry) => entry.path === 'src/lib.rs') ?? models[0];
+            if (preferred)
+                showModel(preferred.path);
+        };
+        const refreshTemplates = () => {
+            template.replaceChildren();
+            const matching = templates.filter((item) => item.target === target.value);
+            for (const item of matching) {
+                template.append(new Option(item.title, item.id));
+            }
+            if (matching[0])
+                setFiles(matching[0].sourceFilesJson);
+        };
+        target.addEventListener('change', refreshTemplates);
+        template.addEventListener('change', () => {
+            const selected = templates.find((item) => item.id === template.value);
+            if (selected)
+                setFiles(selected.sourceFilesJson);
+        });
+        const doDeploy = (draftMode) => {
+            void controller
+                .deploy({
+                name: options.moduleName ?? 'scratch-mod',
+                target: target.value,
+                sourceFilesJson: sourceJson(),
+                draft: draftMode || options.draftByDefault,
+            })
+                .catch((error) => {
+                status.textContent = `error: ${error.message}`;
+            });
+        };
+        deploy.addEventListener('click', () => doDeploy(false));
+        draft.addEventListener('click', () => doDeploy(true));
+        stop.addEventListener('click', () => controller.stop());
+        const markerSubscription = monaco.editor.onDidChangeMarkers(() => {
+            const markers = monaco.editor.getModelMarkers({});
+            const errors = markers.filter((marker) => marker.severity === monaco.MarkerSeverity.Error).length;
+            const warnings = markers.filter((marker) => marker.severity === monaco.MarkerSeverity.Warning).length;
+            problems.textContent = `${errors} error(s) · ${warnings} warning(s)`;
+        });
+        refreshTemplates();
+        const authenticated = await authenticatedSocket(options.languageServiceUrl, token, String(options.appId), sourceJson());
+        socket = authenticated.socket;
+        const initialSource = sourceJson();
+        modelRootUri = authenticated.workspaceUri.replace(/\/$/, '');
+        setFiles(initialSource);
+        const adapter = websocketAdapter(socket);
+        const reader = new wsJsonRpc.WebSocketMessageReader(adapter);
+        const writer = new wsJsonRpc.WebSocketMessageWriter(adapter);
+        languageClient = new languageClientModule.MonacoLanguageClient({
+            name: 'Crowdy Rust',
+            clientOptions: {
+                documentSelector: [{ language: 'rust' }, { language: 'toml' }],
+                workspaceFolder: {
+                    uri: monaco.Uri.parse(modelRootUri),
+                    name: 'player-mod',
+                    index: 0,
+                },
+            },
+            messageTransports: { reader, writer },
+        });
+        await languageClient.start();
+        void controller.refreshUsage().catch(() => { });
+        return {
+            controller,
+            destroy: () => {
+                markerSubscription.dispose();
+                controller.stop();
+                void languageClient?.stop().catch(() => { });
+                socket?.close();
+                editor.dispose();
+                for (const entry of models)
+                    entry.model.dispose();
+                root.remove();
+            },
+        };
+    }
+    catch (error) {
+        console.warn('Monaco live-coding IDE unavailable; using textarea fallback', error);
+        el.replaceChildren();
+        return mountLiveCoding(el, options);
+    }
+}
+function installRustSyntaxHighlighting(monaco) {
+    const keywords = new Set([
+        'as',
+        'async',
+        'await',
+        'break',
+        'const',
+        'continue',
+        'crate',
+        'dyn',
+        'else',
+        'enum',
+        'extern',
+        'false',
+        'fn',
+        'for',
+        'if',
+        'impl',
+        'in',
+        'let',
+        'loop',
+        'match',
+        'mod',
+        'move',
+        'mut',
+        'pub',
+        'ref',
+        'return',
+        'self',
+        'static',
+        'struct',
+        'super',
+        'trait',
+        'true',
+        'type',
+        'unsafe',
+        'use',
+        'where',
+        'while',
+    ]);
+    const types = new Set([
+        'Self',
+        'String',
+        'Vec',
+        'Option',
+        'Result',
+        'bool',
+        'char',
+        'str',
+        'usize',
+        'isize',
+        'u8',
+        'u16',
+        'u32',
+        'u64',
+        'u128',
+        'i8',
+        'i16',
+        'i32',
+        'i64',
+        'i128',
+        'f32',
+        'f64',
+    ]);
+    const state = {
+        clone() {
+            return this;
+        },
+        equals(other) {
+            return other === this;
+        },
+    };
+    monaco.languages.setTokensProvider('rust', {
+        getInitialState: () => state,
+        tokenize: (line, currentState) => {
+            const tokens = [];
+            let index = 0;
+            while (index < line.length) {
+                const rest = line.slice(index);
+                let match;
+                if ((match = rest.match(/^\s+/))) {
+                    tokens.push({ startIndex: index, scopes: '' });
+                }
+                else if ((match = rest.match(/^\/\/.*$/))) {
+                    tokens.push({ startIndex: index, scopes: 'comment.rust' });
+                }
+                else if ((match = rest.match(/^\/\*.*?(?:\*\/|$)/))) {
+                    tokens.push({ startIndex: index, scopes: 'comment.rust' });
+                }
+                else if ((match = rest.match(/^"(?:\\.|[^"\\])*"?/))) {
+                    tokens.push({ startIndex: index, scopes: 'string.rust' });
+                }
+                else if ((match = rest.match(/^(?:0x[\da-fA-F_]+|\d[\d_]*)/))) {
+                    tokens.push({ startIndex: index, scopes: 'number.rust' });
+                }
+                else if ((match = rest.match(/^[A-Za-z_]\w*!/))) {
+                    tokens.push({ startIndex: index, scopes: 'macro.rust' });
+                }
+                else if ((match = rest.match(/^[A-Za-z_]\w*/))) {
+                    const word = match[0];
+                    tokens.push({
+                        startIndex: index,
+                        scopes: keywords.has(word)
+                            ? 'keyword.rust'
+                            : types.has(word)
+                                ? 'type.rust'
+                                : 'identifier.rust',
+                    });
+                }
+                else {
+                    match = rest.match(/^./);
+                    tokens.push({ startIndex: index, scopes: 'delimiter.rust' });
+                }
+                index += match?.[0].length ?? 1;
+            }
+            return { tokens, endState: currentState };
+        },
+    });
+}
+function resolveToken(token) {
+    const value = typeof token === 'function' ? token() : token;
+    return value && value.length > 0 ? value : null;
+}
+function parseFiles(sourceFilesJson) {
+    const parsed = JSON.parse(sourceFilesJson);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('sourceFilesJson must be an object');
+    }
+    return Object.fromEntries(Object.entries(parsed).map(([path, value]) => {
+        if (typeof value !== 'string')
+            throw new Error(`Invalid source file ${path}`);
+        return [path, value];
+    }));
+}
+async function authenticatedSocket(url, token, appId, sourceFilesJson) {
+    const socket = new WebSocket(url);
+    let workspaceUri = 'file:///player-mod';
+    await new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error('language service timeout')), 10000);
+        socket.addEventListener('open', () => {
+            socket.send(JSON.stringify({
+                type: 'authenticate',
+                token,
+                appId,
+                sourceFilesJson,
+            }));
+        }, { once: true });
+        socket.addEventListener('message', (event) => {
+            try {
+                const message = JSON.parse(String(event.data));
+                if (message.type !== 'ready' || !message.workspaceUri) {
+                    throw new Error('language service refused session');
+                }
+                workspaceUri = message.workspaceUri;
+                clearTimeout(timeout);
+                resolve();
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                reject(error);
+            }
+        }, { once: true });
+        socket.addEventListener('close', (event) => {
+            clearTimeout(timeout);
+            reject(new Error(event.reason || 'language service closed'));
+        }, { once: true });
+    });
+    return { socket, workspaceUri };
+}
+function websocketAdapter(socket) {
+    return {
+        send: (content) => socket.send(content),
+        onMessage: (callback) => socket.addEventListener('message', (event) => callback(event.data)),
+        onError: (callback) => socket.addEventListener('error', (event) => callback(event)),
+        onClose: (callback) => socket.addEventListener('close', (event) => callback(event.code, event.reason)),
+        dispose: () => socket.close(),
+    };
+}
+function select(values) {
+    const element = document.createElement('select');
+    for (const value of values)
+        element.append(new Option(value, value));
+    return element;
+}
+function button(label) {
+    const element = document.createElement('button');
+    element.type = 'button';
+    element.textContent = label;
+    return element;
+}
+function renderStatus(status, meter, value) {
+    status.textContent = [
+        `[${value.target}] ${value.phase}`,
+        value.message,
+        value.compileLog,
+    ]
+        .filter(Boolean)
+        .join('\n');
+    if (value.usage) {
+        meter.textContent =
+            `units ${value.usage.hourUnitsUsed}/${value.usage.unitsPerHour ?? '∞'} · ` +
+                `compiles ${value.usage.compilesThisHour}/${value.usage.maxCompilesPerHour} · ` +
+                `gate ${value.usage.gateStatus}${value.usage.gateReason ? ` (${value.usage.gateReason})` : ''}`;
+    }
+}

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

@@ -29,6 +29,8 @@ export interface LiveCodingControllerOptions {
     /** Page-side host-call router for the broker (World Stores reads + owner effects). */
     onHostCall: PlayerCodeBrokerOptions['onHostCall'];
     onPresentation?: PlayerCodeBrokerOptions['onPresentation'];
+    /** Client tick cadence (ms); the worker self-drives `tick` for HUD-style mods. */
+    clientTickIntervalMs?: number;
     onStatus?: (status: LiveCodingStatus) => void;
     /** Poll interval for compile status (ms). */
     pollMs?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"live-coding-controller.d.ts","sourceRoot":"","sources":["../../src/live-coding/live-coding-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAC1B,MAAM,yCAAyC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EACD,MAAM,GACN,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,OAAO,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sEAAsE;IACtE,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,IAAI,CACjB,gBAAgB,EAChB,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CACnF,CAAC;IACF,YAAY,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAChD,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,oBAAoB,CAAC;IAC3B,6DAA6D;IAC7D,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;IACxB,sFAAsF;IACtF,UAAU,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAClD,cAAc,CAAC,EAAE,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC9C,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,gBAAgB,CAAC;CACxE;AAED;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAAyD;gBAE1C,OAAO,EAAE,2BAA2B;IAEjE,SAAS,IAAI,gBAAgB;IAI7B,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,KAAK;IAMb,oDAAoD;IAC9C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBnC;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,gBAAgB,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC,IAAI,CAAC;YA6CH,WAAW;YAoBX,SAAS;IA2BvB,IAAI,IAAI,IAAI;CAKb"}
+{"version":3,"file":"live-coding-controller.d.ts","sourceRoot":"","sources":["../../src/live-coding/live-coding-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAC1B,MAAM,yCAAyC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EACD,MAAM,GACN,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,OAAO,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sEAAsE;IACtE,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,IAAI,CACjB,gBAAgB,EAChB,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CACnF,CAAC;IACF,YAAY,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAChD,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,oBAAoB,CAAC;IAC3B,6DAA6D;IAC7D,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;IACxB,sFAAsF;IACtF,UAAU,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAClD,cAAc,CAAC,EAAE,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;IAC3D,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC9C,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,gBAAgB,CAAC;CACxE;AAED;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAAyD;gBAE1C,OAAO,EAAE,2BAA2B;IAEjE,SAAS,IAAI,gBAAgB;IAI7B,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,KAAK;IAMb,oDAAoD;IAC9C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBnC;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,gBAAgB,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC,IAAI,CAAC;YA6CH,WAAW;YAoBX,SAAS;IA4BvB,IAAI,IAAI,IAAI;CAKb"}

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

@@ -119,6 +119,7 @@ export class LiveCodingController {
             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) {

package/dist/player-runtime/glue-runtime.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Factored, environment-agnostic core of the platform glue (player compute
+ * P3/P5). This is the ONLY platform code that shares an execution context
+ * with an untrusted player module, so it is deliberately tiny and auditable
+ * and has NO dependency on worker globals, the DOM, or the SDK client — the
+ * browser worker entry ([player-glue-worker.ts]) and the Node integration
+ * test both drive this same core.
+ *
+ * ABI (matches crowdy-compute-sdk `lib.rs`): the guest imports module `ck`
+ * with `log`, `now_ms`, `state_get`, `state_set`, and the JSON gateway
+ * `host_call(ptr,len) -> u64` (packed `resp_ptr<<32 | resp_len`, guest frees
+ * with `ck_free`), plus `wasi_snapshot_preview1.random_get`. The guest
+ * exports `memory`, `ck_alloc`, `ck_free`, and the module hooks `init`,
+ * `tick(dt_ms)`, `handle_invoke(ptr,len)->u64`, optional `on_event(ptr,len)`.
+ *
+ * `host_call` is SYNCHRONOUS from the guest's view. The single synchronous
+ * dependency this core takes is `hostCallSync(reqBytes) -> respBytes`; the
+ * browser/Node entry realizes it with a SharedArrayBuffer + `Atomics.wait`
+ * (the worker blocks; the page/broker services the async SDK call and writes
+ * the reply back). Everything else here is pure.
+ */
+/** The host-call names surfaced to a guest (mirrors the broker allowlist). */
+export declare const GLUE_HOST_FUNCTIONS: readonly ["container_create", "container_get", "containers_list", "container_delete", "property_set", "model_invoke", "user_state_get", "user_state_set", "grid_state_get", "grid_state_set", "chunk_get", "voxels_list", "actors_list", "actors_list_radius", "voxel_set", "emit_spatial", "hud_set", "overlay_draw", "grid_permission_check"];
+export interface GlueInitMessage {
+    type: 'init';
+    artifact: ArrayBuffer;
+    authority: 'player';
+    fuelPerDispatch?: string;
+    watchdogMs?: number;
+    /** Local client tick cadence in ms (0/undefined => no self-tick). */
+    tickIntervalMs?: number;
+}
+/** Parse the fuel budget the broker forwards; undefined/invalid => unbounded (server still meters). */
+export declare function parseFuelBudget(raw: string | undefined): bigint | null;
+/** A dispatch outcome the worker reports back to the broker. */
+export type GlueDispatchResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'fuel' | 'watchdog' | 'trap';
+    detail?: string;
+};
+/**
+ * Wrap a single guest dispatch with the wall-clock watchdog. The fuel trap is
+ * enforced inside the gas-injected module; this guards against a hang that
+ * spins without consuming fuel. Pure and unit-testable.
+ */
+export declare function runWithWatchdog(dispatch: () => unknown, watchdogMs: number, now?: () => number): Promise<GlueDispatchResult>;
+/** The minimal guest-instance surface the runtime drives (a real WebAssembly.Instance satisfies it). */
+export interface GuestExports {
+    memory: {
+        buffer: ArrayBuffer;
+    };
+    ck_alloc(len: number): number;
+    ck_free?(ptr: number, len: number): void;
+    init?(): void;
+    tick?(dtMs: number): void;
+    handle_invoke?(ptr: number, len: number): bigint | number;
+    on_event?(ptr: number, len: number): void;
+}
+export interface GlueRuntimeOptions {
+    /** Synchronous host-API gateway: JSON request bytes in, SDK Response-envelope bytes out. */
+    hostCallSync: (reqBytes: Uint8Array) => Uint8Array;
+    /** debug/info/warn/error sink for guest `ck.log` (optional). */
+    onLog?: (level: number, message: string) => void;
+    /** Deterministic-enough randomness for the guest `random_get` (defaults to crypto). */
+    randomFill?: (buf: Uint8Array) => void;
+    now?: () => number;
+}
+/**
+ * Drives one untrusted guest module: builds the `ck` + wasi import table,
+ * instantiates the artifact, and marshals the synchronous `host_call`
+ * gateway across guest linear memory. Durable client state is kept in-worker
+ * (a client module's blob is ephemeral per session — the durable store is a
+ * host_call away for anything that must survive).
+ */
+export declare class GlueRuntime {
+    private readonly options;
+    private exports;
+    private stateBlob;
+    constructor(options: GlueRuntimeOptions);
+    /** The import object handed to `WebAssembly.instantiate`. Guest sees only these. */
+    buildImports(getExports: () => GuestExports | null): WebAssembly.Imports;
+    instantiate(artifact: ArrayBuffer): Promise<void>;
+    /** Run the module's `init` export (once, after instantiate). */
+    init(): void;
+    /** Run one `tick(dt_ms)`. Throws propagate to the caller's watchdog wrapper. */
+    tick(dtMs: number): void;
+    /** Invoke the module with an opaque payload; returns the reply bytes (copied out). */
+    invoke(payload: Uint8Array): Uint8Array;
+}
+//# sourceMappingURL=glue-runtime.d.ts.map

package/dist/player-runtime/glue-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glue-runtime.d.ts","sourceRoot":"","sources":["../../src/player-runtime/glue-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,iVAoBtB,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,QAAQ,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQtE;AAED,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,OAAO,EACvB,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,MAAyB,GACnC,OAAO,CAAC,kBAAkB,CAAC,CAe7B;AAED,wGAAwG;AACxG,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1D,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,4FAA4F;IAC5F,YAAY,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,UAAU,CAAC;IACnD,gEAAgE;IAChE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,uFAAuF;IACvF,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAgBD;;;;;;GAMG;AACH,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAiC;gBAErB,OAAO,EAAE,kBAAkB;IAExD,oFAAoF;IACpF,YAAY,CAAC,UAAU,EAAE,MAAM,YAAY,GAAG,IAAI,GAAG,WAAW,CAAC,OAAO;IAkFlE,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,gEAAgE;IAChE,IAAI,IAAI,IAAI;IAIZ,gFAAgF;IAChF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,sFAAsF;IACtF,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU;CAcxC"}