@kumwe/studio-testkit 0.1.0-alpha.2

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,14 @@
+{
+  "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",
+    "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." }]
+        }
+      ]
+    }
+  ]
+}

package/fixtures/studio-config.example.json

@@ -0,0 +1,139 @@
+{
+  "contractVersion": "0.1-draft",
+  "protocolVersion": "0.1.0-draft.1",
+  "sessionId": "session-018f",
+  "sessionGeneration": "session-generation-1",
+  "mode": "content",
+  "composite": "hybrid",
+  "sessionState": "editable",
+  "actor": {
+    "id": "users/designer-17",
+    "displayName": "Example Designer"
+  },
+  "locale": {
+    "requested": "en-NA",
+    "resolved": "en-NA",
+    "fallbacks": ["en"],
+    "direction": "ltr",
+    "timeZone": "Africa/Windhoek"
+  },
+  "displayPreferences": {
+    "calendar": "gregory",
+    "numberingSystem": "latn",
+    "hourCycle": "h23",
+    "measurementSystem": "metric"
+  },
+  "resourceContext": {
+    "key": "contexts/main-site-catalog",
+    "surface": "org.kumwe.surface/administrator",
+    "revision": "context-r7",
+    "scopes": [
+      {
+        "kind": "studio.scope/tenant",
+        "id": "tenants/example"
+      },
+      {
+        "kind": "studio.scope/site",
+        "id": "sites/main"
+      },
+      {
+        "kind": "studio.scope/organization",
+        "id": "organizations/windhoek"
+      }
+    ],
+    "resource": {
+      "type": "org.example.models/product",
+      "id": "products/trail-backpack"
+    }
+  },
+  "permissions": [
+    "studio.permission/edit-content",
+    "studio.permission/edit-blueprint",
+    "studio.permission/upload-media"
+  ],
+  "artifacts": {
+    "model": {
+      "id": "org.example.models/product",
+      "version": "1.0.0",
+      "revision": "product-model-r1"
+    },
+    "blueprint": {
+      "id": "org.example.blueprints/product-card",
+      "version": "1.0.0",
+      "revision": "product-card-r5"
+    },
+    "entry": {
+      "id": "products/trail-backpack",
+      "revision": "entry-r7"
+    },
+    "theme": {
+      "id": "org.example.themes/commerce",
+      "version": "1.0.0",
+      "revision": "commerce-theme-r3"
+    }
+  },
+  "blocks": [
+    {
+      "type": "studio.core/grid",
+      "version": "1.0.0",
+      "revision": "grid-block-r1"
+    },
+    {
+      "type": "org.example.catalog/price",
+      "version": "1.0.0",
+      "revision": "price-block-r1"
+    }
+  ],
+  "plugins": [],
+  "hostCapabilities": {
+    "contractVersion": "0.1-draft",
+    "kind": "host-capabilities",
+    "host": {
+      "id": "org.kumwe/cms",
+      "version": "3.0.0-alpha.1",
+      "generation": "runtime-generation-42"
+    },
+    "protocolVersions": ["0.1.0-draft.1"],
+    "ports": [
+      {
+        "id": "studio.port/artifact",
+        "version": "1.0.0",
+        "operations": ["studio.operation/load", "studio.operation/save"]
+      }
+    ],
+    "capabilities": []
+  },
+  "limits": {
+    "maxNodes": 5000,
+    "maxDepth": 32,
+    "maxSlotsPerNode": 20,
+    "maxChildrenPerSlot": 1000,
+    "maxPropertyBytes": 1048576,
+    "maxExtensionBytes": 1048576,
+    "maxCommandBatch": 100,
+    "maxHistoryEntries": 1000,
+    "maxRichTextBytes": 1048576,
+    "maxRichTextDepth": 32,
+    "maxPreviewRequestsPerMinute": 600,
+    "maxPreviewBytes": 10485760,
+    "maxMediaUploadBytes": 1073741824,
+    "maxMediaBatch": 50,
+    "maxPluginCount": 50,
+    "maxContributionsPerPlugin": 500,
+    "maxLocaleBytes": 1048576
+  },
+  "features": {
+    "executablePlugins": false,
+    "customInspectors": false,
+    "externalMediaImport": false,
+    "clipboardMediaUpload": true,
+    "collaboration": false,
+    "offlineRecovery": true
+  },
+  "preview": {
+    "enabled": true,
+    "sameOriginRequired": true,
+    "allowApproximateRenderer": false,
+    "initialViewport": "expanded"
+  }
+}

package/fixtures/theme.example.json

@@ -0,0 +1,123 @@
+{
+  "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"
+    }
+  ]
+}

package/fixtures/unresolved-contribution.example.json

@@ -0,0 +1,23 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "unresolved-contribution",
+  "reference": {
+    "contribution": "block",
+    "id": "org.example.blocks/hero",
+    "version": "1.0.0"
+  },
+  "reason": "owner-disabled",
+  "owner": { "id": "org.example/blocks", "version": "1.0.0" },
+  "affectedNodes": ["node-hero-1", "node-hero-2"],
+  "diagnostics": [
+    {
+      "code": "studio.validation/block-unavailable",
+      "severity": "warning",
+      "message": {
+        "key": "studio.validation/block-unavailable",
+        "defaultMessage": "The hero block's provider is disabled; its content is preserved but not editable."
+      },
+      "location": { "nodeId": "node-hero-1" }
+    }
+  ]
+}

package/invalid/blueprint.control-character-member.json

