@ts-type/package-dts 2.0.7 → 3.0.1

package/schema/package.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "http://json-schema.org/draft-04/schema#",
+	"$schema": "http://json-schema.org/draft-07/schema#",
 	"title": "JSON schema for NPM package.json files",
 	"definitions": {
 		"person": {
@@ -32,6 +32,74 @@
 				"type": "string"
 			}
 		},
+		"devDependency": {
+			"description": "Specifies dependencies that are required for the development and testing of the project. These dependencies are not needed in the production environment.",
+			"type": "object",
+			"additionalProperties": {
+				"type": "string"
+			}
+		},
+		"optionalDependency": {
+			"description": "Specifies dependencies that are optional for your project. These dependencies are attempted to be installed during the npm install process, but if they fail to install, the installation process will not fail.",
+			"type": "object",
+			"additionalProperties": {
+				"type": "string"
+			}
+		},
+		"peerDependency": {
+			"description": "Specifies dependencies that are required by the package but are expected to be provided by the consumer of the package.",
+			"type": "object",
+			"additionalProperties": {
+				"type": "string"
+			}
+		},
+		"peerDependencyMeta": {
+			"description": "When a user installs your package, warnings are emitted if packages specified in \"peerDependencies\" are not already installed. The \"peerDependenciesMeta\" field serves to provide more information on how your peer dependencies are utilized. Most commonly, it allows peer dependencies to be marked as optional. Metadata for this field is specified with a simple hash of the package name to a metadata object.",
+			"type": "object",
+			"additionalProperties": {
+				"type": "object",
+				"additionalProperties": true,
+				"properties": {
+					"optional": {
+						"description": "Specifies that this peer dependency is optional and should not be installed automatically.",
+						"type": "boolean"
+					}
+				}
+			}
+		},
+		"license": {
+			"anyOf": [
+				{
+					"type": "string"
+				},
+				{
+					"enum": [
+						"AGPL-3.0-only",
+						"Apache-2.0",
+						"BSD-2-Clause",
+						"BSD-3-Clause",
+						"BSL-1.0",
+						"CC0-1.0",
+						"CDDL-1.0",
+						"CDDL-1.1",
+						"EPL-1.0",
+						"EPL-2.0",
+						"GPL-2.0-only",
+						"GPL-3.0-only",
+						"ISC",
+						"LGPL-2.0-only",
+						"LGPL-2.1-only",
+						"LGPL-2.1-or-later",
+						"LGPL-3.0-only",
+						"LGPL-3.0-or-later",
+						"MIT",
+						"MPL-2.0",
+						"MS-PL",
+						"UNLICENSED"
+					]
+				}
+			]
+		},
 		"scriptsInstallAfter": {
 			"description": "Run AFTER the package is installed.",
 			"type": "string",
@@ -92,6 +160,11 @@
 					"$ref": "#/definitions/packageExportsEntryOrFallback",
 					"description": "The module path that is resolved when this specifier is imported as an ECMAScript module using an `import` declaration or the dynamic `import(...)` function."
 				},
+				"module-sync": {
+					"$ref": "#/definitions/packageExportsEntryOrFallback",
+					"$comment": "https://nodejs.org/api/packages.html#conditional-exports#:~:text=%22module-sync%22",
+					"description": "The same as `import`, but can be used with require(esm) in Node 20+. This requires the files to not use any top-level awaits."
+				},
 				"node": {
 					"$ref": "#/definitions/packageExportsEntryOrFallback",
 					"description": "The module path that is resolved when this environment is Node.js."
@@ -99,12 +172,20 @@
 				"default": {
 					"$ref": "#/definitions/packageExportsEntryOrFallback",
 					"description": "The module path that is resolved when no other export type matches."
+				},
+				"types": {
+					"$ref": "#/definitions/packageExportsEntryOrFallback",
+					"description": "The module path that is resolved for TypeScript types when this specifier is imported. Should be listed before other conditions. Additionally, versioned \"types\" condition in the form \"types@{selector}\" are supported."
 				}
 			},
 			"patternProperties": {
-				"^(?![\\.0-9]).": {
+				"^[^.0-9]+$": {
 					"$ref": "#/definitions/packageExportsEntryOrFallback",
 					"description": "The module path that is resolved when this environment matches the property name."
+				},
+				"^types@.+$": {
+					"$ref": "#/definitions/packageExportsEntryOrFallback",
+					"description": "The module path that is resolved for TypeScript types when this specifier is imported. Should be listed before other conditions. Additionally, versioned \"types\" condition in the form \"types@{selector}\" are supported."
 				}
 			},
 			"additionalProperties": false
@@ -136,6 +217,77 @@
 				}
 			]
 		},
