explicit 0.2.14 → 0.2.16

data/lib/explicit/type/agreement.rb

@@ -26,14 +26,12 @@ class Explicit::Type::Agreement < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "boolean",
-        description_topics: [
-          swagger_i18n("agreement")
-        ]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "boolean",
+      description_topics: [
+        swagger_i18n("agreement")
+      ]
+    }
   end
 end

data/lib/explicit/type/any.rb

@@ -19,9 +19,9 @@ class Explicit::Type::Any < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({})
-    end
+  def json_schema(flavour)
+    return {} if flavour == :swagger
+
+    { type: "string" }
   end
 end

data/lib/explicit/type/array.rb

@@ -43,13 +43,11 @@ class Explicit::Type::Array < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "array",
-        items: item_type.swagger_schema,
-        minItems: empty ? 0 : 1
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "array",
+      items: item_type.mcp_schema,
+      minItems: empty ? 0 : 1
+    }
   end
 end

data/lib/explicit/type/big_decimal.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
 class Explicit::Type::BigDecimal < Explicit::Type
-  attr_reader :min, :max
+  attr_reader :min, :max, :negative, :positive
 
-  def initialize(min: nil, max: nil)
+  def initialize(min: nil, max: nil, negative: nil, positive: nil)
     @min = min
     @max = max
+    @negative = negative
+    @positive = positive
   end
 
   def validate(value)
@@ -23,6 +25,22 @@ class Explicit::Type::BigDecimal < Explicit::Type
       return error_i18n("max", max:)
     end
 
+    if negative == false && decimal_value < 0
+      return error_i18n("not_negative")
+    end
+
+    if negative == true && decimal_value >= 0
+      return error_i18n("only_negative")
+    end
+
+    if positive == false && decimal_value > 0
+      return error_i18n("not_positive")
+    end
+
+    if positive == true && decimal_value <= 0
+      return error_i18n("only_positive")
+    end
+
     [:ok, decimal_value]
   rescue ArgumentError
     return error_i18n("big_decimal")
@@ -30,7 +48,7 @@ class Explicit::Type::BigDecimal < Explicit::Type
 
   concerning :Webpage do
     def summary
-      "string"
+      "decimal string"
     end
 
     def partial
@@ -42,17 +60,20 @@ class Explicit::Type::BigDecimal < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "string",
-        pattern: /^\d*\.?\d*$/.inspect[1..-2],
-        format: "decimal number",
-        description_topics: [
-          min&.then { swagger_i18n("big_decimal_min", min: _1) },
-          max&.then { swagger_i18n("big_decimal_max", max: _1) }
-        ]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "string",
+      pattern: /^\d*\.?\d*$/.inspect[1..-2],
+      format: "decimal number",
+      description_topics: [
+        swagger_i18n("big_decimal_format"),
+        min&.then { swagger_i18n("big_decimal_min", min: _1) },
+        max&.then { swagger_i18n("big_decimal_max", max: _1) },
+        positive == false ? swagger_i18n("number_not_positive") : nil,
+        positive == true ? swagger_i18n("number_only_positive") : nil,
+        negative == false ? swagger_i18n("number_not_negative") : nil,
+        negative == true ? swagger_i18n("number_only_negative") : nil
+      ].compact
+    }
   end
 end

data/lib/explicit/type/boolean.rb

@@ -36,11 +36,9 @@ class Explicit::Type::Boolean < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "boolean"
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "boolean"
+    }
   end
 end

data/lib/explicit/type/date.rb

@@ -51,16 +51,14 @@ class Explicit::Type::Date < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "string",
-        pattern: /\d{4}-\d{2}-\d{2}/.inspect[1..-2],
-        format: "date",
-        description_topics: [
-          swagger_i18n("date_format")
-        ]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "string",
+      pattern: /\d{4}-\d{2}-\d{2}/.inspect[1..-2],
+      format: "date",
+      description_topics: [
+        swagger_i18n("date_format")
+      ]
+    }
   end
 end

