ranges-iterate 3.0.6 → 3.0.12

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2010-2021 Roy Revelt and other contributors
+Copyright (c) 2010-2022 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

@@ -26,18 +26,17 @@
 
 ## Install
 
-This package is ESM only: Node 12+ is needed to use it and it must be imported instead of required:
+The latest version is **ESM only**: Node 12+ is needed to use it and it must be `import`ed instead of `require`d. If your project is not on ESM yet and you want to use `require`, use an older version of this program, `2.1.0`.
 
 ```bash
 npm i ranges-iterate
 ```
 
-If you need a legacy version which works with `require`, use version 2.1.0
-
 ## Quick Take
 
 ```js
 import { strict as assert } from "assert";
+
 import { rIterate } from "ranges-iterate";
 
 // Ranges in the following example "punches out" a "hole" from `a` to `g`
@@ -62,7 +61,7 @@ assert.deepEqual(gathered, [
 
 ## Documentation
 
-Please [visit codsen.com](https://codsen.com/os/ranges-iterate/) for a full description of the API and examples.
+Please [visit codsen.com](https://codsen.com/os/ranges-iterate/) for a full description of the API.
 
 ## Contributing
 
@@ -72,6 +71,6 @@ To report bugs or request features or assistance, [raise an issue](https://githu
 
 MIT License
 
-Copyright (c) 2010-2021 Roy Revelt and other contributors
+Copyright (c) 2010-2022 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/ranges-iterate.esm.js

@@ -1,81 +1,10 @@
 /**
  * @name ranges-iterate
  * @fileoverview Iterate a string and any changes within given string index ranges
- * @version 3.0.6
+ * @version 3.0.12
  * @author Roy Revelt, Codsen Ltd
  * @license MIT
  * {@link https://codsen.com/os/ranges-iterate/}
  */
 
-var version$1 = "3.0.6";
-
-const version = version$1;
-function rIterate(str, originalRanges, cb, offset = 0) {
-    if (typeof str !== "string") {
-        throw new TypeError(`ranges-iterate: [THROW_ID_01] Input string must be a string! It was given as ${typeof str}, equal to: ${JSON.stringify(str, null, 0)}`);
-    }
-    else if (!str.length) {
-        throw new TypeError(`ranges-iterate: [THROW_ID_02] Input string must be non-empty!`);
-    }
-    if (originalRanges && !Array.isArray(originalRanges)) {
-        throw new TypeError(`ranges-iterate: [THROW_ID_03] Input ranges must be an array, consisting of zero or more arrays! Currently its type is: ${typeof originalRanges}, equal to: ${JSON.stringify(originalRanges, null, 0)}`);
-    }
-    if (!cb) {
-        throw new TypeError(`ranges-iterate: [THROW_ID_04] You should provide a callback function as third input argument!`);
-    }
-    else if (typeof cb !== "function") {
-        throw new TypeError(`ranges-iterate: [THROW_ID_05] The calllback function (third input argument) must be a function. It was given as: ${typeof cb}, equal to: ${JSON.stringify(cb, null, 0)}`);
-    }
-    if (originalRanges === null || !originalRanges.length) {
-        for (let i = 0; i < str.length; i++) {
-            cb({
-                i,
-                val: str[i],
-            });
-        }
-    }
-    else {
-        const ranges = Array.from(originalRanges);
-        let currentIdx = offset;
-        let finalIdx = offset;
-        if (finalIdx < ranges[0][0]) {
-            for (; finalIdx < ranges[0][0]; finalIdx++, currentIdx++) {
-                if (!str[finalIdx]) {
-                    break;
-                }
-                cb({
-                    i: finalIdx,
-                    val: str[finalIdx],
-                });
-            }
-        }
-        if (ranges[0][0] <= currentIdx) {
-            ranges.forEach((rangeArr, rangeArrIdx) => {
-                if (rangeArr[2]) {
-                    for (let y = 0, len = rangeArr[2].length; y < len; y++) {
-                        cb({
-                            i: finalIdx,
-                            val: rangeArr[2][y],
-                        });
-                        finalIdx += 1;
-                    }
-                }
-                while (currentIdx < rangeArr[1]) {
-                    currentIdx += 1;
-                }
-                let loopUntil = str.length;
-                if (ranges[rangeArrIdx + 1]) {
-                    loopUntil = ranges[rangeArrIdx + 1][0];
-                }
-                for (; currentIdx < loopUntil; finalIdx++, currentIdx++) {
-                    cb({
-                        i: finalIdx,
-                        val: str[currentIdx],
-                    });
-                }
-            });
-        }
-    }
-}
-
-export { rIterate, version };
+var c="3.0.12";var f=c;function b(r,o,n,a=0){if(typeof r!="string")throw new TypeError(`ranges-iterate: [THROW_ID_01] Input string must be a string! It was given as ${typeof r}, equal to: ${JSON.stringify(r,null,0)}`);if(!r.length)throw new TypeError("ranges-iterate: [THROW_ID_02] Input string must be non-empty!");if(o&&!Array.isArray(o))throw new TypeError(`ranges-iterate: [THROW_ID_03] Input ranges must be an array, consisting of zero or more arrays! Currently its type is: ${typeof o}, equal to: ${JSON.stringify(o,null,0)}`);if(n){if(typeof n!="function")throw new TypeError(`ranges-iterate: [THROW_ID_05] The calllback function (third input argument) must be a function. It was given as: ${typeof n}, equal to: ${JSON.stringify(n,null,0)}`)}else throw new TypeError("ranges-iterate: [THROW_ID_04] You should provide a callback function as third input argument!");if(o===null||!o.length)for(let e=0;e<r.length;e++)n({i:e,val:r[e]});else{let e=Array.from(o),i=a,t=a;if(t<e[0][0])for(;t<e[0][0]&&r[t];t++,i++)n({i:t,val:r[t]});e[0][0]<=i&&e.forEach((s,u)=>{if(s[2])for(let l=0,p=s[2].length;l<p;l++)n({i:t,val:s[2][l]}),t+=1;for(;i<s[1];)i+=1;let $=r.length;for(e[u+1]&&($=e[u+1][0]);i<$;t++,i++)n({i:t,val:r[i]})})}}export{b as rIterate,f as version};

package/dist/ranges-iterate.umd.js

@@ -1,10 +1,10 @@
 /**
  * @name ranges-iterate
  * @fileoverview Iterate a string and any changes within given string index ranges
- * @version 3.0.6
+ * @version 3.0.12
  * @author Roy Revelt, Codsen Ltd
  * @license MIT
  * {@link https://codsen.com/os/ranges-iterate/}
  */
 
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).rangesIterate={})}(this,(function(e){"use strict";e.rIterate=function(e,t,r,n=0){if("string"!=typeof e)throw new TypeError(`ranges-iterate: [THROW_ID_01] Input string must be a string! It was given as ${typeof e}, equal to: ${JSON.stringify(e,null,0)}`);if(!e.length)throw new TypeError("ranges-iterate: [THROW_ID_02] Input string must be non-empty!");if(t&&!Array.isArray(t))throw new TypeError(`ranges-iterate: [THROW_ID_03] Input ranges must be an array, consisting of zero or more arrays! Currently its type is: ${typeof t}, equal to: ${JSON.stringify(t,null,0)}`);if(!r)throw new TypeError("ranges-iterate: [THROW_ID_04] You should provide a callback function as third input argument!");if("function"!=typeof r)throw new TypeError(`ranges-iterate: [THROW_ID_05] The calllback function (third input argument) must be a function. It was given as: ${typeof r}, equal to: ${JSON.stringify(r,null,0)}`);if(null!==t&&t.length){const i=Array.from(t);let o=n,a=n;if(a<i[0][0])for(;a<i[0][0]&&e[a];a++,o++)r({i:a,val:e[a]});i[0][0]<=o&&i.forEach(((t,n)=>{if(t[2])for(let e=0,n=t[2].length;e<n;e++)r({i:a,val:t[2][e]}),a+=1;for(;o<t[1];)o+=1;let f=e.length;for(i[n+1]&&(f=i[n+1][0]);o<f;a++,o++)r({i:a,val:e[o]})}))}else for(let t=0;t<e.length;t++)r({i:t,val:e[t]})},e.version="3.0.6",Object.defineProperty(e,"__esModule",{value:!0})}));
+var rangesIterate=(()=>{var u=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var b=e=>u(e,"__esModule",{value:!0});var y=(e,r)=>{for(var t in r)u(e,t,{get:r[t],enumerable:!0})},x=(e,r,t,s)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of g(r))!f.call(e,n)&&(t||n!=="default")&&u(e,n,{get:()=>r[n],enumerable:!(s=m(r,n))||s.enumerable});return e};var I=(e=>(r,t)=>e&&e.get(r)||(t=x(b({}),r,1),e&&e.set(r,t),t))(typeof WeakMap!="undefined"?new WeakMap:0);var D={};y(D,{rIterate:()=>v,version:()=>E});var p="3.0.12";var E=p;function v(e,r,t,s=0){if(typeof e!="string")throw new TypeError(`ranges-iterate: [THROW_ID_01] Input string must be a string! It was given as ${typeof e}, equal to: ${JSON.stringify(e,null,0)}`);if(!e.length)throw new TypeError("ranges-iterate: [THROW_ID_02] Input string must be non-empty!");if(r&&!Array.isArray(r))throw new TypeError(`ranges-iterate: [THROW_ID_03] Input ranges must be an array, consisting of zero or more arrays! Currently its type is: ${typeof r}, equal to: ${JSON.stringify(r,null,0)}`);if(t){if(typeof t!="function")throw new TypeError(`ranges-iterate: [THROW_ID_05] The calllback function (third input argument) must be a function. It was given as: ${typeof t}, equal to: ${JSON.stringify(t,null,0)}`)}else throw new TypeError("ranges-iterate: [THROW_ID_04] You should provide a callback function as third input argument!");if(r===null||!r.length)for(let n=0;n<e.length;n++)t({i:n,val:e[n]});else{let n=Array.from(r),i=s,o=s;if(o<n[0][0])for(;o<n[0][0]&&e[o];o++,i++)t({i:o,val:e[o]});n[0][0]<=i&&n.forEach((l,$)=>{if(l[2])for(let a=0,d=l[2].length;a<d;a++)t({i:o,val:l[2][a]}),o+=1;for(;i<l[1];)i+=1;let c=e.length;for(n[$+1]&&(c=n[$+1][0]);i<c;o++,i++)t({i:o,val:e[i]})})}}return I(D);})();

package/examples/_quickTake.js

@@ -1,6 +1,7 @@
 // Quick Take
 
 import { strict as assert } from "assert";
+
 import { rIterate } from "../dist/ranges-iterate.esm.js";
 
 // Ranges in the following example "punches out" a "hole" from `a` to `g`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ranges-iterate",
-  "version": "3.0.6",
+  "version": "3.0.12",
   "description": "Iterate a string and any changes within given string index ranges",
   "keywords": [
     "array",
@@ -33,94 +33,41 @@
   },
   "types": "types/index.d.ts",
   "scripts": {
-    "build": "rollup -c",
-    "build:esbuild": "node '../../scripts/esbuild.js'",
-    "build:esbuild:dev": "cross-env MODE=dev node '../../scripts/esbuild.js'",
-    "ci_test": "npm run build && npm run format && tap --no-only --reporter=silent",
-    "clean_types": "../../scripts/cleanTypes.js",
-    "dev": "rollup -c --dev",
-    "devunittest": "npm run dev && tap --only -R 'base'",
-    "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 test:ci && npm run perf",
-    "test:ci": "npm run unittest && npm run test:examples && npm run format",
-    "test:examples": "../../scripts/test-examples.js && npm run lect && npm run prettier",
-    "tsc": "tsc",
-    "unittest": "tap --no-only --reporter=terse && tsc -p tsconfig.json --noEmit"
+    "build": "node '../../ops/scripts/esbuild.js' && yarn run dts",
+    "dev": "DEV=true node '../../ops/scripts/esbuild.js' && yarn run dts",
+    "devtest": "c8 yarn run unit && yarn run examples && yarn run lint",
+    "dts": "rollup -c && yarn run prettier 'types/index.d.ts' --write",
+    "examples": "node '../../ops/scripts/run-examples.js'",
+    "lect": "node '../../ops/lect/lect.js' && yarn run prettier 'README.md' '.all-contributorsrc' 'rollup.config.js' --write",
+    "letspublish": "yarn publish || :",
+    "lint": "eslint . --fix",
+    "perf": "node perf/check.js",
+    "prepare": "echo 'ready'",
+    "prettier": "prettier",
+    "prettier:format": "prettier --write '**/*.{ts,tsx,md}' --no-error-on-unmatched-pattern",
+    "pretest": "yarn run lect && yarn run build",
+    "test": "yarn run devtest",
+    "unit": "uvu test"
   },
-  "tap": {
-    "check-coverage": false,
-    "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": "{ rIterate }",
-    "various": {
-      "devDependencies": [
-        "ranges-apply",
-        "ranges-merge"
-      ]
     }
   },
-  "dependencies": {
-    "@babel/runtime": "^7.16.3"
-  },
   "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.4",
-    "@babel/preset-env": "^7.16.4",
-    "@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-json": "^4.1.0",
-    "@rollup/plugin-node-resolve": "^13.0.6",
-    "@rollup/plugin-strip": "^2.1.0",
-    "@rollup/plugin-typescript": "^8.3.0",
-    "@types/node": "^16.11.9",
-    "@types/tap": "^15.0.5",
-    "@typescript-eslint/eslint-plugin": "^5.4.0",
-    "@typescript-eslint/parser": "^5.4.0",
-    "core-js": "^3.19.1",
-    "cross-env": "^7.0.3",
-    "eslint": "^8.3.0",
-    "lect": "^0.18.6",
-    "ranges-apply": "^6.0.6",
-    "ranges-merge": "^8.0.6",
-    "rollup": "^2.60.0",
-    "rollup-plugin-ascii": "^0.0.3",
-    "rollup-plugin-banner": "^0.2.1",
-    "rollup-plugin-cleanup": "^3.2.1",
-    "rollup-plugin-dts": "^4.0.1",
-    "rollup-plugin-terser": "^7.0.2",
-    "tap": "^15.1.2",
-    "tslib": "^2.3.1",
-    "typescript": "^4.5.2"
-  },
-  "engines": {
-    "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+    "ranges-apply": "^6.0.12",
+    "ranges-merge": "^8.0.12"
   }
 }

package/types/index.d.ts

@@ -1,12 +1,19 @@
-declare type Range = [from: number, to: number] | [from: number, to: number, whatToInsert: string | null | undefined];
+declare type Range =
+  | [from: number, to: number]
+  | [from: number, to: number, whatToInsert: string | null | undefined];
 declare type Ranges = Range[] | null;
 
 declare const version: string;
 interface Obj {
-    i: number;
-    val: any;
+  i: number;
+  val: any;
 }
 declare type Callback = (obj: Obj) => void;
-declare function rIterate(str: string, originalRanges: Ranges, cb: Callback, offset?: number): void;
+declare function rIterate(
+  str: string,
+  originalRanges: Ranges,
+  cb: Callback,
+  offset?: number
+): void;
 
 export { rIterate, version };

package/examples/api.json

@@ -1 +0,0 @@
-{"_quickTake.js":{"title":"Quick Take","content":"import { strict as assert } from \"assert\";\nimport { rIterate } from \"ranges-iterate\";\n\n// Ranges in the following example \"punches out\" a \"hole\" from `a` to `g`\n// (included), replacing it with `xyz`. That's what gets iterated.\n\nconst gathered = [];\n\n// a callback-based interface:\nrIterate(\"abcdefghij\", [[0, 7, \"xyz\"]], ({ i, val }) => {\n  gathered.push(`i = ${i}; val = ${val}`);\n});\n\nassert.deepEqual(gathered, [\n  \"i = 0; val = x\",\n  \"i = 1; val = y\",\n  \"i = 2; val = z\",\n  \"i = 3; val = h\",\n  \"i = 4; val = i\",\n  \"i = 5; val = j\",\n]);"}}