rhales 0.5.4 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba52e82c80de6bba26167aaf61b424d72a03fc195ec69be7e38dbd17422cf064
-  data.tar.gz: d87dc62997bf10cfde421bb93e7d1025b2374e9cd53a2280acd37c157d553227
+  metadata.gz: 441e27aff0e4003c6e0351c6cf065cad3c3348c2aba7059acdfe6e26670df95c
+  data.tar.gz: bb38a8fd9c007c9efd3a69a6f5a1355ecbff4874553d7f63bc8b000e730677b7
 SHA512:
-  metadata.gz: 8368580c220c662432ede3e323b9460b6edba4ff5012c57fbbe0b4760572d063aed07225a4e9b29d542d00f169c7ccdab9ddf7c1aa742b67d0a80c438ad91b18
-  data.tar.gz: 2ff74a6825fda46507e849dfc19139c7084be205024a03d2b0fd5f8d930d71366ce5c3407fbeeb77acf133bdd5486b17dbc5b068780ec169a1ee29c15669f1e2
+  metadata.gz: 0733d8449de842934d86fe0af89fa6dc8b0c345248bda7c11c575f004b2996d1d845d3b90d584e28d919d6db1730bb137627af5471215c4ac8b018db06c6db79
+  data.tar.gz: d8d871a587836562d94a249f5bf1abf9624a30391b7186411f2e167afd5376006d6f8d68132e1958ca0eb59f091a19b976f177f4d1757c494bec7c32164ebd2c

data/CHANGELOG.md

@@ -7,7 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-03-21
+
 ### Added
+- **External Schema References**: Schema definitions can now reference external TypeScript/JavaScript files via the `src` attribute
+  - Enables single-source-of-truth patterns where TypeScript schemas drive both frontend types and Rhales validation
+  - Path resolution relative to template file with security checks to prevent path traversal
+  - Rake task output now shows inline vs external schema sources
+  - Example: `<schema src="schemas/user.schema.ts" lang="js-zod" window="__USER__">`
+- **Multi-directory Schema Search**: New `schema_search_paths` configuration option
+  - Allows searching multiple directories for external schema files
+  - Resolution order: template-relative first, then search paths in order
+  - Security checks apply to all configured paths
+- **tsx Import Mode**: New bundling mode for external schemas with imports
+  - `schema_use_tsx_import = true` enables esbuild bundling
+  - `schema_tsconfig_path` allows custom TypeScript configuration
+  - Externalizes zod to prevent dual-instance issues
+  - Cross-platform file:// URL support for Windows ESM compatibility
 - **Production Logging**: Structured logging via `Rhales.logger=` for security auditing and debugging
   - View rendering events with template details, timing, and hydration size
   - Schema validation warnings for production debugging (missing/extra keys)
@@ -23,16 +39,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Comprehensive test coverage for collision detection and merge strategies
 
 ### Changed
+- **Ruby 3.4+ required** (was 3.3.4) - aligns with current LTS ecosystem; no Ruby 3.3 features relied upon, but 3.4 is recommended for YJIT improvements and json_schemer performance
+- Updated zod to 4.3.6
+- Relaxed json_schemer dependency from ~> 2.3 to ~> 2
 - Replaced `json-schema` gem with `json_schemer` for better JSON Schema Draft 2020-12 support
 - Improved validation error messages with more structured output from json_schemer
 - Validation performance improved to <0.05ms average (was ~2ms with json-schema)
 
+### Removed
+- Unused `HydrationRegistry.clear!` method
+
 ### Security
 - Window collision detection prevents accidental data exposure by making overwrites explicit
 - All merge operations happen client-side after server-side interpolation and JSON serialization
 - Request-scoped registry prevents cross-request data leakage
 
-## [0.1.0] - 2024-01-XX
+## [0.1.0] - 2025-07-21
 
 ### Added
 - Initial release of Rhales

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    rhales (0.5.3)
-      json_schemer (~> 2.3)
+    rhales (0.6.0)
+      json_schemer (~> 2)
       logger
       tilt (~> 2)
 

data/README.md

@@ -1,20 +1,20 @@
 # Rhales - Ruby Single File Components
 
 > [!CAUTION]
