@almadar/core 11.0.1 → 11.2.0

package/dist/patterns/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-11-06T03:25:33.553Z",
+  "exportedAt": "2026-11-07T03:57:49.631Z",
   "contracts": {
     "form": {
       "emits": [

package/dist/patterns/index.d.ts

@@ -1,6 +1,6 @@
-import { A as AnyPatternConfig, o as PatternType } from '../effect-DZaXwSAz.js';
+import { A as AnyPatternConfig, o as PatternType } from '../effect-Dr--GXRe.js';
 import { RenderBinding, FieldValue, Effect } from '../index.js';
-export { p as PATTERN_TYPES, q as PatternConfig, r as PatternProps, s as PatternPropsMap, t as isValidPatternType } from '../effect-DZaXwSAz.js';
+export { p as PATTERN_TYPES, q as PatternConfig, r as PatternProps, s as PatternPropsMap, t as isValidPatternType } from '../effect-Dr--GXRe.js';
 import { JsonValue } from '../factory/index.js';
 import { EventPayloadValue, EventPayload, SExprObject, SExpr } from '../index.js';
 import 'zod';

package/dist/patterns/index.js

@@ -1,5 +1,5 @@
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, PATTERN_TYPES, PROP_KINDS, SELF_OVERLAY_PATTERN_TYPES, SERVICES_REGISTRY, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternFieldsContract, getPatternMetadata, getPatternMinUsableWidths, getPatternPropsCompact, getPatternRuntimeDefinition, getPatternsGroupedByCategory, isBrowserOnlyService, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, renderUiEntriesOf, renderUiPatternTypesOf, services_registry_default as servicesRegistry } from '../chunk-66Q5VX2F.js';
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, PATTERN_TYPES, PROP_KINDS, SELF_OVERLAY_PATTERN_TYPES, SERVICES_REGISTRY, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternFieldsContract, getPatternMetadata, getPatternMinUsableWidths, getPatternPropsCompact, getPatternRuntimeDefinition, getPatternsGroupedByCategory, isBrowserOnlyService, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, renderUiEntriesOf, renderUiPatternTypesOf, services_registry_default as servicesRegistry } from '../chunk-ZDIHVDTW.js';
 import '../chunk-7GHJU5WI.js';
-export { PATTERN_REGISTRY, getPatternDefinition, patternsRegistry, registry } from '../chunk-SNZYN7UA.js';
+export { PATTERN_REGISTRY, getPatternDefinition, patternsRegistry, registry } from '../chunk-N3CK4AYW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/patterns/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-11-06T03:25:33.553Z",
+  "exportedAt": "2026-11-07T03:57:49.631Z",
   "patterns": {
     "detail-panel": {
       "type": "detail-panel",
@@ -97003,6 +97003,49 @@
           },
           "default": []
         },
+        "particles": {
+          "types": [
+            "object"
+          ],
+          "description": "Packed particles drawn under the shapes in one pass ({@link LearningParticles}).",
+          "properties": {
+            "data": {
+              "types": [
+                "string"
+              ]
+            },
+            "buffer": {
+              "types": [
+                "GpuBuffer"
+              ]
+            },
+            "stride": {
+              "types": [
+                "number"
+              ]
+            },
+            "radius": {
+              "types": [
+                "number"
+              ]
+            },
+            "palette": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "string"
+                ]
+              }
+            }
+          },
+          "propertyRequired": [
+            "stride",
+            "radius",
+            "palette"
+          ]
+        },
         "drawables": {
           "types": [
             "array"
@@ -97735,7 +97778,7 @@
           "types": [
             "string"
           ],
-          "description": "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host.",
+          "description": "Painter: 2D raster (default) or 3D mesh scene, both drawn by orbital-canvas.",
           "enumValues": [
             "2d",
             "3d"
@@ -98906,7 +98949,7 @@
           "types": [
             "array"
           ],
-          "description": "Top-right status chip row, forwarded to LearningCanvas verbatim.",
+          "description": "Top-right status chip row (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -98939,7 +98982,7 @@
           "types": [
             "array"
           ],
-          "description": "Inset sparkline panels, forwarded to LearningCanvas verbatim.",
+          "description": "Inset sparkline panels (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -99519,7 +99562,7 @@
           "types": [
             "string"
           ],
-          "description": "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host.",
+          "description": "Painter: 2D raster (default) or 3D mesh scene, both drawn by orbital-canvas.",
           "enumValues": [
             "2d",
             "3d"
@@ -100675,7 +100718,7 @@
           "types": [
             "array"
           ],
-          "description": "Top-right status chip row, forwarded to LearningCanvas verbatim.",
+          "description": "Top-right status chip row (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -100708,7 +100751,7 @@
           "types": [
             "array"
           ],
-          "description": "Inset sparkline panels, forwarded to LearningCanvas verbatim.",
+          "description": "Inset sparkline panels (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -102169,7 +102212,7 @@
           "types": [
             "array"
           ],
-          "description": "Top-right status chips, forwarded verbatim to LearningCanvas.",
+          "description": "Top-right status chips (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -102202,7 +102245,7 @@
           "types": [
             "array"
           ],
-          "description": "Inset sparkline panels, forwarded verbatim to LearningCanvas.",
+          "description": "Inset sparkline panels (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -102798,7 +102841,7 @@
           "types": [
             "string"
           ],
-          "description": "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host.",
+          "description": "Painter: 2D raster (default) or 3D mesh scene, both drawn by orbital-canvas.",
           "enumValues": [
             "2d",
             "3d"
@@ -103231,6 +103274,49 @@
           },
           "default": []
         },
+        "particles": {
+          "types": [
+            "object"
+          ],
+          "description": "2D mode: packed particles drawn in one pass under the bodies (a GPU readback), instead of a body per particle.",
+          "properties": {
+            "data": {
+              "types": [
+                "string"
+              ]
+            },
+            "buffer": {
+              "types": [
+                "GpuBuffer"
+              ]
+            },
+            "stride": {
+              "types": [
+                "number"
+              ]
+            },
+            "radius": {
+              "types": [
+                "number"
+              ]
+            },
+            "palette": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "string"
+                ]
+              }
+            }
+          },
+          "propertyRequired": [
+            "stride",
+            "radius",
+            "palette"
+          ]
+        },
         "constraints": {
           "types": [
             "array"
@@ -104190,7 +104276,7 @@
           "types": [
             "array"
           ],
-          "description": "Top-right status chip row, forwarded to LearningCanvas verbatim.",
+          "description": "Top-right status chip row (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -104223,7 +104309,7 @@
           "types": [
             "array"
           ],
-          "description": "Inset sparkline panels, forwarded to LearningCanvas verbatim.",
+          "description": "Inset sparkline panels (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -115119,7 +115205,7 @@
           "types": [
             "array"
           ],
-          "description": "Consumer-declared effect vocabulary — one row per fx `type` (look + recipe). Unknown types fall back to a neutral spark burst.",
+          "description": "Consumer-declared effect vocabulary — one row per fx `type` (look, recipe and motion). An item whose `type` has no row draws only from its own fields, and a missing required field is a typed error.",
           "items": {
             "types": [
               "object"
@@ -115220,7 +115306,11 @@
               }
             },
             "required": [
-              "type"
+              "type",
+              "gravity",
+              "vx",
+              "vy",
+              "vz"
             ]
           }
         },

