@objectstack/spec 3.0.4 → 3.0.6

package/dist/index.js

@@ -22,6 +22,8 @@ __export(shared_exports, {
   FlowNameSchema: () => FlowNameSchema,
   HttpMethod: () => HttpMethod,
   IsolationLevelEnum: () => IsolationLevelEnum,
+  MAP_SUPPORTED_FIELDS: () => MAP_SUPPORTED_FIELDS,
+  METADATA_ALIASES: () => METADATA_ALIASES,
   MetadataFormatSchema: () => MetadataFormatSchema,
   MutationEventEnum: () => MutationEventEnum,
   ObjectNameSchema: () => ObjectNameSchema,
@@ -38,6 +40,9 @@ __export(shared_exports, {
   formatZodError: () => formatZodError,
   formatZodIssue: () => formatZodIssue,
   levenshteinDistance: () => levenshteinDistance,
+  normalizeMetadataCollection: () => normalizeMetadataCollection,
+  normalizePluginMetadata: () => normalizePluginMetadata,
+  normalizeStackInput: () => normalizeStackInput,
   objectStackErrorMap: () => objectStackErrorMap,
   safeParsePretty: () => safeParsePretty,
   suggestFieldType: () => suggestFieldType
@@ -491,9 +496,9 @@ var FieldSchema = zod.z.object({
   /** Calculation */
   expression: zod.z.string().optional().describe("Formula expression"),
   summaryOperations: zod.z.object({
-    object: zod.z.string(),
-    field: zod.z.string(),
-    function: zod.z.enum(["count", "sum", "min", "max", "avg"])
+    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
@@ -894,6 +899,88 @@ function safeParsePretty(schema, data, label) {
   };
 }
 
+// src/shared/metadata-collection.zod.ts
+var MAP_SUPPORTED_FIELDS = [
+  "objects",
+  "apps",
+  "pages",
+  "dashboards",
+  "reports",
+  "actions",
+  "themes",
+  "workflows",
+  "approvals",
+  "flows",
+  "roles",
+  "permissions",
+  "sharingRules",
+  "policies",
+  "apis",
+  "webhooks",
+  "agents",
+  "ragPipelines",
+  "hooks",
+  "mappings",
+  "analyticsCubes",
+  "connectors",
+  "datasources"
+];
+function normalizeMetadataCollection(value, keyField = "name") {
+  if (value == null || Array.isArray(value)) return value;
+  if (typeof value === "object") {
+    return Object.entries(value).map(([key, item]) => {
+      if (item && typeof item === "object" && !Array.isArray(item)) {
+        const obj = item;
+        if (!(keyField in obj) || obj[keyField] === void 0) {
+          return { ...obj, [keyField]: key };
+        }
+        return obj;
+      }
+      return item;
+    });
+  }
+  return value;
+}
+function normalizeStackInput(input) {
+  const result = { ...input };
+  for (const field of MAP_SUPPORTED_FIELDS) {
+    if (field in result) {
+      result[field] = normalizeMetadataCollection(result[field]);
+    }
+  }
+  return result;
+}
+var METADATA_ALIASES = {
+  triggers: "hooks"
+};
+function normalizePluginMetadata(metadata) {
+  const result = { ...metadata };
+  for (const [alias, canonical] of Object.entries(METADATA_ALIASES)) {
+    if (alias in result) {
+      const aliasValue = normalizeMetadataCollection(result[alias]);
+      const canonicalValue = normalizeMetadataCollection(result[canonical]);
+      if (Array.isArray(aliasValue)) {
+        result[canonical] = Array.isArray(canonicalValue) ? [...canonicalValue, ...aliasValue] : aliasValue;
+      }
+      delete result[alias];
+    }
+  }
+  for (const field of MAP_SUPPORTED_FIELDS) {
+    if (field in result) {
+      result[field] = normalizeMetadataCollection(result[field]);
+    }
+  }
+  if (Array.isArray(result.plugins)) {
+    result.plugins = result.plugins.map((p) => {
+      if (p && typeof p === "object" && !Array.isArray(p)) {
+        return normalizePluginMetadata(p);
+      }
+      return p;
+    });
+  }
+  return result;
+}
+
 // src/data/index.ts
 var data_exports = {};
 __export(data_exports, {
@@ -1639,15 +1726,15 @@ var ObjectExtensionSchema = zod.z.object({
   /** Fields to merge into the target object (additive) */
   fields: zod.z.record(zod.z.string(), FieldSchema).optional().describe("Fields to add/override"),
   /** Override label */
-  label: zod.z.string().optional(),
+  label: zod.z.string().optional().describe("Override label for the extended object"),
   /** Override plural label */
-  pluralLabel: zod.z.string().optional(),
+  pluralLabel: zod.z.string().optional().describe("Override plural label for the extended object"),
   /** Override description */
-  description: zod.z.string().optional(),
+  description: zod.z.string().optional().describe("Override description for the extended object"),
   /** Additional validation rules to add */
-  validations: zod.z.array(ValidationRuleSchema).optional(),
+  validations: zod.z.array(ValidationRuleSchema).optional().describe("Additional validation rules to merge into the target object"),
   /** Additional indexes to add */
-  indexes: zod.z.array(IndexSchema).optional(),
+  indexes: zod.z.array(IndexSchema).optional().describe("Additional indexes to merge into the target object"),
   /** Merge priority. Higher number applied later (wins on conflict). Default: 200 */
   priority: zod.z.number().int().min(0).max(999).default(200).describe("Merge priority (higher = applied later)")
 });
@@ -33792,14 +33879,31 @@ __export(studio_exports, {
   ActionLocationSchema: () => ActionLocationSchema,
   ActivationEventSchema: () => ActivationEventSchema2,
   CommandContributionSchema: () => CommandContributionSchema,
+  ERDiagramConfigSchema: () => ERDiagramConfigSchema,
+  ERLayoutAlgorithmSchema: () => ERLayoutAlgorithmSchema,
+  ERNodeDisplaySchema: () => ERNodeDisplaySchema,
+  FieldEditorConfigSchema: () => FieldEditorConfigSchema,
+  FieldGroupSchema: () => FieldGroupSchema,
+  FieldPropertySectionSchema: () => FieldPropertySectionSchema,
   MetadataIconContributionSchema: () => MetadataIconContributionSchema,
   MetadataViewerContributionSchema: () => MetadataViewerContributionSchema,
+  ObjectDesignerConfigSchema: () => ObjectDesignerConfigSchema,
+  ObjectDesignerDefaultViewSchema: () => ObjectDesignerDefaultViewSchema,
+  ObjectFilterSchema: () => ObjectFilterSchema,
+  ObjectListDisplayModeSchema: () => ObjectListDisplayModeSchema,
+  ObjectManagerConfigSchema: () => ObjectManagerConfigSchema,
+  ObjectPreviewConfigSchema: () => ObjectPreviewConfigSchema,
+  ObjectPreviewTabSchema: () => ObjectPreviewTabSchema,
+  ObjectSortFieldSchema: () => ObjectSortFieldSchema,
   PanelContributionSchema: () => PanelContributionSchema,
   PanelLocationSchema: () => PanelLocationSchema,
+  RelationshipDisplaySchema: () => RelationshipDisplaySchema,
+  RelationshipMapperConfigSchema: () => RelationshipMapperConfigSchema,
   SidebarGroupContributionSchema: () => SidebarGroupContributionSchema,
   StudioPluginContributionsSchema: () => StudioPluginContributionsSchema,
   StudioPluginManifestSchema: () => StudioPluginManifestSchema,
   ViewModeSchema: () => ViewModeSchema,
+  defineObjectDesignerConfig: () => defineObjectDesignerConfig,
   defineStudioPlugin: () => defineStudioPlugin
 });
 var ViewModeSchema = zod.z.enum(["preview", "design", "code", "data"]);
@@ -33916,6 +34020,344 @@ var StudioPluginManifestSchema = zod.z.object({
 function defineStudioPlugin(input) {
   return StudioPluginManifestSchema.parse(input);
 }
+var FieldPropertySectionSchema = zod.z.object({
+  /** Unique section key */
+  key: zod.z.string().describe('Section key (e.g., "basics", "constraints", "security")'),
+  /** Display label */
+  label: zod.z.string().describe("Section display label"),
+  /** Lucide icon name */
+  icon: zod.z.string().optional().describe("Lucide icon name"),
+  /** Whether section is expanded by default */
+  defaultExpanded: zod.z.boolean().default(true).describe("Whether section is expanded by default"),
+  /** Sort order — lower values appear first */
+  order: zod.z.number().default(0).describe("Sort order (lower = higher)")
+});
+var FieldGroupSchema = zod.z.object({
+  /** Group key (matches field.group value) */
+  key: zod.z.string().describe("Group key matching field.group values"),
+  /** Display label */
+  label: zod.z.string().describe("Group display label"),
+  /** Lucide icon name */
+  icon: zod.z.string().optional().describe("Lucide icon name"),
+  /** Whether group is expanded by default */
+  defaultExpanded: zod.z.boolean().default(true).describe("Whether group is expanded by default"),
+  /** Sort order — lower values appear first */
+  order: zod.z.number().default(0).describe("Sort order (lower = higher)")
+});
+var FieldEditorConfigSchema = zod.z.object({
+  /** Enable inline editing of field properties in the table */
+  inlineEditing: zod.z.boolean().default(true).describe("Enable inline editing of field properties"),
+  /** Enable drag-and-drop field reordering */
+  dragReorder: zod.z.boolean().default(true).describe("Enable drag-and-drop field reordering"),
+  /** Show field group headers for organizing fields */
+  showFieldGroups: zod.z.boolean().default(true).describe("Show field group headers"),
+  /** Show the type-specific property panel on the right */
+  showPropertyPanel: zod.z.boolean().default(true).describe("Show the right-side property panel"),
+  /** Default property panel sections to display */
+  propertySections: zod.z.array(FieldPropertySectionSchema).default([
+    { key: "basics", label: "Basic Properties", defaultExpanded: true, order: 0 },
+    { key: "constraints", label: "Constraints & Validation", defaultExpanded: true, order: 10 },
+    { key: "relationship", label: "Relationship Config", defaultExpanded: true, order: 20 },
+    { key: "display", label: "Display & UI", defaultExpanded: false, order: 30 },
+    { key: "security", label: "Security & Compliance", defaultExpanded: false, order: 40 },
+    { key: "advanced", label: "Advanced", defaultExpanded: false, order: 50 }
+  ]).describe("Property panel section definitions"),
+  /** Field groups for organizing fields in the editor */
+  fieldGroups: zod.z.array(FieldGroupSchema).default([]).describe("Field group definitions"),
+  /** Maximum fields before pagination kicks in */
+  paginationThreshold: zod.z.number().default(50).describe("Number of fields before pagination is enabled"),
+  /** Enable batch field operations (add multiple fields at once) */
+  batchOperations: zod.z.boolean().default(true).describe("Enable batch add/remove field operations"),
+  /** Show field usage statistics (views, formulas, relationships referencing this field) */
+  showUsageStats: zod.z.boolean().default(false).describe("Show field usage statistics")
+});
+var RelationshipDisplaySchema = zod.z.object({
+  /** Relationship type to configure */
+  type: zod.z.enum(["lookup", "master_detail", "tree"]).describe("Relationship type"),
+  /** Line style for this relationship type */
+  lineStyle: zod.z.enum(["solid", "dashed", "dotted"]).default("solid").describe("Line style in diagrams"),
+  /** Line color (CSS color value) */
+  color: zod.z.string().default("#94a3b8").describe("Line color (CSS value)"),
+  /** Highlighted color on hover/select */
+  highlightColor: zod.z.string().default("#0891b2").describe("Highlighted color on hover/select"),
+  /** Cardinality label to display */
+  cardinalityLabel: zod.z.string().default("1:N").describe('Cardinality label (e.g., "1:N", "1:1", "N:M")')
+});
+var RelationshipMapperConfigSchema = zod.z.object({
+  /** Enable visual relationship creation (drag from source to target) */
+  visualCreation: zod.z.boolean().default(true).describe("Enable drag-to-create relationships"),
+  /** Show reverse relationships (child → parent) */
+  showReverseRelationships: zod.z.boolean().default(true).describe("Show reverse/child-to-parent relationships"),
+  /** Show cascade delete warnings */
+  showCascadeWarnings: zod.z.boolean().default(true).describe("Show cascade delete behavior warnings"),
+  /** Relationship display configuration by type */
+  displayConfig: zod.z.array(RelationshipDisplaySchema).default([
+    { type: "lookup", lineStyle: "dashed", color: "#0891b2", highlightColor: "#06b6d4", cardinalityLabel: "1:N" },
+    { type: "master_detail", lineStyle: "solid", color: "#ea580c", highlightColor: "#f97316", cardinalityLabel: "1:N" },
+    { type: "tree", lineStyle: "dotted", color: "#8b5cf6", highlightColor: "#a78bfa", cardinalityLabel: "1:N" }
+  ]).describe("Visual config per relationship type")
+});
+var ERLayoutAlgorithmSchema = zod.z.enum([
+  "force",
+  // Force-directed graph (natural clustering)
+  "hierarchy",
+  // Top-down hierarchy (master → detail)
+  "grid",
+  // Uniform grid layout
+  "circular"
+  // Circular arrangement
+]).describe("ER diagram layout algorithm");
+var ERNodeDisplaySchema = zod.z.object({
+  /** Show field list within the node */
+  showFields: zod.z.boolean().default(true).describe("Show field list inside entity nodes"),
+  /** Maximum fields to show before collapsing (0 = no limit) */
+  maxFieldsVisible: zod.z.number().default(8).describe('Max fields visible before "N more..." collapse'),
+  /** Show field types alongside field names */
+  showFieldTypes: zod.z.boolean().default(true).describe("Show field type badges"),
+  /** Show required field indicators */
+  showRequiredIndicator: zod.z.boolean().default(true).describe("Show required field indicators"),
+  /** Show record count on each node (requires data access) */
+  showRecordCount: zod.z.boolean().default(false).describe("Show live record count on nodes"),
+  /** Show object icon */
+  showIcon: zod.z.boolean().default(true).describe("Show object icon on node header"),
+  /** Show object description on hover tooltip */
+  showDescription: zod.z.boolean().default(true).describe("Show description tooltip on hover")
+});
+var ERDiagramConfigSchema = zod.z.object({
+  /** Enable the ER diagram panel */
+  enabled: zod.z.boolean().default(true).describe("Enable ER diagram panel"),
+  /** Default layout algorithm */
+  layout: ERLayoutAlgorithmSchema.default("force").describe("Default layout algorithm"),
+  /** Node display options */
+  nodeDisplay: ERNodeDisplaySchema.default({
+    showFields: true,
+    maxFieldsVisible: 8,
+    showFieldTypes: true,
+    showRequiredIndicator: true,
+    showRecordCount: false,
+    showIcon: true,
+    showDescription: true
+  }).describe("Node display configuration"),
+  /** Show minimap for navigation */
+  showMinimap: zod.z.boolean().default(true).describe("Show minimap for large diagrams"),
+  /** Enable zoom controls */
+  zoomControls: zod.z.boolean().default(true).describe("Show zoom in/out/fit controls"),
+  /** Minimum zoom level */
+  minZoom: zod.z.number().default(0.1).describe("Minimum zoom level"),
+  /** Maximum zoom level */
+  maxZoom: zod.z.number().default(3).describe("Maximum zoom level"),
+  /** Show relationship labels (cardinality) on edges */
+  showEdgeLabels: zod.z.boolean().default(true).describe("Show cardinality labels on relationship edges"),
+  /** Highlight connected entities on hover */
+  highlightOnHover: zod.z.boolean().default(true).describe("Highlight connected entities on node hover"),
+  /** Click behavior: navigate to object designer */
+  clickToNavigate: zod.z.boolean().default(true).describe("Click node to navigate to object detail"),
+  /** Enable drag-and-drop to create relationships */
+  dragToConnect: zod.z.boolean().default(true).describe("Drag between nodes to create relationships"),
+  /** Filter to show only objects with relationships (hide orphans) */
+  hideOrphans: zod.z.boolean().default(false).describe("Hide objects with no relationships"),
+  /** Auto-fit diagram to viewport on initial load */
+  autoFit: zod.z.boolean().default(true).describe("Auto-fit diagram to viewport on load"),
+  /** Export diagram options */
+  exportFormats: zod.z.array(zod.z.enum(["png", "svg", "json"])).default(["png", "svg"]).describe("Available export formats for diagram")
+});
+var ObjectListDisplayModeSchema = zod.z.enum([
+  "table",
+  // Traditional table with columns
+  "cards",
+  // Card grid (visual overview)
+  "tree"
+  // Hierarchical tree (grouped by package/namespace)
+]).describe("Object list display mode");
+var ObjectSortFieldSchema = zod.z.enum([
+  "name",
+  // Sort by API name
+  "label",
+  // Sort by display label
+  "fieldCount",
+  // Sort by number of fields
+  "updatedAt"
+  // Sort by last modified
+]).describe("Object list sort field");
+var ObjectFilterSchema = zod.z.object({
+  /** Filter by package/namespace */
+  package: zod.z.string().optional().describe("Filter by owning package"),
+  /** Filter by tags */
+  tags: zod.z.array(zod.z.string()).optional().describe("Filter by object tags"),
+  /** Show system objects */
+  includeSystem: zod.z.boolean().default(false).describe("Include system-level objects"),
+  /** Show abstract objects */
+  includeAbstract: zod.z.boolean().default(false).describe("Include abstract base objects"),
+  /** Show only objects with specific field types */
+  hasFieldType: zod.z.string().optional().describe("Filter to objects containing a specific field type"),
+  /** Show only objects with relationships */
+  hasRelationships: zod.z.boolean().optional().describe("Filter to objects with lookup/master_detail fields"),
+  /** Text search across name, label, description */
+  searchQuery: zod.z.string().optional().describe("Free-text search across name, label, and description")
+});
+var ObjectManagerConfigSchema = zod.z.object({
+  /** Default display mode */
+  defaultDisplayMode: ObjectListDisplayModeSchema.default("table").describe("Default list display mode"),
+  /** Default sort field */
+  defaultSortField: ObjectSortFieldSchema.default("label").describe("Default sort field"),
+  /** Default sort direction */
+  defaultSortDirection: zod.z.enum(["asc", "desc"]).default("asc").describe("Default sort direction"),
+  /** Default filters */
+  defaultFilter: ObjectFilterSchema.default({
+    includeSystem: false,
+    includeAbstract: false
+  }).describe("Default filter configuration"),
+  /** Show field count badge on each object row */
+  showFieldCount: zod.z.boolean().default(true).describe("Show field count badge"),
+  /** Show relationship count badge */
+  showRelationshipCount: zod.z.boolean().default(true).describe("Show relationship count badge"),
+  /** Show quick-preview tooltip with field list on hover */
+  showQuickPreview: zod.z.boolean().default(true).describe("Show quick field preview tooltip on hover"),
+  /** Enable object comparison (diff two objects side-by-side) */
+  enableComparison: zod.z.boolean().default(false).describe("Enable side-by-side object comparison"),
+  /** Show ER diagram toggle button in the toolbar */
+  showERDiagramToggle: zod.z.boolean().default(true).describe("Show ER diagram toggle in toolbar"),
+  /** Show "Create Object" quick action */
+  showCreateAction: zod.z.boolean().default(true).describe("Show create object action"),
+  /** Show object statistics summary bar (total objects, fields, relationships) */
+  showStatsSummary: zod.z.boolean().default(true).describe("Show statistics summary bar")
+});
+var ObjectPreviewTabSchema = zod.z.object({
+  /** Tab key */
+  key: zod.z.string().describe("Tab key"),
+  /** Tab display label */
+  label: zod.z.string().describe("Tab display label"),
+  /** Lucide icon name */
+  icon: zod.z.string().optional().describe("Lucide icon name"),
+  /** Whether this tab is enabled */
+  enabled: zod.z.boolean().default(true).describe("Whether this tab is available"),
+  /** Sort order */
+  order: zod.z.number().default(0).describe("Sort order (lower = higher)")
+});
+var ObjectPreviewConfigSchema = zod.z.object({
+  /** Tabs to show in the object detail view */
+  tabs: zod.z.array(ObjectPreviewTabSchema).default([
+    { key: "fields", label: "Fields", icon: "list", enabled: true, order: 0 },
+    { key: "relationships", label: "Relationships", icon: "link", enabled: true, order: 10 },
+    { key: "indexes", label: "Indexes", icon: "zap", enabled: true, order: 20 },
+    { key: "validations", label: "Validations", icon: "shield-check", enabled: true, order: 30 },
+    { key: "capabilities", label: "Capabilities", icon: "settings", enabled: true, order: 40 },
+    { key: "data", label: "Data", icon: "table-2", enabled: true, order: 50 },
+    { key: "api", label: "API", icon: "globe", enabled: true, order: 60 },
+    { key: "code", label: "Code", icon: "code-2", enabled: true, order: 70 }
+  ]).describe("Object detail preview tabs"),
+  /** Default active tab */
+  defaultTab: zod.z.string().default("fields").describe("Default active tab key"),
+  /** Show object header with summary info */
+  showHeader: zod.z.boolean().default(true).describe("Show object summary header"),
+  /** Show breadcrumbs */
+  showBreadcrumbs: zod.z.boolean().default(true).describe("Show navigation breadcrumbs")
+});
+var ObjectDesignerDefaultViewSchema = zod.z.enum([
+  "field-editor",
+  // Field table editor (default)
+  "relationship-mapper",
+  // Visual relationship view
+  "er-diagram",
+  // Full ER diagram
+  "object-manager"
+  // Object list/manager
+]).describe("Default view when entering the Object Designer");
+var ObjectDesignerConfigSchema = zod.z.object({
+  /** Default view when opening the designer */
+  defaultView: ObjectDesignerDefaultViewSchema.default("field-editor").describe("Default view"),
+  /** Field editor configuration */
+  fieldEditor: FieldEditorConfigSchema.default({
+    inlineEditing: true,
+    dragReorder: true,
+    showFieldGroups: true,
+    showPropertyPanel: true,
+    propertySections: [
+      { key: "basics", label: "Basic Properties", defaultExpanded: true, order: 0 },
+      { key: "constraints", label: "Constraints & Validation", defaultExpanded: true, order: 10 },
+      { key: "relationship", label: "Relationship Config", defaultExpanded: true, order: 20 },
+      { key: "display", label: "Display & UI", defaultExpanded: false, order: 30 },
+      { key: "security", label: "Security & Compliance", defaultExpanded: false, order: 40 },
+      { key: "advanced", label: "Advanced", defaultExpanded: false, order: 50 }
+    ],
+    fieldGroups: [],
+    paginationThreshold: 50,
+    batchOperations: true,
+    showUsageStats: false
+  }).describe("Field editor configuration"),
+  /** Relationship mapper configuration */
+  relationshipMapper: RelationshipMapperConfigSchema.default({
+    visualCreation: true,
+    showReverseRelationships: true,
+    showCascadeWarnings: true,
+    displayConfig: [
+      { type: "lookup", lineStyle: "dashed", color: "#0891b2", highlightColor: "#06b6d4", cardinalityLabel: "1:N" },
+      { type: "master_detail", lineStyle: "solid", color: "#ea580c", highlightColor: "#f97316", cardinalityLabel: "1:N" },
+      { type: "tree", lineStyle: "dotted", color: "#8b5cf6", highlightColor: "#a78bfa", cardinalityLabel: "1:N" }
+    ]
+  }).describe("Relationship mapper configuration"),
+  /** ER diagram configuration */
+  erDiagram: ERDiagramConfigSchema.default({
+    enabled: true,
+    layout: "force",
+    nodeDisplay: {
+      showFields: true,
+      maxFieldsVisible: 8,
+      showFieldTypes: true,
+      showRequiredIndicator: true,
+      showRecordCount: false,
+      showIcon: true,
+      showDescription: true
+    },
+    showMinimap: true,
+    zoomControls: true,
+    minZoom: 0.1,
+    maxZoom: 3,
+    showEdgeLabels: true,
+    highlightOnHover: true,
+    clickToNavigate: true,
+    dragToConnect: true,
+    hideOrphans: false,
+    autoFit: true,
+    exportFormats: ["png", "svg"]
+  }).describe("ER diagram configuration"),
+  /** Object manager configuration */
+  objectManager: ObjectManagerConfigSchema.default({
+    defaultDisplayMode: "table",
+    defaultSortField: "label",
+    defaultSortDirection: "asc",
+    defaultFilter: {
+      includeSystem: false,
+      includeAbstract: false
+    },
+    showFieldCount: true,
+    showRelationshipCount: true,
+    showQuickPreview: true,
+    enableComparison: false,
+    showERDiagramToggle: true,
+    showCreateAction: true,
+    showStatsSummary: true
+  }).describe("Object manager configuration"),
+  /** Object preview configuration */
+  objectPreview: ObjectPreviewConfigSchema.default({
+    tabs: [
+      { key: "fields", label: "Fields", icon: "list", enabled: true, order: 0 },
+      { key: "relationships", label: "Relationships", icon: "link", enabled: true, order: 10 },
+      { key: "indexes", label: "Indexes", icon: "zap", enabled: true, order: 20 },
+      { key: "validations", label: "Validations", icon: "shield-check", enabled: true, order: 30 },
+      { key: "capabilities", label: "Capabilities", icon: "settings", enabled: true, order: 40 },
+      { key: "data", label: "Data", icon: "table-2", enabled: true, order: 50 },
+      { key: "api", label: "API", icon: "globe", enabled: true, order: 60 },
+      { key: "code", label: "Code", icon: "code-2", enabled: true, order: 70 }
+    ],
+    defaultTab: "fields",
+    showHeader: true,
+    showBreadcrumbs: true
+  }).describe("Object preview configuration")
+});
+function defineObjectDesignerConfig(input) {
+  return ObjectDesignerConfigSchema.parse(input);
+}
 var ObjectStackDefinitionSchema = zod.z.object({
   /** System Configuration */
   manifest: ManifestSchema.optional().describe("Project Package Configuration"),
@@ -34097,10 +34539,11 @@ function validateCrossReferences(config) {
 }
 function defineStack(config, options) {
   const strict = options?.strict !== false;
+  const normalized = normalizeStackInput(config);
   if (!strict) {
-    return config;
+    return normalized;
   }
-  const result = ObjectStackDefinitionSchema.safeParse(config, {
+  const result = ObjectStackDefinitionSchema.safeParse(normalized, {
     error: objectStackErrorMap
   });
   if (!result.success) {
@@ -34241,6 +34684,8 @@ exports.Data = data_exports;
 exports.Identity = identity_exports;
 exports.Integration = integration_exports;
 exports.Kernel = kernel_exports;
+exports.MAP_SUPPORTED_FIELDS = MAP_SUPPORTED_FIELDS;
+exports.METADATA_ALIASES = METADATA_ALIASES;
 exports.ObjectOSCapabilitiesSchema = ObjectOSCapabilitiesSchema;
 exports.ObjectQLCapabilitiesSchema = ObjectQLCapabilitiesSchema;
 exports.ObjectStackCapabilitiesSchema = ObjectStackCapabilitiesSchema;
@@ -34262,6 +34707,9 @@ exports.findClosestMatches = findClosestMatches;
 exports.formatSuggestion = formatSuggestion;
 exports.formatZodError = formatZodError;
 exports.formatZodIssue = formatZodIssue;
+exports.normalizeMetadataCollection = normalizeMetadataCollection;
+exports.normalizePluginMetadata = normalizePluginMetadata;
+exports.normalizeStackInput = normalizeStackInput;
 exports.objectStackErrorMap = objectStackErrorMap;
 exports.safeParsePretty = safeParsePretty;
 exports.suggestFieldType = suggestFieldType;