@kumwe/studio-testkit 0.1.0-alpha.2

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@kumwe/studio-testkit",
+  "version": "0.1.0-alpha.2",
+  "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",
+    "conformance",
+    "dist",
+    "fixtures",
+    "invalid",
+    "README.md",
+    "vectors"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./conformance/*": "./conformance/*",
+    "./fixtures/*": "./fixtures/*",
+    "./invalid/*": "./invalid/*",
+    "./vectors/*": "./vectors/*"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@kumwe/studio-core": "0.1.0-alpha.2",
+    "@kumwe/studio-protocol": "0.1.0-alpha.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}

package/vectors/command/apply-pattern.colliding-id.error.json

@@ -0,0 +1,97 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "command-vector",
+  "id": "vector.command-vector.apply-pattern.colliding-id.error",
+  "description": "A pattern application may not reuse an identifier that already exists in the document.",
+  "initial": {
+    "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": {},
+        "type": "studio.vector/text",
+        "version": "1.0.0"
+      }
+    ],
+    "status": "draft",
+    "version": "1.0.0"
+  },
+  "command": {
+    "artifactId": "vector.blueprint",
+    "baseStateVersion": 0,
+    "contractVersion": "0.1-draft",
+    "id": "vector.command.apply-pattern.colliding-id",
+    "kind": "command",
+    "payload": {
+      "destination": {
+        "position": 1
+      },
+      "idMap": {
+        "text-p": "text-a"
+      },
+      "nodes": [
+        {
+          "authoring": {
+            "mode": "designer"
+          },
+          "bindings": {},
+          "id": "text-p",
+          "properties": {},
+          "slots": {},
+          "type": "studio.vector/text",
+          "version": "1.0.0"
+        }
+      ],
+      "pattern": {
+        "id": "patterns/hero-with-caption",
+        "revision": "pattern-r3",
+        "version": "1.2.0"
+      }
+    },
+    "sessionGeneration": "session-r1",
+    "type": "studio.command/apply-pattern"
+  },
+  "expect": {
+    "errorCode": "duplicate-node"
+  }
+}

package/vectors/command/apply-pattern.incomplete-id-map.error.json

@@ -0,0 +1,111 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "command-vector",
+  "id": "vector.command-vector.apply-pattern.incomplete-id-map.error",
+  "description": "A pattern application must remap every node of every fragment root exactly once.",
+  "initial": {
+    "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": {},
+        "type": "studio.vector/text",
+        "version": "1.0.0"
+      }
+    ],
+    "status": "draft",
+    "version": "1.0.0"
+  },
+  "command": {
+    "artifactId": "vector.blueprint",
+    "baseStateVersion": 0,
+    "contractVersion": "0.1-draft",
+    "id": "vector.command.apply-pattern.incomplete-id-map",
+    "kind": "command",
+    "payload": {
+      "destination": {
+        "position": 1
+      },
+      "idMap": {
+        "section-p": "section-p1"
+      },
+      "nodes": [
+        {
+          "authoring": {
+            "mode": "structural"
+          },
+          "bindings": {},
+          "id": "section-p",
+          "properties": {},
+          "slots": {
+            "main": [
+              {
+                "authoring": {
+                  "mode": "designer"
+                },
+                "bindings": {},
+                "id": "text-p",
+                "properties": {},
+                "slots": {},
+                "type": "studio.vector/text",
+                "version": "1.0.0"
+              }
+            ]
+          },
+          "type": "studio.vector/section",
+          "version": "1.0.0"
+        }
+      ],
+      "pattern": {
+        "id": "patterns/hero-with-caption",
+        "revision": "pattern-r3",
+        "version": "1.2.0"
+      }
+    },
+    "sessionGeneration": "session-r1",
+    "type": "studio.command/apply-pattern"
+  },
+  "expect": {
+    "errorCode": "invalid-id-map"
+  }
+}

package/vectors/command/apply-pattern.two-roots.json

@@ -0,0 +1,259 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "command-vector",
+  "id": "vector.command-vector.apply-pattern.two-roots",
+  "description": "Applying a pattern inserts every remapped fragment root in order at the destination and stamps pattern provenance on each applied root; the inverse removes the applied roots.",
+  "initial": {
+    "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": {},
+        "type": "studio.vector/text",
+        "version": "1.0.0"
+      }
+    ],
+    "status": "draft",
+    "version": "1.0.0"
+  },
+  "command": {
+    "artifactId": "vector.blueprint",
+    "baseStateVersion": 0,
+    "contractVersion": "0.1-draft",
+    "id": "vector.command.apply-pattern.two-roots",
+    "kind": "command",
+    "payload": {
+      "destination": {
+        "position": 1
+      },
+      "idMap": {
+        "section-p": "section-p1",
+        "text-p": "text-p1",
+        "text-q": "text-q1"
+      },
+      "nodes": [
+        {
+          "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"
+        }
+      ],
+      "pattern": {
+        "id": "patterns/hero-with-caption",
+        "revision": "pattern-r3",
+        "version": "1.2.0"
+      }
+    },
+    "sessionGeneration": "session-r1",
+    "type": "studio.command/apply-pattern"
+  },
+  "expect": {
+    "document": {
+      "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": {},
+          "type": "studio.vector/text",
+          "version": "1.0.0"
+        },
+        {
+          "authoring": {
+            "mode": "structural"
+          },
+          "bindings": {},
+          "id": "section-p1",
+          "properties": {},
+          "slots": {
+            "main": [
+              {
+                "authoring": {
+                  "mode": "designer"
+                },
+                "bindings": {},
+                "id": "text-p1",
+                "properties": {
+                  "text": "Hero"
+                },
+                "slots": {},
+                "type": "studio.vector/text",
+                "version": "1.0.0"
+              }
+            ]
+          },
+          "type": "studio.vector/section",
+          "version": "1.0.0",
+          "extensions": {
+            "studio.pattern/source": {
+              "id": "patterns/hero-with-caption",
+              "revision": "pattern-r3",
+              "version": "1.2.0"
+            }
+          }
+        },
+        {
+          "authoring": {
+            "mode": "designer"
+          },
+          "bindings": {},
+          "id": "text-q1",
+          "properties": {
+            "text": "Caption"
+          },
+          "slots": {},
+          "type": "studio.vector/text",
+          "version": "1.0.0",
+          "extensions": {
+            "studio.pattern/source": {
+              "id": "patterns/hero-with-caption",
+              "revision": "pattern-r3",
+              "version": "1.2.0"
+            }
+          }
+        }
+      ],
+      "status": "draft",
+      "version": "1.0.0"
+    }
+  },
+  "inverse": {
+    "artifactId": "vector.blueprint",
+    "baseStateVersion": 1,
+    "contractVersion": "0.1-draft",
+    "id": "vector.inverse.apply-pattern.two-roots",
+    "kind": "command",
+    "payload": {
+      "operations": [
+        {
+          "payload": {
+            "nodeId": "section-p1"
+          },
+          "type": "studio.command/remove-node"
+        },
+        {
+          "payload": {
+            "nodeId": "text-q1"
+          },
+          "type": "studio.command/remove-node"
+        }
+      ]
+    },
+    "sessionGeneration": "session-r1",
+    "type": "studio.command/batch"
+  }
+}