1681-engine 0.5.8 → 0.5.10

package/dist/types/ui/rich/richLayout.d.ts

@@ -0,0 +1,76 @@
+import type { RichSpan, RichStyle } from './richMarkup.js';
+/**
+ * Line breaking and placement for `RichText`, pure: every width and height comes from a `RichMeasure` the caller
+ * hands in, so the same layout runs under node in a test, with a canvas font, or with a bitmap font.
+ *
+ * Lines break only at spaces and `\n`; a word wider than the whole line is broken between letters. Text and icons
+ * with no space between them (`[icon=coin]50`) stay together. Text of one style that ends up side by side on a line
+ * is one item, so a paragraph in one colour costs one display object a line.
+ */
+export interface RichMeasure {
+    /** Advance width of `text` in `style` (spaces included: they are measured on their own). */
+    textWidth(text: string, style: RichStyle): number;
+    /** Height of a line of text in `style`. */
+    lineHeight(style: RichStyle): number;
+    /** Baseline from the top of such a line; 0.8 of the line height when not given. */
+    ascent?(style: RichStyle): number;
+    /** Size of an icon's frame in texture pixels. */
+    iconSize(key: string, frame: string | undefined): {
+        width: number;
+        height: number;
+    };
+}
+export type RichAlign = 'left' | 'center' | 'right';
+export interface RichLayoutOptions {
+    /** Wrap lines to this width; unset, lines break only at `\n`. */
+    wrapWidth?: number;
+    align?: RichAlign;
+    /** Extra pixels between lines. */
+    lineSpacing?: number;
+    /**
+     * `'line'` (default): an icon is as tall as its style's line — on a pixel-perfect layout the largest whole multiple
+     * of its frame that fits, never below 1×, so its texels stay square. A number: that scale, whatever the line.
+     */
+    iconScale?: 'line' | number;
+    /** Whole-pixel positions and icon scales (a pixel-art game). */
+    pixelPerfect?: boolean;
+}
+export interface RichTextItem {
+    kind: 'text';
+    text: string;
+    style: RichStyle;
+    x: number;
+    /** Top of the text's own line box. */
+    y: number;
+    width: number;
+    height: number;
+}
+export interface RichIconItem {
+    kind: 'icon';
+    key: string;
+    frame?: string;
+    style: RichStyle;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export type RichItem = RichTextItem | RichIconItem;
+export interface RichLine {
+    y: number;
+    width: number;
+    height: number;
+    /** Baseline from the line's top. */
+    baseline: number;
+    items: RichItem[];
+}
+export interface RichLayout {
+    /** The box: `wrapWidth` when wrapping, else the widest line. */
+    width: number;
+    height: number;
+    lines: RichLine[];
+}
+/** Breaks spans into lines and places every run and icon. */
+export declare function layoutRichText(spans: readonly RichSpan[], measure: RichMeasure, options?: RichLayoutOptions): RichLayout;
+export declare function sameStyle(a: RichStyle, b: RichStyle): boolean;
+//# sourceMappingURL=richLayout.d.ts.map

package/dist/types/ui/rich/richLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richLayout.d.ts","sourceRoot":"","sources":["../../../../src/ui/rich/richLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAExD;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,4FAA4F;IAC5F,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAClD,2CAA2C;IAC3C,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IACrC,mFAAmF;IACnF,MAAM,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAClC,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACrF;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,sCAAsC;IACtC,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAaD,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CA+D5H;AA4HD,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAE7D"}

package/dist/types/ui/rich/richMarkup.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The markup `RichText` reads: square-bracket tags, like BBCode, chosen because a translator can type them, a chat
+ * line can carry them, and nothing in ordinary prose looks like one.
+ *
+ * | Markup | Means |
+ * |---|---|
+ * | `[color=#f0c060]…[/color]` | colour: `#rgb`, `#rrggbb`, or a name the caller defines (`colors: { gold: '#f0c060' }`) |
+ * | `[b]…[/b]`, `[i]…[/i]` | bold, italic (where the font has them) |
+ * | `[size=16]…[/size]` | font size in pixels |
+ * | `[icon=coin]`, `[icon=items:12]` | an inline icon: a texture key, and after the last `:` a frame of it |
+ * | `[[` | a literal `[` |
+ *
+ * Anything else in brackets — an unknown tag, a bad value, a close with nothing open — is printed as written, so a
+ * typo shows on screen instead of swallowing the text after it. Tags still open at the end are closed there; closing
+ * an outer tag closes the ones opened inside it. Text from players (names, chat) goes through `escapeRichText` first.
+ * Pure: no Pixi, no DOM.
+ */
+/** How a run of text is drawn. Unset fields fall back to the font's own. */
+export interface RichStyle {
+    color?: string;
+    bold: boolean;
+    italic: boolean;
+    size?: number;
+}
+export interface RichTextSpan {
+    kind: 'text';
+    text: string;
+    style: RichStyle;
+}
+export interface RichIconSpan {
+    kind: 'icon';
+    key: string;
+    frame?: string;
+    /** The style around it: its size decides the icon's height. */
+    style: RichStyle;
+}
+export type RichSpan = RichTextSpan | RichIconSpan;
+export interface RichMarkupOptions {
+    /** Colour names the markup may use besides hex (`[color=gold]`). */
+    colors?: Readonly<Record<string, string>>;
+}
+/** Makes text safe to put inside markup: every `[` doubled, so a player named `[b]` prints as typed. */
+export declare function escapeRichText(text: string): string;
+/** Parses markup into spans; adjacent text of one style is one span. */
+export declare function parseRichText(source: string, options?: RichMarkupOptions): RichSpan[];
+/** Plain text of markup: tags gone, icons gone, escapes undone (for measuring, logs, screen readers). */
+export declare function stripRichText(source: string, options?: RichMarkupOptions): string;
+//# sourceMappingURL=richMarkup.d.ts.map

package/dist/types/ui/rich/richMarkup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richMarkup.d.ts","sourceRoot":"","sources":["../../../../src/ui/rich/richMarkup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3C;AAMD,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,QAAQ,EAAE,CAwCzF;AAED,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAIrF"}

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

@@ -0,0 +1,9 @@
+/**
+ * `1681-engine/updates`: file-by-file web updates from a release store, the pure half — the feed's shapes, which web
+ * to take, and what to copy or download to build it. No Node, DOM or Electron: shared by the desktop shell
+ * (`1681-engine/electron`), a browser build and the phone apps.
+ */
+export { isNewer, safePath, isSha256, validManifest, fileUrl, type WebFile, type WebManifest, type LatestJson, type ReleaseFile, } from './manifest.js';
+export { planWeb, type WebPlan } from './webPlan.js';
+export { pickWebUpdate, apkUpdateOf, pluginEntries, heldBundle, type WebBundle, type NewerRelease, type PluginEntry } from './pickUpdate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/updates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,OAAO,EACP,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/updates/manifest.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The shapes of a release store's feed for file-by-file web updates, and the rules for trusting one. One definition
+ * for every client that reads it: the desktop shell's patcher (`1681-engine/electron`), a browser build and the phone
+ * apps' over-the-air updater. A publish script writes, per channel:
+ *
+ * - `<channel>/latest.json` ({@link LatestJson}): the newest build and where its pieces lie, as paths under the channel,
+ *   written last so a client never reads a release that is half up;
+ * - `<channel>/web/<version>.json` ({@link WebManifest}): every file of the built web with its sha256;
+ * - `<channel>/files/<sha256>`: each content once, so a release uploads and a client downloads only what is new.
+ *
+ * Kept pure (no Node, no DOM, no Electron) so a phone's web view and an Electron main process share it.
+ */
+/** One file of a built web, as the manifest lists it. */
+export interface WebFile {
+    /** Relative to the web's root, forward slashes (`assets/index-3f2a.js`). */
+    path: string;
+    /** Lower-case hex sha256 of the content; also its name under `<channel>/files/`. */
+    sha256: string;
+    size: number;
+}
+/** `<channel>/web/<version>.json`. */
+export interface WebManifest {
+    version: string;
+    /**
+     * The desktop shell this web needs (`shellId` in `1681-engine/electron`): a web talks to its shell through a
+     * preload script and may need what a newer shell adds, so any other shell takes the installer instead.
+     */
+    shell: string;
+    /** The lowest native build of the phone apps this web needs: a web calling a plugin the app lacks must never reach it. */
+    minNative: number;
+    files: WebFile[];
+}
+/** A packaged download listed in `latest.json` (an APK, an installer). */
+export interface ReleaseFile {
+    file: string;
+    size: number;
+    sha256?: string;
+}
+/** `<channel>/latest.json`. */
+export interface LatestJson {
+    version: string;
+    date?: string;
+    /** The build's web: its manifest's path under the channel, the shell and native build it needs. */
+    web?: {
+        manifest: string;
+        shell: string;
+        minNative: number;
+    };
+    /** The Android package, when the channel publishes one. */
+    apk?: {
+        file: string;
+        size: number;
+        sha256: string;
+    };
+    /** Desktop installers by platform key (the publisher names the keys, e.g. `win`, `macArm`, `macX64`). */
+    desktop?: Record<string, ReleaseFile | undefined>;
+}
+/** Whether version `a` ("0.5.23", "v0.5.23") is newer than `b`, number by number; a missing part counts 0. */
+export declare function isNewer(a: string, b: string): boolean;
+/**
+ * A path a manifest may name: relative, forward slashes, no `.` or `..` segment, no NUL — nothing that could write
+ * outside the web's own folder once joined to it.
+ */
+export declare function safePath(p: string): boolean;
+/** Whether `s` is a lower-case hex sha256. */
+export declare function isSha256(s: unknown): s is string;
+/**
+ * A manifest whose shape may be trusted: every path safe and listed once, every hash a sha256, every size a number,
+ * and an `index.html` (a web without one cannot be loaded, and a truncated upload is the usual way to get one).
+ */
+export declare function validManifest(m: unknown): m is WebManifest;
+/** Where a content lies in the store: `<channelUrl>/files/<sha256>`. */
+export declare function fileUrl(channelUrl: string, sha256: string): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/types/updates/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/updates/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,yDAAyD;AACzD,MAAM,WAAW,OAAO;IACtB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,0HAA0H;IAC1H,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,GAAG,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,2DAA2D;IAC3D,GAAG,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC;CACnD;AAED,8GAA8G;AAC9G,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CASrD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAG3C;AAID,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAU1D;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/types/updates/pickUpdate.d.ts

@@ -0,0 +1,43 @@
+import { type LatestJson } from './manifest.js';
+/** A web a client may take: its version, its manifest's full URL and the native build it needs. */
+export interface WebBundle {
+    version: string;
+    manifestUrl: string;
+    minNative: number;
+}
+/**
+ * The web to take from `latest`: newer than the web running (`webVersion`), and needing no native code this app lacks
+ * (`nativeBuild` ≥ the web's `minNative`). A browser or desktop build with no native layer passes `Infinity`.
+ */
+export declare function pickWebUpdate(latest: LatestJson, channelUrl: string, webVersion: string, nativeBuild: number): WebBundle | null;
+/** A newer build than this one, and where its Android package downloads from. */
+export interface NewerRelease {
+    version: string;
+    apkUrl: string;
+}
+/**
+ * The build's APK, when it is newer than this client and its web cannot come over the air instead (`webBundle` is
+ * what {@link pickWebUpdate} found): the package is the slow road, for native changes.
+ */
+export declare function apkUpdateOf(latest: LatestJson, channelUrl: string, clientVersion: string, webBundle: WebBundle | null): NewerRelease | null;
+/** One entry of a multi-file bundle download, in the shape `@capgo/capacitor-updater`'s `ManifestEntry` takes. */
+export interface PluginEntry {
+    file_name: string;
+    file_hash: string;
+    download_url: string;
+}
+/**
+ * A phone updater's download list for `manifest`, or null when the manifest is not one to trust (another version, an
+ * unsafe or repeated path, a bad hash, no `index.html`). The updater checks each file against its hash and reuses
+ * every file it already holds, so only new content is fetched.
+ */
+export declare function pluginEntries(manifest: unknown, version: string, channelUrl: string): PluginEntry[] | null;
+/**
+ * A copy of `bundle` the updater already holds whole (downloaded and checked, applied or waiting), so asking again —
+ * a settings screen's check after the login screen's — takes it instead of downloading the same files twice.
+ */
+export declare function heldBundle<T extends {
+    version: string;
+    status: string;
+}>(held: readonly T[], bundle: WebBundle): T | null;
+//# sourceMappingURL=pickUpdate.d.ts.map

package/dist/types/updates/pickUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickUpdate.d.ts","sourceRoot":"","sources":["../../../src/updates/pickUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,UAAU,EAAoB,MAAM,YAAY,CAAC;AAErG,mGAAmG;AACnG,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI/H;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAG3I;AAED,kHAAkH;AAClH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,IAAI,CAW1G;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAG,CAAC,GAAG,IAAI,CAEzH"}

package/dist/types/updates/webPlan.d.ts

@@ -0,0 +1,21 @@
+import type { WebFile, WebManifest } from './manifest.js';
+/** What building a new web takes, given the files a client already holds. */
+export interface WebPlan {
+    /** Files taken from the web held now: `from` is their path there. */
+    copy: {
+        path: string;
+        from: string;
+    }[];
+    /** Files to fetch from `<channel>/files/<sha256>`; content shared by several paths appears once per path. */
+    download: WebFile[];
+    /** Bytes to download, each distinct content counted once. */
+    bytes: number;
+}
+/**
+ * What to copy and what to download for `target`, given the web held now (`have`: path → sha256): a file whose path
+ * holds the same content is copied from there, one whose content lies under another path (a bundler renamed it) is
+ * copied from that path, and only content found nowhere is downloaded — once, however many paths share it. This is
+ * what makes a patch cost only what changed, the way a game launcher patches.
+ */
+export declare function planWeb(target: WebManifest, have: ReadonlyMap<string, string>): WebPlan;
+//# sourceMappingURL=webPlan.d.ts.map

package/dist/types/updates/webPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPlan.d.ts","sourceRoot":"","sources":["../../../src/updates/webPlan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,WAAW,OAAO;IACtB,qEAAqE;IACrE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvC,6GAA6G;IAC7G,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAoBvF"}

package/dist/ui/Bar.js

@@ -51,4 +51,3 @@ class v extends d {
 export {
   v as Bar
 };
-//# sourceMappingURL=Bar.js.map

package/dist/ui/Button.js

@@ -55,4 +55,3 @@ class v extends d {
 export {
   v as Button
 };
-//# sourceMappingURL=Button.js.map

package/dist/ui/Dialog.js

@@ -53,4 +53,3 @@ class H extends p {
 export {
   H as Dialog
 };
-//# sourceMappingURL=Dialog.js.map

package/dist/ui/FocusManager.js

@@ -94,4 +94,3 @@ export {
   f as DEFAULT_NAV,
   x as FocusManager
 };
-//# sourceMappingURL=FocusManager.js.map

package/dist/ui/Label.js

@@ -33,4 +33,3 @@ class i extends c {
 export {
   i as Label
 };
-//# sourceMappingURL=Label.js.map

package/dist/ui/List.js

@@ -42,4 +42,3 @@ class m extends c {
 export {
   m as List
 };
-//# sourceMappingURL=List.js.map

package/dist/ui/Panel.js

@@ -35,4 +35,3 @@ class x extends f {
 export {
   x as Panel
 };
-//# sourceMappingURL=Panel.js.map

package/dist/ui/ScrollView.js

@@ -93,4 +93,3 @@ class w extends n {
 export {
   w as ScrollView
 };
-//# sourceMappingURL=ScrollView.js.map

package/dist/ui/Slider.js

@@ -52,4 +52,3 @@ class b extends l {
 export {
   b as Slider
 };
-//# sourceMappingURL=Slider.js.map

package/dist/ui/Stack.js

@@ -25,4 +25,3 @@ class f extends h {
 export {
   f as Stack
 };
-//# sourceMappingURL=Stack.js.map

package/dist/ui/Toggle.js

@@ -34,4 +34,3 @@ class o extends a {
 export {
   o as Toggle
 };
-//# sourceMappingURL=Toggle.js.map

package/dist/ui/UiHost.js

@@ -6,4 +6,3 @@ function e(r) {
 export {
   e as uiHostOf
 };
-//# sourceMappingURL=UiHost.js.map

package/dist/ui/UiPointerGate.js

@@ -22,4 +22,3 @@ const u = {
 export {
   u as UiPointerGate
 };
-//# sourceMappingURL=UiPointerGate.js.map

package/dist/ui/UiRoot.js

@@ -90,4 +90,3 @@ class y extends h {
 export {
   y as UiRoot
 };
-//# sourceMappingURL=UiRoot.js.map

package/dist/ui/Widget.js

@@ -87,4 +87,3 @@ export {
   n as Widget,
   b as sizeOf
 };
-//# sourceMappingURL=Widget.js.map

package/dist/ui/dom/DomOverlay.js

@@ -56,4 +56,3 @@ class r {
 export {
   r as DomOverlay
 };
-//# sourceMappingURL=DomOverlay.js.map

package/dist/ui/dom/DomWorldAnchors.js

@@ -56,4 +56,3 @@ class m {
 export {
   m as DomWorldAnchors
 };
-//# sourceMappingURL=DomWorldAnchors.js.map

package/dist/ui/dom/InputShield.js

@@ -24,4 +24,3 @@ class a {
 export {
   a as InputShield
 };
-//# sourceMappingURL=InputShield.js.map

package/dist/ui/dom/createStore.js

@@ -39,4 +39,3 @@ function l(f) {
 export {
   l as createStore
 };
-//# sourceMappingURL=createStore.js.map

package/dist/ui/dom/shieldDecision.js

@@ -33,4 +33,3 @@ export {
   i as isInside,
   u as shouldShield
 };
-//# sourceMappingURL=shieldDecision.js.map

package/dist/ui/dom/worldToScreen.js

@@ -8,4 +8,3 @@ export {
   f as onScreen,
   x as worldToScreen
 };
-//# sourceMappingURL=worldToScreen.js.map

package/dist/ui/layout/anchor.js

@@ -17,4 +17,3 @@ function b(e, t, o, g = 0, n = !1) {
 export {
   b as anchorPosition
 };
-//# sourceMappingURL=anchor.js.map

package/dist/ui/layout/barDrain.js

@@ -22,4 +22,3 @@ export {
   d as setDrainValue,
   f as stepDrain
 };
-//# sourceMappingURL=barDrain.js.map

package/dist/ui/layout/fitToViewport.js

@@ -14,4 +14,3 @@ function W(h, a, n = {}) {
 export {
   W as fitToViewport
 };
-//# sourceMappingURL=fitToViewport.js.map

package/dist/ui/layout/focusNav.js

@@ -39,4 +39,3 @@ export {
   G as linearFocus,
   F as nextFocus
 };
-//# sourceMappingURL=focusNav.js.map

package/dist/ui/layout/geometry.js

@@ -18,4 +18,3 @@ export {
   i as snapPx,
   u as snapRect
 };
-//# sourceMappingURL=geometry.js.map

package/dist/ui/layout/listWidth.js

@@ -7,4 +7,3 @@ function m(i, n, t = {}) {
 export {
   m as listWidth
 };
-//# sourceMappingURL=listWidth.js.map

package/dist/ui/layout/placeTooltip.js

@@ -25,4 +25,3 @@ function a(e, t, s, h = {}) {
 export {
   a as placeTooltip
 };
-//# sourceMappingURL=placeTooltip.js.map

package/dist/ui/layout/scroll.js

@@ -21,4 +21,3 @@ export {
   a as scrollIntoView,
   p as stepFling
 };
-//# sourceMappingURL=scroll.js.map

package/dist/ui/layout/slider.js

@@ -17,4 +17,3 @@ export {
   i as sliderFraction,
   s as sliderValueAt
 };
-//# sourceMappingURL=slider.js.map

package/dist/ui/layout/stack.js

@@ -24,4 +24,3 @@ function M(h, s = {}) {
 export {
   M as stackLayout
 };
-//# sourceMappingURL=stack.js.map

package/dist/ui/layout/wrapRow.js

@@ -10,4 +10,3 @@ function p(s, h, u = 0) {
 export {
   p as wrapRow
 };
-//# sourceMappingURL=wrapRow.js.map

package/dist/ui/rich/RichText.js

@@ -0,0 +1,87 @@
+import { Sprite as a } from "pixi.js";
+import { Widget as c } from "../Widget.js";
+import { layoutRichText as d } from "./richLayout.js";
+import { parseRichText as p } from "./richMarkup.js";
+class b extends c {
+  source = "";
+  last = { width: 0, height: 0, lines: [] };
+  runs = [];
+  icons = [];
+  measure;
+  options;
+  /** Whether the last layout was on whole pixels. */
+  snapped = !1;
+  constructor(t, h) {
+    super(), this.options = { ...h };
+    const s = h.font;
+    this.measure = {
+      textWidth: (i, o) => s.textWidth(i, o),
+      lineHeight: (i) => s.lineHeight(i),
+      ascent: (i) => s.ascent?.(i) ?? s.lineHeight(i) * 0.8,
+      iconSize: (i, o) => {
+        const r = h.textures?.get(i, o);
+        return r ? { width: r.orig.width, height: r.orig.height } : { width: 0, height: 0 };
+      }
+    }, this.source = t, this.relayout(), h.pixelPerfect === void 0 && this.on("added", () => this.pixelPerfect() !== this.snapped && this.relayout());
+  }
+  /** The markup shown. */
+  get markup() {
+    return this.source;
+  }
+  /** Where every line, run and icon was placed, for hit-testing a word or drawing behind one. */
+  get layout() {
+    return this.last;
+  }
+  /** Changes the text; the same markup again costs nothing. */
+  setText(t) {
+    return t === this.source ? this : (this.source = t, this.relayout(), this);
+  }
+  /** Wraps to a new width (undefined: only at `\n`). */
+  setWrapWidth(t) {
+    return t === this.options.wrapWidth ? this : (t === void 0 ? delete this.options.wrapWidth : this.options.wrapWidth = t, this.relayout(), this);
+  }
+  setAlign(t) {
+    return t === (this.options.align ?? "left") ? this : (this.options.align = t, this.relayout(), this);
+  }
+  /** Lays out and draws again: after the font's colours or the icons' textures were swapped under it. */
+  relayout() {
+    const t = this.snapped = this.pixelPerfect(), h = p(this.source, this.options);
+    this.last = d(h, this.measure, { ...this.options, pixelPerfect: t });
+    let s = 0, i = 0;
+    for (const l of this.last.lines)
+      for (const e of l.items) {
+        if (e.kind === "text") {
+          const u = this.runs[s] ?? this.addRun();
+          s++, this.options.font.updateRun(u, e.text, e.style), u.position.set(e.x, e.y), u.visible = !0;
+          continue;
+        }
+        if (!this.options.textures || e.width === 0) continue;
+        const n = this.icons[i] ?? this.addIcon();
+        i++, n.texture = this.options.textures.get(e.key, e.frame), n.position.set(e.x, e.y), n.setSize(e.width, e.height), n.visible = !0;
+      }
+    for (; s < this.runs.length; s++) this.runs[s].visible = !1;
+    for (; i < this.icons.length; i++) this.icons[i].visible = !1;
+    const o = this.boxW, r = this.boxH;
+    this.boxW = Math.ceil(this.last.width), this.boxH = Math.ceil(this.last.height), (this.boxW !== o || this.boxH !== r) && this.notifyResized();
+  }
+  destroy(t) {
+    super.destroy(typeof t == "object" ? { ...t, children: !0, texture: !1 } : { children: !0 });
+  }
+  redraw() {
+    this.alpha = this.enabled ? 1 : 0.5;
+  }
+  pixelPerfect() {
+    return this.options.pixelPerfect ?? this.host?.pixelPerfect ?? !1;
+  }
+  addRun() {
+    const t = this.options.font.createRun();
+    return this.runs.push(t), this.addChild(t), t;
+  }
+  addIcon() {
+    const t = new a();
+    return t.roundPixels = !0, this.icons.push(t), this.addChild(t), t;
+  }
+}
+export {
+  b as RichText
+};