@fjell/registry 4.4.7 → 4.4.9

package/docs/public/memory.md

@@ -0,0 +1,430 @@
+# Registry Memory Consumption Analysis
+
+> **Generated:** 2025-07-19T19:08:20.039Z
+> **Version:** 4.4.5
+> **Node.js:** v22.0.0
+> **Test Environment:** darwin arm64
+
+## Executive Summary
+
+  This document provides a comprehensive analysis of memory efficiency for the Fjell Registry library infrastructure. The tests focus on measuring memory overhead per registry instance to ensure optimal memory scaling and efficiency in production environments.
+
+"Memory efficiency per instance" refers to the average amount of memory used by each registry instance, helping identify how memory usage scales as the number of instances increases.
+
+## Memory Test Results
+
+| Operation | Description | Memory Delta | Per Instance | Avg Time (ms) | Threshold | Status |
+|-----------|-------------|--------------|--------------|---------------|-----------|--------|
+| registryCreation | Memory overhead of creating a Registry instance | 66.21 kB | N/A | 0.000 | 83.01 kB | ✅ PASS |
+| registryHubCreation | Memory overhead of creating a RegistryHub instance | 73.34 kB | N/A | 0.000 | 83.01 kB | ✅ PASS |
+| coordinateCreation | Memory overhead of creating Coordinate instances | 112.55 kB | 1.13 kB | 0.001 | 146.48 kB | ✅ PASS |
+| instanceCreation | Memory overhead of creating Instance objects | 158.27 kB | 1.58 kB | 0.001 | 244.14 kB | ✅ PASS |
+| registryStorage | Memory growth when registering instances in registry | 310.70 kB | 3.11 kB | 0.005 | 390.63 kB | ✅ PASS |
+| multiLevelTree | Memory overhead of multi-level instance tree structures | 212.92 kB | 4.26 kB | 0.005 | 585.94 kB | ✅ PASS |
+| scopedInstances | Memory overhead of instances with multiple scopes | 315.40 kB | 3.15 kB | 0.003 | 610.35 kB | ✅ PASS |
+| registryHubIntegration | Memory overhead of RegistryHub managing multiple registries | 281.44 kB | 2.81 kB | 0.012 | 2.29 MB | ✅ PASS |
+
+## Memory Efficiency Scaling Analysis (Statistical)
+
+### Per-Instance Memory Efficiency Results
+
+| Instance Count | Iterations | Memory Per Instance (Avg ± StdDev) | Time (Avg ± StdDev) | Status |
+|----------------|------------|-------------------------------------|---------------------|--------|
+| 10 | 50 | 3.73 kB ± 5.09 kB | 0.04 ± 0.14 ms | ✅ PASS |
+| 20 | 50 | 2.59 kB ± 1.67 kB | 0.09 ± 0.37 ms | ✅ PASS |
+| 50 | 50 | 2.31 kB ± 1.73 kB | 0.15 ± 0.63 ms | ✅ PASS |
+| 100 | 50 | 2.16 kB ± 1.75 kB | 0.31 ± 0.40 ms | ✅ PASS |
+| 200 | 50 | 2.28 kB ± 2.28 kB | 0.72 ± 1.37 ms | ✅ PASS |
+| 500 | 25 | 1.89 kB ± 1.35 kB | 3.35 ± 5.85 ms | ✅ PASS |
+| 1,000 | 25 | 2.05 kB ± 1.72 kB | 2.23 ± 2.49 ms | ✅ PASS |
+| 2,000 | 25 | 1.85 kB ± 1.52 kB | 5.32 ± 3.99 ms | ✅ PASS |
+| 5,000 | 10 | 1.51 kB ± 905 B | 13.19 ± 6.27 ms | ✅ PASS |
+| 10,000 | 10 | 1.76 kB ± 909 B | 18.37 ± 2.89 ms | ✅ PASS |
+
+### Detailed Statistical Analysis
+
+#### 10 Instances (50 iterations)
+
+**Memory Per Instance:**
+- Average: 3.73 kB
+- Range: 200 B - 27.14 kB
+- Standard Deviation: 5.09 kB
+
+**Creation Time:**
+- Average: 0.04 ms
+- Range: 0.01 - 1.03 ms
+- Standard Deviation: 0.14 ms
+
+#### 20 Instances (50 iterations)
+
+**Memory Per Instance:**
+- Average: 2.59 kB
+- Range: 200 B - 8.97 kB
+- Standard Deviation: 1.67 kB
+
+**Creation Time:**
+- Average: 0.09 ms
+- Range: 0.02 - 2.65 ms
+- Standard Deviation: 0.37 ms
+
+#### 50 Instances (50 iterations)
+
+**Memory Per Instance:**
+- Average: 2.31 kB
+- Range: 200 B - 9.98 kB
+- Standard Deviation: 1.73 kB
+
+**Creation Time:**
+- Average: 0.15 ms
+- Range: 0.05 - 4.55 ms
+- Standard Deviation: 0.63 ms
+
+#### 100 Instances (50 iterations)
+
+**Memory Per Instance:**
+- Average: 2.16 kB
+- Range: 200 B - 10.54 kB
+- Standard Deviation: 1.75 kB
+
+**Creation Time:**
+- Average: 0.31 ms
+- Range: 0.08 - 3.04 ms
+- Standard Deviation: 0.40 ms
+
+#### 200 Instances (50 iterations)
+
+**Memory Per Instance:**
+- Average: 2.28 kB
+- Range: 200 B - 11.64 kB
+- Standard Deviation: 2.28 kB
+
+**Creation Time:**
+- Average: 0.72 ms
+- Range: 0.17 - 7.75 ms
+- Standard Deviation: 1.37 ms
+
+#### 500 Instances (25 iterations)
+
+**Memory Per Instance:**
+- Average: 1.89 kB
+- Range: 200 B - 7.61 kB
+- Standard Deviation: 1.35 kB
+
+**Creation Time:**
+- Average: 3.35 ms
+- Range: 0.41 - 26.01 ms
+- Standard Deviation: 5.85 ms
+
+#### 1,000 Instances (25 iterations)
+
+**Memory Per Instance:**
+- Average: 2.05 kB
+- Range: 200 B - 7.63 kB
+- Standard Deviation: 1.72 kB
+
+**Creation Time:**
+- Average: 2.23 ms
+- Range: 0.84 - 8.48 ms
+- Standard Deviation: 2.49 ms
+
+#### 2,000 Instances (25 iterations)
+
+**Memory Per Instance:**
+- Average: 1.85 kB
+- Range: 449 B - 6.68 kB
+- Standard Deviation: 1.52 kB
+
+**Creation Time:**
+- Average: 5.32 ms
+- Range: 1.86 - 14.81 ms
+- Standard Deviation: 3.99 ms
+
+#### 5,000 Instances (10 iterations)
+
+**Memory Per Instance:**
+- Average: 1.51 kB
+- Range: 200 B - 3.86 kB
+- Standard Deviation: 905 B
+
+**Creation Time:**
+- Average: 13.19 ms
+- Range: 4.91 - 24.69 ms
+- Standard Deviation: 6.27 ms
+
+#### 10,000 Instances (10 iterations)
+
+**Memory Per Instance:**
+- Average: 1.76 kB
+- Range: 1.28 kB - 3.58 kB
+- Standard Deviation: 909 B
+
+**Creation Time:**
+- Average: 18.37 ms
+- Range: 13.29 - 25.13 ms
+- Standard Deviation: 2.89 ms
+
+
+### Memory Efficiency Pattern (Statistical Summary)
+
+The following data shows per-instance memory efficiency with confidence intervals:
+
+```
+Instance Count | Avg Per Instance | StdDev %
+           10 |          3.73 kB | 136.7%
+           20 |          2.59 kB | 64.5%
+           50 |          2.31 kB | 74.7%
+          100 |          2.16 kB | 81.0%
+          200 |          2.28 kB | 99.8%
+          500 |          1.89 kB | 71.3%
+         1000 |          2.05 kB | 83.9%
+         2000 |          1.85 kB | 82.1%
+         5000 |          1.51 kB | 58.6%
+        10000 |          1.76 kB | 50.5%
+```
+
+### Statistical Reliability
+
+- **Sample Sizes**: 10: 50 iterations, 20: 50 iterations, 50: 50 iterations, 100: 50 iterations, 200: 50 iterations, 500: 25 iterations, 1000: 25 iterations, 2000: 25 iterations, 5000: 10 iterations, 10000: 10 iterations
+- **Data Quality**: All measurements include statistical analysis with standard deviations
+- **Outlier Detection**: Raw data files available in `./docs/memory-data/` for detailed analysis
+- **Confidence**: Standard deviations indicate measurement reliability and consistency
+
+### Scaling Characteristics (Statistical)
+
+- **Per-Instance Memory Change**: -30.2% (2.16 kB → 1.51 kB)
+- **Memory Efficiency**: Needs optimization
+- **Per-Instance Consistency**: Excellent (< 1KB variation)
+- **Statistical Confidence**: High (multiple iterations with standard deviation analysis)
+
+## Detailed Memory Analysis
+
+### registryCreation
+
+**Description:** Memory overhead of creating a Registry instance
+**Iterations:** 100
+**Total Memory Delta:** 66.21 kB
+**Memory Per Instance:** N/A
+**Average Time:** 0.000 ms
+
+**Memory Breakdown:**
+- Heap Used: 66.21 kB
+- Heap Total: 0 B
+- External: 40 B
+- RSS: 0 B
+
+**Memory Threshold:** 83.01 kB
+**Time Threshold:** 1 ms
+**Status:** ✅ PASS
+
+### registryHubCreation
+
+**Description:** Memory overhead of creating a RegistryHub instance
+**Iterations:** 100
+**Total Memory Delta:** 73.34 kB
+**Memory Per Instance:** N/A
+**Average Time:** 0.000 ms
+
+**Memory Breakdown:**
+- Heap Used: 73.34 kB
+- Heap Total: 0 B
+- External: 0 B
+- RSS: 0 B
+
+**Memory Threshold:** 83.01 kB
+**Time Threshold:** 1.5 ms
+**Status:** ✅ PASS
+
+### coordinateCreation
+
+**Description:** Memory overhead of creating Coordinate instances
+**Iterations:** 100
+**Total Memory Delta:** 112.55 kB
+**Memory Per Instance:** 1.13 kB
+**Average Time:** 0.001 ms
+
+**Memory Breakdown:**
+- Heap Used: 112.55 kB
+- Heap Total: 0 B
+- External: 0 B
+- RSS: 0 B
+
+**Memory Threshold:** 146.48 kB
+**Time Threshold:** 0.5 ms
+**Status:** ✅ PASS
+
+### instanceCreation
+
+**Description:** Memory overhead of creating Instance objects
+**Iterations:** 100
+**Total Memory Delta:** 158.27 kB
+**Memory Per Instance:** 1.58 kB
+**Average Time:** 0.001 ms
+
+**Memory Breakdown:**
+- Heap Used: 158.27 kB
+- Heap Total: 0 B
+- External: 0 B
+- RSS: 0 B
+
+**Memory Threshold:** 244.14 kB
+**Time Threshold:** 1 ms
+**Status:** ✅ PASS
+
+### registryStorage
+
+**Description:** Memory growth when registering instances in registry
+**Iterations:** 100
+**Total Memory Delta:** 310.70 kB
+**Memory Per Instance:** 3.11 kB
+**Average Time:** 0.005 ms
+
+**Memory Breakdown:**
+- Heap Used: 310.70 kB
+- Heap Total: 0 B
+- External: 0 B
+- RSS: 0 B
+
+**Memory Threshold:** 390.63 kB
+**Time Threshold:** 1.5 ms
+**Status:** ✅ PASS
+
+### multiLevelTree
+
+**Description:** Memory overhead of multi-level instance tree structures
+**Iterations:** 50
+**Total Memory Delta:** 212.92 kB
+**Memory Per Instance:** 4.26 kB
+**Average Time:** 0.005 ms
+
+**Memory Breakdown:**
+- Heap Used: 212.92 kB
+- Heap Total: 0 B
+- External: 0 B
+- RSS: 0 B
+
+**Memory Threshold:** 585.94 kB
+**Time Threshold:** 2 ms
+**Status:** ✅ PASS
+
+### scopedInstances
+
+**Description:** Memory overhead of instances with multiple scopes
+**Iterations:** 100
+**Total Memory Delta:** 315.40 kB
+**Memory Per Instance:** 3.15 kB
+**Average Time:** 0.003 ms
+
+**Memory Breakdown:**
+- Heap Used: 315.40 kB
+- Heap Total: 0 B
+- External: 0 B
+- RSS: 16.00 kB
+
+**Memory Threshold:** 610.35 kB
+**Time Threshold:** 2 ms
+**Status:** ✅ PASS
+
+### registryHubIntegration
+
+**Description:** Memory overhead of RegistryHub managing multiple registries
+**Iterations:** 20
+**Total Memory Delta:** 281.44 kB
+**Memory Per Instance:** 2.81 kB
+**Average Time:** 0.012 ms
+
+**Memory Breakdown:**
+- Heap Used: 281.44 kB
+- Heap Total: 0 B
+- External: 0 B
+- RSS: 0 B
+
+**Memory Threshold:** 2.29 MB
+**Time Threshold:** 5 ms
+**Status:** ✅ PASS
+
+## Memory Constraints
+
+The following memory constraints are enforced to ensure optimal memory usage:
+
+### Infrastructure Overhead
+- **Registry Creation**: ≤ 83.01 kB
+- **Registry Hub Creation**: ≤ 83.01 kB
+- **Maximum Registry Overhead**: ≤ 117.19 kB
+
+### Per-Instance Overhead
+- **Instance Creation**: ≤ 2.44 kB per instance
+- **Coordinate Creation**: ≤ 1.46 kB per coordinate
+- **Instance Tree Node**: ≤ 3.91 kB per tree node
+- **Maximum Memory Per Instance**: ≤ 4.88 kB
+
+### Memory Efficiency Analysis
+
+The memory efficiency analysis focuses on per-instance memory overhead and how it scales with the number of instances.
+
+- **Registry Overhead Efficiency**: 20.2% under constraint limit
+- **Per-Instance Efficiency**: 67.6% under constraint limit
+
+## Performance Characteristics
+
+### Memory Efficiency Scaling
+- **Per-Instance Consistency**: Memory overhead per instance remains relatively constant as instance count increases
+- **Statistical Validation**: Multiple iterations ensure reliable measurements of per-instance efficiency
+- **Low Variance**: Small standard deviations indicate consistent per-instance memory usage
+- **Predictable Efficiency**: Memory efficiency per instance is predictable and optimized
+
+### Optimization Features
+- **Efficient Data Structures**: Uses optimized tree structures for instance storage
+- **Minimal Overhead**: Core registry infrastructure has very low memory footprint
+- **Consistent Performance**: Statistical analysis shows reliable memory patterns
+
+## Data Files
+
+Raw measurement data is available in the following files:
+- `./docs/memory-data/scaling-10-instances.json`
+- `./docs/memory-data/scaling-20-instances.json`
+- `./docs/memory-data/scaling-50-instances.json`
+- `./docs/memory-data/scaling-100-instances.json`
+- `./docs/memory-data/scaling-200-instances.json`
+- `./docs/memory-data/scaling-500-instances.json`
+- `./docs/memory-data/scaling-1000-instances.json`
+- `./docs/memory-data/scaling-2000-instances.json`
+- `./docs/memory-data/scaling-5000-instances.json`
+- `./docs/memory-data/scaling-10000-instances.json`
+
+These files contain all individual measurements, allowing for detailed statistical analysis and trend identification.
+
+## Recommendations
+
+### Memory Management
+1. **Monitor Instance Count**: Keep track of total instances across all registries
+2. **Statistical Analysis**: Use the statistical data to understand memory variance
+3. **Trend Analysis**: Review raw data files to identify memory usage patterns
+4. **Cleanup**: Ensure proper cleanup of unused instances and registries
+
+### Performance Optimization
+1. **Batch Operations**: Create instances in batches when possible
+2. **Registry Reuse**: Reuse registries instead of creating new ones frequently
+3. **Statistical Monitoring**: Use the statistical baselines to detect anomalies
+4. **Constraint Monitoring**: Regularly run memory tests to ensure constraints are met
+
+## Troubleshooting
+
+### Memory Issues
+If memory tests fail, consider:
+
+1. **Statistical Significance**: Check if failures are consistent across multiple iterations
+2. **Variance Analysis**: High standard deviations may indicate unstable conditions
+3. **Raw Data Review**: Examine individual measurements in data files for patterns
+4. **System Resources**: Ensure adequate system memory is available during testing
+
+### Constraint Violations
+If memory constraints are exceeded:
+
+1. **Statistical Confidence**: Verify violations are consistent across iterations
+2. **Trend Analysis**: Use historical data to identify if this is a regression
+3. **Outlier Investigation**: Check raw measurements for outliers affecting averages
+4. **Update Thresholds**: Consider updating constraints based on statistical analysis
+
+---
+
+*This document is automatically generated during memory testing and includes statistical analysis of multiple iterations. Raw data files are saved for detailed analysis.*

