refactor(dash): [PKG-DASH-03] adapt SDK generations and own menu lifecycles

refactor/baselines/dash-runtime.json

@@ -0,0 +1,854 @@
+{
+  "schemaVersion": 1,
+  "task": "PKG-DASH-03",
+  "baseCommit": "762cc634",
+  "scope": "Runtime structure and compatible SDK call surfaces. Real old/new core DOM with formal plugin main/legacy and native MP4. SDK is controlled; actual dash.js, MPD/ABR, physical devices and installed tarball acceptance remain outstanding.",
+  "inputs": [
+    {
+      "file": "packages/artplayer-plugin-dash-control/src/index.js",
+      "sha256LF": "3d82930fa8da9f729235ed34e5b9ae732bde6a986124b0ca1016eabefae4fc70"
+    },
+    {
+      "file": "packages/artplayer-plugin-dash-control/src/sdk.js",
+      "sha256LF": "90f77e57fd9d8cae3c7876166b048285d18634a93eecfcf50a70f8d6c9da1050"
+    },
+    {
+      "file": "packages/artplayer-plugin-dash-control/src/mapping.js",
+      "sha256LF": "03c1b99e0869263778f05896b05d2fe4004cf657fd5168cb303926a90de35b34"
+    },
+    {
+      "file": "packages/artplayer-plugin-dash-control/src/menu.js",
+      "sha256LF": "e852cbdf07bd681594c95ee368834995d34c6d1314d06c1c6089a025b1d7b896"
+    },
+    {
+      "file": "test/helpers/dash-control.js",
+      "sha256LF": "a32852c960a25c27ae18a6910f2b6d9e4f5786c1339db91f414b70a1fec041db"
+    },
+    {
+      "file": "test/dash-contract.test.js",
+      "sha256LF": "4477b48fc53224890a7eb22ed5f1554b57fd6265c864fb4039393978e63ceb31"
+    },
+    {
+      "file": "test/dash-lifecycle.test.js",
+      "sha256LF": "1374d51d7952c44a63580a6b127bc53f626ba161a03982414299d807cfc1525c"
+    },
+    {
+      "file": "test/browser/dash-control.spec.js",
+      "sha256LF": "a770394af0f3291925734e116ab53f8c090349673aa14205bd9a1300c82ad154"
+    }
+  ],
+  "artifacts": [
+    {
+      "file": "packages/artplayer-plugin-dash-control/dist/artplayer-plugin-dash-control.js",
+      "sha256": "c1c63bd0ec787a6f9eb445b53341dd5eaeaccccd1589455234be311fcf6ce5e6",
+      "bytes": 5469
+    },
+    {
+      "file": "packages/artplayer-plugin-dash-control/dist/artplayer-plugin-dash-control.legacy.js",
+      "sha256": "1b6fba04c90ba19197213cf1868599dab13d430e8923d3081e37c43dc4d5d00e",
+      "bytes": 5924
+    },
+    {
+      "file": "packages/artplayer-plugin-dash-control/dist/artplayer-plugin-dash-control.mjs",
+      "sha256": "84b50383a8d6e75ad27dad6b550826b0d690aaaec9b2831a65111ec4f4c277b0",
+      "bytes": 9724
+    }
+  ],
+  "reports": [
+    {
+      "file": "refactor/.cache/dash03-main-first/report.json",
+      "sha256": "b17971ffd22f20acd68b64bb4ba7bff62b65c6fcc9ce10836b1f16f2d1bc9bd3",
+      "bytes": 15822733,
+      "stats": {
+        "startTime": "2026-09-11T20:51:00.164Z",
+        "duration": 64825.979,
+        "expected": 84,
+        "skipped": 0,
+        "unexpected": 0,
+        "flaky": 0
+      },
+      "results": {
+        "directory": "refactor/.cache/dash03-main-first/results",
+        "files": 85,
+        "sha256": "a92c517dd7be719052b8766b3d19c00619469c0da792a9b2eead751048893594",
+        "algorithm": "SHA256 of JSON.stringify(sorted relative path and raw SHA256 pairs), UTF-8, slash paths"
+      },
+      "pluginInput": {
+        "published": {
+          "name": "artplayer-plugin-dash-control",
+          "version": "1.1.0",
+          "metadataUrl": "https://registry.npmjs.org/artplayer-plugin-dash-control/1.1.0",
+          "tarball": "https://registry.npmjs.org/artplayer-plugin-dash-control/-/artplayer-plugin-dash-control-1.1.0.tgz",
+          "integrity": "sha512-EssRkzYXWcln3a6nAzi4ESacBhzMih8s0bzdjXuvBBCh2UFmvK99ITD5E+0cuU8i5ZzIQGQSdce1/gANTrX0BQ==",
+          "sha256": "f4047a569d99b6a7de57b3719b7ad40109f2a1d360566a840f50ab32aacefcd9",
+          "archiveBytes": 3385,
+          "registryGitHead": "daf133b22630b4a0eecfa3336bbddab0e9119d96",
+          "files": {
+            "package/README.md": "98982f1123ff9a11f5d3d9a52da6e8fea9cd0989f7465605c27b0f9a46f2dbcd",
+            "package/dist/artplayer-plugin-dash-control.js": "f0cbbcf8badeaca13c05ae178932818cb52fbce37ed504ac0e62160b9c7e1145",
+            "package/dist/artplayer-plugin-dash-control.legacy.js": "f0cbbcf8badeaca13c05ae178932818cb52fbce37ed504ac0e62160b9c7e1145",
+            "package/dist/artplayer-plugin-dash-control.mjs": "e32bf08c33a481781883067dcc639f0495c9dcb8a88b91be13736370f4932fc4",
+            "package/package.json": "556e2adc479bab36c5973de617c0b57c5d86aa8425643a1952ab04738e9ce927",
+            "package/types/artplayer-plugin-dash-control.d.ts": "e15ef683e0c335d81531587828593325e037efe7ed29c022477cd14fe71aebba"
+          },
+          "manifest": {
+            "name": "artplayer-plugin-dash-control",
+            "version": "1.1.0",
+            "description": "Dash control plugin for ArtPlayer",
+            "author": "Harvey Zhao <laozhaochaguan@gmail.com>",
+            "license": "MIT",
+            "homepage": "https://artplayer.org",
+            "repository": {
+              "type": "git",
+              "url": "git+https://github.com/zhw2590582/ArtPlayer.git"
+            },
+            "bugs": {
+              "url": "https://github.com/zhw2590582/ArtPlayer/issues"
+            },
+            "keywords": [
+              "html5",
+              "video",
+              "player"
+            ],
+            "exports": {
+              ".": {
+                "types": "./types/artplayer-plugin-dash-control.d.ts",
+                "import": "./dist/artplayer-plugin-dash-control.mjs",
+                "require": "./dist/artplayer-plugin-dash-control.js"
+              },
+              "./legacy": {
+                "types": "./types/artplayer-plugin-dash-control.d.ts",
+                "import": "./dist/artplayer-plugin-dash-control.legacy.js",
+                "require": "./dist/artplayer-plugin-dash-control.legacy.js"
+              }
+            },
+            "main": "./dist/artplayer-plugin-dash-control.js",
+            "module": "./dist/artplayer-plugin-dash-control.mjs",
+            "types": "./types/artplayer-plugin-dash-control.d.ts",
+            "legacy": "./dist/artplayer-plugin-dash-control.legacy.js",
+            "browserslist": "last 1 Chrome version"
+          }
+        },
+        "sourceSHA256": "6c37d58c427aa688fe252127dbbc5bb131d0ef6e5141a3b22400f40e5fd177f9",
+        "candidate": "packages/artplayer-plugin-dash-control/dist/artplayer-plugin-dash-control.js",
+        "scope": "Real ArtPlayer DOM and native MP4 with controlled SDK methods. No dash.js instance, MPD, ABR or adaptive media validation."
+      },
+      "engines": [
+        {
+          "project": "chromium",
+          "version": "153.0.8010.12",
+          "platform": "win32"
+        },
+        {
+          "project": "firefox",
+          "version": "155.0",
+          "platform": "win32"
+        },
+        {
+          "project": "webkit",
+          "version": "26.6",
+          "platform": "win32"
+        }
+      ],
+      "manifest": {
+        "kind": "artplayer-browser-test",
+        "resources": {
+          "/candidate/artplayer.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer\\src\\index.ts"
+            },
+            "sha256": "df495dd386d32ea96be5006e1bbfda1ea91cfeb32aa21758197b46a155ebe0dc",
+            "bytes": 378040
+          },
+          "/compiled/artplayer.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer\\src\\index.ts"
+            },
+            "sha256": "df495dd386d32ea96be5006e1bbfda1ea91cfeb32aa21758197b46a155ebe0dc",
+            "bytes": 378040,
+            "aliasOf": "/candidate/artplayer.js"
+          },
+          "/uncompiled/artplayer/index.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer\\src\\index.ts"
+            },
+            "sha256": "df495dd386d32ea96be5006e1bbfda1ea91cfeb32aa21758197b46a155ebe0dc",
+            "bytes": 378040,
+            "aliasOf": "/candidate/artplayer.js"
+          },
+          "/candidate/artplayer-plugin-chapter.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer-plugin-chapter\\src\\index.ts"
+            },
+            "sha256": "1a8eb891d3690e2526e78a2e53183a25367b1d02a5fd349d821548edb731ee3a",
+            "bytes": 8529
+          },
+          "/compiled/artplayer-plugin-chapter.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer-plugin-chapter\\src\\index.ts"
+            },
+            "sha256": "1a8eb891d3690e2526e78a2e53183a25367b1d02a5fd349d821548edb731ee3a",
+            "bytes": 8529,
+            "aliasOf": "/candidate/artplayer-plugin-chapter.js"
+          },
+          "/uncompiled/artplayer-plugin-chapter/index.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer-plugin-chapter\\src\\index.ts"
+            },
+            "sha256": "1a8eb891d3690e2526e78a2e53183a25367b1d02a5fd349d821548edb731ee3a",
+            "bytes": 8529,
+            "aliasOf": "/candidate/artplayer-plugin-chapter.js"
+          },
+          "/published/artplayer.js": {
+            "source": {
+              "kind": "npm-release",
+              "version": "5.4.0",
+              "integrity": "sha512-2B+plbx8N2yNsjK4nJU3+EOG8TULm1LRZk/QPkWRAMEX2Ee/MSnZG/WJYz8kcoZxZuLKcQ3uXifqLuPxZOH29A==",
+              "member": "package/dist/artplayer.js"
+            },
+            "sha256": "f1db1fa3406aa6d41baa7c554749429a8e79f99d56a794bde23345eb9c07573f",
+            "bytes": 134037
+          },
+          "/published/artplayer-plugin-chapter.js": {
+            "source": {
+              "kind": "npm-release",
+              "version": "1.1.0",
+              "integrity": "sha512-ji66Lr2K2S+OjFMuMby3yq+pefWlOC51Sbpop/DIr2N6w3F0smrF+YZbshN1Dy8/Tx1TYpT7N6WkkZWy5Jix1w==",
+              "member": "package/dist/artplayer-plugin-chapter.js"
+            },
+            "sha256": "c2aaee11bf1db765433b01d9f8dd3978e41fa4d39655db00ebd03fc0be3e35e0",
+            "bytes": 4973
+          },
+          "/test/pattern.mp4": {
+            "source": {
+              "kind": "generated-media",
+              "file": "test/browser/media/pattern.mp4"
+            },
+            "sha256": "0ad1d7ad286aec6e0fa9e27fc1e487e7277df2e603e30040fb942365763d0233",
+            "bytes": 251538
+          },
+          "/test/pattern.webm": {
+            "source": {
+              "kind": "generated-media",
+              "file": "test/browser/media/pattern.webm"
+            },
+            "sha256": "9d3c2b3dec9581a599de2d6732992ef7846790e0d1368e6e131bd339b39e984f",
+            "bytes": 162073
+          },
+          "/test/audio-tone.m4a": {
+            "source": {
+              "kind": "generated-media",
+              "file": "test/browser/media/audio-tone.m4a"
+            },
+            "sha256": "83e6672b880b5d1c97093b1e26bdc40221c0b279615f40e99dbf9d2ade7b4d56",
+            "bytes": 132436
+          },
+          "/test/declaration-cues.vtt": {
+            "source": {
+              "kind": "test-subtitles",
+              "file": "test/browser/media/declaration-cues.vtt"
+            },
+            "sha256": "5d149d4e641ce41cbb83376835c03daf1fb89f3b9f568fa59e064d51e2b57704",
+            "bytes": 54
+          },
+          "/test/thumbnail-grid.svg": {
+            "source": {
+              "kind": "test-thumbnail-grid",
+              "file": "test/browser/media/thumbnail-grid.svg"
+            },
+            "sha256": "bb3f1ec9895d37def77ca4b192d3cd73577a2668558cc99de1588f511d65d3e6",
+            "bytes": 14969
+          },
+          "/test/legacy-safe-area.js": {
+            "source": {
+              "kind": "frozen-own-source",
+              "file": "test/helpers/legacy-safe-area.js",
+              "commit": "ccf77c4e"
+            },
+            "sha256": "ce0368618ef6363b78271b8bcc7973abd0478e797cc464ddd912929e6dfa501a",
+            "bytes": 795
+          },
+          "/assets/sample/video.mp4": {
+            "source": {
+              "kind": "docs-media",
+              "file": "docs/assets/sample/video.mp4"
+            },
+            "sha256": "30a2de667ba267b6bc605edcee1c4bd728c048ed76f500ea0e73d1f1a6f8f980",
+            "bytes": 5818706
+          },
+          "/test/performance.js": {
+            "source": {
+              "kind": "adapted-baseline-fixture",
+              "file": "refactor/fixtures/performance.js"
+            },
+            "sha256": "2318f39bdb5f3a3348d755cb4335907ae4adc944be3a435839c1bba201e81500",
+            "bytes": 8994
+          }
+        }
+      }
+    },
+    {
+      "file": "refactor/.cache/dash03-main-final/report.json",
+      "sha256": "c3175930e53b8d4771c5393de015520f0dbcfb56362cd8017c1263ac1eba8758",
+      "bytes": 15813200,
+      "stats": {
+        "startTime": "2026-09-11T20:53:02.032Z",
+        "duration": 64490.32,
+        "expected": 84,
+        "skipped": 0,
+        "unexpected": 0,
+        "flaky": 0
+      },
+      "results": {
+        "directory": "refactor/.cache/dash03-main-final/results",
+        "files": 85,
+        "sha256": "d3efa538c4ba0e698aa95b40b112caabf8324b5f3beec05f6845e7f5675de857",
+        "algorithm": "SHA256 of JSON.stringify(sorted relative path and raw SHA256 pairs), UTF-8, slash paths"
+      },
+      "pluginInput": {
+        "published": {
+          "name": "artplayer-plugin-dash-control",
+          "version": "1.1.0",
+          "metadataUrl": "https://registry.npmjs.org/artplayer-plugin-dash-control/1.1.0",
+          "tarball": "https://registry.npmjs.org/artplayer-plugin-dash-control/-/artplayer-plugin-dash-control-1.1.0.tgz",
+          "integrity": "sha512-EssRkzYXWcln3a6nAzi4ESacBhzMih8s0bzdjXuvBBCh2UFmvK99ITD5E+0cuU8i5ZzIQGQSdce1/gANTrX0BQ==",
+          "sha256": "f4047a569d99b6a7de57b3719b7ad40109f2a1d360566a840f50ab32aacefcd9",
+          "archiveBytes": 3385,
+          "registryGitHead": "daf133b22630b4a0eecfa3336bbddab0e9119d96",
+          "files": {
+            "package/README.md": "98982f1123ff9a11f5d3d9a52da6e8fea9cd0989f7465605c27b0f9a46f2dbcd",
+            "package/dist/artplayer-plugin-dash-control.js": "f0cbbcf8badeaca13c05ae178932818cb52fbce37ed504ac0e62160b9c7e1145",
+            "package/dist/artplayer-plugin-dash-control.legacy.js": "f0cbbcf8badeaca13c05ae178932818cb52fbce37ed504ac0e62160b9c7e1145",
+            "package/dist/artplayer-plugin-dash-control.mjs": "e32bf08c33a481781883067dcc639f0495c9dcb8a88b91be13736370f4932fc4",
+            "package/package.json": "556e2adc479bab36c5973de617c0b57c5d86aa8425643a1952ab04738e9ce927",
+            "package/types/artplayer-plugin-dash-control.d.ts": "e15ef683e0c335d81531587828593325e037efe7ed29c022477cd14fe71aebba"
+          },
+          "manifest": {
+            "name": "artplayer-plugin-dash-control",
+            "version": "1.1.0",
+            "description": "Dash control plugin for ArtPlayer",
+            "author": "Harvey Zhao <laozhaochaguan@gmail.com>",
+            "license": "MIT",
+            "homepage": "https://artplayer.org",
+            "repository": {
+              "type": "git",
+              "url": "git+https://github.com/zhw2590582/ArtPlayer.git"
+            },
+            "bugs": {
+              "url": "https://github.com/zhw2590582/ArtPlayer/issues"
+            },
+            "keywords": [
+              "html5",
+              "video",
+              "player"
+            ],
+            "exports": {
+              ".": {
+                "types": "./types/artplayer-plugin-dash-control.d.ts",
+                "import": "./dist/artplayer-plugin-dash-control.mjs",
+                "require": "./dist/artplayer-plugin-dash-control.js"
+              },
+              "./legacy": {
+                "types": "./types/artplayer-plugin-dash-control.d.ts",
+                "import": "./dist/artplayer-plugin-dash-control.legacy.js",
+                "require": "./dist/artplayer-plugin-dash-control.legacy.js"
+              }
+            },
+            "main": "./dist/artplayer-plugin-dash-control.js",
+            "module": "./dist/artplayer-plugin-dash-control.mjs",
+            "types": "./types/artplayer-plugin-dash-control.d.ts",
+            "legacy": "./dist/artplayer-plugin-dash-control.legacy.js",
+            "browserslist": "last 1 Chrome version"
+          }
+        },
+        "sourceSHA256": "c1c63bd0ec787a6f9eb445b53341dd5eaeaccccd1589455234be311fcf6ce5e6",
+        "candidate": "packages/artplayer-plugin-dash-control/dist/artplayer-plugin-dash-control.js",
+        "scope": "Real ArtPlayer DOM and native MP4 with controlled SDK methods. No dash.js instance, MPD, ABR or adaptive media validation."
+      },
+      "engines": [
+        {
+          "project": "chromium",
+          "version": "153.0.8010.12",
+          "platform": "win32"
+        },
+        {
+          "project": "firefox",
+          "version": "155.0",
+          "platform": "win32"
+        },
+        {
+          "project": "webkit",
+          "version": "26.6",
+          "platform": "win32"
+        }
+      ],
+      "manifest": {
+        "kind": "artplayer-browser-test",
+        "resources": {
+          "/candidate/artplayer.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer\\src\\index.ts"
+            },
+            "sha256": "df495dd386d32ea96be5006e1bbfda1ea91cfeb32aa21758197b46a155ebe0dc",
+            "bytes": 378040
+          },
+          "/compiled/artplayer.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer\\src\\index.ts"
+            },
+            "sha256": "df495dd386d32ea96be5006e1bbfda1ea91cfeb32aa21758197b46a155ebe0dc",
+            "bytes": 378040,
+            "aliasOf": "/candidate/artplayer.js"
+          },
+          "/uncompiled/artplayer/index.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer\\src\\index.ts"
+            },
+            "sha256": "df495dd386d32ea96be5006e1bbfda1ea91cfeb32aa21758197b46a155ebe0dc",
+            "bytes": 378040,
+            "aliasOf": "/candidate/artplayer.js"
+          },
+          "/candidate/artplayer-plugin-chapter.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer-plugin-chapter\\src\\index.ts"
+            },
+            "sha256": "1a8eb891d3690e2526e78a2e53183a25367b1d02a5fd349d821548edb731ee3a",
+            "bytes": 8529
+          },
+          "/compiled/artplayer-plugin-chapter.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer-plugin-chapter\\src\\index.ts"
+            },
+            "sha256": "1a8eb891d3690e2526e78a2e53183a25367b1d02a5fd349d821548edb731ee3a",
+            "bytes": 8529,
+            "aliasOf": "/candidate/artplayer-plugin-chapter.js"
+          },
+          "/uncompiled/artplayer-plugin-chapter/index.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer-plugin-chapter\\src\\index.ts"
+            },
+            "sha256": "1a8eb891d3690e2526e78a2e53183a25367b1d02a5fd349d821548edb731ee3a",
+            "bytes": 8529,
+            "aliasOf": "/candidate/artplayer-plugin-chapter.js"
+          },
+          "/published/artplayer.js": {
+            "source": {
+              "kind": "npm-release",
+              "version": "5.4.0",
+              "integrity": "sha512-2B+plbx8N2yNsjK4nJU3+EOG8TULm1LRZk/QPkWRAMEX2Ee/MSnZG/WJYz8kcoZxZuLKcQ3uXifqLuPxZOH29A==",
+              "member": "package/dist/artplayer.js"
+            },
+            "sha256": "f1db1fa3406aa6d41baa7c554749429a8e79f99d56a794bde23345eb9c07573f",
+            "bytes": 134037
+          },
+          "/published/artplayer-plugin-chapter.js": {
+            "source": {
+              "kind": "npm-release",
+              "version": "1.1.0",
+              "integrity": "sha512-ji66Lr2K2S+OjFMuMby3yq+pefWlOC51Sbpop/DIr2N6w3F0smrF+YZbshN1Dy8/Tx1TYpT7N6WkkZWy5Jix1w==",
+              "member": "package/dist/artplayer-plugin-chapter.js"
+            },
+            "sha256": "c2aaee11bf1db765433b01d9f8dd3978e41fa4d39655db00ebd03fc0be3e35e0",
+            "bytes": 4973
+          },
+          "/test/pattern.mp4": {
+            "source": {
+              "kind": "generated-media",
+              "file": "test/browser/media/pattern.mp4"
+            },
+            "sha256": "0ad1d7ad286aec6e0fa9e27fc1e487e7277df2e603e30040fb942365763d0233",
+            "bytes": 251538
+          },
+          "/test/pattern.webm": {
+            "source": {
+              "kind": "generated-media",
+              "file": "test/browser/media/pattern.webm"
+            },
+            "sha256": "9d3c2b3dec9581a599de2d6732992ef7846790e0d1368e6e131bd339b39e984f",
+            "bytes": 162073
+          },
+          "/test/audio-tone.m4a": {
+            "source": {
+              "kind": "generated-media",
+              "file": "test/browser/media/audio-tone.m4a"
+            },
+            "sha256": "83e6672b880b5d1c97093b1e26bdc40221c0b279615f40e99dbf9d2ade7b4d56",
+            "bytes": 132436
+          },
+          "/test/declaration-cues.vtt": {
+            "source": {
+              "kind": "test-subtitles",
+              "file": "test/browser/media/declaration-cues.vtt"
+            },
+            "sha256": "5d149d4e641ce41cbb83376835c03daf1fb89f3b9f568fa59e064d51e2b57704",
+            "bytes": 54
+          },
+          "/test/thumbnail-grid.svg": {
+            "source": {
+              "kind": "test-thumbnail-grid",
+              "file": "test/browser/media/thumbnail-grid.svg"
+            },
+            "sha256": "bb3f1ec9895d37def77ca4b192d3cd73577a2668558cc99de1588f511d65d3e6",
+            "bytes": 14969
+          },
+          "/test/legacy-safe-area.js": {
+            "source": {
+              "kind": "frozen-own-source",
+              "file": "test/helpers/legacy-safe-area.js",
+              "commit": "ccf77c4e"
+            },
+            "sha256": "ce0368618ef6363b78271b8bcc7973abd0478e797cc464ddd912929e6dfa501a",
+            "bytes": 795
+          },
+          "/assets/sample/video.mp4": {
+            "source": {
+              "kind": "docs-media",
+              "file": "docs/assets/sample/video.mp4"
+            },
+            "sha256": "30a2de667ba267b6bc605edcee1c4bd728c048ed76f500ea0e73d1f1a6f8f980",
+            "bytes": 5818706
+          },
+          "/test/performance.js": {
+            "source": {
+              "kind": "adapted-baseline-fixture",
+              "file": "refactor/fixtures/performance.js"
+            },
+            "sha256": "2318f39bdb5f3a3348d755cb4335907ae4adc944be3a435839c1bba201e81500",
+            "bytes": 8994
+          }
+        }
+      }
+    },
+    {
+      "file": "refactor/.cache/dash03-legacy-final/report.json",
+      "sha256": "5eaa45267a3f0e6a5c5922f974d46737a7d3c559c9a8e2dab84e8262269e6d83",
+      "bytes": 15807757,
+      "stats": {
+        "startTime": "2026-09-11T20:55:36.976Z",
+        "duration": 69224.891,
+        "expected": 84,
+        "skipped": 0,
+        "unexpected": 0,
+        "flaky": 0
+      },
+      "results": {
+        "directory": "refactor/.cache/dash03-legacy-final/results",
+        "files": 85,
+        "sha256": "a7016f915efb43c45b31f9d25b755fba95c649ec7008bb397130cc840e78b7fe",
+        "algorithm": "SHA256 of JSON.stringify(sorted relative path and raw SHA256 pairs), UTF-8, slash paths"
+      },
+      "pluginInput": {
+        "published": {
+          "name": "artplayer-plugin-dash-control",
+          "version": "1.1.0",
+          "metadataUrl": "https://registry.npmjs.org/artplayer-plugin-dash-control/1.1.0",
+          "tarball": "https://registry.npmjs.org/artplayer-plugin-dash-control/-/artplayer-plugin-dash-control-1.1.0.tgz",
+          "integrity": "sha512-EssRkzYXWcln3a6nAzi4ESacBhzMih8s0bzdjXuvBBCh2UFmvK99ITD5E+0cuU8i5ZzIQGQSdce1/gANTrX0BQ==",
+          "sha256": "f4047a569d99b6a7de57b3719b7ad40109f2a1d360566a840f50ab32aacefcd9",
+          "archiveBytes": 3385,
+          "registryGitHead": "daf133b22630b4a0eecfa3336bbddab0e9119d96",
+          "files": {
+            "package/README.md": "98982f1123ff9a11f5d3d9a52da6e8fea9cd0989f7465605c27b0f9a46f2dbcd",
+            "package/dist/artplayer-plugin-dash-control.js": "f0cbbcf8badeaca13c05ae178932818cb52fbce37ed504ac0e62160b9c7e1145",
+            "package/dist/artplayer-plugin-dash-control.legacy.js": "f0cbbcf8badeaca13c05ae178932818cb52fbce37ed504ac0e62160b9c7e1145",
+            "package/dist/artplayer-plugin-dash-control.mjs": "e32bf08c33a481781883067dcc639f0495c9dcb8a88b91be13736370f4932fc4",
+            "package/package.json": "556e2adc479bab36c5973de617c0b57c5d86aa8425643a1952ab04738e9ce927",
+            "package/types/artplayer-plugin-dash-control.d.ts": "e15ef683e0c335d81531587828593325e037efe7ed29c022477cd14fe71aebba"
+          },
+          "manifest": {
+            "name": "artplayer-plugin-dash-control",
+            "version": "1.1.0",
+            "description": "Dash control plugin for ArtPlayer",
+            "author": "Harvey Zhao <laozhaochaguan@gmail.com>",
+            "license": "MIT",
+            "homepage": "https://artplayer.org",
+            "repository": {
+              "type": "git",
+              "url": "git+https://github.com/zhw2590582/ArtPlayer.git"
+            },
+            "bugs": {
+              "url": "https://github.com/zhw2590582/ArtPlayer/issues"
+            },
+            "keywords": [
+              "html5",
+              "video",
+              "player"
+            ],
+            "exports": {
+              ".": {
+                "types": "./types/artplayer-plugin-dash-control.d.ts",
+                "import": "./dist/artplayer-plugin-dash-control.mjs",
+                "require": "./dist/artplayer-plugin-dash-control.js"
+              },
+              "./legacy": {
+                "types": "./types/artplayer-plugin-dash-control.d.ts",
+                "import": "./dist/artplayer-plugin-dash-control.legacy.js",
+                "require": "./dist/artplayer-plugin-dash-control.legacy.js"
+              }
+            },
+            "main": "./dist/artplayer-plugin-dash-control.js",
+            "module": "./dist/artplayer-plugin-dash-control.mjs",
+            "types": "./types/artplayer-plugin-dash-control.d.ts",
+            "legacy": "./dist/artplayer-plugin-dash-control.legacy.js",
+            "browserslist": "last 1 Chrome version"
+          }
+        },
+        "sourceSHA256": "1b6fba04c90ba19197213cf1868599dab13d430e8923d3081e37c43dc4d5d00e",
+        "candidate": "packages/artplayer-plugin-dash-control/dist/artplayer-plugin-dash-control.legacy.js",
+        "scope": "Real ArtPlayer DOM and native MP4 with controlled SDK methods. No dash.js instance, MPD, ABR or adaptive media validation."
+      },
+      "engines": [
+        {
+          "project": "chromium",
+          "version": "153.0.8010.12",
+          "platform": "win32"
+        },
+        {
+          "project": "firefox",
+          "version": "155.0",
+          "platform": "win32"
+        },
+        {
+          "project": "webkit",
+          "version": "26.6",
+          "platform": "win32"
+        }
+      ],
+      "manifest": {
+        "kind": "artplayer-browser-test",
+        "resources": {
+          "/candidate/artplayer.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer\\src\\index.ts"
+            },
+            "sha256": "df495dd386d32ea96be5006e1bbfda1ea91cfeb32aa21758197b46a155ebe0dc",
+            "bytes": 378040
+          },
+          "/compiled/artplayer.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer\\src\\index.ts"
+            },
+            "sha256": "df495dd386d32ea96be5006e1bbfda1ea91cfeb32aa21758197b46a155ebe0dc",
+            "bytes": 378040,
+            "aliasOf": "/candidate/artplayer.js"
+          },
+          "/uncompiled/artplayer/index.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer\\src\\index.ts"
+            },
+            "sha256": "df495dd386d32ea96be5006e1bbfda1ea91cfeb32aa21758197b46a155ebe0dc",
+            "bytes": 378040,
+            "aliasOf": "/candidate/artplayer.js"
+          },
+          "/candidate/artplayer-plugin-chapter.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer-plugin-chapter\\src\\index.ts"
+            },
+            "sha256": "1a8eb891d3690e2526e78a2e53183a25367b1d02a5fd349d821548edb731ee3a",
+            "bytes": 8529
+          },
+          "/compiled/artplayer-plugin-chapter.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer-plugin-chapter\\src\\index.ts"
+            },
+            "sha256": "1a8eb891d3690e2526e78a2e53183a25367b1d02a5fd349d821548edb731ee3a",
+            "bytes": 8529,
+            "aliasOf": "/candidate/artplayer-plugin-chapter.js"
+          },
+          "/uncompiled/artplayer-plugin-chapter/index.js": {
+            "source": {
+              "kind": "workspace-build",
+              "entry": "packages\\artplayer-plugin-chapter\\src\\index.ts"
+            },
+            "sha256": "1a8eb891d3690e2526e78a2e53183a25367b1d02a5fd349d821548edb731ee3a",
+            "bytes": 8529,
+            "aliasOf": "/candidate/artplayer-plugin-chapter.js"
+          },
+          "/published/artplayer.js": {
+            "source": {
+              "kind": "npm-release",
+              "version": "5.4.0",
+              "integrity": "sha512-2B+plbx8N2yNsjK4nJU3+EOG8TULm1LRZk/QPkWRAMEX2Ee/MSnZG/WJYz8kcoZxZuLKcQ3uXifqLuPxZOH29A==",
+              "member": "package/dist/artplayer.js"
+            },
+            "sha256": "f1db1fa3406aa6d41baa7c554749429a8e79f99d56a794bde23345eb9c07573f",
+            "bytes": 134037
+          },
+          "/published/artplayer-plugin-chapter.js": {
+            "source": {
+              "kind": "npm-release",
+              "version": "1.1.0",
+              "integrity": "sha512-ji66Lr2K2S+OjFMuMby3yq+pefWlOC51Sbpop/DIr2N6w3F0smrF+YZbshN1Dy8/Tx1TYpT7N6WkkZWy5Jix1w==",
+              "member": "package/dist/artplayer-plugin-chapter.js"
+            },
+            "sha256": "c2aaee11bf1db765433b01d9f8dd3978e41fa4d39655db00ebd03fc0be3e35e0",
+            "bytes": 4973
+          },
+          "/test/pattern.mp4": {
+            "source": {
+              "kind": "generated-media",
+              "file": "test/browser/media/pattern.mp4"
+            },
+            "sha256": "0ad1d7ad286aec6e0fa9e27fc1e487e7277df2e603e30040fb942365763d0233",
+            "bytes": 251538
+          },
+          "/test/pattern.webm": {
+            "source": {
+              "kind": "generated-media",
+              "file": "test/browser/media/pattern.webm"
+            },
+            "sha256": "9d3c2b3dec9581a599de2d6732992ef7846790e0d1368e6e131bd339b39e984f",
+            "bytes": 162073
+          },
+          "/test/audio-tone.m4a": {
+            "source": {
+              "kind": "generated-media",
+              "file": "test/browser/media/audio-tone.m4a"
+            },
+            "sha256": "83e6672b880b5d1c97093b1e26bdc40221c0b279615f40e99dbf9d2ade7b4d56",
+            "bytes": 132436
+          },
+          "/test/declaration-cues.vtt": {
+            "source": {
+              "kind": "test-subtitles",
+              "file": "test/browser/media/declaration-cues.vtt"
+            },
+            "sha256": "5d149d4e641ce41cbb83376835c03daf1fb89f3b9f568fa59e064d51e2b57704",
+            "bytes": 54
+          },
+          "/test/thumbnail-grid.svg": {
+            "source": {
+              "kind": "test-thumbnail-grid",
+              "file": "test/browser/media/thumbnail-grid.svg"
+            },
+            "sha256": "bb3f1ec9895d37def77ca4b192d3cd73577a2668558cc99de1588f511d65d3e6",
+            "bytes": 14969
+          },
+          "/test/legacy-safe-area.js": {
+            "source": {
+              "kind": "frozen-own-source",
+              "file": "test/helpers/legacy-safe-area.js",
+              "commit": "ccf77c4e"
+            },
+            "sha256": "ce0368618ef6363b78271b8bcc7973abd0478e797cc464ddd912929e6dfa501a",
+            "bytes": 795
+          },
+          "/assets/sample/video.mp4": {
+            "source": {
+              "kind": "docs-media",
+              "file": "docs/assets/sample/video.mp4"
+            },
+            "sha256": "30a2de667ba267b6bc605edcee1c4bd728c048ed76f500ea0e73d1f1a6f8f980",
+            "bytes": 5818706
+          },
+          "/test/performance.js": {
+            "source": {
+              "kind": "adapted-baseline-fixture",
+              "file": "refactor/fixtures/performance.js"
+            },
+            "sha256": "2318f39bdb5f3a3348d755cb4335907ae4adc944be3a435839c1bba201e81500",
+            "bytes": 8994
+          }
+        }
+      }
+    }
+  ],
+  "logs": [
+    {
+      "file": "refactor/.cache/dash03-before.log",
+      "sha256": "5a4e92a1bcf6a8117ba6745d1d54ade25d58643200ffc1d18d0f09e8e1ba8e28",
+      "bytes": 175508
+    },
+    {
+      "file": "refactor/.cache/dash03-reentry-before.log",
+      "sha256": "bc04fcd6b8518f74718bcc732a26f88fb919a79f63a1dc073fe724849ea0c99d",
+      "bytes": 4865
+    },
+    {
+      "file": "refactor/.cache/dash03-formatter-before.log",
+      "sha256": "0799ccc96096116e75e83db65289102bde825f57796bfb620579927d982084d0",
+      "bytes": 4840
+    },
+    {
+      "file": "refactor/.cache/dash03-node-final.log",
+      "sha256": "4455e88c907ea0f2f335b67c020bf819e47b124fc3e766c1bb220b6135934f6d",
+      "bytes": 11463
+    },
+    {
+      "file": "refactor/.cache/dash03-artifacts-realm-before.log",
+      "sha256": "0a09f96f3457128982aa93d3d5c9a93f84900ea1bf09add729c47d048714b7be",
+      "bytes": 36034
+    },
+    {
+      "file": "refactor/.cache/dash03-artifacts-final.log",
+      "sha256": "c68ec1c1ab54f7e389ce210bc95276ed6484f499e3d2d90cb023bf92a2dcb76b",
+      "bytes": 31662
+    },
+    {
+      "file": "refactor/.cache/dash03-build-final.log",
+      "sha256": "90a8251da20f5ebe7cf2759e87284ab0265bc9db4b7a12dc14304f14019883c1",
+      "bytes": 1472
+    },
+    {
+      "file": "refactor/.cache/dash03-main.log",
+      "sha256": "9c55a02c2bc12d2128779677d9a02a4be3e3c57a50a5ad46631bc703b9d58a99",
+      "bytes": 16163
+    },
+    {
+      "file": "refactor/.cache/dash03-main-final.log",
+      "sha256": "896e9acf28c7b66998dd25ad9c39304242180d8e273f27f16a52a8c3d02fe162",
+      "bytes": 16162
+    },
+    {
+      "file": "refactor/.cache/dash03-legacy-final.log",
+      "sha256": "837a8ad81b4306231d44f9ca38f328afef8a57c1f604196bc64319b772049167",
+      "bytes": 16160
+    },
+    {
+      "file": "refactor/.cache/dash03-ci.log",
+      "sha256": "4d88eba96b783e9e26ea2197c398160b2565e622a58ab5b80db44375bcd85722",
+      "bytes": 74484
+    }
+  ],
+  "results": {
+    "initialRegression": {
+      "passed": 1,
+      "failed": 21
+    },
+    "reentrantCleanupBefore": {
+      "passed": 29,
+      "failed": 2
+    },
+    "formatterShutdownBefore": {
+      "passed": 29,
+      "failed": 2
+    },
+    "nodeFinal": 116,
+    "nodeWithThreeArtifacts": 266,
+    "mainBrowser": 84,
+    "legacyBrowser": 84,
+    "ci": {
+      "unit": 661,
+      "engineering": 14,
+      "baseline": 37
+    }
+  },
+  "localEvidence": "Raw logs and browser reports/traces remain local cache. Committed hashes locate evidence but are not uploaded traces; rerun on a fresh machine."
+}

