@objectstack/spec 6.7.0 → 6.8.0

package/dist/ui/index.js

@@ -428,6 +428,11 @@ var ActionNavItemSchema = lazySchema(() => BaseNavItemSchema.extend({
     params: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Parameters passed to the action")
   }).describe("Action definition to execute when clicked")
 }));
+var ComponentNavItemSchema = lazySchema(() => BaseNavItemSchema.extend({
+  type: zod.z.literal("component"),
+  componentRef: zod.z.string().describe('Component registry key (e.g. "metadata:directory")'),
+  params: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Props passed to the component")
+}));
 var GroupNavItemSchema = lazySchema(() => BaseNavItemSchema.extend({
   type: zod.z.literal("group"),
   expanded: zod.z.boolean().default(false).describe("Default expansion state in sidebar")
@@ -443,6 +448,7 @@ var NavigationItemSchema = zod.z.lazy(
     UrlNavItemSchema,
     ReportNavItemSchema,
     ActionNavItemSchema,
+    ComponentNavItemSchema,
     GroupNavItemSchema.extend({
       children: zod.z.array(NavigationItemSchema).describe("Child navigation items")
     })
@@ -568,1401 +574,1843 @@ var App = {
 function defineApp(config) {
   return AppSchema.parse(config);
 }
-var HttpMethod = zod.z.enum([
-  "GET",
-  "POST",
-  "PUT",
-  "DELETE",
-  "PATCH",
-  "HEAD",
-  "OPTIONS"
+var EncryptionAlgorithmSchema = lazySchema(() => zod.z.enum([
+  "aes-256-gcm",
+  "aes-256-cbc",
+  "chacha20-poly1305"
+]).describe("Supported encryption algorithm"));
+var KeyManagementProviderSchema = lazySchema(() => zod.z.enum([
+  "local",
+  "aws-kms",
+  "azure-key-vault",
+  "gcp-kms",
+  "hashicorp-vault"
+]).describe("Key management service provider"));
+var KeyRotationPolicySchema = lazySchema(() => zod.z.object({
+  enabled: zod.z.boolean().default(false).describe("Enable automatic key rotation"),
+  frequencyDays: zod.z.number().min(1).default(90).describe("Rotation frequency in days"),
+  retainOldVersions: zod.z.number().default(3).describe("Number of old key versions to retain"),
+  autoRotate: zod.z.boolean().default(true).describe("Automatically rotate without manual approval")
+}).describe("Policy for automatic encryption key rotation"));
+var EncryptionConfigSchema = lazySchema(() => zod.z.object({
+  enabled: zod.z.boolean().default(false).describe("Enable field-level encryption"),
+  algorithm: EncryptionAlgorithmSchema.default("aes-256-gcm").describe("Encryption algorithm"),
+  keyManagement: zod.z.object({
+    provider: KeyManagementProviderSchema.describe("Key management service provider"),
+    keyId: zod.z.string().optional().describe("Key identifier in the provider"),
+    rotationPolicy: KeyRotationPolicySchema.optional().describe("Key rotation policy")
+  }).describe("Key management configuration"),
+  scope: zod.z.enum(["field", "record", "table", "database"]).describe("Encryption scope level"),
+  deterministicEncryption: zod.z.boolean().default(false).describe("Allows equality queries on encrypted data"),
+  searchableEncryption: zod.z.boolean().default(false).describe("Allows search on encrypted data")
+}).describe("Field-level encryption configuration"));
+lazySchema(() => zod.z.object({
+  fieldName: zod.z.string().describe("Name of the field to encrypt"),
+  encryptionConfig: EncryptionConfigSchema.describe("Encryption settings for this field"),
+  indexable: zod.z.boolean().default(false).describe("Allow indexing on encrypted field")
+}).describe("Per-field encryption assignment"));
+var MaskingStrategySchema = lazySchema(() => zod.z.enum([
+  "redact",
+  // Complete redaction: ****
+  "partial",
+  // Partial masking: 138****5678
+  "hash",
+  // Hash value: sha256(value)
+  "tokenize",
+  // Tokenization: token-12345
+  "randomize",
+  // Randomize: generate random value
+  "nullify",
+  // Null value: null
+  "substitute"
+  // Substitute with dummy data
+]).describe("Data masking strategy for PII protection"));
+var MaskingRuleSchema = lazySchema(() => zod.z.object({
+  field: zod.z.string().describe("Field name to apply masking to"),
+  strategy: MaskingStrategySchema.describe("Masking strategy to use"),
+  pattern: zod.z.string().optional().describe("Regex pattern for partial masking"),
+  preserveFormat: zod.z.boolean().default(true).describe("Keep the original data format after masking"),
+  preserveLength: zod.z.boolean().default(true).describe("Keep the original data length after masking"),
+  roles: zod.z.array(zod.z.string()).optional().describe("Roles that see masked data"),
+  exemptRoles: zod.z.array(zod.z.string()).optional().describe("Roles that see unmasked data")
+}).describe("Masking rule for a single field"));
+lazySchema(() => zod.z.object({
+  enabled: zod.z.boolean().default(false).describe("Enable data masking"),
+  rules: zod.z.array(MaskingRuleSchema).describe("List of field-level masking rules"),
+  auditUnmasking: zod.z.boolean().default(true).describe("Log when masked data is accessed unmasked")
+}).describe("Top-level data masking configuration for PII protection"));
+
+// src/data/field.zod.ts
+var FieldType = zod.z.enum([
+  // Core Text
+  "text",
+  "textarea",
+  "email",
+  "url",
+  "phone",
+  "password",
+  // Rich Content
+  "markdown",
+  "html",
+  "richtext",
+  // Numbers
+  "number",
+  "currency",
+  "percent",
+  // Date & Time
+  "date",
+  "datetime",
+  "time",
+  // Logic
+  "boolean",
+  "toggle",
+  // Toggle is a distinct UI from checkbox
+  // Selection
+  "select",
+  // Single select dropdown
+  "multiselect",
+  // Multi select (often tags)
+  "radio",
+  // Radio group
+  "checkboxes",
+  // Checkbox group
+  // Relational
+  "lookup",
+  "master_detail",
+  // Dynamic reference
+  "tree",
+  // Hierarchical reference
+  // Media
+  "image",
+  "file",
+  "avatar",
+  "video",
+  "audio",
+  // Calculated / System
+  "formula",
+  "summary",
+  "autonumber",
+  // Embedded structured values (stored as JSON on the parent row — no separate table / FK)
+  "composite",
+  // Single embedded sub-object with declared sub-fields  (≈ Strapi component / ACF group)
+  "repeater",
+  // Repeating embedded sub-object array with declared sub-fields  (≈ Strapi repeatable component / ACF repeater)
+  // Enhanced Types
+  "location",
+  // GPS coordinates
+  "address",
+  // Structured address
+  "code",
+  // Code editor (JSON/SQL/JS)
+  "json",
+  // Structured JSON data (untyped escape hatch)
+  "color",
+  // Color picker
+  "rating",
+  // Star rating
+  "slider",
+  // Numeric slider
+  "signature",
+  // Digital signature
+  "qrcode",
+  // QR code / Barcode
+  "progress",
+  // Progress bar
+  "tags",
+  // Simple tag list
+  // AI/ML Types
+  "vector"
+  // Vector embeddings for AI/ML (semantic search, RAG)
 ]);
-var HttpMethodSchema = lazySchema(() => zod.z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]));
-var HttpRequestSchema = lazySchema(() => zod.z.object({
-  url: zod.z.string().describe("API endpoint URL"),
-  method: HttpMethodSchema.optional().default("GET").describe("HTTP method"),
-  headers: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Custom HTTP headers"),
-  params: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Query parameters"),
-  body: zod.z.unknown().optional().describe("Request body for POST/PUT/PATCH")
+var SelectOptionSchema = lazySchema(() => zod.z.object({
+  label: zod.z.string().describe("Display label (human-readable, any case allowed)"),
+  value: SystemIdentifierSchema.describe("Stored value (lowercase machine identifier)"),
+  color: zod.z.string().optional().describe("Color code for badges/charts"),
+  default: zod.z.boolean().optional().describe("Is default option")
 }));
 lazySchema(() => zod.z.object({
-  /**
-   * Enable CORS
-   */
-  enabled: zod.z.boolean().default(true).describe("Enable CORS"),
-  /**
-   * Allowed origins (* for all)
-   */
-  origins: zod.z.union([
-    zod.z.string(),
-    zod.z.array(zod.z.string())
-  ]).default("*").describe("Allowed origins (* for all)"),
-  /**
-   * Allowed HTTP methods
-   */
-  methods: zod.z.array(HttpMethod).optional().describe("Allowed HTTP methods"),
-  /**
-   * Allow credentials (cookies, authorization headers)
-   */
-  credentials: zod.z.boolean().default(false).describe("Allow credentials (cookies, authorization headers)"),
-  /**
-   * Preflight cache duration in seconds
-   */
-  maxAge: zod.z.number().int().optional().describe("Preflight cache duration in seconds")
+  latitude: zod.z.number().min(-90).max(90).describe("Latitude coordinate"),
+  longitude: zod.z.number().min(-180).max(180).describe("Longitude coordinate"),
+  altitude: zod.z.number().optional().describe("Altitude in meters"),
+  accuracy: zod.z.number().optional().describe("Accuracy in meters")
+}));
+var CurrencyConfigSchema = lazySchema(() => zod.z.object({
+  precision: zod.z.number().int().min(0).max(10).default(2).describe("Decimal precision (default: 2)"),
+  currencyMode: zod.z.enum(["dynamic", "fixed"]).default("dynamic").describe("Currency mode: dynamic (user selectable) or fixed (single currency)"),
+  defaultCurrency: zod.z.string().length(3).default("CNY").describe("Default or fixed currency code (ISO 4217, e.g., USD, CNY, EUR)")
 }));
 lazySchema(() => zod.z.object({
-  /**
-   * Enable rate limiting
-   */
-  enabled: zod.z.boolean().default(false).describe("Enable rate limiting"),
-  /**
-   * Time window in milliseconds
-   */
-  windowMs: zod.z.number().int().default(6e4).describe("Time window in milliseconds"),
-  /**
-   * Max requests per window
-   */
-  maxRequests: zod.z.number().int().default(100).describe("Max requests per window")
+  value: zod.z.number().describe("Monetary amount"),
+  currency: zod.z.string().length(3).describe("Currency code (ISO 4217)")
 }));
 lazySchema(() => zod.z.object({
-  /**
-   * URL path to serve from
-   */
-  path: zod.z.string().describe("URL path to serve from"),
-  /**
-   * Physical directory to serve
-   */
-  directory: zod.z.string().describe("Physical directory to serve"),
-  /**
-   * Cache-Control header value
-   */
-  cacheControl: zod.z.string().optional().describe("Cache-Control header value")
+  street: zod.z.string().optional().describe("Street address"),
+  city: zod.z.string().optional().describe("City name"),
+  state: zod.z.string().optional().describe("State/Province"),
+  postalCode: zod.z.string().optional().describe("Postal/ZIP code"),
+  country: zod.z.string().optional().describe("Country name or code"),
+  countryCode: zod.z.string().optional().describe("ISO country code (e.g., US, GB)"),
+  formatted: zod.z.string().optional().describe("Formatted address string")
 }));
-
-// src/ui/view.zod.ts
-var ViewDataSchema = lazySchema(() => zod.z.discriminatedUnion("provider", [
-  zod.z.object({
-    provider: zod.z.literal("object"),
-    object: zod.z.string().describe("Target object name")
-  }),
-  zod.z.object({
-    provider: zod.z.literal("api"),
-    read: HttpRequestSchema.optional().describe("Configuration for fetching data"),
-    write: HttpRequestSchema.optional().describe("Configuration for submitting data (for forms/editable tables)")
-  }),
-  zod.z.object({
-    provider: zod.z.literal("value"),
-    items: zod.z.array(zod.z.unknown()).describe("Static data array")
-  })
-]));
-var ViewFilterRuleSchema = lazySchema(() => zod.z.object({
-  /** Field name to filter on */
-  field: zod.z.string().describe("Field name to filter on"),
-  /** Filter operator */
-  operator: zod.z.string().describe("Filter operator (e.g. equals, not_equals, contains, this_quarter)"),
-  /** Filter value (optional for unary operators like is_null, this_quarter) */
-  value: zod.z.union([zod.z.string(), zod.z.number(), zod.z.boolean(), zod.z.null(), zod.z.array(zod.z.union([zod.z.string(), zod.z.number()]))]).optional().describe("Filter value")
-}).describe("View filter rule"));
-var ColumnSummarySchema = lazySchema(() => zod.z.enum([
-  "none",
-  "count",
-  "count_empty",
-  "count_filled",
-  "count_unique",
-  "percent_empty",
-  "percent_filled",
-  "sum",
-  "avg",
-  "min",
-  "max"
-]).describe("Aggregation function for column footer summary"));
-var ListColumnSchema = lazySchema(() => zod.z.object({
-  field: zod.z.string().describe("Field name (snake_case)"),
-  label: I18nLabelSchema.optional().describe("Display label override"),
-  width: zod.z.number().positive().optional().describe("Column width in pixels"),
-  align: zod.z.enum(["left", "center", "right"]).optional().describe("Text alignment"),
-  hidden: zod.z.boolean().optional().describe("Hide column by default"),
-  sortable: zod.z.boolean().optional().describe("Allow sorting by this column"),
-  resizable: zod.z.boolean().optional().describe("Allow resizing this column"),
-  wrap: zod.z.boolean().optional().describe("Allow text wrapping"),
-  type: zod.z.string().optional().describe('Renderer type override (e.g., "currency", "date")'),
-  /** Pinning (Airtable-style frozen columns) */
-  pinned: zod.z.enum(["left", "right"]).optional().describe("Pin/freeze column to left or right side"),
-  /** Column Footer Summary (Airtable-style aggregation) */
-  summary: ColumnSummarySchema.optional().describe("Footer aggregation function for this column"),
-  /** Interaction */
-  link: zod.z.boolean().optional().describe("Functions as the primary navigation link (triggers View navigation)"),
-  action: zod.z.string().optional().describe("Registered Action ID to execute when clicked")
-}));
-var SelectionConfigSchema = lazySchema(() => zod.z.object({
-  type: zod.z.enum(["none", "single", "multiple"]).default("none").describe("Selection mode")
-}));
-var PaginationConfigSchema = lazySchema(() => zod.z.object({
-  pageSize: zod.z.number().int().positive().default(25).describe("Number of records per page"),
-  pageSizeOptions: zod.z.array(zod.z.number().int().positive()).optional().describe("Available page size options")
-}));
-var RowHeightSchema = lazySchema(() => zod.z.enum([
-  "compact",
-  // Minimal padding, single line
-  "short",
-  // Reduced padding
-  "medium",
-  // Default padding
-  "tall",
-  // Extra padding, multi-line preview
-  "extra_tall"
-  // Maximum padding, rich content preview
-]).describe("Row height / density setting for list view"));
-var GroupingFieldSchema = lazySchema(() => zod.z.object({
-  field: zod.z.string().describe("Field name to group by"),
-  order: zod.z.enum(["asc", "desc"]).default("asc").describe("Group sort order"),
-  collapsed: zod.z.boolean().default(false).describe("Collapse groups by default")
-}));
-var GroupingConfigSchema = lazySchema(() => zod.z.object({
-  fields: zod.z.array(GroupingFieldSchema).min(1).describe("Fields to group by (supports up to 3 levels)")
-}).describe("Record grouping configuration"));
-var GalleryConfigSchema = lazySchema(() => zod.z.object({
-  coverField: zod.z.string().optional().describe("Attachment/image field to display as card cover"),
-  coverFit: zod.z.enum(["cover", "contain"]).default("cover").describe("Image fit mode for card cover"),
-  cardSize: zod.z.enum(["small", "medium", "large"]).default("medium").describe("Card size in gallery view"),
-  titleField: zod.z.string().optional().describe("Field to display as card title"),
-  visibleFields: zod.z.array(zod.z.string()).optional().describe("Fields to display on card body")
-}).describe("Gallery/card view configuration"));
-var TimelineConfigSchema = lazySchema(() => zod.z.object({
-  startDateField: zod.z.string().describe("Field for timeline item start date"),
-  endDateField: zod.z.string().optional().describe("Field for timeline item end date"),
-  titleField: zod.z.string().describe("Field to display as timeline item title"),
-  groupByField: zod.z.string().optional().describe("Field to group timeline rows"),
-  colorField: zod.z.string().optional().describe("Field to determine item color"),
-  scale: zod.z.enum(["hour", "day", "week", "month", "quarter", "year"]).default("week").describe("Default timeline scale")
-}).describe("Timeline view configuration"));
-var ViewSharingSchema = lazySchema(() => zod.z.object({
-  type: zod.z.enum(["personal", "collaborative"]).default("collaborative").describe("View ownership type"),
-  lockedBy: zod.z.string().optional().describe("User who locked the view configuration")
-}).describe("View sharing and access configuration"));
-var RowColorConfigSchema = lazySchema(() => zod.z.object({
-  field: zod.z.string().describe("Field to derive color from (typically a select/status field)"),
-  colors: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Map of field value to color (hex/token)")
-}).describe("Row color configuration based on field values"));
-var VisualizationTypeSchema = lazySchema(() => zod.z.enum([
-  "grid",
-  "kanban",
-  "gallery",
-  "calendar",
-  "timeline",
-  "gantt",
-  "map"
-]).describe("Visualization type that users can switch to"));
-var UserActionsConfigSchema = lazySchema(() => zod.z.object({
-  sort: zod.z.boolean().default(true).describe("Allow users to sort records"),
-  search: zod.z.boolean().default(true).describe("Allow users to search records"),
-  filter: zod.z.boolean().default(true).describe("Allow users to filter records"),
-  rowHeight: zod.z.boolean().default(true).describe("Allow users to toggle row height/density"),
-  addRecordForm: zod.z.boolean().default(false).describe("Add records through a form instead of inline"),
-  buttons: zod.z.array(zod.z.string()).optional().describe("Custom action button IDs to show in the toolbar")
-}).describe("User action toggles for the view toolbar"));
-var AppearanceConfigSchema = lazySchema(() => zod.z.object({
-  showDescription: zod.z.boolean().default(true).describe("Show the view description text"),
-  allowedVisualizations: zod.z.array(VisualizationTypeSchema).optional().describe('Whitelist of visualization types users can switch between (e.g. ["grid", "gallery", "kanban"])')
-}).describe("Appearance and visualization configuration"));
-var ViewTabSchema = lazySchema(() => zod.z.object({
-  name: SnakeCaseIdentifierSchema.describe("Tab identifier (snake_case)"),
-  label: I18nLabelSchema.optional().describe("Display label"),
-  icon: zod.z.string().optional().describe("Tab icon name"),
-  view: zod.z.string().optional().describe("Referenced list view name from listViews"),
-  filter: zod.z.array(ViewFilterRuleSchema).optional().describe("Tab-specific filter criteria"),
-  order: zod.z.number().int().min(0).optional().describe("Tab display order"),
-  pinned: zod.z.boolean().default(false).describe("Pin tab (cannot be removed by users)"),
-  isDefault: zod.z.boolean().default(false).describe("Set as the default active tab"),
-  visible: zod.z.boolean().default(true).describe("Tab visibility")
-}).describe("Tab configuration for multi-tab view interface"));
-var AddRecordConfigSchema = lazySchema(() => zod.z.object({
-  enabled: zod.z.boolean().default(true).describe("Show the add record entry point"),
-  position: zod.z.enum(["top", "bottom", "both"]).default("bottom").describe("Position of the add record button"),
-  mode: zod.z.enum(["inline", "form", "modal"]).default("inline").describe("How to add a new record"),
-  formView: zod.z.string().optional().describe('Named form view to use when mode is "form" or "modal"')
-}).describe("Add record entry point configuration"));
-var KanbanConfigSchema = lazySchema(() => zod.z.object({
-  groupByField: zod.z.string().describe("Field to group columns by (usually status/select)"),
-  summarizeField: zod.z.string().optional().describe("Field to sum at top of column (e.g. amount)"),
-  columns: zod.z.array(zod.z.string()).describe("Fields to show on cards")
+var VectorConfigSchema = lazySchema(() => zod.z.object({
+  dimensions: zod.z.number().int().min(1).max(1e4).describe("Vector dimensionality (e.g., 1536 for OpenAI embeddings)"),
+  distanceMetric: zod.z.enum(["cosine", "euclidean", "dotProduct", "manhattan"]).default("cosine").describe("Distance/similarity metric for vector search"),
+  normalized: zod.z.boolean().default(false).describe("Whether vectors are normalized (unit length)"),
+  indexed: zod.z.boolean().default(true).describe("Whether to create a vector index for fast similarity search"),
+  indexType: zod.z.enum(["hnsw", "ivfflat", "flat"]).optional().describe("Vector index algorithm (HNSW for high accuracy, IVFFlat for large datasets)")
 }));
-var ListChartConfigSchema = lazySchema(() => zod.z.object({
-  chartType: zod.z.enum(["bar", "line", "pie", "area", "scatter"]).default("bar").describe("Chart visualisation type"),
-  xAxisField: zod.z.string().describe("Field used as the X axis / category dimension"),
-  yAxisFields: zod.z.array(zod.z.string()).min(1).describe("Field(s) used as the Y axis / measures"),
-  aggregation: zod.z.enum(["sum", "avg", "count", "min", "max"]).optional().describe("Aggregation function applied to Y axis fields"),
-  groupByField: zod.z.string().optional().describe("Optional field used to split / stack the chart")
-}).describe("List chart view configuration"));
-var CalendarConfigSchema = lazySchema(() => zod.z.object({
-  startDateField: zod.z.string(),
-  endDateField: zod.z.string().optional(),
-  titleField: zod.z.string(),
-  colorField: zod.z.string().optional()
+var FileAttachmentConfigSchema = lazySchema(() => zod.z.object({
+  /** File Size Limits */
+  minSize: zod.z.number().min(0).optional().describe("Minimum file size in bytes"),
+  maxSize: zod.z.number().min(1).optional().describe("Maximum file size in bytes (e.g., 10485760 = 10MB)"),
+  /** File Type Restrictions */
+  allowedTypes: zod.z.array(zod.z.string()).optional().describe('Allowed file extensions (e.g., [".pdf", ".docx", ".jpg"])'),
+  blockedTypes: zod.z.array(zod.z.string()).optional().describe('Blocked file extensions (e.g., [".exe", ".bat", ".sh"])'),
+  allowedMimeTypes: zod.z.array(zod.z.string()).optional().describe('Allowed MIME types (e.g., ["image/jpeg", "application/pdf"])'),
+  blockedMimeTypes: zod.z.array(zod.z.string()).optional().describe("Blocked MIME types"),
+  /** Virus Scanning */
+  virusScan: zod.z.boolean().default(false).describe("Enable virus scanning for uploaded files"),
+  virusScanProvider: zod.z.enum(["clamav", "virustotal", "metadefender", "custom"]).optional().describe("Virus scanning service provider"),
+  virusScanOnUpload: zod.z.boolean().default(true).describe("Scan files immediately on upload"),
+  quarantineOnThreat: zod.z.boolean().default(true).describe("Quarantine files if threat detected"),
+  /** Storage Configuration */
+  storageProvider: zod.z.string().optional().describe("Object storage provider name (references ObjectStorageConfig)"),
+  storageBucket: zod.z.string().optional().describe("Target bucket name"),
+  storagePrefix: zod.z.string().optional().describe('Storage path prefix (e.g., "uploads/documents/")'),
+  /** Image-Specific Validation */
+  imageValidation: zod.z.object({
+    minWidth: zod.z.number().min(1).optional().describe("Minimum image width in pixels"),
+    maxWidth: zod.z.number().min(1).optional().describe("Maximum image width in pixels"),
+    minHeight: zod.z.number().min(1).optional().describe("Minimum image height in pixels"),
+    maxHeight: zod.z.number().min(1).optional().describe("Maximum image height in pixels"),
+    aspectRatio: zod.z.string().optional().describe('Required aspect ratio (e.g., "16:9", "1:1")'),
+    generateThumbnails: zod.z.boolean().default(false).describe("Auto-generate thumbnails"),
+    thumbnailSizes: zod.z.array(zod.z.object({
+      name: zod.z.string().describe('Thumbnail variant name (e.g., "small", "medium", "large")'),
+      width: zod.z.number().min(1).describe("Thumbnail width in pixels"),
+      height: zod.z.number().min(1).describe("Thumbnail height in pixels"),
+      crop: zod.z.boolean().default(false).describe("Crop to exact dimensions")
+    })).optional().describe("Thumbnail size configurations"),
+    preserveMetadata: zod.z.boolean().default(false).describe("Preserve EXIF metadata"),
+    autoRotate: zod.z.boolean().default(true).describe("Auto-rotate based on EXIF orientation")
+  }).optional().describe("Image-specific validation rules"),
+  /** Upload Behavior */
+  allowMultiple: zod.z.boolean().default(false).describe("Allow multiple file uploads (overrides field.multiple)"),
+  allowReplace: zod.z.boolean().default(true).describe("Allow replacing existing files"),
+  allowDelete: zod.z.boolean().default(true).describe("Allow deleting uploaded files"),
+  requireUpload: zod.z.boolean().default(false).describe("Require at least one file when field is required"),
+  /** Metadata Extraction */
+  extractMetadata: zod.z.boolean().default(true).describe("Extract file metadata (name, size, type, etc.)"),
+  extractText: zod.z.boolean().default(false).describe("Extract text content from documents (OCR/parsing)"),
+  /** Versioning */
+  versioningEnabled: zod.z.boolean().default(false).describe("Keep previous versions of replaced files"),
+  maxVersions: zod.z.number().min(1).optional().describe("Maximum number of versions to retain"),
+  /** Access Control */
+  publicRead: zod.z.boolean().default(false).describe("Allow public read access to uploaded files"),
+  presignedUrlExpiry: zod.z.number().min(60).max(604800).default(3600).describe("Presigned URL expiration in seconds (default: 1 hour)")
+}).refine((data) => {
+  if (data.minSize !== void 0 && data.maxSize !== void 0 && data.minSize > data.maxSize) {
+    return false;
+  }
+  return true;
+}, {
+  message: "minSize must be less than or equal to maxSize"
+}).refine((data) => {
+  if (data.virusScanProvider !== void 0 && data.virusScan !== true) {
+    return false;
+  }
+  return true;
+}, {
+  message: "virusScanProvider requires virusScan to be enabled"
 }));
-var GanttConfigSchema = lazySchema(() => zod.z.object({
-  startDateField: zod.z.string(),
-  endDateField: zod.z.string(),
-  titleField: zod.z.string(),
-  progressField: zod.z.string().optional(),
-  dependenciesField: zod.z.string().optional()
+var DataQualityRulesSchema = lazySchema(() => zod.z.object({
+  /** Enforce uniqueness constraint */
+  uniqueness: zod.z.boolean().default(false).describe("Enforce unique values across all records"),
+  /** Completeness ratio (0-1) indicating minimum percentage of non-null values */
+  completeness: zod.z.number().min(0).max(1).default(0).describe("Minimum ratio of non-null values (0-1, default: 0 = no requirement)"),
+  /** Accuracy validation against authoritative source */
+  accuracy: zod.z.object({
+    source: zod.z.string().describe('Reference data source for validation (e.g., "api.verify.com", "master_data")'),
+    threshold: zod.z.number().min(0).max(1).describe("Minimum accuracy threshold (0-1, e.g., 0.95 = 95% match required)")
+  }).optional().describe("Accuracy validation configuration")
 }));
-var NavigationModeSchema = lazySchema(() => zod.z.enum([
-  "page",
-  // Navigate to a new route (default)
-  "drawer",
-  // Open details in a side drawer/panel
-  "modal",
-  // Open details in a modal dialog
-  "split",
-  // Show details side-by-side with the list (master-detail)
-  "popover",
-  // Show details in a popover (lightweight)
-  "new_window",
-  // Open in new browser tab/window
-  "none"
-  // No navigation (read-only list)
-]));
-var NavigationConfigSchema = lazySchema(() => zod.z.object({
-  mode: NavigationModeSchema.default("page"),
-  /** Target View Config */
-  view: zod.z.string().optional().describe('Name of the form view to use for details (e.g. "summary_view", "edit_form")'),
-  /** Interaction Triggers */
-  preventNavigation: zod.z.boolean().default(false).describe("Disable standard navigation entirely"),
-  openNewTab: zod.z.boolean().default(false).describe("Force open in new tab (applies to page mode)"),
-  /** Dimensions (for modal/drawer) */
-  width: zod.z.union([zod.z.string(), zod.z.number()]).optional().describe('Width of the drawer/modal (e.g. "600px", "50%")')
+var ComputedFieldCacheSchema = lazySchema(() => zod.z.object({
+  /** Enable caching for this computed field */
+  enabled: zod.z.boolean().describe("Enable caching for computed field results"),
+  /** Time-to-live in seconds */
+  ttl: zod.z.number().min(0).describe("Cache TTL in seconds (0 = no expiration)"),
+  /** Array of field paths that trigger cache invalidation when changed */
+  invalidateOn: zod.z.array(zod.z.string()).describe('Field paths that invalidate cache (e.g., ["inventory.quantity", "pricing.base_price"])')
 }));
-var ListViewSchema = lazySchema(() => zod.z.object({
-  name: SnakeCaseIdentifierSchema.optional().describe("Internal view name (lowercase snake_case)"),
-  label: I18nLabelSchema.optional(),
-  // Display label override (supports i18n)
-  type: zod.z.enum([
-    "grid",
-    // Standard Data Table
-    "kanban",
-    // Board / Columns
-    "gallery",
-    // Card Deck / Masonry
-    "calendar",
-    // Monthly/Weekly/Daily
-    "timeline",
-    // Chronological Stream (Feed)
-    "gantt",
-    // Project Timeline
-    "map",
-    // Geospatial
-    "chart"
-    // Aggregate visualisation
-  ]).default("grid"),
-  /** Data Source Configuration */
-  data: ViewDataSchema.optional().describe('Data source configuration (defaults to "object" provider)'),
-  /** Shared Query Config */
-  columns: zod.z.union([
-    zod.z.array(zod.z.string()),
-    // Legacy: simple field names
-    zod.z.array(ListColumnSchema)
-    // Enhanced: detailed column config
-  ]).describe("Fields to display as columns"),
-  filter: zod.z.array(ViewFilterRuleSchema).optional().describe("Filter criteria (JSON Rules)"),
-  sort: zod.z.union([
-    zod.z.string(),
-    //Legacy "field desc"
-    zod.z.array(zod.z.object({
-      field: zod.z.string(),
-      order: zod.z.enum(["asc", "desc"])
-    }))
-  ]).optional(),
-  /** Search & Filter */
-  searchableFields: zod.z.array(zod.z.string()).optional().describe("Fields enabled for search"),
-  filterableFields: zod.z.array(zod.z.string()).optional().describe("Fields enabled for end-user filtering in the top bar"),
-  /** Grid Features */
-  resizable: zod.z.boolean().optional().describe("Enable column resizing"),
-  striped: zod.z.boolean().optional().describe("Striped row styling"),
-  bordered: zod.z.boolean().optional().describe("Show borders"),
-  compactToolbar: zod.z.boolean().optional().describe("Collapse Group/Color/Density/Hide-fields into a single View settings popover"),
-  /** Selection */
-  selection: SelectionConfigSchema.optional().describe("Row selection configuration"),
-  /** Navigation / Interaction */
-  navigation: NavigationConfigSchema.optional().describe("Configuration for item click navigation (page, drawer, modal, etc.)"),
-  /** Pagination */
-  pagination: PaginationConfigSchema.optional().describe("Pagination configuration"),
-  /** Type Specific Config */
-  kanban: KanbanConfigSchema.optional(),
-  calendar: CalendarConfigSchema.optional(),
-  gantt: GanttConfigSchema.optional(),
-  gallery: GalleryConfigSchema.optional(),
-  timeline: TimelineConfigSchema.optional(),
-  chart: ListChartConfigSchema.optional(),
-  /** View Metadata (Airtable-style view management) */
-  description: I18nLabelSchema.optional().describe("View description for documentation/tooltips"),
-  sharing: ViewSharingSchema.optional().describe("View sharing and access configuration"),
-  /** Row Height / Density (Airtable-style) */
-  rowHeight: RowHeightSchema.optional().describe("Row height / density setting"),
-  /** Record Grouping (Airtable-style) */
-  grouping: GroupingConfigSchema.optional().describe("Group records by one or more fields"),
-  /** Row Color (Airtable-style) */
-  rowColor: RowColorConfigSchema.optional().describe("Color rows based on field value"),
-  /** Field Visibility & Ordering per View (Airtable-style) */
-  hiddenFields: zod.z.array(zod.z.string()).optional().describe("Fields to hide in this specific view"),
-  fieldOrder: zod.z.array(zod.z.string()).optional().describe("Explicit field display order for this view"),
-  /** Row & Bulk Actions */
-  rowActions: zod.z.array(zod.z.string()).optional().describe("Actions available for individual row items"),
-  bulkActions: zod.z.array(zod.z.string()).optional().describe("Actions available when multiple rows are selected"),
-  bulkActionDefs: zod.z.array(zod.z.record(zod.z.string(), zod.z.any())).optional().describe("Rich bulk action definitions (schema-driven, executed via BulkActionDialog)"),
-  /** Performance */
-  virtualScroll: zod.z.boolean().optional().describe("Enable virtual scrolling for large datasets"),
-  /** Conditional Formatting */
-  conditionalFormatting: zod.z.array(zod.z.object({
-    condition: ExpressionInputSchema.describe("Predicate (CEL) to evaluate."),
-    style: zod.z.record(zod.z.string(), zod.z.string()).describe("CSS styles to apply when condition is true")
-  })).optional().describe("Conditional formatting rules for list rows"),
-  /** Inline Edit */
-  inlineEdit: zod.z.boolean().optional().describe("Allow inline editing of records directly in the list view"),
-  /** Export */
-  exportOptions: zod.z.array(zod.z.enum(["csv", "xlsx", "pdf", "json"])).optional().describe("Available export format options"),
-  /** User Actions (Airtable Interface parity) */
-  userActions: UserActionsConfigSchema.optional().describe("User action toggles for the view toolbar"),
-  /** Appearance (Airtable Interface parity) */
-  appearance: AppearanceConfigSchema.optional().describe("Appearance and visualization configuration"),
-  /** Tabs (Airtable Interface parity) */
-  tabs: zod.z.array(ViewTabSchema).optional().describe("Tab definitions for multi-tab view interface"),
-  /** Add Record (Airtable Interface parity) */
-  addRecord: AddRecordConfigSchema.optional().describe("Add record entry point configuration"),
-  /** Record Count Display (Airtable Interface parity) */
-  showRecordCount: zod.z.boolean().optional().describe("Show record count at the bottom of the list"),
-  /** Advanced: Allow Printing (Airtable Interface parity) */
-  allowPrinting: zod.z.boolean().optional().describe("Allow users to print the view"),
-  /** Empty State */
-  emptyState: zod.z.object({
-    title: I18nLabelSchema.optional(),
-    message: I18nLabelSchema.optional(),
-    icon: zod.z.string().optional()
-  }).optional().describe("Empty state configuration when no records found"),
-  /** ARIA accessibility attributes */
-  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes for the list view"),
-  /** Responsive layout overrides per breakpoint */
-  responsive: ResponsiveConfigSchema.optional().describe("Responsive layout configuration"),
-  /** Performance optimization settings */
-  performance: PerformanceConfigSchema.optional().describe("Performance optimization settings")
-}));
-var FormFieldSchema = lazySchema(() => zod.z.object({
-  field: zod.z.string().describe("Field name (snake_case)"),
-  label: I18nLabelSchema.optional().describe("Display label override"),
-  placeholder: I18nLabelSchema.optional().describe("Placeholder text"),
-  helpText: I18nLabelSchema.optional().describe("Help/hint text"),
-  readonly: zod.z.boolean().optional().describe("Read-only override"),
-  required: zod.z.boolean().optional().describe("Required override"),
-  hidden: zod.z.boolean().optional().describe("Hidden override"),
-  colSpan: zod.z.number().int().min(1).max(4).optional().describe("Column span in grid layout (1-4)"),
-  widget: zod.z.string().optional().describe("Custom widget/component name"),
-  dependsOn: zod.z.string().optional().describe("Parent field name for cascading"),
-  visibleOn: ExpressionInputSchema.optional().describe("Visibility predicate (CEL).")
-}));
-var FormSectionSchema = lazySchema(() => zod.z.object({
-  label: I18nLabelSchema.optional(),
-  collapsible: zod.z.boolean().default(false),
-  collapsed: zod.z.boolean().default(false),
-  columns: zod.z.union([
-    zod.z.enum(["1", "2", "3", "4"]),
-    zod.z.literal(1),
-    zod.z.literal(2),
-    zod.z.literal(3),
-    zod.z.literal(4)
-  ]).default(2).transform((val) => typeof val === "string" ? parseInt(val) : val),
-  fields: zod.z.array(zod.z.union([
-    zod.z.string(),
-    // Legacy: simple field name
-    FormFieldSchema
-    // Enhanced: detailed field config
-  ]))
-}));
-var FormViewSchema = lazySchema(() => zod.z.object({
-  type: zod.z.enum([
-    "simple",
-    // Single column or sections
-    "tabbed",
-    // Tabs
-    "wizard",
-    // Step by step
-    "split",
-    // Master-Detail split
-    "drawer",
-    // Side panel
-    "modal"
-    // Dialog
-  ]).default("simple"),
-  /** Data Source Configuration */
-  data: ViewDataSchema.optional().describe('Data source configuration (defaults to "object" provider)'),
-  sections: zod.z.array(FormSectionSchema).optional(),
-  // For simple layout
-  groups: zod.z.array(FormSectionSchema).optional(),
-  // Legacy support -> alias to sections
-  /** Default Sort for Related Lists (e.g., sort child records by date) */
-  defaultSort: zod.z.array(zod.z.object({
-    field: zod.z.string().describe("Field name to sort by"),
-    order: zod.z.enum(["asc", "desc"]).default("desc").describe("Sort direction")
-  })).optional().describe("Default sort order for related list views within this form"),
-  /** Public form sharing configuration */
-  sharing: SharingConfigSchema.optional().describe("Public sharing configuration for this form"),
+var FieldSchema = lazySchema(() => zod.z.object({
+  /** Identity */
+  name: zod.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe("Machine name (snake_case)").optional(),
+  label: zod.z.string().optional().describe("Human readable label"),
+  type: FieldType.describe("Field Data Type"),
+  description: zod.z.string().optional().describe("Tooltip/Help text"),
+  format: zod.z.string().optional().describe("Format string (e.g. email, phone)"),
+  /** Storage Layer Mapping */
+  columnName: zod.z.string().optional().describe("Physical column name in the target datasource. Defaults to the field key when not set."),
+  /** Database Constraints */
+  required: zod.z.boolean().default(false).describe("Is required"),
+  searchable: zod.z.boolean().default(false).describe("Is searchable"),
+  multiple: zod.z.boolean().default(false).describe("Allow multiple values (Stores as Array/JSON). Applicable for select, lookup, file, image."),
+  unique: zod.z.boolean().default(false).describe("Is unique constraint"),
+  defaultValue: zod.z.unknown().optional().describe("Default value"),
+  /** Text/String Constraints */
+  maxLength: zod.z.number().optional().describe("Max character length"),
+  minLength: zod.z.number().optional().describe("Min character length"),
+  /** Number Constraints */
+  precision: zod.z.number().optional().describe("Total digits"),
+  scale: zod.z.number().optional().describe("Decimal places"),
+  min: zod.z.number().optional().describe("Minimum value"),
+  max: zod.z.number().optional().describe("Maximum value"),
+  /** Selection Options */
+  options: zod.z.array(SelectOptionSchema).optional().describe("Static options for select/multiselect"),
   /**
-   * What happens after a successful submit.
-   *
-   * - `thank-you` (default) — show a confirmation panel
-   * - `redirect` — send the browser to a URL
-   * - `continue` — reset the form so another response can be entered
-   * - `next-record` — advance to the next record (internal queues only)
+   * Relationship Config
+   * 
+   * Used by `lookup` and `master_detail` field types to define cross-object references.
+   * The `reference` property is **required** for these types — it identifies the target
+   * object whose records this field links to. The engine uses `reference` during $expand
+   * post-processing to resolve foreign key IDs into full related objects via batch queries.
+   * 
+   * For `master_detail` fields, the parent record controls the lifecycle of child records
+   * (e.g., cascade delete). For `lookup` fields, the reference is a soft link.
    */
-  submitBehavior: zod.z.union([
-    zod.z.object({
-      kind: zod.z.literal("thank-you"),
-      title: zod.z.string().optional(),
-      message: zod.z.string().optional()
-    }),
-    zod.z.object({
-      kind: zod.z.literal("redirect"),
-      url: zod.z.string(),
-      delayMs: zod.z.number().int().min(0).optional()
-    }),
-    zod.z.object({ kind: zod.z.literal("continue") }),
-    zod.z.object({ kind: zod.z.literal("next-record") })
-  ]).optional().describe("Post-submit behavior"),
-  /** ARIA accessibility attributes */
-  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes for the form view")
-}));
-var ViewSchema = lazySchema(() => zod.z.object({
-  list: ListViewSchema.optional(),
-  // Default list view
-  form: FormViewSchema.optional(),
-  // Default form view
-  listViews: zod.z.record(zod.z.string(), ListViewSchema).optional().describe("Additional named list views"),
-  formViews: zod.z.record(zod.z.string(), FormViewSchema).optional().describe("Additional named form views")
-}));
-function defineView(config) {
-  return ViewSchema.parse(config);
-}
-var FieldReferenceSchema = lazySchema(() => zod.z.object({
-  $field: zod.z.string().describe("Field Reference/Column Name")
-}));
-lazySchema(() => zod.z.object({
-  /** Equal to (default) - SQL: = | MongoDB: $eq */
-  $eq: zod.z.any().optional(),
-  /** Not equal to - SQL: <> or != | MongoDB: $ne */
-  $ne: zod.z.any().optional()
-}));
-lazySchema(() => zod.z.object({
-  /** Greater than - SQL: > | MongoDB: $gt */
-  $gt: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
-  /** Greater than or equal to - SQL: >= | MongoDB: $gte */
-  $gte: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
-  /** Less than - SQL: < | MongoDB: $lt */
-  $lt: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
-  /** Less than or equal to - SQL: <= | MongoDB: $lte */
-  $lte: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional()
-}));
-lazySchema(() => zod.z.object({
-  /** In list - SQL: IN (?, ?, ?) | MongoDB: $in */
-  $in: zod.z.array(zod.z.any()).optional(),
-  /** Not in list - SQL: NOT IN (...) | MongoDB: $nin */
-  $nin: zod.z.array(zod.z.any()).optional()
-}));
-lazySchema(() => zod.z.object({
-  /** Between (inclusive) - takes [min, max] array */
-  $between: zod.z.tuple([
-    zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]),
-    zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema])
-  ]).optional()
-}));
-lazySchema(() => zod.z.object({
-  /** Contains substring - SQL: LIKE %?% | MongoDB: $regex */
-  $contains: zod.z.string().optional(),
-  /** Does not contain substring - SQL: NOT LIKE %?% | MongoDB: $not: $regex */
-  $notContains: zod.z.string().optional(),
-  /** Starts with prefix - SQL: LIKE ?% | MongoDB: $regex */
-  $startsWith: zod.z.string().optional(),
-  /** Ends with suffix - SQL: LIKE %? | MongoDB: $regex */
-  $endsWith: zod.z.string().optional()
-}));
-lazySchema(() => zod.z.object({
-  /** Is null check - SQL: IS NULL (true) / IS NOT NULL (false) | MongoDB: field: null */
-  $null: zod.z.boolean().optional(),
-  /** Field exists check (primarily for NoSQL) - MongoDB: $exists */
-  $exists: zod.z.boolean().optional()
-}));
-var FieldOperatorsSchema = lazySchema(() => zod.z.object({
-  // Equality
-  $eq: zod.z.any().optional(),
-  $ne: zod.z.any().optional(),
-  // Comparison (numeric/date)
-  $gt: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
-  $gte: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
-  $lt: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
-  $lte: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
-  // Set & Range
-  $in: zod.z.array(zod.z.any()).optional(),
-  $nin: zod.z.array(zod.z.any()).optional(),
-  $between: zod.z.tuple([
-    zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]),
-    zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema])
-  ]).optional(),
-  // String-specific
-  $contains: zod.z.string().optional(),
-  $notContains: zod.z.string().optional(),
-  $startsWith: zod.z.string().optional(),
-  $endsWith: zod.z.string().optional(),
-  // Special
-  $null: zod.z.boolean().optional(),
-  $exists: zod.z.boolean().optional()
-}));
-var FilterConditionSchema = zod.z.lazy(
-  () => zod.z.record(zod.z.string(), zod.z.unknown()).and(
-    zod.z.object({
-      $and: zod.z.array(FilterConditionSchema).optional(),
-      $or: zod.z.array(FilterConditionSchema).optional(),
-      $not: FilterConditionSchema.optional()
-    })
-  )
-);
-lazySchema(() => zod.z.object({
-  where: FilterConditionSchema.optional()
-}));
-var NormalizedFilterSchema = zod.z.lazy(
-  () => zod.z.object({
-    $and: zod.z.array(
-      zod.z.union([
-        // Field condition: { field: { $op: value } }
-        zod.z.record(zod.z.string(), FieldOperatorsSchema),
-        // Nested logical group
-        NormalizedFilterSchema
-      ])
-    ).optional(),
-    $or: zod.z.array(
-      zod.z.union([
-        zod.z.record(zod.z.string(), FieldOperatorsSchema),
-        NormalizedFilterSchema
-      ])
-    ).optional(),
-    $not: zod.z.union([
-      zod.z.record(zod.z.string(), FieldOperatorsSchema),
-      NormalizedFilterSchema
-    ]).optional()
-  })
-);
-var SortNodeSchema = lazySchema(() => zod.z.object({
-  field: zod.z.string(),
-  order: zod.z.enum(["asc", "desc"]).default("asc")
-}));
-var AggregationFunction = zod.z.enum([
-  "count",
-  "sum",
-  "avg",
-  "min",
-  "max",
-  "count_distinct",
-  "array_agg",
-  "string_agg"
-]);
-var DateGranularity = zod.z.enum(["day", "week", "month", "quarter", "year"]);
-var GroupByNodeSchema = lazySchema(() => zod.z.union([
-  zod.z.string(),
-  zod.z.object({
-    field: zod.z.string().describe("Field to group by"),
-    dateGranularity: DateGranularity.optional().describe("Bucket date values into uniform periods (day/week/month/quarter/year)"),
-    /** Optional alias for the projected group value (defaults to `field`). */
-    alias: zod.z.string().optional().describe("Alias for the projected group value")
-  })
-]));
-var AggregationNodeSchema = lazySchema(() => zod.z.object({
-  function: AggregationFunction.describe("Aggregation function"),
-  field: zod.z.string().optional().describe("Field to aggregate (optional for COUNT(*))"),
-  alias: zod.z.string().describe("Result column alias"),
-  distinct: zod.z.boolean().optional().describe("Apply DISTINCT before aggregation"),
-  filter: FilterConditionSchema.optional().describe("Filter/Condition to apply to the aggregation (FILTER WHERE clause)")
+  reference: zod.z.string().optional().describe(
+    "Target object name (snake_case) for lookup/master_detail fields. Required for relationship types. Used by $expand to resolve foreign key IDs into full objects."
+  ),
+  referenceFilters: zod.z.array(zod.z.string()).optional().describe('Filters applied to lookup dialogs (e.g. "active = true")'),
+  writeRequiresMasterRead: zod.z.boolean().optional().describe("If true, user needs read access to master record to edit this field"),
+  deleteBehavior: zod.z.enum(["set_null", "cascade", "restrict"]).optional().default("set_null").describe("What happens if referenced record is deleted"),
+  /** Calculation — CEL formula. Plain string accepted for back-compat; build emits canonical envelope. */
+  expression: ExpressionInputSchema.optional().describe("Formula expression (CEL). e.g. F`record.amount * 0.1`"),
+  summaryOperations: zod.z.object({
+    object: zod.z.string().describe("Source child object name for roll-up"),
+    field: zod.z.string().describe("Field on child object to aggregate"),
+    function: zod.z.enum(["count", "sum", "min", "max", "avg"]).describe("Aggregation function to apply")
+  }).optional().describe("Roll-up summary definition"),
+  /** Enhanced Field Type Configurations */
+  // Code field config
+  language: zod.z.string().optional().describe("Programming language for syntax highlighting (e.g., javascript, python, sql)"),
+  theme: zod.z.string().optional().describe("Code editor theme (e.g., dark, light, monokai)"),
+  lineNumbers: zod.z.boolean().optional().describe("Show line numbers in code editor"),
+  // Rating field config
+  maxRating: zod.z.number().optional().describe("Maximum rating value (default: 5)"),
+  allowHalf: zod.z.boolean().optional().describe("Allow half-star ratings"),
+  // Location field config
+  displayMap: zod.z.boolean().optional().describe("Display map widget for location field"),
+  allowGeocoding: zod.z.boolean().optional().describe("Allow address-to-coordinate conversion"),
+  // Address field config
+  addressFormat: zod.z.enum(["us", "uk", "international"]).optional().describe("Address format template"),
+  // Color field config
+  colorFormat: zod.z.enum(["hex", "rgb", "rgba", "hsl"]).optional().describe("Color value format"),
+  allowAlpha: zod.z.boolean().optional().describe("Allow transparency/alpha channel"),
+  presetColors: zod.z.array(zod.z.string()).optional().describe("Preset color options"),
+  // Slider field config
+  step: zod.z.number().optional().describe("Step increment for slider (default: 1)"),
+  showValue: zod.z.boolean().optional().describe("Display current value on slider"),
+  marks: zod.z.record(zod.z.string(), zod.z.string()).optional().describe('Custom marks/labels at specific values (e.g., {0: "Low", 50: "Medium", 100: "High"})'),
+  // QR Code / Barcode field config
+  // Note: qrErrorCorrection is only applicable when barcodeFormat='qr'
+  // Runtime validation should enforce this constraint
+  barcodeFormat: zod.z.enum(["qr", "ean13", "ean8", "code128", "code39", "upca", "upce"]).optional().describe("Barcode format type"),
+  qrErrorCorrection: zod.z.enum(["L", "M", "Q", "H"]).optional().describe('QR code error correction level (L=7%, M=15%, Q=25%, H=30%). Only applicable when barcodeFormat is "qr"'),
+  displayValue: zod.z.boolean().optional().describe("Display human-readable value below barcode/QR code"),
+  allowScanning: zod.z.boolean().optional().describe("Enable camera scanning for barcode/QR code input"),
+  // Currency field config
+  currencyConfig: CurrencyConfigSchema.optional().describe("Configuration for currency field type"),
+  // Vector field config
+  vectorConfig: VectorConfigSchema.optional().describe("Configuration for vector field type (AI/ML embeddings)"),
+  // File attachment field config
+  fileAttachmentConfig: FileAttachmentConfigSchema.optional().describe("Configuration for file and attachment field types"),
+  /** Enhanced Security & Compliance */
+  // Encryption configuration
+  encryptionConfig: EncryptionConfigSchema.optional().describe("Field-level encryption configuration for sensitive data (GDPR/HIPAA/PCI-DSS)"),
+  // Data masking rules
+  maskingRule: MaskingRuleSchema.optional().describe("Data masking rules for PII protection"),
+  // Audit trail
+  auditTrail: zod.z.boolean().default(false).describe("Enable detailed audit trail for this field (tracks all changes with user and timestamp)"),
+  /** Field Dependencies & Relationships */
+  // Field dependencies
+  dependencies: zod.z.array(zod.z.string()).optional().describe("Array of field names that this field depends on (for formulas, visibility rules, etc.)"),
+  /** Computed Field Optimization */
+  // Computed field caching
+  cached: ComputedFieldCacheSchema.optional().describe("Caching configuration for computed/formula fields"),
+  /** Data Quality & Governance */
+  // Data quality rules
+  dataQuality: DataQualityRulesSchema.optional().describe("Data quality validation and monitoring rules"),
+  /** Layout & Grouping */
+  group: zod.z.string().optional().describe('Field group name for organizing fields in forms and layouts (e.g., "contact_info", "billing", "system")'),
+  /** Conditional Requirements */
+  conditionalRequired: ExpressionInputSchema.optional().describe("Predicate (CEL) \u2014 field is required when TRUE. e.g. P`record.status == 'closed_won'`"),
+  /** Security & Visibility */
+  hidden: zod.z.boolean().default(false).describe("Hidden from default UI"),
+  readonly: zod.z.boolean().default(false).describe("Read-only in UI"),
+  system: zod.z.boolean().optional().describe("Auto-injected system/audit field (e.g. created_at, updated_by, organization_id). Tools that surface system fields separately from author-declared business fields should branch on this flag."),
+  sortable: zod.z.boolean().optional().default(true).describe("Whether field is sortable in list views"),
+  inlineHelpText: zod.z.string().optional().describe("Help text displayed below the field in forms"),
+  trackFeedHistory: zod.z.boolean().optional().describe("Track field changes in Chatter/activity feed (Salesforce pattern)"),
+  caseSensitive: zod.z.boolean().optional().describe("Whether text comparisons are case-sensitive"),
+  autonumberFormat: zod.z.string().optional().describe('Auto-number display format pattern (e.g., "CASE-{0000}")'),
+  /** Indexing */
+  index: zod.z.boolean().default(false).describe("Create standard database index"),
+  externalId: zod.z.boolean().default(false).describe("Is external ID for upsert operations")
 }));
-var JoinType = zod.z.enum(["inner", "left", "right", "full"]);
-var JoinStrategy = zod.z.enum(["auto", "database", "hash", "loop"]);
-var JoinNodeSchema = zod.z.lazy(
-  () => zod.z.object({
-    type: JoinType.describe("Join type"),
-    strategy: JoinStrategy.optional().describe("Execution strategy hint"),
-    object: zod.z.string().describe("Object/table to join"),
-    alias: zod.z.string().optional().describe("Table alias"),
-    on: FilterConditionSchema.describe("Join condition"),
-    subquery: zod.z.lazy(() => QuerySchema).optional().describe("Subquery instead of object")
-  })
-);
-var WindowFunction = zod.z.enum([
-  "row_number",
-  "rank",
-  "dense_rank",
-  "percent_rank",
-  "lag",
-  "lead",
-  "first_value",
-  "last_value",
-  "sum",
-  "avg",
-  "count",
-  "min",
-  "max"
+var HttpMethod = zod.z.enum([
+  "GET",
+  "POST",
+  "PUT",
+  "DELETE",
+  "PATCH",
+  "HEAD",
+  "OPTIONS"
 ]);
-var WindowSpecSchema = lazySchema(() => zod.z.object({
-  partitionBy: zod.z.array(zod.z.string()).optional().describe("PARTITION BY fields"),
-  orderBy: zod.z.array(SortNodeSchema).optional().describe("ORDER BY specification"),
-  frame: zod.z.object({
-    type: zod.z.enum(["rows", "range"]).optional(),
-    start: zod.z.string().optional().describe('Frame start (e.g., "UNBOUNDED PRECEDING", "1 PRECEDING")'),
-    end: zod.z.string().optional().describe('Frame end (e.g., "CURRENT ROW", "1 FOLLOWING")')
-  }).optional().describe("Window frame specification")
-}));
-var WindowFunctionNodeSchema = lazySchema(() => zod.z.object({
-  function: WindowFunction.describe("Window function name"),
-  field: zod.z.string().optional().describe("Field to operate on (for aggregate window functions)"),
-  alias: zod.z.string().describe("Result column alias"),
-  over: WindowSpecSchema.describe("Window specification (OVER clause)")
+var HttpMethodSchema = lazySchema(() => zod.z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]));
+var HttpRequestSchema = lazySchema(() => zod.z.object({
+  url: zod.z.string().describe("API endpoint URL"),
+  method: HttpMethodSchema.optional().default("GET").describe("HTTP method"),
+  headers: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Custom HTTP headers"),
+  params: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Query parameters"),
+  body: zod.z.unknown().optional().describe("Request body for POST/PUT/PATCH")
 }));
-var FieldNodeSchema = zod.z.lazy(
-  () => zod.z.union([
+lazySchema(() => zod.z.object({
+  /**
+   * Enable CORS
+   */
+  enabled: zod.z.boolean().default(true).describe("Enable CORS"),
+  /**
+   * Allowed origins (* for all)
+   */
+  origins: zod.z.union([
     zod.z.string(),
-    // Primitive field: "name"
-    zod.z.object({
-      field: zod.z.string(),
-      // Relationship field: "owner"
-      fields: zod.z.array(FieldNodeSchema).optional(),
-      // Nested select: ["name", "email"]
-      alias: zod.z.string().optional()
-    })
-  ])
-);
-var FullTextSearchSchema = lazySchema(() => zod.z.object({
-  query: zod.z.string().describe("Search query text"),
-  fields: zod.z.array(zod.z.string()).optional().describe("Fields to search in (if not specified, searches all text fields)"),
-  fuzzy: zod.z.boolean().optional().default(false).describe("Enable fuzzy matching (tolerates typos)"),
-  operator: zod.z.enum(["and", "or"]).optional().default("or").describe("Logical operator between terms"),
-  boost: zod.z.record(zod.z.string(), zod.z.number()).optional().describe("Field-specific relevance boosting (field name -> boost factor)"),
-  minScore: zod.z.number().optional().describe("Minimum relevance score threshold"),
-  language: zod.z.string().optional().describe('Language for text analysis (e.g., "en", "zh", "es")'),
-  highlight: zod.z.boolean().optional().default(false).describe("Enable search result highlighting")
-}));
-var BaseQuerySchema = zod.z.object({
-  /** Target Entity */
-  object: zod.z.string().describe("Object name (e.g. account)"),
-  /** Select Clause */
-  fields: zod.z.array(FieldNodeSchema).optional().describe("Fields to retrieve"),
-  /** Where Clause (Filtering) */
-  where: FilterConditionSchema.optional().describe("Filtering criteria (WHERE)"),
-  /** Full-Text Search */
-  search: FullTextSearchSchema.optional().describe("Full-text search configuration ($search parameter)"),
-  /** Order By Clause (Sorting) */
-  orderBy: zod.z.array(SortNodeSchema).optional().describe("Sorting instructions (ORDER BY)"),
-  /** Pagination */
-  limit: zod.z.number().optional().describe("Max records to return (LIMIT)"),
-  offset: zod.z.number().optional().describe("Records to skip (OFFSET)"),
-  top: zod.z.number().optional().describe("Alias for limit (OData compatibility)"),
-  cursor: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Cursor for keyset pagination"),
-  /** Joins */
-  joins: zod.z.array(JoinNodeSchema).optional().describe("Explicit Table Joins"),
-  /** Aggregations */
-  aggregations: zod.z.array(AggregationNodeSchema).optional().describe("Aggregation functions"),
-  /** Group By Clause */
-  groupBy: zod.z.array(GroupByNodeSchema).optional().describe("GROUP BY targets (strings or `{field, dateGranularity?}` objects for date bucketing)"),
-  /** Having Clause */
-  having: FilterConditionSchema.optional().describe("HAVING clause for aggregation filtering"),
-  /** Window Functions */
-  windowFunctions: zod.z.array(WindowFunctionNodeSchema).optional().describe("Window functions with OVER clause"),
-  /** Subquery flag */
-  distinct: zod.z.boolean().optional().describe("SELECT DISTINCT flag")
-});
-var QuerySchema = lazySchema(() => BaseQuerySchema.extend({
-  expand: zod.z.lazy(() => zod.z.record(zod.z.string(), QuerySchema)).optional().describe(
-    "Recursive relation loading map. Keys are lookup/master_detail field names; values are nested QueryAST objects that control select, filter, sort, and further expansion on the related object. The engine resolves expand via batch $in queries (driver-agnostic) with a default max depth of 3."
-  )
+    zod.z.array(zod.z.string())
+  ]).default("*").describe("Allowed origins (* for all)"),
+  /**
+   * Allowed HTTP methods
+   */
+  methods: zod.z.array(HttpMethod).optional().describe("Allowed HTTP methods"),
+  /**
+   * Allow credentials (cookies, authorization headers)
+   */
+  credentials: zod.z.boolean().default(false).describe("Allow credentials (cookies, authorization headers)"),
+  /**
+   * Preflight cache duration in seconds
+   */
+  maxAge: zod.z.number().int().optional().describe("Preflight cache duration in seconds")
 }));
-
-// src/ui/dashboard.zod.ts
-var WidgetColorVariantSchema = lazySchema(() => zod.z.enum([
-  "default",
-  "blue",
-  "teal",
-  "orange",
-  "purple",
-  "success",
-  "warning",
-  "danger"
-]).describe("Widget color variant"));
-var WidgetActionTypeSchema = lazySchema(() => zod.z.enum([
-  "script",
-  "url",
-  "modal",
-  "flow",
-  "api"
-]).describe("Widget action type"));
-var DashboardHeaderActionSchema = lazySchema(() => zod.z.object({
-  /** Action label */
-  label: I18nLabelSchema.describe("Action button label"),
-  /** Action URL or target */
-  actionUrl: zod.z.string().describe("URL or target for the action"),
-  /** Action type */
-  actionType: WidgetActionTypeSchema.optional().describe("Type of action"),
-  /** Icon identifier */
-  icon: zod.z.string().optional().describe("Icon identifier for the action button")
-}).describe("Dashboard header action"));
-var DashboardHeaderSchema = lazySchema(() => zod.z.object({
-  /** Whether to show the dashboard title in the header */
-  showTitle: zod.z.boolean().default(true).describe("Show dashboard title in header"),
-  /** Whether to show the dashboard description in the header */
-  showDescription: zod.z.boolean().default(true).describe("Show dashboard description in header"),
-  /** Action buttons displayed in the header */
-  actions: zod.z.array(DashboardHeaderActionSchema).optional().describe("Header action buttons")
-}).describe("Dashboard header configuration"));
-var WidgetMeasureSchema = lazySchema(() => zod.z.object({
-  /** Value field to aggregate */
-  valueField: zod.z.string().describe("Field to aggregate"),
-  /** Aggregate function */
-  aggregate: zod.z.enum(["count", "sum", "avg", "min", "max"]).default("count").describe("Aggregate function"),
-  /** Display label for the measure */
-  label: I18nLabelSchema.optional().describe("Measure display label"),
-  /** Number format string (e.g., "$0,0.00", "0.0%") */
-  format: zod.z.string().optional().describe("Number format string")
-}).describe("Widget measure definition"));
-var DashboardWidgetSchema = lazySchema(() => zod.z.object({
-  /** Unique widget identifier (snake_case, used for targetWidgets references) */
-  id: SnakeCaseIdentifierSchema.describe("Unique widget identifier (snake_case)"),
-  /** Widget Title */
-  title: I18nLabelSchema.optional().describe("Widget title"),
-  /** Widget Description (displayed below the title) */
-  description: I18nLabelSchema.optional().describe("Widget description text below the header"),
-  /** Visualization Type */
-  type: ChartTypeSchema.default("metric").describe("Visualization type"),
-  /** Chart Configuration */
-  chartConfig: ChartConfigSchema.optional().describe("Chart visualization configuration"),
-  /** Color variant for the widget (e.g., KPI card accent color) */
-  colorVariant: WidgetColorVariantSchema.optional().describe("Widget color variant for theming"),
+lazySchema(() => zod.z.object({
   /**
-   * Runtime capability gate — widget is hidden when the named object is
-   * not registered in the runtime's SchemaRegistry. Mirrors
-   * `NavigationItem.requiresObject` so cloud-only widgets (e.g. those
-   * keyed on `sys_app` / `sys_package_installation`) silently disappear
-   * in single-environment runtimes instead of rendering a 404 error.
-   *
-   * Defaults to the widget's `object` field when not explicitly set —
-   * any widget that targets an object will be gated on that object's
-   * registration. Set this to a different value (or empty string to
-   * disable) when the widget should appear even if its `object` is
-   * unavailable.
+   * Enable rate limiting
    */
-  requiresObject: zod.z.string().optional().describe("Hide the widget unless the named object is registered"),
+  enabled: zod.z.boolean().default(false).describe("Enable rate limiting"),
   /**
-   * Runtime capability gate — widget is hidden when the named kernel
-   * service is not registered. Mirrors `NavigationItem.requiresService`.
+   * Time window in milliseconds
    */
-  requiresService: zod.z.string().optional().describe("Hide the widget unless the named kernel service is registered"),
-  /** Action URL for the widget header action button */
-  actionUrl: zod.z.string().optional().describe("URL or target for the widget action button"),
-  /** Action type for the widget header action button */
-  actionType: WidgetActionTypeSchema.optional().describe("Type of action for the widget action button"),
-  /** Icon for the widget header action button */
-  actionIcon: zod.z.string().optional().describe("Icon identifier for the widget action button"),
-  /** Data Source Object */
-  object: zod.z.string().optional().describe("Data source object name"),
-  /** Data Filter (MongoDB-style FilterCondition) */
-  filter: FilterConditionSchema.optional().describe("Data filter criteria"),
+  windowMs: zod.z.number().int().default(6e4).describe("Time window in milliseconds"),
+  /**
+   * Max requests per window
+   */
+  maxRequests: zod.z.number().int().default(100).describe("Max requests per window")
+}));
+lazySchema(() => zod.z.object({
   /**
-   * Period-over-period comparison primitive.
-   *
-   * When set, the renderer runs a second query against a shifted time
-   * window and surfaces the delta (metric widgets show a secondary
-   * value + arrow; chart widgets render a muted/dashed overlay series).
-   *
-   * - `'previousPeriod'` — auto-detect the comparison window from the
-   *   widget's `filter` date macros (e.g. `{current_month_start}` →
-   *   `{last_month_start}`). Falls back to no comparison when the
-   *   filter contains no resolvable date range.
-   * - `'previousYear'` — shift the resolved filter window back by one
-   *   calendar year.
-   * - `{ offset: '7d' | '1M' | '1y' }` — shift by an explicit
-   *   ISO-8601-like duration. Units: `d` (days), `w` (weeks),
-   *   `M` (months), `y` (years).
+   * URL path to serve from
    */
-  compareTo: zod.z.union([
-    zod.z.literal("previousPeriod"),
-    zod.z.literal("previousYear"),
-    zod.z.object({
-      offset: zod.z.string().regex(/^\d+[dwMy]$/, 'Offset must match <N>(d|w|M|y), e.g. "7d", "1M", "1y"')
-    })
-  ]).optional().describe("Period-over-period comparison window"),
-  /** Category Field (X-Axis / Group By) */
-  categoryField: zod.z.string().optional().describe("Field for grouping (X-Axis)"),
+  path: zod.z.string().describe("URL path to serve from"),
   /**
-   * Date Bucketing Granularity for `categoryField`
-   *
-   * When set and `categoryField` references a date/datetime field, the engine
-   * buckets values into uniform `day` / `week` / `month` / `quarter` / `year`
-   * periods server-side (PostgreSQL `date_trunc`, MySQL `date_format`, SQLite
-   * `strftime`, MongoDB `$dateTrunc`; falls back to in-memory ISO-8601
-   * bucketing otherwise). Without this, raw timestamps are grouped verbatim
-   * which typically yields one bucket per row — making time-series charts
-   * appear flat.
-   *
-   * Mirrors the `dateGranularity` shape of {@link GroupByNodeSchema}.
+   * Physical directory to serve
    */
-  categoryGranularity: DateGranularity.optional().describe("Bucket categoryField date values into day/week/month/quarter/year periods"),
-  /** Value Field (Y-Axis) */
-  valueField: zod.z.string().optional().describe("Field for values (Y-Axis)"),
-  /** Aggregate operation */
-  aggregate: zod.z.enum(["count", "sum", "avg", "min", "max"]).optional().default("count").describe("Aggregate function"),
-  /** Multi-measure definitions for pivot/matrix widgets */
-  measures: zod.z.array(WidgetMeasureSchema).optional().describe("Multiple measures for pivot/matrix analysis"),
-  /** 
-   * Layout Position (React-Grid-Layout style)
-   * x: column (0-11)
-   * y: row
-   * w: width (1-12)
-   * h: height
+  directory: zod.z.string().describe("Physical directory to serve"),
+  /**
+   * Cache-Control header value
    */
-  layout: zod.z.object({
-    x: zod.z.number(),
-    y: zod.z.number(),
-    w: zod.z.number(),
-    h: zod.z.number()
-  }).describe("Grid layout position"),
-  /** Widget specific options (colors, legend, etc.) */
-  options: zod.z.unknown().optional().describe("Widget specific configuration"),
-  /** Responsive layout overrides per breakpoint */
-  responsive: ResponsiveConfigSchema.optional().describe("Responsive layout configuration"),
-  /** ARIA accessibility attributes */
-  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+  cacheControl: zod.z.string().optional().describe("Cache-Control header value")
 }));
-var GlobalFilterOptionsFromSchema = lazySchema(() => zod.z.object({
-  /** Source object name to fetch options from */
-  object: zod.z.string().describe("Source object name"),
-  /** Field to use as option value */
-  valueField: zod.z.string().describe("Field to use as option value"),
-  /** Field to use as option label */
-  labelField: zod.z.string().describe("Field to use as option label"),
-  /** Optional filter to apply when fetching options */
-  filter: FilterConditionSchema.optional().describe("Filter to apply to source object")
-}).describe("Dynamic filter options from object"));
-var GlobalFilterSchema = lazySchema(() => zod.z.object({
+
+// src/ui/view.zod.ts
+var ViewDataSchema = lazySchema(() => zod.z.discriminatedUnion("provider", [
+  zod.z.object({
+    provider: zod.z.literal("object"),
+    object: zod.z.string().describe("Target object name")
+  }),
+  zod.z.object({
+    provider: zod.z.literal("api"),
+    read: HttpRequestSchema.optional().describe("Configuration for fetching data"),
+    write: HttpRequestSchema.optional().describe("Configuration for submitting data (for forms/editable tables)")
+  }),
+  zod.z.object({
+    provider: zod.z.literal("value"),
+    items: zod.z.array(zod.z.unknown()).describe("Static data array")
+  }),
+  /**
+   * Schema-bound data source — used by standalone forms whose data is
+   * shaped by a JSON Schema (or Zod-derived schema) rather than by an
+   * ObjectQL object. Powers the metadata editor, action input dialogs,
+   * and any Form that is not bound to a CRUD object.
+   */
+  zod.z.object({
+    provider: zod.z.literal("schema"),
+    /** Schema identifier (e.g. metadata type name "report"). Resolved at runtime against /meta entries. */
+    schemaId: zod.z.string().describe("Schema identifier \u2014 typically the metadata type name"),
+    /** Optional inline JSON Schema; when omitted the runtime resolves schemaId from the server. */
+    schema: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Inline JSON Schema (Draft 2020-12). Optional when schemaId is resolvable.")
+  })
+]));
+var ViewFilterRuleSchema = lazySchema(() => zod.z.object({
   /** Field name to filter on */
   field: zod.z.string().describe("Field name to filter on"),
-  /** Display label for the filter */
-  label: I18nLabelSchema.optional().describe("Display label for the filter"),
-  /** Filter input type */
-  type: zod.z.enum(["text", "select", "date", "number", "lookup"]).optional().describe("Filter input type"),
-  /** Static options for select/lookup filters */
-  options: zod.z.array(zod.z.object({
-    value: zod.z.union([zod.z.string(), zod.z.number(), zod.z.boolean()]).describe("Option value"),
-    label: I18nLabelSchema
-  })).optional().describe("Static filter options"),
-  /** Dynamic data binding for filter options */
-  optionsFrom: GlobalFilterOptionsFromSchema.optional().describe("Dynamic filter options from object"),
-  /** Default filter value */
-  defaultValue: zod.z.union([zod.z.string(), zod.z.number(), zod.z.boolean()]).optional().describe("Default filter value"),
-  /** Filter application scope */
-  scope: zod.z.enum(["dashboard", "widget"]).default("dashboard").describe("Filter application scope"),
-  /** Widget IDs to apply this filter to (when scope is widget) */
-  targetWidgets: zod.z.array(zod.z.string()).optional().describe("Widget IDs to apply this filter to")
+  /** Filter operator */
+  operator: zod.z.string().describe("Filter operator (e.g. equals, not_equals, contains, this_quarter)"),
+  /** Filter value (optional for unary operators like is_null, this_quarter) */
+  value: zod.z.union([zod.z.string(), zod.z.number(), zod.z.boolean(), zod.z.null(), zod.z.array(zod.z.union([zod.z.string(), zod.z.number()]))]).optional().describe("Filter value")
+}).describe("View filter rule"));
+var ColumnSummarySchema = lazySchema(() => zod.z.enum([
+  "none",
+  "count",
+  "count_empty",
+  "count_filled",
+  "count_unique",
+  "percent_empty",
+  "percent_filled",
+  "sum",
+  "avg",
+  "min",
+  "max"
+]).describe("Aggregation function for column footer summary"));
+var ListColumnSchema = lazySchema(() => zod.z.object({
+  field: zod.z.string().describe("Field name (snake_case)"),
+  label: I18nLabelSchema.optional().describe("Display label override"),
+  width: zod.z.number().positive().optional().describe("Column width in pixels"),
+  align: zod.z.enum(["left", "center", "right"]).optional().describe("Text alignment"),
+  hidden: zod.z.boolean().optional().describe("Hide column by default"),
+  sortable: zod.z.boolean().optional().describe("Allow sorting by this column"),
+  resizable: zod.z.boolean().optional().describe("Allow resizing this column"),
+  wrap: zod.z.boolean().optional().describe("Allow text wrapping"),
+  type: zod.z.string().optional().describe('Renderer type override (e.g., "currency", "date")'),
+  /** Pinning (Airtable-style frozen columns) */
+  pinned: zod.z.enum(["left", "right"]).optional().describe("Pin/freeze column to left or right side"),
+  /** Column Footer Summary (Airtable-style aggregation) */
+  summary: ColumnSummarySchema.optional().describe("Footer aggregation function for this column"),
+  /** Interaction */
+  link: zod.z.boolean().optional().describe("Functions as the primary navigation link (triggers View navigation)"),
+  action: zod.z.string().optional().describe("Registered Action ID to execute when clicked")
 }));
-var DashboardSchema = lazySchema(() => zod.z.object({
-  /** Machine name */
-  name: SnakeCaseIdentifierSchema.describe("Dashboard unique name"),
-  /** Display label */
-  label: I18nLabelSchema.describe("Dashboard label"),
-  /** Description */
-  description: I18nLabelSchema.optional().describe("Dashboard description"),
-  /** Structured header configuration */
-  header: DashboardHeaderSchema.optional().describe("Dashboard header configuration"),
-  /** Collection of widgets */
-  widgets: zod.z.array(DashboardWidgetSchema).describe("Widgets to display"),
-  /** Grid column count — defaults to 12 for a standard 12-column grid */
-  columns: zod.z.number().int().min(1).max(24).optional().describe("Number of grid columns (default 12)"),
-  /** Grid gap in Tailwind spacing units (e.g. 4 = 1rem) */
-  gap: zod.z.number().int().min(0).optional().describe("Grid gap in Tailwind spacing units"),
-  /** Auto-refresh */
-  refreshInterval: zod.z.number().optional().describe("Auto-refresh interval in seconds"),
-  /** Dashboard Date Range (Global time filter) */
-  dateRange: zod.z.object({
-    field: zod.z.string().optional().describe("Default date field name for time-based filtering"),
-    defaultRange: zod.z.enum(["today", "yesterday", "this_week", "last_week", "this_month", "last_month", "this_quarter", "last_quarter", "this_year", "last_year", "last_7_days", "last_30_days", "last_90_days", "custom"]).default("this_month").describe("Default date range preset"),
-    allowCustomRange: zod.z.boolean().default(true).describe("Allow users to pick a custom date range")
-  }).optional().describe("Global dashboard date range filter configuration"),
-  /** Global Filters */
-  globalFilters: zod.z.array(GlobalFilterSchema).optional().describe("Global filters that apply to all widgets in the dashboard"),
-  /** ARIA accessibility attributes */
-  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes"),
-  /** Performance optimization settings */
-  performance: PerformanceConfigSchema.optional().describe("Performance optimization settings")
+var SelectionConfigSchema = lazySchema(() => zod.z.object({
+  type: zod.z.enum(["none", "single", "multiple"]).default("none").describe("Selection mode")
+}));
+var PaginationConfigSchema = lazySchema(() => zod.z.object({
+  pageSize: zod.z.number().int().positive().default(25).describe("Number of records per page"),
+  pageSizeOptions: zod.z.array(zod.z.number().int().positive()).optional().describe("Available page size options")
+}));
+var RowHeightSchema = lazySchema(() => zod.z.enum([
+  "compact",
+  // Minimal padding, single line
+  "short",
+  // Reduced padding
+  "medium",
+  // Default padding
+  "tall",
+  // Extra padding, multi-line preview
+  "extra_tall"
+  // Maximum padding, rich content preview
+]).describe("Row height / density setting for list view"));
+var GroupingFieldSchema = lazySchema(() => zod.z.object({
+  field: zod.z.string().describe("Field name to group by"),
+  order: zod.z.enum(["asc", "desc"]).default("asc").describe("Group sort order"),
+  collapsed: zod.z.boolean().default(false).describe("Collapse groups by default")
+}));
+var GroupingConfigSchema = lazySchema(() => zod.z.object({
+  fields: zod.z.array(GroupingFieldSchema).min(1).describe("Fields to group by (supports up to 3 levels)")
+}).describe("Record grouping configuration"));
+var GalleryConfigSchema = lazySchema(() => zod.z.object({
+  coverField: zod.z.string().optional().describe("Attachment/image field to display as card cover"),
+  coverFit: zod.z.enum(["cover", "contain"]).default("cover").describe("Image fit mode for card cover"),
+  cardSize: zod.z.enum(["small", "medium", "large"]).default("medium").describe("Card size in gallery view"),
+  titleField: zod.z.string().optional().describe("Field to display as card title"),
+  visibleFields: zod.z.array(zod.z.string()).optional().describe("Fields to display on card body")
+}).describe("Gallery/card view configuration"));
+var TimelineConfigSchema = lazySchema(() => zod.z.object({
+  startDateField: zod.z.string().describe("Field for timeline item start date"),
+  endDateField: zod.z.string().optional().describe("Field for timeline item end date"),
+  titleField: zod.z.string().describe("Field to display as timeline item title"),
+  groupByField: zod.z.string().optional().describe("Field to group timeline rows"),
+  colorField: zod.z.string().optional().describe("Field to determine item color"),
+  scale: zod.z.enum(["hour", "day", "week", "month", "quarter", "year"]).default("week").describe("Default timeline scale")
+}).describe("Timeline view configuration"));
+var ViewSharingSchema = lazySchema(() => zod.z.object({
+  type: zod.z.enum(["personal", "collaborative"]).default("collaborative").describe("View ownership type"),
+  lockedBy: zod.z.string().optional().describe("User who locked the view configuration")
+}).describe("View sharing and access configuration"));
+var RowColorConfigSchema = lazySchema(() => zod.z.object({
+  field: zod.z.string().describe("Field to derive color from (typically a select/status field)"),
+  colors: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Map of field value to color (hex/token)")
+}).describe("Row color configuration based on field values"));
+var VisualizationTypeSchema = lazySchema(() => zod.z.enum([
+  "grid",
+  "kanban",
+  "gallery",
+  "calendar",
+  "timeline",
+  "gantt",
+  "map"
+]).describe("Visualization type that users can switch to"));
+var UserActionsConfigSchema = lazySchema(() => zod.z.object({
+  sort: zod.z.boolean().default(true).describe("Allow users to sort records"),
+  search: zod.z.boolean().default(true).describe("Allow users to search records"),
+  filter: zod.z.boolean().default(true).describe("Allow users to filter records"),
+  rowHeight: zod.z.boolean().default(true).describe("Allow users to toggle row height/density"),
+  addRecordForm: zod.z.boolean().default(false).describe("Add records through a form instead of inline"),
+  buttons: zod.z.array(zod.z.string()).optional().describe("Custom action button IDs to show in the toolbar")
+}).describe("User action toggles for the view toolbar"));
+var AppearanceConfigSchema = lazySchema(() => zod.z.object({
+  showDescription: zod.z.boolean().default(true).describe("Show the view description text"),
+  allowedVisualizations: zod.z.array(VisualizationTypeSchema).optional().describe('Whitelist of visualization types users can switch between (e.g. ["grid", "gallery", "kanban"])')
+}).describe("Appearance and visualization configuration"));
+var ViewTabSchema = lazySchema(() => zod.z.object({
+  name: SnakeCaseIdentifierSchema.describe("Tab identifier (snake_case)"),
+  label: I18nLabelSchema.optional().describe("Display label"),
+  icon: zod.z.string().optional().describe("Tab icon name"),
+  view: zod.z.string().optional().describe("Referenced list view name from listViews"),
+  filter: zod.z.array(ViewFilterRuleSchema).optional().describe("Tab-specific filter criteria"),
+  order: zod.z.number().int().min(0).optional().describe("Tab display order"),
+  pinned: zod.z.boolean().default(false).describe("Pin tab (cannot be removed by users)"),
+  isDefault: zod.z.boolean().default(false).describe("Set as the default active tab"),
+  visible: zod.z.boolean().default(true).describe("Tab visibility")
+}).describe("Tab configuration for multi-tab view interface"));
+var AddRecordConfigSchema = lazySchema(() => zod.z.object({
+  enabled: zod.z.boolean().default(true).describe("Show the add record entry point"),
+  position: zod.z.enum(["top", "bottom", "both"]).default("bottom").describe("Position of the add record button"),
+  mode: zod.z.enum(["inline", "form", "modal"]).default("inline").describe("How to add a new record"),
+  formView: zod.z.string().optional().describe('Named form view to use when mode is "form" or "modal"')
+}).describe("Add record entry point configuration"));
+var KanbanConfigSchema = lazySchema(() => zod.z.object({
+  groupByField: zod.z.string().describe("Field to group columns by (usually status/select)"),
+  summarizeField: zod.z.string().optional().describe("Field to sum at top of column (e.g. amount)"),
+  columns: zod.z.array(zod.z.string()).describe("Fields to show on cards")
 }));
-var Dashboard = {
-  create: (config) => DashboardSchema.parse(config)
-};
-var ReportType = zod.z.enum([
-  "tabular",
-  // Simple list
-  "summary",
-  // Grouped by row
-  "matrix",
-  // Grouped by row and column
-  "joined"
-  // Joined multiple blocks
-]);
-var ReportColumnSchema = lazySchema(() => zod.z.object({
-  field: zod.z.string().describe("Field name"),
-  label: I18nLabelSchema.optional().describe("Override label"),
-  aggregate: zod.z.enum(["sum", "avg", "max", "min", "count", "unique"]).optional().describe("Aggregation function"),
-  /** Responsive visibility/priority per breakpoint */
-  responsive: ResponsiveConfigSchema.optional().describe("Responsive visibility for this column")
+var ListChartConfigSchema = lazySchema(() => zod.z.object({
+  chartType: zod.z.enum(["bar", "line", "pie", "area", "scatter"]).default("bar").describe("Chart visualisation type"),
+  xAxisField: zod.z.string().describe("Field used as the X axis / category dimension"),
+  yAxisFields: zod.z.array(zod.z.string()).min(1).describe("Field(s) used as the Y axis / measures"),
+  aggregation: zod.z.enum(["sum", "avg", "count", "min", "max"]).optional().describe("Aggregation function applied to Y axis fields"),
+  groupByField: zod.z.string().optional().describe("Optional field used to split / stack the chart")
+}).describe("List chart view configuration"));
+var CalendarConfigSchema = lazySchema(() => zod.z.object({
+  startDateField: zod.z.string(),
+  endDateField: zod.z.string().optional(),
+  titleField: zod.z.string(),
+  colorField: zod.z.string().optional()
 }));
-var ReportGroupingSchema = lazySchema(() => zod.z.object({
-  field: zod.z.string().describe("Field to group by"),
-  sortOrder: zod.z.enum(["asc", "desc"]).default("asc"),
-  dateGranularity: zod.z.enum(["day", "week", "month", "quarter", "year"]).optional().describe("For date fields")
+var GanttConfigSchema = lazySchema(() => zod.z.object({
+  startDateField: zod.z.string(),
+  endDateField: zod.z.string(),
+  titleField: zod.z.string(),
+  progressField: zod.z.string().optional(),
+  dependenciesField: zod.z.string().optional()
 }));
-var ReportChartSchema = lazySchema(() => ChartConfigSchema.extend({
-  /** Report-specific chart configuration */
-  xAxis: zod.z.string().describe("Grouping field for X-Axis"),
-  yAxis: zod.z.string().describe("Summary field for Y-Axis"),
-  groupBy: zod.z.string().optional().describe("Additional grouping field")
+var NavigationModeSchema = lazySchema(() => zod.z.enum([
+  "page",
+  // Navigate to a new route (default)
+  "drawer",
+  // Open details in a side drawer/panel
+  "modal",
+  // Open details in a modal dialog
+  "split",
+  // Show details side-by-side with the list (master-detail)
+  "popover",
+  // Show details in a popover (lightweight)
+  "new_window",
+  // Open in new browser tab/window
+  "none"
+  // No navigation (read-only list)
+]));
+var NavigationConfigSchema = lazySchema(() => zod.z.object({
+  mode: NavigationModeSchema.default("page"),
+  /** Target View Config */
+  view: zod.z.string().optional().describe('Name of the form view to use for details (e.g. "summary_view", "edit_form")'),
+  /** Interaction Triggers */
+  preventNavigation: zod.z.boolean().default(false).describe("Disable standard navigation entirely"),
+  openNewTab: zod.z.boolean().default(false).describe("Force open in new tab (applies to page mode)"),
+  /** Dimensions (for modal/drawer) */
+  width: zod.z.union([zod.z.string(), zod.z.number()]).optional().describe('Width of the drawer/modal (e.g. "600px", "50%")')
 }));
-var JoinedReportBlockSchema = lazySchema(() => zod.z.object({
-  /** Stable id for the block (used as react key, telemetry, deeplinks). */
-  name: SnakeCaseIdentifierSchema,
-  /** Human label shown above the block. Falls back to `name`. */
+var ListViewSchema = lazySchema(() => zod.z.object({
+  name: SnakeCaseIdentifierSchema.optional().describe("Internal view name (lowercase snake_case)"),
   label: I18nLabelSchema.optional(),
-  /** Optional description rendered below the label. */
-  description: I18nLabelSchema.optional(),
-  /** Block report type — `joined` is intentionally excluded (no recursion). */
-  type: zod.z.enum(["tabular", "summary", "matrix"]).default("tabular"),
-  /** Object queried by this block. Defaults to the container's objectName. */
-  objectName: zod.z.string().optional(),
-  /** Columns to display / aggregate. Same shape as `Report.columns`. */
-  columns: zod.z.array(ReportColumnSchema),
-  /** Row groupings (same shape as `Report.groupingsDown`). */
-  groupingsDown: zod.z.array(ReportGroupingSchema).optional(),
-  /** Column groupings — only meaningful when `type: matrix`. */
-  groupingsAcross: zod.z.array(ReportGroupingSchema).optional(),
-  /** Block-specific filter, ANDed with the container filter at render time. */
-  filter: FilterConditionSchema.optional(),
-  /** Optional inline chart configuration. */
-  chart: ReportChartSchema.optional()
-}));
-var ReportSchema = lazySchema(() => zod.z.object({
-  /** Identity */
-  name: SnakeCaseIdentifierSchema.describe("Report unique name"),
-  label: I18nLabelSchema.describe("Report label"),
-  description: I18nLabelSchema.optional(),
-  /** Data Source */
-  objectName: zod.z.string().describe("Primary object"),
-  /** Report Configuration */
-  type: ReportType.default("tabular").describe("Report format type"),
-  columns: zod.z.array(ReportColumnSchema).describe("Columns to display"),
-  /** Grouping (for Summary/Matrix) */
-  groupingsDown: zod.z.array(ReportGroupingSchema).optional().describe("Row groupings"),
-  groupingsAcross: zod.z.array(ReportGroupingSchema).optional().describe("Column groupings (Matrix only)"),
-  /** Filtering (MongoDB-style FilterCondition) */
-  filter: FilterConditionSchema.optional().describe("Filter criteria"),
-  /** Visualization */
-  chart: ReportChartSchema.optional().describe("Embedded chart configuration"),
+  // Display label override (supports i18n)
+  type: zod.z.enum([
+    "grid",
+    // Standard Data Table
+    "kanban",
+    // Board / Columns
+    "gallery",
+    // Card Deck / Masonry
+    "calendar",
+    // Monthly/Weekly/Daily
+    "timeline",
+    // Chronological Stream (Feed)
+    "gantt",
+    // Project Timeline
+    "map",
+    // Geospatial
+    "chart"
+    // Aggregate visualisation
+  ]).default("grid"),
+  /** Data Source Configuration */
+  data: ViewDataSchema.optional().describe('Data source configuration (defaults to "object" provider)'),
+  /** Shared Query Config */
+  columns: zod.z.union([
+    zod.z.array(zod.z.string()),
+    // Legacy: simple field names
+    zod.z.array(ListColumnSchema)
+    // Enhanced: detailed column config
+  ]).describe("Fields to display as columns"),
+  filter: zod.z.array(ViewFilterRuleSchema).optional().describe("Filter criteria (JSON Rules)"),
+  sort: zod.z.union([
+    zod.z.string(),
+    //Legacy "field desc"
+    zod.z.array(zod.z.object({
+      field: zod.z.string(),
+      order: zod.z.enum(["asc", "desc"])
+    }))
+  ]).optional(),
+  /** Search & Filter */
+  searchableFields: zod.z.array(zod.z.string()).optional().describe("Fields enabled for search"),
+  filterableFields: zod.z.array(zod.z.string()).optional().describe("Fields enabled for end-user filtering in the top bar"),
+  /** Grid Features */
+  resizable: zod.z.boolean().optional().describe("Enable column resizing"),
+  striped: zod.z.boolean().optional().describe("Striped row styling"),
+  bordered: zod.z.boolean().optional().describe("Show borders"),
+  compactToolbar: zod.z.boolean().optional().describe("Collapse Group/Color/Density/Hide-fields into a single View settings popover"),
+  /** Selection */
+  selection: SelectionConfigSchema.optional().describe("Row selection configuration"),
+  /** Navigation / Interaction */
+  navigation: NavigationConfigSchema.optional().describe("Configuration for item click navigation (page, drawer, modal, etc.)"),
+  /** Pagination */
+  pagination: PaginationConfigSchema.optional().describe("Pagination configuration"),
+  /** Type Specific Config */
+  kanban: KanbanConfigSchema.optional(),
+  calendar: CalendarConfigSchema.optional(),
+  gantt: GanttConfigSchema.optional(),
+  gallery: GalleryConfigSchema.optional(),
+  timeline: TimelineConfigSchema.optional(),
+  chart: ListChartConfigSchema.optional(),
+  /** View Metadata (Airtable-style view management) */
+  description: I18nLabelSchema.optional().describe("View description for documentation/tooltips"),
+  sharing: ViewSharingSchema.optional().describe("View sharing and access configuration"),
+  /** Row Height / Density (Airtable-style) */
+  rowHeight: RowHeightSchema.optional().describe("Row height / density setting"),
+  /** Record Grouping (Airtable-style) */
+  grouping: GroupingConfigSchema.optional().describe("Group records by one or more fields"),
+  /** Row Color (Airtable-style) */
+  rowColor: RowColorConfigSchema.optional().describe("Color rows based on field value"),
+  /** Field Visibility & Ordering per View (Airtable-style) */
+  hiddenFields: zod.z.array(zod.z.string()).optional().describe("Fields to hide in this specific view"),
+  fieldOrder: zod.z.array(zod.z.string()).optional().describe("Explicit field display order for this view"),
+  /** Row & Bulk Actions */
+  rowActions: zod.z.array(zod.z.string()).optional().describe("Actions available for individual row items"),
+  bulkActions: zod.z.array(zod.z.string()).optional().describe("Actions available when multiple rows are selected"),
+  bulkActionDefs: zod.z.array(zod.z.record(zod.z.string(), zod.z.any())).optional().describe("Rich bulk action definitions (schema-driven, executed via BulkActionDialog)"),
+  /** Performance */
+  virtualScroll: zod.z.boolean().optional().describe("Enable virtual scrolling for large datasets"),
+  /** Conditional Formatting */
+  conditionalFormatting: zod.z.array(zod.z.object({
+    condition: ExpressionInputSchema.describe("Predicate (CEL) to evaluate."),
+    style: zod.z.record(zod.z.string(), zod.z.string()).describe("CSS styles to apply when condition is true")
+  })).optional().describe("Conditional formatting rules for list rows"),
+  /** Inline Edit */
+  inlineEdit: zod.z.boolean().optional().describe("Allow inline editing of records directly in the list view"),
+  /** Export */
+  exportOptions: zod.z.array(zod.z.enum(["csv", "xlsx", "pdf", "json"])).optional().describe("Available export format options"),
+  /** User Actions (Airtable Interface parity) */
+  userActions: UserActionsConfigSchema.optional().describe("User action toggles for the view toolbar"),
+  /** Appearance (Airtable Interface parity) */
+  appearance: AppearanceConfigSchema.optional().describe("Appearance and visualization configuration"),
+  /** Tabs (Airtable Interface parity) */
+  tabs: zod.z.array(ViewTabSchema).optional().describe("Tab definitions for multi-tab view interface"),
+  /** Add Record (Airtable Interface parity) */
+  addRecord: AddRecordConfigSchema.optional().describe("Add record entry point configuration"),
+  /** Record Count Display (Airtable Interface parity) */
+  showRecordCount: zod.z.boolean().optional().describe("Show record count at the bottom of the list"),
+  /** Advanced: Allow Printing (Airtable Interface parity) */
+  allowPrinting: zod.z.boolean().optional().describe("Allow users to print the view"),
+  /** Empty State */
+  emptyState: zod.z.object({
+    title: I18nLabelSchema.optional(),
+    message: I18nLabelSchema.optional(),
+    icon: zod.z.string().optional()
+  }).optional().describe("Empty state configuration when no records found"),
   /** ARIA accessibility attributes */
-  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes"),
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes for the list view"),
+  /** Responsive layout overrides per breakpoint */
+  responsive: ResponsiveConfigSchema.optional().describe("Responsive layout configuration"),
   /** Performance optimization settings */
-  performance: PerformanceConfigSchema.optional().describe("Performance optimization settings"),
+  performance: PerformanceConfigSchema.optional().describe("Performance optimization settings")
+}));
+var FormFieldSchema = lazySchema(() => zod.z.object({
+  /** Field name (snake_case) */
+  field: zod.z.string().describe("Field name (snake_case)"),
+  /** Field type — reuses Data.FieldType. When set, widget is auto-inferred (can be overridden). */
+  type: FieldType.optional().describe("Field type (auto-infers widget if omitted)"),
+  /** Select/multiselect options — only needed when type=select/multiselect/radio/checkboxes */
+  options: zod.z.array(SelectOptionSchema).optional().describe("Options for select/multiselect/radio/checkboxes fields"),
+  /** Reference object for lookup/master_detail fields */
+  reference: zod.z.string().optional().describe("Target object name for lookup/master_detail fields"),
+  /** Text constraints */
+  maxLength: zod.z.number().optional().describe("Maximum character length (for text/textarea/email/url/phone)"),
+  minLength: zod.z.number().optional().describe("Minimum character length"),
+  /** Number constraints */
+  min: zod.z.number().optional().describe("Minimum value (for number/currency/percent/slider)"),
+  max: zod.z.number().optional().describe("Maximum value"),
+  precision: zod.z.number().optional().describe("Total digits (for number/currency)"),
+  scale: zod.z.number().optional().describe("Decimal places"),
+  /** Multi-value flag */
+  multiple: zod.z.boolean().optional().describe("Allow multiple values (for select/lookup/file/image)"),
+  /** UI overrides */
+  label: I18nLabelSchema.optional().describe("Display label override"),
+  placeholder: I18nLabelSchema.optional().describe("Placeholder text"),
+  helpText: I18nLabelSchema.optional().describe("Help/hint text"),
+  readonly: zod.z.boolean().optional().describe("Read-only override"),
+  immutable: zod.z.boolean().optional().describe("Editable on create, locked once the record exists (e.g. machine names)."),
+  required: zod.z.boolean().optional().describe("Required override"),
+  hidden: zod.z.boolean().optional().describe("Hidden override"),
+  colSpan: zod.z.number().int().min(1).max(4).optional().describe("Column span in grid layout (1-4)"),
+  /** Custom widget override — only needed when auto-inference is insufficient */
+  widget: zod.z.string().optional().describe("Custom widget/component name (overrides type-based inference)"),
+  /** For `code` fields: source language (e.g. 'javascript', 'sql', 'json', 'typescript', 'expression', 'cel'). Drives syntax highlighting. */
+  language: zod.z.string().optional().describe("Code editor language (for type=code)"),
+  /**
+   * Sub-fields for `composite` / `repeater` types — declares the inner shape
+   * of an embedded sub-object (composite) or each row of an embedded
+   * sub-object array (repeater). Recursive: composite/repeater can nest.
+   * Ignored for all other field types.
+   *
+   * Use `lookup` / `master_detail` instead when the children are independent
+   * records with their own IDs in a separate object/table.
+   */
+  fields: zod.z.array(zod.z.lazy(() => FormFieldSchema)).optional().describe("Sub-fields for composite/repeater types"),
+  dependsOn: zod.z.string().optional().describe("Parent field name for cascading"),
+  visibleOn: ExpressionInputSchema.optional().describe("Visibility predicate (CEL).")
+}));
+var FormSectionSchema = lazySchema(() => zod.z.object({
+  label: I18nLabelSchema.optional(),
+  description: zod.z.string().optional().describe("Optional description rendered under the section header."),
+  collapsible: zod.z.boolean().default(false),
+  collapsed: zod.z.boolean().default(false),
+  visibleOn: ExpressionInputSchema.optional().describe("Visibility predicate (CEL). Hides the whole section when false."),
+  columns: zod.z.union([
+    zod.z.enum(["1", "2", "3", "4"]),
+    zod.z.literal(1),
+    zod.z.literal(2),
+    zod.z.literal(3),
+    zod.z.literal(4)
+  ]).default(1).transform((val) => typeof val === "string" ? parseInt(val) : val),
+  fields: zod.z.array(zod.z.union([
+    zod.z.string(),
+    // Legacy: simple field name
+    FormFieldSchema
+    // Enhanced: detailed field config
+  ]))
+}));
+var FormViewSchema = lazySchema(() => zod.z.object({
+  type: zod.z.enum([
+    "simple",
+    // Single column or sections
+    "tabbed",
+    // Tabs
+    "wizard",
+    // Step by step
+    "split",
+    // Master-Detail split
+    "drawer",
+    // Side panel
+    "modal"
+    // Dialog
+  ]).default("simple"),
+  /** Data Source Configuration */
+  data: ViewDataSchema.optional().describe('Data source configuration (defaults to "object" provider)'),
+  sections: zod.z.array(FormSectionSchema).optional(),
+  // For simple layout
+  groups: zod.z.array(FormSectionSchema).optional(),
+  // Legacy support -> alias to sections
+  /** Default Sort for Related Lists (e.g., sort child records by date) */
+  defaultSort: zod.z.array(zod.z.object({
+    field: zod.z.string().describe("Field name to sort by"),
+    order: zod.z.enum(["asc", "desc"]).default("desc").describe("Sort direction")
+  })).optional().describe("Default sort order for related list views within this form"),
+  /** Public form sharing configuration */
+  sharing: SharingConfigSchema.optional().describe("Public sharing configuration for this form"),
   /**
-   * Joined report blocks — only meaningful when `type: 'joined'`.
-   *
-   * A joined report renders multiple independent sub-reports stacked
-   * vertically in the same view. Each block declares its own object,
-   * columns, groupings and filter. The container-level `filter` is ANDed
-   * into every block at query time so a top-level scope (e.g. "this
-   * quarter") flows down without per-block duplication.
+   * What happens after a successful submit.
    *
-   * Renderers must ignore `blocks` when `type !== 'joined'`.
+   * - `thank-you` (default) — show a confirmation panel
+   * - `redirect` — send the browser to a URL
+   * - `continue` — reset the form so another response can be entered
+   * - `next-record` — advance to the next record (internal queues only)
    */
-  blocks: zod.z.array(JoinedReportBlockSchema).optional().describe("Sub-reports for type=joined")
+  submitBehavior: zod.z.union([
+    zod.z.object({
+      kind: zod.z.literal("thank-you"),
+      title: zod.z.string().optional(),
+      message: zod.z.string().optional()
+    }),
+    zod.z.object({
+      kind: zod.z.literal("redirect"),
+      url: zod.z.string(),
+      delayMs: zod.z.number().int().min(0).optional()
+    }),
+    zod.z.object({ kind: zod.z.literal("continue") }),
+    zod.z.object({ kind: zod.z.literal("next-record") })
+  ]).optional().describe("Post-submit behavior"),
+  /** ARIA accessibility attributes */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes for the form view")
+}));
+var ViewSchema = lazySchema(() => zod.z.object({
+  list: ListViewSchema.optional(),
+  // Default list view
+  form: FormViewSchema.optional(),
+  // Default form view
+  listViews: zod.z.record(zod.z.string(), ListViewSchema).optional().describe("Additional named list views"),
+  formViews: zod.z.record(zod.z.string(), FormViewSchema).optional().describe("Additional named form views")
+}));
+function defineView(config) {
+  return ViewSchema.parse(config);
+}
+function defineForm(config) {
+  const { schemaId, ...rest } = config;
+  return FormViewSchema.parse({
+    ...rest,
+    data: { provider: "schema", schemaId }
+  });
+}
+var FieldReferenceSchema = lazySchema(() => zod.z.object({
+  $field: zod.z.string().describe("Field Reference/Column Name")
 }));
-var Report = {
-  create: (config) => ReportSchema.parse(config)
-};
-var EncryptionAlgorithmSchema = lazySchema(() => zod.z.enum([
-  "aes-256-gcm",
-  "aes-256-cbc",
-  "chacha20-poly1305"
-]).describe("Supported encryption algorithm"));
-var KeyManagementProviderSchema = lazySchema(() => zod.z.enum([
-  "local",
-  "aws-kms",
-  "azure-key-vault",
-  "gcp-kms",
-  "hashicorp-vault"
-]).describe("Key management service provider"));
-var KeyRotationPolicySchema = lazySchema(() => zod.z.object({
-  enabled: zod.z.boolean().default(false).describe("Enable automatic key rotation"),
-  frequencyDays: zod.z.number().min(1).default(90).describe("Rotation frequency in days"),
-  retainOldVersions: zod.z.number().default(3).describe("Number of old key versions to retain"),
-  autoRotate: zod.z.boolean().default(true).describe("Automatically rotate without manual approval")
-}).describe("Policy for automatic encryption key rotation"));
-var EncryptionConfigSchema = lazySchema(() => zod.z.object({
-  enabled: zod.z.boolean().default(false).describe("Enable field-level encryption"),
-  algorithm: EncryptionAlgorithmSchema.default("aes-256-gcm").describe("Encryption algorithm"),
-  keyManagement: zod.z.object({
-    provider: KeyManagementProviderSchema.describe("Key management service provider"),
-    keyId: zod.z.string().optional().describe("Key identifier in the provider"),
-    rotationPolicy: KeyRotationPolicySchema.optional().describe("Key rotation policy")
-  }).describe("Key management configuration"),
-  scope: zod.z.enum(["field", "record", "table", "database"]).describe("Encryption scope level"),
-  deterministicEncryption: zod.z.boolean().default(false).describe("Allows equality queries on encrypted data"),
-  searchableEncryption: zod.z.boolean().default(false).describe("Allows search on encrypted data")
-}).describe("Field-level encryption configuration"));
 lazySchema(() => zod.z.object({
-  fieldName: zod.z.string().describe("Name of the field to encrypt"),
-  encryptionConfig: EncryptionConfigSchema.describe("Encryption settings for this field"),
-  indexable: zod.z.boolean().default(false).describe("Allow indexing on encrypted field")
-}).describe("Per-field encryption assignment"));
-var MaskingStrategySchema = lazySchema(() => zod.z.enum([
-  "redact",
-  // Complete redaction: ****
-  "partial",
-  // Partial masking: 138****5678
-  "hash",
-  // Hash value: sha256(value)
-  "tokenize",
-  // Tokenization: token-12345
-  "randomize",
-  // Randomize: generate random value
-  "nullify",
-  // Null value: null
-  "substitute"
-  // Substitute with dummy data
-]).describe("Data masking strategy for PII protection"));
-var MaskingRuleSchema = lazySchema(() => zod.z.object({
-  field: zod.z.string().describe("Field name to apply masking to"),
-  strategy: MaskingStrategySchema.describe("Masking strategy to use"),
-  pattern: zod.z.string().optional().describe("Regex pattern for partial masking"),
-  preserveFormat: zod.z.boolean().default(true).describe("Keep the original data format after masking"),
-  preserveLength: zod.z.boolean().default(true).describe("Keep the original data length after masking"),
-  roles: zod.z.array(zod.z.string()).optional().describe("Roles that see masked data"),
-  exemptRoles: zod.z.array(zod.z.string()).optional().describe("Roles that see unmasked data")
-}).describe("Masking rule for a single field"));
+  /** Equal to (default) - SQL: = | MongoDB: $eq */
+  $eq: zod.z.any().optional(),
+  /** Not equal to - SQL: <> or != | MongoDB: $ne */
+  $ne: zod.z.any().optional()
+}));
 lazySchema(() => zod.z.object({
-  enabled: zod.z.boolean().default(false).describe("Enable data masking"),
-  rules: zod.z.array(MaskingRuleSchema).describe("List of field-level masking rules"),
-  auditUnmasking: zod.z.boolean().default(true).describe("Log when masked data is accessed unmasked")
-}).describe("Top-level data masking configuration for PII protection"));
-
-// src/data/field.zod.ts
-var FieldType = zod.z.enum([
-  // Core Text
-  "text",
-  "textarea",
-  "email",
-  "url",
-  "phone",
-  "password",
-  // Rich Content
-  "markdown",
-  "html",
-  "richtext",
-  // Numbers
-  "number",
-  "currency",
-  "percent",
-  // Date & Time
-  "date",
-  "datetime",
-  "time",
-  // Logic
-  "boolean",
-  "toggle",
-  // Toggle is a distinct UI from checkbox
-  // Selection
-  "select",
-  // Single select dropdown
-  "multiselect",
-  // Multi select (often tags)
-  "radio",
-  // Radio group
-  "checkboxes",
-  // Checkbox group
-  // Relational
-  "lookup",
-  "master_detail",
-  // Dynamic reference
-  "tree",
-  // Hierarchical reference
-  // Media
-  "image",
-  "file",
-  "avatar",
-  "video",
-  "audio",
-  // Calculated / System
-  "formula",
-  "summary",
-  "autonumber",
-  // Enhanced Types
-  "location",
-  // GPS coordinates
-  "address",
-  // Structured address
-  "code",
-  // Code editor (JSON/SQL/JS)
-  "json",
-  // Structured JSON data
-  "color",
-  // Color picker
-  "rating",
-  // Star rating
-  "slider",
-  // Numeric slider
-  "signature",
-  // Digital signature
-  "qrcode",
-  // QR code / Barcode
-  "progress",
-  // Progress bar
-  "tags",
-  // Simple tag list
-  // AI/ML Types
-  "vector"
-  // Vector embeddings for AI/ML (semantic search, RAG)
-]);
-var SelectOptionSchema = lazySchema(() => zod.z.object({
-  label: zod.z.string().describe("Display label (human-readable, any case allowed)"),
-  value: SystemIdentifierSchema.describe("Stored value (lowercase machine identifier)"),
-  color: zod.z.string().optional().describe("Color code for badges/charts"),
-  default: zod.z.boolean().optional().describe("Is default option")
+  /** Greater than - SQL: > | MongoDB: $gt */
+  $gt: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
+  /** Greater than or equal to - SQL: >= | MongoDB: $gte */
+  $gte: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
+  /** Less than - SQL: < | MongoDB: $lt */
+  $lt: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
+  /** Less than or equal to - SQL: <= | MongoDB: $lte */
+  $lte: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional()
+}));
+lazySchema(() => zod.z.object({
+  /** In list - SQL: IN (?, ?, ?) | MongoDB: $in */
+  $in: zod.z.array(zod.z.any()).optional(),
+  /** Not in list - SQL: NOT IN (...) | MongoDB: $nin */
+  $nin: zod.z.array(zod.z.any()).optional()
 }));
 lazySchema(() => zod.z.object({
-  latitude: zod.z.number().min(-90).max(90).describe("Latitude coordinate"),
-  longitude: zod.z.number().min(-180).max(180).describe("Longitude coordinate"),
-  altitude: zod.z.number().optional().describe("Altitude in meters"),
-  accuracy: zod.z.number().optional().describe("Accuracy in meters")
+  /** Between (inclusive) - takes [min, max] array */
+  $between: zod.z.tuple([
+    zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]),
+    zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema])
+  ]).optional()
 }));
-var CurrencyConfigSchema = lazySchema(() => zod.z.object({
-  precision: zod.z.number().int().min(0).max(10).default(2).describe("Decimal precision (default: 2)"),
-  currencyMode: zod.z.enum(["dynamic", "fixed"]).default("dynamic").describe("Currency mode: dynamic (user selectable) or fixed (single currency)"),
-  defaultCurrency: zod.z.string().length(3).default("CNY").describe("Default or fixed currency code (ISO 4217, e.g., USD, CNY, EUR)")
+lazySchema(() => zod.z.object({
+  /** Contains substring - SQL: LIKE %?% | MongoDB: $regex */
+  $contains: zod.z.string().optional(),
+  /** Does not contain substring - SQL: NOT LIKE %?% | MongoDB: $not: $regex */
+  $notContains: zod.z.string().optional(),
+  /** Starts with prefix - SQL: LIKE ?% | MongoDB: $regex */
+  $startsWith: zod.z.string().optional(),
+  /** Ends with suffix - SQL: LIKE %? | MongoDB: $regex */
+  $endsWith: zod.z.string().optional()
 }));
 lazySchema(() => zod.z.object({
-  value: zod.z.number().describe("Monetary amount"),
-  currency: zod.z.string().length(3).describe("Currency code (ISO 4217)")
+  /** Is null check - SQL: IS NULL (true) / IS NOT NULL (false) | MongoDB: field: null */
+  $null: zod.z.boolean().optional(),
+  /** Field exists check (primarily for NoSQL) - MongoDB: $exists */
+  $exists: zod.z.boolean().optional()
+}));
+var FieldOperatorsSchema = lazySchema(() => zod.z.object({
+  // Equality
+  $eq: zod.z.any().optional(),
+  $ne: zod.z.any().optional(),
+  // Comparison (numeric/date)
+  $gt: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
+  $gte: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
+  $lt: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
+  $lte: zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]).optional(),
+  // Set & Range
+  $in: zod.z.array(zod.z.any()).optional(),
+  $nin: zod.z.array(zod.z.any()).optional(),
+  $between: zod.z.tuple([
+    zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema]),
+    zod.z.union([zod.z.number(), zod.z.date(), FieldReferenceSchema])
+  ]).optional(),
+  // String-specific
+  $contains: zod.z.string().optional(),
+  $notContains: zod.z.string().optional(),
+  $startsWith: zod.z.string().optional(),
+  $endsWith: zod.z.string().optional(),
+  // Special
+  $null: zod.z.boolean().optional(),
+  $exists: zod.z.boolean().optional()
+}));
+var FilterConditionSchema = zod.z.lazy(
+  () => zod.z.record(zod.z.string(), zod.z.unknown()).and(
+    zod.z.object({
+      $and: zod.z.array(FilterConditionSchema).optional(),
+      $or: zod.z.array(FilterConditionSchema).optional(),
+      $not: FilterConditionSchema.optional()
+    })
+  )
+);
+lazySchema(() => zod.z.object({
+  where: FilterConditionSchema.optional()
+}));
+var NormalizedFilterSchema = zod.z.lazy(
+  () => zod.z.object({
+    $and: zod.z.array(
+      zod.z.union([
+        // Field condition: { field: { $op: value } }
+        zod.z.record(zod.z.string(), FieldOperatorsSchema),
+        // Nested logical group
+        NormalizedFilterSchema
+      ])
+    ).optional(),
+    $or: zod.z.array(
+      zod.z.union([
+        zod.z.record(zod.z.string(), FieldOperatorsSchema),
+        NormalizedFilterSchema
+      ])
+    ).optional(),
+    $not: zod.z.union([
+      zod.z.record(zod.z.string(), FieldOperatorsSchema),
+      NormalizedFilterSchema
+    ]).optional()
+  })
+);
+var SortNodeSchema = lazySchema(() => zod.z.object({
+  field: zod.z.string(),
+  order: zod.z.enum(["asc", "desc"]).default("asc")
+}));
+var AggregationFunction = zod.z.enum([
+  "count",
+  "sum",
+  "avg",
+  "min",
+  "max",
+  "count_distinct",
+  "array_agg",
+  "string_agg"
+]);
+var DateGranularity = zod.z.enum(["day", "week", "month", "quarter", "year"]);
+var GroupByNodeSchema = lazySchema(() => zod.z.union([
+  zod.z.string(),
+  zod.z.object({
+    field: zod.z.string().describe("Field to group by"),
+    dateGranularity: DateGranularity.optional().describe("Bucket date values into uniform periods (day/week/month/quarter/year)"),
+    /** Optional alias for the projected group value (defaults to `field`). */
+    alias: zod.z.string().optional().describe("Alias for the projected group value")
+  })
+]));
+var AggregationNodeSchema = lazySchema(() => zod.z.object({
+  function: AggregationFunction.describe("Aggregation function"),
+  field: zod.z.string().optional().describe("Field to aggregate (optional for COUNT(*))"),
+  alias: zod.z.string().describe("Result column alias"),
+  distinct: zod.z.boolean().optional().describe("Apply DISTINCT before aggregation"),
+  filter: FilterConditionSchema.optional().describe("Filter/Condition to apply to the aggregation (FILTER WHERE clause)")
+}));
+var JoinType = zod.z.enum(["inner", "left", "right", "full"]);
+var JoinStrategy = zod.z.enum(["auto", "database", "hash", "loop"]);
+var JoinNodeSchema = zod.z.lazy(
+  () => zod.z.object({
+    type: JoinType.describe("Join type"),
+    strategy: JoinStrategy.optional().describe("Execution strategy hint"),
+    object: zod.z.string().describe("Object/table to join"),
+    alias: zod.z.string().optional().describe("Table alias"),
+    on: FilterConditionSchema.describe("Join condition"),
+    subquery: zod.z.lazy(() => QuerySchema).optional().describe("Subquery instead of object")
+  })
+);
+var WindowFunction = zod.z.enum([
+  "row_number",
+  "rank",
+  "dense_rank",
+  "percent_rank",
+  "lag",
+  "lead",
+  "first_value",
+  "last_value",
+  "sum",
+  "avg",
+  "count",
+  "min",
+  "max"
+]);
+var WindowSpecSchema = lazySchema(() => zod.z.object({
+  partitionBy: zod.z.array(zod.z.string()).optional().describe("PARTITION BY fields"),
+  orderBy: zod.z.array(SortNodeSchema).optional().describe("ORDER BY specification"),
+  frame: zod.z.object({
+    type: zod.z.enum(["rows", "range"]).optional(),
+    start: zod.z.string().optional().describe('Frame start (e.g., "UNBOUNDED PRECEDING", "1 PRECEDING")'),
+    end: zod.z.string().optional().describe('Frame end (e.g., "CURRENT ROW", "1 FOLLOWING")')
+  }).optional().describe("Window frame specification")
+}));
+var WindowFunctionNodeSchema = lazySchema(() => zod.z.object({
+  function: WindowFunction.describe("Window function name"),
+  field: zod.z.string().optional().describe("Field to operate on (for aggregate window functions)"),
+  alias: zod.z.string().describe("Result column alias"),
+  over: WindowSpecSchema.describe("Window specification (OVER clause)")
+}));
+var FieldNodeSchema = zod.z.lazy(
+  () => zod.z.union([
+    zod.z.string(),
+    // Primitive field: "name"
+    zod.z.object({
+      field: zod.z.string(),
+      // Relationship field: "owner"
+      fields: zod.z.array(FieldNodeSchema).optional(),
+      // Nested select: ["name", "email"]
+      alias: zod.z.string().optional()
+    })
+  ])
+);
+var FullTextSearchSchema = lazySchema(() => zod.z.object({
+  query: zod.z.string().describe("Search query text"),
+  fields: zod.z.array(zod.z.string()).optional().describe("Fields to search in (if not specified, searches all text fields)"),
+  fuzzy: zod.z.boolean().optional().default(false).describe("Enable fuzzy matching (tolerates typos)"),
+  operator: zod.z.enum(["and", "or"]).optional().default("or").describe("Logical operator between terms"),
+  boost: zod.z.record(zod.z.string(), zod.z.number()).optional().describe("Field-specific relevance boosting (field name -> boost factor)"),
+  minScore: zod.z.number().optional().describe("Minimum relevance score threshold"),
+  language: zod.z.string().optional().describe('Language for text analysis (e.g., "en", "zh", "es")'),
+  highlight: zod.z.boolean().optional().default(false).describe("Enable search result highlighting")
+}));
+var BaseQuerySchema = zod.z.object({
+  /** Target Entity */
+  object: zod.z.string().describe("Object name (e.g. account)"),
+  /** Select Clause */
+  fields: zod.z.array(FieldNodeSchema).optional().describe("Fields to retrieve"),
+  /** Where Clause (Filtering) */
+  where: FilterConditionSchema.optional().describe("Filtering criteria (WHERE)"),
+  /** Full-Text Search */
+  search: FullTextSearchSchema.optional().describe("Full-text search configuration ($search parameter)"),
+  /** Order By Clause (Sorting) */
+  orderBy: zod.z.array(SortNodeSchema).optional().describe("Sorting instructions (ORDER BY)"),
+  /** Pagination */
+  limit: zod.z.number().optional().describe("Max records to return (LIMIT)"),
+  offset: zod.z.number().optional().describe("Records to skip (OFFSET)"),
+  top: zod.z.number().optional().describe("Alias for limit (OData compatibility)"),
+  cursor: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Cursor for keyset pagination"),
+  /** Joins */
+  joins: zod.z.array(JoinNodeSchema).optional().describe("Explicit Table Joins"),
+  /** Aggregations */
+  aggregations: zod.z.array(AggregationNodeSchema).optional().describe("Aggregation functions"),
+  /** Group By Clause */
+  groupBy: zod.z.array(GroupByNodeSchema).optional().describe("GROUP BY targets (strings or `{field, dateGranularity?}` objects for date bucketing)"),
+  /** Having Clause */
+  having: FilterConditionSchema.optional().describe("HAVING clause for aggregation filtering"),
+  /** Window Functions */
+  windowFunctions: zod.z.array(WindowFunctionNodeSchema).optional().describe("Window functions with OVER clause"),
+  /** Subquery flag */
+  distinct: zod.z.boolean().optional().describe("SELECT DISTINCT flag")
+});
+var QuerySchema = lazySchema(() => BaseQuerySchema.extend({
+  expand: zod.z.lazy(() => zod.z.record(zod.z.string(), QuerySchema)).optional().describe(
+    "Recursive relation loading map. Keys are lookup/master_detail field names; values are nested QueryAST objects that control select, filter, sort, and further expansion on the related object. The engine resolves expand via batch $in queries (driver-agnostic) with a default max depth of 3."
+  )
+}));
+
+// src/ui/dashboard.zod.ts
+var WidgetColorVariantSchema = lazySchema(() => zod.z.enum([
+  "default",
+  "blue",
+  "teal",
+  "orange",
+  "purple",
+  "success",
+  "warning",
+  "danger"
+]).describe("Widget color variant"));
+var WidgetActionTypeSchema = lazySchema(() => zod.z.enum([
+  "script",
+  "url",
+  "modal",
+  "flow",
+  "api"
+]).describe("Widget action type"));
+var DashboardHeaderActionSchema = lazySchema(() => zod.z.object({
+  /** Action label */
+  label: I18nLabelSchema.describe("Action button label"),
+  /** Action URL or target */
+  actionUrl: zod.z.string().describe("URL or target for the action"),
+  /** Action type */
+  actionType: WidgetActionTypeSchema.optional().describe("Type of action"),
+  /** Icon identifier */
+  icon: zod.z.string().optional().describe("Icon identifier for the action button")
+}).describe("Dashboard header action"));
+var DashboardHeaderSchema = lazySchema(() => zod.z.object({
+  /** Whether to show the dashboard title in the header */
+  showTitle: zod.z.boolean().default(true).describe("Show dashboard title in header"),
+  /** Whether to show the dashboard description in the header */
+  showDescription: zod.z.boolean().default(true).describe("Show dashboard description in header"),
+  /** Action buttons displayed in the header */
+  actions: zod.z.array(DashboardHeaderActionSchema).optional().describe("Header action buttons")
+}).describe("Dashboard header configuration"));
+var WidgetMeasureSchema = lazySchema(() => zod.z.object({
+  /** Value field to aggregate */
+  valueField: zod.z.string().describe("Field to aggregate"),
+  /** Aggregate function */
+  aggregate: zod.z.enum(["count", "sum", "avg", "min", "max"]).default("count").describe("Aggregate function"),
+  /** Display label for the measure */
+  label: I18nLabelSchema.optional().describe("Measure display label"),
+  /** Number format string (e.g., "$0,0.00", "0.0%") */
+  format: zod.z.string().optional().describe("Number format string")
+}).describe("Widget measure definition"));
+var DashboardWidgetSchema = lazySchema(() => zod.z.object({
+  /** Unique widget identifier (snake_case, used for targetWidgets references) */
+  id: SnakeCaseIdentifierSchema.describe("Unique widget identifier (snake_case)"),
+  /** Widget Title */
+  title: I18nLabelSchema.optional().describe("Widget title"),
+  /** Widget Description (displayed below the title) */
+  description: I18nLabelSchema.optional().describe("Widget description text below the header"),
+  /** Visualization Type */
+  type: ChartTypeSchema.default("metric").describe("Visualization type"),
+  /** Chart Configuration */
+  chartConfig: ChartConfigSchema.optional().describe("Chart visualization configuration"),
+  /** Color variant for the widget (e.g., KPI card accent color) */
+  colorVariant: WidgetColorVariantSchema.optional().describe("Widget color variant for theming"),
+  /**
+   * Runtime capability gate — widget is hidden when the named object is
+   * not registered in the runtime's SchemaRegistry. Mirrors
+   * `NavigationItem.requiresObject` so cloud-only widgets (e.g. those
+   * keyed on `sys_app` / `sys_package_installation`) silently disappear
+   * in single-environment runtimes instead of rendering a 404 error.
+   *
+   * Defaults to the widget's `object` field when not explicitly set —
+   * any widget that targets an object will be gated on that object's
+   * registration. Set this to a different value (or empty string to
+   * disable) when the widget should appear even if its `object` is
+   * unavailable.
+   */
+  requiresObject: zod.z.string().optional().describe("Hide the widget unless the named object is registered"),
+  /**
+   * Runtime capability gate — widget is hidden when the named kernel
+   * service is not registered. Mirrors `NavigationItem.requiresService`.
+   */
+  requiresService: zod.z.string().optional().describe("Hide the widget unless the named kernel service is registered"),
+  /** Action URL for the widget header action button */
+  actionUrl: zod.z.string().optional().describe("URL or target for the widget action button"),
+  /** Action type for the widget header action button */
+  actionType: WidgetActionTypeSchema.optional().describe("Type of action for the widget action button"),
+  /** Icon for the widget header action button */
+  actionIcon: zod.z.string().optional().describe("Icon identifier for the widget action button"),
+  /** Data Source Object */
+  object: zod.z.string().optional().describe("Data source object name"),
+  /** Data Filter (MongoDB-style FilterCondition) */
+  filter: FilterConditionSchema.optional().describe("Data filter criteria"),
+  /**
+   * Period-over-period comparison primitive.
+   *
+   * When set, the renderer runs a second query against a shifted time
+   * window and surfaces the delta (metric widgets show a secondary
+   * value + arrow; chart widgets render a muted/dashed overlay series).
+   *
+   * - `'previousPeriod'` — auto-detect the comparison window from the
+   *   widget's `filter` date macros (e.g. `{current_month_start}` →
+   *   `{last_month_start}`). Falls back to no comparison when the
+   *   filter contains no resolvable date range.
+   * - `'previousYear'` — shift the resolved filter window back by one
+   *   calendar year.
+   * - `{ offset: '7d' | '1M' | '1y' }` — shift by an explicit
+   *   ISO-8601-like duration. Units: `d` (days), `w` (weeks),
+   *   `M` (months), `y` (years).
+   */
+  compareTo: zod.z.union([
+    zod.z.literal("previousPeriod"),
+    zod.z.literal("previousYear"),
+    zod.z.object({
+      offset: zod.z.string().regex(/^\d+[dwMy]$/, 'Offset must match <N>(d|w|M|y), e.g. "7d", "1M", "1y"')
+    })
+  ]).optional().describe("Period-over-period comparison window"),
+  /** Category Field (X-Axis / Group By) */
+  categoryField: zod.z.string().optional().describe("Field for grouping (X-Axis)"),
+  /**
+   * Date Bucketing Granularity for `categoryField`
+   *
+   * When set and `categoryField` references a date/datetime field, the engine
+   * buckets values into uniform `day` / `week` / `month` / `quarter` / `year`
+   * periods server-side (PostgreSQL `date_trunc`, MySQL `date_format`, SQLite
+   * `strftime`, MongoDB `$dateTrunc`; falls back to in-memory ISO-8601
+   * bucketing otherwise). Without this, raw timestamps are grouped verbatim
+   * which typically yields one bucket per row — making time-series charts
+   * appear flat.
+   *
+   * Mirrors the `dateGranularity` shape of {@link GroupByNodeSchema}.
+   */
+  categoryGranularity: DateGranularity.optional().describe("Bucket categoryField date values into day/week/month/quarter/year periods"),
+  /** Value Field (Y-Axis) */
+  valueField: zod.z.string().optional().describe("Field for values (Y-Axis)"),
+  /** Aggregate operation */
+  aggregate: zod.z.enum(["count", "sum", "avg", "min", "max"]).optional().default("count").describe("Aggregate function"),
+  /** Multi-measure definitions for pivot/matrix widgets */
+  measures: zod.z.array(WidgetMeasureSchema).optional().describe("Multiple measures for pivot/matrix analysis"),
+  /** 
+   * Layout Position (React-Grid-Layout style)
+   * x: column (0-11)
+   * y: row
+   * w: width (1-12)
+   * h: height
+   */
+  layout: zod.z.object({
+    x: zod.z.number(),
+    y: zod.z.number(),
+    w: zod.z.number(),
+    h: zod.z.number()
+  }).describe("Grid layout position"),
+  /** Widget specific options (colors, legend, etc.) */
+  options: zod.z.unknown().optional().describe("Widget specific configuration"),
+  /** Responsive layout overrides per breakpoint */
+  responsive: ResponsiveConfigSchema.optional().describe("Responsive layout configuration"),
+  /** ARIA accessibility attributes */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 }));
-lazySchema(() => zod.z.object({
-  street: zod.z.string().optional().describe("Street address"),
-  city: zod.z.string().optional().describe("City name"),
-  state: zod.z.string().optional().describe("State/Province"),
-  postalCode: zod.z.string().optional().describe("Postal/ZIP code"),
-  country: zod.z.string().optional().describe("Country name or code"),
-  countryCode: zod.z.string().optional().describe("ISO country code (e.g., US, GB)"),
-  formatted: zod.z.string().optional().describe("Formatted address string")
+var GlobalFilterOptionsFromSchema = lazySchema(() => zod.z.object({
+  /** Source object name to fetch options from */
+  object: zod.z.string().describe("Source object name"),
+  /** Field to use as option value */
+  valueField: zod.z.string().describe("Field to use as option value"),
+  /** Field to use as option label */
+  labelField: zod.z.string().describe("Field to use as option label"),
+  /** Optional filter to apply when fetching options */
+  filter: FilterConditionSchema.optional().describe("Filter to apply to source object")
+}).describe("Dynamic filter options from object"));
+var GlobalFilterSchema = lazySchema(() => zod.z.object({
+  /** Field name to filter on */
+  field: zod.z.string().describe("Field name to filter on"),
+  /** Display label for the filter */
+  label: I18nLabelSchema.optional().describe("Display label for the filter"),
+  /** Filter input type */
+  type: zod.z.enum(["text", "select", "date", "number", "lookup"]).optional().describe("Filter input type"),
+  /** Static options for select/lookup filters */
+  options: zod.z.array(zod.z.object({
+    value: zod.z.union([zod.z.string(), zod.z.number(), zod.z.boolean()]).describe("Option value"),
+    label: I18nLabelSchema
+  })).optional().describe("Static filter options"),
+  /** Dynamic data binding for filter options */
+  optionsFrom: GlobalFilterOptionsFromSchema.optional().describe("Dynamic filter options from object"),
+  /** Default filter value */
+  defaultValue: zod.z.union([zod.z.string(), zod.z.number(), zod.z.boolean()]).optional().describe("Default filter value"),
+  /** Filter application scope */
+  scope: zod.z.enum(["dashboard", "widget"]).default("dashboard").describe("Filter application scope"),
+  /** Widget IDs to apply this filter to (when scope is widget) */
+  targetWidgets: zod.z.array(zod.z.string()).optional().describe("Widget IDs to apply this filter to")
 }));
-var VectorConfigSchema = lazySchema(() => zod.z.object({
-  dimensions: zod.z.number().int().min(1).max(1e4).describe("Vector dimensionality (e.g., 1536 for OpenAI embeddings)"),
-  distanceMetric: zod.z.enum(["cosine", "euclidean", "dotProduct", "manhattan"]).default("cosine").describe("Distance/similarity metric for vector search"),
-  normalized: zod.z.boolean().default(false).describe("Whether vectors are normalized (unit length)"),
-  indexed: zod.z.boolean().default(true).describe("Whether to create a vector index for fast similarity search"),
-  indexType: zod.z.enum(["hnsw", "ivfflat", "flat"]).optional().describe("Vector index algorithm (HNSW for high accuracy, IVFFlat for large datasets)")
+var DashboardSchema = lazySchema(() => zod.z.object({
+  /** Machine name */
+  name: SnakeCaseIdentifierSchema.describe("Dashboard unique name"),
+  /** Display label */
+  label: I18nLabelSchema.describe("Dashboard label"),
+  /** Description */
+  description: I18nLabelSchema.optional().describe("Dashboard description"),
+  /** Structured header configuration */
+  header: DashboardHeaderSchema.optional().describe("Dashboard header configuration"),
+  /** Collection of widgets */
+  widgets: zod.z.array(DashboardWidgetSchema).describe("Widgets to display"),
+  /** Grid column count — defaults to 12 for a standard 12-column grid */
+  columns: zod.z.number().int().min(1).max(24).optional().describe("Number of grid columns (default 12)"),
+  /** Grid gap in Tailwind spacing units (e.g. 4 = 1rem) */
+  gap: zod.z.number().int().min(0).optional().describe("Grid gap in Tailwind spacing units"),
+  /** Auto-refresh */
+  refreshInterval: zod.z.number().optional().describe("Auto-refresh interval in seconds"),
+  /** Dashboard Date Range (Global time filter) */
+  dateRange: zod.z.object({
+    field: zod.z.string().optional().describe("Default date field name for time-based filtering"),
+    defaultRange: zod.z.enum(["today", "yesterday", "this_week", "last_week", "this_month", "last_month", "this_quarter", "last_quarter", "this_year", "last_year", "last_7_days", "last_30_days", "last_90_days", "custom"]).default("this_month").describe("Default date range preset"),
+    allowCustomRange: zod.z.boolean().default(true).describe("Allow users to pick a custom date range")
+  }).optional().describe("Global dashboard date range filter configuration"),
+  /** Global Filters */
+  globalFilters: zod.z.array(GlobalFilterSchema).optional().describe("Global filters that apply to all widgets in the dashboard"),
+  /** ARIA accessibility attributes */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes"),
+  /** Performance optimization settings */
+  performance: PerformanceConfigSchema.optional().describe("Performance optimization settings")
 }));
-var FileAttachmentConfigSchema = lazySchema(() => zod.z.object({
-  /** File Size Limits */
-  minSize: zod.z.number().min(0).optional().describe("Minimum file size in bytes"),
-  maxSize: zod.z.number().min(1).optional().describe("Maximum file size in bytes (e.g., 10485760 = 10MB)"),
-  /** File Type Restrictions */
-  allowedTypes: zod.z.array(zod.z.string()).optional().describe('Allowed file extensions (e.g., [".pdf", ".docx", ".jpg"])'),
-  blockedTypes: zod.z.array(zod.z.string()).optional().describe('Blocked file extensions (e.g., [".exe", ".bat", ".sh"])'),
-  allowedMimeTypes: zod.z.array(zod.z.string()).optional().describe('Allowed MIME types (e.g., ["image/jpeg", "application/pdf"])'),
-  blockedMimeTypes: zod.z.array(zod.z.string()).optional().describe("Blocked MIME types"),
-  /** Virus Scanning */
-  virusScan: zod.z.boolean().default(false).describe("Enable virus scanning for uploaded files"),
-  virusScanProvider: zod.z.enum(["clamav", "virustotal", "metadefender", "custom"]).optional().describe("Virus scanning service provider"),
-  virusScanOnUpload: zod.z.boolean().default(true).describe("Scan files immediately on upload"),
-  quarantineOnThreat: zod.z.boolean().default(true).describe("Quarantine files if threat detected"),
-  /** Storage Configuration */
-  storageProvider: zod.z.string().optional().describe("Object storage provider name (references ObjectStorageConfig)"),
-  storageBucket: zod.z.string().optional().describe("Target bucket name"),
-  storagePrefix: zod.z.string().optional().describe('Storage path prefix (e.g., "uploads/documents/")'),
-  /** Image-Specific Validation */
-  imageValidation: zod.z.object({
-    minWidth: zod.z.number().min(1).optional().describe("Minimum image width in pixels"),
-    maxWidth: zod.z.number().min(1).optional().describe("Maximum image width in pixels"),
-    minHeight: zod.z.number().min(1).optional().describe("Minimum image height in pixels"),
-    maxHeight: zod.z.number().min(1).optional().describe("Maximum image height in pixels"),
-    aspectRatio: zod.z.string().optional().describe('Required aspect ratio (e.g., "16:9", "1:1")'),
-    generateThumbnails: zod.z.boolean().default(false).describe("Auto-generate thumbnails"),
-    thumbnailSizes: zod.z.array(zod.z.object({
-      name: zod.z.string().describe('Thumbnail variant name (e.g., "small", "medium", "large")'),
-      width: zod.z.number().min(1).describe("Thumbnail width in pixels"),
-      height: zod.z.number().min(1).describe("Thumbnail height in pixels"),
-      crop: zod.z.boolean().default(false).describe("Crop to exact dimensions")
-    })).optional().describe("Thumbnail size configurations"),
-    preserveMetadata: zod.z.boolean().default(false).describe("Preserve EXIF metadata"),
-    autoRotate: zod.z.boolean().default(true).describe("Auto-rotate based on EXIF orientation")
-  }).optional().describe("Image-specific validation rules"),
-  /** Upload Behavior */
-  allowMultiple: zod.z.boolean().default(false).describe("Allow multiple file uploads (overrides field.multiple)"),
-  allowReplace: zod.z.boolean().default(true).describe("Allow replacing existing files"),
-  allowDelete: zod.z.boolean().default(true).describe("Allow deleting uploaded files"),
-  requireUpload: zod.z.boolean().default(false).describe("Require at least one file when field is required"),
-  /** Metadata Extraction */
-  extractMetadata: zod.z.boolean().default(true).describe("Extract file metadata (name, size, type, etc.)"),
-  extractText: zod.z.boolean().default(false).describe("Extract text content from documents (OCR/parsing)"),
-  /** Versioning */
-  versioningEnabled: zod.z.boolean().default(false).describe("Keep previous versions of replaced files"),
-  maxVersions: zod.z.number().min(1).optional().describe("Maximum number of versions to retain"),
-  /** Access Control */
-  publicRead: zod.z.boolean().default(false).describe("Allow public read access to uploaded files"),
-  presignedUrlExpiry: zod.z.number().min(60).max(604800).default(3600).describe("Presigned URL expiration in seconds (default: 1 hour)")
-}).refine((data) => {
-  if (data.minSize !== void 0 && data.maxSize !== void 0 && data.minSize > data.maxSize) {
-    return false;
-  }
-  return true;
-}, {
-  message: "minSize must be less than or equal to maxSize"
-}).refine((data) => {
-  if (data.virusScanProvider !== void 0 && data.virusScan !== true) {
-    return false;
-  }
-  return true;
-}, {
-  message: "virusScanProvider requires virusScan to be enabled"
+var Dashboard = {
+  create: (config) => DashboardSchema.parse(config)
+};
+var ReportType = zod.z.enum([
+  "tabular",
+  // Simple list
+  "summary",
+  // Grouped by row
+  "matrix",
+  // Grouped by row and column
+  "joined"
+  // Joined multiple blocks
+]);
+var ReportColumnSchema = lazySchema(() => zod.z.object({
+  field: zod.z.string().describe("Field name"),
+  label: I18nLabelSchema.optional().describe("Override label"),
+  aggregate: zod.z.enum(["sum", "avg", "max", "min", "count", "unique"]).optional().describe("Aggregation function"),
+  /** Responsive visibility/priority per breakpoint */
+  responsive: ResponsiveConfigSchema.optional().describe("Responsive visibility for this column")
 }));
-var DataQualityRulesSchema = lazySchema(() => zod.z.object({
-  /** Enforce uniqueness constraint */
-  uniqueness: zod.z.boolean().default(false).describe("Enforce unique values across all records"),
-  /** Completeness ratio (0-1) indicating minimum percentage of non-null values */
-  completeness: zod.z.number().min(0).max(1).default(0).describe("Minimum ratio of non-null values (0-1, default: 0 = no requirement)"),
-  /** Accuracy validation against authoritative source */
-  accuracy: zod.z.object({
-    source: zod.z.string().describe('Reference data source for validation (e.g., "api.verify.com", "master_data")'),
-    threshold: zod.z.number().min(0).max(1).describe("Minimum accuracy threshold (0-1, e.g., 0.95 = 95% match required)")
-  }).optional().describe("Accuracy validation configuration")
+var ReportGroupingSchema = lazySchema(() => zod.z.object({
+  field: zod.z.string().describe("Field to group by"),
+  sortOrder: zod.z.enum(["asc", "desc"]).default("asc"),
+  dateGranularity: zod.z.enum(["day", "week", "month", "quarter", "year"]).optional().describe("For date fields")
 }));
-var ComputedFieldCacheSchema = lazySchema(() => zod.z.object({
-  /** Enable caching for this computed field */
-  enabled: zod.z.boolean().describe("Enable caching for computed field results"),
-  /** Time-to-live in seconds */
-  ttl: zod.z.number().min(0).describe("Cache TTL in seconds (0 = no expiration)"),
-  /** Array of field paths that trigger cache invalidation when changed */
-  invalidateOn: zod.z.array(zod.z.string()).describe('Field paths that invalidate cache (e.g., ["inventory.quantity", "pricing.base_price"])')
+var ReportChartSchema = lazySchema(() => ChartConfigSchema.extend({
+  /** Report-specific chart configuration */
+  xAxis: zod.z.string().describe("Grouping field for X-Axis"),
+  yAxis: zod.z.string().describe("Summary field for Y-Axis"),
+  groupBy: zod.z.string().optional().describe("Additional grouping field")
 }));
-var FieldSchema = lazySchema(() => zod.z.object({
+var JoinedReportBlockSchema = lazySchema(() => zod.z.object({
+  /** Stable id for the block (used as react key, telemetry, deeplinks). */
+  name: SnakeCaseIdentifierSchema,
+  /** Human label shown above the block. Falls back to `name`. */
+  label: I18nLabelSchema.optional(),
+  /** Optional description rendered below the label. */
+  description: I18nLabelSchema.optional(),
+  /** Block report type — `joined` is intentionally excluded (no recursion). */
+  type: zod.z.enum(["tabular", "summary", "matrix"]).default("tabular"),
+  /** Object queried by this block. Defaults to the container's objectName. */
+  objectName: zod.z.string().optional(),
+  /** Columns to display / aggregate. Same shape as `Report.columns`. */
+  columns: zod.z.array(ReportColumnSchema),
+  /** Row groupings (same shape as `Report.groupingsDown`). */
+  groupingsDown: zod.z.array(ReportGroupingSchema).optional(),
+  /** Column groupings — only meaningful when `type: matrix`. */
+  groupingsAcross: zod.z.array(ReportGroupingSchema).optional(),
+  /** Block-specific filter, ANDed with the container filter at render time. */
+  filter: FilterConditionSchema.optional(),
+  /** Optional inline chart configuration. */
+  chart: ReportChartSchema.optional()
+}));
+var ReportSchema = lazySchema(() => zod.z.object({
   /** Identity */
-  name: zod.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe("Machine name (snake_case)").optional(),
-  label: zod.z.string().optional().describe("Human readable label"),
-  type: FieldType.describe("Field Data Type"),
-  description: zod.z.string().optional().describe("Tooltip/Help text"),
-  format: zod.z.string().optional().describe("Format string (e.g. email, phone)"),
-  /** Storage Layer Mapping */
-  columnName: zod.z.string().optional().describe("Physical column name in the target datasource. Defaults to the field key when not set."),
-  /** Database Constraints */
-  required: zod.z.boolean().default(false).describe("Is required"),
-  searchable: zod.z.boolean().default(false).describe("Is searchable"),
-  multiple: zod.z.boolean().default(false).describe("Allow multiple values (Stores as Array/JSON). Applicable for select, lookup, file, image."),
-  unique: zod.z.boolean().default(false).describe("Is unique constraint"),
-  defaultValue: zod.z.unknown().optional().describe("Default value"),
-  /** Text/String Constraints */
-  maxLength: zod.z.number().optional().describe("Max character length"),
-  minLength: zod.z.number().optional().describe("Min character length"),
-  /** Number Constraints */
-  precision: zod.z.number().optional().describe("Total digits"),
-  scale: zod.z.number().optional().describe("Decimal places"),
-  min: zod.z.number().optional().describe("Minimum value"),
-  max: zod.z.number().optional().describe("Maximum value"),
-  /** Selection Options */
-  options: zod.z.array(SelectOptionSchema).optional().describe("Static options for select/multiselect"),
+  name: SnakeCaseIdentifierSchema.describe("Report unique name"),
+  label: I18nLabelSchema.describe("Report label"),
+  description: I18nLabelSchema.optional(),
+  /** Data Source */
+  objectName: zod.z.string().describe("Primary object"),
+  /** Report Configuration */
+  type: ReportType.default("tabular").describe("Report format type"),
+  columns: zod.z.array(ReportColumnSchema).describe("Columns to display"),
+  /** Grouping (for Summary/Matrix) */
+  groupingsDown: zod.z.array(ReportGroupingSchema).optional().describe("Row groupings"),
+  groupingsAcross: zod.z.array(ReportGroupingSchema).optional().describe("Column groupings (Matrix only)"),
+  /** Filtering (MongoDB-style FilterCondition) */
+  filter: FilterConditionSchema.optional().describe("Filter criteria"),
+  /** Visualization */
+  chart: ReportChartSchema.optional().describe("Embedded chart configuration"),
+  /** ARIA accessibility attributes */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes"),
+  /** Performance optimization settings */
+  performance: PerformanceConfigSchema.optional().describe("Performance optimization settings"),
   /**
-   * Relationship Config
-   * 
-   * Used by `lookup` and `master_detail` field types to define cross-object references.
-   * The `reference` property is **required** for these types — it identifies the target
-   * object whose records this field links to. The engine uses `reference` during $expand
-   * post-processing to resolve foreign key IDs into full related objects via batch queries.
-   * 
-   * For `master_detail` fields, the parent record controls the lifecycle of child records
-   * (e.g., cascade delete). For `lookup` fields, the reference is a soft link.
+   * Joined report blocks — only meaningful when `type: 'joined'`.
+   *
+   * A joined report renders multiple independent sub-reports stacked
+   * vertically in the same view. Each block declares its own object,
+   * columns, groupings and filter. The container-level `filter` is ANDed
+   * into every block at query time so a top-level scope (e.g. "this
+   * quarter") flows down without per-block duplication.
+   *
+   * Renderers must ignore `blocks` when `type !== 'joined'`.
    */
-  reference: zod.z.string().optional().describe(
-    "Target object name (snake_case) for lookup/master_detail fields. Required for relationship types. Used by $expand to resolve foreign key IDs into full objects."
-  ),
-  referenceFilters: zod.z.array(zod.z.string()).optional().describe('Filters applied to lookup dialogs (e.g. "active = true")'),
-  writeRequiresMasterRead: zod.z.boolean().optional().describe("If true, user needs read access to master record to edit this field"),
-  deleteBehavior: zod.z.enum(["set_null", "cascade", "restrict"]).optional().default("set_null").describe("What happens if referenced record is deleted"),
-  /** Calculation — CEL formula. Plain string accepted for back-compat; build emits canonical envelope. */
-  expression: ExpressionInputSchema.optional().describe("Formula expression (CEL). e.g. F`record.amount * 0.1`"),
-  summaryOperations: zod.z.object({
-    object: zod.z.string().describe("Source child object name for roll-up"),
-    field: zod.z.string().describe("Field on child object to aggregate"),
-    function: zod.z.enum(["count", "sum", "min", "max", "avg"]).describe("Aggregation function to apply")
-  }).optional().describe("Roll-up summary definition"),
-  /** Enhanced Field Type Configurations */
-  // Code field config
-  language: zod.z.string().optional().describe("Programming language for syntax highlighting (e.g., javascript, python, sql)"),
-  theme: zod.z.string().optional().describe("Code editor theme (e.g., dark, light, monokai)"),
-  lineNumbers: zod.z.boolean().optional().describe("Show line numbers in code editor"),
-  // Rating field config
-  maxRating: zod.z.number().optional().describe("Maximum rating value (default: 5)"),
-  allowHalf: zod.z.boolean().optional().describe("Allow half-star ratings"),
-  // Location field config
-  displayMap: zod.z.boolean().optional().describe("Display map widget for location field"),
-  allowGeocoding: zod.z.boolean().optional().describe("Allow address-to-coordinate conversion"),
-  // Address field config
-  addressFormat: zod.z.enum(["us", "uk", "international"]).optional().describe("Address format template"),
-  // Color field config
-  colorFormat: zod.z.enum(["hex", "rgb", "rgba", "hsl"]).optional().describe("Color value format"),
-  allowAlpha: zod.z.boolean().optional().describe("Allow transparency/alpha channel"),
-  presetColors: zod.z.array(zod.z.string()).optional().describe("Preset color options"),
-  // Slider field config
-  step: zod.z.number().optional().describe("Step increment for slider (default: 1)"),
-  showValue: zod.z.boolean().optional().describe("Display current value on slider"),
-  marks: zod.z.record(zod.z.string(), zod.z.string()).optional().describe('Custom marks/labels at specific values (e.g., {0: "Low", 50: "Medium", 100: "High"})'),
-  // QR Code / Barcode field config
-  // Note: qrErrorCorrection is only applicable when barcodeFormat='qr'
-  // Runtime validation should enforce this constraint
-  barcodeFormat: zod.z.enum(["qr", "ean13", "ean8", "code128", "code39", "upca", "upce"]).optional().describe("Barcode format type"),
-  qrErrorCorrection: zod.z.enum(["L", "M", "Q", "H"]).optional().describe('QR code error correction level (L=7%, M=15%, Q=25%, H=30%). Only applicable when barcodeFormat is "qr"'),
-  displayValue: zod.z.boolean().optional().describe("Display human-readable value below barcode/QR code"),
-  allowScanning: zod.z.boolean().optional().describe("Enable camera scanning for barcode/QR code input"),
-  // Currency field config
-  currencyConfig: CurrencyConfigSchema.optional().describe("Configuration for currency field type"),
-  // Vector field config
-  vectorConfig: VectorConfigSchema.optional().describe("Configuration for vector field type (AI/ML embeddings)"),
-  // File attachment field config
-  fileAttachmentConfig: FileAttachmentConfigSchema.optional().describe("Configuration for file and attachment field types"),
-  /** Enhanced Security & Compliance */
-  // Encryption configuration
-  encryptionConfig: EncryptionConfigSchema.optional().describe("Field-level encryption configuration for sensitive data (GDPR/HIPAA/PCI-DSS)"),
-  // Data masking rules
-  maskingRule: MaskingRuleSchema.optional().describe("Data masking rules for PII protection"),
-  // Audit trail
-  auditTrail: zod.z.boolean().default(false).describe("Enable detailed audit trail for this field (tracks all changes with user and timestamp)"),
-  /** Field Dependencies & Relationships */
-  // Field dependencies
-  dependencies: zod.z.array(zod.z.string()).optional().describe("Array of field names that this field depends on (for formulas, visibility rules, etc.)"),
-  /** Computed Field Optimization */
-  // Computed field caching
-  cached: ComputedFieldCacheSchema.optional().describe("Caching configuration for computed/formula fields"),
-  /** Data Quality & Governance */
-  // Data quality rules
-  dataQuality: DataQualityRulesSchema.optional().describe("Data quality validation and monitoring rules"),
-  /** Layout & Grouping */
-  group: zod.z.string().optional().describe('Field group name for organizing fields in forms and layouts (e.g., "contact_info", "billing", "system")'),
-  /** Conditional Requirements */
-  conditionalRequired: ExpressionInputSchema.optional().describe("Predicate (CEL) \u2014 field is required when TRUE. e.g. P`record.status == 'closed_won'`"),
-  /** Security & Visibility */
-  hidden: zod.z.boolean().default(false).describe("Hidden from default UI"),
-  readonly: zod.z.boolean().default(false).describe("Read-only in UI"),
-  system: zod.z.boolean().optional().describe("Auto-injected system/audit field (e.g. created_at, updated_by, organization_id). Tools that surface system fields separately from author-declared business fields should branch on this flag."),
-  sortable: zod.z.boolean().optional().default(true).describe("Whether field is sortable in list views"),
-  inlineHelpText: zod.z.string().optional().describe("Help text displayed below the field in forms"),
-  trackFeedHistory: zod.z.boolean().optional().describe("Track field changes in Chatter/activity feed (Salesforce pattern)"),
-  caseSensitive: zod.z.boolean().optional().describe("Whether text comparisons are case-sensitive"),
-  autonumberFormat: zod.z.string().optional().describe('Auto-number display format pattern (e.g., "CASE-{0000}")'),
-  /** Indexing */
-  index: zod.z.boolean().default(false).describe("Create standard database index"),
-  externalId: zod.z.boolean().default(false).describe("Is external ID for upsert operations")
+  blocks: zod.z.array(JoinedReportBlockSchema).optional().describe("Sub-reports for type=joined")
 }));
+var Report = {
+  create: (config) => ReportSchema.parse(config)
+};
+
+// src/ui/report.form.ts
+var reportForm = defineForm({
+  schemaId: "report",
+  type: "simple",
+  sections: [
+    {
+      label: "Basics",
+      description: "Identity and data source.",
+      columns: 2,
+      fields: [
+        { field: "name", type: "text", colSpan: 1, required: true, helpText: "snake_case unique identifier" },
+        { field: "label", type: "text", colSpan: 1, required: true },
+        { field: "description", type: "textarea", colSpan: 2 },
+        { field: "objectName", widget: "ref:object", colSpan: 1, helpText: "Data source object" },
+        { field: "type", colSpan: 1, helpText: "Report type: tabular/summary/matrix/joined" }
+      ]
+    },
+    {
+      label: "Columns",
+      description: "Columns shown in the report output.",
+      fields: [
+        { field: "columns", type: "repeater", helpText: "Columns to display in the report" }
+      ]
+    },
+    {
+      label: "Groupings",
+      description: "How rows (and columns, for matrix reports) are grouped.",
+      fields: [
+        { field: "groupingsDown", type: "repeater", helpText: "Row grouping levels" },
+        // CEL visibility — only Matrix reports use column groupings.
+        { field: "groupingsAcross", type: "repeater", visibleOn: "data.type == 'matrix'", helpText: "Column grouping levels (matrix only)" }
+      ]
+    },
+    {
+      label: "Joined blocks",
+      description: "Additional blocks joined into a single report (joined reports only).",
+      visibleOn: "data.type == 'joined'",
+      fields: [
+        { field: "blocks", type: "repeater", helpText: "Join multiple objects (joined report only)" }
+      ]
+    },
+    {
+      label: "Filter & chart",
+      description: "Report-level filters and chart presentation.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "filter", type: "repeater", helpText: "Report-level filters" },
+        { field: "chart", type: "composite", helpText: "Chart config (type, legend, colors)" }
+      ]
+    },
+    {
+      label: "Advanced",
+      description: "Accessibility and performance tuning.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "aria", type: "composite", helpText: "Accessibility labels" },
+        { field: "performance", type: "composite", helpText: "Caching and optimization" }
+      ]
+    }
+  ]
+});
+
+// src/ui/view.form.ts
+var viewForm = defineForm({
+  schemaId: "view",
+  type: "simple",
+  sections: [
+    {
+      label: "Basics",
+      description: "Identity and primary surface.",
+      columns: 2,
+      fields: [
+        { field: "name", type: "text", required: true, colSpan: 1, helpText: "snake_case, unique per environment" },
+        { field: "label", type: "text", required: true, colSpan: 1 },
+        { field: "description", type: "textarea", colSpan: 2 },
+        { field: "type", required: true, colSpan: 1, helpText: "Primary view surface" },
+        { field: "data", widget: "json", colSpan: 2, helpText: 'Data source \u2014 e.g. {"provider":"object","object":"task"}' }
+      ]
+    },
+    {
+      label: "Columns & filters",
+      description: "What rows show and how users filter them.",
+      fields: [
+        { field: "columns", type: "repeater", required: true, helpText: "Columns to display (field names from selected object)" },
+        { field: "filter", type: "repeater", helpText: "Filter conditions" },
+        { field: "sort", type: "repeater", helpText: "Default sort order" },
+        { field: "searchableFields", widget: "string-tags", helpText: "Field names available for quick search" },
+        { field: "filterableFields", widget: "string-tags", helpText: "Field names available for filtering" }
+      ]
+    },
+    {
+      label: "Table options",
+      description: "Grid-only display options.",
+      visibleOn: "data.type == 'grid' || data.type == null",
+      collapsible: true,
+      collapsed: true,
+      columns: 2,
+      fields: [
+        { field: "resizable", colSpan: 1 },
+        { field: "striped", colSpan: 1 },
+        { field: "bordered", colSpan: 1 },
+        { field: "compactToolbar", colSpan: 1 },
+        { field: "rowHeight", colSpan: 1 },
+        { field: "selection", type: "composite", colSpan: 2 },
+        { field: "pagination", type: "composite", colSpan: 2 }
+      ]
+    },
+    {
+      label: "Kanban",
+      description: "Kanban-specific board configuration.",
+      visibleOn: "data.type == 'kanban'",
+      fields: [{ field: "kanban", type: "composite" }]
+    },
+    {
+      label: "Calendar",
+      description: "Calendar-specific configuration.",
+      visibleOn: "data.type == 'calendar'",
+      fields: [{ field: "calendar", type: "composite" }]
+    },
+    {
+      label: "Gantt",
+      description: "Gantt-specific configuration.",
+      visibleOn: "data.type == 'gantt'",
+      fields: [{ field: "gantt", type: "composite" }]
+    },
+    {
+      label: "Gallery",
+      description: "Gallery-specific configuration.",
+      visibleOn: "data.type == 'gallery'",
+      fields: [{ field: "gallery", type: "composite" }]
+    },
+    {
+      label: "Timeline",
+      description: "Timeline-specific configuration.",
+      visibleOn: "data.type == 'timeline'",
+      fields: [{ field: "timeline", type: "composite" }]
+    },
+    {
+      label: "Chart",
+      description: "Chart-specific configuration.",
+      visibleOn: "data.type == 'chart'",
+      fields: [{ field: "chart", type: "composite" }]
+    },
+    {
+      label: "Navigation & sharing",
+      description: "Where this view appears and who can see it.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "navigation", type: "composite" },
+        { field: "sharing", type: "composite" }
+      ]
+    }
+  ]
+});
+
+// src/ui/app.form.ts
+var appForm = defineForm({
+  schemaId: "app",
+  type: "simple",
+  sections: [
+    {
+      label: "Basics",
+      description: "App identity and activation.",
+      columns: 2,
+      fields: [
+        { field: "name", type: "text", required: true, colSpan: 1, helpText: "snake_case, unique" },
+        { field: "label", type: "text", required: true, colSpan: 1 },
+        { field: "description", type: "textarea", colSpan: 2 },
+        { field: "version", type: "text", colSpan: 1 },
+        { field: "icon", type: "text", colSpan: 1, helpText: 'Lucide icon name (e.g. "users", "briefcase")' },
+        { field: "active", type: "boolean", colSpan: 1 },
+        { field: "isDefault", type: "boolean", colSpan: 1, helpText: "Make this the default app for new users" }
+      ]
+    },
+    {
+      label: "Navigation",
+      description: "Sidebar items and area grouping.",
+      fields: [
+        { field: "navigation", type: "composite", helpText: "Nav tree \u2014 recursive structure" },
+        { field: "areas", type: "repeater", helpText: "Group items into collapsible areas" },
+        { field: "homePageId", type: "text", helpText: "Landing page when app opens" },
+        { field: "mobileNavigation", type: "composite", helpText: "Bottom tab bar config for mobile" }
+      ]
+    },
+    {
+      label: "Content",
+      description: "Objects and APIs this app uses.",
+      fields: [
+        { field: "objects", widget: "object-selector", multiple: true, helpText: "Object names this app exposes" },
+        { field: "apis", type: "composite", helpText: "API endpoint definitions" },
+        { field: "defaultAgent", type: "text", helpText: "AI agent for the ambient assistant button" }
+      ]
+    },
+    {
+      label: "Branding",
+      description: "Theme colors and logo.",
+      collapsible: true,
+      collapsed: true,
+      fields: [{ field: "branding", type: "composite", helpText: "Primary/secondary colors, logo, theme" }]
+    },
+    {
+      label: "Access & sharing",
+      description: "Who can access this app and how it can be embedded.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "requiredPermissions", widget: "string-tags", helpText: "Permissions needed to access this app" },
+        { field: "sharing", type: "composite", helpText: "Public/internal/restricted access control" },
+        { field: "embed", type: "composite", helpText: "iFrame embed configuration" },
+        { field: "aria", type: "composite", helpText: "Accessibility labels" }
+      ]
+    }
+  ]
+});
+
+// src/ui/dashboard.form.ts
+var dashboardForm = defineForm({
+  schemaId: "dashboard",
+  type: "simple",
+  sections: [
+    {
+      label: "Basics",
+      description: "Dashboard identity and description.",
+      columns: 2,
+      fields: [
+        { field: "name", type: "text", required: true, colSpan: 1, helpText: "snake_case unique identifier" },
+        { field: "label", type: "text", required: true, colSpan: 1, helpText: "Display name" },
+        { field: "description", type: "textarea", colSpan: 2 }
+      ]
+    },
+    {
+      label: "Layout",
+      description: "Grid sizing and refresh cadence.",
+      columns: 3,
+      fields: [
+        { field: "columns", type: "number", colSpan: 1, helpText: "Grid columns (default 12)" },
+        { field: "gap", type: "number", colSpan: 1, helpText: "Grid gap (Tailwind units)" },
+        { field: "refreshInterval", type: "number", colSpan: 1, helpText: "Auto-refresh (seconds)" },
+        { field: "header", type: "composite", colSpan: 3, helpText: "Dashboard header config (title, subtitle, actions)" }
+      ]
+    },
+    {
+      label: "Widgets",
+      description: "Cards and charts placed on the grid.",
+      fields: [
+        { field: "widgets", type: "repeater", required: true, helpText: "Dashboard widgets with position and sizing" }
+      ]
+    },
+    {
+      label: "Filters",
+      description: "Default and global filters applied across widgets.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "dateRange", type: "composite", helpText: "Default date range selector" },
+        { field: "globalFilters", type: "repeater", helpText: "Filters applied to all widgets" }
+      ]
+    },
+    {
+      label: "Advanced",
+      description: "Accessibility and performance tuning.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "aria", type: "composite", helpText: "Accessibility labels" },
+        { field: "performance", type: "composite", helpText: "Caching and optimization config" }
+      ]
+    }
+  ]
+});
+
+// src/ui/action.form.ts
+var actionForm = defineForm({
+  schemaId: "action",
+  type: "simple",
+  sections: [
+    {
+      label: "Basics",
+      description: "Action identity and presentation.",
+      columns: 2,
+      fields: [
+        { field: "name", required: true, colSpan: 1, helpText: "Unique identifier (snake_case)" },
+        { field: "label", required: true, colSpan: 1, helpText: "Button text shown to users" },
+        { field: "objectName", widget: "ref:object", colSpan: 1, helpText: "Object this action belongs to (optional)" },
+        { field: "icon", colSpan: 1, helpText: 'Lucide icon name (e.g., "check", "x-circle")' },
+        { field: "type", required: true, colSpan: 1, helpText: "What happens when clicked" },
+        { field: "variant", colSpan: 1, helpText: "Button style (primary=blue, danger=red, ghost=transparent)" }
+      ]
+    },
+    {
+      label: "Behavior",
+      description: "Configure what happens when the action is triggered.",
+      fields: [
+        { field: "target", visibleOn: "data.type != 'script'", helpText: "URL, flow name, or API endpoint to call" },
+        { field: "method", visibleOn: "data.type == 'api'", helpText: "HTTP method (GET, POST, PUT, DELETE)" },
+        { field: "body", widget: "code", visibleOn: "data.type == 'script'", helpText: "JavaScript code to execute" },
+        { field: "params", type: "repeater", helpText: "User input parameters (show form before executing)" },
+        { field: "confirmText", helpText: 'Confirmation message (e.g., "Are you sure?")' },
+        { field: "successMessage", helpText: "Success message after completion" },
+        { field: "refreshAfter", helpText: "Refresh the list/page after action completes" }
+      ]
+    },
+    {
+      label: "Placement",
+      description: "Where and when the action button appears.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "locations", type: "repeater", helpText: "Where to show this action (toolbar, row menu, etc.)" },
+        { field: "component", helpText: "How to render (button, icon, menu item)" },
+        { field: "visible", widget: "textarea", helpText: "CEL expression: show only when condition is true" },
+        { field: "disabled", widget: "textarea", helpText: "CEL expression: disable when condition is true" },
+        { field: "shortcut", helpText: 'Keyboard shortcut (e.g., "Ctrl+S", "Cmd+Enter")' }
+      ]
+    },
+    {
+      label: "Advanced",
+      description: "Bulk operations, AI exposure, and API request shape.",
+      collapsible: true,
+      collapsed: true,
+      columns: 2,
+      fields: [
+        { field: "bulkEnabled", colSpan: 1, helpText: "Allow applying to multiple selected records" },
+        { field: "aiExposed", colSpan: 1, helpText: "Allow AI agents to call this action" },
+        { field: "recordIdParam", visibleOn: "data.type == 'api'", colSpan: 1, helpText: "Body parameter name for record ID" },
+        { field: "recordIdField", visibleOn: "data.type == 'api' && data.recordIdParam", colSpan: 1, helpText: 'Field to use as record ID (default: "id")' },
+        { field: "bodyShape", visibleOn: "data.type == 'api'", colSpan: 2, helpText: "Request body structure (flat or nested)" }
+      ]
+    }
+  ]
+});
+
+// src/ui/page.form.ts
+var pageForm = defineForm({
+  schemaId: "page",
+  type: "simple",
+  sections: [
+    {
+      label: "Basics",
+      description: "Page identity and template.",
+      columns: 2,
+      fields: [
+        { field: "name", required: true, colSpan: 1, helpText: "Unique identifier (snake_case)" },
+        { field: "label", required: true, colSpan: 1, helpText: "Page title shown to users" },
+        { field: "icon", colSpan: 1, helpText: "Icon for navigation menu" },
+        { field: "type", colSpan: 1, helpText: "Page type (record, home, app, dashboard, etc.)" },
+        { field: "template", colSpan: 2, helpText: 'Layout template (e.g., "header-sidebar-main")' },
+        { field: "description", widget: "textarea", colSpan: 2, helpText: "Page description for navigation" }
+      ]
+    },
+    {
+      label: "Data Context",
+      description: "Record binding and page-local state.",
+      fields: [
+        { field: "object", widget: "ref:object", helpText: "Bound object (for Record pages)" },
+        { field: "variables", type: "repeater", helpText: "Local page state variables" }
+      ]
+    },
+    {
+      label: "Layout",
+      description: "Page regions and components placed within them.",
+      fields: [
+        { field: "regions", type: "repeater", required: true, helpText: "Layout regions (header, main, sidebar, footer) with components" }
+      ]
+    },
+    {
+      label: "Advanced",
+      description: "Activation, audience, and accessibility.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "isDefault", helpText: "Set as default page for this page type" },
+        { field: "kind", helpText: "Page override mode: full or slotted (for record pages)" },
+        { field: "assignedProfiles", widget: "string-tags", helpText: "Profiles that can access this page" },
+        { field: "aria", type: "composite", helpText: "Accessibility attributes (ARIA labels, roles)" }
+      ]
+    }
+  ]
+});
 var HookBodyCapability = zod.z.enum([
   "api.read",
   "api.write",
@@ -3717,6 +4165,7 @@ exports.ChartTypeSchema = ChartTypeSchema;
 exports.ColorPaletteSchema = ColorPaletteSchema;
 exports.ColumnSummarySchema = ColumnSummarySchema;
 exports.ComponentAnimationSchema = ComponentAnimationSchema;
+exports.ComponentNavItemSchema = ComponentNavItemSchema;
 exports.ComponentPropsMap = ComponentPropsMap;
 exports.ConflictResolutionSchema = ConflictResolutionSchema;
 exports.Dashboard = Dashboard;
@@ -3874,8 +4323,15 @@ exports.WidgetMeasureSchema = WidgetMeasureSchema;
 exports.WidgetPropertySchema = WidgetPropertySchema;
 exports.WidgetSourceSchema = WidgetSourceSchema;
 exports.ZIndexSchema = ZIndexSchema;
+exports.actionForm = actionForm;
+exports.appForm = appForm;
+exports.dashboardForm = dashboardForm;
 exports.defineApp = defineApp;
+exports.defineForm = defineForm;
 exports.definePortal = definePortal;
 exports.defineView = defineView;
+exports.pageForm = pageForm;
+exports.reportForm = reportForm;
+exports.viewForm = viewForm;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map