shelving 1.157.0 → 1.157.2

package/index.d.ts

@@ -7,7 +7,6 @@ export * from "./api/index.js";
 export * from "./db/index.js";
 export * from "./error/index.js";
 export * from "./feedback/index.js";
-export * from "./iterate/index.js";
 export * from "./markup/index.js";
 export * from "./schema/index.js";
 export * from "./sequence/index.js";

package/index.js

@@ -10,7 +10,6 @@ export * from "./feedback/index.js";
 // export * from "./firestore/client/index.js"; // Not exported.
 // export * from "./firestore/lite/index.js"; // Not exported.
 // export * from "./firestore/server/index.js"; // Not exported.
-export * from "./iterate/index.js";
 export * from "./markup/index.js";
 // export * from "./react/index.js"; // Not exported.
 export * from "./schema/index.js";

package/package.json

@@ -11,7 +11,7 @@
 		"state-management",
 		"query-builder"
 	],
-	"version": "1.157.0",
+	"version": "1.157.2",
 	"repository": "https://github.com/dhoulb/shelving",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"license": "0BSD",

package/schema/NullableSchema.d.ts

@@ -1,8 +1,8 @@
-import type { Schema, SchemaOptions } from "./Schema.js";
-import { ThroughSchema } from "./ThroughSchema.js";
+import type { Schema } from "./Schema.js";
+import { ThroughSchema, type ThroughSchemaOptions } from "./ThroughSchema.js";
 /** Allowed options for `NullableSchema` */
