vident 1.0.2 → 2.0.1

data/lib/vident2/phlex/html.rb

@@ -1,84 +0,0 @@
-# frozen_string_literal: true
-
-require "set"
-
-module Vident2
-  module Phlex
-    class HTML < ::Phlex::HTML
-      include ::Vident2::Component
-
-      STANDARD_ELEMENTS = %i[
-        a abbr address article aside b bdi bdo blockquote body button caption
-        cite code colgroup data datalist dd del details dfn dialog div dl dt
-        em fieldset figcaption figure footer form g h1 h2 h3 h4 h5 h6 head
-        header hgroup html i iframe ins kbd label legend li main map mark
-        menuitem meter nav noscript object ol optgroup option output p path
-        picture pre progress q rp rt ruby s samp script section select slot
-        small span strong style sub summary sup svg table tbody td template_tag
-        textarea tfoot th thead time title tr u ul video wbr
-      ].freeze
-      VOID_ELEMENTS = %i[area br embed hr img input link meta param source track col].freeze
-      VALID_TAGS = Set[*(STANDARD_ELEMENTS + VOID_ELEMENTS)].freeze
-
-      class << self
-        # Capture the subclass's defining `.rb` path at class-definition
-        # time so Caching#cache_component_modified_time can read its mtime.
-        # Walks caller_locations to skip the `inherited` frame itself.
-        def inherited(subclass)
-          loc = caller_locations(1, 10).reject { |l| l.label == "inherited" }[0]
-          subclass.component_source_file_path = loc&.path
-          super
-        end
-
-        attr_accessor :component_source_file_path
-
-        def cache_component_modified_time
-          path = component_source_file_path
-          raise StandardError, "No component source file exists #{path}" unless path && ::File.exist?(path)
-          ::File.mtime(path).to_i.to_s
-        end
-      end
-
-      # Phlex lifecycle hook: resolve stimulus DSL procs now that
-      # `view_context` / `helpers` are wired. Procs declared in the DSL
-      # stayed unresolved at `after_initialize`; this is where they run.
-      def before_template
-        resolve_stimulus_attributes_at_render_time
-        super
-      end
-
-      # Block-capture-first so children initialising inside the block can
-      # mutate THIS instance's Draft (outlet-host pattern). After the
-      # block returns, we seal the Draft and emit the tag.
-      def root_element(**overrides, &block)
-        tag_type = root_element_tag_type
-        check_valid_html_tag!(tag_type)
-        if block
-          content = capture(self, &block).html_safe
-          options = build_root_element_attributes(overrides)
-          send(tag_type, **options) { content }
-        else
-          options = build_root_element_attributes(overrides)
-          send(tag_type, **options)
-        end
-      end
-
-      private
-
-      def check_valid_html_tag!(tag_name)
-        return if VALID_TAGS.include?(tag_name)
-        raise ArgumentError,
-          "Unsupported HTML tag name #{tag_name}. Valid tags are: #{VALID_TAGS.to_a.join(", ")}"
-      end
-
-      # Phlex tag DSL emits open-close pairs for non-void tags and
-      # self-closing for void tags automatically, so we just forward.
-      def generate_child_element(tag_name, stimulus_data_attributes, options, &block)
-        check_valid_html_tag!(tag_name)
-        options[:data] ||= {}
-        options[:data].merge!(stimulus_data_attributes)
-        send(tag_name, **options, &block)
-      end
-    end
-  end
-end

data/lib/vident2/phlex.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require "phlex"
-require "vident2/phlex/html"
-
-module Vident2
-  module Phlex
-  end
-end

