@halospv3/hce.shared-config 3.5.3-develop.1 → 3.6.0-develop.1

package/mjs/utils/reflection/isConstructor.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"isConstructor.mjs","names":[],"sources":["../../../src/utils/reflection/isConstructor.ts"],"sourcesContent":["/**\n * A very jank function to determine if an object can be the target of Reflect.construct.\n * Unfortunately, many functions have a constructor in their prototype. These\n * functions are treated like classes due to JavaScript's poor distinction between\n * classes and functions.\\\n * Typescript can enforce \"new\" keyword usage, but overriding the type\n * allows you to `new isConstructor()` despite this function not intended to be\n * used with the `new` keyword.\n * #### NOTE: Only works when targeting ES6/ES2015 or later.\n * > If your project or a dependent project is compiled to < ES6, this function will always return `false`; classes and constructors were introduced in ES6/ES2015.\n * @param obj Anything.\n * @returns `true` if the obj is a constructor. Else, `false`.\n * @since 3.0.0\n * @see https://stackoverflow.com/a/49510834\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function isConstructor(obj: unknown): obj is abstract new (...args: any[]) => any {\n  // Method 0 - filter\n  if (typeof obj !== 'function')\n    return false;\n\n  // Method 1\n  // statically-defined class\n  if (/^class\\s/.test(obj.toString()))\n    return true;\n\n  /* Method 2\n   * > class class_ {}; function func(){}\n   * undefined\n   * > class_.prototype.constructor.name === class_.name\n   * true\n   * > func.prototype?.constructor?.name === func.name\n   * false\n   * typeof String.prototype ==='object'\n   * > true\n   * typeof Function.prototype === 'object';\n   * > false\n   * typeof Function.prototype\n   * > 'function'\n   */\n  const prototype: unknown = obj.prototype;\n  if ((typeof prototype === 'object' || typeof prototype === 'function')\n    && prototype !== null\n    && 'constructor' in prototype\n    && typeof prototype.constructor === 'function') {\n    const _ctor = prototype.constructor as (new (...arguments_: unknown[]) => unknown);\n    const _name = Reflect.getOwnPropertyDescriptor(\n      _ctor,\n      'name',\n    );\n    // short-circuit if `obj.prototype.constructor` is a function, but not a constructor. Return false.\n    return (\n      _ctor === obj\n      && _name?.writable === false\n      && _name.enumerable === false\n      && _name.configurable === true\n    );\n  }\n\n  // Short-circuit\n  // Method 3 catches exceptions when !isConstructor. When debugging, that's annoying.\n  return false;\n\n  // Method 3\n  // isConstructable (See https://stackoverflow.com/a/49510834)\n  // try {\n  //   // @ts-expect-error ts(2351): Type 'Function' has no construct signatures.\n  //   new new Proxy(obj, { construct: () => ({}) })()\n  //   return true\n  // }\n  // catch {\n  //   return false\n  // }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,cAAc,KAA2D;CAEvF,IAAI,OAAO,QAAQ,YACjB,OAAO;CAIT,IAAI,WAAW,KAAK,IAAI,UAAU,CAAC,EACjC,OAAO;CAgBT,MAAM,YAAqB,IAAI;CAC/B,KAAK,OAAO,cAAc,YAAY,OAAO,cAAc,eACtD,cAAc,QACd,iBAAiB,aACjB,OAAO,UAAU,gBAAgB,YAAY;EAChD,MAAM,QAAQ,UAAU;EACxB,MAAM,QAAQ,QAAQ,yBACpB,OACA,OACD;EAED,OACE,UAAU,OACP,OAAO,aAAa,SACpB,MAAM,eAAe,SACrB,MAAM,iBAAiB;;CAM9B,OAAO"}
+{"version":3,"file":"isConstructor.mjs","names":[],"sources":["../../../src/utils/reflection/isConstructor.ts"],"sourcesContent":["/**\n * A very jank function to determine if an object can be the target of Reflect.construct.\n * Unfortunately, many functions have a constructor in their prototype. These\n * functions are treated like classes due to JavaScript's poor distinction between\n * classes and functions.\\\n * Typescript can enforce \"new\" keyword usage, but overriding the type\n * allows you to `new isConstructor()` despite this function not intended to be\n * used with the `new` keyword.\n * #### NOTE: Only works when targeting ES6/ES2015 or later.\n * > If your project or a dependent project is compiled to < ES6, this function will always return `false`; classes and constructors were introduced in ES6/ES2015.\n * @param object Anything.\n * @returns `true` if the {@link object} is a constructor. Else, `false`.\n * @since 3.0.0\n * @see https://stackoverflow.com/a/49510834\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function isConstructor(object: unknown): object is abstract new (...arguments_: any[]) => any {\n  // Method 0 - filter\n  if (typeof object !== 'function')\n    return false;\n\n  // Method 1\n  // statically-defined class\n  if (/^class\\s/.test(object.toString()))\n    return true;\n\n  /* Method 2\n   * > class class_ {}; function func(){}\n   * undefined\n   * > class_.prototype.constructor.name === class_.name\n   * true\n   * > func.prototype?.constructor?.name === func.name\n   * false\n   * typeof String.prototype ==='object'\n   * > true\n   * typeof Function.prototype === 'object';\n   * > false\n   * typeof Function.prototype\n   * > 'function'\n   */\n  const prototype: unknown = object.prototype;\n  if ((typeof prototype === 'object' || typeof prototype === 'function')\n    && prototype !== null\n    && 'constructor' in prototype\n    && typeof prototype.constructor === 'function') {\n    const _ctor = prototype.constructor as (new (...arguments_: unknown[]) => unknown);\n    const _name = Reflect.getOwnPropertyDescriptor(\n      _ctor,\n      'name',\n    );\n    // short-circuit if `obj.prototype.constructor` is a function, but not a constructor. Return false.\n    return (\n      _ctor === object\n      && _name?.writable === false\n      && _name.enumerable === false\n      && _name.configurable === true\n    );\n  }\n\n  // Short-circuit\n  // Method 3 catches exceptions when !isConstructor. When debugging, that's annoying.\n  return false;\n\n  // Method 3\n  // isConstructable (See https://stackoverflow.com/a/49510834)\n  // try {\n  //   // @ts-expect-error ts(2351): Type 'Function' has no construct signatures.\n  //   new new Proxy(obj, { construct: () => ({}) })()\n  //   return true\n  // }\n  // catch {\n  //   return false\n  // }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,cAAc,QAAuE;CAEnG,IAAI,OAAO,WAAW,YACpB,OAAO;CAIT,IAAI,WAAW,KAAK,OAAO,SAAS,CAAC,GACnC,OAAO;CAgBT,MAAM,YAAqB,OAAO;CAClC,KAAK,OAAO,cAAc,YAAY,OAAO,cAAc,eACtD,cAAc,QACd,iBAAiB,aACjB,OAAO,UAAU,gBAAgB,YAAY;EAChD,MAAM,QAAQ,UAAU;EACxB,MAAM,QAAQ,QAAQ,yBACpB,OACA,MACF;EAEA,OACE,UAAU,UACP,OAAO,aAAa,SACpB,MAAM,eAAe,SACrB,MAAM,iBAAiB;CAE9B;CAIA,OAAO;AAYT"}

package/mjs/utils/reflection/isGetterDescriptor.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"isGetterDescriptor.d.mts","names":[],"sources":["../../../src/utils/reflection/isGetterDescriptor.ts"],"mappings":";;;;;AAQA;;;;iBAAgB,kBAAA,GAAA,CAAsB,kBAAA,EAAoB,uBAAA,CAAwB,CAAA,IAAK,kBAAA,IAAsB,gBAAA,CAAiB,CAAA"}
+{"version":3,"file":"isGetterDescriptor.d.mts","names":[],"sources":["../../../src/utils/reflection/isGetterDescriptor.ts"],"mappings":";;;;;AAQA;;;;iBAAgB,kBAAA,IAAsB,kBAAA,EAAoB,uBAAA,CAAwB,CAAA,IAAK,kBAAA,IAAsB,gBAAA,CAAiB,CAAA"}

