@q1travel/design-system 0.14.0 → 0.15.0

package/contracts/overlay-foundation.md

@@ -156,7 +156,7 @@ type OverlayRecord = {
 | --- | --- | --- | --- |
 | Modal | 公开 props、尺寸/布局、关闭策略、文档示例 | portal、stack、focus、blocking lock、统一 Escape/outside ownership | Foundation |
 | DestructiveActionModal | destructive/loading/confirm 语义与提交状态 | 同上；loading 时由 policy 禁止关闭 | Foundation |
-| Sheet | 现有 side、persistent-context 语义；blocking=true、outside pointer=false | 同上；不能让 CSS 注释与 ARIA 语义继续冲突 | Foundation |
+| Sheet | side、persistent-context 语义；blocking=true、outside pointer=false；dismissable 默认 true，false 禁用 Escape 并隐藏内置关闭按钮 | 同上；不能让 CSS 注释与 ARIA 语义继续冲突 | Foundation |
 | Drawer | mobile bottom、gesture、outside/Escape 语义 | 同上；gesture 关闭仍必须服从 top-most 与 loading policy | Foundation |
 
 组件接入不得一次性重写四个组件，也不得在未有单独 contract 的情况下改变公开 DOM、默认 dismissal 或 accessibility tier。
@@ -259,3 +259,7 @@ D7  q1travel-web adoption/migration
 - 宿主每次 open 对应一次登记/释放；改变 blocking 策略应重新登记。idempotent disposer 支持 StrictMode 清理。不同 document 完全隔离。
 
 回归入口：`node --test scripts/check-overlay-coordination.test.mjs`；真实跨 root 的 Escape、焦点、快捷键与滚动锁由 Web consumer 浏览器测试验证。
+
+### Sheet sizing and dismissal
+
+Sheet accepts optional `size: 'sm' | 'md' | 'lg' | 'xl'` for left/right panel widths of 360/480/640/860px, capped by the existing viewport gutters. Omitting size retains 512px. Top/bottom geometry, `title: string`, children, footer, and side remain unchanged. Dismissal policy updates take effect in the same commit as visible close controls, before consumer layout effects. `dismissable=false` retains its blocking coordinator entry, focus trap, inert background, and scroll lock; Escape cannot dismiss it or the underlying host overlay. Outside pointer never closes Sheet. Consumers retain ownership of controlled open and footer actions and restore dismissal when the temporary busy state ends.

package/dist-pkg/design-system.d.ts

@@ -1392,17 +1392,21 @@ export declare function Separator({ orientation, decorative, className, }: {
 
 export declare type SeparatorOrientation = 'horizontal' | 'vertical';
 
-export declare function Sheet({ open, onClose, title, side, children, footer }: {
+export declare function Sheet({ open, onClose, title, side, size, dismissable, children, footer }: {
     open: boolean;
     onClose: () => void;
     title: string;
     side?: SheetSide;
+    size?: SheetSize;
+    dismissable?: boolean;
     children: ReactNode;
     footer?: ReactNode;
 }): ReactNode;
 
 export declare type SheetSide = 'top' | 'right' | 'bottom' | 'left';
 
+export declare type SheetSize = 'sm' | 'md' | 'lg' | 'xl';
+
 export declare function ShowMore({ items, initial, noBorder, initialExpanded, }: {
     items: string[];
     initial?: number;