@proteus-vue/render-backend 0.1.1-beta.0 → 0.3.0-beta.7

package/dist/index.js

@@ -86,8 +86,8 @@ var SEMANTIC_HEADLESS_MAP = {
   "ui.input": "input",
   "ui.list": "list",
   "ui.nav": "nav",
-  "capability.scan-qr": "scan-qr",
-  "capability.pick-photo": "pick-photo",
+  "capability.qr-code": "scan-qr",
+  "capability.camera": "pick-photo",
   "capability.location": "location",
   // ★G-32 B1：新增 implemented 语义（与 component-ir SEMANTIC_BACKEND_MAP headless 列同源）
   "layout.inline": "inline",
@@ -126,6 +126,7 @@ var SEMANTIC_HEADLESS_MAP = {
   "engineering.router-link": "router-link",
   // ★G-32 B5 续二：工程原语动画组件形态（E19/E20）
   "engineering.transition": "transition",
+  "engineering.share-element": "share-element",
   "engineering.animate": "animate",
   // ★能力颗粒度对齐 C2
   "ui.progress": "progress",
@@ -253,8 +254,8 @@ var SEMANTIC_WEB_MAP = {
   "ui.list": { tag: "div", className: "proteus-list" },
   "ui.nav": { tag: "nav" },
   // ★G-31 B5：能力入口（G-28 组件化）——Web 端用标准元素承载，能力实现由 useNative 注入
-  "capability.scan-qr": { tag: "button", className: "proteus-scan-qr" },
-  "capability.pick-photo": { tag: "input", className: "proteus-pick-photo" },
+  "capability.qr-code": { tag: "button", className: "proteus-scan-qr" },
+  "capability.camera": { tag: "input", className: "proteus-pick-photo" },
   "capability.location": { tag: "button", className: "proteus-location" },
   // ★G-32 B1：新增 implemented 语义（与 component-ir SEMANTIC_BACKEND_MAP vue-dom 列同源）
   "layout.inline": { tag: "div", className: "proteus-inline" },
@@ -294,6 +295,8 @@ var SEMANTIC_WEB_MAP = {
   "engineering.router-link": { tag: "a", className: "proteus-router-link" },
   // ★G-32 B5 续二：工程原语动画组件形态（E19/E20——纯 CSS 声明）
   "engineering.transition": { tag: "div", className: "proteus-transition" },
+  // ★批次 8：共享元素转场（Web 无宿主共享元素 → 普通容器降级）
+  "engineering.share-element": { tag: "div", className: "proteus-share-element" },
   "engineering.animate": { tag: "div", className: "proteus-animate" },
   // ★能力颗粒度对齐 C2：进度条 / 表单标签 / 页面容器
   "ui.progress": { tag: "div", className: "proteus-progress" },
@@ -435,8 +438,8 @@ var SEMANTIC_NATIVE_MAPS = {
     "ui.input": "UITextField",
     "ui.list": "UITableView",
     "ui.nav": "UINavigationController",
-    "capability.scan-qr": "AVCaptureSession",
-    "capability.pick-photo": "UIImagePicker",
+    "capability.qr-code": "AVCaptureSession",
+    "capability.camera": "UIImagePicker",
     "capability.location": "CLLocationManager",
     // ★G-32 B1：新增 implemented 语义
     "layout.inline": "UITextAttachment",
@@ -475,6 +478,7 @@ var SEMANTIC_NATIVE_MAPS = {
     "engineering.router-link": "UIButton.link",
     // ★G-32 B5 续二：工程原语动画组件形态（E19/E20）
     "engineering.transition": "UIView.transition",
+    "engineering.share-element": "UIView.matchedTransition",
     "engineering.animate": "CAKeyframeAnimation",
     // ★能力颗粒度对齐 C2
     "ui.progress": "UIProgressView",
@@ -503,8 +507,8 @@ var SEMANTIC_NATIVE_MAPS = {
     "ui.input": "EditText",
     "ui.list": "RecyclerView",
     "ui.nav": "NavigationRail",
-    "capability.scan-qr": "CameraX",
-    "capability.pick-photo": "PhotoPicker",
+    "capability.qr-code": "CameraX",
+    "capability.camera": "PhotoPicker",
     "capability.location": "FusedLocation",
     // ★G-32 B1：新增 implemented 语义
     "layout.inline": "TextView.inline",
@@ -543,6 +547,7 @@ var SEMANTIC_NATIVE_MAPS = {
     "engineering.router-link": "TextView.link",
     // ★G-32 B5 续二：工程原语动画组件形态（E19/E20）
     "engineering.transition": "View.animate.transition",
+    "engineering.share-element": "SharedElementTransition",
     "engineering.animate": "ValueAnimator",
     // ★能力颗粒度对齐 C2
     "ui.progress": "ProgressBar",
@@ -571,8 +576,8 @@ var SEMANTIC_NATIVE_MAPS = {
     "ui.input": "TextInput",
     "ui.list": "List",
     "ui.nav": "Navigation",
-    "capability.scan-qr": "ScanKit",
-    "capability.pick-photo": "PhotoViewPicker",
+    "capability.qr-code": "ScanKit",
+    "capability.camera": "PhotoViewPicker",
     "capability.location": "geoLocationManager",
     // ★G-32 B1：新增 implemented 语义
     "layout.inline": "Span",
@@ -611,6 +616,7 @@ var SEMANTIC_NATIVE_MAPS = {
     "engineering.router-link": "Text.link",
     // ★G-32 B5 续二：工程原语动画组件形态（E19/E20）
     "engineering.transition": "animateTo.transition",
+    "engineering.share-element": "geometryTransition",
     "engineering.animate": "Animator.transition",
     // ★能力颗粒度对齐 C2
     "ui.progress": "Progress",
@@ -735,8 +741,8 @@ var SEMANTIC_FLUTTER_MAP = {
   "ui.input": "TextField",
   "ui.list": "ListView",
   "ui.nav": "Navigator",
-  "capability.scan-qr": "scanQR",
-  "capability.pick-photo": "pickPhoto",
+  "capability.qr-code": "scanQR",
+  "capability.camera": "pickPhoto",
   "capability.location": "getLocation",
   // ★G-32 B1：新增 implemented 语义
   "layout.inline": "InlineSpan",
@@ -775,6 +781,8 @@ var SEMANTIC_FLUTTER_MAP = {
   "engineering.router-link": "TextButton",
   // ★G-32 B5 续二：工程原语动画组件形态（E19/E20）
   "engineering.transition": "AnimatedOpacity",
+  "engineering.share-element": "Hero",
+  // Flutter Hero 即共享元素
   "engineering.animate": "AnimationController",
   // ★能力颗粒度对齐 C2
   "ui.progress": "LinearProgressIndicator",
@@ -1134,11 +1142,17 @@ var TAG_SEMANTIC_MAP = {
   // ★E18 组件形态（p- 前缀产 C-IR）
   "router-link": "engineering.router-link",
   // ★兼容别名（Vue Router 风格 <router-link> 标签；非 catalog 条目——p-view 先例 G-31 B4）
+  "p-share-element": "engineering.share-element",
+  // ★批次 8：页面间共享元素转场（≠ p-transition 页内过渡）
   "p-transition": "engineering.transition",
   "p-animate": "engineering.animate",
   // G-31 能力入口
-  "p-scan-qr": "capability.scan-qr",
-  "p-pick-photo": "capability.pick-photo",
+  // ★2026-09-18 语义去重：原 capability.scan-qr / capability.pick-photo 是**重复名**——
+  //   两个组件的实现分别调用 useQRCode() / useCamera()，对应真实能力即 C42 capability.qr-code /
+  //   C1 capability.camera（其 mpEquiv 与 hook 完全一致）。故**退役重复名、重指向真实能力**，
+  //   并按 E8 双形态在两行补 tag（而非新建语义）。
+  "p-scan-qr": "capability.qr-code",
+  "p-pick-photo": "capability.camera",
   "p-location": "capability.location",
   // ★G-31 B4 现有组件对齐（src/components 实际标签 → L1 语义）
   "p-view": "layout.box",
@@ -1149,7 +1163,9 @@ var TAG_SEMANTIC_MAP = {
   "p-safe": "layout.safe",
   "p-sidebar": "layout.sidebar",
   // ★#405 语义登记批：剩余 10 组件全量入图（EXTRA_KIND 文档兑底退役）——
-  //   9 个新语义（catalog planned L2：语义层待多端映射）+ p-scroll-view 复用 layout.scroll（p-view 先例）
+  //   9 个新语义（catalog planned L2：语义层待多端映射）+ p-scroll-view 复用 layout.scroll
+  //   （★2026-09-18 修正原文「p-view 先例」：显式 multi-tag 别名先例是上一行的 `router-link`
+  //    ——同一语义由两个标签提供；本条与 p-view 是并列的别名情形，非「先例」关系）
   "p-aspect": "layout.aspect",
   "p-zone": "layout.zone",
   "p-loading": "ui.loading",
@@ -1202,17 +1218,20 @@ var LAYOUT = [
   { id: "L12", kind: "layout", semantic: "layout.masonry", tag: "p-masonry", props: ["colCount", "gap"], mpEquiv: "\u7B2C\u4E09\u65B9\u7011\u5E03\u6D41", tier: "L1", status: "implemented" },
   // ★#405 语义登记批：Fluid 体系剩余组件（语义层待多端映射 → planned L2——G-31.4 不足 3 端降级）
   { id: "L13", kind: "layout", semantic: "layout.aspect", tag: "p-aspect", props: ["ratio", "maxWidth"], mpEquiv: "\u65E0\uFF08\u7EB5\u6A2A\u6BD4\u5BB9\u5668\uFF09", tier: "L2", status: "planned" },
-  { id: "L14", kind: "layout", semantic: "layout.zone", tag: "p-zone", props: ["designWidth"], mpEquiv: "\u65E0\uFF08\u5BB9\u5668\u65AD\u70B9\u5206\u533A\uFF09", tier: "L2", status: "planned" }
+  { id: "L14", kind: "layout", semantic: "layout.zone", tag: "p-zone", props: ["designWidth"], mpEquiv: "\u65E0\uFF08\u5BB9\u5668\u65AD\u70B9\u5206\u533A\uFF09", tier: "L2", status: "planned" },
+  // ★批次 7（2026-09-18）未登记组件补登记：安全区（刘海/折叠屏/降级）+ 侧边导航容器
+  { id: "L15", kind: "layout", semantic: "layout.safe", tag: "p-safe", props: ["area", "fold", "fallback"], mpEquiv: "\u65E0\uFF08\u5B89\u5168\u533A\u8BED\u4E49\u5BB9\u5668\uFF09", tier: "L1", status: "implemented" },
+  { id: "L16", kind: "layout", semantic: "layout.sidebar", tag: "p-sidebar", props: ["minSidebarWidth", "navWidth", "designWidth", "toggleLabel"], mpEquiv: "\u65E0\uFF08\u5BB9\u5668\u65AD\u70B9\u4FA7\u680F\uFF09", tier: "L1", status: "implemented" }
 ];
 var UI = [
   { id: "U1", kind: "ui", semantic: "ui.text", tag: "p-text", props: ["content", "selectable", "truncate", "align", "userSelect", "overflow", "maxLines", "selectOnGesture", "space", "decode"], mpEquiv: "<text>", tier: "L1", status: "implemented" },
   { id: "U2", kind: "ui", semantic: "ui.heading", tag: "p-heading", props: ["level"], mpEquiv: "<h1>-<h6>", tier: "L1", status: "implemented" },
-  { id: "U3", kind: "ui", semantic: "ui.rich-text", tag: "p-rich-text", props: ["source", "schema"], mpEquiv: "<rich-text>", tier: "L1", status: "implemented" },
+  { id: "U3", kind: "ui", semantic: "ui.rich-text", tag: "p-rich-text", props: ["nodes", "space", "userSelect", "mode", "source"], mpEquiv: "<rich-text>", tier: "L1", status: "implemented" },
   { id: "U4", kind: "ui", semantic: "ui.icon", tag: "p-icon", props: ["name", "type", "size", "color", "spin"], mpEquiv: "<icon>", tier: "L1", status: "implemented" },
   { id: "U5", kind: "ui", semantic: "ui.image", tag: "p-image", props: ["src", "fit", "placeholder", "lazy", "showMenuByLongpress", "fadeIn", "preload", "webp", "referrerPolicy"], mpEquiv: "<image>", tier: "L1", status: "implemented" },
   { id: "U6", kind: "ui", semantic: "ui.avatar", tag: "p-avatar", props: ["src", "shape", "size", "fallback"], mpEquiv: "\u7EC4\u5408", tier: "L1", status: "implemented" },
-  { id: "U7", kind: "ui", semantic: "ui.media", tag: "p-media", props: ["kind", "controls", "autoplay", "poster", "loop", "muted", "pictureInPicture"], mpEquiv: "<video>+<audio>", tier: "L1", status: "implemented" },
-  { id: "U8", kind: "ui", semantic: "ui.canvas", tag: "p-canvas", props: ["engine", "resolution"], mpEquiv: "<canvas>", tier: "L1", status: "implemented" },
+  { id: "U7", kind: "ui", semantic: "ui.media", tag: "p-media", props: ["kind", "src", "duration", "controls", "autoplay", "loop", "muted", "initialTime", "poster", "objectFit", "title", "playBtnPosition", "direction", "showProgress", "showFullscreenBtn", "showPlayBtn", "showCenterPlayBtn", "showMuteBtn", "showBottomProgress", "enableProgressGesture", "enablePlayGesture", "pageGesture", "vslideGesture", "vslideGestureInFullscreen", "autoPauseIfNavigate", "autoPauseIfOpenNative", "danmuList", "danmuBtn", "enableDanmu", "pictureInPicture"], mpEquiv: "<video>+<audio>", tier: "L1", status: "implemented" },
+  { id: "U8", kind: "ui", semantic: "ui.canvas", tag: "p-canvas", props: ["engine", "canvasId", "disableScroll", "resolution"], mpEquiv: "<canvas>", tier: "L1", status: "implemented" },
   { id: "U9", kind: "ui", semantic: "ui.svg", tag: "p-svg", props: ["path", "viewbox"], mpEquiv: "\u65E0", tier: "L1", status: "implemented" },
   { id: "U10", kind: "ui", semantic: "ui.input", tag: "p-input", props: ["type", "mask", "validation", "clearable"], mpEquiv: "<input>", tier: "L1", status: "implemented" },
   { id: "U11", kind: "ui", semantic: "ui.textarea", tag: "p-textarea", props: ["autosize", "maxLength", "count"], mpEquiv: "<textarea>", tier: "L1", status: "implemented" },
@@ -1233,9 +1252,16 @@ var UI = [
   // ★权威标尺批 H：局部文本选区
   { id: "U24", kind: "ui", semantic: "ui.selection", tag: "p-selection", props: ["disableContextMenu", "selectable"], mpEquiv: "<selection>", tier: "L1", status: "implemented" },
   // ★权威标尺批 I：相机
-  { id: "U25", kind: "ui", semantic: "ui.camera", tag: "p-camera", props: ["devicePosition", "flash", "aspectRatio"], mpEquiv: "<camera>", tier: "L1", status: "implemented" },
+  { id: "U25", kind: "ui", semantic: "ui.camera", tag: "p-camera", props: ["mode", "resolution", "devicePosition", "flash", "frameSize", "aspectRatio"], mpEquiv: "<camera>", tier: "L1", status: "implemented" },
   // ★权威标尺批 J：地图
-  { id: "U26", kind: "ui", semantic: "ui.map", tag: "p-map", props: ["latitude", "longitude", "scale", "markers"], mpEquiv: "<map>", tier: "L1", status: "implemented" }
+  { id: "U26", kind: "ui", semantic: "ui.map", tag: "p-map", props: ["latitude", "longitude", "scale", "minScale", "maxScale", "markers", "polyline", "circles", "polygons", "includePoints", "showLocation", "layerStyle", "rotate", "skew", "showCompass", "showScale", "enableZoom", "enableScroll", "enableRotate", "enableSatellite", "enableTraffic", "enablePoi", "enableBuilding", "enableOverlooking", "setting"], mpEquiv: "<map>", tier: "L1", status: "implemented" },
+  // ★批次 7（2026-09-18）未登记组件补登记：这 3 个组件此前**只存在于 TAG_SEMANTIC_MAP**（编译器能解析、
+  //   组件能渲染），但不在 SSOT catalog → C1 不变量（catalog tag ↔ TAG_SEMANTIC_MAP 双向）单向成立、
+  //   catalog 查询类 API（primitiveByTag / componentPrimitives）查不到它们。
+  //   ★p-button 尤其反讽：它是**端对齐全流程的参考实现**（21/21、SOP v2 范式），却不在语义清单里。
+  { id: "U27", kind: "ui", semantic: "ui.button", tag: "p-button", props: ["disabled", "loading", "throttle", "size", "type", "plain", "formType", "openType", "hoverClass", "theme", "hoverStopPropagation", "hoverStartTime", "hoverStayTime", "lang", "sessionFrom", "sendMessageTitle", "sendMessagePath", "sendMessageImg", "appParameter", "showMessageCard", "phoneNumberNoQuotaToast", "needShowEntrance", "entrancePath"], mpEquiv: "<button>", tier: "L1", status: "implemented" },
+  { id: "U28", kind: "ui", semantic: "ui.list", tag: "p-list-view", props: ["items", "itemHeight", "height", "bufferSize", "virtual", "lazy", "padding"], mpEquiv: "<list-view>\uFF08\u865A\u62DF\u6EDA\u52A8\uFF09", tier: "L1", status: "implemented" },
+  { id: "U29", kind: "ui", semantic: "ui.nav", tag: "p-nav-bar", props: ["title", "back", "fixed", "loading", "frontColor", "backgroundColor", "colorAnimationDuration", "colorAnimationTimingFunc"], mpEquiv: "<navigation-bar>\uFF08\u81EA\u7ED8\uFF09", tier: "L1", status: "implemented" }
 ];
 var SHELL = [
   { id: "S1", kind: "shell", semantic: "shell.page", tag: "p-page", props: ["title", "statusBar", "pullRefresh"], mpEquiv: "<page>", tier: "L1", status: "implemented" },
@@ -1259,17 +1285,21 @@ var SHELL = [
   { id: "S15", kind: "shell", semantic: "shell.keyboard-accessory", tag: "p-keyboard-accessory", props: ["visible", "maxHeight", "background"], mpEquiv: "<keyboard-accessory>", tier: "L1", status: "implemented" },
   // ★权威标尺批 J：内嵌网页 / 广告位
   { id: "S16", kind: "shell", semantic: "shell.webview", tag: "p-webview", props: ["src", "height", "sandbox"], mpEquiv: "<web-view>", tier: "L1", status: "implemented" },
-  { id: "S17", kind: "shell", semantic: "shell.ad", tag: "p-ad", props: ["unitId", "adIntervals", "adType", "height"], mpEquiv: "<ad>", tier: "L1", status: "implemented" }
+  { id: "S17", kind: "shell", semantic: "shell.ad", tag: "p-ad", props: ["unitId", "adIntervals", "adType", "adTheme", "height"], mpEquiv: "<ad>", tier: "L1", status: "implemented" }
 ];
 var GESTURE = [
-  { id: "G1", kind: "gesture", semantic: "gesture.tap", api: "v-gesture:tap", props: ["count"], mpEquiv: "bindtap", tier: "L1", status: "planned" },
-  { id: "G2", kind: "gesture", semantic: "gesture.longpress", api: "v-gesture:longpress", props: ["duration", "onEnd"], mpEquiv: "bindlongpress", tier: "L1", status: "planned" },
-  { id: "G3", kind: "gesture", semantic: "gesture.swipe", api: "v-gesture:swipe", props: ["direction", "threshold"], mpEquiv: "bindswipe", tier: "L1", status: "planned" },
-  { id: "G4", kind: "gesture", semantic: "gesture.pan", api: "v-gesture:pan", props: ["axis", "bounds"], mpEquiv: "bindtouchmove", tier: "L1", status: "planned" },
-  { id: "G5", kind: "gesture", semantic: "gesture.pinch", api: "v-gesture:pinch", props: ["scale", "onChange"], mpEquiv: "touchstart/move \u7EC4\u5408", tier: "L1", status: "planned" },
-  { id: "G6", kind: "gesture", semantic: "gesture.rotate", api: "v-gesture:rotate", props: ["angle"], mpEquiv: "\u7EC4\u5408", tier: "L1", status: "planned" },
-  { id: "G7", kind: "gesture", semantic: "gesture.press", api: "v-gesture:press", props: ["force"], mpEquiv: "3D Touch", tier: "L1", status: "planned" },
-  { id: "G8", kind: "gesture", semantic: "gesture.draggable", tag: "p-draggable", props: ["ghost", "snapToGrid", "onDrop"], mpEquiv: "movable-view", tier: "L1", status: "implemented" },
+  // ★2026-09-18：G1/G2 由 planned → implemented——`v-gesture:tap|longpress` 已双端落地
+  //   （编译器新增 `directive/v-gesture` 规则：MP 映射 bindtap/bindlongpress；Web 走 Pointer 识别器）。
+  //   ★G3–G7 **保持 planned**：MP 端无事件对等（官方用 worklet 手势处理器<组件>，框架未生成），
+  //   mpEquiv 已改为**如实描述**（原值 bindswipe/bindtouchmove/组合/3D Touch 多为不准确表述）。
+  { id: "G1", kind: "gesture", semantic: "gesture.tap", api: "v-gesture:tap", props: ["count"], mpEquiv: "bindtap\uFF08\u539F\u751F\u4E8B\u4EF6\u2014\u2014\u7F16\u8BD1\u5668\u76F4\u6620\u5C04\uFF09", tier: "L1", status: "implemented" },
+  { id: "G2", kind: "gesture", semantic: "gesture.longpress", api: "v-gesture:longpress", props: ["duration", "onEnd"], mpEquiv: "bindlongpress\uFF08\u539F\u751F\u4E8B\u4EF6\u2014\u2014\u7F16\u8BD1\u5668\u76F4\u6620\u5C04\uFF09", tier: "L1", status: "implemented" },
+  { id: "G3", kind: "gesture", semantic: "gesture.swipe", api: "v-gesture:swipe", props: ["direction", "threshold"], mpEquiv: "\u65E0\u539F\u751F\u4E8B\u4EF6\u2014\u2014\u9700 @touchstart/@touchend \u81EA\u884C\u5224\u5B9A\u65B9\u5411", tier: "L1", status: "planned" },
+  { id: "G4", kind: "gesture", semantic: "gesture.pan", api: "v-gesture:pan", props: ["axis", "bounds"], mpEquiv: "\u65E0\u539F\u751F\u4E8B\u4EF6\u2014\u2014\u5B98\u65B9 <pan-gesture-handler>\uFF08worklet\uFF09\u6216 touch \u65CF\u81EA\u884C\u5224\u5B9A", tier: "L1", status: "planned" },
+  { id: "G5", kind: "gesture", semantic: "gesture.pinch", api: "v-gesture:pinch", props: ["scale", "onChange"], mpEquiv: "\u65E0\u539F\u751F\u4E8B\u4EF6\u2014\u2014\u5B98\u65B9 <scale-gesture-handler>\uFF08worklet\uFF09", tier: "L1", status: "planned" },
+  { id: "G6", kind: "gesture", semantic: "gesture.rotate", api: "v-gesture:rotate", props: ["angle"], mpEquiv: "\u65E0\u539F\u751F\u4E8B\u4EF6\uFF08MP \u65E0 rotate \u624B\u52BF\u5904\u7406\u5668\uFF09", tier: "L1", status: "planned" },
+  { id: "G7", kind: "gesture", semantic: "gesture.press", api: "v-gesture:press", props: ["force"], mpEquiv: "\u65E0\u539F\u751F\u4E8B\u4EF6\u2014\u2014\u5B98\u65B9 <force-press-gesture-handler>\uFF08worklet\uFF0C\u9700 3D Touch \u8BBE\u5907\uFF09", tier: "L1", status: "planned" },
+  { id: "G8", kind: "gesture", semantic: "gesture.draggable", tag: "p-draggable", props: ["direction", "inertia", "outOfBounds", "x", "y", "damping", "friction", "disabled", "scaleEnabled", "scaleMin", "scaleMax", "scaleValue", "animation", "scaleArea", "ghost", "snapToGrid", "onDrop"], mpEquiv: "movable-view", tier: "L1", status: "implemented" },
   { id: "G9", kind: "gesture", semantic: "gesture.scrollable", tag: "p-scrollable", props: ["bounce", "refresh", "loadMore"], mpEquiv: "<scroll-view>", tier: "L1", status: "implemented" },
   { id: "G10", kind: "gesture", semantic: "gesture.use-gesture", api: "useGesture()", props: ["recognizers", "simultaneous"], mpEquiv: "\u65E0", tier: "L1", status: "planned" }
 ];
@@ -1278,9 +1308,10 @@ function cap(id, name, api, mpEquiv, returnType) {
 }
 var CAPABILITY = [
   // 7.1 设备/硬件（15）
-  cap("C1", "camera", "useCamera()", "wx.createCameraContext", "Result<Media>"),
+  // ★2026-09-18 双形态（E8 先例）：能力入口组件 p-pick-photo 即 useCamera() 的声明式入口
+  { id: "C1", kind: "capability", semantic: "capability.camera", api: "useCamera()", tag: "p-pick-photo", props: ["Result<Media>"], mpEquiv: "wx.createCameraContext", tier: "L1", status: "implemented" },
   cap("C2", "microphone", "useMicrophone()", "RecorderManager", "Result<AudioBuffer>"),
-  { id: "C3", kind: "capability", semantic: "capability.location", api: "useLocation()", props: ["Result<Coords>"], mpEquiv: "wx.getLocation", tier: "L1", status: "implemented" },
+  { id: "C3", kind: "capability", semantic: "capability.location", api: "useLocation()", tag: "p-location", props: ["Result<Coords>"], mpEquiv: "wx.getLocation", tier: "L1", status: "implemented" },
   cap("C4", "map", "useMap()", "wx.createMapContext", "MapController"),
   cap("C5", "sensor", "useSensor()", "onAccelerometer/onCompass/onGyroscope", "SensorStream"),
   cap("C6", "vibrate", "useVibrate()", "wx.vibrateShort/Long", "void"),
@@ -1322,7 +1353,8 @@ var CAPABILITY = [
   cap("C39", "face-id", "useFaceID()", "\u7EC4\u5408", "Result<boolean>"),
   cap("C40", "payment", "usePayment()", "wx.requestPayment", "Result<PayResult>"),
   cap("C41", "login", "useLogin()", "wx.login", "Result<Token>"),
-  cap("C42", "qr-code", "useQRCode()", "wx.scanCode + canvas", "Result<string>"),
+  // ★2026-09-18 双形态（E8 先例）：能力入口组件 p-scan-qr 即 useQRCode() 的声明式入口
+  { id: "C42", kind: "capability", semantic: "capability.qr-code", api: "useQRCode()", tag: "p-scan-qr", props: ["Result<string>"], mpEquiv: "wx.scanCode + canvas", tier: "L1", status: "implemented" },
   cap("C43", "file-system", "useFileSystem()", "wx.getFileSystemManager", "FSAdapter"),
   cap("C44", "archive", "useArchive()", "wx.compressFile", "Result<void>"),
   cap("C45", "shortcut", "useShortcut()", "wx.addToDesktop", "Result<void>"),
@@ -1404,7 +1436,18 @@ var ENGINEERING = [
   { id: "E25", kind: "engineering", semantic: "engineering.inspector", api: "useInspector()", mpEquiv: "\u65E0", tier: "L1", status: "planned" },
   { id: "E26", kind: "engineering", semantic: "engineering.performance", api: "usePerformance()", mpEquiv: "wx.reportPerformance", tier: "L1", status: "planned" },
   { id: "E27", kind: "engineering", semantic: "engineering.define-component", api: "defineComponent()", mpEquiv: "Component()", tier: "L1", status: "planned" },
-  { id: "E28", kind: "engineering", semantic: "engineering.define-capability", api: "defineCapability()", mpEquiv: "\u65E0", tier: "L1", status: "planned" }
+  { id: "E28", kind: "engineering", semantic: "engineering.define-capability", api: "defineCapability()", mpEquiv: "\u65E0", tier: "L1", status: "planned" },
+  // ★批次 8（2026-09-18）：共享元素转场（官方 <share-element> 对齐）——能力由宿主提供，框架只声明语义
+  { id: "E29", kind: "engineering", semantic: "engineering.share-element", tag: "p-share-element", props: ["shuttleKey", "animate", "duration", "easingFunction", "transitionOnGesture", "shuttleOnPush", "shuttleOnPop", "rectTweenType"], mpEquiv: "<share-element>\uFF08\u5BBF\u4E3B\u8DE8\u9875\u98DE\u884C\u52A8\u753B\uFF09", tier: "L1", status: "implemented" },
+  // ★E30（2026-09-19）：WebMCP 接入——把**能力面**暴露为浏览器内 agent 可调用工具。
+  //   规范面：`document.modelContext.registerTool(...)`（★非 navigator）+ signal 注销（规范无 unregisterTool）；
+  //   灵感来自 VueUse v15 `useWebMCP`（document 命名空间 / signal 注销 / 方法可调用探测 / 三元组返回）。
+  //   框架差异化：能力面统一 `CapResult<T>` 契约（G-32.4）→ 能力可**自动**派生为工具、响应归一不必逐个手写。
+  //   ★状态口径（与 E1-E28 / C15 / C26 等同款，非本轮新引入）：hook 形态原语无**渲染后端映射**，
+  //   故按 catalog 既有约定记 `planned`——该字段反映「已在 SEMANTIC_BACKEND_MAP 登记 ≥3 端」，
+  //   不等于「代码未实现」（本原语已实现于 `packages/api/src/mcp.ts`）。
+  //   `mpEquiv: 无`：WebMCP 是浏览器侧 agent 通道，小程序无 `document.modelContext` → 如实降级（isSupported=false）。
+  { id: "E30", kind: "engineering", semantic: "engineering.mcp", api: "useMCP()", props: ["tools", "capabilities", "prefix"], mpEquiv: "\u65E0\uFF08\u6D4F\u89C8\u5668\u4FA7 agent \u901A\u9053\uFF1BMP \u7AEF isSupported=false \u8BDA\u5B9E\u964D\u7EA7\uFF09", tier: "L1", status: "planned" }
 ];
 var PRIMITIVE_CATALOG = [...LAYOUT, ...UI, ...SHELL, ...GESTURE, ...CAPABILITY, ...ENGINEERING];
 
@@ -1447,7 +1490,7 @@ var MP_COMPONENTS = [
   { mp: "<ad>", proteus: "shell.ad\uFF08p-ad\uFF09", status: "ok", group: "component" },
   { mp: "<official-account>", proteus: "useMiniProgram\uFF08\u5FAE\u4FE1\u79C1\u6709\uFF09", status: "private", group: "component" },
   { mp: "<open-data>", proteus: "useMiniProgram\uFF08\u5FAE\u4FE1\u79C1\u6709\uFF09", status: "private", group: "component" },
-  { mp: "<share-element>", proteus: "p-share-element\uFF08L2 \u89C4\u5212\uFF09", status: "compat", group: "component", planned: true },
+  { mp: "<share-element>", proteus: "engineering.share-element\uFF08p-share-element\uFF09", status: "ok", group: "component" },
   { mp: "<aria-component>", proteus: "aria-* \u5C5E\u6027\uFF08\u5404\u7EC4\u4EF6 ariaLabel\uFF1B\u4E24\u7AEF\u539F\u751F\u652F\u6301\uFF09", status: "ok", group: "component" },
   { mp: "<page-container>", proteus: "shell.page-container", status: "ok", group: "component" },
   { mp: "<voip-room>", proteus: "useMiniProgram\uFF08\u5FAE\u4FE1 VOIP\uFF09", status: "private", group: "component" },
@@ -1533,6 +1576,110 @@ var MP_API_GROUPS = [
 ];
 var MP_MAPPING_MATRIX = [...MP_COMPONENTS, ...MP_API_GROUPS];
 
+// ../component-ir/src/degradation.ts
+var PRIVATE_WEB_FALLBACK = {
+  openType: "Web \u89E6\u53D1\u540C\u540D\u4E8B\u4EF6\uFF08\u5982 @contact\uFF09+ console \u63D0\u793A\u81EA\u5B9A\u4E49\u5BF9\u5E94\u4EA4\u4E92\uFF08\u53C2\u8003 Web p-button open-type\uFF09",
+  appId: "Web \u65E0\u8DE8\u5E94\u7528\u8DF3\u8F6C\u80FD\u529B\uFF0C\u4EC5\u56DE\u663E\u53C2\u6570\u5E76\u63D0\u793A",
+  shortLink: "Web \u65E0\u77ED\u94FE\u8DF3\u8F6C\u80FD\u529B\uFF0C\u4EC5\u56DE\u663E\u53C2\u6570\u5E76\u63D0\u793A",
+  unitId: "Web \u65E0\u5BBF\u4E3B\u5E7F\u544A\u4F4D\uFF0C\u6E32\u67D3\u5360\u4F4D\u5E76\u63D0\u793A\uFF08\u4E0D\u9759\u9ED8\uFF09",
+  adType: "Web \u65E0\u5BBF\u4E3B\u5E7F\u544A\u7C7B\u578B\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  adTheme: "Web \u65E0\u5BBF\u4E3B\u5E7F\u544A\u4E3B\u9898\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  adIntervals: "Web \u65E0\u5BBF\u4E3B\u5E7F\u544A\u81EA\u52A8\u5237\u65B0\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A"
+};
+var STYLE_WEB_FALLBACK = {
+  hoverClass: "\u6620\u5C04 CSS :active/:hover \u7C7B\uFF08\u6846\u67B6\u9ED8\u8BA4\u7C7B\u6052\u5728\uFF0C\u81EA\u5B9A\u4E49\u7C7B\u4F5C\u9644\u52A0\u2014\u2014T3\uFF09",
+  hoverStartTime: "Web \u7528 CSS transition-delay \u8FD1\u4F3C\u6309\u538B\u8D77\u59CB\u5EF6\u65F6",
+  hoverStayTime: "Web \u7528 CSS transition-duration \u8FD1\u4F3C\u6309\u538B\u505C\u7559\u65F6\u957F",
+  hoverStopPropagation: "Web \u7528 CSS pointer-events \u963B\u65AD\u5B50\u7EA7\u53CD\u9988\u8FD1\u4F3C"
+};
+var MP_HOST_WEB_FALLBACK = {
+  alwaysEmbed: "Web \u65E0\u540C\u5C42/\u975E\u540C\u5C42\u5207\u6362\u6982\u5FF5\uFF08input \u59CB\u7EC8\u5728\u6587\u6863\u6D41\uFF09\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  confirmHold: "Web \u65E0\u6CD5\u63A7\u5236\u8F6F\u952E\u76D8\u6536\u8D77\u65F6\u673A\uFF08\u7531\u6D4F\u89C8\u5668/\u7CFB\u7EDF\u51B3\u5B9A\uFF09\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  adjustPosition: "Web \u7531\u6D4F\u89C8\u5668\u81EA\u8EAB\u5904\u7406\u952E\u76D8\u5F39\u8D77\u65F6\u7684\u89C6\u53E3\u6EDA\u52A8\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  holdKeyboard: "Web \u65E0\u6CD5\u5728\u5931\u7126\u70B9\u51FB\u65F6\u4FDD\u6301\u952E\u76D8\uFF08\u6D4F\u89C8\u5668\u884C\u4E3A\uFF09\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  cursorColor: "Web \u8FD1\u4F3C\uFF1ACSS caret-color\uFF08\u5F53\u524D\u672A\u63A5\u7EBF\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A\uFF09",
+  selectionStart: "Web \u8FD1\u4F3C\uFF1AsetSelectionRange\uFF08\u5F53\u524D\u672A\u63A5\u7EBF\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A\uFF09",
+  selectionEnd: "Web \u8FD1\u4F3C\uFF1AsetSelectionRange\uFF08\u5F53\u524D\u672A\u63A5\u7EBF\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A\uFF09",
+  placeholderClass: "Web \u65E0\u300C\u5360\u4F4D\u7B26\u4E13\u7528\u7C7B\u540D\u300D\u901A\u9053\uFF08::placeholder \u4E0D\u53EF\u627F\u63A5\u4EFB\u610F\u7C7B\uFF09\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  safePasswordCertPath: "Web \u65E0\u5C0F\u7A0B\u5E8F\u5B89\u5168\u952E\u76D8\uFF08\u5BBF\u4E3B\u7EA7\u52A0\u5BC6\u952E\u76D8\uFF09\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  safePasswordLength: "Web \u65E0\u5C0F\u7A0B\u5E8F\u5B89\u5168\u952E\u76D8\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  safePasswordTimeStamp: "Web \u65E0\u5C0F\u7A0B\u5E8F\u5B89\u5168\u952E\u76D8\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  safePasswordNonce: "Web \u65E0\u5C0F\u7A0B\u5E8F\u5B89\u5168\u952E\u76D8\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  safePasswordSalt: "Web \u65E0\u5C0F\u7A0B\u5E8F\u5B89\u5168\u952E\u76D8\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  safePasswordCustomHash: "Web \u65E0\u5C0F\u7A0B\u5E8F\u5B89\u5168\u952E\u76D8\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A",
+  reportSubmit: "formId \u662F\u5C0F\u7A0B\u5E8F\u6A21\u677F\u6D88\u606F\u5BBF\u4E3B\u80FD\u529B\uFF0CWeb \u65E0\u5BF9\u5E94 \u2192 \u5FFD\u7565\u5E76\u63D0\u793A",
+  reportSubmitTimeout: "formId \u662F\u5C0F\u7A0B\u5E8F\u6A21\u677F\u6D88\u606F\u5BBF\u4E3B\u80FD\u529B\uFF0CWeb \u65E0\u5BF9\u5E94 \u2192 \u5FFD\u7565\u5E76\u63D0\u793A"
+};
+var HOST_TAGS = {
+  "p-map": "Web \u6A21\u62DF\u5C42\u6E32\u67D3\u9759\u6001\u5360\u4F4D\u5BB9\u5668\uFF0C\u5FFD\u7565\u8BE5\u5730\u56FE\u663E\u793A\u53C2\u6570\u5E76\u63D0\u793A",
+  "p-media": "Web \u7528\u539F\u751F <video>\uFF0C\u5FFD\u7565\u8BE5\u64AD\u653E\u5668\u5916\u89C2/\u4E13\u6709\u53C2\u6570\u5E76\u63D0\u793A",
+  "p-camera": "Web \u65E0\u6444\u50CF\u5934\u5BBF\u4E3B\uFF0C\u5FFD\u7565\u8BE5\u91C7\u96C6\u53C2\u6570\u5E76\u63D0\u793A\uFF08\u53EF\u9000\u5316 getUserMedia \u65F6\u53E6\u884C\u5B9E\u73B0\uFF09",
+  "p-ad": "Web \u65E0\u5BBF\u4E3B\u5E7F\u544A\uFF0C\u5FFD\u7565\u8BE5\u5E7F\u544A\u53C2\u6570\u5E76\u63D0\u793A",
+  "p-canvas": "Web \u7528 HTMLCanvasElement\uFF0C\u5FFD\u7565\u8BE5\u5C0F\u7A0B\u5E8F\u6E32\u67D3\u4E0A\u4E0B\u6587\u4E13\u6709\u53C2\u6570\u5E76\u63D0\u793A",
+  "p-webview": "Web \u7528 <iframe>\uFF0C\u5FFD\u7565\u8BE5\u5C0F\u7A0B\u5E8F web-view \u4E13\u6709\u53C2\u6570\u5E76\u63D0\u793A"
+};
+var WEB_EXTENSION_MP_FALLBACK = {
+  density: "\u5C0F\u7A0B\u5E8F\u65E0 DPI \u5BC6\u5EA6\u6982\u5FF5\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A\uFF08rpx \u5DF2\u6309\u8BBE\u8BA1\u7A3F\u5BBD\u5EA6\u6362\u7B97\uFF09",
+  designWidth: "\u5C0F\u7A0B\u5E8F\u7528 rpx \u57FA\u51C6\uFF08750\uFF09\uFF0C\u8BE5 Web \u4E13\u7528\u57FA\u51C6\u5FFD\u7565\u5E76\u63D0\u793A",
+  searchable: "\u5C0F\u7A0B\u5E8F\u65E0\u5185\u5EFA\u641C\u7D22\u8BED\u4E49\uFF0C\u5FFD\u7565\u5E76\u63D0\u793A\uFF08\u7531\u4E1A\u52A1\u4FA7\u81EA\u7ED8\uFF09"
+};
+var TAG_PROP_MP_FALLBACK = {
+  "p-stack": {
+    snap: "\u5C0F\u7A0B\u5E8F view \u4E0D\u6EDA\u52A8\uFF08Skyline \u65E0 CSS overflow \u6EDA\u52A8\uFF0CS14 \u5B9E\u6D4B\uFF09\u2192 \u5438\u9644\u65E0\u8F7D\u4F53\uFF0C\u964D\u7EA7\u4E3A\u666E\u901A\u6392\u5217 + \u53EF\u89C2\u5BDF\u63D0\u793A\uFF1B\u9700\u7FFB\u9875\u8BF7\u7528 p-scroll-view \u7684 paging-enabled",
+    loop: "\u56DE\u73AF\u4F9D\u8D56\u5438\u9644\u5BB9\u5668\uFF0C\u800C\u5C0F\u7A0B\u5E8F view \u4E0D\u6EDA\u52A8\uFF08S14\uFF09\u2192 \u4E00\u5E76\u964D\u7EA7\u4E3A\u666E\u901A\u6392\u5217 + \u53EF\u89C2\u5BDF\u63D0\u793A"
+  }
+};
+var RULE_REGISTERED_PROPS = [
+  ...Object.keys(PRIVATE_WEB_FALLBACK),
+  ...Object.keys(STYLE_WEB_FALLBACK),
+  ...Object.keys(WEB_EXTENSION_MP_FALLBACK),
+  ...Object.keys(MP_HOST_WEB_FALLBACK),
+  ...Object.values(TAG_PROP_MP_FALLBACK).flatMap((m) => Object.keys(m))
+];
+var HOST_FALLBACK_TAGS = Object.keys(HOST_TAGS);
+function degradeProp(tag, prop) {
+  const style = STYLE_WEB_FALLBACK[prop];
+  if (style) return { mp: "supported", web: "fallback", behavior: style };
+  const priv = PRIVATE_WEB_FALLBACK[prop];
+  if (priv) return { mp: "supported", web: "fallback", behavior: priv };
+  const mpHost = MP_HOST_WEB_FALLBACK[prop];
+  if (mpHost) return { mp: "supported", web: "fallback", behavior: mpHost };
+  if (tag && HOST_TAGS[tag]) {
+    return { mp: "supported", web: "fallback", behavior: HOST_TAGS[tag] };
+  }
+  const tagProp = tag ? TAG_PROP_MP_FALLBACK[tag] : void 0;
+  const tagPropBehavior = tagProp ? tagProp[prop] : void 0;
+  if (tagPropBehavior) return { mp: "fallback", web: "supported", behavior: tagPropBehavior };
+  const webExt = WEB_EXTENSION_MP_FALLBACK[prop];
+  if (webExt) return { mp: "fallback", web: "supported", behavior: webExt };
+  return { mp: "supported", web: "supported" };
+}
+function degradationOf(prim) {
+  const out = {};
+  for (const p of prim.props ?? []) out[p] = degradeProp(prim.tag, p);
+  return out;
+}
+var DEGRADATION_TABLE = (() => {
+  const out = {};
+  for (const prim of PRIMITIVE_CATALOG) {
+    if (!prim.tag) continue;
+    out[prim.tag] = degradationOf(prim);
+  }
+  return out;
+})();
+var MP_UNSUPPORTED_PROPS = (() => {
+  const kebab = (s) => s.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+  const out = {};
+  for (const [tag, table] of Object.entries(DEGRADATION_TABLE)) {
+    const set = /* @__PURE__ */ new Set();
+    for (const [prop, entry] of Object.entries(table)) {
+      if (entry.mp === "unsupported") set.add(kebab(prop));
+    }
+    if (set.size) out[tag] = set;
+  }
+  return out;
+})();
+
 // src/dispatcher.ts
 var DispatcherError = class extends Error {
   constructor(code, detail) {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@proteus-vue/render-backend",
-  "version": "0.1.1-beta.0",
+  "version": "0.3.0-beta.7",
   "description": "G-27 ProteusRenderBackend SPI：可插拔渲染后端接口 + conformance test + 官方后端原型（Headless/VueDom） + G-41 nodeOps Dispatcher——Render anywhere, on any engine（M1.4）",
   "type": "module",
   "license": "Apache-2.0",
   "dependencies": {
-    "@proteus-vue/component-ir": "0.1.1-beta.0",
-    "@proteus-vue/contracts": "0.1.0"
+    "@proteus-vue/component-ir": "0.3.0-beta.7",
+    "@proteus-vue/contracts": "0.3.0-beta.7"
   },
   "peerDependencies": {
     "@vue/runtime-core": "^3.4.0"

package/LICENSE

@@ -1,218 +0,0 @@
-Proteus（普罗透斯）Vue 跨端编译框架
-Copyright (c) 2026 Proteus Contributors
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-
-═══════════════════════════════════════════════════════════════════════════════
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.