1681-engine 0.0.0-stage → 0.5.8

package/dist/types/postfx/fxShader.d.ts

@@ -0,0 +1,49 @@
+import { Filter } from 'pixi.js';
+/** The uniform types an effect may declare. */
+export type FxUniformType = 'f32' | 'vec2<f32>' | 'vec3<f32>' | 'vec4<f32>';
+export interface FxUniform {
+    type: FxUniformType;
+    value: number | Float32Array;
+}
+export type FxUniforms = Record<string, FxUniform>;
+/**
+ * One effect's shader: its uniforms, and the body of its fragment function in GLSL (WebGL 2) and WGSL (WebGPU).
+ *
+ * Both bodies are given the same helpers, so they read alike:
+ * - `frameUv` (vec2): 0–1 across the filtered area, whatever the size of the texture Pixi hands over;
+ * - `framePx` (vec2): the filtered area's size in pixels; `texel` (vec2): one input pixel in texture coordinates;
+ * - `sampleAt(coord)`: the input at a texture coordinate, clamped inside the area; `toCoord(uv)`: frame uv back to one;
+ * - `coord`: this fragment's texture coordinate; `src`: the input there (premultiplied alpha);
+ * - `uMap` / `sampleMap(coord)` when the effect has a second texture (`map: true`).
+ * GLSL reads its uniforms by name; WGSL through `fx.<name>`. Each body ends by writing `result`.
+ */
+export interface FxShaderSpec {
+    name: string;
+    uniforms: FxUniforms;
+    glsl: string;
+    wgsl: string;
+    /** A second texture the effect samples (bloom's blurred light). */
+    map?: boolean;
+}
+/** The GLSL fragment shader of an effect. */
+export declare function glslSource(spec: FxShaderSpec): string;
+/** The WGSL module of an effect (vertex and fragment). */
+export declare function wgslSource(spec: FxShaderSpec): string;
+/**
+ * A full-screen effect built from an `FxShaderSpec`: a Pixi `Filter` whose uniforms are read and written by name
+ * (`fx.set('strength', 0.5)`, or the subclasses' own properties). Works on both renderers.
+ */
+export declare class FxFilter extends Filter {
+    readonly fxName: string;
+    private readonly group;
+    constructor(spec: FxShaderSpec);
+    /** A uniform's value (a number, or the live array of a vector). */
+    get(name: string): number | Float32Array;
+    /** Sets a number uniform, or the components of a vector one. */
+    set(name: string, ...values: number[]): this;
+    /** A number uniform, for the subclasses' getters. */
+    protected num(name: string): number;
+}
+/** A 0xRRGGBB colour as three 0–1 channels. */
+export declare function rgb(color: number): [number, number, number];
+//# sourceMappingURL=fxShader.d.ts.map

package/dist/types/postfx/fxShader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fxShader.d.ts","sourceRoot":"","sources":["../../../src/postfx/fxShader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgD,MAAM,SAAS,CAAC;AAE/E,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAE5E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;CAC9B;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAkBD,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA0BrD;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA8CrD;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,MAAM;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,IAAI,EAAE,YAAY;IAiB9B,mEAAmE;IACnE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY;IAIxC,gEAAgE;IAChE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAU5C,qDAAqD;IACrD,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGpC;AAED,+CAA+C;AAC/C,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAE3D"}

package/dist/types/postfx/index.d.ts

