@vibes.diy/prompts 6.1.3 → 6.2.0

package/index.d.ts

@@ -8,3 +8,4 @@ export * from "./themes/index.js";
 export { parseContent } from "./segment-parser.js";
 export { normalizeComponentExports, transformImports, coreImportMap } from "./component-transforms.js";
 export { buildSchemaSystemMessage } from "./build-schema-prompt.js";
+export { allConfigs } from "./llms/index.js";

package/index.js

@@ -8,4 +8,5 @@ export * from "./themes/index.js";
 export { parseContent } from "./segment-parser.js";
 export { normalizeComponentExports, transformImports, coreImportMap } from "./component-transforms.js";
 export { buildSchemaSystemMessage } from "./build-schema-prompt.js";
+export { allConfigs } from "./llms/index.js";
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../jsr/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAEvG,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../jsr/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAEvG,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAIpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/llms/image-gen.md

@@ -2,6 +2,8 @@
 
 Generate and edit images from a text prompt. Each generated image lands as a file ref on the doc — display reads the platform-minted URL via `_files`.
 
+**When to use it:** reach for `<ImgGen>` when a picture adds real value — items whose identity includes an image (cards, creatures, products, covers), user-personalized art (avatars, portraits from a photo), or apps whose whole point is imagery. Most text/data apps (lists, trackers, notes, forms) need **no** images — leave the import unused rather than decorating with gratuitous pictures.
+
 ## Basic Usage
 
 Start with a minimal image generation component:
@@ -51,7 +53,20 @@ export default function App() {
 >>>>>>> REPLACE
 ```
 
-The input image is automatically resized (max 1024px) and compressed as JPEG before sending. img2img is currently supported on `prodia/*` models.
+The input image is automatically resized (max 1024px) and compressed as JPEG before sending.
+
+`images` accepts **either** a raw `File` (fresh from an `<input type="file">`) **or** a stored Fireproof file ref — anything shaped like `{ file: () => Promise<File> }` passes straight through. So if the app has already saved the upload onto a doc, feed it back directly:
+
+```jsx
+// doc was saved earlier with: database.put({ ..., _files: { photo: file } })
+<ImgGen prompt="Turn this pet into a cute cartoon character" images={[doc._files.photo]} _id={doc._id} database={database} />
+```
+
+Do **not** invent wrappers like `images={x?.file ? something : undefined}` — pass the `_files` entry itself. If the stored ref might be absent, gate the whole `<ImgGen>` mount on it instead: `{doc._files?.photo && <ImgGen images={[doc._files.photo]} ... />}`.
+
+**Displaying an img2img result later** (gallery, detail view, reload): render by `_id` and do NOT re-pass `images` — `<ImgGen _id={doc._id} database={database} showControls={false} />` shows the stored version. Passing `images` on a doc that already has one forces a fresh generation instead of displaying the saved result. Generate once with `images`, display forever with `_id` alone.
+
+Do **not** set `model` for img2img: when an input image is present the platform automatically selects its image-**edit** default, which is tuned to produce edits faithful to the source. An explicit `model` override bypasses that routing — only use one when the app has a specific, stated reason.
 
 ## Loading a Specific Doc
 
@@ -142,7 +157,7 @@ Model ids follow the `provider/model-name` form from the platform's model catalo
 #### Props
 
 - `prompt`: text prompt (required unless `_id` is provided)
-- `images`: array of `File` objects for img2img (uses first image)
+- `images`: array of `File` objects **or stored `_files` refs** for img2img (uses first image; only pass while generating — display stored results via `_id`)
 - `_id`: load a specific doc instead of generating
 - `database`: Fireproof db name or instance (default `"ImgGen"`)
 - `className`, `alt`, `style`: standard image styling

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibes.diy/prompts",
-  "version": "6.1.3",
+  "version": "6.2.0",
   "type": "module",
   "main": "./index.js",
   "description": "",
@@ -24,9 +24,9 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@adviser/cement": "~0.5.34",
-    "@vibes.diy/call-ai-v2": "^6.1.3",
-    "@vibes.diy/identity": "^6.1.3",
-    "@vibes.diy/use-vibes-types": "^6.1.3",
+    "@vibes.diy/call-ai-v2": "^6.2.0",
+    "@vibes.diy/identity": "^6.2.0",
+    "@vibes.diy/use-vibes-types": "^6.2.0",
     "arktype": "~2.2.3",
     "json-schema-faker": "~0.6.2"
   },