hyraft 0.1.0.alpha1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3f65d6ee969c94c23ae99ca813f71286ecb5264bece1b4f6b87ddbc3fa1a0218
+  data.tar.gz: 9996948d832a17aa74f1a33193088ef5356e2b42ca3c2bd334dd761bcacceebf
+SHA512:
+  metadata.gz: db8bb8e19e7f11b291a9cd486db101db9883f009e78cb56e58d1177cd7ab226c39402bd01182389a2a9571616592e113a3f47624a1f8f1a754bbbc898de2605c
+  data.tar.gz: 175e8fb071450b12431e195cd9f6ccab32f5c7ad21c425baa9fc047964dbee79476f37d3d6037c7e8da02ceb6b4e8c684357ea3cb9066dca08e259bb0cf76eec

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-10-17
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Hyraft: Demjhon Silver
+
+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/README.md

@@ -0,0 +1,231 @@
+<p align="center">
+<img src="https://raw.githubusercontent.com/demjhonsilver/hyraft/main/img/logo.png" alt="Logo" width="70" height="70"/>
+</p>
+<div align="center">
+
+# Hyraft 
+
+[![Gem Version](https://badge.fury.io/rb/hyraft.svg?icon=si%3Arubygems&icon_color=%23ffffff)](https://badge.fury.io/rb/hyraft)
+![Downloads](https://img.shields.io/gem/dt/hyraft)
+![License](https://img.shields.io/github/license/demjhonsilver/hyraft)
+![Ruby Version](https://img.shields.io/badge/ruby-%3E%3D%203.4.0-red)
+![Tests](https://github.com/demjhonsilver/hyraft/actions/workflows/ci.yml/badge.svg)
+
+
+</div>
+
+
+**A high-performance Ruby web framework with hexagonal architecture**
+
+Hyraft is a modern Ruby web framework that combines excellent performance with clean hexagonal architecture. Built for developers who want both speed and maintainability in their web applications.
+
+
+## Features
+
+-  **High Performance**: 37-55ms page renders, faster than most Ruby frameworks
+-  **Hexagonal Architecture**: Clean separation with ports, adapters, and use cases
+-  **Custom Template Engine**: `.hyr` files with metadata, displayers, transmuters, and manifestors
+-  **Multi-App Support**: Run multiple applications under one framework
+-  **Dual Server Mode**: Web server (port 1091) + API server (port 1092) simultaneously
+-  **Auto-Discovery**: Automatic template and component discovery across apps
+-  **Lightweight**: Minimal dependencies, maximum performance
+
+
+## Hyraft Components
+
+-  **Hyraft** - Framework`(Main)`
+-  **Hyraft-server** - Server `(Switch Server)`
+-  **Hyraft-rule** - CLI `(Commands)`
+
+
+## Installation
+
+Install the gem and add to your application's Gemfile:
+
+```bash
+gem install hyraft
+```
+
+## Create a new Hyraft application:
+
+```bash
+hyraft do myapp
+
+cd myapp
+
+bundle install && npm install
+```
+Run server:
+
+```bash
+
+hyraft-server thin
+
+or 
+
+hyr s thin
+```
+
+Visit:
+
+```bash
+http://localhost:1091
+```
+
+## Project Structure
+
+```bash
+myapp/
+├── adapter-intake/              # Input adapters
+│   ├── multi-app/ 
+│   ├── admin-app/
+│   ├── api-app/
+│   │   └── request/             # API controllers/adapters
+│   │       └──  articles_api_adapter.rb
+│   └── web-app/
+│       ├── request/             # Web controllers/adapters
+│       │   ├── home_web_adapter.rb
+│       │   └── articles_web_adapter.rb
+│       │   
+│       └── display/             # Hyraft templates (.hyr files)
+│           └── pages/
+│               ├── home/
+│               │   └── home.hyr
+│               └── articles/
+│                 ├── index.hyr
+│                 ├── show.hyr
+│                 ├── new.hyr
+│                 └── edit.hyr             
+│
+├── adapter-exhaust/             # Output adapters  
+│   └── data-gateway/            # Database access implementations
+│       └── sequel_articles_gateway.rb
+│
+├── engine/                      # Business logic (framework-independent)
+│   ├── source/                  # Domain entities
+│   │   └── article.rb
+│   │
+│   ├── circuit/                 # Use cases/business processes
+│   │   └── articles_circuit.rb
+│   │
+│   └── port/                    # Interfaces (abstract)
+│       └── articles_gateway_port.rb
+│
+├── framework/                       # Framework tools
+│   ├── adapters/
+│   ├── compiler/
+│   ├── errors/
+│   └── middleware/
+│      
+├── shared/                       # Shared files
+│   └── helpers/
+│       ├── pagination_helper.rb
+│       └── response_formatter.rb
+│
+├── infra/                       # Infrastructure
+│   ├── config/
+│   │   ├── routes/            # Route definitions
+│   │   │    ├── api_routes.rb    # API 
+│   │   │    └── web_routes.rb    # Web
+│   │   │
+│   │   ├── environment.rb
+│   │   └── error_config.rb
+│   │   
+│   ├── database/
+│   │   ├── migrations/          # Database schema
+│   │   │   ├── 001_create_articles.rb
+│   │   │   └── 002_add_image_to_articles.rb
+│   │   │
+│   │   └── sequel_connection.rb # Database configuration
+│   │   
+│   ├── gems/                  # Third party gems to import
+│   │   ├── database.rb        # Database gems
+│   │   ├── load_all.rb        # Load all gems
+│   │   ├── utilities.rb       # Utilities
+│   │   └── web.rb             # Web gems
+│   │ 
+│   └── server/
+│       ├── api-server.ru        # Rack api configuration
+│       └── web-server.ru        # Rack web configuration
+│         
+├── public/                      # Static assets
+│    ├── uploads/                 # File uploads (images, etc.)
+│    ├── icons/
+│    ├── styles/
+│    │   └── css/
+│    │       ├── main.css
+│    │       └── spa.css
+│    ├── images/
+│    │   ├── hyr-logo.png
+│    │   └── hyr-logo.webp
+│    ├── favicon.ico
+│    │
+│    └── index.html
+│
+├── boot.rb
+├── env.yml
+├── Gemfile
+└── package.json
+
+
+```
+
+## # For template files ( .hyr )
+
+
+## VS Code Extension
+Enhanced development experience with Hyraft extension for VS Code.
+
+Install from VS Code:
+
+```bash
+# Open VS Code then press (ctrl + shift + x)
+# Search for "Hyraft"
+# Click Install
+```
+
+## VS Code Extension ( snippets ) 
+
+Prefix:
+
+Type 3 letters: hyr
+
+
+It will display the following snippet options:
+
+----------
+
+- hyr-component
+- hyr-embed
+- hyr-html-method
+- hyr-interp
+- hyr-template
+
+----------
+
+* In a VS Code extension, snippets are predefined pieces of code or text that can be inserted quickly using a trigger (a prefix) in the editor.
+
+
+## Official site
+
+Visit: [https://hyraft.com](https://hyraft.com)
+
+
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies.
+
+Then, run `rake test` to run the tests.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/demjhonsilver/hyraft. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/demjhonsilver/hyraft/blob/master/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Hyraft project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/demjhonsilver/hyraft/blob/master/CODE_OF_CONDUCT.md).

data/exe/hyraft

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "hyraft"
+Hyraft::CLI.start(ARGV)
+

data/lib/hyraft/boot/asset_preloader.rb

@@ -0,0 +1,185 @@
+# lib/hyraft/boot/asset_preloader.rb
+module Hyraft
+  module AssetPreloader
+    COLORS = {
+      green:  "\e[32m",
+      cyan:   "\e[36m", 
+      yellow: "\e[33m",
+      red:    "\e[31m",
+      orange: "\e[38;5;214m",  
+      blue:   "\e[34m",     
+      lightblue: "\e[94m",   
+      reset:  "\e[0m"
+    }
+
+    @preloaded_assets = {}
+    @stats = {
+      total_assets: 0,
+      total_bytes: 0,
+      compressed_bytes: 0,
+      load_time: 0.0
+    }
+
+    def self.preload_assets(public_path)
+      puts "#{COLORS[:green]} Hyraft Asset Preloader: Scanning for assets...#{COLORS[:reset]}"
+      
+      start_time = Time.now
+      assets_found = discover_assets(public_path)
+      
+      puts "Found #{assets_found.size} asset files"
+      
+      assets_found.each do |asset_path|
+        preload_asset(asset_path, public_path)
+      end
+      
+      @stats[:load_time] = Time.now - start_time
+      print_stats
+    end
+
+    def self.discover_assets(public_path)
+      return [] unless File.exist?(public_path)
+      
+      assets = []
+      
+      # Look for assets in common locations
+      asset_patterns = [
+        "styles/css/**/*.css",
+        "css/**/*.css", 
+        "images/**/*.{jpg,jpeg,png,gif,svg,webp,ico}",
+        "js/**/*.js",
+        "favicon.ico"
+      ]
+      
+      asset_patterns.each do |pattern|
+        full_pattern = File.join(public_path, pattern)
+        assets += Dir.glob(full_pattern)
+      end
+      
+      assets.sort
+    end
+
+    def self.preload_asset(asset_path, public_path)
+      relative_path = asset_path.sub(public_path + '/', '')
+      
+      begin
+        content = File.read(asset_path, mode: 'rb')
+        compressed = compress_asset(content, File.extname(asset_path))
+        
+        @preloaded_assets[relative_path] = {
+          content: content,
+          compressed: compressed,
+          size: content.bytesize,
+          compressed_size: compressed.bytesize,
+          mtime: File.mtime(asset_path),
+          content_type: content_type_for(asset_path)
+        }
+        
+        @stats[:total_assets] += 1
+        @stats[:total_bytes] += content.bytesize
+        @stats[:compressed_bytes] += compressed.bytesize
+        
+        compression_ratio = ((1 - compressed.bytesize.to_f / content.bytesize) * 100).round(2)
+        
+        puts "  #{COLORS[:green]}✓#{COLORS[:reset]} #{COLORS[:lightblue]}#{relative_path}#{COLORS[:reset]} " \
+             "(#{COLORS[:yellow]}#{(content.bytesize / 1024.0).round(2)} KB#{COLORS[:reset]} → " \
+             "#{COLORS[:cyan]}#{(compressed.bytesize / 1024.0).round(2)} KB#{COLORS[:reset]} " \
+             "#{COLORS[:green]}#{compression_ratio}%#{COLORS[:reset]})"
+             
+      rescue => e
+        puts "  #{COLORS[:red]}✗#{COLORS[:reset]} #{COLORS[:cyan]}#{relative_path}#{COLORS[:reset]} " \
+             "#{COLORS[:red]}Error: #{e.message}#{COLORS[:reset]}"
+      end
+    end
+
+    def self.compress_asset(content, extname)
+      case extname.downcase
+      when '.css'
+        compress_css(content)
+      when '.js'
+        compress_js(content)
+      else
+        content
+      end
+    end
+
+    def self.compress_css(css)
+      css.gsub(/\/\*.*?\*\//m, '')
+         .gsub(/\s+/, ' ')
+         .gsub(/;\s*}/, '}')
+         .gsub(/\s*{\s*/, '{')
+         .gsub(/\s*}\s*/, '}')
+         .gsub(/:\s+/, ':')
+         .gsub(/,\s+/, ',')
+         .strip
+    end
+
+    def self.compress_js(js)
+      js.gsub(/\/\/.*?$/, '')
+        .gsub(/\/\*.*?\*\//m, '')
+        .gsub(/\s+/, ' ')
+        .gsub(/\s*([=+\-\/*{}()\[\],;:])\s*/, '\1')  
+        .strip
+    end
+
+    def self.content_type_for(file_path)
+      case File.extname(file_path).downcase
+      when '.css' then 'text/css'
+      when '.js' then 'application/javascript'
+      when '.jpg', '.jpeg' then 'image/jpeg'
+      when '.png' then 'image/png'
+      when '.gif' then 'image/gif'
+      when '.svg' then 'image/svg+xml'
+      when '.webp' then 'image/webp'
+      when '.ico' then 'image/x-icon'
+      else 'application/octet-stream'
+      end
+    end
+
+    def self.get_asset(asset_path)
+      @preloaded_assets[asset_path]
+    end
+
+    def self.asset_preloaded?(asset_path)
+      @preloaded_assets.key?(asset_path)
+    end
+
+    def self.serve_asset(asset_path)
+      return nil unless asset_preloaded?(asset_path)
+      get_asset(asset_path)
+    end
+
+    def self.stats
+      @stats.dup
+    end
+
+    private
+
+    def self.print_stats
+      puts "\n#{COLORS[:green]}Asset Preload Statistics:#{COLORS[:reset]}"
+      puts "   #{COLORS[:cyan]}Assets:#{COLORS[:reset]} #{@stats[:total_assets]}"
+      puts "   #{COLORS[:cyan]}Original Size:#{COLORS[:reset]} #{(@stats[:total_bytes] / 1024.0).round(2)} KB" 
+      puts "   #{COLORS[:cyan]}Compressed Size:#{COLORS[:reset]} #{(@stats[:compressed_bytes] / 1024.0).round(2)} KB"
+      puts "   #{COLORS[:cyan]}Total Savings:#{COLORS[:reset]} #{((@stats[:total_bytes] - @stats[:compressed_bytes]) / 1024.0).round(2)} KB"
+      puts "   #{COLORS[:cyan]}Load Time:#{COLORS[:reset]} #{@stats[:load_time].round(3)}s"
+      puts "   #{COLORS[:cyan]}Memory:#{COLORS[:reset]} #{memory_usage} MB"
+      puts "   #{COLORS[:cyan]}Status:#{COLORS[:reset]} #{COLORS[:green]}ASSETS PRELOADED#{COLORS[:reset]}\n\n"
+    end
+
+    def self.memory_usage
+      if Gem.win_platform?
+        # Windows (no `ps -o rss=`)
+        get_windows_memory
+      else
+        # Linux/Mac
+        (`ps -o rss= -p #{Process.pid}`.to_i / 1024.0).round(2)
+      end
+    end
+
+    def self.get_windows_memory
+      memory_kb = `tasklist /FI "PID eq #{Process.pid}" /FO CSV /NH`
+                    .split(",")[4].to_s.gsub('"','').gsub(/[^0-9]/, '').to_i
+      (memory_kb / 1024.0).round(2)
+    end
+    
+  end
+end

data/lib/hyraft/boot/preloaded_static.rb

@@ -0,0 +1,46 @@
+
+require 'digest'
+
+module Hyraft
+  class PreloadedStatic
+    def initialize(app, options = {})
+      @app = app
+      @urls = options[:urls] || ["/styles", "/css", "/images", "/js", "/favicon.ico"]
+    end
+
+    def call(env)
+      path = env['PATH_INFO']
+      
+      # Check if this is a static asset we should handle
+      if @urls.any? { |url| path.start_with?(url) }
+        serve_preloaded_asset(path)
+      else
+        @app.call(env)
+      end
+    end
+
+    private
+
+    def serve_preloaded_asset(path)
+      # Normalize path (remove leading slash)
+      asset_path = path.start_with?('/') ? path[1..-1] : path
+      
+      if Hyraft::AssetPreloader.asset_preloaded?(asset_path)
+        # ULTRA FAST: Serve from memory
+        asset_data = Hyraft::AssetPreloader.serve_asset(asset_path)
+        
+        headers = {
+          'Content-Type' => asset_data[:content_type],
+          'Content-Length' => asset_data[:compressed_size].to_s,
+          'Cache-Control' => 'public, max-age=86400',
+          'ETag' => Digest::MD5.hexdigest(asset_data[:compressed])
+        }
+        
+        [200, headers, [asset_data[:compressed]]]
+      else
+        # Fallback to original request
+        @app.call(env)
+      end
+    end
+  end
+end