shellfie 0.1.1 → 1.1.0

data/lib/shellfie/yaml_safety.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+require_relative "errors"
+require "yaml"
+
+module Shellfie
+  module YamlSafety
+    MAX_DEPTH = 100
+    MAX_NODES = 100_000
+
+    module_function
+
+    def annotate_validation_error(error, documents, provenance: {})
+      if (target = validation_path(error.message)) && (origin = provenance[target])
+        path, local_path = origin
+        content = documents.assoc(path)&.last
+        if content && (location = location_for_path(content, local_path))
+          return error.class.new("#{path}:#{location[0]}:#{location[1]}: #{error.message}")
+        end
+      end
+
+      documents.each do |path, content|
+        next unless path && content
+
+        location = validation_location(content, error.message)
+        return error.class.new("#{path}:#{location[0]}:#{location[1]}: #{error.message}") if location
+      end
+
+      path = documents.first&.first
+      error.class.new(path ? "#{path}: #{error.message}" : error.message)
+    end
+
+    def read_file(path, max_bytes:, label: "Configuration")
+      raise ParseError, "#{label} file not found: #{path}" unless File.file?(path)
+
+      content = File.open(path, "rb") { |file| file.read(max_bytes + 1) }
+      raise ParseError, "#{label} file is too large: #{path} (max #{max_bytes} bytes)" if content.bytesize > max_bytes
+
+      content
+    end
+
+    def load_file(path, max_bytes:, label: "Configuration", symbolize_names: true)
+      value = YAML.safe_load(
+        read_file(path, max_bytes: max_bytes, label: label), symbolize_names: symbolize_names, aliases: true
+      )
+      validate_tree!(value)
+    rescue Psych::Exception => e
+      raise ParseError, "Invalid #{label.downcase} YAML syntax: #{e.message}"
+    end
+
+    def validate_tree!(value)
+      active = {}
+      nodes = 0
+      stack = [[value, 0, false]]
+
+      until stack.empty?
+        node, depth, leaving = stack.pop
+        next unless node.is_a?(Hash) || node.is_a?(Array)
+        if leaving
+          active.delete(node.object_id)
+          next
+        end
+
+        raise ParseError, "YAML aliases must not contain cycles" if active[node.object_id]
+        raise ParseError, "YAML nesting is too deep (max #{MAX_DEPTH})" if depth > MAX_DEPTH
+        nodes += 1
+        raise ParseError, "YAML structure is too large (max #{MAX_NODES} collections)" if nodes > MAX_NODES
+
+        active[node.object_id] = true
+        stack << [node, depth, true]
+        children = node.is_a?(Hash) ? node.flat_map { |key, nested| [key, nested] } : node
+        children.reverse_each { |child| stack << [child, depth + 1, false] }
+      end
+
+      value
+    end
+
+    def validation_location(content, message)
+      locations = {}
+      collect_locations(Psych.parse(content).root, [], locations)
+      target = validation_path(message)
+      return locations[target] if target && locations[target]
+
+      locations.sort_by { |path, _location| -path.size }.each do |path, location|
+        return location if message.include?(format_path(path))
+      end
+      nil
+    rescue Psych::Exception
+      nil
+    end
+
+    def location_for_path(content, path)
+      locations = {}
+      collect_locations(Psych.parse(content).root, [], locations)
+      locations[path] || locations[path[0...-1]]
+    rescue Psych::Exception
+      nil
+    end
+
+    def collect_locations(node, path, locations)
+      case node
+      when Psych::Nodes::Mapping
+        node.children.each_slice(2) do |key, value|
+          next unless key.respond_to?(:value)
+
+          child_path = path + [key.value.to_sym]
+          locations[child_path] = [key.start_line + 1, key.start_column + 1]
+          collect_locations(value, child_path, locations)
+        end
+      when Psych::Nodes::Sequence
+        node.children.each_with_index { |child, index| collect_locations(child, path + [index], locations) }
+      end
+    end
+
+    def validation_path(message)
+      if (match = /Unknown (.+?) key\(s\):\s*([^,\s]+)/.match(message))
+        prefix = match[1] == "configuration" ? [] : parse_path(match[1])
+        return prefix + [match[2].to_sym]
+      end
+
+      explicit = message[/\b(?:steps|outputs|frames|lines)\[\d+\](?:\.[a-z_]+)*|\b(?:terminal|render|window|font|animation|cursor|limits)\.[a-z_]+/]
+      return parse_path(explicit) if explicit
+
+      {
+        "Session config version" => [:version], "mode must" => [:mode], "Invalid theme" => [:theme],
+        "redaction" => [:redact], "requires" => [:requires], "terminal.env" => %i[terminal env],
+        "title must" => [:title], "headless must" => [:headless]
+      }.each { |fragment, path| return path if message.include?(fragment) }
+      nil
+    end
+
+    def parse_path(value)
+      value.to_s.scan(/[A-Za-z_][A-Za-z0-9_]*|\d+/).map { |part| part.match?(/\A\d+\z/) ? part.to_i : part.to_sym }
+    end
+
+    def format_path(path)
+      path.each_with_object(+"") do |part, result|
+        if part.is_a?(Integer)
+          result << "[#{part}]"
+        else
+          result << "." unless result.empty?
+          result << part.to_s
+        end
+      end
+    end
+  end
+end

