@object-ui/types 0.3.0 → 0.5.0

package/src/form.ts

@@ -1,3 +1,11 @@
+/**
+ * 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/types - Form Component Schemas
  * 
@@ -932,6 +940,126 @@ export interface LabelSchema extends BaseSchema {
   htmlFor?: string;
 }
 
+/**
+ * Combobox option
+ */
+export interface ComboboxOption {
+  /**
+   * Option value
+   */
+  value: string;
+  /**
+   * Option label (displayed to user)
+   */
+  label: string;
+  /**
+   * Whether option is disabled
+   */
+  disabled?: boolean;
+}
+
+/**
+ * Combobox component (searchable select)
+ */
+export interface ComboboxSchema extends BaseSchema {
+  type: 'combobox';
+  /**
+   * Field name for form submission
+   */
+  name?: string;
+  /**
+   * Combobox label
+   */
+  label?: string;
+  /**
+   * Placeholder text
+   */
+  placeholder?: string;
+  /**
+   * Combobox options
+   */
+  options?: ComboboxOption[];
+  /**
+   * Default selected value
+   */
+  defaultValue?: string;
+  /**
+   * Controlled value
+   */
+  value?: string;
+  /**
+   * Whether field is disabled
+   */
+  disabled?: boolean;
+  /**
+   * Help text or description
+   */
+  description?: string;
+  /**
+   * Error message
+   */
+  error?: string;
+  /**
+   * Change handler
+   */
+  onChange?: (value: string) => void;
+}
+
+/**
+ * Command menu item
+ */
+export interface CommandItem {
+  /**
+   * Item value
+   */
+  value: string;
+  /**
+   * Item label (displayed to user)
+   */
+  label: string;
+  /**
+   * Item icon
+   */
+  icon?: string;
+}
+
+/**
+ * Command menu group
+ */
+export interface CommandGroup {
+  /**
+   * Group heading
+   */
+  heading?: string;
+  /**
+   * Group items
+   */
+  items: CommandItem[];
+}
+
+/**
+ * Command component (command palette)
+ */
+export interface CommandSchema extends BaseSchema {
+  type: 'command';
+  /**
+   * Placeholder text
+   */
+  placeholder?: string;
+  /**
+   * Empty state text
+   */
+  emptyText?: string;
+  /**
+   * Command groups
+   */
+  groups?: CommandGroup[];
+  /**
+   * Change handler
+   */
+  onChange?: (value: string) => void;
+}
+
 /**
  * Union type of all form schemas
  */
@@ -950,5 +1078,7 @@ export type FormComponentSchema =
   | CalendarSchema
   | InputOTPSchema
   | FormSchema
-  | LabelSchema;
+  | LabelSchema
+  | ComboboxSchema
+  | CommandSchema;
 

package/src/index.ts

