@objectstack/spec 6.7.1 → 6.8.1

package/dist/{app.zod-nPfH1TcS.d.ts → app.zod-CLlpb0AH.d.ts}

@@ -42,6 +42,10 @@ declare const ViewDataSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     provider: z.ZodLiteral<"value">;
     items: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    provider: z.ZodLiteral<"schema">;
+    schemaId: z.ZodString;
+    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>], "provider">;
 /**
  * View Filter Rule Schema
@@ -473,6 +477,10 @@ declare const ListViewSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         provider: z.ZodLiteral<"value">;
         items: z.ZodArray<z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        provider: z.ZodLiteral<"schema">;
+        schemaId: z.ZodString;
+        schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>], "provider">>;
     columns: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
         field: z.ZodString;
@@ -800,19 +808,30 @@ declare const ListViewSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Form Field Configuration Schema
- * Detailed configuration for individual form fields
+ * Detailed configuration for individual form fields.
+ *
+ * Reuses Data.FieldType and related constraints from the Data protocol to avoid duplication.
+ * The `type` field auto-infers widget rendering; explicit `widget` overrides are only needed
+ * for custom components.
+ *
+ * @example Auto-inferred select widget
+ * { field: 'status', type: 'select', options: [{ label: 'Open', value: 'open' }] }
+ *
+ * @example Lookup field with reference
+ * { field: 'account_id', type: 'lookup', reference: 'account', label: 'Account' }
+ *
+ * @example Custom widget override
+ * { field: 'filter', widget: 'filter-builder' }
  */
-declare const FormFieldSchema: z.ZodObject<{
-    field: z.ZodString;
+declare const FormFieldSchema: z.ZodType<any>;
+/**
+ * Form Layout Section
+ */
+declare const FormSectionSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
-    placeholder: z.ZodOptional<z.ZodString>;
-    helpText: z.ZodOptional<z.ZodString>;
-    readonly: z.ZodOptional<z.ZodBoolean>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    hidden: z.ZodOptional<z.ZodBoolean>;
-    colSpan: z.ZodOptional<z.ZodNumber>;
-    widget: z.ZodOptional<z.ZodString>;
-    dependsOn: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    collapsible: z.ZodDefault<z.ZodBoolean>;
+    collapsed: z.ZodDefault<z.ZodBoolean>;
     visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
         dialect: "cel" | "js" | "cron" | "template";
         source?: string | undefined;
@@ -835,54 +854,13 @@ declare const FormFieldSchema: z.ZodObject<{
             generatedBy: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>]>>;
-}, z.core.$strip>;
-/**
- * Form Layout Section
- */
-declare const FormSectionSchema: z.ZodObject<{
-    label: z.ZodOptional<z.ZodString>;
-    collapsible: z.ZodDefault<z.ZodBoolean>;
-    collapsed: z.ZodDefault<z.ZodBoolean>;
     columns: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
         1: "1";
         2: "2";
         3: "3";
         4: "4";
     }>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>, z.ZodTransform<4 | 1 | 2 | 3, "1" | "2" | "3" | 4 | 1 | 2 | "4" | 3>>;
