@kumwe/studio-protocol 0.1.0-alpha.10

package/schemas/schema-profile.schema.json

@@ -0,0 +1,201 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/schema-profile.schema.json",
+  "title": "Studio Schema Profile meta-schema",
+  "allOf": [
+    { "$ref": "#/$defs/schema" },
+    {
+      "type": "object",
+      "propertyNames": { "$ref": "common.schema.json#/$defs/safeJsonMemberName" },
+      "required": ["type", "additionalProperties"],
+      "properties": {
+        "type": { "const": "object" },
+        "additionalProperties": { "const": false }
+      }
+    }
+  ],
+  "$defs": {
+    "schema": {
+      "type": "object",
+      "propertyNames": {
+        "enum": [
+          "$defs",
+          "$ref",
+          "$schema",
+          "additionalProperties",
+          "allOf",
+          "anyOf",
+          "const",
+          "default",
+          "dependentRequired",
+          "description",
+          "else",
+          "enum",
+          "examples",
+          "exclusiveMaximum",
+          "exclusiveMinimum",
+          "if",
+          "items",
+          "maxItems",
+          "maxLength",
+          "maxProperties",
+          "maximum",
+          "minItems",
+          "minLength",
+          "minProperties",
+          "minimum",
+          "multipleOf",
+          "not",
+          "oneOf",
+          "prefixItems",
+          "properties",
+          "propertyNames",
+          "readOnly",
+          "required",
+          "then",
+          "title",
+          "type",
+          "uniqueItems",
+          "writeOnly"
+        ]
+      },
+      "properties": {
+        "$defs": { "$ref": "#/$defs/schemaMap" },
+        "$ref": {
+          "type": "string",
+          "maxLength": 500,
+          "pattern": "^#(?:/(?:[A-Za-z0-9._!$&'()*+,;=:@-]|~[01])*)*(?![\\s\\S])"
+        },
+        "$schema": { "const": "https://json-schema.org/draft/2020-12/schema" },
+        "additionalProperties": { "$ref": "#/$defs/subschema" },
+        "allOf": { "$ref": "#/$defs/schemaArray" },
+        "anyOf": { "$ref": "#/$defs/schemaArray" },
+        "const": { "$ref": "#/$defs/jsonValue" },
+        "default": { "$ref": "#/$defs/jsonValue" },
+        "dependentRequired": {
+          "type": "object",
+          "maxProperties": 512,
+          "propertyNames": { "$ref": "common.schema.json#/$defs/safeJsonMemberName" },
+          "additionalProperties": {
+            "type": "array",
+            "maxItems": 512,
+            "uniqueItems": true,
+            "items": { "$ref": "common.schema.json#/$defs/safeJsonMemberName" }
+          }
+        },
+        "description": { "type": "string", "maxLength": 10000 },
+        "else": { "$ref": "#/$defs/subschema" },
+        "enum": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1024,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/jsonValue" }
+        },
+        "examples": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/jsonValue" }
+        },
+        "exclusiveMaximum": { "type": "number" },
+        "exclusiveMinimum": { "type": "number" },
+        "if": { "$ref": "#/$defs/subschema" },
+        "items": { "$ref": "#/$defs/subschema" },
+        "maxItems": { "type": "integer", "minimum": 0 },
+        "maxLength": { "type": "integer", "minimum": 0 },
+        "maxProperties": { "type": "integer", "minimum": 0 },
+        "maximum": { "type": "number" },
+        "minItems": { "type": "integer", "minimum": 0 },
+        "minLength": { "type": "integer", "minimum": 0 },
+        "minProperties": { "type": "integer", "minimum": 0 },
+        "minimum": { "type": "number" },
+        "multipleOf": { "type": "number", "exclusiveMinimum": 0 },
+        "not": { "$ref": "#/$defs/subschema" },
+        "oneOf": { "$ref": "#/$defs/schemaArray" },
+        "prefixItems": { "$ref": "#/$defs/schemaArray" },
+        "properties": { "$ref": "#/$defs/schemaMap" },
+        "propertyNames": { "$ref": "#/$defs/subschema" },
+        "readOnly": { "type": "boolean" },
+        "required": {
+          "type": "array",
+          "maxItems": 512,
+          "uniqueItems": true,
+          "items": { "$ref": "common.schema.json#/$defs/safeJsonMemberName" }
+        },
+        "then": { "$ref": "#/$defs/subschema" },
+        "title": { "type": "string", "maxLength": 1000 },
+        "type": {
+          "oneOf": [
+            { "$ref": "#/$defs/typeName" },
+            {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 7,
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/typeName" }
+            }
+          ]
+        },
+        "uniqueItems": { "type": "boolean" },
+        "writeOnly": { "type": "boolean" }
+      }
+    },
+    "schemaArray": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "items": { "$ref": "#/$defs/subschema" }
+    },
+    "schemaMap": {
+      "type": "object",
+      "maxProperties": 512,
+      "propertyNames": { "$ref": "common.schema.json#/$defs/safeJsonMemberName" },
+      "additionalProperties": { "$ref": "#/$defs/schema" }
+    },
+    "jsonValue": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "boolean" },
+        { "type": "number" },
+        { "type": "string" },
+        {
+          "type": "array",
+          "maxItems": 10000,
+          "items": { "$ref": "#/$defs/jsonValue" }
+        },
+        {
+          "type": "object",
+          "maxProperties": 1000,
+          "propertyNames": { "$ref": "common.schema.json#/$defs/safeJsonMemberName" },
+          "additionalProperties": { "$ref": "#/$defs/jsonValue" }
+        }
+      ]
+    },
+    "subschema": {
+      "oneOf": [{ "type": "boolean" }, { "$ref": "#/$defs/schema" }]
+    },
+    "typeName": {
+      "enum": ["array", "boolean", "integer", "null", "number", "object", "string"]
+    },
+    "limits": {
+      "const": {
+        "maxAlternatives": 64,
+        "maxDescriptionLength": 10000,
+        "maxEnumMembers": 1024,
+        "maxExamples": 100,
+        "maxJsonDepth": 64,
+        "maxJsonItems": 10000,
+        "maxJsonProperties": 1000,
+        "maxObjectKeyLength": 200,
+        "maxPropertyNames": 512,
+        "maxReferenceLength": 500,
+        "maxReferences": 128,
+        "maxSchemaBytes": 262144,
+        "maxSchemaDepth": 32,
+        "maxSchemaMapProperties": 512,
+        "maxSchemaNodes": 1024,
+        "maxTitleLength": 1000
+      }
+    }
+  }
+}

