@almadar/core 10.89.0 → 10.91.0

package/dist/mock/index.d.ts

@@ -1,10 +1,10 @@
-import { f as OrbitalEntity, a as EntityPersistence, E as EntityField, F as FieldValue, g as EntityRow } from '../effect-CdLBg9zL.js';
-import { a as OrbitalDefinition, O as OrbitalSchema } from '../schema-DYC_RnBX.js';
+import { f as OrbitalEntity, a as EntityPersistence, E as EntityField, F as FieldValue, g as EntityRow } from '../effect-Bt8vKHwd.js';
+import { a as OrbitalDefinition, O as OrbitalSchema } from '../schema-ovDTDQz9.js';
 import { S as SExpr } from '../expression-WfTp2arD.js';
-export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessPoliciesByStoreKey, b as entityAccessTable } from '../entityAccess-BmZHpQUv.js';
+export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessPoliciesByStoreKey, b as entityAccessTable } from '../entityAccess-BdDX85rM.js';
 import 'zod';
 import '../json-D8gmyK3l.js';
-import '../trait-DmWdtKlP.js';
+import '../trait-C3e3btfn.js';
 
 /**
  * Lightweight seeded pseudo-random generator for mock data.
@@ -227,6 +227,12 @@ declare function roleSatisfyingPolicy(policy: SExpr | undefined, identity: Orbit
  * Rust can reproduce and therefore the one parity is asserted on.
  */
 type SampleStrategy = 'seeded' | 'index';
