hudini 0.18.1 → 0.20.0

package/dist/loaders/load-fonts.d.ts

@@ -1,8 +1,37 @@
+/**
+ * Options for {@link loadFonts}.
+ *
+ * @property fontAwesomeUrl - Optional override for the Font Awesome stylesheet URL.
+ *   When omitted, `font-awesome-for-phaser` uses its own default.
+ * @property baseFont - Stylesheet URL for the base HUD font. Defaults to
+ *   Google Fonts' Fredoka (variable, weights 300..700).
+ * @property baseFontFamily - Font-family name matching the stylesheet above.
+ *   Must be the exact name the browser knows the font by. Defaults to `'Fredoka'`.
+ */
 type LoadFontsOptions = {
     fontAwesomeUrl?: string;
     baseFont?: string;
     baseFontFamily?: string;
 };
+/**
+ * Loads the fonts Hudini needs at runtime: Font Awesome (for the icon
+ * components) and a base HUD font (used by text-based components).
+ *
+ * By default it pulls Fredoka from Google Fonts. Pass `baseFont` + `baseFontFamily`
+ * to swap it for any other web font — just make sure both point to the same
+ * font-family name the browser will see.
+ *
+ * @example
+ * // Use the defaults (Font Awesome + Fredoka)
+ * await loadFonts();
+ *
+ * @example
+ * // Use a custom base font
+ * await loadFonts({
+ *   baseFont: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap',
+ *   baseFontFamily: 'Inter',
+ * });
+ */
 export declare const loadFonts: (options?: LoadFontsOptions) => Promise<void>;
 export {};
 //# sourceMappingURL=load-fonts.d.ts.map

