@shineuix/angular 1.1.0 → 1.2.0

package/index.d.ts

@@ -208,8 +208,8 @@ declare class SuiAutoComplete {
     invalid: Components.SuiAutoComplete['invalid'];
     static ngAcceptInputType_invalid: boolean | '';
     /**
-     * Label above the field. Without one the field takes the host's `aria-label` or `aria-labelledby`
-     * as its name; a visible label wins over both.
+     * Label above the field, and the field's name: a host `aria-labelledby` or `aria-label` wins over it, as on a native field, and should contain it. Without one the host's attribute names
+     * the field.
      */
     label?: Exclude<Components.SuiAutoComplete['label'], undefined>;
     /**
@@ -2728,7 +2728,9 @@ declare class SuiCheckbox {
     invalid: Components.SuiCheckbox['invalid'];
     static ngAcceptInputType_invalid: boolean | '';
     /**
-     * Visible label.
+     * Visible label, and the box's name unless the element carries an `aria-label` or an
+     * `aria-labelledby`, which win as they do on a native checkbox. A name that differs, as
+     * "Mark INV-1042 paid" for a box labeled "Paid" in each row, should contain the visible label.
      */
     label?: Exclude<Components.SuiCheckbox['label'], undefined>;
     /**
@@ -3711,9 +3713,10 @@ declare class SuiCopyButton {
     errorLabel?: Exclude<Components.SuiCopyButton['errorLabel'], undefined>;
     /**
      * Success face: `icon` (default) shows the check glyph on its tint, so the button is the size of
-     * what it draws; `text` adds `copiedLabel` beside the check, for a toolbar with room, and holds
-     * that room at rest, so what sits beside the button does not move. The polite live region announces
-     * `copiedLabel` in both modes.
+     * what it draws; `text` writes a word beside the glyph, for a toolbar with room: "Copy" at rest and
+     * `copiedLabel` once copied. The word swaps in place and the button keeps the width of the longer
+     * of the two, so what sits beside it does not move. The polite live region announces `copiedLabel`
+     * in both modes.
      * @default 'icon'
      */
     feedback: Components.SuiCopyButton['feedback'];
@@ -5675,8 +5678,8 @@ declare class SuiFloatLabel {
     static ngAcceptInputType_invalid: boolean | '';
     /**
      * The floating label. It takes the placeholder's position, so there is no placeholder prop, and
-     * it names the field; only without one does the host's `aria-label` or `aria-labelledby`, the
-     * rule every text field shares.
+     * it names the field unless the host carries an `aria-labelledby` or an `aria-label`, which win as
+     * on a native field and should contain the label: the rule every text field shares.
      */
     label: Components.SuiFloatLabel['label'];
     /**
@@ -6184,7 +6187,7 @@ declare class SuiIconField {
      * `aria-labelledby` names the input then, or the placeholder. Set one of the three and it
      * draws the shell the other five elements in the InputText family draw, which is what this
      * element was missing: it carried `required` and `invalid` with nowhere to say why. A visible
-     * label wins over both host attributes.
+     * label is the name unless the host carries one of those attributes, which win as on a native field.
      */
     label?: Exclude<Components.SuiIconField['label'], undefined>;
     /**
@@ -6295,8 +6298,9 @@ declare class SuiIftaLabel {
     invalid: Components.SuiIftaLabel['invalid'];
     static ngAcceptInputType_invalid: boolean | '';
     /**
-     * The in-field label. It names the field; only without one does the host's `aria-label` or
-     * `aria-labelledby`, the rule every text field shares.
+     * The in-field label. It names the field unless the host carries an `aria-labelledby` or an
+     * `aria-label`, which win as on a native field and should contain the label: the rule every text
+     * field shares.
      */
     label: Components.SuiIftaLabel['label'];
     /**
@@ -6651,8 +6655,8 @@ declare class SuiInputGroup {
     invalid: Components.SuiInputGroup['invalid'];
     static ngAcceptInputType_invalid: boolean | '';
     /**
-     * Field label above the group. Without one the slotted control takes the host's `aria-label`
-     * or `aria-labelledby` as its name, unless it carries its own; a visible label wins over both.
+     * Field label above the group, and the slotted control's name unless it carries its own: a host
+     * `aria-labelledby` or `aria-label` wins over it, as on a native field, and should contain it.
      */
     label?: Exclude<Components.SuiInputGroup['label'], undefined>;
     /**
@@ -6755,8 +6759,7 @@ declare class SuiInputMask {
     invalid: Components.SuiInputMask['invalid'];
     static ngAcceptInputType_invalid: boolean | '';
     /**
-     * Field label. Without one the field takes the host's `aria-label` or `aria-labelledby` as its
-     * name; a visible label wins over both.
+     * Field label, and the field's name: a host `aria-labelledby` or `aria-label` wins over it, as on a native field, and should contain it.
      */
     label?: Exclude<Components.SuiInputMask['label'], undefined>;
     /**
@@ -6867,7 +6870,9 @@ declare class SuiInputNumber {
      */
     currency: Components.SuiInputNumber['currency'];
     /**
-     * Fraction digits. Defaults to the currency's own count in money mode (2 for dollars, 0 for yen), otherwise 0.
+     * Fraction digits, shown and taken. Defaults to the currency's own count in money mode (2 for
+     * dollars, 0 for yen), otherwise 0, so a plain field takes whole numbers. With `maxDecimals` it is
+     * the fewest the number shows.
      */
     decimals?: Exclude<Components.SuiInputNumber['decimals'], undefined>;
     /**
@@ -6899,7 +6904,8 @@ declare class SuiInputNumber {
     static ngAcceptInputType_invalid: boolean | '';
     /**
      * Field label. Set one, or give the host an `aria-label` or `aria-labelledby`: without any the
-     * spinbutton has no name. A visible label wins over both host attributes.
+     * spinbutton has no name. With both, the host attribute wins, as on a native field, and should
+     * contain the label.
      */
     label?: Exclude<Components.SuiInputNumber['label'], undefined>;
     /**
@@ -6910,11 +6916,18 @@ declare class SuiInputNumber {
      */
     locale?: Exclude<Components.SuiInputNumber['locale'], undefined>;
     /**
-     * Upper bound applied on commit.
+     * Highest number the field takes, on the same terms.
      */
     max?: Exclude<Components.SuiInputNumber['max'], undefined>;
     /**
-     * Lower bound applied on commit.
+     * Up to this many fraction digits, for a figure whose precision varies: hours (`1.5`), a rate
+     * (`0.075`), a unit price with four decimals. The field shows as many as the number has, at least
+     * `decimals`, so 2 reads "2" and 1.5 reads "1.5". Phones then show a keypad with a decimal point.
+     */
+    maxDecimals?: Exclude<Components.SuiInputNumber['maxDecimals'], undefined>;
+    /**
+     * Lowest number the field takes. A lower one is refused with "Enter 0 or more.", and the
+     * steppers stop here.
      */
     min?: Exclude<Components.SuiInputNumber['min'], undefined>;
     /**
@@ -6961,7 +6974,8 @@ declare class SuiInputNumber {
      */
     size: Components.SuiInputNumber['size'];
     /**
-     * Stepper and arrow-key increment.
+     * Stepper and arrow-key increment. A step lands on the field's decimals and stops at `min` and
+     * `max`, since a step is the field's own move rather than a number someone typed.
      * @default 1
      */
     step: Components.SuiInputNumber['step'];
@@ -6978,9 +6992,12 @@ declare class SuiInputNumber {
      */
     tone?: Exclude<Components.SuiInputNumber['tone'], undefined>;
     /**
-     * Committed number. Mutable; `null` while the field is empty, which is how it starts, so a new
-     * record shows the placeholder and posts nothing it was not given. A commit happens on blur,
-     * Enter, an arrow key or a stepper, rounded to `decimals` and clamped to `min` and `max`.
+     * The number in the field. Mutable, and it follows the typing: each keystroke that leaves a number
+     * the field takes sets it before `suiInput` fires, so a save that runs while the field still has
+     * focus reads what is on screen. `null` while the field is empty, which is how it starts, and while
+     * the text is one the field refuses. The field never rewrites a number: not one typed, not one set
+     * here. A number outside `min` and `max`, or with more decimals than the field takes, is refused
+     * with a message when the field is left, and holds the form until it is fixed.
      * @default null
      */
     value: Components.SuiInputNumber['value'];
@@ -7002,16 +7019,19 @@ declare class SuiInputNumber {
     suiBlur: EventEmitter<SuiInputNumberCustomEvent<void>>;
     constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
     static ɵfac: i0.ɵɵFactoryDeclaration<SuiInputNumber, never>;
-    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>;
+    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; }; "maxDecimals": { "alias": "maxDecimals"; "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>;
 }
 declare interface SuiInputNumber extends Components.SuiInputNumber {
     /**
-     * Fires on commit (blur, Enter, arrows, stepper); detail is the committed number or `null`.
+     * Fires when the field is left or Enter is pressed, and on an arrow key or a stepper, when the
+  number differs from the last one it reported; detail is the number, or `null` for an empty or
+  refused entry.
      */
     suiChange: EventEmitter<SuiInputNumberCustomEvent<number | null>>;
     /**
-     * Fires on every keystroke; detail is the parsed, unclamped number, or `null` while the text
-  does not parse: an empty field, or a lone `-` or `.`.
+     * Fires on every keystroke, after `value` follows it; detail is the number the text reads as,
+  even one the field will refuse, or `null` while the text holds no number: an empty field, or
+  a lone `-` or `.`.
      */
     suiInput: EventEmitter<SuiInputNumberCustomEvent<number | null>>;
     /**
@@ -7055,7 +7075,7 @@ declare class SuiInputOtp {
     static ngAcceptInputType_invalid: boolean | '';
     /**
      * Group label. Without one the group takes the host's `aria-label` or `aria-labelledby` as its
-     * name, and "One-time code" without either; a visible label wins over both. Each box stays
+     * name, and "One-time code" without either; a host attribute wins over a label. Each box stays
      * "Digit n".
      */
     label?: Exclude<Components.SuiInputOtp['label'], undefined>;
@@ -7156,8 +7176,8 @@ declare class SuiInputTags {
     invalid: Components.SuiInputTags['invalid'];
     static ngAcceptInputType_invalid: boolean | '';
     /**
-     * Label above the field. Without one the box and its entry field take the host's `aria-label`
-     * or `aria-labelledby` as their name; a visible label wins over both.
+     * Label above the field, and the name of the box and its entry field: a host `aria-labelledby` or
+     * `aria-label` wins over it, as on a native field, and should contain it.
      */
     label?: Exclude<Components.SuiInputTags['label'], undefined>;
     /**
@@ -7268,7 +7288,8 @@ declare class SuiInputText {
     static ngAcceptInputType_invalid: boolean | '';
     /**
      * Field label. Without one the field takes the host's `aria-label` or `aria-labelledby` as its
-     * name, for a settings row that already prints the term; a visible label wins over both.
+     * name, for a settings row that already prints the term. With both, the host attribute wins, as on
+     * a native field, and should contain the label.
      */
     label?: Exclude<Components.SuiInputText['label'], undefined>;
     /**
@@ -8638,8 +8659,7 @@ declare class SuiPassword {
     invalid: Components.SuiPassword['invalid'];
     static ngAcceptInputType_invalid: boolean | '';
     /**
-     * Field label. Without one the field takes the host's `aria-label` or `aria-labelledby` as its
-     * name; a visible label wins over both.
+     * Field label, and the field's name: a host `aria-labelledby` or `aria-label` wins over it, as on a native field, and should contain it.
      */
     label?: Exclude<Components.SuiPassword['label'], undefined>;
     /**
@@ -10855,8 +10875,7 @@ declare class SuiTextarea {
     invalid: Components.SuiTextarea['invalid'];
     static ngAcceptInputType_invalid: boolean | '';
     /**
-     * Field label above the box. Without one the box takes the host's `aria-label` or
-     * `aria-labelledby` as its name; a visible label wins over both.
+     * Field label above the box, and the box's name: a host `aria-labelledby` or `aria-label` wins over it, as on a native field, and should contain it.
      */
     label?: Exclude<Components.SuiTextarea['label'], undefined>;
     /**
@@ -11457,7 +11476,8 @@ declare class SuiToggleSwitch {
     invalid: Components.SuiToggleSwitch['invalid'];
     static ngAcceptInputType_invalid: boolean | '';
     /**
-     * Visible label.
+     * Visible label, and the switch's name unless the element carries an `aria-label` or an
+     * `aria-labelledby`, which win as they do on a native control.
      */
     label?: Exclude<Components.SuiToggleSwitch['label'], undefined>;
     /**
@@ -12311,6 +12331,10 @@ declare class SuiHtmlValueAccessor extends ValueAccessor {
  * parseFloat. The model is a number, a range slider's `[low, high]` pair, or null: null, an empty
  * string and NaN all report null, so a cleared required field is invalid. Keep the selector equal
  * to `NUMBER_ELEMENTS` there; `scripts/check-value-accessors.mjs` fails when they differ.
+ *
+ * The model follows suiInput as well as suiChange, as `NUMBER_ELEMENTS` says: a number field's model
+ * that waited for the commit sent the old amount from a save that ran before the field lost focus.
+ * The rating fires no suiInput; `handleChangeEvent` skips a value it already has.
  */
 declare class NumericValueAccessor extends ValueAccessor {
     constructor(el: ElementRef);
@@ -12348,6 +12372,6 @@ declare class SelectValueAccessor extends ValueAccessor {
     static ɵdir: i0.ɵɵDirectiveDeclaration<SelectValueAccessor, "sui-select, sui-multi-select, sui-cascade-select, sui-tree-select, sui-listbox, sui-select-button, sui-radio-group, sui-checkbox-group, sui-choice-cards, sui-date-picker, sui-time-picker, sui-color-picker, sui-color-editor, sui-input-otp, sui-input-tags, sui-filter-builder", never, {}, {}, never, never, true, never>;
 }
 
-declare const VALUE_ACCESSORS: (typeof BooleanValueAccessor)[];
+declare const VALUE_ACCESSORS: (typeof TextValueAccessor)[];
 
 export { BooleanValueAccessor, DIRECTIVES, NumericValueAccessor, SelectValueAccessor, SuiAccordion, SuiAccordionItem, SuiAnchor, SuiAutoComplete, SuiAvatar, SuiAvatarGroup, SuiBadge, SuiBlockUi, SuiBoard, SuiBottomNav, SuiBreadcrumb, SuiButton, SuiButtonGroup, SuiCalendar, SuiCard, SuiCarousel, SuiCascadeSelect, SuiChartBar, SuiChartCandlestick, SuiChartCombo, SuiChartGauge, SuiChartHeatmap, SuiChartLine, SuiChartNavigator, SuiChartPie, SuiChartRadar, SuiChartScatter, SuiChartSynced, SuiChartTreemap, SuiChartWaterfall, SuiCheckbox, SuiCheckboxGroup, SuiChip, SuiChoiceCards, SuiCodeBlock, SuiColorEditor, SuiColorPicker, SuiCommandPalette, SuiConfigList, SuiConfigRow, SuiConfirmDialog, SuiConfirmPopup, SuiContextMenu, SuiCopyButton, SuiDataGrid, SuiDataTable, SuiDataView, SuiDatePicker, SuiDescriptionList, SuiDialog, SuiDivider, SuiDock, SuiDrawer, SuiEditBox, SuiEmptyState, SuiFieldset, SuiFileUpload, SuiFilterBuilder, SuiFilterPanel, SuiFilterPanelValueAccessor, SuiFloatLabel, SuiFluid, SuiForm, SuiFormActions, SuiFormLayout, SuiGalleria, SuiHtmlValueAccessor, SuiIconButton, SuiIconField, SuiIftaLabel, SuiImage, SuiImageCompare, SuiInplace, SuiInputGroup, SuiInputGroupAddon, SuiInputMask, SuiInputNumber, SuiInputOtp, SuiInputTags, SuiInputText, SuiKbd, SuiKnob, SuiList, SuiListbox, SuiMegaMenu, SuiMenu, SuiMenubar, SuiMessage, SuiMeterGroup, SuiMiniToolbar, SuiMultiSelect, SuiNotificationCenter, SuiOrderList, SuiOrgChart, SuiOverlayBadge, SuiPageHeader, SuiPaginator, SuiPanel, SuiPanelMenu, SuiPassword, SuiPersona, SuiPickList, SuiPopover, SuiProgressBar, SuiProgressRing, SuiProgressSpinner, SuiQrCode, SuiRadioButton, SuiRadioGroup, SuiRating, SuiRichTextEditor, SuiSaveStatus, SuiSchedulerBuilder, SuiSchedulerBuilderValueAccessor, SuiScrollPanel, SuiScrollTop, SuiSelect, SuiSelectButton, SuiSideNav, SuiSkeleton, SuiSkeletonCard, SuiSlider, SuiSparkline, SuiSpeedDial, SuiSplitButton, SuiSplitter, SuiSpoiler, SuiStatCard, SuiStepper, SuiTab, SuiTabs, SuiTag, SuiTerminal, SuiTextarea, SuiThemePicker, SuiTieredMenu, SuiTimePicker, SuiTimeline, SuiToastHost, SuiToggleButton, SuiToggleSwitch, SuiToolbar, SuiTooltip, SuiTour, SuiTree, SuiTreeSelect, SuiTreeTable, SuiTrend, SuiVirtualScroller, TextValueAccessor, VALUE_ACCESSORS, ValueAccessor };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shineuix/angular",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Angular standalone directives for ShineUI web components.",
   "license": "MIT",
   "keywords": [
@@ -21,7 +21,7 @@
   },
   "dependencies": {
     "tslib": "^2.8.0",
-    "@shineuix/core": "1.1.0"
+    "@shineuix/core": "1.2.0"
   },
   "peerDependencies": {
     "@angular/core": "^20.0.0 || ^21.0.0 || ^22.0.0",