bandoola 0.1.0

data/lib/bandoola/view/style/colors.rb

@@ -0,0 +1,167 @@
+module Bandoola
+  class View
+    class Style
+      # Background and border colors, named with Tailwind classes:
+      # bg-<color>-<shade> fills a div; border-<color>-<shade> colors its
+      # border (which still needs a border-N width to be drawn). Mixed into
+      # Style.
+      #
+      # PALETTE is Tailwind CSS v3.4 default colors (MIT-licensed): each
+      # family mapped to its 50..950 shades as hex.
+      module Colors # rubocop:disable Metrics/ModuleLength -- mostly the palette data table
+        PALETTE = {
+          "red" => {
+            50 => "#fef2f2", 100 => "#fee2e2", 200 => "#fecaca", 300 => "#fca5a5",
+            400 => "#f87171", 500 => "#ef4444", 600 => "#dc2626", 700 => "#b91c1c",
+            800 => "#991b1b", 900 => "#7f1d1d", 950 => "#450a0a"
+          },
+          "orange" => {
+            50 => "#fff7ed", 100 => "#ffedd5", 200 => "#fed7aa", 300 => "#fdba74",
+            400 => "#fb923c", 500 => "#f97316", 600 => "#ea580c", 700 => "#c2410c",
+            800 => "#9a3412", 900 => "#7c2d12", 950 => "#431407"
+          },
+          "amber" => {
+            50 => "#fffbeb", 100 => "#fef3c7", 200 => "#fde68a", 300 => "#fcd34d",
+            400 => "#fbbf24", 500 => "#f59e0b", 600 => "#d97706", 700 => "#b45309",
+            800 => "#92400e", 900 => "#78350f", 950 => "#451a03"
+          },
+          "yellow" => {
+            50 => "#fefce8", 100 => "#fef9c3", 200 => "#fef08a", 300 => "#fde047",
+            400 => "#facc15", 500 => "#eab308", 600 => "#ca8a04", 700 => "#a16207",
+            800 => "#854d0e", 900 => "#713f12", 950 => "#422006"
+          },
+          "lime" => {
+            50 => "#f7fee7", 100 => "#ecfccb", 200 => "#d9f99d", 300 => "#bef264",
+            400 => "#a3e635", 500 => "#84cc16", 600 => "#65a30d", 700 => "#4d7c0f",
+            800 => "#3f6212", 900 => "#365314", 950 => "#1a2e05"
+          },
+          "green" => {
+            50 => "#f0fdf4", 100 => "#dcfce7", 200 => "#bbf7d0", 300 => "#86efac",
+            400 => "#4ade80", 500 => "#22c55e", 600 => "#16a34a", 700 => "#15803d",
+            800 => "#166534", 900 => "#14532d", 950 => "#052e16"
+          },
+          "emerald" => {
+            50 => "#ecfdf5", 100 => "#d1fae5", 200 => "#a7f3d0", 300 => "#6ee7b7",
+            400 => "#34d399", 500 => "#10b981", 600 => "#059669", 700 => "#047857",
+            800 => "#065f46", 900 => "#064e3b", 950 => "#022c22"
+          },
+          "teal" => {
+            50 => "#f0fdfa", 100 => "#ccfbf1", 200 => "#99f6e4", 300 => "#5eead4",
+            400 => "#2dd4bf", 500 => "#14b8a6", 600 => "#0d9488", 700 => "#0f766e",
+            800 => "#115e59", 900 => "#134e4a", 950 => "#042f2e"
+          },
+          "cyan" => {
+            50 => "#ecfeff", 100 => "#cffafe", 200 => "#a5f3fc", 300 => "#67e8f9",
+            400 => "#22d3ee", 500 => "#06b6d4", 600 => "#0891b2", 700 => "#0e7490",
+            800 => "#155e75", 900 => "#164e63", 950 => "#083344"
+          },
+          "sky" => {
+            50 => "#f0f9ff", 100 => "#e0f2fe", 200 => "#bae6fd", 300 => "#7dd3fc",
+            400 => "#38bdf8", 500 => "#0ea5e9", 600 => "#0284c7", 700 => "#0369a1",
+            800 => "#075985", 900 => "#0c4a6e", 950 => "#082f49"
+          },
+          "blue" => {
+            50 => "#eff6ff", 100 => "#dbeafe", 200 => "#bfdbfe", 300 => "#93c5fd",
+            400 => "#60a5fa", 500 => "#3b82f6", 600 => "#2563eb", 700 => "#1d4ed8",
+            800 => "#1e40af", 900 => "#1e3a8a", 950 => "#172554"
+          },
+          "indigo" => {
+            50 => "#eef2ff", 100 => "#e0e7ff", 200 => "#c7d2fe", 300 => "#a5b4fc",
+            400 => "#818cf8", 500 => "#6366f1", 600 => "#4f46e5", 700 => "#4338ca",
+            800 => "#3730a3", 900 => "#312e81", 950 => "#1e1b4b"
+          },
+          "violet" => {
+            50 => "#f5f3ff", 100 => "#ede9fe", 200 => "#ddd6fe", 300 => "#c4b5fd",
+            400 => "#a78bfa", 500 => "#8b5cf6", 600 => "#7c3aed", 700 => "#6d28d9",
+            800 => "#5b21b6", 900 => "#4c1d95", 950 => "#2e1065"
+          },
+          "purple" => {
+            50 => "#faf5ff", 100 => "#f3e8ff", 200 => "#e9d5ff", 300 => "#d8b4fe",
+            400 => "#c084fc", 500 => "#a855f7", 600 => "#9333ea", 700 => "#7e22ce",
+            800 => "#6b21a8", 900 => "#581c87", 950 => "#3b0764"
+          },
+          "fuchsia" => {
+            50 => "#fdf4ff", 100 => "#fae8ff", 200 => "#f5d0fe", 300 => "#f0abfc",
+            400 => "#e879f9", 500 => "#d946ef", 600 => "#c026d3", 700 => "#a21caf",
+            800 => "#86198f", 900 => "#701a75", 950 => "#4a044e"
+          },
+          "pink" => {
+            50 => "#fdf2f8", 100 => "#fce7f3", 200 => "#fbcfe8", 300 => "#f9a8d4",
+            400 => "#f472b6", 500 => "#ec4899", 600 => "#db2777", 700 => "#be185d",
+            800 => "#9d174d", 900 => "#831843", 950 => "#500724"
+          },
+          "rose" => {
+            50 => "#fff1f2", 100 => "#ffe4e6", 200 => "#fecdd3", 300 => "#fda4af",
+            400 => "#fb7185", 500 => "#f43f5e", 600 => "#e11d48", 700 => "#be123c",
+            800 => "#9f1239", 900 => "#881337", 950 => "#4c0519"
+          },
+          "slate" => {
+            50 => "#f8fafc", 100 => "#f1f5f9", 200 => "#e2e8f0", 300 => "#cbd5e1",
+            400 => "#94a3b8", 500 => "#64748b", 600 => "#475569", 700 => "#334155",
+            800 => "#1e293b", 900 => "#0f172a", 950 => "#020617"
+          },
+          "gray" => {
+            50 => "#f9fafb", 100 => "#f3f4f6", 200 => "#e5e7eb", 300 => "#d1d5db",
+            400 => "#9ca3af", 500 => "#6b7280", 600 => "#4b5563", 700 => "#374151",
+            800 => "#1f2937", 900 => "#111827", 950 => "#030712"
+          },
+          "zinc" => {
+            50 => "#fafafa", 100 => "#f4f4f5", 200 => "#e4e4e7", 300 => "#d4d4d8",
+            400 => "#a1a1aa", 500 => "#71717a", 600 => "#52525b", 700 => "#3f3f46",
+            800 => "#27272a", 900 => "#18181b", 950 => "#09090b"
+          },
+          "neutral" => {
+            50 => "#fafafa", 100 => "#f5f5f5", 200 => "#e5e5e5", 300 => "#d4d4d4",
+            400 => "#a3a3a3", 500 => "#737373", 600 => "#525252", 700 => "#404040",
+            800 => "#262626", 900 => "#171717", 950 => "#0a0a0a"
+          },
+          "stone" => {
+            50 => "#fafaf9", 100 => "#f5f5f4", 200 => "#e7e5e4", 300 => "#d6d3d1",
+            400 => "#a8a29e", 500 => "#78716c", 600 => "#57534e", 700 => "#44403c",
+            800 => "#292524", 900 => "#1c1917", 950 => "#0c0a09"
+          }
+        }.freeze
+
+        # Colors without a shade: black/white. A shade is optional, so
+        # bg-black works, and a bare family (bg-cyan) falls back to 500.
+        NAMED = { "black" => "#000000", "white" => "#ffffff" }.freeze
+        DEFAULT_SHADE = 500
+
+        BACKGROUND = /\Abg-([a-z]+)(?:-(\d+))?\z/
+        BORDER_COLOR = /\Aborder-([a-z]+)(?:-(\d+))?\z/
+        TEXT_COLOR = /\Atext-([a-z]+)(?:-(\d+))?\z/
+
+        attr_reader :background, :border_color, :text_color
+
+        # [r, g, b] floats in 0..1 for a color name and optional shade, or nil
+        # if unknown. Named colors (black/white) ignore the shade.
+        def self.rgb(family, shade)
+          hex = NAMED[family] || PALETTE.dig(family, (shade || DEFAULT_SHADE).to_i)
+          return nil unless hex
+
+          digits = hex.delete("#")
+          [0, 2, 4].map { |offset| digits[offset, 2].to_i(16) / 255.0 }
+        end
+
+        def init_colors
+          @background = nil
+          @border_color = nil
+          @text_color = nil
+        end
+
+        # Only assigns when the token resolves to a real color, so an unknown
+        # color (or a text-<size> token that matches the text- shape but isn't
+        # a color) doesn't clobber a color set by an earlier class.
+        def apply_color_token(token)
+          if (match = token.match(BACKGROUND))
+            @background = Colors.rgb(match[1], match[2]) || @background
+          elsif (match = token.match(BORDER_COLOR))
+            @border_color = Colors.rgb(match[1], match[2]) || @border_color
+          elsif (match = token.match(TEXT_COLOR))
+            @text_color = Colors.rgb(match[1], match[2]) || @text_color
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bandoola/view/style/spacing.rb