-    fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        field: z.ZodString;
-        label: z.ZodOptional<z.ZodString>;
-        placeholder: z.ZodOptional<z.ZodString>;
-        helpText: z.ZodOptional<z.ZodString>;
-        readonly: z.ZodOptional<z.ZodBoolean>;
-        required: z.ZodOptional<z.ZodBoolean>;
-        hidden: z.ZodOptional<z.ZodBoolean>;
-        colSpan: z.ZodOptional<z.ZodNumber>;
-        widget: z.ZodOptional<z.ZodString>;
-        dependsOn: z.ZodOptional<z.ZodString>;
-        visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
-            dialect: "cel" | "js" | "cron" | "template";
-            source?: string | undefined;
-            ast?: unknown;
-            meta?: {
-                rationale?: string | undefined;
-                generatedBy?: string | undefined;
-            } | undefined;
-        }, string>>, z.ZodObject<{
-            dialect: z.ZodEnum<{
-                cel: "cel";
-                js: "js";
-                cron: "cron";
-                template: "template";
-            }>;
-            source: z.ZodOptional<z.ZodString>;
-            ast: z.ZodOptional<z.ZodUnknown>;
-            meta: z.ZodOptional<z.ZodObject<{
-                rationale: z.ZodOptional<z.ZodString>;
-                generatedBy: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>]>>;
-    }, z.core.$strip>]>>;
+    fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>]>>;
 }, z.core.$strip>;
 /**
  * Form View Schema
@@ -947,96 +925,80 @@ declare const FormViewSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         provider: z.ZodLiteral<"value">;
         items: z.ZodArray<z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        provider: z.ZodLiteral<"schema">;
+        schemaId: z.ZodString;
+        schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>], "provider">>;
     sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         collapsible: z.ZodDefault<z.ZodBoolean>;
         collapsed: z.ZodDefault<z.ZodBoolean>;
+        visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        }, string>>, z.ZodObject<{
+            dialect: z.ZodEnum<{
+                cel: "cel";
+                js: "js";
+                cron: "cron";
+                template: "template";
+            }>;
+            source: z.ZodOptional<z.ZodString>;
+            ast: z.ZodOptional<z.ZodUnknown>;
+            meta: z.ZodOptional<z.ZodObject<{
+                rationale: z.ZodOptional<z.ZodString>;
+                generatedBy: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>;
         columns: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
             1: "1";
             2: "2";
             3: "3";
             4: "4";
         }>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>, z.ZodTransform<4 | 1 | 2 | 3, "1" | "2" | "3" | 4 | 1 | 2 | "4" | 3>>;
-        fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            field: z.ZodString;
-            label: z.ZodOptional<z.ZodString>;
-            placeholder: z.ZodOptional<z.ZodString>;
-            helpText: z.ZodOptional<z.ZodString>;
-            readonly: z.ZodOptional<z.ZodBoolean>;
-            required: z.ZodOptional<z.ZodBoolean>;
-            hidden: z.ZodOptional<z.ZodBoolean>;
-            colSpan: z.ZodOptional<z.ZodNumber>;
-            widget: z.ZodOptional<z.ZodString>;
-            dependsOn: z.ZodOptional<z.ZodString>;
-            visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
-                dialect: "cel" | "js" | "cron" | "template";
-                source?: string | undefined;
-                ast?: unknown;
-                meta?: {
-                    rationale?: string | undefined;
-                    generatedBy?: string | undefined;
-                } | undefined;
-            }, string>>, z.ZodObject<{
-                dialect: z.ZodEnum<{
-                    cel: "cel";
-                    js: "js";
-                    cron: "cron";
-                    template: "template";
-                }>;
-                source: z.ZodOptional<z.ZodString>;
-                ast: z.ZodOptional<z.ZodUnknown>;
-                meta: z.ZodOptional<z.ZodObject<{
-                    rationale: z.ZodOptional<z.ZodString>;
-                    generatedBy: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>>;
-            }, z.core.$strip>]>>;
-        }, z.core.$strip>]>>;
+        fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>]>>;
     }, z.core.$strip>>>;
     groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         collapsible: z.ZodDefault<z.ZodBoolean>;
         collapsed: z.ZodDefault<z.ZodBoolean>;
+        visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        }, string>>, z.ZodObject<{
+            dialect: z.ZodEnum<{
+                cel: "cel";
+                js: "js";
+                cron: "cron";
+                template: "template";
+            }>;
+            source: z.ZodOptional<z.ZodString>;
+            ast: z.ZodOptional<z.ZodUnknown>;
+            meta: z.ZodOptional<z.ZodObject<{
+                rationale: z.ZodOptional<z.ZodString>;
+                generatedBy: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>;
         columns: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
             1: "1";
             2: "2";
             3: "3";
             4: "4";
         }>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>, z.ZodTransform<4 | 1 | 2 | 3, "1" | "2" | "3" | 4 | 1 | 2 | "4" | 3>>;
-        fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            field: z.ZodString;
-            label: z.ZodOptional<z.ZodString>;
-            placeholder: z.ZodOptional<z.ZodString>;
-            helpText: z.ZodOptional<z.ZodString>;
-            readonly: z.ZodOptional<z.ZodBoolean>;
-            required: z.ZodOptional<z.ZodBoolean>;
-            hidden: z.ZodOptional<z.ZodBoolean>;
-            colSpan: z.ZodOptional<z.ZodNumber>;
-            widget: z.ZodOptional<z.ZodString>;
-            dependsOn: z.ZodOptional<z.ZodString>;
-            visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
-                dialect: "cel" | "js" | "cron" | "template";
-                source?: string | undefined;
-                ast?: unknown;
-                meta?: {
-                    rationale?: string | undefined;
-                    generatedBy?: string | undefined;
-                } | undefined;
-            }, string>>, z.ZodObject<{
-                dialect: z.ZodEnum<{
-                    cel: "cel";
-                    js: "js";
-                    cron: "cron";
-                    template: "template";
-                }>;
-                source: z.ZodOptional<z.ZodString>;
-                ast: z.ZodOptional<z.ZodUnknown>;
-                meta: z.ZodOptional<z.ZodObject<{
-                    rationale: z.ZodOptional<z.ZodString>;
-                    generatedBy: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>>;
-            }, z.core.$strip>]>>;
-        }, z.core.$strip>]>>;
+        fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>]>>;
     }, z.core.$strip>>>;
     defaultSort: z.ZodOptional<z.ZodArray<z.ZodObject<{
         field: z.ZodString;
@@ -1138,6 +1100,10 @@ declare const ViewSchema: z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             provider: z.ZodLiteral<"value">;
             items: z.ZodArray<z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            provider: z.ZodLiteral<"schema">;
+            schemaId: z.ZodString;
+            schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>], "provider">>;
         columns: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
             field: z.ZodString;
@@ -1506,96 +1472,80 @@ declare const ViewSchema: z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             provider: z.ZodLiteral<"value">;
             items: z.ZodArray<z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            provider: z.ZodLiteral<"schema">;
+            schemaId: z.ZodString;
+            schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>], "provider">>;
         sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
             collapsible: z.ZodDefault<z.ZodBoolean>;
             collapsed: z.ZodDefault<z.ZodBoolean>;
+            visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            }, string>>, z.ZodObject<{
+                dialect: z.ZodEnum<{
+                    cel: "cel";
+                    js: "js";
+                    cron: "cron";
+                    template: "template";
+                }>;
+                source: z.ZodOptional<z.ZodString>;
+                ast: z.ZodOptional<z.ZodUnknown>;
+                meta: z.ZodOptional<z.ZodObject<{
+                    rationale: z.ZodOptional<z.ZodString>;
+                    generatedBy: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
             columns: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
                 1: "1";
                 2: "2";
                 3: "3";
                 4: "4";
             }>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>, z.ZodTransform<4 | 1 | 2 | 3, "1" | "2" | "3" | 4 | 1 | 2 | "4" | 3>>;
-            fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                field: z.ZodString;
-                label: z.ZodOptional<z.ZodString>;
-                placeholder: z.ZodOptional<z.ZodString>;
-                helpText: z.ZodOptional<z.ZodString>;
-                readonly: z.ZodOptional<z.ZodBoolean>;
-                required: z.ZodOptional<z.ZodBoolean>;
-                hidden: z.ZodOptional<z.ZodBoolean>;
-                colSpan: z.ZodOptional<z.ZodNumber>;
-                widget: z.ZodOptional<z.ZodString>;
-                dependsOn: z.ZodOptional<z.ZodString>;
-                visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
-                    dialect: "cel" | "js" | "cron" | "template";
-                    source?: string | undefined;
-                    ast?: unknown;
-                    meta?: {
-                        rationale?: string | undefined;
-                        generatedBy?: string | undefined;
-                    } | undefined;
-                }, string>>, z.ZodObject<{
-                    dialect: z.ZodEnum<{
-                        cel: "cel";
-                        js: "js";
-                        cron: "cron";
-                        template: "template";
-                    }>;
-                    source: z.ZodOptional<z.ZodString>;
-                    ast: z.ZodOptional<z.ZodUnknown>;
-                    meta: z.ZodOptional<z.ZodObject<{
-                        rationale: z.ZodOptional<z.ZodString>;
-                        generatedBy: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strip>>;
-                }, z.core.$strip>]>>;
-            }, z.core.$strip>]>>;
+            fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>]>>;
         }, z.core.$strip>>>;
         groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
             collapsible: z.ZodDefault<z.ZodBoolean>;
             collapsed: z.ZodDefault<z.ZodBoolean>;
+            visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            }, string>>, z.ZodObject<{
+                dialect: z.ZodEnum<{
+                    cel: "cel";
+                    js: "js";
+                    cron: "cron";
+                    template: "template";
+                }>;
+                source: z.ZodOptional<z.ZodString>;
+                ast: z.ZodOptional<z.ZodUnknown>;
+                meta: z.ZodOptional<z.ZodObject<{
+                    rationale: z.ZodOptional<z.ZodString>;
+                    generatedBy: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
             columns: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
                 1: "1";
                 2: "2";
                 3: "3";
                 4: "4";
             }>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>, z.ZodTransform<4 | 1 | 2 | 3, "1" | "2" | "3" | 4 | 1 | 2 | "4" | 3>>;
-            fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                field: z.ZodString;
-                label: z.ZodOptional<z.ZodString>;
-                placeholder: z.ZodOptional<z.ZodString>;
-                helpText: z.ZodOptional<z.ZodString>;
-                readonly: z.ZodOptional<z.ZodBoolean>;
-                required: z.ZodOptional<z.ZodBoolean>;
-                hidden: z.ZodOptional<z.ZodBoolean>;
-                colSpan: z.ZodOptional<z.ZodNumber>;
-                widget: z.ZodOptional<z.ZodString>;
-                dependsOn: z.ZodOptional<z.ZodString>;
-                visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
-                    dialect: "cel" | "js" | "cron" | "template";
-                    source?: string | undefined;
-                    ast?: unknown;
-                    meta?: {
-                        rationale?: string | undefined;
-                        generatedBy?: string | undefined;
-                    } | undefined;
-                }, string>>, z.ZodObject<{
-                    dialect: z.ZodEnum<{
-                        cel: "cel";
-                        js: "js";
-                        cron: "cron";
-                        template: "template";
-                    }>;
-                    source: z.ZodOptional<z.ZodString>;
-                    ast: z.ZodOptional<z.ZodUnknown>;
-                    meta: z.ZodOptional<z.ZodObject<{
-                        rationale: z.ZodOptional<z.ZodString>;
-                        generatedBy: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strip>>;
-                }, z.core.$strip>]>>;
-            }, z.core.$strip>]>>;
+            fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>]>>;
         }, z.core.$strip>>>;
         defaultSort: z.ZodOptional<z.ZodArray<z.ZodObject<{
             field: z.ZodString;
@@ -1678,6 +1628,10 @@ declare const ViewSchema: z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             provider: z.ZodLiteral<"value">;
             items: z.ZodArray<z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            provider: z.ZodLiteral<"schema">;
+            schemaId: z.ZodString;
+            schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>], "provider">>;
         columns: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
             field: z.ZodString;
@@ -2046,96 +2000,80 @@ declare const ViewSchema: z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             provider: z.ZodLiteral<"value">;
             items: z.ZodArray<z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            provider: z.ZodLiteral<"schema">;
+            schemaId: z.ZodString;
+            schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>], "provider">>;
         sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
             collapsible: z.ZodDefault<z.ZodBoolean>;
             collapsed: z.ZodDefault<z.ZodBoolean>;
+            visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            }, string>>, z.ZodObject<{
+                dialect: z.ZodEnum<{
+                    cel: "cel";
+                    js: "js";
+                    cron: "cron";
+                    template: "template";
+                }>;
+                source: z.ZodOptional<z.ZodString>;
+                ast: z.ZodOptional<z.ZodUnknown>;
+                meta: z.ZodOptional<z.ZodObject<{
+                    rationale: z.ZodOptional<z.ZodString>;
+                    generatedBy: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
             columns: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
                 1: "1";
                 2: "2";
                 3: "3";
                 4: "4";
             }>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>, z.ZodTransform<4 | 1 | 2 | 3, "1" | "2" | "3" | 4 | 1 | 2 | "4" | 3>>;
-            fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                field: z.ZodString;
-                label: z.ZodOptional<z.ZodString>;
-                placeholder: z.ZodOptional<z.ZodString>;
-                helpText: z.ZodOptional<z.ZodString>;
-                readonly: z.ZodOptional<z.ZodBoolean>;
-                required: z.ZodOptional<z.ZodBoolean>;
-                hidden: z.ZodOptional<z.ZodBoolean>;
-                colSpan: z.ZodOptional<z.ZodNumber>;
-                widget: z.ZodOptional<z.ZodString>;
-                dependsOn: z.ZodOptional<z.ZodString>;
-                visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
-                    dialect: "cel" | "js" | "cron" | "template";
-                    source?: string | undefined;
-                    ast?: unknown;
-                    meta?: {
-                        rationale?: string | undefined;
-                        generatedBy?: string | undefined;
-                    } | undefined;
-                }, string>>, z.ZodObject<{
-                    dialect: z.ZodEnum<{
-                        cel: "cel";
-                        js: "js";
-                        cron: "cron";
-                        template: "template";
-                    }>;
-                    source: z.ZodOptional<z.ZodString>;
-                    ast: z.ZodOptional<z.ZodUnknown>;
-                    meta: z.ZodOptional<z.ZodObject<{
-                        rationale: z.ZodOptional<z.ZodString>;
-                        generatedBy: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strip>>;
-                }, z.core.$strip>]>>;
-            }, z.core.$strip>]>>;
+            fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>]>>;
         }, z.core.$strip>>>;
         groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
             collapsible: z.ZodDefault<z.ZodBoolean>;
             collapsed: z.ZodDefault<z.ZodBoolean>;
+            visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            }, string>>, z.ZodObject<{
+                dialect: z.ZodEnum<{
+                    cel: "cel";
+                    js: "js";
+                    cron: "cron";
+                    template: "template";
+                }>;
+                source: z.ZodOptional<z.ZodString>;
+                ast: z.ZodOptional<z.ZodUnknown>;
+                meta: z.ZodOptional<z.ZodObject<{
+                    rationale: z.ZodOptional<z.ZodString>;
+                    generatedBy: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
             columns: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
                 1: "1";
                 2: "2";
                 3: "3";
                 4: "4";
             }>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>, z.ZodTransform<4 | 1 | 2 | 3, "1" | "2" | "3" | 4 | 1 | 2 | "4" | 3>>;
-            fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                field: z.ZodString;
-                label: z.ZodOptional<z.ZodString>;
-                placeholder: z.ZodOptional<z.ZodString>;
-                helpText: z.ZodOptional<z.ZodString>;
-                readonly: z.ZodOptional<z.ZodBoolean>;
-                required: z.ZodOptional<z.ZodBoolean>;
-                hidden: z.ZodOptional<z.ZodBoolean>;
-                colSpan: z.ZodOptional<z.ZodNumber>;
-                widget: z.ZodOptional<z.ZodString>;
-                dependsOn: z.ZodOptional<z.ZodString>;
-                visibleOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
-                    dialect: "cel" | "js" | "cron" | "template";
-                    source?: string | undefined;
-                    ast?: unknown;
-                    meta?: {
-                        rationale?: string | undefined;
-                        generatedBy?: string | undefined;
-                    } | undefined;
-                }, string>>, z.ZodObject<{
-                    dialect: z.ZodEnum<{
-                        cel: "cel";
-                        js: "js";
-                        cron: "cron";
-                        template: "template";
-                    }>;
-                    source: z.ZodOptional<z.ZodString>;
-                    ast: z.ZodOptional<z.ZodUnknown>;
-                    meta: z.ZodOptional<z.ZodObject<{
-                        rationale: z.ZodOptional<z.ZodString>;
-                        generatedBy: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strip>>;
-                }, z.core.$strip>]>>;
-            }, z.core.$strip>]>>;
+            fields: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>]>>;
         }, z.core.$strip>>>;
         defaultSort: z.ZodOptional<z.ZodArray<z.ZodObject<{
             field: z.ZodString;
@@ -2193,6 +2131,44 @@ declare const ViewSchema: z.ZodObject<{
  * ```
  */
 declare function defineView(config: z.input<typeof ViewSchema>): View;
