@plures/praxis 0.2.0

package/dist/core/schema/normalize.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Praxis Schema Normalizer
+ *
+ * Expands and normalizes schema definitions for code generation.
+ */
+import type { PraxisSchema, ModelDefinition, ComponentDefinition, LogicDefinition, FieldDefinition } from './types.js';
+/**
+ * Normalized schema with expanded and validated definitions
+ */
+export interface NormalizedSchema extends PraxisSchema {
+    /** Normalized models with expanded references */
+    models: NormalizedModel[];
+    /** Normalized components */
+    components: NormalizedComponent[];
+    /** Normalized logic */
+    logic: NormalizedLogic[];
+}
+/**
+ * Normalized model definition
+ */
+export interface NormalizedModel extends ModelDefinition {
+    /** Fully qualified name */
+    fullName: string;
+    /** All fields including inherited ones */
+    allFields: FieldDefinition[];
+    /** Model dependencies */
+    dependencies: string[];
+}
+/**
+ * Normalized component definition
+ */
+export interface NormalizedComponent extends ComponentDefinition {
+    /** Fully qualified name */
+    fullName: string;
+    /** Resolved model reference */
+    resolvedModel?: NormalizedModel;
+}
+/**
+ * Normalized logic definition
+ */
+export interface NormalizedLogic extends LogicDefinition {
+    /** Fully qualified identifier */
+    fullId: string;
+}
+/**
+ * Normalization options
+ */
+export interface NormalizationOptions {
+    /** Schema name prefix for fully qualified names */
+    schemaPrefix?: string;
+    /** Expand all field references */
+    expandReferences?: boolean;
+    /** Include computed metadata */
+    includeMetadata?: boolean;
+}
+/**
+ * Normalize a Praxis schema for code generation
+ */
+export declare function normalizeSchema(schema: PraxisSchema, options?: NormalizationOptions): NormalizedSchema;
+/**
+ * Expand field type to fully qualified type string
+ */
+export declare function expandFieldType(fieldType: any, schemaPrefix?: string): string;
+/**
+ * Generate TypeScript type from field type
+ */
+export declare function fieldTypeToTypeScript(fieldType: any): string;
+/**
+ * Sort models by dependency order (models with no dependencies first)
+ */
+export declare function sortModelsByDependencies(models: NormalizedModel[]): NormalizedModel[];
+//# sourceMappingURL=normalize.d.ts.map

package/dist/core/schema/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/core/schema/normalize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,iDAAiD;IACjD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,uBAAuB;IACvB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,yBAAyB;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gCAAgC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,oBAAyB,GACjC,gBAAgB,CAoClB;AA0FD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,GAAG,EACd,YAAY,GAAE,MAAW,GACxB,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,CA2C5D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EAAE,GACxB,eAAe,EAAE,CAsCnB"}

package/dist/core/schema/normalize.js