@@ -0,0 +1,11 @@
+export { PostFx, type PostFxOptions, type FlashOptions, type ShockwaveRun } from './PostFx.js';
+export { FxFilter, rgb, glslSource, wgslSource, type FxShaderSpec, type FxUniform, type FxUniforms, type FxUniformType } from './fxShader.js';
+export { FxAnimator, type FxAnimation } from './fxAnimator.js';
+export { VignetteFilter, type VignetteOptions } from './VignetteFilter.js';
+export { ChromaticAberrationFilter } from './ChromaticAberrationFilter.js';
+export { PixelateFilter } from './PixelateFilter.js';
+export { CrtFilter, type CrtOptions } from './CrtFilter.js';
+export { ColorAdjustFilter, type ColorAdjustOptions } from './ColorAdjustFilter.js';
+export { ShockwaveFilter, type ShockwaveOptions } from './ShockwaveFilter.js';
+export { BloomFilter, type BloomOptions } from './BloomFilter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/postfx/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postfx/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3I,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/react/ChoiceDialog.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The open `askChoice`, if any: mounted once at the UI's root. A row per option, the first that can be taken picked;
+ * Enter takes the picked one, Esc or a press outside cancels.
+ */
+export declare function ChoiceDialog({ width }: {
+    width?: number;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=ChoiceDialog.d.ts.map

package/dist/types/react/ChoiceDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChoiceDialog.d.ts","sourceRoot":"","sources":["../../../src/react/ChoiceDialog.tsx"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,KAAW,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,sCAgD/D"}

package/dist/types/react/ConfirmDialog.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The open `askConfirm` / `askQuantity` question, if any: mounted once at the UI's root. Enter confirms, Esc or a
+ * press outside cancels. A quantity is asked with a slider, − and + and a field for an exact number (a slider over 99
+ * cannot land on 37 with a thumb).
+ */
+export declare function ConfirmDialog({ width }: {
+    width?: number;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=ConfirmDialog.d.ts.map

package/dist/types/react/ConfirmDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmDialog.d.ts","sourceRoot":"","sources":["../../../src/react/ConfirmDialog.tsx"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAAW,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,sCAmDhE"}

package/dist/types/react/Glyph.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Small marks (close, check, arrows, a star…) as pixel art on a square grid, drawn in the text's colour. A pixel font
+ * usually carries letters and punctuation only, so a ✕, ✓, ▾ or → typed into the UI falls through to a system font
+ * and reads as a smooth vector glyph in the middle of pixel text. `scale` is screen pixels per glyph pixel: a whole
+ * number, so the mark keeps its pixels square.
+ *
+ * Rows are strings, one character a pixel: `.` is empty, `X` the text's colour; any other letter takes its colour
+ * from the glyph's `tones` (a coloured glyph, lit like the world's art).
+ */
+export interface GlyphArt {
+    rows: readonly string[];
+    tones?: Readonly<Record<string, string>>;
+}
+declare const BUILT_IN: {
+    readonly close: readonly ["X.....X", ".X...X.", "..X.X..", "...X...", "..X.X..", ".X...X.", "X.....X"];
+    readonly check: readonly [".......", "......X", ".....XX", "X...XX.", "XX.XX..", ".XXX...", "..X...."];
+    readonly down: readonly [".......", ".......", "XXXXXXX", ".XXXXX.", "..XXX..", "...X...", "......."];
+    readonly up: readonly [".......", "...X...", "..XXX..", ".XXXXX.", "XXXXXXX", ".......", "......."];
+    readonly right: readonly ["..X....", "..XX...", "..XXX..", "..XXXX.", "..XXX..", "..XX...", "..X...."];
+    readonly left: readonly ["....X..", "...XX..", "..XXX..", ".XXXX..", "..XXX..", "...XX..", "....X.."];
+    readonly arrow: readonly [".......", "....X..", ".....X.", "XXXXXXX", ".....X.", "....X..", "......."];
+    readonly back: readonly ["..X....", ".XX....", "XXXXXX.", ".XX...X", "..X...X", "......X", "..XXXX."];
+    readonly star: readonly ["...X...", "...X...", "XXXXXXX", ".XXXXX.", "..XXX..", ".XX.XX.", "X.....X"];
+    readonly diamond: readonly ["...X...", "..XXX..", ".XXXXX.", "XXXXXXX", ".XXXXX.", "..XXX..", "...X..."];
+    readonly diamondOpen: readonly ["...X...", "..X.X..", ".X...X.", "X.....X", ".X...X.", "..X.X..", "...X..."];
+    readonly menu: readonly [".......", "XXXXXXX", ".......", "XXXXXXX", ".......", "XXXXXXX", "......."];
+    readonly plus: readonly [".......", "...X...", "...X...", ".XXXXX.", "...X...", "...X...", "......."];
+    readonly minus: readonly [".......", ".......", ".......", ".XXXXX.", ".......", ".......", "......."];
+    readonly warn: readonly ["...X...", "..XXX..", "..X.X..", ".XX.XX.", ".X...X.", "XX.X.XX", "XXXXXXX"];
+    readonly spark: readonly ["...X...", "...X...", "..XXX..", "XXXXXXX", "..XXX..", "...X...", "...X..."];
+    readonly lock: readonly ["..XXX..", ".X...X.", ".X...X.", "XXXXXXX", "XXX.XXX", "XXX.XXX", "XXXXXXX"];
+    readonly pin: readonly [".XXXXX.", "..XXX..", "..XXX..", ".XXXXX.", "XXXXXXX", "...X...", "...X..."];
+    readonly mail: readonly [".......", "XXXXXXX", "XX...XX", "X.X.X.X", "X..X..X", "X.....X", "XXXXXXX"];
+};
+/** The marks the engine draws itself; a game adds its own with `registerGlyph`. */
+export type BuiltInGlyph = keyof typeof BUILT_IN;
+export type GlyphId = BuiltInGlyph | (string & {});
+/** The cells of one letter as one SVG path of 1x1 squares. */
+export declare function glyphPath(rows: readonly string[], letter: string): string;
+/** Adds a mark (or replaces one, a built-in included): a coin in the game's own colours, a class crest. */
+export declare function registerGlyph(id: string, art: GlyphArt | readonly string[]): void;
+/** Whether `id` has art (built in or registered). */
+export declare function hasGlyph(id: string): boolean;
+export interface GlyphProps {
+    id: GlyphId;
+    /** Screen pixels per glyph pixel (default 2). */
+    scale?: number;
+    className?: string;
+    /** Spoken name; without it the mark is hidden from screen readers (it sits beside words that say it). */
+    label?: string;
+}
+export declare const Glyph: import("react").NamedExoticComponent<GlyphProps>;
+export {};
+//# sourceMappingURL=Glyph.d.ts.map

package/dist/types/react/Glyph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Glyph.d.ts","sourceRoot":"","sources":["../../../src/react/Glyph.tsx"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1C;AAED,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;CAoBJ,CAAC;AAEX,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,QAAQ,CAAC;AACjD,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAKnD,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,2GAA2G;AAC3G,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,CAOjF;AAID,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yGAAyG;IACzG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,KAAK,kDAqBhB,CAAC"}

package/dist/types/react/Modal.d.ts

@@ -0,0 +1,22 @@
+import { type ReactNode } from 'react';
+export interface ModalProps {
+    /** Esc, or a press on the backdrop. */
+    onCancel: () => void;
+    /** Enter (a text field's own Enter included). */
+    onConfirm?: () => void;
+    /** The box's preferred width, px. */
+    width?: number;
+    role?: 'dialog' | 'alertdialog';
+    label?: string;
+    className?: string;
+    children: ReactNode;
+    /** Under the scrolling body, never scrolled away: the dialog's buttons. */
+    actions?: ReactNode;
+}
+/**
+ * A dialog box over a backdrop, fitted into the viewport like a window (`fitToViewport`, centred in whole pixels) and
+ * portalled to the `UiProvider`'s `portal`. Esc and Enter are caught on the window in the capture phase, so they do
+ * not also close the window underneath or reach the game's keys.
+ */
+export declare function Modal({ onCancel, onConfirm, width, role, label, className, children, actions }: ModalProps): import("react").JSX.Element;
+//# sourceMappingURL=Modal.d.ts.map

