@realsee/five 5.0.0-alpha.100

package/sticker/index.d.ts

@@ -0,0 +1,70 @@
+import * as THREE_2 from 'three';
+
+/**
+ * 焦点
+ * @description
+ * 可以传入 THREE.Intersection 可以是 Five 的 Intersection
+ */
+export declare interface IntersectionLike {
+    /** 焦点坐标 */
+    point: THREE_2.Vector3;
+    /** 焦点面片 */
+    face?: {
+        normal: THREE_2.Vector3;
+    } | null;
+}
+
+/**
+ * 贴纸
+ */
+export declare class Sticker extends THREE_2.Mesh<THREE_2.BufferGeometry, THREE_2.MeshBasicMaterial> {
+    private _needsRender;
+    /**
+     * 贴纸
+     * @description
+     * 默认加载时, 透明图根据图片类型，如果是 png 默认透明，其他为不透明，且不支持 gif 动画。
+     * @param width - 贴纸长
+     * @param height - 贴纸宽
+     * @param resource - 贴纸图片地址 或者 image / canvas / video 标签
+     *
+     * @example
+     * ```
+     * const resource = "http://vrlab-public.ljcdn.com/release/static/image/release/five/demo/sticker/kagami.jpg";
+     * five.on("wantsTapGesture", raycaster => {
+     *   const [intersection] = five.model.intersectRaycaster(raycaster);
+     *   if (intersection) {
+     *     const sticker = new Sticker(1, 1, resource);
+     *     five.scene.add(sticker);
+     *     sticker.locationWithIntersection(intersection);
+     *   }
+     *   return false;
+     * });
+     * ```
+     */
+    constructor(width: number, height: number, resource: string | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement);
+    get needsRender(): boolean;
+    set needsRender(value: boolean);
+    /**
+     * 设置贴纸大小
+     * @param width - 贴纸长
+     * @param height - 贴纸宽
+     */
+    setSize(width: number, height: number): void;
+    /**
+     * 设置贴纸背景是否透明
+     * @param transparent - 是否透明
+     */
+    setTransparent(transparent: boolean): void;
+    /**
+     * 通过焦点快捷设置贴纸位置
+     * @param intersection - 焦点
+     * @param offset - 位置值（已通过焦点面的法线位移一定值，防止重叠）
+     */
+    locationWithIntersection(intersection: IntersectionLike, offset?: number): void;
+    /**
+     * 资源回收
+     */
+    dispose(): void;
+}
+
+export { }

package/sticker/index.js

