@oscarpalmer/atoms 0.209.0 → 0.211.0

package/dist/array/sort.d.mts

@@ -53,7 +53,7 @@ export type ArrayValueSorter<Item> = {
   /**
    * Value to sort by
    */
-  value: (item: Item) => unknown;
+  value(item: Item): unknown;
 };
 /**
  * Comparator to use when comparing items and values

package/dist/color/models.d.mts

@@ -187,16 +187,16 @@ export type Color = {
   unsubscribe(): void;
 };
 export type ColorChanges = {
-  "*": (value: Color) => void;
-  alpha: (value: number) => void;
-  hex: (value: string) => void;
-  hexa: (value: string) => void;
-  hsl: (value: HSLColor) => void;
-  hsla: (value: HSLAColor) => void;
-  hwb: (value: HWBColor) => void;
-  hwba: (value: HWBAColor) => void;
-  rgb: (value: RGBColor) => void;
-  rgba: (value: RGBAColor) => void;
+  "*"(value: Color): void;
+  alpha(value: number): void;
+  hex(value: string): void;
+  hexa(value: string): void;
+  hsl(value: HSLColor): void;
+  hsla(value: HSLAColor): void;
+  hwb(value: HWBColor): void;
+  hwba(value: HWBAColor): void;
+  rgb(value: RGBColor): void;
+  rgba(value: RGBAColor): void;
 };
 export type ColorDefaults = {
   alpha: Alpha;

package/dist/index.d.mts

@@ -90,7 +90,7 @@ export type OnceAsync<Callback extends GenericAsyncCallback> = {
    * @param parameters Callback parameters
    * @returns Call result
    */
-  run: (...parameters: Parameters<Callback>) => ReturnType<Callback>;
+  run(...parameters: Parameters<Callback>): ReturnType<Callback>;
 } & OnceProperties;
 /**
  * A callback function that can only be called once, returning the same value on subsequent calls
@@ -102,7 +102,7 @@ export type Once<Callback extends GenericCallback> = {
    * @param parameters Callback parameters
    * @returns Call result
    */
-  run: (...parameters: Parameters<Callback>) => ReturnType<Callback>;
+  run(...parameters: Parameters<Callback>): ReturnType<Callback>;
 } & OnceProperties;
 type OnceProperties = {
   /**
@@ -116,7 +116,7 @@ type OnceProperties = {
   /**
    * Clear the callback's cached value
    */
-  clear: () => void;
+  clear(): void;
 };
 /**
  * A generic object
@@ -2615,7 +2615,7 @@ export type ArrayValueSorter<Item> = {
   /**
    * Value to sort by
    */
-  value: (item: Item) => unknown;
+  value(item: Item): unknown;
 };
 /**
  * Comparator to use when comparing items and values
@@ -3711,14 +3711,14 @@ export type ResultMatch<Value, Returned, E = Error> = {
    * @param original Original error, if available
    * @returns Value to return
    */
-  error: (error: E, original?: Error) => Returned;
+  error(error: E, original?: Error): Returned;
   /**
    * Callback for ok result
    *
    * @param value Ok value
    * @returns Value to return
    */
-  ok: (value: Value) => Returned;
+  ok(value: Value): Returned;
 };
 /**
  * Unwrap a result value
@@ -4257,9 +4257,9 @@ type BaseHandler = {
   handlers: WeakMap<WeakKey, string | GenericCallback>;
   options: BaseHandlerOptions;
   owner: GenericCallback;
-  deregister: (constructor: Constructor) => void;
-  get: (first: unknown, second: unknown) => string | GenericCallback | undefined;
-  register: (constructor: Constructor, handler?: string | GenericCallback) => void;
+  deregister(constructor: Constructor): void;
+  get(first: unknown, second: unknown): string | GenericCallback | undefined;
+  register(constructor: Constructor, handler?: string | GenericCallback): void;
 };
 type BaseHandlerOptions = {
   callback: GenericCallback;
@@ -4591,67 +4591,157 @@ export declare function setValue<Data extends PlainObject>(data: Data, path: str
 /**
  * An asynchronous plan of execution that can yield intermediate results and eventually return a result
  */
