@harpern/edu-modelhub-viewer-core 0.1.0-beta.1 → 0.1.0-beta.3

package/CHANGELOG.md

@@ -6,6 +6,35 @@ here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.1.0-beta.3] - 2026-09-13
+
+### Changed
+
+- American spellings throughout the source, tests and README, matching the
+  rest of the project. The only user-visible effect is the background swatch
+  labels, which now read "Light gray", "Medium gray" and "Dark gray". The
+  swatch ids are deliberately unchanged, still `light-grey`, `medium-grey`
+  and `dark-grey`, because both viewers and any saved collection or model
+  settings refer to them by id.
+
+## [0.1.0-beta.2] - 2026-09-13
+
+### Added
+
+- `readableRegions` and `isAuthoredRegion`, for prose views such as a reading
+  mode. The workspace addon invents one region per object when
+  nobody authored any, described as "Auto-created from object …"; these
+  helpers drop those while keeping named regions that simply have no
+  description. Interactive region lists should keep using every region,
+  because an invented region still highlights real geometry.
+
+### Changed
+
+- The spoken model summary says "labeled regions" instead of "labelled
+  regions".
+
 ## [0.1.0-beta.1] - 2026-09-13
 
 ### Fixed
@@ -21,7 +50,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   which checks the error name: with the parser bundled in, a class identity
   check against a separate copy would silently fail.
 
-## [Unreleased]
+## [0.1.0-beta.0] - 2026-09-13
+
+First publish. Deprecated: it declared a runtime dependency on an unpublished
+package and cannot be installed. Use `0.1.0-beta.1` or later.
 
 ### Added
 
@@ -43,4 +75,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   so rigged models no longer frame several times too small.
 - Camera placement preferring an authored camera, with an eased flight that
   becomes a jump cut under reduced motion.
+- Lighting presets, including rigs measured from Sketchfab's viewer, applied
+  and removed as a unit.
+- Background swatches, with custom colors resolved and their lightness
+  measured so overlays stay readable.
 - A spoken model summary, a throttled announcer, and a Markdown transcript.

package/README.md

@@ -2,7 +2,7 @@
 
 The parts of an EDU_modelhub viewer that should not be written twice.
 
-This package holds the behaviour two viewers of the same model must agree on:
+This package holds the behavior two viewers of the same model must agree on:
 how metadata is found, what happens when it is missing, how annotations are
 numbered, where markers sit, which geometry a region owns, and where the
 camera goes when someone selects an annotation.
@@ -72,7 +72,7 @@ used to mean the opposite, so this rule is enforced in one function.
 
 **Regions bound to geometry.** Built from `primitive.extras.modelhubRegionId`,
 which three.js copies onto the geometry's `userData` rather than the mesh's.
-`applyVisibilityDefaults` honours a region authored as hidden.
+`applyVisibilityDefaults` honors a region authored as hidden.
 
 **Markers.** Numbered from reading order, so the visual order and the
 announced order cannot disagree. Use sprites in the scene, or project anchors
@@ -86,6 +86,6 @@ viewer prefers reduced motion.
 **Text.** A spoken model summary, a throttled announcer so held keys do not
 flood a live region, and a Markdown transcript of everything the model says.
 
-## Licence
+## License
 
 Apache-2.0.

package/dist/backgrounds.d.ts

@@ -1,8 +1,8 @@
 /**
- * Viewer background colours.
+ * Viewer background colors.
  *
  * Which background a model sits on changes how readable it is: a pale bone
- * specimen disappears on white and reads clearly on dark grey. Offering the
+ * specimen disappears on white and reads clearly on dark gray. Offering the
  * same choices in every viewer means an instructor who picked one for a
  * collection gets it wherever the model is shown.
  */
@@ -12,11 +12,11 @@ export interface BackgroundOption {
     label: string;
     /** Canonical `#rrggbb`. */
     hex: string;
-    /** True when the colour is light enough that dark overlays read better. */
+    /** True when the color is light enough that dark overlays read better. */
     light: boolean;
 }
 /**
- * The standard swatches. Dark grey is the reference background, and gallery
+ * The standard swatches. Dark gray is the reference background, and gallery
  * thumbnails are captured against it.
  */
 export declare const BACKGROUND_OPTIONS: readonly BackgroundOption[];
@@ -25,7 +25,7 @@ export declare const DEFAULT_BACKGROUND = "dark-grey";
 /**
  * Accept `#rgb` or `#rrggbb`, with or without the hash, and return canonical
  * `#rrggbb`. Anything else returns an empty string, so a viewer falls back to
- * a known swatch rather than handing an invalid colour to the renderer.
+ * a known swatch rather than handing an invalid color to the renderer.
  */
 export declare function normalizeHexColor(value: unknown): string;
 /** Perceived brightness, 0 to 1, using the usual luma weights. */
@@ -33,8 +33,8 @@ export declare function luminance(hex: string): number;
 /**
  * The background actually in force.
  *
- * A custom colour, typically chosen per collection or per model, wins over
+ * A custom color, typically chosen per collection or per model, wins over
  * the named swatch, and its `light` flag is measured rather than declared so
- * overlays stay readable on a colour nobody anticipated.
+ * overlays stay readable on a color nobody anticipated.
  */
 export declare function resolveBackground(backgroundId?: string, custom?: string): BackgroundOption;

package/dist/camera.d.ts

