pollyroll 0.1.0

package/dist/render.d.cts

@@ -0,0 +1,75 @@
+import { a as RollEvent, b as RollSummary, i as SkinRef, e as MaterialPreset, M as MaterialParams, S as Skin } from './types-CnzvkHmJ.cjs';
+export { L as LabelStyle, P as PatternName } from './types-CnzvkHmJ.cjs';
+
+type LabelSet = 'd4' | 'd6' | 'd8' | 'd10' | 'd12' | 'd20' | 'd100tens' | 'd100ones' | 'dF';
+
+interface TrayOptions {
+    skin?: SkinRef;
+    labelFont?: string;
+    dieScale?: number;
+    shadows?: boolean;
+    maxDpr?: number;
+    reducedMotion?: 'auto' | 'always' | 'never';
+    fadeAfterMs?: number | null;
+    /**
+     * Custom labels per label set; labels[set][i] replaces the i-th label of the set's natural
+     * sequence: d4 '1'..'4', d6 '1'..'6', d8 '1'..'8', d12 '1'..'12', d20 '1'..'20' (i = value − 1);
+     * d10 and d100ones '0'..'9' and d100tens '00'..'90' (i = digit); dF 0 = the −1 faces, 1 = the
+     * blank faces, 2 = the +1 faces. Missing entries use the default text.
+     */
+    labels?: Partial<Record<LabelSet, readonly string[]>>;
+}
+interface DiceTray {
+    /** Pre-simulates, remaps, animates, and resolves with the summary once every die has settled. */
+    playRoll(event: RollEvent): Promise<RollSummary>;
+    setSkin(skin: SkinRef): void;
+    /** Sets the die size for subsequent rolls; the dice already on screen keep their size. */
+    setDieScale(scale: number): void;
+    clear(): void;
+    resize(): void;
+    dispose(): void;
+    readonly supported: boolean;
+}
+type PresetParams = Readonly<Required<MaterialParams>>;
+/** The full `MaterialParams` each named material renders with. */
+declare const materialPresets: Readonly<Record<MaterialPreset, PresetParams>>;
+/**
+ * Creates a WebGL2 dice tray on a canvas, or on an absolutely positioned overlay canvas appended to
+ * an element. Without WebGL2 `supported` is false and `playRoll` resolves immediately.
+ */
+declare function createDiceTray(target: HTMLCanvasElement | HTMLElement, opts?: TrayOptions): DiceTray;
+
+/** A shader failed to compile or a program failed to link; `log` holds the driver's info log. */
+declare class PollyrollShaderError extends Error {
+    readonly log: string;
+    constructor(message: string, log: string);
+}
+
+/** White plastic with black printed labels; the default skin. */
+declare const classic: Skin;
+/** Black marbled stone with engraved gold labels. */
+declare const obsidian: Skin;
+/** Graded brass with engraved dark labels. */
+declare const brass: Skin;
+/** Ringed oak with engraved cream labels. */
+declare const oak: Skin;
+/** Blue glass with white printed labels. */
+declare const sapphire: Skin;
+/** Swirled red gem with printed pale-gold labels. */
+declare const ruby: Skin;
+/** Deep green glass with printed pale-gold labels. */
+declare const emerald: Skin;
+/** Swirled purple gem with printed pale labels. */
+declare const amethyst: Skin;
+/** Amber gem with printed dark-brown labels. */
+declare const topaz: Skin;
+/** Clear sea-blue glass with printed dark-blue labels. */
+declare const aquamarine: Skin;
+/** Lightly tinted smoky-quartz glass with printed white labels. */
+declare const smoke: Skin;
+/** A new skin: the resolved base with `overrides` applied on top. The base is not modified. */
+declare function defineSkin(base: SkinRef, overrides: Partial<Skin>): Skin;
+/** Adds or replaces the named preset `name`. Throws TypeError for an empty name. */
+declare function registerSkin(name: string, skin: Skin): void;
+
+export { type DiceTray, type LabelSet, MaterialParams, MaterialPreset, PollyrollShaderError, Skin, SkinRef, type TrayOptions, amethyst, aquamarine, brass, classic, createDiceTray, defineSkin, emerald, materialPresets, oak, obsidian, registerSkin, ruby, sapphire, smoke, topaz };

