ruact 0.0.5 → 0.0.6

data/vendor/javascript/vite-plugin-ruact/type-tests/scaffold/ambient.d.ts

@@ -0,0 +1,166 @@
+// Story 10.2 (AC7 / Task 5) — AMBIENT stubs so the GENERATED `<Model>List.tsx`
+// type-checks in ISOLATION, without a real shadcn install. The fixture
+// `PostList.tsx` in this directory is byte-identical to the generator's live
+// output (a gem rspec example asserts that equality), so type-checking it under
+// `tsconfig.scaffold.json` proves the emitted typed List holds the FR99 server
+// boundary + the shadcn `table`-primitive import contract. There is NO
+// table-engine dependency — Story 10.2b moved the List off the react-table-based
+// `DataTable` recipe onto the dep-free shadcn `table` primitive + a generated sort.
+//
+// These are deliberately MINIMAL structural shims — NOT the real shadcn / react
+// types. Story 10.5 installs the real `@/components/ui/*` modules (incl. the
+// `table` primitive); 10.7 wires the live end-to-end demo. The point here is the
+// generated module's OWN type-safety (typed rows, sortable headers, the search
+// accessor), not re-testing upstream libraries.
+
+// JSX without `lib: ["dom"]` / `@types/react`: a permissive intrinsic-element
+// table (every native prop is `any`, so `onChange={(e) => …}` etc. need no DOM
+// event types). `jsx: "preserve"` in tsconfig.scaffold.json still type-checks
+// every JSX expression against this namespace.
+declare namespace JSX {
+  interface Element {} // eslint-disable-line @typescript-eslint/no-empty-interface
+  interface ElementClass {} // eslint-disable-line @typescript-eslint/no-empty-interface
+  interface IntrinsicElements {
+    [elem: string]: any;
+  }
+}
+
+declare module "react" {
+  export function useState<S>(initial: S | (() => S)): [S, (next: S | ((prev: S) => S)) => void];
+  // The generated Form's `handleSubmit(event: FormEvent)` only calls
+  // `event.preventDefault()`; a minimal shim keeps the type load-bearing without
+  // pulling in `@types/react`.
+  export interface FormEvent {
+    preventDefault(): void;
+  }
+}
+
+declare module "@/.ruact/server-functions" {
+  // FR88/FR99 wire union — the only param value type a query accessor accepts.
+  type Wire = string | number | boolean | null;
+
+  // The codegen exports a generic `search` from `<Plural>Query#search(q:)`,
+  // typed from the declared `(q:)` kwarg (Story 13.4). The List aliases it
+  // `search<Plural>`.
+  export const search: (params: { q: Wire }) => Promise<unknown>;
+
+  // Action accessors the generated Form imports (Story 10.3). Actions are NOT
+  // typed by FR99 (only queries are — Story 13.4 decision A), so the accessors
+  // take a loose payload and return `Promise<unknown>`; the Form narrows the
+  // result with an `as { errors?: ... } | null` assertion at the call site.
+  export const createPost: (payload: Record<string, unknown>) => Promise<unknown>;
+  export const updatePost: (payload: Record<string, unknown>) => Promise<unknown>;
+  // Story 10.4 — the destroy accessor the List's RowActions calls in `onConfirm`
+  // (DELETE /posts/:id). Like the other actions it is not FR99-typed; it returns
+  // `Promise<unknown>` and throws a `RuactActionError` on a non-2xx response.
+  export const destroyPost: (payload: Record<string, unknown>) => Promise<unknown>;
+
+  // Mirrors the runtime declaration (`ruact-server-functions-runtime/index.d.ts`)
+  // — `reference` is the widened accessor shape (Story 13.4), `T` the return type.
+  export function useQuery<T = unknown>(
+    reference: (...args: never[]) => Promise<unknown>,
+    params?: Record<string, unknown>,
+  ): { data: T | undefined; loading: boolean; error: unknown };
+}
+
+// Story 10.2b — the shadcn `table` primitive (a styled HTML table; no engine).
+// Permissive structural shims (like Button/Badge/DropdownMenu below): the
+// generated List reads `row.<attr>` directly and drives its own `useState` sort,
+// so there is nothing engine-typed left to check here. Story 10.5 installs the
+// real module (`npx shadcn add table`).
+declare module "@/components/ui/table" {
+  type Props = { children?: any; [key: string]: any };
+  export function Table(props: Props): any;
+  export function TableHeader(props: Props): any;
+  export function TableBody(props: Props): any;
+  export function TableRow(props: Props): any;
+  export function TableHead(props: Props): any;
+  export function TableCell(props: Props): any;
+}
+
+declare module "@/components/ui/badge" {
+  export function Badge(props: { children?: any; [key: string]: any }): any;
+}
+
+declare module "@/components/ui/button" {
+  export function Button(props: { children?: any; [key: string]: any }): any;
+}
+
+declare module "@/components/ui/dropdown-menu" {
+  type Props = { children?: any; [key: string]: any };
+  export function DropdownMenu(props: Props): any;
+  export function DropdownMenuTrigger(props: Props): any;
+  export function DropdownMenuContent(props: Props): any;
+  export function DropdownMenuItem(props: Props): any;
+}
+
+// Story 10.4 — the shadcn AlertDialog parts the generated `<Model>DeleteDialog`
+// imports. The controlled `AlertDialog` types `open` + `onOpenChange` precisely
+// (the controlled contract the generated dialog binds); the rest stay permissive
+// structural shims (like Button/Badge above). Story 10.5 installs the real module.
+declare module "@/components/ui/alert-dialog" {
+  type Props = { children?: any; [key: string]: any };
+  export function AlertDialog(props: {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    [key: string]: any;
+  }): any;
+  export function AlertDialogTrigger(props: Props): any;
+  export function AlertDialogContent(props: Props): any;
+  export function AlertDialogHeader(props: Props): any;
+  export function AlertDialogFooter(props: Props): any;
+  export function AlertDialogTitle(props: Props): any;
+  export function AlertDialogDescription(props: Props): any;
+  export function AlertDialogCancel(props: Props): any;
+  export function AlertDialogAction(props: Props): any;
+}
+
+// Story 10.3 — the shadcn Form primitives the generated `<Model>Form.tsx` imports.
+// Permissive structural shims (like Button/Badge above): the point is the
+// generated module's OWN type-safety (controlled state, the typed action
+// accessors, the `initial` prop + `{ id; label }[]` options props), not
+// re-testing upstream shadcn. Story 10.5 installs the real modules.
+declare module "@/components/ui/label" {
+  export function Label(props: { children?: any; [key: string]: any }): any;
+}
+
+// Input/Textarea/Switch/Select type the value + change handler precisely (the
+// rest of the props stay permissive) so the isolated typecheck actually proves
+// the generated Form binds STRING state to string controls and a boolean to the
+// Switch — the controlled-state contract, not just import resolution.
+declare module "@/components/ui/input" {
+  export function Input(props: {
+    value?: string;
+    onChange?: (event: { target: { value: string } }) => void;
+    [key: string]: any;
+  }): any;
+}
+
+declare module "@/components/ui/textarea" {
+  export function Textarea(props: {
+    value?: string;
+    onChange?: (event: { target: { value: string } }) => void;
+    [key: string]: any;
+  }): any;
+}
+
+declare module "@/components/ui/switch" {
+  export function Switch(props: {
+    checked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+    [key: string]: any;
+  }): any;
+}
+
+declare module "@/components/ui/select" {
+  type Props = { children?: any; [key: string]: any };
+  export function Select(props: {
+    value?: string;
+    onValueChange?: (value: string) => void;
+    [key: string]: any;
+  }): any;
+  export function SelectContent(props: Props): any;
+  export function SelectItem(props: Props): any;
+  export function SelectTrigger(props: Props): any;
+  export function SelectValue(props: Props): any;
+}