package/dist/patterns/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-11-06T03:25:33.553Z",
+  "exportedAt": "2026-11-07T03:57:49.631Z",
   "patterns": {
     "detail-panel": {
       "type": "detail-panel",
@@ -97003,6 +97003,49 @@
           },
           "default": []
         },
+        "particles": {
+          "types": [
+            "object"
+          ],
+          "description": "Packed particles drawn under the shapes in one pass ({@link LearningParticles}).",
+          "properties": {
+            "data": {
+              "types": [
+                "string"
+              ]
+            },
+            "buffer": {
+              "types": [
+                "GpuBuffer"
+              ]
+            },
+            "stride": {
+              "types": [
+                "number"
+              ]
+            },
+            "radius": {
+              "types": [
+                "number"
+              ]
+            },
+            "palette": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "string"
+                ]
+              }
+            }
+          },
+          "propertyRequired": [
+            "stride",
+            "radius",
+            "palette"
+          ]
+        },
         "drawables": {
           "types": [
             "array"
@@ -97735,7 +97778,7 @@
           "types": [
             "string"
           ],
-          "description": "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host.",
+          "description": "Painter: 2D raster (default) or 3D mesh scene, both drawn by orbital-canvas.",
           "enumValues": [
             "2d",
             "3d"
@@ -98906,7 +98949,7 @@
           "types": [
             "array"
           ],
-          "description": "Top-right status chip row, forwarded to LearningCanvas verbatim.",
+          "description": "Top-right status chip row (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -98939,7 +98982,7 @@
           "types": [
             "array"
           ],
-          "description": "Inset sparkline panels, forwarded to LearningCanvas verbatim.",
+          "description": "Inset sparkline panels (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -99519,7 +99562,7 @@
           "types": [
             "string"
           ],
-          "description": "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host.",
+          "description": "Painter: 2D raster (default) or 3D mesh scene, both drawn by orbital-canvas.",
           "enumValues": [
             "2d",
             "3d"
@@ -100675,7 +100718,7 @@
           "types": [
             "array"
           ],
-          "description": "Top-right status chip row, forwarded to LearningCanvas verbatim.",
+          "description": "Top-right status chip row (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -100708,7 +100751,7 @@
           "types": [
             "array"
           ],
-          "description": "Inset sparkline panels, forwarded to LearningCanvas verbatim.",
+          "description": "Inset sparkline panels (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -102169,7 +102212,7 @@
           "types": [
             "array"
           ],
-          "description": "Top-right status chips, forwarded verbatim to LearningCanvas.",
+          "description": "Top-right status chips (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -102202,7 +102245,7 @@
           "types": [
             "array"
           ],
-          "description": "Inset sparkline panels, forwarded verbatim to LearningCanvas.",
+          "description": "Inset sparkline panels (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -102798,7 +102841,7 @@
           "types": [
             "string"
           ],
-          "description": "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host.",
+          "description": "Painter: 2D raster (default) or 3D mesh scene, both drawn by orbital-canvas.",
           "enumValues": [
             "2d",
             "3d"
@@ -103231,6 +103274,49 @@
           },
           "default": []
         },
+        "particles": {
+          "types": [
+            "object"
+          ],
+          "description": "2D mode: packed particles drawn in one pass under the bodies (a GPU readback), instead of a body per particle.",
+          "properties": {
+            "data": {
+              "types": [
+                "string"
+              ]
+            },
+            "buffer": {
+              "types": [
+                "GpuBuffer"
+              ]
+            },
+            "stride": {
+              "types": [
+                "number"
+              ]
+            },
+            "radius": {
+              "types": [
+                "number"
+              ]
+            },
+            "palette": {
+              "types": [
+                "array"
+              ],
+              "items": {
+                "types": [
+                  "string"
+                ]
+              }
+            }
+          },
+          "propertyRequired": [
+            "stride",
+            "radius",
+            "palette"
+          ]
+        },
         "constraints": {
           "types": [
             "array"
@@ -104190,7 +104276,7 @@
           "types": [
             "array"
           ],
-          "description": "Top-right status chip row, forwarded to LearningCanvas verbatim.",
+          "description": "Top-right status chip row (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -104223,7 +104309,7 @@
           "types": [
             "array"
           ],
-          "description": "Inset sparkline panels, forwarded to LearningCanvas verbatim.",
+          "description": "Inset sparkline panels (the LearningCanvas vocabulary).",
           "items": {
             "types": [
               "object"
@@ -115119,7 +115205,7 @@
           "types": [
             "array"
           ],
-          "description": "Consumer-declared effect vocabulary — one row per fx `type` (look + recipe). Unknown types fall back to a neutral spark burst.",
+          "description": "Consumer-declared effect vocabulary — one row per fx `type` (look, recipe and motion). An item whose `type` has no row draws only from its own fields, and a missing required field is a typed error.",
           "items": {
             "types": [
               "object"
@@ -115220,7 +115306,11 @@
               }
             },
             "required": [
-              "type"
+              "type",
+              "gravity",
+              "vx",
+              "vy",
+              "vz"
             ]
           }
         },