npm - @affectively/aeon-flux - Versions diffs - 0.3.0 - Mend

@affectively/aeon-flux 0.3.0

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 (72) hide show

package/README.md +438 -0
package/examples/basic/aeon.config.ts +39 -0
package/examples/basic/components/Cursor.tsx +88 -0
package/examples/basic/components/OfflineIndicator.tsx +93 -0
package/examples/basic/components/PresenceBar.tsx +68 -0
package/examples/basic/package.json +20 -0
package/examples/basic/pages/index.tsx +73 -0
package/package.json +90 -0
package/packages/benchmarks/src/benchmark.test.ts +644 -0
package/packages/cli/package.json +43 -0
package/packages/cli/src/commands/build.test.ts +649 -0
package/packages/cli/src/commands/build.ts +853 -0
package/packages/cli/src/commands/dev.ts +463 -0
package/packages/cli/src/commands/init.ts +395 -0
package/packages/cli/src/commands/start.ts +289 -0
package/packages/cli/src/index.ts +102 -0
package/packages/directives/src/use-aeon.ts +266 -0
package/packages/react/package.json +34 -0
package/packages/react/src/Link.tsx +355 -0
package/packages/react/src/hooks/useAeonNavigation.ts +204 -0
package/packages/react/src/hooks/usePilotNavigation.ts +253 -0
package/packages/react/src/hooks/useServiceWorker.ts +276 -0
package/packages/react/src/hooks.ts +192 -0
package/packages/react/src/index.ts +89 -0
package/packages/react/src/provider.tsx +428 -0
package/packages/runtime/package.json +70 -0
package/packages/runtime/schema.sql +40 -0
package/packages/runtime/src/api-routes.ts +453 -0
package/packages/runtime/src/benchmark.ts +145 -0
package/packages/runtime/src/cache.ts +287 -0
package/packages/runtime/src/durable-object.ts +847 -0
package/packages/runtime/src/index.ts +235 -0
package/packages/runtime/src/navigation.test.ts +432 -0
package/packages/runtime/src/navigation.ts +412 -0
package/packages/runtime/src/nextjs-adapter.ts +254 -0
package/packages/runtime/src/predictor.ts +368 -0
package/packages/runtime/src/registry.ts +339 -0
package/packages/runtime/src/router/context-extractor.ts +394 -0
package/packages/runtime/src/router/esi-control-react.tsx +1172 -0
package/packages/runtime/src/router/esi-control.ts +488 -0
package/packages/runtime/src/router/esi-react.tsx +600 -0
package/packages/runtime/src/router/esi.ts +595 -0
package/packages/runtime/src/router/heuristic-adapter.test.ts +272 -0
package/packages/runtime/src/router/heuristic-adapter.ts +544 -0
package/packages/runtime/src/router/index.ts +158 -0
package/packages/runtime/src/router/speculation.ts +442 -0
package/packages/runtime/src/router/types.ts +514 -0
package/packages/runtime/src/router.test.ts +466 -0
package/packages/runtime/src/router.ts +285 -0
package/packages/runtime/src/server.ts +446 -0
package/packages/runtime/src/service-worker.ts +418 -0
package/packages/runtime/src/speculation.test.ts +360 -0
package/packages/runtime/src/speculation.ts +456 -0
package/packages/runtime/src/storage.test.ts +1201 -0
package/packages/runtime/src/storage.ts +1031 -0
package/packages/runtime/src/tree-compiler.ts +252 -0
package/packages/runtime/src/types.ts +444 -0
package/packages/runtime/src/worker.ts +300 -0
package/packages/runtime/tsconfig.json +19 -0
package/packages/runtime/wrangler.toml +41 -0
package/packages/runtime-wasm/Cargo.lock +436 -0
package/packages/runtime-wasm/Cargo.toml +29 -0
package/packages/runtime-wasm/pkg/aeon_pages_runtime.d.ts +328 -0
package/packages/runtime-wasm/pkg/aeon_pages_runtime.js +1267 -0
package/packages/runtime-wasm/pkg/aeon_pages_runtime_bg.wasm +0 -0
package/packages/runtime-wasm/pkg/aeon_pages_runtime_bg.wasm.d.ts +73 -0
package/packages/runtime-wasm/pkg/package.json +21 -0
package/packages/runtime-wasm/src/hydrate.rs +352 -0
package/packages/runtime-wasm/src/lib.rs +189 -0
package/packages/runtime-wasm/src/render.rs +629 -0
package/packages/runtime-wasm/src/router.rs +298 -0
package/rfcs/RFC-001-ZERO-DEPENDENCY-RENDERING.md +1446 -0

package/packages/runtime/src/speculation.test.ts ADDED Viewed

