com.wallstop-studios.unity-helpers 2.0.0-rc81.7 → 2.0.0-rc81.9

package/Docs/Images/octree_3d.svg

@@ -0,0 +1,79 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="560" height="420" viewBox="0 0 560 420">
+  <rect x="0" y="0" width="560" height="420" fill="#0f0f13"/>
+  <g font-family="Verdana,Arial,sans-serif" font-size="14" fill="#c8d1dc">
+    <text x="16" y="26">Octree (3D) — Three Orthogonal Splits</text>
+  </g>
+  <!-- complete cube wireframe (axonometric) -->
+  <g fill="none" stroke="#9fb3c8" stroke-width="2">
+    <!-- front face -->
+    <rect x="160" y="140" width="240" height="180"/>
+    <!-- back face (offset) -->
+    <rect x="200" y="110" width="240" height="180"/>
+    <!-- connecting edges -->
+    <line x1="160" y1="140" x2="200" y2="110"/>
+    <line x1="400" y1="140" x2="440" y2="110"/>
+    <line x1="160" y1="320" x2="200" y2="290"/>
+    <line x1="400" y1="320" x2="440" y2="290"/>
+  </g>
+
+  <!-- X-split (vertical plane through center) -->
+  <g fill="rgba(213, 122, 122, 0.12)" stroke="#d57a7a" stroke-width="2" stroke-dasharray="6 6">
+    <polygon points="280,140 320,110 320,290 280,320"/>
+  </g>
+  <!-- x-split label bubble (red, near plane) -->
+  <g font-family="Verdana,Arial,sans-serif" font-size="11">
+    <rect x="268" y="120" width="56" height="18" rx="6" ry="6" fill="#242a34" stroke="#d57a7a" stroke-width="1.5"/>
+    <text x="272" y="133" fill="#d57a7a">x-split</text>
+  </g>
+
+  <!-- Y-split (horizontal plane) -->
+  <g fill="rgba(94, 198, 154, 0.12)" stroke="#5ec69a" stroke-width="2" stroke-dasharray="6 6">
+    <polygon points="160,230 200,200 440,200 400,230"/>
+  </g>
+  <!-- y-split label bubble -->
+  <g font-family="Verdana,Arial,sans-serif" font-size="11">
+    <rect x="416" y="186" width="56" height="18" rx="6" ry="6" fill="#242a34" stroke="#5ec69a" stroke-width="1.5"/>
+    <text x="420" y="199" fill="#5ec69a">y-split</text>
+  </g>
+
+  <!-- Z-split (depth-aligned plane parallel to front, mid-depth) -->
+  <g fill="rgba(122, 162, 255, 0.10)" stroke="#7aa2ff" stroke-width="2" stroke-dasharray="6 6">
+    <polygon points="180,125 420,125 420,305 180,305"/>
+  </g>
+  <!-- z-split label bubble -->
+  <g font-family="Verdana,Arial,sans-serif" font-size="11">
+    <rect x="424" y="112" width="56" height="18" rx="6" ry="6" fill="#242a34" stroke="#7aa2ff" stroke-width="1.5"/>
+    <text x="428" y="125" fill="#7aa2ff">z-split</text>
+  </g>
+
+  <!-- points -->
+  <g fill="#e0e6ee">
+    <circle cx="210" cy="260" r="3"/>
+    <circle cx="300" cy="190" r="3"/>
+    <circle cx="360" cy="240" r="3"/>
+    <circle cx="260" cy="300" r="3"/>
+    <circle cx="420" cy="180" r="3"/>
+  </g>
+
+  <!-- axis hints (moved outside box; lighter strokes and clearer labels) -->
+  <g stroke="#9fb3c8" stroke-width="1.5" fill="none" opacity="0.85">
+    <!-- origin for axes -->
+    <!-- x-axis (to the right) -->
+    <line x1="80" y1="380" x2="140" y2="380"/>
+    <polygon fill="#9fb3c8" points="134,374 134,386 146,380"/>
+    <!-- y-axis (up-right/back) -->
+    <line x1="80" y1="380" x2="110" y2="360"/>
+    <polygon fill="#9fb3c8" points="106,356 113,364 118,358"/>
+    <!-- z-axis (upward) -->
+    <line x1="80" y1="380" x2="80" y2="340"/>
+    <polygon fill="#9fb3c8" points="74,346 86,346 80,334"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" text-anchor="start">
+    <rect x="142" y="372" width="22" height="16" rx="6" ry="6" fill="#242a34" stroke="#3a4354" stroke-width="1"/>
+    <text x="146" y="384" fill="#e0e6ee">+x</text>
+    <rect x="112" y="349" width="22" height="16" rx="6" ry="6" fill="#242a34" stroke="#3a4354" stroke-width="1"/>
+    <text x="116" y="361" fill="#e0e6ee">+y</text>
+    <rect x="70" y="327" width="22" height="16" rx="6" ry="6" fill="#242a34" stroke="#3a4354" stroke-width="1"/>
+    <text x="74" y="339" fill="#e0e6ee">+z</text>
+  </g>
+</svg>

