Examples: Deprecate examples/js.

docs/manual/en/introduction/Import-via-modules.html

@@ -66,8 +66,8 @@ <h2>Importable Examples</h2>
 		<p>
 			The core of three.js is focused on the most important components of a 3D engine. Many other components like loaders or controls are part of the
 			examples directory. three.js ensures that these files are kept in sync with the core but users have to import them separately if they are required
-			for a project. You can find in the [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm] directory an ES6
-			module version for almost all example files. If you install three.js via npm, you can import them like so:
+			for a project. You can find them in the [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm] directory. If you install three.js
+			via npm, import example files like so:
 		</p>
 		<code>
 		import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
@@ -77,5 +77,10 @@ <h2>Importable Examples</h2>
 			your three.js main file. For example, it's not acceptable to use *GLTFLoader* and *OrbitControls* from R96 together
 			with three.js R103.
 		</p>
+		<p>
+			As of THREE R117, the *examples/js* directory will not be available anymore. That means it's no longer possible to import examples files via
+			*require()* (CommonJS). Besides, it's no longer possible to include example files with the *script* tag into HTML files. The only way of importing
+			example files is via ES6 import statements.
+		</p>
 	</body>
 </html>

docs/manual/en/introduction/Loading-3D-models.html

@@ -81,19 +81,10 @@ <h2>Loading</h2>
 
 	<p>
 		Only a few loaders (e.g. [page:ObjectLoader]) are included by default with
-		three.js — others should be added to your page individually. Depending on your
-		preference and comfort with build tools, choose one of the following:
+		three.js — others should be added to your app individually.
 	</p>
 
 	<code>
-		// global script
-		&lt;script src="GLTFLoader.js"&gt;&lt;/script&gt;
-
-		// commonjs
-		var THREE = window.THREE = require('three');
-		require('three/examples/js/loaders/GLTFLoader');
-
-		// ES modules
 		import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader';
 	</code>
 

docs/manual/zh/introduction/Import-via-modules.html

@@ -64,10 +64,10 @@ <h2>导入这个模块</h2>
 
 		<h2>可引入的示例</h2>
 		<p>
-			three.js的核心专注于实现3D引擎中最为重要的组件。其他诸如加载器和控制器等组件，是示例文件夹中的一部分。
-			three.js确保这些文件能够与核心保持同步，但如果在一个项目中这些组件是必要的，用户将必须分别地引入它们。
-			你可以在[link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm]文件夹中找到所有示例文件的ES6版本。
-			如果你是通过npm来安装three.js的，那么你可以使用类似下面的代码来引入它们：
+			The core of three.js is focused on the most important components of a 3D engine. Many other components like loaders or controls are part of the
+			examples directory. three.js ensures that these files are kept in sync with the core but users have to import them separately if they are required
+			for a project. You can find them in the [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm] directory. If you install three.js
+			via npm, import example files like so:
 		</p>
 		<code>
 		import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
@@ -76,5 +76,10 @@ <h2>可引入的示例</h2>
 			请注意：当你在使用来自示例（examples）文件夹中的代码时，其中的所有文件和你的three.js主文件版本相匹配是很重要的。
 			比如说，three.js的R103版本不能够接受和来自R96版本的*GLTFLoader*和*OrbitControls*一起使用。
 		</p>
+		<p>
+			As of THREE R117, the *examples/js* directory will not be available anymore. That means it's no longer possible to import examples files via
+			*require()* (CommonJS). Besides, it's no longer possible to include example files with the *script* tag into HTML files. The only way of importing
+			example files is via ES6 import statements.
+		</p>
 	</body>
 </html>

docs/manual/zh/introduction/Loading-3D-models.html

@@ -70,18 +70,11 @@ <h2>推荐的工作流程</h2>
 	<h2>加载</h2>
 
 	<p>
-		three.js中默认仅包含了几个加载器（例如：[page:ObjectLoader]）——其它加载器需要你分别地添加到页面中。
-		取决于你对构建工具的偏好，选择以下任意一种方式：
+		Only a few loaders (e.g. [page:ObjectLoader]) are included by default with
+		three.js — others should be added to your app individually.
 	</p>
 
 	<code>
-		// global script
-		&lt;script src="GLTFLoader.js"&gt;&lt;/script&gt;
-
-		// commonjs
-		var THREE = window.THREE = require('three');
-		require('three/examples/js/loaders/GLTFLoader');
-
 		// ES modules
 		import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader';
 	</code>

examples/js/WebGL.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.WebGL: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author alteredq / http://alteredqualia.com/
  * @author mrdoob / http://mrdoob.com/

examples/js/animation/AnimationClipCreator.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.AnimationClipCreator: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  *
  * Creator of typical test AnimationClips / KeyframeTracks

examples/js/animation/CCDIKSolver.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.CCDIKSolver: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahiro / https://github.com/takahirox
  *

examples/js/animation/MMDAnimationHelper.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.MMDAnimationHelper: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahiro / https://github.com/takahirox
  *

examples/js/animation/MMDPhysics.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.MMDPhysics: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahiro / https://github.com/takahirox
  *

examples/js/animation/TimelinerController.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.TimelinerController: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * Controller class for the Timeliner GUI.
  *

