@object-ui/types 0.3.0 → 0.5.0

package/src/zod/crud.zod.ts

@@ -0,0 +1,259 @@
+/**
+ * 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/zod - CRUD Component Zod Validators
+ * 
+ * Zod validation schemas for CRUD operations.
+ * Following @objectstack/spec UI specification format.
+ * 
+ * Enhanced in Phase 2 with ajax, confirm, dialog actions, chaining, and conditional execution.
+ * 
+ * @module zod/crud
+ * @packageDocumentation
+ */
+
+import { z } from 'zod';
+import { BaseSchema, SchemaNodeSchema } from './base.zod.js';
+
+/**
+ * Action Execution Mode Schema
+ */
+export const ActionExecutionModeSchema = z.enum(['sequential', 'parallel']).describe('Action execution mode for chaining');
+
+/**
+ * Action Callback Schema
+ */
+export const ActionCallbackSchema = z.object({
+  type: z.enum(['toast', 'message', 'redirect', 'reload', 'custom', 'ajax', 'dialog']).describe('Callback type'),
+  message: z.string().optional().describe('Message to display'),
+  url: z.string().optional().describe('Redirect URL'),
+  api: z.string().optional().describe('API endpoint for ajax callback'),
+  method: z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH']).optional().describe('HTTP method for ajax callback'),
+  dialog: SchemaNodeSchema.optional().describe('Dialog schema to open'),
+  handler: z.string().optional().describe('Custom callback handler expression'),
+});
+
+/**
+ * Action Condition Schema
+ */
+export const ActionConditionSchema: z.ZodType<any> = z.lazy(() => z.object({
+  expression: z.string().describe('Condition expression'),
+  then: z.union([ActionSchema, z.array(ActionSchema)]).optional().describe('Action to execute if condition is true'),
+  else: z.union([ActionSchema, z.array(ActionSchema)]).optional().describe('Action to execute if condition is false'),
+}));
+
+/**
+ * Action Schema - Enhanced with Phase 2 features
+ */
+export const ActionSchema: z.ZodType<any> = z.lazy(() => BaseSchema.extend({
+  type: z.literal('action'),
+  label: z.string().describe('Action label'),
+  level: z.enum(['primary', 'secondary', 'success', 'warning', 'danger', 'info', 'default']).optional().default('default').describe('Action type/level'),
+  icon: z.string().optional().describe('Icon to display (lucide-react icon name)'),
+  variant: z.enum(['default', 'outline', 'ghost', 'link']).optional().describe('Action variant'),
+  disabled: z.boolean().optional().describe('Whether action is disabled'),
+  actionType: z.enum(['button', 'link', 'dropdown', 'ajax', 'confirm', 'dialog']).optional().describe('Action type'),
+  api: z.string().optional().describe('API endpoint to call (for ajax actions)'),
+  method: z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH']).optional().default('POST').describe('HTTP method'),
+  data: z.any().optional().describe('Request body/data'),
+  headers: z.record(z.string(), z.string()).optional().describe('Request headers'),
+  confirm: z.object({
+    title: z.string().optional().describe('Confirmation title'),
+    message: z.string().optional().describe('Confirmation message'),
+    confirmText: z.string().optional().describe('Confirm button text'),
+    cancelText: z.string().optional().describe('Cancel button text'),
+    confirmVariant: z.enum(['default', 'destructive', 'outline', 'secondary', 'ghost']).optional().describe('Confirm button variant'),
+  }).optional().describe('Confirmation dialog configuration (for confirm actions)'),
+  confirmText: z.string().optional().describe('Legacy confirmation message (deprecated - use confirm object instead)'),
+  dialog: z.object({
+    title: z.string().optional().describe('Dialog title'),
+    content: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).optional().describe('Dialog content'),
+    size: z.enum(['sm', 'default', 'lg', 'xl', 'full']).optional().describe('Dialog size'),
+    actions: z.array(ActionSchema).optional().describe('Dialog actions'),
+  }).optional().describe('Dialog configuration (for dialog actions)'),
+  successMessage: z.string().optional().describe('Success message after execution'),
+  errorMessage: z.string().optional().describe('Error message on failure'),
+  onSuccess: ActionCallbackSchema.optional().describe('Success callback'),
+  onFailure: ActionCallbackSchema.optional().describe('Failure callback'),
+  chain: z.array(ActionSchema).optional().describe('Action chaining - actions to execute after this one'),
+  chainMode: ActionExecutionModeSchema.optional().default('sequential').describe('Chain execution mode'),
+  condition: ActionConditionSchema.optional().describe('Conditional execution'),
+  reload: z.boolean().optional().default(true).describe('Whether to reload data after action'),
+  close: z.boolean().optional().default(true).describe('Whether to close dialog/modal after action'),
+  onClick: z.any().optional().describe('Custom click handler'),
+  redirect: z.string().optional().describe('Redirect URL after success'),
+  tracking: z.object({
+    enabled: z.boolean().optional().describe('Enable tracking'),
+    event: z.string().optional().describe('Event name'),
+    metadata: z.record(z.string(), z.any()).optional().describe('Additional metadata'),
+  }).optional().describe('Action logging/tracking'),
+  timeout: z.number().optional().describe('Timeout in milliseconds'),
+  retry: z.object({
+    maxAttempts: z.number().optional().describe('Maximum retry attempts'),
+    delay: z.number().optional().describe('Delay between retries (in ms)'),
+  }).optional().describe('Retry configuration'),
+}));
+
+/**
+ * CRUD Operation Schema
+ */
+export const CRUDOperationSchema = z.object({
+  type: z.enum(['create', 'read', 'update', 'delete', 'export', 'import', 'custom']).describe('Operation type'),
+  label: z.string().optional().describe('Operation label'),
+  icon: z.string().optional().describe('Operation icon'),
+  enabled: z.boolean().optional().default(true).describe('Whether operation is enabled'),
+  api: z.string().optional().describe('API endpoint for this operation'),
+  method: z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH']).optional().describe('HTTP method'),
+  confirmText: z.string().optional().describe('Confirmation message'),
+  successMessage: z.string().optional().describe('Success message'),
+  visibleOn: z.string().optional().describe('Visibility condition'),
+  disabledOn: z.string().optional().describe('Disabled condition'),
+});
+
+/**
+ * CRUD Filter Schema
+ */
+export const CRUDFilterSchema = z.object({
+  name: z.string().describe('Filter name (field name)'),
+  label: z.string().optional().describe('Filter label'),
+  type: z.enum(['input', 'select', 'date-picker', 'date-range', 'number-range']).optional().describe('Filter type'),
+  operator: z.enum(['equals', 'contains', 'startsWith', 'endsWith', 'gt', 'gte', 'lt', 'lte', 'between', 'in']).optional().default('equals').describe('Filter operator'),
+  options: z.array(z.object({ label: z.string(), value: z.union([z.string(), z.number()]) })).optional().describe('Options for select filter'),
+  placeholder: z.string().optional().describe('Placeholder text'),
+  defaultValue: z.any().optional().describe('Default value'),
+});
+
+/**
+ * CRUD Toolbar Schema
+ */
+export const CRUDToolbarSchema = z.object({
+  showCreate: z.boolean().optional().default(true).describe('Show create button'),
+  showRefresh: z.boolean().optional().default(true).describe('Show refresh button'),
+  showExport: z.boolean().optional().default(false).describe('Show export button'),
+  showImport: z.boolean().optional().default(false).describe('Show import button'),
+  showFilter: z.boolean().optional().default(true).describe('Show filter toggle'),
+  showSearch: z.boolean().optional().default(true).describe('Show search box'),
+  actions: z.array(ActionSchema).optional().describe('Custom actions'),
+});
+
+/**
+ * CRUD Pagination Schema
+ */
+export const CRUDPaginationSchema = z.object({
+  enabled: z.boolean().optional().default(true).describe('Whether pagination is enabled'),
+  pageSize: z.number().optional().default(10).describe('Default page size'),
+  pageSizeOptions: z.array(z.number()).optional().default([10, 20, 50, 100]).describe('Page size options'),
+  showTotal: z.boolean().optional().default(true).describe('Show total count'),
+  showSizeChanger: z.boolean().optional().default(true).describe('Show page size selector'),
+});
+
+/**
+ * CRUD Schema
+ */
+export const CRUDSchema = BaseSchema.extend({
+  type: z.literal('crud'),
+  title: z.string().optional().describe('CRUD title'),
+  resource: z.string().optional().describe('Resource name (singular)'),
+  api: z.string().optional().describe('API endpoint for list/search'),
+  columns: z.array(z.any()).describe('Table columns configuration'),
+  fields: z.array(z.any()).optional().describe('Form fields for create/edit'),
+  operations: z.record(z.string(), z.union([z.boolean(), CRUDOperationSchema])).optional().describe('Enabled operations'),
+  toolbar: CRUDToolbarSchema.optional().describe('Toolbar configuration'),
+  filters: z.array(CRUDFilterSchema).optional().describe('Filter configuration'),
+  pagination: CRUDPaginationSchema.optional().describe('Pagination configuration'),
+  defaultSort: z.string().optional().describe('Default sort field'),
+  defaultSortOrder: z.enum(['asc', 'desc']).optional().default('asc').describe('Default sort order'),
+  selectable: z.union([z.boolean(), z.enum(['single', 'multiple'])]).optional().describe('Row selection mode'),
+  batchActions: z.array(ActionSchema).optional().describe('Batch actions for selected rows'),
+  rowActions: z.array(ActionSchema).optional().describe('Row actions (displayed in each row)'),
+  emptyState: SchemaNodeSchema.optional().describe('Custom empty state'),
+  loading: z.boolean().optional().default(true).describe('Whether to show loading state'),
+  loadingComponent: SchemaNodeSchema.optional().describe('Custom loading component'),
+  mode: z.enum(['table', 'grid', 'list', 'kanban']).optional().default('table').describe('Table layout mode'),
+  gridColumns: z.number().optional().default(3).describe('Grid columns (for grid mode)'),
+  cardTemplate: SchemaNodeSchema.optional().describe('Card template (for grid/list mode)'),
+  kanbanColumns: z.array(z.object({
+    id: z.string(),
+    title: z.string(),
+    color: z.string().optional(),
+  })).optional().describe('Kanban columns (for kanban mode)'),
+  kanbanGroupField: z.string().optional().describe('Kanban group field'),
+});
+
+/**
+ * Detail Schema
+ */
+export const DetailSchema = BaseSchema.extend({
+  type: z.literal('detail'),
+  title: z.string().optional().describe('Detail title'),
+  api: z.string().optional().describe('API endpoint to fetch detail data'),
+  resourceId: z.union([z.string(), z.number()]).optional().describe('Resource ID to display'),
+  groups: z.array(z.object({
+    title: z.string().optional(),
+    description: z.string().optional(),
+    fields: z.array(z.object({
+      name: z.string(),
+      label: z.string().optional(),
+      type: z.enum(['text', 'image', 'link', 'badge', 'date', 'datetime', 'json', 'html', 'custom']).optional(),
+      format: z.string().optional(),
+      render: SchemaNodeSchema.optional(),
+    })),
+  })).optional().describe('Field groups for organized display'),
+  actions: z.array(ActionSchema).optional().describe('Actions available in detail view'),
+  tabs: z.array(z.object({
+    key: z.string(),
+    label: z.string(),
+    content: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]),
+  })).optional().describe('Tabs for additional content'),
+  showBack: z.boolean().optional().default(true).describe('Show back button'),
+  onBack: z.any().optional().describe('Custom back action'),
+  loading: z.boolean().optional().default(true).describe('Whether to show loading state'),
+});
+
+/**
+ * CRUD Dialog Schema
+ */
+export const CRUDDialogSchema = BaseSchema.extend({
+  type: z.literal('crud-dialog'),
+  title: z.string().optional().describe('Dialog title'),
+  description: z.string().optional().describe('Dialog description'),
+  content: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).optional().describe('Dialog content'),
+  size: z.enum(['sm', 'default', 'lg', 'xl', 'full']).optional().default('default').describe('Dialog size'),
+  actions: z.array(ActionSchema).optional().describe('Dialog actions/buttons'),
+  open: z.boolean().optional().describe('Whether dialog is open'),
+  onClose: z.any().optional().describe('Close handler'),
+  closeOnOutsideClick: z.boolean().optional().default(true).describe('Whether clicking outside closes dialog'),
+  closeOnEscape: z.boolean().optional().default(true).describe('Whether pressing Escape closes dialog'),
+  showClose: z.boolean().optional().default(true).describe('Show close button'),
+});
+
+/**
+ * Union of all CRUD schemas
+ */
+export const CRUDComponentSchema = z.union([
+  ActionSchema,
+  CRUDSchema,
+  DetailSchema,
+  CRUDDialogSchema,
+]);
+
+/**
+ * Export type inference helpers
+ */
+export type ActionExecutionModeSchemaType = z.infer<typeof ActionExecutionModeSchema>;
+export type ActionCallbackSchemaType = z.infer<typeof ActionCallbackSchema>;
+export type ActionConditionSchemaType = z.infer<typeof ActionConditionSchema>;
+export type ActionSchemaType = z.infer<typeof ActionSchema>;
+export type CRUDOperationSchemaType = z.infer<typeof CRUDOperationSchema>;
+export type CRUDFilterSchemaType = z.infer<typeof CRUDFilterSchema>;
+export type CRUDToolbarSchemaType = z.infer<typeof CRUDToolbarSchema>;
+export type CRUDPaginationSchemaType = z.infer<typeof CRUDPaginationSchema>;
+export type CRUDSchemaType = z.infer<typeof CRUDSchema>;
+export type DetailSchemaType = z.infer<typeof DetailSchema>;
+export type CRUDDialogSchemaType = z.infer<typeof CRUDDialogSchema>;

