browser-runtime-solid 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,32 @@
-# Temporary Holding Version
+# browser-runtime-solid
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional Solid JSX compiler and renderer plugin for [`browser-module-runtime`](https://www.npmjs.com/package/browser-module-runtime).
+
+## Install
+
+```sh
+npm install browser-module-runtime@0.0.1 browser-runtime-solid@0.0.1 solid-tag@0.0.3
+```
+
+Solid rendering also needs the Solid DOM runtime available through your host's import map or runtime module configuration.
+
+## Usage
+
+```js
+import {createRuntime} from 'browser-module-runtime';
+import {solid} from 'browser-runtime-solid';
+
+const runtime = createRuntime({plugins: [solid()]});
+runtime.define('/Counter.jsx', `
+  import {createSignal} from 'solid-js';
+  export default function Counter() {
+    const [count,setCount] = createSignal(0);
+    return <button onClick={() => setCount(n => n + 1)}>Count: {count()}</button>;
+  }
+`, {type:'solid-jsx'});
+
+const handle = await runtime.mount({module:'/Counter.jsx', target:'#app'});
+// Later: await handle.dispose(); await runtime.dispose();
+```
+
+This plugin lazily compiles JSX through `solid-tag` and mounts via `@solidjs/web.render`. It handles `type="solid-jsx"`; coherent Solid module identity is the application's responsibility. It is not an alias of `solid-tag-runtime` and does not replace that package's specialized HTML/delegation APIs.

package/index.d.ts

@@ -0,0 +1,2 @@
+import type {RuntimePlugin} from 'browser-module-runtime';
+export declare function solid(options?:Record<string,unknown>):RuntimePlugin;

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "browser-runtime-solid",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./src/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "index.d.ts",
+    "README.md"
+  ],
+  "peerDependenciesMeta": {
+    "solid-tag": {
+      "optional": true
+    },
+    "@solidjs/web": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "browser-module-runtime": "0.0.1",
+    "solid-tag": "0.0.3",
+    "@solidjs/web": "*"
+  },
+  "description": "Solid JSX compiler and renderer adapter for browser-module-runtime.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "browser",
+    "esm",
+    "runtime",
+    "modules",
+    "compiler",
+    "adapter",
+    "solid"
+  ]
+}

package/src/index.d.ts

@@ -0,0 +1 @@
+export * from '../index.js';

package/src/index.js

@@ -0,0 +1,27 @@
+/** Solid is optional. The generic core never imports or loads Solid. */
+export function solid({compiler,render,modules={},version='0.0.3',transformOptions={}}={}) {
+  let transformer=compiler;
+  let renderFunction=render;
+  return {
+    name:'solid',version:String(version),
+    async configure({runtime}) {for(const [id,ns] of Object.entries(modules))runtime.defineModule(id,ns);},
+    compilers:[{
+      types:['solid-jsx'],extensions:['.jsx'],
+      async compile(source,{id}) {
+        transformer ||= await import('solid-tag');
+        if (typeof transformer.compile==='function')return transformer.compile(source,{id});
+        if(typeof transformer.transformModule!=='function')throw new TypeError('solid-tag transformer requires transformModule()');
+        const result=await transformer.transformModule(source,{...transformOptions,injectHtmlImport:true,htmlImportSource:'@solidjs/html'});
+        return {code:result.code,diagnostics:result.diagnostics||[],map:result.sourceMap};
+      }
+    }],
+    renderers:[{
+      name:'solid',types:['solid-jsx'],
+      async mount({component,target,props}) {
+        renderFunction ||= (await import('@solidjs/web')).render;
+        const dispose=renderFunction(()=>component(props),target);
+        return {dispose};
+      }
+    }]
+  };
+}