@almadar/core 10.36.0 → 10.38.0

package/dist/mock/index.d.ts

@@ -0,0 +1,119 @@
+import { E as EntityPersistence, a as EntityField, F as FieldValue, b as EntityRow } from '../entity-CVylqnAf.js';
+import 'zod';
+
+/**
+ * Lightweight seeded pseudo-random generator for mock data.
+ *
+ * Replaces @faker-js/faker in browser-facing code so the client bundle does
+ * not pay the ~3.7 MB faker cost. The API surface is intentionally narrow:
+ * only the helpers actually used by MockPersistenceAdapter.
+ */
+/** Re-seed the generator. Same signature as `faker.seed()`. */
+declare function seedRandom(value: number | undefined): void;
+/** Integer in [min, max]. */
+declare function randomInt({ min, max }: {
+    min: number;
+    max: number;
+}): number;
+/** Float in [min, max] with fixed fraction digits. */
+declare function randomFloat({ min, max, fractionDigits, }: {
+    min: number;
+    max: number;
+    fractionDigits?: number;
+}): number;
+/** True/false with 50% probability. */
+declare function randomBoolean(): boolean;
+/** Pick one element from an array. */
+declare function randomArrayElement<T>(array: ReadonlyArray<T>): T;
+/** Return a shallow-shuffled copy of the array (Fisher-Yates). */
+declare function shuffleArray<T>(array: ReadonlyArray<T>): T[];
+/** ISO-8601 date string roughly `years` in the past. */
+declare function randomPastDate({ years }?: {
+    years?: number;
+}): Date;
+/** ISO-8601 date string within the last `days`. */
+declare function randomRecentDate({ days }?: {
+    days?: number;
+}): Date;
+/** Any date in the last ~100 years. */
+declare function randomAnytimeDate(): Date;
+/** A few random words. */
+declare function randomWords(count: number): string;
+/** A short sentence. */
+declare function randomSentence(): string;
+/** UUID v4-like string (random, not strictly compliant). */
+declare function randomUuid(): string;
+/** Random hex color (#rrggbb). */
+declare function randomColor(): string;
+/** Random password of the given length. */
+declare function randomPassword(length?: number): string;
+/** Random email address. */
+declare function randomEmail(): string;
+/** Random URL. */
+declare function randomUrl(): string;
+/** Random phone number. */
+declare function randomPhone(): string;
+
+/**
+ * The one owner of mock-seed value synthesis.
+ *
+ * Five synthesizers used to hold four different policies on a field's declared
+ * `default`, so the same entity seeded differently depending on which path
+ * rendered it. This module is the single policy; callers supply only entropy.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Entropy source. `'seeded'` draws from the shared LCG — stateful and
+ * order-dependent, so a value depends on how many draws earlier rows consumed.
+ * `'index'` is a pure function of `(field, index)`, which is the only strategy
+ * Rust can reproduce and therefore the one parity is asserted on.
+ */
+type SampleStrategy = 'seeded' | 'index';
+interface SampleEntity {
+    readonly name: string;
+    readonly persistence?: EntityPersistence;
+    readonly fields: readonly EntityField[];
+}
+interface SampleContext {
+    readonly entityName: string;
+    /** 1-based row ordinal. Row 1 always yields `values[0]`. */
+    readonly index: number;
+    readonly strategy: SampleStrategy;
+    /** Declared persistence of the OWNING entity; undefined means persistent. */
+    readonly persistence?: EntityPersistence;
+    readonly depth?: number;
+}
+/**
+ * Image-bearing field names that still resolve to a real photo.
+ *
+ * A stopgap, kept verbatim from the two copies it replaces: no entity field in
+ * the corpus can express an image type yet, and 470 string fields are named
+ * this way, so deleting it would render broken `<img>` corpus-wide. Retire it
+ * once a real `image` type exists — not before.
+ */
+declare const IMAGE_FIELD_NAMES: ReadonlySet<string>;
+/** Deterministic stock-photo URL; the same entity+field renders the same image. */
+declare function sampleImageUrl(entityName: string, fieldName: string, ctx: SampleContext, width?: number, height?: number): string;
+/**
+ * Is `field.default` a value the synthesizer must return verbatim?
+ *
+ * Exported so codegen and tests share the one predicate rather than restating it.
+ */
+declare function isDeclaredDefaultHonored(field: EntityField): boolean;
+/** Rows to synthesize. A `[runtime]` entity is a per-orbital singleton. */
+declare function sampleRowCount(entity: SampleEntity, requested: number): number;
+/**
+ * One sample value for one field. `undefined` means OMIT the key.
+ *
+ * Order matters — see the three gates in the plan. Gates 1 and 2 read declared
+ * schema properties (`persistence`, `intrinsic`), never field names.
+ */
+declare function sampleFieldValue(field: EntityField, ctx: SampleContext): FieldValue | undefined;
+/** One row. Reserved keys are left to the caller. */
+declare function sampleRow(entity: SampleEntity, ctx: Omit<SampleContext, 'entityName' | 'depth'>): EntityRow;
+/** `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, isDeclaredDefaultHonored, randomAnytimeDate, randomArrayElement, randomBoolean, randomColor, randomEmail, randomFloat, randomInt, randomPassword, randomPastDate, randomPhone, randomRecentDate, randomSentence, randomUrl, randomUuid, randomWords, sampleFieldValue, sampleImageUrl, sampleRow, sampleRowCount, sampleRows, seedRandom, shuffleArray };