@idle-screens/schema 2.1.0 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idle-screens/schema",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Declarative, agent-authorable saver format for idle-screens: validate a data spec, then compile it into a runnable, seeded, flash-safe SaverPlugin.",
   "license": "MIT",
   "author": "Shawn Partridge",

package/saver-spec.schema.json

@@ -88,6 +88,16 @@
                 "color": { "$ref": "#/definitions/hexColor" },
                 "height": { "type": "number", "exclusiveMinimum": 0, "description": "Band height in px (e.g. an aquarium seafloor)." }
               }
+            },
+            "drift": {
+              "type": "object",
+              "required": ["period"],
+              "additionalProperties": false,
+              "properties": {
+                "period": { "type": "number", "minimum": 10000, "description": "Full cycle period in ms. Floor of 10 s." },
+                "amount": { "type": "number", "exclusiveMinimum": 0, "maximum": 0.3, "description": "How far stops shift (fraction of 0..1 range). Default 0.15, max 0.3." }
+              },
+              "description": "Slow oscillation of gradient stop positions — makes the background feel alive."
             }
           }
         }
@@ -147,6 +157,16 @@
           },
           "description": "Exact fractional position for a single entity. Requires count: 1. Overrides region scatter."
         },
+        "trail": {
+          "type": "object",
+          "required": ["length"],
+          "additionalProperties": false,
+          "properties": {
+            "length": { "type": "number", "exclusiveMinimum": 0, "maximum": 5000, "description": "Trail duration in ms. How far back the afterglow extends." },
+            "fade": { "type": "number", "minimum": 0, "maximum": 1, "description": "Opacity fade factor along the trail. 1 = full fade to 0 (default), 0 = uniform opacity." }
+          },
+          "description": "Afterglow trail behind moving entities. Sampled analytically — no state, fully deterministic."
+        },
         "links": {
           "type": "object",
           "required": ["k", "maxDist"],