@fjell/registry 4.4.6 → 4.4.9

package/docs/timing-range.svg

@@ -31,18 +31,18 @@
   <g transform="translate(110,60)">
 
     <!-- Grid lines (logarithmic scale) -->
-    <line x1="0" y1="405.8161250388523" x2="1015" y2="405.8161250388523" class="grid"/>
-    <text x="-10" y="409.8161250388523" text-anchor="end" class="label">0.10µs</text>
-    <line x1="0" y1="346.36644516472364" x2="1015" y2="346.36644516472364" class="grid"/>
-    <text x="-10" y="350.36644516472364" text-anchor="end" class="label">0.20µs</text>
-    <line x1="0" y1="267.7782431070532" x2="1015" y2="267.7782431070532" class="grid"/>
-    <text x="-10" y="271.7782431070532" text-anchor="end" class="label">0.50µs</text>
-    <line x1="0" y1="208.32856323292452" x2="1015" y2="208.32856323292452" class="grid"/>
-    <text x="-10" y="212.32856323292452" text-anchor="end" class="label">1.0µs</text>
-    <line x1="0" y1="148.87888335879586" x2="1015" y2="148.87888335879586" class="grid"/>
-    <text x="-10" y="152.87888335879586" text-anchor="end" class="label">2.0µs</text>
-    <line x1="0" y1="70.2906813011254" x2="1015" y2="70.2906813011254" class="grid"/>
-    <text x="-10" y="74.2906813011254" text-anchor="end" class="label">5.0µs</text>
+    <line x1="0" y1="414.21183286644987" x2="1015" y2="414.21183286644987" class="grid"/>
+    <text x="-10" y="418.21183286644987" text-anchor="end" class="label">0.10µs</text>
+    <line x1="0" y1="359.62470346155027" x2="1015" y2="359.62470346155027" class="grid"/>
+    <text x="-10" y="363.62470346155027" text-anchor="end" class="label">0.20µs</text>
+    <line x1="0" y1="287.46444348196144" x2="1015" y2="287.46444348196144" class="grid"/>
+    <text x="-10" y="291.46444348196144" text-anchor="end" class="label">0.50µs</text>
+    <line x1="0" y1="232.87731407706184" x2="1015" y2="232.87731407706184" class="grid"/>
+    <text x="-10" y="236.87731407706184" text-anchor="end" class="label">1.0µs</text>
+    <line x1="0" y1="178.29018467216224" x2="1015" y2="178.29018467216224" class="grid"/>
+    <text x="-10" y="182.29018467216224" text-anchor="end" class="label">2.0µs</text>
+    <line x1="0" y1="106.12992469257341" x2="1015" y2="106.12992469257341" class="grid"/>
+    <text x="-10" y="110.12992469257341" 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"/>
@@ -78,34 +78,34 @@
     <!-- 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 142.430798647259 L 76.38636139973525 96.73055537047361 L 177.36363860026475 177.4521950381918 L 253.75 83.99291100490706 L 330.1363613997352 186.4434713406274 L 431.1136386002648 202.25465028675842 L 507.5 59.44967987412866 L 583.8863613997353 196.07937177124188 L 684.8636386002647 160.13731944918072 L 761.25 116.85882864465992 L 837.6363613997353 193.5315909963606 L 938.6136386002647 194.8627036479004 L 1015 194.18947356142252" class="register-mean"/>