data/lib/explicit/type/date_range.rb

@@ -78,18 +78,16 @@ class Explicit::Type::DateRange < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "string",
-        pattern: FORMAT.inspect[1..-2],
-        format: "date range",
-        description_topics: [
-          swagger_i18n("date_range"),
-          min_range&.then { swagger_i18n("date_range_min_range", min_range: _1.inspect) },
-          max_range&.then { swagger_i18n("date_range_max_range", max_range: _1.inspect) },
-        ]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "string",
+      pattern: FORMAT.inspect[1..-2],
+      format: "date range",
+      description_topics: [
+        swagger_i18n("date_range"),
+        min_range&.then { swagger_i18n("date_range_min_range", min_range: _1.inspect) },
+        max_range&.then { swagger_i18n("date_range_max_range", max_range: _1.inspect) },
+      ]
+    }
   end
 end

data/lib/explicit/type/date_time_iso8601.rb

@@ -52,15 +52,13 @@ class Explicit::Type::DateTimeISO8601 < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "string",
-        format: "date-time",
-        description_topics: [
-          swagger_i18n("date_time_iso8601")
-        ]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "string",
+      format: "date-time",
+      description_topics: [
+        swagger_i18n("date_time_iso8601")
+      ]
+    }
   end
-end
+end

data/lib/explicit/type/date_time_iso8601_range.rb

@@ -92,17 +92,15 @@ class Explicit::Type::DateTimeISO8601Range < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "string",
-        format: "date time range",
-        description_topics: [
-          swagger_i18n("date_time_iso8601_range"),
-          min_range&.then { swagger_i18n("date_time_iso8601_range_min_range", min_range: _1.inspect) },
-          max_range&.then { swagger_i18n("date_time_iso8601_range_max_range", max_range: _1.inspect) },
-        ]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "string",
+      format: "date time range",
+      description_topics: [
+        swagger_i18n("date_time_iso8601_range"),
+        min_range&.then { swagger_i18n("date_time_iso8601_range_min_range", min_range: _1.inspect) },
+        max_range&.then { swagger_i18n("date_time_iso8601_range_max_range", max_range: _1.inspect) },
+      ]
+    }
   end
 end

data/lib/explicit/type/date_time_unix_epoch.rb

@@ -54,16 +54,14 @@ class Explicit::Type::DateTimeUnixEpoch < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "integer",
-        minimum: 1,
-        format: "POSIX time",
-        description_topics: [
-          swagger_i18n("date_time_unix_epoch")
-        ]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "integer",
+      minimum: 1,
+      format: "POSIX time",
+      description_topics: [
+        swagger_i18n("date_time_unix_epoch")
+      ]
+    }
   end
 end

data/lib/explicit/type/enum.rb

@@ -29,12 +29,10 @@ class Explicit::Type::Enum < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "string",
-        enum: allowed_values
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "string",
+      enum: allowed_values
+    }
   end
 end

data/lib/explicit/type/file.rb

@@ -45,16 +45,14 @@ class Explicit::Type::File < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "string",
-        format: "binary",
-        description_topics: [
-          max_size&.then { swagger_i18n("file_max_size", max_size: number_to_human_size(_1)) },
-          content_types.any? ? swagger_i18n("file_content_types", content_types: content_types.join(', ')) : nil
-        ]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "string",
+      format: "binary",
+      description_topics: [
+        max_size&.then { swagger_i18n("file_max_size", max_size: number_to_human_size(_1)) },
+        content_types.any? ? swagger_i18n("file_content_types", content_types: content_types.join(', ')) : nil
+      ]
+    }
   end
 end

data/lib/explicit/type/float.rb

