add errors 1063-1092

Author: kitsonk

deno.json

@@ -17,9 +17,6 @@
       ]
     }
   },
-  "fmt": {
-    "exclude": ["./docs/*"]
-  },
   "exclude": [
     "**/_fresh/*"
   ],

docs/1003.md

@@ -1,5 +1,5 @@
 ---
-title: Identifier expected.
+title: "Identifier expected."
 category: error
 tags:
 - syntax-error

docs/1030.md

@@ -8,8 +8,10 @@ tags:
 Modifiers can only appear once per property. If a modifier is repeated, an error
 will be shown:
 
+<!-- deno-fmt-ignore-start -->
 ```ts
 class A {
   readonly readonly x: string;
 }
 ```
+<!-- deno-fmt-ignore-end -->

docs/1063.md

@@ -1,6 +1,10 @@
 ---
 title: "An export assignment cannot be used in a namespace."
 category: error
+tags:
+- typescript-only
+- namespace
+- export-assignment
 ---
 
 Namespaces are defined in TypeScript with an object which may have properties.

docs/1064.md

@@ -1,4 +1,20 @@
 ---
 title: "The return type of an async function or method must be the global Promise<T> type. Did you mean to write 'Promise<{0}>'?"
 category: error
+tags:
+- promise
+- async
+related:
+- 1055
 ---
+
+Async functions which try to declare non-promise return type will throw this
+error, because async functions and methods _always_ return a promise:
+
+```ts
+class A {
+  async method(): number {
+    return 1;
+  }
+}
+```

docs/1064_fix_01.md

@@ -0,0 +1,13 @@
+---
+title: "Correct the return type"
+---
+
+Correct the return type:
+
+```ts
+class A {
+  async method(): Promise<number> {
+    return 1;
+  }
+}
+```

docs/1066.md

@@ -1,4 +1,19 @@
 ---
 title: "In ambient enum declarations member initializer must be constant expression."
 category: error
+tags:
+- typescript
+- enum
+- initializer
 ---
+
+While valid in `.ts` files, using a variable as an enum initializer is not
+allowed in type declaration files (`.d.ts`):
+
+```ts
+declare const aVal = 1;
+
+export enum A {
+  a = aVal;
+}
+```

docs/1066_fix_01.md

@@ -0,0 +1,13 @@
+---
+title: "Use a const value initializer."
+---
+
+Move the value into the `enum`:
+
+```ts
+declare const aVal = 1;
+
+export enum A {
+  a = 1; /* aVal */
+}
+```

docs/1068.md

@@ -1,4 +1,15 @@
 ---
 title: "Unexpected token. A constructor, method, accessor, or property was expected."
 category: error
+tags:
+- syntax-error
 ---
+
+This error indicates that your syntax is incorrect. You likely have an
+additional keyword which is unnecessary:
+
+```ts
+class A {
+  function method() {}
+}
+```

docs/1068_fix_01.md

@@ -0,0 +1,11 @@
+---
+title: "Correct the syntax."
+---
+
+To fix the error, correct the syntax:
+
+```ts
+class A {
+  method() {}
+}
+```

docs/1069.md

@@ -1,4 +1,24 @@
 ---
 title: "Unexpected token. A type parameter name was expected without curly braces."
 category: error
+tags:
+- jsdoc
+- javascript
+- type-parameters
 ---
+
+When using the `@template` tag, the parser looks for code like
+`@template {Constraint} T,U,V`. The names of the generic parameters are not
+included in braces:
+
+```js
+// @ts-check
+
+/**
+ * @template {string} {T}
+ * @param {T} arg
+ */
+function identity(arg) {
+  return arg;
+}
+```

docs/1069_fix_01.md

@@ -0,0 +1,17 @@
+---
+title: "Remove braces from generic name."
+---
+
+Remove the braces from the names of the generic parameters:
+
+```js
+// @ts-check
+
+/**
+ * @template {string} T
+ * @param {T} arg
+ */
+function identity(arg) {
+  return arg;
+}
+```

docs/1070.md

@@ -1,4 +1,20 @@
 ---
 title: "'{0}' modifier cannot appear on a type member."
 category: error
+tags:
+- types
+- typescript-only
+- modifiers
 ---
+
+When defining a type, no modifiers (except `readonly`) can be applied to its
+type members:
+
+```ts
+interface A {
+  async a(): Promise<string>;
+  public b(): string;
+  private c(): string;
+  protected d(): string;
+}
+```

