完成小节：三斜线指令

xcatliu · xcatliu · commit 8d157e1e587d · 2019-05-14T15:50:17.000+08:00
diff --git a/basics/declaration-files.md b/basics/declaration-files.md
diff --git a/examples/declaration-files/04-declare-const-jquery/src/index.ts b/examples/declaration-files/04-declare-const-jquery/src/index.ts
@@ -1,4 +1,4 @@
-declare const jQuery: (selector: string) => any;
+// src/index.ts
 
 jQuery('#foo');
 // 使用 declare const 定义的 jQuery 类型，禁止修改这个全局变量
diff --git a/examples/declaration-files/04-declare-const-jquery/src/jQuery.d.ts b/examples/declaration-files/04-declare-const-jquery/src/jQuery.d.ts
@@ -0,0 +1,3 @@
+// src/jQuery.d.ts
+
+declare const jQuery: (selector: string) => any;
diff --git a/examples/declaration-files/05-declare-jquery-value/src/jQuery.d.ts b/examples/declaration-files/05-declare-jquery-value/src/jQuery.d.ts
diff --git a/examples/declaration-files/06-declare-function/src/index.ts b/examples/declaration-files/06-declare-function/src/index.ts
@@ -1,5 +1,4 @@
-declare function jQuery(selector: string): any;
-declare function jQuery(domReadyCallback: () => any): any;
+// src/index.ts
 
 jQuery('#foo');
 jQuery(function() {
diff --git a/examples/declaration-files/06-declare-function/src/jQuery.d.ts b/examples/declaration-files/06-declare-function/src/jQuery.d.ts
@@ -0,0 +1,4 @@
+// src/jQuery.d.ts
+
+declare function jQuery(selector: string): any;
+declare function jQuery(domReadyCallback: () => any): any;
diff --git a/examples/declaration-files/07-declare-class/src/Animal.d.ts b/examples/declaration-files/07-declare-class/src/Animal.d.ts
@@ -0,0 +1,7 @@
+// src/Animal.d.ts
+
+declare class Animal {
+    name: string;
+    constructor(name: string);
+    sayHi(): string;
+}
diff --git a/examples/declaration-files/07-declare-class/src/index.ts b/examples/declaration-files/07-declare-class/src/index.ts
@@ -1,8 +1,3 @@
-declare class Animal {
-    name: string;
-    constructor(name: string);
-    sayHi() {
-        return `My name is ${this.name}`;
-    }
-    // ERROR: An implementation cannot be declared in ambient contexts.
-}
+// src/index.ts
+
+let cat = new Animal('Tom');
diff --git a/examples/declaration-files/08-declare-enum/src/Directions.d.ts b/examples/declaration-files/08-declare-enum/src/Directions.d.ts
@@ -0,0 +1,8 @@
+// src/Directions.d.ts
+
+declare enum Directions {
+    Up,
+    Down,
+    Left,
+    Right
+}
diff --git a/examples/declaration-files/08-declare-enum/src/index.ts b/examples/declaration-files/08-declare-enum/src/index.ts
@@ -1,8 +1,3 @@
-declare enum Directions {
-    Up,
-    Down,
-    Left,
-    Right
-}
+// src/index.ts
 
 let directions = [Directions.Up, Directions.Down, Directions.Left, Directions.Right];
diff --git a/examples/declaration-files/09-declare-namespace/src/index.ts b/examples/declaration-files/09-declare-namespace/src/index.ts
@@ -1,13 +1,4 @@
-declare namespace jQuery {
-    function ajax(url: string, settings?: any): void;
-    const version: number;
-    class Event {
-        blur(eventType: EventType): void;
-    }
-    enum EventType {
-        CustomClick
-    }
-}
+// src/index.ts
 
 jQuery.ajax('/api/get_something');
 console.log(jQuery.version);
diff --git a/examples/declaration-files/09-declare-namespace/src/jQuery.d.ts b/examples/declaration-files/09-declare-namespace/src/jQuery.d.ts
@@ -0,0 +1,12 @@
+// src/jQuery.d.ts
+
+declare namespace jQuery {
+    function ajax(url: string, settings?: any): void;
+    const version: number;
+    class Event {
+        blur(eventType: EventType): void;
+    }
+    enum EventType {
+        CustomClick
+    }
+}
diff --git a/examples/declaration-files/10-declare-namespace-nesting/src/index.ts b/examples/declaration-files/10-declare-namespace-nesting/src/index.ts
@@ -1,9 +1,4 @@
-declare namespace jQuery {
-    function ajax(url: string, settings?: any): void;
-    namespace fn {
-        function extend(object: any): void;
-    }
-}
+// src/index.ts
 
 jQuery.ajax('/api/get_something');
 jQuery.fn.extend({
diff --git a/examples/declaration-files/10-declare-namespace-nesting/src/jQuery.d.ts b/examples/declaration-files/10-declare-namespace-nesting/src/jQuery.d.ts
@@ -0,0 +1,8 @@
+// src/jQuery.d.ts
+
+declare namespace jQuery {
+    function ajax(url: string, settings?: any): void;
+    namespace fn {
+        function extend(object: any): void;
+    }
+}
diff --git a/examples/declaration-files/11-declare-namespace-dot/src/index.ts b/examples/declaration-files/11-declare-namespace-dot/src/index.ts
@@ -1,6 +1,4 @@
-declare namespace jQuery.fn {
-    function extend(object: any): void;
-}
+// src/index.ts
 
 jQuery.fn.extend({
     check: function() {
diff --git a/examples/declaration-files/11-declare-namespace-dot/src/jQuery.d.ts b/examples/declaration-files/11-declare-namespace-dot/src/jQuery.d.ts
@@ -0,0 +1,5 @@
+// src/jQuery.d.ts
+
+declare namespace jQuery.fn {
+    function extend(object: any): void;
+}
diff --git a/examples/declaration-files/14-declaration-merging/src/index.ts b/examples/declaration-files/14-declaration-merging/src/index.ts
@@ -1,7 +1,4 @@
-declare function jQuery(selector: string): any;
-declare namespace jQuery {
-    function ajax(url: string, settings?: any): void;
-}
+// src/index.ts
 
 jQuery('#foo');
 jQuery.ajax('/api/get_something');
diff --git a/examples/declaration-files/14-declaration-merging/src/jQuery.d.ts b/examples/declaration-files/14-declaration-merging/src/jQuery.d.ts
@@ -0,0 +1,6 @@
+// src/jQuery.d.ts
+
+declare function jQuery(selector: string): any;
+declare namespace jQuery {
+    function ajax(url: string, settings?: any): void;
+}
diff --git a/examples/declaration-files/28-triple-slash-directives/package-lock.json b/examples/declaration-files/28-triple-slash-directives/package-lock.json
diff --git a/examples/declaration-files/28-triple-slash-directives/package.json b/examples/declaration-files/28-triple-slash-directives/package.json
@@ -1,5 +1,5 @@
 {
-    "name": "25-declare-global",
+    "name": "24-merge-global-namespace",
     "version": "1.0.0",
     "description": "",
     "main": "index.js",
diff --git a/examples/declaration-files/28-triple-slash-directives/src/index.ts b/examples/declaration-files/28-triple-slash-directives/src/index.ts
@@ -0,0 +1,3 @@
+// src/index.ts
+
+foo({});
diff --git a/examples/declaration-files/28-triple-slash-directives/tsconfig.json b/examples/declaration-files/28-triple-slash-directives/tsconfig.json
@@ -0,0 +1,9 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "baseUrl": "./",
+        "paths": {
+            "*": ["types/*"]
+        }
+    }
+}
diff --git a/examples/declaration-files/28-triple-slash-directives/types/jquery-plugin/index.d.ts b/examples/declaration-files/28-triple-slash-directives/types/jquery-plugin/index.d.ts
@@ -0,0 +1,5 @@
+// types/jquery-plugin/index.d.ts
+
+/// <reference types="jquery" />
+
+declare function foo(options: JQuery.AjaxSettings): string;
diff --git a/examples/declaration-files/29-triple-slash-directives-global/package-lock.json b/examples/declaration-files/29-triple-slash-directives-global/package-lock.json
diff --git a/examples/declaration-files/29-triple-slash-directives-global/package.json b/examples/declaration-files/29-triple-slash-directives-global/package.json
@@ -0,0 +1,15 @@
+{
+    "name": "24-merge-global-namespace",
+    "version": "1.0.0",
+    "description": "",
+    "main": "index.js",
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "author": "",
+    "license": "MIT",
+    "dependencies": {},
+    "devDependencies": {
+        "@types/node": "^12.0.1"
+    }
+}
diff --git a/examples/declaration-files/29-triple-slash-directives-global/src/index.ts b/examples/declaration-files/29-triple-slash-directives-global/src/index.ts
@@ -0,0 +1,5 @@
+// src/index.ts
+
+import { foo } from 'node-plugin';
+
+foo(global.process);
diff --git a/examples/declaration-files/29-triple-slash-directives-global/tsconfig.json b/examples/declaration-files/29-triple-slash-directives-global/tsconfig.json
@@ -0,0 +1,9 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "baseUrl": "./",
+        "paths": {
+            "*": ["types/*"]
+        }
+    }
+}
diff --git a/examples/declaration-files/29-triple-slash-directives-global/types/node-plugin/index.d.ts b/examples/declaration-files/29-triple-slash-directives-global/types/node-plugin/index.d.ts
@@ -0,0 +1,5 @@
+// types/node-plugin/index.d.ts
+
+/// <reference types="node" />
+
+export function foo(p: NodeJS.Process): string;

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-declare const jQuery: (selector: string) => any;`
	`1`	`+// src/index.ts`
`2`	`2`
`3`	`3`	`jQuery('#foo');`
`4`	`4`	`// 使用 declare const 定义的 jQuery 类型，禁止修改这个全局变量`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+// src/jQuery.d.ts`
	`2`	`+`
	`3`	`+declare const jQuery: (selector: string) => any;`
-Original file line number
+Diff line change
@@ @@ -0,0 +1,8 @@ @@
 +// src/Directions.d.ts
++
 +declare enum Directions {
 +    Up,
 +    Down,
 +    Left,
 +    Right
 +}
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "name": "25-declare-global",`
	`2`	`+ "name": "24-merge-global-namespace",`
`3`	`3`	`"version": "1.0.0",`
`4`	`4`	`"description": "",`
`5`	`5`	`"main": "index.js",`