package/mjs/utils/reflection/isGetterDescriptor.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"isGetterDescriptor.mjs","names":[],"sources":["../../../src/utils/reflection/isGetterDescriptor.ts"],"sourcesContent":["import type { GetterDescriptor } from './GetterDescriptor.d.ts';\n\n/**\n * A function for inferring a {@link TypedPropertyDescriptor} is a {@link GetterDescriptor}\n * @param propertyDescriptor The {@link TypedPropertyDescriptor} to inspect.\n * @returns `true` if {@link propertyDescriptor} describes a getter. Else, `false.\n * @since 3.0.0\n */\nexport function isGetterDescriptor<T>(propertyDescriptor: TypedPropertyDescriptor<T>): propertyDescriptor is GetterDescriptor<T> {\n  return typeof propertyDescriptor.get === 'function';\n};\n"],"mappings":";;;;;;;AAQA,SAAgB,mBAAsB,oBAA2F;CAC/H,OAAO,OAAO,mBAAmB,QAAQ"}
+{"version":3,"file":"isGetterDescriptor.mjs","names":[],"sources":["../../../src/utils/reflection/isGetterDescriptor.ts"],"sourcesContent":["import type { GetterDescriptor } from './GetterDescriptor.d.ts';\n\n/**\n * A function for inferring a {@link TypedPropertyDescriptor} is a {@link GetterDescriptor}\n * @param propertyDescriptor The {@link TypedPropertyDescriptor} to inspect.\n * @returns `true` if {@link propertyDescriptor} describes a getter. Else, `false.\n * @since 3.0.0\n */\nexport function isGetterDescriptor<T>(propertyDescriptor: TypedPropertyDescriptor<T>): propertyDescriptor is GetterDescriptor<T> {\n  return typeof propertyDescriptor.get === 'function';\n};\n"],"mappings":";;;;;;;AAQA,SAAgB,mBAAsB,oBAA2F;CAC/H,OAAO,OAAO,mBAAmB,QAAQ;AAC3C"}

package/mjs/utils/reflection/listOwnGetters.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"listOwnGetters.d.mts","names":[],"sources":["../../../src/utils/reflection/listOwnGetters.ts"],"mappings":";;;;;;AAUO;;;;KAUF,UAAA,eACW,SAAA,CAAU,qBAAA,CAAsB,KAAA,IAAS,SAAA,CAAU,cAAA,GAAiB,cAAA,8BACxD,gBAAA,KAEvB,iBAAA,yBACC,OAAA,EACC,KAAA,sBAA2B,cAAA,UAAwB,kBAAA,CAAmB,KAAA,qCAC7D,YAAA,CAAa,KAAA,IACnB,OAAA,OACM,YAAA,CAAa,KAAA,UACZ,KAAA,sBAA2B,cAAA,UAAwB,kBAAA,CAAmB,KAAA,oCAIhF,iBAAA,uBACG,OAAA,CACA,KAAA,mCAAwC,KAAA,GAAQ,OAAA,OAAc,KAAA,QAAa,KAAA;;;;;;;;;;;;;;;iBAmBrE,cAAA,eACA,SAAA,CAAU,qBAAA,CAAsB,KAAA,IAAS,SAAA,CAAU,cAAA,GAAiB,cAAA,8BACxD,gBAAA,CAAA,CAE1B,eAAA,EAAiB,KAAA,EACjB,gBAAA,EAAkB,OAAA,CAAQ,iBAAA,EAAmB,gBAAA,IAC5C,UAAA,CAAW,KAAA,EAAO,iBAAA"}
+{"version":3,"file":"listOwnGetters.d.mts","names":[],"sources":["../../../src/utils/reflection/listOwnGetters.ts"],"mappings":";;;;;;AAUO;;;;KAUF,UAAA,eACW,SAAA,CAAU,qBAAA,CAAsB,KAAA,IAAS,SAAA,CAAc,cAAA,GAAiB,cAAA,8BAC5D,gBAAA,KAEvB,iBAAA,yBACC,OAAA,EACC,KAAA,sBAA2B,cAAA,UAA4B,kBAAA,CAAmB,KAAA,qCACjE,YAAA,CAAa,KAAA,IACnB,OAAA,OACM,YAAA,CAAa,KAAA,UACZ,KAAA,sBAA2B,cAAA,UAA4B,kBAAA,CAAmB,KAAA,oCAIpF,iBAAA,uBACG,OAAA,CACA,KAAA,mCAAwC,KAAA,GAAQ,OAAA,OAAc,KAAA,QAAa,KAAA;;;;;;;;;;;;;;;iBAmBrE,cAAA,eACA,SAAA,CAAU,qBAAA,CAAsB,KAAA,IAAS,SAAA,CAAc,cAAA,GAAiB,cAAA,8BAC5D,gBAAA,EAE1B,eAAA,EAAiB,KAAA,EACjB,gBAAA,EAAkB,OAAA,CAAQ,iBAAA,EAAmB,gBAAA,IAC5C,UAAA,CAAW,KAAA,EAAO,iBAAA"}

package/mjs/utils/reflection/listOwnGetters.mjs

@@ -19,10 +19,12 @@ function listOwnGetters(classDefinition, instanceOrStatic) {
 	if (instanceOrStatic === "Instance") {
 		const getterDescriptorMap = filterForGetters(getOwnPropertyDescriptors(classDefinition, instanceOrStatic));
 		return Reflect.ownKeys(getterDescriptorMap);
-	} else if (instanceOrStatic === "Static") {
+	}
+	if (instanceOrStatic === "Static") {
 		const getterDescriptorMap = filterForGetters(getOwnPropertyDescriptors(classDefinition, instanceOrStatic));
 		return Reflect.ownKeys(getterDescriptorMap);
-	} else throw new TypeError("Argument `instanceOrStatic` must be \"Instance\" or \"Static\".");
+	}
+	throw new TypeError("Argument `instanceOrStatic` must be \"Instance\" or \"Static\".");
 }
 //#endregion
 export { listOwnGetters };

package/mjs/utils/reflection/listOwnGetters.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"listOwnGetters.mjs","names":[],"sources":["../../../src/utils/reflection/listOwnGetters.ts"],"sourcesContent":["import type { InstanceOrStatic } from '../miscTypes.ts';\nimport { filterForGetters } from './filterForGetters.ts';\nimport { getOwnPropertyDescriptors } from './getOwnPropertyDescriptors.ts';\nimport type {\n  BaseClassProto,\n  ClassLike,\n  ConstructorConstraint,\n  InstanceTypeOrSelf,\n  SuperClassLike,\n  WithProto,\n} from './inheritance.ts';\nimport type { InstancePropertyDescriptorMap } from './InstancePropertyDescriptorMap.d.ts';\nimport type { OwnPropertyDescriptorMap } from './OwnPropertyDescriptorMap.d.ts';\n\n/**\n * Description placeholder\n * @template {ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>} Class\n * @template {InstanceOrStatic} _InstanceOrStatic\n * @since 3.0.0\n */\ntype OwnGetters<\n  Class extends ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>,\n  _InstanceOrStatic extends InstanceOrStatic,\n>\n  = [_InstanceOrStatic] extends ['Instance']\n    ? Exclude<\n      (Class['__proto__'] extends BaseClassProto ? null : InstanceTypeOrSelf<Class['__proto__']>) extends null\n        ? keyof InstanceType<Class>\n        : Exclude<\n          keyof InstanceType<Class>,\n          keyof (Class['__proto__'] extends BaseClassProto ? null : InstanceTypeOrSelf<Class['__proto__']>)\n        >,\n      '__proto__'\n    >[]\n    : [_InstanceOrStatic] extends ['Static']\n        ? Exclude<\n          Class['__proto__'] extends null ? keyof Class : Exclude<keyof Class, keyof Class['__proto__']>,\n          '__proto__'\n        >[]\n        : never;\n\n/**\n * # !WARNING!\n * > If you don't specify the Class's SuperClass (or `BaseClassProto`) via WithProto, the return type will wrongly include inherited property names! This is a design limitation of TypeScript.\n *\n * Returns the names of the instantiated (or static), noninherited getters derived from the\n * given prototype or prototype of the given object.\n * @template {ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>} Class\n * @template {InstanceOrStatic} _InstanceOrStatic 'Instance' or 'Static'. Determines the return type.\n * @param classDefinition Any class cast to ClassLike\n * @param instanceOrStatic 'Instance' or 'Static'. Determines the return type.\n * @since 3.0.0\n * @returns\n * An array of names of getters that were not inherited from a parent class. If {@link classDefinition} is a class instance, the names of instanced getters are returned. Otherwise, the names of static getters are returned;\n */\nexport function listOwnGetters<\n  Class extends ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>,\n  _InstanceOrStatic extends InstanceOrStatic,\n>(\n  classDefinition: Class,\n  instanceOrStatic: Extract<_InstanceOrStatic, InstanceOrStatic>,\n): OwnGetters<Class, _InstanceOrStatic> {\n  if (instanceOrStatic === 'Instance') {\n    const descriptorMap: InstancePropertyDescriptorMap<Class> = getOwnPropertyDescriptors(classDefinition, instanceOrStatic as 'Instance');\n    const getterDescriptorMap = filterForGetters(descriptorMap);\n    const keyArray = Reflect.ownKeys(getterDescriptorMap) as (keyof typeof getterDescriptorMap)[];\n    return keyArray as [typeof instanceOrStatic & 'Instance'] extends ['Instance'] ? typeof keyArray : never;\n  }\n  else if (instanceOrStatic === 'Static') {\n    const descriptorMap: OwnPropertyDescriptorMap<Class> = getOwnPropertyDescriptors(classDefinition, instanceOrStatic as 'Static');\n    const getterDescriptorMap = filterForGetters(descriptorMap);\n    const keyArray = Reflect.ownKeys(getterDescriptorMap) as (keyof typeof getterDescriptorMap)[];\n    return keyArray as [_InstanceOrStatic] extends ['Instance']\n      ? never\n      : [_InstanceOrStatic] extends ['Static']\n          ? typeof keyArray\n          : never;\n  }\n  else throw new TypeError('Argument `instanceOrStatic` must be \"Instance\" or \"Static\".');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAuDA,SAAgB,eAId,iBACA,kBACsC;CACtC,IAAI,qBAAqB,YAAY;EAEnC,MAAM,sBAAsB,iBADgC,0BAA0B,iBAAiB,iBAC7C,CAAC;EAE3D,OADiB,QAAQ,QAAQ,oBAClB;QAEZ,IAAI,qBAAqB,UAAU;EAEtC,MAAM,sBAAsB,iBAD2B,0BAA0B,iBAAiB,iBACxC,CAAC;EAE3D,OADiB,QAAQ,QAAQ,oBAClB;QAMZ,MAAM,IAAI,UAAU,kEAA8D"}
+{"version":3,"file":"listOwnGetters.mjs","names":[],"sources":["../../../src/utils/reflection/listOwnGetters.ts"],"sourcesContent":["import type { InstanceOrStatic } from '../miscTypes.ts';\nimport { filterForGetters } from './filterForGetters.ts';\nimport { getOwnPropertyDescriptors } from './getOwnPropertyDescriptors.ts';\nimport type {\n  BaseClassProto as BaseClassPrototype,\n  ClassLike,\n  ConstructorConstraint,\n  InstanceTypeOrSelf,\n  SuperClassLike,\n  WithProto as WithPrototype,\n} from './inheritance.ts';\nimport type { InstancePropertyDescriptorMap } from './InstancePropertyDescriptorMap.d.ts';\nimport type { OwnPropertyDescriptorMap } from './OwnPropertyDescriptorMap.d.ts';\n\n/**\n * Description placeholder\n * @template {ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>} Class\n * @template {InstanceOrStatic} _InstanceOrStatic\n * @since 3.0.0\n */\ntype OwnGetters<\n  Class extends ClassLike<ConstructorConstraint<Class> & WithPrototype<SuperClassLike | BaseClassPrototype>>,\n  _InstanceOrStatic extends InstanceOrStatic,\n>\n  = [_InstanceOrStatic] extends ['Instance']\n    ? Exclude<\n      (Class['__proto__'] extends BaseClassPrototype ? null : InstanceTypeOrSelf<Class['__proto__']>) extends null\n        ? keyof InstanceType<Class>\n        : Exclude<\n          keyof InstanceType<Class>,\n          keyof (Class['__proto__'] extends BaseClassPrototype ? null : InstanceTypeOrSelf<Class['__proto__']>)\n        >,\n      '__proto__'\n    >[]\n    : [_InstanceOrStatic] extends ['Static']\n        ? Exclude<\n          Class['__proto__'] extends null ? keyof Class : Exclude<keyof Class, keyof Class['__proto__']>,\n          '__proto__'\n        >[]\n        : never;\n\n/**\n * # !WARNING!\n * > If you don't specify the Class's SuperClass (or `BaseClassProto`) via WithProto, the return type will wrongly include inherited property names! This is a design limitation of TypeScript.\n *\n * Returns the names of the instantiated (or static), noninherited getters derived from the\n * given prototype or prototype of the given object.\n * @template {ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>} Class\n * @template {InstanceOrStatic} _InstanceOrStatic 'Instance' or 'Static'. Determines the return type.\n * @param classDefinition Any class cast to ClassLike\n * @param instanceOrStatic 'Instance' or 'Static'. Determines the return type.\n * @since 3.0.0\n * @returns\n * An array of names of getters that were not inherited from a parent class. If {@link classDefinition} is a class instance, the names of instanced getters are returned. Otherwise, the names of static getters are returned;\n */\nexport function listOwnGetters<\n  Class extends ClassLike<ConstructorConstraint<Class> & WithPrototype<SuperClassLike | BaseClassPrototype>>,\n  _InstanceOrStatic extends InstanceOrStatic,\n>(\n  classDefinition: Class,\n  instanceOrStatic: Extract<_InstanceOrStatic, InstanceOrStatic>,\n): OwnGetters<Class, _InstanceOrStatic> {\n  if (instanceOrStatic === 'Instance') {\n    const descriptorMap: InstancePropertyDescriptorMap<Class> = getOwnPropertyDescriptors(classDefinition, instanceOrStatic as 'Instance');\n    const getterDescriptorMap = filterForGetters(descriptorMap);\n    const keyArray = Reflect.ownKeys(getterDescriptorMap) as (keyof typeof getterDescriptorMap)[];\n    return keyArray as [typeof instanceOrStatic & 'Instance'] extends ['Instance'] ? typeof keyArray : never;\n  }\n  if (instanceOrStatic === 'Static') {\n    const descriptorMap: OwnPropertyDescriptorMap<Class> = getOwnPropertyDescriptors(classDefinition, instanceOrStatic as 'Static');\n    const getterDescriptorMap = filterForGetters(descriptorMap);\n    const keyArray = Reflect.ownKeys(getterDescriptorMap) as (keyof typeof getterDescriptorMap)[];\n    return keyArray as [_InstanceOrStatic] extends ['Instance']\n      ? never\n      : [_InstanceOrStatic] extends ['Static']\n          ? typeof keyArray\n          : never;\n  }\n  throw new TypeError('Argument `instanceOrStatic` must be \"Instance\" or \"Static\".');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAuDA,SAAgB,eAId,iBACA,kBACsC;CACtC,IAAI,qBAAqB,YAAY;EAEnC,MAAM,sBAAsB,iBADgC,0BAA0B,iBAAiB,gBAC9C,CAAC;EAE1D,OADiB,QAAQ,QAAQ,mBACnB;CAChB;CACA,IAAI,qBAAqB,UAAU;EAEjC,MAAM,sBAAsB,iBAD2B,0BAA0B,iBAAiB,gBACzC,CAAC;EAE1D,OADiB,QAAQ,QAAQ,mBACnB;CAKhB;CACA,MAAM,IAAI,UAAU,iEAA6D;AACnF"}

package/mjs/utils/reflection.d.mts

@@ -15,4 +15,4 @@ import { getPrototypeOf } from "./reflection/getPrototypeOf.mjs";
 import { isConstructor } from "./reflection/isConstructor.mjs";
 import { isGetterDescriptor } from "./reflection/isGetterDescriptor.mjs";
 import { listOwnGetters } from "./reflection/listOwnGetters.mjs";
-export { BaseClass, BaseClassProto, ClassLike, ClassLike_Unknown, ConstructorConstraint, ConstructorLike, Constructor_Unknown, FunctionLike, GetterDescriptor, IClass, InstancePropertyDescriptorMap, InstanceTypeOrSelf, InstanceTypeOrSelfPropertyDescriptorMap, OwnGetterDescriptorMap, OwnKeyOf, OwnPropertyDescriptorMap, PropertyDescriptorMap, ProtoChainOfClass, ProtoChainOfClassInstance, ProtoChainOfObject, ProtoOrSuperClass, RecursedPropertyDescriptorMap, RecursedPropertyDescriptorMapArray, SuperClassLike, WithProto, baseClassProto, filterForGetters, getOwnPropertyDescriptors, getOwnPropertyDescriptorsRecursively, getPrototypeOf, getPrototypesChainOf, isConstructor, isGetterDescriptor, listOwnGetters };
+export { BaseClass, BaseClassProto, ClassLike, ClassLike_Unknown, ConstructorConstraint, ConstructorLike, Constructor_Unknown, type FunctionLike, type GetterDescriptor, IClass, type InstancePropertyDescriptorMap, InstanceTypeOrSelf, type InstanceTypeOrSelfPropertyDescriptorMap, type OwnGetterDescriptorMap, type OwnKeyOf, type OwnPropertyDescriptorMap, type PropertyDescriptorMap, ProtoChainOfClass, ProtoChainOfClassInstance, ProtoChainOfObject, ProtoOrSuperClass, RecursedPropertyDescriptorMap, RecursedPropertyDescriptorMapArray, SuperClassLike, WithProto, baseClassProto, filterForGetters, getOwnPropertyDescriptors, getOwnPropertyDescriptorsRecursively, getPrototypeOf, getPrototypesChainOf, isConstructor, isGetterDescriptor, listOwnGetters };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halospv3/hce.shared-config",
-  "version": "3.5.3-develop.1",
+  "version": "3.6.0-develop.1",
   "description": "Automate commit message quality, changelogs, and CI/CD releases. Its `main` entry point is a Semantic Release config. Functions and classes are exposed for customization. An ESLint config, a Commitlint config, and addl. resources for .NET projects are also provided.",
   "keywords": [
     "semantic-release",
@@ -14,6 +14,7 @@
   "bugs": "https://github.com/halospv3/hce.shared/issues",
   "license": "MIT",
   "author": "Noah Sherwin",
+  "preferUnplugged": true,
   "files": [
     "!.github/",
     "!.husky/",
@@ -54,30 +55,30 @@
     "presemantic-release": "npm pack",
     "semantic-release": "semantic-release",
     "pretest": "npm run build && npm run test:cacheSampleProjects",
-    "test": "tsx --test --experimental-test-coverage --enable-source-maps --test-reporter=spec --test-reporter-destination=stdout --test-reporter=lcov --test-reporter-destination=lcov.txt --test-reporter=junit --test-reporter-destination=junit.xml",
-    "test:cacheSampleProjects": "echo \"START: Cache Sample Projects\" && tsx ./tests/dotnet/MSBuildProject.projects.ts && echo \"DONE: Cache Sample Projects\"",
+    "test": "node --trace-deprecation --trace-warnings --test --experimental-test-coverage --enable-source-maps --test-reporter=spec --test-reporter-destination=stdout --test-reporter=lcov --test-reporter-destination=lcov.txt --test-reporter=junit --test-reporter-destination=junit.xml",
+    "test:cacheSampleProjects": "echo \"START: Cache Sample Projects\" && node ./tests/dotnet/MSBuildProject.projects.ts && echo \"DONE: Cache Sample Projects\"",
     "test:watch": "npm run test -- --watch",
     "type": "tsc --build",
     "validate": "tsdown --no-write",
     "watch": "tsdown --watch"
   },
   "dependencies": {
-    "@commitlint/cli": "^21.0.0",
+    "@commitlint/cli": "^21.1.0",
     "@commitlint/config-conventional": "^21.0.0",
-    "@dotenvx/dotenvx": "^1.63.0",
+    "@dotenvx/dotenvx": "^1.75.1",
     "@eslint/js": "^10.0.1",
-    "@eslint/json": "^1.2.0",
+    "@eslint/json": "^2.0.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^12.0.6",
+    "@semantic-release/github": "^12.0.8",
     "@semantic-release/npm": "^13.1.5",
-    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@semantic-release/release-notes-generator": "^14.1.1",
     "@stylistic/eslint-plugin": "^5.9.0",
-    "@types/node": "~24.12.0",
-    "arktype": "^2.1.20",
-    "chardet": "^2.1.0",
+    "@types/node": "~26.0.1",
+    "arktype": "^2.2.1",
+    "chardet": "^2.2.0",
     "conventional-changelog-conventionalcommits": "^9.3.1",
     "debug": "^4.4.1",
     "error.iserror": "^1.0.2",
@@ -86,10 +87,10 @@
     "husky": "^9.1.7",
     "patch-package": "^8.0.1",
     "sanitize-filename": "^1.6.4",
-    "semantic-release": "^25.0.0",
+    "semantic-release": "^25.0.5",
     "semantic-release-export-data": "^1.1.0",
-    "ts-essentials": "^10.1.1",
-    "typescript-eslint": "^8.59.0"
+    "ts-essentials": "^10.2.1",
+    "typescript-eslint": "^8.62.0"
   },
   "peerDependencies": {
     "@bintoss/semantic-release-npm-multiple": "^3.0.0 || >= 3.0.0",
@@ -107,25 +108,25 @@
     }
   },
   "devDependencies": {
-    "@arethetypeswrong/core": "^0.18.2",
+    "@arethetypeswrong/core": "^0.18.4",
     "@bintoss/semantic-release-npm-multiple": "^3.17.1",
     "@commitlint/types": "^21.0.0",
-    "@eslint/config-inspector": "^2.0.0",
-    "@eslint/markdown": "^8.0.1",
-    "@sebbo2002/semantic-release-jsr": "^3.2.0",
+    "@eslint/config-inspector": "^3.0.4",
+    "@eslint/markdown": "^8.0.2",
+    "@sebbo2002/semantic-release-jsr": "^4.0.1",
     "@semantic-release/gitlab": "^13.3.2",
     "@types/debug": "^4.1.13",
     "@types/tmp": "^0.2.6",
     "conventional-changelog-preset-loader": "^5.0.0",
     "eslint": "^10.2.1",
-    "eslint-plugin-jsdoc": "^62.9.0",
-    "eslint-plugin-unicorn": "^64.0.0",
+    "eslint-plugin-jsdoc": "^63.0.8",
+    "eslint-plugin-unicorn": "^69.0.0",
     "pinst": "^3.0.0",
-    "publint": "^0.3.18",
-    "tmp": "^0.2.3",
-    "tsdown": "^0.22.0",
+    "publint": "^0.3.21",
+    "tmp": "^0.2.7",
+    "tsdown": "^0.22.3",
     "tslib": "^2.8.1",
-    "tsx": "^4.20.3",
+    "tsx": "^4.22.4",
     "typescript": "^6.0.3",
     "unplugin-unused": "^0.5.7"
   },
@@ -186,5 +187,5 @@
     "./*": "./*"
   },
   "types": "./mjs/index.d.mts",
-  "packageManager": "npm@11.13.0+sha512.7119a16a0843580d65160977520e3f5710c974f04afd4fad36d9eb97d917ba716a856c35c78c4be6dc64367eeaccfb957ef5ce997ca31e9330b2e936ba2b1b92"
+  "packageManager": "npm@11.17.0+sha512.3eeaf18997b11070d313849268b23766b9db0068997dec9471073170fe43fa17f2b4d0337bf0f52330ee2274e7f5754b21b01052742e48f5c9c74d8b1e32ef43"
 }

package/src/dotnet/GithubNugetRegistryInfo.ts

@@ -1,14 +1,15 @@
 import type { Type } from 'arktype';
-import { getEnvVarValue } from '../utils/env.ts';
+import { getEnvVarValue as getEnvironmentVariableValue } from '../utils/env.ts';
 import type { MSBuildProject, MSBuildEvaluationOutput } from './MSBuildProject.ts';
 import type { NugetProjectProperties } from './NugetProjectProperties.ts';
 import {
   NugetRegistryInfo,
-  NRIOptsBase,
+  NRIOptsBase as NRIOptionsBase,
 } from './NugetRegistryInfo.ts';
 import type { Default } from 'arktype/internal/attributes.ts';
 
 const NUGET_PKG_GITHUB_COM = 'https://nuget.pkg.github.com';
+// eslint-disable-next-line unicorn/name-replacements
 export const DefaultGithubTokenEnvVars: readonly ['GH_TOKEN', 'GITHUB_TOKEN'] = Object.freeze([
   'GH_TOKEN',
   'GITHUB_TOKEN',
@@ -17,15 +18,6 @@ export const DefaultGithubTokenEnvVars: readonly ['GH_TOKEN', 'GITHUB_TOKEN'] =
 export class GithubNugetRegistryInfo extends NugetRegistryInfo {
   static readonly NUGET_PKG_GITHUB_COM = 'https://nuget.pkg.github.com';
 
-  // GithubNugetRegistryInfo.CtorArgs(...) behaves differently than NugetRegistryInfo.CtorArgs(...)
-  /**
-   * Creates an instance of GithubNugetRegistryInfo.
-   * @param opts The input type of {@link GHNRIOpts.from}
-   */
-  constructor(opts: typeof GHNRIOpts.inferIn) {
-    super(GHNRIOpts.from(opts));
-  }
-
   /**
    * Returns `https://nuget.pkg.github.com/${GITHUB_REPOSITORY_OWNER}/index.json`
    * or (if GITHUB_REPOSITORY_OWNER is not defined in {@link process.env} nor
@@ -34,11 +26,21 @@ export class GithubNugetRegistryInfo extends NugetRegistryInfo {
    * Otherwise, returns `undefined`
    */
   static getNugetGitHubUrl(): string | undefined {
-    const owner = getEnvVarValue('GITHUB_REPOSITORY_OWNER');
+    const owner = getEnvironmentVariableValue('GITHUB_REPOSITORY_OWNER');
     return owner === undefined
       ? undefined
       : `${NUGET_PKG_GITHUB_COM}/${owner}/index.json`;
   }
+
+  // GithubNugetRegistryInfo.CtorArgs(...) behaves differently than NugetRegistryInfo.CtorArgs(...)
+  /**
+   * Creates an instance of GithubNugetRegistryInfo.
+   * @param opts The input type of {@link GHNRIOpts.from}
+   */
+  // eslint-disable-next-line unicorn/name-replacements
+  constructor(opts: typeof GHNRIOpts.inferIn) {
+    super(GHNRIOpts.from(opts));
+  }
 }
 const GHNRI = GithubNugetRegistryInfo;
 
@@ -47,6 +49,7 @@ const GHNRI = GithubNugetRegistryInfo;
  * {@link GHNRI.getNugetGitHubUrl} and will default to an empty string if the
  * environment variable `GITHUB_REPOSITORY_OWNER` is undefined!
  */
+// eslint-disable-next-line unicorn/name-replacements
 export const GHNRIOpts: Type<{
   project: MSBuildProject | {
     readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;
@@ -56,11 +59,11 @@ export const GHNRIOpts: Type<{
   };
   source: Default<string, string>;
   tokenEnvVars: Default<readonly string[], readonly ['GH_TOKEN', 'GITHUB_TOKEN']>;
-}> = NRIOptsBase.merge({
+}> = NRIOptionsBase.merge({
   /** @see {@link GHNRI.getNugetGitHubUrl } */
-  source: NRIOptsBase.get('source')
+  source: NRIOptionsBase.get('source')
     .default(() => GHNRI.getNugetGitHubUrl() ?? ''),
-  tokenEnvVars: NRIOptsBase.get('tokenEnvVars')
+  tokenEnvVars: NRIOptionsBase.get('tokenEnvVars')
     .default(
       /* must be a function. A fixed-length array is NOT a primitive type! */
       (): typeof DefaultGithubTokenEnvVars => DefaultGithubTokenEnvVars,

package/src/dotnet/GitlabNugetRegistryInfo.ts

@@ -1,9 +1,9 @@
-import { getEnvVarValue } from '../utils/env.ts';
+import { getEnvVarValue as getEnvironmentVariableValue } from '../utils/env.ts';
 import { isError } from '../utils/isError.ts';
 import {
   NugetRegistryInfo,
-  NRIOpts,
-  NRIOptsBase,
+  NRIOpts as NRIOptions,
+  NRIOptsBase as NRIOptionsBase,
 } from './NugetRegistryInfo.ts';
 import type { Out, Type } from 'arktype';
 import type { Default } from 'arktype/internal/attributes.ts';
@@ -12,13 +12,19 @@ import type { NugetProjectProperties } from './NugetProjectProperties.ts';
 
 // https://docs.gitlab.com/ee/user/packages/nuget_repository/
 export class GitlabNugetRegistryInfo extends NugetRegistryInfo {
+  static readonly DefaultGitlabTokenEnvVars: readonly ['GL_TOKEN', 'GITLAB_TOKEN', 'CI_JOB_TOKEN'] = Object.freeze([
+    'GL_TOKEN',
+    'GITLAB_TOKEN',
+    'CI_JOB_TOKEN',
+  ] as const);
+
   /**
    * The GitLab API v4 root URL.
    * @returns The value of the environment variable `CI_API_V4_URL`.
    * If that's `undefined`, 'https://gitlab.com/api/v4' is returned, instead.
    */
   static get CI_API_V4_URL(): string {
-    return getEnvVarValue('CI_API_V4_URL') ?? 'https://gitlab.com/api/v4';
+    return getEnvironmentVariableValue('CI_API_V4_URL') ?? 'https://gitlab.com/api/v4';
   }
 
   /**
@@ -28,7 +34,7 @@ export class GitlabNugetRegistryInfo extends NugetRegistryInfo {
    * @todo add URI encoded project pathname as alternative e.g. 'halospv3%2FHCE.Shared' in 'https://gitlab.com/api/v4/projects/halospv3%2FHCE.Shared'
    */
   static get projectId(): string | undefined {
-    return getEnvVarValue('CI_PROJECT_ID');
+    return getEnvironmentVariableValue('CI_PROJECT_ID');
   }
 
   /**
@@ -37,24 +43,7 @@ export class GitlabNugetRegistryInfo extends NugetRegistryInfo {
    * @returns The value of the environment variable 'CI_PROJECT_NAMESPACE_ID' or `undefined`.
    */
   static get ownerId(): string | undefined {
-    return getEnvVarValue('CI_PROJECT_NAMESPACE_ID');
-  }
-
-  static readonly DefaultGitlabTokenEnvVars: readonly ['GL_TOKEN', 'GITLAB_TOKEN', 'CI_JOB_TOKEN'] = Object.freeze([
-    'GL_TOKEN',
-    'GITLAB_TOKEN',
-    'CI_JOB_TOKEN',
-  ] as const);
-
-  /**
-   * Creates an instance of GitlabNugetRegistryInfo.
-   * @param opts The input type of {@link GLNRIOpts.from}
-   */
-  constructor(opts: typeof GLNRIOpts.inferIn) {
-    const optsOut = GLNRIOpts.from(opts);
-    if (isError(optsOut.source))
-      throw optsOut.source;
-    super(optsOut as typeof optsOut & { source: string });
+    return getEnvironmentVariableValue('CI_PROJECT_NAMESPACE_ID');
   }
 
   /**
@@ -81,12 +70,25 @@ export class GitlabNugetRegistryInfo extends NugetRegistryInfo {
       ? `${this.CI_API_V4_URL}/groups/${this.ownerId}/-/packages/nuget/index.json`
       : new Error('env.CI_PROJECT_NAMESPACE_ID must be defined to use its GitLab API endpoint!');
   }
+
+  /**
+   * Creates an instance of GitlabNugetRegistryInfo.
+   * @param opts The input type of {@link GLNRIOpts.from}
+   */
+  // eslint-disable-next-line unicorn/name-replacements
+  constructor(opts: typeof GLNRIOpts.inferIn) {
+    const optionsOut = GLNRIOpts.from(opts);
+    if (isError(optionsOut.source))
+      throw optionsOut.source;
+    super(optionsOut as typeof optionsOut & { source: string });
+  }
 }
 const GLNRI = GitlabNugetRegistryInfo;
 
 /**
  * The Arktype definition for {@link GitlabNugetRegistryInfo}'s constructor parameter. Construct an object of this type by calling {@link GLNRIOpts.from}
  */
+// eslint-disable-next-line unicorn/name-replacements
 export const GLNRIOpts: Type<{
   project: MSBuildProject | {
     readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;
@@ -96,8 +98,8 @@ export const GLNRIOpts: Type<{
   };
   tokenEnvVars: Default<readonly string[], readonly ['GL_TOKEN', 'GITLAB_TOKEN', 'CI_JOB_TOKEN']>;
   source: (In: Default<string | Error, string | Error>) => Out<string | Error>;
-}> = NRIOpts.merge({
-  tokenEnvVars: NRIOptsBase.get('tokenEnvVars').default(
+}> = NRIOptions.merge({
+  tokenEnvVars: NRIOptionsBase.get('tokenEnvVars').default(
     () => GLNRI.DefaultGitlabTokenEnvVars,
   ),
   /**
@@ -107,7 +109,7 @@ export const GLNRIOpts: Type<{
    * @see {@link GLNRI.projectUrl}, {@link GLNRI.groupUrl}
    */
   // todo: change '"group" | "project"' to '"GITLAB:PROJECT" | "GITLAB:GROUP"'
-  source: NRIOptsBase.get('source')
+  source: NRIOptionsBase.get('source')
     .or('"group" | "project" | Error')
     .pipe((source: string | Error): string | Error => {
       switch (source) {

package/src/dotnet/IsNextVersionAlreadyPublished.cli.ts

@@ -13,17 +13,17 @@ import esMain from 'es-main';
  *   - already exists at `source`
  */
 async function main(): Promise<0> {
-  const args = process.argv.slice(2);
+  const arguments_ = process.argv.slice(2);
   // Parse command-line arguments - https://stackoverflow.com/a/76298476/14894786
   const options: {
     packageId: string | undefined;
     source: string | undefined;
   } & Record<string, string | undefined> = { packageId: undefined, source: undefined };
-  for (let i = 0; i < args.length; i += 2) {
-    const argName = args[i];
-    const argValue = args[i + 1];
-    if (argValue !== undefined && argName?.startsWith('--') === true) {
-      options[argName.slice(2)] = argValue;
+  for (let index = 0; index < arguments_.length; index += 2) {
+    const argumentName = arguments_[index];
+    const argumentValue = arguments_[index + 1];
+    if (argumentValue !== undefined && argumentName?.startsWith('--') === true) {
+      options[argumentName.slice(2)] = argumentValue;
     }
   }