tina4ruby 0.4.0

data/lib/tina4/response.rb

@@ -0,0 +1,172 @@
+# frozen_string_literal: true
+require "json"
+require "uri"
+
+module Tina4
+  class Response
+    MIME_TYPES = {
+      ".html" => "text/html", ".htm" => "text/html",
+      ".css" => "text/css", ".js" => "application/javascript",
+      ".json" => "application/json", ".xml" => "application/xml",
+      ".txt" => "text/plain", ".csv" => "text/csv",
+      ".png" => "image/png", ".jpg" => "image/jpeg",
+      ".jpeg" => "image/jpeg", ".gif" => "image/gif",
+      ".svg" => "image/svg+xml", ".ico" => "image/x-icon",
+      ".webp" => "image/webp", ".pdf" => "application/pdf",
+      ".zip" => "application/zip", ".woff" => "font/woff",
+      ".woff2" => "font/woff2", ".ttf" => "font/ttf",
+      ".eot" => "application/vnd.ms-fontobject",
+      ".mp3" => "audio/mpeg", ".mp4" => "video/mp4",
+      ".webm" => "video/webm"
+    }.freeze
+
+    # Pre-frozen header values
+    JSON_CONTENT_TYPE = "application/json; charset=utf-8"
+    HTML_CONTENT_TYPE = "text/html; charset=utf-8"
+    TEXT_CONTENT_TYPE = "text/plain; charset=utf-8"
+    XML_CONTENT_TYPE  = "application/xml; charset=utf-8"
+
+    attr_accessor :status, :headers, :body, :cookies
+
+    def initialize
+      @status = 200
+      @headers = { "content-type" => HTML_CONTENT_TYPE }
+      @body = ""
+      @cookies = nil  # Lazy — most responses have no cookies
+    end
+
+    def json(data, status_or_opts = nil, status: nil)
+      @status = status || (status_or_opts.is_a?(Integer) ? status_or_opts : 200)
+      @headers["content-type"] = JSON_CONTENT_TYPE
+      @body = data.is_a?(String) ? data : JSON.generate(data)
+      self
+    end
+
+    def html(content, status_or_opts = nil, status: nil)
+      @status = status || (status_or_opts.is_a?(Integer) ? status_or_opts : 200)
+      @headers["content-type"] = HTML_CONTENT_TYPE
+      @body = content.to_s
+      self
+    end
+
+    def text(content, status_or_opts = nil, status: nil)
+      @status = status || (status_or_opts.is_a?(Integer) ? status_or_opts : 200)
+      @headers["content-type"] = TEXT_CONTENT_TYPE
+      @body = content.to_s
+      self
+    end
+
+    def xml(content, status: 200)
+      @status = status
+      @headers["content-type"] = XML_CONTENT_TYPE
+      @body = content.to_s
+      self
+    end
+
+    def csv(content, filename: "export.csv", status: 200)
+      @status = status
+      @headers["content-type"] = "text/csv"
+      @headers["content-disposition"] = "attachment; filename=\"#{filename}\""
+      @body = content.to_s
+      self
+    end
+
+    def redirect(url, status: 302)
+      @status = status
+      @headers["location"] = url
+      @body = ""
+      self
+    end
+
+    def file(path, content_type: nil, download: false)
+      unless ::File.exist?(path)
+        @status = 404
+        @body = "File not found"
+        return self
+      end
+      ext = ::File.extname(path).downcase
+      @headers["content-type"] = content_type || MIME_TYPES[ext] || "application/octet-stream"
+      if download
+        @headers["content-disposition"] = "attachment; filename=\"#{::File.basename(path)}\""
+      end
+      @body = ::File.binread(path)
+      self
+    end
+
+    def render(template_path, data = {}, status: 200)
+      @status = status
+      @headers["content-type"] = HTML_CONTENT_TYPE
+      @body = Tina4::Template.render(template_path, data)
+      self
+    end
+
+    def set_cookie(name, value, opts = {})
+      cookie = "#{name}=#{URI.encode_www_form_component(value)}"
+      cookie += "; Path=#{opts[:path] || '/'}"
+      cookie += "; HttpOnly" if opts.fetch(:http_only, true)
+      cookie += "; Secure" if opts[:secure]
+      cookie += "; SameSite=#{opts[:same_site] || 'Lax'}"
+      cookie += "; Max-Age=#{opts[:max_age]}" if opts[:max_age]
+      cookie += "; Expires=#{opts[:expires].httpdate}" if opts[:expires]
+      @cookies ||= []
+      @cookies << cookie
+      self
+    end
+
+    def delete_cookie(name, path: "/")
+      set_cookie(name, "", max_age: 0, path: path)
+    end
+
+    def add_header(key, value)
+      @headers[key] = value
+      self
+    end
+
+    def add_cors_headers(origin: "*", methods: "GET, POST, PUT, PATCH, DELETE, OPTIONS",
+                         headers_list: "Content-Type, Authorization, Accept", credentials: false)
+      @headers["access-control-allow-origin"] = origin
+      @headers["access-control-allow-methods"] = methods
+      @headers["access-control-allow-headers"] = headers_list
+      @headers["access-control-allow-credentials"] = "true" if credentials
+      @headers["access-control-max-age"] = "86400"
+      self
+    end
+
+    def to_rack
+      # Fast path: no cookies (99% of API responses)
+      if @cookies.nil? || @cookies.empty?
+        return [@status, @headers, [@body.to_s]]
+      end
+
+      # Cookie path
+      final_headers = @headers.dup
+      final_headers["set-cookie"] = @cookies.join("\n")
+      [@status, final_headers, [@body.to_s]]
+    end
+
+    def self.auto_detect(result, response)
+      case result
+      when Tina4::Response
+        result
+      when Hash, Array
+        response.json(result)
+      when String
+        if result.start_with?("<")
+          response.html(result)
+        else
+          response.text(result)
+        end
+      when Integer
+        response.status = result
+        response.body = ""
+        response
+      when NilClass
+        response.status = 204
+        response.body = ""
+        response
+      else
+        response.json(result.respond_to?(:to_hash) ? result.to_hash : { data: result.to_s })
+      end
+    end
+  end
+end

