feat: add DashboardSchema, PageRegion, and ListViewSchema interfaces for enhanced layout and view definitions

Author: hotlong

packages/types/src/complex.ts

@@ -17,6 +17,35 @@
 
 import type { BaseSchema, SchemaNode } from './base';
 
+/**
+ * Dashboard Component Schema
+ * (Report / BI View)
+ */
+export interface DashboardSchema extends BaseSchema {
+  type: 'dashboard';
+  /**
+   * Layout Grid Configuration (e.g. 12 column grid)
+   */
+  columns?: number;
+  /**
+   * Widget gap
+   */
+  gap?: number;
+  /**
+   * Dashboard Widgets
+   */
+  widgets: Array<{
+    /** Unique Widget ID */
+    id: string;
+    /** Widget Title */
+    title?: string;
+    /** Widget Component (Chart, Statistic, List, etc) */
+    component: SchemaNode;
+    /** Grid Position: x, y, w, h */
+    layout?: { x: number; y: number; w: number; h: number };
+  }>;
+}
+
 /**
  * Kanban column
  */
@@ -470,4 +499,5 @@ export type ComplexSchema =
   | CalendarViewSchema
   | FilterBuilderSchema
   | CarouselSchema
-  | ChatbotSchema;
+  | ChatbotSchema
+  | DashboardSchema;

packages/types/src/index.ts

@@ -332,7 +332,7 @@ export type {
 // Union Types - Discriminated Unions for All Schemas
 // ============================================================================
 
-import type { BaseSchema, SchemaNode } from './base';
+import type { AnySchema, BaseSchema, SchemaNode } from './base';
 import type { LayoutSchema } from './layout';
 import type { FormComponentSchema } from './form';
 import type { DataDisplaySchema } from './data-display';

packages/types/src/layout.ts

@@ -424,6 +424,32 @@ export interface AspectRatioSchema extends BaseSchema {
   children?: SchemaNode | SchemaNode[];
 }
 
+/**
+ * Page Region (Header, Sidebar, Main, etc)
+ */
+export interface PageRegion {
+  /**
+   * Region name/id
+   */
+  name: string;
+  /**
+   * Region type
+   */
+  type?: 'header' | 'sidebar' | 'main' | 'footer' | 'aside';
+  /**
+   * Width (flex basis)
+   */
+  width?: string;
+  /**
+   * Components in this region
+   */
+  components: SchemaNode[];
+  /**
+   * CSS class
+   */
+  className?: string;
+}
+
 /**
  * Page layout component
  * Top-level container for a page route
@@ -443,7 +469,12 @@ export interface PageSchema extends BaseSchema {
    */
   description?: string;
   /**
-   * Main content array
+   * Page layout regions
+   * (Aligned with @objectstack/spec Page.regions)
+   */
+  regions?: PageRegion[];
+  /**
+   * Main content array (Legacy/Simple mode)
    */
   body?: SchemaNode[];
   /**

packages/types/src/objectql.ts

@@ -674,6 +674,33 @@ export interface ObjectViewSchema extends BaseSchema {
   className?: string;
 }
 
+/**
+ * Generic View Definition
+ * Aligned with @objectstack/spec View/ListView
+ * Defines the data requirement, not just the visual component.
+ */
+export interface ListViewSchema extends BaseSchema {
+  type: 'list-view';
+  
+  /** Object Name */
+  objectName: string;
+  
+  /** View Type (grid, kanban, etc) */
+  viewType?: 'grid' | 'kanban' | 'calendar' | 'gantt' | 'map' | 'chart';
+  
+  /** Fields to fetch/display */
+  fields?: string[];
+  
+  /** Filter conditions */
+  filters?: Array<any[] | string>; // placeholder for FilterCondition
+  
+  /** Sort order */
+  sort?: Array<{ field: string; order: 'asc' | 'desc' }>;
+  
+  /** Visual Component overrides */
+  options?: Record<string, any>;
+}
+
 /**
  * Object Map Component Schema
  */
@@ -766,4 +793,5 @@ export type ObjectQLComponentSchema =
   | ObjectGanttSchema
   | ObjectCalendarSchema
   | ObjectKanbanSchema
-  | ObjectChartSchema;
+  | ObjectChartSchema
+  | ListViewSchema;