package/Docs/Images/octree_3d.svg.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 69f15367d88369940b4f530384fa028c
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Docs/Images/polyline_simplify.svg

@@ -0,0 +1,18 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="560" height="260" viewBox="0 0 560 260">
+  <rect x="0" y="0" width="560" height="260" fill="#0f0f13"/>
+  <g font-family="Verdana,Arial,sans-serif" font-size="12" fill="#c8d1dc">
+    <text x="16" y="24">Polyline Simplification (Douglas–Peucker)</text>
+  </g>
+  <!-- original polyline -->
+  <g fill="none" stroke="#7aa2ff" stroke-width="2">
+    <polyline points="40,200 80,180 120,190 160,150 200,160 240,140 280,145 320,120 360,130 400,90 440,110 480,100 520,80"/>
+  </g>
+  <!-- simplified polyline -->
+  <g fill="none" stroke="#66d9a8" stroke-width="3">
+    <polyline points="40,200 160,150 320,120 520,80"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" fill="#9fb3c8">
+    <text x="70" y="210">Original</text>
+    <text x="340" y="150">Simplified</text>
+  </g>
+</svg>

package/Docs/Images/polyline_simplify.svg.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 39bc13cd4b26a074eaa9b62f0a915baa
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Docs/Images/quadtree_2d.svg

@@ -0,0 +1,37 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="540" height="380" viewBox="0 0 540 380">
+  <rect x="0" y="0" width="540" height="380" fill="#0f0f13"/>
+  <g font-family="Verdana,Arial,sans-serif" font-size="12" fill="#c8d1dc">
+    <text x="16" y="24">QuadTree (2D) — Recursive 4-way partitioning</text>
+  </g>
+  <!-- world bounds -->
+  <g fill="none" stroke="#9fb3c8" stroke-width="2">
+    <rect x="40" y="60" width="460" height="300"/>
+  </g>
+  <!-- level 1 split -->
+  <g stroke="#3a7bd5" stroke-dasharray="6 6" stroke-width="2">
+    <line x1="270" y1="60" x2="270" y2="360"/>
+    <line x1="40" y1="210" x2="500" y2="210"/>
+  </g>
+  <!-- level 2 split (top-left quadrant) -->
+  <g stroke="#3a7bd5" stroke-dasharray="6 6" stroke-width="1.5">
+    <line x1="155" y1="60" x2="155" y2="210"/>
+    <line x1="40" y1="135" x2="270" y2="135"/>
+  </g>
+  <!-- points -->
+  <g fill="#7aa2ff">
+    <circle cx="110" cy="100" r="4"/>
+    <circle cx="200" cy="180" r="4"/>
+    <circle cx="320" cy="250" r="4"/>
+    <circle cx="430" cy="120" r="4"/>
+    <circle cx="460" cy="300" r="4"/>
+    <circle cx="140" cy="260" r="4"/>
+    <circle cx="250" cy="290" r="4"/>
+  </g>
+  <!-- labels (color-coded to split color) -->
+  <g font-family="Verdana,Arial,sans-serif" font-size="11">
+    <rect x="56" y="68" width="58" height="18" rx="6" ry="6" fill="#242a34" stroke="#3a7bd5" stroke-width="1.5"/>
+    <text x="60" y="81" fill="#3a7bd5">Level 1</text>
+    <rect x="56" y="138" width="58" height="18" rx="6" ry="6" fill="#242a34" stroke="#3a7bd5" stroke-width="1.5"/>
+    <text x="60" y="151" fill="#3a7bd5">Level 2</text>
+  </g>
+</svg>