-    <path d="M 0 349.1456976647436 L 76.38636139973525 357.616470993962 L 177.36363860026475 375.0717416315533 L 253.75 366.1063731767276 L 330.1363613997352 400.55032012587134 L 431.1136386002648 388.16668967553164 L 507.5 397.0928704987528 L 583.8863613997353 359.67999645309214 L 684.8636386002647 314.1346785287632 L 761.25 291.54524655676005 L 837.6363613997353 304.65166773904434 L 938.6136386002647 347.2353709468816 L 1015 346.075329400909" class="lookup-mean"/>
-    <circle cx="0" cy="142.430798647259" r="4" class="register-dot"/>
-    <circle cx="76.38636139973525" cy="96.73055537047361" r="4" class="register-dot"/>
-    <circle cx="177.36363860026475" cy="177.4521950381918" r="4" class="register-dot"/>
-    <circle cx="253.75" cy="83.99291100490706" r="4" class="register-dot"/>
-    <circle cx="330.1363613997352" cy="186.4434713406274" r="4" class="register-dot"/>
-    <circle cx="431.1136386002648" cy="202.25465028675842" r="4" class="register-dot"/>
-    <circle cx="507.5" cy="59.44967987412866" r="4" class="register-dot"/>
-    <circle cx="583.8863613997353" cy="196.07937177124188" r="4" class="register-dot"/>
-    <circle cx="684.8636386002647" cy="160.13731944918072" r="4" class="register-dot"/>
-    <circle cx="761.25" cy="116.85882864465992" r="4" class="register-dot"/>
-    <circle cx="837.6363613997353" cy="193.5315909963606" r="4" class="register-dot"/>
-    <circle cx="938.6136386002647" cy="194.8627036479004" r="4" class="register-dot"/>
-    <circle cx="1015" cy="194.18947356142252" r="4" class="register-dot"/>
-    <circle cx="0" cy="349.1456976647436" r="4" class="lookup-dot"/>
-    <circle cx="76.38636139973525" cy="357.616470993962" r="4" class="lookup-dot"/>
-    <circle cx="177.36363860026475" cy="375.0717416315533" r="4" class="lookup-dot"/>
-    <circle cx="253.75" cy="366.1063731767276" r="4" class="lookup-dot"/>
-    <circle cx="330.1363613997352" cy="400.55032012587134" r="4" class="lookup-dot"/>
-    <circle cx="431.1136386002648" cy="388.16668967553164" r="4" class="lookup-dot"/>
-    <circle cx="507.5" cy="397.0928704987528" r="4" class="lookup-dot"/>
-    <circle cx="583.8863613997353" cy="359.67999645309214" r="4" class="lookup-dot"/>
-    <circle cx="684.8636386002647" cy="314.1346785287632" r="4" class="lookup-dot"/>
-    <circle cx="761.25" cy="291.54524655676005" r="4" class="lookup-dot"/>
-    <circle cx="837.6363613997353" cy="304.65166773904434" r="4" class="lookup-dot"/>
-    <circle cx="938.6136386002647" cy="347.2353709468816" r="4" class="lookup-dot"/>
-    <circle cx="1015" cy="346.075329400909" r="4" class="lookup-dot"/>
+    <path d="M 0 54.5871294048996 L 76.38636139973525 204.52223211454054 L 177.36363860026475 106.51935671032135 L 253.75 195.52814972290633 L 330.1363613997352 113.59480588788551 L 431.1136386002648 163.00101388142247 L 507.5 168.64530111783552 L 583.8863613997353 168.02389006721552 L 684.8636386002647 181.3006947529126 L 761.25 184.74259304128134 L 837.6363613997353 223.36673887164602 L 938.6136386002647 205.81985515489995 L 1015 213.90171946899312" class="register-mean"/>
+    <path d="M 0 384.9149488624966 L 76.38636139973525 389.00373120422694 L 177.36363860026475 398.33522029914974 L 253.75 405.4128705951004 L 330.1363613997352 403.43324668188495 L 431.1136386002648 395.4950539384694 L 507.5 378.3221393445412 L 583.8863613997353 349.59171308701286 L 684.8636386002647 357.5457555145213 L 761.25 309.89073610809453 L 837.6363613997353 343.0099722607768 L 938.6136386002647 344.3996689209627 L 1015 339.77636216178064" class="lookup-mean"/>
+    <circle cx="0" cy="54.5871294048996" r="4" class="register-dot"/>
+    <circle cx="76.38636139973525" cy="204.52223211454054" r="4" class="register-dot"/>
+    <circle cx="177.36363860026475" cy="106.51935671032135" r="4" class="register-dot"/>
+    <circle cx="253.75" cy="195.52814972290633" r="4" class="register-dot"/>
+    <circle cx="330.1363613997352" cy="113.59480588788551" r="4" class="register-dot"/>
+    <circle cx="431.1136386002648" cy="163.00101388142247" r="4" class="register-dot"/>
+    <circle cx="507.5" cy="168.64530111783552" r="4" class="register-dot"/>
+    <circle cx="583.8863613997353" cy="168.02389006721552" r="4" class="register-dot"/>
+    <circle cx="684.8636386002647" cy="181.3006947529126" r="4" class="register-dot"/>
+    <circle cx="761.25" cy="184.74259304128134" r="4" class="register-dot"/>
+    <circle cx="837.6363613997353" cy="223.36673887164602" r="4" class="register-dot"/>
+    <circle cx="938.6136386002647" cy="205.81985515489995" r="4" class="register-dot"/>
+    <circle cx="1015" cy="213.90171946899312" r="4" class="register-dot"/>
+    <circle cx="0" cy="384.9149488624966" r="4" class="lookup-dot"/>
+    <circle cx="76.38636139973525" cy="389.00373120422694" r="4" class="lookup-dot"/>
+    <circle cx="177.36363860026475" cy="398.33522029914974" r="4" class="lookup-dot"/>
+    <circle cx="253.75" cy="405.4128705951004" r="4" class="lookup-dot"/>
+    <circle cx="330.1363613997352" cy="403.43324668188495" r="4" class="lookup-dot"/>
+    <circle cx="431.1136386002648" cy="395.4950539384694" r="4" class="lookup-dot"/>
+    <circle cx="507.5" cy="378.3221393445412" r="4" class="lookup-dot"/>
+    <circle cx="583.8863613997353" cy="349.59171308701286" r="4" class="lookup-dot"/>
+    <circle cx="684.8636386002647" cy="357.5457555145213" r="4" class="lookup-dot"/>
+    <circle cx="761.25" cy="309.89073610809453" r="4" class="lookup-dot"/>
+    <circle cx="837.6363613997353" cy="343.0099722607768" r="4" class="lookup-dot"/>
+    <circle cx="938.6136386002647" cy="344.3996689209627" r="4" class="lookup-dot"/>
+    <circle cx="1015" cy="339.77636216178064" 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"/>
@@ -132,7 +132,7 @@
       <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-19</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>