docs/1070_fix_01.md

@@ -0,0 +1,14 @@
+---
+title: "Remove the modifier."
+---
+
+Remove the modifiers:
+
+```ts
+interface A {
+  a(): Promise<string>;
+  b(): string;
+  c(): string;
+  d(): string;
+}
+```

docs/1071.md

@@ -1,4 +1,17 @@
 ---
 title: "'{0}' modifier cannot appear on an index signature."
 category: error
+tags:
+- types
+- typescript-only
+- modifiers
 ---
+
+When defining a type, no modifiers (except `readonly`) can be applied to its
+index signature:
+
+```ts
+interface A {
+  public [x: string]: string;
+}
+```

docs/1071_fix_01.md

@@ -0,0 +1,11 @@
+---
+title: "Remove the modifier."
+---
+
+Remove the modifiers:
+
+```ts
+interface A {
+  [x: string]: string;
+}
+```

docs/1079.md

@@ -1,4 +1,14 @@
 ---
 title: "A '{0}' modifier cannot be used with an import declaration."
 category: error
+tags:
+- declarations
+- typescript-only
 ---
+
+Whether in a declaration file or a regular TypeScript file, imports are already
+declared, so it doesn't make sense to add the `declare` keyword to the import:
+
+```ts
+declare import * as ts from "typescript";
+```

docs/1079_fix_01.md

@@ -0,0 +1,9 @@
+---
+title: "Remove declare keyword."
+---
+
+Remove the declare keyword:
+
+```ts
+import * as ts from "typescript";
+```

docs/1084.md

@@ -1,4 +1,16 @@
 ---
 title: "Invalid 'reference' directive syntax."
 category: error
+tags:
+- syntax-error
+- typescript-only
+- triple-slash
 ---
+
+When using triple slash references, the tag must contain a `path`, `types`,
+`lib`, or `no-default-lib` key. If the tag does not include any of these keys,
+this error will be reported:
+
+```ts
+/// <reference />
+```

docs/1084_fix_01.md

@@ -0,0 +1,16 @@
+---
+title: "Use a valid reference directive."
+---
+
+To fix the error, complete the tag by adding a valid key:
+
+```ts
+/// <reference path="./some-file" />
+/// <reference types="node" />
+/// <reference lib="es2015" />
+/// <reference no-default-lib="true"/>
+```
+
+Also see
+[Triple-Slash Directives](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html)
+in the TypeScript Handbook.

docs/1085.md

@@ -1,4 +1,26 @@
 ---
 title: "'{0}' modifier cannot appear on a constructor declaration."
 category: error
+tags:
+- constructors
+- modifiers
+- syntax-error
 ---
+
+Some modifiers cannot be applied to class constructors:
+
+```ts
+class A {
+  static constructor()
+  abstract constructor()
+  async constructor()
+  readonly constructor() {}
+}
+```
+
+Static constructor methods cannot be named `constructor` as the `constructor`
+property already exists on objects and refer to the constructor of the object.
+`create` is a common alternative name. Similarly, `async` can be applied to a
+`static` "constructor". Marking a constructor as `abstract` doesn't make sense
+since `abstract` only refers to members of the instance of a class. Constructors
+cannot be assigned to, so `readonly` doesn't make sense.

docs/1089.md

@@ -0,0 +1,15 @@
+---
+type: "Remove the constructor modifier."
+---
+
+Remove the constructor modifier:
+
+```ts
+class A {
+  static create(): A;
+
+  static async createAsync(): Promise<A>;
+
+  constructor() {}
+}
+```

docs/1089_fix_01.md

@@ -1,4 +1,19 @@
 ---
 title: "'{0}' modifier cannot appear on a parameter."
 category: error
+tags:
+- constructors
+- parameters
+- modifiers
+- syntax-error
 ---
+
+Some modifiers can be added to constructor parameters in order to automatically
+declare the parameter as an element of the class. If you try to use an invalid
+modifier, this error will occur:
+
+```ts
+class A {
+  constructor(static param: string) {}
+}
+```

docs/1090.md

@@ -0,0 +1,16 @@
+---
+title: "Refactor code to remove modifier."
+---
+
+Replace the modifier with the explicit code you were hoping TypeScript would
+generate.
+
+```ts
+class A {
+  static param: string = "";
+
+  constructor(param: string) {
+    A.param = param;
+  }
+}
+```