Phase 1: Add object-level validation engine and window function builder

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/core/src/query/query-ast.ts

@@ -1,6 +1,7 @@
 /**
  * ObjectUI - Query AST Builder
  * Phase 3.3: QuerySchema AST implementation
+ * ObjectStack Spec v0.7.1: Window functions support
  */
 
 import type {
@@ -15,6 +16,9 @@ import type {
   LimitNode,
   OffsetNode,
   AggregateNode,
+  WindowNode,
+  WindowFunction,
+  WindowFrame,
   FieldNode,
   LiteralNode,
   OperatorNode,
@@ -64,7 +68,7 @@ export class QueryASTBuilder {
   }
 
   private buildSelect(query: QuerySchema): SelectNode {
-    const fields: (FieldNode | AggregateNode)[] = [];
+    const fields: (FieldNode | AggregateNode | WindowNode)[] = [];
 
     if (query.fields && query.fields.length > 0) {
       fields.push(...query.fields.map(field => this.buildField(field)));
@@ -77,6 +81,9 @@ export class QueryASTBuilder {
       fields.push(...query.aggregations.map(agg => this.buildAggregation(agg)));
     }
 
+    // Add window functions if they exist (future extension point)
+    // query.windows?.forEach(win => fields.push(this.buildWindow(win)));
+
     return {
       type: 'select',
       fields,
@@ -279,6 +286,55 @@ export class QueryASTBuilder {
     };
   }
 
+  /**
+   * Build window function node (ObjectStack Spec v0.7.1)
+   */
+  private buildWindow(config: {
+    function: WindowFunction;
+    field?: string;
+    alias: string;
+    partitionBy?: string[];
+    orderBy?: Array<{ field: string; direction: 'asc' | 'desc' }>;
+    frame?: WindowFrame;
+    offset?: number;
+    defaultValue?: any;
+  }): WindowNode {
+    const node: WindowNode = {
+      type: 'window',
+      function: config.function,
+      alias: config.alias,
+    };
+
+    if (config.field) {
+      node.field = this.buildField(config.field);
+    }
+
+    if (config.partitionBy && config.partitionBy.length > 0) {
+      node.partitionBy = config.partitionBy.map(field => this.buildField(field));
+    }
+
+    if (config.orderBy && config.orderBy.length > 0) {
+      node.orderBy = config.orderBy.map(sort => ({
+        field: this.buildField(sort.field),
+        direction: sort.direction,
+      }));
+    }
+
+    if (config.frame) {
+      node.frame = config.frame;
+    }
+
+    if (config.offset !== undefined) {
+      node.offset = config.offset;
+    }
+
+    if (config.defaultValue !== undefined) {
+      node.defaultValue = this.buildLiteral(config.defaultValue);
+    }
+
+    return node;
+  }
+
   optimize(ast: QueryAST): QueryAST {
     return ast;
   }

packages/core/src/validation/index.ts

@@ -2,7 +2,9 @@
  * @object-ui/core - Validation Module
  * 
  * Phase 3.5: Validation engine
+ * ObjectStack Spec v0.7.1: Object-level validation
  */
 
 export * from './validation-engine';
 export * from './schema-validator';
+export * from './validators';

packages/core/src/validation/validators/index.ts

@@ -0,0 +1,25 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * @object-ui/core - Validators
+ * 
+ * ObjectStack Spec v0.7.1 compliant validators
+ * 
+ * @module validators
+ * @packageDocumentation
+ */
+
+export {
+  ObjectValidationEngine,
+  defaultObjectValidationEngine,
+  validateRecord,
+  type ObjectValidationContext,
+  type ObjectValidationResult,
+  type ValidationExpressionEvaluator,
+} from './object-validation-engine';