jsx_rosetta 0.5.1 → 0.6.0

data/lib/jsx_rosetta/backend/rails_view.rb

@@ -15,7 +15,7 @@ module JsxRosetta
     # source JSX includes inline event handlers, a Stimulus controller is
     # still emitted as a sibling file alongside the .html.erb.
     class RailsView < ViewComponent
-      def emit(component)
+      def emit(component, source_filename: nil) # rubocop:disable Lint/UnusedMethodArgument
         prop_names = component.props.map(&:name)
         prop_names << component.rest_prop_name if component.rest_prop_name
         translator = ExpressionTranslator.new(

data/lib/jsx_rosetta/backend/view_component/expression_translator.rb

@@ -22,6 +22,11 @@ module JsxRosetta
       #     lowering time but not modeled in IR) translate to a `nil`
       #     placeholder with an inline `# TODO: local 'name'` marker — the
       #     file still loads, but the reviewer sees what to fill in.
+      #   * Names in `imported_names` (top-level `import` declarations) are
+      #     treated the same as local bindings — `nil` at leaf position, bail
+      #     at member-chain root. Without this, `styles.listContainer` from
+      #     `import styles from "./X.module.css"` snake-cases to a bare
+      #     `styles` reference that NameErrors at render time.
       #   * Anything else translates to the bare snake_case identifier and
       #     is recorded as unresolved.
       #
@@ -71,16 +76,22 @@ module JsxRosetta
         OPEN_BRACKETS = ["(", "[", "{"].freeze
         CLOSE_BRACKETS = [")", "]", "}"].freeze
 
-        Result = Data.define(:ruby, :unresolved_identifiers)
+        # `promoted_locals` lists names that the condition-mode translator
+        # rendered as `@ivar` despite being known-but-unresolvable locals or
+        # imports (bucket 4 in the resolution rules). The caller is expected
+        # to surface this list in a TODO so a reviewer knows which bindings
+        # need to become controller-passed props.
+        Result = Data.define(:ruby, :unresolved_identifiers, :promoted_locals)
 
         # prop_aliases maps a local-binding name (the alias) to the
         # underlying prop name. `"data-testid": dataTestId` records
         # `{ "dataTestId" => "data-testid" }` so the use site of
         # `dataTestId` resolves to the prop's `@data_testid` ivar.
-        def initialize(prop_names:, local_binding_names: [], prop_aliases: {})
+        def initialize(prop_names:, local_binding_names: [], prop_aliases: {}, imported_names: [])
           @prop_names = prop_names.to_set
           @local_binding_names = local_binding_names.to_set
           @prop_aliases = prop_aliases.dup
+          @imported_names = imported_names.to_set
           @local_stack = []
         end
 
@@ -92,15 +103,48 @@ module JsxRosetta
         end
 
         def translate(source)
+          do_translate(source, condition_mode: false)
+        end
+
+        # Render-condition entry point. Same recursive translator as
+        # `translate`, but bucket-4 hits (known-but-unresolvable locals /
+        # imports) emit `@snake_case` instead of returning `nil` (member-
+        # chain root, unary/binary operand) or `"nil"` (leaf identifier).
+        # The promoted names come back via `Result#promoted_locals` so the
+        # caller can surface a TODO naming the bindings that need to become
+        # controller-passed props.
+        #
+        # Only safe here because driving an `if` with a known-but-nil value
+        # silently disables the branch — destroying the source's intent.
+        # Promoting to an ivar trades silence for a clear render-time error
+        # (NameError on @ivar if the user never threads the prop) that the
+        # accompanying TODO points the reviewer at.
+        def translate_condition(source)
+          do_translate(source, condition_mode: true)
+        end
+
+        private
+
+        def do_translate(source, condition_mode:)
           source = source.strip
           unresolved = []
+          promoted = []
+          previous_mode = @condition_mode
+          previous_promoted = @promoted_locals
+          @condition_mode = condition_mode
+          @promoted_locals = promoted
 
           ruby = translate_ruby(source, unresolved)
-          ruby && Result.new(ruby: ruby, unresolved_identifiers: unresolved.uniq)
+          ruby && Result.new(
+            ruby: ruby,
+            unresolved_identifiers: unresolved.uniq,
+            promoted_locals: promoted.uniq
+          )
+        ensure
+          @condition_mode = previous_mode
+          @promoted_locals = previous_promoted
         end
 
-        private
-
         def translate_ruby(source, unresolved)
           source = unwrap_outer_parens(source.strip)
           translate_simple_form(source, unresolved) || translate_compound_form(source, unresolved)
@@ -335,14 +379,19 @@ module JsxRosetta
             "@#{AST::Inflector.underscore(@prop_aliases[name])}"
           elsif @prop_names.include?(name)
             "@#{snake}"
-          elsif @local_binding_names.include?(name)
-            # We know this binding exists locally (destructure, hook tuple)
-            # but can't model its value. As a leaf identifier, return `nil`
-            # so the file loads (a bare snake_case ref would NameError).
-            # As a member-chain root, `nil.member` would NoMethodError and
-            # the bare-snake fallback would NameError — both crash at render
-            # time. Bail so the whole expression fails translation and the
-            # caller emits a TODO comment with the verbatim source.
+          elsif @local_binding_names.include?(name) || @imported_names.include?(name)
+            # We know this binding exists (destructure, hook tuple, top-level
+            # import) but can't model its value. In `translate_condition`
+            # mode the test is load-bearing — emitting `nil` would silently
+            # false-arm the branch — so promote the binding to an `@ivar`
+            # and record it for the caller's TODO. In default mode, return
+            # `nil` so the file loads (leaf) / bail so the caller emits a
+            # TODO (member-chain root).
+            if @condition_mode
+              @promoted_locals << name
+              return "@#{snake}"
+            end
+
             return nil if member_chain_root
 
             "nil"
@@ -352,16 +401,20 @@ module JsxRosetta
           end
         end
 
-        # An identifier that we know to be a local binding (e.g. destructured
-        # from an untranslatable init) but whose value we can't model. The
-        # leaf-translates-to-nil path is safe in value positions (attribute
-        # kwargs, leaf interpolations) but compound contexts (unary, binary,
-        # member chain) must bail so callers emit a TODO instead of silently
-        # changing semantics.
+        # An identifier we know to be defined locally (destructure, hook
+        # tuple) or pulled in via a top-level `import`, but whose value we
+        # can't model. The leaf-translates-to-nil path is safe in value
+        # positions (attribute kwargs, leaf interpolations) but compound
+        # contexts (unary, binary, member chain) must bail so callers emit
+        # a TODO instead of silently changing semantics.
         def unresolvable_local?(source)
           return false unless source.match?(IDENTIFIER)
+          # In render-condition mode we promote bucket-4 hits to @ivars
+          # (see translate_identifier) — so they aren't unresolvable here.
+          # Skip the bail so unary/binary translation succeeds.
+          return false if @condition_mode
 
-          @local_binding_names.include?(source) &&
+          (@local_binding_names.include?(source) || @imported_names.include?(source)) &&
             !in_local_scope?(source) &&
             !@prop_names.include?(source)
         end

data/lib/jsx_rosetta/backend/view_component.rb

@@ -82,7 +82,7 @@ module JsxRosetta
         @layout = layout
       end
 
-      def emit(component)
+      def emit(component, source_filename: nil) # rubocop:disable Lint/UnusedMethodArgument
         translator = build_translator(component)
         base_name = "#{AST::Inflector.underscore(component.name)}_component"
         @stimulus_identifier = component.stimulus_methods.any? ? stimulus_identifier(component) : nil
@@ -239,7 +239,8 @@ module JsxRosetta
         ExpressionTranslator.new(
           prop_names: prop_names,
           local_binding_names: component.local_binding_names,
-          prop_aliases: prop_aliases
+          prop_aliases: prop_aliases,
+          imported_names: component.module_imports.map(&:name) + component.module_bindings.map(&:name)
         )
       end
 
@@ -911,6 +912,51 @@ module JsxRosetta
         when IR::Interpolation
           translated = translator.translate(value.expression)
           translated ? translated.ruby : "nil # TODO: translate #{value.expression.inspect}"
+        when IR::ComponentInvocation
+          component_invocation_inline_value(value, translator)
+        when IR::Element, IR::Fragment
+          "nil # TODO: couldn't inline JSX value: #{jsx_value_summary(value)}"
+        end
+      end
+
+      # JSX appearing as an attribute value — `icon={<Foo/>}` etc. — lowered
+      # in v0.5.x. Emit a component-instance value (`icon: FooComponent.new`)
+      # so the receiving ViewComponent can `render @icon`. With children we
+      # use Ruby block syntax (`FooComponent.new { ... }`) when the body
+      # fits one line; otherwise we drop with a TODO so the kwarg stays
+      # valid Ruby. Cases requiring a Phlex execution context (IR::Element,
+      # multi-element IR::Fragment) drop with a TODO too — out of MVP scope.
+      def component_invocation_inline_value(invocation, translator)
+        return inline_render_prop_todo if invocation.children.any?(IR::RenderProp)
+
+        kwargs = component_invocation_kwargs(invocation.props, translator)
+        class_name = component_class_name(invocation.name)
+        new_call = kwargs.empty? ? "#{class_name}.new" : "#{class_name}.new(#{kwargs})"
+        return new_call if invocation.children.empty?
+
+        block_body = inline_children_body(invocation.children, translator)
+        return "nil # TODO: couldn't inline JSX value: <#{invocation.name}...>" unless block_body
+
+        "#{new_call} { #{block_body} }"
+      end
+
+      def inline_render_prop_todo
+        "nil # TODO: couldn't inline render-prop value"
+      end
+
+      def inline_children_body(children, translator)
+        rendered = children.map { |c| render_ir_node(c, translator, indent: 0).strip }
+        return nil if rendered.any? { |line| line.include?("\n") }
+
+        joined = rendered.join("; ")
+        joined.empty? || joined.length > 100 ? nil : joined
+      end
+
+      def jsx_value_summary(value)
+        case value
+        when IR::Element then "<#{value.tag}...>"
+        when IR::Fragment then "<>...</>"
+        else "<JSX>"
         end
       end
 

data/lib/jsx_rosetta/cli.rb

@@ -3,6 +3,7 @@
 require "fileutils"
 require "json"
 require "open3"
+require "pathname"
 
 require_relative "node_bridge"
 
@@ -15,6 +16,8 @@ module JsxRosetta
   #                              (default: current directory). TSX is detected
   #                              via the .tsx extension or --tsx.
   #   parse FILE                 Print the parsed Babel AST as pretty JSON.
+  #   pages-routes DIR [-o PATH] Walk a Next.js `pages/` directory and emit a
+  #                              Rails config/routes.rb skeleton.
   #   version                    Print the gem version.
   #   help                       Show usage.
   class CLI
@@ -22,6 +25,43 @@ module JsxRosetta
     EXIT_USAGE = 64
     EXIT_FAILURE = 1
 
+    USAGE_TEXT = <<~USAGE
+      Usage: jsx_rosetta <command> [args]
+
+      Commands:
+        install                    Install the gem's Node sidecar dependencies (runs `npm install`).
+        translate FILE [-o DIR]    Translate JSX/TSX into ViewComponent files in DIR (default: ".").
+                                   Pass --tsx to force TypeScript parsing if the input is .jsx.
+                                   Pass --as=view to emit a Rails view template (`<snake>.html.erb`)
+                                   instead of a ViewComponent class + sidecar template — appropriate
+                                   for pages tied to a route.
+                                   Pass --as=phlex to emit a single-file Phlex 2.x view class
+                                   (`<snake>.rb`) instead of a ViewComponent. Configure the class
+                                   name with --phlex-suffix=Component or --phlex-namespace=Components
+                                   (mutually exclusive; default is bare class name).
+                                   Pass --rails-routes DIR (with --as=phlex) to place the output
+                                   at <controller>/<action>.rb with class
+                                   Views::<Controller>::<Action> < Views::Base, derived from a
+                                   route table scanned out of DIR (a Next.js pages directory).
+        routes FILE [-o OUT.rb]    Parse <Route path=... element={<X/>} /> patterns from FILE
+                                   and emit a reviewable Ruby script that calls `rails generate
+                                   controller` and prints suggested config/routes.rb additions.
+        pages-routes DIR [-o PATH] Walk a Next.js `pages/` directory tree and emit a
+                                   Rails config/routes.rb skeleton derived from the file
+                                   layout. Use --ext .tsx,.jsx,.ts,.js to override the
+                                   default `.tsx,.jsx` filter, and --allow-any-dir to
+                                   skip the `basename == 'pages'` safety check.
+                                   Pass --controllers DIR to also emit one
+                                   `<controller>_controller.rb` per controller in DIR
+                                   (existing files are not overwritten).
+        parse FILE                 Parse the input and print the Babel AST as JSON.
+        version                    Print the gem version.
+        help                       Show this help.
+
+      Environment:
+        JSX_ROSETTA_NODE           Absolute path to a node executable (default: PATH lookup).
+    USAGE
+
     def initialize(argv = ARGV.dup, stdout: $stdout, stderr: $stderr)
       @argv = argv
       @stdout = stdout
@@ -34,6 +74,7 @@ module JsxRosetta
       when "install" then run_install
       when "translate" then run_translate
       when "routes" then run_routes
+      when "pages-routes" then run_pages_routes
       when "parse" then run_parse
       when "version", "-v", "--version" then run_version
       when nil, "help", "-h", "--help" then print_help(EXIT_OK)
@@ -61,6 +102,8 @@ module JsxRosetta
       input_path = positional.first
       return missing_argument("translate FILE", "translate") unless input_path
 
+      resolve_rails_view_route!(options, input_path)
+
       out_dir = options[:out] || "."
       typescript = options[:tsx] || input_path.end_with?(".tsx")
       backend = backend_for_as(options[:as])
@@ -72,7 +115,8 @@ module JsxRosetta
         backend: backend,
         backend_options: backend_options,
         typescript: typescript,
-        source_filename: input_path
+        source_filename: input_path,
+        keep_slot: options[:keep_slot] || false
       )
 
       write_emitted_files(files, out_dir)