package/Docs/Images/quadtree_2d.svg.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 7eb0d1c73ecb7384ab98089133e9a2d5
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Docs/Images/query_boundaries.svg

@@ -0,0 +1,38 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="760" height="320" viewBox="0 0 760 320">
+  <rect x="0" y="0" width="760" height="320" fill="#0f0f13"/>
+  <g font-family="Verdana,Arial,sans-serif" font-size="14" fill="#c8d1dc">
+    <text x="16" y="26">Query Boundaries — Closed vs Half-Open</text>
+  </g>
+  <!-- legend: green=included, red=excluded -->
+  <g font-family="Verdana,Arial,sans-serif" font-size="12">
+    <circle cx="560" cy="22" r="5" fill="#66d9a8"/>
+    <text x="572" y="26" fill="#c8d1dc">included</text>
+    <circle cx="650" cy="22" r="5" fill="#d57a7a"/>
+    <text x="662" y="26" fill="#c8d1dc">excluded</text>
+  </g>
+  <!-- bounds A -->
+  <g fill="none" stroke="#7aa2ff" stroke-width="2">
+    <rect x="60" y="80" width="260" height="160"/>
+  </g>
+  <!-- point on max edge -->
+  <g fill="#66d9a8">
+    <circle cx="320" cy="160" r="4"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" fill="#9fb3c8">
+    <text x="60" y="60">Closed [min,max]: includes max edge</text>
+  </g>
+  <!-- bounds B -->
+  <g fill="none" stroke="#7aa2ff" stroke-width="2">
+    <rect x="420" y="80" width="260" height="160"/>
+  </g>
+  <!-- same point on max edge (excluded) -->
+  <g fill="#d57a7a">
+    <circle cx="680" cy="160" r="4"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" fill="#9fb3c8">
+    <text x="420" y="60">Half-open [min,max): excludes max edge</text>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" fill="#c8d1dc">
+    <text x="60" y="260">Tip: add small epsilon when comparing boundaries across structures.</text>
+  </g>
+</svg>

package/Docs/Images/query_boundaries.svg.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: c5967f82e34e6f44d951bd8db69707d2
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Docs/Images/random_generators.svg