@@ -0,0 +1,260 @@
+/**
+ * @realsee/five
+ *
+ * Generated: 2022-02-22
+ * Version: 5.0.0-alpha.100
+ *
+ * Terms:
+ * Realsee SDK License Agreement
+ *
+ * Update: July 28, 2021
+ *
+ * THIS LICENSE AGREEMENT BETWEEN YOU AND 【BEIKE REALSEE TECHNOLOGY (HK)
+ * LIMITED】(“Realsee”) FORMS A LEGALLY BINDING CONTRACT BETWEEN YOU AND REALSEE IN
+ * RELATION TO YOUR USE OF THE SDK. This License Agreement accompanies the Realsee
+ * Software Development Kit(s) for the software and related explanatory materials
+ * (the "SDK") and includes any upgrades, modified versions, updates, additions,
+ * and copies of the SDK licensed to You by Realsee.
+ * BY DOWNLOADING, INSTALLING, OR OTHERWISE ACCESSING OR USING THE SDK, YOU AGREE
+ * THAT YOU HAVE READ, UNDERSTOOD, AND AGREE TO BE BOUND BY THIS AGREEMENT. YOU ARE
+ * AGREEING ON YOUR OWN BEHALF AND/OR ON BEHALF OF YOUR COMPANY OR ORGANIZATION TO
+ * THE TERMS AND CONDITIONS STATED BELOW.
+ * This Agreement applies to Your use of the SDK in the country in which You
+ * legally install it (“Territory”) and is subject to the laws of such Territory
+ * and further subject to Section 12 below. Different terms, conditions, and
+ * limitations may apply to the use of the SDK in any additional countries.
+ * 1. DEFINITIONS.
+ * “Agreement” means this Realsee SDK License Agreement.
+ * “Developer”, “You” and “Your” means the person(s) or entity acquiring or using
+ * the SDK or otherwise exercising rights under the terms of this Agreement.
+ * “Documentation” means the technical or other specifications or documentation
+ * that Realsee may provide to You for use in connection with the SDK.
+ * “Integrated Product” means any software, website, or on-line service developed
+ * by You based on or using the SDK (collectively, the “Integrated Product”).
+ * “Intellectual Property” means any patents, patent rights, trademarks, service
+ * marks, registered and unregistered designs, applications for any of the
+ * foregoing, copyright, and any other similar protected rights in any country and
+ * to the extent recognised by any relevant jurisdiction as intellectual property,
+ * trade secrets, know-how and confidential information. Realsee reserves all
+ * rights not expressly granted to You.
+ * “Realsee” means [Beike Realsee Technology (HK) Limited, a company incorporated
+ * and validly existing under the laws of Hong Kong].
+ * “SDK” means the Realsee-proprietary Software Development Kits (SDK) provided
+ * hereunder, includes all development tools (including any compiler and debugger),
+ * application programming interfaces (“APIs”), libraries, binary utilities, header
+ * files, Documentation, content, data, code samples, and other materials provided
+ * to You in connection with this Agreement, whether delivered through a download,
+ * or any other media or form, and is licensed, not sold, to You by Realsee for use
+ * only under the terms of this Agreement. The terms of this Agreement will govern
+ * any updates provided by Realsee that replace and/or supplement the original SDK
+ * delivered to You, unless such update is accompanied by a separate license, in
+ * which case the terms of such license will govern.
+ * 2. LICENSED USES AND RESTRICTIONS.
+ * 2.1 Subject to the restrictions contained in this Section 2, Realsee grants to
+ * You during the term, a limited, non-exclusive, revocable, non-sublicensable,
+ * non-transferable license to install and use the SDK within the Territory only
+ * for the purpose of internal development.
+ * 2.2 Restrictions. You acknowledge and agree that, You shall not, and shall
+ * ensure that Your affiliates, employees, agents, representatives, officers,
+ * representatives, and subcontractors do not (directly or indirectly):
+ * 2.2.1 decompile, reverse engineer, disassemble or attempt to derive the source
+ * code of, those components of the SDK provided in object code form, or any part
+ * thereof;
+ * 2.2.2 remove, alter, or obscure any copyright notice or other proprietary rights
+ * notice on any part of the SDK;
+ * 2.2.3 sell, assign, pledge, rent, lease, lend, upload to or host on any website
+ * or server for use by any third party except You, redistribute, or sublicense the
+ * SDK (or any part thereof), or operate the SDK (or any part thereof) in the
+ * capacity of a service bureau or other hosted services provider, in whole or in
+ * part, nor may You enable others to do so;
+ * 2.2.4 or alter, modify, customize or improve the SDK, or any part thereof;
+ * 2.2.5 use the SDK (or any part thereof) for any illegal purpose, in any manner
+ * that is inconsistent with the terms of this Agreement, or to engage in any
+ * illegal activity;
+ * 2.2.6 use the SDK (or any part thereof) in any manner that may damage the
+ * operation of Realsee’s products or services; or
+ * 2.2.7 use the SDK or any information contained therein or otherwise provided by
+ * Realsee for the purpose of developing, or having developed, any product
+ * competitive with any Realsee product or service, as determined by Realsee in its
+ * sole discretion;
+ * 2.2.8 include any portion of the SDK in Your Developer products.
+ * 2.3 Realsee has the right to impose reasonable conditions such as a reasonable
+ * fee for use of the SDK in Integrated Product in the future.
+ * 2.4 You may make a limited number of copies of the SDK to be used by Your
+ * employees or consultants as provided herein, and not for general business
+ * purposes, and such employees or consultants shall be subject to the obligations
+ * and restrictions in this Agreement.
+ * 2.5 All licenses not expressly granted in this Agreement are reserved and no
+ * other licenses, immunity, or rights, express or implied, are granted by Realsee,
+ * by implication, estoppel, or otherwise.
+ * 3. CONFIDENTIALITY.
+ * The SDK and all source code, Documentation, specifications, engineering details,
+ * and related information pertaining to the SDK, whether in oral, written,
+ * graphic, or electronic form, are and shall remain the confidential and
+ * proprietary information of Realsee or its licensors (collectively, the
+ * “Confidential Information”). You shall (i) disclose Confidential Information to
+ * only those directors and employees (collectively, “Affiliates”) whose duties
+ * justify their need to know such information and who have been clearly informed
+ * of their obligation to maintain the confidential, proprietary, and/or trade
+ * secret status of such Confidential Information; and (ii) use Confidential
+ * Information solely in accordance with the license granted hereunder. In any
+ * event, You and Your Affiliates shall treat Confidential Information as strictly
+ * confidential and shall use the same care to prevent disclosure of such
+ * information as You use with respect to Your own similar confidential and/or
+ * proprietary information, which shall not be less than the care a reasonable
+ * person would use under similar circumstances. All Confidential Information, and
+ * any copies thereof, shall be returned promptly to Realsee upon request. You
+ * shall ensure that Your Affiliates comply with the provisions of this Section 3,
+ * and You shall be liable for any breach of this Section 3 resulting from the act
+ * or omission of any of Your Affiliates. You shall not disclose Confidential
+ * Information to any third party, including, without limitation, any of Your
+ * subcontractors.
+ * 4. PROPRIETARY RIGHTS.
+ * 4.1 As between You and Realsee, Realsee and/or its licensors retain ownership of
+ * all right, title, and interest in, to, and under the SDK, including, without
+ * limitation, all patents, copyrights, trade secrets, trademarks and other
+ * intellectual property and other proprietary rights therein, and reserve all
+ * rights not expressly granted to You.
+ * 4.2 The items contained in the SDK are the intellectual property of Realsee and
+ * its licensors and are protected by PRC copyright and patent law, international
+ * treaty provisions and applicable laws of the country in which it is being used.
+ * You agree to protect all copyright and other ownership interests of Realsee
+ * and/or its licensors in all items in the SDK supplied under this License
+ * Agreement. You agree that all copies of the items in the SDK, reproduced for any
+ * reason by You, contain the same copyright notices, and other proprietary notices
+ * as appropriate, as appear on or in the original items delivered by Realsee in
+ * the SDK. Realsee and/or its licensors retain title and ownership of the items in
+ * the SDK, the media on which it is loaded, and all subsequent copies, regardless
+ * of the form or media in or on which the original and other copies may exist.
+ * Except as stated above, this Agreement does not grant You any rights to patents,
+ * copyrights, trade secrets, trademarks or any other rights in respect to the
+ * items in the SDK.
+ * 5. TERM AND TERMINATION.
+ * 5.1 This Agreement is effective until terminated. Realsee has the right to
+ * terminate this Agreement immediately, without judicial intervention, if You fail
+ * to comply with any term herein. Upon any such termination You must remove all
+ * full and partial copies of the items in the SDK from Your computer and
+ * discontinue the use of the items in the SDK.
+ * 5.2 Realsee may at any time, terminate the Agreement with You if: (A) You have
+ * breached any provision of the Agreement; or (B) Realsee is required to do so by
+ * law; or (C) Realsee decides to no longer provide the SDK or certain parts of the
+ * SDK to users in the country in which You are resident or from which You use the
+ * service, or the provision of the SDK or certain SDK services to You by Realsee
+ * is, in Realsee's sole discretion, no longer legally or commercially viable.
+ * 5.3 When the Agreement comes to an end, all of the legal rights, obligations and
+ * liabilities that You and Realsee have benefited from, been subject to (or which
+ * have accrued over time whilst the Agreement has been in force) or which are
+ * expressed to continue indefinitely, shall be unaffected by this cessation, and
+ * the provisions of Section 3, 4, 6, 7 and 8 shall continue to apply to such
+ * rights, obligations and liabilities indefinitely.
+ * 6. DISCLAIMER OF WARRANTY.
+ * YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT, TO THE EXTENT PERMITTED BY APPLICABLE
+ * LAW, USE OF THE SDK (OR ANY PART THEREOF) IS AT YOUR SOLE RISK AND THAT THE
+ * ENTIRE RISK AS TO SATISFACTORY QUALITY, PERFORMANCE, ACCURACY, AND EFFORT IS
+ * WITH YOU. REALSEE LICENSES THE SDK TO YOU ONLY ON AN "AS-IS" BASIS. REALSEE
+ * MAKES NO REPRESENTATION WITH RESPECT TO THE ADEQUACY OF ANY ITEMS IN THE SDK,
+ * WHETHER OR NOT USED BY YOU IN THE DEVELOPMENT OF INTEGRATED PRODUCT, FOR ANY
+ * PARTICULAR PURPOSE OR WITH RESPECT TO THEIR ADEQUACY TO PRODUCE ANY PARTICULAR
+ * RESULT. REALSEE AND ITS LICENSORS SHALL NOT BE LIABLE FOR LOSS OR DAMAGE ARISING
+ * OUT OF THIS AGREEMENT OR FROM THE DISTRIBUTION OR USE OF INTEGRATED PRODUCT
+ * CONTAINING PORTIONS OF THE SDK. REALSEE AND ITS LICENSORS DISCLAIM ALL
+ * WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED
+ * CONDITIONS OR WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * OR NONINFRINGEMENT OF ANY THIRD PARTY RIGHT IN RESPECT OF THE ITEMS IN THE SDK
+ * OR ANY SERVICES RELATED TO THE SDK.
+ * REALSEE IS UNDER NO OBLIGATION TO PROVIDE ANY SUPPORT UNDER THIS LICENSE
+ * AGREEMENT, INCLUDING UPGRADES OR FUTURE VERSIONS OF THE SDK OR ANY PORTIONS
+ * THEREOF, TO YOU, END USER OR TO ANY OTHER PARTY.
+ * 7. LIMITATION OF LIABILITY.
+ * TO THE EXTENT NOT PROHIBITED BY APPLICABLE LAW, IN NO EVENT WILL REALSEE OR ITS
+ * LICENSORS BE LIABLE FOR ANY DIRECT, INCIDENTAL, SPECIAL, INDIRECT, OR
+ * CONSEQUENTIAL DAMAGES, INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF USE,
+ * LOSS OF BUSINESS, REVENUE, OR PROFITS, LOSS OF OPPORTUNITY (WHETHER DIRECT OR
+ * INDIRECT), CORRUPTION OR LOSS OF DATA, LOSS OF REPUTATION OR SAVINGS, DOWNTIME,
+ * OR DAMAGE TO, LOSS OF OR REPLACEMENT OF DATA OR TRANSACTIONS, COST OF
+ * PROCUREMENT OF SUBSTITUTE SERVICES, BUSINESS INTERRUPTION, OR ANY OTHER
+ * COMMERCIAL DAMAGES OR LOSSES, ARISING OUT OF OR RELATED TO YOUR USE OR INABILITY
+ * TO USE THE SDK (OR ANY PART THEREOF), ANY INTEGRATED PRODUCT, OR ANY THIRD PARTY
+ * SOFTWARE, APPLICATIONS, OR SERVICES IN CONJUNCTION WITH THE SDK (OR ANY PART
+ * THEREOF), HOWEVER CAUSED, REGARDLESS OF THE THEORY OF LIABILITY (CONTRACT, TORT,
+ * OR OTHERWISE) AND EVEN IF REALSEE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+ * DAMAGES. IN NO EVENT WILL REALSEE’S TOTAL LIABILITY TO YOU FOR ALL DAMAGES
+ * EXCEED ONE HUNDRED DOLLARS ($100.00). THE FOREGOING LIMITATIONS WILL APPLY EVEN
+ * IF THE ABOVE STATED REMEDY FAILS OF ITS ESSENTIAL PURPOSE. THE LIMITATIONS
+ * CONTAINED IN SECTIONS 6 AND THIS SECTION 7 ARE A FUNDAMENTAL PART OF THE BASIS
+ * OF REALSEE’S BARGAIN HEREUNDER, AND REALSEE WOULD NOT ENTER INTO THIS AGREEMENT
+ * OR PROVIDE YOU WITH ACCESS TO THE SDK ABSENT SUCH LIMITATIONS.
+ * 8. INDEMNIFICATION.
+ * To the extent permitted by applicable law, You agree to indemnify, defend and
+ * hold harmless Realsee, its affiliates and each of their directors, officers,
+ * employees, independent contractors, and agents (each a “Realsee Indemnified
+ * Party”) from any and all claims, losses, liabilities, damages, expenses, and
+ * costs (including without limitation attorneys’ fees and court costs) incurred by
+ * a Realsee Indemnified Party as a result of: (i) Your non-compliance with any
+ * terms of this Agreement; (ii) Your use of the SDK (or any part thereof); or
+ * (iii) Your use of any Integrated Product, including any claim that Integrated
+ * Product infringes the copyright, trademark, trade secret or other intellectual
+ * property right of a third party.
+ * 9. ACKNOWLEDGEMENTS.
+ * Portions of the SDK may utilize or include third party software and other
+ * copyrighted material. Acknowledgments, licensing terms, and disclaimers for such
+ * material are contained in Documentation for the SDK or may otherwise accompany
+ * such material, and Your use of such materials governed by their respective
+ * terms. In the event of conflict between the terms of this Agreement and an
+ * applicable open source or third party agreement, the open source or third party
+ * agreement will control solely with respect to the open source software or third
+ * party software. Moreover, You shall not subject any items (including not limited
+ * to source code, object code, and any software)  included in the SDK to any open
+ * source license.
+ * 10. NON-BLOCKING OF REALSEE DEVELOPMENT.
+ * You acknowledge that Realsee is currently developing or may develop technologies
+ * and products in the future that have or may have design and/or functionality
+ * similar to Integrated Product that You may develop based on Your license herein.
+ * Nothing in this Agreement shall impair, limit or curtail Realsee's right to
+ * continue with its development, maintenance and/or distribution of Realsee's
+ * technology or products.
+ * 11. GENERAL.
+ * 11.1 Export Control. You may not use or otherwise export or re-export the SDK
+ * (or any part thereof) except as authorized by United States law and the laws of
+ * the jurisdiction(s) in which the SDK (or any part thereof) was obtained. In
+ * particular, but without limitation, the SDK may not be exported or re-exported
+ * (i) into any U.S. embargoed countries or (ii) to anyone on the U.S. Treasury
+ * Department's list of Specially Designated Nationals or the U.S. Department of
+ * Commerce Denied Person's List or Entity List. By using the SDK (or any part
+ * thereof), You represent and warrant that You are not located in any such country
+ * or on any such list.
+ * 11.2 Governing Law. This Agreement and the rights of the parties hereunder shall
+ * be governed by and construed in accordance with the laws of People’s Republic of
+ * China (for purpose of this Agreement, excluding Hong Kong, Taiwan, and Macau),
+ * without reference to its conflict of laws principles. Any dispute, controversy
+ * or claim arising from or in connection with this Agreement, or the breach,
+ * termination or invalidity thereof, shall be submitted to China International
+ * Economic and Trade Arbitration Commission (“CIETAC”) for arbitration in Beijing
+ * which shall be conducted in accordance with the CIETAC's arbitration rules in
+ * effect at the time of applying for arbitration. The arbitral award is final and
+ * binding upon both parties.
+ * 11.3 Severability. If any provision of this Agreement is held by a court of
+ * competent jurisdiction to be unenforceable for any reason, the remaining
+ * provisions hereof will be unaffected and remain in full force and effect.
+ * 11.4. Modifications. Realsee reserves the right, from time to time, with or
+ * without notice to You, to make revisions to this Agreement in our sole and
+ * absolute discretion.  The most current version of this Agreement will supersede
+ * all previous versions and shall be made available on the website where the SDK
+ * is made available, or by such other means as Realsee may determine in its
+ * discretion. Any modified versions of this Agreement hereto shall take effect
+ * from the time that it is made available. You shall be responsible for regularly
+ * checking for notice of any such modifications. You agree that Your continued use
+ * of the SDK constitutes Your agreement to the modified Agreement.
+ * 11.5 Relationship of the Parties. This Agreement will not be construed as
+ * creating an agency, partnership, joint venture, fiduciary duty, or any other
+ * form of legal association between You and Realsee, and You will not represent to
+ * the contrary, whether expressly, by implication, appearance, or otherwise.
+ * 11.6 Entire Agreement; Governing Language. This Agreement constitutes the entire
+ * agreement between You and Realsee with respect to the use of the SDK licensed
+ * hereunder and supersedes all prior understandings regarding such subject matter.
+ * No amendment to or modification of this Agreement will be binding unless in
+ * writing and signed by Realsee. You and Realsee hereto confirm that this
+ * Agreement and all related documents shall be drafted in English.
+ */
+
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("tslib");function t(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(n){if("default"!==n){var r=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,r.get?r:{enumerable:!0,get:function(){return e[n]}})}})),t.default=e,Object.freeze(t)}var n=t(require("three")),r=new Float32Array([-.5,-.5,0,.5,-.5,0,-.5,.5,0,.5,.5,0]),i=new Float32Array([0,0,1,0,0,1,1,1]),a=new Uint8Array([0,1,2,1,3,2]),o=new n.BufferGeometry;o.setAttribute("position",new n.BufferAttribute(r,3)),o.setAttribute("uv",new n.BufferAttribute(i,2)),o.setIndex(new n.BufferAttribute(a,1));var s=window,u=s.requestAnimationFrame||s.mozRequestAnimationFrame||s.webkitRequestAnimationFrame||s.msRequestAnimationFrame||function(e){return setTimeout(e,16)},d="undefined"!=typeof performance&&void 0!==performance.timing?performance.timing.navigationStart:Date.now(),p="undefined"!=typeof performance?function(){return d+performance.now()}:function(){return Date.now()};function c(e,t){var n=e.dispose;e.dispose=function(){t(),n.call(e)}}var f=function(t){function r(e,r,i){var a,s,d,f,m,l,v=this,g=new n.MeshBasicMaterial;if((v=t.call(this,o,g)||this)._needsRender=!1,v.scale.set(e,r,1),"string"==typeof i){g.transparent=/\.png$/.test(i);var h=new Image;h.src=i,h.crossOrigin="",i=h}if(i instanceof HTMLImageElement){var w=g.map=new n.Texture;w.wrapS=n.ClampToEdgeWrapping,w.wrapT=n.ClampToEdgeWrapping,w.minFilter=n.LinearFilter,w.encoding=n.sRGBEncoding,c(w,function(e,t){e.naturalWidth>0&&u((function(){return t()}));var n=function(){return t()};return e.addEventListener("load",n,!1),function(){return e.removeEventListener("load",n,!1)}}(i,(function(){w.image=i,w.needsUpdate=!0,v._needsRender=!0})))}else if(i instanceof HTMLCanvasElement)g.map=new n.CanvasTexture(i);else if(i instanceof HTMLVideoElement){var y=g.map=new n.VideoTexture(i);y.wrapS=n.ClampToEdgeWrapping,y.wrapT=n.ClampToEdgeWrapping,y.minFilter=n.LinearFilter,y.encoding=n.sRGBEncoding,c(y,(a=i,s=function(){v._needsRender=!0},d=p(),f=!1,m=function(){f=!0,s(),p()-d<3e3?u(m):f=!1},l=function(){d=p(),!1===f&&m()},a.addEventListener("timeupdate",l,!1),function(){a.removeEventListener("timeupdate",l,!1),f=!1}))}return v}return e.__extends(r,t),Object.defineProperty(r.prototype,"needsRender",{get:function(){return this._needsRender},set:function(e){this._needsRender=e,!0===e&&this.material.map&&(this.material.map.needsUpdate=!0)},enumerable:!1,configurable:!0}),r.prototype.setSize=function(e,t){this.scale.set(e,t,1),this._needsRender=!0},r.prototype.setTransparent=function(e){this.material.transparent=e,this._needsRender=!0},r.prototype.locationWithIntersection=function(e,t){void 0===t&&(t=.005);var n=e.point,r=e.face;this.position.copy(n),r&&(this.position.add(r.normal.clone().setLength(t)),this.lookAt(n.clone().add(r.normal))),this._needsRender=!0},r.prototype.dispose=function(){var e;null===(e=this.material.map)||void 0===e||e.dispose(),this.material.dispose()},r}(n.Mesh);exports.Sticker=f;

