@woosh/meep-engine 3.14.2 → 3.14.3

package/src/format/texture/basis/transcode_uastc.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Every format {@link transcode_uastc} can write, best first.
+ *
+ * BC5 is not "worse" than BC7 — it is two channels instead of four, and which is wanted depends on
+ * the texture's role. It is last here because this order is the default for content that said
+ * nothing, and a caller that knows it holds a normal map asks for BC5 by name.
+ *
+ * @returns {TextureFormat[]}
+ */
+export function transcode_uastc_formats(): TextureFormat[];
+/**
+ * Transcode a Basis Universal UASTC payload into texels a device can sample.
+ *
+ * **The other Basis encoding, and the one high-quality content uses.** ETC1S trades quality for size
+ * and is what a colour texture ships as when size dominates; UASTC is four times the size and close
+ * to ASTC in quality, which is what a **normal map** needs — ETC1S bands visibly on one, because its
+ * four colours per block lie on a line through the grey axis and a normal's channels do not.
+ * `gltf-transform uastc` and `toktx --uastc` are what produce it.
+ *
+ * The same contract as {@link transcode_basis}: bytes in, texels out, no device and no queue. The
+ * two are separate functions rather than one with a flag because they share nothing below the
+ * container — different bitstreams, different tables, different block structure.
+ *
+ * @param {BasisUastcPayload} payload
+ * @param {TextureFormat} target_format
+ * @returns {TexelPayload}
+ * @throws {Error} naming the format, for a target this cannot write
+ *
+ * @see the UASTC LDR 4x4 specification
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function transcode_uastc(payload: BasisUastcPayload, target_format: TextureFormat): TexelPayload;
+/**
+ * What a container hands the transcoder: UASTC blocks, one array per mip level.
+ *
+ * Simpler than {@link BasisEtc1sPayload } because UASTC has no global data — every block stands
+ * alone, which is the trade it makes for being four times the size and much higher quality.
+ */
+export type BasisUastcPayload = {
+    /**
+     * texels, base level
+     */
+    width: number;
+    /**
+     * texels, base level
+     */
+    height: number;
+    /**
+     * blocks, one entry per mip level, base first
+     */
+    levels: Uint8Array[];
+};
+import { TextureFormat } from "../../../shade/descriptor/texture/format/TextureFormat.js";
+//# sourceMappingURL=transcode_uastc.d.ts.map

package/src/format/texture/basis/transcode_uastc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcode_uastc.d.ts","sourceRoot":"","sources":["../../../../../src/format/texture/basis/transcode_uastc.js"],"names":[],"mappings":"AA4CA;;;;;;;;GAQG;AACH,2CAFa,aAAa,EAAE,CAI3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,yCATW,iBAAiB,iBACjB,aAAa,GACX,YAAY,CA4CxB;;;;;;;;;;;WA7Fa,MAAM;;;;YACN,MAAM;;;;YACN,UAAU,EAAE;;8BAzBI,2DAA2D"}

package/src/format/texture/basis/transcode_uastc.js

