@kumwe/studio-protocol 0.1.0-alpha.6 → 0.1.0-beta.2

package/schemas/manifest.json

@@ -1,10 +1,54 @@
 {
   "contractVersion": "0.1-draft",
   "epoch": "https://schemas.kumwe.org/studio/v1/",
+  "generator": {
+    "name": "@kumwe/studio/schema-manifest",
+    "version": "1.0.0"
+  },
   "kind": "schema-manifest",
   "schemas": [
     {
-      "digest": "sha256-sx4nxAo1fq7Mjp2J3gfsIWRq9vD6nkDDrc1PtWLzfNE=",
+      "digest": "sha256-nzk5hko590N58UQlQ04bR31Jk2pw+sDwXLJXu2re174=",
+      "file": "authoring-http-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-http-vector.schema.json"
+    },
+    {
+      "digest": "sha256-1G8TtRsEvzqO9ixuoaMRAOBJZ2FdSM82xLA6zziA5Rk=",
+      "file": "authoring-http.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-http.schema.json"
+    },
+    {
+      "digest": "sha256-WvSNMOQ3OZWs7ZKBCCRRwLtw5byZBtn6Rwvxz74vfAY=",
+      "file": "authoring-message-catalog.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-message-catalog.schema.json"
+    },
+    {
+      "digest": "sha256-/rKcDdqp9AomUUzMlcpUbEVUTTydH9rduu5BumhfN9s=",
+      "file": "authoring-save.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-save.schema.json"
+    },
+    {
+      "digest": "sha256-YOuMdnT6L/BkfGv9D9gqQjXP1yvriLufPLVKWeKmQh0=",
+      "file": "authoring-session.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-session.schema.json"
+    },
+    {
+      "digest": "sha256-N3sgQ/9iEAOvKwpkoRPbTeJF/KwK1kLWheMKuGRU+PY=",
+      "file": "authoring-target.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-target.schema.json"
+    },
+    {
+      "digest": "sha256-hZBNrpwHkLuUu/mPeU2UWtuOXfvZgrd8MO7vB9fJWog=",
+      "file": "authoring-web-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-web-vector.schema.json"
+    },
+    {
+      "digest": "sha256-GCk2z8XalwUUKM6R146c7WeCj3CY00kTMRKtPjaeehs=",
+      "file": "binding-projection-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/binding-projection-vector.schema.json"
+    },
+    {
+      "digest": "sha256-S3sx0m9PQs2vMFNvYIapBXc8W184cEng5MFF54C6RwQ=",
       "file": "block-definition.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/block-definition.schema.json"
     },
@@ -29,7 +73,7 @@
       "id": "https://schemas.kumwe.org/studio/v1/command.schema.json"
     },
     {
-      "digest": "sha256-htSwJXFIhBnC96NxNxKgr+h2Fbo/qg8/ydtwguXEesA=",
+      "digest": "sha256-O2nKQ4qeVaHzqM6pseB6R1NXflQyPd2TWzucR5Lf/Ss=",
       "file": "common.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/common.schema.json"
     },
@@ -64,12 +108,12 @@
       "id": "https://schemas.kumwe.org/studio/v1/host-capabilities.schema.json"
     },
     {
-      "digest": "sha256-6FWXIBdUaiuxpwLJUWnHxnRdcYmR6Ni6WWFCEQFekGw=",
+      "digest": "sha256-7tYC8PpuMQd3DHt4zrB3A+w5bZVMOman4gYvfugXdc8=",
       "file": "host-error.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/host-error.schema.json"
     },
     {
-      "digest": "sha256-dKcbTVV2gn4IWAAH1RMpK5Ve12V+RswsDuhlrC1Ohm4=",
+      "digest": "sha256-Sd/PcwJSh/qPuxVz7L1durLmavdALdCbya/BMMxzZvs=",
       "file": "host-operations.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/host-operations.schema.json"
     },
@@ -89,7 +133,7 @@
       "id": "https://schemas.kumwe.org/studio/v1/host-sequence-vector.schema.json"
     },
     {
-      "digest": "sha256-KETVqPMNQCSN8faoNW7fHuSWc6rT/Jkp4+Lh31gQuQM=",
+      "digest": "sha256-v2LFWwqpa0hS9XnYaVP9xC7Ohyw+Dl7ZG4e038+LqtI=",
       "file": "host-vector.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/host-vector.schema.json"
     },
@@ -134,7 +178,7 @@
       "id": "https://schemas.kumwe.org/studio/v1/pattern.schema.json"
     },
     {
-      "digest": "sha256-WWBFJmWz4p0F1PhOwup1rgBJuAkelWZz83SJX7mshGE=",
+      "digest": "sha256-UyyZAvE8JJcZqrKucPPK4oy2HPELR3q+zAl3pWPkWOU=",
       "file": "plugin-manifest.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/plugin-manifest.schema.json"
     },
