@uibit/number-increment 0.1.0 → 0.1.1

package/README.md

@@ -1,7 +1,17 @@
 # Number Ticker
 
+[![NPM Version](https://img.shields.io/npm/v/@uibit/number-increment.svg?style=flat-square&color=black)](https://www.npmjs.com/package/@uibit/number-increment)
+
+
 [Interactive Demonstration](https://rawlings.github.io/uibit/number-ticker)
 
+## Installation
+
+```bash
+npm install @uibit/number-increment
+```
+
+
 Number Ticker is a visual performance indicator component that animates numerical statistics, percentages, and currencies when they enter the user's viewport. By displaying numbers with a smooth counting motion rather than as static values, it highlights milestones and growth metrics.
 
 ## Value Delivery

package/custom-elements.json

@@ -39,7 +39,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Animates a numeric value from zero (or a custom start) up to the `value`\nattribute once the element scrolls into the viewport. Supports easing,\ndecimal places, and custom formatting functions.\n\nThe animation runs entirely in the shadow DOM on a rAF loop so it never\nblocks the main thread via layout thrashing.",
+          "description": "Animates a numeric value from zero (or a custom start) up to the `value`",
           "name": "NumberIncrement",
           "cssProperties": [
             {
@@ -109,16 +109,6 @@
               "description": "Number of decimal places to display. Used only if no custom formatter is provided.",
               "attribute": "decimals"
             },
-            {
-              "kind": "field",
-              "name": "locale",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "BCP 47 locale string for number formatting (e.g. \"en-US\"). Defaults to browser locale if options is set.",
-              "attribute": "locale"
-            },
             {
               "kind": "field",
               "name": "options",
@@ -278,6 +268,211 @@
                   }
                 }
               ]
+            },
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale string for formatting and localization. Defaults to inherited document language.",
+              "attribute": "locale",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "resolvedLocale",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Resolves the active locale for formatting and localization.\nChecks the `locale` property first, then traverses up the DOM to find\nthe nearest ancestor with a `lang` attribute, and finally falls back\nto undefined (which defaults to browser locale).",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_disposables",
+              "type": {
+                "text": "Set<() => void>"
+              },
+              "privacy": "private",
+              "default": "new Set()",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "createProperty",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "PropertyKey"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "PropertyDeclaration"
+                  }
+                }
+              ],
+              "description": "Overrides createProperty to automatically map camelCase property names\nto kebab-case attribute names by default.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "finalizeStyles",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "Array<any>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "styles",
+                  "optional": true,
+                  "type": {
+                    "text": "CSSResultGroup"
+                  }
+                }
+              ],
+              "description": "Automatically prepends basic layout resets (border-box) to the\ncomponent's final styles.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "dispatchCustomEvent",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "T"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "Omit<CustomEventInit<T>, 'detail'>"
+                  }
+                }
+              ],
+              "description": "Helper to dispatch a custom event with standard bubbles and composed options.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getCssPropertyValue",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "propertyName",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Helper to retrieve a computed CSS custom property value from the element.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "registerDisposable",
+              "parameters": [
+                {
+                  "name": "cleanup",
+                  "type": {
+                    "text": "() => void"
+                  }
+                }
+              ],
+              "description": "Register a cleanup function to be executed when the element is disconnected from the DOM.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "listen",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "type": {
+                    "text": "EventTarget"
+                  }
+                },
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: EventTarget, ev: HTMLElementEventMap[K]) => any"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | AddEventListenerOptions"
+                  }
+                }
+              ],
+              "description": "Utility to add an event listener that is automatically cleaned up when the element is disconnected.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
             }
           ],
           "events": [
@@ -323,15 +518,6 @@
               "description": "Number of decimal places to display. Used only if no custom formatter is provided.",
               "fieldName": "decimals"
             },
-            {
-              "name": "locale",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "BCP 47 locale string for number formatting (e.g. \"en-US\"). Defaults to browser locale if options is set.",
-              "fieldName": "locale"
-            },
             {
               "name": "options",
               "type": {
@@ -366,12 +552,32 @@
               "default": "false",
               "description": "Re-animate each time the element re-enters the viewport.",
               "fieldName": "repeat"
+            },
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale string for formatting and localization. Defaults to inherited document language.",
+              "fieldName": "locale",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            }
+          ],
+          "cssStates": [
+            {
+              "name": "animating",
+              "description": "Active when the count animation is running."
             }
           ],
           "superclass": {
             "name": "UIBitElement",
             "package": "@uibit/core"
           },
