@lalalic/markcut 2.4.1 → 2.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/skills/markcut/docs/markdown-descriptive.md +12 -8
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lalalic/markcut",
3
- "version": "2.4.1",
3
+ "version": "2.4.2",
4
4
  "description": "Markdown-to-video engine. Describe scenes in markdown, get a rendered video.",
5
5
  "bin": {
6
6
  "markcut": "bin/markcut"
package/skills/markcut/docs/markdown-descriptive.md CHANGED
@@ -39,7 +39,7 @@ width:1920 height:1080 fps:30 layout:series
39
39
  ~~~css stylesheet
40
40
  .bg { background: #000; }
41
41
  ~~~
42
- subtitle:captions.vtt
42
+ subtitle:{src:"captions.vtt",type:"Bounce"}
43
43
  ```
44
44
 
45
45
  Supported keys: `width`, `height`, `fps`, `layout`, `tts`, `stt`, `tti`, `ttv`,
@@ -49,12 +49,14 @@ Values containing spaces must be quoted with double or single quotes.
49
49
 
50
50
  ### Subtitle on the config line
51
51
 
52
+ Set subtitle via `subtitle:` on the root config line:
53
+
52
54
  ```markdown
53
55
  # video
54
- width:640 height:480 subtitle:captions.vtt
56
+ width:640 height:480 subtitle:{src:"captions.vtt",type:"Bounce",fontSize:48}
55
57
  ```
56
58
 
57
- Currently only `src` (a VTT file path) is supported via the config line.
59
+ See the [Subtitle](#subtitle) section below for all supported fields.
58
60
 
59
61
  ## Template Variables
60
62
 
@@ -73,16 +75,18 @@ width:1920 height:1080
73
75
 
74
76
  > Template variables are NOT resolved in root config keys, jsx, script, style,
75
77
  > or other string fields — only in `src`, `prompt`, and `stylesheet`.
76
- style: "color: yellow;"
77
- ```
78
+
79
+ ### Subtitle
80
+
81
+ Subtitles are configured at the root level as a VTT overlay. Set via `subtitle:` on the root config line, or `root.subtitle` in JSON.
78
82
 
79
83
  | Field | Required | Type | Notes |
80
84
  |---|---|---|---|
81
85
  | `src` | yes | string | VTT path/URL, inline VTT body, or plain text |
82
- | `type` | opt | string | caption animation: `Bounce`, `Fade`, `Typewriter`, `Colorful`, etc. Default: plain static caption |
83
- | `fontSize` | opt | number | default 56 |
86
+ | `type` | opt | string | caption animation: `Bounce`, `Fade`, `Typewriter`, `Colorful`, `Glowing`, `Neon`, `Zoom`. Default: plain static caption |
87
+ | `fontSize` | opt | number \| string | default 56 (accepts CSS value like `"2em"` or number) |
84
88
  | `fontFamily` | opt | string | font family |
85
- | `fontStyle` | opt | string | `normal`, `italic`, `bold`, etc. |
89
+ | `fontStyle` | opt | string | `normal`, `italic`, `bold`, `bold italic` |
86
90
  | `style` | opt | string | inline CSS for the overlay container |
87
91
 
88
92
  > **HTML in cue text**: Cue text supports HTML tags with inline CSS, so you can style individual words: