motion-kit 0.0.1 → 0.9.0

data/lib/motion-kit-osx/layouts/constraints_layout.rb

@@ -0,0 +1,42 @@
+# @requires MotionKit::ConstraintsLayout
+module MotionKit
+  class ConstraintsLayout
+
+    def content_compression_resistance_priority(value, for_orientation: orientation)
+      orientation = Constraint.orientation_lookup(orientation)
+    end
+
+    # consistency with iOS methods:
+    def content_compression_resistance_priority(value, for_axis: orientation)
+      content_compression_resistance_priority(value, for_orientation: orientation)
+    end
+
+    def compression_priority(value, for_orientation: orientation)
+      content_compression_resistance_priority(value, for_orientation: orientation)
+    end
+
+    # consistency with iOS methods:
+    def compression_priority(value, for_axis: orientation)
+      content_compression_resistance_priority(value, for_orientation: orientation)
+    end
+
+    def content_hugging_priority(value, for_orientation: orientation)
+      orientation = Constraint.orientation_lookup(orientation)
+    end
+
+    # consistency with iOS methods:
+    def content_hugging_priority(value, for_axis: orientation)
+      content_hugging_priority(value, for_orientation: orientation)
+    end
+
+    def hugging_priority(value, for_orientation: orientation)
+      content_hugging_priority(value, for_orientation: orientation)
+    end
+
+    # consistency with iOS methods:
+    def hugging_priority(value, for_axis: orientation)
+      content_hugging_priority(value, for_orientation: orientation)
+    end
+
+  end
+end

data/lib/motion-kit-osx/layouts/nsmenu_extensions.rb

@@ -0,0 +1,186 @@
+# @requires MotionKit::NSMenuLayout
+module MotionKit
+  class NSMenuLayout
+
+    # useful when writing menus
+    def app_name
+      NSBundle.mainBundle.infoDictionary['CFBundleName']
+    end
+
+    def _menu_title_and_options(title, options, default_title=nil, default_options={})
+      if title.is_a?(NSDictionary)
+        options = title
+        title = options[:title]
+      end
+      title ||= default_title
+      return title, default_options.merge(options)
+    end
+
+    def app_menu(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, app_name)
+
+      exclude = Array(options.fetch(:exclude, []))
+      return create(title) do
+        unless exclude.include?(:about)
+          add about_item
+          add separator_item
+        end
+        unless exclude.include?(:prefs)
+          add preferences_item
+          add separator_item
+        end
+        unless exclude.include?(:services)
+          add services_item
+          add separator_item
+        end
+        unless exclude.include?(:hide)
+          add hide_item
+          add hide_others_item
+        end
+        add show_all_item unless exclude.include?(:show)
+        add quit_item unless exclude.include?(:quit)
+      end
+    end
+
+    def file_menu(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'File')
+
+      exclude = Array(options.fetch(:exclude, []))
+      return create(title) do
+        add new_item unless exclude.include?(:new)
+        add open_item unless exclude.include?(:open)
+        add separator_item unless [:new, :open].all? { |menu_name| exclude.include?(menu_name) }
+
+        add close_item unless exclude.include?(:close)
+        add save_item unless exclude.include?(:save)
+        add revert_to_save_item unless exclude.include?(:revert)
+        add separator_item unless [:close, :save, :revert].all? { |menu_name| exclude.include?(menu_name) }
+
+        add page_setup_item unless exclude.include?(:page_setup)
+        add print_item unless exclude.include?(:print)
+      end
+    end
+
+    def window_menu(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Window')
+
+      exclude = Array(options.fetch(:exclude, []))
+      return create(title) do
+        add minimize_item unless exclude.include?(:minimize)
+        add zoom_item unless exclude.include?(:zoom)
+        add separator_item unless [:minimize, :zoom].all? { |menu_name| exclude.include?(menu_name) }
+
+        add bring_all_to_front_item unless exclude.include?(:bring_all_to_front)
+      end
+    end
+
+    def help_menu(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Help')
+
+      exclude = Array(options.fetch(:exclude, []))
+      return create(title) do
+        add help_item
+      end
+    end
+
+    def separator_item
+      NSMenuItem.separatorItem
+    end
+
+    def about_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, "About #{app_name}", { action: 'orderFrontStandardAboutPanel:' })
+      return self.item(title, options)
+    end
+
+    def preferences_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Preferences', { key: ',', action: 'openPreferences:' })
+      return self.item(title, options)
+    end
+
+    def services_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Services')
+      return self.item(title, options)
+    end
+
+    def hide_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, "Hide #{app_name}", { key: 'h', action: 'hide:' })
+      return self.item(title, options)
+    end
+
+    def hide_others_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Hide Others', { key: 'h', action: 'hideOtherApplications:', mask: NSCommandKeyMask | NSAlternateKeyMask })
+      return self.item(title, options)
+    end
+
+    def show_all_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Show All', { action: 'unhideAllApplications:' })
+      return self.item(title, options)
+    end
+
+    def quit_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, "Quit #{app_name}", { key: 'q', action: 'terminate:' })
+      return self.item(title, options)
+    end
+
+    def new_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'New', { key: 'n', action: 'newDocument:' })
+      return self.item(title, options)
+    end
+
+    def open_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Open…', { key: 'o', action: 'openDocument:' })
+      return self.item(title, options)
+    end
+
+    def close_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Close', { key: 'w', action: 'performClose:' })
+      return self.item(title, options)
+    end
+
+    def save_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Save…', { key: 's', action: 'saveDocument:' })
+      return self.item(title, options)
+    end
+
+    def save_as_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Save as…', { key: 'S', action: 'saveDocumentAs:' })
+      return self.item(title, options)
+    end
+
+    def revert_to_save_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Revert to Saved', { action: 'revertDocumentToSaved:' })
+      return self.item(title, options)
+    end
+
+    def page_setup_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Page Setup…', { key: 'P', action: 'runPageLayout:' })
+      return self.item(title, options)
+    end
+
+    def print_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Print…', { key: 'p', action: 'printDocument:' })
+      return self.item(title, options)
+    end
+
+    def minimize_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Minimize', { key: 'm', action: 'performMiniaturize:' })
+      return self.item(title, options)
+    end
+
+    def zoom_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Zoom', { action: 'performMiniaturize:' })
+      return self.item(title, options)
+    end
+
+    def bring_all_to_front_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, 'Bring All To Front', { action: 'arrangeInFront:' })
+      return self.item(title, options)
+    end
+
+    def help_item(title=nil, options={})
+      title, options = _menu_title_and_options(title, options, "#{app_name} Help", { key: '?', action: 'showHelp:' })
+      return self.item("#{app_name} Help", options)
+    end
+
+  end
+end