@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="820" height="360" viewBox="0 0 820 360" version="1.1">
+  <title>Random Generators — Landscape &amp; Usage</title>
+  <desc>Overview of RNG families and guidance. Boxes: PCG, XorShift/Xoshiro, SplitMix, System/Unity Adapters. Notes on streams, distributions, determinism, performance, threading.</desc>
+  <rect x="0" y="0" width="820" height="360" fill="#0f0f13"/>
+  <g font-family="Verdana,Arial,sans-serif" font-size="14" fill="#c8d1dc">
+    <text x="16" y="26">Random Generators — Landscape &amp; Usage</text>
+  </g>
+  <g fill="#1d2330" stroke="#7aa2ff" stroke-width="2">
+    <rect x="40" y="60" width="160" height="50" rx="8"/>
+    <rect x="220" y="60" width="160" height="50" rx="8"/>
+    <rect x="400" y="60" width="160" height="50" rx="8"/>
+    <rect x="580" y="60" width="200" height="50" rx="8"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="12" fill="#e0e6ee" text-anchor="middle">
+    <text x="120" y="92">PCG</text>
+    <text x="300" y="92">XorShift/Xoshiro</text>
+    <text x="480" y="92">SplitMix</text>
+    <text x="680" y="92">System / Unity Adapters</text>
+  </g>
+  <g fill="none" stroke="#9fb3c8" stroke-dasharray="6 6" stroke-width="2">
+    <rect x="40" y="130" width="740" height="200" rx="8"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" fill="#c8d1dc">
+    <text x="50" y="150">- Streams/Seeding: per-thread/per-entity streams to avoid contention/correlation</text>
+    <text x="50" y="168">- Distributions: uniform, Gaussian, ranges; adapters for ints/floats/vectors</text>
+    <text x="50" y="186">- Determinism: seed management for replayability</text>
+    <text x="50" y="204">- Performance: prefer PCG/Xoshiro for hot loops</text>
+    <text x="50" y="222">- Threading: avoid sharing RNG across threads without locking</text>
+  </g>
+  <!-- mini visuals: histogram (uniform), gaussian curve, dice, bits -->
+  <!-- Uniform histogram -->
+  <g stroke="#7aa2ff" fill="rgba(122,162,255,0.25)">
+    <!-- baseline x=70..170, y base=300, bar width ~8 -->
+    <rect x="70" y="260" width="8" height="40"/>
+    <rect x="80" y="255" width="8" height="45"/>
+    <rect x="90" y="262" width="8" height="38"/>
+    <rect x="100" y="258" width="8" height="42"/>
+    <rect x="110" y="254" width="8" height="46"/>
+    <rect x="120" y="257" width="8" height="43"/>
+    <rect x="130" y="260" width="8" height="40"/>
+    <rect x="140" y="255" width="8" height="45"/>
+    <rect x="150" y="261" width="8" height="39"/>
+    <rect x="160" y="258" width="8" height="42"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="10" fill="#9fb3c8">
+    <text x="70" y="315">uniform</text>
+  </g>
+
+  <!-- Gaussian curve (proper normal distribution) -->
+  <g stroke="#5ec69a" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+    <!-- Mean=280, sigma=20, base=300, amplitude=60; y = base - amp * exp(-((x-mean)^2)/(2*sigma^2)) -->
+    <path fill="#5ec69a" fill-opacity="0.18"
+          d="M220 299.33
+             L230 297.36
+             L240 291.88
+             L250 280.52
+             L260 263.61
+             L270 247.05
+             L280 240
+             L290 247.05
+             L300 263.61
+             L310 280.52
+             L320 291.88
+             L330 297.36
+             L340 299.33
+             L340 300
+             L220 300 Z"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="10" fill="#9fb3c8">
+    <text x="240" y="315">gaussian</text>
+  </g>
+
+  <!-- Dice outcomes -->
+  <g stroke="#c8d1dc" fill="#1d2330">
+    <rect x="380" y="255" width="24" height="24" rx="4"/>
+    <rect x="410" y="255" width="24" height="24" rx="4"/>
+    <rect x="440" y="255" width="24" height="24" rx="4"/>
+    <rect x="470" y="255" width="24" height="24" rx="4"/>
+  </g>
+  <g fill="#e0e6ee">
+    <!-- pip patterns 1,2,5,6 -->
+    <circle cx="392" cy="267" r="2"/>
+    <circle cx="420" cy="262" r="2"/>
+    <circle cx="424" cy="276" r="2"/>
+    <circle cx="450" cy="260" r="2"/>
+    <circle cx="452" cy="268" r="2"/>
+    <circle cx="458" cy="276" r="2"/>
+    <circle cx="480" cy="260" r="2"/>
+    <circle cx="490" cy="260" r="2"/>
+    <circle cx="480" cy="276" r="2"/>
+    <circle cx="490" cy="276" r="2"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="10" fill="#9fb3c8">
+    <text x="390" y="315">discrete outcomes</text>
+  </g>
+
+  <!-- Random bits row -->
+  <g font-family="Consolas,Menlo,monospace" font-size="12" fill="#c8d1dc">
+    <text x="560" y="270">1011 0101 1100 0110</text>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="10" fill="#9fb3c8">
+    <text x="560" y="315">bit patterns</text>
+  </g>
+</svg>

