vizcore 1.1.0 → 1.2.0

data/scripts/browser_capture.mjs

@@ -4,7 +4,7 @@ import path from "node:path";
 const options = parseArgs(process.argv.slice(2));
 
 if (!options.url) {
-  console.error("Usage: node scripts/browser_capture.mjs URL --out browser-capture.png [--selector #vizcore-canvas] [--wait 1000]");
+  console.error("Usage: node scripts/browser_capture.mjs URL --out browser-capture.png [--selector #vizcore-canvas] [--wait 1000] [--wait-for-frame]");
   process.exit(1);
 }
 
@@ -24,8 +24,11 @@ try {
     await page.waitForTimeout(options.wait);
   }
 
-  const element = page.locator(options.selector).first();
+  const element = await resolveCaptureLocator(page, options.selector);
   await element.waitFor({ state: "visible", timeout: 10000 });
+  if (options.waitForFrame) {
+    await waitForVizcoreFrame(page, options.frameTimeout);
+  }
   await fs.mkdir(path.dirname(options.out), { recursive: true });
   await element.screenshot({ path: options.out });
   console.log(`Browser capture written: ${options.out}`);
@@ -33,6 +36,25 @@ try {
   await browser.close();
 }
 
+async function resolveCaptureLocator(page, selector) {
+  const candidates = [...new Set([selector, "#vizcore-canvas", "canvas"].filter(Boolean))];
+  for (const candidate of candidates) {
+    const locator = page.locator(candidate).first();
+    if (await locator.count().catch(() => 0) > 0) {
+      return locator;
+    }
+  }
+  return page.locator(selector).first();
+}
+
+async function waitForVizcoreFrame(page, timeout) {
+  await page.waitForFunction(
+    () => Number(document.body?.dataset?.vizcoreFrameCount || 0) > 0,
+    null,
+    { timeout }
+  );
+}
+
 function parseArgs(args) {
   const parsed = {
     url: null,
@@ -41,6 +63,8 @@ function parseArgs(args) {
     wait: 1000,
     width: 1280,
     height: 720,
+    waitForFrame: false,
+    frameTimeout: 10000,
   };
 
   for (let index = 0; index < args.length; index += 1) {
@@ -60,6 +84,11 @@ function parseArgs(args) {
     } else if (value === "--height") {
       parsed.height = finiteNumber(args[index + 1], parsed.height);
       index += 1;
+    } else if (value === "--wait-for-frame") {
+      parsed.waitForFrame = true;
+    } else if (value === "--frame-timeout") {
+      parsed.frameTimeout = finiteNumber(args[index + 1], parsed.frameTimeout);
+      index += 1;
     } else if (!parsed.url) {
       parsed.url = value;
     }

data/sig/vizcore.rbs

@@ -4,6 +4,7 @@ module Vizcore
   def self.root: () -> Pathname
   def self.frontend_root: () -> Pathname
   def self.templates_root: () -> Pathname
+  def self.features: (?command_available: untyped? command_available) -> Hash[Symbol, bool]
   def self.define: () { () -> void } -> Hash[Symbol, untyped]
   def self.plugin: (String | Symbol name) -> bool
   def self.register_shape: (Symbol | String name, untyped renderer) -> Vizcore::Shape::Definition
@@ -87,11 +88,18 @@ module Vizcore::Shape
   class AudioContext
     def amplitude: () -> Float
     def bass: () -> Float
+    def bass_peak: () -> Float
     def mid: () -> Float
+    def mid_peak: () -> Float
     def high: () -> Float
+    def high_peak: () -> Float
     def fft: () -> Array[untyped]
     def beat?: () -> bool
     def beat_pulse: () -> Float
+    def beat_phase: () -> Float
+    def bar_phase: () -> Float
+    def bar_count: () -> Integer
+    def phrase_count: () -> Integer
     def kick: () -> Float
     def snare: () -> Float
     def hihat: () -> Float
@@ -201,10 +209,14 @@ module Vizcore::Analysis
 
   class FeatureReplay
     attr_reader metadata: Hash[Symbol, untyped]
+    attr_reader cursor: Integer
 
     def initialize: (path: String | Pathname path) -> void
     def call: (?Array[Float]? samples) -> Hash[Symbol, untyped]
     def frame_count: () -> Integer
+    def seek: (Integer index) -> FeatureReplay
+    def seek_seconds: (Numeric seconds) -> FeatureReplay
+    def frame: (Integer index) -> Hash[Symbol, untyped]
   end
 end
 
@@ -239,7 +251,8 @@ module Vizcore::DSL
   type scene = { name: Symbol, layers: Array[layer], ?theme: Symbol }
   type style = { name: Symbol, params: Hash[Symbol, untyped] }
   type theme = { name: Symbol, params: Hash[Symbol, untyped] }
-  type timeline_entry = { at: Float, unit: Symbol, scene: Symbol }
+  type mapping_preset = { name: Symbol, mappings: Array[mapping] }
+  type timeline_entry = { at: Float, unit: Symbol, scene: Symbol, ?cue: Symbol }
   type key_action = { type: Symbol, ?scene: String, ?control: Symbol }
   type key_mapping = { key: String, action: key_action }
 
@@ -251,18 +264,28 @@ module Vizcore::DSL
     def audio: (Symbol | String name, **untyped options) -> Array[Hash[Symbol, untyped]]
     def style: (Symbol | String name) { () -> void } -> void
     def theme: (Symbol | String name) { () -> void } -> void
+    def mapping: (Symbol | String name) { () -> void } -> void
     def midi: (Symbol | String name, **untyped options) -> Array[Hash[Symbol, untyped]]
     def audio_normalize: (?mode: Symbol | String mode, **untyped options) -> Hash[Symbol, untyped]
+    def audio_analysis: (**untyped options) -> Hash[Symbol, untyped]
     def bpm: (Numeric value) -> Float
     def bpm_lock: () -> bool
                 | (bool value) -> bool
     def tap_tempo: (?key: Symbol | String key) -> Hash[Symbol, untyped]
     def key: (Symbol | String value) { () -> void } -> void
     def scene: (Symbol | String name, ?extends: Symbol | String? extends) { () -> void } -> void
-    def section: (Symbol | String name, bars: Integer bars, ?beats_per_bar: Integer beats_per_bar) { () -> void } -> void
+    def section: (Symbol | String name, bars: Integer bars, ?beats_per_bar: Integer beats_per_bar, ?loop: bool loop, ?hold: Numeric hold, ?outro: bool outro) { () -> void } -> void
     def timeline: (?beats_per_bar: Integer beats_per_bar) { () -> void } -> void
     def transition: (from: Symbol | String, to: Symbol | String) { () -> void } -> void
-    def midi_map: (?note: Integer? note, ?cc: Integer? cc, ?pc: Integer? pc) { (*untyped) -> void } -> void
+    def midi_map: (
+      ?note: Integer? note,
+      ?cc: Integer? cc,
+      ?pc: Integer? pc,
+      ?channel: Integer? channel,
+      ?relative: bool relative,
+      ?deadband: Numeric? deadband,
+      ?smooth: Numeric | bool | nil smooth
+    ) { (*untyped) -> void } -> void
     def set: (Symbol | String key, untyped value) -> untyped
     def to_h: () -> Hash[Symbol, untyped]
   end
@@ -308,6 +331,7 @@ module Vizcore::DSL
       name: Symbol | String name,
       ?styles: Hash[Symbol, Hash[Symbol, untyped]] styles,
       ?themes: Hash[Symbol, Hash[Symbol, untyped]] themes,
+      ?mapping_presets: Hash[Symbol, Array[mapping]] mapping_presets,
       ?layers: Array[layer] layers
     ) -> void
     def evaluate: () ?{ () -> void } -> SceneBuilder
@@ -321,6 +345,7 @@ module Vizcore::DSL
     def initialize: (
       name: Symbol | String name,
       ?styles: Hash[Symbol, Hash[Symbol, untyped]] styles,
+      ?mapping_presets: Hash[Symbol, Array[mapping]] mapping_presets,
       ?defaults: Hash[Symbol, untyped] defaults
     ) -> void
     def evaluate: () ?{ () -> void } -> LayerGroupBuilder
@@ -351,6 +376,7 @@ module Vizcore::DSL
     def initialize: (
       name: Symbol | String name,
       ?styles: Hash[Symbol, Hash[Symbol, untyped]] styles,
+      ?mapping_presets: Hash[Symbol, Array[mapping]] mapping_presets,
       ?defaults: Hash[Symbol, untyped] defaults
     ) -> void
     def evaluate: () ?{ () -> void } -> LayerBuilder
@@ -391,6 +417,7 @@ module Vizcore::DSL
     def color_shift: (Numeric value) -> Float
     def palette: (*untyped colors) -> Array[String]
     def use_style: (Symbol | String name) -> Hash[Symbol, untyped]
+    def use_mapping: (Symbol | String name) -> void
     def param: (
       Symbol | String name,
       ?default: Numeric? default,
@@ -403,12 +430,19 @@ module Vizcore::DSL
     def react_to: (Hash[Symbol, untyped] | Symbol | String source_value) { () -> void } -> void
     def amplitude: () -> source
     def frequency_band: (Symbol | String name) -> source
+    def frequency_band_peak: (Symbol | String name) -> source
     def sub: () -> source
+    def sub_peak: () -> source
     def low: () -> source
+    def low_peak: () -> source
     def bass: () -> source
+    def bass_peak: () -> source
     def mid: () -> source
+    def mid_peak: () -> source
     def high: () -> source
+    def high_peak: () -> source
     def treble: () -> source
+    def treble_peak: () -> source
     def fft_spectrum: () -> source
     def onset: () -> source
              | (Symbol | String band) -> source
@@ -423,6 +457,15 @@ module Vizcore::DSL
     def beat_confidence: () -> source
     def beat_pulse: () -> source
     def beat_count: () -> source
+    def beat_phase: () -> source
+    def beat_2: () -> source
+    def beat_4: () -> source
+    def beat_8: () -> source
+    def beat_triplet: () -> source
+    def triplet: () -> source
+    def bar_phase: () -> source
+    def bar_count: () -> source
+    def phrase_count: () -> source
     def bpm: () -> source
     def to_h: () -> layer
   end
@@ -447,6 +490,12 @@ module Vizcore::DSL
     def to_h: () -> Hash[Symbol, untyped]
   end
 
+  class MappingPresetBuilder
+    def initialize: (name: Symbol | String name, ?strict: bool strict) -> void
+    def evaluate: () ?{ () -> void } -> MappingPresetBuilder
+    def to_h: () -> mapping_preset
+  end
+
   class MappingResolver
     def initialize: () -> void
     def resolve_layers: (
@@ -455,7 +504,9 @@ module Vizcore::DSL
       ?time: Numeric time,
       ?frame: Integer frame,
       ?resolution: Array[untyped] resolution,
-      ?globals: Hash[untyped, untyped] globals
+      ?globals: Hash[untyped, untyped] globals,
+      ?custom_shape_overrides: Hash[untyped, untyped] custom_shape_overrides,
+      ?layer_param_overrides: Hash[untyped, untyped] layer_param_overrides
     ) -> Array[Hash[Symbol, untyped]]
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vizcore
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Yudai Takada
@@ -13,16 +13,22 @@ dependencies:
   name: faye-websocket
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.11'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.13'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.11'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.13'
 - !ruby/object:Gem::Dependency
   name: ffi
   requirement: !ruby/object:Gem::Requirement
@@ -146,6 +152,7 @@ files:
 - frontend/src/renderer/layer-manager.js
 - frontend/src/renderer/shader-manager.js
 - frontend/src/runtime-control-preset.js
+- frontend/src/scene-patches.js
 - frontend/src/shader-error-overlay.js
 - frontend/src/shader-param-controls.js
 - frontend/src/shaders/builtins.js
@@ -177,6 +184,7 @@ files:
 - lib/vizcore/analysis/tap_tempo.rb
 - lib/vizcore/audio.rb
 - lib/vizcore/audio/base_input.rb
+- lib/vizcore/audio/calibration.rb
 - lib/vizcore/audio/dummy_sine_input.rb
 - lib/vizcore/audio/file_input.rb
 - lib/vizcore/audio/fixture_input.rb
@@ -189,6 +197,7 @@ files:
 - lib/vizcore/cli/doctor.rb
 - lib/vizcore/cli/dsl_reference.rb
 - lib/vizcore/cli/layer_docs.rb
+- lib/vizcore/cli/plugin_checker.rb
 - lib/vizcore/cli/scene_diagnostics.rb
 - lib/vizcore/cli/scene_inspector.rb
 - lib/vizcore/cli/scene_validator.rb
@@ -196,11 +205,15 @@ files:
 - lib/vizcore/cli/shader_uniform_docs.rb
 - lib/vizcore/config.rb
 - lib/vizcore/control_preset.rb
+- lib/vizcore/deep_copy.rb
 - lib/vizcore/dsl.rb
+- lib/vizcore/dsl/color_helpers.rb
 - lib/vizcore/dsl/engine.rb
 - lib/vizcore/dsl/file_watcher.rb
 - lib/vizcore/dsl/layer_builder.rb
 - lib/vizcore/dsl/layer_group_builder.rb
+- lib/vizcore/dsl/layout_helpers.rb
+- lib/vizcore/dsl/mapping_preset_builder.rb
 - lib/vizcore/dsl/mapping_resolver.rb
 - lib/vizcore/dsl/mapping_transform_builder.rb
 - lib/vizcore/dsl/midi_map_executor.rb
@@ -212,6 +225,7 @@ files:
 - lib/vizcore/dsl/transition_controller.rb
 - lib/vizcore/errors.rb
 - lib/vizcore/layer_catalog.rb
+- lib/vizcore/plugin_asset_policy.rb
 - lib/vizcore/project_manifest.rb
 - lib/vizcore/renderer.rb
 - lib/vizcore/renderer/frame_scheduler.rb
@@ -221,6 +235,7 @@ files:
 - lib/vizcore/renderer/scene_serializer.rb
 - lib/vizcore/renderer/snapshot.rb
 - lib/vizcore/renderer/snapshot_renderer.rb
+- lib/vizcore/scene_trust.rb
 - lib/vizcore/server.rb
 - lib/vizcore/server/frame_broadcaster.rb
 - lib/vizcore/server/gallery_app.rb