@three-flatland/normals 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/bake.js

@@ -1,123 +1,158 @@
-import {
-  DEFAULT_BUMP,
-  DEFAULT_PITCH,
-  DEFAULT_STRENGTH,
-  resolveRegion
-} from "./descriptor.js";
+import { DEFAULT_BUMP, DEFAULT_PITCH, resolveRegion } from "./descriptor.js";
+//#region src/bake.ts
+/**
+* Produce a tangent-space normal map from source pixels + a descriptor.
+*
+* Cross-platform: browser + node. No filesystem, no pngjs. Used by
+* the CLI baker (wrapped with file I/O) and the runtime loader
+* (called directly on decoded image pixels).
+*
+* Per texel in each region:
+*   1. `bump: 'alpha'` — central-difference gradient on the source
+*      alpha channel, clamped to the region bounds so adjacent regions
+*      (e.g. atlas cells) can't bleed into each other.
+*   2. Compose with a tilt rotation that takes `+Z` to the region's
+*      `direction` at `pitch` radians.
+*   3. Normalize and encode to `rgb = normal * 0.5 + 0.5`. Alpha is
+*      copied from the source so the baked map carries its own
+*      silhouette.
+*
+* Texels outside every region receive the flat normal `(0, 0, 1)`
+* with the source's alpha — safe default for sparse descriptors.
+*
+* @param pixels    RGBA pixel buffer, row-major, 4 bytes per pixel.
+* @param width     Pixel width.
+* @param height    Pixel height.
+* @param descriptor Region / tilt / bump control. Defaults to a single
+*                   whole-texture flat region with alpha-derived bump.
+* @returns RGBA pixel buffer containing the encoded normal map.
+*/
 function bakeNormalMap(pixels, width, height, descriptor = {}) {
-  const out = new Uint8Array(pixels.length);
-  for (let i = 0; i < pixels.length; i += 4) {
-    out[i] = 128;
-    out[i + 1] = 128;
-    out[i + 2] = 0;
-    out[i + 3] = pixels[i + 3];
-  }
-  const regions = descriptor.regions && descriptor.regions.length > 0 ? descriptor.regions : [{ x: 0, y: 0, w: width, h: height }];
-  for (const region of regions) {
-    const resolved = resolveRegion(region, descriptor);
-    bakeRegion(pixels, out, width, resolved);
-  }
-  return out;
+	const out = new Uint8Array(pixels.length);
+	for (let i = 0; i < pixels.length; i += 4) {
+		out[i] = 128;
+		out[i + 1] = 128;
+		out[i + 2] = 0;
+		out[i + 3] = pixels[i + 3];
+	}
+	const regions = descriptor.regions && descriptor.regions.length > 0 ? descriptor.regions : [{
+		x: 0,
+		y: 0,
+		w: width,
+		h: height
+	}];
+	for (const region of regions) bakeRegion(pixels, out, width, resolveRegion(region, descriptor));
+	return out;
 }
+/**
+* Bake a single region into the output buffer. Region-local alpha
+* clamping prevents cross-region gradient bleed.
+*/
 function bakeRegion(pixels, out, width, region) {
-  const x0 = region.x;
-  const y0 = region.y;
-  const x1 = region.x + region.w;
-  const y1 = region.y + region.h;
-  const strength = region.strength;
-  const bumpMode = region.bump;
-  const bumpChannel = bumpMode === "alpha" ? 3 : bumpMode === "red" ? 0 : bumpMode === "green" ? 1 : bumpMode === "blue" ? 2 : -1;
-  const useLuminance = bumpMode === "luminance";
-  const useBump = bumpChannel >= 0 || useLuminance;
-  let r00 = 1, r01 = 0, r02 = 0;
-  let r10 = 0, r11 = 1, r12 = 0;
-  let r20 = 0, r21 = 0, r22 = 1;
-  const hasTilt = region.angle !== null;
-  if (hasTilt) {
-    const theta = region.angle;
-    const pitch = region.pitch;
-    const ax = -Math.sin(theta);
-    const ay = Math.cos(theta);
-    const c = Math.cos(pitch);
-    const s = Math.sin(pitch);
-    const t = 1 - c;
-    r00 = c + ax * ax * t;
-    r01 = ax * ay * t;
-    r02 = ay * s;
-    r10 = ay * ax * t;
-    r11 = c + ay * ay * t;
-    r12 = -ax * s;
-    r20 = -ay * s;
-    r21 = ax * s;
-    r22 = c;
-  }
-  const heightAt = (x, y) => {
-    const cx = x < x0 ? x0 : x >= x1 ? x1 - 1 : x;
-    const cy = y < y0 ? y0 : y >= y1 ? y1 - 1 : y;
-    const base = (cy * width + cx) * 4;
-    if (useLuminance) {
-      return (0.2126 * pixels[base] + 0.7152 * pixels[base + 1] + 0.0722 * pixels[base + 2]) / 255;
-    }
-    return pixels[base + bumpChannel] / 255;
-  };
-  for (let y = y0; y < y1; y++) {
-    for (let x = x0; x < x1; x++) {
-      const idx = (y * width + x) * 4;
-      let lx;
-      let ly;
-      let lz;
-      if (useBump) {
-        const hL = heightAt(x - 1, y);
-        const hR = heightAt(x + 1, y);
-        const hD = heightAt(x, y - 1);
-        const hU = heightAt(x, y + 1);
-        const dx = (hR - hL) * strength;
-        const dy = (hU - hD) * strength;
-        lx = -dx;
-        ly = -dy;
-        lz = 1;
-      } else {
-        lx = 0;
-        ly = 0;
-        lz = 1;
-      }
-      let nx;
-      let ny;
-      let nz;
-      if (hasTilt) {
-        nx = r00 * lx + r01 * ly + r02 * lz;
-        ny = r10 * lx + r11 * ly + r12 * lz;
-        nz = r20 * lx + r21 * ly + r22 * lz;
-      } else {
-        nx = lx;
-        ny = ly;
-        nz = lz;
-      }
-      const len = Math.hypot(nx, ny, nz);
-      nx /= len;
-      ny /= len;
-      nz /= len;
-      out[idx] = Math.round((nx * 0.5 + 0.5) * 255);
-      out[idx + 1] = Math.round((ny * 0.5 + 0.5) * 255);
-      out[idx + 2] = Math.round(region.elevation * 255);
-      out[idx + 3] = pixels[idx + 3];
-    }
-  }
+	const x0 = region.x;
+	const y0 = region.y;
+	const x1 = region.x + region.w;
+	const y1 = region.y + region.h;
+	const strength = region.strength;
+	const bumpMode = region.bump;
+	const bumpChannel = bumpMode === "alpha" ? 3 : bumpMode === "red" ? 0 : bumpMode === "green" ? 1 : bumpMode === "blue" ? 2 : -1;
+	const useLuminance = bumpMode === "luminance";
+	const useBump = bumpChannel >= 0 || useLuminance;
+	let r00 = 1, r01 = 0, r02 = 0;
+	let r10 = 0, r11 = 1, r12 = 0;
+	let r20 = 0, r21 = 0, r22 = 1;
+	const hasTilt = region.angle !== null;
+	if (hasTilt) {
+		const theta = region.angle;
+		const pitch = region.pitch;
+		const ax = -Math.sin(theta);
+		const ay = Math.cos(theta);
+		const c = Math.cos(pitch);
+		const s = Math.sin(pitch);
+		const t = 1 - c;
+		r00 = c + ax * ax * t;
+		r01 = ax * ay * t;
+		r02 = ay * s;
+		r10 = ay * ax * t;
+		r11 = c + ay * ay * t;
+		r12 = -ax * s;
+		r20 = -ay * s;
+		r21 = ax * s;
+		r22 = c;
+	}
+	const heightAt = (x, y) => {
+		const cx = x < x0 ? x0 : x >= x1 ? x1 - 1 : x;
+		const base = ((y < y0 ? y0 : y >= y1 ? y1 - 1 : y) * width + cx) * 4;
+		if (useLuminance) return (.2126 * pixels[base] + .7152 * pixels[base + 1] + .0722 * pixels[base + 2]) / 255;
+		return pixels[base + bumpChannel] / 255;
+	};
+	for (let y = y0; y < y1; y++) for (let x = x0; x < x1; x++) {
+		const idx = (y * width + x) * 4;
+		let lx;
+		let ly;
+		let lz;
+		if (useBump) {
+			const hL = heightAt(x - 1, y);
+			const hR = heightAt(x + 1, y);
+			const hD = heightAt(x, y - 1);
+			const hU = heightAt(x, y + 1);
+			const dx = (hR - hL) * strength;
+			const dy = (hU - hD) * strength;
+			lx = -dx;
+			ly = -dy;
+			lz = 1;
+		} else {
+			lx = 0;
+			ly = 0;
+			lz = 1;
+		}
+		let nx;
+		let ny;
+		let nz;
+		if (hasTilt) {
+			nx = r00 * lx + r01 * ly + r02 * lz;
+			ny = r10 * lx + r11 * ly + r12 * lz;
+			nz = r20 * lx + r21 * ly + r22 * lz;
+		} else {
+			nx = lx;
+			ny = ly;
+			nz = lz;
+		}
+		const len = Math.hypot(nx, ny, nz);
+		nx /= len;
+		ny /= len;
+		nz /= len;
+		out[idx] = Math.round((nx * .5 + .5) * 255);
+		out[idx + 1] = Math.round((ny * .5 + .5) * 255);
+		out[idx + 2] = Math.round(region.elevation * 255);
+		out[idx + 3] = pixels[idx + 3];
+	}
 }
+/**
+* Legacy back-compat wrapper. Use `bakeNormalMap(pixels, w, h, {
+* strength })` for equivalent behavior in new code.
+*
+* @deprecated
+*/
 function bakeNormalMapFromPixels(pixels, width, height, options = {}) {
-  const strength = options.strength ?? DEFAULT_STRENGTH;
-  return bakeNormalMap(pixels, width, height, {
-    strength,
-    bump: DEFAULT_BUMP,
-    pitch: DEFAULT_PITCH
-  });
+	return bakeNormalMap(pixels, width, height, {
+		strength: options.strength ?? 1,
+		bump: DEFAULT_BUMP,
+		pitch: DEFAULT_PITCH
+	});
 }
