ikura 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 18b5d492ca45d8e35c47fc6ae5b776465b1c97bbbea3c6bc8685860ff006b638
+  data.tar.gz: 48a96a16a338ff94097e3b17c8435ec13c2746568fa5e5cade896cf158e2d623
+SHA512:
+  metadata.gz: b28cb7014d7a2896230d81e19b24685f75a625164f48fb289146b27c4d29b06b0759d173d6421da7634b57c07c32c7838b9f918f7f9accba90dd0cad70b38dbe
+  data.tar.gz: 541e6c46e6a8708e03610caa899d511caa15db2a191423c2de5f8c9a8306682c803c69af68f4c9e53d198b3b875a6c4181d799d0896dfcd3e3e14b4b02e8e97a

data/.ruby-version

@@ -0,0 +1 @@
+4.0.2

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## [0.1.0] - 2026-04-04
+
+### Added
+
+- Initial release
+- Interactive gunkan-maki sushi toy server
+- Click on the sushi to place ikura (salmon roe) via Ruby running in WebAssembly
+- Turbo Stream-based DOM updates without a frontend framework

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in ikura.gemspec
+gemspec
+
+gem "rake", "~> 13.0"

data/README.md

@@ -0,0 +1,56 @@
+# Ikura
+
+An interactive gunkan-maki sushi toy server powered by Ruby Wasm.
+
+Click anywhere on the sushi in the browser to place ikura (salmon roe). The click handling runs entirely in Ruby via WebAssembly, and DOM updates are delivered as Turbo Streams — no frontend framework required.
+
+The server is built on Ruby's built-in `socket` library (TCPServer), so there are **no external runtime dependencies**.
+
+## Installation
+
+```
+gem install ikura
+```
+
+Or add to your Gemfile:
+
+```
+bundle add ikura
+```
+
+## Usage
+
+Start the server:
+
+```
+ikura
+```
+
+Then open [http://localhost:8080](http://localhost:8080) in your browser.
+
+To use a custom port:
+
+```ruby
+require "ikura"
+Ikura::Server.start(port: 3000)
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt.
+
+To install this gem onto your local machine:
+
+```
+bundle exec rake install
+```
+
+To release a new version, update `lib/ikura/version.rb`, then run:
+
+```
+bundle exec rake release
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/haruna-tsujita/ikura.

data/Rakefile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.pattern = "test/**/test_*.rb"
+end
+
+task default: %i[test]

data/exe/ikura

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/ikura"
+
+Ikura::Server.start

data/lib/ikura/builder.rb

@@ -0,0 +1,7 @@
+module Ikura
+  module Builder
+    def self.append(target, content)
+      %(<turbo-stream action="append" target="#{target}"><template>#{content}</template></turbo-stream>)
+    end
+  end
+end

data/lib/ikura/server.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require "socket"
+require "uri"
+require "erb"
+
+module Ikura
+  class Server
+    TEMPLATE_PATH = File.join(__dir__, "templates", "ikura.html.erb")
+
+    def self.start(port: 8080)
+      new(port:).run
+    end
+
+    COORDS = [
+      [50, 50], [35, 50], [65, 50], [20, 50], [80, 50],
+      [50, 15], [35, 22], [65, 22], [20, 35], [80, 35],
+      [50, 85], [35, 78], [65, 78], [20, 65], [80, 65],
+      [10, 50], [90, 50],
+      [50, 30], [50, 70], [28, 38], [72, 38], [28, 62], [72, 62],
+    ].freeze
+
+    def initialize(port: 8080)
+      @port = port
+      @ikura_count = 0
+    end
+
+    def run
+      server = TCPServer.new(@port)
+      $stdout.sync = true
+      puts "🍣  http://localhost:#{@port}"
+      puts "    (Ctrl+C to stop)\n\n"
+
+      loop do
+        client = server.accept
+        req = parse_request(client)
+        next unless req
+
+        puts "#{req[:method]} #{req[:path]}"
+        handle(client, req)
+        client.close
+      rescue => e
+        STDERR.puts "Error: #{e}"
+        client&.close
+      end
+    end
+
+    private
+
+    def handle(client, req)
+      case [req[:method], req[:path]]
+      in ["GET", "/"]
+        respond(client, type: "text/html; charset=utf-8", body: html_page)
+      in ["POST", "/ikura"]
+        coord_idx = parse_form(req[:body])["coord"]&.to_i || 0
+        x, y = COORDS[coord_idx] || [50, 50]
+        id = @ikura_count
+        @ikura_count += 1
+
+        jx = (x + rand(-8..8)).clamp(5, 95)
+        jy = (y + rand(-8..8)).clamp(5, 95)
+
+        respond(client,
+          type: "text/vnd.turbo-stream.html; charset=utf-8",
+          body: Ikura::Builder.append("ikura-layer",
+            "<li id='ikura_#{id}' class='ikura' style='left:#{jx}%;top:#{jy}%'></li>"))
+
+        puts "  → append ikura_#{id} at (#{jx}%, #{jy}%)"
+      else
+        respond(client, status: "404 Not Found", type: "text/plain", body: "Not found")
+      end
+    end
+
+    def html_page
+      coords_html = COORDS.each_with_index.map { |(x, y), i|
+        "<div class='coord' style='left:#{x}%;top:#{y}%'></div>"
+      }.join("\n")
+
+      ERB.new(File.read(TEMPLATE_PATH)).result(binding)
+    end
+
+    def parse_request(client)
+      line = client.gets
+      return nil unless line
+
+      method, path, _ = line.split(" ")
+
+      headers = {}
+      while (l = client.gets) && l.chomp != ""
+        key, val = l.split(": ", 2)
+        headers[key.strip.downcase] = val&.strip
+      end
+
+      body = nil
+      if (len = headers["content-length"]&.to_i)&.positive?
+        body = client.read(len)
+      end
+
+      { method:, path:, headers:, body: }
+    end
+
+    def parse_form(body)
+      URI.decode_www_form(body.to_s).to_h
+    end
+
+    def respond(client, status: "200 OK", type:, body:)
+      client.print "HTTP/1.1 #{status}\r\n"
+      client.print "Content-Type: #{type}\r\n"
+      client.print "Content-Length: #{body.bytesize}\r\n"
+      client.print "Access-Control-Allow-Origin: *\r\n"
+      client.print "Access-Control-Allow-Methods: GET, POST, DELETE, OPTIONS\r\n"
+      client.print "Access-Control-Allow-Headers: Content-Type, Accept\r\n"
+      client.print "Connection: close\r\n"
+      client.print "\r\n"
+      client.print body
+    end
+  end
+end

data/lib/ikura/templates/ikura.html.erb

@@ -0,0 +1,114 @@
+<!DOCTYPE html>
+<html lang="ja">
+  <head>
+    <meta charset="UTF-8">
+    <title>🍣 Ikura</title>
+    <script type="module">
+      import { DefaultRubyVM } from "https://cdn.jsdelivr.net/npm/@ruby/wasm-wasi@2.8.1/dist/browser/+esm";
+      const res = await fetch("https://cdn.jsdelivr.net/npm/@ruby/4.0-wasm-wasi@2.8.1/dist/ruby+stdlib.wasm");
+      const { vm } = await DefaultRubyVM(await WebAssembly.compileStreaming(res));
+      window.rubyVM = vm;
+      vm.eval(`
+require "js"
+doc   = JS.global[:document]
+nodes = doc.call(:querySelectorAll, ".coord")
+nodes[:length].to_i.times do |i|
+  node = nodes.call(:item, i)
+  node[:style][:opacity] = "1"
+  node.call(:addEventListener, "click", ->(event) {
+    opts = JS.eval("return {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+      body: 'coord=#{i}'
+    }")
+    JS.global.fetch("/ikura", opts).call(:then, ->(response) {
+      response.text().call(:then, ->(text) {
+        doc = JS.global[:document]
+        div = doc.call(:createElement, "div")
+        div[:innerHTML] = text.to_s
+        div.call(:querySelectorAll, "turbo-stream")[:length].to_i.times do |j|
+          el          = div.call(:querySelectorAll, "turbo-stream").call(:item, j)
+          action      = el.call(:getAttribute, "action").to_s
+          target      = el.call(:getAttribute, "target").to_s
+          content     = el.call(:querySelector, "template")[:innerHTML].to_s rescue ""
+          target_node = doc.call(:getElementById, target)
+          case action
+          when "append" then target_node.call(:insertAdjacentHTML, "beforeend", content)
+          end
+        end
+        nil
+      })
+      nil
+    })
+    nil
+  })
+end
+      `);
+    </script>
+    <style>
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      body { background: #ffffff; overflow: hidden; width: 100vw; height: 100vh; }
+
+      #board { position: relative; width: 100vw; height: 100vh; }
+
+      .gunkan {
+        position: absolute;
+        left: 50%; top: 50%;
+        transform: translate(-50%, -50%);
+        width: 140px;
+        height: 120px;
+        background: #1b2b1b;
+        border-radius: 50% / 20%;
+        box-shadow: inset 0 -10px 20px rgba(0,0,0,0.5);
+        z-index: 10;
+        pointer-events: none;
+      }
+      .gunkan-top {
+        position: absolute;
+        top: 2px; left: 8px;
+        width: 124px; height: 40px;
+        background: radial-gradient(ellipse at 50% 60%, #f8f4ec, #e8e0cc);
+        border-radius: 50%;
+      }
+
+      .coord {
+        position: absolute;
+        transform: translate(-50%, -50%);
+        width: 16px; height: 16px;
+        cursor: crosshair;
+        pointer-events: all;
+        opacity: 0;
+      }
+
+      #ikura-layer {
+        position: absolute; inset: 0;
+        pointer-events: none; list-style: none;
+      }
+
+      .ikura {
+        position: absolute;
+        transform: translate(-50%, -50%);
+        width: 14px; height: 14px;
+        border-radius: 50%;
+        background: radial-gradient(circle at 35% 30%, #ffbb66, #cc2200);
+        border: 1px solid rgba(255,180,100,0.3);
+        animation: pop 0.2s cubic-bezier(0.175, 0.885, 0.32, 1.275);
+      }
+      @keyframes pop {
+        from { transform: translate(-50%, -50%) scale(0); opacity: 0; }
+        to   { transform: translate(-50%, -50%) scale(1); opacity: 1; }
+      }
+    </style>
+  </head>
+  <body>
+    <div id="board">
+      <div class="gunkan">
+        <div class="gunkan-top">
+          <%= coords_html %>
+          <ul id="ikura-layer"></ul>
+        </div>
+      </div>
+    </div>
+
+  </body>
+</html>

data/lib/ikura/version.rb

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

data/lib/ikura.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "ikura/version"
+require_relative "ikura/builder"
+require_relative "ikura/server"
+
+module Ikura
+end

data/sig/ikura.rbs

@@ -0,0 +1,4 @@
+module Ikura
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: ikura
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- haruna-tsujita
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Ikura is a tiny HTTP server that renders an interactive gunkan-maki sushi
+  in the browser. Click anywhere on the sushi to place ikura (salmon roe) using Ruby
+  running in WebAssembly.
+email:
+- snwxxx29@gmail.com
+executables:
+- ikura
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ruby-version"
+- CHANGELOG.md
+- Gemfile
+- README.md
+- Rakefile
+- exe/ikura
+- lib/ikura.rb
+- lib/ikura/builder.rb
+- lib/ikura/server.rb
+- lib/ikura/templates/ikura.html.erb
+- lib/ikura/version.rb
+- sig/ikura.rbs
+homepage: https://github.com/haruna-tsujita/ikura
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/haruna-tsujita/ikura
+  source_code_uri: https://github.com/haruna-tsujita/ikura/tree/master
+  changelog_uri: https://github.com/haruna-tsujita/ikura/blob/master/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: An interactive gunkan-maki sushi toy server powered by Ruby Wasm
+test_files: []