@almadar/core 10.94.0 → 10.96.0

package/dist/mock/index.d.ts

@@ -1,10 +1,10 @@
-import { O as OrbitalEntity, a as EntityPersistence, E as EntityField, F as FieldValue, g as EntityRow } from '../effect-D73ryQpY.js';
-import { a as OrbitalDefinition, O as OrbitalSchema } from '../schema-BRVT0vy-.js';
+import { O as OrbitalEntity, a as EntityPersistence, E as EntityField, F as FieldValue, g as EntityRow } from '../effect-Bw8T4qh5.js';
+import { a as OrbitalDefinition, O as OrbitalSchema } from '../schema-DPpES4qj.js';
 import { S as SExpr } from '../expression-WfTp2arD.js';
-export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessPoliciesByStoreKey, b as entityAccessTable } from '../entityAccess-B0rGIlYJ.js';
+export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessPoliciesByStoreKey, b as entityAccessTable } from '../entityAccess-DfoXs9mc.js';
 import 'zod';
 import '../json-D8gmyK3l.js';
-import '../trait-ZaXauUvA.js';
+import '../trait-DXXRrRMP.js';
 
 /**
  * Lightweight seeded pseudo-random generator for mock data.
@@ -262,8 +262,23 @@ declare function sampleImageUrl(entityName: string, fieldName: string, ctx: Samp
  * Is `field.default` a value the synthesizer must return verbatim?
  *
  * Exported so codegen and tests share the one predicate rather than restating it.
+ *
+ * `isRuntime` defaults to `false` (the persistent/multi-row behavior) —
+ * a `[runtime]` singleton's seeded row must equal its declared-defaults
+ * projection outright (gate 1: persistence must agree with the default
+ * layer in the `@entity` merge, or the machine boots into the wrong
+ * state), so ANY declared default is honored there, unconditionally.
+ * For a persistent, multi-row entity a number/boolean default is a
+ * NEW-RECORD default, not a claim about every existing row — same
+ * reasoning already applied below to a string default on a closed
+ * vocabulary (the row cycle wins over it). Honoring it verbatim made
+ * every mock-seeded counter/amount field (`hours = 0`, `debit = 0`, a
+ * runtime-only concern accidentally applied to every row of a real
+ * collection) read as literally, uniformly zero across the whole
+ * collection — confirmed 2026-09-17 across `LedgerEntry.debit/credit`,
+ * `ExecTimeEntry.hours/costRate`, `ExecCost.amount`.
  */
-declare function isDeclaredDefaultHonored(field: EntityField): boolean;
+declare function isDeclaredDefaultHonored(field: EntityField, isRuntime?: boolean): boolean;
 /** Rows to synthesize. A `[runtime]` entity is a per-orbital singleton. */
 declare function sampleRowCount(entity: SampleEntity, requested: number): number;
 /**

package/dist/mock/index.js

@@ -566,6 +566,7 @@ var EntityFieldSchema = z.lazy(() => {
     intrinsic: z.boolean().optional(),
     description: z.string().optional(),
     synonyms: z.string().optional(),
+    mock: z.string().optional(),
     mergedFrom: z.string().optional()
   };
   function scalarVariant(t) {
@@ -923,10 +924,11 @@ function declaredValues(field) {
   const values = "values" in field ? field.values : void 0;
   return values && values.length > 0 ? values : void 0;
 }
-function isDeclaredDefaultHonored(field) {
+function isDeclaredDefaultHonored(field, isRuntime = false) {
   const value = field.default;
   if (value === void 0 || value === null) return false;
-  if (typeof value === "number" || typeof value === "boolean") return true;
+  if (isRuntime) return true;
+  if (typeof value === "number" || typeof value === "boolean") return false;
   if (Array.isArray(value)) return true;
   if (typeof value === "object") return true;
   if (typeof value !== "string") return false;
@@ -937,6 +939,13 @@ function isDeclaredDefaultHonored(field) {
 function sampleRowCount(entity, requested) {
   return entity.persistence === "runtime" ? 1 : requested;
 }
+function mockFieldValue(declared, index) {
+  const candidates = declared.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (candidates.length > 1) {
+    return candidates[(index - 1) % candidates.length];
+  }
+  return `${declared.trim()}-${index}`;
+}
 function sampleText(field, ctx) {
   const fieldName = field.name ?? "field";
   if (IMAGE_FIELD_NAMES.has(fieldName.toLowerCase())) {
@@ -1000,8 +1009,7 @@ function sampleFieldValue(field, ctx) {
   const honoredDefault = field.default !== void 0 && isFieldValue(field.default) ? field.default : void 0;
   if (field.intrinsic === true) return honoredDefault;
   const isRuntime = ctx.persistence === "runtime";
-  if (isRuntime && honoredDefault !== void 0) return honoredDefault;
-  if (!isRuntime && isDeclaredDefaultHonored(field) && honoredDefault !== void 0) {
+  if (isDeclaredDefaultHonored(field, isRuntime) && honoredDefault !== void 0) {
     return honoredDefault;
   }
   if (!field.required && field.default === void 0 && field.type !== "relation" && omitsUndefaultedOptionalFields(ctx)) {
@@ -1012,6 +1020,10 @@ function sampleFieldValue(field, ctx) {
     const ordinal = isRuntime ? 1 : ctx.index;
     return values[(ordinal - 1) % values.length];
   }
+  if (field.mock !== void 0) {
+    const ordinal = isRuntime ? 1 : ctx.index;
+    return mockFieldValue(field.mock, ordinal);
+  }
   switch (field.type) {
     case "string":
       return sampleText(field, ctx);