package/dist/types/react/Modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/react/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAC;AAK1D,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,IAAe,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,+BAoCrH"}

package/dist/types/react/Panel.d.ts

@@ -0,0 +1,29 @@
+import { type CSSProperties, type ReactNode } from 'react';
+import type { Point } from '../ui/layout/geometry.js';
+export interface PanelProps {
+    title: ReactNode;
+    /** The close button's action; no close button without it. */
+    onClose?: () => void;
+    children?: ReactNode;
+    /** The width it wants, in px (its own units); default: as wide as its content. */
+    width?: number;
+    /** Where it wants to stand, screen px; default: centred. It is moved back inside the screen either way. */
+    at?: Point;
+    /** Under the scrolling body, never scrolled away (a row of buttons). */
+    footer?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+    /** The title as plain text, for the close button's spoken name when `title` is not a string. */
+    titleText?: string;
+}
+/**
+ * A window that never overflows the screen: fitted by `fitToViewport` (moved inside the edges, cut to what is left,
+ * shrunk to `minScale` when the `UiProvider` allows it) with its header kept and its body scrolling under it. Placed
+ * in whole pixels by `left`/`top`, never centred with `translate(-50%)`, which stood an odd-width window half a pixel
+ * off the grid and smeared every icon in it.
+ *
+ * On a touch screen it is a full-screen sheet instead (`.e1681-sheet`): no width of its own, the header put and the
+ * body scrolling, laid out at the provider's `sheetScale`. A press inside never reaches the world under it.
+ */
+export declare function Panel({ title, onClose, children, width, at, footer, className, style, titleText }: PanelProps): import("react").JSX.Element;
+//# sourceMappingURL=Panel.d.ts.map

package/dist/types/react/Panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Panel.d.ts","sourceRoot":"","sources":["../../../src/react/Panel.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAU,MAAM,OAAO,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAOnD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2GAA2G;IAC3G,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,wEAAwE;IACxE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,+BAyB7G"}

package/dist/types/react/PixelImage.d.ts

@@ -0,0 +1,19 @@
+export interface PixelImageProps {
+    src: string;
+    /** The box, CSS px. */
+    width: number;
+    height: number;
+    /** Image pixels the URL already spends on one art pixel (a sheet painted at 4x). */
+    upscaled?: number;
+    /** Caps the multiple, so a row of sprites of different sizes keeps their sizes against each other. */
+    maxScale?: number;
+    alt?: string;
+    className?: string;
+}
+/**
+ * A sprite whose size is not known ahead (a creature, a portrait), shown at the largest **whole** multiple of its
+ * art that fits the box, centred (`pixelFit`); a sprite bigger than the box is shrunk by a whole divisor. Hidden until
+ * it has loaded and been measured, so it never flashes at the wrong size.
+ */
+export declare function PixelImage({ src, width, height, upscaled, maxScale, alt, className }: PixelImageProps): import("react").JSX.Element;
+//# sourceMappingURL=PixelImage.d.ts.map

package/dist/types/react/PixelImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixelImage.d.ts","sourceRoot":"","sources":["../../../src/react/PixelImage.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAY,EAAE,QAAQ,EAAE,GAAQ,EAAE,SAAS,EAAE,EAAE,eAAe,+BAkB9G"}

package/dist/types/react/Select.d.ts

@@ -0,0 +1,27 @@
+import { type ReactNode } from 'react';
+export interface SelectOption<T extends string | number> {
+    value: T;
+    label: ReactNode;
+}
+export interface SelectProps<T extends string | number> {
+    value: T;
+    options: readonly SelectOption<T>[];
+    onChange: (value: T) => void;
+    /** What it chooses, for a screen reader. */
+    label?: string;
+    /** Fills its row, cutting the label with an ellipsis instead of growing. */
+    grow?: boolean;
+    className?: string;
+    disabled?: boolean;
+}
+/** The next option along the list, wrapping round. */
+export declare function stepOption(index: number, step: number, count: number): number;
+/**
+ * A drop-down drawn by the theme instead of the browser's `<select>`, whose list is the OS's own widget and whose box
+ * clips its text at a fixed width. The button is as wide as its longest label (every label stacked in one cell, the
+ * picked one shown). The list opens in a portal, so no window's `overflow` cuts it: as wide as its longest label
+ * (`listWidth`), under the button or over it when the screen ends below (`listPlacement`). A press never takes the
+ * focus, so a text field beside it keeps its keyboard.
+ */
+export declare function Select<T extends string | number>({ value, options, onChange, label, grow, className, disabled }: SelectProps<T>): import("react").JSX.Element;
+//# sourceMappingURL=Select.d.ts.map

package/dist/types/react/Select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/react/Select.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAgD,MAAM,OAAO,CAAC;AAQzG,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACrD,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACpD,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,+BAoI/H"}

package/dist/types/react/Slider.d.ts

@@ -0,0 +1,24 @@
+export interface SliderProps {
+    value: number;
+    onChange: (value: number) => void;
+    /** Spoken name (`aria-label`). */
+    label: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    /** What the value reads as, for the screen reader and the number beside the track (default: a percentage). */
+    format?: (value: number) => string;
+    /** Hides the number beside the track. */
+    hideValue?: boolean;
+    disabled?: boolean;
+    className?: string;
+}
+/** The value an arrow, Page or Home/End key moves a slider to; `undefined` for any other key. */
+export declare function sliderKeyValue(key: string, value: number, min: number, max: number, step: number): number | undefined;
+/**
+ * A slider drawn by the theme instead of the browser's range: a sunk track, a fill and a square knob. Dragging,
+ * pressing anywhere on the track and the arrow / Page / Home / End keys move it; it is a `role="slider"` with its aria
+ * values, so it reads like the native range it replaces. Focused, it keeps the arrow keys from the game.
+ */
+export declare function Slider({ value, onChange, label, min, max, step, format, hideValue, disabled, className }: SliderProps): import("react").JSX.Element;
+//# sourceMappingURL=Slider.d.ts.map

