Release

.github/workflows/release.yml

@@ -42,7 +42,7 @@ jobs:
       - name: Polish Files
         run: yarn polish
       - name: Build Distribution Bundles
-        run: yarn build:bundle
+        run: yarn build
       - name: Perform Semantic Release
         id: release
         uses: cycjimmy/[email protected]
@@ -70,8 +70,9 @@ jobs:
           NONINTERACTIVE: true
       - run: yarn install
       - run: yarn bump-deps
+      - run: yarn polish
       - run: yarn build
       - uses: stefanzweifel/git-auto-commit-action@v4
         with:
           commit_message:
-            "chore(post-release): committing changes produced during the release"
+            "chore(docs and dist): commit what was produced during the release"

.gitignore

@@ -119,4 +119,6 @@ index.*.map
 
 *.old
 
-fun-promises-*.tgz
+*.tgz
+*.tar.gz
+*.tar.xz

.npmignore

@@ -6,5 +6,5 @@ script
 docs
 conf.d
 tsconfig/*
-dist/docs.tgz
-fun-promises-*.tgz
+*.tgz
+*.xz

CHANGELOG.md

@@ -1,48 +1,53 @@
+<!-- @format -->
+
 fun-promises Changelog
 
 ## [1.2.0](https://github.com/RobertFischer/fun-promises/compare/v1.1.0...v1.2.0) (2020-12-03)
 
-
 ### Features
 
-* **fold:** implements fold in case map and filter don't cut it ([86c010f](https://github.com/RobertFischer/fun-promises/commit/86c010ff5f934602a2a964cb71ebb73697ed7c2a)), closes [#12](https://github.com/RobertFischer/fun-promises/issues/12)
-* **tap:** implement 'tap' for peeking at values ([0f4816a](https://github.com/RobertFischer/fun-promises/commit/0f4816ab42fd9f18bf91e179d2c03fed25822f11))
-
+- **fold:** implements fold in case map and filter don't cut it
+  ([86c010f](https://github.com/RobertFischer/fun-promises/commit/86c010ff5f934602a2a964cb71ebb73697ed7c2a)),
+  closes [#12](https://github.com/RobertFischer/fun-promises/issues/12)
+- **tap:** implement 'tap' for peeking at values
+  ([0f4816a](https://github.com/RobertFischer/fun-promises/commit/0f4816ab42fd9f18bf91e179d2c03fed25822f11))
 
 ### Reverts
 
-* **release:** the cleanup caused a problem with the autocommitting ([6c03637](https://github.com/RobertFischer/fun-promises/commit/6c03637137923e0581a4a736bcb6bd4aa25c77d4))
+- **release:** the cleanup caused a problem with the autocommitting
+  ([6c03637](https://github.com/RobertFischer/fun-promises/commit/6c03637137923e0581a4a736bcb6bd4aa25c77d4))
 
 ## [1.2.0-rc.2](https://github.com/RobertFischer/fun-promises/compare/v1.2.0-rc.1...v1.2.0-rc.2) (2020-12-02)
 
-
 ### Features
 
-* **fold:** implements fold in case map and filter don't cut it ([86c010f](https://github.com/RobertFischer/fun-promises/commit/86c010ff5f934602a2a964cb71ebb73697ed7c2a)), closes [#12](https://github.com/RobertFischer/fun-promises/issues/12)
+- **fold:** implements fold in case map and filter don't cut it
+  ([86c010f](https://github.com/RobertFischer/fun-promises/commit/86c010ff5f934602a2a964cb71ebb73697ed7c2a)),
+  closes [#12](https://github.com/RobertFischer/fun-promises/issues/12)
 
 ## [1.2.0-rc.1](https://github.com/RobertFischer/fun-promises/compare/v1.1.0...v1.2.0-rc.1) (2020-12-02)
 
-
 ### Features
 
-* **tap:** implement 'tap' for peeking at values ([0f4816a](https://github.com/RobertFischer/fun-promises/commit/0f4816ab42fd9f18bf91e179d2c03fed25822f11))
-
+- **tap:** implement 'tap' for peeking at values
+  ([0f4816a](https://github.com/RobertFischer/fun-promises/commit/0f4816ab42fd9f18bf91e179d2c03fed25822f11))
 
 ### Reverts
 
-* **release:** the cleanup caused a problem with the autocommitting ([6c03637](https://github.com/RobertFischer/fun-promises/commit/6c03637137923e0581a4a736bcb6bd4aa25c77d4))
+- **release:** the cleanup caused a problem with the autocommitting
+  ([6c03637](https://github.com/RobertFischer/fun-promises/commit/6c03637137923e0581a4a736bcb6bd4aa25c77d4))
 
 ## [1.1.0-rc.2](https://github.com/RobertFischer/fun-promises/compare/v1.1.0-rc.1...v1.1.0-rc.2) (2020-12-02)
 
-
 ### Features
 
-* **tap:** implement 'tap' for peeking at values ([ce059bd](https://github.com/RobertFischer/fun-promises/commit/ce059bdb12c4706f8bf8189d5b09dadae740fa47))
-
+- **tap:** implement 'tap' for peeking at values
+  ([ce059bd](https://github.com/RobertFischer/fun-promises/commit/ce059bdb12c4706f8bf8189d5b09dadae740fa47))
 
 ### Reverts
 
-* **release:** the cleanup caused a problem with the autocommitting ([c9ad636](https://github.com/RobertFischer/fun-promises/commit/c9ad636762e510ce0218f4c13b506cac05f4ab0f))
+- **release:** the cleanup caused a problem with the autocommitting
+  ([c9ad636](https://github.com/RobertFischer/fun-promises/commit/c9ad636762e510ce0218f4c13b506cac05f4ab0f))
 
 <!-- @format -->
 

README.md

@@ -20,12 +20,12 @@ npm install --save fun-promises
 
 ### CDN for Browsers
 
-The following URL contains a script which will set the `FunPromise` global to be
-an object containing the various exports of
+The following URL contains a script which will set the `FunPromises` global to
+be an object containing the various exports of
 [`index.ts`](https://robertfischer.github.io/fun-promises/modules/_index_.html).
 
 ```
-https://unpkg.com/browse/fun-promises@latest/dist/browser/index.js
+https://unpkg.com/fun-promises@latest/dist/browser/index.js
 ```
 
 ## Usage
@@ -85,6 +85,12 @@ This is an inside-out promise: it gives you access to the `resolve` and `reject`
 methods of the promise so that you can perform operations on them later, as well
 as having accessor to query the state of `promise`.
 
+### `fold`/`map`/`filter`
+
+Optimized promise-based implementations for all your collection-processing
+needs. Note that `map` and `fold` also come in "flat" varieties for
+concatenating iterables: `flatMap` and `flatFold`.
+
 ### `try`
 
 ```typescript

dist/es6/cjs/src/fun-promise.d.ts

@@ -26,7 +26,7 @@ export default class FunPromise<T> implements Promise<T> {
     /**
      * Constructor, which takes the promise to wrap.
      */
