foldkit-form 0.4.3 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { Duration, Effect, Option, Schema } from "effect";
2
2
  import { Bundle } from "foldkit-bundle";
3
- import { AnyEntity, EntityInput, InputMember, NestedInput } from "foldkit-entity";
3
+ import { AnyEntity, Entity, EntityInput, InputMember, NestedInput } from "foldkit-entity";
4
4
  import { Metadata } from "foldkit-metadata";
5
5
  import { Command } from "foldkit/command";
6
6
  import * as FieldValidation from "foldkit/fieldValidation";
@@ -94,6 +94,15 @@ interface NestedForm {
94
94
  readonly RowRemoved: (payload: never) => unknown;
95
95
  };
96
96
  }
97
+ /** A kind of control. The kinds below are made with it, and so is an application's. */
98
+ declare const kind: <Data = Record<string, never>>(name: string, spec: {
99
+ readonly draft: DraftKind;
100
+ readonly shown?: boolean;
101
+ readonly searches?: boolean | ((data: Data) => boolean);
102
+ /** The value a text draft stands for, given the control's data; `undefined` when it stands for none. */
103
+ readonly parse?: (draft: string, data: Data) => unknown;
104
+ readonly unparsed?: string;
105
+ }) => ControlKind<Data>;
97
106
  /**
98
107
  * What a control backed by a Bundle carries: the Bundle, its args, and how the
99
108
  * key's value is read from its Model and written into it.
@@ -159,14 +168,7 @@ export declare const Input: {
159
168
  * gives `.of(data)` to make one and `.is(control)` to tell one, exactly as the
160
169
  * kinds below were made. A view draws it once it is given a renderer for `Date`.
161
170
  */
162
- kind: <Data = Record<string, never>>(name: string, spec: {
163
- readonly draft: DraftKind;
164
- readonly shown?: boolean;
165
- readonly searches?: boolean | ((data: Data) => boolean);
166
- /** The value a text draft stands for, given the control's data; `undefined` when it stands for none. */
167
- readonly parse?: (draft: string, data: Data) => unknown;
168
- readonly unparsed?: string;
169
- }) => ControlKind<Data>;
171
+ kind: typeof kind;
170
172
  Text: ControlKind<Record<string, never>>;
171
173
  Hidden: ControlKind<Record<string, never>>;
172
174
  Multiline: ControlKind<Record<string, never>>;
