@objectstack/spec 3.0.6 → 3.0.7

package/dist/index.mjs

@@ -29,6 +29,7 @@ __export(shared_exports, {
   RoleNameSchema: () => RoleNameSchema,
   SnakeCaseIdentifierSchema: () => SnakeCaseIdentifierSchema,
   SortDirectionEnum: () => SortDirectionEnum,
+  SortItemSchema: () => SortItemSchema,
   StaticMountSchema: () => StaticMountSchema,
   SystemIdentifierSchema: () => SystemIdentifierSchema,
   TransformTypeSchema: () => TransformTypeSchema,
@@ -171,6 +172,10 @@ var AggregationFunctionEnum = z.enum([
   "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");
 var MutationEventEnum = z.enum([
   "insert",
   "update",
@@ -4227,6 +4232,8 @@ __export(ui_exports, {
   AppBrandingSchema: () => AppBrandingSchema,
   AppSchema: () => AppSchema,
   AriaPropsSchema: () => AriaPropsSchema,
+  BlankPageLayoutItemSchema: () => BlankPageLayoutItemSchema,
+  BlankPageLayoutSchema: () => BlankPageLayoutSchema,
   BorderRadiusSchema: () => BorderRadiusSchema,
   BreakpointColumnMapSchema: () => BreakpointColumnMapSchema,
   BreakpointName: () => BreakpointName,
@@ -4245,6 +4252,8 @@ __export(ui_exports, {
   ComponentPropsMap: () => ComponentPropsMap,
   ConflictResolutionSchema: () => ConflictResolutionSchema,
   Dashboard: () => Dashboard,
+  DashboardHeaderActionSchema: () => DashboardHeaderActionSchema,
+  DashboardHeaderSchema: () => DashboardHeaderSchema,
   DashboardNavItemSchema: () => DashboardNavItemSchema,
   DashboardSchema: () => DashboardSchema,
   DashboardWidgetSchema: () => DashboardWidgetSchema,
@@ -4257,6 +4266,15 @@ __export(ui_exports, {
   DropEffectSchema: () => DropEffectSchema,
   DropZoneSchema: () => DropZoneSchema,
   EasingFunctionSchema: () => EasingFunctionSchema,
+  ElementButtonPropsSchema: () => ElementButtonPropsSchema,
+  ElementDataSourceSchema: () => ElementDataSourceSchema,
+  ElementFilterPropsSchema: () => ElementFilterPropsSchema,
+  ElementFormPropsSchema: () => ElementFormPropsSchema,
+  ElementImagePropsSchema: () => ElementImagePropsSchema,
+  ElementNumberPropsSchema: () => ElementNumberPropsSchema,
+  ElementRecordPickerPropsSchema: () => ElementRecordPickerPropsSchema,
+  ElementTextPropsSchema: () => ElementTextPropsSchema,
+  EmbedConfigSchema: () => EmbedConfigSchema,
   EvictionPolicySchema: () => EvictionPolicySchema,
   FieldWidgetPropsSchema: () => FieldWidgetPropsSchema,
   FocusManagementSchema: () => FocusManagementSchema,
@@ -4268,6 +4286,8 @@ __export(ui_exports, {
   GanttConfigSchema: () => GanttConfigSchema,
   GestureConfigSchema: () => GestureConfigSchema,
   GestureTypeSchema: () => GestureTypeSchema,
+  GlobalFilterOptionsFromSchema: () => GlobalFilterOptionsFromSchema,
+  GlobalFilterSchema: () => GlobalFilterSchema,
   GroupNavItemSchema: () => GroupNavItemSchema,
   GroupingConfigSchema: () => GroupingConfigSchema,
   GroupingFieldSchema: () => GroupingFieldSchema,
@@ -4307,6 +4327,7 @@ __export(ui_exports, {
   PageSchema: () => PageSchema,
   PageTabsProps: () => PageTabsProps,
   PageTransitionSchema: () => PageTransitionSchema,
+  PageTypeSchema: () => PageTypeSchema,
   PageVariableSchema: () => PageVariableSchema,
   PaginationConfigSchema: () => PaginationConfigSchema,
   PerformanceConfigSchema: () => PerformanceConfigSchema,
@@ -4318,6 +4339,7 @@ __export(ui_exports, {
   RecordHighlightsProps: () => RecordHighlightsProps,
   RecordPathProps: () => RecordPathProps,
   RecordRelatedListProps: () => RecordRelatedListProps,
+  RecordReviewConfigSchema: () => RecordReviewConfigSchema,
   Report: () => Report,
   ReportChartSchema: () => ReportChartSchema,
   ReportColumnSchema: () => ReportColumnSchema,
@@ -4329,6 +4351,7 @@ __export(ui_exports, {
   RowHeightSchema: () => RowHeightSchema,
   SelectionConfigSchema: () => SelectionConfigSchema,
   ShadowSchema: () => ShadowSchema,
+  SharingConfigSchema: () => SharingConfigSchema,
   SpacingSchema: () => SpacingSchema,
   SwipeDirectionSchema: () => SwipeDirectionSchema,
   SwipeGestureConfigSchema: () => SwipeGestureConfigSchema,
@@ -4346,9 +4369,12 @@ __export(ui_exports, {
   ViewSchema: () => ViewSchema,
   ViewSharingSchema: () => ViewSharingSchema,
   WcagContrastLevel: () => WcagContrastLevel,
+  WidgetActionTypeSchema: () => WidgetActionTypeSchema,
+  WidgetColorVariantSchema: () => WidgetColorVariantSchema,
   WidgetEventSchema: () => WidgetEventSchema,
   WidgetLifecycleSchema: () => WidgetLifecycleSchema,
   WidgetManifestSchema: () => WidgetManifestSchema,
+  WidgetMeasureSchema: () => WidgetMeasureSchema,
   WidgetPropertySchema: () => WidgetPropertySchema,
   WidgetSourceSchema: () => WidgetSourceSchema,
   ZIndexSchema: () => ZIndexSchema,
@@ -4589,6 +4615,25 @@ var PerformanceConfigSchema = z.object({
   /** Debounce interval for user interactions (ms) */
   debounceMs: z.number().optional().describe("Debounce interval for user interactions in milliseconds")
 }).describe("Performance optimization configuration");
+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({
   /** Unique identifier for the item */
   id: SnakeCaseIdentifierSchema.describe("Unique identifier for this navigation item (lowercase snake_case)"),
@@ -4629,7 +4674,6 @@ 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)")
     }),
@@ -4664,10 +4708,11 @@ 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.
    */
-  navigation: z.array(NavigationItemSchema).optional().describe("Structured navigation menu tree"),
+  navigation: z.array(NavigationItemSchema).optional().describe("Full navigation tree for the app sidebar"),
   /** 
    * App-level Home Page Override
    * ID of the navigation item to act as the landing page.
@@ -4687,6 +4732,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"),
@@ -4999,6 +5048,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")
 });
@@ -5013,13 +5064,66 @@ var ViewSchema = z.object({
 function defineView(config) {
   return ViewSchema.parse(config);
 }
+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) */
@@ -5030,6 +5134,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)
@@ -5050,6 +5156,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"),
@@ -5057,6 +5194,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 */
@@ -5068,11 +5207,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 */
@@ -5232,8 +5367,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([
@@ -5256,6 +5408,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 */
@@ -5263,19 +5417,91 @@ 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 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 */
@@ -5656,6 +5882,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,
@@ -5682,7 +5973,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)"),
@@ -11639,7 +11940,6 @@ __export(kernel_exports, {
   AdvancedPluginLifecycleConfigSchema: () => AdvancedPluginLifecycleConfigSchema,
   BreakingChangeSchema: () => BreakingChangeSchema,
   CLICommandContributionSchema: () => CLICommandContributionSchema,
-  CLIExtensionExportSchema: () => CLIExtensionExportSchema,
   CORE_PLUGIN_TYPES: () => CORE_PLUGIN_TYPES,
   CapabilityConformanceLevelSchema: () => CapabilityConformanceLevelSchema,
   CompatibilityLevelSchema: () => CompatibilityLevelSchema,
@@ -11741,6 +12041,7 @@ __export(kernel_exports, {
   MetadataValidationResultSchema: () => MetadataValidationResultSchema,
   MetadataWatchEventSchema: () => MetadataWatchEventSchema2,
   MultiVersionSupportSchema: () => MultiVersionSupportSchema,
+  OclifPluginConfigSchema: () => OclifPluginConfigSchema,
   OpsDomainModuleSchema: () => OpsDomainModuleSchema,
   OpsFilePathSchema: () => OpsFilePathSchema,
   OpsPluginStructureSchema: () => OpsPluginStructureSchema,
@@ -11854,28 +12155,29 @@ var CLICommandContributionSchema = z.object({
   /** Brief description shown in `os --help` output. */
   description: z.string().optional().describe("Command description for help text"),
   /** 
-   * Module path that exports the Commander.js command(s).
-   * Relative to the plugin package root. If omitted, the CLI 
-   * imports from the package's main entry point.
-   * 
-   * The module must export one of:
-   * - `export const commands: Command[]`
-   * - `export default Command | Command[]`
+   * Module path that exports the oclif Command class(es).
+   * Relative to the plugin package root. With oclif, this is typically
+   * auto-discovered from the `commands` directory, but can be specified
+   * for documentation or manifest purposes.
    * 
-   * @example "./dist/cli.js"
-   * @example "./cli"
-   */
-  module: z.string().optional().describe("Module path exporting Commander.js commands")
-});
-var CLIExtensionExportSchema = z.object({
-  /** Named export: array of Commander.js Command instances */
-  commands: z.array(z.unknown()).optional().describe("Array of Commander.js Command instances"),
-  /** Default export: single Command or array of Commands */
-  default: z.union([
-    z.unknown(),
-    z.array(z.unknown())
-  ]).optional().describe("Default export: Command or Command[]")
-});
+   * @example "./dist/commands/marketplace.js"
+   * @example "./dist/commands"
+   */
+  module: z.string().optional().describe("Module path exporting oclif Command classes")
+});
+var OclifPluginConfigSchema = z.object({
+  /** Command discovery configuration */
+  commands: z.object({
+    /** Discovery strategy — typically "pattern" for file-based discovery */
+    strategy: z.enum(["pattern", "explicit", "single"]).optional().describe("Command discovery strategy"),
+    /** Directory path containing compiled command files */
+    target: z.string().optional().describe("Target directory for command files"),
+    /** Glob pattern for matching command files */
+    glob: z.string().optional().describe("Glob pattern for command file matching")
+  }).optional().describe("Command discovery configuration"),
+  /** Topic separator character (default: space) */
+  topicSeparator: z.string().optional().describe("Character separating topic and command names")
+}).describe("oclif plugin configuration section");
 var RuntimeMode = z.enum([
   "development",
   // Hot-reload, verbose logging
@@ -33876,13 +34178,17 @@ __export(studio_exports, {
   ActionContributionSchema: () => ActionContributionSchema,
   ActionLocationSchema: () => ActionLocationSchema,
   ActivationEventSchema: () => ActivationEventSchema2,
+  CanvasSnapSettingsSchema: () => CanvasSnapSettingsSchema,
+  CanvasZoomSettingsSchema: () => CanvasZoomSettingsSchema,
   CommandContributionSchema: () => CommandContributionSchema,
   ERDiagramConfigSchema: () => ERDiagramConfigSchema,
   ERLayoutAlgorithmSchema: () => ERLayoutAlgorithmSchema,
   ERNodeDisplaySchema: () => ERNodeDisplaySchema,
+  ElementPaletteItemSchema: () => ElementPaletteItemSchema,
   FieldEditorConfigSchema: () => FieldEditorConfigSchema,
   FieldGroupSchema: () => FieldGroupSchema,
   FieldPropertySectionSchema: () => FieldPropertySectionSchema,
+  InterfaceBuilderConfigSchema: () => InterfaceBuilderConfigSchema,
   MetadataIconContributionSchema: () => MetadataIconContributionSchema,
   MetadataViewerContributionSchema: () => MetadataViewerContributionSchema,
   ObjectDesignerConfigSchema: () => ObjectDesignerConfigSchema,
@@ -33893,6 +34199,7 @@ __export(studio_exports, {
   ObjectPreviewConfigSchema: () => ObjectPreviewConfigSchema,
   ObjectPreviewTabSchema: () => ObjectPreviewTabSchema,
   ObjectSortFieldSchema: () => ObjectSortFieldSchema,
+  PageBuilderConfigSchema: () => PageBuilderConfigSchema,
   PanelContributionSchema: () => PanelContributionSchema,
   PanelLocationSchema: () => PanelLocationSchema,
   RelationshipDisplaySchema: () => RelationshipDisplaySchema,
@@ -34356,6 +34663,35 @@ var ObjectDesignerConfigSchema = z.object({
 function defineObjectDesignerConfig(input) {
   return ObjectDesignerConfigSchema.parse(input);
 }
+var CanvasSnapSettingsSchema = z.object({
+  enabled: z.boolean().default(true).describe("Enable snap-to-grid"),
+  gridSize: z.number().int().min(1).default(8).describe("Snap grid size in pixels"),
+  showGrid: z.boolean().default(true).describe("Show grid overlay on canvas"),
+  showGuides: z.boolean().default(true).describe("Show alignment guides when dragging")
+});
+var CanvasZoomSettingsSchema = z.object({
+  min: z.number().min(0.1).default(0.25).describe("Minimum zoom level"),
+  max: z.number().max(10).default(3).describe("Maximum zoom level"),
+  default: z.number().default(1).describe("Default zoom level"),
+  step: z.number().default(0.1).describe("Zoom step increment")
+});
+var ElementPaletteItemSchema = z.object({
+  type: z.string().describe('Component type (e.g. "element:button", "element:text")'),
+  label: z.string().describe("Display label in palette"),
+  icon: z.string().optional().describe("Icon name for palette display"),
+  category: z.enum(["content", "interactive", "data", "layout"]).describe("Palette category grouping"),
+  defaultWidth: z.number().int().min(1).default(4).describe("Default width in grid columns"),
+  defaultHeight: z.number().int().min(1).default(2).describe("Default height in grid rows")
+});
+var PageBuilderConfigSchema = z.object({
+  snap: CanvasSnapSettingsSchema.optional().describe("Canvas snap settings"),
+  zoom: CanvasZoomSettingsSchema.optional().describe("Canvas zoom settings"),
+  palette: z.array(ElementPaletteItemSchema).optional().describe("Custom element palette (defaults to all registered elements)"),
+  showLayerPanel: z.boolean().default(true).describe("Show layer ordering panel"),
+  showPropertyPanel: z.boolean().default(true).describe("Show property inspector panel"),
+  undoLimit: z.number().int().min(1).default(50).describe("Maximum undo history steps")
+});
+var InterfaceBuilderConfigSchema = PageBuilderConfigSchema;
 var ObjectStackDefinitionSchema = z.object({
   /** System Configuration */
   manifest: ManifestSchema.optional().describe("Project Package Configuration"),
@@ -34557,6 +34893,131 @@ ${lines.join("\n")}`);
   }
   return result.data;
 }
+var ConflictStrategySchema = z.enum(["error", "override", "merge"]);
+var ComposeStacksOptionsSchema = z.object({
+  /**
+   * How to handle same-name objects across stacks.
+   * @default 'error'
+   */
+  objectConflict: ConflictStrategySchema.default("error"),
+  /**
+   * Which manifest to keep when multiple stacks provide one.
+   * - `'first'` — Use the first manifest found.
+   * - `'last'`  — Use the last manifest found (default).
+   * - A number  — Use the manifest from the stack at the given index.
+   * @default 'last'
+   */
+  manifest: z.union([z.enum(["first", "last"]), z.number().int().min(0)]).default("last"),
+  /**
+   * Optional namespace prefix (reserved for Phase 2 — Marketplace isolation).
+   * When set, object names from this composition are prefixed for isolation.
+   */
+  namespace: z.string().optional()
+});
+var CONCAT_ARRAY_FIELDS = [
+  "datasources",
+  "translations",
+  "objectExtensions",
+  "apps",
+  "views",
+  "pages",
+  "dashboards",
+  "reports",
+  "actions",
+  "themes",
+  "workflows",
+  "approvals",
+  "flows",
+  "roles",
+  "permissions",
+  "sharingRules",
+  "policies",
+  "apis",
+  "webhooks",
+  "agents",
+  "ragPipelines",
+  "hooks",
+  "mappings",
+  "analyticsCubes",
+  "connectors",
+  "data",
+  "plugins",
+  "devPlugins"
+];
+function mergeObjects(stacks, strategy) {
+  const map = /* @__PURE__ */ new Map();
+  const result = [];
+  for (const stack of stacks) {
+    if (!stack.objects) continue;
+    for (const obj of stack.objects) {
+      const existing = map.get(obj.name);
+      if (!existing) {
+        map.set(obj.name, obj);
+        result.push(obj);
+        continue;
+      }
+      switch (strategy) {
+        case "error":
+          throw new Error(
+            `composeStacks conflict: object '${obj.name}' is defined in multiple stacks. Use { objectConflict: 'override' } or { objectConflict: 'merge' } to resolve.`
+          );
+        case "override": {
+          const idx = result.indexOf(existing);
+          result[idx] = obj;
+          map.set(obj.name, obj);
+          break;
+        }
+        case "merge": {
+          const merged = { ...existing, ...obj, fields: { ...existing.fields, ...obj.fields } };
+          const idx = result.indexOf(existing);
+          result[idx] = merged;
+          map.set(obj.name, merged);
+          break;
+        }
+      }
+    }
+  }
+  return result.length > 0 ? result : void 0;
+}
+function selectManifest(stacks, strategy) {
+  if (typeof strategy === "number") {
+    return stacks[strategy]?.manifest;
+  }
+  if (strategy === "first") {
+    for (const s of stacks) {
+      if (s.manifest) return s.manifest;
+    }
+    return void 0;
+  }
+  for (let i = stacks.length - 1; i >= 0; i--) {
+    if (stacks[i].manifest) return stacks[i].manifest;
+  }
+  return void 0;
+}
+function composeStacks(stacks, options) {
+  if (stacks.length === 0) return {};
+  if (stacks.length === 1) return stacks[0];
+  const opts = ComposeStacksOptionsSchema.parse(options ?? {});
+  const composed = {};
+  composed.manifest = selectManifest(stacks, opts.manifest);
+  for (let i = stacks.length - 1; i >= 0; i--) {
+    if (stacks[i].i18n) {
+      composed.i18n = stacks[i].i18n;
+      break;
+    }
+  }
+  const objects = mergeObjects(stacks, opts.objectConflict);
+  if (objects) {
+    composed.objects = objects;
+  }
+  for (const field of CONCAT_ARRAY_FIELDS) {
+    const arrays = stacks.map((s) => s[field]).filter((v) => Array.isArray(v));
+    if (arrays.length > 0) {
+      composed[field] = arrays.flat();
+    }
+  }
+  return composed;
+}
 var ObjectQLCapabilitiesSchema = z.object({
   /** Query Capabilities */
   queryFilters: z.boolean().default(true).describe("Supports WHERE clause filtering"),
@@ -34673,6 +35134,6 @@ var ObjectStackCapabilitiesSchema = z.object({
   system: ObjectOSCapabilitiesSchema.describe("System/Runtime Layer capabilities")
 });
 
-export { ai_exports as AI, api_exports as API, automation_exports as Automation, cloud_exports as Cloud, contracts_exports as Contracts, data_exports as Data, identity_exports as Identity, integration_exports as Integration, kernel_exports as Kernel, MAP_SUPPORTED_FIELDS, METADATA_ALIASES, ObjectOSCapabilitiesSchema, ObjectQLCapabilitiesSchema, ObjectStackCapabilitiesSchema, ObjectStackDefinitionSchema, ObjectStackSchema, ObjectUICapabilitiesSchema, qa_exports as QA, security_exports as Security, shared_exports as Shared, studio_exports as Studio, system_exports as System, ui_exports as UI, defineAgent, defineApp, defineFlow, defineStack, defineView, findClosestMatches, formatSuggestion, formatZodError, formatZodIssue, normalizeMetadataCollection, normalizePluginMetadata, normalizeStackInput, objectStackErrorMap, safeParsePretty, suggestFieldType };
+export { ai_exports as AI, api_exports as API, automation_exports as Automation, cloud_exports as Cloud, ComposeStacksOptionsSchema, ConflictStrategySchema, contracts_exports as Contracts, data_exports as Data, identity_exports as Identity, integration_exports as Integration, kernel_exports as Kernel, MAP_SUPPORTED_FIELDS, METADATA_ALIASES, ObjectOSCapabilitiesSchema, ObjectQLCapabilitiesSchema, ObjectStackCapabilitiesSchema, ObjectStackDefinitionSchema, ObjectStackSchema, ObjectUICapabilitiesSchema, qa_exports as QA, security_exports as Security, shared_exports as Shared, studio_exports as Studio, system_exports as System, ui_exports as UI, composeStacks, defineAgent, defineApp, defineFlow, defineStack, defineView, findClosestMatches, formatSuggestion, formatZodError, formatZodIssue, normalizeMetadataCollection, normalizePluginMetadata, normalizeStackInput, objectStackErrorMap, safeParsePretty, suggestFieldType };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map