@@ -0,0 +1,360 @@
+import { describe, test, expect, beforeEach, afterEach, mock, spyOn } from 'bun:test';
+import {
+  SpeculativeRenderer,
+  getSpeculativeRenderer,
+  setSpeculativeRenderer,
+  initSpeculativeRendering,
+  type SpeculativeRendererConfig,
+} from './speculation';
+import { setPredictor, NavigationPredictor } from './predictor';
+// Mock DOM environment
+function createMockDOM() {
+  return {
+    querySelectorAll: mock(() => []),
+    addEventListener: mock(() => {}),
+    createElement: mock(() => ({
+      type: '',
+      textContent: '',
+    })),
+    head: {
+      appendChild: mock(() => {}),
+    },
+    open: mock(() => {}),
+    write: mock(() => {}),
+    close: mock(() => {}),
+  };
+}
+function createMockWindow() {
+  return {
+    location: { pathname: '/', origin: 'http://localhost' },
+    history: {
+      pushState: mock(() => {}),
+    },
+    addEventListener: mock(() => {}),
+    IntersectionObserver: mock((callback: Function, options: any) => ({
+      observe: mock(() => {}),
+      unobserve: mock(() => {}),
+      disconnect: mock(() => {}),
+    })),
+  };
+}
+describe('SpeculativeRenderer', () => {
+  let originalWindow: typeof globalThis.window;
+  let originalDocument: typeof globalThis.document;
+  let originalFetch: typeof globalThis.fetch;
+  beforeEach(() => {
+    originalWindow = globalThis.window;
+    originalDocument = globalThis.document;
+    originalFetch = globalThis.fetch;
+    // Set up a mock predictor
+    const predictor = new NavigationPredictor();
+    setPredictor(predictor);
+  });
+  afterEach(() => {
+    globalThis.window = originalWindow;
+    globalThis.document = originalDocument;
+    globalThis.fetch = originalFetch;
+    setSpeculativeRenderer(null as any);
+  });
+  test('creates instance with default config', () => {
+    const renderer = new SpeculativeRenderer();
+    expect(renderer).toBeDefined();
+    const stats = renderer.getStats();
+    expect(stats.cachedPages).toBe(0);
+    expect(stats.cacheSize).toBe(0);
+  });
+  test('creates instance with custom config', () => {
+    const config: Partial<SpeculativeRendererConfig> = {
+      maxCachedPages: 10,
+      maxCacheSize: 10 * 1024 * 1024,
+      minConfidence: 0.5,
+    };
+    const renderer = new SpeculativeRenderer(config);
+    expect(renderer).toBeDefined();
+  });
+  test('getSpeculativeRenderer returns singleton', () => {
+    const renderer1 = getSpeculativeRenderer();
+    const renderer2 = getSpeculativeRenderer();
+    expect(renderer1).toBe(renderer2);
+  });
+  test('setSpeculativeRenderer replaces singleton', () => {
+    const original = getSpeculativeRenderer();
+    const replacement = new SpeculativeRenderer();
+    setSpeculativeRenderer(replacement);
+    expect(getSpeculativeRenderer()).toBe(replacement);
+    expect(getSpeculativeRenderer()).not.toBe(original);
+  });
+  test('prerender caches page HTML', async () => {
+    const mockHtml = '<html><body>Test Page</body></html>';
+    globalThis.fetch = mock(async () => ({
+      ok: true,
+      text: async () => mockHtml,
+    } as Response));
+    globalThis.window = {
+      location: { pathname: '/' },
+    } as any;
+    const renderer = new SpeculativeRenderer();
+    const result = await renderer.prerender('/about');
+    expect(result).toBe(true);
+    expect(renderer.getStats().cachedPages).toBe(1);
+    expect(renderer.getStats().cacheSize).toBe(mockHtml.length);
+  });
+  test('prerender skips current route', async () => {
+    globalThis.window = {
+      location: { pathname: '/about' },
+    } as any;
+    const renderer = new SpeculativeRenderer();
+    const result = await renderer.prerender('/about');
+    expect(result).toBe(false);
+    expect(renderer.getStats().cachedPages).toBe(0);
+  });
+  test('prerender handles fetch failures', async () => {
+    globalThis.fetch = mock(async () => ({
+      ok: false,
+      status: 404,
+    } as Response));
+    globalThis.window = {
+      location: { pathname: '/' },
+    } as any;
+    const renderer = new SpeculativeRenderer();
+    const result = await renderer.prerender('/not-found');
+    expect(result).toBe(false);
+    expect(renderer.getStats().cachedPages).toBe(0);
+  });
+  test('prerender handles network errors', async () => {
+    globalThis.fetch = mock(async () => {
+      throw new Error('Network error');
+    });
+    globalThis.window = {
+      location: { pathname: '/' },
+    } as any;
+    const renderer = new SpeculativeRenderer();
+    const result = await renderer.prerender('/error');
+    expect(result).toBe(false);
+    expect(renderer.getStats().cachedPages).toBe(0);
+  });
+  test('invalidate marks pages as stale', async () => {
+    const mockHtml = '<html><body>Test</body></html>';
+    globalThis.fetch = mock(async () => ({
+      ok: true,
+      text: async () => mockHtml,
+    } as Response));
+    globalThis.window = {
+      location: { pathname: '/' },
+    } as any;
+    const renderer = new SpeculativeRenderer();
+    await renderer.prerender('/about');
+    await renderer.prerender('/contact');
+    // Invalidate specific routes
+    renderer.invalidate(['/about']);
+    // About should be stale, navigate should fail
+    const navigateResult = await renderer.navigate('/about');
+    expect(navigateResult).toBe(false);
+  });
+  test('invalidate without routes marks all as stale', async () => {
+    const mockHtml = '<html><body>Test</body></html>';
+    globalThis.fetch = mock(async () => ({
+      ok: true,
+      text: async () => mockHtml,
+    } as Response));
+    globalThis.window = {
+      location: { pathname: '/' },
+    } as any;
+    const renderer = new SpeculativeRenderer();
+    await renderer.prerender('/about');
+    await renderer.prerender('/contact');
+    // Invalidate all
+    renderer.invalidate();
+    // Both should be stale
+    const aboutResult = await renderer.navigate('/about');
+    const contactResult = await renderer.navigate('/contact');
+    expect(aboutResult).toBe(false);
+    expect(contactResult).toBe(false);
+  });
+  test('evicts old pages when cache is full', async () => {
+    const mockHtml = 'x'.repeat(1000); // 1KB per page
+    globalThis.fetch = mock(async () => ({
+      ok: true,
+      text: async () => mockHtml,
+    } as Response));
+    globalThis.window = {
+      location: { pathname: '/' },
+    } as any;
+    // Small cache - max 2 pages
+    const renderer = new SpeculativeRenderer({
+      maxCachedPages: 2,
+    });
+    await renderer.prerender('/page1');
+    await renderer.prerender('/page2');
+    expect(renderer.getStats().cachedPages).toBe(2);
+    // Adding third page should evict oldest
+    await renderer.prerender('/page3');
+    expect(renderer.getStats().cachedPages).toBe(2);
+  });
+  test('evicts based on cache size limit', async () => {
+    globalThis.fetch = mock(async () => ({
+      ok: true,
+      text: async () => 'x'.repeat(1000), // 1KB
+    } as Response));
+    globalThis.window = {
+      location: { pathname: '/' },
+    } as any;
+    // Small cache - max 1.5KB
+    const renderer = new SpeculativeRenderer({
+      maxCacheSize: 1500,
+      maxCachedPages: 100,
+    });
+    await renderer.prerender('/page1');
+    await renderer.prerender('/page2');
+    // Should only keep one page due to size limit
+    expect(renderer.getStats().cachedPages).toBe(1);
+    expect(renderer.getStats().cacheSize).toBeLessThanOrEqual(1500);
+  });
+  test('uses cached page on second prerender', async () => {
+    let fetchCount = 0;
+    const mockHtml = '<html><body>Test</body></html>';
+    globalThis.fetch = mock(async () => {
+      fetchCount++;
+      return {
+        ok: true,
+        text: async () => mockHtml,
+      } as Response;
+    });
+    globalThis.window = {
+      location: { pathname: '/' },
+    } as any;
+    const renderer = new SpeculativeRenderer();
+    await renderer.prerender('/about');
+    expect(fetchCount).toBe(1);
+    // Second call should use cache
+    await renderer.prerender('/about');
+    expect(fetchCount).toBe(1); // No additional fetch
+  });
+  test('destroy cleans up resources', async () => {
+    const mockHtml = '<html><body>Test</body></html>';
+    globalThis.fetch = mock(async () => ({
+      ok: true,
+      text: async () => mockHtml,
+    } as Response));
+    globalThis.window = {
+      location: { pathname: '/' },
+    } as any;
+    const renderer = new SpeculativeRenderer();
+    await renderer.prerender('/about');
+    expect(renderer.getStats().cachedPages).toBe(1);
+    renderer.destroy();
+    expect(renderer.getStats().cachedPages).toBe(0);
+    expect(renderer.getStats().cacheSize).toBe(0);
+  });
+});
+describe('initSpeculativeRendering', () => {
+  test('creates and initializes renderer', () => {
+    // Can't fully test init without DOM, but verify function exists
+    expect(initSpeculativeRendering).toBeDefined();
+    expect(typeof initSpeculativeRendering).toBe('function');
+  });
+});
+describe('Speculation integration with predictor', () => {
+  test('predictor predictions are used for pre-rendering', () => {
+    const predictor = new NavigationPredictor();
+    // Record some navigation history
+    predictor.record({
+      from: '/',
+      to: '/dashboard',
+      timestamp: Date.now(),
+      duration: 5000,
+    });
+    predictor.record({
+      from: '/',
+      to: '/dashboard',
+      timestamp: Date.now(),
+      duration: 3000,
+    });
+    predictor.record({
+      from: '/',
+      to: '/explore',
+      timestamp: Date.now(),
+      duration: 2000,
+    });
+    // Predict from home
+    const predictions = predictor.predict('/');
+    expect(predictions.length).toBeGreaterThan(0);
+    expect(predictions[0].route).toBe('/dashboard'); // Most likely
+    expect(predictions[0].probability).toBeGreaterThan(0.4); // ~0.48 expected
+  });
+});