lithop 0.2.0 → 0.4.0

data/lib/lithop/web/server.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "puma"
+require_relative "app"
+
+module Lithop
+  module Web
+    # Starts the local UI with Puma on the loopback interface.
+    module Server
+      HOST = "127.0.0.1"
+      DEFAULT_PORT = 4567
+
+      module_function
+
+      def run(project_dir:, port: DEFAULT_PORT)
+        application = App.configured(project_dir:)
+        application.run!(bind: HOST, port:, server: :puma)
+      end
+    end
+  end
+end

data/lib/lithop/web/settings_form.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Lithop
+  module Web
+    # Resolves browser form values through the same Settings validation used by the CLI.
+    class SettingsForm
+      FLOAT_FIELDS = %i[
+        width height margin_top margin_right margin_bottom margin_left crop_position_x crop_position_y
+        crop_scale brightness contrast saturation yellow_mix_percent minimum_thickness maximum_thickness pixel_size
+        color_pixel_size nozzle_diameter
+      ].freeze
+      INTEGER_FIELDS = %i[tile_count tile_rows tile_columns color_region_parts].freeze
+      STRING_FIELDS = %i[image_fit tile_layout yellow_mix_color pigment_order].freeze
+      BOOLEAN_FIELDS = %i[suppress_pale_colors separate_z_parts].freeze
+      FIELD_NAMES = (FLOAT_FIELDS + INTEGER_FIELDS + STRING_FIELDS + BOOLEAN_FIELDS).map(&:to_s).freeze
+
+      attr_reader :defaults
+
+      def initialize(project_dir:)
+        @project_dir = File.expand_path(project_dir)
+        @file_settings = SettingsFile.load(File.join(@project_dir, SettingsFile::DEFAULT_PATH)).values
+        @defaults = Settings.new(**@file_settings)
+      end
+
+      def resolve(params)
+        overrides = parse_fields(params)
+        Settings.new(**@file_settings, **overrides)
+      end
+
+      def values(settings = defaults)
+        result = settings.to_h.slice(*Settings::DEFAULTS.keys).transform_keys(&:to_s)
+        result["pigment_order"] = settings.pigment_order.join(",")
+        result
+      end
+
+      private
+
+      def parse_fields(params)
+        values = {}
+        FLOAT_FIELDS.each { |key| assign_number(values, params, key, Float) }
+        INTEGER_FIELDS.each { |key| assign_number(values, params, key, Integer) }
+        STRING_FIELDS.each { |key| values[key] = params[key.to_s] if present?(params[key.to_s]) }
+        BOOLEAN_FIELDS.each { |key| values[key] = params[key.to_s] == "1" }
+        clear_unused_grid(values)
+        values
+      rescue ArgumentError
+        raise ConfigurationError, "settings must contain valid numbers"
+      end
+
+      def assign_number(values, params, key, converter)
+        value = params[key.to_s]
+        return unless present?(value)
+
+        values[key] = converter == Integer ? Integer(value, 10) : Float(value)
+      end
+
+      def clear_unused_grid(values)
+        return if values.fetch(:tile_layout, defaults.tile_layout) == "grid"
+
+        values[:tile_rows] = nil
+        values[:tile_columns] = nil
+      end
+
+      def present?(value) = !value.nil? && !value.to_s.strip.empty?
+    end
+  end
+end