data/lib/shellfie.rb

@@ -5,9 +5,50 @@ require_relative "shellfie/errors"
 require_relative "shellfie/config"
 require_relative "shellfie/parser"
 require_relative "shellfie/ansi_parser"
-require_relative "shellfie/renderer"
-require_relative "shellfie/gif_generator"
-require_relative "shellfie/cli"
 
 module Shellfie
+  autoload :AnimationFrameBuilder, File.expand_path("shellfie/animation_frame_builder", __dir__)
+  autoload :AnimationScrollEasing, File.expand_path("shellfie/animation_scroll_easing", __dir__)
+  autoload :AnimationTimeline, File.expand_path("shellfie/animation_timeline", __dir__)
+  autoload :CLI, File.expand_path("shellfie/cli", __dir__)
+  autoload :GifGenerator, File.expand_path("shellfie/gif_generator", __dir__)
+  autoload :GifPalette, File.expand_path("shellfie/gif_palette", __dir__)
+  autoload :ImageMagickCommandBuilder, File.expand_path("shellfie/image_magick_command_builder", __dir__)
+  autoload :RenderChromeCache, File.expand_path("shellfie/render_chrome_cache", __dir__)
+  autoload :Renderer, File.expand_path("shellfie/renderer", __dir__)
+  autoload :TerminalScreen, File.expand_path("shellfie/terminal_screen", __dir__)
+  autoload :TranscriptRenderer, File.expand_path("shellfie/transcript_renderer", __dir__)
+  autoload :Cassette, File.expand_path("shellfie/cassette", __dir__)
+  autoload :Session, File.expand_path("shellfie/session", __dir__)
+  autoload :SessionConfig, File.expand_path("shellfie/session_config", __dir__)
+  autoload :SessionRunner, File.expand_path("shellfie/session_runner", __dir__)
+  autoload :ReproducibilityManifest, File.expand_path("shellfie/reproducibility_manifest", __dir__)
+
+  class << self
+    def parse(source)
+      Parser.parse(source)
+    end
+
+    def validate(source)
+      parse(source)
+      true
+    end
+
+    def render(config_or_source, output:, animate: nil, scale: 1, shadow: true, transparent: false, format: nil)
+      config = config_or_source.is_a?(Config) ? config_or_source : parse(config_or_source)
+      animated = animate.nil? ? config.animated? : animate
+
+      if animated
+        GifGenerator.new(config).generate(output, scale: scale, shadow: shadow, transparent: transparent, format: format)
+      else
+        Renderer.new(config).render(output, scale: scale, shadow: shadow, transparent: transparent, format: format)
+      end
+    end
+
+    def inspect_config(source, scale: 1, shadow: true)
+      config = parse(source)
+      geometry = Renderer.new(config).estimate(scale: scale, shadow: shadow)
+      { config: config.to_h, theme: config.theme, geometry: geometry, fonts: Renderer.new(config).font_info }
+    end
+  end
 end