package/schemas/studio-chart.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/studio-chart.schema.json",
+  "title": "Studio canonical chart",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["type", "labels", "datasets"],
+  "properties": {
+    "type": { "enum": ["bar", "doughnut", "line", "pie"] },
+    "title": { "type": "string", "maxLength": 500 },
+    "labels": {
+      "type": "array",
+      "maxItems": 200,
+      "items": { "type": "string", "maxLength": 500 }
+    },
+    "datasets": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 20,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["label", "values"],
+        "properties": {
+          "label": { "type": "string", "maxLength": 500 },
+          "values": {
+            "type": "array",
+            "maxItems": 200,
+            "items": { "type": "number", "minimum": -1000000000000000, "maximum": 1000000000000000 }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/studio-config.schema.json

@@ -0,0 +1,244 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/studio-config.schema.json",
+  "title": "Studio resolved session configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contractVersion",
+    "protocolVersion",
+    "sessionId",
+    "sessionGeneration",
+    "mode",
+    "composite",
+    "sessionState",
+    "actor",
+    "locale",
+    "displayPreferences",
+    "resourceContext",
+    "permissions",
+    "artifacts",
+    "blocks",
+    "plugins",
+    "hostCapabilities",
+    "limits",
+    "features",
+    "preview"
+  ],
+  "properties": {
+    "contractVersion": { "$ref": "common.schema.json#/$defs/contractVersion" },
+    "protocolVersion": { "$ref": "common.schema.json#/$defs/semanticVersion" },
+    "sessionId": { "$ref": "common.schema.json#/$defs/stableId" },
+    "sessionGeneration": { "$ref": "common.schema.json#/$defs/revision" },
+    "mode": {
+      "enum": ["model", "blueprint", "content"]
+    },
+    "composite": { "enum": ["single", "hybrid"] },
+    "sessionState": { "enum": ["editable", "read-only"] },
+    "actor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "displayName"],
+      "properties": {
+        "id": { "$ref": "common.schema.json#/$defs/stableId" },
+        "displayName": { "type": "string", "minLength": 1, "maxLength": 200 }
+      }
+    },
+    "locale": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requested", "resolved", "fallbacks", "direction", "timeZone"],
+      "properties": {
+        "requested": { "$ref": "common.schema.json#/$defs/locale" },
+        "resolved": { "$ref": "common.schema.json#/$defs/locale" },
+        "fallbacks": {
+          "type": "array",
+          "maxItems": 10,
+          "uniqueItems": true,
+          "items": { "$ref": "common.schema.json#/$defs/locale" }
+        },
+        "direction": { "enum": ["ltr", "rtl"] },
+        "timeZone": { "type": "string", "minLength": 1, "maxLength": 100 }
+      }
+    },
+    "displayPreferences": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["calendar", "numberingSystem", "hourCycle"],
+      "properties": {
+        "calendar": { "$ref": "common.schema.json#/$defs/localName" },
+        "numberingSystem": { "$ref": "common.schema.json#/$defs/localName" },
+        "hourCycle": { "enum": ["h11", "h12", "h23", "h24"] },
+        "measurementSystem": { "enum": ["metric", "us", "uk"] }
+      }
+    },
+    "resourceContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key", "surface", "scopes"],
+      "properties": {
+        "key": { "$ref": "common.schema.json#/$defs/stableId" },
+        "surface": { "$ref": "common.schema.json#/$defs/qualifiedName" },
+        "revision": { "$ref": "common.schema.json#/$defs/revision" },
+        "scopes": {
+          "type": "array",
+          "maxItems": 20,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "id"],
+            "properties": {
+              "kind": { "$ref": "common.schema.json#/$defs/qualifiedName" },
+              "id": { "$ref": "common.schema.json#/$defs/stableId" }
+            }
+          }
+        },
+        "resource": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "id"],
+          "properties": {
+            "type": { "$ref": "common.schema.json#/$defs/qualifiedName" },
+            "id": { "$ref": "common.schema.json#/$defs/stableId" }
+          }
+        }
+      }
+    },
+    "permissions": {
+      "type": "array",
+      "maxItems": 500,
+      "uniqueItems": true,
+      "items": { "$ref": "common.schema.json#/$defs/qualifiedName" }
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "model": { "$ref": "common.schema.json#/$defs/lockedArtifactReference" },
+        "blueprint": { "$ref": "common.schema.json#/$defs/lockedArtifactReference" },
+        "entry": { "$ref": "common.schema.json#/$defs/resolvedEntryReference" },
+        "theme": { "$ref": "common.schema.json#/$defs/lockedArtifactReference" }
+      }
+    },
+    "plugins": {
+      "type": "array",
+      "maxItems": 100,
+      "uniqueItems": true,
+      "items": { "$ref": "common.schema.json#/$defs/lockedArtifactReference" }
+    },
+    "blocks": {
+      "type": "array",
+      "maxItems": 5000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["type", "version", "revision"],
+        "properties": {
+          "type": { "$ref": "common.schema.json#/$defs/qualifiedName" },
+          "version": { "$ref": "common.schema.json#/$defs/semanticVersion" },
+          "revision": { "$ref": "common.schema.json#/$defs/revision" },
+          "integrity": { "$ref": "common.schema.json#/$defs/integrity" }
+        }
+      }
+    },
+    "hostCapabilities": {
+      "$ref": "host-capabilities.schema.json"
+    },
+    "limits": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "maxNodes",
+        "maxDepth",
+        "maxSlotsPerNode",
+        "maxChildrenPerSlot",
+        "maxPropertyBytes",
+        "maxExtensionBytes",
+        "maxCommandBatch",
+        "maxHistoryEntries",
+        "maxRichTextBytes",
+        "maxRichTextDepth",
+        "maxPreviewRequestsPerMinute",
+        "maxPreviewBytes",
+        "maxMediaUploadBytes",
+        "maxMediaBatch",
+        "maxPluginCount",
+        "maxContributionsPerPlugin",
+        "maxLocaleBytes"
+      ],
+      "properties": {
+        "maxNodes": { "type": "integer", "minimum": 1, "maximum": 100000 },
+        "maxDepth": { "type": "integer", "minimum": 1, "maximum": 128 },
+        "maxSlotsPerNode": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "maxChildrenPerSlot": { "type": "integer", "minimum": 0, "maximum": 10000 },
+        "maxPropertyBytes": { "type": "integer", "minimum": 0, "maximum": 10485760 },
+        "maxExtensionBytes": { "type": "integer", "minimum": 0, "maximum": 10485760 },
+        "maxCommandBatch": { "type": "integer", "minimum": 1, "maximum": 10000 },
+        "maxHistoryEntries": { "type": "integer", "minimum": 1, "maximum": 100000 },
+        "maxRichTextBytes": { "type": "integer", "minimum": 1, "maximum": 10485760 },
+        "maxRichTextDepth": { "type": "integer", "minimum": 1, "maximum": 128 },
+        "maxPreviewRequestsPerMinute": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 60000
+        },
+        "maxPreviewBytes": { "type": "integer", "minimum": 1, "maximum": 52428800 },
+        "maxMediaUploadBytes": { "type": "integer", "minimum": 1, "maximum": 1099511627776 },
+        "maxMediaBatch": { "type": "integer", "minimum": 1, "maximum": 1000 },
+        "maxPluginCount": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "maxContributionsPerPlugin": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 5000
+        },
+        "maxLocaleBytes": { "type": "integer", "minimum": 1, "maximum": 104857600 }
+      }
+    },
+    "features": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "executablePlugins",
+        "customInspectors",
+        "externalMediaImport",
+        "clipboardMediaUpload",
+        "collaboration",
+        "offlineRecovery"
+      ],
+      "properties": {
+        "executablePlugins": { "type": "boolean" },
+        "customInspectors": { "type": "boolean" },
+        "externalMediaImport": { "type": "boolean" },
+        "clipboardMediaUpload": { "type": "boolean" },
+        "collaboration": { "type": "boolean" },
+        "offlineRecovery": { "type": "boolean" }
+      }
+    },
+    "preview": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["enabled", "sameOriginRequired", "allowApproximateRenderer"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "sameOriginRequired": { "type": "boolean" },
+        "allowApproximateRenderer": { "type": "boolean" },
+        "initialViewport": { "$ref": "common.schema.json#/$defs/localName" }
+      }
+    },
+    "extensions": { "$ref": "common.schema.json#/$defs/extensions" }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "composite": { "const": "hybrid" } },
+        "required": ["composite"]
+      },
+      "then": {
+        "properties": {
+          "mode": { "enum": ["blueprint", "content"] }
+        }
+      }
+    }
+  ]
+}

