@almadar/core 10.109.0 → 10.111.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-Cv7k1MTO.js';
-import { a as OrbitalDefinition, O as OrbitalSchema } from '../schema-Chi9QIcZ.js';
-import { S as SExpr } from '../expression-C6Gs_c5b.js';
-export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessPoliciesByStoreKey, b as entityAccessTable } from '../entityAccess-CH8vC2OG.js';
+import { O as OrbitalEntity, a as EntityPersistence, E as EntityField, F as FieldValue, g as EntityRow } from '../effect-BD47AL48.js';
+import { a as OrbitalDefinition, O as OrbitalSchema } from '../schema-B3GE83sz.js';
+import { S as SExpr } from '../expression-Dz84kipC.js';
+export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessPoliciesByStoreKey, b as entityAccessTable } from '../entityAccess-Dc6o3AYo.js';
 import 'zod';
 import '../json-D8gmyK3l.js';
-import '../trait-A_OGE8xT.js';
-import '../domain-DYverojF.js';
+import '../trait-BNxIGRUF.js';
+import '../domain-Bf6sf9NR.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" }
     )
@@ -1011,7 +1011,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 +1029,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;
@@ -1112,6 +1113,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 +1131,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 +1171,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