@vacantthinker/firefox-addon-framework-easy 2026.611.821 → 2026.611.1153

package/dist/serviceOpContent.js

@@ -0,0 +1,69 @@
+import { browserRuntimePlatformInfo } from './browserRuntime';
+import { generateMkvScriptForSystemFedora, generateMkvScriptForSystemWindows, } from './generate';
+/**
+ * Maps file extensions to MIME types.
+ */
+const EXT_MIME_MAP = {
+    txt: 'text/plain',
+    json: 'application/json',
+    js: 'application/javascript',
+    sh: 'application/x-sh',
+};
+/**
+ * Copies text content to the system clipboard.
+ */
+export async function serviceCopyContentToClipboard(data) {
+    return await window.navigator.clipboard.writeText(data);
+}
+/**
+ * Saves content to a local file.
+ * @param content The content string.
+ * @param filename The base filename.
+ * @param ext The file extension.
+ */
+export function serviceSaveContentToLocal(content, filename, ext = 'txt') {
+    const mimeType = EXT_MIME_MAP[ext] || 'text/plain';
+    const blob = new Blob([content], { type: mimeType });
+    const url = URL.createObjectURL(blob);
+    const eleA = document.createElement('a');
+    eleA.href = url;
+    eleA.download = `${filename}.${ext}`;
+    // Programmatically trigger download
+    eleA.click();
+    // Cleanup
+    URL.revokeObjectURL(url);
+}
+/**
+ * Generates an MKVToolNix script based on the current OS.
+ * @param videoInfo - The object containing vid and videoTitle.
+ */
+export async function serviceGenerateMkvToolNixScript(videoInfo) {
+    const platformInfo = await browserRuntimePlatformInfo();
+    if (platformInfo.os === 'win') {
+        const content = generateMkvScriptForSystemWindows(videoInfo);
+        serviceSaveContentToLocal(content, videoInfo.videoTitle, 'js');
+    }
+    else if (platformInfo.os === 'linux') {
+        const content = generateMkvScriptForSystemFedora(videoInfo);
+        serviceSaveContentToLocal(content, videoInfo.videoTitle, 'sh');
+    }
+}
+/**
+ * Cleans a string to make it a valid filename.
+ * @param value The raw string.
+ * @returns A cleaned filename string.
+ */
+export function serviceRemoveIllegalWord(value) {
+    if (!value)
+        return '';
+    // Get the first line and trim whitespace
+    let name = value.trim().split(/\r?\n/)[0];
+    // Replace punctuation, symbols, and control chars with space
+    name = name.replace(/[\p{P}\p{S}\p{C}]/gu, ' ');
+    // Replace specific legacy forbidden characters
+    name = name.replace(/[~"#%&*:<>?/\\{|}]/g, ' ');
+    // Normalize whitespaces
+    name = name.replace(/[\s\u3000]+/g, ' ').trim();
+    // Remove leading/trailing dots or hyphens
+    return name.replace(/^[-.]+|[-.]+$/g, '');
+}

package/dist/serviceOpJavascript.d.ts

@@ -0,0 +1,41 @@
+interface ScreenRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface ActionMessage {
+    tabId: number;
+    act: string;
+}
+interface MagnetLinkMessage extends ActionMessage {
+    title: string;
+    data?: string[];
+    handleOption?: 'clipboard' | 'txt' | 'clipboardAndTxt';
+}
+/**
+ * Captures a tab's screenshot and triggers a local download in the target tab.
+ */
+export declare function serviceTakeScreenshot({ tabId, filename, rect }: {
+    tabId: number;
+    filename: string;
+    rect: ScreenRect;
+}): Promise<void>;
+/**
+ * Enables an element picker overlay in the target tab.
+ */
+export declare function serviceElementPicker(message: ActionMessage): Promise<void>;
+/**
+ * Gets the bounding rectangle of the full page.
+ */
+export declare function serviceGetFullPageRectData(message: ActionMessage): Promise<void>;
+/**
+ * Scans the page for magnet links.
+ */
+export declare function serviceFindAllMagnetLink(message: MagnetLinkMessage): Promise<void>;
+/**
+ * Handles the processing of collected magnet links (clipboard or file).
+ */
+export declare function serviceDealWithMagnetLink(message: MagnetLinkMessage): Promise<void>;
+export {};
+//# sourceMappingURL=serviceOpJavascript.d.ts.map

package/dist/serviceOpJavascript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceOpJavascript.d.ts","sourceRoot":"","sources":["../src/serviceOpJavascript.ts"],"names":[],"mappings":"AAUA,UAAU,UAAU;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,iBAAkB,SAAQ,aAAa;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,iBAAiB,CAAC;CACxD;AAID;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,EAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAC,EAAE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAA;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAchB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFhF;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAatF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BxF;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBzF"}

package/dist/serviceOpJavascript.js

@@ -0,0 +1,182 @@
+import { serviceGetCurrentDateYYYYMMDDHHMMSS } from './serviceGet';
+import { serviceCopyContentToClipboard, serviceRemoveIllegalWord, serviceSaveContentToLocal, } from './serviceOpContent';
+import { browserNotificationCreate } from './browserNotification';
+// --- Services ---
+/**
+ * Captures a tab's screenshot and triggers a local download in the target tab.
+ */
+export async function serviceTakeScreenshot({ tabId, filename, rect }) {
+    const dataURI = await browser.tabs.captureTab(tabId, { rect });
+    await browser.scripting.executeScript({
+        target: { tabId },
+        args: [{ dataURI, filename }],
+        func: (message) => {
+            const { dataURI, filename } = message;
+            const a = document.createElement('a');
+            a.href = dataURI;
+            a.download = filename;
+            a.click();
+        },
+    });
+}
+/**
+ * Enables an element picker overlay in the target tab.
+ */
+export async function serviceElementPicker(message) {
+    await browser.scripting.executeScript({
+        target: { tabId: message.tabId },
+        args: [message],
+        func: (async (message) => {
+            const overlayId = 'extension-element-highlighter-overlay';
+            let overlay = document.getElementById(overlayId);
+            if (!overlay) {
+                overlay = document.createElement('div');
+                overlay.id = overlayId;
+                overlay.style.cssText = `
+          position: fixed !important; top: 0 !important; left: 0 !important;
+          width: 0 !important; height: 0 !important;
+          background-color: rgba(255, 0, 85, 0.2) !important;
+          outline: 2px dashed #ff0055 !important; outline-offset: -2px !important;
+          z-index: 2147483647 !important; pointer-events: none !important;
+          transition: all 0.05s ease-out !important; display: none !important;
+        `;
+                document.documentElement.appendChild(overlay);
+            }
+            function getUniqueSelector(el) {
+                const path = [];
+                let current = el;
+                while (current && current.nodeType === Node.ELEMENT_NODE) {
+                    let selector = current.nodeName.toLowerCase();
+                    if (current.id) {
+                        selector += `#${current.id}`;
+                        path.unshift(selector);
+                        break;
+                    }
+                    else {
+                        let sib = current, nth = 1;
+                        while ((sib = sib.previousElementSibling) && sib.nodeName.toLowerCase() === selector)
+                            nth++;
+                        if (nth !== 1)
+                            selector += `:nth-of-type(${nth})`;
+                    }
+                    path.unshift(selector);
+                    current = current.parentElement;
+                }
+                return path.join(' > ');
+            }
+            function handleMouseOver(e) {
+                const target = e.target;
+                if (target.id === overlayId || !overlay)
+                    return;
+                const rect = target.getBoundingClientRect();
+                Object.assign(overlay.style, {
+                    display: 'block',
+                    top: `${rect.top}px`, left: `${rect.left}px`,
+                    width: `${rect.width}px`, height: `${rect.height}px`,
+                });
+                document.body.style.setProperty('cursor', 'crosshair', 'important');
+            }
+            async function handleElementClick(e) {
+                e.preventDefault();
+                e.stopPropagation();
+                const target = e.target;
+                stopPickingMode();
+                const clientRect = target.getBoundingClientRect();
+                const rect = {
+                    height: clientRect.height,
+                    width: clientRect.width,
+                    x: clientRect.left + window.scrollX,
+                    y: clientRect.top + window.scrollY,
+                };
+                await browser.runtime.sendMessage({
+                    ...message,
+                    rect,
+                    uniqueSelector: getUniqueSelector(target),
+                });
+            }
+            function stopPickingMode() {
+                document.removeEventListener('mouseover', handleMouseOver, true);
+                document.removeEventListener('click', handleElementClick, true);
+                document.body.style.removeProperty('cursor');
+                overlay?.remove();
+            }
+            document.addEventListener('mouseover', handleMouseOver, true);
+            document.addEventListener('click', handleElementClick, true);
+        }),
+    });
+}
+/**
+ * Gets the bounding rectangle of the full page.
+ */
+export async function serviceGetFullPageRectData(message) {
+    await browser.scripting.executeScript({
+        target: { tabId: message.tabId },
+        args: [message],
+        func: (message) => {
+            const rect = {
+                x: 0, y: 0,
+                width: document.documentElement.scrollWidth,
+                height: document.documentElement.scrollHeight,
+            };
+            browser.runtime.sendMessage({ ...message, rect });
+        },
+    });
+}
+/**
+ * Scans the page for magnet links.
+ */
+export async function serviceFindAllMagnetLink(message) {
+    await browser.scripting.executeScript({
+        target: { tabId: message.tabId },
+        args: [message],
+        func: (async (message) => {
+            const magnets = new Set();
+            // Type 1: Attribute selectors
+            const attrElements = document.querySelectorAll('*[href*="magnet:"], *[data-url*="magnet:"], *[data-magnet*="magnet:"], *[data-href*="magnet:"]');
+            attrElements.forEach(el => {
+                Array.from(el.attributes).forEach(attr => {
+                    if (attr.value.includes('magnet:?xt='))
+                        magnets.add(attr.value.trim());
+                });
+            });
+            // Type 2: Text content
+            document.querySelectorAll('div, span, td, p, a, button').forEach(el => {
+                if (el.children.length === 0) {
+                    const text = el.textContent?.trim() || '';
+                    const match = text.match(/magnet:\?xt=[^\s"'<>]+/);
+                    if (match)
+                        magnets.add(match[0]);
+                }
+            });
+            await browser.runtime.sendMessage({
+                ...message,
+                data: Array.from(magnets),
+            });
+        }),
+    });
+}
+/**
+ * Handles the processing of collected magnet links (clipboard or file).
+ */
+export async function serviceDealWithMagnetLink(message) {
+    const { title, data, handleOption } = message;
+    const titleCleaned = serviceRemoveIllegalWord(title);
+    if (!Array.isArray(data) || data.length === 0) {
+        await browserNotificationCreate('magnet link not found!');
+        return;
+    }
+    const content = `${data.join('\n')}\n`;
+    const filename = ['magnet-link', titleCleaned, serviceGetCurrentDateYYYYMMDDHHMMSS()].join(' ');
+    switch (handleOption) {
+        case 'clipboard':
+            await serviceCopyContentToClipboard(content);
+            break;
+        case 'txt':
+            serviceSaveContentToLocal(content, filename);
+            break;
+        case 'clipboardAndTxt':
+            await serviceCopyContentToClipboard(content);
+            serviceSaveContentToLocal(content, filename);
+            break;
+    }
+}

package/dist/servicePure.d.ts

@@ -0,0 +1,18 @@
+export interface YoutubeVideoInfo {
+    videolink: string;
+    vid: string;
+}
+export interface YoutubePlaylistInfo {
+    playlistVideolink: string;
+    playlistId: string;
+}
+/**
+ * Extracts video ID and creates a clean YouTube URL.
+ * Supports: youtube.com/watch?v=, youtu.be/, and youtube.com/shorts/
+ */
+export declare function servicePureVideolinkYTB(videolinkOrigin: string): YoutubeVideoInfo | null;
+/**
+ * Extracts playlist ID and creates a clean YouTube playlist URL.
+ */
+export declare function servicePurePlaylistVideolinkYTB(videolinkOrigin: string): YoutubePlaylistInfo | null;
+//# sourceMappingURL=servicePure.d.ts.map

package/dist/servicePure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"servicePure.d.ts","sourceRoot":"","sources":["../src/servicePure.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA6BxF;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,eAAe,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAgBnG"}

package/dist/servicePure.js

@@ -0,0 +1,51 @@
+/**
+ * Extracts video ID and creates a clean YouTube URL.
+ * Supports: youtube.com/watch?v=, youtu.be/, and youtube.com/shorts/
+ */
+export function servicePureVideolinkYTB(videolinkOrigin) {
+    if (!videolinkOrigin)
+        return null;
+    try {
+        const url = new URL(videolinkOrigin);
+        let vid = null;
+        // 1. Standard watch URL: youtube.com/watch?v=ID
+        vid = url.searchParams.get('v');
+        // 2. Short URL: youtu.be/ID
+        if (!vid && url.hostname.includes('youtu.be')) {
+            vid = url.pathname.slice(1);
+        }
+        // 3. Shorts URL: youtube.com/shorts/ID
+        if (!vid && url.pathname.startsWith('/shorts/')) {
+            vid = url.pathname.split('/')[2];
+        }
+        if (!vid)
+            return null;
+        return {
+            videolink: `https://www.youtube.com/watch?v=${vid}`,
+            vid,
+        };
+    }
+    catch {
+        return null; // Invalid URL
+    }
+}
+/**
+ * Extracts playlist ID and creates a clean YouTube playlist URL.
+ */
+export function servicePurePlaylistVideolinkYTB(videolinkOrigin) {
+    if (!videolinkOrigin)
+        return null;
+    try {
+        const url = new URL(videolinkOrigin);
+        const playlistId = url.searchParams.get('list');
+        if (!playlistId)
+            return null;
+        return {
+            playlistVideolink: `https://www.youtube.com/playlist?list=${playlistId}`,
+            playlistId,
+        };
+    }
+    catch {
+        return null; // Invalid URL
+    }
+}

package/dist/serviceUpdateTabStyle.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Style management service for browser tabs.
+ */
+/**
+ * Update the text color for all elements globally.
+ */
+export declare function serviceUpdataALLTextNodeColor(tabId: number, color: string): Promise<void>;
+/**
+ * Update the background color for all elements globally.
+ */
+export declare function serviceUpdataALLNodeBackgroundColor(tabId: number, bgColor: string): Promise<void>;
+/**
+ * Adjust font size globally by a delta value.
+ * Uses recursive DOM traversal to support Shadow DOM elements.
+ */
+export declare function serviceIncreaseAllTextFontSize(tabId: number, delta: number): Promise<void>;
+//# sourceMappingURL=serviceUpdateTabStyle.d.ts.map

package/dist/serviceUpdateTabStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceUpdateTabStyle.d.ts","sourceRoot":"","sources":["../src/serviceUpdateTabStyle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/F;AAED;;GAEG;AACH,wBAAsB,mCAAmC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvG;AASD;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkChG"}

package/dist/serviceUpdateTabStyle.js

@@ -0,0 +1,63 @@
+/**
+ * Style management service for browser tabs.
+ */
+/**
+ * Apply a CSS string globally to the target tab.
+ * This is the most efficient way to override styles without traversing the DOM.
+ */
+async function applyGlobalCss(tabId, css) {
+    await browser.scripting.insertCSS({
+        target: { tabId },
+        css: css,
+    });
+}
+/**
+ * Update the text color for all elements globally.
+ */
+export async function serviceUpdataALLTextNodeColor(tabId, color) {
+    // Use "body, body *" to target all elements, with !important to override existing styles.
+    const css = `body, body * { color: ${color} !important; }`;
+    await applyGlobalCss(tabId, css);
+}
+/**
+ * Update the background color for all elements globally.
+ */
+export async function serviceUpdataALLNodeBackgroundColor(tabId, bgColor) {
+    // Apply background-color to all elements.
+    const css = `body, body * { background-color: ${bgColor} !important; }`;
+    await applyGlobalCss(tabId, css);
+}
+/**
+ * Adjust font size globally by a delta value.
+ * Uses recursive DOM traversal to support Shadow DOM elements.
+ */
+export async function serviceIncreaseAllTextFontSize(tabId, delta) {
+    await browser.scripting.executeScript({
+        target: { tabId },
+        args: [{ delta }],
+        func: (({ delta }) => {
+            /**
+             * Recursively traverse DOM and Shadow DOM to update font sizes.
+             */
+            function walk(root) {
+                const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+                let node;
+                while ((node = walker.nextNode())) {
+                    const el = node;
+                    // If the element has a Shadow Root, recurse into it to support web components.
+                    if (el.shadowRoot) {
+                        walk(el.shadowRoot);
+                    }
+                    // Calculate and update font size
+                    const style = window.getComputedStyle(el);
+                    const currentSize = parseFloat(style.fontSize);
+                    if (!isNaN(currentSize)) {
+                        el.style.setProperty('font-size', `${currentSize + delta}px`, 'important');
+                    }
+                }
+            }
+            // Start traversal from the document body
+            walk(document.body);
+        }), // Cast to any to bypass strict type checking for the execution closure
+    });
+}

package/package.json

@@ -1,14 +1,20 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0611.0821",
+  "version": "2026.0611.1153",
   "description": "",
-  "main": "index.js",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "scripts": {
-    "install_package": "npm install"
+    "install_package": "npm install",
+    "build": "tsc"
   },
   "author": "VacantThinker",
   "license": "AGPL-3.0-only",
@@ -20,7 +26,8 @@
   "bugs": {
     "url": "https://github.com/VacantThinker/firefox-addon-framework-easy/issues"
   },
-  "dependencies": {
+  "devDependencies": {
+    "typescript": "6.0.3",
     "@types/firefox-webext-browser": "^143.0.0"
   }
 }

package/.github/workflows/npm-publish.yml

@@ -1,34 +0,0 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
-
-name: Node.js Package
-
-on:
-  push:
-    branches:
-      - main #
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version: 24
-      - run: npm ci
-
-  publish-npm:
-    needs: build
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version: 24
-          registry-url: https://registry.npmjs.org/
-      - run: npm ci
-      - run: npm publish --provenance --access public

package/index.js

@@ -1,17 +0,0 @@
-export * from './src/BaseORM.js'
-export * from './src/browserDownload.js'
-export * from './src/browserNotification.js'
-export * from './src/browserRuntime.js'
-export * from './src/browserRuntimeOnMessageCommon.js'
-export * from './src/browserTab.js'
-export * from './src/DomainORM.js'
-export * from './src/generate.js'
-export * from './src/opStorage.js'
-export * from './src/opTab.js'
-export * from './src/serviceCommon.js'
-export * from './src/serviceFetch.js'
-export * from './src/serviceGet.js'
-export * from './src/serviceOpContent.js'
-export * from './src/serviceOpJavascript.js'
-export * from './src/servicePure.js'
-export * from './src/serviceUpdateTabStyle.js'

package/publish.sh

@@ -1,81 +0,0 @@
-#!/bin/bash
-
-# 1. Get the current time (Format example: 2026.0522.0443)
-# This includes the date, hour, and minute to ensure the version number increments every time you push.
-NEW_VERSION=$(date +'%Y.%m%d.%H%M')
-
-echo "🚀 Starting version update to: $NEW_VERSION"
-
-# 2. Use jq to automatically modify the version field in package.json and write it back
-jq ".version = \"$NEW_VERSION\"" package.json > package.json.tmp && mv package.json.tmp package.json
-
-# 2.5 Automatically scan all js files in the src directory and generate export statements for index.js
-echo "🚀 Dynamically generating index.js exports..."
-true > index.js
-for file in src/*.js; do
-    if [ -f "$file" ]; then
-        echo "export * from './$file'" >> index.js
-    fi
-done
-
-# 2.6 Automatically reset README.md and append the scanned public functions
-echo "📝 Updating README.md..."
-
-# 1. Write the default fixed content
-cat << 'EOF' > README.md
-# firefox-addon-framework-easy
-
-[![License: AGPL v3](https://shields.io)](https://gnu.org)
-
-## License
-
-This project is licensed under the GNU Affero General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
-
-
-## Source Code Access
-
-According to the terms of the AGPL-3.0, the source code for this network service must be made available to all users.
-
-You can download, clone, or view the complete source code for this application here: [Insert your GitHub/GitLab URL].
-
-## API Reference (Auto-Generated)
-
-Below is a list of all public functions found inside the `src` directory:
-
-EOF
-
-# 2. Iterate through all js files, capture multi-line signatures, and append them to README
-for file in src/*.js; do
-    if [ -f "$file" ]; then
-        echo "### 📄 File: \`$file\`" >> README.md
-        echo "\`\`\`javascript" >> README.md
-
-        # Reads multi-line signatures up to the opening brace or semicolon
-        awk '/^export (async )?(function|const|let|var|class) / {
-            line = $0
-            # Keep reading lines if there is no opening brace or semicolon yet
-            while (line !~ /\{/ && line !~ /;/ && (getline next_line) > 0) {
-                line = line "\n" next_line
-            }
-            # Clean up the function body and replace it with standard closing
-            sub(/\{.*/, "{  }", line)
-            print line
-            print ""
-        }' "$file" >> README.md
-
-        echo "\`\`\`" >> README.md
-        echo "" >> README.md
-    fi
-done
-
-# 3. Check if there are any code changes to commit
-git add .
-
-# 4. Automatically commit and log this release version
-git commit -m "chore: bump version to $NEW_VERSION and publish"
-
-# 5. Push to GitHub to trigger cloud-based automated publishing
-echo "📤 Pushing to GitHub..."
-git push origin main
-
-echo "✅ Push complete! Please check the GitHub Actions page to view the deployment status."