@ancon/wildcat-utils 1.53.1 → 1.53.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancon/wildcat-utils",
-  "version": "1.53.1",
+  "version": "1.53.3",
   "main": "index.js",
   "module": "index.mjs",
   "types": "index.d.ts",
@@ -1115,6 +1115,11 @@
       "require": "./quantity/index.js",
       "types": "./quantity/index.d.ts"
     },
+    "./shared/bitmask": {
+      "import": "./shared/bitmask.mjs",
+      "require": "./shared/bitmask.js",
+      "types": "./shared/bitmask.d.ts"
+    },
     "./shared/constants": {
       "import": "./shared/constants.mjs",
       "require": "./shared/constants.js",

package/shared/bitmask.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Bitmasks where flag `id` is stored as bit 2^(id - 1), e.g. the gift card
+ * template `templates` mask. Ids must be positive integers.
+ *
+ * Uses BigInt internally, because JavaScript's 32-bit bitwise operators give
+ * wrong results for ids above 31.
+ */
+/** Bit value of one flag: 2^(id - 1). */
+export declare function getBitValue(id: number): bigint;
+/** Whether flag `id` is set in `mask`. A null or undefined mask has no flags set. */
+export declare function isBitSet<T extends number>(mask: number | null | undefined, id: T): boolean;
+/** Sum of the given ids as a mask. Returns null when there are no ids. */
+export declare function idsToBitmask<T extends number>(ids: readonly T[]): number | null;
+/**
+ * The candidate ids that are set in `mask`, in the order of `candidates`.
+ * Needed because a mask alone does not say which ids exist.
+ *
+ * Generic over the id type, so numeric enums keep their type:
+ * `bitmaskToIds<GiftCardDesignTemplate>(templates, templateIds)`.
+ */
+export declare function bitmaskToIds<T extends number>(mask: number | null | undefined, candidates: readonly T[]): T[];

package/shared/bitmask.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function s(t){if(!Number.isInteger(t)||t<1)throw new RangeError(`Bitmask id must be a positive integer, got ${t}`)}function n(t){return s(t),BigInt(2)**BigInt(t-1)}function r(t,e){return t?(BigInt(t)&n(e))!==BigInt(0):!1}function o(t){if(t.length===0)return null;const e=t.reduce((i,u)=>i|n(u),BigInt(0));return Number(e)}function a(t,e){return e.filter(i=>r(t,i))}exports.bitmaskToIds=a;exports.getBitValue=n;exports.idsToBitmask=o;exports.isBitSet=r;

package/shared/bitmask.mjs

@@ -0,0 +1,28 @@
+function u(t) {
+  if (!Number.isInteger(t) || t < 1)
+    throw new RangeError(`Bitmask id must be a positive integer, got ${t}`);
+}
+function r(t) {
+  return u(t), BigInt(2) ** BigInt(t - 1);
+}
+function o(t, n) {
+  return t ? (BigInt(t) & r(n)) !== BigInt(0) : !1;
+}
+function s(t) {
+  if (t.length === 0)
+    return null;
+  const n = t.reduce(
+    (e, i) => e | r(i),
+    BigInt(0)
+  );
+  return Number(n);
+}
+function g(t, n) {
+  return n.filter((e) => o(t, e));
+}
+export {
+  g as bitmaskToIds,
+  r as getBitValue,
+  s as idsToBitmask,
+  o as isBitSet
+};

package/shared/index.d.ts

@@ -1,7 +1,8 @@
 import isWithinFlag from './isWithinFlag';
+import { bitmaskToIds, getBitValue, idsToBitmask, isBitSet } from './bitmask';
 import generateId from './generateId';
 import wait from './wait';
 import kiloGramToGram from './kiloGramToGram';
 import gramToKiloGram from './gramToKiloGram';
 import { useMountedRef, usePrevious } from './hooks';
-export { isWithinFlag, generateId, wait, useMountedRef, usePrevious, gramToKiloGram, kiloGramToGram, };
+export { isWithinFlag, bitmaskToIds, getBitValue, idsToBitmask, isBitSet, generateId, wait, useMountedRef, usePrevious, gramToKiloGram, kiloGramToGram, };

package/shared/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./isWithinFlag.js"),r=require("./generateId.js"),o=require("./wait.js"),s=require("./kiloGramToGram.js"),i=require("./gramToKiloGram.js"),a=require("./hooks/usePrevious.js"),t=require("./hooks/useMountedRef.js");require("react");exports.isWithinFlag=e;exports.generateId=r;exports.wait=o;exports.kiloGramToGram=s;exports.gramToKiloGram=i;exports.usePrevious=a;exports.useMountedRef=t;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./isWithinFlag.js"),e=require("./bitmask.js"),i=require("./generateId.js"),s=require("./wait.js"),t=require("./kiloGramToGram.js"),o=require("./gramToKiloGram.js"),a=require("./hooks/usePrevious.js"),u=require("./hooks/useMountedRef.js");require("react");exports.isWithinFlag=r;exports.bitmaskToIds=e.bitmaskToIds;exports.getBitValue=e.getBitValue;exports.idsToBitmask=e.idsToBitmask;exports.isBitSet=e.isBitSet;exports.generateId=i;exports.wait=s;exports.kiloGramToGram=t;exports.gramToKiloGram=o;exports.usePrevious=a;exports.useMountedRef=u;

package/shared/index.mjs

@@ -1,17 +1,22 @@
-import { default as r } from "./isWithinFlag.mjs";
-import { default as f } from "./generateId.mjs";
-import { default as s } from "./wait.mjs";
-import { default as l } from "./kiloGramToGram.mjs";
-import { default as i } from "./gramToKiloGram.mjs";
-import { default as x } from "./hooks/usePrevious.mjs";
-import { default as n } from "./hooks/useMountedRef.mjs";
+import { default as a } from "./isWithinFlag.mjs";
+import { bitmaskToIds as f, getBitValue as s, idsToBitmask as m, isBitSet as i } from "./bitmask.mjs";
+import { default as d } from "./generateId.mjs";
+import { default as p } from "./wait.mjs";
+import { default as g } from "./kiloGramToGram.mjs";
+import { default as k } from "./gramToKiloGram.mjs";
+import { default as B } from "./hooks/usePrevious.mjs";
+import { default as I } from "./hooks/useMountedRef.mjs";
 import "react";
 export {
-  f as generateId,
-  i as gramToKiloGram,
-  r as isWithinFlag,
-  l as kiloGramToGram,
-  n as useMountedRef,
-  x as usePrevious,
-  s as wait
+  f as bitmaskToIds,
+  d as generateId,
+  s as getBitValue,
+  k as gramToKiloGram,
+  m as idsToBitmask,
+  i as isBitSet,
+  a as isWithinFlag,
+  g as kiloGramToGram,
+  I as useMountedRef,
+  B as usePrevious,
+  p as wait
 };