RubyGems - ruact - Versions diffs - 0.0.10 → 0.0.12 - Mend

ruact 0.0.10 → 0.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (116) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +123 -48
data/CONTRIBUTING.md +233 -0
data/README.md +16 -6
data/RELEASING.md +125 -139
data/lib/ruact/packaging.rb +68 -0
data/lib/ruact/version.rb +1 -1
data/vendor/javascript/vite-plugin-ruact/flight-client.test.mjs +321 -0
data/vendor/javascript/vite-plugin-ruact/package-lock.json +11 -0
data/vendor/javascript/vite-plugin-ruact/package.json +1 -0
data/vendor/javascript/vite-plugin-ruact/runtime/flight-client.js +14 -3
metadata +6 -107
data/.codecov.yml +0 -31
data/.github/workflows/ci.yml +0 -284
data/.github/workflows/server-functions-bench.yml +0 -54
data/.rubocop.yml +0 -107
data/.rubocop_todo.yml +0 -63
data/Rakefile +0 -10
data/bench/server_functions_dispatch_bench.rb +0 -276
data/bench/server_functions_dispatch_bench.results.md +0 -150
data/docs/internal/README.md +0 -9
data/docs/internal/decisions/server-functions-api.md +0 -2236
data/spec/benchmarks/baseline.json +0 -1
data/spec/benchmarks/render_pipeline_benchmark_spec.rb +0 -92
data/spec/fixtures/flight/README.md +0 -136
data/spec/fixtures/flight/array.txt +0 -1
data/spec/fixtures/flight/as_json_object.txt +0 -2
data/spec/fixtures/flight/bigint.txt +0 -1
data/spec/fixtures/flight/boolean_false.txt +0 -1
data/spec/fixtures/flight/boolean_true.txt +0 -1
data/spec/fixtures/flight/client_component_with_props.txt +0 -2
data/spec/fixtures/flight/client_reference.txt +0 -2
data/spec/fixtures/flight/hash.txt +0 -1
data/spec/fixtures/flight/infinity.txt +0 -1
data/spec/fixtures/flight/nan.txt +0 -1
data/spec/fixtures/flight/negative_infinity.txt +0 -1
data/spec/fixtures/flight/nil.txt +0 -1
data/spec/fixtures/flight/number_float.txt +0 -1
data/spec/fixtures/flight/number_integer.txt +0 -1
data/spec/fixtures/flight/react_element_no_props.txt +0 -1
data/spec/fixtures/flight/redirect_row.txt +0 -1
data/spec/fixtures/flight/serializable_object.txt +0 -2
data/spec/fixtures/flight/string_basic.txt +0 -1
data/spec/fixtures/flight/string_dollar_escape.txt +0 -1
data/spec/fixtures/flight/undefined.txt +0 -1
data/spec/fixtures/readme/children-error.html.erb +0 -3
data/spec/fixtures/readme/children-error.txt +0 -1
data/spec/fixtures/story_7_9_views/controller_request_spec_support/demo/show.html.erb +0 -3
data/spec/fixtures/story_7_9_views/controller_request_spec_support/errors_demo/new.html.erb +0 -3
data/spec/fixtures/story_7_9_views/controller_request_spec_support/exploding_layout_demo/show.html.erb +0 -3
data/spec/fixtures/story_7_9_views/controller_request_spec_support/ghost_layout_demo/show.html.erb +0 -3
data/spec/fixtures/story_7_9_views/controller_request_spec_support/layout_demo/show.html.erb +0 -3
data/spec/fixtures/story_7_9_views/controller_request_spec_support/rootless_layout_demo/show.html.erb +0 -3
data/spec/fixtures/story_7_9_views/controller_request_spec_support/unwired_layout_demo/show.html.erb +0 -3
data/spec/fixtures/story_7_9_views/layouts/bare_host.html.erb +0 -16
data/spec/fixtures/story_7_9_views/layouts/exploding_host.html.erb +0 -24
data/spec/fixtures/story_7_9_views/layouts/rootless_host.html.erb +0 -15
data/spec/fixtures/story_7_9_views/layouts/ruact_host.html.erb +0 -17
data/spec/readme_demo_message_spec.rb +0 -67
data/spec/readme_spec.rb +0 -282
data/spec/ruact/client_manifest_spec.rb +0 -270
data/spec/ruact/component_contract_spec.rb +0 -119
data/spec/ruact/configuration_spec.rb +0 -518
data/spec/ruact/controller_request_spec.rb +0 -671
data/spec/ruact/controller_spec.rb +0 -343
data/spec/ruact/doctor_spec.rb +0 -769
data/spec/ruact/erb_preprocessor_hook_spec.rb +0 -55
data/spec/ruact/erb_preprocessor_spec.rb +0 -361
data/spec/ruact/errors_spec.rb +0 -93
data/spec/ruact/flight/renderer_spec.rb +0 -133
data/spec/ruact/flight/serializer_spec.rb +0 -494
data/spec/ruact/html_converter_spec.rb +0 -375
data/spec/ruact/install_generator_spec.rb +0 -1549
data/spec/ruact/layout_source_spec.rb +0 -108
data/spec/ruact/manifest_resolver_spec.rb +0 -174
data/spec/ruact/query_request_spec.rb +0 -706
data/spec/ruact/query_spec.rb +0 -105
data/spec/ruact/railtie_spec.rb +0 -155
data/spec/ruact/render_context_spec.rb +0 -58
data/spec/ruact/render_pipeline_concurrency_spec.rb +0 -78
data/spec/ruact/render_pipeline_spec.rb +0 -928
data/spec/ruact/scaffold_generator_spec.rb +0 -1849
data/spec/ruact/serializable_spec.rb +0 -179
data/spec/ruact/server_bucket_request_spec.rb +0 -785
data/spec/ruact/server_function_name_spec.rb +0 -53
data/spec/ruact/server_functions/backtrace_cleaner_spec.rb +0 -63
data/spec/ruact/server_functions/bucket_two_payload_spec.rb +0 -200
data/spec/ruact/server_functions/codegen_spec.rb +0 -397
data/spec/ruact/server_functions/error_payload_spec.rb +0 -222
data/spec/ruact/server_functions/error_suggestion_spec.rb +0 -79
data/spec/ruact/server_functions/introspection_spec.rb +0 -135
data/spec/ruact/server_functions/name_bridge_spec.rb +0 -212
data/spec/ruact/server_functions/query_context_spec.rb +0 -72
data/spec/ruact/server_functions/query_source_spec.rb +0 -193
data/spec/ruact/server_functions/railtie_integration_spec.rb +0 -215
data/spec/ruact/server_functions/rake_spec.rb +0 -86
data/spec/ruact/server_functions/route_source_spec.rb +0 -202
data/spec/ruact/server_functions/snapshot_spec.rb +0 -96
data/spec/ruact/server_functions/snapshot_writer_spec.rb +0 -71
data/spec/ruact/server_rescue_request_spec.rb +0 -416
data/spec/ruact/server_spec.rb +0 -179
data/spec/ruact/server_upload_request_spec.rb +0 -311
data/spec/ruact/signed_references_spec.rb +0 -164
data/spec/ruact/string_distance_spec.rb +0 -38
data/spec/ruact/tasks_json_introspection_spec.rb +0 -141
data/spec/ruact/testing/have_ruact_component_spec.rb +0 -170
data/spec/ruact/testing/no_production_load_spec.rb +0 -41
data/spec/ruact/validation_errors_spec.rb +0 -116
data/spec/ruact/view_helper_spec.rb +0 -131
data/spec/spec_helper.rb +0 -77
data/spec/support/fixtures/pixel.png +0 -0
data/spec/support/flight_wire_parser.rb +0 -21
data/spec/support/flight_wire_parser_spec.rb +0 -93
data/spec/support/matchers/flight_fixture_matcher.rb +0 -130
data/spec/support/matchers/flight_fixture_matcher_spec.rb +0 -250
data/spec/support/rails_stub.rb +0 -115