@@ -0,0 +1,59 @@
+{
+  "schema": "blueprint.schema.json",
+  "description": "Node property member names reject control characters.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "dependencyLock": {
+      "blocks": [
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/section",
+          "version": "1.0.0"
+        },
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/text",
+          "version": "1.0.0"
+        }
+      ],
+      "theme": {
+        "id": "studio.vector/theme",
+        "revision": "theme-r1",
+        "version": "1.0.0"
+      }
+    },
+    "id": "vector.blueprint",
+    "kind": "blueprint",
+    "label": {
+      "defaultMessage": "Vector Blueprint",
+      "key": "studio.vector/blueprint"
+    },
+    "model": {
+      "id": "studio.vector/model",
+      "revision": "model-r1",
+      "version": "1.0.0"
+    },
+    "owner": {
+      "id": "studio.vector/suite",
+      "version": "0.1.0-alpha.0"
+    },
+    "revision": "blueprint-r1",
+    "roots": [
+      {
+        "authoring": {
+          "mode": "designer"
+        },
+        "bindings": {},
+        "id": "text-a",
+        "properties": {
+          "line\nbreak": true
+        },
+        "slots": {},
+        "type": "studio.vector/text",
+        "version": "1.0.0"
+      }
+    ],
+    "status": "draft",
+    "version": "1.0.0"
+  }
+}

package/invalid/blueprint.forbidden-property-member.json

@@ -0,0 +1,61 @@
+{
+  "schema": "blueprint.schema.json",
+  "description": "Node properties reject prototype-polluting member names.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "dependencyLock": {
+      "blocks": [
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/section",
+          "version": "1.0.0"
+        },
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/text",
+          "version": "1.0.0"
+        }
+      ],
+      "theme": {
+        "id": "studio.vector/theme",
+        "revision": "theme-r1",
+        "version": "1.0.0"
+      }
+    },
+    "id": "vector.blueprint",
+    "kind": "blueprint",
+    "label": {
+      "defaultMessage": "Vector Blueprint",
+      "key": "studio.vector/blueprint"
+    },
+    "model": {
+      "id": "studio.vector/model",
+      "revision": "model-r1",
+      "version": "1.0.0"
+    },
+    "owner": {
+      "id": "studio.vector/suite",
+      "version": "0.1.0-alpha.0"
+    },
+    "revision": "blueprint-r1",
+    "roots": [
+      {
+        "authoring": {
+          "mode": "designer"
+        },
+        "bindings": {},
+        "id": "text-a",
+        "properties": {
+          "__proto__": {
+            "polluted": true
+          }
+        },
+        "slots": {},
+        "type": "studio.vector/text",
+        "version": "1.0.0"
+      }
+    ],
+    "status": "draft",
+    "version": "1.0.0"
+  }
+}

package/invalid/blueprint.invalid-node-id.json

@@ -0,0 +1,57 @@
+{
+  "schema": "blueprint.schema.json",
+  "description": "Node identifiers must start with an alphanumeric character.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "dependencyLock": {
+      "blocks": [
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/section",
+          "version": "1.0.0"
+        },
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/text",
+          "version": "1.0.0"
+        }
+      ],
+      "theme": {
+        "id": "studio.vector/theme",
+        "revision": "theme-r1",
+        "version": "1.0.0"
+      }
+    },
+    "id": "vector.blueprint",
+    "kind": "blueprint",
+    "label": {
+      "defaultMessage": "Vector Blueprint",
+      "key": "studio.vector/blueprint"
+    },
+    "model": {
+      "id": "studio.vector/model",
+      "revision": "model-r1",
+      "version": "1.0.0"
+    },
+    "owner": {
+      "id": "studio.vector/suite",
+      "version": "0.1.0-alpha.0"
+    },
+    "revision": "blueprint-r1",
+    "roots": [
+      {
+        "authoring": {
+          "mode": "designer"
+        },
+        "bindings": {},
+        "id": "-leading-dash",
+        "properties": {},
+        "slots": {},
+        "type": "studio.vector/text",
+        "version": "1.0.0"
+      }
+    ],
+    "status": "draft",
+    "version": "1.0.0"
+  }
+}

package/invalid/blueprint.invalid-slot-name.json

@@ -0,0 +1,59 @@
+{
+  "schema": "blueprint.schema.json",
+  "description": "Slot names are lower-case local names.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "dependencyLock": {
+      "blocks": [
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/section",
+          "version": "1.0.0"
+        },
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/text",
+          "version": "1.0.0"
+        }
+      ],
+      "theme": {
+        "id": "studio.vector/theme",
+        "revision": "theme-r1",
+        "version": "1.0.0"
+      }
+    },
+    "id": "vector.blueprint",
+    "kind": "blueprint",
+    "label": {
+      "defaultMessage": "Vector Blueprint",
+      "key": "studio.vector/blueprint"
+    },
+    "model": {
+      "id": "studio.vector/model",
+      "revision": "model-r1",
+      "version": "1.0.0"
+    },
+    "owner": {
+      "id": "studio.vector/suite",
+      "version": "0.1.0-alpha.0"
+    },
+    "revision": "blueprint-r1",
+    "roots": [
+      {
+        "authoring": {
+          "mode": "designer"
+        },
+        "bindings": {},
+        "id": "text-a",
+        "properties": {},
+        "slots": {
+          "Main": []
+        },
+        "type": "studio.vector/text",
+        "version": "1.0.0"
+      }
+    ],
+    "status": "draft",
+    "version": "1.0.0"
+  }
+}