action_link 0.1.1 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fb82eefce04018119e077392dd55980535cb21407adcb14988605f199bd3e42
-  data.tar.gz: ea83ec0bf21af581e71ec2a79783adb97a3e65f8fe91ef43d1ef241f1ad56232
+  metadata.gz: 80820750651f4ec759b40bafb3e029029676672d2e72f83b69eba9bd2f05a95b
+  data.tar.gz: e3daa24250f63d7a9e5c41c2c4609007d63b3501e1e48c156eee0590efc2253b
 SHA512:
-  metadata.gz: b1f640474051d8720d8de893567ded1129277abde85b36f07d2c2d16932dd2d7a1c7b349dd9a9c23f274f67d4892f5b68ac14427f20c930887b996546a29e214
-  data.tar.gz: b142f701ff7b43541fb9a5d99c98ec297e1480701b0dfeab848b243662c5c05c5abcc2c42ced17333e615380064f5a8c10e34a88d219f1436b0188aeb21c93ec
+  metadata.gz: a639c34fb4df4af7c79fe5478f9212fcd39dfd61363e1476f7fc411a370199e529c2b85549f0092803a369fbf00e6bd7f634fafcabb64f7827b14576950b4c5e
+  data.tar.gz: d637d15c764b1cfc0c82ae5f27b83846cc82ac7f2627dc96662eaad0a805641e0e1fb6fd725f37e0bfcf446c95cb7e5fc4b49538af2ba37ace681d8febbf3ccf

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [1.0.1] - 2026-01-27
+
+- Fix <a title> for non-breaking spaces
+
+## [1.0.0] - 2025-05-11
+
+- Add more link types
+
 ## [0.1.0] - 2023-08-24
 
 - Initial release

data/README.md

@@ -1,34 +1,55 @@
 # ActionLink
 
-Intuitive ViewComponents for CRUD resource link actions in Rails.
+ActionLink is a Ruby gem that provides intuitive ViewComponents for CRUD resource link actions in Rails. It simplifies the process of creating common action links (show, edit, delete, etc.) with associated icons.
 
 ## Usage
 
+Here's an example of how to use the `ActionLink` gem in a Rails view:
+
 ```ruby
 # In Rails view
-= render ActionLink::Show.new(url: [:admin, @post], current_user:)
+= render ActionLink::Show.new(url: [:admin, @post], current_user: current_user)
+```
+
+## More Usage Examples
+
+Here are some more examples of how to use the `ActionLink` gem in a Rails view:
+
+```ruby
+# In Rails view
+= render ActionLink::Edit.new(url: [:edit, @post], current_user: current_user)
+= render ActionLink::Destroy.new(url: [:destroy, @post], current_user: current_user)
+= render ActionLink::New.new(url: [:new, @post], current_user: current_user)
 ```
 
 ## Installation
 
-Install the gem and add to the application's Gemfile by executing:
+To install the `ActionLink` gem, add it to your application's Gemfile and run `bundle install`:
 
-    $ bundle add action_link
+```ruby
+gem 'action_link'
+```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+Alternatively, you can install the gem manually by running:
 
-    $ gem install action_link
+```sh
+gem install action_link
+```
 
 ## 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.