+/**
+ * Type-safe factory for a standalone {@link FormView} bound to a JSON Schema
+ * rather than to an ObjectQL object.
+ *
+ * Use this for forms that edit **metadata** (e.g. `report.form.ts`,
+ * `dashboard.form.ts`), **action inputs**, or **flow screens** — anywhere the
+ * data shape is described by a Zod-derived JSON Schema instead of an Object
+ * field set.
+ *
+ * The returned FormView is validated at definition time; the runtime form
+ * renderer (`@object-ui/plugin-form`) inspects `data.provider === 'schema'`
+ * and pulls field metadata from the resolved JSON Schema instead of from
+ * ObjectQL.
+ *
+ * @example
+ * ```ts
+ * export const reportForm = defineForm({
+ *   schemaId: 'report',
+ *   type: 'tabbed',
+ *   sections: [
+ *     { label: 'Basics', columns: 2, fields: [
+ *       { field: 'name' },
+ *       { field: 'label' },
+ *       { field: 'objectName', widget: 'ref:object' },
+ *       { field: 'type' },
+ *     ]},
+ *     { label: 'Columns', fields: [{ field: 'columns', widget: 'master-detail' }] },
+ *     { label: 'Advanced', collapsible: true, collapsed: true, fields: [
+ *       { field: 'filter', widget: 'filter-builder' },
+ *       { field: 'chart', widget: 'chart-config' },
+ *     ]},
+ *   ],
+ * });
+ * ```
+ */
+declare function defineForm(config: Omit<z.input<typeof FormViewSchema>, 'data'> & {
+    schemaId: string;
+}): FormView;
 type View = z.infer<typeof ViewSchema>;
 type ListView = z.infer<typeof ListViewSchema>;
 type FormView = z.infer<typeof FormViewSchema>;
