@objectstack/spec 0.1.0 → 0.1.2

package/json-schema/ListView.json

@@ -0,0 +1,153 @@
+{
+  "$ref": "#/definitions/ListView",
+  "definitions": {
+    "ListView": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "grid",
+            "kanban",
+            "calendar",
+            "gantt",
+            "map"
+          ],
+          "default": "grid"
+        },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Fields to display as columns"
+        },
+        "filter": {
+          "type": "array",
+          "description": "Filter criteria (JSON Rules)"
+        },
+        "sort": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "order": {
+                    "type": "string",
+                    "enum": [
+                      "asc",
+                      "desc"
+                    ]
+                  }
+                },
+                "required": [
+                  "field",
+                  "order"
+                ],
+                "additionalProperties": false
+              }
+            }
+          ]
+        },
+        "searchableFields": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Fields enabled for search"
+        },
+        "kanban": {
+          "type": "object",
+          "properties": {
+            "groupByField": {
+              "type": "string",
+              "description": "Field to group columns by (usually status/select)"
+            },
+            "summarizeField": {
+              "type": "string",
+              "description": "Field to sum at top of column (e.g. amount)"
+            },
+            "columns": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Fields to show on cards"
+            }
+          },
+          "required": [
+            "groupByField",
+            "columns"
+          ],
+          "additionalProperties": false
+        },
+        "calendar": {
+          "type": "object",
+          "properties": {
+            "startDateField": {
+              "type": "string"
+            },
+            "endDateField": {
+              "type": "string"
+            },
+            "titleField": {
+              "type": "string"
+            },
+            "colorField": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "startDateField",
+            "titleField"
+          ],
+          "additionalProperties": false
+        },
+        "gantt": {
+          "type": "object",
+          "properties": {
+            "startDateField": {
+              "type": "string"
+            },
+            "endDateField": {
+              "type": "string"
+            },
+            "titleField": {
+              "type": "string"
+            },
+            "progressField": {
+              "type": "string"
+            },
+            "dependenciesField": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "startDateField",
+            "endDateField",
+            "titleField"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "columns"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Locale.json

@@ -0,0 +1,10 @@
+{
+  "$ref": "#/definitions/Locale",
+  "definitions": {
+    "Locale": {
+      "type": "string",
+      "description": "BCP-47 Language Tag (e.g. en-US, zh-CN)"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/LocationCoordinates.json

@@ -0,0 +1,36 @@
+{
+  "$ref": "#/definitions/LocationCoordinates",
+  "definitions": {
+    "LocationCoordinates": {
+      "type": "object",
+      "properties": {
+        "latitude": {
+          "type": "number",
+          "minimum": -90,
+          "maximum": 90,
+          "description": "Latitude coordinate"
+        },
+        "longitude": {
+          "type": "number",
+          "minimum": -180,
+          "maximum": 180,
+          "description": "Longitude coordinate"
+        },
+        "altitude": {
+          "type": "number",
+          "description": "Altitude in meters"
+        },
+        "accuracy": {
+          "type": "number",
+          "description": "Accuracy in meters"
+        }
+      },
+      "required": [
+        "latitude",
+        "longitude"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Logger.json

@@ -0,0 +1,25 @@
+{
+  "$ref": "#/definitions/Logger",
+  "definitions": {
+    "Logger": {
+      "type": "object",
+      "properties": {
+        "debug": {
+          "description": "(message: string, ...meta: any[]) => void"
+        },
+        "info": {
+          "description": "(message: string, ...meta: any[]) => void"
+        },
+        "warn": {
+          "description": "(message: string, ...meta: any[]) => void"
+        },
+        "error": {
+          "description": "(message: string, ...meta: any[]) => void"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Structured Logger"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/LogicOperator.json

@@ -0,0 +1,14 @@
+{
+  "$ref": "#/definitions/LogicOperator",
+  "definitions": {
+    "LogicOperator": {
+      "type": "string",
+      "enum": [
+        "and",
+        "or",
+        "not"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Manifest.json

@@ -0,0 +1,315 @@
+{
+  "$ref": "#/definitions/Manifest",
+  "definitions": {
+    "Manifest": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique package identifier (reverse domain style)"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Package version (semantic versioning)"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "app",
+            "plugin",
+            "driver",
+            "module"
+          ],
+          "description": "Type of package"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable package name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Package description"
+        },
+        "permissions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Array of required permission strings"
+        },
+        "objects": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Glob patterns for ObjectQL schemas files"
+        },
+        "datasources": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Glob patterns for Datasource definitions"
+        },
+        "dependencies": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Package dependencies"
+        },
+        "configuration": {
+          "type": "object",
+          "properties": {
+            "title": {
+              "type": "string"
+            },
+            "properties": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "array",
+                      "object"
+                    ],
+                    "description": "Data type of the setting"
+                  },
+                  "default": {
+                    "description": "Default value"
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "Tooltip description"
+                  },
+                  "required": {
+                    "type": "boolean",
+                    "description": "Is this setting required?"
+                  },
+                  "secret": {
+                    "type": "boolean",
+                    "description": "If true, value is encrypted/masked (e.g. API Keys)"
+                  },
+                  "enum": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Allowed values for select inputs"
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Map of configuration keys to their definitions"
+            }
+          },
+          "required": [
+            "properties"
+          ],
+          "additionalProperties": false,
+          "description": "Plugin configuration settings"
+        },
+        "contributes": {
+          "type": "object",
+          "properties": {
+            "kinds": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "The generic identifier of the kind (e.g., \"sys.bi.report\")"
+                  },
+                  "globs": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "File patterns to watch (e.g., [\"**/*.report.ts\"])"
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "Description of what this kind represents"
+                  }
+                },
+                "required": [
+                  "id",
+                  "globs"
+                ],
+                "additionalProperties": false
+              },
+              "description": "New Metadata Types to recognize"
+            },
+            "events": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Events this plugin listens to"
+            },
+            "menus": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "label": {
+                      "type": "string"
+                    },
+                    "command": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "label"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "description": "UI Menu contributions"
+            },
+            "themes": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id",
+                  "label",
+                  "path"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Theme contributions"
+            },
+            "translations": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "locale": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "locale",
+                  "path"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Translation resources"
+            },
+            "actions": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "Unique action name"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "input": {
+                    "description": "Input validation schema"
+                  },
+                  "output": {
+                    "description": "Output schema"
+                  }
+                },
+                "required": [
+                  "name"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Exposed server actions"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Platform contributions"
+        },
+        "data": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "object": {
+                "type": "string",
+                "description": "Target Object Name"
+              },
+              "records": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": {}
+                },
+                "description": "List of records to insert"
+              },
+              "mode": {
+                "type": "string",
+                "enum": [
+                  "upsert",
+                  "insert",
+                  "ignore"
+                ],
+                "default": "upsert",
+                "description": "Seeding mode"
+              }
+            },
+            "required": [
+              "object",
+              "records"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Initial seed data"
+        },
+        "extensions": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Extension points and contributions"
+        }
+      },
+      "required": [
+        "id",
+        "version",
+        "type",
+        "name"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}