@objectstack/spec 0.3.3 → 0.4.1

package/json-schema/ui/FieldWidgetProps.json

@@ -52,24 +52,34 @@
                 "datetime",
                 "time",
                 "boolean",
+                "toggle",
                 "select",
+                "multiselect",
+                "radio",
+                "checkboxes",
                 "lookup",
                 "master_detail",
+                "tree",
                 "image",
                 "file",
                 "avatar",
+                "video",
+                "audio",
                 "formula",
                 "summary",
                 "autonumber",
                 "location",
-                "geolocation",
                 "address",
                 "code",
+                "json",
                 "color",
                 "rating",
                 "slider",
                 "signature",
-                "qrcode"
+                "qrcode",
+                "progress",
+                "tags",
+                "vector"
               ],
               "description": "Field Data Type"
             },
@@ -135,11 +145,13 @@
                 "properties": {
                   "label": {
                     "type": "string",
-                    "description": "Display label"
+                    "description": "Display label (human-readable, any case allowed)"
                   },
                   "value": {
                     "type": "string",
-                    "description": "Stored value"
+                    "minLength": 2,
+                    "pattern": "^[a-z][a-z0-9_.]*$",
+                    "description": "Stored value (lowercase machine identifier)"
                   },
                   "color": {
                     "type": "string",
@@ -353,6 +365,52 @@
               "additionalProperties": false,
               "description": "Configuration for currency field type"
             },
+            "vectorConfig": {
+              "type": "object",
+              "properties": {
+                "dimensions": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 10000,
+                  "description": "Vector dimensionality (e.g., 1536 for OpenAI embeddings)"
+                },
+                "distanceMetric": {
+                  "type": "string",
+                  "enum": [
+                    "cosine",
+                    "euclidean",
+                    "dotProduct",
+                    "manhattan"
+                  ],
+                  "default": "cosine",
+                  "description": "Distance/similarity metric for vector search"
+                },
+                "normalized": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Whether vectors are normalized (unit length)"
+                },
+                "indexed": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Whether to create a vector index for fast similarity search"
+                },
+                "indexType": {
+                  "type": "string",
+                  "enum": [
+                    "hnsw",
+                    "ivfflat",
+                    "flat"
+                  ],
+                  "description": "Vector index algorithm (HNSW for high accuracy, IVFFlat for large datasets)"
+                }
+              },
+              "required": [
+                "dimensions"
+              ],
+              "additionalProperties": false,
+              "description": "Configuration for vector field type (AI/ML embeddings)"
+            },
             "hidden": {
               "type": "boolean",
               "default": false,

package/json-schema/ui/FormView.json

@@ -9,7 +9,10 @@
           "enum": [
             "simple",
             "tabbed",
-            "wizard"
+            "wizard",
+            "split",
+            "drawer",
+            "modal"
           ],
           "default": "simple"
         },

package/json-schema/ui/GroupNavItem.json

