@quicktvui/ai 1.0.7 → 1.0.8

package/rules/.source/hippy/hippy_views/webview/HippyWebViewInner.java

@@ -0,0 +1,77 @@
+/* Tencent is pleased to support the open source community by making Hippy available.
+ * Copyright (C) 2018 THL A29 Limited, a Tencent company. All rights reserved.
+ *
+ * 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.
+ */
+package com.tencent.mtt.hippy.views.webview;
+
+import android.content.Context;
+import android.view.KeyEvent;
+import android.webkit.WebSettings;
+import android.webkit.WebView;
+
+@SuppressWarnings({"unused"})
+class HippyWebViewInner extends WebView {
+
+  public HippyWebViewInner(Context context) {
+    super(context);
+    // 启用支持javascript
+    WebSettings settings = getSettings();
+    settings.setJavaScriptEnabled(true);
+    settings.setBuiltInZoomControls(true);
+    // 不显示webview缩放按钮
+    settings.setDisplayZoomControls(false);
+    settings.setDomStorageEnabled(true);
+    // 支持缩放
+    settings.setSupportZoom(true);
+    // 设置可以访问文件
+    settings.setAllowFileAccess(true);
+    //地理位置相关
+    settings.setGeolocationEnabled(true);
+    settings.setDatabaseEnabled(true);
+    settings.setLoadWithOverviewMode(true);
+    settings.setUseWideViewPort(true);
+    settings.setAppCacheEnabled(false);
+    settings.setCacheMode(WebSettings.LOAD_NO_CACHE);
+    settings.setSupportMultipleWindows(false);
+    settings.setAppCachePath(context.getDir("hwebview_appcache", 0).getPath());
+    settings.setDatabasePath(context.getDir("hwebview_databases", 0).getPath());
+    settings.setGeolocationDatabasePath(context.getDir("hwebview_geolocation", 0).getPath());
+    settings.setLoadsImagesAutomatically(true);
+    settings.setAllowContentAccess(false);
+    settings.setDatabaseEnabled(true);
+    settings.setDomStorageEnabled(true);
+    settings.setLoadWithOverviewMode(true);
+    settings.setUseWideViewPort(true);
+    settings.setBuiltInZoomControls(true);
+    settings.setDisplayZoomControls(false);
+    settings.setSupportZoom(true);
+    settings.setRenderPriority(WebSettings.RenderPriority.HIGH);
+    if (android.os.Build.VERSION.SDK_INT >= 26) {
+      settings.setSafeBrowsingEnabled(true);
+    }
+  }
+
+  // 改写物理按键——返回的逻辑
+  @Override
+  public boolean onKeyDown(int keyCode, KeyEvent event) {
+    if (keyCode == KeyEvent.KEYCODE_BACK) {
+      if (canGoBack()) {
+        // 返回上一页面
+        goBack();
+        return true;
+      }
+    }
+    return super.onKeyDown(keyCode, event);
+  }
+}

package/rules/.windsurfrules

@@ -7,9 +7,18 @@
 **AI MUST refer to the official documentation and source code below BEFORE generating any code. NEVER hallucinate component names, attribute names, or APIs. These are the ONLY authorities.**
 
 1.  **Local Docs, Examples & Source (PRIMARY)**: `node_modules/@quicktvui/ai/rules/.docs/` and `node_modules/@quicktvui/ai/rules/.source/` directories.
-    *   **Component Docs**: Detailed definitions of components, APIs, and CSS.
-    *   **Example Code**: `.docs/examples/` are verified best practices.
-    *   **Framework Source Code**: `.source/` directory contains the actual framework implementation. **AI SHOULD refer to the source code to resolve ambiguities in documentation.**
+    *   **Component Docs**: `.docs/` for component, API, and CSS definitions.
+    *   **Example Code**: `.docs/examples/` for verified best practices (pagination, focus, etc.).
+    *   **Framework Source Map**: `.source/` contains the full-stack implementation. AI MUST locate source based on module:
+        *   `quicktvui/`: Core Vue 3 UI component library implementation.
+        *   `hippy/`: Android Native implementation (ViewController, UIManager).
+        *   `ESPlayer*/ESVideoPlayer`: Media playback engines (Video, Audio, ADs).
+        *   `ESPlayerManager`: High-level player window and playlist management.
+        *   `ESRouter`: TV-optimized routing and navigation system.
+        *   `ESCore`: Native module bridge, Storage, Toast, and System APIs.
+        *   `ESVue*/ESVueStyleParser`: Custom Vue renderer and Style parser logic.
+        *   `ESAxios`: Platform-optimized network library.
+        *   `web/`: Polyfills for standard web tags.
 
 2.  **Official Docs**: https://quicktvui.com
 3.  **Core Library Samples**: https://github.com/quicktvui/quicktvui.git
