atome-opal-browser 0.3.9.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9dbdd6e9d572cae1acb8b53fa2daaf4492bef554d84c2c0e989ad43d32bb34ba
+  data.tar.gz: b5bb70c2406c0143d4b1a5a2be3bba7151d707e20615965134a09b2a894b046c
+SHA512:
+  metadata.gz: 8b75e9ed30ed18b07bad5356fb1df35dfcb63ee9ca16ccdb7011f740a01b3dec97e6893a1917c26fe48043385e3b3b680b2aa631073e9c814b1cca8e43fd4892
+  data.tar.gz: 84a211f8fc03ac41e5e9af2d9028b00b2ca8f6745f020983a1ac5d1114e63e3276f8ec53f792a1ba9e44affae18ab05599e29446a18042d61b901d8f719a7bc9

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+## 0.3.3
+* Compatibility fix for Opal 1.4
+
+## 0.3.2
+* Cookie: refactor the module
+  * Note in documentation it's available as `$document.cookies` and it's the preferred way to access it
+  * Always encode a cookie with JSON, unless a new parameter `raw:` is provided
+
+## 0.3.1
+* Element#inner_dom: Reduce flickering - first build tree, then insert it
+* NodeSet#to_a to be aliased to #to_ary

data/Gemfile

@@ -0,0 +1,33 @@
+source 'https://rubygems.org'
+gemspec
+
+# specs
+gem 'rake'
+gem 'rack'
+gem 'sinatra'
+gem 'sinatra-websocket'
+gem 'opal-rspec'
+gem 'opal-sprockets'
+# Force build of eventmachine... I wish we could find a way to not use
+# this unmaintained library anymore.
+gem 'eventmachine', github: 'eventmachine/eventmachine'
+gem 'thin', github: 'macournoyer/thin' unless RUBY_PLATFORM =~ /mingw/
+
+# runner
+gem 'selenium-webdriver', require: false
+gem 'rest-client', require: false
+gem 'webdrivers', require: false
+gem 'rexml', require: false
+
+# browser
+case ENV['OPAL_VERSION']
+when nil
+  # noop
+when ->(path) { File.exist? path }
+  gem 'opal', path: ENV['OPAL_VERSION']
+when /\./
+  gem 'opal', "~> #{ENV['OPAL_VERSION']}.0a"
+else
+  gem 'opal', github: 'opal/opal', ref: ENV['OPAL_VERSION']
+end
+

data/Gemfile.lock