package/dist/types/react/Slider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Slider.d.ts","sourceRoot":"","sources":["../../../src/react/Slider.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8GAA8G;IAC9G,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAarH;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAO,EAAE,GAAO,EAAE,IAAW,EAAE,MAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,WAAW,+BAoD9I"}

package/dist/types/react/SplitPane.d.ts

@@ -0,0 +1,26 @@
+import { type ReactNode } from 'react';
+export interface SplitPaneProps {
+    list: ReactNode;
+    /** The right pane; `null`/`undefined`/`false` shows `empty` instead. */
+    detail?: ReactNode;
+    empty?: ReactNode;
+    /** The list column's width (any CSS grid track); by default the two share the width evenly. */
+    listWidth?: string;
+    /** Height follows the content (capped) instead of the fixed window height: for panes with little in them. */
+    fit?: boolean;
+    /** Below this width a touch screen shows one pane at a time (default `SPLIT_STACK_BELOW`, 600). */
+    stackBelow?: number;
+    /** A click on an element matching this opens the detail when stacked (default `.e1681-pickable`). */
+    pickSelector?: string;
+    /** The back button's word (default: the provider's `backToList`). */
+    backLabel?: ReactNode;
+    className?: string;
+}
+/**
+ * Two panes side by side: a list that scrolls on its own and the detail of what is picked, which stays in view
+ * however long the list grows, so a window is as tall as `.e1681-split` says and never taller. On a touch screen
+ * narrower than `stackBelow` only one pane shows at a time: tapping a pickable row (`.e1681-pickable`) opens its
+ * detail, and the back button returns. In a touch sheet it fills the height left below what sits above it.
+ */
+export declare function SplitPane({ list, detail, empty, listWidth, fit, stackBelow, pickSelector, backLabel, className }: SplitPaneProps): import("react").JSX.Element;
+//# sourceMappingURL=SplitPane.d.ts.map

package/dist/types/react/SplitPane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SplitPane.d.ts","sourceRoot":"","sources":["../../../src/react/SplitPane.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,SAAS,EAAoB,MAAM,OAAO,CAAC;AAM9F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6GAA6G;IAC7G,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,UAA8B,EAAE,YAAgC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,cAAc,+BA4BxK"}

package/dist/types/react/TabStrip.d.ts

@@ -0,0 +1,31 @@
+import type { PointerEvent, ReactNode } from 'react';
+export interface Tab<T extends string> {
+    id: T;
+    label: ReactNode;
+    /** Why a disabled tab cannot be taken. */
+    title?: string;
+    disabled?: boolean;
+    /** The tab's own colour for its label, kept on both states. */
+    color?: string;
+}
+export interface TabStripProps<T extends string> {
+    tabs: readonly Tab<T>[];
+    value: T;
+    onChange: (id: T) => void;
+    /** The short strip that sits over a field or in a row of controls. */
+    small?: boolean;
+    /** Breaks onto more rows instead of scrolling sideways (same as `className={cx('wrap')}`). */
+    wrap?: boolean;
+    className?: string;
+    /** What the strip chooses, for a screen reader. */
+    label?: string;
+    /** Lets a strip beside a text field keep the keyboard open (`e.preventDefault()`). */
+    onPointerDown?: (e: PointerEvent) => void;
+}
+/**
+ * One strip of tabs: the chosen one lifted and open into the pane below, the rest a step lower. Every row of tabs —
+ * a window's sections, a filter, a difficulty — goes through here so they all read the same; never a row of buttons
+ * or a `<select>`. A strip too long for one row takes `wrap` (or `className={cx('wrap')}`).
+ */
+export declare function TabStrip<T extends string>({ tabs, value, onChange, small, wrap, className, label, onPointerDown }: TabStripProps<T>): import("react").JSX.Element;
+//# sourceMappingURL=TabStrip.d.ts.map

package/dist/types/react/TabStrip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabStrip.d.ts","sourceRoot":"","sources":["../../../src/react/TabStrip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpE,MAAM,WAAW,GAAG,CAAC,CAAC,SAAS,MAAM;IACnC,EAAE,EAAE,CAAC,CAAC;IACN,KAAK,EAAE,SAAS,CAAC;IACjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM;IAC7C,IAAI,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC;IAC1B,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8FAA8F;IAC9F,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,+BAiCnI"}

package/dist/types/react/TitleTips.d.ts

@@ -0,0 +1,15 @@
+export interface TitleTipsProps {
+    /** How long the pointer rests on an element before its tip shows (default 350 ms). */
+    delayMs?: number;
+    /** Only elements inside this one (default: the whole document). */
+    root?: () => HTMLElement | null;
+    className?: string;
+}
+/**
+ * Every `title=` drawn as the kit's `Tooltip` instead of the browser's. Mounted once: the element under the pointer
+ * has its `title` taken off while the pointer stays on it (so the browser shows nothing) and put back when it leaves,
+ * so components keep writing plain `title=` and React's diffing never sees a change. Pointer events, not mouse
+ * events, because a disabled button fires only those. Desktop only: a touch screen never showed a title.
+ */
+export declare function TitleTips({ delayMs, root, className }: TitleTipsProps): import("react").JSX.Element | null;
+//# sourceMappingURL=TitleTips.d.ts.map

package/dist/types/react/TitleTips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TitleTips.d.ts","sourceRoot":"","sources":["../../../src/react/TitleTips.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,OAAa,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,cAAc,sCAuF3E"}

