@fjell/registry 4.4.52 → 4.4.54

package/docs/public/operations/get.md

@@ -1,389 +0,0 @@
-# `get` Operation
-
-Retrieve a single item by its key with automatic error handling and retry logic.
-
-## Syntax
-
-### Primary Items (PItemApi)
-```typescript
-async get(key: PriKey<S>): Promise<V | null>
-```
-
-### Contained Items (CItemApi)
-```typescript
-async get(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>): Promise<V | null>
-```
-
-## Parameters
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `key` | `PriKey<S>` or `ComKey<S, ...>` | Yes | Key identifying the item to retrieve |
-
-### Key Types
-
-```typescript
-// Primary Key (for PItemApi)
-interface PriKey<S> {
-  keyType: S;
-  pk: string;
-}
-
-// Composite Key (for CItemApi)
-interface ComKey<S, L1, L2, L3, L4, L5> {
-  keyType: S;
-  pk: string;
-  l1?: LocKey<L1>;
-  l2?: LocKey<L2>;
-  // ... up to l5
-}
-```
-
-## Examples
-
-### Basic Usage
-
-```typescript
-// Get a user by ID
-const userKey = { keyType: 'user', pk: 'user-123' };
-const user = await userApi.get(userKey);
-
-if (user) {
-  console.log('Found user:', user.name);
-} else {
-  console.log('User not found');
-}
-```
-
-### Contained Items
-
-```typescript
-// Get a task with composite key
-const taskKey = {
-  keyType: 'task',
-  pk: 'task-456',
-  l1: { lkType: 'user', lk: 'user-123' }
-};
-
-const task = await taskApi.get(taskKey);
-```
-
-### Error Handling
-
-```typescript
-try {
-  const user = await userApi.get(userKey);
-
-  if (!user) {
-    console.log('User not found - this is normal');
-    return;
-  }
-
-  console.log('User found:', user.name);
-
-} catch (error) {
-  if (error.code === 'NETWORK_ERROR') {
-    console.error('Network issue - operation was automatically retried');
-  } else if (error.code === 'AUTHENTICATION_ERROR') {
-    console.error('Authentication failed - check credentials');
-  } else {
-    console.error('Unexpected error:', error.message);
-  }
-}
-```
-
-### Null Handling Patterns
-
-```typescript
-// Pattern 1: Explicit null check
-const user = await userApi.get(userKey);
-if (user === null) {
-  throw new Error('User not found');
-}
-// user is now typed as V (not null)
-
-// Pattern 2: Default fallback
-const user = await userApi.get(userKey) ?? createDefaultUser();
-
-// Pattern 3: Optional chaining
-const userName = (await userApi.get(userKey))?.name ?? 'Unknown';
-```
-
-## Return Value
-
-Returns `Promise<V | null>`:
-- **V**: The found item with all its properties
-- **null**: When item is not found (404 response)
-
-```typescript
-// Found item structure
-const user = await userApi.get(userKey);
-// {
-//   id: 'user-123',
-//   name: 'John Doe',
-//   email: 'john@example.com',
-//   active: true,
-//   createdAt: '2024-01-15T10:30:00Z',
-//   updatedAt: '2024-01-20T14:22:00Z',
-//   keyType: 'user'
-// }
-
-// Not found
-const missingUser = await userApi.get({ keyType: 'user', pk: 'nonexistent' });
-// null
-```
-
-## Performance Optimization
-
-### Caching Strategies
-
-```typescript
-// Simple memory cache
-const userCache = new Map<string, User>();
-
-async function getCachedUser(userKey: PriKey<'user'>): Promise<User | null> {
-  const cacheKey = `user:${userKey.pk}`;
-
-  // Check cache first
-  if (userCache.has(cacheKey)) {
-    return userCache.get(cacheKey)!;
-  }
-
-  // Fetch from API
-  const user = await userApi.get(userKey);
-
-  // Cache the result (including null)
-  if (user) {
-    userCache.set(cacheKey, user);
-  }
-
-  return user;
-}
-```
-
-### Batch Loading
-
-```typescript
-// Load multiple items efficiently
-async function getUsersBatch(userKeys: PriKey<'user'>[]): Promise<(User | null)[]> {
-  // Use Promise.all for parallel requests
-  const promises = userKeys.map(key =>
-    userApi.get(key).catch(error => {
-      console.error(`Failed to load user ${key.pk}:`, error.message);
-      return null;
-    })
-  );
-
-  return Promise.all(promises);
-}
-```
-
-## Advanced Patterns
-
-### Safe Get with Type Guards
-
-```typescript
-// Type-safe retrieval with validation
-async function getValidUser(userKey: PriKey<'user'>): Promise<User> {
-  const user = await userApi.get(userKey);
-
-  if (!user) {
-    throw new Error(`User ${userKey.pk} not found`);
-  }
-
-  if (!user.active) {
-    throw new Error(`User ${userKey.pk} is inactive`);
-  }
-
-  return user;
-}
-```
-
-### Retry with Custom Logic
-
-```typescript
-// Get with custom retry behavior
-async function getWithRetry<T>(
-  apiCall: () => Promise<T | null>,
-  maxAttempts: number = 3,
-  delay: number = 1000
-): Promise<T | null> {
-  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-    try {
-      return await apiCall();
-    } catch (error) {
-      if (attempt === maxAttempts) throw error;
-
-      console.log(`Attempt ${attempt} failed, retrying in ${delay}ms...`);
-      await new Promise(resolve => setTimeout(resolve, delay));
-      delay *= 2; // Exponential backoff
-    }
-  }
-  return null;
-}
-
-// Usage
-const user = await getWithRetry(() => userApi.get(userKey));
-```
-
-### Get with Fallback Chain
-
-```typescript
-// Try multiple sources for data
-async function getUserWithFallbacks(userId: string): Promise<User | null> {
-  const userKey = { keyType: 'user' as const, pk: userId };
-
-  // Try primary API
-  try {
-    const user = await userApi.get(userKey);
-    if (user) return user;
-  } catch (error) {
-    console.warn('Primary API failed:', error.message);
-  }
-
-  // Try backup API
-  try {
-    const user = await backupUserApi.get(userKey);
-    if (user) return user;
-  } catch (error) {
-    console.warn('Backup API failed:', error.message);
-  }
-
-  // Try cache
-  try {
-    const cachedUser = await getUserFromCache(userId);
-    if (cachedUser) return cachedUser;
-  } catch (error) {
-    console.warn('Cache failed:', error.message);
-  }
-
-  return null;
-}
-```
-
-## Common Use Cases
-
-### User Profile Loading
-
-```typescript
-// Load user with profile data
-async function loadUserProfile(userId: string) {
-  const userKey = { keyType: 'user' as const, pk: userId };
-  const user = await userApi.get(userKey);
-
-  if (!user) {
-    throw new Error('User not found');
-  }
-
-  // Load related data
-  const [profile, preferences, activity] = await Promise.all([
-    profileApi.get({ keyType: 'profile', pk: userId }),
-    preferencesApi.get({ keyType: 'preferences', pk: userId }),
-    activityApi.allFacet('recent-activity', { limit: 10 }, [userId])
-  ]);
-
-  return {
-    user,
-    profile,
-    preferences,
-    activity
-  };
-}
-```
-
-### Resource Validation
-
-```typescript
-// Validate resource exists before operation
-async function updateUserIfExists(
-  userKey: PriKey<'user'>,
-  updates: Partial<User>
-): Promise<User | null> {
-  const user = await userApi.get(userKey);
-
-  if (!user) {
-    console.log('User not found, skipping update');
-    return null;
-  }
-
-  // User exists, proceed with update
-  return await userApi.update(userKey, updates);
-}
-```
-
-### Conditional Operations
-
-```typescript
-// Perform operation based on item state
-async function processUserBasedOnState(userKey: PriKey<'user'>) {
-  const user = await userApi.get(userKey);
-
-  if (!user) {
-    console.log('User not found');
-    return;
-  }
-
-  switch (user.status) {
-    case 'pending':
-      await userApi.action(userKey, 'send-welcome-email');
-      break;
-
-    case 'active':
-      await userApi.action(userKey, 'update-last-seen');
-      break;
-
-    case 'suspended':
-      console.log('User is suspended, no action taken');
-      break;
-
-    default:
-      console.log('Unknown user status:', user.status);
-  }
-}
-```
-
-## Error Scenarios
-
-### Network Issues
-
-```typescript
-// Automatic retry handles network issues
-try {
-  const user = await userApi.get(userKey);
-  // Network errors are automatically retried
-} catch (error) {
-  // Only non-retryable errors reach here
-  if (error.code === 'NETWORK_ERROR') {
-    // All retries exhausted
-    console.error('Network completely unavailable');
-  }
-}
-```
-
-### Authorization
-
-```typescript
-// Handle permission issues
-try {
-  const user = await userApi.get(userKey);
-} catch (error) {
-  if (error.code === 'AUTHORIZATION_ERROR') {
-    console.error('Insufficient permissions to access user');
-    // Redirect to login or show error message
-  }
-}
-```
-
-## Related Operations
-
-- [`all`](./all.md) - Get multiple items
-- [`one`](./one.md) - Get single item with query
-- [`find`](./find.md) - Find items with custom finders
-- [`create`](./create.md) - Create new items
-- [`update`](./update.md) - Update existing items
-
-## Next Steps
-
-- Explore [Caching Strategies](../guides/caching.md)
-- Learn about [Error Handling](../error-handling/README.md)
-- Review [Performance Optimization](../guides/performance.md)

