@almadar/core 10.29.0 → 10.31.0

package/dist/builders.d.ts

@@ -1,5 +1,5 @@
-import './pattern-types-JZordBZv.js';
-export { i as ComposeBehaviorsInput, j as ComposeBehaviorsResult, c7 as ComposeConnection, c8 as ComposePage, a6 as EventWiringEntry, aq as LayoutStrategy, c9 as MakeAtomOrbitalOpts, ca as MakeAtomOrbitalTraitOverrides, cb as MakeEntityOpts, cc as MakeLayoutTraitOpts, cd as MakeOrbitalWithUsesOpts, ce as MakePageOpts, cf as MakePageRefOpts, cg as MakePageRefOptsTyped, M as MakeTraitRefOpts, ch as MakeTraitRefOptsTyped, bS as applyEventWiring, ci as applyTraitConfigOverrides, cj as compose, bT as composeBehaviors, ck as connect, bU as detectLayoutStrategy, cl as ensureIdField, cm as extractTrait, cn as makeAtomOrbital, co as makeEntity, cp as makeLayoutTrait, cq as makeOrbital, cr as makeOrbitalWithUses, cs as makePage, ct as makePageRef, cu as makeRenderUI, cv as makeSchema, cw as makeSlot, cx as makeTraitRef, cy as mergeOrbitals, cz as pipe, cA as plural, cB as wire } from './builders-DcBjE_Uw.js';
-import './trait-B_CzfDSi.js';
+import './pattern-types-VDIr2TkX.js';
+export { i as ComposeBehaviorsInput, j as ComposeBehaviorsResult, c7 as ComposeConnection, c8 as ComposePage, a6 as EventWiringEntry, aq as LayoutStrategy, c9 as MakeAtomOrbitalOpts, ca as MakeAtomOrbitalTraitOverrides, cb as MakeEntityOpts, cc as MakeLayoutTraitOpts, cd as MakeOrbitalWithUsesOpts, ce as MakePageOpts, cf as MakePageRefOpts, cg as MakePageRefOptsTyped, M as MakeTraitRefOpts, ch as MakeTraitRefOptsTyped, bS as applyEventWiring, ci as applyTraitConfigOverrides, cj as compose, bT as composeBehaviors, ck as connect, bU as detectLayoutStrategy, cl as ensureIdField, cm as extractTrait, cn as makeAtomOrbital, co as makeEntity, cp as makeLayoutTrait, cq as makeOrbital, cr as makeOrbitalWithUses, cs as makePage, ct as makePageRef, cu as makeRenderUI, cv as makeSchema, cw as makeSlot, cx as makeTraitRef, cy as mergeLedgers, cz as mergeOrbitals, cA as pipe, cB as plural, cC as wire } from './builders-DDcCVboe.js';
+import './trait-DE6VU4Cd.js';
 import './expression-CB9R3KWk.js';
 import 'zod';

package/dist/builders.js

@@ -1,6 +1,85 @@
 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 isEntityId = entityKind.is;
+var isTraitId = traitKind.is;
+var isEventId = eventKind.is;
+var isPageId = pageKind.is;
+var isServiceId = serviceKind.is;
+var isThemeId = themeKind.is;
+var isPaletteEntryId = paletteKind.is;
+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}")` });
+z.string().refine(isServiceId, { message: `Expected a service id (prefix "${ID_PREFIXES.service}")` });
+z.string().refine(isThemeId, { message: `Expected a theme id (prefix "${ID_PREFIXES.theme}")` });
+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()
+});
+z.object({
+  schemaVersion: z.literal(1),
+  entries: z.record(LedgerEntrySchema)
+});
+var JsonValueSchema = z.lazy(
+  () => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(JsonValueSchema), z.record(JsonValueSchema)])
+);
+
+// src/types/field.ts
 z.enum([
   "string",
   "number",
@@ -25,6 +104,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 +115,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
@@ -62,7 +143,7 @@ var EntityFieldSchema = z.lazy(() => {
   const baseFieldShape = {
     name: z.string().min(1, "Field name is required").optional(),
     required: z.boolean().optional(),
-    default: z.unknown().optional(),
+    default: JsonValueSchema.optional(),
     format: FieldFormatSchema.optional(),
     min: z.number().optional(),
     max: z.number().optional(),
@@ -326,6 +407,7 @@ var PayloadFieldSchema = z.object({
 });
 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(),
@@ -343,6 +425,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()
@@ -379,6 +462,7 @@ var ConfigFieldItemsDeclarationSchema = z.lazy(
 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(),
@@ -422,7 +506,7 @@ var TraitEntityFieldSchema = z.object({
     "enum"
   ]),
   required: z.boolean().optional(),
-  default: z.unknown().optional(),
+  default: TraitConfigValueSchema.optional(),
   values: z.array(z.string()).optional(),
   items: ConfigFieldItemsDeclarationSchema.optional(),
   properties: z.lazy(() => z.record(TraitEntityFieldSchema)).optional()
@@ -444,9 +528,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({
@@ -481,6 +567,7 @@ var TraitEventContractSchema = z.object({
     /^([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(),
@@ -489,16 +576,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(),
@@ -514,14 +609,20 @@ var RequiredFieldSchema = z.object({
 });
 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")
@@ -540,12 +641,11 @@ z.object({
   listens: z.array(z.unknown()).optional(),
   emitsScope: z.enum(["internal", "external"]).optional(),
   // Phase F.8: per-transition effects override. The keys are event
-  // names (the transition triggers AFTER renames). Values are arrays
-  // of SExpression-shaped data; the inliner validates the SExpression
-  // shape during application, so the schema accepts loose `unknown[]`.
+  // names (the transition triggers AFTER renames); values are SExpr
+  // effect tuples.
   effects: z.record(
     z.string().min(1, "effects override key (event name) must be non-empty"),
-    z.array(z.unknown())
+    z.array(SExprSchema)
   ).optional()
 }).refine(
   (ref) => {
@@ -571,6 +671,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(),
@@ -582,6 +683,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(),
@@ -627,10 +731,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()
 });
 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"),
@@ -638,6 +745,7 @@ 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(),
@@ -1159,11 +1267,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,
@@ -1204,6 +1315,7 @@ var ComputedEventListenerSchema = z.object({
   payloadMapping: z.record(z.string()).optional()
 });
 z.object({
+  id: OrbitalIdSchema.optional(),
   name: z.string().min(1, "Orbital name is required"),
   description: z.string().optional(),
   visual_prompt: z.string().optional(),
@@ -1386,13 +1498,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();
@@ -1462,10 +1601,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,
@@ -1604,6 +1747,7 @@ function makeTraitRef(opts) {
   if (opts.from !== void 0) ref.from = opts.from;
   if (opts.name !== void 0) ref.name = opts.name;
   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.fields !== void 0) ref.fields = opts.fields;
   if (opts.effects !== void 0) ref.effects = opts.effects;
@@ -1805,6 +1949,6 @@ function pipe(orbitals, events, appName) {
   };
 }
 
-export { applyEventWiring, applyTraitConfigOverrides, compose, composeBehaviors, connect, detectLayoutStrategy, ensureIdField, extractTrait, makeAtomOrbital, makeEntity, makeLayoutTrait, makeOrbital, makeOrbitalWithUses, makePage, makePageRef, makeRenderUI, makeSchema, makeSlot, makeTraitRef, mergeOrbitals, pipe, plural, wire };
+export { applyEventWiring, applyTraitConfigOverrides, compose, composeBehaviors, connect, detectLayoutStrategy, ensureIdField, extractTrait, makeAtomOrbital, makeEntity, makeLayoutTrait, makeOrbital, makeOrbitalWithUses, makePage, makePageRef, makeRenderUI, makeSchema, makeSlot, makeTraitRef, mergeLedgers, mergeOrbitals, pipe, plural, wire };
 //# sourceMappingURL=builders.js.map
 //# sourceMappingURL=builders.js.map