@quicktvui/qtx 0.0.0-stage → 0.9.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/AI_CONTRACT.md +472 -0
  2. package/README.md +173 -2
  3. package/dist/components/QtxAppIcon/QtxAppIcon.vue.d.ts +73 -0
  4. package/dist/components/QtxAppIcon/QtxAppIconBase.vue.d.ts +144 -0
  5. package/dist/components/QtxAppIcon/index.d.ts +13 -0
  6. package/dist/components/QtxAppIcon/types.d.ts +157 -0
  7. package/dist/components/QtxButton/QtxButton.vue.d.ts +24 -0
  8. package/dist/components/QtxButton/QtxButtonBase.vue.d.ts +64 -0
  9. package/dist/components/QtxButton/index.d.ts +13 -0
  10. package/dist/components/QtxCheckbox/QtxCheckbox.vue.d.ts +110 -0
  11. package/dist/components/QtxCheckbox/index.d.ts +13 -0
  12. package/dist/components/QtxCheckboxGroup/QtxCheckboxGroup.vue.d.ts +103 -0
  13. package/dist/components/QtxCheckboxGroup/index.d.ts +13 -0
  14. package/dist/components/QtxCollapseMenuGroup/QtxCollapseMenuGroup.vue.d.ts +9 -0
  15. package/dist/components/QtxCollapseMenuGroup/QtxCollapseMenuGroupBase.vue.d.ts +40 -0
  16. package/dist/components/QtxCollapseMenuGroup/index.d.ts +13 -0
  17. package/dist/components/QtxCollapseMenuList/QtxCollapseMenuList.vue.d.ts +12 -0
  18. package/dist/components/QtxCollapseMenuList/QtxCollapseMenuListBase.vue.d.ts +32 -0
  19. package/dist/components/QtxCollapseMenuList/index.d.ts +13 -0
  20. package/dist/components/QtxDatePicker/QtxDatePicker.vue.d.ts +28 -0
  21. package/dist/components/QtxDatePicker/index.d.ts +13 -0
  22. package/dist/components/QtxGridTabs/QtxGridTabs.vue.d.ts +11 -0
  23. package/dist/components/QtxGridTabs/index.d.ts +13 -0
  24. package/dist/components/QtxGridTabs/useGridItemPresence.d.ts +26 -0
  25. package/dist/components/QtxGridTabs/useGridTabs.d.ts +163 -0
  26. package/dist/components/QtxGridTabs/useGridTabsData.d.ts +20 -0
  27. package/dist/components/QtxGridTabs/useGridTabsUpdater.d.ts +24 -0
  28. package/dist/components/QtxHsvBackground/QtxHsvBackground.vue.d.ts +26 -0
  29. package/dist/components/QtxHsvBackground/index.d.ts +13 -0
  30. package/dist/components/QtxInputView/QtxInputView.vue.d.ts +42 -0
  31. package/dist/components/QtxInputView/QtxInputViewBase.vue.d.ts +46 -0
  32. package/dist/components/QtxInputView/index.d.ts +13 -0
  33. package/dist/components/QtxKeyboard/QtxKeyboard.vue.d.ts +59 -0
  34. package/dist/components/QtxKeyboard/index.d.ts +13 -0
  35. package/dist/components/QtxList/QtxList.vue.d.ts +96 -0
  36. package/dist/components/QtxList/QtxListBase.vue.d.ts +11 -0
  37. package/dist/components/QtxList/capture.d.ts +86 -0
  38. package/dist/components/QtxList/index.d.ts +13 -0
  39. package/dist/components/QtxList/types.d.ts +78 -0
  40. package/dist/components/QtxNumericKeyboard/QtxNumericKeyboard.vue.d.ts +28 -0
  41. package/dist/components/QtxNumericKeyboard/index.d.ts +13 -0
  42. package/dist/components/QtxPortalItem/QtxPortalItem.vue.d.ts +24 -0
  43. package/dist/components/QtxPortalItem/index.d.ts +13 -0
  44. package/dist/components/QtxPortalPool/QtxPortalPool.vue.d.ts +11 -0
  45. package/dist/components/QtxPortalPool/index.d.ts +13 -0
  46. package/dist/components/QtxPoster/QtxPoster.vue.d.ts +60 -0
  47. package/dist/components/QtxPoster/QtxPosterBase.vue.d.ts +117 -0
  48. package/dist/components/QtxPoster/index.d.ts +13 -0
  49. package/dist/components/QtxPoster/types.d.ts +133 -0
  50. package/dist/components/QtxRadioGroup/QtxRadioGroup.vue.d.ts +103 -0
  51. package/dist/components/QtxRadioGroup/index.d.ts +13 -0
  52. package/dist/components/QtxRatingBar/QtxRatingBar.vue.d.ts +34 -0
  53. package/dist/components/QtxRatingBar/index.d.ts +13 -0
  54. package/dist/components/QtxSettingSwitch/QtxSettingSwitch.vue.d.ts +111 -0
  55. package/dist/components/QtxSettingSwitch/index.d.ts +6 -0
  56. package/dist/components/QtxSvgImage/QtxSvgImage.vue.d.ts +26 -0
  57. package/dist/components/QtxSvgImage/index.d.ts +13 -0
  58. package/dist/components/QtxSwitcher/QtxSwitcher.vue.d.ts +52 -0
  59. package/dist/components/QtxSwitcher/index.d.ts +13 -0
  60. package/dist/components/QtxTabContent/QtxTabContent.vue.d.ts +24 -0
  61. package/dist/components/QtxTabs/QtxTabs.vue.d.ts +37 -0
  62. package/dist/components/QtxTabs/index.d.ts +16 -0
  63. package/dist/core/installQtx.d.ts +40 -0
  64. package/dist/core/portalCoordinator.d.ts +4 -0
  65. package/dist/core/qtxGate.d.ts +13 -0
  66. package/dist/core/theme.d.ts +12 -0
  67. package/dist/directives/v-portal-to.d.ts +4 -0
  68. package/dist/index.d.ts +139 -0
  69. package/dist/modules/AddonEnvModule.d.ts +4 -0
  70. package/dist/modules/ExtraUIConfigModule.d.ts +7 -0
  71. package/dist/modules/GridTabsConfigModule.d.ts +7 -0
  72. package/dist/modules/QtxVersionModule.d.ts +4 -0
  73. package/dist/preset-items/QtxStyledList.vue.d.ts +65 -0
  74. package/dist/preset-items/compact.d.ts +2 -0
  75. package/dist/preset-items/glint.d.ts +11 -0
  76. package/dist/preset-items/index.d.ts +45 -0
  77. package/dist/preset-items/retired-items.d.ts +22 -0
  78. package/dist/preset-items/types.d.ts +112 -0
  79. package/dist/qtx.cjs.js +1 -0
  80. package/dist/qtx.es.js +6375 -0
  81. package/dist/style.css +1 -0
  82. package/dist/types/index.d.ts +50 -0
  83. package/package.json +32 -4
