silk_layout 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98125df0dda9b67eb2040377c0d095ed91b33e2f62b944643c57565ba2c45cf3
-  data.tar.gz: b19305f2b4f6e72d5a438ff299f0b6c5378eecda536436c865d10c8b82ac93fb
+  metadata.gz: eaabe9a16fb9f8239faf12994d4dbb5e55e7fa057a002b2e63697cbbd78c1d45
+  data.tar.gz: 286bebded7bfd70477c787f88be61e44d6589776c8fdaf2ee2c8e95db75b3ab9
 SHA512:
-  metadata.gz: 9d12cfbb00fdfa50249fe3890ffc8c2d0742975089c8e19562e23fbff2a7055f4b52fee5af7a203fcf34ef5e195eb4d7f27b5f365484eef49e5a5d787489a7d1
-  data.tar.gz: 50e90dbf3aa62fb150b028925bc8de3636c0fa54654c4ae68aedcd3eb9cd1b2187680b3ba90cc9cca2bff7557763e39eb3c6ec9eaaa973badcef0caebf896ed0
+  metadata.gz: ccc56be016419055cc8f6e3de5509917f5cfa9578d798bb87c400e3384bdd26bf9b5eee2a16c60b29bfcf41a1669d66f0167fcf2f66fcbd82c0efc6706da0433
+  data.tar.gz: f47d7dd848f5f373042752c257057d02972d758ee9dba7cea21761f4a268b225ed86e4a3d6b06d81cbcdb2a026c5f51b29f6eba80137e375861328c583ce49fd

data/CHANGELOG.md

@@ -6,7 +6,42 @@ This project follows a lightweight changelog format while it is pre-1.0.
 
 ## Unreleased
 
-No changes yet.
+- Nothing yet.
+
+## 0.2.0
+
+Released rendering foundations for the 0.2 line.
+
+### Runtime Scope
+
+- Local raster image loading, intrinsic image sizing, and PDF rendering smoke
+  coverage.
+- CSS value hardening for common percent and `calc()` length cases.
+- Richer color parsing for named colors, hex colors, `rgb()`, `rgba()`,
+  `hsl()`, `hsla()`, and `transparent`.
+- Basic print CSS page sizing through explicit options and `@page size`.
+- Continued cascade, selector, box model, inline layout, flex layout, and visual
+  parity hardening.
+
+### Release and DX
+
+- Document the 0.2 support matrix as current, partial, or unsupported rather
+  than browser-complete.
+- Document unit test, visual regression, single visual fixture, and package smoke
+  commands in the README and contribution guide.
+- Add `bundle exec rake package:smoke` for a build/install/require/render smoke
+  path.
+- Add CI coverage for the package smoke path on the release Ruby.
+
+### Known gaps
+
+- Pagination, page-break controls, repeated headers/footers, and multi-page
+  fragmentation remain unsupported.
+- CSS Grid, positioning, floats, tables, and list markers remain unsupported.
+- Border radius, shadows, gradients, background images, filters, transforms, and
+  blend modes remain unsupported.
+- Remote images, SVG, animated image formats, `object-fit`, and
+  `object-position` remain unsupported.
 
 ## 0.1.0
 

data/README.md

@@ -3,35 +3,61 @@
 SilkLayout is a Ruby-native HTML/CSS layout engine that renders documents to PDF.
 
 The long-term goal is to make PDF generation feel natural inside Ruby apps without
-delegating layout to a browser engine. The project is currently on the `0.1`
-release track: useful for experimentation, regression testing, and early document
-rendering, but not yet 1.0 or browser-spec complete.
+delegating layout to a browser engine. The project is currently on the `0.2`
+pre-release track: useful for experimentation, regression testing, and early
+document rendering, but not yet 1.0 or browser-spec complete.
 
 ## Current Status
 