+/** Framework-stamped columns — the row's id and audit timestamps, minted by
+ *  the store itself, never synthesized here and never a REQUIRED column a
+ *  caller must supply (`EffectExecutor`'s persist-create check, `@almadar/
+ *  runtime`'s mock store stamping). The one owner; every caller imports this
+ *  instead of repeating the name list. */
+declare const RESERVED_FIELD_NAMES: ReadonlySet<string>;
 interface SampleEntity {
     readonly name: string;
     readonly persistence?: EntityPersistence;
@@ -278,4 +284,53 @@ declare function sampleRow(entity: SampleEntity, ctx: Omit<SampleContext, 'entit
 /** `count` rows, 1-based, honoring the runtime-singleton gate. */
 declare function sampleRows(entity: SampleEntity, count: number, strategy: SampleStrategy): EntityRow[];
 
-export { IMAGE_FIELD_NAMES, type SampleContext, type SampleEntity, type SampleStrategy, collectUserFieldLiterals, identityEntitiesOf, identityEntityName, identityEntityNames, isDeclaredDefaultHonored, 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, shuffleArray };
+/**
+ * Deterministic self-relation forest — the ONE seeding policy for a
+ * self-referential relation field (`Tag.parentId : Tag`, `ChatMessage.replies
+ * : [ChatMessage]`), shared by every mock seeder.
+ *
+ * Before this module each seeder invented its own policy: the interpreted
+ * path (`MockPersistenceAdapter`) built a deterministic binary forest for
+ * `one`/`many-to-one` self-relations but handed `many` self-relations 2-4
+ * RANDOM other-row ids, and the compiled path's seeder (`MockDataService`)
+ * assigned every relation field — self or cross-entity, any cardinality — one
+ * random id with no forest at all. Random cross-linking on a `many`
+ * self-relation means every row ends up referenced by several others, so
+ * under a default `onDelete: restrict` policy nothing is ever deletable — the
+ * `std-realtime-chat` `ChatMessage.replies` case this module fixes.
+ *
+ * The forest guarantees exactly one root (row 0, never referenced by any
+ * other row) and no cycles: row *i*'s parent is always row ⌊(i−1)/2⌋, a
+ * strictly smaller index.
+ *
+ * @packageDocumentation
+ */
+
+/** Parent/children lookups over `rowIds`, in binary-forest order. */
+interface SelfRelationForest {
+    /** Row *i*'s parent id, or `''` for the root (row 0). */
+    parentOf: (index: number) => string | '';
+    /** The (0, 1, or 2) ids of rows whose parent is row *i*. */
+    childrenOf: (index: number) => string[];
+}
+/**
+ * Build the forest over a set of already-generated row ids. Deterministic —
+ * the same `rowIds` array always produces the same forest, no PRNG involved.
+ */
+declare function selfRelationForest(rowIds: readonly string[]): SelfRelationForest;
+/**
+ * Write a self-relation field over the forest derived from `rows`' own ids —
+ * the scalar parent form for `one`/`many-to-one`, the children-id-list form
+ * for `many`/`one-to-many`/`many-to-many`.
+ *
+ * `isExcluded`, when given, is asked per row/index before writing; each
+ * seeder passes in whatever cell it has already deliberately stamped (an
+ * owner column, a pre-authored value) so this pass never overwrites it — the
+ * exclusion RULE stays with the caller, who alone knows what it stamped.
+ */
+declare function linkSelfRelationField(rows: ReadonlyArray<EntityRow>, field: {
+    readonly name: string;
+    readonly cardinality?: string;
+}, isExcluded?: (row: EntityRow, index: number) => boolean): void;
+
+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 };

package/dist/mock/index.js

@@ -573,7 +573,8 @@ var EntityFieldSchema = z.lazy(() => {
     properties: z.record(EntityFieldSchema).optional(),
     intrinsic: z.boolean().optional(),
     description: z.string().optional(),
-    synonyms: z.string().optional()
+    synonyms: z.string().optional(),
+    mergedFrom: z.string().optional()
   };
   function scalarVariant(t) {
     return z.object({
@@ -670,7 +671,7 @@ var VISUAL_STYLES = ["pixel", "vector", "hd", "1-bit", "isometric"];
 var VisualStyleSchema = z.enum(VISUAL_STYLES);
 var ASSET_DIMENSIONS = ["2d", "3d"];
 var AssetDimensionSchema = z.enum(ASSET_DIMENSIONS);
-var ASSET_ASPECTS = ["1:1", "16:9", "5:7", "8:1"];
+var ASSET_ASPECTS = ["1:1", "16:9", "5:7", "8:1", "4:1", "5:3", "1:2"];
 var AssetAspectSchema = z.enum(ASSET_ASPECTS);
 var ANIMATION_NAMES = ["idle", "walk", "skate", "jump", "fall", "attack", "hit", "death"];
 z.enum(ANIMATION_NAMES);
@@ -740,7 +741,9 @@ SemanticAssetRefSchema.extend({
   atlas: z.string().optional(),
   sprite: z.string().optional(),
   name: z.string().optional(),
-  thumbnailUrl: z.string().optional()
+  thumbnailUrl: z.string().optional(),
+  prompt: z.string().optional(),
+  choreography: z.record(z.string(), z.array(z.string())).optional()
 });
 var AssetCatalogEntrySchema = z.object({
   url: z.string(),
@@ -870,6 +873,9 @@ z.object({
   visual_prompt: z.string().optional(),
   assetRef: SemanticAssetRefSchema.optional()
 });
+var FieldValueSchema = z.lazy(
+  () => z.union([z.string(), z.number(), z.boolean(), z.date(), z.null(), z.array(FieldValueSchema), z.record(FieldValueSchema.optional())])
+);
 function isFieldValue(value) {
   if (value === null) return true;
   const kind = typeof value;
@@ -1108,6 +1114,31 @@ function sampleRows(entity, count, strategy) {
   return rows;
 }
 
-export { IMAGE_FIELD_NAMES, collectUserFieldLiterals, entityAccessPolicies, entityAccessPoliciesByStoreKey, entityAccessTable, identityEntitiesOf, identityEntityName, identityEntityNames, isDeclaredDefaultHonored, 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, shuffleArray };
+// src/mock/relationForest.ts
+function selfRelationForest(rowIds) {
+  return {
+    parentOf: (index) => index === 0 ? "" : rowIds[Math.floor((index - 1) / 2)] ?? "",
+    childrenOf: (index) => {
+      const children = [];
+      const left = 2 * index + 1;
+      const right = 2 * index + 2;
+      if (left < rowIds.length) children.push(rowIds[left]);
+      if (right < rowIds.length) children.push(rowIds[right]);
+      return children;
+    }
+  };
+}
+var SCALAR_PARENT_CARDINALITIES = /* @__PURE__ */ new Set(["one", "many-to-one"]);
+function linkSelfRelationField(rows, field, isExcluded) {
+  const rowIds = rows.map((row) => row.id ?? "");
+  const forest = selfRelationForest(rowIds);
+  const scalar = SCALAR_PARENT_CARDINALITIES.has(field.cardinality ?? "many");
+  rows.forEach((row, index) => {
+    if (isExcluded?.(row, index)) return;
+    row[field.name] = scalar ? forest.parentOf(index) : forest.childrenOf(index);
+  });
+}
+
+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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map