ts-morph 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a6b5b9fdaac8abc66b8c8ae99cd6d7632538fae7741234df6bc1212a54d7bd67
+  data.tar.gz: d12a438996b9c0ac99665899db97c2a6b262a89175157778a2b1e854dd8573b6
+SHA512:
+  metadata.gz: 051e9cea3cabdca69b383191947dd2258d995cf4b320cb0d4248e53063f6967b7a0c0f7bbed304197ea918a15210d547da566c0257326381e5f142c7eddf414f
+  data.tar.gz: 1b5da2e9707139b8487785fad9dfccb8fa6ba30cfa09b0ef264848da0e05422741689247439fa885de591be8c7c4acb7499497f36d42fc2f340a44c770afb97f

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,8 @@
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-09-09
+
+### Added
+- Initial release of ts-morph Ruby gem
+- Core transformation capabilities:
+  - Add default props to components
+  - Wrap components with other components
+  - Rename components
+  - Add import statements
+  - Inject inline styles
+  - Remove components
+  - Extract components
+- TypeScript/TSX parsing to AST
+- Code formatting functionality
+- Comprehensive test suite
+- Examples for basic usage and Rails integration
+- Full documentation
+
+### Dependencies
+- Requires Node.js and npm for ts-morph integration
+- Ruby >= 3.1.0
+
+[Unreleased]: https://github.com/saulfuhrmann/ts-morph-ruby/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/saulfuhrmann/ts-morph-ruby/releases/tag/v0.1.0

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Socratic Systems
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/PUBLISHING.md

