lipgloss 0.0.1 → 0.2.0

data/go/tree.go

@@ -0,0 +1,138 @@
+package main
+
+import "C"
+
+import (
+	"encoding/json"
+	lipglosstree "github.com/charmbracelet/lipgloss/tree"
+)
+
+func allocTree(tree *lipglosstree.Tree) uint64 {
+	treesMu.Lock()
+	defer treesMu.Unlock()
+	id := getNextID()
+	trees[id] = tree
+
+	return id
+}
+
+func getTree(id uint64) *lipglosstree.Tree {
+	treesMu.RLock()
+	defer treesMu.RUnlock()
+
+	return trees[id]
+}
+
+//export lipgloss_tree_new
+func lipgloss_tree_new() C.ulonglong {
+	return C.ulonglong(allocTree(lipglosstree.New()))
+}
+
+//export lipgloss_tree_root
+func lipgloss_tree_root(root *C.char) C.ulonglong {
+	return C.ulonglong(allocTree(lipglosstree.Root(C.GoString(root))))
+}
+
+//export lipgloss_tree_free
+func lipgloss_tree_free(id C.ulonglong) {
+	treesMu.Lock()
+	defer treesMu.Unlock()
+	delete(trees, uint64(id))
+}
+
+//export lipgloss_tree_set_root
+func lipgloss_tree_set_root(id C.ulonglong, root *C.char) C.ulonglong {
+	tree := getTree(uint64(id)).Root(C.GoString(root))
+
+	return C.ulonglong(allocTree(tree))
+}
+
+//export lipgloss_tree_child
+func lipgloss_tree_child(id C.ulonglong, child *C.char) C.ulonglong {
+	tree := getTree(uint64(id)).Child(C.GoString(child))
+
+	return C.ulonglong(allocTree(tree))
+}
+
+//export lipgloss_tree_child_tree
+func lipgloss_tree_child_tree(id C.ulonglong, childTreeID C.ulonglong) C.ulonglong {
+	childTree := getTree(uint64(childTreeID))
+	tree := getTree(uint64(id)).Child(childTree)
+
+	return C.ulonglong(allocTree(tree))
+}
+
+//export lipgloss_tree_children
+func lipgloss_tree_children(id C.ulonglong, childrenJSON *C.char) C.ulonglong {
+	var children []string
+
+	if err := json.Unmarshal([]byte(C.GoString(childrenJSON)), &children); err != nil {
+		return id
+	}
+
+	anyChildren := make([]any, len(children))
+
+	for index, child := range children {
+		anyChildren[index] = child
+	}
+
+	tree := getTree(uint64(id)).Child(anyChildren...)
+
+	return C.ulonglong(allocTree(tree))
+}
+
+//export lipgloss_tree_enumerator
+func lipgloss_tree_enumerator(id C.ulonglong, enumType C.int) C.ulonglong {
+	var enumerator lipglosstree.Enumerator
+
+	switch int(enumType) {
+	case 0:
+		enumerator = lipglosstree.DefaultEnumerator
+	case 1:
+		enumerator = lipglosstree.RoundedEnumerator
+	default:
+		enumerator = lipglosstree.DefaultEnumerator
+	}
+
+	tree := getTree(uint64(id)).Enumerator(enumerator)
+
+	return C.ulonglong(allocTree(tree))
+}
+
+//export lipgloss_tree_enumerator_style
+func lipgloss_tree_enumerator_style(id C.ulonglong, styleID C.ulonglong) C.ulonglong {
+	style := getStyle(uint64(styleID))
+	tree := getTree(uint64(id)).EnumeratorStyle(style)
+
+	return C.ulonglong(allocTree(tree))
+}
+
+//export lipgloss_tree_item_style
+func lipgloss_tree_item_style(id C.ulonglong, styleID C.ulonglong) C.ulonglong {
+	style := getStyle(uint64(styleID))
+	tree := getTree(uint64(id)).ItemStyle(style)
+
+	return C.ulonglong(allocTree(tree))
+}
+
+//export lipgloss_tree_root_style
+func lipgloss_tree_root_style(id C.ulonglong, styleID C.ulonglong) C.ulonglong {
+	style := getStyle(uint64(styleID))
+	tree := getTree(uint64(id)).RootStyle(style)
+
+	return C.ulonglong(allocTree(tree))
+}
+
+//export lipgloss_tree_offset
+func lipgloss_tree_offset(id C.ulonglong, start C.int, end C.int) C.ulonglong {
+	tree := getTree(uint64(id)).Offset(int(start), int(end))
+
+	return C.ulonglong(allocTree(tree))
+}
+
+//export lipgloss_tree_render
+func lipgloss_tree_render(id C.ulonglong) *C.char {
+	tree := getTree(uint64(id))
+
+	return C.CString(tree.String())
+}