@@ -0,0 +1,42 @@
+module Bandoola
+  class View
+    class Style
+      # Padding and margin: the p-* and m-* classes (p-4, px-2, mt-1, …). Both
+      # use the shared spacing SCALE and the same side letters, so they live
+      # together. Mixed into Style.
+      module Spacing
+        SPACING = /\A([mp])([trblxy]?)-(\d+)\z/
+
+        # Which edges each side letter touches (empty = all four, Tailwind's
+        # x/y axes, or a single t/r/b/l edge).
+        SIDES = {
+          "" => %i[top right bottom left],
+          "x" => %i[left right],
+          "y" => %i[top bottom],
+          "t" => %i[top],
+          "r" => %i[right],
+          "b" => %i[bottom],
+          "l" => %i[left]
+        }.freeze
+
+        attr_reader :margin, :padding
+
+        def init_spacing
+          @margin = Inset.new(0, 0, 0, 0)
+          @padding = Inset.new(0, 0, 0, 0)
+        end
+
+        def apply_spacing_token(token)
+          match = token.match(SPACING)
+          return unless match
+
+          points = SCALE[match[3].to_i]
+          return unless points # steps outside Tailwind's scale have no effect
+
+          inset = match[1] == "m" ? @margin : @padding
+          SIDES.fetch(match[2]).each { |edge| inset[edge] = points }
+        end
+      end
+    end
+  end
+end

