@binblink/wasmnest-plugin-sdk-mobile 0.0.1 → 0.0.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.
- package/README.md +78 -2
- package/README_en.md +64 -2
- package/bin/build.js +4 -2
- package/bin/manifest-gen.js +3 -0
- package/bin/package.js +2 -1
- package/bin/scaffold.js +22 -8
- package/dev-shell/README.md +1 -1
- package/dev-shell/src/apps/mock-terminal/MockTerminalSlotCard.vue +13 -21
- package/dev-shell/src/locales/en-shell.ts +6 -2
- package/dev-shell/src/locales/shell.ts +5 -2
- package/dev-shell/src/mock-context.ts +28 -5
- package/dev-shell/src/shell/adapters/devAppSource.ts +2 -13
- package/dev-shell/src/shell/components/ShellNotificationShade.vue +22 -17
- package/dev-shell/src/shell/components/screens/ShellAppDetailScreen.vue +16 -35
- package/dev-shell/src/shell/components/screens/ShellHomeScreen.vue +58 -17
- package/dev-shell/src/shell/composables/useShellApps.ts +5 -3
- package/dev-shell/src/shell/composables/useShellOpen.ts +12 -3
- package/dev-shell/src/shell/composables/useSlotCarousel.ts +238 -0
- package/dev-shell/src/shell/slotCards.ts +47 -0
- package/dev-shell/src/shell/styles/shell.css +340 -26
- package/dev-shell/src/shell/surfaceIntent.ts +107 -0
- package/dev-shell/src/shell/types.ts +17 -2
- package/dev-shell/src/styles/mobile.css +981 -884
- package/dist/index.d.ts +44 -4
- package/dist/index.js +69 -1
- package/dist/types.d.ts +107 -6
- package/package.json +9 -1
- package/src/index.ts +9 -0
- package/src/types.ts +822 -715
- package/src/ui/AppUpdateSection.d.ts +44 -0
- package/src/ui/AppUpdateSection.vue +253 -0
- package/src/ui/QuickCard.d.ts +33 -0
- package/src/ui/QuickCard.vue +167 -0
- package/src/update.ts +123 -0
|
@@ -41,12 +41,17 @@
|
|
|
41
41
|
min-height: 0;
|
|
42
42
|
}
|
|
43
43
|
|
|
44
|
-
.shell-ui
|
|
44
|
+
/* 同时挂 :root:宿主 chrome 并非都住在 .shell-ui 内——App 根的悬浮导航
|
|
45
|
+
(任意整页路由都要可见)与启动画面都在壳根之外,必须能取到同一套
|
|
46
|
+
结构 / 动效 token,否则 `var(--shell-dur-fast)` 之类的引用会静默失效。 */
|
|
47
|
+
.shell-ui,
|
|
48
|
+
:root {
|
|
45
49
|
/* 壳内结构 token:只定义与平台 token 无关的几何量,避免各处硬编码同一数值 */
|
|
46
50
|
--shell-radius-card: 12px;
|
|
47
51
|
--shell-radius-control: 10px;
|
|
48
52
|
--shell-radius-pill: 999px;
|
|
49
|
-
--shell-radius-lg: 18px; /*
|
|
53
|
+
--shell-radius-lg: 18px; /* 大卡片通用面(弹层 / 分组卡) */
|
|
54
|
+
--shell-radius-recents: 12px; /* 多任务卡单独一档(2026-11-06 用户反馈「太圆」,与桌面 10px 同一收紧口径) */
|
|
50
55
|
--shell-radius-sheet: 16px; /* 底部抽屉面板 */
|
|
51
56
|
/* 应用图标规格(列表行 / 宫格运行卡 / 多任务预览位):同一图标同一尺寸策略 */
|
|
52
57
|
--shell-icon-row: 32px;
|
|
@@ -64,13 +69,14 @@
|
|
|
64
69
|
--shell-dur-fast: 150ms; /* 按压反馈、色值切换等即时响应 */
|
|
65
70
|
--shell-dur-base: 240ms; /* 屏幕栈 / 抽屉 / 覆盖层等空间位移 */
|
|
66
71
|
--shell-dur-slow: 320ms; /* 大件入场、内容展开 */
|
|
67
|
-
|
|
72
|
+
/* 入场用强减速曲线(Emil Kowalski 动效技能 animate / AUDIT.md):内置 ease-out
|
|
73
|
+
与 Material decelerate 前段都太软,用户注视的那一下会显得迟滞。
|
|
74
|
+
退场仍保留加速曲线(ui-ux-pro-max Easing:到达减速、离开加速)。 */
|
|
75
|
+
--shell-ease-out: cubic-bezier(0.23, 1, 0.32, 1);
|
|
68
76
|
--shell-ease-in: cubic-bezier(0.4, 0, 1, 1);
|
|
69
77
|
--shell-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
|
|
70
78
|
/* 系统宫格图标与桌面壳同口径:中性 card 表面 + stroke 线稿(样式见
|
|
71
79
|
.shell-sys-tile)。不按入口上色,双端保持同一套图标语言(2026-10-23)。 */
|
|
72
|
-
/* 快捷磁贴 hover 光晕:由强调色派生,随主题与色板变化(原为硬编码青色 rgba) */
|
|
73
|
-
--shell-action-glow: 0 0 15px color-mix(in srgb, var(--mobile-accent) 12%, transparent);
|
|
74
80
|
}
|
|
75
81
|
|
|
76
82
|
/* ============================================================================
|
|
@@ -230,11 +236,17 @@
|
|
|
230
236
|
横向位移用 26% 而非 100%:与移动端系统「上一级屏幕轻微后退」的手感一致,
|
|
231
237
|
全屏位移在低端机上容易掉帧。
|
|
232
238
|
============================================================================ */
|
|
233
|
-
|
|
239
|
+
/* 入场减速到达、退场加速离开:同一条 transition 声明会让退场也减速,
|
|
240
|
+
看起来像「被拖回去」而不是「被推走」。 */
|
|
241
|
+
.shell-screen-enter-active {
|
|
242
|
+
transition:
|
|
243
|
+
transform var(--shell-dur-base) var(--shell-ease-out),
|
|
244
|
+
opacity var(--shell-dur-base) var(--shell-ease-out);
|
|
245
|
+
}
|
|
234
246
|
.shell-screen-leave-active {
|
|
235
247
|
transition:
|
|
236
|
-
transform var(--shell-dur-base) var(--shell-ease-
|
|
237
|
-
opacity var(--shell-dur-base) var(--shell-ease-
|
|
248
|
+
transform var(--shell-dur-base) var(--shell-ease-in),
|
|
249
|
+
opacity var(--shell-dur-base) var(--shell-ease-in);
|
|
238
250
|
}
|
|
239
251
|
|
|
240
252
|
.shell-screen-forward-enter-from {
|
|
@@ -259,10 +271,17 @@
|
|
|
259
271
|
进入时当前屏缩下去、多任务屏放大浮现;退出时反向,卡片像从应用窗口拉开。 */
|
|
260
272
|
.shell-screen-recents-enter-active,
|
|
261
273
|
.shell-screen-recents-leave-active {
|
|
274
|
+
transform-origin: center center;
|
|
275
|
+
}
|
|
276
|
+
.shell-screen-recents-enter-active {
|
|
262
277
|
transition:
|
|
263
278
|
transform var(--shell-dur-base) var(--shell-ease-out),
|
|
264
279
|
opacity var(--shell-dur-base) var(--shell-ease-out);
|
|
265
|
-
|
|
280
|
+
}
|
|
281
|
+
.shell-screen-recents-leave-active {
|
|
282
|
+
transition:
|
|
283
|
+
transform var(--shell-dur-base) var(--shell-ease-in),
|
|
284
|
+
opacity var(--shell-dur-base) var(--shell-ease-in);
|
|
266
285
|
}
|
|
267
286
|
.shell-screen-recents-enter-from {
|
|
268
287
|
transform: scale(0.9);
|
|
@@ -282,10 +301,13 @@
|
|
|
282
301
|
/* ============================================================================
|
|
283
302
|
底部抽屉(胶囊菜单 / 授权弹窗共用)
|
|
284
303
|
============================================================================ */
|
|
285
|
-
|
|
286
|
-
.shell-sheet-
|
|
304
|
+
/* 抽屉:入场 320ms 减速落位,退场 240ms 加速离场(系统响应比用户决定更快)。 */
|
|
305
|
+
.shell-sheet-enter-active {
|
|
287
306
|
transition: transform var(--shell-dur-slow) var(--shell-ease-out);
|
|
288
307
|
}
|
|
308
|
+
.shell-sheet-leave-active {
|
|
309
|
+
transition: transform var(--shell-dur-base) var(--shell-ease-in);
|
|
310
|
+
}
|
|
289
311
|
.shell-sheet-enter-from,
|
|
290
312
|
.shell-sheet-leave-to {
|
|
291
313
|
transform: translateY(100%);
|
|
@@ -301,18 +323,24 @@
|
|
|
301
323
|
}
|
|
302
324
|
|
|
303
325
|
/* ============================================================================
|
|
304
|
-
|
|
326
|
+
字母头像(LetterAvatar 用)
|
|
305
327
|
----------------------------------------------------------------------------
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
328
|
+
2026-11-05 unslop 审核:六组彩虹渐变(靛 / 蓝 / 绿 / 琥珀 / 粉 / 青)退役。
|
|
329
|
+
头像底不是主题语义面,但仍属于宿主 chrome——用一层 accent tint + secondary
|
|
330
|
+
文字 + hairline,与桌面端收敛后的做法一致;不同 seed 只由首字母区分,
|
|
331
|
+
不再用色相区分。
|
|
309
332
|
============================================================================ */
|
|
310
|
-
.shell-avatar-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
333
|
+
.shell-avatar-tint {
|
|
334
|
+
background: color-mix(in srgb, var(--mobile-accent) 12%, var(--mobile-bg-card));
|
|
335
|
+
border: 1px solid var(--mobile-border);
|
|
336
|
+
color: var(--mobile-text-secondary);
|
|
337
|
+
}
|
|
338
|
+
|
|
339
|
+
/* 分组卡片的默认悬浮影:ShellGroupCard 只给形状与分隔线,投影属于壳的
|
|
340
|
+
材质语汇(主题可整条覆盖;写进组件 inline style 会压过主题规则)。 */
|
|
341
|
+
.shell-group-card {
|
|
342
|
+
box-shadow: var(--mobile-card-shadow);
|
|
343
|
+
}
|
|
316
344
|
|
|
317
345
|
/* ============================================================================
|
|
318
346
|
系统宫格图标瓦片(与桌面壳同口径,.shell-sys-tile)
|
|
@@ -490,11 +518,15 @@
|
|
|
490
518
|
/* ============================================================================
|
|
491
519
|
通知栏(Android 式独立覆盖层:自顶部滑下)
|
|
492
520
|
============================================================================ */
|
|
493
|
-
.shell-shade-enter-active
|
|
521
|
+
.shell-shade-enter-active {
|
|
522
|
+
transition:
|
|
523
|
+
transform var(--shell-dur-base) var(--shell-ease-out),
|
|
524
|
+
opacity var(--shell-dur-fast) var(--shell-ease-out);
|
|
525
|
+
}
|
|
494
526
|
.shell-shade-leave-active {
|
|
495
527
|
transition:
|
|
496
|
-
transform var(--shell-dur-base) var(--shell-ease-
|
|
497
|
-
opacity var(--shell-dur-fast) var(--shell-ease-
|
|
528
|
+
transform var(--shell-dur-base) var(--shell-ease-in),
|
|
529
|
+
opacity var(--shell-dur-fast) var(--shell-ease-in);
|
|
498
530
|
}
|
|
499
531
|
.shell-shade-enter-from,
|
|
500
532
|
.shell-shade-leave-to {
|
|
@@ -555,6 +587,30 @@
|
|
|
555
587
|
min-width: 0;
|
|
556
588
|
scroll-snap-align: start;
|
|
557
589
|
}
|
|
590
|
+
/* 整卡按钮:宿主接管点击(启动并打开贡献方应用),卡片内容不得再嵌套交互控件 */
|
|
591
|
+
.shell-slot-card {
|
|
592
|
+
display: block;
|
|
593
|
+
width: 100%;
|
|
594
|
+
height: 100%;
|
|
595
|
+
padding: 0;
|
|
596
|
+
border: 0;
|
|
597
|
+
border-radius: var(--shell-radius-card);
|
|
598
|
+
background: none;
|
|
599
|
+
color: inherit;
|
|
600
|
+
text-align: left;
|
|
601
|
+
-webkit-tap-highlight-color: transparent;
|
|
602
|
+
transition:
|
|
603
|
+
opacity var(--shell-dur-fast) var(--shell-ease-standard),
|
|
604
|
+
transform var(--shell-dur-fast) var(--shell-ease-standard);
|
|
605
|
+
}
|
|
606
|
+
.shell-slot-card:active {
|
|
607
|
+
opacity: 0.86;
|
|
608
|
+
transform: scale(0.985);
|
|
609
|
+
}
|
|
610
|
+
.shell-slot-card:focus-visible {
|
|
611
|
+
outline: 2px solid var(--mobile-accent);
|
|
612
|
+
outline-offset: 2px;
|
|
613
|
+
}
|
|
558
614
|
|
|
559
615
|
/* ============================================================================
|
|
560
616
|
应用运行页胶囊(菜单 / 多任务 / 回主屏)
|
|
@@ -589,6 +645,145 @@
|
|
|
589
645
|
background: var(--mobile-border);
|
|
590
646
|
}
|
|
591
647
|
|
|
648
|
+
/* ============================================================================
|
|
649
|
+
悬浮导航(Liquid Glass 材质)
|
|
650
|
+
----------------------------------------------------------------------------
|
|
651
|
+
用户明确要求「类似苹果手机的透明玻璃,形状是拉长的按钮」:横向胶囊
|
|
652
|
+
(约 133 × 56,两个 48 × 44 的图标键 + 中间细分隔),半透明材质 + 背景
|
|
653
|
+
模糊 + 极细描边 + 顶部高光。整壳只此一处,且默认关闭;材质只承担导航
|
|
654
|
+
控件,不铺到任何内容层。
|
|
655
|
+
三层降级(材质必须始终可读):
|
|
656
|
+
· 不支持 backdrop-filter → 实色卡片底
|
|
657
|
+
· 用户开启「减少透明」 → 实色卡片底,不做模糊
|
|
658
|
+
· 减少动效 → 去掉入场动画与按压缩放,只留状态色
|
|
659
|
+
位置由组件写 transform(left/top 只是基准点),拖动时不触发布局。
|
|
660
|
+
============================================================================ */
|
|
661
|
+
.shell-floatnav {
|
|
662
|
+
position: fixed;
|
|
663
|
+
left: 0;
|
|
664
|
+
top: 0;
|
|
665
|
+
/* 宿主弹层(抽屉 / 通知栏 / 启动画面)均为 z-50+:悬浮条在它们之下,
|
|
666
|
+
弹层打开时由遮罩自然盖住,不抢弹窗的交互 */
|
|
667
|
+
z-index: 40;
|
|
668
|
+
display: flex;
|
|
669
|
+
align-items: center;
|
|
670
|
+
gap: 12px;
|
|
671
|
+
padding: 6px;
|
|
672
|
+
border-radius: var(--shell-radius-pill);
|
|
673
|
+
border: 1px solid color-mix(in srgb, var(--mobile-text-primary) 16%, transparent);
|
|
674
|
+
background: color-mix(in srgb, var(--mobile-bg-card) 72%, transparent);
|
|
675
|
+
-webkit-backdrop-filter: blur(26px) saturate(200%);
|
|
676
|
+
backdrop-filter: blur(26px) saturate(200%);
|
|
677
|
+
box-shadow:
|
|
678
|
+
0 10px 28px color-mix(in srgb, var(--mobile-overlay) 40%, transparent),
|
|
679
|
+
0 1px 3px color-mix(in srgb, var(--mobile-overlay) 30%, transparent),
|
|
680
|
+
inset 0 1px 0 color-mix(in srgb, var(--mobile-text-primary) 22%, transparent),
|
|
681
|
+
inset 0 -1px 0 color-mix(in srgb, var(--mobile-overlay) 22%, transparent);
|
|
682
|
+
opacity: 0;
|
|
683
|
+
touch-action: none;
|
|
684
|
+
user-select: none;
|
|
685
|
+
-webkit-user-select: none;
|
|
686
|
+
-webkit-touch-callout: none;
|
|
687
|
+
cursor: grab;
|
|
688
|
+
transition:
|
|
689
|
+
opacity var(--shell-dur-fast) var(--shell-ease-standard),
|
|
690
|
+
box-shadow var(--shell-dur-fast) var(--shell-ease-standard);
|
|
691
|
+
animation: shell-floatnav-in var(--shell-dur-base) var(--shell-ease-out);
|
|
692
|
+
}
|
|
693
|
+
/* 玻璃高光面:斜向薄薄一层,让胶囊读作有厚度的材质而不是一块半透明色 */
|
|
694
|
+
.shell-floatnav::before {
|
|
695
|
+
content: '';
|
|
696
|
+
position: absolute;
|
|
697
|
+
inset: 1px;
|
|
698
|
+
border-radius: inherit;
|
|
699
|
+
background: linear-gradient(
|
|
700
|
+
155deg,
|
|
701
|
+
color-mix(in srgb, var(--mobile-text-primary) 13%, transparent) 0%,
|
|
702
|
+
color-mix(in srgb, var(--mobile-text-primary) 4%, transparent) 42%,
|
|
703
|
+
transparent 72%
|
|
704
|
+
);
|
|
705
|
+
pointer-events: none;
|
|
706
|
+
}
|
|
707
|
+
.shell-floatnav.is-ready {
|
|
708
|
+
opacity: 1;
|
|
709
|
+
}
|
|
710
|
+
.shell-floatnav:not(.is-ready) {
|
|
711
|
+
/* 尺寸未量到前不接收点击:避免首帧位置未定时被误触 */
|
|
712
|
+
pointer-events: none;
|
|
713
|
+
}
|
|
714
|
+
.shell-floatnav.is-dragging {
|
|
715
|
+
cursor: grabbing;
|
|
716
|
+
box-shadow:
|
|
717
|
+
0 18px 42px color-mix(in srgb, var(--mobile-overlay) 52%, transparent),
|
|
718
|
+
0 3px 8px color-mix(in srgb, var(--mobile-overlay) 34%, transparent),
|
|
719
|
+
inset 0 1px 0 color-mix(in srgb, var(--mobile-text-primary) 28%, transparent),
|
|
720
|
+
inset 0 -1px 0 color-mix(in srgb, var(--mobile-overlay) 26%, transparent);
|
|
721
|
+
}
|
|
722
|
+
.shell-floatnav:focus-visible {
|
|
723
|
+
outline: 2px solid var(--mobile-accent);
|
|
724
|
+
outline-offset: 3px;
|
|
725
|
+
}
|
|
726
|
+
.shell-floatnav-btn {
|
|
727
|
+
position: relative;
|
|
728
|
+
z-index: 1;
|
|
729
|
+
display: flex;
|
|
730
|
+
align-items: center;
|
|
731
|
+
justify-content: center;
|
|
732
|
+
/* 横向略宽于触控最小值:胶囊因此读作「拉长的按钮」而不是两个圆点 */
|
|
733
|
+
width: 48px;
|
|
734
|
+
height: var(--mobile-touch-target-min);
|
|
735
|
+
border-radius: var(--shell-radius-pill);
|
|
736
|
+
color: var(--mobile-text-primary);
|
|
737
|
+
transition:
|
|
738
|
+
background-color var(--shell-dur-fast) var(--shell-ease-standard),
|
|
739
|
+
transform var(--shell-dur-fast) var(--shell-ease-out);
|
|
740
|
+
}
|
|
741
|
+
.shell-floatnav-btn:active {
|
|
742
|
+
background: color-mix(in srgb, var(--mobile-accent) 20%, transparent);
|
|
743
|
+
/* 只缩放图标按钮的视觉,不改胶囊位置(transform 由外层承担) */
|
|
744
|
+
transform: scale(0.94);
|
|
745
|
+
}
|
|
746
|
+
/* 无可返回目标(已在主屏且无覆盖层):置灰但保留占位——胶囊宽度不随面态跳,
|
|
747
|
+
也不给「能点」的假象;按压反馈一并撤掉 */
|
|
748
|
+
.shell-floatnav-btn:disabled,
|
|
749
|
+
.shell-floatnav-btn:disabled:active {
|
|
750
|
+
color: color-mix(in srgb, var(--mobile-text-primary) 34%, transparent);
|
|
751
|
+
background: none;
|
|
752
|
+
transform: none;
|
|
753
|
+
}
|
|
754
|
+
.shell-floatnav-divider {
|
|
755
|
+
position: relative;
|
|
756
|
+
z-index: 1;
|
|
757
|
+
width: 1px;
|
|
758
|
+
height: 18px;
|
|
759
|
+
background: color-mix(in srgb, var(--mobile-border-active) 64%, transparent);
|
|
760
|
+
}
|
|
761
|
+
|
|
762
|
+
/* 不支持背景模糊:玻璃退化为实色卡片(文字对比不变) */
|
|
763
|
+
@supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
|
|
764
|
+
.shell-floatnav {
|
|
765
|
+
background: var(--mobile-bg-card);
|
|
766
|
+
}
|
|
767
|
+
}
|
|
768
|
+
|
|
769
|
+
/* 系统「减少透明」:与不支持模糊同口径,不做半透明 */
|
|
770
|
+
@media (prefers-reduced-transparency: reduce) {
|
|
771
|
+
.shell-floatnav {
|
|
772
|
+
background: var(--mobile-bg-card);
|
|
773
|
+
-webkit-backdrop-filter: none;
|
|
774
|
+
backdrop-filter: none;
|
|
775
|
+
}
|
|
776
|
+
}
|
|
777
|
+
|
|
778
|
+
@keyframes shell-floatnav-in {
|
|
779
|
+
from {
|
|
780
|
+
opacity: 0;
|
|
781
|
+
}
|
|
782
|
+
to {
|
|
783
|
+
opacity: 1;
|
|
784
|
+
}
|
|
785
|
+
}
|
|
786
|
+
|
|
592
787
|
/* ============================================================================
|
|
593
788
|
多任务卡片布局(2026-10-21:对齐桌面多任务)
|
|
594
789
|
----------------------------------------------------------------------------
|
|
@@ -629,7 +824,10 @@
|
|
|
629
824
|
max-width: 214px;
|
|
630
825
|
aspect-ratio: 3 / 4;
|
|
631
826
|
min-width: 0;
|
|
632
|
-
|
|
827
|
+
/* 圆角单独一档(2026-11-06 用户反馈「太圆」):`--shell-radius-lg` 是 18px 的
|
|
828
|
+
大圆角面口径,给多任务卡用显得像药丸。卡片用 12px,与桌面 .ts-card 的
|
|
829
|
+
10px 同一收紧口径,卡片边界更硬朗。卡片专用 token,不动其他面。 */
|
|
830
|
+
border-radius: var(--shell-radius-recents);
|
|
633
831
|
/* 边框线不再显示(2026-10-25 用户裁决,对齐桌面 .ts-card 的强调口径):
|
|
634
832
|
保留 1px 宽度防内容抖动,颜色透明——卡片边界交给底色差与投影。 */
|
|
635
833
|
border: 1px solid transparent;
|
|
@@ -647,13 +845,68 @@
|
|
|
647
845
|
box-shadow: 0 14px 36px color-mix(in srgb, var(--mobile-text-primary) 16%, transparent);
|
|
648
846
|
}
|
|
649
847
|
/* 拖拽期间关掉过渡与入场动画并开启 will-change:抬手后交回 CSS 过渡,
|
|
650
|
-
否则手指与卡片之间会慢半拍,入场动画也会盖掉跟手位移。
|
|
848
|
+
否则手指与卡片之间会慢半拍,入场动画也会盖掉跟手位移。
|
|
849
|
+
位移经 CSS 变量由 pointermove 直写(rAF 合帧,F6)——逐帧移动不重建 vnode。 */
|
|
651
850
|
.shell-recents-grid--dragging .shell-recents-grid-inner,
|
|
652
851
|
.shell-recents-grid--dragging .shell-recents-card {
|
|
653
852
|
animation: none;
|
|
654
853
|
transition: none;
|
|
655
854
|
will-change: transform;
|
|
656
855
|
}
|
|
856
|
+
.shell-recents-grid--dragging .shell-recents-grid-inner {
|
|
857
|
+
transform: translate3d(var(--grid-nudge, 0px), 0, 0);
|
|
858
|
+
}
|
|
859
|
+
/* 上滑关闭跟手:只有被拖的那张卡带 is-dragging(class 一次手势变一次) */
|
|
860
|
+
.shell-recents-card.is-dragging {
|
|
861
|
+
transform: translate3d(0, var(--drag-y, 0px), 0);
|
|
862
|
+
opacity: var(--drag-opacity, 1);
|
|
863
|
+
}
|
|
864
|
+
|
|
865
|
+
/* ============================================================================
|
|
866
|
+
关闭渐隐(单关 / 全关 两种语义,2026-11-12)
|
|
867
|
+
----------------------------------------------------------------------------
|
|
868
|
+
单关 = 只有这一张原地淡出(基础时长,强减速曲线——关闭是「已经决定了」的动作,
|
|
869
|
+
不留拖尾);全部关闭 = 同一条渐隐 + 按序错峰(+22ms/张,封顶 5 步)+ 下沉 / 缩小
|
|
870
|
+
多一点 + 时长收到 fast,整组读成「一次清场」。位移只走 transform / opacity;
|
|
871
|
+
交错延迟与上滑方向由组件内联注入(--recents-close-delay / --recents-close-y)。
|
|
872
|
+
渐隐期间卡片仍是渲染清单里的一个 flex 项(幽灵占位):布局不在卡还看得见时
|
|
873
|
+
收拢,窗口结束后整组一次性落位。
|
|
874
|
+
============================================================================ */
|
|
875
|
+
.shell-recents-card.is-closing {
|
|
876
|
+
pointer-events: none;
|
|
877
|
+
/* 关闭操作不需要入场动画;animation 关掉才不会盖住过渡的 transform */
|
|
878
|
+
animation: none;
|
|
879
|
+
opacity: 0;
|
|
880
|
+
transform: translate3d(0, var(--recents-close-y, 10px), 0) scale(0.96);
|
|
881
|
+
transition:
|
|
882
|
+
opacity var(--shell-dur-base) var(--shell-ease-out),
|
|
883
|
+
transform var(--shell-dur-base) var(--shell-ease-out);
|
|
884
|
+
transition-delay: var(--recents-close-delay, 0ms);
|
|
885
|
+
}
|
|
886
|
+
/* 全部关闭:整组一起退场,每张多下沉 / 多缩一点,时长收到 fast——张数多时逐张
|
|
887
|
+
240ms 会读成「排队」 */
|
|
888
|
+
.shell-recents-grid--clearing .shell-recents-card.is-closing {
|
|
889
|
+
transform: translate3d(0, var(--recents-close-y, 16px), 0) scale(0.94);
|
|
890
|
+
transition-duration: var(--shell-dur-fast);
|
|
891
|
+
}
|
|
892
|
+
/* 关闭中的缩略区:实例已停用,品牌卡回退也跟着熄掉——只留缩略区底色,像屏幕熄灭;
|
|
893
|
+
不遮的话会在渐隐中途闪一张明亮的品牌渐变卡 */
|
|
894
|
+
.shell-recents-card.is-closing .shell-live-fallback {
|
|
895
|
+
opacity: 0;
|
|
896
|
+
}
|
|
897
|
+
|
|
898
|
+
/* 空态:清场 / 关掉最后一张后淡入,避免「一片空白突然出现」 */
|
|
899
|
+
.shell-recents-empty {
|
|
900
|
+
animation: shell-recents-empty-in var(--shell-dur-base) var(--shell-ease-out) backwards;
|
|
901
|
+
}
|
|
902
|
+
@keyframes shell-recents-empty-in {
|
|
903
|
+
from {
|
|
904
|
+
opacity: 0;
|
|
905
|
+
}
|
|
906
|
+
to {
|
|
907
|
+
opacity: 1;
|
|
908
|
+
}
|
|
909
|
+
}
|
|
657
910
|
|
|
658
911
|
/* 信息条:图标打头 + 名称(异常态才追加状态行)。右侧 44px 留给关闭键,
|
|
659
912
|
padding 让名称 / 状态不钻到关闭键下面。 */
|
|
@@ -703,6 +956,7 @@
|
|
|
703
956
|
运行中给一层可辨的水洗底(success-muted 在浅色主题下几乎不可见,用 color-mix
|
|
704
957
|
把实色按比例混进底面色);状态另有信息条文字冗余,不靠颜色单独传达。 */
|
|
705
958
|
.shell-recents-thumb {
|
|
959
|
+
position: relative;
|
|
706
960
|
flex: 1;
|
|
707
961
|
min-height: 0;
|
|
708
962
|
display: flex;
|
|
@@ -726,6 +980,51 @@
|
|
|
726
980
|
white-space: nowrap;
|
|
727
981
|
}
|
|
728
982
|
|
|
983
|
+
/* 缩略区 = 真实实例的当前页面(2026-10-30 用户裁决,与桌面同口径)。
|
|
984
|
+
实例容器由注册表搬进来:固定整幅尺寸 + transform 等比缩放(布局不重排、
|
|
985
|
+
滚动 / 输入原样),卡片 overflow:hidden 裁掉多余部分;contain 把实例的
|
|
986
|
+
绘制关在卡片里,普通 fixed / absolute 弹层也跟着缩进卡片。
|
|
987
|
+
**不留内边距**:缩略区必须整块交给实例(2026-11-06 用户裁决「内容应该跟着
|
|
988
|
+
卡片宽高铺满显示区域」),留 padding 会让画面四周空出一圈纸边。 */
|
|
989
|
+
.shell-live {
|
|
990
|
+
position: absolute;
|
|
991
|
+
inset: 0;
|
|
992
|
+
overflow: hidden;
|
|
993
|
+
contain: layout paint;
|
|
994
|
+
background: var(--mobile-bg-primary);
|
|
995
|
+
}
|
|
996
|
+
/* 品牌卡 fallback:与真实画面对齐同一盒子,切换不引起布局变化。
|
|
997
|
+
padding 只作用于 fallback 自身(图标 + 元信息的呼吸位),不影响实例画面。 */
|
|
998
|
+
.shell-live-fallback {
|
|
999
|
+
position: absolute;
|
|
1000
|
+
inset: 0;
|
|
1001
|
+
display: flex;
|
|
1002
|
+
flex-direction: column;
|
|
1003
|
+
align-items: center;
|
|
1004
|
+
justify-content: center;
|
|
1005
|
+
gap: 8px;
|
|
1006
|
+
padding: 12px 10px;
|
|
1007
|
+
pointer-events: none;
|
|
1008
|
+
transition: opacity var(--shell-dur-fast) var(--shell-ease-standard);
|
|
1009
|
+
}
|
|
1010
|
+
.shell-live-fallback.is-hidden {
|
|
1011
|
+
opacity: 0;
|
|
1012
|
+
}
|
|
1013
|
+
/* 实例容器挂载点:填满卡片 + 裁切;就绪后短淡入(只动 opacity) */
|
|
1014
|
+
.shell-live-surface {
|
|
1015
|
+
position: absolute;
|
|
1016
|
+
inset: 0;
|
|
1017
|
+
width: 100%;
|
|
1018
|
+
height: 100%;
|
|
1019
|
+
overflow: hidden;
|
|
1020
|
+
opacity: 0;
|
|
1021
|
+
pointer-events: none;
|
|
1022
|
+
transition: opacity var(--shell-dur-fast) var(--shell-ease-standard);
|
|
1023
|
+
}
|
|
1024
|
+
.shell-live[data-live-state='live'] .shell-live-surface {
|
|
1025
|
+
opacity: 1;
|
|
1026
|
+
}
|
|
1027
|
+
|
|
729
1028
|
/* 唯一打开动作:覆盖整张卡的空按钮(视觉层 pointer-events:none)。
|
|
730
1029
|
层序在关闭键之下;按压反馈铺一层半透明强调色,不改变布局边界。 */
|
|
731
1030
|
.shell-recents-open {
|
|
@@ -820,11 +1119,21 @@
|
|
|
820
1119
|
.shell-shade-leave-active,
|
|
821
1120
|
.shell-recents-grid-inner,
|
|
822
1121
|
.shell-recents-card,
|
|
1122
|
+
.shell-recents-card.is-closing,
|
|
1123
|
+
.shell-recents-empty,
|
|
1124
|
+
.shell-live-fallback,
|
|
1125
|
+
.shell-live-surface,
|
|
823
1126
|
.shell-reveal,
|
|
1127
|
+
.shell-floatnav,
|
|
824
1128
|
.notify-card--flee {
|
|
825
1129
|
transition-duration: 0.01ms;
|
|
826
1130
|
animation: none;
|
|
827
1131
|
}
|
|
1132
|
+
/* 关闭渐隐也不能等交错延迟(delay 是内联变量,只有 !important 压得住) */
|
|
1133
|
+
.shell-recents-card.is-closing {
|
|
1134
|
+
transition-delay: 0ms !important;
|
|
1135
|
+
transform: none;
|
|
1136
|
+
}
|
|
828
1137
|
/* 位移 / 缩放型过渡收敛为瞬时 */
|
|
829
1138
|
.notify-card,
|
|
830
1139
|
.notify-list-move,
|
|
@@ -832,10 +1141,15 @@
|
|
|
832
1141
|
.shell-segmented button,
|
|
833
1142
|
.shell-icon-action,
|
|
834
1143
|
.shell-capsule-btn,
|
|
1144
|
+
.shell-floatnav-btn,
|
|
835
1145
|
.shell-btn-danger-outline,
|
|
836
1146
|
.shell-btn-danger-text,
|
|
837
1147
|
.shell-sys-tile,
|
|
1148
|
+
.shell-slot-card,
|
|
838
1149
|
.shell-run-backdrop {
|
|
839
1150
|
transition-duration: 0.01ms;
|
|
840
1151
|
}
|
|
1152
|
+
.shell-slot-card:active {
|
|
1153
|
+
transform: none;
|
|
1154
|
+
}
|
|
841
1155
|
}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 运行面入口意图通道(dev-shell 版;与宿主 shell/surfaceIntent.ts 同构)
|
|
3
|
+
* -----------------------------------------------------------------------------
|
|
4
|
+
* 场景:应用在首页快捷卡片上写「3 个活跃会话」,点击应直接进入某个会话,而不是
|
|
5
|
+
* 只停在应用门口。每应用运行面是独立 Vue 应用、且切走保活不重挂,所以入口不能
|
|
6
|
+
* 靠「首次挂载参数」传——必须是**可重复投递的事件通道**。
|
|
7
|
+
*
|
|
8
|
+
* 契约分三段:
|
|
9
|
+
* 1. 应用在卡片注册里给 `onPress()`(`ShellSlotContribution.onPress`);
|
|
10
|
+
* 2. 宿主点击时照常「启动并打开应用」,再 `queueSurfaceIntent(appId, intent)`;
|
|
11
|
+
* 3. 应用运行面经 `context.ui.onSurfaceIntent` 订阅,订阅前到达的按序补投。
|
|
12
|
+
*
|
|
13
|
+
* 边界纪律:意图对宿主**完全不透明**——只有 appId(键控)与两个应用自定义字段
|
|
14
|
+
* (key / payload),宿主不读、不解释、不翻译。B1–B6 均不命中。
|
|
15
|
+
*
|
|
16
|
+
* 生命周期:意图只属于「这一次打开」。应用停用 / 卸载 / 运行面销毁时由
|
|
17
|
+
* `clearSurfaceIntents` 清空排队项,旧意图不会在下一次打开时突然生效;队列有上限,
|
|
18
|
+
* 应用永不消费时也不会无限增长。
|
|
19
|
+
*/
|
|
20
|
+
import type { Disposable, ShellSurfaceIntent } from '../../../src/types'
|
|
21
|
+
|
|
22
|
+
/** 单应用最多排队的意图数(超出丢最旧的;只保留「最近几次点击」) */
|
|
23
|
+
export const SURFACE_INTENT_MAX_PENDING = 8
|
|
24
|
+
|
|
25
|
+
/** 待投递意图(订阅者出现前滞留) */
|
|
26
|
+
const pending = new Map<string, ShellSurfaceIntent[]>()
|
|
27
|
+
|
|
28
|
+
/** 已订阅的运行面(同一应用通常一个;按 Set 容忍多订阅,逐个投递) */
|
|
29
|
+
const subscribers = new Map<string, Set<(intent: ShellSurfaceIntent) => void>>()
|
|
30
|
+
|
|
31
|
+
/** 把排队意图投给当前订阅者;没有订阅者时保留排队 */
|
|
32
|
+
function flush(appId: string): void {
|
|
33
|
+
const queue = pending.get(appId)
|
|
34
|
+
const handlers = subscribers.get(appId)
|
|
35
|
+
if (!queue || queue.length === 0 || !handlers || handlers.size === 0) return
|
|
36
|
+
pending.delete(appId)
|
|
37
|
+
for (const intent of queue) {
|
|
38
|
+
for (const handler of handlers) handler(intent)
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* 投递一条入口意图(宿主点击路径调用,启动成功后入队)
|
|
44
|
+
*
|
|
45
|
+
* 空 appId / 空意图直接忽略(调用方语义上是「没有入口」,不是错误)。
|
|
46
|
+
*/
|
|
47
|
+
export function queueSurfaceIntent(
|
|
48
|
+
appId: string,
|
|
49
|
+
intent: ShellSurfaceIntent | null | undefined,
|
|
50
|
+
): void {
|
|
51
|
+
if (!appId || !intent) return
|
|
52
|
+
const queue = pending.get(appId) ?? []
|
|
53
|
+
queue.push(intent)
|
|
54
|
+
if (queue.length > SURFACE_INTENT_MAX_PENDING) {
|
|
55
|
+
queue.splice(0, queue.length - SURFACE_INTENT_MAX_PENDING)
|
|
56
|
+
}
|
|
57
|
+
pending.set(appId, queue)
|
|
58
|
+
flush(appId)
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* 应用运行面订阅入口意图(`context.ui.onSurfaceIntent` 的落点)
|
|
63
|
+
*
|
|
64
|
+
* 返回 Disposable:只摘本订阅者,不动排队项(其它订阅者仍可收到)。
|
|
65
|
+
*/
|
|
66
|
+
export function subscribeSurfaceIntent(
|
|
67
|
+
appId: string,
|
|
68
|
+
handler: (intent: ShellSurfaceIntent) => void,
|
|
69
|
+
): Disposable {
|
|
70
|
+
let handlers = subscribers.get(appId)
|
|
71
|
+
if (!handlers) {
|
|
72
|
+
handlers = new Set()
|
|
73
|
+
subscribers.set(appId, handlers)
|
|
74
|
+
}
|
|
75
|
+
handlers.add(handler)
|
|
76
|
+
// 订阅前到达的意图按序补投
|
|
77
|
+
flush(appId)
|
|
78
|
+
return {
|
|
79
|
+
dispose() {
|
|
80
|
+
const current = subscribers.get(appId)
|
|
81
|
+
if (!current) return
|
|
82
|
+
current.delete(handler)
|
|
83
|
+
if (current.size === 0) subscribers.delete(appId)
|
|
84
|
+
},
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* 清空某应用的排队意图(停用 / 卸载 / 运行面销毁)
|
|
90
|
+
*
|
|
91
|
+
* 不清订阅者:运行面真正销毁时其订阅会随插件上下文 dispose 自摘;这里是
|
|
92
|
+
* 防止「点了卡片但应用没起来 / 被停用」留下的旧意图劫持下一次打开。
|
|
93
|
+
*/
|
|
94
|
+
export function clearSurfaceIntents(appId: string): void {
|
|
95
|
+
pending.delete(appId)
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** 测试隔离:清空全部排队与订阅 */
|
|
99
|
+
export function resetSurfaceIntents(): void {
|
|
100
|
+
pending.clear()
|
|
101
|
+
subscribers.clear()
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/** 排障 / 测试:当前排队意图数(只读) */
|
|
105
|
+
export function pendingSurfaceIntentCount(appId: string): number {
|
|
106
|
+
return pending.get(appId)?.length ?? 0
|
|
107
|
+
}
|
|
@@ -92,6 +92,13 @@ export interface ShellApp {
|
|
|
92
92
|
sizeBytes?: number
|
|
93
93
|
/** 上一次失败的简短原因(state === 'error' 时展示) */
|
|
94
94
|
error?: string
|
|
95
|
+
/** manifest `update` 段(缺省 = 不参与更新检查;与宿主 ShellApp 契约逐字一致) */
|
|
96
|
+
update?: {
|
|
97
|
+
provider?: 'github-release'
|
|
98
|
+
repo?: string
|
|
99
|
+
tagPrefix?: string
|
|
100
|
+
slug?: string
|
|
101
|
+
}
|
|
95
102
|
contributions: ShellAppContributions
|
|
96
103
|
}
|
|
97
104
|
|
|
@@ -100,6 +107,14 @@ export interface ShellApp {
|
|
|
100
107
|
*
|
|
101
108
|
* 能力可选:不支持的能力不实现该方法,壳据此不渲染对应入口,不做静默降级。
|
|
102
109
|
*/
|
|
110
|
+
/**
|
|
111
|
+
* 本地包安装的「旧数据是否恢复」询问(与宿主同形状)
|
|
112
|
+
*
|
|
113
|
+
* dev-shell 当前没有安装能力的数据源,保留同构签名只为契约不漂移:
|
|
114
|
+
* 将来接安装时按宿主口径在落盘前询问(默认不恢复)。
|
|
115
|
+
*/
|
|
116
|
+
export type ShellInstallRestoreDecider = (info: { pluginId: string }) => Promise<boolean | null>
|
|
117
|
+
|
|
103
118
|
export interface ShellAppSource {
|
|
104
119
|
/** 数据源标识(日志与诊断用) */
|
|
105
120
|
readonly id: string
|
|
@@ -125,10 +140,10 @@ export interface ShellAppSource {
|
|
|
125
140
|
/**
|
|
126
141
|
* 安装本地应用包(数据源自行完成选包与校验)。
|
|
127
142
|
*
|
|
128
|
-
* @returns 安装后的应用 id;`null` =
|
|
143
|
+
* @returns 安装后的应用 id;`null` = 用户取消选包或取消恢复询问(不是失败)。
|
|
129
144
|
* 未实现时壳不渲染「安装本地包」入口——不提供点了没反应的按钮。
|
|
130
145
|
*/
|
|
131
|
-
installFromLocalPackage?(): Promise<string | null>
|
|
146
|
+
installFromLocalPackage?(decideRestore?: ShellInstallRestoreDecider): Promise<string | null>
|
|
132
147
|
/** 卸载应用并删除其数据;未实现时壳不渲染「卸载」入口 */
|
|
133
148
|
remove?(appId: string): Promise<boolean>
|
|
134
149
|
/** 查询 / 设置「启动时自动激活」偏好(未实现时壳不渲染自启开关) */
|