@@ -0,0 +1,190 @@
+/**
+ * Praxis Schema Normalizer
+ *
+ * Expands and normalizes schema definitions for code generation.
+ */
+/**
+ * Normalize a Praxis schema for code generation
+ */
+export function normalizeSchema(schema, options = {}) {
+    const schemaPrefix = options.schemaPrefix || schema.name;
+    // Normalize models
+    const normalizedModels = normalizeModels(schema.models || [], schemaPrefix, options);
+    // Create model lookup map
+    const modelMap = new Map(normalizedModels.map((model) => [model.name, model]));
+    // Normalize components
+    const normalizedComponents = normalizeComponents(schema.components || [], schemaPrefix, modelMap, options);
+    // Normalize logic
+    const normalizedLogic = normalizeLogic(schema.logic || [], schemaPrefix, options);
+    return {
+        ...schema,
+        models: normalizedModels,
+        components: normalizedComponents,
+        logic: normalizedLogic,
+    };
+}
+/**
+ * Normalize model definitions
+ */
+function normalizeModels(models, schemaPrefix, _options) {
+    return models.map((model) => {
+        const fullName = `${schemaPrefix}.${model.name}`;
+        const dependencies = extractModelDependencies(model);
+        // For now, allFields is the same as fields
+        // In the future, this could include inherited fields
+        const allFields = [...model.fields];
+        return {
+            ...model,
+            fullName,
+            allFields,
+            dependencies,
+        };
+    });
+}
+/**
+ * Extract model dependencies from field references
+ */
+function extractModelDependencies(model) {
+    const dependencies = new Set();
+    for (const field of model.fields) {
+        if (typeof field.type === 'object' && 'reference' in field.type) {
+            dependencies.add(field.type.reference);
+        }
+    }
+    // Add relationship dependencies
+    if (model.relationships) {
+        for (const rel of model.relationships) {
+            dependencies.add(rel.target);
+        }
+    }
+    return Array.from(dependencies);
+}
+/**
+ * Normalize component definitions
+ */
+function normalizeComponents(components, schemaPrefix, modelMap, _options) {
+    return components.map((component) => {
+        const fullName = `${schemaPrefix}.${component.name}`;
+        const resolvedModel = component.model
+            ? modelMap.get(component.model)
+            : undefined;
+        return {
+            ...component,
+            fullName,
+            resolvedModel,
+        };
+    });
+}
+/**
+ * Normalize logic definitions
+ */
+function normalizeLogic(logic, schemaPrefix, _options) {
+    return logic.map((logicDef) => {
+        const fullId = `${schemaPrefix}.${logicDef.id}`;
+        return {
+            ...logicDef,
+            fullId,
+        };
+    });
+}
+/**
+ * Expand field type to fully qualified type string
+ */
+export function expandFieldType(fieldType, schemaPrefix = '') {
+    if (typeof fieldType === 'string') {
+        return fieldType;
+    }
+    if (typeof fieldType === 'object') {
+        if ('array' in fieldType) {
+            const innerType = expandFieldType(fieldType.array, schemaPrefix);
+            return `${innerType}[]`;
+        }
+        if ('object' in fieldType) {
+            return 'object';
+        }
+        if ('reference' in fieldType) {
+            const refName = fieldType.reference;
+            return schemaPrefix ? `${schemaPrefix}.${refName}` : refName;
+        }
+    }
+    return 'unknown';
+}
+/**
+ * Generate TypeScript type from field type
+ */
+export function fieldTypeToTypeScript(fieldType) {
+    if (typeof fieldType === 'string') {
+        switch (fieldType) {
+            case 'string':
+                return 'string';
+            case 'number':
+                return 'number';
+            case 'boolean':
+                return 'boolean';
+            case 'date':
+                return 'Date';
+            case 'array':
+                return 'unknown[]';
+            case 'object':
+                return 'Record<string, unknown>';
+            default:
+                return 'unknown';
+        }
+    }
+    if (typeof fieldType === 'object') {
+        if ('array' in fieldType) {
+            const innerType = fieldTypeToTypeScript(fieldType.array);
+            return `${innerType}[]`;
+        }
+        if ('object' in fieldType) {
+            const fields = fieldType.object;
+            const fieldTypes = Object.entries(fields)
+                .map(([key, field]) => {
+                const type = fieldTypeToTypeScript(field.type || field);
+                return `${key}: ${type}`;
+            })
+                .join('; ');
+            return `{ ${fieldTypes} }`;
+        }
+        if ('reference' in fieldType) {
+            return fieldType.reference;
+        }
+    }
+    return 'unknown';
+}
+/**
+ * Sort models by dependency order (models with no dependencies first)
+ */
+export function sortModelsByDependencies(models) {
+    const sorted = [];
+    const visited = new Set();
+    const visiting = new Set();
+    function visit(model) {
+        if (visited.has(model.name)) {
+            return;
+        }
+        if (visiting.has(model.name)) {
+            // Circular dependency detected, just add it
+            visiting.delete(model.name);
+            sorted.push(model);
+            visited.add(model.name);
+            return;
+        }
+        visiting.add(model.name);
+        // Visit dependencies first
+        for (const depName of model.dependencies) {
+            const dep = models.find((m) => m.name === depName);
+            if (dep) {
+                visit(dep);
+            }
+        }
+        visiting.delete(model.name);
+        visited.add(model.name);
+        sorted.push(model);
+    }
+    for (const model of models) {
+        visit(model);
+    }
+    return sorted;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/core/schema/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/core/schema/normalize.ts"],"names":[],"mappings":"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"}

package/dist/core/schema/types.d.ts

@@ -0,0 +1,370 @@
+/**
+ * Praxis Schema System
+ *
+ * Declarative schema definitions for generating models, components, logic, and documentation.
+ */
+/**
+ * Base schema definition
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'reference' | {
+    array: FieldType;
+} | {
+    object: Record<string, FieldDefinition>;
+} | {
+    reference: string;
+};
+/**
+ * Validation rule for a field
+ */
+export interface ValidationRule {
+    /** Validation type */
+    type: 'required' | 'min' | 'max' | 'pattern' | 'custom';
+    /** Validation value */
+    value?: unknown;
+    /** Error message */
+    message?: string;
+}
+/**
+ * Constraint definition for models
+ */
+export 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
+ */
+export interface IndexDefinition {
+    /** Index name */
+    name: string;
+    /** Indexed fields */
+    fields: string[];
+    /** Unique index */
+    unique?: boolean;
+    /** Index type */
+    type?: 'btree' | 'hash' | 'fulltext';
+}
+/**
+ * Relationship definition between models
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export interface ComponentEvent {
+    /** Event name */
+    name: string;
+    /** Event payload type */
+    payload?: string;
+    /** Event description */
+    description?: string;
+}
+/**
+ * Layout definition for components
+ */
+export 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
+ */
+export interface StylingDefinition {
+    /** CSS classes */
+    classes?: string[];
+    /** Inline styles */
+    styles?: Record<string, string>;
+    /** Theme tokens */
+    theme?: Record<string, string>;
+}
+/**
+ * Logic definition for business rules
+ */
+export 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
+ */
+export interface FactDefinition {
+    /** Fact tag */
+    tag: string;
+    /** Fact payload type */
+    payload: Record<string, string>;
+    /** Fact description */
+    description?: string;
+}
+/**
+ * Event definition
+ */
+export interface EventDefinition {
+    /** Event tag */
+    tag: string;
+    /** Event payload type */
+    payload: Record<string, string>;
+    /** Event description */
+    description?: string;
+}
+/**
+ * Rule definition
+ */
+export 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
+ */
+export interface LogicConstraint {
+    /** Constraint identifier */
+    id: string;
+    /** Constraint description */
+    description: string;
+    /** Constraint check */
+    check: string;
+    /** Error message */
+    message: string;
+}
+/**
+ * Orchestration definition
+ */
+export interface OrchestrationDefinition {
+    /** Orchestration type */
+    type: 'dsc' | 'mcp' | 'custom';
+    /** Node configurations */
+    nodes?: NodeDefinition[];
+    /** State synchronization */
+    sync?: SyncDefinition;
+    /** Health checks */
+    health?: HealthDefinition;
+}
+/**
+ * Node definition for orchestration
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export interface SyncDefinition {
+    /** Sync interval in ms */
+    interval: number;
+    /** Conflict resolution strategy */
+    conflictResolution: 'last-write-wins' | 'merge' | 'custom';
+    /** Sync targets */
+    targets: string[];
+}
+/**
+ * Health check definition
+ */
+export interface HealthDefinition {
+    /** Check interval in ms */
+    interval: number;
+    /** Health check endpoints */
+    endpoints: string[];
+    /** Timeout in ms */
+    timeout: number;
+}
+/**
+ * Schema validation result
+ */
+export interface ValidationResult {
+    /** Validation success */
+    valid: boolean;
+    /** Validation errors */
+    errors: ValidationError[];
+}
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    /** Error path in schema */
+    path: string;
+    /** Error message */
+    message: string;
+    /** Error code */
+    code?: string;
+}
+/**
+ * Validate a Praxis schema
+ */
+export declare function validateSchema(schema: PraxisSchema): ValidationResult;
+/**
+ * Create a basic schema template
+ */
+export declare function createSchemaTemplate(name: string): PraxisSchema;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/schema/types.d.ts.map

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