package/docs/timing.md

@@ -1,7 +1,7 @@
 # Performance Timing Report
 
-Generated: 2025-07-19T19:08:20.231Z
-Version: 4.4.5
+Generated: 2025-07-21T04:04:11.800Z
+Version: 4.4.7
 Node.js: v22.0.0
 Platform: darwin arm64
 
@@ -15,43 +15,43 @@ Timing results are reported in microseconds (µs) for precision.
 
 | Operation | Description | Avg Time (µs) | Min Time (µs) | Max Time (µs) | Threshold (µs) | Status |
 |-----------|-------------|---------------|---------------|---------------|----------------|--------|
-| createRegistry | Time to create a new registry | 0.2 | 0.0 | 865.0 | 5000 | ✅ PASS |
-| createRegistryHub | Time to create a new registry hub | 0.1 | 0.0 | 395.9 | 5000 | ✅ PASS |
-| createInstance | Time to create a new instance | 1.0 | 0.2 | 3362.4 | 10000 | ✅ PASS |
-| registerInstance | Time to register an instance in registry | 6.0 | 0.7 | 14657.3 | 5000 | ✅ PASS |
-| lookupInstance | Time to lookup an existing instance from registry | 0.3 | 0.0 | 685.2 | 2000 | ✅ PASS |
-| completeWorkflow | Time for complete workflow: create hub, registry, instance, register, and lookup | 6.4 | 2.1 | 7064.8 | 25000 | ✅ PASS |
+| createRegistry | Time to create a new registry | 0.2 | 0.0 | 558.5 | 5000 | ✅ PASS |
+| createRegistryHub | Time to create a new registry hub | 0.1 | 0.0 | 321.1 | 5000 | ✅ PASS |
+| createInstance | Time to create a new instance | 1.0 | 0.2 | 3170.4 | 10000 | ✅ PASS |
+| registerInstance | Time to register an instance in registry | 6.9 | 0.8 | 40163.7 | 5000 | ✅ PASS |
+| lookupInstance | Time to lookup an existing instance from registry | 0.5 | 0.1 | 2411.6 | 2000 | ✅ PASS |
+| completeWorkflow | Time for complete workflow: create hub, registry, instance, register, and lookup | 6.4 | 2.1 | 8119.5 | 25000 | ✅ PASS |
 
 ## Scaling Performance Tests
 
 | Operation | Tree Size | Avg Time (µs) | Min Time (µs) | Max Time (µs) | Threshold (µs) | Status |
 |-----------|-----------|---------------|---------------|---------------|----------------|--------|
