@almadar/core 10.95.0 → 10.97.0

package/dist/mock/index.d.ts

@@ -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

@@ -924,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;
@@ -1008,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)) {