-SilkLayout currently supports:
-
-- HTML parsing with Nokogiri
-- CSS parsing with Crass
-- CSS cascade basics, selector matching, specificity, inheritance, inline styles,
-  and `!important`
-- block layout, inline text layout, line wrapping, and whitespace normalization
-- box model spacing: margin, padding, borders, border colors, width, and height
-- basic flex layout: rows, columns, reverse directions, wrapping, gaps, grow,
-  shrink, basis, justify, and align basics
-- PDF rendering with HexaPDF for text, borders, border colors, and simple
-  background colors
-- visual regression tests against Chromium output
-
-Not yet supported:
-
-- CSS Grid
-- percentage and `calc()` sizing
-- images
-- pagination and page-break controls
-- positioning, floats, tables, and list markers
-- border radius, shadows, gradients, and background images
-- full CSS color syntax such as `rgb()`, `rgba()`, and `hsl()`
+SilkLayout is pre-1.0, so support is described as current, partial, or
+unsupported rather than as a browser compatibility promise.
+
+| Area | 0.2 status | Notes |
+| --- | --- | --- |
+| HTML parsing | Current | Nokogiri document parsing, text nodes, attributes, inline styles, `<style>` blocks, linked stylesheets, and base URLs. |
+| CSS cascade | Current | Crass parsing, selector matching, specificity, inheritance, inline styles, and `!important`; unsupported selectors fail closed. |
+| Block and inline layout | Current | Block stacking, inline text measurement, line wrapping, whitespace normalization, margins, padding, borders, width, and height. |
+| Flex layout | Partial | Rows, columns, reverse directions, wrapping, gaps, grow, shrink, basis, justify, and align basics; full flexbox parity is still out of scope. |
+| CSS values and colors | Partial / 0.2 target | Pixel lengths are current; 0.2 tracks percent and `calc()` lengths for common box values plus named, hex, `rgb()`, `rgba()`, `hsl()`, `hsla()`, and `transparent` colors. |
+| PDF painting | Partial | Text, borders, border colors, and simple backgrounds are current; 0.2 tracks local raster image painting and print page sizing. |
+| Images | Partial / 0.2 target | Local image loading, intrinsic sizing, and PDF smoke coverage are planned for 0.2; remote images, SVG, animated formats, `object-fit`, and `object-position` are unsupported. |
+| Visual regression | Current | Chromium reference PDF rendering with PNG comparison; generated artifacts are written to `tmp/visual/`. |
+| Pagination and fragmentation | Unsupported | Page breaks, repeated headers/footers, and content overflow across pages are before-1.0 work. |
+| Advanced layout | Unsupported | CSS Grid, positioning, floats, tables, and list markers are not implemented yet. |
+| Advanced painting | Unsupported | Border radius, shadows, gradients, background images, filters, and transforms are not implemented yet. |
+
+## Example-Driven Roadmap
+
+The next rendering milestones are anchored to realistic document families rather
+than abstract CSS checklists. The comparison fixtures in `tmp/pdf_compare/`
+currently show a browser/Chromium render next to SilkLayout output for each
+target. They are temporary evaluation artifacts, but the document types below are
+the product goals they represent.
+
+| Goal document | Current fit | Feature work needed |
+| --- | --- | --- |
+| Plain invoices and receipt-like statements | Closest near-term target. Simple text, spacing, borders, page sizing, and gray bands are mostly in range. | Table layout or robust table-like rows; reliable numeric column alignment; better font-weight handling; footer placement; tighter support for absolute/relative positioning used by headers and payment blocks. |
+| Colorful invoices and branded receipts | Partially reachable when simplified, but decorative layout falls apart quickly. | Stable flex for document components; border radius; layered backgrounds; background images; gradients; better positioned panels; custom or mapped font weights; table row styling including alternating fills. |
+| Government notices and simple pamphlets | Good medium-term target for one-page notices; multi-page publications remain limited. | Multi-column layout; pagination and fragmentation; repeated headers/footers; page counters; column rules; improved text sizing/leading parity; better page-margin and print CSS handling. |
+| Posters and flyers | Useful stress target, but not visually faithful yet. | Absolute positioning; transforms/rotation; border radius and circles; dashed borders; SVG/vector image support; background images/textures; object fitting and image clipping; richer z-index/layering. |
+| Brochures and park/map guides | Long-range target because these combine nearly every hard print feature. | Multi-page spreads; CSS Grid; floats; positioned overlays; clipping/masking; remote and local raster image scaling; SVG/vector paths; map/icon rendering; gradients and blend-like background effects; robust small-text layout. |
+
+Cross-cutting engine work that serves all of these goals:
+
+- Stabilize font resolution and weight/style mapping so common CSS such as
+  `font-weight: bold` never crashes PDF rendering.
+- Make partial flexbox behavior predictable for document layout, then add
+  regression fixtures for invoice headers, side panels, and totals blocks.
+- Add a first-class table layout path before treating real invoices or receipts
+  as supported.
+- Add paged-media primitives: page breaks, content overflow across pages,
+  repeated headers/footers, and page counters.
+- Expand the painter beyond rectangular fills and straight borders: rounded
+  corners, dashed borders, gradients, background images, and image clipping.
+- Support SVG and remote images so real logos, badges, maps, QR codes, and
+  brochure artwork can be rendered without pre-flattening.
+- Keep browser-vs-SilkLayout visual comparison fixtures for each goal document
+  and graduate them into the visual regression suite as features land.
 
 ## Installation
 
