@shineuix/angular 1.0.0 → 1.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/index.d.ts CHANGED
@@ -39,7 +39,7 @@ declare interface SuiAccordion extends Components.SuiAccordion {
39
39
  }
40
40
  declare class SuiAccordionItem {
41
41
  /**
42
- * Greys the header and blocks toggling.
42
+ * Grays the header and blocks toggling.
43
43
  * @default false
44
44
  */
45
45
  disabled: Components.SuiAccordionItem['disabled'];
@@ -300,7 +300,7 @@ declare class SuiAutoComplete {
300
300
  size: Components.SuiAutoComplete['size'];
301
301
  /**
302
302
  * Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover
303
- * wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value
303
+ * wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value
304
304
  * reads on a `tone="brand"` toolbar. Opening the field shows its shell in the card's own inks. The
305
305
  * default variant ignores it.
306
306
  */
@@ -718,8 +718,12 @@ declare class SuiButton {
718
718
  /**
719
719
  * Blocks clicks. Filled roles take the disabled well, an outline keeps its surface, and ghost
720
720
  * and link stay bare; on navy (`tone="inverse"`) the ink fades instead. A disabled link keeps
721
- * the look, drops its `href`, reads `aria-disabled="true"` and takes no pointer events, since an
722
- * anchor has no `disabled` attribute of its own.
721
+ * the look, drops its `href`, reads `aria-disabled="true"` and swallows a click, since an anchor
722
+ * has no `disabled` attribute of its own. A disabled button leaves the tab order; to keep it
723
+ * there, so a keyboard or screen reader user reaches it and the reason beside it, set
724
+ * `aria-disabled="true"` on the element instead. The button then reads as disabled, takes the
725
+ * same look and ignores a click, Enter and Space; a link drops its `href` and stays a tab stop.
726
+ * An `aria-describedby` on the element reaches the button too, so the reason is read with it.
723
727
  * @default false
724
728
  */
725
729
  disabled: Components.SuiButton['disabled'];
@@ -757,7 +761,8 @@ declare class SuiButton {
757
761
  * Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy,
758
762
  * `aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap
759
763
  * around it holds; a click, Enter or Space does nothing until it clears. A link behaves the
760
- * same and keeps its `href`. Reflected.
764
+ * same: it drops its `href` until the work is done and stays a tab stop, so nothing opens
765
+ * it, a new tab included. Reflected.
761
766
  * @default false
762
767
  */
763
768
  loading: Components.SuiButton['loading'];
@@ -780,7 +785,9 @@ declare class SuiButton {
780
785
  */
781
786
  rel?: Exclude<Components.SuiButton['rel'], undefined>;
782
787
  /**
783
- * Control height: sm 28px, md 34px (toolbars), lg 42px (forms). Reflected.
788
+ * Control height: sm 28px (packed rows), md 34px (forms and toolbars), lg 42px (beside the
789
+ * 42px fields of a sign-in or marketing page), xl 44px (that page's call to action, and the
790
+ * smallest touch target). Reflected.
784
791
  * @default 'md'
785
792
  */
786
793
  size: Components.SuiButton['size'];
@@ -798,7 +805,7 @@ declare class SuiButton {
798
805
  * `inverse` is for a quiet button sitting on dark chrome, an app bar or a side rail, where the
799
806
  * default ink would read against the panel rather than on it. It paints `--ink-inverse-muted` and
800
807
  * brightens to `--ink-inverse` on hover, matching `sui-icon-button`'s tone of the same name so a
801
- * labelled button and an icon button agree on a brand bar.
808
+ * labeled button and an icon button agree on a brand bar.
802
809
  */
803
810
  tone?: Exclude<Components.SuiButton['tone'], undefined>;
804
811
  /**
@@ -1144,7 +1151,7 @@ declare class SuiCarousel {
1144
1151
  index: Components.SuiCarousel['index'];
1145
1152
  /**
1146
1153
  * `horizontal` (default) runs the pages sideways with the arrows either side. `vertical` stacks
1147
- * them and pages downwards: the arrows sit above and below, ArrowUp and ArrowDown page, the
1154
+ * them and pages downward: the arrows sit above and below, ArrowUp and ArrowDown page, the
1148
1155
  * swipe runs up and down, and the viewport takes `height`. Unknown values fall back to
1149
1156
  * `horizontal`.
1150
1157
  * @default 'horizontal'
@@ -1290,7 +1297,7 @@ declare class SuiCascadeSelect {
1290
1297
  size: Components.SuiCascadeSelect['size'];
1291
1298
  /**
1292
1299
  * Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover
1293
- * wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value
1300
+ * wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value
1294
1301
  * reads on a `tone="brand"` toolbar. Opening the field shows its shell in the card's own inks. The
1295
1302
  * default variant ignores it.
1296
1303
  */
@@ -3780,7 +3787,7 @@ declare class SuiDataGrid {
3780
3787
  * plain-text copy prefixes such a cell with an apostrophe, the mark Excel and Sheets read as
3781
3788
  * "this is text", so a cell holding `=HYPERLINK(…)` cannot run when pasted into a spreadsheet,
3782
3789
  * as OWASP advises for CSV and clipboard output. A paste into a ShineUI grid gets the cells
3783
- * exactly either way, from a private clipboard flavour the copy carries beside the plain text.
3790
+ * exactly either way, from a private clipboard flavor the copy carries beside the plain text.
3784
3791
  * @default false
3785
3792
  */
3786
3793
  copyFormulas: Components.SuiDataGrid['copyFormulas'];
@@ -3814,7 +3821,7 @@ declare class SuiDataGrid {
3814
3821
  * Where a column's filter control lives: a row of boxes under the header, or a menu opened from
3815
3822
  * a funnel on the header's end edge. A column takes part by declaring `filter: true`. The menu
3816
3823
  * offers up to two conditions suited to the column's type, joined by all or any, or a list of
3817
- * values to tick when the column sets `filterOptions`; it edits a draft and writes it on Apply.
3824
+ * values to check when the column sets `filterOptions`; it edits a draft and writes it on Apply.
3818
3825
  * Either way the grid writes the rule into `filterModel` and emits `suiFilter`.
3819
3826
  * @default 'none'
3820
3827
  */
@@ -4142,7 +4149,7 @@ declare class SuiDataTable {
4142
4149
  /**
4143
4150
  * Where the filter controls live: nowhere, in a row under the headers, or behind a funnel button
4144
4151
  * on each header's end edge. The menu offers up to two conditions suited to the column's type,
4145
- * joined by all or any, or a list of values to tick when the column sets `filterOptions`; it
4152
+ * joined by all or any, or a list of values to check when the column sets `filterOptions`; it
4146
4153
  * edits a draft and writes it on Apply.
4147
4154
  * @default 'none'
4148
4155
  */
@@ -4718,7 +4725,7 @@ declare class SuiDatePicker {
4718
4725
  todayDate?: Exclude<Components.SuiDatePicker['todayDate'], undefined>;
4719
4726
  /**
4720
4727
  * Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover
4721
- * wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value
4728
+ * wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value
4722
4729
  * reads on a `tone="brand"` toolbar. Opening the field shows its shell in the card's own inks. The
4723
4730
  * default variant ignores it.
4724
4731
  */
@@ -4779,6 +4786,14 @@ declare interface SuiDatePicker extends Components.SuiDatePicker {
4779
4786
  suiClose: EventEmitter<SuiDatePickerCustomEvent<SuiCloseReason>>;
4780
4787
  }
4781
4788
  declare class SuiDescriptionList {
4789
+ /**
4790
+ * Which side the values sit on, in the reading direction. `end` lines figures up on their last
4791
+ * digit, for a summary such as subtotal, tax and balance due. It is one side for the whole list,
4792
+ * as a table column has one: a list that mixes names and dates with amounts reads best at the
4793
+ * start. In the columns layout the term moves with its value.
4794
+ * @default 'start'
4795
+ */
4796
+ align: Components.SuiDescriptionList['align'];
4782
4797
  /**
4783
4798
  * Grid column count in the columns layout.
4784
4799
  * @default 2
@@ -4807,7 +4822,7 @@ declare class SuiDescriptionList {
4807
4822
  suiCopyError: EventEmitter<SuiDescriptionListCustomEvent<string>>;
4808
4823
  constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
4809
4824
  static ɵfac: i0.ɵɵFactoryDeclaration<SuiDescriptionList, never>;
4810
- static ɵcmp: i0.ɵɵComponentDeclaration<SuiDescriptionList, "sui-description-list", never, { "columns": { "alias": "columns"; "required": false; }; "items": { "alias": "items"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "termWidth": { "alias": "termWidth"; "required": false; }; }, { "suiCopy": "suiCopy"; "suiCopyError": "suiCopyError"; }, never, ["*"], true, never>;
4825
+ static ɵcmp: i0.ɵɵComponentDeclaration<SuiDescriptionList, "sui-description-list", never, { "align": { "alias": "align"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; "items": { "alias": "items"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "termWidth": { "alias": "termWidth"; "required": false; }; }, { "suiCopy": "suiCopy"; "suiCopyError": "suiCopyError"; }, never, ["*"], true, never>;
4811
4826
  }
4812
4827
  declare interface SuiDescriptionList extends Components.SuiDescriptionList {
4813
4828
  /**
@@ -5191,7 +5206,7 @@ declare class SuiEditBox {
5191
5206
  * and the edit path both read it through `sanitizeEditorHtml`: tags and attributes the editor
5192
5207
  * cannot produce are dropped, a script or a handler never reaches the page, and a link whose
5193
5208
  * address is not http, https, mailto, tel or sms, or a relative path, is shown as plain text.
5194
- * A picture is shown with `referrerpolicy="no-referrer"`. View mode writes the sanitised markup
5209
+ * A picture is shown with `referrerpolicy="no-referrer"`. View mode writes the sanitized markup
5195
5210
  * through the library's Trusted Types policy, `shineui`. The form value is the string as set, so
5196
5211
  * a value that came from your own store posts back unchanged until an edit is saved.
5197
5212
  * @default ''
@@ -5292,7 +5307,7 @@ declare class SuiEmptyState {
5292
5307
  */
5293
5308
  icon?: Exclude<Components.SuiEmptyState['icon'], undefined>;
5294
5309
  /**
5295
- * Outcome flavour: `empty`, `success` (the brand, never a green), `error` (the deep accent) or `not-found`.
5310
+ * Outcome flavor: `empty`, `success` (the brand, never a green), `error` (the deep accent) or `not-found`.
5296
5311
  * Sets the icon well colors and the default icon. Only `error` renders `role="alert"`, so only
5297
5312
  * a failed operation interrupts a screen reader; do not use it for a merely empty list. The
5298
5313
  * icon is `aria-hidden`, so the heading and body are the whole accessible content.
@@ -5309,7 +5324,7 @@ declare interface SuiEmptyState extends Components.SuiEmptyState {
5309
5324
  }
5310
5325
  declare class SuiFieldset {
5311
5326
  /**
5312
- * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.
5327
+ * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.
5313
5328
  * @default false
5314
5329
  */
5315
5330
  collapsed: Components.SuiFieldset['collapsed'];
@@ -5937,7 +5952,7 @@ declare class SuiGalleria {
5937
5952
  /**
5938
5953
  * Shows the full-screen viewer. Mutable; the element opens it from the full-screen control and
5939
5954
  * closes it on Escape, the scrim and the close control. Focus is trapped inside while it is open
5940
- * and returns to the control afterwards. While open, and while it fades out, the viewer paints in
5955
+ * and returns to the control afterward. While open, and while it fades out, the viewer paints in
5941
5956
  * the browser's top layer, so a transformed or clipping ancestor cannot trap it; everything
5942
5957
  * outside it is inert and the page does not scroll, and a node the page adds outside it while it
5943
5958
  * is open goes inert too. The viewer is `role="dialog"` with no `aria-modal`, so VoiceOver keeps
@@ -5994,8 +6009,12 @@ declare class SuiIconButton {
5994
6009
  /**
5995
6010
  * Blocks clicks. As on `sui-button`, filled roles take the disabled well, an outline keeps its
5996
6011
  * surface, a ghost stays bare, and on navy the ink fades. A disabled link keeps the look, drops its
5997
- * `href`, reads `aria-disabled="true"` and takes no pointer events, since an anchor has no
5998
- * `disabled` attribute of its own.
6012
+ * `href`, reads `aria-disabled="true"` and swallows a click, since an anchor has no `disabled`
6013
+ * attribute of its own. A disabled button leaves the tab order and its tooltip with it; to keep
6014
+ * both, so a keyboard or screen reader user reaches it and the reason the tooltip gives, set
6015
+ * `aria-disabled="true"` on the element instead. The button then reads as disabled, takes the
6016
+ * same look and ignores a click, Enter and Space. An `aria-describedby` on the element reaches
6017
+ * the button too.
5999
6018
  * @default false
6000
6019
  */
6001
6020
  disabled: Components.SuiIconButton['disabled'];
@@ -6025,7 +6044,8 @@ declare class SuiIconButton {
6025
6044
  * Shows a spinner in place of the icon and blocks clicks. The button stays focusable while busy,
6026
6045
  * `aria-disabled` rather than disabled, so a keyboard user keeps their place and a modal trap
6027
6046
  * around it holds; a click, Enter or Space does nothing until it clears. A link behaves the
6028
- * same and keeps its `href`. Reflected.
6047
+ * same: it drops its `href` until the work is done and stays a tab stop, so nothing opens
6048
+ * it, a new tab included. Reflected.
6029
6049
  * @default false
6030
6050
  */
6031
6051
  loading: Components.SuiIconButton['loading'];
@@ -6381,7 +6401,7 @@ declare class SuiImage {
6381
6401
  /**
6382
6402
  * Shows the lightbox. Mutable; the element opens it on click and closes it on Escape, the scrim
6383
6403
  * and the close control. Focus is trapped inside while it is open and returns to the frame
6384
- * afterwards. Zoomed past 1x, the picture drags to pan and the arrow keys pan it too. While open,
6404
+ * afterward. Zoomed past 1x, the picture drags to pan and the arrow keys pan it too. While open,
6385
6405
  * and while it fades out, the lightbox paints in the browser's top layer, so a transformed or
6386
6406
  * clipping ancestor cannot trap it; everything outside it is inert and the page does not scroll,
6387
6407
  * and a node the page adds outside it while it is open goes inert too. The lightbox is
@@ -6408,7 +6428,8 @@ declare class SuiImage {
6408
6428
  */
6409
6429
  src: Components.SuiImage['src'];
6410
6430
  /**
6411
- * Frame width: a number of px or any CSS length.
6431
+ * Width: a number of px or any CSS length, a percentage of the container included. The element
6432
+ * takes it, the frame fills it and the caption wraps to it.
6412
6433
  */
6413
6434
  width?: Exclude<Components.SuiImage['width'], undefined>;
6414
6435
  protected z: NgZone;
@@ -6795,6 +6816,13 @@ declare interface SuiInputMask extends Components.SuiInputMask {
6795
6816
  suiBlur: EventEmitter<SuiInputMaskCustomEvent<void>>;
6796
6817
  }
6797
6818
  declare class SuiInputNumber {
6819
+ /**
6820
+ * Which side of the field the number sits on, in the reading direction. Unset, a `money` field
6821
+ * sits at the end and any other at the start. Set `end` where figures stack and should line up
6822
+ * on their last digit: quantities, hours and rates in a line-item form, as a table's number
6823
+ * column does. A `quiet` field is as wide as its number, so it has no side to choose.
6824
+ */
6825
+ align?: Exclude<Components.SuiInputNumber['align'], undefined>;
6798
6826
  /**
6799
6827
  * Native autocomplete hint, e.g. "transaction-amount" or "postal-code".
6800
6828
  */
@@ -6912,7 +6940,7 @@ declare class SuiInputNumber {
6912
6940
  suffixText?: Exclude<Components.SuiInputNumber['suffixText'], undefined>;
6913
6941
  /**
6914
6942
  * Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover
6915
- * wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value
6943
+ * wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value
6916
6944
  * reads on a `tone="brand"` toolbar. Opening the field shows its shell in the card's own inks. The
6917
6945
  * default variant ignores it.
6918
6946
  */
@@ -6942,7 +6970,7 @@ declare class SuiInputNumber {
6942
6970
  suiBlur: EventEmitter<SuiInputNumberCustomEvent<void>>;
6943
6971
  constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
6944
6972
  static ɵfac: i0.ɵɵFactoryDeclaration<SuiInputNumber, never>;
6945
- static ɵcmp: i0.ɵɵComponentDeclaration<SuiInputNumber, "sui-input-number", never, { "autocomplete": { "alias": "autocomplete"; "required": false; }; "currency": { "alias": "currency"; "required": false; }; "decimals": { "alias": "decimals"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "error": { "alias": "error"; "required": false; }; "help": { "alias": "help"; "required": false; }; "hideButtons": { "alias": "hideButtons"; "required": false; }; "invalid": { "alias": "invalid"; "required": false; }; "label": { "alias": "label"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "max": { "alias": "max"; "required": false; }; "min": { "alias": "min"; "required": false; }; "money": { "alias": "money"; "required": false; }; "name": { "alias": "name"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "prefixText": { "alias": "prefixText"; "required": false; }; "readOnly": { "alias": "readOnly"; "required": false; }; "required": { "alias": "required"; "required": false; }; "size": { "alias": "size"; "required": false; }; "step": { "alias": "step"; "required": false; }; "suffixText": { "alias": "suffixText"; "required": false; }; "tone": { "alias": "tone"; "required": false; }; "value": { "alias": "value"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; }, { "suiChange": "suiChange"; "suiInput": "suiInput"; "suiFocus": "suiFocus"; "suiBlur": "suiBlur"; }, never, ["*"], true, never>;
6973
+ static ɵcmp: i0.ɵɵComponentDeclaration<SuiInputNumber, "sui-input-number", never, { "align": { "alias": "align"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "currency": { "alias": "currency"; "required": false; }; "decimals": { "alias": "decimals"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "error": { "alias": "error"; "required": false; }; "help": { "alias": "help"; "required": false; }; "hideButtons": { "alias": "hideButtons"; "required": false; }; "invalid": { "alias": "invalid"; "required": false; }; "label": { "alias": "label"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "max": { "alias": "max"; "required": false; }; "min": { "alias": "min"; "required": false; }; "money": { "alias": "money"; "required": false; }; "name": { "alias": "name"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "prefixText": { "alias": "prefixText"; "required": false; }; "readOnly": { "alias": "readOnly"; "required": false; }; "required": { "alias": "required"; "required": false; }; "size": { "alias": "size"; "required": false; }; "step": { "alias": "step"; "required": false; }; "suffixText": { "alias": "suffixText"; "required": false; }; "tone": { "alias": "tone"; "required": false; }; "value": { "alias": "value"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; }, { "suiChange": "suiChange"; "suiInput": "suiInput"; "suiFocus": "suiFocus"; "suiBlur": "suiBlur"; }, never, ["*"], true, never>;
6946
6974
  }
6947
6975
  declare interface SuiInputNumber extends Components.SuiInputNumber {
6948
6976
  /**
@@ -7380,7 +7408,7 @@ declare class SuiKnob {
7380
7408
  required: Components.SuiKnob['required'];
7381
7409
  static ngAcceptInputType_required: boolean | '';
7382
7410
  /**
7383
- * Increment between values; drag positions and keyboard steps snap to it. Decimals are honoured.
7411
+ * Increment between values; drag positions and keyboard steps snap to it. Decimals are honored.
7384
7412
  * A drag crosses the whole range in 150px whatever the step, so a coarse step lands on the grid
7385
7413
  * without slowing the drag.
7386
7414
  * @default 1
@@ -7840,7 +7868,7 @@ declare class SuiMeterGroup {
7840
7868
  * under it. `vertical` stands the bar up as a column that fills the height of the element or of
7841
7869
  * its parent (give one of them a height, e.g. `style="height:180px"`; 120px is the floor),
7842
7870
  * stacks the segments top to bottom in legend order, and puts the total and the legend beside
7843
- * it. An unrecognised value falls back to `horizontal`.
7871
+ * it. An unrecognized value falls back to `horizontal`.
7844
7872
  * @default 'horizontal'
7845
7873
  */
7846
7874
  orientation: Components.SuiMeterGroup['orientation'];
@@ -8007,7 +8035,7 @@ declare class SuiMultiSelect {
8007
8035
  size: Components.SuiMultiSelect['size'];
8008
8036
  /**
8009
8037
  * Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover
8010
- * wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value
8038
+ * wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value
8011
8039
  * reads on a `tone="brand"` toolbar. Opening the field shows its shell in the card's own inks. The
8012
8040
  * default variant ignores it.
8013
8041
  */
@@ -8213,7 +8241,7 @@ declare class SuiOrderList {
8213
8241
  selection: Components.SuiOrderList['selection'];
8214
8242
  /**
8215
8243
  * `single` picks one row at a time. `checkbox` draws a box on every row under a select-all
8216
- * header, and the four controls carry the whole ticked set at once. Spelled as on `sui-tree`,
8244
+ * header, and the four controls carry the whole checked set at once. Spelled as on `sui-tree`,
8217
8245
  * which names the same two ways of picking rows. Reflected.
8218
8246
  * @default 'single'
8219
8247
  */
@@ -8437,7 +8465,7 @@ declare interface SuiPaginator extends Components.SuiPaginator {
8437
8465
  }
8438
8466
  declare class SuiPanel {
8439
8467
  /**
8440
- * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterwards; writing it from script emits nothing.
8468
+ * Whether the body is hidden. Seeds the state (the reference `defaultCollapsed`) and tracks it afterward; writing it from script emits nothing.
8441
8469
  * @default false
8442
8470
  */
8443
8471
  collapsed: Components.SuiPanel['collapsed'];
@@ -8805,7 +8833,7 @@ declare class SuiPickList {
8805
8833
  selection: Components.SuiPickList['selection'];
8806
8834
  /**
8807
8835
  * `single` picks one row at a time. `checkbox` draws a box on every row under a per-pane
8808
- * select-all header, and the transfer controls carry the whole ticked set at once. Reflected.
8836
+ * select-all header, and the transfer controls carry the whole checked set at once. Reflected.
8809
8837
  * @default 'single'
8810
8838
  */
8811
8839
  selectionMode: Components.SuiPickList['selectionMode'];
@@ -9467,13 +9495,16 @@ declare interface SuiRichTextEditor extends Components.SuiRichTextEditor {
9467
9495
  }
9468
9496
  declare class SuiSaveStatus {
9469
9497
  /**
9470
- * Which line to show.
9471
- * @default 'saved'
9498
+ * Which line to show. `idle`, the default, has nothing to report: a record opened and not yet
9499
+ * edited. It draws nothing and stays in the page as the live region, so the first change is
9500
+ * announced; a live region added to the page together with its text is often not read. Keep the
9501
+ * element in place and change `state`, rather than adding it when there is something to say.
9502
+ * @default 'idle'
9472
9503
  */
9473
9504
  state: Components.SuiSaveStatus['state'];
9474
9505
  /**
9475
9506
  * When the record was saved, in the page's language, e.g. "2 min ago". The saved line reads
9476
- * "Saved 2 min ago"; without it, "Saved just now".
9507
+ * "Saved 2 min ago"; without it, "Saved just now". Read on the saved line only.
9477
9508
  */
9478
9509
  time?: Exclude<Components.SuiSaveStatus['time'], undefined>;
9479
9510
  protected z: NgZone;
@@ -9712,7 +9743,7 @@ declare class SuiSelect {
9712
9743
  size: Components.SuiSelect['size'];
9713
9744
  /**
9714
9745
  * Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover
9715
- * wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value
9746
+ * wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value
9716
9747
  * reads on a `tone="brand"` toolbar. Opening the field shows its shell in the card's own inks. The
9717
9748
  * default variant ignores it.
9718
9749
  */
@@ -10197,7 +10228,7 @@ declare interface SuiSparkline extends Components.SuiSparkline {
10197
10228
  declare class SuiSpeedDial {
10198
10229
  /**
10199
10230
  * Where the satellites fan out from the launcher. The first item is always the one nearest the
10200
- * launcher. An unrecognised value falls back to `up`.
10231
+ * launcher. An unrecognized value falls back to `up`.
10201
10232
  * @default 'up'
10202
10233
  */
10203
10234
  direction: Components.SuiSpeedDial['direction'];
@@ -10419,7 +10450,7 @@ declare class SuiSplitter {
10419
10450
  */
10420
10451
  orientation: Components.SuiSplitter['orientation'];
10421
10452
  /**
10422
- * Share of the whole the first pane takes (0 to 1): its width side by side, its height when vertical. Seeds the split (the reference `defaultRatio`) and tracks it afterwards.
10453
+ * Share of the whole the first pane takes (0 to 1): its width side by side, its height when vertical. Seeds the split (the reference `defaultRatio`) and tracks it afterward.
10423
10454
  * @default 0.5
10424
10455
  */
10425
10456
  ratio: Components.SuiSplitter['ratio'];
@@ -10548,7 +10579,7 @@ declare class SuiStatCard {
10548
10579
  * positive ink (the ink under brand status, green under semantic); `critical`, bad news (a
10549
10580
  * rising receivable), in the danger ink with the direction arrow ringed and a visually hidden
10550
10581
  * "unfavorable" after the figure; `neutral`, neither, in the muted ink at regular weight, the
10551
- * arrow kept and unringed. So the judgement never rests on colour alone. The danger ink
10582
+ * arrow kept and unringed. So the judgment never rests on color alone. The danger ink
10552
10583
  * is the brand's own under brand mode and rose under semantic status mode, the same ink an
10553
10584
  * overdue date wears. An unknown value reads as `positive`. Reflected.
10554
10585
  * @default 'positive'
@@ -10583,7 +10614,7 @@ declare interface SuiStatCard extends Components.SuiStatCard {
10583
10614
  }
10584
10615
  declare class SuiStepper {
10585
10616
  /**
10586
- * Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterwards; writing it from script emits nothing.
10617
+ * Index of the current step. Seeds it (the reference `defaultActive`) and tracks it afterward; writing it from script emits nothing.
10587
10618
  * @default 0
10588
10619
  */
10589
10620
  active: Components.SuiStepper['active'];
@@ -10635,7 +10666,7 @@ declare class SuiTab {
10635
10666
  */
10636
10667
  badge?: Exclude<Components.SuiTab['badge'], undefined>;
10637
10668
  /**
10638
- * Greys the tab and blocks activation.
10669
+ * Grays the tab and blocks activation.
10639
10670
  * @default false
10640
10671
  */
10641
10672
  disabled: Components.SuiTab['disabled'];
@@ -10659,7 +10690,7 @@ declare interface SuiTab extends Components.SuiTab {
10659
10690
  }
10660
10691
  declare class SuiTabs {
10661
10692
  /**
10662
- * Index of the active tab. Seeds the selection (the reference `defaultActive`) and tracks it afterwards; writing it from script moves the bar and emits nothing.
10693
+ * Index of the active tab. Seeds the selection (the reference `defaultActive`) and tracks it afterward; writing it from script moves the bar and emits nothing.
10663
10694
  * @default 0
10664
10695
  */
10665
10696
  active: Components.SuiTabs['active'];
@@ -10902,7 +10933,7 @@ declare class SuiThemePicker {
10902
10933
  /**
10903
10934
  * Code panes and consoles: `dark` (default) or `light`, written as `data-sui-code`. Independent
10904
10935
  * of `mode`, because the light set is computed from the theme rather than from the site's light
10905
- * or dark, so a dark site with a light code pane is a supported pair. Unrecognised values become
10936
+ * or dark, so a dark site with a light code pane is a supported pair. Unrecognized values become
10906
10937
  * `dark`.
10907
10938
  * @default 'dark'
10908
10939
  */
@@ -10917,13 +10948,13 @@ declare class SuiThemePicker {
10917
10948
  * `light`, `dark`, or `system`, which follows the operating system's `prefers-color-scheme` for
10918
10949
  * as long as the element is connected and writes whichever it resolves to. It is the starting
10919
10950
  * state: the switch in the kit shows what is painted and, pressed, picks light or dark outright,
10920
- * so `mode="system"` follows the OS until the reader chooses. Unrecognised values become
10951
+ * so `mode="system"` follows the OS until the reader chooses. Unrecognized values become
10921
10952
  * `light`. Light removes `data-sui-theme`.
10922
10953
  * @default 'light'
10923
10954
  */
10924
10955
  mode: Components.SuiThemePicker['mode'];
10925
10956
  /**
10926
- * Neutral family. Unrecognised values become `tint`.
10957
+ * Neutral family. Unrecognized values become `tint`.
10927
10958
  * @default 'tint'
10928
10959
  */
10929
10960
  neutral: Components.SuiThemePicker['neutral'];
@@ -10934,7 +10965,7 @@ declare class SuiThemePicker {
10934
10965
  persist: Components.SuiThemePicker['persist'];
10935
10966
  static ngAcceptInputType_persist: boolean | '';
10936
10967
  /**
10937
- * Named palette or `custom`. Unrecognised values become `shineui`.
10968
+ * Named palette or `custom`. Unrecognized values become `shineui`.
10938
10969
  * @default 'shineui'
10939
10970
  */
10940
10971
  preset: Components.SuiThemePicker['preset'];
@@ -11236,7 +11267,7 @@ declare class SuiToastHost {
11236
11267
  * viewport. A top stack grows downward and a bottom stack grows upward, so the newest toast is
11237
11268
  * always the one nearest the middle of the screen; `center` grows both ways and stays centered.
11238
11269
  * The corner names are sides of the screen in either reading direction; inside a toast the
11239
- * severity edge and the icon lead and the X trails. An unrecognised value falls back to `top-right`.
11270
+ * severity edge and the icon lead and the X trails. An unrecognized value falls back to `top-right`.
11240
11271
  * While toasts show, the stack paints in the browser's top layer, above dialogs and every other
11241
11272
  * surface but tooltips, so it answers to the viewport even inside a transformed or clipping box.
11242
11273
  * The live regions that announce the toasts stay where the element is, and stay live while a
@@ -11846,7 +11877,7 @@ declare class SuiTreeSelect {
11846
11877
  size: Components.SuiTreeSelect['size'];
11847
11878
  /**
11848
11879
  * Ink for the quiet variant on the brand chrome. `inverse` takes the inverse inks, the inverse hover
11849
- * wash and the inverse focus colour, as `sui-button`'s tone of the same name does, so the value
11880
+ * wash and the inverse focus color, as `sui-button`'s tone of the same name does, so the value
11850
11881
  * reads on a `tone="brand"` toolbar. Opening the field shows its shell in the card's own inks. The
11851
11882
  * default variant ignores it.
11852
11883
  */
@@ -12000,8 +12031,8 @@ declare class SuiTreeTable {
12000
12031
  */
12001
12032
  nullOrder: Components.SuiTreeTable['nullOrder'];
12002
12033
  /**
12003
- * The keys the user has ticked. Under `checkbox` a branch is stored only when it was ticked
12004
- * whole: the mixed and fully ticked states of every ancestor are derived from the tree on each
12034
+ * The keys the user has checked. Under `checkbox` a branch is stored only when it was checked
12035
+ * whole: the mixed and fully checked states of every ancestor are derived from the tree on each
12005
12036
  * render, so there is no second copy to go stale when the tree changes shape. Mutable; updated
12006
12037
  * before `suiSelectionChange` fires. Property, not attribute.
12007
12038
  * @default []
@@ -12009,7 +12040,7 @@ declare class SuiTreeTable {
12009
12040
  selection: Components.SuiTreeTable['selection'];
12010
12041
  /**
12011
12042
  * `none`, `single` (one highlighted row) or `checkbox` (a box per row, a select-all box in the
12012
- * header, and a tick that carries down a whole subtree).
12043
+ * header, and a check that carries down a whole subtree).
12013
12044
  * @default 'none'
12014
12045
  */
12015
12046
  selectionMode: Components.SuiTreeTable['selectionMode'];
@@ -12060,7 +12091,7 @@ declare interface SuiTreeTable extends Components.SuiTreeTable {
12060
12091
  */
12061
12092
  suiExpandedChange: EventEmitter<SuiTreeTableCustomEvent<SuiKey[]>>;
12062
12093
  /**
12063
- * Fires when the selection changes; detail is the new `selection`, the ticked keys. Does not
12094
+ * Fires when the selection changes; detail is the new `selection`, the checked keys. Does not
12064
12095
  bubble.
12065
12096
  */
12066
12097
  suiSelectionChange: EventEmitter<SuiTreeTableCustomEvent<SuiKey[]>>;
@@ -12096,7 +12127,7 @@ declare class SuiTrend {
12096
12127
  * the positive ink (the ink under brand status, green under semantic); `critical`, bad news, in
12097
12128
  * the danger ink with the arrow ringed and a hidden "unfavorable" after the figure; `neutral`,
12098
12129
  * neither, in the muted ink at regular weight, the arrow kept and unringed, so no tone rests on
12099
- * colour alone. Whether a rise is good is yours to say, since a rising receivable is
12130
+ * color alone. Whether a rise is good is yours to say, since a rising receivable is
12100
12131
  * bad: `severity="critical"` marks it. An unknown value reads as `positive`. Reflected.
12101
12132
  * @default 'positive'
12102
12133
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shineuix/angular",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "Angular standalone directives for ShineUI web components.",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -21,7 +21,7 @@
21
21
  },
22
22
  "dependencies": {
23
23
  "tslib": "^2.8.0",
24
- "@shineuix/core": "1.0.0"
24
+ "@shineuix/core": "1.0.2"
25
25
  },
26
26
  "peerDependencies": {
27
27
  "@angular/core": "^20.0.0 || ^21.0.0 || ^22.0.0",
@@ -29,6 +29,11 @@
29
29
  "rxjs": "^6.5.3 || ^7.4.0"
30
30
  },
31
31
  "author": "ShineUI contributors",
32
+ "repository": {
33
+ "type": "git",
34
+ "url": "git+https://github.com/smallandsimple/shineui.git",
35
+ "directory": "packages/angular"
36
+ },
32
37
  "homepage": "https://shineui.dev",
33
38
  "bugs": {
34
39
  "email": "info@shineui.dev"