performance-helpers 1.0.0 → 1.0.1

package/scripts/find-missing-jsdoc.js

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-import fs from 'fs';
-import path from 'path';
-import url from 'url';
-
-const __dirname = path.dirname(url.fileURLToPath(import.meta.url));
-
-function walk(dir, files = []) {
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) walk(full, files);
-    else if (entry.isFile() && full.endsWith('.js')) files.push(full);
-  }
-  return files;
-}
-
-function isReexport(line) {
-  return /\bfrom\b/.test(line) || /^\s*export\s*{/.test(line);
-}
-
-function isExportDecl(line) {
-  // matches export default class/function, export class, export function, export const/let/var
-  return (
-    /^\s*export\s+(?:default\s+)?(?:async\s+)?(?:class|function)\b/.test(line) ||
-    /^\s*export\s+(?:const|let|var)\s+[A-Za-z_$][\w$]*/.test(line) ||
-    /^\s*export\s+default\s*(?:\(|[A-Za-z_$])/.test(line)
-  );
-}
-
-function hasJSDocBefore(lines, idx) {
-  let j = idx - 1;
-  while (j >= 0) {
-    const t = lines[j].trim();
-    if (t === '') {
-      j--;
-      continue;
-    }
-    return t.startsWith('/**');
-  }
-  return false;
-}
-
-const root = path.join(__dirname, '..', 'src');
-const files = walk(root);
-const findings = [];
-for (const file of files) {
-  const src = fs.readFileSync(file, 'utf8');
-  const lines = src.split(/\r?\n/);
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    if (!/\bexport\b/.test(line)) continue;
-    if (isReexport(line)) continue;
-    if (!isExportDecl(line)) continue;
-    if (!hasJSDocBefore(lines, i)) {
-      findings.push({ file: path.relative(process.cwd(), file), line: i + 1, code: line.trim() });
-    }
-  }
-}
-
-console.log(JSON.stringify(findings, null, 2));
-if (findings.length === 0) process.exit(0);
-process.exit(1);

package/scripts/modernize-optional-chaining.cjs

@@ -1,36 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-
-function walk(dir, list = []) {
-  for (const e of fs.readdirSync(dir)) {
-    const p = path.join(dir, e);
-    let st;
-    try {
-      st = fs.statSync(p);
-    } catch (err) {
-      continue;
-    }
-    if (st.isDirectory()) walk(p, list);
-    else if (p.endsWith('.js')) list.push(p);
-  }
-  return list;
-}
-
-const files = walk('src');
-
-const propRegex = /([A-Za-z_$][\w$\.]*)\s*&&\s*\1\./g;
-const callRegex = /([A-Za-z_$][\w$\.]*)\s*&&\s*\1\s*\(/g;
-const typeofRegex = /([A-Za-z_$][\w$\.]*)\s*&&\s*typeof\s+\1\./g;
-
-files.forEach(f => {
-  try {
-    let s = fs.readFileSync(f, 'utf8');
-    let t = s.replace(propRegex, '$1?.').replace(callRegex, '$1?.(').replace(typeofRegex, 'typeof $1?.');
-    if (t !== s) {
-      fs.writeFileSync(f, t, 'utf8');
-      console.log('patched', f);
-    }
-  } catch (e) {
-    console.error('error processing', f, e && e.message);
-  }
-});

package/scripts/pool-debug.mjs

@@ -1,29 +0,0 @@
-import { PowerPool } from '../src/helpers/powerPool.js';
-import { o2u8 } from '../src/helpers/powerBuffer.js';
-import { Worker as NodeWorker } from 'worker_threads';
-globalThis.Worker = NodeWorker;
-import { performance } from 'perf_hooks';
-
-async function run() {
-  const pool = new PowerPool('./bench/worker.js', {
-    size: 1,
-    minSize: 1,
-    maxSize: 1,
-    idleTimeout: 10000,
-    taskQueue: true,
-    workerOptions: { type: 'module' },
-  });
-  const payload = o2u8({ iterations: 1000000 });
-  const p0 = pool.postMessage(payload, [payload.buffer]);
-  console.log('after first dispatch, tasks=', pool.workers[0]?.tasks, 'queue=', pool.queue.length);
-  const payload2 = o2u8({ iterations: 1000000 });
-  const p1 = pool.postMessage(payload2, [payload2.buffer]);
-  console.log('after second dispatch, tasks=', pool.workers[0]?.tasks, 'queue=', pool.queue.length);
-  await pool.drain();
-  console.log('final tasks=', pool.workers[0]?.tasks, 'queue=', pool.queue.length);
-  pool.terminate();
-}
-run().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/scripts/repro_powercache.js

@@ -1,14 +0,0 @@
-import { PowerCache } from '../src/helpers/powerCache.js';
-
-(async () => {
-  const c = new PowerCache({ defaultTTL: 1, maxEntries: 10 });
-  c.set('a', 1, { ttl: 1 });
-  await new Promise((r) => setTimeout(r, 5));
-  console.log('peek:', c.peek('a'));
-  console.log('map has a before has(ignoreExpiry):', c.map.has('a'));
-  console.log('has(ignoreExpiry):', c.has('a', { ignoreExpiry: true }));
-  console.log('map has a after has(ignoreExpiry):', c.map.has('a'));
-  console.log('has():', c.has('a'));
-  console.log('delete:', c.delete('a'));
-  console.log('map has a after delete:', c.map.has('a'));
-})();

package/scripts/static-audit-exports.cjs

@@ -1,93 +0,0 @@
-#!/usr/bin/env node
-const fs = require('fs');
-const path = require('path');
-
-const root = process.cwd();
-const srcHelpers = path.join(root, 'src');
-
-function listJsFiles(dir) {
-  const out = [];
-  for (const name of fs.readdirSync(dir)) {
-    const p = path.join(dir, name);
-    const st = fs.statSync(p);
-    if (st.isDirectory()) {
-      out.push(...listJsFiles(p));
-    } else if (st.isFile() && p.endsWith('.js')) {
-      out.push(p);
-    }
-  }
-  return out;
-}
-
-function listAllJsFiles(dir) {
-  const out = [];
-  const entries = fs.readdirSync(dir);
-  for (const name of entries) {
-    const p = path.join(dir, name);
-    let st;
-    try { st = fs.statSync(p); } catch (e) { continue; }
-    if (st.isDirectory()) {
-      if (name === 'node_modules' || name === 'coverage' || name === '.git') continue;
-      out.push(...listAllJsFiles(p));
-    } else if (st.isFile() && p.endsWith('.js')) out.push(p);
-  }
-  return out;
-}
-
-function extractExports(content) {
-  const symbols = [];
-  const classRx = /export\s+class\s+([A-Za-z_$][A-Za-z0-9_$]*)/g;
-  const fnRx = /export\s+function\s+([A-Za-z_$][A-Za-z0-9_$]*)/g;
-  const varRx = /export\s+(?:const|let|var)\s+([A-Za-z_$][A-Za-z0-9_$]*)/g;
-  const defaultRx = /export\s+default\s+([A-Za-z_$][A-Za-z0-9_$]*)/g;
-  const namedRx = /export\s*\{([^}]+)\}/g;
-
-  let m;
-  while ((m = classRx.exec(content))) symbols.push(m[1]);
-  while ((m = fnRx.exec(content))) symbols.push(m[1]);
-  while ((m = varRx.exec(content))) symbols.push(m[1]);
-  while ((m = defaultRx.exec(content))) symbols.push(m[1]);
-  while ((m = namedRx.exec(content))) {
-    const list = m[1].split(',').map(s => s.trim().split(/\s+as\s+/)[0].trim()).filter(Boolean);
-    for (const s of list) symbols.push(s);
-  }
-  return Array.from(new Set(symbols));
-}
-
-function readFileSafe(p) {
-  try { return fs.readFileSync(p, 'utf8'); } catch (e) { return null; }
-}
-
-const helperFiles = listJsFiles(srcHelpers);
-const allJsFiles = listAllJsFiles(root);
-
-const report = [];
-const symbolMap = {};
-
-for (const file of helperFiles) {
-  const content = readFileSafe(file);
-  if (!content) continue;
-  const exports = extractExports(content);
-  for (const sym of exports) {
-    if (!symbolMap[sym]) symbolMap[sym] = { def: file, refs: new Set() };
-    else symbolMap[sym].def = symbolMap[sym].def || file;
-  }
-}
-
-for (const [sym, info] of Object.entries(symbolMap)) {
-  const rx = new RegExp('\\b' + sym + '\\b', 'g');
-  for (const file of allJsFiles) {
-    const c = readFileSafe(file);
-    if (!c) continue;
-    if (file === info.def) continue; // skip declaration file
-    if (rx.test(c)) info.refs.add(file);
-  }
-}
-
-for (const [sym, info] of Object.entries(symbolMap)) {
-  report.push({ symbol: sym, definedIn: path.relative(root, info.def), referencedIn: Array.from(info.refs).map(f => path.relative(root, f)) });
-}
-
-const out = { generatedAt: new Date().toISOString(), report };
-fs.writeFileSync(path.join('scripts','static-audit-exports.json'), JSON.stringify(out, null, 2));
-console.log(JSON.stringify(out, null, 2));