@synopackageland/ui 0.10.1 → 0.10.3

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.10.3 (2026-10-16)
+
+- `Dialog` takes `size="sm" | "md" | "lg" | "xl"`: the DSM 7.4 dialog widths 450, 530, 740 and 860 px (`--ui-dialog-width-<size>`), measured on File Station's Create folder, Task Scheduler's Create task, Storage Manager's Data Scrubbing and a shared folder's Edit. An explicit `width` still wins. JSON UI `Dialog` takes `size` too.
+- A content-sized `Dialog` holding a `Textarea` opens at least `md` (530 px) wide, and one holding a row-wide `Input` at least `sm` (450 px), as DSM builds dialogs around such fields. A number field does not widen it. The floor never passes the maximum width.
+- Every dialog width, presets included, stays inside its DSM window less a 12 px margin, also when the dialog floats over the desktop (`dialogBounds: 'viewport'`, as the SDK's AppShell sets in a DSM window). A 760 px dialog in a 700 px window no longer overflows it.
+- A content-sized dialog can grow to the whole room it is given; before, its centring limited it to half its container's width.
+- A dialog with a title bar draws DSM's 3 px modal-window corner (`--ui-radius-window`); a message box without a title keeps 8 px (`--ui-radius-dialog`). Both measured on DSM 7.4.
+- On a phone-width app, the bottom sheet of an app-local dialog now runs edge to edge; it was 24 px short of the app.
+- Visible changes for apps: dialogs with a text area or text fields get wider, titled dialogs get squarer corners, and some content-sized dialogs grow up to 760 px. Download Hub's 新增下載 dialog needs no change: its text area makes it 530 px. Remove hard-coded dialog widths that only imitated DSM, and use `size` for a wide form.
+
+繁中摘要：Dialog 新增 `size`（sm 450／md 530／lg 740／xl 860px，依 DSM 7.4 實測），明確的 `width` 仍優先；JSON UI 的 Dialog 同樣支援。依內容決定寬度的 Dialog 內含 Textarea 時至少 530px、含整列 Input 時至少 450px（數字欄位不影響），不超過最大寬度。所有寬度（含 size）都夾在 DSM 視窗內寬減 12px 邊距內，浮在桌面上的對話框（SDK AppShell 在 DSM 視窗中的 `dialogBounds: 'viewport'`）也一樣；700px 視窗中的 760px 對話框不再溢出。依內容決定寬度的對話框不再因置中方式被限制在容器一半寬。有標題列的 Dialog 改用 DSM 模態視窗的 3px 圓角（`--ui-radius-window`），無標題的訊息框維持 8px。手機寬度下 app-local 對話框的底部面板改為滿版（先前比 App 窄 24px）。App 升級後：含文字區域／文字欄位的對話框變寬、有標題的對話框圓角變小、部分依內容決定寬度的對話框可寬到 760px。Download Hub 的「新增下載」不需修改即為 530px；移除只為模仿 DSM 而寫死的寬度，寬表單改用 `size`。
+
+## 0.10.2 (2026-10-16)
+
+- A `PageHeader` inside `PageContent` no longer gets the section gap on top of its own bottom padding: the title sits 12 px above the content in a DSM window again (16 px on a phone, 24 px in the web layout), not 24 px.
+- Buttons in `SettingsSection` `#footer`, `Card` `#footer`, `Panel` `#fbar`, `Sheet` `#footer` and `AppActionBar` become `action` automatically, like `FormActions`, `Footbar`, `Dialog` and `Wizard` footers. An explicit `kind` still wins.
+- **Behavior change:** `Tag` `removable` now defaults to `false`. DSM status and label tags are display-only, so the remove control must be opted into with `removable`; a Tag that relied on the old default loses its ×.
+- Visible changes for apps: less space under page titles, and these footers draw capsule buttons. An app can drop the `kind="action"` it added to such footers, and the `:removable="false"` it set on Tags.
+
+繁中摘要：PageContent 裡的 PageHeader 不再把段落間距疊在自己的下方 padding 上，DSM 視窗中標題到內容回到 12px（手機 16px、web 版面 24px）。SettingsSection `#footer`、Card `#footer`、Panel `#fbar`、Sheet `#footer`、AppActionBar 的按鈕跟 FormActions／Footbar／Dialog／Wizard 頁尾一樣自動用 action；明確寫的 `kind` 仍優先。**行為變更：**Tag 的 `removable` 預設改為 `false`（DSM 狀態／標籤 Tag 只供顯示），需要移除鈕時要明確寫 `removable`；依賴舊預設的 Tag 會失去 ×。App 可刪掉自己在這些頁尾加的 `kind="action"`，以及 Tag 上的 `:removable="false"`。
+
 ## 0.10.1 (2026-10-16)
 
 - Components follow measured DSM 7 metrics (see `docs/dsm-native-metrics.md`).

package/README.md

@@ -257,10 +257,17 @@ const open = ref(false)
 </template>
 ```
 
-Without `width` the dialog sizes to its content between
+Without `width` or `size` the dialog sizes to its content between
 `--ui-dialog-min-width` (420px) and `--ui-dialog-max-width` (760px, or the
-`max-width` prop); a long paragraph wraps at the maximum. `width` sets a fixed
-width, capped to the viewport. A dialog with no title and no close button is a
+`max-width` prop); a long paragraph wraps at the maximum. A field without a
+width of its own raises that minimum to the DSM width of a dialog built around
+it: a `Textarea` to `md` (530px), a row-wide `Input` to `sm` (450px). `size`
+picks a fixed DSM dialog width: `sm` 450px (one field), `md` 530px (a form
+with a text area), `lg` 740px (a wide form), `xl` 860px (tabs of settings),
+as measured on DSM 7.4. `width` sets any
+fixed width and wins over `size`. Every width stays inside the room the
+container leaves: the viewport or the app less a margin, and in a DSM window
+the window itself, also when the dialog floats over the desktop. A dialog with no title and no close button is a
 question and takes DSM's message-box layout. Buttons in the `footer` slot are
 capsule `action` buttons (`kind="tool"` opts one out). `height` or
 `min-height` (for example `min-height="420px"`) keeps a panel with little
@@ -324,7 +331,9 @@ import { AppLayout, Button, PageHeader } from '@synopackageland/ui'
 `AppLayout` also accepts `sidebar`, `toolbar`, and `footer` slots.
 
 `PageContent` stacks its direct children (a search row, a toolbar, cards) at
-`--ui-section-gap`, so a page needs no margins between them.
+`--ui-section-gap`, so a page needs no margins between them. Under a
+`PageHeader` the space is the header's own bottom padding (12px in a DSM
+window), with no section gap added.
 
 To set a block apart inside a card, use `<Surface variant="inset">`. DSM draws it as a
 faint grey block with no border of its own, at 12px × 16px padding.

package/dist/components/composite/settings-section/SettingsSection.vue.d.ts

@@ -10,7 +10,7 @@ type __VLS_Props = {
     /** Bound with `v-model:open` for controlled collapse. */
     open?: boolean;
 };
-declare var __VLS_6: {}, __VLS_8: {}, __VLS_10: {}, __VLS_12: {}, __VLS_14: {}, __VLS_21: {}, __VLS_23: {};
+declare var __VLS_6: {}, __VLS_8: {}, __VLS_10: {}, __VLS_12: {}, __VLS_14: {}, __VLS_21: {}, __VLS_29: {};
 type __VLS_Slots = {} & {
     title?: (props: typeof __VLS_6) => any;
 } & {
@@ -24,7 +24,7 @@ type __VLS_Slots = {} & {
 } & {
     default?: (props: typeof __VLS_21) => any;
 } & {
-    footer?: (props: typeof __VLS_23) => any;
+    footer?: (props: typeof __VLS_29) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:open": (value: boolean) => any;

package/dist/components/containers/card/Card.vue.d.ts

@@ -14,7 +14,7 @@ type __VLS_Props = {
     /** Shows a skeleton in place of the body and footer while they load. */
     loading?: boolean;
 };
-declare var __VLS_8: {}, __VLS_10: {}, __VLS_22: {}, __VLS_24: {}, __VLS_26: {};
+declare var __VLS_8: {}, __VLS_10: {}, __VLS_22: {}, __VLS_24: {}, __VLS_32: {};
 type __VLS_Slots = {} & {
     title?: (props: typeof __VLS_8) => any;
 } & {
@@ -24,7 +24,7 @@ type __VLS_Slots = {} & {
 } & {
     default?: (props: typeof __VLS_24) => any;
 } & {
-    footer?: (props: typeof __VLS_26) => any;
+    footer?: (props: typeof __VLS_32) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:expanded": (value: boolean) => any;

package/dist/components/containers/panel/Panel.vue.d.ts

@@ -18,7 +18,7 @@ type __VLS_Props = {
     /** Make the default body slot scroll when its content overflows. */
     scrollable?: boolean;
 };
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {}, __VLS_18: {};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_15: {}, __VLS_24: {};
 type __VLS_Slots = {} & {
     tbar?: (props: typeof __VLS_1) => any;
 } & {
@@ -28,9 +28,9 @@ type __VLS_Slots = {} & {
 } & {
     default?: (props: typeof __VLS_7) => any;
 } & {
-    fbar?: (props: typeof __VLS_9) => any;
+    fbar?: (props: typeof __VLS_15) => any;
 } & {
-    'spin-inner'?: (props: typeof __VLS_18) => any;
+    'spin-inner'?: (props: typeof __VLS_24) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     getScrollEl: () => HTMLElement | null;

package/dist/components/primitives/dialog/Dialog.vue.d.ts

@@ -1,10 +1,13 @@
+import { DialogSize } from './dialogSize';
 type __VLS_Props = {
     open?: boolean;
     defaultOpen?: boolean;
     title?: string;
     description?: string;
-    /** A fixed width, capped to the viewport. Without it the dialog sizes to its content. */
+    /** A fixed width, capped to the room the app window leaves. Without it (or `size`) the dialog sizes to its content. */
     width?: string;
+    /** A fixed DSM dialog width (`--ui-dialog-width-<size>`), capped like `width`; `width` wins over it. */
+    size?: DialogSize;
     /** The widest a content-sized dialog grows (default `--ui-dialog-max-width`). */
     maxWidth?: string;
     /** A fixed panel height, capped to the available height. */

package/dist/components/primitives/dialog/dialogSize.d.ts

@@ -0,0 +1,12 @@
+import { ComputedRef } from 'vue';
+/** A Dialog width preset: one of the dialog widths DSM 7 itself uses (`--ui-dialog-width-<size>`). */
+export type DialogSize = 'sm' | 'md' | 'lg' | 'xl';
+/**
+ * The narrowest DSM dialog width the fields in a dialog ask for: the widest
+ * of their wishes, or undefined. A field without a width of its own (a text
+ * area, a row-wide input) would otherwise shrink to a content-sized dialog's
+ * minimum.
+ */
+export declare function provideDialogContentWidth(): ComputedRef<DialogSize | undefined>;
+/** Asks the dialog a field is in, if any, to be at least `size` wide while the field is shown. */
+export declare function useDialogContentWidth(size: () => DialogSize | undefined): void;

package/dist/components/primitives/sheet/Sheet.vue.d.ts

@@ -8,13 +8,13 @@ type __VLS_Props = {
     description?: string;
     closeLabel?: string;
 };
-declare var __VLS_14: {}, __VLS_62: {}, __VLS_64: {};
+declare var __VLS_14: {}, __VLS_62: {}, __VLS_70: {};
 type __VLS_Slots = {} & {
     trigger?: (props: typeof __VLS_14) => any;
 } & {
     default?: (props: typeof __VLS_62) => any;
 } & {
-    footer?: (props: typeof __VLS_64) => any;
+    footer?: (props: typeof __VLS_70) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     escapeKeyDown: (event: KeyboardEvent) => any;

package/dist/components/primitives/tag/Tag.vue.d.ts

@@ -10,7 +10,10 @@ export interface TagVisual {
 type __VLS_Props = {
     label?: string;
     appearance?: TagAppearance;
-    /** Shows the remove control; the caller handles the actual removal. */
+    /**
+     * Shows the remove control; the caller handles the actual removal. Off by
+     * default: DSM status and label tags are display-only.
+     */
     removable?: boolean;
     selected?: boolean;
     disabled?: boolean;

package/dist/index.d.ts

@@ -40,6 +40,7 @@ export { default as SplitButton } from './components/primitives/split-button/Spl
 export { default as ContextMenu } from './components/primitives/context-menu/ContextMenu.vue';
 export type { ContextMenuEntry } from './components/primitives/context-menu/types';
 export { default as Dialog } from './components/primitives/dialog/Dialog.vue';
+export type { DialogSize } from './components/primitives/dialog/dialogSize';
 export { default as Sheet, default as Drawer } from './components/primitives/sheet/Sheet.vue';
 export { default as DatePicker } from './components/primitives/date-picker/DatePicker.vue';
 export type { DateFormat, DateTimeParts, TimeFormat } from './components/primitives/date-picker/dateTime';