@akashjs/runtime 0.2.1 → 0.2.6

package/dist/machine.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkNVZLEJXB_cjs=require('./chunk-NVZLEJXB.cjs');require('./chunk-3AL2DVPZ.cjs');Object.defineProperty(exports,"createMachine",{enumerable:true,get:function(){return chunkNVZLEJXB_cjs.a}});//# sourceMappingURL=machine.cjs.map
+'use strict';var chunk2Q6SYE5O_cjs=require('./chunk-2Q6SYE5O.cjs');require('./chunk-EEILP4OL.cjs');Object.defineProperty(exports,"createMachine",{enumerable:true,get:function(){return chunk2Q6SYE5O_cjs.a}});//# sourceMappingURL=machine.cjs.map
 //# sourceMappingURL=machine.cjs.map

package/dist/machine.js

@@ -1,2 +1,2 @@
-export{a as createMachine}from'./chunk-Z5LQV5ND.js';import'./chunk-POLTPHUA.js';//# sourceMappingURL=machine.js.map
+export{a as createMachine}from'./chunk-5A7KDBDU.js';import'./chunk-3GRR4VW2.js';//# sourceMappingURL=machine.js.map
 //# sourceMappingURL=machine.js.map

package/dist/offline.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkH4SAK7A5_cjs=require('./chunk-H4SAK7A5.cjs');require('./chunk-3AL2DVPZ.cjs');Object.defineProperty(exports,"createOfflineStore",{enumerable:true,get:function(){return chunkH4SAK7A5_cjs.a}});//# sourceMappingURL=offline.cjs.map
+'use strict';var chunk2U643GJZ_cjs=require('./chunk-2U643GJZ.cjs');require('./chunk-EEILP4OL.cjs');Object.defineProperty(exports,"createOfflineStore",{enumerable:true,get:function(){return chunk2U643GJZ_cjs.a}});//# sourceMappingURL=offline.cjs.map
 //# sourceMappingURL=offline.cjs.map

package/dist/offline.d.cts

@@ -42,6 +42,8 @@ interface OfflineStoreOptions<T> {
 interface OfflineStore<T extends Record<string, unknown>> {
     /** All items (reactive) */
     items: ReadonlySignal<T[]>;
+    /** Alias for items (reactive) */
+    data: ReadonlySignal<T[]>;
     /** Get a single item by key */
     get(key: string): T | undefined;
     /** Add or update an item */

package/dist/offline.d.ts

@@ -42,6 +42,8 @@ interface OfflineStoreOptions<T> {
 interface OfflineStore<T extends Record<string, unknown>> {
     /** All items (reactive) */
     items: ReadonlySignal<T[]>;
+    /** Alias for items (reactive) */
+    data: ReadonlySignal<T[]>;
     /** Get a single item by key */
     get(key: string): T | undefined;
     /** Add or update an item */

package/dist/offline.js

@@ -1,2 +1,2 @@
-export{a as createOfflineStore}from'./chunk-D6QQYZIC.js';import'./chunk-POLTPHUA.js';//# sourceMappingURL=offline.js.map
+export{a as createOfflineStore}from'./chunk-5NHDEY2C.js';import'./chunk-3GRR4VW2.js';//# sourceMappingURL=offline.js.map
 //# sourceMappingURL=offline.js.map

package/dist/pwa.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunk6NX6JRSV_cjs=require('./chunk-6NX6JRSV.cjs');require('./chunk-3AL2DVPZ.cjs');Object.defineProperty(exports,"generateSWScript",{enumerable:true,get:function(){return chunk6NX6JRSV_cjs.b}});Object.defineProperty(exports,"registerServiceWorker",{enumerable:true,get:function(){return chunk6NX6JRSV_cjs.a}});Object.defineProperty(exports,"subscribePush",{enumerable:true,get:function(){return chunk6NX6JRSV_cjs.c}});//# sourceMappingURL=pwa.cjs.map
+'use strict';var chunkZYVQQ5VR_cjs=require('./chunk-ZYVQQ5VR.cjs');require('./chunk-EEILP4OL.cjs');Object.defineProperty(exports,"generateSWScript",{enumerable:true,get:function(){return chunkZYVQQ5VR_cjs.b}});Object.defineProperty(exports,"registerServiceWorker",{enumerable:true,get:function(){return chunkZYVQQ5VR_cjs.a}});Object.defineProperty(exports,"subscribePush",{enumerable:true,get:function(){return chunkZYVQQ5VR_cjs.c}});//# sourceMappingURL=pwa.cjs.map
 //# sourceMappingURL=pwa.cjs.map

package/dist/pwa.d.cts

@@ -71,7 +71,11 @@ interface CacheRoute {
  * ]);
  * ```
  */
-declare function generateSWScript(routes: CacheRoute[]): string;
+declare function generateSWScript(routesOrConfig: CacheRoute[] | {
+    cacheName?: string;
+    precache?: string[];
+    runtimeCache?: CacheRoute[];
+}): string;
 /**
  * Request push notification permission and subscribe.
  */

package/dist/pwa.d.ts

@@ -71,7 +71,11 @@ interface CacheRoute {
  * ]);
  * ```
  */
-declare function generateSWScript(routes: CacheRoute[]): string;
+declare function generateSWScript(routesOrConfig: CacheRoute[] | {
+    cacheName?: string;
+    precache?: string[];
+    runtimeCache?: CacheRoute[];
+}): string;
 /**
  * Request push notification permission and subscribe.
  */

package/dist/pwa.js

@@ -1,2 +1,2 @@
-export{b as generateSWScript,a as registerServiceWorker,c as subscribePush}from'./chunk-IM2VW4TK.js';import'./chunk-POLTPHUA.js';//# sourceMappingURL=pwa.js.map
+export{b as generateSWScript,a as registerServiceWorker,c as subscribePush}from'./chunk-U53YRJNV.js';import'./chunk-3GRR4VW2.js';//# sourceMappingURL=pwa.js.map
 //# sourceMappingURL=pwa.js.map

package/dist/ssr.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkUOD4PYAN_cjs=require('./chunk-UOD4PYAN.cjs');require('./chunk-3AL2DVPZ.cjs');Object.defineProperty(exports,"escapeHtml",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.a}});Object.defineProperty(exports,"isServerRendering",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.b}});Object.defineProperty(exports,"nodeToHtml",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.i}});Object.defineProperty(exports,"renderNodes",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.j}});Object.defineProperty(exports,"renderToStream",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.e}});Object.defineProperty(exports,"renderToString",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.c}});Object.defineProperty(exports,"renderToStringSync",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.d}});Object.defineProperty(exports,"ssrElement",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.f}});Object.defineProperty(exports,"ssrRaw",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.h}});Object.defineProperty(exports,"ssrText",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.g}});//# sourceMappingURL=ssr.cjs.map
+'use strict';var chunkUOD4PYAN_cjs=require('./chunk-UOD4PYAN.cjs');require('./chunk-EEILP4OL.cjs');Object.defineProperty(exports,"escapeHtml",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.a}});Object.defineProperty(exports,"isServerRendering",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.b}});Object.defineProperty(exports,"nodeToHtml",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.i}});Object.defineProperty(exports,"renderNodes",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.j}});Object.defineProperty(exports,"renderToStream",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.e}});Object.defineProperty(exports,"renderToString",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.c}});Object.defineProperty(exports,"renderToStringSync",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.d}});Object.defineProperty(exports,"ssrElement",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.f}});Object.defineProperty(exports,"ssrRaw",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.h}});Object.defineProperty(exports,"ssrText",{enumerable:true,get:function(){return chunkUOD4PYAN_cjs.g}});//# sourceMappingURL=ssr.cjs.map
 //# sourceMappingURL=ssr.cjs.map

