string-match-left-right 8.0.4 → 8.0.10

package/CHANGELOG.md

@@ -3,26 +3,6 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## 8.0.3 (2021-11-02)
-
-### Bug Fixes
-
-- bump TS and separate ESLint plugins away from this monorepo ([b1ebce1](https://github.com/codsen/codsen/commit/b1ebce1637d8c41c2d848fc24b0ba4058865bd5d))
-
-### Features
-
-- migrate to ES Modules ([c579dff](https://github.com/codsen/codsen/commit/c579dff3b23205e383035ca10ddcec671e35d0fe))
-
-### BREAKING CHANGES
-
-- programs now are in ES Modules and won't work with Common JS require()
-
-## 8.0.1 (2021-09-13)
-
-### Bug Fixes
-
-- bump TS and separate ESLint plugins away from this monorepo ([2e07d42](https://github.com/codsen/codsen/commit/2e07d424222b6ffedf5fb45c83ad453627ec2904))
-
 ## 8.0.0 (2021-09-09)
 
 ### Features

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2010-%YEAR% Roy Revelt and other contributors
+Copyright (c) 2010-2021 Roy Revelt and other contributors
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/README.md

@@ -38,6 +38,7 @@ If you need a legacy version which works with `require`, use version 7.1.0
 
 ```js
 import { strict as assert } from "assert";
+
 import {
   matchLeftIncl,
   matchRightIncl,
@@ -63,7 +64,7 @@ assert.equal(matchRight("abcdefghi", 3, ["ef", `zz`]), "ef");
 
 ## Documentation
 
-Please [visit codsen.com](https://codsen.com/os/string-match-left-right/) for a full description of the API and examples.
+Please [visit codsen.com](https://codsen.com/os/string-match-left-right/) for a full description of the API.
 
 ## Contributing
 
@@ -75,4 +76,6 @@ MIT License
 
 Copyright (c) 2010-2021 Roy Revelt and other contributors
 
+
 <img src="https://codsen.com/images/png-codsen-ok.png" width="98" alt="ok" align="center"> <img src="https://codsen.com/images/png-codsen-1.png" width="148" alt="codsen" align="center"> <img src="https://codsen.com/images/png-codsen-star-small.png" width="32" alt="star" align="center">
+

package/dist/string-match-left-right.esm.js

@@ -1,305 +1,13 @@
 /**
  * @name string-match-left-right
  * @fileoverview Match substrings on the left or right of a given index, ignoring whitespace
- * @version 8.0.4
+ * @version 8.0.10
  * @author Roy Revelt, Codsen Ltd
  * @license MIT
  * {@link https://codsen.com/os/string-match-left-right/}
  */
 
-import { arrayiffy } from 'arrayiffy-if-string';
-
-function isObj(something) {
-  return something && typeof something === "object" && !Array.isArray(something);
-}
-function isStr(something) {
-  return typeof something === "string";
-}
-const defaults = {
-  cb: undefined,
-  i: false,
-  trimBeforeMatching: false,
-  trimCharsBeforeMatching: [],
-  maxMismatches: 0,
-  firstMustMatch: false,
-  lastMustMatch: false,
-  hungry: false
-};
-const defaultGetNextIdx = index => index + 1;
-function march(str, position, whatToMatchVal, originalOpts, special = false, getNextIdx = defaultGetNextIdx) {
-  const whatToMatchValVal = typeof whatToMatchVal === "function" ? whatToMatchVal() : whatToMatchVal;
-  if (+position < 0 && special && whatToMatchValVal === "EOL") {
-    return whatToMatchValVal;
-  }
-  const opts = { ...defaults,
-    ...originalOpts
-  };
-  if (position >= str.length && !special) {
-    return false;
-  }
-  let charsToCheckCount = special ? 1 : whatToMatchVal.length;
-  let charsMatchedTotal = 0;
-  let patienceReducedBeforeFirstMatch = false;
-  let lastWasMismatched = false;
-  let atLeastSomethingWasMatched = false;
-  let patience = opts.maxMismatches;
-  let i = position;
-  let somethingFound = false;
-  let firstCharacterMatched = false;
-  let lastCharacterMatched = false;
-  function whitespaceInFrontOfFirstChar() {
-    return (
-      charsMatchedTotal === 1 &&
-      patience < opts.maxMismatches - 1
-    );
-  }
-  while (str[i]) {
-    const nextIdx = getNextIdx(i);
-    if (opts.trimBeforeMatching && str[i].trim() === "") {
-      if (!str[nextIdx] && special && whatToMatchVal === "EOL") {
-        return true;
-      }
-      i = getNextIdx(i);
-      continue;
-    }
-    if (opts && !opts.i && opts.trimCharsBeforeMatching && opts.trimCharsBeforeMatching.includes(str[i]) || opts && opts.i && opts.trimCharsBeforeMatching && opts.trimCharsBeforeMatching.map(val => val.toLowerCase()).includes(str[i].toLowerCase())) {
-      if (special && whatToMatchVal === "EOL" && !str[nextIdx]) {
-        return true;
-      }
-      i = getNextIdx(i);
-      continue;
-    }
-    const charToCompareAgainst = nextIdx > i ? whatToMatchVal[whatToMatchVal.length - charsToCheckCount] : whatToMatchVal[charsToCheckCount - 1];
-    if (!opts.i && str[i] === charToCompareAgainst || opts.i && str[i].toLowerCase() === charToCompareAgainst.toLowerCase()) {
-      if (!somethingFound) {
-        somethingFound = true;
-      }
-      if (!atLeastSomethingWasMatched) {
-        atLeastSomethingWasMatched = true;
-      }
-      if (charsToCheckCount === whatToMatchVal.length) {
-        firstCharacterMatched = true;
-        if (patience !== opts.maxMismatches) {
-          return false;
-        }
-      } else if (charsToCheckCount === 1) {
-        lastCharacterMatched = true;
-      }
-      charsToCheckCount -= 1;
-      charsMatchedTotal++;
-      if (whitespaceInFrontOfFirstChar()) {
-        return false;
-      }
-      if (!charsToCheckCount) {
-        return (
-          charsMatchedTotal !== whatToMatchVal.length ||
-          patience === opts.maxMismatches ||
-          !patienceReducedBeforeFirstMatch ? i : false
-        );
-      }
-    } else {
-      if (!patienceReducedBeforeFirstMatch && !charsMatchedTotal) {
-        patienceReducedBeforeFirstMatch = true;
-      }
-      if (opts.maxMismatches && patience && i) {
-        patience -= 1;
-        for (let y = 0; y <= patience; y++) {
-          const nextCharToCompareAgainst = nextIdx > i ? whatToMatchVal[whatToMatchVal.length - charsToCheckCount + 1 + y] : whatToMatchVal[charsToCheckCount - 2 - y];
-          const nextCharInSource = str[getNextIdx(i)];
-          if (nextCharToCompareAgainst && (!opts.i && str[i] === nextCharToCompareAgainst || opts.i && str[i].toLowerCase() === nextCharToCompareAgainst.toLowerCase()) && (
-          !opts.firstMustMatch || charsToCheckCount !== whatToMatchVal.length)) {
-            charsMatchedTotal++;
-            if (whitespaceInFrontOfFirstChar()) {
-              return false;
-            }
-            charsToCheckCount -= 2;
-            somethingFound = true;
-            break;
-          } else if (nextCharInSource && nextCharToCompareAgainst && (!opts.i && nextCharInSource === nextCharToCompareAgainst || opts.i && nextCharInSource.toLowerCase() === nextCharToCompareAgainst.toLowerCase()) && (
-          !opts.firstMustMatch || charsToCheckCount !== whatToMatchVal.length)) {
-            if (!charsMatchedTotal && !opts.hungry) {
-              return false;
-            }
-            charsToCheckCount -= 1;
-            somethingFound = true;
-            break;
-          } else if (nextCharToCompareAgainst === undefined && patience >= 0 && somethingFound && (!opts.firstMustMatch || firstCharacterMatched) && (!opts.lastMustMatch || lastCharacterMatched)) {
-            return i;
-          }
-        }
-        if (!somethingFound) {
-          lastWasMismatched = i;
-        }
-      } else if (i === 0 && charsToCheckCount === 1 && !opts.lastMustMatch && atLeastSomethingWasMatched) {
-        return 0;
-      } else {
-        return false;
-      }
-    }
-    if (lastWasMismatched !== false && lastWasMismatched !== i) {
-      lastWasMismatched = false;
-    }
-    if (charsToCheckCount < 1) {
-      return i;
-    }
-    i = getNextIdx(i);
-  }
-  if (charsToCheckCount > 0) {
-    if (special && whatToMatchValVal === "EOL") {
-      return true;
-    }
-    if (opts && opts.maxMismatches >= charsToCheckCount && atLeastSomethingWasMatched) {
-      return lastWasMismatched || 0;
-    }
-    return false;
-  }
-}
-function main(mode, str, position, originalWhatToMatch, originalOpts) {
-  if (isObj(originalOpts) && Object.prototype.hasOwnProperty.call(originalOpts, "trimBeforeMatching") && typeof originalOpts.trimBeforeMatching !== "boolean") {
-    throw new Error(`string-match-left-right/${mode}(): [THROW_ID_09] opts.trimBeforeMatching should be boolean!${Array.isArray(originalOpts.trimBeforeMatching) ? ` Did you mean to use opts.trimCharsBeforeMatching?` : ""}`);
-  }
-  const opts = { ...defaults,
-    ...originalOpts
-  };
-  if (typeof opts.trimCharsBeforeMatching === "string") {
-    opts.trimCharsBeforeMatching = arrayiffy(opts.trimCharsBeforeMatching);
-  }
-  opts.trimCharsBeforeMatching = opts.trimCharsBeforeMatching.map(el => isStr(el) ? el : String(el));
-  if (!isStr(str)) {
-    return false;
-  }
-  if (!str.length) {
-    return false;
-  }
-  if (!Number.isInteger(position) || position < 0) {
-    throw new Error(`string-match-left-right/${mode}(): [THROW_ID_03] the second argument should be a natural number. Currently it's of a type: ${typeof position}, equal to:\n${JSON.stringify(position, null, 4)}`);
-  }
-  let whatToMatch;
-  let special;
-  if (isStr(originalWhatToMatch)) {
-    whatToMatch = [originalWhatToMatch];
-  } else if (Array.isArray(originalWhatToMatch)) {
-    whatToMatch = originalWhatToMatch;
-  } else if (!originalWhatToMatch) {
-    whatToMatch = originalWhatToMatch;
-  } else if (typeof originalWhatToMatch === "function") {
-    whatToMatch = [];
-    whatToMatch.push(originalWhatToMatch);
-  } else {
-    throw new Error(`string-match-left-right/${mode}(): [THROW_ID_05] the third argument, whatToMatch, is neither string nor array of strings! It's ${typeof originalWhatToMatch}, equal to:\n${JSON.stringify(originalWhatToMatch, null, 4)}`);
-  }
-  if (originalOpts && !isObj(originalOpts)) {
-    throw new Error(`string-match-left-right/${mode}(): [THROW_ID_06] the fourth argument, options object, should be a plain object. Currently it's of a type "${typeof originalOpts}", and equal to:\n${JSON.stringify(originalOpts, null, 4)}`);
-  }
-  let culpritsIndex = 0;
-  let culpritsVal = "";
-  if (opts && opts.trimCharsBeforeMatching && opts.trimCharsBeforeMatching.some((el, i) => {
-    if (el.length > 1) {
-      culpritsIndex = i;
-      culpritsVal = el;
-      return true;
-    }
-    return false;
-  })) {
-    throw new Error(`string-match-left-right/${mode}(): [THROW_ID_07] the fourth argument, options object contains trimCharsBeforeMatching. It was meant to list the single characters but one of the entries at index ${culpritsIndex} is longer than 1 character, ${culpritsVal.length} (equals to ${culpritsVal}). Please split it into separate characters and put into array as separate elements.`);
-  }
-  if (!whatToMatch || !Array.isArray(whatToMatch) ||
-  Array.isArray(whatToMatch) && !whatToMatch.length ||
-  Array.isArray(whatToMatch) && whatToMatch.length === 1 && isStr(whatToMatch[0]) && !whatToMatch[0].trim()
-  ) {
-    if (typeof opts.cb === "function") {
-      let firstCharOutsideIndex;
-      let startingPosition = position;
-      if (mode === "matchLeftIncl" || mode === "matchRight") {
-        startingPosition += 1;
-      }
-      if (mode[5] === "L") {
-        for (let y = startingPosition; y--;) {
-          const currentChar = str[y];
-          if ((!opts.trimBeforeMatching || opts.trimBeforeMatching && currentChar !== undefined && currentChar.trim()) && (!opts.trimCharsBeforeMatching || !opts.trimCharsBeforeMatching.length || currentChar !== undefined && !opts.trimCharsBeforeMatching.includes(currentChar))) {
-            firstCharOutsideIndex = y;
-            break;
-          }
-        }
-      } else if (mode.startsWith("matchRight")) {
-        for (let y = startingPosition; y < str.length; y++) {
-          const currentChar = str[y];
-          if ((!opts.trimBeforeMatching || opts.trimBeforeMatching && currentChar.trim()) && (!opts.trimCharsBeforeMatching || !opts.trimCharsBeforeMatching.length || !opts.trimCharsBeforeMatching.includes(currentChar))) {
-            firstCharOutsideIndex = y;
-            break;
-          }
-        }
-      }
-      if (firstCharOutsideIndex === undefined) {
-        return false;
-      }
-      const wholeCharacterOutside = str[firstCharOutsideIndex];
-      const indexOfTheCharacterAfter = firstCharOutsideIndex + 1;
-      let theRemainderOfTheString = "";
-      if (indexOfTheCharacterAfter && indexOfTheCharacterAfter > 0) {
-        theRemainderOfTheString = str.slice(0, indexOfTheCharacterAfter);
-      }
-      if (mode[5] === "L") {
-        return opts.cb(wholeCharacterOutside, theRemainderOfTheString, firstCharOutsideIndex);
-      }
-      if (firstCharOutsideIndex && firstCharOutsideIndex > 0) {
-        theRemainderOfTheString = str.slice(firstCharOutsideIndex);
-      }
-      return opts.cb(wholeCharacterOutside, theRemainderOfTheString, firstCharOutsideIndex);
-    }
-    let extraNote = "";
-    if (!originalOpts) {
-      extraNote = " More so, the whole options object, the fourth input argument, is missing!";
-    }
-    throw new Error(`string-match-left-right/${mode}(): [THROW_ID_08] the third argument, "whatToMatch", was given as an empty string. This means, you intend to match purely by a callback. The callback was not set though, the opts key "cb" is not set!${extraNote}`);
-  }
-  for (let i = 0, len = whatToMatch.length; i < len; i++) {
-    special = typeof whatToMatch[i] === "function";
-    const whatToMatchVal = whatToMatch[i];
-    let fullCharacterInFront;
-    let indexOfTheCharacterInFront;
-    let restOfStringInFront = "";
-    let startingPosition = position;
-    if (mode === "matchRight") {
-      startingPosition += 1;
-    } else if (mode === "matchLeft") {
-      startingPosition -= 1;
-    }
-    const found = march(str, startingPosition, whatToMatchVal, opts, special, i2 => mode[5] === "L" ? i2 - 1 : i2 + 1);
-    if (found && special && typeof whatToMatchVal === "function" && whatToMatchVal() === "EOL") {
-      return whatToMatchVal() && (opts.cb ? opts.cb(fullCharacterInFront, restOfStringInFront, indexOfTheCharacterInFront) : true) ? whatToMatchVal() : false;
-    }
-    if (Number.isInteger(found)) {
-      indexOfTheCharacterInFront = mode.startsWith("matchLeft") ? found - 1 : found + 1;
-      if (mode[5] === "L") {
-        restOfStringInFront = str.slice(0, found);
-      } else {
-        restOfStringInFront = str.slice(indexOfTheCharacterInFront);
-      }
-    }
-    if (indexOfTheCharacterInFront < 0) {
-      indexOfTheCharacterInFront = undefined;
-    }
-    if (str[indexOfTheCharacterInFront]) {
-      fullCharacterInFront = str[indexOfTheCharacterInFront];
-    }
-    if (Number.isInteger(found) && (opts.cb ? opts.cb(fullCharacterInFront, restOfStringInFront, indexOfTheCharacterInFront) : true)) {
-      return whatToMatchVal;
-    }
-  }
-  return false;
-}
-function matchLeftIncl(str, position, whatToMatch, opts) {
-  return main("matchLeftIncl", str, position, whatToMatch, opts);
-}
-function matchLeft(str, position, whatToMatch, opts) {
-  return main("matchLeft", str, position, whatToMatch, opts);
-}
-function matchRightIncl(str, position, whatToMatch, opts) {
-  return main("matchRightIncl", str, position, whatToMatch, opts);
-}
-function matchRight(str, position, whatToMatch, opts) {
-  return main("matchRight", str, position, whatToMatch, opts);
-}
-
-export { matchLeft, matchLeftIncl, matchRight, matchRightIncl };
+import{arrayiffy as S}from"arrayiffy-if-string";function p(t){return t&&typeof t=="object"&&!Array.isArray(t)}function M(t){return typeof t=="string"}var R={cb:void 0,i:!1,trimBeforeMatching:!1,trimCharsBeforeMatching:[],maxMismatches:0,firstMustMatch:!1,lastMustMatch:!1,hungry:!1},w=t=>t+1;function N(t,a,n,s,h=!1,o=w){let l=typeof n=="function"?n():n;if(+a<0&&h&&l==="EOL")return l;let r={...R,...s};if(a>=t.length&&!h)return!1;let c=h?1:n.length,E=0,u=!1,i=!1,m=!1,b=r.maxMismatches,e=a,g=!1,f=!1,$=!1;function T(){return E===1&&b<r.maxMismatches-1}for(;t[e];){let V=o(e);if(r.trimBeforeMatching&&t[e].trim()===""){if(!t[V]&&h&&n==="EOL")return!0;e=o(e);continue}if(r&&!r.i&&r.trimCharsBeforeMatching&&r.trimCharsBeforeMatching.includes(t[e])||r?.i&&r.trimCharsBeforeMatching&&r.trimCharsBeforeMatching.map(D=>D.toLowerCase()).includes(t[e].toLowerCase())){if(h&&n==="EOL"&&!t[V])return!0;e=o(e);continue}let d=V>e?n[n.length-c]:n[c-1];if(!r.i&&t[e]===d||r.i&&t[e].toLowerCase()===d.toLowerCase()){if(g||(g=!0),m||(m=!0),c===n.length){if(f=!0,b!==r.maxMismatches)return!1}else c===1&&($=!0);if(c-=1,E++,T())return!1;if(!c)return E!==n.length||b===r.maxMismatches||!u?e:!1}else if(!u&&!E&&(u=!0),r.maxMismatches&&b&&e){b-=1;for(let D=0;D<=b;D++){let C=V>e?n[n.length-c+1+D]:n[c-2-D],O=t[o(e)];if(C&&(!r.i&&t[e]===C||r.i&&t[e].toLowerCase()===C.toLowerCase())&&(!r.firstMustMatch||c!==n.length)){if(E++,T())return!1;c-=2,g=!0;break}else if(O&&C&&(!r.i&&O===C||r.i&&O.toLowerCase()===C.toLowerCase())&&(!r.firstMustMatch||c!==n.length)){if(!E&&!r.hungry)return!1;c-=1,g=!0;break}else if(C===void 0&&b>=0&&g&&(!r.firstMustMatch||f)&&(!r.lastMustMatch||$))return e}g||(i=e)}else return e===0&&c===1&&!r.lastMustMatch&&m?0:!1;if(i!==!1&&i!==e&&(i=!1),c<1)return e;e=o(e)}if(c>0)return h&&l==="EOL"?!0:r&&r.maxMismatches>=c&&m?i||0:!1}function y(t,a,n,s,h){if(p(h)&&Object.prototype.hasOwnProperty.call(h,"trimBeforeMatching")&&typeof h.trimBeforeMatching!="boolean")throw new Error(`string-match-left-right/${t}(): [THROW_ID_09] opts.trimBeforeMatching should be boolean!${Array.isArray(h.trimBeforeMatching)?" Did you mean to use opts.trimCharsBeforeMatching?":""}`);let o={...R,...h};if(typeof o.trimCharsBeforeMatching=="string"&&(o.trimCharsBeforeMatching=S(o.trimCharsBeforeMatching)),o.trimCharsBeforeMatching=o.trimCharsBeforeMatching.map(u=>M(u)?u:String(u)),!M(a)||!a.length)return!1;if(!Number.isInteger(n)||n<0)throw new Error(`string-match-left-right/${t}(): [THROW_ID_03] the second argument should be a natural number. Currently it's of a type: ${typeof n}, equal to:
+${JSON.stringify(n,null,4)}`);let l,r;if(M(s))l=[s];else if(Array.isArray(s))l=s;else if(!s)l=s;else if(typeof s=="function")l=[],l.push(s);else throw new Error(`string-match-left-right/${t}(): [THROW_ID_05] the third argument, whatToMatch, is neither string nor array of strings! It's ${typeof s}, equal to:
+${JSON.stringify(s,null,4)}`);if(h&&!p(h))throw new Error(`string-match-left-right/${t}(): [THROW_ID_06] the fourth argument, options object, should be a plain object. Currently it's of a type "${typeof h}", and equal to:
+${JSON.stringify(h,null,4)}`);let c=0,E="";if(o?.trimCharsBeforeMatching&&o.trimCharsBeforeMatching.some((u,i)=>u.length>1?(c=i,E=u,!0):!1))throw new Error(`string-match-left-right/${t}(): [THROW_ID_07] the fourth argument, options object contains trimCharsBeforeMatching. It was meant to list the single characters but one of the entries at index ${c} is longer than 1 character, ${E.length} (equals to ${E}). Please split it into separate characters and put into array as separate elements.`);if(!l||!Array.isArray(l)||Array.isArray(l)&&!l.length||Array.isArray(l)&&l.length===1&&M(l[0])&&!l[0].trim()){if(typeof o.cb=="function"){let i,m=n;if((t==="matchLeftIncl"||t==="matchRight")&&(m+=1),t[5]==="L")for(let f=m;f--;){let $=a[f];if((!o.trimBeforeMatching||o.trimBeforeMatching&&$!==void 0&&$.trim())&&(!o.trimCharsBeforeMatching||!o.trimCharsBeforeMatching.length||$!==void 0&&!o.trimCharsBeforeMatching.includes($))){i=f;break}}else if(t.startsWith("matchRight"))for(let f=m;f<a.length;f++){let $=a[f];if((!o.trimBeforeMatching||o.trimBeforeMatching&&$.trim())&&(!o.trimCharsBeforeMatching||!o.trimCharsBeforeMatching.length||!o.trimCharsBeforeMatching.includes($))){i=f;break}}if(i===void 0)return!1;let b=a[i],e=i+1,g="";return e&&e>0&&(g=a.slice(0,e)),t[5]==="L"||i&&i>0&&(g=a.slice(i)),o.cb(b,g,i)}let u="";throw h||(u=" More so, the whole options object, the fourth input argument, is missing!"),new Error(`string-match-left-right/${t}(): [THROW_ID_08] the third argument, "whatToMatch", was given as an empty string. This means, you intend to match purely by a callback. The callback was not set though, the opts key "cb" is not set!${u}`)}for(let u=0,i=l.length;u<i;u++){r=typeof l[u]=="function";let m=l[u],b,e,g="",f=n;t==="matchRight"?f+=1:t==="matchLeft"&&(f-=1);let $=N(a,f,m,o,r,T=>t[5]==="L"?T-1:T+1);if($&&r&&typeof m=="function"&&m()==="EOL")return m()&&(o.cb?o.cb(b,g,e):!0)?m():!1;if(Number.isInteger($)&&(e=t.startsWith("matchLeft")?$-1:$+1,t[5]==="L"?g=a.slice(0,$):g=a.slice(e)),e<0&&(e=void 0),a[e]&&(b=a[e]),Number.isInteger($)&&(o.cb?o.cb(b,g,e):!0))return m}return!1}function A(t,a,n,s){return y("matchLeftIncl",t,a,n,s)}function k(t,a,n,s){return y("matchLeft",t,a,n,s)}function B(t,a,n,s){return y("matchRightIncl",t,a,n,s)}function I(t,a,n,s){return y("matchRight",t,a,n,s)}export{k as matchLeft,A as matchLeftIncl,I as matchRight,B as matchRightIncl};

package/dist/string-match-left-right.umd.js

@@ -1,18 +1,21 @@
 /**
  * @name string-match-left-right
  * @fileoverview Match substrings on the left or right of a given index, ignoring whitespace
- * @version 8.0.4
+ * @version 8.0.10
  * @author Roy Revelt, Codsen Ltd
  * @license MIT
  * {@link https://codsen.com/os/string-match-left-right/}
  */
 
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).stringMatchLeftRight={})}(this,(function(t){"use strict";
+var stringMatchLeftRight=(()=>{var y=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames,S=Object.getOwnPropertySymbols;var w=Object.prototype.hasOwnProperty,J=Object.prototype.propertyIsEnumerable;var N=(t,n,e)=>n in t?y(t,n,{enumerable:!0,configurable:!0,writable:!0,value:e}):t[n]=e,V=(t,n)=>{for(var e in n||(n={}))w.call(n,e)&&N(t,e,n[e]);if(S)for(var e of S(n))J.call(n,e)&&N(t,e,n[e]);return t};var x=t=>y(t,"__esModule",{value:!0});var F=(t,n)=>{for(var e in n)y(t,e,{get:n[e],enumerable:!0})},H=(t,n,e,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let l of I(n))!w.call(t,l)&&(e||l!=="default")&&y(t,l,{get:()=>n[l],enumerable:!(s=B(n,l))||s.enumerable});return t};var P=(t=>(n,e)=>t&&t.get(n)||(e=H(x({}),n,1),t&&t.set(n,e),e))(typeof WeakMap!="undefined"?new WeakMap:0);var G={};F(G,{matchLeft:()=>_,matchLeftIncl:()=>W,matchRight:()=>Y,matchRightIncl:()=>q});function L(t){return typeof t=="string"?t.length?[t]:[]:t}function A(t){return t&&typeof t=="object"&&!Array.isArray(t)}function O(t){return typeof t=="string"}var k={cb:void 0,i:!1,trimBeforeMatching:!1,trimCharsBeforeMatching:[],maxMismatches:0,firstMustMatch:!1,lastMustMatch:!1,hungry:!1},U=t=>t+1;function j(t,n,e,s,l=!1,r=U){var K;let i=typeof e=="function"?e():e;if(+n<0&&l&&i==="EOL")return i;let a=V(V({},k),s);if(n>=t.length&&!l)return!1;let u=l?1:e.length,E=0,h=!1,c=!1,m=!1,b=a.maxMismatches,o=n,g=!1,f=!1,$=!1;function T(){return E===1&&b<a.maxMismatches-1}for(;t[o];){let M=r(o);if(a.trimBeforeMatching&&t[o].trim()===""){if(!t[M]&&l&&e==="EOL")return!0;o=r(o);continue}if(a&&!a.i&&a.trimCharsBeforeMatching&&a.trimCharsBeforeMatching.includes(t[o])||(a==null?void 0:a.i)&&a.trimCharsBeforeMatching&&a.trimCharsBeforeMatching.map(D=>D.toLowerCase()).includes(t[o].toLowerCase())){if(l&&e==="EOL"&&!t[M])return!0;o=r(o);continue}let R=M>o?e[e.length-u]:e[u-1];if(!a.i&&t[o]===R||a.i&&t[o].toLowerCase()===R.toLowerCase()){if(g||(g=!0),m||(m=!0),u===e.length){if(f=!0,b!==a.maxMismatches)return!1}else u===1&&($=!0);if(u-=1,E++,T())return!1;if(!u)return E!==e.length||b===a.maxMismatches||!h?o:!1}else if(!h&&!E&&(h=!0),a.maxMismatches&&b&&o){b-=1;for(let D=0;D<=b;D++){let C=M>o?e[e.length-u+1+D]:e[u-2-D],p=t[r(o)];if(C&&(!a.i&&t[o]===C||a.i&&t[o].toLowerCase()===C.toLowerCase())&&(!a.firstMustMatch||u!==e.length)){if(E++,T())return!1;u-=2,g=!0;break}else if(p&&C&&(!a.i&&p===C||a.i&&p.toLowerCase()===C.toLowerCase())&&(!a.firstMustMatch||u!==e.length)){if(!E&&!a.hungry)return!1;u-=1,g=!0;break}else if(C===void 0&&b>=0&&g&&(!a.firstMustMatch||f)&&(!a.lastMustMatch||$))return o}g||(c=o)}else return o===0&&u===1&&!a.lastMustMatch&&m?0:!1;if(c!==!1&&c!==o&&(c=!1),u<1)return o;o=r(o)}if(u>0)return l&&i==="EOL"?!0:a&&a.maxMismatches>=u&&m?c||0:!1}function d(t,n,e,s,l){if(A(l)&&Object.prototype.hasOwnProperty.call(l,"trimBeforeMatching")&&typeof l.trimBeforeMatching!="boolean")throw new Error(`string-match-left-right/${t}(): [THROW_ID_09] opts.trimBeforeMatching should be boolean!${Array.isArray(l.trimBeforeMatching)?" Did you mean to use opts.trimCharsBeforeMatching?":""}`);let r=V(V({},k),l);if(typeof r.trimCharsBeforeMatching=="string"&&(r.trimCharsBeforeMatching=L(r.trimCharsBeforeMatching)),r.trimCharsBeforeMatching=r.trimCharsBeforeMatching.map(h=>O(h)?h:String(h)),!O(n)||!n.length)return!1;if(!Number.isInteger(e)||e<0)throw new Error(`string-match-left-right/${t}(): [THROW_ID_03] the second argument should be a natural number. Currently it's of a type: ${typeof e}, equal to:
+${JSON.stringify(e,null,4)}`);let i,a;if(O(s))i=[s];else if(Array.isArray(s))i=s;else if(!s)i=s;else if(typeof s=="function")i=[],i.push(s);else throw new Error(`string-match-left-right/${t}(): [THROW_ID_05] the third argument, whatToMatch, is neither string nor array of strings! It's ${typeof s}, equal to:
+${JSON.stringify(s,null,4)}`);if(l&&!A(l))throw new Error(`string-match-left-right/${t}(): [THROW_ID_06] the fourth argument, options object, should be a plain object. Currently it's of a type "${typeof l}", and equal to:
+${JSON.stringify(l,null,4)}`);let u=0,E="";if((r==null?void 0:r.trimCharsBeforeMatching)&&r.trimCharsBeforeMatching.some((h,c)=>h.length>1?(u=c,E=h,!0):!1))throw new Error(`string-match-left-right/${t}(): [THROW_ID_07] the fourth argument, options object contains trimCharsBeforeMatching. It was meant to list the single characters but one of the entries at index ${u} is longer than 1 character, ${E.length} (equals to ${E}). Please split it into separate characters and put into array as separate elements.`);if(!i||!Array.isArray(i)||Array.isArray(i)&&!i.length||Array.isArray(i)&&i.length===1&&O(i[0])&&!i[0].trim()){if(typeof r.cb=="function"){let c,m=e;if((t==="matchLeftIncl"||t==="matchRight")&&(m+=1),t[5]==="L")for(let f=m;f--;){let $=n[f];if((!r.trimBeforeMatching||r.trimBeforeMatching&&$!==void 0&&$.trim())&&(!r.trimCharsBeforeMatching||!r.trimCharsBeforeMatching.length||$!==void 0&&!r.trimCharsBeforeMatching.includes($))){c=f;break}}else if(t.startsWith("matchRight"))for(let f=m;f<n.length;f++){let $=n[f];if((!r.trimBeforeMatching||r.trimBeforeMatching&&$.trim())&&(!r.trimCharsBeforeMatching||!r.trimCharsBeforeMatching.length||!r.trimCharsBeforeMatching.includes($))){c=f;break}}if(c===void 0)return!1;let b=n[c],o=c+1,g="";return o&&o>0&&(g=n.slice(0,o)),t[5]==="L"||c&&c>0&&(g=n.slice(c)),r.cb(b,g,c)}let h="";throw l||(h=" More so, the whole options object, the fourth input argument, is missing!"),new Error(`string-match-left-right/${t}(): [THROW_ID_08] the third argument, "whatToMatch", was given as an empty string. This means, you intend to match purely by a callback. The callback was not set though, the opts key "cb" is not set!${h}`)}for(let h=0,c=i.length;h<c;h++){a=typeof i[h]=="function";let m=i[h],b,o,g="",f=e;t==="matchRight"?f+=1:t==="matchLeft"&&(f-=1);let $=j(n,f,m,r,a,T=>t[5]==="L"?T-1:T+1);if($&&a&&typeof m=="function"&&m()==="EOL")return m()&&(r.cb?r.cb(b,g,o):!0)?m():!1;if(Number.isInteger($)&&(o=t.startsWith("matchLeft")?$-1:$+1,t[5]==="L"?g=n.slice(0,$):g=n.slice(o)),o<0&&(o=void 0),n[o]&&(b=n[o]),Number.isInteger($)&&(r.cb?r.cb(b,g,o):!0))return m}return!1}function W(t,n,e,s){return d("matchLeftIncl",t,n,e,s)}function _(t,n,e,s){return d("matchLeft",t,n,e,s)}function q(t,n,e,s){return d("matchRightIncl",t,n,e,s)}function Y(t,n,e,s){return d("matchRight",t,n,e,s)}return P(G);})();
 /**
  * @name arrayiffy-if-string
  * @fileoverview Put non-empty strings into arrays, turn empty-ones into empty arrays. Bypass everything else.
- * @version 4.0.4
+ * @version 4.0.10
  * @author Roy Revelt, Codsen Ltd
  * @license MIT
  * {@link https://codsen.com/os/arrayiffy-if-string/}
- */function e(t){return t&&"object"==typeof t&&!Array.isArray(t)}function r(t){return"string"==typeof t}const i={cb:void 0,i:!1,trimBeforeMatching:!1,trimCharsBeforeMatching:[],maxMismatches:0,firstMustMatch:!1,lastMustMatch:!1,hungry:!1},n=t=>t+1;function a(t,e,r,a,o=!1,s=n){const h="function"==typeof r?r():r;if(+e<0&&o&&"EOL"===h)return h;const c={...i,...a};if(e>=t.length&&!o)return!1;let f=o?1:r.length,u=0,l=!1,g=!1,m=!1,M=c.maxMismatches,y=e,p=!1,b=!1,d=!1;function B(){return 1===u&&M<c.maxMismatches-1}for(;t[y];){const e=s(y);if(c.trimBeforeMatching&&""===t[y].trim()){if(!t[e]&&o&&"EOL"===r)return!0;y=s(y);continue}if(c&&!c.i&&c.trimCharsBeforeMatching&&c.trimCharsBeforeMatching.includes(t[y])||c&&c.i&&c.trimCharsBeforeMatching&&c.trimCharsBeforeMatching.map((t=>t.toLowerCase())).includes(t[y].toLowerCase())){if(o&&"EOL"===r&&!t[e])return!0;y=s(y);continue}const i=e>y?r[r.length-f]:r[f-1];if(!c.i&&t[y]===i||c.i&&t[y].toLowerCase()===i.toLowerCase()){if(p||(p=!0),m||(m=!0),f===r.length){if(b=!0,M!==c.maxMismatches)return!1}else 1===f&&(d=!0);if(f-=1,u++,B())return!1;if(!f)return(u!==r.length||M===c.maxMismatches||!l)&&y}else{if(l||u||(l=!0),!(c.maxMismatches&&M&&y))return!(0!==y||1!==f||c.lastMustMatch||!m)&&0;M-=1;for(let i=0;i<=M;i++){const n=e>y?r[r.length-f+1+i]:r[f-2-i],a=t[s(y)];if(n&&(!c.i&&t[y]===n||c.i&&t[y].toLowerCase()===n.toLowerCase())&&(!c.firstMustMatch||f!==r.length)){if(u++,B())return!1;f-=2,p=!0;break}if(a&&n&&(!c.i&&a===n||c.i&&a.toLowerCase()===n.toLowerCase())&&(!c.firstMustMatch||f!==r.length)){if(!u&&!c.hungry)return!1;f-=1,p=!0;break}if(void 0===n&&M>=0&&p&&(!c.firstMustMatch||b)&&(!c.lastMustMatch||d))return y}p||(g=y)}if(!1!==g&&g!==y&&(g=!1),f<1)return y;y=s(y)}return f>0?!(!o||"EOL"!==h)||!!(c&&c.maxMismatches>=f&&m)&&(g||0):void 0}function o(t,n,o,s,h){if(e(h)&&Object.prototype.hasOwnProperty.call(h,"trimBeforeMatching")&&"boolean"!=typeof h.trimBeforeMatching)throw new Error(`string-match-left-right/${t}(): [THROW_ID_09] opts.trimBeforeMatching should be boolean!${Array.isArray(h.trimBeforeMatching)?" Did you mean to use opts.trimCharsBeforeMatching?":""}`);const c={...i,...h};var f;if("string"==typeof c.trimCharsBeforeMatching&&(c.trimCharsBeforeMatching="string"==typeof(f=c.trimCharsBeforeMatching)?f.length?[f]:[]:f),c.trimCharsBeforeMatching=c.trimCharsBeforeMatching.map((t=>r(t)?t:String(t))),!r(n))return!1;if(!n.length)return!1;if(!Number.isInteger(o)||o<0)throw new Error(`string-match-left-right/${t}(): [THROW_ID_03] the second argument should be a natural number. Currently it's of a type: ${typeof o}, equal to:\n${JSON.stringify(o,null,4)}`);let u,l;if(r(s))u=[s];else if(Array.isArray(s))u=s;else if(s){if("function"!=typeof s)throw new Error(`string-match-left-right/${t}(): [THROW_ID_05] the third argument, whatToMatch, is neither string nor array of strings! It's ${typeof s}, equal to:\n${JSON.stringify(s,null,4)}`);u=[],u.push(s)}else u=s;if(h&&!e(h))throw new Error(`string-match-left-right/${t}(): [THROW_ID_06] the fourth argument, options object, should be a plain object. Currently it's of a type "${typeof h}", and equal to:\n${JSON.stringify(h,null,4)}`);let g=0,m="";if(c&&c.trimCharsBeforeMatching&&c.trimCharsBeforeMatching.some(((t,e)=>t.length>1&&(g=e,m=t,!0))))throw new Error(`string-match-left-right/${t}(): [THROW_ID_07] the fourth argument, options object contains trimCharsBeforeMatching. It was meant to list the single characters but one of the entries at index ${g} is longer than 1 character, ${m.length} (equals to ${m}). Please split it into separate characters and put into array as separate elements.`);if(!u||!Array.isArray(u)||Array.isArray(u)&&!u.length||Array.isArray(u)&&1===u.length&&r(u[0])&&!u[0].trim()){if("function"==typeof c.cb){let e,r=o;if("matchLeftIncl"!==t&&"matchRight"!==t||(r+=1),"L"===t[5])for(let t=r;t--;){const r=n[t];if((!c.trimBeforeMatching||c.trimBeforeMatching&&void 0!==r&&r.trim())&&(!c.trimCharsBeforeMatching||!c.trimCharsBeforeMatching.length||void 0!==r&&!c.trimCharsBeforeMatching.includes(r))){e=t;break}}else if(t.startsWith("matchRight"))for(let t=r;t<n.length;t++){const r=n[t];if((!c.trimBeforeMatching||c.trimBeforeMatching&&r.trim())&&(!c.trimCharsBeforeMatching||!c.trimCharsBeforeMatching.length||!c.trimCharsBeforeMatching.includes(r))){e=t;break}}if(void 0===e)return!1;const i=n[e],a=e+1;let s="";return a&&a>0&&(s=n.slice(0,a)),"L"===t[5]?c.cb(i,s,e):(e&&e>0&&(s=n.slice(e)),c.cb(i,s,e))}let e="";throw h||(e=" More so, the whole options object, the fourth input argument, is missing!"),new Error(`string-match-left-right/${t}(): [THROW_ID_08] the third argument, "whatToMatch", was given as an empty string. This means, you intend to match purely by a callback. The callback was not set though, the opts key "cb" is not set!${e}`)}for(let e=0,r=u.length;e<r;e++){l="function"==typeof u[e];const r=u[e];let i,s,h="",f=o;"matchRight"===t?f+=1:"matchLeft"===t&&(f-=1);const g=a(n,f,r,c,l,(e=>"L"===t[5]?e-1:e+1));if(g&&l&&"function"==typeof r&&"EOL"===r())return!(!r()||c.cb&&!c.cb(i,h,s))&&r();if(Number.isInteger(g)&&(s=t.startsWith("matchLeft")?g-1:g+1,h="L"===t[5]?n.slice(0,g):n.slice(s)),s<0&&(s=void 0),n[s]&&(i=n[s]),Number.isInteger(g)&&(!c.cb||c.cb(i,h,s)))return r}return!1}t.matchLeft=function(t,e,r,i){return o("matchLeft",t,e,r,i)},t.matchLeftIncl=function(t,e,r,i){return o("matchLeftIncl",t,e,r,i)},t.matchRight=function(t,e,r,i){return o("matchRight",t,e,r,i)},t.matchRightIncl=function(t,e,r,i){return o("matchRightIncl",t,e,r,i)},Object.defineProperty(t,"__esModule",{value:!0})}));
+ */

