@contentful/experience-design-system-cli 2.20.2-dev-build-e7403ea.0 → 2.20.2-dev-build-67c8a28.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.20.2-dev-build-e7403ea.0",
+  "version": "2.20.2-dev-build-67c8a28.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -44,13 +44,13 @@
     "commander": "^13.1.0",
     "ink": "^4.4.1",
     "react": "^18.3.1",
-    "react-devtools-core": "^4.28.5",
+    "react-devtools-core": "^4.19.1",
     "react-dom": "^18.3.1"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
     "@types/node": "^24.0.3",
-    "@types/react": "^18.3.31",
+    "@types/react": "^18.3.24",
     "eslint": "^9.39.5",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.6",

package/dist/src/analyze/composition/interchange-schema.d.ts

@@ -11,7 +11,7 @@
  *
  * This module owns both shapes and the converters between them.
  */
-export type EdgeProvenance = 'user' | 'typed-slot' | `adapter:${string}` | 'agent';
+export type EdgeProvenance = 'user' | 'typed-slot' | 'structural' | `adapter:${string}` | 'agent';
 export type CompositionEdge = {
     parent: string;
     child: string;

package/dist/src/analyze/composition/merge-edges.js

@@ -1,15 +1,23 @@
 /**
  * Provenance rank (spec T2). Lower number = higher trust = wins conflicts.
- *   1 user  >  2 typed-slot  >  3 adapter:*  >  4 agent
+ *   1 user  >  2 typed-slot  >  3 structural  >  4 adapter:*  >  5 agent
+ *
+ * `structural` sits just below a declared slot contract: it's usage evidence
+ * (a runtime type-predicate function, a `.type === Component` identity check,
+ * direct JSX instantiation — see `structural-slot-evidence.ts`) rather than a
+ * typed generic or explicit marker, so a declared contract always overrides
+ * it on conflict, but it still outranks the LLM agent.
  */
 function rank(p) {
     if (p === 'user')
         return 1;
     if (p === 'typed-slot')
         return 2;
-    if (p.startsWith('adapter:'))
+    if (p === 'structural')
         return 3;
-    return 4; // agent
+    if (p.startsWith('adapter:'))
+        return 4;
+    return 5; // agent
 }
 /**
  * Union all edges, resolving conflicts by provenance rank. A conflict is two

package/dist/src/analyze/composition/resolve-mapping.d.ts

@@ -10,7 +10,8 @@ export type ResolveMappingResult = {
 /**
  * Orchestrate composition-map acquisition (spec T2) and enrichment (T7).
  *
- * Sources by rank: user map (1) > typed-slot / "code slots" (2) > agent (4).
+ * Sources by rank: user map (1) > typed-slot / "code slots" (2) > structural
+ * usage evidence (3) > adapter-resolved / extraEdges (4) > agent (5).
  * ALL sources — including the code slots already on the incoming components —
  * are fed into one ranked merge and unioned; non-conflicting edges from every
  * source survive, and on a conflict (same parent+child, different slot) the

package/dist/src/analyze/composition/resolve-mapping.js

@@ -6,7 +6,8 @@ import { loadPrompt } from './agent-parser/load-prompt.js';
 /**
  * Orchestrate composition-map acquisition (spec T2) and enrichment (T7).
  *
- * Sources by rank: user map (1) > typed-slot / "code slots" (2) > agent (4).
+ * Sources by rank: user map (1) > typed-slot / "code slots" (2) > structural
+ * usage evidence (3) > adapter-resolved / extraEdges (4) > agent (5).
  * ALL sources — including the code slots already on the incoming components —
  * are fed into one ranked merge and unioned; non-conflicting edges from every
  * source survive, and on a conflict (same parent+child, different slot) the
@@ -33,18 +34,30 @@ export async function resolveMapping(input) {
             }
         }
     }
+    // Rank 3 — structural usage evidence (runtime type-predicate, `.type ===`
+    // identity check, or direct JSX nesting — see structural-slot-evidence.ts).
+    // Lower trust than a declared slot contract, but still code-derived, so it
+    // outranks the agent and suppresses a redundant agent run when it alone
+    // covers a parent.
+    for (const c of input.components) {
+        for (const slot of c.slots) {
+            for (const child of slot.structuralAllowedComponents ?? []) {
+                collected.push({ parent: c.name, child, slot: slot.name, provenance: 'structural' });
+            }
+        }
+    }
     // Rank 1 — user-provided map.
     if (input.userMap) {
         collected.push(...groupsToEdges(input.userMap, 'user'));
     }
-    // Externally pre-resolved edges (e.g. agent-authored parser, rank 3).
+    // Externally pre-resolved edges (e.g. adapter-authored parser, rank 4).
     if (input.extraEdges) {
         collected.push(...input.extraEdges);
     }
     // Routing: which parents are already covered by a higher-rank source?
     const coveredParents = new Set(collected.map((e) => e.parent));
     const residueParents = input.components.map((c) => c.name).filter((n) => !coveredParents.has(n));
-    // Rank 4 — agent. Runs when enabled AND (forced OR there is residue).
+    // Rank 5 — agent. Runs when enabled AND (forced OR there is residue).
     const shouldRunAgent = (input.useAgent || input.forceAgent) && (input.forceAgent || residueParents.length > 0);
     if (shouldRunAgent) {
         const prompt = input.buildPrompt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.20.2-dev-build-e7403ea.0",
+  "version": "2.20.2-dev-build-67c8a28.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -31,17 +31,17 @@
     "commander": "^13.1.0",
     "ink": "^4.4.1",
     "react": "^18.3.1",
-    "react-devtools-core": "^4.28.5",
+    "react-devtools-core": "^4.19.1",
     "react-dom": "^18.3.1",
-    "@contentful/experience-design-system-client": "2.20.2-dev-build-e7403ea.0",
-    "@contentful/experience-design-system-generation": "2.20.2-dev-build-e7403ea.0",
-    "@contentful/experience-design-system-extraction": "2.20.2-dev-build-e7403ea.0",
-    "@contentful/experience-design-system-types": "2.20.2-dev-build-e7403ea.0"
+    "@contentful/experience-design-system-client": "2.20.2-dev-build-67c8a28.0",
+    "@contentful/experience-design-system-extraction": "2.20.2-dev-build-67c8a28.0",
+    "@contentful/experience-design-system-generation": "2.20.2-dev-build-67c8a28.0",
+    "@contentful/experience-design-system-types": "2.20.2-dev-build-67c8a28.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
     "@types/node": "^24.0.3",
-    "@types/react": "^18.3.31",
+    "@types/react": "^18.3.24",
     "eslint": "^9.39.5",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.6",