data/lib/vident2/stimulus/controller.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-require "literal"
-require_relative "naming"
-
-module Vident2
-  module Stimulus
-    # `data-controller` fragment. Fields:
-    # - `path`    : raw underscored path (e.g. `"admin/user_card_component"`)
-    # - `name`    : dasherized/joined form (e.g. `"admin--user-card-component"`)
-    # - `alias_name`: optional Symbol the DSL uses to refer back to this
-    #   controller from other entries (`action(:save, on: :admin)`).
-    class Controller < ::Literal::Data
-      prop :path, String
-      prop :name, String
-      prop :alias_name, _Nilable(Symbol), default: nil
-
-      # `.parse(path = nil, as: nil, implied:)`
-      #
-      # No positional arg -> clone the implied controller (for unambiguous
-      # "refer to my own controller" use).
-      #
-      # One positional arg (String | Symbol) -> explicit controller path.
-      # `implied:` is unused in that branch but is accepted for uniformity
-      # with the other kinds' `.parse` signatures.
-      def self.parse(*args, as: nil, implied:, component_id: nil)
-        case args.size
-        when 0
-          new(path: implied.path, name: implied.name, alias_name: as)
-        when 1
-          raw = args[0]
-          path = raw.to_s
-          new(path: path, name: Naming.stimulize_path(path), alias_name: as)
-        else
-          raise ::Vident2::ParseError, "Controller.parse: expected 0 or 1 positional args, got #{args.size}"
-        end
-      end
-
-      def identifier = name
-
-      def to_s = name
-
-      def to_data_pair = [:controller, name]
-
-      def to_h = {controller: name}
-      # Ruby's `{**x}` splat calls #to_hash; alias so users can splat the
-      # data-attr pair directly into a tag's `data:` option.
-      alias_method :to_hash, :to_h
-
-      # Space-joined. Order preserved, duplicates kept (caller dedups).
-      def self.to_data_hash(controllers)
-        return {} if controllers.empty?
-        joined = controllers.map(&:name).reject(&:empty?).join(" ")
-        return {} if joined.empty?
-        {controller: joined}
-      end
-    end
-  end
-end

data/lib/vident2/stimulus/naming.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require "active_support/core_ext/string/inflections"
-
-module Vident2
-  module Stimulus
-    # Pure naming helpers shared across value classes. No state, no
-    # inheritance — the v1 `StimulusAttributeBase` tree goes away in V2;
-    # each value class is a `Literal::Data` and just calls these module
-    # functions directly.
-    module Naming
-      module_function
-
-      # `"admin/users"` -> `"admin--users"`. Symbol or String accepted.
-      def stimulize_path(path)
-        path.to_s.split("/").map(&:dasherize).join("--")
-      end
-
-      # `:my_thing` -> `"myThing"`. Used for action method names and
-      # target names (not for attribute keys, which dasherize instead).
-      def js_name(name)
-        name.to_s.camelize(:lower)
-      end
-    end
-  end
-end

data/lib/vident2/stimulus/null.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-module Vident2
-  module Stimulus
-    # Sentinel that serialises to the literal string "null". Use in
-    # `value` / `param` positions where the Stimulus side expects a
-    # JSON-parsed JS `null` (Object / Array value types).
-    #
-    # A bare `nil` drops the attribute entirely. Reach for Null only when
-    # you need an explicit `"null"` in the emitted HTML.
-    Null = Object.new
-    def Null.inspect = "Vident2::Stimulus::Null"
-    def Null.to_s = "null"
-    Null.freeze
-  end
-end

data/lib/vident2/stimulus/value.rb

@@ -1,77 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require "literal"
-require_relative "naming"
-require_relative "controller"
-require_relative "null"
-
-module Vident2
-  module Stimulus
-    # `data-<ctrl>-<name>-value` fragment. Holds the *serialised* form
-    # (always a String post-parse); Array/Hash inputs go through `to_json`,
-    # other non-nil inputs through `to_s`. The `Null` sentinel's `to_s`
-    # produces `"null"` naturally. Only `nil` drops at the caller —
-    # `false`, blank strings, and empty collections emit their serialised
-    # form.
-    class Value < ::Literal::Data
-      prop :controller, Controller
-      prop :name, String
-      prop :serialized, String
-
-      # `.parse(*args, implied:)` grammar:
-      #   (Symbol, raw)           -> implied controller, value named `Symbol`
-      #   (String, Symbol, raw)   -> explicit (controller_path, name, raw)
-      #
-      # The caller (Resolver / mutator) is responsible for filtering out
-      # `nil` before reaching here — see `serialize` for the check.
-      def self.parse(*args, implied:, component_id: nil)
-        case args
-        in [Symbol => name_sym, raw]
-          new(
-            controller: implied,
-            name: name_sym.to_s.dasherize,
-            serialized: serialize(raw)
-          )
-        in [String => ctrl_path, Symbol => name_sym, raw]
-          new(
-            controller: Controller.parse(ctrl_path, implied: implied),
-            name: name_sym.to_s.dasherize,
-            serialized: serialize(raw)
-          )
-        else
-          raise ::Vident2::ParseError, "Value.parse: invalid arguments #{args.inspect}"
-        end
-      end
-
-      # Raw -> String. `Null` sentinel serialises to `"null"` via its
-      # own `to_s`. `nil` should have been filtered upstream; raising
-      # here catches misrouted callers early.
-      def self.serialize(raw)
-        raise ::Vident2::ParseError, "Value.serialize: nil is not serializable — filter nil upstream" if raw.nil?
-        case raw
-        when Array, Hash then raw.to_json
-        else raw.to_s
-        end
-      end
-
-      def to_s = serialized
-
-      def data_attribute_key = :"#{controller.name}-#{name}-value"
-
-      def to_data_pair = [data_attribute_key, serialized]
-
-      def to_h = {data_attribute_key => serialized}
-      alias_method :to_hash, :to_h
-
-      # One entry per Value instance. Later-instance same-key wins on
-      # collision (Hash#merge semantics).
-      def self.to_data_hash(values)
-        values.each_with_object({}) do |v, acc|
-          key, str = v.to_data_pair
-          acc[key] = str
-        end
-      end
-    end
-  end
-end

