tg_geometry 0.1.0 → 0.2.0

data/spec/{block_3_geom_parse_spec.rb → geom_parse_spec.rb}

@@ -3,7 +3,7 @@
 require "spec_helper"
 require "objspace"
 
-RSpec.describe "Release Core Block 3 Geom parsing" do
+RSpec.describe "Geom parsing" do
   let(:geojson_point) { %({"type":"Point","coordinates":[1.0,2.0]}) }
   let(:wkt_point) { "POINT (1 2)" }
   let(:wkb_point) { [1, 1].pack("CL<") + [1.0, 2.0].pack("E2") }

data/spec/{block_8_index_borrowed_geometry_spec.rb → index_borrowed_geometry_spec.rb}

@@ -5,7 +5,7 @@ require "json"
 require "objspace"
 require "weakref"
 
-RSpec.describe "Release Core Block 8 Index borrowed geometry ingestion" do
+RSpec.describe "Index borrowed geometry ingestion" do
   let(:polygon_a_wkt) { "POLYGON ((0 0, 2 0, 2 2, 0 2, 0 0))" }
   let(:polygon_b_wkt) { "POLYGON ((10 10, 12 10, 12 12, 10 12, 10 10))" }
 

data/spec/{block_6_index_build_spec.rb → index_build_spec.rb}

@@ -2,7 +2,7 @@
 
 require "spec_helper"
 
-RSpec.describe "Release Core Block 6 Index build skeleton" do
+RSpec.describe "Index build" do
   let(:geom) { TG::Geometry.parse_wkt("POINT (1 2)") }
 
   it "builds an empty immutable index" do
@@ -54,7 +54,7 @@ RSpec.describe "Release Core Block 6 Index build skeleton" do
       .to raise_error(TG::Geometry::ArgumentError)
   end
 
-  it "requires String values for owned geometry modes in the block 6 skeleton" do
+  it "requires String values for owned geometry modes in the owned geometry build path" do
     expect { TG::Geometry::Index.build([[1, Object.new]], via: :geojson, strategy: :flat) }
       .to raise_error(TypeError)
     expect { TG::Geometry::Index.build([[1, Object.new]], via: :wkb, strategy: :flat) }

data/spec/{block_9_flat_query_spec.rb → index_flat_query_spec.rb}

@@ -2,7 +2,7 @@
 
 require "spec_helper"
 
-RSpec.describe "Release Core Block 9 flat query engine" do
+RSpec.describe "Flat index query engine" do
   let(:zone_a) { TG::Geometry.parse_wkt("POLYGON ((0 0, 10 0, 10 10, 0 10, 0 0))") }
   let(:zone_b) { TG::Geometry.parse_wkt("POLYGON ((5 5, 12 5, 12 12, 5 12, 5 5))") }
   let(:zone_c) { TG::Geometry.parse_wkt("POLYGON ((20 20, 22 20, 22 22, 20 22, 20 20))") }

data/spec/{block_7_index_owned_geometry_spec.rb → index_owned_geometry_spec.rb}

@@ -3,7 +3,7 @@
 require "spec_helper"
 require "objspace"
 
-RSpec.describe "Release Core Block 7 Index owned geometry ingestion" do
+RSpec.describe "Index owned geometry ingestion" do
   let(:geojson_a) do
     '{"type":"Polygon","coordinates":[[[0,0],[2,0],[2,2],[0,2],[0,0]]]}'
   end

data/spec/{block_10_rtree_strategy_spec.rb → index_rtree_accounting_spec.rb}

@@ -2,7 +2,7 @@
 
 require "spec_helper"
 
-RSpec.describe "Release Core Block 10 exact rtree accounting" do
+RSpec.describe "Exact rtree accounting" do
   let(:zone_a) { TG::Geometry.parse_wkt("POLYGON ((0 0, 10 0, 10 10, 0 10, 0 0))") }
   let(:zone_b) { TG::Geometry.parse_wkt("POLYGON ((20 20, 30 20, 30 30, 20 30, 20 20))") }
 

data/spec/{block_11_rtree_order_spec.rb → index_rtree_order_spec.rb}

@@ -2,7 +2,7 @@
 
 require "spec_helper"
 