+          "summary": "A scroll-triggered animated numeric counter component.\nattribute once the element scrolls into the viewport. Supports easing,\ndecimal places, and custom formatting functions.\n\nThe animation runs entirely in the shadow DOM on a rAF loop so it never\nblocks the main thread via layout thrashing.",
           "tagName": "uibit-number-increment",
           "customElement": true
         }
@@ -429,6 +635,250 @@
       "path": "src/types.ts",
       "declarations": [],
       "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "../../platform/core/src/element.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A foundational base class for all UIBit web components.\nProvides custom event helpers, default kebab-case attribute mapping,\nautomatic cleanup/disposable tracking, and auto-injected reset styles.",
+          "name": "UIBitElement",
+          "members": [
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale string for formatting and localization. Defaults to inherited document language.",
+              "attribute": "locale"
+            },
+            {
+              "kind": "field",
+              "name": "resolvedLocale",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Resolves the active locale for formatting and localization.\nChecks the `locale` property first, then traverses up the DOM to find\nthe nearest ancestor with a `lang` attribute, and finally falls back\nto undefined (which defaults to browser locale).",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_disposables",
+              "type": {
+                "text": "Set<() => void>"
+              },
+              "privacy": "private",
+              "default": "new Set()"
+            },
+            {
+              "kind": "method",
+              "name": "createProperty",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "PropertyKey"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "PropertyDeclaration"
+                  }
+                }
+              ],
+              "description": "Overrides createProperty to automatically map camelCase property names\nto kebab-case attribute names by default."
+            },
+            {
+              "kind": "method",
+              "name": "finalizeStyles",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "Array<any>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "styles",
+                  "optional": true,
+                  "type": {
+                    "text": "CSSResultGroup"
+                  }
+                }
+              ],
+              "description": "Automatically prepends basic layout resets (border-box) to the\ncomponent's final styles."
+            },
+            {
+              "kind": "method",
+              "name": "dispatchCustomEvent",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "T"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "Omit<CustomEventInit<T>, 'detail'>"
+                  }
+                }
+              ],
+              "description": "Helper to dispatch a custom event with standard bubbles and composed options."
+            },
+            {
+              "kind": "method",
+              "name": "getCssPropertyValue",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "propertyName",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Helper to retrieve a computed CSS custom property value from the element."
+            },
+            {
+              "kind": "method",
+              "name": "registerDisposable",
+              "parameters": [
+                {
+                  "name": "cleanup",
+                  "type": {
+                    "text": "() => void"
+                  }
+                }
+              ],
+              "description": "Register a cleanup function to be executed when the element is disconnected from the DOM."
+            },
+            {
+              "kind": "method",
+              "name": "listen",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "type": {
+                    "text": "EventTarget"
+                  }
+                },
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: EventTarget, ev: HTMLElementEventMap[K]) => any"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | AddEventListenerOptions"
+                  }
+                }
+              ],
+              "description": "Utility to add an event listener that is automatically cleaned up when the element is disconnected."
+            },
+            {
+              "kind": "method",
+              "name": "listen",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "type": {
+                    "text": "EventTarget"
+                  }
+                },
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "EventListenerOrEventListenerObject"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | AddEventListenerOptions"
+                  }
+                }
+              ]
+            }
+          ],
+          "attributes": [
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale string for formatting and localization. Defaults to inherited document language.",
+              "fieldName": "locale"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "UIBitElement",
+          "declaration": {
+            "name": "UIBitElement",
+            "module": "../../platform/core/src/element.ts"
+          }
+        }
+      ]
     }
   ]
 }

package/dist/frameworks/angular/index.ts

@@ -33,11 +33,6 @@ export class NgxNumberIncrement {
         this.el.nativeElement.decimals = this.decimals();
       }
     });
-    effect(() => {
-      if (this.el.nativeElement) {
-        this.el.nativeElement.locale = this.locale();
-      }
-    });
     effect(() => {
       if (this.el.nativeElement) {
         this.el.nativeElement.options = this.options();
@@ -63,18 +58,23 @@ export class NgxNumberIncrement {
         this.el.nativeElement.repeat = this.repeat();
       }
     });
+    effect(() => {
+      if (this.el.nativeElement) {
+        this.el.nativeElement.locale = this.locale();
+      }
+    });
   }
 
   readonly value = input<number, any>(0, { transform: numberAttribute });
   readonly from = input<number, any>(0, { transform: numberAttribute });
   readonly duration = input<number, any>(1800, { transform: numberAttribute });
   readonly decimals = input<number, any>(0, { transform: numberAttribute });
