@ng-solid/design-system 22.4.1 → 22.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-solid/design-system",
-  "version": "22.4.1",
+  "version": "22.5.0",
   "license": "MIT",
   "description": "Arvisfy, the token-driven Angular design system for ng-solid.",
   "author": "Ulises Familia Rodríguez <chicromedia@hotmail.com>",

package/types/ng-solid-design-system.d.ts

@@ -942,6 +942,77 @@ declare class NsPasswordComponent extends NsValueAccessor implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NsPasswordComponent, "ns-password", never, { "forgotLink": { "alias": "forgotLink"; "required": false; "isSignal": true; }; "forgotLinkLabel": { "alias": "forgotLinkLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Numeric stepper `[–] | input | [+]` (WAI-ARIA spinbutton).
+ *
+ * The model is `number | null`. While focused the field shows an editable raw
+ * number; on blur / Enter / stepping the text is parsed with the active
+ * `locale`, clamped to `min`/`max` and snapped to `step` (counted from `min`
+ * when set). When blurred it shows `formatOptions` applied through
+ * `Intl.NumberFormat`.
+ *
+ * `formatOptions.style === 'percent'` follows the `Intl` convention: the model
+ * is a fraction (`0.5` shows "50 %"), so `min`/`max`/`step` are fractions too.
+ */
+declare class NsQuantityComponent extends NsValueAccessor<number | null> {
+    private readonly destroyRef;
+    private readonly fieldContext;
+    readonly min: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly step: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** `Intl.NumberFormat` options used for the blurred display and `aria-valuetext`. */
+    readonly formatOptions: _angular_core.InputSignal<Intl.NumberFormatOptions>;
+    readonly locale: _angular_core.InputSignal<string>;
+    readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly wheelDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly incrementAriaLabel: _angular_core.InputSignal<string>;
+    readonly decrementAriaLabel: _angular_core.InputSignal<string>;
+    private readonly focused;
+    /** Text typed by the user and not committed yet; `null` when pristine. */
+    private readonly draft;
+    private readonly formatter;
+    private readonly isPercent;
+    protected readonly numericValue: _angular_core.Signal<number>;
+    protected readonly displayText: _angular_core.Signal<string>;
+    protected readonly valueNow: _angular_core.Signal<number>;
+    protected readonly valueText: _angular_core.Signal<string>;
+    protected readonly decrementDisabled: _angular_core.Signal<boolean>;
+    protected readonly incrementDisabled: _angular_core.Signal<boolean>;
+    /** Like the base `describedBy`, minus the description hidden by an error. */
+    protected readonly quantityDescribedBy: _angular_core.Signal<string>;
+    private repeatTimer;
+    private repeatInterval;
+    constructor();
+    writeValue(value: number | null): void;
+    protected onFocus(): void;
+    protected onBlur(): void;
+    protected onInput(event: Event): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected onWheel(event: WheelEvent): void;
+    protected onButtonPointerDown(direction: 1 | -1, event: PointerEvent): void;
+    /**
+     * Pointer presses already stepped on `pointerdown`; a click with
+     * `detail === 0` comes from the keyboard or assistive technology.
+     */
+    protected onButtonClick(direction: 1 | -1, event: MouseEvent): void;
+    protected stopRepeat(): void;
+    private isButtonDisabled;
+    private handleKey;
+    private jumpTo;
+    /** Moves `multiplier` steps along the grid that starts at `min ?? 0`. */
+    private stepBy;
+    /** Parses the pending text (if any) and writes the normalized result. */
+    private commit;
+    /** Clamps to `min`/`max` and snaps to the nearest step without float drift. */
+    private normalize;
+    /** Editable text: locale decimal separator, no grouping, no symbols. */
+    private toRawText;
+    /** Locale text → model number (`null` when it is not a number). */
+    private parse;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NsQuantityComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NsQuantityComponent, "ns-quantity", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "formatOptions": { "alias": "formatOptions"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "wheelDisabled": { "alias": "wheelDisabled"; "required": false; "isSignal": true; }; "incrementAriaLabel": { "alias": "incrementAriaLabel"; "required": false; "isSignal": true; }; "decrementAriaLabel": { "alias": "decrementAriaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class NsRadioComponent {
     private readonly ids;
     readonly group: NsRadioGroupContext;
@@ -2012,5 +2083,5 @@ declare class NsTooltipDirective implements OnDestroy {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NsTooltipDirective, "[nsTooltip]", never, { "message": { "alias": "nsTooltip"; "required": true; "isSignal": true; }; "placement": { "alias": "nsTooltipPlacement"; "required": false; "isSignal": true; }; "delay": { "alias": "nsTooltipDelay"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { Arvisfy, NS_EDITOR_TOOLS_DEFAULT, NS_RETIRED_TOKENS, NS_THEME_OPTIONS, NS_TOAST_OPTIONS, NsAccordionComponent, NsAccordionItemComponent, NsAlertComponent, NsAvatarComponent, NsAvatarGroupComponent, NsBadgeComponent, NsBreadcrumbItemComponent, NsBreadcrumbsComponent, NsButtonComponent, NsButtonGroupComponent, NsCardBodyComponent, NsCardComponent, NsCardFooterComponent, NsCardHeaderComponent, NsCheckboxComponent, NsChipComponent, NsCollectionController, NsCommandPaletteComponent, NsCommentComponent, NsContentEditableComponent, NsDatePickerComponent, NsDateRangePickerComponent, NsDescriptionComponent, NsDividerComponent, NsDrawerComponent, NsDrawerRef, NsDrawerService, NsDropdownComponent, NsDropdownItemDirective, NsEditorColorPickerComponent, NsEditorComponent, NsEditorImageComponent, NsEditorLinkComponent, NsEditorListComponent, NsEditorParagraphComponent, NsEditorToggleCommandComponent, NsEmptyStateComponent, NsFieldContext, NsFieldDirective, NsImageUploadComponent, NsInputCodeComponent, NsInputComponent, NsInputGroupAddonComponent, NsInputGroupComponent, NsInputNumberComponent, NsInputSearchComponent, NsLinkComponent, NsLoadMoreComponent, NsMenuComponent, NsMenuDividerComponent, NsMenuItemComponent, NsMenuSectionComponent, NsMeterComponent, NsModalComponent, NsModalRef, NsModalService, NsOptionCardComponent, NsOverlayRef, NsOverlayService, NsPaginationComponent, NsPasswordComponent, NsPopoverComponent, NsProgressBarComponent, NsRadioComponent, NsRadioGroupComponent, NsSchedule, NsScheduleComponent, NsScheduleService, NsSchemaMarkupComponent, NsSideNavComponent, NsSideNavItemComponent, NsSideNavSectionComponent, NsSkeletonComponent, NsSliderComponent, NsStatCardComponent, NsSurfaceComponent, NsSwitchComponent, NsTabComponent, NsTabsComponent, NsTagComponent, NsTagGroupComponent, NsTextAreaComponent, NsThemeService, NsTimelineComponent, NsTimelineItemComponent, NsToastComponent, NsToastHandle, NsToastService, NsTooltipComponent, NsTooltipDirective, NsValueAccessor, TemplateDirective, defineNsPreset, flattenTokens, getNsOverlayPosition, provideNsTheme, referenceToCssVariable, tokenPathToCssVariable, validateNsPreset };
+export { Arvisfy, NS_EDITOR_TOOLS_DEFAULT, NS_RETIRED_TOKENS, NS_THEME_OPTIONS, NS_TOAST_OPTIONS, NsAccordionComponent, NsAccordionItemComponent, NsAlertComponent, NsAvatarComponent, NsAvatarGroupComponent, NsBadgeComponent, NsBreadcrumbItemComponent, NsBreadcrumbsComponent, NsButtonComponent, NsButtonGroupComponent, NsCardBodyComponent, NsCardComponent, NsCardFooterComponent, NsCardHeaderComponent, NsCheckboxComponent, NsChipComponent, NsCollectionController, NsCommandPaletteComponent, NsCommentComponent, NsContentEditableComponent, NsDatePickerComponent, NsDateRangePickerComponent, NsDescriptionComponent, NsDividerComponent, NsDrawerComponent, NsDrawerRef, NsDrawerService, NsDropdownComponent, NsDropdownItemDirective, NsEditorColorPickerComponent, NsEditorComponent, NsEditorImageComponent, NsEditorLinkComponent, NsEditorListComponent, NsEditorParagraphComponent, NsEditorToggleCommandComponent, NsEmptyStateComponent, NsFieldContext, NsFieldDirective, NsImageUploadComponent, NsInputCodeComponent, NsInputComponent, NsInputGroupAddonComponent, NsInputGroupComponent, NsInputNumberComponent, NsInputSearchComponent, NsLinkComponent, NsLoadMoreComponent, NsMenuComponent, NsMenuDividerComponent, NsMenuItemComponent, NsMenuSectionComponent, NsMeterComponent, NsModalComponent, NsModalRef, NsModalService, NsOptionCardComponent, NsOverlayRef, NsOverlayService, NsPaginationComponent, NsPasswordComponent, NsPopoverComponent, NsProgressBarComponent, NsQuantityComponent, NsRadioComponent, NsRadioGroupComponent, NsSchedule, NsScheduleComponent, NsScheduleService, NsSchemaMarkupComponent, NsSideNavComponent, NsSideNavItemComponent, NsSideNavSectionComponent, NsSkeletonComponent, NsSliderComponent, NsStatCardComponent, NsSurfaceComponent, NsSwitchComponent, NsTabComponent, NsTabsComponent, NsTagComponent, NsTagGroupComponent, NsTextAreaComponent, NsThemeService, NsTimelineComponent, NsTimelineItemComponent, NsToastComponent, NsToastHandle, NsToastService, NsTooltipComponent, NsTooltipDirective, NsValueAccessor, TemplateDirective, defineNsPreset, flattenTokens, getNsOverlayPosition, provideNsTheme, referenceToCssVariable, tokenPathToCssVariable, validateNsPreset };
 export type { NsAlertVariant, NsBadgeMode, NsButtonGroupSelectionMode, NsButtonSize, NsButtonVariant, NsChipColor, NsChipSize, NsChipVariant, NsCollectionItem, NsColor, NsColorScheme, NsCommandGroup, NsCommandItem, NsComment, NsComponentInputs, NsDateRangeValue, NsDateView, NsDeepPartial, NsDrawerComponentInputs, NsDrawerConfig, NsDrawerOptions, NsDrawerPosition, NsDropdownItem, NsDropdownValue, NsEditorTool, NsEmptyStateSize, NsFlattenedPrimitiveTokens, NsKey, NsModalConfig, NsModalOptions, NsModalSize, NsOrientation, NsOverlayCloseReason, NsOverlayConfig, NsOverlayPosition, NsPlacement, NsPrimitiveReference, NsPrimitiveTokenValue, NsResolvedColorScheme, NsResolvedThemeOptions, NsResolvedToastThemeOptions, NsSchemaMarkup, NsSchemaType, NsSelectionMode, NsSemanticReference, NsSemanticTokens, NsSideNavColor, NsSize, NsSliderValue, NsStatCardDeltaTone, NsStatCardHintTone, NsStatCardIconTone, NsStatCardValueTone, NsStatCardVariant, NsTabsVariant, NsThemeOptions, NsThemePreset, NsThemePresetOverrides, NsTimelineItemColor, NsTimelineSize, NsToastAction, NsToastCloseReason, NsToastOptions, NsToastPlacement, NsToastThemeOptions, NsToastVariant, NsTokenTree, NsVariant };