package/dist/render.d.ts

@@ -0,0 +1,75 @@
+import { a as RollEvent, b as RollSummary, i as SkinRef, e as MaterialPreset, M as MaterialParams, S as Skin } from './types-CnzvkHmJ.js';
+export { L as LabelStyle, P as PatternName } from './types-CnzvkHmJ.js';
+
+type LabelSet = 'd4' | 'd6' | 'd8' | 'd10' | 'd12' | 'd20' | 'd100tens' | 'd100ones' | 'dF';
+
+interface TrayOptions {
+    skin?: SkinRef;
+    labelFont?: string;
+    dieScale?: number;
+    shadows?: boolean;
+    maxDpr?: number;
+    reducedMotion?: 'auto' | 'always' | 'never';
+    fadeAfterMs?: number | null;
+    /**
+     * Custom labels per label set; labels[set][i] replaces the i-th label of the set's natural
+     * sequence: d4 '1'..'4', d6 '1'..'6', d8 '1'..'8', d12 '1'..'12', d20 '1'..'20' (i = value − 1);
+     * d10 and d100ones '0'..'9' and d100tens '00'..'90' (i = digit); dF 0 = the −1 faces, 1 = the
+     * blank faces, 2 = the +1 faces. Missing entries use the default text.
+     */
+    labels?: Partial<Record<LabelSet, readonly string[]>>;
+}
+interface DiceTray {
+    /** Pre-simulates, remaps, animates, and resolves with the summary once every die has settled. */
+    playRoll(event: RollEvent): Promise<RollSummary>;
+    setSkin(skin: SkinRef): void;
+    /** Sets the die size for subsequent rolls; the dice already on screen keep their size. */
+    setDieScale(scale: number): void;
+    clear(): void;
+    resize(): void;
+    dispose(): void;
+    readonly supported: boolean;
+}
+type PresetParams = Readonly<Required<MaterialParams>>;
+/** The full `MaterialParams` each named material renders with. */
+declare const materialPresets: Readonly<Record<MaterialPreset, PresetParams>>;
+/**
+ * Creates a WebGL2 dice tray on a canvas, or on an absolutely positioned overlay canvas appended to
+ * an element. Without WebGL2 `supported` is false and `playRoll` resolves immediately.
+ */
+declare function createDiceTray(target: HTMLCanvasElement | HTMLElement, opts?: TrayOptions): DiceTray;
+
+/** A shader failed to compile or a program failed to link; `log` holds the driver's info log. */
+declare class PollyrollShaderError extends Error {
+    readonly log: string;
+    constructor(message: string, log: string);
+}
+
+/** White plastic with black printed labels; the default skin. */
+declare const classic: Skin;
+/** Black marbled stone with engraved gold labels. */
+declare const obsidian: Skin;
+/** Graded brass with engraved dark labels. */
+declare const brass: Skin;
+/** Ringed oak with engraved cream labels. */
+declare const oak: Skin;
+/** Blue glass with white printed labels. */
+declare const sapphire: Skin;
+/** Swirled red gem with printed pale-gold labels. */
+declare const ruby: Skin;
+/** Deep green glass with printed pale-gold labels. */
+declare const emerald: Skin;
+/** Swirled purple gem with printed pale labels. */
+declare const amethyst: Skin;
+/** Amber gem with printed dark-brown labels. */
+declare const topaz: Skin;
+/** Clear sea-blue glass with printed dark-blue labels. */
+declare const aquamarine: Skin;
+/** Lightly tinted smoky-quartz glass with printed white labels. */
+declare const smoke: Skin;
+/** A new skin: the resolved base with `overrides` applied on top. The base is not modified. */
+declare function defineSkin(base: SkinRef, overrides: Partial<Skin>): Skin;
+/** Adds or replaces the named preset `name`. Throws TypeError for an empty name. */
+declare function registerSkin(name: string, skin: Skin): void;
+
+export { type DiceTray, type LabelSet, MaterialParams, MaterialPreset, PollyrollShaderError, Skin, SkinRef, type TrayOptions, amethyst, aquamarine, brass, classic, createDiceTray, defineSkin, emerald, materialPresets, oak, obsidian, registerSkin, ruby, sapphire, smoke, topaz };