@netless/appliance-plugin 1.1.42 → 1.1.43-beta.1

package/dist/undo/index.d.ts

@@ -36,14 +36,14 @@ export declare class UndoRedoMethod {
     private pendingState;
     private tickerEndWaiters;
     private undoLifecycleListeners;
+    private pendingWaitCancels;
+    private destroyed;
     private lifecycleCache;
     private stackRevision;
     private tickStartCaches;
     private tickStartExcludeIds;
     private readonly timingFix;
     private readonly ackTimeout;
-    private readonly gracePeriodTimeout;
-    private readonly doingFallbackTimeout;
     private isGlobalStackTransaction;
     private pendingGlobalServiceData?;
     private pendingArrayChanges;
@@ -55,6 +55,7 @@ export declare class UndoRedoMethod {
     onUndoLifecycle(listener: (event: UndoLifecycleEvent) => void): () => void;
     getPendingTickerSnapshots(scenePath: string): PendingTickerSnapshot[];
     waitForUndoStackEnd(identity: UndoStackIdentity, stackEndTimeout: number): Promise<UndoStackEndEvent>;
+    waitForDataDone(identity: UndoStackIdentity, timeout?: number): Promise<void>;
     waitForFinalizeRequested(identity: UndoStackIdentity, timeout: number): Promise<void>;
     private emitUndoStepsUpdate;
     private emitRedoStepsUpdate;
@@ -75,10 +76,17 @@ export declare class UndoRedoMethod {
     private armAckTimeout;
     private tryEnd;
     private forceFlushPending;
-    private hasAnyAck;
     private clearPendingState;
     waitForTickerEnd(id: UndoStackId, timeout?: number): Promise<void>;
+    /**
+     * Dispose only this View's local ticker machinery. This is intentionally
+     * different from cancelUndoTicker(): destroying a View must not manufacture
+     * a stack-end/no-change event or an Undo item.
+     */
+    disposeViewTickers(reason?: "view-destroyed" | "plugin-destroyed"): void;
     cancelUndoTicker(id: number, viewId: string, scenePath: string): void;
+    /** Cancel this View's current start-to-stack-end transaction after Clear. */
+    cancelViewUndoTicker(): void;
     private getStartCache;
     private getExcludeIds;
     private resetLegacyTicker;
@@ -97,6 +105,7 @@ export declare class UndoRedoMethod {
     undo(scenePath: string): number;
     redo(scenePath: string): number;
     clear(): void;
+    destroy(): void;
     clearUndo(): void;
     clearRedo(): void;
     canUndo(): boolean;

package/dist/undo/timing.d.ts

@@ -1,5 +1,7 @@
 import type { BaseCollectorReducerAction } from "../collector/types";
 export declare const UndoScope_ClearAll = "__undo_scope_clear_all__";
+export declare const resolveUndoFinalizeTimeout: (ackTimeout: number) => number;
+export declare const resolveUndoStackEndTimeout: (ackTimeout: number) => number;
 export declare enum UndoTickerSource {
     DrawingPencil = "drawing:pencil",
     DrawingArrow = "drawing:arrow",
@@ -58,13 +60,12 @@ export type PendingUndoTickerState = {
     phase: LocalTransactionPhase;
     ownerPromiseActive: boolean;
     finalizeRequested: boolean;
+    finalizedAt?: number;
     collectedScopeKeys: Set<string>;
     scopeKeys: Set<string>;
     ackedStorageKeys: Set<string>;
     meta: AckMeta & Pick<ExpectedAcks, "copyAck" | "isWritable">;
     ackTimer?: number;
-    graceTimer?: number;
-    fallbackTimer?: number;
 };
 export type UndoStackIdentity = {
     viewId: string;
@@ -78,6 +79,11 @@ export type UndoFinalizeRequestedEvent = UndoStackIdentity & {
     scopeMode: "static" | "dynamic";
     finalizedAt: number;
 };
+export type UndoDataDoneEvent = UndoStackIdentity & {
+    phase: "data-done";
+    source: UndoTickerSource;
+    completedAt: number;
+};
 export type UndoStackEndEvent = UndoStackIdentity & {
     phase: "stack-end";
     source: UndoTickerSource;
@@ -92,7 +98,7 @@ export type UndoStackFailedEvent = UndoStackIdentity & {
     missingRender: boolean;
     missingStorageIds: string[];
 };
-export type UndoLifecycleEvent = UndoFinalizeRequestedEvent | UndoStackEndEvent | UndoStackFailedEvent;
+export type UndoLifecycleEvent = UndoFinalizeRequestedEvent | UndoDataDoneEvent | UndoStackEndEvent | UndoStackFailedEvent;
 export type PendingTickerSnapshot = UndoStackIdentity & {
     source: UndoTickerSource;
     startedAt: number;
@@ -113,7 +119,6 @@ export declare function createPendingUndoTickerState(params: {
     viewId: string;
     scenePath: string;
     expectedAcks: ExpectedAcks;
-    fallbackTimer?: number;
 }): PendingUndoTickerState;
 export declare function mergeAckMeta(state: PendingUndoTickerState, meta?: AckMeta): void;
 export declare function isPendingStateComplete(state: PendingUndoTickerState): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netless/appliance-plugin",
-  "version": "1.1.42",
+  "version": "1.1.43-beta.1",
   "files": [
     "dist",
     "bridge.d.ts",
@@ -42,22 +42,34 @@
     "example:lint": "pnpm --dir example lint",
     "example:typecheck": "pnpm exec tsc --noEmit -p example/tsconfig.json",
     "sync:fastboard-docs": "node scripts/sync-fastboard-docs.mjs",
-    "ci:check": "pnpm lint && pnpm test:auto-shape && pnpm test:rendering-compatibility && pnpm test:background-image-load:coverage && pnpm test:max-retries-type && pnpm test:background-image-query && pnpm test:current-scene-guard && pnpm test:init-ready && pnpm build && pnpm example:typecheck",
+    "ci:check": "pnpm lint && pnpm test:auto-shape && pnpm test:rendering-compatibility && pnpm test:render-runtime-fallback && pnpm test:image-bitmap-retirement && pnpm test:image-bitmap-diagnostic && pnpm test:service-sync-commit && pnpm test:init-await-boundaries && pnpm test:init-log-aggregation && pnpm test:background-image-load:coverage && pnpm test:max-retries-type && pnpm test:background-image-query && pnpm test:current-scene-guard && pnpm test:init-state-reconciliation && pnpm test:render-runtime-cache && pnpm test:init-ready && pnpm test:transaction-barrier && pnpm test:bitmap-eraser && pnpm test:undo-timing && pnpm build && pnpm example:typecheck",
     "test:max-retries-type": "tsc -p tsconfig.types-test.json",
     "test:text-editor-focus": "tsx scripts/textEditorFocus.test.ts",
-    "test:auto-shape": "tsx test/autoShape.test.ts",
-    "test:undo-timing": "tsx test/undoTiming.test.ts",
+    "test:auto-shape": "tsx scripts/autoShape.test.ts",
+    "test:undo-timing": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx test/undoTiming.test.ts",
     "test:undo-finalize": "tsx scripts/undoFinalize.test.ts",
     "test:batch-scheduler": "tsx scripts/batchScheduler.test.ts",
     "test:transaction-barrier": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx scripts/transactionBarrier.test.ts",
     "test:current-scene-guard": "tsx scripts/currentSceneGuard.test.ts",
     "test:init-ready": "tsx scripts/initReadyBarrier.test.ts",
+    "test:init-state-reconciliation": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx --tsconfig scripts/tsconfig.appliance-main.json scripts/initStateReconciliation.test.ts",
+    "test:render-runtime-cache": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx scripts/renderRuntimeCache.test.ts",
+    "test:camera-main-thread-fallback": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx --tsconfig scripts/tsconfig.appliance-main.json scripts/mainThreadCameraFallback.test.ts",
     "test:init-reentry:stress": "playwright test tests/init-reentry.stress.spec.ts",
-    "test:undo-timing:coverage": "c8 --reporter=text --reporter=html --include=src/undo/timing.ts --check-coverage --statements 90 --lines 90 --branches 90 --functions 90 tsx test/undoTiming.test.ts",
+    "test:renderer-pixel": "pnpm build:spritejs-runtime && tsx scripts/rendererPixel.test.ts",
+    "test:undo-timing:coverage": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs c8 --reporter=text --reporter=html --include=src/undo/timing.ts --check-coverage --statements 90 --lines 90 --branches 90 --functions 90 tsx test/undoTiming.test.ts",
     "test:selector-api": "tsx test/selectorApi.test.ts",
     "test:rendering-compatibility": "tsx scripts/renderingCompatibility.test.ts",
+    "test:render-runtime-fallback": "tsx scripts/renderRuntimeFallback.test.ts && cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx --tsconfig scripts/tsconfig.appliance-main.json scripts/renderRuntimeFallbackMainEngine.test.ts",
+    "test:image-bitmap-retirement": "tsx scripts/renderImageBitmapRetirement.test.ts",
+    "test:image-bitmap-diagnostic": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx --tsconfig scripts/tsconfig.appliance-main.json scripts/renderImageBitmapDiagnostic.test.ts",
+    "test:service-sync-commit": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx scripts/serviceSyncCommit.test.ts",
+    "test:init-await-boundaries": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx scripts/initAwaitBoundaries.test.ts",
+    "test:font-face-lifecycle": "tsx scripts/fontFaceLifecycle.test.ts",
+    "test:snapshot-lifecycle": "cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx scripts/snapshotLifecycle.test.ts",
+    "test:init-log-aggregation": "tsx scripts/initLogAggregator.test.ts",
     "test:cursor-appearance": "tsx scripts/cursorAppearance.test.ts",
-    "test:bitmap-eraser": "tsx scripts/bitmapEraserCapability.test.ts && tsx scripts/bitmapRasterGeometry.test.ts && tsx scripts/vNodeSpatialIndex.test.ts && tsx scripts/eraserFaces.test.ts",
+    "test:bitmap-eraser": "tsx scripts/bitmapEraserCapability.test.ts && tsx scripts/bitmapRasterGeometry.test.ts && cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx scripts/vNodeSpatialIndex.test.ts && cross-env NODE_OPTIONS=--require=./scripts/registerAssetStubs.cjs tsx scripts/eraserFaces.test.ts",
     "test:sync-logger": "tsx scripts/syncLogger.test.ts",
     "test:background-image-load": "tsx scripts/backgroundImageLoadCoordinator.test.ts",
     "test:background-image-query": "tsx scripts/backgroundImageQuery.test.ts",
@@ -68,7 +80,7 @@
     "types:bundler": "tsc --emitDeclarationOnly",
     "build:spritejs-runtime": "pnpm --dir ../spritejs compile:appliance",
     "build:bridge": "vite build --config vite.config.bridge.js",
-    "build:bundler": "vite build --config vite.config.bundler.js && pnpm build:bridge && pnpm types:bundler",
+    "build:bundler": "vite build --config vite.config.bundler.js && node scripts/assertRenderRuntimeMarker.mjs && pnpm build:bridge && pnpm types:bundler",
     "types:worker": "tsc --noEmit",
     "build:worker:full": "vite build --config vite.config.worker-full.js",
     "build:worker:sub": "vite build --config vite.config.worker-sub.js",
@@ -91,11 +103,13 @@
     "@types/rbush": "4.0.0",
     "@types/react": "^18.3.28",
     "@types/react-dom": "^18.3.7",
+    "@types/spark-md5": "3.0.5",
     "@typescript-eslint/eslint-plugin": "^8.39.0",
     "@typescript-eslint/parser": "^8.39.0",
     "@vitest/coverage-v8": "^4.1.9",
     "c8": "^11.0.0",
     "cross-env": "^7.0.3",
+    "eslint": "^9.39.4",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.20",
     "jsdom": "^29.1.1",
@@ -110,7 +124,7 @@
     "typescript": "^5.2.2",
     "vite": "^5.0.0",
     "vitest": "^4.1.9",
-    "white-web-sdk": "^2.16.57"
+    "white-web-sdk": "^2.16.58"
   },
   "peerDependencies": {
     "@netless/window-manager": ">=1.0",
@@ -142,6 +156,7 @@
     "react": "^16.8.0",
     "react-dom": "^16.8.0",
     "react-draggable": "4.5.0",
+    "spark-md5": "3.0.2",
     "xss": "^1.0.15"
   },
   "directories": {