data/lib/lithop/web/settings_library.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "json"
+require "time"
+
+module Lithop
+  module Web
+    # Persists reusable browser settings without changing config/settings.json.
+    # rubocop:disable-next Metrics/ClassLength
+    class SettingsLibrary
+      SCHEMA_VERSION = 1
+      PATH = File.join("config", "ui-settings.json")
+      MAX_NAME_LENGTH = 80
+
+      def initialize(project_dir:, clock: -> { Time.now.utc })
+        @project_dir = File.expand_path(project_dir)
+        @path = File.join(@project_dir, PATH)
+        @clock = clock
+      end
+
+      def read
+        document = load_document
+        {
+          "schema_version" => SCHEMA_VERSION,
+          "presets" => document.fetch("presets").sort.to_h,
+          "draft" => document["draft"]
+        }
+      end
+
+      def save_preset(name, values)
+        update do |document|
+          document.fetch("presets")[validate_name!(name)] = entry(values)
+        end
+      end
+
+      def rename_preset(name, new_name)
+        update do |document|
+          presets = document.fetch("presets")
+          source = presets.delete(validate_name!(name))
+          raise InputError, "preset not found" unless source
+
+          target = validate_name!(new_name)
+          raise InputError, "preset already exists" if presets.key?(target)
+
+          presets[target] = source.merge("updated_at" => timestamp)
+        end
+      end
+
+      def delete_preset(name)
+        update do |document|
+          removed = document.fetch("presets").delete(validate_name!(name))
+          raise InputError, "preset not found" unless removed
+        end
+      end
+
+      def save_draft(values)
+        update { |document| document["draft"] = entry(values) }
+      end
+
+      def delete_draft
+        update { |document| document.delete("draft") }
+      end
+
+      private
+
+      def entry(values)
+        { "settings" => normalize(values), "updated_at" => timestamp }
+      end
+
+      def normalize(values)
+        supplied = values.to_h.slice(*SettingsForm::FIELD_NAMES).transform_values do |value|
+          if value == true
+            "1"
+          elsif value == false
+            ""
+          elsif value.nil?
+            nil
+          else
+            value.to_s
+          end
+        end
+        resolved = SettingsForm.new(project_dir: @project_dir).resolve(supplied)
+        SettingsForm.new(project_dir: @project_dir).values(resolved).slice(*SettingsForm::FIELD_NAMES)
+      end
+
+      def validate_name!(name)
+        value = name.to_s.strip
+        raise InputError, "preset name is required" if value.empty?
+        raise InputError, "preset name is too long" if value.length > MAX_NAME_LENGTH
+        raise InputError, "preset name contains unsupported characters" if value.match?(/[\x00-\x1f\x7f]/)
+
+        value
+      end
+
+      def update
+        FileUtils.mkdir_p(File.dirname(@path))
+        lock_directory = File.join(@project_dir, "build")
+        FileUtils.mkdir_p(lock_directory)
+        lock_path = File.join(lock_directory, ".ui-settings.lock")
+        File.open(lock_path, File::RDWR | File::CREAT, 0o600) do |lock|
+          lock.flock(File::LOCK_EX)
+          document = load_document
+          yield document
+          write_document(document)
+          read
+        end
+      end
+
+      def load_document
+        return empty_document unless File.file?(@path)
+        raise InputError, "UI settings file must not be a symbolic link" if File.symlink?(@path)
+
+        document = JSON.parse(File.read(@path))
+        raise InputError, "unsupported UI settings schema" unless document["schema_version"] == SCHEMA_VERSION
+        raise InputError, "invalid UI settings file" unless document["presets"].is_a?(Hash)
+
+        validate_entries!(document)
+        document
+      rescue JSON::ParserError
+        raise InputError, "invalid UI settings JSON"
+      end
+
+      def validate_entries!(document)
+        document.fetch("presets").each_value { |value| validate_entry!(value) }
+        validate_entry!(document["draft"]) if document["draft"]
+      end
+
+      def validate_entry!(entry)
+        raise InputError, "invalid saved UI settings" unless entry.is_a?(Hash) && entry["settings"].is_a?(Hash)
+
+        unknown = entry.fetch("settings").keys - SettingsForm::FIELD_NAMES
+        raise InputError, "unsupported saved settings: #{unknown.join(", ")}" unless unknown.empty?
+
+        entry["settings"] = normalize(entry.fetch("settings"))
+      end
+
+      def write_document(document)
+        temporary = "#{@path}.tmp-#{Process.pid}"
+        File.open(temporary, "w", 0o600) do |file|
+          file.write(JSON.pretty_generate(document) << "\n")
+          file.flush
+          file.fsync
+        end
+        File.rename(temporary, @path)
+      ensure
+        FileUtils.rm_f(temporary) if temporary
+      end
+
+      def empty_document = { "schema_version" => SCHEMA_VERSION, "presets" => {} }
+      def timestamp = @clock.call.iso8601(6)
+    end
+  end
+end