npm run build              # تجميع TypeScript إلى dist/
npm run start              # تشغيل أداة الإخفاء (تقرأ input.js)
npm run test               # تشغيل مجموعة الاختبارات
npm run obfuscate-package  # تشغيل اختبارات التوافق مع حزم npm

const { obfuscate } = require('./dist/obfuscator');

const code = 'function add(a, b) { return a + b; }';
const obfuscated = obfuscate(code);

// مع خيارات
const obfuscated = obfuscate(code, { targetTokens: 500000 });

import { runNullCircuitTest } from './verification/nullCircuitTest';
const result = runNullCircuitTest(realCode, paramCount, stmtCount, threshold, targetTokens);
console.log('Similarity:', result.similarity); // 0.0-1.0

import { runAllTests, printSummary } from './verification/unobfuscatableTests';
console.log(printSummary(runAllTests(10000)));

src/
  index.ts              نقطة الدخول لواجهة سطر الأوامر
  obfuscator.ts         المنسق الرئيسي لخط الأنابيب (20 تحويلاً)
  options.ts            نظام الميزانية والخيارات
  types.ts              تعريفات أنواع AST
  random.ts             توليد أسماء Unicode عشوائية (6-16 حرفًا، 16 نطاق كتابة)
  ast.ts                دوال مصنع عقد AST
  keywords.ts           اكتشاف الكلمات الرئيسية الديناميكي (globalThis + حزمة window)
  globals.ts            إدارة الحالة العمومية (خرائط النموذج الفارغ)
  substitute.ts         أدوات استبدال المعرفات
  declarations.d.ts     إعلانات أنواع الوحدات
  passes/
    firstPass.ts        فهرسة المعرفات
    secondPass.ts       استبدال المعرفات + ترميز السلاسل
    thirdPass.ts        حقن المعاملات الوهمية
  transforms/
    antiDebug.ts        مصائد eval("debugger") + حلقات setInterval
    tripwires.ts        فحوصات المدخلات السرية للبرامج المثقوبة [الورقة 4]
    noiseInjection.ts   ضوضاء حسابية مستوحاة من LPN [الورقة 7]
    controlFlowFlattening.ts  توزيع while/switch + حساب نمطي [الورقة 3]
    opaquePredicates.ts       15 مسندًا رياضيًا دائمي الصواب/الخطأ
    proxyFunctions.ts         موزعات تسطيح رسم الاستدعاء
    contextExhaustion.ts      ضوضاء ثلاثية/void لملء سياق LLM
    commaExpressions.ts       دمج العبارات عبر عامل الفاصلة
    globalVariableEncoding.ts eval+replace للمتغيرات العمومية
    propertyKeyEncoding.ts    وصول خاصية محسوب بسجلات لكل نطاق
    numberEncoding.ts         11 استراتيجية ترميز bitwise/حسابي
    selfIntegrity.ts          فحوصات وقت تشغيل مضادة للعبث [الورقة 10]
    stringArrayExtraction.ts  XOR متسلسل + أخطاء موضعية متناثرة [الأوراق 2، 9]
    deadCodeInjection.ts      كود ميت قائم على القالب والطفرة [الورقة 3]
  verification/
    nullCircuitTest.ts        تسجيل جودة الكود الميت [الورقة 10]
    unobfuscatableTests.ts    حالات اختبار استخراج الأسرار [الورقة 1]
  __tests__/                  300+ اختبار وحدة عبر 21 مجموعة
tools/
  obfuscate-package.ts  اختبار توافق حزم npm باستخدام webpack
tests/
  input*.js             ملفات اختبار الإدخال الأصلية

# تشغيل جميع الاختبارات
npm test

# تشغيل مجموعة اختبار محددة
npx jest controlFlowFlattening
npx jest tripwires
npx jest noiseInjection

# اختبار ضد حزم npm (يستنسخ المستودعات، يبنى باستخدام webpack، يخفي، يشغل الاختبارات)
npm run obfuscate-package                    # جميع الحزم العشرة
npm run obfuscate-package -- minimist semver # حزم محددة