@hypit/hypit 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypit/hypit",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "homepage": "https://hypit.ai",
   "repository": {
     "type": "git",

package/packages/gpt-image-kits/README.md

@@ -2,7 +2,8 @@
 
 `phone-ugc-v1` is a data-only Text Template for assembling image prompts. Its
 [source](kits/phone-ugc-v1.svs) emits a fixed iPhone-video capture paragraph, followed by the supplied
-Text slots, with paragraph separators. Import it as `@hypit/gpt-image-kits/phone-ugc-v1`.
+Text slots in `person` → `shot` → `setting` order, with paragraph separators.
+Import it as `@hypit/gpt-image-kits/phone-ugc-v1`.
 
 For creative direction, see the Image direction page in the Hypit Skill.
 
@@ -13,17 +14,20 @@ selecting or authoring another Text Template. The caller supplies the variable d
 
 | Text slot | Required | Content |
 | --- | --- | --- |
-| `shot` | Yes | Camera view, framing, posture, gaze and interaction. |
-| `direction` | Yes | Subject, styling, setting and intended appearance. |
-| `references` | No | What each connected reference supplies or changes. |
+| `person` | No | Person or cast, appearance and styling; identity references and what they preserve. |
+| `shot` | Yes | Camera view, framing, posture, gaze, action and interaction with people or props. |
+| `setting` | No | Surrounding place, palette, structures and objects; scene references and what they preserve. |
 
-Each slot accepts an ordinary Text Output and may contain several paragraphs. The template produces
-Text; the image Surface consumes it. Actual reference Resources and model parameters are connected
-on that Surface.
+For a complete new character-and-scene image, supply all three as ordinary paragraphs. A derived
+view may inherit its person or setting from connected references and omit those slots. Omitted
+blocks add no empty paragraphs. State the necessary reference responsibilities in the slot they
+affect. Each slot accepts an ordinary Text Output and can describe more than one person or relationship.
+The template produces Text; the image Surface consumes it. Actual reference Resources and model
+parameters are connected on that Surface.
 
 ## Assemble the prompt
 
-Given authored Text Outputs `portrait-shot` and `portrait-direction`, this fragment assembles the
+Given authored Text Outputs `portrait-person`, `portrait-shot` and `portrait-setting`, this fragment assembles the
 prompt and passes it to `gpt:Image`:
 
 ```svml
@@ -32,13 +36,14 @@ prompt and passes it to `gpt:Image`:
 <import as="ugc" source="@hypit/gpt-image-kits/phone-ugc-v1"/>
 
 <text:Render id="portrait-prompt" template={ugc.phone-ugc-v1}>
+  <text:Set name="person" text={portrait-person}/>
   <text:Set name="shot" text={portrait-shot}/>
-  <text:Set name="direction" text={portrait-direction}/>
+  <text:Set name="setting" text={portrait-setting}/>
 </text:Render>
 
 <gpt:Image id="portrait" prompt={portrait-prompt} aspect-ratio="9:16" resolution="2K"/>
 ```
 
-To explain reference inputs, add a `text:Set` named `references` to the Render. Connect those same
-images through `gpt:Reference` children on `gpt:Image`. Omit the optional Set when no reference
-direction is needed. The Text does not create Resource bindings.
+Connect reference images through `gpt:Reference` children on `gpt:Image` in the order described by
+the prompt. For example, a `person` paragraph can inherit identity from reference 1 while `shot`
+describes holding the product from reference 2. The Text does not create Resource bindings.

package/packages/gpt-image-kits/kits/phone-ugc-v1.svs

@@ -8,27 +8,27 @@
   text-template.phone-ugc-v1.block.capture {
     kind: fixed;
     order: 10;
-    text: "A photograph with the texture of real iPhone footage, captured as a single frame from a video actually shot on an iPhone. The image looks real, without an oily, overprocessed finish, and has the texture of video footage. The background is clearly visible, with no depth-of-field blur. Skin texture is natural and fine, the lighting is natural, and the image is coherent and free of visual artifacts.";
+    text: "A photograph captured as a single frame from a video actually shot on an iPhone, with the texture of real iPhone footage. The image looks real, without an oily, overprocessed finish. The background is clearly visible, with no depth-of-field blur. Skin texture is natural and fine, and the lighting is natural. The image is coherent and free of visual artifacts.";
   }
 
-  text-template.phone-ugc-v1.block.shot {
+  text-template.phone-ugc-v1.block.person {
     kind: slot;
     order: 20;
-    slot: shot;
-    optional: false;
+    slot: person;
+    optional: true;
   }
 
-  text-template.phone-ugc-v1.block.direction {
+  text-template.phone-ugc-v1.block.shot {
     kind: slot;
     order: 30;
-    slot: direction;
+    slot: shot;
     optional: false;
   }
 
-  text-template.phone-ugc-v1.block.references {
+  text-template.phone-ugc-v1.block.setting {
     kind: slot;
     order: 40;
-    slot: references;
+    slot: setting;
     optional: true;
   }
 </sheet>