@@ -0,0 +1,117 @@
+import { TextureFormat } from "../../../shade/descriptor/texture/format/TextureFormat.js";
+import { uastc_to_astc } from "./uastc/uastc_to_astc.js";
+import { uastc_to_rgba8 } from "./uastc/uastc_to_rgba8.js";
+import { texture_mip_size } from "../../../shade/util/texture_mip_extent.js";
+import { UASTC_BLOCK_BYTES } from "./uastc/uastc_decode_block.js";
+import { uastc_to_bc5 } from "./uastc/uastc_to_bc5.js";
+import { uastc_to_bc7 } from "./uastc/uastc_to_bc7.js";
+
+/**
+ * Texels a UASTC block covers, in each direction.
+ *
+ * @readonly
+ * @type {number}
+ */
+const UASTC_BLOCK_SIZE = 4;
+
+/**
+ * What a container hands the transcoder: UASTC blocks, one array per mip level.
+ *
+ * Simpler than {@link BasisEtc1sPayload} because UASTC has no global data — every block stands
+ * alone, which is the trade it makes for being four times the size and much higher quality.
+ *
+ * @typedef {object} BasisUastcPayload
+ * @property {number} width texels, base level
+ * @property {number} height texels, base level
+ * @property {Uint8Array[]} levels blocks, one entry per mip level, base first
+ */
+
+/**
+ * Which formats this writes, and what writes each.
+ *
+ * @readonly
+ * @type {Object<TextureFormat, Function>}
+ */
+const TARGETS = {
+    [TextureFormat.BC7_RGBA_UNORM]: uastc_to_bc7,
+    [TextureFormat.BC7_RGBA_UNORM_SRGB]: uastc_to_bc7,
+    [TextureFormat.ASTC_4X4_UNORM]: uastc_to_astc,
+    [TextureFormat.ASTC_4X4_UNORM_SRGB]: uastc_to_astc,
+    [TextureFormat.BC5_RG_UNORM]: uastc_to_bc5,
+    [TextureFormat.RGBA8UNORM]: uastc_to_rgba8,
+    [TextureFormat.RGBA8UNORM_SRGB]: uastc_to_rgba8,
+};
+
+/**
+ * Every format {@link transcode_uastc} can write, best first.
+ *
+ * BC5 is not "worse" than BC7 — it is two channels instead of four, and which is wanted depends on
+ * the texture's role. It is last here because this order is the default for content that said
+ * nothing, and a caller that knows it holds a normal map asks for BC5 by name.
+ *
+ * @returns {TextureFormat[]}
+ */
+export function transcode_uastc_formats() {
+    return [TextureFormat.BC7_RGBA_UNORM, TextureFormat.BC5_RG_UNORM, TextureFormat.ASTC_4X4_UNORM, TextureFormat.RGBA8UNORM];
+}
+
+/**
+ * Transcode a Basis Universal UASTC payload into texels a device can sample.
+ *
+ * **The other Basis encoding, and the one high-quality content uses.** ETC1S trades quality for size
+ * and is what a colour texture ships as when size dominates; UASTC is four times the size and close
+ * to ASTC in quality, which is what a **normal map** needs — ETC1S bands visibly on one, because its
+ * four colours per block lie on a line through the grey axis and a normal's channels do not.
+ * `gltf-transform uastc` and `toktx --uastc` are what produce it.
+ *
+ * The same contract as {@link transcode_basis}: bytes in, texels out, no device and no queue. The
+ * two are separate functions rather than one with a flag because they share nothing below the
+ * container — different bitstreams, different tables, different block structure.
+ *
+ * @param {BasisUastcPayload} payload
+ * @param {TextureFormat} target_format
+ * @returns {TexelPayload}
+ * @throws {Error} naming the format, for a target this cannot write
+ *
+ * @see the UASTC LDR 4x4 specification
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function transcode_uastc(payload, target_format) {
+    const write = TARGETS[target_format];
+
+    if (write === undefined) {
+        throw new Error(
+            `UASTC: '${target_format}' is not a format this transcoder writes. It writes`
+            + ` ${Object.keys(TARGETS).map(name => `'${name}'`).join(", ")}.`
+        );
+    }
+
+    const levels = payload.levels.map((blocks, level) => {
+        const width = texture_mip_size(payload.width, level);
+        const height = texture_mip_size(payload.height, level);
+
+        const block_count = Math.ceil(width / UASTC_BLOCK_SIZE)
+            * Math.ceil(height / UASTC_BLOCK_SIZE);
+
+        if (blocks.byteLength !== block_count * UASTC_BLOCK_BYTES) {
+            throw new Error(
+                `UASTC: level ${level} of a ${payload.width}x${payload.height} texture should hold`
+                + ` ${block_count} blocks of ${UASTC_BLOCK_BYTES} bytes, and holds`
+                + ` ${blocks.byteLength} bytes`
+            );
+        }
+
+        return write(blocks, block_count, width, height);
+    });
+
+    return {
+        format: target_format,
+        width: payload.width,
+        height: payload.height,
+        depth: 1,
+        layers: 1,
+        faces: 1,
+        levels
+    };
+}

package/src/format/texture/basis/uastc/bc7_tables.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Which of UASTC's two subsets a BC7 three-subset index belongs to, under one of the six folds.
+ *
+ * @param {number} subset BC7's, `0` to `2`
+ * @param {number} fold
+ * @returns {number} UASTC's, `0` or `1`
+ */
+export function bc7_fold_subset_3_to_2(subset: number, fold: number): number;
+/**
+ * BC7's own partition and anchor tables, and how UASTC's patterns map onto them.
+ *
+ * **Two specifications meet here.** The partition and anchor tables are BC7's, transcribed from the
+ * BPTC specification; the three mapping tables are UASTC's, which name for each of its patterns the
+ * BC7 pattern that draws the same subsets and how the two number them differently.
+ *
+ * They are checked against each other by `bc7_tables.spec.js` rather than trusted: for every UASTC
+ * pattern, applying the stated relabelling to BC7's own pattern must reproduce UASTC's texel for
+ * texel. That check is what makes a transcription error here impossible to miss, and it passes for
+ * all sixty patterns.
+ *
+ * @see the BPTC specification (ARB_texture_compression_bptc), tables P2, P3, A2, A3a and A3b
+ * @see the UASTC LDR 4x4 specification, "Partition Pattern Table" sections
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+/**
+ * BC7's two-subset partitions: one subset index per texel, sixty-four patterns of sixteen.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_PARTITIONS_2: Uint8Array;
+/**
+ * BC7's three-subset partitions.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_PARTITIONS_3: Uint8Array;
+/**
+ * The texel whose index is stored a bit short for the second subset of a two-subset partition.
+ *
+ * Subset zero's anchor is always texel zero, so only the others are tabulated. The anchor is *not*
+ * the first texel of its subset — BC7 chose these positions for the encoder's benefit and a decoder
+ * has to read them from the table.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_ANCHOR_2: Uint8Array;
+/**
+ * The same for the second subset of a three-subset partition.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_ANCHOR_3_SECOND: Uint8Array;
+/**
+ * The same for the third subset of a three-subset partition.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_ANCHOR_3_THIRD: Uint8Array;
+/**
+ * For each UASTC two-subset pattern, the BC7 pattern drawing the same shape.
+ *
+ * `invert` says the two number their subsets oppositely, so a UASTC subset `s` is BC7's `1 - s`.
+ *
+ * @readonly
+ * @type {{bc7: number, invert: boolean}[]}
+ */
+export const UASTC_TO_BC7_2: {
+    bc7: number;
+    invert: boolean;
+}[];
+/**
+ * For each UASTC three-subset pattern, the BC7 pattern and which relabelling of the three subsets
+ * takes UASTC's numbering to BC7's.
+ *
+ * @readonly
+ * @type {{bc7: number, permutation: number}[]}
+ */
+export const UASTC_TO_BC7_3: {
+    bc7: number;
+    permutation: number;
+}[];
+/**
+ * The relabellings {@link UASTC_TO_BC7_3} refers to: entry `p` of a row is the BC7 subset that
+ * UASTC's subset `p` becomes.
+ *
+ * @readonly
+ * @type {number[][]}
+ */
+export const SUBSET_PERMUTATIONS: number[][];
+/**
+ * For each of mode 7's patterns, the BC7 *three*-subset pattern to use and the rule folding its
+ * three subsets back down to UASTC's two.
+ *
+ * Mode 7 is the odd one: two subsets in UASTC and three in BC7, which works because two of BC7's
+ * three endpoint pairs are written identically. `fold` is the rule, applied by
+ * {@link bc7_fold_subset_3_to_2}.
+ *
+ * @readonly
+ * @type {{bc7: number, fold: number}[]}
+ */
+export const UASTC_TO_BC7_2_VIA_3: {
+    bc7: number;
+    fold: number;
+}[];
+//# sourceMappingURL=bc7_tables.d.ts.map