package/docs/public/package.json

@@ -1,63 +0,0 @@
-{
-  "name": "@fjell/registry",
-  "version": "4.4.11",
-  "keywords": [
-    "registry",
-    "fjell"
-  ],
-  "license": "Apache-2.0",
-  "description": "Common Registry for Fjell",
-  "engines": {
-    "node": ">=21"
-  },
-  "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.cjs",
-      "import": "./dist/index.js"
-    }
-  },
-  "type": "module",
-  "scripts": {
-    "build": "tsc --noEmit && vite build",
-    "dev": "concurrently \"tsc --watch --noEmit\" \"vite build --watch\"",
-    "lint": "eslint . --ext .ts --fix",
-    "clean": "rm -rf dist",
-    "test": "npm run lint && vitest run --coverage",
-    "test:memory:optimized": "npm run lint && NODE_OPTIONS=\"--max-old-space-size=8192 --max-semi-space-size=1024\" vitest run tests/memory.test.ts",
-    "test:timing:optimized": "npm run lint && NODE_OPTIONS=\"--max-old-space-size=8192 --max-semi-space-size=1024\" vitest run tests/timing.test.ts",
-    "prepublishOnly": "npm run clean && npm run build"
-  },
-  "dependencies": {
-    "@fjell/core": "^4.4.7",
-    "@fjell/logging": "^4.4.7",
-    "deepmerge": "^4.3.1"
-  },
-  "devDependencies": {
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.31.0",
-    "@swc/core": "^1.13.1",
-    "@tsconfig/recommended": "^1.0.10",
-    "@types/multer": "^2.0.0",
-    "@types/node": "^24.0.15",
-    "@typescript-eslint/eslint-plugin": "^8.37.0",
-    "@typescript-eslint/parser": "^8.37.0",
-    "@vitest/coverage-v8": "^3.2.4",
-    "concurrently": "^9.2.0",
-    "eslint": "^9.31.0",
-    "nodemon": "^3.1.10",
-    "ts-node": "^10.9.2",
-    "tsc-alias": "^1.8.16",
-    "typescript": "^5.8.3",
-    "vite": "^7.0.5",
-    "vite-plugin-dts": "^4.5.4",
-    "vite-plugin-node": "^7.0.0",
-    "vitest": "^3.2.4"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/getfjell/registry.git"
-  }
-}

package/docs/public/timing-range.svg

@@ -1,176 +0,0 @@
-<?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>