@almadar/core 10.110.0 → 10.112.0

package/dist/mock/index.d.ts

@@ -1,11 +1,11 @@
-import { O as OrbitalEntity, a as EntityPersistence, E as EntityField, F as FieldValue, g as EntityRow } from '../effect-2JoKc8Zj.js';
-import { a as OrbitalDefinition, O as OrbitalSchema } from '../schema-DqBoP7Ab.js';
-import { S as SExpr } from '../expression-DhTTuu2W.js';
-export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessPoliciesByStoreKey, b as entityAccessTable } from '../entityAccess-CuKaSX0N.js';
+import { O as OrbitalEntity, a as EntityPersistence, E as EntityField, F as FieldValue, g as EntityRow } from '../effect-B9nMpTKN.js';
+import { a as OrbitalDefinition, O as OrbitalSchema } from '../schema-C-HLTS_Q.js';
+import { S as SExpr } from '../expression-Dz84kipC.js';
+export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessPoliciesByStoreKey, b as entityAccessTable } from '../entityAccess-Ak_ZvGXZ.js';
 import 'zod';
 import '../json-D8gmyK3l.js';
-import '../trait-S5uhI089.js';
-import '../domain-Bf6sf9NR.js';
+import '../trait-CRgDZSy_.js';
+import '../domain-DV8lmH3r.js';
 
 /**
  * Lightweight seeded pseudo-random generator for mock data.
@@ -237,6 +237,8 @@ declare const RESERVED_FIELD_NAMES: ReadonlySet<string>;
 interface SampleEntity {
     readonly name: string;
     readonly persistence?: EntityPersistence;
+    /** `[identity]`: the rows are the persona roster, so every field is filled. */
+    readonly identity?: boolean;
     readonly fields: readonly EntityField[];
 }
 interface SampleContext {
@@ -246,6 +248,8 @@ interface SampleContext {
     readonly strategy: SampleStrategy;
     /** Declared persistence of the OWNING entity; undefined means persistent. */
     readonly persistence?: EntityPersistence;
+    /** The owning entity is `[identity]`: its rows are personas, never left partly unset. */
+    readonly identity?: boolean;
     readonly depth?: number;
 }
 /**
@@ -348,5 +352,14 @@ declare function linkSelfRelationField(rows: ReadonlyArray<EntityRow>, field: {
     readonly name: string;
     readonly cardinality?: string;
 }, isExcluded?: (row: EntityRow, index: number) => boolean): void;
+/**
+ * A cross-entity relation value for row `index` (0-based), deterministic and PRNG-free so every
+ * seeder links identically whatever else it draws: a scalar relation takes `targetIds[index % n]`;
+ * a list takes 2 (even rows) or 3 (odd rows) consecutive distinct ids from offset `index`. Twin of
+ * `orbital-core/src/runtime/seed.rs` `link_relation_fields`. `undefined` when there is no target.
+ */
+declare function crossRelationValue(targetIds: readonly string[], index: number, cardinality?: string): string | string[] | undefined;
+/** A relation cell a seeder may fill: missing, or the `''` / `[]` placeholder `sampleRow` writes. */
+declare function isRelationPlaceholder(value: EntityRow[string]): boolean;
 
-export { IMAGE_FIELD_NAMES, RESERVED_FIELD_NAMES, type SampleContext, type SampleEntity, type SampleStrategy, type SelfRelationForest, collectUserFieldLiterals, identityEntitiesOf, identityEntityName, identityEntityNames, isDeclaredDefaultHonored, linkSelfRelationField, ownerColumnsFromPolicy, ownerFieldsFromSchema, randomAnytimeDate, randomArrayElement, randomBoolean, randomColor, randomEmail, randomFloat, randomInt, randomPassword, randomPastDate, randomPhone, randomRecentDate, randomSentence, randomStraddlingDate, randomUrl, randomUuid, randomWords, roleSatisfyingPolicy, roleVocabularyOf, sampleFieldValue, sampleImageUrl, sampleRow, sampleRowCount, sampleRows, seedRandom, selfRelationForest, shuffleArray };
+export { IMAGE_FIELD_NAMES, RESERVED_FIELD_NAMES, type SampleContext, type SampleEntity, type SampleStrategy, type SelfRelationForest, collectUserFieldLiterals, crossRelationValue, identityEntitiesOf, identityEntityName, identityEntityNames, isDeclaredDefaultHonored, isRelationPlaceholder, linkSelfRelationField, ownerColumnsFromPolicy, ownerFieldsFromSchema, randomAnytimeDate, randomArrayElement, randomBoolean, randomColor, randomEmail, randomFloat, randomInt, randomPassword, randomPastDate, randomPhone, randomRecentDate, randomSentence, randomStraddlingDate, randomUrl, randomUuid, randomWords, roleSatisfyingPolicy, roleVocabularyOf, sampleFieldValue, sampleImageUrl, sampleRow, sampleRowCount, sampleRows, seedRandom, selfRelationForest, shuffleArray };

package/dist/mock/index.js

@@ -816,7 +816,7 @@ var SExprAtomSchema = z.union([
 var SExprSchema = z.lazy(
   () => z.union([
     SExprAtomSchema,
-    z.array(z.lazy(() => SExprSchema)).min(1).refine(
+    z.array(SExprDataSchema).min(1).refine(
       (arr) => typeof arr[0] === "string",
       { message: "S-expression array must have a string operator as first element" }
     )
@@ -953,8 +953,11 @@ function isDeclaredDefaultHonored(field, isRuntime = false) {
 function sampleRowCount(entity, requested) {
   return entity.persistence === "runtime" ? 1 : requested;
 }
+function mockCandidates(declared) {
+  return declared.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+}
 function mockFieldValue(declared, index) {
-  const candidates = declared.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  const candidates = mockCandidates(declared);
   if (candidates.length > 1) {
     return candidates[(index - 1) % candidates.length];
   }
@@ -978,12 +981,13 @@ function sampleText(field, ctx) {
   }
   return ctx.strategy === "seeded" ? titleCase(randomWords(2)) : `${titleCase(fieldName)} ${ctx.index}`;
 }
+var SEEDED_DATE_WINDOW_DAYS = 120;
 function sampleDate(ctx, dateOnly) {
   if (ctx.strategy === "index") {
     const month = String(ctx.index % 12 + 1).padStart(2, "0");
     return dateOnly ? `2026-${month}-15` : `2026-${month}-15T00:00:00.000Z`;
   }
-  const iso = randomStraddlingDate({ days: 15 }).toISOString();
+  const iso = randomStraddlingDate({ days: SEEDED_DATE_WINDOW_DAYS }).toISOString();
   return dateOnly ? iso.split("T")[0] : iso;
 }
 function sampleRelation(field) {
@@ -1011,7 +1015,8 @@ function sampleObject(field, ctx) {
   const depth = ctx.depth ?? 0;
   if (!field.properties || depth >= MAX_NESTED_DEPTH) return null;
   const out = {};
-  for (const [propName, propField] of Object.entries(field.properties)) {
+  const entries = Object.entries(field.properties).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+  for (const [propName, propField] of entries) {
     const child = { ...propField, name: propName };
     out[propName] = sampleFieldValue(child, { ...ctx, depth: depth + 1 }) ?? null;
   }
@@ -1028,7 +1033,7 @@ function sampleUnion(field, ctx) {
   return sampleFieldValue(child, { ...ctx, depth: depth + 1 });
 }
 function omitsUndefaultedOptionalFields(ctx) {
-  return ctx.strategy === "seeded" && ctx.index % 2 === 0;
+  return ctx.strategy === "seeded" && !ctx.identity && (ctx.depth ?? 0) === 0 && ctx.index % 2 === 0;
 }
 function sampleFieldValue(field, ctx) {
   const honoredDefault = field.default !== void 0 && isFieldValue(field.default) ? field.default : void 0;
@@ -1040,15 +1045,17 @@ function sampleFieldValue(field, ctx) {
   if (!field.required && field.default === void 0 && field.type !== "relation" && omitsUndefaultedOptionalFields(ctx)) {
     return void 0;
   }
+  if (field.mock !== void 0) {
+    const ordinal = isRuntime ? 1 : ctx.index;
+    const members = declaredValues(field) ? mockCandidates(field.mock) : [];
+    if (members.length > 0) return members[(ordinal - 1) % members.length];
+    return typedMockValue(field, mockFieldValue(field.mock, ordinal));
+  }
   const values = declaredValues(field);
   if (values) {
     const ordinal = isRuntime ? 1 : ctx.index;
     return values[(ordinal - 1) % values.length];
   }
-  if (field.mock !== void 0) {
-    const ordinal = isRuntime ? 1 : ctx.index;
-    return typedMockValue(field, mockFieldValue(field.mock, ordinal));
-  }
   switch (field.type) {
     case "string":
       return sampleText(field, ctx);
@@ -1112,6 +1119,8 @@ function sampleFieldValue(field, ctx) {
     case "trait":
     case "slot":
     case "pattern":
+    // An event name is authored on the owning struct, never random text (seed.rs twin).
+    case "event":
     // Renderable content is computed by the owning trait's effects, never
     // seeded — same no-sample treatment as the config-only reference types.
     case "node":
@@ -1128,7 +1137,8 @@ function sampleRow(entity, ctx) {
     const value = sampleFieldValue(field, {
       ...ctx,
       entityName: entity.name,
-      persistence: ctx.persistence ?? entity.persistence
+      persistence: ctx.persistence ?? entity.persistence,
+      ...entity.identity ? { identity: true } : {}
     });
     if (value !== void 0) row[name] = value;
   }
@@ -1167,7 +1177,24 @@ function linkSelfRelationField(rows, field, isExcluded) {
     row[field.name] = scalar ? forest.parentOf(index) : forest.childrenOf(index);
   });
 }
+var SCALAR_TARGET_CARDINALITIES = /* @__PURE__ */ new Set(["one", "many-to-one"]);
+function crossRelationValue(targetIds, index, cardinality) {
+  if (targetIds.length === 0) return void 0;
+  if (SCALAR_TARGET_CARDINALITIES.has(cardinality ?? "many")) return targetIds[index % targetIds.length];
+  const picks = [];
+  const count = Math.min(targetIds.length, 2 + index % 2);
+  for (let offset = 0; offset < count; offset++) {
+    const candidate = targetIds[(index + offset) % targetIds.length];
+    if (!picks.includes(candidate)) picks.push(candidate);
+  }
+  return picks;
+}
+function isRelationPlaceholder(value) {
+  if (value === void 0) return true;
+  if (typeof value === "string") return value === "";
+  return Array.isArray(value) && value.length === 0;
+}
 
-export { IMAGE_FIELD_NAMES, RESERVED_FIELD_NAMES, collectUserFieldLiterals, entityAccessPolicies, entityAccessPoliciesByStoreKey, entityAccessTable, identityEntitiesOf, identityEntityName, identityEntityNames, isDeclaredDefaultHonored, linkSelfRelationField, ownerColumnsFromPolicy, ownerFieldsFromSchema, randomAnytimeDate, randomArrayElement, randomBoolean, randomColor, randomEmail, randomFloat, randomInt, randomPassword, randomPastDate, randomPhone, randomRecentDate, randomSentence, randomStraddlingDate, randomUrl, randomUuid, randomWords, roleSatisfyingPolicy, roleVocabularyOf, sampleFieldValue, sampleImageUrl, sampleRow, sampleRowCount, sampleRows, seedRandom, selfRelationForest, shuffleArray };
+export { IMAGE_FIELD_NAMES, RESERVED_FIELD_NAMES, collectUserFieldLiterals, crossRelationValue, entityAccessPolicies, entityAccessPoliciesByStoreKey, entityAccessTable, identityEntitiesOf, identityEntityName, identityEntityNames, isDeclaredDefaultHonored, isRelationPlaceholder, linkSelfRelationField, ownerColumnsFromPolicy, ownerFieldsFromSchema, randomAnytimeDate, randomArrayElement, randomBoolean, randomColor, randomEmail, randomFloat, randomInt, randomPassword, randomPastDate, randomPhone, randomRecentDate, randomSentence, randomStraddlingDate, randomUrl, randomUuid, randomWords, roleSatisfyingPolicy, roleVocabularyOf, sampleFieldValue, sampleImageUrl, sampleRow, sampleRowCount, sampleRows, seedRandom, selfRelationForest, shuffleArray };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map