@almadar/patterns 2.6.3 → 2.7.1

package/dist/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-03-12T02:35:44.580Z",
+  "exportedAt": "2026-03-15T00:20:59.995Z",
   "mappings": {
     "page-header": {
       "component": "PageHeader",

package/dist/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-03-12T02:35:44.580Z",
+  "exportedAt": "2026-03-15T00:20:59.995Z",
   "contracts": {
     "form": {
       "emits": [

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-03-12T02:35:44.580Z";
+var exportedAt$3 = "2026-03-15T00:20:59.995Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -3420,6 +3420,24 @@ var patterns = {
 					"string"
 				],
 				description: "Additional CSS classes"
+			},
+			mode: {
+				types: [
+					"string"
+				],
+				description: "Display mode: floating (fixed overlay) or inline (block element)"
+			},
+			defaultTab: {
+				types: [
+					"string"
+				],
+				description: "Default active tab id"
+			},
+			schema: {
+				types: [
+					"object"
+				],
+				description: "Raw schema for EventDispatcherTab payload extraction"
 			}
 		}
 	},
@@ -6202,6 +6220,12 @@ var patterns = {
 				],
 				description: "onClick prop"
 			},
+			event: {
+				types: [
+					"string"
+				],
+				description: "event prop"
+			},
 			icon: {
 				types: [
 					"string"
@@ -7350,6 +7374,12 @@ var patterns = {
 				],
 				description: "Include HUD slots"
 			},
+			hudMode: {
+				types: [
+					"string"
+				],
+				description: "HUD positioning mode: 'fixed' (default, viewport-relative) or 'inline' (container-relative, uses sticky)"
+			},
 			includeFloating: {
 				types: [
 					"boolean"
@@ -17605,7 +17635,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-03-12T02:35:44.580Z";
+var exportedAt$1 = "2026-03-15T00:20:59.995Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -18833,7 +18863,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-03-12T02:35:44.580Z";
+var exportedAt = "2026-03-15T00:20:59.995Z";
 var contracts = {
 	form: {
 		emits: [
@@ -22975,6 +23005,37 @@ declare function getAllPatternTypes(): PatternType[];
  * Get pattern metadata for a specific pattern.
  */
 declare function getPatternMetadata(patternType: string): PatternEntry$1 | null;
+/**
+ * Get patterns allowed in .orb render-ui trees.
+ *
+ * Returns all non-entity patterns (atoms/molecules) plus the allowed
+ * entity-aware exceptions (data-list, data-grid, search-input, form-section, meter).
+ * Excludes game-specific, debug, and template patterns.
+ *
+ * Grouped by registry category with description and key props.
+ */
+declare function getOrbAllowedPatterns(): Record<string, Array<{
+    name: string;
+    description: string;
+    keyProps: string[];
+}>>;
+/**
+ * Get compact markdown reference of .orb-allowed patterns.
+ * Derives everything from the registry. No hardcoded pattern lists.
+ */
+declare function getOrbAllowedPatternsCompact(): string;
+/**
+ * Get a slim one-line-per-pattern catalog for Gate 3.5 pattern selection.
+ * Format: "- pattern-name: one-line description"
+ * Much smaller than the full compact reference (~800 tokens vs ~3,500).
+ */
+declare function getOrbAllowedPatternsSlim(): string;
+/**
+ * Get compact markdown reference for a filtered subset of patterns.
+ * Used by Gate 4 after Gate 3.5 selects the relevant patterns.
+ * Includes all props (not just top 5) since we're showing fewer patterns.
+ */
+declare function getOrbAllowedPatternsFiltered(patternNames: string[]): string;
 
 /**
  * Pattern Recommender
@@ -25357,6 +25418,18 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                mode: {
+                    types: string[];
+                    description: string;
+                };
+                defaultTab: {
+                    types: string[];
+                    description: string;
+                };
+                schema: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         button: {
@@ -27241,6 +27314,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                event: {
+                    types: string[];
+                    description: string;
+                };
                 icon: {
                     types: string[];
                     description: string;
@@ -28020,6 +28097,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                hudMode: {
+                    types: string[];
+                    description: string;
+                };
                 includeFloating: {
                     types: string[];
                     description: string;
@@ -36727,6 +36808,18 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                mode: {
+                    types: string[];
+                    description: string;
+                };
+                defaultTab: {
+                    types: string[];
+                    description: string;
+                };
+                schema: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         button: {
@@ -38611,6 +38704,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                event: {
+                    types: string[];
+                    description: string;
+                };
                 icon: {
                     types: string[];
                     description: string;
@@ -39390,6 +39487,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                hudMode: {
+                    types: string[];
+                    description: string;
+                };
                 includeFloating: {
                     types: string[];
                     description: string;
@@ -48313,4 +48414,4 @@ declare function getComponentForPattern(patternType: string): string | null;
  */
 declare function isEntityAwarePattern(patternType: string): boolean;
 
-export { type AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, type PatternConfig, type PatternProps, type PatternPropsMap, type PatternRecommendation, type PatternType, type RecommendationContext, buildRecommendationContext, componentMapping, eventContracts, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isEntityAwarePattern, isValidPatternType, patternsRegistry, recommendPatterns, registry };
+export { type AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, type PatternConfig, type PatternProps, type PatternPropsMap, type PatternRecommendation, type PatternType, type RecommendationContext, buildRecommendationContext, componentMapping, eventContracts, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isEntityAwarePattern, isValidPatternType, patternsRegistry, recommendPatterns, registry };

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-03-12T02:35:44.580Z",
+  exportedAt: "2026-03-15T00:20:59.995Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -3422,6 +3422,24 @@ var patterns_registry_default = {
             "string"
           ],
           description: "Additional CSS classes"
+        },
+        mode: {
+          types: [
+            "string"
+          ],
+          description: "Display mode: floating (fixed overlay) or inline (block element)"
+        },
+        defaultTab: {
+          types: [
+            "string"
+          ],
+          description: "Default active tab id"
+        },
+        schema: {
+          types: [
+            "object"
+          ],
+          description: "Raw schema for EventDispatcherTab payload extraction"
         }
       }
     },
@@ -6204,6 +6222,12 @@ var patterns_registry_default = {
           ],
           description: "onClick prop"
         },
+        event: {
+          types: [
+            "string"
+          ],
+          description: "event prop"
+        },
         icon: {
           types: [
             "string"
@@ -7352,6 +7376,12 @@ var patterns_registry_default = {
           ],
           description: "Include HUD slots"
         },
+        hudMode: {
+          types: [
+            "string"
+          ],
+          description: "HUD positioning mode: 'fixed' (default, viewport-relative) or 'inline' (container-relative, uses sticky)"
+        },
         includeFloating: {
           types: [
             "boolean"
@@ -17484,7 +17514,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-03-12T02:35:44.580Z",
+  exportedAt: "2026-03-15T00:20:59.995Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -18710,7 +18740,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-03-12T02:35:44.580Z",
+  exportedAt: "2026-03-15T00:20:59.995Z",
   contracts: {
     form: {
       emits: [
@@ -20115,6 +20145,94 @@ function getPatternMetadata(patternType) {
   const patterns = patterns_registry_default.patterns || {};
   return patterns[patternType] || null;
 }
+var ORB_ALLOWED_ENTITY_PATTERNS = /* @__PURE__ */ new Set([
+  "data-list",
+  "data-grid",
+  "search-input",
+  "form-section",
+  "meter"
+]);
+var ORB_EXCLUDED_CATEGORIES = /* @__PURE__ */ new Set([
+  "game",
+  "debug",
+  "template"
+]);
+function getOrbAllowedPatterns() {
+  const patterns = patterns_registry_default.patterns || {};
+  const grouped = {};
+  for (const [name, def] of Object.entries(patterns)) {
+    const cat = def.category || "uncategorized";
+    if (ORB_EXCLUDED_CATEGORIES.has(cat)) continue;
+    if (name.includes("3-d") || name.includes("3d")) continue;
+    const hasEntity = def.propsSchema && "entity" in def.propsSchema;
+    if (hasEntity && !ORB_ALLOWED_ENTITY_PATTERNS.has(name)) continue;
+    const propsSchema = def.propsSchema || {};
+    const keyProps = Object.keys(propsSchema).slice(0, 5);
+    if (!grouped[cat]) grouped[cat] = [];
+    grouped[cat].push({
+      name,
+      description: def.description || "",
+      keyProps
+    });
+  }
+  return grouped;
+}
+function getOrbAllowedPatternsCompact() {
+  const grouped = getOrbAllowedPatterns();
+  const lines = [];
+  for (const [cat, items] of Object.entries(grouped).sort()) {
+    lines.push(`#### ${cat} (${items.length})`);
+    lines.push("| Pattern | Description | Key Props |");
+    lines.push("|---------|-------------|-----------|");
+    for (const item of items) {
+      const desc = item.description.split("\n")[0].slice(0, 60);
+      lines.push(`| \`${item.name}\` | ${desc} | ${item.keyProps.join(", ")} |`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function getOrbAllowedPatternsSlim() {
+  const grouped = getOrbAllowedPatterns();
+  const lines = [];
+  for (const [cat, items] of Object.entries(grouped).sort()) {
+    lines.push(`## ${cat}`);
+    for (const item of items) {
+      const desc = item.description.split("\n")[0].slice(0, 80);
+      lines.push(`- ${item.name}: ${desc}`);
+    }
+  }
+  return lines.join("\n");
+}
+function getOrbAllowedPatternsFiltered(patternNames) {
+  const nameSet = new Set(patternNames);
+  const patterns = patterns_registry_default.patterns || {};
+  const grouped = {};
+  for (const [name, def] of Object.entries(patterns)) {
+    if (!nameSet.has(name)) continue;
+    const cat = def.category || "uncategorized";
+    const propsSchema = def.propsSchema || {};
+    const allProps = Object.keys(propsSchema);
+    if (!grouped[cat]) grouped[cat] = [];
+    grouped[cat].push({
+      name,
+      description: def.description || "",
+      allProps
+    });
+  }
+  const lines = [];
+  for (const [cat, items] of Object.entries(grouped).sort()) {
+    lines.push(`#### ${cat} (${items.length})`);
+    lines.push("| Pattern | Description | Props |");
+    lines.push("|---------|-------------|-------|");
+    for (const item of items) {
+      const desc = item.description.split("\n")[0].slice(0, 60);
+      lines.push(`| \`${item.name}\` | ${desc} | ${item.allProps.join(", ")} |`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
 
 // src/helpers/pattern-recommender.ts
 var DOMAIN_KEYWORDS = {
@@ -20292,6 +20410,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, 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, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map