phlex 0.5.3 → 1.0.0.rc2

metadata

@@ -1,43 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: phlex
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 1.0.0.rc2
 platform: ruby
 authors:
 - Joel Drapper
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-11-16 00:00:00.000000000 Z
+date: 2022-11-27 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: hescape
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: syntax_tree
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.6'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.6'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -52,20 +24,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
-- !ruby/object:Gem::Dependency
-  name: view_component
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.7'
 description: A high-performance view framework optimised for developer happiness.
 email:
 - joel@drapper.me
@@ -79,148 +37,30 @@ files:
 - CONTRIBUTING.md
 - Gemfile
 - LICENSE.txt
-- Procfile.dev
 - README.md
-- Rakefile
 - SECURITY.md
 - bench.rb
-- config.ru
 - config/sus.rb
-- docs/assets/application.css
-- docs/assets/logo.png
-- docs/build.rb
-- docs/components/callout.rb
-- docs/components/code_block.rb
-- docs/components/code_span.rb
-- docs/components/example.rb
-- docs/components/heading.rb
-- docs/components/layout.rb
-- docs/components/markdown.rb
-- docs/components/nav.rb
-- docs/components/nav/item.rb
-- docs/components/tabs.rb
-- docs/components/tabs/tab.rb
-- docs/components/title.rb
-- docs/page_builder.rb
-- docs/pages/application_page.rb
-- docs/pages/helpers.rb
-- docs/pages/index.rb
-- docs/pages/library/collections.rb
-- docs/pages/rails/getting_started.rb
-- docs/pages/rails/helpers.rb
-- docs/pages/rails/layouts.rb
-- docs/pages/rails/migrating.rb
-- docs/pages/rails/rendering_views.rb
-- docs/pages/rails_integration.rb
-- docs/pages/templates.rb
-- docs/pages/testing/capybara.rb
-- docs/pages/testing/getting_started.rb
-- docs/pages/testing/nokogiri.rb
-- docs/pages/testing/rails.rb
-- docs/pages/translations.rb
-- docs/pages/views.rb
-- fixtures/compiler_test_helpers.rb
-- fixtures/content.rb
-- fixtures/dummy/app/assets/config/manifest.js
-- fixtures/dummy/app/components/comment_component.html.erb
-- fixtures/dummy/app/components/comment_component.rb
-- fixtures/dummy/app/components/reaction_component.html.erb
-- fixtures/dummy/app/components/reaction_component.rb
-- fixtures/dummy/app/controllers/articles_controller.rb
-- fixtures/dummy/app/controllers/comments_controller.rb
-- fixtures/dummy/app/views/application_view.rb
-- fixtures/dummy/app/views/articles/form.rb
-- fixtures/dummy/app/views/articles/index.html.erb
-- fixtures/dummy/app/views/articles/new.html.erb
-- fixtures/dummy/app/views/card.rb
-- fixtures/dummy/app/views/comments/comment.rb
-- fixtures/dummy/app/views/comments/index.html.erb
-- fixtures/dummy/app/views/comments/reaction.rb
-- fixtures/dummy/app/views/comments/show.html.erb
-- fixtures/dummy/app/views/heading.rb
-- fixtures/dummy/config/database.yml
-- fixtures/dummy/config/routes.rb
-- fixtures/dummy/config/storage.yml
-- fixtures/dummy/db/schema.rb
-- fixtures/dummy/log/.gitignore
-- fixtures/dummy/public/favicon.ico
 - fixtures/layout.rb
 - fixtures/page.rb
-- fixtures/rails_helper.rb
-- fixtures/standard_element.rb
 - fixtures/view_helper.rb