package/src/format/texture/basis/uastc/bc7_tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bc7_tables.d.ts","sourceRoot":"","sources":["../../../../../../src/format/texture/basis/uastc/bc7_tables.js"],"names":[],"mappings":"AA2PA;;;;;;GAMG;AACH,+CAJW,MAAM,QACN,MAAM,GACJ,MAAM,CAmBlB;AAnRD;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;GAKG;AACH,+BAFU,UAAU,CAmCjB;AAEH;;;;;GAKG;AACH,+BAFU,UAAU,CAmCjB;AAEH;;;;;;;;;GASG;AACH,2BAFU,UAAU,CAMjB;AAEH;;;;;GAKG;AACH,kCAFU,UAAU,CAMjB;AAEH;;;;;GAKG;AACH,iCAFU,UAAU,CAMjB;AAEH;;;;;;;GAOG;AACH,6BAFU;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAC,EAAE,CAiCxC;AAEF;;;;;;GAMG;AACH,6BAFU;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAC,EAAE,CAc5C;AAEF;;;;;;GAMG;AACH,kCAFU,MAAM,EAAE,EAAE,CASlB;AAEF;;;;;;;;;;GAUG;AACH,mCAFU;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,EAAE,CAsBrC"}

package/src/format/texture/basis/uastc/bc7_tables.js

