@kumwe/studio-testkit 0.1.0-alpha.10

package/fixtures/host-operations.example.json

@@ -0,0 +1,270 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-operations",
+  "operations": [
+    {
+      "capability": "studio.operation/artifact.dependencies",
+      "expectsRevision": false,
+      "method": "dependencies",
+      "mutating": false,
+      "operation": "dependencies",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/dependencies"
+    },
+    {
+      "capability": "studio.operation/artifact.load",
+      "expectsRevision": false,
+      "method": "load",
+      "mutating": false,
+      "operation": "load",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/load"
+    },
+    {
+      "capability": "studio.operation/artifact.publish",
+      "expectsRevision": true,
+      "method": "publish",
+      "mutating": true,
+      "operation": "publish",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/publish"
+    },
+    {
+      "capability": "studio.operation/artifact.save",
+      "expectsRevision": true,
+      "method": "save",
+      "mutating": true,
+      "operation": "save",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/save"
+    },
+    {
+      "capability": "studio.operation/artifact.unpublish",
+      "expectsRevision": true,
+      "method": "unpublish",
+      "mutating": true,
+      "operation": "unpublish",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/unpublish"
+    },
+    {
+      "capability": "studio.operation/localization.messages",
+      "expectsRevision": false,
+      "method": "messages",
+      "mutating": false,
+      "operation": "messages",
+      "port": "localization",
+      "portCapability": "studio.port/localization",
+      "required": false,
+      "route": "localization/messages"
+    },
+    {
+      "capability": "studio.operation/media.abort-upload",
+      "expectsRevision": false,
+      "method": "abortUpload",
+      "mutating": true,
+      "operation": "abort-upload",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/abort-upload"
+    },
+    {
+      "capability": "studio.operation/media.authorize-upload",
+      "expectsRevision": false,
+      "method": "authorizeUpload",
+      "mutating": true,
+      "operation": "authorize-upload",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/authorize-upload"
+    },
+    {
+      "capability": "studio.operation/media.complete-upload",
+      "expectsRevision": false,
+      "method": "completeUpload",
+      "mutating": true,
+      "operation": "complete-upload",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/complete-upload"
+    },
+    {
+      "capability": "studio.operation/media.get",
+      "expectsRevision": false,
+      "method": "get",
+      "mutating": false,
+      "operation": "get",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/get"
+    },
+    {
+      "capability": "studio.operation/media.import-external",
+      "expectsRevision": false,
+      "method": "importExternal",
+      "mutating": true,
+      "operation": "import-external",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/import-external"
+    },
+    {
+      "capability": "studio.operation/media.list",
+      "expectsRevision": false,
+      "method": "list",
+      "mutating": false,
+      "operation": "list",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/list"
+    },
+    {
+      "capability": "studio.operation/media.upload-status",
+      "expectsRevision": false,
+      "method": "uploadStatus",
+      "mutating": false,
+      "operation": "upload-status",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/upload-status"
+    },
+    {
+      "capability": "studio.operation/model.get",
+      "expectsRevision": false,
+      "method": "get",
+      "mutating": false,
+      "operation": "get",
+      "port": "model",
+      "portCapability": "studio.port/model",
+      "required": false,
+      "route": "model/get"
+    },
+    {
+      "capability": "studio.operation/model.list",
+      "expectsRevision": false,
+      "method": "list",
+      "mutating": false,
+      "operation": "list",
+      "port": "model",
+      "portCapability": "studio.port/model",
+      "required": false,
+      "route": "model/list"
+    },
+    {
+      "capability": "studio.operation/permission.explain",
+      "expectsRevision": false,
+      "method": "explain",
+      "mutating": false,
+      "operation": "explain",
+      "port": "permission",
+      "portCapability": "studio.port/permission",
+      "required": false,
+      "route": "permission/explain"
+    },
+    {
+      "capability": "studio.operation/permission.refresh",
+      "expectsRevision": false,
+      "method": "refresh",
+      "mutating": false,
+      "operation": "refresh",
+      "port": "permission",
+      "portCapability": "studio.port/permission",
+      "required": false,
+      "route": "permission/refresh"
+    },
+    {
+      "capability": "studio.operation/preview.cancel",
+      "expectsRevision": false,
+      "method": "cancel",
+      "mutating": false,
+      "operation": "cancel",
+      "port": "preview",
+      "portCapability": "studio.port/preview",
+      "required": false,
+      "route": "preview/cancel"
+    },
+    {
+      "capability": "studio.operation/preview.render",
+      "expectsRevision": false,
+      "method": "render",
+      "mutating": false,
+      "operation": "render",
+      "port": "preview",
+      "portCapability": "studio.port/preview",
+      "required": false,
+      "route": "preview/render"
+    },
+    {
+      "capability": "studio.operation/recovery.discard",
+      "expectsRevision": false,
+      "method": "discard",
+      "mutating": true,
+      "operation": "discard",
+      "port": "recovery",
+      "portCapability": "studio.port/recovery",
+      "required": false,
+      "route": "recovery/discard"
+    },
+    {
+      "capability": "studio.operation/recovery.load",
+      "expectsRevision": false,
+      "method": "load",
+      "mutating": false,
+      "operation": "load",
+      "port": "recovery",
+      "portCapability": "studio.port/recovery",
+      "required": false,
+      "route": "recovery/load"
+    },
+    {
+      "capability": "studio.operation/recovery.store",
+      "expectsRevision": false,
+      "method": "store",
+      "mutating": true,
+      "operation": "store",
+      "port": "recovery",
+      "portCapability": "studio.port/recovery",
+      "required": false,
+      "route": "recovery/store"
+    },
+    {
+      "capability": "studio.operation/resource.search",
+      "expectsRevision": false,
+      "method": "search",
+      "mutating": false,
+      "operation": "search",
+      "port": "resource",
+      "portCapability": "studio.port/resource",
+      "required": false,
+      "route": "resource/search"
+    },
+    {
+      "capability": "studio.operation/telemetry.emit",
+      "expectsRevision": false,
+      "method": "emit",
+      "mutating": true,
+      "operation": "emit",
+      "port": "telemetry",
+      "portCapability": "studio.port/telemetry",
+      "required": false,
+      "route": "telemetry/emit"
+    }
+  ]
+}