@@ -69,19 +69,17 @@ class Explicit::Type::Float < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "number",
-        minimum: min,
-        maximum: max,
-        description_topics: [
-          positive == false ? swagger_i18n("number_not_positive") : nil,
-          positive == true ? swagger_i18n("number_only_positive") : nil,
-          negative == false ? swagger_i18n("number_not_negative") : nil,
-          negative == true ? swagger_i18n("number_only_negative") : nil
-        ]
-      }.compact_blank)
-    end
+  def json_schema(flavour)
+    {
+      type: "number",
+      minimum: min,
+      maximum: max,
+      description_topics: [
+        positive == false ? swagger_i18n("number_not_positive") : nil,
+        positive == true ? swagger_i18n("number_only_positive") : nil,
+        negative == false ? swagger_i18n("number_not_negative") : nil,
+        negative == true ? swagger_i18n("number_only_negative") : nil
+      ].compact_blank
+    }.compact_blank
   end
 end

data/lib/explicit/type/hash.rb

@@ -46,15 +46,13 @@ class Explicit::Type::Hash < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "object",
-        additionalProperties: value_type.swagger_schema,
-        description_topics: [
-          empty == false ? swagger_i18n("hash_not_empty") : nil
-        ]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: "object",
+      additionalProperties: value_type.mcp_schema,
+      description_topics: [
+        empty == false ? swagger_i18n("hash_not_empty") : nil
+      ]
+    }
   end
 end

data/lib/explicit/type/integer.rb

@@ -69,19 +69,17 @@ class Explicit::Type::Integer < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "integer",
-        minimum: min,
-        maximum: max,
-        description_topics: [
-          positive == false ? swagger_i18n("number_not_positive") : nil,
-          positive == true ? swagger_i18n("number_only_positive") : nil,
-          negative == false ? swagger_i18n("number_not_negative") : nil,
-          negative == true ? swagger_i18n("number_only_negative") : nil
-        ]
-      }.compact_blank)
-    end
+  def json_schema(flavour)
+    {
+      type: "integer",
+      minimum: min,
+      maximum: max,
+      description_topics: [
+        positive == false ? swagger_i18n("number_not_positive") : nil,
+        positive == true ? swagger_i18n("number_only_positive") : nil,
+        negative == false ? swagger_i18n("number_not_negative") : nil,
+        negative == true ? swagger_i18n("number_only_negative") : nil
+      ].compact_blank
+    }.compact_blank
   end
 end

data/lib/explicit/type/literal.rb

@@ -33,12 +33,10 @@ class Explicit::Type::Literal < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: @value.is_a?(::String) ? "string" : "integer",
-        enum: [@value]
-      })
-    end
+  def json_schema(flavour)
+    {
+      type: @value.is_a?(::String) ? "string" : "integer",
+      enum: [@value]
+    }
   end
 end

data/lib/explicit/type/one_of.rb

@@ -101,11 +101,9 @@ class Explicit::Type::OneOf < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      return subtypes.first.swagger_schema if subtypes.one?
+  def json_schema(flavour)
+    raise ::NotImplementedError if flavour == :mcp
 
-      { oneOf: subtypes.map(&:swagger_schema) }
-    end
+    { oneOf: subtypes.map(&:swagger_schema) }
   end
 end

data/lib/explicit/type/record.rb

@@ -73,33 +73,20 @@ class Explicit::Type::Record < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_parameters
-      attributes.map do |name, type|
-        {
-          name:,
-          in: type.param_location_path? ? "path" : "body",
-          description: type.description,
-          required: !type.nilable,
-          schema: type.swagger_schema
-        }
-      end
+  def json_schema(flavour)
+    properties = attributes.to_h do |name, type|
+      [ name, flavour == :mcp ? type.mcp_schema : type.swagger_schema ]
     end
 
-    def swagger_schema
-      properties = attributes.to_h do |name, type|
-        [ name, type.swagger_schema ]
-      end
-
-      required = attributes.filter_map do |name, type|
-        type.required? ? name.to_s : nil
-      end
-
-      merge_base_swagger_schema({
-        type: "object",
-        properties:,
-        required:
-      }.compact_blank)
+    required = attributes.filter_map do |name, type|
+      type.required? ? name.to_s : nil
     end
