animate_it 0.3.2 → 0.4.0

data/lib/animate_it.rb

@@ -14,12 +14,21 @@ require_relative "animate_it/registry"
 require_relative "animate_it/render_store"
 require_relative "animate_it/beats"
 require_relative "animate_it/animation"
+require_relative "animate_it/text_effects"
 require_relative "animate_it/scene"
 require_relative "animate_it/configuration"
 require_relative "animate_it/composition"
+require_relative "animate_it/tracks/layer"
+require_relative "animate_it/tracks/document"
+require_relative "animate_it/tracks/recorder"
+require_relative "animate_it/track_document_schema"
+require_relative "animate_it/runtime"
+require_relative "animate_it/embed_helper"
 require_relative "animate_it/output"
 require_relative "animate_it/video_renderer"
+require_relative "animate_it/verification"
 require_relative "animate_it/asset_renderer"
+require_relative "animate_it/asset_manifest"
 # Controllers (app/controllers/animate_it/*) and AnimateIt::RenderJob
 # (app/jobs/animate_it/render_job.rb) autoload via Rails — the engine's
 # `isolate_namespace AnimateIt` wires `app/` paths into the autoloader.

data/lib/tasks/animate_it_tasks.rake

@@ -1,3 +1,5 @@
+require "json"
+
 def animate_it_render_host
   # Prefer ANIMATE_IT_HOST; fall back to the legacy RAILS_MOTION_HOST, then
   # RAILS_HOST, then localhost.
@@ -8,6 +10,12 @@ def animate_it_render_host
 end
 
 namespace :animate_it do
+  desc "Validate source assets and provenance required by AnimateIt compositions"
+  task preflight: :environment do
+    result = AnimateIt::AssetManifest.new.validate!
+    puts "AnimateIt asset preflight passed (#{result.checked} assets)."
+  end
+
   desc <<~DESC
     Render a single composition's declared outputs to their asset paths.
 
@@ -52,6 +60,61 @@ namespace :animate_it do
     end
   end
 
+  desc <<~DESC
+    Pixel-diff a composition's client-driven /player page against the legacy
+    /filmstrip. Samples every <step>-th frame (default 10; use 1 for the full
+    gate) plus structural layer boundaries and adjacent frames.
+
+    Requires a running Rails server.
+
+    Usage:
+      bin/rails 'animate_it:verify[<composition-id>]'
+      bin/rails 'animate_it:verify[<composition-id>,1]'
+      ANIMATE_IT_PROPS_JSON='{"title":"Variant"}' bin/rails 'animate_it:verify[<composition-id>,1]'
+      ANIMATE_IT_PROPS_MATRIX_JSON='[{}, {"title":"Variant"}]' bin/rails 'animate_it:verify[<composition-id>,1]'
+
+    Set ANIMATE_IT_READY_TIMEOUT_MS to override the 30000ms readiness timeout.
+  DESC
+  task :verify, %i[id step] => :environment do |_task, args|
+    raise "Usage: bin/rails 'animate_it:verify[<composition-id>,(<step>)?]'" if args[:id].blank?
+
+    AnimateIt.load_compositions!
+    composition = AnimateIt.registry.fetch(args[:id])
+    verify_composition!(
+      composition,
+      host: animate_it_render_host,
+      step: (args[:step] || 10).to_i,
+      props_variants: verification_props_variants(composition)
+    )
+  end
+
+  desc <<~DESC
+    Every-frame verification gate for every client-driven composition and each
+    composition's declared `verification_props` variant.
+
+    Requires a running Rails server.
+
+    Usage:
+      bin/rails animate_it:verify_all
+      ANIMATE_IT_PROPS_MATRIX_JSON='[{}, {"title":"Variant"}]' bin/rails animate_it:verify_all
+  DESC
+  task verify_all: :environment do
+    AnimateIt.load_compositions!
+    compositions = AnimateIt.compositions.select(&:client_driven?)
+    raise "No client-driven AnimateIt compositions are registered" if compositions.empty?
+
+    compositions.each do |composition|
+      verify_composition!(
+        composition,
+        host: animate_it_render_host,
+        step: 1,
+        props_variants: verification_props_variants(composition)
+      )
+    end
+
+    puts "Verified #{compositions.size} client-driven compositions at every frame."
+  end
+
   # Parse `30..120` / `30-120` / `30` (single frame) into a Range. Returns
   # nil for blank input, meaning "use the whole composition".
   def parse_frame_range(raw, composition)
@@ -80,4 +143,74 @@ namespace :animate_it do
       $stdout.flush
     end
   end
