@almadar/patterns 1.0.1 → 1.0.9

package/{src → dist}/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-02-07T15:32:56.819Z",
+  "exportedAt": "2026-02-07T17:56:09.988Z",
   "mappings": {
     "page-header": {
       "component": "PageHeader",

package/{src → dist}/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-02-07T15:32:56.819Z",
+  "exportedAt": "2026-02-07T17:56:09.988Z",
   "contracts": {
     "form": {
       "emits": [

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-02-07T15:32:56.819Z";
+var exportedAt$3 = "2026-02-07T17:56:09.988Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -21291,8 +21291,7 @@ var patterns = {
 				types: [
 					"array"
 				],
-				description: "Array of tiles to render",
-				required: true
+				description: "Array of tiles to render (optional when entity is provided)"
 			},
 			units: {
 				types: [
@@ -21306,6 +21305,18 @@ var patterns = {
 				],
 				description: "Array of features (resources, portals, etc.)"
 			},
+			entity: {
+				types: [
+					"array"
+				],
+				description: "Raw Orbital entity data array. When provided, the component maps entity fields to tiles/units/features internally based on entityRole."
+			},
+			entityRole: {
+				types: [
+					"string"
+				],
+				description: "How to interpret entity data: - 'tiles': generate tiles from entity data - 'units': generate units from entity data - 'both': generate both tiles and features from entity data"
+			},
 			selectedUnitId: {
 				types: [
 					"string"
@@ -24093,7 +24104,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-02-07T15:32:56.819Z";
+var exportedAt$1 = "2026-02-07T17:56:09.988Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -26187,7 +26198,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-02-07T15:32:56.819Z";
+var exportedAt = "2026-02-07T17:56:09.988Z";
 var contracts = {
 	form: {
 		emits: [
@@ -35170,6 +35181,44 @@ declare const PATTERN_TYPES: PatternType[];
  */
 declare function isValidPatternType(type: string): type is PatternType;
 
+/**
+ * Prompt Helpers for @almadar/patterns
+ *
+ * Helper functions for generating prompts/documentation from pattern registry.
+ * Used by @almadar/skills package and other tools.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Get patterns grouped by category.
+ * Categories are derived from pattern registry metadata.
+ */
+declare function getPatternsGroupedByCategory(): Record<string, PatternType[]>;
+/**
+ * Get compact pattern props reference table.
+ * Generates markdown table of pattern names and their key props.
+ */
+declare function getPatternPropsCompact(): string;
+/**
+ * Get pattern action props reference.
+ * Lists patterns that have action/event props (buttons, forms, etc.).
+ */
+declare function getPatternActionsRef(): string;
+/**
+ * Generate pattern description from metadata.
+ * Auto-generates human-readable description from pattern props schema.
+ */
+declare function generatePatternDescription(patternType: string): string;
+/**
+ * Get all pattern types as array.
+ */
+declare function getAllPatternTypes(): PatternType[];
+/**
+ * Get pattern metadata for a specific pattern.
+ */
+declare function getPatternMetadata(patternType: string): any;
+
 declare const registry: {
     version: string;
     exportedAt: string;
@@ -49622,7 +49671,6 @@ declare const registry: {
                 tiles: {
                     types: string[];
                     description: string;
-                    required: boolean;
                 };
                 units: {
                     types: string[];
@@ -49632,6 +49680,14 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                entity: {
+                    types: string[];
+                    description: string;
+                };
+                entityRole: {
+                    types: string[];
+                    description: string;
+                };
                 selectedUnitId: {
                     types: string[];
                     description: string;
@@ -65608,7 +65664,6 @@ declare const PATTERN_REGISTRY: {
                 tiles: {
                     types: string[];
                     description: string;
-                    required: boolean;
                 };
                 units: {
                     types: string[];
@@ -65618,6 +65673,14 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                entity: {
+                    types: string[];
+                    description: string;
+                };
+                entityRole: {
+                    types: string[];
+                    description: string;
+                };
                 selectedUnitId: {
                     types: string[];
                     description: string;
@@ -72433,4 +72496,4 @@ declare function getComponentForPattern(patternType: string): any;
  */
 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 PatternType, componentMapping, eventContracts, getComponentForPattern, getPatternDefinition, integratorsRegistry, isEntityAwarePattern, isValidPatternType, patternsRegistry, registry };
+export { type AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, type PatternConfig, type PatternProps, type PatternPropsMap, type PatternType, componentMapping, eventContracts, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isEntityAwarePattern, isValidPatternType, patternsRegistry, registry };

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-02-07T15:32:56.819Z",
+  exportedAt: "2026-02-07T17:56:09.988Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -21266,8 +21266,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Array of tiles to render",
-          required: true
+          description: "Array of tiles to render (optional when entity is provided)"
         },
         units: {
           types: [
@@ -21281,6 +21280,18 @@ var patterns_registry_default = {
           ],
           description: "Array of features (resources, portals, etc.)"
         },
+        entity: {
+          types: [
+            "array"
+          ],
+          description: "Raw Orbital entity data array. When provided, the component maps entity fields to tiles/units/features internally based on entityRole."
+        },
+        entityRole: {
+          types: [
+            "string"
+          ],
+          description: "How to interpret entity data: - 'tiles': generate tiles from entity data - 'units': generate units from entity data - 'both': generate both tiles and features from entity data"
+        },
         selectedUnitId: {
           types: [
             "string"
@@ -24057,7 +24068,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-02-07T15:32:56.819Z",
+  exportedAt: "2026-02-07T17:56:09.988Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -26149,7 +26160,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-02-07T15:32:56.819Z",
+  exportedAt: "2026-02-07T17:56:09.988Z",
   contracts: {
     form: {
       emits: [
@@ -31766,6 +31777,87 @@ function isValidPatternType(type) {
   return PATTERN_TYPES.includes(type);
 }
 
+// src/helpers/prompt-helpers.ts
+function getPatternsGroupedByCategory() {
+  const patterns = patterns_registry_default.patterns || {};
+  const grouped = {};
+  for (const [patternName, patternDef] of Object.entries(patterns)) {
+    const category = patternDef.category || "uncategorized";
+    if (!grouped[category]) {
+      grouped[category] = [];
+    }
+    grouped[category].push(patternName);
+  }
+  return grouped;
+}
+function getPatternPropsCompact() {
+  const patterns = patterns_registry_default.patterns || {};
+  const lines = [
+    "| Pattern | Key Props |",
+    "|---------|-----------|"
+  ];
+  for (const [patternName, patternDef] of Object.entries(patterns)) {
+    const propsSchema = patternDef.propsSchema || {};
+    const requiredProps = Object.keys(propsSchema).filter(
+      (key) => propsSchema[key]?.required === true
+    );
+    const keyProps = requiredProps.length > 0 ? requiredProps.join(", ") : Object.keys(propsSchema).slice(0, 3).join(", ");
+    lines.push(`| ${patternName} | ${keyProps} |`);
+  }
+  return lines.join("\n");
+}
+function getPatternActionsRef() {
+  const patterns = patterns_registry_default.patterns || {};
+  const lines = [
+    "## Pattern Action Props",
+    "",
+    "| Pattern | Action Props | Notes |",
+    "|---------|-------------|-------|"
+  ];
+  for (const [patternName, patternDef] of Object.entries(patterns)) {
+    const propsSchema = patternDef.propsSchema || {};
+    const actionProps = [];
+    for (const [propName, propDef] of Object.entries(propsSchema)) {
+      if (propName.includes("action") || propName.includes("Action") || propName.includes("event") || propName.includes("Event") || propName === "onSubmit" || propName === "onClick") {
+        actionProps.push(propName);
+      }
+    }
+    if (actionProps.length > 0) {
+      const notes = patternDef.description || "";
+      lines.push(`| ${patternName} | ${actionProps.join(", ")} | ${notes.slice(0, 50)} |`);
+    }
+  }
+  return lines.join("\n");
+}
+function generatePatternDescription(patternType) {
+  const patterns = patterns_registry_default.patterns || {};
+  const patternDef = patterns[patternType];
+  if (!patternDef) {
+    return patternType;
+  }
+  const desc = patternDef.description;
+  if (desc) {
+    return desc;
+  }
+  const propsSchema = patternDef.propsSchema || {};
+  const propCount = Object.keys(propsSchema).length;
+  const requiredProps = Object.keys(propsSchema).filter(
+    (key) => propsSchema[key]?.required === true
+  );
+  if (requiredProps.length > 0) {
+    return `${patternType} (requires: ${requiredProps.join(", ")})`;
+  }
+  return `${patternType} (${propCount} props)`;
+}
+function getAllPatternTypes() {
+  const patterns = patterns_registry_default.patterns || {};
+  return Object.keys(patterns);
+}
+function getPatternMetadata(patternType) {
+  const patterns = patterns_registry_default.patterns || {};
+  return patterns[patternType] || null;
+}
+
 // src/index.ts
 var registry = patterns_registry_default;
 var PATTERN_REGISTRY = patterns_registry_default;
@@ -31789,6 +31881,6 @@ function isEntityAwarePattern(patternType) {
   return hasEntityProp && hasDataProp;
 }
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, component_mapping_default as componentMapping, event_contracts_default as eventContracts, getComponentForPattern, getPatternDefinition, integrators_registry_default as integratorsRegistry, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, registry };
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, component_mapping_default as componentMapping, event_contracts_default as eventContracts, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, registry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map