komponent 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a99b2271c7cb864588a945d95ffe2bb96b1c29f8
-  data.tar.gz: 523d53f622f49450b839515dd34441087123d32c
+  metadata.gz: 4658a034e4427f5870e308f64d0699e9b588b198
+  data.tar.gz: ef78a5b00c52b95676b15741765c8d221d12c697
 SHA512:
-  metadata.gz: 3c4501a2a63283281a76cf550c40e4544c6fe5d834c539bf3b6e88b1999a17917f6b13033cc86ee0c861e13204f296a6c22ea89ef724da4b67861728f721254e
-  data.tar.gz: 117abc530d8d1bdff4e68d63ebc43eae8eaf80babd0bc4778b91673c8edbf62c03f752410d37b545e9c49127c8741bd0d1d7c96969330a0d481d87090f98951e
+  metadata.gz: e362c8e4e277a68bfbf469c27c15f47a2544925710c16901b94eaf4b3d56a7359237f2b747a9b157ec68cc256476d11212456a37bc89e151b2d6aa6b8c823e2d
+  data.tar.gz: d8d8e23f3b219769d250cb58c46428bcc6344bbc68c18b300b39ef3d75d7d2ad8935ae44920da98d0a756dfd4efa08073d45f6e79222d492ff799454b027b5d2

data/.rubocop.yml

@@ -0,0 +1,112 @@
+AllCops:
+  TargetRubyVersion: 2.4
+  DisabledByDefault: true
+  Exclude:
+    - 'node_modules/**/*'
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+
+Gemspec/OrderedDependencies:
+  Enabled: true
+
+Style/BlockDelimiters:
+  Enabled: true
+
+Style/BracesAroundHashParameters:
+  Enabled: true
+  EnforcedStyle: no_braces
+
+Style/Dir:
+  Enabled: true
+
+Style/Encoding:
+  Enabled: true
+
+Style/For:
+  Enabled: true
+  EnforcedStyle: each
+
+Style/MethodCallWithoutArgsParentheses:
+  Enabled: true
+
+Style/MethodDefParentheses:
+  Enabled: true
+
+Naming/ConstantName:
+  Enabled: true
+
+Naming/FileName:
+  Enabled: true
+
+Naming/MethodName:
+  Enabled: true
+
+Naming/PredicateName:
+  Enabled: true
+
+Naming/VariableName:
+  Enabled: true
+
+Lint/BlockAlignment:
+  Enabled: true
+  EnforcedStyleAlignWith: start_of_block
+
+Lint/ConditionPosition:
+  Enabled: true
+
+Lint/DefEndAlignment:
+  Enabled: true
+
+Lint/DeprecatedClassMethods:
+  Enabled: true
+
+Layout/AlignParameters:
+  Enabled: true
+
+Layout/BlockEndNewline:
+  Enabled: true
+
+Layout/CaseIndentation:
+  Enabled: true
+
+Layout/ClosingParenthesisIndentation:
+  Enabled: true
+
+Layout/DotPosition:
+  Enabled: true
+
+Layout/ElseAlignment:
+  Enabled: true
+
+Layout/EmptyLines:
+  Enabled: true
+
+Layout/EmptyLinesAroundAccessModifier:
+  Enabled: true
+
+Layout/SpaceAroundBlockParameters:
+  Enabled: true
+
+Layout/SpaceAroundEqualsInParameterDefault:
+  Enabled: true
+
+Layout/SpaceAroundOperators:
+  Enabled: true
+
+Layout/SpaceBeforeBlockBraces:
+  Enabled: true
+
+Layout/SpaceBeforeComma:
+  Enabled: true
+
+Layout/SpaceInsideArrayLiteralBrackets:
+  Enabled: true
+
+Layout/SpaceInsideHashLiteralBraces:
+  Enabled: true
+
+Layout/SpaceInsideParens:
+  Enabled: true
+
+Layout/TrailingWhitespace:
+  Enabled: true

data/.travis.yml

@@ -1,4 +1,6 @@
 language: ruby
 rvm:
   - 2.4
-script: bundle exec cucumber
+script:
+  - bundle exec rubocop
+  - bundle exec cucumber

