|
3564 | 3564 | "required": ["dts"], |
3565 | 3565 | "additionalProperties": false |
3566 | 3566 | }, |
3567 | | - "Generator": {}, |
| 3567 | + "Omit_e1330183": { |
| 3568 | + "type": "object", |
| 3569 | + "properties": { |
| 3570 | + "stripInternal": { |
| 3571 | + "anyOf": [{ "const": false }, { "const": true }], |
| 3572 | + "description": "Do not emit declarations for code that has an" |
| 3573 | + } |
| 3574 | + }, |
| 3575 | + "required": [], |
| 3576 | + "additionalProperties": false |
| 3577 | + }, |
| 3578 | + "TsgoOptions": { |
| 3579 | + "type": "object", |
| 3580 | + "properties": { |
| 3581 | + "path": { |
| 3582 | + "type": "string", |
| 3583 | + "description": "Path to a custom `tsgo` executable." |
| 3584 | + } |
| 3585 | + }, |
| 3586 | + "required": [], |
| 3587 | + "additionalProperties": false |
| 3588 | + }, |
| 3589 | + "FileExtensionInfo": { |
| 3590 | + "type": "object", |
| 3591 | + "properties": { |
| 3592 | + "extension": { "type": "string" }, |
| 3593 | + "isMixedContent": { "anyOf": [{ "const": false }, { "const": true }] }, |
| 3594 | + "scriptKind": { |
| 3595 | + "anyOf": [ |
| 3596 | + { "const": 0 }, |
| 3597 | + { "const": 1 }, |
| 3598 | + { "const": 2 }, |
| 3599 | + { "const": 3 }, |
| 3600 | + { "const": 4 }, |
| 3601 | + { "const": 5 }, |
| 3602 | + { "const": 6 }, |
| 3603 | + { "const": 7 } |
| 3604 | + ] |
| 3605 | + } |
| 3606 | + }, |
| 3607 | + "required": ["extension", "isMixedContent"], |
| 3608 | + "additionalProperties": false |
| 3609 | + }, |
| 3610 | + "CustomLanguage": { |
| 3611 | + "type": "object", |
| 3612 | + "properties": { |
| 3613 | + "extensionPatterns": { |
| 3614 | + "type": "array", |
| 3615 | + "items": {}, |
| 3616 | + "description": "Patterns that identify files written in this language." |
| 3617 | + }, |
| 3618 | + "tsFileExtensionInfos": { |
| 3619 | + "type": "array", |
| 3620 | + "items": { "$ref": "#/$defs/FileExtensionInfo" }, |
| 3621 | + "description": "Extra file extensions passed to the TypeScript compiler." |
| 3622 | + } |
| 3623 | + }, |
| 3624 | + "required": ["extensionPatterns"], |
| 3625 | + "additionalProperties": false |
| 3626 | + }, |
3568 | 3627 | "WatchOptions": { |
3569 | 3628 | "type": "object", |
3570 | 3629 | "properties": { |
|
4640 | 4699 | "type": "object", |
4641 | 4700 | "properties": {}, |
4642 | 4701 | "required": [], |
4643 | | - "additionalProperties": { "anyOf": [{}, {}, {}, {}] } |
| 4702 | + "additionalProperties": { |
| 4703 | + "anyOf": [ |
| 4704 | + { "const": false }, |
| 4705 | + { "const": true }, |
| 4706 | + { "$ref": "#/$defs/Record_519c04ca" }, |
| 4707 | + { "type": "array", "items": { "$ref": "#/$defs/Record_519c04ca" } } |
| 4708 | + ] |
| 4709 | + } |
4644 | 4710 | }, |
4645 | 4711 | "Record_ab245659": { |
4646 | 4712 | "type": "object", |
|
4785 | 4851 | "required": [], |
4786 | 4852 | "additionalProperties": false |
4787 | 4853 | }, |
4788 | | - "TscOptions": { |
4789 | | - "type": "object", |
4790 | | - "properties": { |
4791 | | - "vue": { |
4792 | | - "anyOf": [ |
4793 | | - { "const": false }, |
4794 | | - { "const": true }, |
4795 | | - { "$ref": "#/$defs/VueLanguageOptions" } |
4796 | | - ], |
4797 | | - "description": "Registers the built-in Vue language integration using `vue-tsc`.\n\nThis is a shortcut for a preconfigured {@link Options.customLanguages}\nentry and requires the `tsc` generator.", |
4798 | | - "default": false |
4799 | | - }, |
4800 | | - "build": { |
4801 | | - "anyOf": [{ "const": false }, { "const": true }], |
4802 | | - "description": "Uses TypeScript build mode (`tsc -b`) and follows project references.", |
4803 | | - "default": false |
4804 | | - }, |
4805 | | - "incremental": { |
4806 | | - "anyOf": [{ "const": false }, { "const": true }], |
4807 | | - "description": "Persists build-mode outputs, including `.tsbuildinfo`, to disk for reuse.\nWhen disabled, build outputs stay in memory." |
4808 | | - }, |
4809 | | - "parallel": { |
4810 | | - "anyOf": [{ "const": false }, { "const": true }], |
4811 | | - "description": "Runs `tsc` or `vue-tsc` in a separate process.\nCustom languages supplied through {@link Options.customLanguages} are not\nsupported in the worker process.", |
4812 | | - "default": false |
4813 | | - }, |
4814 | | - "eager": { |
4815 | | - "anyOf": [{ "const": false }, { "const": true }], |
4816 | | - "description": "Loads every file listed by `tsconfig.json` into the TypeScript program.\n\nUseful when one config covers multiple packages or entry points.", |
4817 | | - "default": false |
4818 | | - }, |
4819 | | - "newContext": { |
4820 | | - "anyOf": [{ "const": false }, { "const": true }], |
4821 | | - "description": "Uses an isolated TypeScript cache instead of the shared global context.", |
4822 | | - "default": false |
4823 | | - } |
4824 | | - }, |
4825 | | - "required": [], |
4826 | | - "additionalProperties": false |
4827 | | - }, |
4828 | | - "Omit_e1330183": { |
4829 | | - "type": "object", |
4830 | | - "properties": { |
4831 | | - "stripInternal": { |
4832 | | - "anyOf": [{ "const": false }, { "const": true }], |
4833 | | - "description": "Do not emit declarations for code that has an" |
4834 | | - } |
4835 | | - }, |
4836 | | - "required": [], |
4837 | | - "additionalProperties": false |
4838 | | - }, |
4839 | | - "TsgoOptions": { |
| 4854 | + "Options": { |
4840 | 4855 | "type": "object", |
4841 | 4856 | "properties": { |
4842 | | - "runExternalCode": { |
4843 | | - "anyOf": [{ "const": false }, { "const": true }], |
4844 | | - "description": "Allows TypeScript to execute content mappers configured in tsconfig.\nCannot be combined with `tsgo.vfs` when content mappers are configured.", |
4845 | | - "default": false |
4846 | | - }, |
4847 | | - "moduleUrl": { |
4848 | | - "type": "string", |
4849 | | - "description": "A `file://` URL of the TypeScript module that provides the TypeScript Go API.\n\nUse `import.meta.resolve()` to select an npm alias or another compatible\nTypeScript module." |
| 4857 | + "oxc": { |
| 4858 | + "$ref": "#/$defs/Omit_e1330183", |
| 4859 | + "description": "Options for the `oxc` generator.\n\nThe top-level {@link GeneralOptions.sourcemapsourcemap} option controls\ndeclaration maps." |
4850 | 4860 | }, |
4851 | | - "path": { |
4852 | | - "type": "string", |
4853 | | - "description": "Path passed to the TypeScript Go API as `tsserverPath`." |
| 4861 | + "tsgo": { |
| 4862 | + "$ref": "#/$defs/TsgoOptions", |
| 4863 | + "description": "**[Experimental]** Options for the `tsgo` generator.\n\nUsed when {@link GeneralOptions.generatorgenerator} is `'tsgo'` or\nTypeScript 7 is detected." |
4854 | 4864 | }, |
4855 | | - "vfs": { |
4856 | | - "anyOf": [{ "const": false }, { "const": true }], |
4857 | | - "description": "Supplies Rolldown-transformed source code to the `tsgo` API through a\nvirtual filesystem.", |
4858 | | - "default": false |
4859 | | - } |
4860 | | - }, |
4861 | | - "required": [], |
4862 | | - "additionalProperties": false |
4863 | | - }, |
4864 | | - "FileExtensionInfo": { |
4865 | | - "type": "object", |
4866 | | - "properties": { |
4867 | | - "extension": { "type": "string" }, |
4868 | | - "isMixedContent": { "anyOf": [{ "const": false }, { "const": true }] }, |
4869 | | - "scriptKind": { |
4870 | | - "anyOf": [ |
4871 | | - { "const": 0 }, |
4872 | | - { "const": 1 }, |
4873 | | - { "const": 2 }, |
4874 | | - { "const": 3 }, |
4875 | | - { "const": 4 }, |
4876 | | - { "const": 5 }, |
4877 | | - { "const": 6 }, |
4878 | | - { "const": 7 } |
4879 | | - ] |
4880 | | - } |
4881 | | - }, |
4882 | | - "required": ["extension", "isMixedContent"], |
4883 | | - "additionalProperties": false |
4884 | | - }, |
4885 | | - "CustomLanguage": { |
4886 | | - "type": "object", |
4887 | | - "properties": { |
4888 | | - "extensionPatterns": { |
| 4865 | + "customLanguages": { |
4889 | 4866 | "type": "array", |
4890 | | - "items": {}, |
4891 | | - "description": "Patterns that identify files written in this language." |
| 4867 | + "items": { "$ref": "#/$defs/CustomLanguage" }, |
| 4868 | + "description": "Registers non-standard source languages such as Vue or Astro.\n\nIf a language is supported via {@link https://volarjs.dev Volar},\n{@link CustomLanguage.volarTypeScript} and\n{@link CustomLanguage.createVolarPlugins} are both required. Volar\nlanguages require `tsc`; `tsgo` does not support custom languages." |
4892 | 4869 | }, |
4893 | | - "tsFileExtensionInfos": { |
4894 | | - "type": "array", |
4895 | | - "items": { "$ref": "#/$defs/FileExtensionInfo" }, |
4896 | | - "description": "Extra file extensions passed to the TypeScript compiler." |
4897 | | - } |
4898 | | - }, |
4899 | | - "required": ["extensionPatterns"], |
4900 | | - "additionalProperties": false |
4901 | | - }, |
4902 | | - "Options": { |
4903 | | - "type": "object", |
4904 | | - "properties": { |
4905 | 4870 | "generator": { |
4906 | 4871 | "anyOf": [ |
4907 | 4872 | { "const": "tsc" }, |
4908 | 4873 | { "const": "oxc" }, |
4909 | | - { "const": "tsgo" }, |
4910 | | - { "$ref": "#/$defs/Generator" } |
| 4874 | + { "const": "tsgo" } |
4911 | 4875 | ], |
4912 | | - "description": "The generator used to produce declaration files.\n\n- `'tsc'` supports the full TypeScript type system.\n- `'oxc'` is faster but requires code compatible with\n [`isolatedDeclarations`](https://www.typescriptlang.org/tsconfig/#isolatedDeclarations).\n- `'tsgo'` uses the experimental TypeScript Go API.\n- A custom {@link Generator} implementation can be provided directly.\n\nWhen omitted, the plugin selects `'oxc'` for `isolatedDeclarations`,\n`'tsgo'` when TypeScript exposes the declaration emit API, and `'tsc'`\notherwise. Volar-based custom languages require `'tsc'`." |
| 4876 | + "description": "The generator used to produce declaration files.\n\n- `'tsc'` supports the full TypeScript type system.\n- `'oxc'` is faster but requires code compatible with\n [`isolatedDeclarations`](https://www.typescriptlang.org/tsconfig/#isolatedDeclarations).\n- `'tsgo'` uses the experimental TypeScript Go compiler.\n\nWhen omitted, the plugin selects `'oxc'` for `isolatedDeclarations`,\n`'tsgo'` for TypeScript 7, and `'tsc'` otherwise. Volar-based custom\nlanguages require `'tsc'`." |
4913 | 4877 | }, |
4914 | 4878 | "entry": { |
4915 | 4879 | "anyOf": [ |
|
4938 | 4902 | { "const": false }, |
4939 | 4903 | { "const": true } |
4940 | 4904 | ], |
4941 | | - "description": "A `tsconfig.json` path, resolved relative to {@link cwd}.\n\nWhen omitted or `true`, the nearest config is discovered from {@link cwd}.\nSet to `false` to disable config loading. The `tsgo` generator requires a\nconfig file." |
| 4905 | + "description": "A `tsconfig.json` path, resolved relative to {@link cwd}.\n\nWhen omitted or `true`, the nearest config is discovered from {@link cwd}.\nSet to `false` to disable config loading." |
4942 | 4906 | }, |
4943 | 4907 | "tsconfigRaw": { |
4944 | 4908 | "$ref": "#/$defs/Omit_89a7186e", |
4945 | | - "description": "Raw `tsconfig.json` values merged over the loaded config.\nThe plugin's current `tsgo` implementation does not apply these overrides\nto the TypeScript program." |
| 4909 | + "description": "Raw `tsconfig.json` values merged over the loaded config." |
4946 | 4910 | }, |
4947 | 4911 | "compilerOptions": { |
4948 | 4912 | "$ref": "#/$defs/CompilerOptions", |
4949 | | - "description": "Compiler options merged over those loaded from `tsconfig.json`.\nIn the plugin's current `tsgo` implementation, these affect plugin behavior\nbut do not override the program's compiler options. Set those options in\nthe config file instead." |
| 4913 | + "description": "Compiler options merged over those loaded from `tsconfig.json`." |
4950 | 4914 | }, |
4951 | 4915 | "sourcemap": { |
4952 | 4916 | "anyOf": [{ "const": false }, { "const": true }], |
4953 | | - "description": "Emits declaration maps (`.d.ts.map`).\nWith `tsgo`, source mappings also require `compilerOptions.declarationMap`\nto be enabled in the on-disk config; `sourcemap: true` alone is insufficient." |
| 4917 | + "description": "Emits declaration maps (`.d.ts.map`)." |
4954 | 4918 | }, |
4955 | 4919 | "resolver": { |
4956 | 4920 | "anyOf": [{ "const": "tsc" }, { "const": "oxc" }], |
|
4971 | 4935 | "$ref": "#/$defs/Logger", |
4972 | 4936 | "description": "Logger used for plugin messages." |
4973 | 4937 | }, |
4974 | | - "emitJs": { |
| 4938 | + "build": { |
4975 | 4939 | "anyOf": [{ "const": false }, { "const": true }], |
4976 | | - "description": "Generates declarations for JavaScript files with JSDoc types." |
| 4940 | + "description": "Uses TypeScript build mode (`tsc -b`) and follows project references.", |
| 4941 | + "default": false |
4977 | 4942 | }, |
4978 | | - "tsc": { |
4979 | | - "$ref": "#/$defs/TscOptions", |
4980 | | - "description": "Options for the built-in `tsc` generator." |
| 4943 | + "incremental": { |
| 4944 | + "anyOf": [{ "const": false }, { "const": true }], |
| 4945 | + "description": "Persists build-mode outputs, including `.tsbuildinfo`, to disk for reuse.\nWhen disabled, build outputs stay in memory." |
4981 | 4946 | }, |
4982 | | - "oxc": { |
4983 | | - "$ref": "#/$defs/Omit_e1330183", |
4984 | | - "description": "Options for the `oxc` generator.\n\nThe top-level {@link Options.sourcemapsourcemap} option controls\ndeclaration maps." |
| 4947 | + "vue": { |
| 4948 | + "anyOf": [ |
| 4949 | + { "const": false }, |
| 4950 | + { "const": true }, |
| 4951 | + { "$ref": "#/$defs/VueLanguageOptions" } |
| 4952 | + ], |
| 4953 | + "description": "Registers the built-in Vue language integration using `vue-tsc`.\n\nThis is a shortcut for a preconfigured {@link Options.customLanguages}\nentry and requires the `tsc` generator.", |
| 4954 | + "default": false |
4985 | 4955 | }, |
4986 | | - "tsgo": { |
4987 | | - "$ref": "#/$defs/TsgoOptions", |
4988 | | - "description": "**[Experimental]** Options for the TypeScript Go generator." |
| 4956 | + "parallel": { |
| 4957 | + "anyOf": [{ "const": false }, { "const": true }], |
| 4958 | + "description": "Runs `tsc` or `vue-tsc` in a separate process.", |
| 4959 | + "default": false |
4989 | 4960 | }, |
4990 | | - "customLanguages": { |
4991 | | - "type": "array", |
4992 | | - "items": { "$ref": "#/$defs/CustomLanguage" }, |
4993 | | - "description": "Registers non-standard source languages such as Vue or Astro.\n\nIf a language is supported via {@link https://volarjs.dev Volar},\n{@link CustomLanguage.volarTypeScript} and\n{@link CustomLanguage.createVolarPlugins} are both required. Volar\nlanguages require `tsc`. Non-Volar languages can use `tsgo` together\nwith {@link TsgoOptions.vfs`tsgo.vfs`}." |
| 4961 | + "eager": { |
| 4962 | + "anyOf": [{ "const": false }, { "const": true }], |
| 4963 | + "description": "Loads every file listed by `tsconfig.json` into the TypeScript program.\n\nUseful when one config covers multiple packages or entry points.", |
| 4964 | + "default": false |
| 4965 | + }, |
| 4966 | + "newContext": { |
| 4967 | + "anyOf": [{ "const": false }, { "const": true }], |
| 4968 | + "description": "Uses an isolated TypeScript cache instead of the shared global context.", |
| 4969 | + "default": false |
| 4970 | + }, |
| 4971 | + "emitJs": { |
| 4972 | + "anyOf": [{ "const": false }, { "const": true }], |
| 4973 | + "description": "Generates declarations for JavaScript files with JSDoc types." |
4994 | 4974 | } |
4995 | 4975 | }, |
4996 | 4976 | "required": [], |
|
0 commit comments