package/templates/plugin/README.md

@@ -0,0 +1,38 @@
+# Five React 组件: a-five-react-component
+
+> 这是一个 Five 的组件。
+> 这个插件的用途是什么。
+> 能干什么。为什么要使用这组件。
+
+## 参数 / 返回
+
+参数:
+```typescript
+type ParameterType = {
+  parameter1: number,
+  parameter2: string,
+};
+```
+
+返回:
+```typescript
+type ExportType = void;
+```
+
+
+## 如何使用
+
+```typescript
+import { Five } from "@realse/five";
+import { AFivePlugin, FivePluginInit } from "a-five-plugin";
+
+const five = new Five({
+  plugins: [
+    [AFivePlugin, null, {
+      parameter1: 123,
+      parameter2: "abc",
+      parameter3: [new THREE.Vector3(1, 2, 3)],
+    }] as FivePluginInit<typeof AFivePlugin>,
+  ]
+});
+```

package/templates/plugin/devtools/external-five.js

@@ -0,0 +1,5 @@
+if (!('Five' in window)) {
+  throw new Error( '"Five" is not available. Please include "five.js" into your HTML.' );
+}
+
+module.exports = window.Five;

package/templates/plugin/devtools/external-three.js

@@ -0,0 +1,5 @@
+if (!('THREE' in window)) {
+  throw new Error( '"THREE" is not available. "Five" requires it. Please include "THREE.js" into your HTML.' );
+}
+
+module.exports = window.THREE;