@@ -93,7 +137,40 @@ module JsxRosetta
     def backend_options_for(backend, options)
       return {} unless backend == :phlex
 
-      { suffix: options[:phlex_suffix], namespace: options[:phlex_namespace] }.compact
+      base = { suffix: options[:phlex_suffix], namespace: options[:phlex_namespace] }.compact
+      base[:rails_view] = options[:rails_view_route] if options[:rails_view_route]
+      base[:route_table] = options[:route_table] if options[:route_table]
+      base
+    end
+
+    def resolve_rails_view_route!(options, input_path)
+      pages_dir = options[:rails_routes]
+      return unless pages_dir
+
+      raise ArgumentError, "--rails-routes requires --as=phlex" unless options[:as] == "phlex"
+      if options[:phlex_suffix] || options[:phlex_namespace]
+        raise ArgumentError, "--rails-routes cannot be combined with --phlex-suffix or --phlex-namespace"
+      end
+
+      ensure_pages_dir!(pages_dir, allow_any: options[:allow_any_dir])
+      rel = relative_path_under(input_path, pages_dir)
+      raise ArgumentError, "#{input_path} is not under #{pages_dir}" unless rel
+
+      routes, _skipped = PagesRouting.scan(pages_dir, extensions: options[:ext] || PagesRouting::DEFAULT_EXTENSIONS)
+      route = routes.find { |r| r.source_path == rel }
+      raise ArgumentError, "#{rel} has no route in #{pages_dir} (skipped or non-page file?)" unless route
+
+      options[:rails_view_route] = route
+      options[:route_table] = routes
+    end
+
+    def relative_path_under(file_path, dir)
+      file = Pathname.new(File.expand_path(file_path))
+      base = Pathname.new(File.expand_path(dir))
+      rel = file.relative_path_from(base).to_s
+      rel unless rel.start_with?("..")
+    rescue ArgumentError
+      nil
     end
 
     def write_emitted_files(files, out_dir)
