Merge pull request #34 from objectstack-ai/copilot/add-field-widget-contract

Author: huangyiirene

content/docs/references/data/Trigger.mdx

@@ -0,0 +1,16 @@
+---
+title: Trigger
+description: Trigger Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Trigger name (snake_case) |
+| **object** | `string` | ✅ | Target object name |
+| **timing** | `Enum<'before' \| 'after'>` | ✅ | Execution timing |
+| **action** | `Enum<'insert' \| 'update' \| 'delete'> \| Enum<'insert' \| 'update' \| 'delete'>[]` | ✅ | Database operation(s) to trigger on |
+| **description** | `string` | optional | Trigger description |
+| **active** | `boolean` | optional | Is trigger active |
+| **order** | `number` | optional | Execution order |

content/docs/references/data/TriggerAction.mdx

@@ -0,0 +1,10 @@
+---
+title: TriggerAction
+description: TriggerAction Schema Reference
+---
+
+## Allowed Values
+
+* `insert`
+* `update`
+* `delete`

content/docs/references/data/TriggerContext.mdx

@@ -0,0 +1,17 @@
+---
+title: TriggerContext
+description: TriggerContext Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **action** | `Enum<'insert' \| 'update' \| 'delete'>` | ✅ | Database operation type |
+| **timing** | `Enum<'before' \| 'after'>` | ✅ | Trigger execution timing |
+| **doc** | `Record<string, any>` | ✅ | Current document/record |
+| **previousDoc** | `Record<string, any>` | optional | Previous document state |
+| **userId** | `string` | ✅ | Current user ID |
+| **user** | `Record<string, any>` | ✅ | Current user record |
+| **ql** | `any` | optional | ObjectQL data access API |
+| **logger** | `any` | optional | Logging interface |

content/docs/references/data/TriggerTiming.mdx

@@ -0,0 +1,9 @@
+---
+title: TriggerTiming
+description: TriggerTiming Schema Reference
+---
+
+## Allowed Values
+
+* `before`
+* `after`

content/docs/references/system/DriverCapabilities.mdx

@@ -0,0 +1,14 @@
+---
+title: DriverCapabilities
+description: DriverCapabilities Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **transactions** | `boolean` | ✅ | Supports transactions |
+| **joins** | `boolean` | ✅ | Supports SQL joins |
+| **fullTextSearch** | `boolean` | ✅ | Supports full-text search |
+| **jsonFields** | `boolean` | ✅ | Supports JSON field types |
+| **arrayFields** | `boolean` | ✅ | Supports array field types |

content/docs/references/system/DriverInterface.mdx

@@ -0,0 +1,12 @@
+---
+title: DriverInterface
+description: DriverInterface Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Driver name |
+| **version** | `string` | ✅ | Driver version |
+| **supports** | `object` | ✅ | Driver capabilities |

content/docs/references/system/Plugin.mdx

@@ -0,0 +1,11 @@
+---
+title: Plugin
+description: Plugin Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **id** | `string` | optional | Plugin identifier |
+| **version** | `string` | optional | Plugin version |

content/docs/references/system/PluginContext.mdx

@@ -0,0 +1,14 @@
+---
+title: PluginContext
+description: PluginContext Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **ql** | `any` | optional | ObjectQL data access API |
+| **os** | `any` | optional | ObjectOS system API |
+| **logger** | `any` | optional | Logging interface |
+| **metadata** | `any` | optional | Metadata registry |
+| **events** | `any` | optional | Event bus |

content/docs/references/system/PluginLifecycle.mdx

@@ -0,0 +1,9 @@
+---
+title: PluginLifecycle
+description: PluginLifecycle Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |

content/docs/references/ui/FieldWidgetProps.mdx

@@ -0,0 +1,16 @@
+---
+title: FieldWidgetProps
+description: FieldWidgetProps Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **value** | `any` | optional | Current field value |
+| **readonly** | `boolean` | optional | Read-only mode flag |
+| **required** | `boolean` | optional | Required field flag |
+| **error** | `string` | optional | Validation error message |
+| **field** | `object` | ✅ | Field schema definition |
+| **record** | `Record<string, any>` | optional | Complete record data |
+| **options** | `Record<string, any>` | optional | Custom widget options |