package/Docs/Images/random_generators.svg.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 535e22c9e013be6449afc7018dd09408
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Docs/Images/reflection_scan.svg

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="820" height="320" viewBox="0 0 820 320" version="1.1">
+  <title>Reflection Helpers — Scan &amp; Cache</title>
+  <desc>Illustrates the scan-&gt;attributes-&gt;cache flow and notes about editor/runtime scanning, caching, and invalidation.</desc>
+  <rect x="0" y="0" width="820" height="320" fill="#0f0f13"/>
+  <g font-family="Verdana,Arial,sans-serif" font-size="14" fill="#c8d1dc">
+    <text x="16" y="26">Reflection Helpers — Scan &amp; Cache</text>
+  </g>
+  <g fill="#1d2330" stroke="#7aa2ff" stroke-width="2">
+    <rect x="40" y="60" width="220" height="50" rx="8"/>
+    <rect x="300" y="60" width="220" height="50" rx="8"/>
+    <rect x="560" y="60" width="220" height="50" rx="8"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="12" fill="#e0e6ee" text-anchor="middle">
+    <text x="150" y="92">Scan Assemblies</text>
+    <text x="410" y="92">Find Attributes</text>
+    <text x="670" y="92">Build Cache</text>
+  </g>
+  <g stroke="#5ec69a" fill="#5ec69a" stroke-width="2">
+    <line x1="260" y1="85" x2="300" y2="85"/>
+    <polygon points="294,79 294,91 304,85"/>
+    <line x1="520" y1="85" x2="560" y2="85"/>
+    <polygon points="554,79 554,91 564,85"/>
+  </g>
+  <g fill="none" stroke="#9fb3c8" stroke-dasharray="6 6" stroke-width="2">
+    <rect x="60" y="140" width="720" height="130" rx="8"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" fill="#c8d1dc">
+    <text x="70" y="160">- Editor: scan on domain reload; Runtime: scan on first use</text>
+    <text x="70" y="178">- Caches: type → members with attributes, getters/setters delegates</text>
+    <text x="70" y="196">- Invalidation: assembly reloads, explicit clear</text>
+  </g>
+</svg>

package/Docs/Images/reflection_scan.svg.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 6ad5a1e81e95d694a93480e0dd8034e3
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Docs/Images/relational_wiring.svg

@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="920" height="440" viewBox="0 0 920 440" version="1.1">
+  <title>Relational Components — Discovery &amp; Wiring</title>
+  <desc>Shows scene graph (parent/children) and the OnValidate/Awake scan flow that wires [ParentComponent]/[ChildComponent]/[SiblingComponent] with cached lookups.</desc>
+  <rect x="0" y="0" width="920" height="440" fill="#0f0f13"/>
+  <g font-family="Verdana,Arial,sans-serif" font-size="14" fill="#c8d1dc">
+    <text x="16" y="26">Relational Components — Discovery &amp; Wiring</text>
+  </g>
+  <!-- scene graph (spaced) -->
+  <g fill="#1d2330" stroke="#7aa2ff" stroke-width="2">
+    <rect x="80" y="60" width="140" height="46" rx="6"/>
+    <rect x="40" y="180" width="140" height="46" rx="6"/>
+    <rect x="200" y="180" width="140" height="46" rx="6"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="12" fill="#e0e6ee" text-anchor="middle">
+    <text x="150" y="90">Parent</text>
+    <text x="110" y="208">Child A</text>
+    <text x="270" y="208">Child B</text>
+  </g>
+  <!-- relations -->
+  <g stroke="#9fb3c8" stroke-width="2">
+    <line x1="150" y1="106" x2="110" y2="180"/>
+    <line x1="150" y1="106" x2="270" y2="180"/>
+  </g>
+  <!-- wiring flow (wider, multi-line, spaced, color-coded) -->
+  <g fill="#1d2330" stroke-width="2">
+    <!-- Scan box (purple) -->
+    <rect x="480" y="60" width="400" height="64" rx="8" stroke="#c792ea"/>
+    <!-- Resolve box (gold) -->
+    <rect x="480" y="154" width="400" height="64" rx="8" stroke="#e5c07b"/>
+    <!-- Bind box (green) -->
+    <rect x="480" y="248" width="400" height="64" rx="8" stroke="#5ec69a"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" fill="#e6ebf2">
+    <text x="492" y="82">
+      <tspan x="492" dy="0">OnValidate/Awake: scan components</tspan>
+      <tspan x="492" dy="16">[Parent] / [Child] / [Sibling]</tspan>
+    </text>
+    <text x="492" y="176">
+      <tspan x="492" dy="0">Resolve via Transform hierarchy</tspan>
+      <tspan x="492" dy="16">and cached lookups</tspan>
+    </text>
+    <text x="492" y="270">
+      <tspan x="492" dy="0">Bind fields/properties; rebind</tspan>
+      <tspan x="492" dy="16">on hierarchy changes</tspan>
+    </text>
+  </g>
+  <!-- connectors (color match next stage; arrowheads stop before boxes) -->
+  <g stroke-width="2">
+    <!-- left to first box (purple) -->
+    <g stroke="#c792ea" fill="#c792ea">
+      <line x1="360" y1="100" x2="468" y2="100"/>
+      <polygon points="462,94 462,106 472,100"/>
+    </g>
+    <!-- between boxes (gold) -->
+    <g stroke="#e5c07b" fill="#e5c07b">
+      <line x1="680" y1="124" x2="680" y2="146"/>
+      <polygon points="674,140 686,140 680,148"/>
+    </g>
+    <!-- between boxes (green) -->
+    <g stroke="#5ec69a" fill="#5ec69a">
+      <line x1="680" y1="218" x2="680" y2="240"/>
+      <polygon points="674,234 686,234 680,244"/>
+    </g>
+  </g>
+  <!-- legend for color coding -->
+  <g font-family="Verdana,Arial,sans-serif" font-size="11">
+    <rect x="480" y="330" width="14" height="14" fill="#c792ea" rx="3" ry="3"/>
+    <text x="500" y="341" fill="#e6ebf2">Scan</text>
+    <rect x="560" y="330" width="14" height="14" fill="#e5c07b" rx="3" ry="3"/>
+    <text x="580" y="341" fill="#e6ebf2">Resolve</text>
+    <rect x="660" y="330" width="14" height="14" fill="#5ec69a" rx="3" ry="3"/>
+    <text x="680" y="341" fill="#e6ebf2">Bind</text>
+  </g>
+</svg>