@@ -0,0 +1,276 @@
+/**
+ * BC7's own partition and anchor tables, and how UASTC's patterns map onto them.
+ *
+ * **Two specifications meet here.** The partition and anchor tables are BC7's, transcribed from the
+ * BPTC specification; the three mapping tables are UASTC's, which name for each of its patterns the
+ * BC7 pattern that draws the same subsets and how the two number them differently.
+ *
+ * They are checked against each other by `bc7_tables.spec.js` rather than trusted: for every UASTC
+ * pattern, applying the stated relabelling to BC7's own pattern must reproduce UASTC's texel for
+ * texel. That check is what makes a transcription error here impossible to miss, and it passes for
+ * all sixty patterns.
+ *
+ * @see the BPTC specification (ARB_texture_compression_bptc), tables P2, P3, A2, A3a and A3b
+ * @see the UASTC LDR 4x4 specification, "Partition Pattern Table" sections
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+
+/**
+ * BC7's two-subset partitions: one subset index per texel, sixty-four patterns of sixteen.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_PARTITIONS_2 = new Uint8Array([
+    0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1,
+    0, 1, 1, 1, 0, 1, 1, 1, 0, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 1, 1, 1,
+    0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1,
+    0, 0, 0, 1, 0, 0, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 1, 1, 0, 1, 1, 1,
+    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    0, 0, 0, 0, 0, 0, 0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 1, 1, 1,
+    0, 0, 0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,
+    0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1,
+    0, 0, 0, 0, 1, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0,
+    0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 1, 1, 1, 0, 0, 1, 1, 1, 0, 0, 1, 1, 0, 0, 0, 1, 0, 0, 0, 0,
+    0, 0, 1, 1, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 1, 1, 0, 0, 1, 1, 1, 0,
+    0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 1, 1, 0, 0, 0, 1, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 0, 1,
+    0, 0, 1, 1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1, 1, 0, 0,
+    0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 0, 1, 1, 0, 0,
+    0, 0, 0, 1, 0, 1, 1, 1, 1, 1, 1, 0, 1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0,
+    0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 0, 1, 1, 1, 0, 0, 0, 1, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0,
+    0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1,
+    0, 1, 0, 1, 1, 0, 1, 0, 0, 1, 0, 1, 1, 0, 1, 0, 0, 0, 1, 1, 0, 0, 1, 1, 1, 1, 0, 0, 1, 1, 0, 0,
+    0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 1, 0, 1, 0, 1, 0, 1, 1, 0, 1, 0, 1, 0, 1, 0,
+    0, 1, 1, 0, 1, 0, 0, 1, 0, 1, 1, 0, 1, 0, 0, 1, 0, 1, 0, 1, 1, 0, 1, 0, 1, 0, 1, 0, 0, 1, 0, 1,
+    0, 1, 1, 1, 0, 0, 1, 1, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 0, 0, 1, 1, 1, 1, 0, 0, 1, 0, 0, 0,
+    0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1, 1, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0,
+    0, 1, 1, 0, 1, 0, 0, 1, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 1, 1, 1, 1, 0, 0, 1, 1, 0, 0, 0, 0, 1, 1,
+    0, 1, 1, 0, 0, 1, 1, 0, 1, 0, 0, 1, 1, 0, 0, 1, 0, 0, 0, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 0, 0, 0,
+    0, 1, 0, 0, 1, 1, 1, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 1, 1, 1, 0, 0, 1, 0, 0, 0, 0, 0,
+    0, 0, 0, 0, 0, 0, 1, 0, 0, 1, 1, 1, 0, 0, 1, 0, 0, 0, 0, 0, 0, 1, 0, 0, 1, 1, 1, 0, 0, 1, 0, 0,
+    0, 1, 1, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 0, 0, 1,
+    0, 1, 1, 0, 0, 0, 1, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0,
+    0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 1,
+    0, 1, 1, 1, 1, 1, 1, 0, 1, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 1, 1, 0, 0, 0, 1, 1, 1, 0, 0, 1, 1, 1,
+    0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0,
+    0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 1, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1,
+]);
+
+/**
+ * BC7's three-subset partitions.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_PARTITIONS_3 = new Uint8Array([
+    0, 0, 1, 1, 0, 0, 1, 1, 0, 2, 2, 1, 2, 2, 2, 2, 0, 0, 0, 1, 0, 0, 1, 1, 2, 2, 1, 1, 2, 2, 2, 1,
+    0, 0, 0, 0, 2, 0, 0, 1, 2, 2, 1, 1, 2, 2, 1, 1, 0, 2, 2, 2, 0, 0, 2, 2, 0, 0, 1, 1, 0, 1, 1, 1,
+    0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 2, 2, 1, 1, 2, 2, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 2, 2, 0, 0, 2, 2,
+    0, 0, 2, 2, 0, 0, 2, 2, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 2, 2, 1, 1, 2, 2, 1, 1,
+    0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 2, 2, 2, 2,
+    0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 2, 0, 0, 1, 2, 0, 0, 1, 2, 0, 0, 1, 2, 0, 0, 1, 2,
+    0, 1, 1, 2, 0, 1, 1, 2, 0, 1, 1, 2, 0, 1, 1, 2, 0, 1, 2, 2, 0, 1, 2, 2, 0, 1, 2, 2, 0, 1, 2, 2,
+    0, 0, 1, 1, 0, 1, 1, 2, 1, 1, 2, 2, 1, 2, 2, 2, 0, 0, 1, 1, 2, 0, 0, 1, 2, 2, 0, 0, 2, 2, 2, 0,
+    0, 0, 0, 1, 0, 0, 1, 1, 0, 1, 1, 2, 1, 1, 2, 2, 0, 1, 1, 1, 0, 0, 1, 1, 2, 0, 0, 1, 2, 2, 0, 0,
+    0, 0, 0, 0, 1, 1, 2, 2, 1, 1, 2, 2, 1, 1, 2, 2, 0, 0, 2, 2, 0, 0, 2, 2, 0, 0, 2, 2, 1, 1, 1, 1,
+    0, 1, 1, 1, 0, 1, 1, 1, 0, 2, 2, 2, 0, 2, 2, 2, 0, 0, 0, 1, 0, 0, 0, 1, 2, 2, 2, 1, 2, 2, 2, 1,
+    0, 0, 0, 0, 0, 0, 1, 1, 0, 1, 2, 2, 0, 1, 2, 2, 0, 0, 0, 0, 1, 1, 0, 0, 2, 2, 1, 0, 2, 2, 1, 0,
+    0, 1, 2, 2, 0, 1, 2, 2, 0, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 2, 0, 0, 1, 2, 1, 1, 2, 2, 2, 2, 2, 2,
+    0, 1, 1, 0, 1, 2, 2, 1, 1, 2, 2, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 0, 1, 2, 2, 1, 1, 2, 2, 1,
+    0, 0, 2, 2, 1, 1, 0, 2, 1, 1, 0, 2, 0, 0, 2, 2, 0, 1, 1, 0, 0, 1, 1, 0, 2, 0, 0, 2, 2, 2, 2, 2,
+    0, 0, 1, 1, 0, 1, 2, 2, 0, 1, 2, 2, 0, 0, 1, 1, 0, 0, 0, 0, 2, 0, 0, 0, 2, 2, 1, 1, 2, 2, 2, 1,
+    0, 0, 0, 0, 0, 0, 0, 2, 1, 1, 2, 2, 1, 2, 2, 2, 0, 2, 2, 2, 0, 0, 2, 2, 0, 0, 1, 2, 0, 0, 1, 1,
+    0, 0, 1, 1, 0, 0, 1, 2, 0, 0, 2, 2, 0, 2, 2, 2, 0, 1, 2, 0, 0, 1, 2, 0, 0, 1, 2, 0, 0, 1, 2, 0,
+    0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 0, 0, 0, 0, 0, 1, 2, 0, 1, 2, 0, 1, 2, 0, 1, 2, 0, 1, 2, 0,
+    0, 1, 2, 0, 2, 0, 1, 2, 1, 2, 0, 1, 0, 1, 2, 0, 0, 0, 1, 1, 2, 2, 0, 0, 1, 1, 2, 2, 0, 0, 1, 1,
+    0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 1, 0, 1, 2, 2, 2, 2, 2, 2, 2, 2,
+    0, 0, 0, 0, 0, 0, 0, 0, 2, 1, 2, 1, 2, 1, 2, 1, 0, 0, 2, 2, 1, 1, 2, 2, 0, 0, 2, 2, 1, 1, 2, 2,
+    0, 0, 2, 2, 0, 0, 1, 1, 0, 0, 2, 2, 0, 0, 1, 1, 0, 2, 2, 0, 1, 2, 2, 1, 0, 2, 2, 0, 1, 2, 2, 1,
+    0, 1, 0, 1, 2, 2, 2, 2, 2, 2, 2, 2, 0, 1, 0, 1, 0, 0, 0, 0, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1,
+    0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 2, 2, 2, 2, 0, 2, 2, 2, 0, 1, 1, 1, 0, 2, 2, 2, 0, 1, 1, 1,
+    0, 0, 0, 2, 1, 1, 1, 2, 0, 0, 0, 2, 1, 1, 1, 2, 0, 0, 0, 0, 2, 1, 1, 2, 2, 1, 1, 2, 2, 1, 1, 2,
+    0, 2, 2, 2, 0, 1, 1, 1, 0, 1, 1, 1, 0, 2, 2, 2, 0, 0, 0, 2, 1, 1, 1, 2, 1, 1, 1, 2, 0, 0, 0, 2,
+    0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 2, 2, 2, 2, 0, 0, 0, 0, 0, 0, 0, 0, 2, 1, 1, 2, 2, 1, 1, 2,
+    0, 1, 1, 0, 0, 1, 1, 0, 2, 2, 2, 2, 2, 2, 2, 2, 0, 0, 2, 2, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 2, 2,
+    0, 0, 2, 2, 1, 1, 2, 2, 1, 1, 2, 2, 0, 0, 2, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 1, 1, 2,
+    0, 0, 0, 2, 0, 0, 0, 1, 0, 0, 0, 2, 0, 0, 0, 1, 0, 2, 2, 2, 1, 2, 2, 2, 0, 2, 2, 2, 1, 2, 2, 2,
+    0, 1, 0, 1, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 0, 1, 1, 1, 2, 0, 1, 1, 2, 2, 0, 1, 2, 2, 2, 0,
+]);
+
+/**
+ * The texel whose index is stored a bit short for the second subset of a two-subset partition.
+ *
+ * Subset zero's anchor is always texel zero, so only the others are tabulated. The anchor is *not*
+ * the first texel of its subset — BC7 chose these positions for the encoder's benefit and a decoder
+ * has to read them from the table.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_ANCHOR_2 = new Uint8Array([
+    15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 2, 8, 2, 2, 8, 8, 15, 2, 8,
+    2, 2, 8, 8, 2, 2, 15, 15, 6, 8, 2, 8, 15, 15, 2, 8, 2, 2, 2, 15, 15, 6, 6, 2, 6, 8, 15, 15, 2,
+    2, 15, 15, 15, 15, 15, 2, 2, 15,
+]);
+
+/**
+ * The same for the second subset of a three-subset partition.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_ANCHOR_3_SECOND = new Uint8Array([
+    3, 3, 15, 15, 8, 3, 15, 15, 8, 8, 6, 6, 6, 5, 3, 3, 3, 3, 8, 15, 3, 3, 6, 10, 5, 8, 8, 6, 8, 5,
+    15, 15, 8, 15, 3, 5, 6, 10, 8, 15, 15, 3, 15, 5, 15, 15, 15, 15, 3, 15, 5, 5, 5, 8, 5, 10, 5,
+    10, 8, 13, 15, 12, 3, 3,
+]);
+
+/**
+ * The same for the third subset of a three-subset partition.
+ *
+ * @readonly
+ * @type {Uint8Array}
+ */
+export const BC7_ANCHOR_3_THIRD = new Uint8Array([
+    15, 8, 8, 3, 15, 15, 3, 8, 15, 15, 15, 15, 15, 15, 15, 8, 15, 8, 15, 3, 15, 8, 15, 8, 3, 15, 6,
+    10, 15, 15, 10, 8, 15, 3, 15, 10, 10, 8, 9, 10, 6, 15, 8, 15, 3, 6, 6, 8, 15, 3, 15, 15, 15,
+    15, 15, 15, 15, 15, 15, 15, 3, 15, 15, 8,
+]);
+
+/**
+ * For each UASTC two-subset pattern, the BC7 pattern drawing the same shape.
+ *
+ * `invert` says the two number their subsets oppositely, so a UASTC subset `s` is BC7's `1 - s`.
+ *
+ * @readonly
+ * @type {{bc7: number, invert: boolean}[]}
+ */
+export const UASTC_TO_BC7_2 = [
+    { bc7: 0, invert: false },
+    { bc7: 1, invert: false },
+    { bc7: 2, invert: true },
+    { bc7: 3, invert: false },
+    { bc7: 4, invert: true },
+    { bc7: 5, invert: false },
+    { bc7: 6, invert: true },
+    { bc7: 7, invert: true },
+    { bc7: 8, invert: false },
+    { bc7: 9, invert: true },
+    { bc7: 10, invert: false },
+    { bc7: 11, invert: true },
+    { bc7: 12, invert: true },
+    { bc7: 13, invert: true },
+    { bc7: 14, invert: false },
+    { bc7: 15, invert: true },
+    { bc7: 17, invert: true },
+    { bc7: 18, invert: true },
+    { bc7: 19, invert: false },
+    { bc7: 20, invert: false },
+    { bc7: 21, invert: false },
+    { bc7: 22, invert: true },
+    { bc7: 23, invert: true },
+    { bc7: 24, invert: false },
+    { bc7: 25, invert: true },
+    { bc7: 26, invert: false },
+    { bc7: 29, invert: true },
+    { bc7: 32, invert: true },
+    { bc7: 33, invert: true },
+    { bc7: 52, invert: true },
+];
+
+/**
+ * For each UASTC three-subset pattern, the BC7 pattern and which relabelling of the three subsets
+ * takes UASTC's numbering to BC7's.
+ *
+ * @readonly
+ * @type {{bc7: number, permutation: number}[]}
+ */
+export const UASTC_TO_BC7_3 = [
+    { bc7: 4, permutation: 0 },
+    { bc7: 8, permutation: 5 },
+    { bc7: 9, permutation: 5 },
+    { bc7: 10, permutation: 2 },
+    { bc7: 11, permutation: 2 },
+    { bc7: 12, permutation: 0 },
+    { bc7: 13, permutation: 4 },
+    { bc7: 20, permutation: 1 },
+    { bc7: 35, permutation: 1 },
+    { bc7: 36, permutation: 5 },
+    { bc7: 57, permutation: 0 },
+];
+
+/**
+ * The relabellings {@link UASTC_TO_BC7_3} refers to: entry `p` of a row is the BC7 subset that
+ * UASTC's subset `p` becomes.
+ *
+ * @readonly
+ * @type {number[][]}
+ */
+export const SUBSET_PERMUTATIONS = [
+    [0, 1, 2],
+    [1, 2, 0],
+    [2, 0, 1],
+    [2, 1, 0],
+    [0, 2, 1],
+    [1, 0, 2],
+];
+
+/**
+ * For each of mode 7's patterns, the BC7 *three*-subset pattern to use and the rule folding its
+ * three subsets back down to UASTC's two.
+ *
+ * Mode 7 is the odd one: two subsets in UASTC and three in BC7, which works because two of BC7's
+ * three endpoint pairs are written identically. `fold` is the rule, applied by
+ * {@link bc7_fold_subset_3_to_2}.
+ *
+ * @readonly
+ * @type {{bc7: number, fold: number}[]}
+ */
+export const UASTC_TO_BC7_2_VIA_3 = [
+    { bc7: 10, fold: 4 },
+    { bc7: 11, fold: 4 },
+    { bc7: 0, fold: 3 },
+    { bc7: 2, fold: 4 },
+    { bc7: 8, fold: 5 },
+    { bc7: 13, fold: 4 },
+    { bc7: 1, fold: 2 },
+    { bc7: 33, fold: 2 },
+    { bc7: 40, fold: 3 },
+    { bc7: 20, fold: 4 },
+    { bc7: 21, fold: 0 },
+    { bc7: 58, fold: 3 },
+    { bc7: 3, fold: 0 },
+    { bc7: 32, fold: 2 },
+    { bc7: 59, fold: 1 },
+    { bc7: 34, fold: 3 },
+    { bc7: 20, fold: 1 },
+    { bc7: 14, fold: 4 },
+    { bc7: 31, fold: 3 },
+];
+
+/**
+ * Which of UASTC's two subsets a BC7 three-subset index belongs to, under one of the six folds.
+ *
+ * @param {number} subset BC7's, `0` to `2`
+ * @param {number} fold
+ * @returns {number} UASTC's, `0` or `1`
+ */
+export function bc7_fold_subset_3_to_2(subset, fold) {
+    let folded;
+
+    switch (fold >> 1) {
+        case 0:
+            folded = subset <= 1 ? 0 : 1;
+            break;
+        case 1:
+            folded = subset === 0 ? 0 : 1;
+            break;
+        default:
+            folded = (subset === 0 || subset === 2) ? 0 : 1;
+            break;
+    }
+
+    // the low bit of the fold swaps the two
+    return (fold & 1) ? 1 - folded : folded;
+}