-  readonly locale = input<string, any>('');
   readonly options = input<Intl.NumberFormatOptions | undefined, any>(undefined);
   readonly formatter = input<(value: number) => string | undefined, any>(0, { transform: numberAttribute });
   readonly easing = input<'ease-out' | 'ease-in-out' | 'linear', any>('ease-out');
   readonly threshold = input<number, any>(0.2, { transform: numberAttribute });
   readonly repeat = input<boolean, any>(false, { transform: booleanAttribute });
+  readonly locale = input<string, any>('');
 
   readonly void = output<CustomEvent<any>>();
 }

package/dist/frameworks/preact/index.d.ts

@@ -10,12 +10,12 @@ declare module 'preact' {
       from?: number;
       duration?: number;
       decimals?: number;
-      locale?: string;
       options?: Intl.NumberFormatOptions | undefined;
       formatter?: (value: number) => string | undefined;
       easing?: 'ease-out' | 'ease-in-out' | 'linear';
       threshold?: number;
       repeat?: boolean;
+      locale?: string;
       };
     }
   }

package/dist/frameworks/react/index.d.ts

@@ -13,12 +13,12 @@ declare global {
       from?: number;
       duration?: number;
       decimals?: number;
-      locale?: string;
       options?: Intl.NumberFormatOptions | undefined;
       formatter?: (value: number) => string | undefined;
       easing?: 'ease-out' | 'ease-in-out' | 'linear';
       threshold?: number;
       repeat?: boolean;
+      locale?: string;
       onVoid?: (event: any) => void;
         };
       }

package/dist/frameworks/solid/index.d.ts

@@ -10,12 +10,12 @@ declare module 'solid-js' {
       from?: number;
       duration?: number;
       decimals?: number;
-      locale?: string;
       options?: Intl.NumberFormatOptions | undefined;
       formatter?: (value: number) => string | undefined;
       easing?: 'ease-out' | 'ease-in-out' | 'linear';
       threshold?: number;
       repeat?: boolean;
+      locale?: string;
       "on:void"?: (event: CustomEvent) => void;
       };
     }

package/dist/frameworks/stencil/index.d.ts

@@ -9,12 +9,12 @@ declare module '@stencil/core' {
     from?: number;
     duration?: number;
     decimals?: number;
-    locale?: string;
     options?: Intl.NumberFormatOptions | undefined;
     formatter?: (value: number) => string | undefined;
     easing?: 'ease-out' | 'ease-in-out' | 'linear';
     threshold?: number;
     repeat?: boolean;
+    locale?: string;
       };
     }
   }

package/dist/frameworks/svelte/index.svelte

@@ -7,12 +7,12 @@
       from = undefined,
       duration = undefined,
       decimals = undefined,
-      locale = undefined,
       options = undefined,
       formatter = undefined,
       easing = undefined,
       threshold = undefined,
       repeat = undefined,
+      locale = undefined,
       children
   } = $props<{
     children?: any;
@@ -20,12 +20,12 @@
     from?: number;
     duration?: number;
     decimals?: number;
-    locale?: string;
     options?: Intl.NumberFormatOptions | undefined;
     formatter?: (value: number) => string | undefined;
     easing?: 'ease-out' | 'ease-in-out' | 'linear';
     threshold?: number;
     repeat?: boolean;
+    locale?: string;
   
   }>();
   
@@ -44,9 +44,6 @@
     if (elementRef && decimals !== undefined) {
       elementRef.decimals = decimals;
     }
-    if (elementRef && locale !== undefined) {
-      elementRef.locale = locale;
-    }
     if (elementRef && options !== undefined) {
       elementRef.options = options;
     }
@@ -62,6 +59,9 @@
     if (elementRef && repeat !== undefined) {
       elementRef.repeat = repeat;
     }
+    if (elementRef && locale !== undefined) {
+      elementRef.locale = locale;
+    }
   });
   
 </script>

package/dist/frameworks/vue/index.ts

