cineprompt 1.1.0 → 1.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 CLI tool for building structured AI video prompts and share links via [cineprompt.io](https://cineprompt.io).
 
-Turn shot descriptions into optimized prompts for Sora, Runway, Kling, Veo, Seedance, WAN, Grok Imagine, LTX, and other AI video generators.
+Turn shot descriptions into optimized prompts for Kling, Seedance, Grok Imagine, Pixverse, LTX, Runway, Veo, WAN, and other AI video generators.
 
 ## Install
 
@@ -53,7 +53,7 @@ cat shot.json | cineprompt build
 ### Browse available fields
 
 ```bash
-# List all 133 fields
+# List all 130 fields
 cineprompt fields
 
 # Show valid values for a specific field
@@ -110,13 +110,13 @@ cineprompt fields media_type
 
 ### Field types
 
-- **Button fields** (93) accept exact string values (use `cineprompt fields <name>` to see options)
+- **Button fields** accept exact string values (use `cineprompt fields <name>` to see options)
 - **Array fields** accept multiple values: `"media_type": ["cinematic", "documentary"]`
-- **Text fields** (40) accept any string: `"subject_description": "whatever you want"`
+- **Text fields** accept any string: `"subject_description": "whatever you want"`
 
 ## Modes
 
-**Single Shot** — full cinematography control over one shot. 133 fields across subject, camera, lighting, color, environment, and sound.
+**Single Shot** — full cinematography control over one shot. 130 fields across subject, camera, lighting, color, environment, and sound.
 
 **Multi-Shot** — sequence of shots with global settings + per-shot overrides. Recurring characters, 28 transition types.
 

package/data/field-values.json

@@ -179,7 +179,7 @@
     "shot on Panasonic GH5",
     "shot on Blackmagic Pocket Cinema Camera 6K",
     "shot on IMAX 65mm",
-    "shot on \u00c9clair NPR 16mm",
+    "shot on Éclair NPR 16mm",
     "shot on Canon 814 XL-S Super 8",
     "shot on Kodak Brownie 8mm",
     "shot on Canon Scoopic 16mm",
@@ -332,6 +332,67 @@
     "bark-like, wooden",
     "shadowy, made of darkness"
   ],
+  "creature_subtype": [
+    "wolf",
+    "lion",
+    "tiger",
+    "bear",
+    "deer",
+    "elephant",
+    "fox",
+    "leopard",
+    "bison",
+    "gorilla",
+    "rhino",
+    "hippo",
+    "moose",
+    "cheetah",
+    "dog",
+    "cat",
+    "horse",
+    "cow",
+    "sheep",
+    "pig",
+    "chicken",
+    "rabbit",
+    "eagle",
+    "owl",
+    "songbird",
+    "parrot",
+    "penguin",
+    "swan",
+    "crow",
+    "flamingo",
+    "hummingbird",
+    "peacock",
+    "dove",
+    "falcon",
+    "heron",
+    "pelican",
+    "whale",
+    "shark",
+    "dolphin",
+    "octopus",
+    "sea turtle",
+    "jellyfish",
+    "tropical fish",
+    "seal",
+    "butterfly",
+    "bee",
+    "ant",
+    "spider",
+    "beetle",
+    "dragonfly",
+    "grasshopper",
+    "scorpion",
+    "snake",
+    "lizard",
+    "crocodile",
+    "tortoise",
+    "chameleon",
+    "komodo dragon",
+    "frog"
+  ],
   "custom_location": [],
   "delivery_style": [
     "spoken softly, whispered",
@@ -362,7 +423,6 @@
   ],
   "delivery_style_custom": [],
   "dialogue": [],
-  "dialogue_character": [],
   "dialogue_language": [],
   "documentary_style": [
     "nature documentary",
@@ -370,7 +430,7 @@
     "true crime documentary",
     "historical documentary",
     "observational documentary",
-    "cin\u00e9ma v\u00e9rit\u00e9 documentary",
+    "cinéma vérité documentary",
     "biographical documentary",
     "social political documentary",
     "science documentary",
@@ -429,40 +489,6 @@
     "Lomography Color 400 film, saturated unpredictable colors",
     "expired film stock, color shifted unpredictable faded"
   ],
-  "fm_chips_camera": [
-    "Slow push in",
-    "Slow pull out",
-    "Orbit",
-    "Dolly",
-    "Crane up",
-    "Crane down",
-    "Handheld",
-    "Tracking shot",
-    "Locked off"
-  ],
-  "fm_chips_direction": [
-    "Slow Build",
-    "One at a Time",
-    "Breathe",
-    "Anchor",
-    "Physics",
-    "Chaos",
-    "Match"
-  ],
-  "fm_chips_pacing": [
-    "Slow motion",
-    "Real-time",
-    "Time-lapse",
-    "Hyperlapse"
-  ],
-  "fm_chips_transition": [
-    "Whip pan",
-    "Steadicam",
-    "Rack focus",
-    "Reveal",
-    "Morph",
-    "Dissolve"
-  ],
   "focal_length": [
     "8mm fisheye lens",
     "12mm lens",
@@ -622,6 +648,11 @@
     "reaction to environment",
     "transformation"
   ],
+  "isolation": [
+    "isolated on a clean white studio background, white cyclorama, no shadows",
+    "isolated on a pure black background, void, no reflections",
+    "isolated on a bright green screen background, chroma key, evenly lit"
+  ],
   "key_light": [],
   "land_scale": [
     "intimate, small detail",
@@ -629,14 +660,6 @@
     "vast panoramic landscape",
     "infinite horizon, endless expanse"
   ],
-  "land_season": [
-    "spring, fresh green",
-    "summer, lush and warm",
-    "autumn, golden leaves",
-    "winter, cold and bare",
-    "dry season, arid",
-    "monsoon, heavy rain"
-  ],
   "lens_brand": [
     "ARRI Master Prime",
     "ARRI Signature Prime",
@@ -736,7 +759,7 @@
     "prison cell",
     "bar",
     "nightclub",
-    "caf\u00e9",
+    "café",
     "restaurant",
     "diner",
     "hotel lobby",
@@ -969,7 +992,7 @@
     "shot on Panasonic GH5",
     "shot on Blackmagic Pocket Cinema Camera 6K",
     "shot on IMAX 65mm",
-    "shot on \u00c9clair NPR 16mm",
+    "shot on Éclair NPR 16mm",
     "shot on Canon 814 XL-S Super 8",
     "shot on Kodak Brownie 8mm",
     "shot on Canon Scoopic 16mm",
@@ -1042,7 +1065,7 @@
     "true crime documentary",
     "historical documentary",
     "observational documentary",
-    "cin\u00e9ma v\u00e9rit\u00e9 documentary",
+    "cinéma vérité documentary",
     "biographical documentary",
     "social political documentary",
     "science documentary",
@@ -1506,6 +1529,81 @@
     "military",
     "racing"
   ],
+  "veh_subtype": [
+    "sports car",
+    "sedan",
+    "SUV",
+    "race car",
+    "hot rod",
+    "taxi",
+    "police car",
+    "convertible",
+    "sport bike",
+    "cruiser motorcycle",
+    "chopper",
+    "cafe racer",
+    "dirt bike",
+    "scooter",
+    "touring motorcycle",
+    "bobber motorcycle",
+    "pickup truck",
+    "semi truck",
+    "delivery truck",
+    "fire truck",
+    "military truck",
+    "monster truck",
+    "dump truck",
+    "tow truck",
+    "sailboat",
+    "speedboat",
+    "fishing boat",
+    "canoe",
+    "rowboat",
+    "pontoon boat",
+    "tugboat",
+    "raft",
+    "cruise ship",
+    "cargo ship",
+    "warship",
+    "pirate ship",
+    "tanker ship",
+    "aircraft carrier",
+    "submarine",
+    "commercial airliner",
+    "private jet",
+    "fighter jet",
+    "biplane",
+    "seaplane",
+    "cargo plane",
+    "bomber aircraft",
+    "propeller plane",
+    "military helicopter",
+    "medical helicopter",
+    "police helicopter",
+    "news helicopter",
+    "transport helicopter",
+    "tour helicopter",
+    "steam locomotive",
+    "bullet train",
+    "diesel train",
+    "subway train",
+    "freight train",
+    "trolley",
+    "monorail",
+    "road bike",
+    "mountain bike",
+    "BMX bike",
+    "cruiser bike",
+    "e-bike",
+    "tricycle",
+    "rocket",
+    "space shuttle",
+    "space station",
+    "fighter spacecraft",
+    "colony ship",
+    "space probe",
+    "landing module"
+  ],
   "veh_type": [
     "car",
     "motorcycle",
@@ -1534,4 +1632,4 @@
     "smoke drifting through scene",
     "humid, tropical heat"
   ]
-}
+}

package/lib/prompt-builder.js

@@ -14,7 +14,7 @@ function nlJoin(arr) {
 // Section ordering (Universal model default)
 const SECTION_ORDER = [
   { section: 'STYLE', fields: ['media_type', 'commercial_type', 'documentary_style', 'animation_style', 'music_video_style', 'social_media_style', 'genre', 'tone', 'format'] },
-  { section: 'SUBJECT', fields: ['char_label', 'age_range', 'build', 'hair_style', 'hair_color', 'subject_description', 'wardrobe', 'expression', 'body_language', 'framing', 'creature_category', 'creature_label', 'creature_size', 'creature_body', 'creature_skin', 'creature_description', 'creature_expression', 'creature_framing', 'obj_description', 'obj_material', 'obj_condition', 'obj_scale', 'prod_description', 'prod_material', 'prod_staging', 'prod_condition', 'food_description', 'food_state', 'food_presentation', 'food_texture', 'cloth_description', 'cloth_fabric', 'cloth_presentation', 'cloth_fit', 'art_description', 'art_medium', 'art_setting', 'art_condition', 'botan_description', 'botan_type', 'botan_stage', 'botan_detail', 'veh_type', 'veh_description', 'veh_era', 'veh_condition', 'land_season', 'land_scale', 'abs_description', 'abs_quality', 'abs_movement'] },
+  { section: 'SUBJECT', fields: ['char_label', 'age_range', 'build', 'hair_style', 'hair_color', 'subject_description', 'wardrobe', 'expression', 'body_language', 'framing', 'creature_category', 'creature_subtype', 'creature_label', 'creature_size', 'creature_body', 'creature_skin', 'creature_description', 'creature_expression', 'obj_description', 'obj_material', 'obj_condition', 'obj_scale', 'prod_description', 'prod_material', 'prod_staging', 'prod_condition', 'food_description', 'food_state', 'food_presentation', 'food_texture', 'cloth_description', 'cloth_fabric', 'cloth_presentation', 'cloth_fit', 'art_description', 'art_medium', 'art_setting', 'art_condition', 'botan_description', 'botan_type', 'botan_stage', 'botan_detail', 'veh_type', 'veh_subtype', 'veh_description', 'veh_era', 'veh_condition', 'land_scale', 'abs_description', 'abs_quality', 'abs_movement'] },
   { section: 'ACTIONS', fields: ['movement_type', 'pacing', 'interaction_type', 'action_primary', 'beat_1', 'beat_2', 'beat_3'] },
   { section: 'ENVIRONMENT', fields: ['setting', 'isolation', 'location_type', 'abstract_environment', 'custom_location', 'location', 'env_time', 'weather', 'props', 'env_fg', 'env_mg', 'env_bg'] },
   { section: 'CINEMATOGRAPHY', fields: ['shot_type', 'movement', 'camera_body', 'focal_length', 'lens_brand', 'lens_filter', 'dof', 'lighting_style', 'lighting_type', 'key_light', 'fill_light'] },
@@ -93,6 +93,9 @@ function buildMergeRules(fields) {
       if (c && l) return `${c}, ${l}`;
       return c || l;
     }},
+    'veh_type': { mergeWith: 'veh_subtype', fn: (type, subtype) => {
+      return subtype || type || null;
+    }},
     'music_genre': { mergeWith: 'music_mood', fn: (g, m) => {
       if (g && m) return `${m.split(',')[0].trim()} ${g}`;
       return g || m;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cineprompt",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "AI video prompt builder for cinematographers. Create structured prompts and share links via cineprompt.io.",
   "keywords": [
     "ai",