@supermousejs/utils 2.3.1 → 2.4.1

package/dist/dom.d.ts

@@ -6,21 +6,30 @@
  * @param css A string of CSS rules to inject.
  */
 export declare const injectStyles: (id: string, css: string) => void;
+type CSSProperties = {
+    [K in keyof CSSStyleDeclaration as CSSStyleDeclaration[K] extends (...args: any) => any ? never : K]?: string | number;
+};
 /**
- * Smart Style Setter (Batch).
- * Only writes to the DOM if the value has actually changed.
- * @param el The element to style
- * @param styles An object of CSS properties and values
+ * Applies CSS properties to an element. Only touches the DOM when a value
+ * has actually changed.
+ *
+ * @example
+ * css(el, {
+ *   width: `${size}px`,
+ *   height: `${size}px`,
+ *   opacity: state.isHover ? 1 : 0,
+ *   backgroundColor: state.interaction.color || "#000",
+ * });
+ */
+export declare function css(el: HTMLElement | SVGElement, styles: CSSProperties): void;
+/**
+ * @deprecated Use `dom.css()` instead. This function will be removed in future versions.
  */
-export declare function applyStyles(el: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;
+export declare function setStyle(el: HTMLElement | SVGElement, prop: string, value: string | number): void;
 /**
- * Smart Style Setter (Single).
- * Proxies to applyStyles for consistency.
- * @param el The element to style
- * @param property The CSS property to set
- * @param value The value to set for the property
+ * @deprecated Use `dom.css()` instead. This function will be removed in future versions.
  */
-export declare function setStyle(el: HTMLElement, property: keyof CSSStyleDeclaration, value: string | number): void;
+export declare function applyStyles(el: HTMLElement | SVGElement, styles: Record<string, string | number>): void;
 /**
  * Universal Transform Setter.
  * Handles centering (-50%) automatically.
@@ -34,18 +43,18 @@ export declare function setStyle(el: HTMLElement, property: keyof CSSStyleDeclar
  * @param skewX Skew X (deg) - Default 0
  * @param skewY Skew Y (deg) - Default 0
  */
-export declare function setTransform(el: HTMLElement, x: number, y: number, rotation?: number, scaleX?: number, scaleY?: number, skewX?: number, skewY?: number): void;
+export declare function setTransform(el: HTMLElement | SVGElement, x: number, y: number, rotation?: number, scaleX?: number, scaleY?: number, skewX?: number, skewY?: number): void;
 /**
  * Calculates the bounding rectangle of an element relative to a container.
  */
-export declare function projectRect(element: HTMLElement, container?: HTMLElement): DOMRect;
+export declare function projectRect(element: HTMLElement | SVGSVGElement, container?: HTMLElement | SVGSVGElement): DOMRect;
 /**
  * Creates a standard Supermouse actor element with optimal performance settings.
  * Includes absolute positioning, pointer-events: none, and will-change: transform.
  *
  * @param tagName The HTML tag to create (default: 'div')
  */
-export declare function createActor(tagName?: string): HTMLElement;
+export declare function createActor(tagName?: string): HTMLElement | SVGSVGElement;
 /**
  * Creates a circular HTML div using the standard actor base.
  */
@@ -55,4 +64,5 @@ export declare function createCircle(size: number, color: string): HTMLDivElemen
  * @deprecated Use createActor() instead.
  */
 export declare function createDiv(): HTMLDivElement;
+export {};
 //# sourceMappingURL=dom.d.ts.map

package/dist/dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,EAAE,KAAK,MAAM,SAQnD,CAAC;AAKF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,QAgBhF;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,mBAAmB,EACnC,KAAK,EAAE,MAAM,GAAG,MAAM,QAGvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,WAAW,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,GAAE,MAAU,EACpB,MAAM,GAAE,MAAU,EAClB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAU,EACjB,KAAK,GAAE,MAAU,QAKlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,GAAE,WAA2B,GAAG,OAAO,CAYjG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,MAAc,GAAG,WAAW,CAYhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CASxE;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,cAAc,CAE1C"}
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,EAAE,KAAK,MAAM,KAAG,IAQtD,CAAC;AAIF,KAAK,aAAa,GAAG;KAClB,CAAC,IAAI,MAAM,mBAAmB,IAAI,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,GACnF,KAAK,GACL,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CACzB,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,wBAAgB,GAAG,CAAC,EAAE,EAAE,WAAW,GAAG,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAkB7E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjG;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,WAAW,GAAG,UAAU,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,IAAI,CAEN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,WAAW,GAAG,UAAU,EAC5B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,GAAE,MAAU,EACpB,MAAM,GAAE,MAAU,EAClB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAU,EACjB,KAAK,GAAE,MAAU,GAChB,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,WAAW,GAAG,aAAa,EACpC,SAAS,GAAE,WAAW,GAAG,aAA6B,GACrD,OAAO,CAYT;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,MAAc,GAAG,WAAW,GAAG,aAAa,CAYhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CASxE;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,cAAc,CAE1C"}

package/dist/index.d.ts

@@ -1,11 +1,14 @@
+export * from './math';
+export * from './dom';
+export * from './effects';
+export * from './options';
+export * from './doctor';
+export * from './plugin';
+export * from './svg';
+export * from './css';
 import * as math from "./math";
 import * as dom from "./dom";
 import * as effects from "./effects";
-export { math, dom, effects };
-export * from './layers';
-export * from './css';
-export { definePlugin } from './plugin';
-export type { BasePluginOptions } from './plugin';
-export { normalize } from './options';
-export * from './doctor';
+import * as svg from "./svg";
+export { math, dom, effects, svg };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AAEtB,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAE7B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC"}