@@ -129,6 +206,53 @@ module JsxRosetta
       EXIT_FAILURE
     end
 
+    def run_pages_routes
+      options, positional = parse_translate_options
+      input_dir = positional.first
+      return missing_argument("pages-routes DIR [-o OUT.rb]", "pages-routes") unless input_dir
+
+      ensure_pages_dir!(input_dir, allow_any: options[:allow_any_dir])
+      extensions = options[:ext] || PagesRouting::DEFAULT_EXTENSIONS
+      routes, skipped = PagesRouting.scan(input_dir, extensions: extensions)
+      contents = PagesRouting.emit(routes: routes, skipped: skipped, source_dir: input_dir)
+
+      if options[:out]
+        File.write(options[:out], contents)
+        @stdout.puts "wrote #{options[:out]}"
+      else
+        @stdout.print(contents)
+      end
+
+      write_controllers(routes, options[:controllers]) if options[:controllers]
+      EXIT_OK
+    rescue ArgumentError => e
+      @stderr.puts "jsx_rosetta pages-routes: #{e.message}"
+      EXIT_FAILURE
+    end
+
+    def write_controllers(routes, dir)
+      FileUtils.mkdir_p(dir)
+      PagesRouting.emit_controllers(routes: routes).each do |file|
+        target = File.join(dir, file.path)
+        if File.exist?(target)
+          @stdout.puts "skipped #{target} (exists)"
+        else
+          File.write(target, file.contents)
+          @stdout.puts "wrote #{target}"
+        end
+      end
+    end
+
+    def ensure_pages_dir!(dir, allow_any:)
+      return if allow_any
+      return if File.basename(dir) == "pages"
+      return if File.directory?(File.join(dir, "pages"))
+
+      raise ArgumentError,
+            "#{dir.inspect} does not look like a Next.js pages directory " \
+            "(basename != 'pages' and no nested 'pages/'). Pass --allow-any-dir to override."
+    end
+
     def run_parse
       options, positional = parse_translate_options
       input_path = positional.first