@@ -0,0 +1,122 @@
+GIT
+  remote: https://github.com/eventmachine/eventmachine.git
+  revision: df4ab0068e5e9f504096584093a74510d0dac6c8
+  specs:
+    eventmachine (1.3.0.dev.1)
+
+GIT
+  remote: https://github.com/macournoyer/thin.git
+  revision: 10607a2663fc282d67f98a930f954dc407fd056d
+  specs:
+    thin (1.8.1)
+      daemons (~> 1.0, >= 1.0.9)
+      eventmachine (~> 1.0, >= 1.0.4)
+      rack (>= 1, < 3)
+
+PATH
+  remote: .
+  specs:
+    opal-browser (0.3.9.3)
+      opal (>= 1.0, < 2.0)
+      paggio (~> 0.3.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.1)
+      public_suffix (>= 2.0.2, < 6.0)
+    ast (2.4.2)
+    childprocess (4.1.0)
+    concurrent-ruby (1.1.10)
+    daemons (1.4.1)
+    domain_name (0.5.20190701)
+      unf (>= 0.0.5, < 1.0.0)
+    em-websocket (0.3.8)
+      addressable (>= 2.1.1)
+      eventmachine (>= 0.12.9)
+    http-accept (1.7.0)
+    http-cookie (1.0.5)
+      domain_name (~> 0.5)
+    mime-types (3.4.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2022.0105)
+    mustermann (3.0.0)
+      ruby2_keywords (~> 0.0.1)
+    netrc (0.11.0)
+    nokogiri (1.13.9-arm64-darwin)
+      racc (~> 1.4)
+    opal (1.5.1)
+      ast (>= 2.3.0)
+      parser (~> 3.0, >= 3.0.3.2)
+    opal-rspec (0.8.0)
+      opal (>= 1.0.0, < 2.0)
+      opal-sprockets (< 2.0)
+      rake (>= 12.0)
+    opal-sprockets (1.0.3)
+      opal (>= 1.0, < 2.0)
+      sprockets (~> 4.0)
+      tilt (>= 1.4)
+    paggio (0.3.0)
+    parser (3.1.2.1)
+      ast (~> 2.4.1)
+    public_suffix (5.0.0)
+    racc (1.6.0)
+    rack (2.2.4)
+    rack-protection (3.0.2)
+      rack
+    rake (13.0.6)
+    rest-client (2.1.0)
+      http-accept (>= 1.7.0, < 2.0)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
+    rexml (3.2.5)
+    ruby2_keywords (0.0.5)
+    rubyzip (2.3.2)
+    selenium-webdriver (4.5.0)
+      childprocess (>= 0.5, < 5.0)
+      rexml (~> 3.2, >= 3.2.5)
+      rubyzip (>= 1.2.2, < 3.0)
+      websocket (~> 1.0)
+    sinatra (3.0.2)
+      mustermann (~> 3.0)
+      rack (~> 2.2, >= 2.2.4)
+      rack-protection (= 3.0.2)
+      tilt (~> 2.0)
+    sinatra-websocket (0.3.1)
+      em-websocket (~> 0.3.6)
+      eventmachine
+      thin (>= 1.3.1, < 2.0.0)
+    sprockets (4.1.1)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    tilt (2.0.11)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.8.2)
+    webdrivers (5.2.0)
+      nokogiri (~> 1.6)
+      rubyzip (>= 1.3.0)
+      selenium-webdriver (~> 4.0)
+    websocket (1.2.9)
+
+PLATFORMS
+  arm64-darwin-22
+
+DEPENDENCIES
+  eventmachine!
+  opal-browser!
+  opal-rspec
+  opal-sprockets
+  rack
+  rake
+  rest-client
+  rexml
+  selenium-webdriver
+  sinatra
+  sinatra-websocket
+  thin!
+  webdrivers
+
+BUNDLED WITH
+   2.3.24

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (C) 2013-2018 by meh
+Copyright (C) 2019-2021 hmdne and the Opal-Browser contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,301 @@
+Opal-Browser - Client side web development in pure Ruby, using Opal
+===================================================================
+
+[![Gem Version](https://badge.fury.io/rb/opal-browser.svg)](http://badge.fury.io/rb/opal-browser)
+[![Code Climate](https://img.shields.io/codeclimate/maintainability-percentage/opal/opal-browser.svg)](https://codeclimate.com/github/opal/opal-browser)
+[![Build Status](https://github.com/opal/opal-browser/workflows/build/badge.svg)](https://github.com/opal/opal-browser/actions?query=workflow%3Abuild)
+[![Join Chat](https://img.shields.io/badge/slack-join%20chat-46BC99?logo=slack&style=flat)](https://slack.opalrb.com/)
+[![Stack Overflow](https://img.shields.io/badge/stackoverflow-%23opalrb-orange.svg?style=flat)](https://stackoverflow.com/questions/ask?tags=opalrb,opal-browser)
+[![Documentation](https://img.shields.io/badge/docs-updated-blue.svg)](https://rubydoc.info/gems/opal-browser)
+
+This library aims to be a full-blown wrapper for all the browser API as defined by
+HTML5.
+
+It provides a very JQuery-like interface to DOM, but itself it doesn't use nor
+require JQuery nor opal-jquery (which is an alternative library for interfacing
+the web browser). The main difference though is that Opal-Browser goes far beyond
+what JQuery does.
+
+Usage
+=====
+
+_Gemfile_
+
+```ruby
+source 'https://rubygems.org/'
+
+gem 'opal-browser'
+```
+
+_Server side (config.ru, Rakefile, Rails, Sinatra, Roda, etc. - not needed for static compilation)_
+
+```ruby
+require 'opal-browser'
+# Your server code here
+```
+
+_Browser side_
+
+```ruby
+require 'opal'
+require 'native'
+require 'promise'
+require 'browser/setup/full'
+
+# Your Opal code here
+$document.body << "Hello world!"
+```
+
+_Static Compile Opal + Opal-Browser library_
+
+```bash
+bundle exec opal -c -q opal-browser -p native -p promise -p browser/setup/full -e '#' -E > opal-browser.js
+```
+
+_Static Compile your application_
+
+```bash
+bundle exec opal -Oc -s opal -s native -s promise -s browser/setup/full app/application.rb > application.js
+```
+
+_And load it in HTML!_
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <title>My Application</title>
+</head>
+<body>
+  <script src='opal-browser.js' onload='Opal.require("native"); Opal.require("promise"); Opal.require("browser/setup/full");'></script>
+  <script src='application.js'></script>
+</body>
+</html>
+```
+
+See the `examples/integrations/` directory for various ideas on how to quickly start
+development using opal-browser.
+
+Features
+========
+This is a list of many currently wrapped features and some details on them.
+
+DOM
+---
+DOM support is complete as far as I know, it has a very Nokogiri feel to it
+with obvious differences where relevant (for instance, event handling).
+
+```ruby
+$document.ready do
+  alert "yo dawg, I'm all loaded up in here"
+end
+```
+
+It also supports a markaby inspired builder DSL (using Paggio) which generates
+DOM nodes directly instead of creating a string.
+
+```ruby
+$document.ready do
+  DOM {
+    div.info {
+      span.red "I'm all cooked up."
+    }
+  }.append_to($document.body)
+end
+```
+
+Events
+------
+
+Add an event to a given element:
+
+```ruby
+$document.at_css("button").on(:click) do |e|
+  e.prevent # Prevent the default action (eg. form submission)
+  # You can also use `e.stop` to stop propagating the event to other handlers.
+  alert "Button clicked!"
+end
+```
+
+Or add it to a parent element and use a delegator, so that an event gets fired
+when any button children of `$document` is clicked:
+
+```ruby
+$document.on(:click, "button") do |e|
+  e.prevent
+  # e.on is a button that has been clicked
+  e.on.inner_text = "Clicked!"
+end
+```
+
+Run an event once with `#one` instead of `#on`, or disable an event with `#off`.
+
+CSSOM
+-----
+CSSOM support (using Paggio) is still incomplete but the useful parts are
+implemented, this includes a DSL for generating a CSS style and the same DSL
+is also used to change style declarations (which can either belong to a
+`DOM::Element` or a `CSS::Rule::Style`).
+
+```ruby
+$document.body.style.apply {
+  background color: 'black'
+  color 'white'
+  font family: 'Verdana'
+}
+```
+
+AJAX & SJAX
+-----------
+The `XMLHttpRequest` API has been wrapped completely, it also optionally
+supports binary results as typed-arrays.
+
+It easily allows for synchronous and asynchronous requests.
+
+```ruby
+require 'browser/http'
+
+Browser::HTTP.get "/something.json" do
+  on :success do |res|
+    alert res.json.inspect
+  end
+end
+```
+
+WebSocket
+---------
+Websockets have been fully wrapped and they are easily configurable with
+blocks.
+
+```ruby
+require 'browser/socket'
+
+Browser::Socket.new 'ws://echo.websocket.org' do
+  on :open do
+    every 1 do
+      puts "ping"
+    end
+  end
+
+  on :message do |e|
+    log "Received #{e.data}"
+  end
+end
+```
+
+EventSource
+-----------
+Event sources have been implemented and are easily configurable with blocks.
+
+```ruby
+require 'browser/event_source'
+
+Browser::EventSource.new '/events' do |es|
+  es.on :message do |e|
+    alert e.data
+  end
+
+  es.on :custom do |e|
+    alert "custom #{e.data}"
+  end
+end
+```
+
+History
+-------
+The HTML5 History API has been fully wrapped.
+
+```ruby
+current = $window.history.current
+$window.history.replace("?get=params")
+$window.history.push("?get=params")
+$window.history.back
+
+$window.on :popstate do |e|
+  p "User clicked a back button! He is now on #{$window.history.current}"
+end
+```
+
+Storage
+-------
+The HTML5 Storage API has been wrapped and it exports a single Storage class
+that uses the most appropriate and available API to store data locally.
+
+```ruby
+require 'browser/storage'
+
+$storage = $window.storage
+$storage[:hello] = "world"
+```
+
+Database SQL
+------------
+WebSQL has been fully wrapped (Chromium-only)
+
+```ruby
+require 'browser/database/sql'
+
+db = Browser::Database::SQL.new 'test'
+db.transaction {|t|
+  t.query('CREATE TABLE test(ID INTEGER PRIMARY KEY ASC, text TEXT)').then {
+    t.query('INSERT INTO test (id, text) VALUES(?, ?)', 1, 'huehue')
+  }.then {
+    t.query('INSERT INTO test (id, text) VALUES(?, ?)', 2, 'jajaja')
+  }.then {
+    t.query('SELECT * FROM test')
+  }.then {|r|
+    r.each {|row|
+      alert row.inspect
+    }
+  }
+}
+```
+
+Browser support
+===============
+
+* Edge (Current - 3) to Current
+* Firefox (Current - 3) to Current
+* Chrome (Current - 3) to Current
+* Safari (Current - 3) to Current
+* Opera (Current - 3) to Current
+
+Any problem above browsers should be considered and reported as a bug.
+
+(Current - 3) to Current denotes that we support the current major stable version
+of the browser and 3 versions preceding it. For example, if the current version
+of a browser is 24.x, we support all versions between 21.x to 24.x.
+
+We will accept compatibility patches for even earlier browser versions. Opal-Browser
+is written in such a way, that it integrates a robust compatibility check system,
+similar to Modernizr, and the history of this library goes even as far as supporting
+Internet Explorer 6.
+
+See the [polyfills documentation](docs/polyfills.md) if you wish to polyfill some
+behaviors not supported by the ancient web browsers (like `querySelectorAll`).
+
+License
+=======
+
+(The MIT License)
+
+Copyright (C) 2013-2018 by meh<br>
+Copyright (C) 2019-2021 hmdne and the Opal-Browser contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,63 @@
+require 'bundler'
+Bundler.require
+require 'bundler/gem_tasks'
+
+require 'webdrivers'
+load 'webdrivers/Rakefile'
+
+require 'opal/rspec/rake_task'
+Opal::RSpec::RakeTask.new(:broken_rspec) do |_, task|
+  task.default_path = 'spec'
+  task.pattern = 'spec/**/*_spec.{rb,opal}'
+end
+
+task(:nil) {}
+
+%w[chrome edge gecko safari].each do |i|
+  dependency = nil
+  if %w[chrome edge gecko].include? i
+    dependency = "webdrivers:#{i}driver:update"
+  end
+  desc "Run Selenium tests with #{i}"
+  task :"selenium_#{i}" => dependency do
+    server = Process.spawn("bundle", "exec", "rackup")
+    at_exit { Process.kill(9, server) rescue nil }
+    sleep 2
+    ENV['BROWSER'] = i
+    load 'spec/runner.rb'
+  ensure
+    Process.kill(9, server) rescue nil
+  end
+end
+
+task :default => :selenium_chrome
+
+task :build_gh_pages do
+  require 'fileutils'
+
+  output_dir = __dir__+"/gh-pages/examples/"
+  FileUtils.mkdir_p output_dir
+
+  Dir['examples/*'].reject { |i| i =~ /integrations|svg/ }.each do |example_path|
+    example = File.basename(example_path)
+
+    output_example_dir = output_dir+"/"+example
+    FileUtils.mkdir_p output_example_dir
+
+    Dir.chdir(example_path) do
+      Bundler.with_unbundled_env do
+        `bundle install`
+        `bundle exec opal -qopal-browser -c app/application.rb > #{output_example_dir}/app.js`
+      end
+      File.write("#{output_example_dir}/index.html", <<~HTML)
+        <!DOCTYPE html>
+        <html>
+          <head></head>
+          <body>
+            <script src="app.js"></script>
+          </body>
+        </html>
+      HTML
+    end
+  end
+end

data/bin/rake

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+gem install bundler --conservative
+
+bundle update

data/config.ru

@@ -0,0 +1,81 @@
+require 'bundler'
+Bundler.require
+
+apps = []
+
+sprockets_env = Opal::RSpec::SprocketsEnvironment.new(spec_pattern         = 'spec/**/*_spec.{rb,opal}',
+                                                      spec_exclude_pattern = nil,
+                                                      spec_files           = nil,
+                                                      default_path         = 'spec')
+
+apps << Opal::Sprockets::Server.new(sprockets: sprockets_env) { |s|
+  s.main = 'opal/rspec/sprockets_runner'
+  s.append_path 'spec'
+  s.index_path = 'index.html.erb'
+  s.debug = true
+}
+
+apps << Class.new(Sinatra::Base) {
+  get '/http' do
+    "lol"
+  end
+
+  post '/http' do
+    if params['lol'] == 'wut'
+      "ok"
+    else
+      "fail"
+    end
+  end
+
+  put '/http' do
+    if params['lol'] == 'wut'
+      "ok"
+    else
+      "fail"
+    end
+  end
+
+  delete '/http' do
+    "lol"
+  end
+
+  post '/http-file' do
+    if params['lol'] == 'wut' && 
+       params['file'][:filename] == 'yay.txt' && 
+       params['file'][:tempfile].read == 'content'
+
+      "ok"
+    else
+      "fail"
+    end
+  end
+
+  get '/events' do
+    headers 'Content-Type' => 'text/event-stream'
+
+    stream do |out|
+      sleep 0.2
+
+      out << "data: lol\n" << "\n"
+      out << "event: custom\n" << "data: omg\n" << "\n"
+      out << "data: wut\n" << "\n"
+
+      sleep 10
+    end
+  end
+
+  get '/socket' do
+    request.websocket do |ws|
+      ws.onopen do
+        ws.send 'lol'
+      end
+
+      ws.onmessage do |msg|
+        ws.send msg
+      end
+    end
+  end
+}
+
+run Rack::Cascade.new(apps)

data/docs/polyfills.md

@@ -0,0 +1,24 @@
+CSS selectors
+-------------
+Older browsers do not support CSS selector in queries, this means you'll need
+external polyfills for this.
+
+The suggested polyfill is [Sizzle](http://sizzlejs.com/), require it **before**
+opal-browser.
+
+JSON parsing
+------------
+Older browsers don't support JSON parsing natively, this means you'll need
+external polyfills for this.
+
+The suggested polyfill is [json2](https://github.com/douglascrockford/JSON-js),
+require it **before** opal-browser.
+
+XPath support
+-------------
+Not all browsers support XPath queries, I'm looking at you Internet Explorer,
+this means you'll need external polyfills for this.
+
+The suggested polyfill is
+[wgxpath](https://code.google.com/p/wicked-good-xpath/), require it **before**
+opal-browser.

data/examples/2048/Gemfile

@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+gem 'opal'
+gem 'rake', "~> 13.0"
+gem 'puma'
+gem 'rack', '~> 2.2'
+gem "opal-sprockets"
+gem "opal-browser", path: "../.."
+
+
+
+
+
+