evc_rails 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 703fa9100249c54f63c8e567d5d8cde7b3908b6777dfb555f2d2e72a949d4daa
-  data.tar.gz: f175e943945bc31a3d4da2be22290e7f843546c0bb6dc0426ad22d1433472fe6
+  metadata.gz: 9b8286c7a2de504f1e3320186e144fbeadd0c36cf2b0e56b7c2a677994d3ff80
+  data.tar.gz: a03f8ac74485749cf933bab0d0fb3abe16e042c41ba065fd6f259d2379a58225
 SHA512:
-  metadata.gz: dcd338b43347af1e971b99d50298d425da85193856f0362a4b7358ad19fbe3b059b5808b6c7ba0bf0f53944244d2bf2a5a7fd8e2283d6d13912f138c683d6b36
-  data.tar.gz: c902814035da4a002d4006df67b07e8e71256084a9bc3585a256d1b14281eb5bee41c4941b0d7956f4c6d87330bf72cfdfb5edef2b03321a94e99c676af2e331
+  metadata.gz: 9f1256d0f4b2d3ae9d9ac59182dab66c32898f6294e739d23819fc8c590e935f8c2ac5f27a3d5622e50aa5e4657af7618fe8b6bfe97da5baaacb0b296a3d0de3
+  data.tar.gz: f6284a6a2d33cbbffa09485895cfbd8b5a9b680073565281b95bdbf32caeb599254daece8fe837e13e1c2f96f3eb4f6b2731be6e1a6ea75cb69a2eb5b07399dc

data/README.md

@@ -6,11 +6,13 @@ EvcRails is a Rails gem that introduces a custom .evc template handler, allowing
 
 PascalCase Component Tags: Define and use your View Components with <MyComponent> or self-closing <MyComponent /> syntax directly in your .evc templates.
 
+Namespaced Components: Support for namespaced components like <Ui::Button /> or <Forms::Input /> for better organization.
+
 Attribute Handling: Pass attributes to your components using standard HTML-like key="value", key='value', or Ruby expressions key={@variable}.
 
 Content Blocks: Components can accept content blocks (<MyComponent>content</MyComponent>) which are passed to the View Component via a block.
 
-Automatic Component Resolution: Automatically appends "Component" to your tag name if it's not already present (e.g., <Button> resolves to ButtonComponent).
+Automatic Component Resolution: Automatically appends "Component" to your tag name if it's not already present (e.g., <Button> resolves to ButtonComponent, <Ui::Button> resolves to Ui::ButtonComponent).
 
 Performance Optimized: Includes in-memory caching of compiled templates and memoization of component class lookups for efficient rendering in production.
 
@@ -57,7 +59,7 @@ end
 
 And its associated template app/components/my_component_component.html.erb (if you're using separate templates):
 
-```html
+```erb
 <!-- app/components/my_component_component.html.erb -->
 <div class="my-component">
   <h2><%= @title %></h2>
@@ -68,7 +70,7 @@ And its associated template app/components/my_component_component.html.erb (if y
 2. Create an .evc Template
    Now, create a template file with the .evc extension. For instance, app/views/pages/home.html.evc:
 
-```html
+```erb
 <!-- app/views/pages/home.html.evc -->
 <h1>Welcome to My App</h1>
 
@@ -77,8 +79,15 @@ And its associated template app/components/my_component_component.html.erb (if y
   <button text="Click Me" />
 </MyComponent>
 
+<%# Namespaced components for better organization %>
+<Ui::Button text="Click Me" />
+<Forms::Input name="email" placeholder="Enter your email" />
+<Layout::Container>
+  <p>Content inside a layout container</p>
+</Layout::Container>
+
 <%# A more concise way to render your DoughnutChartComponent %>
-<DoughnutChart rings="{@progress_data}" />
+<DoughnutChart rings={@progress_data} />
 
 <%# You can still use standard ERB within .evc files %>
 <p><%= link_to "Go somewhere", some_path %></p>
@@ -92,24 +101,57 @@ And its associated template app/components/my_component_component.html.erb (if y
 config.eager_load_paths << Rails.root.join("app/components")
 ```
 
+## Component Organization
+
+You can organize your components into namespaces for better structure:
+
+```
+app/components/
+├── ui/
+│   ├── button_component.rb
+│   ├── card_component.rb
+│   └── input_component.rb
+├── forms/
+│   ├── input_component.rb
+│   ├── select_component.rb
+│   └── checkbox_component.rb
+├── layout/
+│   ├── container_component.rb
+│   ├── header_component.rb
+│   └── footer_component.rb
+└── my_component_component.rb
+```
+
+Then use them in your .evc templates:
+
+```erb
+<Ui::Button text="Submit" />
+<Forms::Input name="username" />
+<Layout::Container>
+  <Layout::Header title="My App" />
+  <p>Main content</p>
+  <Layout::Footer />
+</Layout::Container>
+```
+
 ## How it Works
 
 When Rails processes an .evc template, EvcRails intercepts it and performs the following transformations:
 
 ```erb
-<MyComponent title="Hello World">... </MyComponent>
+<Card title="Hello World">... </Card>
 ```
 
 becomes:
 
 ```ruby
-<%= render MyComponentComponent.new(title: "Hello World") do %>
+<%= render CardComponent.new(title: "Hello World") do %>
   ... (processed content) ...
 <% end %>
 ```
 
 ```erb
-<%=<button text="Click Me" />
+<Button text="Click Me" />
 ```
 
 becomes:
@@ -118,6 +160,16 @@ becomes:
 <%= render ButtonComponent.new(text: "Click Me") %>
 ```
 
+```erb
+<Ui::Button text="Click Me" />
+```
+
+becomes:
+
+```ruby
+<%= render Ui::ButtonComponent.new(text: "Click Me") %>
+```
+
 ```erb
 <DoughnutChart rings={@progress_data} />
 ```
@@ -147,7 +199,3 @@ Bug reports and pull requests are welcome on GitHub at [your-gem-repo-link]. Thi
 ## License
 
 The gem is available as open source under the terms of the MIT License
-
-```
-
-```

data/lib/evc_rails/template_handler.rb

@@ -12,16 +12,18 @@ module EvcRails
   module TemplateHandlers
     class Evc
       # Regex to match opening or self-closing PascalCase component tags with attributes
-      TAG_REGEX = %r{<([A-Z][a-zA-Z_]*)([^>]*)/?>}
+      # Updated to support namespaced components like UI::Button
+      TAG_REGEX = %r{<([A-Z][a-zA-Z_]*(::[A-Z][a-zA-Z_]*)*)([^>]*)/?>}
 
       # Regex to match closing PascalCase component tags
-      CLOSE_TAG_REGEX = %r{</([A-Z][a-zA-Z_]*)>}
+      # Updated to support namespaced components like UI::Button
+      CLOSE_TAG_REGEX = %r{</([A-Z][a-zA-Z_]*(::[A-Z][a-zA-Z_]*)*)>}
 
       # Regex for attributes: Supports string literals (key="value", key='value')
       # and Ruby expressions (key={@variable}).
       # Group 1: Attribute key, Group 2: Double-quoted value, Group 3: Single-quoted value,
       # Group 4: Ruby expression.
-      ATTRIBUTE_REGEX = /(\w+)=(?:\"([^"]*)\"|'([^']*)'|\{([^}]*)\})/
+      ATTRIBUTE_REGEX = /(\w+)=(?:"([^"]*)"|'([^']*)'|\{([^}]*)\})/
 
       # Cache for compiled templates to improve performance.
       # @cache will store { identifier: { source: original_source, result: compiled_result } }
@@ -56,8 +58,8 @@ module EvcRails
         # In development, templates change frequently, so caching would hinder development flow.
         unless Rails.env.development?
           self.class.instance_variable_set(:@cache, self.class.instance_variable_get(:@cache).merge({
-            identifier => { source: source, result: result }
-          }))
+                                                                                                      identifier => { source: source, result: result }
+                                                                                                    }))
         end
         result
       end