package/dist/ssr.js

@@ -1,2 +1,2 @@
-export{a as escapeHtml,b as isServerRendering,i as nodeToHtml,j as renderNodes,e as renderToStream,c as renderToString,d as renderToStringSync,f as ssrElement,h as ssrRaw,g as ssrText}from'./chunk-QTPP343X.js';import'./chunk-POLTPHUA.js';//# sourceMappingURL=ssr.js.map
+export{a as escapeHtml,b as isServerRendering,i as nodeToHtml,j as renderNodes,e as renderToStream,c as renderToString,d as renderToStringSync,f as ssrElement,h as ssrRaw,g as ssrText}from'./chunk-QTPP343X.js';import'./chunk-3GRR4VW2.js';//# sourceMappingURL=ssr.js.map
 //# sourceMappingURL=ssr.js.map

package/dist/store.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunk7LQZF3XA_cjs=require('./chunk-7LQZF3XA.cjs');require('./chunk-3AL2DVPZ.cjs');Object.defineProperty(exports,"__getStoreInstances",{enumerable:true,get:function(){return chunk7LQZF3XA_cjs.d}});Object.defineProperty(exports,"clearStores",{enumerable:true,get:function(){return chunk7LQZF3XA_cjs.c}});Object.defineProperty(exports,"configureStores",{enumerable:true,get:function(){return chunk7LQZF3XA_cjs.a}});Object.defineProperty(exports,"defineStore",{enumerable:true,get:function(){return chunk7LQZF3XA_cjs.b}});//# sourceMappingURL=store.cjs.map
+'use strict';var chunkAVVJKYT3_cjs=require('./chunk-AVVJKYT3.cjs');require('./chunk-35DJOBEO.cjs'),require('./chunk-EEILP4OL.cjs');Object.defineProperty(exports,"__getStoreInstances",{enumerable:true,get:function(){return chunkAVVJKYT3_cjs.d}});Object.defineProperty(exports,"clearStores",{enumerable:true,get:function(){return chunkAVVJKYT3_cjs.c}});Object.defineProperty(exports,"configureStores",{enumerable:true,get:function(){return chunkAVVJKYT3_cjs.a}});Object.defineProperty(exports,"defineStore",{enumerable:true,get:function(){return chunkAVVJKYT3_cjs.b}});//# sourceMappingURL=store.cjs.map
 //# sourceMappingURL=store.cjs.map

package/dist/store.d.cts

@@ -1,33 +1,6 @@
+import { SyncTransport } from './sync.cjs';
 import { S as Signal, R as ReadonlySignal } from './signals-C7XfOHHR.cjs';
 