@@ -2457,7 +2433,61 @@ declare const ActionNavItemSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
- * 7. Group Navigation Item
+ * 7. Component Navigation Item
+ * Navigates to a built-in front-end component registered in the runtime's
+ * `ComponentRegistry` (e.g. `metadata:directory`, `metadata:resource`,
+ * `setup:permission_matrix`). Unlike `page` (which resolves a user-defined
+ * Page metadata record) and `url` (external link), `component` targets
+ * a first-party UI shipped with the platform — typically admin/setup
+ * surfaces that have no row in any data store.
+ *
+ * `params` are passed verbatim to the component as React props, so the
+ * same component (e.g. `metadata:resource`) can be reused across many
+ * nav entries with different `type` parameters.
+ *
+ * @example
+ * ```ts
+ * { id: 'nav_objects', type: 'component', label: 'Objects',
+ *   componentRef: 'metadata:resource', params: { type: 'object' } }
+ * ```
+ */
+declare const ComponentNavItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+    badge: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    visible: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<{
+        dialect: "cel" | "js" | "cron" | "template";
+        source?: string | undefined;
+        ast?: unknown;
+        meta?: {
+            rationale?: string | undefined;
+            generatedBy?: string | undefined;
+        } | undefined;
+    }, string>>, z.ZodObject<{
+        dialect: z.ZodEnum<{
+            cel: "cel";
+            js: "js";
+            cron: "cron";
+            template: "template";
+        }>;
+        source: z.ZodOptional<z.ZodString>;
+        ast: z.ZodOptional<z.ZodUnknown>;
+        meta: z.ZodOptional<z.ZodObject<{
+            rationale: z.ZodOptional<z.ZodString>;
+            generatedBy: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>;
+    requiredPermissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiresObject: z.ZodOptional<z.ZodString>;
+    requiresService: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"component">;
+    componentRef: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * 8. Group Navigation Item
  * A container for child navigation items (Sub-menu).
  * Does not perform navigation itself.
  */
@@ -2725,8 +2755,9 @@ type PageNavItem = z.infer<typeof PageNavItemSchema>;
 type UrlNavItem = z.infer<typeof UrlNavItemSchema>;
 type ReportNavItem = z.infer<typeof ReportNavItemSchema>;
 type ActionNavItem = z.infer<typeof ActionNavItemSchema>;
+type ComponentNavItem = z.infer<typeof ComponentNavItemSchema>;
 type GroupNavItem = z.infer<typeof GroupNavItemSchema> & {
     children: NavigationItem[];
 };
 
-export { ReportNavItemSchema as $, type ActionNavItem as A, ListChartConfigSchema as B, CalendarConfigSchema as C, type DashboardNavItem as D, type ListColumn as E, type FormField as F, type GalleryConfig as G, type HttpMethod as H, ListColumnSchema as I, type ListView as J, KanbanConfigSchema as K, type ListChartConfig as L, ListViewSchema as M, type NavigationArea as N, NavigationAreaSchema as O, type NavigationConfig as P, NavigationConfigSchema as Q, type NavigationItem as R, NavigationItemSchema as S, NavigationModeSchema as T, type ObjectNavItem as U, ObjectNavItemSchema as V, type PageNavItem as W, PageNavItemSchema as X, type PaginationConfig as Y, PaginationConfigSchema as Z, type ReportNavItem as _, ActionNavItemSchema as a, type RowColorConfig as a0, RowColorConfigSchema as a1, type RowHeight as a2, RowHeightSchema as a3, type SelectionConfig as a4, SelectionConfigSchema as a5, type TimelineConfig as a6, TimelineConfigSchema as a7, type UrlNavItem as a8, UrlNavItemSchema as a9, type UserActionsConfig as aa, UserActionsConfigSchema as ab, type View as ac, type ViewData as ad, ViewDataSchema as ae, type ViewFilterRule as af, ViewFilterRuleSchema as ag, ViewSchema as ah, type ViewSharing as ai, ViewSharingSchema as aj, type ViewTab as ak, ViewTabSchema as al, type VisualizationType as am, VisualizationTypeSchema as an, defineApp as ao, defineView as ap, type AddRecordConfig as b, AddRecordConfigSchema as c, App as d, type AppBranding as e, AppBrandingSchema as f, type AppInput as g, AppSchema as h, type AppearanceConfig as i, AppearanceConfigSchema as j, type ColumnSummary as k, ColumnSummarySchema as l, DashboardNavItemSchema as m, FormFieldSchema as n, type FormSection as o, FormSectionSchema as p, type FormView as q, FormViewSchema as r, GalleryConfigSchema as s, GanttConfigSchema as t, type GroupNavItem as u, GroupNavItemSchema as v, type GroupingConfig as w, GroupingConfigSchema as x, GroupingFieldSchema as y, type HttpRequest as z };
+export { PaginationConfigSchema as $, type ActionNavItem as A, GroupingFieldSchema as B, CalendarConfigSchema as C, type DashboardNavItem as D, type HttpRequest as E, type FormField as F, type GalleryConfig as G, type HttpMethod as H, ListChartConfigSchema as I, type ListColumn as J, KanbanConfigSchema as K, type ListChartConfig as L, ListColumnSchema as M, type ListView as N, ListViewSchema as O, type NavigationArea as P, NavigationAreaSchema as Q, type NavigationConfig as R, NavigationConfigSchema as S, type NavigationItem as T, NavigationItemSchema as U, NavigationModeSchema as V, type ObjectNavItem as W, ObjectNavItemSchema as X, type PageNavItem as Y, PageNavItemSchema as Z, type PaginationConfig as _, ActionNavItemSchema as a, type ReportNavItem as a0, ReportNavItemSchema as a1, type RowColorConfig as a2, RowColorConfigSchema as a3, type RowHeight as a4, RowHeightSchema as a5, type SelectionConfig as a6, SelectionConfigSchema as a7, type TimelineConfig as a8, TimelineConfigSchema as a9, type UrlNavItem as aa, UrlNavItemSchema as ab, type UserActionsConfig as ac, UserActionsConfigSchema as ad, type View as ae, type ViewData as af, ViewDataSchema as ag, type ViewFilterRule as ah, ViewFilterRuleSchema as ai, ViewSchema as aj, type ViewSharing as ak, ViewSharingSchema as al, type ViewTab as am, ViewTabSchema as an, type VisualizationType as ao, VisualizationTypeSchema as ap, defineApp as aq, defineForm as ar, defineView as as, type AddRecordConfig as b, AddRecordConfigSchema as c, App as d, type AppBranding as e, AppBrandingSchema as f, type AppInput as g, AppSchema as h, type AppearanceConfig as i, AppearanceConfigSchema as j, type ColumnSummary as k, ColumnSummarySchema as l, type ComponentNavItem as m, ComponentNavItemSchema as n, DashboardNavItemSchema as o, FormFieldSchema as p, type FormSection as q, FormSectionSchema as r, type FormView as s, FormViewSchema as t, GalleryConfigSchema as u, GanttConfigSchema as v, type GroupNavItem as w, GroupNavItemSchema as x, type GroupingConfig as y, GroupingConfigSchema as z };