renderify 0.1.0 → 0.3.0

package/README.md

@@ -39,6 +39,93 @@ console.log(result.html);
 await app.stop();
 ```
 
+## Renderer-only (BYO LLM/Backend)
+
+You do not need to use the built-in LLM providers. A common integration is to generate RuntimePlan externally and only use `renderify` for execution/rendering:
+
+```ts
+import { renderPlanInBrowser, renderPlanOnce } from "renderify";
+
+const plan = {
+  specVersion: "runtime-plan/v1",
+  id: "renderer_only",
+  version: 1,
+  root: {
+    type: "element",
+    tag: "section",
+    children: [{ type: "text", value: "Hello from external plan" }],
+  },
+  capabilities: { domWrite: true },
+};
+
+// Browser mount
+await renderPlanInBrowser(plan, { target: "#app" });
+
+// Optional one-shot execution in app orchestration flow
+const result = await renderPlanOnce(plan);
+console.log(result.html);
+```
+
+### Renderer-only TSX + Dependency Package (JSPM)
+
+`renderPlanInBrowser` defaults to `auto-pin-latest`, so bare imports work out of the box:
+
+```ts
+import { renderPlanInBrowser } from "renderify";
+
+const tsxPlan = {
+  specVersion: "runtime-plan/v1",
+  id: "renderer_only_tsx_datefns",
+  version: 1,
+  capabilities: { domWrite: true },
+  root: {
+    type: "element",
+    tag: "div",
+    children: [{ type: "text", value: "Loading..." }],
+  },
+  source: {
+    language: "tsx",
+    runtime: "renderify",
+    code: `
+      import { format } from "date-fns/format";
+
+      export default function App() {
+        return <section>Today: {format(new Date(), "yyyy-MM-dd")}</section>;
+      }
+    `,
+  },
+};
+
+await renderPlanInBrowser(tsxPlan, { target: "#app" });
+```
+
+For production determinism, prefer `manifest-only` (explicit pinned versions) and disable auto-pin:
+
+```ts
+const pinnedPlan = {
+  ...tsxPlan,
+  moduleManifest: {
+    "date-fns/format": {
+      resolvedUrl: "https://ga.jspm.io/npm:date-fns@4.1.0/format.js",
+      version: "4.1.0",
+    },
+  },
+};
+
+await renderPlanInBrowser(pinnedPlan, {
+  target: "#app",
+  autoPinLatestModuleManifest: false,
+});
+```
+
+Auto-pin-latest workflow (`renderPlanInBrowser` default):
+
+1. Write bare imports for DX, for example `import { format } from "date-fns/format"`.
+2. On first run, Renderify resolves the bare specifier via JSPM latest metadata.
+3. Renderify immediately pins and injects the exact resolved URL/version into `moduleManifest`, then executes with pinned resolution.
+
+Use `manifest-only` in production (`autoPinLatestModuleManifest: false`) when you want fully pre-pinned, reviewable dependency mappings.
+
 ## One-shot Prompt Rendering
 
 ```ts
@@ -67,5 +154,6 @@ console.log(result.html);
 
 ## Notes
 
+- Default browser embedding behavior is `auto-pin-latest` for bare source imports; use `manifest-only` for production-grade deterministic deployments.
 - Node.js `>=22` is required.
 - For advanced split-package usage, you can still import `@renderify/core`, `@renderify/runtime`, `@renderify/security`, `@renderify/llm`, and `@renderify/ir` directly.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "renderify",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Official Renderify SDK facade",
   "main": "dist/renderify.cjs.js",
   "types": "dist/renderify.d.ts",
@@ -45,11 +45,11 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@renderify/core": "^0.1.0",
-    "@renderify/ir": "^0.1.0",
-    "@renderify/llm": "^0.1.0",
-    "@renderify/runtime": "^0.1.0",
-    "@renderify/security": "^0.1.0"
+    "@renderify/core": "^0.3.0",
+    "@renderify/ir": "^0.3.0",
+    "@renderify/llm": "^0.3.0",
+    "@renderify/runtime": "^0.3.0",
+    "@renderify/security": "^0.3.0"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",