data/lib/tina4/router.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+module Tina4
+  class Route
+    attr_reader :method, :path, :handler, :auth_handler, :swagger_meta, :path_regex, :param_names
+
+    def initialize(method, path, handler, auth_handler: nil, swagger_meta: {})
+      @method = method.to_s.upcase.freeze
+      @path = normalize_path(path).freeze
+      @handler = handler
+      @auth_handler = auth_handler
+      @swagger_meta = swagger_meta
+      @param_names = []
+      @path_regex = compile_pattern(@path)
+      @param_names.freeze
+    end
+
+    # Returns params hash if matched, false otherwise
+    def match?(request_path, request_method = nil)
+      return false if request_method && @method != request_method.to_s.upcase
+      match_path(request_path)
+    end
+
+    # Returns params hash if matched, false otherwise
+    def match_path(request_path)
+      match = @path_regex.match(request_path)
+      return false unless match
+
+      if @param_names.empty?
+        # Static route — no params to extract
+        {}
+      else
+        params = {}
+        @param_names.each_with_index do |param_def, i|
+          raw_value = match[i + 1]
+          params[param_def[:name]] = cast_param(raw_value, param_def[:type])
+        end
+        params
+      end
+    end
+
+    private
+
+    def normalize_path(path)
+      p = path.to_s.gsub("\\", "/")
+      p = "/#{p}" unless p.start_with?("/")
+      p = p.chomp("/") unless p == "/"
+      p
+    end
+
+    def compile_pattern(path)
+      return Regexp.new("\\A/\\z") if path == "/"
+
+      parts = path.split("/").reject(&:empty?)
+      regex_parts = parts.map do |part|
+        if part =~ /\A\{(\w+)(?::(\w+))?\}\z/
+          name = Regexp.last_match(1)
+          type = Regexp.last_match(2) || "string"
+          @param_names << { name: name.to_sym, type: type }
+          case type
+          when "int", "integer"
+            '(\d+)'
+          when "float", "number"
+            '([\d.]+)'
+          when "path"
+            '(.+)'
+          else
+            '([^/]+)'
+          end
+        else
+          Regexp.escape(part)
+        end
+      end
+      Regexp.new("\\A/#{regex_parts.join("/")}\\z")
+    end
+
+    def cast_param(value, type)
+      case type
+      when "int", "integer"
+        value.to_i
+      when "float", "number"
+        value.to_f
+      else
+        value
+      end
+    end
+  end
+
+  module Router
+    class << self
+      def routes
+        @routes ||= []
+      end
+
+      # Routes indexed by HTTP method for O(1) method lookup
+      def method_index
+        @method_index ||= Hash.new { |h, k| h[k] = [] }
+      end
+
+      def add_route(method, path, handler, auth_handler: nil, swagger_meta: {})
+        route = Route.new(method, path, handler, auth_handler: auth_handler, swagger_meta: swagger_meta)
+        routes << route
+        method_index[route.method] << route
+        Tina4::Debug.debug("Route registered: #{method.upcase} #{path}")
+        route
+      end
+
+      def find_route(path, method)
+        normalized_method = method.upcase
+        # Normalize path once (not per-route)
+        normalized_path = path.gsub("\\", "/")
+        normalized_path = "/#{normalized_path}" unless normalized_path.start_with?("/")
+        normalized_path = normalized_path.chomp("/") unless normalized_path == "/"
+
+        # Only scan routes matching this HTTP method
+        candidates = method_index[normalized_method]
+        candidates.each do |route|
+          params = route.match_path(normalized_path)
+          return [route, params] if params
+        end
+        nil
+      end
+
+      def clear!
+        @routes = []
+        @method_index = Hash.new { |h, k| h[k] = [] }
+      end
+
+      def group(prefix, auth_handler: nil, &block)
+        GroupContext.new(prefix, auth_handler).instance_eval(&block)
+      end
+    end
+
+    class GroupContext
+      def initialize(prefix, auth_handler = nil)
+        @prefix = prefix.chomp("/")
+        @auth_handler = auth_handler
+      end
+
+      %w[get post put patch delete any].each do |m|
+        define_method(m) do |path, swagger_meta: {}, &handler|
+          full_path = "#{@prefix}#{path}"
+          Tina4::Router.add_route(m, full_path, handler, auth_handler: @auth_handler, swagger_meta: swagger_meta)
+        end
+      end
+    end
+  end
+end

