@lalalic/markcut 2.7.0 → 2.7.1

package/AGENTS.md

@@ -5,10 +5,11 @@
 ## Quick Start
 
 ```bash
-npm run render storyboard.md      # render markdown → MP4 (9x16 default)
-npm run preview storyboard.md --edit  # live preview with auto-reload
-npm test                           # unit + integration tests
-npm run typecheck                  # TypeScript type check
+npm run render storyboard.md                        # render markdown → MP4 (9x16 default)
+npm run preview storyboard.md --edit                # live preview with auto-reload
+npm run preview storyboard.md --storyboard          # fast structure preview (skips TTI/TTV, shows prompts as placeholders)
+npm test                                             # unit + integration tests
+npm run typecheck                                    # TypeScript type check
 ```
 
 ## Input formats

package/README.md

@@ -9,6 +9,9 @@ npx markcut render storyboard.md
 # Preview with live edit (edit .md file, player auto-reloads)
 npx markcut preview storyboard.md --edit
 
+# Fast structure preview: show TTI/TTV prompts as placeholders, skip slow generation
+npx markcut preview storyboard.md --storyboard
+
 # Label clips in a stream tree
 npx markcut preview labels.json --label --port=3031
 ```
@@ -43,6 +46,7 @@ storyboard.md  ──[parse]──▶  DescriptiveRoot  ──[compile]──▶
 | **Tween animation** | `tween(from, to)` function calls in JSX for frame-accurate numeric animation |
 | **Styling** | Inline `style` strings on any node for CSS. JSX components use inline React styles |
 | **Live edit** | `--edit` watches the input file, re-runs pipeline, auto-reloads player |
+| **Storyboard** | `--storyboard` fast structure preview: replaces TTI/TTV prompts with placeholder components, skips slow generation. Implies `--edit` |
 | **Label mode** | `--label` interactive player with per-scene label input, saves to labels.json |
 | **CLI** | `render`, `preview` commands for MP4 export and Remotion Studio |
 | **Programmatic** | `MarkCut` / `DescriptiveComposition` React components for embedding |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lalalic/markcut",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "description": "Markdown-to-video engine. Describe scenes in markdown, get a rendered video.",
   "bin": {
     "markcut": "bin/markcut"

package/skills/markcut/SKILL.md

@@ -10,8 +10,9 @@ Everything video is a **stream tree** described with markdown. see [docs/markdow
 
 ## Video Design Utilities
 
-### User labels — label media with text, time ranges
-- `npx @lalalic/markcut preview --label` provides tool to label video and images with text.
+### Vision — understand video and images
+- `npx @lalalic/markcut vision <folder>` provides tool to understand video and images in a folder, and generate a `metadata.json` file with with text description, duration, and other metadata for each media file.
+- `npx @lalalic/markcut vision <folder> --label`, interactive mode, provides tool to label video and images with text, and above metadata.
 
 ### Storyboard — plan video structure with scene nodes
 
@@ -20,6 +21,18 @@ Everything video is a **stream tree** described with markdown. see [docs/markdow
 
 see [docs/markdown-descriptive.md](docs/markdown-descriptive.md) for full details.
 
+### `--storyboard` — fast structure preview
+```bash
+npx @lalalic/markcut preview video.md --storyboard
+```
+
+Skips slow TTI/TTV/STT generation and renders a fast preview where:
+- `image`/`video` nodes with `prompt` but no `src` → `<StoryboardSlot>` placeholder showing the prompt text
+- `audio`/`script` nodes → `<StoryboardCaption>` overlays showing narration text
+- A `<StoryboardInfo>` card with root metadata (title, dimensions, fps) appears at the first frame
+
+Implies `--edit` so you can chat to reshape the story and see live reloads.
+
 ### Video Variants
 - define variants for different video configurations, such as different languages, aspects, platforms
 
@@ -43,10 +56,11 @@ npx @lalalic/markcut <command> [options]
 npx @lalalic/markcut --help # get overall information
 npx @lalalic/markcut --show-clis # get command specific information
 npx @lalalic/markcut preview <file> # assemble and preview the video with a local server, and chat to edit the video and auto refresh
+npx @lalalic/markcut preview <file> --storyboard # fast structure preview: replaces TTI/TTV prompts with placeholder components, skips slow generation
 npx @lalalic/markcut render <file> # render the video to mp4
 npx @lalalic/markcut vision <folder> # vision understanding medias in folder
 npx @lalalic/markcut vision <folder> --label # an extra step to provide UI to label the medias with text, time ranges
-
+  
 ```
 
 ---

package/src/render/cli.mjs

@@ -65,8 +65,10 @@ Commands:
 
   preview <file.json|.md>               Open player with live preview
     --label                           Open label input overlay
-    --storyboard                      Fast structure preview: show TTI/TTV prompts as
-                                      placeholder components (skips slow generation).
+    --storyboard                      Fast structure preview: replaces TTI/TTV prompt
+                                    nodes with <StoryboardSlot> placeholders and
+                                    script nodes with <StoryboardCaption> overlays.
+                                    Skips slow generation (TTI/TTV/STT).
                                       Implies --edit so you can reshape the story.
     --no-browser                      Skip opening browser automatically
     --port <num>                        Port for the player server (default: 3001)