@@ -157,22 +281,59 @@ module JsxRosetta
 
       until @argv.empty?
         arg = @argv.shift
-        case arg
-        when "-o", "--out" then options[:out] = @argv.shift
-        when "--tsx", "--typescript" then options[:tsx] = true
-        when "--as" then options[:as] = @argv.shift
-        when /\A--as=(.+)\z/ then options[:as] = ::Regexp.last_match(1)
-        when "--phlex-suffix" then options[:phlex_suffix] = @argv.shift
-        when /\A--phlex-suffix=(.*)\z/ then options[:phlex_suffix] = ::Regexp.last_match(1)
-        when "--phlex-namespace" then options[:phlex_namespace] = @argv.shift
-        when /\A--phlex-namespace=(.+)\z/ then options[:phlex_namespace] = ::Regexp.last_match(1)
-        else positional << arg
-        end
+        positional << arg unless option_consumed?(arg, options)
       end
 
       [options, positional]
     end
 
+    def option_consumed?(arg, options)
+      consume_translate_option?(arg, options) ||
+        consume_phlex_option?(arg, options) ||
+        consume_pages_routes_option?(arg, options)
+    end
+
+    def consume_translate_option?(arg, options)
+      case arg
+      when "-o", "--out" then options[:out] = @argv.shift
+      when "--tsx", "--typescript" then options[:tsx] = true
+      when "--as" then options[:as] = @argv.shift
+      when /\A--as=(.+)\z/ then options[:as] = ::Regexp.last_match(1)
+      when "--keep-slot" then options[:keep_slot] = true
+      else return false
+      end
+      true
+    end
+
+    def consume_phlex_option?(arg, options)
+      case arg
+      when "--phlex-suffix" then options[:phlex_suffix] = @argv.shift
+      when /\A--phlex-suffix=(.*)\z/ then options[:phlex_suffix] = ::Regexp.last_match(1)
+      when "--phlex-namespace" then options[:phlex_namespace] = @argv.shift
+      when /\A--phlex-namespace=(.+)\z/ then options[:phlex_namespace] = ::Regexp.last_match(1)
+      when "--rails-routes" then options[:rails_routes] = @argv.shift
+      when /\A--rails-routes=(.+)\z/ then options[:rails_routes] = ::Regexp.last_match(1)
+      else return false
+      end
+      true
+    end
+
+    def consume_pages_routes_option?(arg, options)
+      case arg
+      when "--ext" then options[:ext] = parse_ext_list(@argv.shift)
+      when /\A--ext=(.+)\z/ then options[:ext] = parse_ext_list(::Regexp.last_match(1))
+      when "--allow-any-dir" then options[:allow_any_dir] = true
+      when "--controllers" then options[:controllers] = @argv.shift
+      when /\A--controllers=(.+)\z/ then options[:controllers] = ::Regexp.last_match(1)
+      else return false
+      end
+      true
+    end
+
+    def parse_ext_list(value)
+      value.to_s.split(",").map(&:strip).reject(&:empty?).map { |ext| ext.start_with?(".") ? ext : ".#{ext}" }
+    end
+
     def missing_argument(usage, command)
       @stderr.puts "jsx_rosetta #{command}: missing required argument."
       @stderr.puts "  usage: jsx_rosetta #{usage}"
