@siteimprove/alfa-lazy 0.89.5

package/CHANGELOG.md

@@ -0,0 +1,157 @@
+# @siteimprove/alfa-lazy
+
+## 0.89.3
+
+## 0.89.2
+
+### Patch Changes
+
+- **Changed:** Trying to fix a problem in generating provenance statements ([#1674](https://github.com/Siteimprove/alfa/pull/1674))
+
+## 0.89.1
+
+### Patch Changes
+
+- **Added:** Trying to publish Alfa packages on the npm registry ([#1673](https://github.com/Siteimprove/alfa/pull/1673))
+
+## 0.89.0
+
+## 0.88.0
+
+### Minor Changes
+
+- **Fixed:** The publish flow was updated to a new version. ([`a2f19cf9a6c7c72b8bf085597e4f1a95ac3e4eb2`](https://github.com/Siteimprove/alfa/commit/a2f19cf9a6c7c72b8bf085597e4f1a95ac3e4eb2))
+
+  Some 0.87.\* versions were generating uninstallable package. This should be fixed now.
+
+## 0.87.12
+
+## 0.87.11
+
+## 0.87.10
+
+## 0.87.7
+
+## 0.87.6
+
+## 0.87.5
+
+## 0.87.4
+
+## 0.87.3
+
+## 0.87.2
+
+## 0.87.1
+
+## 0.87.0
+
+### Minor Changes
+
+- **Breaking:** Optional serialization type parameters have been removed. ([#1651](https://github.com/Siteimprove/alfa/pull/1651))
+
+## 0.86.2
+
+## 0.86.1
+
+## 0.86.0
+
+### Minor Changes
+
+- **Breaking:** TS resolution has been changed to `Node16`, target to `es2022`. ([#1636](https://github.com/Siteimprove/alfa/pull/1636))
+
+- **Breaking:** Alfa is now distributed as ESM rather than CJS modules; projects using it must be ESM or use dynamic `import()`. ([#1636](https://github.com/Siteimprove/alfa/pull/1636))
+
+  ⚠️ This is the last of a series of changes on the internal structure and build process of distributed packages that was started with v0.85.0.
+
+## 0.85.1
+
+## 0.85.0
+
+### Minor Changes
+
+- **Breaking:** The .js files are now built in the `dist` folder rather than in `src`. ([#1628](https://github.com/Siteimprove/alfa/pull/1628))
+
+  ⚠️ This is the first of a series of changes on the internal structure and build process of distributed packages. It is probably better to not use this version and wait until more of these internal changes have been done to jump directly to the final result. We are internally releasing these changes for validation purpose only.
+
+  This should not impact consumers, the `package.json` files should be set correctly to consume these files.
+
+## 0.84.0
+
+## 0.83.1
+
+## 0.83.0
+
+## 0.82.0
+
+### Minor Changes
+
+- **Added:** Serialization options are now accepted, and passed on, by `toJSON()` on these types. ([#1622](https://github.com/Siteimprove/alfa/pull/1622))
+
+- **Breaking:** Node 18 is no longer supported. ([#1618](https://github.com/Siteimprove/alfa/pull/1618))
+
+## 0.81.0
+
+### Patch Changes
+
+- **Added:** Each package now contains its internal dependency graph in its `docs` directory. ([#1610](https://github.com/Siteimprove/alfa/pull/1610))
+
+## 0.80.0
+
+## 0.79.1
+
+## 0.79.0
+
+## 0.78.2
+
+## 0.78.1
+
+## 0.78.0
+
+## 0.77.0
+
+## 0.76.0
+
+## 0.75.2
+
+## 0.75.1
+
+## 0.75.0
+
+## 0.74.0
+
+## 0.73.0
+
+## 0.72.0
+
+## 0.71.1
+
+## 0.71.0
+
+## 0.70.0
+
+## 0.69.0
+
+## 0.68.0
+
+## 0.67.0
+
+## 0.66.0
+
+## 0.65.1
+
+## 0.65.0
+
+## 0.64.0
+
+## 0.63.3
+
+## 0.63.2
+
+## 0.63.1
+
+## 0.63.0
+
+## 0.62.2
+
+## 0.62.1

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./lazy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./lazy.js";
+//# sourceMappingURL=index.js.map

package/dist/lazy.d.ts

@@ -0,0 +1,35 @@
+import type { Applicative } from "@siteimprove/alfa-applicative";
+import { Equatable } from "@siteimprove/alfa-equatable";
+import type { Functor } from "@siteimprove/alfa-functor";
+import { Serializable } from "@siteimprove/alfa-json";
+import type { Mapper } from "@siteimprove/alfa-mapper";
+import type { Monad } from "@siteimprove/alfa-monad";
+import type { Thunk } from "@siteimprove/alfa-thunk";
+/**
+ * @public
+ */
+export declare class Lazy<T> implements Functor<T>, Applicative<T>, Monad<T>, Iterable<T>, Equatable, Serializable<Lazy.JSON<T>> {
+    static of<T>(thunk: Thunk<T>): Lazy<T>;
+    static force<T>(value: T): Lazy<T>;
+    private _value;
+    private constructor();
+    force(): T;
+    map<U>(mapper: Mapper<T, U>): Lazy<U>;
+    apply<U>(mapper: Lazy<Mapper<T, U>>): Lazy<U>;
+    flatMap<U>(mapper: Mapper<T, Lazy<U>>): Lazy<U>;
+    flatten<T>(this: Lazy<Lazy<T>>): Lazy<T>;
+    equals<T>(value: Lazy<T>): boolean;
+    equals(value: unknown): value is this;
+    iterator(): Iterator<T>;
+    [Symbol.iterator](): Iterator<T>;
+    toThunk(): Thunk<T>;
+    toJSON(options?: Serializable.Options): Lazy.JSON<T>;
+    toString(): string;
+}
+/**
+ * @public
+ */
+export declare namespace Lazy {
+    type JSON<T> = Serializable.ToJSON<T>;
+}
+//# sourceMappingURL=lazy.d.ts.map

package/dist/lazy.js

@@ -0,0 +1,65 @@
+import { Equatable } from "@siteimprove/alfa-equatable";
+import { Serializable } from "@siteimprove/alfa-json";
+import { Trampoline } from "@siteimprove/alfa-trampoline";
+/**
+ * @public
+ */
+export class Lazy {
+    static of(thunk) {
+        return new Lazy(Trampoline.delay(thunk));
+    }
+    static force(value) {
+        return new Lazy(Trampoline.done(value));
+    }
+    _value;
+    constructor(value) {
+        this._value = value;
+    }
+    force() {
+        if (this._value.isSuspended()) {
+            this._value = Trampoline.done(this._value.run());
+        }
+        return this._value.run();
+    }
+    map(mapper) {
+        return new Lazy(this._value.flatMap((value) => {
+            if (this._value.isSuspended()) {
+                this._value = Trampoline.done(value);
+            }
+            return Trampoline.done(mapper(value));
+        }));
+    }
+    apply(mapper) {
+        return mapper.map((mapper) => mapper(this.force()));
+    }
+    flatMap(mapper) {
+        return new Lazy(this._value.flatMap((value) => {
+            if (this._value.isSuspended()) {
+                this._value = Trampoline.done(value);
+            }
+            return mapper(value)._value;
+        }));
+    }
+    flatten() {
+        return this.flatMap((lazy) => lazy);
+    }
+    equals(value) {
+        return (value instanceof Lazy && Equatable.equals(value.force(), this.force()));
+    }
+    *iterator() {
+        yield this.force();
+    }
+    [Symbol.iterator]() {
+        return this.iterator();
+    }
+    toThunk() {
+        return () => this.force();
+    }
+    toJSON(options) {
+        return Serializable.toJSON(this.force(), options);
+    }
+    toString() {
+        return `Lazy { ${this.force()} }`;
+    }
+}
+//# sourceMappingURL=lazy.js.map

package/package.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "http://json.schemastore.org/package",
+  "name": "@siteimprove/alfa-lazy",
+  "homepage": "https://alfa.siteimprove.com",
+  "version": "0.89.5",
+  "license": "MIT",
+  "description": "An implementation of lazy values, which are values whose initialization can be delayed until needed",
+  "repository": {
+    "type": "git",
+    "url": "github:Siteimprove/alfa",
+    "directory": "packages/alfa-lazy"
+  },
+  "bugs": "https://github.com/siteimprove/alfa/issues",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "dependencies": {
+    "@siteimprove/alfa-applicative": "^0.89.5",
+    "@siteimprove/alfa-equatable": "^0.89.5",
+    "@siteimprove/alfa-functor": "^0.89.5",
+    "@siteimprove/alfa-json": "^0.89.5",
+    "@siteimprove/alfa-mapper": "^0.89.5",
+    "@siteimprove/alfa-monad": "^0.89.5",
+    "@siteimprove/alfa-thunk": "^0.89.5",
+    "@siteimprove/alfa-trampoline": "^0.89.5"
+  },
+  "devDependencies": {
+    "@siteimprove/alfa-test": "^0.89.5"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://npm.pkg.github.com/"
+  }
+}