-| registerInstance_10 | 10 | 2.9 | 0.8 | 8043.9 | 5000 | ✅ PASS |
-| lookupInstance_10 | 10 | 0.2 | 0.0 | 57.5 | 2000 | ✅ PASS |
-| registerInstance_20 | 20 | 4.0 | 0.8 | 5138.1 | 5000 | ✅ PASS |
-| lookupInstance_20 | 20 | 0.4 | 0.0 | 2896.7 | 2000 | ✅ PASS |
-| registerInstance_50 | 50 | 1.8 | 0.7 | 3538.8 | 5000 | ✅ PASS |
-| lookupInstance_50 | 50 | 0.2 | 0.0 | 17.3 | 2000 | ✅ PASS |
-| registerInstance_100 | 100 | 3.0 | 0.8 | 3714.0 | 5000 | ✅ PASS |
-| lookupInstance_100 | 100 | 0.3 | 0.0 | 2029.2 | 2000 | ✅ PASS |
-| registerInstance_200 | 200 | 1.6 | 0.8 | 2891.4 | 10000 | ✅ PASS |
-| lookupInstance_200 | 200 | 0.3 | 0.0 | 2867.3 | 5000 | ✅ PASS |
-| registerInstance_500 | 500 | 1.5 | 0.7 | 3092.2 | 10000 | ✅ PASS |
-| lookupInstance_500 | 500 | 0.3 | 0.0 | 3657.6 | 5000 | ✅ PASS |
-| registerInstance_1000 | 1000 | 1.6 | 0.7 | 4527.8 | 10000 | ✅ PASS |
-| lookupInstance_1000 | 1000 | 0.2 | 0.0 | 2594.0 | 5000 | ✅ PASS |
-| registerInstance_2000 | 2000 | 1.1 | 0.8 | 63.3 | 20000 | ✅ PASS |
-| lookupInstance_2000 | 2000 | 0.2 | 0.0 | 8.2 | 10000 | ✅ PASS |
-| registerInstance_5000 | 5000 | 1.7 | 1.1 | 291.6 | 20000 | ✅ PASS |
-| lookupInstance_5000 | 5000 | 1.8 | 0.0 | 7794.5 | 10000 | ✅ PASS |
-| registerInstance_10000 | 10000 | 4.7 | 1.1 | 4041.7 | 20000 | ✅ PASS |
-| lookupInstance_10000 | 10000 | 0.3 | 0.0 | 46.0 | 10000 | ✅ PASS |
-| registerInstance_20000 | 20000 | 1.2 | 0.9 | 5.8 | 50000 | ✅ PASS |
-| lookupInstance_20000 | 20000 | 0.3 | 0.1 | 4.8 | 25000 | ✅ PASS |
-| registerInstance_50000 | 50000 | 1.2 | 0.9 | 18.1 | 50000 | ✅ PASS |
-| lookupInstance_50000 | 50000 | 0.2 | 0.1 | 3.4 | 25000 | ✅ PASS |
-| registerInstance_100000 | 100000 | 1.3 | 0.9 | 31.5 | 50000 | ✅ PASS |
-| lookupInstance_100000 | 100000 | 0.2 | 0.1 | 5.2 | 25000 | ✅ PASS |
+| registerInstance_10 | 10 | 2.5 | 0.9 | 8034.8 | 5000 | ✅ PASS |
+| lookupInstance_10 | 10 | 0.2 | 0.0 | 87.8 | 2000 | ✅ PASS |
+| registerInstance_20 | 20 | 2.1 | 0.8 | 6723.3 | 5000 | ✅ PASS |
+| lookupInstance_20 | 20 | 0.1 | 0.0 | 31.5 | 2000 | ✅ PASS |
+| registerInstance_50 | 50 | 2.4 | 0.8 | 3273.2 | 5000 | ✅ PASS |
+| lookupInstance_50 | 50 | 0.1 | 0.0 | 446.4 | 2000 | ✅ PASS |
+| registerInstance_100 | 100 | 2.0 | 0.8 | 3239.7 | 5000 | ✅ PASS |
+| lookupInstance_100 | 100 | 0.1 | 0.0 | 36.8 | 2000 | ✅ PASS |
+| registerInstance_200 | 200 | 1.9 | 0.8 | 3083.9 | 10000 | ✅ PASS |
+| lookupInstance_200 | 200 | 0.1 | 0.0 | 12.0 | 5000 | ✅ PASS |
+| registerInstance_500 | 500 | 1.8 | 0.8 | 1154.4 | 10000 | ✅ PASS |
+| lookupInstance_500 | 500 | 0.5 | 0.0 | 6698.5 | 5000 | ✅ PASS |
+| registerInstance_1000 | 1000 | 3.3 | 0.8 | 7510.2 | 10000 | ✅ PASS |
+| lookupInstance_1000 | 1000 | 0.2 | 0.0 | 138.5 | 5000 | ✅ PASS |
+| registerInstance_2000 | 2000 | 3.1 | 1.1 | 370.3 | 20000 | ✅ PASS |
+| lookupInstance_2000 | 2000 | 0.2 | 0.1 | 8.5 | 10000 | ✅ PASS |
+| registerInstance_5000 | 5000 | 2.1 | 1.1 | 379.8 | 20000 | ✅ PASS |
+| lookupInstance_5000 | 5000 | 0.2 | 0.1 | 4.3 | 10000 | ✅ PASS |
+| registerInstance_10000 | 10000 | 2.3 | 0.9 | 1541.2 | 20000 | ✅ PASS |
+| lookupInstance_10000 | 10000 | 0.4 | 0.1 | 35.2 | 10000 | ✅ PASS |
+| registerInstance_20000 | 20000 | 1.2 | 0.9 | 22.7 | 50000 | ✅ PASS |
+| lookupInstance_20000 | 20000 | 0.3 | 0.0 | 29.1 | 25000 | ✅ PASS |
+| registerInstance_50000 | 50000 | 1.4 | 0.9 | 37.1 | 50000 | ✅ PASS |
+| lookupInstance_50000 | 50000 | 0.2 | 0.1 | 2.3 | 25000 | ✅ PASS |
+| registerInstance_100000 | 100000 | 1.5 | 1.0 | 44.6 | 50000 | ✅ PASS |
+| lookupInstance_100000 | 100000 | 0.3 | 0.1 | 2.4 | 25000 | ✅ PASS |
 
 ## Scaling Performance Visualization
 
