interfacets 0.1.0 → 0.9.99

data/lib/interfacets/test/js/receivers/timer.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Interfacets
+  module Test
+    module Js
+      module Receivers
+        class Timer
+          include Enumerable
+
+          class Registration
+            attr_reader :ms, :response_payload, :dispatch
+
+            def initialize(ms:, response_payload:, dispatch:)
+              @ms = ms
+              @response_payload = response_payload
+              @dispatch = dispatch
+              @notified = false
+            end
+
+            def notify
+              return if @notified
+              @dispatch.call({ payload: response_payload })
+              @notified = true
+            end
+          end
+
+          attr_reader :name, :registrations
+          def initialize(name:)
+            @name = name
+            @registrations = []
+          end
+
+          def receive(payload:, dispatch:)
+            @dispatch = dispatch
+
+            return if payload.nil?
+            return if payload.empty?
+            return if payload.dig("streams", "default").nil?
+            return if payload.dig("streams", "default").empty?
+
+            event = payload.dig("streams", "default")
+            ms = event["ms"]
+            response_payload = event["response"]
+
+            return unless ms && response_payload
+
+            @registrations << Registration.new(
+              ms: ms,
+              response_payload: response_payload,
+              dispatch: dispatch
+            )
+          end
+
+          def handler
+            self
+          end
+
+          def first
+            registrations.first
+          end
+
+          def last
+            registrations.last
+          end
+
+          def each(&block)
+            registrations.each(&block)
+          end
+
+          def clear
+            @registrations = []
+          end
+        end
+      end
+    end
+  end
+end

data/lib/interfacets/test/js/receivers/url.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Interfacets
+  module Test
+    module Js
+      module Receivers
+        class Url
+          class Handler
+            def initialize(state)
+              @state = state
+            end
+
+            def url
+              url_spec = @state.fetch("urlSpec")
+              base_url = url_spec["url"]
+              query_params = url_spec["queryParams"]
+
+              return base_url if query_params.nil? || query_params.empty?
+
+              uri = URI(base_url)
+              uri.query = URI.encode_www_form(query_params)
+              uri.to_s
+            end
+
+            def redirected_url
+              @state.fetch("redirectSpec")
+            end
+          end
+
+          attr_reader :server, :name, :response_queue
+          def initialize(name:)
+            @name = name
+            @response_queue = []
+          end
+
+          def receive(payload:, dispatch:)
+            @dispatch = dispatch
+
+            return if payload.nil?
+            return if payload.empty?
+            return if payload.dig("streams", "default").nil?
+            return if payload.dig("streams", "default").empty?
+
+            @handler = Handler.new(payload.dig("streams", "default"))
+          end
+
+          def handler
+            @handler
+          end
+
+          def flush_responses
+            response_queue.tap { @response_queue = [] }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/interfacets/test/standard_elements.yml

@@ -0,0 +1,173 @@
+---
+- a
+- abbr
+- address
+- area
+- article
+- aside
+- audio
+- b
+- base
+- bdi
+- bdo
+- blockquote
+- body
+- br
+- button
+- canvas
+- caption
+- cite
+- code
+- col
+- colgroup
+- data
+- datalist
+- dd
+- del
+- details
+- dfn
+- dialog
+- div
+- dl
+- dt
+- em
+- embed
+- fieldset
+- figcaption
+- figure
+- footer
+- form
+- h1
+- h2
+- h3
+- h4
+- h5
+- h6
+- head
+- header
+- hgroup
+- hr
+- html
+- i
+- iframe
+- img
+- input
+- ins
+- kbd
+- label
+- legend
+- li
+- link
+- main
+- map
+- mark
+- menu
+- meta
+- meter
+- nav
+- noscript
+- object
+- ol
+- optgroup
+- option
+- output
+- p
+- picture
+- pre
+- progress
+- q
+- rp
+- rt
+- ruby
+- s
+- samp
+- script
+- section
+- select
+- slot
+- small
+- source
+- span
+- strong
+- style
+- sub
+- summary
+- sup
+- table
+- tbody
+- td
+- template
+- textarea
+- tfoot
+- th
+- thead
+- time
+- title
+- tr
+- track
+- u
+- ul
+- var
+- video
+- wbr
+- animate
+- animatemotion
+- animatetransform
+- circle
+- clippath
+- defs
+- desc
+- discard
+- ellipse
+- feblend
+- fecolormatrix
+- fecomponenttransfer
+- fecomposite
+- feconvolvematrix
+- fediffuselighting
+- fedisplacementmap
+- fedistantlight
+- fedropshadow
+- feflood
+- fefunca
+- fefuncb
+- fefuncg
+- fefuncr
+- fegaussianblur
+- feimage
+- femerge
+- femergenode
+- femorphology
+- feoffset
+- fepointlight
+- fespecularlighting
+- fespotlight
+- fetile
+- feturbulence
+- filter
+- foreignobject
+- g
+- image
+- line
+- lineargradient
+- marker
+- mask
+- metadata
+- mpath
+- path
+- pattern
+- polygon
+- polyline
+- radialgradient
+- rect
+- script
+- set
+- stop
+- svg
+- switch
+- symbol
+- text
+- textpath
+- tspan
+- use
+- view