-export interface NullableSchemaOptions<T> extends SchemaOptions {
-    readonly source: Schema<T>;
+export interface NullableSchemaOptions<T> extends ThroughSchemaOptions<T | null> {
+    /** Default value (defaults to `null`). */
     readonly value?: T | null;
 }
 /** Validate a value of a specific type or `null`. */

package/schema/OptionalSchema.d.ts

@@ -1,11 +1,18 @@
 import type { Schema } from "./Schema.js";
-import { ThroughSchema } from "./ThroughSchema.js";
+import { ThroughSchema, type ThroughSchemaOptions } from "./ThroughSchema.js";
+export interface OptionalSchemaOptions<T> extends ThroughSchemaOptions<T | undefined> {
+    /** Default value for an `OptionalSchema` can always `undefined` */
+    readonly value?: undefined;
+}
 /**
  * Validate a property in an optional way, i.e. it can be the value, or `undefined`
  * - If the prop is `undefined`, then `undefined` is returned.
  * - When used with `validateData()` this means the prop can be silently skipped.
  */
 export declare class OptionalSchema<T> extends ThroughSchema<T | undefined> {
+    /** Default value for an `OptionalSchema` is always `undefined` (default value is only used when a value is `undefined`, so otherwise `undefined` could never be returned as a value). */
+    readonly value: undefined;
+    constructor(options: OptionalSchemaOptions<T>);
     validate(unsafeValue: unknown): T | undefined;
 }
 /** Make a property of a set of data optional, i.e. it can be the value or `undefined` */

package/schema/OptionalSchema.js

@@ -5,6 +5,9 @@ import { ThroughSchema } from "./ThroughSchema.js";
  * - When used with `validateData()` this means the prop can be silently skipped.
  */
 export class OptionalSchema extends ThroughSchema {
+    constructor(options) {
+        super({ ...options, value: undefined });
+    }
     validate(unsafeValue) {
         if (unsafeValue === undefined)
             return undefined;

package/schema/StringSchema.d.ts

@@ -43,10 +43,7 @@ export declare class StringSchema extends Schema<string> {
 /** Valid string, e.g. `Hello there!` */
 export declare const STRING: StringSchema;
 /** Valid string, `Hello there!`, with more than one character. */
-export declare const REQUIRED_STRING: StringSchema; /** Valid text, e.g. `Hello there!` */
-export declare const TEXT: StringSchema;
-/** Valid text, `Hello there!`, with more than one character. */
-export declare const REQUIRED_TEXT: StringSchema;
+export declare const REQUIRED_STRING: StringSchema;
 /** Title string, e.g. `Title of something` */
 export declare const TITLE: StringSchema;
 /** Optional name string, e.g. `Title of something` or `null` */

package/schema/StringSchema.js

@@ -59,10 +59,7 @@ export class StringSchema extends Schema {
 /** Valid string, e.g. `Hello there!` */
 export const STRING = new StringSchema({});
 /** Valid string, `Hello there!`, with more than one character. */
-export const REQUIRED_STRING = new StringSchema({ min: 1 }); /** Valid text, e.g. `Hello there!` */
-export const TEXT = new StringSchema({ title: "Text" });
-/** Valid text, `Hello there!`, with more than one character. */
-export const REQUIRED_TEXT = new StringSchema({ min: 1 });
+export const REQUIRED_STRING = new StringSchema({ min: 1 });
 /** Title string, e.g. `Title of something` */
 export const TITLE = new StringSchema({ title: "Title", min: 1, max: 100 });
 /** Optional name string, e.g. `Title of something` or `null` */

package/iterate/AbstractIterator.d.ts

@@ -1,7 +0,0 @@
-/** Abstract generator designed to be extended that implements the full generator protocol. */
-export declare abstract class AbstractIterator<T, R, N> implements Iterator<T, R, N>, Iterable<T, R, N> {
-    abstract next(value: N): IteratorResult<T, R>;
-    throw(thrown: unknown): IteratorResult<T, R>;
-    return(value: R): IteratorResult<T, R>;
-    [Symbol.iterator](): Iterator<T, R, N>;
-}

package/iterate/AbstractIterator.js

@@ -1,15 +0,0 @@
-/** Abstract generator designed to be extended that implements the full generator protocol. */
-export class AbstractIterator {
-    throw(thrown) {
-        // Default behaviour for a generator is to throw the error back out of the iterator and not continue.
-        throw thrown;
-    }
-    return(value) {
-        // Default behaviour for a generator is to return `done: true` and the input value.
-        return { done: true, value };
-    }
-    // Implement `Iterable`
-    [Symbol.iterator]() {
-        return this;
-    }
-}

package/iterate/InspectIterator.d.ts

@@ -1,31 +0,0 @@
-import { ThroughIterator } from "./ThroughIterator.js";
-/**
- * Iterable that inspects a source iterable as it iterates.
- * - Stores: first/last yielded value, returned value, whether iteration is done, the number of items that were iterated.
- *
- * @example
- * 	const watch = new InspectIterator(iterable);
- * 	for (const next of capture) console.log("YIELDED", next);
- * 	console.log("FIRST", watch.first);
- * 	console.log("RETURNED", watch.returned);
- */
-export declare class InspectIterator<T, R, N> extends ThroughIterator<T, R, N> implements Iterator<T, R, N>, Iterable<T, R, N> {
-    /** Get the number of results received by this iterator so far. */
-    readonly count = 0;
-    /** Is the iteration done? */
-    readonly done: boolean;
-    /** The first yielded value (throws if the iteration yielded no values, i.e. `this.count === 0`). */
-    get first(): T;
-    private _first;
-    /** The last yielded value (throws if the iteration yielded no values, i.e. `this.count === 0`). */
-    get last(): T;
-    private _last;
-    /** The returned value (throws if the iteration is not done, i.e. `this.done === false`). */
-    get returned(): R;
-    private _returned;
-    next(value: N): IteratorResult<T, R>;
-    throw(thrown: unknown): IteratorResult<T, R>;
-    return(value: R): IteratorResult<T, R>;
-    /** Capture a result. */
-    private _inspect;
-}

package/iterate/InspectIterator.js

@@ -1,75 +0,0 @@
-import { UnexpectedError } from "../error/UnexpectedError.js";
-import { getGetter } from "../util/class.js";
-import { ThroughIterator } from "./ThroughIterator.js";
-/** Used when the sequence hasn't inspected anything yet. */
-const _NOVALUE = Symbol("shelving/InspectGenerator.NOVALUE");
-/**
- * Iterable that inspects a source iterable as it iterates.
- * - Stores: first/last yielded value, returned value, whether iteration is done, the number of items that were iterated.
- *
- * @example
- * 	const watch = new InspectIterator(iterable);
- * 	for (const next of capture) console.log("YIELDED", next);
- * 	console.log("FIRST", watch.first);
- * 	console.log("RETURNED", watch.returned);
- */
-export class InspectIterator extends ThroughIterator {
-    /** Get the number of results received by this iterator so far. */
-    count = 0;
-    /** Is the iteration done? */
-    done = false;
-    /** The first yielded value (throws if the iteration yielded no values, i.e. `this.count === 0`). */
-    get first() {
-        if (this._first === _NOVALUE)
-            throw new UnexpectedError("Iteration not started", {
-                iterator: this,
-                caller: getGetter(this, "first"),
-            });
-        return this._first;
-    }
-    _first = _NOVALUE;
-    /** The last yielded value (throws if the iteration yielded no values, i.e. `this.count === 0`). */
-    get last() {
-        if (this._last === _NOVALUE)
-            throw new UnexpectedError("Iteration not started", {
-                iterator: this,
-                caller: getGetter(this, "last"),
-            });
-        return this._last;
-    }
-    _last = _NOVALUE;
-    /** The returned value (throws if the iteration is not done, i.e. `this.done === false`). */
-    get returned() {
-        if (this._returned === _NOVALUE)
-            throw new UnexpectedError("Iteration not done", {
-                iterator: this,
-                caller: getGetter(this, "returned"),
-            });
-        return this._returned;
-    }
-    _returned = _NOVALUE;
-    // Override to watch returned values.
-    next(value) {
-        return this._inspect(this.next(value));
-    }
-    throw(thrown) {
-        return this._inspect(this.throw(thrown));
-    }
-    return(value) {
-        return this._inspect(this.return(value));
-    }
-    /** Capture a result. */
-    _inspect(result) {
-        if (!result.done) {
-            if (this.first === undefined)
-                this._first = result.value;
-            this._last = result.value;
-            this.count++;
-        }
-        else {
-            this._returned = result.value;
-            this.done = true;
-        }
-        return result;
-    }
-}

package/iterate/ThroughIterator.d.ts

@@ -1,9 +0,0 @@
-import { AbstractIterator } from "./AbstractIterator.js";
-/** Iterable that pulls values from a source iterable. */
-export declare class ThroughIterator<T, R, N> extends AbstractIterator<T, R, N> implements Iterator<T, R, N>, Iterable<T, R, N> {
-    private readonly _source;
-    constructor(iterator: Iterator<T, R, N>);
-    next(value: N): IteratorResult<T, R>;
-    throw(thrown: unknown): IteratorResult<T, R>;
-    return(value: R): IteratorResult<T, R>;
-}

package/iterate/ThroughIterator.js

@@ -1,19 +0,0 @@
-import { AbstractIterator } from "./AbstractIterator.js";
-/** Iterable that pulls values from a source iterable. */
-export class ThroughIterator extends AbstractIterator {
-    _source;
-    constructor(iterator) {
-        super();
-        this._source = iterator;
-    }
-    // Implement `AbstractIterator`
-    next(value) {
-        return this._source.next(value);
-    }
-    throw(thrown) {
-        return this._source.throw ? this._source.throw(thrown) : super.throw(thrown);
-    }
-    return(value) {
-        return this._source.return ? this._source.return(value) : super.return(value);
-    }
-}

package/iterate/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./AbstractIterator.js";
-export * from "./ThroughIterator.js";
-export * from "./InspectIterator.js";

package/iterate/index.js

@@ -1,3 +0,0 @@
-export * from "./AbstractIterator.js";
-export * from "./ThroughIterator.js";
-export * from "./InspectIterator.js";