@oscarpalmer/atoms 0.211.0 → 0.213.0

package/dist/color/instance.mjs

@@ -1,4 +1,3 @@
-import "../internal/subscription.mjs";
 import { herald } from "../internal/herald.mjs";
 import { COLOR_NAME, COLOR_PROPERTY, COLOR_SYMBOL, COLOR_TYPE, colorSubscription } from "./constants.mjs";
 import { getColorAlpha, setColorAlpha } from "./misc/alpha.mjs";

package/dist/color/models.d.mts

@@ -1,5 +1,5 @@
 import { Subscription } from "../internal/subscription.mjs";
-import { Herald, HeraldEvents } from "../internal/herald.mjs";
+import { Herald, HeraldEvents } from "../internal/models/herald.model.mjs";
 import { COLOR_SYMBOL } from "./constants.mjs";
 //#region src/color/models.d.ts
 export type Alpha = {

package/dist/herald.d.mts

@@ -1,2 +1,3 @@
+import { Herald, HeraldEvents } from "./internal/models/herald.model.mjs";
 import { herald, isHerald, isHeraldEvents, isHeraldSubscription } from "./internal/herald.mjs";
-export { herald, isHerald, isHeraldEvents, isHeraldSubscription };
+export { type Herald, type HeraldEvents, herald, isHerald, isHeraldEvents, isHeraldSubscription };

package/dist/index.d.mts

@@ -63,7 +63,7 @@ type _NestedValue<Value, Path extends string> = Path extends `${infer ItemKey}.$
 /**
  * The nested _(keyed)_ values of an object _(up to 5 levels deep)_
  */
-export type NestedValues<Value extends PlainObject> = { [Path in NestedKeys<Value>]: NestedValue<Value, Path>; };
+export type NestedValues<Value extends PlainObject> = Simplify<{ [Path in NestedKeys<Value>]: NestedValue<Value, Path>; }>;
 /**
  * The numerical keys of an object
  */
@@ -71,7 +71,7 @@ export type NumericalKeys<Value> = { [ItemKey in keyof Value]: ItemKey extends n
 /**
  * The numerical values of an object
  */
-export type NumericalValues<Item extends PlainObject> = { [ItemKey in keyof Item as Item[ItemKey] extends number ? ItemKey : never]: Item[ItemKey]; };
+export type NumericalValues<Item extends PlainObject> = Simplify<{ [ItemKey in keyof Item as Item[ItemKey] extends number ? ItemKey : never]: Item[ItemKey]; }>;
 /**
  * An asynchronous function that can only be called once, returning the same value on subsequent calls
  */
@@ -131,7 +131,7 @@ export type Primitive = null | undefined | string | number | boolean | symbol |
 /**
  * Set required keys for a type
  */
-export type RequiredKeys<Model extends object, Keys extends keyof Model> = Required<Pick<Model, Keys>> & Omit<Model, Keys>;
+export type RequiredKeys<Model extends object, Keys extends keyof Model> = Simplify<Required<Pick<Model, Keys>> & Omit<Model, Keys>>;
 /**
  * Flattens the type to improve type hints in IDEs
  *
@@ -4597,22 +4597,22 @@ type AsyncPlan<Yielded, Returned, Parameters extends unknown[]> = {
    *
    * @returns Asynchronous generator
    */
-  [Symbol.asyncIterator]: () => AsyncGenerator<Yielded, Returned, unknown>;
+  [Symbol.asyncIterator]: (...parameters: Parameters) => AsyncGenerator<Yielded, Returned>;
   /**
    * Attempt to run the plan to completion
    *
    * _Returns a promised {@link Result} instead of a raw value or throwing an error_
    *
-   * @returns Promised result
+   * @returns Attempted result
    */
-  attempt(...parameters: Parameters): Promise<Result<PlanResult<Returned>, PlanError<Yielded, Returned>>>;
+  attempt(...parameters: Parameters): Promise<Result<PlanOk<Returned>, PlanError<Yielded, Returned>>>;
   /**
    * Run the plan to completion
    *
    * @throws {PlanError<Yielded, Returned>}
    * @returns Result
    */
-  run(...parameters: Parameters): Promise<PlanResult<Returned>>;
+  run(...parameters: Parameters): Promise<PlanReturned<Returned>>;
 };
 /**
  * A plan of execution that can yield intermediate results and eventually return a result
@@ -4623,26 +4623,28 @@ type Plan<Yielded, Returned, Parameters extends unknown[]> = {
    *
    * @returns Generator
    */
-  [Symbol.iterator]: () => Generator<Yielded, Returned, unknown>;
+  [Symbol.iterator]: (...parameters: Parameters) => Generator<Yielded, Returned>;
   /**
    * Attempt to run the plan to completion
    *
    * _Returns a {@link Result} instead of a raw value or throwing an error_
    *
-   * @returns Result
+   * @returns Attempted result
    */
-  attempt(...parameters: Parameters): Result<PlanResult<Returned>, PlanError<Yielded, Returned>>;
+  attempt(...parameters: Parameters): Result<PlanOk<Returned>, PlanError<Yielded, Returned>>;
   /**
    * Run the plan to completion
    *
    * @throws {PlanError<Yielded, Returned>}
    * @returns Result
    */
-  run(...parameters: Parameters): PlanResult<Returned>;
+  run(...parameters: Parameters): PlanReturned<Returned>;
 };
-type PlanErrorValues<Original> = Original extends Error ? Original : Original extends Err<infer Error> ? Error : Original extends Result<infer _, infer Error> ? Error : never;
-type PlanError<Yielded, Returned> = PlanErrorValues<Yielded> | PlanErrorValues<Returned> | Error;
-type PlanResult<Returned> = Returned extends Error ? never : Returned extends Err<infer _> ? never : Returned extends Ok<infer Value> ? Value : Returned extends Result<infer Value, infer _> ? Value : Returned;
+type PlanOk<Returned> = Returned extends Error ? never : Returned extends Err<infer _> ? never : Returned extends Ok<infer Value> ? Value : Returned;
+type PlanErrors<Yielded, Returned> = PlanErrorValues<Yielded> | PlanErrorValues<Returned>;
+type PlanError<Yielded, Returned> = [PlanErrors<Yielded, Returned>] extends [never] ? Error : PlanErrors<Yielded, Returned>;
+type PlanErrorValues<Original> = Original extends Error ? Original : Original extends Err<infer Error> ? Error : never;
+type PlanReturned<Returned> = Returned extends Error ? never : Returned extends Err<infer _> ? never : Returned;
 //#endregion
 //#region src/plan/result.d.ts
 /**
@@ -4652,7 +4654,7 @@ type PlanResult<Returned> = Returned extends Error ? never : Returned extends Er
  *
  * @returns Promised result
  */
-export declare function asyncAttemptRun<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => AsyncGenerator<Yielded, Returned, unknown>, ...parameters: Parameters): Promise<Result<PlanResult<Returned>, PlanError<Yielded, Returned>>>;
+export declare function asyncAttemptRun<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => AsyncGenerator<Yielded, Returned>, ...parameters: Parameters): Promise<Result<PlanOk<Returned>, PlanError<Yielded, Returned>>>;
 /**
  * Attempt to run the plan to completion
  *
@@ -4660,7 +4662,7 @@ export declare function asyncAttemptRun<Yielded, Returned, Parameters extends un
  *
  * @returns Promised result
  */
-export declare function asyncAttemptRun<Yielded, Returned, Parameters extends unknown[]>(plan: AsyncPlan<Yielded, Returned, Parameters>, ...parameters: Parameters): Promise<Result<PlanResult<Returned>, PlanError<Yielded, Returned>>>;
+export declare function asyncAttemptRun<Yielded, Returned, Parameters extends unknown[]>(plan: AsyncPlan<Yielded, Returned, Parameters>, ...parameters: Parameters): Promise<Result<PlanOk<Returned>, PlanError<Yielded, Returned>>>;
 /**
  * Attempt to run the generator to completion
  *
@@ -4668,7 +4670,7 @@ export declare function asyncAttemptRun<Yielded, Returned, Parameters extends un
  *
  * @returns Result
  */
-export declare function attemptRun<Yielded, Returned>(generator: () => Generator<Yielded, Returned, unknown>, ...parameters: Parameters<typeof generator>): Result<PlanResult<Returned>, PlanError<Yielded, Returned>>;
+export declare function attemptRun<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => Generator<Yielded, Returned>, ...parameters: Parameters): Result<PlanOk<Returned>, PlanError<Yielded, Returned>>;
 /**
  * Attempt to run the plan to completion
  *
@@ -4676,7 +4678,7 @@ export declare function attemptRun<Yielded, Returned>(generator: () => Generator
  *
  * @returns Result
  */
-export declare function attemptRun<Yielded, Returned, Parameters extends unknown[]>(plan: Plan<Yielded, Returned, Parameters>, ...parameters: Parameters): Result<PlanResult<Returned>, PlanError<Yielded, Returned>>;
+export declare function attemptRun<Yielded, Returned, Parameters extends unknown[]>(plan: Plan<Yielded, Returned, Parameters>, ...parameters: Parameters): Result<PlanOk<Returned>, PlanError<Yielded, Returned>>;
 export declare namespace attemptRun {
   export var async: typeof asyncAttemptRun;
 }
@@ -4688,28 +4690,28 @@ export declare namespace attemptRun {
  * @param generator Generator to run
  * @returns Result
  */
-export declare function asyncRun<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => AsyncGenerator<Yielded, Returned, unknown>, ...parameters: Parameters): Promise<PlanResult<Returned>>;
+export declare function asyncRun<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => AsyncGenerator<Yielded, Returned>, ...parameters: Parameters): Promise<PlanReturned<Returned>>;
 /**
  * Run an asynchronous plan to completion
  *
  * @param plan Plan to run
  * @returns Result
  */
-export declare function asyncRun<Yielded, Returned, Parameters extends unknown[]>(plan: AsyncPlan<Yielded, Returned, Parameters>, ...parameters: Parameters): Promise<PlanResult<Returned>>;
+export declare function asyncRun<Yielded, Returned, Parameters extends unknown[]>(plan: AsyncPlan<Yielded, Returned, Parameters>, ...parameters: Parameters): Promise<PlanReturned<Returned>>;
 /**
  * Run a generator to completion
  *
  * @param generator Generator to run
  * @returns Result
  */
-export declare function run<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => Generator<Yielded, Returned, unknown>, ...parameters: Parameters): PlanResult<Returned> | PlanError<Yielded, Returned>;
+export declare function run<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => Generator<Yielded, Returned>, ...parameters: Parameters): PlanReturned<Returned>;
 /**
  * Run a plan to completion
  *
  * @param plan Plan to run
  * @returns Result
  */
-export declare function run<Yielded, Returned, Parameters extends unknown[]>(plan: Plan<Yielded, Returned, Parameters>, ...parameters: Parameters): PlanResult<Returned> | PlanError<Yielded, Returned>;
+export declare function run<Yielded, Returned, Parameters extends unknown[]>(plan: Plan<Yielded, Returned, Parameters>, ...parameters: Parameters): PlanReturned<Returned>;
 export declare namespace asyncRun {
   export var attempt: typeof asyncAttemptRun;
 }
@@ -4734,14 +4736,7 @@ export declare function plan<Yielded, Returned, Parameters extends unknown[]>(ge
  */
 export declare function plan<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => Generator<Yielded, Returned>): Plan<Yielded, Returned, Parameters>;
 //#endregion
-//#region src/internal/plan.d.ts
-/**
- * Create an immediately failing generator
- *
- * @param reason Failure reason
- * @returns Failing generator
- */
-export declare function fail<Reason>(reason: Reason): Generator<unknown, never>;
+//#region src/plan/is.d.ts
 /**
  * Is the value an asynchronous generator function?
  *
@@ -4770,13 +4765,26 @@ export declare function isGenerator(value: unknown): value is () => Generator;
  * @returns `true` if the value is a plan, otherwise `false`
  */
 export declare function isPlan<Yielded = unknown, Returned = unknown, Parameters extends unknown[] = unknown[]>(value: unknown): value is Plan<Yielded, Returned, Parameters>;
+//#endregion
+//#region src/plan/misc.d.ts
+/**
+ * Create an immediately failing plan
+ *
+ * @param reason Failure reason
+ * @returns Plan failure
+ */
+export declare function fail<Reason>(reason: Reason): Generator<Reason, void>;
 /**
- * Create an immediately succeeding generator
+ * Create an immediately succeeding plan
  *
  * @param value Success value
- * @returns Succeeding generator
+ * @returns Plan success
  */
-export declare function succeed<Value>(value: Value): Generator<unknown, Value>;
+export declare function succeed<Value>(value: Value): Generator<never, Value>;
+export declare function succeedResult<Returned>(value: Returned): Generator<never, Ok<Returned>>;
+export declare namespace succeed {
+  export var result: typeof succeedResult;
+}
 //#endregion
 //#region src/internal/aborter.d.ts
 type Aborter = {
@@ -4859,7 +4867,7 @@ export type PromiseStrategy = "complete" | "first";
 export declare class PromiseTimeoutError extends Error {
   constructor();
 }
-export type PromisesItems<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Promise<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Promise<Value> : Promise<Items[ItemsKey]>; };
+export type PromisesItems<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Promise<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Promise<Value> : Promise<Items[ItemsKey]>; } extends (infer Result) ? Result : never;
 /**
  * Options for handling multiple _Promises_
  */
@@ -4874,9 +4882,9 @@ export type PromisesOptions = {
   strategy?: PromiseStrategy;
 };
 export type PromisesResult<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? Result<Awaited<Value>> : never; };
-export type PromisesUnwrapped<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Awaited<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Awaited<Value> : never; };
-export type PromisesValue<Value> = FulfilledPromise<Value> | RejectedPromise;
-export type PromisesValues<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never; };
+export type PromisesUnwrapped<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Awaited<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Awaited<Value> : never; } extends (infer Result) ? Result : never;
+export type PromisesValue<Value> = (FulfilledPromise<Value> | RejectedPromise);
+export type PromisesValues<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never; } extends (infer Result) ? Result : never;
 /**
  * A _Promise_ that was rejected
  */
@@ -6350,7 +6358,7 @@ export declare function pick<Value extends PlainObject, ValueKey extends keyof V
 /**
  * A shaken object, without any `undefined` values
  */
-type Shaken<Value extends PlainObject> = { [Key in keyof Value]: Value[Key] extends undefined ? never : Value[Key]; };
+type Shaken<Value extends PlainObject> = Simplify<{ [Key in keyof Value as undefined extends Value[Key] ? never : Key]: Value[Key]; } & { [Key in keyof Value as undefined extends Value[Key] ? [Value[Key]] extends [undefined] ? never : Key : never]?: Exclude<Value[Key], undefined>; }>;
 /**
  * Shake an object, removing all keys with `undefined` values
  *
@@ -6795,7 +6803,7 @@ export declare function isBeaconSubscription(value: unknown): value is Subscript
  */
 export declare function isObservable<Value = unknown>(value: unknown): value is Observable<Value>;
 //#endregion
-//#region src/internal/herald.d.ts
+//#region src/internal/models/herald.model.d.ts
 type Herald<Events extends Record<string, GenericCallback>> = {
   readonly events: HeraldEvents<Events>;
   /**
@@ -6833,35 +6841,6 @@ type HeraldOptions<Events extends Record<string, GenericCallback>> = {
   property?: SubscriptionProperty;
   onCreate?: HeraldOnCreate<Events>;
 };
-/**
- * Create a _Herald_ for announcing named events
- *
- * @param names Event names
- * @param property Optional property for subscription identification _(defaults to `$herald`)_
- * @returns _Herald_ instance
- */
-export declare function herald<Events extends Record<string, GenericCallback>>(options: HeraldOptions<Events>): Herald<Events>;
-/**
- * Is the value a herald?
- *
- * @param value Value to check
- * @returns `true` if the value is a herald, otherwise `false`
- */
-export declare function isHerald<Events extends Record<string, GenericCallback> = Record<string, GenericCallback>>(value: unknown): value is Herald<Events>;
-/**
- * Is the value events for a herald?
- *
- * @param value Value to check
- * @returns `true` if the value is events for a herald, otherwise `false`
- */
-export declare function isHeraldEvents<Events extends Record<string, GenericCallback> = Record<string, GenericCallback>>(value: unknown): value is HeraldEvents<Events>;
-/**
- * Is the value a herald subscription?
- *
- * @param value Value to check
- * @returns `true` if the value is a herald subscription, otherwise `false`
- */
-export declare function isHeraldSubscription(value: unknown): value is Subscription;
 //#endregion
 //#region src/color/models.d.ts
 /**
@@ -7539,6 +7518,37 @@ export declare function rgbToHwba(rgb: RGBAColor | RGBColor): HWBAColor;
  */
 export declare function getColor(value: unknown): Color;
 //#endregion
+//#region src/internal/herald.d.ts
+/**
+ * Create a _Herald_ for announcing named events
+ *
+ * @param names Event names
+ * @param property Optional property for subscription identification _(defaults to `$herald`)_
+ * @returns _Herald_ instance
+ */
+export declare function herald<Events extends Record<string, GenericCallback>>(options: HeraldOptions<Events>): Herald<Events>;
+/**
+ * Is the value a herald?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is a herald, otherwise `false`
+ */
+export declare function isHerald<Events extends Record<string, GenericCallback> = Record<string, GenericCallback>>(value: unknown): value is Herald<Events>;
+/**
+ * Is the value events for a herald?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is events for a herald, otherwise `false`
+ */
+export declare function isHeraldEvents<Events extends Record<string, GenericCallback> = Record<string, GenericCallback>>(value: unknown): value is HeraldEvents<Events>;
+/**
+ * Is the value a herald subscription?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is a herald subscription, otherwise `false`
+ */
+export declare function isHeraldSubscription(value: unknown): value is Subscription;
+//#endregion
 //#region src/internal/is.d.ts
 /**
  * Is the value an array or a plain object?
@@ -8508,4 +8518,4 @@ export declare class SizedSet<Value = unknown> extends Set<Value> {
   get(value: Value, update?: boolean): Value | undefined;
 }
 //#endregion
-export { type AsyncLimiter, type AsyncPlan, type Color, type ColorType, type ColorTypeExtended, type ColorValue, type ColorValueExtended, type HSLAColor, type HSLColor, type HWBAColor, type HWBColor, Key$1 as Key, type Limiter, Logger, type Plan, type RGBAColor, type RGBColor, type Shaken, type Smushed, type Subscription, type SubscriptionParameters, type SubscriptionProperty, type Subscriptions, type SubscriptionsParameters, type TimeLogger, type Unsmushed, push as append, filterAndMap as select, toPromise as fromResult, getRandomFloatingNumber as getRandomFloat, isLogger, isTimeLogger, mapAndFilter as reverseSelect };
+export { type AsyncLimiter, type AsyncPlan, type Color, type ColorType, type ColorTypeExtended, type ColorValue, type ColorValueExtended, type HSLAColor, type HSLColor, type HWBAColor, type HWBColor, type Herald, type HeraldEvents, Key$1 as Key, type Limiter, Logger, type Plan, type RGBAColor, type RGBColor, type Shaken, type Smushed, type Subscription, type SubscriptionParameters, type SubscriptionProperty, type Subscriptions, type SubscriptionsParameters, type TimeLogger, type Unsmushed, push as append, filterAndMap as select, toPromise as fromResult, getRandomFloatingNumber as getRandomFloat, isLogger, isTimeLogger, mapAndFilter as reverseSelect };

package/dist/index.mjs

@@ -2756,19 +2756,7 @@ const PLAN_SYMBOL = Symbol("plan");
 const PLAN_TYPE_PLAN_ASYNC = "asyncPlan";
 const PLAN_TYPE_PLAN_SYNC = "plan";
 //#endregion
-//#region src/internal/plan.ts
-/**
-* Create an immediately failing generator
-*
-* @param reason Failure reason
-* @returns Failing generator
-*/
-function fail(reason) {
-	return (function* () {
-		yield;
-		throw reason;
-	})();
-}
+//#region src/plan/is.ts
 /**
 * Is the value an asynchronous generator function?
 *
@@ -2811,21 +2799,9 @@ function isPlan(value) {
 function isPlanInstance(type, value) {
 	return typeof value === "object" && value !== null && PLAN_SYMBOL in value && value[PLAN_SYMBOL].type === type;
 }
-/**
-* Create an immediately succeeding generator
-*
-* @param value Success value
-* @returns Succeeding generator
-*/
-function succeed(value) {
-	return (function* () {
-		yield;
-		return value;
-	})();
-}
 //#endregion
 //#region src/plan/generate.ts
-async function asyncGenerate(callback, parameters) {
+async function asyncGenerate(callback, parameters, unwrap) {
 	const generator = callback(...parameters);
 	let success = true;
 	let lastValue;
@@ -2845,10 +2821,10 @@ async function asyncGenerate(callback, parameters) {
 	} finally {
 		await generator?.return(lastValue);
 	}
-	if (success) return lastValue;
+	if (success) return unwrap && isOk(lastValue) ? lastValue.value : lastValue;
 	throw lastValue;
 }
-function generate(callback, parameters) {
+function generate(callback, parameters, unwrap) {
 	const generator = callback(...parameters);
 	let success = true;
 	let lastValue;
@@ -2868,45 +2844,45 @@ function generate(callback, parameters) {
 	} finally {
 		generator.return(lastValue);
 	}
-	if (success) return lastValue;
+	if (success) return unwrap && isOk(lastValue) ? lastValue.value : lastValue;
 	throw lastValue;
 }
 //#endregion
 //#region src/plan/result.ts
 function asyncAttemptRun(input, ...parameters) {
 	if (isAsyncPlan(input)) return input.attempt(...parameters);
-	if (isAsyncGenerator(input)) return asyncAttempt(() => asyncGenerate(input, parameters));
+	if (isAsyncGenerator(input)) return asyncAttempt(() => asyncGenerate(input, parameters, true));
 	throw new Error(PLAN_MESSAGE_RUN_INPUT);
 }
 function attemptRun(input, ...parameters) {
 	if (isPlan(input)) return input.attempt(...parameters);
-	if (isGenerator(input)) return attempt(() => generate(input, parameters));
+	if (isGenerator(input)) return attempt(() => generate(input, parameters, true));
 	throw new Error(PLAN_MESSAGE_RUN_INPUT);
 }
 function attemptRunAsyncPlan(...parameters) {
-	return asyncAttempt(() => this.run(...parameters));
+	return asyncAttempt(() => asyncGenerate(this[PLAN_SYMBOL].generator, parameters, true));
 }
 function attemptRunPlan(...parameters) {
-	return attempt(() => this.run(...parameters));
+	return attempt(() => generate(this[PLAN_SYMBOL].generator, parameters, true));
 }
 attemptRun.async = asyncAttemptRun;
 //#endregion
 //#region src/plan/run.ts
 function asyncRun(input, ...parameters) {
 	if (isAsyncPlan(input)) return input.run(...parameters);
-	if (isAsyncGenerator(input)) return asyncGenerate(input, parameters);
+	if (isAsyncGenerator(input)) return asyncGenerate(input, parameters, false);
 	throw new Error(PLAN_MESSAGE_RUN_INPUT);
 }
 function run(input, ...parameters) {
 	if (isPlan(input)) return input.run(...parameters);
-	if (isGenerator(input)) return generate(input, parameters);
+	if (isGenerator(input)) return generate(input, parameters, false);
 	throw new Error(PLAN_MESSAGE_RUN_INPUT);
 }
 function runAsyncPlan(...parameters) {
-	return asyncGenerate(this[PLAN_SYMBOL].generator, parameters);
+	return asyncGenerate(this[PLAN_SYMBOL].generator, parameters, false);
 }
 function runPlan(...parameters) {
-	return generate(this[PLAN_SYMBOL].generator, parameters);
+	return generate(this[PLAN_SYMBOL].generator, parameters, false);
 }
 asyncRun.attempt = asyncAttemptRun;
 run.async = asyncRun;
@@ -2941,6 +2917,36 @@ function plan(generator) {
 	throw new Error(PLAN_MESSAGE_PLAN_INPUT);
 }
 //#endregion
+//#region src/plan/misc.ts
+/**
+* Create an immediately failing plan
+*
+* @param reason Failure reason
+* @returns Plan failure
+*/
+function fail(reason) {
+	return (function* () {
+		throw reason;
+	})();
+}
+/**
+* Create an immediately succeeding plan
+*
+* @param value Success value
+* @returns Plan success
+*/
+function succeed(value) {
+	return (function* () {
+		return value;
+	})();
+}
+function succeedResult(value) {
+	return (function* () {
+		return ok(value);
+	})();
+}
+succeed.result = succeedResult;
+//#endregion
 //#region src/internal/aborter.ts
 function createAborter(value, onAbort) {
 	if (!(value instanceof AbortSignal)) return;
@@ -4847,10 +4853,20 @@ const beaconSubscription = {
 	value: SUBSCRIPTION_NAME
 };
 //#endregion
-//#region src/internal/herald.ts
+//#region src/internal/models/herald.model.ts
+const HERALD_MESSAGE_ARRAY = "Herald requires an array of event names.";
+const HERALD_MESSAGE_ONCREATE = `Herald requires a valid onCreate callback for subscription creation`;
+const HERALD_MESSAGE_PROPERTY = `Herald requires valid property information for subscription identification`;
 const HERALD_NAME_EVENTS = "events";
 const HERALD_NAME_HERALD = "herald";
 const HERALD_PROPERTY = "$herald";
+const HERALD_SYMBOL = Symbol(HERALD_PROPERTY);
+const heraldSubscription = {
+	key: HERALD_PROPERTY,
+	value: SUBSCRIPTION_NAME
+};
+//#endregion
+//#region src/internal/herald.ts
 function Events(herald, state) {
 	for (const key of state.keys) Object.defineProperty(this, key, { value: (callback, signal) => herald.subscribe(key, callback, signal) });
 }
@@ -4937,7 +4953,7 @@ function isHeraldEvents(value) {
 	return isHeraldInstance(HERALD_NAME_EVENTS, value);
 }
 function isHeraldInstance(name, value) {
-	return typeof value === "object" && value !== null && HERALD_PROPERTY in value && value[HERALD_PROPERTY] === name;
+	return typeof value === "object" && value !== null && "$herald" in value && value["$herald"] === name;
 }
 /**
 * Is the value a herald subscription?
@@ -4946,7 +4962,7 @@ function isHeraldInstance(name, value) {
 * @returns `true` if the value is a herald subscription, otherwise `false`
 */
 function isHeraldSubscription(value) {
-	return isSubscription(value) && HERALD_PROPERTY in value && value[HERALD_PROPERTY] === "subscription";
+	return isSubscription(value) && "$herald" in value && value["$herald"] === "subscription";
 }
 function subscribeToHerald(key, callback, signal) {
 	const { state } = this[HERALD_SYMBOL];
@@ -4958,14 +4974,6 @@ function subscribeToHerald(key, callback, signal) {
 	if (!existing) state.onCreate?.(key, callback, subscription);
 	return subscription;
 }
-const HERALD_MESSAGE_ARRAY = "Herald requires an array of event names.";
-const HERALD_MESSAGE_ONCREATE = `Herald requires a valid onCreate callback for subscription creation`;
-const HERALD_MESSAGE_PROPERTY = `Herald requires valid property information for subscription identification`;
-const HERALD_SYMBOL = Symbol(HERALD_PROPERTY);
-const heraldSubscription = {
-	key: HERALD_PROPERTY,
-	value: SUBSCRIPTION_NAME
-};
 //#endregion
 //#region src/color/constants.ts
 const COLOR_ALPHA = {
@@ -7041,4 +7049,4 @@ var SizedSet = class extends Set {
 	}
 };
 //#endregion
-export { CancelablePromise, Logger, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, push as append, push, assert, assertCondition, assertDefined, assertInstanceOf, assertIs, assertProperty, assign, asyncAttempt, asyncAttemptRun, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncRun, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, attemptRun, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, copy, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, fail, filter, filterAndMap, filterAndMap as select, find, findLast, first, firstOrDefault, flatFreeze, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, herald, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeCloner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isAsyncGenerator, isAsyncOnce, isAsyncPlan, isBeacon, isBeaconSubscription, isColor, isConstructor, isEmpty, isError, isFrozen, isFulfilled, isFuzzy, isGenerator, isHerald, isHeraldEvents, isHeraldSubscription, isHexColor, isHslColor, isHslaColor, isHwbColor, isHwbaColor, isInstanceOf, isKey, isKeyedQueue, isLogger, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTemplateStringsArray, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isObservable, isOk, isOnce, isPlainObject, isPlan, isPrimitive, isQueue, isQueueInstance, isRejected, isResult, isRgbColor, isRgbaColor, isSorted, isSubscription, isSubscriptions, isTemplateStringsArray, isTimeLogger, isTypedArray, join, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, lowerCase, mapAndFilter, mapAndFilter as reverseSelect, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, normalize, ok, omit, once, parse, partition, pascalCase, pick, pipe, plan, promises, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba, round, run, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, subscriptions, succeed, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, toResult, toSet, toggle, transform, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, Logger, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, push as append, push, assert, assertCondition, assertDefined, assertInstanceOf, assertIs, assertProperty, assign, asyncAttempt, asyncAttemptRun, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncRun, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, attemptRun, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, copy, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, fail, filter, filterAndMap, filterAndMap as select, find, findLast, first, firstOrDefault, flatFreeze, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, herald, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeCloner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isAsyncGenerator, isAsyncOnce, isAsyncPlan, isBeacon, isBeaconSubscription, isColor, isConstructor, isEmpty, isError, isFrozen, isFulfilled, isFuzzy, isGenerator, isHerald, isHeraldEvents, isHeraldSubscription, isHexColor, isHslColor, isHslaColor, isHwbColor, isHwbaColor, isInstanceOf, isKey, isKeyedQueue, isLogger, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTemplateStringsArray, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isObservable, isOk, isOnce, isPlainObject, isPlan, isPrimitive, isQueue, isQueueInstance, isRejected, isResult, isRgbColor, isRgbaColor, isSorted, isSubscription, isSubscriptions, isTemplateStringsArray, isTimeLogger, isTypedArray, join, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, lowerCase, mapAndFilter, mapAndFilter as reverseSelect, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, normalize, ok, omit, once, parse, partition, pascalCase, pick, pipe, plan, promises, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba, round, run, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, subscriptions, succeed, succeedResult, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, toResult, toSet, toggle, transform, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/internal/herald.d.mts

@@ -1,43 +1,7 @@
 import { GenericCallback } from "../models.mjs";
-import { Subscription, SubscriptionProperty } from "./subscription.mjs";
+import { Subscription } from "./subscription.mjs";
+import { Herald, HeraldEvents, HeraldOptions } from "./models/herald.model.mjs";
 //#region src/internal/herald.d.ts
-export type Herald<Events extends Record<string, GenericCallback>> = {
-  readonly events: HeraldEvents<Events>;
-  /**
-   * Remove all event subscribers
-   */
-  clear(): void;
-  /**
-   * Emit an event with parameters
-   *
-   * @param event Event name
-   * @param parameters Event parameters
-   */
-  emit<Event extends keyof Events>(event: Event, ...parameters: Parameters<Events[Event]>): void;
-  /**
-   * Is the event observed by any subscribers?
-   *
-   * @param event Event name
-   * @returns `true` if the event is observed, otherwise `false`
-   */
-  observed<Event extends keyof Events>(event: Event): boolean;
-  /**
-   * Subscribe to an event with a callback
-   *
-   * @param event Event name
-   * @param callback Callback function
-   * @param signal Optional abort signal to cancel the subscription
-   * @returns Subscription instance
-   */
-  subscribe<Event extends keyof Events>(event: Event, callback: Events[Event], signal?: AbortSignal): Subscription;
-};
-export type HeraldEvents<Events extends Record<string, GenericCallback>> = { [Key in keyof Events]: Key extends "*" ? never : (callback: Events[Key], signal?: AbortSignal) => void; };
-type HeraldOnCreate<Events extends Record<string, GenericCallback>> = <Event extends keyof Events>(event: Event, callback: Events[Event], subscription: Subscription) => void;
-export type HeraldOptions<Events extends Record<string, GenericCallback>> = {
-  names: Array<keyof Events>;
-  property?: SubscriptionProperty;
-  onCreate?: HeraldOnCreate<Events>;
-};
 /**
  * Create a _Herald_ for announcing named events
  *

package/dist/internal/herald.mjs

@@ -1,9 +1,7 @@
 import { isPlainObject } from "./is.mjs";
-import { SUBSCRIPTION_NAME, isSubscription, subscriptions } from "./subscription.mjs";
+import { isSubscription, subscriptions } from "./subscription.mjs";
+import { HERALD_MESSAGE_ARRAY, HERALD_MESSAGE_ONCREATE, HERALD_MESSAGE_PROPERTY, HERALD_NAME_EVENTS, HERALD_NAME_HERALD, HERALD_PROPERTY, HERALD_SYMBOL, heraldSubscription } from "./models/herald.model.mjs";
 //#region src/internal/herald.ts
-const HERALD_NAME_EVENTS = "events";
-const HERALD_NAME_HERALD = "herald";
-const HERALD_PROPERTY = "$herald";
 function Events(herald, state) {
 	for (const key of state.keys) Object.defineProperty(this, key, { value: (callback, signal) => herald.subscribe(key, callback, signal) });
 }
@@ -91,7 +89,7 @@ function isHeraldEvents(value) {
 	return isHeraldInstance(HERALD_NAME_EVENTS, value);
 }
 function isHeraldInstance(name, value) {
-	return typeof value === "object" && value !== null && HERALD_PROPERTY in value && value[HERALD_PROPERTY] === name;
+	return typeof value === "object" && value !== null && "$herald" in value && value["$herald"] === name;
 }
 /**
 * Is the value a herald subscription?
@@ -100,7 +98,7 @@ function isHeraldInstance(name, value) {
 * @returns `true` if the value is a herald subscription, otherwise `false`
 */
 function isHeraldSubscription(value) {
-	return isSubscription(value) && HERALD_PROPERTY in value && value[HERALD_PROPERTY] === "subscription";
+	return isSubscription(value) && "$herald" in value && value["$herald"] === "subscription";
 }
 function subscribeToHerald(key, callback, signal) {
 	const { state } = this[HERALD_SYMBOL];
@@ -112,13 +110,5 @@ function subscribeToHerald(key, callback, signal) {
 	if (!existing) state.onCreate?.(key, callback, subscription);
 	return subscription;
 }
-const HERALD_MESSAGE_ARRAY = "Herald requires an array of event names.";
-const HERALD_MESSAGE_ONCREATE = `Herald requires a valid onCreate callback for subscription creation`;
-const HERALD_MESSAGE_PROPERTY = `Herald requires valid property information for subscription identification`;
-const HERALD_SYMBOL = Symbol(HERALD_PROPERTY);
-const heraldSubscription = {
-	key: HERALD_PROPERTY,
-	value: SUBSCRIPTION_NAME
-};
 //#endregion
 export { herald, isHerald, isHeraldEvents, isHeraldSubscription };