@@ -73,7 +73,7 @@ consistent performance, while wider bands show more variability.*
 **Iterations:** 20000
 **Average Time:** 0.2 µs
 **Min Time:** 0.0 µs
-**Max Time:** 865.0 µs
+**Max Time:** 558.5 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -83,7 +83,7 @@ consistent performance, while wider bands show more variability.*
 **Iterations:** 20000
 **Average Time:** 0.1 µs
 **Min Time:** 0.0 µs
-**Max Time:** 395.9 µs
+**Max Time:** 321.1 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -93,7 +93,7 @@ consistent performance, while wider bands show more variability.*
 **Iterations:** 20000
 **Average Time:** 1.0 µs
 **Min Time:** 0.2 µs
-**Max Time:** 3362.4 µs
+**Max Time:** 3170.4 µs
 **Threshold:** 10000 µs
 **Status:** ✅ PASS
 
@@ -101,9 +101,9 @@ consistent performance, while wider bands show more variability.*
 
 **Description:** Time to register an instance in registry
 **Iterations:** 20000
-**Average Time:** 6.0 µs
-**Min Time:** 0.7 µs
-**Max Time:** 14657.3 µs
+**Average Time:** 6.9 µs
+**Min Time:** 0.8 µs
+**Max Time:** 40163.7 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -111,9 +111,9 @@ consistent performance, while wider bands show more variability.*
 
 **Description:** Time to lookup an existing instance from registry
 **Iterations:** 20000
-**Average Time:** 0.3 µs
-**Min Time:** 0.0 µs
-**Max Time:** 685.2 µs
+**Average Time:** 0.5 µs
+**Min Time:** 0.1 µs
+**Max Time:** 2411.6 µs
 **Threshold:** 2000 µs
 **Status:** ✅ PASS
 