package/Docs/Images/relational_wiring.svg.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: c42aa6b33dc0b9a448c05ad6d0e0b93e
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Docs/Images/rtree_2d.svg

@@ -0,0 +1,27 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="540" height="380" viewBox="0 0 540 380">
+  <rect x="0" y="0" width="540" height="380" fill="#0f0f13"/>
+  <g font-family="Verdana,Arial,sans-serif" font-size="12" fill="#c8d1dc">
+    <text x="16" y="24">R-Tree (2D) — Grouped minimum bounding rectangles</text>
+  </g>
+  <!-- object rectangles -->
+  <g fill="rgba(122,162,255,0.15)" stroke="#7aa2ff" stroke-width="2">
+    <rect x="80" y="100" width="40" height="28"/>
+    <rect x="130" y="140" width="30" height="30"/>
+    <rect x="200" y="90" width="45" height="35"/>
+    <rect x="250" y="180" width="50" height="40"/>
+    <rect x="360" y="120" width="50" height="30"/>
+    <rect x="410" y="260" width="60" height="35"/>
+  </g>
+  <!-- MBR groups -->
+  <g fill="none" stroke="#66d9a8" stroke-width="2.5" stroke-dasharray="8 6">
+    <rect x="70" y="80" width="190" height="110"/>
+    <rect x="240" y="170" width="110" height="70"/>
+    <rect x="340" y="100" width="150" height="210"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" fill="#9fb3c8">
+    <text x="76" y="92">Leaf group</text>
+    <text x="246" y="182">Leaf group</text>
+    <text x="346" y="112">Parent MBR</text>
+  </g>
+</svg>
+

package/Docs/Images/rtree_2d.svg.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 96831c50c45784749aed67abb7b2b992
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Docs/Images/rtree_3d.svg

