funicular 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d778a4d72fce90ad8e8403f40a32293431da06b47908e927a587ad725afa192
-  data.tar.gz: 1ded05e84560d65c99119e6e8603c04a8f130e40949ca476d6ec1419ba19cc82
+  metadata.gz: c20fca7e6590276dff1b8d10dcec31cc33a7c89070f2d515b28a39123358a7bb
+  data.tar.gz: f96247a21b413702c3e999a0588b4366e7cb356535eca53d472ca36abd331c62
 SHA512:
-  metadata.gz: 843a50c979823f2a307107958dab03e4414ebf37978bb968857336c6ba4436f48ab47322f3bf7b37ce27f2bd8030696d668c20c3adc52df7b01eb7c443c01d6d
-  data.tar.gz: 51f945d515798ee9804b4e11359f7ff7579024a8db8e392ef96c4bfa36867a0a6a52cedb8da8542abc7161be1fe256b3076ba345e39803407683e3523fbeef6f
+  metadata.gz: f592cbc26f7266a421846e0cb7f9445dcbc34458025d33d3da0ba140a5c3a3b5ee1c7b646ae56d7d5097162ed587ec92bcb402cc5da113d905deaae8bdb18a6c
+  data.tar.gz: 9967e115be234ee8c29e3a605192a398cef6f6de7413d833beaf08b23829752f049e9ced1590761a8b7b1f1cbaccc515efdc9ec5ff0fa431879c83e06c37c88f

data/CHANGELOG.md

@@ -1,4 +1,59 @@
-## [Unreleased]
+## [0.1.0] - 2026-04-20
+
+### Added
+
+- Consolidated with picoruby-funicular: merged the full PicoRuby frontend
+  framework into this gem, including Component, Cable, VDOM, Router,
+  FormBuilder, Model, HTTP, FileUpload, ErrorBoundary, Styles, Differ,
+  Patcher, Debug, and EnvironmentInquirer, along with RBS signatures and
+  comprehensive test suite
+- Bundle PicoRuby.wasm and picorbc WASM artifacts into the gem via a
+  `rake copy_wasm` task; artifacts are vendored at build time so no
+  runtime npm lookup is required
+- `Funicular::Configuration` with per-environment PicoRuby.wasm source
+  selection (`:local_debug`, `:local_dist`, `:cdn`) and optional
+  `cdn_version` override
+- `picoruby_include_tag` view helper (auto-registered via Railtie) that
+  serves the appropriate PicoRuby.wasm build per environment
+- `funicular:install:wasm` rake sub-task to copy dist/debug WASM builds
+  into `public/picoruby/`
+- Rails Asset Pipeline integration: Rack middleware, compiler, and
+  `funicular:compile` / `funicular:install` rake tasks
+- `funicular routes` CLI command and `Funicular::RouteParser` to inspect
+  Rails routes from the command line
+- Component Debug Highlighter: CSS/JS assets (`funicular_debug.css`,
+  `funicular_debug.js`) that highlight the selected component in the
+  browser
+- `ENV['FUNICULAR_ENV']` is now set from `Rails.env` in generated
+  `application.rb`
+
+### Changed
+
+- picorbc is now resolved from a vendored WASM artifact; removed
+  npm-based picorbc lookup and all `PICORBC_VERSION` environment variable
+  logic
+- Upgraded picorbc to the latest version
+- Switched test framework from test/unit to minitest
+
+### Fixed
+
+- Asset pipeline: middleware now detects whether `app.mrb` has actually
+  changed before recompiling, preventing unnecessary rebuilds
+- XSS vulnerabilities in VDOM attribute handling: expanded
+  `URL_ATTRIBUTES` constant, applied case-insensitive `javascript:` URI
+  blocking, and added the same URL validation to `Patcher#update_props`
+  and `Patcher#create_element`
+- XSS vulnerability in Debug module: replaced manual JSON string
+  concatenation with `JSON.generate` to eliminate escaping gaps
+- `funicular:compile` rake task
+- `funicular:install` rake task
+- Rack middleware
+- RBS type signatures
+
+### Removed
+
+- Debugger Chrome extension (`debugger/` directory)
+- `.ruby-version` file
 
 ## [0.0.1] - 2025-11-27
 

data/README.md

@@ -1,43 +1,81 @@
 # Funicular
 
-TODO: Delete this and the text below, and describe your gem
+> 🎵Funicu-lì, Funicu-là!🚊🚊🚊
+>
+> 🎵Funicu-lì, Funicu-là!🚞🚞🚞
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/funicular`. To experiment with that code, run `bin/console` for an interactive prompt.
+**Funicular** is a single-page application (SPA) framework powered by PicoRuby.wasm.
 
-## Installation
+## Features
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+- Write client-side code in Ruby instead of JavaScript
+- Seamless Rails integration
 
-Install the gem and add to the application's Gemfile by executing:
+## Combined Gem
 
-```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+This repository consists of three relevant projects:
+
+- PicoGem "picoruby-funicular" ... Core implementation
+- CRubyGem "funicular" ... Rails integration
+- Chrome extension "PicoRuby Debugger"
+
+### PicoGem "picoruby-funicular"
+
+```console
+.
+├── mrbgem.rake
+├── mrblib/
+└── test/
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+### CRubyGem "funicular"
+
+```console
+.
+├── bin/
+├── exe/
+├── funicular.gemspec
+├── Gemfile
+├── Gemfile.lock
+├── lib/
+├── minitest/
+└── Rakefile
+```
+
+### Chrome extention "PicoRuby.wasm debugger"
 
-```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```console
+.
+└── debugger/
 ```
 
