@plures/praxis 1.0.2 → 1.1.0

package/dist/src/integrations/code-canvas.d.ts

@@ -1,265 +0,0 @@
-/**
- * CodeCanvas Integration
- *
- * Integration with plures/code-canvas - A visual schema editor and FSM enforcement tool.
- * Provides visual editing capabilities for Praxis schemas and logic flows.
- *
- * Features:
- * - Visual Schema Editor: Drag-and-drop interface for schema design
- * - FSM Visualization: Mermaid and DOT graph generation
- * - State Lifecycle Management: Activity tracking and validation
- * - Canvas Export/Import: YAML and JSON Canvas formats
- * - Guardian Integration: Pre-commit validation and rules enforcement
- *
- * @see https://github.com/plures/code-canvas
- */
-import type { PraxisSchema } from "../core/schema/types.js";
-/**
- * Canvas node representing a visual element
- */
-export interface CanvasNode {
-    /** Unique node identifier */
-    id: string;
-    /** Node type */
-    type: 'model' | 'component' | 'event' | 'fact' | 'rule' | 'constraint' | 'state' | 'transition';
-    /** Node label/name */
-    label: string;
-    /** X position */
-    x: number;
-    /** Y position */
-    y: number;
-    /** Width */
-    width: number;
-    /** Height */
-    height: number;
-    /** Node data (model, component, etc.) */
-    data?: unknown;
-    /** Node style */
-    style?: CanvasNodeStyle;
-    /** FSM state reference */
-    fsmState?: string;
-}
-/**
- * Canvas edge representing a connection between nodes
- */
-export interface CanvasEdge {
-    /** Unique edge identifier */
-    id: string;
-    /** Source node ID */
-    source: string;
-    /** Target node ID */
-    target: string;
-    /** Edge label */
-    label?: string;
-    /** Edge type */
-    type?: 'dependency' | 'transition' | 'trigger' | 'reference';
-    /** Edge style */
-    style?: CanvasEdgeStyle;
-}
-/**
- * Node style configuration
- */
-export interface CanvasNodeStyle {
-    /** Background color */
-    backgroundColor?: string;
-    /** Border color */
-    borderColor?: string;
-    /** Border width */
-    borderWidth?: number;
-    /** Text color */
-    textColor?: string;
-    /** Font size */
-    fontSize?: number;
-    /** Border radius */
-    borderRadius?: number;
-}
-/**
- * Edge style configuration
- */
-export interface CanvasEdgeStyle {
-    /** Stroke color */
-    strokeColor?: string;
-    /** Stroke width */
-    strokeWidth?: number;
-    /** Stroke style */
-    strokeDasharray?: string;
-    /** Arrow type */
-    arrowType?: 'arrow' | 'none' | 'circle';
-}
-/**
- * Canvas document containing nodes and edges
- */
-export interface CanvasDocument {
-    /** Document identifier */
-    id: string;
-    /** Document name */
-    name: string;
-    /** Document version */
-    version: string;
-    /** All nodes in the canvas */
-    nodes: CanvasNode[];
-    /** All edges in the canvas */
-    edges: CanvasEdge[];
-    /** Document metadata */
-    metadata?: {
-        created: number;
-        modified: number;
-        author?: string;
-        description?: string;
-    };
-    /** Viewport settings */
-    viewport?: {
-        x: number;
-        y: number;
-        zoom: number;
-    };
-}
-/**
- * FSM lifecycle state
- */
-export interface LifecycleState {
-    /** State identifier */
-    id: string;
-    /** State name */
-    name: string;
-    /** State description */
-    description?: string;
-    /** Allowed transitions from this state */
-    transitions: string[];
-    /** Entry actions */
-    onEntry?: string[];
-    /** Exit actions */
-    onExit?: string[];
-    /** Is this an initial state */
-    initial?: boolean;
-    /** Is this a final state */
-    final?: boolean;
-}
-/**
- * Activity tracking for current work context
- */
-export interface ActivityState {
-    /** Current activity type */
-    activity: 'designing' | 'implementing' | 'testing' | 'documenting' | 'reviewing';
-    /** Actor performing the activity */
-    actor: string;
-    /** Current intent/goal */
-    intent?: string;
-    /** Started timestamp */
-    startedAt: number;
-    /** Allowed file patterns for this activity */
-    allowedPaths?: string[];
-}
-/**
- * Canvas editor configuration
- */
-export interface CanvasEditorConfig {
-    /** Canvas document to edit */
-    document?: CanvasDocument;
-    /** Schema to visualize */
-    schema?: PraxisSchema;
-    /** Enable FSM validation */
-    enableFSM?: boolean;
-    /** Custom node styles by type */
-    nodeStyles?: Record<string, CanvasNodeStyle>;
-    /** Custom edge styles by type */
-    edgeStyles?: Record<string, CanvasEdgeStyle>;
-    /** Auto-layout algorithm */
-    layout?: 'hierarchical' | 'force' | 'grid' | 'circular';
-}
-/**
- * Guardian validation result
- */
-export interface GuardianResult {
-    /** Whether validation passed */
-    valid: boolean;
-    /** Validation errors */
-    errors: GuardianError[];
-    /** Validation warnings */
-    warnings: GuardianWarning[];
-    /** Files validated */
-    filesChecked: string[];
-    /** Current activity state */
-    activity?: ActivityState;
-}
-/**
- * Guardian validation error
- */
-export interface GuardianError {
-    /** Error code */
-    code: string;
-    /** Error message */
-    message: string;
-    /** File path (if applicable) */
-    file?: string;
-    /** Line number (if applicable) */
-    line?: number;
-    /** Rule that was violated */
-    rule?: string;
-}
-/**
- * Guardian validation warning
- */
-export interface GuardianWarning {
-    /** Warning code */
-    code: string;
-    /** Warning message */
-    message: string;
-    /** File path (if applicable) */
-    file?: string;
-    /** Suggestion for resolution */
-    suggestion?: string;
-}
-/**
- * Create a canvas document from a Praxis schema
- *
- * @example
- * ```typescript
- * import { schemaToCanvas } from '@plures/praxis/integrations/code-canvas';
- *
- * const canvas = schemaToCanvas(mySchema, {
- *   layout: 'hierarchical',
- * });
- *
- * // Export to YAML
- * const yaml = canvasToYaml(canvas);
- * ```
- */
-export declare function schemaToCanvas(schema: PraxisSchema, _options?: {
-    layout?: 'hierarchical' | 'force' | 'grid' | 'circular';
-}): CanvasDocument;
-/**
- * Convert a canvas document back to a Praxis schema
- */
-export declare function canvasToSchema(canvas: CanvasDocument): PraxisSchema;
-/**
- * Export canvas to YAML format (compatible with Obsidian Canvas)
- */
-export declare function canvasToYaml(canvas: CanvasDocument): string;
-/**
- * Export canvas to Mermaid diagram format
- */
-export declare function canvasToMermaid(canvas: CanvasDocument): string;
-/**
- * Validate files against FSM lifecycle rules
- *
- * This provides integration with the CodeCanvas Guardian for pre-commit validation.
- */
-export declare function validateWithGuardian(files: string[], activity: ActivityState, lifecycle: LifecycleState[]): GuardianResult;
-/**
- * Create a CodeCanvas editor instance
- *
- * Note: This is a placeholder for the visual editor integration.
- * The actual visual editor requires a browser environment.
- */
-export declare function createCanvasEditor(config: CanvasEditorConfig): {
-    document: CanvasDocument;
-    addNode: (node: Omit<CanvasNode, 'id'>) => CanvasNode;
-    removeNode: (id: string) => void;
-    addEdge: (edge: Omit<CanvasEdge, 'id'>) => CanvasEdge;
-    removeEdge: (id: string) => void;
-    toSchema: () => PraxisSchema;
-    toYaml: () => string;
-    toMermaid: () => string;
-};
-//# sourceMappingURL=code-canvas.d.ts.map

package/dist/src/integrations/code-canvas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"code-canvas.d.ts","sourceRoot":"","sources":["../../../src/integrations/code-canvas.ts"],"names":[],"mappings":"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"}