klenod-build 0.0.1

data/lib/klenod/build/source_map/vlq.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Klenod
+  module Build
+    module SourceMap
+      module VLQ
+        BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"
+        BASE64_VALUES = BASE64_CHARS.each_char.with_index.to_h.freeze
+        CONTINUATION_BIT = 32
+        VALUE_MASK = 31
+
+        module_function
+
+        def decode(segment)
+          values = []
+          value = 0
+          shift = 0
+
+          segment.each_char do |char|
+            digit = BASE64_VALUES.fetch(char)
+            continuation = (digit & CONTINUATION_BIT) != 0
+            digit &= VALUE_MASK
+            value += digit << shift
+
+            if continuation
+              shift += 5
+            else
+              values << from_vlq_signed(value)
+              value = 0
+              shift = 0
+            end
+          end
+
+          values
+        end
+
+        def encode(values)
+          values.map { encode_value(it) }.join
+        end
+
+        def encode_value(value)
+          vlq = to_vlq_signed(value)
+          encoded = +""
+
+          loop do
+            digit = vlq & VALUE_MASK
+            vlq >>= 5
+            digit |= CONTINUATION_BIT if vlq > 0
+            encoded << BASE64_CHARS[digit]
+            break if vlq == 0
+          end
+
+          encoded
+        end
+
+        def to_vlq_signed(value)
+          (value < 0) ? ((-value) << 1) + 1 : value << 1
+        end
+
+        def from_vlq_signed(value)
+          negative = (value & 1) == 1
+          shifted = value >> 1
+          negative ? -shifted : shifted
+        end
+      end
+    end
+  end
+end

data/lib/klenod/build/source_map.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative "source_map/editor"
+require_relative "source_map/map"
+require_relative "source_map/vlq"
+
+module Klenod
+  module Build
+    module SourceMap
+    end
+  end
+end

data/lib/klenod/build/transform_result.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Klenod
+  module Build
+    TransformResult =
+      Data.define(:code, :dependencies, :source_map, :assets, :watched_patterns, :metadata) do
+        def self.identity(code)
+          new(code, [], nil, [], [], {})
+        end
+      end
+  end
+end

data/lib/klenod/build/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Klenod
+  module Build
+    VERSION = "0.0.1"
+  end
+end

data/lib/klenod/build/watched_pattern.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Klenod
+  module Build
+    WatchedPattern = Data.define(:importer_id, :glob, :kind, :metadata) do
+      def match?(path)
+        File.fnmatch?(glob, path, File::FNM_PATHNAME | File::FNM_EXTGLOB)
+      end
+    end
+  end
+end

data/lib/klenod/build/watcher.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require "listen"
+
+module Klenod
+  module Build
+    UpdateEvent = Data.define(:changed_paths, :removed_paths, :graph_version, :result) do
+      def asset_changes
+        result.asset_changes
+      end
+
+      def asset_updates
+        result.asset_updates
+      end
+    end
+
+    class Watcher
+      class PendingChanges
+        def initialize
+          @changed_paths = Set.new
+          @removed_paths = Set.new
+        end
+
+        def add(changed_paths, removed_paths)
+          changed_paths.each do |path|
+            @changed_paths << path
+            @removed_paths.delete(path)
+          end
+
+          removed_paths.each do |path|
+            @removed_paths << path
+            @changed_paths.delete(path)
+          end
+        end
+
+        def empty?
+          @changed_paths.empty? && @removed_paths.empty?
+        end
+
+        def normalized
+          changed_paths = Set.new
+          removed_paths = Set.new
+
+          (@changed_paths + @removed_paths).each do |path|
+            if File.exist?(path)
+              changed_paths << path
+            else
+              removed_paths << path
+            end
+          end
+
+          [changed_paths.to_a.freeze, removed_paths.to_a.freeze]
+        end
+      end
+
+      def initialize(source_dir:, context:, debounce_interval: 0.1)
+        @source_dir = source_dir
+        @context = context
+        @debounce_interval = debounce_interval
+        @graph_version = 0
+        @pending_changes = PendingChanges.new
+        @pending_mutex = Mutex.new
+        @pending_condition = ConditionVariable.new
+        @last_change_at = nil
+        @stopping = false
+      end
+
+      def start
+        @worker_thread = Thread.new { process_pending_updates }
+        @listener =
+          Listen.to(@source_dir) do |modified, added, removed|
+            enqueue_update(modified + added, removed)
+          end
+        @listener.start
+      end
+
+      def stop
+        @listener&.stop
+        @pending_mutex.synchronize do
+          @stopping = true
+          @pending_condition.broadcast
+        end
+        @worker_thread&.join
+      end
+
+      private
+
+      def enqueue_update(changed_paths, removed_paths)
+        @pending_mutex.synchronize do
+          @pending_changes.add(changed_paths, removed_paths)
+          @last_change_at = monotonic_time
+          @pending_condition.signal
+        end
+      end
+
+      def process_pending_updates
+        loop do
+          changed_paths, removed_paths = wait_for_pending_update
+          break unless changed_paths
+
+          emit_update(changed_paths, removed_paths)
+        end
+      end
+
+      def wait_for_pending_update
+        @pending_mutex.synchronize do
+          @pending_condition.wait(@pending_mutex) while !@stopping && @pending_changes.empty?
+          return nil if @stopping
+
+          wait_for_debounce_window
+          return nil if @stopping
+
+          changes = @pending_changes
+          @pending_changes = PendingChanges.new
+          changes.normalized
+        end
+      end
+
+      def wait_for_debounce_window
+        loop do
+          remaining = @debounce_interval - (monotonic_time - @last_change_at)
+          break if remaining <= 0
+
+          @pending_condition.wait(@pending_mutex, remaining)
+          break if @stopping
+        end
+      end
+
+      def emit_update(changed_paths, removed_paths)
+        @graph_version += 1
+        result = @context.invalidate_paths(changed_paths, removed_paths: removed_paths)
+
+        @context.emit_update(UpdateEvent.new(changed_paths, removed_paths, @graph_version, result))
+      end
+
+      def monotonic_time
+        Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      end
+    end
+  end
+end