@@ -426,6 +428,12 @@ export type ChecksFor<F extends Remakeable> = { readonly [K in Exclude<keyof F['
426
428
  /** What a set of checks needs between them, read off the functions that were given. */
427
429
  export type RequirementOf<C> = { [K in keyof C]: C[K] extends ((...args: never) => Effect.Effect<any, any, infer R>) ? R : never; }[keyof C];
428
430
  declare const Core: {
431
+ /**
432
+ * The input of a form that writes no Entity of its own (a sign-up, a search,
433
+ * a login): `Entity.input` over an Entity defined from the same schema, so
434
+ * every key maps itself. `Form.make('Waitlist', Form.input(JoinWaitlist))`.
435
+ */
436
+ input: <Fields extends Schema.Struct.Fields>(schema: Schema.Struct<Fields>) => EntityInput<Entity<"FormInput", Fields, {}, {}>, Fields, { readonly [K in keyof Fields]: K extends never ? {}[K] extends (infer T) ? T extends {}[K] ? T extends string ? T extends keyof Fields & string ? { readonly [K_1 in keyof Fields & string]: import("foldkit-entity").EntityField<"FormInput", K_1, Fields[K_1]>; }[T] : T extends never ? import("foldkit-entity").RelationInput<{}[T]> : `"${T}" names no field or relation of FormInput` : T : never : never : K extends keyof Fields & string ? { readonly [K_1 in keyof Fields & string]: import("foldkit-entity").EntityField<"FormInput", K_1, Fields[K_1]>; }[K] : never; }>;
429
437
  /**
430
438
  * A form for one operation's input. A key mapped with `Relation.nested` holds
431
439
  * rows of a form of its own, built here from the nested input; every other key
@@ -433,46 +441,73 @@ declare const Core: {
433
441
  * words, the checks.
434
442
  */
435
443
  make: <const Name extends string, E extends AnyEntity, Fields extends Schema.Struct.Fields, Members extends { readonly [K in keyof Fields]: InputMember; }, R = never, const Nest extends NestedForms<Fields, Members, R> = {}, const Inputs extends InputsFor<Fields, Members> = {}>(name: Name, input: EntityInput<E, Fields, Members>, options?: FormOptions<Fields, Members, R, Nest, Inputs>) => {
444
+ pipe<A>(this: A): A;
445
+ pipe<A, B = never>(this: A, ab: (_: A) => B): B;
446
+ pipe<A, B = never, C = never>(this: A, ab: (_: A) => B, bc: (_: B) => C): C;
447
+ pipe<A, B = never, C = never, D = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D): D;
448
+ pipe<A, B = never, C = never, D = never, E_1 = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1): E_1;
449
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F): F;
450
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G): G;
451
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H): H;
452
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I): I;
453
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J): J;
454
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K): K;
455
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L): L;
456
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M): M;
457
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N): N;
458
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O): O;
459
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P): P;
460
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q): Q;
461
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1): R_1;
462
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never, S = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1, rs: (_: R_1) => S): S;
463
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never, S = never, T = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1, rs: (_: R_1) => S, st: (_: S) => T): T;
464
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never, S = never, T = never, U = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1, rs: (_: R_1) => S, st: (_: S) => T, tu: (_: T) => U): U;
465
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never, S = never, T = never, U = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1, rs: (_: R_1) => S, st: (_: S) => T, tu: (_: T) => U): U;
466
+ /** The name, input and options the form was made from: what a pipe step makes the next form from. */
467
+ name: Name;
468
+ options: FormOptions<Fields, Members, R, Nest, Inputs>;
469
+ /** Type-only: the form's type parameters, for a pipe step to read. Never set. */
470
+ types: {
471
+ readonly Name: Name;
472
+ readonly E: E;
473
+ readonly Fields: Fields;
474
+ readonly Members: Members;
475
+ readonly R: R;
476
+ readonly Nest: Nest;
477
+ readonly Inputs: Inputs;
478
+ };
436
479
  bundle: Bundle.Bundle<Name, void, FormModel<Fields, Members, ControlsOf<Inputs>>, {
437
- readonly _tag: "Changed";
438
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
439
- readonly value: string | boolean | readonly string[];
480
+ readonly _tag: "About";
481
+ readonly subject: {
482
+ readonly [x: string]: string;
483
+ };
440
484
  } | {
441
485
  readonly _tag: "Blurred";
442
486
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
443
487
  } | {
444
- readonly _tag: "ValidatedAll";
445
- } | {
446
- readonly _tag: "Submitted";
447
- } | {
448
- readonly _tag: "Reset";
488
+ readonly _tag: "Changed";
489
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
490
+ readonly value: string | boolean | readonly string[];
449
491
  } | {
450
492
  readonly _tag: "Checked";
451
493
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
452
494
  readonly draft: string | boolean | readonly string[];
453
495
  readonly error: string | null;
454
496
  } | {
455
- readonly _tag: "Refused";
456
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
457
- readonly error: string;
458
- } | {
459
- readonly _tag: "About";
460
- readonly subject: {
461
- readonly [x: string]: string;
462
- };
463
- } | {
464
- readonly _tag: "Searched";
465
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
466
- readonly text: string;
497
+ readonly _tag: "Control";
498
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
499
+ readonly message: unknown;
467
500
  } | {
468
501
  readonly _tag: "Nested";
469
502
  readonly key: string;
470
503
  readonly row: string;
471
504
  readonly message: unknown;
472
505
  } | {
473
- readonly _tag: "Control";
474
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
475
- readonly message: unknown;
506
+ readonly _tag: "Refused";
507
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
508
+ readonly error: string;
509
+ } | {
510
+ readonly _tag: "Reset";
476
511
  } | {
477
512
  readonly _tag: "RowAdded";
478
513
  readonly key: string;
@@ -480,6 +515,14 @@ declare const Core: {
480
515
  readonly _tag: "RowRemoved";
481
516
  readonly key: string;
482
517
  readonly row: string;
518
+ } | {
519
+ readonly _tag: "Searched";
520
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
521
+ readonly text: string;
522
+ } | {
523
+ readonly _tag: "Submitted";
524
+ } | {
525
+ readonly _tag: "ValidatedAll";
483
526
  }, Submitted<Schema.Struct.View<Fields, "Type", Schema.Struct.TypeOptionalKeys<Fields>, Schema.Struct.TypeMutableKeys<Fields>>>, R, never, void, ControlResourcesOf<Inputs>, {
484
527
  fill: (model: FormModel<Fields, Members, ControlsOf<Inputs>>, values: Partial<Schema.Struct.View<Fields, "Type", Schema.Struct.TypeOptionalKeys<Fields>, Schema.Struct.TypeMutableKeys<Fields>>>) => {
485
528
  readonly model: FormModel<Fields, Members, ControlsOf<Inputs>>;
@@ -557,6 +600,18 @@ declare const Core: {
557
600
  row: Schema.String;
558
601
  };
559
602
  }>;
603
+ /** The Command a key's check runs as, for a test to resolve (`Command.resolve(form.Check, …)`). */
604
+ Check: import("foldkit/command").CommandDefinitionWithArgs<`${Name}.check`, {
605
+ key: Schema.Literals<readonly [Exclude<keyof Fields & string, NestedKey<Members>>, ...Exclude<keyof Fields & string, NestedKey<Members>>[]]>;
606
+ draft: Schema.Union<readonly [Schema.String, Schema.Boolean, Schema.$Array<Schema.String>]>;
607
+ values: Schema.Unknown;
608
+ subject: Schema.$Record<Schema.String, Schema.String>;
609
+ }, Effect.Effect<{
610
+ readonly _tag: "Checked";
611
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
612
+ readonly draft: string | boolean | readonly string[];
613
+ readonly error: string | null;
614
+ }, never, R>>;
560
615
  /** The reading the form was made from, for `Entity.selectFor` and `Entity.valuesFor`. */
561
616
  input: EntityInput<E, Fields, Members>;
562
617
  /** Whether a completed transition changed authored content. See the note above. */
@@ -583,45 +638,37 @@ declare const Core: {
583
638
  control: <K extends keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>>(key: K) => {
584
639
  readonly field: (model: FormModel<Fields, Members, ControlsOf<Inputs>>) => { readonly [K_1 in keyof Fields as K_1 extends NestedKey<Members> ? never : K_1]: FieldValidation.Field<K_1 extends keyof ControlsOf<Inputs> ? ControlsOf<Inputs>[K_1] : DraftOf<Schema.Schema.Type<Fields[K_1]>>>; }[K];
585
640
  readonly send: (message: ControlMessageOf<Inputs[K]>) => {
586
- readonly _tag: "Changed";
587
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
588
- readonly value: string | boolean | readonly string[];
641
+ readonly _tag: "About";
642
+ readonly subject: {
643
+ readonly [x: string]: string;
644
+ };
589
645
  } | {
590
646
  readonly _tag: "Blurred";
591
647
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
592
648
  } | {
593
- readonly _tag: "ValidatedAll";
594
- } | {
595
- readonly _tag: "Submitted";
596
- } | {
597
- readonly _tag: "Reset";
649
+ readonly _tag: "Changed";
650
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
651
+ readonly value: string | boolean | readonly string[];
598
652
  } | {
599
653
  readonly _tag: "Checked";
600
654
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
601
655
  readonly draft: string | boolean | readonly string[];
602
656
  readonly error: string | null;
603
657
  } | {
604
- readonly _tag: "Refused";
605
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
606
- readonly error: string;
607
- } | {
608
- readonly _tag: "About";
609
- readonly subject: {
610
- readonly [x: string]: string;
611
- };
612
- } | {
613
- readonly _tag: "Searched";
614
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
615
- readonly text: string;
658
+ readonly _tag: "Control";
659
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
660
+ readonly message: unknown;
616
661
  } | {
617
662
  readonly _tag: "Nested";
618
663
  readonly key: string;
619
664
  readonly row: string;
620
665
  readonly message: unknown;
621
666
  } | {
622
- readonly _tag: "Control";
623
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
624
- readonly message: unknown;
667
+ readonly _tag: "Refused";
668
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
669
+ readonly error: string;
670
+ } | {
671
+ readonly _tag: "Reset";
625
672
  } | {
626
673
  readonly _tag: "RowAdded";
627
674
  readonly key: string;
@@ -629,6 +676,14 @@ declare const Core: {
629
676
  readonly _tag: "RowRemoved";
630
677
  readonly key: string;
631
678
  readonly row: string;
679
+ } | {
680
+ readonly _tag: "Searched";
681
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
682
+ readonly text: string;
683
+ } | {
684
+ readonly _tag: "Submitted";
685
+ } | {
686
+ readonly _tag: "ValidatedAll";
632
687
  };
633
688
  };
634
689
  /** What was typed to find a choice for a relation key that searches; `''` until something is. */
@@ -645,45 +700,37 @@ declare const Core: {
645
700
  * is this form's Message for that edit in that row.
646
701
  */
647
702
  row: <K extends Extract<keyof Fields & string, NestedKey<Members>>>(key: K, row: string) => RowHandle<K extends keyof Nest ? NonNullable<Nest[K]> : NestedForm, {
648
- readonly _tag: "Changed";
649
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
650
- readonly value: string | boolean | readonly string[];
703
+ readonly _tag: "About";
704
+ readonly subject: {
705
+ readonly [x: string]: string;
706
+ };
651
707
  } | {
652
708
  readonly _tag: "Blurred";
653
709
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
654
710
  } | {
655
- readonly _tag: "ValidatedAll";
656
- } | {
657
- readonly _tag: "Submitted";
658
- } | {
659
- readonly _tag: "Reset";
711
+ readonly _tag: "Changed";
712
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
713
+ readonly value: string | boolean | readonly string[];
660
714
  } | {
661
715
  readonly _tag: "Checked";
662
716
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
663
717
  readonly draft: string | boolean | readonly string[];
664
718
  readonly error: string | null;
665
719
  } | {
666
- readonly _tag: "Refused";
667
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
668
- readonly error: string;
669
- } | {
670
- readonly _tag: "About";
671
- readonly subject: {
672
- readonly [x: string]: string;
673
- };
674
- } | {
675
- readonly _tag: "Searched";
676
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
677
- readonly text: string;
720
+ readonly _tag: "Control";
721
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
722
+ readonly message: unknown;
678
723
  } | {
679
724
  readonly _tag: "Nested";
680
725
  readonly key: string;
681
726
  readonly row: string;
682
727
  readonly message: unknown;
683
728
  } | {
684
- readonly _tag: "Control";
685
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
686
- readonly message: unknown;
729
+ readonly _tag: "Refused";
730
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
731
+ readonly error: string;
732
+ } | {
733
+ readonly _tag: "Reset";
687
734
  } | {
688
735
  readonly _tag: "RowAdded";
689
736
  readonly key: string;
@@ -691,6 +738,14 @@ declare const Core: {
691
738
  readonly _tag: "RowRemoved";
692
739
  readonly key: string;
693
740
  readonly row: string;
741
+ } | {
742
+ readonly _tag: "Searched";
743
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
744
+ readonly text: string;
745
+ } | {
746
+ readonly _tag: "Submitted";
747
+ } | {
748
+ readonly _tag: "ValidatedAll";
694
749
  }>;
695
750
  /**
696
751
  * Whether a key that follows another still does: `false` once the author has
@@ -739,45 +794,37 @@ declare const Core: {
739
794
  args?: Record<string, unknown>;
740
795
  key?: string;
741
796
  effect: Effect.Effect<{
742
- readonly _tag: "Changed";
743
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
744
- readonly value: string | boolean | readonly string[];
797
+ readonly _tag: "About";
798
+ readonly subject: {
799
+ readonly [x: string]: string;
800
+ };
745
801
  } | {
746
802
  readonly _tag: "Blurred";
747
803
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
748
804
  } | {
749
- readonly _tag: "ValidatedAll";
750
- } | {
751
- readonly _tag: "Submitted";
752
- } | {
753
- readonly _tag: "Reset";
805
+ readonly _tag: "Changed";
806
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
807
+ readonly value: string | boolean | readonly string[];
754
808
  } | {
755
809
  readonly _tag: "Checked";
756
810
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
757
811
  readonly draft: string | boolean | readonly string[];
758
812
  readonly error: string | null;
759
813
  } | {
760
- readonly _tag: "Refused";
761
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
762
- readonly error: string;
763
- } | {
764
- readonly _tag: "About";
765
- readonly subject: {
766
- readonly [x: string]: string;
767
- };
768
- } | {
769
- readonly _tag: "Searched";
770
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
771
- readonly text: string;
814
+ readonly _tag: "Control";
815
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
816
+ readonly message: unknown;
772
817
  } | {
773
818
  readonly _tag: "Nested";
774
819
  readonly key: string;
775
820
  readonly row: string;
776
821
  readonly message: unknown;
777
822
  } | {
778
- readonly _tag: "Control";
779
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
780
- readonly message: unknown;
823
+ readonly _tag: "Refused";
824
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
825
+ readonly error: string;
826
+ } | {
827
+ readonly _tag: "Reset";
781
828
  } | {
782
829
  readonly _tag: "RowAdded";
783
830
  readonly key: string;
@@ -785,6 +832,14 @@ declare const Core: {
785
832
  readonly _tag: "RowRemoved";
786
833
  readonly key: string;
787
834
  readonly row: string;
835
+ } | {
836
+ readonly _tag: "Searched";
837
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
838
+ readonly text: string;
839
+ } | {
840
+ readonly _tag: "Submitted";
841
+ } | {
842
+ readonly _tag: "ValidatedAll";
788
843
  }, never, R>;
789
844
  }>[];
790
845
  };
@@ -795,45 +850,37 @@ declare const Core: {
795
850
  args?: Record<string, unknown>;
796
851
  key?: string;
797
852
  effect: Effect.Effect<{
798
- readonly _tag: "Changed";
799
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
800
- readonly value: string | boolean | readonly string[];
853
+ readonly _tag: "About";
854
+ readonly subject: {
855
+ readonly [x: string]: string;
856
+ };
801
857
  } | {
802
858
  readonly _tag: "Blurred";
803
859
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
804
860
  } | {
805
- readonly _tag: "ValidatedAll";
806
- } | {
807
- readonly _tag: "Submitted";
808
- } | {
809
- readonly _tag: "Reset";
861
+ readonly _tag: "Changed";
862
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
863
+ readonly value: string | boolean | readonly string[];
810
864
  } | {
811
865
  readonly _tag: "Checked";
812
866
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
813
867
  readonly draft: string | boolean | readonly string[];
814
868
  readonly error: string | null;
815
869
  } | {
816
- readonly _tag: "Refused";
817
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
818
- readonly error: string;
819
- } | {
820
- readonly _tag: "About";
821
- readonly subject: {
822
- readonly [x: string]: string;
823
- };
824
- } | {
825
- readonly _tag: "Searched";
826
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
827
- readonly text: string;
870
+ readonly _tag: "Control";
871
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
872
+ readonly message: unknown;
828
873
  } | {
829
874
  readonly _tag: "Nested";
830
875
  readonly key: string;
831
876
  readonly row: string;
832
877
  readonly message: unknown;
833
878
  } | {
834
- readonly _tag: "Control";
835
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
836
- readonly message: unknown;
879
+ readonly _tag: "Refused";
880
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
881
+ readonly error: string;
882
+ } | {
883
+ readonly _tag: "Reset";
837
884
  } | {
838
885
  readonly _tag: "RowAdded";
839
886
  readonly key: string;
@@ -841,6 +888,14 @@ declare const Core: {
841
888
  readonly _tag: "RowRemoved";
842
889
  readonly key: string;
843
890
  readonly row: string;
891
+ } | {
892
+ readonly _tag: "Searched";
893
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
894
+ readonly text: string;
895
+ } | {
896
+ readonly _tag: "Submitted";
897
+ } | {
898
+ readonly _tag: "ValidatedAll";
844
899
  }, never, R>;
845
900
  }>[];
846
901
  };
@@ -850,41 +905,6 @@ declare const Core: {
850
905
  /** The decoded input when every key and row is valid as it stands; validates nothing. */
851
906
  value: (model: FormModel<Fields, Members, ControlsOf<Inputs>>) => Schema.Struct.View<Fields, "Type", Schema.Struct.TypeOptionalKeys<Fields>, Schema.Struct.TypeMutableKeys<Fields>> | undefined;
852
907
  };
853
- pipe<A>(this: A): A;
854
- pipe<A, B = never>(this: A, ab: (_: A) => B): B;
855
- pipe<A, B_1 = never, C = never>(this: A, ab: (_: A) => B_1, bc: (_: B_1) => C): C;
856
- pipe<A, B_2 = never, C_1 = never, D = never>(this: A, ab: (_: A) => B_2, bc: (_: B_2) => C_1, cd: (_: C_1) => D): D;
857
- pipe<A, B_3 = never, C_2 = never, D_1 = never, E_1 = never>(this: A, ab: (_: A) => B_3, bc: (_: B_3) => C_2, cd: (_: C_2) => D_1, de: (_: D_1) => E_1): E_1;
858
- pipe<A, B_4 = never, C_3 = never, D_2 = never, E_2 = never, F = never>(this: A, ab: (_: A) => B_4, bc: (_: B_4) => C_3, cd: (_: C_3) => D_2, de: (_: D_2) => E_2, ef: (_: E_2) => F): F;
859
- pipe<A, B_5 = never, C_4 = never, D_3 = never, E_3 = never, F_1 = never, G = never>(this: A, ab: (_: A) => B_5, bc: (_: B_5) => C_4, cd: (_: C_4) => D_3, de: (_: D_3) => E_3, ef: (_: E_3) => F_1, fg: (_: F_1) => G): G;
860
- pipe<A, B_6 = never, C_5 = never, D_4 = never, E_4 = never, F_2 = never, G_1 = never, H = never>(this: A, ab: (_: A) => B_6, bc: (_: B_6) => C_5, cd: (_: C_5) => D_4, de: (_: D_4) => E_4, ef: (_: E_4) => F_2, fg: (_: F_2) => G_1, gh: (_: G_1) => H): H;
861
- pipe<A, B_7 = never, C_6 = never, D_5 = never, E_5 = never, F_3 = never, G_2 = never, H_1 = never, I = never>(this: A, ab: (_: A) => B_7, bc: (_: B_7) => C_6, cd: (_: C_6) => D_5, de: (_: D_5) => E_5, ef: (_: E_5) => F_3, fg: (_: F_3) => G_2, gh: (_: G_2) => H_1, hi: (_: H_1) => I): I;
862
- pipe<A, B_8 = never, C_7 = never, D_6 = never, E_6 = never, F_4 = never, G_3 = never, H_2 = never, I_1 = never, J = never>(this: A, ab: (_: A) => B_8, bc: (_: B_8) => C_7, cd: (_: C_7) => D_6, de: (_: D_6) => E_6, ef: (_: E_6) => F_4, fg: (_: F_4) => G_3, gh: (_: G_3) => H_2, hi: (_: H_2) => I_1, ij: (_: I_1) => J): J;
863
- pipe<A, B_9 = never, C_8 = never, D_7 = never, E_7 = never, F_5 = never, G_4 = never, H_3 = never, I_2 = never, J_1 = never, K = never>(this: A, ab: (_: A) => B_9, bc: (_: B_9) => C_8, cd: (_: C_8) => D_7, de: (_: D_7) => E_7, ef: (_: E_7) => F_5, fg: (_: F_5) => G_4, gh: (_: G_4) => H_3, hi: (_: H_3) => I_2, ij: (_: I_2) => J_1, jk: (_: J_1) => K): K;
864
- pipe<A, B_10 = never, C_9 = never, D_8 = never, E_8 = never, F_6 = never, G_5 = never, H_4 = never, I_3 = never, J_2 = never, K_1 = never, L = never>(this: A, ab: (_: A) => B_10, bc: (_: B_10) => C_9, cd: (_: C_9) => D_8, de: (_: D_8) => E_8, ef: (_: E_8) => F_6, fg: (_: F_6) => G_5, gh: (_: G_5) => H_4, hi: (_: H_4) => I_3, ij: (_: I_3) => J_2, jk: (_: J_2) => K_1, kl: (_: K_1) => L): L;
865
- pipe<A, B_11 = never, C_10 = never, D_9 = never, E_9 = never, F_7 = never, G_6 = never, H_5 = never, I_4 = never, J_3 = never, K_2 = never, L_1 = never, M = never>(this: A, ab: (_: A) => B_11, bc: (_: B_11) => C_10, cd: (_: C_10) => D_9, de: (_: D_9) => E_9, ef: (_: E_9) => F_7, fg: (_: F_7) => G_6, gh: (_: G_6) => H_5, hi: (_: H_5) => I_4, ij: (_: I_4) => J_3, jk: (_: J_3) => K_2, kl: (_: K_2) => L_1, lm: (_: L_1) => M): M;
866
- pipe<A, B_12 = never, C_11 = never, D_10 = never, E_10 = never, F_8 = never, G_7 = never, H_6 = never, I_5 = never, J_4 = never, K_3 = never, L_2 = never, M_1 = never, N = never>(this: A, ab: (_: A) => B_12, bc: (_: B_12) => C_11, cd: (_: C_11) => D_10, de: (_: D_10) => E_10, ef: (_: E_10) => F_8, fg: (_: F_8) => G_7, gh: (_: G_7) => H_6, hi: (_: H_6) => I_5, ij: (_: I_5) => J_4, jk: (_: J_4) => K_3, kl: (_: K_3) => L_2, lm: (_: L_2) => M_1, mn: (_: M_1) => N): N;
867
- pipe<A, B_13 = never, C_12 = never, D_11 = never, E_11 = never, F_9 = never, G_8 = never, H_7 = never, I_6 = never, J_5 = never, K_4 = never, L_3 = never, M_2 = never, N_1 = never, O = never>(this: A, ab: (_: A) => B_13, bc: (_: B_13) => C_12, cd: (_: C_12) => D_11, de: (_: D_11) => E_11, ef: (_: E_11) => F_9, fg: (_: F_9) => G_8, gh: (_: G_8) => H_7, hi: (_: H_7) => I_6, ij: (_: I_6) => J_5, jk: (_: J_5) => K_4, kl: (_: K_4) => L_3, lm: (_: L_3) => M_2, mn: (_: M_2) => N_1, no: (_: N_1) => O): O;
868
- pipe<A, B_14 = never, C_13 = never, D_12 = never, E_12 = never, F_10 = never, G_9 = never, H_8 = never, I_7 = never, J_6 = never, K_5 = never, L_4 = never, M_3 = never, N_2 = never, O_1 = never, P = never>(this: A, ab: (_: A) => B_14, bc: (_: B_14) => C_13, cd: (_: C_13) => D_12, de: (_: D_12) => E_12, ef: (_: E_12) => F_10, fg: (_: F_10) => G_9, gh: (_: G_9) => H_8, hi: (_: H_8) => I_7, ij: (_: I_7) => J_6, jk: (_: J_6) => K_5, kl: (_: K_5) => L_4, lm: (_: L_4) => M_3, mn: (_: M_3) => N_2, no: (_: N_2) => O_1, op: (_: O_1) => P): P;
869
- pipe<A, B_15 = never, C_14 = never, D_13 = never, E_13 = never, F_11 = never, G_10 = never, H_9 = never, I_8 = never, J_7 = never, K_6 = never, L_5 = never, M_4 = never, N_3 = never, O_2 = never, P_1 = never, Q = never>(this: A, ab: (_: A) => B_15, bc: (_: B_15) => C_14, cd: (_: C_14) => D_13, de: (_: D_13) => E_13, ef: (_: E_13) => F_11, fg: (_: F_11) => G_10, gh: (_: G_10) => H_9, hi: (_: H_9) => I_8, ij: (_: I_8) => J_7, jk: (_: J_7) => K_6, kl: (_: K_6) => L_5, lm: (_: L_5) => M_4, mn: (_: M_4) => N_3, no: (_: N_3) => O_2, op: (_: O_2) => P_1, pq: (_: P_1) => Q): Q;
870
- pipe<A, B_16 = never, C_15 = never, D_14 = never, E_14 = never, F_12 = never, G_11 = never, H_10 = never, I_9 = never, J_8 = never, K_7 = never, L_6 = never, M_5 = never, N_4 = never, O_3 = never, P_2 = never, Q_1 = never, R_1 = never>(this: A, ab: (_: A) => B_16, bc: (_: B_16) => C_15, cd: (_: C_15) => D_14, de: (_: D_14) => E_14, ef: (_: E_14) => F_12, fg: (_: F_12) => G_11, gh: (_: G_11) => H_10, hi: (_: H_10) => I_9, ij: (_: I_9) => J_8, jk: (_: J_8) => K_7, kl: (_: K_7) => L_6, lm: (_: L_6) => M_5, mn: (_: M_5) => N_4, no: (_: N_4) => O_3, op: (_: O_3) => P_2, pq: (_: P_2) => Q_1, qr: (_: Q_1) => R_1): R_1;
871
- pipe<A, B_17 = never, C_16 = never, D_15 = never, E_15 = never, F_13 = never, G_12 = never, H_11 = never, I_10 = never, J_9 = never, K_8 = never, L_7 = never, M_6 = never, N_5 = never, O_4 = never, P_3 = never, Q_2 = never, R_2 = never, S = never>(this: A, ab: (_: A) => B_17, bc: (_: B_17) => C_16, cd: (_: C_16) => D_15, de: (_: D_15) => E_15, ef: (_: E_15) => F_13, fg: (_: F_13) => G_12, gh: (_: G_12) => H_11, hi: (_: H_11) => I_10, ij: (_: I_10) => J_9, jk: (_: J_9) => K_8, kl: (_: K_8) => L_7, lm: (_: L_7) => M_6, mn: (_: M_6) => N_5, no: (_: N_5) => O_4, op: (_: O_4) => P_3, pq: (_: P_3) => Q_2, qr: (_: Q_2) => R_2, rs: (_: R_2) => S): S;
872
- pipe<A, B_18 = never, C_17 = never, D_16 = never, E_16 = never, F_14 = never, G_13 = never, H_12 = never, I_11 = never, J_10 = never, K_9 = never, L_8 = never, M_7 = never, N_6 = never, O_5 = never, P_4 = never, Q_3 = never, R_3 = never, S_1 = never, T = never>(this: A, ab: (_: A) => B_18, bc: (_: B_18) => C_17, cd: (_: C_17) => D_16, de: (_: D_16) => E_16, ef: (_: E_16) => F_14, fg: (_: F_14) => G_13, gh: (_: G_13) => H_12, hi: (_: H_12) => I_11, ij: (_: I_11) => J_10, jk: (_: J_10) => K_9, kl: (_: K_9) => L_8, lm: (_: L_8) => M_7, mn: (_: M_7) => N_6, no: (_: N_6) => O_5, op: (_: O_5) => P_4, pq: (_: P_4) => Q_3, qr: (_: Q_3) => R_3, rs: (_: R_3) => S_1, st: (_: S_1) => T): T;
873
- pipe<A, B_19 = never, C_18 = never, D_17 = never, E_17 = never, F_15 = never, G_14 = never, H_13 = never, I_12 = never, J_11 = never, K_10 = never, L_9 = never, M_8 = never, N_7 = never, O_6 = never, P_5 = never, Q_4 = never, R_4 = never, S_2 = never, T_1 = never, U = never>(this: A, ab: (_: A) => B_19, bc: (_: B_19) => C_18, cd: (_: C_18) => D_17, de: (_: D_17) => E_17, ef: (_: E_17) => F_15, fg: (_: F_15) => G_14, gh: (_: G_14) => H_13, hi: (_: H_13) => I_12, ij: (_: I_12) => J_11, jk: (_: J_11) => K_10, kl: (_: K_10) => L_9, lm: (_: L_9) => M_8, mn: (_: M_8) => N_7, no: (_: N_7) => O_6, op: (_: O_6) => P_5, pq: (_: P_5) => Q_4, qr: (_: Q_4) => R_4, rs: (_: R_4) => S_2, st: (_: S_2) => T_1, tu: (_: T_1) => U): U;
874
- pipe<A, B_20 = never, C_19 = never, D_18 = never, E_18 = never, F_16 = never, G_15 = never, H_14 = never, I_13 = never, J_12 = never, K_11 = never, L_10 = never, M_9 = never, N_8 = never, O_7 = never, P_6 = never, Q_5 = never, R_5 = never, S_3 = never, T_2 = never, U_1 = never>(this: A, ab: (_: A) => B_20, bc: (_: B_20) => C_19, cd: (_: C_19) => D_18, de: (_: D_18) => E_18, ef: (_: E_18) => F_16, fg: (_: F_16) => G_15, gh: (_: G_15) => H_14, hi: (_: H_14) => I_13, ij: (_: I_13) => J_12, jk: (_: J_12) => K_11, kl: (_: K_11) => L_10, lm: (_: L_10) => M_9, mn: (_: M_9) => N_8, no: (_: N_8) => O_7, op: (_: O_7) => P_6, pq: (_: P_6) => Q_5, qr: (_: Q_5) => R_5, rs: (_: R_5) => S_3, st: (_: S_3) => T_2, tu: (_: T_2) => U_1): U_1;
875
- /** The name, input and options the form was made from: what a pipe step makes the next form from. */
876
- name: Name;
877
- options: FormOptions<Fields, Members, R, Nest, Inputs>;
878
- /** Type-only: the form's type parameters, for a pipe step to read. Never set. */
879
- types: {
880
- readonly Name: Name;
881
- readonly E: E;
882
- readonly Fields: Fields;
883
- readonly Members: Members;
884
- readonly R: R;
885
- readonly Nest: Nest;
886
- readonly Inputs: Inputs;
887
- };
888
908
  };
889
909
  /**
890
910
  * Entity metadata: the label of a member that has no schema to annotate (a
@@ -921,43 +941,12 @@ interface Remakeable<T extends FormTypes = FormTypes> {
921
941
  type Made<T extends FormTypes> = ReturnType<typeof Core.make<T['Name'], T['E'], T['Fields'], T['Members'], T['R'], T['Nest'], T['Inputs']>>;
922
942
  type OptionsOf<T extends FormTypes> = FormOptions<T['Fields'], T['Members'], T['R'], T['Nest']>;
923
943
  export declare const Form: {
924
- /** Controls by key, beside the ones the form already names. */
925
- inputs: <F extends Remakeable, const I extends InputsFor<F["types"]["Fields"], F["types"]["Members"]>>(inputs: I) => (form: F) => [keyof ControlsOf<I>] extends [never] ? F : Made<{
926
- readonly Name: F["types"]["Name"];
927
- readonly E: F["types"]["E"];
928
- readonly Fields: F["types"]["Fields"];
929
- readonly Members: F["types"]["Members"];
930
- readonly R: F["types"]["R"];
931
- readonly Nest: F["types"]["Nest"];
932
- readonly Inputs: Omit<F["types"]["Inputs"], keyof I> & I;
933
- }>;
934
- /** The form's words, beside the ones it already has. */
935
- messages: <F extends Remakeable>(messages: NonNullable<OptionsOf<F["types"]>["messages"]>) => (form: F) => F;
936
- /** How long a key rests before its check runs. */
937
- debounce: (debounce: Duration.Input) => <F extends Remakeable>(form: F) => F;
938
944
  /**
939
- * Checks by key, beside the ones the form already has. What they need (`R`) is
940
- * added to what the form needs.
945
+ * The input of a form that writes no Entity of its own (a sign-up, a search,
946
+ * a login): `Entity.input` over an Entity defined from the same schema, so
947
+ * every key maps itself. `Form.make('Waitlist', Form.input(JoinWaitlist))`.
941
948
  */
942
- checks: <F extends Remakeable, const C extends ChecksFor<F>>(checks: C) => (form: F) => Made<{
943
- readonly Name: F["types"]["Name"];
944
- readonly E: F["types"]["E"];
945
- readonly Fields: F["types"]["Fields"];
946
- readonly Members: F["types"]["Members"];
947
- readonly R: F["types"]["R"] | RequirementOf<C>;
948
- readonly Nest: F["types"]["Nest"];
949
- readonly Inputs: F["types"]["Inputs"];
950
- }>;
951
- /** The forms of nested keys, beside the ones the form was already given. */
952
- nested: <F extends Remakeable, const N extends NestedForms<F["types"]["Fields"], F["types"]["Members"], F["types"]["R"]>>(forms: N) => (form: F) => Made<{
953
- readonly Name: F["types"]["Name"];
954
- readonly E: F["types"]["E"];
955
- readonly Fields: F["types"]["Fields"];
956
- readonly Members: F["types"]["Members"];
957
- readonly R: F["types"]["R"];
958
- readonly Nest: F["types"]["Nest"] & N;
959
- readonly Inputs: F["types"]["Inputs"];
960
- }>;
949
+ input: <Fields extends Schema.Struct.Fields>(schema: Schema.Struct<Fields>) => EntityInput<Entity<"FormInput", Fields, {}, {}>, Fields, { readonly [K in keyof Fields]: K extends never ? {}[K] extends (infer T) ? T extends {}[K] ? T extends string ? T extends keyof Fields & string ? { readonly [K_1 in keyof Fields & string]: import("foldkit-entity").EntityField<"FormInput", K_1, Fields[K_1]>; }[T] : T extends never ? import("foldkit-entity").RelationInput<{}[T]> : `"${T}" names no field or relation of FormInput` : T : never : never : K extends keyof Fields & string ? { readonly [K_1 in keyof Fields & string]: import("foldkit-entity").EntityField<"FormInput", K_1, Fields[K_1]>; }[K] : never; }>;
961
950
  /**
962
951
  * A form for one operation's input. A key mapped with `Relation.nested` holds
963
952
  * rows of a form of its own, built here from the nested input; every other key
@@ -965,46 +954,73 @@ export declare const Form: {
965
954
  * words, the checks.
966
955
  */
967
956
  make: <const Name extends string, E extends AnyEntity, Fields extends Schema.Struct.Fields, Members extends { readonly [K in keyof Fields]: InputMember; }, R = never, const Nest extends NestedForms<Fields, Members, R> = {}, const Inputs extends InputsFor<Fields, Members> = {}>(name: Name, input: EntityInput<E, Fields, Members>, options?: FormOptions<Fields, Members, R, Nest, Inputs>) => {
957
+ pipe<A>(this: A): A;
958
+ pipe<A, B = never>(this: A, ab: (_: A) => B): B;
959
+ pipe<A, B = never, C = never>(this: A, ab: (_: A) => B, bc: (_: B) => C): C;
960
+ pipe<A, B = never, C = never, D = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D): D;
961
+ pipe<A, B = never, C = never, D = never, E_1 = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1): E_1;
962
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F): F;
963
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G): G;
964
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H): H;
965
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I): I;
966
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J): J;
967
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K): K;
968
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L): L;
969
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M): M;
970
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N): N;
971
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O): O;
972
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P): P;
973
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q): Q;
974
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1): R_1;
975
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never, S = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1, rs: (_: R_1) => S): S;
976
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never, S = never, T = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1, rs: (_: R_1) => S, st: (_: S) => T): T;
977
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never, S = never, T = never, U = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1, rs: (_: R_1) => S, st: (_: S) => T, tu: (_: T) => U): U;
978
+ pipe<A, B = never, C = never, D = never, E_1 = never, F = never, G = never, H = never, I = never, J = never, K = never, L = never, M = never, N = never, O = never, P = never, Q = never, R_1 = never, S = never, T = never, U = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D, de: (_: D) => E_1, ef: (_: E_1) => F, fg: (_: F) => G, gh: (_: G) => H, hi: (_: H) => I, ij: (_: I) => J, jk: (_: J) => K, kl: (_: K) => L, lm: (_: L) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P, pq: (_: P) => Q, qr: (_: Q) => R_1, rs: (_: R_1) => S, st: (_: S) => T, tu: (_: T) => U): U;
979
+ /** The name, input and options the form was made from: what a pipe step makes the next form from. */
980
+ name: Name;
981
+ options: FormOptions<Fields, Members, R, Nest, Inputs>;
982
+ /** Type-only: the form's type parameters, for a pipe step to read. Never set. */
983
+ types: {
984
+ readonly Name: Name;
985
+ readonly E: E;
986
+ readonly Fields: Fields;
987
+ readonly Members: Members;
988
+ readonly R: R;
989
+ readonly Nest: Nest;
990
+ readonly Inputs: Inputs;
991
+ };
968
992
  bundle: Bundle.Bundle<Name, void, FormModel<Fields, Members, ControlsOf<Inputs>>, {
969
- readonly _tag: "Changed";
970
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
971
- readonly value: string | boolean | readonly string[];
993
+ readonly _tag: "About";
994
+ readonly subject: {
995
+ readonly [x: string]: string;
996
+ };
972
997
  } | {
973
998
  readonly _tag: "Blurred";
974
999
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
975
1000
  } | {
976
- readonly _tag: "ValidatedAll";
977
- } | {
978
- readonly _tag: "Submitted";
979
- } | {
980
- readonly _tag: "Reset";
1001
+ readonly _tag: "Changed";
1002
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1003
+ readonly value: string | boolean | readonly string[];
981
1004
  } | {
982
1005
  readonly _tag: "Checked";
983
1006
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
984
1007
  readonly draft: string | boolean | readonly string[];
985
1008
  readonly error: string | null;
986
1009
  } | {
987
- readonly _tag: "Refused";
988
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
989
- readonly error: string;
990
- } | {
991
- readonly _tag: "About";
992
- readonly subject: {
993
- readonly [x: string]: string;
994
- };
995
- } | {
996
- readonly _tag: "Searched";
997
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
998
- readonly text: string;
1010
+ readonly _tag: "Control";
1011
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1012
+ readonly message: unknown;
999
1013
  } | {
1000
1014
  readonly _tag: "Nested";
1001
1015
  readonly key: string;
1002
1016
  readonly row: string;
1003
1017
  readonly message: unknown;
1004
1018
  } | {
1005
- readonly _tag: "Control";
1006
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1007
- readonly message: unknown;
1019
+ readonly _tag: "Refused";
1020
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1021
+ readonly error: string;
1022
+ } | {
1023
+ readonly _tag: "Reset";
1008
1024
  } | {
1009
1025
  readonly _tag: "RowAdded";
1010
1026
  readonly key: string;
@@ -1012,6 +1028,14 @@ export declare const Form: {
1012
1028
  readonly _tag: "RowRemoved";
1013
1029
  readonly key: string;
1014
1030
  readonly row: string;
1031
+ } | {
1032
+ readonly _tag: "Searched";
1033
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1034
+ readonly text: string;
1035
+ } | {
1036
+ readonly _tag: "Submitted";
1037
+ } | {
1038
+ readonly _tag: "ValidatedAll";
1015
1039
  }, Submitted<Schema.Struct.View<Fields, "Type", Schema.Struct.TypeOptionalKeys<Fields>, Schema.Struct.TypeMutableKeys<Fields>>>, R, never, void, ControlResourcesOf<Inputs>, {
1016
1040
  fill: (model: FormModel<Fields, Members, ControlsOf<Inputs>>, values: Partial<Schema.Struct.View<Fields, "Type", Schema.Struct.TypeOptionalKeys<Fields>, Schema.Struct.TypeMutableKeys<Fields>>>) => {
1017
1041
  readonly model: FormModel<Fields, Members, ControlsOf<Inputs>>;
@@ -1089,6 +1113,18 @@ export declare const Form: {
1089
1113
  row: Schema.String;
1090
1114
  };
1091
1115
  }>;
1116
+ /** The Command a key's check runs as, for a test to resolve (`Command.resolve(form.Check, …)`). */
1117
+ Check: import("foldkit/command").CommandDefinitionWithArgs<`${Name}.check`, {
1118
+ key: Schema.Literals<readonly [Exclude<keyof Fields & string, NestedKey<Members>>, ...Exclude<keyof Fields & string, NestedKey<Members>>[]]>;
1119
+ draft: Schema.Union<readonly [Schema.String, Schema.Boolean, Schema.$Array<Schema.String>]>;
1120
+ values: Schema.Unknown;
1121
+ subject: Schema.$Record<Schema.String, Schema.String>;
1122
+ }, Effect.Effect<{
1123
+ readonly _tag: "Checked";
1124
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1125
+ readonly draft: string | boolean | readonly string[];
1126
+ readonly error: string | null;
1127
+ }, never, R>>;
1092
1128
  /** The reading the form was made from, for `Entity.selectFor` and `Entity.valuesFor`. */
1093
1129
  input: EntityInput<E, Fields, Members>;
1094
1130
  /** Whether a completed transition changed authored content. See the note above. */
@@ -1115,45 +1151,37 @@ export declare const Form: {
1115
1151
  control: <K extends keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>>(key: K) => {
1116
1152
  readonly field: (model: FormModel<Fields, Members, ControlsOf<Inputs>>) => { readonly [K_1 in keyof Fields as K_1 extends NestedKey<Members> ? never : K_1]: FieldValidation.Field<K_1 extends keyof ControlsOf<Inputs> ? ControlsOf<Inputs>[K_1] : DraftOf<Schema.Schema.Type<Fields[K_1]>>>; }[K];
1117
1153
  readonly send: (message: ControlMessageOf<Inputs[K]>) => {
1118
- readonly _tag: "Changed";
1119
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1120
- readonly value: string | boolean | readonly string[];
1154
+ readonly _tag: "About";
1155
+ readonly subject: {
1156
+ readonly [x: string]: string;
1157
+ };
1121
1158
  } | {
1122
1159
  readonly _tag: "Blurred";
1123
1160
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1124
1161
  } | {
1125
- readonly _tag: "ValidatedAll";
1126
- } | {
1127
- readonly _tag: "Submitted";
1128
- } | {
1129
- readonly _tag: "Reset";
1162
+ readonly _tag: "Changed";
1163
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1164
+ readonly value: string | boolean | readonly string[];
1130
1165
  } | {
1131
1166
  readonly _tag: "Checked";
1132
1167
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1133
1168
  readonly draft: string | boolean | readonly string[];
1134
1169
  readonly error: string | null;
1135
1170
  } | {
1136
- readonly _tag: "Refused";
1137
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1138
- readonly error: string;
1139
- } | {
1140
- readonly _tag: "About";
1141
- readonly subject: {
1142
- readonly [x: string]: string;
1143
- };
1144
- } | {
1145
- readonly _tag: "Searched";
1146
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1147
- readonly text: string;
1171
+ readonly _tag: "Control";
1172
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1173
+ readonly message: unknown;
1148
1174
  } | {
1149
1175
  readonly _tag: "Nested";
1150
1176
  readonly key: string;
1151
1177
  readonly row: string;
1152
1178
  readonly message: unknown;
1153
1179
  } | {
1154
- readonly _tag: "Control";
1155
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1156
- readonly message: unknown;
1180
+ readonly _tag: "Refused";
1181
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1182
+ readonly error: string;
1183
+ } | {
1184
+ readonly _tag: "Reset";
1157
1185
  } | {
1158
1186
  readonly _tag: "RowAdded";
1159
1187
  readonly key: string;
@@ -1161,6 +1189,14 @@ export declare const Form: {
1161
1189
  readonly _tag: "RowRemoved";
1162
1190
  readonly key: string;
1163
1191
  readonly row: string;
1192
+ } | {
1193
+ readonly _tag: "Searched";
1194
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1195
+ readonly text: string;
1196
+ } | {
1197
+ readonly _tag: "Submitted";
1198
+ } | {
1199
+ readonly _tag: "ValidatedAll";
1164
1200
  };
1165
1201
  };
1166
1202
  /** What was typed to find a choice for a relation key that searches; `''` until something is. */
@@ -1177,45 +1213,37 @@ export declare const Form: {
1177
1213
  * is this form's Message for that edit in that row.
1178
1214
  */
1179
1215
  row: <K extends Extract<keyof Fields & string, NestedKey<Members>>>(key: K, row: string) => RowHandle<K extends keyof Nest ? NonNullable<Nest[K]> : NestedForm, {
1180
- readonly _tag: "Changed";
1181
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1182
- readonly value: string | boolean | readonly string[];
1216
+ readonly _tag: "About";
1217
+ readonly subject: {
1218
+ readonly [x: string]: string;
1219
+ };
1183
1220
  } | {
1184
1221
  readonly _tag: "Blurred";
1185
1222
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1186
1223
  } | {
1187
- readonly _tag: "ValidatedAll";
1188
- } | {
1189
- readonly _tag: "Submitted";
1190
- } | {
1191
- readonly _tag: "Reset";
1224
+ readonly _tag: "Changed";
1225
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1226
+ readonly value: string | boolean | readonly string[];
1192
1227
  } | {
1193
1228
  readonly _tag: "Checked";
1194
1229
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1195
1230
  readonly draft: string | boolean | readonly string[];
1196
1231
  readonly error: string | null;
1197
1232
  } | {
1198
- readonly _tag: "Refused";
1199
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1200
- readonly error: string;
1201
- } | {
1202
- readonly _tag: "About";
1203
- readonly subject: {
1204
- readonly [x: string]: string;
1205
- };
1206
- } | {
1207
- readonly _tag: "Searched";
1208
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1209
- readonly text: string;
1233
+ readonly _tag: "Control";
1234
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1235
+ readonly message: unknown;
1210
1236
  } | {
1211
1237
  readonly _tag: "Nested";
1212
1238
  readonly key: string;
1213
1239
  readonly row: string;
1214
1240
  readonly message: unknown;
1215
1241
  } | {
1216
- readonly _tag: "Control";
1217
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1218
- readonly message: unknown;
1242
+ readonly _tag: "Refused";
1243
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1244
+ readonly error: string;
1245
+ } | {
1246
+ readonly _tag: "Reset";
1219
1247
  } | {
1220
1248
  readonly _tag: "RowAdded";
1221
1249
  readonly key: string;
@@ -1223,6 +1251,14 @@ export declare const Form: {
1223
1251
  readonly _tag: "RowRemoved";
1224
1252
  readonly key: string;
1225
1253
  readonly row: string;
1254
+ } | {
1255
+ readonly _tag: "Searched";
1256
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1257
+ readonly text: string;
1258
+ } | {
1259
+ readonly _tag: "Submitted";
1260
+ } | {
1261
+ readonly _tag: "ValidatedAll";
1226
1262
  }>;
1227
1263
  /**
1228
1264
  * Whether a key that follows another still does: `false` once the author has
@@ -1271,45 +1307,37 @@ export declare const Form: {
1271
1307
  args?: Record<string, unknown>;
1272
1308
  key?: string;
1273
1309
  effect: Effect.Effect<{
1274
- readonly _tag: "Changed";
1275
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1276
- readonly value: string | boolean | readonly string[];
1310
+ readonly _tag: "About";
1311
+ readonly subject: {
1312
+ readonly [x: string]: string;
1313
+ };
1277
1314
  } | {
1278
1315
  readonly _tag: "Blurred";
1279
1316
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1280
1317
  } | {
1281
- readonly _tag: "ValidatedAll";
1282
- } | {
1283
- readonly _tag: "Submitted";
1284
- } | {
1285
- readonly _tag: "Reset";
1318
+ readonly _tag: "Changed";
1319
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1320
+ readonly value: string | boolean | readonly string[];
1286
1321
  } | {
1287
1322
  readonly _tag: "Checked";
1288
1323
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1289
1324
  readonly draft: string | boolean | readonly string[];
1290
1325
  readonly error: string | null;
1291
1326
  } | {
1292
- readonly _tag: "Refused";
1293
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1294
- readonly error: string;
1295
- } | {
1296
- readonly _tag: "About";
1297
- readonly subject: {
1298
- readonly [x: string]: string;
1299
- };
1300
- } | {
1301
- readonly _tag: "Searched";
1302
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1303
- readonly text: string;
1327
+ readonly _tag: "Control";
1328
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1329
+ readonly message: unknown;
1304
1330
  } | {
1305
1331
  readonly _tag: "Nested";
1306
1332
  readonly key: string;
1307
1333
  readonly row: string;
1308
1334
  readonly message: unknown;
1309
1335
  } | {
1310
- readonly _tag: "Control";
1311
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1312
- readonly message: unknown;
1336
+ readonly _tag: "Refused";
1337
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1338
+ readonly error: string;
1339
+ } | {
1340
+ readonly _tag: "Reset";
1313
1341
  } | {
1314
1342
  readonly _tag: "RowAdded";
1315
1343
  readonly key: string;
@@ -1317,6 +1345,14 @@ export declare const Form: {
1317
1345
  readonly _tag: "RowRemoved";
1318
1346
  readonly key: string;
1319
1347
  readonly row: string;
1348
+ } | {
1349
+ readonly _tag: "Searched";
1350
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1351
+ readonly text: string;
1352
+ } | {
1353
+ readonly _tag: "Submitted";
1354
+ } | {
1355
+ readonly _tag: "ValidatedAll";
1320
1356
  }, never, R>;
1321
1357
  }>[];
1322
1358
  };
@@ -1327,45 +1363,37 @@ export declare const Form: {
1327
1363
  args?: Record<string, unknown>;
1328
1364
  key?: string;
1329
1365
  effect: Effect.Effect<{
1330
- readonly _tag: "Changed";
1331
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1332
- readonly value: string | boolean | readonly string[];
1366
+ readonly _tag: "About";
1367
+ readonly subject: {
1368
+ readonly [x: string]: string;
1369
+ };
1333
1370
  } | {
1334
1371
  readonly _tag: "Blurred";
1335
1372
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1336
1373
  } | {
1337
- readonly _tag: "ValidatedAll";
1338
- } | {
1339
- readonly _tag: "Submitted";
1340
- } | {
1341
- readonly _tag: "Reset";
1374
+ readonly _tag: "Changed";
1375
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1376
+ readonly value: string | boolean | readonly string[];
1342
1377
  } | {
1343
1378
  readonly _tag: "Checked";
1344
1379
  readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1345
1380
  readonly draft: string | boolean | readonly string[];
1346
1381
  readonly error: string | null;
1347
1382
  } | {
1348
- readonly _tag: "Refused";
1349
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1350
- readonly error: string;
1351
- } | {
1352
- readonly _tag: "About";
1353
- readonly subject: {
1354
- readonly [x: string]: string;
1355
- };
1356
- } | {
1357
- readonly _tag: "Searched";
1358
- readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1359
- readonly text: string;
1383
+ readonly _tag: "Control";
1384
+ readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1385
+ readonly message: unknown;
1360
1386
  } | {
1361
1387
  readonly _tag: "Nested";
1362
1388
  readonly key: string;
1363
1389
  readonly row: string;
1364
1390
  readonly message: unknown;
1365
1391
  } | {
1366
- readonly _tag: "Control";
1367
- readonly key: keyof ControlsOf<Inputs> & Exclude<keyof Fields & string, NestedKey<Members>>;
1368
- readonly message: unknown;
1392
+ readonly _tag: "Refused";
1393
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1394
+ readonly error: string;
1395
+ } | {
1396
+ readonly _tag: "Reset";
1369
1397
  } | {
1370
1398
  readonly _tag: "RowAdded";
1371
1399
  readonly key: string;
@@ -1373,6 +1401,14 @@ export declare const Form: {
1373
1401
  readonly _tag: "RowRemoved";
1374
1402
  readonly key: string;
1375
1403
  readonly row: string;
1404
+ } | {
1405
+ readonly _tag: "Searched";
1406
+ readonly key: Exclude<keyof Fields & string, NestedKey<Members>>;
1407
+ readonly text: string;
1408
+ } | {
1409
+ readonly _tag: "Submitted";
1410
+ } | {
1411
+ readonly _tag: "ValidatedAll";
1376
1412
  }, never, R>;
1377
1413
  }>[];
1378
1414
  };
@@ -1382,41 +1418,6 @@ export declare const Form: {
1382
1418
  /** The decoded input when every key and row is valid as it stands; validates nothing. */
1383
1419
  value: (model: FormModel<Fields, Members, ControlsOf<Inputs>>) => Schema.Struct.View<Fields, "Type", Schema.Struct.TypeOptionalKeys<Fields>, Schema.Struct.TypeMutableKeys<Fields>> | undefined;
1384
1420
  };
1385
- pipe<A>(this: A): A;
1386
- pipe<A, B = never>(this: A, ab: (_: A) => B): B;
1387
- pipe<A, B_1 = never, C = never>(this: A, ab: (_: A) => B_1, bc: (_: B_1) => C): C;
1388
- pipe<A, B_2 = never, C_1 = never, D = never>(this: A, ab: (_: A) => B_2, bc: (_: B_2) => C_1, cd: (_: C_1) => D): D;
1389
- pipe<A, B_3 = never, C_2 = never, D_1 = never, E_1 = never>(this: A, ab: (_: A) => B_3, bc: (_: B_3) => C_2, cd: (_: C_2) => D_1, de: (_: D_1) => E_1): E_1;
1390
- pipe<A, B_4 = never, C_3 = never, D_2 = never, E_2 = never, F = never>(this: A, ab: (_: A) => B_4, bc: (_: B_4) => C_3, cd: (_: C_3) => D_2, de: (_: D_2) => E_2, ef: (_: E_2) => F): F;
1391
- pipe<A, B_5 = never, C_4 = never, D_3 = never, E_3 = never, F_1 = never, G = never>(this: A, ab: (_: A) => B_5, bc: (_: B_5) => C_4, cd: (_: C_4) => D_3, de: (_: D_3) => E_3, ef: (_: E_3) => F_1, fg: (_: F_1) => G): G;
1392
- pipe<A, B_6 = never, C_5 = never, D_4 = never, E_4 = never, F_2 = never, G_1 = never, H = never>(this: A, ab: (_: A) => B_6, bc: (_: B_6) => C_5, cd: (_: C_5) => D_4, de: (_: D_4) => E_4, ef: (_: E_4) => F_2, fg: (_: F_2) => G_1, gh: (_: G_1) => H): H;
1393
- pipe<A, B_7 = never, C_6 = never, D_5 = never, E_5 = never, F_3 = never, G_2 = never, H_1 = never, I = never>(this: A, ab: (_: A) => B_7, bc: (_: B_7) => C_6, cd: (_: C_6) => D_5, de: (_: D_5) => E_5, ef: (_: E_5) => F_3, fg: (_: F_3) => G_2, gh: (_: G_2) => H_1, hi: (_: H_1) => I): I;
1394
- pipe<A, B_8 = never, C_7 = never, D_6 = never, E_6 = never, F_4 = never, G_3 = never, H_2 = never, I_1 = never, J = never>(this: A, ab: (_: A) => B_8, bc: (_: B_8) => C_7, cd: (_: C_7) => D_6, de: (_: D_6) => E_6, ef: (_: E_6) => F_4, fg: (_: F_4) => G_3, gh: (_: G_3) => H_2, hi: (_: H_2) => I_1, ij: (_: I_1) => J): J;
1395
- pipe<A, B_9 = never, C_8 = never, D_7 = never, E_7 = never, F_5 = never, G_4 = never, H_3 = never, I_2 = never, J_1 = never, K = never>(this: A, ab: (_: A) => B_9, bc: (_: B_9) => C_8, cd: (_: C_8) => D_7, de: (_: D_7) => E_7, ef: (_: E_7) => F_5, fg: (_: F_5) => G_4, gh: (_: G_4) => H_3, hi: (_: H_3) => I_2, ij: (_: I_2) => J_1, jk: (_: J_1) => K): K;
1396
- pipe<A, B_10 = never, C_9 = never, D_8 = never, E_8 = never, F_6 = never, G_5 = never, H_4 = never, I_3 = never, J_2 = never, K_1 = never, L = never>(this: A, ab: (_: A) => B_10, bc: (_: B_10) => C_9, cd: (_: C_9) => D_8, de: (_: D_8) => E_8, ef: (_: E_8) => F_6, fg: (_: F_6) => G_5, gh: (_: G_5) => H_4, hi: (_: H_4) => I_3, ij: (_: I_3) => J_2, jk: (_: J_2) => K_1, kl: (_: K_1) => L): L;
1397
- pipe<A, B_11 = never, C_10 = never, D_9 = never, E_9 = never, F_7 = never, G_6 = never, H_5 = never, I_4 = never, J_3 = never, K_2 = never, L_1 = never, M = never>(this: A, ab: (_: A) => B_11, bc: (_: B_11) => C_10, cd: (_: C_10) => D_9, de: (_: D_9) => E_9, ef: (_: E_9) => F_7, fg: (_: F_7) => G_6, gh: (_: G_6) => H_5, hi: (_: H_5) => I_4, ij: (_: I_4) => J_3, jk: (_: J_3) => K_2, kl: (_: K_2) => L_1, lm: (_: L_1) => M): M;
1398
- pipe<A, B_12 = never, C_11 = never, D_10 = never, E_10 = never, F_8 = never, G_7 = never, H_6 = never, I_5 = never, J_4 = never, K_3 = never, L_2 = never, M_1 = never, N = never>(this: A, ab: (_: A) => B_12, bc: (_: B_12) => C_11, cd: (_: C_11) => D_10, de: (_: D_10) => E_10, ef: (_: E_10) => F_8, fg: (_: F_8) => G_7, gh: (_: G_7) => H_6, hi: (_: H_6) => I_5, ij: (_: I_5) => J_4, jk: (_: J_4) => K_3, kl: (_: K_3) => L_2, lm: (_: L_2) => M_1, mn: (_: M_1) => N): N;
1399
- pipe<A, B_13 = never, C_12 = never, D_11 = never, E_11 = never, F_9 = never, G_8 = never, H_7 = never, I_6 = never, J_5 = never, K_4 = never, L_3 = never, M_2 = never, N_1 = never, O = never>(this: A, ab: (_: A) => B_13, bc: (_: B_13) => C_12, cd: (_: C_12) => D_11, de: (_: D_11) => E_11, ef: (_: E_11) => F_9, fg: (_: F_9) => G_8, gh: (_: G_8) => H_7, hi: (_: H_7) => I_6, ij: (_: I_6) => J_5, jk: (_: J_5) => K_4, kl: (_: K_4) => L_3, lm: (_: L_3) => M_2, mn: (_: M_2) => N_1, no: (_: N_1) => O): O;
1400
- pipe<A, B_14 = never, C_13 = never, D_12 = never, E_12 = never, F_10 = never, G_9 = never, H_8 = never, I_7 = never, J_6 = never, K_5 = never, L_4 = never, M_3 = never, N_2 = never, O_1 = never, P = never>(this: A, ab: (_: A) => B_14, bc: (_: B_14) => C_13, cd: (_: C_13) => D_12, de: (_: D_12) => E_12, ef: (_: E_12) => F_10, fg: (_: F_10) => G_9, gh: (_: G_9) => H_8, hi: (_: H_8) => I_7, ij: (_: I_7) => J_6, jk: (_: J_6) => K_5, kl: (_: K_5) => L_4, lm: (_: L_4) => M_3, mn: (_: M_3) => N_2, no: (_: N_2) => O_1, op: (_: O_1) => P): P;
1401
- pipe<A, B_15 = never, C_14 = never, D_13 = never, E_13 = never, F_11 = never, G_10 = never, H_9 = never, I_8 = never, J_7 = never, K_6 = never, L_5 = never, M_4 = never, N_3 = never, O_2 = never, P_1 = never, Q = never>(this: A, ab: (_: A) => B_15, bc: (_: B_15) => C_14, cd: (_: C_14) => D_13, de: (_: D_13) => E_13, ef: (_: E_13) => F_11, fg: (_: F_11) => G_10, gh: (_: G_10) => H_9, hi: (_: H_9) => I_8, ij: (_: I_8) => J_7, jk: (_: J_7) => K_6, kl: (_: K_6) => L_5, lm: (_: L_5) => M_4, mn: (_: M_4) => N_3, no: (_: N_3) => O_2, op: (_: O_2) => P_1, pq: (_: P_1) => Q): Q;
1402
- pipe<A, B_16 = never, C_15 = never, D_14 = never, E_14 = never, F_12 = never, G_11 = never, H_10 = never, I_9 = never, J_8 = never, K_7 = never, L_6 = never, M_5 = never, N_4 = never, O_3 = never, P_2 = never, Q_1 = never, R_1 = never>(this: A, ab: (_: A) => B_16, bc: (_: B_16) => C_15, cd: (_: C_15) => D_14, de: (_: D_14) => E_14, ef: (_: E_14) => F_12, fg: (_: F_12) => G_11, gh: (_: G_11) => H_10, hi: (_: H_10) => I_9, ij: (_: I_9) => J_8, jk: (_: J_8) => K_7, kl: (_: K_7) => L_6, lm: (_: L_6) => M_5, mn: (_: M_5) => N_4, no: (_: N_4) => O_3, op: (_: O_3) => P_2, pq: (_: P_2) => Q_1, qr: (_: Q_1) => R_1): R_1;
1403
- pipe<A, B_17 = never, C_16 = never, D_15 = never, E_15 = never, F_13 = never, G_12 = never, H_11 = never, I_10 = never, J_9 = never, K_8 = never, L_7 = never, M_6 = never, N_5 = never, O_4 = never, P_3 = never, Q_2 = never, R_2 = never, S = never>(this: A, ab: (_: A) => B_17, bc: (_: B_17) => C_16, cd: (_: C_16) => D_15, de: (_: D_15) => E_15, ef: (_: E_15) => F_13, fg: (_: F_13) => G_12, gh: (_: G_12) => H_11, hi: (_: H_11) => I_10, ij: (_: I_10) => J_9, jk: (_: J_9) => K_8, kl: (_: K_8) => L_7, lm: (_: L_7) => M_6, mn: (_: M_6) => N_5, no: (_: N_5) => O_4, op: (_: O_4) => P_3, pq: (_: P_3) => Q_2, qr: (_: Q_2) => R_2, rs: (_: R_2) => S): S;
1404
- pipe<A, B_18 = never, C_17 = never, D_16 = never, E_16 = never, F_14 = never, G_13 = never, H_12 = never, I_11 = never, J_10 = never, K_9 = never, L_8 = never, M_7 = never, N_6 = never, O_5 = never, P_4 = never, Q_3 = never, R_3 = never, S_1 = never, T = never>(this: A, ab: (_: A) => B_18, bc: (_: B_18) => C_17, cd: (_: C_17) => D_16, de: (_: D_16) => E_16, ef: (_: E_16) => F_14, fg: (_: F_14) => G_13, gh: (_: G_13) => H_12, hi: (_: H_12) => I_11, ij: (_: I_11) => J_10, jk: (_: J_10) => K_9, kl: (_: K_9) => L_8, lm: (_: L_8) => M_7, mn: (_: M_7) => N_6, no: (_: N_6) => O_5, op: (_: O_5) => P_4, pq: (_: P_4) => Q_3, qr: (_: Q_3) => R_3, rs: (_: R_3) => S_1, st: (_: S_1) => T): T;
1405
- pipe<A, B_19 = never, C_18 = never, D_17 = never, E_17 = never, F_15 = never, G_14 = never, H_13 = never, I_12 = never, J_11 = never, K_10 = never, L_9 = never, M_8 = never, N_7 = never, O_6 = never, P_5 = never, Q_4 = never, R_4 = never, S_2 = never, T_1 = never, U = never>(this: A, ab: (_: A) => B_19, bc: (_: B_19) => C_18, cd: (_: C_18) => D_17, de: (_: D_17) => E_17, ef: (_: E_17) => F_15, fg: (_: F_15) => G_14, gh: (_: G_14) => H_13, hi: (_: H_13) => I_12, ij: (_: I_12) => J_11, jk: (_: J_11) => K_10, kl: (_: K_10) => L_9, lm: (_: L_9) => M_8, mn: (_: M_8) => N_7, no: (_: N_7) => O_6, op: (_: O_6) => P_5, pq: (_: P_5) => Q_4, qr: (_: Q_4) => R_4, rs: (_: R_4) => S_2, st: (_: S_2) => T_1, tu: (_: T_1) => U): U;
1406
- pipe<A, B_20 = never, C_19 = never, D_18 = never, E_18 = never, F_16 = never, G_15 = never, H_14 = never, I_13 = never, J_12 = never, K_11 = never, L_10 = never, M_9 = never, N_8 = never, O_7 = never, P_6 = never, Q_5 = never, R_5 = never, S_3 = never, T_2 = never, U_1 = never>(this: A, ab: (_: A) => B_20, bc: (_: B_20) => C_19, cd: (_: C_19) => D_18, de: (_: D_18) => E_18, ef: (_: E_18) => F_16, fg: (_: F_16) => G_15, gh: (_: G_15) => H_14, hi: (_: H_14) => I_13, ij: (_: I_13) => J_12, jk: (_: J_12) => K_11, kl: (_: K_11) => L_10, lm: (_: L_10) => M_9, mn: (_: M_9) => N_8, no: (_: N_8) => O_7, op: (_: O_7) => P_6, pq: (_: P_6) => Q_5, qr: (_: Q_5) => R_5, rs: (_: R_5) => S_3, st: (_: S_3) => T_2, tu: (_: T_2) => U_1): U_1;
1407
- /** The name, input and options the form was made from: what a pipe step makes the next form from. */
1408
- name: Name;
1409
- options: FormOptions<Fields, Members, R, Nest, Inputs>;
1410
- /** Type-only: the form's type parameters, for a pipe step to read. Never set. */
1411
- types: {
1412
- readonly Name: Name;
1413
- readonly E: E;
1414
- readonly Fields: Fields;
1415
- readonly Members: Members;
1416
- readonly R: R;
1417
- readonly Nest: Nest;
1418
- readonly Inputs: Inputs;
1419
- };
1420
1421
  };
1421
1422
  /**
1422
1423
  * Entity metadata: the label of a member that has no schema to annotate (a
@@ -1431,6 +1432,43 @@ export declare const Form: {
1431
1432
  labelOf: (member: {
1432
1433
  readonly metadata: Metadata;
1433
1434
  }) => string | undefined;
1435
+ /** Controls by key, beside the ones the form already names. */
1436
+ inputs: <F extends Remakeable, const I extends InputsFor<F['types']['Fields'], F['types']['Members']>>(inputs: I) => (form: F) => [keyof ControlsOf<I>] extends [never] ? F : Made<{
1437
+ readonly Name: F['types']['Name'];
1438
+ readonly E: F['types']['E'];
1439
+ readonly Fields: F['types']['Fields'];
1440
+ readonly Members: F['types']['Members'];
1441
+ readonly R: F['types']['R'];
1442
+ readonly Nest: F['types']['Nest'];
1443
+ readonly Inputs: Omit<F['types']['Inputs'], keyof I> & I;
1444
+ }>;
1445
+ /** The form's words, beside the ones it already has. */
1446
+ messages: <F extends Remakeable>(messages: NonNullable<OptionsOf<F['types']>['messages']>) => (form: F) => F;
1447
+ /** How long a key rests before its check runs. */
1448
+ debounce: (debounce: Duration.Input) => <F extends Remakeable>(form: F) => F;
1449
+ /**
1450
+ * Checks by key, beside the ones the form already has. What they need (`R`) is
1451
+ * added to what the form needs.
1452
+ */
1453
+ checks: <F extends Remakeable, const C extends ChecksFor<F>>(checks: C) => (form: F) => Made<{
1454
+ readonly Name: F['types']['Name'];
1455
+ readonly E: F['types']['E'];
1456
+ readonly Fields: F['types']['Fields'];
1457
+ readonly Members: F['types']['Members'];
1458
+ readonly R: F['types']['R'] | RequirementOf<C>;
1459
+ readonly Nest: F['types']['Nest'];
1460
+ readonly Inputs: F['types']['Inputs'];
1461
+ }>;
1462
+ /** The forms of nested keys, beside the ones the form was already given. */
1463
+ nested: <F extends Remakeable, const N extends NestedForms<F['types']['Fields'], F['types']['Members'], F['types']['R']>>(forms: N) => (form: F) => Made<{
1464
+ readonly Name: F['types']['Name'];
1465
+ readonly E: F['types']['E'];
1466
+ readonly Fields: F['types']['Fields'];
1467
+ readonly Members: F['types']['Members'];
1468
+ readonly R: F['types']['R'];
1469
+ readonly Nest: F['types']['Nest'] & N;
1470
+ readonly Inputs: F['types']['Inputs'];
1471
+ }>;
1434
1472
  };
1435
1473
  //#endregion
1436
1474
  export type { BundleControl, BundleControlSpec, BundleData, Control, ControlChange, ControlKind, Draft, DraftKind, Follows, FormRow, NestedData, NestedForm, RelationData };