essence 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a9516a2911b410deb58ca4b9ba2afbf083752314b0bb6df0018c81a4615f14d
-  data.tar.gz: 51074c18359021237cc4588b64a858aed0464746d5b9d0f0513319e722b73828
+  metadata.gz: 41a46dd9be7eb9ea84ba3ca4ad2f3a20333154644472673c347117bd6fb6b652
+  data.tar.gz: 3fd04819b2f327760571d3ec200a7300c45b7a4d7627b425e969a6999a051925
 SHA512:
-  metadata.gz: a94fccdf29ea63f7fd807b786f8bd477ac44feb623a19bae66814412d6c170536b15ec46f8f02266c5bf6afbc0db61f2c30e95f2b58e5a6dbb3288a807af18ac
-  data.tar.gz: 8e49f1011e3ddbecf3b37f3f5a0bd257b94061eab3053c8f06f616f3a60cd5f179688f9deacda83eb6ccb9129c48a0c47c6b8607fe5ca80c36e9b22e379c5dec
+  metadata.gz: 5688120d6baf34e1de5049978bd7a8b63f18bfd9dae45ab8acfbe3096b42f36168c5408502e7d4fc24bdafb4cda29fa1e7db77469fc3b6cd297ec685e89bb0a7
+  data.tar.gz: 9067b68f43129af1e0d5e4398b1d3682cf10bb05b0e06898ba708cec4d79e531e00129998a4697306c1b229fb139f33b985980c6216129a04279c1d02fb8e4d9

data/README.md

@@ -0,0 +1,13 @@
+# Essence
+
+A simple, ergonomic and performant component library for Ruby applications.
+
+---
+
+## Installation
+
+TBA
+
+## Licence
+
+MIT

data/exe/essence

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require_relative "../lib/essence"
+
+Essence::CLI.call

data/lib/essence/cli/add.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Essence
+  module CLI
+    class Add < Dry::CLI::Command
+      desc "Add an Essence component to your project"
+      argument :component_name, required: true, desc: "Component name"
+      example Essence.component_names
+
+      def call(*args)
+        component_name = args[0][:component_name]
+
+        return puts "> #{component_name}: component unsupported" unless Essence.component_names.include?(component_name.to_sym)
+
+        Essence::CLI::Commands.copy_component(component_name:)
+        Essence::CLI::Commands.replace_component_contents(component_name:)
+        Essence::CLI::Commands.replace_component_contents(
+          component_name:,
+          from: Essence::CLI::Commands::COMPONENT_DEFINITION_SUFFIX,
+          to: Essence::CLI::Commands::PHLEX_COMPONENT_DEFINITION_SUFFIX
+        )
+
+        puts "> Successfully added #{component_name} component to #{Essence::CLI::Commands::DESTINATION_DIR.join("#{component_name}.rb")}"
+      end
+    end
+  end
+end

data/lib/essence/cli/install.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Essence
+  module CLI
+    class Install < Dry::CLI::Command
+      BASE_COMPONENT_NAME = "essence"
+      BASE_DEFINITION_PREFIX = "class Essence::Essence"
+      PHLEX_BASE_DEFINITION_PREFIX = "class Components::Essence"
+
+      desc "Install Essence to your project"
+      def call(*)
+        puts "> Installing Essence..."
+        puts "> Copying base component to your project"
+        Essence::CLI::Commands.copy_component(component_name: BASE_COMPONENT_NAME)
+        Essence::CLI::Commands.replace_component_contents(
+          component_name: BASE_COMPONENT_NAME,
+          from: BASE_DEFINITION_PREFIX,
+          to: PHLEX_BASE_DEFINITION_PREFIX
+        )
+        # Essence::CLI::Commands.rename_component_file(
+        #   from: Essence::CLI::Commands::DESTINATION_DIR.join("#{BASE_COMPONENT_NAME}.rb"),
+        #   to: Essence::CLI::Commands::DESTINATION_DIR.join("essence.rb")
+        # )
+        puts "> Essence has been successfully installed!"
+      end
+    end
+  end
+end

data/lib/essence/cli/version.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Essence
+  module CLI
+    class Version < Dry::CLI::Command
+      desc "Print Essence version"
+
+      def call(*)
+        puts Essence::VERSION
+      end
+    end
+  end
+end