@@ -104,6 +130,12 @@ Run tests only:
 bundle exec rake test
 ```
 
+Run visual regression tests:
+
+```sh
+BROWSER_PATH=/path/to/chrome bundle exec ruby -Ilib:test test/visual_test.rb
+```
+
 Run lint:
 
 ```sh
@@ -116,6 +148,19 @@ Run a single test file:
 bundle exec ruby -Ilib:test test/layout/flex_layout_test.rb
 ```
 
+Run a single visual fixture:
+
+```sh
+BROWSER_PATH=/path/to/chrome bundle exec ruby -Ilib:test test/visual_test.rb -n test_visual_flex_row_basic
+```
+
+Build and install the gem into a temporary `GEM_HOME`, then require it and render
+a smoke PDF from the installed package:
+
+```sh
+bundle exec rake package:smoke
+```
+
 Visual regression tests require Chromium or Chrome plus PDF-to-PNG tooling such
 as Poppler or ImageMagick. Generated visual artifacts are written to
 `tmp/visual/`.
@@ -130,9 +175,9 @@ script/release
 ```
 
 The script must be run from a clean, up-to-date `main` branch after the release
-PR is merged. It installs dependencies, runs the test/lint/build gate, publishes
-the gem through Bundler's release task, and creates a GitHub release from the
-matching `CHANGELOG.md` section.
+PR is merged. It installs dependencies, runs the test/lint/package smoke gate,
+publishes the gem through Bundler's release task, and creates a GitHub release
+from the matching `CHANGELOG.md` section.
 
 This gem is still pre-1.0. Before a public 1.0 release, the project should
 stabilize the supported CSS surface, add pagination, improve visual parity, and

data/lib/silk_layout/css/cascade.rb

@@ -29,11 +29,14 @@ module SilkLayout
         style = node.attributes["style"].to_s.strip
         return nil if style.empty?
 
-        declarations = {}
+        declarations = []
         Crass.parse_properties(style).each do |child|
           next unless child[:node] == :property
 
