teptris 0.2.53-aarch64-linux → 0.2.55-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 168a5dbc5e797d21c3d6798cd78b90d4b8a704b1f9423413904c71b2559c31fb
-  data.tar.gz: 2e6f06fcfc14d22db8c821402462d428a09dd30c4c63e4ac5d071173415084a8
+  metadata.gz: a2400a09ae1ced1e09d349bdb20851b189f13e466c2bf4d9006008c517c0bf83
+  data.tar.gz: 8ab7d95aa9e1bb795d589e0963e6ebda41b419f914e857802e8014cd273dc357
 SHA512:
-  metadata.gz: 050ed9059cefb4cc60b37194b353e9a385335aa22e99395ed993833967efa7d466e0e3c0de2d9764ee08b528f56cf6e7e622aa6f3d0f0c5503931a395746ea55
-  data.tar.gz: 4c24b94cbe121c7413367f42afd48413e2acce70dd47328614d9f7da94735d91b74cfdbc30d44404e8b46f89519fa75a2e7ad64fd30f501c07d3798e10a5fd32
+  metadata.gz: fe7a41af3f3e7727d6d377df95a8b326acf58375acac85c8fa1a8ca11e9e07809fc189cace8c7a07206206fc151330e94e457625cf51b60c5b5faa0013c760e0
+  data.tar.gz: 1cdc4dee00304a83e731054485934bf055ac5a11b5722628d03c78dfc7378ee65612aca9cabf9a1ae50c8749f49c8010dbd52deeaf15cd06f69af8c624bb11f0

data/Steepfile

@@ -0,0 +1,10 @@
+target :lib do
+  signature "sig"
+  library "date"
+
+  check "lib"
+
+  configure_code_diagnostics do |hash|
+    # keep the lane green while signatures evolve
+  end
+end

data/lib/teptris/descriptor.rb

@@ -32,7 +32,9 @@ class Teptris::Descriptor
     # siblings that follow a :nested child into the sub-plan's range —
     # the 0.2.29 bug (every array-of-tables element grew stray nil
     # rows).
+    # @type var plans: Array[Hash[Symbol, untyped]]
     plans = []
+    # @type var index_of: Hash[Integer, Integer]
     index_of = {}
     collect = lambda do |t|
       unless index_of.key?(t.object_id)

data/lib/teptris/toml.rb

@@ -25,6 +25,7 @@ module Teptris
         unless %i[native string].include?(datetime_policy)
           raise ArgumentError, "datetime_policy must be :native or :string"
         end
+        # @type var opts: Hash[Symbol, untyped]
         opts = {}
         opts[:string_datetimes] = true if datetime_policy == :string
         if permitted_classes && datetime_policy == :native
@@ -69,6 +70,7 @@ module Teptris
         # Repeated objects are dup'd once each HERE: a repeat landing in
         # two slices would double-lock across threads (the slice-level
         # guard cannot see across slices); frozen dup'ing is C-side.
+        # @type var seen: Hash[Integer, bool]
         seen = {}
         tomls = tomls.map do |s|
           next s.dup if seen[s.object_id]
@@ -77,6 +79,7 @@ module Teptris
         end
         per = (n.to_f / threads).ceil
         results = Array.new(n)
+        # @type var first_error: [Integer, untyped]?
         first_error = nil
         mutex = Mutex.new
         threads.times.map do |ti|
@@ -157,6 +160,7 @@ module Teptris
       end
 
       def _safe_load_opts(safe_load, datetime_policy)
+        # @type var opts: Hash[Symbol, untyped]
         opts = {}
         opts[:string_datetimes] = true if datetime_policy == :string
         if safe_load && datetime_policy == :native

data/lib/teptris/version.rb

@@ -1,3 +1,3 @@
 module Teptris
-  VERSION = "0.2.53"
+  VERSION = "0.2.55"
 end

data/sig/teptris.rbs