-- fixtures/void_element.rb
-- lib/generators/phlex/collection/USAGE
-- lib/generators/phlex/collection/collection_generator.rb
-- lib/generators/phlex/collection/templates/collection.rb.erb
-- lib/generators/phlex/controller/USAGE
-- lib/generators/phlex/controller/controller_generator.rb
-- lib/generators/phlex/controller/templates/controller.rb.erb
-- lib/generators/phlex/controller/templates/view.rb.erb
-- lib/generators/phlex/layout/USAGE
-- lib/generators/phlex/layout/layout_generator.rb
-- lib/generators/phlex/layout/templates/layout.rb.erb
-- lib/generators/phlex/page/USAGE
-- lib/generators/phlex/page/page_generator.rb
-- lib/generators/phlex/page/templates/page.rb.erb
-- lib/generators/phlex/table/USAGE
-- lib/generators/phlex/table/table_generator.rb
-- lib/generators/phlex/table/templates/table.rb.erb
-- lib/generators/phlex/view/USAGE
-- lib/generators/phlex/view/templates/view.rb.erb
-- lib/generators/phlex/view/view_generator.rb
-- lib/install/phlex.rb
 - lib/overrides/symbol/name.rb
 - lib/phlex.rb
-- lib/phlex/block.rb
 - lib/phlex/buffered.rb
 - lib/phlex/callable.rb
 - lib/phlex/collection.rb
-- lib/phlex/compiler.rb
-- lib/phlex/compiler/elements.rb
-- lib/phlex/compiler/formatter.rb
-- lib/phlex/compiler/generators/content.rb
-- lib/phlex/compiler/generators/element.rb
-- lib/phlex/compiler/nodes/base.rb
-- lib/phlex/compiler/nodes/call.rb
-- lib/phlex/compiler/nodes/command.rb
-- lib/phlex/compiler/nodes/fcall.rb
-- lib/phlex/compiler/nodes/method_add_block.rb
-- lib/phlex/compiler/nodes/vcall.rb
-- lib/phlex/compiler/optimizer.rb
-- lib/phlex/compiler/visitors/base.rb
-- lib/phlex/compiler/visitors/file.rb
-- lib/phlex/compiler/visitors/stable_scope.rb
-- lib/phlex/compiler/visitors/statements.rb
-- lib/phlex/compiler/visitors/view.rb
-- lib/phlex/compiler/visitors/view_method.rb
 - lib/phlex/configuration.rb
 - lib/phlex/elements.rb
+- lib/phlex/experimental.rb
 - lib/phlex/helpers.rb
 - lib/phlex/html.rb
-- lib/phlex/html/callbacks.rb
-- lib/phlex/markdown.rb
-- lib/phlex/rails.rb
-- lib/phlex/rails/engine.rb
-- lib/phlex/rails/form.rb
-- lib/phlex/rails/helpers.rb
-- lib/phlex/rails/layout.rb
-- lib/phlex/renderable.rb
 - lib/phlex/table.rb
-- lib/phlex/testing/capybara.rb
-- lib/phlex/testing/nokogiri.rb
-- lib/phlex/testing/rails.rb
 - lib/phlex/testing/view_helper.rb
-- lib/phlex/translation.rb
 - lib/phlex/turbo/frame.rb
 - lib/phlex/turbo/stream.rb
 - lib/phlex/version.rb
-- lib/tasks/phlex_tasks.rake
-- package-lock.json
-- package.json
 - phlex_logo.png
 - sig/phlex.rbs
-- tailwind.config.js
 homepage: https://www.phlex.fun
 licenses:
 - MIT
@@ -241,12 +81,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.3.25
 signing_key:
 specification_version: 4
-summary: A framework for building views with a Ruby DSL.
+summary: A framework for building views in Ruby.
 test_files: []

data/Procfile.dev

@@ -1,3 +0,0 @@
-server: ruby -run -e httpd docs/dist
-docs: bundle exec docs/build.rb --watch
-tailwind: npx tailwindcss -i ./docs/assets/application.css -o ./docs/dist/application.css --watch

data/Rakefile

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-
-task :sus do
-	sh "bundle exec sus"
-end
-task default: :sus

data/config.ru

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require "rubygems"
-require "bundler"
-
-Bundler.require :default, :development
-
-Combustion.initialize! :all
-run Combustion::Application

data/docs/assets/application.css