package/fixtures/inspector.example.json

@@ -0,0 +1,17 @@
+{
+  "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": ["org.example.catalog/price"],
+  "placement": "augment",
+  "requiredCapability": "studio.capability/custom-inspectors"
+}

package/fixtures/media-asset.example.json

@@ -0,0 +1,29 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "media-asset",
+  "id": "media/trail-backpack-front",
+  "revision": "media-r4",
+  "state": "ready",
+  "mediaKind": "image",
+  "mediaType": "image/avif",
+  "byteSize": 483210,
+  "filename": "trail-backpack-front.avif",
+  "metadata": {
+    "width": 2400,
+    "height": 1800,
+    "altText": "Green trail backpack shown from the front",
+    "decorative": false,
+    "focalPoint": {
+      "x": 0.5,
+      "y": 0.46
+    }
+  },
+  "renditions": [
+    {
+      "id": "card",
+      "mediaType": "image/avif",
+      "width": 800,
+      "height": 600
+    }
+  ]
+}

package/fixtures/media-asset.processing.example.json

@@ -0,0 +1,15 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "media-asset",
+  "id": "media/trail-backpack-side",
+  "revision": "media-r1",
+  "state": "processing",
+  "mediaKind": "image",
+  "mediaType": "image/jpeg",
+  "byteSize": 7831420,
+  "filename": "trail-backpack-side.jpg",
+  "metadata": {
+    "altText": "Green trail backpack shown from the side",
+    "decorative": false
+  }
+}

package/fixtures/media-reference.example.json

