@kumwe/studio-testkit 0.1.0-alpha.10

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@kumwe/studio-testkit",
+  "version": "0.1.0-alpha.10",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kumwe/studio.git",
+    "directory": "packages/testkit"
+  },
+  "homepage": "https://github.com/kumwe/studio/tree/main/packages/testkit#readme",
+  "bugs": "https://github.com/kumwe/studio/issues",
+  "description": "Draft canonical fixtures, builders, and the initial Blueprint assertion for Studio.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "third-party-licenses",
+    "README.md",
+    "conformance",
+    "corpus-manifest.json",
+    "dist",
+    "fixtures",
+    "invalid",
+    "studio-release.json",
+    "vectors"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./conformance/*": "./conformance/*",
+    "./corpus-manifest.json": "./corpus-manifest.json",
+    "./fixtures/*": "./fixtures/*",
+    "./invalid/*": "./invalid/*",
+    "./studio-release.json": "./studio-release.json",
+    "./vectors/*": "./vectors/*"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@kumwe/studio-core": "0.1.0-alpha.10",
+    "@kumwe/studio-protocol": "0.1.0-alpha.10"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}

package/studio-release.json

@@ -0,0 +1,18 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "studio-release",
+  "release": "0.1.0-alpha.10",
+  "packages": {
+    "@kumwe/studio-core": "0.1.0-alpha.10",
+    "@kumwe/studio-media": "0.1.0-alpha.10",
+    "@kumwe/studio-preview": "0.1.0-alpha.10",
+    "@kumwe/studio-protocol": "0.1.0-alpha.10",
+    "@kumwe/studio-renderer-web": "0.1.0-alpha.10",
+    "@kumwe/studio-rich-text": "0.1.0-alpha.10",
+    "@kumwe/studio": "0.1.0-alpha.10",
+    "@kumwe/studio-testkit": "0.1.0-alpha.10"
+  },
+  "protocolVersion": "0.1.0-draft.2",
+  "corpusManifestDigest": "sha256-4/ChS3pCA32CoZ+BjvL2tj2RGOFJNdqXwuqO8gWDxTs=",
+  "claimedProfiles": []
+}

package/vectors/binding-projection/app-content-fields.resolved.json

@@ -0,0 +1,286 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "binding-projection-vector",
+  "id": "binding-projection/app-content-fields-resolved",
+  "description": "An App-like Content projection exposes compatible visible fields in authoring order, preserves declared controls, and resolves exact entry-field bindings.",
+  "profile": "studio.profile/binding-projection-v1",
+  "blueprint": {
+    "contractVersion": "0.1-draft",
+    "kind": "blueprint",
+    "id": "blueprints/article-page",
+    "version": "1.0.0",
+    "revision": "blueprint-r1",
+    "owner": { "id": "studio.test/host", "version": "1.0.0" },
+    "status": "draft",
+    "label": { "key": "studio.test/article-page", "defaultMessage": "Article page" },
+    "model": {
+      "id": "content-model:00000000-0000-4000-8000-000000000001",
+      "version": "0.0.4",
+      "revision": "content-type-v4"
+    },
+    "dependencyLock": {
+      "theme": { "id": "studio.test/theme", "version": "1.0.0", "revision": "theme-r1" },
+      "blocks": [{ "type": "studio.test/article-card", "version": "1.0.0", "revision": "block-r1" }]
+    },
+    "roots": [
+      {
+        "id": "article-card-1",
+        "type": "studio.test/article-card",
+        "version": "1.0.0",
+        "properties": {},
+        "bindings": {
+          "headline": {
+            "source": { "kind": "entry-field", "fieldPath": ["data_title"] },
+            "transforms": [],
+            "onNull": "empty",
+            "onError": "error"
+          },
+          "labels": {
+            "source": { "kind": "entry-field", "fieldPath": ["data_tags"] },
+            "transforms": [],
+            "onNull": "empty",
+            "onError": "error"
+          },
+          "manual": {
+            "source": { "kind": "static-value", "value": "Fallback" },
+            "transforms": [],
+            "onNull": "empty",
+            "onError": "error"
+          }
+        },
+        "slots": {},
+        "authoring": { "mode": "content" }
+      }
+    ]
+  },
+  "model": {
+    "contractVersion": "0.1-draft",
+    "kind": "content-model",
+    "id": "content-model:00000000-0000-4000-8000-000000000001",
+    "version": "0.0.4",
+    "revision": "content-type-v4",
+    "owner": { "id": "kumwe.app/content", "version": "2.0.0" },
+    "status": "published",
+    "label": { "key": "kumwe.app/article", "defaultMessage": "Article" },
+    "fields": [
+      {
+        "id": "data_title",
+        "kind": "string",
+        "label": { "key": "kumwe.app/title", "defaultMessage": "Title" },
+        "required": true,
+        "localized": true,
+        "cardinality": "one",
+        "authoring": { "control": "studio.control/single-line-text", "order": 0 }
+      },
+      {
+        "id": "data_contact",
+        "kind": "string",
+        "label": { "key": "kumwe.app/contact", "defaultMessage": "Contact" },
+        "required": false,
+        "localized": true,
+        "cardinality": "one",
+        "authoring": { "control": "kumwe.app/email", "order": 1 }
+      },
+      {
+        "id": "data_category",
+        "kind": "enum",
+        "label": { "key": "kumwe.app/category", "defaultMessage": "Category" },
+        "required": false,
+        "localized": true,
+        "cardinality": "one",
+        "enumValues": [
+          {
+            "value": "guide",
+            "label": { "key": "kumwe.app/category-guide", "defaultMessage": "Guide" }
+          }
+        ],
+        "authoring": { "control": "studio.control/select", "order": 2 }
+      },
+      {
+        "id": "data_internal",
+        "kind": "string",
+        "label": { "key": "kumwe.app/internal", "defaultMessage": "Internal" },
+        "required": false,
+        "localized": false,
+        "cardinality": "one",
+        "authoring": {
+          "control": "studio.control/single-line-text",
+          "hidden": true,
+          "order": 3
+        }
+      },
+      {
+        "id": "data_tags",
+        "kind": "collection",
+        "itemKind": "string",
+        "label": { "key": "kumwe.app/tags", "defaultMessage": "Tags" },
+        "required": false,
+        "localized": true,
+        "cardinality": "many",
+        "authoring": { "control": "kumwe.app/schema-group", "order": 4 }
+      }
+    ],
+    "relationships": []
+  },
+  "blockDefinitions": [
+    {
+      "contractVersion": "0.1-draft",
+      "kind": "block-definition",
+      "type": "studio.test/article-card",
+      "version": "1.0.0",
+      "revision": "block-r1",
+      "owner": { "id": "studio.test/blocks", "version": "1.0.0" },
+      "label": { "key": "studio.test/article-card", "defaultMessage": "Article card" },
+      "category": "studio.category/content",
+      "propertySchema": { "type": "object", "additionalProperties": false },
+      "slots": [],
+      "ports": [
+        {
+          "id": "headline",
+          "label": { "key": "studio.test/headline", "defaultMessage": "Headline" },
+          "valueType": "text",
+          "required": true,
+          "multiple": false
+        },
+        {
+          "id": "labels",
+          "label": { "key": "studio.test/labels", "defaultMessage": "Labels" },
+          "valueType": "text",
+          "required": false,
+          "multiple": true
+        },
+        {
+          "id": "featured",
+          "label": { "key": "studio.test/featured", "defaultMessage": "Featured" },
+          "valueType": "boolean",
+          "required": false,
+          "multiple": false
+        },
+        {
+          "id": "manual",
+          "label": { "key": "studio.test/manual", "defaultMessage": "Manual" },
+          "valueType": "text",
+          "required": false,
+          "multiple": false
+        }
+      ],
+      "editingModes": ["blueprint", "content"],
+      "themeControls": [],
+      "rendererRequirements": [
+        {
+          "surface": "preview",
+          "capability": "studio.renderer/test",
+          "versions": "^1.0.0"
+        }
+      ],
+      "accessibility": {
+        "category": "text",
+        "accessibleName": "derived",
+        "keyboard": {
+          "key": "studio.test/article-card-keyboard",
+          "defaultMessage": "Use the outline controls."
+        },
+        "reducedMotion": "not-applicable",
+        "outputChecks": ["studio.check/article-card"]
+      }
+    }
+  ],
+  "expect": {
+    "model": {
+      "id": "content-model:00000000-0000-4000-8000-000000000001",
+      "version": "0.0.4",
+      "revision": "content-type-v4"
+    },
+    "nodes": [
+      {
+        "nodeId": "article-card-1",
+        "ports": [
+          {
+            "port": "headline",
+            "status": "resolved",
+            "bindingSourceKind": "entry-field",
+            "boundFieldPath": ["data_title"],
+            "candidates": [
+              {
+                "fieldPath": ["data_title"],
+                "kind": "string",
+                "cardinality": "one",
+                "control": "studio.control/single-line-text"
+              },
+              {
+                "fieldPath": ["data_contact"],
+                "kind": "string",
+                "cardinality": "one",
+                "control": "kumwe.app/email"
+              },
+              {
+                "fieldPath": ["data_category"],
+                "kind": "enum",
+                "cardinality": "one",
+                "control": "studio.control/select"
+              }
+            ],
+            "multiple": false,
+            "required": true,
+            "valueType": "text"
+          },
+          {
+            "port": "labels",
+            "status": "resolved",
+            "bindingSourceKind": "entry-field",
+            "boundFieldPath": ["data_tags"],
+            "candidates": [
+              {
+                "fieldPath": ["data_tags"],
+                "kind": "collection",
+                "itemKind": "string",
+                "cardinality": "many",
+                "control": "kumwe.app/schema-group"
+              }
+            ],
+            "multiple": true,
+            "required": false,
+            "valueType": "text"
+          },
+          {
+            "port": "featured",
+            "status": "unbound",
+            "candidates": [],
+            "multiple": false,
+            "required": false,
+            "valueType": "boolean"
+          },
+          {
+            "port": "manual",
+            "status": "non-field-source",
+            "bindingSourceKind": "static-value",
+            "candidates": [
+              {
+                "fieldPath": ["data_title"],
+                "kind": "string",
+                "cardinality": "one",
+                "control": "studio.control/single-line-text"
+              },
+              {
+                "fieldPath": ["data_contact"],
+                "kind": "string",
+                "cardinality": "one",
+                "control": "kumwe.app/email"
+              },
+              {
+                "fieldPath": ["data_category"],
+                "kind": "enum",
+                "cardinality": "one",
+                "control": "studio.control/select"
+              }
+            ],
+            "multiple": false,
+            "required": false,
+            "valueType": "text"
+          }
+        ]
+      }
+    ],
+    "diagnostics": []
+  }
+}

package/vectors/binding-projection/field-removed.diagnostic.json

@@ -0,0 +1,135 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "binding-projection-vector",
+  "id": "binding-projection/field-removed-diagnostic",
+  "description": "A binding to a field removed from the exact locked model is preserved and diagnosed instead of silently rewritten.",
+  "profile": "studio.profile/binding-projection-v1",
+  "blueprint": {
+    "contractVersion": "0.1-draft",
+    "kind": "blueprint",
+    "id": "blueprints/removed-field",
+    "version": "1.0.0",
+    "revision": "blueprint-r1",
+    "owner": { "id": "studio.test/host", "version": "1.0.0" },
+    "status": "draft",
+    "label": { "key": "studio.test/removed-field", "defaultMessage": "Removed field" },
+    "model": { "id": "studio.test/article", "version": "1.0.0", "revision": "model-r2" },
+    "dependencyLock": {
+      "theme": { "id": "studio.test/theme", "version": "1.0.0", "revision": "theme-r1" },
+      "blocks": [{ "type": "studio.test/text", "version": "1.0.0", "revision": "block-r1" }]
+    },
+    "roots": [
+      {
+        "id": "text-1",
+        "type": "studio.test/text",
+        "version": "1.0.0",
+        "properties": {},
+        "bindings": {
+          "headline": {
+            "source": { "kind": "entry-field", "fieldPath": ["title"] },
+            "transforms": [],
+            "onNull": "empty",
+            "onError": "error"
+          }
+        },
+        "slots": {},
+        "authoring": { "mode": "content" }
+      }
+    ]
+  },
+  "model": {
+    "contractVersion": "0.1-draft",
+    "kind": "content-model",
+    "id": "studio.test/article",
+    "version": "1.0.0",
+    "revision": "model-r2",
+    "owner": { "id": "studio.test/host", "version": "1.0.0" },
+    "status": "published",
+    "label": { "key": "studio.test/article", "defaultMessage": "Article" },
+    "fields": [
+      {
+        "id": "summary",
+        "kind": "string",
+        "label": { "key": "studio.test/summary", "defaultMessage": "Summary" },
+        "required": false,
+        "localized": true,
+        "cardinality": "one",
+        "authoring": { "control": "studio.control/multi-line-text", "order": 0 }
+      }
+    ],
+    "relationships": []
+  },
+  "blockDefinitions": [
+    {
+      "contractVersion": "0.1-draft",
+      "kind": "block-definition",
+      "type": "studio.test/text",
+      "version": "1.0.0",
+      "revision": "block-r1",
+      "owner": { "id": "studio.test/blocks", "version": "1.0.0" },
+      "label": { "key": "studio.test/text", "defaultMessage": "Text" },
+      "category": "studio.category/content",
+      "propertySchema": { "type": "object", "additionalProperties": false },
+      "slots": [],
+      "ports": [
+        {
+          "id": "headline",
+          "label": { "key": "studio.test/headline", "defaultMessage": "Headline" },
+          "valueType": "text",
+          "required": true,
+          "multiple": false
+        }
+      ],
+      "editingModes": ["blueprint", "content"],
+      "themeControls": [],
+      "rendererRequirements": [
+        { "surface": "preview", "capability": "studio.renderer/test", "versions": "^1.0.0" }
+      ],
+      "accessibility": {
+        "category": "text",
+        "accessibleName": "derived",
+        "keyboard": { "key": "studio.test/text-keyboard", "defaultMessage": "Use the outline." },
+        "reducedMotion": "not-applicable",
+        "outputChecks": ["studio.check/text"]
+      }
+    }
+  ],
+  "expect": {
+    "model": { "id": "studio.test/article", "version": "1.0.0", "revision": "model-r2" },
+    "nodes": [
+      {
+        "nodeId": "text-1",
+        "ports": [
+          {
+            "port": "headline",
+            "status": "invalid",
+            "bindingSourceKind": "entry-field",
+            "boundFieldPath": ["title"],
+            "candidates": [
+              {
+                "fieldPath": ["summary"],
+                "kind": "string",
+                "cardinality": "one",
+                "control": "studio.control/multi-line-text"
+              }
+            ],
+            "multiple": false,
+            "required": true,
+            "valueType": "text"
+          }
+        ]
+      }
+    ],
+    "diagnostics": [
+      {
+        "code": "studio.binding/field-missing",
+        "severity": "error",
+        "location": {
+          "artifactId": "blueprints/removed-field",
+          "nodeId": "text-1",
+          "fieldPath": ["title"]
+        }
+      }
+    ]
+  }
+}

package/vectors/binding-projection/model-revision-mismatch.diagnostic.json

@@ -0,0 +1,124 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "binding-projection-vector",
+  "id": "binding-projection/model-revision-mismatch-diagnostic",
+  "description": "A projected model from a different immutable revision fails the entire candidate surface closed with an exact coordinate diagnostic.",
+  "profile": "studio.profile/binding-projection-v1",
+  "blueprint": {
+    "contractVersion": "0.1-draft",
+    "kind": "blueprint",
+    "id": "blueprints/revision-mismatch",
+    "version": "1.0.0",
+    "revision": "blueprint-r1",
+    "owner": { "id": "studio.test/host", "version": "1.0.0" },
+    "status": "draft",
+    "label": { "key": "studio.test/revision-mismatch", "defaultMessage": "Mismatch" },
+    "model": { "id": "studio.test/article", "version": "1.0.0", "revision": "model-r1" },
+    "dependencyLock": {
+      "theme": { "id": "studio.test/theme", "version": "1.0.0", "revision": "theme-r1" },
+      "blocks": [{ "type": "studio.test/text", "version": "1.0.0", "revision": "block-r1" }]
+    },
+    "roots": [
+      {
+        "id": "text-1",
+        "type": "studio.test/text",
+        "version": "1.0.0",
+        "properties": {},
+        "bindings": {
+          "headline": {
+            "source": { "kind": "entry-field", "fieldPath": ["title"] },
+            "transforms": [],
+            "onNull": "empty",
+            "onError": "error"
+          }
+        },
+        "slots": {},
+        "authoring": { "mode": "content" }
+      }
+    ]
+  },
+  "model": {
+    "contractVersion": "0.1-draft",
+    "kind": "content-model",
+    "id": "studio.test/article",
+    "version": "1.0.0",
+    "revision": "model-r2",
+    "owner": { "id": "studio.test/host", "version": "1.0.0" },
+    "status": "published",
+    "label": { "key": "studio.test/article", "defaultMessage": "Article" },
+    "fields": [
+      {
+        "id": "title",
+        "kind": "string",
+        "label": { "key": "studio.test/title", "defaultMessage": "Title" },
+        "required": true,
+        "localized": true,
+        "cardinality": "one",
+        "authoring": { "control": "studio.control/single-line-text", "order": 0 }
+      }
+    ],
+    "relationships": []
+  },
+  "blockDefinitions": [
+    {
+      "contractVersion": "0.1-draft",
+      "kind": "block-definition",
+      "type": "studio.test/text",
+      "version": "1.0.0",
+      "revision": "block-r1",
+      "owner": { "id": "studio.test/blocks", "version": "1.0.0" },
+      "label": { "key": "studio.test/text", "defaultMessage": "Text" },
+      "category": "studio.category/content",
+      "propertySchema": { "type": "object", "additionalProperties": false },
+      "slots": [],
+      "ports": [
+        {
+          "id": "headline",
+          "label": { "key": "studio.test/headline", "defaultMessage": "Headline" },
+          "valueType": "text",
+          "required": true,
+          "multiple": false
+        }
+      ],
+      "editingModes": ["blueprint", "content"],
+      "themeControls": [],
+      "rendererRequirements": [
+        { "surface": "preview", "capability": "studio.renderer/test", "versions": "^1.0.0" }
+      ],
+      "accessibility": {
+        "category": "text",
+        "accessibleName": "derived",
+        "keyboard": { "key": "studio.test/text-keyboard", "defaultMessage": "Use the outline." },
+        "reducedMotion": "not-applicable",
+        "outputChecks": ["studio.check/text"]
+      }
+    }
+  ],
+  "expect": {
+    "model": { "id": "studio.test/article", "version": "1.0.0", "revision": "model-r1" },
+    "nodes": [
+      {
+        "nodeId": "text-1",
+        "ports": [
+          {
+            "port": "headline",
+            "status": "invalid",
+            "bindingSourceKind": "entry-field",
+            "boundFieldPath": ["title"],
+            "candidates": [],
+            "multiple": false,
+            "required": true,
+            "valueType": "text"
+          }
+        ]
+      }
+    ],
+    "diagnostics": [
+      {
+        "code": "studio.binding/model-revision-mismatch",
+        "severity": "error",
+        "location": { "artifactId": "blueprints/revision-mismatch" }
+      }
+    ]
+  }
+}

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