data/schema/shellfie-v1.schema.json

@@ -0,0 +1,153 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/ydah/shellfie/main/schema/shellfie-v1.schema.json",
+  "title": "Shellfie compose configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "version": { "const": 1 },
+    "include": { "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] },
+    "include_policy": { "enum": ["allow", "root"] },
+    "theme": { "enum": ["macos", "ubuntu", "windows", "custom"] },
+    "window_theme": { "enum": ["macos", "ubuntu", "windows"] },
+    "color_scheme": { "enum": ["dracula", "one_dark", "solarized_dark", "catppuccin_mocha", null] },
+    "colors": {
+      "type": "object",
+      "propertyNames": { "enum": ["background", "foreground", "title_bar", "title_text", "title_bar_border", "border", "selection", "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "bright_black", "bright_red", "bright_green", "bright_yellow", "bright_blue", "bright_magenta", "bright_cyan", "bright_white"] },
+      "additionalProperties": { "type": "string" }
+    },
+    "window_decoration": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "title_bar_height": { "type": "number", "minimum": 0 },
+        "button_size": { "type": "number", "minimum": 0 },
+        "button_spacing": { "type": "number", "minimum": 0 },
+        "button_width": { "type": "number", "minimum": 0 },
+        "corner_radius": { "type": "number", "minimum": 0 },
+        "shadow": {
+          "type": "object", "additionalProperties": false,
+          "properties": {
+            "blur": { "type": "number", "minimum": 0 }, "offset_x": { "type": "number" },
+            "offset_y": { "type": "number" }, "color": { "type": "string" }
+          }
+        }
+      }
+    },
+    "title": { "type": "string" },
+    "headless": { "type": "boolean" },
+    "window": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "width": { "type": "integer", "minimum": 120 },
+        "height": { "type": ["integer", "null"], "minimum": 1 },
+        "padding": { "type": "integer", "minimum": 0, "maximum": 40 },
+        "opacity": { "type": "number", "minimum": 0, "maximum": 1 },
+        "visible_lines": { "type": ["integer", "null"], "minimum": 1 },
+        "max_lines": { "type": ["integer", "null"], "minimum": 1 },
+        "max_height": { "type": ["integer", "null"], "minimum": 1 },
+        "wrap": { "type": "boolean" },
+        "overflow": { "enum": ["clip", "wrap", "scroll"] },
+        "margin": { "type": ["integer", "null"], "minimum": 0 },
+        "exact_size": { "type": "boolean" },
+        "trim": { "type": "boolean" },
+        "tab_width": { "type": "integer", "minimum": 1 },
+        "ambiguous_width": { "enum": [1, 2] },
+        "osc_policy": { "enum": ["ignore", "preserve", "apply"] },
+        "graphics_policy": { "enum": ["ignore", "error"] },
+        "ansi_state": { "enum": ["persistent", "line"] },
+        "background_gradient": { "type": ["array", "null"], "minItems": 2, "maxItems": 2, "items": { "type": "string" } },
+        "scroll_offset": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "font": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "family": { "type": ["string", "null"] },
+        "size": { "type": "number", "exclusiveMinimum": 0 },
+        "line_height": { "type": "number", "exclusiveMinimum": 0 },
+        "fallback_family": { "type": ["string", "null"] },
+        "italic_family": { "type": ["string", "null"] },
+        "emoji_family": { "type": ["string", "null"] }
+      }
+    },
+    "animation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "typing_speed": { "type": "integer", "minimum": 0, "maximum": 86400000 },
+        "command_delay": { "type": "integer", "minimum": 0, "maximum": 86400000 },
+        "cursor_blink": { "type": "boolean" },
+        "loop": { "type": "boolean" },
+        "typing_jitter": { "type": "number", "minimum": 0, "maximum": 1 },
+        "seed": { "type": "integer", "minimum": 0, "maximum": 2147483647 },
+        "typing_chunk_size": { "type": "integer", "minimum": 1 },
+        "output_delay": { "type": "integer", "minimum": 0, "maximum": 86400000 },
+        "final_delay": { "type": "integer", "minimum": 0, "maximum": 86400000 },
+        "max_frames": { "type": ["integer", "null"], "minimum": 1 },
+        "dither": { "type": "boolean" },
+        "palette": { "enum": ["global", "adaptive", "theme"] },
+        "gif_colors": { "type": "integer", "minimum": 2, "maximum": 256 },
+        "gif_optimize": { "type": "boolean" },
+        "webp_lossless": { "type": "boolean" },
+        "webp_quality": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "webp_method": { "type": "integer", "minimum": 0, "maximum": 6 },
+        "webp_near_lossless": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "apng_prediction": { "enum": ["none", "sub", "up", "avg", "paeth", "mixed"] },
+        "loop_count": { "type": ["integer", "null"], "minimum": 0, "maximum": 65535 },
+        "direction": { "enum": ["forward", "reverse", "ping_pong"] },
+        "loop_offset": { "type": "integer", "minimum": 0 },
+        "scroll_easing": { "enum": ["linear", "ease_in", "ease_out", "ease_in_out"] },
+        "framerate": { "type": "integer", "minimum": 1, "maximum": 120 },
+        "playback_speed": { "type": "number", "exclusiveMinimum": 0, "maximum": 100 }
+      }
+    },
+    "cursor": {
+      "type": "object", "additionalProperties": false,
+      "properties": { "style": { "enum": ["block", "bar", "underline"] }, "color": { "type": ["string", "null"] } }
+    },
+    "limits": {
+      "type": "object", "additionalProperties": false,
+      "properties": {
+        "max_lines": { "type": "integer", "minimum": 1, "maximum": 10000 },
+        "max_frames": { "type": "integer", "minimum": 1, "maximum": 500 },
+        "max_render_frames": { "type": "integer", "minimum": 1, "maximum": 2000 },
+        "max_characters": { "type": "integer", "minimum": 1, "maximum": 200000 },
+        "max_pixels": { "type": "integer", "minimum": 1, "maximum": 50000000 },
+        "max_total_pixels": { "type": "integer", "minimum": 1, "maximum": 2000000000 },
+        "max_temp_bytes": { "type": "integer", "minimum": 1, "maximum": 8000000000 }
+      }
+    },
+    "lines": { "type": "array", "maxItems": 10000, "items": { "$ref": "#/$defs/line" } },
+    "frames": { "type": "array", "maxItems": 500, "items": { "$ref": "#/$defs/frame" } }
+  },
+  "anyOf": [{ "required": ["lines"] }, { "required": ["frames"] }],
+  "$defs": {
+    "line": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "prompt": { "type": "string" }, "command": { "type": "string" }, "output": { "type": "string" },
+        "prompt_color": { "type": "string" }, "command_color": { "type": "string" }, "output_color": { "type": "string" },
+        "selected": { "type": "boolean" }
+      },
+      "anyOf": [{ "required": ["prompt"] }, { "required": ["command"] }, { "required": ["output"] }]
+    },
+    "frame": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "prompt": { "type": "string" }, "type": { "type": "string" }, "output": { "type": "string" },
+        "screen": { "type": "array", "items": { "type": "string" } },
+        "delay": { "type": "integer", "minimum": 0, "maximum": 86400000 }, "prompt_color": { "type": "string" },
+        "command_color": { "type": "string" }, "output_color": { "type": "string" }
+      },
+      "allOf": [
+        { "anyOf": [{ "required": ["type"] }, { "required": ["output"] }, { "required": ["screen"] }, { "required": ["delay"] }] },
+        { "if": { "required": ["prompt"] }, "then": { "required": ["type"] } }
+      ]
+    }
+  }
+}

