essence 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41a46dd9be7eb9ea84ba3ca4ad2f3a20333154644472673c347117bd6fb6b652
-  data.tar.gz: 3fd04819b2f327760571d3ec200a7300c45b7a4d7627b425e969a6999a051925
+  metadata.gz: b698fdfbf94b34b4afa01e1c6f38a2e9ac2feca00f34166c0acead4c4e6c8e40
+  data.tar.gz: b11e693d29dbc9bd6763725692570bffb8879cafb32967cc1c34a2fbc5c65881
 SHA512:
-  metadata.gz: 5688120d6baf34e1de5049978bd7a8b63f18bfd9dae45ab8acfbe3096b42f36168c5408502e7d4fc24bdafb4cda29fa1e7db77469fc3b6cd297ec685e89bb0a7
-  data.tar.gz: 9067b68f43129af1e0d5e4398b1d3682cf10bb05b0e06898ba708cec4d79e531e00129998a4697306c1b229fb139f33b985980c6216129a04279c1d02fb8e4d9
+  metadata.gz: b95a0636aca009728061fc524f93bfeacf2728aa846e7e6ff7afa8918ba99ce1a47ba80ef8bc44863d982c0cb8cc1ef760f61f9c367b9cddd9beda463de5798c
+  data.tar.gz: 371fb23359faf1f9e5835394c2fea1952813d7f43bf0f008704b641dca2d50faa2463c371869d1511a8625a22b9416ac8d2c3b59f09ceae36ca1c1e6fc865d29

data/README.md

@@ -2,11 +2,53 @@
 
 A simple, ergonomic and performant component library for Ruby applications.
 
+<a href="https://rubygems.org/gems/essence">
+  <img alt="Essence GEM Version" src="https://img.shields.io/gem/v/essence?color=10b981&include_prereleases&logo=ruby&logoColor=f43f5e">
+</a>
+
+<a href="https://rubygems.org/gems/essence">
+  <img alt="Essence GEM Version" src="https://img.shields.io/gem/dt/essence?color=10b981&include_prereleases&logo=ruby&logoColor=f43f5e">
+</a>
+
+---
+
+### Features
+
+- Tailored components - Designed using flexibility in mind while streamlining the development process
+- Gorgeous simplicity - Essence empowers minimalistic user interface with purposeful accents
+- Geared for performance - Keep everything in one place. No spreadsheets or getting lost between tooling
+- Ergonomic approach - Essence is designed to be easy to use and understand
+
 ---
 
 ## Installation
 
