@plures/praxis 1.0.2 → 1.1.0

package/dist/{src/core/schema/types.d.ts → node/schema.d.cts}

@@ -6,7 +6,7 @@
 /**
  * Base schema definition
  */
-export interface PraxisSchema {
+interface PraxisSchema {
     /** Schema version (semver) */
     version: string;
     /** Schema name/identifier */
@@ -27,7 +27,7 @@ export interface PraxisSchema {
 /**
  * Model definition for data structures
  */
-export interface ModelDefinition {
+interface ModelDefinition {
     /** Model name */
     name: string;
     /** Model description */
@@ -44,7 +44,7 @@ export interface ModelDefinition {
 /**
  * Field definition within a model
  */
-export interface FieldDefinition {
+interface FieldDefinition {
     /** Field name */
     name: string;
     /** Field type */
@@ -61,7 +61,7 @@ export interface FieldDefinition {
 /**
  * Supported field types
  */
-export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'reference' | {
+type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'reference' | {
     array: FieldType;
 } | {
     object: Record<string, FieldDefinition>;
@@ -71,7 +71,7 @@ export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'ob
 /**
  * Validation rule for a field
  */
-export interface ValidationRule {
+interface ValidationRule {
     /** Validation type */
     type: 'required' | 'min' | 'max' | 'pattern' | 'custom';
     /** Validation value */
@@ -82,7 +82,7 @@ export interface ValidationRule {
 /**
  * Constraint definition for models
  */
-export interface ConstraintDefinition {
+interface ConstraintDefinition {
     /** Constraint identifier */
     id: string;
     /** Constraint description */
@@ -97,7 +97,7 @@ export interface ConstraintDefinition {
 /**
  * Index definition for queries
  */
-export interface IndexDefinition {
+interface IndexDefinition {
     /** Index name */
     name: string;
     /** Indexed fields */
@@ -110,7 +110,7 @@ export interface IndexDefinition {
 /**
  * Relationship definition between models
  */
-export interface RelationshipDefinition {
+interface RelationshipDefinition {
     /** Relationship name */
     name: string;
     /** Relationship type */
@@ -125,7 +125,7 @@ export interface RelationshipDefinition {
 /**
  * Component definition for UI
  */
-export interface ComponentDefinition {
+interface ComponentDefinition {
     /** Component name */
     name: string;
     /** Component type */
@@ -146,7 +146,7 @@ export interface ComponentDefinition {
 /**
  * Component property definition
  */
-export interface ComponentProp {
+interface ComponentProp {
     /** Property name */
     name: string;
     /** Property type */
@@ -161,7 +161,7 @@ export interface ComponentProp {
 /**
  * Component event definition
  */
-export interface ComponentEvent {
+interface ComponentEvent {
     /** Event name */
     name: string;
     /** Event payload type */
@@ -172,7 +172,7 @@ export interface ComponentEvent {
 /**
  * Layout definition for components
  */
-export interface LayoutDefinition {
+interface LayoutDefinition {
     /** Layout type */
     type: 'stack' | 'grid' | 'flex' | 'absolute';
     /** Layout direction */
@@ -187,7 +187,7 @@ export interface LayoutDefinition {
 /**
  * Styling definition for components
  */
-export interface StylingDefinition {
+interface StylingDefinition {
     /** CSS classes */
     classes?: string[];
     /** Inline styles */
@@ -198,7 +198,7 @@ export interface StylingDefinition {
 /**
  * Logic definition for business rules
  */
-export interface LogicDefinition {
+interface LogicDefinition {
     /** Logic identifier */
     id: string;
     /** Logic description */
@@ -215,7 +215,7 @@ export interface LogicDefinition {
 /**
  * Fact definition
  */
-export interface FactDefinition {
+interface FactDefinition {
     /** Fact tag */
     tag: string;
     /** Fact payload type */
@@ -226,7 +226,7 @@ export interface FactDefinition {
 /**
  * Event definition
  */
-export interface EventDefinition {
+interface EventDefinition {
     /** Event tag */
     tag: string;
     /** Event payload type */
@@ -237,7 +237,7 @@ export interface EventDefinition {
 /**
  * Rule definition
  */
-export interface RuleDefinition {
+interface RuleDefinition {
     /** Rule identifier */
     id: string;
     /** Rule description */
@@ -254,7 +254,7 @@ export interface RuleDefinition {
 /**
  * Logic constraint definition
  */
-export interface LogicConstraint {
+interface LogicConstraint {
     /** Constraint identifier */
     id: string;
     /** Constraint description */
@@ -267,7 +267,7 @@ export interface LogicConstraint {
 /**
  * Orchestration definition
  */
-export interface OrchestrationDefinition {
+interface OrchestrationDefinition {
     /** Orchestration type */
     type: 'dsc' | 'mcp' | 'custom';
     /** Node configurations */
@@ -280,7 +280,7 @@ export interface OrchestrationDefinition {
 /**
  * Node definition for orchestration
  */
-export interface NodeDefinition {
+interface NodeDefinition {
     /** Node identifier */
     id: string;
     /** Node type */
@@ -298,7 +298,7 @@ export interface NodeDefinition {
 /**
  * Node bindings for pluresdb path connections
  */
-export interface NodeBindings {
+interface NodeBindings {
     /** Output binding to pluresdb path */
     output?: string;
     /** Input binding to pluresdb path */
@@ -309,7 +309,7 @@ export interface NodeBindings {
 /**
  * Terminal node specific configuration
  */
-export interface TerminalNodeProps {
+interface TerminalNodeProps {
     /** Input mode: text input or widget-based */
     inputMode: 'text' | 'widget';
     /** Command history */
@@ -320,7 +320,7 @@ export interface TerminalNodeProps {
 /**
  * Sync definition for state synchronization
  */
-export interface SyncDefinition {
+interface SyncDefinition {
     /** Sync interval in ms */
     interval: number;
     /** Conflict resolution strategy */
@@ -331,7 +331,7 @@ export interface SyncDefinition {
 /**
  * Health check definition
  */
-export interface HealthDefinition {
+interface HealthDefinition {
     /** Check interval in ms */
     interval: number;
     /** Health check endpoints */
@@ -342,7 +342,7 @@ export interface HealthDefinition {
 /**
  * Schema validation result
  */
-export interface ValidationResult {
+interface ValidationResult {
     /** Validation success */
     valid: boolean;
     /** Validation errors */
@@ -351,7 +351,7 @@ export interface ValidationResult {
 /**
  * Validation error
  */
-export interface ValidationError {
+interface ValidationError {
     /** Error path in schema */
     path: string;
     /** Error message */
@@ -362,9 +362,10 @@ export interface ValidationError {
 /**
  * Validate a Praxis schema
  */
-export declare function validateSchema(schema: PraxisSchema): ValidationResult;
+declare function validateSchema(schema: PraxisSchema): ValidationResult;
 /**
  * Create a basic schema template
  */
-export declare function createSchemaTemplate(name: string): PraxisSchema;
-//# sourceMappingURL=types.d.ts.map
+declare function createSchemaTemplate(name: string): PraxisSchema;
+
+export { type ComponentDefinition, type ComponentEvent, type ComponentProp, type ConstraintDefinition, type EventDefinition, type FactDefinition, type FieldDefinition, type FieldType, type HealthDefinition, type IndexDefinition, type LayoutDefinition, type LogicConstraint, type LogicDefinition, type ModelDefinition, type NodeBindings, type NodeDefinition, type OrchestrationDefinition, type PraxisSchema, type RelationshipDefinition, type RuleDefinition, type StylingDefinition, type SyncDefinition, type TerminalNodeProps, type ValidationError, type ValidationResult, type ValidationRule, createSchemaTemplate, validateSchema };

package/dist/node/schema.d.ts

@@ -0,0 +1,371 @@
+/**
+ * Praxis Schema System
+ *
+ * Declarative schema definitions for generating models, components, logic, and documentation.
+ */
+/**
+ * Base schema definition
+ */
+interface PraxisSchema {
+    /** Schema version (semver) */
+    version: string;
+    /** Schema name/identifier */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Data models */
+    models?: ModelDefinition[];
+    /** UI components */
+    components?: ComponentDefinition[];
+    /** Logic definitions */
+    logic?: LogicDefinition[];
+    /** Orchestration configuration */
+    orchestration?: OrchestrationDefinition;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Model definition for data structures
+ */
+interface ModelDefinition {
+    /** Model name */
+    name: string;
+    /** Model description */
+    description?: string;
+    /** Model fields */
+    fields: FieldDefinition[];
+    /** Validation constraints */
+    constraints?: ConstraintDefinition[];
+    /** Indexes for queries */
+    indexes?: IndexDefinition[];
+    /** Relationships to other models */
+    relationships?: RelationshipDefinition[];
+}
+/**
+ * Field definition within a model
+ */
+interface FieldDefinition {
+    /** Field name */
+    name: string;
+    /** Field type */
+    type: FieldType;
+    /** Optional field */
+    optional?: boolean;
+    /** Default value */
+    default?: unknown;
+    /** Field description */
+    description?: string;
+    /** Validation rules */
+    validation?: ValidationRule[];
+}
+/**
+ * Supported field types
+ */
+type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'reference' | {
+    array: FieldType;
+} | {
+    object: Record<string, FieldDefinition>;
+} | {
+    reference: string;
+};
+/**
+ * Validation rule for a field
+ */
+interface ValidationRule {
+    /** Validation type */
+    type: 'required' | 'min' | 'max' | 'pattern' | 'custom';
+    /** Validation value */
+    value?: unknown;
+    /** Error message */
+    message?: string;
+}
+/**
+ * Constraint definition for models
+ */
+interface ConstraintDefinition {
+    /** Constraint identifier */
+    id: string;
+    /** Constraint description */
+    description: string;
+    /** Constraint type */
+    type: 'unique' | 'check' | 'foreign_key';
+    /** Constraint fields */
+    fields: string[];
+    /** Additional constraint options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Index definition for queries
+ */
+interface IndexDefinition {
+    /** Index name */
+    name: string;
+    /** Indexed fields */
+    fields: string[];
+    /** Unique index */
+    unique?: boolean;
+    /** Index type */
+    type?: 'btree' | 'hash' | 'fulltext';
+}
+/**
+ * Relationship definition between models
+ */
+interface RelationshipDefinition {
+    /** Relationship name */
+    name: string;
+    /** Relationship type */
+    type: 'one-to-one' | 'one-to-many' | 'many-to-many';
+    /** Target model */
+    target: string;
+    /** Foreign key field */
+    foreignKey?: string;
+    /** Cascade delete */
+    cascadeDelete?: boolean;
+}
+/**
+ * Component definition for UI
+ */
+interface ComponentDefinition {
+    /** Component name */
+    name: string;
+    /** Component type */
+    type: 'form' | 'display' | 'list' | 'navigation' | 'custom';
+    /** Component description */
+    description?: string;
+    /** Model binding */
+    model?: string;
+    /** Component properties */
+    props?: ComponentProp[];
+    /** Component events */
+    events?: ComponentEvent[];
+    /** Component layout */
+    layout?: LayoutDefinition;
+    /** Component styling */
+    styling?: StylingDefinition;
+}
+/**
+ * Component property definition
+ */
+interface ComponentProp {
+    /** Property name */
+    name: string;
+    /** Property type */
+    type: string;
+    /** Required property */
+    required?: boolean;
+    /** Default value */
+    default?: unknown;
+    /** Property description */
+    description?: string;
+}
+/**
+ * Component event definition
+ */
+interface ComponentEvent {
+    /** Event name */
+    name: string;
+    /** Event payload type */
+    payload?: string;
+    /** Event description */
+    description?: string;
+}
+/**
+ * Layout definition for components
+ */
+interface LayoutDefinition {
+    /** Layout type */
+    type: 'stack' | 'grid' | 'flex' | 'absolute';
+    /** Layout direction */
+    direction?: 'horizontal' | 'vertical';
+    /** Layout gap */
+    gap?: number;
+    /** Layout padding */
+    padding?: number;
+    /** Layout alignment */
+    alignment?: string;
+}
+/**
+ * Styling definition for components
+ */
+interface StylingDefinition {
+    /** CSS classes */
+    classes?: string[];
+    /** Inline styles */
+    styles?: Record<string, string>;
+    /** Theme tokens */
+    theme?: Record<string, string>;
+}
+/**
+ * Logic definition for business rules
+ */
+interface LogicDefinition {
+    /** Logic identifier */
+    id: string;
+    /** Logic description */
+    description: string;
+    /** Facts definitions */
+    facts?: FactDefinition[];
+    /** Events definitions */
+    events?: EventDefinition[];
+    /** Rules definitions */
+    rules?: RuleDefinition[];
+    /** Constraints definitions */
+    constraints?: LogicConstraint[];
+}
+/**
+ * Fact definition
+ */
+interface FactDefinition {
+    /** Fact tag */
+    tag: string;
+    /** Fact payload type */
+    payload: Record<string, string>;
+    /** Fact description */
+    description?: string;
+}
+/**
+ * Event definition
+ */
+interface EventDefinition {
+    /** Event tag */
+    tag: string;
+    /** Event payload type */
+    payload: Record<string, string>;
+    /** Event description */
+    description?: string;
+}
+/**
+ * Rule definition
+ */
+interface RuleDefinition {
+    /** Rule identifier */
+    id: string;
+    /** Rule description */
+    description: string;
+    /** Input events */
+    on?: string[];
+    /** Rule condition */
+    when?: string;
+    /** Rule action */
+    then: string;
+    /** Rule priority */
+    priority?: number;
+}
+/**
+ * Logic constraint definition
+ */
+interface LogicConstraint {
+    /** Constraint identifier */
+    id: string;
+    /** Constraint description */
+    description: string;
+    /** Constraint check */
+    check: string;
+    /** Error message */
+    message: string;
+}
+/**
+ * Orchestration definition
+ */
+interface OrchestrationDefinition {
+    /** Orchestration type */
+    type: 'dsc' | 'mcp' | 'custom';
+    /** Node configurations */
+    nodes?: NodeDefinition[];
+    /** State synchronization */
+    sync?: SyncDefinition;
+    /** Health checks */
+    health?: HealthDefinition;
+}
+/**
+ * Node definition for orchestration
+ */
+interface NodeDefinition {
+    /** Node identifier */
+    id: string;
+    /** Node type */
+    type: string;
+    /** Node configuration */
+    config: Record<string, unknown>;
+    /** Node position (x, y coordinates for canvas) */
+    x?: number;
+    y?: number;
+    /** Node props (type-specific properties) */
+    props?: Record<string, unknown>;
+    /** Node bindings (connections to pluresdb paths) */
+    bindings?: NodeBindings;
+}
+/**
+ * Node bindings for pluresdb path connections
+ */
+interface NodeBindings {
+    /** Output binding to pluresdb path */
+    output?: string;
+    /** Input binding to pluresdb path */
+    input?: string;
+    /** Additional custom bindings */
+    [key: string]: string | undefined;
+}
+/**
+ * Terminal node specific configuration
+ */
+interface TerminalNodeProps {
+    /** Input mode: text input or widget-based */
+    inputMode: 'text' | 'widget';
+    /** Command history */
+    history: string[];
+    /** Last command output */
+    lastOutput: string | null;
+}
+/**
+ * Sync definition for state synchronization
+ */
+interface SyncDefinition {
+    /** Sync interval in ms */
+    interval: number;
+    /** Conflict resolution strategy */
+    conflictResolution: 'last-write-wins' | 'merge' | 'custom';
+    /** Sync targets */
+    targets: string[];
+}
+/**
+ * Health check definition
+ */
+interface HealthDefinition {
+    /** Check interval in ms */
+    interval: number;
+    /** Health check endpoints */
+    endpoints: string[];
+    /** Timeout in ms */
+    timeout: number;
+}
+/**
+ * Schema validation result
+ */
+interface ValidationResult {
+    /** Validation success */
+    valid: boolean;
+    /** Validation errors */
+    errors: ValidationError[];
+}
+/**
+ * Validation error
+ */
+interface ValidationError {
+    /** Error path in schema */
+    path: string;
+    /** Error message */
+    message: string;
+    /** Error code */
+    code?: string;
+}
+/**
+ * Validate a Praxis schema
+ */
+declare function validateSchema(schema: PraxisSchema): ValidationResult;
+/**
+ * Create a basic schema template
+ */
+declare function createSchemaTemplate(name: string): PraxisSchema;
+
+export { type ComponentDefinition, type ComponentEvent, type ComponentProp, type ConstraintDefinition, type EventDefinition, type FactDefinition, type FieldDefinition, type FieldType, type HealthDefinition, type IndexDefinition, type LayoutDefinition, type LogicConstraint, type LogicDefinition, type ModelDefinition, type NodeBindings, type NodeDefinition, type OrchestrationDefinition, type PraxisSchema, type RelationshipDefinition, type RuleDefinition, type StylingDefinition, type SyncDefinition, type TerminalNodeProps, type ValidationError, type ValidationResult, type ValidationRule, createSchemaTemplate, validateSchema };

package/dist/node/schema.js

@@ -0,0 +1,9 @@
+import {
+  createSchemaTemplate,
+  validateSchema
+} from "./chunk-UATVJBNV.js";
+import "./chunk-QGM4M3NI.js";
+export {
+  createSchemaTemplate,
+  validateSchema
+};