@@ -180,30 +341,7 @@ module JsxRosetta
     end
 
     def print_help(exit_code)
-      @stdout.puts <<~USAGE
-        Usage: jsx_rosetta <command> [args]
-
-        Commands:
-          install                    Install the gem's Node sidecar dependencies (runs `npm install`).
-          translate FILE [-o DIR]    Translate JSX/TSX into ViewComponent files in DIR (default: ".").
-                                     Pass --tsx to force TypeScript parsing if the input is .jsx.
-                                     Pass --as=view to emit a Rails view template (`<snake>.html.erb`)
-                                     instead of a ViewComponent class + sidecar template — appropriate
-                                     for pages tied to a route.
-                                     Pass --as=phlex to emit a single-file Phlex 2.x view class
-                                     (`<snake>.rb`) instead of a ViewComponent. Configure the class
-                                     name with --phlex-suffix=Component or --phlex-namespace=Components
-                                     (mutually exclusive; default is bare class name).
-          routes FILE [-o OUT.rb]    Parse <Route path=... element={<X/>} /> patterns from FILE
-                                     and emit a reviewable Ruby script that calls `rails generate
-                                     controller` and prints suggested config/routes.rb additions.
-          parse FILE                 Parse the input and print the Babel AST as JSON.
-          version                    Print the gem version.
-          help                       Show this help.
-
-        Environment:
-          JSX_ROSETTA_NODE           Absolute path to a node executable (default: PATH lookup).
-      USAGE
+      @stdout.puts USAGE_TEXT
       exit_code
     end
   end