+
+    {
+      type: "object",
+      properties:,
+      required:,
+      additionalProperties: false
+    }.compact
   end
 end

data/lib/explicit/type/string.rb

@@ -51,18 +51,16 @@ class Explicit::Type::String < Explicit::Type
     end
   end
 
-  concerning :Swagger do
-    def swagger_schema
-      merge_base_swagger_schema({
-        type: "string",
-        pattern: format&.inspect&.then { _1[1..-2] },
-        minLength: min_length || (empty == false ? 1 : nil),
-        maxLength: max_length,
-        description_topics: [
-          empty == false ? swagger_i18n("string_not_empty") : nil,
-          downcase == true ? swagger_i18n("string_downcase") : nil
-        ]
-      }.compact_blank)
-    end
+  def json_schema(flavour)
+    {
+      type: "string",
+      pattern: format&.inspect&.then { _1[1..-2] },
+      minLength: min_length || (empty == false ? 1 : nil),
+      maxLength: max_length,
+      description_topics: [
+        empty == false ? swagger_i18n("string_not_empty") : nil,
+        downcase == true ? swagger_i18n("string_downcase") : nil
+      ].compact_blank
+    }.compact_blank
   end
 end

data/lib/explicit/type.rb

@@ -130,7 +130,7 @@ class Explicit::Type
   end
 
   def required?
-    !nilable
+    !nilable && default.blank?
   end
 
   def error_i18n(name, context = {})
@@ -156,7 +156,15 @@ class Explicit::Type
     end
   end
 
-  def merge_base_swagger_schema(attributes)
+  def swagger_schema
+    merge_base_json_schema(json_schema(:swagger))
+  end
+
+  def mcp_schema
+    merge_base_json_schema(json_schema(:mcp))
+  end
+
+  def merge_base_json_schema(attributes)
     topics = attributes.delete(:description_topics)&.compact_blank || []
 
     formatted_description =

data/lib/explicit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Explicit
-  VERSION = "0.2.14"
+  VERSION = "0.2.16"
 end

data/lib/explicit.rb

@@ -4,6 +4,13 @@ require "explicit/configuration"
 require "explicit/engine"
 require "explicit/version"
 
+require "explicit/mcp_server"
+require "explicit/mcp_server/builder"
+require "explicit/mcp_server/request"
+require "explicit/mcp_server/router"
+require "explicit/mcp_server/response"
+require "explicit/mcp_server/tool"
+
 require "explicit/documentation"
 require "explicit/documentation/builder"
 require "explicit/documentation/markdown"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: explicit
 version: !ruby/object:Gem::Version
-  version: 0.2.14
+  version: 0.2.16
 platform: ruby
 authors:
 - Luiz Vasconcellos
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-04-06 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -86,6 +85,12 @@ files:
 - lib/explicit/documentation/page/request.rb
 - lib/explicit/documentation/section.rb
 - lib/explicit/engine.rb
+- lib/explicit/mcp_server.rb
+- lib/explicit/mcp_server/builder.rb
+- lib/explicit/mcp_server/request.rb
+- lib/explicit/mcp_server/response.rb
+- lib/explicit/mcp_server/router.rb
+- lib/explicit/mcp_server/tool.rb
 - lib/explicit/request.rb
 - lib/explicit/request/example.rb
 - lib/explicit/request/invalid_params_error.rb
@@ -128,7 +133,6 @@ metadata:
   homepage_uri: https://github.com/luizpvas/explicit
   source_code_uri: https://github.com/luizpvas/explicit
   changelog_uri: https://github.com/luizpvas/explicit
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -143,8 +147,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
-signing_key: 
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Explicit is a validation and documentation library for REST APIs
 test_files: []