@@ -0,0 +1,184 @@
+# Publishing ts-morph Ruby Gem
+
+This guide walks through the steps to publish the ts-morph gem to RubyGems.org and set up the GitHub repository.
+
+## Prerequisites
+
+1. **RubyGems.org Account**
+   - Sign up at https://rubygems.org/sign_up if you don't have an account
+   - Note your username and password
+
+2. **GitHub Account**
+   - Ensure you're logged into GitHub
+   - Have SSH keys set up for GitHub
+
+## Step 1: Set up GitHub Repository
+
+```bash
+# Make sure you're in the gem directory
+cd /Users/saulfuhrmann/dev/ts-morph-ruby
+
+# Add all files and commit
+git add .
+git commit -m "Initial commit: ts-morph Ruby gem"
+
+# Create repository on GitHub (using GitHub CLI)
+gh repo create saulfuhrmann/ts-morph-ruby --public --source=. --remote=origin --push
+```
+
+If you don't have GitHub CLI, create the repository manually:
+1. Go to https://github.com/new
+2. Repository name: `ts-morph-ruby`
+3. Description: "Ruby wrapper for ts-morph TypeScript Compiler API"
+4. Make it public
+5. Don't initialize with README (we already have one)
+6. Create repository
+
+Then push your code:
+```bash
+git remote add origin git@github.com:saulfuhrmann/ts-morph-ruby.git
+git branch -M main
+git push -u origin main
+```
+
+## Step 2: Run Tests and Linting
+
+Before publishing, ensure everything passes:
+
+```bash
+# Install dependencies
+bundle install
+
+# Run tests
+bundle exec rake spec
+
+# Run linting
+bundle exec rake rubocop
+
+# Or run both (default task)
+bundle exec rake
+```
+
+## Step 3: Build the Gem
+
+```bash
+# Build the gem
+gem build ts-morph.gemspec
+
+# This creates ts-morph-0.1.0.gem
+```
+
+## Step 4: Test Local Installation
+
+```bash
+# Install locally to test
+gem install ./ts-morph-0.1.0.gem
+
+# Test in IRB
+irb
+require 'ts/morph'
+Ts::Morph::VERSION
+exit
+```
+
+## Step 5: Set up RubyGems Credentials
+
+```bash
+# Set up your RubyGems API key
+gem signin
+
+# Or if you already have credentials
+curl -u YOUR_USERNAME https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials
+chmod 0600 ~/.gem/credentials
+```
+
+## Step 6: Publish to RubyGems.org
+
+```bash
+# Push the gem to RubyGems.org
+gem push ts-morph-0.1.0.gem
+```
+
+## Step 7: Verify Publication
+
+1. Visit https://rubygems.org/gems/ts-morph
+2. Verify the gem appears with correct information
+3. Test installation from RubyGems:
+
+```bash
+# In a different directory
+gem install ts-morph
+```
+
+## Step 8: Tag the Release
+
+```bash
+# Create a git tag for the version
+git tag -a v0.1.0 -m "Release version 0.1.0"
+git push origin v0.1.0
+```
+
+## Step 9: Create GitHub Release
+
+Using GitHub CLI:
+```bash
+gh release create v0.1.0 --title "v0.1.0" --notes "Initial release of ts-morph Ruby gem"
+```
+
+Or manually:
+1. Go to https://github.com/saulfuhrmann/ts-morph-ruby/releases
+2. Click "Create a new release"
+3. Choose tag v0.1.0
+4. Title: v0.1.0
+5. Add release notes
+6. Publish release
+
+## Updating the Gem
+
+When you need to release a new version:
+
+1. Update version in `lib/ts/morph/version.rb`
+2. Update CHANGELOG.md
+3. Commit changes
+4. Build and push new version:
+
+```bash
+git add .
+git commit -m "Bump version to 0.2.0"
+gem build ts-morph.gemspec
+gem push ts-morph-0.2.0.gem
+git tag -a v0.2.0 -m "Release version 0.2.0"
+git push origin main --tags
+```
+
+## Troubleshooting
+
+### "gem push" fails with authentication error
+- Ensure you've run `gem signin` with correct credentials
+- Check ~/.gem/credentials exists and has correct permissions (600)
+
+### Name already taken on RubyGems
+- The name "ts-morph" might be taken. If so, consider:
+  - `ts-morph-ruby`
+  - `ruby-ts-morph`
+  - `tsmorph`
+
+### Tests fail before publishing
+- Ensure Node.js is installed
+- Run `Ts::Morph.install_dependencies` manually
+- Check for any linting errors with `bundle exec rubocop -a`
+
+## GitHub Actions CI
+
+The gem includes GitHub Actions configuration. After pushing to GitHub:
+1. Go to Settings > Actions > General
+2. Ensure Actions are enabled
+3. The CI will run automatically on push and pull requests
+
+## Gem Maintenance
+
+- Respond to issues on GitHub
+- Keep dependencies updated
+- Follow semantic versioning
+- Update documentation as needed
+- Consider adding more features based on user feedback

data/README.md

