@dava96/osrs-icons 1.0.15 → 1.0.17

package/dist/cjs/generated/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/generated/meta.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,yx4VAwgiBZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/cjs/generated/meta.js

@@ -2,6 +2,20 @@
 // Auto-generated OSRS Icon metadata
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.iconNames = void 0;
+/**
+ * Alphabetically sorted array of every available OSRS icon export name.
+ *
+ * Use this list for search/autocomplete UIs, icon pickers, or validation.
+ * Each entry corresponds to a named export from `@dava96/osrs-icons`.
+ *
+ * @example
+ * ```ts
+ * import { iconNames } from '@dava96/osrs-icons';
+ *
+ * console.log(iconNames.length); // 17,000+
+ * const matches = iconNames.filter(n => n.includes('dragon'));
+ * ```
+ */
 exports.iconNames = [
     '_10thBirthdayBalloons',
     '_10thBirthdayCape',

package/dist/cjs/index.d.ts

@@ -1,5 +1,20 @@
 export * from './generated/icons';
 export * from './generated/meta';
+export * from './packs';
+export * from './flip';
+export * from './applyCursors';
+export * from './animateCursor';
+/**
+ * A fun easter-egg cursor for error states — the OSRS Red Herring icon.
+ *
+ * @example
+ * ```ts
+ * import { errorCursor } from '@dava96/osrs-icons';
+ *
+ * document.body.style.cursor = errorCursor;
+ * ```
+ */
+export { redHerring as errorCursor } from './generated/icons';
 /**
  * Extracts the raw `data:image/png;base64,...` URL from one or more
  * CSS cursor values.
@@ -29,3 +44,4 @@ export declare function toDataUrl(cursorValue: string): string;
 export declare function toDataUrl<T extends Record<string, string>>(cursorValues: T): {
     [K in keyof T]: string;
 };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;AACvD,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxD,YAAY,EAAE,CAAC,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,CAAC"}

package/dist/cjs/index.js

@@ -14,17 +14,36 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorCursor = void 0;
 exports.toDataUrl = toDataUrl;
 __exportStar(require("./generated/icons"), exports);
 __exportStar(require("./generated/meta"), exports);
+__exportStar(require("./packs"), exports);
+__exportStar(require("./flip"), exports);
+__exportStar(require("./applyCursors"), exports);
+__exportStar(require("./animateCursor"), exports);
+/**
+ * A fun easter-egg cursor for error states — the OSRS Red Herring icon.
+ *
+ * @example
+ * ```ts
+ * import { errorCursor } from '@dava96/osrs-icons';
+ *
+ * document.body.style.cursor = errorCursor;
+ * ```
+ */
+var icons_1 = require("./generated/icons");
+Object.defineProperty(exports, "errorCursor", { enumerable: true, get: function () { return icons_1.redHerring; } });
 function toDataUrl(input) {
     if (typeof input === 'string') {
         return extractUrl(input);
     }
     return Object.fromEntries(Object.entries(input).map(([key, value]) => [key, extractUrl(value)]));
 }
+/** Matches `url('...')` in a CSS cursor value. Precompiled for use in loops. */
+const CURSOR_URL_REGEX = /url\('(.*)'\)/;
 /** Extracts the URL from a single `url('...')` CSS value. */
 function extractUrl(cursorValue) {
-    const match = cursorValue.match(/url\('(.*)'\)/);
+    const match = cursorValue.match(CURSOR_URL_REGEX);
     return match ? match[1] : cursorValue;
 }

package/dist/cjs/packs.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Metadata for a cursor pack, used by the documentation site to
+ * automatically display all available packs.
+ *
+ * When adding a new pack, push it onto the {@link allPacks} array
+ * so it appears on the site with zero extra work.
+ */
+export interface PackInfo {
+    /** Display name shown on the site (e.g. "Coins"). */
+    name: string;
+    /** CSS cursor string for a representative icon displayed beside the name. */
+    icon: string;
+    /** The variable name consumers import (e.g. "coinsPack"). */
+    importName: string;
+    /** Short description of what the pack represents. */
+    description: string;
+    /** Human-readable labels for each stage, in order. */
+    stageLabels: string[];
+    /** Ordered cursor strings for each stage. */
+    stages: readonly string[];
+}
+/**
+ * A cursor pack groups related OSRS icons by their in-game state.
+ *
+ * Each key is a semantic label and each value is the corresponding
+ * CSS cursor string, ready to apply to any element's `cursor` property.
+ *
+ * **Want to add a new pack?** See the
+ * {@link https://github.com/Dava96/osrs-icons/blob/main/CONTRIBUTING.md | Contributing Guide}
+ * for instructions on assembling and submitting your own cursor packs.
+ *
+ * @example
+ * ```ts
+ * import { coinsPack, animateCursor } from '@dava96/osrs-icons';
+ *
+ * // Animate the coin stack growing
+ * const stop = animateCursor(coinsPack.stages, { duration: 1200 });
+ * ```
+ */
+/**
+ * Coins cursor pack — represents increasing wealth from 1gp to 10,000gp.
+ *
+ * In OSRS, the coin stack sprite changes based on the amount.
+ * Great for progress indicators, score displays, or loading states.
+ *
+ * @example
+ * ```ts
+ * import { coinsPack } from '@dava96/osrs-icons';
+ *
+ * // Map a 0–100 progress value to a coin stack
+ * const stages = coinsPack.stages;
+ * const index = Math.min(Math.floor(progress / 100 * stages.length), stages.length - 1);
+ * element.style.cursor = stages[index];
+ * ```
+ */
+export declare const coinsPack: {
+    readonly _1: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAwAAAAICAMAAAD6Ou7DAAAAOVBMVEVMaXFbSgmfgRGOdBH70EL70UhwWw0AAAGxkBX70k37zzW3lRWoiRXdtBr2yB3luhrswR3QqRj7zSbkOlBfAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAADhJREFUeNpjYAACdjCAsjjAAMiDstA5QB47F5TJxAbksLBycgoJ8HIzM4LUcbKy8PEL8sCNg5oMAHx9Anyrx+YNAAAAAElFTkSuQmCC'), auto";
+    readonly _2: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAKCAMAAACDi47UAAAARVBMVEVMaXHktAD+yADXqQD/0QD/0ABeSgAAAAG3kAD/0hfzwQD/zQDsugD/zwCkgQC9lQB0WwCSdACtiQCdfADDmgCzjgD1wgBsovB2AAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAFVJREFUeNpdj0kOwCAMA8Nq0n3//1MLNBKhvmWksRyiHNSQSj5TjaJCBOIPU3G+HsyClq0pCJ55HMy6R9UD9sFO7gC6clmErFhznVGPK8rj7n5w++EFukYET+thchsAAAAASUVORK5CYII='), auto";
+    readonly _3: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABsAAAALCAMAAAC53Ab8AAAAV1BMVEVMaXH/zwBeSgD+yAD/0hf/0ybktAAAAAG3kAD/0QDXqQD/0ADzwQD/zQB0WwDIngCqhgCaeQDwvgD/ygDsugCkgQC9lQCSdACtiQCdfADDmgCzjgD1wgCZ+KI0AAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAHlJREFUeNptkFkWgyAQBIclNKAx7prl/ufMQEAx2l/Uq3kNA9E5CDkANrAhkZHA/mSCyOWZzc5N6WxoAG6ce21ayU4kMzV5xrmh9x3XoHJa89y8yOyEUOYRb4d2lRr9ChTd+dVIK4ALlHk9JS5W5oKPf+NC/X0BEX0B4u0GeCgCBnYAAAAASUVORK5CYII='), auto";
+    readonly _4: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABsAAAANCAMAAABvheXhAAAAYFBMVEVMaXH2yB3QqRj70EL70k3701LdtBoAAAGxkBX70UhbSgn7zzylhhXCnhj7zSbswR1wWw3uwh2VeRHpvh34yh2Eaw3luhq0kxX7zzW3lRWfgRGoiRWOdBGYfBG9mhiujhUvxeaWAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAIlJREFUeNp1kFcSwyAMREUxC9hJ7PSe+98yEgFMZuz9At6yKkSNAFoR4P0KZSKCmDB70sVnlk+J1ufQKbcZTr4IJUqYmfSl/vdjy1Ic0LG2OzdEZtdM7mMNCMeD3ktTJljLvtszFtb3XDg1ChuMOuvHXKmZAT8ROEC59ysuzC8Bk/4srwZ/CyH6AiYkB7WkpPmdAAAAAElFTkSuQmCC'), auto";
+    readonly _5: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABsAAAAOCAMAAADpEZdPAAAAYFBMVEVMaXHdtBqfgRH70k3701JbSgnQqRgAAAGxkBX70EK3lRX2yB2OdBFwWw370UjluhrswR37zSarixXuwh2oiRX7zi6bfxFpVQmRdhGVeRF0Xg34yh2Hbg3xxB3pvh3CnhjfHVeAAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAJBJREFUeNptUFkWwyAING6A2dp03+9/y6LGSNPMByAD80aUEgDIEdQaAIjc54iCTmXsCRSNVOIadR4oJZ0TusjVeWvbJnTW2v2uueEvh3TwrE15c+qZO82M7mEReIz+7JijwRhWCZ2rFhOiTTNQO/pjcarvIP+cx7LTcL38n0UBW3z56ek2OF6k92frmkVdvL+7OQiYUyofJwAAAABJRU5ErkJggg=='), auto";
+    readonly _25: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABsAAAATCAMAAABWWYYKAAAAXVBMVEVMaXFbSgn70k370Uj70EL2yB1wWw0AAAGxkBX701LQqRjdtBqOdBGVeRGfgRHswR23lRX7zSbluhqoiRWlhhXuwh2Hbg10Xg20kxW6lxXpvh37zCDIoxj7zzX4yh1F/w8cAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAKtJREFUeNptkVcWhCAMRSkBjGAbnV72v8wJRZED+aB4ycuLYawIE4LVQV+7EDVMoMUyqmBA4JfHTbcY4vv1dHfeYh2oz9DQRERlh2WKBc3JfGEl09DV3toIcddB+EgQQtnZkfQy2Y17lrUkXHvKB1CXngzpok48Shm2jRox30RGvb9B/FGmLwdSCKowO54t7sMwQvoK6+H0/MdMehe7p/zm/ICcrs3RJoV8/wOJmwrmIGvH+wAAAABJRU5ErkJggg=='), auto";
+    readonly _100: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABsAAAAXCAMAAADNyMQcAAAAhFBMVEVMaXFwWw37zSb70k32yB3701Luwh0AAAGxkBX70EL7zzWfgRGOdBFbSgm3lRXQqRj7zCDdtBrxxB34yh370UiHbg1WRgmbfxGVeRHzxh3luhrswR3nvB3pvh2oiRX7zi6lhhV0Xg20kxW6lxXIoxi9mhiLcRHgthrLpRj7zzx4Yg1pVQmh/vD3AAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAANtJREFUeNp1ktkCQzAQRRExiZ3SVkvpvv3//3XIQtB5iMjJ3LmZxLImASqseQAwFXM4kgU00AwaLLBN5jubypOs3MK6EcZ2htN/1YYTiTXeD5dSVxPL9TBSmjbX8ByBoZajFTf3uHvbj5q6UptWzZNJddE3EAmvjrGFH3i3Kc7uMj/g4msPulqUEDeLQ0qpc8y6qE8cT1ZwL2FQc+4eEjT0mTImpr7szReZr/ur9qToLX5gS4EXhGCFOIx0vr58IEVf4aT6ZtyP2gZosXcaLZ8LbuLo9ARrSCqM/z+0HhDka2pQNQAAAABJRU5ErkJggg=='), auto";
+    readonly _250: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB8AAAAWCAMAAAAPf7fDAAAAwFBMVEVMaXH7zSbxxB37zCD2yB3uwh3zxh0AAAGxkBXswR3iuRrluhrnvB34yh0dGADpvh3FoBiVeRHYsBrVrhrashrdtBqrixXIoxi3lRWLcRGbfxHTrBrCnhjLpRjQqRi6lxW9mhhwWw20kxV0Xg18ZQ3NqBilhhXgthpIOgltWA1pVQmoiRVgTQmujhW/nBiHbg2RdhH7zzz7zi6fgRGihBFCNQCAZw01KgBkUQkmIACYfBFbSgmEaw0uJgA8MAD7zzWLXbQwAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAUZJREFUeNp1klWWwzAMRWO2w4xlZhrG7n9Xo6YnSdtp9Wdf+UlPlqZpmqhCuxtCViHq5LvcFvXhMkEYDRfyHxeC7S1mhB3XFrVUUwSu+NFSut9OL3gjAlf4QNW004tBnlGiu8srbkqJuBm0ZA6SlhqvvWs/fG+paeHaF8KKYex380XZgjhw02/FDR29YKacjtzOSoXa3pxwZUTBZP7mmIbuPss0H544RtiMiuTzHQH3E2/xQWkUdiM3zlYnzgi4H/eyL8SdsN3NVrbkUCHo5cNZOVFwD+1/W5QSysyp7/1KKNCOyxGBfwrP0gnMTCHg0Xj7c2pnsDv7V6yeqQSuF62RTZDuTl7PnBCCnGCzzEAJUcdP0qFgOEi9vqj+B0fJetcXjip1PXGzBNX6cGoRPYmzR3sEBni4eRo94KCjVDGo6t7PuF3TP1rgG9GlMDsaAAAAAElFTkSuQmCC'), auto";
+    readonly _1000: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB4AAAAVCAMAAABmKa5TAAAAulBMVEVMaXHluhrYsBouJgDFoBgdGADuwh0AAAGxkBXpvh3VrhrswR3LpRiLcRHiuRqHbg2OdBGrixXashrnvB3zxh34yh2RdhGujhX2yB26lxXgthrQqRiEaw14Yg23lRXCnhjxxB2fgRGYfBHdtBrTrBptWA2AZw3NqBjIoxhwWw2VeRGoiRWlhhX7zCD7zSabfxFbSglCNQA1KgBWRgk8MABpVQl0Xg20kxV8ZQ2ihBG9mhhIOgn7zzVkUQk7597mAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAASxJREFUeNp1ktd2wjAQRC1jaZAb7p1O6DUhPfn/34pkGSeHwL6t7pnRNk27HZCh3Qt0ZeCWqKUU13aNBvwaK0HjCSubpT2FlSGYJIwEk0+BOVv41bn9R7ywLxYYrCi9k0gIX27nT2hNARa7djc0DecsMbFT70HiyCLTpKPwxpraByGCS8x8PBefIyKm0RPYioN8HbmlX4tIYfjJUeCY6zXmo1k3OYVmXj2K15DP8nFV91jjugLvyPWlIzEPy8F43mCn04xJJbJxshgc3lr1aFcM3yn2ykq06S5eJ/2mtD7N4uBjQpGJ5FtqLNHl+gXNrLGLzIFHYelDh8qcF8s0WV2GjoyVaUVx2QvCqeHXc1F4xO1t/3eXQDDcOM/4dx1qNbh7Ltjr/ur+HWl/ZT+/jxj+uQYGegAAAABJRU5ErkJggg=='), auto";
+    readonly _10000: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB4AAAAdCAMAAACKeiw+AAAAwFBMVEVMaXEdGADnvB3swR3pvh3uwh3FoBgAAAGxkBXluhrYsBqVeRHxxB3ashrQqRifgRG3lRXzxh3LpRj2yB2ujhXIoxjiuRrgthpwWw3dtBrVrhr4yh2YfBGbfxGoiRWOdBGrixWRdhGLcREuJgC6lxVtWA3NqBh4Yg29mhg1KgCAZw10Xg20kxWihBFWRglpVQnTrBqEaw1CNQClhhWHbg2/nBj7zCB8ZQ08MAD7zSbCnhhMPQn7zi5kUQn7zzVgTQng0mzuAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAapJREFUeNp1k2uXmjAQhjUkGSMEhOWygCJQL6irq9Vu99LL//9XnSRQpD07n+bMEzLvDG9Goz5AxeizgIkK6E/C/3QMfT6558B+kSBsMe2Pdtj/IaKixZafPS2H2HmL+bHFzHHD+h4DYS/Jt4URBJa1KW8DTJ1cruZGEBASFZfdEGO/VjAIwa/7D+hm1GqYGzIh5181Dsrbb+hmBIVpUDBxrl41difVI/QbAPYg+JGlQY0tIRbZbLFX2KGxuhAxCqdTvvzQWDbX2uDUXb4iRuG2JaPFT1UVCQ/tseqZnHl1Ul9PZ7aTbIqD0baZeXg7+EQG3npn8ANKup1ADX5eeaZ57IaXE1gKP5OssddfALE7W3zXk5FsZa93zEd8oNPIe0RMe4yl42HHnLTx9lRyg8Xmab5tsS6xmJe1ZXKwhrhbDu1wHEzsg5Lmi4zblrFHTjBXyjXGrUJOZVRu/Ze0mY8BByu3+gclUaiWDrjmVQU5joXucWRTKRcARbxcQ+fZHN1zGcPfoCkvNW6NRoPrFnq3k5QX9TP8+0I6t4N8v8e9qd6S9yN8/qIG5T9OGikrB+sX9AAAAABJRU5ErkJggg=='), auto";
+    /** Ordered array of all coin stages, from 1gp to 10,000gp. */
+    readonly stages: readonly string[];
+};
+/**
+ * Bucket cursor pack — represents a filling progression from empty to full.
+ *
+ * Perfect for loading indicators, progress bars, or upload states.
+ * The `stages` array orders them from empty → full for easy indexing.
+ *
+ * @example
+ * ```ts
+ * import { bucketPack } from '@dava96/osrs-icons';
+ *
+ * // Map a 0–100 progress value to a bucket fill state
+ * const stages = bucketPack.stages;
+ * const index = Math.min(Math.floor(progress / 100 * stages.length), stages.length - 1);
+ * element.style.cursor = stages[index];
+ * ```
+ */
+export declare const bucketPack: {
+    readonly empty: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAdCAMAAACdWLz3AAAA5FBMVEVMaXGLckCWe0WUeUNcRhWOdEKRdkMAAAFkTRhgSRiEenqbf0hXQxWghEpwVhpnYGCJgH+IcD+mh01OPBFSPxWjhUyDazxqYmJdV1duZmZ9ZjlzXjWPhYWegkmZfUaBeHiFfHuAaTplXl19dHSHfn1pUBp6Yzl3b25wXDSQhoZ7cnJza2s/MA1JORFsZGRjXFt1bWyFbT12YTdtWDJwaWmLgoGoik05LA00JgksIgmViomNg4N7Xh1sVBqaj49FNBFCPT1bVVVOSUhWUFBUTU2PbiR5cXCIaSKWjIt/dnaTiIirjE4aNStaAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAVlJREFUeNpd0teWgjAQBmBIIEMEBAREBMGO2Hvd3sv7v8+GYFn97/KdzMxJEYQ8ACDcBl5eK7cKpgfNybVCgVWP/eb/FtDyn4bDx+nAGF0UBolBFWXZmo6d02aI+3FdYanHnqRRzpCs6jQzhT54HYkqHRBAur+jR4yNim1LEkOtQ3OkVGLoOJShrUhnbD6/jZys3KEX1CqVplTMyjWNI83KJ94y6Wfo2PYJx/60L2a46AXaaLjZbLe73eDDksVChsG8W20UeSxRlq0Vw17QrZZnliUyEAk5FPiJjEaZCyGY4NRscwyqfsgJI2SGEebY65ZF1G63TdMM9yomZ8SRWtPdUklHWOa4mDcsgji6ESY5+kF1JuOo5pbeVUTq/JZh4rXKItuqrz9Raq7yqwdjmXwfwvRn/5WGKjrivNEq5NH1M7KWKFKz4W7t/MoAmM0urX/XV38Hjjmu/wC2oyMiAJCBbAAAAABJRU5ErkJggg=='), auto";
+    readonly fifth: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAdCAMAAACdWLz3AAAA5FBMVEVMaXGLckCWe0WUeUNcRhWOdEKRdkMAAAFkTRhgSRiEenqbf0hXQxWghEpwVhpnYGCJgH+IcD+mh01OPBFSPxWjhUyDazxqYmJdV1duZmZ9ZjlzXjWPhYWegkmZfUaBeHiFfHuAaTplXl19dHSHfn1pUBp6Yzl3b25wXDSQhoZ7cnJza2s/MA1JORFsZGRjXFt1bWyFbT12YTdtWDJwaWmLgoGoik05LA00JgksIgmViomNg4N7Xh1sVBqaj49FNBFCPT1bVVVOSUhWUFBUTU2PbiR5cXCIaSKWjIt/dnaTiIirjE4aNStaAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAVlJREFUeNpd0teWgjAQBmBIIEMEBAREBMGO2Hvd3sv7v8+GYFn97/KdzMxJEYQ8ACDcBl5eK7cKpgfNybVCgVWP/eb/FtDyn4bDx+nAGF0UBolBFWXZmo6d02aI+3FdYanHnqRRzpCs6jQzhT54HYkqHRBAur+jR4yNim1LEkOtQ3OkVGLoOJShrUhnbD6/jZys3KEX1CqVplTMyjWNI83KJ94y6Wfo2PYJx/60L2a46AXaaLjZbLe73eDDksVChsG8W20UeSxRlq0Vw17QrZZnliUyEAk5FPiJjEaZCyGY4NRscwyqfsgJI2SGEebY65ZF1G63TdMM9yomZ8SRWtPdUklHWOa4mDcsgji6ESY5+kF1JuOo5pbeVUTq/JZh4rXKItuqrz9Raq7yqwdjmXwfwvRn/5WGKjrivNEq5NH1M7KWKFKz4W7t/MoAmM0urX/XV38Hjjmu/wC2oyMiAJCBbAAAAABJRU5ErkJggg=='), auto";
+    readonly twoFifths: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAdCAMAAACdWLz3AAAA5FBMVEVMaXGLckCWe0WUeUNcRhWOdEKRdkMAAAFkTRhgSRiEenqbf0hXQxWghEpwVhpnYGCJgH+IcD+mh01OPBFSPxWjhUyDazxqYmJdV1duZmZ9ZjlzXjWPhYWegkmZfUaBeHiFfHuAaTplXl19dHSHfn1pUBp6Yzl3b25wXDSQhoZ7cnJza2s/MA1JORFsZGRjXFt1bWyFbT12YTdtWDJwaWmLgoGoik05LA00JgksIgmViomNg4N7Xh1sVBqaj49FNBFCPT1bVVVOSUhWUFBUTU2PbiR5cXCIaSKWjIt/dnaTiIirjE4aNStaAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAVlJREFUeNpd0teWgjAQBmBIIEMEBAREBMGO2Hvd3sv7v8+GYFn97/KdzMxJEYQ8ACDcBl5eK7cKpgfNybVCgVWP/eb/FtDyn4bDx+nAGF0UBolBFWXZmo6d02aI+3FdYanHnqRRzpCs6jQzhT54HYkqHRBAur+jR4yNim1LEkOtQ3OkVGLoOJShrUhnbD6/jZys3KEX1CqVplTMyjWNI83KJ94y6Wfo2PYJx/60L2a46AXaaLjZbLe73eDDksVChsG8W20UeSxRlq0Vw17QrZZnliUyEAk5FPiJjEaZCyGY4NRscwyqfsgJI2SGEebY65ZF1G63TdMM9yomZ8SRWtPdUklHWOa4mDcsgji6ESY5+kF1JuOo5pbeVUTq/JZh4rXKItuqrz9Raq7yqwdjmXwfwvRn/5WGKjrivNEq5NH1M7KWKFKz4W7t/MoAmM0urX/XV38Hjjmu/wC2oyMiAJCBbAAAAABJRU5ErkJggg=='), auto";
+    readonly threeFifths: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAdCAMAAACdWLz3AAAA6lBMVEVMaXFJORGWe0Wbf0iEenqDazx6YzkJOmQAAAFcRhVSPxWghEqAaTpwVhp9ZjlzXjV9dHR1bWyUeUOmh012YTdOPBFnYGBwXDRgSRijhUyFbT1qYmJdV1dlXl1waWmRdkNtWDKegkmOdEKZfUaLckBFNBE/MA1sZGR/dnZkTRhXQxVuZmaIcD+BeHh5cXCJgH80Jglza2tjXFuQhoaPhYWoik0sIgk5LA2FfHuViolpUBp3b26LgoF7cnKaj49bVVVCPT1OSUhWUFB7Xh1UTU1sVBqPbiSIaSKWjIuTiIiNg4OrjE6Hfn1mVC6FCO42AAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAVJJREFUeNpd0teWgjAUQFHpN4BSFEQQUFGKBexldHpv//87EwLq6Hljr5tkEahUigCgch08PrWvFTIH3PmlAotXRyP3/xagRg9hONBmJnVW8DTXshJP1SLxOAxxqsYIt504aGgRBi2bDKk8485JkJXcQAXQ67MRToW8idkeUAhhFBNqI5RhFEULo2EJp9z7F0rMl4vojEK77aIqxqF4NnPuePtbgoZxxGik3Y5TjJ2mgoxBuJlO1+tZatv8JEelwdfkKonjOP73UEzmytnjfg+bxpI3Ms8s82z2Q1CpjbySeXUZ6ASbPNen2VhNtRm7Y3T/hHrAdKVWvS7Reo9gpyGPfZpgK9D9AkdKze7pQbdVf2Nof0tuGeaOyvXxqLR6pxfZobh6ML19/LVcfO4+FkuGLrEhq2yRJJ0Qb0kHTH54q3v6ygA6Pru++l5d/DtQVj7/AW6fJZqMVLzGAAAAAElFTkSuQmCC'), auto";
+    readonly fourFifths: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAdCAMAAACdWLz3AAAA6lBMVEVMaXFJORGWe0Wbf0iEenqDazx6YzkJOmQAAAFcRhVSPxWghEqAaTpwVhp9ZjlzXjV9dHR1bWyUeUOmh012YTdOPBFnYGBwXDRgSRijhUyFbT1qYmJdV1dlXl1waWmRdkNtWDKegkmOdEKZfUaLckBFNBE/MA1sZGR/dnZkTRhXQxVuZmaIcD+BeHh5cXCJgH80Jglza2tjXFuQhoaPhYWoik0sIgk5LA2FfHuViolpUBp3b26LgoF7cnKaj49bVVVCPT1OSUhWUFB7Xh1UTU1sVBqPbiSIaSKWjIuTiIiNg4OrjE6Hfn1mVC6FCO42AAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAVJJREFUeNpd0teWgjAUQFHpN4BSFEQQUFGKBexldHpv//87EwLq6Hljr5tkEahUigCgch08PrWvFTIH3PmlAotXRyP3/xagRg9hONBmJnVW8DTXshJP1SLxOAxxqsYIt504aGgRBi2bDKk8485JkJXcQAXQ67MRToW8idkeUAhhFBNqI5RhFEULo2EJp9z7F0rMl4vojEK77aIqxqF4NnPuePtbgoZxxGik3Y5TjJ2mgoxBuJlO1+tZatv8JEelwdfkKonjOP73UEzmytnjfg+bxpI3Ms8s82z2Q1CpjbySeXUZ6ASbPNen2VhNtRm7Y3T/hHrAdKVWvS7Reo9gpyGPfZpgK9D9AkdKze7pQbdVf2Nof0tuGeaOyvXxqLR6pxfZobh6ML19/LVcfO4+FkuGLrEhq2yRJJ0Qb0kHTH54q3v6ygA6Pru++l5d/DtQVj7/AW6fJZqMVLzGAAAAAElFTkSuQmCC'), auto";
+    readonly full: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAdCAMAAACdWLz3AAAA6lBMVEVMaXFJORGWe0Wbf0iEenqDazx6Yzl7e5sAAAFcRhVSPxWghEqAaTpwVhp9ZjlzXjV9dHR1bWyUeUOmh012YTdOPBFnYGBwXDRgSRijhUyFbT1qYmJdV1dlXl1waWmRdkNtWDKegkmOdEKZfUaLckBFNBE/MA1sZGR/dnZkTRhXQxVuZmaIcD+BeHh5cXCJgH80Jglza2tjXFuQhoaPhYWoik0sIgk5LA2FfHuViolpUBp3b26LgoF7cnKaj49bVVVCPT1OSUhWUFB7Xh1UTU1sVBqPbiSIaSKWjIuTiIiNg4OrjE6Hfn1mVC6Nk9sLAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAVJJREFUeNpd0teWgjAUQFHpN4BSFEQQUFGKBexldHpv//87EwLq6Hljr5tkEahUigCgch08PrWvFTIH3PmlAotXRyP3/xagRg9hONBmJnVW8DTXshJP1SLxOAxxqsYIt504aGgRBi2bDKk8485JkJXcQAXQ67MRToW8idkeUAhhFBNqI5RhFEULo2EJp9z7F0rMl4vojEK77aIqxqF4NnPuePtbgoZxxGik3Y5TjJ2mgoxBuJlO1+tZatv8JEelwdfkKonjOP73UEzmytnjfg+bxpI3Ms8s82z2Q1CpjbySeXUZ6ASbPNen2VhNtRm7Y3T/hHrAdKVWvS7Reo9gpyGPfZpgK9D9AkdKze7pQbdVf2Nof0tuGeaOyvXxqLR6pxfZobh6ML19/LVcfO4+FkuGLrEhq2yRJJ0Qb0kHTH54q3v6ygA6Pru++l5d/DtQVj7/AW6fJZqMVLzGAAAAAElFTkSuQmCC'), auto";
+    /** Ordered array of all bucket stages, from empty to full. */
+    readonly stages: readonly string[];
+};
+/**
+ * Free-to-Play Rune cursor pack — the 10 runes available to F2P players.
+ *
+ * Ordered by the four elemental runes, then combat/utility runes.
+ * Great for magic-themed UIs, tooltips, or decorative hover effects.
+ *
+ * @example
+ * ```ts
+ * import { runePack } from '@dava96/osrs-icons';
+ *
+ * // Pick a random rune cursor
+ * const randomIndex = Math.floor(Math.random() * runePack.stages.length);
+ * element.style.cursor = runePack.stages[randomIndex];
+ * ```
+ */
+export declare const runePack: {
+    readonly air: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAAz1BMVEVMaXGPhYWonJtza2tsZGR1bWyVionk4eEAAAFwaWl3b259dHR5cXCEenqdkpKbkJB7cnK/trakmZiaj4+QhoaNg4OFfHuLgoF/dnavoqKmm5qpnp2rn5+WjItuZmaJgH/Cubm8srK6r6+soKC3rKy0qaiflJSjl5aYjo2TiIiBeHiHfn2xpaWvpKRbVVW2q6qhlZXFvLyyqKdlXl25rq27sbFjXFtqYmJnYGBRSkpMRka+tLRFQEBUTU1YUlJIQ0NhWlrGvr7BuLddV1dWUFArijJsAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAcdJREFUeNpt02mbmkAMAGBBJUEEXOQ+pCtyyCHUe92z7f7/39QMSO3W5oOPT95JMgzDYHAL7GNwH4jVtl4tD48P3+4c0YucMq5X+yXx9y+OmGi8H1XlNo5XLf+4MQrzRHM9P3KcqrzyH0WONNV43qMFkbP9whiSKk2aaq7LA/h+WTPuFKWCVFWUpGlSoOA9J973jJJpBEGWzVWAhCm4blSunh+YojgzDX29FoIAgK2gSDWvqg+McTGVLcMA0NcCQJa1nDS8Ey9/4gBHk7woQkpxHP0IAVPaBV+tnklPYzuXTZNyVt+BJihaFB9Id0PJzkFumRroOv3J5krqlXvSD3EmSZSRAQoAo+0fZIrmOjXp22gynVEmB6B6i7Wn6Qqd+5b09TyeTClj26w8DBmvBdXl/Yr0chyOyWd9d7Z9XVB5z3fYA29EcdiWSzZ0u6NiNXX59rAuxwUxAJtOD8eQ09Wk0bqDfj0RUzl05TTc0DNVub6k981oIV7L2XQztDghmPcv+Ok4GrHuk3bzuVxYnL7uLwe+vJ1PLbd7t2WzoOrb1Xl52uy67sTkufz3pUR8Z86iW4H/3ufL52bz62N3ph7/+RoQ77+U36KNMyU1Bh/+AAAAAElFTkSuQmCC'), auto";
+    readonly fire: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAAz1BMVEVMaXGaj4+kmZibkJCdkpKonJtsZGQAAAGoIhVwaWlza2uPhYWViol1bWyflJS/trajl5apnp2mm5qQhoZ9dHR3b26rn5+voqJuZmaLgoGEenqBeHiHfn2WjIvCubmYjo17cnKhlZW8srK6r695cXCsoKC3rKy0qaiFfHuNg4N/dnavpKSxpaVbVVWJgH+TiIi2q6rFvLyyqKdlXl25rq27sbFjXFtqYmJRSkpnYGBMRka+tLRFQEBUTU1YUlJIQ0NhWlrGvr7BuLddV1dWUFD3A8DAAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAaRJREFUeNpt0+mSojAQAGAJYEdBhkuQa5FVLgFhPUfnntn3f6btoKyjTlflD1/TlXQ6vd4loIvefQAUqyaZbX8//LpzAC22y7RJNjPkP1cOoBDRiotylaZJyx8XBplTiK5ZsW0X5Zn/K0ioKhFFDRNie3XFsEQVIlUluo4ZllU2jE8Kpo/KC4ISRSohLMFONx2DmeVBEIYczwsKPZWIy+TpgSkMpllu1LUc0JDjqNBmEK1otoxhMnedPJcMg8ptBk+pokSinc4+oQf9sef7S8ehVDIopUFAKduFWCRPqPvRwnOzzEfJcdW4GJM43aKuh+bC81z2Ef+n7H+sL6hauUF9H0xNdHoVoUB0u0F97Y/nU5PehIB9X6G+HEbj+fwGZV4XrQL1uBuORuM7xZba7MDVYDC8YanmVV1sm3XcTZCv1eCViJwa/bJHHl7MX+ZGyAvnS3qr+hOs3qGbLR1JDrjugh93ffQzY+d8RzLqbjjg+fWwZ4x7x6Mv3Az7Ll1G5/mxWrfVGaN77vehBHhjzuKUAbfzfPxbVV/v6wPW+OE1ANy/lH+KczGeQmrIpwAAAABJRU5ErkJggg=='), auto";
+    readonly water: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAAz1BMVEVMaXGaj4+onJt1bWydkpJwaWmPhYUVGqgAAAGViolsZGR9dHSQhoaWjIubkJB3b26Eenp5cXCkmZhza2uBeHiHfn17cnKTiIh/dnaFfHuLgoGNg4O/traYjo2flJSjl5amm5qpnp2JgH+hlZWrn5+voqJuZmbCubm8srK6r6+soKC3rKy0qaixpaWvpKRbVVW2q6rFvLyyqKdlXl25rq27sbFjXFtqYmJRSkpnYGBMRka+tLRFQEBUTU1YUlJIQ0NhWlrGvr7BuLddV1dWUFDUeke0AAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAapJREFUeNpt02mDmjAQBmDBSAbEKHiAsnII2Mpdz9U9e/z/37STAEu3dr4+kxdmCL1eV9BW774Ain2V7k7fH77dOUCQxHlWpccd8o8vDuCacpQU+T7LUsE/OwZVck0/iJI4LvKGPxUUVM+U5QAbknj/hWGDSkLPM30fO6IorzjXCsM5KiPEDUOPmrwhzo4tw3DpjEbrtcQYcWkdkeTp0wNXGCyWjm5ZKnZIEq0jzKCoTpxha0xWjqPouqWqlNYRbijH2e4X9EAbz+bzzWrlKIpOKRUR+BZykT6hXvr2bLJcigbU+hGMmEl2Qj1Mh/YMHQMoL3wCMvGC/Ij6PlgM0SfotGNi+nGF+qqNjcZpxwT3vkd9ufbHBrptzxpVkJkvRwXq7Tzt98XxBimOpzJcacwHLgeDqThOO7aY58tiWbfzlvPYaHGzUnTmhma96JcLMnqDOLqjrxlpPtJbqW1FukAcHQ+rI6n9wI9nTePpQnG0OUZb7eWA59frRbB4d3vC16p0V+f5sTw06cZiwTfz96UEeOPOq+6Af+/z7U9Z/n4/XDHjP38DwP2f8gHHtzWW+3HO1QAAAABJRU5ErkJggg=='), auto";
+    readonly earth: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAAz1BMVEVMaXFsZGSEenqPhYVwaWmdkpKonJttSQ0AAAF9dHSViol5cXCbkJCkmZh/dnaBeHh7cnJ3b251bWyHfn2LgoGFfHuaj49za2uJgH+Ng4OQhoa/traflJSjl5amm5qpnp2WjIuTiIirn5+voqJuZmbCubmYjo2hlZW8srK6r6+soKC3rKy0qaixpaWvpKRbVVW2q6rFvLyyqKdlXl25rq27sbFqYmJjXFtRSkpnYGBMRka+tLRFQEBYUlJUTU1IQ0NhWlrGvr7BuLddV1dWUFAr/HOAAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAZxJREFUeNpt0+liokAMAGAVBiIyXtyUQ8DVyl3Pau923/+ZNgOiRTd/v5BkMkOncw1oonMfAPm6TFa7x4c/dw7gx1GWlsl2hfzUcgCHCmGcZ+s0TSr+ujJIukM9P4yjKM/OfFHgUF0qCD4mxNG6xWCikqXrUs/DjDDMSsa1Ql9BlQlxlkuXUpYQpduGoa9Zs9liocsycZy6RJwlLw9MgR9rlh0EEmbolxJ+Xu4Yw3zQUy2Ls+1AkpoSoihE6eobOtCdjBTFVFVL/B1EyJMX1P10OOppWstEmdA43aFujP5wNGqjqBPXz7aon/y4j97raayBxXE4wGxBqBeVqG/dyeDirH/FBPe+Rn0/TicD9CFrr5gmGy+QZE8Ic9TTwZiit9rakowrjdiBC543bobiAtn1hGpZp8Ocv1Vbdpa0XvT7fs4bxrQZDptb9kIm50v6KLpzrH4eDtlUOWmmNxf8fOiiI09qVlQ8VfM44PXtuK+4qj6szs1dn87rc7Fpqo+rz38/SoAP5izqDLh9z6e/RfHzuTlijf/8DQD3f8o/qkc1EyGPx1YAAAAASUVORK5CYII='), auto";
+    readonly chaos: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAA2FBMVEVMaXF1bWxsZGSonJt5cXB3b25waWngqBoAAAHk4eGkmZh9dHRza2t7cnKPhYWdkpKbkJC/traViompnp2mm5qEenqBeHiLgoGaj49uZmavoqKrn59IRgmHfn1/dnaFfHvCubm8srK6r6+3rKy0qaiQhoasoKCflJSWjIujl5aJgH+Ng4OxpaWvpKRbVVWhlZW2q6qTiIiYjo3FvLyyqKdlXl0VERG5rq27sbFjXFtqYmJnYGBRSkpMRka+tLRFQEBUTU1YUlJIQ0NhWlrGvr7BuLddV1dWUFAAM/I5AAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAbBJREFUeNpt01ljojAQAGAFlWmUoxyiIGUrt9xU61V7btv//492wrGua+eBB75kkpkkvd45oIvedQCk68JZ7u5vf105gOIbiVs42yXyw4UDBIQ1/TRZu65T8+8zgzwLiKqYvmGkSct/FQTUiLCsggN8Y33BsEIV8ygiqoojTDMpKDcKYwtVEsUgzyNC6ADD3XYMYzsOw6qaSRJXB6bwE+f5liqMeDv2ylIOQ64NTKGkxY4yzAeaHseC53HcDQ3kIMhZw11+Qg+Y4dSyVrre4GJBGXfBps4z6qF/N9VsG//dLDrFTRLf3aFuJuO76VS70GomRkqyRf0Y8WN0rl22XjisRKIaBeobMxygN/r4WKscitj3NerrsT8coFOlSLmUJZU1U9TTftJH57lzRYInS9hSgxacjUYTOr1h/OqxUEqRytbNOu3nlIeDtlVYvOBJQU6aRr8ekOn0GjXbWsVeJYntIb1nzLzJjkhbg5PlcNYd8NOeYdrsPJauWZi67C4HvLwdDzX3a6a5deF8dV6esk2Xna+n/3spAd6p02hGwP/3+fSdZV8fmyPm+OE1AFy/lD+qgjWJ67gidwAAAABJRU5ErkJggg=='), auto";
+    readonly mind: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAA0lBMVEVMaXGLgoFwaWlsZGR5cXB7cnJ9dHQAAAFIRgngiBqEenqFfHuHfn2onJuPhYV1bWyViomdkpKbkJCBeHikmZiQhoaflJSJgH+Ng4OTiIi/trZ3b26aj49uZmZ/dnZza2ujl5ahlZXCubm8srK6r6+3rKyvoqKrn5+soKCpnp2mm5q0qaixpaWvpKRbVVWWjIuYjo3FvLy2q6qyqKdlXl27sbG5rq1jXFtqYmJRSkpMRkZnYGBFQEC+tLRYUlJUTU1IQ0NhWlrGvr7BuLdWUFBdV1d4dGkXAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAcRJREFUeNpt0+eCmkAQAGDBMrMivQiHBRNFQFBjP72a8v6vlJnljLmY+cnHTtnSaNwCrtG4D4Bqu5lN918fvtw5QJ6l5WIzO0yJv31ygMDT51lVbheLmeTvNwZrEHhFPs/StCo/+I+CQZp4up4LkWXp9hNDn9SeJIlXCKHn83kpmGuFTo9UCDuYTITwCl0XQhyuDB0tXNEH4Th2EFAKIYqsnD0/sILa1kI/Yl4PEJFTJF5ebfbMMGx1lTA0fD9CGXUKPV1Mf0ADmrHb6/UVJSSJIgtxPRg4tq1Xs2fSkzlyu5rWQ6QffKQMqzWxly32pLtxZ+SSI/YVZEeLm0zy8kD6rra5pS4iFwgNym+t1rZXpBvSl2bcanc6I8SuxvURfWKb9n1L+nox4xY5osvcr9kp9HlFej6OTTO+ssbNGb7l0JamPPBSVcdyeT2vLB45SaHLzTofh8RCyOVcXAjDd4KJV2/062moctuyOVeyWDv2xyG9LZvMdXPMfcWwVoPrAT8em03OHsc19xTDj66XA55eLifJJmcfybmN29V5elzuiNUxF5fL/76UAG/sHHK6Nvx7n88/l8tf77sL5fjPawC4fym/AWbpNUTFnNo2AAAAAElFTkSuQmCC'), auto";
+    readonly death: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAA0lBMVEVMaXGPhYWHfn1waWmLgoFsZGR5cXDk4eEAAAF7cnKViomdkpJ3b26Ng4OQhoaJgH91bWx9dHSaj4+WjIuonJu/traEenqkmZiFfHubkJCTiIhza2uvoqJuZmYVERHCubm8srKYjo2flJSpnp20qairn5+3rKy6r6+BeHijl5asoKCmm5qvpKSxpaVbVVV/dna2q6rFvLyhlZWyqKdlXl27sbFjXFtqYmK5rq1nYGBRSkpMRka+tLRFQEBUTU1YUlJIQ0NhWlrGvr7BuLddV1dWUFBUSRUMAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAbFJREFUeNpt0+di2jAQAGCMMTpb2MEjeGBoPMETl03IbNr3f6WeBAZSej/1Sac7jU7nGtBG5z4AylWTzjZPjz/uHCDK/Spu0v0M+ec3BwhtK8nLahXHKedfVwbFCO0iSnLfL6szXxQE1My2rIgQkvurbwwPqHSZZTZhkSRVw/ikoHdRXUpDZtMpsSI/3rcMuqOaZhAYSFxJUeRV+vLIFETZUTXPU0yuLJaZHZXNhjFM+qOeqgqaRtqgYbi0/Hj2BR2QBvNu96HXU/m2hJiBwaqwyvQFdTdczEeOc5owJbgFukvtPN6grsf6Yo6OCdhqTUMPDJpF1R71U5R19BH3nioInKld+A3quzToo+OykXPZ36R47ivUt8Nw0O/LvFrnnN1T3MJKStTjdjxEly8NEWxPca0o8VnDtSiOr8sJYZt7blZY/LCO2wnjwQ0Lmhsu7dNBv+2Qx0Nyk1sLXHq+pI9amogiH5bbxYpptBf8vJWkCRtmvWFnXUzttY8DXt8PO8a8dn3B+xauT+f1uV6z7Kx2WWYnd/soAT6YszjNgH/f8/FPXf/+XB8wx39+A8D9T/kLRWwzl3aLm/YAAAAASUVORK5CYII='), auto";
+    readonly law: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAAz1BMVEVMaXFsZGSPhYWdkpJwaWmLgoGFfHsaIuAAAAGHfn13b251bWyEenqJgH9za2uonJt9dHR5cXCkmZiViom/trZ7cnKNg4OQhoapnp1uZmabkJCvoqKaj4+rn5/CubmBeHi8srK6r6+mm5qjl5a3rKysoKC0qaiflJShlZV/dnZbVVWvpKSTiIixpaWWjIu2q6rFvLxlXl2yqKeYjo27sbFjXFtqYmJRSkpnYGBMRka5rq1FQEC+tLRUTU1YUlJIQ0NhWlrGvr7BuLddV1dWUFAdIpvGAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAbhJREFUeNpt0+eCmkAQAGAFYQZFaUeREiNNpMZ66tUk9/7PdLMIMRcz/+DbnZltg8EtsI/BfSAW2yZe7r8/fLtzRCfxqrSJL0viH18ccaUrQVJU2zSNW/55YzT8lR46QeJ5RdXxH0WONNIVxaEBibf9wjgl5bMo0sOQRgRB1TC+KqoSqcvzqyyLdKBwvPTSM6qiVde7HdwiTKr4+YEpjkzRssuygy6FUzR7xjjXZMGyONsuDQNg57vAwypTvHT5Cwc4HC8kaQqCxXE2gFHX4AN1oRTxM+lxsl7IoiiBIFgANpWogVhP0j3pZqauFyCLIE0FgHY+gM9HTnUhfR+Zqtp2xApYXNedHnoN6etwrJntH7lN36sSbElfTpOxBj1Ppx2HSlCQng+zyWRM31ReBrGtDoZLW+qxBeej0Yyma6a6pv+MLa50o1BpN+t8mDOm6mqXXeBsd5Xp141+ORLP+uqMLXvn8t0hveXDeZu9VdoammzUfn/Aj4ch+aw7iIUsUeqyvxz49Ho6MqbeWW/X0rer8/SYb7rsmmmypf19KRHfmLO4jsB/7/P5I89/v29OlOM/rwHx/qV8AsWdMoqwxBK4AAAAAElFTkSuQmCC'), auto";
+    readonly nature: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAAz1BMVEVMaXFsZGR1bWyEenp9dHRwaWmViokAAAERixWPhYV7cnKLgoF5cXCbkJCdkpKNg4N3b26Hfn2aj4+WjIuQhoZza2uFfHuJgH9/dnaTiIiBeHi/trakmZionJuflJSYjo2voqJuZmbCubm8srK6r6+3rKyjl5a0qaisoKCpnp2vpKSrn59bVVW2q6qmm5qxpaXFvLyhlZWyqKdlXl25rq27sbFjXFtqYmJnYGBRSkpMRka+tLRFQEBUTU1YUlJIQ0NhWlrGvr7BuLddV1dWUFA3NRYCAAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAb1JREFUeNpt03ebmkAQBnARZQYVkCICR/OiNCmxe15N+f6f6WYXjLmY+YuHH/POsiy93q3gWr37Aii21Wp5+PbweOcAeRY3abXaL4m/f3GA0A/WWdFs03TF+ceNQTJCv87XWRwXTcd/FGTSxA+CnB7I4u0XhjmpukkSH7uqGLcKA51UUfFWcbq/MgxszTQjuqmoYbhJ6KLOmtXzA1MYjmzNcumeGRkUoYaIiZ8X1YExLCbiWNNIXUkyo8hQFMRwE8Tp8if0QJh6uj4nlWXLdSXTRGQRQbF6Jj31HU+0bcTxWJMtNoNGKKqfpQfS3WzgeOSIc5ogUwgNMNQkb/akH8PRgFwUbV3HMc8nVv06rkjfhOmkc2pHFk+s0r5vSV/P/emE3HE8RJ3FM1bqYF2QXo6zfr9tR7RR5ywpQb6O2QuXw+GsbUekcM6uktQB36zLccGY2hFZO7FsKeHGbzf69UTM2hFZO7FmRYrafaT3UljwdERqp1enZsk0rh/46SgILB2Rrd0TdYp2r4cDXt7OJ8587Y7IR9+OzstTuevSJyPe/vehBHhnzqp9Av49z5ffZfnrY3emjP/8DQD3f8onci40NjYnZ7EAAAAASUVORK5CYII='), auto";
+    readonly body: "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAcCAMAAACqEUSYAAAA0lBMVEVMaXF5cXCNg4NsZGSPhYV9dHR7cnIAAAEYINAVERGHfn2QhoaonJtwaWl/dnaEenqFfHuViomkmZidkpKbkJB1bWyBeHiJgH+LgoGaj493b26flJS/traWjIuTiIijl5Zza2vCubm8srK6r6+3rKyrn5+pnp2voqKsoKBuZmahlZW0qaivpKSmm5qYjo1bVVWxpaXFvLy2q6qyqKdlXl25rq27sbFjXFtqYmJRSkpMRkZnYGBFQEC+tLRYUlJUTU1IQ0NhWlrGvr7BuLdWUFBdV1esApB5AAAAAXRSTlMAQObYZgAAAAlwSFlzAAALEwAACxMBAJqcGAAAAcpJREFUeNpt0+uamkAMBmAFJAkHQUAFWcGtclBBrefVPbbb+7+lZkBrt3b+wfvkS2YYGo3bgutq3C+AYrOejPffHh7vHCDNs9V8PdmNmb9/cYDQMZK8WG3m80nFP24MnSB0yjTJs6xYXfiPgsIaO4aRIuZ5tvnC0Gd1Z3HslIhGmiSIgmuFlsaK6IazGaJTGgYi7q4MLVsa8ovA89wwFBGcv5q8PAgFU7UlPWIeLgIi4giMnbRY7wXDtGn5kqToetQhWhDVEUY2H/+EBsiDnqb1fV9SiKKIiCMCz3WNYvLCeuy2e5Zta30ikcDM7rlOPt+zbketdo+dqF91IOqIIeN0tWP9MFV+QIsn4gaczwMMF65TZmvWV3nQVFtcb1mCRTyzy+e+YX07dwdN9na7R6K7X7FXGknBejqMut26nKjurugdj480ExtemuaoLieqmqOkRF5cGtVhnQ5TZh5MrdTWEBXdC2dOfdBvx6nJeB1OMC489/KR3pfylF9chmPm4s4wuH7gp4Mso2g+qFnzeezr5YDn1/NRFs27KJiz+75yuzrPT8stszlC5qr870sJ8C5crGp3Kvx7n0+fy+Wvj+2ZM/7zNwDc/ym/ARuUNYt5kjXZAAAAAElFTkSuQmCC'), auto";
+    /** Ordered array of all F2P runes: elementals first, then combat/utility. */
+    readonly stages: readonly string[];
+};
+/**
+ * Registry of all available cursor packs.
+ *
+ * The documentation site reads this array to automatically render
+ * every pack. To add a new pack to the site, simply push your
+ * {@link PackInfo} entry here — no site code changes needed.
+ *
+ * @example
+ * ```ts
+ * import { allPacks } from '@dava96/osrs-icons';
+ *
+ * allPacks.forEach(pack => {
+ *   console.log(`${pack.name}: ${pack.stages.length} stages`);
+ * });
+ * ```
+ */
+export declare const allPacks: PackInfo[];
+//# sourceMappingURL=packs.d.ts.map

package/dist/cjs/packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packs.d.ts","sourceRoot":"","sources":["../../src/packs.ts"],"names":[],"mappings":"AA6BA;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,6CAA6C;IAC7C,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AAIH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;IAWpB,8DAA8D;qBAYzD,SAAS,MAAM,EAAE;CACd,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU;;;;;;;IAOrB,8DAA8D;qBAQzD,SAAS,MAAM,EAAE;CACd,CAAC;AAIX;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;IAWnB,6EAA6E;qBAYxE,SAAS,MAAM,EAAE;CACd,CAAC;AAIX;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,EAoC9B,CAAC"}

package/dist/cjs/packs.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allPacks = exports.runePack = exports.bucketPack = exports.coinsPack = void 0;
+const icons_1 = require("./generated/icons");
+/**
+ * A cursor pack groups related OSRS icons by their in-game state.
+ *
+ * Each key is a semantic label and each value is the corresponding
+ * CSS cursor string, ready to apply to any element's `cursor` property.
+ *
+ * **Want to add a new pack?** See the
+ * {@link https://github.com/Dava96/osrs-icons/blob/main/CONTRIBUTING.md | Contributing Guide}
+ * for instructions on assembling and submitting your own cursor packs.
+ *
+ * @example
+ * ```ts
+ * import { coinsPack, animateCursor } from '@dava96/osrs-icons';
+ *
+ * // Animate the coin stack growing
+ * const stop = animateCursor(coinsPack.stages, { duration: 1200 });
+ * ```
+ */
+// ── Progression Packs ──────────────────────────────────────────────
+/**
+ * Coins cursor pack — represents increasing wealth from 1gp to 10,000gp.
+ *
+ * In OSRS, the coin stack sprite changes based on the amount.
+ * Great for progress indicators, score displays, or loading states.
+ *
+ * @example
+ * ```ts
+ * import { coinsPack } from '@dava96/osrs-icons';
+ *
+ * // Map a 0–100 progress value to a coin stack
+ * const stages = coinsPack.stages;
+ * const index = Math.min(Math.floor(progress / 100 * stages.length), stages.length - 1);
+ * element.style.cursor = stages[index];
+ * ```
+ */
+exports.coinsPack = {
+    _1: icons_1.coins1,
+    _2: icons_1.coins2,
+    _3: icons_1.coins3,
+    _4: icons_1.coins4,
+    _5: icons_1.coins5,
+    _25: icons_1.coins25,
+    _100: icons_1.coins100,
+    _250: icons_1.coins250,
+    _1000: icons_1.coins1000,
+    _10000: icons_1.coins10000,
+    /** Ordered array of all coin stages, from 1gp to 10,000gp. */
+    stages: [
+        icons_1.coins1,
+        icons_1.coins2,
+        icons_1.coins3,
+        icons_1.coins4,
+        icons_1.coins5,
+        icons_1.coins25,
+        icons_1.coins100,
+        icons_1.coins250,
+        icons_1.coins1000,
+        icons_1.coins10000,
+    ],
+};
+/**
+ * Bucket cursor pack — represents a filling progression from empty to full.
+ *
+ * Perfect for loading indicators, progress bars, or upload states.
+ * The `stages` array orders them from empty → full for easy indexing.
+ *
+ * @example
+ * ```ts
+ * import { bucketPack } from '@dava96/osrs-icons';
+ *
+ * // Map a 0–100 progress value to a bucket fill state
+ * const stages = bucketPack.stages;
+ * const index = Math.min(Math.floor(progress / 100 * stages.length), stages.length - 1);
+ * element.style.cursor = stages[index];
+ * ```
+ */
+exports.bucketPack = {
+    empty: icons_1.bucket,
+    fifth: icons_1._15thsFullBucket,
+    twoFifths: icons_1._25thsFullBucket,
+    threeFifths: icons_1._35thsFullBucket,
+    fourFifths: icons_1._45thsFullBucket,
+    full: icons_1.bucketOfWater,
+    /** Ordered array of all bucket stages, from empty to full. */
+    stages: [
+        icons_1.bucket,
+        icons_1._15thsFullBucket,
+        icons_1._25thsFullBucket,
+        icons_1._35thsFullBucket,
+        icons_1._45thsFullBucket,
+        icons_1.bucketOfWater,
+    ],
+};
+// ── Collection Packs ───────────────────────────────────────────────
+/**
+ * Free-to-Play Rune cursor pack — the 10 runes available to F2P players.
+ *
+ * Ordered by the four elemental runes, then combat/utility runes.
+ * Great for magic-themed UIs, tooltips, or decorative hover effects.
+ *
+ * @example
+ * ```ts
+ * import { runePack } from '@dava96/osrs-icons';
+ *
+ * // Pick a random rune cursor
+ * const randomIndex = Math.floor(Math.random() * runePack.stages.length);
+ * element.style.cursor = runePack.stages[randomIndex];
+ * ```
+ */
+exports.runePack = {
+    air: icons_1.airRune,
+    fire: icons_1.fireRune,
+    water: icons_1.waterRune,
+    earth: icons_1.earthRune,
+    chaos: icons_1.chaosRune,
+    mind: icons_1.mindRune,
+    death: icons_1.deathRune,
+    law: icons_1.lawRune,
+    nature: icons_1.natureRune,
+    body: icons_1.bodyRune,
+    /** Ordered array of all F2P runes: elementals first, then combat/utility. */
+    stages: [
+        icons_1.airRune,
+        icons_1.fireRune,
+        icons_1.waterRune,
+        icons_1.earthRune,
+        icons_1.chaosRune,
+        icons_1.mindRune,
+        icons_1.deathRune,
+        icons_1.lawRune,
+        icons_1.natureRune,
+        icons_1.bodyRune,
+    ],
+};
+// ── Pack Registry ──────────────────────────────────────────────────
+/**
+ * Registry of all available cursor packs.
+ *
+ * The documentation site reads this array to automatically render
+ * every pack. To add a new pack to the site, simply push your
+ * {@link PackInfo} entry here — no site code changes needed.
+ *
+ * @example
+ * ```ts
+ * import { allPacks } from '@dava96/osrs-icons';
+ *
+ * allPacks.forEach(pack => {
+ *   console.log(`${pack.name}: ${pack.stages.length} stages`);
+ * });
+ * ```
+ */
+exports.allPacks = [
+    {
+        name: 'Coins',
+        icon: icons_1.coins10000,
+        importName: 'coinsPack',
+        description: 'Stack grows from 1gp to 10,000gp — great for progress or score displays',
+        stageLabels: ['1', '2', '3', '4', '5', '25', '100', '250', '1K', '10K'],
+        stages: exports.coinsPack.stages,
+    },
+    {
+        name: 'Bucket',
+        icon: icons_1.bucket,
+        importName: 'bucketPack',
+        description: 'Empty → Full — perfect for loading indicators or upload progress',
+        stageLabels: ['Empty', '1/5', '2/5', '3/5', '4/5', 'Full'],
+        stages: exports.bucketPack.stages,
+    },
+    {
+        name: 'F2P Runes',
+        icon: icons_1.airRune,
+        importName: 'runePack',
+        description: 'All 10 free-to-play runes — perfect for magic-themed UIs or hover effects',
+        stageLabels: [
+            'Air',
+            'Fire',
+            'Water',
+            'Earth',
+            'Chaos',
+            'Mind',
+            'Death',
+            'Law',
+            'Nature',
+            'Body',
+        ],
+        stages: exports.runePack.stages,
+    },
+];

package/dist/esm/animateCursor.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Options for {@link animateCursor}.
+ */
+export interface AnimateCursorOptions {
+    /**
+     * Total duration of one full animation cycle in milliseconds.
+     * Each frame occupies `duration / frames.length` of the cycle.
+     *
+     * @default 1000
+     */
+    duration?: number;
+    /**
+     * Element to scope the animated cursor to.
+     * When omitted the cursor animates on the entire page (`*`).
+     */
+    target?: HTMLElement;
+    /**
+     * How many times the cycle should repeat.
+     * Use `Infinity` (the default) for a continuous loop.
+     *
+     * @default Infinity
+     */
+    iterations?: number;
+}
+/**
+ * Animates a cursor by cycling through an ordered array of OSRS icon
+ * strings using a pure‑CSS `@keyframes` rule.
+ *
+ * Each frame is assigned an equal slice of the total `duration` and
+ * transitions are **discrete** (`step-end`), producing a clean
+ * frame‑by‑frame sprite animation — no JavaScript timers required.
+ *
+ * **Browser‑only** — in non‑browser environments (Node / SSR) this
+ * is a no‑op that returns an empty cleanup function.
+ *
+ * @param frames  - An ordered array of CSS cursor strings (≥ 2).
+ * @param options - Optional configuration for duration, target, and iterations.
+ * @returns A cleanup function that removes the injected styles and
+ *          stops the animation.
+ *
+ * @throws {Error} If fewer than 2 frames are provided.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   coins1, coins2, coins3, coins4, coins5,
+ *   animateCursor,
+ * } from '@dava96/osrs-icons';
+ *
+ * // Animate a growing coin stack on the whole page
+ * const stop = animateCursor(
+ *   [coins1, coins2, coins3, coins4, coins5],
+ *   { duration: 1200 },
+ * );
+ *
+ * // Later, stop the animation and clean up
+ * stop();
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { lobsterRaw, lobsterCooked, lobsterBurnt, animateCursor } from '@dava96/osrs-icons';
+ *
+ * // Scope to a specific element, play 3 times
+ * const stop = animateCursor(
+ *   [lobsterRaw, lobsterCooked, lobsterBurnt],
+ *   { duration: 900, target: document.getElementById('cooking')!, iterations: 3 },
+ * );
+ * ```
+ */
+export declare function animateCursor(frames: string[], options?: AnimateCursorOptions): () => void;
+//# sourceMappingURL=animateCursor.d.ts.map

package/dist/esm/animateCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animateCursor.d.ts","sourceRoot":"","sources":["../../src/animateCursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,IAAI,CAiD9F"}

package/dist/esm/animateCursor.js

@@ -0,0 +1,91 @@
+/**
+ * Animates a cursor by cycling through an ordered array of OSRS icon
+ * strings using a pure‑CSS `@keyframes` rule.
+ *
+ * Each frame is assigned an equal slice of the total `duration` and
+ * transitions are **discrete** (`step-end`), producing a clean
+ * frame‑by‑frame sprite animation — no JavaScript timers required.
+ *
+ * **Browser‑only** — in non‑browser environments (Node / SSR) this
+ * is a no‑op that returns an empty cleanup function.
+ *
+ * @param frames  - An ordered array of CSS cursor strings (≥ 2).
+ * @param options - Optional configuration for duration, target, and iterations.
+ * @returns A cleanup function that removes the injected styles and
+ *          stops the animation.
+ *
+ * @throws {Error} If fewer than 2 frames are provided.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   coins1, coins2, coins3, coins4, coins5,
+ *   animateCursor,
+ * } from '@dava96/osrs-icons';
+ *
+ * // Animate a growing coin stack on the whole page
+ * const stop = animateCursor(
+ *   [coins1, coins2, coins3, coins4, coins5],
+ *   { duration: 1200 },
+ * );
+ *
+ * // Later, stop the animation and clean up
+ * stop();
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { lobsterRaw, lobsterCooked, lobsterBurnt, animateCursor } from '@dava96/osrs-icons';
+ *
+ * // Scope to a specific element, play 3 times
+ * const stop = animateCursor(
+ *   [lobsterRaw, lobsterCooked, lobsterBurnt],
+ *   { duration: 900, target: document.getElementById('cooking')!, iterations: 3 },
+ * );
+ * ```
+ */
+export function animateCursor(frames, options = {}) {
+    if (frames.length < 2) {
+        throw new Error(`animateCursor requires at least 2 frames, received ${frames.length}.`);
+    }
+    if (typeof document === 'undefined') {
+        return () => { };
+    }
+    const { duration = 1000, target, iterations = Infinity } = options;
+    const animationName = generateAnimationName();
+    const scopeId = `${animationName}-scope`;
+    const selector = target ? `[data-osrs-anim-id="${scopeId}"]` : '*';
+    if (target) {
+        target.setAttribute('data-osrs-anim-id', scopeId);
+    }
+    const keyframeSteps = frames
+        .map((cursorValue, index) => {
+        const percentage = ((index / frames.length) * 100).toFixed(2);
+        return `  ${percentage}% { cursor: ${cursorValue}; }`;
+    })
+        .join('\n');
+    const iterationCount = iterations === Infinity ? 'infinite' : String(iterations);
+    const css = [
+        `@keyframes ${animationName} {`,
+        keyframeSteps,
+        '}',
+        `${selector} {`,
+        `  animation: ${animationName} ${duration}ms step-end ${iterationCount};`,
+        '}',
+    ].join('\n');
+    const styleElement = document.createElement('style');
+    styleElement.textContent = css;
+    styleElement.setAttribute('data-osrs-animate', 'true');
+    document.head.appendChild(styleElement);
+    return () => {
+        styleElement.remove();
+        if (target) {
+            target.removeAttribute('data-osrs-anim-id');
+        }
+    };
+}
+/** Generates a short unique ID for animation scoping. */
+let animCounter = 0;
+function generateAnimationName() {
+    return `osrs-anim-${++animCounter}-${Date.now().toString(36)}`;
+}