data/lib/vident2/tailwind.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module Vident2
-  # Thin Tailwind CSS merge integration — exposes a lazy per-thread merger
-  # instance so the ClassListBuilder can collapse conflicting utilities
-  # when ::TailwindMerge::Merger is available.
-  module Tailwind
-    def tailwind_merger
-      return unless tailwind_merge_available?
-      return @tailwind_merger if defined?(@tailwind_merger)
-
-      @tailwind_merger = Thread.current[:vident2_tailwind_merger] ||= ::TailwindMerge::Merger.new
-    end
-
-    def tailwind_merge_available?
-      defined?(::TailwindMerge::Merger) && ::TailwindMerge::Merger.respond_to?(:new)
-    end
-  end
-end

data/lib/vident2/version.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-module Vident2
-  VERSION = "2.0.0.alpha0"
-end

data/lib/vident2/view_component/base.rb

@@ -1,124 +0,0 @@
-# frozen_string_literal: true
-
-require "set"
-
-module Vident2
-  module ViewComponent
-    class Base < ::ViewComponent::Base
-      include ::Vident2::Component
-
-      class << self
-        def cache_component_modified_time
-          cache_sidecar_view_modified_time + cache_rb_component_modified_time
-        end
-
-        def cache_sidecar_view_modified_time
-          ::File.exist?(template_path) ? ::File.mtime(template_path).to_i.to_s : ""
-        end
-
-        def cache_rb_component_modified_time
-          ::File.exist?(component_path) ? ::File.mtime(component_path).to_i.to_s : ""
-        end
-
-        def template_path
-          extensions = [".html.erb", ".erb", ".html.haml", ".haml", ".html.slim", ".slim"]
-          base_path = Rails.root.join(components_base_path, virtual_path)
-
-          extensions.each do |ext|
-            potential_path = "#{base_path}#{ext}"
-            return potential_path if File.exist?(potential_path)
-          end
-
-          Rails.root.join(components_base_path, "#{virtual_path}.html.erb").to_s
-        end
-
-        def component_path
-          Rails.root.join(components_base_path, "#{virtual_path}.rb").to_s
-        end
-
-        def components_base_path
-          ::Rails.configuration.view_component.view_component_path || "app/components"
-        end
-      end
-
-      SELF_CLOSING_TAGS = Set[*%i[area base br col embed hr img input link meta param source track wbr]].freeze
-
-      # ViewComponent lifecycle hook: resolve stimulus DSL procs now that
-      # `@view_context` is set (so `helpers` works inside them).
-      def before_render
-        resolve_stimulus_attributes_at_render_time
-        super
-      end
-
-      # Same block-capture-first ordering as the Phlex adapter. Children
-      # instantiated inside the block can still mutate this instance's
-      # Draft (outlet-host pattern) before we seal.
-      def root_element(**overrides, &block)
-        tag_type = root_element_tag_type
-        child_content = view_context.capture(self, &block) if block
-        options = build_root_element_attributes(overrides)
-        if SELF_CLOSING_TAGS.include?(tag_type)
-          view_context.tag(tag_type, options)
-        else
-          view_context.content_tag(tag_type, child_content, options)
-        end
-      end
-
-      # Inline ERB helpers: emit `data-*="..."` attribute strings for the
-      # given stimulus input. Thin wrappers around the plural/singular
-      # parsers — Collection#to_h is the splat target used by v1's helpers
-      # too. Returns an ActiveSupport::SafeBuffer.
-      def as_stimulus_targets(...)  = to_data_attribute_string(**stimulus_targets(...).to_h)
-      def as_stimulus_target(...)   = to_data_attribute_string(**stimulus_target(...).to_h)
-      def as_stimulus_actions(...)  = to_data_attribute_string(**stimulus_actions(...).to_h)
-      def as_stimulus_action(...)   = to_data_attribute_string(**stimulus_action(...).to_h)
-      def as_stimulus_controllers(...) = to_data_attribute_string(**stimulus_controllers(...).to_h)
-      def as_stimulus_controller(...)  = to_data_attribute_string(**stimulus_controller(...).to_h)
-      def as_stimulus_outlets(...)  = to_data_attribute_string(**stimulus_outlets(...).to_h)
-      def as_stimulus_outlet(...)   = to_data_attribute_string(**stimulus_outlet(...).to_h)
-      def as_stimulus_values(...)   = to_data_attribute_string(**stimulus_values(...).to_h)
-      def as_stimulus_value(...)    = to_data_attribute_string(**stimulus_value(...).to_h)
-      def as_stimulus_params(...)   = to_data_attribute_string(**stimulus_params(...).to_h)
-      def as_stimulus_param(...)    = to_data_attribute_string(**stimulus_param(...).to_h)
-      def as_stimulus_classes(...)  = to_data_attribute_string(**stimulus_classes(...).to_h)
-      def as_stimulus_class(...)    = to_data_attribute_string(**stimulus_class(...).to_h)
-
-      # Short aliases — same semantics as the singular `as_stimulus_*` above.
-      alias_method :as_target,     :as_stimulus_target
-      alias_method :as_action,     :as_stimulus_action
-      alias_method :as_controller, :as_stimulus_controller
-      alias_method :as_outlet,     :as_stimulus_outlet
-      alias_method :as_value,      :as_stimulus_value
-      alias_method :as_param,      :as_stimulus_param
-      alias_method :as_class,      :as_stimulus_class
-
-      private
-
-      def generate_child_element(tag_name, stimulus_data_attributes, options, &block)
-        options[:data] ||= {}
-        options[:data].merge!(stimulus_data_attributes)
-        if SELF_CLOSING_TAGS.include?(tag_name.to_sym)
-          view_context.tag(tag_name, options)
-        elsif block
-          view_context.content_tag(tag_name, view_context.capture(&block), options)
-        else
-          view_context.content_tag(tag_name, nil, options)
-        end
-      end
-
-      def escape_attribute_name_for_html(name)
-        name.to_s.gsub(/[^a-zA-Z0-9\-_]/, "").tr("_", "-")
-      end
-
-      def escape_attribute_value_for_html(value)
-        value.to_s.gsub('"', "&quot;").gsub("'", "&#39;")
-      end
-
-      def to_data_attribute_string(**attributes)
-        attributes.map { |key, value| "data-#{escape_attribute_name_for_html(key)}=\"#{escape_attribute_value_for_html(value)}\"" }
-          .join(" ")
-          .html_safe
-      end
-    end
-  end
-end