@@ -0,0 +1,287 @@
+# ts-morph Ruby Gem
+
+A Ruby wrapper for [ts-morph](https://github.com/dsherret/ts-morph), providing programmatic TypeScript and TSX code analysis and transformation capabilities.
+
+## Features
+
+- Transform TypeScript/TSX code programmatically
+- Parse TypeScript/TSX into AST
+- Format TypeScript/TSX code
+- Add/modify/remove components and imports
+- Inject styles and props
+- Extract and manipulate React components
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ts-morph'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install ts-morph
+```
+
+### Node.js Dependencies
+
+This gem requires Node.js and npm to be installed. After installing the gem, run:
+
+```ruby
+require 'ts/morph'
+Ts::Morph.install_dependencies
+```
+
+This will install the necessary Node.js packages (ts-morph, TypeScript, and Babel).
+
+## Usage
+
+### Basic Transformation
+
+```ruby
+require 'ts/morph'
+
+code = <<~TSX
+  import React from 'react';
+  
+  const MyComponent = () => {
+    return <Button>Click me</Button>;
+  };
+TSX
+
+# Transform the code
+transformations = [
+  {
+    type: 'addDefaultProps',
+    component: 'Button',
+    props: { variant: 'primary', size: 'medium' }
+  }
+]
+
+transformed = Ts::Morph.transform(code, transformations)
+puts transformed
+# Output includes: <Button variant="primary" size="medium">Click me</Button>
+```
+
+### Using Transformation Helpers
+
+```ruby
+require 'ts/morph'
+require 'ts/morph/transformations'
+
+# Build transformations using helper methods
+transformations = [
+  Ts::Morph::Transformations.add_default_props('Button', { 
+    variant: 'primary',
+    size: 'medium' 
+  }),
+  Ts::Morph::Transformations.add_imports([
+    Ts::Morph::Transformations.import_spec(
+      from: '@/components/ui',
+      named: ['Button', 'Card']
+    )
+  ]),
+  Ts::Morph::Transformations.wrap_components('form', 'FormProvider')
+]
+
+transformed = Ts::Morph.transform(code, transformations)
+```
+
+### Parsing AST
+
+```ruby
+code = <<~TSX
+  const App = () => <div>Hello World</div>;
+TSX
+
+ast = Ts::Morph.parse(code)
+puts JSON.pretty_generate(ast)
+```
+
+### Formatting Code
+
+```ruby
+ugly_code = "const   App=()=><div>Hello</div>;"
+formatted = Ts::Morph.format(ugly_code)
+puts formatted
+# Output: const App = () => <div>Hello</div>;
+```
+
+## Available Transformations
+
+### addDefaultProps
+Add default props to components:
+
+```ruby
+{
+  type: 'addDefaultProps',
+  component: 'Button',
+  props: { variant: 'primary', disabled: false }
+}
+```
+
+### wrapComponents
+Wrap components with another component:
+
+```ruby
+{
+  type: 'wrapComponents',
+  target: 'form',
+  wrapper: 'FormProvider'
+}
+```
+
+### renameComponents
+Rename components throughout the file:
+
+```ruby
+{
+  type: 'renameComponents',
+  oldName: 'Container',
+  newName: 'AppContainer'
+}
+```
+
+### addImports
+Add import statements:
+
+```ruby
+{
+  type: 'addImports',
+  imports: [
+    { from: 'react', named: ['useState', 'useEffect'] },
+    { from: './utils', default: 'utils' }
+  ]
+}
+```
+
+### injectStyles
+Inject inline styles:
+
+```ruby
+{
+  type: 'injectStyles',
+  styles: {
+    'Container' => { padding: '1rem', maxWidth: '1200px' },
+    'Card' => { borderRadius: '8px' }
+  }
+}
+```
+
+### removeComponent
+Remove all instances of a component:
+
+```ruby
+{
+  type: 'removeComponent',
+  component: 'DebugPanel'
+}
+```
+
+## Rails Integration
+
+Example service for Rails applications:
+
+```ruby
+# app/services/tsx_transformer_service.rb
+class TsxTransformerService
+  include Ts::Morph::Transformations
+
+  def self.transform_for_site(tsx_code, site_config = {})
+    transformations = []
+
+    # Add consistent styling
+    if site_config[:theme]
+      transformations << inject_styles(theme_styles(site_config[:theme]))
+    end
+
+    # Standardize components
+    transformations << add_default_props('Button', {
+      variant: site_config[:button_variant] || 'primary'
+    })
+
+    # Add necessary imports
+    transformations << add_imports([
+      import_spec(from: '@/components/ui', named: ['Button', 'Card']),
+      import_spec(from: 'react', named: ['useState'])
+    ])
+
+    Ts::Morph.transform(tsx_code, transformations)
+  end
+
+  private
+
+  def self.theme_styles(theme)
+    case theme
+    when 'dark'
+      {
+        'Container' => { 
+          backgroundColor: '#1a1a1a',
+          color: '#ffffff'
+        }
+      }
+    else
+      {
+        'Container' => { 
+          backgroundColor: '#ffffff',
+          color: '#000000'
+        }
+      }
+    end
+  end
+end
+```
+
+## Performance Considerations
+
+For better performance in production:
+
+1. **Install dependencies once** during deployment
+2. **Consider running a Node.js service** for transformations instead of spawning processes
+3. **Cache transformed results** when possible
+
+## Error Handling
+
+```ruby
+begin
+  transformed = Ts::Morph.transform(code, transformations)
+rescue Ts::Morph::ServiceUnavailableError => e
+  # Node service not available, install dependencies
+  Ts::Morph.install_dependencies
+  retry
+rescue Ts::Morph::TransformationError => e
+  # Handle transformation errors
+  Rails.logger.error "Transformation failed: #{e.message}"
+end
+```
+
+## Development
+
+After checking out the repo, run:
+
+```bash
+bundle install
+bundle exec rake spec
+```
+
+To install this gem onto your local machine:
+
+```bash
+bundle exec rake install
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/saulfuhrmann/ts-morph-ruby.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+
+task default: [:spec, :rubocop]

data/SUMMARY.md

@@ -0,0 +1,114 @@
+# ts-morph Ruby Gem - Summary
+
+## What We've Created
+
+We've built a complete Ruby gem that wraps the ts-morph TypeScript Compiler API, providing Ruby developers with powerful TypeScript/TSX transformation capabilities.
+
+### Key Features
+
+1. **TypeScript/TSX Transformations**
+   - Add default props to React components
+   - Wrap components with other components
+   - Rename components throughout files
+   - Add import statements
+   - Inject inline styles
+   - Remove/extract components
+
+2. **Additional Capabilities**
+   - Parse TypeScript/TSX to AST
+   - Format TypeScript/TSX code
+   - Rails integration examples
+
+3. **Complete Test Suite**
+   - Unit tests for all major functionality
+   - RSpec configuration
+   - CI/CD with GitHub Actions
+
+4. **Documentation**
+   - Comprehensive README
+   - Usage examples
+   - Rails integration guide
+   - Publishing instructions
+
+## Should We Add Specs?
+
+✅ **Already Done!** We've added a comprehensive test suite:
+- `spec/ts/morph_spec.rb` - Main module tests
+- `spec/ts/morph/transformer_spec.rb` - Transformation tests
+- `spec/ts/morph/transformations_spec.rb` - Helper method tests
+- Configured RSpec and included it in the default Rake task
+
+## How to Publish to RubyGems.org
+
+### Quick Steps:
+
+1. **Create GitHub Repository**
+   ```bash
+   gh repo create saulfuhrmann/ts-morph-ruby --public --source=. --remote=origin --push
+   ```
+
+2. **Run Tests**
+   ```bash
+   bundle exec rake
+   ```
+
+3. **Build Gem**
+   ```bash
+   gem build ts-morph.gemspec
+   ```
+
+4. **Sign in to RubyGems**
+   ```bash
+   gem signin
+   ```
+
+5. **Publish**
+   ```bash
+   gem push ts-morph-0.1.0.gem
+   ```
+
+6. **Tag Release**
+   ```bash
+   git tag -a v0.1.0 -m "Initial release"
+   git push origin v0.1.0
+   ```
+
+### Detailed Instructions
+
+See `PUBLISHING.md` for comprehensive publishing instructions including:
+- Setting up RubyGems credentials
+- Testing local installation
+- Creating GitHub releases
+- Troubleshooting common issues
+- Future version updates
+
+## File Structure
+
+```
+ts-morph-ruby/
+├── lib/
+│   └── ts/
+│       ├── morph.rb              # Main module
+│       └── morph/
+│           ├── version.rb        # Version constant
+│           ├── error.rb          # Error classes
+│           ├── node_service.rb   # Node.js integration
+│           ├── transformer.rb    # Core transformation logic
+│           └── transformations.rb # Helper methods
+├── spec/                         # Test suite
+├── examples/                     # Usage examples
+├── .github/workflows/main.yml    # CI configuration
+├── README.md                     # Main documentation
+├── PUBLISHING.md                 # Publishing guide
+├── LICENSE.txt                   # MIT License
+└── ts-morph.gemspec             # Gem specification
+```
+
+## Next Steps
+
+1. **Push to GitHub** - The repository is ready to be pushed
+2. **Verify CI** - GitHub Actions will run tests automatically
+3. **Publish to RubyGems** - Follow PUBLISHING.md instructions
+4. **Announce** - Consider announcing on Ruby forums/social media
+
+The gem is fully functional and ready for publication!