@@ -123,7 +123,7 @@ consistent performance, while wider bands show more variability.*
 **Iterations:** 10000
 **Average Time:** 6.4 µs
 **Min Time:** 2.1 µs
-**Max Time:** 7064.8 µs
+**Max Time:** 8119.5 µs
 **Threshold:** 25000 µs
 **Status:** ✅ PASS
 
@@ -134,9 +134,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 10 existing items in tree
 **Tree Size:** 10 items
 **Iterations:** 10000
-**Average Time:** 2.9 µs
-**Min Time:** 0.8 µs
-**Max Time:** 8043.9 µs
+**Average Time:** 2.5 µs
+**Min Time:** 0.9 µs
+**Max Time:** 8034.8 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -147,7 +147,7 @@ consistent performance, while wider bands show more variability.*
 **Iterations:** 20000
 **Average Time:** 0.2 µs
 **Min Time:** 0.0 µs
-**Max Time:** 57.5 µs
+**Max Time:** 87.8 µs
 **Threshold:** 2000 µs
 **Status:** ✅ PASS
 
@@ -156,9 +156,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 20 existing items in tree
 **Tree Size:** 20 items
 **Iterations:** 10000
-**Average Time:** 4.0 µs
+**Average Time:** 2.1 µs
 **Min Time:** 0.8 µs
-**Max Time:** 5138.1 µs
+**Max Time:** 6723.3 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -167,9 +167,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to lookup instance with 20 items in tree
 **Tree Size:** 20 items
 **Iterations:** 20000
-**Average Time:** 0.4 µs
+**Average Time:** 0.1 µs
 **Min Time:** 0.0 µs
-**Max Time:** 2896.7 µs
+**Max Time:** 31.5 µs
 **Threshold:** 2000 µs
 **Status:** ✅ PASS
 
@@ -178,9 +178,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 50 existing items in tree
 **Tree Size:** 50 items
 **Iterations:** 10000
-**Average Time:** 1.8 µs
-**Min Time:** 0.7 µs
-**Max Time:** 3538.8 µs
+**Average Time:** 2.4 µs
+**Min Time:** 0.8 µs
+**Max Time:** 3273.2 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -189,9 +189,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to lookup instance with 50 items in tree
 **Tree Size:** 50 items
 **Iterations:** 20000
-**Average Time:** 0.2 µs
+**Average Time:** 0.1 µs
 **Min Time:** 0.0 µs
-**Max Time:** 17.3 µs
+**Max Time:** 446.4 µs
 **Threshold:** 2000 µs
 **Status:** ✅ PASS
 
@@ -200,9 +200,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 100 existing items in tree
 **Tree Size:** 100 items
 **Iterations:** 10000
-**Average Time:** 3.0 µs
+**Average Time:** 2.0 µs
 **Min Time:** 0.8 µs
-**Max Time:** 3714.0 µs
+**Max Time:** 3239.7 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -211,9 +211,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to lookup instance with 100 items in tree
 **Tree Size:** 100 items
 **Iterations:** 20000
-**Average Time:** 0.3 µs
+**Average Time:** 0.1 µs
 **Min Time:** 0.0 µs
-**Max Time:** 2029.2 µs
+**Max Time:** 36.8 µs
 **Threshold:** 2000 µs
 **Status:** ✅ PASS
 
@@ -222,9 +222,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 200 existing items in tree
 **Tree Size:** 200 items
 **Iterations:** 10000
-**Average Time:** 1.6 µs
+**Average Time:** 1.9 µs
 **Min Time:** 0.8 µs
-**Max Time:** 2891.4 µs
+**Max Time:** 3083.9 µs
 **Threshold:** 10000 µs
 **Status:** ✅ PASS
 
@@ -233,9 +233,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to lookup instance with 200 items in tree
 **Tree Size:** 200 items
 **Iterations:** 20000
-**Average Time:** 0.3 µs
+**Average Time:** 0.1 µs
 **Min Time:** 0.0 µs
-**Max Time:** 2867.3 µs
+**Max Time:** 12.0 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -244,9 +244,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 500 existing items in tree
 **Tree Size:** 500 items
 **Iterations:** 10000
-**Average Time:** 1.5 µs
-**Min Time:** 0.7 µs
-**Max Time:** 3092.2 µs
+**Average Time:** 1.8 µs
+**Min Time:** 0.8 µs
+**Max Time:** 1154.4 µs
 **Threshold:** 10000 µs
 **Status:** ✅ PASS
 
