@realsee/dnalogel 3.81.15 → 3.81.16-dev.2

package/CHANGELOG.md

@@ -1,10 +1,11 @@
 # CHANGELOG
+## 3.81.16-dev.1
 
-## 3.81.15
-
-- 测量插件新增 `interactionState` 与 `interactionChange`，通知绘制、长按等待、端点调整和确认／取消状态，供宿主按当前操作更新提示。
-- 提供已完成测量数与当前绘制点数，覆盖选点、撤销、载入、清空和删除后的可用操作。
-- 保持既有手势和数据格式，新增状态转换回归测试。
+- feat(MeasurePluginV2): 新增量尺插件 V2 试点版本，对应 PRD《量尺点位选择器优化》M1 / M2。
+- feat(MeasurePluginV2): 放大镜内叠加落点所在平面的坐标系 —— 绿色 Z 轴 = 平面法线（只画朝外的一半，端点带绿色圆点），红色 X / 蓝色 Y 为平面内两条方向、贯穿落点画整条，轴长固定为放大镜半径 × 0.9。
+- feat(MeasurePluginV2): 绘制落点平面框，法线与最近世界轴夹角小于 15° 时吸附成正四边形，斜面贴合法线；1.5px #FF4D4F、不透明度 90%、只描边不填充。
+- feat(MeasurePluginV2): 与既有 MeasurePlugin 完全独立，通过 `MeasureV2.MeasurePluginV2(five, config)` 接入，不改动原插件的任何行为；`magnifier.setOverlayEnabled(false)` 可关闭叠加层做对比。
+- docs(examples): 新增 MeasurePluginV2 示例页，可在 examples 站点查看放大镜内的坐标轴与平面框效果。
 
 ## 3.81.14
 

package/LICENSE-UPDATE.txt

@@ -0,0 +1,5 @@
+License update for @realsee/dnalogel@3.81.16-dev.2
+
+This release updates the Realsee-authored package license to the Realsee SDK License Agreement, last updated 2026-09-22. The package implementation is unchanged from @realsee/dnalogel@3.81.16-dev.1.
+
+Third-party components, notices and separately licensed materials retain their respective licenses. This update does not change the license of any previously published package version.

package/README.md

@@ -122,13 +122,3 @@ Add the extension to the request.
 - 转动视角：避开测量点，按住画面拖动。
 - 调整测量点：按住测量线一端的圆点不动，等约半秒，再拖到新位置；松开确认。
 - 桌面端按 Esc 取消本次调整。触摸设备沿用长按选点的绘制方式。
-
-
-### 按操作状态更新提示
-
-读取 `measure.interactionState` 初始化 UI，订阅 `measure.on('interactionChange', state => ...)` 后续变化。销毁 UI 前调用订阅返回的取消函数。
-
-- `phase` 为 `idle`、`drawing`、`holding` 或 `editing`，分别表示浏览、绘制、按住端点等待和调整端点。
-- `measurementCount` 为已完成的测量数量；`pointCount` 为正在绘制的点数。
-- 确认或取消调整后回到 `idle`，`result` 分别为 `confirmed` 或 `cancelled`。事件在坐标提交或还原、指针监听清理后发出。
-- 绘制选点、撤销、载入、清空和删除测量都会同步状态，宿主可以据此展示当前可用操作。

package/TERMS.txt

@@ -1,56 +1,119 @@
 Realsee SDK License Agreement
 
-Update: July 28, 2021
+Last updated: 2026-09-22
+
+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.
 
-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.
+
+“Term” means the period commencing on the date You first download, install, access, or use the SDK, and continuing until this Agreement is terminated in accordance with Section 6.
+
 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.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, use, and integrate the SDK within the Territory only for the purpose of developing, testing, operating and supporting Integrated Products. 
+
+2.2 Restrictions. You acknowledge and agree that, You shall not, and shall ensure that Your affiliates, employees, agents, representatives, officers, 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.4 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.2.7 use the SDK or any non-public information provided by Realsee for the primary purpose of developing products or services that substantially replicate the core functionality of Realsee proprietary SDK offerings;
+
+2.2.8 distribute, re-sell, or make available the SDK (or any part thereof) as a standalone product, library, or development toolkit to any third party.
+
 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.