package/dist/types/react/Tooltip.d.ts

@@ -0,0 +1,22 @@
+import { type ReactNode } from 'react';
+import type { Rect } from '../ui/layout/geometry.js';
+import { type TipSide } from '../ui/layout/placeTooltip.js';
+export interface TooltipProps {
+    /** By the cursor: its screen position. */
+    x?: number;
+    y?: number;
+    /** Or beside an element: its screen rect (`getBoundingClientRect()`). Wins over `x`/`y`. */
+    anchor?: Rect;
+    /** Open over the cursor (or on this side of the anchor) first; it flips when there is no room. */
+    above?: boolean;
+    side?: TipSide;
+    className?: string;
+    children: ReactNode;
+}
+/**
+ * A tooltip frame kept on screen by its own measured size (`placeTooltip`): under the cursor while it fits, over it
+ * when it does not, slid along the edge, never taller than the viewport. Portalled to the `UiProvider`'s `portal`, so
+ * a window's `overflow` or transform never clips or shifts it.
+ */
+export declare function Tooltip({ x, y, anchor, above, side, className, children }: TooltipProps): import("react").JSX.Element;
+//# sourceMappingURL=Tooltip.d.ts.map

package/dist/types/react/Tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/react/Tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAqC,MAAM,OAAO,CAAC;AAE1E,OAAO,KAAK,EAAE,IAAI,EAAQ,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAgB,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIvE,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,4FAA4F;IAC5F,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,kGAAkG;IAClG,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,CAAK,EAAE,CAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,YAAY,+BA0B/F"}

package/dist/types/react/UiProvider.d.ts

@@ -0,0 +1,52 @@
+import { type ReactNode } from 'react';
+import type { Size } from '../ui/layout/geometry.js';
+import { type ClassJoiner } from './classNames.js';
+import { type UiLabels } from './labels.js';
+/** What every component of the kit reads: where it is, how big the screen is and the words it prints. */
+export interface UiSettings {
+    /** Fingers, not a mouse: windows become full-screen sheets, tooltips are not shown. Default: `isTouchUi()`. */
+    touch: boolean;
+    /**
+     * The scale windows and dialogs are meant to be drawn at (`fitToViewport`'s `scale`): a whole multiple for a
+     * pixel-art UI laid out on small units. Default 1.
+     */
+    scale: number;
+    /** The smallest scale a window may shrink to before its body scrolls instead (default: `scale`, never shrinks). */
+    minScale: number;
+    /** A player's "window size" for touch sheets: laid out on a box `1 / sheetScale` the screen and drawn back down. */
+    sheetScale: number;
+    /** Kept clear between a window and the screen's edges (default 8). */
+    margin: number;
+    /** Positions and sizes land on whole pixels (default true): pixel art at x.5 reads blurred. */
+    snap: boolean;
+    labels: UiLabels;
+    /** The box windows, tooltips and lists are placed in. Default: the browser window. */
+    viewport: () => Size;
+    /** Where tooltips, the select's list and dialogs are portalled. Default: `document.body`. */
+    portal: () => HTMLElement | null;
+    /**
+     * A game's own class names hung beside the kit's, keyed by the kit's name without its prefix (`tabs`, `tab`,
+     * `button`, `select-list`…) or by a state (`picked`, `open`): a game whose stylesheet already styles its own names
+     * takes the kit without rewriting it. Default none.
+     */
+    classNames: Readonly<Record<string, string>>;
+    /** Joins class names, adding the game's beside each of the kit's (`classNames`); what every component calls. */
+    cx: ClassJoiner;
+}
+export interface UiProviderProps extends Partial<Omit<UiSettings, 'labels' | 'cx'>> {
+    labels?: Partial<UiLabels>;
+    children?: ReactNode;
+}
+/** The settings a component sees with no `UiProvider` above it. */
+export declare function defaultUiSettings(): UiSettings;
+/**
+ * Optional: sets the touch mode, the window scale, the words and the box to place things in for every component
+ * below it. A UI mounted in a `DomOverlay` passes the overlay's content size as `viewport` and the overlay's
+ * content as `portal`, so tooltips and lists land inside its scaled box.
+ */
+export declare function UiProvider({ children, labels, touch, scale, minScale, sheetScale, margin, snap, viewport, portal, classNames }: UiProviderProps): import("react").JSX.Element;
+/** The kit's settings: the nearest `UiProvider`'s, or the defaults. */
+export declare function useUi(): UiSettings;
+/** The class joiner of the nearest `UiProvider` (`UiSettings.cx`). */
+export declare function useCx(): ClassJoiner;
+//# sourceMappingURL=UiProvider.d.ts.map

package/dist/types/react/UiProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiProvider.d.ts","sourceRoot":"","sources":["../../../src/react/UiProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE3E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzD,yGAAyG;AACzG,MAAM,WAAW,UAAU;IACzB,+GAA+G;IAC/G,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,mHAAmH;IACnH,QAAQ,EAAE,MAAM,CAAC;IACjB,oHAAoH;IACpH,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,QAAQ,CAAC;IACjB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,gHAAgH;IAChH,EAAE,EAAE,WAAW,CAAC;CACjB;AAED,MAAM,WAAW,eAAgB,SAAQ,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAYD,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C;AAID;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,eAAe,+BAqB/I;AAID,uEAAuE;AACvE,wBAAgB,KAAK,IAAI,UAAU,CAKlC;AAED,sEAAsE;AACtE,wBAAgB,KAAK,IAAI,WAAW,CAEnC"}