@@ -255,9 +255,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to lookup instance with 500 items in tree
 **Tree Size:** 500 items
 **Iterations:** 20000
-**Average Time:** 0.3 µs
+**Average Time:** 0.5 µs
 **Min Time:** 0.0 µs
-**Max Time:** 3657.6 µs
+**Max Time:** 6698.5 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -266,9 +266,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 1000 existing items in tree
 **Tree Size:** 1000 items
 **Iterations:** 10000
-**Average Time:** 1.6 µs
-**Min Time:** 0.7 µs
-**Max Time:** 4527.8 µs
+**Average Time:** 3.3 µs
+**Min Time:** 0.8 µs
+**Max Time:** 7510.2 µs
 **Threshold:** 10000 µs
 **Status:** ✅ PASS
 
@@ -279,7 +279,7 @@ consistent performance, while wider bands show more variability.*
 **Iterations:** 20000
 **Average Time:** 0.2 µs
 **Min Time:** 0.0 µs
-**Max Time:** 2594.0 µs
+**Max Time:** 138.5 µs
 **Threshold:** 5000 µs
 **Status:** ✅ PASS
 
@@ -288,9 +288,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 2000 existing items in tree
 **Tree Size:** 2000 items
 **Iterations:** 2500
-**Average Time:** 1.1 µs
-**Min Time:** 0.8 µs
-**Max Time:** 63.3 µs
+**Average Time:** 3.1 µs
+**Min Time:** 1.1 µs
+**Max Time:** 370.3 µs
 **Threshold:** 20000 µs
 **Status:** ✅ PASS
 
@@ -300,8 +300,8 @@ consistent performance, while wider bands show more variability.*
 **Tree Size:** 2000 items
 **Iterations:** 5000
 **Average Time:** 0.2 µs
-**Min Time:** 0.0 µs
-**Max Time:** 8.2 µs
+**Min Time:** 0.1 µs
+**Max Time:** 8.5 µs
 **Threshold:** 10000 µs
 **Status:** ✅ PASS
 
@@ -310,9 +310,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 5000 existing items in tree
 **Tree Size:** 5000 items
 **Iterations:** 2500
-**Average Time:** 1.7 µs
+**Average Time:** 2.1 µs
 **Min Time:** 1.1 µs
-**Max Time:** 291.6 µs
+**Max Time:** 379.8 µs
 **Threshold:** 20000 µs
 **Status:** ✅ PASS
 
@@ -321,9 +321,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to lookup instance with 5000 items in tree
 **Tree Size:** 5000 items
 **Iterations:** 5000
-**Average Time:** 1.8 µs
-**Min Time:** 0.0 µs
-**Max Time:** 7794.5 µs
+**Average Time:** 0.2 µs
+**Min Time:** 0.1 µs
+**Max Time:** 4.3 µs
 **Threshold:** 10000 µs
 **Status:** ✅ PASS
 
@@ -332,9 +332,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 10000 existing items in tree
 **Tree Size:** 10000 items
 **Iterations:** 2500
-**Average Time:** 4.7 µs
-**Min Time:** 1.1 µs
-**Max Time:** 4041.7 µs
+**Average Time:** 2.3 µs
+**Min Time:** 0.9 µs
+**Max Time:** 1541.2 µs
 **Threshold:** 20000 µs
 **Status:** ✅ PASS
 
@@ -343,9 +343,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to lookup instance with 10000 items in tree
 **Tree Size:** 10000 items
 **Iterations:** 5000
-**Average Time:** 0.3 µs
-**Min Time:** 0.0 µs
-**Max Time:** 46.0 µs
+**Average Time:** 0.4 µs
+**Min Time:** 0.1 µs
+**Max Time:** 35.2 µs
 **Threshold:** 10000 µs
 **Status:** ✅ PASS
 
@@ -356,7 +356,7 @@ consistent performance, while wider bands show more variability.*
 **Iterations:** 500
 **Average Time:** 1.2 µs
 **Min Time:** 0.9 µs
-**Max Time:** 5.8 µs
+**Max Time:** 22.7 µs
 **Threshold:** 50000 µs
 **Status:** ✅ PASS
 