@@ -1,32 +0,0 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-pre { tab-size: 2; }
-
-.tabs input[type="radio"]:checked + label {
-  background: #f8f8f8;
-  z-index: 1;
-  margin-bottom: -1px;
-  padding-bottom: 1px;
-}
-
-.tabs input[type="radio"]:focus + label {
-  --tw-ring-offset-shadow: var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);
-  --tw-ring-shadow: var(--tw-ring-inset) 0 0 0 calc(3px + var(--tw-ring-offset-width)) var(--tw-ring-color);
-  box-shadow: var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow, 0 0 #0000);
-}
-
-.tabs input[type="radio"]:checked + label + .tab {
-  display: block;
-}
-
-p {
-  @apply my-5
-}
-
-.prose ol, .prose ul {
-  list-style: revert;
-  margin: 0 0 0 1rem;
-  padding: 0 0 0 1rem;
-}

data/docs/build.rb

@@ -1,30 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-$stdout.sync = true
-
-require "phlex"
-require "phlex/markdown"
-require "bundler"
-require "fileutils"
-require "i18n"
-
-Bundler.require :docs
-
-loader = Zeitwerk::Loader.new
-loader.push_dir(__dir__)
-loader.ignore(__FILE__)
-loader.inflector.inflect("rspec" => "RSpec")
-loader.enable_reloading
-loader.setup
-loader.eager_load
-
-PageBuilder.build_all
-
-if ARGV.include? "--watch"
-	Filewatcher.new("#{__dir__}/**/*rb").watch do |_changes|
-		loader.reload
-		loader.eager_load
-		PageBuilder.build_all
-	end
-end

data/docs/components/callout.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Callout < Phlex::HTML
-		def template(&block)
-			div(class: "rounded bg-orange-50 text-sm p-5 border border-orange-100", &block)
-		end
-	end
-end

data/docs/components/code_block.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class CodeBlock < Phlex::HTML
-		FORMATTER = Rouge::Formatters::HTML.new
-
-		def initialize(code, syntax:)
-			@code = code
-			@syntax = syntax
-		end
-
-		def template
-			pre(class: "highlight p-5 whitespace-pre-wrap bg-stone-50") {
-				unsafe_raw FORMATTER.format(
-					lexer.lex(@code)
-				)
-			}
-		end
-
-		private
-
-		def lexer
-			Rouge::Lexer.find(@syntax)
-		end
-	end
-end

data/docs/components/code_span.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class CodeSpan < Phlex::HTML
-		def template(&block)
-			code(class: "bg-stone-50 inline-block font-medium rounded border px-1 -mt-1", &block)
-		end
-	end
-end

data/docs/components/example.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Example < Phlex::HTML
-		def initialize
-			@sandbox = Module.new
-		end
-
-		def template(&block)
-			render Tabs.new do |t|
-				@t = t
-				yield self
-			end
-		end
-
-		def tab(name, code, syntax: :ruby)
-			@t.tab(name) do
-				render CodeBlock.new(code, syntax: syntax)
-			end
-
-			@sandbox.class_eval(code) if syntax == :ruby
-		end
-
-		def execute(code)
-			output = @sandbox.class_eval(code)
-
-			@t.tab("👀 Output") do
-				render CodeBlock.new(HtmlBeautifier.beautify(output), syntax: :html)
-			end
-		end
-	end
-end

data/docs/components/heading.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Heading < Phlex::HTML
-		def template(&block)
-			h2(class: "text-2xl font-semibold mt-10 mb-5", &block)
-		end
-	end
-end

data/docs/components/layout.rb