package/dist/loaders/load-fonts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-fonts.d.ts","sourceRoot":"","sources":["../../src/loaders/load-fonts.ts"],"names":[],"mappings":"AAEA,KAAK,gBAAgB,GAAG;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAiCF,eAAO,MAAM,SAAS,GAAU,UAAU,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAexE,CAAC"}
+{"version":3,"file":"load-fonts.d.ts","sourceRoot":"","sources":["../../src/loaders/load-fonts.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,KAAK,gBAAgB,GAAG;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAiCF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS,GAAU,UAAU,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAexE,CAAC"}

package/dist/loaders/load-fonts.js

@@ -26,8 +26,27 @@ const ensureBaseFontReady = async (fontFamily) => {
     await Promise.all(loads);
     await document['fonts'].ready;
 };
+/**
+ * Loads the fonts Hudini needs at runtime: Font Awesome (for the icon
+ * components) and a base HUD font (used by text-based components).
+ *
+ * By default it pulls Fredoka from Google Fonts. Pass `baseFont` + `baseFontFamily`
+ * to swap it for any other web font — just make sure both point to the same
+ * font-family name the browser will see.
+ *
+ * @example
+ * // Use the defaults (Font Awesome + Fredoka)
+ * await loadFonts();
+ *
+ * @example
+ * // Use a custom base font
+ * await loadFonts({
+ *   baseFont: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap',
+ *   baseFontFamily: 'Inter',
+ * });
+ */
 export const loadFonts = async (options) => {
-    const { fontAwesomeUrl, baseFont = 'https://fonts.googleapis.com/css2?family=Bebas+Neue&display=swap', baseFontFamily = 'Bebas Neue', } = options ?? {};
+    const { fontAwesomeUrl, baseFont = 'https://fonts.googleapis.com/css2?family=Fredoka:wght@300..700&display=swap', baseFontFamily = 'Fredoka', } = options ?? {};
     try {
         await loadFontAwesomeForPhaser(fontAwesomeUrl);
         await loadStylesheet(baseFont);

package/dist/loaders/load-fonts.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-fonts.js","sourceRoot":"","sources":["../../src/loaders/load-fonts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAQ/E,MAAM,cAAc,GAAG,CAAC,GAAW,EAAiB,EAAE;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAQ,EAAE;QAC3C,MAAM,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;QACnE,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,GAAS,EAAE;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,GAAS,EAAE;YACxB,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,KAAK,EAAE,UAAkB,EAAiB,EAAE;IACtE,MAAM,KAAK,GAAG;QACZ,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,UAAU,GAAG,EAAE,GAAG,CAAC;QACpD,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,UAAU,GAAG,EAAE,GAAG,CAAC;KACrD,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,MAAO,QAA2D,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;AACpF,CAAC,CAAC;AAGF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,OAA0B,EAAiB,EAAE;IAC3E,MAAM,EACJ,cAAc,EACd,QAAQ,GAAG,kEAAkE,EAC7E,cAAc,GAAG,YAAY,GAC9B,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,IAAI,CAAC;QACH,MAAM,wBAAwB,CAAC,cAAc,CAAC,CAAC;QAC/C,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,mBAAmB,CAAC,cAAc,CAAC,CAAC;QAC1C,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"load-fonts.js","sourceRoot":"","sources":["../../src/loaders/load-fonts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAkB/E,MAAM,cAAc,GAAG,CAAC,GAAW,EAAiB,EAAE;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAQ,EAAE;QAC3C,MAAM,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;QACnE,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,GAAS,EAAE;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,GAAS,EAAE;YACxB,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,KAAK,EAAE,UAAkB,EAAiB,EAAE;IACtE,MAAM,KAAK,GAAG;QACZ,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,UAAU,GAAG,EAAE,GAAG,CAAC;QACpD,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,UAAU,GAAG,EAAE,GAAG,CAAC;KACrD,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,MAAO,QAA2D,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;AACpF,CAAC,CAAC;AAGF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,OAA0B,EAAiB,EAAE;IAC3E,MAAM,EACJ,cAAc,EACd,QAAQ,GAAG,6EAA6E,EACxF,cAAc,GAAG,SAAS,GAC3B,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,IAAI,CAAC;QACH,MAAM,wBAAwB,CAAC,cAAc,CAAC,CAAC;QAC/C,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,mBAAmB,CAAC,cAAc,CAAC,CAAC;QAC1C,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;AACH,CAAC,CAAC"}

package/dist/scene/index.d.ts

@@ -1,2 +1,3 @@
 export * from './scene-with-hudini';
+export * from './with-hudini';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scene/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scene/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/dist/scene/index.js

@@ -1,2 +1,3 @@
 export * from './scene-with-hudini';
+export * from './with-hudini';
 //# sourceMappingURL=index.js.map

package/dist/scene/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scene/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scene/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/dist/scene/scene-with-hudini.d.ts

@@ -1,8 +1,31 @@
 import { BaseThemeConfig, SceneWithPhaserWind } from 'phaser-wind';
 import { HudiniPlugin } from '../plugin/plugin';
+/**
+ * @deprecated Use {@link withHudini} instead.
+ *
+ * Forces single inheritance, which conflicts with any user-defined `BaseScene`
+ * or other libraries that ship their own scene base class. It also relies on a
+ * non-null assertion (`hudini!`) that lies to TypeScript about when the plugin
+ * is available — touching `this.hudini` before the plugin mounts throws at
+ * runtime.
+ *
+ * Prefer the `withHudini(scene)` accessor:
+ *
+ * ```ts
+ * import { withHudini } from 'hudini';
+ * import type { ThemeType } from './theme';
+ *
+ * class MyScene extends Phaser.Scene {
+ *   create() {
+ *     const hudini = withHudini<ThemeType>(this);
+ *   }
+ * }
+ * ```
+ *
+ * Kept exported to avoid breaking existing consumers.
+ */
 export declare abstract class SceneWithHudini<T extends BaseThemeConfig = BaseThemeConfig> extends SceneWithPhaserWind<T> {
     /**
-     *
      * @param config The scene key or scene specific configuration settings.
      */
     constructor(config?: string | Phaser.Types.Scenes.SettingsConfig);

package/dist/scene/scene-with-hudini.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-with-hudini.d.ts","sourceRoot":"","sources":["../../src/scene/scene-with-hudini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,8BAAsB,eAAe,CACnC,CAAC,SAAS,eAAe,GAAG,eAAe,CAC3C,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IAC9B;;;OAGG;gBACS,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc;IAIzD,MAAM,EAAG,YAAY,CAAC,CAAC,CAAC,CAAC;CACjC"}
+{"version":3,"file":"scene-with-hudini.d.ts","sourceRoot":"","sources":["../../src/scene/scene-with-hudini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8BAAsB,eAAe,CACnC,CAAC,SAAS,eAAe,GAAG,eAAe,CAC3C,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IAC9B;;OAEG;gBACS,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc;IAIzD,MAAM,EAAG,YAAY,CAAC,CAAC,CAAC,CAAC;CACjC"}

package/dist/scene/scene-with-hudini.js

@@ -1,7 +1,30 @@
 import { SceneWithPhaserWind } from 'phaser-wind';
+/**
+ * @deprecated Use {@link withHudini} instead.
+ *
+ * Forces single inheritance, which conflicts with any user-defined `BaseScene`
+ * or other libraries that ship their own scene base class. It also relies on a
+ * non-null assertion (`hudini!`) that lies to TypeScript about when the plugin
+ * is available — touching `this.hudini` before the plugin mounts throws at
+ * runtime.
+ *
+ * Prefer the `withHudini(scene)` accessor:
+ *
+ * ```ts
+ * import { withHudini } from 'hudini';
+ * import type { ThemeType } from './theme';
+ *
+ * class MyScene extends Phaser.Scene {
+ *   create() {
+ *     const hudini = withHudini<ThemeType>(this);
+ *   }
+ * }
+ * ```
+ *
+ * Kept exported to avoid breaking existing consumers.
+ */
 export class SceneWithHudini extends SceneWithPhaserWind {
     /**
-     *
      * @param config The scene key or scene specific configuration settings.
      */
     constructor(config) {

package/dist/scene/scene-with-hudini.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene-with-hudini.js","sourceRoot":"","sources":["../../src/scene/scene-with-hudini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAInE,MAAM,OAAgB,eAEpB,SAAQ,mBAAsB;IAC9B;;;OAGG;IACH,YAAY,MAAoD;QAC9D,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAEM,MAAM,CAAmB;CACjC"}
+{"version":3,"file":"scene-with-hudini.js","sourceRoot":"","sources":["../../src/scene/scene-with-hudini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAInE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAgB,eAEpB,SAAQ,mBAAsB;IAC9B;;OAEG;IACH,YAAY,MAAoD;QAC9D,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAEM,MAAM,CAAmB;CACjC"}

package/dist/scene/with-hudini.d.ts

@@ -0,0 +1,35 @@
+import type { Scene } from 'phaser';
+import type { BaseThemeConfig } from 'phaser-wind';
+import { HudiniPlugin } from '../plugin/plugin';
+/**
+ * Accessor for the Hudini plugin from within a Phaser scene.
+ *
+ * Preferred over {@link SceneWithHudini} (inheritance) and over module
+ * augmentation of `Phaser.Scene`, because it:
+ * - Composes with any existing base scene (no forced inheritance).
+ * - Keeps the theme type explicit at the call site (no silent `any`).
+ * - Doesn't rely on non-null assertions that lie about lifecycle.
+ *
+ * Call it inside `create()` / `update()` (after the plugin has been installed).
+ *
+ * @typeParam T - The theme config type. Pass your `ThemeType` to get
+ *   type-narrowed access to your custom tokens (through `hudini.pw`).
+ * @param scene - The Phaser scene instance.
+ * @returns The Hudini plugin instance bound to the given theme type.
+ *
+ * @example
+ * ```ts
+ * import { withHudini } from 'hudini';
+ * import type { ThemeType } from './theme';
+ *
+ * class MyScene extends Phaser.Scene {
+ *   create() {
+ *     const hudini = withHudini<ThemeType>(this);
+ *     const pw = hudini.pw;
+ *     this.cameras.main.setBackgroundColor(pw.color.rgb('background'));
+ *   }
+ * }
+ * ```
+ */
+export declare const withHudini: <T extends BaseThemeConfig = BaseThemeConfig>(scene: Scene) => HudiniPlugin<T>;
+//# sourceMappingURL=with-hudini.d.ts.map

package/dist/scene/with-hudini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-hudini.d.ts","sourceRoot":"","sources":["../../src/scene/with-hudini.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAc,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,eAAe,GAAG,eAAe,EACpE,OAAO,KAAK,KACX,YAAY,CAAC,CAAC,CAC4C,CAAC"}

package/dist/scene/with-hudini.js

@@ -0,0 +1,33 @@
+import { HUDINI_KEY } from '../plugin/plugin';
+/**
+ * Accessor for the Hudini plugin from within a Phaser scene.
+ *
+ * Preferred over {@link SceneWithHudini} (inheritance) and over module
+ * augmentation of `Phaser.Scene`, because it:
+ * - Composes with any existing base scene (no forced inheritance).
+ * - Keeps the theme type explicit at the call site (no silent `any`).
+ * - Doesn't rely on non-null assertions that lie about lifecycle.
+ *
+ * Call it inside `create()` / `update()` (after the plugin has been installed).
+ *
+ * @typeParam T - The theme config type. Pass your `ThemeType` to get
+ *   type-narrowed access to your custom tokens (through `hudini.pw`).
+ * @param scene - The Phaser scene instance.
+ * @returns The Hudini plugin instance bound to the given theme type.
+ *
+ * @example
+ * ```ts
+ * import { withHudini } from 'hudini';
+ * import type { ThemeType } from './theme';
+ *
+ * class MyScene extends Phaser.Scene {
+ *   create() {
+ *     const hudini = withHudini<ThemeType>(this);
+ *     const pw = hudini.pw;
+ *     this.cameras.main.setBackgroundColor(pw.color.rgb('background'));
+ *   }
+ * }
+ * ```
+ */
+export const withHudini = (scene) => scene.plugins.get(HUDINI_KEY);
+//# sourceMappingURL=with-hudini.js.map

package/dist/scene/with-hudini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-hudini.js","sourceRoot":"","sources":["../../src/scene/with-hudini.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,KAAY,EACK,EAAE,CACnB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAA+B,CAAC"}

package/dist/utils/button-style.d.ts

@@ -0,0 +1,16 @@
+/** Thickness of the outline stroke around a button's text or icon glyph. */
+export declare const BUTTON_STROKE_THICKNESS = 3;
+/**
+ * Compute the outline (stroke) color for the text or icon of a button, given
+ * the button's own color input.
+ *
+ * - Palette-based color (family like `'blue'` or a full token like
+ *   `'blue-500'`): a darker shade in the same palette family via
+ *   {@link Color.shift}.
+ * - Arbitrary CSS color (`'#3B82F6'`, `'rgb(...)'`): soft translucent black.
+ *
+ * Shared between {@link TextButton} and {@link IconButton} so both render
+ * with the same outline style.
+ */
+export declare const getButtonStrokeColor: (colorInput: string) => string;
+//# sourceMappingURL=button-style.d.ts.map

package/dist/utils/button-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-style.d.ts","sourceRoot":"","sources":["../../src/utils/button-style.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAkBzC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAAI,YAAY,MAAM,KAAG,MAMzD,CAAC"}

package/dist/utils/button-style.js

@@ -0,0 +1,35 @@
+import { Color, isColorKey, Opacity } from 'phaser-wind';
+/** Thickness of the outline stroke around a button's text or icon glyph. */
+export const BUTTON_STROKE_THICKNESS = 3;
+/**
+ * Amount added to the palette shade to derive the button's stroke color.
+ * `blue-500` + 400 → `blue-900` — a darker outline that still lives in the
+ * same palette family, so it never clashes with the fill.
+ */
+const STROKE_DARKER_SHIFT = 400;
+/**
+ * Opacity token used for the fallback stroke when the button color isn't a
+ * palette reference. Solid black chapado is too harsh against many fills;
+ * ~60% translucent black keeps the outline readable while blending in.
+ */
+const FALLBACK_STROKE_OPACITY_KEY = '60';
+const blackWithAlpha = (alpha) => `rgba(0, 0, 0, ${alpha})`;
+/**
+ * Compute the outline (stroke) color for the text or icon of a button, given
+ * the button's own color input.
+ *
+ * - Palette-based color (family like `'blue'` or a full token like
+ *   `'blue-500'`): a darker shade in the same palette family via
+ *   {@link Color.shift}.
+ * - Arbitrary CSS color (`'#3B82F6'`, `'rgb(...)'`): soft translucent black.
+ *
+ * Shared between {@link TextButton} and {@link IconButton} so both render
+ * with the same outline style.
+ */
+export const getButtonStrokeColor = (colorInput) => {
+    const isPaletteColor = isColorKey(colorInput) || Color.isValidColorToken(colorInput);
+    return isPaletteColor
+        ? Color.rgb(Color.shift(colorInput, STROKE_DARKER_SHIFT))
+        : blackWithAlpha(Opacity.value(FALLBACK_STROKE_OPACITY_KEY));
+};
+//# sourceMappingURL=button-style.js.map

package/dist/utils/button-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-style.js","sourceRoot":"","sources":["../../src/utils/button-style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAExE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,IAAa,CAAC;AAElD,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,iBAAiB,KAAK,GAAG,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAkB,EAAU,EAAE;IACjE,MAAM,cAAc,GAClB,UAAU,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChE,OAAO,cAAc;QACnB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,UAAsB,EAAE,mBAAmB,CAAC,CAAC;QACrE,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;AACjE,CAAC,CAAC"}

package/dist/utils/index.d.ts

@@ -1,4 +1,6 @@
+export * from './button-style';
 export * from './color-variants';
 export * from './get-hudini';
 export * from './get-pw-from-scene';
+export * from './number-to-rgb';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -1,4 +1,6 @@
+export * from './button-style';
 export * from './color-variants';
 export * from './get-hudini';
 export * from './get-pw-from-scene';
+export * from './number-to-rgb';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/utils/number-to-rgb.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Convert a `0xRRGGBB` color number into a CSS `rgb(r, g, b)` string.
+ *
+ * Handy when a numeric Phaser color (e.g. produced by `pw.color.hex(...)` or
+ * `getColorVariant(...)`) needs to feed a `Phaser.GameObjects.Text` style
+ * field like `color`, `stroke` or `shadow.color`, which expect strings.
+ *
+ * @param color - Color as a 24-bit integer (`0xRRGGBB`).
+ * @returns CSS `rgb(r, g, b)` string.
+ *
+ * @example
+ * const dark = getColorVariant('blue-500', 400, 0); // number
+ * text.setStroke(numberToRgb(dark), 3);
+ */
+export declare const numberToRgb: (color: number) => string;
+//# sourceMappingURL=number-to-rgb.d.ts.map

package/dist/utils/number-to-rgb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-to-rgb.d.ts","sourceRoot":"","sources":["../../src/utils/number-to-rgb.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAG3C,CAAC"}

package/dist/utils/number-to-rgb.js

@@ -0,0 +1,20 @@
+import Phaser from 'phaser';
+/**
+ * Convert a `0xRRGGBB` color number into a CSS `rgb(r, g, b)` string.
+ *
+ * Handy when a numeric Phaser color (e.g. produced by `pw.color.hex(...)` or
+ * `getColorVariant(...)`) needs to feed a `Phaser.GameObjects.Text` style
+ * field like `color`, `stroke` or `shadow.color`, which expect strings.
+ *
+ * @param color - Color as a 24-bit integer (`0xRRGGBB`).
+ * @returns CSS `rgb(r, g, b)` string.
+ *
+ * @example
+ * const dark = getColorVariant('blue-500', 400, 0); // number
+ * text.setStroke(numberToRgb(dark), 3);
+ */
+export const numberToRgb = (color) => {
+    const c = Phaser.Display.Color.ValueToColor(color);
+    return `rgb(${c.red}, ${c.green}, ${c.blue})`;
+};
+//# sourceMappingURL=number-to-rgb.js.map

package/dist/utils/number-to-rgb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-to-rgb.js","sourceRoot":"","sources":["../../src/utils/number-to-rgb.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE;IACnD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnD,OAAO,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC;AAChD,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hudini",
-  "version": "0.18.1",
+  "version": "0.20.0",
   "description": "🎩 Magical Phaser UI components - Reusable HUD elements for game development. Is magic, like a wizard",
   "type": "module",
   "main": "./dist/index.js",
@@ -62,7 +62,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "phaser-wind": "0.9.1",
+    "phaser-wind": "0.11.0",
     "font-awesome-for-phaser": "0.10.0"
   },
   "peerDependencies": {

package/dist/components/flat-icon-button/flat-icon-button.d.ts

@@ -1,60 +0,0 @@
-import { IconText, type IconKey, type IconStyle } from 'font-awesome-for-phaser';
-import { GameObjects, Scene } from 'phaser';
-import { type ColorKey, type FontSizeKey } from 'phaser-wind';
-export type FlatIconButtonParams = {
-    scene: Scene;
-    x: number;
-    y: number;
-    icon: IconKey;
-    iconStyle?: IconStyle;
-    size?: FontSizeKey | number;
-    backgroundColor?: ColorKey | string;
-    iconColor?: ColorKey | string;
-    onClick?: () => void;
-    borderRadius?: string | number;
-    backgroundOpacity?: number;
-    iconOpacity?: number;
-};
-export declare class FlatIconButton extends GameObjects.Container {
-    backgroundSprite: GameObjects.Sprite;
-    whiteBorderSprite: GameObjects.Sprite;
-    iconText: IconText;
-    private pw;
-    private baseSizePx;
-    private borderRadiusPx;
-    private backgroundColorValue;
-    private iconColorValue;
-    private backgroundOpacityValue;
-    private iconOpacityValue;
-    constructor({ scene, x, y, icon, iconStyle, size, backgroundColor, iconColor, onClick, borderRadius, backgroundOpacity, iconOpacity, }: FlatIconButtonParams);
-    setBackgroundColor(color: ColorKey | string): this;
-    setIconColor(color: ColorKey | string): this;
-    setBackgroundOpacity(opacity: number): this;
-    setIconOpacity(opacity: number): this;
-    setBorderRadius(borderRadius: string | number): this;
-    setIcon(icon: IconKey, opts?: {
-        iconStyle?: IconStyle;
-    }): this;
-    setButtonSize(size: FontSizeKey | number): this;
-    private updateSize;
-    private createWhiteBorderSprite;
-    private createBackgroundSprite;
-    private regenerateBackgroundTexture;
-    private createWhiteBorderTexture;
-    private createBackgroundTexture;
-    private createIconText;
-    private setupContainer;
-    private setupInteractivity;
-    /**
-     * Gets the interactive sprite of the icon button
-     * @returns The interactive sprite
-     */
-    get interactive(): Pick<GameObjects.Sprite, 'on' | 'off' | 'setInteractive' | 'setInteractive' | 'once'>;
-    /**
-     * Gets the bounds of the flat icon button for layout calculations
-     * @param output Optional rectangle to store the result
-     * @returns Rectangle with the button bounds
-     */
-    getBounds(output?: Phaser.Geom.Rectangle): Phaser.Geom.Rectangle;
-}
-//# sourceMappingURL=flat-icon-button.d.ts.map

package/dist/components/flat-icon-button/flat-icon-button.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flat-icon-button.d.ts","sourceRoot":"","sources":["../../../src/components/flat-icon-button/flat-icon-button.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAIrB,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AA4BF,qBAAa,cAAe,SAAQ,WAAW,CAAC,SAAS;IAChD,gBAAgB,EAAG,WAAW,CAAC,MAAM,CAAC;IACtC,iBAAiB,EAAG,WAAW,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAG,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAuB;IAEjC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,oBAAoB,CAAU;IACtC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,sBAAsB,CAAK;IACnC,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,EACV,KAAK,EACL,CAAC,EACD,CAAC,EACD,IAAI,EACJ,SAAmB,EACnB,IAAI,EACJ,eAA4B,EAC5B,SAAmB,EACnB,OAAO,EACP,YAAmB,EACnB,iBAAqB,EACrB,WAAe,GAChB,EAAE,oBAAoB;IA6BhB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IAMlD,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IAQ5C,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOrC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkBpD,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAK9D,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAiBtD,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,2BAA2B;IAQnC,OAAO,CAAC,wBAAwB;IA8BhC,OAAO,CAAC,uBAAuB;IAsC/B,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,kBAAkB;IA+C1B;;;OAGG;IACH,IAAW,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,GAAG,KAAK,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,MAAM,CAAC,CAQ9G;IAED;;;;OAIG;IACa,SAAS,CACvB,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,GAC7B,MAAM,CAAC,IAAI,CAAC,SAAS;CAoBzB"}