@@ -403,4 +412,18 @@ export default defineComponent({
 5.  **Pagination & Load More Rules (CRITICAL)**:
     *   **`qt-tabs` (Tabs Waterfall)**: **MUST** use **`@onTabPageLoadData="onTabPageLoadData"`**. Append data via `addPageData`.
     *   **`qt-waterfall` (Single Waterfall)**: **NO native `loadMore` event**. Usually triggered via **`@onItemBind`** on the last section (e.g., a Loading Section) or by listening to **`@onScrollToBottom`** (if supported by parent).
-    *   **`qt-list-view` / `qt-grid-view`**: Support native `@loadMore="loadMoreFn"` with `pageNo` parameter.
+    *   **`qt-list-view` / `qt-grid-view`**: Support native `@loadMore="loadMoreFn"` with `pageNo` parameter.
+
+### 7. Native Component Mapping & Deprecations
+AI MUST understand the mapping between Vue components and Java Native controllers to avoid using deprecated logic:
+
+| Vue Component | Native Name (Hippy) | Java Class (PRIMARY) | Status |
+| :--- | :--- | :--- | :--- |
+| `qt-text` | `TextView` | `com.tencent.extend.views.TextViewController` | **Recommended** |
+| `qt-list-view` | `FastListView` | `com.tencent.extend.views.fastlist.FastListViewController` | **Recommended** |
+| `qt-waterfall` | `FastListView` | `com.tencent.extend.views.fastlist.FastListViewController` | **Recommended** |
+| `qt-image` | `Image` | `com.tencent.mtt.hippy.views.image.HippyImageViewController` | **Active** |
+| **(Deprecated)** | `Text` | `com.tencent.mtt.hippy.views.text.HippyTextViewController` | **DEPRECATED** |
+| **(Deprecated)** | `ListView` | `com.tencent.mtt.hippy.views.list.HippyListViewController` | **DEPRECATED** |
+
+**Rule**: Always prefer source code in `.source/hippy/extend_views/`. Use `.source/hippy/hippy_views/` only as a secondary fallback.

package/rules/AGENTS.md

@@ -7,9 +7,18 @@
 **AI MUST refer to the official documentation and source code below BEFORE generating any code. NEVER hallucinate component names, attribute names, or APIs. These are the ONLY authorities.**
 
 1.  **Local Docs, Examples & Source (PRIMARY)**: `node_modules/@quicktvui/ai/rules/.docs/` and `node_modules/@quicktvui/ai/rules/.source/` directories.
-    *   **Component Docs**: Detailed definitions of components, APIs, and CSS.
-    *   **Example Code**: `.docs/examples/` are verified best practices.
-    *   **Framework Source Code**: `.source/` directory contains the actual framework implementation. **AI SHOULD refer to the source code to resolve ambiguities in documentation.**
+    *   **Component Docs**: `.docs/` for component, API, and CSS definitions.
+    *   **Example Code**: `.docs/examples/` for verified best practices (pagination, focus, etc.).
+    *   **Framework Source Map**: `.source/` contains the full-stack implementation. AI MUST locate source based on module:
+        *   `quicktvui/`: Core Vue 3 UI component library implementation.
+        *   `hippy/`: Android Native implementation (ViewController, UIManager).
+        *   `ESPlayer*/ESVideoPlayer`: Media playback engines (Video, Audio, ADs).
+        *   `ESPlayerManager`: High-level player window and playlist management.
+        *   `ESRouter`: TV-optimized routing and navigation system.
+        *   `ESCore`: Native module bridge, Storage, Toast, and System APIs.
+        *   `ESVue*/ESVueStyleParser`: Custom Vue renderer and Style parser logic.
+        *   `ESAxios`: Platform-optimized network library.
+        *   `web/`: Polyfills for standard web tags.
 
 2.  **Official Docs**: https://quicktvui.com (390+ docs)
 3.  **Core Library Samples**: https://github.com/quicktvui/quicktvui.git (Core library + samples)
@@ -492,4 +501,18 @@ export default defineComponent({
 5.  **Pagination & Load More Rules (CRITICAL)**:
     *   **`qt-tabs` (Tabs Waterfall)**: **MUST** use **`@onTabPageLoadData="onTabPageLoadData"`**. Append data via `addPageData`.
     *   **`qt-waterfall` (Single Waterfall)**: **NO native `loadMore` event**. Usually triggered via **`@onItemBind`** on the last section (e.g., a Loading Section) or by listening to **`@onScrollToBottom`** (if supported by parent).
-    *   **`qt-list-view` / `qt-grid-view`**: Support native `@loadMore="loadMoreFn"` with `pageNo` parameter.
+    *   **`qt-list-view` / `qt-grid-view`**: Support native `@loadMore="loadMoreFn"` with `pageNo` parameter.
+
+### 7. Native Component Mapping & Deprecations
+AI MUST understand the mapping between Vue components and Java Native controllers to avoid using deprecated logic:
+
+| Vue Component | Native Name (Hippy) | Java Class (PRIMARY) | Status |
+| :--- | :--- | :--- | :--- |
+| `qt-text` | `TextView` | `com.tencent.extend.views.TextViewController` | **Recommended** |
+| `qt-list-view` | `FastListView` | `com.tencent.extend.views.fastlist.FastListViewController` | **Recommended** |
+| `qt-waterfall` | `FastListView` | `com.tencent.extend.views.fastlist.FastListViewController` | **Recommended** |
+| `qt-image` | `Image` | `com.tencent.mtt.hippy.views.image.HippyImageViewController` | **Active** |
+| **(Deprecated)** | `Text` | `com.tencent.mtt.hippy.views.text.HippyTextViewController` | **DEPRECATED** |
+| **(Deprecated)** | `ListView` | `com.tencent.mtt.hippy.views.list.HippyListViewController` | **DEPRECATED** |
+
+**Rule**: Always prefer source code in `.source/hippy/extend_views/`. Use `.source/hippy/hippy_views/` only as a secondary fallback.

package/rules/CLAUDE.md

@@ -7,9 +7,18 @@
 **AI 在生成代码前，必须严格参考以下权威来源，严禁凭空想象任何组件名、属性名或 API。这是所有代码的唯一依据。**
 
 1.  **本地文档、示例与源码 (PRIMARY)**：`node_modules/@quicktvui/ai/rules/.docs/` 和 `node_modules/@quicktvui/ai/rules/.source/` 目录。
-    *   **组件文档**：提供组件、API 及 CSS 的详细定义。
-    *   **示例代码**：`.docs/examples/` 下的 Vue 文件是经过验证的最佳实践。
-    *   **框架源码**：`.source/` 目录下是框架的真实实现逻辑。**当文档模糊时，AI 必须查阅源码以确保 100% 准确性。**
+    *   **组件文档**：`.docs/` 提供组件、API 及 CSS 的详细定义。
+    *   **示例代码**：`.docs/examples/` 是经过验证的最佳实践（分页、焦点等）。
+    *   **框架源码地图**：`.source/` 包含框架的全栈实现，AI 必须根据模块定位源码：
+        *   `quicktvui/`: 核心 Vue 3 UI 组件库实现。
+        *   `hippy/`: Android Native 层实现 (ViewController, UIManager)。
+        *   `ESPlayer*/ESVideoPlayer`: 视频、音频及广告播放核心引擎。
+        *   `ESPlayerManager`: 高级播放器窗口管理、列表流转逻辑。
+        *   `ESRouter`: 适配 TV 端的路由与导航系统。
+        *   `ESCore`: 原生桥接层、存储、提示及系统级 API。
+        *   `ESVue*/ESVueStyleParser`: 自定义 Vue 渲染器及样式解析器实现。
+        *   `ESAxios`: 针对平台优化的网络请求库。
+        *   `web/`: Web 标准标签适配层。
 
 2.  **官方文档**：https://quicktvui.com (官网 390+ 篇详细文档)
 3.  **核心库示例**：https://github.com/quicktvui/quicktvui.git (Core library + samples)
@@ -867,3 +876,18 @@ export default defineComponent({
 }
 </style>
 ```
+
+
+### 7. Native 组件映射与废弃说明 (Component Mapping & Deprecations)
+AI 必须了解 Vue 组件与 Java Native 层的对应关系，避免查阅已废弃的源码：
+
+| Vue 组件 | Native 名称 (Hippy) | 对应 Java 类 (PRIMARY) | 状态 |
+| :--- | :--- | :--- | :--- |
+| `qt-text` | `TextView` | `com.tencent.extend.views.TextViewController` | **推荐** |
+| `qt-list-view` | `FastListView` | `com.tencent.extend.views.fastlist.FastListViewController` | **推荐** |
+| `qt-waterfall` | `FastListView` | `com.tencent.extend.views.fastlist.FastListViewController` | **推荐** |
+| `qt-image` | `Image` | `com.tencent.mtt.hippy.views.image.HippyImageViewController` | **常用** |
+| **(已废弃)** | `Text` | `com.tencent.mtt.hippy.views.text.HippyTextViewController` | **废弃** |
+| **(已废弃)** | `ListView` | `com.tencent.mtt.hippy.views.list.HippyListViewController` | **废弃** |
+
+**注意**：查阅源码时，优先进入 `.source/hippy/extend_views/` 目录。只有当该目录下没有对应组件时，才查阅 `.source/hippy/hippy_views/`。

package/rules/GEMINI.md

@@ -7,9 +7,18 @@
 **AI 在生成代码前，必须严格参考以下权威来源，严禁凭空想象任何组件名、属性名或 API。这是所有代码的唯一依据。**
 
 1.  **本地文档、示例与源码 (PRIMARY)**：`node_modules/@quicktvui/ai/rules/.docs/` 和 `node_modules/@quicktvui/ai/rules/.source/` 目录。
-    *   **组件文档**：提供组件、API 及 CSS 的详细定义。
-    *   **示例代码**：`.docs/examples/` 下的 Vue 文件是经过验证的最佳实践。
-    *   **框架源码**：`.source/` 目录下是框架的真实实现逻辑。**当文档模糊时，AI 必须查阅源码以确保 100% 准确性。**
+    *   **组件文档**：`.docs/` 提供组件、API 及 CSS 的详细定义。
+    *   **示例代码**：`.docs/examples/` 是经过验证的最佳实践（分页、焦点等）。
+    *   **框架源码地图**：`.source/` 包含框架的全栈实现，AI 必须根据模块定位源码：
+        *   `quicktvui/`: 核心 Vue 3 UI 组件库实现。
+        *   `hippy/`: Android Native 层实现 (ViewController, UIManager)。
+        *   `ESPlayer*/ESVideoPlayer`: 视频、音频及广告播放核心引擎。
+        *   `ESPlayerManager`: 高级播放器窗口管理、列表流转逻辑。
+        *   `ESRouter`: 适配 TV 端的路由与导航系统。
+        *   `ESCore`: 原生桥接层、存储、提示及系统级 API。
+        *   `ESVue*/ESVueStyleParser`: 自定义 Vue 渲染器及样式解析器实现。
+        *   `ESAxios`: 针对平台优化的网络请求库。
+        *   `web/`: Web 标准标签适配层。
 
 2.  **官方文档**：https://quicktvui.com (官网 390+ 篇详细文档)
 3.  **核心库示例**：https://github.com/quicktvui/quicktvui.git
@@ -63,6 +72,19 @@ AI 在编写业务逻辑时，必须牢记以下框架特性，防止套用 Web
 AI 在创建新项目时，必须遵循：`git clone` 官方模板 -> 清理 `.git` -> 修改 `package.json` -> `yarn install`。
 
 ---
+### 7. Native 组件映射与废弃说明 (Component Mapping & Deprecations)
+AI 必须了解 Vue 组件与 Java Native 层的对应关系，避免查阅已废弃的源码：
+
+| Vue 组件 | Native 名称 (Hippy) | 对应 Java 类 (PRIMARY) | 状态 |
+| :--- | :--- | :--- | :--- |
+| `qt-text` | `TextView` | `com.tencent.extend.views.TextViewController` | **推荐** |
+| `qt-list-view` | `FastListView` | `com.tencent.extend.views.fastlist.FastListViewController` | **推荐** |
+| `qt-waterfall` | `FastListView` | `com.tencent.extend.views.fastlist.FastListViewController` | **推荐** |
+| `qt-image` | `Image` | `com.tencent.mtt.hippy.views.image.HippyImageViewController` | **常用** |
+| **(已废弃)** | `Text` | `com.tencent.mtt.hippy.views.text.HippyTextViewController` | **废弃** |
+| **(已废弃)** | `ListView` | `com.tencent.mtt.hippy.views.list.HippyListViewController` | **废弃** |
+
+**注意**：查阅源码时，优先进入 `.source/hippy/extend_views/` 目录。只有当该目录下没有对应组件时，才查阅 `.source/hippy/hippy_views/`。
 
 ## 📚 常用组件与 API (速查)
 * **Back 键**：必须命名为 `onBackPressed`。