@@ -154,12 +198,22 @@
       "id": "https://schemas.kumwe.org/studio/v1/provenance.schema.json"
     },
     {
-      "digest": "sha256-PKyCGI95WZ6Uojq9u5HvS2wwWU97+V+nmsY4l/Vc040=",
+      "digest": "sha256-cu3tmXzzoKCru9GNHj7QiUbprOf+zrcuiUhQZ3iTX1M=",
+      "file": "renderer-web-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/renderer-web-vector.schema.json"
+    },
+    {
+      "digest": "sha256-/DKHbScEb8525pjXQIhQipCSnS90y21f+2L8JMnRqJc=",
+      "file": "reusable-content-type.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/reusable-content-type.schema.json"
+    },
+    {
+      "digest": "sha256-74OcoS9iGzRnDOjo/opHhlXZdxMLcCUkw0Ol4ipzkws=",
       "file": "rich-text-projection.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/rich-text-projection.schema.json"
     },
     {
-      "digest": "sha256-PgFfnylfsJzq7B0wQq1gAxYA0r6gMx+xiKeT3NiDVqc=",
+      "digest": "sha256-r+wYEvy3tvMdQhmU0272K1cklAiYcEiD7nICWDdFFPs=",
       "file": "rich-text.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/rich-text.schema.json"
     },
@@ -174,10 +228,50 @@
       "id": "https://schemas.kumwe.org/studio/v1/schema-profile.schema.json"
     },
     {
-      "digest": "sha256-FC0lGnAqTIdHLvlwbGyYGdXEK5mwtyhdyrCwt7WzVhY=",
+      "digest": "sha256-JyV/s49f+XgMI+zBVAmx9UgCXwK1qpMBWR7flnu9NW4=",
+      "file": "studio-browser-assets.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-browser-assets.schema.json"
+    },
+    {
+      "digest": "sha256-3jvAa7VGd6F7uAOR82AcTOSMGXWvgaMVmGsG1UzSXiI=",
+      "file": "studio-chart.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-chart.schema.json"
+    },
+    {
+      "digest": "sha256-LK81tgJb05u/pwRymTrccKbZiQHD7QXMYv14myilfGs=",
       "file": "studio-config.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/studio-config.schema.json"
     },
