@almadar/patterns 2.34.1 → 2.36.0

package/dist/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-05-30T10:04:19.715Z",
+  "exportedAt": "2026-06-04T18:07:03.548Z",
   "mappings": {
     "page-header": {
       "component": "PageHeader",

package/dist/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-05-30T10:04:19.715Z",
+  "exportedAt": "2026-06-04T18:07:03.548Z",
   "contracts": {
     "form": {
       "emits": [

package/dist/helpers/pattern-swap.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pattern-swap compatibility — the deterministic shape gate for a contextual
+ * pattern swap. A swap keeps the circuit closed when the replacement shares the
+ * current pattern's entity-inlet cardinality and can emit the events the
+ * consumer's trait listens for. Semantic ranking (which compatible pattern best
+ * matches the user's instruction) is the embedding step, layered on top of this
+ * gate — never the other way around.
+ */
+/** The data-inlet cardinality of a pattern (`record`/`collection`), or `null`
+ *  when the pattern has no entity inlet (layout / leaf patterns). */
+export declare function getEntityCardinality(patternType: string): 'record' | 'collection' | null;
+/** Events a pattern emits, from its declared event-outlet contract. */
+export declare function getEmittedEvents(patternType: string): string[];
+export interface PatternSwapGate {
+    /** Events the replacement MUST be able to emit (the trait's listened set), so
+     *  handlers still fire after the swap. Omit to skip the outlet gate. */
+    requiredEmits?: readonly string[];
+}
+/**
+ * Pattern types a `currentType` node can be swapped to while keeping the circuit
+ * closed: same entity-inlet cardinality, and — when `requiredEmits` is given —
+ * able to emit every required event. Deterministic and unranked; the caller
+ * ranks the result semantically (embeddings).
+ */
+export declare function findCompatiblePatterns(currentType: string, gate?: PatternSwapGate): string[];