data/lib/bandoola/view/style/typography.rb

@@ -0,0 +1,72 @@
+module Bandoola
+  class View
+    class Style
+      # Typography classes:
+      #   font-sans / font-serif / font-mono / font-<name>  -> font family
+      #   font-light/normal/medium/semibold/bold/...        -> font weight
+      #   text-xs … text-9xl                                -> font size (pt)
+      #
+      # The family is recorded by name (the View resolves it to an actual font
+      # at render time). The weight is a number; since we don't carry separate
+      # weight files, the renderer synthesises heavier weights with a stroke
+      # ("faux bold"), so anything below normal renders like normal. A name
+      # that is a known weight keyword can't double as a family name.
+      #
+      # text- also covers font size (text-xs … text-9xl) and alignment
+      # (text-left/center/right). These share the prefix with colors
+      # (text-cyan-500); each handler recognises only its own keywords, so they
+      # never claim each other's tokens.
+      # Mixed into Style.
+      module Typography
+        FONT = /\Afont-([a-z0-9-]+)\z/
+
+        WEIGHTS = {
+          "thin" => 100, "extralight" => 200, "light" => 300, "normal" => 400,
+          "medium" => 500, "semibold" => 600, "bold" => 700, "extrabold" => 800,
+          "black" => 900
+        }.freeze
+
+        # Tailwind's font-size scale, in points (1px ≈ 1pt).
+        SIZES = {
+          "xs" => 12, "sm" => 14, "base" => 16, "lg" => 18, "xl" => 20,
+          "2xl" => 24, "3xl" => 30, "4xl" => 36, "5xl" => 48, "6xl" => 60,
+          "7xl" => 72, "8xl" => 96, "9xl" => 128
+        }.freeze
+
+        ALIGNMENTS = %w[left center right].freeze
+
+        attr_reader :font, :font_weight, :text_size, :text_align
+
+        def init_typography
+          @font = nil
+          @font_weight = nil
+          @text_size = nil
+          @text_align = nil
+        end
+
+        def apply_font_token(token)
+          match = token.match(FONT)
+          return unless match
+
+          name = match[1]
+          if WEIGHTS.key?(name)
+            @font_weight = WEIGHTS[name]
+          else
+            @font = name
+          end
+        end
+
+        def apply_text_token(token)
+          return unless token.start_with?("text-")
+
+          key = token.delete_prefix("text-")
+          if (size = SIZES[key])
+            @text_size = size
+          elsif ALIGNMENTS.include?(key)
+            @text_align = key.to_sym
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bandoola/view/style.rb

