@almadar/patterns 2.35.0 → 2.36.0

package/dist/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-06-02T04:23:24.655Z",
+  "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-06-02T04:23:24.655Z",
+  "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[];

package/dist/index.d.ts

@@ -44147,3 +44147,4 @@ export declare function getComponentForPattern(patternType: string): string | nu
 export declare function isEntityAwarePattern(patternType: string): boolean;
 export { getPatternsGroupedByCategory, getPatternPropsCompact, getPatternActionsRef, generatePatternDescription, getAllPatternTypes, getPatternMetadata, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsSlim, getOrbAllowedPatternsFiltered, } from './helpers/prompt-helpers.js';
 export { recommendPatterns, buildRecommendationContext, formatRecommendationsForPrompt, type RecommendationContext, type PatternRecommendation, } from './helpers/pattern-recommender.js';
+export { findCompatiblePatterns, getEntityCardinality, getEmittedEvents, type PatternSwapGate, } from './helpers/pattern-swap.js';

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-02T04:23:24.655Z",
+  exportedAt: "2026-06-04T18:07:03.548Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -33753,7 +33753,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-02T04:23:24.655Z",
+  exportedAt: "2026-06-04T18:07:03.548Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -35293,7 +35293,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-02T04:23:24.655Z",
+  exportedAt: "2026-06-04T18:07:03.548Z",
   contracts: {
     form: {
       emits: [
@@ -37183,6 +37183,44 @@ function formatRecommendationsForPrompt(recommendations) {
   return lines.join("\n");
 }
 
+// src/helpers/pattern-swap.ts
+var PATTERNS = patterns_registry_default;
+var CONTRACTS = event_contracts_default;
+function entityInlet(patternType) {
+  const propsSchema = PATTERNS.patterns?.[patternType]?.propsSchema;
+  if (!propsSchema) return null;
+  for (const prop of Object.values(propsSchema)) {
+    if (prop.kind === "entity") return prop;
+  }
+  return propsSchema["entity"] ?? null;
+}
+function getEntityCardinality(patternType) {
+  return entityInlet(patternType)?.cardinality ?? null;
+}
+function getEmittedEvents(patternType) {
+  const emits = CONTRACTS.contracts?.[patternType]?.emits ?? [];
+  const out = [];
+  for (const e of emits) {
+    if (typeof e.event === "string") out.push(e.event);
+  }
+  return out;
+}
+function findCompatiblePatterns(currentType, gate = {}) {
+  const cardinality = getEntityCardinality(currentType);
+  const required = gate.requiredEmits ?? [];
+  const result = [];
+  for (const type of Object.keys(PATTERNS.patterns ?? {})) {
+    if (type === currentType) continue;
+    if (getEntityCardinality(type) !== cardinality) continue;
+    if (required.length > 0) {
+      const emits = new Set(getEmittedEvents(type));
+      if (!required.every((ev) => emits.has(ev))) continue;
+    }
+    result.push(type);
+  }
+  return result;
+}
+
 // src/index.ts
 var registry = patterns_registry_default;
 var PATTERN_REGISTRY = patterns_registry_default;
@@ -37205,6 +37243,6 @@ function isEntityAwarePattern(patternType) {
   return "entity" in propsSchema;
 }
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, component_mapping_default as componentMapping, event_contracts_default as eventContracts, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, recommendPatterns, registry };
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, component_mapping_default as componentMapping, event_contracts_default as eventContracts, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, recommendPatterns, registry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map