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

ruact 0.0.11 → 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 +110 -48
data/CONTRIBUTING.md +233 -0
data/README.md +14 -4
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 -12
data/spec/benchmarks/render_pipeline_benchmark_spec.rb +0 -109
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/layout_source_spec.rb DELETED Viewed

@@ -1,108 +0,0 @@
-# frozen_string_literal: true
-require "spec_helper"
-require "ruact"
-# The single definition of "is this layout migrated?", shared by the runtime and
-# by `ruact:install`. Every example here is a shape that fooled an earlier,
-# looser check — a NAME where only a CALL counts, or a substring where only an
-# attribute counts.
-RSpec.describe Ruact::LayoutSource do
-  describe ".wired?" do
-    it "accepts a plain output tag" do
-      expect(described_class.wired?("<%= ruact_js_assets %>")).to be true
-    end
-    it "accepts the raw-output form and tight whitespace" do
-      expect(described_class.wired?("<%==ruact_js_assets%>")).to be true
-    end
-    it "accepts a call with an argument" do
-      expect(described_class.wired?("<%= ruact_js_assets(payload) %>")).to be true
-    end
-    # Round-1 finding: a mention in prose read as wired.
-    it "rejects a mention inside an ERB comment" do
-      expect(described_class.wired?("<%# remember to add ruact_js_assets here %>")).to be false
-    end
-    # Round-2 finding, and the sharper version of the same mistake: a genuinely
-    # COMMENTED-OUT call. ERB comments do not nest, so this emits nothing — but
-    # a regex looking only for `<%=` sees a call and reports the layout ready,
-    # which sends the runtime off to render an unmigrated layout.
-    it "rejects a commented-out call" do
-      expect(described_class.wired?("<%# <%= ruact_js_assets %> %>")).to be false
-    end
-    it "rejects a multi-line comment that wraps a call" do
-      source = <<~ERB
-        <%#
-          disabled for now:
-          <%= ruact_js_assets %>
-        %>
-      ERB
-      expect(described_class.wired?(source)).to be false
-    end
-    it "still sees a real call that follows a comment mentioning it" do
-      expect(described_class.wired?("<%# ruact_js_assets %>\n<%= ruact_js_assets %>")).to be true
-    end
-    # Round-3 finding: ERB's trim-mode comment (`<%-# ... -%>`) is a comment in
-    # Erubi too — verified by compiling it — but the stripper only knew `<%#`,
-    # so a call disabled this way read as wired.
-    it "rejects a call disabled with a trim-mode comment" do
-      expect(described_class.wired?("<%-# <%= ruact_js_assets %> -%>")).to be false
-    end
-    # Round-3 finding, the other direction: forbidding `%` before the name to
-    # avoid crossing tag boundaries also rejected legitimate calls. A false
-    # "unwired" is safer than a false "wired", but it is still a wrong answer —
-    # the app would silently keep ruact's CSS-less shell.
-    it "accepts a call whose expression contains a percent sign" do
-      expect(described_class.wired?(%(<%= raw("100%") + ruact_js_assets %>))).to be true
-      expect(described_class.wired?("<%= ruact_js_assets if 50 % 2 == 0 %>")).to be true
-    end
-    it "still refuses to match across a tag boundary" do
-      expect(described_class.wired?("<%= something %> then a bare ruact_js_assets mention")).to be false
-    end
-    it "rejects a layout that never names it" do
-      expect(described_class.wired?("<html><body><%= yield %></body></html>")).to be false
-    end
-  end
-  describe ".root?" do
-    it "accepts the emitted form" do
-      expect(described_class.root?(%(<div id="root"></div>))).to be true
-    end
-    it "accepts single quotes, extra attributes and unquoted values" do
-      expect(described_class.root?(%(<div id='root'></div>))).to be true
-      expect(described_class.root?(%(<div class="a" id="root" data-x="1"></div>))).to be true
-      expect(described_class.root?(%(<div id=root></div>))).to be true
-    end
-    # Round-2 finding: `data-id="root"` is not a mount point, and a document
-    # carrying one but no real root gives React nothing to mount into.
-    it "rejects a look-alike attribute" do
-      expect(described_class.root?(%(<body data-id="root"></body>))).to be false
-    end
-    it "rejects a different id that merely starts with root" do
-      expect(described_class.root?(%(<div id="rootish"></div>))).to be false
-    end
-  end
-  # The anchor `ruact:install` injects after.
-  describe "::ROOT_ELEMENT" do
-    it "anchors on a whole empty root div" do
-      expect(described_class::ROOT_ELEMENT).to match(%(<div id="root"></div>))
-    end
-    it "does not anchor on a look-alike attribute" do
-      expect(described_class::ROOT_ELEMENT).not_to match(%(<div data-id="root"></div>))
-    end
-  end
-end