@@ -0,0 +1,139 @@
+require_relative "style/spacing"
+require_relative "style/borders"
+require_relative "style/colors"
+require_relative "style/typography"
+
+module Bandoola
+  class View
+    # A box's spacing on each edge, in PDF points.
+    Inset = Struct.new(:top, :right, :bottom, :left)
+
+    # The visual style parsed from an element's `class` keyword. The vocabulary
+    # borrows from Tailwind. This file keeps the shared scale and the sizing
+    # classes; the other concerns live in mixins beside it:
+    #
+    #   Spacing  p-4 px-2 mt-1            padding / margin   (style/spacing.rb)
+    #   Borders  border-2                 border width       (style/borders.rb)
+    #   Colors   bg-cyan-100 border-...   colors            (style/colors.rb)
+    #
+    # Sizing (kept here):
+    #   w-2 w-64 h-8             fixed width / height (the shared SCALE)
+    #   w-1/2 w-6/7 h-3/4        fractional width / height
+    #   w-full h-full           fill the container
+    #
+    # Spacing and fixed sizes share one scale: `n` maps to `n * SPACING_UNIT`
+    # points. The allowed steps are Tailwind's — close together at the low end
+    # and increasingly sparse higher up (…12, 14, 16, 20, 24…), so `p-6` and
+    # `w-64` are valid but `w-31` is not. Unknown classes are ignored, so
+    # decorative names can sit alongside layout ones with no effect yet.
+    class Style
+      SPACING_UNIT = 4
+
+      # Tailwind's spacing scale (the integer steps): dense low, sparse high.
+      SCALE = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 14, 16, 20, 24, 28,
+               32, 36, 40, 44, 48, 52, 56, 60, 64].to_h { |step| [step, step * SPACING_UNIT] }.freeze
+
+      SIZE_FRACTION = %r{\A([wh])-(\d+)/(\d+)\z}
+      SIZE_FIXED = /\A([wh])-(\d+)\z/
+
+      include Spacing
+      include Borders
+      include Colors
+      include Typography
+
+      attr_reader :width, :width_fraction, :height, :height_fraction
+
+      def self.none
+        new
+      end
+
+      # Parse a `class` value into a Style. Accepts a String (split on
+      # whitespace), an Array of tokens, or nil.
+      def self.parse(value)
+        new.apply(tokens(value))
+      end
+
+      # Normalize a `class` value to an array of tokens: a String is split on
+      # whitespace, an Array is flattened (its entries normalized in turn),
+      # and nil yields none.
+      def self.tokens(value)
+        case value
+        when Array then value.flat_map { |item| tokens(item) }
+        when String then value.split(/\s+/).reject(&:empty?)
+        when nil then []
+        else [value.to_s]
+        end
+      end
+
+      def initialize
+        init_spacing
+        init_sizing
+        init_borders
+        init_colors
+        init_typography
+      end
+
+      def apply(tokens)
+        tokens.each { |token| apply_token(token) }
+        self
+      end
+
+      private
+
+      # Try each concern in turn. A token matches at most one, so the others
+      # simply do nothing — no branching, no precedence to reason about.
+      def apply_token(token)
+        apply_spacing_token(token)
+        apply_sizing_token(token)
+        apply_border_token(token)
+        apply_color_token(token)
+        apply_font_token(token)
+        apply_text_token(token)
+      end
+
+      def init_sizing
+        @width = nil           # fixed width in points, or nil
+        @width_fraction = nil  # [numerator, denominator], or nil
+        @height = nil
+        @height_fraction = nil
+      end
+
+      def apply_sizing_token(token)
+        if (match = token.match(SIZE_FRACTION))
+          apply_fraction(match[1], [match[2].to_i, match[3].to_i])
+        elsif (match = token.match(SIZE_FIXED))
+          apply_fixed(match[1], SCALE[match[2].to_i])
+        elsif token == "w-full"
+          # Width already defaults to full, so "full" just clears any size.
+          @width = @width_fraction = nil
+        elsif token == "h-full"
+          # Height defaults to auto, so "full" means fill the available height.
+          @height = nil
+          @height_fraction = [1, 1]
+        end
+      end
+
+      def apply_fraction(axis, fraction)
+        if axis == "w"
+          @width = nil
+          @width_fraction = fraction
+        else
+          @height = nil
+          @height_fraction = fraction
+        end
+      end
+
+      def apply_fixed(axis, points)
+        return unless points # steps outside Tailwind's scale have no effect
+
+        if axis == "w"
+          @width = points
+          @width_fraction = nil
+        else
+          @height = points
+          @height_fraction = nil
+        end
+      end
+    end
+  end
+end