-RSpec.describe "Release Core Block 11 rtree ordered results" do
+RSpec.describe "Rtree ordered results" do
   let(:entries) do
     [
       [:first, TG::Geometry.parse_wkt("POLYGON ((0 0, 10 0, 10 10, 0 10, 0 0))")],

data/spec/{block_1_skeleton_spec.rb → load_and_errors_spec.rb}

@@ -2,7 +2,7 @@
 
 require "spec_helper"
 
-RSpec.describe "Release Core Block 1 skeleton" do
+RSpec.describe "Load and error hierarchy" do
   it "compiles the native extension" do
     expect(File.file?(EXT_SO)).to be(true)
   end

data/spec/{expansion_e_low_level_geometry_spec.rb → low_level_geometry_spec.rb}

@@ -2,7 +2,7 @@
 
 require "spec_helper"
 
-RSpec.describe "Expansion Block E low-level geometry wrappers" do
+RSpec.describe "Low-level geometry wrappers" do
   it "exposes Point coordinates without constructing a mutable point wrapper" do
     geom = TG::Geometry.parse_wkt("POINT (1 2)")
 

data/spec/{block_14_memory_gc_hardening_spec.rb → memory_gc_spec.rb}

@@ -3,7 +3,7 @@
 require "spec_helper"
 require "objspace"
 
-RSpec.describe "Release Core Block 14 memory, GC, and compaction hardening" do
+RSpec.describe "Memory, GC, and compaction hardening" do
   let(:small_polygon_wkt) { "POLYGON ((0 0, 10 0, 10 10, 0 10, 0 0))" }
   let(:small_polygon_geojson) { '{"type":"Polygon","coordinates":[[[0,0],[10,0],[10,10],[0,10],[0,0]]]}' }
   let(:malformed_geojson) { '{"type":"Polygon","coordinates":[' }

data/spec/{expansion_i_ractor_spec.rb → ractor_spec.rb}

@@ -2,7 +2,7 @@
 
 require "spec_helper"
 
-RSpec.describe "Expansion Block I Ractor investigation" do
+RSpec.describe "Ractor boundary" do
   it "keeps native wrappers outside Ractor shareability claims" do
     skip "Ractor is not available on this Ruby" unless defined?(Ractor)
 

data/spec/{block_5_rect_api_spec.rb → rect_api_spec.rb}

@@ -2,7 +2,7 @@
 
 require "spec_helper"
 
-RSpec.describe "Release Core Block 5 Rect API" do
+RSpec.describe "Rect API" do
   it "constructs an immutable rect with coordinate accessors" do
     rect = TG::Geometry::Rect.new(1, 2, 5, 8)
 

data/spec/{expansion_b_registry_spec.rb → registry_spec.rb}

@@ -26,7 +26,7 @@ RSpec.describe TG::Geometry::Registry do
     expect(registry.find_covering(25, 25)).to eq(:b)
   end
 
-  it "supports subclass source blocks" do
+  it "supports subclass source definitions" do
     entries = [[:a, zone_a]]
     klass = Class.new(described_class) do
       source { entries }

data/spec/{expansion_j_full_tg_api_coverage_spec.rb → tg_api_coverage_spec.rb}

@@ -2,7 +2,7 @@
 
 require "spec_helper"
 
-RSpec.describe "Expansion Block J grouped TG API coverage" do
+RSpec.describe "TG API coverage" do
   it "adds safe point and empty geometry constructors without public allocation" do
     point = TG::Geometry.point_zm(1, 2, 3, 4)
 

data/spec/{block_2_vendor_spec.rb → vendor_sources_spec.rb}

@@ -4,16 +4,16 @@ require "spec_helper"
 require "open3"
 require "tmpdir"
 
-RSpec.describe "Release Core Block 2 vendored build" do
+RSpec.describe "Vendored source build" do
   let(:vendor_dir) { File.join(ROOT, "ext", "tg_geometry", "vendor") }
 
-  it "keeps tidwall/tg vendored under the contract path" do
+  it "keeps tidwall/tg vendored under the expected path" do
     %w[tg.c tg.h VERSION].each do |name|
       expect(File.file?(File.join(vendor_dir, "tg", name))).to be(true), "missing vendor/tg/#{name}"
     end
   end
 
-  it "keeps rtree.c vendored under the contract path" do
+  it "keeps rtree.c vendored under the expected path" do
     %w[rtree.c rtree.h VERSION].each do |name|
       expect(File.file?(File.join(vendor_dir, "rtree", name))).to be(true), "missing vendor/rtree/#{name}"
     end
@@ -51,7 +51,7 @@ RSpec.describe "Release Core Block 2 vendored build" do
     end
   end
 
-  it "uses the release-core compiler warning flags" do
+  it "uses the expected compiler warning flags" do
     extconf = File.read(File.join(ROOT, "ext", "tg_geometry", "extconf.rb"))
 
     expect(extconf).to include('"-std=c11"')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tg_geometry
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Roman Haydarov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-25 00:00:00.000000000 Z
+date: 2026-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -44,8 +44,9 @@ description: Defines TG::Geometry with immutable Geom parsing and constructor wr
   wrappers, value Segment wrappers, Registry reload sugar, optional ActiveRecord source
   helpers, and an immutable geofencing-oriented Index with owned and borrowed geometry
   ingestion, flat/rtree strategies, deterministic ordered id results, exact rtree
-  allocation accounting, and native-endian packed point batch queries over vendored
-  TG sources. Ractor support is not claimed.
+  allocation accounting, and native-endian packed point batch queries, and FeatureSource
+  GeoJSON FeatureCollection extraction/build paths over vendored C sources. Ractor
+  support is not claimed.
 email:
 - romnhajdarov@gmail.com
 executables: []
@@ -61,32 +62,30 @@ files:
 - benchmark/_support.rb
 - benchmark/batch_packed_vs_loop.rb
 - benchmark/falcon_concurrency.rb
+- benchmark/feature_source.rb
 - benchmark/flat_vs_rtree.rb
 - benchmark/gvl_threshold.rb
 - benchmark/objectspace_memsize.rb
 - benchmark/parse_throughput.rb
 - benchmark/rss_stability.rb
-- docs/ACTIVE_RECORD.md
 - docs/ARCHITECTURE.md
-- docs/AUTO_STRATEGY.md
 - docs/BENCHMARKING.md
 - docs/CASUAL_EXAMPLE.md
 - docs/CONCURRENCY.md
 - docs/ERROR_HANDLING.md
-- docs/EXPANSION_E_TO_H_STATUS.md
-- docs/FORMAT_COVERAGE.md
-- docs/FULL_TG_API_COVERAGE.md
+- docs/FEATURE_SOURCE.md
 - docs/LIMITATIONS.md
-- docs/LOW_LEVEL_GEOMETRY.md
 - docs/MEMORY_OWNERSHIP.md
-- docs/RACTOR.md
-- docs/REGISTRY.md
-- docs/RELEASE_CHECKLIST.md
 - ext/tg_geometry/extconf.rb
 - ext/tg_geometry/tg_geometry_ext.c
+- ext/tg_geometry/tg_geometry_vendor_json.c
 - ext/tg_geometry/tg_geometry_vendor_rtree.c
 - ext/tg_geometry/tg_geometry_vendor_tg.c
 - ext/tg_geometry/vendor/.vendored
+- ext/tg_geometry/vendor/json/LICENSE
+- ext/tg_geometry/vendor/json/VERSION
+- ext/tg_geometry/vendor/json/json.c
+- ext/tg_geometry/vendor/json/json.h
 - ext/tg_geometry/vendor/rtree/LICENSE
 - ext/tg_geometry/vendor/rtree/README.md
 - ext/tg_geometry/vendor/rtree/VERSION
@@ -103,30 +102,32 @@ files:
 - lib/tg/geometry/version.rb
 - lib/tg_geometry.rb
 - script/vendor_libs.rb
-- spec/block_10_rtree_strategy_spec.rb
-- spec/block_11_rtree_order_spec.rb
-- spec/block_12_batch_packed_spec.rb
-- spec/block_13_error_hardening_spec.rb
-- spec/block_14_memory_gc_hardening_spec.rb
-- spec/block_1_skeleton_spec.rb
-- spec/block_20_concurrency_spec.rb
-- spec/block_20_fuzz_spec.rb
-- spec/block_2_vendor_spec.rb
-- spec/block_3_geom_parse_spec.rb
-- spec/block_4_geom_api_spec.rb
-- spec/block_5_rect_api_spec.rb
-- spec/block_6_index_build_spec.rb
-- spec/block_7_index_owned_geometry_spec.rb
-- spec/block_8_index_borrowed_geometry_spec.rb
-- spec/block_9_flat_query_spec.rb
-- spec/expansion_a_auto_strategy_spec.rb
-- spec/expansion_b_registry_spec.rb
-- spec/expansion_c_active_record_source_spec.rb
-- spec/expansion_d_format_coverage_spec.rb
-- spec/expansion_e_low_level_geometry_spec.rb
-- spec/expansion_i_ractor_spec.rb
-- spec/expansion_j_full_tg_api_coverage_spec.rb
+- spec/active_record_source_spec.rb
+- spec/auto_strategy_spec.rb
+- spec/batch_packed_spec.rb
+- spec/concurrency_spec.rb
+- spec/error_hardening_spec.rb
+- spec/feature_source_nogvl_spec.rb
+- spec/feature_source_spec.rb
+- spec/format_coverage_spec.rb
+- spec/fuzz_spec.rb
+- spec/geom_api_spec.rb
+- spec/geom_parse_spec.rb
+- spec/index_borrowed_geometry_spec.rb
+- spec/index_build_spec.rb
+- spec/index_flat_query_spec.rb
+- spec/index_owned_geometry_spec.rb
+- spec/index_rtree_accounting_spec.rb
+- spec/index_rtree_order_spec.rb
+- spec/load_and_errors_spec.rb
+- spec/low_level_geometry_spec.rb
+- spec/memory_gc_spec.rb
+- spec/ractor_spec.rb
+- spec/rect_api_spec.rb
+- spec/registry_spec.rb
 - spec/spec_helper.rb
+- spec/tg_api_coverage_spec.rb
+- spec/vendor_sources_spec.rb
 homepage: https://github.com/roman-haidarov/tg_geometry
 licenses:
 - MIT
@@ -142,7 +143,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -153,5 +154,5 @@ rubygems_version: 3.3.27
 signing_key:
 specification_version: 4
 summary: Native extension for TG::Geometry parsing, predicates, immutable indexes,
-  registries, low-level wrappers, and packed point batches
+  FeatureSource imports, registries, low-level wrappers, and packed point batches
 test_files: []

data/docs/ACTIVE_RECORD.md

@@ -1,26 +0,0 @@
-# ActiveRecord source helper
-
-`TG::Geometry::ActiveRecordSource` is an optional Ruby helper. It does not require Rails or ActiveRecord and is not loaded from a separate integration gem.
-
-It accepts any object that responds to `find_each`, or any Enumerable:
-
-```ruby
-entries = TG::Geometry::ActiveRecordSource.call(
-  Zone.where(active: true),
-  id: :id,
-  geometry: :geojson,
-  batch_size: 1_000
-)
-
-index = TG::Geometry::Index.build(entries, via: :geojson, strategy: :rtree)
-```
-
-It can also feed a Registry:
-
-```ruby
-class DeliveryZones < TG::Geometry::Registry
-  active_record_source Zone.where(active: true), id: :id, geometry: :geojson
-end
-```
-
-Field readers may be Symbols, Strings, or Procs. The helper only converts application records into `[[id, object], ...]`; it does not mutate records, keep database connections, create background jobs, install reload hooks, or add a Rails dependency to the native extension.

data/docs/AUTO_STRATEGY.md

@@ -1,15 +0,0 @@
-# Auto strategy status
-
-`strategy: :auto` is not exposed in the first public release.
-
-The release-core contract only enables explicit `strategy: :flat` and `strategy: :rtree`. Automatic threshold selection requires a complete project-owned benchmark matrix and explicit approval before it can become public API.
-
-Use `benchmark/flat_vs_rtree.rb` to compare strategies for a workload, then pass the chosen strategy explicitly:
-
-```ruby
-index = TG::Geometry::Index.build(entries, via: :geojson, strategy: :rtree)
-# or
-index = TG::Geometry::Index.build(entries, via: :geojson, strategy: :flat)
-```
-
-Do not infer a universal crossover from rtree internals or from a partial benchmark run.

data/docs/EXPANSION_E_TO_H_STATUS.md

@@ -1,51 +0,0 @@
-# Expansion Blocks E–H status
-
-## Expansion Block E — Low-level Ring / Line / Polygon APIs
-
-Implemented as read-only borrowed wrappers:
-
-- `TG::Geometry::Geom#point`
-- `TG::Geometry::Geom#line`
-- `TG::Geometry::Geom#polygon`
-- `TG::Geometry::Line`
-- `TG::Geometry::Ring`
-- `TG::Geometry::Polygon`
-
-Invariant satisfied: child pointers are borrowed from the parent TG geometry and the wrapper keeps the parent Ruby `TG::Geometry::Geom` alive through `geom_owner` with compaction-aware marking.
-
-Tests: `spec/expansion_e_low_level_geometry_spec.rb` covers accessors, private allocation, out-of-range errors, and parent survival after `GC.start` / `GC.compact`.
-
-## Expansion Block F — Callback/search APIs
-
-OPEN QUESTION: not implemented.
-
-Reason: the roadmap allows callback/search APIs only with a new callback safety contract. The current contract still forbids public callback/block APIs in the first release. No `geom.search`, `index.search`, or `each_match` method is exposed.
-
-Required before implementation:
-
-- explicit callback exception propagation semantics;
-- GVL behavior for Ruby callbacks inside C loops;
-- proof that borrowed pointers cannot be invalidated by callback reentrancy;
-- benchmark of callback overhead;
-- tests for exceptions raised from callbacks.
-
-## Expansion Block G — Fast no-allocation point query optimization
-
-OPEN QUESTION: not implemented.
-
-Reason: the current implementation intentionally constructs a temporary TG point geometry for `covers` / `contains` correctness. Replacing this with `tg_geom_intersects_xy` or a specialized helper requires proof of exact boundary semantics and a benchmark proving benefit.
-
-Current invariant: point query semantics remain exact and boundary behavior is covered by existing tests.
-
-## Expansion Block H — Geodesic helpers or projection integration
-
-OPEN QUESTION: not implemented.
-
-Reason: TG core remains planar XY. No optional geodesic/projection dependency has been approved. The gem continues to document that `length`, `area`, and `perimeter` are in input coordinate units, not meters for lon/lat.
-
-Required before implementation:
-
-- explicit optional dependency decision;
-- public API shape;
-- tests separating planar TG behavior from geodesic/projection helpers;
-- documentation that TG itself does not handle geodesics.

data/docs/FORMAT_COVERAGE.md

@@ -1,23 +0,0 @@
-# Format coverage
-
-Expansion Block D exposes additional TG format helpers without changing ownership rules.
-
-## Parse helpers
-
-- `TG::Geometry.parse_hex(str, index: :ystripes)`
-- `TG::Geometry.parse_geobin(bytes, index: :ystripes)`
-
-These are shortcuts over `TG::Geometry.parse(..., format: :hex)` and `TG::Geometry.parse(..., format: :geobin)`.
-
-## Writer helpers
-
-- `TG::Geometry::Geom#to_hex` -> UTF-8 String
-- `TG::Geometry::Geom#to_geobin` -> ASCII-8BIT String
-
-Writers use the same direct Ruby string buffer pattern as existing writers. Hex is text and GeoBIN is binary.
-
-## Raw extra_json
-
-- `TG::Geometry::Geom#extra_json` -> UTF-8 String or nil
-
-This returns a copied Ruby String from TG's raw extra JSON pointer. It does not parse JSON into Hashes and does not expose borrowed child wrappers. This follows the constraint that raw `extra_json` is safer than implicit `JSON.parse`.

data/docs/FULL_TG_API_COVERAGE.md

@@ -1,109 +0,0 @@
-# Full TG API coverage status
-
-This document covers Expansion Block J as implemented in grouped, safe increments.
-
-Block J does not mean exposing every upstream TG function in one change. The rule is: implement in groups, define ownership for each group, add tests, and avoid environment allocator overrides or global mutable settings.
-
-## Implemented group: predicates
-
-`TG::Geometry::Geom` now exposes additional read-only predicates:
-
-- `equals?(other)`
-- `disjoint?(other)`
-- `within?(other)`
-- `covers?(other)`
-- `covered_by?(other)`
-- `touches?(other)`
-- `intersects_xy?(x, y)`
-- `intersects_rect?(rect)`
-- `intersects_rect?(min_x, min_y, max_x, max_y)`
-
-Existing methods remain:
-
-- `contains?(other)`
-- `intersects?(other)`
-- `covers_xy?(x, y)`
-
-`equals?` intentionally does not change Ruby `==`, `eql?`, or `hash`. Ruby equality remains identity-based until that open API decision is explicitly made.
-
-## Implemented group: geometry accessors
-
-`TG::Geometry::Geom` now exposes safe read-only accessors for upstream geometry collections and coordinate metadata:
-
-- `feature?`
-- `feature_collection?`
-- `empty?`
-- `dims`
-- `has_z?`
-- `has_m?`
-- `z`
-- `m`
-- `extra_coords`
-- `num_points`
-- `point_at(index)`
-- `points`
-- `num_lines`
-- `line_at(index)`
-- `lines`
-- `num_polygons`
-- `polygon_at(index)`
-- `polygons`
-- `num_geometries`
-- `geometry_at(index)`
-- `geometries`
-
-`geometry_at` and `geometries` return borrowed immutable `TG::Geometry::Geom` wrappers. They keep the parent wrapper alive through `geom_owner`, mark it for GC, update it during compaction, and do not call `tg_geom_free` for the borrowed child pointer.
-
-## Implemented group: point and empty constructors
-
-Safe constructors are exposed only where ownership is simple and the returned object owns exactly one `struct tg_geom *`:
-
-- `TG::Geometry.point(x, y)`
-- `TG::Geometry.point_z(x, y, z)`
-- `TG::Geometry.point_m(x, y, m)`
-- `TG::Geometry.point_zm(x, y, z, m)`
-- `TG::Geometry.empty_point`
-- `TG::Geometry.empty_linestring`
-- `TG::Geometry.empty_polygon`
-- `TG::Geometry.empty_multipoint`
-- `TG::Geometry.empty_multilinestring`
-- `TG::Geometry.empty_multipolygon`
-- `TG::Geometry.empty_geometrycollection`
-
-Numeric coordinates are converted with `NUM2DBL` and rejected if NaN or Infinity.
-
-## Implemented group: segments
-
-`TG::Geometry::Segment` is a frozen value wrapper over one copied `struct tg_segment`.
-
-Created by:
-
-- `TG::Geometry::Line#segment_at(index)`
-- `TG::Geometry::Line#segments`
-- `TG::Geometry::Ring#segment_at(index)`
-- `TG::Geometry::Ring#segments`
-
-Methods:
-
-- `a -> [Float, Float]`
-- `b -> [Float, Float]`
-- `points -> [[Float, Float], [Float, Float]]`
-- `bbox -> TG::Geometry::Rect`
-- `intersects?(other_segment)`
-
-`TG::Geometry::Segment.allocate` is disabled. Segment wrappers do not borrow parent TG memory and do not call any TG free function.
-
-## Still not implemented
-
-The following remain outside this grouped implementation:
-
-- Line/Ring/Polygon public constructors from Ruby arrays;
-- MultiLineString / MultiPolygon constructors from low-level wrappers;
-- callback/search APIs;
-- nearest segment APIs;
-- environment configuration functions;
-- global allocator override;
-- mutable settings;
-- user callbacks inside C loops.
-
-Those require separate ownership and callback-safety contracts before implementation.

data/docs/LOW_LEVEL_GEOMETRY.md

@@ -1,121 +0,0 @@
-# Low-level geometry wrappers
-
-This document covers Expansion Block E.
-
-## Scope
-
-The first low-level API exposes borrowed read-only views over TG child types:
-
-- `TG::Geometry::Line`
-- `TG::Geometry::Ring`
-- `TG::Geometry::Polygon`
-- `TG::Geometry::Segment`
-
-These wrappers are created only from `TG::Geometry::Geom`, `TG::Geometry::Polygon`, `TG::Geometry::Line`, and `TG::Geometry::Ring` methods. Public `.allocate` is disabled for all four classes.
-
-## Ownership model
-
-TG child accessors return borrowed pointers owned by the parent `struct tg_geom`. The Line/Ring/Polygon Ruby wrappers therefore store:
-
-- `geom_owner`: the original `TG::Geometry::Geom` Ruby object;
-- a borrowed `const struct tg_line *`, `const struct tg_ring *`, or `const struct tg_poly *` pointer.
-
-The wrappers mark `geom_owner` with `rb_gc_mark_movable` and update it in `dcompact` with `rb_gc_location`. They do not call `tg_line_free`, `tg_ring_free`, or `tg_poly_free` for borrowed children.
-
-`TG::Geometry::Segment` is a value wrapper over a copied `struct tg_segment`, so it does not store `geom_owner` and does not free any TG-owned pointer.
-
-Allocator pairs:
-
-Resource | Allocator | Deallocator | Owner | Notes
---- | --- | --- | --- | ---
-`tg_line_wrapper_t` | `TypedData_Make_Struct` / Ruby allocator | `ruby_xfree` | Ruby object | borrowed pointer, marks parent `geom_owner`
-`tg_ring_wrapper_t` | `TypedData_Make_Struct` / Ruby allocator | `ruby_xfree` | Ruby object | borrowed pointer, marks parent `geom_owner`
-`tg_polygon_wrapper_t` | `TypedData_Make_Struct` / Ruby allocator | `ruby_xfree` | Ruby object | borrowed pointer, marks parent `geom_owner`
-`tg_segment_wrapper_t` | `TypedData_Make_Struct` / Ruby allocator | `ruby_xfree` | Ruby object | owns copied `struct tg_segment` value
-TG child pointers | parent `struct tg_geom` | parent `TG::Geometry::Geom` dfree | parent geometry | never freed by child wrappers
-
-## Public API
-
-### `TG::Geometry::Geom#point`
-
-Returns `[x, y]` for point geometries. Returns `nil` for non-point geometries.
-
-### `TG::Geometry::Geom#line`
-
-Returns a frozen `TG::Geometry::Line` for LineString geometries. Returns `nil` otherwise.
-
-### `TG::Geometry::Geom#polygon`
-
-Returns a frozen `TG::Geometry::Polygon` for Polygon geometries. Returns `nil` otherwise.
-
-### `TG::Geometry::Line`
-
-Methods:
-
-- `bbox -> TG::Geometry::Rect`
-- `num_points -> Integer`
-- `point_at(index) -> [Float, Float]`
-- `points -> Array<[Float, Float]>`
-- `num_segments -> Integer`
-- `segment_at(index) -> TG::Geometry::Segment`
-- `segments -> Array<TG::Geometry::Segment>`
-- `length -> Float`
-- `clockwise? -> Boolean`
-
-`length` is measured in input coordinate units. For lon/lat data this is not meters.
-
-### `TG::Geometry::Ring`
-
-Methods:
-
-- `bbox -> TG::Geometry::Rect`
-- `num_points -> Integer`
-- `point_at(index) -> [Float, Float]`
-- `points -> Array<[Float, Float]>`
-- `num_segments -> Integer`
-- `segment_at(index) -> TG::Geometry::Segment`
-- `segments -> Array<TG::Geometry::Segment>`
-- `area -> Float`
-- `perimeter -> Float`
-- `clockwise? -> Boolean`
-- `convex? -> Boolean`
-
-`area` and `perimeter` are measured in input coordinate units. For lon/lat data these are not square meters or meters.
-
-### `TG::Geometry::Polygon`
-
-Methods:
-
-- `bbox -> TG::Geometry::Rect`
-- `exterior_ring -> TG::Geometry::Ring`
-- `num_holes -> Integer`
-- `hole_at(index) -> TG::Geometry::Ring`
-- `holes -> Array<TG::Geometry::Ring>`
-- `clockwise? -> Boolean`
-
-`hole_at` rejects out-of-range indexes with `TG::Geometry::ArgumentError`.
-
-### `TG::Geometry::Segment`
-
-Methods:
-
-- `a -> [Float, Float]`
-- `b -> [Float, Float]`
-- `points -> [[Float, Float], [Float, Float]]`
-- `bbox -> TG::Geometry::Rect`
-- `intersects?(other_segment) -> Boolean`
-
-Segments are copied by value from a line or ring. They do not keep or free borrowed TG pointers.
-
-## Error paths
-
-- Wrong wrapper type is handled by `TypedData_Get_Struct` and raises `TypeError`.
-- Out-of-range child indexes raise `TG::Geometry::ArgumentError`.
-- Child wrappers are immutable and cannot be constructed directly from Ruby.
-
-## Not implemented in this block
-
-- Low-level constructors for Ring, Line, or Polygon.
-- Mutable coordinate access.
-- Polygon `area` / `perimeter` convenience aggregation. Ring-level values are exposed first to avoid undocumented assumptions about hole orientation and aggregation semantics.
-- Geodesic length/area.