data/lib/tina4/scss/tina4css/_alerts.scss

@@ -0,0 +1,34 @@
+// Tina4 CSS Framework - Alerts
+// -------------------------------
+
+.alert {
+  position: relative;
+  padding: 0.75rem 1rem;
+  margin-bottom: 1rem;
+  border: 1px solid transparent;
+  border-radius: $border-radius;
+}
+
+@each $name, $color in $theme-colors {
+  .alert-#{$name} {
+    color: darken($color, 25%);
+    background-color: lighten($color, 35%);
+    border-color: lighten($color, 25%);
+  }
+}
+
+.alert-dismissible {
+  padding-right: 3rem;
+  .btn-close {
+    position: absolute;
+    top: 0;
+    right: 0;
+    padding: 0.9375rem 1rem;
+    background: transparent;
+    border: 0;
+    cursor: pointer;
+    color: inherit;
+    opacity: 0.5;
+    &:hover { opacity: 0.75; }
+  }
+}

data/lib/tina4/scss/tina4css/_badges.scss

@@ -0,0 +1,22 @@
+// Tina4 CSS Framework - Badges
+// -------------------------------
+
+.badge {
+  display: inline-block;
+  padding: 0.25em 0.65em;
+  font-size: 0.75em;
+  font-weight: $font-weight-bold;
+  line-height: 1;
+  color: $white;
+  text-align: center;
+  white-space: nowrap;
+  vertical-align: baseline;
+  border-radius: $border-radius-pill;
+}
+
+@each $name, $color in $theme-colors {
+  .badge-#{$name} {
+    color: if($name == "light" or $name == "warning", $dark, $white);
+    background-color: $color;
+  }
+}

