@nevescloud/pip 2.11.2 → 3.1.0

package/README.md

@@ -20,6 +20,30 @@ const pip = createPip({
 
 Or via npm: `npm install @nevescloud/pip`.
 
+### Quickstart: bundle entries
+
+Provider-named bundles re-export the three primitives most hosts compose, from a single import. Pick the brain you're wiring to:
+
+```js
+// Anthropic — Claude on /v1/messages
+import { createPip, createRuntime, anthropic } from 'https://cdn.jsdelivr.net/npm/@nevescloud/pip@latest/bundle/anthropic';
+
+const rt = createRuntime({ provider: anthropic({ model: 'claude-opus-4-7', apiKey: '…' }) });
+const pip = createPip({ onSubmit: rt.onSubmit, onSlash: rt.onSlash, slashSource: rt.slashSource });
+```
+
+```js
+// OpenAI-compatible — OpenAI, GitHub Models, Together, Groq, OpenRouter, LM Studio, llama.cpp
+import { createPip, createRuntime, openai } from 'https://cdn.jsdelivr.net/npm/@nevescloud/pip@latest/bundle/openai';
+```
+
+```js
+// Local — in-browser inference via transformers.js + WebGPU (different shape: no runtime, renderer is host-driven)
+import { createPip, createTransformersRenderer } from 'https://cdn.jsdelivr.net/npm/@nevescloud/pip@latest/bundle/local';
+```
+
+`pip/bundle` (no provider segment) is an alias for `pip/bundle/anthropic` — the default when you haven't picked a brain. Bundles are sugar over the layered files; hosts with a different brain shape (UI only, custom provider, in-browser model) import the granular files directly. See [CONSUMERS.md](../../CONSUMERS.md) for the full entry-point list.
+
 ## Options
 
 | Key | Default | Notes |

package/bundle/anthropic.esm.js

@@ -0,0 +1,8 @@
+// Quickstart entry — pip wired to Anthropic in one import.
+// Re-exports the three primitives most Anthropic hosts wire together.
+// Layered files stay public; hosts that need a different brain shape
+// import from pip-core / runtime / providers directly.
+
+export { createPip } from '../pip-core.esm.js';
+export { createRuntime } from '../runtime.esm.js';
+export { anthropic } from '../providers/anthropic.esm.js';

package/bundle/local.esm.js

@@ -0,0 +1,9 @@
+// Quickstart entry — pip wired to an in-browser model in one import.
+// Re-exports the two primitives most local-renderer hosts compose.
+// Different shape from bundle/anthropic and bundle/openai: there's no
+// runtime here — the renderer is host-driven (one-shot generate),
+// not part of the turn loop. Consumers shouldn't need to know which
+// underlying library powers the renderer; that's why this entry exists.
+
+export { createPip } from '../pip-core.esm.js';
+export { createTransformersRenderer, splitThinking } from '../providers/local.esm.js';

package/bundle/openai.esm.js

@@ -0,0 +1,8 @@
+// Quickstart entry — pip wired to any OpenAI-compatible host in one import.
+// Re-exports the three primitives. Works with OpenAI direct, GitHub Models,
+// Together, Groq, OpenRouter, LM Studio, llama.cpp — anything speaking
+// /chat/completions. Pass baseUrl to switch hosts.
+
+export { createPip } from '../pip-core.esm.js';
+export { createRuntime } from '../runtime.esm.js';
+export { openai } from '../providers/openai.esm.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nevescloud/pip",
-  "version": "2.11.2",
+  "version": "3.1.0",
   "description": "Floating assistant bubble + panel + chat runtime. ESM, no build.",
   "type": "module",
   "main": "pip-core.esm.js",
@@ -8,13 +8,21 @@
     ".": "./pip-core.esm.js",
     "./pip-core.esm.js": "./pip-core.esm.js",
     "./runtime.esm.js": "./runtime.esm.js",
+    "./bundle": "./bundle/anthropic.esm.js",
+    "./bundle/anthropic": "./bundle/anthropic.esm.js",
+    "./bundle/anthropic.esm.js": "./bundle/anthropic.esm.js",
+    "./bundle/openai": "./bundle/openai.esm.js",
+    "./bundle/openai.esm.js": "./bundle/openai.esm.js",
+    "./bundle/local": "./bundle/local.esm.js",
+    "./bundle/local.esm.js": "./bundle/local.esm.js",
     "./providers/anthropic.esm.js": "./providers/anthropic.esm.js",
     "./providers/openai.esm.js": "./providers/openai.esm.js",
-    "./providers/transformers.esm.js": "./providers/transformers.esm.js"
+    "./providers/local.esm.js": "./providers/local.esm.js"
   },
   "files": [
     "pip-core.esm.js",
     "runtime.esm.js",
+    "bundle/",
     "providers/",
     "README.md",
     "LICENSE"

package/providers/{transformers.esm.js → local.esm.js}

@@ -6,7 +6,7 @@
 //
 // Usage:
 //   import { createTransformersRenderer } from
-//     '@nevescloud/pip/providers/transformers.esm.js';
+//     '@nevescloud/pip/providers/local.esm.js';
 //
 //   const renderer = createTransformersRenderer();
 //   renderer.setModel({