data/lib/vident2/view_component.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require "view_component"
-require "vident2/view_component/base"
-
-module Vident2
-  module ViewComponent
-  end
-end

data/lib/vident2.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-require "active_support"
-require "active_support/concern"
-require "literal"
-
-require "vident2/version"
-
-# Vident 2.0 — synthesis rearchitecture per doc/reviews/wave-4-synthesis.md.
-# Built side-by-side with Vident 1.x during development; renamed to Vident
-# at release.
-module Vident2
-end
-
-# V1 still ships alongside V2 — Vident::StableId is aliased as
-# Vident2::StableId in lib/vident2/stable_id.rb so the V2 namespace stays
-# self-referential.
-require "vident"
-
-require "vident2/engine" if defined?(Rails::Engine)
-require "vident2/error"
-require "vident2/stable_id"
-
-require "vident2/stimulus/naming"
-require "vident2/stimulus/null"
-require "vident2/stimulus/controller"
-require "vident2/stimulus/action"
-require "vident2/stimulus/target"
-require "vident2/stimulus/outlet"
-require "vident2/stimulus/value"
-require "vident2/stimulus/param"
-require "vident2/stimulus/class_map"
-require "vident2/stimulus/collection"
-require "vident2/internals/registry"
-require "vident2/internals/declaration"
-require "vident2/internals/declarations"
-require "vident2/internals/dsl"
-require "vident2/internals/draft"
-require "vident2/internals/plan"
-require "vident2/internals/resolver"
-require "vident2/internals/attribute_writer"
-require "vident2/internals/class_list_builder"
-
-require "vident2/tailwind"
-require "vident2/caching"
-
-require "vident2/component"
-
-require "vident2/phlex"
-require "vident2/view_component"