package/src/zod/data-display.zod.ts

@@ -0,0 +1,290 @@
+/**
+ * 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/zod - Data Display Component Zod Validators
+ * 
+ * Zod validation schemas for data display and information presentation components.
+ * Following @objectstack/spec UI specification format.
+ * 
+ * @module zod/data-display
+ * @packageDocumentation
+ */
+
+import { z } from 'zod';
+import { BaseSchema, SchemaNodeSchema } from './base.zod.js';
+
+/**
+ * Alert Schema - Alert/notification component
+ */
+export const AlertSchema = BaseSchema.extend({
+  type: z.literal('alert'),
+  title: z.string().optional().describe('Alert title'),
+  description: z.string().optional().describe('Alert description'),
+  variant: z.enum(['default', 'destructive']).optional().describe('Alert variant'),
+  icon: z.string().optional().describe('Alert icon'),
+  dismissible: z.boolean().optional().describe('Whether alert can be dismissed'),
+  onDismiss: z.function().optional().describe('Dismiss handler'),
+  children: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).optional(),
+});
+
+/**
+ * Statistic Schema - Statistic display component
+ */
+export const StatisticSchema = BaseSchema.extend({
+  type: z.literal('statistic'),
+  label: z.string().optional().describe('Statistic label'),
+  value: z.union([z.string(), z.number()]).describe('Statistic value'),
+  trend: z.enum(['up', 'down', 'neutral']).optional().describe('Trend indicator'),
+  description: z.string().optional().describe('Description text'),
+  icon: z.string().optional().describe('Statistic icon'),
+});
+
+/**
+ * Badge Schema - Badge/tag component
+ */
+export const BadgeSchema = BaseSchema.extend({
+  type: z.literal('badge'),
+  label: z.string().optional().describe('Badge label'),
+  variant: z.enum(['default', 'secondary', 'destructive', 'outline']).optional().describe('Badge variant'),
+  icon: z.string().optional().describe('Badge icon'),
+  children: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).optional(),
+});
+
+/**
+ * Avatar Schema - Avatar/profile picture component
+ */
+export const AvatarSchema = BaseSchema.extend({
+  type: z.literal('avatar'),
+  src: z.string().optional().describe('Image source URL'),
+  alt: z.string().optional().describe('Alt text'),
+  fallback: z.string().optional().describe('Fallback text/initials'),
+  size: z.enum(['sm', 'default', 'lg', 'xl']).optional().describe('Avatar size'),
+  shape: z.enum(['circle', 'square']).optional().describe('Avatar shape'),
+});
+
+/**
+ * List Item Schema
+ */
+export const ListItemSchema = z.object({
+  id: z.string().optional().describe('Item ID'),
+  label: z.string().optional().describe('Item label'),
+  description: z.string().optional().describe('Item description'),
+  icon: z.string().optional().describe('Item icon'),
+  avatar: z.string().optional().describe('Item avatar URL'),
+  disabled: z.boolean().optional().describe('Whether item is disabled'),
+  onClick: z.function().optional().describe('Click handler'),
+  content: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).optional().describe('Custom content'),
+});
+
+/**
+ * List Schema - List component
+ */
+export const ListSchema = BaseSchema.extend({
+  type: z.literal('list'),
+  items: z.array(ListItemSchema).describe('List items'),
+  ordered: z.boolean().optional().describe('Whether list is ordered'),
+  dividers: z.boolean().optional().describe('Show dividers between items'),
+  dense: z.boolean().optional().describe('Dense spacing'),
+});
+
+/**
+ * Table Column Schema
+ */
+export const TableColumnSchema = z.object({
+  header: z.string().describe('Column header text'),
+  accessorKey: z.string().describe('Data accessor key'),
+  className: z.string().optional().describe('Column class name'),
+  cellClassName: z.string().optional().describe('Cell class name'),
+  width: z.union([z.string(), z.number()]).optional().describe('Column width'),
+  minWidth: z.union([z.string(), z.number()]).optional().describe('Minimum width'),
+  align: z.enum(['left', 'center', 'right']).optional().describe('Column alignment'),
+  fixed: z.enum(['left', 'right']).optional().describe('Fixed column position'),
+  type: z.string().optional().describe('Column type'),
+  sortable: z.boolean().optional().describe('Whether column is sortable'),
+  filterable: z.boolean().optional().describe('Whether column is filterable'),
+  resizable: z.boolean().optional().describe('Whether column is resizable'),
+  cell: z.function().optional().describe('Custom cell renderer'),
+});
+
+/**
+ * Table Schema - Simple table component
+ */
+export const TableSchema = BaseSchema.extend({
+  type: z.literal('table'),
+  caption: z.string().optional().describe('Table caption'),
+  columns: z.array(TableColumnSchema).describe('Table columns'),
+  data: z.array(z.any()).describe('Table data'),
+  footer: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).optional().describe('Table footer'),
+  hoverable: z.boolean().optional().describe('Highlight rows on hover'),
+  striped: z.boolean().optional().describe('Striped rows'),
+});
+
+/**
+ * Data Table Schema - Advanced data table with features
+ */
+export const DataTableSchema = BaseSchema.extend({
+  type: z.literal('data-table'),
+  caption: z.string().optional().describe('Table caption'),
+  toolbar: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).optional().describe('Toolbar content'),
+  columns: z.array(TableColumnSchema).describe('Table columns'),
+  data: z.array(z.any()).describe('Table data'),
+  pagination: z.boolean().optional().describe('Enable pagination'),
+  pageSize: z.number().optional().describe('Default page size'),
+  searchable: z.boolean().optional().describe('Enable search'),
+  selectable: z.boolean().optional().describe('Enable row selection'),
+  sortable: z.boolean().optional().describe('Enable sorting'),
+  exportable: z.boolean().optional().describe('Enable data export'),
+  rowActions: z.array(z.any()).optional().describe('Row action buttons'),
+  resizableColumns: z.boolean().optional().describe('Allow column resizing'),
+  reorderableColumns: z.boolean().optional().describe('Allow column reordering'),
+  onRowEdit: z.function().optional().describe('Row edit handler'),
+  onRowDelete: z.function().optional().describe('Row delete handler'),
+  onSelectionChange: z.function().optional().describe('Selection change handler'),
+  onColumnsReorder: z.function().optional().describe('Column reorder handler'),
+});
+
+/**
+ * Markdown Schema - Markdown content renderer
+ */
+export const MarkdownSchema = BaseSchema.extend({
+  type: z.literal('markdown'),
+  content: z.string().describe('Markdown content'),
+  sanitize: z.boolean().optional().describe('Sanitize HTML'),
+  components: z.record(z.string(), z.any()).optional().describe('Custom component overrides'),
+});
+
+/**
+ * Tree Node Schema
+ */
+export const TreeNodeSchema: z.ZodType<any> = z.lazy(() =>
+  z.object({
+    id: z.string().describe('Node ID'),
+    label: z.string().describe('Node label'),
+    icon: z.string().optional().describe('Node icon'),
+    defaultExpanded: z.boolean().optional().describe('Default expanded state'),
+    selectable: z.boolean().optional().describe('Whether node is selectable'),
+    children: z.array(TreeNodeSchema).optional().describe('Child nodes'),
+    data: z.any().optional().describe('Custom node data'),
+  })
+);
+
+/**
+ * Tree View Schema - Tree/hierarchical view component
+ */
+export const TreeViewSchema = BaseSchema.extend({
+  type: z.literal('tree-view'),
+  data: z.array(TreeNodeSchema).describe('Tree data'),
+  defaultExpandedIds: z.array(z.string()).optional().describe('Default expanded node IDs'),
+  defaultSelectedIds: z.array(z.string()).optional().describe('Default selected node IDs'),
+  expandedIds: z.array(z.string()).optional().describe('Controlled expanded node IDs'),
+  selectedIds: z.array(z.string()).optional().describe('Controlled selected node IDs'),
+  multiSelect: z.boolean().optional().describe('Allow multiple selection'),
+  showLines: z.boolean().optional().describe('Show connecting lines'),
+  onSelectChange: z.function().optional().describe('Selection change handler'),
+  onExpandChange: z.function().optional().describe('Expand change handler'),
+});
+
+/**
+ * Chart Type Enum
+ */
+export const ChartTypeSchema = z.enum([
+  'line',
+  'bar',
+  'area',
+  'pie',
+  'donut',
+  'radar',
+  'scatter',
+]);
+
+/**
+ * Chart Series Schema
+ */
+export const ChartSeriesSchema = z.object({
+  name: z.string().describe('Series name'),
+  data: z.array(z.number()).describe('Series data points'),
+  color: z.string().optional().describe('Series color'),
+});
+
+/**
+ * Chart Schema - Chart/graph component
+ */
+export const ChartSchema = BaseSchema.extend({
+  type: z.literal('chart'),
+  chartType: ChartTypeSchema.describe('Chart type'),
+  title: z.string().optional().describe('Chart title'),
+  description: z.string().optional().describe('Chart description'),
+  categories: z.array(z.string()).optional().describe('X-axis categories'),
+  series: z.array(ChartSeriesSchema).describe('Chart data series'),
+  height: z.union([z.string(), z.number()]).optional().describe('Chart height'),
+  width: z.union([z.string(), z.number()]).optional().describe('Chart width'),
+  showLegend: z.boolean().optional().describe('Show legend'),
+  showGrid: z.boolean().optional().describe('Show grid lines'),
+  animate: z.boolean().optional().describe('Enable animations'),
+  config: z.record(z.string(), z.any()).optional().describe('Additional chart configuration'),
+});
+
+/**
+ * Timeline Event Schema
+ */
+export const TimelineEventSchema = z.object({
+  id: z.string().optional().describe('Event ID'),
+  title: z.string().describe('Event title'),
+  description: z.string().optional().describe('Event description'),
+  date: z.union([z.string(), z.date()]).describe('Event date'),
+  icon: z.string().optional().describe('Event icon'),
+  color: z.string().optional().describe('Event color'),
+  content: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).optional().describe('Custom content'),
+});
+
+/**
+ * Timeline Schema - Timeline component
+ */
+export const TimelineSchema = BaseSchema.extend({
+  type: z.literal('timeline'),
+  events: z.array(TimelineEventSchema).describe('Timeline events'),
+  orientation: z.enum(['vertical', 'horizontal']).optional().describe('Timeline orientation'),
+  position: z.enum(['left', 'right', 'alternate']).optional().describe('Event position'),
+});
+
+/**
+ * Keyboard Key Schema - Keyboard key display
+ */
+export const KbdSchema = BaseSchema.extend({
+  type: z.literal('kbd'),
+  label: z.string().optional().describe('Key label'),
+  keys: z.union([z.string(), z.array(z.string())]).optional().describe('Key(s) to display'),
+});
+
+/**
+ * HTML Schema - Raw HTML renderer
+ */
+export const HtmlSchema = BaseSchema.extend({
+  type: z.literal('html'),
+  html: z.string().describe('HTML content'),
+});
+
+/**
+ * Data Display Schema Union - All data display component schemas
+ */
+export const DataDisplaySchema = z.union([
+  AlertSchema,
+  StatisticSchema,
+  BadgeSchema,
+  AvatarSchema,
+  ListSchema,
+  TableSchema,
+  DataTableSchema,
+  MarkdownSchema,
+  TreeViewSchema,
+  ChartSchema,
+  TimelineSchema,
+  KbdSchema,
+  HtmlSchema,
+]);