package/dist/types/react/baseCss.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The kit's base stylesheet, as a string: `injectBaseCss()` puts it in the page once, or a game copies it into its
+ * own CSS. Everything is themed by custom properties a game sets on `:root` (or any ancestor):
+ *
+ * | Property | What |
+ * |---|---|
+ * | `--e1681-font`, `--e1681-font-size` | the UI's font |
+ * | `--e1681-text`, `--e1681-muted`, `--e1681-accent` | text, quiet text, the picked / lit colour |
+ * | `--e1681-bg`, `--e1681-well`, `--e1681-control-bg` | a window's fill, a sunk pane's, a button's or field's |
+ * | `--e1681-border`, `--e1681-border-width` | the plain border used while no frame image is given |
+ * | `--e1681-frame`, `--e1681-frame-slice`, `--e1681-frame-width` | windows and dialogs: a 9-slice `border-image` (`url(…)`, `16 20 20 16 fill`, `16px 20px 20px 16px`) |
+ * | `--e1681-tip-frame`, `-slice`, `-width` | tooltips and the select's list |
+ * | `--e1681-control-frame`, `-slice`, `-width` | buttons, the select, text fields |
+ * | `--e1681-tab-frame`, `--e1681-tab-active-frame`, `-slice`, `-width` | tabs |
+ * | `--e1681-well-frame`, `-slice`, `-width` | the split pane's detail, the slider's track |
+ * | `--e1681-backdrop` | behind a dialog |
+ *
+ * A `-width` may have one to four lengths, like `border-width`. The pixel rules hold here: no `translate(-50%)` centring and no `zoom` (the components place in whole pixels), no
+ * blurred shadow, no gradient. A frame's middle shows through only when its slice says `fill`.
+ */
+export declare const baseCss = "\n:root {\n  --e1681-font: inherit;\n  --e1681-font-size: 16px;\n  --e1681-text: #ece6d6;\n  --e1681-muted: #9c968a;\n  --e1681-accent: #e8c060;\n  --e1681-bg: #1d242e;\n  --e1681-well: #131a24;\n  --e1681-control-bg: #2a323e;\n  --e1681-border: #6a5634;\n  --e1681-border-width: 2px;\n  --e1681-backdrop: rgba(0, 0, 0, 0.5);\n  --e1681-frame: none;\n  --e1681-frame-slice: 0;\n  --e1681-frame-width: var(--e1681-border-width);\n  --e1681-tip-frame: var(--e1681-frame);\n  --e1681-tip-frame-slice: var(--e1681-frame-slice);\n  --e1681-tip-frame-width: var(--e1681-frame-width);\n  --e1681-control-frame: none;\n  --e1681-control-frame-slice: 0;\n  --e1681-control-frame-width: var(--e1681-border-width);\n  --e1681-tab-frame: var(--e1681-control-frame);\n  --e1681-tab-active-frame: var(--e1681-tab-frame);\n  --e1681-tab-frame-slice: var(--e1681-control-frame-slice);\n  --e1681-tab-frame-width: var(--e1681-control-frame-width);\n  --e1681-well-frame: none;\n  --e1681-well-frame-slice: 0;\n  --e1681-well-frame-width: var(--e1681-border-width);\n}\n\n.e1681-frame {\n  color: var(--e1681-text);\n  font-family: var(--e1681-font);\n  font-size: var(--e1681-font-size);\n  background: var(--e1681-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-frame-width);\n  border-image: var(--e1681-frame) var(--e1681-frame-slice) / var(--e1681-frame-width) stretch;\n  box-sizing: border-box;\n}\n.e1681-tip-frame {\n  color: var(--e1681-text);\n  font-family: var(--e1681-font);\n  font-size: var(--e1681-font-size);\n  background: var(--e1681-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-tip-frame-width);\n  border-image: var(--e1681-tip-frame) var(--e1681-tip-frame-slice) / var(--e1681-tip-frame-width) stretch;\n  box-sizing: border-box;\n}\n\n/* windows: placed by useFitToViewport in whole pixels; header kept, body scrolls */\n.e1681-panel {\n  position: fixed;\n  z-index: 10;\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  overflow: hidden;\n  pointer-events: auto;\n}\n.e1681-panel-header { display: flex; align-items: center; gap: 8px; flex: none; padding: 2px 4px 6px; }\n.e1681-panel-title { flex: 1; min-width: 0; margin: 0; font-size: 1.25em; font-weight: normal; color: var(--e1681-accent); }\n.e1681-panel-body { flex: 1 1 auto; min-height: 0; overflow-y: auto; overflow-x: hidden; padding: 0 4px 4px; }\n.e1681-panel-footer { flex: none; display: flex; flex-wrap: wrap; gap: 6px; justify-content: flex-end; padding: 6px 4px 0; }\n.e1681-close {\n  flex: none; padding: 2px; border: 0; background: none; color: var(--e1681-text); cursor: pointer; line-height: 0;\n}\n.e1681-close:hover { color: var(--e1681-accent); }\n/* a touch screen's sheet: the whole screen inside the safe area */\n.e1681-panel.e1681-sheet {\n  inset: env(safe-area-inset-top, 0px) env(safe-area-inset-right, 0px) env(safe-area-inset-bottom, 0px) env(safe-area-inset-left, 0px);\n  width: auto;\n  height: auto;\n}\n.e1681-panel.e1681-sheet .e1681-panel-body { overscroll-behavior: contain; -webkit-overflow-scrolling: touch; }\n\n/* controls */\n.e1681-button, .e1681-input, .e1681-select {\n  color: var(--e1681-text);\n  font: inherit;\n  background: var(--e1681-control-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-control-frame-width);\n  border-image: var(--e1681-control-frame) var(--e1681-control-frame-slice) / var(--e1681-control-frame-width) stretch;\n  box-shadow: none;\n}\n.e1681-button { padding: 2px 10px; cursor: pointer; min-height: 28px; }\n.e1681-button.small { padding: 0 6px; min-height: 22px; }\n.e1681-button.ghost { background-color: transparent; }\n.e1681-button:hover:not(:disabled) { color: var(--e1681-accent); }\n/* pressed: the same face a pixel lower, never a transform */\n.e1681-button:active:not(:disabled) { padding-top: 3px; padding-bottom: 1px; }\n.e1681-button:disabled { opacity: 0.55; cursor: default; }\n.e1681-input { padding: 2px 6px; min-width: 0; }\n.e1681-glyph { display: inline-block; flex: none; vertical-align: -1px; }\n\n/* tabs: a row that scrolls sideways, or wraps with .wrap */\n.e1681-tabs { display: flex; gap: 2px; align-items: flex-end; overflow-x: auto; overflow-y: hidden; scrollbar-width: none; margin-bottom: 8px; }\n.e1681-tabs::-webkit-scrollbar { display: none; }\n.e1681-tabs.wrap { flex-wrap: wrap; overflow-x: visible; row-gap: 4px; }\n.e1681-tab {\n  flex: 0 0 auto;\n  padding: 2px 10px;\n  color: var(--e1681-muted);\n  font: inherit;\n  cursor: pointer;\n  white-space: nowrap;\n  background: var(--e1681-control-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-tab-frame-width);\n  border-image: var(--e1681-tab-frame) var(--e1681-tab-frame-slice) / var(--e1681-tab-frame-width) stretch;\n}\n.e1681-tab:hover:not(.active):not(:disabled) { color: var(--e1681-text); }\n.e1681-tab.active { color: var(--e1681-accent); padding-bottom: 6px; border-image-source: var(--e1681-tab-active-frame); }\n.e1681-tab:disabled { opacity: 0.55; cursor: default; }\n.e1681-tab:focus-visible { outline: 2px solid var(--e1681-accent); outline-offset: -4px; }\n.e1681-tabs.small { margin-bottom: 4px; }\n.e1681-tabs.small .e1681-tab { padding: 0 6px; }\n.e1681-tabs.small .e1681-tab.active { padding-bottom: 4px; }\n\n/* list beside detail */\n.e1681-split {\n  display: grid;\n  grid-template-columns: var(--e1681-split-list, minmax(0, 1fr)) minmax(0, 1fr);\n  gap: 12px;\n  height: min(58vh, 620px);\n}\n.e1681-split.fit { height: auto; max-height: min(58vh, 620px); }\n.e1681-split-list, .e1681-split-detail { min-height: 0; overflow-y: auto; overflow-x: hidden; }\n.e1681-split-list { padding-right: 4px; }\n.e1681-split-detail {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  padding: 8px 10px;\n  background: var(--e1681-well) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-well-frame-width);\n  border-image: var(--e1681-well-frame) var(--e1681-well-frame-slice) / var(--e1681-well-frame-width) stretch;\n}\n.e1681-split-empty { flex: 1; display: flex; align-items: center; justify-content: center; text-align: center; color: var(--e1681-muted); }\n.e1681-split.stack { grid-template-columns: minmax(0, 1fr); }\n.e1681-split.stack.show-list .e1681-split-detail, .e1681-split.stack.show-detail .e1681-split-list { display: none; }\n.e1681-split-back { align-self: flex-start; }\n.e1681-row { display: flex; align-items: center; gap: 8px; padding: 4px 6px; margin-bottom: 4px; border: var(--e1681-border-width) solid transparent; }\n.e1681-pickable { cursor: pointer; }\n.e1681-pickable:hover:not(.picked):not(.disabled) { border-color: var(--e1681-border); }\n.e1681-row.picked { border-color: var(--e1681-accent); color: var(--e1681-accent); }\n.e1681-row.disabled { opacity: 0.55; cursor: default; }\n\n/* the select: as wide as its longest label */\n.e1681-select { display: inline-flex; align-items: center; gap: 6px; flex: none; padding: 1px 4px; text-align: left; cursor: pointer; }\n.e1681-select:hover:not(:disabled), .e1681-select.open { color: var(--e1681-accent); }\n.e1681-select:disabled { opacity: 0.6; cursor: default; }\n.e1681-select.grow { flex: 1 1 auto; min-width: 0; }\n.e1681-select.grow .e1681-select-labels { flex: 1 1 auto; min-width: 0; overflow: hidden; }\n.e1681-select.grow .e1681-select-labels > span { overflow: hidden; text-overflow: ellipsis; }\n.e1681-select-labels { display: grid; white-space: nowrap; }\n.e1681-select-labels > span { grid-area: 1 / 1; visibility: hidden; }\n.e1681-select-labels > span.shown { visibility: visible; }\n.e1681-select-list {\n  position: fixed;\n  z-index: 10000;\n  box-sizing: border-box;\n  width: max-content;\n  padding: 2px;\n  overflow-y: auto;\n  pointer-events: auto;\n}\n.e1681-select-option { padding: 2px 6px; white-space: nowrap; cursor: pointer; }\n.e1681-select-list.measuring .e1681-select-option { width: max-content; }\n.e1681-select-option.hot { background: var(--e1681-control-bg); }\n.e1681-select-option.picked { color: var(--e1681-accent); }\n\n/* tooltips */\n.e1681-tooltip { position: fixed; z-index: 10001; max-width: 360px; padding: 4px 8px; overflow: hidden; pointer-events: none; }\n.e1681-title-tip { white-space: pre-line; }\n\n/* slider: a square knob, flat fills */\n.e1681-slider-row { display: flex; align-items: center; gap: 8px; flex: 1; min-width: 0; }\n.e1681-slider { flex: 1; min-width: 0; padding: 6px 7px; cursor: pointer; touch-action: none; user-select: none; pointer-events: auto; }\n.e1681-slider:focus { outline: none; }\n.e1681-slider:focus-visible { outline: 2px solid var(--e1681-accent); outline-offset: 2px; }\n.e1681-slider[aria-disabled='true'] { opacity: 0.55; cursor: default; }\n.e1681-slider-track {\n  position: relative;\n  height: 6px;\n  background: var(--e1681-well) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-well-frame-width);\n  border-image: var(--e1681-well-frame) var(--e1681-well-frame-slice) / var(--e1681-well-frame-width) stretch;\n}\n.e1681-slider-fill { position: absolute; left: 0; top: 0; bottom: 0; background: var(--e1681-accent); }\n/* the knob is offset by half its own whole-pixel width with a margin, so it stays on the pixel grid */\n.e1681-slider-knob { position: absolute; top: -6px; width: 10px; height: 14px; margin-left: -5px; background: var(--e1681-text); border: 2px solid var(--e1681-well); box-sizing: border-box; }\n.e1681-slider-value { min-width: 40px; text-align: right; font-variant-numeric: tabular-nums; }\n\n/* dialogs */\n.e1681-backdrop { position: fixed; inset: 0; z-index: 9000; background: var(--e1681-backdrop); pointer-events: auto; }\n.e1681-dialog { position: fixed; display: flex; flex-direction: column; overflow: hidden; padding: 8px 10px; }\n.e1681-dialog-body { flex: 1 1 auto; min-height: 0; overflow-y: auto; }\n.e1681-dialog-actions { flex: none; display: flex; flex-wrap: wrap; gap: 8px; justify-content: flex-end; padding-top: 10px; }\n.e1681-confirm-text { white-space: pre-line; }\n.e1681-confirm-qty { display: flex; align-items: center; gap: 6px; margin-top: 10px; }\n.e1681-confirm-qty-input { width: 56px; text-align: right; }\n.e1681-choice-list { margin-top: 8px; }\n.e1681-choice-icon { flex: none; line-height: 0; }\n.e1681-choice-label { flex: 1; min-width: 0; }\n.e1681-choice-note { flex: none; margin-left: auto; color: var(--e1681-muted); }\n\n/* sprites at whole multiples */\n.e1681-pixel-image { display: inline-flex; align-items: center; justify-content: center; flex: none; overflow: hidden; }\n.e1681-pixel-image > img { image-rendering: pixelated; flex: none; }\n";
+/**
+ * Puts `baseCss` into the page once, first in `<head>` so the game's own rules (and its custom properties) win
+ * without needing more specific selectors. Returns the `<style>` element; nothing on a server.
+ */
+export declare function injectBaseCss(doc?: Document | undefined): HTMLStyleElement | null;
+//# sourceMappingURL=baseCss.d.ts.map

