@kumwe/studio-protocol 0.1.0-alpha.5 → 0.1.0-rc.1

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,160 @@
+{
+  "$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" } }
+    },
+    "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", "cssContains", "enhancements"],
+      "properties": {
+        "htmlContains": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "maxLength": 10000 }
+        },
+        "htmlExcludes": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "maxLength": 10000 }
+        },
+        "cssContains": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "maxLength": 10000 }
+        },
+        "enhancements": {
+          "type": "array",
+          "maxItems": 100,
+          "items": {
+            "enum": [
+              "chart",
+              "countdown",
+              "diagram",
+              "dialog",
+              "lightbox",
+              "math",
+              "motion",
+              "navigation",
+              "notice",
+              "popover",
+              "slideshow",
+              "tabs"
+            ]
+          }
+        }
+      }
+    }
+  }
+}

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

package/schemas/rich-text.schema.json

@@ -24,7 +24,11 @@
         { "$ref": "#/$defs/blockquote" },
         { "$ref": "#/$defs/bulletList" },
         { "$ref": "#/$defs/orderedList" },
-        { "$ref": "#/$defs/horizontalRule" }
+        { "$ref": "#/$defs/horizontalRule" },
+        { "$ref": "#/$defs/checklist" },
+        { "$ref": "#/$defs/table" },
+        { "$ref": "#/$defs/callout" },
+        { "$ref": "#/$defs/codeBlock" }
       ]
     },
     "paragraph": {
@@ -133,6 +137,131 @@
         "type": { "const": "horizontalRule" }
       }
     },
+    "checklist": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "content"],
+      "properties": {
+        "type": { "const": "checklist" },
+        "content": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 500,
+          "items": { "$ref": "#/$defs/checklistItem" }
+        }
+      }
+    },
+    "checklistItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "attrs"],
+      "properties": {
+        "type": { "const": "checklistItem" },
+        "attrs": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["checked", "level"],
+          "properties": {
+            "checked": { "type": "boolean" },
+            "level": { "type": "integer", "minimum": 0, "maximum": 4 }
+          }
+        },
+        "content": {
+          "type": "array",
+          "maxItems": 5000,
+          "items": { "$ref": "#/$defs/inline" }
+        }
+      }
+    },
+    "table": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "attrs", "content"],
+      "properties": {
+        "type": { "const": "table" },
+        "attrs": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["header"],
+          "properties": { "header": { "type": "boolean" } }
+        },
+        "content": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 200,
+          "items": { "$ref": "#/$defs/tableRow" }
+        }
+      }
+    },
+    "tableRow": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "content"],
+      "properties": {
+        "type": { "const": "tableRow" },
+        "content": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 50,
+          "items": { "$ref": "#/$defs/tableCell" }
+        }
+      }
+    },
+    "tableCell": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": { "const": "tableCell" },
+        "content": {
+          "type": "array",
+          "maxItems": 5000,
+          "items": { "$ref": "#/$defs/inline" }
+        }
+      }
+    },
+    "callout": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "attrs", "content"],
+      "properties": {
+        "type": { "const": "callout" },
+        "attrs": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["tone"],
+          "properties": {
+            "tone": { "enum": ["danger", "info", "success", "warning"] }
+          }
+        },
+        "content": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 5000,
+          "items": { "$ref": "#/$defs/block" }
+        }
+      }
+    },
+    "codeBlock": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "attrs", "text"],
+      "properties": {
+        "type": { "const": "codeBlock" },
+        "attrs": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["language"],
+          "properties": {
+            "language": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9+_.#-]{0,63}$"
+            }
+          }
+        },
+        "text": { "type": "string", "maxLength": 250000 }
+      }
+    },
     "hardBreak": {
       "type": "object",
       "additionalProperties": false,
@@ -163,12 +292,32 @@
       "oneOf": [{ "$ref": "#/$defs/text" }, { "$ref": "#/$defs/hardBreak" }]
     },
     "mark": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["type"],
-      "properties": {
-        "type": { "enum": ["bold", "code", "italic", "strike"] }
-      }
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type"],
+          "properties": {
+            "type": { "enum": ["bold", "code", "italic", "strike"] }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "attrs"],
+          "properties": {
+            "type": { "const": "highlight" },
+            "attrs": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["tone"],
+              "properties": {
+                "tone": { "enum": ["accent", "danger", "info", "success", "warning"] }
+              }
+            }
+          }
+        }
+      ]
     }
   }
 }

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])"
+    }
+  }
+}