@almadar/core 4.4.1 → 4.5.0

package/dist/builders.d.ts

@@ -1,5 +1,5 @@
-import { T as TraitEventContract, E as EntityField, a as EntityPersistence, b as EntityRow, O as OrbitalDefinition, c as OrbitalSchema, d as Trait, e as Entity, P as Page } from './schema-B0Yin-RM.js';
-export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-Da0YDcli.js';
+import { T as TraitEventContract, E as EntityField, a as EntityPersistence, b as EntityRow, O as OrbitalDefinition, c as OrbitalSchema, d as Trait, e as Entity, P as Page } from './schema-D4VBpRZI.js';
+export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-BtjmpmIC.js';
 import 'zod';
 import '@almadar/patterns';
 

package/dist/builders.js

@@ -46,22 +46,61 @@ var FieldFormatSchema = z.enum([
   "datetime",
   "uuid"
 ]);
+var FIELD_TYPE_ALIASES = {
+  text: "string",
+  int: "number",
+  float: "number",
+  ts: "timestamp"
+};
 var EntityFieldSchema = z.lazy(
-  () => z.object({
-    name: z.string().min(1, "Field name is required"),
-    type: FieldTypeSchema,
-    required: z.boolean().optional(),
-    default: z.unknown().optional(),
-    values: z.array(z.string()).optional(),
-    enum: z.array(z.string()).optional(),
-    format: FieldFormatSchema.optional(),
-    min: z.number().optional(),
-    max: z.number().optional(),
-    items: EntityFieldSchema.optional(),
-    relation: RelationConfigSchema.optional()
-  }).refine(
-    (field) => field.type !== "relation" || field.relation !== void 0,
-    { message: 'Relation config is required when type is "relation"', path: ["relation"] }
+  () => z.preprocess(
+    (input) => {
+      if (input !== null && typeof input === "object" && "type" in input && typeof input.type === "string") {
+        const raw = input.type;
+        const canonical = FIELD_TYPE_ALIASES[raw];
+        if (canonical !== void 0) {
+          return { ...input, type: canonical };
+        }
+      }
+      return input;
+    },
+    z.object({
+      name: z.string().min(1, "Field name is required"),
+      type: FieldTypeSchema,
+      required: z.boolean().optional(),
+      default: z.unknown().optional(),
+      values: z.array(z.string()).optional(),
+      enum: z.array(z.string()).optional(),
+      format: FieldFormatSchema.optional(),
+      min: z.number().optional(),
+      max: z.number().optional(),
+      items: EntityFieldSchema.optional(),
+      relation: RelationConfigSchema.optional()
+    }).refine(
+      (field) => field.type !== "relation" || field.relation !== void 0,
+      { message: 'Relation config is required when type is "relation"', path: ["relation"] }
+    ).refine(
+      // Enum fields must carry their allowed values. Without this refine,
+      // the type was lying about what's valid — bare `type: 'enum'` without
+      // `values` passed zod but failed `orb validate` downstream with
+      // ORB_E_EMPTY_ENUM_VALUES, stalling the agent pipeline for 20 minutes.
+      // `enum` is the legacy field-name alias; accept either.
+      (field) => {
+        if (field.type !== "enum") return true;
+        const vals = field.values ?? field.enum;
+        return Array.isArray(vals) && vals.length > 0;
+      },
+      { message: "Enum field requires a non-empty `values` array", path: ["values"] }
+    ).refine(
+      // Array fields must describe their element shape. Bare `type: 'array'`
+      // with no `items` forces downstream consumers (builders, UI renderers,
+      // persistence) to guess, so reject it at the schema boundary.
+      (field) => {
+        if (field.type !== "array") return true;
+        return field.items !== void 0;
+      },
+      { message: "Array field requires an `items` schema describing each element", path: ["items"] }
+    )
   )
 );
 var ENTITY_ROLES = [
@@ -358,6 +397,8 @@ var RequiredFieldSchema = z.object({
 });
 z.object({
   ref: z.string().min(1),
+  // Phase 1.2: optional registry path disambiguator, pairs with `ref`.
+  from: z.string().optional(),
   linkedEntity: z.string().optional(),
   name: z.string().optional(),
   events: z.record(
@@ -723,6 +764,8 @@ var PageRefStringSchema = z.string().regex(
 );
 var PageRefObjectSchema = z.object({
   ref: PageRefStringSchema,
+  // 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()