@@ -0,0 +1,26 @@
+{
+  "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
+  },
+  "accessibility": {
+    "mode": "informative",
+    "altText": "Green trail backpack shown from the front",
+    "caption": "Trail Backpack in forest green"
+  }
+}

package/fixtures/media-upload-grant.example.json

@@ -0,0 +1,14 @@
+{
+  "expiresAt": "2026-08-18T23:30:00Z",
+  "headers": {
+    "X-Upload-Session": "uploads-7f2c"
+  },
+  "method": "PUT",
+  "plan": {
+    "chunkBytes": 5242880,
+    "maximumBytes": 52428800,
+    "resumable": true
+  },
+  "uploadId": "uploads/7f2c",
+  "url": "https://media.example.org/uploads/7f2c"
+}

package/fixtures/media-upload-session.transferring.example.json

@@ -0,0 +1,22 @@
+{
+  "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",
+    "checksum": "sha256-47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU="
+  },
+  "plan": {
+    "maximumBytes": 10485760,
+    "chunkBytes": 1048576,
+    "resumable": true
+  },
+  "state": "transferring",
+  "progress": {
+    "transferredBytes": 2097152,
+    "totalBytes": 3145728
+  }
+}

package/fixtures/migration.example.json

@@ -0,0 +1,22 @@
+{
+  "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"
+  },
+  "description": {
+    "key": "org.example.catalog/price-to-money-description",
+    "defaultMessage": "Rewrites plain price properties into the typed money value shape."
+  },
+  "artifactKinds": ["blueprint", "entry"],
+  "sourceVersions": ">=1.0.0 <1.1.0",
+  "targetVersion": "1.1.0",
+  "lossClassification": "lossless"
+}

package/fixtures/pattern.example.json

@@ -0,0 +1,49 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "pattern",
+  "id": "patterns/hero-with-caption",
+  "version": "1.2.0",
+  "revision": "pattern-r3",
+  "owner": { "id": "org.example/patterns", "version": "1.2.0" },
+  "label": { "key": "org.example/hero-with-caption", "defaultMessage": "Hero with caption" },
+  "description": {
+    "key": "org.example/hero-with-caption-help",
+    "defaultMessage": "A hero section followed by a caption paragraph."
+  },
+  "blockDependencies": [
+    { "type": "studio.vector/section", "version": "1.0.0", "revision": "block-r1" },
+    { "type": "studio.vector/text", "version": "1.0.0", "revision": "block-r1" }
+  ],
+  "roots": [
+    {
+      "authoring": { "mode": "structural" },
+      "bindings": {},
+      "id": "section-p",
+      "properties": {},
+      "slots": {
+        "main": [
+          {
+            "authoring": { "mode": "designer" },
+            "bindings": {},
+            "id": "text-p",
+            "properties": { "text": "Hero" },
+            "slots": {},
+            "type": "studio.vector/text",
+            "version": "1.0.0"
+          }
+        ]
+      },
+      "type": "studio.vector/section",
+      "version": "1.0.0"
+    },
+    {
+      "authoring": { "mode": "designer" },
+      "bindings": {},
+      "id": "text-q",
+      "properties": { "text": "Caption" },
+      "slots": {},
+      "type": "studio.vector/text",
+      "version": "1.0.0"
+    }
+  ]
+}

package/fixtures/plugin.example.json

