版博士V2.0程序
No puede seleccionar más de 25 temas Los temas deben comenzar con una letra o número, pueden incluir guiones ('-') y pueden tener hasta 35 caracteres de largo.
 
 
 
 

109 líneas
4.0 KiB

  1. /**
  2. * The `Alternative` type class extends the `Alt` type class with a value that should be the left and right identity for `alt`.
  3. *
  4. * It is similar to `Monoid`, except that it applies to types of kind `* -> *`, like `Array` or `Option`, rather than
  5. * concrete types like `string` or `number`.
  6. *
  7. * `Alternative` instances should satisfy the following laws:
  8. *
  9. * 1. Left identity: `A.alt(zero, fa) <-> fa`
  10. * 2. Right identity: `A.alt(fa, zero) <-> fa`
  11. * 3. Annihilation: `A.map(zero, f) <-> zero`
  12. * 4. Distributivity: `A.ap(A.alt(fab, gab), fa) <-> A.alt(A.ap(fab, fa), A.ap(gab, fa))`
  13. * 5. Annihilation: `A.ap(zero, fa) <-> zero`
  14. *
  15. * @since 2.0.0
  16. */
  17. import { Alt, Alt1, Alt2, Alt2C, Alt3, Alt3C, Alt4 } from './Alt'
  18. import {
  19. Applicative,
  20. Applicative1,
  21. Applicative2,
  22. Applicative2C,
  23. Applicative3,
  24. Applicative3C,
  25. Applicative4
  26. } from './Applicative'
  27. import { HKT, Kind, Kind2, Kind3, Kind4, URIS, URIS2, URIS3, URIS4 } from './HKT'
  28. import { Zero, Zero1, Zero2, Zero2C, Zero3, Zero3C, Zero4 } from './Zero'
  29. import { Monoid } from './Monoid'
  30. import { Semigroup } from './Semigroup'
  31. /**
  32. * @category model
  33. * @since 2.0.0
  34. */
  35. export interface Alternative<F> extends Applicative<F>, Alt<F>, Zero<F> {}
  36. /**
  37. * @category model
  38. * @since 2.0.0
  39. */
  40. export interface Alternative1<F extends URIS> extends Applicative1<F>, Alt1<F>, Zero1<F> {}
  41. /**
  42. * @category model
  43. * @since 2.0.0
  44. */
  45. export interface Alternative2<F extends URIS2> extends Applicative2<F>, Alt2<F>, Zero2<F> {}
  46. /**
  47. * @category model
  48. * @since 2.0.0
  49. */
  50. export interface Alternative2C<F extends URIS2, E> extends Applicative2C<F, E>, Alt2C<F, E>, Zero2C<F, E> {}
  51. /**
  52. * @category model
  53. * @since 2.0.0
  54. */
  55. export interface Alternative3<F extends URIS3> extends Applicative3<F>, Alt3<F>, Zero3<F> {}
  56. /**
  57. * @category model
  58. * @since 2.10.0
  59. */
  60. export interface Alternative3C<F extends URIS3, E> extends Applicative3C<F, E>, Alt3C<F, E>, Zero3C<F, E> {}
  61. /**
  62. * @category model
  63. * @since 2.10.0
  64. */
  65. export interface Alternative4<F extends URIS4> extends Applicative4<F>, Alt4<F>, Zero4<F> {}
  66. /**
  67. * @since 2.11.0
  68. */
  69. export declare function altAll<F extends URIS4>(
  70. F: Alternative4<F>
  71. ): <S, R, E, A>(as: ReadonlyArray<Kind4<F, S, R, E, A>>) => Kind4<F, S, R, E, A>
  72. export declare function altAll<F extends URIS3>(
  73. F: Alternative3<F>
  74. ): <R, E, A>(as: ReadonlyArray<Kind3<F, R, E, A>>) => Kind3<F, R, E, A>
  75. export declare function altAll<F extends URIS3, E>(
  76. F: Alternative3C<F, E>
  77. ): <R, A>(as: ReadonlyArray<Kind3<F, R, E, A>>) => Kind3<F, R, E, A>
  78. export declare function altAll<F extends URIS2>(
  79. F: Alternative2<F>
  80. ): <E, A>(as: ReadonlyArray<Kind2<F, E, A>>) => Kind2<F, E, A>
  81. export declare function altAll<F extends URIS2, E>(
  82. F: Alternative2C<F, E>
  83. ): <A>(as: ReadonlyArray<Kind2<F, E, A>>) => Kind2<F, E, A>
  84. export declare function altAll<F extends URIS>(F: Alternative1<F>): <A>(as: ReadonlyArray<Kind<F, A>>) => Kind<F, A>
  85. export declare function altAll<F>(F: Alternative<F>): <A>(as: ReadonlyArray<HKT<F, A>>) => HKT<F, A>
  86. /**
  87. * Lift a semigroup into a monoid alternative 'F', the inner values are concatenated using the provided `Semigroup`.
  88. * @since 2.13.0
  89. */
  90. export declare function getAlternativeMonoid<F extends URIS4>(
  91. F: Alternative4<F>
  92. ): <A, S, R, E>(S: Semigroup<A>) => Monoid<Kind4<F, S, R, E, A>>
  93. export declare function getAlternativeMonoid<F extends URIS3>(
  94. F: Alternative3<F>
  95. ): <A, R, E>(S: Semigroup<A>) => Monoid<Kind3<F, R, E, A>>
  96. export declare function getAlternativeMonoid<F extends URIS3, E>(
  97. F: Alternative3C<F, E>
  98. ): <A, R>(S: Semigroup<A>) => Monoid<Kind3<F, R, E, A>>
  99. export declare function getAlternativeMonoid<F extends URIS2>(
  100. F: Alternative2<F>
  101. ): <A, E>(S: Semigroup<A>) => Monoid<Kind2<F, E, A>>
  102. export declare function getAlternativeMonoid<F extends URIS2, E>(
  103. F: Alternative2C<F, E>
  104. ): <A>(S: Semigroup<A>) => Monoid<Kind2<F, E, A>>
  105. export declare function getAlternativeMonoid<F extends URIS>(
  106. F: Alternative1<F>
  107. ): <A>(S: Semigroup<A>) => Monoid<Kind<F, A>>
  108. export declare function getAlternativeMonoid<F>(F: Alternative<F>): <A>(S: Semigroup<A>) => Monoid<HKT<F, A>>