flarp 2.0.1 → 2.5.1

package/src/dom/find.js

@@ -8,16 +8,16 @@
  * Find nearest store by searching up the DOM tree
  * 
  * @param {Element} element - Starting element
- * @param {string} selector - Store selector (default: 'f-state')
+ * @param {string} selector - Store selector (default: 'f-store')
  * @returns {Element|null}
  * 
  * Search order:
  * 1. Explicit store="id" attribute
  * 2. Scoped store from f-each
- * 3. Nearest f-state in same container hierarchy
+ * 3. Nearest f-store in same container hierarchy
  * 4. Document-level fallback by ID proximity
  */
-export function findStore(element, selector = 'f-state') {
+export function findStore(element, selector = 'f-store') {
   // 1. Check explicit reference
   const ref = element.getAttribute('store');
   if (ref) {
@@ -34,7 +34,7 @@ export function findStore(element, selector = 'f-state') {
   let current = element.parentElement;
   
   while (current) {
-    // Search for f-state within this ancestor (but not within nested components)
+    // Search for f-store within this ancestor (but not within nested components)
     const store = current.querySelector(selector);
     if (store) {
       return store;
@@ -52,7 +52,7 @@ export function findStore(element, selector = 'f-state') {
  * @param {string} selector
  * @returns {Element[]}
  */
-export function findAllStores(element, selector = 'f-state') {
+export function findAllStores(element, selector = 'f-store') {
   const stores = [];
   const seen = new Set();
   let current = element.parentElement;

package/src/index.js

@@ -3,29 +3,40 @@
  * 
  * XML is state. Signals are reactive. The DOM is the runtime.
  * 
+ * ## Multi-Master Sync
+ * 
+ * All browser tabs are equal peers. No single source of truth.
+ * Conflicts are resolved deterministically - all tabs agree independently.
+ * 
  * @example
  * ```html
- * <f-state key="myapp" autosave="500">
- *   <User>
+ * <f-store key="myapp" autosave="500">
+ *   <user>
  *     <n>Alice</n>
- *     <Role>Developer</Role>
- *   </User>
- * </f-state>
+ *     <role>Developer</role>
+ *   </user>
+ * </f-store>
  * 
- * <main>
- *   <f-text path="User.Name"></f-text>
- *   <f-field path="User.Role"></f-field>
- * </main>
+ * <f-text path="user.name"></f-text>
+ * <f-field path="user.role"></f-field>
  * 
  * <script type="module">
  *   import 'flarp';
  *   
- *   const store = document.querySelector('f-state');
+ *   const store = document.querySelector('f-store');
  *   
  *   store.state.when('ready', () => {
- *     const name = store.at('User.Name');
+ *     const name = store.at('user.name');
  *     name.subscribe(v => console.log('Name:', v));
  *   });
+ *   
+ *   // Handle conflicts
+ *   store.onConflict(({ uuid, winner }) => {
+ *     console.log(`Conflict: ${winner} won`);
+ *   });
+ *   
+ *   // Apply external update (from server, WebSocket, etc.)
+ *   store.applyRemote('<n uuid="..." rev="5-abc">Bob</n>');
  * </script>
  * ```
  */
@@ -42,6 +53,7 @@ export * as Path from './xml/Path.js';
 // Sync utilities
 export * as Persist from './sync/Persist.js';
 export { default as Channel, Protocol } from './sync/Channel.js';
+export { default as Sync, parseRev, createRev, compareRevisions } from './sync/Sync.js';
 
 // DOM utilities
 export { findStore, findAllStores, whenReady, scopedStore } from './dom/find.js';
@@ -60,4 +72,4 @@ export {
 } from './components/index.js';
 
 // Version
-export const VERSION = '2.0.0';
+export const VERSION = '2.1.0';