@objectstack/spec 3.0.6 → 3.0.8

package/dist/ui/index.mjs

@@ -244,6 +244,23 @@ var SnakeCaseIdentifierSchema = z.string().min(2, { message: "Identifier must be
 z.string().min(3, { message: "Event name must be at least 3 characters" }).regex(/^[a-z][a-z0-9_.]*$/, {
   message: 'Event name must be lowercase with dots for namespacing (e.g., "user.created", "order.paid")'
 }).describe("Event name (lowercase with dot notation for namespacing)");
+var SharingConfigSchema = z.object({
+  enabled: z.boolean().default(false).describe("Enable public sharing"),
+  publicLink: z.string().optional().describe("Generated public share URL"),
+  password: z.string().optional().describe("Password required to access shared link"),
+  allowedDomains: z.array(z.string()).optional().describe('Restrict access to specific email domains (e.g. ["example.com"])'),
+  expiresAt: z.string().optional().describe("Expiration date/time in ISO 8601 format"),
+  allowAnonymous: z.boolean().optional().default(false).describe("Allow access without authentication")
+});
+var EmbedConfigSchema = z.object({
+  enabled: z.boolean().default(false).describe("Enable iframe embedding"),
+  allowedOrigins: z.array(z.string()).optional().describe('Allowed iframe parent origins (e.g. ["https://example.com"])'),
+  width: z.string().optional().default("100%").describe("Embed width (CSS value)"),
+  height: z.string().optional().default("600px").describe("Embed height (CSS value)"),
+  showHeader: z.boolean().optional().default(true).describe("Show interface header in embed"),
+  showNavigation: z.boolean().optional().default(false).describe("Show navigation in embed"),
+  responsive: z.boolean().optional().default(true).describe("Enable responsive resizing")
+});
 
 // src/ui/app.zod.ts
 var BaseNavItemSchema = z.object({
@@ -253,12 +270,18 @@ var BaseNavItemSchema = z.object({
   label: I18nLabelSchema.describe("Display proper label"),
   /** Icon name (Lucide) */
   icon: z.string().optional().describe("Icon name"),
+  /** Sort order within the same level (lower numbers appear first) */
+  order: z.number().optional().describe("Sort order within the same level (lower = first)"),
+  /** Badge text or count displayed on the navigation item (e.g. "3", "New") */
+  badge: z.union([z.string(), z.number()]).optional().describe("Badge text or count displayed on the item"),
   /** 
    * Visibility condition. 
    * Formula expression returning boolean. 
    * e.g. "user.is_admin || user.department == 'sales'"
    */
-  visible: z.string().optional().describe("Visibility formula condition")
+  visible: z.string().optional().describe("Visibility formula condition"),
+  /** Permissions required to see/access this navigation item */
+  requiredPermissions: z.array(z.string()).optional().describe("Permissions required to access this item")
 });
 var ObjectNavItemSchema = BaseNavItemSchema.extend({
   type: z.literal("object"),
@@ -279,6 +302,17 @@ var UrlNavItemSchema = BaseNavItemSchema.extend({
   url: z.string().describe("Target external URL"),
   target: z.enum(["_self", "_blank"]).default("_self").describe("Link target window")
 });
+var ReportNavItemSchema = BaseNavItemSchema.extend({
+  type: z.literal("report"),
+  reportName: z.string().describe("Target report name")
+});
+var ActionNavItemSchema = BaseNavItemSchema.extend({
+  type: z.literal("action"),
+  actionDef: z.object({
+    actionName: z.string().describe("Action machine name to execute"),
+    params: z.record(z.string(), z.unknown()).optional().describe("Parameters passed to the action")
+  }).describe("Action definition to execute when clicked")
+});
 var GroupNavItemSchema = BaseNavItemSchema.extend({
   type: z.literal("group"),
   expanded: z.boolean().default(false).describe("Default expansion state in sidebar")
@@ -286,13 +320,14 @@ var GroupNavItemSchema = BaseNavItemSchema.extend({
 });
 var NavigationItemSchema = z.lazy(
   () => z.union([
-    // Object Item can now have children (Airtable style: Object -> Views)
     ObjectNavItemSchema.extend({
       children: z.array(NavigationItemSchema).optional().describe("Child navigation items (e.g. specific views)")
     }),
     DashboardNavItemSchema,
     PageNavItemSchema,
     UrlNavItemSchema,
+    ReportNavItemSchema,
+    ActionNavItemSchema,
     GroupNavItemSchema.extend({
       children: z.array(NavigationItemSchema).describe("Child navigation items")
     })
@@ -303,6 +338,27 @@ var AppBrandingSchema = z.object({
   logo: z.string().optional().describe("Custom logo URL for this app"),
   favicon: z.string().optional().describe("Custom favicon URL for this app")
 });
+var NavigationAreaSchema = z.object({
+  /** Unique area identifier */
+  id: SnakeCaseIdentifierSchema.describe("Unique area identifier (lowercase snake_case)"),
+  /** Display label */
+  label: I18nLabelSchema.describe("Area display label"),
+  /** Icon name (Lucide) */
+  icon: z.string().optional().describe("Area icon name"),
+  /** Sort order among areas (lower = first) */
+  order: z.number().optional().describe("Sort order among areas (lower = first)"),
+  /** Area description */
+  description: I18nLabelSchema.optional().describe("Area description"),
+  /** 
+   * Visibility condition.
+   * Formula expression returning boolean.
+   */
+  visible: z.string().optional().describe("Visibility formula condition for this area"),
+  /** Permissions required to access this area */
+  requiredPermissions: z.array(z.string()).optional().describe("Permissions required to access this area"),
+  /** Navigation items within this area */
+  navigation: z.array(NavigationItemSchema).describe("Navigation items within this area")
+});
 var AppSchema = z.object({
   /** Machine name (id) */
   name: SnakeCaseIdentifierSchema.describe("App unique machine name (lowercase snake_case)"),
@@ -321,10 +377,28 @@ var AppSchema = z.object({
   /** Is this the default app for new users? */
   isDefault: z.boolean().optional().default(false).describe("Is default app"),
   /** 
-   * Navigation Tree Structure.
-   * Replaces the old flat 'tabs' list with a structured menu.
+   * Full Navigation Tree — supports unlimited nesting depth.
+   * Pages are referenced by name via `type: 'page'` items.
+   * Groups can contain other groups for arbitrary sidebar depth.
+   * 
+   * For simple apps, use `navigation` directly.
+   * For enterprise apps with multiple business domains, use `areas` instead.
+   */
+  navigation: z.array(NavigationItemSchema).optional().describe("Full navigation tree for the app sidebar"),
+  /**
+   * Navigation Areas — partitions navigation by business domain.
+   * Each area defines an independent navigation tree (e.g. Sales, Service, Settings).
+   * When areas are defined, they take precedence over the top-level `navigation` array.
+   * 
+   * @example
+   * ```ts
+   * areas: [
+   *   { id: 'area_sales', label: 'Sales', icon: 'briefcase', order: 1, navigation: [...] },
+   *   { id: 'area_service', label: 'Service', icon: 'headset', order: 2, navigation: [...] },
+   * ]
+   * ```
    */
-  navigation: z.array(NavigationItemSchema).optional().describe("Structured navigation menu tree"),
+  areas: z.array(NavigationAreaSchema).optional().describe("Navigation areas for partitioning navigation by business domain"),
   /** 
    * App-level Home Page Override
    * ID of the navigation item to act as the landing page.
@@ -344,6 +418,10 @@ var AppSchema = z.object({
    */
   objects: z.array(z.unknown()).optional().describe("Objects belonging to this app"),
   apis: z.array(z.unknown()).optional().describe("Custom APIs belonging to this app"),
+  /** Sharing configuration for public access */
+  sharing: SharingConfigSchema.optional().describe("Public sharing configuration"),
+  /** Embed configuration for iframe embedding */
+  embed: EmbedConfigSchema.optional().describe("Iframe embedding configuration"),
   /** Mobile navigation mode */
   mobileNavigation: z.object({
     mode: z.enum(["drawer", "bottom_nav", "hamburger"]).default("drawer").describe("Mobile navigation mode: drawer sidebar, bottom navigation bar, or hamburger menu"),
@@ -462,6 +540,44 @@ var RowColorConfigSchema = z.object({
   field: z.string().describe("Field to derive color from (typically a select/status field)"),
   colors: z.record(z.string(), z.string()).optional().describe("Map of field value to color (hex/token)")
 }).describe("Row color configuration based on field values");
+var VisualizationTypeSchema = z.enum([
+  "grid",
+  "kanban",
+  "gallery",
+  "calendar",
+  "timeline",
+  "gantt",
+  "map"
+]).describe("Visualization type that users can switch to");
+var UserActionsConfigSchema = z.object({
+  sort: z.boolean().default(true).describe("Allow users to sort records"),
+  search: z.boolean().default(true).describe("Allow users to search records"),
+  filter: z.boolean().default(true).describe("Allow users to filter records"),
+  rowHeight: z.boolean().default(true).describe("Allow users to toggle row height/density"),
+  addRecordForm: z.boolean().default(false).describe("Add records through a form instead of inline"),
+  buttons: z.array(z.string()).optional().describe("Custom action button IDs to show in the toolbar")
+}).describe("User action toggles for the view toolbar");
+var AppearanceConfigSchema = z.object({
+  showDescription: z.boolean().default(true).describe("Show the view description text"),
+  allowedVisualizations: 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 = z.object({
+  name: SnakeCaseIdentifierSchema.describe("Tab identifier (snake_case)"),
+  label: I18nLabelSchema.optional().describe("Display label"),
+  icon: z.string().optional().describe("Tab icon name"),
+  view: z.string().optional().describe("Referenced list view name from listViews"),
+  filter: z.array(z.unknown()).optional().describe("Tab-specific filter criteria"),
+  order: z.number().int().min(0).optional().describe("Tab display order"),
+  pinned: z.boolean().default(false).describe("Pin tab (cannot be removed by users)"),
+  isDefault: z.boolean().default(false).describe("Set as the default active tab"),
+  visible: z.boolean().default(true).describe("Tab visibility")
+}).describe("Tab configuration for multi-tab view interface");
+var AddRecordConfigSchema = z.object({
+  enabled: z.boolean().default(true).describe("Show the add record entry point"),
+  position: z.enum(["top", "bottom", "both"]).default("bottom").describe("Position of the add record button"),
+  mode: z.enum(["inline", "form", "modal"]).default("inline").describe("How to add a new record"),
+  formView: z.string().optional().describe('Named form view to use when mode is "form" or "modal"')
+}).describe("Add record entry point configuration");
 var KanbanConfigSchema = z.object({
   groupByField: z.string().describe("Field to group columns by (usually status/select)"),
   summarizeField: z.string().optional().describe("Field to sum at top of column (e.g. amount)"),
@@ -596,6 +712,18 @@ var ListViewSchema = z.object({
   inlineEdit: z.boolean().optional().describe("Allow inline editing of records directly in the list view"),
   /** Export */
   exportOptions: z.array(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: 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: z.boolean().optional().describe("Show record count at the bottom of the list"),
+  /** Advanced: Allow Printing (Airtable Interface parity) */
+  allowPrinting: z.boolean().optional().describe("Allow users to print the view"),
   /** Empty State */
   emptyState: z.object({
     title: I18nLabelSchema.optional(),
@@ -656,6 +784,8 @@ var FormViewSchema = z.object({
     field: z.string().describe("Field name to sort by"),
     order: 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"),
   /** ARIA accessibility attributes */
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes for the form view")
 });
@@ -776,13 +906,66 @@ var NormalizedFilterSchema = z.lazy(
 );
 
 // src/ui/dashboard.zod.ts
+var WidgetColorVariantSchema = z.enum([
+  "default",
+  "blue",
+  "teal",
+  "orange",
+  "purple",
+  "success",
+  "warning",
+  "danger"
+]).describe("Widget color variant");
+var WidgetActionTypeSchema = z.enum([
+  "url",
+  "modal",
+  "flow"
+]).describe("Widget action type");
+var DashboardHeaderActionSchema = z.object({
+  /** Action label */
+  label: I18nLabelSchema.describe("Action button label"),
+  /** Action URL or target */
+  actionUrl: z.string().describe("URL or target for the action"),
+  /** Action type */
+  actionType: WidgetActionTypeSchema.optional().describe("Type of action"),
+  /** Icon identifier */
+  icon: z.string().optional().describe("Icon identifier for the action button")
+}).describe("Dashboard header action");
+var DashboardHeaderSchema = z.object({
+  /** Whether to show the dashboard title in the header */
+  showTitle: z.boolean().default(true).describe("Show dashboard title in header"),
+  /** Whether to show the dashboard description in the header */
+  showDescription: z.boolean().default(true).describe("Show dashboard description in header"),
+  /** Action buttons displayed in the header */
+  actions: z.array(DashboardHeaderActionSchema).optional().describe("Header action buttons")
+}).describe("Dashboard header configuration");
+var WidgetMeasureSchema = z.object({
+  /** Value field to aggregate */
+  valueField: z.string().describe("Field to aggregate"),
+  /** Aggregate function */
+  aggregate: 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: z.string().optional().describe("Number format string")
+}).describe("Widget measure definition");
 var DashboardWidgetSchema = z.object({
   /** 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"),
+  /** Action URL for the widget header action button */
+  actionUrl: 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: z.string().optional().describe("Icon identifier for the widget action button"),
   /** Data Source Object */
   object: z.string().optional().describe("Data source object name"),
   /** Data Filter (MongoDB-style FilterCondition) */
@@ -793,6 +976,8 @@ var DashboardWidgetSchema = z.object({
   valueField: z.string().optional().describe("Field for values (Y-Axis)"),
   /** Aggregate operation */
   aggregate: z.enum(["count", "sum", "avg", "min", "max"]).optional().default("count").describe("Aggregate function"),
+  /** Multi-measure definitions for pivot/matrix widgets */
+  measures: z.array(WidgetMeasureSchema).optional().describe("Multiple measures for pivot/matrix analysis"),
   /** 
    * Layout Position (React-Grid-Layout style)
    * x: column (0-11)
@@ -813,6 +998,37 @@ var DashboardWidgetSchema = z.object({
   /** ARIA accessibility attributes */
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
+var GlobalFilterOptionsFromSchema = z.object({
+  /** Source object name to fetch options from */
+  object: z.string().describe("Source object name"),
+  /** Field to use as option value */
+  valueField: z.string().describe("Field to use as option value"),
+  /** Field to use as option label */
+  labelField: 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 = z.object({
+  /** Field name to filter on */
+  field: 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: z.enum(["text", "select", "date", "number", "lookup"]).optional().describe("Filter input type"),
+  /** Static options for select/lookup filters */
+  options: z.array(z.object({
+    value: z.any(),
+    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: z.any().optional().describe("Default filter value"),
+  /** Filter application scope */
+  scope: z.enum(["dashboard", "widget"]).default("dashboard").describe("Filter application scope"),
+  /** Widget IDs to apply this filter to (when scope is widget) */
+  targetWidgets: z.array(z.string()).optional().describe("Widget IDs to apply this filter to")
+});
 var DashboardSchema = z.object({
   /** Machine name */
   name: SnakeCaseIdentifierSchema.describe("Dashboard unique name"),
@@ -820,6 +1036,8 @@ var DashboardSchema = z.object({
   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: z.array(DashboardWidgetSchema).describe("Widgets to display"),
   /** Auto-refresh */
@@ -831,11 +1049,7 @@ var DashboardSchema = z.object({
     allowCustomRange: z.boolean().default(true).describe("Allow users to pick a custom date range")
   }).optional().describe("Global dashboard date range filter configuration"),
   /** Global Filters */
-  globalFilters: z.array(z.object({
-    field: z.string().describe("Field name to filter on"),
-    label: I18nLabelSchema.optional().describe("Display label for the filter"),
-    type: z.enum(["text", "select", "date", "number"]).optional().describe("Filter input type")
-  })).optional().describe("Global filters that apply to all widgets in the dashboard"),
+  globalFilters: 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 */
@@ -1167,6 +1381,8 @@ var FieldSchema = z.object({
   type: FieldType.describe("Field Data Type"),
   description: z.string().optional().describe("Tooltip/Help text"),
   format: z.string().optional().describe("Format string (e.g. email, phone)"),
+  /** Storage Layer Mapping */
+  columnName: z.string().optional().describe("Physical column name in the target datasource. Defaults to the field key when not set."),
   /** Database Constraints */
   required: z.boolean().default(false).describe("Is required"),
   searchable: z.boolean().default(false).describe("Is searchable"),
@@ -1330,6 +1546,39 @@ var ActionSchema = z.object({
 var Action = {
   create: (config) => ActionSchema.parse(config)
 };
+z.enum([
+  "count",
+  "sum",
+  "avg",
+  "min",
+  "max",
+  "count_distinct",
+  "percentile",
+  "median",
+  "stddev",
+  "variance"
+]).describe("Standard aggregation functions");
+var SortDirectionEnum = z.enum(["asc", "desc"]).describe("Sort order direction");
+var SortItemSchema = z.object({
+  field: z.string().describe("Field name to sort by"),
+  order: SortDirectionEnum.describe("Sort direction")
+}).describe("Sort field and direction pair");
+z.enum([
+  "insert",
+  "update",
+  "delete",
+  "upsert"
+]).describe("Data mutation event types");
+z.enum([
+  "read_uncommitted",
+  "read_committed",
+  "repeatable_read",
+  "serializable",
+  "snapshot"
+]).describe("Transaction isolation levels (snake_case standard)");
+z.enum(["lru", "lfu", "ttl", "fifo"]).describe("Cache eviction strategy");
+
+// src/ui/page.zod.ts
 var PageRegionSchema = z.object({
   name: z.string().describe('Region name (e.g. "sidebar", "main", "header")'),
   width: z.enum(["small", "medium", "large", "full"]).optional(),
@@ -1361,8 +1610,25 @@ var PageComponentType = z.enum([
   "user:profile",
   // AI
   "ai:chat_window",
-  "ai:suggestion"
+  "ai:suggestion",
+  // Content Elements (Airtable Interface parity)
+  "element:text",
+  "element:number",
+  "element:image",
+  "element:divider",
+  // Interactive Elements (Phase B — Element Library)
+  "element:button",
+  "element:filter",
+  "element:form",
+  "element:record_picker"
 ]);
+var ElementDataSourceSchema = z.object({
+  object: z.string().describe("Object to query"),
+  view: z.string().optional().describe("Named view to apply"),
+  filter: z.any().optional().describe("Additional filter criteria"),
+  sort: z.array(SortItemSchema).optional().describe("Sort order"),
+  limit: z.number().int().positive().optional().describe("Max records to display")
+});
 var PageComponentSchema = z.object({
   /** Definition */
   type: z.union([
@@ -1385,6 +1651,8 @@ var PageComponentSchema = z.object({
   className: z.string().optional().describe("CSS class names"),
   /** Visibility Rule */
   visibility: z.string().optional().describe("Visibility filter/formula"),
+  /** Per-element data binding, overrides page-level object context */
+  dataSource: ElementDataSourceSchema.optional().describe("Per-element data binding for multi-object pages"),
   /** Responsive layout overrides per breakpoint */
   responsive: ResponsiveConfigSchema.optional().describe("Responsive layout configuration"),
   /** ARIA accessibility attributes */
@@ -1392,19 +1660,112 @@ var PageComponentSchema = z.object({
 });
 var PageVariableSchema = z.object({
   name: z.string().describe("Variable name"),
-  type: z.enum(["string", "number", "boolean", "object", "array"]).default("string"),
-  defaultValue: z.unknown().optional()
-});
+  type: z.enum(["string", "number", "boolean", "object", "array", "record_id"]).default("string"),
+  defaultValue: z.unknown().optional(),
+  /** Source element binding (e.g. element:record_picker writes to this variable) */
+  source: z.string().optional().describe("Component ID that writes to this variable")
+});
+var BlankPageLayoutItemSchema = z.object({
+  componentId: z.string().describe("Reference to a PageComponent.id in the page"),
+  x: z.number().int().min(0).describe("Grid column position (0-based)"),
+  y: z.number().int().min(0).describe("Grid row position (0-based)"),
+  width: z.number().int().min(1).describe("Width in grid columns"),
+  height: z.number().int().min(1).describe("Height in grid rows")
+});
+var BlankPageLayoutSchema = z.object({
+  columns: z.number().int().min(1).default(12).describe("Number of grid columns"),
+  rowHeight: z.number().int().min(1).default(40).describe("Height of each grid row in pixels"),
+  gap: z.number().int().min(0).default(8).describe("Gap between grid items in pixels"),
+  items: z.array(BlankPageLayoutItemSchema).describe("Positioned components on the canvas")
+});
+var PageTypeSchema = z.enum([
+  // Platform page types (Salesforce FlexiPage style)
+  "record",
+  // Component-based record layout page with regions
+  "home",
+  // Platform-level home/landing page
+  "app",
+  // App-level page with navigation context
+  "utility",
+  // Floating utility panel (e.g. notes, phone dialer)
+  // Interface page types (Airtable Interface parity)
+  "dashboard",
+  // KPI summary with charts/metrics
+  "grid",
+  // Spreadsheet-like data table
+  "list",
+  // Record list with quick actions
+  "gallery",
+  // Card-based visual browsing
+  "kanban",
+  // Status-based board
+  "calendar",
+  // Date-based scheduling
+  "timeline",
+  // Gantt-like project timeline
+  "form",
+  // Data entry form
+  "record_detail",
+  // Auto-generated single record field display
+  "record_review",
+  // Sequential record review/approval
+  "overview",
+  // Interface-level navigation/landing hub
+  "blank"
+  // Free-form canvas for custom composition
+]).describe("Page type \u2014 platform or interface page types");
+var RecordReviewConfigSchema = z.object({
+  object: z.string().describe("Target object for review"),
+  filter: z.any().optional().describe("Filter criteria for review queue"),
+  sort: z.array(SortItemSchema).optional().describe("Sort order for review queue"),
+  displayFields: z.array(z.string()).optional().describe("Fields to display on the review page"),
+  actions: z.array(z.object({
+    label: z.string().describe("Action button label"),
+    type: z.enum(["approve", "reject", "skip", "custom"]).describe("Action type"),
+    field: z.string().optional().describe("Field to update on action"),
+    value: z.any().optional().describe("Value to set on action"),
+    nextRecord: z.boolean().optional().default(true).describe("Auto-advance to next record after action")
+  })).describe("Review actions"),
+  navigation: z.enum(["sequential", "random", "filtered"]).optional().default("sequential").describe("Record navigation mode"),
+  showProgress: z.boolean().optional().default(true).describe("Show review progress indicator")
+});
+var InterfacePageConfigSchema = z.object({
+  /** Data binding */
+  source: z.string().optional().describe("Source object name for the page"),
+  levels: z.number().int().min(1).optional().describe("Number of hierarchy levels to display"),
+  filterBy: z.array(z.unknown()).optional().describe("Page-level filter criteria"),
+  /** Appearance */
+  appearance: AppearanceConfigSchema.optional().describe("Appearance and visualization configuration"),
+  /** User filters */
+  userFilters: z.object({
+    elements: z.array(z.enum(["grid", "gallery", "kanban"])).optional().describe("Visualization element types available in user filter bar"),
+    tabs: z.array(ViewTabSchema).optional().describe("User-configurable tabs")
+  }).optional().describe("User filter configuration"),
+  /** User actions */
+  userActions: UserActionsConfigSchema.optional().describe("User action toggles"),
+  /** Add record */
+  addRecord: AddRecordConfigSchema.optional().describe("Add record entry point configuration"),
+  /** Record count */
+  showRecordCount: z.boolean().optional().describe("Show record count at page bottom"),
+  /** Advanced */
+  allowPrinting: z.boolean().optional().describe("Allow users to print the page")
+}).describe("Interface-level page configuration (Airtable parity)");
 var PageSchema = z.object({
   name: SnakeCaseIdentifierSchema.describe("Page unique name (lowercase snake_case)"),
   label: I18nLabelSchema,
   description: I18nLabelSchema.optional(),
+  /** Icon (used in interface navigation) */
+  icon: z.string().optional().describe("Page icon name"),
   /** Page Type */
-  type: z.enum(["record", "home", "app", "utility"]).default("record"),
+  type: PageTypeSchema.default("record").describe("Page type"),
   /** Page State Definitions */
   variables: z.array(PageVariableSchema).optional().describe("Local page state variables"),
   /** Context */
   object: z.string().optional().describe("Bound object (for Record pages)"),
+  /** Record Review Configuration (only for record_review pages) */
+  recordReview: RecordReviewConfigSchema.optional().describe('Record review configuration (required when type is "record_review")'),
+  /** Blank Page Layout (only for blank pages) */
+  blankLayout: BlankPageLayoutSchema.optional().describe('Free-form grid layout for blank pages (used when type is "blank")'),
   /** Layout Template */
   template: z.string().default("default").describe('Layout template name (e.g. "header-sidebar-main")'),
   /** Regions & Content */
@@ -1412,6 +1773,8 @@ var PageSchema = z.object({
   /** Activation */
   isDefault: z.boolean().default(false),
   assignedProfiles: z.array(z.string()).optional(),
+  /** Interface Page Configuration (Airtable Interface parity) */
+  interfaceConfig: InterfacePageConfigSchema.optional().describe("Interface-level page configuration (for Airtable-style interface pages)"),
   /** ARIA accessibility attributes */
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
@@ -1686,6 +2049,86 @@ var FieldWidgetPropsSchema = z.object({
    */
   options: z.record(z.string(), z.unknown()).optional().describe("Custom widget options")
 });
+var FeedItemType = z.enum([
+  "comment",
+  "field_change",
+  "task",
+  "event",
+  "email",
+  "call",
+  "note",
+  "file",
+  "record_create",
+  "record_delete",
+  "approval",
+  "sharing",
+  "system"
+]);
+var MentionSchema = z.object({
+  type: z.enum(["user", "team", "record"]).describe("Mention target type"),
+  id: z.string().describe("Target ID"),
+  name: z.string().describe("Display name for rendering"),
+  offset: z.number().int().min(0).describe("Character offset in body text"),
+  length: z.number().int().min(1).describe("Length of mention token in body text")
+});
+var FieldChangeEntrySchema = z.object({
+  field: z.string().describe("Field machine name"),
+  fieldLabel: z.string().optional().describe("Field display label"),
+  oldValue: z.unknown().optional().describe("Previous value"),
+  newValue: z.unknown().optional().describe("New value"),
+  oldDisplayValue: z.string().optional().describe("Human-readable old value"),
+  newDisplayValue: z.string().optional().describe("Human-readable new value")
+});
+var ReactionSchema = z.object({
+  emoji: z.string().describe('Emoji character or shortcode (e.g., "\u{1F44D}", ":thumbsup:")'),
+  userIds: z.array(z.string()).describe("Users who reacted"),
+  count: z.number().int().min(1).describe("Total reaction count")
+});
+var FeedActorSchema = z.object({
+  type: z.enum(["user", "system", "service", "automation"]).describe("Actor type"),
+  id: z.string().describe("Actor ID"),
+  name: z.string().optional().describe("Actor display name"),
+  avatarUrl: z.string().url().optional().describe("Actor avatar URL"),
+  source: z.string().optional().describe('Source application (e.g., "Omni", "API", "Studio")')
+});
+var FeedVisibility = z.enum(["public", "internal", "private"]);
+z.object({
+  /** Unique identifier */
+  id: z.string().describe("Feed item ID"),
+  /** Feed item type */
+  type: FeedItemType.describe("Activity type"),
+  /** Target record reference */
+  object: z.string().describe('Object name (e.g., "account")'),
+  recordId: z.string().describe("Record ID this feed item belongs to"),
+  /** Actor (who performed the action) */
+  actor: FeedActorSchema.describe("Who performed this action"),
+  /** Content (for comments/notes) */
+  body: z.string().optional().describe("Rich text body (Markdown supported)"),
+  /** @Mentions */
+  mentions: z.array(MentionSchema).optional().describe("Mentioned users/teams/records"),
+  /** Field changes (for field_change type) */
+  changes: z.array(FieldChangeEntrySchema).optional().describe("Field-level changes"),
+  /** Reactions */
+  reactions: z.array(ReactionSchema).optional().describe("Emoji reactions on this item"),
+  /** Reply threading */
+  parentId: z.string().optional().describe("Parent feed item ID for threaded replies"),
+  replyCount: z.number().int().min(0).default(0).describe("Number of replies"),
+  /** Visibility */
+  visibility: FeedVisibility.default("public").describe("Visibility: public (all users), internal (team only), private (author + mentioned)"),
+  /** Timestamps */
+  createdAt: z.string().datetime().describe("Creation timestamp"),
+  updatedAt: z.string().datetime().optional().describe("Last update timestamp"),
+  editedAt: z.string().datetime().optional().describe("When comment was last edited"),
+  isEdited: z.boolean().default(false).describe("Whether comment has been edited")
+});
+var FeedFilterMode = z.enum([
+  "all",
+  "comments_only",
+  "changes_only",
+  "tasks_only"
+]);
+
+// src/ui/component.zod.ts
 var EmptyProps = z.object({});
 var PageHeaderProps = z.object({
   title: I18nLabelSchema.describe("Page title"),
@@ -1752,9 +2195,42 @@ var RecordHighlightsProps = z.object({
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
 var RecordActivityProps = z.object({
-  types: z.array(z.enum(["task", "event", "email", "call", "note"])).optional().describe("Activity types to display"),
-  limit: z.number().int().positive().default(10).describe("Number of activities to show"),
+  /** Activity types to display (unified enum including comment, field_change, etc.) */
+  types: z.array(FeedItemType).optional().describe("Feed item types to show (default: all)"),
+  /** Default filter mode (Airtable-style dropdown) */
+  filterMode: FeedFilterMode.default("all").describe("Default activity filter"),
+  /** Allow user to switch filter modes */
+  showFilterToggle: z.boolean().default(true).describe("Show filter dropdown in panel header"),
+  /** Pagination */
+  limit: z.number().int().positive().default(20).describe("Number of items to load per page"),
+  /** Show completed activities */
   showCompleted: z.boolean().default(false).describe("Include completed activities"),
+  /** Merge field_change + comment in a unified timeline */
+  unifiedTimeline: z.boolean().default(true).describe("Mix field changes and comments in one timeline (Airtable style)"),
+  /** Show the comment input box at the bottom */
+  showCommentInput: z.boolean().default(true).describe('Show "Leave a comment" input at the bottom'),
+  /** Enable @mentions in comments */
+  enableMentions: z.boolean().default(true).describe("Enable @mentions in comments"),
+  /** Enable emoji reactions */
+  enableReactions: z.boolean().default(false).describe("Enable emoji reactions on feed items"),
+  /** Enable threaded replies */
+  enableThreading: z.boolean().default(false).describe("Enable threaded replies on comments"),
+  /** Show notification subscription toggle (bell icon) */
+  showSubscriptionToggle: z.boolean().default(true).describe("Show bell icon for record-level notification subscription"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var RecordChatterProps = z.object({
+  /** Panel position */
+  position: z.enum(["sidebar", "inline", "drawer"]).default("sidebar").describe("Where to render the chatter panel"),
+  /** Panel width (for sidebar/drawer) */
+  width: z.union([z.string(), z.number()]).optional().describe('Panel width (e.g., "350px", "30%")'),
+  /** Collapsible */
+  collapsible: z.boolean().default(true).describe("Whether the panel can be collapsed"),
+  /** Default collapsed state */
+  defaultCollapsed: z.boolean().default(false).describe("Whether the panel starts collapsed"),
+  /** Feed configuration (delegates to RecordActivityProps) */
+  feed: RecordActivityProps.optional().describe("Embedded activity feed configuration"),
   /** ARIA accessibility */
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
@@ -1785,6 +2261,71 @@ var AIChatWindowProps = z.object({
   /** ARIA accessibility */
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
+var ElementTextPropsSchema = z.object({
+  content: z.string().describe("Text or Markdown content"),
+  variant: z.enum(["heading", "subheading", "body", "caption"]).optional().default("body").describe("Text style variant"),
+  align: z.enum(["left", "center", "right"]).optional().default("left").describe("Text alignment"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var ElementNumberPropsSchema = z.object({
+  object: z.string().describe("Source object"),
+  field: z.string().optional().describe("Field to aggregate"),
+  aggregate: z.enum(["count", "sum", "avg", "min", "max"]).describe("Aggregation function"),
+  filter: z.any().optional().describe("Filter criteria"),
+  format: z.enum(["number", "currency", "percent"]).optional().describe("Number display format"),
+  prefix: z.string().optional().describe('Prefix text (e.g. "$")'),
+  suffix: z.string().optional().describe('Suffix text (e.g. "%")'),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var ElementImagePropsSchema = z.object({
+  src: z.string().describe("Image URL or attachment field"),
+  alt: z.string().optional().describe("Alt text for accessibility"),
+  fit: z.enum(["cover", "contain", "fill"]).optional().default("cover").describe("Image object-fit mode"),
+  height: z.number().optional().describe("Fixed height in pixels"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var ElementButtonPropsSchema = z.object({
+  label: I18nLabelSchema.describe("Button display label"),
+  variant: z.enum(["primary", "secondary", "danger", "ghost", "link"]).optional().default("primary").describe("Button visual variant"),
+  size: z.enum(["small", "medium", "large"]).optional().default("medium").describe("Button size"),
+  icon: z.string().optional().describe("Icon name (Lucide icon)"),
+  iconPosition: z.enum(["left", "right"]).optional().default("left").describe("Icon position relative to label"),
+  disabled: z.boolean().optional().default(false).describe("Disable the button"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var ElementFilterPropsSchema = z.object({
+  object: z.string().describe("Object to filter"),
+  fields: z.array(z.string()).describe("Filterable field names"),
+  targetVariable: z.string().optional().describe("Page variable to store filter state"),
+  layout: z.enum(["inline", "dropdown", "sidebar"]).optional().default("inline").describe("Filter display layout"),
+  showSearch: z.boolean().optional().default(true).describe("Show search input"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var ElementFormPropsSchema = z.object({
+  object: z.string().describe("Object for the form"),
+  fields: z.array(z.string()).optional().describe("Fields to display (defaults to all editable fields)"),
+  mode: z.enum(["create", "edit"]).optional().default("create").describe("Form mode"),
+  submitLabel: I18nLabelSchema.optional().describe("Submit button label"),
+  onSubmit: z.string().optional().describe("Action expression on form submit"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var ElementRecordPickerPropsSchema = z.object({
+  object: z.string().describe("Object to pick records from"),
+  displayField: z.string().describe("Field to display as the record label"),
+  searchFields: z.array(z.string()).optional().describe("Fields to search against"),
+  filter: z.any().optional().describe("Filter criteria for available records"),
+  multiple: z.boolean().optional().default(false).describe("Allow multiple record selection"),
+  targetVariable: z.string().optional().describe("Page variable to bind selected record ID(s)"),
+  placeholder: I18nLabelSchema.optional().describe("Placeholder text"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
 var ComponentPropsMap = {
   // Structure
   "page:header": PageHeaderProps,
@@ -1799,7 +2340,7 @@ var ComponentPropsMap = {
   "record:related_list": RecordRelatedListProps,
   "record:highlights": RecordHighlightsProps,
   "record:activity": RecordActivityProps,
-  "record:chatter": EmptyProps,
+  "record:chatter": RecordChatterProps,
   "record:path": RecordPathProps,
   // Navigation
   "app:launcher": EmptyProps,
@@ -1811,7 +2352,17 @@ var ComponentPropsMap = {
   "user:profile": EmptyProps,
   // AI
   "ai:chat_window": AIChatWindowProps,
-  "ai:suggestion": z.object({ context: z.string().optional() })
+  "ai:suggestion": z.object({ context: z.string().optional() }),
+  // Content Elements
+  "element:text": ElementTextPropsSchema,
+  "element:number": ElementNumberPropsSchema,
+  "element:image": ElementImagePropsSchema,
+  "element:divider": EmptyProps,
+  // Interactive Elements
+  "element:button": ElementButtonPropsSchema,
+  "element:filter": ElementFilterPropsSchema,
+  "element:form": ElementFormPropsSchema,
+  "element:record_picker": ElementRecordPickerPropsSchema
 };
 var TouchTargetConfigSchema = z.object({
   minWidth: z.number().default(44).describe("Minimum touch target width in pixels (WCAG 2.5.5: 44px)"),
@@ -2243,6 +2794,6 @@ var DndConfigSchema = z.object({
   touchDelay: z.number().default(200).describe("Delay in ms before drag starts on touch devices")
 }).describe("Drag and drop interaction configuration");
 
-export { AIChatWindowProps, Action, ActionParamSchema, ActionSchema, AnimationSchema, AnimationTriggerSchema, App, AppBrandingSchema, AppSchema, AriaPropsSchema, BorderRadiusSchema, BreakpointColumnMapSchema, BreakpointName, BreakpointOrderMapSchema, BreakpointsSchema, CalendarConfigSchema, ChartAnnotationSchema, ChartAxisSchema, ChartConfigSchema, ChartInteractionSchema, ChartSeriesSchema, ChartTypeSchema, ColorPaletteSchema, ColumnSummarySchema, ComponentAnimationSchema, ComponentPropsMap, ConflictResolutionSchema, Dashboard, DashboardNavItemSchema, DashboardSchema, DashboardWidgetSchema, DateFormatSchema, DensityMode, DndConfigSchema, DragConstraintSchema, DragHandleSchema, DragItemSchema, DropEffectSchema, DropZoneSchema, EasingFunctionSchema, EvictionPolicySchema, FieldWidgetPropsSchema, FocusManagementSchema, FocusTrapConfigSchema, FormFieldSchema, FormSectionSchema, FormViewSchema, GalleryConfigSchema, GanttConfigSchema, GestureConfigSchema, GestureTypeSchema, GroupNavItemSchema, GroupingConfigSchema, GroupingFieldSchema, HttpMethodSchema, HttpRequestSchema, I18nLabelSchema, I18nObjectSchema, KanbanConfigSchema, KeyboardNavigationConfigSchema, KeyboardShortcutSchema, ListColumnSchema, ListViewSchema, LocaleConfigSchema, LongPressGestureConfigSchema, MotionConfigSchema, NavigationConfigSchema, NavigationItemSchema, NavigationModeSchema, NotificationActionSchema, NotificationConfigSchema, NotificationPositionSchema, NotificationSchema, NotificationSeveritySchema, NotificationTypeSchema, NumberFormatSchema, ObjectNavItemSchema, OfflineCacheConfigSchema, OfflineConfigSchema, OfflineStrategySchema, PageAccordionProps, PageCardProps, PageComponentSchema, PageComponentType, PageHeaderProps, PageNavItemSchema, PageRegionSchema, PageSchema, PageTabsProps, PageTransitionSchema, PageVariableSchema, PaginationConfigSchema, PerformanceConfigSchema, PersistStorageSchema, PinchGestureConfigSchema, PluralRuleSchema, RecordActivityProps, RecordDetailsProps, RecordHighlightsProps, RecordPathProps, RecordRelatedListProps, Report, ReportChartSchema, ReportColumnSchema, ReportGroupingSchema, ReportSchema, ReportType, ResponsiveConfigSchema, RowColorConfigSchema, RowHeightSchema, SelectionConfigSchema, ShadowSchema, SpacingSchema, SwipeDirectionSchema, SwipeGestureConfigSchema, SyncConfigSchema, ThemeMode, ThemeSchema, TimelineConfigSchema, TouchInteractionSchema, TouchTargetConfigSchema, TransitionConfigSchema, TransitionPresetSchema, TypographySchema, UrlNavItemSchema, ViewDataSchema, ViewSchema, ViewSharingSchema, WcagContrastLevel, WidgetEventSchema, WidgetLifecycleSchema, WidgetManifestSchema, WidgetPropertySchema, WidgetSourceSchema, ZIndexSchema, defineApp, defineView };
+export { AIChatWindowProps, Action, ActionNavItemSchema, ActionParamSchema, ActionSchema, AddRecordConfigSchema, AnimationSchema, AnimationTriggerSchema, App, AppBrandingSchema, AppSchema, AppearanceConfigSchema, AriaPropsSchema, BlankPageLayoutItemSchema, BlankPageLayoutSchema, BorderRadiusSchema, BreakpointColumnMapSchema, BreakpointName, BreakpointOrderMapSchema, BreakpointsSchema, CalendarConfigSchema, ChartAnnotationSchema, ChartAxisSchema, ChartConfigSchema, ChartInteractionSchema, ChartSeriesSchema, ChartTypeSchema, ColorPaletteSchema, ColumnSummarySchema, ComponentAnimationSchema, ComponentPropsMap, ConflictResolutionSchema, Dashboard, DashboardHeaderActionSchema, DashboardHeaderSchema, DashboardNavItemSchema, DashboardSchema, DashboardWidgetSchema, DateFormatSchema, DensityMode, DndConfigSchema, DragConstraintSchema, DragHandleSchema, DragItemSchema, DropEffectSchema, DropZoneSchema, EasingFunctionSchema, ElementButtonPropsSchema, ElementDataSourceSchema, ElementFilterPropsSchema, ElementFormPropsSchema, ElementImagePropsSchema, ElementNumberPropsSchema, ElementRecordPickerPropsSchema, ElementTextPropsSchema, EmbedConfigSchema, EvictionPolicySchema, FieldWidgetPropsSchema, FocusManagementSchema, FocusTrapConfigSchema, FormFieldSchema, FormSectionSchema, FormViewSchema, GalleryConfigSchema, GanttConfigSchema, GestureConfigSchema, GestureTypeSchema, GlobalFilterOptionsFromSchema, GlobalFilterSchema, GroupNavItemSchema, GroupingConfigSchema, GroupingFieldSchema, HttpMethodSchema, HttpRequestSchema, I18nLabelSchema, I18nObjectSchema, InterfacePageConfigSchema, KanbanConfigSchema, KeyboardNavigationConfigSchema, KeyboardShortcutSchema, ListColumnSchema, ListViewSchema, LocaleConfigSchema, LongPressGestureConfigSchema, MotionConfigSchema, NavigationAreaSchema, NavigationConfigSchema, NavigationItemSchema, NavigationModeSchema, NotificationActionSchema, NotificationConfigSchema, NotificationPositionSchema, NotificationSchema, NotificationSeveritySchema, NotificationTypeSchema, NumberFormatSchema, ObjectNavItemSchema, OfflineCacheConfigSchema, OfflineConfigSchema, OfflineStrategySchema, PageAccordionProps, PageCardProps, PageComponentSchema, PageComponentType, PageHeaderProps, PageNavItemSchema, PageRegionSchema, PageSchema, PageTabsProps, PageTransitionSchema, PageTypeSchema, PageVariableSchema, PaginationConfigSchema, PerformanceConfigSchema, PersistStorageSchema, PinchGestureConfigSchema, PluralRuleSchema, RecordActivityProps, RecordChatterProps, RecordDetailsProps, RecordHighlightsProps, RecordPathProps, RecordRelatedListProps, RecordReviewConfigSchema, Report, ReportChartSchema, ReportColumnSchema, ReportGroupingSchema, ReportNavItemSchema, ReportSchema, ReportType, ResponsiveConfigSchema, RowColorConfigSchema, RowHeightSchema, SelectionConfigSchema, ShadowSchema, SharingConfigSchema, SpacingSchema, SwipeDirectionSchema, SwipeGestureConfigSchema, SyncConfigSchema, ThemeMode, ThemeSchema, TimelineConfigSchema, TouchInteractionSchema, TouchTargetConfigSchema, TransitionConfigSchema, TransitionPresetSchema, TypographySchema, UrlNavItemSchema, UserActionsConfigSchema, ViewDataSchema, ViewSchema, ViewSharingSchema, ViewTabSchema, VisualizationTypeSchema, WcagContrastLevel, WidgetActionTypeSchema, WidgetColorVariantSchema, WidgetEventSchema, WidgetLifecycleSchema, WidgetManifestSchema, WidgetMeasureSchema, WidgetPropertySchema, WidgetSourceSchema, ZIndexSchema, defineApp, defineView };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map