@object-ui/types 0.5.0 → 3.0.0

package/src/index.ts

@@ -94,6 +94,10 @@ export type {
   AspectRatioSchema,
   LayoutSchema,
   PageSchema,
+  PageType,
+  PageRegion,
+  PageRegionWidth,
+  PageVariable,
 } from './layout';
 
 // ============================================================================
@@ -249,6 +253,7 @@ export type {
   DataBinding,
   ValidationError,
   APIError,
+  FileUploadResult,
 } from './data';
 
 // ============================================================================
@@ -290,7 +295,10 @@ export type {
   ListViewSchema,
   ObjectGridSchema,
   ObjectFormSchema,
+  ObjectFormSection,
   ObjectViewSchema,
+  NamedListView,
+  ViewNavigationConfig,
   ObjectQLComponentSchema,
 } from './objectql';
 
@@ -402,7 +410,7 @@ export type {
   ValidationContext,
   AdvancedValidationResult,
   AdvancedValidationError,
-  // ObjectStack Spec v0.7.1 Validation
+  // ObjectStack Spec v2.0.1 Validation
   BaseValidation,
   ScriptValidation,
   UniquenessValidation,
@@ -432,6 +440,89 @@ export type {
   DatasourceMetrics,
 } from './data-protocol';
 
+// ============================================================================
+// Permission & RBAC Types (Q2 2026)
+// ============================================================================
+export type {
+  PermissionAction,
+  PermissionEffect,
+  RoleDefinition,
+  ObjectLevelPermission,
+  FieldLevelPermission,
+  RowLevelPermission,
+  PermissionCondition,
+  ObjectPermissionConfig,
+  SharingRuleConfig,
+  PermissionCheckResult,
+  PermissionContext,
+  PermissionGuardConfig,
+} from './permissions';
+
+// ============================================================================
+// Multi-Tenancy Types (Q2 2026)
+// ============================================================================
+export type {
+  TenantIsolationStrategy,
+  TenantStatus,
+  TenantPlan,
+  TenantConfig,
+  TenantBranding,
+  TenantLimits,
+  TenantContext,
+  TenantResolutionStrategy,
+  TenantProviderConfig,
+  TenantScopedQueryConfig,
+} from './tenant';
+
+// ============================================================================
+// Mobile Optimization Types (Q2 2026)
+// ============================================================================
+export type {
+  BreakpointName,
+  ResponsiveValue,
+  ResponsiveConfig,
+  MobileOverrides,
+  PWAConfig,
+  PWAIcon,
+  CacheStrategy,
+  OfflineConfig,
+  OfflineRoute,
+  GestureType,
+  GestureConfig,
+  GestureContext,
+  MobileComponentConfig,
+} from './mobile';
+
+// ============================================================================
+// Visual Designer Types (Q2 2026)
+// ============================================================================
+export type {
+  DesignerPosition,
+  DesignerCanvasConfig,
+  DesignerComponent,
+  PageDesignerSchema,
+  DesignerPaletteCategory,
+  DesignerPaletteItem,
+  DataModelEntity,
+  DataModelField,
+  DataModelRelationship,
+  DataModelDesignerSchema,
+  BPMNNodeType,
+  BPMNNode,
+  BPMNEdge,
+  BPMNLane,
+  ProcessDesignerSchema,
+  ReportSectionType,
+  ReportDesignerElement,
+  ReportDesignerSection,
+  ReportDesignerSchema,
+  CollaborationPresence,
+  CollaborationOperation,
+  CollaborationConfig,
+  ViewDesignerColumn,
+  ViewDesignerSchema,
+} from './designer';
+
 // ============================================================================
 // API and Events - API Integration and Event Handling
 // ============================================================================
@@ -469,16 +560,24 @@ import type { AppSchema } from './app';
 // Phase 2 Schemas - New Additions
 // ============================================================================
 export type {
-  // Theme System
+  // Theme System (aligned with @objectstack/spec)
+  Theme,
   ThemeSchema,
-  ThemeDefinition,
   ThemeMode,
   ColorPalette,
   Typography,
-  SpacingScale,
+  Spacing,
   BorderRadius,
+  Shadow,
+  Breakpoints,
+  Animation,
+  ZIndex,
+  ThemeLogo,
   ThemeSwitcherSchema,
   ThemePreviewSchema,
+  // Legacy aliases
+  ThemeDefinition,
+  SpacingScale,
 } from './theme';
 
 export type {
@@ -497,6 +596,37 @@ export type {
   ReportViewerSchema,
 } from './reports';
 
+export type {
+  // Workflow System
+  WorkflowStatus,
+  WorkflowNodeType,
+  WorkflowEdgeType,
+  WorkflowNode,
+  WorkflowNodeAction,
+  WorkflowEdge,
+  ApprovalRule,
+  WorkflowVariable,
+  WorkflowSchema,
+  WorkflowDesignerSchema,
+  ApprovalHistoryItem,
+  ApprovalProcessSchema,
+  WorkflowInstanceSchema,
+} from './workflow';
+
+export type {
+  // AI System
+  AIProvider,
+  AIModelType,
+  AIConfig,
+  AIFieldSuggestion,
+  AIFormAssistSchema,
+  AIRecommendationItem,
+  AIRecommendationsSchema,
+  NLQueryResult,
+  NLQuerySchema,
+  AIInsightsSchema,
+} from './ai';
+
 export type {
   // Block System
   BlockSchema,
@@ -609,7 +739,7 @@ export type {
 } from './plugin-scope';
 
 // ============================================================================
-// UI Actions - Enhanced Action Schema (ObjectStack Spec v0.7.1)
+// UI Actions - Enhanced Action Schema (ObjectStack Spec v2.0.1)
 // ============================================================================
 /**
  * Enhanced action schema with location-based placement, parameter collection,
@@ -625,6 +755,14 @@ export type {
   ActionContext,
   ActionResult,
   ActionExecutor,
+  BatchOperationConfig,
+  BatchOperationResult,
+  TransactionIsolationLevel,
+  TransactionConfig,
+  TransactionResult,
+  UndoRedoEntry,
+  UndoRedoConfig,
+  UndoRedoState,
 } from './ui-action';
 
 // ============================================================================
@@ -638,10 +776,261 @@ export type {
  * 
  * @example
  * ```typescript
- * import { Data, UI, System, AI, API } from '@object-ui/types';
+ * import { Data, UI, System, AI, API, Kernel } from '@object-ui/types';
  * 
  * const field: Data.Field = { name: 'task_name', type: 'text' };
- * const component: UI.Component = { type: 'button', label: 'Click me' };
+ * const view: UI.ListView = { name: 'all', label: 'All Records', ... };
+ * ```
+ */
+export type {
+  Data,
+  UI,
+  System,
+  AI,
+  API,
+  Cloud,
+  Automation,
+  Shared,
+  QA,
+  Kernel,
+  Contracts,
+  Integration,
+  Studio,
+  Identity,
+  Security,
+} from '@objectstack/spec';
+
+// ============================================================================
+// ObjectStack Protocol Utilities - defineStack
+// ============================================================================
+/**
+ * Re-export ObjectStack Protocol utility functions and top-level types.
+ *
+ * @example
+ * ```typescript
+ * import { defineStack } from '@object-ui/types';
+ *
+ * export default defineStack({
+ *   manifest: { id: 'com.example.app', version: '1.0.0', type: 'app', name: 'My App' },
+ *   objects: [],
+ *   apps: [],
+ * });
  * ```
  */
-export type { Data, UI, System, AI, API, Auth, Hub, Automation, Permission, Shared, QA } from '@objectstack/spec';
+export {
+  defineStack,
+  ObjectStackSchema,
+  ObjectStackDefinitionSchema,
+  ObjectStackCapabilitiesSchema,
+  ObjectOSCapabilitiesSchema,
+  ObjectQLCapabilitiesSchema,
+  ObjectUICapabilitiesSchema,
+} from '@objectstack/spec';
+
+export type {
+  PluginContext,
+  ObjectStack,
+  ObjectStackDefinition,
+  ObjectStackCapabilities,
+  ObjectOSCapabilities,
+  ObjectQLCapabilities,
+  ObjectUICapabilities,
+} from '@objectstack/spec';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — Drag and Drop
+// ============================================================================
+export type {
+  DndConfig,
+  DndConfigSchema,
+  DragItem,
+  DragItemSchema,
+  DropZone,
+  DropZoneSchema,
+  DragConstraint,
+  DragConstraintSchema,
+  DragHandle,
+  DragHandleSchema,
+  DropEffect,
+  DropEffectSchema,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — Focus & Keyboard Navigation
+// ============================================================================
+export type {
+  FocusManagement,
+  FocusManagementSchema,
+  FocusTrapConfig,
+  FocusTrapConfigSchema,
+  KeyboardNavigationConfig,
+  KeyboardNavigationConfigSchema,
+  KeyboardShortcut,
+  KeyboardShortcutSchema,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — Animation & Motion
+// ============================================================================
+export type {
+  ComponentAnimation,
+  ComponentAnimationSchema,
+  AnimationTrigger,
+  AnimationTriggerSchema,
+  MotionConfig,
+  MotionConfigSchema,
+  TransitionConfig,
+  TransitionConfigSchema,
+  TransitionPreset,
+  TransitionPresetSchema,
+  EasingFunction,
+  EasingFunctionSchema,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — Notifications
+// ============================================================================
+export type {
+  Notification,
+  NotificationSchema,
+  NotificationConfig,
+  NotificationConfigSchema,
+  NotificationAction,
+  NotificationActionSchema,
+  NotificationPosition,
+  NotificationPositionSchema,
+  NotificationSeverity,
+  NotificationSeveritySchema,
+  NotificationType,
+  NotificationTypeSchema,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — Gestures & Touch
+// ============================================================================
+export type {
+  GestureConfig as SpecGestureConfig,
+  GestureConfigSchema as SpecGestureConfigSchema,
+  GestureType as SpecGestureType,
+  GestureTypeSchema as SpecGestureTypeSchema,
+  SwipeGestureConfig,
+  SwipeGestureConfigSchema,
+  SwipeDirection,
+  SwipeDirectionSchema,
+  PinchGestureConfig,
+  PinchGestureConfigSchema,
+  LongPressGestureConfig,
+  LongPressGestureConfigSchema,
+  TouchInteraction,
+  TouchInteractionSchema,
+  TouchTargetConfig,
+  TouchTargetConfigSchema,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — Offline & Sync
+// ============================================================================
+export type {
+  OfflineConfig as SpecOfflineConfig,
+  OfflineConfigSchema as SpecOfflineConfigSchema,
+  OfflineCacheConfig,
+  OfflineCacheConfigSchema,
+  OfflineStrategy,
+  OfflineStrategySchema,
+  SyncConfig,
+  SyncConfigSchema,
+  ConflictResolution,
+  ConflictResolutionSchema,
+  PersistStorage,
+  PersistStorageSchema,
+  EvictionPolicy,
+  EvictionPolicySchema,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — View Enhancements
+// ============================================================================
+export type {
+  ColumnSummary,
+  ColumnSummarySchema,
+  GalleryConfig,
+  GalleryConfigSchema,
+  GroupingConfig,
+  GroupingConfigSchema,
+  RowColorConfig,
+  RowColorConfigSchema,
+  RowHeight,
+  RowHeightSchema,
+  DensityMode,
+  ViewSharing,
+  ViewSharingSchema,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — Performance & Page Transitions
+// ============================================================================
+export type {
+  PerformanceConfig,
+  PerformanceConfigSchema,
+  PageTransition,
+  PageTransitionSchema,
+  PageComponentType,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — Accessibility
+// ============================================================================
+export type {
+  AriaProps,
+  AriaPropsSchema,
+  WcagContrastLevel,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — I18n
+// ============================================================================
+export type {
+  I18nLabel,
+  I18nLabelSchema,
+  I18nObject,
+  I18nObjectSchema,
+  LocaleConfig,
+  LocaleConfigSchema,
+  PluralRule,
+  PluralRuleSchema,
+  DateFormat,
+  DateFormatSchema,
+  NumberFormat,
+  NumberFormatSchema,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// v2.0.7 Spec UI Types — Responsive Design
+// ============================================================================
+export type {
+  ResponsiveConfig as SpecResponsiveConfig,
+  ResponsiveConfigSchema as SpecResponsiveConfigSchema,
+  BreakpointColumnMapSchema,
+  BreakpointOrderMapSchema,
+  BreakpointName as SpecBreakpointName,
+} from '@objectstack/spec/ui';
+
+// ============================================================================
+// Widget System - Runtime Widget Registration (Section 1.6)
+// ============================================================================
+/**
+ * Widget manifest and registry types for runtime widget registration,
+ * plugin auto-discovery, and custom widget registry.
+ */
+export type {
+  WidgetManifest,
+  WidgetSource,
+  WidgetSourceModule,
+  WidgetSourceInline,
+  WidgetSourceRegistry,
+  WidgetInput,
+  WidgetCapabilities,
+  ResolvedWidget,
+  WidgetRegistryEvent,
+  WidgetRegistryListener,
+} from './widget';

package/src/layout.ts

@@ -424,35 +424,64 @@ export interface AspectRatioSchema extends BaseSchema {
   children?: SchemaNode | SchemaNode[];
 }
 
+/**
+ * Page Type
+ * Determines page behavior and default layout template.
+ * Aligned with @objectstack/spec Page.type
+ */
+export type PageType = 'record' | 'home' | 'app' | 'utility';
+
+/**
+ * Page Variable
+ * Local page state that can be read/written by components and expressions.
+ * Aligned with @objectstack/spec PageVariableSchema
+ */
+export interface PageVariable {
+  /** Variable name */
+  name: string;
+  /** Variable type @default 'string' */
+  type?: 'string' | 'number' | 'boolean' | 'object' | 'array';
+  /** Default value for initialization */
+  defaultValue?: any;
+}
+
+/**
+ * Page Region Size
+ * Aligned with @objectstack/spec PageRegionSchema.width
+ */
+export type PageRegionWidth = 'small' | 'medium' | 'large' | 'full';
+
 /**
  * Page Region (Header, Sidebar, Main, etc)
+ * Aligned with @objectstack/spec PageRegionSchema
  */
 export interface PageRegion {
   /**
-   * Region name/id
+   * Region name/id (e.g. "sidebar", "main", "header")
    */
   name: string;
   /**
-   * Region type
+   * Region type — semantic role for layout rendering
    */
   type?: 'header' | 'sidebar' | 'main' | 'footer' | 'aside';
   /**
-   * Width (flex basis)
+   * Region width (spec-aligned enum)
    */
-  width?: string;
+  width?: PageRegionWidth | string;
   /**
    * Components in this region
    */
   components: SchemaNode[];
   /**
-   * CSS class
+   * CSS class overrides
    */
   className?: string;
 }
 
 /**
  * Page layout component
- * Top-level container for a page route
+ * Top-level container for a page route.
+ * Aligned with @objectstack/spec PageSchema
  */
 export interface PageSchema extends BaseSchema {
   type: 'page';
@@ -461,13 +490,33 @@ export interface PageSchema extends BaseSchema {
    */
   title?: string;
   /**
-    * Page icon (Lucide icon name)
-    */
+   * Page icon (Lucide icon name)
+   */
   icon?: string;
   /**
    * Page description
    */
   description?: string;
+  /**
+   * Page type — determines default layout and behavior
+   * @default 'record'
+   */
+  pageType?: PageType;
+  /**
+   * Bound object name (for record pages)
+   * Provides record context to components in regions
+   */
+  object?: string;
+  /**
+   * Layout template name (e.g. "default", "header-sidebar-main")
+   * @default 'default'
+   */
+  template?: string;
+  /**
+   * Local page state variables
+   * Initialized on mount and available to all components via context
+   */
+  variables?: PageVariable[];
   /**
    * Page layout regions
    * (Aligned with @objectstack/spec Page.regions)
@@ -481,6 +530,15 @@ export interface PageSchema extends BaseSchema {
    * Alternative content prop
    */
   children?: SchemaNode | SchemaNode[];
+  /**
+   * Whether this is the default page for the object/app
+   * @default false
+   */
+  isDefault?: boolean;
+  /**
+   * Profiles that can access this page
+   */
+  assignedProfiles?: string[];
 }
 
 /**