data/lib/tina4/scss/tina4css/_buttons.scss

@@ -0,0 +1,69 @@
+// Tina4 CSS Framework - Buttons
+// --------------------------------
+
+.btn {
+  display: inline-block;
+  font-weight: $font-weight-normal;
+  line-height: $line-height-base;
+  color: $body-color;
+  text-align: center;
+  vertical-align: middle;
+  cursor: pointer;
+  user-select: none;
+  background-color: transparent;
+  border: 1px solid transparent;
+  padding: 0.375rem 0.75rem;
+  font-size: $font-size-base;
+  border-radius: $border-radius;
+  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;
+  text-decoration: none;
+
+  &:disabled, &.disabled {
+    pointer-events: none;
+    opacity: 0.65;
+  }
+}
+
+// Solid buttons
+@each $name, $color in $theme-colors {
+  $text: if($name == "light" or $name == "warning", $dark, $white);
+  .btn-#{$name} {
+    color: $text;
+    background-color: $color;
+    border-color: $color;
+    &:hover {
+      background-color: darken($color, 8%);
+      border-color: darken($color, 10%);
+    }
+  }
+}
+
+// Outline buttons
+@each $name, $color in $theme-colors {
+  .btn-outline-#{$name} {
+    color: $color;
+    border-color: $color;
+    background-color: transparent;
+    &:hover {
+      color: if($name == "light" or $name == "warning", $dark, $white);
+      background-color: $color;
+    }
+  }
+}
+
+.btn-sm {
+  padding: 0.25rem 0.5rem;
+  font-size: $font-size-sm;
+  border-radius: $border-radius-sm;
+}
+
+.btn-lg {
+  padding: 0.5rem 1rem;
+  font-size: $font-size-lg;
+  border-radius: $border-radius-lg;
+}
+
+.btn-block {
+  display: block;
+  width: 100%;
+}

data/lib/tina4/scss/tina4css/_cards.scss

@@ -0,0 +1,49 @@
+// Tina4 CSS Framework - Cards
+// ------------------------------
+
+.card {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  word-wrap: break-word;
+  background-color: $white;
+  background-clip: border-box;
+  border: 1px solid rgba($black, 0.125);
+  border-radius: $border-radius-lg;
+}
+
+.card-header {
+  padding: 0.75rem 1rem;
+  margin-bottom: 0;
+  background-color: rgba($black, 0.03);
+  border-bottom: 1px solid rgba($black, 0.125);
+  &:first-child { border-radius: calc($border-radius-lg - 1px) calc($border-radius-lg - 1px) 0 0; }
+}
+
+.card-body {
+  flex: 1 1 auto;
+  padding: 1rem;
+}
+
+.card-footer {
+  padding: 0.75rem 1rem;
+  background-color: rgba($black, 0.03);
+  border-top: 1px solid rgba($black, 0.125);
+  &:last-child { border-radius: 0 0 calc($border-radius-lg - 1px) calc($border-radius-lg - 1px); }
+}
+
+.card-title {
+  margin-bottom: 0.5rem;
+  font-weight: $font-weight-bold;
+}
+
+.card-text:last-child {
+  margin-bottom: 0;
+}
+
+.card-img-top {
+  width: 100%;
+  border-top-left-radius: calc($border-radius-lg - 1px);
+  border-top-right-radius: calc($border-radius-lg - 1px);
+}

data/lib/tina4/scss/tina4css/_forms.scss

