@almadar/core 10.55.0 → 10.56.0

package/dist/{entityAccess-JTWGFDja.d.ts → entityAccess-Bnz5CJ3S.d.ts}

@@ -1,4 +1,4 @@
-import { O as OrbitalSchema } from './schema-0C1bXRFm.js';
+import { O as OrbitalSchema } from './schema-Nk1usPv6.js';
 import { S as SExpr } from './expression-Fk8bQWef.js';
 
 /**

package/dist/factory-runtime/index.d.ts

@@ -1,4 +1,4 @@
-import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-0C1bXRFm.js';
+import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-Nk1usPv6.js';
 import { h as CallSiteConfig, i as CallSiteConfigEntry, g as Trait } from '../trait-WnYkvPdZ.js';
 import { E as EntityField, a as EntityPersistence } from '../effect-DxD-XTI8.js';
 import { MakeTraitRefOpts } from '../builders.js';
@@ -210,6 +210,24 @@ declare function applyDeclarationEntityRename(schema: OrbitalSchema, rename: Ent
  * declaration disagrees with `curName` → `ORB_ID_NAME_MISMATCH`.
  */
 at: string): OrbitalSchema;
+/**
+ * Ledger/declaration agreement heal for the factory build path: every entity
+ * declaration carrying an id must find its ledger row naming the SAME name
+ * the declaration carries. A re-instantiate adopts the prior `.orb`'s ledger
+ * via `orb stamp --prior` — including rename rows an earlier build recorded —
+ * while the factory re-emits the entity at its baked/requested name, so a
+ * stale `curName` would survive a corrective rebuild unchanged and
+ * manufacture an `ORB_ID_NAME_MISMATCH` no repair pass can edit away
+ * (battery 2026-08-06 domain-rule: param-fill renamed MarketplaceUserOrbital's
+ * entity to `Product`; the corrective re-instantiate at `entityName:
+ * "MarketplaceUser"` applies NO rename — from === to — and the adopted row
+ * kept `curName: "Product"` against a `MarketplaceUser` declaration).
+ *
+ * Sound on this path only: the factory always re-emits the declaration at the
+ * requested/baked name, so the declaration is the build's truth and the
+ * adopted row carries identity (the id) forward. No-op when they agree.
+ */
+declare function healEntityLedgerRows(schema: OrbitalSchema, at: string): OrbitalSchema;
 /**
  * The overlay. Resolves the effective entity name + collection, calls
  * `makeOrbitalWithUses` with the rewritten data, then applies the params'
@@ -233,4 +251,4 @@ declare function applyParamsToOrb(orb: OrbitalSchema, orbitalName: string, _mani
 
 declare function applyParamsToWholeOrb(orb: OrbitalSchema, manifests: readonly OrbitalParamsManifest[], params: OrbitalFactoryParams): OrbitalSchema;
 
-export { type EntityDeclarationRename, type OrbitalFactoryParams, type OrbitalParamsManifest, type OrbitalTraitOverride, type ParamFieldDescriptor, type ParamValidationError, type ParamValidationResult, applyDeclarationEntityRename, applyDeclarationTraitRenames, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };
+export { type EntityDeclarationRename, type OrbitalFactoryParams, type OrbitalParamsManifest, type OrbitalTraitOverride, type ParamFieldDescriptor, type ParamValidationError, type ParamValidationResult, applyDeclarationEntityRename, applyDeclarationTraitRenames, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, healEntityLedgerRows, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };

package/dist/factory-runtime/index.js

@@ -1284,6 +1284,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")
+  })
+]);
 var EntityRefStringSchema = z.string().regex(
   /^[A-Z][a-zA-Z0-9]*\.entity$/,
   'Entity reference must be in format "Alias.entity" (e.g., "Goblin.entity")'
@@ -1373,6 +1390,8 @@ var OrbitalDefinitionSchema = 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(),
@@ -1571,6 +1590,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 ?? []
@@ -1921,6 +1941,21 @@ function applyDeclarationEntityRename(schema, rename, at) {
   }
   return { ...schema, orbitals, ...ledger !== schema.ledger ? { ledger } : {} };
 }
+function healEntityLedgerRows(schema, at) {
+  let ledger = schema.ledger;
+  if (ledger === void 0) return schema;
+  for (const orbital of schema.orbitals) {
+    const entity = orbital.entity;
+    if (typeof entity !== "object" || entity === null) continue;
+    const id = entity.id;
+    const name = entity.name;
+    if (typeof id !== "string" || typeof name !== "string") continue;
+    const entry = ledger.entries[id];
+    if (entry === void 0 || entry.kind !== "entity" || entry.curName === name) continue;
+    ledger = ledgerRename(ledger, id, name, at);
+  }
+  return ledger !== schema.ledger ? { ...schema, ledger } : schema;
+}
 function applyParamsToOrb(orb, orbitalName, _manifest, params) {
   const orbital = findOrbitalOrThrow(orb, orbitalName);
   const canonicalEntity = assertResolvedEntity(orbital.entity, orbitalName, orb.name);
@@ -1930,6 +1965,10 @@ function applyParamsToOrb(orb, orbitalName, _manifest, params) {
   const built = makeOrbitalWithUses({
     name: orbital.name,
     uses: orbital.uses ?? [],
+    // Derived `expects` declarations ride the overlay untouched — they name
+    // SIBLING entities (never the orbital's own), so the entityName rename
+    // below cannot affect them.
+    ...orbital.expects !== void 0 ? { expects: orbital.expects } : {},
     entity: buildEntity(ctx, canonicalEntityName, effectiveCollection, params),
     traits: rebuildTraits(orbital.traits),
     pages: rebuildPages(orbital.pages)
@@ -1991,6 +2030,6 @@ function applyParamsToWholeOrb(orb, manifests, params) {
   return { ...orb, orbitals: rebuilt };
 }
 
-export { applyDeclarationEntityRename, applyDeclarationTraitRenames, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };
+export { applyDeclarationEntityRename, applyDeclarationTraitRenames, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, healEntityLedgerRows, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map