examples/js/cameras/CinematicCamera.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.CinematicCamera: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author greggman / http://games.greggman.com/

examples/js/controls/DeviceOrientationControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.DeviceOrientationControls: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author richt / http://richt.me
  * @author WestLangley / https://github.com/WestLangley

examples/js/controls/DragControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.DragControls: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author zz85 / https://github.com/zz85
  * @author mrdoob / http://mrdoob.com

examples/js/controls/FirstPersonControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.FirstPersonControls: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author alteredq / http://alteredqualia.com/

examples/js/controls/FlyControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.FlyControls: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author James Baicoianu / http://www.baicoianu.com/
  */

examples/js/controls/OrbitControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.OrbitControls: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author qiao / https://github.com/qiao
  * @author mrdoob / http://mrdoob.com

examples/js/controls/PointerLockControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.PointerLockControls: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author Mugen87 / https://github.com/Mugen87

examples/js/controls/TrackballControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.TrackballControls: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Eberhard Graether / http://egraether.com/
  * @author Mark Lundin 	/ http://mark-lundin.com

examples/js/controls/TransformControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.TransformControls: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author arodic / https://github.com/arodic
  */

examples/js/curves/CurveExtras.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.CurveExtras: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * A bunch of parametric curves
  * @author zz85

examples/js/curves/NURBSCurve.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.NURBSCurve: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author renej
  * NURBS curve object

examples/js/curves/NURBSSurface.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.NURBSSurface: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author renej
  * NURBS surface object

examples/js/curves/NURBSUtils.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.NURBSUtils: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author renej
  * NURBS utils

examples/js/effects/AnaglyphEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.AnaglyphEffect: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author marklundin / http://mark-lundin.com/

examples/js/effects/AsciiEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.AsciiEffect: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author zz85 / https://github.com/zz85
  *

examples/js/effects/OutlineEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.OutlineEffect: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahirox / https://github.com/takahirox/
  *

examples/js/effects/ParallaxBarrierEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.ParallaxBarrierEffect: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author marklundin / http://mark-lundin.com/

examples/js/effects/PeppersGhostEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.PeppersGhostEffect: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * Created by tpowellmeto on 29/10/2015.
  *

examples/js/effects/StereoEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.StereoEffect: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author alteredq / http://alteredqualia.com/
  * @authod mrdoob / http://mrdoob.com/

examples/js/exporters/ColladaExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.ColladaExporter: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Garrett Johnson / http://gkjohnson.github.io/
  * https://github.com/gkjohnson/collada-exporter-js

examples/js/exporters/DRACOExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.DRACOExporter: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * Export draco compressed files from threejs geometry objects.
  *

examples/js/exporters/GLTFExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.GLTFExporter: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author fernandojsg / http://fernandojsg.com
  * @author Don McCurdy / https://www.donmccurdy.com

examples/js/exporters/MMDExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.MMDExporter: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahiro / https://github.com/takahirox
  *

examples/js/exporters/OBJExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.OBJExporter: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  */

examples/js/exporters/PLYExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.PLYExporter: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Garrett Johnson / http://gkjohnson.github.io/
  * https://github.com/gkjohnson/ply-exporter-js

examples/js/exporters/STLExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.STLExporter: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author kovacsv / http://kovacsv.hu/
  * @author mrdoob / http://mrdoob.com/

examples/js/exporters/TypedGeometryExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.TypedGeometryExporter: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  */

examples/js/geometries/BoxLineGeometry.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.BoxLineGeometry: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  */

examples/js/geometries/ConvexGeometry.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.ConvexGeometry: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Mugen87 / https://github.com/Mugen87
  */

examples/js/geometries/DecalGeometry.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.DecalGeometry: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Mugen87 / https://github.com/Mugen87
  * @author spite / https://github.com/spite

examples/js/geometries/LightningStrike.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.LightningStrike: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author yomboprime https://github.com/yomboprime
  *

examples/js/geometries/ParametricGeometries.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.ParametricGeometries: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author zz85
  *

examples/js/geometries/TeapotBufferGeometry.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.TeapotBufferGeometry: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Eric Haines / http://erichaines.com/
  *

examples/js/interactive/SelectionBox.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.SelectionBox: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author HypnosNova / https://www.threejs.org.cn/gallery
  * This is a class to check whether objects are in a selection area in 3D space

examples/js/interactive/SelectionHelper.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.SelectionHelper: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author HypnosNova / https://www.threejs.org.cn/gallery
  */

examples/js/lights/LightProbeGenerator.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.LightProbeGenerator: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author WestLangley / https://github.com/WestLangley
  */

examples/js/lines/Line2.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.Line2: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author WestLangley / https://github.com/WestLangley
  *

examples/js/lines/LineGeometry.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.LineGeometry: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author WestLangley / https://github.com/WestLangley
  *

examples/js/lines/LineMaterial.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.LineMaterial: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author WestLangley / https://github.com/WestLangley
  *

examples/js/lines/LineSegments2.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.LineSegments2: This file is deprecated and will be removed with R117. Please use the ES6 module version instead. More information in https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author WestLangley / https://github.com/WestLangley
  *