refactor/changes/2026-09-12-PKG-DASH-03-runtime.md

@@ -0,0 +1,36 @@
+# PKG-DASH-03：两代 SDK 适配、菜单与生命周期拆分
+
+起点 `762cc634`。把单一入口拆为入口生命周期、SDK 方法适配、selector 模型、菜单所有权
+四个模块。保持 JavaScript 完成本步结构与行为修复，下一步 04 再迁移严格 TS 和公开声明。
+包内 [架构图](../../packages/artplayer-plugin-dash-control/ARCHITECTURE.md) 随实际实现维护。
+
+## 行为修正
+
+- 恢复发布版 dash.js 4.x 方法表，同时保留工作区 5.x 稳定 ID；不使用过滤后的下标选画质。
+- 空拓扑、禁用菜单、渲染失败清理自有 UI；换 SDK/重建/销毁后旧引用无副作用。
+- 销毁释放 ready/restart/destroy 订阅，安装异常回滚；不销毁调用方 SDK，不误删调用方替换的菜单。
+- 当前重复标签保留实际当前 key/track；零 ID、唯一克隆轨道高亮正确，歧义轨道不伪造选中。
+- SDK/getName 重入使旧 revision 失效；回调销毁后停止后续格式化、SDK 写入和提示。
+  清理中同步重建时只释放旧所有权，不删除重建的新菜单。
+
+公开工厂、同步 update/选中返回、getName 身份/参数、通知顺序、DOM/CSS hooks 与包入口保持。
+错误继续同步传播原对象，次要清理异常不覆盖原错误。上述历史缺陷作为有意修正记录，
+不把冻结旧实现的缺陷观察改成候选期望。README 更新 SDK 适配说明，没有改 demo 或增加依赖。
+
+## 验证
+
+最初 22 项新增回归先运行旧源码；后续重入和格式化关闭的两组红灯另保留。正式三格式加入
+生命周期回归时发现 4 项 Node VM 数组原型比较问题，实际内容相同；用本地 Array.from
+比较原有精确内容，未放宽断言。所有日志和输入指纹见 [执行证据](../baselines/dash-runtime.json)。
+
+最终源码 116 项、包含三格式及两代 SDK 的 Node 266 项通过；正式 main/legacy 浏览器各
+84 项通过。完整 CI 712 项（661 单元、14 工程、37 基线）通过；包三格式构建成功，
+计划/风险/本地链接校验通过。没有重试或跳过。DASH-LIFE-01 关闭，SDK/实际轨道风险仍 open。
+当前 217 项：73 done、3 doing、141 todo。已完成结构步，不计为 TS 迁移或发布完成。
+
+真实 DOM 浏览器测试扩充到两种候选 SDK、两代核心及空拓扑/销毁：每格式 84 项。
+仍是可控 SDK 方法与原生 MP4，不是实际 dash.js/MPD/ABR 验收。SDK/状态的真实媒体风险
+继续由 05 接续；04 精确类型、06 分发、真机和全局发布复盘没有被本步替代。
+
+本步通过标准构建脚本生成 dist/docs compiled，未手改产物。独立本地提交；不推送、不发布。
+回退本提交同时撤回结构、行为修正、回归和产物，恢复重构前仅支持 5.x 的源码；该限制需知悉。

