@kumwe/studio-testkit 0.1.0-alpha.10

package/invalid/host-sequence.pending-expectation.json

@@ -0,0 +1,52 @@
+{
+  "schema": "host-sequence-vector.schema.json",
+  "description": "A pending invocation cannot declare a settled outcome before an explicit settle step.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "host-sequence-vector",
+    "id": "vector.host-sequence.invalid.pending-expectation",
+    "description": "Invalid pending sequence step.",
+    "profile": "studio.profile/host-baseline-v2",
+    "assertions": ["in-flight-preview-cancellation"],
+    "idempotencyPolicy": {
+      "scopeFields": ["idempotencyKey", "operationId", "resourceContextKey", "sessionGeneration"],
+      "argumentCanonicalization": "canonical-json",
+      "intentContextFields": ["expectedRevision", "locale", "protocolVersion"],
+      "absentOptionalFields": "omit",
+      "numberNormalization": "canonical-json",
+      "excludedContextFields": ["requestId", "traceContext"]
+    },
+    "given": { "artifacts": [], "permissions": [], "sessionGeneration": "session-r1" },
+    "steps": [
+      {
+        "action": "invoke",
+        "id": "render-pending",
+        "port": "preview",
+        "operation": "render",
+        "context": {
+          "operationId": "studio.operation/preview.render",
+          "protocolVersion": "0.1.0-draft.2",
+          "requestId": "requests/preview-render",
+          "resourceContextKey": "contexts/vector",
+          "sessionGeneration": "session-r1"
+        },
+        "argument": {
+          "artifactId": "vector.blueprint",
+          "draftDigest": "b03cc45a784d7cd4d2836e24694d42f9c8e2ee3dde3ceca79b0a147436db47c6",
+          "draftRevision": "vector-blueprint-r1",
+          "requestId": "renders/pending-invalid-1",
+          "viewport": "desktop"
+        },
+        "completion": "pending",
+        "expect": { "outcome": "result", "value": "rendered" }
+      },
+      {
+        "action": "settle",
+        "id": "render-settled",
+        "invocation": "render-pending",
+        "expect": { "outcome": "error", "category": "cancelled", "retryable": false }
+      }
+    ],
+    "expectFinal": { "pendingPreviewRenders": 0, "previewDeliveries": [] }
+  }
+}

package/invalid/host-sequence.preview-render-missing-request-id.json

@@ -0,0 +1,50 @@
+{
+  "schema": "host-sequence-vector.schema.json",
+  "description": "A preview render invocation must carry the complete draft.2 render identity, including its session-unique request identifier.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "host-sequence-vector",
+    "id": "vector.host-sequence.invalid.preview-render-missing-request-id",
+    "description": "Invalid preview render identity.",
+    "profile": "studio.profile/host-baseline-v2",
+    "assertions": ["cross-context-cancellation-isolation"],
+    "idempotencyPolicy": {
+      "scopeFields": ["idempotencyKey", "operationId", "resourceContextKey", "sessionGeneration"],
+      "argumentCanonicalization": "canonical-json",
+      "intentContextFields": ["expectedRevision", "locale", "protocolVersion"],
+      "absentOptionalFields": "omit",
+      "numberNormalization": "canonical-json",
+      "excludedContextFields": ["requestId", "traceContext"]
+    },
+    "given": { "artifacts": [], "permissions": [], "sessionGeneration": "session-r1" },
+    "steps": [
+      {
+        "action": "invoke",
+        "id": "render-missing-request-id",
+        "port": "preview",
+        "operation": "render",
+        "context": {
+          "operationId": "studio.operation/preview.render",
+          "protocolVersion": "0.1.0-draft.2",
+          "requestId": "requests/preview-render",
+          "resourceContextKey": "contexts/vector",
+          "sessionGeneration": "session-r1"
+        },
+        "argument": {
+          "artifactId": "vector.blueprint",
+          "draftDigest": "b03cc45a784d7cd4d2836e24694d42f9c8e2ee3dde3ceca79b0a147436db47c6",
+          "draftRevision": "vector-blueprint-r1",
+          "viewport": "desktop"
+        },
+        "completion": "pending"
+      },
+      {
+        "action": "settle",
+        "id": "render-settled",
+        "invocation": "render-missing-request-id",
+        "expect": { "outcome": "error", "category": "invalid-request", "retryable": false }
+      }
+    ],
+    "expectFinal": { "pendingPreviewRenders": 0, "previewDeliveries": [] }
+  }
+}