@@ -9,12 +9,12 @@ export const NumberIncrement = defineComponent({
     from: { type: [String, Number, Boolean, Array, Object] as any },
     duration: { type: [String, Number, Boolean, Array, Object] as any },
     decimals: { type: [String, Number, Boolean, Array, Object] as any },
-    locale: { type: [String, Number, Boolean, Array, Object] as any },
     options: { type: [String, Number, Boolean, Array, Object] as any },
     formatter: { type: [String, Number, Boolean, Array, Object] as any },
     easing: { type: [String, Number, Boolean, Array, Object] as any },
     threshold: { type: [String, Number, Boolean, Array, Object] as any },
-    repeat: { type: [String, Number, Boolean, Array, Object] as any }
+    repeat: { type: [String, Number, Boolean, Array, Object] as any },
+    locale: { type: [String, Number, Boolean, Array, Object] as any }
   },
   emits: ['void'],
   setup(props, { slots, emit }) {

package/dist/number-increment.d.ts

@@ -1,6 +1,8 @@
 import { UIBitElement } from '@uibit/core';
 /**
  * Animates a numeric value from zero (or a custom start) up to the `value`
+
+ * @summary A scroll-triggered animated numeric counter component.
  * attribute once the element scrolls into the viewport. Supports easing,
  * decimal places, and custom formatting functions.
  *
@@ -15,7 +17,8 @@ import { UIBitElement } from '@uibit/core';
  * @cssprop [--uibit-number-increment-color=inherit] - Text color
  * @cssprop [--uibit-number-increment-font-family=inherit] - Font family
  * @cssprop [--uibit-number-increment-line-height=inherit] - Line height
- */
+ 
+ * @cssstate animating - Active when the count animation is running.*/
 export declare class NumberIncrement extends UIBitElement {
     static styles: import("lit").CSSResult;
     /** Target numeric value to count up to. */
@@ -26,8 +29,6 @@ export declare class NumberIncrement extends UIBitElement {
     duration: number;
     /** Number of decimal places to display. Used only if no custom formatter is provided. */
     decimals: number;
-    /** BCP 47 locale string for number formatting (e.g. "en-US"). Defaults to browser locale if options is set. */
-    locale: string;
     /** Options for Intl.NumberFormat. */
     options?: Intl.NumberFormatOptions;
     /** Custom formatter function to format the number for display. Overrides locale and options. */

package/dist/number-increment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"number-increment.d.ts","sourceRoot":"","sources":["../src/number-increment.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,YAAY,EAAsC,MAAM,aAAa,CAAC;AAI9F;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,MAAM,CAAC,MAAM,0BAAU;IAEvB,2CAA2C;IACf,KAAK,SAAK;IACtC,wCAAwC;IACO,IAAI,SAAK;IACxD,uDAAuD;IAC3B,QAAQ,SAAQ;IAC5C,yFAAyF;IAC7D,QAAQ,SAAK;IACzC,+GAA+G;IACnF,MAAM,SAAM;IACxC,qCAAqC;IACT,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;IAC/D,gGAAgG;IAChE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACtE,2DAA2D;IAC/B,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAc;IACvF,oEAAoE;IACxC,SAAS,SAAO;IAC5C,+DAA+D;IAClC,MAAM,UAAS;IAEnC,OAAO,CAAC,QAAQ,CAAM;IAE/B,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,OAAO,CAAC,KAAK,CAGV;IAEH,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAK;IAEpB,iBAAiB,SAahB;IAED,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,QAIpC;IAED,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,KAAK;IAcb,MAAM,oCAEL;CACF;eAEc,eAAe"}
+{"version":3,"file":"number-increment.d.ts","sourceRoot":"","sources":["../src/number-increment.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,YAAY,EAAsC,MAAM,aAAa,CAAC;AAI9F;;;;;;;;;;;;;;;;;;;sEAmBsE;AACtE,qBACa,eAAgB,SAAQ,YAAY;IAC/C,MAAM,CAAC,MAAM,0BAAU;IAEvB,2CAA2C;IACf,KAAK,SAAK;IACtC,wCAAwC;IACO,IAAI,SAAK;IACxD,uDAAuD;IAC3B,QAAQ,SAAQ;IAC5C,yFAAyF;IAC7D,QAAQ,SAAK;IAEzC,qCAAqC;IACT,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;IAC/D,gGAAgG;IAChE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACtE,2DAA2D;IAC/B,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAc;IACvF,oEAAoE;IACxC,SAAS,SAAO;IAC5C,+DAA+D;IAClC,MAAM,UAAS;IAEnC,OAAO,CAAC,QAAQ,CAAM;IAE/B,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,OAAO,CAAC,KAAK,CAGV;IAEH,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAK;IAEpB,iBAAiB,SAahB;IAED,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,QAIpC;IAED,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,KAAK;IAcb,MAAM,oCAEL;CACF;eAEc,eAAe"}

package/dist/number-increment.js

@@ -10,6 +10,8 @@ import { property, state } from 'lit/decorators.js';
 import { styles } from './styles';
 /**
  * Animates a numeric value from zero (or a custom start) up to the `value`
+
+ * @summary A scroll-triggered animated numeric counter component.
  * attribute once the element scrolls into the viewport. Supports easing,
  * decimal places, and custom formatting functions.
  *
@@ -24,7 +26,8 @@ import { styles } from './styles';
  * @cssprop [--uibit-number-increment-color=inherit] - Text color
  * @cssprop [--uibit-number-increment-font-family=inherit] - Font family
  * @cssprop [--uibit-number-increment-line-height=inherit] - Line height
- */
+ 
+ * @cssstate animating - Active when the count animation is running.*/
 let NumberIncrement = class NumberIncrement extends UIBitElement {
     constructor() {
         super(...arguments);
@@ -36,8 +39,6 @@ let NumberIncrement = class NumberIncrement extends UIBitElement {
         this.duration = 1800;
         /** Number of decimal places to display. Used only if no custom formatter is provided. */
         this.decimals = 0;
-        /** BCP 47 locale string for number formatting (e.g. "en-US"). Defaults to browser locale if options is set. */
-        this.locale = '';
         /** Easing curve: "ease-out" | "ease-in-out" | "linear". */
         this.easing = 'ease-out';
         /** Intersection threshold (0–1) at which the animation triggers. */
@@ -86,10 +87,14 @@ let NumberIncrement = class NumberIncrement extends UIBitElement {
         if (this.formatter) {
             return this.formatter(n);
         }
+        const locale = this.resolvedLocale;
         if (this.options || this.locale) {
-            return new Intl.NumberFormat(this.locale || undefined, this.options).format(n);
+            return new Intl.NumberFormat(locale, this.options || undefined).format(n);
         }
-        return n.toFixed(this.decimals);
+        return new Intl.NumberFormat(locale, {
+            minimumFractionDigits: this.decimals,
+            maximumFractionDigits: this.decimals,
+        }).format(n);
     }
     _start() {
         this._started = true;
@@ -128,9 +133,6 @@ __decorate([
 __decorate([
     property({ type: Number })
 ], NumberIncrement.prototype, "decimals", void 0);
-__decorate([
-    property({ type: String })
-], NumberIncrement.prototype, "locale", void 0);
 __decorate([
     property({ type: Object })
 ], NumberIncrement.prototype, "options", void 0);

package/dist/number-increment.js.map

@@ -1 +1 @@
-{"version":3,"file":"number-increment.js","sourceRoot":"","sources":["../src/number-increment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"number-increment.js","sourceRoot":"","sources":["../src/number-increment.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uibit/number-increment",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Intersection-aware numeric counter that animates to a target value with easing curves, locale-aware formatting, and custom formatter function overrides. Triggers once the element scrolls into the viewport.",
   "type": "module",
   "main": "./dist/index.js",
@@ -46,7 +46,7 @@
     "directory": "packages/components/number-increment"
   },
   "dependencies": {
-    "@uibit/core": "0.1.0"
+    "@uibit/core": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^20.19.43",
@@ -83,9 +83,9 @@
     "tagName": "uibit-number-increment"
   },
   "scripts": {
-    "build": "cem analyze --globs 'src/**/*.ts' --litelement && uibit-codegen --package . && tsc",
-    "dev": "concurrently \"cem analyze --globs 'src/**/*.ts' --litelement --watch\" \"tsc --watch\"",
-    "analyze": "cem analyze --globs 'src/**/*.ts' --litelement",
+    "build": "cem analyze --config ../custom-elements-manifest.config.js && uibit-codegen --package . && tsc",
+    "dev": "concurrently \"cem analyze --config ../custom-elements-manifest.config.js --watch\" \"tsc --watch\"",
+    "analyze": "cem analyze --config ../custom-elements-manifest.config.js",
     "typecheck": "tsc --noEmit",
     "test": "vitest run -c ../../../vitest.config.ts --passWithNoTests"
   }