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

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 (87) hide show
  1. package/AI_CONTRACT.md +472 -0
  2. package/README.md +174 -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/QtxChannelNav/QtxChannelNav.vue.d.ts +48 -0
  11. package/dist/components/QtxChannelNav/QtxChannelNavBase.vue.d.ts +127 -0
  12. package/dist/components/QtxChannelNav/index.d.ts +13 -0
  13. package/dist/components/QtxChannelNav/types.d.ts +232 -0
  14. package/dist/components/QtxCheckbox/QtxCheckbox.vue.d.ts +110 -0
  15. package/dist/components/QtxCheckbox/index.d.ts +13 -0
  16. package/dist/components/QtxCheckboxGroup/QtxCheckboxGroup.vue.d.ts +103 -0
  17. package/dist/components/QtxCheckboxGroup/index.d.ts +13 -0
  18. package/dist/components/QtxCollapseMenuGroup/QtxCollapseMenuGroup.vue.d.ts +9 -0
  19. package/dist/components/QtxCollapseMenuGroup/QtxCollapseMenuGroupBase.vue.d.ts +40 -0
  20. package/dist/components/QtxCollapseMenuGroup/index.d.ts +13 -0
  21. package/dist/components/QtxCollapseMenuList/QtxCollapseMenuList.vue.d.ts +12 -0
  22. package/dist/components/QtxCollapseMenuList/QtxCollapseMenuListBase.vue.d.ts +32 -0
  23. package/dist/components/QtxCollapseMenuList/index.d.ts +13 -0
  24. package/dist/components/QtxDatePicker/QtxDatePicker.vue.d.ts +28 -0
  25. package/dist/components/QtxDatePicker/index.d.ts +13 -0
  26. package/dist/components/QtxGridTabs/QtxGridTabs.vue.d.ts +11 -0
  27. package/dist/components/QtxGridTabs/index.d.ts +13 -0
  28. package/dist/components/QtxGridTabs/useGridItemPresence.d.ts +26 -0
  29. package/dist/components/QtxGridTabs/useGridTabs.d.ts +163 -0
  30. package/dist/components/QtxGridTabs/useGridTabsData.d.ts +20 -0
  31. package/dist/components/QtxGridTabs/useGridTabsUpdater.d.ts +24 -0
  32. package/dist/components/QtxHsvBackground/QtxHsvBackground.vue.d.ts +26 -0
  33. package/dist/components/QtxHsvBackground/index.d.ts +13 -0
  34. package/dist/components/QtxInputView/QtxInputView.vue.d.ts +42 -0
  35. package/dist/components/QtxInputView/QtxInputViewBase.vue.d.ts +46 -0
  36. package/dist/components/QtxInputView/index.d.ts +13 -0
  37. package/dist/components/QtxKeyboard/QtxKeyboard.vue.d.ts +59 -0
  38. package/dist/components/QtxKeyboard/index.d.ts +13 -0
  39. package/dist/components/QtxList/QtxList.vue.d.ts +96 -0
  40. package/dist/components/QtxList/QtxListBase.vue.d.ts +11 -0
  41. package/dist/components/QtxList/capture.d.ts +86 -0
  42. package/dist/components/QtxList/index.d.ts +13 -0
  43. package/dist/components/QtxList/types.d.ts +78 -0
  44. package/dist/components/QtxNumericKeyboard/QtxNumericKeyboard.vue.d.ts +28 -0
  45. package/dist/components/QtxNumericKeyboard/index.d.ts +13 -0
  46. package/dist/components/QtxPortalItem/QtxPortalItem.vue.d.ts +24 -0
  47. package/dist/components/QtxPortalItem/index.d.ts +13 -0
  48. package/dist/components/QtxPortalPool/QtxPortalPool.vue.d.ts +11 -0
  49. package/dist/components/QtxPortalPool/index.d.ts +13 -0
  50. package/dist/components/QtxPoster/QtxPoster.vue.d.ts +60 -0
  51. package/dist/components/QtxPoster/QtxPosterBase.vue.d.ts +117 -0
  52. package/dist/components/QtxPoster/index.d.ts +13 -0
  53. package/dist/components/QtxPoster/types.d.ts +133 -0
  54. package/dist/components/QtxRadioGroup/QtxRadioGroup.vue.d.ts +103 -0
  55. package/dist/components/QtxRadioGroup/index.d.ts +13 -0
  56. package/dist/components/QtxRatingBar/QtxRatingBar.vue.d.ts +34 -0
  57. package/dist/components/QtxRatingBar/index.d.ts +13 -0
  58. package/dist/components/QtxSettingSwitch/QtxSettingSwitch.vue.d.ts +111 -0
  59. package/dist/components/QtxSettingSwitch/index.d.ts +6 -0
  60. package/dist/components/QtxSvgImage/QtxSvgImage.vue.d.ts +26 -0
  61. package/dist/components/QtxSvgImage/index.d.ts +13 -0
  62. package/dist/components/QtxSwitcher/QtxSwitcher.vue.d.ts +52 -0
  63. package/dist/components/QtxSwitcher/index.d.ts +13 -0
  64. package/dist/components/QtxTabContent/QtxTabContent.vue.d.ts +24 -0
  65. package/dist/components/QtxTabs/QtxTabs.vue.d.ts +37 -0
  66. package/dist/components/QtxTabs/index.d.ts +16 -0
  67. package/dist/core/installQtx.d.ts +40 -0
  68. package/dist/core/portalCoordinator.d.ts +4 -0
  69. package/dist/core/qtxGate.d.ts +13 -0
  70. package/dist/core/theme.d.ts +12 -0
  71. package/dist/directives/v-portal-to.d.ts +4 -0
  72. package/dist/index.d.ts +146 -0
  73. package/dist/modules/AddonEnvModule.d.ts +4 -0
  74. package/dist/modules/ExtraUIConfigModule.d.ts +7 -0
  75. package/dist/modules/GridTabsConfigModule.d.ts +7 -0
  76. package/dist/modules/QtxVersionModule.d.ts +4 -0
  77. package/dist/preset-items/QtxStyledList.vue.d.ts +65 -0
  78. package/dist/preset-items/compact.d.ts +2 -0
  79. package/dist/preset-items/glint.d.ts +11 -0
  80. package/dist/preset-items/index.d.ts +45 -0
  81. package/dist/preset-items/retired-items.d.ts +22 -0
  82. package/dist/preset-items/types.d.ts +112 -0
  83. package/dist/qtx.cjs.js +1 -0
  84. package/dist/qtx.es.js +6847 -0
  85. package/dist/style.css +1 -0
  86. package/dist/types/index.d.ts +50 -0
  87. package/package.json +32 -4
