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

package/schemas/preview-message.schema.json

@@ -31,7 +31,20 @@
       "minimum": 0
     },
     "type": {
-      "$ref": "common.schema.json#/$defs/qualifiedName"
+      "enum": [
+        "studio.preview/activated",
+        "studio.preview/dispose",
+        "studio.preview/error",
+        "studio.preview/measure",
+        "studio.preview/measurements",
+        "studio.preview/ready",
+        "studio.preview/reload",
+        "studio.preview/render",
+        "studio.preview/rendered",
+        "studio.preview/select",
+        "studio.preview/teardown",
+        "studio.preview/viewport"
+      ]
     },
     "payload": {
       "type": "object",
@@ -239,6 +252,12 @@
     }
   ],
   "$defs": {
+    "previewMarker": {
+      "description": "A deterministic marker for one node in a canonical draft: the draft digest followed by its zero-based Blueprint preorder ordinal.",
+      "type": "string",
+      "pattern": "^studio\\.preview/node/[0-9a-f]{64}/(?:0|[1-9][0-9]{0,4})(?![\\s\\S])",
+      "maxLength": 90
+    },
     "ready": {
       "type": "object",
       "additionalProperties": false,
@@ -262,7 +281,7 @@
     "render": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["artifactId", "draftDigest", "viewport"],
+      "required": ["artifactId", "draftDigest", "draftRevision", "requestId", "viewport"],
       "properties": {
         "artifactId": {
           "$ref": "common.schema.json#/$defs/stableId"
@@ -274,6 +293,10 @@
         "draftRevision": {
           "$ref": "common.schema.json#/$defs/revision"
         },
+        "requestId": {
+          "$ref": "common.schema.json#/$defs/stableId",
+          "description": "A session-unique render attempt identifier. Retries use a new identifier even when draft and viewport are unchanged."
+        },
         "viewport": {
           "$ref": "common.schema.json#/$defs/localName"
         }
@@ -282,24 +305,29 @@
     "rendered": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["draftDigest", "markers", "diagnostics"],
+      "required": ["requestId", "draftDigest", "markers", "markerMap", "diagnostics"],
       "properties": {
         "draftDigest": {
           "type": "string",
           "pattern": "^[a-f0-9]{64}(?![\\s\\S])"
         },
+        "requestId": {
+          "$ref": "common.schema.json#/$defs/stableId",
+          "description": "The exact render attempt this response settles."
+        },
         "markers": {
           "type": "array",
           "maxItems": 100000,
+          "uniqueItems": true,
           "items": {
-            "$ref": "common.schema.json#/$defs/stableId"
+            "$ref": "#/$defs/previewMarker"
           }
         },
         "markerMap": {
           "type": "object",
           "maxProperties": 100000,
           "propertyNames": {
-            "$ref": "common.schema.json#/$defs/stableId"
+            "$ref": "#/$defs/previewMarker"
           },
           "additionalProperties": {
             "$ref": "common.schema.json#/$defs/stableId"
@@ -334,13 +362,16 @@
       "required": ["requestId", "markers"],
       "properties": {
         "requestId": {
-          "$ref": "common.schema.json#/$defs/stableId"
+          "$ref": "common.schema.json#/$defs/stableId",
+          "description": "A session-unique measurement attempt identifier, never reused for another render or measurement."
         },
         "markers": {
           "type": "array",
+          "minItems": 1,
           "maxItems": 1000,
+          "uniqueItems": true,
           "items": {
-            "$ref": "common.schema.json#/$defs/stableId"
+            "$ref": "#/$defs/previewMarker"
           }
         }
       }
@@ -361,7 +392,7 @@
           "type": "object",
           "maxProperties": 1000,
           "propertyNames": {
-            "$ref": "common.schema.json#/$defs/stableId"
+            "$ref": "#/$defs/previewMarker"
           },
           "additionalProperties": {
             "type": "array",
@@ -375,8 +406,9 @@
         "unknown": {
           "type": "array",
           "maxItems": 1000,
+          "uniqueItems": true,
           "items": {
-            "$ref": "common.schema.json#/$defs/stableId"
+            "$ref": "#/$defs/previewMarker"
           }
         },
         "viewport": {
@@ -492,8 +524,8 @@
           "enum": ["activate", "context-menu", "focus"]
         },
         "marker": {
-          "description": "The opaque marker the renderer associated with the region. It carries nothing beyond the node identity the render already published.",
-          "$ref": "common.schema.json#/$defs/stableId"
+          "description": "A marker from the renderer's currently accepted inventory. The channel drops invented and stale markers.",
+          "$ref": "#/$defs/previewMarker"
         }
       }
     },
@@ -519,7 +551,7 @@
             "height": {
               "description": "Bounded CSS-pixel height.",
               "type": "integer",
-              "minimum": 120,
+              "minimum": 240,
               "maximum": 10000
             },
             "width": {

package/schemas/preview-vector.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/preview-vector.schema.json",
+  "title": "Studio preview identity conformance vector",
+  "description": "One complete Blueprint draft, its exact render-attempt identity, and the SHA-256 plus deterministic marker inventory every implementation must reproduce under the preview identity profile.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contractVersion",
+    "kind",
+    "id",
+    "description",
+    "profile",
+    "protocolVersion",
+    "draft",
+    "render",
+    "expect"
+  ],
+  "properties": {
+    "contractVersion": { "$ref": "common.schema.json#/$defs/contractVersion" },
+    "kind": { "const": "preview-vector" },
+    "id": { "$ref": "common.schema.json#/$defs/stableId" },
+    "description": { "type": "string", "minLength": 1, "maxLength": 1000 },
+    "profile": { "const": "studio.profile/preview-identity-v1" },
+    "protocolVersion": { "const": "0.1.0-draft.2" },
+    "draft": { "$ref": "blueprint.schema.json" },
+    "render": { "$ref": "preview-message.schema.json#/$defs/render" },
+    "expect": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["draftDigest", "markers", "markerMap"],
+      "properties": {
+        "draftDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}(?![\\s\\S])"
+        },
+        "markers": {
+          "type": "array",
+          "maxItems": 100000,
+          "uniqueItems": true,
+          "items": { "$ref": "preview-message.schema.json#/$defs/previewMarker" }
+        },
+        "markerMap": {
+          "type": "object",
+          "maxProperties": 100000,
+          "propertyNames": { "$ref": "preview-message.schema.json#/$defs/previewMarker" },
+          "additionalProperties": { "$ref": "common.schema.json#/$defs/stableId" }
+        }
+      }
+    }
+  }
+}

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