@almadar/core 10.77.0 → 10.79.0

package/dist/builders.d.ts

@@ -1,6 +1,6 @@
-import { I as IdentityLedger, A as AnyPatternConfig, U as UISlot, c as Effect, h as RenderBinding, i as RenderUIEffect, d as EntityId, e as Entity, E as EntityField, a as EntityPersistence, f as EntityRow } from './effect-BHaHSAvM.js';
-import { a as OrbitalDefinition, O as OrbitalSchema, U as UseDeclaration, E as EntityRef, b as ExpectDeclaration, P as PageRef, c as Page, d as PageRefObject } from './schema-Czlrw3bA.js';
-import { b as TraitConfig, g as Trait, T as TraitEventListener, h as CallSiteConfig, j as TraitEventContract, d as TraitRef, a as TraitReference } from './trait-DCmf5iRN.js';
+import { I as IdentityLedger, A as AnyPatternConfig, U as UISlot, c as Effect, h as RenderBinding, i as RenderUIEffect, d as EntityId, e as Entity, E as EntityField, a as EntityPersistence, f as EntityRow } from './effect-Mx_niZdY.js';
+import { a as OrbitalDefinition, O as OrbitalSchema, U as UseDeclaration, E as EntityRef, b as ExpectDeclaration, P as PageRef, c as Page, d as PageRefObject } from './schema-CkTuSx6F.js';
+import { b as TraitConfig, h as Trait, T as TraitEventListener, i as CallSiteConfig, k as TraitEventContract, d as TraitRef, a as TraitReference } from './trait-B1fI0lTU.js';
 import { S as SExpr } from './expression-Fk8bQWef.js';
 import 'zod';
 