@@ -24,9 +24,9 @@ export interface CameraPlacement {
 /** Tuning for the computed fallback placement. */
 export interface TourPlacementOptions {
     /**
-     * `true` puts the camera between the model centre and the annotation,
+     * `true` puts the camera between the model center and the annotation,
      * looking outward, which suits interior walkthrough scenes. `false` puts it
-     * beyond the annotation looking back at the centre, which suits a single
+     * beyond the annotation looking back at the center, which suits a single
      * specimen and needs a real standoff or the camera lands inside the mesh.
      */
     outward?: boolean;
@@ -60,7 +60,7 @@ export interface FlyOptions {
     durationMs?: number;
     /** Called after each step so the host can request a render. */
     onFrame?: () => void;
-    /** Called once the move finishes or is cancelled. */
+    /** Called once the move finishes or is canceled. */
     onDone?: () => void;
 }
 /** Handle for an in-flight camera move. */

package/dist/framing.d.ts

@@ -2,7 +2,7 @@
  * Fitting a model into view.
  *
  * Models arrive at wildly different scales, so every viewer normalizes them
- * to a known size and centres them at the origin. Doing it the same way in
+ * to a known size and centers them at the origin. Doing it the same way in
  * both apps means an authored camera means the same thing in each.
  */
 import { Box3 } from "three";
@@ -19,7 +19,7 @@ export declare const NORMALIZED_SIZE = 2;
  */
 export declare function computeDisplayBox(root: Object3D): Box3;
 /**
- * Scale a model so its longest axis is `size`, then centre it at the origin.
+ * Scale a model so its longest axis is `size`, then center it at the origin.
  * Mutates the model's transform and returns the scale factor applied.
  */
 export declare function frameModel(root: Object3D, size?: number): number;

package/dist/index.cjs

@@ -1,16 +1,16 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("three"),_=new Set(["__proto__","constructor","prototype"]);function U(e,t){const n=new WeakSet,o=[{value:e,path:""}],r=(i,s)=>{o.push({value:i,path:s})};for(;o.length>0;){const{value:i,path:s}=o.pop();if(!(typeof i!="object"||i===null||n.has(i)))if(n.add(i),Array.isArray(i))for(let c=0;c<i.length;c++)r(i[c],`${s}[${c}]`);else t(i,s,r)}}function re(e){const t=[];return U(e,(n,o,r)=>{for(const i of Object.keys(n)){const s=o===""?i:`${o}.${i}`;_.has(i)?t.push({path:s,key:i}):r(n[i],s)}}),t}function ie(e){return U(e,(t,n,o)=>{for(const r of Object.keys(t))_.has(r)?delete t[r]:o(t[r],n)}),e}const L=1179937895,E=2,se=1313821514,ae=21;class y extends Error{constructor(t){super(t),this.name="GlbParseError"}}function ce(e){return e instanceof ArrayBuffer?new DataView(e):new DataView(e.buffer,e.byteOffset,e.byteLength)}function ue(e){return e===null?"null":Array.isArray(e)?"an array":typeof e}function le(e){const t=ce(e);if(t.byteLength<ae)throw new y(`Input too short to be a GLB file (${t.byteLength} bytes).`);const n=t.getUint32(0,!0);if(n!==L)throw new y(`Invalid GLB magic: expected 0x${L.toString(16)}, got 0x${n.toString(16)}.`);const o=t.getUint32(4,!0);if(o!==E)throw new y(`Unsupported GLB version: expected ${E}, got ${o}.`);const r=t.getUint32(8,!0);if(r>t.byteLength)throw new y(`GLB header reports ${r} bytes but only ${t.byteLength} bytes were supplied.`);if(t.byteLength<20)throw new y("GLB file truncated before first chunk header.");const i=t.getUint32(12,!0),s=t.getUint32(16,!0);if(s!==se)throw new y(`First GLB chunk is not JSON (type 0x${s.toString(16)}).`);if(20+i>r)throw new y(`JSON chunk claims ${i} bytes but the declared GLB length is only ${r} bytes.`);if(20+i>t.byteLength)throw new y(`JSON chunk claims ${i} bytes but only ${t.byteLength-20} bytes remain in the buffer.`);const c=new Uint8Array(t.buffer,t.byteOffset+20,i),l=new TextDecoder("utf-8").decode(c);let a;try{a=JSON.parse(l)}catch(u){throw new y(`Failed to parse GLB JSON chunk: ${u.message}`)}if(a===null||typeof a!="object"||Array.isArray(a))throw new y(`GLB JSON chunk root must be an object, got ${ue(a)}.`);return a}function de(e){const t=le(e).extensions;if(t===null||typeof t!="object"||Array.isArray(t))return null;const n=t.EDU_modelhub;return n===void 0?null:ie(n)}const fe=/^[a-z][a-z0-9_]*$/,me=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/,he=/^[a-z]{2}$/,pe=/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;function d(e,t){return{field:e,message:t,severity:"error"}}function $(e,t){return{field:e,message:t,severity:"warning"}}function x(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function w(e){return typeof e=="string"&&e.trim()!==""}function F(e){return typeof e=="number"&&Number.isInteger(e)&&e>=0}function h(e){if(e===void 0)return"undefined";let t;if(typeof e=="string")t=`"${e}"`;else try{const n=JSON.stringify(e);if(n===void 0)return typeof e;t=n}catch{return Array.isArray(e)?"an array":typeof e}return t.length>60?`${t.slice(0,57)}...`:t}function V(e){const t=[],n=e;if(!x(n))return[d("",`Payload must be a JSON object, got ${h(n)}.`)];ge(n,t),ye(n.specVersion,t),be(n.coordinateSpace,t),$e(n.model,t);const o=Se(n.regions,t);return Ie(n.annotations,o,t),t}function ge(e,t){for(const n of re(e))t.push(d(n.path,`Disallowed key "${n.key}" at ${n.path} (prototype-pollution vector).`))}function ye(e,t){(typeof e!="string"||!pe.test(e))&&t.push(d("specVersion",`specVersion must be a semver string (e.g. "0.1.0"), got ${h(e)}.`))}function be(e,t){e!==void 0&&e!=="gltf"&&e!=="blender"&&t.push(d("coordinateSpace",`coordinateSpace must be "gltf" or "blender" when present, got ${h(e)}.`))}function $e(e,t){if(!x(e)){t.push(d("model",`model is required and must be an object, got ${h(e)}.`));return}const n=e,o=n.title;w(o)||t.push(d("model.title",`model.title is required and must be a non-empty string, got ${h(o)}.`));const r=n.altText;w(r)?r.length>300&&t.push(d("model.altText",`model.altText exceeds 300 characters (${r.length} chars).`)):t.push(d("model.altText",`model.altText is required and must be a non-empty string, got ${h(r)}.`));const i=n.language;i!==void 0&&(typeof i!="string"||!he.test(i))&&t.push($("model.language",`model.language should be an ISO 639-1 two-letter code (e.g. "en"), got ${h(i)}.`)),we(n,t),xe(n.source,t),Ae(n,t),w(n.longDescription)||t.push($("model.longDescription","model.longDescription is recommended."))}function we(e,t){const n=["CC0","CC BY","CC BY-SA","All Rights Reserved"],o=e.license;o!==void 0&&(typeof o!="string"||!n.includes(o))&&t.push(d("model.license",`model.license must be one of ${n.map(r=>`"${r}"`).join(", ")}, got ${h(o)}.`)),(o==="CC BY"||o==="CC BY-SA")&&!w(e.attribution)&&t.push($("model.attribution",'model.attribution is recommended when license is "CC BY" or "CC BY-SA".'))}function xe(e,t){if(e===void 0)return;const n=["scan","photogrammetry","manual","other"];if(typeof e!="string"||!n.includes(e)){const o=n.map(r=>`"${r}"`).join(", ");t.push(d("model.source",`model.source must be one of ${o}, got ${h(e)}.`))}}function Ae(e,t){for(const n of["created","modified"]){const o=e[n];o!==void 0&&(typeof o!="string"||!me.test(o))&&t.push($(`model.${n}`,`model.${n} should be ISO 8601 UTC (YYYY-MM-DDTHH:MM:SSZ), got ${h(o)}.`))}}function Se(e,t){const n=new Set;if(!Array.isArray(e)||e.length===0)return t.push(d("regions","At least one region is required.")),n;for(let o=0;o<e.length;o++){const r=e[o],i=`regions[${o}]`;if(!x(r)){t.push(d(i,`${i} must be an object, got ${h(r)}.`));continue}ve(r,i,n,t)}return n}function ve(e,t,n,o){const r=e.id;typeof r!="string"||!fe.test(r)?o.push(d(`${t}.id`,`${t}.id must be a non-empty snake_case string (lowercase letters, digits, underscores; must start with a letter), got ${h(r)}.`)):n.has(r)?o.push(d(`${t}.id`,`Duplicate region id "${r}" at ${t}.`)):n.add(r);const i=e.visibilityDefault;i!==void 0&&i!=="shown"&&i!=="hidden"&&o.push(d(`${t}.visibilityDefault`,`${t}.visibilityDefault must be "shown" or "hidden", got ${h(i)}.`));const s=e.order;s!==void 0&&!F(s)&&o.push($(`${t}.order`,`${t}.order should be a non-negative integer, got ${h(s)}.`))}function Ie(e,t,n){if(!Array.isArray(e)){n.push(d("annotations","annotations must be an array."));return}e.length<3&&n.push($("annotations",`Only ${e.length} annotation(s) defined (3–8 recommended).`)),e.length>8&&n.push($("annotations",`${e.length} annotations defined (3–8 recommended).`));const o={seenRegionIds:t,seenAnnotationIds:new Set,seenReadingOrders:new Set};for(let r=0;r<e.length;r++){const i=e[r],s=`annotations[${r}]`;if(!x(i)){n.push(d(s,`${s} must be an object, got ${h(i)}.`));continue}Me(i,s,o,n)}Be(o.seenReadingOrders,n)}function Me(e,t,n,o){const r=e.id;w(r)?n.seenAnnotationIds.has(r)?o.push(d(`${t}.id`,`Duplicate annotation id "${r}" at ${t}.`)):n.seenAnnotationIds.add(r):o.push(d(`${t}.id`,`${t}.id is required and must be a non-empty string, got ${h(r)}.`));const i=e.regionId;i!==void 0&&i!==""&&(typeof i!="string"||!n.seenRegionIds.has(i))&&o.push(d(`${t}.regionId`,`${t}.regionId ${h(i)} does not match any region id.`)),Oe(e.readingOrder,t,n,o),Te(e.anchor,t,o),Ne(e.camera,t,o)}function Oe(e,t,n,o){e!==void 0&&(F(e)?n.seenReadingOrders.has(e)?o.push(d(`${t}.readingOrder`,`Duplicate readingOrder value ${e} at ${t}.`)):n.seenReadingOrders.add(e):o.push(d(`${t}.readingOrder`,`${t}.readingOrder must be a non-negative integer, got ${h(e)}.`)))}function Te(e,t,n){if(!x(e)){n.push(d(`${t}.anchor`,`${t}.anchor is required and must be an object, got ${h(e)}.`));return}const o=e,r=o.type;if(r==="marker"){const i=o.position;(!Array.isArray(i)||i.length!==3||!i.every(s=>typeof s=="number"))&&n.push(d(`${t}.anchor.position`,`${t}.anchor.position must be an array of exactly 3 numbers for type "marker".`))}else r==="node"||r==="primitive"||r==="aabb"?w(o.ref)||n.push(d(`${t}.anchor.ref`,`${t}.anchor.ref is required for anchor type "${r}".`)):n.push(d(`${t}.anchor.type`,`${t}.anchor.type must be "marker", "node", "primitive", or "aabb", got ${h(r)}.`))}function Ne(e,t,n){if(e===void 0)return;if(!x(e)){n.push(d(`${t}.camera`,`${t}.camera must be an object when present, got ${h(e)}.`));return}for(const r of["eye","target"]){const i=e[r];(!Array.isArray(i)||i.length!==3||!i.every(s=>typeof s=="number"&&Number.isFinite(s)))&&n.push(d(`${t}.camera.${r}`,`${t}.camera.${r} must be an array of exactly 3 finite numbers.`))}const o=e.fov;o!==void 0&&(typeof o!="number"||!(o>0))&&n.push(d(`${t}.camera.fov`,`${t}.camera.fov must be a number greater than 0 when present, got ${h(o)}.`))}function Be(e,t){if(e.size===0)return;const n=[...e].sort((o,r)=>o-r);for(let o=0;o<n.length;o++)if(n[o]!==o){t.push($("annotations[*].readingOrder",`readingOrder values are not sequential from 0. Expected 0–${n.length-1} but found gaps or wrong start.`));break}}class k extends Error{constructor(t){super(t),this.name="AdaptError"}}class Ce{adapt(t){var n,o;const r=t.model,i=((n=r==null?void 0:r.title)==null?void 0:n.trim())??"",s=((o=r==null?void 0:r.altText)==null?void 0:o.trim())??"";if(!i)throw new k("Sidecar is missing required field: model.title");if(!s)throw new k("Sidecar is missing required field: model.altText");return t}}const Re=new Ce;function Le(e){return Re.adapt(e)}function G(e){return e.filter(t=>t.severity==="error")}function P(e){const[t,n=""]=e.split("?",2);if(!/\.glb$/i.test(t))return null;const o=t.replace(/\.glb$/i,".modelhub.json");return n?`${o}?${n}`:o}function Ee(e,t){var i;if(!e||e.startsWith("blob:")||e.startsWith("data:"))return"";const n=t??((i=globalThis.location)==null?void 0:i.href),o=n?new URL(e,n).href:e,r=o.lastIndexOf("/");return r===-1?"":o.slice(0,r+1)}async function z(e,t=fetch){const n=await t(e);if(!n.ok)throw new Error(`Failed to fetch ${e} (HTTP ${n.status}).`);return n.arrayBuffer()}function j(e){const t=de(e);if(!t)return{payload:null,source:"none",findings:[],problem:"This model carries no EDU_modelhub metadata."};const n=V(t);return{payload:t,source:"embedded",findings:n,problem:null}}async function ke(e,t={}){const n=t.fetchImpl??fetch,o=await z(e,n),r=j(o);if(r.payload)return{...r,bytes:o};if(t.sidecar===!1)return{...r,bytes:o};const s=(t.sidecarUrl??P)(e);if(!s)return{...r,bytes:o};try{const c=await n(s);if(c.ok){const l=Le(await c.json());return{payload:l,source:"sidecar",findings:V(l),problem:null,bytes:o}}}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:o}}function De(e,t="EDU_modelhub",n=console){if(!(e!=null&&e.length))return;const o=G(e),r=e.filter(i=>i.severity!=="error");o.length&&n.warn(`${t}: ${o.length} validation error(s)`,o),r.length&&n.info(`${t}: ${r.length} validation warning(s)`,r)}function _e(e){return(e==null?void 0:e.name)==="GlbParseError"}function T(e){return Array.isArray(e)&&e.length===3&&e.every(t=>typeof t=="number"&&Number.isFinite(t))}function N(e){return e==="blender"}function A(e,t){if(!T(e))return null;const[n,o,r]=e;return N(t)?[n,r,-o]:[n,o,r]}function Ue(e,t){if(!T(e))return null;const[n,o,r]=e;return N(t)?[n,-r,o]:[n,o,r]}function W(e){if(!Array.isArray(e))return[];const t=new Set;return e.map((n,o)=>{const i=(typeof(n==null?void 0:n.id)=="string"?n.id.trim():"")||`annotation-${o+1}`;let s=i,c=2;for(;t.has(s);)s=`${i}-${c++}`;return t.add(s),{...n??{},id:s}})}function I(e){const t=W(e==null?void 0:e.annotations),n=o=>Number.isFinite(o.readingOrder)?o.readingOrder:Number.MAX_SAFE_INTEGER;return t.map((o,r)=>({annotation:o,index:r})).sort((o,r)=>n(o.annotation)-n(r.annotation)||o.index-r.index).map(o=>o.annotation)}function B(e){return(Array.isArray(e==null?void 0:e.regions)?e.regions:[]).map((n,o)=>({region:n,index:o})).sort((n,o)=>(n.region.order??Number.MAX_SAFE_INTEGER)-(o.region.order??Number.MAX_SAFE_INTEGER)||n.index-o.index).map(n=>n.region)}function M(e){var t;return e?((t=e.label)==null?void 0:t.trim())||e.id||"Unnamed region":"Unknown region"}function Fe(e){if(!e)return[];const t=[],n=/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g;let o=0,r;for(;(r=n.exec(e))!==null;)r.index>o&&t.push({text:e.slice(o,r.index)}),t.push({text:r[1],url:r[2]}),o=r.index+r[0].length;return o<e.length&&t.push({text:e.slice(o)}),t.filter(i=>i.text.trim()||i.url)}function Ve(e){const t=e==null?void 0:e.coordinateSpace,n=B(e),o=I(e),r=new Map(n.map(a=>[a.id,a])),i=new Map(o.map(a=>[a.id,a])),s=new Map;for(const a of o){const u=a.regionId;if(!u)continue;const f=s.get(u);f?f.push(a):s.set(u,[a])}const c=[];for(const a of o){const u=a.anchor;if(!u||u.type!=="marker")continue;const f=A(u.position,t);if(!f)continue;const m=a.camera,g=m?A(m.eye,t):null,b=m?A(m.target,t):null;c.push({annotation:a,position:f,...g&&b?{camera:{eye:g,target:b,...m!=null&&m.fov?{fov:m.fov}:{}}}:{}})}const l=new Set(n.filter(a=>a.visibilityDefault==="hidden").map(a=>a.id));return{payload:e,regions:n,regionsById:r,annotations:o,annotationsById:i,annotationsByRegion:s,markerAnchors:c,hiddenRegionIds:l}}function Ge(e){return e.isMesh===!0}function Pe(e,t,n=[]){var l;const o=new Map,r=new Map,i=new Map,s=new Map;for(const[a,u]of((t==null?void 0:t.meshes)??[]).entries())for(const f of u.primitives??[]){const m=(l=f.extras)==null?void 0:l.modelhubRegionId;typeof m=="string"&&m&&(s.set(a,m),u.name&&r.set(u.name,m))}for(const a of(t==null?void 0:t.nodes)??[]){if(a.mesh===void 0||!a.name)continue;const u=s.get(a.mesh);u&&i.set(a.name,u)}const c=new Set(n.map(a=>a.id));return e.traverse(a=>{var g,b;if(!Ge(a))return;const u=(b=(g=a.geometry)==null?void 0:g.userData)==null?void 0:b.modelhubRegionId,f=typeof u=="string"&&u||i.get(a.name)||r.get(a.name)||(c.has(a.name)?a.name:void 0);if(!f)return;const m=o.get(f);m?m.push(a):o.set(f,[a]),a.userData.modelhubOriginalMaterial===void 0&&(a.userData.modelhubOriginalMaterial=a.material)}),o}function ze(e){const t={};for(const[n,o]of e)t[n]=o.length;return t}function q(e,t,n){for(const o of e.get(t)??[])o.visible=n}function je(e,t){for(const n of e.keys())q(e,n,!t.has(n))}function We(e,t,n){for(const o of e.get(t)??[])o.material=n}function qe(e,t){for(const n of e.get(t)??[]){const o=n.userData.modelhubOriginalMaterial;o&&(n.material=o)}}const H="#2196f3",He="#ff5722";function C(e,t={}){const{fill:n=H,text:o="#ffffff",textStroke:r="rgba(0, 0, 0, 0.45)"}=t,i=256,s=document.createElement("canvas");s.width=i,s.height=i;const c=s.getContext("2d");return c&&(c.beginPath(),c.arc(i/2,i/2,i/2-4,0,Math.PI*2),c.fillStyle=n,c.fill(),c.strokeStyle="#ffffff",c.lineWidth=8,c.stroke(),c.fillStyle=o,c.strokeStyle=r,c.lineWidth=10,c.font="bold 132px Arial, sans-serif",c.textAlign="center",c.textBaseline="middle",c.strokeText(String(e),i/2,i/2),c.fillText(String(e),i/2,i/2)),s}function Y(e,t=.2,n){const o=new p.SpriteMaterial({map:new p.CanvasTexture(C(e,n)),transparent:!0,depthTest:!1}),r=new p.Sprite(o);return r.scale.set(t,t,1),r.renderOrder=999,r}function Ye(e,t,n){var r;const o=e.material;(r=o.map)==null||r.dispose(),o.map=new p.CanvasTexture(C(t,{fill:n})),o.needsUpdate=!0}function Ke(e,t,n=.2,o){return t.map((r,i)=>{const s=Y(i+1,n,o);return s.position.set(...r.position),s.name=`modelhub_marker_${r.annotation.id}`,s.userData.annotationId=r.annotation.id,s.userData.displayNumber=i+1,e.add(s),s})}function Ze(e){const{camera:t,model:n,anchors:o,width:r,height:i,isOccluded:s}=e,c=e.referenceDistance??1,l=new p.Vector3,a={};n.updateMatrixWorld();for(const u of o){l.set(...u.position).applyMatrix4(n.matrixWorld);const f=l.distanceTo(t.position),m=s?s(l,f):!1,g=l.clone().project(t);a[u.annotation.id]={x:(g.x*.5+.5)*r,y:(-g.y*.5+.5)*i,scale:Math.min(1.6,Math.max(.55,c/Math.max(f,.001))),zIndex:Math.max(1,Math.round((1-g.z)*1e5))+(m?0:2e5),inView:g.z<1&&g.x>-1.05&&g.x<1.05&&g.y>-1.05&&g.y<1.05,occluded:m}}return a}const K=.03,Xe={enabled:!1,isOccluded:()=>!1,dispose:()=>{}};async function Qe(e){var i;let t=[],n=[];if(e.traverse(s=>{if(!s.isMesh)return;const c=s.geometry;c!=null&&c.computeBoundsTree&&(t.push(c),n.push(s))}),!t.length)return Xe;for(const s of t)s.boundsTree||(i=s.computeBoundsTree)==null||i.call(s,{maxLeafTris:8});const o=new p.Raycaster;o.firstHitOnly=!0;const r=new p.Vector3;return{enabled:!0,isOccluded(s,c,l){return r.subVectors(c,s.position).normalize(),o.set(s.position,r),o.near=0,o.far=Math.max(0,l-K),o.camera=s,o.intersectObjects(n,!1).length>0},dispose(){var s;for(const c of t)(s=c.disposeBoundsTree)==null||s.call(c);t=[],n=[]}}}const v={headlight:{ambient:.7,lights:[{color:[1,1,1],intensity:.9,position:[4,8,6]},{color:[1,1,1],intensity:2.4,position:[0,0,0],attach:!0,spot:!0}]},studio:{ambient:.85,lights:[{color:[.78,.8,1],intensity:1.45,position:[1.35,6.75,-7.26]},{color:[1,.88,.71],intensity:1.5,position:[-5.71,3.5,7.43]},{color:[.42,.74,1],intensity:.25,position:[7.23,6.78,1.29]}]},"dual-cam":{ambient:.6,lights:[{color:[.6,.48,.3],intensity:1.6,position:[-1,0,1],attach:!0},{color:[.42,.42,.6],intensity:1.6,position:[1,0,1],attach:!0}]},"studio-cam":{ambient:.7,lights:[{color:[.78,.8,1],intensity:1.35,position:[-1,.3,1],attach:!0},{color:[1,.88,.71],intensity:1.4,position:[1,.3,1],attach:!0},{color:[.42,.74,1],intensity:.25,position:[7.23,6.78,1.29]}]}},Z="headlight";function Je(){return Object.keys(v)}function et(e){var t;(t=e.parent)==null||t.remove(e)}function tt(e){var c;const{scene:t,camera:n,exposure:o=1}=e;(c=e.previous)==null||c.remove();const r=v[e.preset??""]??v[Z],i=[],s=new p.AmbientLight(16777215,r.ambient*o);t.add(s),i.push(s);for(const l of r.lights){let a;if(l.spot){const f=new p.SpotLight(new p.Color(...l.color));f.angle=.5,f.penumbra=.9,f.decay=0,a=f}else a=new p.DirectionalLight(new p.Color(...l.color));a.intensity=l.intensity,a.position.set(...l.position);const u=a.target;l.attach?(u==null||u.position.set(0,0,l.spot?-1:0),n.add(a),u&&n.add(u)):(t.add(a),u&&t.add(u)),i.push(a),u&&i.push(u)}return{lights:i,remove(){for(const l of i)et(l);i.length=0}}}const S=[{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}],X="dark-grey";function Q(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(n=>n+n).join("").toLowerCase()}`:""}function J(e){const t=Number.parseInt(e.replace("#",""),16);return Number.isFinite(t)?(.299*(t>>16&255)+.587*(t>>8&255)+.114*(t&255))/255:0}function nt(e,t){const n=Q(t);return n?{id:"custom",label:"Custom",hex:n,light:J(n)>.5}:S.find(o=>o.id===e)??S.find(o=>o.id===X)??S[0]}const ee=2;function O(e){e.updateMatrixWorld(!0);const t=new p.Box3,n=new p.Box3;return e.traverse(o=>{const r=o,i=o;r.isSkinnedMesh?(r.computeBoundingBox(),r.boundingBox&&(n.copy(r.boundingBox).applyMatrix4(r.matrixWorld),t.union(n))):i.isMesh&&i.geometry&&(i.geometry.boundingBox||i.geometry.computeBoundingBox(),i.geometry.boundingBox&&(n.copy(i.geometry.boundingBox).applyMatrix4(i.matrixWorld),t.union(n)))}),t.isEmpty()?new p.Box3().setFromObject(e):t}function ot(e,t=ee){const o=O(e).getSize(new p.Vector3),r=Math.max(o.x,o.y,o.z)||1,i=t/r;e.scale.multiplyScalar(i);const s=O(e);return e.position.sub(s.getCenter(new p.Vector3)),i}function rt(e,t=1.3){return t/Math.tan(e*Math.PI/360)}const te=.5,ne=1.5;function it(e,t,n={}){t.updateMatrixWorld();const o=new p.Vector3(...e.position).applyMatrix4(t.matrixWorld);if(e.camera){const l=new p.Vector3(...e.camera.eye).applyMatrix4(t.matrixWorld),u=new p.Vector3(...e.camera.target).applyMatrix4(t.matrixWorld).clone().sub(l);u.lengthSq()<1e-10&&u.copy(o).sub(l),u.normalize();const f=Math.max(o.distanceTo(l),.2);return{position:l,target:l.clone().addScaledVector(u,f),...e.camera.fov?{fov:e.camera.fov}:{}}}const r=n.outward??!0,i=new p.Vector3(o.x,0,o.z);i.lengthSq()<1e-8&&i.set(0,0,1),i.normalize();const s=r?-(n.outwardDistance??te):n.inwardDistance??ne,c=o.clone().addScaledVector(i,s);return c.y=o.y,{position:c,target:o}}const st={cancel:()=>{}};function at(e){const{camera:t,controls:n,to:o,onFrame:r,onDone:i}=e,s=()=>{r==null||r(),i==null||i()};if(e.reducedMotion)return t.position.copy(o.position),n.target.copy(o.target),n.update(),s(),st;const c=e.durationMs??900,l=t.position.clone(),a=n.target.clone(),u=performance.now();let f=null;const m=g=>{const b=Math.min((g-u)/c,1),R=b*(2-b);t.position.lerpVectors(l,o.position,R),n.target.lerpVectors(a,o.target,R),n.update(),r==null||r(),b<1?f=requestAnimationFrame(m):(f=null,i==null||i())};return f=requestAnimationFrame(m),{cancel(){f!==null&&cancelAnimationFrame(f),f=null}}}function ct(e,t,n){const o=t||n;e.fov!==o&&(e.fov=o,e.updateProjectionMatrix())}const oe=500;function ut(e){var r,i,s;if(!e)return"Model loaded, but it carries no educational metadata.";const t=[];(r=e.model)!=null&&r.title&&t.push(`${e.model.title} loaded`),(i=e.model)!=null&&i.altText&&t.push(e.model.altText);const n=((s=e.regions)==null?void 0:s.length)??0,o=I(e).length;return n&&t.push(`${n} labelled ${n===1?"region":"regions"}`),o&&t.push(`${o} ${o===1?"annotation":"annotations"}`),t.map(c=>c.replace(/\.$/,"")).join(". ")+"."}function lt(e,t,n){return`Annotation ${t+1} of ${n}: ${e||"Untitled"}.`}function dt(e,t=oe,n=()=>Date.now()){let o=-1/0,r=null,i=null;const s=a=>{o=n(),r=null,e(a)};return{announce:a=>{const u=n()-o;if(u>=t){s(a);return}r=a,i||(i=setTimeout(()=>{i=null,r!==null&&s(r)},t-u))},flush:()=>{i&&(clearTimeout(i),i=null),r!==null&&s(r)}}}function D(e,t){return`## ${e}
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("three"),_=new Set(["__proto__","constructor","prototype"]);function U(e,t){const n=new WeakSet,r=[{value:e,path:""}],o=(i,s)=>{r.push({value:i,path:s})};for(;r.length>0;){const{value:i,path:s}=r.pop();if(!(typeof i!="object"||i===null||n.has(i)))if(n.add(i),Array.isArray(i))for(let c=0;c<i.length;c++)o(i[c],`${s}[${c}]`);else t(i,s,o)}}function ie(e){const t=[];return U(e,(n,r,o)=>{for(const i of Object.keys(n)){const s=r===""?i:`${r}.${i}`;_.has(i)?t.push({path:s,key:i}):o(n[i],s)}}),t}function se(e){return U(e,(t,n,r)=>{for(const o of Object.keys(t))_.has(o)?delete t[o]:r(t[o],n)}),e}const E=1179937895,L=2,ae=1313821514,ce=21;class y extends Error{constructor(t){super(t),this.name="GlbParseError"}}function ue(e){return e instanceof ArrayBuffer?new DataView(e):new DataView(e.buffer,e.byteOffset,e.byteLength)}function le(e){return e===null?"null":Array.isArray(e)?"an array":typeof e}function de(e){const t=ue(e);if(t.byteLength<ce)throw new y(`Input too short to be a GLB file (${t.byteLength} bytes).`);const n=t.getUint32(0,!0);if(n!==E)throw new y(`Invalid GLB magic: expected 0x${E.toString(16)}, got 0x${n.toString(16)}.`);const r=t.getUint32(4,!0);if(r!==L)throw new y(`Unsupported GLB version: expected ${L}, got ${r}.`);const o=t.getUint32(8,!0);if(o>t.byteLength)throw new y(`GLB header reports ${o} bytes but only ${t.byteLength} bytes were supplied.`);if(t.byteLength<20)throw new y("GLB file truncated before first chunk header.");const i=t.getUint32(12,!0),s=t.getUint32(16,!0);if(s!==ae)throw new y(`First GLB chunk is not JSON (type 0x${s.toString(16)}).`);if(20+i>o)throw new y(`JSON chunk claims ${i} bytes but the declared GLB length is only ${o} bytes.`);if(20+i>t.byteLength)throw new y(`JSON chunk claims ${i} bytes but only ${t.byteLength-20} bytes remain in the buffer.`);const c=new Uint8Array(t.buffer,t.byteOffset+20,i),l=new TextDecoder("utf-8").decode(c);let a;try{a=JSON.parse(l)}catch(u){throw new y(`Failed to parse GLB JSON chunk: ${u.message}`)}if(a===null||typeof a!="object"||Array.isArray(a))throw new y(`GLB JSON chunk root must be an object, got ${le(a)}.`);return a}function fe(e){const t=de(e).extensions;if(t===null||typeof t!="object"||Array.isArray(t))return null;const n=t.EDU_modelhub;return n===void 0?null:se(n)}const me=/^[a-z][a-z0-9_]*$/,he=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/,pe=/^[a-z]{2}$/,ge=/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;function d(e,t){return{field:e,message:t,severity:"error"}}function $(e,t){return{field:e,message:t,severity:"warning"}}function x(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function w(e){return typeof e=="string"&&e.trim()!==""}function F(e){return typeof e=="number"&&Number.isInteger(e)&&e>=0}function h(e){if(e===void 0)return"undefined";let t;if(typeof e=="string")t=`"${e}"`;else try{const n=JSON.stringify(e);if(n===void 0)return typeof e;t=n}catch{return Array.isArray(e)?"an array":typeof e}return t.length>60?`${t.slice(0,57)}...`:t}function G(e){const t=[],n=e;if(!x(n))return[d("",`Payload must be a JSON object, got ${h(n)}.`)];ye(n,t),be(n.specVersion,t),$e(n.coordinateSpace,t),we(n.model,t);const r=ve(n.regions,t);return Me(n.annotations,r,t),t}function ye(e,t){for(const n of ie(e))t.push(d(n.path,`Disallowed key "${n.key}" at ${n.path} (prototype-pollution vector).`))}function be(e,t){(typeof e!="string"||!ge.test(e))&&t.push(d("specVersion",`specVersion must be a semver string (e.g. "0.1.0"), got ${h(e)}.`))}function $e(e,t){e!==void 0&&e!=="gltf"&&e!=="blender"&&t.push(d("coordinateSpace",`coordinateSpace must be "gltf" or "blender" when present, got ${h(e)}.`))}function we(e,t){if(!x(e)){t.push(d("model",`model is required and must be an object, got ${h(e)}.`));return}const n=e,r=n.title;w(r)||t.push(d("model.title",`model.title is required and must be a non-empty string, got ${h(r)}.`));const o=n.altText;w(o)?o.length>300&&t.push(d("model.altText",`model.altText exceeds 300 characters (${o.length} chars).`)):t.push(d("model.altText",`model.altText is required and must be a non-empty string, got ${h(o)}.`));const i=n.language;i!==void 0&&(typeof i!="string"||!pe.test(i))&&t.push($("model.language",`model.language should be an ISO 639-1 two-letter code (e.g. "en"), got ${h(i)}.`)),xe(n,t),Ae(n.source,t),Se(n,t),w(n.longDescription)||t.push($("model.longDescription","model.longDescription is recommended."))}function xe(e,t){const n=["CC0","CC BY","CC BY-SA","All Rights Reserved"],r=e.license;r!==void 0&&(typeof r!="string"||!n.includes(r))&&t.push(d("model.license",`model.license must be one of ${n.map(o=>`"${o}"`).join(", ")}, got ${h(r)}.`)),(r==="CC BY"||r==="CC BY-SA")&&!w(e.attribution)&&t.push($("model.attribution",'model.attribution is recommended when license is "CC BY" or "CC BY-SA".'))}function Ae(e,t){if(e===void 0)return;const n=["scan","photogrammetry","manual","other"];if(typeof e!="string"||!n.includes(e)){const r=n.map(o=>`"${o}"`).join(", ");t.push(d("model.source",`model.source must be one of ${r}, got ${h(e)}.`))}}function Se(e,t){for(const n of["created","modified"]){const r=e[n];r!==void 0&&(typeof r!="string"||!he.test(r))&&t.push($(`model.${n}`,`model.${n} should be ISO 8601 UTC (YYYY-MM-DDTHH:MM:SSZ), got ${h(r)}.`))}}function ve(e,t){const n=new Set;if(!Array.isArray(e)||e.length===0)return t.push(d("regions","At least one region is required.")),n;for(let r=0;r<e.length;r++){const o=e[r],i=`regions[${r}]`;if(!x(o)){t.push(d(i,`${i} must be an object, got ${h(o)}.`));continue}Ie(o,i,n,t)}return n}function Ie(e,t,n,r){const o=e.id;typeof o!="string"||!me.test(o)?r.push(d(`${t}.id`,`${t}.id must be a non-empty snake_case string (lowercase letters, digits, underscores; must start with a letter), got ${h(o)}.`)):n.has(o)?r.push(d(`${t}.id`,`Duplicate region id "${o}" at ${t}.`)):n.add(o);const i=e.visibilityDefault;i!==void 0&&i!=="shown"&&i!=="hidden"&&r.push(d(`${t}.visibilityDefault`,`${t}.visibilityDefault must be "shown" or "hidden", got ${h(i)}.`));const s=e.order;s!==void 0&&!F(s)&&r.push($(`${t}.order`,`${t}.order should be a non-negative integer, got ${h(s)}.`))}function Me(e,t,n){if(!Array.isArray(e)){n.push(d("annotations","annotations must be an array."));return}e.length<3&&n.push($("annotations",`Only ${e.length} annotation(s) defined (3–8 recommended).`)),e.length>8&&n.push($("annotations",`${e.length} annotations defined (3–8 recommended).`));const r={seenRegionIds:t,seenAnnotationIds:new Set,seenReadingOrders:new Set};for(let o=0;o<e.length;o++){const i=e[o],s=`annotations[${o}]`;if(!x(i)){n.push(d(s,`${s} must be an object, got ${h(i)}.`));continue}Oe(i,s,r,n)}Be(r.seenReadingOrders,n)}function Oe(e,t,n,r){const o=e.id;w(o)?n.seenAnnotationIds.has(o)?r.push(d(`${t}.id`,`Duplicate annotation id "${o}" at ${t}.`)):n.seenAnnotationIds.add(o):r.push(d(`${t}.id`,`${t}.id is required and must be a non-empty string, got ${h(o)}.`));const i=e.regionId;i!==void 0&&i!==""&&(typeof i!="string"||!n.seenRegionIds.has(i))&&r.push(d(`${t}.regionId`,`${t}.regionId ${h(i)} does not match any region id.`)),Te(e.readingOrder,t,n,r),Ne(e.anchor,t,r),Re(e.camera,t,r)}function Te(e,t,n,r){e!==void 0&&(F(e)?n.seenReadingOrders.has(e)?r.push(d(`${t}.readingOrder`,`Duplicate readingOrder value ${e} at ${t}.`)):n.seenReadingOrders.add(e):r.push(d(`${t}.readingOrder`,`${t}.readingOrder must be a non-negative integer, got ${h(e)}.`)))}function Ne(e,t,n){if(!x(e)){n.push(d(`${t}.anchor`,`${t}.anchor is required and must be an object, got ${h(e)}.`));return}const r=e,o=r.type;if(o==="marker"){const i=r.position;(!Array.isArray(i)||i.length!==3||!i.every(s=>typeof s=="number"))&&n.push(d(`${t}.anchor.position`,`${t}.anchor.position must be an array of exactly 3 numbers for type "marker".`))}else o==="node"||o==="primitive"||o==="aabb"?w(r.ref)||n.push(d(`${t}.anchor.ref`,`${t}.anchor.ref is required for anchor type "${o}".`)):n.push(d(`${t}.anchor.type`,`${t}.anchor.type must be "marker", "node", "primitive", or "aabb", got ${h(o)}.`))}function Re(e,t,n){if(e===void 0)return;if(!x(e)){n.push(d(`${t}.camera`,`${t}.camera must be an object when present, got ${h(e)}.`));return}for(const o of["eye","target"]){const i=e[o];(!Array.isArray(i)||i.length!==3||!i.every(s=>typeof s=="number"&&Number.isFinite(s)))&&n.push(d(`${t}.camera.${o}`,`${t}.camera.${o} must be an array of exactly 3 finite numbers.`))}const r=e.fov;r!==void 0&&(typeof r!="number"||!(r>0))&&n.push(d(`${t}.camera.fov`,`${t}.camera.fov must be a number greater than 0 when present, got ${h(r)}.`))}function Be(e,t){if(e.size===0)return;const n=[...e].sort((r,o)=>r-o);for(let r=0;r<n.length;r++)if(n[r]!==r){t.push($("annotations[*].readingOrder",`readingOrder values are not sequential from 0. Expected 0–${n.length-1} but found gaps or wrong start.`));break}}class k extends Error{constructor(t){super(t),this.name="AdaptError"}}class Ce{adapt(t){var n,r;const o=t.model,i=((n=o==null?void 0:o.title)==null?void 0:n.trim())??"",s=((r=o==null?void 0:o.altText)==null?void 0:r.trim())??"";if(!i)throw new k("Sidecar is missing required field: model.title");if(!s)throw new k("Sidecar is missing required field: model.altText");return t}}const Ee=new Ce;function Le(e){return Ee.adapt(e)}function V(e){return e.filter(t=>t.severity==="error")}function P(e){const[t,n=""]=e.split("?",2);if(!/\.glb$/i.test(t))return null;const r=t.replace(/\.glb$/i,".modelhub.json");return n?`${r}?${n}`:r}function ke(e,t){var i;if(!e||e.startsWith("blob:")||e.startsWith("data:"))return"";const n=t??((i=globalThis.location)==null?void 0:i.href),r=n?new URL(e,n).href:e,o=r.lastIndexOf("/");return o===-1?"":r.slice(0,o+1)}async function z(e,t=fetch){const n=await t(e);if(!n.ok)throw new Error(`Failed to fetch ${e} (HTTP ${n.status}).`);return n.arrayBuffer()}function j(e){const t=fe(e);if(!t)return{payload:null,source:"none",findings:[],problem:"This model carries no EDU_modelhub metadata."};const n=G(t);return{payload:t,source:"embedded",findings:n,problem:null}}async function De(e,t={}){const n=t.fetchImpl??fetch,r=await z(e,n),o=j(r);if(o.payload)return{...o,bytes:r};if(t.sidecar===!1)return{...o,bytes:r};const s=(t.sidecarUrl??P)(e);if(!s)return{...o,bytes:r};try{const c=await n(s);if(c.ok){const l=Le(await c.json());return{payload:l,source:"sidecar",findings:G(l),problem:null,bytes:r}}}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:r}}function _e(e,t="EDU_modelhub",n=console){if(!(e!=null&&e.length))return;const r=V(e),o=e.filter(i=>i.severity!=="error");r.length&&n.warn(`${t}: ${r.length} validation error(s)`,r),o.length&&n.info(`${t}: ${o.length} validation warning(s)`,o)}function Ue(e){return(e==null?void 0:e.name)==="GlbParseError"}function T(e){return Array.isArray(e)&&e.length===3&&e.every(t=>typeof t=="number"&&Number.isFinite(t))}function N(e){return e==="blender"}function A(e,t){if(!T(e))return null;const[n,r,o]=e;return N(t)?[n,o,-r]:[n,r,o]}function Fe(e,t){if(!T(e))return null;const[n,r,o]=e;return N(t)?[n,-o,r]:[n,r,o]}function W(e){if(!Array.isArray(e))return[];const t=new Set;return e.map((n,r)=>{const i=(typeof(n==null?void 0:n.id)=="string"?n.id.trim():"")||`annotation-${r+1}`;let s=i,c=2;for(;t.has(s);)s=`${i}-${c++}`;return t.add(s),{...n??{},id:s}})}function I(e){const t=W(e==null?void 0:e.annotations),n=r=>Number.isFinite(r.readingOrder)?r.readingOrder:Number.MAX_SAFE_INTEGER;return t.map((r,o)=>({annotation:r,index:o})).sort((r,o)=>n(r.annotation)-n(o.annotation)||r.index-o.index).map(r=>r.annotation)}function R(e){return(Array.isArray(e==null?void 0:e.regions)?e.regions:[]).map((n,r)=>({region:n,index:r})).sort((n,r)=>(n.region.order??Number.MAX_SAFE_INTEGER)-(r.region.order??Number.MAX_SAFE_INTEGER)||n.index-r.index).map(n=>n.region)}const Ge="Auto-created from object ";function q(e){var n;const t=(n=e==null?void 0:e.description)==null?void 0:n.trim();return t?!t.startsWith(Ge):!1}function Ve(e){return Array.isArray(e)?e.filter(t=>{var n;return q(t)||!((n=t.description)!=null&&n.trim())}):[]}function M(e){var t;return e?((t=e.label)==null?void 0:t.trim())||e.id||"Unnamed region":"Unknown region"}function Pe(e){if(!e)return[];const t=[],n=/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g;let r=0,o;for(;(o=n.exec(e))!==null;)o.index>r&&t.push({text:e.slice(r,o.index)}),t.push({text:o[1],url:o[2]}),r=o.index+o[0].length;return r<e.length&&t.push({text:e.slice(r)}),t.filter(i=>i.text.trim()||i.url)}function ze(e){const t=e==null?void 0:e.coordinateSpace,n=R(e),r=I(e),o=new Map(n.map(a=>[a.id,a])),i=new Map(r.map(a=>[a.id,a])),s=new Map;for(const a of r){const u=a.regionId;if(!u)continue;const f=s.get(u);f?f.push(a):s.set(u,[a])}const c=[];for(const a of r){const u=a.anchor;if(!u||u.type!=="marker")continue;const f=A(u.position,t);if(!f)continue;const m=a.camera,g=m?A(m.eye,t):null,b=m?A(m.target,t):null;c.push({annotation:a,position:f,...g&&b?{camera:{eye:g,target:b,...m!=null&&m.fov?{fov:m.fov}:{}}}:{}})}const l=new Set(n.filter(a=>a.visibilityDefault==="hidden").map(a=>a.id));return{payload:e,regions:n,regionsById:o,annotations:r,annotationsById:i,annotationsByRegion:s,markerAnchors:c,hiddenRegionIds:l}}function je(e){return e.isMesh===!0}function We(e,t,n=[]){var l;const r=new Map,o=new Map,i=new Map,s=new Map;for(const[a,u]of((t==null?void 0:t.meshes)??[]).entries())for(const f of u.primitives??[]){const m=(l=f.extras)==null?void 0:l.modelhubRegionId;typeof m=="string"&&m&&(s.set(a,m),u.name&&o.set(u.name,m))}for(const a of(t==null?void 0:t.nodes)??[]){if(a.mesh===void 0||!a.name)continue;const u=s.get(a.mesh);u&&i.set(a.name,u)}const c=new Set(n.map(a=>a.id));return e.traverse(a=>{var g,b;if(!je(a))return;const u=(b=(g=a.geometry)==null?void 0:g.userData)==null?void 0:b.modelhubRegionId,f=typeof u=="string"&&u||i.get(a.name)||o.get(a.name)||(c.has(a.name)?a.name:void 0);if(!f)return;const m=r.get(f);m?m.push(a):r.set(f,[a]),a.userData.modelhubOriginalMaterial===void 0&&(a.userData.modelhubOriginalMaterial=a.material)}),r}function qe(e){const t={};for(const[n,r]of e)t[n]=r.length;return t}function H(e,t,n){for(const r of e.get(t)??[])r.visible=n}function He(e,t){for(const n of e.keys())H(e,n,!t.has(n))}function Ye(e,t,n){for(const r of e.get(t)??[])r.material=n}function Ke(e,t){for(const n of e.get(t)??[]){const r=n.userData.modelhubOriginalMaterial;r&&(n.material=r)}}const Y="#2196f3",Ze="#ff5722";function B(e,t={}){const{fill:n=Y,text:r="#ffffff",textStroke:o="rgba(0, 0, 0, 0.45)"}=t,i=256,s=document.createElement("canvas");s.width=i,s.height=i;const c=s.getContext("2d");return c&&(c.beginPath(),c.arc(i/2,i/2,i/2-4,0,Math.PI*2),c.fillStyle=n,c.fill(),c.strokeStyle="#ffffff",c.lineWidth=8,c.stroke(),c.fillStyle=r,c.strokeStyle=o,c.lineWidth=10,c.font="bold 132px Arial, sans-serif",c.textAlign="center",c.textBaseline="middle",c.strokeText(String(e),i/2,i/2),c.fillText(String(e),i/2,i/2)),s}function K(e,t=.2,n){const r=new p.SpriteMaterial({map:new p.CanvasTexture(B(e,n)),transparent:!0,depthTest:!1}),o=new p.Sprite(r);return o.scale.set(t,t,1),o.renderOrder=999,o}function Xe(e,t,n){var o;const r=e.material;(o=r.map)==null||o.dispose(),r.map=new p.CanvasTexture(B(t,{fill:n})),r.needsUpdate=!0}function Qe(e,t,n=.2,r){return t.map((o,i)=>{const s=K(i+1,n,r);return s.position.set(...o.position),s.name=`modelhub_marker_${o.annotation.id}`,s.userData.annotationId=o.annotation.id,s.userData.displayNumber=i+1,e.add(s),s})}function Je(e){const{camera:t,model:n,anchors:r,width:o,height:i,isOccluded:s}=e,c=e.referenceDistance??1,l=new p.Vector3,a={};n.updateMatrixWorld();for(const u of r){l.set(...u.position).applyMatrix4(n.matrixWorld);const f=l.distanceTo(t.position),m=s?s(l,f):!1,g=l.clone().project(t);a[u.annotation.id]={x:(g.x*.5+.5)*o,y:(-g.y*.5+.5)*i,scale:Math.min(1.6,Math.max(.55,c/Math.max(f,.001))),zIndex:Math.max(1,Math.round((1-g.z)*1e5))+(m?0:2e5),inView:g.z<1&&g.x>-1.05&&g.x<1.05&&g.y>-1.05&&g.y<1.05,occluded:m}}return a}const Z=.03,et={enabled:!1,isOccluded:()=>!1,dispose:()=>{}};async function tt(e){var i;let t=[],n=[];if(e.traverse(s=>{if(!s.isMesh)return;const c=s.geometry;c!=null&&c.computeBoundsTree&&(t.push(c),n.push(s))}),!t.length)return et;for(const s of t)s.boundsTree||(i=s.computeBoundsTree)==null||i.call(s,{maxLeafTris:8});const r=new p.Raycaster;r.firstHitOnly=!0;const o=new p.Vector3;return{enabled:!0,isOccluded(s,c,l){return o.subVectors(c,s.position).normalize(),r.set(s.position,o),r.near=0,r.far=Math.max(0,l-Z),r.camera=s,r.intersectObjects(n,!1).length>0},dispose(){var s;for(const c of t)(s=c.disposeBoundsTree)==null||s.call(c);t=[],n=[]}}}const v={headlight:{ambient:.7,lights:[{color:[1,1,1],intensity:.9,position:[4,8,6]},{color:[1,1,1],intensity:2.4,position:[0,0,0],attach:!0,spot:!0}]},studio:{ambient:.85,lights:[{color:[.78,.8,1],intensity:1.45,position:[1.35,6.75,-7.26]},{color:[1,.88,.71],intensity:1.5,position:[-5.71,3.5,7.43]},{color:[.42,.74,1],intensity:.25,position:[7.23,6.78,1.29]}]},"dual-cam":{ambient:.6,lights:[{color:[.6,.48,.3],intensity:1.6,position:[-1,0,1],attach:!0},{color:[.42,.42,.6],intensity:1.6,position:[1,0,1],attach:!0}]},"studio-cam":{ambient:.7,lights:[{color:[.78,.8,1],intensity:1.35,position:[-1,.3,1],attach:!0},{color:[1,.88,.71],intensity:1.4,position:[1,.3,1],attach:!0},{color:[.42,.74,1],intensity:.25,position:[7.23,6.78,1.29]}]}},X="headlight";function nt(){return Object.keys(v)}function rt(e){var t;(t=e.parent)==null||t.remove(e)}function ot(e){var c;const{scene:t,camera:n,exposure:r=1}=e;(c=e.previous)==null||c.remove();const o=v[e.preset??""]??v[X],i=[],s=new p.AmbientLight(16777215,o.ambient*r);t.add(s),i.push(s);for(const l of o.lights){let a;if(l.spot){const f=new p.SpotLight(new p.Color(...l.color));f.angle=.5,f.penumbra=.9,f.decay=0,a=f}else a=new p.DirectionalLight(new p.Color(...l.color));a.intensity=l.intensity,a.position.set(...l.position);const u=a.target;l.attach?(u==null||u.position.set(0,0,l.spot?-1:0),n.add(a),u&&n.add(u)):(t.add(a),u&&t.add(u)),i.push(a),u&&i.push(u)}return{lights:i,remove(){for(const l of i)rt(l);i.length=0}}}const S=[{id:"white",label:"White",hex:"#ffffff",light:!0},{id:"light-grey",label:"Light gray",hex:"#d4d4d4",light:!0},{id:"medium-grey",label:"Medium gray",hex:"#808080",light:!1},{id:"dark-grey",label:"Dark gray",hex:"#252525",light:!1},{id:"black",label:"Black",hex:"#000000",light:!1}],Q="dark-grey";function J(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(n=>n+n).join("").toLowerCase()}`:""}function ee(e){const t=Number.parseInt(e.replace("#",""),16);return Number.isFinite(t)?(.299*(t>>16&255)+.587*(t>>8&255)+.114*(t&255))/255:0}function it(e,t){const n=J(t);return n?{id:"custom",label:"Custom",hex:n,light:ee(n)>.5}:S.find(r=>r.id===e)??S.find(r=>r.id===Q)??S[0]}const te=2;function O(e){e.updateMatrixWorld(!0);const t=new p.Box3,n=new p.Box3;return e.traverse(r=>{const o=r,i=r;o.isSkinnedMesh?(o.computeBoundingBox(),o.boundingBox&&(n.copy(o.boundingBox).applyMatrix4(o.matrixWorld),t.union(n))):i.isMesh&&i.geometry&&(i.geometry.boundingBox||i.geometry.computeBoundingBox(),i.geometry.boundingBox&&(n.copy(i.geometry.boundingBox).applyMatrix4(i.matrixWorld),t.union(n)))}),t.isEmpty()?new p.Box3().setFromObject(e):t}function st(e,t=te){const r=O(e).getSize(new p.Vector3),o=Math.max(r.x,r.y,r.z)||1,i=t/o;e.scale.multiplyScalar(i);const s=O(e);return e.position.sub(s.getCenter(new p.Vector3)),i}function at(e,t=1.3){return t/Math.tan(e*Math.PI/360)}const ne=.5,re=1.5;function ct(e,t,n={}){t.updateMatrixWorld();const r=new p.Vector3(...e.position).applyMatrix4(t.matrixWorld);if(e.camera){const l=new p.Vector3(...e.camera.eye).applyMatrix4(t.matrixWorld),u=new p.Vector3(...e.camera.target).applyMatrix4(t.matrixWorld).clone().sub(l);u.lengthSq()<1e-10&&u.copy(r).sub(l),u.normalize();const f=Math.max(r.distanceTo(l),.2);return{position:l,target:l.clone().addScaledVector(u,f),...e.camera.fov?{fov:e.camera.fov}:{}}}const o=n.outward??!0,i=new p.Vector3(r.x,0,r.z);i.lengthSq()<1e-8&&i.set(0,0,1),i.normalize();const s=o?-(n.outwardDistance??ne):n.inwardDistance??re,c=r.clone().addScaledVector(i,s);return c.y=r.y,{position:c,target:r}}const ut={cancel:()=>{}};function lt(e){const{camera:t,controls:n,to:r,onFrame:o,onDone:i}=e,s=()=>{o==null||o(),i==null||i()};if(e.reducedMotion)return t.position.copy(r.position),n.target.copy(r.target),n.update(),s(),ut;const c=e.durationMs??900,l=t.position.clone(),a=n.target.clone(),u=performance.now();let f=null;const m=g=>{const b=Math.min((g-u)/c,1),C=b*(2-b);t.position.lerpVectors(l,r.position,C),n.target.lerpVectors(a,r.target,C),n.update(),o==null||o(),b<1?f=requestAnimationFrame(m):(f=null,i==null||i())};return f=requestAnimationFrame(m),{cancel(){f!==null&&cancelAnimationFrame(f),f=null}}}function dt(e,t,n){const r=t||n;e.fov!==r&&(e.fov=r,e.updateProjectionMatrix())}const oe=500;function ft(e){var o,i,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`),(i=e.model)!=null&&i.altText&&t.push(e.model.altText);const n=((s=e.regions)==null?void 0:s.length)??0,r=I(e).length;return n&&t.push(`${n} labeled ${n===1?"region":"regions"}`),r&&t.push(`${r} ${r===1?"annotation":"annotations"}`),t.map(c=>c.replace(/\.$/,"")).join(". ")+"."}function mt(e,t,n){return`Annotation ${t+1} of ${n}: ${e||"Untitled"}.`}function ht(e,t=oe,n=()=>Date.now()){let r=-1/0,o=null,i=null;const s=a=>{r=n(),o=null,e(a)};return{announce:a=>{const u=n()-r;if(u>=t){s(a);return}o=a,i||(i=setTimeout(()=>{i=null,o!==null&&s(o)},t-u))},flush:()=>{i&&(clearTimeout(i),i=null),o!==null&&s(o)}}}function D(e,t){return`## ${e}
 ${t}
 
-`}function ft(e,t={}){const n=e.model??{},o=B(e),r=I(e);let i=`# ${n.title||"Untitled model"}
+`}function pt(e,t={}){const n=e.model??{},r=R(e),o=I(e);let i=`# ${n.title||"Untitled model"}
 
-`;if(n.altText&&(i+=D(t.summaryHeading??"Summary",n.altText)),n.longDescription&&(i+=D("Full description",n.longDescription)),o.length){i+=`## Regions (${o.length})
+`;if(n.altText&&(i+=D(t.summaryHeading??"Summary",n.altText)),n.longDescription&&(i+=D("Full description",n.longDescription)),r.length){i+=`## Regions (${r.length})
 
-`;for(const s of o)i+=`### ${M(s)}
+`;for(const s of r)i+=`### ${M(s)}
 ${s.description||"No description."}
 
-`}return r.length&&(i+=`## Annotations (${r.length})
+`}return o.length&&(i+=`## Annotations (${o.length})
 
-`,r.forEach((s,c)=>{const l=s.regionId?` (${M(o.find(u=>u.id===s.regionId))})`:"",a=`${c+1}. ${s.title||"Untitled"}${l}`;i+=`### ${a}
+`,o.forEach((s,c)=>{const l=s.regionId?` (${M(r.find(u=>u.id===s.regionId))})`:"",a=`${c+1}. ${s.title||"Untitled"}${l}`;i+=`### ${a}
 ${s.body||"No description."}
 
 `})),i+=`## Licensing
@@ -18,4 +18,4 @@ ${s.body||"No description."}
 `,i+=`- **Attribution:** ${n.attribution||"Not specified"}
 `,i+=`- **Creator:** ${n.creator||"Not specified"}
 `,i+=`- **Source:** ${n.source||"Not specified"}
-`,i}function mt(e){var n;return`${(((n=e.model)==null?void 0:n.title)||"model").trim().replace(/[^\w\-. ]+/g,"").replace(/\s+/g,"_")||"model"}_transcript.md`}function ht(e){e&&e.traverse(t=>{var i,s;const n=t,o=n.geometry;o&&(o.boundsTree&&o.disposeBoundsTree&&o.disposeBoundsTree(),(i=o.dispose)==null||i.call(o));const r=[].concat(n.material??[]);for(const c of r)if(c){for(const l of Object.values(c)){const a=l;a&&a.isTexture&&a.dispose()}(s=c.dispose)==null||s.call(c)}})}exports.BACKGROUND_OPTIONS=S;exports.CAMERA_ANNOUNCE_INTERVAL=oe;exports.DEFAULT_BACKGROUND=X;exports.DEFAULT_LIGHTING=Z;exports.LIGHTING_PRESETS=v;exports.MARKER_FILL=H;exports.MARKER_FILL_ACTIVE=He;exports.NORMALIZED_SIZE=ee;exports.OCCLUSION_BIAS=K;exports.TOUR_DISTANCE_INWARD=ne;exports.TOUR_DISTANCE_OUTWARD=te;exports.annotationSummary=lt;exports.annotationsInReadingOrder=I;exports.applyFov=ct;exports.applyLighting=tt;exports.applyVisibilityDefaults=je;exports.buildRegionMeshMap=Pe;exports.buildTranscript=ft;exports.clearRegionHighlight=qe;exports.computeDisplayBox=O;exports.computeTourPlacement=it;exports.createAnnouncer=dt;exports.createMarkerSprite=Y;exports.createMarkerSprites=Ke;exports.createOcclusionIndex=Qe;exports.disposeSceneGraph=ht;exports.distanceForFov=rt;exports.drawMarkerCanvas=C;exports.errorsOf=G;exports.fetchBytes=z;exports.flyCamera=at;exports.frameModel=ot;exports.fromViewerPosition=Ue;exports.highlightRegion=We;exports.isGlbParseError=_e;exports.isVec3=T;exports.lightingPresetNames=Je;exports.loadModel=ke;exports.logFindings=De;exports.luminance=J;exports.modelSummary=ut;exports.needsConversion=N;exports.normalizeAnnotationIds=W;exports.normalizeHexColor=Q;exports.normalizeModel=Ve;exports.parseBodySegments=Fe;exports.projectMarkers=Ze;exports.readEmbedded=j;exports.regionBindingCounts=ze;exports.regionLabel=M;exports.regionsInOrder=B;exports.resolveBackground=nt;exports.resourcePathFor=Ee;exports.setMarkerSpriteColor=Ye;exports.setRegionVisible=q;exports.sidecarUrlFor=P;exports.toViewerPosition=A;exports.transcriptFileName=mt;
+`,i}function gt(e){var n;return`${(((n=e.model)==null?void 0:n.title)||"model").trim().replace(/[^\w\-. ]+/g,"").replace(/\s+/g,"_")||"model"}_transcript.md`}function yt(e){e&&e.traverse(t=>{var i,s;const n=t,r=n.geometry;r&&(r.boundsTree&&r.disposeBoundsTree&&r.disposeBoundsTree(),(i=r.dispose)==null||i.call(r));const o=[].concat(n.material??[]);for(const c of o)if(c){for(const l of Object.values(c)){const a=l;a&&a.isTexture&&a.dispose()}(s=c.dispose)==null||s.call(c)}})}exports.BACKGROUND_OPTIONS=S;exports.CAMERA_ANNOUNCE_INTERVAL=oe;exports.DEFAULT_BACKGROUND=Q;exports.DEFAULT_LIGHTING=X;exports.LIGHTING_PRESETS=v;exports.MARKER_FILL=Y;exports.MARKER_FILL_ACTIVE=Ze;exports.NORMALIZED_SIZE=te;exports.OCCLUSION_BIAS=Z;exports.TOUR_DISTANCE_INWARD=re;exports.TOUR_DISTANCE_OUTWARD=ne;exports.annotationSummary=mt;exports.annotationsInReadingOrder=I;exports.applyFov=dt;exports.applyLighting=ot;exports.applyVisibilityDefaults=He;exports.buildRegionMeshMap=We;exports.buildTranscript=pt;exports.clearRegionHighlight=Ke;exports.computeDisplayBox=O;exports.computeTourPlacement=ct;exports.createAnnouncer=ht;exports.createMarkerSprite=K;exports.createMarkerSprites=Qe;exports.createOcclusionIndex=tt;exports.disposeSceneGraph=yt;exports.distanceForFov=at;exports.drawMarkerCanvas=B;exports.errorsOf=V;exports.fetchBytes=z;exports.flyCamera=lt;exports.frameModel=st;exports.fromViewerPosition=Fe;exports.highlightRegion=Ye;exports.isAuthoredRegion=q;exports.isGlbParseError=Ue;exports.isVec3=T;exports.lightingPresetNames=nt;exports.loadModel=De;exports.logFindings=_e;exports.luminance=ee;exports.modelSummary=ft;exports.needsConversion=N;exports.normalizeAnnotationIds=W;exports.normalizeHexColor=J;exports.normalizeModel=ze;exports.parseBodySegments=Pe;exports.projectMarkers=Je;exports.readEmbedded=j;exports.readableRegions=Ve;exports.regionBindingCounts=qe;exports.regionLabel=M;exports.regionsInOrder=R;exports.resolveBackground=it;exports.resourcePathFor=ke;exports.setMarkerSpriteColor=Xe;exports.setRegionVisible=H;exports.sidecarUrlFor=P;exports.toViewerPosition=A;exports.transcriptFileName=gt;

package/dist/index.d.ts

@@ -7,13 +7,13 @@
  * placing annotation markers, and moving the camera to them.
  *
  * Nothing here renders or owns a scene. A host brings its own three.js
- * renderer and its own UI; this package supplies the behaviour underneath so
+ * renderer and its own UI; this package supplies the behavior underneath so
  * two viewers of the same model agree about what it says.
  */
 export { errorsOf, fetchBytes, loadModel, logFindings, isGlbParseError, readEmbedded, resourcePathFor, sidecarUrlFor, type LoadOptions, type LoadedModel, type MetadataResult, type MetadataSource } from "./metadata.js";
 export type { Annotation, AnnotationCamera, EduModelHub, ModelLicense, ModelMetadata, ModelSource, Region, ValidationResult, ValidationSeverity, VisibilityDefault } from "./types.js";
 export { fromViewerPosition, isVec3, needsConversion, toViewerPosition, type Vec3 } from "./coordinates.js";
-export { annotationsInReadingOrder, normalizeAnnotationIds, normalizeModel, parseBodySegments, regionLabel, regionsInOrder, type BodySegment, type IdentifiedAnnotation, type MarkerAnchor, type NormalizedModel } from "./normalize.js";
+export { annotationsInReadingOrder, isAuthoredRegion, normalizeAnnotationIds, normalizeModel, parseBodySegments, readableRegions, regionLabel, regionsInOrder, type BodySegment, type IdentifiedAnnotation, type MarkerAnchor, type NormalizedModel } from "./normalize.js";
 export { applyVisibilityDefaults, buildRegionMeshMap, clearRegionHighlight, highlightRegion, regionBindingCounts, setRegionVisible, type GltfJsonLike, type RegionMeshMap } from "./regions.js";
 export { MARKER_FILL, MARKER_FILL_ACTIVE, createMarkerSprite, createMarkerSprites, drawMarkerCanvas, projectMarkers, setMarkerSpriteColor, type MarkerColors, type MarkerScreenPosition, type ProjectMarkersOptions } from "./markers.js";
 export { OCCLUSION_BIAS, createOcclusionIndex, type OcclusionIndex } from "./occlusion.js";

package/dist/index.js

@@ -1,5 +1,5 @@
-import { SpriteMaterial as j, CanvasTexture as E, Sprite as W, Vector3 as b, Raycaster as q, AmbientLight as Y, SpotLight as H, Color as T, DirectionalLight as K, Box3 as v } from "three";
-const R = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+import { SpriteMaterial as V, CanvasTexture as E, Sprite as W, Vector3 as b, Raycaster as q, AmbientLight as Y, SpotLight as H, Color as T, DirectionalLight as X, Box3 as v } from "three";
+const C = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
 function _(e, t) {
   const n = /* @__PURE__ */ new WeakSet(), o = [
     { value: e, path: "" }
@@ -16,19 +16,19 @@ function _(e, t) {
         t(i, s, r);
   }
 }
-function X(e) {
+function K(e) {
   const t = [];
   return _(e, (n, o, r) => {
     for (const i of Object.keys(n)) {
       const s = o === "" ? i : `${o}.${i}`;
-      R.has(i) ? t.push({ path: s, key: i }) : r(n[i], s);
+      C.has(i) ? t.push({ path: s, key: i }) : r(n[i], s);
     }
   }), t;
 }
 function Z(e) {
   return _(e, (t, n, o) => {
     for (const r of Object.keys(t))
-      R.has(r) ? delete t[r] : o(t[r], n);
+      C.has(r) ? delete t[r] : o(t[r], n);
   }), e;
 }
 const N = 1179937895, k = 2, Q = 1313821514, J = 21;
@@ -149,7 +149,7 @@ function F(e) {
   return ye(n.annotations, o, t), t;
 }
 function ce(e, t) {
-  for (const n of X(e))
+  for (const n of K(e))
     t.push(
       d(
         n.path,
@@ -457,7 +457,7 @@ function Oe(e) {
   const o = t.replace(/\.glb$/i, ".modelhub.json");
   return n ? `${o}?${n}` : o;
 }
-function He(e, t) {
+function Ke(e, t) {
   var i;
   if (!e || e.startsWith("blob:") || e.startsWith("data:")) return "";
   const n = t ?? ((i = globalThis.location) == null ? void 0 : i.href), o = n ? new URL(e, n).href : e, r = o.lastIndexOf("/");
@@ -481,7 +481,7 @@ function Ne(e) {
   const n = F(t);
   return { payload: t, source: "embedded", findings: n, problem: null };
 }
-async function Ke(e, t = {}) {
+async function Ze(e, t = {}) {
   const n = t.fetchImpl ?? fetch, o = await Te(e, n), r = Ne(o);
   if (r.payload) return { ...r, bytes: o };
   if (t.sidecar === !1) return { ...r, bytes: o };
@@ -509,7 +509,7 @@ async function Ke(e, t = {}) {
     bytes: o
   };
 }
-function Xe(e, t = "EDU_modelhub", n = console) {
+function Qe(e, t = "EDU_modelhub", n = console) {
   if (!(e != null && e.length)) return;
   const o = Me(e), r = e.filter((i) => i.severity !== "error");
   o.length && n.warn(`${t}: ${o.length} validation error(s)`, o), r.length && n.info(
@@ -517,24 +517,24 @@ function Xe(e, t = "EDU_modelhub", n = console) {
     r
   );
 }
-function Ze(e) {
+function Je(e) {
   return (e == null ? void 0 : e.name) === "GlbParseError";
 }
 function G(e) {
   return Array.isArray(e) && e.length === 3 && e.every((t) => typeof t == "number" && Number.isFinite(t));
 }
-function z(e) {
+function P(e) {
   return e === "blender";
 }
 function A(e, t) {
   if (!G(e)) return null;
   const [n, o, r] = e;
-  return z(t) ? [n, r, -o] : [n, o, r];
+  return P(t) ? [n, r, -o] : [n, o, r];
 }
-function Qe(e, t) {
+function et(e, t) {
   if (!G(e)) return null;
   const [n, o, r] = e;
-  return z(t) ? [n, -r, o] : [n, o, r];
+  return P(t) ? [n, -r, o] : [n, o, r];
 }
 function ke(e) {
   if (!Array.isArray(e)) return [];
@@ -552,16 +552,30 @@ function M(e) {
     (o, r) => n(o.annotation) - n(r.annotation) || o.index - r.index
   ).map((o) => o.annotation);
 }
-function P(e) {
+function z(e) {
   return (Array.isArray(e == null ? void 0 : e.regions) ? e.regions : []).map((n, o) => ({ region: n, index: o })).sort(
     (n, o) => (n.region.order ?? Number.MAX_SAFE_INTEGER) - (o.region.order ?? Number.MAX_SAFE_INTEGER) || n.index - o.index
   ).map((n) => n.region);
 }
+const Be = "Auto-created from object ";
+function Le(e) {
+  var n;
+  const t = (n = e == null ? void 0 : e.description) == null ? void 0 : n.trim();
+  return t ? !t.startsWith(Be) : !1;
+}
+function tt(e) {
+  return Array.isArray(e) ? e.filter(
+    (t) => {
+      var n;
+      return Le(t) || !((n = t.description) != null && n.trim());
+    }
+  ) : [];
+}
 function L(e) {
   var t;
   return e ? ((t = e.label) == null ? void 0 : t.trim()) || e.id || "Unnamed region" : "Unknown region";
 }
-function Je(e) {
+function nt(e) {
   if (!e) return [];
   const t = [], n = /\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g;
   let o = 0, r;
@@ -569,8 +583,8 @@ function Je(e) {
     r.index > o && t.push({ text: e.slice(o, r.index) }), t.push({ text: r[1], url: r[2] }), o = r.index + r[0].length;
   return o < e.length && t.push({ text: e.slice(o) }), t.filter((i) => i.text.trim() || i.url);
 }
-function et(e) {
-  const t = e == null ? void 0 : e.coordinateSpace, n = P(e), o = M(e), r = new Map(n.map((a) => [a.id, a])), i = new Map(
+function ot(e) {
+  const t = e == null ? void 0 : e.coordinateSpace, n = z(e), o = M(e), r = new Map(n.map((a) => [a.id, a])), i = new Map(
     o.map((a) => [a.id, a])
   ), s = /* @__PURE__ */ new Map();
   for (const a of o) {
@@ -612,10 +626,10 @@ function et(e) {
     hiddenRegionIds: l
   };
 }
-function Be(e) {
+function De(e) {
   return e.isMesh === !0;
 }
-function tt(e, t, n = []) {
+function rt(e, t, n = []) {
   var l;
   const o = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map();
   for (const [a, u] of ((t == null ? void 0 : t.meshes) ?? []).entries())
@@ -631,38 +645,38 @@ function tt(e, t, n = []) {
   const c = new Set(n.map((a) => a.id));
   return e.traverse((a) => {
     var p, y;
-    if (!Be(a)) return;
+    if (!De(a)) return;
     const u = (y = (p = a.geometry) == null ? void 0 : p.userData) == null ? void 0 : y.modelhubRegionId, f = typeof u == "string" && u || i.get(a.name) || r.get(a.name) || (c.has(a.name) ? a.name : void 0);
     if (!f) return;
     const m = o.get(f);
     m ? m.push(a) : o.set(f, [a]), a.userData.modelhubOriginalMaterial === void 0 && (a.userData.modelhubOriginalMaterial = a.material);
   }), o;
 }
-function nt(e) {
+function it(e) {
   const t = {};
   for (const [n, o] of e) t[n] = o.length;
   return t;
 }
-function Le(e, t, n) {
+function Re(e, t, n) {
   for (const o of e.get(t) ?? []) o.visible = n;
 }
-function ot(e, t) {
+function st(e, t) {
   for (const n of e.keys())
-    Le(e, n, !t.has(n));
+    Re(e, n, !t.has(n));
 }
-function rt(e, t, n) {
+function at(e, t, n) {
   for (const o of e.get(t) ?? []) o.material = n;
 }
-function it(e, t) {
+function ct(e, t) {
   for (const n of e.get(t) ?? []) {
     const o = n.userData.modelhubOriginalMaterial;
     o && (n.material = o);
   }
 }
-const De = "#2196f3", st = "#ff5722";
-function V(e, t = {}) {
+const Ee = "#2196f3", ut = "#ff5722";
+function j(e, t = {}) {
   const {
-    fill: n = De,
+    fill: n = Ee,
     text: o = "#ffffff",
     textStroke: r = "rgba(0, 0, 0, 0.45)"
   } = t, i = 256, s = document.createElement("canvas");
@@ -671,25 +685,25 @@ function V(e, t = {}) {
   return c && (c.beginPath(), c.arc(i / 2, i / 2, i / 2 - 4, 0, Math.PI * 2), c.fillStyle = n, c.fill(), c.strokeStyle = "#ffffff", c.lineWidth = 8, c.stroke(), c.fillStyle = o, c.strokeStyle = r, c.lineWidth = 10, c.font = "bold 132px Arial, sans-serif", c.textAlign = "center", c.textBaseline = "middle", c.strokeText(String(e), i / 2, i / 2), c.fillText(String(e), i / 2, i / 2)), s;
 }
 function Ce(e, t = 0.2, n) {
-  const o = new j({
-    map: new E(V(e, n)),
+  const o = new V({
+    map: new E(j(e, n)),
     transparent: !0,
     depthTest: !1
   }), r = new W(o);
   return r.scale.set(t, t, 1), r.renderOrder = 999, r;
 }
-function at(e, t, n) {
+function lt(e, t, n) {
   var r;
   const o = e.material;
-  (r = o.map) == null || r.dispose(), o.map = new E(V(t, { fill: n })), o.needsUpdate = !0;
+  (r = o.map) == null || r.dispose(), o.map = new E(j(t, { fill: n })), o.needsUpdate = !0;
 }
-function ct(e, t, n = 0.2, o) {
+function dt(e, t, n = 0.2, o) {
   return t.map((r, i) => {
     const s = Ce(i + 1, n, o);
     return s.position.set(...r.position), s.name = `modelhub_marker_${r.annotation.id}`, s.userData.annotationId = r.annotation.id, s.userData.displayNumber = i + 1, e.add(s), s;
   });
 }
-function ut(e) {
+function ft(e) {
   const { camera: t, model: n, anchors: o, width: r, height: i, isOccluded: s } = e, c = e.referenceDistance ?? 1, l = new b(), a = {};
   n.updateMatrixWorld();
   for (const u of o) {
@@ -709,20 +723,20 @@ function ut(e) {
   }
   return a;
 }
-const Ee = 0.03, Re = {
+const _e = 0.03, Ue = {
   enabled: !1,
   isOccluded: () => !1,
   dispose: () => {
   }
 };
-async function lt(e) {
+async function mt(e) {
   var i;
   let t = [], n = [];
   if (e.traverse((s) => {
     if (!s.isMesh) return;
     const c = s.geometry;
     c != null && c.computeBoundsTree && (t.push(c), n.push(s));
-  }), !t.length) return Re;
+  }), !t.length) return Ue;
   for (const s of t)
     s.boundsTree || (i = s.computeBoundsTree) == null || i.call(s, { maxLeafTris: 8 });
   const o = new q();
@@ -731,7 +745,7 @@ async function lt(e) {
   return {
     enabled: !0,
     isOccluded(s, c, l) {
-      return r.subVectors(c, s.position).normalize(), o.set(s.position, r), o.near = 0, o.far = Math.max(0, l - Ee), o.camera = s, o.intersectObjects(n, !1).length > 0;
+      return r.subVectors(c, s.position).normalize(), o.set(s.position, r), o.near = 0, o.far = Math.max(0, l - _e), o.camera = s, o.intersectObjects(n, !1).length > 0;
     },
     dispose() {
       var s;
@@ -797,19 +811,19 @@ const I = {
       { color: [0.42, 0.74, 1], intensity: 0.25, position: [7.23, 6.78, 1.29] }
     ]
   }
-}, _e = "headlight";
-function dt() {
+}, Fe = "headlight";
+function ht() {
   return Object.keys(I);
 }
-function Ue(e) {
+function Ge(e) {
   var t;
   (t = e.parent) == null || t.remove(e);
 }
-function ft(e) {
+function pt(e) {
   var c;
   const { scene: t, camera: n, exposure: o = 1 } = e;
   (c = e.previous) == null || c.remove();
-  const r = I[e.preset ?? ""] ?? I[_e], i = [], s = new Y(16777215, r.ambient * o);
+  const r = I[e.preset ?? ""] ?? I[Fe], i = [], s = new Y(16777215, r.ambient * o);
   t.add(s), i.push(s);
   for (const l of r.lights) {
     let a;
@@ -817,7 +831,7 @@ function ft(e) {
       const f = new H(new T(...l.color));
       f.angle = 0.5, f.penumbra = 0.9, f.decay = 0, a = f;
     } else
-      a = new K(new T(...l.color));
+      a = new X(new T(...l.color));
     a.intensity = l.intensity, a.position.set(...l.position);
     const u = a.target;
     l.attach ? (u == null || u.position.set(0, 0, l.spot ? -1 : 0), n.add(a), u && n.add(u)) : (t.add(a), u && t.add(u)), i.push(a), u && i.push(u);
@@ -825,37 +839,37 @@ function ft(e) {
   return {
     lights: i,
     remove() {
-      for (const l of i) Ue(l);
+      for (const l of i) Ge(l);
       i.length = 0;
     }
   };
 }
 const S = [
   { 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: "light-grey", label: "Light gray", hex: "#d4d4d4", light: !0 },
+  { id: "medium-grey", label: "Medium gray", hex: "#808080", light: !1 },
+  { id: "dark-grey", label: "Dark gray", hex: "#252525", light: !1 },
   { id: "black", label: "Black", hex: "#000000", light: !1 }
-], Fe = "dark-grey";
-function Ge(e) {
+], Pe = "dark-grey";
+function ze(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((n) => n + n).join("").toLowerCase()}` : "";
 }
-function ze(e) {
+function je(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 mt(e, t) {
-  const n = Ge(t);
+function gt(e, t) {
+  const n = ze(t);
   return n ? {
     id: "custom",
     label: "Custom",
     hex: n,
-    light: ze(n) > 0.5
-  } : S.find((o) => o.id === e) ?? S.find((o) => o.id === Fe) ?? S[0];
+    light: je(n) > 0.5
+  } : S.find((o) => o.id === e) ?? S.find((o) => o.id === Pe) ?? S[0];
 }
-const Pe = 2;
+const Ve = 2;
 function D(e) {
   e.updateMatrixWorld(!0);
   const t = new v(), n = new v();
@@ -864,17 +878,17 @@ function D(e) {
     r.isSkinnedMesh ? (r.computeBoundingBox(), r.boundingBox && (n.copy(r.boundingBox).applyMatrix4(r.matrixWorld), t.union(n))) : i.isMesh && i.geometry && (i.geometry.boundingBox || i.geometry.computeBoundingBox(), i.geometry.boundingBox && (n.copy(i.geometry.boundingBox).applyMatrix4(i.matrixWorld), t.union(n)));
   }), t.isEmpty() ? new v().setFromObject(e) : t;
 }
-function ht(e, t = Pe) {
+function yt(e, t = Ve) {
   const o = D(e).getSize(new b()), r = Math.max(o.x, o.y, o.z) || 1, i = t / r;
   e.scale.multiplyScalar(i);
   const s = D(e);
   return e.position.sub(s.getCenter(new b())), i;
 }
-function pt(e, t = 1.3) {
+function bt(e, t = 1.3) {
   return t / Math.tan(e * Math.PI / 360);
 }
-const Ve = 0.5, je = 1.5;
-function gt(e, t, n = {}) {
+const We = 0.5, qe = 1.5;
+function $t(e, t, n = {}) {
   t.updateMatrixWorld();
   const o = new b(...e.position).applyMatrix4(
     t.matrixWorld
@@ -895,17 +909,17 @@ function gt(e, t, n = {}) {
   }
   const r = n.outward ?? !0, i = new b(o.x, 0, o.z);
   i.lengthSq() < 1e-8 && i.set(0, 0, 1), i.normalize();
-  const s = r ? -(n.outwardDistance ?? Ve) : n.inwardDistance ?? je, c = o.clone().addScaledVector(i, s);
+  const s = r ? -(n.outwardDistance ?? We) : n.inwardDistance ?? qe, c = o.clone().addScaledVector(i, s);
   return c.y = o.y, { position: c, target: o };
 }
-const We = { cancel: () => {
+const Ye = { cancel: () => {
 } };
-function yt(e) {
+function wt(e) {
   const { camera: t, controls: n, to: o, onFrame: r, onDone: i } = e, s = () => {
     r == null || r(), i == null || i();
   };
   if (e.reducedMotion)
-    return t.position.copy(o.position), n.target.copy(o.target), n.update(), s(), We;
+    return t.position.copy(o.position), n.target.copy(o.target), n.update(), s(), Ye;
   const c = e.durationMs ?? 900, l = t.position.clone(), a = n.target.clone(), u = performance.now();
   let f = null;
   const m = (p) => {
@@ -918,26 +932,26 @@ function yt(e) {
     }
   };
 }
-function bt(e, t, n) {
+function xt(e, t, n) {
   const o = t || n;
   e.fov !== o && (e.fov = o, e.updateProjectionMatrix());
 }
-const qe = 500;
-function $t(e) {
+const He = 500;
+function vt(e) {
   var r, i, s;
   if (!e)
     return "Model loaded, but it carries no educational metadata.";
   const t = [];
   (r = e.model) != null && r.title && t.push(`${e.model.title} loaded`), (i = e.model) != null && i.altText && t.push(e.model.altText);
   const n = ((s = e.regions) == null ? void 0 : s.length) ?? 0, o = M(e).length;
-  return n && t.push(`${n} labelled ${n === 1 ? "region" : "regions"}`), o && t.push(
+  return n && t.push(`${n} labeled ${n === 1 ? "region" : "regions"}`), o && t.push(
     `${o} ${o === 1 ? "annotation" : "annotations"}`
   ), t.map((c) => c.replace(/\.$/, "")).join(". ") + ".";
 }
-function wt(e, t, n) {
+function At(e, t, n) {
   return `Annotation ${t + 1} of ${n}: ${e || "Untitled"}.`;
 }
-function xt(e, t = qe, n = () => Date.now()) {
+function St(e, t = He, n = () => Date.now()) {
   let o = -1 / 0, r = null, i = null;
   const s = (a) => {
     o = n(), r = null, e(a);
@@ -955,18 +969,18 @@ function xt(e, t = qe, n = () => Date.now()) {
     i && (clearTimeout(i), i = null), r !== null && s(r);
   } };
 }
-function C(e, t) {
+function R(e, t) {
   return `## ${e}
 ${t}
 
 `;
 }
-function vt(e, t = {}) {
-  const n = e.model ?? {}, o = P(e), r = M(e);
+function It(e, t = {}) {
+  const n = e.model ?? {}, o = z(e), r = M(e);
   let i = `# ${n.title || "Untitled model"}
 
 `;
-  if (n.altText && (i += C(t.summaryHeading ?? "Summary", n.altText)), n.longDescription && (i += C("Full description", n.longDescription)), o.length) {
+  if (n.altText && (i += R(t.summaryHeading ?? "Summary", n.altText)), n.longDescription && (i += R("Full description", n.longDescription)), o.length) {
     i += `## Regions (${o.length})
 
 `;
@@ -991,11 +1005,11 @@ ${s.body || "No description."}
 `, i += `- **Source:** ${n.source || "Not specified"}
 `, i;
 }
-function At(e) {
+function Mt(e) {
   var n;
   return `${(((n = e.model) == null ? void 0 : n.title) || "model").trim().replace(/[^\w\-. ]+/g, "").replace(/\s+/g, "_") || "model"}_transcript.md`;
 }
-function St(e) {
+function Ot(e) {
   e && e.traverse((t) => {
     var i, s;
     const n = t, o = n.geometry;
@@ -1015,61 +1029,63 @@ function St(e) {
 }
 export {
   S as BACKGROUND_OPTIONS,
-  qe as CAMERA_ANNOUNCE_INTERVAL,
-  Fe as DEFAULT_BACKGROUND,
-  _e as DEFAULT_LIGHTING,
+  He as CAMERA_ANNOUNCE_INTERVAL,
+  Pe as DEFAULT_BACKGROUND,
+  Fe as DEFAULT_LIGHTING,
   I as LIGHTING_PRESETS,
-  De as MARKER_FILL,
-  st as MARKER_FILL_ACTIVE,
-  Pe as NORMALIZED_SIZE,
-  Ee as OCCLUSION_BIAS,
-  je as TOUR_DISTANCE_INWARD,
-  Ve as TOUR_DISTANCE_OUTWARD,
-  wt as annotationSummary,
+  Ee as MARKER_FILL,
+  ut as MARKER_FILL_ACTIVE,
+  Ve as NORMALIZED_SIZE,
+  _e as OCCLUSION_BIAS,
+  qe as TOUR_DISTANCE_INWARD,
+  We as TOUR_DISTANCE_OUTWARD,
+  At as annotationSummary,
   M as annotationsInReadingOrder,
-  bt as applyFov,
-  ft as applyLighting,
-  ot as applyVisibilityDefaults,
-  tt as buildRegionMeshMap,
-  vt as buildTranscript,
-  it as clearRegionHighlight,
+  xt as applyFov,
+  pt as applyLighting,
+  st as applyVisibilityDefaults,
+  rt as buildRegionMeshMap,
+  It as buildTranscript,
+  ct as clearRegionHighlight,
   D as computeDisplayBox,
-  gt as computeTourPlacement,
-  xt as createAnnouncer,
+  $t as computeTourPlacement,
+  St as createAnnouncer,
   Ce as createMarkerSprite,
-  ct as createMarkerSprites,
-  lt as createOcclusionIndex,
-  St as disposeSceneGraph,
-  pt as distanceForFov,
-  V as drawMarkerCanvas,
+  dt as createMarkerSprites,
+  mt as createOcclusionIndex,
+  Ot as disposeSceneGraph,
+  bt as distanceForFov,
+  j as drawMarkerCanvas,
   Me as errorsOf,
   Te as fetchBytes,
-  yt as flyCamera,
-  ht as frameModel,
-  Qe as fromViewerPosition,
-  rt as highlightRegion,
-  Ze as isGlbParseError,
+  wt as flyCamera,
+  yt as frameModel,
+  et as fromViewerPosition,
+  at as highlightRegion,
+  Le as isAuthoredRegion,
+  Je as isGlbParseError,
   G as isVec3,
-  dt as lightingPresetNames,
-  Ke as loadModel,
-  Xe as logFindings,
-  ze as luminance,
-  $t as modelSummary,
-  z as needsConversion,
+  ht as lightingPresetNames,
+  Ze as loadModel,
+  Qe as logFindings,
+  je as luminance,
+  vt as modelSummary,
+  P as needsConversion,
   ke as normalizeAnnotationIds,
-  Ge as normalizeHexColor,
-  et as normalizeModel,
-  Je as parseBodySegments,
-  ut as projectMarkers,
+  ze as normalizeHexColor,
+  ot as normalizeModel,
+  nt as parseBodySegments,
+  ft as projectMarkers,
   Ne as readEmbedded,
-  nt as regionBindingCounts,
+  tt as readableRegions,
+  it as regionBindingCounts,
   L as regionLabel,
-  P as regionsInOrder,
-  mt as resolveBackground,
-  He as resourcePathFor,
-  at as setMarkerSpriteColor,
-  Le as setRegionVisible,
+  z as regionsInOrder,
+  gt as resolveBackground,
+  Ke as resourcePathFor,
+  lt as setMarkerSpriteColor,
+  Re as setRegionVisible,
   Oe as sidecarUrlFor,
   A as toViewerPosition,
-  At as transcriptFileName
+  Mt as transcriptFileName
 };

package/dist/lighting.d.ts

@@ -2,7 +2,7 @@
  * 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
+ * organization'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.
  *

package/dist/markers.d.ts

@@ -12,15 +12,15 @@
 import { Sprite, Vector3 } from "three";
 import type { Camera, Object3D } from "three";
 import type { MarkerAnchor } from "./normalize.js";
-/** Colours for a marker's circle and number. */
+/** Colors for a marker's circle and number. */
 export interface MarkerColors {
     fill?: string;
     text?: string;
     textStroke?: string;
 }
-/** Default unselected marker colour. */
+/** Default unselected marker color. */
 export declare const MARKER_FILL = "#2196f3";
-/** Default selected marker colour. */
+/** Default selected marker color. */
 export declare const MARKER_FILL_ACTIVE = "#ff5722";
 /**
  * Draw a numbered marker: a filled circle, a white ring, and the number.
@@ -35,7 +35,7 @@ export declare function drawMarkerCanvas(value: number | string, colors?: Marker
  * `occlusion.ts` rather than by the depth buffer.
  */
 export declare function createMarkerSprite(value: number | string, scale?: number, colors?: MarkerColors): Sprite;
-/** Redraw a sprite's texture in a new colour, disposing the old one. */
+/** Redraw a sprite's texture in a new color, disposing the old one. */
 export declare function setMarkerSpriteColor(sprite: Sprite, value: number | string, fill: string): void;
 /**
  * Add one sprite per marker anchor, parented to the model so they inherit

package/dist/normalize.d.ts

@@ -57,6 +57,15 @@ export declare function normalizeAnnotationIds(annotations: readonly Annotation[
 export declare function annotationsInReadingOrder(payload: EduModelHub): IdentifiedAnnotation[];
 /** Regions sorted by `order`, ties keeping storage order. */
 export declare function regionsInOrder(payload: EduModelHub): Region[];
+/** True when a region carries a description an author actually wrote. */
+export declare function isAuthoredRegion(region: Region | undefined): boolean;
+/**
+ * Regions worth showing in a reading view: those an author described, or
+ * those left undescribed but given a real name. A region the tool invented
+ * outright is dropped, so a model nobody annotated shows no region list at
+ * all rather than a wall of object names.
+ */
+export declare function readableRegions(regions: readonly Region[] | undefined): Region[];
 /** Display name for a region, falling back to its id. */
 export declare function regionLabel(region: Region | undefined): string;
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@harpern/edu-modelhub-viewer-core",
-  "version": "0.1.0-beta.1",
-  "description": "Framework-agnostic viewer core for EDU_modelhub models: metadata loading, normalization, region binding, annotation markers, and camera behaviour shared by every conforming viewer",
+  "version": "0.1.0-beta.3",
+  "description": "Framework-agnostic viewer core for EDU_modelhub models: metadata loading, normalization, region binding, annotation markers, and camera behavior shared by every conforming viewer",
   "license": "Apache-2.0",
   "author": "Oregon State University Ecampus",
   "contributors": [