code-playpad 0.1.3

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+import type { Extension } from '@codemirror/state';
+/** Tabular result — used by SQL-style runtimes. Present from day one so
+ *  adding one later is not a breaking change. */
+export interface Table {
+    columns: string[];
+    rows: unknown[][];
+}
+export interface Result {
+    stdout: string;
+    stderr?: string;
+    /** repr of the last expression, if the snippet ended in one */
+    value?: string;
+    table?: Table;
+    /** Runtime guidance about a failure, in plain language — not program output. */
+    hint?: string;
+    durationMs: number;
+}
+export interface LoadProgress {
+    phase: 'booting' | 'packages' | 'ready';
+    message: string;
+}
+/** name -> contents. Names are relative paths: "utils.py", "pkg/__init__.py",
+ *  "data.csv". Written into the runtime's filesystem before the run. */
+export type Files = Record<string, string>;
+export interface RunOptions {
+    stdin?: string;
+    /** Extra files to place next to the entry point before running. */
+    files?: Files;
+    /** Path the entry code is written to, so tracebacks name a real file. */
+    entry?: string;
+    /** Fires when the job leaves the queue and actually reaches the runtime. */
+    onStart?: () => void;
+    /** Input echoed back as it is consumed, the way a terminal echoes typing.
+     *  Display only — it is not part of the program's stdout. */
+    onEcho?: (text: string) => void;
+    /** Called when the program blocks on input() and the pre-filled lines have
+     *  run out. Resolve with a line, or null for EOF. */
+    onStdinRequest?: () => Promise<string | null>;
+    /** Streamed as the program writes; the full text is also in Result.stdout. */
+    onStdout?: (chunk: string) => void;
+    onStderr?: (chunk: string) => void;
+}
+export interface Runtime {
+    /** stable id used by the registry, e.g. "python" */
+    id: string;
+    /** human label, e.g. "Python 3.14" */
+    label: string;
+    /** CodeMirror language support, loaded on demand */
+    editorLanguage(): Promise<Extension>;
+    load(onProgress?: (p: LoadProgress) => void): Promise<void>;
+    run(code: string, options?: RunOptions): Promise<Result>;
+    /** hard stop: kill the worker and reboot. Optional per the interface. */
+    stop?(): void;
+    /** true once load() has resolved and the runtime is usable */
+    readonly ready: boolean;
+    /** Whether this runtime can block on input() and wait for the page to answer.
+     *  False falls back to consuming pre-filled lines and raising EOFError. */
+    readonly interactiveStdin: boolean;
+}
+/** Thrown when a run is cancelled by stop(). */
+export declare class RunStopped extends Error {
+    constructor(message?: string);
+}
+/** Thrown when the environment refuses to give us a Worker (CSP, etc.). */
+export declare class WorkerUnavailable extends Error {
+    constructor(message?: string);
+}

package/dist/worker-runtime-8Mnw4vAD.js