-## Usage
+----
+
+The others are common resources.
 
-TODO: Write usage instructions here
+## Documentation
+
+You may want to see Tic-Tac-Toe tutorial first: [https://picoruby.org/funicular](https://picoruby.org/funicular)
+
+Then, dig [docs/](docs/).
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+This repository is a submodule of [picoruby/picoruby](https://github.com/picoruby/picoruby).
+Do not check it out standalone. Instead, clone the parent repository and work from there:
+
+```console
+git clone --recurse-submodules https://github.com/picoruby/picoruby.git
+cd picoruby/mrbgems/picoruby-funicular
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+The CRubyGem side (`lib/`, `funicular.gemspec`, etc.) can be developed and tested independently inside that directory, but `rake copy_wasm` — which vendorsthe PicoRuby.wasm and picorbc wasm artifacts into the gem — relies on sibling directories within the picoruby repository (`mrbgems/picoruby-wasm/npm/`).
+Running it from a standalone checkout will fail.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/funicular. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/funicular/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/picoruby/funicular.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the Funicular project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/funicular/blob/master/CODE_OF_CONDUCT.md).
+Copyright © 2025- HASUMI Hitoshi. See MIT-LICENSE for further details.

data/Rakefile

@@ -4,9 +4,81 @@ require "bundler/gem_tasks"
 require "rake/testtask"
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
+  t.libs << "minitest"
   t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
+  t.test_files = FileList["minitest/**/*_test.rb"]
 end
 
 task default: :test
+
+desc "Copy picoruby and picorbc wasm artifacts from picoruby-wasm into the gem"
+task :copy_wasm do
+  require "fileutils"
+  require "json"
+
+  vendor_root = File.expand_path("lib/funicular/vendor", __dir__)
+
+  # PICORUBY_WASM_NPM_DIR overrides the default search path.
+  # Default: picoruby-wasm is a sibling of picoruby-funicular under mrbgems/.
+  npm_root = ENV["PICORUBY_WASM_NPM_DIR"] ||
+             File.expand_path("../picoruby-wasm/npm", __dir__)
+
+  unless Dir.exist?(npm_root)
+    abort "picoruby-wasm npm directory not found: #{npm_root}\n" \
+          "Set PICORUBY_WASM_NPM_DIR to override, and ensure picoruby-wasm has been built."
+  end
+
+  # ------------------------------------------------------------------
+  # 1) PicoRuby runtime (browser): dist + debug
+  # ------------------------------------------------------------------
+  picoruby_src  = File.join(npm_root, "picoruby")
+  picoruby_dest = File.join(vendor_root, "picoruby")
+  abort "Missing #{picoruby_src}" unless Dir.exist?(picoruby_src)
+
+  picoruby_version = JSON.parse(File.read(File.join(picoruby_src, "package.json"))).fetch("version")
+  picoruby_files = %w[picoruby.wasm picoruby.js init.iife.js]
+
+  %w[dist debug].each do |variant|
+    src = File.join(picoruby_src, variant)
+    dst = File.join(picoruby_dest, variant)
+    abort "Missing source variant: #{src}" unless Dir.exist?(src)
+
+    FileUtils.rm_rf(dst)
+    FileUtils.mkdir_p(dst)
+    picoruby_files.each do |fname|
+      src_file = File.join(src, fname)
+      abort "Missing file: #{src_file}" unless File.exist?(src_file)
+      # FileUtils.copy_file follows symlinks, so debug/init.iife.js
+      # (a symlink to ../dist/init.iife.js) is materialized.
+      FileUtils.copy_file(src_file, File.join(dst, fname))
+    end
+    puts "  copied picoruby/#{variant}"
+  end
+
+  File.write(File.join(picoruby_dest, "VERSION"), "#{picoruby_version}\n")
+  puts "  wrote picoruby/VERSION (#{picoruby_version})"
+
+  # ------------------------------------------------------------------
+  # 2) picorbc compiler (node CLI, run by Funicular::Compiler)
+  # ------------------------------------------------------------------
+  picorbc_src  = File.join(npm_root, "picorbc", "debug")
+  picorbc_dest = File.join(vendor_root, "picorbc")
+  abort "Missing #{picorbc_src}" unless Dir.exist?(picorbc_src)
+
+  picorbc_version = JSON.parse(File.read(File.join(npm_root, "picorbc", "package.json"))).fetch("version")
+  picorbc_files = %w[picorbc.js picorbc.wasm]
+
+  FileUtils.rm_rf(picorbc_dest)
+  FileUtils.mkdir_p(picorbc_dest)
+  picorbc_files.each do |fname|
+    src_file = File.join(picorbc_src, fname)
+    abort "Missing file: #{src_file}" unless File.exist?(src_file)
+    FileUtils.copy_file(src_file, File.join(picorbc_dest, fname))
+  end
+  File.chmod(0755, File.join(picorbc_dest, "picorbc.js"))
+  File.write(File.join(picorbc_dest, "VERSION"), "#{picorbc_version}\n")
+  puts "  copied picorbc (#{picorbc_version})"
+end
+
+# Make sure the wasm artifacts are refreshed before the gem is packaged for release.
+Rake::Task["build"].enhance([:copy_wasm])