+		"packageImportsEntryPath": {
+			"type": [
+				"string",
+				"null"
+			],
+			"description": "The module path that is resolved when this specifier is imported. Set to `null` to disallow importing this module."
+		},
+		"packageImportsEntryObject": {
+			"type": "object",
+			"description": "Used to specify conditional exports, note that Conditional exports are unsupported in older environments, so it's recommended to use the fallback array option if support for those environments is a concern.",
+			"properties": {
+				"require": {
+					"$ref": "#/definitions/packageImportsEntryOrFallback",
+					"description": "The module path that is resolved when this specifier is imported as a CommonJS module using the `require(...)` function."
+				},
+				"import": {
+					"$ref": "#/definitions/packageImportsEntryOrFallback",
+					"description": "The module path that is resolved when this specifier is imported as an ECMAScript module using an `import` declaration or the dynamic `import(...)` function."
+				},
+				"node": {
+					"$ref": "#/definitions/packageImportsEntryOrFallback",
+					"description": "The module path that is resolved when this environment is Node.js."
+				},
+				"default": {
+					"$ref": "#/definitions/packageImportsEntryOrFallback",
+					"description": "The module path that is resolved when no other export type matches."
+				},
+				"types": {
+					"$ref": "#/definitions/packageImportsEntryOrFallback",
+					"description": "The module path that is resolved for TypeScript types when this specifier is imported. Should be listed before other conditions. Additionally, versioned \"types\" condition in the form \"types@{selector}\" are supported."
+				}
+			},
+			"patternProperties": {
+				"^[^.0-9]+$": {
+					"$ref": "#/definitions/packageImportsEntryOrFallback",
+					"description": "The module path that is resolved when this environment matches the property name."
+				},
+				"^types@.+$": {
+					"$ref": "#/definitions/packageImportsEntryOrFallback",
+					"description": "The module path that is resolved for TypeScript types when this specifier is imported. Should be listed before other conditions. Additionally, versioned \"types\" condition in the form \"types@{selector}\" are supported."
+				}
+			},
+			"additionalProperties": false
+		},
+		"packageImportsEntry": {
+			"oneOf": [
+				{
+					"$ref": "#/definitions/packageImportsEntryPath"
+				},
+				{
+					"$ref": "#/definitions/packageImportsEntryObject"
+				}
+			]
+		},
+		"packageImportsFallback": {
+			"type": "array",
+			"description": "Used to allow fallbacks in case this environment doesn't support the preceding entries.",
+			"items": {
+				"$ref": "#/definitions/packageImportsEntry"
+			}
+		},
+		"packageImportsEntryOrFallback": {
+			"oneOf": [
+				{
+					"$ref": "#/definitions/packageImportsEntry"
+				},
+				{
+					"$ref": "#/definitions/packageImportsFallback"
+				}
+			]
+		},
 		"fundingUrl": {
 			"type": "string",
 			"format": "uri",
@@ -157,6 +309,33 @@
 			"required": [
 				"url"
 			]
+		},
+		"devEngineDependency": {
+			"description": "Specifies requirements for development environment components such as operating systems, runtimes, or package managers. Used to ensure consistent development environments across the team.",
+			"type": "object",
+			"required": [
+				"name"
+			],
+			"properties": {
+				"name": {
+					"type": "string",
+					"description": "The name of the dependency, with allowed values depending on the parent field"
+				},
+				"version": {
+					"type": "string",
+					"description": "The version range for the dependency"
+				},
+				"onFail": {
+					"type": "string",
+					"enum": [
+						"ignore",
+						"warn",
+						"error",
+						"download"
+					],
+					"description": "What action to take if validation fails"
+				}
+			}
 		}
 	},
 	"type": "object",