data/lib/jsx_rosetta/icons/lucide.json

@@ -0,0 +1,37 @@
+{
+  "AlertCircle": "<circle cx=\"12\" cy=\"12\" r=\"10\"/><line x1=\"12\" x2=\"12\" y1=\"8\" y2=\"12\"/><line x1=\"12\" x2=\"12.01\" y1=\"16\" y2=\"16\"/>",
+  "AlertTriangle": "<path d=\"m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z\"/><path d=\"M12 9v4\"/><path d=\"M12 17h.01\"/>",
+  "ArrowDown": "<path d=\"M12 5v14\"/><path d=\"m19 12-7 7-7-7\"/>",
+  "ArrowLeft": "<path d=\"m12 19-7-7 7-7\"/><path d=\"M19 12H5\"/>",
+  "ArrowRight": "<path d=\"M5 12h14\"/><path d=\"m12 5 7 7-7 7\"/>",
+  "ArrowUp": "<path d=\"m5 12 7-7 7 7\"/><path d=\"M12 19V5\"/>",
+  "Bell": "<path d=\"M6 8a6 6 0 0 1 12 0c0 7 3 9 3 9H3s3-2 3-9\"/><path d=\"M10.3 21a1.94 1.94 0 0 0 3.4 0\"/>",
+  "Calendar": "<rect width=\"18\" height=\"18\" x=\"3\" y=\"4\" rx=\"2\" ry=\"2\"/><line x1=\"16\" x2=\"16\" y1=\"2\" y2=\"6\"/><line x1=\"8\" x2=\"8\" y1=\"2\" y2=\"6\"/><line x1=\"3\" x2=\"21\" y1=\"10\" y2=\"10\"/>",
+  "Check": "<path d=\"M20 6 9 17l-5-5\"/>",
+  "ChevronDown": "<path d=\"m6 9 6 6 6-6\"/>",
+  "ChevronLeft": "<path d=\"m15 18-6-6 6-6\"/>",
+  "ChevronRight": "<path d=\"m9 18 6-6-6-6\"/>",
+  "ChevronUp": "<path d=\"m18 15-6-6-6 6\"/>",
+  "ChevronsUpDown": "<path d=\"m7 15 5 5 5-5\"/><path d=\"m7 9 5-5 5 5\"/>",
+  "Circle": "<circle cx=\"12\" cy=\"12\" r=\"10\"/>",
+  "Copy": "<rect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\" ry=\"2\"/><path d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"/>",
+  "Dot": "<circle cx=\"12.1\" cy=\"12.1\" r=\"1\"/>",
+  "Eye": "<path d=\"M2 12s3-7 10-7 10 7 10 7-3 7-10 7-10-7-10-7Z\"/><circle cx=\"12\" cy=\"12\" r=\"3\"/>",
+  "EyeOff": "<path d=\"M9.88 9.88a3 3 0 1 0 4.24 4.24\"/><path d=\"M10.73 5.08A10.43 10.43 0 0 1 12 5c7 0 10 7 10 7a13.16 13.16 0 0 1-1.67 2.68\"/><path d=\"M6.61 6.61A13.526 13.526 0 0 0 2 12s3 7 10 7a9.74 9.74 0 0 0 5.39-1.61\"/><line x1=\"2\" x2=\"22\" y1=\"2\" y2=\"22\"/>",
+  "GripVertical": "<circle cx=\"9\" cy=\"12\" r=\"1\"/><circle cx=\"9\" cy=\"5\" r=\"1\"/><circle cx=\"9\" cy=\"19\" r=\"1\"/><circle cx=\"15\" cy=\"12\" r=\"1\"/><circle cx=\"15\" cy=\"5\" r=\"1\"/><circle cx=\"15\" cy=\"19\" r=\"1\"/>",
+  "Info": "<circle cx=\"12\" cy=\"12\" r=\"10\"/><path d=\"M12 16v-4\"/><path d=\"M12 8h.01\"/>",
+  "Loader2": "<path d=\"M21 12a9 9 0 1 1-6.219-8.56\"/>",
+  "Mail": "<rect width=\"20\" height=\"16\" x=\"2\" y=\"4\" rx=\"2\"/><path d=\"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7\"/>",
+  "Menu": "<line x1=\"4\" x2=\"20\" y1=\"12\" y2=\"12\"/><line x1=\"4\" x2=\"20\" y1=\"6\" y2=\"6\"/><line x1=\"4\" x2=\"20\" y1=\"18\" y2=\"18\"/>",
+  "Minus": "<path d=\"M5 12h14\"/>",
+  "MoreHorizontal": "<circle cx=\"12\" cy=\"12\" r=\"1\"/><circle cx=\"19\" cy=\"12\" r=\"1\"/><circle cx=\"5\" cy=\"12\" r=\"1\"/>",
+  "MoreVertical": "<circle cx=\"12\" cy=\"12\" r=\"1\"/><circle cx=\"12\" cy=\"5\" r=\"1\"/><circle cx=\"12\" cy=\"19\" r=\"1\"/>",
+  "PanelLeft": "<rect width=\"18\" height=\"18\" x=\"3\" y=\"3\" rx=\"2\"/><path d=\"M9 3v18\"/>",
+  "Plus": "<path d=\"M5 12h14\"/><path d=\"M12 5v14\"/>",
+  "Search": "<circle cx=\"11\" cy=\"11\" r=\"8\"/><path d=\"m21 21-4.3-4.3\"/>",
+  "Settings": "<path d=\"M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.1a2 2 0 0 1 1 1.72v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.39a2 2 0 0 0-.73-2.73l-.15-.08a2 2 0 0 1-1-1.74v-.5a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z\"/><circle cx=\"12\" cy=\"12\" r=\"3\"/>",
+  "Star": "<polygon points=\"12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2\"/>",
+  "Trash2": "<path d=\"M3 6h18\"/><path d=\"M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6\"/><path d=\"M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2\"/><line x1=\"10\" x2=\"10\" y1=\"11\" y2=\"17\"/><line x1=\"14\" x2=\"14\" y1=\"11\" y2=\"17\"/>",
+  "User": "<path d=\"M19 21v-2a4 4 0 0 0-4-4H9a4 4 0 0 0-4 4v2\"/><circle cx=\"12\" cy=\"7\" r=\"4\"/>",
+  "X": "<path d=\"M18 6 6 18\"/><path d=\"m6 6 12 12\"/>"
+}

