@runtypelabs/persona 3.27.0 → 3.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/persona",
-  "version": "3.27.0",
+  "version": "3.28.0",
   "description": "Themeable, pluggable streaming agent widget for websites, in plain JS with support for voice input and reasoning / tool output.",
   "type": "module",
   "main": "dist/index.cjs",
@@ -17,6 +17,11 @@
       "import": "./dist/theme-reference.js",
       "require": "./dist/theme-reference.cjs"
     },
+    "./codegen": {
+      "types": "./dist/codegen.d.ts",
+      "import": "./dist/codegen.js",
+      "require": "./dist/codegen.cjs"
+    },
     "./theme-editor": {
       "types": "./dist/theme-editor.d.ts",
       "import": "./dist/theme-editor.js",
@@ -99,12 +104,13 @@
     "access": "public"
   },
   "scripts": {
-    "build": "rimraf dist && pnpm run build:styles && pnpm run build:client && pnpm run build:installer && pnpm run build:launcher && pnpm run build:theme-ref && pnpm run build:theme-editor && pnpm run build:testing && pnpm run build:smart-dom-reader && pnpm run build:animations",
+    "build": "rimraf dist && pnpm run build:styles && pnpm run build:client && pnpm run build:installer && pnpm run build:launcher && pnpm run build:theme-ref && pnpm run build:codegen && pnpm run build:theme-editor && pnpm run build:testing && pnpm run build:smart-dom-reader && pnpm run build:animations",
     "build:theme-editor": "tsup src/theme-editor.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting",
     "build:testing": "tsup src/testing.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting",
     "build:smart-dom-reader": "tsup src/smart-dom-reader.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting",
     "build:animations": "tsup src/animations/glyph-cycle.ts src/animations/wipe.ts --format esm,cjs --minify --dts --out-dir dist/animations --no-splitting",
     "build:theme-ref": "tsup src/theme-reference.ts --format esm,cjs --minify --dts",
+    "build:codegen": "tsup src/codegen.ts --format esm,cjs --minify --dts",
     "build:styles": "node -e \"const fs=require('fs');fs.mkdirSync('dist',{recursive:true});fs.copyFileSync('src/styles/widget.css','dist/widget.css');\"",
     "build:client": "tsup src/index.ts --format esm,cjs --minify --sourcemap --splitting false --dts --loader \".css=text\" && tsup src/index-global.ts --format iife --global-name AgentWidget --minify --sourcemap --splitting false --out-dir dist --loader \".css=text\" && node -e \"const fs=require('fs');for(const ext of ['.global.js','.global.js.map']){const from='dist/index-global'+ext;if(fs.existsSync(from))fs.renameSync(from,'dist/index'+ext);}\"",
     "build:installer": "tsup src/install.ts --format iife --global-name SiteAgentInstaller --out-dir dist --minify --sourcemap --no-splitting",

package/src/codegen.test.ts

@@ -0,0 +1,39 @@
+import { describe, it, expect } from "vitest";
+import { generateCodeSnippet as fromSubpath } from "./codegen";
+import { generateCodeSnippet as fromInternal } from "./utils/code-generators";
+import { VERSION } from "./version";
+
+// The `@runtypelabs/persona/codegen` subpath is the server/Worker-safe entry for
+// snippet generation. It must expose the exact same generator as the internal
+// module (and, transitively, the main barrel) — no fork, no drift.
+describe("codegen subpath", () => {
+  const config = {
+    apiUrl: "https://api.example.com/chat",
+    clientToken: "ct_test_123",
+    launcher: { enabled: true, title: "Chat" },
+  };
+
+  it("re-exports the same generateCodeSnippet implementation", () => {
+    expect(fromSubpath).toBe(fromInternal);
+  });
+
+  it("produces identical output via the subpath for every format", () => {
+    const formats = [
+      "esm",
+      "script-installer",
+      "script-manual",
+      "script-advanced",
+      "react-component",
+      "react-advanced",
+    ] as const;
+    for (const format of formats) {
+      expect(fromSubpath(config, format)).toBe(fromInternal(config, format));
+    }
+  });
+
+  it("pins the installer CDN url to the package version (not @latest)", () => {
+    const code = fromSubpath(config, "script-installer");
+    expect(code).toContain(`@runtypelabs/persona@${VERSION}/dist/install.global.js`);
+    expect(code).not.toContain("@latest");
+  });
+});

package/src/codegen.ts

@@ -0,0 +1,20 @@
+/**
+ * Pure code-snippet generation entry (`@runtypelabs/persona/codegen`).
+ *
+ * `generateCodeSnippet` is pure string-templating — it builds install snippets
+ * from a widget config and depends only on a type import + the `VERSION`
+ * constant. The main `index.ts` barrel re-exports it too, but that barrel pulls
+ * in the full widget runtime (`index-core` → idiomorph / marked / DOM), which is
+ * unacceptable for server/Worker consumers that only need snippet strings.
+ *
+ * This subpath exposes the generator on its own (mirroring `theme-reference`) so
+ * those consumers import it without dragging in the browser runtime. Existing
+ * npm consumers keep using the barrel export unchanged.
+ */
+
+export { generateCodeSnippet } from "./utils/code-generators";
+export type {
+  CodeFormat,
+  CodeGeneratorHooks,
+  CodeGeneratorOptions
+} from "./utils/code-generators";