@almadar/core 10.54.0 → 10.56.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-BlFO53UR.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-BPC1Wuxb.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-RzDL-lSo.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-DxD-XTI8.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-Nk1usPv6.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 { S as SExpr } from './expression-Fk8bQWef.js';
 import 'zod';
 
@@ -480,6 +480,12 @@ 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[];
     /** Trait references. */
     traits: TraitRef[];
     /** Optional page references (omitted entirely when not provided). */

package/dist/builders.js

@@ -791,7 +791,9 @@ z.object({
   path: z.string().min(1, "Page path is required").startsWith("/", "Path must start with /"),
   primaryEntity: z.string().min(1, "Primary entity is required"),
   traits: z.array(PageTraitRefSchema).min(1, "Page must have at least one trait"),
-  title: z.string().optional()
+  title: z.string().optional(),
+  icon: z.string().optional(),
+  label: z.string().optional()
 }).strict();
 var OrbitalPageSchema = z.object({
   id: PageIdSchema.optional(),
@@ -801,7 +803,9 @@ var OrbitalPageSchema = z.object({
   title: z.string().optional(),
   primaryEntity: z.string().optional(),
   traits: z.array(PageTraitRefSchema).optional(),
-  isInitial: z.boolean().optional()
+  isInitial: z.boolean().optional(),
+  icon: z.string().optional(),
+  label: z.string().optional()
 }).strict();
 var PageSchema = OrbitalPageSchema;
 z.enum([
@@ -1270,6 +1274,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";
 }
@@ -1370,6 +1391,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(),
@@ -1817,6 +1840,7 @@ function makeOrbitalWithUses(opts) {
   const orbital = {
     name: opts.name,
     uses: opts.uses,
+    ...opts.expects !== void 0 ? { expects: opts.expects } : {},
     entity: opts.entity,
     traits: opts.traits,
     pages: opts.pages ?? []