+    {
+      "digest": "sha256-T37m573XBWGK0mV7UAN/r+juuJ1Q5/cVen2B6iwPzw4=",
+      "file": "studio-deployment.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-deployment.schema.json"
+    },
+    {
+      "digest": "sha256-SAP1i3VfZS51FRsqnN2frFxE/UmI9xEUsSREUp/cA+E=",
+      "file": "studio-drawing.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-drawing.schema.json"
+    },
+    {
+      "digest": "sha256-6jp6QkIqqUrNSVAQJHOlK8BCb8vdAZF5QRZmyRUqfgM=",
+      "file": "studio-money.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-money.schema.json"
+    },
+    {
+      "digest": "sha256-+dyYyHfQcUz4n5BUNMmGODJ6J7n2ysm9/+rWpSrbODA=",
+      "file": "studio-presentation.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-presentation.schema.json"
+    },
+    {
+      "digest": "sha256-mQ98exmrEHcyy26sSav8dQ65BCdswHDh2zGvTkdlfB8=",
+      "file": "studio-release.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-release.schema.json"
+    },
+    {
+      "digest": "sha256-txf6OXjSyFvOcoepU01qNY2WWlTyDA3iquMVXrFC2tQ=",
+      "file": "studio-table.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-table.schema.json"
+    },
     {
       "digest": "sha256-xzhCb8J2nx+K6kBMciFj1glB4Q6jT8+KUdbUBsNM4h8=",
       "file": "theme.schema.json",

package/schemas/plugin-manifest.schema.json

@@ -52,6 +52,7 @@
         "properties": {
           "kind": {
             "enum": [
+              "authoring-target",
               "block",
               "command",
               "design-vocabulary",

package/schemas/renderer-web-vector.schema.json

@@ -0,0 +1,273 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/renderer-web-vector.schema.json",
+  "title": "Studio renderer-web conformance vector",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["id", "coverage", "roots", "bindings", "media", "expect"],
+  "properties": {
+    "id": { "$ref": "common.schema.json#/$defs/stableId" },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["blockTypes", "behaviors", "presentation", "security"],
+      "properties": {
+        "blockTypes": {
+          "type": "array",
+          "maxItems": 100,
+          "uniqueItems": true,
+          "items": { "$ref": "common.schema.json#/$defs/qualifiedName" }
+        },
+        "behaviors": {
+          "type": "array",
+          "maxItems": 50,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "accordion-native",
+              "countdown",
+              "dialog",
+              "lightbox",
+              "navigation-disclosure",
+              "notice-dismiss",
+              "popover",
+              "slideshow",
+              "tabs"
+            ]
+          }
+        },
+        "presentation": {
+          "type": "array",
+          "maxItems": 50,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "alignment",
+              "inverse",
+              "markers",
+              "motion",
+              "position",
+              "print",
+              "responsive-visibility",
+              "scrolling",
+              "sizing",
+              "spacing"
+            ]
+          }
+        },
+        "security": {
+          "type": "array",
+          "maxItems": 50,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "active-media-deny",
+              "blob-default-deny",
+              "escaped-text",
+              "safe-url-deny",
+              "typed-data-fallback"
+            ]
+          }
+        }
+      }
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "allowBlobMedia": { "type": "boolean" },
+        "scopedStyles": {
+          "description": "Trusted structured host style input keyed by the exact Blueprint node ID.",
+          "type": "object",
+          "maxProperties": 100,
+          "propertyNames": { "$ref": "common.schema.json#/$defs/stableId" },
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["rules"],
+            "properties": {
+              "rules": {
+                "type": "array",
+                "maxItems": 100,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["target", "declarations"],
+                  "properties": {
+                    "target": {
+                      "enum": ["action", "content", "heading", "media", "self"]
+                    },
+                    "declarations": {
+                      "type": "object",
+                      "maxProperties": 50,
+                      "propertyNames": {
+                        "enum": [
+                          "background-color",
+                          "border-color",
+                          "border-radius",
+                          "border-style",
+                          "border-width",
+                          "color",
+                          "font-family",
+                          "font-size",
+                          "font-style",
+                          "font-weight",
+                          "gap",
+                          "letter-spacing",
+                          "line-height",
+                          "margin-block",
+                          "margin-inline",
+                          "max-inline-size",
+                          "min-block-size",
+                          "opacity",
+                          "padding-block",
+                          "padding-inline",
+                          "text-align",
+                          "text-decoration",
+                          "text-transform"
+                        ]
+                      },
+                      "additionalProperties": {
+                        "type": "string",
+                        "maxLength": 256,
+                        "pattern": "^(?:#[0-9A-Fa-f]{3,8}|-?[0-9]+(?:\\.[0-9]+)?(?:ch|em|rem|%|px)?|[a-z][a-z0-9 -]{0,126}|var\\(--studio-[a-z0-9-]{1,100}\\))$"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "roots": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 100,
+      "items": { "$ref": "blueprint.schema.json#/$defs/node" }
+    },
+    "bindings": {
+      "type": "array",
+      "maxItems": 1000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["nodeId", "port", "value"],
+        "properties": {
+          "nodeId": { "$ref": "common.schema.json#/$defs/stableId" },
+          "port": { "$ref": "common.schema.json#/$defs/localName" },
+          "value": { "$ref": "common.schema.json#/$defs/jsonValue" }
+        }
+      }
+    },
+    "media": {
+      "type": "array",
+      "maxItems": 1000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["assetId", "src", "altText"],
+        "properties": {
+          "assetId": { "$ref": "common.schema.json#/$defs/stableId" },
+          "src": { "type": "string", "minLength": 1, "maxLength": 2048 },
+          "altText": { "type": "string", "maxLength": 5000 },
+          "mediaType": { "type": "string", "maxLength": 255 },
+          "caption": { "type": "string", "maxLength": 20000 },
+          "width": { "type": "integer", "minimum": 1, "maximum": 100000 },
+          "height": { "type": "integer", "minimum": 1, "maximum": 100000 }
+        }
+      }
+    },
+    "expect": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "htmlContains",
+        "htmlExcludes",
+        "htmlBytes",
+        "htmlSha256",
+        "cssBytes",
+        "cssContains",
+        "cssSha256",
+        "publicStyleAsset",
+        "enhancements",
+        "activationMarkers"
+      ],
+      "properties": {
+        "activationMarkers": {
+          "description": "The complete renderer-emitted data-attribute vocabulary a public enhancement runtime is allowed to discover in this vector.",
+          "type": "array",
+          "maxItems": 100,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 12,
+            "maxLength": 100,
+            "pattern": "^data-studio-[a-z0-9]+(?:-[a-z0-9]+)*$"
+          }
+        },
+        "htmlContains": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "maxLength": 10000 }
+        },
+        "htmlExcludes": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "maxLength": 10000 }
+        },
+        "htmlBytes": {
+          "description": "Exact UTF-8 byte length of the canonical renderer HTML, closing activation-marker topology as wire output.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1048576
+        },
+        "htmlSha256": {
+          "description": "Lowercase SHA-256 of the exact canonical renderer HTML bytes.",
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "cssContains": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "maxLength": 10000 }
+        },
+        "cssBytes": {
+          "description": "Exact UTF-8 byte length of the canonical compact renderer stylesheet.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 262144
+        },
+        "cssSha256": {
+          "description": "Lowercase SHA-256 of the exact canonical renderer stylesheet bytes.",
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "publicStyleAsset": {
+          "$ref": "studio-browser-assets.schema.json#/$defs/publicStyleAsset"
+        },
+        "enhancements": {
+          "type": "array",
+          "maxItems": 100,
+          "items": {
+            "enum": [
+              "chart",
+              "countdown",
+              "diagram",
+              "dialog",
+              "lightbox",
+              "math",
+              "motion",
+              "navigation",
+              "notice",
+              "popover",
+              "slideshow",
+              "tabs"
+            ]
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/reusable-content-type.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/reusable-content-type.schema.json",
+  "title": "Studio host-owned reusable content type projection",
+  "description": "The host-facing definition that coordinates exact Model and Blueprint revisions. It is not a portable Studio artifact and never contains Entry values.",
+  "$ref": "#/$defs/definition",
+  "$defs": {
+    "reference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "revision"],
+      "properties": {
+        "id": { "$ref": "common.schema.json#/$defs/stableId" },
+        "version": { "$ref": "common.schema.json#/$defs/semanticVersion" },
+        "revision": { "$ref": "common.schema.json#/$defs/revision" }
+      }
+    },
+    "authoringPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["modes", "itemComposition"],
+      "properties": {
+        "modes": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 3,
+          "uniqueItems": true,
+          "items": { "enum": ["model", "blueprint", "content"] }
+        },
+        "itemComposition": { "enum": ["denied", "overrides"] }
+      }
+    },
+    "definition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contractVersion",
+        "kind",
+        "id",
+        "version",
+        "revision",
+        "label",
+        "status",
+        "model",
+        "blueprint",
+        "authoringPolicy"
+      ],
+      "properties": {
+        "contractVersion": { "$ref": "common.schema.json#/$defs/contractVersion" },
+        "kind": { "const": "reusable-content-type" },
+        "id": { "$ref": "common.schema.json#/$defs/stableId" },
+        "version": { "$ref": "common.schema.json#/$defs/semanticVersion" },
+        "revision": { "$ref": "common.schema.json#/$defs/revision" },
+        "label": { "$ref": "common.schema.json#/$defs/messageReference" },
+        "status": { "enum": ["draft", "published", "retired"] },
+        "model": { "$ref": "common.schema.json#/$defs/lockedArtifactReference" },
+        "blueprint": { "$ref": "common.schema.json#/$defs/lockedArtifactReference" },
+        "authoringPolicy": { "$ref": "#/$defs/authoringPolicy" },
+        "extensions": { "$ref": "common.schema.json#/$defs/extensions" }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["reference", "label", "model", "blueprint"],
+      "properties": {
+        "reference": { "$ref": "#/$defs/reference" },
+        "label": { "$ref": "common.schema.json#/$defs/messageReference" },
+        "model": { "$ref": "common.schema.json#/$defs/lockedArtifactReference" },
+        "blueprint": { "$ref": "common.schema.json#/$defs/lockedArtifactReference" }
+      }
+    },
+    "listQuery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["targetId", "resourceContext", "limit"],
+      "properties": {
+        "targetId": { "$ref": "common.schema.json#/$defs/qualifiedName" },
+        "resourceContext": { "$ref": "common.schema.json#/$defs/resourceContext" },
+        "cursor": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "limit": { "type": "integer", "minimum": 1, "maximum": 100 },
+        "search": { "type": "string", "maxLength": 500 }
+      }
+    },
+    "listPage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["items"],
+      "properties": {
+        "items": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/summary" }
+        },
+        "nextCursor": { "type": "string", "minLength": 1, "maxLength": 500 }
+      }
+    }
+  }
+}

package/schemas/rich-text-projection.schema.json

@@ -24,7 +24,16 @@
       "additionalProperties": false,
       "required": ["type", "text", "spans", "embeds"],
       "properties": {
-        "type": { "enum": ["heading", "horizontalRule", "paragraph"] },
+        "type": {
+          "enum": [
+            "checklistItem",
+            "codeBlock",
+            "heading",
+            "horizontalRule",
+            "paragraph",
+            "tableCell"
+          ]
+        },
         "text": {
           "type": "string",
           "maxLength": 250000
@@ -51,9 +60,9 @@
         "marks": {
           "type": "array",
           "minItems": 1,
-          "maxItems": 4,
+          "maxItems": 5,
           "uniqueItems": true,
-          "items": { "enum": ["bold", "code", "italic", "strike"] }
+          "items": { "enum": ["bold", "code", "highlight", "italic", "strike"] }
         }
       }
     },