@almadar/patterns 2.10.0 → 2.11.0

package/dist/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-03-28T13:39:00.733Z",
+  "exportedAt": "2026-04-03T05:25:58.152Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -2785,6 +2785,18 @@
             "string"
           ],
           "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave"
+        },
+        "maxWidth": {
+          "types": [
+            "string"
+          ],
+          "description": "Maximum width (CSS value, e.g., \"550px\", \"80rem\")"
+        },
+        "children": {
+          "types": [
+            "node"
+          ],
+          "description": "Children elements"
         }
       }
     },
@@ -10621,6 +10633,12 @@
           ],
           "description": "Maximum height before scrolling"
         },
+        "foldable": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Enable JSON-style code folding (default: true for json/orb)"
+        },
         "className": {
           "types": [
             "string"
@@ -13204,6 +13222,12 @@
           ],
           "description": "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored."
         },
+        "renderItem": {
+          "types": [
+            "function"
+          ],
+          "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. @deprecated Use children render prop in React code. This prop exists for pattern registry sync."
+        },
         "pageSize": {
           "types": [
             "number"
@@ -13364,6 +13388,12 @@
           ],
           "description": "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored."
         },
+        "renderItem": {
+          "types": [
+            "function"
+          ],
+          "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. @deprecated Use children render prop in React code. This prop exists for pattern registry sync."
+        },
         "pageSize": {
           "types": [
             "number"
@@ -20509,23 +20539,17 @@
           "description": "schema prop",
           "required": true
         },
-        "className": {
+        "mockData": {
           "types": [
-            "string"
+            "object"
           ],
-          "description": "className prop"
+          "description": "mockData prop"
         },
-        "color": {
+        "className": {
           "types": [
             "string"
           ],
-          "description": "color prop"
-        },
-        "animated": {
-          "types": [
-            "boolean"
-          ],
-          "description": "animated prop"
+          "description": "className prop"
         },
         "width": {
           "types": [
@@ -20541,35 +20565,131 @@
           ],
           "description": "height prop"
         },
+        "onNodeClick": {
+          "types": [
+            "function"
+          ],
+          "description": "onNodeClick prop"
+        },
+        "onLevelChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onLevelChange prop"
+        },
+        "initialOrbital": {
+          "types": [
+            "string"
+          ],
+          "description": "initialOrbital prop"
+        },
+        "initialLevel": {
+          "types": [
+            "object"
+          ],
+          "description": "Start at Level 2 (expanded) when initialOrbital is set. Default: 'overview'."
+        },
+        "initialSelectedNode": {
+          "types": [
+            "object"
+          ],
+          "description": "Pre-select a node on mount (opens OrbInspector)."
+        },
+        "editable": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Enable editing in the inspector. When true, fields become inputs."
+        },
+        "onSchemaChange": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when the user edits the schema via the inspector."
+        },
+        "onPatternDelete": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when the user presses Delete/Backspace with a pattern selected."
+        },
+        "onEventWire": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when the user drags from a source handle to a target handle (event wiring)."
+        },
+        "behaviorMeta": {
+          "types": [
+            "object"
+          ],
+          "description": "Behavior layer metadata for node styling (layer color bands)."
+        },
+        "layoutHint": {
+          "types": [
+            "string"
+          ],
+          "description": "Layout hint: 'pipeline' renders nodes left-to-right, 'grid' (default) uses sqrt-based grid."
+        },
+        "onNodeSelect": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when the user clicks a node in overview level (for composition hints)."
+        },
+        "composeLevel": {
+          "types": [
+            "object"
+          ],
+          "description": "When 'behavior', shows behavior-level glyph nodes instead of orbital previews."
+        },
+        "behaviorEntries": {
+          "types": [
+            "array"
+          ],
+          "description": "Behavior entries for compose mode (only when composeLevel='behavior')."
+        },
+        "behaviorWires": {
+          "types": [
+            "array"
+          ],
+          "description": "Event wires between behaviors (only when composeLevel='behavior')."
+        },
         "onZoomChange": {
           "types": [
             "function"
           ],
-          "description": "onZoomChange prop"
+          "description": "@deprecated Use onNodeClick instead. Kept for AvlCosmicZoom compat."
         },
         "focusTarget": {
           "types": [
             "object"
           ],
-          "description": "focusTarget prop"
+          "description": "@deprecated Not used in V3."
         },
