feat: bundle t-ruby source at build time

- Add bundle-t-ruby.mjs script to embed Ruby source files
- Update release workflow to clone t-ruby and bundle sources
- Support dynamic init script generation based on bundle availability
- Add vendor/ to gitignore (populated during CI build)

Author: yhk1038

.github/workflows/release.yml

@@ -41,9 +41,29 @@ jobs:
             VERSION=${GITHUB_REF#refs/tags/v}
             T_RUBY_VERSION=""
           fi
+          # t_ruby_version이 없으면 version과 동일하게 설정
+          if [[ -z "$T_RUBY_VERSION" ]]; then
+            T_RUBY_VERSION="$VERSION"
+          fi
           echo "version=$VERSION" >> $GITHUB_OUTPUT
           echo "t_ruby_version=$T_RUBY_VERSION" >> $GITHUB_OUTPUT
-          echo "Publishing version: $VERSION"
+          echo "Publishing version: $VERSION (t-ruby: $T_RUBY_VERSION)"
+
+      - name: Clone t-ruby source
+        run: |
+          git clone --depth 1 --branch v${{ steps.version.outputs.t_ruby_version }} \
+            https://github.com/type-ruby/t-ruby.git /tmp/t-ruby
+          echo "Cloned t-ruby v${{ steps.version.outputs.t_ruby_version }}"
+
+      - name: Copy t-ruby lib to vendor
+        run: |
+          mkdir -p vendor/t-ruby
+          cp -r /tmp/t-ruby/lib/* vendor/t-ruby/
+          echo "Copied t-ruby lib files:"
+          ls -la vendor/t-ruby/
+
+      - name: Bundle t-ruby source
+        run: node scripts/bundle-t-ruby.mjs
 
       - name: Build
         run: npm run build

.gitignore

@@ -4,6 +4,9 @@ node_modules/
 # Build output
 dist/
 
+# Vendor (t-ruby source copied during CI build)
+vendor/
+
 # IDE
 .idea/
 .vscode/

scripts/bundle-t-ruby.mjs

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+
+/**
+ * Bundle T-Ruby source files into a TypeScript module
+ *
+ * This script reads all Ruby files from vendor/t-ruby and generates
+ * a TypeScript file that embeds them for use in the WASM environment.
+ */
+
+import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const rootDir = join(__dirname, "..");
+const vendorDir = join(rootDir, "vendor", "t-ruby");
+const outputFile = join(rootDir, "src", "vm", "TRubyBundle.ts");
+
+/**
+ * Recursively collect all .rb files from a directory
+ */
+function collectRubyFiles(dir, basePath = "") {
+  const files = [];
+
+  if (!existsSync(dir)) {
+    return files;
+  }
+
+  for (const entry of readdirSync(dir)) {
+    const fullPath = join(dir, entry);
+    const relativePath = basePath ? `${basePath}/${entry}` : entry;
+
+    if (statSync(fullPath).isDirectory()) {
+      files.push(...collectRubyFiles(fullPath, relativePath));
+    } else if (entry.endsWith(".rb")) {
+      files.push({
+        path: relativePath,
+        content: readFileSync(fullPath, "utf-8"),
+      });
+    }
+  }
+
+  return files;
+}
+
+/**
+ * Escape string for use in TypeScript template literal
+ */
+function escapeForTemplate(str) {
+  return str
+    .replace(/\\/g, "\\\\")
+    .replace(/`/g, "\\`")
+    .replace(/\$\{/g, "\\${");
+}
+
+console.log("Bundling T-Ruby source files...");
+
+const files = collectRubyFiles(vendorDir);
+
+if (files.length === 0) {
+  console.log("No Ruby files found in vendor/t-ruby. Using fallback bundle.");
+
+  // Generate fallback bundle (minimal implementation)
+  const fallbackContent = `/**
+ * T-Ruby Bundle - Auto-generated
+ *
+ * This file contains bundled T-Ruby source files for WASM environment.
+ * Generated at build time from vendor/t-ruby directory.
+ *
+ * @internal
+ */
+
+/** Bundled T-Ruby source files */
+export const T_RUBY_BUNDLE: Record<string, string> = {};
+
+/** Flag indicating if real T-Ruby is bundled */
+export const HAS_T_RUBY_BUNDLE = false;
+`;
+
+  writeFileSync(outputFile, fallbackContent);
+  console.log("Generated fallback bundle.");
+} else {
+  console.log(`Found ${files.length} Ruby files to bundle.`);
+
+  // Generate TypeScript bundle
+  let content = `/**
+ * T-Ruby Bundle - Auto-generated
+ *
+ * This file contains bundled T-Ruby source files for WASM environment.
+ * Generated at build time from vendor/t-ruby directory.
+ *
+ * DO NOT EDIT MANUALLY - This file is auto-generated by scripts/bundle-t-ruby.mjs
+ *
+ * @internal
+ */
+
+/** Bundled T-Ruby source files */
+export const T_RUBY_BUNDLE: Record<string, string> = {
+`;
+
+  for (const file of files) {
+    content += `  "${file.path}": \`${escapeForTemplate(file.content)}\`,\n`;
+  }
+
+  content += `};
+
+/** Flag indicating if real T-Ruby is bundled */
+export const HAS_T_RUBY_BUNDLE = true;
+`;
+
+  writeFileSync(outputFile, content);
+  console.log(`Generated bundle with ${files.length} files: ${outputFile}`);
+}

src/vm/TRubyBundle.ts

@@ -0,0 +1,14 @@
+/**
+ * T-Ruby Bundle - Auto-generated
+ *
+ * This file contains bundled T-Ruby source files for WASM environment.
+ * Generated at build time from vendor/t-ruby directory.
+ *
+ * @internal
+ */
+
+/** Bundled T-Ruby source files */
+export const T_RUBY_BUNDLE: Record<string, string> = {};
+
+/** Flag indicating if real T-Ruby is bundled */
+export const HAS_T_RUBY_BUNDLE = false;

src/vm/TRubyInitScript.ts

@@ -1,14 +1,49 @@
+import { T_RUBY_BUNDLE, HAS_T_RUBY_BUNDLE } from "./TRubyBundle.js";
+
 /**
- * Ruby initialization script for T-Ruby in WASM environment
+ * Generate Ruby initialization script for T-Ruby in WASM environment
  *
  * @remarks
- * This script is executed when the Ruby VM is initialized.
- * It attempts to load the T-Ruby gem, and falls back to a minimal
- * implementation if the gem is not available.
+ * This function generates a script that either loads bundled T-Ruby files
+ * or falls back to a minimal implementation if no bundle is available.
  *
  * @internal
  */
-export const T_RUBY_INIT_SCRIPT = `
+export function generateInitScript(): string {
+  if (HAS_T_RUBY_BUNDLE) {
+    // Generate script that loads bundled files
+    let script = `
+# T-Ruby WASM Bundle Loader
+$LOAD_PATH.unshift('/t-ruby')
+
+# Create virtual file system for bundled files
+`;
+
+    // Add each bundled file to the virtual file system
+    for (const [path, content] of Object.entries(T_RUBY_BUNDLE)) {
+      const escapedContent = content
+        .replace(/\\/g, "\\\\")
+        .replace(/'/g, "\\'")
+        .replace(/\n/g, "\\n");
+      script += `
+begin
+  dir = File.dirname('/t-ruby/${path}')
+  FileUtils.mkdir_p(dir) unless Dir.exist?(dir)
+rescue; end
+File.write('/t-ruby/${path}', '${escapedContent}')
+`;
+    }
+
+    script += `
+require 'rubygems'
+require 't_ruby'
+`;
+
+    return script;
+  }
+
+  // Fallback: minimal implementation
+  return `
 require 'rubygems'
 begin
   require 't-ruby'
@@ -36,3 +71,9 @@ rescue LoadError
   end
 end
 `;
+}
+
+/**
+ * @deprecated Use generateInitScript() instead
+ */
+export const T_RUBY_INIT_SCRIPT = generateInitScript();

src/vm/index.ts

@@ -5,4 +5,5 @@
 
 export type { RubyVM } from "./RubyVM.js";
 export type { DefaultRubyVMResult } from "./DefaultRubyVM.js";
-export { T_RUBY_INIT_SCRIPT } from "./TRubyInitScript.js";
+export { T_RUBY_INIT_SCRIPT, generateInitScript } from "./TRubyInitScript.js";
+export { T_RUBY_BUNDLE, HAS_T_RUBY_BUNDLE } from "./TRubyBundle.js";