@@ -1,3 +1,11 @@
+/**
+ * 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/types
  * 
@@ -75,6 +83,7 @@ export type {
   SeparatorSchema,
   ContainerSchema,
   FlexSchema,
+  StackSchema,
   GridSchema,
   CardSchema,
   TabsSchema,
@@ -82,6 +91,7 @@ export type {
   ScrollAreaSchema,
   ResizableSchema,
   ResizablePanel,
+  AspectRatioSchema,
   LayoutSchema,
   PageSchema,
 } from './layout';
@@ -99,15 +109,17 @@ export type {
   RadioGroupSchema,
   RadioOption,
   SwitchSchema,
-  ToggleSchema,
   SliderSchema,
   FileUploadSchema,
   DatePickerSchema,
   CalendarSchema,
-  InputOTPSchema,
   ValidationRule,
   FieldCondition,
   FormField,
+  ComboboxSchema,
+  CommandSchema,
+  InputOTPSchema,
+  ToggleSchema,
   FormSchema,
   LabelSchema,
   FormComponentSchema,
@@ -133,6 +145,7 @@ export type {
   ChartSchema,
   TimelineEvent,
   TimelineSchema,
+  KbdSchema,
   HtmlSchema,
   StatisticSchema,
   DataDisplaySchema,
@@ -142,10 +155,13 @@ export type {
 // Feedback Components - Status & Progress Indication
 // ============================================================================
 export type {
+  SpinnerSchema,
   LoadingSchema,
   ProgressSchema,
   SkeletonSchema,
   ToastSchema,
+  EmptySchema,
+  SonnerSchema,
   ToasterSchema,
   FeedbackSchema,
 } from './feedback';
@@ -155,6 +171,7 @@ export type {
 // ============================================================================
 export type {
   AccordionItem,
+  ToggleGroupSchema,
   AccordionSchema,
   CollapsibleSchema,
   DisclosureSchema,
@@ -174,6 +191,7 @@ export type {
   TooltipSchema,
   HoverCardSchema,
   MenuItem,
+  MenubarSchema,
   DropdownMenuSchema,
   ContextMenuSchema,
   OverlaySchema,
@@ -188,8 +206,10 @@ export type {
   SidebarSchema,
   BreadcrumbItem,
   BreadcrumbSchema,
-  PaginationSchema,
+  ButtonGroupSchema,
+  NavigationMenuSchema,
   NavigationSchema,
+  PaginationSchema,
 } from './navigation';
 
 // ============================================================================
@@ -209,6 +229,9 @@ export type {
   FilterField,
   CarouselItem,
   CarouselSchema,
+  DashboardWidgetLayout,
+  DashboardWidgetSchema,
+  DashboardSchema,
   ChatMessage,
   ChatbotSchema,
   ComplexSchema,
@@ -247,11 +270,168 @@ export type {
 // ObjectQL Components - ObjectQL-specific components
 // ============================================================================
 export type {
-  ObjectTableSchema,
+  // Schema types aligned with @objectstack/spec
+  HttpMethod,
+  HttpRequest,
+  ViewData,
+  ListColumn,
+  SelectionConfig,
+  PaginationConfig,
+  KanbanConfig,
+  CalendarConfig,
+  GanttConfig,
+  SortConfig,
+  // Component schemas
+  ObjectMapSchema,
+  ObjectGanttSchema,
+  ObjectCalendarSchema,
+  ObjectKanbanSchema,
+  ObjectChartSchema,
+  ListViewSchema,
+  ObjectGridSchema,
   ObjectFormSchema,
+  ObjectViewSchema,
   ObjectQLComponentSchema,
 } from './objectql';
 
+// ============================================================================
+// Field Types - ObjectQL Field Type System
+// ============================================================================
+export type {
+  BaseFieldMetadata,
+  VisibilityCondition,
+  ValidationFunction as FieldValidationFunction,
+  TextFieldMetadata,
+  TextareaFieldMetadata,
+  MarkdownFieldMetadata,
+  HtmlFieldMetadata,
+  NumberFieldMetadata,
+  CurrencyFieldMetadata,
+  PercentFieldMetadata,
+  BooleanFieldMetadata,
+  DateFieldMetadata,
+  DateTimeFieldMetadata,
+  TimeFieldMetadata,
+  SelectFieldMetadata,
+  SelectOptionMetadata,
+  EmailFieldMetadata,
+  PhoneFieldMetadata,
+  UrlFieldMetadata,
+  PasswordFieldMetadata,
+  FileFieldMetadata,
+  FileMetadata,
+  ImageFieldMetadata,
+  LocationFieldMetadata,
+  LookupFieldMetadata,
+  FormulaFieldMetadata,
+  SummaryFieldMetadata,
+  AutoNumberFieldMetadata,
+  UserFieldMetadata,
+  ObjectFieldMetadata,
+  VectorFieldMetadata,
+  GridFieldMetadata,
+  GridColumnDefinition,
+  ColorFieldMetadata,
+  CodeFieldMetadata,
+  AvatarFieldMetadata,
+  SignatureFieldMetadata,
+  QRCodeFieldMetadata,
+  AddressFieldMetadata,
+  GeolocationFieldMetadata,
+  SliderFieldMetadata,
+  RatingFieldMetadata,
+  MasterDetailFieldMetadata,
+  FieldMetadata,
+  ObjectTrigger,
+  ObjectPermission,
+  SharingRule,
+  ObjectSchemaMetadata,
+  ObjectIndex,
+  ObjectRelationship,
+} from './field-types';
+
+// ============================================================================
+// Phase 3: Data Protocol Advanced Types
+// ============================================================================
+export type {
+  // Query AST (Phase 3.3)
+  QueryASTNodeType,
+  QueryASTNode,
+  SelectNode,
+  FromNode,
+  WhereNode,
+  JoinNode,
+  JoinStrategy,
+  GroupByNode,
+  OrderByNode,
+  LimitNode,
+  OffsetNode,
+  SubqueryNode,
+  AggregateNode,
+  WindowNode,
+  WindowFunction,
+  WindowFrame,
+  WindowFrameUnit,
+  WindowFrameBoundary,
+  FieldNode,
+  LiteralNode,
+  OperatorNode,
+  FunctionNode,
+  ComparisonOperator,
+  LogicalOperator,
+  QueryAST,
+  QuerySchema,
+  QuerySortConfig,
+  JoinConfig,
+  AggregationConfig,
+  WindowConfig,
+  // Filter Schema (Phase 3.4)
+  AdvancedFilterSchema,
+  AdvancedFilterCondition,
+  AdvancedFilterOperator,
+  DateRangeFilter,
+  DateRangePreset,
+  FilterBuilderConfig,
+  FilterFieldConfig,
+  // Validation Schema (Phase 3.5)
+  AdvancedValidationSchema,
+  AdvancedValidationRule,
+  ValidationRuleType,
+  ValidationFunction,
+  AsyncValidationFunction,
+  ValidationContext,
+  AdvancedValidationResult,
+  AdvancedValidationError,
+  // ObjectStack Spec v0.7.1 Validation
+  BaseValidation,
+  ScriptValidation,
+  UniquenessValidation,
+  StateMachineValidation,
+  CrossFieldValidation,
+  AsyncValidation,
+  ConditionalValidation,
+  FormatValidation,
+  RangeValidation,
+  ObjectValidationRule,
+  // Driver Interface (Phase 3.6)
+  DriverInterface,
+  ConnectionConfig,
+  DriverQueryResult,
+  BatchOperation,
+  BatchResult,
+  TransactionContext,
+  CacheManager,
+  ConnectionPool,
+  // Datasource Schema (Phase 3.7)
+  DatasourceSchema,
+  DatasourceType,
+  DatasourceMetric,
+  DatasourceAlert,
+  DatasourceManager,
+  HealthCheckResult,
+  DatasourceMetrics,
+} from './data-protocol';
+
 // ============================================================================
 // API and Events - API Integration and Event Handling
 // ============================================================================
@@ -273,18 +453,83 @@ export type {
 // ============================================================================
 
 import type { BaseSchema, SchemaNode } from './base';
-import type { LayoutSchema } from './layout';
+import type { LayoutSchema, PageSchema } from './layout';
 import type { FormComponentSchema } from './form';
 import type { DataDisplaySchema } from './data-display';
 import type { FeedbackSchema } from './feedback';
 import type { DisclosureSchema } from './disclosure';
 import type { OverlaySchema } from './overlay';
 import type { NavigationSchema } from './navigation';
-import type { ComplexSchema } from './complex';
+import type { ComplexSchema, DashboardSchema } from './complex';
 import type { CRUDComponentSchema } from './crud';
-import type { ObjectQLComponentSchema } from './objectql';
+import type { ObjectQLComponentSchema, ListViewSchema } from './objectql';
 import type { AppSchema } from './app';
 
+// ============================================================================
+// Phase 2 Schemas - New Additions
+// ============================================================================
+export type {
+  // Theme System
+  ThemeSchema,
+  ThemeDefinition,
+  ThemeMode,
+  ColorPalette,
+  Typography,
+  SpacingScale,
+  BorderRadius,
+  ThemeSwitcherSchema,
+  ThemePreviewSchema,
+} from './theme';
+
+export type {
+  // Report System
+  ReportSchema,
+  ReportExportFormat,
+  ReportScheduleFrequency,
+  ReportAggregationType,
+  ReportField,
+  ReportFilter,
+  ReportGroupBy,
+  ReportSection,
+  ReportSchedule,
+  ReportExportConfig,
+  ReportBuilderSchema,
+  ReportViewerSchema,
+} from './reports';
+
+export type {
+  // Block System
+  BlockSchema,
+  BlockMetadata,
+  BlockVariable,
+  BlockSlot,
+  BlockLibraryItem,
+  BlockLibrarySchema,
+  BlockEditorSchema,
+  BlockInstanceSchema,
+  ComponentSchema,
+} from './blocks';
+
+export type {
+  // View System Enhancements
+  ViewType,
+  DetailViewSchema,
+  DetailViewField,
+  DetailViewSection,
+  DetailViewTab,
+  ViewSwitcherSchema,
+  FilterUISchema,
+  SortUISchema,
+  ViewComponentSchema,
+} from './views';
+
+export type {
+  // Enhanced Action System (Phase 2)
+  ActionExecutionMode,
+  ActionCallback,
+  ActionCondition,
+} from './crud';
+
 /**
  * Union of all component schemas.
  * Use this for generic component rendering where the type is determined at runtime.
@@ -293,6 +538,7 @@ export type AnySchema =
   | AppSchema 
   | BaseSchema
   | LayoutSchema
+  | PageSchema
   | FormComponentSchema
   | DataDisplaySchema
   | FeedbackSchema
@@ -300,8 +546,10 @@ export type AnySchema =
   | OverlaySchema
   | NavigationSchema
   | ComplexSchema
+  | DashboardSchema
   | CRUDComponentSchema
-  | ObjectQLComponentSchema;
+  | ObjectQLComponentSchema
+  | ListViewSchema;
 
 /**
  * Utility type to extract the schema type from a type string.
@@ -348,3 +596,52 @@ export type {
   SchemaRegistry,
   ComponentType,
 } from './registry';
+
+// ============================================================================
+// Plugin Scope Isolation - Section 3.3
+// ============================================================================
+export type {
+  PluginScope,
+  PluginScopeConfig,
+  ComponentMeta as PluginComponentMeta,
+  ComponentInput as PluginComponentInput,
+  PluginEventHandler,
+} from './plugin-scope';
+
+// ============================================================================
+// UI Actions - Enhanced Action Schema (ObjectStack Spec v0.7.1)
+// ============================================================================
+/**
+ * Enhanced action schema with location-based placement, parameter collection,
+ * conditional visibility, and rich feedback mechanisms.
+ */
+export type {
+  ActionLocation,
+  ActionComponent,
+  ActionType,
+  ActionParam,
+  ActionSchema as UIActionSchema,
+  ActionGroup,
+  ActionContext,
+  ActionResult,
+  ActionExecutor,
+} from './ui-action';
+
+// ============================================================================
+// ObjectStack Protocol Namespaces - Protocol Re-exports
+// ============================================================================
+/**
+ * Re-export ObjectStack Protocol namespaces for convenience.
+ * 
+ * This allows consumers to access the full ObjectStack protocol through
+ * @object-ui/types without needing to install @objectstack/spec separately.
+ * 
+ * @example
+ * ```typescript
+ * import { Data, UI, System, AI, API } from '@object-ui/types';
+ * 
+ * const field: Data.Field = { name: 'task_name', type: 'text' };
+ * const component: UI.Component = { type: 'button', label: 'Click me' };
+ * ```
+ */
+export type { Data, UI, System, AI, API, Auth, Hub, Automation, Permission, Shared, QA } from '@objectstack/spec';