-    constructor(wrapped: Promise<T>);
+    constructor(wrapped: Promisable<T>);
     /**
      * Takes a value (or a promise of a value) and returns a promise wrapping
      * it.
@@ -298,6 +298,18 @@ export default class FunPromise<T> implements Promise<T> {
      * Equivalent to `FunPromise.resolve(values).fold(initialValue, accumulator)`.
      */
     static fold<T, T2 = T>(values: PromisableIterable<T>, initialValue: T2, accumulator: (memo: T2, it: T) => Promisable<T2>): FunPromise<T2>;
+    /**
+     * Given an initial array of values and an accumulator function, apply the accumlator function to each element of the promise's resolved value,
+     * passing in the current array of values and the resolved item.  Returns an array with the concatenated results of the accumulation.
+     * If any of the promise's values are rejected, the entire operation will be rejected.
+     *
+     * The resolution order is not guaranteed. The accumulator function will be passed values as those values resolve.
+     */
+    flatFold<T2 = Item<T>>(initialValue: PromisableIterable<T2>, accumulator: (memo: T2[], it: Item<T>) => PromisableIterable<T2>): FunPromise<T2[]>;
+    /**
+     * Equivalent to `FunPromise.resolve(values).flatFold(initialValue, accumulator)`.
+     */
+    static flatFold<T, T2 = T>(values: PromisableIterable<T>, initialValue: PromisableIterable<T2>, accumulator: (memo: T2[], it: T) => PromisableIterable<T2>): FunPromise<T2[]>;
     /**
      * Handles rejections like 'catch', but wraps them in a [[`NestedError`]] with the given message.
      */