@@ -0,0 +1,9 @@
+/*!
+ * code-playpad — MIT © 2026 Seung Hun Lee
+ * Bundles CodeMirror 6 and Lezer (MIT) © Marijn Haverbeke and others.
+ * Full third-party licences: THIRD-PARTY-NOTICES.txt in this package.
+ */
+import{c as e,s as t}from"./config-B2qK2rdk.js";var n=1,r=class{#e=null;#t=null;#n=`module`;#r=null;#i=!1;#a=!1;#o=``;#s=new Set;#c=[];#l=null;#u=!1;initPayload(){return{}}get ready(){return this.#i}get interactiveStdin(){return this.#a}get version(){return this.#o}load(t){t&&this.#s.add(t);let n=()=>{t&&this.#s.delete(t)};if(!this.#r){let t=new Promise((t,n)=>{let r;try{if(typeof Worker>`u`)throw Error(`Worker constructor missing`);let e=new Blob([this.source],{type:`text/javascript`});this.#t=URL.createObjectURL(e),r=new Worker(this.#t,{type:this.#n})}catch(t){n(new e(`Could not start a Web Worker: ${t.message}`));return}this.#e=r,r.onmessage=e=>{let r=e.data;if(r.type===`ready`){this.#o=r.version,this.#a=r.interactiveStdin===!0,this.#i=!0,this.#p({phase:`ready`,message:`${this.label} ready`}),t();return}if(r.type===`fatal`&&!this.#i){this.#d(r.message,t,n);return}this.#m(r)},r.onerror=e=>{let r=e.message||`Worker failed to start`;this.#i?this.#l&&this.#g(this.#l,Error(r)):this.#d(r,t,n)},r.postMessage({type:`init`,...this.initPayload()})});this.#r=t,t.catch(()=>{this.#r===t&&(this.#r=null)})}return this.#r.then(n,e=>{throw n(),e})}run(e,t={}){let r,i=new Promise(e=>{r=e});return new Promise((a,o)=>{this.#c.push({id:n++,code:e,options:t,stdout:``,stderr:``,resolve:a,reject:o,done:i,markDone:r}),this.#_()})}stop(){let e=this.#e!==null;this.#f(),this.#l&&this.#g(this.#l,new t),e&&this.load().catch(()=>{})}#d(e,t,n){if(this.#f(),this.#n===`module`){this.#n=`classic`,this.load().then(t,n);return}n(Error(e))}#f(){this.#e?.terminate(),this.#e=null,this.#t&&=(URL.revokeObjectURL(this.#t),null),this.#r=null,this.#i=!1}#p(e){for(let t of this.#s)t(e)}#m(e){if(e.type===`progress`){this.#p({phase:e.phase,message:e.message});return}let t=this.#l;if(!(!t||!(`id`in e)||e.id!==t.id))switch(e.type){case`stdout`:t.stdout+=e.text,t.options.onStdout?.(e.text);break;case`echo`:t.options.onEcho?.(e.text);break;case`stdin-request`:this.#h(t,e.request);break;case`stderr`:t.stderr+=e.text,t.options.onStderr?.(e.text);break;case`result`:t.resolve({stdout:t.stdout,stderr:t.stderr||void 0,value:e.value,durationMs:Math.round(e.durationMs)}),t.markDone();break;case`error`:case`fatal`:{let n=(t.stderr&&!t.stderr.endsWith(`
+`)?`
+`:``)+e.message+`
+`;t.stderr+=n,t.options.onStderr?.(n),t.resolve({stdout:t.stdout,stderr:t.stderr,hint:`hint`in e?e.hint:void 0,durationMs:Math.round(`durationMs`in e?e.durationMs:0)}),t.markDone();break}}}#h(e,t){let n=this.#e,r=r=>{this.#e===n&&this.#l===e&&n?.postMessage({type:`stdin-response`,request:t,text:r})},i=e.options.onStdinRequest;if(!i){r(null);return}i().then(r,()=>r(null))}#g(e,t){e.reject(t),e.markDone()}async#_(){if(!this.#u){this.#u=!0;try{for(;this.#c.length;){let e=this.#c.shift();this.#l=e;try{await this.load(),e.options.onStart?.(),this.#e.postMessage({type:`run`,id:e.id,code:e.code,stdin:e.options.stdin,files:e.options.files,entry:e.options.entry}),await e.done}catch(t){this.#g(e,t)}finally{this.#l=null}}}finally{this.#u=!1}}}};export{r as t};

package/dist/worker-runtime-BZHszOA3.js

@@ -0,0 +1,4 @@
+import{l as e,u as t}from"./element-CJuhuMOP.js";var n=1,r=class{#e=null;#t=null;#n=`module`;#r=null;#i=!1;#a=!1;#o=``;#s=new Set;#c=[];#l=null;#u=!1;initPayload(){return{}}get ready(){return this.#i}get interactiveStdin(){return this.#a}get version(){return this.#o}load(e){e&&this.#s.add(e);let n=()=>{e&&this.#s.delete(e)};if(!this.#r){let e=new Promise((e,n)=>{let r;try{if(typeof Worker>`u`)throw Error(`Worker constructor missing`);let e=new Blob([this.source],{type:`text/javascript`});this.#t=URL.createObjectURL(e),r=new Worker(this.#t,{type:this.#n})}catch(e){n(new t(`Could not start a Web Worker: ${e.message}`));return}this.#e=r,r.onmessage=t=>{let r=t.data;if(r.type===`ready`){this.#o=r.version,this.#a=r.interactiveStdin===!0,this.#i=!0,this.#p({phase:`ready`,message:`${this.label} ready`}),e();return}if(r.type===`fatal`&&!this.#i){this.#d(r.message,e,n);return}this.#m(r)},r.onerror=t=>{let r=t.message||`Worker failed to start`;this.#i?this.#l&&this.#g(this.#l,Error(r)):this.#d(r,e,n)},r.postMessage({type:`init`,...this.initPayload()})});this.#r=e,e.catch(()=>{this.#r===e&&(this.#r=null)})}return this.#r.then(n,e=>{throw n(),e})}run(e,t={}){let r,i=new Promise(e=>{r=e});return new Promise((a,o)=>{this.#c.push({id:n++,code:e,options:t,stdout:``,stderr:``,resolve:a,reject:o,done:i,markDone:r}),this.#_()})}stop(){let t=this.#e!==null;this.#f(),this.#l&&this.#g(this.#l,new e),t&&this.load().catch(()=>{})}#d(e,t,n){if(this.#f(),this.#n===`module`){this.#n=`classic`,this.load().then(t,n);return}n(Error(e))}#f(){this.#e?.terminate(),this.#e=null,this.#t&&=(URL.revokeObjectURL(this.#t),null),this.#r=null,this.#i=!1}#p(e){for(let t of this.#s)t(e)}#m(e){if(e.type===`progress`){this.#p({phase:e.phase,message:e.message});return}let t=this.#l;if(!(!t||!(`id`in e)||e.id!==t.id))switch(e.type){case`stdout`:t.stdout+=e.text,t.options.onStdout?.(e.text);break;case`echo`:t.options.onEcho?.(e.text);break;case`stdin-request`:this.#h(t,e.request);break;case`stderr`:t.stderr+=e.text,t.options.onStderr?.(e.text);break;case`result`:t.resolve({stdout:t.stdout,stderr:t.stderr||void 0,value:e.value,durationMs:Math.round(e.durationMs)}),t.markDone();break;case`error`:case`fatal`:{let n=(t.stderr&&!t.stderr.endsWith(`
+`)?`
+`:``)+e.message+`
+`;t.stderr+=n,t.options.onStderr?.(n),t.resolve({stdout:t.stdout,stderr:t.stderr,hint:`hint`in e?e.hint:void 0,durationMs:Math.round(`durationMs`in e?e.durationMs:0)}),t.markDone();break}}}#h(e,t){let n=this.#e,r=r=>{this.#e===n&&this.#l===e&&n?.postMessage({type:`stdin-response`,request:t,text:r})},i=e.options.onStdinRequest;if(!i){r(null);return}i().then(r,()=>r(null))}#g(e,t){e.reject(t),e.markDone()}async#_(){if(!this.#u){this.#u=!0;try{for(;this.#c.length;){let e=this.#c.shift();this.#l=e;try{await this.load(),e.options.onStart?.(),this.#e.postMessage({type:`run`,id:e.id,code:e.code,stdin:e.options.stdin,files:e.options.files,entry:e.options.entry}),await e.done}catch(t){this.#g(e,t)}finally{this.#l=null}}}finally{this.#u=!1}}}};export{r as t};

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "code-playpad",
+  "version": "0.1.3",
+  "description": "Embeddable browser code playground: a CodeMirror editor that runs Python, JavaScript and TypeScript in the browser. No backend. One shared worker per page, blocking input(), multi-file projects, lazy per-language loading.",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": [
+    "./dist/element.js",
+    "./dist/index.js",
+    "./dist/standalone.js"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "default": "./dist/react.js"
+    },
+    "./element": {
+      "types": "./dist/element.d.ts",
+      "default": "./dist/element.js"
+    },
+    "./standalone": {
+      "types": "./dist/standalone.d.ts",
+      "default": "./dist/standalone.js"
+    }
+  },
+  "scripts": {
+    "dev": "vite --config vite.demo.config.ts",
+    "build": "vite build && vite build --config vite.standalone.config.ts && tsc -p tsconfig.build.json && node scripts/check-dist.mjs",
+    "build:demo": "npm run build && vite build --config vite.demo.config.ts",
+    "preview:demo": "vite preview --config vite.demo.config.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && node scripts/check-dist.mjs --publish"
+  },
+  "peerDependencies": {
+    "@codemirror/autocomplete": "^6",
+    "@codemirror/commands": "^6",
+    "@codemirror/lang-javascript": "^6",
+    "@codemirror/lang-json": "^6",
+    "@codemirror/lang-python": "^6",
+    "@codemirror/language": "^6",
+    "@codemirror/state": "^6",
+    "@codemirror/theme-one-dark": "^6",
+    "@codemirror/view": "^6",
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "@codemirror/lang-javascript": {
+      "optional": true
+    },
+    "@codemirror/lang-json": {
+      "optional": true
+    },
+    "@codemirror/lang-python": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@codemirror/autocomplete": "^6.20.3",
+    "@codemirror/commands": "^6.11.0",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-python": "^6.2.1",
+    "@codemirror/language": "^6.12.4",
+    "@codemirror/state": "^6.7.1",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@codemirror/view": "^6.43.9",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "esbuild": "^0.28.2",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "typescript": "^5.9.3",
+    "vite": "^8.2.2"
+  },
+  "keywords": [
+    "playground",
+    "code-editor",
+    "codemirror",
+    "repl",
+    "web-component",
+    "custom-element",
+    "python",
+    "pyodide",
+    "javascript",
+    "typescript",
+    "wasm",
+    "run-code-in-browser",
+    "education",
+    "sandbox"
+  ],
+  "homepage": "https://code-playpad.swengr.com",
+  "author": "Seung Hun Lee",
+  "unpkg": "./dist/standalone.js",
+  "jsdelivr": "./dist/standalone.js",
+  "engines": {
+    "node": ">=18"
+  }
+}