@almadar/core 10.28.0 → 10.30.0

package/dist/index.js

@@ -1,6 +1,151 @@
 import { z } from 'zod';
 
 // src/types/orbital.ts
+var ID_PREFIXES = {
+  orbital: "orb_",
+  entity: "ent_",
+  trait: "trt_",
+  event: "evt_",
+  page: "pag_",
+  service: "svc_",
+  theme: "thm_",
+  palette: "pal_"
+};
+function brand(value) {
+  return value;
+}
+function makeIdKind(kind) {
+  const prefix = ID_PREFIXES[kind];
+  const is = (value) => value.startsWith(prefix) && value.length > prefix.length;
+  const as = (value) => {
+    if (!is(value)) {
+      throw new Error(
+        `Expected ${kind} id (prefix "${prefix}"), got: ${JSON.stringify(value)}`
+      );
+    }
+    return brand(value);
+  };
+  return { prefix, is, as };
+}
+var orbitalKind = makeIdKind("orbital");
+var entityKind = makeIdKind("entity");
+var traitKind = makeIdKind("trait");
+var eventKind = makeIdKind("event");
+var pageKind = makeIdKind("page");
+var serviceKind = makeIdKind("service");
+var themeKind = makeIdKind("theme");
+var paletteKind = makeIdKind("palette");
+var isOrbitalId = orbitalKind.is;
+var asOrbitalId = orbitalKind.as;
+var isEntityId = entityKind.is;
+var asEntityId = entityKind.as;
+var isTraitId = traitKind.is;
+var asTraitId = traitKind.as;
+var isEventId = eventKind.is;
+var asEventId = eventKind.as;
+var isPageId = pageKind.is;
+var asPageId = pageKind.as;
+var isServiceId = serviceKind.is;
+var asServiceId = serviceKind.as;
+var isThemeId = themeKind.is;
+var asThemeId = themeKind.as;
+var isPaletteEntryId = paletteKind.is;
+var asPaletteEntryId = paletteKind.as;
+function idPrefix(kind) {
+  return ID_PREFIXES[kind];
+}
+function idKindOf(id) {
+  for (const kind of Object.keys(ID_PREFIXES)) {
+    const prefix = ID_PREFIXES[kind];
+    if (id.startsWith(prefix) && id.length > prefix.length) return kind;
+  }
+  return null;
+}
+var CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+var TIME_LEN = 10;
+var RANDOM_LEN = 16;
+function randomBytes(len) {
+  const g = globalThis;
+  if (g.crypto?.getRandomValues) {
+    return g.crypto.getRandomValues(new Uint8Array(len));
+  }
+  throw new Error("mintId: no crypto.getRandomValues available in this runtime");
+}
+function encodeTime(now) {
+  let value = now;
+  let out = "";
+  for (let i = 0; i < TIME_LEN; i++) {
+    const mod = value % 32;
+    out = CROCKFORD[mod] + out;
+    value = (value - mod) / 32;
+  }
+  return out;
+}
+function encodeRandom() {
+  const bytes = randomBytes(RANDOM_LEN);
+  let out = "";
+  for (let i = 0; i < RANDOM_LEN; i++) {
+    out += CROCKFORD[bytes[i] & 31];
+  }
+  return out;
+}
+function ulid() {
+  return encodeTime(Date.now()) + encodeRandom();
+}
+function mintId(kind) {
+  return brand(ID_PREFIXES[kind] + ulid());
+}
+function ledgerResolveName(ledger, kind, name) {
+  for (const [id, entry] of Object.entries(ledger.entries)) {
+    if (entry.kind === kind && entry.curName === name) return id;
+  }
+  return null;
+}
+function ledgerRename(ledger, id, to, at) {
+  const entry = ledger.entries[id];
+  if (entry === void 0) return ledger;
+  const updated = {
+    ...entry,
+    curName: to,
+    renames: [...entry.renames, { from: entry.curName, to, at }]
+  };
+  return { ...ledger, entries: { ...ledger.entries, [id]: updated } };
+}
+function ledgerCurName(ledger, id) {
+  return ledger.entries[id]?.curName ?? null;
+}
+var OrbitalIdSchema = z.string().refine(isOrbitalId, { message: `Expected an orbital id (prefix "${ID_PREFIXES.orbital}")` });
+var EntityIdSchema = z.string().refine(isEntityId, { message: `Expected an entity id (prefix "${ID_PREFIXES.entity}")` });
+var TraitIdSchema = z.string().refine(isTraitId, { message: `Expected a trait id (prefix "${ID_PREFIXES.trait}")` });
+var EventIdSchema = z.string().refine(isEventId, { message: `Expected an event id (prefix "${ID_PREFIXES.event}")` });
+var PageIdSchema = z.string().refine(isPageId, { message: `Expected a page id (prefix "${ID_PREFIXES.page}")` });
+var ServiceIdSchema = z.string().refine(isServiceId, { message: `Expected a service id (prefix "${ID_PREFIXES.service}")` });
+var ThemeIdSchema = z.string().refine(isThemeId, { message: `Expected a theme id (prefix "${ID_PREFIXES.theme}")` });
+var PaletteEntryIdSchema = z.string().refine(isPaletteEntryId, { message: `Expected a palette-entry id (prefix "${ID_PREFIXES.palette}")` });
+var LedgerKindSchema = z.enum([
+  "orbital",
+  "entity",
+  "trait",
+  "event",
+  "page",
+  "service",
+  "theme"
+]);
+var LedgerEntrySchema = z.object({
+  id: z.string(),
+  kind: LedgerKindSchema,
+  bakedName: z.string(),
+  curName: z.string(),
+  renames: z.array(
+    z.object({ from: z.string(), to: z.string(), at: z.string() })
+  ),
+  owner: z.enum(["std", "io", "workspace"]),
+  parent: TraitIdSchema.optional()
+});
+var IdentityLedgerSchema = z.object({
+  schemaVersion: z.literal(1),
+  entries: z.record(LedgerEntrySchema)
+});
 var FieldTypeSchema = z.enum([
   "string",
   "number",
@@ -25,6 +170,7 @@ var RelationCardinalitySchema = z.enum([
 ]);
 var RelationConfigSchema = z.object({
   entity: z.string().min(1, "Target entity is required"),
+  entityId: EntityIdSchema.optional(),
   field: z.string().optional(),
   cardinality: RelationCardinalitySchema.optional(),
   onDelete: z.enum(["cascade", "nullify", "restrict"]).optional(),
@@ -35,6 +181,7 @@ var RelationConfigSchema = z.object({
 }).transform((data) => {
   const normalized = {
     entity: data.entity || data.target || "",
+    entityId: data.entityId,
     cardinality: data.cardinality || data.type,
     field: data.field,
     onDelete: data.onDelete
@@ -437,7 +584,7 @@ function isBinding(value) {
 function isSExprCall(value) {
   return isSExpr(value);
 }
-var CORE_BINDINGS = ["entity", "payload", "state", "now", "config", "computed", "trait", "user"];
+var CORE_BINDINGS = ["entity", "payload", "state", "now", "config", "computed", "trait", "user", "callsitePayload"];
 function parseBinding(binding) {
   if (!binding.startsWith("@")) {
     return null;
@@ -521,10 +668,12 @@ var StateSchema = z.object({
 var PayloadFieldSchema = z.object({
   name: z.string().min(1),
   type: z.string().min(1),
-  required: z.boolean().optional()
+  required: z.boolean().optional(),
+  properties: z.lazy(() => z.array(PayloadFieldSchema)).optional()
 });
 var EventSchema = z.object({
   key: z.string().min(1, "Event key is required"),
+  id: EventIdSchema.optional(),
   name: z.string().min(1, "Event name is required"),
   description: z.string().optional(),
   synonyms: z.string().optional(),
@@ -542,6 +691,7 @@ var TransitionSchema = z.object({
   from: z.string().min(1, "Transition source state is required"),
   to: z.string().min(1, "Transition target state is required"),
   event: z.string().min(1, "Transition event is required"),
+  eventId: EventIdSchema.optional(),
   guard: ExpressionSchema.nullish(),
   effects: z.array(EffectSchema).optional(),
   description: z.string().nullish()
@@ -571,14 +721,50 @@ var TraitConfigSchema = z.record(TraitConfigValueSchema);
 function isCallSiteConfigDeclaration(entry) {
   return typeof entry === "object" && entry !== null && !Array.isArray(entry) && "type" in entry && typeof entry.type === "string" && "default" in entry;
 }
+var CONFIG_DECLARATION_META_KEYS = ["label", "description", "tier", "synonyms", "values"];
+function isConfigFieldSchema(entry) {
+  if (typeof entry !== "object" || entry === null || Array.isArray(entry)) return false;
+  if (!("type" in entry) || typeof entry.type !== "string") return false;
+  return "default" in entry || CONFIG_DECLARATION_META_KEYS.some((k) => k in entry);
+}
+function normalizeCallSiteConfigToValues(config) {
+  if (config === void 0) {
+    return void 0;
+  }
+  const out = {};
+  let hasAny = false;
+  for (const [key, entry] of Object.entries(config)) {
+    const value = isConfigFieldSchema(entry) ? entry.default : entry;
+    if (value !== void 0) {
+      out[key] = value;
+      hasAny = true;
+    }
+  }
+  return hasAny ? out : void 0;
+}
+var REFERENCE_CONFIG_TYPES = ["entity", "trait", "event"];
+function isReferenceConfigType(type) {
+  return REFERENCE_CONFIG_TYPES.includes(type);
+}
+var ConfigFieldItemsDeclarationSchema = z.lazy(
+  () => z.object({
+    type: z.string().optional(),
+    properties: z.record(TraitEntityFieldSchema).optional(),
+    items: ConfigFieldItemsDeclarationSchema.optional()
+  })
+);
 var ConfigFieldDeclarationSchema = z.object({
   type: z.string(),
   default: TraitConfigValueSchema.optional(),
+  refId: z.string().optional(),
+  required: z.boolean().optional(),
   label: z.string().optional(),
   description: z.string().optional(),
   tier: z.string().optional(),
   values: z.array(z.string()).optional(),
-  synonyms: z.string().optional()
+  synonyms: z.string().optional(),
+  items: ConfigFieldItemsDeclarationSchema.optional(),
+  properties: z.lazy(() => z.record(TraitEntityFieldSchema)).optional()
 });
 var DeclaredTraitConfigSchema = z.record(
   ConfigFieldDeclarationSchema
@@ -615,7 +801,9 @@ var TraitEntityFieldSchema = z.object({
   ]),
   required: z.boolean().optional(),
   default: z.unknown().optional(),
-  values: z.array(z.string()).optional()
+  values: z.array(z.string()).optional(),
+  items: ConfigFieldItemsDeclarationSchema.optional(),
+  properties: z.lazy(() => z.record(TraitEntityFieldSchema)).optional()
 });
 var TraitDataEntitySchema = z.object({
   name: z.string().min(1),
@@ -634,9 +822,11 @@ var TraitTickSchema = z.object({
   interval: z.union([z.literal("frame"), z.number().positive()]),
   appliesTo: z.array(z.string()).optional(),
   pages: z.array(z.string()).optional(),
+  pageIds: z.array(PageIdSchema).optional(),
   guard: ExpressionSchema.optional(),
   effects: z.array(EffectSchema).min(1),
-  emits: z.array(z.string()).optional()
+  emits: z.array(z.string()).optional(),
+  emitIds: z.array(EventIdSchema).optional()
 });
 var EventScopeSchema = z.enum(["internal", "external"]);
 var EventPayloadFieldSchema = z.object({
@@ -654,20 +844,39 @@ var EventPayloadFieldSchema = z.object({
   type: z.string().min(1),
   required: z.boolean().optional(),
   description: z.string().optional(),
-  entityType: z.string().optional()
+  entityType: z.string().optional(),
+  properties: z.lazy(() => z.array(EventPayloadFieldSchema)).optional()
 });
+var CONFIG_REF_EVENT_PATTERN = /^@config\.[A-Za-z_][A-Za-z0-9_]*$/;
+function configRefEventKnob(event) {
+  return CONFIG_REF_EVENT_PATTERN.test(event) ? event.slice("@config.".length) : void 0;
+}
+function resolveConfigRefEventName(event, declaredConfig, effectiveConfig) {
+  const knob = configRefEventKnob(event);
+  if (knob === void 0) return { ok: false, error: "unknown-knob" };
+  const field = declaredConfig?.[knob];
+  if (field === void 0) return { ok: false, error: "unknown-knob" };
+  if (field.type !== "string") return { ok: false, error: "not-string" };
+  if (field.default === void 0) return { ok: false, error: "no-default" };
+  const value = effectiveConfig[knob];
+  if (typeof value !== "string") return { ok: false, error: "not-string" };
+  return { ok: true, value };
+}
 var TraitEventContractSchema = z.object({
   /**
    * Event name. Mirrors the Rust validator's `is_valid_event_identifier`:
    * starts with a letter, then any letters / digits / underscores. Both
    * UPPER_SNAKE_CASE and PascalCase shapes are valid identifiers in the
    * post-Phase 2.5 nominal-event type system (events declared via
-   * `type X = Event<T>`).
+   * `type X = Event<T>`). A pre-resolution `@config.<knob>` reference
+   * (Option B) is also legal — inline/resolve substitutes it with the
+   * knob's effective literal before codegen/runtime consume it.
    */
   event: z.string().min(1).regex(
-    /^[A-Za-z][A-Za-z0-9_]*$/,
-    "Event name must start with a letter and contain only letters, digits, and underscores"
+    /^([A-Za-z][A-Za-z0-9_]*|@config\.[A-Za-z_][A-Za-z0-9_]*)$/,
+    "Event name must start with a letter and contain only letters, digits, and underscores, or be a `@config.<knob>` reference"
   ),
+  eventId: EventIdSchema.optional(),
   description: z.string().optional(),
   synonyms: z.string().optional(),
   tier: z.string().optional(),
@@ -676,16 +885,24 @@ var TraitEventContractSchema = z.object({
 });
 var ListenSourceSchema = z.union([
   z.object({ kind: z.literal("any") }),
-  z.object({ kind: z.literal("trait"), trait: z.string().min(1) }),
+  z.object({
+    kind: z.literal("trait"),
+    trait: z.string().min(1),
+    traitId: TraitIdSchema.optional()
+  }),
   z.object({
     kind: z.literal("orbital"),
     orbital: z.string().min(1),
-    trait: z.string().min(1)
+    trait: z.string().min(1),
+    orbitalId: OrbitalIdSchema.optional(),
+    traitId: TraitIdSchema.optional()
   })
 ]);
 var TraitEventListenerSchema = z.object({
   event: z.string().min(1),
+  eventId: EventIdSchema.optional(),
   triggers: z.string().min(1),
+  triggersId: EventIdSchema.optional(),
   description: z.string().optional(),
   synonyms: z.string().optional(),
   tier: z.string().optional(),
@@ -701,14 +918,20 @@ var RequiredFieldSchema = z.object({
 });
 var TraitReferenceSchema = z.object({
   ref: z.string().min(1),
+  refId: TraitIdSchema.optional(),
+  // V4 local declaration id (see the interface doc) — declared so the
+  // strip-mode zod gate carries it through instead of dropping it.
+  id: TraitIdSchema.optional(),
   // Phase 1.2: optional registry path disambiguator, pairs with `ref`.
   from: z.string().optional(),
   linkedEntity: z.string().optional(),
+  linkedEntityId: EntityIdSchema.optional(),
   name: z.string().optional(),
   events: z.record(
     z.string().min(1, "events key (atom event name) must be non-empty"),
     z.string().min(1, "events value (caller event name) must be non-empty")
   ).optional(),
+  eventIds: z.record(z.string().min(1), EventIdSchema).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")
@@ -758,6 +981,7 @@ var SourceBehaviorMetadataSchema = z.object({
   originalName: z.string().min(1)
 });
 var TraitSchema = z.object({
+  id: TraitIdSchema.optional(),
   name: z.string().min(1),
   description: z.string().optional(),
   description_visual_prompt: z.string().optional(),
@@ -769,6 +993,9 @@ var TraitSchema = z.object({
   capabilities: z.array(z.string()).optional(),
   scope: TraitScopeSchema,
   linkedEntity: z.string().optional(),
+  linkedEntityId: EntityIdSchema.optional(),
+  entityRefIds: z.record(z.string().min(1), EntityIdSchema).optional(),
+  traitEmbedIds: z.record(z.string().min(1), TraitIdSchema).optional(),
   requiredFields: z.array(RequiredFieldSchema).optional(),
   dataEntities: z.array(TraitDataEntitySchema).optional(),
   stateMachine: StateMachineSchema.optional(),
@@ -842,10 +1069,13 @@ var ViewTypeSchema = z.enum([
 ]);
 var PageTraitRefSchema = z.object({
   ref: z.string().min(1, "Trait ref is required"),
+  refId: TraitIdSchema.optional(),
   linkedEntity: z.string().optional(),
+  linkedEntityId: EntityIdSchema.optional(),
   config: TraitConfigSchema.optional()
 });
 var OrbitalPageStrictSchema = z.object({
+  id: PageIdSchema.optional(),
   name: z.string().min(1, "Page name is required"),
   path: z.string().min(1, "Page path is required").startsWith("/", "Path must start with /"),
   primaryEntity: z.string().min(1, "Primary entity is required"),
@@ -853,6 +1083,7 @@ var OrbitalPageStrictSchema = z.object({
   title: z.string().optional()
 }).strict();
 var OrbitalPageSchema = z.object({
+  id: PageIdSchema.optional(),
   name: z.string().min(1, "Page name is required"),
   path: z.string().min(1, "Page path is required").startsWith("/", "Path must start with /"),
   viewType: ViewTypeSchema.optional(),
@@ -1429,11 +1660,14 @@ var PageRefStringSchema = z.string().regex(
 );
 var PageRefObjectSchema = z.object({
   ref: PageRefStringSchema,
+  refId: PageIdSchema.optional(),
   // Phase 1.2: optional registry path disambiguator, pairs with `ref`.
   from: z.string().optional(),
   path: z.string().startsWith("/").optional(),
   linkedEntity: z.string().optional(),
-  traits: z.array(TraitRefSchema).optional()
+  linkedEntityId: EntityIdSchema.optional(),
+  traits: z.array(TraitRefSchema).optional(),
+  traitRefIds: z.array(TraitIdSchema).optional()
 });
 var PageRefSchema = z.union([
   PageSchema,
@@ -1487,6 +1721,7 @@ var ComputedEventListenerSchema = z.object({
   payloadMapping: z.record(z.string()).optional()
 });
 var OrbitalDefinitionSchema = z.object({
+  id: OrbitalIdSchema.optional(),
   name: z.string().min(1, "Orbital name is required"),
   description: z.string().optional(),
   visual_prompt: z.string().optional(),
@@ -1551,7 +1786,12 @@ var OrbitalSchemaSchema = z.object({
   orbitals: z.array(OrbitalSchema).min(1, "At least one orbital is required"),
   services: z.array(ServiceDefinitionSchema).optional(),
   config: OrbitalConfigSchema.optional(),
-  _metadata: SchemaMetadataSchema.optional()
+  _metadata: SchemaMetadataSchema.optional(),
+  // V4 identity — optional/dual-carry until the Phase-7 flip. Present on
+  // id-carrying `.orb` files so `parseOrbitalSchema` preserves them instead
+  // of stripping unknown keys.
+  schemaVersion: z.number().optional(),
+  ledger: IdentityLedgerSchema.optional()
 });
 function parseOrbitalSchema(data) {
   return OrbitalSchemaSchema.parse(data);
@@ -1608,6 +1848,11 @@ var BINDING_DOCS = {
     description: "Authenticated user / agent context for ownership and role-based gating",
     examples: ["@user.id", "@user.role"],
     requiresPath: true
+  },
+  callsitePayload: {
+    description: "Call-site-captured event payload \u2014 emitted by the compiler's inline-trait hoisting when an extracted render block captured @payload; resolved at the composing effect by the runtime BindingResolver",
+    examples: ["@callsitePayload.error", "@callsitePayload.row"],
+    requiresPath: true
   }
 };
 var BINDING_CONTEXT_RULES = {
@@ -1616,8 +1861,8 @@ var BINDING_CONTEXT_RULES = {
     description: `Guards can access entity fields, event payload, current state, time, the call-site trait config (@config.X), and the authenticated user context (@user.id, @user.role) for ownership / role gates. Config access lets atoms write mode-aware guards \u2014 e.g. std-modal's OPEN can require @payload.row only when @config.mode equals "edit", letting create-mode legitimately fire OPEN with no row. Like effects, @config.X is substituted at molecule/organism inline time with the literal call-site value; at atom-scope validate, @config is allowed-but-unresolved.`
   },
   effect: {
-    allowed: ["entity", "payload", "state", "now", "trait", "config", "user"],
-    description: "Effects can access and modify entity fields, use payload data, embed another trait's live frame via @trait.X inside render-ui children, read trait config values (@config.X) for atoms parameterized by their call-site, and read the authenticated user context (@user.id, @user.role). At molecule/organism inline time, @config.X is substituted with the literal value from the call-site config block; at atom-scope validate, @config is allowed-but-unresolved."
+    allowed: ["entity", "payload", "state", "now", "trait", "config", "user", "callsitePayload"],
+    description: "Effects can access and modify entity fields, use payload data, embed another trait's live frame via @trait.X inside render-ui children, read trait config values (@config.X) for atoms parameterized by their call-site, and read the authenticated user context (@user.id, @user.role). At molecule/organism inline time, @config.X is substituted with the literal value from the call-site config block; at atom-scope validate, @config is allowed-but-unresolved. @callsitePayload.X is the call-site-captured event payload emitted by the compiler's inline-trait hoisting (a hoisted render block that captured @payload); it is resolved at the composing effect by the runtime BindingResolver."
   },
   tick: {
     allowed: ["entity", "state", "now", "config", "user"],
@@ -1730,7 +1975,7 @@ function getInteractionModelForDomain(domain) {
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-09T14:00:32.936Z",
+  exportedAt: "2026-07-16T19:33:37.203Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -2435,7 +2680,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "renderItem prop",
+          description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           kind: "callback",
           callbackArgs: [
             {
@@ -2605,15 +2850,6 @@ var patterns_registry_default = {
       ],
       typicalSize: "medium",
       propsSchema: {
-        entity: {
-          types: [
-            "object",
-            "array"
-          ],
-          description: "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
-          kind: "entity",
-          cardinality: "collection"
-        },
         className: {
           types: [
             "string"
@@ -2717,6 +2953,15 @@ var patterns_registry_default = {
             ]
           }
         },
+        entity: {
+          types: [
+            "object",
+            "array"
+          ],
+          description: "Entity data (single record or collection).",
+          kind: "entity",
+          cardinality: "collection"
+        },
         minCardWidth: {
           types: [
             "number"
@@ -5952,7 +6197,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Declarative step click event \u2014 emits UI:{stepClickEvent} with { stepIndex }",
+          description: "Declarative step click event \u2014 emits UI:{stepClickEvent} with { stepIndex }. Setting it requires declaring that event (with a `{ stepIndex }` payload) and a transition handling it in the same trait; omit this prop for non-clickable progress indicators.",
           kind: "event-ref",
           emitPayloadSchema: [
             {
@@ -9401,7 +9646,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Input type - supports 'select' and 'textarea' in addition to standard types",
+          description: "Input type \u2014 selects the field's data mode. Use 'password' for masked credentials / secret / passphrase entry (there is no separate password pattern); 'email', 'tel', 'url', 'number', 'search', 'date', and 'time' for their respective values; and 'select' / 'textarea' for choice and multi-line entry in addition to the standard single-line types.",
           enumValues: [
             "text",
             "email",
@@ -10679,7 +10924,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "Render function for each item",
+          description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           required: true,
           kind: "callback",
           callbackArgs: [
@@ -12079,6 +12324,144 @@ var patterns_registry_default = {
       ],
       typicalSize: "medium",
       propsSchema: {
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        },
+        placeholder: {
+          types: [
+            "string"
+          ],
+          description: "Placeholder text"
+        },
+        value: {
+          types: [
+            "string",
+            "number"
+          ],
+          description: "Current value"
+        },
+        disabled: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether input is disabled"
+        },
+        action: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event name for trait dispatch",
+          kind: "event"
+        },
+        inputType: {
+          types: [
+            "string"
+          ],
+          description: "Input type \u2014 selects the field's data mode. Use 'password' for masked credentials / secret / passphrase entry (there is no separate password pattern); 'email', 'tel', 'url', 'number', 'search', 'date', and 'time' for their respective values; and 'select' / 'textarea' for choice and multi-line entry in addition to the standard single-line types.",
+          enumValues: [
+            "text",
+            "email",
+            "password",
+            "number",
+            "tel",
+            "url",
+            "search",
+            "date",
+            "datetime-local",
+            "time",
+            "checkbox",
+            "select",
+            "textarea"
+          ]
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "label prop"
+        },
+        helperText: {
+          types: [
+            "string"
+          ],
+          description: "helperText prop"
+        },
+        error: {
+          types: [
+            "string"
+          ],
+          description: "error prop"
+        },
+        leftIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "leftIcon prop"
+        },
+        rightIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "rightIcon prop"
+        },
+        clearable: {
+          types: [
+            "boolean"
+          ],
+          description: "Show clear button when input has value"
+        },
+        onClear: {
+          types: [
+            "function",
+            "string"
+          ],
+          description: "Callback or declarative event key when clear button is clicked"
+        },
+        options: {
+          types: [
+            "array"
+          ],
+          description: "Options for select type",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              value: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "value",
+              "label"
+            ]
+          }
+        },
+        rows: {
+          types: [
+            "number"
+          ],
+          description: "Rows for textarea type"
+        },
+        onChange: {
+          types: [
+            "function",
+            "string"
+          ],
+          description: "onChange handler or declarative event key for trait dispatch"
+        },
         leftAddon: {
           types: [
             "node",
@@ -12092,12 +12475,6 @@ var patterns_registry_default = {
             "icon"
           ],
           description: "Right addon (icon, button, or text)"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
         }
       }
     },
@@ -16086,6 +16463,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              badge: {
+                types: [
+                  "number"
+                ]
+              },
               x: {
                 types: [
                   "number"
@@ -16106,7 +16488,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Graph edges",
+          description: "Graph edges (the only rendered links)",
           items: {
             types: [
               "object"
@@ -16144,6 +16526,39 @@ var patterns_registry_default = {
             ]
           }
         },
+        similarity: {
+          types: [
+            "array"
+          ],
+          description: "All-pairs similarity (cosine 0\u20131) used ONLY for layout, never drawn. It is the secondary macro-layout: non-connected pairs get a weak spring (higher cosine \u21D2 closer) so clusters arrange relative to each other; drawn `edges` stay the primary tight structure. When omitted, edges alone drive the layout.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              source: {
+                types: [
+                  "string"
+                ]
+              },
+              target: {
+                types: [
+                  "string"
+                ]
+              },
+              weight: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "source",
+              "target",
+              "weight"
+            ]
+          }
+        },
         height: {
           types: [
             "number"
@@ -16253,6 +16668,11 @@ var patterns_registry_default = {
                       "number"
                     ]
                   },
+                  badge: {
+                    types: [
+                      "number"
+                    ]
+                  },
                   x: {
                     types: [
                       "number"
@@ -16311,6 +16731,74 @@ var patterns_registry_default = {
                       "number"
                     ]
                   },
+                  badge: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "id"
+                ]
+              }
+            }
+          ]
+        },
+        onBadgeClick: {
+          types: [
+            "function"
+          ],
+          description: "On node badge click (e.g. to expand a merged cluster).",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "node",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  id: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  label: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  group: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  color: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  size: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  badge: {
+                    types: [
+                      "number"
+                    ]
+                  },
                   x: {
                     types: [
                       "number"
@@ -18326,7 +18814,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Field definitions for rendering each card. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
+          description: "Field definitions for rendering each card. The pattern contract in `@almadar/core/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
           items: {
             types: [
               "object"
@@ -18658,7 +19146,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop.',
+          description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. In .lolo, author the per-item renderer as renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.',
           kind: "callback",
           callbackArgs: [
             {
@@ -18771,7 +19259,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Field definitions for rendering each row. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
+          description: "Field definitions for rendering each row. The pattern contract in `@almadar/core/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
           items: {
             types: [
               "object"
@@ -19175,7 +19663,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop.',
+          description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. In .lolo, author the per-item renderer as renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.',
           kind: "callback",
           callbackArgs: [
             {
@@ -20205,6 +20693,12 @@ var patterns_registry_default = {
           ],
           description: "Text to display after the number"
         },
+        format: {
+          types: [
+            "string"
+          ],
+          description: `Display format: "number" (locale grouping), "currency" ($x.xx), "percent" (rounded %). Unset preserves the value's own decimals.`
+        },
         className: {
           types: [
             "string"
@@ -20391,7 +20885,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "Render function for each slide",
+          description: "Render function for each slide. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           kind: "callback",
           callbackArgs: [
             {
@@ -20564,7 +21058,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "renderItem prop",
+          description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           required: true,
           kind: "callback",
           callbackArgs: [
@@ -34586,7 +35080,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: 'Per-row render function (schema alias). In .orb: ["fn","item",{...}]. The compiler converts this to the children render prop.',
+          description: 'Per-row render function (schema alias). In .orb: ["fn","item",{...}]. The compiler converts this to the children render prop. In .lolo, author the per-row renderer as renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.',
           kind: "callback",
           callbackArgs: [
             {
@@ -36622,7 +37116,159 @@ var patterns_registry_default = {
         "v stack"
       ],
       typicalSize: "small",
-      propsSchema: {}
+      propsSchema: {
+        gap: {
+          types: [
+            "string"
+          ],
+          description: "Gap between children",
+          enumValues: [
+            "none",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl"
+          ],
+          default: "md"
+        },
+        align: {
+          types: [
+            "string"
+          ],
+          description: "Align items on the cross axis",
+          enumValues: [
+            "start",
+            "center",
+            "end",
+            "stretch",
+            "baseline"
+          ],
+          default: "stretch"
+        },
+        justify: {
+          types: [
+            "string"
+          ],
+          description: "Justify items on the main axis",
+          enumValues: [
+            "start",
+            "center",
+            "end",
+            "between",
+            "around",
+            "evenly"
+          ],
+          default: "start"
+        },
+        wrap: {
+          types: [
+            "boolean"
+          ],
+          description: "Allow items to wrap",
+          default: false
+        },
+        reverse: {
+          types: [
+            "boolean"
+          ],
+          description: "Reverse the order of children",
+          default: false
+        },
+        flex: {
+          types: [
+            "boolean"
+          ],
+          description: "Fill available space (flex: 1)",
+          default: false
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Custom class name"
+        },
+        style: {
+          types: [
+            "object"
+          ],
+          description: "Inline styles"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Children elements"
+        },
+        as: {
+          types: [
+            "component"
+          ],
+          description: "HTML element to render as"
+        },
+        onClick: {
+          types: [
+            "function"
+          ],
+          description: "Click handler",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "e",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        onKeyDown: {
+          types: [
+            "function"
+          ],
+          description: "Keyboard handler",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "e",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        role: {
+          types: [
+            "string"
+          ],
+          description: "Role for accessibility"
+        },
+        tabIndex: {
+          types: [
+            "number"
+          ],
+          description: "Tab index for focus management"
+        },
+        action: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          kind: "event"
+        },
+        actionPayload: {
+          types: [
+            "object"
+          ],
+          description: "Payload to include with the action event",
+          freeform: true
+        },
+        responsive: {
+          types: [
+            "boolean"
+          ],
+          description: "When true, horizontal stacks flip to vertical below the md breakpoint (768px)",
+          default: false
+        }
+      }
     },
     hstack: {
       type: "hstack",
@@ -36635,7 +37281,159 @@ var patterns_registry_default = {
         "h stack"
       ],
       typicalSize: "small",
-      propsSchema: {}
+      propsSchema: {
+        gap: {
+          types: [
+            "string"
+          ],
+          description: "Gap between children",
+          enumValues: [
+            "none",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl"
+          ],
+          default: "md"
+        },
+        align: {
+          types: [
+            "string"
+          ],
+          description: "Align items on the cross axis",
+          enumValues: [
+            "start",
+            "center",
+            "end",
+            "stretch",
+            "baseline"
+          ],
+          default: "stretch"
+        },
+        justify: {
+          types: [
+            "string"
+          ],
+          description: "Justify items on the main axis",
+          enumValues: [
+            "start",
+            "center",
+            "end",
+            "between",
+            "around",
+            "evenly"
+          ],
+          default: "start"
+        },
+        wrap: {
+          types: [
+            "boolean"
+          ],
+          description: "Allow items to wrap",
+          default: false
+        },
+        reverse: {
+          types: [
+            "boolean"
+          ],
+          description: "Reverse the order of children",
+          default: false
+        },
+        flex: {
+          types: [
+            "boolean"
+          ],
+          description: "Fill available space (flex: 1)",
+          default: false
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Custom class name"
+        },
+        style: {
+          types: [
+            "object"
+          ],
+          description: "Inline styles"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Children elements"
+        },
+        as: {
+          types: [
+            "component"
+          ],
+          description: "HTML element to render as"
+        },
+        onClick: {
+          types: [
+            "function"
+          ],
+          description: "Click handler",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "e",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        onKeyDown: {
+          types: [
+            "function"
+          ],
+          description: "Keyboard handler",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "e",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        role: {
+          types: [
+            "string"
+          ],
+          description: "Role for accessibility"
+        },
+        tabIndex: {
+          types: [
+            "number"
+          ],
+          description: "Tab index for focus management"
+        },
+        action: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          kind: "event"
+        },
+        actionPayload: {
+          types: [
+            "object"
+          ],
+          description: "Payload to include with the action event",
+          freeform: true
+        },
+        responsive: {
+          types: [
+            "boolean"
+          ],
+          description: "When true, horizontal stacks flip to vertical below the md breakpoint (768px)",
+          default: false
+        }
+      }
     },
     "form-layout": {
       type: "form-layout",
@@ -39888,31 +40686,31 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Rect width in px."
+          description: "Rect width in world units (fractions of `projector.tileWidth`)."
         },
         height: {
           types: [
             "number"
           ],
-          description: "Rect height in px."
+          description: "Rect height in world units (fractions of `projector.tileWidth`)."
         },
         radiusX: {
           types: [
             "number"
           ],
-          description: "Ellipse horizontal radius in px."
+          description: "Ellipse horizontal radius in world units (fractions of `projector.tileWidth`)."
         },
         radiusY: {
           types: [
             "number"
           ],
-          description: "Ellipse vertical radius in px; omitted \u2192 `radiusX` (a circle)."
+          description: "Ellipse vertical radius in world units; omitted \u2192 `radiusX` (a circle)."
         },
         offsetX: {
           types: [
             "number"
           ],
-          description: "Fine px nudge from the anchor point (e.g. a disc drawn at `groundY - 8*scale`)."
+          description: "Fine nudge from the anchor point in world units."
         },
         offsetY: {
           types: [
@@ -39924,7 +40722,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Poly vertices as px offsets relative to the cell's projected top-left.",
+          description: "Poly vertices as world-unit offsets relative to the cell's projected top-left.",
           items: {
             types: [
               "object"
@@ -40114,13 +40912,13 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Draw width in px (2D) / world units (3D); omitted \u2192 resolved source width."
+          description: "Draw width in world units (fractions of `projector.tileWidth`); omitted \u2192 resolved source width in px."
         },
         height: {
           types: [
             "number"
           ],
-          description: "Draw height in px (2D) / world units (3D); omitted \u2192 resolved source height."
+          description: "Draw height in world units (fractions of `projector.tileWidth`); omitted \u2192 resolved source height in px."
         },
         frame: {
           types: [
@@ -40128,6 +40926,12 @@ var patterns_registry_default = {
           ],
           description: "Explicit atlas sub-rect override (px); omitted \u2192 resolved from `asset.atlas`/`asset.sprite`."
         },
+        animation: {
+          types: [
+            "string"
+          ],
+          description: "Named GLB animation clip to play (3D backend only; the 2D painter animates via `frame`). Matched case-insensitively against the model's clips."
+        },
         flipX: {
           types: [
             "boolean"
@@ -40605,6 +41409,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              animation: {
+                types: [
+                  "string"
+                ]
+              },
               flipX: {
                 types: [
                   "boolean"
@@ -41731,7 +42540,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-09T14:00:32.936Z",
+  exportedAt: "2026-07-16T19:33:37.203Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -43086,7 +43895,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-09T14:00:32.936Z",
+  exportedAt: "2026-07-16T19:33:37.203Z",
   contracts: {
     form: {
       emits: [
@@ -44573,10 +45382,13 @@ var ORB_ALLOWED_ENTITY_PATTERNS = /* @__PURE__ */ new Set([
   "data-grid",
   "search-input",
   "form-section",
-  "meter"
+  "meter",
+  "table-view",
+  "filter-group",
+  "timeline",
+  "media-gallery"
 ]);
 var ORB_EXCLUDED_CATEGORIES = /* @__PURE__ */ new Set([
-  "game",
   "debug",
   "template"
 ]);
@@ -44657,6 +45469,43 @@ function getOrbAllowedPatternsFiltered(patternNames) {
   return lines.join("\n");
 }
 
+// src/types/json.ts
+function isJsonPrimitive(value) {
+  return value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function isJsonObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isJsonArray(value) {
+  return Array.isArray(value);
+}
+
+// src/patterns/helpers/render-ui-pattern-types.ts
+function collectPatternTypeTokens(node, out) {
+  if (!isJsonObject(node)) return;
+  const type = node["type"];
+  if (typeof type === "string" && !type.startsWith("@")) out.add(type);
+  const children = node["children"];
+  if (isJsonArray(children)) {
+    for (const child of children) collectPatternTypeTokens(child, out);
+  }
+}
+function collectRenderUiPatternTypes(ir, out) {
+  if (isJsonArray(ir)) {
+    if (ir.length >= 3 && ir[0] === "render-ui" && typeof ir[1] === "string") {
+      collectPatternTypeTokens(ir[2], out);
+    }
+    for (const item of ir) collectRenderUiPatternTypes(item, out);
+  } else if (isJsonObject(ir)) {
+    for (const value of Object.values(ir)) collectRenderUiPatternTypes(value, out);
+  }
+}
+function renderUiPatternTypesOf(ir) {
+  const out = /* @__PURE__ */ new Set();
+  collectRenderUiPatternTypes(ir, out);
+  return out;
+}
+
 // src/patterns/helpers/pattern-recommender.ts
 var DOMAIN_KEYWORDS = {
   business: ["admin panels", "data-dense views", "list pages", "data entry", "comparisons"],
@@ -45010,17 +45859,6 @@ function isResolvedIR(ir) {
   return typeof r.appName === "string" && r.traits instanceof Map && r.pages instanceof Map;
 }
 
-// src/types/json.ts
-function isJsonPrimitive(value) {
-  return value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
-}
-function isJsonObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function isJsonArray(value) {
-  return Array.isArray(value);
-}
-
 // src/types/validation.ts
 var KNOWN_VALIDATION_ERROR_CODES = {
   // Binding (`@entity.X`, `@payload.Y`, `@state.Z`, `@now`, ...)
@@ -45185,7 +46023,13 @@ var KNOWN_VALIDATION_ERROR_CODES = {
   ORB_X_PAYLOAD_MISMATCH: "ORB_X_PAYLOAD_MISMATCH",
   ORB_X_RENDER_UI_EVENT_LITERAL_STALE: "ORB_X_RENDER_UI_EVENT_LITERAL_STALE",
   ORB_X_UNRESOLVED_PATTERN_FIELD_REF: "ORB_X_UNRESOLVED_PATTERN_FIELD_REF",
-  ORB_X_UNUSED_EMISSION: "ORB_X_UNUSED_EMISSION"
+  ORB_X_UNUSED_EMISSION: "ORB_X_UNUSED_EMISSION",
+  // Identity — V4 dual-carry id integrity (`ORB_ID_*`). Mirrors
+  // `orbital-compiler/src/phases/validation/id_integrity.rs`.
+  ORB_ID_UNKNOWN_REF: "ORB_ID_UNKNOWN_REF",
+  ORB_ID_NAME_MISMATCH: "ORB_ID_NAME_MISMATCH",
+  ORB_ID_KIND_MISMATCH: "ORB_ID_KIND_MISMATCH",
+  ORB_ID_LEDGER_ORPHAN: "ORB_ID_LEDGER_ORPHAN"
 };
 function isKnownValidationErrorCode(code) {
   return code in KNOWN_VALIDATION_ERROR_CODES;
@@ -45587,6 +46431,109 @@ function getTrait(ir, traitName) {
   return ir.traits.get(traitName);
 }
 
+// src/embedded-trait-config.ts
+var TRAIT_BINDING_PREFIX = "@trait.";
+var CONFIG_FORWARD_RE = /^@config\.([A-Za-z_][A-Za-z0-9_]*)$/;
+function collectTraitRefsFromValue(value, into) {
+  if (value === null || value === void 0) return;
+  if (typeof value === "string") {
+    if (value.startsWith(TRAIT_BINDING_PREFIX)) {
+      const rest = value.slice(TRAIT_BINDING_PREFIX.length);
+      const dot = rest.indexOf(".");
+      const traitName = dot === -1 ? rest : rest.slice(0, dot);
+      if (traitName.length > 0) into.add(traitName);
+    }
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectTraitRefsFromValue(item, into);
+    return;
+  }
+  if (typeof value === "object") {
+    for (const v of Object.values(value)) {
+      collectTraitRefsFromValue(v, into);
+    }
+  }
+}
+function targetTraitOf(traitRef) {
+  if (!traitRef || typeof traitRef !== "object") return void 0;
+  const resolved = traitRef._resolved;
+  return resolved && typeof resolved === "object" ? resolved : traitRef;
+}
+function collectEmbeddedTraitReferrers(schema) {
+  const out = /* @__PURE__ */ new Map();
+  if (!schema?.orbitals) return out;
+  for (const orbital of schema.orbitals) {
+    const traits = orbital.traits;
+    if (!Array.isArray(traits)) continue;
+    for (const traitRef of traits) {
+      const target = targetTraitOf(traitRef);
+      if (!target) continue;
+      const referrerName = target.name;
+      if (typeof referrerName !== "string" || referrerName.length === 0) continue;
+      const refs = /* @__PURE__ */ new Set();
+      if (target.config) collectTraitRefsFromValue(target.config, refs);
+      const stateMachine = target.stateMachine;
+      if (stateMachine) collectTraitRefsFromValue(stateMachine, refs);
+      if (refs.size === 0) continue;
+      for (const child of refs) {
+        if (child === referrerName) continue;
+        if (!out.has(child)) out.set(child, referrerName);
+      }
+    }
+  }
+  return out;
+}
+function buildResolvedTraitConfigs(schema) {
+  const rawByName = {};
+  if (!schema?.orbitals) return {};
+  for (const orbital of schema.orbitals) {
+    const traitRefs = orbital.traits;
+    if (!traitRefs) continue;
+    for (const t of traitRefs) {
+      if (typeof t === "string") continue;
+      const name = t.name ?? t.ref;
+      const config = t.config;
+      if (typeof name === "string" && config !== void 0) {
+        rawByName[name] = { ...t, config };
+      }
+    }
+  }
+  const referrerByChild = collectEmbeddedTraitReferrers(schema);
+  const resolved = /* @__PURE__ */ new Map();
+  const resolving = /* @__PURE__ */ new Set();
+  function resolveConfig(name) {
+    const cached = resolved.get(name);
+    if (cached) return cached;
+    const raw = rawByName[name]?.config;
+    const base = normalizeCallSiteConfigToValues(raw);
+    if (!base) return void 0;
+    if (resolving.has(name)) return base;
+    resolving.add(name);
+    const out = { ...base };
+    const referrer = referrerByChild.get(name);
+    if (referrer && referrer !== name) {
+      const referrerConfig = resolveConfig(referrer);
+      for (const [key, value] of Object.entries(out)) {
+        if (typeof value !== "string") continue;
+        const match = CONFIG_FORWARD_RE.exec(value);
+        if (!match) continue;
+        const forwarded = referrerConfig?.[match[1]];
+        if (forwarded !== void 0) out[key] = forwarded;
+      }
+    }
+    resolving.delete(name);
+    resolved.set(name, out);
+    return out;
+  }
+  const map = {};
+  for (const name of Object.keys(rawByName)) {
+    const cfg = resolveConfig(name);
+    if (cfg !== void 0) map[name] = cfg;
+  }
+  return map;
+}
+
 // src/diff.ts
 function diffSchemas(before, after) {
   const changes = [];
@@ -47207,13 +48154,40 @@ function applyEventWiring(orbitals, wiring) {
 }
 
 // src/builders/compose-behaviors.ts
+function isSchema(input) {
+  return "orbitals" in input && Array.isArray(input.orbitals);
+}
 function asDefinitions(inputs) {
-  return inputs.flatMap((input) => {
-    if ("orbitals" in input && Array.isArray(input.orbitals)) {
-      return input.orbitals;
+  return inputs.flatMap(
+    (input) => isSchema(input) ? input.orbitals : [input]
+  );
+}
+function mergeLedgers(inputs) {
+  const merged = /* @__PURE__ */ new Map();
+  let sawLedger = false;
+  for (const input of inputs) {
+    if (!isSchema(input) || input.ledger === void 0) continue;
+    sawLedger = true;
+    for (const [id, entry] of Object.entries(input.ledger.entries)) {
+      if (!merged.has(id)) merged.set(id, entry);
     }
-    return [input];
-  });
+  }
+  if (!sawLedger) return void 0;
+  const entries = {};
+  for (const [id, entry] of [...merged.entries()].sort(
+    ([a], [b]) => a < b ? -1 : a > b ? 1 : 0
+  )) {
+    entries[id] = entry;
+  }
+  return { schemaVersion: 1, entries };
+}
+function mergeSchemaVersions(inputs) {
+  let max;
+  for (const input of inputs) {
+    if (!isSchema(input) || input.schemaVersion === void 0) continue;
+    max = max === void 0 ? input.schemaVersion : Math.max(max, input.schemaVersion);
+  }
+  return max;
 }
 function toKebabCase(name) {
   return name.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
@@ -47283,10 +48257,14 @@ function composeBehaviors(input) {
       pages: page ? [page] : []
     };
   });
+  const ledger = mergeLedgers(rawInputs);
+  const schemaVersion = mergeSchemaVersions(rawInputs);
   const schema = {
     name: appName,
     version: "1.0.0",
-    orbitals: orbitalsWithPages
+    orbitals: orbitalsWithPages,
+    ...schemaVersion !== void 0 ? { schemaVersion } : {},
+    ...ledger !== void 0 ? { ledger } : {}
   };
   return {
     schema,
@@ -47697,6 +48675,6 @@ function mergeEntityFrame(current, orderedWrites) {
   return next;
 }
 
-export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, ANIMATION_NAMES, ASSET_ASPECTS, ASSET_DIMENSIONS, AgentDomainCategorySchema, AnimationDefSchema, AnimationNameSchema, AssetAspectSchema, AssetCatalogEntrySchema, AssetCatalogSchema, AssetDimensionSchema, AssetSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CAMERA_MODES, COMPONENT_MAPPING, CORE_BINDINGS, CameraModeSchema, CameraSchema, ColorSliceSchema, ColorTokensSchema, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, ConfigProvenanceRecordSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DensitySliceSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EVENT_CONTRACTS, EffectSchema, ElevationSliceSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldContractSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GameSubCategorySchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, INTEGRATORS_REGISTRY, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PATTERN_REGISTRY, PATTERN_TYPES, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PatternTypeSchema, PayloadFieldSchema, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SPRITE_DIRECTIONS, ScenePosSchema, SchemaMetadataSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, SpriteDirectionSchema, SpriteSheetAtlasSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SubTextureSchema, SuggestedGuardSchema, TextureAtlasSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TilesheetSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, applyRenderOverlay, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildRecommendationContext, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, component_mapping_default as componentMapping, composeBehaviors, constTruth, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, deriveInputType, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, event_contracts_default as eventContracts, extractPayloadFieldRef, findCompatiblePatterns, findService, fingerprintNode, formatRecommendationsForPrompt, generatePatternDescription, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getComponentForPattern, getDefaultAnimationsForRole, getEmittedEvents, getEntity, getEntityCardinality, getInteractionModelForDomain, getOperator, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPage, getPages, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, inferTsType, insertChildAtPath, integrators_registry_default as integratorsRegistry, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isDestructiveChange, isDrawHostPattern, isDrawablePattern, isEffect, isEntityAwarePattern, isEntityCall, isEntityReference, isEntityReferenceAny, isEventPayloadValue, isFieldValue, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isPlanSnapshot, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSessionHistoryEntry, isSocketService, isThemeReference, isTraitFieldRef, isValidBinding, isValidPatternType, mergeEntityFrame, navigate, navigatePatternPath, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, patterns_registry_default as patternsRegistry, persist, persistenceModeAllowsOverrides, recommendPatterns, ref, registry, removeChildAtPath, renderUI, replaceChildAtPath, requiresConfirmation, safeParseOrbitalSchema, schemaToIR, set, setPropAtPath, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, walkSExpr, walkStatePairs, watch, widenTier };
+export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, ANIMATION_NAMES, ASSET_ASPECTS, ASSET_DIMENSIONS, AgentDomainCategorySchema, AnimationDefSchema, AnimationNameSchema, AssetAspectSchema, AssetCatalogEntrySchema, AssetCatalogSchema, AssetDimensionSchema, AssetSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CAMERA_MODES, COMPONENT_MAPPING, CONFIG_REF_EVENT_PATTERN, CORE_BINDINGS, CameraModeSchema, CameraSchema, ColorSliceSchema, ColorTokensSchema, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, ConfigProvenanceRecordSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DensitySliceSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EVENT_CONTRACTS, EffectSchema, ElevationSliceSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldContractSchema, EntityFieldSchema, EntityIdSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventIdSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GameSubCategorySchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, INTEGRATORS_REGISTRY, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IdentityLedgerSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, LedgerEntrySchema, LedgerKindSchema, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalIdSchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PATTERN_REGISTRY, PATTERN_TYPES, PageIdSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PaletteEntryIdSchema, PatternTypeSchema, PayloadFieldSchema, REFERENCE_CONFIG_TYPES, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SPRITE_DIRECTIONS, ScenePosSchema, SchemaMetadataSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceIdSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, SpriteDirectionSchema, SpriteSheetAtlasSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SubTextureSchema, SuggestedGuardSchema, TextureAtlasSchema, ThemeDefinitionSchema, ThemeIdSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TilesheetSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitIdSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, applyRenderOverlay, asEntityId, asEventId, asOrbitalId, asPageId, asPaletteEntryId, asServiceId, asThemeId, asTraitId, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildRecommendationContext, buildReplayPaths, buildResolvedTraitConfigs, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectEmbeddedTraitReferrers, collectReachableStates, collectRenderUiPatternTypes, component_mapping_default as componentMapping, composeBehaviors, configRefEventKnob, constTruth, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, deriveInputType, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, event_contracts_default as eventContracts, extractPayloadFieldRef, findCompatiblePatterns, findService, fingerprintNode, formatRecommendationsForPrompt, generatePatternDescription, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getComponentForPattern, getDefaultAnimationsForRole, getEmittedEvents, getEntity, getEntityCardinality, getInteractionModelForDomain, getOperator, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPage, getPages, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, idKindOf, idPrefix, inferTsType, insertChildAtPath, integrators_registry_default as integratorsRegistry, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isDestructiveChange, isDrawHostPattern, isDrawablePattern, isEffect, isEntityAwarePattern, isEntityCall, isEntityId, isEntityReference, isEntityReferenceAny, isEventId, isEventPayloadValue, isFieldValue, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMcpService, isOrbitalDefinition, isOrbitalId, isPageId, isPageReference, isPageReferenceObject, isPageReferenceString, isPaletteEntryId, isPlanSnapshot, isReferenceConfigType, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceId, isServiceReference, isServiceReferenceObject, isSessionHistoryEntry, isSocketService, isThemeId, isThemeReference, isTraitFieldRef, isTraitId, isValidBinding, isValidPatternType, ledgerCurName, ledgerRename, ledgerResolveName, mergeEntityFrame, mintId, navigate, navigatePatternPath, normalizeCallSiteConfigToValues, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, patterns_registry_default as patternsRegistry, persist, persistenceModeAllowsOverrides, recommendPatterns, ref, registry, removeChildAtPath, renderUI, renderUiPatternTypesOf, replaceChildAtPath, requiresConfirmation, resolveConfigRefEventName, safeParseOrbitalSchema, schemaToIR, set, setPropAtPath, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, walkSExpr, walkStatePairs, watch, widenTier };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map