evc_rails 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 703fa9100249c54f63c8e567d5d8cde7b3908b6777dfb555f2d2e72a949d4daa
-  data.tar.gz: f175e943945bc31a3d4da2be22290e7f843546c0bb6dc0426ad22d1433472fe6
+  metadata.gz: a7fda15b180ea02549511ff7aa2f1a51071ef8cce0fbf9721c92cc8fe4b6f605
+  data.tar.gz: 03ab565adcff81843d342152c4631c22124ee01d820e8a007a590afea3792347
 SHA512:
-  metadata.gz: dcd338b43347af1e971b99d50298d425da85193856f0362a4b7358ad19fbe3b059b5808b6c7ba0bf0f53944244d2bf2a5a7fd8e2283d6d13912f138c683d6b36
-  data.tar.gz: c902814035da4a002d4006df67b07e8e71256084a9bc3585a256d1b14281eb5bee41c4941b0d7956f4c6d87330bf72cfdfb5edef2b03321a94e99c676af2e331
+  metadata.gz: c1b7c0694278f7bffbf73b23423f14ca96f993cdfd0f19fe230ce52014405d8f1221f0ff3922c9ae7fab2e889832d1de480b0465b875cfcb4cd6ad26c012fd34
+  data.tar.gz: 24c79d6ba0ac68acea62831ee0043bfb175ac05a3aab97cbe641b503258dfb4becabc21cc72b7f2b03bffdd8d68a0d88902dd9e82d79101e0c876cd28654f285

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
@@ -93,10 +95,14 @@ 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")
+            # Handle both namespaced (UI::Button) and non-namespaced (Button) components
+            component_class_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"
@@ -161,7 +167,8 @@ module EvcRails
 
             # 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}"
+              raise ArgumentError,
+                    "Mismatched tags: expected </#{component_class_name}>, got </#{closing_tag_name}> in template #{template.identifier}"
             end
 
             # Recursively process the content between the opening and closing tags.
@@ -179,9 +186,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.1"
 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.1
 platform: ruby
 authors:
 - scttymn