@wocart/theme 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to `@wocart/theme` are recorded here. The package follows
 major version, and an export is marked `@deprecated` for at least one minor
 release before a major removes it.
 
+## 2.1.0 — 2026-10-21
+
+The release check now sees where a section may be placed.
+
+### Changed
+
+- `diffThemeManifests` treats a component that is no longer insertable, or that
+  is limited to a narrower list of surfaces, as a breaking change. Widening a
+  component's surfaces, or making it insertable again, is additive. Before, a
+  theme could narrow where a section sits without the release check noticing.
+
 ## 2.0.0 — 2026-10-20
 
 Blocks: components place other components inside them, some fixed by the

package/dist/manifest-diff.js

@@ -82,6 +82,7 @@ export function diffThemeManifests(previous, next) {
 }
 function compareComponents(previous, next, path, breaking, additive) {
     compareFields(previous.fields, next.fields, `${path}.fields`, breaking, additive);
+    compareCapabilities(previous.capabilities, next.capabilities, `${path}.capabilities`, breaking, additive);
     const nextSlots = new Map(next.slots.map((slot) => [slot.name, slot]));
     for (const slot of previous.slots) {
         const after = nextSlots.get(slot.name);
@@ -108,6 +109,37 @@ function compareComponents(previous, next, path, breaking, additive) {
             additive(`${path}.fixed.${block.name}`, `fixed block "${block.name}" was added`);
     }
 }
+/**
+ * Where an editor may place a component. A narrowed rule is breaking: a section
+ * saved on a surface it no longer covers may stop rendering there, once a theme
+ * renders each surface from the components it covers, and it cannot be placed
+ * again. Widening only adds.
+ */
+function compareCapabilities(previous, next, path, breaking, additive) {
+    const wasInsertable = previous?.insertable !== false;
+    const isInsertable = next?.insertable !== false;
+    if (wasInsertable && !isInsertable)
+        breaking(`${path}.insertable`, "no longer insertable: an editor cannot place it again");
+    else if (!wasInsertable && isInsertable)
+        additive(`${path}.insertable`, "insertable again");
+    const before = previous?.surfaces;
+    const after = next?.surfaces;
+    if (after === undefined) {
+        if (before !== undefined)
+            additive(`${path}.surfaces`, "now on any surface");
+        return;
+    }
+    if (before === undefined) {
+        breaking(`${path}.surfaces`, `now only on ${after.join(", ")}`);
+        return;
+    }
+    const removed = before.filter((surface) => !after.includes(surface));
+    if (removed.length > 0)
+        breaking(`${path}.surfaces`, `no longer on ${removed.join(", ")}`);
+    const added = after.filter((surface) => !before.includes(surface));
+    if (added.length > 0)
+        additive(`${path}.surfaces`, `now also on ${added.join(", ")}`);
+}
 /** A list's cap and required types: a lower cap hides saved instances; a new requirement only adds. */
 function compareCaps(previous, next, path, what, breaking, additive) {
     if (next.max !== undefined && (previous.max === undefined || next.max < previous.max)) {

package/dist/version.d.ts

@@ -4,4 +4,4 @@
  * reads. Always equal to `package.json`'s version; the package check refuses
  * a release where they differ.
  */
-export declare const THEME_SDK_VERSION = "2.0.0";
+export declare const THEME_SDK_VERSION = "2.1.0";

package/dist/version.js

@@ -4,4 +4,4 @@
  * reads. Always equal to `package.json`'s version; the package check refuses
  * a release where they differ.
  */
-export const THEME_SDK_VERSION = "2.0.0";
+export const THEME_SDK_VERSION = "2.1.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wocart/theme",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "The Wocart theme contract: code-owned component definitions, JSON page documents, validation and resolution, and a reference Astro renderer.",
   "keywords": [
     "wocart",