rhales 0.3.0 → 0.5.3

data/lib/tasks/rhales_schema.rake

@@ -0,0 +1,197 @@
+# lib/tasks/rhales_schema.rake
+
+namespace :rhales do
+  namespace :schema do
+    desc 'Generate JSON Schemas from .rue template files'
+    task :generate do
+      require 'rhales'
+
+      # Default to current working directory (implementing project)
+      templates_dir = ENV.fetch('TEMPLATES_DIR', './templates')
+      output_dir = ENV.fetch('OUTPUT_DIR', './public/schemas')
+
+      puts "Schema Generation"
+      puts "=" * 60
+      puts "Templates: #{templates_dir}"
+      puts "Output: #{output_dir}"
+      puts "Zod: (using pnpm exec tsx)"
+      puts
+
+      # Validate templates directory exists
+      unless Dir.exist?(templates_dir)
+        puts "⚠️  Templates directory not found: #{templates_dir}"
+        puts
+        puts "Usage:"
+        puts "  rake rhales:schema:generate TEMPLATES_DIR=./templates OUTPUT_DIR=./public/schemas"
+        puts
+        puts "Or from project root where templates/ exists:"
+        puts "  rake rhales:schema:generate"
+        exit 1
+      end
+
+      # Extract schemas
+      extractor = Rhales::SchemaExtractor.new(templates_dir)
+      schemas = extractor.extract_all
+
+      if schemas.empty?
+        puts "⚠️  No schema sections found in templates"
+        puts
+        puts "Make sure your .rue files have <schema> sections:"
+        puts "  <schema lang=\"js-zod\" window=\"appData\">"
+        puts "  const schema = z.object({ ... });"
+        puts "  </schema>"
+        exit 0
+      end
+
+      puts "Found #{schemas.size} schema section(s):"
+      schemas.each do |schema|
+        puts "  - #{schema[:template_name]} (#{schema[:lang]})"
+      end
+      puts
+
+      # Generate JSON Schemas
+      generator = Rhales::SchemaGenerator.new(
+        templates_dir: templates_dir,
+        output_dir: output_dir
+      )
+
+      puts "Generating JSON Schemas..."
+      results = generator.generate_all
+
+      # Report results
+      puts
+      puts "Results:"
+      puts "-" * 60
+
+      generated_count = results[:generated]
+      failed_count = results[:failed]
+
+      if results[:success]
+        puts "✓ Successfully generated #{generated_count} schema(s)"
+        puts "✓ Output directory: #{output_dir}"
+      else
+        puts "✗ Generation failed with #{failed_count} error(s)"
+        results[:errors].each do |error|
+          puts "  - #{error}"
+        end
+      end
+
+      puts
+
+      exit(results[:success] ? 0 : 1)
+    end
+
+    desc 'Validate existing JSON Schemas'
+    task :validate do
+      require 'rhales'
+      require 'json'
+      require 'json_schemer'
+
+      # Default to current working directory
+      schemas_dir = ENV.fetch('OUTPUT_DIR', './public/schemas')
+
+      unless Dir.exist?(schemas_dir)
+        puts "⚠️  Schemas directory not found: #{schemas_dir}"
+        puts
+        puts "Generate schemas first:"
+        puts "  rake rhales:schema:generate"
+        exit 1
+      end
+
+      schema_files = Dir.glob("#{schemas_dir}/**/*.json")
+
+      if schema_files.empty?
+        puts "⚠️  No schema files found in #{schemas_dir}"
+        puts
+        puts "Generate schemas first:"
+        puts "  rake rhales:schema:generate"
+        exit 1
+      end
+
+      puts "Validating #{schema_files.size} schema file(s) in #{schemas_dir}..."
+      puts
+
+      errors = []
+
+      schema_files.each do |file|
+        relative_path = file.sub("#{schemas_dir}/", '')
+
+        begin
+          schema = JSON.parse(File.read(file))
+
+          # Validate against JSON Schema meta-schema
+          unless schema.is_a?(Hash)
+            errors << "#{relative_path}: Not a valid object"
+            next
+          end
+
+          # Use JSONSchemer to validate against the meta-schema
+          meta_schema = JSONSchemer.schema(
+            {
+              '$schema' => 'https://json-schema.org/draft/2020-12/schema'
+            }
+          )
+
+          validation_errors = meta_schema.validate(schema).to_a
+
+          if validation_errors.any?
+            validation_errors.each do |error|
+              errors << "#{relative_path}: #{error['type']} at #{error['data_pointer']}"
+            end
+          else
+            puts "✓ #{relative_path}"
+          end
+        rescue JSON::ParserError => e
+          errors << "#{relative_path}: Invalid JSON - #{e.message}"
+        rescue => e
+          errors << "#{relative_path}: #{e.message}"
+        end
+      end
+
+      puts
+
+      if errors.any?
+        puts "Errors:"
+        errors.each { |err| puts "  ✗ #{err}" }
+        exit 1
+      else
+        puts "All schemas valid ✓"
+      end
+    end
+
+    desc 'Show statistics about schema sections'
+    task :stats do
+      require 'rhales'
+
+      # Default to current working directory
+      templates_dir = ENV.fetch('TEMPLATES_DIR', './templates')
+
+      unless Dir.exist?(templates_dir)
+        puts "⚠️  Templates directory not found: #{templates_dir}"
+        puts
+        puts "Usage:"
+        puts "  rake rhales:schema:stats TEMPLATES_DIR=./templates"
+        exit 1
+      end
+
+      extractor = Rhales::SchemaExtractor.new(templates_dir)
+      stats = extractor.schema_stats
+
+      puts "Schema Statistics"
+      puts "=" * 60
+      puts "Templates directory: #{templates_dir}"
+      puts
+      puts "Total .rue files: #{stats[:total_files]}"
+      puts "Files with <schema>: #{stats[:files_with_schemas]}"
+      puts "Files without <schema>: #{stats[:files_without_schemas]}"
+      puts
+
+      if stats[:schemas_by_lang].any?
+        puts "By language:"
+        stats[:schemas_by_lang].each do |lang, count|
+          puts "  #{lang}: #{count}"
+        end
+      end
+    end
+  end
+end

