phlex 0.3.2 → 0.5.0

data/lib/phlex/rails/helpers.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+module Phlex
+	module Rails
+		module Helpers
+			module CSPMetaTag
+				def csp_meta_tag(**options)
+					if (output = @_view_context.csp_meta_tag(**options))
+						@_target << output
+					end
+				end
+			end
+
+			module CSRFMetaTags
+				def csrf_meta_tags
+					if (output = @_view_context.csrf_meta_tags)
+						@_target << output
+					end
+				end
+			end
+
+			module ActionCableMetaTag
+				def action_cable_meta_tag
+					if (output = @_view_context.action_cable_meta_tag)
+						@_target << output
+					end
+				end
+			end
+
+			module FormWith
+				class BufferedFormWith < Phlex::Buffered
+					alias_method :check_box, :__output_method__
+					alias_method :collection_check_boxes, :__output_method__
+					alias_method :collection_radio_buttons, :__output_method__
+					alias_method :collection_select, :__output_method__
+					alias_method :color_field, :__output_method__
+					alias_method :date_field, :__output_method__
+					alias_method :date_select, :__output_method__
+					alias_method :datetime_field, :__output_method__
+					alias_method :datetime_local_field, :__output_method__
+					alias_method :datetime_select, :__output_method__
+					alias_method :email_field, :__output_method__
+					alias_method :file_field, :__output_method__
+					alias_method :grouped_collection_select, :__output_method__
+					alias_method :hidden_field, :__output_method__
+					alias_method :label, :__output_method__
+					alias_method :month_field, :__output_method__
+					alias_method :number_field, :__output_method__
+					alias_method :password_field, :__output_method__
+					alias_method :phone_field, :__output_method__
+					alias_method :radio_button, :__output_method__
+					alias_method :range_field, :__output_method__
+					alias_method :search_field, :__output_method__
+					alias_method :select, :__output_method__
+					alias_method :submit, :__output_method__
+					alias_method :telephone_field, :__output_method__
+					alias_method :text_area, :__output_method__
+					alias_method :text_field, :__output_method__
+					alias_method :time_field, :__output_method__
+					alias_method :time_select, :__output_method__
+					alias_method :time_zone_select, :__output_method__
+					alias_method :url_field, :__output_method__
+					alias_method :week_field, :__output_method__
+					alias_method :weekday_select, :__output_method__
+					alias_method :button, :__output_method__
+				end
+
+				def form_with(*args, **kwargs, &block)
+					@_target << @_view_context.form_with(*args, **kwargs) { |form|
+						capture do
+							yield(
+								BufferedFormWith.new(form, buffer: @_target)
+							)
+						end
+					}
+				end
+			end
+
+			module StylesheetLinkTag
+				def stylesheet_link_tag(*sources)
+					if (output = @_view_context.stylesheet_link_tag(*sources))
+						@_target << output
+					end
+				end
+			end
+
+			module FaviconLinkTag
+				def favicon_link_tag(*args)
+					if (output = @_view_context.favicon_link_tag(*args))
+						@_target << output
+					end
+				end
+			end
+
+			module PreloadLinkTag
+				def preload_link_tag(*args)
+					if (output = @_view_context.preload_link_tag(*args))
+						@_target << output
+					end
+				end
+			end
+
+			module JavaScriptIncludeTag
+				def javascript_include_tag(*sources)
+					if (output = @_view_context.javascript_include_tag(*sources))
+						@_target << output
+					end
+				end
+			end
+
+			module ContentFor
+				def content_for(slot, &block)
+					@_view_context.content_for(slot, capture(&block))
+				end
+			end
+		end
+	end
+end

data/lib/phlex/rails/layout.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Phlex
+	module Rails
+		module Layout
+			include Helpers::CSPMetaTag
+			include Helpers::CSRFMetaTags
+			include Helpers::FaviconLinkTag
+			include Helpers::PreloadLinkTag
+			include Helpers::StylesheetLinkTag
+			include Helpers::ActionCableMetaTag
+			include Helpers::JavaScriptIncludeTag
+		end
+	end
+end

data/lib/phlex/rails.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "phlex"
+
+module Phlex::Rails
+	Loader = Zeitwerk::Loader.new.tap do |loader|
+		loader.push_dir("#{__dir__}/rails", namespace: Phlex::Rails)
+		loader.setup
+	end
+end