-        "initialOrbital": {
+        "color": {
           "types": [
             "string"
           ],
-          "description": "initialOrbital prop"
+          "description": "@deprecated Not used in V3."
+        },
+        "animated": {
+          "types": [
+            "boolean"
+          ],
+          "description": "@deprecated Not used in V3."
         },
         "initialTrait": {
           "types": [
             "string"
           ],
-          "description": "initialTrait prop"
+          "description": "@deprecated Not used in V3."
         },
         "stateCoverage": {
           "types": [
             "object"
           ],
-          "description": "stateCoverage prop"
+          "description": "@deprecated Not used in V3."
         }
       }
     },
@@ -22623,6 +22743,52 @@
         }
       }
     },
+    "orb-inspector": {
+      "type": "orb-inspector",
+      "category": "debug",
+      "description": "OrbInspector component",
+      "suggestedFor": [
+        "orb",
+        "inspector",
+        "orb inspector"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "node": {
+          "types": [
+            "object"
+          ],
+          "description": "node prop",
+          "required": true
+        },
+        "schema": {
+          "types": [
+            "object"
+          ],
+          "description": "schema prop",
+          "required": true
+        },
+        "editable": {
+          "types": [
+            "boolean"
+          ],
+          "description": "editable prop"
+        },
+        "onSchemaChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onSchemaChange prop"
+        },
+        "onClose": {
+          "types": [
+            "function"
+          ],
+          "description": "onClose prop",
+          "required": true
+        }
+      }
+    },
     "heading": {
       "type": "heading",
       "category": "component",

package/dist/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-03-28T13:39:00.733Z",
+  "exportedAt": "2026-04-03T05:25:58.152Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -2785,6 +2785,18 @@
             "string"
           ],
           "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave"
+        },
+        "maxWidth": {
+          "types": [
+            "string"
+          ],
+          "description": "Maximum width (CSS value, e.g., \"550px\", \"80rem\")"
+        },
+        "children": {
+          "types": [
+            "node"
+          ],
+          "description": "Children elements"
         }
       }
     },
@@ -10621,6 +10633,12 @@
           ],
           "description": "Maximum height before scrolling"
         },
+        "foldable": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Enable JSON-style code folding (default: true for json/orb)"
+        },
         "className": {
           "types": [
             "string"
@@ -13204,6 +13222,12 @@
           ],
           "description": "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored."
         },
+        "renderItem": {
+          "types": [
+            "function"
+          ],
+          "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. @deprecated Use children render prop in React code. This prop exists for pattern registry sync."
+        },
         "pageSize": {
           "types": [
             "number"
@@ -13364,6 +13388,12 @@
           ],
           "description": "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored."
         },