data/vendor/javascript/vite-plugin-ruact/type-tests/typed-query.test-d.ts

@@ -0,0 +1,48 @@
+// Story 13.4 (AC6) — compile-time proof that the codegen-emitted typed query
+// `params` signature is ENFORCED by `tsc`. This file mirrors the accessor shape
+// emitted by `renderQueryExportV2` for a query declaring `def search_users(term:,
+// limit: 10)` (see the byte-exact assertion in `server-functions-codegen.test.mjs`
+// → "Story 13.4 … typed query params render"). If codegen drifts, that parity
+// test reddens; if the emitted type is too loose, the `@ts-expect-error` lines
+// below become "unused directive" tsc errors (TS2578) — either way CI catches it.
+//
+// `@ts-expect-error` is self-checking: it is itself an error UNLESS the next line
+// genuinely fails to compile, so a clean call MUST type-check and every illegal
+// call MUST fail.
+
+// The emitted value type for a typed query param: the FR88 wire union.
+type Wire = string | number | boolean | null;
+
+// Mirror of the emitted accessor: `term` required, `limit` optional.
+declare const searchUsers: (params: {
+  term: Wire;
+  limit?: Wire;
+}) => Promise<unknown>;
+
+// ── Clean calls — MUST type-check ───────────────────────────────────────────
+void searchUsers({ term: "ada" });
+void searchUsers({ term: "ada", limit: 10 });
+void searchUsers({ term: 42, limit: true });
+void searchUsers({ term: null });
+
+// ── Missing required param — MUST error ─────────────────────────────────────
+// @ts-expect-error — `term` is required
+void searchUsers({ limit: 10 });
+
+// @ts-expect-error — required param object cannot be omitted entirely
+void searchUsers();
+
+// ── Unknown key — MUST error (excess property check) ────────────────────────
+// @ts-expect-error — `bogus` is not a declared param
+void searchUsers({ term: "ada", bogus: 1 });
+
+// ── Wrong-typed value — MUST error (outside the wire union) ──────────────────
+// @ts-expect-error — an object is not assignable to the wire union
+void searchUsers({ term: { nested: true } });
+
+// @ts-expect-error — an array is not assignable to the wire union
+void searchUsers({ term: [1, 2, 3] });
+
+// ── Wrong arity — MUST error ────────────────────────────────────────────────
+// @ts-expect-error — the accessor takes exactly one argument
+void searchUsers({ term: "ada" }, "extra");

