flammarion 0.0.13 → 0.0.14

data/Readme.md

@@ -2,6 +2,9 @@
 
 [![Gem Version](https://badge.fury.io/rb/flammarion.svg)](https://badge.fury.io/rb/flammarion)
 
+* [Source](https://github.com/zach-capalbo/flammarion)
+* [Documentation](http://zach-capalbo.github.io/flammarion/doc/)
+
 ## Overview
 
 Flammarion is an easy-to-use library for displaying information that you might
@@ -13,8 +16,11 @@ without going through too much trouble.
 
 ## Installation
 
-First you need to install [electron](http://electron.atom.io/)
-and make sure it's in your path. Then you can install the gem:
+First, you need to install [electron](http://electron.atom.io/) or [chrome](http://www.google.com/chrome)
+and make sure it's in your path. (*Note:* On Windows, currently only chrome
+works, but you don't need to worry about putting it in your path.)
+
+Then you can install the gem:
 
 ```
 gem install flammarion
@@ -70,7 +76,9 @@ f.button("Click Here!!!") {f.puts "You clicked the button!"}
 f.input("Placeholder > ") {|msg| f.puts "You wrote: #{msg['text'].light_magenta}"}
 ```
 
-The (_almost_) full [api documetaion](http://zach-capalbo.github.io/flammarion/doc/) is available at http://zach-capalbo.github.io/flammarion/doc/
+The (_almost_) full [api documetaion](http://zach-capalbo.github.io/flammarion/doc/)
+is available at <http://zach-capalbo.github.io/flammarion/doc/>. See especially
+the [Writeable Module](http://zach-capalbo.github.io/flammarion/doc/Flammarion/Writeable.html)
 
 ## Screenshots / Samples
 
@@ -148,7 +156,7 @@ f.pane("sidebar").pane("side2").puts Faker::Hipster.paragraph.green
 
 ## Examples
 
-There are a number of useful examples in the [examples directory.](https://github.com/zach-capalbo/flammarion)
+There are a number of useful examples in the [examples directory.](https://github.com/zach-capalbo/flammarion/tree/master/examples)
 
 # Bundled Packages
 

data/lib/flammarion.rb

@@ -6,11 +6,14 @@ require 'colorize'
 require 'filewatcher'
 require 'rbconfig'
 
-# Optional requires
-require 'sass'
-require 'slim'
-require 'coffee-script'
-require 'redcarpet'
+begin
+  # Optional Requires
+  require 'sass'
+  require 'slim'
+  require 'coffee-script'
+  require 'redcarpet'
+rescue LoadError
+end
 
 require_relative 'flammarion/writeable.rb'
 require_relative 'flammarion/pane.rb'
@@ -18,134 +21,10 @@ require_relative 'flammarion/server.rb'
 require_relative 'flammarion/version.rb'
 require_relative 'flammarion/revelator.rb'
 require_relative 'flammarion/about.rb'
+require_relative 'flammarion/engraving.rb'
 
+# This is the main namespace for Flammarion.
+# @see Engraving
+# @see Writeable
 module Flammarion
-  class Engraving
-    include Revelator
-    attr_reader :chrome
-    attr_accessor :callbacks, :sockets, :on_disconnect, :on_connect, :actions
-    include Writeable
-
-    # Creates a new Engraving (i.e., a new display window)
-    # @option options [Proc] :on_connect Called when the display window is
-    #  connected (i.e., displayed)
-    # @option options [Proc] :on_disconnect Called when the display windows is
-    #   disconnected (i.e., closed)
-    def initialize(options = {})
-      @chrome = OpenStruct.new
-      @sockets = []
-      @actions = {}
-      @engraving = self
-      @pane_name = "default"
-      @on_connect = options[:on_connect]
-      @on_disconnect = options[:on_disconnect]
-      @exit_on_disconnect = options.fetch(:exit_on_disconnect, false)
-
-      start_server
-      @window_id = @@server.register_window(self)
-      open_a_window unless options[:no_chrome]
-      @callbacks = {}
-      wait_for_a_connection unless options[:no_wait]
-
-      at_exit {close} if options.fetch(:close_on_exit, false)
-    end
-
-    def disconnect(ws)
-      @sockets.delete ws
-      exit 0 if @exit_on_disconnect
-      @on_disconnect.call if @on_disconnect
-    end
-
-    def wait_until_closed
-      sleep 1 until @sockets.empty?
-    end
-
-    def process_message(msg)
-      @last_msg = msg
-      m = {}
-      begin
-        m = JSON.parse(msg)
-      rescue JSON::ParserError
-        log "Invalid JSON String"
-        return
-      end
-
-      case m["action"]
-      when 'callback'
-        callback = @callbacks[m['id']]
-        unless callback.nil?
-          if callback.arity == 1
-            callback.call(m)
-          else
-            callback.call
-          end
-        end
-      end
-      @actions[m["action"]].call(m) if @actions.include?(m["action"])
-    end
-
-    def make_id
-      @id ||= 0
-      @id += 1
-      "i#{@id}"
-    end
-
-    def start_server
-      @@server ||= Server.new
-    end
-
-    def server; @@server; end;
-
-    def wait_for_a_connection
-      sleep 0.5 while @sockets.empty?
-    end
-
-    def window_open?
-      not @sockets.empty?
-    end
-
-    def send_json(val)
-      if @sockets.empty? then
-        open_a_window
-        wait_for_a_connection
-      end
-      @sockets.each{|ws| ws.send val.to_json}
-      nil
-    end
-
-    def alert(text)
-      send_json(action:'alert', text:text)
-    end
-
-    def orientation=(orientation)
-      raise ArgumentError.new("Orientation must be :horizontal or :vertical") unless [:horizontal, :vertical].include?(orientation)
-      send_json({action:'reorient', orientation:orientation})
-    end
-
-    def title(str)
-      send_json({action:'title', title:str})
-    end
-
-    def layout(file)
-      data = Slim::Template.new(file).render
-      send_json({action:'layout', data:data})
-    end
-
-    def close
-      send_json({action:'close'})
-    end
-
-    def live_reload_layout(file)
-      layout(file); yield if block_given?
-      FileWatcher.new(file).watch {|file| layout(file); yield if block_given? }
-    end
-
-    def get_save_path
-      if Gem.win_platform?
-        `powershell "Add-Type -AssemblyName System.windows.forms|Out-Null;$f=New-Object System.Windows.Forms.SaveFileDialog;$f.InitialDirectory='%cd%';$f.Filter='All Files (*.*)|*.*';$f.showHelp=$true;$f.ShowDialog()|Out-Null;$f.FileName"`.strip
-      else
-        `zenity --file-selection --save --confirm-overwrite`.strip
-      end
-    end
-  end
 end

data/lib/flammarion/about.rb

@@ -1,4 +1,6 @@
 module Flammarion
+  
+  # Pops up a little about box.
   def self.about
     f = Engraving.new(close_on_exit:true)
     f.title "Flammarion #{VERSION}"

data/lib/flammarion/engraving.rb

@@ -0,0 +1,171 @@
+module Flammarion
+
+  # The engraving class represents a window. It contains everything you need to
+  # display on the screen and interacts with a user. An +Engraving+ contains
+  # one or more panes, which are containers for writeable areas. Most of the
+  # power of the panes comes from the +Writeable+ module, which is also included
+  # in +Engraving+ (operating on the default pane) for convenience.
+  # @see Writeable
+  # @note Right now, there is no persistence of Engravings. Once it is closed,
+  #   everything is erased, and you'll need to set it up all over again.
+  # @note If you try to display something to a closed window, it will open a new
+  #   blank window, and then display that thing.
+  class Engraving
+    include Revelator
+    attr_reader :chrome
+    attr_accessor :callbacks, :sockets, :on_disconnect, :on_connect, :actions
+    include Writeable
+
+    # Creates a new Engraving (i.e., a new display window)
+    # @option options [Proc] :on_connect Called when the display window is
+    #  connected (i.e., displayed)
+    # @option options [Proc] :on_disconnect Called when the display windows is
+    #  disconnected (i.e., closed)
+    # @option options [Boolean] :exit_on_disconnect (false) Will call +exit+
+    #  when the widow is closed if this option is true.
+    # @option options [Boolean] :close_on_exit (false) Will close the window
+    #  when the process exits if this is true. Otherwise, it will just stay
+    #  around, but not actually be interactive.
+    # @opion options [String] :title The initial title of the engraving. If
+    #  empty, a random title will be generated.
+    def initialize(options = {})
+      options = {:title => options} if options.is_a?(String)
+      @chrome = OpenStruct.new
+      @sockets = []
+      @actions = {}
+      @engraving = self
+      @pane_name = "default"
+      @on_connect = options[:on_connect]
+      @on_disconnect = options[:on_disconnect]
+      @exit_on_disconnect = options.fetch(:exit_on_disconnect, false)
+
+      start_server
+      @window_id = @@server.register_window(self)
+      open_a_window(options) unless options[:no_window]
+      @callbacks = {}
+      wait_for_a_connection unless options[:no_wait]
+
+      at_exit {close if window_open?} if options.fetch(:close_on_exit, true)
+
+      title options[:title] if options[:title]
+    end
+
+    # Blocks the current thread until the window has been closed. All user
+    # interactions and callbacks will continue in other threads.
+    def wait_until_closed
+      sleep 1 until @sockets.empty?
+    end
+
+    # Is thie Engraving displayed on the screen.
+    def window_open?
+      not @sockets.empty?
+    end
+
+    # Pops up an alert message containing +text+.
+    def alert(text)
+      send_json(action:'alert', text:text)
+    end
+
+    # Changes the orientation of the panes in this engraving. Options are
+    # - :horizontal
+    # - :vertical
+    def orientation=(orientation)
+      raise ArgumentError.new("Orientation must be :horizontal or :vertical") unless [:horizontal, :vertical].include?(orientation)
+      send_json({action:'reorient', orientation:orientation})
+    end
+
+    # Sets the title of the window
+    def title(str)
+      send_json({action:'title', title:str})
+    end
+
+    # Attempts to close the window.
+    def close
+      send_json({action:'close'})
+    end
+
+    # Opens a native "Save File" Dialog box, prompting the user for a file.
+    def get_save_path
+      if Gem.win_platform?
+        `powershell "Add-Type -AssemblyName System.windows.forms|Out-Null;$f=New-Object System.Windows.Forms.SaveFileDialog;$f.InitialDirectory='%cd%';$f.Filter='All Files (*.*)|*.*';$f.showHelp=$true;$f.ShowDialog()|Out-Null;$f.FileName"`.strip
+      else
+        `zenity --file-selection --save --confirm-overwrite`.strip
+      end
+    end
+
+    # Allows you to load a custom layout file. This replaces all html in the
+    # window with a custom slim layout. You probably don't want this unless your
+    # writing a very complex application.
+    def layout(file)
+      data = Slim::Template.new(file).render
+      send_json({action:'layout', data:data})
+    end
+
+    def live_reload_layout(file)
+      layout(file); yield if block_given?
+      FileWatcher.new(file).watch {|file| layout(file); yield if block_given? }
+    end
+
+    # @api private
+    def disconnect(ws)
+      @sockets.delete ws
+      exit 0 if @exit_on_disconnect
+      @on_disconnect.call if @on_disconnect
+    end
+
+    # @api private
+    def process_message(msg)
+      @last_msg = msg
+      m = {}
+      begin
+        m = JSON.parse(msg)
+      rescue JSON::ParserError
+        log "Invalid JSON String"
+        return
+      end
+
+      case m["action"]
+      when 'callback'
+        callback = @callbacks[m['id']]
+        unless callback.nil?
+          if callback.arity == 1
+            callback.call(m)
+          else
+            callback.call
+          end
+        end
+      end
+      @actions[m["action"]].call(m) if @actions.include?(m["action"])
+    end
+
+    # @api private
+    def make_id
+      @id ||= 0
+      @id += 1
+      "i#{@id}"
+    end
+
+    # @api private
+    def start_server
+      @@server ||= Server.new
+    end
+
+    # @api private
+    def server; @@server; end;
+
+    # @api private
+    def wait_for_a_connection
+      sleep 0.5 while @sockets.empty?
+    end
+
+    # @api private
+    def send_json(val)
+      if @sockets.empty? then
+        open_a_window
+        wait_for_a_connection
+      end
+      @sockets.each{|ws| ws.send val.to_json}
+      nil
+    end
+  end
+end

data/lib/flammarion/pane.rb

@@ -1,6 +1,7 @@
 require_relative 'writeable.rb'
 
 module Flammarion
+  # @see Writeable
   class Pane
     attr_reader :pane_name
     include Writeable

data/lib/flammarion/revelator.rb

@@ -1,36 +1,24 @@
 module Flammarion
+  # @api private
+  # @todo This all needs a lot of clean up
   module Revelator
-    def which(cmd)
-      exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
-      ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
-        exts.each do |ext|
-          exe = File.join(path, "#{cmd}#{ext}")
-          return exe if File.executable?(exe) && !File.directory?(exe)
-        end
-      end
-      return nil
-    end
-
     CHROME_PATH = 'C:\Program Files (x86)\Google\Chrome\Application\chrome.exe'
-    def open_a_window_on_windows
+    def open_a_window_on_windows(options)
       file_path = File.absolute_path(File.join(File.dirname(__FILE__), ".."))
       file_path = `cygpath -w '#{file_path}'`.strip if RbConfig::CONFIG["host_os"] == "cygwin"
       resource = %[file\://#{file_path}/html/build/index.html]
       chrome_path = CHROME_PATH
       chrome_path = `cygpath -u '#{CHROME_PATH}'`.strip if RbConfig::CONFIG["host_os"] == "cygwin"
-      spawn(chrome_path, %[--app=#{resource}?path=#{@window_id}&port=#{server.port}])
+      Process.detach(spawn(chrome_path, %[--app=#{resource}?path=#{@window_id}&port=#{server.port}&title="#{options[:title] || "Flammarion%20Engraving"}"]))
     end
 
-    def open_a_window
-      return open_a_window_on_windows if RbConfig::CONFIG["host_os"] =~ /cygwin|mswin|mingw/
-      developmentMode = system("lsof -i:#{4567}", out: '/dev/null')
+    def open_a_window(options = {})
+      return open_a_window_on_windows(options) if RbConfig::CONFIG["host_os"] =~ /cygwin|mswin|mingw/
+      developmentMode = system("lsof -i:#{4567}", out: '/dev/null') and File.exist?("#{File.dirname(__FILE__)}/../html/source/index.html.slim")
       host = "file://#{File.dirname(File.absolute_path(__FILE__))}/../html/build/index.html"
       host = "http://localhost:4567/" if developmentMode
 
-      # data_dir = Dir.mktmpdir("flammarion")
-      # File.open("#{data_dir}/First\ Run", "w") {}
-
-      @expect_title = "Flammarion-#{rand.to_s[2..-1]}"
+      @expect_title = options[:title] || "Flammarion-#{rand.to_s[2..-1]}"
 
       if which('electron') then
         Process.detach(spawn("electron #{File.dirname(File.absolute_path(__FILE__))}/../../electron '#{host}?path=#{@window_id}&port=#{server.port}&title=#{@expect_title}'"))
@@ -44,5 +32,17 @@ module Flammarion
 
       raise StandardError.new("Cannot launch any browser") unless @chrome.in
     end
+
+    private
+    def which(cmd)
+      exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+      ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
+        exts.each do |ext|
+          exe = File.join(path, "#{cmd}#{ext}")
+          return exe if File.executable?(exe) && !File.directory?(exe)
+        end
+      end
+      return nil
+    end
   end
 end

data/lib/flammarion/server.rb

@@ -1,4 +1,5 @@
 module Flammarion
+  # @api private
   class Server
     attr_reader :port
     def initialize

data/lib/flammarion/version.rb

@@ -1,3 +1,3 @@
   module Flammarion
-    VERSION = "0.0.13"
+    VERSION = "0.0.14"
   end

data/lib/flammarion/writeable.rb

@@ -55,6 +55,13 @@ module Flammarion
     #   @note Don't forget to set the :escape_html option to false when including
     #    this string.
 
+    # @!macro [new] add_options
+    # @option options [Boolean] :replace If true, will replace any existing
+    #  contents of the writeable area.
+    # @option options [Hash] :style A map of css style attributes and values to
+    #  be applied to the element before it is added.
+
+    # @api private
     def send_json(hash)
       @engraving.send_json({target: @pane_name}.merge(hash))
     end
@@ -98,7 +105,7 @@ module Flammarion
 
     # Creates a new plot to display single axis data
     # @param [Array<Number>] values A list of numbers to plot
-    # TODO: @options
+    # @todo finish documenting options
     # @return [Spectrum] A Spectrum object for manipulation after creation.
     def plot(values, options = {})
       id = @engraving.make_id
@@ -159,7 +166,7 @@ module Flammarion
     # Creates a string representing a Font Awesome icon.
     # @macro string_representation
     # @param name [String] The name of a Font Awesome icon class. See
-    # @see https://fortawesome.github.io/Font-Awesome/icons/ for the list.
+    # @see https://fortawesome.github.io/Font-Awesome/icons/
     def icon(name, additional_classes = [])
       %|<i class="fa fa-#{name} #{additional_classes.collect{|c| "fa-#{c}"}.join(" ")}"></i>|
     end
@@ -259,15 +266,27 @@ module Flammarion
       send_json({action:'replace', text:data, raw:true})
     end
 
-    def script(coffee, options = {})
-      data = options.fetch(:coffee, true) ? CoffeeScript.compile(coffee) : coffee
+    # Runs a script in the engraving window.
+    # @param text [String] The script to run. Lanuage of the script depends on
+    #  the options given. Defaults to CoffeeScript
+    # @option options [Boolean] :coffee (true) If true, will compile +text+ from
+    #  CoffeeScript to JavaScript. If false, will pass text as plain JavaScript
+    def script(text, options = {})
+      data = options.fetch(:coffee, true) ? CoffeeScript.compile(text) : text
       send_json({action:'script', data:data}.merge(options))
     end
 
+    # Sets a CSS styles attribute on the current pane.
+    # @param attribute [String] The css attribute to set. Currently does not
+    #  support selectors or anything.
+    # @param value [#to_s] The value to set the attribute to. (Don't forget
+    #  units!)
     def style(attribute, value)
       send_json({action: 'style', attribute: attribute, value: value})
     end
 
+    # Will render the given Slim template into the pane
+    # @param file [String] Path to the template file to render
     def template(file)
       data = Slim::Template.new(file).render
       send_json({action:'replace', text:data, raw:true})
@@ -277,6 +296,11 @@ module Flammarion
       FileWatcher.new(file).watch {|file| template(file) }
     end
 
+    # Renders the given markdown text into the pane.
+    # @param text [String] The markdown text to render.
+    # @option options [Hash] :markdown_extensions Additional Redcarpet
+    #  extensions to enable.
+    # @macro add_options
     def markdown(text, options = {})
       markdown_html = Redcarpet::Markdown.new(Redcarpet::Render::HTML, {
         tables: true,
@@ -288,19 +312,50 @@ module Flammarion
       send_json({action:'markdown', text: markdown_html}.merge(options))
     end
 
+    # Hides (but doesn't close) the pane. This allows the pane to be written
+    # to without it opening up again.
+    # @see show
     def hide
       send_json({action:'hidepane'})
     end
 
+    # Shows a hidden pane.
+    # @see hide
     def show
       send_json({action:'showpane'})
     end
 
+    # @!macro [new] pane_difference
+    #  @note The difference between pane and subpane is that a pane is
+    #   automatically scaled depending on the number of other panes and the
+    #   current orientation, while subpanes are automatically the size of their
+    #   contents.
+    #   Another way to think about it might be that pane creates structural
+    #   layout elements, while subpane creates embedded sections within other
+    #   panes.
+
+    # Creates a writeable area within the current writeable area. This lets you
+    # update the contents of the writeable later, without disturbing the rest
+    # of the curent pane. If a pane or subpane with the given name already
+    # exists, it will just use that one instead.
+    # @param name [String] an identifier for the subpane. All panes and subpanes
+    #  share the same scope, so you want to be careful with your naming.
+    # @return [Pane] The newly created or already existing pane.
+    # @macro pane_difference
+    # @see pane
     def subpane(name, options = {})
       send_json({action:'subpane', name:name}.merge(options))
       return Pane.new(@engraving, name)
     end
 
+    # Creates a scaled pane within the current writeable area. Where it goes
+    # depends on the orientation.
+    # @param name [String] an identifier for the subpane. All panes and subpanes
+    #  share the same scope, so you want to be careful with your naming.
+    # @return [Pane] The newly created or already existing pane.
+    # @macro pane_difference
+    # @see pane
+    # @see orientation=
     def pane(name, options = {})
       send_json({action:'addpane', name:name}.merge(options))
       return Pane.new(@engraving, name)
@@ -343,6 +398,18 @@ module Flammarion
       return str
     end
 
+    # Adds an interactive street map of a specified location.
+    # @option options [Integer] :zoom (13) The initial zoom level
+    # @option options [Boolean] :marker (true) Display a marker on the
+    #  identified address or coordinates
+    # @macro add_options
+    # @overload map(options)
+    # @overload map(address, options = {})
+    #  @param address [String] The address or landmark to look up and display.
+    # @overload map(latitude, longitude, options = {})
+    #  @param latitude [Float] The latitude to display
+    #  @param longitude [Float] The longitude to display
+    # @note Street map provided by http://openstreetmap.org
     def map(*args)
       case (args.size)
       when 1

data/lib/html/build/javascripts/actions.js

@@ -58,7 +58,8 @@ void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?voi
 
 }).call(this);
 (function() {
-  var WSClient;
+  var WSClient,
+    hasProp = {}.hasOwnProperty;
 
   WSClient = (function() {
     function WSClient() {
@@ -181,6 +182,15 @@ void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?voi
     };
 
     WSClient.prototype.add = function(object, target, data) {
+      var key, ref, val;
+      if (data.style) {
+        ref = data.style;
+        for (key in ref) {
+          if (!hasProp.call(ref, key)) continue;
+          val = ref[key];
+          object.css(key, val);
+        }
+      }
       if (data.replace) {
         return target.html(object);
       } else {

data/lib/html/build/javascripts/all.js

@@ -6679,7 +6679,8 @@ if (typeof module !== 'undefined') {
 
 }).call(this);
 (function() {
-  var WSClient;
+  var WSClient,
+    hasProp = {}.hasOwnProperty;
 
   WSClient = (function() {
     function WSClient() {
@@ -6802,6 +6803,15 @@ if (typeof module !== 'undefined') {
     };
 
     WSClient.prototype.add = function(object, target, data) {
+      var key, ref, val;
+      if (data.style) {
+        ref = data.style;
+        for (key in ref) {
+          if (!hasProp.call(ref, key)) continue;
+          val = ref[key];
+          object.css(key, val);
+        }
+      }
       if (data.replace) {
         return target.html(object);
       } else {
@@ -7273,7 +7283,7 @@ if (typeof module !== 'undefined') {
 
   Plot = (function() {
     Plot.prototype.default_options = {
-      color: "#fff",
+      color: $(document.body).css("color"),
       replace: true,
       size: 1.0,
       orientation: 'vertical',

data/lib/html/build/javascripts/input.js

@@ -58,7 +58,8 @@ void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?voi
 
 }).call(this);
 (function() {
-  var WSClient;
+  var WSClient,
+    hasProp = {}.hasOwnProperty;
 
   WSClient = (function() {
     function WSClient() {
@@ -181,6 +182,15 @@ void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?voi
     };
 
     WSClient.prototype.add = function(object, target, data) {
+      var key, ref, val;
+      if (data.style) {
+        ref = data.style;
+        for (key in ref) {
+          if (!hasProp.call(ref, key)) continue;
+          val = ref[key];
+          object.css(key, val);
+        }
+      }
       if (data.replace) {
         return target.html(object);
       } else {

data/lib/html/build/javascripts/map.js

@@ -58,7 +58,8 @@ void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?voi
 
 }).call(this);
 (function() {
-  var WSClient;
+  var WSClient,
+    hasProp = {}.hasOwnProperty;
 
   WSClient = (function() {
     function WSClient() {
@@ -181,6 +182,15 @@ void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?voi
     };
 
     WSClient.prototype.add = function(object, target, data) {
+      var key, ref, val;
+      if (data.style) {
+        ref = data.style;
+        for (key in ref) {
+          if (!hasProp.call(ref, key)) continue;
+          val = ref[key];
+          object.css(key, val);
+        }
+      }
       if (data.replace) {
         return target.html(object);
       } else {

data/lib/html/build/javascripts/plot.js

@@ -25,7 +25,7 @@
 
   Plot = (function() {
     Plot.prototype.default_options = {
-      color: "#fff",
+      color: $(document.body).css("color"),
       replace: true,
       size: 1.0,
       orientation: 'vertical',

data/lib/html/build/javascripts/websocket.js

@@ -58,7 +58,8 @@ void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?voi
 
 }).call(this);
 (function() {
-  var WSClient;
+  var WSClient,
+    hasProp = {}.hasOwnProperty;
 
   WSClient = (function() {
     function WSClient() {
@@ -181,6 +182,15 @@ void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?voi
     };
 
     WSClient.prototype.add = function(object, target, data) {
+      var key, ref, val;
+      if (data.style) {
+        ref = data.style;
+        for (key in ref) {
+          if (!hasProp.call(ref, key)) continue;
+          val = ref[key];
+          object.css(key, val);
+        }
+      }
       if (data.replace) {
         return target.html(object);
       } else {

data/lib/html/source/javascripts/plot.coffee

@@ -13,7 +13,7 @@ $.extend WSClient.prototype.actions,
 
 class Plot
   default_options:
-    color: "#fff"
+    color: $(document.body).css("color")
     replace: true
     size: 1.0
     orientation: 'vertical'

data/lib/html/source/javascripts/websocket.coffee

@@ -75,6 +75,8 @@ class WSClient
     return text
 
   add: (object, target, data) ->
+    if data.style
+      object.css(key, val) for own key, val of data.style
     if data.replace
       target.html(object)
     else

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flammarion
 version: !ruby/object:Gem::Version
-  version: 0.0.13
+  version: 0.0.14
   prerelease: 
 platform: ruby
 authors:
@@ -284,6 +284,7 @@ files:
 - lib/html/Gemfile
 - lib/flammarion/about.rb
 - lib/flammarion/server.rb
+- lib/flammarion/engraving.rb
 - lib/flammarion/pane.rb
 - lib/flammarion/version.rb
 - lib/flammarion/revelator.rb