@@ -0,0 +1,37 @@
1
+ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
2
+ active?: string | undefined;
3
+ offscreen?: number | undefined;
4
+ maxInstances?: number | undefined;
5
+ animationDuration?: number | undefined;
6
+ animationDirection?: "horizontal" | "vertical" | undefined;
7
+ }>>, {
8
+ getNativeNode: () => any;
9
+ changeTab: (key: string) => any;
10
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
11
+ change: (key: string) => void;
12
+ }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
13
+ active?: string | undefined;
14
+ offscreen?: number | undefined;
15
+ maxInstances?: number | undefined;
16
+ animationDuration?: number | undefined;
17
+ animationDirection?: "horizontal" | "vertical" | undefined;
18
+ }>>> & Readonly<{
19
+ onChange?: ((key: string) => any) | undefined;
20
+ }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
21
+ default?(_: {}): any;
22
+ }>;
23
+ export default _default;
24
+ type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
25
+ type __VLS_TypePropsToRuntimeProps<T> = {
26
+ [K in keyof T]-?: {} extends Pick<T, K> ? {
27
+ type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
28
+ } : {
29
+ type: import('vue').PropType<T[K]>;
30
+ required: true;
31
+ };
32
+ };
33
+ type __VLS_WithTemplateSlots<T, S> = T & {
34
+ new (): {
35
+ $slots: S;
36
+ };
37
+ };
@@ -0,0 +1,16 @@
1
+ import type { App } from 'vue';
2
+ import QtxTabs from './QtxTabs.vue';
3
+ import QtxTabContent from '../QtxTabContent/QtxTabContent.vue';
4
+ export declare const QtxTabsPlugin: {
5
+ install: (app: App) => void;
6
+ };
7
+ export { QtxTabs, QtxTabContent };
8
+ export default QtxTabsPlugin;
9
+ declare module 'vue' {
10
+ interface GlobalComponents {
11
+ QtxTabs: typeof QtxTabs;
12
+ 'qtx-tabs': typeof QtxTabs;
13
+ QtxTabContent: typeof QtxTabContent;
14
+ 'qtx-tab-content': typeof QtxTabContent;
15
+ }
16
+ }
@@ -0,0 +1,40 @@
1
+ /** qtx 统一插件 */
2
+ export declare const QTX_PLUGIN_PKG = "com.quicktvui.plugin.qtx";
3
+ /** 插件入口类(宿主 callReflect 调用其 setup()) */
4
+ export declare const QTX_PLUGIN_INIT_CLASS = "com.quicktvui.plugin.qtx.QtxPluginApp";
5
+ /** JS 侧要求的最低指令协议版本(与 GridTabsSDUI.md 同步) */
6
+ export declare const QTX_MIN_PROTOCOL_VERSION = "1.28.0";
7
+ export interface QtxVersionInfo {
8
+ pluginVersion: string;
9
+ protocolVersion: string;
10
+ components: Record<string, string>;
11
+ mode: 'plugin' | 'embedded';
12
+ }
13
+ export interface InstallQtxOptions {
14
+ /** 兼容的最低插件版本,默认取本库编译期版本(同版本发布) */
15
+ minPluginVersion?: string;
16
+ /** 兼容的最低协议版本,默认 QTX_MIN_PROTOCOL_VERSION */
17
+ minProtocolVersion?: string;
18
+ /** auto=缺失/过期时驱动宿主插件管理器下载安装;manual=只报错不动作 */
19
+ upgrade?: 'auto' | 'manual';
20
+ /** 单次安装超时(毫秒),默认 8000 */
21
+ timeout?: number;
22
+ }
23
+ export declare class QtxInstallError extends Error {
24
+ code: 'PROBE_FAILED' | 'INSTALL_FAILED' | 'VERSION_TOO_LOW' | 'PROTOCOL_MISMATCH' | 'TIMEOUT';
25
+ detail?: Partial<QtxVersionInfo> & {
26
+ minPluginVersion?: string;
27
+ minProtocolVersion?: string;
28
+ };
29
+ constructor(code: QtxInstallError['code'], message: string, detail?: QtxInstallError['detail']);
30
+ }
31
+ export declare function isVersionAtLeast(actual: string, required: string): boolean;
32
+ /**
33
+ * 引导 qtx(全局单例,幂等,可重试——失败后再次调用会重新走流程)。
34
+ * app.use(qtx) 与首个组件挂载都会触发;一般无需手动调用。
35
+ */
36
+ export declare function installQtx(options?: InstallQtxOptions): Promise<QtxVersionInfo>;
37
+ /** 组件渲染前 await:未 ready 时渲染层出骨架屏 */
38
+ export declare function ensureQtxReady(options?: InstallQtxOptions): Promise<QtxVersionInfo>;
39
+ /** 当前就绪状态(同步,不触发引导) */
40
+ export declare function getQtxReadyInfo(): QtxVersionInfo | null;
@@ -0,0 +1,4 @@
1
+ export declare function setPortalListViewId(viewId: string | null): void;
2
+ export declare function getPortalListViewId(): string | null;
3
+ /** 活内容注册:key=relocate-key,nodeId=活内容 Hippy nodeId。成功 true */
4
+ export declare function registerPortalLive(key: string, nodeId: number): Promise<boolean>;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * createQtxGate —— 生成器组件壳的统一门卫。
3
+ *
4
+ * 取代旧的 withAsyncPlugin:不再逐组件探测/安装(那是引导前时代的按需逻辑),
5
+ * 只等待全局 installQtx() 就绪后渲染原生标签;未就绪时渲染骨架屏,失败时显示
6
+ * 诊断信息(含版本与原因),点击可重试。
7
+ *
8
+ * 渲染机制与旧 HOC 完全一致:ready 后 h(tagName) 命中 registerElement 注册的
9
+ * 原生元素(而非 Vue 全局组件,避免递归)。
10
+ */
11
+ export declare function createQtxGate(tagName: string): import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
12
+ [key: string]: any;
13
+ }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -0,0 +1,12 @@
1
+ /**
2
+ * 全局主题初始化(自旧 AddonProvider 迁出的纯函数部分,shade/env 逻辑已退役)。
3
+ */
4
+ /** 初始化 GridTabs 的全局兜底配置(themeConfig / loadingConfig 等) */
5
+ export declare function initGridTabsGlobalConfig(config: Record<string, any>): Promise<boolean>;
6
+ /** 初始化 ExtraUI 的全局主题(primaryColor、focusBorderColor、cornerRadius 等) */
7
+ export declare function initExtraUIGlobalTheme(config: Record<string, any>): Promise<boolean>;
8
+ /**
9
+ * 一键设置全局主题(联合配置):同时配置 extra-ui 与 grid-tabs/glint 的主题参数。
10
+ * 供业务层在启动时调用。
11
+ */
12
+ export declare function initGlobalTheme(themeConfig: Record<string, any>): Promise<boolean>;
@@ -0,0 +1,4 @@
1
+ export declare const vPortalTo: {
2
+ mounted(el: any, binding: any): void;
3
+ unmounted(el: any): void;
4
+ };
@@ -0,0 +1,139 @@
1
+ export * from './components/QtxGridTabs';
2
+ export { useGridTabs } from './components/QtxGridTabs/useGridTabs';
3
+ export type { QtxListItem, QtxListProps, QtxListItemEvent, QtxListLoadMoreEvent, QtxListEventName, QtxListExpose, } from './components/QtxList/types';
4
+ export { QTX_LIST_EVENTS } from './components/QtxList/types';
5
+ export { captureItemTemplate } from './components/QtxList/capture';
6
+ export type { QtxPosterProps, QtxPosterExpose } from './components/QtxPoster/types';
7
+ export type { QtxAppIconProps, QtxAppIconExpose } from './components/QtxAppIcon/types';
8
+ export { glintStylePack, compactStylePack, presetItem, styledRows, resolvePresetViewType, registerStylePack, getStylePack, listStylePacks, listPresetViewTypes, isKnownPresetViewType, } from './preset-items';
9
+ export type { PresetItemRow, PresetItemTypeSpec, PresetItemOptions, StylePack, StyledRow, QtxStyledListProps, } from './preset-items';
10
+ import QtxStyledList from './preset-items/QtxStyledList.vue';
11
+ export { QtxStyledList };
12
+ import { QtxGridTabsPlugin, QtxGridTabs } from './components/QtxGridTabs';
13
+ import { QtxKeyboardPlugin, QtxKeyboard } from './components/QtxKeyboard';
14
+ import { QtxNumericKeyboardPlugin, QtxNumericKeyboard } from './components/QtxNumericKeyboard';
15
+ import { QtxPortalPoolPlugin, QtxPortalPool } from './components/QtxPortalPool';
16
+ import { QtxPortalItemPlugin, QtxPortalItem } from './components/QtxPortalItem';
17
+ import { QtxHsvBackgroundPlugin, QtxHsvBackground } from './components/QtxHsvBackground';
18
+ import { QtxSvgImagePlugin, QtxSvgImage } from './components/QtxSvgImage';
19
+ import { QtxButtonPlugin, QtxButton } from './components/QtxButton';
20
+ import { QtxCheckboxPlugin, QtxCheckbox } from './components/QtxCheckbox';
21
+ import { QtxRadioGroupPlugin, QtxRadioGroup } from './components/QtxRadioGroup';
22
+ import { QtxCheckboxGroupPlugin, QtxCheckboxGroup } from './components/QtxCheckboxGroup';
23
+ import { QtxSwitcherPlugin, QtxSwitcher } from './components/QtxSwitcher';
24
+ import { QtxSettingSwitchPlugin, QtxSettingSwitch } from './components/QtxSettingSwitch';
25
+ import { QtxCollapseMenuGroupPlugin, QtxCollapseMenuGroup } from './components/QtxCollapseMenuGroup';
26
+ import { QtxCollapseMenuListPlugin, QtxCollapseMenuList } from './components/QtxCollapseMenuList';
27
+ import { QtxInputViewPlugin, QtxInputView } from './components/QtxInputView';
28
+ import { QtxDatePickerPlugin, QtxDatePicker } from './components/QtxDatePicker';
29
+ import { QtxRatingBarPlugin, QtxRatingBar } from './components/QtxRatingBar';
30
+ import { QtxListPlugin, QtxList } from './components/QtxList';
31
+ import { QtxTabsPlugin, QtxTabs, QtxTabContent } from './components/QtxTabs';
32
+ import { QtxPosterPlugin, QtxPoster } from './components/QtxPoster';
33
+ import { QtxAppIconPlugin, QtxAppIcon } from './components/QtxAppIcon';
34
+ export { QtxGridTabsPlugin, QtxGridTabs, QtxKeyboardPlugin, QtxKeyboard, QtxNumericKeyboardPlugin, QtxNumericKeyboard, QtxPortalPoolPlugin, QtxPortalPool, QtxPortalItemPlugin, QtxPortalItem, QtxHsvBackgroundPlugin, QtxHsvBackground, QtxSvgImagePlugin, QtxSvgImage, QtxButtonPlugin, QtxButton, QtxCheckboxPlugin, QtxCheckbox, QtxRadioGroupPlugin, QtxRadioGroup, QtxCheckboxGroupPlugin, QtxCheckboxGroup, QtxSwitcherPlugin, QtxSwitcher, QtxSettingSwitchPlugin, QtxSettingSwitch, QtxCollapseMenuGroupPlugin, QtxCollapseMenuGroup, QtxCollapseMenuListPlugin, QtxCollapseMenuList, QtxInputViewPlugin, QtxInputView, QtxDatePickerPlugin, QtxDatePicker, QtxRatingBarPlugin, QtxRatingBar, QtxListPlugin, QtxList, QtxTabsPlugin, QtxTabs, QtxTabContent, QtxPosterPlugin, QtxPoster, QtxAppIconPlugin, QtxAppIcon };
35
+ export { installQtx, ensureQtxReady, getQtxReadyInfo, QtxInstallError, isVersionAtLeast } from './core/installQtx';
36
+ export type { QtxVersionInfo, InstallQtxOptions } from './core/installQtx';
37
+ export { createQtxGate } from './core/qtxGate';
38
+ export { initGlobalTheme, initExtraUIGlobalTheme, initGridTabsGlobalConfig } from './core/theme';
39
+ export { vPortalTo } from './directives/v-portal-to';
40
+ export { setPortalListViewId, getPortalListViewId, registerPortalLive } from './core/portalCoordinator';
41
+ import { App } from 'vue';
42
+ /**
43
+ * qtx Vue 插件:注册全部 qtx-* 组件,并自动触发插件引导(探测/协商/安装)。
44
+ * 这是用户唯一需要写的一行:app.use(qtx)。
45
+ */
46
+ export declare const qtx: {
47
+ install: (app: App) => void;
48
+ };
49
+ export default qtx;
50
+ declare module '@vue/runtime-core' {
51
+ interface GlobalComponents {
52
+ QtxGridTabs: typeof QtxGridTabs;
53
+ 'qtx-grid-tabs': typeof QtxGridTabs;
54
+ QtxKeyboard: typeof QtxKeyboard;
55
+ 'qtx-keyboard': typeof QtxKeyboard;
56
+ QtxNumericKeyboard: typeof QtxNumericKeyboard;
57
+ 'qtx-numeric-keyboard': typeof QtxNumericKeyboard;
58
+ QtxPortalPool: typeof QtxPortalPool;
59
+ 'qtx-portal-pool': typeof QtxPortalPool;
60
+ QtxPortalItem: typeof QtxPortalItem;
61
+ 'qtx-portal-item': typeof QtxPortalItem;
62
+ QtxHsvBackground: typeof QtxHsvBackground;
63
+ 'qtx-hsv-background': typeof QtxHsvBackground;
64
+ QtxSvgImage: typeof QtxSvgImage;
65
+ 'qtx-svg-image': typeof QtxSvgImage;
66
+ QtxButton: typeof QtxButton;
67
+ 'qtx-button': typeof QtxButton;
68
+ QtxCheckbox: typeof QtxCheckbox;
69
+ 'qtx-checkbox': typeof QtxCheckbox;
70
+ QtxRadioGroup: typeof QtxRadioGroup;
71
+ 'qtx-radio-group': typeof QtxRadioGroup;
72
+ QtxCheckboxGroup: typeof QtxCheckboxGroup;
73
+ 'qtx-checkbox-group': typeof QtxCheckboxGroup;
74
+ QtxSwitcher: typeof QtxSwitcher;
75
+ 'qtx-switcher': typeof QtxSwitcher;
76
+ QtxSettingSwitch: typeof QtxSettingSwitch;
77
+ 'qtx-setting-switch': typeof QtxSettingSwitch;
78
+ QtxCollapseMenuGroup: typeof QtxCollapseMenuGroup;
79
+ 'qtx-collapse-menu-group': typeof QtxCollapseMenuGroup;
80
+ QtxCollapseMenuList: typeof QtxCollapseMenuList;
81
+ 'qtx-collapse-menu-list': typeof QtxCollapseMenuList;
82
+ QtxInputView: typeof QtxInputView;
83
+ 'qtx-input-view': typeof QtxInputView;
84
+ QtxDatePicker: typeof QtxDatePicker;
85
+ 'qtx-date-picker': typeof QtxDatePicker;
86
+ QtxRatingBar: typeof QtxRatingBar;
87
+ 'qtx-rating-bar': typeof QtxRatingBar;
88
+ QtxPoster: typeof QtxPoster;
89
+ 'qtx-poster': typeof QtxPoster;
90
+ QtxAppIcon: typeof QtxAppIcon;
91
+ 'qtx-app-icon': typeof QtxAppIcon;
92
+ QtxStyledList: typeof QtxStyledList;
93
+ }
94
+ }
95
+ declare module 'vue' {
96
+ interface GlobalComponents {
97
+ QtxGridTabs: typeof QtxGridTabs;
98
+ 'qtx-grid-tabs': typeof QtxGridTabs;
99
+ QtxKeyboard: typeof QtxKeyboard;
100
+ 'qtx-keyboard': typeof QtxKeyboard;
101
+ QtxNumericKeyboard: typeof QtxNumericKeyboard;
102
+ 'qtx-numeric-keyboard': typeof QtxNumericKeyboard;
103
+ QtxPortalPool: typeof QtxPortalPool;
104
+ 'qtx-portal-pool': typeof QtxPortalPool;
105
+ QtxPortalItem: typeof QtxPortalItem;
106
+ 'qtx-portal-item': typeof QtxPortalItem;
107
+ QtxHsvBackground: typeof QtxHsvBackground;
108
+ 'qtx-hsv-background': typeof QtxHsvBackground;
109
+ QtxSvgImage: typeof QtxSvgImage;
110
+ 'qtx-svg-image': typeof QtxSvgImage;
111
+ QtxButton: typeof QtxButton;
112
+ 'qtx-button': typeof QtxButton;
113
+ QtxCheckbox: typeof QtxCheckbox;
114
+ 'qtx-checkbox': typeof QtxCheckbox;
115
+ QtxRadioGroup: typeof QtxRadioGroup;
116
+ 'qtx-radio-group': typeof QtxRadioGroup;
117
+ QtxCheckboxGroup: typeof QtxCheckboxGroup;
118
+ 'qtx-checkbox-group': typeof QtxCheckboxGroup;
119
+ QtxSwitcher: typeof QtxSwitcher;
120
+ 'qtx-switcher': typeof QtxSwitcher;
121
+ QtxSettingSwitch: typeof QtxSettingSwitch;
122
+ 'qtx-setting-switch': typeof QtxSettingSwitch;
123
+ QtxCollapseMenuGroup: typeof QtxCollapseMenuGroup;
124
+ 'qtx-collapse-menu-group': typeof QtxCollapseMenuGroup;
125
+ QtxCollapseMenuList: typeof QtxCollapseMenuList;
126
+ 'qtx-collapse-menu-list': typeof QtxCollapseMenuList;
127
+ QtxInputView: typeof QtxInputView;
128
+ 'qtx-input-view': typeof QtxInputView;
129
+ QtxDatePicker: typeof QtxDatePicker;
130
+ 'qtx-date-picker': typeof QtxDatePicker;
131
+ QtxRatingBar: typeof QtxRatingBar;
132
+ 'qtx-rating-bar': typeof QtxRatingBar;
133
+ QtxPoster: typeof QtxPoster;
134
+ 'qtx-poster': typeof QtxPoster;
135
+ QtxAppIcon: typeof QtxAppIcon;
136
+ 'qtx-app-icon': typeof QtxAppIcon;
137
+ QtxStyledList: typeof QtxStyledList;
138
+ }
139
+ }
@@ -0,0 +1,4 @@
1
+ export declare const AddonEnvModule: {
2
+ getBuiltInVersions(): Promise<any>;
3
+ };
4
+ export default AddonEnvModule;
@@ -0,0 +1,7 @@
1
+ export declare const ExtraUIConfigModule: {
2
+ /**
3
+ * 前端调用此方法,传入 JSON 字符串配置以更新 ExtraUI 的主题
4
+ */
5
+ setThemeConfig(jsonConfig: Record<string, any> | string): Promise<any>;
6
+ };
7
+ export default ExtraUIConfigModule;
@@ -0,0 +1,7 @@
1
+ export declare const GridTabsConfigModule: {
2
+ /**
3
+ * 前端调用此方法,传入 JSON 字符串配置
4
+ */
5
+ setDefaultConfig(jsonConfig: Record<string, any> | string): Promise<any>;
6
+ };
7
+ export default GridTabsConfigModule;
@@ -0,0 +1,4 @@
1
+ export declare const QtxVersionModule: {
2
+ getVersionInfo(): Promise<any>;
3
+ };
4
+ export default QtxVersionModule;
@@ -0,0 +1,65 @@
1
+ import type { QtxStyledListProps, StyledRow } from './types';
2
+ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<QtxStyledListProps>, {
3
+ pack: string;
4
+ typeField: string;
5
+ keyField: string;
6
+ columns: number;
7
+ direction: string;
8
+ gutter: number;
9
+ loadingTail: boolean;
10
+ }>>, {
11
+ getNativeNode: () => any;
12
+ updateItem: (index: number, patch: Record<string, unknown>) => void;
13
+ addListData: (input: StyledRow[]) => any;
14
+ prependItems: (input: StyledRow[]) => any;
15
+ removeItem: (index: number) => any;
16
+ moveItemBefore: (from: number, to: number) => any;
17
+ clearItems: () => any;
18
+ scrollToIndex: (index: number, smooth?: boolean) => any;
19
+ setLoading: (visible: boolean) => any;
20
+ focusItem: (index: number) => any;
21
+ setListData: (input: StyledRow[]) => any;
22
+ refresh: () => any;
23
+ dispatchAction: (actions: unknown) => any;
24
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<QtxStyledListProps>, {
25
+ pack: string;
26
+ typeField: string;
27
+ keyField: string;
28
+ columns: number;
29
+ direction: string;
30
+ gutter: number;
31
+ loadingTail: boolean;
32
+ }>>> & Readonly<{}>, {
33
+ pack: string;
34
+ typeField: string;
35
+ keyField: string;
36
+ columns: number;
37
+ direction: "horizontal" | "vertical";
38
+ gutter: number;
39
+ loadingTail: boolean;
40
+ }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
41
+ portals?(_: {}): any;
42
+ }>;
43
+ export default _default;
44
+ type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
45
+ type __VLS_TypePropsToRuntimeProps<T> = {
46
+ [K in keyof T]-?: {} extends Pick<T, K> ? {
47
+ type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
48
+ } : {
49
+ type: import('vue').PropType<T[K]>;
50
+ required: true;
51
+ };
52
+ };
53
+ type __VLS_WithDefaults<P, D> = {
54
+ [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
55
+ default: D[K];
56
+ }> : P[K];
57
+ };
58
+ type __VLS_Prettify<T> = {
59
+ [K in keyof T]: T[K];
60
+ } & {};
61
+ type __VLS_WithTemplateSlots<T, S> = T & {
62
+ new (): {
63
+ $slots: S;
64
+ };
65
+ };
@@ -0,0 +1,2 @@
1
+ import type { StylePack } from './types';
2
+ export declare const compactStylePack: StylePack;
@@ -0,0 +1,11 @@
1
+ import type { StylePack, PresetItemTypeSpec } from './types';
2
+ /**
3
+ * 全量规格(含已下架类型):事实源保留,供离线门禁校验下架清单与原生实现回归。
4
+ * 对外 API 请勿直接使用本对象,一律以 `glintStylePack.itemTypes` 为准。
5
+ */
6
+ export declare const glintAllItemTypes: Record<string, PresetItemTypeSpec>;
7
+ /**
8
+ * 对外提供的风格包:按 `retired-items.ts` 的下架清单过滤。
9
+ * 规格定义、Java 工厂与 GlintStyleInstaller 注册均保留,从清单移除即可恢复。
10
+ */
11
+ export declare const glintStylePack: StylePack;
@@ -0,0 +1,45 @@
1
+ import { glintStylePack } from './glint';
2
+ import { compactStylePack } from './compact';
3
+ import type { PresetItemOptions, PresetItemRow, StyledRow, StylePack } from './types';
4
+ export type { PresetItemOptions, PresetItemRow, PresetItemTypeSpec, StylePack, StyledRow, QtxStyledListProps, } from './types';
5
+ export { glintStylePack, compactStylePack };
6
+ /** 注册一套 UI 风格包;后续新增风格(如 classic / minimal)走这里,不必改 qtx-list */
7
+ export declare function registerStylePack(pack: StylePack): void;
8
+ export declare function getStylePack(id?: string): StylePack;
9
+ export declare function listStylePacks(): StylePack[];
10
+ /** 所有已注册风格包的 viewType 全集 */
11
+ export declare function listPresetViewTypes(): string[];
12
+ export declare function isKnownPresetViewType(viewType: string): boolean;
13
+ /**
14
+ * 构造一行「内置样式 item」数据,可直接放进 QtxList 的 :items。
15
+ *
16
+ * 写法示例:
17
+ * :items="[
18
+ * presetItem('header', { title: '热门推荐' }),
19
+ * presetItem('poster', { imgUrl: item.cover, title: item.title }, { id: item.id })
20
+ * ]"
21
+ *
22
+ * 产出的行带 viewType;QtxList 会保留它并透传给原生 GridTabsManager 的
23
+ * glint 工厂(视觉与 grid-tabs 完全一致),不走 #item 模板判别。
24
+ */
25
+ export declare function presetItem(type: string, content?: Record<string, unknown>, options?: PresetItemOptions): PresetItemRow;
26
+ /** styledRows 的映射选项 */
27
+ export interface StyledRowsOptions {
28
+ pack?: string;
29
+ typeField?: string;
30
+ keyField?: string;
31
+ }
32
+ /**
33
+ * 业务行数组 → 内置样式行数组(QtxStyledList 的核心映射)。
34
+ *
35
+ * 业务只写 { type: 'poster', title, image, span? };本函数补出 viewType、
36
+ * 校验必填字段、把行级尺寸转成 __span / __aspectRatio 协议字段。
37
+ * 已是 presetItem 产出的行(带已注册 viewType)原样放行,便于混排。
38
+ */
39
+ export declare function styledRows(items?: StyledRow[], options?: StyledRowsOptions): PresetItemRow[];
40
+ /**
41
+ * QtxList 行数据 → 应保留的原生 viewType。
42
+ * 仅放行「已注册风格包」的 viewType,避免业务误写导致原生 FallbackView 降级。
43
+ * 返回 null 表示走原有的 #item 模板判别路径(__disc__ / tpl:*)。
44
+ */
45
+ export declare function resolvePresetViewType(row: Record<string, unknown>): string | null;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * 内置 item 风格包的「不再提供」清单(2026-11-10)。
3
+ *
4
+ * 口径(维护者确认):**规格定义与原生 Java 工厂全部保留**,
5
+ * `GlintStyleInstaller.install()` 仍注册这些 viewType,grid-tabs 的既有 SDUI
6
+ * 数据与历史页面仍可正常渲染;只是 qtx 风格包不再对外提供它们 ——
7
+ * `presetItem()` / `styledRows()` 不接受、`resolvePresetViewType()` 不放行,
8
+ * 文档站、风格画廊、真机验证用例集也不再列出。
9
+ *
10
+ * 恢复方式:从 `RETIRED_ITEM_ALIASES` 移除对应 alias,重跑
11
+ * `npm run docs:device-cases -- --emit` 与 `npm run docs:gen` 即可,
12
+ * 无需改动 glint.ts、用例生成器或任何 Java 代码。
13
+ *
14
+ * 先例:`docs-site/hidden-components.json`(qtx-grid-tabs 暂不对外提供)。
15
+ */
16
+ export declare const RETIRED_ITEMS: {
17
+ readonly reason: "业务页面零使用、文档仅风格包自身引用;按维护者要求精简对外提供的 item 类型。原生实现保留以便随时恢复。";
18
+ readonly updated: "2026-11-10";
19
+ readonly aliases: readonly ["banner", "theme_card", "tool_card"];
20
+ };
21
+ /** 供 glint.ts 过滤;使用可变数组便于离线门禁做集合运算 */
22
+ export declare const RETIRED_ITEM_ALIASES: string[];
@@ -0,0 +1,112 @@
1
+ /**
2
+ * 内置 item 样式(Style Pack)类型定义。
3
+ *
4
+ * 背景:grid-tabs / qtx-glint-items 已有一整套「固定风格」的原生卡片工厂,
5
+ * 以 viewType 字符串注册进 GridTabsManager,业务数据通过 ItemEntity.content 填充。
6
+ * qtx-list 的 #item 插槽有封闭标签白名单(QtxListSDUI §3.1),自定义 Vue 组件
7
+ * 在编译期会被 [QTX-T-EXPR] 回落、运行时被 custom_component 诊断丢弃,因此
8
+ * 「内置 item」不是 Vue 卡片组件,而是「风格包 + 行数据构造器 + 原生工厂视图」。
9
+ *
10
+ * 一套风格包 = 一组 viewType 规格 + 原生安装入口;后续可并列多套风格。
11
+ */
12
+ /** 单个内置 item 类型的规格 */
13
+ export interface PresetItemTypeSpec {
14
+ /** 原生 viewType,必须与 GridTabsManager 注册的工厂名完全一致 */
15
+ viewType: string;
16
+ /** 中文名称,用于文档与 IDE 提示 */
17
+ label: string;
18
+ /** 用途说明 */
19
+ description: string;
20
+ /**
21
+ * content 字段说明(字段名 → 说明)。
22
+ * 只登记对应原生工厂 / View 中**实际读取**的键;由离线用例逐项与 Java 源码比对。
23
+ */
24
+ fields: Record<string, string>;
25
+ /** 必填字段(全部都要提供) */
26
+ required: string[];
27
+ /** 该风格下的默认字段值;业务传入的同名值优先 */
28
+ defaults?: Record<string, unknown>;
29
+ /** 多选一必填:每组至少提供一个键(例如海报图片 poster / image / imgUrl) */
30
+ requiredAnyOf?: string[][];
31
+ /** SDUI 协议声明、但当前原生工厂未读取的字段;写入不会生效,仅作迁移提示 */
32
+ protocolOnly?: string[];
33
+ /** 嵌套数据字段说明(例如 banner 的 banners 数组元素) */
34
+ nestedFields?: Record<string, string>;
35
+ /** 对应的原生工厂 Java 类 */
36
+ factory: string;
37
+ /** 该 viewType 读取 content 的 Java 源码文件(相对 android 目录,用于离线一致性校验) */
38
+ nativeSources: string[];
39
+ }
40
+ /** 一套固定 UI 风格 */
41
+ export interface StylePack {
42
+ id: string;
43
+ name: string;
44
+ description: string;
45
+ /** 原生侧安装入口(宿主需调用,否则 viewType 未注册会走 FallbackView) */
46
+ installer: string;
47
+ /** 视觉实现形态:native = 独立原生工厂;preset = 复用既有工厂的字段预设层 */
48
+ rendering: 'native' | 'preset';
49
+ /** 若 rendering=preset,说明复用了哪套原生风格包 */
50
+ basedOn?: string;
51
+ /** item 类型别名 → 规格 */
52
+ itemTypes: Record<string, PresetItemTypeSpec>;
53
+ }
54
+ /** presetItem 产出的行数据:可直接放进 QtxList 的 :items */
55
+ export interface PresetItemRow {
56
+ [key: string]: unknown;
57
+ /** 原生工厂的 viewType;QtxList 会保留它而不改写为 '__disc__' */
58
+ viewType: string;
59
+ /** 行级协议字段:跨列占位(由 buildRowJson 提升到 ItemEntity.span) */
60
+ __span?: number;
61
+ /** 行级协议字段:单元格宽高比(由 buildRowJson 提升到 ItemEntity.aspectRatio) */
62
+ __aspectRatio?: number;
63
+ }
64
+ /**
65
+ * 业务侧的「样式行」:只需声明卡片类型与业务字段,不必写 viewType。
66
+ * 由 styledRows() / QtxStyledList 转换为 PresetItemRow。
67
+ */
68
+ export interface StyledRow {
69
+ [key: string]: unknown;
70
+ /** 内置 item 类型别名(如 poster);字段名可由 QtxStyledList 的 typeField 改 */
71
+ type?: string;
72
+ /** 已经是 presetItem 产出的行时,带该字段可直接放行 */
73
+ viewType?: string;
74
+ /** 行锚点 */
75
+ id?: string | number;
76
+ /** 跨列数 */
77
+ span?: number;
78
+ /** 单元格宽高比 */
79
+ aspectRatio?: number;
80
+ }
81
+ /** QtxStyledList 容器组件属性;列表布局属性原样透传给 QtxList */
82
+ export interface QtxStyledListProps {
83
+ /** 业务行数据(type + 业务字段),自动映射为内置样式行 */
84
+ items?: StyledRow[];
85
+ /** 风格包 id,默认 'glint' */
86
+ pack?: string;
87
+ /** 类型字段名,默认 'type' */
88
+ typeField?: string;
89
+ /** 行锚点字段名,默认 'id' */
90
+ keyField?: string;
91
+ columns?: number;
92
+ direction?: 'vertical' | 'horizontal';
93
+ gutter?: number;
94
+ itemHeight?: number;
95
+ itemAspectRatio?: number;
96
+ pageEnabled?: boolean;
97
+ loadingTail?: boolean;
98
+ initialFocusIndex?: number;
99
+ }
100
+ /** presetItem 的行级选项 */
101
+ export interface PresetItemOptions {
102
+ /** 行锚点 id */
103
+ id?: string | number;
104
+ /** 行锚点字段名,默认 'id' */
105
+ keyField?: string;
106
+ /** 风格包 id,默认 'glint' */
107
+ pack?: string;
108
+ /** GridLayoutManager 跨列数,默认 1;仅 >=1 的整数生效 */
109
+ span?: number;
110
+ /** 单元格宽高比(宽/高),默认由原生按 viewType 推导;仅 >0 生效 */
111
+ aspectRatio?: number;
112
+ }