@@ -0,0 +1,131 @@
+module Teptris
+  VERSION: String
+
+  # mirrored from the engine's teptris_status (lib/teptris.rb)
+  TEPTRIS_OK: Integer
+
+  class Error < StandardError
+  end
+
+  class ParseError < Error
+    attr_reader line: Integer
+    attr_reader column: Integer
+
+    def initialize: (String message, ?Integer line, ?Integer column) -> void
+  end
+
+  module TOML
+    VERSION: String
+
+    # Eager load: String -> Hash with String keys. Datetime contract
+    # (the tomlib shape): Time with zone for offset datetimes, local
+    # Time for local datetimes, Date for dates, "HH:MM:SS" String for
+    # local times.
+    def self.load: (String toml) -> Hash[String, untyped]
+
+    def self.load_file: (String path) -> Hash[String, untyped]
+
+    def self.safe_load: (String toml, ?permitted_classes: Array[Class]?,
+                         ?datetime_policy: :native | :string)
+                       -> Hash[String, untyped]
+
+    # One parse; host objects materialize only along accessed paths.
+    def self.load_lazy: (String toml) -> TeptrisExt::LazyValue
+
+    def self.load_batch: (Array[String] tomls, ?safe_load: Array[Class]?,
+                          ?datetime_policy: :native | :string,
+                          ?threads: Integer)
+                        -> Array[Hash[String, untyped]]
+
+    def self.load_lazy_batch: (Array[String] tomls)
+                            -> Array[TeptrisExt::LazyValue]
+
+    def self.load_files: (Array[String] paths, ?safe_load: Array[Class]?,
+                          ?datetime_policy: :native | :string)
+                        -> Array[Hash[String, untyped]]
+
+    def self.load_schema: (String toml, Descriptor descriptor)
+                         -> Hash[String, untyped]
+
+    def self.dump: (untyped obj) -> String
+
+    def self.engine_version: () -> String
+
+    def self._validate_batch!: (untyped input, untyped safe_load,
+                                :native | :string datetime_policy,
+                                ?kind: Symbol) -> void
+
+    def self._safe_load_opts: (untyped safe_load,
+                               :native | :string datetime_policy)
+                             -> Hash[Symbol, untyped]?
+  end
+
+  # Tree-shaped schema descriptor: compile once with .build, then
+  # materialize documents against it with #walk — unplanned keys are
+  # never materialized (the py twin is teptris.Descriptor).
+  class Descriptor
+    KINDS: Hash[Symbol, Integer]
+
+    def self.build: (Hash[Symbol, untyped] tree) -> Descriptor
+
+    attr_reader rows: Array[[String, Integer, Integer]]
+    attr_reader first_row: Array[Integer]
+
+    def walk: (String toml) -> Hash[String, untyped]
+  end
+end
+
+# The C extension's surface (defined in ext/teptris_ext). The gem's
+# public API is Teptris::TOML; these module functions are the binding
+# layer underneath it.
+module TeptrisExt
+  # Lazy wrapper: one parse, scalars materialize on access, to_h/to_a
+  # flatten to the eager shapes.
+  class LazyValue
+    def []: (String key) -> (LazyValue | untyped)
+           | (Integer index) -> (LazyValue | untyped)
+
+    def at: (Integer index) -> (LazyValue | untyped)
+
+    def dig: (*String keys) -> (LazyValue | untyped)
+
+    def kind: () -> String
+
+    def size: () -> Integer
+
+    def each: () { (LazyValue | untyped) -> void } -> LazyValue
+             | () -> Enumerator[LazyValue | untyped, LazyValue]
+
+    def value: () -> untyped
+
+    def to_h: () -> Hash[String, untyped]
+
+    def to_a: () -> Array[untyped]
+
+    def ==: (untyped other) -> bool
+
+    include Enumerable[LazyValue | untyped]
+  end
+
+  def self.load: (String toml, ?Hash[Symbol, untyped]? opts)
+               -> Hash[String, untyped]
+
+  def self.load_lazy: (String toml) -> LazyValue
+
+  def self.load_batch: (Array[String] tomls, Hash[Symbol, untyped]? opts)
+                     -> Array[Hash[String, untyped]]
+
+  def self.load_slice: (Array[String] tomls, Hash[Symbol, untyped]? opts)
+                     -> Array[Hash[String, untyped]]
+
+  def self.load_lazy_batch: (Array[String] tomls) -> Array[LazyValue]
+
+  def self.dump: (untyped obj) -> String
+
+  def self.engine_version: () -> String
+
+  def self.plan_build: (Array[[String, Integer, Integer]] rows,
+                        Array[Integer] first_row) -> untyped
+
+  def self.plan_emit: (untyped handle, String toml) -> Hash[String, untyped]
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: teptris
 version: !ruby/object:Gem::Version
-  version: 0.2.53
+  version: 0.2.55
 platform: aarch64-linux
 authors:
 - teptris contributors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-01 00:00:00.000000000 Z
+date: 2026-10-05 00:00:00.000000000 Z
 dependencies: []
 description: A native C extension over libteptris, a C99 TOML 1.1 parser/emitter.
   API shape mirrors the tomlib gem.
@@ -17,6 +17,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- Steepfile
 - ext/teptris_ext/engine/LICENSE.md
 - ext/teptris_ext/engine/README.md
 - ext/teptris_ext/engine/src/include/teptris/plan.h
@@ -58,10 +59,16 @@ files:
 - lib/teptris/error.rb
 - lib/teptris/toml.rb
 - lib/teptris/version.rb
+- sig/teptris.rbs
 homepage: https://github.com/leptris/teptris-ruby
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/leptris/teptris-ruby/issues
+  changelog_uri: https://github.com/leptris/teptris-ruby/releases
+  documentation_uri: https://leptris.github.io/docs/teptris-ruby
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/leptris/teptris-ruby
 post_install_message:
 rdoc_options: []
 require_paths: