@tempots/std 0.26.1 → 0.28.0

package/number.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./string.cjs"),l=1e-9,s=(e,t,r=360)=>{let n=(t-e)%r;return n<0&&(n+=r),n>r/2&&(n-=r),n},f=(e,t)=>{const r=Math.pow(10,t);return Math.ceil(e*r)/r},a=(e,t,r)=>Math.min(Math.max(e,t),r),u=(e,t,r)=>Math.trunc(a(e,t,r)),g=(e,t)=>a(e,-t,t),M=(e,t)=>e<t?-1:e>t?1:0,h=(e,t)=>{const r=Math.pow(10,t);return Math.floor(e*r)/r},A=(e,t=0)=>p.lpad(e.toString(16),"0",t),i=(e,t,r)=>(t-e)*r+e,N=(e,t,r,n=360)=>o(i(e,e+s(e,t,n),r),n),c=(e,t,r=360)=>{let n=(t-e)%r;return n<0&&(n+=r),n>r/2&&(n-=r),n},d=(e,t,r,n=360)=>o(i(e,e+c(e,t,n),r),n),w=(e,t,r,n=360)=>(e=o(e,n),t=o(t,n),t<e&&(t+=n),o(i(e,t,r),n)),m=(e,t,r,n=360)=>(e=o(e,n),t=o(t,n),t>e&&(t-=n),o(i(e,t,r),n)),C=(e,t,r=l)=>isFinite(e)?isFinite(t)?Math.abs(e-t)<=r:!1:isNaN(e)&&isNaN(t)?!0:isNaN(e)||isNaN(t)||isFinite(t)?!1:e>0==t>0,S=(e,t,r=360,n=l)=>Math.abs(s(e,t,r))<=n,T=(e,t=l)=>Math.abs(e)<=t,E=(e,t)=>Math.pow(e,1/t),W=(e,t)=>{const r=Math.pow(10,t);return Math.round(e*r)/r},q=(e,t,r)=>{const n=r-t+1;return e<t&&(e+=n*((t-e)/n+1)),t+(e-t)%n},o=(e,t)=>(e=e%t,e<0&&(e+=t),e);exports.EPSILON=l;exports.angleDifference=s;exports.ceilTo=f;exports.clamp=a;exports.clampInt=u;exports.clampSym=g;exports.compareNumbers=M;exports.floorTo=h;exports.interpolate=i;exports.interpolateAngle=N;exports.interpolateAngleCCW=m;exports.interpolateAngleCW=w;exports.interpolateWidestAngle=d;exports.nearEqual=C;exports.nearEqualAngles=S;exports.nearZero=T;exports.root=E;exports.roundTo=W;exports.toHex=A;exports.widestAngleDifference=c;exports.wrap=q;exports.wrapCircular=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./string.cjs"),i=1e-9,l=(e,t,n=360)=>{let r=(t-e)%n;return r<0&&(r+=n),r>n/2&&(r-=n),r},f=(e,t)=>{const n=Math.pow(10,t);return Math.ceil(e*n)/n},a=(e,t,n)=>Math.min(Math.max(e,t),n),u=(e,t,n)=>Math.trunc(a(e,t,n)),g=(e,t)=>a(e,-t,t),M=(e,t)=>e<t?-1:e>t?1:0,h=(e,t)=>{const n=Math.pow(10,t);return Math.floor(e*n)/n},d=(e,t=0)=>p.lpad(e.toString(16),"0",t),s=(e,t,n)=>(t-e)*n+e,A=(e,t,n,r=360)=>o(s(e,e+l(e,t,r),n),r),c=(e,t,n=360)=>{let r=(t-e)%n;return r<0&&(r+=n),r>n/2&&(r-=n),r},N=(e,t,n,r=360)=>o(s(e,e+c(e,t,r),n),r),w=(e,t,n,r=360)=>(e=o(e,r),t=o(t,r),t<e&&(t+=r),o(s(e,t,n),r)),m=(e,t,n,r=360)=>(e=o(e,r),t=o(t,r),t>e&&(t-=r),o(s(e,t,n),r)),T=(e,t,n=i)=>isFinite(e)?isFinite(t)?Math.abs(e-t)<=n:!1:isNaN(e)&&isNaN(t)?!0:isNaN(e)||isNaN(t)||isFinite(t)?!1:e>0==t>0,C=(e,t,n=360,r=i)=>Math.abs(l(e,t,n))<=r,E=(e,t=i)=>Math.abs(e)<=t,S=(e,t)=>Math.pow(e,1/t),W=(e,t)=>{const n=Math.pow(10,t);return Math.round(e*n)/n},q=(e,t,n)=>{const r=n-t+1;return e<t&&(e+=r*((t-e)/r+1)),t+(e-t)%r},o=(e,t)=>(e=e%t,e<0&&(e+=t),e),y=(e,t)=>Math.round(e/t)*t;exports.EPSILON=i;exports.angleDifference=l;exports.ceilTo=f;exports.clamp=a;exports.clampInt=u;exports.clampSym=g;exports.compareNumbers=M;exports.floorTo=h;exports.interpolate=s;exports.interpolateAngle=A;exports.interpolateAngleCCW=m;exports.interpolateAngleCW=w;exports.interpolateWidestAngle=N;exports.nearEqual=T;exports.nearEqualAngles=C;exports.nearZero=E;exports.root=S;exports.roundTo=W;exports.snapToGrid=y;exports.toHex=d;exports.widestAngleDifference=c;exports.wrap=q;exports.wrapCircular=o;