data/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+## Upcoming release
+
+## v1.1.0 (2018-01-12)
+
+**Enhancements:**
+- [stimulus](https://github.com/stimulusjs/stimulus) integration
+- Component generator supports `css`, `scss`, `sass` stylesheet engine
+- Add a component path resolver
+
+**Bug fixes**
+- Make `content_for` work in component
+- Fix issue with wrong stylesheet extension being used when
+imported in JavaScript files
+
+**Deprecation**
+- `render_partial` is deprecated in favor of default `render`
+- The file naming convention will be changed in the next major version, for namespaced components, to include the namespace:
+  - `frontend/components/admin/button/_button.html.slim` -> `frontend/components/admin/button/_admin_button.html.slim`
+  - `frontend/components/admin/button/button.js` -> `frontend/components/admin/button/admin_button.js`
+  - `frontend/components/admin/button/button.css` -> `frontend/components/admin/button/admin_button.css`
+
+## v1.0.0 (2018-01-01)
+
+**Enhancements:**
+
+- Components namespacing
+- Implement basic features
+- Implement `render_partial` helper
+
+## v1.0.0.pre.2 (2017-12-09)
+
+**Enhancements:**
+
+- Lazy-load helpers and configuration
+- Add an install generator (`rails g komponent:install`)
+- Standardize components name (underscore for all except css classes are dasherized)
+- Support `erb`, `slim`, and `haml` template engines
+- Add an `--locale` option to component generator
+- Documentation improvements
+
+## v1.0.0.pre.1 (2017-12-09)
+
+First pre-release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at contact@komposable.io. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/README.md

@@ -1,15 +1,37 @@
 # <img alt="Komponent" src="https://raw.github.com/ouvrages/komponent/master/logo.svg?sanitize=true" width="200" height="40" />
 [![Build Status](https://travis-ci.org/komposable/komponent.svg?branch=master)](https://travis-ci.org/komposable/komponent)
-=======
+[![Gem](https://img.shields.io/gem/v/komponent.svg)](https://github.com/komposable/komponent)
 
 **Komponent** implements an opinionated way of organizing front-end code in Ruby on Rails, based on _components_.
 
-Each component has its own folder, containing a Ruby module, a slim partial, a PostCSS stylesheet and a JavaScript file.
+Each component has its own folder, containing a Ruby module, a partial, a stylesheet and a JavaScript file.
 
 Komponent relies heavily on webpacker to manage dependencies and generate the production JS and CSS files.
 
+This README examples are written in Slim, but Komponent is compatible with:
+
+- your preferred templating language (Slim, Haml, erb)
+- your stylesheet language of choice (Sass, SCSS, CSS, PostCSS)
+
 This gem has been inspired by our Rails development practices at [Ouvrages](https://ouvrages-web.fr) and [Etamin Studio](https://etaminstudio.com), and the (excellent) [_Modern Front-end in Rails_](https://evilmartians.com/chronicles/evil-front-part-1) article from Evil Martians.
 
+## Table of contents
+
+- [Getting started](#getting-started)
+- [Usage](#usage)
+  - [Passing variables](#passing-variables)
+  - [Passing a block](#passing-a-block)
+  - [Properties](#properties)
+  - [Helpers](#helpers)
+  - [Component partials](#component-partials)
+  - [Namespacing components](#namespacing-components)
+  - [Stimulus integration](#stimulus-integration)
+  - [Internationalization](#internationalization)
+  - [Configuration](#configuration)
+    - [Default options for the generators](#default-options-for-the-generators)
+    - [Additional paths](#additional-paths)
+- [Contributing](#contributing)
+- [License](#license)
 
 ## Getting started
 
@@ -137,19 +159,18 @@ a.button(href=@href)
 
 ### Component partials
 
-You can also choose to split your component into partials. In this case, use the `render_partial` helper to render a partial, stored inside the component directory. It's a simple shorthand of the default `render` helper from Rails. 
+You can also choose to split your component into partials. In this case, we can use the default `render` helper to render a partial, stored inside the component directory.
 
 ```slim
 / frontend/components/button/_button.html.slim
 
 = a.button(href=@href)
   = @text
-  / The line below is similar to: render("components/button/suffix", text: "external link") if external_link?
-  = render_partial("suffix", text: "external link") if external_link?
+  = render("suffix", text: "external link") if external_link?
 ```
 
 ```slim
-/ frontend/components/button/_external_link.html.slim
+/ frontend/components/button/_suffix.html.slim
 
 = " (#{text})"
 ```
@@ -165,9 +186,144 @@ rails generate component admin/header
 This will create the component in an `admin` folder, and name its Ruby module `AdminHeaderComponent`.
 
 
+### Stimulus integration
+
+You can pass `--stimulus` to both generators to use [stimulus](https://github.com/stimulusjs/stimulus) in your components.
+
+```sh
+rails generate komponent:install --stimulus
+```
+
+This will yarn `stimulus` package, and create a `stimulus_application.js` in the `frontend` folder.
+
+```sh
+rails generate component button --stimulus
+```
+
+This will create a component with an additional `button_controller.js` file, and define a `data-controller` in the generated view.
+
+### Internationalization
+
+In case your component will contain text strings you want to localize, you can pass the `--locale` option to generate localization files in your component directory.
+
+```sh
+rails generate component button --locale
+```
+
+This will create a `yml` file for each locale (using `I18n.available_locales`). In your component, the `t` helper will use the same ["lazy" lookup](http://guides.rubyonrails.org/i18n.html#lazy-lookup) as Rails.
+
+```slim
+/ frontend/components/button/_button.html.slim
+= a.button(href=@href)
+  = @text
+  = render("suffix", text: t(".external_link")) if external_link?
+```
+
+```yml
+/ frontend/components/button/button.en.yml
+en:
+  button_component:
+    external_link: "external link"
+```
+
+```yml
+/ frontend/components/button/button.fr.yml
+fr:
+  button_component:
+    external_link: "lien externe"
+```
+
+### Configuration
+
+#### Default options for the generators
+
+You can configure the generators in an initializer or in `application.rb`, so you don't have to add `--locale` and/or `--stimulus` flags every time you generate a fresh component.
+
+```rb
+config.generators do |g|
+  g.komponent stimulus: true, locale: true # both are false by default
+end
+```
+
+#### Additional paths
+
+You may want to use components in a gem, or a Rails engine, and expose them to the main app. In order to do that, you just have to configure the paths where Komponent will look for components.
+
+From a gem:
+
+```rb
+module MyGem
+  class Railtie < Rails::Railtie
+    config.after_initialize do |app|
+      app.config.komponent.component_paths.append(self.root.join("frontend/components"))
+    end
+
+    initializer "my_gem.action_dispatch" do |app|
+      ActiveSupport.on_load :action_controller do
+        ActionController::Base.prepend_view_path self.root.join("frontend")
+      end
+    end
+
+    initializer 'my_gem.autoload', before: :set_autoload_paths do |app|
+      app.config.autoload_paths << self.root.join("frontend")
+    end
+
+    private
+
+    def self.root
+      Pathname.new(File.dirname(__dir__))
+    end
+  end
+end
+```
+
+or from an engine:
+
+
+```rb
+module MyEngine
+  class Engine < Rails::Engine
+    isolate_namespace MyEngine
+
+    config.after_initialize do |app|
+      app.config.komponent.component_paths.append(MyEngine::Engine.root.join("frontend/components"))
+    end
+
+    initializer "my_engine.action_dispatch" do |app|
+      ActiveSupport.on_load :action_controller do
+        ActionController::Base.prepend_view_path MyEngine::Engine.root.join("frontend")
+      end
+    end
+
+    initializer 'my_engine.autoload', before: :set_autoload_paths do |app|
+      app.config.autoload_paths << MyEngine::Engine.root.join("frontend")
+    end
+  end
+end
+```
+
+Make sure you add `komponent` to the runtime dependencies in your `gemspec`.
+
+In order to compile packs from engine, and to use `javascript_pack_tag 'engine'`, you need to:
+
+- Create a pack file in main app
+
+```js
+// frontend/packs/engine.js
+
+import 'packs/engine';
+```
+
+- Append engine frontend folder to `resolved_paths` in `config/webpacker.yml` from your main app
+
+```yml
+resolved_paths:
+  - engine/frontend
+```
+
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/ouvrages/komponent.
+Bug reports and pull requests are welcome on GitHub at https://github.com/komposable/komponent.
 
 ## License
 

data/komponent.gemspec

@@ -1,4 +1,3 @@
-# coding: utf-8
 lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require "komponent/version"
@@ -21,10 +20,12 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
+  spec.add_development_dependency "aruba"
   spec.add_development_dependency "bundler", "~> 1.15"
-  spec.add_development_dependency "rake", "~> 10.0"
-
   spec.add_development_dependency "cucumber"
-  spec.add_development_dependency "aruba"
   spec.add_development_dependency "rails", ">= 5.0"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rubocop", '~> 0.52.1'
+
+  spec.add_runtime_dependency "webpacker", ">= 3.0.0"
 end

data/lib/generators/component/component_generator.rb

@@ -2,17 +2,21 @@ class ComponentGenerator < Rails::Generators::NamedBase
   source_root File.expand_path('../templates', __FILE__)
 
   class_option :locale, type: :boolean, default: false
+  class_option :stimulus, type: :boolean, default: false
 
   def create_view_file
-    template "view.html.#{template_engine}.erb", component_path + "_#{component_name}.html.#{template_engine}"
+    template "#{template_prefix}view.html.#{template_engine}.erb", component_path + "_#{name_with_namespace.underscore}.html.#{template_engine}"
   end
 
   def create_css_file
-    template "css.erb", component_path + "#{component_name}.css"
+    template "#{stylesheet_engine}.erb", component_path + "#{name_with_namespace}.#{stylesheet_engine}"
   end
 
   def create_js_file
-    template "js.erb", component_path + "#{component_name}.js"
+    template "js.erb", component_path + "#{name_with_namespace}.js"
+    if stimulus?
+      template "stimulus_controller_js.erb", component_path + "#{name_with_namespace}_controller.js"
+    end
   end
 
   def create_rb_file
@@ -24,7 +28,7 @@ class ComponentGenerator < Rails::Generators::NamedBase
 
     I18n.available_locales.each do |locale|
       @locale = locale
-      template "locale.erb", component_path + "#{component_name}.#{locale}.yml"
+      template "locale.erb", component_path + "#{name_with_namespace}.#{locale}.yml"
     end
   end
 
@@ -37,7 +41,7 @@ class ComponentGenerator < Rails::Generators::NamedBase
     split_name[0..-2].each do |split|
       base_path += split
       file_path = base_path + "index.js"
-      create_file(file_path) unless File.exists?(file_path)
+      create_file(file_path) unless File.exist?(file_path)
       imports << base_path.relative_path_from(root_path)
     end
 
@@ -54,12 +58,16 @@ class ComponentGenerator < Rails::Generators::NamedBase
     end
 
     append_to_file(base_path + "index.js") do
-      "import \"#{base_path.relative_path_from(root_path)}/#{component_name}/#{component_name}\";\n"
-    end 
+      "import \"#{base_path.relative_path_from(root_path)}/#{component_name}/#{name_with_namespace.underscore}\";\n"
+    end
   end
 
   protected
 
+  def template_prefix
+    stimulus? ? "stimulus_" : ""
+  end
+
   def split_name
     name.split(/[:,::,\/]/).reject(&:blank?).map(&:underscore)
   end
@@ -81,16 +89,44 @@ class ComponentGenerator < Rails::Generators::NamedBase
   def component_class_name
     name_with_namespace.dasherize
   end
-  
+
   def component_name
     split_name.last.underscore
   end
 
   def template_engine
-    Rails.application.config.app_generators.rails[:template_engine] || :erb
+    app_generators.rails[:template_engine] || :erb
+  end
+
+  def stylesheet_engine
+    if sass = rails_configuration.try(:sass)
+      sass[:preferred_syntax]
+    else
+      :css
+    end
   end
 
   def locale?
-    options[:locale]
+    return options[:locale] if options[:locale]
+    komponent_configuration[:locale]
+  end
+
+  def stimulus?
+    return options[:stimulus] if options[:stimulus]
+    komponent_configuration[:stimulus]
+  end
+
+  private
+
+  def komponent_configuration
+    { stimulus: nil, locale: nil }.merge app_generators.komponent
+  end
+
+  def rails_configuration
+    Rails.application.config
+  end
+
+  def app_generators
+    rails_configuration.app_generators
   end
 end

data/lib/generators/component/templates/js.erb

@@ -1 +1,11 @@
-import "./<%= component_name %>.css";
+<%- if stimulus? -%>
+import application from 'stimulus_application';
+import { autoload } from "stimulus/webpack-helpers";
+
+import "./<%= name_with_namespace %>.<%= stylesheet_engine %>";
+
+const context = require.context('./', true, /_controller\.js$/);
+autoload(context, application);
+<%- else -%>
+import "./<%= name_with_namespace %>.<%= stylesheet_engine %>";
+<%- end -%>

data/lib/generators/component/templates/locale.erb

@@ -1,3 +1,3 @@
 <%= @locale %>:
-  <%= component_name %>:
-    component_name: <%= component_name %>
+  <%= module_name.underscore %>:
+    component_name: <%= module_name.underscore %>

data/lib/generators/component/templates/sass.erb

@@ -0,0 +1 @@
+.<%= component_class_name %>

data/lib/generators/component/templates/scss.erb

@@ -0,0 +1 @@
+.<%= component_class_name %> {}

data/lib/generators/component/templates/stimulus_controller_js.erb

@@ -0,0 +1,9 @@
+import { Controller } from "stimulus";
+import "./<%= name_with_namespace %>.<%= stylesheet_engine %>";
+
+export default class extends Controller {
+  connect() {
+    console.log("Hello, Stimulus!", this.element);
+  }
+}
+

data/lib/generators/component/templates/stimulus_view.html.erb.erb

@@ -0,0 +1,7 @@
+<div data-controller="<%= component_class_name %>" class="<%= component_class_name %>">
+  <%- if locale? -%>
+  <%%= t ".component_name" %>
+  <%- else -%>
+  <%= module_name.underscore %>
+  <%- end -%>
+</div>

data/lib/generators/component/templates/stimulus_view.html.haml.erb

@@ -0,0 +1,6 @@
+.<%= component_class_name %>{'data-controller': "<%= component_class_name %>", class: "<%= component_class_name %>"}
+  <%- if locale? -%>
+  = t ".component_name"
+  <%- else -%>
+  <%= module_name.underscore %>
+  <%- end -%>

data/lib/generators/component/templates/stimulus_view.html.slim.erb

@@ -0,0 +1,6 @@
+div data-controller="<%= component_class_name %>" class="<%= component_class_name %>"
+  <%- if locale? -%>
+  = t ".component_name"
+  <%- else -%>
+  <%= module_name.underscore %>
+  <%- end -%>

data/lib/generators/component/templates/view.html.erb.erb

@@ -1,3 +1,7 @@
 <div class="<%= component_class_name %>">
-  <%= component_name %>
+  <%- if locale? -%>
+  <%%= t "<%= module_name.underscore %>.component_name" %>
+  <%- else -%>
+  <%= module_name.underscore %>
+  <%- end -%>
 </div>

data/lib/generators/component/templates/view.html.haml.erb

@@ -1 +1,6 @@
-.<%= component_class_name %> <%= component_name %>
+.<%= component_class_name %>{class: "<%= component_class_name %>"}
+  <%- if locale? -%>
+  = t "<%= module_name.underscore %>.component_name"
+  <%- else -%>
+  <%= module_name.underscore %>
+  <%- end -%>

data/lib/generators/component/templates/view.html.slim.erb

@@ -1 +1,6 @@
-.<%= component_class_name %> <%= component_name %>
+div class="<%= component_class_name %>"
+  <%- if locale? -%>
+  = t "<%= module_name.underscore %>.component_name"
+  <%- else -%>
+  <%= module_name.underscore %>
+  <%- end -%>

data/lib/generators/komponent/install_generator.rb

@@ -1,8 +1,10 @@
 module Komponent
   module Generators
     class InstallGenerator < Rails::Generators::Base
+      class_option :stimulus, type: :boolean, default: false
+
       def check_webpacker_dependency
-        unless File.exists?(webpacker_configuration_file) and File.directory?(webpacker_default_structure)
+        unless File.exist?(webpacker_configuration_file) and File.directory?(webpacker_default_structure)
           raise Thor::Error, dependencies_not_met_error_message
         end
       end
@@ -24,12 +26,33 @@ module Komponent
         create_file(components_directory.join("index.js"))
       end
 
+      def create_stimulus_file
+        template = <<-eos
+import { Application } from "stimulus";
+const application = Application.start();
+export default application;
+        eos
+        create_file(stimulus_application_path, stimulus? ? template : "")
+      end
+
       def append_to_application_pack
         append_to_file(application_pack_path, "import 'components';")
       end
 
+      def install_stimulus
+        if stimulus?
+          in_root do
+            run("yarn add stimulus")
+          end
+        end
+      end
+
       private
 
+      def stimulus_application_path
+        komponent_root_directory.join("stimulus_application.js")
+      end
+
       def application_pack_path
         komponent_root_directory.join("packs", "application.js")
       end
@@ -53,6 +76,25 @@ module Komponent
       def dependencies_not_met_error_message
         "Seems you don't have webpacker installed in your project. Please install webpacker, and follow instructions at https://github.com/rails/webpacker"
       end
+
+      def stimulus?
+        return options[:stimulus] if options[:stimulus]
+        komponent_configuration[:stimulus]
+      end
+
+      private
+
+      def komponent_configuration
+        { stimulus: nil, locale: nil }.merge app_generators.komponent
+      end
+
+      def rails_configuration
+        Rails.application.config
+      end
+
+      def app_generators
+        rails_configuration.app_generators
+      end
     end
   end
 end

data/lib/komponent/core/component_path_resolver.rb

@@ -0,0 +1,52 @@
+module Komponent
+  class ComponentPathResolver
+    def resolve(component_name)
+      root_path = component_paths.find do |path|
+        path_has_component?(path, component_name)
+      end
+
+      if root_path.nil?
+        raise ComponentPathResolver::MissingComponentError.new(
+          component_name,
+          component_paths,
+        )
+      end
+
+      root_path.join(*component_name)
+    end
+
+    protected
+
+    def path_has_component?(path, component_name)
+      file_name = path.join(*[
+        component_name,
+        "#{component_name.split("/").join("_")}_component.rb",
+      ])
+      File.exist?(file_name)
+    end
+
+    def component_paths
+      komponent_configuration.component_paths.map do |path|
+        Pathname.new(path)
+      end
+    end
+
+    def komponent_configuration
+      app_configuration.komponent
+    end
+
+    def app_configuration
+      Rails.application.config
+    end
+
+    class MissingComponentError < StandardError
+      def initialize(component_name, paths)
+        message = "Component `#{component_name}` not found in:\n"
+        paths.each do |path|
+          message += "  * #{path}\n"
+        end
+        super(message)
+      end
+    end
+  end
+end

data/lib/komponent/core/translation.rb

@@ -0,0 +1,22 @@
+module Komponent
+  module Translation
+    def translate(key, options = {})
+      virtual_path = @virtual_path
+
+      is_component = key.to_s.first == "." and
+        virtual_path =~ /^components/
+
+      if is_component
+        path = virtual_path.match(/^components\/.+\/_(.+)/)[1]
+        path += "_component"
+        defaults = [:"#{path}#{key}"]
+        defaults << options[:default] if options[:default]
+        options[:default] = defaults.flatten
+        key = "#{path}.#{key}"
+      end
+
+      super(key, options)
+    end
+    alias :t :translate
+  end
+end

data/lib/komponent/komponent_helper.rb

@@ -1,16 +1,25 @@
 module KomponentHelper
   def component(component, locals = {}, &block)
-    components_path = Rails.root.join("frontend", "components")
+    component_path = Komponent::ComponentPathResolver.new.resolve(component)
 
     parts = component.split("/")
-    component_path = components_path.join(*parts)
     component_name = parts.join("_")
     component_path = component_path.join("#{component_name}_component")
+
     require_dependency(component_path)
 
     component_module = "#{component_name}_component".camelize.constantize
     context = controller.view_context.dup
+
+    context.view_flow = view_flow
+
+    view_renderer = context.view_renderer = context.view_renderer.dup
+    lookup_context = view_renderer.lookup_context = view_renderer.lookup_context.dup
+    lookup_context.prefixes = ["components/#{component}"]
+
     context.class_eval { prepend component_module }
+    context.class_eval { prepend Komponent::Translation }
+
     capture_block = proc { capture(&block) } if block
 
     context.instance_eval do
@@ -36,33 +45,37 @@ module KomponentHelper
     if context.respond_to?(custom_method)
       context.public_send(custom_method, locals, &capture_block)
     else
-      context.render("components/#{component}/#{parts.last}", &capture_block)
+      begin
+        context.render("components/#{component}/#{parts.join('_')}", &capture_block)
+      rescue ActionView::MissingTemplate
+        warn "[DEPRECATION WARNING] `#{parts.last}` filename in namespace is deprecated in favor of `#{parts.join('_')}`."
+        context.render("components/#{component}/#{parts.last}", &capture_block)
+      end
     end
   end
-
   alias :c :component
 
   def render_partial(partial_name, locals = {}, &block)
-    benchmark("Rendered partial #{partial_name}") do
-      context = controller.view_context
-      view_paths = context.lookup_context.view_paths.dup
-      components_path = Rails.root.join "frontend/components"
-
-      capture_block = proc { capture(&block) } if block
+    warn "[DEPRECATION WARNING] `render_partial` is deprecated. Please use default `render` instead."
 
-      current_dir = Pathname.new(@virtual_path).dirname
+    context = controller.view_context
+    view_paths = context.lookup_context.view_paths.dup
+    components_path = Rails.root.join "frontend/components"
 
-      context.lookup_context.prefixes.prepend current_dir
-      context.lookup_context.view_paths.unshift components_path
+    capture_block = proc { capture(&block) } if block
 
-      rendered_partial = capture do 
-        context.render partial_name, locals, &capture_block
-      end
+    current_dir = Pathname.new(@virtual_path).dirname
 
-      context.lookup_context.prefixes.delete current_dir
-      context.lookup_context.view_paths = view_paths
+    context.lookup_context.prefixes.prepend current_dir
+    context.lookup_context.view_paths.unshift components_path
 
-      rendered_partial
+    rendered_partial = capture do
+      context.render partial_name, locals, &capture_block
     end
+
+    context.lookup_context.prefixes.delete current_dir
+    context.lookup_context.view_paths = view_paths
+
+    rendered_partial
   end
 end

data/lib/komponent/railtie.rb

@@ -1,7 +1,18 @@
+require 'webpacker'
 require 'komponent/core/component_helper'
+require 'komponent/core/translation'
+require 'komponent/core/component_path_resolver'
 
 module Komponent
   class Railtie < Rails::Railtie
+    config.komponent = ActiveSupport::OrderedOptions.new
+    config.komponent.component_paths = []
+
+    config.before_configuration do |app|
+      app.config.komponent = config.komponent
+      app.config.komponent.component_paths.append(app.config.root.join("frontend/components"))
+    end
+
     initializer "komponent.action_view" do |app|
       ActiveSupport.on_load :action_view do
         require 'komponent/komponent_helper'
@@ -17,7 +28,7 @@ module Komponent
 
     initializer "komponent.i18n" do |app|
       ActiveSupport.on_load :i18n do
-        I18n.load_path.concat(Dir["#{app.config.root}/frontend/components/*/*.yml"])
+        I18n.load_path.concat(Dir["#{app.config.root}/frontend/components/**/*.yml"])
       end
     end
 

data/lib/komponent/version.rb

@@ -1,3 +1,3 @@
 module Komponent
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: komponent
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Ouvrages
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-01-01 00:00:00.000000000 Z
+date: 2018-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: aruba
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '1.15'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '1.15'
 - !ruby/object:Gem::Dependency
   name: cucumber
   requirement: !ruby/object:Gem::Requirement
@@ -53,33 +53,61 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: aruba
+  name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.52.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.52.1
+- !ruby/object:Gem::Dependency
+  name: webpacker
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
 description: An opinionated way of organizing front-end code in Ruby on Rails, based
   on components
 email:
@@ -89,7 +117,10 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rubocop.yml"
 - ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -103,12 +134,20 @@ files:
 - lib/generators/component/templates/js.erb
 - lib/generators/component/templates/locale.erb
 - lib/generators/component/templates/rb.erb
+- lib/generators/component/templates/sass.erb
+- lib/generators/component/templates/scss.erb
+- lib/generators/component/templates/stimulus_controller_js.erb
+- lib/generators/component/templates/stimulus_view.html.erb.erb
+- lib/generators/component/templates/stimulus_view.html.haml.erb
+- lib/generators/component/templates/stimulus_view.html.slim.erb
 - lib/generators/component/templates/view.html.erb.erb
 - lib/generators/component/templates/view.html.haml.erb
 - lib/generators/component/templates/view.html.slim.erb
 - lib/generators/komponent/install_generator.rb
 - lib/komponent.rb
 - lib/komponent/core/component_helper.rb
+- lib/komponent/core/component_path_resolver.rb
+- lib/komponent/core/translation.rb
 - lib/komponent/komponent_helper.rb
 - lib/komponent/railtie.rb
 - lib/komponent/version.rb