@@ -172,10 +351,10 @@
 			"type": "string",
 			"maxLength": 214,
 			"minLength": 1,
-			"pattern": "^(?:@[a-z0-9-*~][a-z0-9-*._~]*/)?[a-z0-9-~][a-z0-9-._~]*$"
+			"pattern": "^(?:(?:@(?:[a-z0-9-*~][a-z0-9-*._~]*)?/[a-z0-9-._~])|[a-z0-9-~])[a-z0-9-._~]*$"
 		},
 		"version": {
-			"description": "Version must be parseable by node-semver, which is bundled with npm as a dependency.",
+			"description": "Version must be parsable by node-semver, which is bundled with npm as a dependency.",
 			"type": "string"
 		},
 		"description": {
@@ -213,7 +392,7 @@
 			}
 		},
 		"license": {
-			"type": "string",
+			"$ref": "#/definitions/license",
 			"description": "You should specify a license for your package so that people know how they are permitted to use it, and any restrictions you're placing on it."
 		},
 		"licenses": {
@@ -223,7 +402,7 @@
 				"type": "object",
 				"properties": {
 					"type": {
-						"type": "string"
+						"$ref": "#/definitions/license"
 					},
 					"url": {
 						"type": "string",
@@ -293,6 +472,17 @@
 				}
 			]
 		},