-/**
- * Global state management via defineStore().
- *
- * Stores are singleton signal containers that persist across
- * components. They provide shared state, computed getters,
- * and actions — no external library needed.
- *
- * ```ts
- * const useCounterStore = defineStore('counter', {
- *   state: () => ({ count: 0, name: 'Counter' }),
- *   getters: {
- *     doubled: (state) => state.count() * 2,
- *   },
- *   actions: {
- *     increment() { this.count.update(c => c + 1); },
- *     reset() { this.count.set(0); },
- *   },
- * });
- *
- * // In any component:
- * const store = useCounterStore();
- * store.count();     // 0
- * store.doubled();   // 0
- * store.increment();
- * store.count();     // 1
- * ```
- */
-
 type StateFactory<S> = () => S;
 type Getters<S, G> = {
     [K in keyof G]: (state: SignalifiedState<S>) => G[K];
@@ -53,17 +26,43 @@ type Store<S, G, A> = SignalifiedState<S> & {
     /** Store ID */
     $id: string;
 };
-/** Actions with `this` typed to include state signals, getters, and other actions */
-type StoreActions<S, G, A> = {
-    [K in keyof A]: A[K] extends (...args: infer P) => infer R ? (this: SignalifiedState<S> & {
-        [GK in keyof G]: ReadonlySignal<G[GK]>;
-    } & A, ...args: P) => R : never;
-};
+interface PersistOptions<S> {
+    /** Only persist these state keys (default: all) */
+    pick?: (keyof S)[];
+    /** Storage backend (default: 'localStorage') */
+    storage?: 'localStorage' | 'sessionStorage';
+    /** Custom storage key (default: 'akash-store:{storeId}') */
+    key?: string;
+    /** Custom serializer (default: JSON.stringify) */
+    serialize?: (value: unknown) => string;
+    /** Custom deserializer (default: JSON.parse) */
+    deserialize?: (value: string) => unknown;
+}
+interface StoreSyncOptions {
+    /** Sync transport (WebSocket, local, etc.) */
+    transport?: SyncTransport;
+    /** Enable sync — uses provided or default transport */
+    enabled?: boolean;
+    /** Sync room/channel name (default: store ID) */
+    room?: string;
+    /** Unique peer ID */
+    peerId?: string;
+    /** Enable presence tracking */
+    presence?: boolean;
+    /** Only sync these state keys (default: all) */
+    pick?: string[];
+}
 interface StoreDefinition<S, G, A> {
     state: StateFactory<S>;
     getters?: Getters<S, G>;
-    actions?: StoreActions<S, G, A>;
+    actions?: A & ThisType<SignalifiedState<S> & {
+        [K in keyof G]: ReadonlySignal<G[K]>;
+    } & A>;
     plugins?: StorePlugin[];
+    /** Auto-persist state to storage. true = persist all to localStorage. */
+    persist?: boolean | PersistOptions<S> | PersistOptions<S>[];
+    /** Sync state across peers via CRDT. Adds real-time collaboration to any store. */
+    sync?: StoreSyncOptions;
 }
 interface StorePlugin {
     init?(store: Store<any, any, any>): void;
@@ -85,4 +84,4 @@ declare function clearStores(): void;
 /** @internal — exposes store registry for devtools */
 declare function __getStoreInstances(): Record<string, Store<any, any, any>>;
 
-export { type Store, type StoreDefinition, type StorePlugin, __getStoreInstances, clearStores, configureStores, defineStore };
+export { type PersistOptions, type Store, type StoreDefinition, type StorePlugin, type StoreSyncOptions, __getStoreInstances, clearStores, configureStores, defineStore };

package/dist/store.d.ts

@@ -1,33 +1,6 @@
+import { SyncTransport } from './sync.js';
 import { S as Signal, R as ReadonlySignal } from './signals-C7XfOHHR.js';
 
-/**
- * Global state management via defineStore().
- *
- * Stores are singleton signal containers that persist across
- * components. They provide shared state, computed getters,
- * and actions — no external library needed.
- *
- * ```ts
- * const useCounterStore = defineStore('counter', {
- *   state: () => ({ count: 0, name: 'Counter' }),
- *   getters: {
- *     doubled: (state) => state.count() * 2,
- *   },
- *   actions: {
- *     increment() { this.count.update(c => c + 1); },
- *     reset() { this.count.set(0); },
- *   },
- * });
- *
- * // In any component:
- * const store = useCounterStore();
- * store.count();     // 0
- * store.doubled();   // 0
- * store.increment();
- * store.count();     // 1
- * ```
- */
-
 type StateFactory<S> = () => S;
 type Getters<S, G> = {
     [K in keyof G]: (state: SignalifiedState<S>) => G[K];
@@ -53,17 +26,43 @@ type Store<S, G, A> = SignalifiedState<S> & {
     /** Store ID */
     $id: string;
 };
-/** Actions with `this` typed to include state signals, getters, and other actions */
-type StoreActions<S, G, A> = {
-    [K in keyof A]: A[K] extends (...args: infer P) => infer R ? (this: SignalifiedState<S> & {
-        [GK in keyof G]: ReadonlySignal<G[GK]>;
-    } & A, ...args: P) => R : never;
-};
+interface PersistOptions<S> {
+    /** Only persist these state keys (default: all) */
+    pick?: (keyof S)[];
+    /** Storage backend (default: 'localStorage') */
+    storage?: 'localStorage' | 'sessionStorage';
+    /** Custom storage key (default: 'akash-store:{storeId}') */
+    key?: string;
+    /** Custom serializer (default: JSON.stringify) */
+    serialize?: (value: unknown) => string;
+    /** Custom deserializer (default: JSON.parse) */
+    deserialize?: (value: string) => unknown;
+}
+interface StoreSyncOptions {
+    /** Sync transport (WebSocket, local, etc.) */
+    transport?: SyncTransport;
+    /** Enable sync — uses provided or default transport */
+    enabled?: boolean;
+    /** Sync room/channel name (default: store ID) */
+    room?: string;
+    /** Unique peer ID */
+    peerId?: string;
+    /** Enable presence tracking */
+    presence?: boolean;
+    /** Only sync these state keys (default: all) */
+    pick?: string[];
+}
 interface StoreDefinition<S, G, A> {
     state: StateFactory<S>;
     getters?: Getters<S, G>;
-    actions?: StoreActions<S, G, A>;
+    actions?: A & ThisType<SignalifiedState<S> & {
+        [K in keyof G]: ReadonlySignal<G[K]>;
+    } & A>;
     plugins?: StorePlugin[];
+    /** Auto-persist state to storage. true = persist all to localStorage. */
+    persist?: boolean | PersistOptions<S> | PersistOptions<S>[];
+    /** Sync state across peers via CRDT. Adds real-time collaboration to any store. */
+    sync?: StoreSyncOptions;
 }
 interface StorePlugin {
     init?(store: Store<any, any, any>): void;
@@ -85,4 +84,4 @@ declare function clearStores(): void;
 /** @internal — exposes store registry for devtools */
 declare function __getStoreInstances(): Record<string, Store<any, any, any>>;
 
-export { type Store, type StoreDefinition, type StorePlugin, __getStoreInstances, clearStores, configureStores, defineStore };
+export { type PersistOptions, type Store, type StoreDefinition, type StorePlugin, type StoreSyncOptions, __getStoreInstances, clearStores, configureStores, defineStore };

package/dist/store.js

@@ -1,2 +1,2 @@
-export{d as __getStoreInstances,c as clearStores,a as configureStores,b as defineStore}from'./chunk-772SU4MG.js';import'./chunk-POLTPHUA.js';//# sourceMappingURL=store.js.map
+export{d as __getStoreInstances,c as clearStores,a as configureStores,b as defineStore}from'./chunk-TKFJGLUO.js';import'./chunk-H2HNKYN2.js';import'./chunk-3GRR4VW2.js';//# sourceMappingURL=store.js.map
 //# sourceMappingURL=store.js.map

package/dist/sync.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkYIB4EKVI_cjs=require('./chunk-YIB4EKVI.cjs');require('./chunk-3AL2DVPZ.cjs');Object.defineProperty(exports,"LWWRegister",{enumerable:true,get:function(){return chunkYIB4EKVI_cjs.a}});Object.defineProperty(exports,"createLocalTransport",{enumerable:true,get:function(){return chunkYIB4EKVI_cjs.c}});Object.defineProperty(exports,"createSync",{enumerable:true,get:function(){return chunkYIB4EKVI_cjs.d}});Object.defineProperty(exports,"createWebSocketTransport",{enumerable:true,get:function(){return chunkYIB4EKVI_cjs.b}});//# sourceMappingURL=sync.cjs.map
+'use strict';var chunk35DJOBEO_cjs=require('./chunk-35DJOBEO.cjs');require('./chunk-EEILP4OL.cjs');Object.defineProperty(exports,"LWWRegister",{enumerable:true,get:function(){return chunk35DJOBEO_cjs.a}});Object.defineProperty(exports,"createLocalTransport",{enumerable:true,get:function(){return chunk35DJOBEO_cjs.c}});Object.defineProperty(exports,"createSync",{enumerable:true,get:function(){return chunk35DJOBEO_cjs.d}});Object.defineProperty(exports,"createWebSocketTransport",{enumerable:true,get:function(){return chunk35DJOBEO_cjs.b}});Object.defineProperty(exports,"useCursor",{enumerable:true,get:function(){return chunk35DJOBEO_cjs.e}});Object.defineProperty(exports,"useTypingIndicator",{enumerable:true,get:function(){return chunk35DJOBEO_cjs.f}});//# sourceMappingURL=sync.cjs.map
 //# sourceMappingURL=sync.cjs.map

package/dist/sync.d.cts

@@ -65,8 +65,8 @@ interface SyncTransport {
     onReceive(handler: (op: SyncOp) => void): () => void;
     /** Listen for peer presence updates */
     onPresence?(handler: (peerId: string, data: unknown) => void): () => void;
-    /** Send presence data */
-    sendPresence?(data: unknown): void;
+    /** Send presence data (peerId passed by createSync internals) */
+    sendPresence?(data: unknown, peerId?: string): void;
     /** Connect to the sync channel */
     connect(): void;
     /** Disconnect */
@@ -79,11 +79,23 @@ interface WebSocketTransportOptions {
 }
 declare function createWebSocketTransport(options: WebSocketTransportOptions): SyncTransport;
 declare function createLocalTransport(): SyncTransport;
+interface SyncConflict {
+    key: string;
+    localValue: unknown;
+    remoteValue: unknown;
+    localTimestamp: number;
+    remoteTimestamp: number;
+    remotePeerId: string;
+}
 interface SyncOptions {
     /** Transport for sending/receiving operations */
     transport?: SyncTransport;
     /** Unique peer ID (default: random) */
     peerId?: string;
+    /** Initial presence data — broadcast on connect */
+    presence?: Record<string, unknown>;
+    /** Custom conflict resolver. Return the winning value, or undefined to queue for manual resolution. */
+    onConflict?: (conflict: SyncConflict) => unknown | undefined;
 }
 interface SyncDoc<T extends Record<string, unknown>> {
     /** Reactive synced state — each key is a Signal */
@@ -96,6 +108,10 @@ interface SyncDoc<T extends Record<string, unknown>> {
     presence: Signal<Record<string, unknown>>;
     /** Peer presence map (reactive) */
     peerPresence: ReadonlySignal<Map<string, unknown>>;
+    /** Unresolved conflicts (reactive) */
+    conflicts: ReadonlySignal<SyncConflict[]>;
+    /** Resolve a conflict by choosing a value for a key */
+    resolveConflict: (key: string, value: unknown) => void;
     /** This peer's ID */
     peerId: string;
     /** Whether connected */
@@ -123,6 +139,45 @@ interface PeerInfo {
  * doc.peers();                  // connected users
  * ```
  */
-declare function createSync<T extends Record<string, unknown>>(roomId: string, initialState: T, options?: SyncOptions): SyncDoc<T>;
+declare function createSync<T extends Record<string, unknown>>(initialState: T, options?: SyncOptions): SyncDoc<T>;
+/**
+ * Track cursor position and broadcast via sync presence.
+ * Throttles updates to avoid flooding the transport.
+ *
+ * ```ts
+ * const cursor = useCursor(doc, { throttle: 50 });
+ * // Automatically tracks mousemove and broadcasts { cursor: { x, y } }
+ * // Other peers: doc.peerPresence().get(peerId).cursor
+ * ```
+ */
+declare function useCursor(doc: SyncDoc<any>, options?: {
+    throttle?: number;
+    target?: HTMLElement;
+}): {
+    x: ReadonlySignal<number>;
+    y: ReadonlySignal<number>;
+    dispose: () => void;
+};
+/**
+ * Typing indicator — broadcasts typing state with auto-timeout.
+ *
+ * ```ts
+ * const typing = useTypingIndicator(doc, { timeout: 2000 });
+ * typing.start();  // broadcasts { typing: true }
+ * // Auto-stops after 2s of inactivity
+ * typing.stop();   // manual stop
+ *
+ * // Other peers typing:
+ * typing.othersTyping(); // string[] of peer IDs currently typing
+ * ```
+ */
+declare function useTypingIndicator(doc: SyncDoc<any>, options?: {
+    timeout?: number;
+}): {
+    isTyping: ReadonlySignal<boolean>;
+    othersTyping: ReadonlySignal<string[]>;
+    start: () => void;
+    stop: () => void;
+};
 
-export { type LWWEntry, LWWRegister, type PeerInfo, type SyncDoc, type SyncOp, type SyncOptions, type SyncTransport, type WebSocketTransportOptions, createLocalTransport, createSync, createWebSocketTransport };
+export { type LWWEntry, LWWRegister, type PeerInfo, type SyncConflict, type SyncDoc, type SyncOp, type SyncOptions, type SyncTransport, type WebSocketTransportOptions, createLocalTransport, createSync, createWebSocketTransport, useCursor, useTypingIndicator };

package/dist/sync.d.ts

@@ -65,8 +65,8 @@ interface SyncTransport {
     onReceive(handler: (op: SyncOp) => void): () => void;
     /** Listen for peer presence updates */
     onPresence?(handler: (peerId: string, data: unknown) => void): () => void;
-    /** Send presence data */
-    sendPresence?(data: unknown): void;
+    /** Send presence data (peerId passed by createSync internals) */
+    sendPresence?(data: unknown, peerId?: string): void;
     /** Connect to the sync channel */
     connect(): void;
     /** Disconnect */
@@ -79,11 +79,23 @@ interface WebSocketTransportOptions {
 }
 declare function createWebSocketTransport(options: WebSocketTransportOptions): SyncTransport;
 declare function createLocalTransport(): SyncTransport;
+interface SyncConflict {
+    key: string;
+    localValue: unknown;
+    remoteValue: unknown;
+    localTimestamp: number;
+    remoteTimestamp: number;
+    remotePeerId: string;
+}
 interface SyncOptions {
     /** Transport for sending/receiving operations */
     transport?: SyncTransport;
     /** Unique peer ID (default: random) */
     peerId?: string;
+    /** Initial presence data — broadcast on connect */
+    presence?: Record<string, unknown>;
+    /** Custom conflict resolver. Return the winning value, or undefined to queue for manual resolution. */
+    onConflict?: (conflict: SyncConflict) => unknown | undefined;
 }
 interface SyncDoc<T extends Record<string, unknown>> {
     /** Reactive synced state — each key is a Signal */
@@ -96,6 +108,10 @@ interface SyncDoc<T extends Record<string, unknown>> {
     presence: Signal<Record<string, unknown>>;
     /** Peer presence map (reactive) */
     peerPresence: ReadonlySignal<Map<string, unknown>>;
+    /** Unresolved conflicts (reactive) */
+    conflicts: ReadonlySignal<SyncConflict[]>;
+    /** Resolve a conflict by choosing a value for a key */
+    resolveConflict: (key: string, value: unknown) => void;
     /** This peer's ID */
     peerId: string;
     /** Whether connected */
@@ -123,6 +139,45 @@ interface PeerInfo {
  * doc.peers();                  // connected users
  * ```
  */
-declare function createSync<T extends Record<string, unknown>>(roomId: string, initialState: T, options?: SyncOptions): SyncDoc<T>;
+declare function createSync<T extends Record<string, unknown>>(initialState: T, options?: SyncOptions): SyncDoc<T>;
+/**
+ * Track cursor position and broadcast via sync presence.
+ * Throttles updates to avoid flooding the transport.
+ *
+ * ```ts
+ * const cursor = useCursor(doc, { throttle: 50 });
+ * // Automatically tracks mousemove and broadcasts { cursor: { x, y } }
+ * // Other peers: doc.peerPresence().get(peerId).cursor
+ * ```
+ */
+declare function useCursor(doc: SyncDoc<any>, options?: {
+    throttle?: number;
+    target?: HTMLElement;
+}): {
+    x: ReadonlySignal<number>;
+    y: ReadonlySignal<number>;
+    dispose: () => void;
+};
+/**
+ * Typing indicator — broadcasts typing state with auto-timeout.
+ *
+ * ```ts
+ * const typing = useTypingIndicator(doc, { timeout: 2000 });
+ * typing.start();  // broadcasts { typing: true }
+ * // Auto-stops after 2s of inactivity
+ * typing.stop();   // manual stop
+ *
+ * // Other peers typing:
+ * typing.othersTyping(); // string[] of peer IDs currently typing
+ * ```
+ */
+declare function useTypingIndicator(doc: SyncDoc<any>, options?: {
+    timeout?: number;
+}): {
+    isTyping: ReadonlySignal<boolean>;
+    othersTyping: ReadonlySignal<string[]>;
+    start: () => void;
+    stop: () => void;
+};
 
-export { type LWWEntry, LWWRegister, type PeerInfo, type SyncDoc, type SyncOp, type SyncOptions, type SyncTransport, type WebSocketTransportOptions, createLocalTransport, createSync, createWebSocketTransport };
+export { type LWWEntry, LWWRegister, type PeerInfo, type SyncConflict, type SyncDoc, type SyncOp, type SyncOptions, type SyncTransport, type WebSocketTransportOptions, createLocalTransport, createSync, createWebSocketTransport, useCursor, useTypingIndicator };

package/dist/sync.js

@@ -1,2 +1,2 @@
-export{a as LWWRegister,c as createLocalTransport,d as createSync,b as createWebSocketTransport}from'./chunk-ODDXU5DO.js';import'./chunk-POLTPHUA.js';//# sourceMappingURL=sync.js.map
+export{a as LWWRegister,c as createLocalTransport,d as createSync,b as createWebSocketTransport,e as useCursor,f as useTypingIndicator}from'./chunk-H2HNKYN2.js';import'./chunk-3GRR4VW2.js';//# sourceMappingURL=sync.js.map
 //# sourceMappingURL=sync.js.map

package/dist/test.cjs

@@ -1,5 +1,5 @@
-'use strict';var chunkNQVWTQ2I_cjs=require('./chunk-NQVWTQ2I.cjs'),chunk3AL2DVPZ_cjs=require('./chunk-3AL2DVPZ.cjs');function H(t,n){let e=document.createElement("div");e.setAttribute("data-akash-test-root","");let i=n?.props??{},r=n?.provide,s;return r&&r.size>0?s=chunkNQVWTQ2I_cjs.B(()=>{for(let[l,d]of r)chunkNQVWTQ2I_cjs.h(l,d);return ()=>t(i)})({}):s=t(i),e.appendChild(s),document.body.appendChild(e),{container:e,unmount(){e.remove();},getByText(o){let l=T(e,o);if(!l)throw new Error(`[AkashJS Test] Could not find element with text: "${o}"
-  Container HTML: ${e.innerHTML.slice(0,200)}`);return l},getByRole(o){let l=e.querySelector(`[role="${o}"]`)??f(e,o);if(!l)throw new Error(`[AkashJS Test] Could not find element with role: "${o}"
-  Container HTML: ${e.innerHTML.slice(0,200)}`);return l},getByTestId(o){let l=e.querySelector(`[data-testid="${o}"]`);if(!l)throw new Error(`[AkashJS Test] Could not find element with data-testid: "${o}"
-  Container HTML: ${e.innerHTML.slice(0,200)}`);return l},queryAll(o){return Array.from(e.querySelectorAll(o))},query(o){return e.querySelector(o)}}}var L={async click(t){t.dispatchEvent(new MouseEvent("click",{bubbles:true,cancelable:true})),await a();},async input(t,n){let e=Object.getOwnPropertyDescriptor(t instanceof HTMLTextAreaElement?HTMLTextAreaElement.prototype:HTMLInputElement.prototype,"value")?.set;e?e.call(t,n):t.value=n,t.dispatchEvent(new Event("input",{bubbles:true})),t.dispatchEvent(new Event("change",{bubbles:true})),await a();},async submit(t){t.dispatchEvent(new Event("submit",{bubbles:true,cancelable:true})),await a();},async focus(t){t.focus(),t.dispatchEvent(new FocusEvent("focus",{bubbles:true})),await a();},async blur(t){t.blur(),t.dispatchEvent(new FocusEvent("blur",{bubbles:true})),await a();},async keyDown(t,n,e){t.dispatchEvent(new KeyboardEvent("keydown",{key:n,bubbles:true,...e})),await a();},async keyUp(t,n,e){t.dispatchEvent(new KeyboardEvent("keyup",{key:n,bubbles:true,...e})),await a();}};function a(){return new Promise(t=>queueMicrotask(t))}function T(t,n){let e=null,i=document.createTreeWalker(t,NodeFilter.SHOW_ELEMENT),r=i.nextNode();for(;r;)r instanceof HTMLElement&&r.textContent?.includes(n)&&(e=r),r=i.nextNode();return !e&&t.textContent?.includes(n)&&(e=t),e}var E={button:["button"],a:["link"],input:["textbox","checkbox","radio","spinbutton","slider"],select:["combobox","listbox"],textarea:["textbox"],img:["img"],form:["form"],nav:["navigation"],main:["main"],header:["banner"],footer:["contentinfo"],aside:["complementary"],section:["region"],article:["article"],ul:["list"],ol:["list"],li:["listitem"],table:["table"],th:["columnheader"],td:["cell"],h1:["heading"],h2:["heading"],h3:["heading"],h4:["heading"],h5:["heading"],h6:["heading"]};function f(t,n){let e=[];for(let[r,s]of Object.entries(E))s.includes(n)&&e.push(r);if(e.length===0)return null;let i=e.join(", ");return t.querySelector(i)}async function y(t,n){let{timeout:e=1e3,interval:i=50}=n??{},r=Date.now();for(;;)try{await t();return}catch(s){if(Date.now()-r>=e)throw s;await new Promise(o=>setTimeout(o,i));}}async function w(t,n,e){let i=null;return await y(()=>{if(i=t.querySelector(n),!i)throw new Error(`Element "${n}" not found`)},e),i}function v(t){let n=chunk3AL2DVPZ_cjs.l(t),e=[t],i=0,r=(()=>n());return r.set=s=>{n.set(s),e.push(s),i++;},r.update=s=>{let o=s(n.peek());r.set(o);},r.peek=()=>n.peek(),Object.defineProperty(r,"history",{get:()=>[...e]}),Object.defineProperty(r,"setCount",{get:()=>i}),r.resetHistory=()=>{e.length=0,e.push(n.peek()),i=0;},r}Object.defineProperty(exports,"flush",{enumerable:true,get:function(){return chunk3AL2DVPZ_cjs.b}});exports.createTestSignal=v;exports.fireEvent=L;exports.mount=H;exports.waitFor=y;exports.waitForElement=w;//# sourceMappingURL=test.cjs.map
+'use strict';var chunk6GGYM5SF_cjs=require('./chunk-6GGYM5SF.cjs'),chunkAVVJKYT3_cjs=require('./chunk-AVVJKYT3.cjs');require('./chunk-35DJOBEO.cjs');var chunkEEILP4OL_cjs=require('./chunk-EEILP4OL.cjs');function A(e,n){let t=document.createElement("div");t.setAttribute("data-akash-test-root","");let r=n?.props??{},o=n?.provide,i;return o&&o.size>0?i=chunk6GGYM5SF_cjs.B(()=>{for(let[a,u]of o)chunk6GGYM5SF_cjs.h(a,u);return ()=>e(r)})({}):i=e(r),t.appendChild(i),document.body.appendChild(t),f.push(t),{container:t,unmount(){t.remove();},getByText(s){let a=k(t,s);if(!a)throw new Error(`[AkashJS Test] Could not find element with text: "${s}"
+  Container HTML: ${t.innerHTML.slice(0,200)}`);return a},getByRole(s){let a=t.querySelector(`[role="${s}"]`)??x(t,s);if(!a)throw new Error(`[AkashJS Test] Could not find element with role: "${s}"
+  Container HTML: ${t.innerHTML.slice(0,200)}`);return a},getByTestId(s){let a=t.querySelector(`[data-testid="${s}"]`);if(!a)throw new Error(`[AkashJS Test] Could not find element with data-testid: "${s}"
+  Container HTML: ${t.innerHTML.slice(0,200)}`);return a},queryAll(s){return Array.from(t.querySelectorAll(s))},query(s){return t.querySelector(s)}}}var O={async click(e){e.dispatchEvent(new MouseEvent("click",{bubbles:true,cancelable:true})),await c();},async input(e,n){let t=Object.getOwnPropertyDescriptor(e instanceof HTMLTextAreaElement?HTMLTextAreaElement.prototype:HTMLInputElement.prototype,"value")?.set;t?t.call(e,n):e.value=n,e.dispatchEvent(new Event("input",{bubbles:true})),e.dispatchEvent(new Event("change",{bubbles:true})),await c();},async submit(e){e.dispatchEvent(new Event("submit",{bubbles:true,cancelable:true})),await c();},async focus(e){e.focus(),e.dispatchEvent(new FocusEvent("focus",{bubbles:true})),await c();},async blur(e){e.blur(),e.dispatchEvent(new FocusEvent("blur",{bubbles:true})),await c();},async keyDown(e,n,t){e.dispatchEvent(new KeyboardEvent("keydown",{key:n,bubbles:true,...t})),await c();},async keyUp(e,n,t){e.dispatchEvent(new KeyboardEvent("keyup",{key:n,bubbles:true,...t})),await c();}};function c(){return new Promise(e=>queueMicrotask(e))}function k(e,n){let t=null,r=document.createTreeWalker(e,NodeFilter.SHOW_ELEMENT),o=r.nextNode();for(;o;)o instanceof HTMLElement&&o.textContent?.includes(n)&&(t=o),o=r.nextNode();return !t&&e.textContent?.includes(n)&&(t=e),t}var H={button:["button"],a:["link"],input:["textbox","checkbox","radio","spinbutton","slider"],select:["combobox","listbox"],textarea:["textbox"],img:["img"],form:["form"],nav:["navigation"],main:["main"],header:["banner"],footer:["contentinfo"],aside:["complementary"],section:["region"],article:["article"],ul:["list"],ol:["list"],li:["listitem"],table:["table"],th:["columnheader"],td:["cell"],h1:["heading"],h2:["heading"],h3:["heading"],h4:["heading"],h5:["heading"],h6:["heading"]};function x(e,n){let t=[];for(let[o,i]of Object.entries(H))i.includes(n)&&t.push(o);if(t.length===0)return null;let r=t.join(", ");return e.querySelector(r)}async function S(e,n){let{timeout:t=1e3,interval:r=50}=n??{},o=Date.now();for(;;)try{await e();return}catch(i){if(Date.now()-o>=t)throw i;await new Promise(s=>setTimeout(s,r));}}async function q(e,n,t){let r=null;return await S(()=>{if(r=e.querySelector(n),!r)throw new Error(`Element "${n}" not found`)},t),r}function N(e){let n=chunkEEILP4OL_cjs.l(e),t=[e],r=0,o=(()=>n());return o.set=i=>{n.set(i),t.push(i),r++;},o.update=i=>{let s=i(n.peek());o.set(s);},o.peek=()=>n.peek(),Object.defineProperty(o,"history",{get:()=>[...t]}),Object.defineProperty(o,"setCount",{get:()=>r}),o.resetHistory=()=>{t.length=0,t.push(n.peek()),r=0;},o}var f=[];function j(){for(let e of f)e.remove();f.length=0,chunkAVVJKYT3_cjs.c();}function D(e){chunkAVVJKYT3_cjs.c();let n=e();return chunkAVVJKYT3_cjs.c(),n}function B(e={},n=200){let t=[],r=async(o,i)=>{let s=typeof o=="string"?o:o instanceof URL?o.toString():o.url,a=i?.method??"GET",u;if(i?.body)try{u=JSON.parse(String(i.body));}catch{u=i.body;}let y={};i?.headers&&new Headers(i.headers).forEach((p,v)=>{y[v]=p;}),t.push({url:s,method:a,body:u,headers:y});let M=s.replace(/^https?:\/\/[^/]+/,"").split("?")[0],h=e[M]??e[s];if(h===void 0)return new Response("Not Found",{status:404});let d=n,l=h;if(l&&typeof l=="object"&&!Array.isArray(l)&&"_status"in l){let{_status:g,...p}=l;d=Number(g),l=p;}let T=d===204||d===304;return new Response(T?null:JSON.stringify(l),{status:d,headers:T?{}:{"Content-Type":"application/json"}})};return r.calls=()=>[...t],r.callCount=()=>t.length,r.reset=()=>{t.length=0;},r}function _(){let e=new Map;return {invalidate:()=>{},setQueryData:()=>{},getQueryData:()=>{},removeQuery:n=>{e.delete(JSON.stringify(n));},clear:()=>{e.clear();},_cache:e,_options:{defaultStaleTime:0}}}Object.defineProperty(exports,"flush",{enumerable:true,get:function(){return chunkEEILP4OL_cjs.b}});exports.cleanup=j;exports.createTestSignal=N;exports.createTestStore=D;exports.fireEvent=O;exports.mockFetch=B;exports.mockQueryClient=_;exports.mount=A;exports.waitFor=S;exports.waitForElement=q;//# sourceMappingURL=test.cjs.map
 //# sourceMappingURL=test.cjs.map