data/vendor/javascript/vite-plugin-ruact/type-tests/usequery.test-d.ts

@@ -0,0 +1,26 @@
+// Story 13.4 (AC3 / Task 6) — proves a codegen-emitted TYPED query accessor is
+// accepted by `useQuery` without a cast (the dev⇄Codex round-1 regression: the
+// pre-13.4 `useQuery` `reference` param was `(params?: Record<string, unknown>)`,
+// which a typed `(params: { term: Wire }) => Promise<unknown>` accessor is NOT
+// assignable to under `strict`). Also confirms the no-kwargs accessor and the
+// return-type generic still work.
+
+import { useQuery } from "ruact/server-functions-runtime";
+
+type Wire = string | number | boolean | null;
+
+// Mirror of the emitted accessors:
+declare const searchUsers: (params: { term: Wire; limit?: Wire }) => Promise<unknown>;
+declare const categories: () => Promise<unknown>;
+
+// Typed query ref + params — MUST type-check.
+void useQuery(searchUsers, { term: "ada" });
+void useQuery(searchUsers, { term: "ada", limit: 25 });
+
+// No-kwargs query ref — MUST type-check (with and without the return generic).
+void useQuery(categories);
+void useQuery<{ id: number }[]>(categories);
+
+// Return-type generic still flows.
+const r = useQuery<{ id: number }[]>(searchUsers, { term: "ada" });
+void r.data;

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruact
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors:
 - Luiz Garcia
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-10 00:00:00.000000000 Z
+date: 2026-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -46,11 +46,32 @@ files:
 - docs/internal/README.md
 - docs/internal/decisions/server-functions-api.md
 - lib/generators/ruact/install/install_generator.rb
-- lib/generators/ruact/install/templates/application.jsx.tt
+- lib/generators/ruact/install/templates/Procfile.dev.tt
+- lib/generators/ruact/install/templates/dev.tt
 - lib/generators/ruact/install/templates/initializer.rb.tt
+- lib/generators/ruact/install/templates/package.json.tt
 - lib/generators/ruact/install/templates/vite.config.js.tt