package/invalid/inspector.empty-block-types.json

@@ -0,0 +1,20 @@
+{
+  "schema": "inspector.schema.json",
+  "description": "An inspector declares the block types it applies to; an empty list would silently apply to none.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "inspector",
+    "id": "org.example.catalog/price-inspector",
+    "version": "1.0.0",
+    "owner": {
+      "id": "org.example/catalog",
+      "version": "1.0.0"
+    },
+    "label": {
+      "key": "org.example.catalog/price-inspector",
+      "defaultMessage": "Price inspector"
+    },
+    "blockTypes": [],
+    "placement": "augment"
+  }
+}

package/invalid/media-reference.missing-accessibility.json

@@ -0,0 +1,25 @@
+{
+  "schema": "media-reference.schema.json",
+  "description": "Every media reference declares an explicit accessibility mode.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "media-reference",
+    "assetId": "media/trail-backpack-front",
+    "assetRevision": "media-r4",
+    "usage": "org.example.catalog/product-hero",
+    "renditionIntent": {
+      "role": "hero",
+      "fit": "cover",
+      "preferredMediaTypes": ["image/avif", "image/webp"]
+    },
+    "focalPoint": {
+      "x": 0.5,
+      "y": 0.46
+    },
+    "cropIntent": {
+      "mode": "aspect-ratio",
+      "width": 4,
+      "height": 3
+    }
+  }
+}

package/invalid/media-upload-grant.insecure-url.json

@@ -0,0 +1,14 @@
+{
+  "schema": "media-upload-grant.schema.json",
+  "description": "An upload destination is always an https URL the host controls.",
+  "value": {
+    "expiresAt": "2026-08-18T23:30:00Z",
+    "method": "PUT",
+    "plan": {
+      "maximumBytes": 52428800,
+      "resumable": false
+    },
+    "uploadId": "uploads/7f2c",
+    "url": "http://media.example.org/uploads/7f2c"
+  }
+}

package/invalid/media-upload-session.complete-without-asset.json

@@ -0,0 +1,20 @@
+{
+  "schema": "media-upload-session.schema.json",
+  "description": "A complete upload session must carry the accepted stable asset identity.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "media-upload-session",
+    "id": "uploads/2b6f0d31",
+    "request": {
+      "filename": "trail-backpack-side.jpg",
+      "mediaType": "image/jpeg",
+      "byteSize": 3145728,
+      "purpose": "org.example.catalog/product-gallery"
+    },
+    "state": "complete",
+    "progress": {
+      "transferredBytes": 3145728,
+      "totalBytes": 3145728
+    }
+  }
+}

package/invalid/migration.empty-artifact-kinds.json

@@ -0,0 +1,22 @@
+{
+  "schema": "migration.schema.json",
+  "description": "A migration declaration must cover at least one artifact kind.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "migration",
+    "id": "org.example.catalog/price-to-money",
+    "version": "1.1.0",
+    "owner": {
+      "id": "org.example/catalog",
+      "version": "1.1.0"
+    },
+    "label": {
+      "key": "org.example.catalog/price-to-money",
+      "defaultMessage": "Price becomes typed money"
+    },
+    "artifactKinds": [],
+    "sourceVersions": ">=1.0.0 <1.1.0",
+    "targetVersion": "1.1.0",
+    "lossClassification": "lossless"
+  }
+}

package/invalid/preview-message.activated-unknown-interaction.json

@@ -0,0 +1,16 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "Activation reports the closed interaction vocabulary, never an arbitrary input event.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 3,
+    "type": "studio.preview/activated",
+    "payload": {
+      "interaction": "hover",
+      "marker": "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0"
+    }
+  }
+}

package/invalid/preview-message.duplicate-marker.json

@@ -0,0 +1,24 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "A rendered marker inventory contains each canonical marker exactly once.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "studio.preview/rendered",
+    "payload": {
+      "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "markers": [
+        "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0",
+        "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0"
+      ],
+      "markerMap": {
+        "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0": "node-1"
+      },
+      "requestId": "renders/1",
+      "diagnostics": []
+    }
+  }
+}

package/invalid/preview-message.invalid-digest.json