data/package.json

@@ -0,0 +1,10 @@
+{
+  "type": "module",
+  "dependencies": {
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@prettier/plugin-ruby": "^4.0.4",
+    "tsx": "^4.20.6"
+  }
+}

data/pnpm-lock.yaml

@@ -0,0 +1,345 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      zod:
+        specifier: ^4.1.12
+        version: 4.1.12
+    devDependencies:
+      '@prettier/plugin-ruby':
+        specifier: ^4.0.4
+        version: 4.0.4(prettier@3.6.2)
+      tsx:
+        specifier: ^4.20.6
+        version: 4.20.6
+
+packages:
+
+  '@esbuild/aix-ppc64@0.25.11':
+    resolution: {integrity: sha512-Xt1dOL13m8u0WE8iplx9Ibbm+hFAO0GsU2P34UNoDGvZYkY8ifSiy6Zuc1lYxfG7svWE2fzqCUmFp5HCn51gJg==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.25.11':
+    resolution: {integrity: sha512-9slpyFBc4FPPz48+f6jyiXOx/Y4v34TUeDDXJpZqAWQn/08lKGeD8aDp9TMn9jDz2CiEuHwfhRmGBvpnd/PWIQ==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.25.11':
+    resolution: {integrity: sha512-uoa7dU+Dt3HYsethkJ1k6Z9YdcHjTrSb5NUy66ZfZaSV8hEYGD5ZHbEMXnqLFlbBflLsl89Zke7CAdDJ4JI+Gg==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.25.11':
+    resolution: {integrity: sha512-Sgiab4xBjPU1QoPEIqS3Xx+R2lezu0LKIEcYe6pftr56PqPygbB7+szVnzoShbx64MUupqoE0KyRlN7gezbl8g==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.25.11':
+    resolution: {integrity: sha512-VekY0PBCukppoQrycFxUqkCojnTQhdec0vevUL/EDOCnXd9LKWqD/bHwMPzigIJXPhC59Vd1WFIL57SKs2mg4w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.25.11':
+    resolution: {integrity: sha512-+hfp3yfBalNEpTGp9loYgbknjR695HkqtY3d3/JjSRUyPg/xd6q+mQqIb5qdywnDxRZykIHs3axEqU6l1+oWEQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.25.11':
+    resolution: {integrity: sha512-CmKjrnayyTJF2eVuO//uSjl/K3KsMIeYeyN7FyDBjsR3lnSJHaXlVoAK8DZa7lXWChbuOk7NjAc7ygAwrnPBhA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.25.11':
+    resolution: {integrity: sha512-Dyq+5oscTJvMaYPvW3x3FLpi2+gSZTCE/1ffdwuM6G1ARang/mb3jvjxs0mw6n3Lsw84ocfo9CrNMqc5lTfGOw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.25.11':
+    resolution: {integrity: sha512-Qr8AzcplUhGvdyUF08A1kHU3Vr2O88xxP0Tm8GcdVOUm25XYcMPp2YqSVHbLuXzYQMf9Bh/iKx7YPqECs6ffLA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.25.11':
+    resolution: {integrity: sha512-TBMv6B4kCfrGJ8cUPo7vd6NECZH/8hPpBHHlYI3qzoYFvWu2AdTvZNuU/7hsbKWqu/COU7NIK12dHAAqBLLXgw==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.25.11':
+    resolution: {integrity: sha512-TmnJg8BMGPehs5JKrCLqyWTVAvielc615jbkOirATQvWWB1NMXY77oLMzsUjRLa0+ngecEmDGqt5jiDC6bfvOw==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.25.11':
+    resolution: {integrity: sha512-DIGXL2+gvDaXlaq8xruNXUJdT5tF+SBbJQKbWy/0J7OhU8gOHOzKmGIlfTTl6nHaCOoipxQbuJi7O++ldrxgMw==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.25.11':
+    resolution: {integrity: sha512-Osx1nALUJu4pU43o9OyjSCXokFkFbyzjXb6VhGIJZQ5JZi8ylCQ9/LFagolPsHtgw6himDSyb5ETSfmp4rpiKQ==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.25.11':
+    resolution: {integrity: sha512-nbLFgsQQEsBa8XSgSTSlrnBSrpoWh7ioFDUmwo158gIm5NNP+17IYmNWzaIzWmgCxq56vfr34xGkOcZ7jX6CPw==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.25.11':
+    resolution: {integrity: sha512-HfyAmqZi9uBAbgKYP1yGuI7tSREXwIb438q0nqvlpxAOs3XnZ8RsisRfmVsgV486NdjD7Mw2UrFSw51lzUk1ww==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.25.11':
+    resolution: {integrity: sha512-HjLqVgSSYnVXRisyfmzsH6mXqyvj0SA7pG5g+9W7ESgwA70AXYNpfKBqh1KbTxmQVaYxpzA/SvlB9oclGPbApw==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.25.11':
+    resolution: {integrity: sha512-HSFAT4+WYjIhrHxKBwGmOOSpphjYkcswF449j6EjsjbinTZbp8PJtjsVK1XFJStdzXdy/jaddAep2FGY+wyFAQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.25.11':
+    resolution: {integrity: sha512-hr9Oxj1Fa4r04dNpWr3P8QKVVsjQhqrMSUzZzf+LZcYjZNqhA3IAfPQdEh1FLVUJSiu6sgAwp3OmwBfbFgG2Xg==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.25.11':
+    resolution: {integrity: sha512-u7tKA+qbzBydyj0vgpu+5h5AeudxOAGncb8N6C9Kh1N4n7wU1Xw1JDApsRjpShRpXRQlJLb9wY28ELpwdPcZ7A==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.25.11':
+    resolution: {integrity: sha512-Qq6YHhayieor3DxFOoYM1q0q1uMFYb7cSpLD2qzDSvK1NAvqFi8Xgivv0cFC6J+hWVw2teCYltyy9/m/14ryHg==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.25.11':
+    resolution: {integrity: sha512-CN+7c++kkbrckTOz5hrehxWN7uIhFFlmS/hqziSFVWpAzpWrQoAG4chH+nN3Be+Kzv/uuo7zhX716x3Sn2Jduw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/openharmony-arm64@0.25.11':
+    resolution: {integrity: sha512-rOREuNIQgaiR+9QuNkbkxubbp8MSO9rONmwP5nKncnWJ9v5jQ4JxFnLu4zDSRPf3x4u+2VN4pM4RdyIzDty/wQ==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@esbuild/sunos-x64@0.25.11':
+    resolution: {integrity: sha512-nq2xdYaWxyg9DcIyXkZhcYulC6pQ2FuCgem3LI92IwMgIZ69KHeY8T4Y88pcwoLIjbed8n36CyKoYRDygNSGhA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.25.11':
+    resolution: {integrity: sha512-3XxECOWJq1qMZ3MN8srCJ/QfoLpL+VaxD/WfNRm1O3B4+AZ/BnLVgFbUV3eiRYDMXetciH16dwPbbHqwe1uU0Q==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.25.11':
+    resolution: {integrity: sha512-3ukss6gb9XZ8TlRyJlgLn17ecsK4NSQTmdIXRASVsiS2sQ6zPPZklNJT5GR5tE/MUarymmy8kCEf5xPCNCqVOA==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.25.11':
+    resolution: {integrity: sha512-D7Hpz6A2L4hzsRpPaCYkQnGOotdUpDzSGRIv9I+1ITdHROSFUWW95ZPZWQmGka1Fg7W3zFJowyn9WGwMJ0+KPA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
+  '@prettier/plugin-ruby@4.0.4':
+    resolution: {integrity: sha512-lCpvfS/dQU5WrwN3AQ5vR8qrvj2h5gE41X08NNzAAXvHdM4zwwGRcP2sHSxfu6n6No+ljWCVx95NvJPFTTjCTg==}
+    peerDependencies:
+      prettier: ^3.0.0
+
+  esbuild@0.25.11:
+    resolution: {integrity: sha512-KohQwyzrKTQmhXDW1PjCv3Tyspn9n5GcY2RTDqeORIdIJY8yKIF7sTSopFmn/wpMPW4rdPXI0UE5LJLuq3bx0Q==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  fsevents@2.3.3:
+    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  get-tsconfig@4.12.0:
+    resolution: {integrity: sha512-LScr2aNr2FbjAjZh2C6X6BxRx1/x+aTDExct/xyq2XKbYOiG5c0aK7pMsSuyc0brz3ibr/lbQiHD9jzt4lccJw==}
+
+  prettier@3.6.2:
+    resolution: {integrity: sha512-I7AIg5boAr5R0FFtJ6rCfD+LFsWHp81dolrFD8S79U9tb8Az2nGrJncnMSnys+bpQJfRUzqs9hnA81OAA3hCuQ==}
+    engines: {node: '>=14'}
+    hasBin: true
+
+  resolve-pkg-maps@1.0.0:
+    resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
+
+  tsx@4.20.6:
+    resolution: {integrity: sha512-ytQKuwgmrrkDTFP4LjR0ToE2nqgy886GpvRSpU0JAnrdBYppuY5rLkRUYPU1yCryb24SsKBTL/hlDQAEFVwtZg==}
+    engines: {node: '>=18.0.0'}
+    hasBin: true
+
+  zod@4.1.12:
+    resolution: {integrity: sha512-JInaHOamG8pt5+Ey8kGmdcAcg3OL9reK8ltczgHTAwNhMys/6ThXHityHxVV2p3fkw/c+MAvBHFVYHFZDmjMCQ==}
+
+snapshots:
+
+  '@esbuild/aix-ppc64@0.25.11':
+    optional: true
+
+  '@esbuild/android-arm64@0.25.11':
+    optional: true
+
+  '@esbuild/android-arm@0.25.11':
+    optional: true
+
+  '@esbuild/android-x64@0.25.11':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.25.11':
+    optional: true
+
+  '@esbuild/darwin-x64@0.25.11':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.25.11':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.25.11':
+    optional: true
+
+  '@esbuild/linux-arm64@0.25.11':
+    optional: true
+
+  '@esbuild/linux-arm@0.25.11':
+    optional: true
+
+  '@esbuild/linux-ia32@0.25.11':
+    optional: true
+
+  '@esbuild/linux-loong64@0.25.11':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.25.11':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.25.11':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.25.11':
+    optional: true
+
+  '@esbuild/linux-s390x@0.25.11':
+    optional: true
+
+  '@esbuild/linux-x64@0.25.11':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.25.11':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.25.11':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.25.11':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.25.11':
+    optional: true
+
+  '@esbuild/openharmony-arm64@0.25.11':
+    optional: true
+
+  '@esbuild/sunos-x64@0.25.11':
+    optional: true
+
+  '@esbuild/win32-arm64@0.25.11':
+    optional: true
+
+  '@esbuild/win32-ia32@0.25.11':
+    optional: true
+
+  '@esbuild/win32-x64@0.25.11':
+    optional: true
+
+  '@prettier/plugin-ruby@4.0.4(prettier@3.6.2)':
+    dependencies:
+      prettier: 3.6.2
+
+  esbuild@0.25.11:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.25.11
+      '@esbuild/android-arm': 0.25.11
+      '@esbuild/android-arm64': 0.25.11
+      '@esbuild/android-x64': 0.25.11
+      '@esbuild/darwin-arm64': 0.25.11
+      '@esbuild/darwin-x64': 0.25.11
+      '@esbuild/freebsd-arm64': 0.25.11
+      '@esbuild/freebsd-x64': 0.25.11
+      '@esbuild/linux-arm': 0.25.11
+      '@esbuild/linux-arm64': 0.25.11
+      '@esbuild/linux-ia32': 0.25.11
+      '@esbuild/linux-loong64': 0.25.11
+      '@esbuild/linux-mips64el': 0.25.11
+      '@esbuild/linux-ppc64': 0.25.11
+      '@esbuild/linux-riscv64': 0.25.11
+      '@esbuild/linux-s390x': 0.25.11
+      '@esbuild/linux-x64': 0.25.11
+      '@esbuild/netbsd-arm64': 0.25.11
+      '@esbuild/netbsd-x64': 0.25.11
+      '@esbuild/openbsd-arm64': 0.25.11
+      '@esbuild/openbsd-x64': 0.25.11
+      '@esbuild/openharmony-arm64': 0.25.11
+      '@esbuild/sunos-x64': 0.25.11
+      '@esbuild/win32-arm64': 0.25.11
+      '@esbuild/win32-ia32': 0.25.11
+      '@esbuild/win32-x64': 0.25.11
+
+  fsevents@2.3.3:
+    optional: true
+
+  get-tsconfig@4.12.0:
+    dependencies:
+      resolve-pkg-maps: 1.0.0
+
+  prettier@3.6.2: {}
+
+  resolve-pkg-maps@1.0.0: {}
+
+  tsx@4.20.6:
+    dependencies:
+      esbuild: 0.25.11
+      get-tsconfig: 4.12.0
+    optionalDependencies:
+      fsevents: 2.3.3
+
+  zod@4.1.12: {}

data/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+onlyBuiltDependencies:
+  - esbuild

data/proofs/error_handling.rb

@@ -0,0 +1,79 @@
+#!/usr/bin/env ruby
+# proofs/error_handling.rb
+
+require_relative 'lib/rhales'
+
+# Example demonstrating the new error hierarchy
+
+puts '=== Rhales Error Hierarchy Demo ==='
+puts
+
+# 1. Catching all Rhales errors
+begin
+  template = '{{#if user}}Hello{{else'  # Missing closing {{/if}}
+  context  = Rhales::Context.minimal(client: { user: 'John' })
+  Rhales::TemplateEngine.render(template, context)
+rescue Rhales::Error => ex
+  puts "Caught any Rhales error: #{ex.class} - #{ex.message}"
+end
+
+puts
+
+# 2. Catching render errors (which wrap parse errors)
+begin
+  template = '{{unclosed'
+  context  = Rhales::Context.minimal(client: {})
+  Rhales::TemplateEngine.render(template, context)
+rescue Rhales::TemplateEngine::RenderError => ex
+  puts 'Render error wrapping parse error:'
+  puts "  Class: #{ex.class}"
+  puts "  Message: #{ex.message}"
+end
+
+puts
+
+# 2b. Catching parse errors directly from parser
+begin
+  parser = Rhales::HandlebarsParser.new('{{unclosed')
+  parser.parse!
+rescue Rhales::ParseError => ex
+  puts 'Direct parse error details:'
+  puts "  Class: #{ex.class}"
+  puts "  Message: #{ex.message}"
+  puts "  Source type: #{ex.source_type}"
+  puts "  Line: #{ex.line}, Column: #{ex.column}"
+end
+
+puts
+
+# 3. Validation error from Parser
+begin
+  template = <<~RUE
+    <logic>
+    # Missing required sections
+    </logic>
+  RUE
+
+  parser = Rhales::RueDocument.new(template)
+  parser.parse!
+rescue Rhales::ValidationError => ex
+  puts "Validation error: #{ex.class} - #{ex.message}"
+end
+
+puts
+
+# 4. Render error example
+begin
+  template = '{{> missing_partial}}'
+  context  = Rhales::Context.minimal(client: {})
+  Rhales::TemplateEngine.render(template, context)
+rescue Rhales::RenderError => ex
+  puts "Render error: #{ex.class} - #{ex.message}"
+end
+
+puts
+puts '=== Benefits of the new hierarchy ==='
+puts '1. Single rescue for all Rhales errors: rescue Rhales::Error'
+puts '2. Stage-specific handling: ParseError, ValidationError, RenderError'
+puts '3. Consistent error attributes across all parse errors'
+puts '4. Better error messages with source context'