rhine-var 0.3.2 → 0.4.0

package/README.md

@@ -1,139 +1,149 @@
-<div align="center">
-
-# RHINE-VAR: Simplest and Most Powerful Collaborative Framework
-
-Rhine Variable — A self-synchronizing variable for collaboration.
-Developing collaborative applications has never been this easy.
-
-
-[English](README.md) &nbsp; | &nbsp; [中文](README_zh.md)
-
-<img src='./assets/images/example1.png' style="border-radius: 10px; max-width: 840px"/>
-
-</div>
-
-<br/>
-
-## Why Choose RHINE-VAR ?
-
-### Concise and Efficient Syntax Design
-RhineVar draws inspiration from the design philosophy of the Valtio state management library, significantly reducing the learning curve. Developers can easily manage collaborative data as if they were manipulating regular variables.
-
-### Comprehensive Type Support
-RhineVar offers full type hints and checks, ensuring precise code completion and static analysis during development. This not only improves the development experience but also reduces potential errors, making it especially suitable for TypeScript projects, enhancing code safety and reliability.
-
-### Distributed Real-time Collaboration Algorithm
-The underlying collaboration algorithm of RhineVar is powered by the robust Yjs library. Using the CRDT (Conflict-free Replicated Data Type) algorithm, it ensures eventual consistency even in multi-user and offline environments.
-
-### High Performance with Low Bandwidth Requirements
-The data synchronization and conflict resolution mechanism is highly efficient. Leveraging Yjs's incremental update mechanism, only necessary data changes are transmitted rather than the entire document, making it ideal for bandwidth-constrained environments and reducing unnecessary data transfers.
-
-### Strong Offline Support
-Users can continue to work even while offline. Once reconnected, all changes are automatically synchronized, ensuring no data is lost or conflicted. This is crucial for building offline-first applications.
-
-### Cross-platform and Framework Agnostic
-RhineVar can be used in various environments, including browsers, Node.js, and other JavaScript platforms. It integrates with multiple frontend frameworks and libraries such as Next.js, React, Vue.js, ProseMirror, and more.
-
-### Lightweight and Extensible
-RhineVar is a highly lightweight library, with its core package only a few KB in size, making it suitable for various frontend applications. Its modular architecture supports feature extensions, allowing developers to import or develop custom modules as needed.
-
-### Decentralized Architecture
-With a decentralized architecture, collaborative editing becomes more scalable, efficient, and fault-tolerant. Peer-to-peer data transfer is supported without relying on a central server (currently under development).
-
-### Native Yjs Support
-RhineVar offers full support for native Yjs object operations, providing lower-level, richer API support. Direct operations on Yjs objects automatically trigger updates in RhineVar.
-
-### More Friendly and Complete Event System
-RhineVar offers an extensive event subscription and listening system with intuitive data change events. It also supports deep data change monitoring within objects, catering to a wide range of use cases.
-
-<br/>
-
-## Contact Us
-Welcome to join our WeChat group for communication. We look forward to having more community members participate in the creation of rhine-var.
-
-WeChat: [FNA-04]()
-
-Email: [RhineAILab@gmail.com](rhineailab@gmail.com) & [RhineAI@163.com](RhineAI@163.com)
-
-<br/>
-
-## Install
-```bash
-yarn add rhine-var
-```
-If you don't have `yarn`, you can install it via `npm i rhine-var`, or install `yarn` first using `npm i -g yarn` and then use the command above to install.
-
-<br/>
-
-## Usage
-
-```typescript jsx
-const defaultValue = {value: 0}
-const count = rhineProxy(defaultValue, 'localhost:6600/room-0')
-
-function Counter() {
-  
-  const countSnap = useRhine(count)
-  
-  return <div>
-    <button onClick={() => count.value-- }> - 1 </button>
-    <span>{countSnap.value}</span>
-    <button onClick={() => count.value++ }> + 1 </button>
-  </div>
-}
-```
-### Default Value
-
-When the room does not exist on the server, a default value will be used to create the room. If not connected to the server, data from the default value will also be returned.
-
-### Room ID
-
-The `Same Room ID` manages the `Same State Variables`, and users who join will experience real-time multi-user collaboration.
-
-### rhineProxy
-
-Create a `RhineVariable` that anyone in the room can directly modify, and the value will be synchronized to everyone almost simultaneously.
-
-Its value is `at least an object` in javascript, `but` there is almost no upper limit. It can be an `extremely complex and large JSON structure` to accommodate all the data for a large project.
-
-### useRhine
-
-A hook for use with React. It creates a snapshot of a `RhineVariable`, and whenever someone modifies this value, the information will be `updated on everyone's screen` in real-time.
-
-Use snapshot only when data needs to be displayed on the React page. For other operations, such as modifying values, please use RhineVariable itself.
-
-<br/>
-
-## Server
-We provide a simple server as a reference, located at `/test/server` in this project. The server is fully compatible with all Yjs websocket servers.
-```
-git clone https://github.com/RhineAI-Lab/rhine-var.git
-cd test/server
-yarn install
-yarn start
-```
-It will run on `Port 6600`, and you can connect to it via `ws://localhost:6600/<room-id>`. `<room-id>` can be any text, with each room ID corresponding to a `RhineVariable`.
-
-More information about server develop: [https://docs.yjs.dev/ecosystem/connection-provider/y-websocket](https://docs.yjs.dev/ecosystem/connection-provider/y-websocket)
-
-<br/>
-
-## Develop
-
-```bash
-# start watch and build by typescript
-yarn run watch
-
-# start a easy websocket server
-cd test/server
-yarn install
-yarn start
-
-# start a nextjs playground for develop debug
-cd test/debug/next-app
-yarn install
-yarn start
-# Open http://localhost:3000 in browser
-```
-
-<br/>
+<div align="center">
+
+# RHINE-VAR: Simplest and Powerful CRDT Library
+
+Rhine Variable — A self-synchronizing variable for collaboration.
+Developing collaborative applications has never been this easy.
+
+
+[English](README.md) &nbsp; | &nbsp; [中文](README_zh.md)
+
+<img src='./assets/images/example1.png' style="border-radius: 10px"/>
+
+</div>
+
+<br/>
+
+<br/>
+
+## Why Choose RHINE-VAR ?
+
+### Concise and Efficient Syntax Design
+RhineVar draws inspiration from the design philosophy of the Valtio state management library, `significantly reducing the learning curve`. Allowing developers to handle data seamlessly, as if `working with standard variables`.
+
+### Almost No Size Limit
+There is almost no upper limit. It can be an `Extremely Complex and Large Data Structure` to accommodate all the data for a large project. But at the very least, it is `a JavaScript Object`.
+
+### Comprehensive Type Support
+RhineVar offers full type hints and checks, ensuring `Precise Code Completion` and `Static Analysis` during development. This not only improves the development experience but also reduces potential errors, making it especially `suitable for TypeScript projects`, enhancing code safety and reliability.
+
+### Distributed Real-time Collaboration Algorithm
+The underlying collaboration algorithm of RhineVar is `Powered By the Robust Yjs Library`. Using the CRDT (Conflict-free Replicated Data Type) algorithm, it ensures eventual consistency even in multi-user and offline environments.
+
+### High Performance with Low Bandwidth Requirements
+The data synchronization and conflict resolution mechanism is highly efficient. Leveraging Yjs's `Incremental Update Mechanism`, only necessary data changes are transmitted rather than the entire document, making it ideal for bandwidth-constrained environments and reducing unnecessary data transfers.
+
+### Strong Offline Support
+Users can continue to work even while offline. Once reconnected, all changes are automatically synchronized, ensuring `no data is lost or conflicted`. This is crucial for building offline-first applications.
+
+### Cross-platform and Framework Agnostic
+RhineVar can be used in `All JavaScript Environments`, including browsers, Node.js, and other JavaScript platforms. It integrates with multiple frontend frameworks and libraries such as Next.js, React, Vue.js, ProseMirror, and more.
+
+### Lightweight and Extensible
+RhineVar is a highly lightweight library, with its core package `only a few KB` in size, making it suitable for various frontend applications. Its modular architecture supports feature extensions, allowing developers to import or develop custom modules as needed.
+
+### Decentralized Architecture
+With a decentralized architecture, collaborative editing becomes more scalable, efficient, and fault-tolerant. Peer-to-peer data transfer is supported without relying on a central server (currently under development).
+
+### Native Yjs Support
+RhineVar offers full support for native Yjs object operations, providing lower-level, richer API support. `Direct operations on Yjs objects automatically trigger updates in RhineVar`.
+
+### More Friendly and Complete Event System
+RhineVar offers an extensive event subscription and listening system with `Intuitive Data Change Events`. It also supports deep data change monitoring within objects, catering to a wide range of use cases.
+
+### Fully Open Source
+This is a fully open-source project, licensed under the `Apache-2.0 license` on GitHub. You are `Free to use it for both Commercial and Non-commercial Projects`, and it allows modification and distribution, as long as the original copyright notice is retained.
+
+<br/>
+
+## Contact Us
+Welcome to join our WeChat group for communication. We look forward to having more community members participate in the creation of rhine-var.
+
+WeChat: [FNA-04]()
+
+Email: [RhineAILab@gmail.com](rhineailab@gmail.com) & [RhineAI@163.com](RhineAI@163.com)
+
+<br/>
+
+## Install
+```bash
+yarn add rhine-var
+```
+If you don't have `yarn`, you can install it via `npm i rhine-var`, or install `yarn` first using `npm i -g yarn` and then use the command above to install.
+
+<br/>
+
+## Usage
+
+```typescript jsx
+const defaultValue = {value: 0}
+const count = rhineProxy(defaultValue, 'localhost:6600/room-0')
+
+function Counter() {
+  
+  const countSnap = useRhine(count)
+  
+  return <div>
+    <button onClick={() => count.value-- }> - 1 </button>
+    <span>{countSnap.value}</span>
+    <button onClick={() => count.value++ }> + 1 </button>
+  </div>
+}
+```
+### Default Value
+
+When the room does not exist on the server, a default value will be used to create the room. If not connected to the server, data from the default value will also be returned.
+
+### Room ID
+
+&lt;room-id&gt; can be any text, with each Room ID corresponding to a RhineVariable, and users who join with the same Room ID will experience real-time multi-user collaboration.
+
+Regarding the server-side, it will be mentioned below.
+
+### rhineProxy
+
+Create a `RhineVariable` that anyone in the room can directly modify, and the value will be synchronized to everyone real-time.
+
+Its data structure `can be quite complex`, but `at least`, it is `an object` in JavaScript.
+
+### useRhine
+
+A hook for use with React. It creates a snapshot of a `RhineVariable`, and whenever someone modifies this value, the information will be `updated on everyone's screen` in real-time.
+
+Use snapshot only when data needs to be displayed on the React page. For other operations, such as modifying values, please use RhineVariable itself.
+
+<br/>
+
+## Server
+We provide a simple server as a reference, located at `/test/server` in this project. The server is fully compatible with all Yjs websocket servers.
+```
+git clone https://github.com/RhineAI-Lab/rhine-var.git
+cd test/server
+yarn install
+yarn start
+```
+It will run on `Port 6600`, and you can connect to it via `ws://localhost:6600/<room-id>`. `<room-id>` can be any text, with each room ID corresponding to a `RhineVariable`.
+
+More information about server develop: [https://docs.yjs.dev/ecosystem/connection-provider/y-websocket](https://docs.yjs.dev/ecosystem/connection-provider/y-websocket)
+
+<br/>
+
+## Develop
+
+```bash
+# start watch and build by typescript
+yarn run watch
+
+# start a easy websocket server
+cd test/server
+yarn install
+yarn start
+
+# start a nextjs playground for develop debug
+cd test/debug/next-app
+yarn install
+yarn start
+# Open http://localhost:3000 in browser
+```
+
+<br/>

package/README_zh.md

@@ -16,6 +16,8 @@
 
 **简洁高效的语法设计:**   RhineVar 借鉴了 Valtio 状态管理库的设计理念，极大地降低了学习成本。开发者可以像操作普通变量一样轻松操控协同数据。
 
+**几乎没有体积上限:**   它几乎没有体积限制，可以是一个极其复杂且庞大的数据结构，以容纳一个大型项目所需的所有数据。但至少是一个 JavaScript 对象。
+
 **完备的类型支持:**   RhineVar 提供全面的类型提示和类型检查，确保在开发过程中能够获得精确的代码补全和静态分析。这不仅改善了开发体验，还有效降低了潜在的错误风险，特别适用于 TypeScript 项目，提升了代码的安全性和可靠性。
 
 **分布式实时协作算法:**   RhineVar 的底层协同算法基于强大的 Yjs 库。通过 CRDT (Conflict-free Replicated Data Type，无冲突复制数据类型) 算法，确保多用户同时使用，甚至离线下使用的最终一致性。
@@ -24,7 +26,7 @@
 
 **强大的离线支持:**   即使在离线状态下，用户仍然可以继续使用应用。当重新联机时，所有更改将自动同步，确保数据不会出现丢失或冲突。这对于构建离线优先的应用至关重要。
 
-**跨平台和框架无关:**   RhineVar 支持在多种环境中使用，包括浏览器、Node.js 和其他 JavaScript 环境。此外，它可以与多个前端框架和库 (如 NextJs、React、Vue.js、ProseMirror 等) 集成。
+**跨平台和框架无关:**   RhineVar 支持在多种环境中使用，包括浏览器、Node.js 和其它 JavaScript 环境。此外，它可以与多个前端框架和库 (如 NextJs、React、Vue.js、ProseMirror 等) 集成。
 
 **轻量级且可扩展:**   RhineVar 是一个非常轻量的库，核心包仅几 KB，适合各种前端应用。其模块化架构也支持扩展特性，开发者可以根据需要引入或开发自定义模块。
 
@@ -34,11 +36,13 @@
 
 **更友好且完善的事件体系:**   RhineVar 提供了丰富的事件订阅监听方式，直观的数据变更事件，更好的支持数据变更的监听和处理。以及提供了对内部深层数据变化的监听，以适用更多场景。
 
+**完全开源:**   这是个完全开源的项目，本库在 Github 上以 Apache-2.0 许可证发布。您可以自由将其用于商业和非商业项目，并且允许对其进行修改和分发，只需要保留原作者的版权声明。
+
 <br/>
 
 ## Contact Us
 
-欢迎加入我们的微信群一起讨论交流，我们期待更多的社区成员能加入到 RHINE-VAR 的创造中来！
+欢迎加入我们的微信群一起讨论交流，我们期待更多的社区开发者能加入到 RHINE-VAR 的创造中！
 
 微信: [FNA-04]() (请备注来源)
 
@@ -79,19 +83,21 @@ function Counter() {
 
 一个房间号对应一个状态变量, 加入到一个房间中的用户会参与到多人协同中。
 
+关于服务端，下方将会提及。
+
 ### rhineProxy
 
-用于创建一个 `RhineVariable` 他的值会和房间中的其他人共享并同步。
+用于创建一个 `RhineVariable` 它的值会和房间中的其他人共享并同步。
 
-你可以像操作 JavaScript 中的普通变量一样直接随意操作他。
+你可以像操作 JavaScript 中的普通变量一样直接随意操作它。
 
-值的类型至少是 JavaScript 中的 object，但没有上限。它可以是一个非常复杂和庞大的 JSON 结构，以容纳大型项目的所有数据。
+它内部的数据结构可以很复杂，但至少是 JavaScript 中的一个 object。
 
 ### useRhine
 
-一个 `React` 的 `Hook` 函数. 他将为 `RhineVariable` 创建一个快照, 用于自动热重载更新页面。当任何人对值做出修改时，他会把最新的值立刻更新到所有人的屏幕上。
+一个 `React` 的 `Hook` 函数. 它将为 `RhineVariable` 创建一个快照, 用于自动热重载更新页面。当任何人对值做出修改时，它会把最新的值立刻更新到所有人的屏幕上。
 
-只有页面需要数据的时候使用 `useRhine` 创造的快照。在其他操作，例如赋值时，请操作原来的 `RhineVariable`。
+只有页面需要数据的时候使用 `useRhine` 创造的快照。在其它操作，例如赋值时，请操作原来的 `RhineVariable`。
 
 <br/>
 
@@ -103,7 +109,7 @@ cd test/server
 yarn install
 yarn start
 ```
-默认运行在 `端口 6600`, 你可以通过连接 `ws://localhost:6600/<room-id>` 连接他，`<room-id>` 可以是任意文本，一个房间号对应一个 `RhineVariable`。
+默认运行在 `端口 6600`, 你可以通过连接 `ws://localhost:6600/<room-id>` 连接它，`<room-id>` 可以是任意文本，一个房间号对应一个 `RhineVariable`。
 
 更多服务端开发信息请参考: [https://docs.yjs.dev/ecosystem/connection-provider/y-websocket](https://docs.yjs.dev/ecosystem/connection-provider/y-websocket)
 

package/dist/core/class/array/RhineVarArray.d.ts

@@ -1,4 +1,4 @@
-import RhineVar from "../../proxy/RhineVar";
-export default class RhineVarArray<T> extends Array<T | RhineVar<T[]>> {
+import RhineVarItem from "../../proxy/RhineVarItem";
+export default class RhineVarArray<T> extends Array<T | RhineVarItem<T[]>> {
 }
 //# sourceMappingURL=RhineVarArray.d.ts.map

package/dist/core/class/array/RhineVarArray.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RhineVarArray.d.ts","sourceRoot":"","sources":["../../../../src/core/class/array/RhineVarArray.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,6BAA8B;AAE7C,MAAM,CAAC,OAAO,OAAO,aAAa,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;CAErE"}
+{"version":3,"file":"RhineVarArray.d.ts","sourceRoot":"","sources":["../../../../src/core/class/array/RhineVarArray.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,iCAAkC;AAErD,MAAM,CAAC,OAAO,OAAO,aAAa,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;CAEzE"}

package/dist/core/event/Callback.d.ts

@@ -1,4 +1,7 @@
 import { ChangeType } from "./ChangeType";
 import { Transaction, YArrayEvent, YMapEvent } from "yjs";
-export type Callback<T> = (value: T[keyof T], key: keyof T, oldValue: T[keyof T], type: ChangeType, nativeEvent: YMapEvent<any> | YArrayEvent<any>, nativeTransaction: Transaction) => void;
+import { YPath } from "../native/Native";
+import { ProxiedRhineVarItem } from "../proxy/ProxiedRhineVar";
+export type Callback<T> = (key: keyof T, value: T[keyof T] | ProxiedRhineVarItem<T[keyof T]>, oldValue: T[keyof T], type: ChangeType, nativeEvent: YMapEvent<any> | YArrayEvent<any>, nativeTransaction: Transaction) => void;
+export type DeepCallback<T> = (path: YPath, value: any | ProxiedRhineVarItem<any>, oldValue: any, type: ChangeType, nativeEvent: YMapEvent<any> | YArrayEvent<any>, nativeTransaction: Transaction) => void;
 //# sourceMappingURL=Callback.d.ts.map

package/dist/core/event/Callback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Callback.d.ts","sourceRoot":"","sources":["../../../src/core/event/Callback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,qBAAgC;AACnD,OAAO,EAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,KAAK,CAAC;AAGxD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CACxB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EACjB,GAAG,EAAE,MAAM,CAAC,EACZ,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EACpB,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,EAC9C,iBAAiB,EAAE,WAAW,KAC3B,IAAI,CAAA"}
+{"version":3,"file":"Callback.d.ts","sourceRoot":"","sources":["../../../src/core/event/Callback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,qBAAgC;AACnD,OAAO,EAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,KAAK,CAAC;AACxD,OAAO,EAAS,KAAK,EAAC,yBAA6B;AACnD,OAAO,EAAC,mBAAmB,EAAC,iCAAqC;AAGjE,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CACxB,GAAG,EAAE,MAAM,CAAC,EACZ,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EACpB,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,EAC9C,iBAAiB,EAAE,WAAW,KAC3B,IAAI,CAAA;AAET,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAC5B,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,EACrC,QAAQ,EAAE,GAAG,EACb,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,EAC9C,iBAAiB,EAAE,WAAW,KAC3B,IAAI,CAAA"}

package/dist/core/event/ChangeType.d.ts

@@ -1,7 +1,7 @@
 export declare enum ChangeType {
-    Add = "add",
-    Update = "update",
-    Delete = "delete",
+    Add = "add",// For YMap / YArray
+    Update = "update",// For YMap
+    Delete = "delete",// For YMap / YArray
     Sync = "sync"
 }
 //# sourceMappingURL=ChangeType.d.ts.map

package/dist/core/event/ChangeType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChangeType.d.ts","sourceRoot":"","sources":["../../../src/core/event/ChangeType.ts"],"names":[],"mappings":"AACA,oBAAY,UAAU;IACpB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd"}
+{"version":3,"file":"ChangeType.d.ts","sourceRoot":"","sources":["../../../src/core/event/ChangeType.ts"],"names":[],"mappings":"AACA,oBAAY,UAAU;IACpB,GAAG,QAAQ,CAAG,oBAAoB;IAClC,MAAM,WAAW,CAAG,WAAW;IAC/B,MAAM,WAAW,CAAG,oBAAoB;IACxC,IAAI,SAAS;CACd"}

package/dist/core/native/Native.d.ts

@@ -1,3 +1,5 @@
 import { Array as YArray, Map as YMap } from "yjs";
 export type Native = YMap<any> | YArray<any>;
+export type YKey = string | number;
+export type YPath = YKey[];
 //# sourceMappingURL=Native.d.ts.map

package/dist/core/native/Native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Native.d.ts","sourceRoot":"","sources":["../../../src/core/native/Native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,EAAC,MAAM,KAAK,CAAC;AAEjD,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA"}
+{"version":3,"file":"Native.d.ts","sourceRoot":"","sources":["../../../src/core/native/Native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,EAAC,MAAM,KAAK,CAAC;AAEjD,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;AAE5C,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;AAElC,MAAM,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA"}

package/dist/core/proxy/ProxiedRhineVar.d.ts

@@ -1,6 +1,12 @@
+import RhineVarItem from "./RhineVarItem";
 import RhineVar from "./RhineVar";
+export type RecursiveCrossRhineVarItem<T> = {
+    [K in keyof T]: T[K] extends object ? RecursiveCrossRhineVarItem<T[K]> & RhineVarItem<T[K]> : T[K];
+};
+export type StoredRhineVarItem<T> = T & RecursiveCrossRhineVarItem<T> & RhineVarItem<T>;
+export type ProxiedRhineVarItem<T> = StoredRhineVarItem<T>;
 export type RecursiveCrossRhineVar<T> = {
-    [K in keyof T]: T[K] extends object ? RecursiveCrossRhineVar<T[K]> & RhineVar<T[K]> : T[K];
+    [K in keyof T]: T[K] extends object ? RecursiveCrossRhineVarItem<T[K]> & RhineVarItem<T[K]> : T[K];
 };
 export type StoredRhineVar<T> = T & RecursiveCrossRhineVar<T> & RhineVar<T>;
 export type ProxiedRhineVar<T> = StoredRhineVar<T>;

package/dist/core/proxy/ProxiedRhineVar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProxiedRhineVar.d.ts","sourceRoot":"","sources":["../../../src/core/proxy/ProxiedRhineVar.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,mBAA8B;AAE7C,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;KACrC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC3F,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;AAE3E,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"ProxiedRhineVar.d.ts","sourceRoot":"","sources":["../../../src/core/proxy/ProxiedRhineVar.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,uBAAkC;AACrD,OAAO,QAAQ,mBAA8B;AAE7C,MAAM,MAAM,0BAA0B,CAAC,CAAC,IAAI;KACzC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACnG,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,0BAA0B,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;AAEvF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAA;AAG1D,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;KACrC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACnG,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;AAE3E,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAA"}

package/dist/core/proxy/ProxiedRhineVarItem.d.ts

@@ -0,0 +1,7 @@
+import RhineVarItem from "./RhineVarItem";
+export type RecursiveCrossRhineVar<T> = {
+    [K in keyof T]: T[K] extends object ? RecursiveCrossRhineVar<T[K]> & RhineVarItem<T[K]> : T[K];
+};
+export type StoredRhineVar<T> = T & RecursiveCrossRhineVar<T> & RhineVarItem<T>;
+export type ProxiedRhineVar<T> = StoredRhineVar<T>;
+//# sourceMappingURL=ProxiedRhineVarItem.d.ts.map

package/dist/core/proxy/ProxiedRhineVarItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProxiedRhineVarItem.d.ts","sourceRoot":"","sources":["../../../src/core/proxy/ProxiedRhineVarItem.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,uBAAkC;AAErD,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;KACrC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC/F,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;AAE/E,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAA"}

package/dist/core/proxy/ProxiedRhineVarItem.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/proxy/Proxy.d.ts

@@ -1,8 +1,10 @@
 import WebsocketRhineConnector from "../connector/WebsocketRhineConnector";
-import { ProxiedRhineVar } from "./ProxiedRhineVar";
+import RhineVarItem from "./RhineVarItem";
+import { ProxiedRhineVar, ProxiedRhineVarItem } from "./ProxiedRhineVar";
 import { Native } from "../native/Native";
+import RhineVar from "./RhineVar";
 export declare const PROTOCOL_LIST: string[];
 export declare const DEFAULT_PROTOCOL_LIST: string;
-export declare function rhineProxy<T extends object>(data: T, connector?: WebsocketRhineConnector | string | null, overwrite?: boolean | number): ProxiedRhineVar<T>;
-export declare function rhineProxyNative<T extends object>(target: Native): ProxiedRhineVar<T>;
+export declare function rhineProxy<T extends object>(data: T | Native, connector: WebsocketRhineConnector | string, overwrite?: boolean | number): ProxiedRhineVar<T>;
+export declare function rhineProxyItem<T extends object>(data: T | Native, parent?: RhineVar<any> | RhineVarItem<any> | null): ProxiedRhineVarItem<T> | ProxiedRhineVar<T>;
 //# sourceMappingURL=Proxy.d.ts.map

package/dist/core/proxy/Proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Proxy.d.ts","sourceRoot":"","sources":["../../../src/core/proxy/Proxy.ts"],"names":[],"mappings":"AACA,OAAO,uBAAgD,6CAAiD;AAKxG,OAAO,EAAC,eAAe,EAAC,0BAAqC;AAC7D,OAAO,EAAC,MAAM,EAAC,yBAA6B;AAY5C,eAAO,MAAM,aAAa,UAAsB,CAAA;AAChD,eAAO,MAAM,qBAAqB,QAAmB,CAAA;AAGrD,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,IAAI,EAAE,CAAC,EACP,SAAS,GAAE,uBAAuB,GAAG,MAAM,GAAG,IAAW,EACzD,SAAS,GAAE,OAAO,GAAG,MAAc,GAClC,eAAe,CAAC,CAAC,CAAC,CA6CpB;AAGD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAoErF"}
+{"version":3,"file":"Proxy.d.ts","sourceRoot":"","sources":["../../../src/core/proxy/Proxy.ts"],"names":[],"mappings":"AACA,OAAO,uBAAgD,6CAAiD;AACxG,OAAO,YAA+C,uBAAkC;AAIxF,OAAO,EAAC,eAAe,EAAE,mBAAmB,EAAC,0BAAqC;AAClF,OAAO,EAAC,MAAM,EAAC,yBAA6B;AAS5C,OAAO,QAAQ,mBAA8B;AAG7C,eAAO,MAAM,aAAa,UAAsB,CAAA;AAChD,eAAO,MAAM,qBAAqB,QAAmB,CAAA;AAGrD,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,IAAI,EAAE,CAAC,GAAG,MAAM,EAChB,SAAS,EAAE,uBAAuB,GAAG,MAAM,EAC3C,SAAS,GAAE,OAAO,GAAG,MAAc,GAClC,eAAe,CAAC,CAAC,CAAC,CA6CpB;AAGD,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,IAAI,EAAE,CAAC,GAAG,MAAM,EAChB,MAAM,GAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,IAAW,GACtD,mBAAmB,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAgG7C"}