package/docs/public/timing-range.svg

@@ -0,0 +1,176 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="1200" height="800" xmlns="http://www.w3.org/2000/svg">
+  <style>
+    .axis { stroke: #333; stroke-width: 1; }
+    .grid { stroke: #ddd; stroke-width: 0.5; }
+    .label { font-family: Arial, sans-serif; font-size: 14px; fill: #333; }
+    .title { font-family: Arial, sans-serif; font-size: 16px; font-weight: bold; fill: #333; }
+    .subtitle { font-family: Arial, sans-serif; font-size: 12px; fill: #666; }
+    .register-mean { stroke: #e74c3c; stroke-width: 3; fill: none; }
+    .lookup-mean { stroke: #3498db; stroke-width: 3; fill: none; }
+    .register-band { fill: rgba(231, 76, 60, 0.2); stroke: #e74c3c; stroke-width: 1; }
+    .lookup-band { fill: rgba(52, 152, 219, 0.2); stroke: #3498db; stroke-width: 1; }
+    .register-dot { fill: #e74c3c; }
+    .lookup-dot { fill: #3498db; }
+    .legend { font-family: Arial, sans-serif; font-size: 12px; fill: #333; }
+    .axis-title { font-family: Arial, sans-serif; font-size: 16px; font-weight: bold; fill: #333; }
+    .metadata-title { font-family: Arial, sans-serif; font-size: 14px; font-weight: bold; fill: #333; }
+    .metadata-section { font-family: Arial, sans-serif; font-size: 14px; font-weight: bold; fill: #444; }
+    .metadata-label { font-family: Arial, sans-serif; font-size: 10px; fill: #666; }
+    .metadata-value { font-family: Arial, sans-serif; font-size: 10px; fill: #333; }
+  </style>
+
+  <!-- Background -->
+  <rect width="1200" height="800" fill="white"/>
+
+  <!-- Title -->
+  <text x="600" y="25" text-anchor="middle" class="title">Timing of Common Registry Operations</text>
+  <text x="600" y="45" text-anchor="middle" class="subtitle">Performance measurements across varying tree sizes</text>
+
+  <!-- Plot area -->
+  <g transform="translate(110,60)">
+
+    <!-- Grid lines (logarithmic scale) -->
+    <line x1="0" y1="405.47941100296094" x2="1015" y2="405.47941100296094" class="grid"/>
+    <text x="-10" y="409.47941100296094" text-anchor="end" class="label">0.05µs</text>
+    <line x1="0" y1="344.44867833493345" x2="1015" y2="344.44867833493345" class="grid"/>
+    <text x="-10" y="348.44867833493345" text-anchor="end" class="label">0.10µs</text>
+    <line x1="0" y1="283.41794566690595" x2="1015" y2="283.41794566690595" class="grid"/>
+    <text x="-10" y="287.41794566690595" text-anchor="end" class="label">0.20µs</text>
+    <line x1="0" y1="202.7397055014805" x2="1015" y2="202.7397055014805" class="grid"/>
+    <text x="-10" y="206.7397055014805" text-anchor="end" class="label">0.50µs</text>
+    <line x1="0" y1="141.708972833453" x2="1015" y2="141.708972833453" class="grid"/>
+    <text x="-10" y="145.708972833453" text-anchor="end" class="label">1.0µs</text>
+    <line x1="0" y1="80.6782401654255" x2="1015" y2="80.6782401654255" class="grid"/>
+    <text x="-10" y="84.6782401654255" text-anchor="end" class="label">2.0µs</text>
+    <line x1="0" y1="0" x2="1015" y2="0" class="grid"/>
+    <text x="-10" y="4" text-anchor="end" class="label">5.0µs</text>
+    <line x1="0" y1="0" x2="0" y2="460" class="grid"/>
+    <text x="0" y="480" text-anchor="middle" class="label">10</text>
+    <line x1="76.38636139973525" y1="0" x2="76.38636139973525" y2="460" class="grid"/>
+    <text x="76.38636139973525" y="480" text-anchor="middle" class="label">20</text>
+    <line x1="177.36363860026475" y1="0" x2="177.36363860026475" y2="460" class="grid"/>
+    <text x="177.36363860026475" y="480" text-anchor="middle" class="label">50</text>
+    <line x1="253.75" y1="0" x2="253.75" y2="460" class="grid"/>
+    <text x="253.75" y="480" text-anchor="middle" class="label">100</text>
+    <line x1="330.1363613997352" y1="0" x2="330.1363613997352" y2="460" class="grid"/>
+    <text x="330.1363613997352" y="480" text-anchor="middle" class="label">200</text>
+    <line x1="431.1136386002648" y1="0" x2="431.1136386002648" y2="460" class="grid"/>
+    <text x="431.1136386002648" y="480" text-anchor="middle" class="label">500</text>
+    <line x1="507.5" y1="0" x2="507.5" y2="460" class="grid"/>
+    <text x="507.5" y="480" text-anchor="middle" class="label">1k</text>
+    <line x1="583.8863613997353" y1="0" x2="583.8863613997353" y2="460" class="grid"/>
+    <text x="583.8863613997353" y="480" text-anchor="middle" class="label">2k</text>
+    <line x1="684.8636386002647" y1="0" x2="684.8636386002647" y2="460" class="grid"/>
+    <text x="684.8636386002647" y="480" text-anchor="middle" class="label">5k</text>
+    <line x1="761.25" y1="0" x2="761.25" y2="460" class="grid"/>
+    <text x="761.25" y="480" text-anchor="middle" class="label">10k</text>
+    <line x1="837.6363613997353" y1="0" x2="837.6363613997353" y2="460" class="grid"/>
+    <text x="837.6363613997353" y="480" text-anchor="middle" class="label">20k</text>
+    <line x1="938.6136386002647" y1="0" x2="938.6136386002647" y2="460" class="grid"/>
+    <text x="938.6136386002647" y="480" text-anchor="middle" class="label">50k</text>
+    <line x1="1015" y1="0" x2="1015" y2="460" class="grid"/>
+    <text x="1015" y="480" text-anchor="middle" class="label">100k</text>
+    <!-- Y-axis -->
+    <line x1="0" y1="0" x2="0" y2="460" class="axis"/>
+
+    <!-- X-axis -->
+    <line x1="0" y1="460" x2="1015" y2="460" class="axis"/>
+
+    <!-- Axis labels -->
+    <text x="507.5" y="510" text-anchor="middle" class="axis-title">Tree Size (items) - Log Scale</text>
+    <text transform="rotate(-90,-70,230)" x="-70" y="230" text-anchor="middle" class="axis-title">Execution Time (µs)</text>
+    <path d="M 0 148.74050590256667 L 76.38636139973525 148.7524277923311 L 177.36363860026475 148.44013071796422 L 253.75 163.96828165051454 L 330.1363613997352 162.08556246017355 L 431.1136386002648 172.30055096042298 L 507.5 164.83245476448178 L 583.8863613997353 182.97393995516205 L 684.8636386002647 169.94194464665668 L 761.25 151.0989993965061 L 837.6363613997353 160.0780931612813 L 938.6136386002647 148.48776057676235 L 1015 120.43534569475918" class="register-mean"/>
+    <path d="M 0 391.3646719514693 L 76.38636139973525 388.54139718542586 L 177.36363860026475 389.0557369024966 L 253.75 374.3747740786199 L 330.1363613997352 398.9692673319725 L 431.1136386002648 360.0500990825511 L 507.5 360.0275016662577 L 583.8863613997353 305.0657993375811 L 684.8636386002647 300.3208350816295 L 761.25 264.9832596121842 L 837.6363613997353 268.5823457977558 L 938.6136386002647 288.5555639615857 L 1015 247.60931540724576" class="lookup-mean"/>
+    <circle cx="0" cy="148.74050590256667" r="4" class="register-dot"/>
+    <circle cx="76.38636139973525" cy="148.7524277923311" r="4" class="register-dot"/>
+    <circle cx="177.36363860026475" cy="148.44013071796422" r="4" class="register-dot"/>
+    <circle cx="253.75" cy="163.96828165051454" r="4" class="register-dot"/>
+    <circle cx="330.1363613997352" cy="162.08556246017355" r="4" class="register-dot"/>
+    <circle cx="431.1136386002648" cy="172.30055096042298" r="4" class="register-dot"/>
+    <circle cx="507.5" cy="164.83245476448178" r="4" class="register-dot"/>
+    <circle cx="583.8863613997353" cy="182.97393995516205" r="4" class="register-dot"/>
+    <circle cx="684.8636386002647" cy="169.94194464665668" r="4" class="register-dot"/>
+    <circle cx="761.25" cy="151.0989993965061" r="4" class="register-dot"/>
+    <circle cx="837.6363613997353" cy="160.0780931612813" r="4" class="register-dot"/>
+    <circle cx="938.6136386002647" cy="148.48776057676235" r="4" class="register-dot"/>
+    <circle cx="1015" cy="120.43534569475918" r="4" class="register-dot"/>
+    <circle cx="0" cy="391.3646719514693" r="4" class="lookup-dot"/>
+    <circle cx="76.38636139973525" cy="388.54139718542586" r="4" class="lookup-dot"/>
+    <circle cx="177.36363860026475" cy="389.0557369024966" r="4" class="lookup-dot"/>
+    <circle cx="253.75" cy="374.3747740786199" r="4" class="lookup-dot"/>
+    <circle cx="330.1363613997352" cy="398.9692673319725" r="4" class="lookup-dot"/>
+    <circle cx="431.1136386002648" cy="360.0500990825511" r="4" class="lookup-dot"/>
+    <circle cx="507.5" cy="360.0275016662577" r="4" class="lookup-dot"/>
+    <circle cx="583.8863613997353" cy="305.0657993375811" r="4" class="lookup-dot"/>
+    <circle cx="684.8636386002647" cy="300.3208350816295" r="4" class="lookup-dot"/>
+    <circle cx="761.25" cy="264.9832596121842" r="4" class="lookup-dot"/>
+    <circle cx="837.6363613997353" cy="268.5823457977558" r="4" class="lookup-dot"/>
+    <circle cx="938.6136386002647" cy="288.5555639615857" r="4" class="lookup-dot"/>
+    <circle cx="1015" cy="247.60931540724576" r="4" class="lookup-dot"/>
+    <!-- Legend -->
+    <g transform="translate(20, 20)">
+      <rect x="0" y="0" width="190" height="80" fill="white" stroke="#ccc" stroke-width="1"/>
+
+      <!-- Register Instance Legend -->
+      <text x="10" y="20" class="legend" font-weight="bold">Register Instance</text>
+      <line x1="10" y1="30" x2="40" y2="30" class="register-mean"/>
+      <circle cx="25" cy="30" r="3" class="register-dot"/>
+      <text x="45" y="34" class="legend">Average Timing</text>
+
+      <!-- Lookup Instance Legend -->
+      <text x="10" y="55" class="legend" font-weight="bold">Lookup Instance</text>
+      <line x1="10" y1="65" x2="40" y2="65" class="lookup-mean"/>
+      <circle cx="25" cy="65" r="3" class="lookup-dot"/>
+      <text x="45" y="69" class="legend">Average Timing</text>
+    </g>
+
+  </g>
+
+  <!-- Test Metadata Section -->
+  <g transform="translate(50, 620)">
+    <!-- Left Column: System Information -->
+    <g transform="translate(20, 20)">
+      <text x="0" y="0" class="metadata-section">System Information</text>
+
+      <text x="0" y="25" class="metadata-label">Test Date:</text>
+      <text x="150" y="25" class="metadata-value">2025-07-21</text>
+
+      <text x="0" y="45" class="metadata-label">Package Version:</text>
+      <text x="150" y="45" class="metadata-value">@fjell/registry v4.4.5</text>
+
+      <text x="0" y="65" class="metadata-label">Node.js Version:</text>
+      <text x="150" y="65" class="metadata-value">v22.0.0 (darwin arm64)</text>
+
+      <text x="0" y="85" class="metadata-label">Platform:</text>
+      <text x="150" y="85" class="metadata-value">darwin arm64</text>
+
+      <text x="0" y="105" class="metadata-label">Compiler:</text>
+      <text x="150" y="105" class="metadata-value">TypeScript + Vite</text>
+    </g>
+
+    <!-- Center Column: Test Configuration -->
+    <g transform="translate(330, 20)">
+      <text x="0" y="0" class="metadata-section">Test Configuration</text>
+
+      <text x="0" y="25" class="metadata-label">Test Rounds:</text>
+      <text x="120" y="25" class="metadata-value">100 per tree size</text>
+
+      <text x="0" y="45" class="metadata-label">Iterations per Round:</text>
+      <text x="120" y="45" class="metadata-value">200 operations</text>
+
+      <text x="0" y="65" class="metadata-label">Total Measurements:</text>
+      <text x="120" y="65" class="metadata-value">20,000 per data point</text>
+    </g>
+
+    <!-- Right Column: Test Notes -->
+    <g transform="translate(600, 20)">
+      <text x="0" y="0" class="metadata-section">Test Notes</text>
+      <text x="0" y="25" class="metadata-label">• Performance measurements use Node.js performance.now() with microsecond precision</text>
+      <text x="0" y="42" class="metadata-label">• Each test includes warm-up iterations to minimize JIT compilation effects</text>
+      <text x="0" y="59" class="metadata-label">• Logging is mocked during timing tests to eliminate I/O overhead</text>
+      <text x="0" y="76" class="metadata-label">• Tests verify both mean performance and consistency (low standard deviation)</text>
+      <text x="0" y="93" class="metadata-label">• Statistical analysis ensures reliable performance measurements across all tree sizes</text>
+    </g>
+  </g>
+</svg>