@feralfile/cli 2.0.2 → 2.0.3

package/config.json.example

@@ -1,5 +1,6 @@
 {
   "defaultDuration": 10,
+  "generativeDuration": 60,
   "browser": {
     "timeout": 90000,
     "sanitizationLevel": "medium"

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@feralfile/cli",
-    "version": "2.0.2",
+    "version": "2.0.3",
     "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
     "repository": {
         "type": "git",

package/dist/src/config.js

@@ -34,6 +34,7 @@ function loadConfig() {
     const { localPath, userPath } = getConfigPaths();
     const defaultConfig = {
         defaultDuration: parseInt(process.env.DEFAULT_DURATION || '10', 10),
+        generativeDuration: parseInt(process.env.DEFAULT_GENERATIVE_DURATION || '60', 10),
         browser: {
             timeout: parseInt(process.env.BROWSER_TIMEOUT || '90000', 10),
             sanitizationLevel: process.env.SANITIZATION_LEVEL || 'medium',

package/dist/src/utilities/playlist-builder.js

@@ -48,16 +48,18 @@ function isInteractiveWeb(mimeType, sourceUrl) {
  *   - a time-based source (video/audio) gets NO duration and
  *     `display.loop: false`, so a conformant player MUST advance at
  *     end-of-stream — the media plays its natural length;
- *   - an interactive web page (HTML) gets NO duration either, but for the
- *     opposite reason: it has no end-of-stream event, so a conformant player
- *     parks on it indefinitely (the generative/interactive art keeps running);
+ *   - an interactive web page (HTML) — generative art with no intrinsic
+ *     runtime and no end-of-stream event — gets the configured
+ *     `generativeDuration` (default 60s) so the playlist rotates. Set
+ *     `generativeDuration` to 0 to omit it and have a conformant player park
+ *     on the work open-ended instead;
  *   - static and code-based sources fall back to the configured
  *     `defaultDuration` because they have no intrinsic runtime to play out.
  *
- * Do not re-introduce an unconditional duration here: stamping a default on
- * video items silently truncates or pads them, and stamping one on an HTML
- * page cuts the artwork off and restarts it every `defaultDuration` seconds
- * (the bugs this guards against).
+ * Do not stamp a duration on video/audio: it silently truncates or pads them.
+ * (Earlier this also omitted duration for HTML works, which left them with no
+ * duration field. Players that require the field — notably FF1 — then rejected
+ * the entire playlist, so generative works now carry an explicit duration.)
  *
  * @param {Object} item - DP1 playlist item (mutated in place)
  * @param {Object} mediaHints - Media signals for the time-based check
@@ -76,8 +78,13 @@ function applyItemTiming(item, mediaHints = {}, duration) {
         return item;
     }
     if (isInteractiveWeb(mediaHints.mimeType, mediaHints.sourceUrl)) {
-        // No duration: an open-ended interactive page should play until the
-        // playlist advances for another reason, not on a fixed timer.
+        // Generative/interactive works have no intrinsic runtime, so stamp the
+        // configured generative duration to drive playlist rotation. A configured
+        // value of 0 means "omit" — a conformant player then parks open-ended.
+        const generativeDuration = getGenerativeDuration();
+        if (generativeDuration > 0) {
+            item.duration = generativeDuration;
+        }
         return item;
     }
     item.duration = getDefaultStaticDuration();
@@ -98,6 +105,23 @@ function getDefaultStaticDuration() {
         return 10;
     }
 }
+/**
+ * getGenerativeDuration returns the configured display seconds for
+ * generative/interactive (HTML) works, which have no intrinsic runtime.
+ * Defaults to 60 when config is unavailable. A configured 0 is honored (the
+ * caller omits the duration so the work plays open-ended).
+ *
+ * @returns {number} Display duration in seconds (0 means "omit / open-ended")
+ */
+function getGenerativeDuration() {
+    try {
+        const configured = getConfig().generativeDuration;
+        return typeof configured === 'number' ? configured : 60;
+    }
+    catch (_error) {
+        return 60;
+    }
+}
 /**
  * Convert a string to a URL-friendly slug
  *

package/docs/CONFIGURATION.md

@@ -22,8 +22,11 @@ npm run dev -- config show
 ## Top‑level fields
 
 - **defaultDuration** (number, seconds)
-  - Default per‑item display duration for media without an intrinsic runtime (images, code-based works). Falls back to 10s when unset.
+  - Default per‑item display duration for static media without an intrinsic runtime (images). Falls back to 10s when unset.
   - Does NOT apply to video/audio items: with no explicit duration those are emitted without `duration` and with `display.loop: false`, so a DP-1 player advances at end-of-stream (§4.1) — the media plays its natural length.
+- **generativeDuration** (number, seconds)
+  - Display duration stamped on generative/interactive (HTML) works, which have no intrinsic runtime and no end-of-stream event. Defaults to **60s** (override via `DEFAULT_GENERATIVE_DURATION`).
+  - Set to **0** to omit the duration entirely, so a conformant player parks on the work open-ended instead of rotating. Note: some players (including FF1) require every item to carry a `duration` and will reject a playlist whose items omit it — keep this non-zero unless you know your player tolerates an absent duration.
 
 ## browser
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feralfile/cli",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
   "repository": {
     "type": "git",