data/lib/interfacets/test/ui_simulator.rb

@@ -0,0 +1,75 @@
+
+module Interfacets
+  module Test
+    class UiSimulator
+      TYPES = {
+        inline: Js::InlineBus,
+        nodo: Js::NodoBus,
+        mruby_wasm: Js::NodoBus,
+      }
+
+      attr_reader :system_json, :router, :type, :contract_path, :validation
+      def initialize(type:, bus:, router:, contract_path: nil, validation: :strict)
+        unless TYPES.keys.include?(type)
+          raise ArgumentError.new(
+            "type: #{type.inspect} not allowed. Must be one of #{TYPES.keys}"
+          )
+        end
+
+        @type = type
+        # Serialize and deserialize to ensure proper data structure for JS
+        @system_json = JSON.parse(bus.client_system_json(only_facets: type == :inline).to_json)
+        @router = router
+        @contract_path = contract_path
+        @validation = validation
+      end
+
+      def visit(path)
+        js.init(
+          hydrated_facet: router.call(path).render
+        )
+      end
+
+      def c(channel_id)
+        js.handler(channel_id)
+      end
+
+      def dispatch(channel_id, event)
+        js.dispatch(channel_id, event)
+      end
+
+      def url
+        c("url")
+      end
+
+      def dom
+        c("dom")
+      end
+
+      def timers
+        c("timer")
+      end
+
+      private
+
+      def js
+        @js ||= (
+          validation_engine = if contract_path
+            ValidationEngine.new(ComponentRegistry.load(contract_path), validation_mode: validation)
+          end
+
+          js_api = Test::Js::Receivers::Api.new(name: "interfacets:api", router:)
+          js_react = Test::Js::Receivers::React.new(name: "dom", validation_engine:)
+          js_url = Test::Js::Receivers::Url.new(name: "url")
+          js_timer = Test::Js::Receivers::Timer.new(name: "timer")
+          receivers = [js_api, js_react, js_url, js_timer]
+
+          TYPES.fetch(type).new(
+            receiver_index: receivers.map { [_1.name, _1] }.to_h,
+            client_system_json: system_json,
+          )
+        )
+      end
+    end
+  end
+end