data/schema/shellfie-v2.schema.json

@@ -0,0 +1,262 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/ydah/shellfie/main/schema/shellfie-v2.schema.json",
+  "title": "Shellfie executable session",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version"],
+  "anyOf": [{ "required": ["steps"] }, { "required": ["include"] }],
+  "dependentRequired": { "include_policy": ["include"] },
+  "properties": {
+    "version": { "const": 2 },
+    "include": { "oneOf": [{ "type": "string" }, { "type": "array", "minItems": 1, "items": { "type": "string" } }] },
+    "include_policy": { "enum": ["allow", "root"] },
+    "mode": { "enum": ["run", "replay"] },
+    "title": { "type": "string" },
+    "theme": { "enum": ["macos", "ubuntu", "windows", "custom"] },
+    "vars": {
+      "type": "object", "maxProperties": 100,
+      "propertyNames": { "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
+      "additionalProperties": { "type": ["string", "number", "boolean", "null"] }
+    },
+    "step_sets": {
+      "type": "object", "maxProperties": 100,
+      "propertyNames": { "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
+      "additionalProperties": {
+        "type": "array", "items": { "oneOf": [{ "$ref": "#/$defs/step" }, { "$ref": "#/$defs/step_use" }] }
+      }
+    },
+    "terminal": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "shell": { "type": "string" }, "columns": { "type": "integer", "minimum": 1, "maximum": 500 },
+        "rows": { "type": "integer", "minimum": 1, "maximum": 200 }, "cwd": { "type": "string" },
+        "cwd_policy": { "enum": ["allow", "root"] },
+        "env": {
+          "type": "object",
+          "propertyNames": { "allOf": [{ "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" }, { "not": { "const": "PS1" } }] },
+          "additionalProperties": { "type": ["string", "null"] }
+        },
+        "env_allowlist": {
+          "type": ["array", "null"], "uniqueItems": true,
+          "items": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" }
+        },
+        "timeout": { "$ref": "#/$defs/duration" },
+        "total_timeout": { "oneOf": [{ "$ref": "#/$defs/duration" }, { "type": "null" }] },
+        "prompt": { "type": "string", "pattern": "\\S" }
+      }
+    },
+    "requires": { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z0-9_.+-]+$" } },
+    "steps": {
+      "type": "array", "maxItems": 10000,
+      "items": { "oneOf": [{ "$ref": "#/$defs/step" }, { "$ref": "#/$defs/step_use" }] },
+      "contains": { "type": "object", "required": ["capture"] }, "minContains": 0, "maxContains": 100
+    },
+    "outputs": { "type": "array", "items": { "$ref": "#/$defs/output" } },
+    "render": {
+      "type": "object", "additionalProperties": false,
+      "properties": {
+        "window": {
+          "$ref": "#/$defs/window"
+        },
+        "font": {
+          "$ref": "#/$defs/font"
+        },
+        "animation": {
+          "$ref": "#/$defs/animation"
+        },
+        "headless": { "type": "boolean" }
+      }
+    },
+    "redact": { "type": "array", "maxItems": 100, "items": { "type": "string", "maxLength": 512 } }
+  },
+  "$defs": {
+    "duration": {
+      "oneOf": [
+        { "type": "number", "exclusiveMinimum": 0, "maximum": 86400 },
+        {
+          "type": "string",
+          "pattern": "^(?=.{1,32}s?$)0*(?:0\\.[0-9]*[1-9][0-9]*|(?:[1-9][0-9]{0,3}|[1-7][0-9]{4}|8[0-5][0-9]{3}|86[0-3][0-9]{2})(?:\\.[0-9]+)?|86400(?:\\.0+)?)s?$"
+        },
+        {
+          "type": "string",
+          "pattern": "^(?=.{1,32}ms$)0*(?:0\\.[0-9]*[1-9][0-9]*|(?:[1-9][0-9]{0,6}|[1-7][0-9]{7}|8[0-5][0-9]{6}|86[0-3][0-9]{5})(?:\\.[0-9]+)?|86400000(?:\\.0+)?)ms$"
+        }
+      ]
+    },
+    "window": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "width": { "type": "integer", "minimum": 120 },
+        "height": { "type": ["integer", "null"], "minimum": 1 },
+        "padding": { "type": "integer", "minimum": 0, "maximum": 40 },
+        "opacity": { "type": "number", "minimum": 0, "maximum": 1 },
+        "visible_lines": { "type": ["integer", "null"], "minimum": 1 },
+        "max_lines": { "type": ["integer", "null"], "minimum": 1 },
+        "max_height": { "type": ["integer", "null"], "minimum": 1 },
+        "wrap": { "type": "boolean" },
+        "overflow": { "enum": ["clip", "wrap", "scroll"] },
+        "margin": { "type": ["integer", "null"], "minimum": 0 },
+        "exact_size": { "type": "boolean" },
+        "trim": { "type": "boolean" },
+        "tab_width": { "type": "integer", "minimum": 1 },
+        "ambiguous_width": { "enum": [1, 2] },
+        "osc_policy": { "enum": ["ignore", "preserve", "apply"] },
+        "graphics_policy": { "enum": ["ignore", "error"] },
+        "ansi_state": { "enum": ["persistent", "line"] },
+        "background_gradient": { "type": ["array", "null"], "minItems": 2, "maxItems": 2, "items": { "type": "string" } },
+        "scroll_offset": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "font": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "family": { "type": ["string", "null"] },
+        "size": { "type": "number", "exclusiveMinimum": 0 },
+        "line_height": { "type": "number", "exclusiveMinimum": 0 },
+        "fallback_family": { "type": ["string", "null"] },
+        "italic_family": { "type": ["string", "null"] },
+        "emoji_family": { "type": ["string", "null"] }
+      }
+    },
+    "animation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "typing_speed": { "type": "integer", "minimum": 0, "maximum": 86400000 },
+        "command_delay": { "type": "integer", "minimum": 0, "maximum": 86400000 },
+        "cursor_blink": { "type": "boolean" },
+        "loop": { "type": "boolean" },
+        "typing_jitter": { "type": "number", "minimum": 0, "maximum": 1 },
+        "seed": { "type": "integer", "minimum": 0, "maximum": 2147483647 },
+        "typing_chunk_size": { "type": "integer", "minimum": 1 },
+        "output_delay": { "type": "integer", "minimum": 0, "maximum": 86400000 },
+        "final_delay": { "type": "integer", "minimum": 0, "maximum": 86400000 },
+        "max_frames": { "type": ["integer", "null"], "minimum": 1 },
+        "dither": { "type": "boolean" },
+        "palette": { "enum": ["global", "adaptive", "theme"] },
+        "gif_colors": { "type": "integer", "minimum": 2, "maximum": 256 },
+        "gif_optimize": { "type": "boolean" },
+        "webp_lossless": { "type": "boolean" },
+        "webp_quality": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "webp_method": { "type": "integer", "minimum": 0, "maximum": 6 },
+        "webp_near_lossless": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "apng_prediction": { "enum": ["none", "sub", "up", "avg", "paeth", "mixed"] },
+        "loop_count": { "type": ["integer", "null"], "minimum": 0, "maximum": 65535 },
+        "direction": { "enum": ["forward", "reverse", "ping_pong"] },
+        "loop_offset": { "type": "integer", "minimum": 0 },
+        "scroll_easing": { "enum": ["linear", "ease_in", "ease_out", "ease_in_out"] },
+        "framerate": { "type": "integer", "minimum": 1, "maximum": 120 },
+        "playback_speed": { "type": "number", "exclusiveMinimum": 0, "maximum": 100 }
+      }
+    },
+    "step": {
+      "oneOf": [
+        { "type": "string", "enum": ["hide", "show"] },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "run": { "type": "string" }, "type": { "type": "string" }, "key": { "type": "string" },
+            "sleep": { "$ref": "#/$defs/duration" }, "wait": { "$ref": "#/$defs/wait" },
+            "expect": { "$ref": "#/$defs/expect" }, "capture": { "type": "string" },
+            "hide": { "const": true }, "show": { "const": true }, "visibility": { "enum": ["visible", "hidden"] },
+            "timeout": { "$ref": "#/$defs/duration" },
+            "speed": { "type": "string", "maxLength": 32, "pattern": "^0*(?:[1-9][0-9]{0,2}(?:\\.[0-9]+)?|1000(?:\\.0+)?)cps$" },
+            "count": { "type": "integer", "minimum": 1, "maximum": 10000 },
+            "async": { "type": "boolean" }, "cwd": { "type": "string" },
+            "delay": { "$ref": "#/$defs/duration" },
+            "repeat": { "type": "integer", "minimum": 1, "maximum": 10000 },
+            "if": { "$ref": "#/$defs/condition" }
+          },
+          "oneOf": [
+            { "required": ["run"] }, { "required": ["type"] }, { "required": ["key"] },
+            { "required": ["sleep"] }, { "required": ["wait"] }, { "required": ["expect"] },
+            { "required": ["capture"] }, { "required": ["hide"] }, { "required": ["show"] }
+          ],
+          "dependentRequired": { "visibility": ["run"], "speed": ["type"], "count": ["key"], "cwd": ["run"], "delay": ["key"] },
+          "allOf": [
+            { "if": { "required": ["async"] }, "then": { "anyOf": [{ "required": ["run"] }, { "required": ["key"] }] } },
+            { "if": { "required": ["timeout"] }, "then": { "anyOf": [{ "required": ["run"] }, { "required": ["key"] }, { "required": ["wait"] }] } },
+            { "not": { "required": ["run", "async", "visibility"], "properties": { "async": { "const": true }, "visibility": { "const": "hidden" } } } }
+          ]
+        }
+      ]
+    },
+    "step_use": {
+      "type": "object", "required": ["use"], "additionalProperties": false,
+      "properties": {
+        "use": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
+        "repeat": { "type": "integer", "minimum": 1, "maximum": 10000 },
+        "if": { "$ref": "#/$defs/condition" }
+      }
+    },
+    "condition": {
+      "type": "object", "minProperties": 1, "additionalProperties": false,
+      "properties": {
+        "os": {
+          "oneOf": [
+            { "enum": ["macos", "linux", "windows"] },
+            { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["macos", "linux", "windows"] } }
+          ]
+        },
+        "shell": { "type": "string" },
+        "ruby": { "type": "string" },
+        "env": { "type": "object", "additionalProperties": { "type": ["string", "null"] } }
+      }
+    },
+    "wait": {
+      "oneOf": [
+        { "type": "string", "maxLength": 512 },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "screen": { "type": "string", "maxLength": 512 }, "line": { "type": "string", "maxLength": 512 },
+            "prompt": { "const": true },
+            "stable": { "$ref": "#/$defs/duration" }, "exit": { "const": true },
+            "timeout": { "$ref": "#/$defs/duration" }
+          },
+          "oneOf": [
+            { "required": ["screen"] }, { "required": ["line"] }, { "required": ["prompt"] },
+            { "required": ["stable"] }, { "required": ["exit"] }
+          ]
+        }
+      ]
+    },
+    "expect": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "screen_contains": { "type": "string" }, "screen": { "type": "string", "maxLength": 512 },
+            "line": { "type": "string", "maxLength": 512 },
+            "exit_status": { "type": "integer", "minimum": 0, "maximum": 255 },
+            "cursor_row": { "type": "integer", "minimum": 0 },
+            "cursor_column": { "type": "integer", "minimum": 0 },
+            "golden": { "type": "string" },
+            "elapsed_under": { "$ref": "#/$defs/duration" }, "elapsed_over": { "$ref": "#/$defs/duration" }
+          },
+          "minProperties": 1
+        }
+      ]
+    },
+    "output": {
+      "type": "object",
+      "required": ["path"],
+      "additionalProperties": false,
+      "properties": {
+        "path": { "type": "string" },
+        "format": { "enum": ["png", "gif", "svg", "svg-raster", "webp", "apng", "mp4", "webm", "png-sequence", "html", "txt", "ansi", "json", "asciicast", "cast"] },
+        "animate": { "type": "boolean" }, "scale": { "type": "integer", "minimum": 1, "maximum": 3 },
+        "shadow": { "type": "boolean" }, "transparent": { "type": "boolean" },
+        "capture": { "type": "string" }
+      }
+    }
+  }
+}