@@ -366,8 +366,8 @@ consistent performance, while wider bands show more variability.*
 **Tree Size:** 20000 items
 **Iterations:** 1250
 **Average Time:** 0.3 µs
-**Min Time:** 0.1 µs
-**Max Time:** 4.8 µs
+**Min Time:** 0.0 µs
+**Max Time:** 29.1 µs
 **Threshold:** 25000 µs
 **Status:** ✅ PASS
 
@@ -376,9 +376,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 50000 existing items in tree
 **Tree Size:** 50000 items
 **Iterations:** 500
-**Average Time:** 1.2 µs
+**Average Time:** 1.4 µs
 **Min Time:** 0.9 µs
-**Max Time:** 18.1 µs
+**Max Time:** 37.1 µs
 **Threshold:** 50000 µs
 **Status:** ✅ PASS
 
@@ -389,7 +389,7 @@ consistent performance, while wider bands show more variability.*
 **Iterations:** 1250
 **Average Time:** 0.2 µs
 **Min Time:** 0.1 µs
-**Max Time:** 3.4 µs
+**Max Time:** 2.3 µs
 **Threshold:** 25000 µs
 **Status:** ✅ PASS
 
@@ -398,9 +398,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to register instance with 100000 existing items in tree
 **Tree Size:** 100000 items
 **Iterations:** 500
-**Average Time:** 1.3 µs
-**Min Time:** 0.9 µs
-**Max Time:** 31.5 µs
+**Average Time:** 1.5 µs
+**Min Time:** 1.0 µs
+**Max Time:** 44.6 µs
 **Threshold:** 50000 µs
 **Status:** ✅ PASS
 
@@ -409,9 +409,9 @@ consistent performance, while wider bands show more variability.*
 **Description:** Time to lookup instance with 100000 items in tree
 **Tree Size:** 100000 items
 **Iterations:** 1250
-**Average Time:** 0.2 µs
+**Average Time:** 0.3 µs
 **Min Time:** 0.1 µs
-**Max Time:** 5.2 µs
+**Max Time:** 2.4 µs
 **Threshold:** 25000 µs
 **Status:** ✅ PASS
 

package/docs/tsconfig.node.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "strict": true
+  },
+  "include": [
+    "vite.config.ts"
+  ]
+}

package/docs/vitest.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'vitest/config'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    globals: true,
+    environment: 'jsdom',
+    setupFiles: ['./src/test/setup.ts'],
+    coverage: {
+      reporter: ['text', 'json', 'html']
+    }
+  }
+})

package/examples/README.md

@@ -115,6 +115,35 @@ const email = hub.get('communication', ['email'], { scopes: ['prod'] });
 - **Microservices**: Each key path represents a different service
 - **Multi-Region**: Different implementations across regions
 
+## Using the Registry
+
+The registry provides a centralized way to manage instances in your application. Here are the main operations you can perform:
+
+### Getting All Coordinates
+
+You can retrieve a list of all coordinates currently registered in the registry:
+
+```typescript
+import { createRegistry } from '@fjell/registry';
+
+const registry = createRegistry('myRegistry');
+
+// Register some instances...
+registry.createInstance(['service'], ['production'], factory1);
+registry.createInstance(['cache', 'redis'], ['development'], factory2);
+
+// Get all coordinates
+const coordinates = registry.getCoordinates();
+console.log(`Found ${coordinates.length} registered coordinates:`);
+coordinates.forEach(coord => {
+  console.log(`- ${coord.toString()}`);
+});
+```
+
+This is useful for debugging, monitoring, or implementing discovery mechanisms in your application.
+
+### Basic Instance Management
+
 ## Running Examples
 
 ```bash
@@ -127,6 +156,12 @@ npx tsx examples/multi-level-keys.ts
 # Run the RegistryHub with service types example
 npx tsx examples/registry-hub-types.ts
 
+# Run the coordinate discovery and introspection example
+npx tsx examples/coordinates-example.ts
+
+# Run the RegistryHub cross-registry coordinate discovery example
+npx tsx examples/registry-hub-coordinates-example.ts
+
 # Or in Node.js
 node -r esbuild-register examples/simple-example.ts
 node -r esbuild-register examples/registry-hub-types.ts