-TBA
+#### Add gem
+
+Simply add the gem to your Gemfile by running the following command
+
+```bash
+bundle add essence
+```
+
+#### Install Essence
+
+Run the installation command and we'll take care of the rest
+
+```bash
+bundle exec essence install
+```
+
+More information on about the installation can be found in the [documentation](https://essence.primevise.com/installation)
+
+## Who uses Essence?
+
+- [Mintis](https://mintis.app)
+- [Hansa](https://hansahq.com)
+- [Release Server](https://releaseserver.com)
+- [College Life Work](https://work.collegelife.co)
+
+Do you use Essence in your project? Let us know!
 
 ## Licence
 

data/lib/essence/components/avatar.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+class Essence::Button < Essence::Essence
+  BASE = "inline-flex items-center justify-center w-fit rounded-xs border border-transparent font-medium transition duration-150 cursor-pointer disabled:opacity-50 disabled:cursor-not-allowed hover:opacity-90"
+  SIZES = {
+    none: "",
+    xs: "text-[0.6rem] px-2 py-1.5 gap-1",
+    sm: "text-xs px-3 py-2 gap-1.5",
+    md: "text-sm px-4 py-2 gap-2",
+    lg: "text-base px-6 py-2.5 gap-2.5",
+    xl: "text-base px-8 py-3 gap-3"
+  }
+  KINDS = {
+    primary: "text-white bg-indigo-500 hover:bg-indigo-500",
+    secondary: "text-gray-700 bg-gray-100 hover:bg-gray-200",
+    critical: "text-white bg-rose-500 hover:bg-rose-400",
+    warning: "text-white bg-amber-500 hover:bg-amber-400",
+    success: "text-white bg-emerald-500 hover:bg-emerald-400",
+    info: "text-white bg-blue-500 hover:bg-blue-400",
+    dark: "text-white bg-gray-900 hover:bg-gray-800",
+    white: "text-gray-900 bg-white hover:bg-gray-200",
+    ghost: "text-gray-900 bg-white hover:bg-gray-200 hover:text-gray-800"
+  }
+
+  attr_reader :size
+  attr_reader :kind
+  attr_reader :attributes
+
+  def initialize(size: :md, kind: :primary, **attributes)
+    @size = size
+    @kind = kind
+    @attributes = attributes
+    @attributes[:class] = construct_classes(@attributes[:class])
+  end
+
+  def view_template(&)
+    element_tag(**attributes, &)
+  end
+
+  private
+
+  def element_tag(...)
+    attributes[:href] ? a(...) : button(...)
+  end
+
+  def construct_classes(classes)
+    TAILWIND_MERGER.merge([ BASE, SIZES[size], KINDS[kind], classes ].compact)
+  end
+end

data/lib/essence/components/badge.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+class Essence::Avatar < Essence::Essence
+  BASE = "border border-transparent rounded-full bg-gray-100 aspect-square inline-flex items-center justify-center font-medium text-gray-700"
+  SIZES = {
+    sm: "size-6 text-xs",
+    md: "size-8 text-sm",
+    lg: "size-12 text-base"
+  }
+
+  attr_reader :attributes
+  attr_reader :size
+
+  def initialize(size: :md, **attributes)
+    @size = size
+    @attributes = attributes
+    @attributes[:class] = construct_classes(@attributes[:class])
+  end
+
+  def view_template(&)
+    div(**attributes, &)
+  end
+
+  def fallback(**attrs, &)
+    span(**attrs, &)
+  end
+
+  def construct_classes(classes)
+    TAILWIND_MERGER.merge([ BASE, SIZES[size], classes ].compact)
+  end
+end

data/lib/essence/components/button.rb

@@ -1,27 +1,21 @@
 # frozen_string_literal: true
 
-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"
-
+class Essence::Badge < Essence::Essence
+  BASE = "inline-flex items-center justify-center w-fit rounded-full border border-transparent font-medium transition duration-150 hover:opacity-90"
   SIZES = {
     none: "",
-    xs: "text-[0.6rem] px-2 py-1.5 gap-1",
-    sm: "text-xs px-3 py-2 gap-1.5",
-    md: "text-sm px-4 py-2 gap-2",
-    lg: "text-base px-6 py-2.5 gap-2.5",
-    xl: "text-base px-8 py-3 gap-3"
+    sm: "text-[0.65rem] px-2 py-0.5 gap-1",
+    md: "text-xs px-2.5 py-1 gap-2",
+    lg: "text-sm px-4 py-1.5 gap-2"
   }
-
   KINDS = {
-    primary: "text-white bg-indigo-500 hover:bg-indigo-500",
-    secondary: "text-gray-700 bg-gray-100 hover:bg-gray-200",
-    critical: "text-white bg-rose-500 hover:bg-rose-400",
-    warning: "text-white bg-amber-500 hover:bg-amber-400",
-    success: "text-white bg-emerald-500 hover:bg-emerald-400",
-    info: "text-white bg-blue-500 hover:bg-blue-400",
-    dark: "text-white bg-gray-900 hover:bg-gray-800",
-    white: "text-gray-900 bg-white hover:bg-gray-200",
-    ghost: "text-gray-900 bg-white hover:bg-gray-200 hover:text-gray-800"
+    primary: "text-gray-900 border-gray-200",
+    success: "text-white bg-emerald-500",
+    critical: "text-white bg-rose-500",
+    warning: "text-white bg-amber-500",
+    info: "text-white bg-blue-500",
+    dark: "text-white bg-gray-900",
+    white: "text-gray-900 bg-white"
   }
 
   attr_reader :size
@@ -36,16 +30,13 @@ class Essence::Button < Essence::Essence
   end
 
   def view_template(&)
-    element_tag(**attributes, &)
+    div(**attributes, &)
   end
 
   private
 
-  def element_tag(...)
-    attributes[:href] ? a(...) : button(...)
-  end
-
   def construct_classes(classes)
     TAILWIND_MERGER.merge([ BASE, SIZES[size], KINDS[kind], classes ].compact)
   end
+
 end

data/lib/essence/components/link.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 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"
+  BASE = "inline-flex w-fit items-center gap-1 font-medium text-gray-900 border-b-2 hover:border-gray-900 transition-colors"
   KINDS = {
     regular: "border-transparent",
     underline: "border-gray-200"
@@ -11,7 +11,7 @@ class Essence::Link < Essence::Essence
 
   def initialize(kind: :regular, **attributes)
     @attributes = attributes
-    @attributes[:class] = @attributes[:class] ? TAILWIND_MERGER.merge([ CLASS, @attributes[:class] ]) : CLASS
+    @attributes[:class] = @attributes[:class] ? TAILWIND_MERGER.merge([ BASE, @attributes[:class] ]) : BASE
   end
 
   def view_template(&)

data/lib/essence/components/row.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 class Essence::Row < Essence::Essence
-  CLASS = "flex gap-4"
-
+  BASE = "flex gap-4"
   KINDS = {
     default: "flex-col md:flex-row md:items-center md:justify-between",
     center: "flex-col md:flex-row md:items-center md:justify-center",
@@ -16,7 +15,7 @@ class Essence::Row < Essence::Essence
   def initialize(kind: :default, **attributes)
     @kind = kind
     @attributes = attributes
-    @attributes[:class] = @attributes[:class] ? TAILWIND_MERGER.merge([ CLASS, KINDS[kind], @attributes[:class] ]) : CLASS
+    @attributes[:class] = @attributes[:class] ? TAILWIND_MERGER.merge([ BASE, KINDS[kind], @attributes[:class] ]) : BASE
   end
 
   def view_template(&)
@@ -24,6 +23,6 @@ class Essence::Row < Essence::Essence
   end
 
   def item(**attrs, &)
-    div(class: TAILWIND_MERGER.merge([ "flex items-center gap-2 flex-wrap", iattrs[:class] ]), **attrs, &)
+    div(class: TAILWIND_MERGER.merge([ "flex items-center gap-2 flex-wrap", attrs[:class] ]), **attrs, &)
   end
 end

data/lib/essence/components/skeleton.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 class Essence::Skeleton < Essence::Essence
-  CLASSES = "animate-pulse bg-gray-200/55 rounded-xs"
+  BASE = "animate-pulse bg-gray-200/55 rounded-xs"
 
   def initialize(**attributes)
     @attributes = attributes
-    @attributes[:class] = @attributes[:class] ? TAILWIND_MERGER.merge([ CLASSES, @attributes[:class] ]) : CLASSES
+    @attributes[:class] = @attributes[:class] ? TAILWIND_MERGER.merge([ BASE, @attributes[:class] ]) : BASE
   end
 
   def view_template(&)

data/lib/essence/version.rb

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

data/lib/essence.rb

@@ -19,6 +19,8 @@ module Essence
   def self.component_class_names
     @component_class_names ||= {
       essence: "Essence::Essence",
+      avataro: "Essence::Avatar",
+      badge: "Essence::Badge",
       button: "Essence::Button",
       link: "Essence::Link",
       skeleton: "Essence::Skeleton",
@@ -29,6 +31,8 @@ module Essence
   def self.component_classes
     @components_classes ||= {
       essence: ::Essence::Essence,
+      avatar: ::Essence::Avatar,
+      badge: ::Essence::Badge,
       button: ::Essence::Button,
       link: ::Essence::Link,
       skeleton: ::Essence::Skeleton,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: essence
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Elvinas Predkelis
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-18 00:00:00.000000000 Z
+date: 2024-12-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-cli
@@ -74,6 +74,8 @@ files:
 - lib/essence/cli/add.rb
 - lib/essence/cli/install.rb
 - lib/essence/cli/version.rb
+- lib/essence/components/avatar.rb
+- lib/essence/components/badge.rb
 - lib/essence/components/button.rb
 - lib/essence/components/essence.rb
 - lib/essence/components/link.rb