@plures/praxis 1.0.2 → 1.1.0

package/docs/tutorials/todo-pluresdb.md

@@ -9,6 +9,7 @@ This tutorial walks you through building a local-first todo application with Plu
 ## What You'll Build
 
 A todo application that:
+
 - Stores todos locally with PluresDB
 - Works completely offline
 - Syncs automatically when connected
@@ -40,7 +41,7 @@ Create `src/schema.psf.json`:
   "id": "todo-app",
   "name": "Todo App",
   "description": "A local-first todo application with PluresDB",
-  
+
   "facts": [
     {
       "id": "fact_todo_created",
@@ -79,7 +80,7 @@ Create `src/schema.psf.json`:
       }
     }
   ],
-  
+
   "events": [
     {
       "id": "event_create_todo",
@@ -115,7 +116,7 @@ Create `src/schema.psf.json`:
       }
     }
   ],
-  
+
   "models": [
     {
       "id": "model_todo",
@@ -167,10 +168,7 @@ export const db = createPluresDB({
         createdAt: { type: 'datetime', default: () => new Date() },
         completedAt: { type: 'datetime', optional: true },
       },
-      indexes: [
-        { fields: ['completed'] },
-        { fields: ['createdAt'], sort: 'desc' },
-      ],
+      indexes: [{ fields: ['completed'] }, { fields: ['createdAt'], sort: 'desc' }],
     },
   ],
   sync: {
@@ -212,21 +210,19 @@ export const TodoCreated = defineFact<
   { id: string; title: string; createdAt: number }
 >('TodoCreated');
 
-export const TodoCompleted = defineFact<
-  'TodoCompleted',
-  { id: string; completedAt: number }
->('TodoCompleted');
+export const TodoCompleted = defineFact<'TodoCompleted', { id: string; completedAt: number }>(
+  'TodoCompleted'
+);
 
-export const TodoDeleted = defineFact<
-  'TodoDeleted',
-  { id: string }
->('TodoDeleted');
+export const TodoDeleted = defineFact<'TodoDeleted', { id: string }>('TodoDeleted');
 
 // Events
 export const CREATE_TODO = defineEvent<'CREATE_TODO', { title: string }>('CREATE_TODO');
 export const COMPLETE_TODO = defineEvent<'COMPLETE_TODO', { id: string }>('COMPLETE_TODO');
 export const DELETE_TODO = defineEvent<'DELETE_TODO', { id: string }>('DELETE_TODO');
-export const SET_FILTER = defineEvent<'SET_FILTER', { filter: 'all' | 'active' | 'completed' }>('SET_FILTER');
+export const SET_FILTER = defineEvent<'SET_FILTER', { filter: 'all' | 'active' | 'completed' }>(
+  'SET_FILTER'
+);
 
 // Rules
 const createTodoRule = defineRule<TodoContext>({
@@ -235,10 +231,10 @@ const createTodoRule = defineRule<TodoContext>({
   impl: async (state, events) => {
     const event = events.find(CREATE_TODO.is);
     if (!event) return [];
-    
+
     const now = Date.now();
     const id = crypto.randomUUID();
-    
+
     // Create in database
     const todo: Todo = {
       id,
@@ -246,12 +242,12 @@ const createTodoRule = defineRule<TodoContext>({
       completed: false,
       createdAt: new Date(now),
     };
-    
+
     await todos.insert(todo);
-    
+
     // Update local state
     state.context.todos.unshift(todo);
-    
+
     return [TodoCreated.create({ id, title: event.payload.title, createdAt: now })];
   },
 });
@@ -262,21 +258,21 @@ const completeTodoRule = defineRule<TodoContext>({
   impl: async (state, events) => {
     const event = events.find(COMPLETE_TODO.is);
     if (!event) return [];
-    
+
     const now = Date.now();
-    
+
     // Update in database
     await todos.updateById(event.payload.id, {
       $set: { completed: true, completedAt: new Date(now) },
     });
-    
+
     // Update local state
-    const todo = state.context.todos.find(t => t.id === event.payload.id);
+    const todo = state.context.todos.find((t) => t.id === event.payload.id);
     if (todo) {
       todo.completed = true;
       todo.completedAt = new Date(now);
     }
-    
+
     return [TodoCompleted.create({ id: event.payload.id, completedAt: now })];
   },
 });
@@ -287,13 +283,13 @@ const deleteTodoRule = defineRule<TodoContext>({
   impl: async (state, events) => {
     const event = events.find(DELETE_TODO.is);
     if (!event) return [];
-    
+
     // Delete from database
     await todos.deleteById(event.payload.id);
-    
+
     // Update local state
-    state.context.todos = state.context.todos.filter(t => t.id !== event.payload.id);
-    
+    state.context.todos = state.context.todos.filter((t) => t.id !== event.payload.id);
+
     return [TodoDeleted.create({ id: event.payload.id })];
   },
 });
@@ -304,7 +300,7 @@ const setFilterRule = defineRule<TodoContext>({
   impl: (state, events) => {
     const event = events.find(SET_FILTER.is);
     if (!event) return [];
-    
+
     state.context.filter = event.payload.filter;
     return [];
   },
@@ -321,7 +317,7 @@ registry.registerRule(setFilterRule);
 export async function createTodoEngine() {
   // Load existing todos from database
   const existingTodos = await todos.find({}, { sort: { createdAt: -1 } });
-  
+
   return createPraxisEngine({
     initialContext: {
       todos: existingTodos,
@@ -347,19 +343,19 @@ export function setupSyncHandlers(onStatusChange: (status: string) => void) {
   db.on('sync:start', () => {
     onStatusChange('syncing');
   });
-  
+
   db.on('sync:complete', () => {
     onStatusChange('online');
   });
-  
+
   db.on('sync:error', () => {
     onStatusChange('offline');
   });
-  
+
   db.on('online', () => {
     onStatusChange('online');
   });
-  
+
   db.on('offline', () => {
     onStatusChange('offline');
   });
@@ -386,27 +382,27 @@ import { setupSyncHandlers, syncNow, getPendingCount } from './db';
 
 async function main() {
   console.log('🚀 Starting Todo App with PluresDB\n');
-  
+
   // Create engine
   const engine = await createTodoEngine();
-  
+
   // Setup sync status updates
   setupSyncHandlers((status) => {
     console.log(`📡 Sync status: ${status}`);
   });
-  
+
   // Display current state
   function displayTodos() {
     const ctx = engine.getContext();
     console.log('\n📋 Todos:');
     console.log('─'.repeat(40));
-    
-    const filtered = ctx.todos.filter(todo => {
+
+    const filtered = ctx.todos.filter((todo) => {
       if (ctx.filter === 'active') return !todo.completed;
       if (ctx.filter === 'completed') return todo.completed;
       return true;
     });
-    
+
     if (filtered.length === 0) {
       console.log('  No todos');
     } else {
@@ -415,43 +411,43 @@ async function main() {
         console.log(`  ${i + 1}. ${checkbox} ${todo.title}`);
       });
     }
-    
+
     console.log('─'.repeat(40));
     console.log(`Filter: ${ctx.filter} | Pending sync: ${getPendingCount()}`);
     console.log('');
   }
-  
+
   // Show initial state
   displayTodos();
-  
+
   // Add some todos
   console.log('Adding todos...');
-  
+
   await engine.dispatch([CREATE_TODO.create({ title: 'Learn Praxis' })]);
   await engine.dispatch([CREATE_TODO.create({ title: 'Build with PluresDB' })]);
   await engine.dispatch([CREATE_TODO.create({ title: 'Deploy to production' })]);
-  
+
   displayTodos();
-  
+
   // Complete a todo
   const firstTodoId = engine.getContext().todos[0].id;
   console.log(`Completing: ${engine.getContext().todos[0].title}`);
   await engine.dispatch([COMPLETE_TODO.create({ id: firstTodoId })]);
-  
+
   displayTodos();
-  
+
   // Filter by active
   console.log('Filtering by active...');
   await engine.dispatch([SET_FILTER.create({ filter: 'active' })]);
-  
+
   displayTodos();
-  
+
   // Filter by completed
   console.log('Filtering by completed...');
   await engine.dispatch([SET_FILTER.create({ filter: 'completed' })]);
-  
+
   displayTodos();
-  
+
   // Trigger sync
   console.log('Syncing with server...');
   try {
@@ -460,7 +456,7 @@ async function main() {
   } catch (error) {
     console.log('⚠️ Sync failed (offline mode)');
   }
-  
+
   console.log('\n🎉 Done!');
 }
 
@@ -492,7 +488,7 @@ describe('Todo Engine', () => {
   describe('CREATE_TODO', () => {
     it('should create a new todo', async () => {
       await engine.dispatch([CREATE_TODO.create({ title: 'Test todo' })]);
-      
+
       const ctx = engine.getContext();
       expect(ctx.todos.length).toBe(1);
       expect(ctx.todos[0].title).toBe('Test todo');
@@ -501,10 +497,8 @@ describe('Todo Engine', () => {
 
     it('should emit TodoCreated fact', async () => {
       const result = await engine.step([CREATE_TODO.create({ title: 'Test' })]);
-      
-      expect(result.state.facts).toContainEqual(
-        expect.objectContaining({ tag: 'TodoCreated' })
-      );
+
+      expect(result.state.facts).toContainEqual(expect.objectContaining({ tag: 'TodoCreated' }));
     });
   });
 
@@ -512,9 +506,9 @@ describe('Todo Engine', () => {
     it('should mark todo as completed', async () => {
       await engine.dispatch([CREATE_TODO.create({ title: 'Test' })]);
       const todoId = engine.getContext().todos[0].id;
-      
+
       await engine.dispatch([COMPLETE_TODO.create({ id: todoId })]);
-      
+
       const todo = engine.getContext().todos[0];
       expect(todo.completed).toBe(true);
       expect(todo.completedAt).toBeDefined();
@@ -525,9 +519,9 @@ describe('Todo Engine', () => {
     it('should remove the todo', async () => {
       await engine.dispatch([CREATE_TODO.create({ title: 'Test' })]);
       const todoId = engine.getContext().todos[0].id;
-      
+
       await engine.dispatch([DELETE_TODO.create({ id: todoId })]);
-      
+
       expect(engine.getContext().todos.length).toBe(0);
     });
   });
@@ -535,7 +529,7 @@ describe('Todo Engine', () => {
   describe('SET_FILTER', () => {
     it('should update the filter', async () => {
       await engine.dispatch([SET_FILTER.create({ filter: 'completed' })]);
-      
+
       expect(engine.getContext().filter).toBe('completed');
     });
   });
@@ -572,10 +566,18 @@ todos.subscribe({}, (items) => {
 ### 4. Sync Status
 
 ```typescript
-db.on('sync:start', () => { /* ... */ });
-db.on('sync:complete', () => { /* ... */ });
-db.on('online', () => { /* ... */ });
-db.on('offline', () => { /* ... */ });
+db.on('sync:start', () => {
+  /* ... */
+});
+db.on('sync:complete', () => {
+  /* ... */
+});
+db.on('online', () => {
+  /* ... */
+});
+db.on('offline', () => {
+  /* ... */
+});
 ```
 
 ## Next Steps

package/package.json

@@ -1,96 +1,132 @@
-{
-  "name": "@plures/praxis",
-  "version": "1.0.2",
-  "description": "The Full Plures Application Framework - declarative schemas, logic engine, component generation, and local-first data",
-  "type": "module",
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
-  "bin": {
-    "praxis": "./dist/src/cli/index.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/src/index.d.ts",
-      "default": "./dist/src/index.js"
-    },
-    "./svelte": {
-      "types": "./dist/src/integrations/svelte.d.ts",
-      "default": "./dist/src/integrations/svelte.js"
-    },
-    "./schema": {
-      "types": "./dist/core/schema-engine/types.d.ts",
-      "default": "./dist/core/schema-engine/types.js"
-    },
-    "./component": {
-      "types": "./dist/ui/svelte-generator/index.d.ts",
-      "default": "./dist/ui/svelte-generator/index.js"
-    },
-    "./cloud": {
-      "types": "./dist/src/cloud/index.d.ts",
-      "default": "./dist/src/cloud/index.js"
-    },
-    "./components": {
-      "types": "./dist/src/components/index.d.ts",
-      "svelte": "./src/components/TerminalNode.svelte"
-    }
-  },
-  "files": [
-    "dist",
-    "src",
-    "core",
-    "cli",
-    "templates",
-    "docs",
-    "README.md",
-    "FRAMEWORK.md",
-    "src/components"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "typecheck": "tsc --noEmit",
-    "cli": "node ./dist/src/cli/index.js"
-  },
-  "keywords": [
-    "praxis",
-    "framework",
-    "plures",
-    "logic",
-    "schema",
-    "component-generation",
-    "local-first",
-    "functional",
-    "typescript",
-    "state-management",
-    "facts",
-    "rules",
-    "constraints",
-    "orchestration",
-    "canvas",
-    "visual-development"
-  ],
-  "author": "Plures",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24.10.1",
-    "@vitest/ui": "^4.0.10",
-    "tsx": "^4.20.6",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.10"
-  },
-  "dependencies": {
-    "commander": "^14.0.2",
-    "js-yaml": "^4.1.1"
-  },
-  "peerDependencies": {
-    "svelte": "^5.0.0"
-  },
-  "peerDependenciesMeta": {
-    "svelte": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "@plures/praxis",
+  "version": "1.1.0",
+  "description": "The Full Plures Application Framework - declarative schemas, logic engine, component generation, and local-first data",
+  "type": "module",
+  "main": "./dist/node/index.js",
+  "types": "./dist/node/index.d.ts",
+  "bin": {
+    "praxis": "./dist/node/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "node": {
+        "types": "./dist/node/index.d.ts",
+        "import": "./dist/node/index.js",
+        "require": "./dist/node/index.cjs"
+      },
+      "browser": {
+        "types": "./dist/browser/index.d.ts",
+        "import": "./dist/browser/index.js"
+      },
+      "default": "./dist/node/index.js"
+    },
+    "./svelte": {
+      "node": {
+        "types": "./dist/node/integrations/svelte.d.ts",
+        "import": "./dist/node/integrations/svelte.js",
+        "require": "./dist/node/integrations/svelte.cjs"
+      },
+      "browser": {
+        "types": "./dist/browser/integrations/svelte.d.ts",
+        "import": "./dist/browser/integrations/svelte.js"
+      },
+      "default": "./dist/node/integrations/svelte.js"
+    },
+    "./schema": {
+      "types": "./dist/node/schema.d.ts",
+      "import": "./dist/node/schema.js",
+      "require": "./dist/node/schema.cjs",
+      "default": "./dist/node/schema.js"
+    },
+    "./component": {
+      "types": "./dist/node/component.d.ts",
+      "import": "./dist/node/component.js",
+      "require": "./dist/node/component.cjs",
+      "default": "./dist/node/component.js"
+    },
+    "./cloud": {
+      "types": "./dist/node/cloud/index.d.ts",
+      "import": "./dist/node/cloud/index.js",
+      "require": "./dist/node/cloud/index.cjs",
+      "default": "./dist/node/cloud/index.js"
+    },
+    "./components": {
+      "types": "./dist/node/components/index.d.ts",
+      "svelte": "./src/components/TerminalNode.svelte",
+      "import": "./dist/node/components/index.js",
+      "require": "./dist/node/components/index.cjs",
+      "default": "./dist/node/components/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "core",
+    "cli",
+    "templates",
+    "docs",
+    "README.md",
+    "FRAMEWORK.md",
+    "src/components",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "typecheck": "tsc --noEmit",
+    "cli": "node ./dist/src/cli/index.js"
+  },
+  "keywords": [
+    "praxis",
+    "framework",
+    "plures",
+    "logic",
+    "schema",
+    "component-generation",
+    "local-first",
+    "functional",
+    "typescript",
+    "state-management",
+    "facts",
+    "rules",
+    "constraints",
+    "orchestration",
+    "canvas",
+    "visual-development"
+  ],
+  "author": "Plures",
+  "license": "MIT",
+  "devDependencies": {
+    "@sveltejs/vite-plugin-svelte": "^6.2.1",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.0.1",
+    "@types/ws": "^8.18.1",
+    "@vitest/ui": "^4.0.15",
+    "esbuild-svelte": "^0.9.4",
+    "svelte": "^5.46.0",
+    "svelte-preprocess": "^6.0.3",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.7",
+    "vitest": "^4.0.15"
+  },
+  "dependencies": {
+    "commander": "^14.0.2",
+    "js-yaml": "^4.1.1"
+  },
+  "peerDependencies": {
+    "svelte": "^5.46.0"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}