+- lib/generators/ruact/scaffold/scaffold_attribute.rb
+- lib/generators/ruact/scaffold/scaffold_form_helpers.rb
+- lib/generators/ruact/scaffold/scaffold_generator.rb
+- lib/generators/ruact/scaffold/scaffold_shadcn_preflight.rb
+- lib/generators/ruact/scaffold/templates/components/DeleteDialog.tsx.tt
+- lib/generators/ruact/scaffold/templates/components/Form.tsx.tt
+- lib/generators/ruact/scaffold/templates/components/List.tsx.tt
+- lib/generators/ruact/scaffold/templates/components/agnostic/DeleteDialog.tsx.tt
+- lib/generators/ruact/scaffold/templates/components/agnostic/Form.tsx.tt
+- lib/generators/ruact/scaffold/templates/components/agnostic/List.tsx.tt
+- lib/generators/ruact/scaffold/templates/controller.rb.tt
+- lib/generators/ruact/scaffold/templates/queries/application_query.rb.tt
+- lib/generators/ruact/scaffold/templates/queries/query.rb.tt
+- lib/generators/ruact/scaffold/templates/request_spec.rb.tt
+- lib/generators/ruact/scaffold/templates/views/edit.html.erb.tt
+- lib/generators/ruact/scaffold/templates/views/index.html.erb.tt
+- lib/generators/ruact/scaffold/templates/views/new.html.erb.tt
+- lib/generators/ruact/scaffold/templates/views/show.html.erb.tt
 - lib/ruact.rb
 - lib/ruact/client_manifest.rb
+- lib/ruact/component_contract.rb
 - lib/ruact/configuration.rb
 - lib/ruact/controller.rb
 - lib/ruact/doctor.rb
@@ -71,13 +92,12 @@ files:
 - lib/ruact/routing.rb
 - lib/ruact/serializable.rb
 - lib/ruact/server.rb
-- lib/ruact/server_action.rb
 - lib/ruact/server_functions.rb
 - lib/ruact/server_functions/backtrace_cleaner.rb
 - lib/ruact/server_functions/bucket_two_payload.rb
 - lib/ruact/server_functions/codegen.rb
 - lib/ruact/server_functions/codegen_v2.rb
-- lib/ruact/server_functions/endpoint_controller.rb
+- lib/ruact/server_functions/codegen_v2_query_params.rb
 - lib/ruact/server_functions/error_payload.rb
 - lib/ruact/server_functions/error_rendering.rb
 - lib/ruact/server_functions/error_suggestion.rb
@@ -85,13 +105,13 @@ files:
 - lib/ruact/server_functions/query_context.rb
 - lib/ruact/server_functions/query_dispatch.rb
 - lib/ruact/server_functions/query_source.rb
-- lib/ruact/server_functions/registry.rb
-- lib/ruact/server_functions/registry_entry.rb
 - lib/ruact/server_functions/route_source.rb
 - lib/ruact/server_functions/snapshot.rb
 - lib/ruact/server_functions/snapshot_writer.rb
-- lib/ruact/server_functions/standalone_context.rb
-- lib/ruact/server_functions/standalone_dispatcher.rb
+- lib/ruact/server_functions/validation_errors.rb
+- lib/ruact/signed_references.rb
+- lib/ruact/string_distance.rb
+- lib/ruact/validation_errors_collector.rb
 - lib/ruact/version.rb
 - lib/ruact/view_helper.rb
 - lib/rubocop/cop/ruact.rb
@@ -125,7 +145,9 @@ files:
 - spec/fixtures/flight/string_dollar_escape.txt
 - spec/fixtures/flight/undefined.txt
 - spec/fixtures/story_7_9_views/controller_request_spec_support/demo/show.html.erb
+- spec/fixtures/story_7_9_views/controller_request_spec_support/errors_demo/new.html.erb
 - spec/ruact/client_manifest_spec.rb
+- spec/ruact/component_contract_spec.rb
 - spec/ruact/configuration_spec.rb
 - spec/ruact/controller_request_spec.rb
 - spec/ruact/controller_spec.rb
@@ -143,14 +165,13 @@ files:
 - spec/ruact/render_context_spec.rb
 - spec/ruact/render_pipeline_concurrency_spec.rb
 - spec/ruact/render_pipeline_spec.rb
+- spec/ruact/scaffold_generator_spec.rb
 - spec/ruact/serializable_spec.rb
 - spec/ruact/server_bucket_request_spec.rb
 - spec/ruact/server_function_name_spec.rb
 - spec/ruact/server_functions/backtrace_cleaner_spec.rb
 - spec/ruact/server_functions/bucket_two_payload_spec.rb
 - spec/ruact/server_functions/codegen_spec.rb
-- spec/ruact/server_functions/csrf_request_spec.rb
-- spec/ruact/server_functions/dispatch_request_spec.rb
 - spec/ruact/server_functions/error_payload_spec.rb
 - spec/ruact/server_functions/error_suggestion_spec.rb
 - spec/ruact/server_functions/name_bridge_spec.rb
