@almadar/core 10.55.0 → 10.57.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-DxD-XTI8.js';
-import { a as OrbitalDefinition, O as OrbitalSchema, U as UseDeclaration, E as EntityRef, P as PageRef, b as Page, c as PageRefObject } from './schema-0C1bXRFm.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-WnYkvPdZ.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-D-_fm4No.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-CrUFqWXN.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-A4_OlY_l.js';
 import { S as SExpr } from './expression-Fk8bQWef.js';
 import 'zod';
 
@@ -480,6 +480,18 @@ interface MakeOrbitalWithUsesOpts {
     uses: UseDeclaration[];
     /** Entity (inline or reference form). */
     entity: EntityRef;
+    /**
+     * Derived `expects` declarations (consumer-side requirements). Threaded
+     * verbatim — derivation lives in `deriveExpectations`; builders never
+     * compute it. Omitted from the result when not provided.
+     */
+    expects?: ExpectDeclaration[];
+    /**
+     * Auxiliary entities (name-resolution side channel for un-rebound atom
+     * imports — see {@link OrbitalDefinition.auxiliaryEntities}). Threaded
+     * verbatim; omitted from the result when not provided.
+     */
+    auxiliaryEntities?: EntityRef[];
     /** Trait references. */
     traits: TraitRef[];
     /** Optional page references (omitted entirely when not provided). */

package/dist/builders.js

@@ -138,6 +138,7 @@ var EntityFieldSchema = z.lazy(() => {
   const baseFieldShape = {
     name: z.string().min(1, "Field name is required").optional(),
     required: z.boolean().optional(),
+    primaryKey: z.boolean().optional(),
     default: JsonValueSchema.optional(),
     min: z.number().optional(),
     max: z.number().optional(),
@@ -542,7 +543,10 @@ var TraitEntityFieldSchema = z.object({
     "url",
     "phone",
     "uuid",
-    "image"
+    "image",
+    "trait",
+    "slot",
+    "pattern"
   ]),
   required: z.boolean().optional(),
   default: TraitConfigValueSchema.optional(),
@@ -652,7 +656,7 @@ var TraitEventListenerSchema = z.object({
 });
 var RequiredFieldSchema = z.object({
   name: z.string().min(1),
-  type: z.enum(["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum", "email", "url", "phone", "uuid", "image"]),
+  type: z.enum(["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum", "email", "url", "phone", "uuid", "image", "trait", "slot", "pattern"]),
   description: z.string().optional()
 });
 var TraitReferenceSchema = z.object({
@@ -1274,6 +1278,23 @@ var UseDeclarationSchema = z.object({
     'Alias must be PascalCase (e.g., "Health", "GameCore")'
   )
 });
+var ExpectDeclarationSchema = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("identity"),
+    name: z.string().optional(),
+    shape: z.array(EntityFieldSchema).optional()
+  }),
+  z.object({
+    kind: z.literal("entity"),
+    name: z.string().min(1, "Expected entity name is required"),
+    shape: z.array(EntityFieldSchema).optional()
+  }),
+  z.object({
+    kind: z.literal("event"),
+    traitName: z.string().min(1, "Expected event trait name is required"),
+    event: z.string().min(1, "Expected event name is required")
+  })
+]);
 function isEntityReference(entity) {
   return typeof entity === "string";
 }
@@ -1374,6 +1395,8 @@ z.object({
   visual_prompt: z.string().optional(),
   // Import system
   uses: z.array(UseDeclarationSchema).optional(),
+  // Consumer-side requirement declarations (`.lolo` `expects ...`)
+  expects: z.array(ExpectDeclarationSchema).optional(),
   // Theme & Services
   theme: ThemeRefSchema.optional(),
   services: z.array(ServiceRefSchema).optional(),
@@ -1821,7 +1844,9 @@ function makeOrbitalWithUses(opts) {
   const orbital = {
     name: opts.name,
     uses: opts.uses,
+    ...opts.expects !== void 0 ? { expects: opts.expects } : {},
     entity: opts.entity,
+    ...opts.auxiliaryEntities !== void 0 ? { auxiliaryEntities: opts.auxiliaryEntities } : {},
     traits: opts.traits,
     pages: opts.pages ?? []
   };