@@ -1,91 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Layout < Phlex::HTML
-		register_element :style
-
-		def initialize(title:)
-			@title = title
-		end
-
-		def template(&block)
-			doctype
-
-			html do
-				head do
-					meta charset: "utf-8"
-					meta name: "viewport", content: "width=device-width, initial-scale=1"
-					title { @title }
-					link href: "/application.css", rel: "stylesheet"
-					style { unsafe_raw Rouge::Theme.find("github").render(scope: ".highlight") }
-				end
-
-				body class: "text-stone-700" do
-					div class: "flex flex-col" do
-						header class: "border-b py-4 px-4 lg:px-10 flex justify-between items-center sticky top-0 left-0 bg-white z-50" do
-							div class: "flex flex-row items-center gap-2" do
-								label for: "nav-toggle", class: "cursor-pointer lg:hidden" do
-									unsafe_raw '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" class="w-8 h-8"> <path fill-rule="evenodd" d="M3 6.75A.75.75 0 013.75 6h16.5a.75.75 0 010 1.5H3.75A.75.75 0 013 6.75zM3 12a.75.75 0 01.75-.75h16.5a.75.75 0 010 1.5H3.75A.75.75 0 013 12zm0 5.25a.75.75 0 01.75-.75h16.5a.75.75 0 010 1.5H3.75a.75.75 0 01-.75-.75z" clip-rule="evenodd" /> </svg>'
-								end
-
-								a(href: "/", class: "block") { img src: "/assets/logo.png", width: "100" }
-							end
-
-							nav(class: "text-stone-500 font-medium") do
-								ul(class: "flex space-x-8") do
-									li { a(href: "https://github.com/sponsors/joeldrapper") { "💖️ Sponsor" } }
-									li { a(href: "https://github.com/joeldrapper/phlex") { "GitHub" } }
-								end
-							end
-						end
-
-						div do
-							div class: "flex flex-row" do
-								input type: "checkbox", id: "nav-toggle", class: "flex-0 peer hidden"
-								label for: "nav-toggle", class: "top-0 bottom-0 left-0 right-0 bg-gray-900 opacity-0 transition-all peer-checked:fixed peer-checked:z-30 peer-checked:block peer-checked:opacity-50 lg:hidden lg:peer-checked:hidden"
-								nav class: "fixed lg:relative w-3/4 border-r-2 border-gray-100 lg:border-0 lg:w-1/4 text-lg lg:text-base h-full z-40 px-10 py-5 -left-full transition-all peer-checked:left-0 lg:left-0 bg-white" do
-									h2(class: "text-lg font-semibold pt-5") { "Guide" }
-
-									ul do
-										render Nav::Item.new("Introduction", to: Pages::Index, active_page: @_parent)
-										render Nav::Item.new("Views", to: Pages::Views, active_page: @_parent)
-										render Nav::Item.new("Templates", to: Pages::Templates, active_page: @_parent)
-										render Nav::Item.new("Helpers", to: Pages::Helpers, active_page: @_parent)
-										render Nav::Item.new("Translations", to: Pages::Translations, active_page: @_parent)
-									end
-
-									h2(class: "text-lg font-semibold pt-5") { "Testing" }
-
-									ul do
-										render Nav::Item.new("Getting Started", to: Pages::Testing::GettingStarted, active_page: @_parent)
-										render Nav::Item.new("Nokogiri", to: Pages::Testing::Nokogiri, active_page: @_parent)
-										render Nav::Item.new("Capybara", to: Pages::Testing::Capybara, active_page: @_parent)
-										render Nav::Item.new("Rails", to: Pages::Testing::Rails, active_page: @_parent)
-									end
-
-									h2(class: "text-lg font-semibold pt-5") { "Rails" }
-
-									ul do
-										render Nav::Item.new("Getting started", to: Pages::Rails::GettingStarted, active_page: @_parent)
-										render Nav::Item.new("Rendering views", to: Pages::Rails::RenderingViews, active_page: @_parent)
-										render Nav::Item.new("Layouts", to: Pages::Rails::Layouts, active_page: @_parent)
-										render Nav::Item.new("Helpers", to: Pages::Rails::Helpers, active_page: @_parent)
-										render Nav::Item.new("Migrating to Phlex", to: Pages::Rails::Migrating, active_page: @_parent)
-									end
-								end
-
-								main class: "w-full lg:w-3/4 px-6 lg:px-20 py-5 border-0 lg:border-l-2 border-gray-100" do
-									div(class: "max-w-full lg:max-w-prose prose", &block)
-								end
-							end
-
-							footer class: "border-t p-20 flex justify-center text-stone-500 text-lg font-medium" do
-								a(href: "https://github.com/sponsors/joeldrapper") { "Sponsor this project 💖" }
-							end
-						end
-					end
-				end
-			end
-		end
-	end
-end