package/dist/types/react/baseCss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseCss.d.ts","sourceRoot":"","sources":["../../../src/react/baseCss.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO,giVAiNnB,CAAC;AAIF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,QAAQ,GAAG,SAAkE,GAAG,gBAAgB,GAAG,IAAI,CASzI"}

package/dist/types/react/choiceStore.d.ts

@@ -0,0 +1,34 @@
+import type { ReactNode } from 'react';
+/** One row of a choice: a line of text, with an icon before it and a note after it if the game gives them. */
+export interface ChoiceOption {
+    id: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    note?: ReactNode;
+    disabled?: boolean;
+}
+export interface ChoiceQuestion {
+    text: ReactNode;
+    options: readonly ChoiceOption[];
+    /** The confirm button's word; default the provider's `choose`. */
+    confirm?: string;
+    cancel?: string;
+    /** The id picked, or null when cancelled. */
+    resolve: (id: string | null) => void;
+}
+/** The open choice, read by `ChoiceDialog`. */
+export declare const choiceStore: import("../ui/index.js").Store<{
+    pending: ChoiceQuestion | null;
+}>;
+/** Asks the player to pick one of `options`; resolves its id, or null when cancelled. */
+export declare function askChoice(text: ReactNode, options: readonly ChoiceOption[], words?: {
+    confirm?: string;
+    cancel?: string;
+}): Promise<string | null>;
+/** Answers the open choice (`null` cancels). */
+export declare function answerChoice(id: string | null): void;
+/** Cancels the open choice, if any (a phone's back button). Returns whether there was one. */
+export declare function cancelChoice(): boolean;
+/** The option picked first: the first one that can be taken. */
+export declare function firstChoice(options: readonly ChoiceOption[]): string | null;
+//# sourceMappingURL=choiceStore.d.ts.map