refactor/dash-validation.md

@@ -1,30 +1,34 @@
 # DASH Control 验证与维护入口
 
-PKG-DASH-02 保护真实 npm 1.1.0 的既有调用契约，以及重构前工作区的 SDK 5.x 稳定 ID
-修正。版本来源见 [发布契约](baselines/dash-control-contract.md)。本步没有更改生产实现。
+测试保护真实 npm 1.1.0 的既有调用契约，以及重构前工作区的 SDK 5.x 稳定 ID 修正。
+版本来源见 [发布契约](baselines/dash-control-contract.md)。02 建立基线，03 已改造生产实现；
+实际模块地图与生命周期规则见 [包内架构](../packages/artplayer-plugin-dash-control/ARCHITECTURE.md)。
 
 ## 可重跑的测试
 
-- `yarn test:dash-control`：原有 5 项过滤/稳定 ID 回归和新增 69 项行为测试，共 74 项。
+- `yarn test:dash-control`：原有 5 项过滤/稳定 ID 回归、80 项行为/历史观察、31 项候选生命周期，共 116 项。
   该脚本和 `test:unit` 都保留旧测试，完整 CI 自动执行。
-- `yarn test:browser test/browser/dash-control.spec.js --trace on`：48 项，两个核心、两个插件、
-  两类菜单、两种选择、Chromium/Firefox/WebKit。浏览器套件串行运行，避免共享端口和报告覆盖。
+- `yarn test:browser test/browser/dash-control.spec.js --trace on`：84 项，两个核心、发布插件 SDK 4/
+  候选插件 SDK 4/5、两类菜单、两种选择及候选清理、Chromium/Firefox/WebKit。
+  浏览器套件串行运行，避免共享端口和报告覆盖。
 - `yarn ci:check`：工具链、计划、lint、声明漂移、严格类型和 Node/基线测试。
 
 Node helper 分别加载当前源码、固定 Git 提交的旧工作区 UMD、实际 npm main/legacy/module。
 Git 内容以 LF 指纹核对，发布归档与成员以原始字节指纹核对。`ARTPLAYER_TEST_DASH` 可指定
-待测产物，以系统路径分隔符连接；未设置时不会把源码测试冒充三种候选产物验证。
+待测产物，以系统路径分隔符连接；同时指定 main/legacy/module 时共 266 项，包含两代 SDK 的
+行为与生命周期。未设置时不会把源码测试冒充三种候选产物验证。
 
 `test/helpers/dash-control.js` 只提供可控 SDK 方法和组件注册表，检查 this、类型参数、
 原始轨道身份、调用顺序、错误身份、ABR 配置保留、换 SDK、多实例和关闭后的引用。
-真实旧实现的缺陷观察保持冻结；03 修复时为候选实现新增正确行为断言，不把历史缺陷当作兼容要求。
+真实旧实现的缺陷观察保持冻结；候选生命周期新增正确行为断言，不把历史缺陷当作兼容要求。
 
 浏览器使用真实发布/候选 ArtPlayer DOM、真实发布/候选插件和本地原生 MP4。SDK 方法可控，
 断言真实点击触发的参数及控制栏/设置同步，再通过真实播放按钮验证视频时钟推进、无媒体错误。
 **没有加载 dash.js，没有验证 MPD、ABR 自动切换或自适应流解码。** 这些仍是 05 必须完成的
-固定 dash.js 4.5.2 / 5.2.1 集成验证。`ARTPLAYER_DASH_ARTIFACT` 可替换插件脚本；本次没有使用。
+固定 dash.js 4.5.2 / 5.2.1 集成验证。`ARTPLAYER_DASH_ARTIFACT` 可替换插件脚本；02 未设置，
+03 分别使用正式 main 与 legacy 文件。核心仍按服务端 manifest 加载发布/候选源码构建。
 
-## 首次失败与证据
+## 02 首次失败与证据
 
 首次浏览器运行 24 通过、24 失败；全部失败位于设置选项文字定位。trace 中选项确实已渲染，
 整行文本包含图标 SVG 的换行，`^fr$`/`^720p$` 不能匹配。改为当前面板内专用
@@ -35,11 +39,11 @@ Git 内容以 LF 指纹核对，发布归档与成员以原始字节指纹核对
 [本步执行记录](baselines/dash-validation.json)。缓存不入 Git，永久保存的是测试、来源和结果摘要；
 换机器应按上述命令重新取得执行证据，不能声称本地 trace 已上传。
 
-## 下一步缺陷与边界
+## 03 修正与后续边界
 
-- DASH-SDK-01：两代旧实现分别在另一代 SDK 方法表上失败。03 通过能力适配恢复旧用法。
-- DASH-LIFE-01：空列表/禁用后 UI 残留，旧回调仍写旧 SDK，销毁后 update 和订阅仍有效。
-- DASH-STATE-01：克隆当前轨道、重复标签、数字零 representation ID 会丢失高亮。
+- DASH-SDK-01：通过能力适配恢复两代方法表，实际 SDK/媒体仍由 05 验证。
+- DASH-LIFE-01：空列表/禁用后 UI、旧回调、销毁后 update/订阅已修正，补充重入和错误回归。
+- DASH-STATE-01：唯一克隆当前轨道、重复标签、数字零 ID 已修正；实际 SDK 轨道身份仍由 05 核验。
 
-这些受控复现仍是 open，不能以本步绿色测试关闭。03 处理结构、清理与正确当前项，04 完成公开
-类型兼容，05 完成真实 SDK/媒体/组合验证，06 完成包分发验收。物理设备和 npm 发布准入仍待完成。
+状态以 risks.json 为准；受控修复不替代真实 SDK 验收。04 完成严格 TS/公开类型兼容，05 完成
+真实 SDK/媒体/组合验证，06 完成包分发验收。物理设备和 npm 发布准入仍待完成。

refactor/plan.md

@@ -4,7 +4,7 @@
 
 基线：`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 217 项，范围 22 个包及工作区/示例。
 
-状态：todo 142 / doing 3 / blocked 0 / done 72 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
+状态：todo 141 / doing 3 / blocked 0 / done 73 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
 
 前置依赖是启动条件；验收是完成条件。任务可以继续拆分，但不能复用或悄悄删除旧 ID。
 
@@ -203,7 +203,7 @@
 | --- | --- | --- | --- | --- | --- | --- |
 | PKG-DASH-01 | artplayer-plugin-dash-control<br>核对包契约与历史用法 | BASE-05 | quality/audio、representation ID/Auto、getName 和 update | 源码/声明/README/demo/发布包差异已登记；公开形状和版本范围冻结 | H | done |
 | PKG-DASH-02 | artplayer-plugin-dash-control<br>建立特有行为与错误测试 | PKG-DASH-01, ENG-03, ENG-05 | 保留已有 5 项稳定 ID 回归，补发布版 SDK 4.x/当前 5.x、音轨/空列表/过滤/换源与关闭引用 | 旧版本行为可重跑，成功/失败/切源/销毁有必要断言 | H | done |
-| PKG-DASH-03 | artplayer-plugin-dash-control<br>整理内部职责与资源 | PKG-DASH-02, CORE-11, CORE-14 | 能力适配保留 SDK 4.x 与 5.x，稳定 ID 映射、ABR 状态、UI 清理和生命周期职责分离 | 结构变化和缺陷修复分开记录；原 API/事件/资源生命周期通过 | H | todo |
+| PKG-DASH-03 | artplayer-plugin-dash-control<br>整理内部职责与资源 | PKG-DASH-02, CORE-11, CORE-14 | 能力适配保留 SDK 4.x 与 5.x，稳定 ID 映射、ABR 状态、UI 清理和生命周期职责分离 | 结构变化和缺陷修复分开记录；原 API/事件/资源生命周期通过 | H | done |
 | PKG-DASH-04 | artplayer-plugin-dash-control<br>迁移自有源码和公开类型 | PKG-DASH-03, ENG-04, ENG-06, CORE-07 | dash.js adapter、selector 和回调类型 | 严格类型检查、旧消费样例通过；声明路径/导出和同步异步兼容 | H | todo |
 | PKG-DASH-05 | artplayer-plugin-dash-control<br>验证新旧核心和组合 | PKG-DASH-04, CORE-22 | 固定 dash.js 4.5.2/5.2.1 与本地 DASH 实际清晰度/音轨、高亮、Auto 和换源组合 | 最终核心与原支持范围核心分别通过；设备/SDK 缺证据不能标完成 | H | todo |
 | PKG-DASH-06 | artplayer-plugin-dash-control<br>验证分发并同步文档 | PKG-DASH-05, ENG-07 | dash.control.js、支持的 dash.js 版本与产物 | tarball 入口/资源、类型、8082 demo 和 README 一致，有回退记录 | H | todo |
@@ -481,3 +481,4 @@
 - PKG-HLS-SDK-01: [记录](changes/2026-09-12-PKG-HLS-SDK-01-integration.md) [记录](baselines/hls-sdk-validation.json) [记录](baselines/hls-sdk-diagnostics.json)
 - PKG-DASH-01: [记录](changes/2026-09-12-PKG-DASH-01-contract.md) [记录](baselines/dash-control-contract.md) [记录](baselines/dash-control-release.json)
 - PKG-DASH-02: [记录](changes/2026-09-12-PKG-DASH-02-tests.md) [记录](dash-validation.md) [记录](baselines/dash-validation.json)
+- PKG-DASH-03: [记录](changes/2026-09-12-PKG-DASH-03-runtime.md) [记录](baselines/dash-runtime.json) [记录](dash-validation.md)

refactor/progress.md

@@ -1,5 +1,20 @@
 # 进度与证据
 
+## 最新完成：DASH-03 SDK 适配与生命周期源码改造
+
+DASH 源码已拆为入口生命周期、SDK 适配、selector 模型、菜单所有权四个 JS 模块。
+恢复发布版 4.x 方法表，保留 5.x 稳定 ID；修复空菜单残留、过期引用、销毁/安装异常清理、
+重复标签/零 ID/唯一克隆轨道高亮，以及清理重入误删新 UI 和销毁后继续格式化的问题。
+
+源码 116 项、三格式两代 SDK Node 266 项通过；正式插件 main/legacy 三引擎、新旧核心
+DOM/原生 MP4 各 84 项通过。完整 CI 712 项通过，实际 SDK/MPD/ABR 与设备验证仍未完成。
+初始 21 项失败和两组重入/格式化失败、VM 数组比较修正证据均保留，未以重试跳过制造通过。
+DASH-LIFE-01 关闭；DASH-SDK-01/DASH-STATE-01 仍需 05 实际 SDK 验证。
+
+当前 217 项：73 done、3 doing、141 todo。下一步 DASH-04 迁移这四个模块和公开类型到严格 TS。
+详见 [源码变更](changes/2026-09-12-PKG-DASH-03-runtime.md)、[执行证据](baselines/dash-runtime.json)
+及 [包内架构](../packages/artplayer-plugin-dash-control/ARCHITECTURE.md)。独立本地提交，不推送/发布。
+
 ## 最新完成：DASH-02 行为测试与真实 DOM 交互
 
 保留原有 5 项稳定 ID 回归，新增发布三格式/冻结工作区/候选源码契约测试，定向 74 项通过。

refactor/risk-table.md

@@ -136,7 +136,7 @@
 | CHAPTER-LAYOUT-01 | resolved / 已复现 | 长章节标题超出窄播放器进度条宽度 | PKG-CHAPTER-05 |
 | CHAPTER-TIMING-01 | open / 已复现 | Windows WebKit 清晰度切换曾在等待窗口内未见 restart，稍后状态恢复 | PKG-CHAPTER-05 |
 | DASH-SDK-01 | open / 已复现 | npm 发布版 4.x 与工作区仅 5.x 的 SDK 接口不兼容 | PKG-DASH-02, PKG-DASH-03, PKG-DASH-05 |
-| DASH-LIFE-01 | open / 已复现 | DASH 空拓扑残留 UI，监听和旧选择回调缺乏关闭守卫 | PKG-DASH-02, PKG-DASH-03 |
+| DASH-LIFE-01 | resolved / 已复现 | DASH 空拓扑残留 UI，监听和旧选择回调缺乏关闭守卫 | PKG-DASH-02, PKG-DASH-03 |
 | DASH-STATE-01 | open / 已复现 | DASH 当前项高亮使用真值 ID、音轨身份和标签去重，边界待核实 | PKG-DASH-02, PKG-DASH-03, PKG-DASH-05 |
 | DASH-TYPE-01 | open / 源码/产物事实 | DASH 类型未表达默认工厂参数、SDK 回调对象和现代模块入口 | PKG-DASH-04 |
 | DASH-DEMO-01 | open / 源码/产物事实 | DASH 示例仅新 SDK 且重复安装会累积销毁回调 | PKG-DASH-06 |

refactor/risks.json

@@ -2848,7 +2848,9 @@
         "packages/artplayer-plugin-dash-control/types/artplayer-plugin-dash-control.d.ts",
         "docs/assets/example/dash.control.js",
         "test/dash-contract.test.js",
-        "refactor/dash-validation.md"
+        "refactor/dash-validation.md",
+        "test/dash-lifecycle.test.js",
+        "refactor/baselines/dash-runtime.json"
       ],
       "compatibleResolution": "按方法能力适配两代已存在用法，保留 v5 稳定 ID，不能要求旧消费者改用新 SDK。",
       "closureCriteria": "归档旧用法、v4/v5 受控及实际媒体矩阵通过，清晰度键不混用。"
@@ -2857,7 +2859,7 @@
       "id": "DASH-LIFE-01",
       "title": "DASH 空拓扑残留 UI，监听和旧选择回调缺乏关闭守卫",
       "confirmation": "reproduced",
-      "status": "open",
+      "status": "resolved",
       "owners": [
         "PKG-DASH-02",
         "PKG-DASH-03"
@@ -2869,10 +2871,18 @@
         "packages/artplayer-plugin-dash-control/types/artplayer-plugin-dash-control.d.ts",
         "docs/assets/example/dash.control.js",
         "test/dash-contract.test.js",
-        "refactor/dash-validation.md"
+        "refactor/dash-validation.md",
+        "test/dash-lifecycle.test.js",
+        "refactor/baselines/dash-runtime.json"
       ],
       "compatibleResolution": "仅释放插件自有 ready/restart/destroy 订阅和 UI，SDK 仍由调用方拥有；替换后旧回调不写旧实例。",
-      "closureCriteria": "空列表、换源/SDK、销毁后引用、安装异常有回归，其他实例与 SDK 不被误释放。"
+      "closureCriteria": "空列表、换源/SDK、销毁后引用、安装异常有回归，其他实例与 SDK 不被误释放。",
+      "resolutionEvidence": [
+        "refactor/changes/2026-09-12-PKG-DASH-03-runtime.md",
+        "refactor/baselines/dash-runtime.json",
+        "packages/artplayer-plugin-dash-control/ARCHITECTURE.md"
+      ],
+      "resolutionRationale": "空拓扑/禁用/失败/销毁清理自有 UI 与订阅，旧 revision/SDK 引用无副作用；先红后绿、两代方法表及三格式 Node 生命周期、新旧核心 main/legacy 各 84 项真实 DOM 通过。只关闭插件所有权和引用缺陷，不替代实际 SDK/MPD、demo 或设备验证。"
     },
     {
       "id": "DASH-STATE-01",
@@ -2891,7 +2901,9 @@
         "packages/artplayer-plugin-dash-control/types/artplayer-plugin-dash-control.d.ts",
         "docs/assets/example/dash.control.js",
         "test/dash-contract.test.js",
-        "refactor/dash-validation.md"
+        "refactor/dash-validation.md",
+        "test/dash-lifecycle.test.js",
+        "refactor/baselines/dash-runtime.json"
       ],
       "compatibleResolution": "验证零 ID、重复标签和克隆音轨当前项，在保持原展示语义时按实际可选项定位高亮。",
       "closureCriteria": "有受控和真实 SDK 证据说明选中的 representation/track 与 UI 一致。"

refactor/tasks.json

@@ -2014,11 +2014,15 @@
         "CORE-11",
         "CORE-14"
       ],
-      "status": "todo",
+      "status": "done",
       "risk": "H",
       "deliverable": "能力适配保留 SDK 4.x 与 5.x，稳定 ID 映射、ABR 状态、UI 清理和生命周期职责分离",
       "acceptance": "结构变化和缺陷修复分开记录；原 API/事件/资源生命周期通过",
-      "evidence": []
+      "evidence": [
+        "changes/2026-09-12-PKG-DASH-03-runtime.md",
+        "baselines/dash-runtime.json",
+        "dash-validation.md"
+      ]
     },
     {
       "id": "PKG-DASH-04",