@dava96/osrs-icons 1.0.15 → 1.0.17

package/dist/esm/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/esm/generated/meta.js

@@ -1,4 +1,18 @@
 // Auto-generated OSRS Icon metadata
+/**
+ * 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'));
+ * ```
+ */
 export const iconNames = [
     '_10thBirthdayBalloons',
     '_10thBirthdayCape',

package/dist/esm/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/esm/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/esm/index.js

@@ -1,13 +1,30 @@
 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';
 export 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/esm/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/esm/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/esm/packs.js

@@ -0,0 +1,189 @@
+import { coins1, coins2, coins3, coins4, coins5, coins25, coins100, coins250, coins1000, coins10000, bucket, _15thsFullBucket, _25thsFullBucket, _35thsFullBucket, _45thsFullBucket, bucketOfWater, airRune, fireRune, waterRune, earthRune, chaosRune, mindRune, deathRune, lawRune, natureRune, bodyRune, } from './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];
+ * ```
+ */
+export const coinsPack = {
+    _1: coins1,
+    _2: coins2,
+    _3: coins3,
+    _4: coins4,
+    _5: coins5,
+    _25: coins25,
+    _100: coins100,
+    _250: coins250,
+    _1000: coins1000,
+    _10000: coins10000,
+    /** Ordered array of all coin stages, from 1gp to 10,000gp. */
+    stages: [
+        coins1,
+        coins2,
+        coins3,
+        coins4,
+        coins5,
+        coins25,
+        coins100,
+        coins250,
+        coins1000,
+        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];
+ * ```
+ */
+export const bucketPack = {
+    empty: bucket,
+    fifth: _15thsFullBucket,
+    twoFifths: _25thsFullBucket,
+    threeFifths: _35thsFullBucket,
+    fourFifths: _45thsFullBucket,
+    full: bucketOfWater,
+    /** Ordered array of all bucket stages, from empty to full. */
+    stages: [
+        bucket,
+        _15thsFullBucket,
+        _25thsFullBucket,
+        _35thsFullBucket,
+        _45thsFullBucket,
+        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];
+ * ```
+ */
+export const runePack = {
+    air: airRune,
+    fire: fireRune,
+    water: waterRune,
+    earth: earthRune,
+    chaos: chaosRune,
+    mind: mindRune,
+    death: deathRune,
+    law: lawRune,
+    nature: natureRune,
+    body: bodyRune,
+    /** Ordered array of all F2P runes: elementals first, then combat/utility. */
+    stages: [
+        airRune,
+        fireRune,
+        waterRune,
+        earthRune,
+        chaosRune,
+        mindRune,
+        deathRune,
+        lawRune,
+        natureRune,
+        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`);
+ * });
+ * ```
+ */
+export const allPacks = [
+    {
+        name: 'Coins',
+        icon: 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: coinsPack.stages,
+    },
+    {
+        name: 'Bucket',
+        icon: 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: bucketPack.stages,
+    },
+    {
+        name: 'F2P Runes',
+        icon: 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: runePack.stages,
+    },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dava96/osrs-icons",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "Old School RuneScape inventory icons as ready-to-use CSS cursor values. Tree-shakeable, zero runtime dependencies.",
   "keywords": [
     "osrs",
@@ -40,7 +40,7 @@
     "build": "tsc -p tsconfig.json && tsc -p tsconfig.esm.json",
     "prepublishOnly": "npm run build",
     "lint": "eslint .",
-    "test": "ts-node src/index_test.ts",
+    "test": "ts-node src/index_test.ts && ts-node src/packs_test.ts && ts-node src/flip_test.ts && ts-node src/applyCursors_test.ts && ts-node src/animateCursor_test.ts",
     "format": "prettier --write ."
   },
   "devDependencies": {

package/dist/cjs/index_test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cjs/index_test.js

@@ -1,110 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("./index");
-const meta_1 = require("./generated/meta");
-const node_assert_1 = __importDefault(require("node:assert"));
-const VALID_CURSOR = "url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAA'), auto";
-const EXPECTED_DATA_URL = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAA';
-// ── Single-value mode ──────────────────────────────────────────────
-function testExtractsDataUrlFromValidCursorValue() {
-    const result = (0, index_1.toDataUrl)(VALID_CURSOR);
-    node_assert_1.default.strictEqual(result, EXPECTED_DATA_URL);
-    console.log('✓ single: extracts data URL from a valid cursor value');
-}
-function testReturnsOriginalStringWhenNoUrlPatternFound() {
-    const plainString = 'not-a-cursor-value';
-    const result = (0, index_1.toDataUrl)(plainString);
-    node_assert_1.default.strictEqual(result, plainString);
-    console.log('✓ single: returns original string when no url() pattern found');
-}
-function testHandlesEmptyString() {
-    const result = (0, index_1.toDataUrl)('');
-    node_assert_1.default.strictEqual(result, '');
-    console.log('✓ single: handles empty string gracefully');
-}
-function testExtractsFromMinimalUrlPattern() {
-    const minimal = "url('https://example.com/icon.png'), auto";
-    const result = (0, index_1.toDataUrl)(minimal);
-    node_assert_1.default.strictEqual(result, 'https://example.com/icon.png');
-    console.log('✓ single: extracts URL from minimal url() pattern');
-}
-function testDoesNotMatchDoubleQuotedUrls() {
-    const doubleQuoted = 'url("data:image/png;base64,abc123"), auto';
-    const result = (0, index_1.toDataUrl)(doubleQuoted);
-    node_assert_1.default.strictEqual(result, doubleQuoted);
-    console.log('✓ single: does not match double-quoted url() (single-quote only)');
-}
-// ── Batch mode ─────────────────────────────────────────────────────
-function testBatchExtractsMultipleIcons() {
-    const secondCursor = "url('data:image/png;base64,AAAA'), auto";
-    const result = (0, index_1.toDataUrl)({
-        first: VALID_CURSOR,
-        second: secondCursor,
-    });
-    node_assert_1.default.deepStrictEqual(result, {
-        first: EXPECTED_DATA_URL,
-        second: 'data:image/png;base64,AAAA',
-    });
-    console.log('✓ batch: extracts data URLs from multiple icons');
-}
-function testBatchHandlesMixedValues() {
-    const result = (0, index_1.toDataUrl)({
-        valid: VALID_CURSOR,
-        invalid: 'not-a-cursor',
-    });
-    node_assert_1.default.deepStrictEqual(result, {
-        valid: EXPECTED_DATA_URL,
-        invalid: 'not-a-cursor',
-    });
-    console.log('✓ batch: handles mixed valid and invalid values');
-}
-function testBatchHandlesEmptyObject() {
-    const result = (0, index_1.toDataUrl)({});
-    node_assert_1.default.deepStrictEqual(result, {});
-    console.log('✓ batch: handles empty object');
-}
-// ── iconNames & IconName ───────────────────────────────────────────
-function testIconNamesIsNonEmptyArray() {
-    node_assert_1.default.ok(Array.isArray(meta_1.iconNames), 'iconNames should be an array');
-    node_assert_1.default.ok(meta_1.iconNames.length > 0, 'iconNames should not be empty');
-    console.log(`✓ iconNames: is a non-empty array (${meta_1.iconNames.length} entries)`);
-}
-function testIconNamesContainsKnownIcons() {
-    const knownIcons = ['abyssalWhip', '_24CaratSword', 'dragonScimitar'];
-    for (const name of knownIcons) {
-        node_assert_1.default.ok(meta_1.iconNames.includes(name), `iconNames should contain "${name}"`);
-    }
-    console.log('✓ iconNames: contains known icon names');
-}
-function testIconNamesEntriesAreStrings() {
-    const sample = meta_1.iconNames.slice(0, 100);
-    for (const name of sample) {
-        node_assert_1.default.strictEqual(typeof name, 'string', `Expected string, got ${typeof name}`);
-        node_assert_1.default.ok(name.length > 0, 'Icon name should not be empty');
-    }
-    console.log('✓ iconNames: all sampled entries are non-empty strings');
-}
-function testIconNamesIsSorted() {
-    for (let i = 1; i < meta_1.iconNames.length; i++) {
-        node_assert_1.default.ok(meta_1.iconNames[i] >= meta_1.iconNames[i - 1], `iconNames[${i}] ("${meta_1.iconNames[i]}") should come after iconNames[${i - 1}] ("${meta_1.iconNames[i - 1]}")`);
-    }
-    console.log('✓ iconNames: is sorted alphabetically');
-}
-// ── Runner ─────────────────────────────────────────────────────────
-console.log('\nRunning toDataUrl tests...\n');
-testExtractsDataUrlFromValidCursorValue();
-testReturnsOriginalStringWhenNoUrlPatternFound();
-testHandlesEmptyString();
-testExtractsFromMinimalUrlPattern();
-testDoesNotMatchDoubleQuotedUrls();
-testBatchExtractsMultipleIcons();
-testBatchHandlesMixedValues();
-testBatchHandlesEmptyObject();
-testIconNamesIsNonEmptyArray();
-testIconNamesContainsKnownIcons();
-testIconNamesEntriesAreStrings();
-testIconNamesIsSorted();
-console.log('\nAll tests passed!\n');

package/dist/esm/index_test.d.ts

@@ -1 +0,0 @@
-export {};