v1.1.0: pooled runtime, 959 tests, production hardening (0 squash)

2025-08-15 10:00:00 -07:00
commit 92deb689cd
321 changed files with 79170 additions and 0 deletions
@@ -0,0 +1,42 @@
+/**
+ * Property runner input domain contracts.
+ *
+ * These types define how render inputs are supplied to a property run:
+ * either as an explicit finite enumeration (determinate) or as a
+ * generated sampled domain (sampled). The mode is always explicit.
+ *
+ * Invariant 6: every InputDomain carries its mode at the type level so
+ * downstream code cannot silently switch from enumerated to generated.
+ */
+
+// ---------------------------------------------------------------------------
+// InputDomain
+// ---------------------------------------------------------------------------
+
+export type InputDomain =
+  | { mode: 'enumerated'; values: unknown[] }
+  | { mode: 'generated'; arbitrary: unknown; seed?: number; numRuns?: number }
+
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+
+export function isEnumeratedDomain(domain: InputDomain): domain is Extract<InputDomain, { mode: 'enumerated' }> {
+  return domain.mode === 'enumerated'
+}
+
+export function isGeneratedDomain(domain: InputDomain): domain is Extract<InputDomain, { mode: 'generated' }> {
+  return domain.mode === 'generated'
+}
+
+// ---------------------------------------------------------------------------
+// Factory Helpers
+// ---------------------------------------------------------------------------
+
+export function enumeratedDomain(values: unknown[]): InputDomain {
+  return { mode: 'enumerated', values }
+}
+
+export function generatedDomain(arbitrary: unknown, options?: { seed?: number; numRuns?: number }): InputDomain {
+  return { mode: 'generated', arbitrary, seed: options?.seed, numRuns: options?.numRuns }
+}