data/docs/components/markdown.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Markdown < Phlex::Markdown
-		def code(&content)
-			render CodeSpan.new, &content
-		end
-
-		def code_block(code, language:)
-			render CodeBlock.new(code.gsub(/(?:^|\G) {4}/m, "	"), syntax: language)
-		end
-
-		def h1(&content)
-			render Title.new, &content
-		end
-
-		def h2(&content)
-			render Heading.new, &content
-		end
-
-		def a(**attributes, &content)
-			super(class: "font-bold text-red-600 underline underline-offset-4", **attributes, &content)
-		end
-	end
-end

data/docs/components/nav/item.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Nav::Item < Phlex::HTML
-		def initialize(text, to:, active_page:)
-			@text = text
-			@to = to
-			@active_page = active_page
-		end
-
-		def template
-			li do
-				a(**link_classes, href: "/#{link}") { @text }
-			end
-		end
-
-		def link_classes
-			classes("pb-1 block font-medium text-stone-500", active?: "text-red-600 font-bold")
-		end
-
-		def link
-			path == "index" ? "" : path
-		end
-
-		def path
-			@to.name.split("::")[1..].map { _1.gsub(/(.)([A-Z])/, '\1-\2') }.map(&:downcase).join("/")
-		end
-
-		def active?
-			@active_page.instance_of?(@to)
-		end
-	end
-end

data/docs/components/nav.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Nav < Phlex::HTML
-	end
-end

data/docs/components/tabs/tab.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Tabs
-		class Tab < Phlex::HTML
-			def initialize(name:, checked:)
-				@name = name
-				@checked = checked
-			end
-
-			def template(&block)
-				input class: "opacity-0 fixed peer", type: "radio", name: @_parent.unique_identifier, id: unique_identifier, checked: @checked
-
-				label id: "#{unique_identifier}-label", for: unique_identifier, role: "tab", aria_controls: "#{unique_identifier}-panel", class: "order-1 py-2 px-5 bg-white text-sm border border-b-0 border-l-0 font-medium first-of-type:border-l first-of-type:rounded-tl last-of-type:rounded-tr before:absolute before:pointer-events-none before:w-full before:ring before:h-full before:left-0 before:top-0 before:hidden before:rounded peer-focus:before:block cursor-pointer" do
-					@name
-				end
-
-				div id: "#{unique_identifier}-panel", role: "tabpanel", aria_labelledby: "#{unique_identifier}-label", class: "tab hidden order-2 w-full border rounded-b rounded-tr overflow-hidden" do
-					@_parent.instance_exec(&block)
-				end
-			end
-
-			def unique_identifier
-				@unique_identifier ||= SecureRandom.hex
-			end
-		end
-	end
-end

data/docs/components/tabs.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Tabs < Phlex::HTML
-		def initialize
-			@index = 1
-		end
-
-		def template(&block)
-			div class: "tabs flex flex-wrap relative my-5", role: "tablist" do
-				yield_content(&block)
-			end
-		end
-
-		def tab(name, &block)
-			render(Tab.new(name: name, checked: first?), &block)
-			@index += 1
-		end
-
-		def unique_identifier
-			@unique_identifier ||= SecureRandom.hex
-		end
-
-		private
-
-		def first?
-			@index == 1
-		end
-	end
-end

data/docs/components/title.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-	class Title < Phlex::HTML
-		def template(&block)
-			h1(class: "text-3xl font-semibold my-5", &block)
-		end
-	end
-end

data/docs/page_builder.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-class PageBuilder
-	ROOT = Pages::ApplicationPage
-
-	def self.build_all
-		FileUtils.mkdir_p("#{__dir__}/dist")
-		FileUtils.cp_r("#{__dir__}/assets", "#{__dir__}/dist")
-		ROOT.subclasses.each { |page| new(page).call }
-	end
-
-	def initialize(page)
-		@page = page
-	end
-
-	def call
-		puts "Building #{@page.name}"
-		FileUtils.mkdir_p(directory)
-		File.write(file, @page.new.call)
-	end
-
-	private
-
-	def file
-		"#{directory}/index.html"
-	end
-
-	def directory
-		if path == "index"
-			"#{__dir__}/dist"
-		else
-			"#{__dir__}/dist/#{path}"
-		end
-	end
-
-	def path
-		@page.name.split("::")[1..].map { _1.gsub(/(.)([A-Z])/, '\1-\2') }.map(&:downcase).join("/")
-	end
-end