@affectively/aeon-pages-react 0.2.0

package/dist/provider.d.ts

@@ -0,0 +1,91 @@
+/**
+ * AeonPageProvider - Context provider for Aeon Pages
+ *
+ * Provides:
+ * - Real-time sync via Aeon SyncCoordinator
+ * - Presence tracking via AgentPresenceManager
+ * - Offline support via OfflineOperationQueue
+ * - Schema versioning via SchemaVersionManager
+ */
+import { type ReactNode } from 'react';
+export interface PresenceUser {
+    userId: string;
+    role: 'user' | 'assistant' | 'monitor' | 'admin';
+    cursor?: {
+        x: number;
+        y: number;
+    };
+    editing?: string;
+    status: 'online' | 'away' | 'offline';
+    lastActivity: string;
+}
+export interface SyncState {
+    isOnline: boolean;
+    isSyncing: boolean;
+    lastSyncAt?: string;
+    pendingOperations: number;
+}
+export interface VersionInfo {
+    current: string;
+    latest: string;
+    needsMigration: boolean;
+}
+export interface AeonPageContextValue {
+    route: string;
+    sessionId: string;
+    presence: PresenceUser[];
+    localUser: PresenceUser | null;
+    updateCursor: (position: {
+        x: number;
+        y: number;
+    }) => void;
+    updateEditing: (elementPath: string | null) => void;
+    sync: SyncState;
+    forcSync: () => Promise<void>;
+    version: VersionInfo;
+    migrate: (toVersion: string) => Promise<void>;
+    data: Record<string, unknown>;
+    setData: (key: string, value: unknown) => void;
+    tree: unknown;
+    updateTree: (path: string, value: unknown) => void;
+}
+export interface AeonPageProviderProps {
+    route: string;
+    children: ReactNode;
+    initialData?: Record<string, unknown>;
+}
+/**
+ * AeonPageProvider - Wraps a page with Aeon collaborative features
+ */
+export declare function AeonPageProvider({ route, children, initialData }: AeonPageProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * useAeonPage - Access Aeon page context
+ */
+export declare function useAeonPage(): AeonPageContextValue;
+/**
+ * usePresence - Just the presence data
+ */
+export declare function usePresence(): {
+    presence: PresenceUser[];
+    localUser: PresenceUser | null;
+    updateCursor: (position: {
+        x: number;
+        y: number;
+    }) => void;
+    updateEditing: (elementPath: string | null) => void;
+};
+/**
+ * useAeonSync - Just the sync state
+ */
+export declare function useAeonSync(): {
+    forceSync: () => Promise<void>;
+    isOnline: boolean;
+    isSyncing: boolean;
+    lastSyncAt?: string;
+    pendingOperations: number;
+};
+/**
+ * useAeonData - Just the data store
+ */
+export declare function useAeonData<T = unknown>(key: string): [T | undefined, (value: T) => void];
+export default AeonPageProvider;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@affectively/aeon-pages-react",
+  "version": "0.2.0",
+  "description": "React bindings for @affectively/aeon-pages",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target browser && tsc --declaration --emitDeclarationOnly",
+    "dev": "bun --watch ./src/index.ts",
+    "test": "bun test",
+    "prepublishOnly": "bun run build"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@affectively/aeon-pages-runtime": "^0.3.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/react": "^18.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/affectively/aeon-pages"
+  }
+}