@object-ui/types 0.3.0 → 0.5.0

package/src/data.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 - Data Source Types
  * 
@@ -27,9 +35,11 @@ export interface QueryParams {
 
   /**
    * Sort order
+   * Can be a Map { field: 'asc' }, an Array of strings ['field', '-field'], or Array of sort objects
    * @example { createdAt: 'desc', name: 'asc' }
+   * @example ['name', '-createdAt']
    */
-  $orderby?: Record<string, 'asc' | 'desc'>;
+  $orderby?: Record<string, 'asc' | 'desc'> | string[] | Array<{ field: string; order?: 'asc' | 'desc' }>;
 
   /**
    * Number of records to skip (for pagination)
@@ -185,6 +195,16 @@ export interface DataSource<T = any> {
    * @returns Promise resolving to operation result
    */
   bulk?(resource: string, operation: 'create' | 'update' | 'delete', data: Partial<T>[]): Promise<T[]>;
+
+  /**
+   * Get object schema/metadata.
+   * Used by ObjectQL-aware components to auto-generate UI from object metadata.
+   * Required for all DataSource implementations to support schema-aware components.
+   * 
+   * @param objectName - Object name
+   * @returns Promise resolving to the object schema
+   */
+  getObjectSchema(objectName: string): Promise<any>;
 }
 
 /**

package/src/disclosure.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 - Disclosure Component Schemas
  * 
@@ -105,9 +113,74 @@ export interface CollapsibleSchema extends BaseSchema {
   onOpenChange?: (open: boolean) => void;
 }
 
+/**
+ * Toggle group item
+ */
+export interface ToggleGroupItem {
+  /**
+   * Item value
+   */
+  value: string;
+  /**
+   * Item label
+   */
+  label: string;
+  /**
+   * Item icon
+   */
+  icon?: string;
+  /**
+   * Whether item is disabled
+   */
+  disabled?: boolean;
+}
+
+/**
+ * Toggle group component
+ */
+export interface ToggleGroupSchema extends BaseSchema {
+  type: 'toggle-group';
+  /**
+   * Toggle group selection mode
+   * @default 'single'
+   */
+  selectionType?: 'single' | 'multiple';
+  /**
+   * Toggle group variant
+   * @default 'default'
+   */
+  variant?: 'default' | 'outline';
+  /**
+   * Toggle group size
+   * @default 'default'
+   */
+  size?: 'default' | 'sm' | 'lg';
+  /**
+   * Toggle group items
+   */
+  items?: ToggleGroupItem[];
+  /**
+   * Default selected value(s)
+   */
+  defaultValue?: string | string[];
+  /**
+   * Controlled selected value(s)
+   */
+  value?: string | string[];
+  /**
+   * Whether toggle group is disabled
+   */
+  disabled?: boolean;
+  /**
+   * Change handler
+   */
+  onValueChange?: (value: string | string[]) => void;
+}
+
 /**
  * Union type of all disclosure schemas
  */
 export type DisclosureSchema =
   | AccordionSchema
-  | CollapsibleSchema;
+  | CollapsibleSchema
+  | ToggleGroupSchema;

package/src/feedback.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 - Feedback Component Schemas
  * 
@@ -7,7 +15,7 @@
  * @packageDocumentation
  */
 
-import type { BaseSchema, SchemaNode } from './base';
+import type { BaseSchema } from './base';
 
 /**
  * Loading/Spinner component
@@ -159,6 +167,69 @@ export interface ToasterSchema extends BaseSchema {
   limit?: number;
 }
 
+/**
+ * Spinner component
+ */
+export interface SpinnerSchema extends BaseSchema {
+  type: 'spinner';
+  /**
+   * Spinner size
+   * @default 'md'
+   */
+  size?: 'sm' | 'md' | 'lg' | 'xl';
+}
+
+/**
+ * Empty state component
+ */
+export interface EmptySchema extends BaseSchema {
+  type: 'empty';
+  /**
+   * Empty state title
+   */
+  title?: string;
+  /**
+   * Empty state description
+   */
+  description?: string;
+  /**
+   * Icon to display
+   */
+  icon?: string;
+}
+
+/**
+ * Sonner toast component (using sonner library)
+ */
+export interface SonnerSchema extends BaseSchema {
+  type: 'sonner';
+  /**
+   * Toast message/title
+   */
+  message?: string;
+  /**
+   * Toast title (alias for message)
+   */
+  title?: string;
+  /**
+   * Toast description
+   */
+  description?: string;
+  /**
+   * Toast variant
+   * @default 'default'
+   */
+  variant?: 'default' | 'success' | 'error' | 'warning' | 'info';
+  /**
+   * Button label to trigger toast
+   */
+  buttonLabel?: string;
+  /**
+   * Button variant
+   */
+  buttonVariant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
+}
+
 /**
  * Union type of all feedback schemas
  */
@@ -167,4 +238,7 @@ export type FeedbackSchema =
   | ProgressSchema
   | SkeletonSchema
   | ToastSchema
-  | ToasterSchema;
+  | ToasterSchema
+  | SpinnerSchema
+  | EmptySchema
+  | SonnerSchema;