package/templates/plugin/devtools/tsconfig.build.json

@@ -0,0 +1,18 @@
+{
+  "include": [
+    "../lib/**/*.ts"
+  ],
+  "compilerOptions": {
+    "target": "ES5",
+    "module": "CommonJS",
+    "declaration": true,
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "moduleResolution": "node",
+    "sourceMap": true,
+    "allowJs": true,
+    "rootDir": "../lib",
+    "outDir": "../build",
+    "skipLibCheck": true
+  }
+}

package/templates/plugin/devtools/webpack.bundle.js

@@ -0,0 +1,44 @@
+const path = require("path");
+const { NormalModuleReplacementPlugin } = require("webpack");
+
+const name = require("../package.json").name.split("/").pop();
+const libraryName = name.replace(/(^|\-)\w/g, char => char[char.length - 1].toUpperCase());
+
+module.exports = {
+  context: path.join(__dirname, "lib"),
+  entry: {
+    [name]: path.join(__dirname, '../lib/index.ts'),
+  },
+  output: {
+    path: path.join(__dirname, "../bundles"),
+    filename: "[name].js",
+    library: libraryName,
+    libraryTarget: "umd",
+    libraryExport: libraryName
+  },
+  mode: "production",
+  devtool: "source-map",
+  module: {
+    rules: [{
+      test: /\.ts$/i,
+      exclude: /node_modules/,
+      use: [{
+        loader: "ts-loader",
+        options: {
+          configFile: path.join(__dirname, "tsconfig.build.json"),
+          compilerOptions: {
+            "declaration": false,
+            "sourceMap": true,
+          }
+        },
+      }]
+    }],
+  },
+  plugins: [
+    new NormalModuleReplacementPlugin(/^three$/, path.join(__dirname, 'external-three.js')),
+    new NormalModuleReplacementPlugin(/^\@realsee\/five$/, path.join(__dirname, 'external-five.js')),
+  ],
+  resolve: {
+    extensions: [".js", ".jsx", ".ts", ".json"],
+  }
+}

package/templates/plugin/devtools/webpack.example.js

@@ -0,0 +1,39 @@
+const path = require("path");
+const glob = require("glob");
+
+module.exports = {
+  context: path.join(__dirname, "../examples"),
+  entry: () => {
+    const list = glob.sync("**/index.ts", { cwd: path.join(__dirname, "../examples") });
+    const entry = {}
+    list.map(filename => {
+      const name = filename.replace(/\.ts$/i, '');
+      entry[name] = './' + filename;
+    })
+    return entry;
+  },
+  output: {
+    path: path.join(__dirname, "../examples"),
+    filename: "[name].bundle.js"
+  },
+  mode: "development",
+  devtool: "eval-cheap-source-map",
+  module: {
+    rules: [{
+      test: /\.ts$/i,
+      exclude: /node_modules/,
+      use: [{
+        loader: "ts-loader",
+        options: {
+          compilerOptions: {
+            "declaration": false,
+            "sourceMap": true,
+          }
+        },
+      }]
+    }]
+  },
+  resolve: {
+    extensions: [".js", ".jsx", ".ts", ".json"],
+  }
+};