@almadar/core 11.1.0 → 11.2.0

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"
             ]
           }
         },

package/dist/{trait-SNHnODBK.d.ts → trait-D9MjuwGC.d.ts}

@@ -1,6 +1,6 @@
 import { S as SExpr, b as Expression, J as JsonValue } from './expression-DirYKz-f.js';
 import { z } from 'zod';
-import { b as EventId, F as FieldProjection, d as Effect, e as TypedEffect, T as TraitId, O as OrbitalId, E as EntityField, f as TypeVariable, g as EntityId, P as PageId, A as AnyPatternConfig, h as Entity } from './effect-BLpc68hI.js';
+import { b as EventId, F as FieldProjection, d as Effect, e as TypedEffect, T as TraitId, O as OrbitalId, E as EntityField, f as TypeVariable, g as EntityId, P as PageId, A as AnyPatternConfig, h as Entity } from './effect-Dr--GXRe.js';
 
 /**
  * Awaiting-server skeletons — the platform-neutral contract.
@@ -1097,7 +1097,6 @@ declare const RequiredFieldSchema: z.ZodObject<{
         event: "event";
         node: "node";
         url: "url";
-        field: "field";
         timestamp: "timestamp";
         datetime: "datetime";
         instant: "instant";
@@ -1110,6 +1109,7 @@ declare const RequiredFieldSchema: z.ZodObject<{
         EventAddress: "EventAddress";
         CallKey: "CallKey";
         SExpr: "SExpr";
+        field: "field";
     }>, z.ZodCustom<`$${string}`, `$${string}`>]>;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -1280,7 +1280,6 @@ declare const TraitReferenceSchema: z.ZodObject<{
                 event: "event";
                 node: "node";
                 url: "url";
-                field: "field";
                 timestamp: "timestamp";
                 datetime: "datetime";
                 instant: "instant";
@@ -1293,6 +1292,7 @@ declare const TraitReferenceSchema: z.ZodObject<{
                 EventAddress: "EventAddress";
                 CallKey: "CallKey";
                 SExpr: "SExpr";
+                field: "field";
             }>, z.ZodCustom<`$${string}`, `$${string}`>]>;
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
@@ -1915,7 +1915,6 @@ declare const TraitSchema: z.ZodObject<{
             event: "event";
             node: "node";
             url: "url";
-            field: "field";
             timestamp: "timestamp";
             datetime: "datetime";
             instant: "instant";
@@ -1928,6 +1927,7 @@ declare const TraitSchema: z.ZodObject<{
             EventAddress: "EventAddress";
             CallKey: "CallKey";
             SExpr: "SExpr";
+            field: "field";
         }>, z.ZodCustom<`$${string}`, `$${string}`>]>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
@@ -2221,7 +2221,6 @@ declare const TraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
                 event: "event";
                 node: "node";
                 url: "url";
-                field: "field";
                 timestamp: "timestamp";
                 datetime: "datetime";
                 instant: "instant";
@@ -2234,6 +2233,7 @@ declare const TraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
                 EventAddress: "EventAddress";
                 CallKey: "CallKey";
                 SExpr: "SExpr";
+                field: "field";
             }>, z.ZodCustom<`$${string}`, `$${string}`>]>;
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
@@ -2555,7 +2555,6 @@ declare const TraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
             event: "event";
             node: "node";
             url: "url";
-            field: "field";
             timestamp: "timestamp";
             datetime: "datetime";
             instant: "instant";
@@ -2568,6 +2567,7 @@ declare const TraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
             EventAddress: "EventAddress";
             CallKey: "CallKey";
             SExpr: "SExpr";
+            field: "field";
         }>, z.ZodCustom<`$${string}`, `$${string}`>]>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
@@ -2931,7 +2931,6 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObje
                 event: "event";
                 node: "node";
                 url: "url";
-                field: "field";
                 timestamp: "timestamp";
                 datetime: "datetime";
                 instant: "instant";
@@ -2944,6 +2943,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObje
                 EventAddress: "EventAddress";
                 CallKey: "CallKey";
                 SExpr: "SExpr";
+                field: "field";
             }>, z.ZodCustom<`$${string}`, `$${string}`>]>;
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
@@ -3265,7 +3265,6 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObje
             event: "event";
             node: "node";
             url: "url";
-            field: "field";
             timestamp: "timestamp";
             datetime: "datetime";
             instant: "instant";
@@ -3278,6 +3277,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObje
             EventAddress: "EventAddress";
             CallKey: "CallKey";
             SExpr: "SExpr";
+            field: "field";
         }>, z.ZodCustom<`$${string}`, `$${string}`>]>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;