@vibes.diy/prompts 14.3.46 → 14.3.47

package/llms/image-gen.initial.md

@@ -94,6 +94,33 @@ Do **not** invent wrappers like `images={x?.file ? something : undefined}` — p
 
 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.
 
+## Restyling a Captured Photo
+
+A photo booth, a style camera or an avatar-from-a-selfie app keeps the camera frame on the shot's own record and gives every styled result its own `_id` (bump it to start a fresh attempt). The styled picture's frame is simply `<ImgGen>`, shown at full size: ImgGen paints the saved result when there is one, and otherwise its own progress bar, its own message when a picture needs another try, and — in the Vibes iPhone app — the **Create with Image Playground** button that a picture started by the camera (rather than a tap) waits on. The person sees each of those right in the frame. Your own words about the shot sit beside or below the frame.
+
+Mount that same `<ImgGen>` wherever an unstyled shot is shown in full — the fresh-capture card and the detail view — so a shot saved in one visit styles the next time it opens. Gallery tiles read the saved result through `useImgGen` and show the original until it arrives.
+
+```jsx
+import { ImgGen, useImgGen } from "use-vibes";
+
+function StyledShot({ shot, database }) {
+  const { document: styled } = useImgGen({ _id: shot.styledId, database });
+  const version = styled?.versions?.[styled.currentVersion ?? 0];
+  const ready = Boolean(version?.id && styled?._files?.[version.id]);
+  return (
+    <figure>
+      <div className="aspect-square w-full overflow-hidden rounded-md">
+        {shot._files?.original && (
+          <ImgGen _id={shot.styledId} database={database} prompt={shot.prompt}
+            images={[shot._files.original]} alt={`${shot.style} version`} className="h-full w-full object-contain" />
+        )}
+      </div>
+      <figcaption>{ready ? shot.style : `Styling as ${shot.style}. Your original is saved.`}</figcaption>
+    </figure>
+  );
+}
+```
+
 ## Loading a Specific Doc
 
 Load a previously generated image by `_id` — if the doc has a `prompt` but no `_files` yet, the component generates one: `<ImgGen _id="my-image-id" database={database} />`

package/llms/image-gen.md

@@ -94,6 +94,33 @@ Do **not** invent wrappers like `images={x?.file ? something : undefined}` — p
 
 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.
 
+## Restyling a Captured Photo
+
+A photo booth, a style camera or an avatar-from-a-selfie app keeps the camera frame on the shot's own record and gives every styled result its own `_id` (bump it to start a fresh attempt). The styled picture's frame is simply `<ImgGen>`, shown at full size: ImgGen paints the saved result when there is one, and otherwise its own progress bar, its own message when a picture needs another try, and — in the Vibes iPhone app — the **Create with Image Playground** button that a picture started by the camera (rather than a tap) waits on. The person sees each of those right in the frame. Your own words about the shot sit beside or below the frame.
+
+Mount that same `<ImgGen>` wherever an unstyled shot is shown in full — the fresh-capture card and the detail view — so a shot saved in one visit styles the next time it opens. Gallery tiles read the saved result through `useImgGen` and show the original until it arrives.
+
+```jsx
+import { ImgGen, useImgGen } from "use-vibes";
+
+function StyledShot({ shot, database }) {
+  const { document: styled } = useImgGen({ _id: shot.styledId, database });
+  const version = styled?.versions?.[styled.currentVersion ?? 0];
+  const ready = Boolean(version?.id && styled?._files?.[version.id]);
+  return (
+    <figure>
+      <div className="aspect-square w-full overflow-hidden rounded-md">
+        {shot._files?.original && (
+          <ImgGen _id={shot.styledId} database={database} prompt={shot.prompt}
+            images={[shot._files.original]} alt={`${shot.style} version`} className="h-full w-full object-contain" />
+        )}
+      </div>
+      <figcaption>{ready ? shot.style : `Styling as ${shot.style}. Your original is saved.`}</figcaption>
+    </figure>
+  );
+}
+```
+
 ## Loading a Specific Doc
 
 Load a previously generated image by `_id` — if the doc has a `prompt` but no `_files` yet, the component generates one: `<ImgGen _id="my-image-id" database={database} />`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibes.diy/prompts",
-  "version": "14.3.46",
+  "version": "14.3.47",
   "type": "module",
   "main": "./index.js",
   "exports": {
@@ -37,9 +37,9 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@adviser/cement": "~0.5.34",
-    "@vibes.diy/call-ai-v2": "14.3.46",
-    "@vibes.diy/identity": "14.3.46",
-    "@vibes.diy/use-vibes-types": "14.3.46",
+    "@vibes.diy/call-ai-v2": "14.3.47",
+    "@vibes.diy/identity": "14.3.47",
+    "@vibes.diy/use-vibes-types": "14.3.47",
     "arktype": "~2.2.3",
     "json-schema-faker": "~0.6.3"
   },