@@ -0,0 +1,19 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "Render digests are lower-case hex sha-256 values.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-7f8d",
+    "sessionGeneration": "session-generation-1",
+    "sequence": 14,
+    "type": "studio.preview/render",
+    "payload": {
+      "artifactId": "org.example.blueprints/product-card",
+      "draftDigest": "not-a-digest",
+      "draftRevision": "product-card-r5-local-12",
+      "requestId": "renders/product-card-14",
+      "viewport": "expanded"
+    }
+  }
+}

package/invalid/preview-message.invalid-marker-grammar.json

@@ -0,0 +1,19 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "A preview marker binds one canonical draft digest to a bounded zero-based preorder ordinal.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "studio.preview/rendered",
+    "payload": {
+      "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "markers": ["markers/m1"],
+      "markerMap": { "markers/m1": "node-1" },
+      "requestId": "renders/1",
+      "diagnostics": []
+    }
+  }
+}

package/invalid/preview-message.missing-marker-map.json

@@ -0,0 +1,20 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "A rendered response must carry an exact marker-to-node map for its complete marker inventory.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "studio.preview/rendered",
+    "payload": {
+      "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "markers": [
+        "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0"
+      ],
+      "requestId": "renders/1",
+      "diagnostics": []
+    }
+  }
+}

package/invalid/preview-message.missing-render-request-id.json

@@ -0,0 +1,18 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "Every render attempt has a session-unique request identifier for exact callback correlation.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "studio.preview/render",
+    "payload": {
+      "artifactId": "blueprints/example",
+      "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "draftRevision": "blueprint-r1",
+      "viewport": "expanded"
+    }
+  }
+}

package/invalid/preview-message.unknown-type.json

@@ -0,0 +1,13 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "The draft.2 preview vocabulary is closed; unknown message types require a negotiated protocol revision.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "org.example.preview/custom",
+    "payload": {}
+  }
+}

package/invalid/preview-message.viewport-height-too-small.json

@@ -0,0 +1,13 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "Explicit preview viewport width and height are each bounded to at least 240 CSS pixels.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 3,
+    "type": "studio.preview/viewport",
+    "payload": { "height": 239 }
+  }
+}

package/invalid/preview-message.viewport-role-and-size.json

@@ -0,0 +1,16 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "A viewport instruction carries a semantic role or explicit dimensions, never both.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 3,
+    "type": "studio.preview/viewport",
+    "payload": {
+      "viewport": "compact",
+      "width": 1280
+    }
+  }
+}

package/invalid/preview-message.viewport-unsafe-role.json

@@ -0,0 +1,13 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "Semantic viewport roles use the safe local-name grammar.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 3,
+    "type": "studio.preview/viewport",
+    "payload": { "viewport": "constructor" }
+  }
+}

package/invalid/rich-text.embedded-html.json

@@ -0,0 +1,13 @@
+{
+  "schema": "rich-text.schema.json",
+  "description": "Rich text stores structured nodes only; raw HTML payloads are rejected.",
+  "value": {
+    "type": "doc",
+    "content": [
+      {
+        "type": "html",
+        "value": "<script>alert(1)</script>"
+      }
+    ]
+  }
+}

package/invalid/rich-text.unknown-mark.json

@@ -0,0 +1,19 @@
+{
+  "schema": "rich-text.schema.json",
+  "description": "Rich text only carries the closed portable mark set; unknown marks such as scripts are rejected.",
+  "value": {
+    "type": "doc",
+    "content": [
+      {
+        "type": "paragraph",
+        "content": [
+          {
+            "type": "text",
+            "text": "styled",
+            "marks": [{ "type": "script" }]
+          }
+        ]
+      }
+    ]
+  }
+}

package/invalid/studio-chart.script-config.json

@@ -0,0 +1,10 @@
+{
+  "schema": "studio-chart.schema.json",
+  "description": "Chart.js options and authored callbacks are not canonical Studio chart data.",
+  "value": {
+    "type": "bar",
+    "labels": ["Unsafe"],
+    "datasets": [{ "label": "Values", "values": [1] }],
+    "options": { "onClick": "alert(1)" }
+  }
+}

package/invalid/studio-drawing.svg-payload.json

@@ -0,0 +1,10 @@
+{
+  "schema": "studio-drawing.schema.json",
+  "description": "Drawing colors cannot carry CSS URLs or executable SVG payloads.",
+  "value": {
+    "width": 100,
+    "height": 100,
+    "alt": "Unsafe drawing",
+    "strokes": [{ "color": "url(javascript:alert(1))", "width": 2, "points": [{ "x": 1, "y": 1 }] }]
+  }
+}

