@flock/wirespec 0.19.5 → 0.20.0-RC.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flock/wirespec",
-  "version": "0.19.5",
+  "version": "0.20.0-RC.1",
   "main": "wirespec-src-plugin-npm.mjs",
   "types": "wirespec-src-plugin-npm.d.mts",
   "devDependencies": {
@@ -30,6 +30,10 @@
       "types": "./wirespec-serialization.d.ts",
       "default": "./wirespec-serialization.mjs"
     },
+    "./generator": {
+      "types": "./wirespec-generator.d.ts",
+      "default": "./wirespec-generator.mjs"
+    },
     "./msw": {
       "types": "./wirespec-msw.d.ts",
       "default": "./wirespec-msw.mjs"

package/wirespec-generator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Wirespec.Generator backed by Kotest Arbs (Kotlin/JS), with a
+ * deterministic seed and optional constant-value path overrides.
+ *
+ * Integer-typed fields without explicit min/max bounds are drawn from the
+ * full Kotlin Long range and converted to JS numbers, so values can exceed
+ * `Number.MAX_SAFE_INTEGER` (2^53 - 1) and lose precision. For unconstrained
+ * Integer fields, prefer narrower bounds in your `.ws` source (e.g.,
+ * `Integer(0, 1000000)`) when precise round-tripping matters.
+ */
+
+export type Type = string;
+
+export interface GeneratorField<T extends any | undefined> {}
+
+export type GeneratorFieldString    = { kind: "string",    regex: string | undefined, annotations: Record<string, any>[] };
+export type GeneratorFieldInteger64 = { kind: "integer64", min: number | undefined, max: number | undefined, annotations: Record<string, any>[] };
+export type GeneratorFieldInteger32 = { kind: "integer32", min: number | undefined, max: number | undefined, annotations: Record<string, any>[] };
+export type GeneratorFieldNumber64  = { kind: "number64",  min: number | undefined, max: number | undefined, annotations: Record<string, any>[] };
+export type GeneratorFieldNumber32  = { kind: "number32",  min: number | undefined, max: number | undefined, annotations: Record<string, any>[] };
+export type GeneratorFieldBoolean = { kind: "boolean", annotations: Record<string, any>[] };
+export type GeneratorFieldBytes   = { kind: "bytes",   annotations: Record<string, any>[] };
+export type GeneratorFieldEnum    = { kind: "enum",    values: string[], annotations: Record<string, any>[], type: Type };
+export type GeneratorFieldUnion   = { kind: "union",   variants: string[], annotations: Record<string, any>[], type: Type };
+export type GeneratorFieldArray<T>    = { kind: "array",    generate: (p0: string[]) => T };
+export type GeneratorFieldNullable<T> = { kind: "nullable", generate: (p0: string[]) => T };
+export type GeneratorFieldShape<T>    = { kind: "shape",    annotations: Record<string, Record<string, any>[]>, generate: (p0: string[]) => T, type: Type };
+export type GeneratorFieldDict<V>     = { kind: "dict",     generate: (p0: string[]) => V };
+
+export interface WirespecGenerator {
+  generate<T>(path: string[], field: GeneratorField<T>): T;
+}
+
+export interface GeneratorBuilder {
+  /**
+   * Pin the value generated at an exact path. `"*"` matches any single
+   * segment (e.g. an array index): `registerPath(["users", "*", "id"], "X")`.
+   */
+  registerPath(segments: string[], value: any): void;
+}
+
+/**
+ * @param seed   Deterministic seed (0..2^31-1). Same seed + same generated
+ *               type → identical output.
+ * @param configure  Optional callback to register constant-value path
+ *               overrides on the builder.
+ */
+export declare function kotestWirespecGenerator(
+  seed?: number,
+  configure?: (builder: GeneratorBuilder) => void,
+): WirespecGenerator;

package/wirespec-generator.mjs

@@ -0,0 +1,9 @@
+// Re-exports the @JsExport facade from the bundled Kotlin/JS module under
+// the TS-friendly name. The Kotlin facade is `kotestWirespecGeneratorJs`
+// (with the `Js` suffix) so it doesn't collide with the Kotlin DSL function
+// of the same root name in commonMain.
+import { kotestWirespecGeneratorJs } from './wirespec-src-integration-kotest.mjs';
+
+export function kotestWirespecGenerator(seed = 0, configure) {
+    return kotestWirespecGeneratorJs(seed, configure);
+}