package/src/zod/disclosure.zod.ts

@@ -0,0 +1,92 @@
+/**
+ * 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/zod - Disclosure Component Zod Validators
+ * 
+ * Zod validation schemas for collapsible/disclosure components.
+ * Following @objectstack/spec UI specification format.
+ * 
+ * @module zod/disclosure
+ * @packageDocumentation
+ */
+
+import { z } from 'zod';
+import { BaseSchema, SchemaNodeSchema } from './base.zod.js';
+
+/**
+ * Accordion Item Schema
+ */
+export const AccordionItemSchema = z.object({
+  value: z.string().describe('Unique accordion item identifier'),
+  title: z.string().describe('Accordion item title'),
+  content: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).describe('Accordion item content'),
+  disabled: z.boolean().optional().describe('Whether item is disabled'),
+  icon: z.string().optional().describe('Item icon'),
+});
+
+/**
+ * Accordion Schema - Accordion component
+ */
+export const AccordionSchema = BaseSchema.extend({
+  type: z.literal('accordion'),
+  items: z.array(AccordionItemSchema).describe('Accordion items'),
+  accordionType: z.enum(['single', 'multiple']).optional().describe('Accordion type'),
+  collapsible: z.boolean().optional().describe('Whether items can be collapsed'),
+  defaultValue: z.union([z.string(), z.array(z.string())]).optional().describe('Default open item(s)'),
+  value: z.union([z.string(), z.array(z.string())]).optional().describe('Controlled open item(s)'),
+  onValueChange: z.function().optional().describe('Value change handler'),
+  variant: z.enum(['default', 'bordered', 'separated']).optional().describe('Accordion variant'),
+});
+
+/**
+ * Collapsible Schema - Collapsible component
+ */
+export const CollapsibleSchema = BaseSchema.extend({
+  type: z.literal('collapsible'),
+  trigger: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).describe('Trigger content'),
+  content: z.union([SchemaNodeSchema, z.array(SchemaNodeSchema)]).describe('Collapsible content'),
+  defaultOpen: z.boolean().optional().describe('Default open state'),
+  open: z.boolean().optional().describe('Controlled open state'),
+  disabled: z.boolean().optional().describe('Whether collapsible is disabled'),
+  onOpenChange: z.function().optional().describe('Open change handler'),
+});
+
+/**
+ * Toggle Group Item Schema
+ */
+export const ToggleGroupItemSchema = z.object({
+  value: z.string().describe('Item value'),
+  label: z.string().describe('Item label'),
+  icon: z.string().optional().describe('Item icon'),
+  disabled: z.boolean().optional().describe('Whether item is disabled'),
+});
+
+/**
+ * Toggle Group Schema - Toggle group component
+ */
+export const ToggleGroupSchema = BaseSchema.extend({
+  type: z.literal('toggle-group'),
+  selectionType: z.enum(['single', 'multiple']).optional().describe('Selection type'),
+  variant: z.enum(['default', 'outline']).optional().describe('Toggle group variant'),
+  size: z.enum(['default', 'sm', 'lg']).optional().describe('Toggle group size'),
+  items: z.array(ToggleGroupItemSchema).optional().describe('Toggle group items'),
+  defaultValue: z.union([z.string(), z.array(z.string())]).optional().describe('Default value(s)'),
+  value: z.union([z.string(), z.array(z.string())]).optional().describe('Controlled value(s)'),
+  disabled: z.boolean().optional().describe('Whether toggle group is disabled'),
+  onValueChange: z.function().optional().describe('Value change handler'),
+});
+
+/**
+ * Disclosure Schema Union - All disclosure component schemas
+ */
+export const DisclosureSchema = z.union([
+  AccordionSchema,
+  CollapsibleSchema,
+  ToggleGroupSchema,
+]);