package/invalid/studio-money.float.json

@@ -0,0 +1,8 @@
+{
+  "schema": "studio-money.schema.json",
+  "description": "Persisted money must use an exact decimal string rather than a binary float.",
+  "value": {
+    "amount": 19.99,
+    "currency": "USD"
+  }
+}

package/invalid/studio-presentation.css-injection.json

@@ -0,0 +1,8 @@
+{
+  "schema": "studio-presentation.schema.json",
+  "description": "Presentation intent rejects arbitrary CSS and selectors.",
+  "value": {
+    "position": "fixed;inset:0",
+    "style": "background:url(javascript:alert(1))"
+  }
+}

package/invalid/studio-table.html-cell.json

@@ -0,0 +1,8 @@
+{
+  "schema": "studio-table.schema.json",
+  "description": "Table data rejects cell objects carrying executable markup.",
+  "value": {
+    "columns": ["Name"],
+    "rows": [[{ "html": "<img src=x onerror=alert(1)>" }]]
+  }
+}

package/invalid/theme.unknown-member.json

@@ -0,0 +1,128 @@
+{
+  "schema": "theme.schema.json",
+  "description": "Theme documents are closed; arbitrary members such as raw CSS are rejected.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "theme",
+    "id": "org.example.themes/commerce",
+    "version": "1.0.0",
+    "revision": "commerce-theme-r3",
+    "owner": {
+      "id": "org.example/theme-package",
+      "version": "1.0.0"
+    },
+    "label": {
+      "key": "org.example.theme/commerce",
+      "defaultMessage": "Commerce"
+    },
+    "viewports": [
+      {
+        "id": "compact",
+        "label": {
+          "key": "studio.viewport/compact",
+          "defaultMessage": "Compact"
+        },
+        "order": 0,
+        "base": true,
+        "previewWidth": 360
+      },
+      {
+        "id": "medium",
+        "label": {
+          "key": "studio.viewport/medium",
+          "defaultMessage": "Medium"
+        },
+        "order": 1,
+        "base": false,
+        "previewWidth": 768
+      },
+      {
+        "id": "expanded",
+        "label": {
+          "key": "studio.viewport/expanded",
+          "defaultMessage": "Expanded"
+        },
+        "order": 2,
+        "base": false,
+        "previewWidth": 1440
+      }
+    ],
+    "designControls": [
+      {
+        "id": "gap",
+        "kind": "spacing-role",
+        "label": {
+          "key": "org.example.theme/gap",
+          "defaultMessage": "Gap"
+        },
+        "choices": [
+          {
+            "id": "small",
+            "label": {
+              "key": "org.example.theme/gap-small",
+              "defaultMessage": "Small"
+            }
+          },
+          {
+            "id": "large",
+            "label": {
+              "key": "org.example.theme/gap-large",
+              "defaultMessage": "Large"
+            }
+          }
+        ]
+      },
+      {
+        "id": "emphasis",
+        "kind": "typography-role",
+        "label": {
+          "key": "org.example.theme/emphasis",
+          "defaultMessage": "Emphasis"
+        },
+        "choices": [
+          {
+            "id": "price",
+            "label": {
+              "key": "org.example.theme/emphasis-price",
+              "defaultMessage": "Price emphasis"
+            }
+          }
+        ]
+      }
+    ],
+    "recipes": [
+      {
+        "id": "product-grid",
+        "blockType": "studio.core/grid",
+        "label": {
+          "key": "org.example.theme/product-grid",
+          "defaultMessage": "Product grid"
+        },
+        "designValues": {
+          "gap": "large"
+        }
+      }
+    ],
+    "renderers": [
+      {
+        "id": "org.example.renderer/twig",
+        "version": "1.0.0",
+        "surfaces": ["web", "preview"],
+        "exactPreview": true
+      }
+    ],
+    "blockSupport": [
+      {
+        "type": "studio.core/grid",
+        "versions": "^1.0.0",
+        "renderer": "org.example.renderer/twig"
+      },
+      {
+        "type": "org.example.catalog/price",
+        "versions": "^1.0.0",
+        "renderer": "org.example.renderer/twig"
+      }
+    ],
+    "customCss": ".hero { color: red }"
+  }
+}