@oscarpalmer/atoms 0.201.0 → 0.202.0

package/dist/internal/subscription.d.mts

@@ -44,7 +44,7 @@ type SubscriptionProperty = {
    */
   value: unknown;
 };
-type Subscriptions = {
+type Subscriptions<Value = unknown> = {
   /**
    * Items of the subscriptions store
    *
@@ -60,7 +60,7 @@ type Subscriptions = {
    * - `to.any` - Map of subscriptions to values _(for unkeyed subscriptions)_
    * - `to.keyed` - Map of keys to maps of subscriptions to values _(for keyed subscriptions)_
    */
-  readonly values: Readonly<SubscriptionsValues>;
+  readonly values: Readonly<SubscriptionsValues<Value>>;
   /**
    * Clear all subscriptions
    */
@@ -90,9 +90,9 @@ type SubscriptionsItems = {
   any: Set<Subscription>;
   keyed?: Map<Key, Set<Subscription>>;
 };
-type SubscriptionsValues = {
-  from: SubscriptionsValuesItem<unknown, Subscription>;
-  to: SubscriptionsValuesItem<Subscription, unknown>;
+type SubscriptionsValues<Value = unknown> = {
+  from: SubscriptionsValuesItem<Value, Subscription>;
+  to: SubscriptionsValuesItem<Subscription, Value>;
 };
 type SubscriptionsValuesItem<MapKey, MapValue> = {
   any: Map<MapKey, MapValue>;
@@ -118,7 +118,7 @@ declare function isSubscriptions(value: unknown): value is Subscriptions;
  * @param parameters Store parameters
  * @returns Subscription store
  */
-declare function subscriptions(parameters?: SubscriptionsParameters): Subscriptions;
+declare function subscriptions<Value = unknown>(parameters?: SubscriptionsParameters): Subscriptions<Value>;
 declare const SUBSCRIPTION_NAME = "subscription";
 //#endregion
 export { SUBSCRIPTION_NAME, Subscription, SubscriptionParameters, SubscriptionProperty, Subscriptions, SubscriptionsParameters, isSubscription, isSubscriptions, subscriptions };

package/dist/models.d.mts

@@ -43,7 +43,23 @@ type GenericCallback = (...args: any[]) => any;
  * A generic key type
  */
 type Key = number | string;
+/**
+ * The `PropertyKey`-safe value of `Item`'s `ItemKey` property
+ */
 type KeyedValue<Item, ItemKey extends keyof Item> = Item[ItemKey] extends PropertyKey ? Item[ItemKey] : never;
+/**
+ * A key of `Item`, or a callback returning `Return`, used to derive a value from an item
+ */
+type KeyOrCallback<Item, Return = unknown> = ((item: Item, index: number, array: Item[]) => Return) | (Item extends PlainObject ? keyof Item : never);
+/**
+ * The `PropertyKey`-safe value resolved from a `KeyOrCallback<Item, Key>` argument, for use as a
+ * `Record` or `Map` key
+ */
+type KeyOrCallbackKey<Item, Arg extends KeyOrCallback<Item, Key>> = Arg extends ((item: Item, index: number, array: Item[]) => Key) ? ReturnType<Arg> : Arg extends keyof Item ? KeyedValue<Item, Arg> : never;
+/**
+ * The value resolved from a `KeyOrCallback` argument against `Item`
+ */
+type KeyOrCallbackValue<Item, Arg extends KeyOrCallback<Item>> = Arg extends ((item: Item, index: number, array: Item[]) => unknown) ? ReturnType<Arg> : Arg extends keyof Item ? Item[Arg] : never;
 /**
  * A nested array
  */
@@ -154,4 +170,4 @@ type UnionToIntersection<Union> = (Union extends unknown ? (distributedUnion: Un
  */
 type Unsubscriber = () => void;
 //#endregion
-export { ArrayOrPlainObject, AsyncCancelableCallback, BuiltIns, CancelableCallback, Constructor, GenericAsyncCallback, GenericCallback, Key, KeyedValue, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NumericalKeys, NumericalValues, OnceAsyncCallback, OnceCallback, PlainObject, Primitive, RequiredKeys, Simplify, ToString, TypedArray, UnionToIntersection, Unsubscriber };
+export { ArrayOrPlainObject, AsyncCancelableCallback, BuiltIns, CancelableCallback, Constructor, GenericAsyncCallback, GenericCallback, Key, KeyOrCallback, KeyOrCallbackKey, KeyOrCallbackValue, KeyedValue, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NumericalKeys, NumericalValues, OnceAsyncCallback, OnceCallback, PlainObject, Primitive, RequiredKeys, Simplify, ToString, TypedArray, UnionToIntersection, Unsubscriber };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oscarpalmer/atoms",
-	"version": "0.201.0",
+	"version": "0.202.0",
 	"description": "Atomic utilities for making your JavaScript better.",
 	"keywords": [
 		"array",