data/lib/motion-kit-osx/layouts/nsmenu_layout.rb

@@ -0,0 +1,109 @@
+# @provides MotionKit::MenuLayout
+# @provides MotionKit::NSMenuLayout
+# @requires MotionKit::ViewLayout
+module MotionKit
+  class MenuLayout < ViewLayout
+
+    # A more sensible name for the menu that is created.
+    def menu
+      self.view
+    end
+
+    # platform specific default root view
+    def default_root
+      # child WindowLayout classes can return *their* NSView subclass from self.nsview_class
+      menu_class = self.class.targets || NSMenu
+      menu_class.alloc.init
+    end
+
+    def add_child(submenu)
+      target.addItem(submenu)
+    end
+
+    def remove_child(submenu)
+      target.removeItem(submenu)
+    end
+
+    # override root to allow a menu title for the top level menu
+    def root(element, element_id=nil, &block)
+      if element && element.is_a?(NSString)
+        element = NSMenu.alloc.initWithTitle(element)
+      end
+      super(element, element_id, &block)
+    end
+
+    # override 'add'; menus are just a horse of a different color.
+    def add(title_or_item, element_id=nil, options={}, &block)
+      if element_id.is_a?(NSDictionary)
+        options = element_id
+        element_id = nil
+      end
+
+      if title_or_item.is_a?(NSMenuItem)
+        item = title_or_item
+        menu = nil
+        retval = item
+      elsif title_or_item.is_a?(NSMenu)
+        menu = title_or_item
+        item = self.item(menu.title, options)
+        item.submenu = menu
+        retval = menu
+      else
+        title = title_or_item
+        item = self.item(title, options)
+
+        if block
+          menu = create(title)
+          item.submenu = menu
+          retval = menu
+        else
+          retval = item
+        end
+      end
+
+      self.apply(:add_child, item)
+
+      if menu && block
+        menuitem_was = @menu_item
+        @menu_item = item
+        context(menu, &block)
+        @menu_item = menuitem_was
+      end
+
+      if element_id
+        create(retval, element_id)
+      end
+
+      return retval
+    end
+
+    def create(title_or_item, element_id=nil, &block)
+      if title_or_item.is_a?(NSString)
+        item = NSMenu.alloc.initWithTitle(title_or_item)
+      else
+        item = title_or_item
+      end
+
+      return super(item, element_id, &block)
+    end
+
+    def item(title, options={})
+      action = options.fetch(:action, nil)
+      key = options.fetch(:keyEquivalent, options.fetch(:key, ''))
+      key ||= ''  # key must never be nil
+      item = NSMenuItem.alloc.initWithTitle(title, action: action, keyEquivalent: key)
+
+      mask = options.fetch(:keyEquivalentModifierMask, options.fetch(:mask, nil))
+      unless mask.nil?
+        item.keyEquivalentModifierMask = mask
+      end
+
+      return item
+    end
+
+  end
+
+  class NSMenuLayout < MenuLayout
+    targets NSMenu
+  end
+end

