fablecut 1.13.0 → 1.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fablecut",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "Zero-dependency browser video editor that AI agents can drive — JSON timeline, MCP server, REST API, live-reloading UI.",
   "main": "server.js",
   "bin": {

package/paths.js

@@ -32,8 +32,15 @@ const MEDIA_DIR = path.join(DATA_DIR, "media");
 const EXPORTS_DIR = path.join(DATA_DIR, "exports");
 const ANALYSIS_DIR = path.join(DATA_DIR, "analysis");
 const LIBRARY_DIR = path.join(DATA_DIR, "library");
+/* Grabs of single frames / contact sheets (GET /api/frame). Disposable render
+   cache, so it lives inside analysis/ rather than becoming a fifth top-level
+   folder users have to think about. */
+const FRAMES_DIR = path.join(ANALYSIS_DIR, "frames");
+/* Proxies (light copies of heavy footage the editor plays while editing).
+   A regenerable cache too, so also inside analysis/. */
+const PROXIES_DIR = path.join(ANALYSIS_DIR, "proxies");
 const PROJECT_FILE = path.join(DATA_DIR, "project.json");
-const LIBRARY_SUBDIRS = ["sfx", "elements", "svg", "fonts"];
+const LIBRARY_SUBDIRS = ["sfx", "elements", "svg", "fonts", "presets", "templates"];
 
 /* The asset library ships with the repo but users also drop their own files in
    (library/sfx is gitignored precisely for that). When the data dir is split
@@ -92,15 +99,38 @@ function superseded(rel, file) {
 /* Create the writable tree. Safe to call from both servers; whoever runs first
    wins and the other no-ops. */
 function ensureDirs() {
-  for (const d of [DATA_DIR, MEDIA_DIR, EXPORTS_DIR, ANALYSIS_DIR])
+  for (const d of [DATA_DIR, MEDIA_DIR, EXPORTS_DIR, ANALYSIS_DIR, FRAMES_DIR, PROXIES_DIR])
     fs.mkdirSync(d, { recursive: true });
   for (const d of LIBRARY_SUBDIRS)
     fs.mkdirSync(path.join(LIBRARY_DIR, d), { recursive: true });
   seedLibrary();
 }
 
+/* Saved animation presets and templates: one JSON file each in library/presets/
+   and library/templates/ (templates.js validates them). Unreadable files are skipped. */
+function readSaved(kind) {
+  const dir = path.join(LIBRARY_DIR, kind);
+  let names = [];
+  try { names = fs.readdirSync(dir).filter((f) => f.toLowerCase().endsWith(".json")).sort(); } catch { return []; }
+  const out = [];
+  for (const f of names) {
+    try { out.push({ file: f, data: JSON.parse(fs.readFileSync(path.join(dir, f), "utf8").replace(new RegExp("^\\uFEFF"), "")) }); } catch { }
+  }
+  return out;
+}
+function writeSaved(kind, id, data) {
+  const dir = path.join(LIBRARY_DIR, kind);
+  fs.mkdirSync(dir, { recursive: true });
+  const file = path.join(dir, String(id).replace(/[^a-z0-9-]+/gi, "-").slice(0, 60) + ".json");
+  // tmp + rename, like the project file: a crash mid-write never leaves half a preset
+  const tmp = `${file}.${crypto.randomUUID()}.tmp`;   // unique: the editor and the MCP server may save at once
+  fs.writeFileSync(tmp, JSON.stringify(data, null, 2) + "\n");
+  fs.renameSync(tmp, file);
+  return file;
+}
+
 module.exports = {
   APP_DIR, DATA_DIR, SPLIT,
   MEDIA_DIR, EXPORTS_DIR, ANALYSIS_DIR, LIBRARY_DIR, PROJECT_FILE,
-  LIBRARY_SUBDIRS, ensureDirs,
+  LIBRARY_SUBDIRS, FRAMES_DIR, PROXIES_DIR, ensureDirs, readSaved, writeSaved,
 };