data/lib/jsx_rosetta/icons.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "json"
+
+module JsxRosetta
+  # Vendored SVG path data for the most common icons referenced by shadcn-shaped
+  # JSX. Backends look up icons here to emit standalone Phlex classes alongside
+  # the translated component .rb file, so consumers don't have to write icon
+  # shims by hand.
+  #
+  # Refresh `lib/jsx_rosetta/icons/lucide.json` from the upstream Lucide package
+  # if you need names that aren't here yet — but verify the path data, since
+  # Lucide occasionally tweaks icon shapes between releases.
+  module Icons
+    LUCIDE_DATA_PATH = File.expand_path("icons/lucide.json", __dir__)
+
+    # Source specifiers that import from a Lucide-shaped icon package.
+    # Includes both the React-flavored `lucide-react` and the bare `lucide`
+    # package (some shadcn forks use it directly).
+    LUCIDE_SOURCE_PATTERN = /\Alucide(-react)?\z/
+
+    def self.lucide_data
+      @lucide_data ||= JSON.parse(File.read(LUCIDE_DATA_PATH))
+    end
+
+    # Look up the inner-SVG for a Lucide icon. Tolerates both canonical
+    # (`ChevronRight`) and legacy `*Icon` (`ChevronRightIcon`) names, since
+    # shadcn varies which it imports across components. Returns nil for
+    # the degenerate name `"Icon"` (and any empty result after stripping)
+    # so callers don't get a misleading data[""] miss.
+    def self.lucide_for(name)
+      name = name.to_s
+      return nil if name.empty? || name == "Icon"
+
+      data = lucide_data
+      data[name] || data[name.sub(/Icon\z/, "")]
+    end
+
+    # True iff the given `IR::ModuleImport#source` is a known Lucide package.
+    def self.lucide_source?(source)
+      LUCIDE_SOURCE_PATTERN.match?(source.to_s)
+    end
+  end
+end