@fjell/registry 4.4.11 → 4.4.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. package/API.md +62 -0
  2. package/GETTING_STARTED.md +69 -0
  3. package/MIGRATION_SUMMARY.md +200 -0
  4. package/docs/docs.config.ts +95 -0
  5. package/docs/package.json +7 -8
  6. package/docs/public/GETTING_STARTED.md +69 -0
  7. package/docs/public/api.md +62 -0
  8. package/docs/public/examples-README.md +19 -0
  9. package/docs/public/package.json +1 -1
  10. package/docs/src/main.tsx +4 -2
  11. package/docs/src/types.d.ts +44 -0
  12. package/package.json +14 -8
  13. package/docs/memory-data/scaling-10-instances.json +0 -526
  14. package/docs/memory-data/scaling-100-instances.json +0 -526
  15. package/docs/memory-data/scaling-1000-instances.json +0 -276
  16. package/docs/memory-data/scaling-10000-instances.json +0 -126
  17. package/docs/memory-data/scaling-20-instances.json +0 -526
  18. package/docs/memory-data/scaling-200-instances.json +0 -526
  19. package/docs/memory-data/scaling-2000-instances.json +0 -276
  20. package/docs/memory-data/scaling-50-instances.json +0 -526
  21. package/docs/memory-data/scaling-500-instances.json +0 -276
  22. package/docs/memory-data/scaling-5000-instances.json +0 -126
  23. package/docs/memory-overhead.svg +0 -120
  24. package/docs/memory.md +0 -430
  25. package/docs/src/App.css +0 -1237
  26. package/docs/src/App.test.tsx +0 -50
  27. package/docs/src/App.tsx +0 -606
  28. package/docs/timing-range.svg +0 -172
  29. package/docs/timing.md +0 -483
  30. package/docs/tsconfig.node.json +0 -13
