funicular 0.1.0 → 0.2.1

data/lib/funicular/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Funicular
-  VERSION = "0.1.0"
+  VERSION = "0.2.1"
 end

data/lib/funicular.rb

@@ -3,6 +3,9 @@
 require_relative "funicular/version"
 require_relative "funicular/configuration"
 require_relative "funicular/compiler"
+require_relative "funicular/plugin"
+require_relative "funicular/schema"
+require_relative "funicular/ssr"
 
 module Funicular
   class Error < StandardError; end

data/lib/generators/funicular/chat/chat_generator.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/active_record"
+
+module Funicular
+  module Generators
+    class ChatGenerator < Rails::Generators::Base
+      include Rails::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+
+      def self.next_migration_number(dirname)
+        ActiveRecord::Generators::Base.next_migration_number(dirname)
+      end
+
+      def migration_version
+        "[#{ActiveRecord::Migration.current_version}]"
+      end
+
+      def create_rails_files
+        migration_template "create_funicular_chat_messages.rb.tt",
+                           "db/migrate/create_funicular_chat_messages.rb"
+        template "funicular_chat_message.rb.tt",
+                 "app/models/funicular_chat_message.rb"
+        template "funicular_chat_controller.rb.tt",
+                 "app/controllers/funicular_chat_controller.rb"
+        template "funicular_chat_messages_controller.rb.tt",
+                 "app/controllers/funicular_chat_messages_controller.rb"
+        template "application_cable_connection.rb.tt",
+                 "app/channels/application_cable/connection.rb" unless File.exist?(Rails.root.join("app", "channels", "application_cable", "connection.rb"))
+        template "application_cable_channel.rb.tt",
+                 "app/channels/application_cable/channel.rb" unless File.exist?(Rails.root.join("app", "channels", "application_cable", "channel.rb"))
+        template "funicular_chat_channel.rb.tt",
+                 "app/channels/funicular_chat_channel.rb"
+        template "show.html.erb.tt",
+                 "app/views/funicular_chat/show.html.erb"
+        template "funicular_chat.css.tt",
+                 "app/assets/stylesheets/funicular_chat.css"
+      end
+
+      def create_funicular_files
+        template "funicular_chat_component.rb.tt",
+                 "app/funicular/components/funicular_chat_component.rb"
+        template "funicular_chat_component_picotest.rb.tt",
+                 "test/funicular/client/funicular_chat_component_picotest.rb"
+
+        @initializer_existed = File.exist?(Rails.root.join("app", "funicular", "initializer.rb"))
+        if @initializer_existed
+          say_status :skip, "app/funicular/initializer.rb already exists", :yellow
+        else
+          template "initializer.rb.tt", "app/funicular/initializer.rb"
+        end
+      end
+
+      def add_routes
+        routes_file = Rails.root.join("config", "routes.rb")
+        if File.exist?(routes_file) && File.read(routes_file).include?('get "funicular_chat"')
+          say_status :skip, "funicular_chat routes already exist", :yellow
+          return
+        end
+
+        route <<~ROUTES
+          get "funicular_chat", to: "funicular_chat#show"
+          get "funicular_chat/messages", to: "funicular_chat_messages#index"
+          post "funicular_chat/messages", to: "funicular_chat_messages#create"
+        ROUTES
+      end
+
+      def add_picoruby_include_tag
+        layout = Rails.root.join("app", "views", "layouts", "application.html.erb")
+        return unless File.exist?(layout)
+
+        content = File.read(layout)
+        return if content.include?("picoruby_include_tag")
+
+        if content.include?("<%= csrf_meta_tags %>")
+          inject_into_file layout.to_s,
+                           "    <%= picoruby_include_tag %>\n",
+                           after: "    <%= csrf_meta_tags %>\n"
+        else
+          say_status :skip, "layout does not contain csrf_meta_tags; add <%= picoruby_include_tag %> manually", :yellow
+        end
+      end
+
+      def print_next_steps
+        say ""
+        say "Funicular chat generated.", :green
+        say ""
+        say "Next steps:"
+        say "  1. Run `bin/rails db:migrate`"
+        say "  2. Run `bin/rails funicular:compile`"
+        say "  3. Open `/funicular_chat` in two browser windows"
+        say ""
+
+        if @initializer_existed
+          say "Add this route inside your existing Funicular.start block:"
+          say "  router.get('/funicular_chat', to: FunicularChatComponent, as: 'funicular_chat')"
+          say ""
+        end
+      end
+    end
+  end
+end