+/**
+* Derive the conventional `.normal.png` sibling URL for a sprite PNG.
+*
+* Runtime loaders call this to try the baked output before falling
+* back to the runtime TSL path.
+*
+* Pure string rewrite — browser-safe, no filesystem.
+*/
 function bakedNormalURL(spriteURL) {
-  return spriteURL.replace(/\.png($|[?#])/i, ".normal.png$1");
+	return spriteURL.replace(/\.png($|[?#])/i, ".normal.png$1");
 }
-export {
-  bakeNormalMap,
-  bakeNormalMapFromPixels,
-  bakedNormalURL
-};
+//#endregion
+export { bakeNormalMap, bakeNormalMapFromPixels, bakedNormalURL };
+
 //# sourceMappingURL=bake.js.map

package/dist/bake.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bake.ts"],"sourcesContent":["import {\n  DEFAULT_BUMP,\n  DEFAULT_PITCH,\n  DEFAULT_STRENGTH,\n  resolveRegion,\n  type NormalSourceDescriptor,\n  type ResolvedNormalRegion,\n} from './descriptor.js'\n\n/**\n * @deprecated — legacy flat-texture bake options. Use\n * `bakeNormalMap(pixels, w, h, descriptor)` for region-aware control.\n */\nexport interface BakeOptions {\n  /** Scales the alpha gradient before normalization. Default 1. */\n  strength?: number\n}\n\n/**\n * Produce a tangent-space normal map from source pixels + a descriptor.\n *\n * Cross-platform: browser + node. No filesystem, no pngjs. Used by\n * the CLI baker (wrapped with file I/O) and the runtime loader\n * (called directly on decoded image pixels).\n *\n * Per texel in each region:\n *   1. `bump: 'alpha'` — central-difference gradient on the source\n *      alpha channel, clamped to the region bounds so adjacent regions\n *      (e.g. atlas cells) can't bleed into each other.\n *   2. Compose with a tilt rotation that takes `+Z` to the region's\n *      `direction` at `pitch` radians.\n *   3. Normalize and encode to `rgb = normal * 0.5 + 0.5`. Alpha is\n *      copied from the source so the baked map carries its own\n *      silhouette.\n *\n * Texels outside every region receive the flat normal `(0, 0, 1)`\n * with the source's alpha — safe default for sparse descriptors.\n *\n * @param pixels    RGBA pixel buffer, row-major, 4 bytes per pixel.\n * @param width     Pixel width.\n * @param height    Pixel height.\n * @param descriptor Region / tilt / bump control. Defaults to a single\n *                   whole-texture flat region with alpha-derived bump.\n * @returns RGBA pixel buffer containing the encoded normal map.\n */\nexport function bakeNormalMap(\n  pixels: Uint8Array,\n  width: number,\n  height: number,\n  descriptor: NormalSourceDescriptor = {}\n): Uint8Array {\n  const out = new Uint8Array(pixels.length)\n\n  // Initialize every texel to flat-normal (nx=0, ny=0), elevation=0,\n  // source alpha. Runtime reconstructs nz = sqrt(1 − nx² − ny²) — a\n  // zero XY yields nz=1 (flat floor). Regions that cover texels will\n  // overwrite; texels outside any region keep this safe default.\n  //\n  // Encoding layout:\n  //   R = nx encoded as (nx * 0.5 + 0.5) * 255   (0.5 = 128)\n  //   G = ny encoded the same                     (0.5 = 128)\n  //   B = elevation in [0, 1] scaled to [0, 255]  (0 = ground default)\n  //   A = source alpha preserved\n  for (let i = 0; i < pixels.length; i += 4) {\n    out[i] = 128\n    out[i + 1] = 128\n    out[i + 2] = 0\n    out[i + 3] = pixels[i + 3]!\n  }\n\n  const regions =\n    descriptor.regions && descriptor.regions.length > 0\n      ? descriptor.regions\n      : [{ x: 0, y: 0, w: width, h: height }]\n\n  for (const region of regions) {\n    const resolved = resolveRegion(region, descriptor)\n    bakeRegion(pixels, out, width, resolved)\n  }\n\n  return out\n}\n\n/**\n * Bake a single region into the output buffer. Region-local alpha\n * clamping prevents cross-region gradient bleed.\n */\nfunction bakeRegion(\n  pixels: Uint8Array,\n  out: Uint8Array,\n  width: number,\n  region: ResolvedNormalRegion\n): void {\n  const x0 = region.x\n  const y0 = region.y\n  const x1 = region.x + region.w\n  const y1 = region.y + region.h\n  const strength = region.strength\n  // Index into the RGBA pixel run for the chosen height source, or -1\n  // for 'none'. 0 = R, 1 = G, 2 = B, 3 = A. Luminance needs all three\n  // RGB components and is handled separately below.\n  const bumpMode = region.bump\n  const bumpChannel =\n    bumpMode === 'alpha'\n      ? 3\n      : bumpMode === 'red'\n        ? 0\n        : bumpMode === 'green'\n          ? 1\n          : bumpMode === 'blue'\n            ? 2\n            : -1\n  const useLuminance = bumpMode === 'luminance'\n  const useBump = bumpChannel >= 0 || useLuminance\n\n  // Build the tilt rotation matrix (+Z → target direction at pitch).\n  // For direction angle θ, the tilt axis is perpendicular to the tilt\n  // direction in the XY plane: `axis = (-sin θ, cos θ, 0)`.\n  // Rodrigues' formula composes the rotation matrix from the axis\n  // and `pitch` radians.\n  let r00 = 1,\n    r01 = 0,\n    r02 = 0\n  let r10 = 0,\n    r11 = 1,\n    r12 = 0\n  let r20 = 0,\n    r21 = 0,\n    r22 = 1\n  const hasTilt = region.angle !== null\n  if (hasTilt) {\n    const theta = region.angle as number\n    const pitch = region.pitch\n    const ax = -Math.sin(theta)\n    const ay = Math.cos(theta)\n    const c = Math.cos(pitch)\n    const s = Math.sin(pitch)\n    const t = 1 - c\n    // Axis is in the XY plane (az = 0), so several Rodrigues terms drop out.\n    r00 = c + ax * ax * t\n    r01 = ax * ay * t\n    r02 = ay * s\n    r10 = ay * ax * t\n    r11 = c + ay * ay * t\n    r12 = -ax * s\n    r20 = -ay * s\n    r21 = ax * s\n    r22 = c\n  }\n\n  // Height sample for the chosen bump mode, clamped to region bounds\n  // so adjacent regions (e.g., atlas cells) can't bleed gradients into\n  // each other. Returns a value in [0, 1].\n  const heightAt = (x: number, y: number): number => {\n    const cx = x < x0 ? x0 : x >= x1 ? x1 - 1 : x\n    const cy = y < y0 ? y0 : y >= y1 ? y1 - 1 : y\n    const base = (cy * width + cx) * 4\n    if (useLuminance) {\n      // Rec. 709 luminance — matches perceptual brightness, so art\n      // authored against a monitor reads consistently.\n      return (\n        (0.2126 * pixels[base]! +\n          0.7152 * pixels[base + 1]! +\n          0.0722 * pixels[base + 2]!) /\n        255\n      )\n    }\n    return pixels[base + bumpChannel]! / 255\n  }\n\n  for (let y = y0; y < y1; y++) {\n    for (let x = x0; x < x1; x++) {\n      const idx = (y * width + x) * 4\n\n      // Local tangent-space bump. Central difference on the height\n      // source — `heightAt` selects alpha / luminance / a color\n      // channel. Standard tangent-space convention: high values are\n      // raised, low values are sunken, normal points away from peaks.\n      let lx: number\n      let ly: number\n      let lz: number\n      if (useBump) {\n        const hL = heightAt(x - 1, y)\n        const hR = heightAt(x + 1, y)\n        const hD = heightAt(x, y - 1)\n        const hU = heightAt(x, y + 1)\n        const dx = (hR - hL) * strength\n        const dy = (hU - hD) * strength\n        lx = -dx\n        ly = -dy\n        lz = 1\n      } else {\n        lx = 0\n        ly = 0\n        lz = 1\n      }\n\n      // Apply tilt: n = R · local.\n      let nx: number\n      let ny: number\n      let nz: number\n      if (hasTilt) {\n        nx = r00 * lx + r01 * ly + r02 * lz\n        ny = r10 * lx + r11 * ly + r12 * lz\n        nz = r20 * lx + r21 * ly + r22 * lz\n      } else {\n        nx = lx\n        ny = ly\n        nz = lz\n      }\n\n      const len = Math.hypot(nx, ny, nz)\n      nx /= len\n      ny /= len\n      nz /= len\n      // Note: nz is not written — runtime reconstructs it as\n      // sqrt(1 − nx² − ny²). Outward-facing convention means nz ≥ 0\n      // always, so the sign is implicit.\n\n      out[idx] = Math.round((nx * 0.5 + 0.5) * 255)\n      out[idx + 1] = Math.round((ny * 0.5 + 0.5) * 255)\n      out[idx + 2] = Math.round(region.elevation * 255)\n      out[idx + 3] = pixels[idx + 3]!\n    }\n  }\n}\n\n/**\n * Legacy back-compat wrapper. Use `bakeNormalMap(pixels, w, h, {\n * strength })` for equivalent behavior in new code.\n *\n * @deprecated\n */\nexport function bakeNormalMapFromPixels(\n  pixels: Uint8Array,\n  width: number,\n  height: number,\n  options: BakeOptions = {}\n): Uint8Array {\n  const strength = options.strength ?? DEFAULT_STRENGTH\n  return bakeNormalMap(pixels, width, height, {\n    strength,\n    bump: DEFAULT_BUMP,\n    pitch: DEFAULT_PITCH,\n  })\n}\n\n/**\n * Derive the conventional `.normal.png` sibling URL for a sprite PNG.\n *\n * Runtime loaders call this to try the baked output before falling\n * back to the runtime TSL path.\n *\n * Pure string rewrite — browser-safe, no filesystem.\n */\nexport function bakedNormalURL(spriteURL: string): string {\n  return spriteURL.replace(/\\.png($|[?#])/i, '.normal.png$1')\n}\n"],"mappings":"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","names":[]}
+{"version":3,"file":"bake.js","names":[],"sources":["../src/bake.ts"],"sourcesContent":["import {\n  DEFAULT_BUMP,\n  DEFAULT_PITCH,\n  DEFAULT_STRENGTH,\n  resolveRegion,\n  type NormalSourceDescriptor,\n  type ResolvedNormalRegion,\n} from './descriptor.js'\n\n/**\n * @deprecated — legacy flat-texture bake options. Use\n * `bakeNormalMap(pixels, w, h, descriptor)` for region-aware control.\n */\nexport interface BakeOptions {\n  /** Scales the alpha gradient before normalization. Default 1. */\n  strength?: number\n}\n\n/**\n * Produce a tangent-space normal map from source pixels + a descriptor.\n *\n * Cross-platform: browser + node. No filesystem, no pngjs. Used by\n * the CLI baker (wrapped with file I/O) and the runtime loader\n * (called directly on decoded image pixels).\n *\n * Per texel in each region:\n *   1. `bump: 'alpha'` — central-difference gradient on the source\n *      alpha channel, clamped to the region bounds so adjacent regions\n *      (e.g. atlas cells) can't bleed into each other.\n *   2. Compose with a tilt rotation that takes `+Z` to the region's\n *      `direction` at `pitch` radians.\n *   3. Normalize and encode to `rgb = normal * 0.5 + 0.5`. Alpha is\n *      copied from the source so the baked map carries its own\n *      silhouette.\n *\n * Texels outside every region receive the flat normal `(0, 0, 1)`\n * with the source's alpha — safe default for sparse descriptors.\n *\n * @param pixels    RGBA pixel buffer, row-major, 4 bytes per pixel.\n * @param width     Pixel width.\n * @param height    Pixel height.\n * @param descriptor Region / tilt / bump control. Defaults to a single\n *                   whole-texture flat region with alpha-derived bump.\n * @returns RGBA pixel buffer containing the encoded normal map.\n */\nexport function bakeNormalMap(\n  pixels: Uint8Array,\n  width: number,\n  height: number,\n  descriptor: NormalSourceDescriptor = {}\n): Uint8Array {\n  const out = new Uint8Array(pixels.length)\n\n  // Initialize every texel to flat-normal (nx=0, ny=0), elevation=0,\n  // source alpha. Runtime reconstructs nz = sqrt(1 − nx² − ny²) — a\n  // zero XY yields nz=1 (flat floor). Regions that cover texels will\n  // overwrite; texels outside any region keep this safe default.\n  //\n  // Encoding layout:\n  //   R = nx encoded as (nx * 0.5 + 0.5) * 255   (0.5 = 128)\n  //   G = ny encoded the same                     (0.5 = 128)\n  //   B = elevation in [0, 1] scaled to [0, 255]  (0 = ground default)\n  //   A = source alpha preserved\n  for (let i = 0; i < pixels.length; i += 4) {\n    out[i] = 128\n    out[i + 1] = 128\n    out[i + 2] = 0\n    out[i + 3] = pixels[i + 3]!\n  }\n\n  const regions =\n    descriptor.regions && descriptor.regions.length > 0 ? descriptor.regions : [{ x: 0, y: 0, w: width, h: height }]\n\n  for (const region of regions) {\n    const resolved = resolveRegion(region, descriptor)\n    bakeRegion(pixels, out, width, resolved)\n  }\n\n  return out\n}\n\n/**\n * Bake a single region into the output buffer. Region-local alpha\n * clamping prevents cross-region gradient bleed.\n */\nfunction bakeRegion(pixels: Uint8Array, out: Uint8Array, width: number, region: ResolvedNormalRegion): void {\n  const x0 = region.x\n  const y0 = region.y\n  const x1 = region.x + region.w\n  const y1 = region.y + region.h\n  const strength = region.strength\n  // Index into the RGBA pixel run for the chosen height source, or -1\n  // for 'none'. 0 = R, 1 = G, 2 = B, 3 = A. Luminance needs all three\n  // RGB components and is handled separately below.\n  const bumpMode = region.bump\n  const bumpChannel =\n    bumpMode === 'alpha' ? 3 : bumpMode === 'red' ? 0 : bumpMode === 'green' ? 1 : bumpMode === 'blue' ? 2 : -1\n  const useLuminance = bumpMode === 'luminance'\n  const useBump = bumpChannel >= 0 || useLuminance\n\n  // Build the tilt rotation matrix (+Z → target direction at pitch).\n  // For direction angle θ, the tilt axis is perpendicular to the tilt\n  // direction in the XY plane: `axis = (-sin θ, cos θ, 0)`.\n  // Rodrigues' formula composes the rotation matrix from the axis\n  // and `pitch` radians.\n  let r00 = 1,\n    r01 = 0,\n    r02 = 0\n  let r10 = 0,\n    r11 = 1,\n    r12 = 0\n  let r20 = 0,\n    r21 = 0,\n    r22 = 1\n  const hasTilt = region.angle !== null\n  if (hasTilt) {\n    const theta = region.angle as number\n    const pitch = region.pitch\n    const ax = -Math.sin(theta)\n    const ay = Math.cos(theta)\n    const c = Math.cos(pitch)\n    const s = Math.sin(pitch)\n    const t = 1 - c\n    // Axis is in the XY plane (az = 0), so several Rodrigues terms drop out.\n    r00 = c + ax * ax * t\n    r01 = ax * ay * t\n    r02 = ay * s\n    r10 = ay * ax * t\n    r11 = c + ay * ay * t\n    r12 = -ax * s\n    r20 = -ay * s\n    r21 = ax * s\n    r22 = c\n  }\n\n  // Height sample for the chosen bump mode, clamped to region bounds\n  // so adjacent regions (e.g., atlas cells) can't bleed gradients into\n  // each other. Returns a value in [0, 1].\n  const heightAt = (x: number, y: number): number => {\n    const cx = x < x0 ? x0 : x >= x1 ? x1 - 1 : x\n    const cy = y < y0 ? y0 : y >= y1 ? y1 - 1 : y\n    const base = (cy * width + cx) * 4\n    if (useLuminance) {\n      // Rec. 709 luminance — matches perceptual brightness, so art\n      // authored against a monitor reads consistently.\n      return (0.2126 * pixels[base]! + 0.7152 * pixels[base + 1]! + 0.0722 * pixels[base + 2]!) / 255\n    }\n    return pixels[base + bumpChannel]! / 255\n  }\n\n  for (let y = y0; y < y1; y++) {\n    for (let x = x0; x < x1; x++) {\n      const idx = (y * width + x) * 4\n\n      // Local tangent-space bump. Central difference on the height\n      // source — `heightAt` selects alpha / luminance / a color\n      // channel. Standard tangent-space convention: high values are\n      // raised, low values are sunken, normal points away from peaks.\n      let lx: number\n      let ly: number\n      let lz: number\n      if (useBump) {\n        const hL = heightAt(x - 1, y)\n        const hR = heightAt(x + 1, y)\n        const hD = heightAt(x, y - 1)\n        const hU = heightAt(x, y + 1)\n        const dx = (hR - hL) * strength\n        const dy = (hU - hD) * strength\n        lx = -dx\n        ly = -dy\n        lz = 1\n      } else {\n        lx = 0\n        ly = 0\n        lz = 1\n      }\n\n      // Apply tilt: n = R · local.\n      let nx: number\n      let ny: number\n      let nz: number\n      if (hasTilt) {\n        nx = r00 * lx + r01 * ly + r02 * lz\n        ny = r10 * lx + r11 * ly + r12 * lz\n        nz = r20 * lx + r21 * ly + r22 * lz\n      } else {\n        nx = lx\n        ny = ly\n        nz = lz\n      }\n\n      const len = Math.hypot(nx, ny, nz)\n      nx /= len\n      ny /= len\n      nz /= len\n      // Note: nz is not written — runtime reconstructs it as\n      // sqrt(1 − nx² − ny²). Outward-facing convention means nz ≥ 0\n      // always, so the sign is implicit.\n\n      out[idx] = Math.round((nx * 0.5 + 0.5) * 255)\n      out[idx + 1] = Math.round((ny * 0.5 + 0.5) * 255)\n      out[idx + 2] = Math.round(region.elevation * 255)\n      out[idx + 3] = pixels[idx + 3]!\n    }\n  }\n}\n\n/**\n * Legacy back-compat wrapper. Use `bakeNormalMap(pixels, w, h, {\n * strength })` for equivalent behavior in new code.\n *\n * @deprecated\n */\nexport function bakeNormalMapFromPixels(\n  pixels: Uint8Array,\n  width: number,\n  height: number,\n  options: BakeOptions = {}\n): Uint8Array {\n  const strength = options.strength ?? DEFAULT_STRENGTH\n  return bakeNormalMap(pixels, width, height, {\n    strength,\n    bump: DEFAULT_BUMP,\n    pitch: DEFAULT_PITCH,\n  })\n}\n\n/**\n * Derive the conventional `.normal.png` sibling URL for a sprite PNG.\n *\n * Runtime loaders call this to try the baked output before falling\n * back to the runtime TSL path.\n *\n * Pure string rewrite — browser-safe, no filesystem.\n */\nexport function bakedNormalURL(spriteURL: string): string {\n  return spriteURL.replace(/\\.png($|[?#])/i, '.normal.png$1')\n}\n"],"mappings":"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"}

package/dist/bake.node.d.ts

@@ -0,0 +1,20 @@
+import { NormalSourceDescriptor } from "./descriptor.js";
+import { BakeOptions } from "./bake.js";
+//#region src/bake.node.d.ts
+/**
+ * Bake a normal map from a PNG file on disk.
+ *
+ * Node-only wrapper around `bakeNormalMap` — handles file I/O and
+ * stamps the output PNG with a `tEXt` chunk containing the descriptor
+ * hash, so `probeBakedSibling` can invalidate stale outputs.
+ *
+ * Second argument accepts either:
+ *   - A full `NormalSourceDescriptor` (region-aware).
+ *   - A legacy `BakeOptions` (`{ strength }`) — for back-compat with
+ *     existing callers; promoted to a zero-region descriptor.
+ *   - A path to a descriptor JSON file.
+ */
+declare function bakeNormalMapFile(inputPath: string, descriptorOrOptions?: NormalSourceDescriptor | BakeOptions | string, outputPath?: string): string;
+//#endregion
+export { bakeNormalMapFile };
+//# sourceMappingURL=bake.node.d.ts.map

package/dist/bake.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bake.node.d.ts","names":[],"sources":["../src/bake.node.ts"],"mappings":";;;;;;;;;;;;;;;;iBAoBgB,kBACd,mBACA,sBAAsB,yBAAyB,sBAC/C"}

package/dist/bake.node.js

@@ -1,38 +1,45 @@
+import { bakeNormalMap } from "./bake.js";
+import { hashDescriptor } from "@three-flatland/bake";
 import { readFileSync } from "node:fs";
 import { PNG } from "pngjs";
-import { hashDescriptor } from "@three-flatland/bake";
 import { writeSidecarPng } from "@three-flatland/bake/node";
-import { bakeNormalMap } from "./bake.js";
+//#region src/bake.node.ts
+/**
+* Bake a normal map from a PNG file on disk.
+*
+* Node-only wrapper around `bakeNormalMap` — handles file I/O and
+* stamps the output PNG with a `tEXt` chunk containing the descriptor
+* hash, so `probeBakedSibling` can invalidate stale outputs.
+*
+* Second argument accepts either:
+*   - A full `NormalSourceDescriptor` (region-aware).
+*   - A legacy `BakeOptions` (`{ strength }`) — for back-compat with
+*     existing callers; promoted to a zero-region descriptor.
+*   - A path to a descriptor JSON file.
+*/
 function bakeNormalMapFile(inputPath, descriptorOrOptions, outputPath) {
-  const buffer = readFileSync(inputPath);
-  const png = PNG.sync.read(buffer);
-  const pixels = new Uint8Array(
-    png.data.buffer,
-    png.data.byteOffset,
-    png.data.byteLength
-  );
-  const descriptor = resolveDescriptorInput(descriptorOrOptions);
-  const normalPixels = bakeNormalMap(pixels, png.width, png.height, descriptor);
-  const resolvedOut = outputPath ?? inputPath.replace(/\.png$/i, ".normal.png");
-  writeSidecarPng(resolvedOut, normalPixels, png.width, png.height, {
-    hash: hashDescriptor(descriptor),
-    v: 1
-  });
-  return resolvedOut;
+	const buffer = readFileSync(inputPath);
+	const png = PNG.sync.read(buffer);
+	const pixels = new Uint8Array(png.data.buffer, png.data.byteOffset, png.data.byteLength);
+	const descriptor = resolveDescriptorInput(descriptorOrOptions);
+	const normalPixels = bakeNormalMap(pixels, png.width, png.height, descriptor);
+	const resolvedOut = outputPath ?? inputPath.replace(/\.png$/i, ".normal.png");
+	writeSidecarPng(resolvedOut, normalPixels, png.width, png.height, {
+		hash: hashDescriptor(descriptor),
+		v: 1
+	});
+	return resolvedOut;
 }
 function resolveDescriptorInput(input) {
-  if (input === void 0) return {};
-  if (typeof input === "string") {
-    const json = readFileSync(input, "utf8");
-    return JSON.parse(json);
-  }
-  if ("regions" in input || "direction" in input || "bump" in input || "pitch" in input) {
-    return input;
-  }
-  const legacy = input;
-  return { strength: legacy.strength };
+	if (input === void 0) return {};
+	if (typeof input === "string") {
+		const json = readFileSync(input, "utf8");
+		return JSON.parse(json);
+	}
+	if ("regions" in input || "direction" in input || "bump" in input || "pitch" in input) return input;
+	return { strength: input.strength };
 }
-export {
-  bakeNormalMapFile
-};
+//#endregion
+export { bakeNormalMapFile };
+
 //# sourceMappingURL=bake.node.js.map

package/dist/bake.node.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bake.node.ts"],"sourcesContent":["import { readFileSync } from 'node:fs'\nimport { PNG } from 'pngjs'\nimport { hashDescriptor } from '@three-flatland/bake'\nimport { writeSidecarPng } from '@three-flatland/bake/node'\nimport { bakeNormalMap, type BakeOptions } from './bake.js'\nimport type { NormalSourceDescriptor } from './descriptor.js'\n\n/**\n * Bake a normal map from a PNG file on disk.\n *\n * Node-only wrapper around `bakeNormalMap` — handles file I/O and\n * stamps the output PNG with a `tEXt` chunk containing the descriptor\n * hash, so `probeBakedSibling` can invalidate stale outputs.\n *\n * Second argument accepts either:\n *   - A full `NormalSourceDescriptor` (region-aware).\n *   - A legacy `BakeOptions` (`{ strength }`) — for back-compat with\n *     existing callers; promoted to a zero-region descriptor.\n *   - A path to a descriptor JSON file.\n */\nexport function bakeNormalMapFile(\n  inputPath: string,\n  descriptorOrOptions?: NormalSourceDescriptor | BakeOptions | string,\n  outputPath?: string\n): string {\n  const buffer = readFileSync(inputPath)\n  const png = PNG.sync.read(buffer)\n  const pixels = new Uint8Array(\n    png.data.buffer,\n    png.data.byteOffset,\n    png.data.byteLength\n  )\n\n  const descriptor = resolveDescriptorInput(descriptorOrOptions)\n  const normalPixels = bakeNormalMap(pixels, png.width, png.height, descriptor)\n\n  const resolvedOut = outputPath ?? inputPath.replace(/\\.png$/i, '.normal.png')\n  writeSidecarPng(resolvedOut, normalPixels, png.width, png.height, {\n    hash: hashDescriptor(descriptor),\n    v: 1,\n  })\n  return resolvedOut\n}\n\nfunction resolveDescriptorInput(\n  input: NormalSourceDescriptor | BakeOptions | string | undefined\n): NormalSourceDescriptor {\n  if (input === undefined) return {}\n  if (typeof input === 'string') {\n    const json = readFileSync(input, 'utf8')\n    return JSON.parse(json) as NormalSourceDescriptor\n  }\n  // Heuristic: a BakeOptions has only `strength`; a descriptor may have\n  // `regions`, `direction`, etc. Treat as descriptor when any non-\n  // `strength` field is present.\n  if ('regions' in input || 'direction' in input || 'bump' in input || 'pitch' in input) {\n    return input\n  }\n  const legacy = input as BakeOptions\n  return { strength: legacy.strength }\n}\n"],"mappings":"AAAA,SAAS,oBAAoB;AAC7B,SAAS,WAAW;AACpB,SAAS,sBAAsB;AAC/B,SAAS,uBAAuB;AAChC,SAAS,qBAAuC;AAgBzC,SAAS,kBACd,WACA,qBACA,YACQ;AACR,QAAM,SAAS,aAAa,SAAS;AACrC,QAAM,MAAM,IAAI,KAAK,KAAK,MAAM;AAChC,QAAM,SAAS,IAAI;AAAA,IACjB,IAAI,KAAK;AAAA,IACT,IAAI,KAAK;AAAA,IACT,IAAI,KAAK;AAAA,EACX;AAEA,QAAM,aAAa,uBAAuB,mBAAmB;AAC7D,QAAM,eAAe,cAAc,QAAQ,IAAI,OAAO,IAAI,QAAQ,UAAU;AAE5E,QAAM,cAAc,cAAc,UAAU,QAAQ,WAAW,aAAa;AAC5E,kBAAgB,aAAa,cAAc,IAAI,OAAO,IAAI,QAAQ;AAAA,IAChE,MAAM,eAAe,UAAU;AAAA,IAC/B,GAAG;AAAA,EACL,CAAC;AACD,SAAO;AACT;AAEA,SAAS,uBACP,OACwB;AACxB,MAAI,UAAU,OAAW,QAAO,CAAC;AACjC,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,OAAO,aAAa,OAAO,MAAM;AACvC,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB;AAIA,MAAI,aAAa,SAAS,eAAe,SAAS,UAAU,SAAS,WAAW,OAAO;AACrF,WAAO;AAAA,EACT;AACA,QAAM,SAAS;AACf,SAAO,EAAE,UAAU,OAAO,SAAS;AACrC;","names":[]}
+{"version":3,"file":"bake.node.js","names":["legacy"],"sources":["../src/bake.node.ts"],"sourcesContent":["import { readFileSync } from 'node:fs'\nimport { PNG } from 'pngjs'\nimport { hashDescriptor } from '@three-flatland/bake'\nimport { writeSidecarPng } from '@three-flatland/bake/node'\nimport { bakeNormalMap, type BakeOptions } from './bake.js'\nimport type { NormalSourceDescriptor } from './descriptor.js'\n\n/**\n * Bake a normal map from a PNG file on disk.\n *\n * Node-only wrapper around `bakeNormalMap` — handles file I/O and\n * stamps the output PNG with a `tEXt` chunk containing the descriptor\n * hash, so `probeBakedSibling` can invalidate stale outputs.\n *\n * Second argument accepts either:\n *   - A full `NormalSourceDescriptor` (region-aware).\n *   - A legacy `BakeOptions` (`{ strength }`) — for back-compat with\n *     existing callers; promoted to a zero-region descriptor.\n *   - A path to a descriptor JSON file.\n */\nexport function bakeNormalMapFile(\n  inputPath: string,\n  descriptorOrOptions?: NormalSourceDescriptor | BakeOptions | string,\n  outputPath?: string\n): string {\n  const buffer = readFileSync(inputPath)\n  const png = PNG.sync.read(buffer)\n  const pixels = new Uint8Array(png.data.buffer, png.data.byteOffset, png.data.byteLength)\n\n  const descriptor = resolveDescriptorInput(descriptorOrOptions)\n  const normalPixels = bakeNormalMap(pixels, png.width, png.height, descriptor)\n\n  const resolvedOut = outputPath ?? inputPath.replace(/\\.png$/i, '.normal.png')\n  writeSidecarPng(resolvedOut, normalPixels, png.width, png.height, {\n    hash: hashDescriptor(descriptor),\n    v: 1,\n  })\n  return resolvedOut\n}\n\nfunction resolveDescriptorInput(\n  input: NormalSourceDescriptor | BakeOptions | string | undefined\n): NormalSourceDescriptor {\n  if (input === undefined) return {}\n  if (typeof input === 'string') {\n    const json = readFileSync(input, 'utf8')\n    return JSON.parse(json) as NormalSourceDescriptor\n  }\n  // Heuristic: a BakeOptions has only `strength`; a descriptor may have\n  // `regions`, `direction`, etc. Treat as descriptor when any non-\n  // `strength` field is present.\n  if ('regions' in input || 'direction' in input || 'bump' in input || 'pitch' in input) {\n    return input\n  }\n  const legacy = input as BakeOptions\n  return { strength: legacy.strength }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,kBACd,WACA,qBACA,YACQ;CACR,MAAM,SAAS,aAAa,SAAS;CACrC,MAAM,MAAM,IAAI,KAAK,KAAK,MAAM;CAChC,MAAM,SAAS,IAAI,WAAW,IAAI,KAAK,QAAQ,IAAI,KAAK,YAAY,IAAI,KAAK,UAAU;CAEvF,MAAM,aAAa,uBAAuB,mBAAmB;CAC7D,MAAM,eAAe,cAAc,QAAQ,IAAI,OAAO,IAAI,QAAQ,UAAU;CAE5E,MAAM,cAAc,cAAc,UAAU,QAAQ,WAAW,aAAa;CAC5E,gBAAgB,aAAa,cAAc,IAAI,OAAO,IAAI,QAAQ;EAChE,MAAM,eAAe,UAAU;EAC/B,GAAG;CACL,CAAC;CACD,OAAO;AACT;AAEA,SAAS,uBACP,OACwB;CACxB,IAAI,UAAU,KAAA,GAAW,OAAO,CAAC;CACjC,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,OAAO,aAAa,OAAO,MAAM;EACvC,OAAO,KAAK,MAAM,IAAI;CACxB;CAIA,IAAI,aAAa,SAAS,eAAe,SAAS,UAAU,SAAS,WAAW,OAC9E,OAAO;CAGT,OAAO,EAAE,UAAUA,MAAO,SAAS;AACrC"}

package/dist/cli.d.ts

@@ -1,5 +1,6 @@
-import { Baker } from '@three-flatland/bake';
-
+import { Baker } from "@three-flatland/bake";
+//#region src/cli.d.ts
 declare const baker: Baker;
-
+//#endregion
 export { baker as default };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","names":[],"sources":["../src/cli.ts"],"mappings":";;cA6BM,OAAO"}