reelforge 0.5.3 → 0.5.4

package/README.md

@@ -95,6 +95,7 @@ Run `rf <command> --help` for full details on any of these.
 |---|---|
 | `templates list [--size 1080x1920] [--type image]` | List HTML frame templates |
 | `templates preview <keyOrPath> [-o out.png]` | Render a preview from a preset key **or your own local .html file** |
+| `templates show <key> [-o file.html]` | Print or save the source HTML of any preset — copy it as a starting point for a custom template |
 | `frames render -t <keyOrPath> --title ... --text ...` | Render a single composed frame to PNG. `-t` accepts a preset key **or a local .html path** |
 | `compositions concat <v1> <v2> -o out.mp4` | FFmpeg concat (+ optional BGM) |
 | `compositions bgm -i video.mp4 --bgm bgm.mp3 -o out.mp4` | Add background music |
@@ -160,6 +161,8 @@ rf llm chat -p 'one-sentence summary of antifragile'
 #      <meta name="template:width"  content="1080">
 #      <meta name="template:height" content="1920">
 #    or pass --size 1080x1920 on the CLI.
+rf templates show 1080x1920/image_default.html -o my-brand.html   # copy a preset
+# ...edit my-brand.html to suit your style...
 rf templates preview ./my-brand.html --title "Hello" -o preview.png
 rf frames render -t ./my-brand.html --values '{"author":"Alice"}' -o frame.png
 rf pipelines standard -t "宠物" --frame-template ./my-brand.html -o final.mp4
@@ -167,6 +170,14 @@ rf pipelines standard -t "宠物" --frame-template ./my-brand.html -o final.mp4
 
 ### Custom HTML templates
 
+Easiest way to start: grab a preset as a reference.
+
+```bash
+rf templates list                                                  # see all keys
+rf templates show 1080x1920/static_default.html                    # print to stdout
+rf templates show 1080x1920/image_default.html -o my-brand.html    # save and edit
+```
+
 `{{title}}`, `{{text}}`, `{{image}}`, `{{index}}` are reserved built-ins; everything else uses the `{{name:type=default}}` DSL (`type` ∈ `text|number|color|bool`). Pass extras through `--values '{"author":"Alice"}'` (or `template_params` on the pipeline API).
 
 Limits and safety:

package/dist/commands/templates.js

@@ -1,3 +1,7 @@
+/**
+ * reelforge templates <list|preview|show>
+ */
+import fs from "node:fs/promises";
 import { get, post } from "../client.js";
 import { downloadTo } from "../utils/download.js";
 import { print, success, table } from "../utils/output.js";
@@ -58,4 +62,32 @@ export function registerTemplates(program) {
         }
         print(r);
     });
+    tpl
+        .command("show <key>")
+        .description("Print or save the source HTML of a preset template — use as a starting point for your own")
+        .helpOption("-h, --help", "show help")
+        .option("-o, --output <file>", "save HTML to this path (otherwise print to stdout)")
+        .addHelpText("after", [
+        "",
+        "Examples:",
+        "  # see what the default static template looks like",
+        "  rf templates show 1080x1920/static_default.html",
+        "",
+        "  # copy a preset and tweak it as your own brand template",
+        "  rf templates show 1080x1920/image_default.html -o my-brand.html",
+        "  # ...edit my-brand.html...",
+        "  rf frames render -t ./my-brand.html --title 'X' -o frame.png",
+        "",
+        "  Get the list of keys via `rf templates list`.",
+    ].join("\n"))
+        .action(async (key, opts) => {
+        const r = await get(`/api/v1/templates/source?key=${encodeURIComponent(key)}`);
+        if (opts.output) {
+            await fs.writeFile(opts.output, r.html, "utf-8");
+            success(`Saved → ${opts.output} (${r.size}, ${r.type}, ${r.params.length} custom params)`);
+        }
+        else {
+            process.stdout.write(r.html);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelforge",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "CLI for ReelForge Studio — AI video engine. Installs as both `reelforge` and the short alias `rf`. Every REST API exposed as a command, with --help on every level.",
   "license": "Apache-2.0",
   "type": "module",