@@ -72,6 +74,18 @@ module EvcRails
         @component_class_memo = {}
       end
 
+      # Helper method to determine the full component class name
+      def resolve_component_class_name(tag_name)
+        if tag_name.include?("::")
+          # For namespaced components, just append Component
+          "#{tag_name}Component"
+        elsif tag_name.end_with?("Component")
+          tag_name
+        else
+          "#{tag_name}Component"
+        end
+      end
+
       # Processes the .evc template source, converting custom tags into Rails View Component render calls.
       # This method is recursive to handle nested components.
       def process_template(source, template)
@@ -93,14 +107,10 @@ module EvcRails
 
             is_self_closing = match[0].end_with?("/>")
             tag_name = match[1]
-            attributes_str = match[2].strip
+            attributes_str = match[3].strip
 
             # Determine the full component class name
-            component_class_name = if tag_name.end_with?("Component")
-                                     tag_name
-                                   else
-                                     "#{tag_name}Component"
-                                   end
+            component_class_name = resolve_component_class_name(tag_name)
 
             # Validate if the component class exists using memoization.
             # The component class will only be constantized once per unique class name
@@ -159,9 +169,15 @@ module EvcRails
             # Pop the corresponding opening tag from the stack
             component_class_name, render_params_str, start_pos = stack.pop
 
+            # Apply the same transformation to the closing tag name for comparison
+            expected_closing_component_name = resolve_component_class_name(closing_tag_name)
+
             # Check for mismatched tags (e.g., <div></p>)
-            if component_class_name != closing_tag_name
-              raise ArgumentError, "Mismatched tags: expected </#{component_class_name}>, got </#{closing_tag_name}> in template #{template.identifier}"
+            if component_class_name != expected_closing_component_name
+              # Extract the original tag name from the component class name for the error message
+              expected_tag_name = component_class_name.gsub(/Component$/, "")
+              raise ArgumentError,
+                    "Mismatched tags: expected </#{expected_tag_name}>, got </#{closing_tag_name}> in template #{template.identifier}"
             end
 
             # Recursively process the content between the opening and closing tags.
@@ -179,9 +195,7 @@ module EvcRails
         end
 
         # After parsing, if the stack is not empty, it means there are unclosed tags.
-        unless stack.empty?
-          raise ArgumentError, "Unclosed tag <#{stack.last[0]}> in template #{template.identifier}"
-        end
+        raise ArgumentError, "Unclosed tag <#{stack.last[0]}> in template #{template.identifier}" unless stack.empty?
 
         # Join all the collected parts to form the final ERB string.
         parts.join("")

data/lib/evc_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EvcRails
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: evc_rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - scttymn