@dava96/osrs-icons 1.0.15 → 1.0.17

package/LICENSE

@@ -0,0 +1,25 @@
+Attribution — NonCommercial — ShareAlike 3.0 Unported
+(CC BY-NC-SA 3.0)
+
+Full licence text: https://creativecommons.org/licenses/by-nc-sa/3.0/legalcode
+
+You are free to:
+
+  Share — copy and redistribute the material in any medium or format.
+  Adapt — remix, transform, and build upon the material.
+
+Under the following terms:
+
+  Attribution — You must give appropriate credit, provide a link to
+  the licence, and indicate if changes were made.
+
+  NonCommercial — You may not use the material for commercial purposes.
+
+  ShareAlike — If you remix, transform, or build upon the material, you
+  must distribute your contributions under the same licence.
+
+---
+
+This project is not affiliated with Jagex Ltd.
+OSRS icons are sourced from the Old School RuneScape Wiki and are the
+property of Jagex / the Wiki contributors.

package/README.md

@@ -8,12 +8,47 @@ Designed for easy integration with modern web apps, with full tree-shaking suppo
 [![license](https://img.shields.io/npm/l/@dava96/osrs-icons)](./LICENSE)
 [![GitHub stars](https://img.shields.io/github/stars/Dava96/osrs-icons)](https://github.com/Dava96/osrs-icons)
 
+📖 **[Browse icons & build packs →](https://dava96.github.io/osrs-icons/)**
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Usage](#usage)
+  - [CSS Cursor](#css-cursor-tree-shaking-supported)
+  - [As an Image](#as-an-image)
+  - [Icon Discovery](#icon-discovery)
+  - [CDN (No Build Step)](#cdn-usage-no-build-step)
+- [Cursor Packs](#cursor-packs)
+- [Utilities](#utilities)
+  - [flipCursor](#flip-cursor)
+  - [applyCursors](#apply-cursors)
+  - [errorCursor](#error-cursor-)
+- [API Reference](#api-reference)
+- [Browser Compatibility](#browser-compatibility)
+- [How It Works](#how-it-works)
+- [Contributing](#contributing)
+- [License](#license)
+
 ## Installation
 
 ```bash
 npm install @dava96/osrs-icons
 ```
 
+## Quick Start
+
+```tsx
+import { abyssalWhip } from '@dava96/osrs-icons';
+
+// As a cursor
+<div style={{ cursor: abyssalWhip }}>Hover me!</div>;
+
+// As an image
+import { toDataUrl } from '@dava96/osrs-icons';
+<img src={toDataUrl(abyssalWhip)} alt="Abyssal Whip" />;
+```
+
 ## Usage
 
 ### CSS Cursor (Tree-Shaking Supported)
@@ -38,7 +73,7 @@ Use the `toDataUrl` helper to extract the raw data URL for use outside of CSS:
 import { abyssalWhip, dragonScimitar, toDataUrl } from '@dava96/osrs-icons';
 
 // Single icon
-<img src={toDataUrl(abyssalWhip)} alt="Abyssal Whip" />
+<img src={toDataUrl(abyssalWhip)} alt="Abyssal Whip" />;
 
 // Multiple icons at once
 const urls = toDataUrl({
@@ -57,10 +92,12 @@ Browse all available icons programmatically with `iconNames`, or restrict values
 import { iconNames, type IconName } from '@dava96/osrs-icons';
 
 // Search / autocomplete
-const results = iconNames.filter(name => name.includes('dragon'));
+const results = iconNames.filter((name) => name.includes('dragon'));
 
 // Type-safe icon references
-function setCustomCursor(name: IconName) { /* ... */ }
+function setCustomCursor(name: IconName) {
+  /* ... */
+}
 ```
 
 ### CDN Usage (No Build Step)
@@ -70,11 +107,129 @@ You can use the package directly in the browser via ESM.sh:
 ```html
 <script type="module">
   import { AbyssalWhip } from 'https://esm.sh/@dava96/osrs-icons';
-  
+
   document.body.style.cursor = AbyssalWhip;
 </script>
 ```
 
+## Cursor Packs
+
+Pre-built thematic icon groups — each pack groups related icons by their in-game state:
+
+```ts
+import { runePack, bucketPack, coinsPack } from '@dava96/osrs-icons';
+
+// Rune pack — all 10 F2P runes
+element.style.cursor = runePack.air;
+
+// Bucket fill progression — great for loading states
+const stages = bucketPack.stages; // [empty, 1/5, 2/5, 3/5, 4/5, full]
+const index = Math.min(Math.floor((progress / 100) * stages.length), stages.length - 1);
+element.style.cursor = stages[index];
+```
+
+**Available packs:**
+
+| Pack         | Keys                                                                                            |
+| ------------ | ----------------------------------------------------------------------------------------------- |
+| `coinsPack`  | `_1` to `_10000` + `stages[]`                                                                   |
+| `bucketPack` | `empty` to `full` + `stages[]`                                                                  |
+| `runePack`   | `air`, `fire`, `water`, `earth`, `chaos`, `mind`, `death`, `law`, `nature`, `body` + `stages[]` |
+
+## Utilities
+
+### Flip Cursor
+
+Many OSRS icons face right, but cursors typically point left. Flip one icon, an array, or an entire pack:
+
+```ts
+import { abyssalWhip, runePack, flipCursor } from '@dava96/osrs-icons';
+
+// Single icon
+const leftFacing = await flipCursor(abyssalWhip);
+
+// Array of icons
+const [flippedAir, flippedFire] = await flipCursor([runePack.air, runePack.fire]);
+
+// Entire pack — flips all values and stages in one call
+const flippedRunes = await flipCursor(runePack);
+```
+
+Results are cached internally — flipping the same icon twice returns instantly. Browser-only (uses Canvas API); returns the original value in Node.js/SSR.
+
+### Apply Cursors
+
+Map OSRS icons to standard CSS cursor states with a one-liner:
+
+```ts
+import { abyssalWhip, dragonScimitar, bucketPack, applyCursors } from '@dava96/osrs-icons';
+
+const cleanup = applyCursors({
+  default: abyssalWhip,
+  pointer: dragonScimitar,
+  wait: bucketPack.full,
+});
+
+// Later, revert to browser defaults
+cleanup();
+```
+
+You can also scope cursors to a specific element:
+
+```ts
+applyCursors({ default: abyssalWhip }, document.getElementById('game-area')!);
+```
+
+### Error Cursor 🐟
+
+Use the iconic red herring as your error cursor:
+
+```ts
+import { errorCursor } from '@dava96/osrs-icons';
+
+// Also available via herringPack.error
+element.style.cursor = errorCursor;
+```
+
+## API Reference
+
+### Types
+
+| Type            | Description                                                                                |
+| --------------- | ------------------------------------------------------------------------------------------ |
+| `IconName`      | Union of all valid icon name strings (for type-safe references)                            |
+| `CursorMapping` | `Partial<Record<CursorState, string>>` — maps CSS cursor states to icon values             |
+| `CursorState`   | `'default' \| 'pointer' \| 'wait' \| 'text' \| 'move' \| ...` — standard CSS cursor states |
+
+### Functions
+
+| Function       | Signature                                                     | Description                                                                              |
+| -------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `toDataUrl`    | `(cursor: string) → string`                                   | Extracts the raw `data:image/png;base64,...` URL from a CSS cursor value                 |
+| `toDataUrl`    | `(cursors: Record<K, string>) → Record<K, string>`            | Batch version — extracts URLs from multiple cursor values                                |
+| `flipCursor`   | `(cursor: string) → Promise<string>`                          | Horizontally flips a cursor icon at runtime via Canvas API. Cached. Browser-only.        |
+| `applyCursors` | `(mapping: CursorMapping, target?: HTMLElement) → () => void` | Injects a `<style>` tag mapping cursor states to OSRS icons. Returns a cleanup function. |
+
+### Constants
+
+| Export        | Type                     | Description                                                |
+| ------------- | ------------------------ | ---------------------------------------------------------- |
+| `iconNames`   | `readonly string[]`      | Array of all available icon name strings                   |
+| `errorCursor` | `string`                 | Semantic alias for `redHerring`                            |
+| `*Pack`       | `Record<string, string>` | Pre-built cursor packs (see [Cursor Packs](#cursor-packs)) |
+
+## Browser Compatibility
+
+| Feature        | Browser                | Node.js / SSR             |
+| -------------- | ---------------------- | ------------------------- |
+| Icon imports   | ✅ All                 | ✅ All                    |
+| `toDataUrl`    | ✅ All                 | ✅ All                    |
+| `applyCursors` | ✅ All modern          | ⚠️ Returns no-op cleanup  |
+| `flipCursor`   | ✅ Canvas API required | ⚠️ Returns original value |
+| Cursor packs   | ✅ All                 | ✅ All                    |
+
+All features are SSR-safe — browser-only features degrade gracefully in Node.js environments by returning safe fallback values.
+
 ## How It Works
 
 The build script fetches every inventory sprite (~17,400 icons) from the
@@ -83,9 +238,19 @@ compresses them as palette PNGs, and generates a TypeScript file of named export
 
 Each icon is a small ~32×32 pixel sprite, base64-encoded inline — no external assets to host.
 
+### Package Output
+
+| Format | Path                  | Use                                  |
+| ------ | --------------------- | ------------------------------------ |
+| ESM    | `dist/esm/index.js`   | `import` (bundlers, modern browsers) |
+| CJS    | `dist/cjs/index.js`   | `require()` (Node.js, legacy)        |
+| Types  | `dist/cjs/index.d.ts` | TypeScript definitions               |
+
+The package has `"sideEffects": false` for optimal tree-shaking in Webpack, Rollup, Vite, and esbuild.
+
 ## Contributing
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for details on updating icons and publishing new versions.
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for details on local development, updating icons, and publishing new versions.
 
 ## License
 

package/dist/cjs/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/cjs/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/cjs/animateCursor.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.animateCursor = animateCursor;
+/**
+ * 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 },
+ * );
+ * ```
+ */
+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)}`;
+}

package/dist/cjs/applyCursors.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Standard CSS cursor states that can be mapped to OSRS icons.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/CSS/cursor
+ */
+export type CursorState = 'default' | 'pointer' | 'wait' | 'text' | 'move' | 'crosshair' | 'grab' | 'grabbing' | 'not-allowed' | 'help' | 'progress' | 'cell' | 'copy' | 'alias' | 'no-drop' | 'col-resize' | 'row-resize' | 'n-resize' | 'e-resize' | 's-resize' | 'w-resize' | 'zoom-in' | 'zoom-out';
+/**
+ * A mapping of CSS cursor states to OSRS icon cursor strings.
+ *
+ * Only include the states you want to override — unlisted states
+ * keep their default browser cursor.
+ */
+export type CursorMapping = Partial<Record<CursorState, string>>;
+/**
+ * Applies OSRS cursor icons to CSS cursor states on a target element
+ * or globally across the entire page.
+ *
+ * Injects a `<style>` tag with CSS rules that map each specified cursor
+ * state to the given OSRS icon. Returns a cleanup function that removes
+ * the injected styles and restores the previous cursors.
+ *
+ * **Browser-only** — in non-browser environments this is a no-op that
+ * returns an empty cleanup function.
+ *
+ * @param mapping - An object mapping CSS cursor states to OSRS cursor strings.
+ * @param target  - Optional element to scope the cursors to. Defaults to the
+ *                  entire document (global).
+ * @returns A cleanup function that reverts all applied cursors.
+ *
+ * @example
+ * ```ts
+ * import { abyssalWhip, dragonScimitar, applyCursors } from '@dava96/osrs-icons';
+ *
+ * // Apply globally
+ * const remove = applyCursors({
+ *   default: abyssalWhip,
+ *   pointer: dragonScimitar,
+ * });
+ *
+ * // Later, revert to browser defaults
+ * remove();
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { bucketPack, applyCursors } from '@dava96/osrs-icons';
+ *
+ * // Scope to a specific element
+ * const cleanup = applyCursors(
+ *   { wait: bucketPack.full },
+ *   document.getElementById('loading-area')!,
+ * );
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { herringPack, applyCursors } from '@dava96/osrs-icons';
+ *
+ * // Use the red herring for error states!
+ * applyCursors({ not-allowed: herringPack.error });
+ * ```
+ */
+export declare function applyCursors(mapping: CursorMapping, target?: HTMLElement): () => void;
+//# sourceMappingURL=applyCursors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applyCursors.d.ts","sourceRoot":"","sources":["../../src/applyCursors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,WAAW,GACX,MAAM,GACN,UAAU,GACV,aAAa,GACb,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,IAAI,CA6BrF"}

package/dist/cjs/applyCursors.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyCursors = applyCursors;
+/**
+ * Applies OSRS cursor icons to CSS cursor states on a target element
+ * or globally across the entire page.
+ *
+ * Injects a `<style>` tag with CSS rules that map each specified cursor
+ * state to the given OSRS icon. Returns a cleanup function that removes
+ * the injected styles and restores the previous cursors.
+ *
+ * **Browser-only** — in non-browser environments this is a no-op that
+ * returns an empty cleanup function.
+ *
+ * @param mapping - An object mapping CSS cursor states to OSRS cursor strings.
+ * @param target  - Optional element to scope the cursors to. Defaults to the
+ *                  entire document (global).
+ * @returns A cleanup function that reverts all applied cursors.
+ *
+ * @example
+ * ```ts
+ * import { abyssalWhip, dragonScimitar, applyCursors } from '@dava96/osrs-icons';
+ *
+ * // Apply globally
+ * const remove = applyCursors({
+ *   default: abyssalWhip,
+ *   pointer: dragonScimitar,
+ * });
+ *
+ * // Later, revert to browser defaults
+ * remove();
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { bucketPack, applyCursors } from '@dava96/osrs-icons';
+ *
+ * // Scope to a specific element
+ * const cleanup = applyCursors(
+ *   { wait: bucketPack.full },
+ *   document.getElementById('loading-area')!,
+ * );
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { herringPack, applyCursors } from '@dava96/osrs-icons';
+ *
+ * // Use the red herring for error states!
+ * applyCursors({ not-allowed: herringPack.error });
+ * ```
+ */
+function applyCursors(mapping, target) {
+    if (typeof document === 'undefined') {
+        return () => { };
+    }
+    const styleElement = document.createElement('style');
+    const selector = target ? `[data-osrs-cursor-id="${generateId()}"]` : '*';
+    if (target) {
+        target.setAttribute('data-osrs-cursor-id', selector.slice(22, -2));
+    }
+    const rules = Object.entries(mapping)
+        .map(([state, cursorValue]) => {
+        const fallback = state === 'default' ? 'auto' : state;
+        return `${selector} { cursor: ${cursorValue.replace(', auto', `, ${fallback}`)}; }`;
+    })
+        .join('\n');
+    styleElement.textContent = rules;
+    styleElement.setAttribute('data-osrs-cursors', 'true');
+    document.head.appendChild(styleElement);
+    return () => {
+        styleElement.remove();
+        if (target) {
+            target.removeAttribute('data-osrs-cursor-id');
+        }
+    };
+}
+/** Generates a short unique ID for scoping cursor styles to elements. */
+let idCounter = 0;
+function generateId() {
+    return `osrs-${++idCounter}-${Date.now().toString(36)}`;
+}

package/dist/cjs/flip.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Horizontally flips CSS cursor icons so they point in the opposite direction.
+ *
+ * Many OSRS inventory icons face right, but cursor conventions typically
+ * expect left-facing images. This helper mirrors the embedded base64 PNG
+ * using the Canvas API and returns new, ready-to-use CSS cursor strings.
+ *
+ * Results are cached internally — flipping the same icon twice returns
+ * the cached value instantly.
+ *
+ * **Browser-only** — requires the Canvas API. In non-browser environments
+ * (Node.js, SSR) the original cursor strings are returned unchanged.
+ *
+ * Supports three input shapes:
+ * - **Single string** → returns a single flipped string.
+ * - **Array of strings** → returns an array of flipped strings (same order).
+ * - **Record of strings** → returns a record with the same keys, values flipped.
+ *   Perfect for flipping an entire pack in one call.
+ *
+ * @example
+ * ```ts
+ * import { abyssalWhip, flipCursor } from '@dava96/osrs-icons';
+ *
+ * // Single icon
+ * const flipped = await flipCursor(abyssalWhip);
+ * document.body.style.cursor = flipped;
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { coinsPack, flipCursor } from '@dava96/osrs-icons';
+ *
+ * // Flip an entire pack
+ * const flippedPack = await flipCursor(coinsPack);
+ * // flippedPack._1, flippedPack._2, ... are all flipped
+ * // flippedPack.stages is a flipped array
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { airRune, fireRune, flipCursor } from '@dava96/osrs-icons';
+ *
+ * // Flip an array of cursors
+ * const [flippedAir, flippedFire] = await flipCursor([airRune, fireRune]);
+ * ```
+ */
+/** Flip a single CSS cursor string. */
+export declare function flipCursor(cursorValue: string): Promise<string>;
+/** Flip an array of CSS cursor strings, preserving order. */
+export declare function flipCursor(cursorValues: readonly string[]): Promise<string[]>;
+/** Flip every string value in a record (e.g. a pack object), preserving keys. */
+export declare function flipCursor<T extends Record<string, unknown>>(pack: T): Promise<{
+    [K in keyof T]: T[K] extends string ? string : T[K] extends readonly string[] ? string[] : T[K];
+}>;
+//# sourceMappingURL=flip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flip.d.ts","sourceRoot":"","sources":["../../src/flip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAUH,uCAAuC;AACvC,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAEvE,6DAA6D;AAC7D,wBAAsB,UAAU,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAErF,iFAAiF;AACjF,wBAAsB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,IAAI,EAAE,CAAC,GACN,OAAO,CAAC;KACR,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;CAChG,CAAC,CAAC"}