package/docs/memory-data/scaling-500-instances.json DELETED
@@ -1,276 +0,0 @@
1
- {
2
- "instanceCount": 500,
3
- "iterations": 25,
4
- "timestamp": "2025-07-21T06:44:47.656Z",
5
- "measurements": [
6
- {
7
- "instanceCount": 500,
8
- "memoryPerInstance": 1801.696,
9
- "time": 2.5225840000000517
10
- },
11
- {
12
- "instanceCount": 500,
13
- "memoryPerInstance": 1725.44,
14
- "time": 1.160333000000037
15
- },
16
- {
17
- "instanceCount": 500,
18
- "memoryPerInstance": 1725.52,
19
- "time": 0.48716699999999946
20
- },
21
- {
22
- "instanceCount": 500,
23
- "memoryPerInstance": 1766.752,
24
- "time": 7.895083
25
- },
26
- {
27
- "instanceCount": 500,
28
- "memoryPerInstance": 1693.712,
29
- "time": 0.8004999999999427
30
- },
31
- {
32
- "instanceCount": 500,
33
- "memoryPerInstance": 4405.392,
34
- "time": 1.0691659999999956
35
- },
36
- {
37
- "instanceCount": 500,
38
- "memoryPerInstance": 4405.232,
39
- "time": 1.158584000000019
40
- },
41
- {
42
- "instanceCount": 500,
43
- "memoryPerInstance": 1693.888,
44
- "time": 0.42433299999993324
45
- },
46
- {
47
- "instanceCount": 500,
48
- "memoryPerInstance": 1693.744,
49
- "time": 0.4206249999999727
50
- },
51
- {
52
- "instanceCount": 500,
53
- "memoryPerInstance": 1693.568,
54
- "time": 0.4637920000000122
55
- },
56
- {
57
- "instanceCount": 500,
58
- "memoryPerInstance": 1693.6,
59
- "time": 0.445459000000028
60
- },
61
- {
62
- "instanceCount": 500,
63
- "memoryPerInstance": 1738.32,
64
- "time": 0.43258400000001984
65
- },
66
- {
67
- "instanceCount": 500,
68
- "memoryPerInstance": 7797.68,
69
- "time": 0.7873339999999871
70
- },
71
- {
72
- "instanceCount": 500,
73
- "memoryPerInstance": 1693.584,
74
- "time": 1.1610419999999522
75
- },
76
- {
77
- "instanceCount": 500,
78
- "memoryPerInstance": 1693.792,
79
- "time": 0.4177919999999631
80
- },
81
- {
82
- "instanceCount": 500,
83
- "memoryPerInstance": 1693.76,
84
- "time": 0.40095800000005966
85
- },
86
- {
87
- "instanceCount": 500,
88
- "memoryPerInstance": 1693.648,
89
- "time": 0.40449999999998454
90
- },
91
- {
92
- "instanceCount": 500,
93
- "memoryPerInstance": 1693.888,
94
- "time": 0.4079580000000078
95
- },
96
- {
97
- "instanceCount": 500,
98
- "memoryPerInstance": 1693.952,
99
- "time": 0.40079100000002654
100
- },
101
- {
102
- "instanceCount": 500,
103
- "memoryPerInstance": 200,
104
- "time": 15.637583000000063
105
- },
106
- {
107
- "instanceCount": 500,
108
- "memoryPerInstance": 1693.648,
109
- "time": 0.9398330000000215
110
- },
111
- {
112
- "instanceCount": 500,
113
- "memoryPerInstance": 1693.888,
114
- "time": 0.5213340000000244
115
- },
116
- {
117
- "instanceCount": 500,
118
- "memoryPerInstance": 200,
119
- "time": 9.436874999999986
120
- },
121
- {
122
- "instanceCount": 500,
123
- "memoryPerInstance": 1693.744,
124
- "time": 0.5413750000000164
125
- },
126
- {
127
- "instanceCount": 500,
128
- "memoryPerInstance": 1694,
129
- "time": 0.45125000000007276
130
- }
131
- ],
132
- "stats": {
133
- "instanceCount": 500,
134
- "iterations": 25,
135
- "memoryPerInstance": {
136
- "min": 200,
137
- "max": 7797.68,
138
- "average": 2046.8979199999999,
139
- "stdDev": 1460.5317138631924
140
- },
141
- "time": {
142
- "min": 0.40079100000002654,
143
- "max": 15.637583000000063,
144
- "average": 1.951553400000007,
145
- "stdDev": 3.5619300975591273
146
- },
147
- "status": "PASS",
148
- "measurements": [
149
- {
150
- "instanceCount": 500,
151
- "memoryPerInstance": 1801.696,
152
- "time": 2.5225840000000517
153
- },
154
- {
155
- "instanceCount": 500,
156
- "memoryPerInstance": 1725.44,
157
- "time": 1.160333000000037
158
- },
159
- {
160
- "instanceCount": 500,
161
- "memoryPerInstance": 1725.52,
162
- "time": 0.48716699999999946
163
- },
164
- {
165
- "instanceCount": 500,
166
- "memoryPerInstance": 1766.752,
167
- "time": 7.895083
168
- },
169
- {
170
- "instanceCount": 500,
171
- "memoryPerInstance": 1693.712,
172
- "time": 0.8004999999999427
173
- },
174
- {
175
- "instanceCount": 500,
176
- "memoryPerInstance": 4405.392,
177
- "time": 1.0691659999999956
178
- },
179
- {
180
- "instanceCount": 500,
181
- "memoryPerInstance": 4405.232,
182
- "time": 1.158584000000019
183
- },
184
- {
185
- "instanceCount": 500,
186
- "memoryPerInstance": 1693.888,
187
- "time": 0.42433299999993324
188
- },
189
- {
190
- "instanceCount": 500,
191
- "memoryPerInstance": 1693.744,
192
- "time": 0.4206249999999727
193
- },
194
- {
195
- "instanceCount": 500,
196
- "memoryPerInstance": 1693.568,
197
- "time": 0.4637920000000122
198
- },
199
- {
200
- "instanceCount": 500,
201
- "memoryPerInstance": 1693.6,
202
- "time": 0.445459000000028
203
- },
204
- {
205
- "instanceCount": 500,
206
- "memoryPerInstance": 1738.32,
207
- "time": 0.43258400000001984
208
- },
209
- {
210
- "instanceCount": 500,
211
- "memoryPerInstance": 7797.68,
212
- "time": 0.7873339999999871
213
- },
214
- {
215
- "instanceCount": 500,
216
- "memoryPerInstance": 1693.584,
217
- "time": 1.1610419999999522
218
- },
219
- {
220
- "instanceCount": 500,
221
- "memoryPerInstance": 1693.792,
222
- "time": 0.4177919999999631
223
- },
224
- {
225
- "instanceCount": 500,
226
- "memoryPerInstance": 1693.76,
227
- "time": 0.40095800000005966
228
- },
229
- {
230
- "instanceCount": 500,
231
- "memoryPerInstance": 1693.648,
232
- "time": 0.40449999999998454
233
- },
234
- {
235
- "instanceCount": 500,
236
- "memoryPerInstance": 1693.888,
237
- "time": 0.4079580000000078
238
- },
239
- {
240
- "instanceCount": 500,
241
- "memoryPerInstance": 1693.952,
242
- "time": 0.40079100000002654
243
- },
244
- {
245
- "instanceCount": 500,
246
- "memoryPerInstance": 200,
247
- "time": 15.637583000000063
248
- },
249
- {
250
- "instanceCount": 500,
251
- "memoryPerInstance": 1693.648,
252
- "time": 0.9398330000000215
253
- },
254
- {
255
- "instanceCount": 500,
256
- "memoryPerInstance": 1693.888,
257
- "time": 0.5213340000000244
258
- },
259
- {
260
- "instanceCount": 500,
261
- "memoryPerInstance": 200,
262
- "time": 9.436874999999986
263
- },
264
- {
265
- "instanceCount": 500,
266
- "memoryPerInstance": 1693.744,
267
- "time": 0.5413750000000164
268
- },
269
- {
270
- "instanceCount": 500,
271
- "memoryPerInstance": 1694,
272
- "time": 0.45125000000007276
273
- }
274
- ]
275
- }
276
- }
package/docs/memory-data/scaling-5000-instances.json DELETED
@@ -1,126 +0,0 @@
1
- {
2
- "instanceCount": 5000,
3
- "iterations": 10,
4
- "timestamp": "2025-07-21T06:44:48.140Z",
5
- "measurements": [
6
- {
7
- "instanceCount": 5000,
8
- "memoryPerInstance": 200,
9
- "time": 55.95570799999996
10
- },
11
- {
12
- "instanceCount": 5000,
13
- "memoryPerInstance": 4441.5536,
14
- "time": 15.330249999999978
15
- },
16
- {
17
- "instanceCount": 5000,
18
- "memoryPerInstance": 1041.8464,
19
- "time": 12.371832999999924
20
- },
21
- {
22
- "instanceCount": 5000,
23
- "memoryPerInstance": 1553.8256,
24
- "time": 10.560457999999926
25
- },
26
- {
27
- "instanceCount": 5000,
28
- "memoryPerInstance": 4772.3696,
29
- "time": 7.97808299999997
30
- },
31
- {
32
- "instanceCount": 5000,
33
- "memoryPerInstance": 898.6544,
34
- "time": 15.381750000000011
35
- },
36
- {
37
- "instanceCount": 5000,
38
- "memoryPerInstance": 1677.4848,
39
- "time": 5.239292000000205
40
- },
41
- {
42
- "instanceCount": 5000,
43
- "memoryPerInstance": 935.384,
44
- "time": 12.319666000000097
45
- },
46
- {
47
- "instanceCount": 5000,
48
- "memoryPerInstance": 1671.1392,
49
- "time": 4.732833000000028
50
- },
51
- {
52
- "instanceCount": 5000,
53
- "memoryPerInstance": 1259,
54
- "time": 9.21183300000007
55
- }
56
- ],
57
- "stats": {
58
- "instanceCount": 5000,
59
- "iterations": 10,
60
- "memoryPerInstance": {
61
- "min": 200,
62
- "max": 4772.3696,
63
- "average": 1845.1257600000001,
64
- "stdDev": 1444.718056682089
65
- },
66
- "time": {
67
- "min": 4.732833000000028,
68
- "max": 55.95570799999996,
69
- "average": 14.908170600000016,
70
- "stdDev": 14.12387273116815
71
- },
72
- "status": "PASS",
73
- "measurements": [
74
- {
75
- "instanceCount": 5000,
76
- "memoryPerInstance": 200,
77
- "time": 55.95570799999996
78
- },
79
- {
80
- "instanceCount": 5000,
81
- "memoryPerInstance": 4441.5536,
82
- "time": 15.330249999999978
83
- },
84
- {
85
- "instanceCount": 5000,
86
- "memoryPerInstance": 1041.8464,
87
- "time": 12.371832999999924
88
- },
89
- {
90
- "instanceCount": 5000,
91
- "memoryPerInstance": 1553.8256,
92
- "time": 10.560457999999926
93
- },
94
- {
95
- "instanceCount": 5000,
96
- "memoryPerInstance": 4772.3696,
97
- "time": 7.97808299999997
98
- },
99
- {
100
- "instanceCount": 5000,
101
- "memoryPerInstance": 898.6544,
102
- "time": 15.381750000000011
103
- },
104
- {
105
- "instanceCount": 5000,
106
- "memoryPerInstance": 1677.4848,
107
- "time": 5.239292000000205
108
- },
109
- {
110
- "instanceCount": 5000,
111
- "memoryPerInstance": 935.384,
112
- "time": 12.319666000000097
113
- },
114
- {
115
- "instanceCount": 5000,
116
- "memoryPerInstance": 1671.1392,
117
- "time": 4.732833000000028
118
- },
119
- {
120
- "instanceCount": 5000,
121
- "memoryPerInstance": 1259,
122
- "time": 9.21183300000007
123
- }
124
- ]
125
- }
126
- }
package/docs/memory-overhead.svg DELETED
@@ -1,120 +0,0 @@
1
- <?xml version="1.0" encoding="UTF-8"?>
2
- <svg width="1200" height="800" xmlns="http://www.w3.org/2000/svg">
3
- <style>
4
- .axis { stroke: #333; stroke-width: 1; }
5
- .grid { stroke: #ddd; stroke-width: 0.5; }
6
- .label { font-family: Arial, sans-serif; font-size: 14px; fill: #333; }
7
- .title { font-family: Arial, sans-serif; font-size: 16px; font-weight: bold; fill: #333; }
8
- .subtitle { font-family: Arial, sans-serif; font-size: 12px; fill: #666; }
9
- .per-instance { stroke: #3498db; stroke-width: 3; fill: none; }
10
- .per-instance-dot { fill: #3498db; }
11
- .legend { font-family: Arial, sans-serif; font-size: 12px; fill: #333; }
12
- .axis-title { font-family: Arial, sans-serif; font-size: 16px; font-weight: bold; fill: #333; }
13
- .metadata-section { font-family: Arial, sans-serif; font-size: 14px; font-weight: bold; fill: #444; }
14
- .metadata-label { font-family: Arial, sans-serif; font-size: 10px; fill: #666; }
15
- .metadata-value { font-family: Arial, sans-serif; font-size: 10px; fill: #333; }
16
- </style>
17
-
18
- <!-- Background -->
19
- <rect width="1200" height="800" fill="white"/>
20
-
21
- <!-- Title -->
22
- <text x="600" y="25" text-anchor="middle" class="title">Memory Efficiency Per Instance</text>
23
- <text x="600" y="45" text-anchor="middle" class="subtitle">Average memory overhead per registry instance across different scale sizes</text>
24
-
25
- <!-- Plot area -->
26
- <g transform="translate(110,60)">
27
-
28
- <!-- Grid lines (Y-axis - memory in KB) -->
29
- <line x1="0" y1="377.79776837534143" x2="990" y2="377.79776837534143" class="grid"/>
30
- <text x="-10" y="381.79776837534143" text-anchor="end" class="label">2KB</text>
31
- <line x1="0" y1="162.708642531701" x2="990" y2="162.708642531701" class="grid"/>
32
- <text x="-10" y="166.708642531701" text-anchor="end" class="label">5KB</text>
33
- <line x1="0" y1="0" x2="990" y2="0" class="grid"/>
34
- <text x="-10" y="4" text-anchor="end" class="label">10KB</text>
35
- <line x1="0" y1="0" x2="0" y2="460" class="grid"/>
36
- <text x="0" y="480" text-anchor="middle" class="label">10</text>
37
- <line x1="99.33989856911381" y1="0" x2="99.33989856911381" y2="460" class="grid"/>
38
- <text x="99.33989856911381" y="480" text-anchor="middle" class="label">20</text>
39
- <line x1="230.6601014308862" y1="0" x2="230.6601014308862" y2="460" class="grid"/>
40
- <text x="230.6601014308862" y="480" text-anchor="middle" class="label">50</text>
41
- <line x1="330" y1="0" x2="330" y2="460" class="grid"/>
42
- <text x="330" y="480" text-anchor="middle" class="label">100</text>
43
- <line x1="429.3398985691138" y1="0" x2="429.3398985691138" y2="460" class="grid"/>
44
- <text x="429.3398985691138" y="480" text-anchor="middle" class="label">200</text>
45
- <line x1="560.6601014308862" y1="0" x2="560.6601014308862" y2="460" class="grid"/>
46
- <text x="560.6601014308862" y="480" text-anchor="middle" class="label">500</text>
47
- <line x1="660" y1="0" x2="660" y2="460" class="grid"/>
48
- <text x="660" y="480" text-anchor="middle" class="label">1k</text>
49
- <line x1="759.3398985691139" y1="0" x2="759.3398985691139" y2="460" class="grid"/>
50
- <text x="759.3398985691139" y="480" text-anchor="middle" class="label">2k</text>
51
- <line x1="890.6601014308862" y1="0" x2="890.6601014308862" y2="460" class="grid"/>
52
- <text x="890.6601014308862" y="480" text-anchor="middle" class="label">5k</text>
53
- <line x1="990" y1="0" x2="990" y2="460" class="grid"/>
54
- <text x="990" y="480" text-anchor="middle" class="label">10k</text>
55
- <!-- Y-axis -->
56
- <line x1="0" y1="0" x2="0" y2="460" class="axis"/>
57
-
58
- <!-- X-axis -->
59
- <line x1="0" y1="460" x2="990" y2="460" class="axis"/>
60
-
61
- <!-- Axis labels -->
62
- <text x="495" y="510" text-anchor="middle" class="axis-title">Instance Count - Log Scale</text>
63
- <text transform="rotate(-90,-70,230)" x="-70" y="230" text-anchor="middle" class="axis-title">Memory Usage (KB)</text>
64
- <path d="M 0 304.9579731338267 L 99.33989856911381 306.7071557553624 L 230.6601014308862 337.98595780742846 L 330 358.8317366954122 L 429.3398985691138 346.7041163638394 L 560.6601014308862 377.92412127359637 L 660 374.76521167374966 L 759.3398985691139 395.4321432144372 L 890.6601014308862 402.2848600999703 L 990 407.6195166880606" class="per-instance"/>
65
- <circle cx="0" cy="304.9579731338267" r="4" class="per-instance-dot"/>
66
- <circle cx="99.33989856911381" cy="306.7071557553624" r="4" class="per-instance-dot"/>
67
- <circle cx="230.6601014308862" cy="337.98595780742846" r="4" class="per-instance-dot"/>
68
- <circle cx="330" cy="358.8317366954122" r="4" class="per-instance-dot"/>
69
- <circle cx="429.3398985691138" cy="346.7041163638394" r="4" class="per-instance-dot"/>
70
- <circle cx="560.6601014308862" cy="377.92412127359637" r="4" class="per-instance-dot"/>
71
- <circle cx="660" cy="374.76521167374966" r="4" class="per-instance-dot"/>
72
- <circle cx="759.3398985691139" cy="395.4321432144372" r="4" class="per-instance-dot"/>
73
- <circle cx="890.6601014308862" cy="402.2848600999703" r="4" class="per-instance-dot"/>
74
- <circle cx="990" cy="407.6195166880606" r="4" class="per-instance-dot"/>
75
- <!-- Legend -->
76
- <g transform="translate(20, 20)">
77
- <rect x="0" y="0" width="190" height="60" fill="white" stroke="#ccc" stroke-width="1"/>
78
-
79
- <!-- Memory Per Instance Legend -->
80
- <text x="10" y="20" class="legend" font-weight="bold">Memory Per Instance</text>
81
- <line x1="10" y1="30" x2="40" y2="30" class="per-instance"/>
82
- <circle cx="25" cy="30" r="3" class="per-instance-dot"/>
83
- <text x="45" y="34" class="legend">Average Performance</text>
84
- </g>
85
-
86
- </g>
87
-
88
- <!-- Test Metadata Section - match timing chart layout exactly -->
89
- <g transform="translate(50, 620)">
90
- <!-- Left Column: System Information -->
91
- <g transform="translate(20, 20)">
92
- <text x="0" y="0" class="metadata-section">System Information</text>
93
-
94
- <text x="0" y="25" class="metadata-label">Test Date:</text>
95
- <text x="150" y="25" class="metadata-value">2025-07-21</text>
96
-
97
- <text x="0" y="45" class="metadata-label">Package Version:</text>
98
- <text x="150" y="45" class="metadata-value">@fjell/registry v4.4.10</text>
99
-
100
- <text x="0" y="65" class="metadata-label">Node.js Version:</text>
101
- <text x="150" y="65" class="metadata-value">v22.0.0 (darwin arm64)</text>
102
-
103
- <text x="0" y="85" class="metadata-label">Platform:</text>
104
- <text x="150" y="85" class="metadata-value">darwin arm64</text>
105
-
106
- <text x="0" y="105" class="metadata-label">Compiler:</text>
107
- <text x="150" y="105" class="metadata-value">TypeScript + Vite</text>
108
- </g>
109
-
110
- <!-- Right Column: Test Notes -->
111
- <g transform="translate(400, 20)">
112
- <text x="0" y="0" class="metadata-section">Test Notes</text>
113
- <text x="0" y="25" class="metadata-label">• Memory measurements use Node.js process.memoryUsage() with heap precision</text>
114
- <text x="0" y="42" class="metadata-label">• Each test includes garbage collection to minimize measurement variance</text>
115
- <text x="0" y="59" class="metadata-label">• Logging is mocked during memory tests to eliminate overhead</text>
116
- <text x="0" y="76" class="metadata-label">• Tests verify memory efficiency and consistency across instance counts</text>
117
- <text x="0" y="93" class="metadata-label">• Statistical analysis ensures reliable performance measurements</text>
118
- </g>
119
- </g>
120
- </svg>