+
+5. DATA PRIVACY AND PROTECTION
+
+5.1 In connection with Your use of the SDK and any Integrated Product, You shall comply with all applicable privacy, data protection, cybersecurity, and cross-border data transfer laws and regulations. To the extent Your use of the SDK involves the collection, processing, transmission, disclosure, or storage of personal data or personal information, You shall be solely responsible for: (i) ensuring that You have a valid legal basis for such processing; (ii) providing all required notices and obtaining all necessary consents or authorisations; and (iii) implementing reasonable and appropriate technical and organisational measures to protect such data against unauthorised access, use, disclosure, alteration, or destruction.
+
+5.2 You shall promptly notify Realsee of any material security incident relating to the SDK or Integrated Product that may materially affect Realsee, the SDK, or any personal data processed in connection with the SDK.
+
+5.3 Developer shall be solely responsible for Developer’s compliance with applicable privacy, data protection, and cybersecurity laws in connection with the Integrated Product.
+
+6. TERM AND TERMINATION.
+
+6.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.
+
+6.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.
+
+6.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 Sections 3, 4, 5, 7, 8, 9, 10, and 11 shall continue to apply to such rights, obligations and liabilities indefinitely.
+
+7. 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.
+
+8. 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 SECTION 7 AND THIS SECTION 8 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.
+
+9. 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.
+
+10. 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.
+
+11. 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.
+
+12. GENERAL.
+
+12.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.
+
+12.2 Governing Law and Dispute Resolution.
+
+This Agreement shall be governed by the laws of the Hong Kong Special Administrative Region of the People's Republic of China, without regard to its conflict of laws principles. Any dispute arising out of or in connection with this Agreement, including its existence, validity, interpretation, performance, breach, or termination, shall first be submitted to thirty (30) days of good faith consultation, and if unresolved, to final and binding arbitration administered by the HKIAC in Hong Kong in English under the HKIAC Administered Arbitration Rules in force at the time of submission, with one (1) arbitrator unless the amount in dispute exceeds USD 1,000,000, in which case three (3) arbitrators shall be appointed. Either party may seek interim or injunctive relief from any court of competent jurisdiction notwithstanding the foregoing.
+
+12.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.
+
+12.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.
+
+12.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.
+
+12.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.

package/dist/MeasurePlugin/Controller.d.ts

@@ -5,17 +5,9 @@ import { MeasureMesh } from './utils/MeasureMesh';
 import { Subscribe } from '../shared-utils/Subscribe';
 import type { MeasurePluginConfig } from '.';
 export type MeasureEndReason = 'enter' | 'escape' | 'polygon' | 'mode_change' | 'pano_move' | 'floor_change' | 'points_insufficient' | 'external';