@@ -0,0 +1,156 @@
+// Tina4 CSS Framework - Forms
+// ------------------------------
+
+.form-group {
+  margin-bottom: 1rem;
+}
+
+.form-label {
+  display: inline-block;
+  margin-bottom: 0.5rem;
+  font-weight: $font-weight-bold;
+}
+
+.form-control {
+  display: block;
+  width: 100%;
+  padding: 0.375rem 0.75rem;
+  font-size: $font-size-base;
+  font-weight: $font-weight-normal;
+  line-height: $line-height-base;
+  color: $body-color;
+  background-color: $white;
+  background-clip: padding-box;
+  border: 1px solid #ced4da;
+  border-radius: $border-radius;
+  transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;
+  appearance: none;
+
+  &:focus {
+    color: $body-color;
+    background-color: $white;
+    border-color: lighten($primary, 25%);
+    outline: 0;
+    box-shadow: 0 0 0 0.2rem rgba($primary, 0.25);
+  }
+
+  &::placeholder {
+    color: $muted;
+    opacity: 1;
+  }
+
+  &:disabled {
+    background-color: $light;
+    opacity: 1;
+  }
+}
+
+textarea.form-control {
+  min-height: calc(1.5em + 0.75rem + 2px);
+}
+
+.form-select {
+  display: block;
+  width: 100%;
+  padding: 0.375rem 2.25rem 0.375rem 0.75rem;
+  font-size: $font-size-base;
+  font-weight: $font-weight-normal;
+  line-height: $line-height-base;
+  color: $body-color;
+  background-color: $white;
+  border: 1px solid #ced4da;
+  border-radius: $border-radius;
+  transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;
+  appearance: none;
+
+  &:focus {
+    border-color: lighten($primary, 25%);
+    outline: 0;
+    box-shadow: 0 0 0 0.2rem rgba($primary, 0.25);
+  }
+}
+
+// Checkboxes and radios
+.form-check {
+  display: block;
+  min-height: $line-height-base * 1rem;
+  padding-left: 1.5em;
+  margin-bottom: 0.125rem;
+}
+
+.form-check-input {
+  float: left;
+  width: 1em;
+  height: 1em;
+  margin-left: -1.5em;
+  margin-top: 0.25em;
+  appearance: none;
+  background-color: $white;
+  border: 1px solid rgba($black, 0.25);
+  &[type="checkbox"] { border-radius: 0.25em; }
+  &[type="radio"] { border-radius: 50%; }
+  &:checked { background-color: $primary; border-color: $primary; }
+  &:focus { border-color: lighten($primary, 25%); outline: 0; box-shadow: 0 0 0 0.2rem rgba($primary, 0.25); }
+}
+
+.form-check-label { cursor: pointer; }
+
+// Validation
+.is-valid {
+  border-color: $success !important;
+  &:focus {
+    box-shadow: 0 0 0 0.2rem rgba($success, 0.25) !important;
+  }
+}
+
+.is-invalid {
+  border-color: $danger !important;
+  &:focus {
+    box-shadow: 0 0 0 0.2rem rgba($danger, 0.25) !important;
+  }
+}
+
+.valid-feedback,
+.invalid-feedback {
+  display: none;
+  width: 100%;
+  margin-top: 0.25rem;
+  font-size: 0.875em;
+}
+.valid-feedback { color: $success; }
+.invalid-feedback { color: $danger; }
+
+.is-valid ~ .valid-feedback,
+.is-invalid ~ .invalid-feedback {
+  display: block;
+}
+
+// Input group
+.input-group {
+  position: relative;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: stretch;
+  width: 100%;
+  > .form-control,
+  > .form-select {
+    position: relative;
+    flex: 1 1 auto;
+    width: 1%;
+    min-width: 0;
+  }
+}
+
+.input-group-text {
+  display: flex;
+  align-items: center;
+  padding: 0.375rem 0.75rem;
+  font-size: $font-size-base;
+  line-height: $line-height-base;
+  color: $body-color;
+  text-align: center;
+  white-space: nowrap;
+  background-color: $light;
+  border: 1px solid #ced4da;
+  border-radius: $border-radius;
+}