data/spec/ruact/testing/have_ruact_component_spec.rb DELETED Viewed

@@ -1,170 +0,0 @@
-# frozen_string_literal: true
-require "spec_helper"
-require "ruact/testing"
-# Story 15.4 (FR108) — end-to-end specs for the PUBLIC render-assertion matcher
-# `have_ruact_component`. Every example asserts against a REAL Flight wire body
-# produced by `Ruact::RenderPipeline` (the same serializer the controller runs),
-# not a hand-authored fixture — so import rows, `$L<id>` references, and the
-# serialized props hash are exactly what a host would receive.
-module Ruact
-  RSpec.describe "have_ruact_component matcher", :story_15_4 do
-    let(:manifest) do
-      ClientManifest.from_hash({
-                                 "LikeButton" => {
-                                   "id" => "/assets/LikeButton-abc.js",
-                                   "name" => "LikeButton",
-                                   "chunks" => ["/assets/LikeButton-abc.js"]
-                                 },
-                                 "PostCard" => {
-                                   "id" => "/components/PostCard.jsx",
-                                   "name" => "PostCard",
-                                   "chunks" => ["/components/PostCard.jsx"]
-                                 }
-                               })
-    end
-    let(:pipeline) { RenderPipeline.new(manifest) }
-    # Renders an ERB snippet to a REAL Flight wire string.
-    def render_wire(erb_source, **ivars)
-      ctx = Object.new
-      ivars.each { |k, v| ctx.instance_variable_set("@#{k}", v) }
-      pipeline.render({ erb: erb_source, binding: ctx.instance_eval { binding } }, mode: :string)
-    end
-    # Wraps a wire in the REAL HTML shell the gem emits (`__FLIGHT_DATA` push),
-    # via the shipped `Ruact::ViewHelper#ruact_flight_data_script`.
-    def html_shell(wire)
-      emitter = Object.new.extend(Ruact::ViewHelper)
-      script = emitter.send(:ruact_flight_data_script, wire)
-      "<!DOCTYPE html><html><body><div id=\"root\"></div>#{script}</body></html>"
-    end
-    # A minimal duck-typed response object exposing `.body` (+ optional
-    # `.content_type`), like an ActionDispatch/Rack response.
-    def response_double(body, content_type: nil)
-      Struct.new(:body, :content_type).new(body, content_type)
-    end
-    describe "presence (raw text/x-component body)" do
-      it "passes when the named component was rendered" do
-        wire = render_wire("<LikeButton postId={42} />")
-        expect(wire).to have_ruact_component("LikeButton")
-      end
-      it "resolves the name by module basename too (D3)" do
-        wire = render_wire("<PostCard title={\"Hi\"} />")
-        # Manifest module path is /components/PostCard.jsx → basename PostCard.
-        expect(wire).to have_ruact_component("PostCard")
-      end
-      it "fails with a legible message naming what was found when absent" do
-        wire = render_wire("<LikeButton />")
-        expect do
-          expect(wire).to have_ruact_component("Missing")
-        end.to raise_error(RSpec::Expectations::ExpectationNotMetError,
-                           /component named "Missing".*found.*LikeButton/m)
-      end
-      it "supports negation for an absent component" do
-        wire = render_wire("<LikeButton />")
-        expect(wire).not_to have_ruact_component("Missing")
-      end
-      it "negation fails legibly when the component IS present" do
-        wire = render_wire("<LikeButton />")
-        expect do
-          expect(wire).not_to have_ruact_component("LikeButton")
-        end.to raise_error(RSpec::Expectations::ExpectationNotMetError, /NOT to have rendered.*"LikeButton"/m)
-      end
-    end
-    describe ".with_props (serialized wire form, D4)" do
-      it "passes when props satisfy a hash_including matcher" do
-        wire = render_wire("<LikeButton postId={42} />")
-        expect(wire).to have_ruact_component("LikeButton").with_props(a_hash_including("postId" => 42))
-      end
-      it "passes with a bare key-presence include matcher" do
-        wire = render_wire("<LikeButton postId={42} />")
-        expect(wire).to have_ruact_component("LikeButton").with_props(including("postId"))
-      end
-      it "fails with a legible message when props mismatch" do
-        wire = render_wire("<LikeButton postId={42} />")
-        expect do
-          expect(wire).to have_ruact_component("LikeButton").with_props(a_hash_including("postId" => 99))
-        end.to raise_error(RSpec::Expectations::ExpectationNotMetError,
-                           /props matching.*serialized wire form.*"postId".*42/m)
-      end
-      it "supports negation with props" do
-        wire = render_wire("<LikeButton postId={42} />")
-        expect(wire).not_to have_ruact_component("LikeButton").with_props(a_hash_including("postId" => 99))
-      end
-    end
-    describe "input shapes (D2)" do
-      it "accepts a response object exposing #body (raw wire)" do
-        wire = render_wire("<LikeButton postId={7} />")
-        response = response_double(wire, content_type: "text/x-component")
-        expect(response).to have_ruact_component("LikeButton").with_props(a_hash_including("postId" => 7))
-      end
-      it "extracts Flight from an HTML shell embedding __FLIGHT_DATA" do
-        wire = render_wire("<LikeButton postId={5} />")
-        html = html_shell(wire)
-        expect(html).to have_ruact_component("LikeButton").with_props(a_hash_including("postId" => 5))
-      end
-      it "ignores an unrelated earlier .push and anchors to __FLIGHT_DATA" do
-        wire = render_wire("<LikeButton postId={5} />")
-        shell = html_shell(wire)
-        # A realistic layout has other scripts BEFORE the ruact bootstrap.
-        noise = %(<script>window.dataLayer=window.dataLayer||[];dataLayer.push("not flight");</script>)
-        html = shell.sub("<div id=\"root\"></div>", "<div id=\"root\"></div>#{noise}")
-        expect(html).to have_ruact_component("LikeButton").with_props(a_hash_including("postId" => 5))
-      end
-      it "extracts Flight from an HTML-response object (content_type text/html)" do
-        wire = render_wire("<LikeButton postId={5} />")
-        response = response_double(html_shell(wire), content_type: "text/html; charset=utf-8")
-        expect(response).to have_ruact_component("LikeButton")
-      end
-      it "raises a clear error on a plain-JSON function-call body" do
-        json = response_double(%({"id":1,"title":"Hi"}), content_type: "application/json")
-        expect do
-          expect(json).to have_ruact_component("PostCard")
-        end.to raise_error(Ruact::Testing::NotAFlightResponseError, /plain-JSON response.*JSON\.parse/m)
-      end
-      it "raises a clear error on an empty (204) body" do
-        empty = response_double("", content_type: nil)
-        expect do
-          expect(empty).to have_ruact_component("PostCard")
-        end.to raise_error(Ruact::Testing::NotAFlightResponseError, /empty response body/m)
-      end
-      it "raises a clear error when handed an HTML doc with no Flight payload" do
-        html = "<!DOCTYPE html><html><body><h1>Nothing here</h1></body></html>"
-        expect do
-          expect(html).to have_ruact_component("PostCard")
-        end.to raise_error(Ruact::Testing::NotAFlightResponseError, /no `__FLIGHT_DATA` payload/m)
-      end
-    end
-    describe "escape round-trip through the HTML shell" do
-      it "recovers a payload containing quotes and interpolation-like sequences" do
-        # Props whose serialized form contains characters Ruby's #inspect
-        # escapes (`"`, `#{`, newlines) must survive extraction from the shell.
-        wire = render_wire("<LikeButton label={@label} />", label: %(a "quoted" \#{literal}\nvalue))
-        html = html_shell(wire)
-        expect(html).to have_ruact_component("LikeButton")
-          .with_props(a_hash_including("label" => a_string_matching(/quoted/)))
-      end
-    end
-  end
-end

data/spec/ruact/testing/no_production_load_spec.rb DELETED Viewed

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-require "spec_helper"
-require "English"
-require "shellwords"
-# Story 15.4 (FR108), AC4c + AC2 — the public test surface must not load in a
-# production boot, and the promoted parser/diff must be the SINGLE shipped
-# implementation the internal `Ruact::Spec` matchers share (wrap, not fork).
-module Ruact
-  RSpec.describe "Ruact::Testing load boundary", :story_15_4 do
-    it "a bare `require \"ruact\"` does NOT define the public test surface" do
-      # Shell out to a pristine Ruby process so nothing this suite already
-      # loaded (spec/support requires `ruact/testing/*`) pollutes the check.
-      lib = File.expand_path("../../../lib", __dir__)
-      script = <<~RUBY
-        $LOAD_PATH.unshift(#{lib.inspect})
-        require "ruact"
-        defined = Ruact.const_defined?(:Testing, false)
-        # `have_ruact_component` must not be registered on the RSpec matcher surface either.
-        rspec_loaded = $LOADED_FEATURES.any? { |f| f.include?("rspec/expectations") }
-        print [defined, rspec_loaded].inspect
-      RUBY
-      output = `#{RbConfig.ruby} -e #{Shellwords.escape(script)} 2>&1`
-      expect($CHILD_STATUS).to be_success, "subprocess failed: #{output}"
-      expect(output).to eq("[false, false]"),
-                        "expected `require \"ruact\"` to leave Ruact::Testing undefined and " \
-                        "RSpec unloaded, got: #{output}"
-    end
-    it "shares ONE implementation with the internal matchers (no fork)" do
-      require "ruact/testing"
-      require_relative "../../support/flight_wire_parser"
-      require_relative "../../support/matchers/flight_fixture_matcher"
-      expect(Ruact::Spec::FlightWireParser).to equal(Ruact::Testing::FlightWireParser)
-      expect(Ruact::Spec::FlightStructureDiff).to equal(Ruact::Testing::FlightStructureDiff)
-    end
-  end
-end

data/spec/ruact/validation_errors_spec.rb DELETED Viewed

@@ -1,116 +0,0 @@
-# frozen_string_literal: true
-# Story 13.3 (FR98) — unit specs for the pure validation-error normalizer
-# Ruact::ServerFunctions::ValidationErrors.normalize. The normalizer turns an
-# ActiveModel-ish record, a raw ActiveModel::Errors, or a pre-shaped Hash into
-# the canonical wire shape `{ [attribute: String] => Array<String> }` (full
-# messages, `base` key, `{}` on a valid/empty/nil source, idempotent on
-# already-canonical input). Pure — no Rails/request/Ruact.config reads.
-require "spec_helper"
-require "active_model"
-require "ruact/server_functions/validation_errors"
-module Ruact
-  module ServerFunctions
-    RSpec.describe ValidationErrors, :story_13_3 do
-      # A minimal ActiveModel record so the normalizer can exercise the real
-      # `errors.group_by_attribute` / `ActiveModel::Error#full_message` API
-      # (present since Rails 6.1; gem pins `rails ~> 8.0`).
-      let(:record_class) do
-        Class.new do
-          include ActiveModel::Model
-          include ActiveModel::Attributes
-          attribute :title, :string
-          attribute :body, :string
-          def self.name = "ValidationErrorsSpecPost"
-        end
-      end
-      describe ".normalize" do
-        context "with a record responding to #errors" do
-          it "returns the canonical { attr => [full_message] } shape" do
-            record = record_class.new
-            record.errors.add(:title, :blank) # "Title can't be blank"
-            expect(described_class.normalize(record)).to eq("title" => ["Title can't be blank"])
-          end
-          it "keys base-level errors under the string 'base' with the bare message" do
-            record = record_class.new
-            record.errors.add(:base, "is invalid overall")
-            expect(described_class.normalize(record)).to eq("base" => ["is invalid overall"])
-          end
-          it "groups multiple attributes and multiple messages per attribute" do
-            record = record_class.new
-            record.errors.add(:title, :blank)              # "Title can't be blank"
-            record.errors.add(:title, "is too short")      # "Title is too short"
-            record.errors.add(:body, "is invalid")         # "Body is invalid"
-            expect(described_class.normalize(record)).to eq(
-              "title" => ["Title can't be blank", "Title is too short"],
-              "body" => ["Body is invalid"]
-            )
-          end
-          it "returns {} for a record with no errors (success symmetry)" do
-            expect(described_class.normalize(record_class.new)).to eq({})
-          end
-        end
-        context "with a raw ActiveModel::Errors" do
-          it "normalizes the Errors object directly" do
-            record = record_class.new
-            record.errors.add(:title, :blank)
-            expect(described_class.normalize(record.errors)).to eq("title" => ["Title can't be blank"])
-          end
-        end
-        context "with a pre-shaped Hash" do
-          it "stringifies keys and leaves canonical array values untouched (idempotent)" do
-            canonical = { "title" => ["Title can't be blank"] }
-            expect(described_class.normalize(canonical)).to eq(canonical)
-          end
-          it "stringifies symbol keys" do
-            expect(described_class.normalize(title: ["x"])).to eq("title" => ["x"])
-          end
-          it "coerces a scalar value into a one-element array" do
-            expect(described_class.normalize("title" => "can't be blank")).to eq("title" => ["can't be blank"])
-          end
-          it "coerces non-string message values to strings" do
-            expect(described_class.normalize("count" => [1, 2])).to eq("count" => %w[1 2])
-          end
-          it "returns {} for an empty Hash" do
-            expect(described_class.normalize({})).to eq({})
-          end
-        end
-        context "with nil / empty sources" do
-          it "returns {} for nil" do
-            expect(described_class.normalize(nil)).to eq({})
-          end
-        end
-        it "is idempotent — normalizing its own output yields the same Hash" do
-          record = record_class.new
-          record.errors.add(:title, :blank)
-          record.errors.add(:base, "is invalid overall")
-          once = described_class.normalize(record)
-          expect(described_class.normalize(once)).to eq(once)
-        end
-      end
-    end
-  end
-end

data/spec/ruact/view_helper_spec.rb DELETED Viewed

@@ -1,131 +0,0 @@
-# frozen_string_literal: true
-require "spec_helper"
-require "active_support/core_ext/string/output_safety"
-require "active_support/string_inquirer"
-module Ruact
-  RSpec.describe ViewHelper do
-    let(:render_context) { RenderContext.new }
-    let(:helper_obj) do
-      obj = Object.new
-      obj.extend(described_class)
-      obj.instance_variable_set(:@ruact_render_context, render_context)
-      obj
-    end
-    describe "#__ruact_component__" do
-      it "registers the component in the render context and returns an HTML comment" do
-        result = helper_obj.__ruact_component__("NavBar", { "currentUser" => 1 })
-        expect(result).to match(/<!-- __RUACT_\d+__ -->/)
-        expect(render_context.components.length).to eq(1)
-        expect(render_context.components.first[:name]).to eq("NavBar")
-        expect(render_context.components.first[:props]).to eq({ "currentUser" => 1 })
-      end
-      it "returns an html_safe string so ActionView does not escape the comment" do
-        result = helper_obj.__ruact_component__("Button", {})
-        expect(result).to be_html_safe
-      end
-      it "uses incrementing token numbers for successive registrations" do
-        token0 = helper_obj.__ruact_component__("Foo", {})
-        token1 = helper_obj.__ruact_component__("Bar", {})
-        expect(token0).to include("__RUACT_0__")
-        expect(token1).to include("__RUACT_1__")
-      end
-      it "passes props through to the registry entry" do
-        helper_obj.__ruact_component__("LikeButton", { "postId" => 42, "label" => "Like" })
-        entry = render_context.components.first
-        expect(entry[:props]["postId"]).to eq(42)
-        expect(entry[:props]["label"]).to eq("Like")
-      end
-      it "raises a clear error when called outside a ruact_render flow" do
-        bare = Object.new
-        bare.extend(described_class)
-        expect { bare.__ruact_component__("NavBar", {}) }
-          .to raise_error(Ruact::Error, /__ruact_component__ called outside a ruact_render flow/)
-      end
-    end
-    # Story 14.2 (FR104) — the public JS-asset helper. Emits the dev/prod
-    # bootstrap entry `<script>` tags (re-targeting `virtual:ruact/bootstrap`)
-    # plus the `__FLIGHT_DATA` inline script. The controller delegates to this
-    # one implementation (parity asserted in controller_spec).
-    describe "#ruact_js_assets", :story_14_2 do
-      let(:asset_helper) do
-        obj = Object.new
-        obj.extend(described_class)
-        obj
-      end
-      let(:payload) { "0:[\"$\",\"div\",null,{}]\n" }
-      context "when in dev with the Vite dev server running" do
-        before do
-          allow(Rails).to receive(:env).and_return(ActiveSupport::StringInquirer.new("development"))
-          allow(asset_helper).to receive(:vite_dev_running?).and_return(true)
-        end
-        it "emits the react-refresh preamble, @vite/client, and the bootstrap module", :aggregate_failures do
-          html = asset_helper.ruact_js_assets(payload)
-          expect(html).to include("__vite_plugin_react_preamble_installed__")
-          expect(html).to include("http://localhost:5173/@vite/client")
-          # Targets the virtual entry at the dev server's /@id/__x00__ URL — NOT
-          # a stale application.jsx path.
-          expect(html).to include("/@id/__x00__#{Ruact.bootstrap_virtual_id}")
-          expect(html).not_to include("application.jsx")
-        end
-        it "includes the __FLIGHT_DATA inline bootstrap script", :aggregate_failures do
-          html = asset_helper.ruact_js_assets(payload)
-          expect(html).to include("__FLIGHT_DATA")
-          expect(html).to include("d.push(")
-        end
-        it "returns an html_safe buffer" do
-          expect(asset_helper.ruact_js_assets(payload)).to be_html_safe
-        end
-      end
-      context "when in prod (Vite manifest lookup)" do
-        before do
-          allow(Rails).to receive(:env).and_return(ActiveSupport::StringInquirer.new("production"))
-        end
-        it "looks up the manifest with the SAME id the generated vite.config input uses (AC3 — no drift)" do
-          allow(asset_helper).to receive(:vite_manifest_entry).and_return(nil)
-          asset_helper.ruact_js_assets(payload)
-          expect(asset_helper).to have_received(:vite_manifest_entry).with(Ruact.bootstrap_virtual_id)
-        end
-        it "emits the hashed bootstrap URL from the manifest entry", :aggregate_failures do
-          allow(asset_helper).to receive(:vite_manifest_entry)
-            .with(Ruact.bootstrap_virtual_id).and_return({ "file" => "bootstrap-abc123.js" })
-          html = asset_helper.ruact_js_assets(payload)
-          expect(html).to include(%(src="/assets/bootstrap-abc123.js"))
-          expect(html).to include("__FLIGHT_DATA")
-        end
-        it "falls back to /assets/application.js when the manifest entry is missing" do
-          allow(asset_helper).to receive(:vite_manifest_entry).and_return(nil)
-          expect(asset_helper.ruact_js_assets(payload)).to include("/assets/application.js")
-        end
-      end
-      context "without a Flight payload (entry tags only)" do
-        before do
-          allow(Rails).to receive(:env).and_return(ActiveSupport::StringInquirer.new("production"))
-          allow(asset_helper).to receive(:vite_manifest_entry).and_return(nil)
-        end
-        it "emits only the entry tag (no __FLIGHT_DATA)", :aggregate_failures do
-          html = asset_helper.ruact_js_assets
-          expect(html).not_to include("__FLIGHT_DATA")
-          expect(html).to include("<script type=\"module\"")
-        end
-      end
-    end
-  end
-end

data/spec/spec_helper.rb DELETED Viewed

@@ -1,77 +0,0 @@
-# frozen_string_literal: true
-require "simplecov"
-require "simplecov-lcov"
-SimpleCov::Formatter::LcovFormatter.config do |c|
-  c.report_with_single_file = true
-  c.single_report_path = "coverage/lcov.info"
-end
-SimpleCov.start do
-  enable_coverage :branch
-  primary_coverage :line
-  formatter SimpleCov::Formatter::MultiFormatter.new(
-    [
-      SimpleCov::Formatter::HTMLFormatter,
-      SimpleCov::Formatter::LcovFormatter
-    ]
-  )
-  add_filter %r{^/spec/}
-  add_filter %r{^/bin/}
-  add_filter %r{lib/generators/.+/templates/}
-  add_filter "lib/ruact/version.rb"
-end
-require "logger"
-require "ruact"
-Dir[File.join(__dir__, "support", "**", "*.rb")].each do |f|
-  next if f.end_with?("_spec.rb") # spec files are loaded by the RSpec runner; avoid double registration
-  require f
-end
-RSpec.configure do |config|
-  config.order = :random
-  config.expect_with :rspec do |expectations|
-    expectations.max_formatted_output_length = 2000
-  end
-  config.mock_with :rspec do |mocks|
-    mocks.verify_partial_doubles = true
-  end
-  # Story 7.3: Ruact.config is a frozen singleton with a boot-state flag for the
-  # re-configuration warning. Reset both before every example so the boot flag
-  # cannot leak between specs — otherwise the AC3 warning may fire into a
-  # Rails.logger that has become a per-example RSpec double from an earlier
-  # spec, producing "originally created in one example but has leaked" failures
-  # under random order.
-  config.before do
-    Ruact.instance_variable_set(:@config, nil)
-    Ruact.instance_variable_set(:@configured_at_least_once, false)
-    # Story 9.3: specs that set `Rails.logger = instance_double(Logger)` (e.g.
-    # railtie_spec, configuration_spec) leave a per-example double on the global
-    # after they finish; rspec then refuses to call it from the NEXT example.
-    # That was harmless until the codegen/rake paths began reading `Rails.logger`
-    # (the `[ruact] codegen: exposing …` line). Reset it to a real, silent logger
-    # before every example so no leaked double survives — examples that need a
-    # specific logger set their own in their own `before` (which runs after this).
-    Rails.logger = Logger.new(IO::NULL) if defined?(Rails) && Rails.respond_to?(:logger=)
-    # Manifest-over-HTTP fix: the gem suite runs with `Rails.env == development`
-    # by default, where `Ruact::ManifestResolver` would otherwise fetch the live
-    # manifest from the Vite dev server (localhost:5173) on every ActionView
-    # render — making the suite hit the network and go flaky on a dev machine
-    # that happens to run a foreign Vite there. Pin the pre-fix behaviour (return
-    # the boot-loaded `Ruact.manifest`) so the whole suite is hermetic. The
-    # resolver's own spec re-stubs these `.and_call_original` to exercise the real
-    # HTTP/fallback paths with `Net::HTTP` mocked. (The programmatic
-    # `RenderPipeline#render({erb:})` path passes `registry: nil` and never
-    # touches the resolver, so the benchmark measures the real render cost.)
-    if defined?(Ruact::ManifestResolver)
-      allow(Ruact::ManifestResolver).to receive(:resolve) { Ruact.manifest }
-      allow(Ruact::ManifestResolver).to receive(:resolve_soft) { Ruact.manifest }
-    end
-  end
-end

data/spec/support/fixtures/pixel.png DELETED Viewed

Binary file

data/spec/support/flight_wire_parser.rb DELETED Viewed

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-# Story 15.4 (FR108) — the pure Flight wire parser was PROMOTED onto the gem's
-# `lib/` load path as `Ruact::Testing::FlightWireParser` so the new public
-# `have_ruact_component` matcher and the gem's own internal matchers share ONE
-# implementation (wrap, not fork). This file is now a thin shim: it loads the
-# promoted implementation and re-exports it under the historical test-only
-# `Ruact::Spec` namespace so the existing internal matcher wrappers and their
-# self-tests keep working unchanged.
-require "ruact/testing/flight_wire_parser"
-module Ruact
-  # Test-support utilities. Code under `Ruact::Spec` is consumed only by the
-  # gem's own RSpec suite; it is not part of the public API and may change
-  # shape across stories without a deprecation cycle. The parser/diff it names
-  # are aliases for the shipped `Ruact::Testing::*` implementation.
-  module Spec
-    FlightWireParser = Ruact::Testing::FlightWireParser
-    FlightWireParseError = Ruact::Testing::FlightWireParseError
-  end
-end

data/spec/support/flight_wire_parser_spec.rb DELETED Viewed

@@ -1,93 +0,0 @@
-# frozen_string_literal: true
-require "spec_helper"
-require_relative "flight_wire_parser"
-module Ruact
-  module Spec
-    RSpec.describe FlightWireParser do
-      describe ".parse" do
-        it "parses a single model row" do
-          rows = described_class.parse(%(0:{"className":"box"}\n))
-          expect(rows).to eq([
-                               {
-                                 id: 0,
-                                 class: :model,
-                                 payload: { "className" => "box" },
-                                 raw: %(0:{"className":"box"}\n)
-                               }
-                             ])
-        end
-        it "parses a single import row and decodes the hex id" do
-          rows = described_class.parse(%(a:I["/L.jsx","L",["/L.jsx"]]\n))
-          expect(rows.length).to eq(1)
-          expect(rows.first).to include(
-            id: 10,
-            class: :import,
-            payload: ["/L.jsx", "L", ["/L.jsx"]]
-          )
-        end
-        it "parses a single error row" do
-          rows = described_class.parse(%(2:E{"message":"boom"}\n))
-          expect(rows.first).to include(
-            id: 2,
-            class: :error,
-            payload: { "message" => "boom" }
-          )
-        end
-        it "parses a hint row with no id" do
-          rows = described_class.parse(%(:HL"/preload.js"\n))
-          expect(rows.first).to include(
-            id: nil,
-            class: :hint,
-            payload: ["L", "/preload.js"]
-          )
-        end
-        it "parses a T row of exactly LARGE_TEXT_THRESHOLD bytes followed by a model row that references it" do
-          large_text = "a" * 1024
-          wire = "1:T#{1024.to_s(16)},#{large_text}0:\"$T1\"\n"
-          rows = described_class.parse(wire)
-          expect(rows.length).to eq(2)
-          expect(rows[0]).to include(id: 1, class: :text, payload: large_text)
-          expect(rows[1]).to include(id: 0, class: :model, payload: "$T1")
-        end
-        it "parses a mixed-row sequence preserving wire order" do
-          wire = %(1:I["/L.jsx","L",["/L.jsx"]]\n0:["$","$L1",null,{}]\n)
-          rows = described_class.parse(wire)
-          expect(rows.map { |r| [r[:id], r[:class]] }).to eq([[1, :import], [0, :model]])
-        end
-        it "parses empty input as an empty array" do
-          expect(described_class.parse("")).to eq([])
-        end
-        it "raises FlightWireParseError naming the byte offset on malformed JSON" do
-          wire = %(0:{not-json}\n)
-          expect { described_class.parse(wire) }
-            .to raise_error(FlightWireParseError, /cannot parse row at offset \d+/)
-        end
-        it "raises FlightWireParseError when a T row is truncated" do
-          wire = "0:T#{10.to_s(16)},abc" # claims 16 bytes but provides 3
-          expect { described_class.parse(wire) }
-            .to raise_error(FlightWireParseError, /cannot parse row at offset 0: T row truncated/)
-        end
-      end
-    end
-  end
-end