-/** Current actions available to a measurement UI. */
-export type MeasureInteractionState = Readonly<{
-    phase: 'idle' | 'drawing' | 'holding' | 'editing';
-    measurementCount: number;
-    pointCount: number;
-    result?: 'confirmed' | 'cancelled';
-}>;
 export type MeasurePluginEventMap = {
     measureEnd: (reason: MeasureEndReason, points: THREE.Vector3[]) => void;
     undo: () => void;
-    interactionChange: (state: MeasureInteractionState) => void;
 };
 export declare class MeasureController extends Subscribe<MeasurePluginEventMap> {
     readonly name = "MeasurePlugin";
@@ -29,10 +21,6 @@ export declare class MeasureController extends Subscribe<MeasurePluginEventMap>
     private cleanupRepositioningListeners?;
     private endpointPointerElement?;
     private endpointPressHandlers;
-    private interactionPhase;
-    private interactionResult?;
-    get interactionState(): MeasureInteractionState;
-    private publishInteraction;
     get pointSelector(): PointSelector;
     private _pointSelector;
     private get fiveDomEvents();

package/dist/MeasurePlugin/index.d.ts

@@ -12,6 +12,6 @@ export type MeasurePluginConfig = {
      */
     precision?: number;
 };
-export type { MeasureEndReason, MeasurePluginEventMap, MeasureInteractionState } from './Controller';
+export type { MeasureEndReason, MeasurePluginEventMap } from './Controller';
 export { validatePolygon } from './utils/validatePolygon';
 export declare const MeasurePlugin: (five: Five, config?: MeasurePluginConfig) => MeasureController;

package/dist/MeasurePluginV2/Controller.d.ts

@@ -0,0 +1,20 @@
+import type { Five } from '@realsee/five';
+import { PointSelector } from '../shared-utils';
+import { MeasureController } from '../MeasurePlugin/Controller';
+import type { MeasurePluginConfig } from '../MeasurePlugin';
+import { MeasureMagnifier } from './Magnifier';
+/**
+ * 量尺插件 V2：把放大镜换成带「坐标轴 + 落点平面框」的版本。
+ *
+ * 放大镜是在 PointSelector 的 helper 里创建的，所以这里只覆盖 pointSelector 这个 getter，
+ * 其余选点 / 吸附 / 打点 / 撤销 / 重定位逻辑全部沿用 MeasureController，不改动原插件的任何代码。
+ */
+export declare class MeasureControllerV2 extends MeasureController {
+    private v2Five;
+    private v2PointSelector?;
+    private v2Magnifier?;
+    constructor(five: Five, config?: MeasurePluginConfig);
+    /** V2 的放大镜实例；需要临时关掉叠加层做对比时，可以 magnifier.setOverlayEnabled(false) */
+    get magnifier(): MeasureMagnifier;
+    get pointSelector(): PointSelector;
+}

package/dist/MeasurePluginV2/Magnifier.d.ts

@@ -0,0 +1,36 @@
+import type { Five } from '@realsee/five';
+import { Magnifier, type MagnifierParameter, type PointIntersection } from '../shared-utils';
+export interface MeasureMagnifierOptions extends MagnifierParameter {
+    /** 是否绘制坐标轴 / 平面框叠加层，默认 true（关掉后行为与现状 Magnifier 完全一致） */
+    overlayEnabled?: boolean;
+}
+/**
+ * 量尺 V2 用的放大镜。
+ *
+ * 完全复用 Magnifier 的「读像素 + 放大」逻辑（直接 super.render()），
+ * 只是在其之后往同一个 2D canvas 上叠加坐标轴与落点平面框。
+ */
+export declare class MeasureMagnifier extends Magnifier {
+    /** 父类把 five 存成了 private，这里自己留一份，叠加层投影时要用 */
+    private overlayFive;
+    /** 父类把 context 存成了 private；getContext('2d') 拿到的是同一个实例 */
+    private overlayContext;
+    /** 由 PointSelector 的 intersectionUpdate 事件注入 */
+    private overlayIntersection;
+    private overlayEnabled;
+    constructor(five: Five, options?: MeasureMagnifierOptions);
+    /** 每次交点更新时调用；传 null 表示当前没有命中任何模型 */
+    setIntersection(intersection: PointIntersection | null): void;
+    /** 开关叠加层，用于灰度 / 排查问题 */
+    setOverlayEnabled(enabled: boolean): void;
+    render(): void;
+    private renderOverlay;
+    private getOverlayContext;
+    /**
+     * 还原 Magnifier.render() 内部的取值，用来把世界坐标映射到放大镜 canvas 坐标。
+     * 这些换算必须和父类保持一致，父类改动时需要同步。
+     */
+    private getOverlayViewport;
+    /** 父类的 scale 是 private，只能这样读；它是真值来源，避免自己再维护一份副本 */
+    private getMagnifierScale;
+}

package/dist/MeasurePluginV2/PointOverlay.d.ts

@@ -0,0 +1,66 @@
+import * as THREE from 'three';
+import type { PointIntersection } from '../shared-utils';
+/**
+ * 放大镜内的叠加绘制：坐标轴（PRD M1）+ 落点平面框（PRD M2）
+ *
+ * 为什么画在 2D canvas 上而不是往场景里加 THREE 物体：
+ * 放大镜并不是「再渲染一遍场景」，而是用 five.getPixels() 读一小块像素，翻转后 putImageData 到 2D canvas 上。
+ * 所以场景里加什么物体都不会出现在放大镜里，只有 putImageData 之后在 2D context 上画的才会出现。
+ */
+/** PRD 五、视觉与设计规范 */
+export declare const OVERLAY_STYLE: {
+    /** M1-2 X 轴颜色 */
+    readonly axisXColor: "#EC4A4E";
+    /** M1-2 Y 轴颜色 */
+    readonly axisYColor: "#1677FF";
+    /** M1-2 Z 轴颜色 */
+    readonly axisZColor: "#065C08";
+    /** M1-5 线条宽度 */
+    readonly axisLineWidth: 1.5;
+    /** 轴线不透明度 */
+    readonly axisOpacity: 0.9;
+    /** M1-4 轴线长度 = 放大镜半径 × 0.9 */
+    readonly axisLengthRadiusScale: 0.9;
+    /** Z 轴端点（朝外的一端）绿色圆点半径 = 放大镜半径 × 该系数 */
+    readonly axisTipDotRadiusScale: 0.03;
+    /** M2 平面框边框颜色 */
+    readonly planeBorderColor: "#FF4D4F";
+    /** M2-3 边框宽度 */
+    readonly planeBorderWidth: 1.5;
+    /** M2-3 边框不透明度 */
+    readonly planeBorderOpacity: 0.9;
+    /** M2-2 轴对齐面框边长 = 放大镜半径 × 1.2 */
+    readonly planeSideRadiusScale: 1.2;
+    /** M2 轴对齐判定：表面法线与最近世界轴的夹角小于该值即视为墙 / 地 / 顶 */
+    readonly axisSnapAngle: 15;
+};
+/**
+ * 放大镜把渲染目标上的一块矩形区域拉伸到了 canvas 上，这里描述这块区域以及映射关系。
+ * 字段取值与 Magnifier.render() 内部完全一致，父类改动时需要同步。
+ */
+export interface MagnifierViewport {
+    camera: THREE.Camera;
+    /** 渲染目标尺寸，与 Magnifier.render() 里 getSize() 的结果一致 */
+    renderSize: THREE.Vector2;
+    /** 读取区域左边缘在渲染目标像素坐标系中的横坐标 */
+    readLeft: number;
+    /** 读取区域下边缘的纵坐标（渲染目标像素坐标系 y 轴向上，与 Magnifier.render() 里的同名量一致） */
+    readTop: number;
+    /** 读取区域的高度（渲染目标像素） */
+    readPixelsHeight: number;
+    /** 一个渲染像素在放大镜 canvas 上重复的倍数 */
+    pixelRadio: number;
+    /** 放大镜 canvas 的宽高（设备像素） */
+    canvasWidth: number;
+    canvasHeight: number;
+}
+/**
+ * 求交点的世界坐标系法线。
+ * 点云等拿不到 face 的情况返回 null（此时只画坐标轴，不画平面框）。
+ */
+export declare function getWorldNormal(intersection: PointIntersection): THREE.Vector3 | null;
+/**
+ * 绘制落点叠加层。
+ * 调用时机：Magnifier.render() 里 putImageData 之后。
+ */
+export declare function drawMeasureOverlay(context: CanvasRenderingContext2D, viewport: MagnifierViewport, intersection: PointIntersection): void;

package/dist/MeasurePluginV2/index.d.ts

@@ -0,0 +1,25 @@
+import type { Five } from '@realsee/five';
+import { MeasureControllerV2 } from './Controller';
+/**
+ * 量尺插件 V2 —— 点位选择可视化（对应 PRD《量尺点位选择器优化》）
+ *
+ * 与 MeasurePlugin 的关系：V2 是试点 fork，完全继承 MeasurePlugin 的控制器，
+ * 只在放大镜里多画「坐标轴（M1）+ 落点平面高亮（M2）」，不改动原插件的任何代码、不影响线上既有行为。
+ *
+ * 使用方式（Console / 编辑器等接入方）：
+ * ```ts
+ * import { MeasureV2 } from '@realsee/dnalogel'
+ * const measure = MeasureV2.MeasurePluginV2(five, { unit: 'm' })
+ * ```
+ */
+export { MeasureControllerV2 } from './Controller';
+export { MeasureMagnifier } from './Magnifier';
+export type { MeasureMagnifierOptions } from './Magnifier';
+export { drawMeasureOverlay, getWorldNormal, OVERLAY_STYLE } from './PointOverlay';
+export type { MagnifierViewport } from './PointOverlay';
+export { validatePolygon } from '../MeasurePlugin';
+export type { MeasureEndReason, MeasurePluginConfig, MeasurePluginEventMap } from '../MeasurePlugin';
+export type MeasureControllerV2Interface = InstanceType<typeof MeasureControllerV2>;
+export type MeasurePluginV2ParamsInterface = ConstructorParameters<typeof MeasureControllerV2>[1];
+export declare const MeasurePluginV2: (five: Five, config?: MeasurePluginV2ParamsInterface) => MeasureControllerV2;
+export default MeasurePluginV2;