data/spec/ruact/manifest_resolver_spec.rb DELETED Viewed

@@ -1,174 +0,0 @@
-# frozen_string_literal: true
-require "spec_helper"
-require "net/http"
-require "tmpdir"
-module Ruact
-  RSpec.describe ManifestResolver do
-    # spec_helper pins resolve/resolve_soft to the boot manifest suite-wide for
-    # hermeticity; this spec is the one place that exercises the REAL paths.
-    before do
-      allow(described_class).to receive(:resolve).and_call_original
-      allow(described_class).to receive(:resolve_soft).and_call_original
-    end
-    let(:manifest_hash) do
-      {
-        "LikeButton" => {
-          "id" => "/LikeButton.jsx",
-          "name" => "LikeButton",
-          "chunks" => ["/LikeButton.jsx"]
-        }
-      }
-    end
-    let(:manifest_json) { JSON.generate(manifest_hash) }
-    # A real Net::HTTPSuccess (HTTPOK < HTTPSuccess) whose body we override, so
-    # the resolver's `response.is_a?(Net::HTTPSuccess)` branch is exercised for
-    # real without touching the network.
-    def http_ok(body)
-      response = Net::HTTPOK.new("1.1", "200", "OK")
-      response.define_singleton_method(:body) { body }
-      response
-    end
-    def in_dev
-      allow(Rails).to receive(:env).and_return(ActiveSupport::StringInquirer.new("development"))
-    end
-    describe ".resolve in development (the boot-race)" do
-      before do
-        in_dev
-        # Simulate the race: boot read the missing file, so the cached manifest is nil.
-        allow(Ruact).to receive(:manifest).and_return(nil)
-      end
-      it "resolves from the Vite dev server over HTTP (no 500, ref resolvable)" do
-        allow(Net::HTTP).to receive(:start).and_return(http_ok(manifest_json))
-        manifest = described_class.resolve
-        expect(manifest).to be_a(ClientManifest)
-        ref = manifest.reference_for("LikeButton")
-        expect(ref.module_id).to eq("/LikeButton.jsx")
-      end
-      it "fetches the manifest from the configured vite_dev_server URL" do
-        allow(Net::HTTP).to receive(:start).and_return(http_ok(manifest_json))
-        described_class.resolve
-        expect(Net::HTTP).to have_received(:start).with(
-          "localhost", 5173, hash_including(:open_timeout, :read_timeout)
-        )
-      end
-      it "does not double-slash the path when vite_dev_server has a trailing slash" do
-        allow(described_class).to receive(:base_url).and_return("http://localhost:5173/")
-        http = instance_double(Net::HTTP)
-        allow(http).to receive(:get).and_return(http_ok(manifest_json))
-        allow(Net::HTTP).to receive(:start).and_yield(http).and_return(http_ok(manifest_json))
-        described_class.resolve
-        expect(http).to have_received(:get).with("/__ruact/manifest")
-      end
-      it "speaks TLS when vite_dev_server is https" do
-        allow(described_class).to receive(:base_url).and_return("https://localhost:5173")
-        allow(Net::HTTP).to receive(:start).and_return(http_ok(manifest_json))
-        described_class.resolve
-        expect(Net::HTTP).to have_received(:start).with(
-          "localhost", 5173, hash_including(use_ssl: true)
-        )
-      end
-      it "falls back to the on-disk file when the dev server is unreachable" do
-        allow(Net::HTTP).to receive(:start).and_raise(Errno::ECONNREFUSED)
-        Dir.mktmpdir do |dir|
-          path = File.join(dir, "react-client-manifest.json")
-          File.write(path, manifest_json)
-          allow(described_class).to receive(:file_path).and_return(path)
-          manifest = described_class.resolve
-          expect(manifest).to be_a(ClientManifest)
-          expect(manifest.reference_for("LikeButton").module_id).to eq("/LikeButton.jsx")
-        end
-      end
-      it "raises a clear, actionable error (not NoMethodError) when neither HTTP nor file is available" do
-        allow(Net::HTTP).to receive(:start).and_raise(Errno::ECONNREFUSED)
-        allow(described_class).to receive(:file_path).and_return("/no/such/manifest.json")
-        expect { described_class.resolve }.to raise_error(ManifestError, %r{Vite dev server.*bin/dev}m)
-      end
-      # Story 15.0 (F8) — an error message is a prompt: agents (and humans)
-      # regex-match error text, so the ENGLISH wording and its stable tokens
-      # (`Vite dev server`, `react-client-manifest.json`, `bin/dev`) are pinned.
-      it "raises the ENGLISH message naming the dev-server URL, the manifest path and the bin/dev fix " \
-         "(Story 15.0)", :story_15_0 do
-        allow(Net::HTTP).to receive(:start).and_raise(Errno::ECONNREFUSED)
-        allow(described_class).to receive(:file_path).and_return("/no/such/manifest.json")
-        expect { described_class.resolve }.to raise_error(ManifestError) do |error|
-          expect(error.message).to include("[ruact] Vite dev server unreachable at http://localhost:5173")
-          expect(error.message).to include("no react-client-manifest.json found at /no/such/manifest.json")
-          expect(error.message).to include("run `bin/dev`")
-        end
-      end
-      it "ignores a non-2xx dev-server response and falls back" do
-        allow(Net::HTTP).to receive(:start).and_return(Net::HTTPNotFound.new("1.1", "404", "Not Found"))
-        allow(described_class).to receive(:file_path).and_return("/no/such/manifest.json")
-        expect { described_class.resolve }.to raise_error(ManifestError)
-      end
-    end
-    describe ".resolve_soft in development (fail-open for FR100)" do
-      before do
-        in_dev
-        allow(Ruact).to receive(:manifest).and_return(nil)
-      end
-      it "returns nil (no raise) when nothing is resolvable" do
-        allow(Net::HTTP).to receive(:start).and_raise(Errno::ECONNREFUSED)
-        allow(described_class).to receive(:file_path).and_return("/no/such/manifest.json")
-        expect(described_class.resolve_soft).to be_nil
-      end
-      it "returns the dev manifest when the server is up" do
-        allow(Net::HTTP).to receive(:start).and_return(http_ok(manifest_json))
-        expect(described_class.resolve_soft).to be_a(ClientManifest)
-      end
-    end
-    describe "production / non-development (untouched)" do
-      it "returns Ruact.manifest verbatim without any HTTP call" do
-        allow(Rails).to receive(:env).and_return(ActiveSupport::StringInquirer.new("production"))
-        allow(Net::HTTP).to receive(:start)
-        boot_manifest = ClientManifest.from_hash(manifest_hash)
-        allow(Ruact).to receive(:manifest).and_return(boot_manifest)
-        expect(described_class.resolve).to be(boot_manifest)
-        expect(Net::HTTP).not_to have_received(:start)
-      end
-      it "returns Ruact.manifest in the test environment too (no dev fetch)" do
-        allow(Rails).to receive(:env).and_return(ActiveSupport::StringInquirer.new("test"))
-        allow(Net::HTTP).to receive(:start)
-        boot_manifest = ClientManifest.from_hash(manifest_hash)
-        allow(Ruact).to receive(:manifest).and_return(boot_manifest)
-        expect(described_class.resolve).to be(boot_manifest)
-        expect(Net::HTTP).not_to have_received(:start)
-      end
-    end
-  end
-end