package/dist/types/react/choiceStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choiceStore.d.ts","sourceRoot":"","sources":["../../../src/react/choiceStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,8GAA8G;AAC9G,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACtC;AAED,+CAA+C;AAC/C,eAAO,MAAM,WAAW;aAA0B,cAAc,GAAG,IAAI;EAAsB,CAAC;AAE9F,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGtJ;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIpD;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,IAAI,OAAO,CAItC;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,GAAG,IAAI,CAE3E"}

package/dist/types/react/classNames.d.ts

@@ -0,0 +1,12 @@
+/** Joins class names, skipping empty ones. */
+export type ClassJoiner = (...names: (string | false | null | undefined)[]) => string;
+/**
+ * A joiner that hangs a game's own class names beside the kit's: every name it is given (split on spaces) is kept,
+ * and followed by `classes[name without the kit's prefix]` when the game mapped it. Pure, so it is tested under node.
+ *
+ * ```ts
+ * classJoiner({ tabs: 'tabs', button: 'btn', picked: 'active' })('e1681-button small', 'picked') // 'e1681-button btn small picked active'
+ * ```
+ */
+export declare function classJoiner(classes: Readonly<Record<string, string>>): ClassJoiner;
+//# sourceMappingURL=classNames.d.ts.map

package/dist/types/react/classNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.d.ts","sourceRoot":"","sources":["../../../src/react/classNames.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC;AAItF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,WAAW,CAgBlF"}