data/lib/essence/cli.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "dry/cli"
+
+# CLI Commands
+require_relative "cli/add"
+require_relative "cli/install"
+require_relative "cli/version"
+
+module Essence
+  module CLI
+    def self.call(*args)
+      Dry::CLI.new(Commands).call
+    end
+
+    module Commands
+      extend Dry::CLI::Registry
+
+      # Constants
+      COMPONENTS_DIR = Pathname.new(File.expand_path("components", __dir__))
+      DESTINATION_DIR = Pathname.new(File.expand_path(Dir.pwd)).join("app/components")
+      COMPONENT_DEFINITION_PREFIX = "class Essence::"
+      COMPONENT_DEFINITION_SUFFIX = "< Essence::Essence"
+      PHLEX_COMPONENT_DEFINITION_PREFIX = "class Components::"
+      PHLEX_COMPONENT_DEFINITION_SUFFIX = "< Components::Essence"
+
+      # Registering commands
+      register "add", Add, aliases: ["a", "generate", "g"]
+      register "install", Install, aliases: ["i"]
+      register "version", Version, aliases: ["v", "-v", "--version"]
+
+      private
+
+      # UTILITIES
+      def self.copy_component(component_name:)
+        source_path = COMPONENTS_DIR.join("#{component_name}.rb")
+        destination_path = DESTINATION_DIR.join("#{component_name}.rb")
+
+        FileUtils.mkdir_p(DESTINATION_DIR)
+        FileUtils.copy(source_path, destination_path)
+      end
+
+      def self.replace_component_contents(
+        component_name:,
+        from: COMPONENT_DEFINITION_PREFIX,
+        to: PHLEX_COMPONENT_DEFINITION_PREFIX
+      )
+        component_file = DESTINATION_DIR.join("#{component_name}.rb")
+        return unless File.exist?(component_file)
+
+        replaced_content = File.read(component_file).gsub(from, to)
+        File.write(component_file, replaced_content)
+      end
+
+      def self.rename_component_file(from:, to:)
+        return if from.nil? || to.nil?
+        return unless File.exist?(from)
+
+        FileUtils.mv(from, to)
+      end
+    end
+  end
+end

data/lib/essence/components/button.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-class Essence::Button < Essence::Component
+class Essence::Button < Essence::Essence
   BASE = "inline-flex items-center rounded-xs border border-transparent font-medium transition duration-150 cursor-pointer disabled:opacity-50 disabled:cursor-not-allowed hover:opacity-90"
 
   SIZES = {

data/lib/essence/{component.rb → components/essence.rb}

@@ -1,4 +1,6 @@
-class Essence::Component < Phlex::HTML
+class Essence::Essence < Phlex::HTML
+  extend Phlex::Kit
+
   TAILWIND_MERGER = ::TailwindMerge::Merger.new.freeze unless defined?(TAILWIND_MERGER)
 
   attr_reader :attributes

data/lib/essence/components/link.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-class Essence::Link < Essence::Component
+class Essence::Link < Essence::Essence
   CLASS = "inline-flex items-center gap-1 font-medium text-gray-900 border-b-2 hover:border-gray-900 transition-colors"
   KINDS = {
     regular: "border-transparent",

data/lib/essence/components/row.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-class Essence::Row < Essence::Component
+class Essence::Row < Essence::Essence
   CLASS = "flex gap-4"
 
   KINDS = {

data/lib/essence/components/skeleton.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-class Essence::Skeleton < Essence::Component
+class Essence::Skeleton < Essence::Essence
   CLASSES = "animate-pulse bg-gray-200/55 rounded-xs"
 
   def initialize(**attributes)

data/lib/essence/version.rb

@@ -1,3 +1,3 @@
 module Essence
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/essence.rb

@@ -1,11 +1,42 @@
+# frozen_string_literal: true
+
 require "tailwind_merge"
 
 module Essence
   # Autoloading
-  autoload :Component, "essence/component"
+  autoload :Component, "essence/components/component"
 
   autoload :Button, "essence/components/button"
   autoload :Link, "essence/components/link"
   autoload :Skeleton, "essence/components/skeleton"
   autoload :Row, "essence/components/row"
+
+  autoload :CLI, "essence/cli"
+
+  # Components
+  # Class names and classes are separated to avoid loading in Phlex into the CLI tooling
+
+  def self.component_class_names
+    @component_class_names ||= {
+      essence: "Essence::Essence",
+      button: "Essence::Button",
+      link: "Essence::Link",
+      skeleton: "Essence::Skeleton",
+      row: "Essence::Row",
+    }
+  end
+
+  def self.component_classes
+    @components_classes ||= {
+      essence: ::Essence::Essence,
+      button: ::Essence::Button,
+      link: ::Essence::Link,
+      skeleton: ::Essence::Skeleton,
+      row: ::Essence::Row,
+    }
+  end
+
+  def self.component_names
+    @component_names ||= component_class_names.keys
+  end
 end

metadata

@@ -1,16 +1,36 @@
 --- !ruby/object:Gem::Specification
 name: essence
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Elvinas Predkelis
 - Primevise
 autorequire:
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2024-12-15 00:00:00.000000000 Z
+date: 2024-12-18 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: dry-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: phlex
   requirement: !ruby/object:Gem::Requirement
@@ -42,13 +62,20 @@ dependencies:
 description: Component library for Ruby applications using Phlex
 email:
 - info@primevise.com
-executables: []
+executables:
+- essence
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
+- exe/essence
 - lib/essence.rb
-- lib/essence/component.rb
+- lib/essence/cli.rb
+- lib/essence/cli/add.rb
+- lib/essence/cli/install.rb
+- lib/essence/cli/version.rb
 - lib/essence/components/button.rb
+- lib/essence/components/essence.rb
 - lib/essence/components/link.rb
 - lib/essence/components/row.rb
 - lib/essence/components/skeleton.rb