@@ -356,6 +356,11 @@ interface MakeTraitRefOpts {
     linkedEntityId?: EntityId;
     /** Per-key rename map, e.g. `{ OPEN: "ADD_ITEM" }`. */
     events?: Record<string, string>;
+    /**
+     * 3-II trait type-parameter arguments (`:: p SomeType`): declared-param
+     * name → type-vocabulary name. Mirrors {@link TraitReference.typeArgs}.
+     */
+    typeArgs?: Record<string, string>;
     /**
      * Entity-field remap, e.g. `{ name: "title", folder: "parentId" }`. Rewrites
      * the inlined trait's canonical `@entity.X` / `@payload.row.X` references to

package/dist/builders.js

@@ -102,7 +102,9 @@ var FIELD_TYPES = [
   "slot",
   "pattern",
   "node",
-  "event"
+  "event",
+  "scalar",
+  "union"
 ];
 z.enum(FIELD_TYPES);
 var RelationCardinalitySchema = z.enum([
@@ -198,12 +200,20 @@ var EntityFieldSchema = z.lazy(() => {
       scalarVariant("event"),
       scalarVariant("money"),
       scalarVariant("file"),
+      scalarVariant("scalar"),
       // Enum variant — REQUIRES non-empty values.
       z.object({
         ...baseFieldShape,
         type: z.literal("enum"),
         values: z.array(z.string()).min(1, "Enum field requires a non-empty `values` array")
       }),
+      // Union variant — tagged struct union; values = variant names,
+      // per-variant shapes in `properties` (absent on named recursion).
+      z.object({
+        ...baseFieldShape,
+        type: z.literal("union"),
+        values: z.array(z.string()).min(1, "Union field requires a non-empty `values` array")
+      }),
       // Relation variant — REQUIRES relation config.
       z.object({
         ...baseFieldShape,
@@ -246,8 +256,8 @@ var ASSET_DIMENSIONS = ["2d", "3d"];
 var AssetDimensionSchema = z.enum(ASSET_DIMENSIONS);
 var ASSET_ASPECTS = ["1:1", "16:9", "5:7", "8:1"];
 var AssetAspectSchema = z.enum(ASSET_ASPECTS);
-var ANIMATION_NAMES = ["idle", "walk", "attack", "hit", "death"];
-var AnimationNameSchema = z.enum(ANIMATION_NAMES);
+var ANIMATION_NAMES = ["idle", "walk", "skate", "jump", "fall", "attack", "hit", "death"];
+z.enum(ANIMATION_NAMES);
 var SPRITE_DIRECTIONS = ["se", "sw", "ne", "nw"];
 var SpriteDirectionSchema = z.enum(SPRITE_DIRECTIONS);
 var SHEET_PROJECTIONS = ["iso", "front", "back", "top", "perspective"];
@@ -267,7 +277,7 @@ z.object({
   rows: z.number().int().positive(),
   directions: z.array(SpriteDirectionSchema),
   sheets: z.record(SpriteDirectionSchema, z.string()),
-  animations: z.record(AnimationNameSchema, AnimationDefSchema),
+  animations: z.record(z.string(), AnimationDefSchema),
   projections: z.object({
     iso: z.record(SpriteDirectionSchema, z.string()).optional(),
     front: z.string().optional(),
@@ -642,6 +652,8 @@ var TraitEventContractSchema = z.object({
   description: z.string().optional(),
   synonyms: z.string().optional(),
   tier: z.string().optional(),
+  definerKnob: z.string().optional(),
+  scopeOverridden: z.boolean().optional(),
   payloadSchema: z.array(EventPayloadFieldSchema).optional(),
   scope: EventScopeSchema.optional()
 });
@@ -695,6 +707,11 @@ var TraitReferenceSchema = z.object({
     z.string().min(1, "events value (caller event name) must be non-empty")
   ).optional(),
   eventIds: z.record(z.string().min(1), EventIdSchema).optional(),
+  // 3-II type-parameter arguments (see `TraitReference.typeArgs`).
+  typeArgs: z.record(
+    z.string().min(1, "typeArgs key (declared param name) must be non-empty"),
+    z.string().min(1, "typeArgs value (type name) must be non-empty")
+  ).optional(),
   fields: z.record(
     z.string().min(1, "fields key (canonical field name) must be non-empty"),
     z.string().min(1, "fields value (consumer field name) must be non-empty")
@@ -755,6 +772,11 @@ var SourceBehaviorMetadataSchema = z.object({
   alias: z.string().min(1),
   originalName: z.string().min(1)
 });
+var TraitTypeParamDefSchema = z.object({
+  name: z.string().min(1),
+  kind: z.string().min(1),
+  default: z.string().optional()
+});
 var TraitSchema = z.object({
   id: TraitIdSchema.optional(),
   name: z.string().min(1),
@@ -781,7 +803,8 @@ var TraitSchema = z.object({
   ui: TraitUIBindingSchema.optional(),
   config: DeclaredTraitConfigSchema.optional(),
   sourceBehavior: SourceBehaviorMetadataSchema.optional(),
-  sourceEntityDefinition: EntitySchema.optional()
+  sourceEntityDefinition: EntitySchema.optional(),
+  typeParams: z.array(TraitTypeParamDefSchema).optional()
 });
 var TraitRefSchema = z.union([
   z.string().min(1),
@@ -1436,7 +1459,8 @@ z.object({
   // Context fields - persisted throughout orbital lifecycle
   domainContext: DomainContextSchema.optional(),
   design: DesignPreferencesSchema.optional(),
-  suggestedGuards: z.array(SuggestedGuardSchema).optional()
+  suggestedGuards: z.array(SuggestedGuardSchema).optional(),
+  types: z.record(z.string(), z.array(EventPayloadFieldSchema)).optional()
 });
 
 // src/builders/apply-config-overrides.ts
@@ -1849,6 +1873,7 @@ function makeTraitRef(opts) {
   if (opts.linkedEntity !== void 0) ref.linkedEntity = opts.linkedEntity;
   if (opts.linkedEntityId !== void 0) ref.linkedEntityId = opts.linkedEntityId;
   if (opts.events !== void 0) ref.events = opts.events;
+  if (opts.typeArgs !== void 0) ref.typeArgs = opts.typeArgs;
   if (opts.fields !== void 0) ref.fields = opts.fields;
   if (opts.effects !== void 0) ref.effects = opts.effects;
   if (opts.listens !== void 0) ref.listens = opts.listens;