package/number.d.ts

@@ -359,3 +359,18 @@ export declare const wrap: (v: number, min: number, max: number) => number;
  * ```
  **/
 export declare const wrapCircular: (v: number, max: number) => number;
+/**
+ * Snaps a value to the nearest multiple of `gridSize`.
+ *
+ * @param value - The value to snap.
+ * @param gridSize - The grid increment to snap to.
+ * @returns The snapped value.
+ * @public
+ * @example
+ * ```ts
+ * snapToGrid(7, 5) // returns 5
+ * snapToGrid(8, 5) // returns 10
+ * snapToGrid(2.3, 0.5) // returns 2.5
+ * ```
+ */
+export declare const snapToGrid: (value: number, gridSize: number) => number;

package/number.js

@@ -1,44 +1,45 @@
-import { lpad as a } from "./string.js";
-const i = 1e-9, c = (t, e, r = 360) => {
-  let n = (e - t) % r;
-  return n < 0 && (n += r), n > r / 2 && (n -= r), n;
+import { lpad as l } from "./string.js";
+const c = 1e-9, i = (t, e, n = 360) => {
+  let o = (e - t) % n;
+  return o < 0 && (o += n), o > n / 2 && (o -= n), o;
 }, h = (t, e) => {
-  const r = Math.pow(10, e);
-  return Math.ceil(t * r) / r;
-}, l = (t, e, r) => Math.min(Math.max(t, e), r), u = (t, e, r) => Math.trunc(l(t, e, r)), M = (t, e) => l(t, -e, e), N = (t, e) => t < e ? -1 : t > e ? 1 : 0, g = (t, e) => {
-  const r = Math.pow(10, e);
-  return Math.floor(t * r) / r;
-}, w = (t, e = 0) => a(t.toString(16), "0", e), s = (t, e, r) => (e - t) * r + t, A = (t, e, r, n = 360) => o(s(t, t + c(t, e, n), r), n), f = (t, e, r = 360) => {
-  let n = (e - t) % r;
-  return n < 0 && (n += r), n > r / 2 && (n -= r), n;
-}, d = (t, e, r, n = 360) => o(s(t, t + f(t, e, n), r), n), m = (t, e, r, n = 360) => (t = o(t, n), e = o(e, n), e < t && (e += n), o(s(t, e, r), n)), C = (t, e, r, n = 360) => (t = o(t, n), e = o(e, n), e > t && (e -= n), o(s(t, e, r), n)), E = (t, e, r = i) => isFinite(t) ? isFinite(e) ? Math.abs(t - e) <= r : !1 : isNaN(t) && isNaN(e) ? !0 : isNaN(t) || isNaN(e) || isFinite(e) ? !1 : t > 0 == e > 0, F = (t, e, r = 360, n = i) => Math.abs(c(t, e, r)) <= n, S = (t, e = i) => Math.abs(t) <= e, T = (t, e) => Math.pow(t, 1 / e), W = (t, e) => {
-  const r = Math.pow(10, e);
-  return Math.round(t * r) / r;
-}, q = (t, e, r) => {
-  const n = r - e + 1;
-  return t < e && (t += n * ((e - t) / n + 1)), e + (t - e) % n;
-}, o = (t, e) => (t = t % e, t < 0 && (t += e), t);
+  const n = Math.pow(10, e);
+  return Math.ceil(t * n) / n;
+}, a = (t, e, n) => Math.min(Math.max(t, e), n), u = (t, e, n) => Math.trunc(a(t, e, n)), M = (t, e) => a(t, -e, e), N = (t, e) => t < e ? -1 : t > e ? 1 : 0, g = (t, e) => {
+  const n = Math.pow(10, e);
+  return Math.floor(t * n) / n;
+}, w = (t, e = 0) => l(t.toString(16), "0", e), s = (t, e, n) => (e - t) * n + t, d = (t, e, n, o = 360) => r(s(t, t + i(t, e, o), n), o), f = (t, e, n = 360) => {
+  let o = (e - t) % n;
+  return o < 0 && (o += n), o > n / 2 && (o -= n), o;
+}, A = (t, e, n, o = 360) => r(s(t, t + f(t, e, o), n), o), m = (t, e, n, o = 360) => (t = r(t, o), e = r(e, o), e < t && (e += o), r(s(t, e, n), o)), C = (t, e, n, o = 360) => (t = r(t, o), e = r(e, o), e > t && (e -= o), r(s(t, e, n), o)), T = (t, e, n = c) => isFinite(t) ? isFinite(e) ? Math.abs(t - e) <= n : !1 : isNaN(t) && isNaN(e) ? !0 : isNaN(t) || isNaN(e) || isFinite(e) ? !1 : t > 0 == e > 0, E = (t, e, n = 360, o = c) => Math.abs(i(t, e, n)) <= o, F = (t, e = c) => Math.abs(t) <= e, W = (t, e) => Math.pow(t, 1 / e), q = (t, e) => {
+  const n = Math.pow(10, e);
+  return Math.round(t * n) / n;
+}, D = (t, e, n) => {
+  const o = n - e + 1;
+  return t < e && (t += o * ((e - t) / o + 1)), e + (t - e) % o;
+}, r = (t, e) => (t = t % e, t < 0 && (t += e), t), I = (t, e) => Math.round(t / e) * e;
 export {
-  i as EPSILON,
-  c as angleDifference,
+  c as EPSILON,
+  i as angleDifference,
   h as ceilTo,
-  l as clamp,
+  a as clamp,
   u as clampInt,
   M as clampSym,
   N as compareNumbers,
   g as floorTo,
   s as interpolate,
-  A as interpolateAngle,
+  d as interpolateAngle,
   C as interpolateAngleCCW,
   m as interpolateAngleCW,
-  d as interpolateWidestAngle,
-  E as nearEqual,
-  F as nearEqualAngles,
-  S as nearZero,
-  T as root,
-  W as roundTo,
+  A as interpolateWidestAngle,
+  T as nearEqual,
+  E as nearEqualAngles,
+  F as nearZero,
+  W as root,
+  q as roundTo,
+  I as snapToGrid,
   w as toHex,
   f as widestAngleDifference,
-  q as wrap,
-  o as wrapCircular
+  D as wrap,
+  r as wrapCircular
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tempots/std",
-  "version": "0.26.1",
+  "version": "0.28.0",
   "priority": 8,
   "description": "Std library for TypeScript. Natural complement to the Tempo libraries.",
   "keywords": [
@@ -41,6 +41,62 @@
       "import": "./boolean.js",
       "require": "./boolean.cjs"
     },
+    "./color-adjust": {
+      "import": "./color-adjust.js",
+      "require": "./color-adjust.cjs"
+    },
+    "./color-contrast": {
+      "import": "./color-contrast.js",
+      "require": "./color-contrast.cjs"
+    },
+    "./color-distance": {
+      "import": "./color-distance.js",
+      "require": "./color-distance.cjs"
+    },
+    "./color-harmony": {
+      "import": "./color-harmony.js",
+      "require": "./color-harmony.cjs"
+    },
+    "./color-hsl": {
+      "import": "./color-hsl.js",
+      "require": "./color-hsl.cjs"
+    },
+    "./color-hsv": {
+      "import": "./color-hsv.js",
+      "require": "./color-hsv.cjs"
+    },
+    "./color-hwb": {
+      "import": "./color-hwb.js",
+      "require": "./color-hwb.cjs"
+    },
+    "./color-lab": {
+      "import": "./color-lab.js",
+      "require": "./color-lab.cjs"
+    },
+    "./color-mix": {
+      "import": "./color-mix.js",
+      "require": "./color-mix.cjs"
+    },
+    "./color-named": {
+      "import": "./color-named.js",
+      "require": "./color-named.cjs"
+    },
+    "./color-oklab": {
+      "import": "./color-oklab.js",
+      "require": "./color-oklab.cjs"
+    },
+    "./color-rgb": {
+      "import": "./color-rgb.js",
+      "require": "./color-rgb.cjs"
+    },
+    "./color-utils": {
+      "import": "./color-utils.js",
+      "require": "./color-utils.cjs"
+    },
+    "./color": {
+      "import": "./color.js",
+      "require": "./color.cjs"
+    },
     "./date": {
       "import": "./date.js",
       "require": "./date.cjs"
@@ -148,6 +204,48 @@
       "boolean": [
         "./boolean.d.ts"
       ],
+      "color-adjust": [
+        "./color-adjust.d.ts"
+      ],
+      "color-contrast": [
+        "./color-contrast.d.ts"
+      ],
+      "color-distance": [
+        "./color-distance.d.ts"
+      ],
+      "color-harmony": [
+        "./color-harmony.d.ts"
+      ],
+      "color-hsl": [
+        "./color-hsl.d.ts"
+      ],
+      "color-hsv": [
+        "./color-hsv.d.ts"
+      ],
+      "color-hwb": [
+        "./color-hwb.d.ts"
+      ],
+      "color-lab": [
+        "./color-lab.d.ts"
+      ],
+      "color-mix": [
+        "./color-mix.d.ts"
+      ],
+      "color-named": [
+        "./color-named.d.ts"
+      ],
+      "color-oklab": [
+        "./color-oklab.d.ts"
+      ],
+      "color-rgb": [
+        "./color-rgb.d.ts"
+      ],
+      "color-utils": [
+        "./color-utils.d.ts"
+      ],
+      "color": [
+        "./color.d.ts"
+      ],
       "date": [
         "./date.d.ts"
       ],