@nevescloud/pip 2.11.1 → 3.0.0

package/README.md

@@ -20,6 +20,25 @@ 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';
+```
+
+`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/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.1",
+  "version": "3.0.0",
   "description": "Floating assistant bubble + panel + chat runtime. ESM, no build.",
   "type": "module",
   "main": "pip-core.esm.js",
@@ -8,13 +8,19 @@
     ".": "./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",
     "./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/pip-core.esm.js

@@ -154,12 +154,14 @@ const CSS = `
   overflow: visible;
   margin: 0;
   padding: 14px;
-  /* color-scheme inherits from the host page. Don't force "light dark"
-     here — that overrides a light-mode host whose user is on a dark OS,
-     painting pip dark while the surrounding page is light (and
-     defeating any --pip-* variables a host did set but happens to leave
-     a fallback unmapped, e.g. --pip-input-bg). Hosts that want pip to
-     follow OS preference set color-scheme on body. */
+  /* Force light as the default scheme for pip's chrome. The fallbacks
+     below use light-dark(); without an explicit value here CSS treats
+     the element as "normal", which lets the browser pick the dark
+     branch based on the visitor's OS preference — painting pip dark
+     even when the host page is rendering light. Hosts that want dark
+     pip set --pip-* variables explicitly or override color-scheme to
+     dark on this rule. */
+  color-scheme: light;
   border: 1px solid var(--pip-border, light-dark(rgba(0,0,0,0.10), rgba(255,255,255,0.12)));
   border-radius: 14px;
   background: var(--pip-surface, light-dark(#fff, #212529));

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({