@@ -158,16 +179,15 @@ files:
 - spec/ruact/server_functions/query_source_spec.rb
 - spec/ruact/server_functions/railtie_integration_spec.rb
 - spec/ruact/server_functions/rake_spec.rb
-- spec/ruact/server_functions/registry_spec.rb
 - spec/ruact/server_functions/route_source_spec.rb
 - spec/ruact/server_functions/snapshot_spec.rb
 - spec/ruact/server_functions/snapshot_writer_spec.rb
-- spec/ruact/server_functions/standalone_action_spec.rb
-- spec/ruact/server_functions/standalone_context_spec.rb
-- spec/ruact/server_functions/standalone_dispatcher_spec.rb
 - spec/ruact/server_rescue_request_spec.rb
 - spec/ruact/server_spec.rb
 - spec/ruact/server_upload_request_spec.rb
+- spec/ruact/signed_references_spec.rb
+- spec/ruact/string_distance_spec.rb
+- spec/ruact/validation_errors_spec.rb
 - spec/ruact/view_helper_spec.rb
 - spec/spec_helper.rb
 - spec/support/fixtures/pixel.png
@@ -181,11 +201,31 @@ files:
 - vendor/javascript/ruact-server-functions-runtime/index.test.mjs
 - vendor/javascript/ruact-server-functions-runtime/package.json
 - vendor/javascript/ruact-server-functions-runtime/usequery.test.mjs
+- vendor/javascript/vite-plugin-ruact/bootstrap.test.mjs
 - vendor/javascript/vite-plugin-ruact/index.js
+- vendor/javascript/vite-plugin-ruact/manifest-contract.test.mjs
 - vendor/javascript/vite-plugin-ruact/package-lock.json
 - vendor/javascript/vite-plugin-ruact/package.json
+- vendor/javascript/vite-plugin-ruact/registry.test.mjs
+- vendor/javascript/vite-plugin-ruact/runtime/bootstrap.jsx
+- vendor/javascript/vite-plugin-ruact/runtime/flight-client.js
+- vendor/javascript/vite-plugin-ruact/runtime/ruact-router.js
 - vendor/javascript/vite-plugin-ruact/server-functions-codegen.mjs
 - vendor/javascript/vite-plugin-ruact/server-functions-codegen.test.mjs
+- vendor/javascript/vite-plugin-ruact/tsconfig.json
+- vendor/javascript/vite-plugin-ruact/tsconfig.scaffold-agnostic.json
+- vendor/javascript/vite-plugin-ruact/tsconfig.scaffold.json
+- vendor/javascript/vite-plugin-ruact/type-tests/emitted-module.test-d.ts
+- vendor/javascript/vite-plugin-ruact/type-tests/scaffold/PostDeleteDialog.tsx
+- vendor/javascript/vite-plugin-ruact/type-tests/scaffold/PostForm.tsx
+- vendor/javascript/vite-plugin-ruact/type-tests/scaffold/PostList.tsx
+- vendor/javascript/vite-plugin-ruact/type-tests/scaffold/agnostic/PostDeleteDialog.tsx
+- vendor/javascript/vite-plugin-ruact/type-tests/scaffold/agnostic/PostForm.tsx
+- vendor/javascript/vite-plugin-ruact/type-tests/scaffold/agnostic/PostList.tsx
+- vendor/javascript/vite-plugin-ruact/type-tests/scaffold/agnostic/ambient.d.ts
+- vendor/javascript/vite-plugin-ruact/type-tests/scaffold/ambient.d.ts
+- vendor/javascript/vite-plugin-ruact/type-tests/typed-query.test-d.ts
+- vendor/javascript/vite-plugin-ruact/type-tests/usequery.test-d.ts
 - vendor/javascript/vite-plugin-ruact/vitest.config.mjs
 homepage: https://luizcg.github.io/ruact/
 licenses:

data/lib/generators/ruact/install/templates/application.jsx.tt

