@harpern/edu-modelhub-viewer-core 0.1.0-beta.0

package/dist/index.js

@@ -0,0 +1,625 @@
+import { parseGlb as B, validate as S, adaptSidecar as R } from "@osuecampus/edu-modelhub-extractor";
+import { GlbParseError as ze } from "@osuecampus/edu-modelhub-extractor";
+import { SpriteMaterial as _, CanvasTexture as N, Sprite as D, Vector3 as h, Raycaster as C, AmbientLight as L, SpotLight as U, Color as I, DirectionalLight as F, Box3 as g } from "three";
+function W(e) {
+  return e.filter((t) => t.severity === "error");
+}
+function z(e) {
+  const [t, i = ""] = e.split("?", 2);
+  if (!/\.glb$/i.test(t)) return null;
+  const n = t.replace(/\.glb$/i, ".modelhub.json");
+  return i ? `${n}?${i}` : n;
+}
+function le(e, t) {
+  var r;
+  if (!e || e.startsWith("blob:") || e.startsWith("data:")) return "";
+  const i = t ?? ((r = globalThis.location) == null ? void 0 : r.href), n = i ? new URL(e, i).href : e, o = n.lastIndexOf("/");
+  return o === -1 ? "" : n.slice(0, o + 1);
+}
+async function P(e, t = fetch) {
+  const i = await t(e);
+  if (!i.ok)
+    throw new Error(`Failed to fetch ${e} (HTTP ${i.status}).`);
+  return i.arrayBuffer();
+}
+function G(e) {
+  const t = B(e);
+  if (!t)
+    return {
+      payload: null,
+      source: "none",
+      findings: [],
+      problem: "This model carries no EDU_modelhub metadata."
+    };
+  const i = S(t);
+  return { payload: t, source: "embedded", findings: i, problem: null };
+}
+async function ue(e, t = {}) {
+  const i = t.fetchImpl ?? fetch, n = await P(e, i), o = G(n);
+  if (o.payload) return { ...o, bytes: n };
+  if (t.sidecar === !1) return { ...o, bytes: n };
+  const s = (t.sidecarUrl ?? z)(e);
+  if (!s) return { ...o, bytes: n };
+  try {
+    const c = await i(s);
+    if (c.ok) {
+      const u = R(await c.json());
+      return {
+        payload: u,
+        source: "sidecar",
+        findings: S(u),
+        problem: null,
+        bytes: n
+      };
+    }
+  } catch {
+  }
+  return {
+    payload: null,
+    source: "none",
+    findings: [],
+    problem: "This model has no EDU_modelhub metadata, either embedded in the file or in a sidecar beside it.",
+    bytes: n
+  };
+}
+function de(e, t = "EDU_modelhub", i = console) {
+  if (!(e != null && e.length)) return;
+  const n = W(e), o = e.filter((r) => r.severity !== "error");
+  n.length && i.warn(`${t}: ${n.length} validation error(s)`, n), o.length && i.info(
+    `${t}: ${o.length} validation warning(s)`,
+    o
+  );
+}
+function v(e) {
+  return Array.isArray(e) && e.length === 3 && e.every((t) => typeof t == "number" && Number.isFinite(t));
+}
+function O(e) {
+  return e === "blender";
+}
+function x(e, t) {
+  if (!v(e)) return null;
+  const [i, n, o] = e;
+  return O(t) ? [i, o, -n] : [i, n, o];
+}
+function fe(e, t) {
+  if (!v(e)) return null;
+  const [i, n, o] = e;
+  return O(t) ? [i, -o, n] : [i, n, o];
+}
+function V(e) {
+  if (!Array.isArray(e)) return [];
+  const t = /* @__PURE__ */ new Set();
+  return e.map((i, n) => {
+    const r = (typeof (i == null ? void 0 : i.id) == "string" ? i.id.trim() : "") || `annotation-${n + 1}`;
+    let s = r, c = 2;
+    for (; t.has(s); ) s = `${r}-${c++}`;
+    return t.add(s), { ...i ?? {}, id: s };
+  });
+}
+function w(e) {
+  const t = V(e == null ? void 0 : e.annotations), i = (n) => Number.isFinite(n.readingOrder) ? n.readingOrder : Number.MAX_SAFE_INTEGER;
+  return t.map((n, o) => ({ annotation: n, index: o })).sort(
+    (n, o) => i(n.annotation) - i(o.annotation) || n.index - o.index
+  ).map((n) => n.annotation);
+}
+function k(e) {
+  return (Array.isArray(e == null ? void 0 : e.regions) ? e.regions : []).map((i, n) => ({ region: i, index: n })).sort(
+    (i, n) => (i.region.order ?? Number.MAX_SAFE_INTEGER) - (n.region.order ?? Number.MAX_SAFE_INTEGER) || i.index - n.index
+  ).map((i) => i.region);
+}
+function T(e) {
+  var t;
+  return e ? ((t = e.label) == null ? void 0 : t.trim()) || e.id || "Unnamed region" : "Unknown region";
+}
+function me(e) {
+  if (!e) return [];
+  const t = [], i = /\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g;
+  let n = 0, o;
+  for (; (o = i.exec(e)) !== null; )
+    o.index > n && t.push({ text: e.slice(n, o.index) }), t.push({ text: o[1], url: o[2] }), n = o.index + o[0].length;
+  return n < e.length && t.push({ text: e.slice(n) }), t.filter((r) => r.text.trim() || r.url);
+}
+function pe(e) {
+  const t = e == null ? void 0 : e.coordinateSpace, i = k(e), n = w(e), o = new Map(i.map((a) => [a.id, a])), r = new Map(
+    n.map((a) => [a.id, a])
+  ), s = /* @__PURE__ */ new Map();
+  for (const a of n) {
+    const l = a.regionId;
+    if (!l) continue;
+    const d = s.get(l);
+    d ? d.push(a) : s.set(l, [a]);
+  }
+  const c = [];
+  for (const a of n) {
+    const l = a.anchor;
+    if (!l || l.type !== "marker") continue;
+    const d = x(l.position, t);
+    if (!d) continue;
+    const f = a.camera, m = f ? x(f.eye, t) : null, p = f ? x(f.target, t) : null;
+    c.push({
+      annotation: a,
+      position: d,
+      ...m && p ? {
+        camera: {
+          eye: m,
+          target: p,
+          ...f != null && f.fov ? { fov: f.fov } : {}
+        }
+      } : {}
+    });
+  }
+  const u = new Set(
+    i.filter((a) => a.visibilityDefault === "hidden").map((a) => a.id)
+  );
+  return {
+    payload: e,
+    regions: i,
+    regionsById: o,
+    annotations: n,
+    annotationsById: r,
+    annotationsByRegion: s,
+    markerAnchors: c,
+    hiddenRegionIds: u
+  };
+}
+function H(e) {
+  return e.isMesh === !0;
+}
+function he(e, t, i = []) {
+  var u;
+  const n = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map();
+  for (const [a, l] of ((t == null ? void 0 : t.meshes) ?? []).entries())
+    for (const d of l.primitives ?? []) {
+      const f = (u = d.extras) == null ? void 0 : u.modelhubRegionId;
+      typeof f == "string" && f && (s.set(a, f), l.name && o.set(l.name, f));
+    }
+  for (const a of (t == null ? void 0 : t.nodes) ?? []) {
+    if (a.mesh === void 0 || !a.name) continue;
+    const l = s.get(a.mesh);
+    l && r.set(a.name, l);
+  }
+  const c = new Set(i.map((a) => a.id));
+  return e.traverse((a) => {
+    var m, p;
+    if (!H(a)) return;
+    const l = (p = (m = a.geometry) == null ? void 0 : m.userData) == null ? void 0 : p.modelhubRegionId, d = typeof l == "string" && l || r.get(a.name) || o.get(a.name) || (c.has(a.name) ? a.name : void 0);
+    if (!d) return;
+    const f = n.get(d);
+    f ? f.push(a) : n.set(d, [a]), a.userData.modelhubOriginalMaterial === void 0 && (a.userData.modelhubOriginalMaterial = a.material);
+  }), n;
+}
+function ge(e) {
+  const t = {};
+  for (const [i, n] of e) t[i] = n.length;
+  return t;
+}
+function q(e, t, i) {
+  for (const n of e.get(t) ?? []) n.visible = i;
+}
+function xe(e, t) {
+  for (const i of e.keys())
+    q(e, i, !t.has(i));
+}
+function be(e, t, i) {
+  for (const n of e.get(t) ?? []) n.material = i;
+}
+function ye(e, t) {
+  for (const i of e.get(t) ?? []) {
+    const n = i.userData.modelhubOriginalMaterial;
+    n && (i.material = n);
+  }
+}
+const K = "#2196f3", we = "#ff5722";
+function E(e, t = {}) {
+  const {
+    fill: i = K,
+    text: n = "#ffffff",
+    textStroke: o = "rgba(0, 0, 0, 0.45)"
+  } = t, r = 256, s = document.createElement("canvas");
+  s.width = r, s.height = r;
+  const c = s.getContext("2d");
+  return c && (c.beginPath(), c.arc(r / 2, r / 2, r / 2 - 4, 0, Math.PI * 2), c.fillStyle = i, c.fill(), c.strokeStyle = "#ffffff", c.lineWidth = 8, c.stroke(), c.fillStyle = n, c.strokeStyle = o, c.lineWidth = 10, c.font = "bold 132px Arial, sans-serif", c.textAlign = "center", c.textBaseline = "middle", c.strokeText(String(e), r / 2, r / 2), c.fillText(String(e), r / 2, r / 2)), s;
+}
+function X(e, t = 0.2, i) {
+  const n = new _({
+    map: new N(E(e, i)),
+    transparent: !0,
+    depthTest: !1
+  }), o = new D(n);
+  return o.scale.set(t, t, 1), o.renderOrder = 999, o;
+}
+function Me(e, t, i) {
+  var o;
+  const n = e.material;
+  (o = n.map) == null || o.dispose(), n.map = new N(E(t, { fill: i })), n.needsUpdate = !0;
+}
+function Ie(e, t, i = 0.2, n) {
+  return t.map((o, r) => {
+    const s = X(r + 1, i, n);
+    return s.position.set(...o.position), s.name = `modelhub_marker_${o.annotation.id}`, s.userData.annotationId = o.annotation.id, s.userData.displayNumber = r + 1, e.add(s), s;
+  });
+}
+function Te(e) {
+  const { camera: t, model: i, anchors: n, width: o, height: r, isOccluded: s } = e, c = e.referenceDistance ?? 1, u = new h(), a = {};
+  i.updateMatrixWorld();
+  for (const l of n) {
+    u.set(...l.position).applyMatrix4(i.matrixWorld);
+    const d = u.distanceTo(t.position), f = s ? s(u, d) : !1, m = u.clone().project(t);
+    a[l.annotation.id] = {
+      x: (m.x * 0.5 + 0.5) * o,
+      y: (-m.y * 0.5 + 0.5) * r,
+      scale: Math.min(
+        1.6,
+        Math.max(0.55, c / Math.max(d, 1e-3))
+      ),
+      zIndex: Math.max(1, Math.round((1 - m.z) * 1e5)) + (f ? 0 : 2e5),
+      inView: m.z < 1 && m.x > -1.05 && m.x < 1.05 && m.y > -1.05 && m.y < 1.05,
+      occluded: f
+    };
+  }
+  return a;
+}
+const j = 0.03, Z = {
+  enabled: !1,
+  isOccluded: () => !1,
+  dispose: () => {
+  }
+};
+async function $e(e) {
+  var r;
+  let t = [], i = [];
+  if (e.traverse((s) => {
+    if (!s.isMesh) return;
+    const c = s.geometry;
+    c != null && c.computeBoundsTree && (t.push(c), i.push(s));
+  }), !t.length) return Z;
+  for (const s of t)
+    s.boundsTree || (r = s.computeBoundsTree) == null || r.call(s, { maxLeafTris: 8 });
+  const n = new C();
+  n.firstHitOnly = !0;
+  const o = new h();
+  return {
+    enabled: !0,
+    isOccluded(s, c, u) {
+      return o.subVectors(c, s.position).normalize(), n.set(s.position, o), n.near = 0, n.far = Math.max(0, u - j), n.camera = s, n.intersectObjects(i, !1).length > 0;
+    },
+    dispose() {
+      var s;
+      for (const c of t) (s = c.disposeBoundsTree) == null || s.call(c);
+      t = [], i = [];
+    }
+  };
+}
+const y = {
+  headlight: {
+    ambient: 0.7,
+    lights: [
+      { color: [1, 1, 1], intensity: 0.9, position: [4, 8, 6] },
+      {
+        color: [1, 1, 1],
+        intensity: 2.4,
+        position: [0, 0, 0],
+        attach: !0,
+        spot: !0
+      }
+    ]
+  },
+  studio: {
+    ambient: 0.85,
+    lights: [
+      { color: [0.78, 0.8, 1], intensity: 1.45, position: [1.35, 6.75, -7.26] },
+      { color: [1, 0.88, 0.71], intensity: 1.5, position: [-5.71, 3.5, 7.43] },
+      { color: [0.42, 0.74, 1], intensity: 0.25, position: [7.23, 6.78, 1.29] }
+    ]
+  },
+  "dual-cam": {
+    ambient: 0.6,
+    lights: [
+      {
+        color: [0.6, 0.48, 0.3],
+        intensity: 1.6,
+        position: [-1, 0, 1],
+        attach: !0
+      },
+      {
+        color: [0.42, 0.42, 0.6],
+        intensity: 1.6,
+        position: [1, 0, 1],
+        attach: !0
+      }
+    ]
+  },
+  "studio-cam": {
+    ambient: 0.7,
+    lights: [
+      {
+        color: [0.78, 0.8, 1],
+        intensity: 1.35,
+        position: [-1, 0.3, 1],
+        attach: !0
+      },
+      {
+        color: [1, 0.88, 0.71],
+        intensity: 1.4,
+        position: [1, 0.3, 1],
+        attach: !0
+      },
+      { color: [0.42, 0.74, 1], intensity: 0.25, position: [7.23, 6.78, 1.29] }
+    ]
+  }
+}, Q = "headlight";
+function Ae() {
+  return Object.keys(y);
+}
+function Y(e) {
+  var t;
+  (t = e.parent) == null || t.remove(e);
+}
+function Se(e) {
+  var c;
+  const { scene: t, camera: i, exposure: n = 1 } = e;
+  (c = e.previous) == null || c.remove();
+  const o = y[e.preset ?? ""] ?? y[Q], r = [], s = new L(16777215, o.ambient * n);
+  t.add(s), r.push(s);
+  for (const u of o.lights) {
+    let a;
+    if (u.spot) {
+      const d = new U(new I(...u.color));
+      d.angle = 0.5, d.penumbra = 0.9, d.decay = 0, a = d;
+    } else
+      a = new F(new I(...u.color));
+    a.intensity = u.intensity, a.position.set(...u.position);
+    const l = a.target;
+    u.attach ? (l == null || l.position.set(0, 0, u.spot ? -1 : 0), i.add(a), l && i.add(l)) : (t.add(a), l && t.add(l)), r.push(a), l && r.push(l);
+  }
+  return {
+    lights: r,
+    remove() {
+      for (const u of r) Y(u);
+      r.length = 0;
+    }
+  };
+}
+const b = [
+  { id: "white", label: "White", hex: "#ffffff", light: !0 },
+  { id: "light-grey", label: "Light grey", hex: "#d4d4d4", light: !0 },
+  { id: "medium-grey", label: "Medium grey", hex: "#808080", light: !1 },
+  { id: "dark-grey", label: "Dark grey", hex: "#252525", light: !1 },
+  { id: "black", label: "Black", hex: "#000000", light: !1 }
+], J = "dark-grey";
+function ee(e) {
+  if (typeof e != "string") return "";
+  const t = e.trim().replace(/^#/, "");
+  return /^[0-9a-f]{6}$/i.test(t) ? `#${t.toLowerCase()}` : /^[0-9a-f]{3}$/i.test(t) ? `#${[...t].map((i) => i + i).join("").toLowerCase()}` : "";
+}
+function te(e) {
+  const t = Number.parseInt(e.replace("#", ""), 16);
+  return Number.isFinite(t) ? (0.299 * (t >> 16 & 255) + 0.587 * (t >> 8 & 255) + 0.114 * (t & 255)) / 255 : 0;
+}
+function Ne(e, t) {
+  const i = ee(t);
+  return i ? {
+    id: "custom",
+    label: "Custom",
+    hex: i,
+    light: te(i) > 0.5
+  } : b.find((n) => n.id === e) ?? b.find((n) => n.id === J) ?? b[0];
+}
+const ne = 2;
+function $(e) {
+  e.updateMatrixWorld(!0);
+  const t = new g(), i = new g();
+  return e.traverse((n) => {
+    const o = n, r = n;
+    o.isSkinnedMesh ? (o.computeBoundingBox(), o.boundingBox && (i.copy(o.boundingBox).applyMatrix4(o.matrixWorld), t.union(i))) : r.isMesh && r.geometry && (r.geometry.boundingBox || r.geometry.computeBoundingBox(), r.geometry.boundingBox && (i.copy(r.geometry.boundingBox).applyMatrix4(r.matrixWorld), t.union(i)));
+  }), t.isEmpty() ? new g().setFromObject(e) : t;
+}
+function ve(e, t = ne) {
+  const n = $(e).getSize(new h()), o = Math.max(n.x, n.y, n.z) || 1, r = t / o;
+  e.scale.multiplyScalar(r);
+  const s = $(e);
+  return e.position.sub(s.getCenter(new h())), r;
+}
+function Oe(e, t = 1.3) {
+  return t / Math.tan(e * Math.PI / 360);
+}
+const ie = 0.5, oe = 1.5;
+function ke(e, t, i = {}) {
+  t.updateMatrixWorld();
+  const n = new h(...e.position).applyMatrix4(
+    t.matrixWorld
+  );
+  if (e.camera) {
+    const u = new h(...e.camera.eye).applyMatrix4(
+      t.matrixWorld
+    ), l = new h(...e.camera.target).applyMatrix4(
+      t.matrixWorld
+    ).clone().sub(u);
+    l.lengthSq() < 1e-10 && l.copy(n).sub(u), l.normalize();
+    const d = Math.max(n.distanceTo(u), 0.2);
+    return {
+      position: u,
+      target: u.clone().addScaledVector(l, d),
+      ...e.camera.fov ? { fov: e.camera.fov } : {}
+    };
+  }
+  const o = i.outward ?? !0, r = new h(n.x, 0, n.z);
+  r.lengthSq() < 1e-8 && r.set(0, 0, 1), r.normalize();
+  const s = o ? -(i.outwardDistance ?? ie) : i.inwardDistance ?? oe, c = n.clone().addScaledVector(r, s);
+  return c.y = n.y, { position: c, target: n };
+}
+const re = { cancel: () => {
+} };
+function Ee(e) {
+  const { camera: t, controls: i, to: n, onFrame: o, onDone: r } = e, s = () => {
+    o == null || o(), r == null || r();
+  };
+  if (e.reducedMotion)
+    return t.position.copy(n.position), i.target.copy(n.target), i.update(), s(), re;
+  const c = e.durationMs ?? 900, u = t.position.clone(), a = i.target.clone(), l = performance.now();
+  let d = null;
+  const f = (m) => {
+    const p = Math.min((m - l) / c, 1), M = p * (2 - p);
+    t.position.lerpVectors(u, n.position, M), i.target.lerpVectors(a, n.target, M), i.update(), o == null || o(), p < 1 ? d = requestAnimationFrame(f) : (d = null, r == null || r());
+  };
+  return d = requestAnimationFrame(f), {
+    cancel() {
+      d !== null && cancelAnimationFrame(d), d = null;
+    }
+  };
+}
+function Be(e, t, i) {
+  const n = t || i;
+  e.fov !== n && (e.fov = n, e.updateProjectionMatrix());
+}
+const se = 500;
+function Re(e) {
+  var o, r, s;
+  if (!e)
+    return "Model loaded, but it carries no educational metadata.";
+  const t = [];
+  (o = e.model) != null && o.title && t.push(`${e.model.title} loaded`), (r = e.model) != null && r.altText && t.push(e.model.altText);
+  const i = ((s = e.regions) == null ? void 0 : s.length) ?? 0, n = w(e).length;
+  return i && t.push(`${i} labelled ${i === 1 ? "region" : "regions"}`), n && t.push(
+    `${n} ${n === 1 ? "annotation" : "annotations"}`
+  ), t.map((c) => c.replace(/\.$/, "")).join(". ") + ".";
+}
+function _e(e, t, i) {
+  return `Annotation ${t + 1} of ${i}: ${e || "Untitled"}.`;
+}
+function De(e, t = se, i = () => Date.now()) {
+  let n = -1 / 0, o = null, r = null;
+  const s = (a) => {
+    n = i(), o = null, e(a);
+  };
+  return { announce: (a) => {
+    const l = i() - n;
+    if (l >= t) {
+      s(a);
+      return;
+    }
+    o = a, r || (r = setTimeout(() => {
+      r = null, o !== null && s(o);
+    }, t - l));
+  }, flush: () => {
+    r && (clearTimeout(r), r = null), o !== null && s(o);
+  } };
+}
+function A(e, t) {
+  return `## ${e}
+${t}
+
+`;
+}
+function Ce(e, t = {}) {
+  const i = e.model ?? {}, n = k(e), o = w(e);
+  let r = `# ${i.title || "Untitled model"}
+
+`;
+  if (i.altText && (r += A(t.summaryHeading ?? "Summary", i.altText)), i.longDescription && (r += A("Full description", i.longDescription)), n.length) {
+    r += `## Regions (${n.length})
+
+`;
+    for (const s of n)
+      r += `### ${T(s)}
+${s.description || "No description."}
+
+`;
+  }
+  return o.length && (r += `## Annotations (${o.length})
+
+`, o.forEach((s, c) => {
+    const u = s.regionId ? ` (${T(n.find((l) => l.id === s.regionId))})` : "", a = `${c + 1}. ${s.title || "Untitled"}${u}`;
+    r += `### ${a}
+${s.body || "No description."}
+
+`;
+  })), r += `## Licensing
+`, r += `- **License:** ${i.license || "Not specified"}
+`, r += `- **Attribution:** ${i.attribution || "Not specified"}
+`, r += `- **Creator:** ${i.creator || "Not specified"}
+`, r += `- **Source:** ${i.source || "Not specified"}
+`, r;
+}
+function Le(e) {
+  var i;
+  return `${(((i = e.model) == null ? void 0 : i.title) || "model").trim().replace(/[^\w\-. ]+/g, "").replace(/\s+/g, "_") || "model"}_transcript.md`;
+}
+function Ue(e) {
+  e && e.traverse((t) => {
+    var r, s;
+    const i = t, n = i.geometry;
+    n && (n.boundsTree && n.disposeBoundsTree && n.disposeBoundsTree(), (r = n.dispose) == null || r.call(n));
+    const o = [].concat(
+      i.material ?? []
+    );
+    for (const c of o)
+      if (c) {
+        for (const u of Object.values(c)) {
+          const a = u;
+          a && a.isTexture && a.dispose();
+        }
+        (s = c.dispose) == null || s.call(c);
+      }
+  });
+}
+export {
+  b as BACKGROUND_OPTIONS,
+  se as CAMERA_ANNOUNCE_INTERVAL,
+  J as DEFAULT_BACKGROUND,
+  Q as DEFAULT_LIGHTING,
+  ze as GlbParseError,
+  y as LIGHTING_PRESETS,
+  K as MARKER_FILL,
+  we as MARKER_FILL_ACTIVE,
+  ne as NORMALIZED_SIZE,
+  j as OCCLUSION_BIAS,
+  oe as TOUR_DISTANCE_INWARD,
+  ie as TOUR_DISTANCE_OUTWARD,
+  _e as annotationSummary,
+  w as annotationsInReadingOrder,
+  Be as applyFov,
+  Se as applyLighting,
+  xe as applyVisibilityDefaults,
+  he as buildRegionMeshMap,
+  Ce as buildTranscript,
+  ye as clearRegionHighlight,
+  $ as computeDisplayBox,
+  ke as computeTourPlacement,
+  De as createAnnouncer,
+  X as createMarkerSprite,
+  Ie as createMarkerSprites,
+  $e as createOcclusionIndex,
+  Ue as disposeSceneGraph,
+  Oe as distanceForFov,
+  E as drawMarkerCanvas,
+  W as errorsOf,
+  P as fetchBytes,
+  Ee as flyCamera,
+  ve as frameModel,
+  fe as fromViewerPosition,
+  be as highlightRegion,
+  v as isVec3,
+  Ae as lightingPresetNames,
+  ue as loadModel,
+  de as logFindings,
+  te as luminance,
+  Re as modelSummary,
+  O as needsConversion,
+  V as normalizeAnnotationIds,
+  ee as normalizeHexColor,
+  pe as normalizeModel,
+  me as parseBodySegments,
+  Te as projectMarkers,
+  G as readEmbedded,
+  ge as regionBindingCounts,
+  T as regionLabel,
+  k as regionsInOrder,
+  Ne as resolveBackground,
+  le as resourcePathFor,
+  Me as setMarkerSpriteColor,
+  q as setRegionVisible,
+  z as sidecarUrlFor,
+  x as toViewerPosition,
+  Le as transcriptFileName
+};

package/dist/lighting.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Scene lighting.
+ *
+ * Lighting is not decoration here. These rigs were measured from this
+ * organisation's Sketchfab viewers through the Viewer API, so a model that
+ * was tuned on Sketchfab looks the same after migration. Keeping them in one
+ * place means a model lit correctly in one viewer is lit correctly in both.
+ *
+ * `attach: true` parents a light to the camera, so its direction stays fixed
+ * relative to whatever the viewer is looking at rather than to the world.
+ */
+import type { Camera, Object3D, Scene } from "three";
+/** One light in a preset. */
+export interface LightSpec {
+    /** Linear RGB, each 0 to 1. */
+    color: [number, number, number];
+    intensity: number;
+    position: [number, number, number];
+    /** Parent to the camera instead of the scene. */
+    attach?: boolean;
+    /** Render as a wide, feathered spot rather than a directional light. */
+    spot?: boolean;
+}
+/** A named lighting rig. */
+export interface LightingPreset {
+    ambient: number;
+    lights: LightSpec[];
+}
+/**
+ * The rigs. `headlight` is the plain single-camera light; the other three
+ * reproduce Sketchfab rigs captured from live models.
+ *
+ * Sketchfab pairs its rigs with an HDRI environment (lightIntensity 3), so
+ * the intensities here are scaled up from the captured values to compensate
+ * for approximating that environment with flat ambient light.
+ */
+export declare const LIGHTING_PRESETS: Record<string, LightingPreset>;
+/** The preset used when a name is missing or unknown. */
+export declare const DEFAULT_LIGHTING = "headlight";
+/** Every preset name, for building a picker. */
+export declare function lightingPresetNames(): string[];
+/** The lights a call to {@link applyLighting} created, so they can be removed. */
+export interface LightingHandle {
+    lights: Object3D[];
+    /** Detach every light this handle owns from whatever it was added to. */
+    remove(): void;
+}
+/** Options for {@link applyLighting}. */
+export interface LightingOptions {
+    scene: Scene;
+    camera: Camera;
+    /** Preset name; an unknown one falls back to `headlight`. */
+    preset?: string;
+    /** Multiplier on the preset's ambient level, mirroring Sketchfab exposure. */
+    exposure?: number;
+    /** A previous handle to tear down first. */
+    previous?: LightingHandle | null;
+}
+/**
+ * Build a preset's lights and add them to the scene, removing any previous
+ * set first. Returns a handle the caller keeps so the next call, or teardown,
+ * can take them out again.
+ */
+export declare function applyLighting(options: LightingOptions): LightingHandle;