-> **Early Development Release** - Rhales is in active development (v0.5). The API underwent breaking changes from v0.4. While functional and tested, it's recommended for experimental use and contributions. Please report issues and provide feedback through GitHub.
+> **Early Development Release** - Rhales is in active development (v0.6). The API underwent breaking changes from v0.4. While functional and tested, it's recommended for experimental use and contributions. Please report issues and provide feedback through GitHub.
 
 Rhales is a **type-safe contract enforcement framework** for server-rendered pages with client-side data hydration. It uses `.rue` files (Ruby Single File Components) that combine Zod v4 schemas, Handlebars templates, and documentation into a single contract-first format.
 
 **About the name:** It all started with a simple mustache template many years ago. Mustache's successor, "Handlebars," is a visual analog for a mustache. "Two Whales Kissing" is another visual analog for a mustache, and since we're working with Ruby, we call it "Rhales" (Ruby + Whales). It's a perfect name with absolutely no ambiguity or risk of confusion.
 
-## What's New in v0.5
+## What's New in v0.6
 
-- ✅ **Schema-First Design**: Replaced `<data>` sections with Zod v4 `<schema>` sections
-- ✅ **Type Safety**: Contract enforcement between backend and frontend
-- ✅ **Simplified API**: Removed deprecated parameters (`sess`, `cust`, `props:`, `app_data:`)
-- ✅ **Clear Context Layers**: Renamed `app` → `request` for clarity
-- ✅ **Schema Tooling**: Rake tasks for schema generation and validation
-- ✅ **100% Migration**: All demo templates use schemas
+- ✅ **External Schema References**: Reference TypeScript schema files via `src` attribute for single-source-of-truth patterns
+- ✅ **Multi-directory Search**: Configure `schema_search_paths` to search multiple directories for shared schemas
+- ✅ **tsx Import Mode**: Bundle external schemas with imports via esbuild (`schema_use_tsx_import`)
+- ✅ **Ruby 3.4+ Required**: Updated minimum Ruby version
+
+**v0.5 features:** Schema-first design, type safety, simplified API, clear context layers, schema tooling.
 
 **Breaking changes from v0.4:** See [Migration Guide](#migration-from-v04-to-v05) below.
 
@@ -134,6 +134,65 @@ const schema = z.object({
 | `version` | No | Schema version | `"2"` |
 | `envelope` | No | Response wrapper type | `"SuccessEnvelope"` |
 | `layout` | No | Layout template reference | `"layouts/main"` |
+| `src` | No | External schema file path | `"schemas/user.schema.ts"` |
+
+### External Schema References
+
+Instead of defining schemas inline, you can reference external TypeScript/JavaScript files. This enables single-source-of-truth patterns where the same schema file drives both frontend TypeScript types (via `z.infer<>`) and Rhales validation.
+
+```xml
+<!-- templates/dashboard.rue -->
+<schema src="schemas/dashboard.schema.ts" lang="js-zod" window="__DASHBOARD__">
+</schema>
+
+<template>
+  <div>{{user.name}}</div>
+</template>
+```
+
+```typescript
+// templates/schemas/dashboard.schema.ts
+import { z } from 'zod';
+
+const schema = z.object({
+  user: z.object({
+    name: z.string(),
+    email: z.string().email()
+  }),
+  items: z.array(z.string())
+});
+
+export default schema;
+
+// TypeScript frontend can import and use: z.infer<typeof schema>
+```
+
+The `src` path is resolved relative to the template file. Security checks prevent path traversal outside the templates directory.
+
+#### Multi-directory Search
+
+Configure additional directories to search for shared schema files:
+
+```ruby
+Rhales.configure do |config|
+  config.schema_search_paths = ['./shared/schemas', './lib/schemas']
+end
+```
+
+Resolution order: template-relative first, then search paths in order.
+
+#### tsx Import Mode
+
+For external schemas that import other modules, enable esbuild bundling:
+
+```ruby
+Rhales.configure do |config|
+  config.schema_use_tsx_import = true
+  config.schema_tsconfig_path = './tsconfig.json'  # optional
+end
+```
+
+This bundles the schema with all its imports while externalizing zod to prevent dual-instance issues.
 
 ### Zod Schema Examples
 

data/lib/rhales/configuration.rb

@@ -157,6 +157,9 @@ module Rhales
     # Hydration mismatch reporting settings
     attr_accessor :hydration_mismatch_format, :hydration_authority
 
+    # External schema settings
+    attr_accessor :schema_search_paths, :schema_tsconfig_path, :schema_use_tsx_import
+
     def initialize
       # Set sensible defaults
       @default_locale         = 'en'
@@ -191,6 +194,11 @@ module Rhales
       @hydration_mismatch_format        = :compact  # :compact, :multiline, :sidebyside, :json
       @hydration_authority              = :schema   # :schema or :data
 
+      # External schema defaults
+      @schema_search_paths              = []        # Additional paths to search for external schemas
+      @schema_tsconfig_path             = nil       # Path to tsconfig.json for tsx import execution
+      @schema_use_tsx_import            = false     # Use tsx import (runs through project tsconfig)
+
       # Yield to block for configuration if provided
       yield(self) if block_given?
     end
@@ -257,6 +265,13 @@ module Rhales
         end
       end
 
+      # Validate schema search paths exist if specified
+      @schema_search_paths.each do |path|
+        unless Dir.exist?(path)
+          errors << "Schema search path does not exist: #{path}"
+        end
+      end
+
       # Validate cache TTL
       if @cache_ttl && @cache_ttl <= 0
         errors << 'cache_ttl must be positive'
@@ -269,6 +284,7 @@ module Rhales
     def freeze!
       @features.freeze
       @template_paths.freeze
+      @schema_search_paths.freeze
       freeze
     end
 

data/lib/rhales/core/rue_document.rb

@@ -39,7 +39,7 @@ module Rhales
     ALL_SECTIONS = KNOWN_SECTIONS.freeze
 
     # Known schema section attributes
-    KNOWN_SCHEMA_ATTRIBUTES = %w[lang version envelope window merge layout extends].freeze
+    KNOWN_SCHEMA_ATTRIBUTES = %w[lang version envelope window merge layout extends src].freeze
 
     attr_reader :content, :file_path, :grammar, :ast
 
@@ -151,6 +151,12 @@ module Rhales
       schema_attributes['extends']
     end
 
+    # External schema file reference (optional)
+    # When present, schema code is loaded from this path instead of inline content
+    def schema_src
+      schema_attributes['src']
+    end
+
     def section?(name)
       @grammar.sections.key?(name)
     end

data/lib/rhales/hydration/hydration_registry.rb

@@ -27,10 +27,6 @@ module Rhales
         }
       end
 
-      def clear!
-        Thread.current[:rhales_hydration_registry] = {}
-      end
-
       # Expose registry for testing purposes
       def registry
         thread_local_registry

data/lib/rhales/utils/schema_extractor.rb

@@ -71,7 +71,18 @@ module Rhales
       return nil unless doc.section?('schema')
 
       template_name = derive_template_name(file_path)
-      schema_code = doc.section('schema')
+      src = doc.schema_src
+      resolved_path = nil
+      schema_code = nil
+
+      if src
+        # External schema: resolve path and read content
+        resolved_path = resolve_schema_src_path(file_path, src)
+        schema_code = read_schema_from_src(resolved_path, src, template_name)
+      else
+        # Inline schema: use content from the schema section
+        schema_code = doc.section('schema')
+      end
 
       {
         template_name: template_name,
@@ -83,7 +94,9 @@ module Rhales
         window: doc.schema_window,
         merge: doc.schema_merge_strategy,
         layout: doc.schema_layout,
-        extends: doc.schema_extends
+        extends: doc.schema_extends,
+        src: src,
+        resolved_path: resolved_path
       }
     end
 
@@ -97,15 +110,20 @@ module Rhales
 
     # Count how many .rue files have schema sections
     #
-    # @return [Hash] Count information
+    # @return [Hash] Count information including external vs inline breakdown
     def schema_stats
       all_files = find_rue_files
       schemas = extract_all
 
+      external_count = schemas.count { |s| s[:src] }
+      inline_count = schemas.count { |s| s[:src].nil? }
+
       {
         total_files: all_files.count,
         files_with_schemas: schemas.count,
         files_without_schemas: all_files.count - schemas.count,
+        external_schemas: external_count,
+        inline_schemas: inline_count,
         schemas_by_lang: schemas.group_by { |s| s[:lang] }.transform_values(&:count)
       }
     end
@@ -128,5 +146,105 @@ module Rhales
       relative_path = file_pathname.relative_path_from(templates_pathname)
       relative_path.to_s.sub(/\.rue$/, '')
     end
+
+    # Resolve external schema src path
+    #
+    # Resolution order:
+    # 1. Relative to template file directory
+    # 2. Search through configured schema_search_paths
+    #
+    # @param template_path [String] Absolute path to the .rue template
+    # @param src [String] The src attribute value from the schema tag
+    # @return [String] Absolute path to the external schema file
+    # @raise [ExtractionError] If path traversal is detected or file not found
+    def resolve_schema_src_path(template_path, src)
+      template_dir = File.dirname(template_path)
+      resolved = File.expand_path(src, template_dir)
+      searched_paths = [resolved]
+
+      # First, check if the path exists relative to template
+      if File.exist?(resolved) && path_within_allowed_directories?(resolved)
+        return resolved
+      end
+
+      # If the relative path does not exist or is not allowed,
+      # search through configured schema_search_paths
+      search_paths = Rhales.configuration.schema_search_paths || []
+      search_paths.each do |search_path|
+        expanded_search_path = File.expand_path(search_path)
+        candidate = File.join(expanded_search_path, src)
+        searched_paths << candidate
+
+        if File.exist?(candidate) && path_within_allowed_directories?(candidate)
+          return candidate
+        end
+      end
+
+      # Security check on the template-relative path
+      unless path_within_allowed_directories?(resolved)
+        raise ExtractionError,
+              "Schema src path traversal not allowed: '#{src}' resolves outside allowed directories"
+      end
+
+      # File not found in any location - raise helpful error listing all searched paths
+      raise ExtractionError,
+            "Schema file not found: '#{src}'. Searched:\n  - #{searched_paths.join("\n  - ")}"
+    end
+
+    # Check if a path is within any allowed directory
+    #
+    # Allowed directories include:
+    # - The templates directory
+    # - Any configured schema_search_paths
+    #
+    # @param path [String] Path to check
+    # @return [Boolean] True if path is within an allowed directory
+    def path_within_allowed_directories?(path)
+      return true if path_within_directory?(path, @templates_dir)
+
+      search_paths = Rhales.configuration.schema_search_paths || []
+      search_paths.any? do |search_path|
+        expanded_search_path = File.expand_path(search_path)
+        path_within_directory?(path, expanded_search_path)
+      end
+    end
+
+    # Read schema content from external file
+    #
+    # @param resolved_path [String] Absolute path to the schema file
+    # @param src [String] Original src attribute value (for error messages)
+    # @param template_name [String] Template name (for error messages)
+    # @return [String] Schema file content
+    # @raise [ExtractionError] If file cannot be read
+    def read_schema_from_src(resolved_path, src, template_name)
+      unless File.exist?(resolved_path)
+        raise ExtractionError,
+              "External schema file not found: '#{src}' (resolved to: #{resolved_path}) " \
+              "referenced by template '#{template_name}'"
+      end
+
+      File.read(resolved_path)
+    rescue Errno::EACCES => e
+      raise ExtractionError,
+            "Permission denied reading external schema '#{src}': #{e.message}"
+    rescue Errno::EISDIR
+      raise ExtractionError,
+            "External schema path '#{src}' is a directory, not a file"
+    end
+
+    # Check if a path is within a given directory (security check)
+    #
+    # @param path [String] Path to check
+    # @param directory [String] Directory that should contain the path
+    # @return [Boolean] True if path is within directory
+    def path_within_directory?(path, directory)
+      expanded_path = File.expand_path(path)
+      expanded_dir = File.expand_path(directory)
+
+      # Ensure directory ends with separator for accurate prefix matching
+      expanded_dir_with_sep = expanded_dir.end_with?(File::SEPARATOR) ? expanded_dir : "#{expanded_dir}#{File::SEPARATOR}"
+
+      expanded_path.start_with?(expanded_dir_with_sep) || expanded_path == expanded_dir
+    end
   end
 end

data/lib/rhales/utils/schema_generator.rb

@@ -3,6 +3,7 @@
 # frozen_string_literal: true
 
 require 'open3'
+require 'securerandom'
 require 'tempfile'
 require 'fileutils'
 require_relative 'schema_extractor'
@@ -76,7 +77,8 @@ module Rhales
         rescue => e
           results[:failed] += 1
           results[:success] = false
-          error_msg = "Failed to generate schema for #{schema_info[:template_name]}: #{e.message}"
+          source_info = schema_info[:src] ? " (from #{schema_info[:src]})" : ""
+          error_msg = "Failed to generate schema for #{schema_info[:template_name]}#{source_info}: #{e.message}"
           results[:errors] << error_msg
           warn error_msg
         end
@@ -95,14 +97,20 @@ module Rhales
       FileUtils.mkdir_p(temp_dir) unless Dir.exist?(temp_dir)
 
       temp_file = Tempfile.new(['schema', '.mts'], temp_dir)
+      bundled_file = nil
 
       begin
-        # Write TypeScript script
-        temp_file.write(build_typescript_script(schema_info))
+        # Write TypeScript script - use import mode for external schemas when configured
+        if use_tsx_import_mode?(schema_info)
+          script, bundled_file = build_typescript_import_script(schema_info)
+        else
+          script = build_typescript_script(schema_info)
+        end
+        temp_file.write(script)
         temp_file.close
 
-        # Execute with tsx via pnpm
-        stdout, stderr, status = Open3.capture3('pnpm', 'exec', 'tsx', temp_file.path)
+        # Execute with tsx via pnpm, optionally with tsconfig
+        stdout, stderr, status = execute_tsx(temp_file.path)
 
         unless status.success?
           raise GenerationError, "TypeScript execution failed: #{stderr}"
@@ -117,17 +125,132 @@ module Rhales
         json_schema
       ensure
         temp_file.unlink if temp_file
+        File.unlink(bundled_file) if bundled_file && File.exist?(bundled_file)
       end
     end
 
     private
 
+    # Determine if we should use tsx import mode for this schema
+    #
+    # Import mode is used when:
+    # 1. schema_use_tsx_import is enabled in configuration
+    # 2. The schema has an external src (not inline)
+    # 3. The resolved_path exists
+    #
+    # @param schema_info [Hash] Schema information
+    # @return [Boolean]
+    def use_tsx_import_mode?(schema_info)
+      return false unless Rhales.configuration.schema_use_tsx_import
+      return false unless schema_info[:src]
+      return false unless schema_info[:resolved_path]
+
+      File.exist?(schema_info[:resolved_path])
+    end
+
+    # Execute tsx with optional tsconfig
+    #
+    # @param script_path [String] Path to the TypeScript script to execute
+    # @return [Array] stdout, stderr, status from Open3.capture3
+    def execute_tsx(script_path)
+      tsconfig_path = Rhales.configuration.schema_tsconfig_path
+
+      if tsconfig_path
+        if File.exist?(tsconfig_path)
+          Open3.capture3('pnpm', 'exec', 'tsx', '--tsconfig', tsconfig_path, script_path)
+        else
+          warn "[Rhales] Warning: schema_tsconfig_path '#{tsconfig_path}' does not exist, ignoring"
+          Open3.capture3('pnpm', 'exec', 'tsx', script_path)
+        end
+      else
+        Open3.capture3('pnpm', 'exec', 'tsx', script_path)
+      end
+    end
+
+    # Build TypeScript script from bundled external schema
+    #
+    # Uses esbuild to bundle the external schema with all imports resolved,
+    # writes to a temp file, then imports via default export. This allows
+    # external files to name their schema variable anything they want.
+    #
+    # External schema files must use default export:
+    #   const mySchema = z.object({ ... });
+    #   export default mySchema;
+    #
+    # @param schema_info [Hash] Schema information with resolved_path
+    # @return [Array<String, String>] [script content, bundled_file_path] - caller must clean up bundled file
+    def build_typescript_import_script(schema_info)
+      safe_name = schema_info[:template_name].gsub("'", "\\'")
+      schema_path = schema_info[:resolved_path]
+
+      # Bundle external schema with esbuild to temp file - resolves all imports
+      # Use SecureRandom for uniqueness across concurrent invocations
+      temp_dir = File.join(Dir.pwd, 'tmp')
+      FileUtils.mkdir_p(temp_dir) unless Dir.exist?(temp_dir)
+      unique_suffix = "#{Process.pid}_#{SecureRandom.hex(4)}"
+      bundled_file = File.join(temp_dir, "bundled_#{File.basename(schema_path, '.*')}_#{unique_suffix}.mjs")
+
+      stdout, stderr, status = Open3.capture3(
+        'pnpm', 'exec', 'esbuild', schema_path,
+        '--bundle', '--format=esm', '--platform=node',
+        '--external:zod',
+        "--outfile=#{bundled_file}"
+      )
+
+      unless status.success?
+        raise GenerationError, "esbuild bundling failed for #{schema_path}: #{stderr}"
+      end
+
+      # Convert to file:// URL for cross-platform ESM import compatibility
+      bundled_file_url = path_to_file_url(bundled_file)
+
+      script = <<~TYPESCRIPT
+        // Auto-generated schema generator for #{safe_name}
+        // Source: #{schema_info[:src]} (bundled via esbuild)
+        import { z } from 'zod/v4';
+        import schema from '#{bundled_file_url}';
+
+        // Generate JSON Schema
+        try {
+          const jsonSchema = z.toJSONSchema(schema, {
+            target: 'draft-2020-12',
+            unrepresentable: 'any',
+            cycles: 'ref',
+            reused: 'inline',
+          });
+
+          // Add metadata
+          const schemaWithMeta = {
+            $schema: 'https://json-schema.org/draft/2020-12/schema',
+            $id: `https://rhales.dev/schemas/#{safe_name}.json`,
+            title: '#{safe_name}',
+            description: 'Schema for #{safe_name} template',
+            ...jsonSchema,
+          };
+
+          // Output JSON to stdout
+          console.log(JSON.stringify(schemaWithMeta, null, 2));
+        } catch (error) {
+          console.error('Schema generation error:', error.message);
+          process.exit(1);
+        }
+      TYPESCRIPT
+
+      [script, bundled_file]
+    end
+
     def build_typescript_script(schema_info)
       # Escape single quotes in template name for TypeScript string
       safe_name = schema_info[:template_name].gsub("'", "\\'")
+      source_comment = if schema_info[:src]
+        "// Source: #{schema_info[:src]} (external)"
+      else
+        "// Source: inline schema"
+      end
 
       <<~TYPESCRIPT
         // Auto-generated schema generator for #{safe_name}
+        #{source_comment}
         import { z } from 'zod/v4';
 
         // Schema code from .rue template
@@ -185,10 +308,34 @@ module Rhales
       unless status.success?
         raise GenerationError, "tsx not found. Run: pnpm install tsx --save-dev"
       end
+
+      # Check esbuild is available when tsx import mode is enabled
+      if Rhales.configuration.schema_use_tsx_import
+        stdout, stderr, status = Open3.capture3('pnpm', 'exec', 'esbuild', '--version')
+        unless status.success?
+          raise GenerationError, "esbuild not found (required for external schema bundling). Run: pnpm install esbuild --save-dev"
+        end
+      end
     end
 
     def ensure_output_directory!
       FileUtils.mkdir_p(@output_dir) unless File.directory?(@output_dir)
     end
+
+    # Convert absolute path to file:// URL for cross-platform ESM imports
+    #
+    # On Windows, paths like C:\foo\bar need to become file:///C:/foo/bar
+    # On Unix, paths like /foo/bar become file:///foo/bar
+    #
+    # @param path [String] Absolute file path
+    # @return [String] file:// URL
+    def path_to_file_url(path)
+      normalized = path.tr('\\', '/')
+      if normalized.match?(%r{^[A-Za-z]:}) # Windows drive letter
+        "file:///#{normalized}"
+      else
+        "file://#{normalized}"
+      end
+    end
   end
 end

data/lib/rhales/version.rb

@@ -5,6 +5,6 @@
 module Rhales
   # Version information for the RSFC gem
   unless defined?(Rhales::VERSION)
-    VERSION = '0.5.4'
+    VERSION = '0.6.0'
   end
 end

data/lib/tasks/rhales_schema.rake

@@ -45,7 +45,8 @@ namespace :rhales do
 
       puts "Found #{schemas.size} schema section(s):"
       schemas.each do |schema|
-        puts "  - #{schema[:template_name]} (#{schema[:lang]})"
+        source_type = schema[:src] ? "external: #{schema[:src]}" : "inline"
+        puts "  - #{schema[:template_name]} (#{schema[:lang]}, #{source_type})"
       end
       puts
 
@@ -186,6 +187,13 @@ namespace :rhales do
       puts "Files without <schema>: #{stats[:files_without_schemas]}"
       puts
 
+      if stats[:files_with_schemas] > 0
+        puts "Schema sources:"
+        puts "  External (src attribute): #{stats[:external_schemas]}"
+        puts "  Inline: #{stats[:inline_schemas]}"
+        puts
+      end
+
       if stats[:schemas_by_lang].any?
         puts "By language:"
         stats[:schemas_by_lang].each do |lang, count|

data/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "dependencies": {
-    "zod": "^4.1.12"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@prettier/plugin-ruby": "^4.0.4",

data/pnpm-lock.yaml

@@ -9,8 +9,8 @@ importers:
   .:
     dependencies:
       zod:
-        specifier: ^4.1.12
-        version: 4.1.12
+        specifier: ^4.3.6
+        version: 4.3.6
     devDependencies:
       '@prettier/plugin-ruby':
         specifier: ^4.0.4
@@ -208,8 +208,8 @@ packages:
     engines: {node: '>=18.0.0'}
     hasBin: true
 
-  zod@4.1.12:
-    resolution: {integrity: sha512-JInaHOamG8pt5+Ey8kGmdcAcg3OL9reK8ltczgHTAwNhMys/6ThXHityHxVV2p3fkw/c+MAvBHFVYHFZDmjMCQ==}
+  zod@4.3.6:
+    resolution: {integrity: sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg==}
 
 snapshots:
 
@@ -342,4 +342,4 @@ snapshots:
     optionalDependencies:
       fsevents: 2.3.3
 
-  zod@4.1.12: {}
+  zod@4.3.6: {}

data/rhales.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |spec|
 
   spec.homepage              = 'https://github.com/onetimesecret/rhales'
   spec.license               = 'MIT'
-  spec.required_ruby_version = '>= 3.3.4'
+  spec.required_ruby_version = '>= 3.4'
 
   spec.metadata['source_code_uri']       = 'https://github.com/onetimesecret/rhales'
   spec.metadata['changelog_uri']         = 'https://github.com/onetimesecret/rhales/blob/main/CHANGELOG.md'
@@ -41,14 +41,11 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   # Runtime dependencies
-  spec.add_dependency 'json_schemer', '~> 2.3'  # JSON Schema validation in middleware
+
+  spec.add_dependency 'json_schemer', '~> 2'    # JSON Schema validation in middleware
   spec.add_dependency 'logger'                  # Standard library logger for logging support
   spec.add_dependency 'tilt', '~> 2'            # Templating engine for rendering RSFCs
 
-  # Optional dependencies for performance optimization
-  # Install oj for 10-20x faster JSON parsing and 5-10x faster generation
-  # spec.add_dependency 'oj', '~> 3.13'
-
   # Development dependencies should be specified in Gemfile instead of gemspec
   # See: https://bundler.io/guides/creating_gem.html#testing-our-gem
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rhales
 version: !ruby/object:Gem::Version
-  version: 0.5.4
+  version: 0.6.0
 platform: ruby
 authors:
 - delano
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: logger
   requirement: !ruby/object:Gem::Requirement
@@ -189,7 +189,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.3.4
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="