@objectstack/spec 0.3.2 → 0.4.1

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",

package/json-schema/ui/View.json

@@ -8,7 +8,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"
@@ -17,8 +20,11 @@
               "type": "string",
               "enum": [
                 "grid",
+                "spreadsheet",
                 "kanban",
+                "gallery",
                 "calendar",
+                "timeline",
                 "gantt",
                 "map"
               ],
@@ -404,7 +410,10 @@
               "enum": [
                 "simple",
                 "tabbed",
-                "wizard"
+                "wizard",
+                "split",
+                "drawer",
+                "modal"
               ],
               "default": "simple"
             },
@@ -750,7 +759,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"
@@ -759,8 +771,11 @@
                 "type": "string",
                 "enum": [
                   "grid",
+                  "spreadsheet",
                   "kanban",
+                  "gallery",
                   "calendar",
+                  "timeline",
                   "gantt",
                   "map"
                 ],
@@ -1150,7 +1165,10 @@
                 "enum": [
                   "simple",
                   "tabbed",
-                  "wizard"
+                  "wizard",
+                  "split",
+                  "drawer",
+                  "modal"
                 ],
                 "default": "simple"
               },

package/json-schema/ui/WidgetEvent.json

@@ -0,0 +1,42 @@
+{
+  "$ref": "#/definitions/WidgetEvent",
+  "definitions": {
+    "WidgetEvent": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Event name"
+        },
+        "label": {
+          "type": "string",
+          "description": "Human-readable event label"
+        },
+        "description": {
+          "type": "string",
+          "description": "Event description and usage"
+        },
+        "bubbles": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether event bubbles"
+        },
+        "cancelable": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether event is cancelable"
+        },
+        "payload": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Event payload schema"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/WidgetLifecycle.json

@@ -0,0 +1,40 @@
+{
+  "$ref": "#/definitions/WidgetLifecycle",
+  "definitions": {
+    "WidgetLifecycle": {
+      "type": "object",
+      "properties": {
+        "onMount": {
+          "type": "string",
+          "description": "Initialization code when widget mounts"
+        },
+        "onUpdate": {
+          "type": "string",
+          "description": "Code to run when props change"
+        },
+        "onUnmount": {
+          "type": "string",
+          "description": "Cleanup code when widget unmounts"
+        },
+        "onValidate": {
+          "type": "string",
+          "description": "Custom validation logic"
+        },
+        "onFocus": {
+          "type": "string",
+          "description": "Code to run on focus"
+        },
+        "onBlur": {
+          "type": "string",
+          "description": "Code to run on blur"
+        },
+        "onError": {
+          "type": "string",
+          "description": "Error handling code"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/WidgetManifest.json

@@ -0,0 +1,262 @@
+{
+  "$ref": "#/definitions/WidgetManifest",
+  "definitions": {
+    "WidgetManifest": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z_][a-z0-9_]*$",
+          "description": "Widget identifier (snake_case)"
+        },
+        "label": {
+          "type": "string",
+          "description": "Widget display name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Widget description"
+        },
+        "version": {
+          "type": "string",
+          "description": "Widget version (semver)"
+        },
+        "author": {
+          "type": "string",
+          "description": "Widget author"
+        },
+        "icon": {
+          "type": "string",
+          "description": "Widget icon"
+        },
+        "fieldTypes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Supported field types"
+        },
+        "category": {
+          "type": "string",
+          "enum": [
+            "input",
+            "display",
+            "picker",
+            "editor",
+            "custom"
+          ],
+          "default": "custom",
+          "description": "Widget category"
+        },
+        "lifecycle": {
+          "type": "object",
+          "properties": {
+            "onMount": {
+              "type": "string",
+              "description": "Initialization code when widget mounts"
+            },
+            "onUpdate": {
+              "type": "string",
+              "description": "Code to run when props change"
+            },
+            "onUnmount": {
+              "type": "string",
+              "description": "Cleanup code when widget unmounts"
+            },
+            "onValidate": {
+              "type": "string",
+              "description": "Custom validation logic"
+            },
+            "onFocus": {
+              "type": "string",
+              "description": "Code to run on focus"
+            },
+            "onBlur": {
+              "type": "string",
+              "description": "Code to run on blur"
+            },
+            "onError": {
+              "type": "string",
+              "description": "Error handling code"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Lifecycle hooks"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Event name"
+              },
+              "label": {
+                "type": "string",
+                "description": "Human-readable event label"
+              },
+              "description": {
+                "type": "string",
+                "description": "Event description and usage"
+              },
+              "bubbles": {
+                "type": "boolean",
+                "default": false,
+                "description": "Whether event bubbles"
+              },
+              "cancelable": {
+                "type": "boolean",
+                "default": false,
+                "description": "Whether event is cancelable"
+              },
+              "payload": {
+                "type": "object",
+                "additionalProperties": {},
+                "description": "Event payload schema"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Custom events"
+        },
+        "properties": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Property name (camelCase)"
+              },
+              "label": {
+                "type": "string",
+                "description": "Human-readable label"
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "string",
+                  "number",
+                  "boolean",
+                  "array",
+                  "object",
+                  "function",
+                  "any"
+                ],
+                "description": "TypeScript type"
+              },
+              "required": {
+                "type": "boolean",
+                "default": false,
+                "description": "Whether property is required"
+              },
+              "default": {
+                "description": "Default value"
+              },
+              "description": {
+                "type": "string",
+                "description": "Property description"
+              },
+              "validation": {
+                "type": "object",
+                "additionalProperties": {},
+                "description": "Validation rules"
+              },
+              "category": {
+                "type": "string",
+                "description": "Property category"
+              }
+            },
+            "required": [
+              "name",
+              "type"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Configuration properties"
+        },
+        "implementation": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "url",
+                "inline",
+                "module"
+              ],
+              "description": "Implementation type"
+            },
+            "source": {
+              "type": "string",
+              "description": "Source URL, inline code, or module path"
+            }
+          },
+          "required": [
+            "type",
+            "source"
+          ],
+          "additionalProperties": false,
+          "description": "Widget implementation"
+        },
+        "dependencies": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "version": {
+                "type": "string"
+              },
+              "url": {
+                "type": "string",
+                "format": "uri"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Widget dependencies"
+        },
+        "screenshots": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "format": "uri"
+          },
+          "description": "Screenshot URLs"
+        },
+        "documentation": {
+          "type": "string",
+          "format": "uri",
+          "description": "Documentation URL"
+        },
+        "license": {
+          "type": "string",
+          "description": "License (SPDX identifier)"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Tags for categorization"
+        }
+      },
+      "required": [
+        "name",
+        "label"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ui/WidgetProperty.json

@@ -0,0 +1,58 @@
+{
+  "$ref": "#/definitions/WidgetProperty",
+  "definitions": {
+    "WidgetProperty": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Property name (camelCase)"
+        },
+        "label": {
+          "type": "string",
+          "description": "Human-readable label"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "string",
+            "number",
+            "boolean",
+            "array",
+            "object",
+            "function",
+            "any"
+          ],
+          "description": "TypeScript type"
+        },
+        "required": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether property is required"
+        },
+        "default": {
+          "description": "Default value"
+        },
+        "description": {
+          "type": "string",
+          "description": "Property description"
+        },
+        "validation": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Validation rules"
+        },
+        "category": {
+          "type": "string",
+          "description": "Property category"
+        }
+      },
+      "required": [
+        "name",
+        "type"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}