data/lib/interfacets/test/validation_engine.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require "json_schemer"
+require "set"
+require "yaml"
+
+module Interfacets
+  module Test
+    class ValidationEngine
+      attr_reader :registry, :validation_mode
+
+      @warned_components = Set.new
+
+      def self.warned_components
+        @warned_components
+      end
+
+      def self.reset_warnings!
+        @warned_components.clear
+      end
+
+      def initialize(registry = ComponentRegistry.load, validation_mode: :strict)
+        @registry = registry
+        @validation_mode = validation_mode
+      end
+
+      def active?
+        registry.contracts.any?
+      end
+
+      def validate_props(component_name, props)
+        return unless active?
+
+        contract = registry.find_component(component_name)
+        is_standard = standard_element?(component_name)
+
+        props_config = contract&.dig("props")
+
+        if is_standard
+          return unless props_config
+        else
+          return unless contract_exists?(component_name)
+
+          raise ValidationError, "Missing props schema for custom component: #{component_name}" unless props_config
+        end
+
+        schema = { "type" => "object", "properties" => props_config }
+        validate!(schema, props, "properties for #{component_name}")
+      end
+
+      def validate_event(component_name, event_name, payload)
+        return unless active?
+
+        contract = registry.find_component(component_name)
+        is_standard = standard_element?(component_name)
+
+        event_config = contract&.dig("props", event_name.to_s)
+
+        if is_standard
+          return unless event_config
+        else
+          return unless contract_exists?(component_name)
+
+          raise ValidationError, "Missing events schema for custom component: #{component_name}" unless contract.key?("props")
+          raise ValidationError, "Missing event schema for '#{event_name}' in custom component: #{component_name}" unless event_config
+        end
+
+        schema = event_config.is_a?(Hash) ? (event_config["payload"] || {}) : {}
+
+        validate!(schema, payload, "event '#{event_name}' for #{component_name}")
+      end
+
+      private
+
+      def standard_element?(component_name)
+        @standard_elements ||= begin
+          yaml_path = File.expand_path("standard_elements.yml", __dir__)
+          Set.new(YAML.load_file(yaml_path).map(&:to_s))
+        end
+        @standard_elements.include?(component_name.to_s)
+      end
+
+      def contract_exists?(component_name)
+        contract = registry.find_component(component_name)
+        return true if contract
+
+        case validation_mode
+        when :strict
+          raise MissingComponentContractError, "Missing component contract for: #{component_name}"
+        when :warn
+          unless self.class.warned_components.include?(component_name)
+            warn "Warning: Missing component contract for: #{component_name}"
+            self.class.warned_components << component_name
+          end
+          false
+        when :permissive
+          false
+        else
+          raise ArgumentError, "Unknown validation_mode: #{validation_mode}"
+        end
+      end
+
+      def find_contract!(name)
+        contract = registry.find_component(name)
+        return contract if contract
+
+        raise MissingComponentContractError, "Missing component contract for: #{name}"
+      end
+
+      def validate!(schema, data, context)
+        full_schema = schema.dup
+        if full_schema["type"] == "object" && !full_schema.key?("additionalProperties")
+          full_schema["additionalProperties"] = false
+        end
+        full_schema["definitions"] = registry.definitions if registry.definitions.any?
+
+        schemer = JSONSchemer.schema(full_schema, keywords: {
+          "is_event" => lambda do |instance, keyword_value, pointer|
+            return true unless keyword_value
+            unless instance.is_a?(Hash) && instance.key?("type") && instance.key?("payload")
+              return [false, "missing 'type' or 'payload'"]
+            end
+
+            prop_name = pointer.split("/").last
+            prop_schema = full_schema.dig("properties", prop_name)
+            if prop_schema && (nested_schema = prop_schema["schema"])
+              nested_schemer = JSONSchemer.schema(nested_schema)
+              nested_errors = nested_schemer.validate(instance["payload"]).to_a
+              if nested_errors.any?
+                return [false, "event payload validation failed: #{nested_errors.map { |e| "#{e['data_pointer']}: #{e['type']} #{e['details']}" }.join(', ')}"]
+              end
+            end
+
+            true
+          end
+        })
+
+        errors = schemer.validate(data).to_a
+
+        return if errors.empty?
+
+        message = "Validation failed for #{context}:\n"
+        errors.each do |error|
+          message += "  - #{error['data_pointer']}: #{error['type']} #{error['details']}\n"
+        end
+
+        raise ValidationError, message
+      end
+    end
+  end
+end

data/lib/interfacets/test.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Interfacets
+  module Test
+    module H
+      module_function
+
+      def j(hash)
+        JSON.parse(hash.to_json)
+      end
+    end
+  end
+end

data/lib/interfacets/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Interfacets
-  VERSION = "0.1.0"
+  VERSION = "0.9.99"
 end

data/lib/interfacets.rb

@@ -1,8 +1,35 @@
 # frozen_string_literal: true
 
-require_relative "interfacets/version"
+require "zeitwerk"
+require "active_support/concern"
 
 module Interfacets
+  class << self
+    def reload
+      loader.reload
+    end
+
+    def loader
+      @loader ||= (
+        Zeitwerk::Loader
+          .for_gem
+          .tap { _1.ignore("#{__dir__}/interfacets/mruby") }
+          .tap { _1.ignore("#{__dir__}/interfacets/client/utils") }
+          .tap { _1.enable_reloading if enable_reloading? }
+          .tap(&:setup)
+      )
+    end
+
+    def enable_reloading?
+      $interfacets_dev_mode
+    end
+  end
+
   class Error < StandardError; end
-  # Your code goes here...
+  class ValidationError < Error; end
+  class MissingComponentContractError < Error; end
+end
+
+unless Interfacets.enable_reloading?
+  Interfacets.loader
 end