يُعد ملف package.json ملف التعريف المركزي (Manifest) لمشاريع Node.js وحزم npm، حيث يدير البيانات الوصفية والتبعيات والسكريبتات وأهداف البناء.
الهيكل الأساسي لملف التعريف (Basic Manifest Structure)
{
"name": "my-awesome-package",
"version": "1.0.0",
"description": "Production-grade utility library",
"main": "dist/index.js",
"types": "dist/index.d.ts",
"bin": {
"mycli": "./bin/cli.js"
},
"keywords": ["node", "api", "tools"],
"author": "Jane Doe <[email protected]>",
"license": "MIT",
"engines": {
"node": ">=18.0.0"
}
}
أنواع التبعيات وقواعد الإصدارات (Dependencies & SemVer)
{
"dependencies": {
"express": "^4.19.2",
"lodash": "~4.17.21"
},
"devDependencies": {
"eslint": "^9.0.0",
"typescript": "^5.4.5"
},
"peerDependencies": {
"react": ">=18.0.0"
},
"optionalDependencies": {
"fsevents": "^2.3.3"
}
}
1.2.3: Exact version match.^1.2.3: Compatible with version (1.x.x).~1.2.3: Patch upgrades only (1.2.x).*: Any available version.
أوامر السكريبت ومتغيرات التكوين (npm Scripts & Config)
{
"config": {
"port": "8080"
},
"scripts": {
"prebuild": "rimraf dist",
"build": "tsc -p tsconfig.build.json",
"start": "node dist/index.js",
"test": "vitest run",
"server": "echo Server port: $npm_package_config_port"
}
}