@plures/praxis 1.0.2 → 1.1.0

package/templates/basic-app/README.md

@@ -56,7 +56,7 @@ export const appSchema: PraxisSchema = {
   version: '1.0.0',
   name: 'MyApp',
   description: 'My Praxis application',
-  
+
   models: [
     {
       name: 'User',
@@ -67,7 +67,7 @@ export const appSchema: PraxisSchema = {
       ],
     },
   ],
-  
+
   components: [
     {
       name: 'UserForm',
@@ -75,17 +75,13 @@ export const appSchema: PraxisSchema = {
       model: 'User',
     },
   ],
-  
+
   logic: [
     {
       id: 'user-logic',
       description: 'User management logic',
-      events: [
-        { tag: 'USER_CREATE', payload: { name: 'string', email: 'string' } },
-      ],
-      facts: [
-        { tag: 'UserCreated', payload: { userId: 'string' } },
-      ],
+      events: [{ tag: 'USER_CREATE', payload: { name: 'string', email: 'string' } }],
+      facts: [{ tag: 'UserCreated', payload: { userId: 'string' } }],
     },
   ],
 };
@@ -98,6 +94,7 @@ praxis generate --schema src/schemas/app.schema.ts
 ```
 
 This generates:
+
 - Svelte components in `src/components/`
 - Logic definitions in `src/logic/`
 - Type definitions throughout

package/templates/fullstack-app/README.md

@@ -79,6 +79,7 @@ export const features = {
 ### 3. Define schemas
 
 The template includes example schemas:
+
 - `auth.schema.ts` - User authentication and sessions
 - `data.schema.ts` - Application data models
 - `app.schema.ts` - Main application configuration
@@ -90,6 +91,7 @@ praxis generate --target all
 ```
 
 Generates:
+
 - Components from all schemas
 - Logic modules with facts, events, rules
 - PluresDB models
@@ -128,6 +130,7 @@ npm run build
 ### Authentication Module
 
 Pre-configured authentication with:
+
 - User registration and login
 - Session management
 - JWT tokens (optional)
@@ -137,6 +140,7 @@ Pre-configured authentication with:
 ### Data Module
 
 Example data models:
+
 - Users
 - Posts
 - Comments
@@ -145,6 +149,7 @@ Example data models:
 ### Canvas Integration
 
 Visual editing for:
+
 - Schema definitions
 - Logic flows
 - Component layouts
@@ -153,6 +158,7 @@ Visual editing for:
 ### Orchestration
 
 Distributed coordination:
+
 - Node configuration
 - State synchronization
 - Health monitoring
@@ -232,6 +238,7 @@ npm run build:mobile
 All documentation is automatically generated in `src/docs/` using State-Docs.
 
 To view:
+
 ```bash
 npm run docs
 ```
@@ -239,12 +246,14 @@ npm run docs
 ## Testing
 
 The template includes:
+
 - Unit tests for logic modules
 - Component tests
 - Integration tests
 - E2E test scaffolds
 
 Run all tests:
+
 ```bash
 npm test
 ```
@@ -252,6 +261,7 @@ npm test
 ## Monitoring
 
 Built-in monitoring with:
+
 - Performance metrics
 - Error tracking
 - User analytics (opt-in)

package/dist/core/codegen/docs-generator.d.ts

@@ -1,123 +0,0 @@
-/**
- * Documentation Generator
- *
- * Generates Markdown documentation from PSF schemas.
- * Produces API docs, architecture diagrams, and user guides.
- */
-import type { PSFSchema } from '../schema-engine/psf.js';
-/**
- * Documentation generator options
- */
-export interface DocsGeneratorOptions {
-    /** Output directory */
-    outputDir?: string;
-    /** Include Mermaid diagrams */
-    includeDiagrams?: boolean;
-    /** Include code examples */
-    includeExamples?: boolean;
-    /** Include API reference */
-    includeApiReference?: boolean;
-    /** Include table of contents */
-    includeToc?: boolean;
-    /** Document format */
-    format?: 'markdown' | 'html';
-}
-/**
- * Generated documentation file
- */
-export interface GeneratedDoc {
-    /** File path */
-    path: string;
-    /** File content */
-    content: string;
-    /** Document type */
-    type: 'overview' | 'api' | 'model' | 'component' | 'flow' | 'diagram' | 'index';
-}
-/**
- * Documentation generation result
- */
-export interface DocsGenerationResult {
-    success: boolean;
-    files: GeneratedDoc[];
-    errors: string[];
-}
-/**
- * Documentation Generator class
- */
-export declare class DocsGenerator {
-    private options;
-    constructor(options?: DocsGeneratorOptions);
-    /**
-     * Generate all documentation from schema
-     */
-    generate(schema: PSFSchema): DocsGenerationResult;
-    /**
-     * Generate overview document
-     */
-    private generateOverview;
-    /**
-     * Generate API reference
-     */
-    private generateApiReference;
-    /**
-     * Generate fact documentation
-     */
-    private generateFactDoc;
-    /**
-     * Generate event documentation
-     */
-    private generateEventDoc;
-    /**
-     * Generate rule documentation
-     */
-    private generateRuleDoc;
-    /**
-     * Generate constraint documentation
-     */
-    private generateConstraintDoc;
-    /**
-     * Generate models documentation
-     */
-    private generateModelsDoc;
-    /**
-     * Generate components documentation
-     */
-    private generateComponentsDoc;
-    /**
-     * Generate flows documentation
-     */
-    private generateFlowsDoc;
-    /**
-     * Generate Mermaid diagrams
-     */
-    private generateDiagrams;
-    /**
-     * Generate index document
-     */
-    private generateIndex;
-    /**
-     * Format field type for display
-     */
-    private formatFieldType;
-    /**
-     * Format field type simple (for Mermaid)
-     */
-    private formatFieldTypeSimple;
-    /**
-     * Get example value for type
-     */
-    private getExampleValue;
-    /**
-     * Sanitize ID for Mermaid
-     */
-    private sanitizeId;
-}
-/**
- * Create a docs generator
- */
-export declare function createDocsGenerator(options?: DocsGeneratorOptions): DocsGenerator;
-/**
- * Generate documentation from PSF schema (convenience function)
- */
-export declare function generateDocs(schema: PSFSchema, options?: DocsGeneratorOptions): DocsGenerationResult;
-//# sourceMappingURL=docs-generator.d.ts.map

package/dist/core/codegen/docs-generator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-generator.d.ts","sourceRoot":"","sources":["../../../core/codegen/docs-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EASV,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4BAA4B;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4BAA4B;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gCAAgC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CACjF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAiC;gBAEpC,OAAO,GAAE,oBAAyB;IAW9C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,oBAAoB;IA8CjD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8DxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsE5B;;OAEG;IACH,OAAO,CAAC,eAAe;IA+CvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+CxB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyDzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsDxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0FxB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4CrB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAEjF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CAGpG"}