data/lib/klenod/build.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative "build/version"
+require "klenod/runtime"
+require_relative "build/context"
+
+module Klenod
+  class Error < StandardError; end unless const_defined?(:Error, false)
+
+  module Build
+    autoload :Graphviz, "klenod/build/graphviz"
+    autoload :UpdateEvent, "klenod/build/watcher"
+    autoload :Watcher, "klenod/build/watcher"
+  end
+end

metadata

@@ -0,0 +1,310 @@
+--- !ruby/object:Gem::Specification
+name: klenod-build
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Andrés Alin
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: klenod-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.42'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.42'
+- !ruby/object:Gem::Dependency
+  name: async-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.95.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.95.1
+- !ruby/object:Gem::Dependency
+  name: brotli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: image_size
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: kramdown-parser-gfm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: listen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+- !ruby/object:Gem::Dependency
+  name: protocol-url
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: samovar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: syntax_tree
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.3'
+- !ruby/object:Gem::Dependency
+  name: syntax_tree-haml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: toml-rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: tsort
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+description: Klenod build constructs Ruby module graphs, runs plugins, emits assets,
+  and serializes runtime bundles.
+email:
+- andreas.alin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/klenod/build.rb
+- lib/klenod/build/asset.rb
+- lib/klenod/build/asset_compression.rb
+- lib/klenod/build/asset_generation_queue.rb
+- lib/klenod/build/cli.rb
+- lib/klenod/build/cli/application.rb
+- lib/klenod/build/config.rb
+- lib/klenod/build/context.rb
+- lib/klenod/build/dependency.rb
+- lib/klenod/build/errors.rb
+- lib/klenod/build/filesystem_resolver.rb
+- lib/klenod/build/graph.rb
+- lib/klenod/build/graph/invalidator.rb
+- lib/klenod/build/graphviz.rb
+- lib/klenod/build/hashing.rb
+- lib/klenod/build/invalidation_result.rb
+- lib/klenod/build/load_result.rb
+- lib/klenod/build/loaded_module.rb
+- lib/klenod/build/module_id.rb
+- lib/klenod/build/module_record.rb
+- lib/klenod/build/plugin.rb
+- lib/klenod/build/plugins.rb
+- lib/klenod/build/plugins/class_names_runtime.rb
+- lib/klenod/build/plugins/component_defaults.rb
+- lib/klenod/build/plugins/data_plugin.rb
+- lib/klenod/build/plugins/gem_import_plugin.rb
+- lib/klenod/build/plugins/google_fonts_plugin.rb
+- lib/klenod/build/plugins/google_fonts_plugin/font_metrics.json
+- lib/klenod/build/plugins/google_fonts_plugin/font_metrics.rb
+- lib/klenod/build/plugins/google_fonts_plugin/font_metrics.txt
+- lib/klenod/build/plugins/haml_plugin.rb
+- lib/klenod/build/plugins/haml_plugin/companions.rb
+- lib/klenod/build/plugins/haml_plugin/errors.rb
+- lib/klenod/build/plugins/haml_plugin/helper_source.rb
+- lib/klenod/build/plugins/haml_plugin/parser.rb
+- lib/klenod/build/plugins/haml_plugin/transformer.rb
+- lib/klenod/build/plugins/haml_plugin/transformer/ruby_builder.rb
+- lib/klenod/build/plugins/image_plugin.rb
+- lib/klenod/build/plugins/intl_plugin.rb
+- lib/klenod/build/plugins/markdown_compiler.rb
+- lib/klenod/build/plugins/markdown_plugin.rb
+- lib/klenod/build/plugins/router_plugin.rb
+- lib/klenod/build/plugins/ruby_plugin.rb
+- lib/klenod/build/plugins/svg_plugin.rb
+- lib/klenod/build/profiler.rb
+- lib/klenod/build/resolution_error_formatter.rb
+- lib/klenod/build/resolver.rb
+- lib/klenod/build/ruby_import_rewriter.rb
+- lib/klenod/build/source_map.rb
+- lib/klenod/build/source_map/editor.rb
+- lib/klenod/build/source_map/map.rb
+- lib/klenod/build/source_map/vlq.rb
+- lib/klenod/build/transform_result.rb
+- lib/klenod/build/version.rb
+- lib/klenod/build/watched_pattern.rb
+- lib/klenod/build/watcher.rb
+homepage: https://github.com/aalin/klenod
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/aalin/klenod
+  source_code_uri: https://github.com/aalin/klenod/tree/main/gems/klenod-build
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.6
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: Build graph and plugins for Klenod.
+test_files: []