data/lib/lipgloss/border.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Lipgloss
+  module Border
+    # Standard border with normal weight and 90 degree corners
+    #   ┌───┐
+    #   │   │
+    #   └───┘
+    NORMAL = :normal
+
+    # Border with rounded corners
+    #   ╭───╮
+    #   │   │
+    #   ╰───╯
+    ROUNDED = :rounded
+
+    # Thicker border
+    #   ┏━━━┓
+    #   ┃   ┃
+    #   ┗━━━┛
+    THICK = :thick
+
+    # Double-line border
+    #   ╔═══╗
+    #   ║   ║
+    #   ╚═══╝
+    DOUBLE = :double
+
+    # ASCII border (compatible with all terminals)
+    #   +---+
+    #   |   |
+    #   +---+
+    ASCII = :ascii
+
+    # Hidden border (spaces, maintains layout)
+    HIDDEN = :hidden
+
+    # Block border (full blocks)
+    #   ████
+    #   █  █
+    #   ████
+    BLOCK = :block
+
+    OUTER_HALF_BLOCK = :outer_half_block
+    INNER_HALF_BLOCK = :inner_half_block
+  end
+end

data/lib/lipgloss/color.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Lipgloss
+  # @rbs!
+  #   type adaptive_color_hash = { light: String, dark: String }
+  #   type complete_color_hash = { true_color: String, ansi256: String, ansi: String }
+  #   type complete_adaptive_color_hash = { light: complete_color_hash, dark: complete_color_hash }
+
+  module ANSIColor
+    # @rbs!
+    #   type ansi_color_symbol = :black | :red | :green | :yellow | :blue | :magenta | :cyan | :white | :bright_black | :bright_red | :bright_green | :bright_yellow | :bright_blue | :bright_magenta | :bright_cyan | :bright_white
+    #   type ansi_color_value = ansi_color_symbol | Symbol | String | Integer
+
+    COLORS = {
+      black: "0",
+      red: "1",
+      green: "2",
+      yellow: "3",
+      blue: "4",
+      magenta: "5",
+      cyan: "6",
+      white: "7",
+      bright_black: "8",
+      bright_red: "9",
+      bright_green: "10",
+      bright_yellow: "11",
+      bright_blue: "12",
+      bright_magenta: "13",
+      bright_cyan: "14",
+      bright_white: "15"
+    }.freeze #: Hash[Symbol, String]
+
+    # @rbs value: ansi_color_value
+    # @rbs return: String
+    def self.resolve(value)
+      case value
+      when Symbol then COLORS.fetch(value) { raise ArgumentError, "Unknown ANSI color: #{value.inspect}" }
+      when String then value
+      when Integer then value.to_s
+      else raise ArgumentError, "ANSI color must be a Symbol, String, or Integer, got #{value.class}"
+      end
+    end
+  end
+
+  # Adaptive color that changes based on terminal background
+  #
+  # @example
+  #   color = Lipgloss::AdaptiveColor.new(light: "#000000", dark: "#FFFFFF")
+  #   style = Lipgloss::Style.new.foreground(color)
+  class AdaptiveColor
+    # @rbs @light: String
+    # @rbs @dark: String
+
+    attr_reader :light #: String
+    attr_reader :dark #: String
+
+    # @rbs light: String -- color to use on light backgrounds
+    # @rbs dark: String -- color to use on dark backgrounds
+    # @rbs return: void
+    def initialize(light:, dark:)
+      @light = light
+      @dark = dark
+    end
+
+    # @rbs return: adaptive_color_hash
+    def to_h
+      { light: @light, dark: @dark }
+    end
+  end
+
+  # Complete color with explicit values for each color profile
+  #
+  # @example
+  #   color = Lipgloss::CompleteColor.new(
+  #     true_color: "#0000FF",
+  #     ansi256: 21,
+  #     ansi: :blue
+  #   )
+  class CompleteColor
+    # @rbs @true_color: String
+    # @rbs @ansi256: String
+    # @rbs @ansi: String
+
+    attr_reader :true_color #: String
+    attr_reader :ansi256 #: String
+    attr_reader :ansi #: String
+
+    # @rbs true_color: String -- 24-bit color (e.g., "#0000FF")
+    # @rbs ansi256: ANSIColor::ansi_color_value -- 8-bit ANSI color (0-255, or symbol for 0-15)
+    # @rbs ansi: ANSIColor::ansi_color_value -- 4-bit ANSI color (:red, :blue, etc., or 0-15)
+    # @rbs return: void
+    def initialize(true_color:, ansi256:, ansi:)
+      @true_color = true_color
+      @ansi256 = ANSIColor.resolve(ansi256)
+      @ansi = ANSIColor.resolve(ansi)
+    end
+
+    # @rbs return: complete_color_hash
+    def to_h
+      { true_color: @true_color, ansi256: @ansi256, ansi: @ansi }
+    end
+  end
+
+  # Complete adaptive color with explicit values for each color profile
+  # and separate options for light and dark backgrounds
+  #
+  # @example
+  #   color = Lipgloss::CompleteAdaptiveColor.new(
+  #     light: Lipgloss::CompleteColor.new(true_color: "#000", ansi256: :black, ansi: :black),
+  #     dark: Lipgloss::CompleteColor.new(true_color: "#FFF", ansi256: :bright_white, ansi: :bright_white)
+  #   )
+  class CompleteAdaptiveColor
+    # @rbs @light: CompleteColor
+    # @rbs @dark: CompleteColor
+
+    attr_reader :light #: CompleteColor
+    attr_reader :dark #: CompleteColor
+
+    # @rbs light: CompleteColor -- color for light backgrounds
+    # @rbs dark: CompleteColor -- color for dark backgrounds
+    # @rbs return: void
+    def initialize(light:, dark:)
+      @light = light
+      @dark = dark
+    end
+
+    # @rbs return: complete_adaptive_color_hash
+    def to_h
+      { light: @light.to_h, dark: @dark.to_h }
+    end
+  end
+end