@@ -0,0 +1,78 @@
1
+ /**
2
+ * QtxList 组件签名类型(QtxListSDUI.md 契约)。
3
+ * 独立文件以避免 index.ts ⇄ QtxList.vue 类型循环。
4
+ */
5
+ /** 行数据:键值开放;keyField 指定的字段作为 itemId 锚点(GridTabsSDUI.md §6.13 指令寻址) */
6
+ export interface QtxListItem {
7
+ [key: string]: unknown;
8
+ }
9
+ export interface QtxListProps {
10
+ /** 行数据(普通响应式数组,可直接变更;捕获期可后置填充) */
11
+ items?: QtxListItem[];
12
+ /** 列数:1 = 纵向列表,N = 网格(默认 1) */
13
+ columns?: number;
14
+ /** itemId 锚点字段名(默认 'id';缺失时组件按索引生成稳定 id) */
15
+ keyField?: string;
16
+ /** 滚动方向(默认 'vertical';'horizontal' 随 M3 提供) */
17
+ direction?: 'vertical' | 'horizontal';
18
+ /** 单元格定高(px,网格必填或与 itemAspectRatio 二选一) */
19
+ itemHeight?: number;
20
+ /** 单元格宽高比(与 columns 共同推导高度) */
21
+ itemAspectRatio?: number;
22
+ /** 单元格间距(px,默认 0) */
23
+ gutter?: number;
24
+ /** 启用触底分页(触发 load-more 事件,默认 false) */
25
+ pageEnabled?: boolean;
26
+ /** B2-1:loading 尾卡开关(C 方案)。开启时 load-more 触发自动显示尾卡、数据到达自动隐藏;默认关闭 */
27
+ loadingTail?: boolean;
28
+ /** 初始焦点行索引(默认 0) */
29
+ initialFocusIndex?: number;
30
+ /**
31
+ * 原生直通属性(内部):{"templates":[...],"items":[...]} 原子初始化载荷。
32
+ * 由组件内部捕获管线生成,业务侧无需传。
33
+ */
34
+ initData?: string;
35
+ }
36
+ export interface QtxListItemEvent {
37
+ item: QtxListItem | undefined;
38
+ index: number;
39
+ /** 触发节点(§8.1 事件载荷的 nodeId) */
40
+ nodeId?: string;
41
+ }
42
+ export interface QtxListLoadMoreEvent {
43
+ pageNo: number;
44
+ /** 触发触底的末尾 itemId */
45
+ itemId?: string;
46
+ }
47
+ /** 组件事件全集(§8.1;曝光批次复用 GT §6.15 VIEW_PRESENCE_BATCH) */
48
+ export declare const QTX_LIST_EVENTS: readonly ["item-click", "item-focus", "item-bind", "item-unbind", "load-more"];
49
+ export type QtxListEventName = (typeof QTX_LIST_EVENTS)[number];
50
+ /** ref 暴露方法:与 QtxList.vue 的 defineExpose(listApi) 一一对应;改实现须同步本接口并重跑 docs:gen */
51
+ export interface QtxListExpose {
52
+ /** 取原生节点代理(Base→gate→$el,带 nodeId) */
53
+ getNativeNode(): any;
54
+ /** 单行增量更新(等价 items[index] 局部赋值,走 UPDATE_ITEM) */
55
+ updateItem(index: number, patch: Partial<QtxListItem>): Promise<void>;
56
+ /** 追加数据(APPEND_SUB_ITEMS) */
57
+ addListData(items: QtxListItem[]): Promise<void>;
58
+ /** 头部插入(下拉刷新语义);业务须同步维护本地数组,结构性操作走重建 */
59
+ prependItems(items: QtxListItem[]): void;
60
+ /** 删除指定行;删除前把焦点迁移到相邻幸存行,避免焦点抖动 */
61
+ removeItem(index: number): Promise<void>;
62
+ /** 移动行到目标行之前;from/to 以当前 items 序为准,业务须在改本地数组前调用 */
63
+ moveItemBefore(from: number, to: number): void;
64
+ /** 清空列表(等价 setListData([]),空数据走同实例反射清空) */
65
+ clearItems(): Promise<void>;
66
+ /** 滚动到指定行(smooth=false 立即定位) */
67
+ scrollToIndex(index: number, smooth?: boolean): Promise<void>;
68
+ /** 手动控制 loading 尾卡;hasMore=false 时置 false 可抑制触底反复重显 */
69
+ setLoading(visible: boolean): Promise<void>;
70
+ /** 滚动到可见并聚焦指定行(TAB 切换后落列表首项的官方姿势) */
71
+ focusItem(index: number): Promise<void>;
72
+ /** 全量重设(以传入数组为权威快照;空数组即清空;替换 :items 引用可回到 props 驱动) */
73
+ setListData(items: QtxListItem[]): Promise<void>;
74
+ /** 以下发数据整体刷新(重建通道) */
75
+ refresh(): void;
76
+ /** 通用指令入口(当前实现等价全量刷新) */
77
+ dispatchAction(actions: unknown): void;
78
+ }
@@ -0,0 +1,28 @@
1
+ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
2
+ maxLength?: any;
3
+ }>>, {
4
+ getNativeNode: () => any;
5
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
6
+ onNumberPressed: (payload?: any) => void;
7
+ }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
8
+ maxLength?: any;
9
+ }>>> & Readonly<{
10
+ onOnNumberPressed?: ((payload?: any) => any) | undefined;
11
+ }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
12
+ default?(_: {}): any;
13
+ }>;
14
+ export default _default;
15
+ type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
16
+ type __VLS_TypePropsToRuntimeProps<T> = {
17
+ [K in keyof T]-?: {} extends Pick<T, K> ? {
18
+ type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
19
+ } : {
20
+ type: import('vue').PropType<T[K]>;
21
+ required: true;
22
+ };
23
+ };
24
+ type __VLS_WithTemplateSlots<T, S> = T & {
25
+ new (): {
26
+ $slots: S;
27
+ };
28
+ };
@@ -0,0 +1,13 @@
1
+ import type { App } from 'vue';
2
+ import QtxNumericKeyboard from './QtxNumericKeyboard.vue';
3
+ export declare const QtxNumericKeyboardPlugin: {
4
+ install: (app: App) => void;
5
+ };
6
+ export { QtxNumericKeyboard };
7
+ export default QtxNumericKeyboardPlugin;
8
+ declare module 'vue' {
9
+ interface GlobalComponents {
10
+ QtxNumericKeyboard: typeof QtxNumericKeyboard;
11
+ 'qtx-numeric-keyboard': typeof QtxNumericKeyboard;
12
+ }
13
+ }
@@ -0,0 +1,24 @@
1
+ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
2
+ portalId?: string | undefined;
3
+ }>>, {
4
+ getNativeNode: () => any;
5
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
6
+ portalId?: string | undefined;
7
+ }>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
8
+ default?(_: {}): any;
9
+ }>;
10
+ export default _default;
11
+ type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
12
+ type __VLS_TypePropsToRuntimeProps<T> = {
13
+ [K in keyof T]-?: {} extends Pick<T, K> ? {
14
+ type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
15
+ } : {
16
+ type: import('vue').PropType<T[K]>;
17
+ required: true;
18
+ };
19
+ };
20
+ type __VLS_WithTemplateSlots<T, S> = T & {
21
+ new (): {
22
+ $slots: S;
23
+ };
24
+ };
@@ -0,0 +1,13 @@
1
+ import type { App } from 'vue';
2
+ import QtxPortalItem from './QtxPortalItem.vue';
3
+ export declare const QtxPortalItemPlugin: {
4
+ install: (app: App) => void;
5
+ };
6
+ export { QtxPortalItem };
7
+ export default QtxPortalItemPlugin;
8
+ declare module 'vue' {
9
+ interface GlobalComponents {
10
+ QtxPortalItem: typeof QtxPortalItem;
11
+ 'qtx-portal-item': typeof QtxPortalItem;
12
+ }
13
+ }
@@ -0,0 +1,11 @@
1
+ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<{}, {
2
+ getNativeNode: () => any;
3
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
4
+ default?(_: {}): any;
5
+ }>;
6
+ export default _default;
7
+ type __VLS_WithTemplateSlots<T, S> = T & {
8
+ new (): {
9
+ $slots: S;
10
+ };
11
+ };
@@ -0,0 +1,13 @@
1
+ import type { App } from 'vue';
2
+ import QtxPortalPool from './QtxPortalPool.vue';
3
+ export declare const QtxPortalPoolPlugin: {
4
+ install: (app: App) => void;
5
+ };
6
+ export { QtxPortalPool };
7
+ export default QtxPortalPoolPlugin;
8
+ declare module 'vue' {
9
+ interface GlobalComponents {
10
+ QtxPortalPool: typeof QtxPortalPool;
11
+ 'qtx-portal-pool': typeof QtxPortalPool;
12
+ }
13
+ }
@@ -0,0 +1,60 @@
1
+ import type { QtxPosterProps, QtxPosterState } from './types';
2
+ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<QtxPosterProps>>, {
3
+ getNativeNode(): any;
4
+ setImageSource(source: string, kind?: string | undefined): void;
5
+ setTitle(text: string): void;
6
+ setSubtitle(text: string): void;
7
+ setBadge(badge: Record<string, any> | null): void;
8
+ setPosterType(type: string): void;
9
+ setAspectRatio(ratio: number): void;
10
+ setLoadingState(loading: boolean): void;
11
+ applyPatch(patch: Record<string, any>): void;
12
+ cancelImageLoad(): void;
13
+ clear(): void;
14
+ recycle(): void;
15
+ requestFocus(): Promise<string>;
16
+ getState(): Promise<QtxPosterState>;
17
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
18
+ click: (payload: any) => void;
19
+ focus: (payload: any) => void;
20
+ blur: (payload: any) => void;
21
+ longClick: (payload: any) => void;
22
+ imageLoadStart: (payload: any) => void;
23
+ imageLoadSuccess: (payload: any) => void;
24
+ imageLoadError: (payload: any) => void;
25
+ stateChange: (payload: any) => void;
26
+ bind: (payload: any) => void;
27
+ recycle: (payload: any) => void;
28
+ patch: (payload: any) => void;
29
+ badgeClick: (payload: any) => void;
30
+ }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<QtxPosterProps>>> & Readonly<{
31
+ onBlur?: ((payload: any) => any) | undefined;
32
+ onClick?: ((payload: any) => any) | undefined;
33
+ onFocus?: ((payload: any) => any) | undefined;
34
+ onLongClick?: ((payload: any) => any) | undefined;
35
+ onImageLoadStart?: ((payload: any) => any) | undefined;
36
+ onImageLoadSuccess?: ((payload: any) => any) | undefined;
37
+ onImageLoadError?: ((payload: any) => any) | undefined;
38
+ onStateChange?: ((payload: any) => any) | undefined;
39
+ onBind?: ((payload: any) => any) | undefined;
40
+ onRecycle?: ((payload: any) => any) | undefined;
41
+ onPatch?: ((payload: any) => any) | undefined;
42
+ onBadgeClick?: ((payload: any) => any) | undefined;
43
+ }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
44
+ default?(_: {}): any;
45
+ }>;
46
+ export default _default;
47
+ type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
48
+ type __VLS_TypePropsToRuntimeProps<T> = {
49
+ [K in keyof T]-?: {} extends Pick<T, K> ? {
50
+ type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
51
+ } : {
52
+ type: import('vue').PropType<T[K]>;
53
+ required: true;
54
+ };
55
+ };
56
+ type __VLS_WithTemplateSlots<T, S> = T & {
57
+ new (): {
58
+ $slots: S;
59
+ };
60
+ };
@@ -0,0 +1,117 @@
1
+ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
2
+ poster?: string | undefined;
3
+ image?: string | undefined;
4
+ imgUrl?: string | undefined;
5
+ localSrc?: string | undefined;
6
+ fallbackSrc?: string | undefined;
7
+ scaleType?: string | undefined;
8
+ title?: string | undefined;
9
+ subtitle?: string | undefined;
10
+ floatTitle?: string | undefined;
11
+ floatSubtitle?: string | undefined;
12
+ posterType?: string | undefined;
13
+ textSize?: any;
14
+ textColor?: string | undefined;
15
+ maxLines?: any;
16
+ badge?: any;
17
+ aspectRatio?: any;
18
+ cornerRadius?: any;
19
+ coord?: any;
20
+ state?: string | undefined;
21
+ placeholderColor?: string | undefined;
22
+ loadingDelayMs?: any;
23
+ focusable?: boolean | undefined;
24
+ focusScale?: any;
25
+ focusBorder?: boolean | undefined;
26
+ focusGlow?: boolean | undefined;
27
+ elevationShadow?: boolean | undefined;
28
+ clickPayload?: any;
29
+ focusPayload?: any;
30
+ }>>, {
31
+ getNativeNode: () => any;
32
+ setImageSource: (...args: any[]) => void;
33
+ setTitle: (...args: any[]) => void;
34
+ setSubtitle: (...args: any[]) => void;
35
+ setBadge: (...args: any[]) => void;
36
+ setPosterType: (...args: any[]) => void;
37
+ setAspectRatio: (...args: any[]) => void;
38
+ setLoadingState: (...args: any[]) => void;
39
+ applyPatch: (...args: any[]) => void;
40
+ cancelImageLoad: (...args: any[]) => void;
41
+ clear: (...args: any[]) => void;
42
+ recycle: (...args: any[]) => void;
43
+ requestFocus: (...args: any[]) => void;
44
+ getState: (...args: any[]) => void;
45
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
46
+ onClick: (payload?: any) => void;
47
+ onFocus: (payload?: any) => void;
48
+ onBlur: (payload?: any) => void;
49
+ onLongClick: (payload?: any) => void;
50
+ onImageLoadStart: (payload?: any) => void;
51
+ onImageLoadSuccess: (payload?: any) => void;
52
+ onImageLoadError: (payload?: any) => void;
53
+ onStateChange: (payload?: any) => void;
54
+ onBind: (payload?: any) => void;
55
+ onRecycle: (payload?: any) => void;
56
+ onPatch: (payload?: any) => void;
57
+ onBadgeClick: (payload?: any) => void;
58
+ }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
59
+ poster?: string | undefined;
60
+ image?: string | undefined;
61
+ imgUrl?: string | undefined;
62
+ localSrc?: string | undefined;
63
+ fallbackSrc?: string | undefined;
64
+ scaleType?: string | undefined;
65
+ title?: string | undefined;
66
+ subtitle?: string | undefined;
67
+ floatTitle?: string | undefined;
68
+ floatSubtitle?: string | undefined;
69
+ posterType?: string | undefined;
70
+ textSize?: any;
71
+ textColor?: string | undefined;
72
+ maxLines?: any;
73
+ badge?: any;
74
+ aspectRatio?: any;
75
+ cornerRadius?: any;
76
+ coord?: any;
77
+ state?: string | undefined;
78
+ placeholderColor?: string | undefined;
79
+ loadingDelayMs?: any;
80
+ focusable?: boolean | undefined;
81
+ focusScale?: any;
82
+ focusBorder?: boolean | undefined;
83
+ focusGlow?: boolean | undefined;
84
+ elevationShadow?: boolean | undefined;
85
+ clickPayload?: any;
86
+ focusPayload?: any;
87
+ }>>> & Readonly<{
88
+ onOnBlur?: ((payload?: any) => any) | undefined;
89
+ onOnClick?: ((payload?: any) => any) | undefined;
90
+ onOnFocus?: ((payload?: any) => any) | undefined;
91
+ onOnLongClick?: ((payload?: any) => any) | undefined;
92
+ onOnImageLoadStart?: ((payload?: any) => any) | undefined;
93
+ onOnImageLoadSuccess?: ((payload?: any) => any) | undefined;
94
+ onOnImageLoadError?: ((payload?: any) => any) | undefined;
95
+ onOnStateChange?: ((payload?: any) => any) | undefined;
96
+ onOnBind?: ((payload?: any) => any) | undefined;
97
+ onOnRecycle?: ((payload?: any) => any) | undefined;
98
+ onOnPatch?: ((payload?: any) => any) | undefined;
99
+ onOnBadgeClick?: ((payload?: any) => any) | undefined;
100
+ }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
101
+ default?(_: {}): any;
102
+ }>;
103
+ export default _default;
104
+ type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
105
+ type __VLS_TypePropsToRuntimeProps<T> = {
106
+ [K in keyof T]-?: {} extends Pick<T, K> ? {
107
+ type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
108
+ } : {
109
+ type: import('vue').PropType<T[K]>;
110
+ required: true;
111
+ };
112
+ };
113
+ type __VLS_WithTemplateSlots<T, S> = T & {
114
+ new (): {
115
+ $slots: S;
116
+ };
117
+ };
@@ -0,0 +1,13 @@
1
+ import type { App } from 'vue';
2
+ import QtxPoster from './QtxPoster.vue';
3
+ export declare const QtxPosterPlugin: {
4
+ install: (app: App) => void;
5
+ };
6
+ export { QtxPoster };
7
+ export default QtxPosterPlugin;
8
+ declare module 'vue' {
9
+ interface GlobalComponents {
10
+ QtxPoster: typeof QtxPoster;
11
+ 'qtx-poster': typeof QtxPoster;
12
+ }
13
+ }
@@ -0,0 +1,133 @@
1
+ /**
2
+ * QtxPoster 组件签名类型(海报卡片 SDUI 契约)。
3
+ * 独立文件以避免 index.ts ⇄ QtxPoster.vue 类型循环。
4
+ */
5
+ export interface QtxPosterProps {
6
+ /** 主图地址,三别名优先级 poster > image > imgUrl,默认空 */
7
+ poster?: string;
8
+ /** 主图地址别名(优先级次于 poster),默认空 */
9
+ image?: string;
10
+ /** 主图地址别名(优先级最低),默认空 */
11
+ imgUrl?: string;
12
+ /** 本地图片资源(drawable / assets / file),默认空 */
13
+ localSrc?: string;
14
+ /** 主图加载失败时的兜底图地址,默认空 */
15
+ fallbackSrc?: string;
16
+ /** 图片缩放类型(如 fitCenter / centerCrop),默认 fitCenter */
17
+ scaleType?: string;
18
+ /** 主标题文本,默认空 */
19
+ title?: string;
20
+ /** 副标题文本,默认空 */
21
+ subtitle?: string;
22
+ /** 浮层标题(text_float 版式专用),默认空 */
23
+ floatTitle?: string;
24
+ /** 浮层副标题(text_float 版式专用),默认空 */
25
+ floatSubtitle?: string;
26
+ /** 海报版式:base / text_bottom / text_float,默认 base */
27
+ posterType?: 'base' | 'text_bottom' | 'text_float' | string;
28
+ /** 标题字号,默认 28 */
29
+ textSize?: number;
30
+ /** 标题颜色,默认 #FFFFFF */
31
+ textColor?: string;
32
+ /** 标题最大行数,默认 1 */
33
+ maxLines?: number;
34
+ /** 角标数据(键值开放),默认空 */
35
+ badge?: Record<string, any>;
36
+ /** 卡片宽高比(宽 / 高),默认 0.72 */
37
+ aspectRatio?: number;
38
+ /** 卡片圆角半径(px),默认 12 */
39
+ cornerRadius?: number;
40
+ /** 坐标 / 布局附加参数(键值开放),默认空 */
41
+ coord?: Record<string, any>;
42
+ /** 卡片状态:loading / ready / error,默认 loading */
43
+ state?: 'loading' | 'ready' | 'error' | string;
44
+ /** 占位图背景色,默认 #2E2E2E */
45
+ placeholderColor?: string;
46
+ /** 加载态延迟显示毫秒数,默认 300 */
47
+ loadingDelayMs?: number;
48
+ /** 是否可获焦,默认 true */
49
+ focusable?: boolean;
50
+ /** 获焦缩放倍率,默认 1.05 */
51
+ focusScale?: number;
52
+ /** 是否显示获焦描边,默认 true */
53
+ focusBorder?: boolean;
54
+ /** 是否显示获焦光晕,默认 false */
55
+ focusGlow?: boolean;
56
+ /** 是否启用投影阴影,默认 false */
57
+ elevationShadow?: boolean;
58
+ /** 点击事件附带载荷(键值开放,随 click 事件回传),默认空 */
59
+ clickPayload?: Record<string, any>;
60
+ /** 获焦事件附带载荷(键值开放,随 focus 事件回传),默认空 */
61
+ focusPayload?: Record<string, any>;
62
+ /** 卡片宽度(数字自动补 px),默认 0 */
63
+ width?: number | string;
64
+ /** 卡片高度(数字自动补 px),默认 0 */
65
+ height?: number | string;
66
+ }
67
+ export interface QtxPosterClickPayload {
68
+ /** 条目 ID */
69
+ itemId?: string;
70
+ /** 列表位置索引 */
71
+ position?: number;
72
+ /** 业务自定义载荷 */
73
+ payload?: any;
74
+ /** 事件来源 */
75
+ source?: string;
76
+ /** 事件类别 */
77
+ kind?: string;
78
+ /** 状态变更原因 */
79
+ reason?: string;
80
+ /** 变更前的值 / 状态 */
81
+ from?: string;
82
+ /** 变更后的值 / 状态 */
83
+ to?: string;
84
+ /** 增量更新涉及的键集合 */
85
+ patchKeys?: string[];
86
+ }
87
+ export interface QtxPosterState {
88
+ /** 当前卡片状态 */
89
+ state?: string;
90
+ /** 状态来源 */
91
+ source?: string;
92
+ /** 卡片类别 */
93
+ kind?: string;
94
+ /** 当前海报版式 */
95
+ posterType?: string;
96
+ /** 数据代数(复用 / 增量更新计数) */
97
+ generation?: number;
98
+ /** 是否处于图片加载中 */
99
+ loading?: boolean;
100
+ }
101
+ /** QtxPoster 对外事件全集(camelCase,与 Vue 壳 defineEmits 一一对应) */
102
+ export declare const QTX_POSTER_EVENTS: readonly ["click", "focus", "blur", "longClick", "imageLoadStart", "imageLoadSuccess", "imageLoadError", "stateChange", "bind", "recycle", "patch", "badgeClick"];
103
+ /** ref 暴露方法:与 QtxPoster.vue 的 defineExpose 一一对应;改实现须同步本接口并重跑 docs:gen */
104
+ export interface QtxPosterExpose {
105
+ /** 取原生节点代理(Base→gate→$el,带 nodeId) */
106
+ getNativeNode(): any;
107
+ /** 切换主图来源,kind 指定 local / network / asset 等 */
108
+ setImageSource(source: string, kind?: string): void;
109
+ /** 设置主标题文本 */
110
+ setTitle(text: string): void;
111
+ /** 设置副标题文本 */
112
+ setSubtitle(text: string): void;
113
+ /** 设置或清除角标(传 null 清除) */
114
+ setBadge(badge: Record<string, any> | null): void;
115
+ /** 切换海报版式 */
116
+ setPosterType(type: string): void;
117
+ /** 设置卡片宽高比 */
118
+ setAspectRatio(ratio: number): void;
119
+ /** 显示 / 隐藏加载态 */
120
+ setLoadingState(loading: boolean): void;
121
+ /** 局部增量更新(按 patch 键原位刷新,不重建) */
122
+ applyPatch(patch: Record<string, any>): void;
123
+ /** 取消当前进行中的图片加载 */
124
+ cancelImageLoad(): void;
125
+ /** 清空卡片内容 */
126
+ clear(): void;
127
+ /** 回收并重置卡片(复用前调用) */
128
+ recycle(): void;
129
+ /** 请求焦点,返回聚焦结果标识 */
130
+ requestFocus(): Promise<string>;
131
+ /** 读取当前卡片状态快照 */
132
+ getState(): Promise<QtxPosterState>;
133
+ }
@@ -0,0 +1,103 @@
1
+ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
2
+ modelValue: {
3
+ type: (BooleanConstructor | NumberConstructor | StringConstructor)[];
4
+ default: string;
5
+ };
6
+ options: {
7
+ type: () => Array<{
8
+ label: string;
9
+ value: any;
10
+ disabled?: boolean;
11
+ props?: any;
12
+ }>;
13
+ default: () => never[];
14
+ };
15
+ direction: {
16
+ type: StringConstructor;
17
+ default: string;
18
+ };
19
+ itemWidth: {
20
+ type: NumberConstructor;
21
+ default: undefined;
22
+ };
23
+ itemHeight: {
24
+ type: NumberConstructor;
25
+ default: undefined;
26
+ };
27
+ itemGap: {
28
+ type: NumberConstructor;
29
+ default: number;
30
+ };
31
+ gravity: {
32
+ type: StringConstructor;
33
+ default: string;
34
+ };
35
+ showBackground: {
36
+ type: BooleanConstructor;
37
+ default: boolean;
38
+ };
39
+ }>, {
40
+ groupStyle: import("vue").ComputedRef<{
41
+ display: string;
42
+ flexDirection: any;
43
+ alignItems: string;
44
+ }>;
45
+ getItemStyle: (item: any, index: number) => any;
46
+ onItemClick: (item: any) => void;
47
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("change" | "update:modelValue")[], "change" | "update:modelValue", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
48
+ modelValue: {
49
+ type: (BooleanConstructor | NumberConstructor | StringConstructor)[];
50
+ default: string;
51
+ };
52
+ options: {
53
+ type: () => Array<{
54
+ label: string;
55
+ value: any;
56
+ disabled?: boolean;
57
+ props?: any;
58
+ }>;
59
+ default: () => never[];
60
+ };
61
+ direction: {
62
+ type: StringConstructor;
63
+ default: string;
64
+ };
65
+ itemWidth: {
66
+ type: NumberConstructor;
67
+ default: undefined;
68
+ };
69
+ itemHeight: {
70
+ type: NumberConstructor;
71
+ default: undefined;
72
+ };
73
+ itemGap: {
74
+ type: NumberConstructor;
75
+ default: number;
76
+ };
77
+ gravity: {
78
+ type: StringConstructor;
79
+ default: string;
80
+ };
81
+ showBackground: {
82
+ type: BooleanConstructor;
83
+ default: boolean;
84
+ };
85
+ }>> & Readonly<{
86
+ onChange?: ((...args: any[]) => any) | undefined;
87
+ "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
88
+ }>, {
89
+ direction: string;
90
+ itemHeight: number;
91
+ gravity: string;
92
+ showBackground: boolean;
93
+ modelValue: string | number | boolean;
94
+ options: {
95
+ label: string;
96
+ value: any;
97
+ disabled?: boolean | undefined;
98
+ props?: any;
99
+ }[];
100
+ itemWidth: number;
101
+ itemGap: number;
102
+ }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
103
+ export default _default;
@@ -0,0 +1,13 @@
1
+ import type { App } from 'vue';
2
+ import QtxRadioGroup from './QtxRadioGroup.vue';
3
+ export declare const QtxRadioGroupPlugin: {
4
+ install: (app: App) => void;
5
+ };
6
+ export { QtxRadioGroup };
7
+ export default QtxRadioGroupPlugin;
8
+ declare module 'vue' {
9
+ interface GlobalComponents {
10
+ QtxRadioGroup: typeof QtxRadioGroup;
11
+ 'qtx-radio-group': typeof QtxRadioGroup;
12
+ }
13
+ }
@@ -0,0 +1,34 @@
1
+ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
2
+ numStars?: any;
3
+ rating?: any;
4
+ stepSize?: any;
5
+ isIndicator?: boolean | undefined;
6
+ }>>, {
7
+ getNativeNode: () => any;
8
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
9
+ onRatingChanged: (payload?: any) => void;
10
+ }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
11
+ numStars?: any;
12
+ rating?: any;
13
+ stepSize?: any;
14
+ isIndicator?: boolean | undefined;
15
+ }>>> & Readonly<{
16
+ onOnRatingChanged?: ((payload?: any) => any) | undefined;
17
+ }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
18
+ default?(_: {}): any;
19
+ }>;
20
+ export default _default;
21
+ type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
22
+ type __VLS_TypePropsToRuntimeProps<T> = {
23
+ [K in keyof T]-?: {} extends Pick<T, K> ? {
24
+ type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
25
+ } : {
26
+ type: import('vue').PropType<T[K]>;
27
+ required: true;
28
+ };
29
+ };
30
+ type __VLS_WithTemplateSlots<T, S> = T & {
31
+ new (): {
32
+ $slots: S;
33
+ };
34
+ };