+        "renderItem": {
+          "types": [
+            "function"
+          ],
+          "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. @deprecated Use children render prop in React code. This prop exists for pattern registry sync."
+        },
         "pageSize": {
           "types": [
             "number"
@@ -20509,23 +20539,17 @@
           "description": "schema prop",
           "required": true
         },
-        "className": {
+        "mockData": {
           "types": [
-            "string"
+            "object"
           ],
-          "description": "className prop"
+          "description": "mockData prop"
         },
-        "color": {
+        "className": {
           "types": [
             "string"
           ],
-          "description": "color prop"
-        },
-        "animated": {
-          "types": [
-            "boolean"
-          ],
-          "description": "animated prop"
+          "description": "className prop"
         },
         "width": {
           "types": [
@@ -20541,35 +20565,131 @@
           ],
           "description": "height prop"
         },
+        "onNodeClick": {
+          "types": [
+            "function"
+          ],
+          "description": "onNodeClick prop"
+        },
+        "onLevelChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onLevelChange prop"
+        },
+        "initialOrbital": {
+          "types": [
+            "string"
+          ],
+          "description": "initialOrbital prop"
+        },
+        "initialLevel": {
+          "types": [
+            "object"
+          ],
+          "description": "Start at Level 2 (expanded) when initialOrbital is set. Default: 'overview'."
+        },
+        "initialSelectedNode": {
+          "types": [
+            "object"
+          ],
+          "description": "Pre-select a node on mount (opens OrbInspector)."
+        },
+        "editable": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Enable editing in the inspector. When true, fields become inputs."
+        },
+        "onSchemaChange": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when the user edits the schema via the inspector."
+        },
+        "onPatternDelete": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when the user presses Delete/Backspace with a pattern selected."
+        },
+        "onEventWire": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when the user drags from a source handle to a target handle (event wiring)."
+        },
+        "behaviorMeta": {
+          "types": [
+            "object"
+          ],
+          "description": "Behavior layer metadata for node styling (layer color bands)."
+        },
+        "layoutHint": {
+          "types": [
+            "string"
+          ],
+          "description": "Layout hint: 'pipeline' renders nodes left-to-right, 'grid' (default) uses sqrt-based grid."
+        },
+        "onNodeSelect": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when the user clicks a node in overview level (for composition hints)."
+        },
+        "composeLevel": {
+          "types": [
+            "object"
+          ],
+          "description": "When 'behavior', shows behavior-level glyph nodes instead of orbital previews."
+        },
+        "behaviorEntries": {
+          "types": [
+            "array"
+          ],
+          "description": "Behavior entries for compose mode (only when composeLevel='behavior')."
+        },
+        "behaviorWires": {
+          "types": [
+            "array"
+          ],
+          "description": "Event wires between behaviors (only when composeLevel='behavior')."
+        },
         "onZoomChange": {
           "types": [
             "function"
           ],
-          "description": "onZoomChange prop"
+          "description": "@deprecated Use onNodeClick instead. Kept for AvlCosmicZoom compat."
         },
         "focusTarget": {
           "types": [
             "object"
           ],
-          "description": "focusTarget prop"
+          "description": "@deprecated Not used in V3."
         },
-        "initialOrbital": {
+        "color": {
           "types": [
             "string"
           ],
-          "description": "initialOrbital prop"
+          "description": "@deprecated Not used in V3."
+        },
+        "animated": {
+          "types": [
+            "boolean"
+          ],
+          "description": "@deprecated Not used in V3."
         },
         "initialTrait": {
           "types": [
             "string"
           ],
-          "description": "initialTrait prop"
+          "description": "@deprecated Not used in V3."
         },
         "stateCoverage": {
           "types": [
             "object"
           ],
-          "description": "stateCoverage prop"
+          "description": "@deprecated Not used in V3."
         }
       }
     },
@@ -22623,6 +22743,52 @@
         }
       }
     },
+    "orb-inspector": {
+      "type": "orb-inspector",
+      "category": "debug",
+      "description": "OrbInspector component",
+      "suggestedFor": [
+        "orb",
+        "inspector",
+        "orb inspector"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "node": {
+          "types": [
+            "object"
+          ],
+          "description": "node prop",
+          "required": true
+        },
+        "schema": {
+          "types": [
+            "object"
+          ],
+          "description": "schema prop",
+          "required": true
+        },
+        "editable": {
+          "types": [
+            "boolean"
+          ],
+          "description": "editable prop"
+        },
+        "onSchemaChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onSchemaChange prop"
+        },
+        "onClose": {
+          "types": [
+            "function"
+          ],
+          "description": "onClose prop",
+          "required": true
+        }
+      }
+    },
     "heading": {
       "type": "heading",
       "category": "component",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/patterns",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "description": "Pattern registry and component mappings for Almadar",
   "type": "module",
   "main": "./dist/index.js",