data/lib/lipgloss/position.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Lipgloss
+  # Position constants for alignment
+  #
+  # Positions are represented as floats from 0.0 to 1.0:
+  # - 0.0 = top/left
+  # - 0.5 = center
+  # - 1.0 = bottom/right
+  module Position
+    # Top alignment (0.0)
+    TOP = 0.0
+
+    # Bottom alignment (1.0)
+    BOTTOM = 1.0
+
+    # Left alignment (0.0)
+    LEFT = 0.0
+
+    # Right alignment (1.0)
+    RIGHT = 1.0
+
+    # Center alignment (0.5)
+    CENTER = 0.5
+
+    # @rbs!
+    #   type position_symbol = :top | :bottom | :left | :right | :center
+    #   type position_value = position_symbol | Symbol | String | Integer | Float
+
+    SYMBOLS = {
+      top: TOP,
+      bottom: BOTTOM,
+      left: LEFT,
+      right: RIGHT,
+      center: CENTER
+    }.freeze #: Hash[Symbol, Float]
+
+    # @rbs value: position_value
+    # @rbs return: Float
+    def self.resolve(value)
+      case value
+      when Symbol then SYMBOLS.fetch(value) { raise ArgumentError, "Unknown position: #{value.inspect}" }
+      when String then SYMBOLS.fetch(value.to_sym) { raise ArgumentError, "Unknown position: #{value.inspect}" }
+      when Numeric then value.to_f
+      else raise ArgumentError, "Position must be a Symbol or Numeric, got #{value.class}"
+      end
+    end
+  end
+end

data/lib/lipgloss/style.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Lipgloss
+  class Style
+    # @rbs *positions: Position::position_value
+    # @rbs return: Style
+    def align(*positions)
+      _align(*positions.map { |p| Position.resolve(p) })
+    end
+
+    # @rbs position: Position::position_value
+    # @rbs return: Style
+    def align_horizontal(position)
+      _align_horizontal(Position.resolve(position))
+    end
+
+    # @rbs position: Position::position_value
+    # @rbs return: Style
+    def align_vertical(position)
+      _align_vertical(Position.resolve(position))
+    end
+  end
+end