-type AsyncPlan<Value, Error = unknown> = {
+type AsyncPlan<Yielded, Returned, Parameters extends unknown[]> = {
   /**
    * Get the asynchronous generator for the plan
    *
    * @returns Asynchronous generator
    */
-  [Symbol.asyncIterator]: () => AsyncGenerator<unknown, Value, unknown>;
+  [Symbol.asyncIterator]: () => AsyncGenerator<Yielded, Returned, unknown>;
+  /**
+   * Attempt to run the plan to completion
+   *
+   * _Returns a promised {@link Result} instead of a raw value or throwing an error_
+   *
+   * @returns Promised result
+   */
+  attempt(...parameters: Parameters): Promise<Result<PlanResult<Returned>, PlanError<Yielded, Returned>>>;
   /**
    * Run the plan to completion
    *
+   * @throws {PlanError<Yielded, Returned>}
    * @returns Result
    */
-  run: () => Promise<Result<Value, Error>>;
+  run(...parameters: Parameters): Promise<PlanResult<Returned>>;
 };
 /**
  * A plan of execution that can yield intermediate results and eventually return a result
  */
-type Plan<Value, Error = unknown> = {
+type Plan<Yielded, Returned, Parameters extends unknown[]> = {
   /**
    * Get the generator for the plan
    *
    * @returns Generator
    */
-  [Symbol.iterator]: () => Generator<unknown, Value, unknown>;
+  [Symbol.iterator]: () => Generator<Yielded, Returned, unknown>;
+  /**
+   * Attempt to run the plan to completion
+   *
+   * _Returns a {@link Result} instead of a raw value or throwing an error_
+   *
+   * @returns Result
+   */
+  attempt(...parameters: Parameters): Result<PlanResult<Returned>, PlanError<Yielded, Returned>>;
   /**
    * Run the plan to completion
    *
+   * @throws {PlanError<Yielded, Returned>}
    * @returns Result
    */
-  run: () => Result<Value, Error>;
+  run(...parameters: Parameters): PlanResult<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;
 //#endregion
-//#region src/plan/index.d.ts
+//#region src/plan/result.d.ts
 /**
- * Create a plan for an asynchronous generator function
+ * Attempt to run the generator to completion
  *
- * @param generator Generator to plan for
- * @returns Generator plan
+ * _Returns a promised {@link Result} instead of a raw value or throwing an error_
+ *
+ * @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>>>;
+/**
+ * Attempt to run the plan to completion
+ *
+ * _Returns a promised {@link Result} instead of a raw value or throwing an error_
+ *
+ * @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>>>;
+/**
+ * Attempt to run the generator to completion
+ *
+ * _Returns a {@link Result} instead of a raw value or throwing an error_
+ *
+ * @returns Result
+ */
+export declare function attemptRun<Yielded, Returned>(generator: () => Generator<Yielded, Returned, unknown>, ...parameters: Parameters<typeof generator>): Result<PlanResult<Returned>, PlanError<Yielded, Returned>>;
+/**
+ * Attempt to run the plan to completion
+ *
+ * _Returns a {@link Result} instead of a raw value or throwing an error_
+ *
+ * @returns Result
  */
-export declare function asyncPlan<Value = unknown, Error = unknown>(generator: () => AsyncGenerator<unknown, Value, unknown>): AsyncPlan<Value, Error>;
+export declare function attemptRun<Yielded, Returned, Parameters extends unknown[]>(plan: Plan<Yielded, Returned, Parameters>, ...parameters: Parameters): Result<PlanResult<Returned>, PlanError<Yielded, Returned>>;
+export declare namespace attemptRun {
+  export var async: typeof asyncAttemptRun;
+}
+//#endregion
+//#region src/plan/run.d.ts
 /**
  * Run an asynchronous generator to completion
  *
  * @param generator Generator to run
  * @returns Result
  */
-export declare function asyncRun<Value = unknown, Error = unknown>(generator: () => AsyncGenerator<unknown, Value, unknown>): Promise<Result<Value, Error>>;
+export declare function asyncRun<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => AsyncGenerator<Yielded, Returned, unknown>, ...parameters: Parameters): Promise<PlanResult<Returned>>;
 /**
  * Run an asynchronous plan to completion
  *
  * @param plan Plan to run
  * @returns Result
  */
-export declare function asyncRun<Value = unknown, Error = unknown>(plan: AsyncPlan<Value, Error>): Promise<Result<Value, Error>>;
+export declare function asyncRun<Yielded, Returned, Parameters extends unknown[]>(plan: AsyncPlan<Yielded, Returned, Parameters>, ...parameters: Parameters): Promise<PlanResult<Returned>>;
 /**
- * Is the value an asynchronous plan?
+ * Run a generator to completion
  *
- * @param value Value to check
- * @returns `true` if the value is an asynchronous plan, otherwise `false`
+ * @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>;
+/**
+ * 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 namespace asyncRun {
+  export var attempt: typeof asyncAttemptRun;
+}
+export declare namespace run {
+  export var async: typeof asyncRun;
+  export var attempt: typeof attemptRun;
+}
+//#endregion
+//#region src/plan/index.d.ts
+/**
+ * Create a plan for an asynchronous generator function
+ *
+ * @param generator Generator to plan for
+ * @returns Generator plan
+ */
+export declare function plan<Yielded, Returned, Parameters extends unknown[]>(generator: (...parameters: Parameters) => AsyncGenerator<Yielded, Returned>): AsyncPlan<Yielded, Returned, Parameters>;
+/**
+ * Create a plan for a generator function
+ *
+ * @param generator Generator to plan for
+ * @returns Generator plan
+ */
+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 isAsyncPlan<Value = unknown, Error = unknown>(value: unknown): value is AsyncPlan<Value, Error>;
+export declare function fail<Reason>(reason: Reason): Generator<unknown, never>;
 /**
  * Is the value an asynchronous generator function?
  *
@@ -4659,6 +4749,13 @@ export declare function isAsyncPlan<Value = unknown, Error = unknown>(value: unk
  * @returns `true` if the value is an asynchronous generator function, otherwise `false`
  */
 export declare function isAsyncGenerator(value: unknown): value is () => AsyncGenerator;
+/**
+ * Is the value an asynchronous plan?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is an asynchronous plan, otherwise `false`
+ */
+export declare function isAsyncPlan<Yielded = unknown, Returned = unknown, Parameters extends unknown[] = unknown[]>(value: unknown): value is AsyncPlan<Yielded, Returned, Parameters>;
 /**
  * Is the value a generator function?
  *
@@ -4672,40 +4769,20 @@ export declare function isGenerator(value: unknown): value is () => Generator;
  * @param value Value to check
  * @returns `true` if the value is a plan, otherwise `false`
  */
-export declare function isPlan<Value = unknown, Error = unknown>(value: unknown): value is Plan<Value, Error>;
-/**
- * Create a plan for a generator function
- *
- * @param generator Generator to plan for
- * @returns Generator plan
- */
-export declare function plan<Value = unknown, Error = unknown>(generator: () => Generator<unknown, Value, Error>): Plan<Value, Error>;
-/**
- * Run a generator to completion
- *
- * @param generator Generator to run
- * @returns Result
- */
-export declare function run<Value = unknown, Error = unknown>(generator: () => Generator<unknown, Value, unknown>): Result<Value, Error>;
+export declare function isPlan<Yielded = unknown, Returned = unknown, Parameters extends unknown[] = unknown[]>(value: unknown): value is Plan<Yielded, Returned, Parameters>;
 /**
- * Run a plan to completion
+ * Create an immediately succeeding generator
  *
- * @param plan Plan to run
- * @returns Result
+ * @param value Success value
+ * @returns Succeeding generator
  */
-export declare function run<Value = unknown, Error = unknown>(plan: Plan<Value, Error>): Result<Value, Error>;
-export declare namespace plan {
-  export var async: typeof asyncPlan;
-}
-export declare namespace run {
-  export var async: typeof asyncRun;
-}
+export declare function succeed<Value>(value: Value): Generator<unknown, Value>;
 //#endregion
 //#region src/internal/aborter.d.ts
 type Aborter = {
   callback: GenericCallback;
+  cancel(): void;
   signal: AbortSignal;
-  cancel: () => void;
 };
 //#endregion
 //#region src/promise/constants.d.ts
@@ -4744,8 +4821,8 @@ export type PromiseData = {
   result: ArrayOrPlainObject;
 };
 export type PromiseHandlers = {
-  resolve: (value: unknown[]) => void;
-  reject: (reason: unknown) => void;
+  resolve(value: unknown[]): void;
+  reject(reason: unknown): void;
 };
 /**
  * Options for a _Promise_-handling function
@@ -6541,14 +6618,14 @@ type Subscriptions<Value = unknown> = {
   /**
    * Clear all subscriptions
    */
-  clear: () => void;
+  clear(): void;
   /**
    * Create _(or retrieve)_ a subscription
    *
    * @param parameters Subscription parameters
    * @returns Tuple holding subsccription and existing boolean
    */
-  create: (parameters: SubscriptionParameters) => [Subscription, boolean];
+  create(parameters: SubscriptionParameters): [Subscription, boolean];
 };
 /**
  * Parameters for creating a subscription store
@@ -6968,16 +7045,16 @@ type Color = {
   unsubscribe(): void;
 };
 type ColorChanges = {
-  "*": (value: Color) => void;
-  alpha: (value: number) => void;
-  hex: (value: string) => void;
-  hexa: (value: string) => void;
-  hsl: (value: HSLColor) => void;
-  hsla: (value: HSLAColor) => void;
-  hwb: (value: HWBColor) => void;
-  hwba: (value: HWBAColor) => void;
-  rgb: (value: RGBColor) => void;
-  rgba: (value: RGBAColor) => void;
+  "*"(value: Color): void;
+  alpha(value: number): void;
+  hex(value: string): void;
+  hexa(value: string): void;
+  hsl(value: HSLColor): void;
+  hsla(value: HSLAColor): void;
+  hwb(value: HWBColor): void;
+  hwba(value: HWBAColor): void;
+  rgb(value: RGBColor): void;
+  rgba(value: RGBAColor): void;
 };
 type ColorWithAlpha = {
   /**
@@ -8431,4 +8508,4 @@ export declare class SizedSet<Value = unknown> extends Set<Value> {
   get(value: Value, update?: boolean): Value | undefined;
 }
 //#endregion
-export { type AsyncLimiter, 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, 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 };