@kumwe/studio-protocol 0.1.0-alpha.5 → 0.1.0-alpha.6

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/schema-profile-vector.schema.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/schema-profile-vector.schema.json",
+  "title": "Studio property-schema profile conformance vector",
+  "description": "One portable admission or instance-validation assertion for studio.profile/schema-property. Rejection vectors deliberately carry schemas outside the profile, so the schema member is bounded JSON rather than a reference to the profile meta-schema.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "kind", "id", "description", "profile", "schema", "expect"],
+  "properties": {
+    "contractVersion": { "$ref": "common.schema.json#/$defs/contractVersion" },
+    "kind": { "const": "schema-profile-vector" },
+    "id": { "$ref": "common.schema.json#/$defs/stableId" },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 500
+    },
+    "profile": { "const": "studio.profile/schema-property" },
+    "boundary": { "$ref": "#/$defs/limitBoundary" },
+    "schema": {
+      "description": "The candidate schema. This is intentionally unconstrained so invalid-root and unsafe-member vectors remain expressible; the vector file itself remains bounded by the corpus size policy. Values JSON cannot represent are covered by implementation tests."
+    },
+    "expect": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["outcome", "instances"],
+          "properties": {
+            "outcome": { "const": "accepted" },
+            "instances": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 50,
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["value", "valid"],
+                "properties": {
+                  "value": { "$ref": "common.schema.json#/$defs/jsonValue" },
+                  "valid": { "type": "boolean" },
+                  "diagnostic": { "$ref": "#/$defs/instanceDiagnostic" }
+                },
+                "allOf": [
+                  {
+                    "if": { "properties": { "valid": { "const": true } } },
+                    "then": { "properties": { "diagnostic": false } },
+                    "else": {
+                      "required": ["diagnostic"],
+                      "properties": {
+                        "diagnostic": { "$ref": "#/$defs/instanceDiagnostic" }
+                      }
+                    }
+                  }
+                ]
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["outcome", "code", "schemaPath"],
+          "properties": {
+            "outcome": { "const": "rejected" },
+            "code": {
+              "enum": [
+                "invalid-root",
+                "unsupported-keyword",
+                "invalid-keyword-value",
+                "unsafe-member",
+                "limit-exceeded",
+                "invalid-reference",
+                "recursive-schema"
+              ]
+            },
+            "schemaPath": { "$ref": "#/$defs/jsonPointer" }
+          }
+        }
+      ]
+    }
+  },
+  "$defs": {
+    "limitBoundary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["limit", "position", "value"],
+      "properties": {
+        "limit": {
+          "enum": [
+            "maxAlternatives",
+            "maxDescriptionLength",
+            "maxEnumMembers",
+            "maxExamples",
+            "maxJsonDepth",
+            "maxJsonItems",
+            "maxJsonProperties",
+            "maxObjectKeyLength",
+            "maxPropertyNames",
+            "maxReferenceLength",
+            "maxReferences",
+            "maxSchemaBytes",
+            "maxSchemaDepth",
+            "maxSchemaMapProperties",
+            "maxSchemaNodes",
+            "maxTitleLength"
+          ]
+        },
+        "position": { "enum": ["at-limit", "over-limit"] },
+        "value": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "instanceDiagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["instancePath", "keyword"],
+      "properties": {
+        "instancePath": { "$ref": "#/$defs/jsonPointer" },
+        "keyword": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "pattern": "^[A-Za-z$][A-Za-z0-9$]*(?![\\s\\S])"
+        }
+      }
+    },
+    "jsonPointer": {
+      "type": "string",
+      "maxLength": 1000,
+      "pattern": "^(?:/(?:[^~\\u0000-\\u001F\\u007F]|~[01])*)*(?![\\s\\S])"
+    }
+  }
+}

package/schemas/schema-profile.schema.json

@@ -2,7 +2,18 @@
   "$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",
-  "$ref": "#/$defs/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",
@@ -53,14 +64,14 @@
         "$ref": {
           "type": "string",
           "maxLength": 500,
-          "pattern": "^#(?:/[^\\u0000-\\u001F\\u007F]*)?(?![\\s\\S])"
+          "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": "common.schema.json#/$defs/jsonValue" },
-        "default": { "$ref": "common.schema.json#/$defs/jsonValue" },
+        "const": { "$ref": "#/$defs/jsonValue" },
+        "default": { "$ref": "#/$defs/jsonValue" },
         "dependentRequired": {
           "type": "object",
           "maxProperties": 512,
@@ -68,6 +79,7 @@
           "additionalProperties": {
             "type": "array",
             "maxItems": 512,
+            "uniqueItems": true,
             "items": { "$ref": "common.schema.json#/$defs/safeJsonMemberName" }
           }
         },
@@ -75,13 +87,15 @@
         "else": { "$ref": "#/$defs/subschema" },
         "enum": {
           "type": "array",
+          "minItems": 1,
           "maxItems": 1024,
-          "items": { "$ref": "common.schema.json#/$defs/jsonValue" }
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/jsonValue" }
         },
         "examples": {
           "type": "array",
           "maxItems": 100,
-          "items": { "$ref": "common.schema.json#/$defs/jsonValue" }
+          "items": { "$ref": "#/$defs/jsonValue" }
         },
         "exclusiveMaximum": { "type": "number" },
         "exclusiveMinimum": { "type": "number" },
@@ -105,6 +119,7 @@
         "required": {
           "type": "array",
           "maxItems": 512,
+          "uniqueItems": true,
           "items": { "$ref": "common.schema.json#/$defs/safeJsonMemberName" }
         },
         "then": { "$ref": "#/$defs/subschema" },
@@ -127,6 +142,7 @@
     },
     "schemaArray": {
       "type": "array",
+      "minItems": 1,
       "maxItems": 64,
       "items": { "$ref": "#/$defs/subschema" }
     },
@@ -136,6 +152,25 @@
       "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" }]
     },
@@ -145,16 +180,21 @@
     "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
+        "maxSchemaNodes": 1024,
+        "maxTitleLength": 1000
       }
     }
   }