phlex 0.5.2 → 1.0.0.rc1

data/docs/pages/translations.rb

@@ -1,81 +0,0 @@
-# frozen_string_literal: true
-
-module Pages
-	class Translations < ApplicationPage
-		def initialize
-			I18n.backend.store_translations(
-				"pt-BR", {
-					hello: "Olá",
-					views: { feedback: { welcome_message: { hello: "Olá" } } }
-				}
-			)
-			I18n.locale = "pt-BR"
-		end
-
-		def template
-			render Layout.new(title: "Translations") do
-				render Markdown.new(<<~MD)
-					# Translations
-
-					Phlex has built-in support for translations with the **[I18n Gem](https://github.com/ruby-i18n/i18n)**.
-
-					Just include `Phlex::Translation` in your view and use the `translate` method to access a translation.
-				MD
-
-				render Example.new do |e|
-					e.tab "welcome_message.rb", <<~RUBY
-						class WelcomeMessage < Phlex::HTML
-							include Phlex::Translation
-
-							def template
-								h1 { translate("hello") }
-							end
-						end
-					RUBY
-
-					e.tab "pt-PR.yml", <<~YAML, syntax: :yaml
-						pt-BR:
-						  hello: "Olá"
-					YAML
-
-					e.execute "WelcomeMessage.new.call"
-				end
-
-				render Markdown.new(<<~MD)
-					## Implicit scoopes
-
-					Start your translate key with a `.` to use the name of the view as an implicit scope.
-				MD
-
-				render Example.new do |e|
-					e.tab "welcome_message.rb", <<~RUBY
-						module Views
-							module Feedback
-								class WelcomeMessage < Phlex::HTML
-									include Phlex::Translation
-
-									def template
-										h1 { translate(".hello") }
-									end
-								end
-							end
-						end
-					RUBY
-
-					e.tab "pt-BR.yml", <<~YAML, syntax: :yaml
-						pt-BR:
-						  views:
-						    feedback:
-						      welcome_message:
-						        hello: Olá
-					YAML
-
-					e.execute <<~RUBY
-						Views::Feedback::WelcomeMessage.translation_path = 'views.feedback.welcome_message'
-						Views::Feedback::WelcomeMessage.new.call
-					RUBY
-				end
-			end
-		end
-	end
-end

data/docs/pages/views.rb

@@ -1,184 +0,0 @@
-# frozen_string_literal: true
-
-module Pages
-	class Views < ApplicationPage
-		def template
-			render Layout.new(title: "Phlex Views") do
-				render Markdown.new(<<~MD)
-					#  Views
-
-					Phlex Views are Ruby objects that represent your app's user interface — from pages and layouts and nav-bars, to headings and buttons and links.
-
-					You can create a view class by subclassing `Phlex::HTML` and defining a `template` instance method.
-				MD
-
-				render Example.new do |e|
-					e.tab "hello.rb", <<~RUBY
-						class Hello < Phlex::HTML
-							def template
-								h1 { "👋 Hello World!" }
-							end
-						end
-					RUBY
-
-					e.execute "Hello.new.call"
-				end
-
-				render Markdown.new(<<~MD)
-					The `template` method determines what your view will output when its rendered. The above example will output an `<h1>` tag with the content `👋 Hello world!`. Click on the "Output" tab above to see for yourself.
-
-					## Accepting arguments
-
-					You can define an initializer for your views just like any other Ruby class. Let's make our `Hello` view take a `name` as a keyword argument, save it in an instance variable and render that variable in the template.
-
-					We'll render this view with the arguments `name: "Joel"` and see what it produces.
-				MD
-
-				render Example.new do |e|
-					e.tab "hello.rb", <<~RUBY
-						class Hello < Phlex::HTML
-							def initialize(name:)
-								@name = name
-							end
-
-							def template
-								h1 { "👋 Hello \#{@name}!" }
-							end
-						end
-					RUBY
-
-					e.execute "Hello.new(name: 'Joel').call"
-				end
-
-				render Markdown.new(<<~MD)
-					## Rendering views
-
-					Views can render other views in their templates using the `render` method. Let's try rendering a couple of instances of this `Hello` view from a new `Example` view and look at the output of the `Example` view.
-				MD
-
-				render Example.new do |e|
-					e.tab "example.rb", <<~RUBY
-						class Example < Phlex::HTML
-							def template
-								render Hello.new(name: "Joel")
-								render Hello.new(name: "Alexandre")
-							end
-						end
-					RUBY
-
-					e.tab "hello.rb", <<~RUBY
-						class Hello < Phlex::HTML
-							def initialize(name:)
-								@name = name
-							end
-
-							def template
-								h1 { "👋 Hello \#{@name}!" }
-							end
-						end
-					RUBY
-
-					e.execute "Example.new.call"
-				end
-
-				render Markdown.new(<<~MD)
-					## Passing content blocks
-
-					Views can also yield content blocks, which can be passed in when rendering. Let's make a `Card` component that yields content in an `<article>` element with a `drop-shadow` class on it.
-				MD
-
-				render Example.new do |e|
-					e.tab "card.rb", <<~RUBY
-						class Card < Phlex::HTML
-							def template(&content)
-								article(class: "drop-shadow") do
-									yield_content(&content)
-								end
-							end
-						end
-					RUBY
-
-					e.tab "example.rb", <<~RUBY
-						class Example < Phlex::HTML
-							def template
-								render Card.new do
-									h1 { "👋 Hello!" }
-								end
-							end
-						end
-					RUBY
-
-					e.execute "Example.new.call"
-				end
-
-				render Markdown.new(<<~MD)
-					The template in the `Card` view accepts a block argument `&content` and uses the `yield_content` method to yield it in an `<article>` element.
-
-					The `Example` view renders a `Card` and passes it a block with an `<h1>` element.
-
-					Looking at the output of the `Example` view, we can see the `<h1>` element was rendered inside the `<article>` element from the `Card` view.
-
-					## Delegating content blocks
-
-					Since the block of content was the only thing we need in the `<article>` element, we could have just passed the content block to the element instead.
-
-					```ruby
-					class Card < Phlex::HTML
-						def template(&content)
-							article(class: "drop-shadow", &content)
-						end
-					end
-					```
-				MD
-
-				render Markdown.new(<<~MD)
-					## Registering custom elements
-
-					You can register custom elements with the `register_element` macro. The custom element will only be available in the view where it is registered and subclasses of that view.
-				MD
-
-				render Example.new do |e|
-					e.tab "example.rb", <<~RUBY
-						class Example < Phlex::HTML
-							register_element :trix_editor
-
-							def template
-								trix_editor input: "content", autofocus: true
-							end
-						end
-					RUBY
-
-					e.execute "Example.new.call"
-				end
-
-				render Markdown.new(<<~MD)
-					## Callbacks
-
-					Prepend the `Phlex::HTML::Callbacks` module, and if you define `#before_rendering_template` and/or `#after_rendering_template` method in your view, they will be called immediately before and after your template is rendered.
-				MD
-
-				render Example.new do |e|
-					e.tab "example.rb", <<~RUBY
-						class Example < Phlex::HTML
-							prepend Phlex::HTML::Callbacks
-
-							def before_rendering_template
-								h1 { "Hello" }
-							end
-
-							def template
-								h2 { "World" }
-							end
-
-							def after_rendering_template
-								h3 { "Bye" }
-							end
-						end
-					RUBY
-
-					e.execute "Example.new.call"
-				end
-			end
-		end
-	end
-end

data/fixtures/compiler_test_helpers.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module CompilerTestHelpers
-	# @return Array
-	def compile(view)
-		@compiler = Phlex::Compiler.new(view)
-		output = []
-
-		mock(@compiler) do |m|
-			m.before(:redefine) { output << _1 }
-		end
-
-		@compiler.call
-
-		output.map! do |method|
-			Phlex::Compiler::Formatter.format("", SyntaxTree.parse(method))
-		end
-	end
-end

data/fixtures/content.rb

@@ -1,60 +0,0 @@
-# frozen_string_literal: true
-
-module Fixtures
-	module Content
-		class BareString < Phlex::HTML
-			def template
-				h1 { "Hello" }
-			end
-		end
-
-		class Symbol < Phlex::HTML
-			def template
-				h1 { :hello }
-			end
-		end
-
-		class Float < Phlex::HTML
-			def template
-				h1 { 1.2 }
-			end
-		end
-
-		class Integer < Phlex::HTML
-			def template
-				h1 { 1 }
-			end
-		end
-
-		class Variable < Phlex::HTML
-			def template
-				greeting = "Hello"
-				h1 { greeting }
-			end
-		end
-
-		class InstanceVariable < Phlex::HTML
-			def template
-				h1 { @hello }
-			end
-		end
-
-		class NestedTags < Phlex::HTML
-			def template
-				article {
-					h1 { "Inside" }
-				}
-			end
-		end
-
-		class NonMutatingNestedContent < Phlex::HTML
-			def template
-				div { say_hello }
-			end
-
-			def say_hello
-				"Hello"
-			end
-		end
-	end
-end

data/fixtures/dummy/app/components/comment_component.html.erb

@@ -1,14 +0,0 @@
-<div>
-  <span>
-    <%= @name %>
-  </span>
-  <span>
-    <%= @body %>
-  </span>
-
-  <%= content %>
-
-  <%= render Views::Comments::Reaction.new(emoji: 'hamburger') do |reaction| %>
-    <p>Emoji reaction for a comment from <%= @name %> with body <%= @body %></p>
-  <% end %>
-</div>

data/fixtures/dummy/app/components/comment_component.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-class CommentComponent < ViewComponent::Base
-	def initialize(name:, body:)
-		@name = name
-		@body = body
-	end
-end

data/fixtures/dummy/app/components/reaction_component.html.erb

@@ -1,3 +0,0 @@
-<p><%= @emoji %></p>
-
-<%= content %>

data/fixtures/dummy/app/components/reaction_component.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-class ReactionComponent < ViewComponent::Base
-	def initialize(emoji:)
-		@emoji = emoji
-	end
-end

data/fixtures/dummy/app/controllers/articles_controller.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-class ArticlesController < ActionController::Base
-end

data/fixtures/dummy/app/controllers/comments_controller.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-class CommentsController < ActionController::Base
-end

data/fixtures/dummy/app/views/application_view.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-module Views
-	class ApplicationView < Phlex::HTML
-		include Rails.application.routes.url_helpers
-		include Phlex::Translation
-	end
-end

data/fixtures/dummy/app/views/articles/form.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Views
-	module Articles
-		class Form < ApplicationView
-			include Phlex::Rails::Helpers::FormWith
-
-			def template
-				form_with url: "test" do |f|
-					f.text_field :name
-				end
-			end
-		end
-	end
-end

data/fixtures/dummy/app/views/articles/index.html.erb

@@ -1,14 +0,0 @@
-<p>Before</p>
-
-<%= render(Views::Heading.new) { "Hello World!" } %>
-
-<%= render Views::Card.new do |a| %>
-  <p>Start Card A</p>
-  <%= a.title "Hello from A" %>
-  <%= render Views::Card.new do |b| %>
-    <p>Start Card B</p>
-    <%= b.title "Hello from B" %>
-    <p>End Card B</p>
-  <% end %>
-  <p>End Card A</p>
-<% end %>

data/fixtures/dummy/app/views/articles/new.html.erb

@@ -1 +0,0 @@
-<%= render Views::Articles::Form.new %>

data/fixtures/dummy/app/views/card.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Views
-	class Card < ApplicationView
-		def template(&block)
-			article class: "drop-shadow p-5 rounded", &block
-		end
-
-		def title(text)
-			h3 class: "font-bold" do
-				text
-			end
-		end
-	end
-end

data/fixtures/dummy/app/views/comments/comment.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module Views
-	module Comments
-		class Comment < ApplicationView
-			def initialize(name:, body:)
-				@name = name
-				@body = body
-			end
-
-			def template(&block)
-				div {
-					span { @name }
-					span { @body }
-
-					yield_content(&block)
-
-					render(::ReactionComponent.new(emoji: "hamburger")) do
-						p { "Emoji reaction for a comment from #{@name} with body #{@body}" }
-					end
-				}
-			end
-		end
-	end
-end

data/fixtures/dummy/app/views/comments/index.html.erb

@@ -1,3 +0,0 @@
-<%= render(CommentComponent.new(name: "Matz", body: "hey, folks")) do %>
-  Hello, World from a ViewComponent!
-<% end %>

data/fixtures/dummy/app/views/comments/reaction.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module Views
-	module Comments
-		class Reaction < ApplicationView
-			def initialize(emoji:)
-				@emoji = emoji
-			end
-
-			def template(&block)
-				p { @emoji }
-
-				yield_content(&block)
-			end
-		end
-	end
-end

data/fixtures/dummy/app/views/comments/show.html.erb

@@ -1,3 +0,0 @@
-<%= render Views::Comments::Comment.new(name: "_why", body: "I'm back") do %>
-  Hello, World from a Phlex Component!
-<% end %>

data/fixtures/dummy/app/views/heading.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-module Views
-	class Heading < ApplicationView
-		def template(&block)
-			h1(&block)
-		end
-	end
-end

data/fixtures/dummy/config/database.yml

@@ -1,3 +0,0 @@
-test:
-  adapter:  sqlite3
-  database: db/combustion_test.sqlite

data/fixtures/dummy/config/routes.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-Rails.application.routes.draw do
-	# Rails routes here
-end

data/fixtures/dummy/config/storage.yml

@@ -1,3 +0,0 @@
-test:
-  service: Disk
-  root: /Users/joeldrapper/src/joeldrapper/phlex/tmp/storage

data/fixtures/dummy/db/schema.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-ActiveRecord::Schema.define do
-	# Set up any tables you need to exist for your test suite that don't belong
-	# in migrations.
-end

data/fixtures/dummy/log/.gitignore

@@ -1 +0,0 @@
-*.log

data/fixtures/rails_helper.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-require "phlex/rails"
-
-Bundler.require :rails
-
-Combustion.path = "fixtures/dummy"
-
-Combustion.initialize! :action_controller do
-	config.autoload_paths << "#{root}/app"
-end

data/fixtures/standard_element.rb

@@ -1,87 +0,0 @@
-# frozen_string_literal: true
-
-module Fixtures
-	module StandardElement
-		class WithParens < Phlex::HTML
-			def template
-				h1()
-			end
-		end
-
-		class WithoutParens < Phlex::HTML
-			def template
-				h1
-			end
-		end
-
-		module WithAttributes
-			class WithParens < Phlex::HTML
-				def template
-					h1(class: "font-bold")
-				end
-			end
-
-			class WithoutParens < Phlex::HTML
-				def template
-					h1 class: "font-bold"
-				end
-			end
-		end
-
-		module WithBraceBlock
-			class WithParens < Phlex::HTML
-				def template
-					h1() { "Hi" }
-				end
-			end
-
-			class WithoutParens < Phlex::HTML
-				def template
-					h1 { "Hi" }
-				end
-			end
-
-			class WithAttributes < Phlex::HTML
-				def template
-					h1(class: "font-bold") { "Hi" }
-				end
-			end
-		end
-
-		module WithDoBlock
-			class WithParens < Phlex::HTML
-				def template
-					h1() do
-						"Hi"
-					end
-				end
-			end
-
-			class WithoutParens < Phlex::HTML
-				def template
-					h1 do
-						"Hi"
-					end
-				end
-			end
-
-			module WithAttributes
-				class WithParens < Phlex::HTML
-					def template
-						h1(class: "font-bold") do
-							"Hi"
-						end
-					end
-				end
-
-				class WithoutParens < Phlex::HTML
-					def template
-						h1 class: "font-bold" do
-							"Hi"
-						end
-					end
-				end
-			end
-		end
-	end
-end

data/fixtures/void_element.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module Fixtures
-	module VoidElement
-		class WithParens < Phlex::HTML
-			def template
-				img()
-			end
-		end
-
-		class WithoutParens < Phlex::HTML
-			def template
-				img
-			end
-		end
-
-		module WithAttributes
-			class WithParens < Phlex::HTML
-				def template
-					img(class: "a b c")
-				end
-			end
-
-			class WithoutParens < Phlex::HTML
-				def template
-					img class: "a b c"
-				end
-			end
-		end
-	end
-end