data/lib/lipgloss/table.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Lipgloss
+  # Ruby enhancements for the Table class
+  #
+  # The Table class is implemented in C, but this module adds
+  # Ruby-level conveniences like style_func with blocks.
+  class Table
+    # Header row constant (used in style_func)
+    HEADER_ROW = -1
+
+    # Set a style function that determines the style for each cell
+    #
+    # @example Alternating row colors
+    #   table.style_func(rows: 2, columns: 2) do |row, column|
+    #     if row == Lipgloss::Table::HEADER_ROW
+    #       Lipgloss::Style.new.bold(true)
+    #     elsif row.even?
+    #       Lipgloss::Style.new.background("#333")
+    #     else
+    #       Lipgloss::Style.new.background("#444")
+    #     end
+    #   end
+    #
+    # @example Column-specific styling
+    #   table.style_func(rows: 2, columns: 2) do |row, column|
+    #     case column
+    #     when 0 then Lipgloss::Style.new.bold(true)
+    #     when 1 then Lipgloss::Style.new.foreground("#00FF00")
+    #     else Lipgloss::Style.new
+    #     end
+    #   end
+    #
+    # @rbs rows: Integer -- number of data rows in the table
+    # @rbs columns: Integer -- number of columns in the table
+    # @rbs &block: (Integer, Integer) -> Style? -- block called for each cell position
+    # @rbs return: Table -- a new table with the style function applied
+    def style_func(rows:, columns:, &block)
+      raise ArgumentError, "block required" unless block_given?
+      raise ArgumentError, "rows must be >= 0" if rows.negative?
+      raise ArgumentError, "columns must be > 0" if columns <= 0
+
+      style_map = {} #: Hash[String, Style]
+
+      # Header row
+      columns.times do |column|
+        style = block.call(HEADER_ROW, column)
+        style_map["#{HEADER_ROW},#{column}"] = style if style
+      end
+
+      # Data rows
+      rows.times do |row|
+        columns.times do |column|
+          style = block.call(row, column)
+          style_map["#{row},#{column}"] = style if style
+        end
+      end
+
+      _style_func_map(style_map)
+    end
+  end
+end

data/lib/lipgloss/version.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
+# rbs_inline: enabled
 
 module Lipgloss
-  VERSION = "0.0.1"
+  VERSION = "0.2.0" #: String
 end

data/lib/lipgloss.rb

@@ -1,8 +1,77 @@
 # frozen_string_literal: true
+# rbs_inline: enabled
 
 require_relative "lipgloss/version"
 
+begin
+  major, minor, _patch = RUBY_VERSION.split(".") #: [String, String, String]
+  require_relative "lipgloss/#{major}.#{minor}/lipgloss"
+rescue LoadError
+  require_relative "lipgloss/lipgloss"
+end
+
+require_relative "lipgloss/position"
+require_relative "lipgloss/border"
+require_relative "lipgloss/color"
+require_relative "lipgloss/style"
+require_relative "lipgloss/table"
+
 module Lipgloss
-  class Error < StandardError; end
-  # Your code goes here...
+  TOP = Position::TOP #: Float
+  BOTTOM = Position::BOTTOM #: Float
+  LEFT = Position::LEFT #: Float
+  RIGHT = Position::RIGHT #: Float
+  CENTER = Position::CENTER #: Float
+
+  NORMAL_BORDER = Border::NORMAL #: Symbol
+  ROUNDED_BORDER = Border::ROUNDED #: Symbol
+  THICK_BORDER = Border::THICK #: Symbol
+  DOUBLE_BORDER = Border::DOUBLE #: Symbol
+  HIDDEN_BORDER = Border::HIDDEN #: Symbol
+  BLOCK_BORDER = Border::BLOCK #: Symbol
+  ASCII_BORDER = Border::ASCII #: Symbol
+
+  NO_TAB_CONVERSION = -1 #: Integer
+
+  class << self
+    # @rbs position: Position::position_value
+    # @rbs *strings: String
+    # @rbs return: String
+    def join_horizontal(position, *strings)
+      _join_horizontal(Position.resolve(position), strings)
+    end
+
+    # @rbs position: Position::position_value
+    # @rbs *strings: String
+    # @rbs return: String
+    def join_vertical(position, *strings)
+      _join_vertical(Position.resolve(position), strings)
+    end
+
+    # @rbs width: Integer
+    # @rbs height: Integer
+    # @rbs horizontal: Position::position_value
+    # @rbs vertical: Position::position_value
+    # @rbs string: String
+    # @rbs return: String
+    def place(width, height, horizontal, vertical, string, **opts)
+      _place(width, height, Position.resolve(horizontal), Position.resolve(vertical), string, **opts)
+    end
+
+    # @rbs width: Integer
+    # @rbs position: Position::position_value
+    # @rbs string: String
+    # @rbs return: String
+    def place_horizontal(width, position, string)
+      _place_horizontal(width, Position.resolve(position), string)
+    end
+
+    # @rbs height: Integer
+    # @rbs position: Position::position_value
+    # @rbs string: String
+    # @rbs return: String
+    def place_vertical(height, position, string)
+      _place_vertical(height, Position.resolve(position), string)
+    end
+  end
 end

