@virid/amber 0.1.3 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +2 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +7 -5
- package/dist/index.d.ts +7 -5
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/package.json +3 -4
package/dist/index.cjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @virid/amber v0.
|
|
2
|
+
* @virid/amber v0.2.2
|
|
3
3
|
* Add replay, redo, undo and other functions to virid
|
|
4
4
|
*/
|
|
5
|
-
var
|
|
5
|
+
var E=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var B=Object.prototype.hasOwnProperty;var $=(i,t,e)=>t in i?E(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e;var u=(i,t)=>E(i,"name",{value:t,configurable:!0});var C=(i,t)=>{for(var e in t)E(i,e,{get:t[e],enumerable:!0})},L=(i,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of v(t))!B.call(i,s)&&s!==e&&E(i,s,{get:()=>t[s],enumerable:!(r=_(t,s))||r.enumerable});return i};var N=i=>L(E({},"__esModule",{value:!0}),i);var T=(i,t,e)=>$(i,typeof t!="symbol"?t+"":t,e);var Q={};C(Q,{Amber:()=>y,AmberPlugin:()=>W,Backup:()=>K,RestoreDirection:()=>l,activateConfig:()=>H,afterExecuteHooks:()=>O,afterTickHooks:()=>I,amberComponentStore:()=>c,amberTickStore:()=>f});module.exports=N(Q);var x=require("@virid/core");var h=require("@virid/core");var w=require("@virid/core"),n={...w.VIRID_METADATA,BACKUP:"virid:amber:backup",VERSION:"virid:amber:version",CUSTOM_METHOD:"virid:amber:custom-method"};var l=(function(i){return i.UNDO="UNDO",i.REDO="REDO",i})({});var k;function H(i){k=i,c.maxComponentLength=k.maxComponentLength,f.maxTickLength=k.maxTickLength}u(H,"activateConfig");var M,P=(M=class{constructor(t=20){T(this,"tickHistory",[]);T(this,"baseTick",0);T(this,"maxTickLength");T(this,"currentTick",0);this.maxTickLength=t}getMinTick(){return this.baseTick}getMaxTick(){return this.tickHistory.length===0?0:this.baseTick+this.tickHistory.length-1}updateTickHistory(){this.currentTick<this.baseTick+this.tickHistory.length&&this.tickHistory.splice(this.currentTick-this.baseTick+1);let t=new Map(c.currentHistory);this.tickHistory.push(t),this.tickHistory.length>this.maxTickLength&&(this.tickHistory.shift(),this.baseTick++);let e=this.baseTick+this.tickHistory.length-1;this.currentTick=e}travel(t){let e=t-this.baseTick,r=this.tickHistory[e];if(!r){h.MessageWriter.error(new Error(`[Virid Amber] Travel Error: Tick ${t} is out of history range.`));return}let s=t<this.currentTick?l.UNDO:l.REDO,o=[];for(let[a,m]of r){let d=c.getCurrentData(a);if(m!==d){let V=d;c.deserializeComponent(a,m),c.seal(a);let z=Reflect.getMetadata(n.CUSTOM_METHOD,a);z?.onRestore&&o.push({strategy:z,oldData:V,newData:m})}let R=A.get(a)}this.currentTick=t,o.forEach(({strategy:a,oldData:m,newData:d})=>{a.onRestore(m,d,s)})}resetTickStore(){this.tickHistory=[],this.baseTick=0,this.currentTick=0,this.updateTickHistory()}},u(M,"AmberTickStore"),M),g,F=(g=class{constructor(t=20){T(this,"componentHistory",new Map);T(this,"biasVersions",new Map);T(this,"maxComponentLength");T(this,"currentHistory",new Map);this.maxComponentLength=t}serializeComponent(t){let e=A.get(t);if(!e)return h.MessageWriter.error(new Error(`[Virid Amber] Serialize Error: Component ${t.name} is not registered.`)),null;let s=Reflect.getMetadata(n.CUSTOM_METHOD,t)?.serialize||k.serialization;try{return s(e)}catch(o){h.MessageWriter.error(o,`[Virid Amber] Serialize Error: Component ${t.name} serialization error`)}return null}deserializeComponent(t,e){let r=A.get(t);if(!r){h.MessageWriter.error(new Error(`[Virid Amber] Deserialize Error: Component ${t.name} is not registered.`));return}if(!e){h.MessageWriter.error(new Error(`[Virid Amber] Deserialize Error: Component ${t.name} data is ${e}!.`));return}let o=Reflect.getMetadata(n.CUSTOM_METHOD,t)?.deserialize||k.deserialization;try{o(r,e)}catch(a){h.MessageWriter.error(a,`[Virid Amber] Deserialize Error: Component ${t.name} deserialize error`)}}diffComponent(t,e){let r=A.get(t);if(!r)return h.MessageWriter.error(new Error(`[Virid Amber] Diff Error: Component ${t.name} is not registered.`)),!1;if(!e)return h.MessageWriter.error(new Error(`[Virid Amber] Diff Error: Component ${t.name} data is ${e}!.`)),!1;let o=Reflect.getMetadata(n.CUSTOM_METHOD,t)?.diff||k.diff;try{return o(r,e)}catch(a){h.MessageWriter.error(a,`[Virid Amber] Diff Error: Component ${t.name} diff error`)}return!1}initComponent(t){let e=t.constructor,s=Reflect.getMetadata(n.CUSTOM_METHOD,e)?.serialize||k.serialization,o;try{o=s(t)}catch(a){h.MessageWriter.error(a,`[Virid Amber] Serialize Error: Component ${e.name} serialization error`);return}this.componentHistory.set(e,[]),this.biasVersions.set(e,0),this.componentHistory.get(e).push(o),this.currentHistory.set(e,o),Reflect.defineMetadata(n.VERSION,0,e)}getCurrentData(t){return this.currentHistory.get(t)}getMinVersion(t){return this.biasVersions.get(t)??0}getMaxVersion(t){let e=this.componentHistory.get(t),r=this.biasVersions.get(t)??0;return!e||e.length===0?r:r+e.length-1}seal(t){let e=this.componentHistory.get(t);if(!e){h.MessageWriter.error(new Error(`[Virid Amber] Seal Error: Component ${t.name} is not initialized.`));return}let r=this.biasVersions.get(t),s=this.getCurrentData(t);if(s&&!this.diffComponent(t,s))return;let o=Reflect.getMetadata(n.CUSTOM_METHOD,t);o?.onBeforeBackup&&o.onBeforeBackup(s);let a=Reflect.getMetadata(n.VERSION,t)||0,m=r+e.length-1;a<m&&e.splice(a-r+1);let d=this.serializeComponent(t);if(!d){h.MessageWriter.error(new Error(`[Virid Amber] Seal Error: Component ${t.name} is not serializable.`));return}e.push(d),this.currentHistory.set(t,d),e.length>this.maxComponentLength&&(e.shift(),this.biasVersions.set(t,r+1));let R=this.biasVersions.get(t)+e.length-1;Reflect.defineMetadata(n.VERSION,R,t),o?.onAfterBackup&&o.onAfterBackup(d)}seek(t,e){let r=this.componentHistory.get(t);if(!r)return h.MessageWriter.error(new Error(`[Virid Amber] Seal Error: Component ${t.name} is not initialized.`)),!1;let s=this.biasVersions.get(t)||0,o=e-s;if(o<0||o>=r.length)return!1;let a=this.getCurrentData(t),m=r[o],d=Reflect.getMetadata(n.VERSION,t)||0,R=e<d?l.UNDO:l.REDO;this.deserializeComponent(t,m),this.currentHistory.set(t,m),Reflect.defineMetadata(n.VERSION,e,t);let V=Reflect.getMetadata(n.CUSTOM_METHOD,t);return V?.onRestore&&V.onRestore(a,m,R),f.updateTickHistory(),!0}resetComponentInternal(t){let e=this.serializeComponent(t);e&&(this.componentHistory.set(t,[e]),this.biasVersions.set(t,0),this.currentHistory.set(t,e),Reflect.defineMetadata(n.VERSION,0,t))}resetComponent(t){this.resetComponentInternal(t),f.updateTickHistory()}},u(g,"AmberComponentStore"),g),f=new P,c=new F;var S=class S{static getVersion(t){return Reflect.getMetadata(n.VERSION,t)||0}static canUndo(t){let e=this.getVersion(t),r=c.getMinVersion(t);return e>r}static canRedo(t){let e=this.getVersion(t),r=c.getMaxVersion(t);return e<r}static undo(t){if(!this.canUndo(t))return!1;let e=this.getVersion(t);return c.seek(t,e-1)}static redo(t){if(!this.canRedo(t))return!1;let e=this.getVersion(t);return c.seek(t,e+1)}static undoTick(){if(!this.canUndoTick())return!1;let t=f.currentTick-1;return f.travel(t),!0}static redoTick(){if(!this.canRedoTick())return!1;let t=f.currentTick+1;return f.travel(t),!0}static canUndoTick(){let t=f.currentTick,e=f.getMinTick();return t>e}static canRedoTick(){let t=f.currentTick,e=f.getMaxTick();return t<e}static resetTick(){f.resetTickStore()}static resetComponent(t){c.resetComponent(t)}static resetAll(){Array.from(c.componentHistory.keys()).forEach(e=>{c.resetComponentInternal(e)}),f.resetTickStore()}};u(S,"Amber");var y=S;var p=require("@virid/core");var b=new Set,O=u((i,t)=>{if(i instanceof p.ErrorMessage||i instanceof p.WarnMessage||i instanceof p.InfoMessage)return;t.context.params.forEach(r=>{Reflect.hasMetadata(n.BACKUP,r)&&b.add(r)})},"afterExecuteHooks"),I=u(i=>{b.size!==0&&(b.forEach(t=>{c.seal(t)}),f.updateTickHistory(),b.clear())},"afterTickHooks");var D=null;function U(i,t){i.onAfterTick(I,!0),i.onAfterExecute(x.BaseMessage,O,!0),H(t);let e=u(r=>(r&&Reflect.hasMetadata(n.VERSION,r.constructor)&&c.initComponent(r),r),"amberInitHook");i.addActivationHook(e),D=i}u(U,"activateApp");var A=new Proxy({},{get(i,t){return(...e)=>{if(!D)return x.MessageWriter.warn(`[Virid Vue] App method "${String(t)}" called before initialization.`),null;let r=D[t];if(typeof r=="function")return Reflect.apply(r,D,e)}}});function K(i){return t=>{Reflect.defineMetadata(n.BACKUP,!0,t),Reflect.defineMetadata(n.VERSION,0,t),i&&Reflect.defineMetadata(n.CUSTOM_METHOD,i,t)}}u(K,"Backup");var W={name:"@virid/amber",install(i,t){U(i,t)}};0&&(module.exports={Amber,AmberPlugin,Backup,RestoreDirection,activateConfig,afterExecuteHooks,afterTickHooks,amberComponentStore,amberTickStore});
|
|
6
6
|
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/app.ts","../src/amber/store.ts","../src/decorators/constant.ts","../src/interfaces/decorator.ts","../src/amber/utils.ts","../src/amber/amber.ts","../src/amber/hooks.ts","../src/decorators/decorator.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Add replay, redo, undo and other functions to virid.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { activateApp } from \"./app\";\nimport { PluginOptions } from \"./interfaces\";\nexport * from \"./amber\";\nexport * from \"./decorators\";\nexport * from \"./interfaces\";\nexport const AmberPlugin: ViridPlugin<PluginOptions> = {\n name: \"@virid/amber\",\n install(app: ViridApp, options) {\n activateApp(app, options);\n },\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { type ViridApp, MessageWriter, BaseMessage } from \"@virid/core\";\nimport {\n amberComponentStore,\n afterExecuteHooks,\n afterTickHooks,\n activateConfig,\n} from \"./amber\";\nimport type { PluginOptions } from \"./interfaces\";\nimport { VIRID_AMBER_METADATA } from \"./decorators/constant\";\nexport interface IViridApp {\n get(identifier: any): any;\n}\n\nlet activeApp: IViridApp | null = null;\n\nexport function activateApp(app: ViridApp, options: PluginOptions) {\n //注册钩子\n app.onAfterTick(afterTickHooks, true);\n app.onAfterExecute(BaseMessage, afterExecuteHooks, true);\n //看看用户提供的配置\n if (options) activateConfig(options);\n const amberInitHook = (instance) => {\n if (\n instance &&\n Reflect.hasMetadata(VIRID_AMBER_METADATA.VERSION, instance.constructor)\n ) {\n //实例化的时候，init第一个版本\n amberComponentStore.initComponent(instance);\n }\n return instance;\n };\n app.addActivationHook(amberInitHook);\n activeApp = app;\n}\n\n/**\n * viridApp 代理\n */\nexport const viridApp: IViridApp = new Proxy({} as IViridApp, {\n get(_, prop: keyof IViridApp) {\n return (...args: any[]) => {\n // 检查实例是否存在\n if (!activeApp) {\n MessageWriter.warn(\n `[Virid Vue] App method \"${String(prop)}\" called before initialization.`,\n );\n return null;\n }\n\n // 正常转发调用\n // 使用 Reflect 确保 this 指向正确，或者直接从 activeApp 调用\n const targetMethod = activeApp[prop];\n if (typeof targetMethod === \"function\") {\n // @ts-ignore\n return targetMethod.apply(activeApp, args);\n }\n };\n },\n});\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { MessageWriter } from \"@virid/core\";\nimport { viridApp } from \"../app\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\nimport { RestoreDirection, type PluginOptions } from \"../interfaces\";\nimport {\n type VersionMetadata,\n type CustomMethodMetadata,\n} from \"../interfaces\";\n\nimport { _serialization, _deserialization, _diff } from \"./utils\";\nlet config: Required<PluginOptions> = {\n serialization: _serialization,\n deserialization: _deserialization,\n diff: _diff, // 默认总是备份\n};\n\nexport function activateConfig(customConfig: PluginOptions) {\n config = Object.assign(config, customConfig);\n}\n\nclass AmberTickStore {\n // 快照镜像\n private tickHistory: Array<Map<any, any>> = [];\n\n // 记录数组第 0 位对应的真实 Tick 号\n public baseTick = 0;\n\n public maxTickLength = 20;\n // 当前处于哪个逻辑 Tick\n public currentTick = 0;\n\n constructor(maxTickLength: number = 20) {\n this.maxTickLength = maxTickLength;\n }\n /**\n * 获取最小可用Tick\n */\n public getMinTick(): number {\n return this.baseTick;\n }\n\n /**\n * 获取最大的Tick\n */\n public getMaxTick(): number {\n if (this.tickHistory.length === 0) return 0;\n return this.baseTick + this.tickHistory.length - 1;\n }\n /**\n * 记录当前的宏观快照\n */\n public updateTickHistory() {\n // 剪枝\n if (this.currentTick < this.baseTick + this.tickHistory.length) {\n // 剪掉后面的平行宇宙\n this.tickHistory.splice(this.currentTick - this.baseTick + 1);\n }\n\n // 增加加新快照\n const snapshot = new Map(amberComponentStore.currentHistory);\n this.tickHistory.push(snapshot);\n\n // 滑动窗口处理\n if (this.tickHistory.length > this.maxTickLength) {\n this.tickHistory.shift();\n this.baseTick++;\n }\n const newLogicalTick = this.baseTick + this.tickHistory.length - 1;\n // 更新指针到最新产生的这个 Tick\n this.currentTick = newLogicalTick;\n }\n\n /**\n * 全局时空旅行\n */\n public travel(targetTick: number) {\n // 计算物理索引\n const index = targetTick - this.baseTick;\n const historyMap = this.tickHistory[index];\n\n if (!historyMap) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Travel Error: Tick ${targetTick} is out of history range.`,\n ),\n );\n return;\n }\n\n const direction =\n targetTick < this.currentTick\n ? RestoreDirection.UNDO\n : RestoreDirection.REDO;\n\n // 准备一个队列，用于最后统一执行钩子\n const restoreQueue: Array<{\n strategy: any;\n oldData: any;\n newData: any;\n }> = [];\n // 遍历快照中的所有组件类\n for (const [compClass, historicalData] of historyMap) {\n const currentData = amberComponentStore.getCurrentData(compClass);\n // 只有数据不一致时才处理\n if (historicalData !== currentData) {\n const oldData = currentData;\n // 执行物理恢复\n amberComponentStore.deserializeComponent(compClass, historicalData);\n\n // 更新微观层的快照记录\n amberComponentStore.seal(compClass);\n\n // 收集钩子\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onRestore) {\n restoreQueue.push({\n strategy: customMethod,\n oldData,\n newData: historicalData,\n });\n }\n }\n const instance = viridApp.get(compClass);\n }\n\n // 更新宏观时空指针\n this.currentTick = targetTick;\n\n // 统一派发副作用钩子\n restoreQueue.forEach(({ strategy, oldData, newData }) => {\n strategy.onRestore(oldData, newData, direction);\n });\n }\n /**\n * 重置宏观时间轴\n */\n public resetTickStore() {\n // 彻底清空旧的磁带\n this.tickHistory = [];\n this.baseTick = 0;\n this.currentTick = 0;\n\n // 立刻保存一份当前的“现状”作为新起点\n this.updateTickHistory();\n }\n}\n\nclass AmberComponentStore {\n public componentHistory = new Map<any, any[]>();\n // 记录每个组件消失的历史总数\n public biasVersions = new Map<any, number>();\n public maxComponentHistorySize = 20;\n // 记录当前每个组件都是什么版本\n public currentHistory = new Map<any, any>();\n // 记录每个组件消失的历史总数\n constructor(maxComponentHistorySize: number = 20) {\n this.maxComponentHistorySize = maxComponentHistorySize;\n }\n /**\n * 将component 的数据进行序列化\n */\n public serializeComponent(compClass: any) {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Serialize Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return null;\n }\n\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const serializeFn = customMethod?.serialize || config.serialization;\n try {\n return serializeFn(instance);\n } catch (e) {\n MessageWriter.error(\n e,\n `[Virid Amber] Serialize Error: Component ${compClass.name} serialization error`,\n );\n }\n return null;\n }\n /**\n * 将component 的数据反序列化\n */\n public deserializeComponent(compClass: any, data: any) {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Deserialize Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return;\n }\n if (!data) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Deserialize Error: Component ${compClass.name} data is ${data}!.`,\n ),\n );\n return;\n }\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const deserializeFn =\n customMethod?.deserialize || config.deserialization;\n try {\n deserializeFn(instance, data);\n } catch (e) {\n MessageWriter.error(\n e,\n `[Virid Amber] Deserialize Error: Component ${compClass.name} deserialize error`,\n );\n }\n return;\n }\n /**\n * 对比diff\n */\n public diffComponent(compClass: any, old_data: any): boolean {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Diff Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return false;\n }\n if (!old_data) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Diff Error: Component ${compClass.name} data is ${old_data}!.`,\n ),\n );\n return false;\n }\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const diffFn = customMethod?.diff || config.diff;\n try {\n return diffFn(instance, old_data);\n } catch (e) {\n MessageWriter.error(\n e,\n `[Virid Amber] Diff Error: Component ${compClass.name} diff error`,\n );\n }\n return false;\n }\n\n /**\n * 初始化组件的历史记录结构\n */\n public initComponent(instance: any) {\n const compClass = instance.constructor;\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const serializeFn = customMethod?.serialize || config.serialization;\n let data;\n try {\n data = serializeFn(instance);\n } catch (e) {\n MessageWriter.error(\n e,\n `[Virid Amber] Serialize Error: Component ${compClass.name} serialization error`,\n );\n return;\n }\n this.componentHistory.set(compClass, []);\n this.biasVersions.set(compClass, 0);\n\n // 将初始数据推入\n this.componentHistory.get(compClass)!.push(data);\n this.currentHistory.set(compClass, data);\n\n // 初始版本设为 0\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, compClass);\n }\n /**\n * 获取组件当前逻辑版本对应的快照数据\n */\n public getCurrentData(compClass: any): any {\n return this.currentHistory.get(compClass);\n }\n\n /**\n * 获取组件在当前滑动窗口内的最小可用版本\n */\n public getMinVersion(compClass: any): number {\n return this.biasVersions.get(compClass) ?? 0;\n }\n\n /**\n * 获取组件在当前物理栈内存在的最大版本（包括撤销后的“未来”）\n */\n public getMaxVersion(compClass: any): number {\n const stack = this.componentHistory.get(compClass);\n const bias = this.biasVersions.get(compClass) ?? 0;\n if (!stack || stack.length === 0) return bias;\n return bias + stack.length - 1;\n }\n\n /**\n * 给一个component 打快照\n * @param compClass 构造函数\n * @returns\n */\n public seal(compClass: any) {\n const stack = this.componentHistory.get(compClass);\n if (!stack) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not initialized.`,\n ),\n );\n }\n const baseVersion = this.biasVersions.get(compClass);\n\n const currentSnapshot = this.getCurrentData(compClass);\n // diff判断\n if (currentSnapshot && !this.diffComponent(compClass, currentSnapshot)) {\n return;\n }\n\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onBeforeBackup) {\n customMethod.onBeforeBackup(currentSnapshot);\n }\n\n // 剪枝\n const currentLogicalVersion:VersionMetadata =\n Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n const latestLogicalVersion = baseVersion + stack.length - 1;\n if (currentLogicalVersion < latestLogicalVersion) {\n stack.splice(currentLogicalVersion - baseVersion + 1);\n }\n\n // 序列化\n const newData = this.serializeComponent(compClass);\n if (!newData) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not serializable.`,\n ),\n );\n return;\n }\n stack.push(newData);\n this.currentHistory.set(compClass, newData);\n // 滑动窗口与元数据更新\n if (stack.length > this.maxComponentHistorySize) {\n stack.shift();\n this.biasVersions.set(compClass, baseVersion + 1);\n }\n\n const newLogicalVersion =\n this.biasVersions.get(compClass)! + stack.length - 1;\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.VERSION,\n newLogicalVersion,\n compClass,\n );\n if (customMethod?.onAfterBackup) {\n customMethod.onAfterBackup(newData);\n }\n }\n /**\n * 回退到指定版本\n * @param compClass component构造函数\n * @param targetVersion 目标版本\n * @returns\n */\n public seek(compClass: any, targetVersion: number): boolean {\n // 边界检查\n const stack = this.componentHistory.get(compClass);\n if (!stack) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not initialized.`,\n ),\n );\n return false;\n }\n const baseVersion = this.biasVersions.get(compClass) || 0;\n\n const physicalIndex = targetVersion - baseVersion;\n if (physicalIndex < 0 || physicalIndex >= stack.length) return false;\n\n // 状态对比准备\n const oldData = this.getCurrentData(compClass);\n const newData = stack[physicalIndex];\n const currentVersion:VersionMetadata =\n Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n\n const direction =\n targetVersion < currentVersion\n ? RestoreDirection.UNDO\n : RestoreDirection.REDO;\n\n // 执行反序列化\n this.deserializeComponent(compClass, newData);\n\n // 时空指针同步\n this.currentHistory.set(compClass, newData);\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, targetVersion, compClass);\n\n // 触发业务钩子\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onRestore) {\n customMethod.onRestore(oldData, newData, direction);\n }\n\n // 告诉时间轴，有个零件变了\n amberTickStore.updateTickHistory();\n return true;\n }\n /**\n * 重置逻辑\n */\n public resetComponentInternal(compClass: any) {\n const newData = this.serializeComponent(compClass);\n if (!newData) return;\n\n // 物理清理\n this.componentHistory.set(compClass, [newData]);\n this.biasVersions.set(compClass, 0);\n this.currentHistory.set(compClass, newData);\n\n // 元数据归零\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, compClass);\n }\n\n public resetComponent(compClass: any) {\n this.resetComponentInternal(compClass);\n // 只有局部重置时，才主动触发宏观记录\n amberTickStore.updateTickHistory();\n }\n}\n\nexport const amberTickStore = new AmberTickStore();\nexport const amberComponentStore = new AmberComponentStore();\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { VIRID_METADATA } from \"@virid/core\";\nexport const VIRID_AMBER_METADATA = {\n ...VIRID_METADATA,\n BACKUP: \"virid:amber:backup\",\n VERSION: \"virid:amber:version\",\n CUSTOM_METHOD: \"virid:amber:custom-method\",\n} as const;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nexport enum RestoreDirection {\n UNDO = \"UNDO\",\n REDO = \"REDO\",\n}\n\nexport interface BackupStrategy<T = any, C = any> {\n /**\n * 自定义序列化：将实例转换为可存储的对象\n */\n serialize?: (instance: T) => C;\n\n /**\n * 自定义反序列化：将数据灌回实例\n */\n deserialize?: (instance: T, data: C) => void;\n\n /**\n * 自定义 Diff：返回 true 表示有变化，需要触发备份\n */\n diff?: (oldData: C, instance: T) => boolean;\n onBeforeBackup?: (oldData: C) => void;\n onAfterBackup?: (newData: C) => void;\n onRestore?: (oldData: C, newData: C, direction: RestoreDirection) => void;\n}\n\nexport type VersionMetadata = number;\nexport type BackupMetadata = boolean;\nexport type CustomMethodMetadata = BackupStrategy;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\n/**\n * 默认 serialization\n */\nexport function _serialization(instance: any, depth = 5): any {\n if (instance === null || typeof instance !== \"object\") return instance;\n if (depth <= 0) return Array.isArray(instance) ? [] : {};\n\n if (Array.isArray(instance)) {\n return instance.map((item) => _serialization(item, depth - 1));\n }\n\n const snapshot: any = {};\n const keys = Object.keys(instance);\n\n for (const key of keys) {\n if (key.startsWith(\"_\")) continue;\n\n const value = instance[key];\n if (typeof value === \"function\") continue;\n\n snapshot[key] =\n typeof value === \"object\" && value !== null\n ? _serialization(value, depth - 1)\n : value;\n }\n return snapshot;\n}\n/**\n * 默认 deserialization\n */\nexport function _deserialization(instance: any, snapshot: any) {\n if (!instance || !snapshot) return;\n\n Object.keys(snapshot).forEach((key) => {\n const newVal = snapshot[key];\n const oldVal = instance[key];\n // 继续递归，而不是直接覆盖对象引用\n if (\n oldVal &&\n typeof oldVal === \"object\" &&\n newVal &&\n typeof newVal === \"object\" &&\n !Array.isArray(newVal)\n ) {\n _deserialization(oldVal, newVal);\n } else {\n // 直接赋值\n instance[key] = newVal;\n }\n });\n}\n/**\n * 默认 Diff\n */\nexport function _diff(oldData: any, instance: any, depth = 3): boolean {\n // 基础类型或引用相同，直接认为没变\n if (oldData === instance) return false;\n\n // 类型不一致，肯定变了\n if (\n typeof oldData !== typeof instance ||\n oldData === null ||\n instance === null\n ) {\n return true;\n }\n // 处理数组\n if (Array.isArray(oldData)) {\n if (!Array.isArray(instance) || oldData.length !== instance.length)\n return true;\n for (let i = 0; i < oldData.length; i++) {\n if (_diff(oldData[i], instance[i], depth - 1)) return true;\n }\n return false;\n }\n\n // 处理对象\n const keys = Object.keys(oldData);\n\n for (const key of keys) {\n const valOld = oldData[key];\n const valNew = instance[key];\n\n if (typeof valOld === \"object\" && valOld !== null) {\n // 达到最大深度限制，不再递归，保守起见认为变了\n if (depth <= 0) continue;\n\n if (_diff(valOld, valNew, depth - 1)) return true;\n } else {\n // 基础类型对比\n if (valOld !== valNew) return true;\n }\n }\n return false;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { amberComponentStore, amberTickStore } from \"./store\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\n\nexport class Amber {\n /**\n * 获取组件当前的逻辑版本号\n */\n public static getVersion(compClass: any): number {\n return Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n }\n\n public static canUndo(compClass: any): boolean {\n const current = this.getVersion(compClass);\n const min = amberComponentStore.getMinVersion(compClass);\n\n return current > min;\n }\n\n public static canRedo(compClass: any): boolean {\n const current = this.getVersion(compClass);\n const max = amberComponentStore.getMaxVersion(compClass);\n\n return current < max;\n }\n\n /**\n * 局部撤销：将单个组件回退一个版本\n * 结果：产生新 Tick，代表“我回到了过去”\n */\n public static undo(compClass: any): boolean {\n if (!this.canUndo(compClass)) return false;\n const current = this.getVersion(compClass);\n const result = amberComponentStore.seek(compClass, current - 1);\n\n return result;\n }\n\n /**\n * 局部重做：将单个组件向前进一个版本\n */\n public static redo(compClass: any): boolean {\n if (!this.canRedo(compClass)) return false;\n const current = this.getVersion(compClass);\n const result = amberComponentStore.seek(compClass, current + 1);\n\n return result;\n }\n /**\n * 全局撤销\n */\n public static undoTick(): boolean {\n if (!this.canUndoTick()) return false;\n const targetTick = amberTickStore.currentTick - 1;\n amberTickStore.travel(targetTick);\n return true;\n }\n\n /**\n * 全局重做\n */\n public static redoTick(): boolean {\n if (!this.canRedoTick()) return false;\n const targetTick = amberTickStore.currentTick + 1;\n amberTickStore.travel(targetTick);\n return true;\n }\n\n /**\n * UI 状态判断：是否还能点撤销\n */\n public static canUndoTick(): boolean {\n const currentTick = amberTickStore.currentTick;\n const minTick = amberTickStore.getMinTick();\n\n return currentTick > minTick;\n }\n\n /**\n * UI 状态判断：是否还能点重做\n */\n public static canRedoTick(): boolean {\n const currentTick = amberTickStore.currentTick;\n const maxTick = amberTickStore.getMaxTick();\n\n return currentTick < maxTick;\n }\n\n /**\n * 重置宏观时间轴\n * 清空所有全局快照，用户无法再进行 undoTick/redoTick，\n * 但各个组件当前的微观版本栈保持不变。\n */\n public static resetTick(): void {\n amberTickStore.resetTickStore();\n }\n\n /**\n * 重置特定组件的历史\n * 该组件的旧版本被物理抹除，当前状态变为 V0。\n * 会自动触发一次 updateTickHistory，记录这一时刻的全局状态。\n */\n public static resetComponent(compClass: any): void {\n amberComponentStore.resetComponent(compClass);\n }\n // 建议添加到 Amber 类中\n public static resetAll(): void {\n // 获取所有存活组件\n const classes = Array.from(amberComponentStore.componentHistory.keys());\n // 清空每个组件（静默重置，不触发 updateTickHistory）\n classes.forEach((compClass) => {\n // 我们可以给 resetComponent 加个参数，或者拆分出一个内部方法\n amberComponentStore.resetComponentInternal(compClass);\n });\n // 重置宏观磁带\n amberTickStore.resetTickStore();\n }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport {\n type ExecuteHook,\n type TickHook,\n AtomicModifyMessage,\n BaseMessage,\n ErrorMessage,\n WarnMessage,\n InfoMessage,\n} from \"@virid/core\";\nimport { amberComponentStore, amberTickStore } from \"./store\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\n\nconst dirtyBuffer = new Set<any>();\n\nexport const afterExecuteHooks: ExecuteHook<BaseMessage> = (\n message,\n context,\n) => {\n if (\n message instanceof ErrorMessage ||\n message instanceof WarnMessage ||\n message instanceof InfoMessage\n )\n return;\n\n const allParams =\n message instanceof AtomicModifyMessage\n ? [...context.context.params, message.ComponentClass]\n : context.context.params;\n\n allParams.forEach((paramClass) => {\n if (Reflect.hasMetadata(VIRID_AMBER_METADATA.BACKUP, paramClass)) {\n dirtyBuffer.add(paramClass);\n }\n });\n};\n\nexport const afterTickHooks: TickHook = (_context) => {\n if (dirtyBuffer.size === 0) return;\n\n // 微观更新\n dirtyBuffer.forEach((compClass) => {\n amberComponentStore.seal(compClass);\n });\n\n // 宏观更新\n amberTickStore.updateTickHistory();\n\n // 清理缓存，准备下一轮\n dirtyBuffer.clear();\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { VIRID_AMBER_METADATA } from \"./constant\";\nimport { type BackupStrategy } from \"../interfaces\";\n\n/**\n * @description: 标记 Backup 身份并配置自定义备份策略\n * @param strategy 可选的自定义序列化/反序列化/Diff 方案\n */\nexport function Backup<T extends new (...args: any[]) => any, C = any>(\n strategy?: BackupStrategy<InstanceType<T>, C>,\n) {\n return (target: T) => {\n // 标记需要备份\n Reflect.defineMetadata(VIRID_AMBER_METADATA.BACKUP, true, target);\n // 初始化版本号\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, target);\n // 如果用户给了自定义方法，存入元数据\n if (strategy) {\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n strategy,\n target,\n );\n }\n };\n}\n"],"mappings":"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","names":["index_exports","__export","Amber","AmberPlugin","Backup","RestoreDirection","activateConfig","afterExecuteHooks","afterTickHooks","amberComponentStore","amberTickStore","__toCommonJS","import_core","import_core","import_core","VIRID_AMBER_METADATA","VIRID_METADATA","BACKUP","VERSION","CUSTOM_METHOD","RestoreDirection","_serialization","instance","depth","Array","isArray","map","item","snapshot","keys","Object","key","startsWith","value","_deserialization","forEach","newVal","oldVal","_diff","oldData","length","i","valOld","valNew","config","serialization","_serialization","deserialization","_deserialization","diff","_diff","activateConfig","customConfig","Object","assign","_a","AmberTickStore","maxTickLength","tickHistory","baseTick","currentTick","getMinTick","getMaxTick","length","updateTickHistory","splice","snapshot","Map","amberComponentStore","currentHistory","push","shift","newLogicalTick","travel","targetTick","index","historyMap","MessageWriter","error","Error","direction","RestoreDirection","UNDO","REDO","restoreQueue","compClass","historicalData","currentData","getCurrentData","oldData","deserializeComponent","seal","customMethod","Reflect","getMetadata","VIRID_AMBER_METADATA","CUSTOM_METHOD","onRestore","strategy","newData","instance","viridApp","get","forEach","resetTickStore","AmberComponentStore","maxComponentHistorySize","componentHistory","biasVersions","serializeComponent","name","serializeFn","serialize","e","data","deserializeFn","deserialize","diffComponent","old_data","diffFn","initComponent","set","defineMetadata","VERSION","getMinVersion","getMaxVersion","stack","bias","baseVersion","currentSnapshot","onBeforeBackup","currentLogicalVersion","latestLogicalVersion","newLogicalVersion","onAfterBackup","seek","targetVersion","physicalIndex","currentVersion","amberTickStore","resetComponentInternal","resetComponent","Amber","getVersion","compClass","Reflect","getMetadata","VIRID_AMBER_METADATA","VERSION","canUndo","current","min","amberComponentStore","getMinVersion","canRedo","max","getMaxVersion","undo","seek","redo","undoTick","canUndoTick","targetTick","amberTickStore","currentTick","travel","redoTick","canRedoTick","minTick","getMinTick","maxTick","getMaxTick","resetTick","resetTickStore","resetComponent","resetAll","Array","from","componentHistory","keys","forEach","resetComponentInternal","_Amber","import_core","dirtyBuffer","Set","afterExecuteHooks","__name","message","context","ErrorMessage","WarnMessage","InfoMessage","AtomicModifyMessage","params","ComponentClass","forEach","paramClass","Reflect","hasMetadata","VIRID_AMBER_METADATA","BACKUP","add","afterTickHooks","_context","size","compClass","amberComponentStore","seal","amberTickStore","updateTickHistory","clear","activeApp","activateApp","app","options","onAfterTick","afterTickHooks","onAfterExecute","BaseMessage","afterExecuteHooks","activateConfig","amberInitHook","__name","instance","Reflect","hasMetadata","VIRID_AMBER_METADATA","VERSION","amberComponentStore","initComponent","addActivationHook","viridApp","Proxy","get","_","prop","args","MessageWriter","warn","String","targetMethod","apply","Backup","strategy","target","Reflect","defineMetadata","VIRID_AMBER_METADATA","BACKUP","VERSION","CUSTOM_METHOD","AmberPlugin","name","install","app","options","activateApp"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/app.ts","../src/amber/store.ts","../src/decorators/constant.ts","../src/interfaces/decorator.ts","../src/amber/amber.ts","../src/amber/hooks.ts","../src/decorators/decorator.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Add replay, redo, undo and other functions to virid.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { activateApp } from \"./app\";\nimport { PluginOptions } from \"./interfaces\";\nexport * from \"./amber\";\nexport * from \"./decorators\";\nexport * from \"./interfaces\";\nexport const AmberPlugin: ViridPlugin<PluginOptions> = {\n name: \"@virid/amber\",\n install(app: ViridApp, options) {\n activateApp(app, options);\n },\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { type ViridApp, MessageWriter, BaseMessage } from \"@virid/core\";\nimport {\n amberComponentStore,\n afterExecuteHooks,\n afterTickHooks,\n activateConfig,\n} from \"./amber\";\nimport type { PluginOptions } from \"./interfaces\";\nimport { VIRID_AMBER_METADATA } from \"./decorators/constant\";\nexport interface IViridApp {\n get(identifier: any): any;\n}\n\nlet activeApp: IViridApp | null = null;\n\nexport function activateApp(app: ViridApp, options: PluginOptions) {\n //注册钩子\n app.onAfterTick(afterTickHooks, true);\n app.onAfterExecute(BaseMessage, afterExecuteHooks, true);\n //看看用户提供的配置\n activateConfig(options);\n const amberInitHook = (instance: any) => {\n if (\n instance &&\n Reflect.hasMetadata(VIRID_AMBER_METADATA.VERSION, instance.constructor)\n ) {\n //实例化的时候，init第一个版本\n amberComponentStore.initComponent(instance);\n }\n return instance;\n };\n app.addActivationHook(amberInitHook);\n activeApp = app;\n}\n\n/**\n * viridApp 代理\n */\nexport const viridApp: IViridApp = new Proxy({} as IViridApp, {\n get(_, prop: keyof IViridApp) {\n return (...args: any[]) => {\n if (!activeApp) {\n MessageWriter.warn(\n `[Virid Vue] App method \"${String(prop)}\" called before initialization.`,\n );\n return null;\n }\n\n const targetMethod = activeApp[prop];\n if (typeof targetMethod === \"function\") {\n return Reflect.apply(targetMethod, activeApp, args);\n }\n };\n },\n});\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { MessageWriter } from \"@virid/core\";\nimport { viridApp } from \"../app\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\nimport { RestoreDirection, type PluginOptions } from \"../interfaces\";\nimport { type VersionMetadata, type CustomMethodMetadata } from \"../interfaces\";\n\nimport { _serialization, _deserialization, _diff } from \"./utils\";\nlet config: PluginOptions;\n\nexport function activateConfig(customConfig: PluginOptions) {\n config = customConfig;\n amberComponentStore.maxComponentLength = config.maxComponentLength;\n amberTickStore.maxTickLength = config.maxTickLength;\n}\n\nclass AmberTickStore {\n // 快照镜像\n private tickHistory: Array<Map<any, any>> = [];\n\n // 记录数组第 0 位对应的真实 Tick 号\n public baseTick = 0;\n\n public maxTickLength: number;\n // 当前处于哪个逻辑 Tick\n public currentTick = 0;\n\n constructor(maxTickLength: number = 20) {\n this.maxTickLength = maxTickLength;\n }\n /**\n * 获取最小可用Tick\n */\n public getMinTick(): number {\n return this.baseTick;\n }\n\n /**\n * 获取最大的Tick\n */\n public getMaxTick(): number {\n if (this.tickHistory.length === 0) return 0;\n return this.baseTick + this.tickHistory.length - 1;\n }\n /**\n * 记录当前的宏观快照\n */\n public updateTickHistory() {\n // 剪枝\n if (this.currentTick < this.baseTick + this.tickHistory.length) {\n // 剪掉后面的平行宇宙\n this.tickHistory.splice(this.currentTick - this.baseTick + 1);\n }\n\n // 增加加新快照\n const snapshot = new Map(amberComponentStore.currentHistory);\n this.tickHistory.push(snapshot);\n\n // 滑动窗口处理\n if (this.tickHistory.length > this.maxTickLength) {\n this.tickHistory.shift();\n this.baseTick++;\n }\n const newLogicalTick = this.baseTick + this.tickHistory.length - 1;\n // 更新指针到最新产生的这个 Tick\n this.currentTick = newLogicalTick;\n }\n\n /**\n * 全局时空旅行\n */\n public travel(targetTick: number) {\n // 计算物理索引\n const index = targetTick - this.baseTick;\n const historyMap = this.tickHistory[index];\n\n if (!historyMap) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Travel Error: Tick ${targetTick} is out of history range.`,\n ),\n );\n return;\n }\n\n const direction =\n targetTick < this.currentTick\n ? RestoreDirection.UNDO\n : RestoreDirection.REDO;\n\n // 准备一个队列，用于最后统一执行钩子\n const restoreQueue: Array<{\n strategy: any;\n oldData: any;\n newData: any;\n }> = [];\n // 遍历快照中的所有组件类\n for (const [compClass, historicalData] of historyMap) {\n const currentData = amberComponentStore.getCurrentData(compClass);\n // 只有数据不一致时才处理\n if (historicalData !== currentData) {\n const oldData = currentData;\n // 执行物理恢复\n amberComponentStore.deserializeComponent(compClass, historicalData);\n\n // 更新微观层的快照记录\n amberComponentStore.seal(compClass);\n\n // 收集钩子\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onRestore) {\n restoreQueue.push({\n strategy: customMethod,\n oldData,\n newData: historicalData,\n });\n }\n }\n const instance = viridApp.get(compClass);\n }\n\n // 更新宏观时空指针\n this.currentTick = targetTick;\n\n // 统一派发副作用钩子\n restoreQueue.forEach(({ strategy, oldData, newData }) => {\n strategy.onRestore(oldData, newData, direction);\n });\n }\n /**\n * 重置宏观时间轴\n */\n public resetTickStore() {\n // 彻底清空旧的磁带\n this.tickHistory = [];\n this.baseTick = 0;\n this.currentTick = 0;\n\n // 立刻保存一份当前的“现状”作为新起点\n this.updateTickHistory();\n }\n}\n\nclass AmberComponentStore {\n public componentHistory = new Map<any, any[]>();\n // 记录每个组件消失的历史总数\n public biasVersions = new Map<any, number>();\n public maxComponentLength: number;\n // 记录当前每个组件都是什么版本\n public currentHistory = new Map<any, any>();\n // 记录每个组件消失的历史总数\n constructor(maxComponentLength: number = 20) {\n this.maxComponentLength = maxComponentLength;\n }\n /**\n * 将component 的数据进行序列化\n */\n public serializeComponent(compClass: any) {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Serialize Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return null;\n }\n\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const serializeFn = customMethod?.serialize || config.serialization;\n try {\n return serializeFn(instance);\n } catch (e) {\n MessageWriter.error(\n e as Error,\n `[Virid Amber] Serialize Error: Component ${compClass.name} serialization error`,\n );\n }\n return null;\n }\n /**\n * 将component 的数据反序列化\n */\n public deserializeComponent(compClass: any, data: any) {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Deserialize Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return;\n }\n if (!data) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Deserialize Error: Component ${compClass.name} data is ${data}!.`,\n ),\n );\n return;\n }\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const deserializeFn = customMethod?.deserialize || config.deserialization;\n try {\n deserializeFn(instance, data);\n } catch (e) {\n MessageWriter.error(\n e as Error,\n `[Virid Amber] Deserialize Error: Component ${compClass.name} deserialize error`,\n );\n }\n return;\n }\n /**\n * 对比diff\n */\n public diffComponent(compClass: any, old_data: any): boolean {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Diff Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return false;\n }\n if (!old_data) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Diff Error: Component ${compClass.name} data is ${old_data}!.`,\n ),\n );\n return false;\n }\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const diffFn = customMethod?.diff || config.diff;\n try {\n return diffFn(instance, old_data);\n } catch (e) {\n MessageWriter.error(\n e as Error,\n `[Virid Amber] Diff Error: Component ${compClass.name} diff error`,\n );\n }\n return false;\n }\n\n /**\n * 初始化组件的历史记录结构\n */\n public initComponent(instance: any) {\n const compClass = instance.constructor;\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const serializeFn = customMethod?.serialize || config.serialization;\n let data;\n try {\n data = serializeFn(instance);\n } catch (e) {\n MessageWriter.error(\n e as Error,\n `[Virid Amber] Serialize Error: Component ${compClass.name} serialization error`,\n );\n return;\n }\n this.componentHistory.set(compClass, []);\n this.biasVersions.set(compClass, 0);\n\n // 将初始数据推入\n this.componentHistory.get(compClass)!.push(data);\n this.currentHistory.set(compClass, data);\n\n // 初始版本设为 0\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, compClass);\n }\n /**\n * 获取组件当前逻辑版本对应的快照数据\n */\n public getCurrentData(compClass: any): any {\n return this.currentHistory.get(compClass);\n }\n\n /**\n * 获取组件在当前滑动窗口内的最小可用版本\n */\n public getMinVersion(compClass: any): number {\n return this.biasVersions.get(compClass) ?? 0;\n }\n\n /**\n * 获取组件在当前物理栈内存在的最大版本（包括撤销后的“未来”）\n */\n public getMaxVersion(compClass: any): number {\n const stack = this.componentHistory.get(compClass);\n const bias = this.biasVersions.get(compClass) ?? 0;\n if (!stack || stack.length === 0) return bias;\n return bias + stack.length - 1;\n }\n\n /**\n * 给一个component 打快照\n * @param compClass 构造函数\n * @returns\n */\n public seal(compClass: any) {\n const stack = this.componentHistory.get(compClass);\n if (!stack) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not initialized.`,\n ),\n );\n return;\n }\n const baseVersion = this.biasVersions.get(compClass)!;\n\n const currentSnapshot = this.getCurrentData(compClass);\n // diff判断\n if (currentSnapshot && !this.diffComponent(compClass, currentSnapshot)) {\n return;\n }\n\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onBeforeBackup) {\n customMethod.onBeforeBackup(currentSnapshot);\n }\n\n // 剪枝\n const currentLogicalVersion: VersionMetadata =\n Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n const latestLogicalVersion = baseVersion + stack.length - 1;\n if (currentLogicalVersion < latestLogicalVersion) {\n stack.splice(currentLogicalVersion - baseVersion + 1);\n }\n\n // 序列化\n const newData = this.serializeComponent(compClass);\n if (!newData) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not serializable.`,\n ),\n );\n return;\n }\n stack.push(newData);\n this.currentHistory.set(compClass, newData);\n // 滑动窗口与元数据更新\n if (stack.length > this.maxComponentLength) {\n stack.shift();\n this.biasVersions.set(compClass, baseVersion + 1);\n }\n\n const newLogicalVersion =\n this.biasVersions.get(compClass)! + stack.length - 1;\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.VERSION,\n newLogicalVersion,\n compClass,\n );\n if (customMethod?.onAfterBackup) {\n customMethod.onAfterBackup(newData);\n }\n }\n /**\n * 回退到指定版本\n * @param compClass component构造函数\n * @param targetVersion 目标版本\n * @returns\n */\n public seek(compClass: any, targetVersion: number): boolean {\n // 边界检查\n const stack = this.componentHistory.get(compClass);\n if (!stack) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not initialized.`,\n ),\n );\n return false;\n }\n const baseVersion = this.biasVersions.get(compClass) || 0;\n\n const physicalIndex = targetVersion - baseVersion;\n if (physicalIndex < 0 || physicalIndex >= stack.length) return false;\n\n // 状态对比准备\n const oldData = this.getCurrentData(compClass);\n const newData = stack[physicalIndex];\n const currentVersion: VersionMetadata =\n Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n\n const direction =\n targetVersion < currentVersion\n ? RestoreDirection.UNDO\n : RestoreDirection.REDO;\n\n // 执行反序列化\n this.deserializeComponent(compClass, newData);\n\n // 时空指针同步\n this.currentHistory.set(compClass, newData);\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.VERSION,\n targetVersion,\n compClass,\n );\n\n // 触发业务钩子\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onRestore) {\n customMethod.onRestore(oldData, newData, direction);\n }\n\n // 告诉时间轴，有个零件变了\n amberTickStore.updateTickHistory();\n return true;\n }\n /**\n * 重置逻辑\n */\n public resetComponentInternal(compClass: any) {\n const newData = this.serializeComponent(compClass);\n if (!newData) return;\n\n // 物理清理\n this.componentHistory.set(compClass, [newData]);\n this.biasVersions.set(compClass, 0);\n this.currentHistory.set(compClass, newData);\n\n // 元数据归零\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, compClass);\n }\n\n public resetComponent(compClass: any) {\n this.resetComponentInternal(compClass);\n // 只有局部重置时，才主动触发宏观记录\n amberTickStore.updateTickHistory();\n }\n}\n\nexport const amberTickStore = new AmberTickStore();\nexport const amberComponentStore = new AmberComponentStore();","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { VIRID_METADATA } from \"@virid/core\";\nexport const VIRID_AMBER_METADATA = {\n ...VIRID_METADATA,\n BACKUP: \"virid:amber:backup\",\n VERSION: \"virid:amber:version\",\n CUSTOM_METHOD: \"virid:amber:custom-method\",\n} as const;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nexport enum RestoreDirection {\n UNDO = \"UNDO\",\n REDO = \"REDO\",\n}\n\nexport interface BackupStrategy<T = any, C = any> {\n /**\n * 自定义序列化：将实例转换为可存储的对象\n */\n serialize?: (instance: T) => C;\n\n /**\n * 自定义反序列化：将数据灌回实例\n */\n deserialize?: (instance: T, data: C) => void;\n\n /**\n * 自定义 Diff：返回 true 表示有变化，需要触发备份\n */\n diff?: (oldData: C, instance: T) => boolean;\n onBeforeBackup?: (oldData: C) => void;\n onAfterBackup?: (newData: C) => void;\n onRestore?: (oldData: C, newData: C, direction: RestoreDirection) => void;\n}\n\nexport type VersionMetadata = number;\nexport type BackupMetadata = boolean;\nexport type CustomMethodMetadata = BackupStrategy;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { amberComponentStore, amberTickStore } from \"./store\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\n\nexport class Amber {\n /**\n * 获取组件当前的逻辑版本号\n */\n public static getVersion(compClass: any): number {\n return Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n }\n\n public static canUndo(compClass: any): boolean {\n const current = this.getVersion(compClass);\n const min = amberComponentStore.getMinVersion(compClass);\n\n return current > min;\n }\n\n public static canRedo(compClass: any): boolean {\n const current = this.getVersion(compClass);\n const max = amberComponentStore.getMaxVersion(compClass);\n\n return current < max;\n }\n\n /**\n * 局部撤销：将单个组件回退一个版本\n * 结果：产生新 Tick，代表“我回到了过去”\n */\n public static undo(compClass: any): boolean {\n if (!this.canUndo(compClass)) return false;\n const current = this.getVersion(compClass);\n const result = amberComponentStore.seek(compClass, current - 1);\n\n return result;\n }\n\n /**\n * 局部重做：将单个组件向前进一个版本\n */\n public static redo(compClass: any): boolean {\n if (!this.canRedo(compClass)) return false;\n const current = this.getVersion(compClass);\n const result = amberComponentStore.seek(compClass, current + 1);\n\n return result;\n }\n /**\n * 全局撤销\n */\n public static undoTick(): boolean {\n if (!this.canUndoTick()) return false;\n const targetTick = amberTickStore.currentTick - 1;\n amberTickStore.travel(targetTick);\n return true;\n }\n\n /**\n * 全局重做\n */\n public static redoTick(): boolean {\n if (!this.canRedoTick()) return false;\n const targetTick = amberTickStore.currentTick + 1;\n amberTickStore.travel(targetTick);\n return true;\n }\n\n /**\n * UI 状态判断：是否还能点撤销\n */\n public static canUndoTick(): boolean {\n const currentTick = amberTickStore.currentTick;\n const minTick = amberTickStore.getMinTick();\n\n return currentTick > minTick;\n }\n\n /**\n * UI 状态判断：是否还能点重做\n */\n public static canRedoTick(): boolean {\n const currentTick = amberTickStore.currentTick;\n const maxTick = amberTickStore.getMaxTick();\n\n return currentTick < maxTick;\n }\n\n /**\n * 重置宏观时间轴\n * 清空所有全局快照，用户无法再进行 undoTick/redoTick，\n * 但各个组件当前的微观版本栈保持不变。\n */\n public static resetTick(): void {\n amberTickStore.resetTickStore();\n }\n\n /**\n * 重置特定组件的历史\n * 该组件的旧版本被物理抹除，当前状态变为 V0。\n * 会自动触发一次 updateTickHistory，记录这一时刻的全局状态。\n */\n public static resetComponent(compClass: any): void {\n amberComponentStore.resetComponent(compClass);\n }\n // 建议添加到 Amber 类中\n public static resetAll(): void {\n // 获取所有存活组件\n const classes = Array.from(amberComponentStore.componentHistory.keys());\n // 清空每个组件（静默重置，不触发 updateTickHistory）\n classes.forEach((compClass) => {\n // 我们可以给 resetComponent 加个参数，或者拆分出一个内部方法\n amberComponentStore.resetComponentInternal(compClass);\n });\n // 重置宏观磁带\n amberTickStore.resetTickStore();\n }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport {\n type ExecuteHook,\n type TickHook,\n BaseMessage,\n ErrorMessage,\n WarnMessage,\n InfoMessage,\n} from \"@virid/core\";\nimport { amberComponentStore, amberTickStore } from \"./store\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\n\nconst dirtyBuffer = new Set<any>();\n\nexport const afterExecuteHooks: ExecuteHook<BaseMessage> = (\n message,\n context,\n) => {\n if (\n message instanceof ErrorMessage ||\n message instanceof WarnMessage ||\n message instanceof InfoMessage\n )\n return;\n\n const allParams = context.context.params;\n\n allParams.forEach((paramClass) => {\n if (Reflect.hasMetadata(VIRID_AMBER_METADATA.BACKUP, paramClass)) {\n dirtyBuffer.add(paramClass);\n }\n });\n};\n\nexport const afterTickHooks: TickHook = (_context) => {\n if (dirtyBuffer.size === 0) return;\n\n // 微观更新\n dirtyBuffer.forEach((compClass) => {\n amberComponentStore.seal(compClass);\n });\n\n // 宏观更新\n amberTickStore.updateTickHistory();\n\n // 清理缓存，准备下一轮\n dirtyBuffer.clear();\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { VIRID_AMBER_METADATA } from \"./constant\";\nimport { type BackupStrategy } from \"../interfaces\";\n\n/**\n * @description: 标记 Backup 身份并配置自定义备份策略\n * @param strategy 可选的自定义序列化/反序列化/Diff 方案\n */\nexport function Backup<T extends new (...args: any[]) => any, C = any>(\n strategy?: BackupStrategy<InstanceType<T>, C>,\n) {\n return (target: T) => {\n // 标记需要备份\n Reflect.defineMetadata(VIRID_AMBER_METADATA.BACKUP, true, target);\n // 初始化版本号\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, target);\n // 如果用户给了自定义方法，存入元数据\n if (strategy) {\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n strategy,\n target,\n );\n }\n };\n}\n"],"mappings":"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","names":["index_exports","__export","Amber","AmberPlugin","Backup","RestoreDirection","activateConfig","afterExecuteHooks","afterTickHooks","amberComponentStore","amberTickStore","__toCommonJS","import_core","import_core","import_core","VIRID_AMBER_METADATA","VIRID_METADATA","BACKUP","VERSION","CUSTOM_METHOD","RestoreDirection","config","activateConfig","customConfig","amberComponentStore","maxComponentLength","amberTickStore","maxTickLength","_a","AmberTickStore","tickHistory","baseTick","currentTick","getMinTick","getMaxTick","length","updateTickHistory","splice","snapshot","Map","currentHistory","push","shift","newLogicalTick","travel","targetTick","index","historyMap","MessageWriter","error","Error","direction","RestoreDirection","UNDO","REDO","restoreQueue","compClass","historicalData","currentData","getCurrentData","oldData","deserializeComponent","seal","customMethod","Reflect","getMetadata","VIRID_AMBER_METADATA","CUSTOM_METHOD","onRestore","strategy","newData","instance","viridApp","get","forEach","resetTickStore","AmberComponentStore","componentHistory","biasVersions","serializeComponent","name","serializeFn","serialize","serialization","e","data","deserializeFn","deserialize","deserialization","diffComponent","old_data","diffFn","diff","initComponent","set","defineMetadata","VERSION","getMinVersion","getMaxVersion","stack","bias","baseVersion","currentSnapshot","onBeforeBackup","currentLogicalVersion","latestLogicalVersion","newLogicalVersion","onAfterBackup","seek","targetVersion","physicalIndex","currentVersion","resetComponentInternal","resetComponent","Amber","getVersion","compClass","Reflect","getMetadata","VIRID_AMBER_METADATA","VERSION","canUndo","current","min","amberComponentStore","getMinVersion","canRedo","max","getMaxVersion","undo","seek","redo","undoTick","canUndoTick","targetTick","amberTickStore","currentTick","travel","redoTick","canRedoTick","minTick","getMinTick","maxTick","getMaxTick","resetTick","resetTickStore","resetComponent","resetAll","Array","from","componentHistory","keys","forEach","resetComponentInternal","_Amber","import_core","dirtyBuffer","Set","afterExecuteHooks","__name","message","context","ErrorMessage","WarnMessage","InfoMessage","params","forEach","paramClass","Reflect","hasMetadata","VIRID_AMBER_METADATA","BACKUP","add","afterTickHooks","_context","size","compClass","amberComponentStore","seal","amberTickStore","updateTickHistory","clear","activeApp","activateApp","app","options","onAfterTick","afterTickHooks","onAfterExecute","BaseMessage","afterExecuteHooks","activateConfig","amberInitHook","__name","instance","Reflect","hasMetadata","VIRID_AMBER_METADATA","VERSION","amberComponentStore","initComponent","addActivationHook","viridApp","Proxy","get","_","prop","args","MessageWriter","warn","String","targetMethod","apply","Backup","strategy","target","Reflect","defineMetadata","VIRID_AMBER_METADATA","BACKUP","VERSION","CUSTOM_METHOD","AmberPlugin","name","install","app","options","activateApp"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
import { ExecuteHook, BaseMessage, TickHook, ViridPlugin } from '@virid/core';
|
|
2
2
|
|
|
3
3
|
interface PluginOptions {
|
|
4
|
-
serialization
|
|
5
|
-
deserialization
|
|
6
|
-
diff
|
|
4
|
+
serialization: (instance: any) => any;
|
|
5
|
+
deserialization: (instance: any, data: any) => any;
|
|
6
|
+
diff: (data: any, instance: any) => boolean;
|
|
7
|
+
maxComponentLength: number;
|
|
8
|
+
maxTickLength: number;
|
|
7
9
|
}
|
|
8
10
|
|
|
9
11
|
declare enum RestoreDirection {
|
|
@@ -112,9 +114,9 @@ declare class AmberTickStore {
|
|
|
112
114
|
declare class AmberComponentStore {
|
|
113
115
|
componentHistory: Map<any, any[]>;
|
|
114
116
|
biasVersions: Map<any, number>;
|
|
115
|
-
|
|
117
|
+
maxComponentLength: number;
|
|
116
118
|
currentHistory: Map<any, any>;
|
|
117
|
-
constructor(
|
|
119
|
+
constructor(maxComponentLength?: number);
|
|
118
120
|
/**
|
|
119
121
|
* 将component 的数据进行序列化
|
|
120
122
|
*/
|
package/dist/index.d.ts
CHANGED
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
import { ExecuteHook, BaseMessage, TickHook, ViridPlugin } from '@virid/core';
|
|
2
2
|
|
|
3
3
|
interface PluginOptions {
|
|
4
|
-
serialization
|
|
5
|
-
deserialization
|
|
6
|
-
diff
|
|
4
|
+
serialization: (instance: any) => any;
|
|
5
|
+
deserialization: (instance: any, data: any) => any;
|
|
6
|
+
diff: (data: any, instance: any) => boolean;
|
|
7
|
+
maxComponentLength: number;
|
|
8
|
+
maxTickLength: number;
|
|
7
9
|
}
|
|
8
10
|
|
|
9
11
|
declare enum RestoreDirection {
|
|
@@ -112,9 +114,9 @@ declare class AmberTickStore {
|
|
|
112
114
|
declare class AmberComponentStore {
|
|
113
115
|
componentHistory: Map<any, any[]>;
|
|
114
116
|
biasVersions: Map<any, number>;
|
|
115
|
-
|
|
117
|
+
maxComponentLength: number;
|
|
116
118
|
currentHistory: Map<any, any>;
|
|
117
|
-
constructor(
|
|
119
|
+
constructor(maxComponentLength?: number);
|
|
118
120
|
/**
|
|
119
121
|
* 将component 的数据进行序列化
|
|
120
122
|
*/
|
package/dist/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @virid/amber v0.
|
|
2
|
+
* @virid/amber v0.2.2
|
|
3
3
|
* Add replay, redo, undo and other functions to virid
|
|
4
4
|
*/
|
|
5
|
-
var
|
|
5
|
+
var x=Object.defineProperty;var z=(i,t,e)=>t in i?x(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e;var f=(i,t)=>x(i,"name",{value:t,configurable:!0});var T=(i,t,e)=>z(i,typeof t!="symbol"?t+"":t,e);import{MessageWriter as C,BaseMessage as L}from"@virid/core";import{MessageWriter as h}from"@virid/core";import{VIRID_METADATA as w}from"@virid/core";var n={...w,BACKUP:"virid:amber:backup",VERSION:"virid:amber:version",CUSTOM_METHOD:"virid:amber:custom-method"};var g=(function(i){return i.UNDO="UNDO",i.REDO="REDO",i})({});var k;function H(i){k=i,a.maxComponentLength=k.maxComponentLength,c.maxTickLength=k.maxTickLength}f(H,"activateConfig");var l,U=(l=class{constructor(t=20){T(this,"tickHistory",[]);T(this,"baseTick",0);T(this,"maxTickLength");T(this,"currentTick",0);this.maxTickLength=t}getMinTick(){return this.baseTick}getMaxTick(){return this.tickHistory.length===0?0:this.baseTick+this.tickHistory.length-1}updateTickHistory(){this.currentTick<this.baseTick+this.tickHistory.length&&this.tickHistory.splice(this.currentTick-this.baseTick+1);let t=new Map(a.currentHistory);this.tickHistory.push(t),this.tickHistory.length>this.maxTickLength&&(this.tickHistory.shift(),this.baseTick++);let e=this.baseTick+this.tickHistory.length-1;this.currentTick=e}travel(t){let e=t-this.baseTick,r=this.tickHistory[e];if(!r){h.error(new Error(`[Virid Amber] Travel Error: Tick ${t} is out of history range.`));return}let u=t<this.currentTick?g.UNDO:g.REDO,o=[];for(let[s,m]of r){let d=a.getCurrentData(s);if(m!==d){let A=d;a.deserializeComponent(s,m),a.seal(s);let D=Reflect.getMetadata(n.CUSTOM_METHOD,s);D?.onRestore&&o.push({strategy:D,oldData:A,newData:m})}let E=p.get(s)}this.currentTick=t,o.forEach(({strategy:s,oldData:m,newData:d})=>{s.onRestore(m,d,u)})}resetTickStore(){this.tickHistory=[],this.baseTick=0,this.currentTick=0,this.updateTickHistory()}},f(l,"AmberTickStore"),l),M,_=(M=class{constructor(t=20){T(this,"componentHistory",new Map);T(this,"biasVersions",new Map);T(this,"maxComponentLength");T(this,"currentHistory",new Map);this.maxComponentLength=t}serializeComponent(t){let e=p.get(t);if(!e)return h.error(new Error(`[Virid Amber] Serialize Error: Component ${t.name} is not registered.`)),null;let u=Reflect.getMetadata(n.CUSTOM_METHOD,t)?.serialize||k.serialization;try{return u(e)}catch(o){h.error(o,`[Virid Amber] Serialize Error: Component ${t.name} serialization error`)}return null}deserializeComponent(t,e){let r=p.get(t);if(!r){h.error(new Error(`[Virid Amber] Deserialize Error: Component ${t.name} is not registered.`));return}if(!e){h.error(new Error(`[Virid Amber] Deserialize Error: Component ${t.name} data is ${e}!.`));return}let o=Reflect.getMetadata(n.CUSTOM_METHOD,t)?.deserialize||k.deserialization;try{o(r,e)}catch(s){h.error(s,`[Virid Amber] Deserialize Error: Component ${t.name} deserialize error`)}}diffComponent(t,e){let r=p.get(t);if(!r)return h.error(new Error(`[Virid Amber] Diff Error: Component ${t.name} is not registered.`)),!1;if(!e)return h.error(new Error(`[Virid Amber] Diff Error: Component ${t.name} data is ${e}!.`)),!1;let o=Reflect.getMetadata(n.CUSTOM_METHOD,t)?.diff||k.diff;try{return o(r,e)}catch(s){h.error(s,`[Virid Amber] Diff Error: Component ${t.name} diff error`)}return!1}initComponent(t){let e=t.constructor,u=Reflect.getMetadata(n.CUSTOM_METHOD,e)?.serialize||k.serialization,o;try{o=u(t)}catch(s){h.error(s,`[Virid Amber] Serialize Error: Component ${e.name} serialization error`);return}this.componentHistory.set(e,[]),this.biasVersions.set(e,0),this.componentHistory.get(e).push(o),this.currentHistory.set(e,o),Reflect.defineMetadata(n.VERSION,0,e)}getCurrentData(t){return this.currentHistory.get(t)}getMinVersion(t){return this.biasVersions.get(t)??0}getMaxVersion(t){let e=this.componentHistory.get(t),r=this.biasVersions.get(t)??0;return!e||e.length===0?r:r+e.length-1}seal(t){let e=this.componentHistory.get(t);if(!e){h.error(new Error(`[Virid Amber] Seal Error: Component ${t.name} is not initialized.`));return}let r=this.biasVersions.get(t),u=this.getCurrentData(t);if(u&&!this.diffComponent(t,u))return;let o=Reflect.getMetadata(n.CUSTOM_METHOD,t);o?.onBeforeBackup&&o.onBeforeBackup(u);let s=Reflect.getMetadata(n.VERSION,t)||0,m=r+e.length-1;s<m&&e.splice(s-r+1);let d=this.serializeComponent(t);if(!d){h.error(new Error(`[Virid Amber] Seal Error: Component ${t.name} is not serializable.`));return}e.push(d),this.currentHistory.set(t,d),e.length>this.maxComponentLength&&(e.shift(),this.biasVersions.set(t,r+1));let E=this.biasVersions.get(t)+e.length-1;Reflect.defineMetadata(n.VERSION,E,t),o?.onAfterBackup&&o.onAfterBackup(d)}seek(t,e){let r=this.componentHistory.get(t);if(!r)return h.error(new Error(`[Virid Amber] Seal Error: Component ${t.name} is not initialized.`)),!1;let u=this.biasVersions.get(t)||0,o=e-u;if(o<0||o>=r.length)return!1;let s=this.getCurrentData(t),m=r[o],d=Reflect.getMetadata(n.VERSION,t)||0,E=e<d?g.UNDO:g.REDO;this.deserializeComponent(t,m),this.currentHistory.set(t,m),Reflect.defineMetadata(n.VERSION,e,t);let A=Reflect.getMetadata(n.CUSTOM_METHOD,t);return A?.onRestore&&A.onRestore(s,m,E),c.updateTickHistory(),!0}resetComponentInternal(t){let e=this.serializeComponent(t);e&&(this.componentHistory.set(t,[e]),this.biasVersions.set(t,0),this.currentHistory.set(t,e),Reflect.defineMetadata(n.VERSION,0,t))}resetComponent(t){this.resetComponentInternal(t),c.updateTickHistory()}},f(M,"AmberComponentStore"),M),c=new U,a=new _;var b=class b{static getVersion(t){return Reflect.getMetadata(n.VERSION,t)||0}static canUndo(t){let e=this.getVersion(t),r=a.getMinVersion(t);return e>r}static canRedo(t){let e=this.getVersion(t),r=a.getMaxVersion(t);return e<r}static undo(t){if(!this.canUndo(t))return!1;let e=this.getVersion(t);return a.seek(t,e-1)}static redo(t){if(!this.canRedo(t))return!1;let e=this.getVersion(t);return a.seek(t,e+1)}static undoTick(){if(!this.canUndoTick())return!1;let t=c.currentTick-1;return c.travel(t),!0}static redoTick(){if(!this.canRedoTick())return!1;let t=c.currentTick+1;return c.travel(t),!0}static canUndoTick(){let t=c.currentTick,e=c.getMinTick();return t>e}static canRedoTick(){let t=c.currentTick,e=c.getMaxTick();return t<e}static resetTick(){c.resetTickStore()}static resetComponent(t){a.resetComponent(t)}static resetAll(){Array.from(a.componentHistory.keys()).forEach(e=>{a.resetComponentInternal(e)}),c.resetTickStore()}};f(b,"Amber");var y=b;import{ErrorMessage as v,WarnMessage as B,InfoMessage as $}from"@virid/core";var R=new Set,S=f((i,t)=>{if(i instanceof v||i instanceof B||i instanceof $)return;t.context.params.forEach(r=>{Reflect.hasMetadata(n.BACKUP,r)&&R.add(r)})},"afterExecuteHooks"),O=f(i=>{R.size!==0&&(R.forEach(t=>{a.seal(t)}),c.updateTickHistory(),R.clear())},"afterTickHooks");var V=null;function I(i,t){i.onAfterTick(O,!0),i.onAfterExecute(L,S,!0),H(t);let e=f(r=>(r&&Reflect.hasMetadata(n.VERSION,r.constructor)&&a.initComponent(r),r),"amberInitHook");i.addActivationHook(e),V=i}f(I,"activateApp");var p=new Proxy({},{get(i,t){return(...e)=>{if(!V)return C.warn(`[Virid Vue] App method "${String(t)}" called before initialization.`),null;let r=V[t];if(typeof r=="function")return Reflect.apply(r,V,e)}}});function pt(i){return t=>{Reflect.defineMetadata(n.BACKUP,!0,t),Reflect.defineMetadata(n.VERSION,0,t),i&&Reflect.defineMetadata(n.CUSTOM_METHOD,i,t)}}f(pt,"Backup");var Dt={name:"@virid/amber",install(i,t){I(i,t)}};export{y as Amber,Dt as AmberPlugin,pt as Backup,g as RestoreDirection,H as activateConfig,S as afterExecuteHooks,O as afterTickHooks,a as amberComponentStore,c as amberTickStore};
|
|
6
6
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/app.ts","../src/amber/store.ts","../src/decorators/constant.ts","../src/interfaces/decorator.ts","../src/amber/utils.ts","../src/amber/amber.ts","../src/amber/hooks.ts","../src/decorators/decorator.ts","../src/index.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { type ViridApp, MessageWriter, BaseMessage } from \"@virid/core\";\nimport {\n amberComponentStore,\n afterExecuteHooks,\n afterTickHooks,\n activateConfig,\n} from \"./amber\";\nimport type { PluginOptions } from \"./interfaces\";\nimport { VIRID_AMBER_METADATA } from \"./decorators/constant\";\nexport interface IViridApp {\n get(identifier: any): any;\n}\n\nlet activeApp: IViridApp | null = null;\n\nexport function activateApp(app: ViridApp, options: PluginOptions) {\n //注册钩子\n app.onAfterTick(afterTickHooks, true);\n app.onAfterExecute(BaseMessage, afterExecuteHooks, true);\n //看看用户提供的配置\n if (options) activateConfig(options);\n const amberInitHook = (instance) => {\n if (\n instance &&\n Reflect.hasMetadata(VIRID_AMBER_METADATA.VERSION, instance.constructor)\n ) {\n //实例化的时候，init第一个版本\n amberComponentStore.initComponent(instance);\n }\n return instance;\n };\n app.addActivationHook(amberInitHook);\n activeApp = app;\n}\n\n/**\n * viridApp 代理\n */\nexport const viridApp: IViridApp = new Proxy({} as IViridApp, {\n get(_, prop: keyof IViridApp) {\n return (...args: any[]) => {\n // 检查实例是否存在\n if (!activeApp) {\n MessageWriter.warn(\n `[Virid Vue] App method \"${String(prop)}\" called before initialization.`,\n );\n return null;\n }\n\n // 正常转发调用\n // 使用 Reflect 确保 this 指向正确，或者直接从 activeApp 调用\n const targetMethod = activeApp[prop];\n if (typeof targetMethod === \"function\") {\n // @ts-ignore\n return targetMethod.apply(activeApp, args);\n }\n };\n },\n});\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { MessageWriter } from \"@virid/core\";\nimport { viridApp } from \"../app\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\nimport { RestoreDirection, type PluginOptions } from \"../interfaces\";\nimport {\n type VersionMetadata,\n type CustomMethodMetadata,\n} from \"../interfaces\";\n\nimport { _serialization, _deserialization, _diff } from \"./utils\";\nlet config: Required<PluginOptions> = {\n serialization: _serialization,\n deserialization: _deserialization,\n diff: _diff, // 默认总是备份\n};\n\nexport function activateConfig(customConfig: PluginOptions) {\n config = Object.assign(config, customConfig);\n}\n\nclass AmberTickStore {\n // 快照镜像\n private tickHistory: Array<Map<any, any>> = [];\n\n // 记录数组第 0 位对应的真实 Tick 号\n public baseTick = 0;\n\n public maxTickLength = 20;\n // 当前处于哪个逻辑 Tick\n public currentTick = 0;\n\n constructor(maxTickLength: number = 20) {\n this.maxTickLength = maxTickLength;\n }\n /**\n * 获取最小可用Tick\n */\n public getMinTick(): number {\n return this.baseTick;\n }\n\n /**\n * 获取最大的Tick\n */\n public getMaxTick(): number {\n if (this.tickHistory.length === 0) return 0;\n return this.baseTick + this.tickHistory.length - 1;\n }\n /**\n * 记录当前的宏观快照\n */\n public updateTickHistory() {\n // 剪枝\n if (this.currentTick < this.baseTick + this.tickHistory.length) {\n // 剪掉后面的平行宇宙\n this.tickHistory.splice(this.currentTick - this.baseTick + 1);\n }\n\n // 增加加新快照\n const snapshot = new Map(amberComponentStore.currentHistory);\n this.tickHistory.push(snapshot);\n\n // 滑动窗口处理\n if (this.tickHistory.length > this.maxTickLength) {\n this.tickHistory.shift();\n this.baseTick++;\n }\n const newLogicalTick = this.baseTick + this.tickHistory.length - 1;\n // 更新指针到最新产生的这个 Tick\n this.currentTick = newLogicalTick;\n }\n\n /**\n * 全局时空旅行\n */\n public travel(targetTick: number) {\n // 计算物理索引\n const index = targetTick - this.baseTick;\n const historyMap = this.tickHistory[index];\n\n if (!historyMap) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Travel Error: Tick ${targetTick} is out of history range.`,\n ),\n );\n return;\n }\n\n const direction =\n targetTick < this.currentTick\n ? RestoreDirection.UNDO\n : RestoreDirection.REDO;\n\n // 准备一个队列，用于最后统一执行钩子\n const restoreQueue: Array<{\n strategy: any;\n oldData: any;\n newData: any;\n }> = [];\n // 遍历快照中的所有组件类\n for (const [compClass, historicalData] of historyMap) {\n const currentData = amberComponentStore.getCurrentData(compClass);\n // 只有数据不一致时才处理\n if (historicalData !== currentData) {\n const oldData = currentData;\n // 执行物理恢复\n amberComponentStore.deserializeComponent(compClass, historicalData);\n\n // 更新微观层的快照记录\n amberComponentStore.seal(compClass);\n\n // 收集钩子\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onRestore) {\n restoreQueue.push({\n strategy: customMethod,\n oldData,\n newData: historicalData,\n });\n }\n }\n const instance = viridApp.get(compClass);\n }\n\n // 更新宏观时空指针\n this.currentTick = targetTick;\n\n // 统一派发副作用钩子\n restoreQueue.forEach(({ strategy, oldData, newData }) => {\n strategy.onRestore(oldData, newData, direction);\n });\n }\n /**\n * 重置宏观时间轴\n */\n public resetTickStore() {\n // 彻底清空旧的磁带\n this.tickHistory = [];\n this.baseTick = 0;\n this.currentTick = 0;\n\n // 立刻保存一份当前的“现状”作为新起点\n this.updateTickHistory();\n }\n}\n\nclass AmberComponentStore {\n public componentHistory = new Map<any, any[]>();\n // 记录每个组件消失的历史总数\n public biasVersions = new Map<any, number>();\n public maxComponentHistorySize = 20;\n // 记录当前每个组件都是什么版本\n public currentHistory = new Map<any, any>();\n // 记录每个组件消失的历史总数\n constructor(maxComponentHistorySize: number = 20) {\n this.maxComponentHistorySize = maxComponentHistorySize;\n }\n /**\n * 将component 的数据进行序列化\n */\n public serializeComponent(compClass: any) {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Serialize Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return null;\n }\n\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const serializeFn = customMethod?.serialize || config.serialization;\n try {\n return serializeFn(instance);\n } catch (e) {\n MessageWriter.error(\n e,\n `[Virid Amber] Serialize Error: Component ${compClass.name} serialization error`,\n );\n }\n return null;\n }\n /**\n * 将component 的数据反序列化\n */\n public deserializeComponent(compClass: any, data: any) {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Deserialize Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return;\n }\n if (!data) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Deserialize Error: Component ${compClass.name} data is ${data}!.`,\n ),\n );\n return;\n }\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const deserializeFn =\n customMethod?.deserialize || config.deserialization;\n try {\n deserializeFn(instance, data);\n } catch (e) {\n MessageWriter.error(\n e,\n `[Virid Amber] Deserialize Error: Component ${compClass.name} deserialize error`,\n );\n }\n return;\n }\n /**\n * 对比diff\n */\n public diffComponent(compClass: any, old_data: any): boolean {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Diff Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return false;\n }\n if (!old_data) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Diff Error: Component ${compClass.name} data is ${old_data}!.`,\n ),\n );\n return false;\n }\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const diffFn = customMethod?.diff || config.diff;\n try {\n return diffFn(instance, old_data);\n } catch (e) {\n MessageWriter.error(\n e,\n `[Virid Amber] Diff Error: Component ${compClass.name} diff error`,\n );\n }\n return false;\n }\n\n /**\n * 初始化组件的历史记录结构\n */\n public initComponent(instance: any) {\n const compClass = instance.constructor;\n const customMethod:CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const serializeFn = customMethod?.serialize || config.serialization;\n let data;\n try {\n data = serializeFn(instance);\n } catch (e) {\n MessageWriter.error(\n e,\n `[Virid Amber] Serialize Error: Component ${compClass.name} serialization error`,\n );\n return;\n }\n this.componentHistory.set(compClass, []);\n this.biasVersions.set(compClass, 0);\n\n // 将初始数据推入\n this.componentHistory.get(compClass)!.push(data);\n this.currentHistory.set(compClass, data);\n\n // 初始版本设为 0\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, compClass);\n }\n /**\n * 获取组件当前逻辑版本对应的快照数据\n */\n public getCurrentData(compClass: any): any {\n return this.currentHistory.get(compClass);\n }\n\n /**\n * 获取组件在当前滑动窗口内的最小可用版本\n */\n public getMinVersion(compClass: any): number {\n return this.biasVersions.get(compClass) ?? 0;\n }\n\n /**\n * 获取组件在当前物理栈内存在的最大版本（包括撤销后的“未来”）\n */\n public getMaxVersion(compClass: any): number {\n const stack = this.componentHistory.get(compClass);\n const bias = this.biasVersions.get(compClass) ?? 0;\n if (!stack || stack.length === 0) return bias;\n return bias + stack.length - 1;\n }\n\n /**\n * 给一个component 打快照\n * @param compClass 构造函数\n * @returns\n */\n public seal(compClass: any) {\n const stack = this.componentHistory.get(compClass);\n if (!stack) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not initialized.`,\n ),\n );\n }\n const baseVersion = this.biasVersions.get(compClass);\n\n const currentSnapshot = this.getCurrentData(compClass);\n // diff判断\n if (currentSnapshot && !this.diffComponent(compClass, currentSnapshot)) {\n return;\n }\n\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onBeforeBackup) {\n customMethod.onBeforeBackup(currentSnapshot);\n }\n\n // 剪枝\n const currentLogicalVersion:VersionMetadata =\n Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n const latestLogicalVersion = baseVersion + stack.length - 1;\n if (currentLogicalVersion < latestLogicalVersion) {\n stack.splice(currentLogicalVersion - baseVersion + 1);\n }\n\n // 序列化\n const newData = this.serializeComponent(compClass);\n if (!newData) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not serializable.`,\n ),\n );\n return;\n }\n stack.push(newData);\n this.currentHistory.set(compClass, newData);\n // 滑动窗口与元数据更新\n if (stack.length > this.maxComponentHistorySize) {\n stack.shift();\n this.biasVersions.set(compClass, baseVersion + 1);\n }\n\n const newLogicalVersion =\n this.biasVersions.get(compClass)! + stack.length - 1;\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.VERSION,\n newLogicalVersion,\n compClass,\n );\n if (customMethod?.onAfterBackup) {\n customMethod.onAfterBackup(newData);\n }\n }\n /**\n * 回退到指定版本\n * @param compClass component构造函数\n * @param targetVersion 目标版本\n * @returns\n */\n public seek(compClass: any, targetVersion: number): boolean {\n // 边界检查\n const stack = this.componentHistory.get(compClass);\n if (!stack) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not initialized.`,\n ),\n );\n return false;\n }\n const baseVersion = this.biasVersions.get(compClass) || 0;\n\n const physicalIndex = targetVersion - baseVersion;\n if (physicalIndex < 0 || physicalIndex >= stack.length) return false;\n\n // 状态对比准备\n const oldData = this.getCurrentData(compClass);\n const newData = stack[physicalIndex];\n const currentVersion:VersionMetadata =\n Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n\n const direction =\n targetVersion < currentVersion\n ? RestoreDirection.UNDO\n : RestoreDirection.REDO;\n\n // 执行反序列化\n this.deserializeComponent(compClass, newData);\n\n // 时空指针同步\n this.currentHistory.set(compClass, newData);\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, targetVersion, compClass);\n\n // 触发业务钩子\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onRestore) {\n customMethod.onRestore(oldData, newData, direction);\n }\n\n // 告诉时间轴，有个零件变了\n amberTickStore.updateTickHistory();\n return true;\n }\n /**\n * 重置逻辑\n */\n public resetComponentInternal(compClass: any) {\n const newData = this.serializeComponent(compClass);\n if (!newData) return;\n\n // 物理清理\n this.componentHistory.set(compClass, [newData]);\n this.biasVersions.set(compClass, 0);\n this.currentHistory.set(compClass, newData);\n\n // 元数据归零\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, compClass);\n }\n\n public resetComponent(compClass: any) {\n this.resetComponentInternal(compClass);\n // 只有局部重置时，才主动触发宏观记录\n amberTickStore.updateTickHistory();\n }\n}\n\nexport const amberTickStore = new AmberTickStore();\nexport const amberComponentStore = new AmberComponentStore();\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { VIRID_METADATA } from \"@virid/core\";\nexport const VIRID_AMBER_METADATA = {\n ...VIRID_METADATA,\n BACKUP: \"virid:amber:backup\",\n VERSION: \"virid:amber:version\",\n CUSTOM_METHOD: \"virid:amber:custom-method\",\n} as const;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nexport enum RestoreDirection {\n UNDO = \"UNDO\",\n REDO = \"REDO\",\n}\n\nexport interface BackupStrategy<T = any, C = any> {\n /**\n * 自定义序列化：将实例转换为可存储的对象\n */\n serialize?: (instance: T) => C;\n\n /**\n * 自定义反序列化：将数据灌回实例\n */\n deserialize?: (instance: T, data: C) => void;\n\n /**\n * 自定义 Diff：返回 true 表示有变化，需要触发备份\n */\n diff?: (oldData: C, instance: T) => boolean;\n onBeforeBackup?: (oldData: C) => void;\n onAfterBackup?: (newData: C) => void;\n onRestore?: (oldData: C, newData: C, direction: RestoreDirection) => void;\n}\n\nexport type VersionMetadata = number;\nexport type BackupMetadata = boolean;\nexport type CustomMethodMetadata = BackupStrategy;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\n/**\n * 默认 serialization\n */\nexport function _serialization(instance: any, depth = 5): any {\n if (instance === null || typeof instance !== \"object\") return instance;\n if (depth <= 0) return Array.isArray(instance) ? [] : {};\n\n if (Array.isArray(instance)) {\n return instance.map((item) => _serialization(item, depth - 1));\n }\n\n const snapshot: any = {};\n const keys = Object.keys(instance);\n\n for (const key of keys) {\n if (key.startsWith(\"_\")) continue;\n\n const value = instance[key];\n if (typeof value === \"function\") continue;\n\n snapshot[key] =\n typeof value === \"object\" && value !== null\n ? _serialization(value, depth - 1)\n : value;\n }\n return snapshot;\n}\n/**\n * 默认 deserialization\n */\nexport function _deserialization(instance: any, snapshot: any) {\n if (!instance || !snapshot) return;\n\n Object.keys(snapshot).forEach((key) => {\n const newVal = snapshot[key];\n const oldVal = instance[key];\n // 继续递归，而不是直接覆盖对象引用\n if (\n oldVal &&\n typeof oldVal === \"object\" &&\n newVal &&\n typeof newVal === \"object\" &&\n !Array.isArray(newVal)\n ) {\n _deserialization(oldVal, newVal);\n } else {\n // 直接赋值\n instance[key] = newVal;\n }\n });\n}\n/**\n * 默认 Diff\n */\nexport function _diff(oldData: any, instance: any, depth = 3): boolean {\n // 基础类型或引用相同，直接认为没变\n if (oldData === instance) return false;\n\n // 类型不一致，肯定变了\n if (\n typeof oldData !== typeof instance ||\n oldData === null ||\n instance === null\n ) {\n return true;\n }\n // 处理数组\n if (Array.isArray(oldData)) {\n if (!Array.isArray(instance) || oldData.length !== instance.length)\n return true;\n for (let i = 0; i < oldData.length; i++) {\n if (_diff(oldData[i], instance[i], depth - 1)) return true;\n }\n return false;\n }\n\n // 处理对象\n const keys = Object.keys(oldData);\n\n for (const key of keys) {\n const valOld = oldData[key];\n const valNew = instance[key];\n\n if (typeof valOld === \"object\" && valOld !== null) {\n // 达到最大深度限制，不再递归，保守起见认为变了\n if (depth <= 0) continue;\n\n if (_diff(valOld, valNew, depth - 1)) return true;\n } else {\n // 基础类型对比\n if (valOld !== valNew) return true;\n }\n }\n return false;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { amberComponentStore, amberTickStore } from \"./store\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\n\nexport class Amber {\n /**\n * 获取组件当前的逻辑版本号\n */\n public static getVersion(compClass: any): number {\n return Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n }\n\n public static canUndo(compClass: any): boolean {\n const current = this.getVersion(compClass);\n const min = amberComponentStore.getMinVersion(compClass);\n\n return current > min;\n }\n\n public static canRedo(compClass: any): boolean {\n const current = this.getVersion(compClass);\n const max = amberComponentStore.getMaxVersion(compClass);\n\n return current < max;\n }\n\n /**\n * 局部撤销：将单个组件回退一个版本\n * 结果：产生新 Tick，代表“我回到了过去”\n */\n public static undo(compClass: any): boolean {\n if (!this.canUndo(compClass)) return false;\n const current = this.getVersion(compClass);\n const result = amberComponentStore.seek(compClass, current - 1);\n\n return result;\n }\n\n /**\n * 局部重做：将单个组件向前进一个版本\n */\n public static redo(compClass: any): boolean {\n if (!this.canRedo(compClass)) return false;\n const current = this.getVersion(compClass);\n const result = amberComponentStore.seek(compClass, current + 1);\n\n return result;\n }\n /**\n * 全局撤销\n */\n public static undoTick(): boolean {\n if (!this.canUndoTick()) return false;\n const targetTick = amberTickStore.currentTick - 1;\n amberTickStore.travel(targetTick);\n return true;\n }\n\n /**\n * 全局重做\n */\n public static redoTick(): boolean {\n if (!this.canRedoTick()) return false;\n const targetTick = amberTickStore.currentTick + 1;\n amberTickStore.travel(targetTick);\n return true;\n }\n\n /**\n * UI 状态判断：是否还能点撤销\n */\n public static canUndoTick(): boolean {\n const currentTick = amberTickStore.currentTick;\n const minTick = amberTickStore.getMinTick();\n\n return currentTick > minTick;\n }\n\n /**\n * UI 状态判断：是否还能点重做\n */\n public static canRedoTick(): boolean {\n const currentTick = amberTickStore.currentTick;\n const maxTick = amberTickStore.getMaxTick();\n\n return currentTick < maxTick;\n }\n\n /**\n * 重置宏观时间轴\n * 清空所有全局快照，用户无法再进行 undoTick/redoTick，\n * 但各个组件当前的微观版本栈保持不变。\n */\n public static resetTick(): void {\n amberTickStore.resetTickStore();\n }\n\n /**\n * 重置特定组件的历史\n * 该组件的旧版本被物理抹除，当前状态变为 V0。\n * 会自动触发一次 updateTickHistory，记录这一时刻的全局状态。\n */\n public static resetComponent(compClass: any): void {\n amberComponentStore.resetComponent(compClass);\n }\n // 建议添加到 Amber 类中\n public static resetAll(): void {\n // 获取所有存活组件\n const classes = Array.from(amberComponentStore.componentHistory.keys());\n // 清空每个组件（静默重置，不触发 updateTickHistory）\n classes.forEach((compClass) => {\n // 我们可以给 resetComponent 加个参数，或者拆分出一个内部方法\n amberComponentStore.resetComponentInternal(compClass);\n });\n // 重置宏观磁带\n amberTickStore.resetTickStore();\n }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport {\n type ExecuteHook,\n type TickHook,\n AtomicModifyMessage,\n BaseMessage,\n ErrorMessage,\n WarnMessage,\n InfoMessage,\n} from \"@virid/core\";\nimport { amberComponentStore, amberTickStore } from \"./store\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\n\nconst dirtyBuffer = new Set<any>();\n\nexport const afterExecuteHooks: ExecuteHook<BaseMessage> = (\n message,\n context,\n) => {\n if (\n message instanceof ErrorMessage ||\n message instanceof WarnMessage ||\n message instanceof InfoMessage\n )\n return;\n\n const allParams =\n message instanceof AtomicModifyMessage\n ? [...context.context.params, message.ComponentClass]\n : context.context.params;\n\n allParams.forEach((paramClass) => {\n if (Reflect.hasMetadata(VIRID_AMBER_METADATA.BACKUP, paramClass)) {\n dirtyBuffer.add(paramClass);\n }\n });\n};\n\nexport const afterTickHooks: TickHook = (_context) => {\n if (dirtyBuffer.size === 0) return;\n\n // 微观更新\n dirtyBuffer.forEach((compClass) => {\n amberComponentStore.seal(compClass);\n });\n\n // 宏观更新\n amberTickStore.updateTickHistory();\n\n // 清理缓存，准备下一轮\n dirtyBuffer.clear();\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { VIRID_AMBER_METADATA } from \"./constant\";\nimport { type BackupStrategy } from \"../interfaces\";\n\n/**\n * @description: 标记 Backup 身份并配置自定义备份策略\n * @param strategy 可选的自定义序列化/反序列化/Diff 方案\n */\nexport function Backup<T extends new (...args: any[]) => any, C = any>(\n strategy?: BackupStrategy<InstanceType<T>, C>,\n) {\n return (target: T) => {\n // 标记需要备份\n Reflect.defineMetadata(VIRID_AMBER_METADATA.BACKUP, true, target);\n // 初始化版本号\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, target);\n // 如果用户给了自定义方法，存入元数据\n if (strategy) {\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n strategy,\n target,\n );\n }\n };\n}\n","/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Add replay, redo, undo and other functions to virid.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { activateApp } from \"./app\";\nimport { PluginOptions } from \"./interfaces\";\nexport * from \"./amber\";\nexport * from \"./decorators\";\nexport * from \"./interfaces\";\nexport const AmberPlugin: ViridPlugin<PluginOptions> = {\n name: \"@virid/amber\",\n install(app: ViridApp, options) {\n activateApp(app, options);\n },\n};\n"],"mappings":";;;;uNAKA,OAAwBA,iBAAAA,EAAeC,eAAAA,MAAmB,cCA1D,OAASC,iBAAAA,MAAqB,cCA9B,OAASC,kBAAAA,MAAsB,cACxB,IAAMC,EAAuB,CAClC,GAAGD,EACHE,OAAQ,qBACRC,QAAS,sBACTC,cAAe,2BACjB,ECNO,IAAKC,GAAAA,SAAAA,EAAAA,oCAAAA,QCGL,SAASC,EAAeC,EAAeC,EAAQ,EAAC,CACrD,GAAID,IAAa,MAAQ,OAAOA,GAAa,SAAU,OAAOA,EAC9D,GAAIC,GAAS,EAAG,OAAOC,MAAMC,QAAQH,CAAAA,EAAY,CAAA,EAAK,CAAC,EAEvD,GAAIE,MAAMC,QAAQH,CAAAA,EAChB,OAAOA,EAASI,IAAKC,GAASN,EAAeM,EAAMJ,EAAQ,CAAA,CAAA,EAG7D,IAAMK,EAAgB,CAAC,EACjBC,EAAOC,OAAOD,KAAKP,CAAAA,EAEzB,QAAWS,KAAOF,EAAM,CACtB,GAAIE,EAAIC,WAAW,GAAA,EAAM,SAEzB,IAAMC,EAAQX,EAASS,CAAAA,EACnB,OAAOE,GAAU,aAErBL,EAASG,CAAAA,EACP,OAAOE,GAAU,UAAYA,IAAU,KACnCZ,EAAeY,EAAOV,EAAQ,CAAA,EAC9BU,EACR,CACA,OAAOL,CACT,CAvBgBP,EAAAA,EAAAA,kBA2BT,SAASa,EAAiBZ,EAAeM,EAAa,CACvD,CAACN,GAAY,CAACM,GAElBE,OAAOD,KAAKD,CAAAA,EAAUO,QAASJ,GAAAA,CAC7B,IAAMK,EAASR,EAASG,CAAAA,EAClBM,EAASf,EAASS,CAAAA,EAGtBM,GACA,OAAOA,GAAW,UAClBD,GACA,OAAOA,GAAW,UAClB,CAACZ,MAAMC,QAAQW,CAAAA,EAEfF,EAAiBG,EAAQD,CAAAA,EAGzBd,EAASS,CAAAA,EAAOK,CAEpB,CAAA,CACF,CApBgBF,EAAAA,EAAAA,oBAwBT,SAASI,EAAMC,EAAcjB,EAAeC,EAAQ,EAAC,CAE1D,GAAIgB,IAAYjB,EAAU,MAAO,GAGjC,GACE,OAAOiB,GAAY,OAAOjB,GAC1BiB,IAAY,MACZjB,IAAa,KAEb,MAAO,GAGT,GAAIE,MAAMC,QAAQc,CAAAA,EAAU,CAC1B,GAAI,CAACf,MAAMC,QAAQH,CAAAA,GAAaiB,EAAQC,SAAWlB,EAASkB,OAC1D,MAAO,GACT,QAASC,EAAI,EAAGA,EAAIF,EAAQC,OAAQC,IAClC,GAAIH,EAAMC,EAAQE,CAAAA,EAAInB,EAASmB,CAAAA,EAAIlB,EAAQ,CAAA,EAAI,MAAO,GAExD,MAAO,EACT,CAGA,IAAMM,EAAOC,OAAOD,KAAKU,CAAAA,EAEzB,QAAWR,KAAOF,EAAM,CACtB,IAAMa,EAASH,EAAQR,CAAAA,EACjBY,EAASrB,EAASS,CAAAA,EAExB,GAAI,OAAOW,GAAW,UAAYA,IAAW,KAAM,CAEjD,GAAInB,GAAS,EAAG,SAEhB,GAAIe,EAAMI,EAAQC,EAAQpB,EAAQ,CAAA,EAAI,MAAO,EAC/C,SAEMmB,IAAWC,EAAQ,MAAO,EAElC,CACA,MAAO,EACT,CAxCgBL,EAAAA,EAAAA,SH5ChB,IAAIM,EAAkC,CACpCC,cAAeC,EACfC,gBAAiBC,EACjBC,KAAMC,CACR,EAEO,SAASC,EAAeC,EAA2B,CACxDR,EAASS,OAAOC,OAAOV,EAAQQ,CAAAA,CACjC,CAFgBD,EAAAA,EAAAA,kBArBhB,IAAAI,EAyBMC,GAAND,EAAA,KAAMC,CAWJ,YAAYC,EAAwB,GAAI,CAThCC,EAAAA,mBAAoC,CAAA,GAGrCC,EAAAA,gBAAW,GAEXF,EAAAA,qBAAgB,IAEhBG,EAAAA,mBAAc,GAGnB,KAAKH,cAAgBA,CACvB,CAIOI,YAAqB,CAC1B,OAAO,KAAKF,QACd,CAKOG,YAAqB,CAC1B,OAAI,KAAKJ,YAAYK,SAAW,EAAU,EACnC,KAAKJ,SAAW,KAAKD,YAAYK,OAAS,CACnD,CAIOC,mBAAoB,CAErB,KAAKJ,YAAc,KAAKD,SAAW,KAAKD,YAAYK,QAEtD,KAAKL,YAAYO,OAAO,KAAKL,YAAc,KAAKD,SAAW,CAAA,EAI7D,IAAMO,EAAW,IAAIC,IAAIC,EAAoBC,cAAc,EAC3D,KAAKX,YAAYY,KAAKJ,CAAAA,EAGlB,KAAKR,YAAYK,OAAS,KAAKN,gBACjC,KAAKC,YAAYa,MAAK,EACtB,KAAKZ,YAEP,IAAMa,EAAiB,KAAKb,SAAW,KAAKD,YAAYK,OAAS,EAEjE,KAAKH,YAAcY,CACrB,CAKOC,OAAOC,EAAoB,CAEhC,IAAMC,EAAQD,EAAa,KAAKf,SAC1BiB,EAAa,KAAKlB,YAAYiB,CAAAA,EAEpC,GAAI,CAACC,EAAY,CACfC,EAAcC,MACZ,IAAIC,MACF,oCAAoCL,CAAAA,2BAAqC,CAAA,EAG7E,MACF,CAEA,IAAMM,EACJN,EAAa,KAAKd,YACdqB,EAAiBC,KACjBD,EAAiBE,KAGjBC,EAID,CAAA,EAEL,OAAW,CAACC,EAAWC,CAAAA,IAAmBV,EAAY,CACpD,IAAMW,EAAcnB,EAAoBoB,eAAeH,CAAAA,EAEvD,GAAIC,IAAmBC,EAAa,CAClC,IAAME,EAAUF,EAEhBnB,EAAoBsB,qBAAqBL,EAAWC,CAAAA,EAGpDlB,EAAoBuB,KAAKN,CAAAA,EAGzB,IAAMO,EAAoCC,QAAQC,YAChDC,EAAqBC,cACrBX,CAAAA,EAEEO,GAAcK,WAChBb,EAAad,KAAK,CAChB4B,SAAUN,EACVH,QAAAA,EACAU,QAASb,CACX,CAAA,CAEJ,CACA,IAAMc,EAAWC,EAASC,IAAIjB,CAAAA,CAChC,CAGA,KAAKzB,YAAcc,EAGnBU,EAAamB,QAAQ,CAAC,CAAEL,SAAAA,EAAUT,QAAAA,EAASU,QAAAA,CAAO,IAAE,CAClDD,EAASD,UAAUR,EAASU,EAASnB,CAAAA,CACvC,CAAA,CACF,CAIOwB,gBAAiB,CAEtB,KAAK9C,YAAc,CAAA,EACnB,KAAKC,SAAW,EAChB,KAAKC,YAAc,EAGnB,KAAKI,kBAAiB,CACxB,CACF,EAhIMR,EAAAA,EAAAA,kBAAND,GAzBAA,EA2JMkD,GAANlD,EAAA,KAAMkD,CAQJ,YAAYC,EAAkC,GAAI,CAP3CC,EAAAA,wBAAmB,IAAIxC,KAEvByC,EAAAA,oBAAe,IAAIzC,KACnBuC,EAAAA,+BAA0B,IAE1BrC,EAAAA,sBAAiB,IAAIF,KAG1B,KAAKuC,wBAA0BA,CACjC,CAIOG,mBAAmBxB,EAAgB,CACxC,IAAMe,EAAWC,EAASC,IAAIjB,CAAAA,EAC9B,GAAI,CAACe,EACHvB,OAAAA,EAAcC,MACZ,IAAIC,MACF,4CAA4CM,EAAUyB,IAAI,qBAAqB,CAAA,EAG5E,KAOT,IAAMC,EAJoClB,QAAQC,YAChDC,EAAqBC,cACrBX,CAAAA,GAEgC2B,WAAapE,EAAOC,cACtD,GAAI,CACF,OAAOkE,EAAYX,CAAAA,CACrB,OAASa,EAAG,CACVpC,EAAcC,MACZmC,EACA,4CAA4C5B,EAAUyB,IAAI,sBAAsB,CAEpF,CACA,OAAO,IACT,CAIOpB,qBAAqBL,EAAgB6B,EAAW,CACrD,IAAMd,EAAWC,EAASC,IAAIjB,CAAAA,EAC9B,GAAI,CAACe,EAAU,CACbvB,EAAcC,MACZ,IAAIC,MACF,+CAA+CM,EAAUyB,IAAI,qBAAqB,CAAA,EAGtF,MACF,CACA,GAAI,CAACI,EAAM,CACTrC,EAAcC,MACZ,IAAIC,MACF,+CAA+CM,EAAUyB,IAAI,YAAYI,CAAAA,IAAQ,CAAA,EAGrF,MACF,CAKA,IAAMC,EAJoCtB,QAAQC,YAChDC,EAAqBC,cACrBX,CAAAA,GAGc+B,aAAexE,EAAOG,gBACtC,GAAI,CACFoE,EAAcf,EAAUc,CAAAA,CAC1B,OAASD,EAAG,CACVpC,EAAcC,MACZmC,EACA,8CAA8C5B,EAAUyB,IAAI,oBAAoB,CAEpF,CAEF,CAIOO,cAAchC,EAAgBiC,EAAwB,CAC3D,IAAMlB,EAAWC,EAASC,IAAIjB,CAAAA,EAC9B,GAAI,CAACe,EACHvB,OAAAA,EAAcC,MACZ,IAAIC,MACF,uCAAuCM,EAAUyB,IAAI,qBAAqB,CAAA,EAGvE,GAET,GAAI,CAACQ,EACHzC,OAAAA,EAAcC,MACZ,IAAIC,MACF,uCAAuCM,EAAUyB,IAAI,YAAYQ,CAAAA,IAAY,CAAA,EAG1E,GAMT,IAAMC,EAJoC1B,QAAQC,YAChDC,EAAqBC,cACrBX,CAAAA,GAE2BpC,MAAQL,EAAOK,KAC5C,GAAI,CACF,OAAOsE,EAAOnB,EAAUkB,CAAAA,CAC1B,OAASL,EAAG,CACVpC,EAAcC,MACZmC,EACA,uCAAuC5B,EAAUyB,IAAI,aAAa,CAEtE,CACA,MAAO,EACT,CAKOU,cAAcpB,EAAe,CAClC,IAAMf,EAAYe,EAAS,YAKrBW,EAJoClB,QAAQC,YAChDC,EAAqBC,cACrBX,CAAAA,GAEgC2B,WAAapE,EAAOC,cAClDqE,EACJ,GAAI,CACFA,EAAOH,EAAYX,CAAAA,CACrB,OAASa,EAAG,CACVpC,EAAcC,MACZmC,EACA,4CAA4C5B,EAAUyB,IAAI,sBAAsB,EAElF,MACF,CACA,KAAKH,iBAAiBc,IAAIpC,EAAW,CAAA,CAAE,EACvC,KAAKuB,aAAaa,IAAIpC,EAAW,CAAA,EAGjC,KAAKsB,iBAAiBL,IAAIjB,CAAAA,EAAYf,KAAK4C,CAAAA,EAC3C,KAAK7C,eAAeoD,IAAIpC,EAAW6B,CAAAA,EAGnCrB,QAAQ6B,eAAe3B,EAAqB4B,QAAS,EAAGtC,CAAAA,CAC1D,CAIOG,eAAeH,EAAqB,CACzC,OAAO,KAAKhB,eAAeiC,IAAIjB,CAAAA,CACjC,CAKOuC,cAAcvC,EAAwB,CAC3C,OAAO,KAAKuB,aAAaN,IAAIjB,CAAAA,GAAc,CAC7C,CAKOwC,cAAcxC,EAAwB,CAC3C,IAAMyC,EAAQ,KAAKnB,iBAAiBL,IAAIjB,CAAAA,EAClC0C,EAAO,KAAKnB,aAAaN,IAAIjB,CAAAA,GAAc,EACjD,MAAI,CAACyC,GAASA,EAAM/D,SAAW,EAAUgE,EAClCA,EAAOD,EAAM/D,OAAS,CAC/B,CAOO4B,KAAKN,EAAgB,CAC1B,IAAMyC,EAAQ,KAAKnB,iBAAiBL,IAAIjB,CAAAA,EACnCyC,GACHjD,EAAcC,MACZ,IAAIC,MACF,uCAAuCM,EAAUyB,IAAI,sBAAsB,CAAA,EAIjF,IAAMkB,EAAc,KAAKpB,aAAaN,IAAIjB,CAAAA,EAEpC4C,EAAkB,KAAKzC,eAAeH,CAAAA,EAE5C,GAAI4C,GAAmB,CAAC,KAAKZ,cAAchC,EAAW4C,CAAAA,EACpD,OAGF,IAAMrC,EAAqCC,QAAQC,YACjDC,EAAqBC,cACrBX,CAAAA,EAEEO,GAAcsC,gBAChBtC,EAAasC,eAAeD,CAAAA,EAI9B,IAAME,EACJtC,QAAQC,YAAYC,EAAqB4B,QAAStC,CAAAA,GAAc,EAC5D+C,EAAuBJ,EAAcF,EAAM/D,OAAS,EACtDoE,EAAwBC,GAC1BN,EAAM7D,OAAOkE,EAAwBH,EAAc,CAAA,EAIrD,IAAM7B,EAAU,KAAKU,mBAAmBxB,CAAAA,EACxC,GAAI,CAACc,EAAS,CACZtB,EAAcC,MACZ,IAAIC,MACF,uCAAuCM,EAAUyB,IAAI,uBAAuB,CAAA,EAGhF,MACF,CACAgB,EAAMxD,KAAK6B,CAAAA,EACX,KAAK9B,eAAeoD,IAAIpC,EAAWc,CAAAA,EAE/B2B,EAAM/D,OAAS,KAAK2C,0BACtBoB,EAAMvD,MAAK,EACX,KAAKqC,aAAaa,IAAIpC,EAAW2C,EAAc,CAAA,GAGjD,IAAMK,EACJ,KAAKzB,aAAaN,IAAIjB,CAAAA,EAAcyC,EAAM/D,OAAS,EACrD8B,QAAQ6B,eACN3B,EAAqB4B,QACrBU,EACAhD,CAAAA,EAEEO,GAAc0C,eAChB1C,EAAa0C,cAAcnC,CAAAA,CAE/B,CAOOoC,KAAKlD,EAAgBmD,EAAgC,CAE1D,IAAMV,EAAQ,KAAKnB,iBAAiBL,IAAIjB,CAAAA,EACxC,GAAI,CAACyC,EACHjD,OAAAA,EAAcC,MACZ,IAAIC,MACF,uCAAuCM,EAAUyB,IAAI,sBAAsB,CAAA,EAGxE,GAET,IAAMkB,EAAc,KAAKpB,aAAaN,IAAIjB,CAAAA,GAAc,EAElDoD,EAAgBD,EAAgBR,EACtC,GAAIS,EAAgB,GAAKA,GAAiBX,EAAM/D,OAAQ,MAAO,GAG/D,IAAM0B,EAAU,KAAKD,eAAeH,CAAAA,EAC9Bc,EAAU2B,EAAMW,CAAAA,EAChBC,EACJ7C,QAAQC,YAAYC,EAAqB4B,QAAStC,CAAAA,GAAc,EAE5DL,EACJwD,EAAgBE,EACZzD,EAAiBC,KACjBD,EAAiBE,KAGvB,KAAKO,qBAAqBL,EAAWc,CAAAA,EAGrC,KAAK9B,eAAeoD,IAAIpC,EAAWc,CAAAA,EACnCN,QAAQ6B,eAAe3B,EAAqB4B,QAASa,EAAenD,CAAAA,EAGpE,IAAMO,EAAqCC,QAAQC,YACjDC,EAAqBC,cACrBX,CAAAA,EAEF,OAAIO,GAAcK,WAChBL,EAAaK,UAAUR,EAASU,EAASnB,CAAAA,EAI3C2D,EAAe3E,kBAAiB,EACzB,EACT,CAIO4E,uBAAuBvD,EAAgB,CAC5C,IAAMc,EAAU,KAAKU,mBAAmBxB,CAAAA,EACnCc,IAGL,KAAKQ,iBAAiBc,IAAIpC,EAAW,CAACc,EAAQ,EAC9C,KAAKS,aAAaa,IAAIpC,EAAW,CAAA,EACjC,KAAKhB,eAAeoD,IAAIpC,EAAWc,CAAAA,EAGnCN,QAAQ6B,eAAe3B,EAAqB4B,QAAS,EAAGtC,CAAAA,EAC1D,CAEOwD,eAAexD,EAAgB,CACpC,KAAKuD,uBAAuBvD,CAAAA,EAE5BsD,EAAe3E,kBAAiB,CAClC,CACF,EArTMyC,EAAAA,EAAAA,uBAANlD,GAuTaoF,EAAiB,IAAInF,EACrBY,EAAsB,IAAIqC,EI3chC,IAAMqC,EAAN,MAAMA,CAAAA,CAIX,OAAcC,WAAWC,EAAwB,CAC/C,OAAOC,QAAQC,YAAYC,EAAqBC,QAASJ,CAAAA,GAAc,CACzE,CAEA,OAAcK,QAAQL,EAAyB,CAC7C,IAAMM,EAAU,KAAKP,WAAWC,CAAAA,EAC1BO,EAAMC,EAAoBC,cAAcT,CAAAA,EAE9C,OAAOM,EAAUC,CACnB,CAEA,OAAcG,QAAQV,EAAyB,CAC7C,IAAMM,EAAU,KAAKP,WAAWC,CAAAA,EAC1BW,EAAMH,EAAoBI,cAAcZ,CAAAA,EAE9C,OAAOM,EAAUK,CACnB,CAMA,OAAcE,KAAKb,EAAyB,CAC1C,GAAI,CAAC,KAAKK,QAAQL,CAAAA,EAAY,MAAO,GACrC,IAAMM,EAAU,KAAKP,WAAWC,CAAAA,EAGhC,OAFeQ,EAAoBM,KAAKd,EAAWM,EAAU,CAAA,CAG/D,CAKA,OAAcS,KAAKf,EAAyB,CAC1C,GAAI,CAAC,KAAKU,QAAQV,CAAAA,EAAY,MAAO,GACrC,IAAMM,EAAU,KAAKP,WAAWC,CAAAA,EAGhC,OAFeQ,EAAoBM,KAAKd,EAAWM,EAAU,CAAA,CAG/D,CAIA,OAAcU,UAAoB,CAChC,GAAI,CAAC,KAAKC,YAAW,EAAI,MAAO,GAChC,IAAMC,EAAaC,EAAeC,YAAc,EAChDD,OAAAA,EAAeE,OAAOH,CAAAA,EACf,EACT,CAKA,OAAcI,UAAoB,CAChC,GAAI,CAAC,KAAKC,YAAW,EAAI,MAAO,GAChC,IAAML,EAAaC,EAAeC,YAAc,EAChDD,OAAAA,EAAeE,OAAOH,CAAAA,EACf,EACT,CAKA,OAAcD,aAAuB,CACnC,IAAMG,EAAcD,EAAeC,YAC7BI,EAAUL,EAAeM,WAAU,EAEzC,OAAOL,EAAcI,CACvB,CAKA,OAAcD,aAAuB,CACnC,IAAMH,EAAcD,EAAeC,YAC7BM,EAAUP,EAAeQ,WAAU,EAEzC,OAAOP,EAAcM,CACvB,CAOA,OAAcE,WAAkB,CAC9BT,EAAeU,eAAc,CAC/B,CAOA,OAAcC,eAAe9B,EAAsB,CACjDQ,EAAoBsB,eAAe9B,CAAAA,CACrC,CAEA,OAAc+B,UAAiB,CAEbC,MAAMC,KAAKzB,EAAoB0B,iBAAiBC,KAAI,CAAA,EAE5DC,QAASpC,GAAAA,CAEfQ,EAAoB6B,uBAAuBrC,CAAAA,CAC7C,CAAA,EAEAmB,EAAeU,eAAc,CAC/B,CACF,EAjHa/B,EAAAA,EAAAA,SAAN,IAAMA,EAANwC,ECHP,OAGEC,uBAAAA,EAEAC,gBAAAA,EACAC,eAAAA,EACAC,eAAAA,MACK,cAIP,IAAMC,EAAc,IAAIC,IAEXC,EAA8CC,EAAA,CACzDC,EACAC,IAAAA,CAEA,GACED,aAAmBE,GACnBF,aAAmBG,GACnBH,aAAmBI,EAEnB,QAGAJ,aAAmBK,EACf,IAAIJ,EAAQA,QAAQK,OAAQN,EAAQO,gBACpCN,EAAQA,QAAQK,QAEZE,QAASC,GAAAA,CACbC,QAAQC,YAAYC,EAAqBC,OAAQJ,CAAAA,GACnDb,EAAYkB,IAAIL,CAAAA,CAEpB,CAAA,CACF,EArB2D,qBAuB9CM,EAA2BhB,EAACiB,GAAAA,CACnCpB,EAAYqB,OAAS,IAGzBrB,EAAYY,QAASU,GAAAA,CACnBC,EAAoBC,KAAKF,CAAAA,CAC3B,CAAA,EAGAG,EAAeC,kBAAiB,EAGhC1B,EAAY2B,MAAK,EACnB,EAbwC,kBNxBxC,IAAIC,EAA8B,KAE3B,SAASC,EAAYC,EAAeC,EAAsB,CAE/DD,EAAIE,YAAYC,EAAgB,EAAA,EAChCH,EAAII,eAAeC,EAAaC,EAAmB,EAAA,EAE/CL,GAASM,EAAeN,CAAAA,EAC5B,IAAMO,EAAgBC,EAACC,IAEnBA,GACAC,QAAQC,YAAYC,EAAqBC,QAASJ,EAAS,WAAW,GAGtEK,EAAoBC,cAAcN,CAAAA,EAE7BA,GARa,iBAUtBV,EAAIiB,kBAAkBT,CAAAA,EACtBV,EAAYE,CACd,CAlBgBD,EAAAA,EAAAA,eAuBT,IAAMmB,EAAsB,IAAIC,MAAM,CAAC,EAAgB,CAC5DC,IAAIC,EAAGC,EAAqB,CAC1B,MAAO,IAAIC,IAAAA,CAET,GAAI,CAACzB,EACH0B,OAAAA,EAAcC,KACZ,2BAA2BC,OAAOJ,CAAAA,CAAAA,iCAAsC,EAEnE,KAKT,IAAMK,EAAe7B,EAAUwB,CAAAA,EAC/B,GAAI,OAAOK,GAAiB,WAE1B,OAAOA,EAAaC,MAAM9B,EAAWyB,CAAAA,CAEzC,CACF,CACF,CAAA,EOnDO,SAASM,GACdC,EAA6C,CAE7C,OAAQC,GAAAA,CAENC,QAAQC,eAAeC,EAAqBC,OAAQ,GAAMJ,CAAAA,EAE1DC,QAAQC,eAAeC,EAAqBE,QAAS,EAAGL,CAAAA,EAEpDD,GACFE,QAAQC,eACNC,EAAqBG,cACrBP,EACAC,CAAAA,CAGN,CACF,CAjBgBF,EAAAA,GAAAA,UCWT,IAAMS,GAA0C,CACrDC,KAAM,eACNC,QAAQC,EAAeC,EAAO,CAC5BC,EAAYF,EAAKC,CAAAA,CACnB,CACF","names":["MessageWriter","BaseMessage","MessageWriter","VIRID_METADATA","VIRID_AMBER_METADATA","BACKUP","VERSION","CUSTOM_METHOD","RestoreDirection","_serialization","instance","depth","Array","isArray","map","item","snapshot","keys","Object","key","startsWith","value","_deserialization","forEach","newVal","oldVal","_diff","oldData","length","i","valOld","valNew","config","serialization","_serialization","deserialization","_deserialization","diff","_diff","activateConfig","customConfig","Object","assign","_a","AmberTickStore","maxTickLength","tickHistory","baseTick","currentTick","getMinTick","getMaxTick","length","updateTickHistory","splice","snapshot","Map","amberComponentStore","currentHistory","push","shift","newLogicalTick","travel","targetTick","index","historyMap","MessageWriter","error","Error","direction","RestoreDirection","UNDO","REDO","restoreQueue","compClass","historicalData","currentData","getCurrentData","oldData","deserializeComponent","seal","customMethod","Reflect","getMetadata","VIRID_AMBER_METADATA","CUSTOM_METHOD","onRestore","strategy","newData","instance","viridApp","get","forEach","resetTickStore","AmberComponentStore","maxComponentHistorySize","componentHistory","biasVersions","serializeComponent","name","serializeFn","serialize","e","data","deserializeFn","deserialize","diffComponent","old_data","diffFn","initComponent","set","defineMetadata","VERSION","getMinVersion","getMaxVersion","stack","bias","baseVersion","currentSnapshot","onBeforeBackup","currentLogicalVersion","latestLogicalVersion","newLogicalVersion","onAfterBackup","seek","targetVersion","physicalIndex","currentVersion","amberTickStore","resetComponentInternal","resetComponent","Amber","getVersion","compClass","Reflect","getMetadata","VIRID_AMBER_METADATA","VERSION","canUndo","current","min","amberComponentStore","getMinVersion","canRedo","max","getMaxVersion","undo","seek","redo","undoTick","canUndoTick","targetTick","amberTickStore","currentTick","travel","redoTick","canRedoTick","minTick","getMinTick","maxTick","getMaxTick","resetTick","resetTickStore","resetComponent","resetAll","Array","from","componentHistory","keys","forEach","resetComponentInternal","_Amber","AtomicModifyMessage","ErrorMessage","WarnMessage","InfoMessage","dirtyBuffer","Set","afterExecuteHooks","__name","message","context","ErrorMessage","WarnMessage","InfoMessage","AtomicModifyMessage","params","ComponentClass","forEach","paramClass","Reflect","hasMetadata","VIRID_AMBER_METADATA","BACKUP","add","afterTickHooks","_context","size","compClass","amberComponentStore","seal","amberTickStore","updateTickHistory","clear","activeApp","activateApp","app","options","onAfterTick","afterTickHooks","onAfterExecute","BaseMessage","afterExecuteHooks","activateConfig","amberInitHook","__name","instance","Reflect","hasMetadata","VIRID_AMBER_METADATA","VERSION","amberComponentStore","initComponent","addActivationHook","viridApp","Proxy","get","_","prop","args","MessageWriter","warn","String","targetMethod","apply","Backup","strategy","target","Reflect","defineMetadata","VIRID_AMBER_METADATA","BACKUP","VERSION","CUSTOM_METHOD","AmberPlugin","name","install","app","options","activateApp"]}
|
|
1
|
+
{"version":3,"sources":["../src/app.ts","../src/amber/store.ts","../src/decorators/constant.ts","../src/interfaces/decorator.ts","../src/amber/amber.ts","../src/amber/hooks.ts","../src/decorators/decorator.ts","../src/index.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { type ViridApp, MessageWriter, BaseMessage } from \"@virid/core\";\nimport {\n amberComponentStore,\n afterExecuteHooks,\n afterTickHooks,\n activateConfig,\n} from \"./amber\";\nimport type { PluginOptions } from \"./interfaces\";\nimport { VIRID_AMBER_METADATA } from \"./decorators/constant\";\nexport interface IViridApp {\n get(identifier: any): any;\n}\n\nlet activeApp: IViridApp | null = null;\n\nexport function activateApp(app: ViridApp, options: PluginOptions) {\n //注册钩子\n app.onAfterTick(afterTickHooks, true);\n app.onAfterExecute(BaseMessage, afterExecuteHooks, true);\n //看看用户提供的配置\n activateConfig(options);\n const amberInitHook = (instance: any) => {\n if (\n instance &&\n Reflect.hasMetadata(VIRID_AMBER_METADATA.VERSION, instance.constructor)\n ) {\n //实例化的时候，init第一个版本\n amberComponentStore.initComponent(instance);\n }\n return instance;\n };\n app.addActivationHook(amberInitHook);\n activeApp = app;\n}\n\n/**\n * viridApp 代理\n */\nexport const viridApp: IViridApp = new Proxy({} as IViridApp, {\n get(_, prop: keyof IViridApp) {\n return (...args: any[]) => {\n if (!activeApp) {\n MessageWriter.warn(\n `[Virid Vue] App method \"${String(prop)}\" called before initialization.`,\n );\n return null;\n }\n\n const targetMethod = activeApp[prop];\n if (typeof targetMethod === \"function\") {\n return Reflect.apply(targetMethod, activeApp, args);\n }\n };\n },\n});\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { MessageWriter } from \"@virid/core\";\nimport { viridApp } from \"../app\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\nimport { RestoreDirection, type PluginOptions } from \"../interfaces\";\nimport { type VersionMetadata, type CustomMethodMetadata } from \"../interfaces\";\n\nimport { _serialization, _deserialization, _diff } from \"./utils\";\nlet config: PluginOptions;\n\nexport function activateConfig(customConfig: PluginOptions) {\n config = customConfig;\n amberComponentStore.maxComponentLength = config.maxComponentLength;\n amberTickStore.maxTickLength = config.maxTickLength;\n}\n\nclass AmberTickStore {\n // 快照镜像\n private tickHistory: Array<Map<any, any>> = [];\n\n // 记录数组第 0 位对应的真实 Tick 号\n public baseTick = 0;\n\n public maxTickLength: number;\n // 当前处于哪个逻辑 Tick\n public currentTick = 0;\n\n constructor(maxTickLength: number = 20) {\n this.maxTickLength = maxTickLength;\n }\n /**\n * 获取最小可用Tick\n */\n public getMinTick(): number {\n return this.baseTick;\n }\n\n /**\n * 获取最大的Tick\n */\n public getMaxTick(): number {\n if (this.tickHistory.length === 0) return 0;\n return this.baseTick + this.tickHistory.length - 1;\n }\n /**\n * 记录当前的宏观快照\n */\n public updateTickHistory() {\n // 剪枝\n if (this.currentTick < this.baseTick + this.tickHistory.length) {\n // 剪掉后面的平行宇宙\n this.tickHistory.splice(this.currentTick - this.baseTick + 1);\n }\n\n // 增加加新快照\n const snapshot = new Map(amberComponentStore.currentHistory);\n this.tickHistory.push(snapshot);\n\n // 滑动窗口处理\n if (this.tickHistory.length > this.maxTickLength) {\n this.tickHistory.shift();\n this.baseTick++;\n }\n const newLogicalTick = this.baseTick + this.tickHistory.length - 1;\n // 更新指针到最新产生的这个 Tick\n this.currentTick = newLogicalTick;\n }\n\n /**\n * 全局时空旅行\n */\n public travel(targetTick: number) {\n // 计算物理索引\n const index = targetTick - this.baseTick;\n const historyMap = this.tickHistory[index];\n\n if (!historyMap) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Travel Error: Tick ${targetTick} is out of history range.`,\n ),\n );\n return;\n }\n\n const direction =\n targetTick < this.currentTick\n ? RestoreDirection.UNDO\n : RestoreDirection.REDO;\n\n // 准备一个队列，用于最后统一执行钩子\n const restoreQueue: Array<{\n strategy: any;\n oldData: any;\n newData: any;\n }> = [];\n // 遍历快照中的所有组件类\n for (const [compClass, historicalData] of historyMap) {\n const currentData = amberComponentStore.getCurrentData(compClass);\n // 只有数据不一致时才处理\n if (historicalData !== currentData) {\n const oldData = currentData;\n // 执行物理恢复\n amberComponentStore.deserializeComponent(compClass, historicalData);\n\n // 更新微观层的快照记录\n amberComponentStore.seal(compClass);\n\n // 收集钩子\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onRestore) {\n restoreQueue.push({\n strategy: customMethod,\n oldData,\n newData: historicalData,\n });\n }\n }\n const instance = viridApp.get(compClass);\n }\n\n // 更新宏观时空指针\n this.currentTick = targetTick;\n\n // 统一派发副作用钩子\n restoreQueue.forEach(({ strategy, oldData, newData }) => {\n strategy.onRestore(oldData, newData, direction);\n });\n }\n /**\n * 重置宏观时间轴\n */\n public resetTickStore() {\n // 彻底清空旧的磁带\n this.tickHistory = [];\n this.baseTick = 0;\n this.currentTick = 0;\n\n // 立刻保存一份当前的“现状”作为新起点\n this.updateTickHistory();\n }\n}\n\nclass AmberComponentStore {\n public componentHistory = new Map<any, any[]>();\n // 记录每个组件消失的历史总数\n public biasVersions = new Map<any, number>();\n public maxComponentLength: number;\n // 记录当前每个组件都是什么版本\n public currentHistory = new Map<any, any>();\n // 记录每个组件消失的历史总数\n constructor(maxComponentLength: number = 20) {\n this.maxComponentLength = maxComponentLength;\n }\n /**\n * 将component 的数据进行序列化\n */\n public serializeComponent(compClass: any) {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Serialize Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return null;\n }\n\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const serializeFn = customMethod?.serialize || config.serialization;\n try {\n return serializeFn(instance);\n } catch (e) {\n MessageWriter.error(\n e as Error,\n `[Virid Amber] Serialize Error: Component ${compClass.name} serialization error`,\n );\n }\n return null;\n }\n /**\n * 将component 的数据反序列化\n */\n public deserializeComponent(compClass: any, data: any) {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Deserialize Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return;\n }\n if (!data) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Deserialize Error: Component ${compClass.name} data is ${data}!.`,\n ),\n );\n return;\n }\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const deserializeFn = customMethod?.deserialize || config.deserialization;\n try {\n deserializeFn(instance, data);\n } catch (e) {\n MessageWriter.error(\n e as Error,\n `[Virid Amber] Deserialize Error: Component ${compClass.name} deserialize error`,\n );\n }\n return;\n }\n /**\n * 对比diff\n */\n public diffComponent(compClass: any, old_data: any): boolean {\n const instance = viridApp.get(compClass);\n if (!instance) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Diff Error: Component ${compClass.name} is not registered.`,\n ),\n );\n return false;\n }\n if (!old_data) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Diff Error: Component ${compClass.name} data is ${old_data}!.`,\n ),\n );\n return false;\n }\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const diffFn = customMethod?.diff || config.diff;\n try {\n return diffFn(instance, old_data);\n } catch (e) {\n MessageWriter.error(\n e as Error,\n `[Virid Amber] Diff Error: Component ${compClass.name} diff error`,\n );\n }\n return false;\n }\n\n /**\n * 初始化组件的历史记录结构\n */\n public initComponent(instance: any) {\n const compClass = instance.constructor;\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n const serializeFn = customMethod?.serialize || config.serialization;\n let data;\n try {\n data = serializeFn(instance);\n } catch (e) {\n MessageWriter.error(\n e as Error,\n `[Virid Amber] Serialize Error: Component ${compClass.name} serialization error`,\n );\n return;\n }\n this.componentHistory.set(compClass, []);\n this.biasVersions.set(compClass, 0);\n\n // 将初始数据推入\n this.componentHistory.get(compClass)!.push(data);\n this.currentHistory.set(compClass, data);\n\n // 初始版本设为 0\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, compClass);\n }\n /**\n * 获取组件当前逻辑版本对应的快照数据\n */\n public getCurrentData(compClass: any): any {\n return this.currentHistory.get(compClass);\n }\n\n /**\n * 获取组件在当前滑动窗口内的最小可用版本\n */\n public getMinVersion(compClass: any): number {\n return this.biasVersions.get(compClass) ?? 0;\n }\n\n /**\n * 获取组件在当前物理栈内存在的最大版本（包括撤销后的“未来”）\n */\n public getMaxVersion(compClass: any): number {\n const stack = this.componentHistory.get(compClass);\n const bias = this.biasVersions.get(compClass) ?? 0;\n if (!stack || stack.length === 0) return bias;\n return bias + stack.length - 1;\n }\n\n /**\n * 给一个component 打快照\n * @param compClass 构造函数\n * @returns\n */\n public seal(compClass: any) {\n const stack = this.componentHistory.get(compClass);\n if (!stack) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not initialized.`,\n ),\n );\n return;\n }\n const baseVersion = this.biasVersions.get(compClass)!;\n\n const currentSnapshot = this.getCurrentData(compClass);\n // diff判断\n if (currentSnapshot && !this.diffComponent(compClass, currentSnapshot)) {\n return;\n }\n\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onBeforeBackup) {\n customMethod.onBeforeBackup(currentSnapshot);\n }\n\n // 剪枝\n const currentLogicalVersion: VersionMetadata =\n Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n const latestLogicalVersion = baseVersion + stack.length - 1;\n if (currentLogicalVersion < latestLogicalVersion) {\n stack.splice(currentLogicalVersion - baseVersion + 1);\n }\n\n // 序列化\n const newData = this.serializeComponent(compClass);\n if (!newData) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not serializable.`,\n ),\n );\n return;\n }\n stack.push(newData);\n this.currentHistory.set(compClass, newData);\n // 滑动窗口与元数据更新\n if (stack.length > this.maxComponentLength) {\n stack.shift();\n this.biasVersions.set(compClass, baseVersion + 1);\n }\n\n const newLogicalVersion =\n this.biasVersions.get(compClass)! + stack.length - 1;\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.VERSION,\n newLogicalVersion,\n compClass,\n );\n if (customMethod?.onAfterBackup) {\n customMethod.onAfterBackup(newData);\n }\n }\n /**\n * 回退到指定版本\n * @param compClass component构造函数\n * @param targetVersion 目标版本\n * @returns\n */\n public seek(compClass: any, targetVersion: number): boolean {\n // 边界检查\n const stack = this.componentHistory.get(compClass);\n if (!stack) {\n MessageWriter.error(\n new Error(\n `[Virid Amber] Seal Error: Component ${compClass.name} is not initialized.`,\n ),\n );\n return false;\n }\n const baseVersion = this.biasVersions.get(compClass) || 0;\n\n const physicalIndex = targetVersion - baseVersion;\n if (physicalIndex < 0 || physicalIndex >= stack.length) return false;\n\n // 状态对比准备\n const oldData = this.getCurrentData(compClass);\n const newData = stack[physicalIndex];\n const currentVersion: VersionMetadata =\n Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n\n const direction =\n targetVersion < currentVersion\n ? RestoreDirection.UNDO\n : RestoreDirection.REDO;\n\n // 执行反序列化\n this.deserializeComponent(compClass, newData);\n\n // 时空指针同步\n this.currentHistory.set(compClass, newData);\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.VERSION,\n targetVersion,\n compClass,\n );\n\n // 触发业务钩子\n const customMethod: CustomMethodMetadata = Reflect.getMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n compClass,\n );\n if (customMethod?.onRestore) {\n customMethod.onRestore(oldData, newData, direction);\n }\n\n // 告诉时间轴，有个零件变了\n amberTickStore.updateTickHistory();\n return true;\n }\n /**\n * 重置逻辑\n */\n public resetComponentInternal(compClass: any) {\n const newData = this.serializeComponent(compClass);\n if (!newData) return;\n\n // 物理清理\n this.componentHistory.set(compClass, [newData]);\n this.biasVersions.set(compClass, 0);\n this.currentHistory.set(compClass, newData);\n\n // 元数据归零\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, compClass);\n }\n\n public resetComponent(compClass: any) {\n this.resetComponentInternal(compClass);\n // 只有局部重置时，才主动触发宏观记录\n amberTickStore.updateTickHistory();\n }\n}\n\nexport const amberTickStore = new AmberTickStore();\nexport const amberComponentStore = new AmberComponentStore();","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { VIRID_METADATA } from \"@virid/core\";\nexport const VIRID_AMBER_METADATA = {\n ...VIRID_METADATA,\n BACKUP: \"virid:amber:backup\",\n VERSION: \"virid:amber:version\",\n CUSTOM_METHOD: \"virid:amber:custom-method\",\n} as const;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nexport enum RestoreDirection {\n UNDO = \"UNDO\",\n REDO = \"REDO\",\n}\n\nexport interface BackupStrategy<T = any, C = any> {\n /**\n * 自定义序列化：将实例转换为可存储的对象\n */\n serialize?: (instance: T) => C;\n\n /**\n * 自定义反序列化：将数据灌回实例\n */\n deserialize?: (instance: T, data: C) => void;\n\n /**\n * 自定义 Diff：返回 true 表示有变化，需要触发备份\n */\n diff?: (oldData: C, instance: T) => boolean;\n onBeforeBackup?: (oldData: C) => void;\n onAfterBackup?: (newData: C) => void;\n onRestore?: (oldData: C, newData: C, direction: RestoreDirection) => void;\n}\n\nexport type VersionMetadata = number;\nexport type BackupMetadata = boolean;\nexport type CustomMethodMetadata = BackupStrategy;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { amberComponentStore, amberTickStore } from \"./store\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\n\nexport class Amber {\n /**\n * 获取组件当前的逻辑版本号\n */\n public static getVersion(compClass: any): number {\n return Reflect.getMetadata(VIRID_AMBER_METADATA.VERSION, compClass) || 0;\n }\n\n public static canUndo(compClass: any): boolean {\n const current = this.getVersion(compClass);\n const min = amberComponentStore.getMinVersion(compClass);\n\n return current > min;\n }\n\n public static canRedo(compClass: any): boolean {\n const current = this.getVersion(compClass);\n const max = amberComponentStore.getMaxVersion(compClass);\n\n return current < max;\n }\n\n /**\n * 局部撤销：将单个组件回退一个版本\n * 结果：产生新 Tick，代表“我回到了过去”\n */\n public static undo(compClass: any): boolean {\n if (!this.canUndo(compClass)) return false;\n const current = this.getVersion(compClass);\n const result = amberComponentStore.seek(compClass, current - 1);\n\n return result;\n }\n\n /**\n * 局部重做：将单个组件向前进一个版本\n */\n public static redo(compClass: any): boolean {\n if (!this.canRedo(compClass)) return false;\n const current = this.getVersion(compClass);\n const result = amberComponentStore.seek(compClass, current + 1);\n\n return result;\n }\n /**\n * 全局撤销\n */\n public static undoTick(): boolean {\n if (!this.canUndoTick()) return false;\n const targetTick = amberTickStore.currentTick - 1;\n amberTickStore.travel(targetTick);\n return true;\n }\n\n /**\n * 全局重做\n */\n public static redoTick(): boolean {\n if (!this.canRedoTick()) return false;\n const targetTick = amberTickStore.currentTick + 1;\n amberTickStore.travel(targetTick);\n return true;\n }\n\n /**\n * UI 状态判断：是否还能点撤销\n */\n public static canUndoTick(): boolean {\n const currentTick = amberTickStore.currentTick;\n const minTick = amberTickStore.getMinTick();\n\n return currentTick > minTick;\n }\n\n /**\n * UI 状态判断：是否还能点重做\n */\n public static canRedoTick(): boolean {\n const currentTick = amberTickStore.currentTick;\n const maxTick = amberTickStore.getMaxTick();\n\n return currentTick < maxTick;\n }\n\n /**\n * 重置宏观时间轴\n * 清空所有全局快照，用户无法再进行 undoTick/redoTick，\n * 但各个组件当前的微观版本栈保持不变。\n */\n public static resetTick(): void {\n amberTickStore.resetTickStore();\n }\n\n /**\n * 重置特定组件的历史\n * 该组件的旧版本被物理抹除，当前状态变为 V0。\n * 会自动触发一次 updateTickHistory，记录这一时刻的全局状态。\n */\n public static resetComponent(compClass: any): void {\n amberComponentStore.resetComponent(compClass);\n }\n // 建议添加到 Amber 类中\n public static resetAll(): void {\n // 获取所有存活组件\n const classes = Array.from(amberComponentStore.componentHistory.keys());\n // 清空每个组件（静默重置，不触发 updateTickHistory）\n classes.forEach((compClass) => {\n // 我们可以给 resetComponent 加个参数，或者拆分出一个内部方法\n amberComponentStore.resetComponentInternal(compClass);\n });\n // 重置宏观磁带\n amberTickStore.resetTickStore();\n }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport {\n type ExecuteHook,\n type TickHook,\n BaseMessage,\n ErrorMessage,\n WarnMessage,\n InfoMessage,\n} from \"@virid/core\";\nimport { amberComponentStore, amberTickStore } from \"./store\";\nimport { VIRID_AMBER_METADATA } from \"../decorators/constant\";\n\nconst dirtyBuffer = new Set<any>();\n\nexport const afterExecuteHooks: ExecuteHook<BaseMessage> = (\n message,\n context,\n) => {\n if (\n message instanceof ErrorMessage ||\n message instanceof WarnMessage ||\n message instanceof InfoMessage\n )\n return;\n\n const allParams = context.context.params;\n\n allParams.forEach((paramClass) => {\n if (Reflect.hasMetadata(VIRID_AMBER_METADATA.BACKUP, paramClass)) {\n dirtyBuffer.add(paramClass);\n }\n });\n};\n\nexport const afterTickHooks: TickHook = (_context) => {\n if (dirtyBuffer.size === 0) return;\n\n // 微观更新\n dirtyBuffer.forEach((compClass) => {\n amberComponentStore.seal(compClass);\n });\n\n // 宏观更新\n amberTickStore.updateTickHistory();\n\n // 清理缓存，准备下一轮\n dirtyBuffer.clear();\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Amber\n */\nimport { VIRID_AMBER_METADATA } from \"./constant\";\nimport { type BackupStrategy } from \"../interfaces\";\n\n/**\n * @description: 标记 Backup 身份并配置自定义备份策略\n * @param strategy 可选的自定义序列化/反序列化/Diff 方案\n */\nexport function Backup<T extends new (...args: any[]) => any, C = any>(\n strategy?: BackupStrategy<InstanceType<T>, C>,\n) {\n return (target: T) => {\n // 标记需要备份\n Reflect.defineMetadata(VIRID_AMBER_METADATA.BACKUP, true, target);\n // 初始化版本号\n Reflect.defineMetadata(VIRID_AMBER_METADATA.VERSION, 0, target);\n // 如果用户给了自定义方法，存入元数据\n if (strategy) {\n Reflect.defineMetadata(\n VIRID_AMBER_METADATA.CUSTOM_METHOD,\n strategy,\n target,\n );\n }\n };\n}\n","/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Add replay, redo, undo and other functions to virid.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { activateApp } from \"./app\";\nimport { PluginOptions } from \"./interfaces\";\nexport * from \"./amber\";\nexport * from \"./decorators\";\nexport * from \"./interfaces\";\nexport const AmberPlugin: ViridPlugin<PluginOptions> = {\n name: \"@virid/amber\",\n install(app: ViridApp, options) {\n activateApp(app, options);\n },\n};\n"],"mappings":"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","names":["MessageWriter","BaseMessage","MessageWriter","VIRID_METADATA","VIRID_AMBER_METADATA","BACKUP","VERSION","CUSTOM_METHOD","RestoreDirection","config","activateConfig","customConfig","amberComponentStore","maxComponentLength","amberTickStore","maxTickLength","_a","AmberTickStore","tickHistory","baseTick","currentTick","getMinTick","getMaxTick","length","updateTickHistory","splice","snapshot","Map","currentHistory","push","shift","newLogicalTick","travel","targetTick","index","historyMap","MessageWriter","error","Error","direction","RestoreDirection","UNDO","REDO","restoreQueue","compClass","historicalData","currentData","getCurrentData","oldData","deserializeComponent","seal","customMethod","Reflect","getMetadata","VIRID_AMBER_METADATA","CUSTOM_METHOD","onRestore","strategy","newData","instance","viridApp","get","forEach","resetTickStore","AmberComponentStore","componentHistory","biasVersions","serializeComponent","name","serializeFn","serialize","serialization","e","data","deserializeFn","deserialize","deserialization","diffComponent","old_data","diffFn","diff","initComponent","set","defineMetadata","VERSION","getMinVersion","getMaxVersion","stack","bias","baseVersion","currentSnapshot","onBeforeBackup","currentLogicalVersion","latestLogicalVersion","newLogicalVersion","onAfterBackup","seek","targetVersion","physicalIndex","currentVersion","resetComponentInternal","resetComponent","Amber","getVersion","compClass","Reflect","getMetadata","VIRID_AMBER_METADATA","VERSION","canUndo","current","min","amberComponentStore","getMinVersion","canRedo","max","getMaxVersion","undo","seek","redo","undoTick","canUndoTick","targetTick","amberTickStore","currentTick","travel","redoTick","canRedoTick","minTick","getMinTick","maxTick","getMaxTick","resetTick","resetTickStore","resetComponent","resetAll","Array","from","componentHistory","keys","forEach","resetComponentInternal","_Amber","ErrorMessage","WarnMessage","InfoMessage","dirtyBuffer","Set","afterExecuteHooks","__name","message","context","ErrorMessage","WarnMessage","InfoMessage","params","forEach","paramClass","Reflect","hasMetadata","VIRID_AMBER_METADATA","BACKUP","add","afterTickHooks","_context","size","compClass","amberComponentStore","seal","amberTickStore","updateTickHistory","clear","activeApp","activateApp","app","options","onAfterTick","afterTickHooks","onAfterExecute","BaseMessage","afterExecuteHooks","activateConfig","amberInitHook","__name","instance","Reflect","hasMetadata","VIRID_AMBER_METADATA","VERSION","amberComponentStore","initComponent","addActivationHook","viridApp","Proxy","get","_","prop","args","MessageWriter","warn","String","targetMethod","apply","Backup","strategy","target","Reflect","defineMetadata","VIRID_AMBER_METADATA","BACKUP","VERSION","CUSTOM_METHOD","AmberPlugin","name","install","app","options","activateApp"]}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@virid/amber",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.2.2",
|
|
5
5
|
"description": "Add replay, redo, undo and other functions to virid",
|
|
6
6
|
"author": "Ailrid",
|
|
7
7
|
"license": "Apache 2.0",
|
|
@@ -34,10 +34,9 @@
|
|
|
34
34
|
},
|
|
35
35
|
"dependencies": {},
|
|
36
36
|
"peerDependencies": {
|
|
37
|
-
"@virid/core": "0.
|
|
37
|
+
"@virid/core": "0.2.2"
|
|
38
38
|
},
|
|
39
39
|
"scripts": {
|
|
40
|
-
"build": "tsup --config tsup.config.ts"
|
|
41
|
-
"example": "node --import @swc-node/register/esm-register examples/index.ts"
|
|
40
|
+
"build": "tsup --config tsup.config.ts"
|
|
42
41
|
}
|
|
43
42
|
}
|