package/src/layout.ts

@@ -1,3 +1,11 @@
+/**
+ * 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/types - Layout Component Schemas
  * 
@@ -388,6 +396,60 @@ export interface ResizablePanel {
   content: SchemaNode | SchemaNode[];
 }
 
+/**
+ * Aspect ratio component
+ */
+export interface AspectRatioSchema extends BaseSchema {
+  type: 'aspect-ratio';
+  /**
+   * Aspect ratio (width / height)
+   * @default 16/9
+   */
+  ratio?: number;
+  /**
+   * Image URL to display
+   */
+  image?: string;
+  /**
+   * Image alt text
+   */
+  alt?: string;
+  /**
+   * Child components (alternative to image)
+   */
+  body?: SchemaNode | SchemaNode[];
+  /**
+   * Child components (alternative syntax)
+   */
+  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
@@ -407,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[];
   /**
@@ -428,24 +495,12 @@ export type LayoutSchema =
   | SeparatorSchema
   | ContainerSchema
   | FlexSchema
+  | StackSchema
   | GridSchema
   | CardSchema
   | TabsSchema
   | ScrollAreaSchema
   | ResizableSchema
+  | AspectRatioSchema
   | PageSchema;
 
-/**
- * Page container component
- */
-export interface PageSchema extends BaseSchema {
-  type: 'page';
-  /**
-   * Page title
-   */
-  title?: string;
-  /**
-   * Child components
-   */
-  children?: SchemaNode | SchemaNode[];
-}