package/examples/_quickTake.js

@@ -1,6 +1,7 @@
 // Quick Take
 
 import { strict as assert } from "assert";
+
 import {
   matchLeftIncl,
   matchRightIncl,

package/examples/cb.js

@@ -1,6 +1,8 @@
+/* eslint-disable no-unused-vars */
 // The Callback Use
 
 import { strict as assert } from "assert";
+
 import {
   matchLeftIncl,
   matchRightIncl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "string-match-left-right",
-  "version": "8.0.4",
+  "version": "8.0.10",
   "description": "Match substrings on the left or right of a given index, ignoring whitespace",
   "keywords": [
     "left",
@@ -31,98 +31,42 @@
   },
   "types": "types/index.d.ts",
   "scripts": {
-    "build": "rollup -c",
-    "ci_test": "npm run build && npm run format && tap --no-only --reporter=silent --output-file=testStats.md && npm run clean_cov",
-    "clean_cov": "../../scripts/leaveCoverageTotalOnly.js",
-    "clean_types": "../../scripts/cleanTypes.js",
-    "dev": "rollup -c --dev",
-    "devunittest": "npm run dev && tap --only -R 'base'",
-    "esbuild": "node '../../scripts/esbuild.js'",
-    "esbuild_dev": "cross-env MODE=dev node '../../scripts/esbuild.js'",
-    "format": "npm run lect && npm run prettier && npm run lint",
-    "lect": "lect",
-    "lint": "../../node_modules/eslint/bin/eslint.js . --ext .js --ext .ts --fix --config \"../../.eslintrc.json\" --quiet",
-    "perf": "node perf/check",
-    "prettier": "../../node_modules/prettier/bin-prettier.js '*.{js,css,scss,vue,md,ts}' --write --loglevel silent",
-    "republish": "npm publish || :",
-    "tap": "tap",
-    "pretest": "npm run build",
-    "test": "npm run lint && npm run unittest && npm run test:examples && npm run clean_cov && npm run format",
-    "test:examples": "../../scripts/test-examples.js && npm run lect && npm run prettier",
-    "tsc": "tsc",
-    "unittest": "tap --no-only --output-file=testStats.md --reporter=terse && tsc -p tsconfig.json --noEmit && npm run clean_cov && npm run perf"
+    "build": "node '../../ops/scripts/esbuild.js' && yarn run dts",
+    "dev": "DEV=true node '../../ops/scripts/esbuild.js' && yarn run dts",
+    "dts": "rollup -c",
+    "examples": "node '../../ops/scripts/run-examples.js'",
+    "lect": "node '../../ops/lect/lect.js'",
+    "letspublish": "yarn publish || :",
+    "lint": "eslint . --fix",
+    "perf": "node perf/check.js",
+    "prepare": "echo 'ready'",
+    "pretest": "yarn run lect && yarn run build",
+    "test": "c8 yarn run unit && yarn run examples && yarn run lint",
+    "unit": "uvu test"
   },
-  "tap": {
-    "check-coverage": false,
-    "coverage-report": [
-      "json-summary",
-      "text"
-    ],
-    "node-arg": [
-      "--no-warnings",
-      "--experimental-loader",
-      "@istanbuljs/esm-loader-hook"
+  "engines": {
+    "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+  },
+  "c8": {
+    "check-coverage": true,
+    "exclude": [
+      "**/test/**/*.*"
     ],
-    "timeout": 0
+    "lines": 100
   },
   "lect": {
     "licence": {
       "extras": [
         ""
       ]
-    },
-    "req": "{ matchLeftIncl, matchRightIncl, matchLeft, matchRight }",
-    "various": {
-      "devDependencies": [
-        "@types/lodash.isplainobject"
-      ]
     }
   },
   "dependencies": {
-    "@babel/runtime": "^7.16.0",
-    "arrayiffy-if-string": "^4.0.4",
+    "arrayiffy-if-string": "^4.0.10",
     "lodash.isplainobject": "^4.0.6",
-    "string-character-is-astral-surrogate": "^2.0.4"
+    "string-character-is-astral-surrogate": "^2.0.10"
   },
   "devDependencies": {
-    "@babel/cli": "^7.16.0",
-    "@babel/core": "^7.16.0",
-    "@babel/node": "^7.16.0",
-    "@babel/plugin-external-helpers": "^7.16.0",
-    "@babel/plugin-proposal-class-properties": "^7.16.0",
-    "@babel/plugin-proposal-nullish-coalescing-operator": "^7.16.0",
-    "@babel/plugin-proposal-object-rest-spread": "^7.16.0",
-    "@babel/plugin-proposal-optional-chaining": "^7.16.0",
-    "@babel/plugin-transform-runtime": "^7.16.0",
-    "@babel/preset-env": "^7.16.0",
-    "@babel/preset-typescript": "^7.16.0",
-    "@babel/register": "^7.16.0",
-    "@istanbuljs/esm-loader-hook": "^0.1.2",
-    "@rollup/plugin-babel": "^5.3.0",
-    "@rollup/plugin-commonjs": "^21.0.1",
-    "@rollup/plugin-node-resolve": "^13.0.6",
-    "@rollup/plugin-strip": "^2.1.0",
-    "@rollup/plugin-typescript": "^8.3.0",
-    "@types/lodash.isplainobject": "^4.0.6",
-    "@types/node": "^16.11.6",
-    "@types/tap": "^15.0.5",
-    "@typescript-eslint/eslint-plugin": "^5.3.0",
-    "@typescript-eslint/parser": "^5.3.0",
-    "core-js": "^3.19.1",
-    "cross-env": "^7.0.3",
-    "eslint": "^8.1.0",
-    "lect": "^0.18.4",
-    "rollup": "^2.59.0",
-    "rollup-plugin-ascii": "^0.0.3",
-    "rollup-plugin-banner": "^0.2.1",
-    "rollup-plugin-cleanup": "^3.2.1",
-    "rollup-plugin-dts": "^4.0.0",
-    "rollup-plugin-terser": "^7.0.2",
-    "tap": "^15.0.10",
-    "tslib": "^2.3.1",
-    "typescript": "^4.4.4"
-  },
-  "engines": {
-    "node": ">=12"
+    "@types/lodash.isplainobject": "^4.0.6"
   }
 }

package/examples/api.json

@@ -1 +0,0 @@
-{"_quickTake.js":{"title":"Quick Take","content":"import &#x7B; strict as assert &#x7D; from \"assert\";\nimport &#x7B;\n  matchLeftIncl,\n  matchRightIncl,\n  matchLeft,\n  matchRight,\n&#x7D; from \"string-match-left-right\";\n\n// 3rd character is \"d\" because indexes start from zero.\n// We're checking the string to the left of it, \"bcd\", inclusive of current character (\"d\").\n// This means, \"bcd\" has to end with existing character and the other chars to the left\n// must match exactly:\nassert.equal(matchLeftIncl(\"abcdefghi\", 3, [\"bcd\"]), \"bcd\");\n\n// neither \"ab\" nor \"zz\" are to the left of 3rd index, \"d\":\nassert.equal(matchLeft(\"abcdefghi\", 3, [\"ab\", `zz`]), false);\n\n// \"def\" is to the right of 3rd index (including it), \"d\":\nassert.equal(matchRightIncl(\"abcdefghi\", 3, [\"def\", `zzz`]), \"def\");\n\n// One of values, \"ef\" is exactly to the right of 3rd index, \"d\":\nassert.equal(matchRight(\"abcdefghi\", 3, [\"ef\", `zz`]), \"ef\");"},"cb.js":{"title":"The Callback Use","content":"import &#x7B; strict as assert &#x7D; from \"assert\";\nimport &#x7B;\n  matchLeftIncl,\n  matchRightIncl,\n  matchLeft,\n  matchRight,\n&#x7D; from \"string-match-left-right\";\n\n// imagine you looped the string and wanted to catch where does attribute \"class\" start\n// and end (not to mention to ensure that it's a real attribute, not something ending with this\n// string \"class\").\n// You catch \"=\", an index number 8.\n// This library can check, is \"class\" to the left of it and feed what's to the left of it\n// to your supplied callback function, which happens to be a checker \"is it a space\":\nfunction isSpace(char) &#x7B;\n  return typeof char === \"string\" && char.trim() === \"\";\n&#x7D;\n\nassert.equal(\n  matchLeft('<a class=\"something\">', 8, \"class\", &#x7B; cb: isSpace &#x7D;),\n  \"class\"\n);"}}