package/schemas/studio-drawing.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/studio-drawing.schema.json",
+  "title": "Studio canonical drawing",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["width", "height", "alt", "strokes"],
+  "properties": {
+    "width": { "type": "integer", "minimum": 1, "maximum": 4096 },
+    "height": { "type": "integer", "minimum": 1, "maximum": 4096 },
+    "alt": { "type": "string", "minLength": 1, "maxLength": 5000 },
+    "strokes": {
+      "type": "array",
+      "maxItems": 5000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["color", "width", "points"],
+        "properties": {
+          "color": {
+            "type": "string",
+            "pattern": "^(?:#[0-9A-Fa-f]{6}|[a-z][a-z0-9-]{0,62}/[a-z][a-z0-9-]{0,62})$",
+            "maxLength": 127
+          },
+          "width": { "type": "number", "minimum": 0.25, "maximum": 64 },
+          "points": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 10000,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["x", "y"],
+              "properties": {
+                "x": { "type": "number", "minimum": 0, "maximum": 4096 },
+                "y": { "type": "number", "minimum": 0, "maximum": 4096 }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/studio-money.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/studio-money.schema.json",
+  "title": "Studio canonical money",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["amount", "currency"],
+  "properties": {
+    "amount": {
+      "type": "string",
+      "pattern": "^-?(?:0|[1-9][0-9]{0,17})(?:\\.[0-9]{1,6})?$",
+      "maxLength": 26
+    },
+    "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }
+  }
+}

package/schemas/studio-presentation.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/studio-presentation.schema.json",
+  "title": "Studio presentation intent",
+  "type": "object",
+  "maxProperties": 12,
+  "additionalProperties": false,
+  "properties": {
+    "align": { "enum": ["center", "end", "start", "stretch"] },
+    "animation": { "enum": ["fade", "none", "parallax", "scale", "slide"] },
+    "height": { "enum": ["auto", "content", "full", "viewport"] },
+    "inverse": { "type": "boolean" },
+    "margin": { "enum": ["comfortable", "compact", "none", "spacious"] },
+    "marker": { "enum": ["check", "decimal", "disc", "none"] },
+    "padding": { "enum": ["comfortable", "compact", "none", "spacious"] },
+    "position": { "enum": ["flow", "relative", "sticky"] },
+    "print": { "enum": ["hide", "only", "show"] },
+    "scrolling": { "enum": ["auto", "clip", "snap", "visible"] },
+    "visibility": {
+      "type": "object",
+      "maxProperties": 3,
+      "additionalProperties": false,
+      "properties": {
+        "compact": { "enum": ["hidden", "visible"] },
+        "expanded": { "enum": ["hidden", "visible"] },
+        "medium": { "enum": ["hidden", "visible"] }
+      }
+    },
+    "width": { "enum": ["auto", "content", "full"] }
+  }
+}

package/schemas/studio-release.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/studio-release.schema.json",
+  "title": "Studio coordinated release record",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contractVersion",
+    "kind",
+    "release",
+    "packages",
+    "protocolVersion",
+    "corpusManifestDigest",
+    "claimedProfiles"
+  ],
+  "properties": {
+    "contractVersion": {
+      "$ref": "common.schema.json#/$defs/contractVersion"
+    },
+    "kind": {
+      "const": "studio-release"
+    },
+    "release": {
+      "$ref": "common.schema.json#/$defs/semanticVersion"
+    },
+    "packages": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "@kumwe/studio-core",
+        "@kumwe/studio-media",
+        "@kumwe/studio-preview",
+        "@kumwe/studio-protocol",
+        "@kumwe/studio-renderer-web",
+        "@kumwe/studio-rich-text",
+        "@kumwe/studio",
+        "@kumwe/studio-testkit"
+      ],
+      "properties": {
+        "@kumwe/studio-core": {
+          "$ref": "common.schema.json#/$defs/semanticVersion"
+        },
+        "@kumwe/studio-media": {
+          "$ref": "common.schema.json#/$defs/semanticVersion"
+        },
+        "@kumwe/studio-preview": {
+          "$ref": "common.schema.json#/$defs/semanticVersion"
+        },
+        "@kumwe/studio-protocol": {
+          "$ref": "common.schema.json#/$defs/semanticVersion"
+        },
+        "@kumwe/studio-renderer-web": {
+          "$ref": "common.schema.json#/$defs/semanticVersion"
+        },
+        "@kumwe/studio-rich-text": {
+          "$ref": "common.schema.json#/$defs/semanticVersion"
+        },
+        "@kumwe/studio": {
+          "$ref": "common.schema.json#/$defs/semanticVersion"
+        },
+        "@kumwe/studio-testkit": {
+          "$ref": "common.schema.json#/$defs/semanticVersion"
+        }
+      }
+    },
+    "protocolVersion": {
+      "$ref": "common.schema.json#/$defs/semanticVersion"
+    },
+    "corpusManifestDigest": {
+      "$ref": "common.schema.json#/$defs/integrity"
+    },
+    "claimedProfiles": {
+      "type": "array",
+      "maxItems": 32,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "common.schema.json#/$defs/qualifiedName"
+      }
+    }
+  }
+}