@ids-group-ltd/ids-design-system 0.8.0 → 0.9.0
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/CHANGELOG.md +377 -0
- package/components.md +500 -0
- package/design-system.md +145 -0
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +1245 -371
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.9.0.json +157 -0
- package/migrations/README.md +8 -1
- package/migrations/unreleased/README.md +134 -0
- package/package.json +1 -1
- package/styles/_dropdown-overlay.scss +34 -7
- package/styles/_field-box.scss +8 -3
- package/styles/_surface-motion.scss +48 -3
- package/styles/_tokens.scss +1 -4
- package/types/ids-group-ltd-ids-design-system.d.ts +631 -113
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": "0.9.0",
|
|
3
|
+
"items": [
|
|
4
|
+
{
|
|
5
|
+
"id": "leave-keyframes-renamed",
|
|
6
|
+
"kind": "token-rename",
|
|
7
|
+
"old": "modal-out / ds-sheet-down / ds-sheet-fade-out / drawer-panel-close-right|left|top|bottom / drawer-scrim-out",
|
|
8
|
+
"new": "ds-fade-out / ds-scale-out / ds-slide-out / ds-slide-edge-out",
|
|
9
|
+
"note": "REMOVED: seven exit @keyframes local to modal, drawer and bottom-sheet are gone, replaced by four GLOBAL presets mirroring the entrance vocabulary. ACTION: nothing, unless you referenced one of the old names - only possible from a global stylesheet, since they were view-encapsulated. If you did, the mapping is: modal-out, ds-sheet-fade-out and drawer-scrim-out -> ds-fade-out; ds-sheet-down and all four drawer-panel-close-* -> ds-slide-edge-out. WHY: teardown matched the animation NAME on animationend, so the exit could not be swapped without breaking close entirely; the guard now checks the event came from the animated element rather than a child, which frees the name. WHAT YOU GAIN: --ds-modal-leave-keyframes, --ds-drawer-leave-keyframes and --ds-bottom-sheet-leave-keyframes, the exit counterparts of the --ds-*-enter-keyframes you already have. Point one at your own GLOBAL @keyframes - a component-scoped name is renamed by Angular and will not resolve. An exit preset reads --_ds-exit-x/y/scale and falls back to the matching --_ds-enter-*, so a surface that leaves the way it arrived declares nothing. VERIFY AFTER UPGRADING: open and close a modal, a drawer and a bottom sheet and confirm the page scrolls again afterwards - a teardown that does not fire leaks the body-scroll lock, which is the failure this change could cause and the one we tested for.",
|
|
10
|
+
"searchHints": [
|
|
11
|
+
"modal-out",
|
|
12
|
+
"ds-sheet-down",
|
|
13
|
+
"drawer-panel-close",
|
|
14
|
+
"drawer-scrim-out",
|
|
15
|
+
"ds-sheet-fade-out"
|
|
16
|
+
]
|
|
17
|
+
},
|
|
18
|
+
{
|
|
19
|
+
"id": "dropdown-panel-radius",
|
|
20
|
+
"kind": "behavior",
|
|
21
|
+
"old": "--radius-md (8px) on the ds-select / ds-multi-select panel",
|
|
22
|
+
"new": "--ds-radius-panel (12px)",
|
|
23
|
+
"note": "CHANGED DEFAULT, visual: the dropdown panel behind ds-select and ds-multi-select has a 12px corner, was 8px. It was the one panel outside the radius role layer - modal, popover, date-picker, time-picker, autocomplete, bottom-sheet, card, stat and page-footer all resolve --ds-radius-panel already - so it both disagreed with its siblings and could not be retuned through the role a consumer is told to use. ACTION: none unless you want the old corner, in which case set --ds-select-panel-radius: 8px, or --ds-radius-panel: 8px to move every panel together. CHECK: a screen where a dropdown opens beside a popover or a date picker - that is where the 4px difference was visible and is now gone.",
|
|
24
|
+
"searchHints": [
|
|
25
|
+
"--radius-md",
|
|
26
|
+
"dropdown-panel",
|
|
27
|
+
"ds-select",
|
|
28
|
+
"--ds-radius-panel"
|
|
29
|
+
]
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"id": "auth-shell-selector-to-auth-layout",
|
|
33
|
+
"kind": "selector-rename",
|
|
34
|
+
"old": "ds-auth-shell",
|
|
35
|
+
"new": "ds-auth-layout",
|
|
36
|
+
"note": "Component renamed (shipped as ds-auth-shell in the tagged 0.8.0 source, its only release under that name). \"Shell\" is not this library's word for a layout: the app-level one was renamed ds-app-shell -> ds-app-layout in 0.7.0, and calling the auth counterpart a shell put the split vocabulary back. ACTION: rename the element and its closing tag. Behaviour, inputs and slots are unchanged - brand, logoLetter, tagline, cardElevation, cardPadding, [brand], [dsBrandName] and dsAuthSupport all keep their names. Also rename the class and the tokens (separate entries below).",
|
|
37
|
+
"searchHints": [
|
|
38
|
+
"ds-auth-shell"
|
|
39
|
+
]
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"id": "auth-shell-class-to-auth-layout",
|
|
43
|
+
"kind": "type-rename",
|
|
44
|
+
"old": "AuthShellComponent",
|
|
45
|
+
"new": "AuthLayoutComponent",
|
|
46
|
+
"note": "The exported component class renamed alongside the ds-auth-shell -> ds-auth-layout selector. Update imports and any type references. No members changed.",
|
|
47
|
+
"searchHints": [
|
|
48
|
+
"AuthShellComponent"
|
|
49
|
+
]
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"id": "auth-shell-tokens-to-auth-layout",
|
|
53
|
+
"kind": "token-rename",
|
|
54
|
+
"old": "--ds-auth-shell-",
|
|
55
|
+
"new": "--ds-auth-layout-",
|
|
56
|
+
"note": "Prefix rename for the six component tokens: --ds-auth-shell-min-height / -card-max-width / -gap / -bg-color / -mark-bg-color / -mark-label-color -> --ds-auth-layout-*. Values and defaults are unchanged. DS-owned tokens only (no others ship under this prefix); a consumer's own --ds-auth-shell-* variable is out of scope. EXCLUDED, do not rename: the global scale token --auth-card-w, the fallback behind -card-max-width, which carries no --ds-auth-shell- prefix and keeps its name. Confirm the new name exists in the installed package.",
|
|
57
|
+
"searchHints": [
|
|
58
|
+
"--ds-auth-shell-"
|
|
59
|
+
]
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
"id": "search-height-joins-field-scale",
|
|
63
|
+
"kind": "behavior",
|
|
64
|
+
"old": "ds-search",
|
|
65
|
+
"new": null,
|
|
66
|
+
"note": "CHANGED DEFAULT: ds-search is 40px tall at the default size, was 36px. Every size moved onto the field scale - sm var(--field-h-sm) 32px (was --hit-min 32px, unchanged), md var(--field-h-md) 40px (was --search-h 36px, CHANGED), lg var(--field-h-lg) 48px (unchanged). The old 36px was a lone tier: nothing else in the library used it, while ds-button, ds-input, ds-select and both pickers all resolve --field-h-md, so a search box in a toolbar sat 4px short of every neighbour. RESTORE the old height with `ds-search { --ds-search-height: 36px; }` - that token still wins over everything. ALSO NEW: the height now falls through --ds-field-height, so `--ds-field-height: 44px` on a toolbar levels search along with the fields, which was the point of the change.",
|
|
67
|
+
"searchHints": [
|
|
68
|
+
"ds-search",
|
|
69
|
+
"--ds-search-height",
|
|
70
|
+
"--search-h"
|
|
71
|
+
]
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
"id": "search-h-token-removed",
|
|
75
|
+
"kind": "removed-api",
|
|
76
|
+
"old": "--search-h",
|
|
77
|
+
"new": null,
|
|
78
|
+
"note": "The global --search-h token is gone; it existed only to hold ds-search's 36px and nothing reads it any more. Its replacements, in precedence order: --ds-search-height (retunes search alone) and --ds-field-height (levels the whole field family). If you declared --search-h to resize search, that declaration is now inert - swap it for --ds-search-height with the same value. Reading it in your own CSS resolves to nothing. The --hit-md scale token it pointed at (36px) is untouched and still available.",
|
|
79
|
+
"searchHints": [
|
|
80
|
+
"--search-h"
|
|
81
|
+
]
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"id": "table-sort-filter-mode-default-server",
|
|
85
|
+
"kind": "behavior",
|
|
86
|
+
"old": "ds-table",
|
|
87
|
+
"new": null,
|
|
88
|
+
"note": "CHANGED DEFAULT: ds-table sortMode and filterMode resolve to 'server' when unset, were 'client'. An undeclared table now emits (sortChange) / updates columnFilters and reorders or filters NOTHING itself. ACTION, and it is per-table: if the table receives ALL its rows - the giveaway is that it does NOT bind `total` - add sortMode=\"client\" and, where any column has filter: 'set', filterMode=\"client\", or its headers will look live and do nothing. If it binds `total` it is server-paged and the new default is what you already wanted: the old 'client' sorted only the page in hand, so the rows looked sorted and were not, and a dev warning said exactly that. Tables that already declare a mode are untouched. A reversed dev warning now fires on the client case (no `total` + sortable/filterable columns + no declared mode), so run the app and let the console list them.",
|
|
89
|
+
"searchHints": [
|
|
90
|
+
"ds-table",
|
|
91
|
+
"sortMode",
|
|
92
|
+
"filterMode",
|
|
93
|
+
"sortable",
|
|
94
|
+
"sortChange"
|
|
95
|
+
]
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
"id": "number-stepper-lg-height",
|
|
99
|
+
"kind": "behavior",
|
|
100
|
+
"old": "ds-number-stepper",
|
|
101
|
+
"new": null,
|
|
102
|
+
"note": "CHANGED DEFAULT, one size only: ds-number-stepper with size=\"lg\" is 48px tall, was 44px. It resolved --hit-comfy while the field family's large size is --field-h-lg (--hit-touch, 48px), so a large stepper was a step short of a large input beside it. The +/- buttons and the quantity box derive their widths from that height, so they widen with it. size=\"sm\" (32px) and the size=\"md\" default (40px) are unchanged. RESTORE with `ds-number-stepper { --ds-field-height: 44px; }` scoped to the instance, or set the size back to md.",
|
|
103
|
+
"searchHints": [
|
|
104
|
+
"ds-number-stepper",
|
|
105
|
+
"size=\"lg\"",
|
|
106
|
+
"--hit-comfy"
|
|
107
|
+
]
|
|
108
|
+
},
|
|
109
|
+
{
|
|
110
|
+
"id": "tabs-url-param-adoption",
|
|
111
|
+
"kind": "code-add",
|
|
112
|
+
"old": "ds-tabs",
|
|
113
|
+
"new": "urlParam=\"tab\"",
|
|
114
|
+
"note": "ds-tabs can now keep the active tab in the URL: set urlParam (e.g. urlParam=\"tab\") and the strip writes ?tab=<name>, so the tab survives F5, a shared link and the Back button. Nothing changes until you set it, but this is worth a deliberate pass rather than a skim. ACTION, per strip: (1) GIVE EACH ds-tab A `value` if it has none - the URL is written from value, falling back to label, so without one a link carries the visible label and breaks the moment the label is translated or reworded. (2) ONE STRIP PER PARAMETER NAME. Two ds-tabs sharing a name on the same screen erase each other: both write the same query parameter, and a reload restores whichever wrote last. A dev-mode warning now names the clash. Nested or sibling strips need distinct names (tab, subtab). (3) DELETE any hand-rolled wiring - a queryParamMap subscription plus a navigate() on tabChanged is exactly what this replaces, and running both fights. Behaviour to expect: NAMES not indices (an index would silently repoint every old link as soon as a tab is inserted), the FIRST tab writes no parameter, every write uses replaceUrl so flipping tabs does not fill the Back button, and an unknown or missing name lands on the first tab instead of throwing. Inert outside a routed context, and being query-only it does not trip ds-app-layout's scroll reset.",
|
|
115
|
+
"searchHints": [
|
|
116
|
+
"<ds-tabs",
|
|
117
|
+
"ds-tabs",
|
|
118
|
+
"tabChanged",
|
|
119
|
+
"queryParamMap"
|
|
120
|
+
]
|
|
121
|
+
}
|
|
122
|
+
],
|
|
123
|
+
"informational": [
|
|
124
|
+
"--ds-radius-inner now actually reaches the small affordances. 33 reads across fifteen component stylesheets took var(--radius-sm) directly - dropdown options, field clear buttons, calendar days, chips, tag and toast close buttons - so the role a consumer is told to retune reached exactly one component. They resolve the role now, and its default IS --radius-sm, so NOTHING MOVES: verified by measuring a component page before and after, identical surfaces at identical radii. NO ACTION, but it changes what a square brand costs you: zeroing the three roles used to leave five surfaces rounded and now leaves one. Two deliberate exclusions - five focus-ring radii inside :focus-visible keep following the raw scale (a ring traces a box, it is not a brand surface), and the shared dropdown panel behind ds-select / ds-multi-select still reads --radius-md (8px) where every other panel resolves --ds-radius-panel (12px). That last one is a tracked inconsistency, not a hook: squaring it needs the scale. Worked example on the Theming page.",
|
|
125
|
+
"A 32px toolbar is `density=\"compact\"`, not a per-control height pin. Measured on a nine-control row: search, input, select, autocomplete, date-picker, time-picker, multi-select, number-stepper and button are all 40px by default and all 32px under [data-density=\"compact\"] on the container. DELETE-LIST MATERIAL: if you pin --ds-search-height (or any sibling) to get a shorter row - one consumer pins --hit-min and its comment complains that md used to be 36px - that pin can go, and after the height contract it was fighting the family rather than joining it. Known limit at the bottom of the scale: ds-multi-select and ds-autocomplete hold chips, so they set a min-height rather than a height and stop following the floor once it drops below what the text needs - under ultra-compact they are 33px and 29px where the rest reach 24px, because a density tier scales padding and hit targets but not the type scale. Compact is unaffected in practice (33 against 32). Documented on the Density page.",
|
|
126
|
+
"SIGNAL FORMS WORK — no adapter, no wrapper, no DS import. Put [formField] from @angular/forms/signals on any DS control and the form owns the value, validation, touched and disabled state. This was ALWAYS nearly true and nobody knew: FormValueControl requires exactly one member, a `value` model(), and every DS control already had it. Measured across all fifteen controls - thirteen bound with no library change at all. Additive, NO ACTION. WHAT CHANGED HERE, and it is why the other four rules now work too: min/max/maxLength on ds-input, ds-textarea and ds-number-stepper accept undefined on the WRITE side (the binder sends it for an unset bound; the read type is untouched); `readonly` joins ds-input, ds-textarea and ds-select as the contract spelling of the existing readOnly, because signal forms binds by NAME and a readonly() rule was reaching nothing; `minLength` and `pattern` are new native attributes on ds-input and ds-textarea; and `hidden` is declared on both control-value-accessor bases, so a hidden() rule now removes the control on all thirteen that carry one. focus() is implemented too, so focusBoundControl() - the usual way to reach the first invalid field after a failed submit - lands on the element that holds the value rather than on the host, which is a <ds-*> element and not focusable, so focus previously went nowhere. It resolves per control: the stepper's number box rather than its minus button, the tabbable radio rather than the first in the DOM, a picker's trigger rather than an input inside its closed panel. NOT implemented: dirty, pending and disabledReasons - the form still tracks them, and they are blocked on a visual decision rather than wiring. ERROR TEXT still comes from your validator: required(path.email, { message: '...' }) or a provideDsConfig field.errorMessages mapping, otherwise the field goes red with no words and only a dev warning explains why. Docs: the Practice > Signal Forms page, with a live form and the measured contract table.",
|
|
127
|
+
"ds-modal / ds-modal-card gained [dividers] (default true = today's rendering). Additive, NO ACTION - but DELETE-LIST MATERIAL if you set --ds-modal-divider: transparent. Two consumer apps did exactly that, and both were then left with header and actions padding sized to clear a rule that was no longer drawn, stacking into a 35px gap where 16px was wanted; one needed !important plus a stylelint-disable to win it back. [dividers]=\"false\" drops the rules AND the padding in one move, because those are one design decision. If you kept a deliberate --ds-modal-divider colour, nothing changes. If you set it transparent, replace it with [dividers]=\"false\" and delete whatever padding overrides you wrote afterwards - and note --ds-modal-body-pad-y now falls to 0 in that mode, so set it explicitly if you want a value in both.",
|
|
128
|
+
"ds-modal / ds-modal-card gained a [title-badge] content slot and a subtitle input, so a dialog header can carry a status chip and a second line without abandoning the component. Additive, NO ACTION - both are absent by default and the header renders exactly as before. WORTH A LOOK IF YOU HAND-ROLLED A DIALOG: a consumer audit found two screens that dropped ds-modal purely because the header could not hold `title + ds-badge` over a `carrier - type` line, and re-implemented the scrim, the body scroll lock, backdrop-click and Escape by hand - losing the focus trap, focus restore, the enter/leave animation and, in one case, the footer, which put a destructive action next to the close button. The shape matches ds-page-header: [title-badge] projects beside the title, subtitle is a plain string under it. The accessible name is still the title string - projected markup never enters aria-labelledby. Retune with --ds-modal-subtitle-text-color and --ds-modal-subtitle-font-size.",
|
|
129
|
+
"HUMAN GUIDE: migrations/unreleased/README.md walks this release in order — where to look for each change, the one call that needs judgement per table (sortMode/filterMode), and a section this project had never written before: WHAT YOU CAN NOW DELETE. Two dogfooding audits found that most consumer workarounds were written against hooks that already existed, because nothing ever told them a thing had been tokenised. Read section 3 even if the upgrade itself is clean.",
|
|
130
|
+
"NEW COMPONENT ds-field-group: several controls in one bordered box (select + input, input + button, search + date-picker). Additive, NO ACTION. If you hand-rolled a glued row by stripping borders off two controls and wrapping them, this replaces it - wrap them in <ds-field-group> and mark the stretching one with grow. Six controls can be segments: ds-input, ds-select, ds-search, ds-autocomplete, ds-date-picker, ds-button. ds-number-stepper and ds-multi-select are excluded by design. Grouped controls must not be given a label or hint - the message row would break the glued line and is suppressed.",
|
|
131
|
+
"ds-table gained [lazy] + (lazyLoad) for fetching rows as they scroll into view. Additive and opt-in, NO ACTION. If you paged a long list yourself to keep it responsive, this is the alternative: set lazy with virtualScroll and total, make data a SPARSE array total long, and write each fetched row at its ABSOLUTE index - gaps inside the window render skeleton rows. Note sortMode must not be \"client\" (it would sort only the rows that happen to have arrived); the new server default is already right.",
|
|
132
|
+
"--ds-field-height now reaches ds-autocomplete, ds-multi-select, ds-color-picker, ds-number-stepper, ds-split-button and the ds-modal confirm input. All six spelled their height as the raw --hit-* value, so the token the name advertises did nothing for them; they read the field scale now. Pixel-identical at every size EXCEPT ds-number-stepper at size=\"lg\" (its own actionable entry above). NO ACTION unless you had already worked around the gap by pinning height on one of these - that pin can go.",
|
|
133
|
+
"The six connected panels (ds-select, ds-multi-select, ds-autocomplete, ds-color-picker, ds-date-picker, ds-time-picker) now build their overlay from one shared helper instead of six identical copies. Internal only, NO ACTION: the position, the 4px gap, the flip-above fallback, the panel classes and the scroll strategy are byte-for-byte what they were.",
|
|
134
|
+
"ds-autocomplete gained dsAutocompletePrefix / dsAutocompleteSuffix content slots and [showChevron] (default true). Additive, NO ACTION. If you absolutely positioned a search glyph over the field and re-padded the input, or hid the arrow with a global rule reaching for .autocomplete-chevron, replace both: put the icon in the prefix slot and set [showChevron]=\"false\". The slot names and behaviour match ds-input's dsInputPrefix / dsInputSuffix.",
|
|
135
|
+
"ds-autocomplete gained a public clear() that empties the value AND the typed text. If you reset the field by querying the inner <input> out of the DS's DOM and dispatching a synthetic input event, delete that and call clear() on a viewChild ref - the DOM shape it depended on is not part of the public API. It deliberately does not move focus.",
|
|
136
|
+
"ds-autocomplete gained --ds-autocomplete-panel-radius (default --ds-radius-panel) and --ds-autocomplete-panel-maxh (default --picker-maxh). NO ACTION - both defaults equal today's values. The radius one matters if you square the radius roles: the autocomplete panel was the last portaled surface hard-coding --radius-lg, so it stayed rounded in an otherwise square brand. The max-height one replaces reaching for the private --picker-maxh, which ds-multi-select also reads.",
|
|
137
|
+
"ds-table gained --ds-table-head-pad-top / --ds-table-head-pad-bottom, plus showPageSize and showLabel forwarded to its footer pager. All additive with today's values as defaults, NO ACTION. Separately FIXED: density=\"compact\" pinned padding onto the cells, which out-specified every --ds-table-*-pad-* hook, so a compact table silently ignored all of them; it now retunes the density tokens instead. Spacing is unchanged - but if you fought that with an !important, it can go.",
|
|
138
|
+
"ds-date-picker and ds-time-picker resolve their trigger's horizontal padding from --field-pad-x (new hooks: --ds-date-picker-trigger-pad-x, --ds-time-picker-trigger-pad-x) instead of a hard-coded --space-3. Identical at the default density; the difference shows under [data-density], where the token shrinks and the literal did not, leaving a picker 8px wider than the input beside it. NO ACTION unless you hand-pinned picker padding to compensate.",
|
|
139
|
+
"The ds-auth-shell -> ds-auth-layout rename is vocabulary only: no input, output, slot, token value or behaviour changed, and it is the same component 0.8.0 shipped. If you never adopted ds-auth-shell (it was added in 0.8.0), there is nothing to do.",
|
|
140
|
+
"FIXED in ds-textarea: size=\"sm\" and size=\"lg\" rendered the md vertical padding (12px top and bottom) regardless of the size. The size blocks set the inner textarea's vertical pad, but a :host-prefixed pin at the end of the file out-ranked them once emulated encapsulation shimmed both selectors - it carries one more attribute than the size selector. There are now three pins, one per size, and the size blocks keep only the horizontal padding they own. NO ACTION: the change is visible only on a non-md textarea and the md default is unchanged. Note that retuning --ds-input-pad-y previously moved all three sizes together; if you compensated for the wrong padding with your own override on a sm or lg textarea, that override now stacks on the corrected value and can go.",
|
|
141
|
+
"ds-auth-layout now COMPRESSES its own chrome on a short viewport: block padding, the column gap, the letter-mark tile and the masthead inner gap clamp against svh. No action - behaviour only, and a viewport 800px tall or more renders exactly what it did before. Read that as a VIEWPORT height, not a screen size: a 1366x768 laptop sits near 630px after browser and OS chrome, and a 1080p screen at 150% display scaling near 585px, so plenty of desktops do get the compressed furniture - an earlier wording of this line said 'so desktop is unchanged', which was wrong. Type is deliberately NOT clamped: the wordmark and the tile's glyph were measured to buy zero vertical space (the tile sets the row height at every viewport, and the glyph sits in a fixed-size box) while flattening the brand against a fixed 14px tagline, so both keep the fixed sizes 0.8.0 ships. Below 800px the remaining furniture shrinks so it is not what pushes a card into scrolling (~131px instead of ~219px at a landscape phone's ~330px). Two tokens opt out per dimension: --ds-auth-layout-pad-block and --ds-auth-layout-mark-size; setting any of those or the existing --ds-auth-layout-gap to a fixed value stops that one compressing. A card taller than the remaining space still scrolls - that is intended.",
|
|
142
|
+
"ds-auth-layout audit fixes, all additive or corrective - NO ACTION. The letter-mark tile is now aria-hidden (a screen reader announced 'A MyAdmin', now 'MyAdmin') and carries flex-shrink: 0 so a long wordmark cannot squash it out of square; logoLetter on its own renders its tile instead of nothing; the glyph is taken by code point rather than charAt(0), which returned half a surrogate pair for a brand starting with an emoji; box-sizing: border-box is declared on the host rather than inherited, so the component still avoids its own overflow scrollbar for a consumer composing style partials without styles/reset. The four env(safe-area-inset-*) calls gained 0px fallbacks and moved to physical padding-left/padding-right so the insets cannot swap sides under RTL - and note they are inert unless YOUR app sets viewport-fit=cover in its viewport meta, which the library cannot set for you. New tokens, both defaulting to today's behaviour: --ds-auth-layout-mark-radius (the tile's radius was the one value with no override hop) and --ds-auth-layout-brand-max-height (none by default; set it to cap a projected [brand] logo, which nothing constrained). New input landmark, default 'none': set landmark=\"main\" on a standalone auth page so the card - an <article>, which is not a landmark - becomes something a screen-reader user can jump to; it stays opt-in because this layout is also embedded inside pages that already own a main.",
|
|
143
|
+
"ds-icon now logs a dev-mode warning when an icon name is in neither the DS set nor your provideDsIcons() registry - previously it rendered an empty <svg> silently. No action, and nothing changes in production. Expect the warning to surface real typos the moment you upgrade: an audit of three screens in one consumer is what prompted it.",
|
|
144
|
+
"ds-app-layout gained scrollReset: \"path\" | \"never\" | \"always\" (default \"path\" = existing behaviour, so NO ACTION), and LayoutNavigationService is now exported. If you wrote your own \"did the path change?\" check to work around the layout resetting scroll - or to skip a view transition, or to reset a tab - replace it with inject(LayoutNavigationService).pathChanged: it is NavigationEnd, path only, de-duplicated, and it skips a navigation carrying state: { dsSamePage: true }. Note a naive split(\"?\") is NOT equivalent, it keeps the fragment this stream strips. To stop the layout resetting scroll on a paged or filtered list, set scrollReset=\"never\" and call LayoutScrollService.scrollToTop() where you actually want it.",
|
|
145
|
+
"Options in ds-select / ds-autocomplete / ds-multi-select panels now have a pressed state (they had hover only, which does nothing on touch). No action - visual only. If you styled :active on .option yourself to work around it, you can drop that override; if you want a different pressed fill, it reads --surface-muted (neutral rows) and --primary-subtitle (the selected row).",
|
|
146
|
+
"ds-table gained filterMode: \"client\" | \"server\" | \"none\" (default \"client\" = existing behaviour, so NO ACTION) and columnFilterOptions. If your table is server-paged (you bind `total`) and any column has filter: \"set\", you WANT filterMode=\"server\" plus columnFilterOptions with the real value domain - otherwise the checklist offers only the values on the current page and then filters locally on top of the server. A dev warning now points this out.",
|
|
147
|
+
"ds-table gained dsHeaderFilter, a template slot for a header filter the built-in checklist cannot express (date range, numeric threshold, async options). Additive, NO ACTION. If you built a host-owned popover outside the table for this, you can move it inside: <ng-template dsHeaderFilter=\"key\" [active]=\"...\" let-close=\"close\">. The table keeps the button, the popover and the active styling; `active` is how you tell it your criterion is set, and `close` dismisses the panel after applying. A projected filter also makes the column filterable on its own - you do not additionally need filter: \"set\".",
|
|
148
|
+
"ds-table now announces sort state and row range through its role=\"status\" region (\"Sorted by Owner, ascending\", \"Showing 1-25 of 240\"). No action - it is additive and the first render stays silent, since aria-live announces changes rather than initial content. If you added your own live region around the table for this, remove it or you will get double announcements. Wording is overridable per table through the sortAnnouncement and rangeAnnouncement inputs, which take the facts and return the sentence.",
|
|
149
|
+
"ds-table column resizing is now keyboard-operable: the handle is focusable (role=\"separator\", labelled per column) and answers Arrow (16px), PageUp/PageDown (64px) and Home (back to automatic sizing). No action. If you hid or restyled .col-resize, note it can now receive focus and shows an indicator.",
|
|
150
|
+
"ds-table exportFetcher may now resolve a Blob or a URL string as well as rows, so a backend-formatted file downloads as-is; a new exportFailed output emits the rejection. Additive, NO ACTION - returning rows keeps working. If you wrapped the button to catch failures yourself, you can drop that.",
|
|
151
|
+
"ds-table: the FIRST column resize now freezes every visible column at its measured width before applying the drag, so untouched columns stop jumping. No action, but if you persist columnWidths (persistLayout) expect the stored map to gain entries for columns the user never dragged - that is the fix, not a bug.",
|
|
152
|
+
"ds-table sortValue string comparison now uses sensitivity: \"base\" alongside numeric: true, so mixed-case and accented values sort together. No action; if you relied on case-sensitive ordering, pass your own sortValue returning a normalized key.",
|
|
153
|
+
"ds-date-picker keeps its trigger indicator while the panel is open (an \"open\" class alongside the focus rules). Visual only, NO ACTION. If you styled .trigger:focus-within yourself to work around the trigger going dark, you can drop it.",
|
|
154
|
+
"ds-autocomplete in single mode collapses its filter input once a value is chosen and the panel is closed, so the field reads as a picker instead of a text box. Visual only, NO ACTION. Clicking the field still opens the panel and expands the input, and typing still filters. If you set --ds-autocomplete-input-minw to work around the empty box, you can drop it.",
|
|
155
|
+
"ds-date-picker: clicking the calendar glyph no longer moves focus into the day grid. It now behaves like a click on the field - with allowInput (the default) the caret stays in the field, and a read-only field still focuses the grid. No action; ArrowDown on the field enters the grid as before. If you scripted tests that assumed a glyph click lands focus on a day button, they need updating."
|
|
156
|
+
]
|
|
157
|
+
}
|
package/migrations/README.md
CHANGED
|
@@ -30,9 +30,16 @@ See `AUTHORING.md` for how to write a good entry.
|
|
|
30
30
|
**Prose guides per version.** The `<version>.json` manifest is the terse machine mirror. When a
|
|
31
31
|
release needs a longer human walkthrough (a worked before/after, a mental model, edge cases the
|
|
32
32
|
`note` can't hold), put it in a sibling folder named for that version: `migrations/<version>/*.md`
|
|
33
|
-
(e.g. `migrations/0.5.1/badge-statuses.md`). The folder never matches the `*.json` glob, so tooling
|
|
33
|
+
(e.g. `migrations/0.5.1/badge-statuses.md`, `migrations/unreleased/README.md`). The folder never matches the `*.json` glob, so tooling
|
|
34
34
|
ignores it; the manifest `note` and the CHANGELOG point at the guide by path.
|
|
35
35
|
|
|
36
|
+
**A guide should carry the half a manifest cannot: what the consumer can now DELETE.** Two
|
|
37
|
+
dogfooding audits (mm-ecm 08-06, mm-broker 08-07) read consumer stylesheets as a record of what
|
|
38
|
+
this library made them write, and both found the same thing — most workarounds were written
|
|
39
|
+
against hooks that ALREADY existed, because a release note says what broke and never says what
|
|
40
|
+
became unnecessary. `unreleased/README.md` §3 is the first guide to carry that list; treat it as
|
|
41
|
+
the shape to follow.
|
|
42
|
+
|
|
36
43
|
**Authoring:** drafted at release time alongside the CHANGELOG entry (the `/changelog` workflow
|
|
37
44
|
drafts it from the release diff; the release author reviews). The prose changelog stays canonical
|
|
38
45
|
for humans — the manifest is its machine mirror; if they disagree, fix the manifest.
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
# Migrating to the next release
|
|
2
|
+
|
|
3
|
+
The manifest (`../unreleased.json`) is the terse machine mirror — what a tool applies.
|
|
4
|
+
This is the human half: **where to look, what to change, and what you can now delete.**
|
|
5
|
+
|
|
6
|
+
> **If you are on 0.7.x**, you are taking two releases at once. Read the 0.8.0 notes
|
|
7
|
+
> first; everything below is on top of them.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## 1. What breaks — eight things, by where you will find them
|
|
12
|
+
|
|
13
|
+
Work through them in this order. The first three are one rename and are best done together.
|
|
14
|
+
|
|
15
|
+
### In your templates
|
|
16
|
+
|
|
17
|
+
| Look for | Change to | Notes |
|
|
18
|
+
| --- | --- | --- |
|
|
19
|
+
| `<ds-auth-shell>` | `<ds-auth-layout>` | Inputs, outputs and slots all keep their names |
|
|
20
|
+
| `sortMode` / `filterMode` **absent** on a `ds-table` | Add `sortMode="client"` (and `filterMode="client"`) **if the table holds every row** | The default flipped to `"server"`. See §2 |
|
|
21
|
+
|
|
22
|
+
### In your TypeScript
|
|
23
|
+
|
|
24
|
+
| Look for | Change to |
|
|
25
|
+
| --- | --- |
|
|
26
|
+
| `AuthShellComponent` | `AuthLayoutComponent` |
|
|
27
|
+
|
|
28
|
+
### In your stylesheets
|
|
29
|
+
|
|
30
|
+
| Look for | Change to | Notes |
|
|
31
|
+
| --- | --- | --- |
|
|
32
|
+
| `--ds-auth-shell-*` | `--ds-auth-layout-*` | Six tokens. **Do not** rename `--auth-card-w` — it carries no such prefix |
|
|
33
|
+
| `--search-h` | `--ds-search-height`, or `--ds-field-height` for the whole family | The global token is gone; a declaration of it is now inert |
|
|
34
|
+
|
|
35
|
+
### Visual changes to eyeball
|
|
36
|
+
|
|
37
|
+
- **`ds-search` is 40px tall, was 36px.** It was the only control in the library on that
|
|
38
|
+
height. Restore with `ds-search { --ds-search-height: 36px; }` if your toolbar depends
|
|
39
|
+
on it — but see §3 first, because a pin may not be what you want.
|
|
40
|
+
- **`ds-number-stepper` at `size="lg"` is 48px, was 44px.** Other sizes unchanged.
|
|
41
|
+
|
|
42
|
+
### Worth a deliberate pass, not a find/replace
|
|
43
|
+
|
|
44
|
+
- **Signal Forms bind to DS controls.** `<ds-input [formField]="f.email" />` — that is the whole
|
|
45
|
+
integration; `[formField]` comes from `@angular/forms/signals`, not from this library. Thirteen
|
|
46
|
+
of fifteen controls already bound before this release; the other two, and the `readonly()`,
|
|
47
|
+
`pattern()`, `minLength()` and `hidden()` rules, work now. If you hand-bound
|
|
48
|
+
`[value]="f.x().value()" (valueChange)="f.x().value.set($event)"` per field, **all of that can
|
|
49
|
+
go.** Give each validator a `message`, or map the kinds once in `provideDsConfig`, or the field
|
|
50
|
+
turns red with no words. See the Practice → Signal Forms page.
|
|
51
|
+
|
|
52
|
+
- **`ds-tabs` can now own the URL.** Set `urlParam="tab"` and the active tab survives F5,
|
|
53
|
+
a shared link and the Back button. Per strip: give each `ds-tab` a `value` (the URL is
|
|
54
|
+
written from it, so without one your links carry the visible label and break when it is
|
|
55
|
+
reworded), use **one parameter name per strip** (two strips sharing a name erase each
|
|
56
|
+
other — there is a dev warning), and delete any hand-rolled `queryParamMap` + `navigate()`
|
|
57
|
+
wiring, which would otherwise fight it.
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 2. The one that needs judgement per table
|
|
62
|
+
|
|
63
|
+
`sortMode` and `filterMode` default to `'server'` now, where they used to default to
|
|
64
|
+
`'client'`.
|
|
65
|
+
|
|
66
|
+
**Why it changed:** server-paged is the normal case, and there the old default was
|
|
67
|
+
actively wrong — the table sorted the page in hand, so rows looked sorted and were not.
|
|
68
|
+
|
|
69
|
+
**How to decide, per table:**
|
|
70
|
+
|
|
71
|
+
- **Binds `total`?** It is server-paged. The new default is what you wanted; do nothing.
|
|
72
|
+
- **Does not bind `total`?** It almost certainly holds every row. Add `sortMode="client"`,
|
|
73
|
+
and `filterMode="client"` if any column has `filter: 'set'` — otherwise the headers stay
|
|
74
|
+
clickable and do nothing.
|
|
75
|
+
|
|
76
|
+
**How to find them all:** run the app in dev and read the console. A reversed dev warning
|
|
77
|
+
now fires on exactly the case that needs your attention (no `total`, sortable or filterable
|
|
78
|
+
columns, no declared mode) and names each table.
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 3. What you can now DELETE — the half a migration guide usually leaves out
|
|
83
|
+
|
|
84
|
+
Two dogfooding audits (mm-ecm 2026-08-06, mm-broker 2026-08-07) read consumer stylesheets
|
|
85
|
+
as a record of what this library made them write. Both found the same thing: **most of the
|
|
86
|
+
workarounds were written against hooks that already existed** — the consumer had no signal
|
|
87
|
+
that anything had been tokenised since. That is a failure of these notes, not of the
|
|
88
|
+
consumer, so here is the list.
|
|
89
|
+
|
|
90
|
+
Search your styles for these; if you find them, they can go.
|
|
91
|
+
|
|
92
|
+
| If you have | Delete it, because |
|
|
93
|
+
| --- | --- |
|
|
94
|
+
| `.button.button.button { … }` or rules against `.v-outline` / `.c-secondary` | `ds-button` reflects `[data-variant]` and `[data-color]` on the HOST. Use `ds-button[data-variant="outline"]` |
|
|
95
|
+
| `--radius-sm: 0` to square a checkbox | `--ds-checkbox-radius` |
|
|
96
|
+
| `.title.title { font-size }` inside a modal | `--ds-modal-title-font-size` |
|
|
97
|
+
| Pagination label type overrides | `--ds-pagination-label-*` |
|
|
98
|
+
| `.size { display: none }` on a pager | `[showPageSize]="false"` — and it is now forwarded through `ds-table` too |
|
|
99
|
+
| `.actions:empty { display: none }` on a modal | The library already ships it |
|
|
100
|
+
| `--ds-modal-divider: transparent`, plus whatever you rewrote the modal padding to afterwards | `[dividers]="false"` — it drops the rules *and* the padding that existed to clear them |
|
|
101
|
+
| A defensive hover rule on the selected dropdown row | The `:not(.is-selected)` branch already handles it |
|
|
102
|
+
| `ds-menu-divider { padding: 0 }` | `--ds-menu-divider-spacing`, which already defaults to 0 |
|
|
103
|
+
| A dozen scattered `--ds-*-radius: 0` | For a fully square brand, four lines: `--radius-sm/md/lg/xl: 0` (leave `--radius-pill`). Measured — the three ROLES alone leave options, clear buttons and dropdown panels rounded; they are the tool for squaring one family and keeping another. Worked example on the Theming page |
|
|
104
|
+
| A global rule squaring `.ds-overlay-pane` | Radius and elevation roles now travel onto portaled panes when the host overrides them |
|
|
105
|
+
| Absolutely positioning a search glyph over an autocomplete, or hiding `.autocomplete-chevron` | `dsAutocompletePrefix` and `[showChevron]="false"` |
|
|
106
|
+
| Querying the autocomplete's inner `<input>` and dispatching a synthetic `input` event to clear it | `clear()` |
|
|
107
|
+
| A hand-built KPI tile whose value is a badge | `ds-stat` takes a projected `[dsStatValue]` |
|
|
108
|
+
| A pinned `--ds-search-height` (or any sibling) to get a shorter control row | `density="compact"` on the container — every field control is 32px there, measured |
|
|
109
|
+
| A hand-rolled `.scrim` + `.panel` dialog, written because the modal header could not hold a badge or a second line | `ds-modal` projects `[title-badge]` and takes a `subtitle`. You get back the focus trap, focus restore, the scroll lock, Escape and the footer |
|
|
110
|
+
| `[value]="f.x().value()" (valueChange)="f.x().value.set($event)"` on every field of a signal form | `[formField]="f.x"` — the control implements the contract already |
|
|
111
|
+
| `white-space: normal` forced onto a badge in a table cell | `--ds-badge-white-space` |
|
|
112
|
+
| `::ng-deep .card { height: 100% }` for equal-height cards | The card's box fills a stretched host on its own |
|
|
113
|
+
| `!important` on `ds-table` cell padding under `density="compact"` | Compact no longer out-specifies the padding hooks |
|
|
114
|
+
| A wrapper around `ds-table` for sort/range announcements, keyboard column resize, or a header filter the checklist cannot express | All three ship: the live region, the `role="separator"` handle, and `dsHeaderFilter` |
|
|
115
|
+
|
|
116
|
+
**How to check you got them all:** grep your styles for `::ng-deep`, `!important` and any
|
|
117
|
+
selector naming a DS internal class (`.button`, `.trigger`, `.option`, `.modal`). Each hit
|
|
118
|
+
is either a genuine gap worth reporting or an entry in the table above.
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## 4. After you bump
|
|
123
|
+
|
|
124
|
+
- **Run the app in dev with the console open.** The library warns about the combinations it
|
|
125
|
+
cannot fix for you: undeclared sort/filter mode, duplicate `urlParam`, lazy without
|
|
126
|
+
`virtualScroll`, an unknown icon name, a projected stat value with an orphaned `unit`.
|
|
127
|
+
Every warning names the component and what to do.
|
|
128
|
+
- **Check a toolbar and a form row side by side.** The field-height contract moved
|
|
129
|
+
`ds-search`, so anything you had lined up by hand is worth a second look. If you pin
|
|
130
|
+
heights per component, consider `[data-density]` instead — it retunes the whole family at
|
|
131
|
+
once and survives the next change of this kind.
|
|
132
|
+
- **Tell us what you had to hand-roll.** The delete list in §3 exists because two consumers
|
|
133
|
+
wrote forty lines of workarounds against hooks that were already there. If you are
|
|
134
|
+
reaching into a DS internal, that is a gap worth filing.
|
package/package.json
CHANGED
|
@@ -5,6 +5,17 @@
|
|
|
5
5
|
// declares the matching rules so the portaled panel renders styled.
|
|
6
6
|
|
|
7
7
|
.ds-dropdown-panel {
|
|
8
|
+
/* The selected row used to paint straight from the theme roles, so a brand that
|
|
9
|
+
wanted a different selected treatment had to RETARGET --primary-* inside this
|
|
10
|
+
panel — and then track which other content in it read the same role. Named
|
|
11
|
+
hooks instead; the defaults are those roles, so nothing moves and a retuned
|
|
12
|
+
palette still flows through. Panel-level, not per-component: one partial
|
|
13
|
+
paints the rows for select, autocomplete and multi-select alike. */
|
|
14
|
+
--_option-selected-bg-color: var(--ds-option-selected-bg-color, var(--primary-subtitle));
|
|
15
|
+
--_option-selected-label-color: var(--ds-option-selected-label-color, var(--primary-strong));
|
|
16
|
+
--_option-selected-bg-color-hover: var(--ds-option-selected-bg-color-hover, var(--primary-muted));
|
|
17
|
+
--_option-check-color: var(--ds-option-check-color, var(--primary));
|
|
18
|
+
|
|
8
19
|
.dropdown-panel {
|
|
9
20
|
// Fill the cdk-overlay-pane width (set from trigger.getBoundingClientRect()
|
|
10
21
|
// in dropdown.component.ts). Without `width: 100%` the panel is a flex
|
|
@@ -12,7 +23,7 @@
|
|
|
12
23
|
width: 100%;
|
|
13
24
|
background: var(--surface-overlay);
|
|
14
25
|
border: var(--border-width-default) solid var(--border-default);
|
|
15
|
-
border-radius: var(--radius-
|
|
26
|
+
border-radius: var(--ds-radius-panel);
|
|
16
27
|
box-shadow: var(--shadow-popover);
|
|
17
28
|
padding: var(--space-1);
|
|
18
29
|
max-height: 320px;
|
|
@@ -70,7 +81,7 @@
|
|
|
70
81
|
font: var(--font-weight-medium) var(--font-size-s) / var(--line-height-flat) var(--font-sans);
|
|
71
82
|
color: var(--text-primary);
|
|
72
83
|
cursor: pointer;
|
|
73
|
-
border-radius: var(--radius-
|
|
84
|
+
border-radius: var(--ds-radius-inner);
|
|
74
85
|
text-align: left;
|
|
75
86
|
transition: background-color var(--duration-fast) var(--ease-standard);
|
|
76
87
|
|
|
@@ -88,7 +99,7 @@
|
|
|
88
99
|
}
|
|
89
100
|
|
|
90
101
|
.option-check {
|
|
91
|
-
color: var(--
|
|
102
|
+
color: var(--_option-check-color);
|
|
92
103
|
flex: 0 0 auto;
|
|
93
104
|
}
|
|
94
105
|
|
|
@@ -101,20 +112,36 @@
|
|
|
101
112
|
background: var(--surface-secondary);
|
|
102
113
|
}
|
|
103
114
|
|
|
115
|
+
// Pressed. The equivalent rows elsewhere (ds-menu-item, ds-list-item) have
|
|
116
|
+
// had one since 2026-07-02; the picker panels were left with hover only, so
|
|
117
|
+
// a tap on a phone — where there is no hover at all — gave no feedback that
|
|
118
|
+
// the row had been hit. One rule here covers select, autocomplete and
|
|
119
|
+
// multi-select, which all render their options through this partial.
|
|
120
|
+
&:active:not(.is-disabled) {
|
|
121
|
+
background: var(--surface-muted);
|
|
122
|
+
}
|
|
123
|
+
|
|
104
124
|
&:focus-visible {
|
|
105
125
|
outline: none;
|
|
106
126
|
box-shadow: var(--ds-control-focus-shadow);
|
|
107
127
|
}
|
|
108
128
|
|
|
109
129
|
&.is-selected {
|
|
110
|
-
background: var(--
|
|
111
|
-
color: var(--
|
|
130
|
+
background: var(--_option-selected-bg-color);
|
|
131
|
+
color: var(--_option-selected-label-color);
|
|
112
132
|
|
|
113
|
-
.option-icon { color: var(--
|
|
133
|
+
.option-icon { color: var(--_option-selected-label-color); }
|
|
114
134
|
|
|
115
135
|
&:hover:not(.is-disabled),
|
|
116
136
|
&.is-active:not(.is-disabled) {
|
|
117
|
-
background: var(--
|
|
137
|
+
background: var(--_option-selected-bg-color-hover);
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
// Selected rows keep the brand family when pressed, for the same reason
|
|
141
|
+
// the hover above exists: falling back to the neutral pressed fill would
|
|
142
|
+
// strand the selected label colour on it.
|
|
143
|
+
&:active:not(.is-disabled) {
|
|
144
|
+
background: var(--_option-selected-bg-color);
|
|
118
145
|
}
|
|
119
146
|
}
|
|
120
147
|
|
package/styles/_field-box.scss
CHANGED
|
@@ -10,8 +10,13 @@
|
|
|
10
10
|
// `--ds-field-height` is the public override and beats the size class, because a
|
|
11
11
|
// consumer setting it has already decided. Per-instance is CSS-variable scoping:
|
|
12
12
|
// `ds-select { --ds-field-height: 44px; }`.
|
|
13
|
-
|
|
14
|
-
|
|
13
|
+
// `$prop` is `min-height` for a box that must be able to grow — autocomplete and
|
|
14
|
+
// multi-select wrap chips onto a second line, and a fixed height would clip them.
|
|
15
|
+
// `--_field-box-height` holds the RESOLVED height, so a control that derives other
|
|
16
|
+
// geometry from it (number-stepper sizes its buttons off its own height) can read
|
|
17
|
+
// it back instead of restating the fallback chain.
|
|
18
|
+
@mixin field-box-height($size: md, $prop: height) {
|
|
19
|
+
--_field-box-height: var(--ds-field-height, var(--field-h-#{$size}));
|
|
15
20
|
|
|
16
|
-
|
|
21
|
+
#{$prop}: var(--_field-box-height);
|
|
17
22
|
}
|
|
@@ -13,9 +13,15 @@
|
|
|
13
13
|
// `--ds-<surface>-enter-offset` / `-scale`. One keyframe therefore serves every
|
|
14
14
|
// surface, and swapping presets never loses the surface's own geometry.
|
|
15
15
|
//
|
|
16
|
-
//
|
|
17
|
-
//
|
|
18
|
-
//
|
|
16
|
+
// Exit presets mirror the entrances and are swappable the same way, via
|
|
17
|
+
// `--ds-<surface>-leave-keyframes`. They were absent until 2026-08-10 for a real
|
|
18
|
+
// reason — teardown matched the animation NAME, so renaming the keyframe broke
|
|
19
|
+
// closing entirely — and the guard now checks that the event came from the
|
|
20
|
+
// animated element rather than from something inside it, which frees the name.
|
|
21
|
+
//
|
|
22
|
+
// An exit reads `--_ds-exit-*` and falls back to the matching `--_ds-enter-*`, so
|
|
23
|
+
// a surface that leaves the way it arrived declares nothing: one preset replaces
|
|
24
|
+
// the drawer's four direction-specific keyframes.
|
|
19
25
|
|
|
20
26
|
/* Opacity only — the calmest entrance. */
|
|
21
27
|
@keyframes ds-fade-in {
|
|
@@ -48,3 +54,42 @@
|
|
|
48
54
|
transform: translate(var(--_ds-enter-x, 0), var(--_ds-enter-y, 0));
|
|
49
55
|
}
|
|
50
56
|
}
|
|
57
|
+
|
|
58
|
+
/* ── Exits ───────────────────────────────────────────────────────────────── */
|
|
59
|
+
|
|
60
|
+
/* Opacity only — the calmest exit, and what a scrim wants. */
|
|
61
|
+
@keyframes ds-fade-out {
|
|
62
|
+
to {
|
|
63
|
+
opacity: 0;
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/* Shrinks away as it fades — the mirror of ds-scale-in. */
|
|
68
|
+
@keyframes ds-scale-out {
|
|
69
|
+
to {
|
|
70
|
+
opacity: 0;
|
|
71
|
+
transform: scale(var(--_ds-exit-scale, var(--_ds-enter-scale, 0.96)));
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/* Travels a short distance while fading — the mirror of ds-slide-in. */
|
|
76
|
+
@keyframes ds-slide-out {
|
|
77
|
+
to {
|
|
78
|
+
opacity: 0;
|
|
79
|
+
transform: translate(
|
|
80
|
+
var(--_ds-exit-x, var(--_ds-enter-x, 0)),
|
|
81
|
+
var(--_ds-exit-y, var(--_ds-enter-y, 0))
|
|
82
|
+
);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/* Edge-anchored travel with NO fade, for panels that slide fully off-screen
|
|
87
|
+
(drawer, bottom-sheet) where a fade would read as a flicker. */
|
|
88
|
+
@keyframes ds-slide-edge-out {
|
|
89
|
+
to {
|
|
90
|
+
transform: translate(
|
|
91
|
+
var(--_ds-exit-x, var(--_ds-enter-x, 0)),
|
|
92
|
+
var(--_ds-exit-y, var(--_ds-enter-y, 0))
|
|
93
|
+
);
|
|
94
|
+
}
|
|
95
|
+
}
|
package/styles/_tokens.scss
CHANGED
|
@@ -419,7 +419,7 @@
|
|
|
419
419
|
--modal-w-fullscreen: calc(100vw - var(--space-6));
|
|
420
420
|
--modal-h-fullscreen: calc(100vh - var(--space-6));
|
|
421
421
|
|
|
422
|
-
/* Auth
|
|
422
|
+
/* Auth layout */
|
|
423
423
|
--auth-card-w: 420px;
|
|
424
424
|
|
|
425
425
|
/* Drawer */
|
|
@@ -443,9 +443,6 @@
|
|
|
443
443
|
--field-floating-label-top: 8px;
|
|
444
444
|
--field-num-stepper-w: var(--space-8);
|
|
445
445
|
|
|
446
|
-
/* Search */
|
|
447
|
-
--search-h: var(--hit-md);
|
|
448
|
-
|
|
449
446
|
/* OTP / PIN input — one box per digit. */
|
|
450
447
|
--otp-cell-w: var(--space-12); /* 48px */
|
|
451
448
|
--otp-cell-h: var(--space-14); /* 56px */
|