@@ -6,7 +6,9 @@
       "properties": {
         "id": {
           "type": "string",
-          "description": "Unique identifier for this navigation item"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique identifier for this navigation item (lowercase snake_case)"
         },
         "label": {
           "type": "string",

package/json-schema/ui/ListView.json

@@ -5,7 +5,10 @@
       "type": "object",
       "properties": {
         "name": {
-          "type": "string"
+          "type": "string",
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Internal view name (lowercase snake_case)"
         },
         "label": {
           "type": "string"
@@ -14,8 +17,11 @@
           "type": "string",
           "enum": [
             "grid",
+            "spreadsheet",
             "kanban",
+            "gallery",
             "calendar",
+            "timeline",
             "gantt",
             "map"
           ],

package/json-schema/ui/NavigationItem.json

@@ -8,7 +8,9 @@
           "properties": {
             "id": {
               "type": "string",
-              "description": "Unique identifier for this navigation item"
+              "minLength": 2,
+              "pattern": "^[a-z][a-z0-9_]*$",
+              "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
               "type": "string",
@@ -48,7 +50,9 @@
           "properties": {
             "id": {
               "type": "string",
-              "description": "Unique identifier for this navigation item"
+              "minLength": 2,
+              "pattern": "^[a-z][a-z0-9_]*$",
+              "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
               "type": "string",
@@ -84,7 +88,9 @@
           "properties": {
             "id": {
               "type": "string",
-              "description": "Unique identifier for this navigation item"
+              "minLength": 2,
+              "pattern": "^[a-z][a-z0-9_]*$",
+              "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
               "type": "string",
@@ -125,7 +131,9 @@
           "properties": {
             "id": {
               "type": "string",
-              "description": "Unique identifier for this navigation item"
+              "minLength": 2,
+              "pattern": "^[a-z][a-z0-9_]*$",
+              "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
               "type": "string",
@@ -170,7 +178,9 @@
           "properties": {
             "id": {
               "type": "string",
-              "description": "Unique identifier for this navigation item"
+              "minLength": 2,
+              "pattern": "^[a-z][a-z0-9_]*$",
+              "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
               "type": "string",

package/json-schema/ui/ObjectNavItem.json

@@ -6,7 +6,9 @@
       "properties": {
         "id": {
           "type": "string",
-          "description": "Unique identifier for this navigation item"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique identifier for this navigation item (lowercase snake_case)"
         },
         "label": {
           "type": "string",

package/json-schema/ui/Page.json

@@ -6,7 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Page unique name (lowercase snake_case)"
         },
         "label": {
           "type": "string"
@@ -57,8 +59,38 @@
                   "type": "object",
                   "properties": {
                     "type": {
-                      "type": "string",
-                      "description": "Component Type (e.g. \"steedos-labs.related-list\")"
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "page:header",
+                            "page:footer",
+                            "page:sidebar",
+                            "page:tabs",
+                            "page:accordion",
+                            "page:card",
+                            "page:section",
+                            "record:details",
+                            "record:highlights",
+                            "record:related_list",
+                            "record:activity",
+                            "record:chatter",
+                            "record:path",
+                            "app:launcher",
+                            "nav:menu",
+                            "nav:breadcrumb",
+                            "global:search",
+                            "global:notifications",
+                            "user:profile",
+                            "ai:chat_window",
+                            "ai:suggestion"
+                          ]
+                        },
+                        {
+                          "type": "string"
+                        }
+                      ],
+                      "description": "Component Type (Standard enum or custom string)"
                     },
                     "id": {
                       "type": "string",
@@ -70,7 +102,7 @@
                     "properties": {
                       "type": "object",
                       "additionalProperties": {},
-                      "description": "Component props passed to the widget"
+                      "description": "Component props passed to the widget. See block.zod.ts for schemas."
                     },
                     "visibility": {
                       "type": "string",

package/json-schema/ui/PageCardProps.json

@@ -0,0 +1,32 @@
+{
+  "$ref": "#/definitions/PageCardProps",
+  "definitions": {
+    "PageCardProps": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string"
+        },
+        "bordered": {
+          "type": "boolean",
+          "default": true
+        },
+        "actions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "children": {
+          "type": "array",
+          "description": "Card content"
+        }
+      },
+      "required": [
+        "children"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/PageComponent.json

@@ -5,8 +5,38 @@
       "type": "object",
       "properties": {
         "type": {
-          "type": "string",
-          "description": "Component Type (e.g. \"steedos-labs.related-list\")"
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "page:header",
+                "page:footer",
+                "page:sidebar",
+                "page:tabs",
+                "page:accordion",
+                "page:card",
+                "page:section",
+                "record:details",
+                "record:highlights",
+                "record:related_list",
+                "record:activity",
+                "record:chatter",
+                "record:path",
+                "app:launcher",
+                "nav:menu",
+                "nav:breadcrumb",
+                "global:search",
+                "global:notifications",
+                "user:profile",
+                "ai:chat_window",
+                "ai:suggestion"
+              ]
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "description": "Component Type (Standard enum or custom string)"
         },
         "id": {
           "type": "string",
@@ -18,7 +48,7 @@
         "properties": {
           "type": "object",
           "additionalProperties": {},
-          "description": "Component props passed to the widget"
+          "description": "Component props passed to the widget. See block.zod.ts for schemas."
         },
         "visibility": {
           "type": "string",

package/json-schema/ui/PageComponentType.json

@@ -0,0 +1,32 @@
+{
+  "$ref": "#/definitions/PageComponentType",
+  "definitions": {
+    "PageComponentType": {
+      "type": "string",
+      "enum": [
+        "page:header",
+        "page:footer",
+        "page:sidebar",
+        "page:tabs",
+        "page:accordion",
+        "page:card",
+        "page:section",
+        "record:details",
+        "record:highlights",
+        "record:related_list",
+        "record:activity",
+        "record:chatter",
+        "record:path",
+        "app:launcher",
+        "nav:menu",
+        "nav:breadcrumb",
+        "global:search",
+        "global:notifications",
+        "user:profile",
+        "ai:chat_window",
+        "ai:suggestion"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/PageHeaderProps.json

@@ -0,0 +1,39 @@
+{
+  "$ref": "#/definitions/PageHeaderProps",
+  "definitions": {
+    "PageHeaderProps": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Page title"
+        },
+        "subtitle": {
+          "type": "string",
+          "description": "Page subtitle"
+        },
+        "icon": {
+          "type": "string",
+          "description": "Icon name"
+        },
+        "breadcrumb": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show breadcrumb"
+        },
+        "actions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Action IDs to show in header"
+        }
+      },
+      "required": [
+        "title"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/PageNavItem.json

@@ -6,7 +6,9 @@
       "properties": {
         "id": {
           "type": "string",
-          "description": "Unique identifier for this navigation item"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique identifier for this navigation item (lowercase snake_case)"
         },
         "label": {
           "type": "string",

package/json-schema/ui/PageRegion.json

@@ -23,8 +23,38 @@
             "type": "object",
             "properties": {
               "type": {
-                "type": "string",
-                "description": "Component Type (e.g. \"steedos-labs.related-list\")"
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "enum": [
+                      "page:header",
+                      "page:footer",
+                      "page:sidebar",
+                      "page:tabs",
+                      "page:accordion",
+                      "page:card",
+                      "page:section",
+                      "record:details",
+                      "record:highlights",
+                      "record:related_list",
+                      "record:activity",
+                      "record:chatter",
+                      "record:path",
+                      "app:launcher",
+                      "nav:menu",
+                      "nav:breadcrumb",
+                      "global:search",
+                      "global:notifications",
+                      "user:profile",
+                      "ai:chat_window",
+                      "ai:suggestion"
+                    ]
+                  },
+                  {
+                    "type": "string"
+                  }
+                ],
+                "description": "Component Type (Standard enum or custom string)"
               },
               "id": {
                 "type": "string",
@@ -36,7 +66,7 @@
               "properties": {
                 "type": "object",
                 "additionalProperties": {},
-                "description": "Component props passed to the widget"
+                "description": "Component props passed to the widget. See block.zod.ts for schemas."
               },
               "visibility": {
                 "type": "string",

package/json-schema/ui/PageTabsProps.json

@@ -0,0 +1,55 @@
+{
+  "$ref": "#/definitions/PageTabsProps",
+  "definitions": {
+    "PageTabsProps": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "line",
+            "card",
+            "pill"
+          ],
+          "default": "line"
+        },
+        "position": {
+          "type": "string",
+          "enum": [
+            "top",
+            "left"
+          ],
+          "default": "top"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "icon": {
+                "type": "string"
+              },
+              "children": {
+                "type": "array",
+                "description": "Child components"
+              }
+            },
+            "required": [
+              "label",
+              "children"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "items"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/RecordDetailsProps.json

@@ -0,0 +1,37 @@
+{
+  "$ref": "#/definitions/RecordDetailsProps",
+  "definitions": {
+    "RecordDetailsProps": {
+      "type": "object",
+      "properties": {
+        "columns": {
+          "type": "string",
+          "enum": [
+            "1",
+            "2",
+            "3",
+            "4"
+          ],
+          "default": "2"
+        },
+        "layout": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "custom"
+          ],
+          "default": "auto"
+        },
+        "sections": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Section IDs to show"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/RecordHighlightsProps.json

@@ -0,0 +1,24 @@
+{
+  "$ref": "#/definitions/RecordHighlightsProps",
+  "definitions": {
+    "RecordHighlightsProps": {
+      "type": "object",
+      "properties": {
+        "fields": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "maxItems": 7,
+          "description": "Key fields to highlights (max 7)"
+        }
+      },
+      "required": [
+        "fields"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/RecordRelatedListProps.json

@@ -0,0 +1,39 @@
+{
+  "$ref": "#/definitions/RecordRelatedListProps",
+  "definitions": {
+    "RecordRelatedListProps": {
+      "type": "object",
+      "properties": {
+        "objectName": {
+          "type": "string",
+          "description": "Related object name"
+        },
+        "relationshipField": {
+          "type": "string",
+          "description": "Field on related object that points to this record"
+        },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Fields to display"
+        },
+        "sort": {
+          "type": "string"
+        },
+        "limit": {
+          "type": "number",
+          "default": 5
+        }
+      },
+      "required": [
+        "objectName",
+        "relationshipField",
+        "columns"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/UrlNavItem.json

@@ -6,7 +6,9 @@
       "properties": {
         "id": {
           "type": "string",
-          "description": "Unique identifier for this navigation item"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique identifier for this navigation item (lowercase snake_case)"
         },
         "label": {
           "type": "string",