@plures/praxis 0.2.1 → 1.0.1

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

@@ -0,0 +1,265 @@
+/**
+ * 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

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