+
+  def verification_props_variants(composition)
+    matrix_json = ENV.fetch("ANIMATE_IT_PROPS_MATRIX_JSON", nil)
+    single_json = ENV.fetch("ANIMATE_IT_PROPS_JSON", nil)
+    return parse_props_matrix(matrix_json) if matrix_json.present?
+    return [parse_props(single_json, "ANIMATE_IT_PROPS_JSON")] if single_json.present?
+
+    composition.verification_props
+  end
+
+  def parse_props_matrix(raw)
+    variants = JSON.parse(raw)
+    valid_matrix = variants.is_a?(Array) && variants.present? && variants.all?(Hash)
+    raise "ANIMATE_IT_PROPS_MATRIX_JSON must contain a non-empty JSON array of objects" unless valid_matrix
+
+    variants.map(&:deep_symbolize_keys)
+  rescue JSON::ParserError => e
+    raise "ANIMATE_IT_PROPS_MATRIX_JSON must contain a JSON array of objects: #{e.message}"
+  end
+
+  def parse_props(raw, name)
+    props = JSON.parse(raw)
+    raise "#{name} must contain a JSON object" unless props.is_a?(Hash)
+
+    props.deep_symbolize_keys
+  rescue JSON::ParserError => e
+    raise "#{name} must contain a JSON object: #{e.message}"
+  end
+
+  def verify_composition!(composition, host:, step:, props_variants:)
+    props_variants.each_with_index do |props, variant_index|
+      output_dir = Rails.root.join("tmp/animate_it/verify/#{composition.id}/variant-#{variant_index + 1}")
+      verification = AnimateIt::Verification.new(
+        composition:,
+        host:,
+        step:,
+        props:,
+        output_dir:,
+        ready_timeout: ENV.fetch("ANIMATE_IT_READY_TIMEOUT_MS", 30_000).to_i
+      )
+      puts "Verifying #{composition.id} variant #{variant_index + 1}/#{props_variants.size}: " \
+           "#{verification.sample_frames.size} frames (step #{verification.step}, " \
+           "RGB threshold #{verification.threshold}dB, alpha threshold #{verification.alpha_threshold}dB)"
+
+      results = verification.call
+      failures = results.reject(&:passed)
+      print_verification_results(results)
+      if failures.any?
+        raise "#{failures.size}/#{results.size} frames below threshold. " \
+              "Screenshots in #{verification.output_dir}"
+      end
+
+      puts "All #{results.size} frames match " \
+           "(RGB >= #{verification.threshold}dB, alpha >= #{verification.alpha_threshold}dB)."
+    end
+  end
+
+  def print_verification_results(results)
+    results.each do |result|
+      rgb = result.rgb_psnr.infinite? ? "identical" : format("%.2fdB", result.rgb_psnr)
+      alpha = result.alpha_psnr.infinite? ? "identical" : format("%.2fdB", result.alpha_psnr)
+      puts format(
+        "  frame %<frame>5d  RGB %<rgb>s  alpha %<alpha>s%<flag>s",
+        frame: result.frame,
+        rgb:,
+        alpha:,
+        flag: result.passed ? "" : "  ← FAIL"
+      )
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: animate_it
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - growth-constant
@@ -60,12 +60,14 @@ files:
 - app/controllers/animate_it/audio_controller.rb
 - app/controllers/animate_it/frames_controller.rb
 - app/controllers/animate_it/props_controller.rb
+- app/controllers/animate_it/public_players_controller.rb
 - app/controllers/animate_it/renders_controller.rb
 - app/controllers/animate_it/studio_controller.rb
 - app/jobs/animate_it/application_job.rb
 - app/jobs/animate_it/render_job.rb
 - app/views/animate_it/frames/filmstrip.html.haml
 - app/views/animate_it/frames/fragment.html.haml
+- app/views/animate_it/frames/player.html.haml
 - app/views/animate_it/frames/show.html.haml
 - app/views/animate_it/props/_form.html.haml
 - app/views/animate_it/props/update.html.haml
@@ -85,11 +87,13 @@ files:
 - lib/animate_it.rb
 - lib/animate_it/animation.rb
 - lib/animate_it/animation_helpers.rb
+- lib/animate_it/asset_manifest.rb
 - lib/animate_it/asset_renderer.rb
 - lib/animate_it/beats.rb
 - lib/animate_it/composition.rb
 - lib/animate_it/configuration.rb
 - lib/animate_it/easing.rb
+- lib/animate_it/embed_helper.rb
 - lib/animate_it/engine.rb
 - lib/animate_it/errors.rb
 - lib/animate_it/frame_context.rb
@@ -98,11 +102,19 @@ files:
 - lib/animate_it/props_schema.rb
 - lib/animate_it/registry.rb
 - lib/animate_it/render_store.rb
+- lib/animate_it/runtime.rb
+- lib/animate_it/runtime/runtime.js
 - lib/animate_it/scene.rb
 - lib/animate_it/style.rb
+- lib/animate_it/text_effects.rb
 - lib/animate_it/timeline.rb
 - lib/animate_it/timing.rb
+- lib/animate_it/track_document_schema.rb
+- lib/animate_it/tracks/document.rb
+- lib/animate_it/tracks/layer.rb
+- lib/animate_it/tracks/recorder.rb
 - lib/animate_it/units.rb
+- lib/animate_it/verification.rb
 - lib/animate_it/version.rb
 - lib/animate_it/video_renderer.rb
 - lib/animate_it/view_helpers.rb