odin-foundation 1.0.4 → 1.2.0

data/lib/odin.rb

@@ -19,12 +19,16 @@ require_relative "odin/types/schema"
 require_relative "odin/validation/redos_protection"
 require_relative "odin/validation/format_validators"
 require_relative "odin/validation/schema_parser"
+require_relative "odin/validation/invariant_evaluator"
+require_relative "odin/validation/schema_definition_validator"
 require_relative "odin/validation/validator"
 require_relative "odin/validation/schema_serializer"
+require_relative "odin/resolver/type_registry"
 require_relative "odin/resolver/import_resolver"
 require_relative "odin/transform/source_parsers"
 require_relative "odin/transform/format_exporters"
 require_relative "odin/transform/transform_types"
+require_relative "odin/transform/transform_expr"
 require_relative "odin/transform/verb_context"
 require_relative "odin/transform/transform_parser"
 require_relative "odin/transform/transform_engine"
@@ -35,7 +39,9 @@ require_relative "odin/transform/verbs/financial_verbs"
 require_relative "odin/transform/verbs/aggregation_verbs"
 require_relative "odin/transform/verbs/object_verbs"
 require_relative "odin/transform/verbs/geo_verbs"
+require_relative "odin/transform/verbs/extra_verbs"
 require_relative "odin/export"
+require_relative "odin/forms"
 
 module Odin
   class << self
@@ -44,6 +50,89 @@ module Odin
       Parsing::OdinParser.new.parse(text, options)
     end
 
+    # Parse a chained document (one or more documents separated by ---) into
+    # the full list of documents. A single document yields a one-element array.
+    def parse_documents(text, options = nil)
+      result = parse(text, options)
+      result.respond_to?(:documents) ? result.documents : [result]
+    end
+
+    # Collapse a chained ODIN document into its computed current state.
+    #
+    # Later documents overlay earlier ones, a repeated path replaces the earlier
+    # value, +field = ~+ removes the field and its descendants, and +field[] = ~+
+    # clears the array. The result carries the final document's metadata.
+    #
+    # Accepts chained ODIN text or a pre-parsed list of documents.
+    def collapse_chain(input, options = nil)
+      docs = input.is_a?(Array) ? input : parse_documents(input, options)
+      collapse_documents(docs)
+    end
+
+    private
+
+    def collapse_documents(docs)
+      assignments = {}
+      modifiers = {}
+      metadata = {}
+
+      docs.each do |doc|
+        metadata = doc.metadata.dup
+
+        doc.paths.each do |path|
+          value = doc.get(path)
+          next if value.nil?
+
+          if value.type == :null
+            if path.end_with?("[]")
+              clear_array(assignments, modifiers, path[0...-2])
+            else
+              remove_path(assignments, modifiers, path)
+            end
+            next
+          end
+
+          assignments[path] = value
+          mods = doc.modifiers_for(path)
+          if mods
+            modifiers[path] = mods
+          else
+            modifiers.delete(path)
+          end
+        end
+      end
+
+      Types::OdinDocument.new(
+        assignments: assignments,
+        metadata: metadata,
+        modifiers: modifiers,
+        comments: {}
+      )
+    end
+
+    # Remove a path and any nested descendants from the working maps.
+    def remove_path(assignments, modifiers, path)
+      assignments.keys.each do |key|
+        if key == path || key.start_with?("#{path}.") || key.start_with?("#{path}[")
+          assignments.delete(key)
+          modifiers.delete(key)
+        end
+      end
+    end
+
+    # Clear all indexed elements of an array path from the working maps.
+    def clear_array(assignments, modifiers, array_path)
+      prefix = "#{array_path}["
+      assignments.keys.each do |key|
+        if key.start_with?(prefix)
+          assignments.delete(key)
+          modifiers.delete(key)
+        end
+      end
+    end
+
+    public
+
     def stringify(doc, options = {})
       Serialization::Stringify.new(options).stringify(doc)
     end
@@ -57,8 +146,15 @@ module Odin
       Validation::SchemaParser.new.parse_schema(text)
     end
 
-    def validate(doc, schema, options = {})
-      Validation::Validator.new.validate(doc, schema, options)
+    def validate(doc, schema, options = {}, registry = nil)
+      Validation::Validator.new.validate(doc, schema, options, registry)
+    end
+
+    # Resolve a schema's imports into a type registry, then validate the document.
+    def validate_with_imports(doc, schema, base_path, options = {}, resolver_options = {})
+      _flattened, registry = Resolver::ImportResolver.new(**resolver_options)
+                                                     .resolve_with_registry(schema, base_path: base_path)
+      validate(doc, schema, options, registry)
     end
 
     def diff(a, b)
@@ -78,8 +174,8 @@ module Odin
       Transform::TransformParser.new.parse(text)
     end
 
-    def execute_transform(transform_def, source)
-      Transform::TransformEngine.new.execute(transform_def, source)
+    def execute_transform(transform_def, source, import_resolver: nil)
+      Transform::TransformEngine.new.execute(transform_def, source, import_resolver: import_resolver)
     end
 
     def transform(transform_text, source)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: odin-foundation
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.2.0
 platform: ruby
 authors:
 - ODIN Foundation
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-07 00:00:00.000000000 Z
+date: 2026-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -91,23 +91,33 @@ files:
 - lib/odin/diff/differ.rb
 - lib/odin/diff/patcher.rb
 - lib/odin/export.rb
+- lib/odin/forms.rb
+- lib/odin/forms/accessibility.rb
+- lib/odin/forms/css.rb
+- lib/odin/forms/parser.rb
+- lib/odin/forms/renderer.rb
+- lib/odin/forms/types.rb
+- lib/odin/forms/units.rb
 - lib/odin/parsing/parser.rb
 - lib/odin/parsing/token.rb
 - lib/odin/parsing/token_type.rb
 - lib/odin/parsing/tokenizer.rb
 - lib/odin/parsing/value_parser.rb
 - lib/odin/resolver/import_resolver.rb
+- lib/odin/resolver/type_registry.rb
 - lib/odin/serialization/canonicalize.rb
 - lib/odin/serialization/stringify.rb
 - lib/odin/transform/format_exporters.rb
 - lib/odin/transform/source_parsers.rb
 - lib/odin/transform/transform_engine.rb
+- lib/odin/transform/transform_expr.rb
 - lib/odin/transform/transform_parser.rb
 - lib/odin/transform/transform_types.rb
 - lib/odin/transform/verb_context.rb
 - lib/odin/transform/verbs/aggregation_verbs.rb
 - lib/odin/transform/verbs/collection_verbs.rb
 - lib/odin/transform/verbs/datetime_verbs.rb
+- lib/odin/transform/verbs/extra_verbs.rb
 - lib/odin/transform/verbs/financial_verbs.rb
 - lib/odin/transform/verbs/geo_verbs.rb
 - lib/odin/transform/verbs/numeric_verbs.rb
@@ -129,7 +139,9 @@ files:
 - lib/odin/utils/path_utils.rb
 - lib/odin/utils/security_limits.rb
 - lib/odin/validation/format_validators.rb
+- lib/odin/validation/invariant_evaluator.rb
 - lib/odin/validation/redos_protection.rb
+- lib/odin/validation/schema_definition_validator.rb
 - lib/odin/validation/schema_parser.rb
 - lib/odin/validation/schema_serializer.rb
 - lib/odin/validation/validator.rb