@@ -1,51 +0,0 @@
-import { createRoot } from 'react-dom/client';
-import { useState, useEffect } from 'react';
-import { createFromFlightPayload } from './flight-client.js';
-import { setupRouter, teardownRouter } from './ruact-router.js';
-
-// MODULE_REGISTRY maps react-client-manifest "id" values to component exports.
-// Add each "use client" component here as you create it.
-// Keys must match the "id" field in public/react-client-manifest.json.
-//
-// Example:
-//   import { MyButton } from './components/MyButton.jsx';
-//   const MODULE_REGISTRY = { '/MyButton.jsx': { MyButton } };
-const MODULE_REGISTRY = {};
-
-// ---------------------------------------------------------------------------
-// Boot
-// ---------------------------------------------------------------------------
-const flightData = globalThis.__FLIGHT_DATA;
-
-if (!flightData || flightData.length === 0) {
-  // Non-RSC page or Rails server not running — skip hydration.
-  const root = document.getElementById('root');
-  if (root && root.childNodes.length === 0) {
-    root.textContent = '[ruact] No Flight data found — is the Rails server running?';
-  }
-} else {
-  const payload = flightData.join('');
-
-  let initialTree;
-  try {
-    initialTree = createFromFlightPayload(payload, MODULE_REGISTRY);
-  } catch (err) {
-    console.error('[ruact] Failed to parse Flight payload:', err);
-    const root = document.getElementById('root');
-    if (root) root.textContent = '[ruact] Error: ' + err.message;
-    throw err;
-  }
-
-  function App() {
-    const [tree, setTree] = useState(() => initialTree);
-
-    useEffect(() => {
-      setupRouter({ onNavigate: setTree, moduleRegistry: MODULE_REGISTRY });
-      return () => teardownRouter();
-    }, []);
-
-    return tree;
-  }
-
-  createRoot(document.getElementById('root')).render(<App />);
-}

data/lib/ruact/server_action.rb

