@kumwe/studio-testkit 0.1.0-alpha.5 → 0.1.0-alpha.7

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-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/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/studio-config.example.json

@@ -98,7 +98,7 @@
       {
         "id": "studio.port/artifact",
         "version": "1.0.0",
-        "operations": ["studio.operation/load", "studio.operation/save"]
+        "operations": ["studio.operation/artifact.load", "studio.operation/artifact.save"]
       }
     ],
     "capabilities": []

package/invalid/blueprint.revoking-slot-marker.json

@@ -0,0 +1,57 @@
+{
+  "schema": "blueprint.schema.json",
+  "description": "The per-slot composition marker only grants composability; a revoking marker is rejected.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "dependencyLock": {
+      "blocks": [
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/section",
+          "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": "structural",
+          "slots": {
+            "main": {
+              "composable": false
+            }
+          }
+        },
+        "bindings": {},
+        "id": "section-a",
+        "properties": {},
+        "slots": {},
+        "type": "studio.vector/section",
+        "version": "1.0.0"
+      }
+    ],
+    "status": "draft",
+    "version": "1.0.0"
+  }
+}

package/invalid/design-vocabulary.unknown-control-kind.json

@@ -0,0 +1,38 @@
+{
+  "schema": "design-vocabulary.schema.json",
+  "description": "Design controls carry only the closed design-control kind vocabulary.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "design-vocabulary",
+    "id": "org.example.catalog/product-vocabulary",
+    "version": "1.0.0",
+    "owner": {
+      "id": "org.example/catalog",
+      "version": "1.0.0"
+    },
+    "label": {
+      "key": "org.example.catalog/product-vocabulary",
+      "defaultMessage": "Product design vocabulary"
+    },
+    "designControls": [
+      {
+        "id": "card-face",
+        "kind": "font-role",
+        "label": {
+          "key": "org.example.catalog/card-face",
+          "defaultMessage": "Card face"
+        },
+        "choices": [
+          {
+            "id": "serif",
+            "label": {
+              "key": "org.example.catalog/card-face-serif",
+              "defaultMessage": "Serif"
+            }
+          }
+        ]
+      }
+    ],
+    "recipes": []
+  }
+}

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-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/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": "node-1"
+    }
+  }
+}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kumwe/studio-testkit",
-  "version": "0.1.0-alpha.5",
+  "version": "0.1.0-alpha.7",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kumwe/studio.git",
@@ -13,11 +13,12 @@
   "sideEffects": false,
   "files": [
     "LICENSE",
+    "README.md",
     "conformance",
+    "corpus-manifest.json",
     "dist",
     "fixtures",
     "invalid",
-    "README.md",
     "vectors"
   ],
   "exports": {
@@ -26,6 +27,7 @@
       "import": "./dist/index.js"
     },
     "./conformance/*": "./conformance/*",
+    "./corpus-manifest.json": "./corpus-manifest.json",
     "./fixtures/*": "./fixtures/*",
     "./invalid/*": "./invalid/*",
     "./vectors/*": "./vectors/*"
@@ -34,8 +36,8 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@kumwe/studio-core": "0.1.0-alpha.5",
-    "@kumwe/studio-protocol": "0.1.0-alpha.3"
+    "@kumwe/studio-core": "0.1.0-alpha.7",
+    "@kumwe/studio-protocol": "0.1.0-alpha.5"
   },
   "publishConfig": {
     "access": "public",

package/vectors/canonical/array-order.json

@@ -0,0 +1,13 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.array-order",
+  "description": "Arrays keep semantic order; only object members are sorted.",
+  "value": {
+    "items": ["c", "a", "b"]
+  },
+  "expect": {
+    "canonical": "{\"items\":[\"c\",\"a\",\"b\"]}",
+    "digest": "sha256-Skzt0qRLwO/5TqmcmghEQQEADtJ5ASbjphmWAaasB7U="
+  }
+}

package/vectors/canonical/control-characters.json

@@ -0,0 +1,13 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.control-characters",
+  "description": "Control characters without a short form are escaped as four hex digits.",
+  "value": {
+    "value": "bell\u0007 unit\u001f"
+  },
+  "expect": {
+    "canonical": "{\"value\":\"bell\\u0007 unit\\u001f\"}",
+    "digest": "sha256-V332co6E4LRxsTuTQ5OLD98jGjDBZAAmzZDCJOFGDNA="
+  }
+}

package/vectors/canonical/depth-exceeded.json

@@ -0,0 +1,21 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.depth-exceeded",
+  "description": "Nesting deeper than the declared bound is refused rather than truncated.",
+  "value": {
+    "a": {
+      "a": {
+        "a": {
+          "a": {
+            "a": 1
+          }
+        }
+      }
+    }
+  },
+  "maximumDepth": 3,
+  "expect": {
+    "rejected": "depth-exceeded"
+  }
+}

package/vectors/canonical/empty-containers.json

@@ -0,0 +1,14 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.empty-containers",
+  "description": "Empty objects and arrays serialize without padding.",
+  "value": {
+    "array": [],
+    "object": {}
+  },
+  "expect": {
+    "canonical": "{\"array\":[],\"object\":{}}",
+    "digest": "sha256-E7OK6rLhiixi3ilF25YAcggBtIPkGTb1oVTb2nJhvnA="
+  }
+}

package/vectors/canonical/forbidden-member.json

@@ -0,0 +1,14 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.forbidden-member",
+  "description": "A forbidden member name is refused rather than silently dropped.",
+  "value": {
+    "__proto__": {
+      "polluted": true
+    }
+  },
+  "expect": {
+    "rejected": "forbidden-member"
+  }
+}

package/vectors/canonical/member-order.json

@@ -0,0 +1,16 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.member-order",
+  "description": "Object members sort by Unicode code unit, not by locale or insertion order.",
+  "value": {
+    "b": 1,
+    "A": 2,
+    "a": 3,
+    "Z": 4
+  },
+  "expect": {
+    "canonical": "{\"A\":2,\"Z\":4,\"a\":3,\"b\":1}",
+    "digest": "sha256-Vn19opLXri8fGzPIdqbQbXdepLMLLlGlhBb5yr19cyk="
+  }
+}