data/lib/phlex/renderable.rb

@@ -3,13 +3,13 @@
 module Phlex
 	module Renderable
 		def render(renderable, *args, **kwargs, &block)
-			if renderable.is_a?(View)
+			if renderable.is_a?(HTML)
 				if block_given? && !block.binding.receiver.is_a?(Phlex::Block)
 					block = Phlex::Block.new(self, &block)
 				end
 
 				renderable.call(@_target, view_context: @_view_context, parent: self, &block)
-			elsif renderable.is_a?(Class) && renderable < View
+			elsif renderable.is_a?(Class) && renderable < Phlex::HTML
 				raise ArgumentError, "You tried to render the Phlex view class: #{renderable.name} but you probably meant to render an instance of that class instead."
 			else
 				@_target << @_view_context.render(renderable, *args, **kwargs, &block)
@@ -26,7 +26,13 @@ module Phlex
 						output = yield(*args, **kwargs)
 						unchanged = (original_length == @_target.length)
 
-						text(output) if unchanged && output.is_a?(String)
+						if unchanged
+							if defined?(ActiveSupport::SafeBuffer) && output.is_a?(ActiveSupport::SafeBuffer)
+								unsafe_raw(output)
+							else
+								text(output)
+							end
+						end
 					end
 				end.html_safe
 			else

data/lib/phlex/table.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Phlex
+	module Table
+		include Collection
+
+		module ClassMethods
+			attr_accessor :header
+
+			def property(header = nil, **attributes, &body)
+				if header.is_a?(String)
+					header_text = header
+					header = -> { head_header(scope: "col") { header_text } }
+				end
+
+				properties << {
+					header: header,
+					body: body,
+					attributes: attributes,
+				}
+			end
+
+			def properties
+				@properties ||= []
+			end
+		end
+
+		def self.included(child)
+			child.extend ClassMethods
+
+			child.alias_method :head, :thead
+			child.alias_method :body, :tbody
+			child.alias_method :foot, :tfoot
+
+			child.alias_method :row, :tr
+
+			child.alias_method :header, :th
+			child.alias_method :cell, :td
+
+			child.alias_method :head_row, :row
+			child.alias_method :body_row, :row
+			child.alias_method :foot_row, :row
+
+			child.alias_method :head_header, :header
+			child.alias_method :foot_header, :header
+
+			child.alias_method :head_cell, :cell
+			child.alias_method :body_cell, :cell
+			child.alias_method :foot_cell, :cell
+		end
+
+		private
+
+		def properties
+			self.class.properties
+		end
+
+		def collection_template(&block)
+			table do
+				head_template
+				body_template(&block)
+				foot_template
+			end
+		end
+
+		def item_template
+			row_template
+		end
+
+		def head_template
+			if self.class.properties.any? { |p| p[:header] }
+				head do
+					head_row do
+						self.class.properties.each do |property|
+							case property[:header]
+							when Proc
+								instance_exec(&property[:header])
+							when Symbol
+								send(property[:header])
+							end
+						end
+					end
+				end
+			end
+		end
+
+		def body_template
+			body { yield_items }
+		end
+
+		def foot_template
+		end
+
+		def row_template
+			body_row do
+				self.class.properties.each do |property|
+					body_cell(**property[:attributes]) do
+						instance_exec(@item, &property[:body])
+					end
+				end
+			end
+		end
+	end
+end

data/lib/phlex/testing/capybara.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "capybara"
+require_relative "view_helper"
+
+module Phlex::Testing
+	module Capybara
+		module ViewHelper
+			include Phlex::Testing::ViewHelper
+
+			def self.included(klass)
+				if defined?(Minitest::Test) && klass < Minitest::Test
+					require "capybara/minitest"
+					include ::Capybara::Minitest::Assertions
+				end
+			end
+
+			attr_accessor :page
+
+			def render(view, &block)
+				@page = ::Capybara::Node::Simple.new(super)
+			end
+		end
+	end
+end

data/lib/phlex/testing/nokogiri.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "nokogiri"
+require_relative "view_helper"
+
+module Phlex::Testing
+	module Nokogiri
+		module DocumentHelper
+			include Phlex::Testing::ViewHelper
+
+			def render(view, &block)
+				::Nokogiri::HTML5(super)
+			end
+		end
+
+		module FragmentHelper
+			include Phlex::Testing::ViewHelper
+
+			def render(view, &block)
+				::Nokogiri::HTML5.fragment(super)
+			end
+		end
+	end
+end

