@ignix-social/editor 0.1.9 → 0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ignix-social/editor",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Ignix Editor: render HTML video compositions (reels, edits, clips) on your own computer. Based on HyperFrames.",
   "license": "Apache-2.0",
   "type": "module",

package/src/engine.mjs

@@ -80,15 +80,23 @@ export async function renderProject(dir, output, { lufs = -14, normalize = true,
   mkdirSync(dirname(output), { recursive: true });
   const raw = join(build, 'raw.mp4');
   const args = ['render', build, '-o', raw, ...engineArgs];
-  // Avance: «Capturing frame N/M» del motor; luego codifica y monta.
+  // Avance: «Capturing frame N/M» del motor; luego codifica y monta. Y si la animación no llegó a
+  // registrarse, el motor renderiza igual (con un aviso) un vídeo congelado: eso es un fallo.
+  let frozen = false;
   const onLine = (line) => {
+    if (/sub_timeline_readiness_timeout|still unregistered|Root timeline not bound/.test(line)) frozen = true;
     const m = line.match(/Capturing frame (\d+)\/(\d+)/);
     if (m) onProgress?.({ stage: 'rendering', fraction: Math.min(0.99, Number(m[1]) / Math.max(1, Number(m[2]))) });
     else if (/Encoding video|Assembling final video/.test(line)) onProgress?.({ stage: 'encoding', fraction: 0.95 });
   };
-  const code = onProgress || signal ? await runEngineAsync(args, env, dir, { onLine, signal }) : runEngine(args, env, dir, { quiet });
+  const code = await runEngineAsync(args, env, dir, { onLine, signal });
   if (signal?.aborted) throw Object.assign(new Error('cancelled'), { code: 'cancelled' });
   if (code !== 0 || !existsSync(raw)) throw new Error('The render failed (see the messages above).');
+  if (frozen) {
+    throw new Error(
+      'The animation never started, so the video would stay frozen on its first frame. Usually GSAP is not loaded before ignix-frame.js, or IgnixFrame.run threw an error: run `ignix-editor check` and fix what it reports, then render again.',
+    );
+  }
   let level = null;
   if (normalize !== false && hasAudio(ffprobe, raw)) {
     const r = normalizeLoudness(ffmpeg, raw, output, { lufs: Number(lufs ?? -14) });

package/src/runtime/ignix-frame.js

@@ -12,6 +12,12 @@
  * `id` es el data-composition-id del nodo raíz. Necesita GSAP cargado antes.
  */
 (function () {
+  // GSAP va antes que este fichero (la plantilla de `init` lo pone). Si un agente reescribió el
+  // HTML sin él, se carga aquí mientras la página aún se lee: sin GSAP nada se movería y el
+  // vídeo saldría congelado en su primer fotograma (pasó dos veces, 2026-10-06).
+  if (!window.gsap && document.readyState === 'loading') {
+    document.write('<script src="assets/gsap.min.js"><\/script>');
+  }
   const clamp01 = (x) => Math.min(1, Math.max(0, x));
 
   // Curva cúbica de Bézier como en CSS (x1, y1, x2, y2).

package/src/validate.mjs

@@ -3,7 +3,8 @@
 //  · <video>/<audio> creados desde JS (el extractor lee el HTML, no la página viva: salen negros o mudos);
 //  · recursos de internet (el render no debe depender de la red: fuentes que llegan tarde);
 //  · ids que el motor trata de forma especial (id="caption" cambió la fuente de los subtítulos).
-import { readFileSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 import { parse } from 'parse5';
 
 // Avisos de parse5 que no cambian cómo se pinta la página.
@@ -65,7 +66,9 @@ export function validateHtml(file) {
   if (frame) {
     const gsap = scripts.find((x) => /gsap(\.min)?\.js$/i.test(x.src));
     if (!gsap || gsap.at > frame.at) {
-      issues.push({ level: 'error', line: lineOf(src, frame.at), rule: 'gsap_before_frame', msg: `ignix-frame.js needs GSAP loaded first. Put <script src="assets/gsap.min.js"></script> right above <script src="ignix-frame.js"></script> (as \`ignix-editor init\` writes it).` });
+      // ignix-frame.js lo carga solo desde assets/gsap.min.js: si el fichero está, es un aviso.
+      const there = existsSync(join(dirname(file), 'assets', 'gsap.min.js'));
+      issues.push({ level: there ? 'warning' : 'error', line: lineOf(src, frame.at), rule: 'gsap_before_frame', msg: `ignix-frame.js needs GSAP loaded first. Put <script src="assets/gsap.min.js"></script> right above <script src="ignix-frame.js"></script> (as \`ignix-editor init\` writes it)${there ? '. ignix-frame.js loads it from assets/ meanwhile.' : ': assets/gsap.min.js is missing too.'}` });
     }
   }
   for (const m of src.matchAll(/@import\s+url\(\s*["']?https?:|url\(\s*["']?https?:\/\/fonts\./gi)) {