@almadar/core 11.1.0 → 11.3.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-Cv3HTGFL.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-C2VKm6kk.js';
 
 /**
  * Awaiting-server skeletons — the platform-neutral contract.
@@ -24,10 +24,10 @@ type SkeletonVariant = (typeof SKELETON_VARIANTS)[number];
 declare const SkeletonVariantSchema: z.ZodEnum<{
     header: "header";
     form: "form";
-    list: "list";
-    detail: "detail";
     card: "card";
     grid: "grid";
+    list: "list";
+    detail: "detail";
     table: "table";
     stats: "stats";
     text: "text";
@@ -43,10 +43,10 @@ declare const SkeletonShapeSchema: z.ZodObject<{
     variant: z.ZodEnum<{
         header: "header";
         form: "form";
-        list: "list";
-        detail: "detail";
         card: "card";
         grid: "grid";
+        list: "list";
+        detail: "detail";
         table: "table";
         stats: "stats";
         text: "text";
@@ -63,10 +63,10 @@ type SkeletonSpec = SkeletonVariant | "none" | SkeletonShape;
 declare const SkeletonSpecSchema: z.ZodUnion<readonly [z.ZodEnum<{
     header: "header";
     form: "form";
-    list: "list";
-    detail: "detail";
     card: "card";
     grid: "grid";
+    list: "list";
+    detail: "detail";
     table: "table";
     stats: "stats";
     text: "text";
@@ -74,10 +74,10 @@ declare const SkeletonSpecSchema: z.ZodUnion<readonly [z.ZodEnum<{
     variant: z.ZodEnum<{
         header: "header";
         form: "form";
-        list: "list";
-        detail: "detail";
         card: "card";
         grid: "grid";
+        list: "list";
+        detail: "detail";
         table: "table";
         stats: "stats";
         text: "text";
@@ -1256,8 +1256,8 @@ declare const TraitReferenceSchema: z.ZodObject<{
         entityBindingSynonyms: z.ZodOptional<z.ZodString>;
         dispatch: z.ZodOptional<z.ZodEnum<{
             client: "client";
-            server: "server";
             optimistic: "optimistic";
+            server: "server";
         }>>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         linkedEntityId: z.ZodOptional<z.ZodString & z.ZodType<EntityId, string, z.core.$ZodTypeInternals<EntityId, string>>>;
@@ -1708,8 +1708,8 @@ declare const DispatchModeSchema: z.ZodEnum<{
 type TraitDispatchMode = 'client' | 'optimistic' | 'server';
 declare const TraitDispatchModeSchema: z.ZodEnum<{
     client: "client";
-    server: "server";
     optimistic: "optimistic";
+    server: "server";
 }>;
 type Trait = {
     /** V4 dual-carry id sibling of `name` — optional until the Phase-7 flip. */
@@ -1891,8 +1891,8 @@ declare const TraitSchema: z.ZodObject<{
     entityBindingSynonyms: z.ZodOptional<z.ZodString>;
     dispatch: z.ZodOptional<z.ZodEnum<{
         client: "client";
-        server: "server";
         optimistic: "optimistic";
+        server: "server";
     }>>;
     linkedEntity: z.ZodOptional<z.ZodString>;
     linkedEntityId: z.ZodOptional<z.ZodString & z.ZodType<EntityId, string, z.core.$ZodTypeInternals<EntityId, string>>>;
@@ -2197,8 +2197,8 @@ declare const TraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         entityBindingSynonyms: z.ZodOptional<z.ZodString>;
         dispatch: z.ZodOptional<z.ZodEnum<{
             client: "client";
-            server: "server";
             optimistic: "optimistic";
+            server: "server";
         }>>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         linkedEntityId: z.ZodOptional<z.ZodString & z.ZodType<EntityId, string, z.core.$ZodTypeInternals<EntityId, string>>>;
@@ -2531,8 +2531,8 @@ declare const TraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
     entityBindingSynonyms: z.ZodOptional<z.ZodString>;
     dispatch: z.ZodOptional<z.ZodEnum<{
         client: "client";
-        server: "server";
         optimistic: "optimistic";
+        server: "server";
     }>>;
     linkedEntity: z.ZodOptional<z.ZodString>;
     linkedEntityId: z.ZodOptional<z.ZodString & z.ZodType<EntityId, string, z.core.$ZodTypeInternals<EntityId, string>>>;
@@ -2907,8 +2907,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObje
         entityBindingSynonyms: z.ZodOptional<z.ZodString>;
         dispatch: z.ZodOptional<z.ZodEnum<{
             client: "client";
-            server: "server";
             optimistic: "optimistic";
+            server: "server";
         }>>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         linkedEntityId: z.ZodOptional<z.ZodString & z.ZodType<EntityId, string, z.core.$ZodTypeInternals<EntityId, string>>>;
@@ -3241,8 +3241,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObje
     entityBindingSynonyms: z.ZodOptional<z.ZodString>;
     dispatch: z.ZodOptional<z.ZodEnum<{
         client: "client";
-        server: "server";
         optimistic: "optimistic";
+        server: "server";
     }>>;
     linkedEntity: z.ZodOptional<z.ZodString>;
     linkedEntityId: z.ZodOptional<z.ZodString & z.ZodType<EntityId, string, z.core.$ZodTypeInternals<EntityId, string>>>;