data/lib/phlex/testing/rails.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative "view_helper"
+
+module Phlex::Testing
+	module Rails
+		module ViewHelper
+			include Phlex::Testing::ViewHelper
+
+			def view_context
+				controller.view_context
+			end
+
+			def controller
+				@controller ||= ActionView::TestCase::TestController.new
+			end
+		end
+	end
+end

data/lib/phlex/testing/view_helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Phlex
+	module Testing
+		module ViewHelper
+			def render(view, &block)
+				view.call(view_context: view_context, &block)
+			end
+
+			def view_context
+				nil
+			end
+		end
+	end
+end

data/lib/phlex/translation.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Phlex
+	module Translation
+		def self.included(view)
+			view.extend(ClassMethods)
+		end
+
+		module ClassMethods
+			attr_writer :translation_path
+
+			def translation_path
+				@translation_path ||= name&.split("::")&.join(".")&.downcase.to_s
+			end
+		end
+
+		def translate(key, **options)
+			key = "#{self.class.translation_path}#{key}" if key.start_with?(".")
+
+			::I18n.translate(key, **options)
+		end
+	end
+end

data/lib/phlex/turbo/frame.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Phlex
+	module Turbo
+		class Frame < Phlex::HTML
+			register_element :turbo_frame
+
+			def initialize(src:, loading:, disabled:, target:, autoscroll:)
+				@src = src
+				@loading = loading
+				@disabled = disabled
+				@target = target
+				@autoscroll = autoscroll
+			end
+
+			def template(&content)
+				turbo_frame(src: @src, loading: @loading, disabled: @disabled, target: @target, autoscroll: @autoscroll, &content)
+			end
+		end
+	end
+end

data/lib/phlex/turbo/stream.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Phlex
+	module Turbo
+		class Stream < Phlex::HTML
+			register_element :turbo_stream
+
+			def initialize(action:, target:)
+				@action = action
+				@target = target
+			end
+
+			def template(&content)
+				turbo_stream(action: @action, target: @target, &content)
+			end
+		end
+	end
+end

data/lib/phlex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Phlex
-	VERSION = "0.3.2"
+	VERSION = "0.5.0"
 end

data/lib/phlex.rb

@@ -1,34 +1,39 @@
 # frozen_string_literal: true
 
-require "cgi"
+require "hescape"
 require "zeitwerk"
 require "syntax_tree"
 
-loader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
-loader.ignore("#{__dir__}/generators")
-loader.ignore("#{__dir__}/install")
-loader.inflector.inflect("html" => "HTML")
-loader.inflector.inflect("vcall" => "VCall")
-loader.inflector.inflect("fcall" => "FCall")
-loader.setup
-
 module Phlex
+	Loader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false).tap do |loader|
+		loader.ignore("#{__dir__}/generators")
+		loader.ignore("#{__dir__}/install")
+
+		loader.ignore("#{__dir__}/phlex/testing")
+
+		loader.ignore("#{__dir__}/phlex/rails.rb")
+		loader.ignore("#{__dir__}/phlex/rails")
+
+		loader.inflector.inflect("html" => "HTML")
+		loader.inflector.inflect("vcall" => "VCall")
+		loader.inflector.inflect("fcall" => "FCall")
+		loader.setup
+	end
+
 	Error = Module.new
 	ArgumentError = Class.new(ArgumentError) { include Error }
 	NameError = Class.new(NameError) { include Error }
 
+	def self.const_missing(name)
+		if name == :View
+			raise NameError, "👋 Phlex::View has been renamed (again 🙄) to Phlex::HTML."
+		end
+	end
+
 	extend self
 
 	ATTRIBUTE_CACHE = {}
 
-	def const_missing(name)
-		if name == :Component
-			raise NameError, "👋 Phlex::Component is now Phlex::View"
-		else
-			super
-		end
-	end
-
 	def configuration
 		@configuration ||= Configuration.new
 	end
@@ -37,10 +42,3 @@ module Phlex
 		yield configuration
 	end
 end
-
-begin
-	require "rails"
-	require "phlex/engine"
-rescue LoadError
-	# Rails isn't in this env, don't load the engine.
-end