+		"imports": {
+			"description": "The \"imports\" field is used to create private mappings that only apply to import specifiers from within the package itself.",
+			"type": "object",
+			"patternProperties": {
+				"^#.+$": {
+					"$ref": "#/definitions/packageImportsEntryOrFallback",
+					"description": "The module path that is resolved when this environment matches the property name."
+				}
+			},
+			"additionalProperties": false
+		},
 		"bin": {
 			"type": [
 				"string",
@@ -450,7 +640,7 @@
 				},
 				"prepare": {
 					"type": "string",
-					"description": "Run both BEFORE the package is packed and published, and on local npm install without any arguments. This is run AFTER prepublish, but BEFORE prepublishOnly."
+					"description": "Runs BEFORE the package is packed, i.e. during \"npm publish\" and \"npm pack\", and on local \"npm install\" without any arguments. This is run AFTER \"prepublish\", but BEFORE \"prepublishOnly\"."
 				},
 				"prepublishOnly": {
 					"type": "string",
@@ -557,29 +747,18 @@
 			"$ref": "#/definitions/dependency"
 		},
 		"devDependencies": {
-			"$ref": "#/definitions/dependency"
+			"$ref": "#/definitions/devDependency"
 		},
 		"optionalDependencies": {
-			"$ref": "#/definitions/dependency"
+			"$ref": "#/definitions/optionalDependency"
 		},
 		"peerDependencies": {
-			"$ref": "#/definitions/dependency"
+			"$ref": "#/definitions/peerDependency"
 		},
 		"peerDependenciesMeta": {
-			"description": "When a user installs your package, warnings are emitted if packages specified in \"peerDependencies\" are not already installed. The \"peerDependenciesMeta\" field serves to provide more information on how your peer dependencies are utilized. Most commonly, it allows peer dependencies to be marked as optional. Metadata for this field is specified with a simple hash of the package name to a metadata object.",
-			"type": "object",
-			"additionalProperties": {
-				"type": "object",
-				"additionalProperties": true,
-				"properties": {
-					"optional": {
-						"description": "Specifies that this peer dependency is optional and should not be installed automatically.",
-						"type": "boolean"
-					}
-				}
-			}
+			"$ref": "#/definitions/peerDependencyMeta"
 		},
-		"bundledDependencies": {
+		"bundleDependencies": {
 			"description": "Array of package names that will be bundled when publishing the package.",
 			"oneOf": [
 				{
@@ -593,8 +772,8 @@
 				}
 			]
 		},
-		"bundleDependencies": {
-			"description": "DEPRECATED: This field is honored, but \"bundledDependencies\" is the correct field name.",
+		"bundledDependencies": {
+			"description": "DEPRECATED: This field is honored, but \"bundleDependencies\" is the correct field name.",
 			"oneOf": [
 				{
 					"type": "array",
@@ -608,13 +787,17 @@
 			]
 		},
 		"resolutions": {
-			"description": "Resolutions is used to support selective version resolutions, which lets you define custom package versions or ranges inside your dependencies. See: https://classic.yarnpkg.com/en/docs/selective-version-resolutions",
+			"description": "Resolutions is used to support selective version resolutions using yarn, which lets you define custom package versions or ranges inside your dependencies. For npm, use overrides instead. See: https://yarnpkg.com/configuration/manifest#resolutions",
+			"type": "object"
+		},
+		"overrides": {
+			"description": "Overrides is used to support selective version overrides using npm, which lets you define custom package versions or ranges inside your dependencies. For yarn, use resolutions instead. See: https://docs.npmjs.com/cli/v9/configuring-npm/package-json#overrides",
 			"type": "object"
 		},
 		"packageManager": {
 			"description": "Defines which package manager is expected to be used when working on the current project. This field is currently experimental and needs to be opted-in; see https://nodejs.org/api/corepack.html",
 			"type": "string",
-			"pattern": "(npm|pnpm|yarn)@\\d+\\.\\d+\\.\\d+(-.+)?"
+			"pattern": "(npm|pnpm|yarn|bun)@\\d+\\.\\d+\\.\\d+(-.+)?"
 		},
 		"engines": {
 			"type": "object",
@@ -627,6 +810,21 @@
 				"type": "string"
 			}
 		},
+		"volta": {
+			"description": "Defines which tools and versions are expected to be used when Volta is installed.",
+			"type": "object",
+			"properties": {
+				"extends": {
+					"description": "The value of that entry should be a path to another JSON file which also has a \"volta\" section",
+					"type": "string"
+				}
+			},
+			"patternProperties": {
+				"(node|npm|pnpm|yarn)": {
+					"type": "string"
+				}
+			}
+		},
 		"engineStrict": {
 			"type": "boolean"
 		},
@@ -644,6 +842,82 @@
 				"type": "string"
 			}
 		},
+		"devEngines": {
+			"description": "Define the runtime and package manager for developing the current project.",
+			"type": "object",
+			"properties": {
+				"os": {
+					"oneOf": [
+						{
+							"$ref": "#/definitions/devEngineDependency"
+						},
+						{
+							"type": "array",
+							"items": {
+								"$ref": "#/definitions/devEngineDependency"
+							}
+						}
+					],
+					"description": "Specifies which operating systems are supported for development"
+				},
+				"cpu": {
+					"oneOf": [
+						{
+							"$ref": "#/definitions/devEngineDependency"
+						},
+						{
+							"type": "array",
+							"items": {
+								"$ref": "#/definitions/devEngineDependency"
+							}
+						}
+					],
+					"description": "Specifies which CPU architectures are supported for development"
+				},
+				"libc": {
+					"oneOf": [
+						{
+							"$ref": "#/definitions/devEngineDependency"
+						},
+						{
+							"type": "array",
+							"items": {
+								"$ref": "#/definitions/devEngineDependency"
+							}
+						}
+					],
+					"description": "Specifies which C standard libraries are supported for development"
+				},
+				"runtime": {
+					"oneOf": [
+						{
+							"$ref": "#/definitions/devEngineDependency"
+						},
+						{
+							"type": "array",
+							"items": {
+								"$ref": "#/definitions/devEngineDependency"
+							}
+						}
+					],
+					"description": "Specifies which JavaScript runtimes (like Node.js, Deno, Bun) are supported for development. Values should use WinterCG Runtime Keys (see https://runtime-keys.proposal.wintercg.org/)"
+				},
+				"packageManager": {
+					"oneOf": [
+						{
+							"$ref": "#/definitions/devEngineDependency"
+						},
+						{
+							"type": "array",
+							"items": {
+								"$ref": "#/definitions/devEngineDependency"
+							}
+						}
+					],
+					"description": "Specifies which package managers are supported for development"
+				}
+			}
+		},
 		"preferGlobal": {
 			"type": "boolean",
 			"description": "DEPRECATED: This option used to trigger an npm warning, but it will no longer warn. It is purely there for informational purposes. It is now recommended that you install any binaries as local devDependencies wherever possible."
@@ -678,6 +952,9 @@
 				"registry": {
 					"type": "string",
 					"format": "uri"
+				},
+				"provenance": {
+					"type": "boolean"
 				}
 			},
 			"additionalProperties": true
@@ -769,6 +1046,230 @@
 		},
 		"jscpd": {
 			"$ref": "https://json.schemastore.org/jscpd.json"
+		},
+		"pnpm": {
+			"description": "Defines pnpm specific configuration.",
+			"type": "object",
+			"properties": {
+				"overrides": {
+					"description": "Used to override any dependency in the dependency graph.",
+					"type": "object"
+				},
+				"packageExtensions": {
+					"description": "Used to extend the existing package definitions with additional information.",
+					"type": "object",
+					"patternProperties": {
+						"^.+$": {
+							"type": "object",
+							"properties": {
+								"dependencies": {
+									"$ref": "#/definitions/dependency"
+								},
+								"optionalDependencies": {
+									"$ref": "#/definitions/optionalDependency"
+								},
+								"peerDependencies": {
+									"$ref": "#/definitions/peerDependency"
+								},
+								"peerDependenciesMeta": {
+									"$ref": "#/definitions/peerDependencyMeta"
+								}
+							},
+							"additionalProperties": false
+						}
+					},
+					"additionalProperties": false
+				},
+				"peerDependencyRules": {
+					"type": "object",
+					"properties": {
+						"ignoreMissing": {
+							"description": "pnpm will not print warnings about missing peer dependencies from this list.",
+							"type": "array",
+							"items": {
+								"type": "string"
+							}
+						},
+						"allowedVersions": {
+							"description": "Unmet peer dependency warnings will not be printed for peer dependencies of the specified range.",
+							"type": "object"
+						},
+						"allowAny": {
+							"description": "Any peer dependency matching the pattern will be resolved from any version, regardless of the range specified in \"peerDependencies\".",
+							"type": "array",
+							"items": {
+								"type": "string"
+							}
+						}
+					},
+					"additionalProperties": false
+				},
+				"neverBuiltDependencies": {
+					"description": "A list of dependencies to run builds for.",
+					"type": "array",
+					"items": {
+						"type": "string"
+					}
+				},
+				"onlyBuiltDependencies": {
+					"description": "A list of package names that are allowed to be executed during installation.",
+					"type": "array",
+					"items": {
+						"type": "string"
+					}
+				},
+				"onlyBuiltDependenciesFile": {
+					"description": "Specifies a JSON file that lists the only packages permitted to run installation scripts during the pnpm install process.",
+					"type": "string"
+				},
+				"ignoredBuiltDependencies": {
+					"description": "A list of package names that should not be built during installation.",
+					"type": "array",
+					"items": {
+						"type": "string"
+					}
+				},
+				"allowedDeprecatedVersions": {
+					"description": "A list of deprecated versions that the warnings are suppressed.",
+					"type": "object"
+				},
+				"patchedDependencies": {
+					"description": "A list of dependencies that are patched.",
+					"type": "object"
+				},
+				"allowNonAppliedPatches": {
+					"description": "When true, installation won't fail if some of the patches from the \"patchedDependencies\" field were not applied.",
+					"type": "boolean"
+				},
+				"allowUnusedPatches": {
+					"description": "When true, installation won't fail if some of the patches from the \"patchedDependencies\" field were not applied.",
+					"type": "boolean"
+				},
+				"updateConfig": {
+					"type": "object",
+					"properties": {
+						"ignoreDependencies": {
+							"description": "A list of packages that should be ignored when running \"pnpm outdated\" or \"pnpm update --latest\".",
+							"type": "array",
+							"items": {
+								"type": "string"
+							}
+						}
+					},
+					"additionalProperties": false
+				},
+				"configDependencies": {
+					"type": "object",
+					"description": "Configurational dependencies are installed before all the other types of dependencies (before 'dependencies', 'devDependencies', 'optionalDependencies')."
+				},
+				"auditConfig": {
+					"type": "object",
+					"properties": {
+						"ignoreCves": {
+							"description": "A list of CVE IDs that will be ignored by \"pnpm audit\".",
+							"type": "array",
+							"items": {
+								"type": "string",
+								"pattern": "^CVE-\\d{4}-\\d{4,7}$"
+							}
+						},
+						"ignoreGhsas": {
+							"description": "A list of GHSA Codes that will be ignored by \"pnpm audit\".",
+							"type": "array",
+							"items": {
+								"type": "string",
+								"pattern": "^GHSA(-[23456789cfghjmpqrvwx]{4}){3}$"
+							}
+						}
+					},
+					"additionalProperties": false
+				},
+				"requiredScripts": {
+					"description": "A list of scripts that must exist in each project.",
+					"type": "array",
+					"items": {
+						"type": "string"
+					}
+				},
+				"supportedArchitectures": {
+					"description": "Specifies architectures for which you'd like to install optional dependencies, even if they don't match the architecture of the system running the install.",
+					"type": "object",
+					"properties": {
+						"os": {
+							"type": "array",
+							"items": {
+								"type": "string"
+							}
+						},
+						"cpu": {
+							"type": "array",
+							"items": {
+								"type": "string"
+							}
+						},
+						"libc": {
+							"type": "array",
+							"items": {
+								"type": "string"
+							}
+						}
+					},
+					"additionalProperties": false
+				},
+				"ignoredOptionalDependencies": {
+					"description": "A list of optional dependencies that the install should be skipped.",
+					"type": "array",
+					"items": {
+						"type": "string"
+					}
+				},
+				"executionEnv": {
+					"type": "object",
+					"properties": {
+						"nodeVersion": {
+							"description": "Specifies which exact Node.js version should be used for the project's runtime.",
+							"type": "string"
+						}
+					},
+					"additionalProperties": false
+				}
+			},
+			"additionalProperties": false
+		},
+		"stackblitz": {
+			"description": "Defines the StackBlitz configuration for the project.",
+			"type": "object",
+			"properties": {
+				"installDependencies": {
+					"description": "StackBlitz automatically installs npm dependencies when opening a project.",
+					"type": "boolean"
+				},
+				"startCommand": {
+					"description": "A terminal command to be executed when opening the project, after installing npm dependencies.",
+					"type": [
+						"string",
+						"boolean"
+					]
+				},
+				"compileTrigger": {
+					"description": "The compileTrigger option controls how file changes in the editor are written to the WebContainers in-memory filesystem. ",
+					"oneOf": [
+						{
+							"type": "string",
+							"enum": [
+								"auto",
+								"keystroke",
+								"save"
+							]
+						}
+					]
+				},
+				"env": {
+					"description": "A map of default environment variables that will be set in each top-level shell process.",
+					"type": "object"
+				}
+			},
+			"additionalProperties": false
 		}
 	},
 	"anyOf": [
@@ -803,5 +1304,6 @@
 				"bundleDependencies"
 			]
 		}
-	]
+	],
+	"$id": "https://json.schemastore.org/package.json"
 }