@@ -1,131 +0,0 @@
-# frozen_string_literal: true
-
-module Ruact
-  # Story 8.3 — host module for STANDALONE server actions. The Ruby
-  # equivalent of React's `"use server"` directive: a module under
-  # `app/server_actions/` that `extend`s {Ruact::ServerAction} and declares
-  # one action body per file with the `ruact_action` macro.
-  #
-  #   # app/server_actions/create_post.rb
-  #   module CreatePost
-  #     extend Ruact::ServerAction
-  #
-  #     ruact_action :create_post do |params|
-  #       Post.create!(title: params[:title], body: params[:body])
-  #     end
-  #   end
-  #
-  # The React side cannot tell standalone-hosted actions apart from
-  # controller-hosted ones — both export under the same accessor at
-  # `app/javascript/.ruact/server-functions.ts` (Story 8.0a codegen).
-  #
-  # Differences from {Ruact::Controller#ruact_action} (the controller-hosted
-  # path from Story 8.1):
-  #
-  #   - NO instance method is defined on the host module. There is no
-  #     `host.public_send(action_name)` call shape — the dispatcher
-  #     ({Ruact::ServerFunctions::EndpointController}) detects the standalone
-  #     host shape and routes through {Ruact::ServerFunctions::StandaloneDispatcher}
-  #     instead of `host_class.dispatch`. Standalone modules are reachable
-  #     ONLY through the gem's `POST /__ruact/fn/:name` endpoint; there is
-  #     no public Ruby surface to invoke them, by design.
-  #   - NO controller `before_action` chain runs. The dev opts out of the
-  #     controller-DSL ergonomic by picking the standalone path; the
-  #     trade-off is no implicit auth/scoping. The dev calls `current_user`
-  #     (resolved via {Ruact::Configuration#current_user_resolver}) and
-  #     Pundit / ActionPolicy directly inside the block when needed.
-  #   - NO `method_added` hook, NO `Thread.current[:__ruact_dispatching]`
-  #     sentinel. The standalone path has no routing surface that could
-  #     reach the action body outside of the gem-managed endpoint, so the
-  #     controller-only security guards are unnecessary (and would be
-  #     misleading — the block is stored in the registry, not on the
-  #     module as an instance method).
-  #
-  # Shared with {Ruact::Controller#ruact_action}:
-  #
-  #   - {Ruact::ServerFunctions::Registry} via `Ruact.action_registry`.
-  #     Symbols declared by standalone modules and by controller hosts live
-  #     in the same registry instance; the existing collision detector
-  #     ({Ruact::ServerFunctions::Registry#detect_collision!}) catches
-  #     same-symbol-different-host collisions across both host shapes.
-  #   - The naming-bridge rule ({Ruact::ServerFunctions::NameBridge}) and
-  #     reserved-identifier sets (`RESERVED_JS_IDENTIFIERS`,
-  #     `RESERVED_BY_RUACT`).
-  #   - The block-parameter shape guard (one positional argument, no
-  #     required keyword arguments) — same regex as Story 8.1 Re-run-5.
-  module ServerAction
-    # @param symbol [Symbol] the action name; same naming-bridge rule as
-    #   {Ruact::Controller#ruact_action}.
-    # @yield [params] the block runs via `instance_exec` on a fresh
-    #   {Ruact::ServerFunctions::StandaloneContext} at dispatch time.
-    # @return [Ruact::ServerFunctions::RegistryEntry] the entry just registered.
-    # @raise [ArgumentError] when +symbol+ is not a Symbol, the block is
-    #   missing, or the block's parameter shape is rejected.
-    # @raise [Ruact::ConfigurationError] when the symbol fails the
-    #   naming-bridge rule or collides with another `ruact_action` in the
-    #   registry (mixed-host collisions are caught here too — see AC4).
-    def ruact_action(symbol, &block)
-      # Story 8.3 review R4 — reject Class hosts loudly. `extend Ruact::ServerAction`
-      # on a Class would work at extend time (Class < Module), but the
-      # endpoint dispatcher's `standalone_host?` predicate returns false for
-      # Class hosts (it requires Module-NOT-Class), and the controller-DSL
-      # branch would then try `host_class.dispatch(...)` against a class
-      # that has NO Rails dispatch surface — crashing at request time.
-      # Catch this at declaration time so the failure is visible at boot.
-      if is_a?(Class)
-        raise Ruact::ConfigurationError,
-              "Ruact::ServerAction is intended for standalone HOST MODULES under " \
-              "`app/server_actions/`. You extended it onto #{name || self} which " \
-              "is a Class — that's a controller-shape host. For controller-hosted " \
-              "actions use `include Ruact::Controller` and declare `ruact_action` " \
-              "inside the controller class body; for standalone actions declare a " \
-              "`module Foo; extend Ruact::ServerAction; ...; end` instead."
-      end
-
-      unless symbol.is_a?(Symbol)
-        raise ArgumentError,
-              "ruact_action requires a Symbol argument, got " \
-              "#{symbol.inspect} (#{symbol.class}). Use " \
-              "`ruact_action :#{symbol}` not `ruact_action #{symbol.inspect}`."
-      end
-
-      unless block
-        raise ArgumentError,
-              "ruact_action :#{symbol} (standalone) requires a block — declare the " \
-              "implementation with `ruact_action :#{symbol} do |params| ... end`"
-      end
-
-      # Mirror the block-parameter shape guard from Story 8.1 Re-run-5
-      # (controller.rb:125-137). The standalone dispatcher invokes the
-      # block with one positional argument (the params shadow); blocks
-      # with wrong arity / required kwargs would crash at dispatch time.
-      req_count    = block.parameters.count { |kind, _| kind == :req }
-      opt_count    = block.parameters.count { |kind, _| kind == :opt }
-      rest_count   = block.parameters.count { |kind, _| kind == :rest }
-      named_positional = req_count + opt_count
-      positional_total = named_positional + rest_count
-      has_required_kwarg = block.parameters.any? { |kind, _| kind == :keyreq }
-      if positional_total.zero? || named_positional > 1 || has_required_kwarg
-        raise ArgumentError,
-              "ruact_action :#{symbol} (standalone) block must accept exactly one " \
-              "positional parameter and no required keyword arguments " \
-              "(got parameters=#{block.parameters.inspect}). Use " \
-              "`ruact_action :#{symbol} do |params| ... end`."
-      end
-
-      # NOTE: no `FRAMEWORK_RESERVED_METHODS` check — standalone modules
-      # have no ActionController surface to clobber. NameBridge +
-      # RESERVED_JS_IDENTIFIERS + RESERVED_BY_RUACT still fire via the
-      # registry's `register` path below.
-      #
-      # NOTE: no `own_methods` / inherited-helper guard — there is no
-      # `define_method` step that could shadow anything; the block lives
-      # in the registry, not on the module.
-      #
-      # NOTE: no `method_added` hook — standalone modules don't define
-      # instance methods at all, so a same-name `def` cannot shadow
-      # anything (Pitfall #2 in the story spec).
-      Ruact.action_registry.register(symbol, kind: :action, controller: self, &block)
-    end
-  end
-end