-
-## Contributing
+To contribute to the development of the `ActionLink` gem, follow these steps:
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/halo/action_link.
+1. Fork the repository on GitHub.
+2. Clone your forked repository to your local machine.
+3. Install the gem's dependencies by running `bin/setup`.
+4. Run the tests to ensure everything is working correctly: `rake test`.
+5. Make your changes and add tests for your changes.
+6. Commit your changes and push them to your forked repository.
+7. Create a pull request on GitHub with a description of your changes.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The `ActionLink` gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
-The icons are taken from the incredible [iconmonstr](https://iconmonstr.com/license/).
+The icons used in this gem are taken from the incredible [iconmonstr](https://iconmonstr.com/license/).

data/app/assets/stylesheets/action_link/_index.sass

@@ -0,0 +1,8 @@
+@use "./variables"
+@use "./style"
+@use "./fonts"
+@use "./acticons"
+
+// Let's add some sane default that is not blue.
+.c-action-link
+  color: black

data/app/assets/stylesheets/action_link/acticons.css

@@ -0,0 +1 @@
+.o-acticon{font-family:"acticons";speak:none;font-style:normal;font-weight:normal;font-variant:normal;text-transform:none;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}/*# sourceMappingURL=acticons.css.map */

data/app/assets/stylesheets/action_link/acticons.css.map

@@ -0,0 +1 @@
+{"version":3,"sourceRoot":"","sources":["file:///Users/orange/Code/2-Areas/action_link/action_link/app/assets/stylesheets/action_link/acticons.sass"],"names":[],"mappings":"AAAA,WACE,uBACA,WACA,kBACA,mBACA,oBACA,oBACA,mCACA","file":"acticons.css","sourcesContent":[".o-acticon\n  font-family: 'acticons'\n  speak: none\n  font-style: normal\n  font-weight: normal\n  font-variant: normal\n  text-transform: none\n  -webkit-font-smoothing: antialiased\n  -moz-osx-font-smoothing: grayscale\n"]}

data/app/assets/stylesheets/action_link/fonts.css

@@ -0,0 +1 @@
+@font-face{font-family:"acticons";font-weight:normal;font-style:normal;src:url("/action_link/acticons.woff") format("woff")}/*# sourceMappingURL=fonts.css.map */

data/app/assets/stylesheets/action_link/fonts.css.map

@@ -0,0 +1 @@
+{"version":3,"sourceRoot":"","sources":["file:///Users/orange/Code/2-Areas/action_link/action_link/app/assets/stylesheets/action_link/fonts.sass"],"names":[],"mappings":"AAAA,WACE,uBACA,mBACA,kBACA","file":"fonts.css","sourcesContent":["@font-face\n  font-family: 'acticons'\n  font-weight: normal\n  font-style: normal\n  src: url('/action_link/acticons.woff') format('woff')\n"]}

data/app/assets/stylesheets/action_link/fonts.sass

@@ -2,4 +2,4 @@
   font-family: 'acticons'
   font-weight: normal
   font-style: normal
-  src: url('action_link/acticons.woff') format('woff')
+  src: url('/action_link/acticons.woff') format('woff')

data/app/assets/stylesheets/action_link/style.css

@@ -0,0 +1 @@
+.o-acticon--info-circle:before{content:""}.o-acticon--questionmark:before{content:"❓"}.o-acticon--arrow-down-circle:before{content:""}.o-acticon--pencil-circle:before{content:""}.o-acticon--check-circle:before{content:""}.o-acticon--chevron-circle-right:before{content:""}.o-acticon--plus-circle:before{content:""}.o-acticon--times-circle:before{content:""}/*# sourceMappingURL=style.css.map */

data/app/assets/stylesheets/action_link/style.css.map

@@ -0,0 +1 @@
+{"version":3,"sourceRoot":"","sources":["file:///Users/orange/Code/2-Areas/action_link/action_link/app/assets/stylesheets/action_link/style.scss","file:///Users/orange/Code/2-Areas/action_link/action_link/app/assets/stylesheets/action_link/variables.scss"],"names":[],"mappings":"CAKE,+BACE,QCJU,IDQZ,gCACE,QCRW,IDYb,qCACE,QCZgB,IDgBlB,iCACE,QChBY,IDoBd,gCACE,QCpBW,IDwBb,wCACE,QCxBmB,ID4BrB,+BACE,QC5BU,IDgCZ,gCACE,QChCW","file":"style.css","sourcesContent":["// This file is autogenerated by `rake acticons:update`\n\n@use \"variables\";\n\n.o-acticon--info-circle {\n  &:before {\n    content: variables.$info-circle;\n  }\n}\n.o-acticon--questionmark {\n  &:before {\n    content: variables.$questionmark;\n  }\n}\n.o-acticon--arrow-down-circle {\n  &:before {\n    content: variables.$arrow-down-circle;\n  }\n}\n.o-acticon--pencil-circle {\n  &:before {\n    content: variables.$pencil-circle;\n  }\n}\n.o-acticon--check-circle {\n  &:before {\n    content: variables.$check-circle;\n  }\n}\n.o-acticon--chevron-circle-right {\n  &:before {\n    content: variables.$chevron-circle-right;\n  }\n}\n.o-acticon--plus-circle {\n  &:before {\n    content: variables.$plus-circle;\n  }\n}\n.o-acticon--times-circle {\n  &:before {\n    content: variables.$times-circle;\n  }\n}\n","// This file is autogenerated by `rake acticons:update`\n\n$info-circle: \"\\e907\";\n$questionmark: \"\\2753\";\n$arrow-down-circle: \"\\e9af\";\n$pencil-circle: \"\\e9ae\";\n$check-circle: \"\\e93b\";\n$chevron-circle-right: \"\\e928\";\n$plus-circle: \"\\e919\";\n$times-circle: \"\\e91a\";\n"]}

data/app/assets/stylesheets/action_link/style.scss

@@ -1,42 +1,44 @@
 // This file is autogenerated by `rake acticons:update`
 
+@use "variables";
+
 .o-acticon--info-circle {
   &:before {
-    content: $o-acticon--info-circle;
+    content: variables.$info-circle;
   }
 }
 .o-acticon--questionmark {
   &:before {
-    content: $o-acticon--questionmark;
+    content: variables.$questionmark;
   }
 }
 .o-acticon--arrow-down-circle {
   &:before {
-    content: $o-acticon--arrow-down-circle;
+    content: variables.$arrow-down-circle;
   }
 }
 .o-acticon--pencil-circle {
   &:before {
-    content: $o-acticon--pencil-circle;
+    content: variables.$pencil-circle;
   }
 }
 .o-acticon--check-circle {
   &:before {
-    content: $o-acticon--check-circle;
+    content: variables.$check-circle;
   }
 }
 .o-acticon--chevron-circle-right {
   &:before {
-    content: $o-acticon--chevron-circle-right;
+    content: variables.$chevron-circle-right;
   }
 }
 .o-acticon--plus-circle {
   &:before {
-    content: $o-acticon--plus-circle;
+    content: variables.$plus-circle;
   }
 }
 .o-acticon--times-circle {
   &:before {
-    content: $o-acticon--times-circle;
+    content: variables.$times-circle;
   }
 }

data/app/assets/stylesheets/action_link/variables.css

@@ -0,0 +1 @@
+/*# sourceMappingURL=variables.css.map */

data/app/assets/stylesheets/action_link/variables.css.map

@@ -0,0 +1 @@
+{"version":3,"sourceRoot":"","sources":[],"names":[],"mappings":"","file":"variables.css","sourcesContent":[]}

data/app/assets/stylesheets/action_link/variables.scss

@@ -1,10 +1,10 @@
 // This file is autogenerated by `rake acticons:update`
 
-$o-acticon--info-circle: "\e907";
-$o-acticon--questionmark: "\2753";
-$o-acticon--arrow-down-circle: "\e9af";
-$o-acticon--pencil-circle: "\e9ae";
-$o-acticon--check-circle: "\e93b";
-$o-acticon--chevron-circle-right: "\e928";
-$o-acticon--plus-circle: "\e919";
-$o-acticon--times-circle: "\e91a";
+$info-circle: "\e907";
+$questionmark: "\2753";
+$arrow-down-circle: "\e9af";
+$pencil-circle: "\e9ae";
+$check-circle: "\e93b";
+$chevron-circle-right: "\e928";
+$plus-circle: "\e919";
+$times-circle: "\e91a";

data/app/components/action_link/base.rb

@@ -24,6 +24,7 @@ module ActionLink
     option :url, default: -> {}
 
     def permission?
+      # TODO: use allowed? in ActionPolicy
       _policy.public_send(:"#{_action}?")
     end
 
@@ -52,7 +53,7 @@ module ActionLink
     # May be accessed and/or overriden in subclasses
 
     def i18n_title_key
-      "action_link_component.titles.#{_action}"
+      "action_link.titles.#{_action}"
     end
 
     def http_method; end
@@ -69,7 +70,11 @@ module ActionLink
     # Options for `link_to`
 
     def _title
-      t(i18n_title_key, subject: strip_tags(_title_subject_name))
+      return if manual_title == false
+
+      # Sometimes the <a title> attribute has non-breaking spaces in it ` `.
+      # ActionLink must not replace that with `&bnsp;` (though other HTML needs to be stripped).
+      t(i18n_title_key, subject: strip_tags(_title_subject_name.gsub(' ', ' ')))
     end
 
     def _data
@@ -96,6 +101,8 @@ module ActionLink
 
     # Converts a class like `::ActionLink::New` to the symbol `:new`.
     def _action
+      return action if is_a?(::ActionLink::Custom)
+
       @_action ||= self.class.name[12..].underscore.to_sym
     end
 

data/app/components/action_link/custom.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module ActionLink
+  # An action link that indicates showing an existing record.
+  class Custom < Base
+    option :action
+
+    erb_template <<~ERB.gsub("\n", '')
+      <% if permission? %>
+      <%= link_to(url, **options) do %>
+      <%= content %>
+      <% icon_tag :icon %>
+      <% end %>
+      <% else %>
+      <%= content %>
+      <% end %>
+    ERB
+  end
+end

data/app/components/action_link/destroy.rb

@@ -22,7 +22,7 @@ module ActionLink
     option :associative, default: -> { false }
 
     def i18n_title_key
-      return 'action_link_component.titles.unassign' if associative
+      return 'action_link.titles.unassign' if associative
 
       super
     end
@@ -42,9 +42,9 @@ module ActionLink
 
     def i18n_confirmation_key
       if associative
-        'action_link_component.confirmations.unassign'
+        'action_link.confirmations.unassign'
       else
-        'action_link_component.confirmations.destroy'
+        'action_link.confirmations.destroy'
       end
     end
   end

data/app/components/action_link/download.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module ActionLink
+  # An action link that indicates downloading a file.
+  class Download < Show
+    ICON = 'arrow-down-circle'
+
+    erb_template <<~ERB.gsub("\n", '')
+      <% if permission? %>
+      <%= link_to(url, **options.merge(target: :_blank)) do %>
+      <%= content %>
+      <% if icon? %><%= ' ' %><%= icon_tag ::ActionLink::Download::ICON %><% end %>
+      <% end %>
+      <% else %>
+      <%= content %>
+      <% end %>
+    ERB
+
+    option :url
+  end
+end

data/app/components/action_link/edit.rb

@@ -3,7 +3,7 @@
 module ActionLink
   # An action link that indicates editing an existing record.
   class Edit < Base
-    ICON = 'pencil-circle'
+    ICON = 'pencil-circle'.freeze
 
     erb_template <<~ERB.gsub("\n", '')
       <% if permission? %>

data/app/components/action_link/new.rb

@@ -3,7 +3,7 @@
 module ActionLink
   # An action link that indicates adding a new record.
   class New < Base
-    ICON = 'plus-circle'
+    ICON = 'plus-circle'.freeze
 
     erb_template <<~ERB.gsub("\n", '')
       <% if permission? %>
@@ -23,7 +23,7 @@ module ActionLink
     option :associative, default: -> { false }
 
     def i18n_title_key
-      return 'action_link_component.titles.assign' if associative
+      return 'action_link.titles.assign' if associative
 
       super
     end

data/app/components/action_link/show.rb

@@ -3,7 +3,7 @@
 module ActionLink
   # An action link that indicates showing an existing record.
   class Show < Base
-    ICON = 'chevron-circle-right'
+    ICON = 'chevron-circle-right'.freeze
 
     erb_template <<~ERB.gsub("\n", '')
       <% if permission? %>

data/config/locales/action_link_component.de.yml

@@ -1,5 +1,5 @@
 de:
-  action_link_component:
+  action_link:
     confirmations:
       destroy: "Möchtest du %{subject} löschen?"
       unassign: "Möchtest du %{subject} entkoppeln? Bei dieser Aktion wird nichts gelöscht."
@@ -10,3 +10,4 @@ de:
       new: "%{subject} anlegen"
       show: "%{subject} anzeigen"
       unassign: "%{subject} entkoppeln"
+      download: "%{subject} downloaden"

data/config/locales/action_link_component.en.yml

@@ -1,5 +1,5 @@
 en:
-  action_link_component:
+  action_link:
     confirmations:
       destroy: "Would you like to delete %{subject}?"
       unassign: "Would you like to unassign %{subject}? This action does not delete."
@@ -10,3 +10,4 @@ en:
       new: Add %{subject}
       show: "Show %{subject}"
       unassign: "Unassign %{subject}"
+      download: "Download %{subject}"

data/lib/action_link/engine.rb

@@ -8,6 +8,22 @@ module ActionLink
   class Engine < ::Rails::Engine
     isolate_namespace ActionLink
 
+    initializer "action_link.assets" do |app|
+      app.config.assets.paths << Engine.root.join('app/stylesheets')
+    end
+
+    initializer 'action_link.vscode_snippets', group: :all do |app|
+      app.config.after_initialize do
+        vscode_dir = Rails.root.join('.vscode')
+        next unless vscode_dir.directory?
+
+        target = vscode_dir.join('action_link.code-snippets')
+        source = Engine.root.join('vscode/action_link.code-snippets')
+
+        FileUtils.ln_s(source, target, force: true)
+      end
+    end
+
     config.to_prepare do
       # Our ActionLink components are subclasses of `ViewComponent::Base`.
       # When `ViewComponent::Base` is subclassed, two things happen:
@@ -21,10 +37,12 @@ module ActionLink
       # That's right here and now.
       require_relative '../../app/components/action_link/application_component'
       require_relative '../../app/components/action_link/base'
+      require_relative '../../app/components/action_link/custom'
       require_relative '../../app/components/action_link/destroy'
       require_relative '../../app/components/action_link/edit'
       require_relative '../../app/components/action_link/new'
       require_relative '../../app/components/action_link/show'
+      require_relative '../../app/components/action_link/download'
     end
   end
 end

data/lib/action_link/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActionLink
-  VERSION = '0.1.1'
+  VERSION = '1.0.1'
 end

data/vscode/action_link.code-snippets

@@ -0,0 +1,43 @@
+{
+  "= render ActionLink::New": {
+    "prefix": [
+      "nal"
+    ],
+    "body": [
+      "= render ActionLink::New.new(url: $1,",
+      "                             model: $2,",
+      "                             current_user:)",
+    ]
+  },
+  "= render ActionLink::Show": {
+    "prefix": [
+      "sal"
+    ],
+    "body": [
+      "= render ActionLink::Show.new(url: $1, current_user:)",
+    ]
+  },
+  "= render ActionLink::Edit": {
+    "prefix": [
+      "eal"
+    ],
+    "body": [
+      "= render ActionLink::Edit.new(url: $1,",
+      "                              model: $2,",
+      "                              title: $3,",
+      "                              current_user:)",
+    ]
+  },
+  "= render ActionLink::Destroy": {
+    "prefix": [
+      "dal"
+    ],
+    "body": [
+      "= render ActionLink::Destroy.new(url: $1,",
+      "                                 model: $2,",
+      "                                 confirmation_subject: 'dieses Ding',",
+      "                                 associative: true,",
+      "                                 current_user:)",
+    ]
+  },
+}

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: action_link
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 1.0.1
 platform: ruby
 authors:
 - halo
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-20 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
@@ -77,14 +76,24 @@ files:
 - LICENSE.txt
 - README.md
 - app/assets/fonts/action_link/acticons.woff
+- app/assets/stylesheets/action_link/_index.sass
+- app/assets/stylesheets/action_link/acticons.css
+- app/assets/stylesheets/action_link/acticons.css.map
 - app/assets/stylesheets/action_link/acticons.sass
-- app/assets/stylesheets/action_link/all.sass
+- app/assets/stylesheets/action_link/fonts.css
+- app/assets/stylesheets/action_link/fonts.css.map
 - app/assets/stylesheets/action_link/fonts.sass
+- app/assets/stylesheets/action_link/style.css
+- app/assets/stylesheets/action_link/style.css.map
 - app/assets/stylesheets/action_link/style.scss
+- app/assets/stylesheets/action_link/variables.css
+- app/assets/stylesheets/action_link/variables.css.map
 - app/assets/stylesheets/action_link/variables.scss
 - app/components/action_link/application_component.rb
 - app/components/action_link/base.rb
+- app/components/action_link/custom.rb
 - app/components/action_link/destroy.rb
+- app/components/action_link/download.rb
 - app/components/action_link/edit.rb
 - app/components/action_link/new.rb
 - app/components/action_link/show.rb
@@ -95,6 +104,7 @@ files:
 - lib/action_link/model.rb
 - lib/action_link/title_subject_name.rb
 - lib/action_link/version.rb
+- vscode/action_link.code-snippets
 homepage: https://github.com/halo/action_link
 licenses:
 - MIT
@@ -103,7 +113,6 @@ metadata:
   source_code_uri: https://github.com/halo/action_link
   changelog_uri: https://github.com/halo/halo/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -118,8 +127,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
-signing_key:
+rubygems_version: 4.0.1
 specification_version: 4
 summary: A set of ViewComponents for common links (show, edit, delete, etc.)
 test_files: []

data/app/assets/stylesheets/action_link/all.sass

@@ -1,4 +0,0 @@
-@import ./variables
-@import ./style
-@import ./fonts
-@import ./acticons