data/lib/generators/funicular/chat/templates/application_cable_channel.rb.tt

@@ -0,0 +1,4 @@
+module ApplicationCable
+  class Channel < ActionCable::Channel::Base
+  end
+end

data/lib/generators/funicular/chat/templates/application_cable_connection.rb.tt

@@ -0,0 +1,4 @@
+module ApplicationCable
+  class Connection < ActionCable::Connection::Base
+  end
+end

data/lib/generators/funicular/chat/templates/create_funicular_chat_messages.rb.tt

@@ -0,0 +1,10 @@
+class CreateFunicularChatMessages < ActiveRecord::Migration<%= migration_version %>
+  def change
+    create_table :funicular_chat_messages do |t|
+      t.string :name, null: false
+      t.text :body, null: false
+
+      t.timestamps
+    end
+  end
+end

data/lib/generators/funicular/chat/templates/funicular_chat.css.tt

@@ -0,0 +1,141 @@
+.funicular-chat {
+  min-height: 100vh;
+  background: #f3f4f6;
+  padding: 1.5rem;
+}
+
+.funicular-chat__panel {
+  max-width: 48rem;
+  margin: 0 auto;
+  background: #fff;
+  border: 1px solid #e5e7eb;
+  border-radius: 0.5rem;
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.06);
+  overflow: hidden;
+}
+
+.funicular-chat__header {
+  padding: 1rem 1.25rem;
+  border-bottom: 1px solid #e5e7eb;
+}
+
+.funicular-chat__title {
+  margin: 0;
+  color: #111827;
+  font-size: 1.25rem;
+  font-weight: 700;
+}
+
+.funicular-chat__subtitle {
+  margin: 0.25rem 0 0;
+  color: #6b7280;
+  font-size: 0.875rem;
+}
+
+.funicular-chat__messages {
+  height: 24rem;
+  overflow-y: auto;
+  padding: 1.25rem;
+  background: #f9fafb;
+}
+
+.funicular-chat__empty {
+  color: #6b7280;
+  font-size: 0.875rem;
+}
+
+.funicular-chat__message {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.75rem;
+  padding: 0.75rem;
+  margin-bottom: 0.75rem;
+  background: #fff;
+  border: 1px solid #e5e7eb;
+  border-radius: 0.375rem;
+}
+
+.funicular-chat__message-name {
+  flex: 0 0 auto;
+  min-width: 7rem;
+  color: #1f2937;
+  font-size: 0.875rem;
+  font-weight: 700;
+}
+
+.funicular-chat__message-body {
+  min-width: 0;
+  color: #374151;
+  font-size: 0.875rem;
+  overflow-wrap: anywhere;
+}
+
+.funicular-chat__form {
+  padding: 1.25rem;
+  border-top: 1px solid #e5e7eb;
+}
+
+.funicular-chat__form-row {
+  display: flex;
+  gap: 0.75rem;
+}
+
+.funicular-chat__input {
+  width: 100%;
+  min-width: 0;
+  padding: 0.5rem 0.75rem;
+  border: 1px solid #d1d5db;
+  border-radius: 0.375rem;
+  font: inherit;
+}
+
+.funicular-chat__input:focus {
+  border-color: #2563eb;
+  outline: 2px solid rgba(37, 99, 235, 0.25);
+}
+
+.funicular-chat__button {
+  flex: 0 0 auto;
+  padding: 0.5rem 1rem;
+  border: 0;
+  border-radius: 0.375rem;
+  font: inherit;
+  font-weight: 700;
+}
+
+.funicular-chat__button--enabled {
+  color: #fff;
+  background: #2563eb;
+  cursor: pointer;
+}
+
+.funicular-chat__button--enabled:hover {
+  background: #1d4ed8;
+}
+
+.funicular-chat__button--disabled {
+  color: #fff;
+  background: #2563eb;
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+
+.funicular-chat__error {
+  margin-bottom: 0.75rem;
+  color: #b91c1c;
+  font-size: 0.875rem;
+}
+
+@media (max-width: 640px) {
+  .funicular-chat {
+    padding: 0.75rem;
+  }
+
+  .funicular-chat__form-row {
+    flex-direction: column;
+  }
+
+  .funicular-chat__message-name {
+    min-width: 5rem;
+  }
+}

data/lib/generators/funicular/chat/templates/funicular_chat_channel.rb.tt

@@ -0,0 +1,5 @@
+class FunicularChatChannel < ApplicationCable::Channel
+  def subscribed
+    stream_from "funicular_chat"
+  end
+end

data/lib/generators/funicular/chat/templates/funicular_chat_component.rb.tt

@@ -0,0 +1,135 @@
+class FunicularChatComponent < Funicular::Component
+  styles do
+    shell "funicular-chat"
+    panel "funicular-chat__panel"
+    header "funicular-chat__header"
+    title "funicular-chat__title"
+    subtitle "funicular-chat__subtitle"
+    messages "funicular-chat__messages"
+    empty "funicular-chat__empty"
+    message "funicular-chat__message"
+    name "funicular-chat__message-name"
+    body "funicular-chat__message-body"
+    form "funicular-chat__form"
+    row "funicular-chat__form-row"
+    input "funicular-chat__input"
+    button base: "funicular-chat__button",
+           variants: {
+             enabled: "funicular-chat__button--enabled",
+             disabled: "funicular-chat__button--disabled"
+           }
+    error "funicular-chat__error"
+  end
+
+  def initialize_state
+    {
+      name: "Rails developer",
+      body: "",
+      messages: [],
+      error: nil,
+      sending: false,
+      connected: false
+    }
+  end
+
+  def component_mounted
+    load_messages
+    subscribe
+  end
+
+  def component_will_unmount
+    @subscription.unsubscribe if @subscription
+    @consumer.cleanup if @consumer
+  end
+
+  def load_messages
+    Funicular::HTTP.get("/funicular_chat/messages") do |response|
+      if response.ok
+        patch(messages: response.data)
+      else
+        patch(error: response.error_message || "Failed to load messages")
+      end
+    end
+  end
+
+  def subscribe
+    @consumer = Funicular::Cable.create_consumer("/cable")
+    @subscription = @consumer.subscriptions.create(channel: "FunicularChatChannel") do |message|
+      patch(messages: state.messages + [message])
+    end
+    @subscription.on_connected do
+      patch(connected: true)
+    end
+  end
+
+  def update_name(event)
+    patch(name: event.target[:value].to_s)
+  end
+
+  def update_body(event)
+    patch(body: event.target[:value].to_s)
+  end
+
+  def send_message(event = nil)
+    event.preventDefault if event
+    return if state.sending
+
+    name = state.name.to_s.strip
+    body = state.body.to_s.strip
+    if name == "" || body == ""
+      patch(error: "Name and message are required")
+      return
+    end
+
+    patch(sending: true, error: nil)
+    Funicular::HTTP.post(
+      "/funicular_chat/messages",
+      { message: { name: name, body: body } }
+    ) do |response|
+      if response.ok
+        patch(body: "", sending: false)
+      else
+        patch(error: response.error_message || "Failed to send message", sending: false)
+      end
+    end
+  end
+
+  def render
+    div(class: s.shell) do
+      div(class: s.panel) do
+        div(class: s.header) do
+          h1(class: s.title) { "Funicular Chat" }
+          p(class: s.subtitle) do
+            state.connected ? "Realtime Ruby chat over ActionCable" : "Connecting..."
+          end
+        end
+
+        div(class: s.messages) do
+          if state.messages.empty?
+            p(class: s.empty) { "No messages yet." }
+          else
+            state.messages.each do |message|
+              div(class: s.message, key: message["id"]) do
+                div(class: s.name) { message["name"] }
+                div(class: s.body) { message["body"] }
+              end
+            end
+          end
+        end
+
+        form(onsubmit: :send_message, class: s.form) do
+          if state.error
+            div(class: s.error) { state.error }
+          end
+          div(class: s.row) do
+            input(type: "text", value: state.name, placeholder: "Name", oninput: :update_name, class: s.input)
+            input(type: "text", value: state.body, placeholder: "Message", oninput: :update_body, class: s.input)
+            button(type: "submit", class: s.button(state.sending ? :disabled : :enabled), disabled: state.sending) do
+              state.sending ? "Sending..." : "Send"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/generators/funicular/chat/templates/funicular_chat_component_picotest.rb.tt

@@ -0,0 +1,64 @@
+class FunicularChatComponentTest < Funicular::Testing::DOMTest
+  def setup
+    super
+    Funicular::HTTP.__test_messages = [
+      { "id" => 1, "name" => "Alice", "body" => "Hello from Rails" }
+    ]
+  end
+
+  def test_renders_loaded_messages
+    mount FunicularChatComponent
+    drain
+
+    assert_text "Funicular Chat"
+    assert_text "Hello from Rails"
+  end
+end
+
+module Funicular
+  module HTTP
+    class << self
+      attr_accessor :__test_messages
+
+      def get(url, &block)
+        block.call(Response.new(200, __test_messages))
+      end
+
+      def post(url, body = nil, &block)
+        block.call(Response.new(201, { "id" => 2, "name" => body[:message][:name], "body" => body[:message][:body] }))
+      end
+    end
+  end
+
+  module Cable
+    class TestConsumer
+      attr_reader :subscriptions
+
+      def initialize
+        @subscriptions = TestSubscriptions.new
+      end
+
+      def cleanup
+      end
+    end
+
+    class TestSubscriptions
+      def create(params, &block)
+        TestSubscription.new
+      end
+    end
+
+    class TestSubscription
+      def on_connected(&block)
+        block.call
+      end
+
+      def unsubscribe
+      end
+    end
+
+    def self.create_consumer(url)
+      TestConsumer.new
+    end
+  end
+end

data/lib/generators/funicular/chat/templates/funicular_chat_controller.rb.tt

@@ -0,0 +1,4 @@
+class FunicularChatController < ApplicationController
+  def show
+  end
+end

data/lib/generators/funicular/chat/templates/funicular_chat_message.rb.tt

@@ -0,0 +1,13 @@
+class FunicularChatMessage < ApplicationRecord
+  validates :name, presence: true, length: { maximum: 40 }
+  validates :body, presence: true, length: { maximum: 500 }
+
+  def as_json(*)
+    {
+      id: id,
+      name: name,
+      body: body,
+      created_at: created_at.iso8601
+    }
+  end
+end

data/lib/generators/funicular/chat/templates/funicular_chat_messages_controller.rb.tt

@@ -0,0 +1,23 @@
+class FunicularChatMessagesController < ApplicationController
+  def index
+    messages = FunicularChatMessage.order(:created_at).last(50)
+    render json: messages
+  end
+
+  def create
+    message = FunicularChatMessage.new(message_params)
+
+    if message.save
+      ActionCable.server.broadcast("funicular_chat", message.as_json)
+      render json: message, status: :created
+    else
+      render json: { errors: message.errors.full_messages }, status: :unprocessable_entity
+    end
+  end
+
+  private
+
+  def message_params
+    params.require(:message).permit(:name, :body)
+  end
+end

data/lib/generators/funicular/chat/templates/initializer.rb.tt

@@ -0,0 +1,4 @@
+Funicular.start(container: "app") do |router|
+  router.get("/funicular_chat", to: FunicularChatComponent, as: "funicular_chat")
+  router.set_default("/funicular_chat")
+end

data/lib/generators/funicular/chat/templates/show.html.erb.tt

@@ -0,0 +1,6 @@
+<%% content_for :head do %>
+  <%%= stylesheet_link_tag "funicular_chat", "data-turbo-track": "reload" %>
+<%% end %>
+
+<%%= funicular_app_container %>
+<script type="application/x-mrb" src="<%%= asset_path("app.mrb") %>"></script>

data/lib/tasks/funicular.rake

@@ -4,6 +4,7 @@ namespace :funicular do
   desc "Compile Funicular Ruby files to .mrb format"
   task compile: :environment do
     require "funicular/compiler"
+    require "funicular/plugin"
 
     source_dir = Rails.root.join("app", "funicular")
     output_file = Rails.root.join("app", "assets", "builds", "app.mrb")
@@ -15,13 +16,20 @@ namespace :funicular do
     end
 
     begin
+      plugin_registry = Funicular::Plugin::Registry.new(Rails.root)
+      plugin_registry.validate!
+      plugin_registry.sync_assets
       compiler = Funicular::Compiler.new(
         source_dir: source_dir,
         output_file: output_file,
-        debug_mode: debug_mode
+        debug_mode: debug_mode,
+        prepend_source_files: plugin_registry.local_source_files
       )
       compiler.compile
-    rescue Funicular::Compiler::PicorbcNotFoundError => e
+    rescue Funicular::Plugin::Error => e
+      puts "ERROR: #{e.message}"
+      exit 1
+    rescue Funicular::Compiler::PicorbcMissingError => e
       puts "ERROR: #{e.message}"
       exit 1
     rescue => e
@@ -46,8 +54,8 @@ namespace :funicular do
     end
   end
 
-  desc "Install Funicular debug assets and PicoRuby.wasm artifacts into a Rails app"
-  task install: ["install:debug_assets", "install:wasm"] do
+  desc "Install Funicular debug assets, PicoRuby.wasm artifacts, and test support into a Rails app"
+  task install: ["install:debug_assets", "install:wasm", "install:test"] do
     puts ""
     puts "All Funicular assets installed."
     puts ""
@@ -64,6 +72,10 @@ namespace :funicular do
     puts '         <%= javascript_include_tag "funicular_debug", "data-turbo-track": "reload" %>'
     puts '         <%= stylesheet_link_tag "funicular_debug", "data-turbo-track": "reload" %>'
     puts '       <% end %>'
+    puts ""
+    puts "  4. Run `npm install` if package.json was created or updated."
+    puts "     Client-side Funicular tests live under test/funicular/client/**/*_picotest.rb"
+    puts "     and run through `bin/rails test`."
   end
 
   namespace :install do
@@ -126,6 +138,77 @@ namespace :funicular do
         puts "Installed PicoRuby #{variant} build to #{dst}"
       end
     end
+
+
+    desc "Install Funicular client test support"
+    task :test do
+      require "fileutils"
+      require "json"
+
+      test_dir = Rails.root.join("test")
+      funicular_test_dir = test_dir.join("funicular")
+      client_test_dir = funicular_test_dir.join("client")
+      FileUtils.mkdir_p(client_test_dir)
+
+      test_helper = test_dir.join("test_helper.rb")
+      unless File.exist?(test_helper)
+        File.write(test_helper, <<~TEST_HELPER)
+          ENV["RAILS_ENV"] ||= "test"
+
+          require_relative "../config/environment"
+          require "rails/test_help"
+        TEST_HELPER
+        puts "Installed #{test_helper}"
+      end
+
+      application_test = funicular_test_dir.join("application_test.rb")
+      unless File.exist?(application_test)
+        File.write(application_test, <<~APPLICATION_TEST)
+          require_relative "../test_helper"
+          require "funicular/testing"
+
+          class FunicularApplicationTest < ActiveSupport::TestCase
+            test "client-side Funicular tests" do
+              result = Funicular::Testing.run!(timeout_ms: 10_000)
+              Funicular::Testing.assert_picotests(self, result)
+            end
+          end
+        APPLICATION_TEST
+        puts "Installed #{application_test}"
+      end
+
+      keep_file = client_test_dir.join(".keep")
+      FileUtils.touch(keep_file) unless File.exist?(keep_file)
+
+      package_json = Rails.root.join("package.json")
+      package = if File.exist?(package_json)
+                  JSON.parse(File.read(package_json))
+                else
+                  { "private" => true }
+                end
+      package["devDependencies"] ||= {}
+      package["devDependencies"]["jsdom"] ||= "^26.1.0"
+      File.write(package_json, JSON.pretty_generate(package) + "\n")
+      puts "Updated #{package_json}"
+
+      gitignore = Rails.root.join(".gitignore")
+      if File.exist?(gitignore)
+        content = File.read(gitignore)
+        unless content.lines.any? { |line| line.chomp == "/node_modules" }
+          File.open(gitignore, "a") do |f|
+            f.puts
+            f.puts "# Ignore Node dependencies."
+            f.puts "/node_modules"
+          end
+          puts "Updated #{gitignore}"
+        end
+      end
+
+      puts "Installed Funicular test support:"
+      puts "  - #{application_test}"
+      puts "  - #{client_test_dir}"
+      puts "  - jsdom dev dependency in #{package_json}"
+    end
   end
 end