data/lib/motion-kit-osx/layouts/nsmenuitem_extensions.rb

@@ -0,0 +1,45 @@
+# @requires MotionKit::NSMenuLayout
+module MotionKit
+  class NSMenuLayout
+
+    ##|
+    ##|  These methods are meant to be called on the parent menu item, but
+    ##|  there's no way to reference an NSMenu's parent *item* (only its parent
+    ##|  *menu*).  So the @menu_item is stored in an ivar before the menu block
+    ##|  is created, and these methods access that menu item.
+    ##|
+
+    # sets the title of the current NSMenu AND it's parent NSMenuItem
+    def title(value)
+      target.title = value
+      @menu_item.title = value
+    end
+
+    def attributedTitle(value)
+      target.title = value.to_s
+      @menu_item.attributedTitle = value
+    end
+
+    def attributed_title(value)
+      target.title = value.to_s
+      @menu_item.attributedTitle = value
+    end
+
+    def state(value)
+      @menu_item.state = value
+    end
+
+    def tag(value)
+      @menu_item.tag = value
+    end
+
+    def keyEquivalentModifierMask(value)
+      @menu_item.keyEquivalentModifierMask = value
+    end
+
+    def key_equivalent_modifier_mask(value)
+      @menu_item.keyEquivalentModifierMask = value
+    end
+
+  end
+end

data/lib/motion-kit-osx/layouts/nstablecolumn_layout.rb

@@ -0,0 +1,12 @@
+# @provides MotionKit::NSTableColumnLayout
+# @requires MotionKit::BaseLayout
+module MotionKit
+  class NSTableColumnLayout < BaseLayout
+    targets NSTableColumn
+
+    def title(value)
+      target.headerCell.stringValue = value
+    end
+
+  end
+end

data/lib/motion-kit-osx/layouts/nstableview_layout.rb

@@ -0,0 +1,20 @@
+# @provides MotionKit::NSTableViewLayout
+# @requires MotionKit::NSViewLayout
+module MotionKit
+  class NSTableViewLayout < NSViewLayout
+    targets NSTableView
+
+    def add_column(column_or_identifier, &block)
+      if column_or_identifier.is_a?(NSTableColumn)
+        column = column_or_identifier
+      else
+        column = NSTableColumn.alloc.initWithIdentifier(column_or_identifier)
+        column.headerCell.stringValue = column_or_identifier
+      end
+      target.addTableColumn(column)
+      context(column, &block)
+    end
+    alias add_table_column add_column
+
+  end
+end

data/lib/motion-kit-osx/layouts/nsview_layout.rb

@@ -0,0 +1,47 @@
+# @provides MotionKit::Layout
+# @provides MotionKit::NSViewLayout
+# @requires MotionKit::ViewLayout
+module MotionKit
+  class Layout < ViewLayout
+
+    # platform specific default root view
+    def default_root
+      # child Layout classes will return *their* NSView subclass from self.targets
+      view_class = self.class.targets || MotionKit.default_view_class
+      view_class.alloc.initWithFrame([[0, 0], [0, 0]])
+    end
+
+    def add_child(subview)
+      target.addSubview(subview)
+    end
+
+    def remove_child(subview)
+      subview.removeFromSuperview
+    end
+
+    # NSViews AND CALayers are updated
+    def reapply!(root=nil)
+      if root.is_a?(CALayer)
+        @layout_state = :reapply
+        MotionKit.find_all_layers(root) do |layer|
+          call_style_method(layer, layer.motion_kit_id) if layer.motion_kit_id
+        end
+        @layout_state = :initial
+      else
+        root ||= self.view
+        if root.layer
+          reapply!(root.layer)
+        end
+        super(root)
+      end
+
+      return self
+    end
+
+  end
+
+  class NSViewLayout < Layout
+    targets NSView
+  end
+
+end