pattern-collector-anyjs 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KeshavSoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# pattern-collector 🔍
+
+> **A high-performance pattern collector and ESM import statement analyzer for JavaScript.**
+
+[![npm version](https://img.shields.io/npm/v/pattern-collector.svg?style=flat-square&color=38bdf8)](https://www.npmjs.com/package/pattern-collector)
+[![license](https://img.shields.io/npm/l/pattern-collector.svg?style=flat-square&color=34d399)](LICENSE)
+
+🔗 **Quick Links:**
+*   📦 **NPM Registry**: [npmjs.com/package/pattern-collector](https://www.npmjs.com/package/pattern-collector)
+*   💻 **GitHub Repo**: [github.com/keshavsoft/pattern-collector](https://github.com/keshavsoft/pattern-collector)
+*   📄 **Interactive Docs**: [keshavsoft.github.io/pattern-collector](https://keshavsoft.github.io/pattern-collector/)
+*   ⚙️ **Publish Workflow**: [.github/workflows/npm-publish.yml](file:///d:/KeshavSoftRepos/2026-07-18/ks6/pattern-collector/.github/workflows/npm-publish.yml)
+
+---
+
+## 📖 Overview
+
+`pattern-collector` is a zero-dependency, lightweight JavaScript library designed to scan file content and collect substrings that match a specified pattern or regular expression. 
+
+It serves as a fast and flexible engine, enabling easy parsing, extraction, and static analysis of source files (such as locating ES Module imports, decorators, function declarations, or other syntactic patterns).
+
+---
+
+## ✨ Features
+
+*   **⚡ Zero Dependencies**: Light, fast, and secure.
+*   **🧩 Flexible Matching**: Collects any patterns by accepting custom global Regular Expressions.
+*   **📦 ESM Native**: Built for modern ES module environments.
+*   **🏷️ Versioned Under the Hood**: Uses an extensible directory-based versioned core.
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install pattern-collector
+```
+
+---
+
+## 🛠️ API Reference
+
+### `default(options)`
+
+The default export is a function that collects all occurrences of a pattern in the given text.
+
+#### Parameters
+
+An options object containing:
+
+*   **`fileContent`** `(string)`: The raw text or code content to search.
+*   **`searchString`** `(RegExp)`: A regular expression with the global (`g`) flag to match patterns in the content.
+
+#### Returns
+
+*   `(string[])`: An array of matches found. If no matches are found, it returns an empty array.
+
+---
+
+## 💻 Usage Example
+
+```javascript
+import patternCollector from 'pattern-collector';
+
+const code = `
+import { exec } from "child_process";
+import dotenv from 'dotenv';
+import express from "express";
+
+const PORT = 3000;
+`;
+
+// Extract all import statements
+const imports = patternCollector({
+  fileContent: code,
+  searchString: /import\s+[\s\S]*?\s+from\s+['"][^'"]+['"]/g
+});
+
+console.log(imports);
+/*
+Output:
+[
+  'import { exec } from "child_process"',
+  "import dotenv from 'dotenv'",
+  'import express from "express"'
+]
+*/
+```
+
+---
+
+## ⚖️ License
+
+MIT License. Designed with ❤️ by [KeshavSoft](https://github.com/keshavsoft).

package/bin/core/getLatestVersion.js

@@ -0,0 +1,13 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default function getLatestVersion() {
+    const versions = fs.readdirSync(path.join(__dirname, ".."))
+        .filter(n => /^v\d+$/.test(n))
+        .sort((a, b) => parseInt(a.slice(1)) - parseInt(b.slice(1)));
+
+    return versions.at(-1);
+};

package/bin/v1/index.js

@@ -0,0 +1,31 @@
+import fs from 'fs';
+import path from 'path';
+
+import pullImportLines from "pattern-collector-routesjs-pull-lines";
+import buildStory from "pattern-collector-routesjs-build-story";
+
+const parseRegex = /import\s*\{[^}]*router\s+as\s+(\w+)[^}]*\}\s*from\s*['"]\.\/([^/]+)\/.*['"]/;
+
+const startFunc = ({ inFilePath, inShowLog, showLogStep1, showLogStep2 }) => {
+    const filePath = path.join(inFilePath, "routes.js");
+
+    const fileContent = fs.readFileSync(filePath, 'utf8');
+
+    const { importLines, useLines } = pullImportLines({
+        fileContent,
+        parseRegex,
+        showLog: showLogStep1,
+        showLogStep1: showLogStep2
+    });
+
+    if (inShowLog) console.log("pullImportLines : ", importLines, useLines);
+
+    const story = buildStory({ importLines, useLines });
+
+    if (inShowLog) console.log("story : ", story);
+    // console.log("aaaaaaaa : ", JSON.stringify(story, null, 4));
+
+    return story;
+};
+
+export default startFunc;

package/bin/v2/index.js

@@ -0,0 +1,23 @@
+import pullImportLines from "pattern-collector-routesjs-pull-lines";
+import buildStory from "pattern-collector-routesjs-build-story";
+
+const startFunc = ({ fileContent, parseRegex,
+    inShowLog, showLogStep1, showLogStep2 }) => {
+
+    const { importLines, useLines } = pullImportLines({
+        fileContent,
+        parseRegex,
+        showLog: showLogStep1,
+        showLogStep1: showLogStep2
+    });
+
+    if (inShowLog) console.log("pullImportLines : ", importLines, useLines);
+
+    const story = buildStory({ importLines, useLines });
+
+    if (inShowLog) console.log("story : ", story);
+
+    return story;
+};
+
+export default startFunc;

package/index.js

@@ -0,0 +1,18 @@
+import { createRequire } from "module";
+import getLatestVersion from "./bin/core/getLatestVersion.js";
+
+const require = createRequire(import.meta.url);
+
+const v = getLatestVersion();
+const latestModule = require(`./bin/${v}/index.js`);
+
+const load = ({ fileContent, parseRegex,
+    inShowLog, showLogStep1, showLogStep2 }) => {
+
+    return latestModule.default({
+        fileContent, parseRegex,
+        inShowLog, showLogStep1, showLogStep2
+    });
+};
+
+export default load;

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "pattern-collector-anyjs",
+  "version": "1.2.1",
+  "description": "A high-performance pattern collector and ESM import statement analyzer.",
+  "keywords": [
+    "pattern",
+    "regex",
+    "parser",
+    "import",
+    "analyzer",
+    "esm",
+    "extractor"
+  ],
+  "dependencies": {
+    "pattern-collector-routesjs-pull-lines": "^1.7.1",
+    "pattern-collector-routesjs-build-story": "^1.4.1"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "bin/",
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "homepage": "https://github.com/keshavsoft/pattern-collector-anyjs#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/keshavsoft/pattern-collector-anyjs"
+  },
+  "bugs": {
+    "url": "https://github.com/keshavsoft/pattern-collector-anyjs/issues"
+  }
+}