@@ -0,0 +1,49 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "plugin-manifest",
+  "id": "org.example/catalog-plugin",
+  "version": "1.0.0",
+  "owner": {
+    "id": "org.example/catalog",
+    "version": "1.0.0"
+  },
+  "label": {
+    "key": "org.example.catalog/plugin",
+    "defaultMessage": "Catalog Studio integration"
+  },
+  "activation": "declarative",
+  "entryModules": [],
+  "contributions": [
+    {
+      "kind": "block",
+      "id": "org.example.catalog/price",
+      "version": "1.0.0",
+      "resource": "blocks/price.json",
+      "integrity": "sha256-gEReHtrWQj4XVxU9b3Yie2ssI8Wsy/nv+rvEe6RcFac=",
+      "executable": false
+    },
+    {
+      "kind": "locale",
+      "id": "org.example.catalog/en",
+      "version": "1.0.0",
+      "resource": "locales/en.json",
+      "integrity": "sha256-5sNWsx8n/MDESzjxSwhjg4AnBq/6Mtur4NX0cWTHkKg=",
+      "executable": false
+    }
+  ],
+  "requiredCapabilities": [
+    {
+      "id": "studio.host/artifact",
+      "versions": "^1.0.0"
+    }
+  ],
+  "optionalCapabilities": [
+    {
+      "id": "studio.host/media",
+      "versions": "^1.0.0"
+    }
+  ],
+  "dependencies": [],
+  "permissions": ["org.example.catalog/read-product"],
+  "locales": ["en"]
+}

package/fixtures/preview.render.example.json

@@ -0,0 +1,15 @@
+{
+  "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": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
+    "draftRevision": "product-card-r5-local-12",
+    "requestId": "renders/product-card-14",
+    "viewport": "expanded"
+  }
+}

package/fixtures/provenance.example.json

@@ -0,0 +1,38 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "provenance",
+  "artifact": {
+    "id": "landing.blueprint",
+    "revision": "blueprint-r9"
+  },
+  "chain": [
+    {
+      "origin": "authoring",
+      "fromRevision": "blueprint-r8",
+      "toRevision": "blueprint-r9",
+      "recordedAt": "2026-08-15T09:30:00Z",
+      "actor": { "id": "users/lemuel", "displayName": "Lemuel" },
+      "sessionId": "sessions/2f6c1f6d",
+      "commandCount": 14
+    },
+    {
+      "origin": "migration",
+      "fromRevision": "blueprint-r7",
+      "toRevision": "blueprint-r8",
+      "recordedAt": "2026-08-14T16:05:12Z",
+      "actor": { "id": "users/lemuel", "displayName": "Lemuel" },
+      "migrationId": "org.example.migration/rename-text"
+    },
+    {
+      "origin": "pattern",
+      "toRevision": "blueprint-r7",
+      "recordedAt": "2026-08-14T15:58:41Z",
+      "actor": { "id": "users/lemuel", "displayName": "Lemuel" },
+      "source": {
+        "id": "patterns/hero-with-caption",
+        "version": "1.2.0",
+        "revision": "pattern-r3"
+      }
+    }
+  ]
+}

package/fixtures/rich-text.example.json

@@ -0,0 +1,48 @@
+{
+  "type": "doc",
+  "content": [
+    {
+      "type": "heading",
+      "attrs": { "level": 2 },
+      "content": [{ "type": "text", "text": "Trail care" }]
+    },
+    {
+      "type": "paragraph",
+      "content": [
+        { "type": "text", "text": "Wash with " },
+        { "type": "text", "text": "cold water", "marks": [{ "type": "bold" }] },
+        { "type": "text", "text": " only." },
+        { "type": "hardBreak" },
+        { "type": "text", "text": "Air dry away from direct sun.", "marks": [{ "type": "italic" }] }
+      ]
+    },
+    {
+      "type": "orderedList",
+      "attrs": { "start": 1 },
+      "content": [
+        {
+          "type": "listItem",
+          "content": [
+            { "type": "paragraph", "content": [{ "type": "text", "text": "Empty all pockets." }] }
+          ]
+        },
+        {
+          "type": "listItem",
+          "content": [
+            { "type": "paragraph", "content": [{ "type": "text", "text": "Brush off dry mud." }] }
+          ]
+        }
+      ]
+    },
+    { "type": "horizontalRule" },
+    {
+      "type": "blockquote",
+      "content": [
+        {
+          "type": "paragraph",
+          "content": [{ "type": "text", "text": "Repairs beat replacements." }]
+        }
+      ]
+    }
+  ]
+}