data/lipgloss.gemspec

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "lib/lipgloss/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "lipgloss"
+  spec.version = Lipgloss::VERSION
+  spec.authors = ["Marco Roth"]
+  spec.email = ["marco.roth@intergga.ch"]
+
+  spec.summary = "Ruby wrapper for Charm's lipgloss. CSS-like terminal styling library."
+  spec.description = "Style Definitions for Nice Terminal Layouts. Built with TUIs in mind."
+  spec.homepage = "https://github.com/marcoroth/lipgloss-ruby"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/marcoroth/lipgloss-ruby"
+  spec.metadata["changelog_uri"] = "https://github.com/marcoroth/lipgloss-ruby/releases"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  spec.files = Dir[
+    "lipgloss.gemspec",
+    "LICENSE.txt",
+    "README.md",
+    "lib/**/*.rb",
+    "ext/**/*.{c,h,rb}",
+    "go/**/*.{go,mod,sum}",
+    "go/build/**/*"
+  ]
+
+  spec.require_paths = ["lib"]
+  spec.extensions = ["ext/lipgloss/extconf.rb"]
+end

metadata

@@ -1,36 +1,62 @@
 --- !ruby/object:Gem::Specification
 name: lipgloss
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Marco Roth
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: Style definitions for nice terminal layouts. Integrate Charm's lipgloss
-  with the RubyGems infrastructure.
+description: Style Definitions for Nice Terminal Layouts. Built with TUIs in mind.
 email:
 - marco.roth@intergga.ch
 executables: []
-extensions: []
+extensions:
+- ext/lipgloss/extconf.rb
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
-- CODE_OF_CONDUCT.md
+- LICENSE.txt
 - README.md
-- Rakefile
+- ext/lipgloss/color.c
+- ext/lipgloss/extconf.rb
+- ext/lipgloss/extension.c
+- ext/lipgloss/extension.h
+- ext/lipgloss/list.c
+- ext/lipgloss/style.c
+- ext/lipgloss/style_border.c
+- ext/lipgloss/style_spacing.c
+- ext/lipgloss/style_unset.c
+- ext/lipgloss/table.c
+- ext/lipgloss/tree.c
+- go/color.go
+- go/go.mod
+- go/go.sum
+- go/layout.go
+- go/lipgloss.go
+- go/list.go
+- go/style.go
+- go/style_border.go
+- go/style_spacing.go
+- go/style_unset.go
+- go/table.go
+- go/tree.go
 - lib/lipgloss.rb
+- lib/lipgloss/border.rb
+- lib/lipgloss/color.rb
+- lib/lipgloss/position.rb
+- lib/lipgloss/style.rb
+- lib/lipgloss/table.rb
 - lib/lipgloss/version.rb
-- sig/lipgloss.rbs
-homepage: https://github.com/marcoroth/lipgloss
+- lipgloss.gemspec
+homepage: https://github.com/marcoroth/lipgloss-ruby
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/marcoroth/lipgloss
-  source_code_uri: https://github.com/marcoroth/lipgloss
-  changelog_uri: https://github.com/marcoroth/lipgloss/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/marcoroth/lipgloss-ruby
+  source_code_uri: https://github.com/marcoroth/lipgloss-ruby
+  changelog_uri: https://github.com/marcoroth/lipgloss-ruby/releases
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
@@ -46,7 +72,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
-summary: Ruby wrapper for Charm's lipgloss CLI tool.
+summary: Ruby wrapper for Charm's lipgloss. CSS-like terminal styling library.
 test_files: []

data/CHANGELOG.md

@@ -1,5 +0,0 @@
-## [Unreleased]
-
-## [0.1.0] - 2025-12-07
-
-- Initial release