@@ -0,0 +1,79 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="560" height="420" viewBox="0 0 560 420">
+  <rect x="0" y="0" width="560" height="420" fill="#0f0f13"/>
+  <g font-family="Verdana,Arial,sans-serif" font-size="14" fill="#c8d1dc">
+    <text x="16" y="26">R-Tree (3D) — MBR Hierarchy</text>
+  </g>
+  <!-- object boxes (3D cuboids, projected) -->
+  <g stroke="#7aa2ff" stroke-width="2" fill="rgba(122,162,255,0.12)">
+    <!-- helper: dx=20, dy=-15 for back face offset -->
+    <!-- box 1 -->
+    <rect x="140" y="180" width="40" height="30"/>
+    <rect x="160" y="165" width="40" height="30"/>
+    <line x1="140" y1="180" x2="160" y2="165"/>
+    <line x1="180" y1="180" x2="200" y2="165"/>
+    <line x1="140" y1="210" x2="160" y2="195"/>
+    <line x1="180" y1="210" x2="200" y2="195"/>
+    <!-- box 2 -->
+    <rect x="210" y="210" width="35" height="26"/>
+    <rect x="230" y="195" width="35" height="26"/>
+    <line x1="210" y1="210" x2="230" y2="195"/>
+    <line x1="245" y1="210" x2="265" y2="195"/>
+    <line x1="210" y1="236" x2="230" y2="221"/>
+    <line x1="245" y1="236" x2="265" y2="221"/>
+    <!-- box 3 -->
+    <rect x="280" y="160" width="45" height="35"/>
+    <rect x="300" y="145" width="45" height="35"/>
+    <line x1="280" y1="160" x2="300" y2="145"/>
+    <line x1="325" y1="160" x2="345" y2="145"/>
+    <line x1="280" y1="195" x2="300" y2="180"/>
+    <line x1="325" y1="195" x2="345" y2="180"/>
+    <!-- box 4 -->
+    <rect x="340" y="240" width="50" height="38"/>
+    <rect x="360" y="225" width="50" height="38"/>
+    <line x1="340" y1="240" x2="360" y2="225"/>
+    <line x1="390" y1="240" x2="410" y2="225"/>
+    <line x1="340" y1="278" x2="360" y2="263"/>
+    <line x1="390" y1="278" x2="410" y2="263"/>
+    <!-- box 5 -->
+    <rect x="400" y="190" width="40" height="28"/>
+    <rect x="420" y="175" width="40" height="28"/>
+    <line x1="400" y1="190" x2="420" y2="175"/>
+    <line x1="440" y1="190" x2="460" y2="175"/>
+    <line x1="400" y1="218" x2="420" y2="203"/>
+    <line x1="440" y1="218" x2="460" y2="203"/>
+  </g>
+  <!-- MBR groups (3D dashed cuboids) -->
+  <g fill="none" stroke="#66d9a8" stroke-width="2.5" stroke-dasharray="8 6">
+    <!-- left group -->
+    <rect x="120" y="160" width="220" height="110"/>
+    <rect x="140" y="145" width="220" height="110"/>
+    <line x1="120" y1="160" x2="140" y2="145"/>
+    <line x1="340" y1="160" x2="360" y2="145"/>
+    <line x1="120" y1="270" x2="140" y2="255"/>
+    <line x1="340" y1="270" x2="360" y2="255"/>
+    <!-- right group -->
+    <rect x="320" y="180" width="140" height="120"/>
+    <rect x="340" y="165" width="140" height="120"/>
+    <line x1="320" y1="180" x2="340" y2="165"/>
+    <line x1="460" y1="180" x2="480" y2="165"/>
+    <line x1="320" y1="300" x2="340" y2="285"/>
+    <line x1="460" y1="300" x2="480" y2="285"/>
+  </g>
+  <!-- axis hints (outside); consistent with KD/Octree -->
+  <g stroke="#9fb3c8" stroke-width="1.5" fill="none" opacity="0.85">
+    <line x1="60" y1="380" x2="120" y2="380"/>
+    <polygon fill="#9fb3c8" points="114,374 114,386 126,380"/>
+    <line x1="60" y1="380" x2="90" y2="360"/>
+    <polygon fill="#9fb3c8" points="86,356 93,364 98,358"/>
+    <line x1="60" y1="380" x2="60" y2="340"/>
+    <polygon fill="#9fb3c8" points="54,346 66,346 60,334"/>
+  </g>
+  <g font-family="Verdana,Arial,sans-serif" font-size="11" text-anchor="start">
+    <rect x="122" y="372" width="22" height="16" rx="6" ry="6" fill="#242a34" stroke="#3a4354" stroke-width="1"/>
+    <text x="126" y="384" fill="#e0e6ee">+x</text>
+    <rect x="92" y="349" width="22" height="16" rx="6" ry="6" fill="#242a34" stroke="#3a4354" stroke-width="1"/>
+    <text x="96" y="361" fill="#e0e6ee">+y</text>
+    <rect x="50" y="327" width="22" height="16" rx="6" ry="6" fill="#242a34" stroke="#3a4354" stroke-width="1"/>
+    <text x="54" y="339" fill="#e0e6ee">+z</text>
+  </g>
+</svg>

package/Docs/Images/rtree_3d.svg.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: e5a10316d59ffcb489e97bc2cda4a6cc
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: