npm - @sapphire/bitfield - Versions diffs - 1.2.5-next.ec05fe56 → 1.2.5-next.f3515ea3 - Mend

@sapphire/bitfield 1.2.5-next.ec05fe56 → 1.2.5-next.f3515ea3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/dist/cjs/index.cjs.map +1 -1
package/dist/esm/index.mjs.map +1 -1
package/dist/iife/index.global.js.map +1 -1
package/package.json +5 -5

package/dist/cjs/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/lib/BitField.ts","../../src/lib/utilities.ts"],"names":[],"mappings":";;;;;;;;AAAA,IAAM,iBAAA,GAAoB,OAAO,kCAAkC,CAAA;AAAnE,IAAA,EAAA;AAOmB,EAAA,GAAA,iBAAA;AALZ,IAAM,SAAA,GAAN,MAAM,SAAwE,CAAA;AAAA,EAO7E,YAAY,KAAwB,EAAA;AAN3C,IAAgB,aAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAChB,IAAgB,aAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAChB,IAAgB,aAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAChB,IAAgB,aAAA,CAAA,IAAA,EAAA,OAAA,CAAA;AAChB,IAAkB,aAAA,CAAA,IAAA,EAAA,EAAA,CAAA;AAGjB,IAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,KAAA,KAAU,IAAM,EAAA;AAChD,MAAM,MAAA,IAAI,UAAU,iCAAiC,CAAA;AAAA;AAGtD,IAAM,MAAA,OAAA,GAAU,MAAO,CAAA,OAAA,CAAQ,KAAK,CAAA;AACpC,IAAI,IAAA,OAAA,CAAQ,WAAW,CAAG,EAAA;AACzB,MAAM,MAAA,IAAI,UAAU,kCAAkC,CAAA;AAAA;AAGvD,IAAA,MAAM,IAAO,GAAA,OAAO,OAAQ,CAAA,CAAC,EAAE,CAAC,CAAA;AAChC,IAAI,IAAA,IAAA,KAAS,QAAY,IAAA,IAAA,KAAS,QAAU,EAAA;AAC3C,MAAM,MAAA,IAAI,UAAU,2DAA2D,CAAA;AAAA;AAGhF,IAAA,IAAA,CAAK,IAAO,GAAA,IAAA;AACZ,IAAA,IAAA,CAAK,KAAQ,GAAA,KAAA;AACb,IAAA,IAAA,CAAK,iBAAiB,CAAI,GAAA,OAAA;AAE1B,IAAA,IAAI,SAAS,QAAU,EAAA;AACtB,MAAA,IAAA,CAAK,IAAO,GAAA,CAAA;AAEZ,MAAA,IAAI,IAAO,GAAA,CAAA;AACX,MAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,OAAS,EAAA;AACnC,QAAI,IAAA,OAAO,UAAU,QAAU,EAAA,MAAM,IAAI,SAAU,CAAA,CAAA,cAAA,EAAiB,GAAG,CAAgC,8BAAA,CAAA,CAAA;AACvG,QAAI,IAAA,KAAA,MAAW,QAAQ,CAAI,CAAA,EAAA,MAAM,IAAI,UAAW,CAAA,CAAA,cAAA,EAAiB,GAAG,CAA6C,2CAAA,CAAA,CAAA;AACjH,QAAA,IAAI,SAAS,CAAG,EAAA,MAAM,IAAI,UAAW,CAAA,CAAA,cAAA,EAAiB,GAAG,CAAoC,kCAAA,CAAA,CAAA;AAC7F,QAAQ,IAAA,IAAA,KAAA;AAAA;AAGT,MAAA,IAAA,CAAK,IAAO,GAAA,IAAA;AAAA,KACN,MAAA;AACN,MAAA,IAAA,CAAK,IAAO,GAAA,EAAA;AAEZ,MAAA,IAAI,IAAO,GAAA,EAAA;AACX,MAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,OAAS,EAAA;AACnC,QAAI,IAAA,OAAO,UAAU,QAAU,EAAA,MAAM,IAAI,SAAU,CAAA,CAAA,cAAA,EAAiB,GAAG,CAAgC,8BAAA,CAAA,CAAA;AACvG,QAAA,IAAI,SAAS,EAAI,EAAA,MAAM,IAAI,UAAW,CAAA,CAAA,cAAA,EAAiB,GAAG,CAAoC,kCAAA,CAAA,CAAA;AAC9F,QAAQ,IAAA,IAAA,KAAA;AAAA;AAGT,MAAA,IAAA,CAAK,IAAO,GAAA,IAAA;AAAA;AACb;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWO,QAAQ,UAAoD,EAAA;AAClE,IAAA,QAAQ,OAAO,UAAY;AAAA,MAC1B,KAAK,QAAA;AACJ,QAAA,IAAK,cAAyB,IAAK,CAAA,KAAA,EAAc,OAAA,IAAA,CAAK,MAAM,UAAyB,CAAA;AACrF,QAAM,MAAA,IAAI,WAAW,mEAAmE,CAAA;AAAA,MACzF,KAAK,IAAK,CAAA,IAAA;AACT,QAAA,OAAS,aAAiC,IAAK,CAAA,IAAA;AAAA,MAChD,KAAK,QAAA;AACJ,QAAA,IAAI,MAAM,OAAQ,CAAA,UAAU,CAAG,EAAA,OAAO,WAAW,MAAO,CAAA,CAAC,GAAK,EAAA,KAAA,KAAU,KAAK,OAAQ,CAAA,KAAK,CAAI,GAAA,GAAA,EAAK,KAAK,IAAI,CAAA;AAC5G,QAAM,MAAA,IAAI,UAAU,+CAA+C,CAAA;AAAA,MACpE;AACC,QAAA,MAAM,IAAI,SAAA,CAAU,CAA4D,yDAAA,EAAA,IAAA,CAAK,IAAI,CAAgB,cAAA,CAAA,CAAA;AAAA;AAC3G;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,GAAA,CAAI,OAA8B,IAAsC,EAAA;AAC9E,IAAQ,OAAA,CAAA,IAAA,CAAK,QAAQ,KAAK,CAAA,GAAI,KAAK,OAAQ,CAAA,IAAI,OAAO,IAAK,CAAA,IAAA;AAAA;AAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,GAAA,CAAI,OAA8B,IAAsC,EAAA;AAC9E,IAAM,MAAA,QAAA,GAAW,IAAK,CAAA,OAAA,CAAQ,IAAI,CAAA;AAClC,IAAA,OAAA,CAAQ,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA,GAAI,QAAc,MAAA,QAAA;AAAA;AAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBO,WAAW,KAA+C,EAAA;AAChE,IAAA,OAAO,IAAK,CAAA,UAAA,CAAW,IAAK,CAAA,IAAA,EAAM,KAAK,CAAA;AAAA;AACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBO,SAAS,MAA2D,EAAA;AAC1E,IAAA,IAAI,QAAQ,IAAK,CAAA,IAAA;AACjB,IAAA,KAAA,MAAW,cAAc,MAAQ,EAAA;AAChC,MAAS,KAAA,GAAA,KAAA,GAAQ,IAAK,CAAA,OAAA,CAAQ,UAAU,CAAA;AAAA;AAGzC,IAAO,OAAA,KAAA;AAAA;AACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBO,YAAA,CAAa,aAAoC,MAA2D,EAAA;AAClH,IAAI,IAAA,KAAA,GAAQ,IAAK,CAAA,OAAA,CAAQ,QAAQ,CAAA;AACjC,IAAA,KAAA,MAAW,cAAc,MAAQ,EAAA;AAChC,MAAS,KAAA,GAAA,KAAA,GAAQ,IAAK,CAAA,OAAA,CAAQ,UAAU,CAAA;AAAA;AAGzC,IAAO,OAAA,KAAA;AAAA;AACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBO,UAAA,CAAW,GAA0B,CAA2C,EAAA;AACtF,IAAA,OAAQ,KAAK,OAAQ,CAAA,CAAC,IAAI,CAAC,IAAA,CAAK,QAAQ,CAAC,CAAA;AAAA;AAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBO,mBAAA,CAAoB,GAA0B,CAA2C,EAAA;AAC/F,IAAA,OAAQ,KAAK,OAAQ,CAAA,CAAC,CAAI,GAAA,IAAA,CAAK,QAAQ,CAAC,CAAA;AAAA;AACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBO,QAAQ,KAA+C,EAAA;AAC7D,IAAA,OAAO,CAAC,GAAG,IAAK,CAAA,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA;AAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,CAAQ,OAAO,KAA6D,EAAA;AAC3E,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA;AAC/B,IAAA,KAAA,MAAW,CAAC,GAAK,EAAA,GAAG,CAAK,IAAA,IAAA,CAAK,iBAAiB,CAAG,EAAA;AAEjD,MAAK,IAAA,CAAA,IAAA,GAAO,GAAS,MAAA,GAAA,EAAW,MAAA,GAAA;AAAA;AACjC;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,CAAQ,SAAS,KAAiE,EAAA;AACjF,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA;AAC/B,IAAA,KAAA,MAAW,CAAC,CAAG,EAAA,GAAG,CAAK,IAAA,IAAA,CAAK,iBAAiB,CAAG,EAAA;AAE/C,MAAK,IAAA,CAAA,IAAA,GAAO,GAAS,MAAA,GAAA,EAAW,MAAA,GAAA;AAAA;AACjC;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,CAAQ,UAAU,KAA4F,EAAA;AAC7G,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA;AAC/B,IAAA,KAAA,MAAW,CAAC,GAAK,EAAA,GAAG,CAAK,IAAA,IAAA,CAAK,iBAAiB,CAAG,EAAA;AAEjD,MAAA,IAAA,CAAK,OAAO,GAAS,MAAA,GAAA,EAAW,MAAA,CAAC,KAAK,GAAiC,CAAA;AAAA;AACxE;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBO,SAAS,KAA4D,EAAA;AAC3E,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA;AAC/B,IAAA,OAAO,OAAO,WAAY,CAAA,IAAA,CAAK,iBAAiB,CAAA,CAAE,IAAI,CAAC,CAAC,GAAK,EAAA,GAAG,MAAM,CAAC,GAAA,EAAA,CAAM,OAAO,GAAS,MAAA,GAAG,CAAC,CAAC,CAAA;AAAA;AAEpG,CAAA;AA7UqF,MAAA,CAAA,SAAA,EAAA,UAAA,CAAA;AAA9E,IAAM,QAAN,GAAA;;;ACmBA,SAAS,aAA+B,UAA+D,EAAA;AAC7G,EAAA,MAAM,SAAS,EAAC;AAChB,EAAA,KAAA,MAAW,CAAC,GAAK,EAAA,KAAK,KAAK,MAAO,CAAA,OAAA,CAAQ,UAAU,CAAG,EAAA;AACtD,IAAI,IAAA,MAAA,CAAO,MAAM,MAAO,CAAA,GAAG,CAAC,CAAG,EAAA,MAAA,CAAO,GAAoC,CAAI,GAAA,KAAA;AAAA;AAG/E,EAAO,OAAA,MAAA;AACR;AAPgB,MAAA,CAAA,YAAA,EAAA,cAAA,CAAA","file":"index.cjs","sourcesContent":["const FlagEntriesSymbol = Symbol('@sapphire/bitfield.flags.entries');\n\nexport class BitField<Flags extends Record<string, number> \| Record<string, bigint>> {\n\tpublic readonly type: Flags[keyof Flags] extends number ? 'number' : 'bigint';\n\tpublic readonly zero: Flags[keyof Flags] extends number ? 0 : 0n;\n\tpublic readonly mask: ValueType<this>;\n\tpublic readonly flags: Flags;\n\tprivate readonly [FlagEntriesSymbol]: readonly [string, Flags[keyof Flags]][];\n\n\tpublic constructor(flags: Readonly<Flags>) {\n\t\tif (typeof flags !== 'object' \|\| flags === null) {\n\t\t\tthrow new TypeError('flags must be a non-null object');\n\t\t}\n\n\t\tconst entries = Object.entries(flags) as [string, Flags[keyof Flags]][];\n\t\tif (entries.length === 0) {\n\t\t\tthrow new TypeError('flags must be a non-empty object');\n\t\t}\n\n\t\tconst type = typeof entries[0][1];\n\t\tif (type !== 'number' && type !== 'bigint') {\n\t\t\tthrow new TypeError('A bitfield can only use numbers or bigints for its values');\n\t\t}\n\n\t\tthis.type = type as any;\n\t\tthis.flags = flags;\n\t\tthis[FlagEntriesSymbol] = entries;\n\n\t\tif (type === 'number') {\n\t\t\tthis.zero = 0 as any;\n\n\t\t\tlet mask = 0;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'number') throw new TypeError(`The property \"${key}\" does not resolve to a number`);\n\t\t\t\tif (value !== (value \| 0)) throw new RangeError(`The property \"${key}\" does not resolve to a safe bitfield value`);\n\t\t\t\tif (value <= 0) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t} else {\n\t\t\tthis.zero = 0n as any;\n\n\t\t\tlet mask = 0n;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'bigint') throw new TypeError(`The property \"${key}\" does not resolve to a bigint`);\n\t\t\t\tif (value <= 0n) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t}\n\t}\n\n\t/*\n\t Resolves a:\n\t * - `string`: If it's a property of {@link Flags}.\n\t * - `number`: If the BitField processes `number` primitives.\n\t * - `bigint`: If the BitField processes `bigint` primitives.\n\t * - `Array`: Resolves recursively.\n\t * @param resolvable The value to resolve.\n\t * @returns The resolved value.\n\t /\n\tpublic resolve(resolvable: ValueResolvable<this>): ValueType<this> {\n\t\tswitch (typeof resolvable) {\n\t\t\tcase 'string':\n\t\t\t\tif ((resolvable as string) in this.flags) return this.flags[resolvable as keyof Flags] as any;\n\t\t\t\tthrow new RangeError('Received a name that could not be resolved to a property of flags');\n\t\t\tcase this.type:\n\t\t\t\treturn ((resolvable as ValueType<this>) & this.mask) as any;\n\t\t\tcase 'object':\n\t\t\t\tif (Array.isArray(resolvable)) return resolvable.reduce((acc, value) => this.resolve(value) \| acc, this.zero);\n\t\t\t\tthrow new TypeError('Received an object value that is not an Array');\n\t\t\tdefault:\n\t\t\t\tthrow new TypeError(`Received a value that is not either type \"string\", type \"${this.type}\", or an Array`);\n\t\t}\n\t}\n\n\t/\n\t Checks whether or not `field` contains any of the bits from `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` has any of `bits`'s bits, also denoted as `A ∩ B ≠ ∅`.\n\t /\n\tpublic any(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\treturn (this.resolve(field) & this.resolve(bits)) !== this.zero;\n\t}\n\n\t/\n\t Checks whether or not `field` is a superset of or equal to `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` is a superset of or equal to `bits`, also denoted as `A ⊇ B`.\n\t /\n\tpublic has(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\tconst resolved = this.resolve(bits);\n\t\treturn (this.resolve(field) & resolved) === resolved;\n\t}\n\n\t/\n\t Makes the complement of `field`, which is a field of all bits (of `U` or the union of all {@link Flags} bits)\n\t * that do not belong to `A`. It is the result of `U ∖ A`, or `difference(U, field)`.\n\t * @param field The bits to get the complement of.\n\t * @returns The complement of `field`, also denoted `Aᶜ` or `A'`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.complement(0b0100);\n\t * // 0b1011\n\t * ```\n\t /\n\tpublic complement(field: ValueResolvable<this>): ValueType<this> {\n\t\treturn this.difference(this.mask, field);\n\t}\n\n\t/\n\t Makes a union of all the bits.\n\t * @param fields The bits to create a union of.\n\t * @returns The result of combining all bits together, also denoted as `∅ ⋃ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.union(0b0001, 0b0100);\n\t * // 0b0101\n\t \n\t bitfield.union(0b1100, 0b0001, 0b0010);\n\t * // 0b1111\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Union_(set_theory)}\n\t /\n\tpublic union(...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.zero as ValueType<this>;\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field \| this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Makes an intersection of all the bits.\n\t * @param bitfield The first field.\n\t * @param fields The bits to intersect with `bitfield`.\n\t * @returns The result of intersecting `bitfield` with all of the `fields`, also denoted as `A ⋂ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.intersection(0b0001, 0b0100);\n\t * // 0b0000\n\t \n\t bitfield.intersection(0b1100, 0b0100);\n\t * // 0b0100\n\t \n\t bitfield.intersection(0b1101, 0b0101, 0b1100);\n\t * // 0b0100\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Intersection_(set_theory)}\n\t /\n\tpublic intersection(bitfield: ValueResolvable<this>, ...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.resolve(bitfield);\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field & this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Removes from `a` the bits that exist in `b`.\n\t * @param a The first field.\n\t * @param b The bits to remove from `a`.\n\t * @returns The result of `a ∖ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.difference(0b1100, 0b0100);\n\t * // 0b1000\n\t \n\t bitfield.difference(0b1111, 0b0110);\n\t * // 0b1001\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Difference_(set_theory)}\n\t /\n\tpublic difference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) & ~this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Computes the symmetric difference, denoted as `A ⊖ B` or `A Δ B`, which is the disjunctive union, or the set of\n\t * elements which are in either of the sets, but not in their intersection. As such, this is the result of\n\t * `(A ∖ B) ∪ (B ∖ A)`, `union(difference(a, b), difference(b, a))`, or `a ⊕ b`.\n\t * @remarks The empty set (`∅`) is neutral, as such, `A Δ ∅ = A` and `A Δ A = ∅`\n\t * @param a The first field.\n\t * @param b The second field.\n\t * @returns The result of computing `a Δ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.symmetricDifference(0b1100, 0b0011);\n\t * // 0b1111\n\t \n\t bitfield.symmetricDifference(0b1101, 0b1011);\n\t * // 0b0110\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Symmetric_difference}\n\t /\n\tpublic symmetricDifference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) ^ this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Retrieves an array of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an array.\n\t * @returns The names of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toArray(0b0101);\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toArray(field: ValueResolvable<this>): (keyof Flags)[] {\n\t\treturn [...this.toKeys(field)];\n\t}\n\n\t/\n\t Retrieves an iterator of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the keys of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toKeys(0b0101)];\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toKeys(field: ValueResolvable<this>): IterableIterator<keyof Flags> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield key;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the values from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the values of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toValues(0b0101)];\n\t * // [0b0001, 0b0100]\n\t * ```\n\t /\n\tpublic toValues(field: ValueResolvable<this>): IterableIterator<ValueType<this>> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [_, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield bit as unknown as ValueType<this>;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the entries from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the entries of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toEntries(0b0101)];\n\t * // [['Read', 0b0001], ['Edit', 0b0100]]\n\t * ```\n\t /\n\tpublic toEntries(field: ValueResolvable<this>): IterableIterator<[key: keyof Flags, value: ValueType<this>]> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield [key, bit as unknown as ValueType<this>];\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an object with the properties from {@link Flags} whose values are boolean denoting whether or not the\n\t * flag's bit is contained in `field`.\n\t * @param field The field to convert to an object.\n\t * @returns An object with the properties of {@link Flags} which values are boolean.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toObject(0b0101);\n\t * // {\n\t * // \tRead: true,\n\t * // \tWrite: false,\n\t * // \tEdit: true,\n\t * // \tDelete: false\n\t * // }\n\t * ```\n\t /\n\tpublic toObject(field: ValueResolvable<this>): Record<keyof Flags, boolean> {\n\t\tconst bits = this.resolve(field);\n\t\treturn Object.fromEntries(this[FlagEntriesSymbol].map(([key, bit]) => [key, (bits & bit) === bit])) as Record<keyof Flags, boolean>;\n\t}\n}\n\nexport type PrimitiveType<T> = T extends number ? number : bigint;\n\nexport type MaybeArray<T> = T \| readonly T[];\n\n/\n Resolves the type of the values the specified {@link BitField} takes.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueType<T> = T extends BitField<infer Flags> ? PrimitiveType<Flags[keyof Flags]> : never;\n\n/\n Resolves the possible types accepted by the specified {@link BitField}.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueResolvable<T> = T extends BitField<infer Flags> ? MaybeArray<keyof Flags \| PrimitiveType<Flags[keyof Flags]>> : never;\n","/\n Converts a TypeScript enum to a 1-way object, stripping out the number keys.\n * @param enumObject The enum to convert\n * @example\n * ```typescript\n * enum Permissions {\n * \tRead: 1 << 0,\n * \tWrite: 1 << 1\n * }\n * // {\n * // \tRead: 1,\n * // \tWrite: 2,\n * // \t1: 'Read',\n * // \t2: 'Write'\n * // }\n \n enumToObject(Permissions);\n * // { Read: 1, Write: 2 }\n * ```\n * @returns The mapped object\n */\nexport function enumToObject<T extends object>(enumObject: T): { [K in Exclude<keyof T, `${number}`>]: T[K] } {\n\tconst result = {} as { [K in Exclude<keyof T, `${number}`>]: T[K] };\n\tfor (const [key, value] of Object.entries(enumObject)) {\n\t\tif (Number.isNaN(Number(key))) result[key as Exclude<keyof T, `${number}`>] = value;\n\t}\n\n\treturn result;\n}\n"]}
1	+ {"version":3,"sources":["../../src/lib/BitField.ts","../../src/lib/utilities.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["const FlagEntriesSymbol = Symbol('@sapphire/bitfield.flags.entries');\n\nexport class BitField<Flags extends Record<string, number> \| Record<string, bigint>> {\n\tpublic readonly type: Flags[keyof Flags] extends number ? 'number' : 'bigint';\n\tpublic readonly zero: Flags[keyof Flags] extends number ? 0 : 0n;\n\tpublic readonly mask: ValueType<this>;\n\tpublic readonly flags: Flags;\n\tprivate readonly [FlagEntriesSymbol]: readonly [string, Flags[keyof Flags]][];\n\n\tpublic constructor(flags: Readonly<Flags>) {\n\t\tif (typeof flags !== 'object' \|\| flags === null) {\n\t\t\tthrow new TypeError('flags must be a non-null object');\n\t\t}\n\n\t\tconst entries = Object.entries(flags) as [string, Flags[keyof Flags]][];\n\t\tif (entries.length === 0) {\n\t\t\tthrow new TypeError('flags must be a non-empty object');\n\t\t}\n\n\t\tconst type = typeof entries[0][1];\n\t\tif (type !== 'number' && type !== 'bigint') {\n\t\t\tthrow new TypeError('A bitfield can only use numbers or bigints for its values');\n\t\t}\n\n\t\tthis.type = type as any;\n\t\tthis.flags = flags;\n\t\tthis[FlagEntriesSymbol] = entries;\n\n\t\tif (type === 'number') {\n\t\t\tthis.zero = 0 as any;\n\n\t\t\tlet mask = 0;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'number') throw new TypeError(`The property \"${key}\" does not resolve to a number`);\n\t\t\t\tif (value !== (value \| 0)) throw new RangeError(`The property \"${key}\" does not resolve to a safe bitfield value`);\n\t\t\t\tif (value <= 0) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t} else {\n\t\t\tthis.zero = 0n as any;\n\n\t\t\tlet mask = 0n;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'bigint') throw new TypeError(`The property \"${key}\" does not resolve to a bigint`);\n\t\t\t\tif (value <= 0n) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t}\n\t}\n\n\t/*\n\t Resolves a:\n\t * - `string`: If it's a property of {@link Flags}.\n\t * - `number`: If the BitField processes `number` primitives.\n\t * - `bigint`: If the BitField processes `bigint` primitives.\n\t * - `Array`: Resolves recursively.\n\t * @param resolvable The value to resolve.\n\t * @returns The resolved value.\n\t /\n\tpublic resolve(resolvable: ValueResolvable<this>): ValueType<this> {\n\t\tswitch (typeof resolvable) {\n\t\t\tcase 'string':\n\t\t\t\tif ((resolvable as string) in this.flags) return this.flags[resolvable as keyof Flags] as any;\n\t\t\t\tthrow new RangeError('Received a name that could not be resolved to a property of flags');\n\t\t\tcase this.type:\n\t\t\t\treturn ((resolvable as ValueType<this>) & this.mask) as any;\n\t\t\tcase 'object':\n\t\t\t\tif (Array.isArray(resolvable)) return resolvable.reduce((acc, value) => this.resolve(value) \| acc, this.zero);\n\t\t\t\tthrow new TypeError('Received an object value that is not an Array');\n\t\t\tdefault:\n\t\t\t\tthrow new TypeError(`Received a value that is not either type \"string\", type \"${this.type}\", or an Array`);\n\t\t}\n\t}\n\n\t/\n\t Checks whether or not `field` contains any of the bits from `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` has any of `bits`'s bits, also denoted as `A ∩ B ≠ ∅`.\n\t /\n\tpublic any(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\treturn (this.resolve(field) & this.resolve(bits)) !== this.zero;\n\t}\n\n\t/\n\t Checks whether or not `field` is a superset of or equal to `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` is a superset of or equal to `bits`, also denoted as `A ⊇ B`.\n\t /\n\tpublic has(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\tconst resolved = this.resolve(bits);\n\t\treturn (this.resolve(field) & resolved) === resolved;\n\t}\n\n\t/\n\t Makes the complement of `field`, which is a field of all bits (of `U` or the union of all {@link Flags} bits)\n\t * that do not belong to `A`. It is the result of `U ∖ A`, or `difference(U, field)`.\n\t * @param field The bits to get the complement of.\n\t * @returns The complement of `field`, also denoted `Aᶜ` or `A'`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.complement(0b0100);\n\t * // 0b1011\n\t * ```\n\t /\n\tpublic complement(field: ValueResolvable<this>): ValueType<this> {\n\t\treturn this.difference(this.mask, field);\n\t}\n\n\t/\n\t Makes a union of all the bits.\n\t * @param fields The bits to create a union of.\n\t * @returns The result of combining all bits together, also denoted as `∅ ⋃ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.union(0b0001, 0b0100);\n\t * // 0b0101\n\t \n\t bitfield.union(0b1100, 0b0001, 0b0010);\n\t * // 0b1111\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Union_(set_theory)}\n\t /\n\tpublic union(...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.zero as ValueType<this>;\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field \| this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Makes an intersection of all the bits.\n\t * @param bitfield The first field.\n\t * @param fields The bits to intersect with `bitfield`.\n\t * @returns The result of intersecting `bitfield` with all of the `fields`, also denoted as `A ⋂ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.intersection(0b0001, 0b0100);\n\t * // 0b0000\n\t \n\t bitfield.intersection(0b1100, 0b0100);\n\t * // 0b0100\n\t \n\t bitfield.intersection(0b1101, 0b0101, 0b1100);\n\t * // 0b0100\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Intersection_(set_theory)}\n\t /\n\tpublic intersection(bitfield: ValueResolvable<this>, ...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.resolve(bitfield);\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field & this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Removes from `a` the bits that exist in `b`.\n\t * @param a The first field.\n\t * @param b The bits to remove from `a`.\n\t * @returns The result of `a ∖ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.difference(0b1100, 0b0100);\n\t * // 0b1000\n\t \n\t bitfield.difference(0b1111, 0b0110);\n\t * // 0b1001\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Difference_(set_theory)}\n\t /\n\tpublic difference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) & ~this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Computes the symmetric difference, denoted as `A ⊖ B` or `A Δ B`, which is the disjunctive union, or the set of\n\t * elements which are in either of the sets, but not in their intersection. As such, this is the result of\n\t * `(A ∖ B) ∪ (B ∖ A)`, `union(difference(a, b), difference(b, a))`, or `a ⊕ b`.\n\t * @remarks The empty set (`∅`) is neutral, as such, `A Δ ∅ = A` and `A Δ A = ∅`\n\t * @param a The first field.\n\t * @param b The second field.\n\t * @returns The result of computing `a Δ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.symmetricDifference(0b1100, 0b0011);\n\t * // 0b1111\n\t \n\t bitfield.symmetricDifference(0b1101, 0b1011);\n\t * // 0b0110\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Symmetric_difference}\n\t /\n\tpublic symmetricDifference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) ^ this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Retrieves an array of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an array.\n\t * @returns The names of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toArray(0b0101);\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toArray(field: ValueResolvable<this>): (keyof Flags)[] {\n\t\treturn [...this.toKeys(field)];\n\t}\n\n\t/\n\t Retrieves an iterator of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the keys of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toKeys(0b0101)];\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toKeys(field: ValueResolvable<this>): IterableIterator<keyof Flags> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield key;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the values from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the values of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toValues(0b0101)];\n\t * // [0b0001, 0b0100]\n\t * ```\n\t /\n\tpublic toValues(field: ValueResolvable<this>): IterableIterator<ValueType<this>> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [_, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield bit as unknown as ValueType<this>;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the entries from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the entries of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toEntries(0b0101)];\n\t * // [['Read', 0b0001], ['Edit', 0b0100]]\n\t * ```\n\t /\n\tpublic toEntries(field: ValueResolvable<this>): IterableIterator<[key: keyof Flags, value: ValueType<this>]> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield [key, bit as unknown as ValueType<this>];\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an object with the properties from {@link Flags} whose values are boolean denoting whether or not the\n\t * flag's bit is contained in `field`.\n\t * @param field The field to convert to an object.\n\t * @returns An object with the properties of {@link Flags} which values are boolean.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toObject(0b0101);\n\t * // {\n\t * // \tRead: true,\n\t * // \tWrite: false,\n\t * // \tEdit: true,\n\t * // \tDelete: false\n\t * // }\n\t * ```\n\t /\n\tpublic toObject(field: ValueResolvable<this>): Record<keyof Flags, boolean> {\n\t\tconst bits = this.resolve(field);\n\t\treturn Object.fromEntries(this[FlagEntriesSymbol].map(([key, bit]) => [key, (bits & bit) === bit])) as Record<keyof Flags, boolean>;\n\t}\n}\n\nexport type PrimitiveType<T> = T extends number ? number : bigint;\n\nexport type MaybeArray<T> = T \| readonly T[];\n\n/\n Resolves the type of the values the specified {@link BitField} takes.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueType<T> = T extends BitField<infer Flags> ? PrimitiveType<Flags[keyof Flags]> : never;\n\n/\n Resolves the possible types accepted by the specified {@link BitField}.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueResolvable<T> = T extends BitField<infer Flags> ? MaybeArray<keyof Flags \| PrimitiveType<Flags[keyof Flags]>> : never;\n","/\n Converts a TypeScript enum to a 1-way object, stripping out the number keys.\n * @param enumObject The enum to convert\n * @example\n * ```typescript\n * enum Permissions {\n * \tRead: 1 << 0,\n * \tWrite: 1 << 1\n * }\n * // {\n * // \tRead: 1,\n * // \tWrite: 2,\n * // \t1: 'Read',\n * // \t2: 'Write'\n * // }\n \n enumToObject(Permissions);\n * // { Read: 1, Write: 2 }\n * ```\n * @returns The mapped object\n */\nexport function enumToObject<T extends object>(enumObject: T): { [K in Exclude<keyof T, `${number}`>]: T[K] } {\n\tconst result = {} as { [K in Exclude<keyof T, `${number}`>]: T[K] };\n\tfor (const [key, value] of Object.entries(enumObject)) {\n\t\tif (Number.isNaN(Number(key))) result[key as Exclude<keyof T, `${number}`>] = value;\n\t}\n\n\treturn result;\n}\n"]}

package/dist/esm/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/lib/BitField.ts","../../src/lib/utilities.ts"],"names":[],"mappings":";;;;;;AAAA,IAAM,iBAAA,GAAoB,OAAO,kCAAkC,CAAA;AAAnE,IAAA,EAAA;AAOmB,EAAA,GAAA,iBAAA;AALZ,IAAM,SAAA,GAAN,MAAM,SAAwE,CAAA;AAAA,EAO7E,YAAY,KAAwB,EAAA;AAN3C,IAAgB,aAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAChB,IAAgB,aAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAChB,IAAgB,aAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAChB,IAAgB,aAAA,CAAA,IAAA,EAAA,OAAA,CAAA;AAChB,IAAkB,aAAA,CAAA,IAAA,EAAA,EAAA,CAAA;AAGjB,IAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,KAAA,KAAU,IAAM,EAAA;AAChD,MAAM,MAAA,IAAI,UAAU,iCAAiC,CAAA;AAAA;AAGtD,IAAM,MAAA,OAAA,GAAU,MAAO,CAAA,OAAA,CAAQ,KAAK,CAAA;AACpC,IAAI,IAAA,OAAA,CAAQ,WAAW,CAAG,EAAA;AACzB,MAAM,MAAA,IAAI,UAAU,kCAAkC,CAAA;AAAA;AAGvD,IAAA,MAAM,IAAO,GAAA,OAAO,OAAQ,CAAA,CAAC,EAAE,CAAC,CAAA;AAChC,IAAI,IAAA,IAAA,KAAS,QAAY,IAAA,IAAA,KAAS,QAAU,EAAA;AAC3C,MAAM,MAAA,IAAI,UAAU,2DAA2D,CAAA;AAAA;AAGhF,IAAA,IAAA,CAAK,IAAO,GAAA,IAAA;AACZ,IAAA,IAAA,CAAK,KAAQ,GAAA,KAAA;AACb,IAAA,IAAA,CAAK,iBAAiB,CAAI,GAAA,OAAA;AAE1B,IAAA,IAAI,SAAS,QAAU,EAAA;AACtB,MAAA,IAAA,CAAK,IAAO,GAAA,CAAA;AAEZ,MAAA,IAAI,IAAO,GAAA,CAAA;AACX,MAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,OAAS,EAAA;AACnC,QAAI,IAAA,OAAO,UAAU,QAAU,EAAA,MAAM,IAAI,SAAU,CAAA,CAAA,cAAA,EAAiB,GAAG,CAAgC,8BAAA,CAAA,CAAA;AACvG,QAAI,IAAA,KAAA,MAAW,QAAQ,CAAI,CAAA,EAAA,MAAM,IAAI,UAAW,CAAA,CAAA,cAAA,EAAiB,GAAG,CAA6C,2CAAA,CAAA,CAAA;AACjH,QAAA,IAAI,SAAS,CAAG,EAAA,MAAM,IAAI,UAAW,CAAA,CAAA,cAAA,EAAiB,GAAG,CAAoC,kCAAA,CAAA,CAAA;AAC7F,QAAQ,IAAA,IAAA,KAAA;AAAA;AAGT,MAAA,IAAA,CAAK,IAAO,GAAA,IAAA;AAAA,KACN,MAAA;AACN,MAAA,IAAA,CAAK,IAAO,GAAA,EAAA;AAEZ,MAAA,IAAI,IAAO,GAAA,EAAA;AACX,MAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,OAAS,EAAA;AACnC,QAAI,IAAA,OAAO,UAAU,QAAU,EAAA,MAAM,IAAI,SAAU,CAAA,CAAA,cAAA,EAAiB,GAAG,CAAgC,8BAAA,CAAA,CAAA;AACvG,QAAA,IAAI,SAAS,EAAI,EAAA,MAAM,IAAI,UAAW,CAAA,CAAA,cAAA,EAAiB,GAAG,CAAoC,kCAAA,CAAA,CAAA;AAC9F,QAAQ,IAAA,IAAA,KAAA;AAAA;AAGT,MAAA,IAAA,CAAK,IAAO,GAAA,IAAA;AAAA;AACb;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWO,QAAQ,UAAoD,EAAA;AAClE,IAAA,QAAQ,OAAO,UAAY;AAAA,MAC1B,KAAK,QAAA;AACJ,QAAA,IAAK,cAAyB,IAAK,CAAA,KAAA,EAAc,OAAA,IAAA,CAAK,MAAM,UAAyB,CAAA;AACrF,QAAM,MAAA,IAAI,WAAW,mEAAmE,CAAA;AAAA,MACzF,KAAK,IAAK,CAAA,IAAA;AACT,QAAA,OAAS,aAAiC,IAAK,CAAA,IAAA;AAAA,MAChD,KAAK,QAAA;AACJ,QAAA,IAAI,MAAM,OAAQ,CAAA,UAAU,CAAG,EAAA,OAAO,WAAW,MAAO,CAAA,CAAC,GAAK,EAAA,KAAA,KAAU,KAAK,OAAQ,CAAA,KAAK,CAAI,GAAA,GAAA,EAAK,KAAK,IAAI,CAAA;AAC5G,QAAM,MAAA,IAAI,UAAU,+CAA+C,CAAA;AAAA,MACpE;AACC,QAAA,MAAM,IAAI,SAAA,CAAU,CAA4D,yDAAA,EAAA,IAAA,CAAK,IAAI,CAAgB,cAAA,CAAA,CAAA;AAAA;AAC3G;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,GAAA,CAAI,OAA8B,IAAsC,EAAA;AAC9E,IAAQ,OAAA,CAAA,IAAA,CAAK,QAAQ,KAAK,CAAA,GAAI,KAAK,OAAQ,CAAA,IAAI,OAAO,IAAK,CAAA,IAAA;AAAA;AAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,GAAA,CAAI,OAA8B,IAAsC,EAAA;AAC9E,IAAM,MAAA,QAAA,GAAW,IAAK,CAAA,OAAA,CAAQ,IAAI,CAAA;AAClC,IAAA,OAAA,CAAQ,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA,GAAI,QAAc,MAAA,QAAA;AAAA;AAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBO,WAAW,KAA+C,EAAA;AAChE,IAAA,OAAO,IAAK,CAAA,UAAA,CAAW,IAAK,CAAA,IAAA,EAAM,KAAK,CAAA;AAAA;AACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBO,SAAS,MAA2D,EAAA;AAC1E,IAAA,IAAI,QAAQ,IAAK,CAAA,IAAA;AACjB,IAAA,KAAA,MAAW,cAAc,MAAQ,EAAA;AAChC,MAAS,KAAA,GAAA,KAAA,GAAQ,IAAK,CAAA,OAAA,CAAQ,UAAU,CAAA;AAAA;AAGzC,IAAO,OAAA,KAAA;AAAA;AACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBO,YAAA,CAAa,aAAoC,MAA2D,EAAA;AAClH,IAAI,IAAA,KAAA,GAAQ,IAAK,CAAA,OAAA,CAAQ,QAAQ,CAAA;AACjC,IAAA,KAAA,MAAW,cAAc,MAAQ,EAAA;AAChC,MAAS,KAAA,GAAA,KAAA,GAAQ,IAAK,CAAA,OAAA,CAAQ,UAAU,CAAA;AAAA;AAGzC,IAAO,OAAA,KAAA;AAAA;AACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBO,UAAA,CAAW,GAA0B,CAA2C,EAAA;AACtF,IAAA,OAAQ,KAAK,OAAQ,CAAA,CAAC,IAAI,CAAC,IAAA,CAAK,QAAQ,CAAC,CAAA;AAAA;AAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBO,mBAAA,CAAoB,GAA0B,CAA2C,EAAA;AAC/F,IAAA,OAAQ,KAAK,OAAQ,CAAA,CAAC,CAAI,GAAA,IAAA,CAAK,QAAQ,CAAC,CAAA;AAAA;AACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBO,QAAQ,KAA+C,EAAA;AAC7D,IAAA,OAAO,CAAC,GAAG,IAAK,CAAA,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA;AAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,CAAQ,OAAO,KAA6D,EAAA;AAC3E,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA;AAC/B,IAAA,KAAA,MAAW,CAAC,GAAK,EAAA,GAAG,CAAK,IAAA,IAAA,CAAK,iBAAiB,CAAG,EAAA;AAEjD,MAAK,IAAA,CAAA,IAAA,GAAO,GAAS,MAAA,GAAA,EAAW,MAAA,GAAA;AAAA;AACjC;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,CAAQ,SAAS,KAAiE,EAAA;AACjF,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA;AAC/B,IAAA,KAAA,MAAW,CAAC,CAAG,EAAA,GAAG,CAAK,IAAA,IAAA,CAAK,iBAAiB,CAAG,EAAA;AAE/C,MAAK,IAAA,CAAA,IAAA,GAAO,GAAS,MAAA,GAAA,EAAW,MAAA,GAAA;AAAA;AACjC;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,CAAQ,UAAU,KAA4F,EAAA;AAC7G,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA;AAC/B,IAAA,KAAA,MAAW,CAAC,GAAK,EAAA,GAAG,CAAK,IAAA,IAAA,CAAK,iBAAiB,CAAG,EAAA;AAEjD,MAAA,IAAA,CAAK,OAAO,GAAS,MAAA,GAAA,EAAW,MAAA,CAAC,KAAK,GAAiC,CAAA;AAAA;AACxE;AACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBO,SAAS,KAA4D,EAAA;AAC3E,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,OAAA,CAAQ,KAAK,CAAA;AAC/B,IAAA,OAAO,OAAO,WAAY,CAAA,IAAA,CAAK,iBAAiB,CAAA,CAAE,IAAI,CAAC,CAAC,GAAK,EAAA,GAAG,MAAM,CAAC,GAAA,EAAA,CAAM,OAAO,GAAS,MAAA,GAAG,CAAC,CAAC,CAAA;AAAA;AAEpG,CAAA;AA7UqF,MAAA,CAAA,SAAA,EAAA,UAAA,CAAA;AAA9E,IAAM,QAAN,GAAA;;;ACmBA,SAAS,aAA+B,UAA+D,EAAA;AAC7G,EAAA,MAAM,SAAS,EAAC;AAChB,EAAA,KAAA,MAAW,CAAC,GAAK,EAAA,KAAK,KAAK,MAAO,CAAA,OAAA,CAAQ,UAAU,CAAG,EAAA;AACtD,IAAI,IAAA,MAAA,CAAO,MAAM,MAAO,CAAA,GAAG,CAAC,CAAG,EAAA,MAAA,CAAO,GAAoC,CAAI,GAAA,KAAA;AAAA;AAG/E,EAAO,OAAA,MAAA;AACR;AAPgB,MAAA,CAAA,YAAA,EAAA,cAAA,CAAA","file":"index.mjs","sourcesContent":["const FlagEntriesSymbol = Symbol('@sapphire/bitfield.flags.entries');\n\nexport class BitField<Flags extends Record<string, number> \| Record<string, bigint>> {\n\tpublic readonly type: Flags[keyof Flags] extends number ? 'number' : 'bigint';\n\tpublic readonly zero: Flags[keyof Flags] extends number ? 0 : 0n;\n\tpublic readonly mask: ValueType<this>;\n\tpublic readonly flags: Flags;\n\tprivate readonly [FlagEntriesSymbol]: readonly [string, Flags[keyof Flags]][];\n\n\tpublic constructor(flags: Readonly<Flags>) {\n\t\tif (typeof flags !== 'object' \|\| flags === null) {\n\t\t\tthrow new TypeError('flags must be a non-null object');\n\t\t}\n\n\t\tconst entries = Object.entries(flags) as [string, Flags[keyof Flags]][];\n\t\tif (entries.length === 0) {\n\t\t\tthrow new TypeError('flags must be a non-empty object');\n\t\t}\n\n\t\tconst type = typeof entries[0][1];\n\t\tif (type !== 'number' && type !== 'bigint') {\n\t\t\tthrow new TypeError('A bitfield can only use numbers or bigints for its values');\n\t\t}\n\n\t\tthis.type = type as any;\n\t\tthis.flags = flags;\n\t\tthis[FlagEntriesSymbol] = entries;\n\n\t\tif (type === 'number') {\n\t\t\tthis.zero = 0 as any;\n\n\t\t\tlet mask = 0;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'number') throw new TypeError(`The property \"${key}\" does not resolve to a number`);\n\t\t\t\tif (value !== (value \| 0)) throw new RangeError(`The property \"${key}\" does not resolve to a safe bitfield value`);\n\t\t\t\tif (value <= 0) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t} else {\n\t\t\tthis.zero = 0n as any;\n\n\t\t\tlet mask = 0n;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'bigint') throw new TypeError(`The property \"${key}\" does not resolve to a bigint`);\n\t\t\t\tif (value <= 0n) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t}\n\t}\n\n\t/*\n\t Resolves a:\n\t * - `string`: If it's a property of {@link Flags}.\n\t * - `number`: If the BitField processes `number` primitives.\n\t * - `bigint`: If the BitField processes `bigint` primitives.\n\t * - `Array`: Resolves recursively.\n\t * @param resolvable The value to resolve.\n\t * @returns The resolved value.\n\t /\n\tpublic resolve(resolvable: ValueResolvable<this>): ValueType<this> {\n\t\tswitch (typeof resolvable) {\n\t\t\tcase 'string':\n\t\t\t\tif ((resolvable as string) in this.flags) return this.flags[resolvable as keyof Flags] as any;\n\t\t\t\tthrow new RangeError('Received a name that could not be resolved to a property of flags');\n\t\t\tcase this.type:\n\t\t\t\treturn ((resolvable as ValueType<this>) & this.mask) as any;\n\t\t\tcase 'object':\n\t\t\t\tif (Array.isArray(resolvable)) return resolvable.reduce((acc, value) => this.resolve(value) \| acc, this.zero);\n\t\t\t\tthrow new TypeError('Received an object value that is not an Array');\n\t\t\tdefault:\n\t\t\t\tthrow new TypeError(`Received a value that is not either type \"string\", type \"${this.type}\", or an Array`);\n\t\t}\n\t}\n\n\t/\n\t Checks whether or not `field` contains any of the bits from `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` has any of `bits`'s bits, also denoted as `A ∩ B ≠ ∅`.\n\t /\n\tpublic any(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\treturn (this.resolve(field) & this.resolve(bits)) !== this.zero;\n\t}\n\n\t/\n\t Checks whether or not `field` is a superset of or equal to `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` is a superset of or equal to `bits`, also denoted as `A ⊇ B`.\n\t /\n\tpublic has(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\tconst resolved = this.resolve(bits);\n\t\treturn (this.resolve(field) & resolved) === resolved;\n\t}\n\n\t/\n\t Makes the complement of `field`, which is a field of all bits (of `U` or the union of all {@link Flags} bits)\n\t * that do not belong to `A`. It is the result of `U ∖ A`, or `difference(U, field)`.\n\t * @param field The bits to get the complement of.\n\t * @returns The complement of `field`, also denoted `Aᶜ` or `A'`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.complement(0b0100);\n\t * // 0b1011\n\t * ```\n\t /\n\tpublic complement(field: ValueResolvable<this>): ValueType<this> {\n\t\treturn this.difference(this.mask, field);\n\t}\n\n\t/\n\t Makes a union of all the bits.\n\t * @param fields The bits to create a union of.\n\t * @returns The result of combining all bits together, also denoted as `∅ ⋃ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.union(0b0001, 0b0100);\n\t * // 0b0101\n\t \n\t bitfield.union(0b1100, 0b0001, 0b0010);\n\t * // 0b1111\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Union_(set_theory)}\n\t /\n\tpublic union(...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.zero as ValueType<this>;\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field \| this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Makes an intersection of all the bits.\n\t * @param bitfield The first field.\n\t * @param fields The bits to intersect with `bitfield`.\n\t * @returns The result of intersecting `bitfield` with all of the `fields`, also denoted as `A ⋂ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.intersection(0b0001, 0b0100);\n\t * // 0b0000\n\t \n\t bitfield.intersection(0b1100, 0b0100);\n\t * // 0b0100\n\t \n\t bitfield.intersection(0b1101, 0b0101, 0b1100);\n\t * // 0b0100\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Intersection_(set_theory)}\n\t /\n\tpublic intersection(bitfield: ValueResolvable<this>, ...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.resolve(bitfield);\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field & this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Removes from `a` the bits that exist in `b`.\n\t * @param a The first field.\n\t * @param b The bits to remove from `a`.\n\t * @returns The result of `a ∖ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.difference(0b1100, 0b0100);\n\t * // 0b1000\n\t \n\t bitfield.difference(0b1111, 0b0110);\n\t * // 0b1001\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Difference_(set_theory)}\n\t /\n\tpublic difference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) & ~this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Computes the symmetric difference, denoted as `A ⊖ B` or `A Δ B`, which is the disjunctive union, or the set of\n\t * elements which are in either of the sets, but not in their intersection. As such, this is the result of\n\t * `(A ∖ B) ∪ (B ∖ A)`, `union(difference(a, b), difference(b, a))`, or `a ⊕ b`.\n\t * @remarks The empty set (`∅`) is neutral, as such, `A Δ ∅ = A` and `A Δ A = ∅`\n\t * @param a The first field.\n\t * @param b The second field.\n\t * @returns The result of computing `a Δ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.symmetricDifference(0b1100, 0b0011);\n\t * // 0b1111\n\t \n\t bitfield.symmetricDifference(0b1101, 0b1011);\n\t * // 0b0110\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Symmetric_difference}\n\t /\n\tpublic symmetricDifference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) ^ this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Retrieves an array of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an array.\n\t * @returns The names of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toArray(0b0101);\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toArray(field: ValueResolvable<this>): (keyof Flags)[] {\n\t\treturn [...this.toKeys(field)];\n\t}\n\n\t/\n\t Retrieves an iterator of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the keys of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toKeys(0b0101)];\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toKeys(field: ValueResolvable<this>): IterableIterator<keyof Flags> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield key;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the values from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the values of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toValues(0b0101)];\n\t * // [0b0001, 0b0100]\n\t * ```\n\t /\n\tpublic toValues(field: ValueResolvable<this>): IterableIterator<ValueType<this>> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [_, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield bit as unknown as ValueType<this>;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the entries from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the entries of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toEntries(0b0101)];\n\t * // [['Read', 0b0001], ['Edit', 0b0100]]\n\t * ```\n\t /\n\tpublic toEntries(field: ValueResolvable<this>): IterableIterator<[key: keyof Flags, value: ValueType<this>]> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield [key, bit as unknown as ValueType<this>];\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an object with the properties from {@link Flags} whose values are boolean denoting whether or not the\n\t * flag's bit is contained in `field`.\n\t * @param field The field to convert to an object.\n\t * @returns An object with the properties of {@link Flags} which values are boolean.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toObject(0b0101);\n\t * // {\n\t * // \tRead: true,\n\t * // \tWrite: false,\n\t * // \tEdit: true,\n\t * // \tDelete: false\n\t * // }\n\t * ```\n\t /\n\tpublic toObject(field: ValueResolvable<this>): Record<keyof Flags, boolean> {\n\t\tconst bits = this.resolve(field);\n\t\treturn Object.fromEntries(this[FlagEntriesSymbol].map(([key, bit]) => [key, (bits & bit) === bit])) as Record<keyof Flags, boolean>;\n\t}\n}\n\nexport type PrimitiveType<T> = T extends number ? number : bigint;\n\nexport type MaybeArray<T> = T \| readonly T[];\n\n/\n Resolves the type of the values the specified {@link BitField} takes.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueType<T> = T extends BitField<infer Flags> ? PrimitiveType<Flags[keyof Flags]> : never;\n\n/\n Resolves the possible types accepted by the specified {@link BitField}.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueResolvable<T> = T extends BitField<infer Flags> ? MaybeArray<keyof Flags \| PrimitiveType<Flags[keyof Flags]>> : never;\n","/\n Converts a TypeScript enum to a 1-way object, stripping out the number keys.\n * @param enumObject The enum to convert\n * @example\n * ```typescript\n * enum Permissions {\n * \tRead: 1 << 0,\n * \tWrite: 1 << 1\n * }\n * // {\n * // \tRead: 1,\n * // \tWrite: 2,\n * // \t1: 'Read',\n * // \t2: 'Write'\n * // }\n \n enumToObject(Permissions);\n * // { Read: 1, Write: 2 }\n * ```\n * @returns The mapped object\n */\nexport function enumToObject<T extends object>(enumObject: T): { [K in Exclude<keyof T, `${number}`>]: T[K] } {\n\tconst result = {} as { [K in Exclude<keyof T, `${number}`>]: T[K] };\n\tfor (const [key, value] of Object.entries(enumObject)) {\n\t\tif (Number.isNaN(Number(key))) result[key as Exclude<keyof T, `${number}`>] = value;\n\t}\n\n\treturn result;\n}\n"]}
1	+ {"version":3,"sources":["../../src/lib/BitField.ts","../../src/lib/utilities.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["const FlagEntriesSymbol = Symbol('@sapphire/bitfield.flags.entries');\n\nexport class BitField<Flags extends Record<string, number> \| Record<string, bigint>> {\n\tpublic readonly type: Flags[keyof Flags] extends number ? 'number' : 'bigint';\n\tpublic readonly zero: Flags[keyof Flags] extends number ? 0 : 0n;\n\tpublic readonly mask: ValueType<this>;\n\tpublic readonly flags: Flags;\n\tprivate readonly [FlagEntriesSymbol]: readonly [string, Flags[keyof Flags]][];\n\n\tpublic constructor(flags: Readonly<Flags>) {\n\t\tif (typeof flags !== 'object' \|\| flags === null) {\n\t\t\tthrow new TypeError('flags must be a non-null object');\n\t\t}\n\n\t\tconst entries = Object.entries(flags) as [string, Flags[keyof Flags]][];\n\t\tif (entries.length === 0) {\n\t\t\tthrow new TypeError('flags must be a non-empty object');\n\t\t}\n\n\t\tconst type = typeof entries[0][1];\n\t\tif (type !== 'number' && type !== 'bigint') {\n\t\t\tthrow new TypeError('A bitfield can only use numbers or bigints for its values');\n\t\t}\n\n\t\tthis.type = type as any;\n\t\tthis.flags = flags;\n\t\tthis[FlagEntriesSymbol] = entries;\n\n\t\tif (type === 'number') {\n\t\t\tthis.zero = 0 as any;\n\n\t\t\tlet mask = 0;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'number') throw new TypeError(`The property \"${key}\" does not resolve to a number`);\n\t\t\t\tif (value !== (value \| 0)) throw new RangeError(`The property \"${key}\" does not resolve to a safe bitfield value`);\n\t\t\t\tif (value <= 0) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t} else {\n\t\t\tthis.zero = 0n as any;\n\n\t\t\tlet mask = 0n;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'bigint') throw new TypeError(`The property \"${key}\" does not resolve to a bigint`);\n\t\t\t\tif (value <= 0n) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t}\n\t}\n\n\t/*\n\t Resolves a:\n\t * - `string`: If it's a property of {@link Flags}.\n\t * - `number`: If the BitField processes `number` primitives.\n\t * - `bigint`: If the BitField processes `bigint` primitives.\n\t * - `Array`: Resolves recursively.\n\t * @param resolvable The value to resolve.\n\t * @returns The resolved value.\n\t /\n\tpublic resolve(resolvable: ValueResolvable<this>): ValueType<this> {\n\t\tswitch (typeof resolvable) {\n\t\t\tcase 'string':\n\t\t\t\tif ((resolvable as string) in this.flags) return this.flags[resolvable as keyof Flags] as any;\n\t\t\t\tthrow new RangeError('Received a name that could not be resolved to a property of flags');\n\t\t\tcase this.type:\n\t\t\t\treturn ((resolvable as ValueType<this>) & this.mask) as any;\n\t\t\tcase 'object':\n\t\t\t\tif (Array.isArray(resolvable)) return resolvable.reduce((acc, value) => this.resolve(value) \| acc, this.zero);\n\t\t\t\tthrow new TypeError('Received an object value that is not an Array');\n\t\t\tdefault:\n\t\t\t\tthrow new TypeError(`Received a value that is not either type \"string\", type \"${this.type}\", or an Array`);\n\t\t}\n\t}\n\n\t/\n\t Checks whether or not `field` contains any of the bits from `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` has any of `bits`'s bits, also denoted as `A ∩ B ≠ ∅`.\n\t /\n\tpublic any(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\treturn (this.resolve(field) & this.resolve(bits)) !== this.zero;\n\t}\n\n\t/\n\t Checks whether or not `field` is a superset of or equal to `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` is a superset of or equal to `bits`, also denoted as `A ⊇ B`.\n\t /\n\tpublic has(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\tconst resolved = this.resolve(bits);\n\t\treturn (this.resolve(field) & resolved) === resolved;\n\t}\n\n\t/\n\t Makes the complement of `field`, which is a field of all bits (of `U` or the union of all {@link Flags} bits)\n\t * that do not belong to `A`. It is the result of `U ∖ A`, or `difference(U, field)`.\n\t * @param field The bits to get the complement of.\n\t * @returns The complement of `field`, also denoted `Aᶜ` or `A'`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.complement(0b0100);\n\t * // 0b1011\n\t * ```\n\t /\n\tpublic complement(field: ValueResolvable<this>): ValueType<this> {\n\t\treturn this.difference(this.mask, field);\n\t}\n\n\t/\n\t Makes a union of all the bits.\n\t * @param fields The bits to create a union of.\n\t * @returns The result of combining all bits together, also denoted as `∅ ⋃ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.union(0b0001, 0b0100);\n\t * // 0b0101\n\t \n\t bitfield.union(0b1100, 0b0001, 0b0010);\n\t * // 0b1111\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Union_(set_theory)}\n\t /\n\tpublic union(...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.zero as ValueType<this>;\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field \| this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Makes an intersection of all the bits.\n\t * @param bitfield The first field.\n\t * @param fields The bits to intersect with `bitfield`.\n\t * @returns The result of intersecting `bitfield` with all of the `fields`, also denoted as `A ⋂ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.intersection(0b0001, 0b0100);\n\t * // 0b0000\n\t \n\t bitfield.intersection(0b1100, 0b0100);\n\t * // 0b0100\n\t \n\t bitfield.intersection(0b1101, 0b0101, 0b1100);\n\t * // 0b0100\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Intersection_(set_theory)}\n\t /\n\tpublic intersection(bitfield: ValueResolvable<this>, ...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.resolve(bitfield);\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field & this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Removes from `a` the bits that exist in `b`.\n\t * @param a The first field.\n\t * @param b The bits to remove from `a`.\n\t * @returns The result of `a ∖ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.difference(0b1100, 0b0100);\n\t * // 0b1000\n\t \n\t bitfield.difference(0b1111, 0b0110);\n\t * // 0b1001\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Difference_(set_theory)}\n\t /\n\tpublic difference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) & ~this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Computes the symmetric difference, denoted as `A ⊖ B` or `A Δ B`, which is the disjunctive union, or the set of\n\t * elements which are in either of the sets, but not in their intersection. As such, this is the result of\n\t * `(A ∖ B) ∪ (B ∖ A)`, `union(difference(a, b), difference(b, a))`, or `a ⊕ b`.\n\t * @remarks The empty set (`∅`) is neutral, as such, `A Δ ∅ = A` and `A Δ A = ∅`\n\t * @param a The first field.\n\t * @param b The second field.\n\t * @returns The result of computing `a Δ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.symmetricDifference(0b1100, 0b0011);\n\t * // 0b1111\n\t \n\t bitfield.symmetricDifference(0b1101, 0b1011);\n\t * // 0b0110\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Symmetric_difference}\n\t /\n\tpublic symmetricDifference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) ^ this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Retrieves an array of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an array.\n\t * @returns The names of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toArray(0b0101);\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toArray(field: ValueResolvable<this>): (keyof Flags)[] {\n\t\treturn [...this.toKeys(field)];\n\t}\n\n\t/\n\t Retrieves an iterator of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the keys of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toKeys(0b0101)];\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toKeys(field: ValueResolvable<this>): IterableIterator<keyof Flags> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield key;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the values from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the values of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toValues(0b0101)];\n\t * // [0b0001, 0b0100]\n\t * ```\n\t /\n\tpublic toValues(field: ValueResolvable<this>): IterableIterator<ValueType<this>> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [_, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield bit as unknown as ValueType<this>;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the entries from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the entries of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toEntries(0b0101)];\n\t * // [['Read', 0b0001], ['Edit', 0b0100]]\n\t * ```\n\t /\n\tpublic toEntries(field: ValueResolvable<this>): IterableIterator<[key: keyof Flags, value: ValueType<this>]> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield [key, bit as unknown as ValueType<this>];\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an object with the properties from {@link Flags} whose values are boolean denoting whether or not the\n\t * flag's bit is contained in `field`.\n\t * @param field The field to convert to an object.\n\t * @returns An object with the properties of {@link Flags} which values are boolean.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toObject(0b0101);\n\t * // {\n\t * // \tRead: true,\n\t * // \tWrite: false,\n\t * // \tEdit: true,\n\t * // \tDelete: false\n\t * // }\n\t * ```\n\t /\n\tpublic toObject(field: ValueResolvable<this>): Record<keyof Flags, boolean> {\n\t\tconst bits = this.resolve(field);\n\t\treturn Object.fromEntries(this[FlagEntriesSymbol].map(([key, bit]) => [key, (bits & bit) === bit])) as Record<keyof Flags, boolean>;\n\t}\n}\n\nexport type PrimitiveType<T> = T extends number ? number : bigint;\n\nexport type MaybeArray<T> = T \| readonly T[];\n\n/\n Resolves the type of the values the specified {@link BitField} takes.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueType<T> = T extends BitField<infer Flags> ? PrimitiveType<Flags[keyof Flags]> : never;\n\n/\n Resolves the possible types accepted by the specified {@link BitField}.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueResolvable<T> = T extends BitField<infer Flags> ? MaybeArray<keyof Flags \| PrimitiveType<Flags[keyof Flags]>> : never;\n","/\n Converts a TypeScript enum to a 1-way object, stripping out the number keys.\n * @param enumObject The enum to convert\n * @example\n * ```typescript\n * enum Permissions {\n * \tRead: 1 << 0,\n * \tWrite: 1 << 1\n * }\n * // {\n * // \tRead: 1,\n * // \tWrite: 2,\n * // \t1: 'Read',\n * // \t2: 'Write'\n * // }\n \n enumToObject(Permissions);\n * // { Read: 1, Write: 2 }\n * ```\n * @returns The mapped object\n */\nexport function enumToObject<T extends object>(enumObject: T): { [K in Exclude<keyof T, `${number}`>]: T[K] } {\n\tconst result = {} as { [K in Exclude<keyof T, `${number}`>]: T[K] };\n\tfor (const [key, value] of Object.entries(enumObject)) {\n\t\tif (Number.isNaN(Number(key))) result[key as Exclude<keyof T, `${number}`>] = value;\n\t}\n\n\treturn result;\n}\n"]}

package/dist/iife/index.global.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/lib/BitField.ts","../../src/lib/utilities.ts"],"names":[],"mappings":"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","file":"index.global.js","sourcesContent":["const FlagEntriesSymbol = Symbol('@sapphire/bitfield.flags.entries');\n\nexport class BitField<Flags extends Record<string, number> \| Record<string, bigint>> {\n\tpublic readonly type: Flags[keyof Flags] extends number ? 'number' : 'bigint';\n\tpublic readonly zero: Flags[keyof Flags] extends number ? 0 : 0n;\n\tpublic readonly mask: ValueType<this>;\n\tpublic readonly flags: Flags;\n\tprivate readonly [FlagEntriesSymbol]: readonly [string, Flags[keyof Flags]][];\n\n\tpublic constructor(flags: Readonly<Flags>) {\n\t\tif (typeof flags !== 'object' \|\| flags === null) {\n\t\t\tthrow new TypeError('flags must be a non-null object');\n\t\t}\n\n\t\tconst entries = Object.entries(flags) as [string, Flags[keyof Flags]][];\n\t\tif (entries.length === 0) {\n\t\t\tthrow new TypeError('flags must be a non-empty object');\n\t\t}\n\n\t\tconst type = typeof entries[0][1];\n\t\tif (type !== 'number' && type !== 'bigint') {\n\t\t\tthrow new TypeError('A bitfield can only use numbers or bigints for its values');\n\t\t}\n\n\t\tthis.type = type as any;\n\t\tthis.flags = flags;\n\t\tthis[FlagEntriesSymbol] = entries;\n\n\t\tif (type === 'number') {\n\t\t\tthis.zero = 0 as any;\n\n\t\t\tlet mask = 0;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'number') throw new TypeError(`The property \"${key}\" does not resolve to a number`);\n\t\t\t\tif (value !== (value \| 0)) throw new RangeError(`The property \"${key}\" does not resolve to a safe bitfield value`);\n\t\t\t\tif (value <= 0) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t} else {\n\t\t\tthis.zero = 0n as any;\n\n\t\t\tlet mask = 0n;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'bigint') throw new TypeError(`The property \"${key}\" does not resolve to a bigint`);\n\t\t\t\tif (value <= 0n) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t}\n\t}\n\n\t/*\n\t Resolves a:\n\t * - `string`: If it's a property of {@link Flags}.\n\t * - `number`: If the BitField processes `number` primitives.\n\t * - `bigint`: If the BitField processes `bigint` primitives.\n\t * - `Array`: Resolves recursively.\n\t * @param resolvable The value to resolve.\n\t * @returns The resolved value.\n\t /\n\tpublic resolve(resolvable: ValueResolvable<this>): ValueType<this> {\n\t\tswitch (typeof resolvable) {\n\t\t\tcase 'string':\n\t\t\t\tif ((resolvable as string) in this.flags) return this.flags[resolvable as keyof Flags] as any;\n\t\t\t\tthrow new RangeError('Received a name that could not be resolved to a property of flags');\n\t\t\tcase this.type:\n\t\t\t\treturn ((resolvable as ValueType<this>) & this.mask) as any;\n\t\t\tcase 'object':\n\t\t\t\tif (Array.isArray(resolvable)) return resolvable.reduce((acc, value) => this.resolve(value) \| acc, this.zero);\n\t\t\t\tthrow new TypeError('Received an object value that is not an Array');\n\t\t\tdefault:\n\t\t\t\tthrow new TypeError(`Received a value that is not either type \"string\", type \"${this.type}\", or an Array`);\n\t\t}\n\t}\n\n\t/\n\t Checks whether or not `field` contains any of the bits from `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` has any of `bits`'s bits, also denoted as `A ∩ B ≠ ∅`.\n\t /\n\tpublic any(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\treturn (this.resolve(field) & this.resolve(bits)) !== this.zero;\n\t}\n\n\t/\n\t Checks whether or not `field` is a superset of or equal to `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` is a superset of or equal to `bits`, also denoted as `A ⊇ B`.\n\t /\n\tpublic has(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\tconst resolved = this.resolve(bits);\n\t\treturn (this.resolve(field) & resolved) === resolved;\n\t}\n\n\t/\n\t Makes the complement of `field`, which is a field of all bits (of `U` or the union of all {@link Flags} bits)\n\t * that do not belong to `A`. It is the result of `U ∖ A`, or `difference(U, field)`.\n\t * @param field The bits to get the complement of.\n\t * @returns The complement of `field`, also denoted `Aᶜ` or `A'`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.complement(0b0100);\n\t * // 0b1011\n\t * ```\n\t /\n\tpublic complement(field: ValueResolvable<this>): ValueType<this> {\n\t\treturn this.difference(this.mask, field);\n\t}\n\n\t/\n\t Makes a union of all the bits.\n\t * @param fields The bits to create a union of.\n\t * @returns The result of combining all bits together, also denoted as `∅ ⋃ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.union(0b0001, 0b0100);\n\t * // 0b0101\n\t \n\t bitfield.union(0b1100, 0b0001, 0b0010);\n\t * // 0b1111\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Union_(set_theory)}\n\t /\n\tpublic union(...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.zero as ValueType<this>;\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field \| this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Makes an intersection of all the bits.\n\t * @param bitfield The first field.\n\t * @param fields The bits to intersect with `bitfield`.\n\t * @returns The result of intersecting `bitfield` with all of the `fields`, also denoted as `A ⋂ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.intersection(0b0001, 0b0100);\n\t * // 0b0000\n\t \n\t bitfield.intersection(0b1100, 0b0100);\n\t * // 0b0100\n\t \n\t bitfield.intersection(0b1101, 0b0101, 0b1100);\n\t * // 0b0100\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Intersection_(set_theory)}\n\t /\n\tpublic intersection(bitfield: ValueResolvable<this>, ...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.resolve(bitfield);\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field & this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Removes from `a` the bits that exist in `b`.\n\t * @param a The first field.\n\t * @param b The bits to remove from `a`.\n\t * @returns The result of `a ∖ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.difference(0b1100, 0b0100);\n\t * // 0b1000\n\t \n\t bitfield.difference(0b1111, 0b0110);\n\t * // 0b1001\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Difference_(set_theory)}\n\t /\n\tpublic difference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) & ~this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Computes the symmetric difference, denoted as `A ⊖ B` or `A Δ B`, which is the disjunctive union, or the set of\n\t * elements which are in either of the sets, but not in their intersection. As such, this is the result of\n\t * `(A ∖ B) ∪ (B ∖ A)`, `union(difference(a, b), difference(b, a))`, or `a ⊕ b`.\n\t * @remarks The empty set (`∅`) is neutral, as such, `A Δ ∅ = A` and `A Δ A = ∅`\n\t * @param a The first field.\n\t * @param b The second field.\n\t * @returns The result of computing `a Δ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.symmetricDifference(0b1100, 0b0011);\n\t * // 0b1111\n\t \n\t bitfield.symmetricDifference(0b1101, 0b1011);\n\t * // 0b0110\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Symmetric_difference}\n\t /\n\tpublic symmetricDifference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) ^ this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Retrieves an array of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an array.\n\t * @returns The names of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toArray(0b0101);\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toArray(field: ValueResolvable<this>): (keyof Flags)[] {\n\t\treturn [...this.toKeys(field)];\n\t}\n\n\t/\n\t Retrieves an iterator of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the keys of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toKeys(0b0101)];\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toKeys(field: ValueResolvable<this>): IterableIterator<keyof Flags> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield key;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the values from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the values of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toValues(0b0101)];\n\t * // [0b0001, 0b0100]\n\t * ```\n\t /\n\tpublic toValues(field: ValueResolvable<this>): IterableIterator<ValueType<this>> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [_, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield bit as unknown as ValueType<this>;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the entries from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the entries of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toEntries(0b0101)];\n\t * // [['Read', 0b0001], ['Edit', 0b0100]]\n\t * ```\n\t /\n\tpublic toEntries(field: ValueResolvable<this>): IterableIterator<[key: keyof Flags, value: ValueType<this>]> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield [key, bit as unknown as ValueType<this>];\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an object with the properties from {@link Flags} whose values are boolean denoting whether or not the\n\t * flag's bit is contained in `field`.\n\t * @param field The field to convert to an object.\n\t * @returns An object with the properties of {@link Flags} which values are boolean.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toObject(0b0101);\n\t * // {\n\t * // \tRead: true,\n\t * // \tWrite: false,\n\t * // \tEdit: true,\n\t * // \tDelete: false\n\t * // }\n\t * ```\n\t /\n\tpublic toObject(field: ValueResolvable<this>): Record<keyof Flags, boolean> {\n\t\tconst bits = this.resolve(field);\n\t\treturn Object.fromEntries(this[FlagEntriesSymbol].map(([key, bit]) => [key, (bits & bit) === bit])) as Record<keyof Flags, boolean>;\n\t}\n}\n\nexport type PrimitiveType<T> = T extends number ? number : bigint;\n\nexport type MaybeArray<T> = T \| readonly T[];\n\n/\n Resolves the type of the values the specified {@link BitField} takes.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueType<T> = T extends BitField<infer Flags> ? PrimitiveType<Flags[keyof Flags]> : never;\n\n/\n Resolves the possible types accepted by the specified {@link BitField}.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueResolvable<T> = T extends BitField<infer Flags> ? MaybeArray<keyof Flags \| PrimitiveType<Flags[keyof Flags]>> : never;\n","/\n Converts a TypeScript enum to a 1-way object, stripping out the number keys.\n * @param enumObject The enum to convert\n * @example\n * ```typescript\n * enum Permissions {\n * \tRead: 1 << 0,\n * \tWrite: 1 << 1\n * }\n * // {\n * // \tRead: 1,\n * // \tWrite: 2,\n * // \t1: 'Read',\n * // \t2: 'Write'\n * // }\n \n enumToObject(Permissions);\n * // { Read: 1, Write: 2 }\n * ```\n * @returns The mapped object\n */\nexport function enumToObject<T extends object>(enumObject: T): { [K in Exclude<keyof T, `${number}`>]: T[K] } {\n\tconst result = {} as { [K in Exclude<keyof T, `${number}`>]: T[K] };\n\tfor (const [key, value] of Object.entries(enumObject)) {\n\t\tif (Number.isNaN(Number(key))) result[key as Exclude<keyof T, `${number}`>] = value;\n\t}\n\n\treturn result;\n}\n"]}
1	+ {"version":3,"sources":["../../src/lib/BitField.ts","../../src/lib/utilities.ts"],"names":[],"mappings":"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","file":"index.global.js","sourcesContent":["const FlagEntriesSymbol = Symbol('@sapphire/bitfield.flags.entries');\n\nexport class BitField<Flags extends Record<string, number> \| Record<string, bigint>> {\n\tpublic readonly type: Flags[keyof Flags] extends number ? 'number' : 'bigint';\n\tpublic readonly zero: Flags[keyof Flags] extends number ? 0 : 0n;\n\tpublic readonly mask: ValueType<this>;\n\tpublic readonly flags: Flags;\n\tprivate readonly [FlagEntriesSymbol]: readonly [string, Flags[keyof Flags]][];\n\n\tpublic constructor(flags: Readonly<Flags>) {\n\t\tif (typeof flags !== 'object' \|\| flags === null) {\n\t\t\tthrow new TypeError('flags must be a non-null object');\n\t\t}\n\n\t\tconst entries = Object.entries(flags) as [string, Flags[keyof Flags]][];\n\t\tif (entries.length === 0) {\n\t\t\tthrow new TypeError('flags must be a non-empty object');\n\t\t}\n\n\t\tconst type = typeof entries[0][1];\n\t\tif (type !== 'number' && type !== 'bigint') {\n\t\t\tthrow new TypeError('A bitfield can only use numbers or bigints for its values');\n\t\t}\n\n\t\tthis.type = type as any;\n\t\tthis.flags = flags;\n\t\tthis[FlagEntriesSymbol] = entries;\n\n\t\tif (type === 'number') {\n\t\t\tthis.zero = 0 as any;\n\n\t\t\tlet mask = 0;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'number') throw new TypeError(`The property \"${key}\" does not resolve to a number`);\n\t\t\t\tif (value !== (value \| 0)) throw new RangeError(`The property \"${key}\" does not resolve to a safe bitfield value`);\n\t\t\t\tif (value <= 0) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t} else {\n\t\t\tthis.zero = 0n as any;\n\n\t\t\tlet mask = 0n;\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tif (typeof value !== 'bigint') throw new TypeError(`The property \"${key}\" does not resolve to a bigint`);\n\t\t\t\tif (value <= 0n) throw new RangeError(`The property \"${key}\" resolves to a non-positive value`);\n\t\t\t\tmask \|= value;\n\t\t\t}\n\n\t\t\tthis.mask = mask as any;\n\t\t}\n\t}\n\n\t/*\n\t Resolves a:\n\t * - `string`: If it's a property of {@link Flags}.\n\t * - `number`: If the BitField processes `number` primitives.\n\t * - `bigint`: If the BitField processes `bigint` primitives.\n\t * - `Array`: Resolves recursively.\n\t * @param resolvable The value to resolve.\n\t * @returns The resolved value.\n\t /\n\tpublic resolve(resolvable: ValueResolvable<this>): ValueType<this> {\n\t\tswitch (typeof resolvable) {\n\t\t\tcase 'string':\n\t\t\t\tif ((resolvable as string) in this.flags) return this.flags[resolvable as keyof Flags] as any;\n\t\t\t\tthrow new RangeError('Received a name that could not be resolved to a property of flags');\n\t\t\tcase this.type:\n\t\t\t\treturn ((resolvable as ValueType<this>) & this.mask) as any;\n\t\t\tcase 'object':\n\t\t\t\tif (Array.isArray(resolvable)) return resolvable.reduce((acc, value) => this.resolve(value) \| acc, this.zero);\n\t\t\t\tthrow new TypeError('Received an object value that is not an Array');\n\t\t\tdefault:\n\t\t\t\tthrow new TypeError(`Received a value that is not either type \"string\", type \"${this.type}\", or an Array`);\n\t\t}\n\t}\n\n\t/\n\t Checks whether or not `field` contains any of the bits from `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` has any of `bits`'s bits, also denoted as `A ∩ B ≠ ∅`.\n\t /\n\tpublic any(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\treturn (this.resolve(field) & this.resolve(bits)) !== this.zero;\n\t}\n\n\t/\n\t Checks whether or not `field` is a superset of or equal to `bits`.\n\t * @param field The bits to compare the bits from.\n\t * @param bits The bits to compare with.\n\t * @returns Whether or not `field` is a superset of or equal to `bits`, also denoted as `A ⊇ B`.\n\t /\n\tpublic has(field: ValueResolvable<this>, bits: ValueResolvable<this>): boolean {\n\t\tconst resolved = this.resolve(bits);\n\t\treturn (this.resolve(field) & resolved) === resolved;\n\t}\n\n\t/\n\t Makes the complement of `field`, which is a field of all bits (of `U` or the union of all {@link Flags} bits)\n\t * that do not belong to `A`. It is the result of `U ∖ A`, or `difference(U, field)`.\n\t * @param field The bits to get the complement of.\n\t * @returns The complement of `field`, also denoted `Aᶜ` or `A'`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.complement(0b0100);\n\t * // 0b1011\n\t * ```\n\t /\n\tpublic complement(field: ValueResolvable<this>): ValueType<this> {\n\t\treturn this.difference(this.mask, field);\n\t}\n\n\t/\n\t Makes a union of all the bits.\n\t * @param fields The bits to create a union of.\n\t * @returns The result of combining all bits together, also denoted as `∅ ⋃ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.union(0b0001, 0b0100);\n\t * // 0b0101\n\t \n\t bitfield.union(0b1100, 0b0001, 0b0010);\n\t * // 0b1111\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Union_(set_theory)}\n\t /\n\tpublic union(...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.zero as ValueType<this>;\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field \| this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Makes an intersection of all the bits.\n\t * @param bitfield The first field.\n\t * @param fields The bits to intersect with `bitfield`.\n\t * @returns The result of intersecting `bitfield` with all of the `fields`, also denoted as `A ⋂ fields`.\n\t * @example\n\t * ```typescript\n\t * bitfield.intersection(0b0001, 0b0100);\n\t * // 0b0000\n\t \n\t bitfield.intersection(0b1100, 0b0100);\n\t * // 0b0100\n\t \n\t bitfield.intersection(0b1101, 0b0101, 0b1100);\n\t * // 0b0100\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Intersection_(set_theory)}\n\t /\n\tpublic intersection(bitfield: ValueResolvable<this>, ...fields: readonly ValueResolvable<this>[]): ValueType<this> {\n\t\tlet field = this.resolve(bitfield);\n\t\tfor (const resolvable of fields) {\n\t\t\tfield = (field & this.resolve(resolvable)) as ValueType<this>;\n\t\t}\n\n\t\treturn field;\n\t}\n\n\t/\n\t Removes from `a` the bits that exist in `b`.\n\t * @param a The first field.\n\t * @param b The bits to remove from `a`.\n\t * @returns The result of `a ∖ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.difference(0b1100, 0b0100);\n\t * // 0b1000\n\t \n\t bitfield.difference(0b1111, 0b0110);\n\t * // 0b1001\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Difference_(set_theory)}\n\t /\n\tpublic difference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) & ~this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Computes the symmetric difference, denoted as `A ⊖ B` or `A Δ B`, which is the disjunctive union, or the set of\n\t * elements which are in either of the sets, but not in their intersection. As such, this is the result of\n\t * `(A ∖ B) ∪ (B ∖ A)`, `union(difference(a, b), difference(b, a))`, or `a ⊕ b`.\n\t * @remarks The empty set (`∅`) is neutral, as such, `A Δ ∅ = A` and `A Δ A = ∅`\n\t * @param a The first field.\n\t * @param b The second field.\n\t * @returns The result of computing `a Δ b`.\n\t * @example\n\t * ```typescript\n\t * bitfield.symmetricDifference(0b1100, 0b0011);\n\t * // 0b1111\n\t \n\t bitfield.symmetricDifference(0b1101, 0b1011);\n\t * // 0b0110\n\t * ```\n\t * @seealso {@link https://en.wikipedia.org/wiki/Symmetric_difference}\n\t /\n\tpublic symmetricDifference(a: ValueResolvable<this>, b: ValueResolvable<this>): ValueType<this> {\n\t\treturn (this.resolve(a) ^ this.resolve(b)) as ValueType<this>;\n\t}\n\n\t/\n\t Retrieves an array of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an array.\n\t * @returns The names of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toArray(0b0101);\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toArray(field: ValueResolvable<this>): (keyof Flags)[] {\n\t\treturn [...this.toKeys(field)];\n\t}\n\n\t/\n\t Retrieves an iterator of the properties from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the keys of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toKeys(0b0101)];\n\t * // ['Read', 'Edit']\n\t * ```\n\t /\n\tpublic toKeys(field: ValueResolvable<this>): IterableIterator<keyof Flags> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield key;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the values from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the values of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toValues(0b0101)];\n\t * // [0b0001, 0b0100]\n\t * ```\n\t /\n\tpublic toValues(field: ValueResolvable<this>): IterableIterator<ValueType<this>> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [_, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield bit as unknown as ValueType<this>;\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an iterator of the entries from {@link Flags} whose values are contained in `field`.\n\t * @param field The field to convert to an iterator.\n\t * @returns An iterator with the entries of the {@link BitField}'s flag properties whose value are contained in `field`.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t [...bitfield.toEntries(0b0101)];\n\t * // [['Read', 0b0001], ['Edit', 0b0100]]\n\t * ```\n\t /\n\tpublic toEntries(field: ValueResolvable<this>): IterableIterator<[key: keyof Flags, value: ValueType<this>]> {\n\t\tconst bits = this.resolve(field);\n\t\tfor (const [key, bit] of this[FlagEntriesSymbol]) {\n\t\t\t// Inline `.has` code for lower overhead:\n\t\t\tif ((bits & bit) === bit) yield [key, bit as unknown as ValueType<this>];\n\t\t}\n\t}\n\n\t/*\n\t Retrieves an object with the properties from {@link Flags} whose values are boolean denoting whether or not the\n\t * flag's bit is contained in `field`.\n\t * @param field The field to convert to an object.\n\t * @returns An object with the properties of {@link Flags} which values are boolean.\n\t * @example\n\t * ```typescript\n\t * const bitfield = new BitField({\n\t * \tRead: 0b0001,\n\t * \tWrite: 0b0010,\n\t * \tEdit: 0b0100,\n\t * \tDelete: 0b1000\n\t * });\n\t \n\t bitfield.toObject(0b0101);\n\t * // {\n\t * // \tRead: true,\n\t * // \tWrite: false,\n\t * // \tEdit: true,\n\t * // \tDelete: false\n\t * // }\n\t * ```\n\t /\n\tpublic toObject(field: ValueResolvable<this>): Record<keyof Flags, boolean> {\n\t\tconst bits = this.resolve(field);\n\t\treturn Object.fromEntries(this[FlagEntriesSymbol].map(([key, bit]) => [key, (bits & bit) === bit])) as Record<keyof Flags, boolean>;\n\t}\n}\n\nexport type PrimitiveType<T> = T extends number ? number : bigint;\n\nexport type MaybeArray<T> = T \| readonly T[];\n\n/\n Resolves the type of the values the specified {@link BitField} takes.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueType<T> = T extends BitField<infer Flags> ? PrimitiveType<Flags[keyof Flags]> : never;\n\n/\n Resolves the possible types accepted by the specified {@link BitField}.\n * @typeparam A {@link BitField} instance type.\n /\nexport type ValueResolvable<T> = T extends BitField<infer Flags> ? MaybeArray<keyof Flags \| PrimitiveType<Flags[keyof Flags]>> : never;\n","/\n Converts a TypeScript enum to a 1-way object, stripping out the number keys.\n * @param enumObject The enum to convert\n * @example\n * ```typescript\n * enum Permissions {\n * \tRead: 1 << 0,\n * \tWrite: 1 << 1\n * }\n * // {\n * // \tRead: 1,\n * // \tWrite: 2,\n * // \t1: 'Read',\n * // \t2: 'Write'\n * // }\n \n enumToObject(Permissions);\n * // { Read: 1, Write: 2 }\n * ```\n * @returns The mapped object\n */\nexport function enumToObject<T extends object>(enumObject: T): { [K in Exclude<keyof T, `${number}`>]: T[K] } {\n\tconst result = {} as { [K in Exclude<keyof T, `${number}`>]: T[K] };\n\tfor (const [key, value] of Object.entries(enumObject)) {\n\t\tif (Number.isNaN(Number(key))) result[key as Exclude<keyof T, `${number}`>] = value;\n\t}\n\n\treturn result;\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@sapphire/bitfield",
-  "version": "1.2.5-next.ec05fe56",
+  "version": "1.2.5-next.f3515ea3",
   "description": "A bitfield utility library for JavaScript.",
   "author": "@sapphire",
   "license": "MIT",
@@ -64,12 +64,12 @@
   },
   "devDependencies": {
     "@favware/cliff-jumper": "^6.0.0",
-    "@vitest/coverage-v8": "^2.1.8",
-    "tsup": "^8.3.5",
-    "tsx": "^4.19.2",
+    "@vitest/coverage-v8": "^3.2.4",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.6",
     "typedoc": "^0.26.11",
     "typedoc-json-parser": "^10.2.0",
     "typescript": "~5.4.5",
-    "vitest": "^2.1.8"
+    "vitest": "^3.2.4"
   }
 }