-          declarations[child[:name]] = Declaration.new(value: child[:value], important: child[:important] ? true : false)
+          declarations << [
+            child[:name].to_s.downcase,
+            Declaration.new(value: child[:value].to_s.strip, important: child[:important] ? true : false)
+          ]
         end
 
         Rule.new(

data/lib/silk_layout/css/color.rb

@@ -0,0 +1,415 @@
+# frozen_string_literal: true
+
+module SilkLayout
+  module CSS
+    class Color
+      attr_reader :red,
+        :green,
+        :blue,
+        :alpha,
+        :normalized
+
+      NAMED_COLOR_HEX = {
+        "aliceblue" => "f0f8ff",
+        "antiquewhite" => "faebd7",
+        "aqua" => "00ffff",
+        "aquamarine" => "7fffd4",
+        "azure" => "f0ffff",
+        "beige" => "f5f5dc",
+        "bisque" => "ffe4c4",
+        "black" => "000000",
+        "blanchedalmond" => "ffebcd",
+        "blue" => "0000ff",
+        "blueviolet" => "8a2be2",
+        "brown" => "a52a2a",
+        "burlywood" => "deb887",
+        "cadetblue" => "5f9ea0",
+        "chartreuse" => "7fff00",
+        "chocolate" => "d2691e",
+        "coral" => "ff7f50",
+        "cornflowerblue" => "6495ed",
+        "cornsilk" => "fff8dc",
+        "crimson" => "dc143c",
+        "cyan" => "00ffff",
+        "darkblue" => "00008b",
+        "darkcyan" => "008b8b",
+        "darkgoldenrod" => "b8860b",
+        "darkgray" => "a9a9a9",
+        "darkgreen" => "006400",
+        "darkgrey" => "a9a9a9",
+        "darkkhaki" => "bdb76b",
+        "darkmagenta" => "8b008b",
+        "darkolivegreen" => "556b2f",
+        "darkorange" => "ff8c00",
+        "darkorchid" => "9932cc",
+        "darkred" => "8b0000",
+        "darksalmon" => "e9967a",
+        "darkseagreen" => "8fbc8f",
+        "darkslateblue" => "483d8b",
+        "darkslategray" => "2f4f4f",
+        "darkslategrey" => "2f4f4f",
+        "darkturquoise" => "00ced1",
+        "darkviolet" => "9400d3",
+        "deeppink" => "ff1493",
+        "deepskyblue" => "00bfff",
+        "dimgray" => "696969",
+        "dimgrey" => "696969",
+        "dodgerblue" => "1e90ff",
+        "firebrick" => "b22222",
+        "floralwhite" => "fffaf0",
+        "forestgreen" => "228b22",
+        "fuchsia" => "ff00ff",
+        "gainsboro" => "dcdcdc",
+        "ghostwhite" => "f8f8ff",
+        "gold" => "ffd700",
+        "goldenrod" => "daa520",
+        "gray" => "808080",
+        "green" => "008000",
+        "greenyellow" => "adff2f",
+        "grey" => "808080",
+        "honeydew" => "f0fff0",
+        "hotpink" => "ff69b4",
+        "indianred" => "cd5c5c",
+        "indigo" => "4b0082",
+        "ivory" => "fffff0",
+        "khaki" => "f0e68c",
+        "lavender" => "e6e6fa",
+        "lavenderblush" => "fff0f5",
+        "lawngreen" => "7cfc00",
+        "lemonchiffon" => "fffacd",
+        "lightblue" => "add8e6",
+        "lightcoral" => "f08080",
+        "lightcyan" => "e0ffff",
+        "lightgoldenrodyellow" => "fafad2",
+        "lightgray" => "d3d3d3",
+        "lightgreen" => "90ee90",
+        "lightgrey" => "d3d3d3",
+        "lightpink" => "ffb6c1",
+        "lightsalmon" => "ffa07a",
+        "lightseagreen" => "20b2aa",
+        "lightskyblue" => "87cefa",
+        "lightslategray" => "778899",
+        "lightslategrey" => "778899",
+        "lightsteelblue" => "b0c4de",
+        "lightyellow" => "ffffe0",
+        "lime" => "00ff00",
+        "limegreen" => "32cd32",
+        "linen" => "faf0e6",
+        "magenta" => "ff00ff",
+        "maroon" => "800000",
+        "mediumaquamarine" => "66cdaa",
+        "mediumblue" => "0000cd",
+        "mediumorchid" => "ba55d3",
+        "mediumpurple" => "9370db",
+        "mediumseagreen" => "3cb371",
+        "mediumslateblue" => "7b68ee",
+        "mediumspringgreen" => "00fa9a",
+        "mediumturquoise" => "48d1cc",
+        "mediumvioletred" => "c71585",
+        "midnightblue" => "191970",
+        "mintcream" => "f5fffa",
+        "mistyrose" => "ffe4e1",
+        "moccasin" => "ffe4b5",
+        "navajowhite" => "ffdead",
+        "navy" => "000080",
+        "oldlace" => "fdf5e6",
+        "olive" => "808000",
+        "olivedrab" => "6b8e23",
+        "orange" => "ffa500",
+        "orangered" => "ff4500",
+        "orchid" => "da70d6",
+        "palegoldenrod" => "eee8aa",
+        "palegreen" => "98fb98",
+        "paleturquoise" => "afeeee",
+        "palevioletred" => "db7093",
+        "papayawhip" => "ffefd5",
+        "peachpuff" => "ffdab9",
+        "peru" => "cd853f",
+        "pink" => "ffc0cb",
+        "plum" => "dda0dd",
+        "powderblue" => "b0e0e6",
+        "purple" => "800080",
+        "rebeccapurple" => "663399",
+        "red" => "ff0000",
+        "rosybrown" => "bc8f8f",
+        "royalblue" => "4169e1",
+        "saddlebrown" => "8b4513",
+        "salmon" => "fa8072",
+        "sandybrown" => "f4a460",
+        "seagreen" => "2e8b57",
+        "seashell" => "fff5ee",
+        "sienna" => "a0522d",
+        "silver" => "c0c0c0",
+        "skyblue" => "87ceeb",
+        "slateblue" => "6a5acd",
+        "slategray" => "708090",
+        "slategrey" => "708090",
+        "snow" => "fffafa",
+        "springgreen" => "00ff7f",
+        "steelblue" => "4682b4",
+        "tan" => "d2b48c",
+        "teal" => "008080",
+        "thistle" => "d8bfd8",
+        "tomato" => "ff6347",
+        "turquoise" => "40e0d0",
+        "violet" => "ee82ee",
+        "wheat" => "f5deb3",
+        "white" => "ffffff",
+        "whitesmoke" => "f5f5f5",
+        "yellow" => "ffff00",
+        "yellowgreen" => "9acd32"
+      }.freeze
+
+      NAMED_COLORS = NAMED_COLOR_HEX.transform_values do |hex|
+        hex.scan(/../).map { |component| component.to_i(16) }
+      end.freeze
+
+      FUNCTION_PATTERN = /\A([a-z]+)\((.*)\)\z/
+      NUMBER_PATTERN = /\A[-+]?(?:\d+\.?\d*|\.\d+)\z/
+
+      def self.parse(value)
+        return value if value.is_a?(self)
+
+        raw = value.to_s.strip
+        return nil if raw.empty?
+
+        normalized = raw.downcase
+        return new(0, 0, 0, alpha: 0, normalized: "transparent") if normalized == "transparent"
+
+        if (rgb = NAMED_COLORS[normalized])
+          return new(*rgb, normalized: normalized)
+        end
+
+        return parse_hex(normalized) if normalized.start_with?("#")
+
+        match = normalized.match(FUNCTION_PATTERN)
+        return nil unless match
+
+        case match[1]
+        when "rgb", "rgba"
+          parse_rgb_function(match[1], match[2], normalized)
+        when "hsl", "hsla"
+          parse_hsl_function(match[1], match[2], normalized)
+        end
+      end
+
+      # The renderer currently paints RGB only. Alpha is kept on parsed colors;
+      # conversion treats fully transparent colors as not paintable and ignores
+      # partial alpha as a best-effort fallback.
+      def self.rgb(value)
+        color = parse(value)
+        return nil unless color
+        return nil if color.transparent?
+
+        color.rgb
+      end
+
+      def initialize(red, green, blue, normalized:, alpha: 1.0)
+        @red = clamp_byte(red)
+        @green = clamp_byte(green)
+        @blue = clamp_byte(blue)
+        @alpha = clamp_unit(alpha)
+        @normalized = normalized
+      end
+
+      def rgb
+        [red, green, blue]
+      end
+
+      def transparent?
+        alpha <= 0
+      end
+
+      def to_sym
+        normalized.to_sym
+      end
+
+      def to_s
+        normalized
+      end
+
+      def self.parse_hex(value)
+        hex = value.delete_prefix("#")
+        return nil unless hex.match?(/\A(?:[0-9a-f]{3}|[0-9a-f]{6})\z/)
+
+        expanded = (hex.length == 3) ? hex.chars.flat_map { |char| [char, char] }.join : hex
+        new(*expanded.scan(/../).map { |component| component.to_i(16) }, normalized: value)
+      end
+      private_class_method :parse_hex
+
+      def self.parse_rgb_function(name, content, normalized)
+        components = split_function_arguments(content)
+        return nil unless [3, 4].include?(components.length)
+        return nil if name == "rgba" && components.length < 4
+
+        red = parse_rgb_component(components[0])
+        green = parse_rgb_component(components[1])
+        blue = parse_rgb_component(components[2])
+        alpha = components[3] ? parse_alpha(components[3]) : 1
+        return nil if [red, green, blue, alpha].any?(&:nil?)
+
+        new(red, green, blue, alpha: alpha, normalized: normalized)
+      end
+      private_class_method :parse_rgb_function
+
+      def self.parse_hsl_function(name, content, normalized)
+        components = split_function_arguments(content)
+        return nil unless [3, 4].include?(components.length)
+        return nil if name == "hsla" && components.length < 4
+
+        hue = parse_hue(components[0])
+        saturation = parse_percentage(components[1])
+        lightness = parse_percentage(components[2])
+        alpha = components[3] ? parse_alpha(components[3]) : 1
+        return nil if [hue, saturation, lightness, alpha].any?(&:nil?)
+
+        new(*hsl_to_rgb(hue, saturation, lightness), alpha: alpha, normalized: normalized)
+      end
+      private_class_method :parse_hsl_function
+
+      def self.split_function_arguments(content)
+        raw = content.to_s.strip
+        return [] if raw.empty?
+
+        parts =
+          if raw.include?(",")
+            raw.split(",").map(&:strip)
+          else
+            values, alpha = raw.split("/", 2).map(&:strip)
+            values.to_s.split(/\s+/).tap { |items| items << alpha if alpha }
+          end
+
+        if parts.last&.include?("/")
+          value, alpha = parts.pop.split("/", 2).map(&:strip)
+          parts << value
+          parts << alpha
+        end
+
+        parts
+      end
+      private_class_method :split_function_arguments
+
+      def self.parse_rgb_component(value)
+        raw = value.to_s.strip
+        if raw.end_with?("%")
+          percentage = parse_number(raw.delete_suffix("%"))
+          return nil unless percentage
+
+          clamp_byte(percentage * 255 / 100.0)
+        else
+          number = parse_number(raw)
+          return nil unless number
+
+          clamp_byte(number)
+        end
+      end
+      private_class_method :parse_rgb_component
+
+      def self.parse_alpha(value)
+        raw = value.to_s.strip
+        if raw.end_with?("%")
+          percentage = parse_number(raw.delete_suffix("%"))
+          return nil unless percentage
+
+          clamp_unit(percentage / 100.0)
+        else
+          number = parse_number(raw)
+          return nil unless number
+
+          clamp_unit(number)
+        end
+      end
+      private_class_method :parse_alpha
+
+      def self.parse_hue(value)
+        raw = value.to_s.strip
+        multiplier =
+          if raw.end_with?("turn")
+            raw = raw.delete_suffix("turn")
+            360
+          elsif raw.end_with?("deg")
+            raw = raw.delete_suffix("deg")
+            1
+          elsif raw.end_with?("rad")
+            raw = raw.delete_suffix("rad")
+            180 / Math::PI
+          else
+            1
+          end
+
+        number = parse_number(raw)
+        return nil unless number
+
+        (number * multiplier) % 360
+      end
+      private_class_method :parse_hue
+
+      def self.parse_percentage(value)
+        raw = value.to_s.strip
+        return nil unless raw.end_with?("%")
+
+        number = parse_number(raw.delete_suffix("%"))
+        return nil unless number
+
+        clamp_unit(number / 100.0)
+      end
+      private_class_method :parse_percentage
+
+      def self.parse_number(value)
+        raw = value.to_s.strip
+        return nil unless raw.match?(NUMBER_PATTERN)
+
+        raw.to_f
+      end
+      private_class_method :parse_number
+
+      def self.hsl_to_rgb(hue, saturation, lightness)
+        chroma = (1 - ((2 * lightness) - 1).abs) * saturation
+        hue_segment = hue / 60.0
+        x = chroma * (1 - ((hue_segment % 2) - 1).abs)
+        match = lightness - (chroma / 2)
+
+        red, green, blue =
+          case hue_segment
+          when 0...1
+            [chroma, x, 0]
+          when 1...2
+            [x, chroma, 0]
+          when 2...3
+            [0, chroma, x]
+          when 3...4
+            [0, x, chroma]
+          when 4...5
+            [x, 0, chroma]
+          else
+            [chroma, 0, x]
+          end
+
+        [
+          clamp_byte((red + match) * 255),
+          clamp_byte((green + match) * 255),
+          clamp_byte((blue + match) * 255)
+        ]
+      end
+      private_class_method :hsl_to_rgb
+
+      def self.clamp_byte(value)
+        value.to_f.round.clamp(0, 255)
+      end
+      private_class_method :clamp_byte
+
+      def self.clamp_unit(value)
+        value.to_f.clamp(0, 1)
+      end
+      private_class_method :clamp_unit
+
+      def clamp_byte(value)
+        value.to_f.round.clamp(0, 255)
+      end
+
+      def clamp_unit(value)
+        value.to_f.clamp(0, 1)
+      end
+    end
+  end
+end