@readium/shared 2.5.1 → 2.7.0

package/dist/fetcher/HttpFetcher.js

@@ -1 +1 @@
-class n{constructor(t,r){this.client=t||window.fetch.bind(window),this.baseUrl=r}links(){return[]}get(t){const r=t.toURL(this.baseUrl);if(r===void 0)throw Error(`Invalid HREF: ${t.href}`);return new i(this.client,t,r)}close(){}}class i{constructor(t,r,s){this.client=t||window.fetch.bind(window),this._link=r,this.url=s}async headResponse(){if(this._headResponse)return this._headResponse;const t=await this.client(this.url,{method:"HEAD"});if(!t.ok)throw new Error(`http HEAD request for ${this.url} failed with HTTP status code ${t.status}`);return this._headResponse=t,t}close(){}async link(){return this._link}async read(t){if(t)throw new Error("http read range not implemented!");const r=await this.client(this.url);if(!r.ok)throw new Error(`http GET request for ${this.url} failed with HTTP status code ${r.status}`);return new Uint8Array(await r.arrayBuffer())}async length(){const r=(await this.headResponse()).headers.get("content-length");if(r===null||r==="")throw new Error("length for resource unavailable");return parseInt(r)}async readAsJSON(){const t=await this.client(this.url);if(!t.ok)throw new Error(`http GET request for ${this.url} failed with HTTP status code ${t.status}`);return await t.json()}async readAsString(){const t=await this.client(this.url);if(!t.ok)throw new Error(`http GET request for ${this.url} failed with HTTP status code ${t.status}`);return await t.text()}async readAsXML(){const t=await this.client(this.url);if(!t.ok)throw new Error(`http GET request for ${this.url} failed with HTTP status code ${t.status}`);return new DOMParser().parseFromString(await t.text(),"application/xml")}}export{n as HttpFetcher,i as HttpResource};
+class n{constructor(t,e){this.client=t||window.fetch.bind(window),this.baseUrl=e}links(){return[]}get(t){const e=t.toURL(this.baseUrl);if(e===void 0)throw Error(`Invalid HREF: ${t.href}`);return new i(this.client,t,e)}close(){}}class i{constructor(t,e,r){this.client=t||window.fetch.bind(window),this._link=e,this.url=r}async headResponse(){if(this._headResponse)return this._headResponse;const t=await this.client(this.url,{method:"HEAD"});if(!t.ok)throw new Error(`http HEAD request for ${this.url} failed with HTTP status code ${t.status}`);return this._headResponse=t,t}close(){}async link(){return this._link}async read(t,e){if(t)throw new Error("http read range not implemented!");const r=await this.client(this.url,e?.signal?{signal:e.signal}:void 0);if(!r.ok)throw new Error(`http GET request for ${this.url} failed with HTTP status code ${r.status}`);return new Uint8Array(await r.arrayBuffer())}async length(){const e=(await this.headResponse()).headers.get("content-length");if(e===null||e==="")throw new Error("length for resource unavailable");return parseInt(e)}async readAsJSON(){const t=await this.client(this.url);if(!t.ok)throw new Error(`http GET request for ${this.url} failed with HTTP status code ${t.status}`);return await t.json()}async readAsString(){const t=await this.client(this.url);if(!t.ok)throw new Error(`http GET request for ${this.url} failed with HTTP status code ${t.status}`);return await t.text()}async readAsXML(){const t=await this.client(this.url);if(!t.ok)throw new Error(`http GET request for ${this.url} failed with HTTP status code ${t.status}`);return new DOMParser().parseFromString(await t.text(),this._link.mediaType.isHTML?this._link.mediaType.essence:"text/xml")}}export{n as HttpFetcher,i as HttpResource};

package/dist/fetcher/Resource.js

@@ -1 +1 @@
-class n{constructor(r,t){this.start=r,this.endInclusive=t}}class i{readAsString(){return this.read().then(r=>r===void 0?r:new TextDecoder().decode(r))}readAsJSON(){return this.readAsString().then(r=>r===void 0?r:JSON.parse(r))}readAsXML(){return this.readAsString().then(r=>r===void 0?r:new DOMParser().parseFromString(r,"text/xml"))}}export{n as NumberRange,i as Resource};
+class t{constructor(e,r){this.start=e,this.endInclusive=r}}class i{readAsString(){return this.read().then(e=>e===void 0?e:new TextDecoder().decode(e))}readAsJSON(){return this.readAsString().then(e=>e===void 0?e:JSON.parse(e))}readAsXML(){return this.link().then(e=>this.readAsString().then(r=>r===void 0?r:new DOMParser().parseFromString(r,e.mediaType.isHTML?e.mediaType.essence:"text/xml")))}}export{t as NumberRange,i as Resource};

package/dist/index.js

@@ -1 +1 @@
-import{EmptyFetcher as o}from"./fetcher/Fetcher.js";import{HttpFetcher as i,HttpResource as a}from"./fetcher/HttpFetcher.js";import{NumberRange as n,Resource as p}from"./fetcher/Resource.js";import{AccessMode as x,Accessibility as l,AccessibilityProfile as s,Certification as g,Exemption as c,Feature as d,Hazard as u,PrimaryAccessMode as T}from"./publication/accessibility/Accessibility.js";import{AccessibilityMetadataDisplayGuide as y,AccessibilitySummary as C,AdditionalInformation as A,Conformance as P,HazardType as L,Hazards as N,Legal as S,Navigation as I,NonvisualReading as O,PrerecordedAudio as R,RichContent as v,RichContentType as E,VisualAdjustments as H,WaysOfReading as M}from"./publication/accessibility/AccessibilityMetadataDisplayGuide.js";import{Localization as k}from"./publication/accessibility/Localization.js";import{Encryption as F}from"./publication/encryption/Encryption.js";import{getEncryption as J}from"./publication/encryption/Properties.js";import{MediaOverlay as G}from"./publication/epub/MediaOverlay.js";import{getMediaOverlay as q}from"./publication/epub/Metadata.js";import{getContains as U}from"./publication/epub/Properties.js";import{getLandmarks as Q,getListOfAudioClips as W,getListOfIllustrations as w,getListOfTables as X,getListOfVideoClips as Y,getPageList as Z}from"./publication/epub/Publication.js";import{DomRange as $}from"./publication/html/DomRange.js";import{DomRangePoint as te}from"./publication/html/DomRangePoint.js";import{getCssSelector as re,getDomRange as ie,getFragmentParameters as ae,getHtmlId as me,getPage as ne,getPartialCfi as pe,getSpace as fe,getTextFragment as xe,getTime as le}from"./publication/html/Locations.js";import{getAuthenticate as ge,getAvailability as ce,getCopies as de,getHolds as ue,getIndirectAcquisitions as Te,getNumberOfItems as be,getPrice as ye}from"./publication/opds/Properties.js";import{getImages as Ae}from"./publication/opds/Publication.js";import{buildHtmlTimeline as Le}from"./publication/services/timeline/html.js";import{buildAudioTimeline as Se}from"./publication/services/timeline/audio.js";import{Timeline as Oe}from"./publication/services/timeline/Timeline.js";import{buildTimeline as ve}from"./publication/services/timeline/index.js";import{Content as He}from"./publication/services/content/Content.js";import{TextContentTokenizer as De}from"./publication/services/content/ContentTokenizer.js";import{IllegalStateError as ze,Iterator as Fe}from"./publication/services/content/Iterator.js";import{AudioElement as Je,ContentElement as je,ImageElement as Ge,TextElement as Ve,TextSegment as qe,TextualElement as Be,VideoElement as Ue}from"./publication/services/content/element/element.js";import{Attribute as Qe,AttributeKeys as We,AttributesHolder as we}from"./publication/services/content/element/attributes.js";import{Body as Ye,Footnote as Ze,Heading as _e,TextQuote as $e}from"./publication/services/content/element/text_role.js";import{PublicationContentIterator as tt}from"./publication/services/content/iterators/PublicationContentIterator.js";import{PDFContentElement as rt,PageContentIteratorPDF as it}from"./publication/services/content/iterators/PDFTextContentIterator.js";import{HTMLResourceContentIterator as mt}from"./publication/services/content/iterators/HTMLResourceContentIterator.js";import{AltIdentifier as pt}from"./publication/AltIdentifier.js";import{BelongsTo as xt}from"./publication/BelongsTo.js";import{Contributor as st,Contributors as gt}from"./publication/Contributor.js";import{Link as dt,Links as ut}from"./publication/Link.js";import{LocalizedString as bt}from"./publication/LocalizedString.js";import{Locator as Ct,LocatorLocations as At,LocatorText as Pt}from"./publication/Locator.js";import{LocatorCollection as Nt,LocatorCollectionMetadata as St}from"./publication/LocatorCollection.js";import{Manifest as Ot}from"./publication/Manifest.js";import{Metadata as vt}from"./publication/Metadata.js";import{Profile as Ht}from"./publication/Profiles.js";import{Page as Dt,Properties as kt}from"./publication/Properties.js";import{Publication as Ft}from"./publication/Publication.js";import{PublicationCollection as Jt}from"./publication/PublicationCollection.js";import{Layout as Gt}from"./publication/Layout.js";import{ReadingProgression as qt,leadingPage as Bt}from"./publication/ReadingProgression.js";import{Subject as Kt,Subjects as Qt}from"./publication/Subject.js";import{TDM as wt,TDMReservation as Xt}from"./publication/TDM.js";import{GuidedNavigationDocument as Zt,GuidedNavigationObject as _t,GuidedNavigationText as $t}from"./publication/GuidedNavigation.js";import{Price as to}from"./opds/Price.js";import{Acquisition as ro}from"./opds/Acquisition.js";import{Holds as ao}from"./opds/Holds.js";import{Copies as no}from"./opds/Copies.js";import{Availability as fo,AvailabilityStatus as xo}from"./opds/Availability.js";import{MediaType as so}from"./util/mediatype/MediaType.js";import{arrayfromJSON as co,arrayfromJSONorString as uo,datefromJSON as To,numberfromJSON as bo,positiveNumberfromJSON as yo,setToArray as Co}from"./util/JSONParse.js";import{formatNptTime as Po,isNptStartOfResource as Lo,parseNptTime as No}from"./util/npt.js";import{URITemplate as Io}from"./util/URITemplate.js";import{DefaultTextContentTokenizer as Ro,IntlTextTokenizer as vo,NaiveTextTokenizer as Eo,TextUnit as Ho,speakableToken as Mo}from"./util/tokenizer/TextTokenizer.js";export{x as AccessMode,l as Accessibility,y as AccessibilityMetadataDisplayGuide,s as AccessibilityProfile,C as AccessibilitySummary,ro as Acquisition,A as AdditionalInformation,pt as AltIdentifier,Qe as Attribute,We as AttributeKeys,we as AttributesHolder,Je as AudioElement,fo as Availability,xo as AvailabilityStatus,xt as BelongsTo,Ye as Body,g as Certification,P as Conformance,He as Content,je as ContentElement,st as Contributor,gt as Contributors,no as Copies,Ro as DefaultTextContentTokenizer,$ as DomRange,te as DomRangePoint,o as EmptyFetcher,F as Encryption,c as Exemption,d as Feature,Ze as Footnote,Zt as GuidedNavigationDocument,_t as GuidedNavigationObject,$t as GuidedNavigationText,mt as HTMLResourceContentIterator,u as Hazard,L as HazardType,N as Hazards,_e as Heading,ao as Holds,i as HttpFetcher,a as HttpResource,ze as IllegalStateError,Ge as ImageElement,vo as IntlTextTokenizer,Fe as Iterator,Gt as Layout,S as Legal,dt as Link,ut as Links,k as Localization,bt as LocalizedString,Ct as Locator,Nt as LocatorCollection,St as LocatorCollectionMetadata,At as LocatorLocations,Pt as LocatorText,Ot as Manifest,G as MediaOverlay,so as MediaType,vt as Metadata,Eo as NaiveTextTokenizer,I as Navigation,O as NonvisualReading,n as NumberRange,rt as PDFContentElement,Dt as Page,it as PageContentIteratorPDF,R as PrerecordedAudio,to as Price,T as PrimaryAccessMode,Ht as Profile,kt as Properties,Ft as Publication,Jt as PublicationCollection,tt as PublicationContentIterator,qt as ReadingProgression,p as Resource,v as RichContent,E as RichContentType,Kt as Subject,Qt as Subjects,wt as TDM,Xt as TDMReservation,De as TextContentTokenizer,Ve as TextElement,$e as TextQuote,qe as TextSegment,Ho as TextUnit,Be as TextualElement,Oe as Timeline,Io as URITemplate,Ue as VideoElement,H as VisualAdjustments,M as WaysOfReading,co as arrayfromJSON,uo as arrayfromJSONorString,Se as buildAudioTimeline,Le as buildHtmlTimeline,ve as buildTimeline,To as datefromJSON,Po as formatNptTime,ge as getAuthenticate,ce as getAvailability,U as getContains,de as getCopies,re as getCssSelector,ie as getDomRange,J as getEncryption,ae as getFragmentParameters,ue as getHolds,me as getHtmlId,Ae as getImages,Te as getIndirectAcquisitions,Q as getLandmarks,W as getListOfAudioClips,w as getListOfIllustrations,X as getListOfTables,Y as getListOfVideoClips,q as getMediaOverlay,be as getNumberOfItems,ne as getPage,Z as getPageList,pe as getPartialCfi,ye as getPrice,fe as getSpace,xe as getTextFragment,le as getTime,Lo as isNptStartOfResource,Bt as leadingPage,bo as numberfromJSON,No as parseNptTime,yo as positiveNumberfromJSON,Co as setToArray,Mo as speakableToken};
+import{EmptyFetcher as o}from"./fetcher/Fetcher.js";import{HttpFetcher as i,HttpResource as a}from"./fetcher/HttpFetcher.js";import{NumberRange as n,Resource as p}from"./fetcher/Resource.js";import{AccessMode as x,Accessibility as l,AccessibilityProfile as s,Certification as g,Exemption as c,Feature as d,Hazard as u,PrimaryAccessMode as T}from"./publication/accessibility/Accessibility.js";import{AccessibilityMetadataDisplayGuide as y,AccessibilitySummary as C,AdditionalInformation as A,Conformance as P,HazardType as L,Hazards as N,Legal as S,Navigation as I,NonvisualReading as O,PrerecordedAudio as R,RichContent as v,RichContentType as E,VisualAdjustments as H,WaysOfReading as M}from"./publication/accessibility/AccessibilityMetadataDisplayGuide.js";import{Localization as k}from"./publication/accessibility/Localization.js";import{Encryption as F}from"./publication/encryption/Encryption.js";import{getEncryption as G}from"./publication/encryption/Properties.js";import{MediaOverlay as j}from"./publication/epub/MediaOverlay.js";import{getMediaOverlay as q}from"./publication/epub/Metadata.js";import{getContains as U}from"./publication/epub/Properties.js";import{getLandmarks as Q,getListOfAudioClips as W,getListOfIllustrations as w,getListOfTables as X,getListOfVideoClips as Y,getPageList as Z}from"./publication/epub/Publication.js";import{DomRange as $}from"./publication/html/DomRange.js";import{DomRangePoint as te}from"./publication/html/DomRangePoint.js";import{getCssSelector as re,getDomRange as ie,getFragmentParameters as ae,getHtmlId as me,getPage as ne,getPartialCfi as pe,getSpace as fe,getTextFragment as xe,getTime as le}from"./publication/html/Locations.js";import{getAuthenticate as ge,getAvailability as ce,getCopies as de,getHolds as ue,getIndirectAcquisitions as Te,getNumberOfItems as be,getPrice as ye}from"./publication/opds/Properties.js";import{getImages as Ae}from"./publication/opds/Publication.js";import{buildHtmlTimeline as Le}from"./publication/services/timeline/html.js";import{buildAudioTimeline as Se}from"./publication/services/timeline/audio.js";import{Timeline as Oe}from"./publication/services/timeline/Timeline.js";import{buildTimeline as ve}from"./publication/services/timeline/index.js";import{Content as He}from"./publication/services/content/Content.js";import{TextContentTokenizer as De}from"./publication/services/content/ContentTokenizer.js";import{IllegalStateError as ze,Iterator as Fe}from"./publication/services/content/Iterator.js";import{AudioElement as Ge,ContentElement as Je,ImageElement as je,TextElement as Ve,TextSegment as qe,TextualElement as Be,VideoElement as Ue}from"./publication/services/content/element/element.js";import{Attribute as Qe,AttributeKeys as We,AttributesHolder as we}from"./publication/services/content/element/attributes.js";import{Body as Ye,Footnote as Ze,Heading as _e,TextQuote as $e}from"./publication/services/content/element/text_role.js";import{PublicationContentIterator as tt}from"./publication/services/content/iterators/PublicationContentIterator.js";import{PDFContentElement as rt,PageContentIteratorPDF as it}from"./publication/services/content/iterators/PDFTextContentIterator.js";import{HTMLResourceContentIterator as mt}from"./publication/services/content/iterators/HTMLResourceContentIterator.js";import{AltIdentifier as pt}from"./publication/AltIdentifier.js";import{BelongsTo as xt}from"./publication/BelongsTo.js";import{Contributor as st,Contributors as gt}from"./publication/Contributor.js";import{Link as dt,Links as ut}from"./publication/Link.js";import{LocalizedString as bt}from"./publication/LocalizedString.js";import{Locator as Ct,LocatorLocations as At,LocatorText as Pt}from"./publication/Locator.js";import{LocatorCollection as Nt,LocatorCollectionMetadata as St}from"./publication/LocatorCollection.js";import{Manifest as Ot}from"./publication/Manifest.js";import{Metadata as vt}from"./publication/Metadata.js";import{Profile as Ht}from"./publication/Profiles.js";import{Page as Dt,Properties as kt}from"./publication/Properties.js";import{Publication as Ft}from"./publication/Publication.js";import{PublicationCollection as Gt}from"./publication/PublicationCollection.js";import{Layout as jt}from"./publication/Layout.js";import{ReadingProgression as qt,leadingPage as Bt}from"./publication/ReadingProgression.js";import{Subject as Kt,Subjects as Qt}from"./publication/Subject.js";import{TDM as wt,TDMReservation as Xt}from"./publication/TDM.js";import{GuidedNavigationDescription as Zt,GuidedNavigationDocument as _t,GuidedNavigationObject as $t,GuidedNavigationText as eo}from"./publication/GuidedNavigation.js";import{Price as oo}from"./opds/Price.js";import{Acquisition as io}from"./opds/Acquisition.js";import{Holds as mo}from"./opds/Holds.js";import{Copies as po}from"./opds/Copies.js";import{Availability as xo,AvailabilityStatus as lo}from"./opds/Availability.js";import{MediaType as go}from"./util/mediatype/MediaType.js";import{arrayfromJSON as uo,arrayfromJSONorString as To,datefromJSON as bo,numberfromJSON as yo,positiveNumberfromJSON as Co,setToArray as Ao}from"./util/JSONParse.js";import{formatNptTime as Lo,isNptStartOfResource as No,parseNptTime as So}from"./util/npt.js";import{URITemplate as Oo}from"./util/URITemplate.js";import{DefaultTextContentTokenizer as vo,IntlTextTokenizer as Eo,NaiveTextTokenizer as Ho,TextUnit as Mo,speakableToken as Do}from"./util/tokenizer/TextTokenizer.js";export{x as AccessMode,l as Accessibility,y as AccessibilityMetadataDisplayGuide,s as AccessibilityProfile,C as AccessibilitySummary,io as Acquisition,A as AdditionalInformation,pt as AltIdentifier,Qe as Attribute,We as AttributeKeys,we as AttributesHolder,Ge as AudioElement,xo as Availability,lo as AvailabilityStatus,xt as BelongsTo,Ye as Body,g as Certification,P as Conformance,He as Content,Je as ContentElement,st as Contributor,gt as Contributors,po as Copies,vo as DefaultTextContentTokenizer,$ as DomRange,te as DomRangePoint,o as EmptyFetcher,F as Encryption,c as Exemption,d as Feature,Ze as Footnote,Zt as GuidedNavigationDescription,_t as GuidedNavigationDocument,$t as GuidedNavigationObject,eo as GuidedNavigationText,mt as HTMLResourceContentIterator,u as Hazard,L as HazardType,N as Hazards,_e as Heading,mo as Holds,i as HttpFetcher,a as HttpResource,ze as IllegalStateError,je as ImageElement,Eo as IntlTextTokenizer,Fe as Iterator,jt as Layout,S as Legal,dt as Link,ut as Links,k as Localization,bt as LocalizedString,Ct as Locator,Nt as LocatorCollection,St as LocatorCollectionMetadata,At as LocatorLocations,Pt as LocatorText,Ot as Manifest,j as MediaOverlay,go as MediaType,vt as Metadata,Ho as NaiveTextTokenizer,I as Navigation,O as NonvisualReading,n as NumberRange,rt as PDFContentElement,Dt as Page,it as PageContentIteratorPDF,R as PrerecordedAudio,oo as Price,T as PrimaryAccessMode,Ht as Profile,kt as Properties,Ft as Publication,Gt as PublicationCollection,tt as PublicationContentIterator,qt as ReadingProgression,p as Resource,v as RichContent,E as RichContentType,Kt as Subject,Qt as Subjects,wt as TDM,Xt as TDMReservation,De as TextContentTokenizer,Ve as TextElement,$e as TextQuote,qe as TextSegment,Mo as TextUnit,Be as TextualElement,Oe as Timeline,Oo as URITemplate,Ue as VideoElement,H as VisualAdjustments,M as WaysOfReading,uo as arrayfromJSON,To as arrayfromJSONorString,Se as buildAudioTimeline,Le as buildHtmlTimeline,ve as buildTimeline,bo as datefromJSON,Lo as formatNptTime,ge as getAuthenticate,ce as getAvailability,U as getContains,de as getCopies,re as getCssSelector,ie as getDomRange,G as getEncryption,ae as getFragmentParameters,ue as getHolds,me as getHtmlId,Ae as getImages,Te as getIndirectAcquisitions,Q as getLandmarks,W as getListOfAudioClips,w as getListOfIllustrations,X as getListOfTables,Y as getListOfVideoClips,q as getMediaOverlay,be as getNumberOfItems,ne as getPage,Z as getPageList,pe as getPartialCfi,ye as getPrice,fe as getSpace,xe as getTextFragment,le as getTime,No as isNptStartOfResource,Bt as leadingPage,yo as numberfromJSON,So as parseNptTime,Co as positiveNumberfromJSON,Ao as setToArray,Do as speakableToken};

package/dist/publication/GuidedNavigation.js

@@ -1 +1 @@
-import{arrayfromJSONorString as a,setToArray as n}from"../util/JSONParse.js";import{Links as o}from"./Link.js";class d{constructor(i){this.links=i.links,this.guided=i.guided}static deserialize(i){if(i)return new d({links:o.deserialize(i.links),guided:r.deserializeArray(i.guided)})}serialize(){const i={};return this.links!==void 0&&(i.links=this.links.serialize()),this.guided!==void 0&&(i.guided=this.guided.map(e=>e.serialize())),i}}class s{constructor(i){this.plain=i.plain,this.ssml=i.ssml,this.language=i.language}static deserialize(i){if(i!=null){if(typeof i=="string")return new s({plain:i});if(i.plain||i.ssml||i.language)return new s({plain:i.plain,ssml:i.ssml,language:i.language})}}serialize(){const i={};return this.plain!==void 0&&(i.plain=this.plain),this.ssml!==void 0&&(i.ssml=this.ssml),this.language!==void 0&&(i.language=this.language),Object.keys(i).length>0?i:void 0}}class r{constructor(i){this.audioref=i.audioref,this.children=i.children,this.imgref=i.imgref,this.role=i.role,this.level=i.level!==void 0?Math.min(6,Math.max(1,i.level)):void 0,this.text=i.text,this.textref=i.textref,this.description=i.description}get plainText(){return this.text?.plain}get ssmlText(){return this.text?.ssml}get textLanguage(){return this.text?.language}static deserialize(i){if(i)return new r({audioref:i.audioref,children:r.deserializeArray(i.children),imgref:i.imgref,role:i.role?new Set(a(i.role)):void 0,level:typeof i.level=="number"?i.level:void 0,text:s.deserialize(i.text),textref:i.textref,description:r.deserialize(i.description)})}static deserializeArray(i){if(Array.isArray(i))return i.map(e=>r.deserialize(e)).filter(e=>e!==void 0)}serialize(){const i={};if(this.audioref!==void 0&&(i.audioref=this.audioref),this.children!==void 0&&(i.children=this.children.map(e=>e.serialize())),this.imgref!==void 0&&(i.imgref=this.imgref),this.role!==void 0&&(i.role=n(this.role)),this.level!==void 0&&(i.level=this.level),this.text!==void 0){const e=this.text.serialize();e!==void 0&&(i.text=e)}return this.textref!==void 0&&(i.textref=this.textref),this.description&&(i.description=this.description.serialize()),i}get audioFile(){return this.audioref?.split("#")[0]}get audioTime(){if(this.audioref?.includes("#"))return this.audioref.split("#",2)[1]}get textFile(){return this.textref?.split("#")[0]}get fragmentId(){if(this.textref?.includes("#"))return this.textref.split("#",2)[1]}get clip(){const i=this.audioFile;if(!i)return;const e=this.audioTime,t={audioResource:i,fragmentId:this.fragmentId};if(!e)return t;const l=this.parseTimer(e);return t.start=l[0],t.end=l[1],t}parseTimer(i){if(!i||!i.startsWith("t="))return[void 0,void 0];const e=i.substring(2).split(",").map(t=>parseFloat(t));return e.length===1?[isNaN(e[0])?void 0:e[0],void 0]:e.length>2?[void 0,void 0]:[isNaN(e[0])?void 0:e[0],isNaN(e[1])?void 0:e[1]]}}export{d as GuidedNavigationDocument,r as GuidedNavigationObject,s as GuidedNavigationText};
+import{arrayfromJSONorString as a,setToArray as n}from"../util/JSONParse.js";class f{constructor(i){this.guided=i.guided}static deserialize(i){if(!i)return;const e=r.deserializeArray(i.guided);if(!(!e||e.length===0))return new f({guided:e})}serialize(){return{guided:this.guided.map(i=>i.serialize())}}}class d{constructor(i){this.plain=i.plain,this.ssml=i.ssml,this.language=i.language}static deserialize(i){if(i!=null){if(typeof i=="string")return i.length>0?new d({plain:i}):void 0;if(i.plain||i.ssml)return new d({plain:i.plain,ssml:i.ssml,language:i.language})}}serialize(){const i={};return this.plain!==void 0&&(i.plain=this.plain),this.ssml!==void 0&&(i.ssml=this.ssml),this.language!==void 0&&(i.language=this.language),Object.keys(i).length>0?i:void 0}}class s{constructor(i){this.audioref=i.audioref,this.imgref=i.imgref,this.textref=i.textref,this.videoref=i.videoref,this.text=i.text}static deserialize(i){if(!i)return;const e=new s({audioref:i.audioref,imgref:i.imgref,textref:i.textref,videoref:i.videoref,text:d.deserialize(i.text)});if(!(e.audioref===void 0&&e.imgref===void 0&&e.textref===void 0&&e.videoref===void 0&&e.text===void 0))return e}serialize(){const i={};this.audioref!==void 0&&(i.audioref=this.audioref),this.imgref!==void 0&&(i.imgref=this.imgref),this.textref!==void 0&&(i.textref=this.textref),this.videoref!==void 0&&(i.videoref=this.videoref);const e=this.text?.serialize();return e!==void 0&&(i.text=e),i}}class r{constructor(i){this.id=i.id,this.audioref=i.audioref,this.children=i.children,this.imgref=i.imgref,this.role=i.role,this.text=i.text,this.textref=i.textref,this.videoref=i.videoref,this.description=i.description}get plainText(){return this.text?.plain}get ssmlText(){return this.text?.ssml}get textLanguage(){return this.text?.language}static deserialize(i){if(!i)return;const e=r.deserializeArray(i.children),t=new r({id:typeof i.id=="string"?i.id:void 0,audioref:i.audioref,children:e&&e.length>0?e:void 0,imgref:i.imgref,role:i.role?new Set(a(i.role)):void 0,text:d.deserialize(i.text),textref:i.textref,videoref:i.videoref,description:s.deserialize(i.description)});if(!(t.audioref===void 0&&t.imgref===void 0&&t.textref===void 0&&t.videoref===void 0&&t.text===void 0&&t.children===void 0))return t}static deserializeArray(i){if(Array.isArray(i))return i.map(e=>r.deserialize(e)).filter(e=>e!==void 0)}serialize(){const i={};if(this.id!==void 0&&(i.id=this.id),this.audioref!==void 0&&(i.audioref=this.audioref),this.children!==void 0&&(i.children=this.children.map(e=>e.serialize())),this.imgref!==void 0&&(i.imgref=this.imgref),this.role!==void 0&&(i.role=n(this.role)),this.text!==void 0){const e=this.text.serialize();e!==void 0&&(i.text=e)}return this.textref!==void 0&&(i.textref=this.textref),this.videoref!==void 0&&(i.videoref=this.videoref),this.description!==void 0&&(i.description=this.description.serialize()),i}get audioFile(){return this.audioref?.split("#")[0]}get audioTime(){if(this.audioref?.includes("#"))return this.audioref.split("#",2)[1]}get textFile(){return this.textref?.split("#")[0]}get fragmentId(){if(this.textref?.includes("#"))return this.textref.split("#",2)[1]}get clip(){const i=this.audioFile;if(!i)return;const e=this.audioTime,t={audioResource:i,fragmentId:this.fragmentId};if(!e)return t;const o=this.parseTimer(e);return t.start=o[0],t.end=o[1],t}parseTimer(i){if(!i||!i.startsWith("t="))return[void 0,void 0];const e=i.substring(2).split(",").map(t=>parseFloat(t));return e.length===1?[isNaN(e[0])?void 0:e[0],void 0]:e.length>2?[void 0,void 0]:[isNaN(e[0])?void 0:e[0],isNaN(e[1])?void 0:e[1]]}}export{s as GuidedNavigationDescription,f as GuidedNavigationDocument,r as GuidedNavigationObject,d as GuidedNavigationText};

package/dist/publication/Manifest.js

@@ -1 +1 @@
-import{Metadata as k}from"./Metadata.js";import{Links as l,Link as m}from"./Link.js";import{arrayfromJSONorString as g}from"../util/JSONParse.js";import{PublicationCollection as u}from"./PublicationCollection.js";import{MediaType as z}from"../util/mediatype/MediaType.js";import{Locator as O,LocatorLocations as w}from"./Locator.js";class p{constructor(e){this.context=e.context,this.metadata=e.metadata,this.links=e.links,this.readingOrder=e.readingOrder,this.resources=e.resources,this.toc=e.toc,this.subcollections=e.subcollections}static deserialize(e){if(!e)return;const i=k.deserialize(e.metadata);if(!i)return;const t=l.deserialize(e.links),r=l.deserialize(e.readingOrder?e.readingOrder:e.spine);if(!r)return;const s=new Set(["@context","metadata","links","readingOrder","spine","resources","toc"]),c={};return Object.keys(e).forEach(n=>{s.has(n)||(c[n]=e[n])}),new p({context:g(e["@context"]),metadata:i,links:t,readingOrder:r,resources:l.deserialize(e.resources),toc:l.deserialize(e.toc),subcollections:u.deserializeCollections(c)})}serialize(){const e={};return this.context!==void 0&&(e["@context"]=this.context),e.metadata=this.metadata.serialize(),this.links!==void 0&&(e.links=this.links.serialize()),e.readingOrder=this.readingOrder.serialize(),this.resources&&(e.resources=this.resources.serialize()),this.toc&&(e.toc=this.toc.serialize()),u.serializeCollection(e,this.subcollections),e}linkWithRel(e){const i=new Array;i.push(this.readingOrder),this.resources&&i.push(this.resources),this.links&&i.push(this.links);let t;for(const r of i)if(t=r.findWithRel(e),t!==void 0)return t;return t}linksWithRel(e){const i=[];return i.push(this.readingOrder.filterByRel(e)),this.resources&&i.push(this.resources.filterByRel(e)),this.links&&i.push(this.links.filterByRel(e)),i.reduce((t,r)=>t.concat(r),[])}locatorFromLink(e){const i=e.href.split("#")[0],t=this.linkWithHref(i);if(!t)return;const r=t.type;if(!r)return;const s=e.href.includes("#");return new O({href:e.href,type:r,title:t.title??e.title,locations:new w({progression:s?void 0:0})})}linkWithHref(e){const i=n=>{let o;for(const f of n)if(o=f.findWithHref(e),o!==void 0)return o;const h=new Array;return n.forEach(f=>{const d=[];for(const a of f.items)a.alternates&&d.push(a.alternates),a.children&&d.push(a.children);h.push(...d)}),h.length>0&&(o=i(h)),o},t=[];t.push(this.readingOrder),this.resources&&t.push(this.resources),this.links&&t.push(this.links);const r=i(t);if(r!==void 0)return r;const s=e.split(/[#]/);if(s.length<2)return;const c=s[0];return this.linkWithHref(c)}get baseURL(){const e=this.links?.items.find(i=>i.rels&&i.rels.has("self"));if(e){let i=e.href;if(i){const t=i.lastIndexOf("/"),r=t===-1?void 0:i.substring(t+1);i=i.replace(new RegExp("/?$query$"),""),i=i.replace(new RegExp("//$"),""),r&&(i=i.replace(new RegExp(r+"$"),""))}return i}}setSelfLink(e){this.links||(this.links=new l([])),this.links.items=this.links.items.filter(i=>i.rels===void 0||!i.rels?.has("self")),this.links.items.push(new m({href:e,type:z.READIUM_WEBPUB_MANIFEST.string,rels:new Set(["self"])}))}}export{p as Manifest};
+import{Metadata as k}from"./Metadata.js";import{Links as n,Link as m}from"./Link.js";import{arrayfromJSONorString as g}from"../util/JSONParse.js";import{PublicationCollection as u}from"./PublicationCollection.js";import{MediaType as z}from"../util/mediatype/MediaType.js";import{Locator as O,LocatorLocations as w}from"./Locator.js";class p{constructor(e){this.context=e.context,this.metadata=e.metadata,this.links=e.links||new n([]),this.readingOrder=e.readingOrder,this.resources=e.resources,this.toc=e.toc,this.subcollections=e.subcollections}static deserialize(e){if(!e)return;const i=k.deserialize(e.metadata);if(!i)return;const t=n.deserialize(e.readingOrder?e.readingOrder:e.spine);if(!t)return;const r=new Set(["@context","metadata","links","readingOrder","spine","resources","toc"]),s={};return Object.keys(e).forEach(o=>{r.has(o)||(s[o]=e[o])}),new p({context:g(e["@context"]),metadata:i,links:n.deserialize(e.links),readingOrder:t,resources:n.deserialize(e.resources),toc:n.deserialize(e.toc),subcollections:u.deserializeCollections(s)})}serialize(){const e={};return this.context!==void 0&&(e["@context"]=this.context),e.metadata=this.metadata.serialize(),this.links&&this.links.items.length>0&&(e.links=this.links.serialize()),e.readingOrder=this.readingOrder.serialize(),this.resources&&(e.resources=this.resources.serialize()),this.toc&&(e.toc=this.toc.serialize()),u.serializeCollection(e,this.subcollections),e}linkWithRel(e){const i=new Array;i.push(this.readingOrder),this.resources&&i.push(this.resources),this.links&&i.push(this.links);let t;for(const r of i)if(t=r.findWithRel(e),t!==void 0)return t;return t}linksWithRel(e){const i=[];return i.push(this.readingOrder.filterByRel(e)),this.resources&&i.push(this.resources.filterByRel(e)),this.links&&i.push(this.links.filterByRel(e)),i.reduce((t,r)=>t.concat(r),[])}locatorFromLink(e){const i=e.href.split("#")[0],t=this.linkWithHref(i);if(!t)return;const r=t.type;if(!r)return;const s=e.href.includes("#");return new O({href:e.href,type:r,title:t.title??e.title,locations:new w({progression:s?void 0:0})})}linkWithHref(e){const i=d=>{let l;for(const a of d)if(l=a.findWithHref(e),l!==void 0)return l;const h=new Array;return d.forEach(a=>{const f=[];for(const c of a.items)c.alternates&&f.push(c.alternates),c.children&&f.push(c.children);h.push(...f)}),h.length>0&&(l=i(h)),l},t=[];t.push(this.readingOrder),this.resources&&t.push(this.resources),this.links&&t.push(this.links);const r=i(t);if(r!==void 0)return r;const s=e.split(/[#]/);if(s.length<2)return;const o=s[0];return this.linkWithHref(o)}get baseURL(){const e=this.links?.items.find(t=>t.rels&&t.rels.has("self"));if(!e)return;const i=e.href;if(i)try{const t=new URL(i);return t.search="",t.hash="",t.pathname=t.pathname.substring(0,t.pathname.lastIndexOf("/")+1),t.href}catch{return i.split(/[?#]/)[0].replace(/[^/]*$/,"")}}setSelfLink(e){this.links||(this.links=new n([])),this.links.items=this.links.items.filter(i=>i.rels===void 0||!i.rels?.has("self")),this.links.items.push(new m({href:e,type:z.READIUM_WEBPUB_MANIFEST.string,rels:new Set(["self"])}))}}export{p as Manifest};

package/dist/publication/html/Locations.js

@@ -1 +1 @@
-import{DomRange as u}from"./DomRange.js";import{parseNptTime as h}from"../../util/npt.js";import{decodeTextFragmentDirective as d}from"@readium/helpers";function C(e){return e.otherLocations?.get("cssSelector")}function L(e){return e.otherLocations?.get("partialCfi")}function N(e){return u.deserialize(e.otherLocations?.get("domRange"))}function W(e){for(const t of e.fragments){const r=d(t);if(r)return r}}function n(e){return new Map(e.fragments.map(t=>t.startsWith("#")?t.slice(1):t).join("&").split("&").filter(t=>!t.startsWith("#")).map(t=>t.split("=")).filter(t=>t.length===2).map(t=>[t[0].trim().toLowerCase(),t[1].trim()]))}function F(e){if(!e.fragments.length)return;let t=e.fragments.find(r=>r.length&&!r.includes("="));if(!t){const r=n(e);r.has("id")?t=r.get("id"):r.has("name")&&(t=r.get("name"))}return t?.startsWith("#")?t.slice(1):t}function R(e){const t=parseInt(n(e).get("page"));if(!isNaN(t)&&t>=0)return t}function T(e){const t=n(e).get("t");if(t)return h(t)}function y(e){const t=n(e);if(!t.has("xywh"))return;const r=t.get("xywh");let i="pixel",s=r;const a=r.toLowerCase();a.startsWith("pixel:")?s=r.slice(6):a.startsWith("percent:")&&(i="percent",s=r.slice(8));const c=i==="percent"?parseFloat:l=>parseInt(l,10),o=s.split(",").map(c);if(o.length!==4||o.some(isNaN))return;const[g,f,m,p]=o;return{unit:i,x:g,y:f,width:m,height:p}}export{C as getCssSelector,N as getDomRange,n as getFragmentParameters,F as getHtmlId,R as getPage,L as getPartialCfi,y as getSpace,W as getTextFragment,T as getTime};
+import{DomRange as u}from"./DomRange.js";import{parseNptTime as h}from"../../util/npt.js";import{decodeTextFragmentDirective as d}from"@readium/helpers";function L(e){return e.otherLocations?.get("cssSelector")}function N(e){return e.otherLocations?.get("partialCfi")}function W(e){return u.deserialize(e.otherLocations?.get("domRange"))}function F(e){return e.fragments?.map(t=>d(t)).find(t=>t)}function n(e){return new Map(e.fragments?.map(t=>t.startsWith("#")?t.slice(1):t).join("&").split("&").filter(t=>!t.startsWith("#")).map(t=>t.split("=")).filter(t=>t.length===2).map(t=>[t[0].trim().toLowerCase(),t[1].trim()]))}function R(e){if(!e.fragments?.length)return;let t=e.fragments.find(r=>r.length&&!r.includes("="));if(!t){const r=n(e);r.has("id")?t=r.get("id"):r.has("name")&&(t=r.get("name"))}return t?.startsWith("#")?t.slice(1):t}function T(e){const t=parseInt(n(e).get("page"));if(!isNaN(t)&&t>=0)return t}function v(e){const t=n(e).get("t");if(t)return h(t)}function y(e){const t=n(e);if(!t.has("xywh"))return;const r=t.get("xywh");let i="pixel",s=r;const o=r.toLowerCase();o.startsWith("pixel:")?s=r.slice(6):o.startsWith("percent:")&&(i="percent",s=r.slice(8));const c=i==="percent"?parseFloat:l=>parseInt(l,10),a=s.split(",").map(c);if(a.length!==4||a.some(isNaN))return;const[g,f,m,p]=a;return{unit:i,x:g,y:f,width:m,height:p}}export{L as getCssSelector,W as getDomRange,n as getFragmentParameters,R as getHtmlId,T as getPage,N as getPartialCfi,y as getSpace,F as getTextFragment,v as getTime};

package/dist/util/mediatype/MediaType.js

@@ -1 +1 @@
-class t{constructor(e){let i,o,p=e.mediaType.replace(/\s/g,"").split(";");const s=p[0].split("/");if(s.length===2){if(i=s[0].toLowerCase().trim(),o=s[1].toLowerCase().trim(),i.length===0||o.length===0)throw new Error("Invalid media type")}else throw new Error("Invalid media type");const r={};for(let n=1;n<p.length;n++){const a=p[n].split("=");if(a.length===2){const u=a[0].toLocaleLowerCase(),f=u==="charset"?a[1].toUpperCase():a[1];r[u]=f}}const c={},m=Object.keys(r);m.sort((n,a)=>n.localeCompare(a)),m.forEach(n=>c[n]=r[n]);let l="";for(const n in c){const a=c[n];l+=`;${n}=${a}`}const g=`${i}/${o}${l}`,E=c.encoding;this.string=g,this.type=i,this.subtype=o,this.parameters=c,this.encoding=E,this.name=e.name,this.fileExtension=e.fileExtension}static parse(e){return new t(e)}get structuredSyntaxSuffix(){const e=this.subtype.split("+");return e.length>1?`+${e[e.length-1]}`:void 0}get charset(){return this.parameters.charset}contains(e){const i=typeof e=="string"?t.parse({mediaType:e}):e;if(!((this.type==="*"||this.type===i.type)&&(this.subtype==="*"||this.subtype===i.subtype)))return!1;const o=new Set(Object.entries(this.parameters).map(([s,r])=>`${s}=${r}`)),p=new Set(Object.entries(i.parameters).map(([s,r])=>`${s}=${r}`));for(const s of Array.from(o.values()))if(!p.has(s))return!1;return!0}matches(e){const i=typeof e=="string"?t.parse({mediaType:e}):e;return this.contains(i)||i.contains(this)}matchesAny(...e){for(const i of e)if(this.matches(i))return!0;return!1}equals(e){return this.string===e.string}get isZIP(){return this.matchesAny(t.ZIP,t.LCP_PROTECTED_AUDIOBOOK,t.LCP_PROTECTED_PDF)||this.structuredSyntaxSuffix==="+zip"}get isJSON(){return this.matchesAny(t.JSON)||this.structuredSyntaxSuffix==="+json"}get isOPDS(){return this.matchesAny(t.OPDS1,t.OPDS1_ENTRY,t.OPDS2,t.OPDS2_PUBLICATION,t.OPDS_AUTHENTICATION)||this.structuredSyntaxSuffix==="+json"}get isHTML(){return this.matchesAny(t.HTML,t.XHTML)}get isBitmap(){return this.matchesAny(t.AVIF,t.BMP,t.GIF,t.JPEG,t.PNG,t.TIFF,t.WEBP)}get isAudio(){return this.type==="audio"}get isVideo(){return this.type==="video"}get isRWPM(){return this.matchesAny(t.READIUM_AUDIOBOOK_MANIFEST,t.DIVINA_MANIFEST,t.READIUM_WEBPUB_MANIFEST)}get isPublication(){return this.matchesAny(t.READIUM_AUDIOBOOK,t.READIUM_AUDIOBOOK_MANIFEST,t.CBZ,t.DIVINA,t.DIVINA_MANIFEST,t.EPUB,t.LCP_PROTECTED_AUDIOBOOK,t.LCP_PROTECTED_PDF,t.LPF,t.PDF,t.W3C_WPUB_MANIFEST,t.READIUM_WEBPUB,t.READIUM_WEBPUB_MANIFEST,t.ZAB)}static get AAC(){return t.parse({mediaType:"audio/aac",fileExtension:"aac"})}static get ACSM(){return t.parse({mediaType:"application/vnd.adobe.adept+xml",name:"Adobe Content Server Message",fileExtension:"acsm"})}static get AIFF(){return t.parse({mediaType:"audio/aiff",fileExtension:"aiff"})}static get AVI(){return t.parse({mediaType:"video/x-msvideo",fileExtension:"avi"})}static get AVIF(){return t.parse({mediaType:"image/avif",fileExtension:"avif"})}static get BINARY(){return t.parse({mediaType:"application/octet-stream"})}static get BMP(){return t.parse({mediaType:"image/bmp",fileExtension:"bmp"})}static get CBZ(){return t.parse({mediaType:"application/vnd.comicbook+zip",name:"Comic Book Archive",fileExtension:"cbz"})}static get CSS(){return t.parse({mediaType:"text/css",fileExtension:"css"})}static get DIVINA(){return t.parse({mediaType:"application/divina+zip",name:"Digital Visual Narratives",fileExtension:"divina"})}static get DIVINA_MANIFEST(){return t.parse({mediaType:"application/divina+json",name:"Digital Visual Narratives",fileExtension:"json"})}static get EPUB(){return t.parse({mediaType:"application/epub+zip",name:"EPUB",fileExtension:"epub"})}static get GIF(){return t.parse({mediaType:"image/gif",fileExtension:"gif"})}static get GZ(){return t.parse({mediaType:"application/gzip",fileExtension:"gz"})}static get HTML(){return t.parse({mediaType:"text/html",fileExtension:"html"})}static get JAVASCRIPT(){return t.parse({mediaType:"text/javascript",fileExtension:"js"})}static get JPEG(){return t.parse({mediaType:"image/jpeg",fileExtension:"jpeg"})}static get JSON(){return t.parse({mediaType:"application/json"})}static get LCP_LICENSE_DOCUMENT(){return t.parse({mediaType:"application/vnd.readium.lcp.license.v1.0+json",name:"LCP License",fileExtension:"lcpl"})}static get LCP_PROTECTED_AUDIOBOOK(){return t.parse({mediaType:"application/audiobook+lcp",name:"LCP Protected Audiobook",fileExtension:"lcpa"})}static get LCP_PROTECTED_PDF(){return t.parse({mediaType:"application/pdf+lcp",name:"LCP Protected PDF",fileExtension:"lcpdf"})}static get LCP_STATUS_DOCUMENT(){return t.parse({mediaType:"application/vnd.readium.license.status.v1.0+json"})}static get LPF(){return t.parse({mediaType:"application/lpf+zip",fileExtension:"lpf"})}static get MP3(){return t.parse({mediaType:"audio/mpeg",fileExtension:"mp3"})}static get MPEG(){return t.parse({mediaType:"video/mpeg",fileExtension:"mpeg"})}static get NCX(){return t.parse({mediaType:"application/x-dtbncx+xml",fileExtension:"ncx"})}static get OGG(){return t.parse({mediaType:"audio/ogg",fileExtension:"oga"})}static get OGV(){return t.parse({mediaType:"video/ogg",fileExtension:"ogv"})}static get OPDS1(){return t.parse({mediaType:"application/atom+xml;profile=opds-catalog"})}static get OPDS1_ENTRY(){return t.parse({mediaType:"application/atom+xml;type=entry;profile=opds-catalog"})}static get OPDS2(){return t.parse({mediaType:"application/opds+json"})}static get OPDS2_PUBLICATION(){return t.parse({mediaType:"application/opds-publication+json"})}static get OPDS_AUTHENTICATION(){return t.parse({mediaType:"application/opds-authentication+json"})}static get OPUS(){return t.parse({mediaType:"audio/opus",fileExtension:"opus"})}static get OTF(){return t.parse({mediaType:"font/otf",fileExtension:"otf"})}static get PDF(){return t.parse({mediaType:"application/pdf",name:"PDF",fileExtension:"pdf"})}static get PNG(){return t.parse({mediaType:"image/png",fileExtension:"png"})}static get READIUM_AUDIOBOOK(){return t.parse({mediaType:"application/audiobook+zip",name:"Readium Audiobook",fileExtension:"audiobook"})}static get READIUM_AUDIOBOOK_MANIFEST(){return t.parse({mediaType:"application/audiobook+json",name:"Readium Audiobook",fileExtension:"json"})}static get READIUM_CONTENT_DOCUMENT(){return t.parse({mediaType:"application/vnd.readium.content+json",name:"Readium Content Document",fileExtension:"json"})}static get READIUM_GUIDED_NAVIGATION_DOCUMENT(){return t.parse({mediaType:"application/guided-navigation+json",name:"Readium Guided Navigation Document",fileExtension:"json"})}static get READIUM_POSITION_LIST(){return t.parse({mediaType:"application/vnd.readium.position-list+json",name:"Readium Position List",fileExtension:"json"})}static get READIUM_WEBPUB(){return t.parse({mediaType:"application/webpub+zip",name:"Readium Web Publication",fileExtension:"webpub"})}static get READIUM_WEBPUB_MANIFEST(){return t.parse({mediaType:"application/webpub+json",name:"Readium Web Publication",fileExtension:"json"})}static get SMIL(){return t.parse({mediaType:"application/smil+xml",fileExtension:"smil"})}static get SVG(){return t.parse({mediaType:"image/svg+xml",fileExtension:"svg"})}static get TEXT(){return t.parse({mediaType:"text/plain",fileExtension:"txt"})}static get TIFF(){return t.parse({mediaType:"image/tiff",fileExtension:"tiff"})}static get TTF(){return t.parse({mediaType:"font/ttf",fileExtension:"ttf"})}static get W3C_WPUB_MANIFEST(){return t.parse({mediaType:"application/x.readium.w3c.wpub+json",name:"Web Publication",fileExtension:"json"})}static get WAV(){return t.parse({mediaType:"audio/wav",fileExtension:"wav"})}static get WEBM_AUDIO(){return t.parse({mediaType:"audio/webm",fileExtension:"webm"})}static get WEBM_VIDEO(){return t.parse({mediaType:"video/webm",fileExtension:"webm"})}static get WEBP(){return t.parse({mediaType:"image/webp",fileExtension:"webp"})}static get WOFF(){return t.parse({mediaType:"font/woff",fileExtension:"woff"})}static get WOFF2(){return t.parse({mediaType:"font/woff2",fileExtension:"woff2"})}static get XHTML(){return t.parse({mediaType:"application/xhtml+xml",fileExtension:"xhtml"})}static get XML(){return t.parse({mediaType:"application/xml",fileExtension:"xml"})}static get ZAB(){return t.parse({mediaType:"application/x.readium.zab+zip",name:"Zipped Audio Book",fileExtension:"zab"})}static get ZIP(){return t.parse({mediaType:"application/zip",fileExtension:"zip"})}}export{t as MediaType};
+class t{constructor(e){let i,o,p=e.mediaType.replace(/\s/g,"").split(";");const s=p[0].split("/");if(s.length===2){if(i=s[0].toLowerCase().trim(),o=s[1].toLowerCase().trim(),i.length===0||o.length===0)throw new Error("Invalid media type")}else throw new Error("Invalid media type");const r={};for(let n=1;n<p.length;n++){const a=p[n].split("=");if(a.length===2){const u=a[0].toLocaleLowerCase(),f=u==="charset"?a[1].toUpperCase():a[1];r[u]=f}}const c={},m=Object.keys(r);m.sort((n,a)=>n.localeCompare(a)),m.forEach(n=>c[n]=r[n]);let l="";for(const n in c){const a=c[n];l+=`;${n}=${a}`}const g=`${i}/${o}${l}`,E=c.encoding;this.string=g,this.type=i,this.subtype=o,this.parameters=c,this.encoding=E,this.name=e.name,this.fileExtension=e.fileExtension}static parse(e){return new t(e)}get structuredSyntaxSuffix(){const e=this.subtype.split("+");return e.length>1?`+${e[e.length-1]}`:void 0}get essence(){return`${this.type}/${this.subtype}`}get charset(){return this.parameters.charset}contains(e){const i=typeof e=="string"?t.parse({mediaType:e}):e;if(!((this.type==="*"||this.type===i.type)&&(this.subtype==="*"||this.subtype===i.subtype)))return!1;const o=new Set(Object.entries(this.parameters).map(([s,r])=>`${s}=${r}`)),p=new Set(Object.entries(i.parameters).map(([s,r])=>`${s}=${r}`));for(const s of Array.from(o.values()))if(!p.has(s))return!1;return!0}matches(e){const i=typeof e=="string"?t.parse({mediaType:e}):e;return this.contains(i)||i.contains(this)}matchesAny(...e){for(const i of e)if(this.matches(i))return!0;return!1}equals(e){return this.string===e.string}get isZIP(){return this.matchesAny(t.ZIP,t.LCP_PROTECTED_AUDIOBOOK,t.LCP_PROTECTED_PDF)||this.structuredSyntaxSuffix==="+zip"}get isJSON(){return this.matchesAny(t.JSON)||this.structuredSyntaxSuffix==="+json"}get isOPDS(){return this.matchesAny(t.OPDS1,t.OPDS1_ENTRY,t.OPDS2,t.OPDS2_PUBLICATION,t.OPDS_AUTHENTICATION)||this.structuredSyntaxSuffix==="+json"}get isHTML(){return this.matchesAny(t.HTML,t.XHTML)}get isBitmap(){return this.matchesAny(t.AVIF,t.BMP,t.GIF,t.JPEG,t.PNG,t.TIFF,t.WEBP)}get isAudio(){return this.type==="audio"}get isVideo(){return this.type==="video"}get isRWPM(){return this.matchesAny(t.READIUM_AUDIOBOOK_MANIFEST,t.DIVINA_MANIFEST,t.READIUM_WEBPUB_MANIFEST)}get isPublication(){return this.matchesAny(t.READIUM_AUDIOBOOK,t.READIUM_AUDIOBOOK_MANIFEST,t.CBZ,t.DIVINA,t.DIVINA_MANIFEST,t.EPUB,t.LCP_PROTECTED_AUDIOBOOK,t.LCP_PROTECTED_PDF,t.LPF,t.PDF,t.W3C_WPUB_MANIFEST,t.READIUM_WEBPUB,t.READIUM_WEBPUB_MANIFEST,t.ZAB)}static get AAC(){return t.parse({mediaType:"audio/aac",fileExtension:"aac"})}static get ACSM(){return t.parse({mediaType:"application/vnd.adobe.adept+xml",name:"Adobe Content Server Message",fileExtension:"acsm"})}static get AIFF(){return t.parse({mediaType:"audio/aiff",fileExtension:"aiff"})}static get AVI(){return t.parse({mediaType:"video/x-msvideo",fileExtension:"avi"})}static get AVIF(){return t.parse({mediaType:"image/avif",fileExtension:"avif"})}static get BINARY(){return t.parse({mediaType:"application/octet-stream"})}static get BMP(){return t.parse({mediaType:"image/bmp",fileExtension:"bmp"})}static get CBZ(){return t.parse({mediaType:"application/vnd.comicbook+zip",name:"Comic Book Archive",fileExtension:"cbz"})}static get CSS(){return t.parse({mediaType:"text/css",fileExtension:"css"})}static get DIVINA(){return t.parse({mediaType:"application/divina+zip",name:"Digital Visual Narratives",fileExtension:"divina"})}static get DIVINA_MANIFEST(){return t.parse({mediaType:"application/divina+json",name:"Digital Visual Narratives",fileExtension:"json"})}static get EPUB(){return t.parse({mediaType:"application/epub+zip",name:"EPUB",fileExtension:"epub"})}static get GIF(){return t.parse({mediaType:"image/gif",fileExtension:"gif"})}static get GZ(){return t.parse({mediaType:"application/gzip",fileExtension:"gz"})}static get HTML(){return t.parse({mediaType:"text/html",fileExtension:"html"})}static get JAVASCRIPT(){return t.parse({mediaType:"text/javascript",fileExtension:"js"})}static get JPEG(){return t.parse({mediaType:"image/jpeg",fileExtension:"jpeg"})}static get JSON(){return t.parse({mediaType:"application/json"})}static get LCP_LICENSE_DOCUMENT(){return t.parse({mediaType:"application/vnd.readium.lcp.license.v1.0+json",name:"LCP License",fileExtension:"lcpl"})}static get LCP_PROTECTED_AUDIOBOOK(){return t.parse({mediaType:"application/audiobook+lcp",name:"LCP Protected Audiobook",fileExtension:"lcpa"})}static get LCP_PROTECTED_PDF(){return t.parse({mediaType:"application/pdf+lcp",name:"LCP Protected PDF",fileExtension:"lcpdf"})}static get LCP_STATUS_DOCUMENT(){return t.parse({mediaType:"application/vnd.readium.license.status.v1.0+json"})}static get LPF(){return t.parse({mediaType:"application/lpf+zip",fileExtension:"lpf"})}static get MP3(){return t.parse({mediaType:"audio/mpeg",fileExtension:"mp3"})}static get MPEG(){return t.parse({mediaType:"video/mpeg",fileExtension:"mpeg"})}static get NCX(){return t.parse({mediaType:"application/x-dtbncx+xml",fileExtension:"ncx"})}static get OGG(){return t.parse({mediaType:"audio/ogg",fileExtension:"oga"})}static get OGV(){return t.parse({mediaType:"video/ogg",fileExtension:"ogv"})}static get OPDS1(){return t.parse({mediaType:"application/atom+xml;profile=opds-catalog"})}static get OPDS1_ENTRY(){return t.parse({mediaType:"application/atom+xml;type=entry;profile=opds-catalog"})}static get OPDS2(){return t.parse({mediaType:"application/opds+json"})}static get OPDS2_PUBLICATION(){return t.parse({mediaType:"application/opds-publication+json"})}static get OPDS_AUTHENTICATION(){return t.parse({mediaType:"application/opds-authentication+json"})}static get OPUS(){return t.parse({mediaType:"audio/opus",fileExtension:"opus"})}static get OTF(){return t.parse({mediaType:"font/otf",fileExtension:"otf"})}static get PDF(){return t.parse({mediaType:"application/pdf",name:"PDF",fileExtension:"pdf"})}static get PNG(){return t.parse({mediaType:"image/png",fileExtension:"png"})}static get READIUM_AUDIOBOOK(){return t.parse({mediaType:"application/audiobook+zip",name:"Readium Audiobook",fileExtension:"audiobook"})}static get READIUM_AUDIOBOOK_MANIFEST(){return t.parse({mediaType:"application/audiobook+json",name:"Readium Audiobook",fileExtension:"json"})}static get READIUM_CONTENT_DOCUMENT(){return t.parse({mediaType:"application/vnd.readium.content+json",name:"Readium Content Document",fileExtension:"json"})}static get READIUM_GUIDED_NAVIGATION_DOCUMENT(){return t.parse({mediaType:"application/guided-navigation+json",name:"Readium Guided Navigation Document",fileExtension:"json"})}static get READIUM_POSITION_LIST(){return t.parse({mediaType:"application/vnd.readium.position-list+json",name:"Readium Position List",fileExtension:"json"})}static get READIUM_WEBPUB(){return t.parse({mediaType:"application/webpub+zip",name:"Readium Web Publication",fileExtension:"webpub"})}static get READIUM_WEBPUB_MANIFEST(){return t.parse({mediaType:"application/webpub+json",name:"Readium Web Publication",fileExtension:"json"})}static get SMIL(){return t.parse({mediaType:"application/smil+xml",fileExtension:"smil"})}static get SVG(){return t.parse({mediaType:"image/svg+xml",fileExtension:"svg"})}static get TEXT(){return t.parse({mediaType:"text/plain",fileExtension:"txt"})}static get TIFF(){return t.parse({mediaType:"image/tiff",fileExtension:"tiff"})}static get TTF(){return t.parse({mediaType:"font/ttf",fileExtension:"ttf"})}static get W3C_WPUB_MANIFEST(){return t.parse({mediaType:"application/x.readium.w3c.wpub+json",name:"Web Publication",fileExtension:"json"})}static get WAV(){return t.parse({mediaType:"audio/wav",fileExtension:"wav"})}static get WEBM_AUDIO(){return t.parse({mediaType:"audio/webm",fileExtension:"webm"})}static get WEBM_VIDEO(){return t.parse({mediaType:"video/webm",fileExtension:"webm"})}static get WEBP(){return t.parse({mediaType:"image/webp",fileExtension:"webp"})}static get WOFF(){return t.parse({mediaType:"font/woff",fileExtension:"woff"})}static get WOFF2(){return t.parse({mediaType:"font/woff2",fileExtension:"woff2"})}static get XHTML(){return t.parse({mediaType:"application/xhtml+xml",fileExtension:"xhtml"})}static get XML(){return t.parse({mediaType:"application/xml",fileExtension:"xml"})}static get ZAB(){return t.parse({mediaType:"application/x.readium.zab+zip",name:"Zipped Audio Book",fileExtension:"zab"})}static get ZIP(){return t.parse({mediaType:"application/zip",fileExtension:"zip"})}}export{t as MediaType};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@readium/shared",
-  "version": "2.5.1",
+  "version": "2.7.0",
   "type": "module",
   "description": "Shared models to be used across other Readium projects and implementations in Typescript",
   "author": "readium",
@@ -56,7 +56,7 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@readium/helpers": "1.1.0"
+    "@readium/helpers": "1.2.0"
   },
   "files": [
     "dist",
@@ -64,7 +64,7 @@
     "types"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=24"
   },
   "devDependencies": {
     "@babel/core": "^7.28.6",

package/src/fetcher/HttpFetcher.ts

@@ -1,6 +1,6 @@
 import { Link } from '../publication/Link.ts';
 import { Fetcher } from './Fetcher.ts';
-import { NumberRange, Resource } from './Resource.ts';
+import { NumberRange, Resource, ResourceReadOptions } from './Resource.ts';
 
 export type FetchImplementation = (
   input: RequestInfo | URL,
@@ -72,9 +72,9 @@ export class HttpResource implements Resource {
     return this._link; // TODO mediatype alteration. Need http response mediatype sniffer stuff
   }
 
-  async read(range?: NumberRange): Promise<Uint8Array | undefined> {
+  async read(range?: NumberRange, options?: ResourceReadOptions): Promise<Uint8Array | undefined> {
     if (range) throw new Error('http read range not implemented!'); // TODO
-    const resp = await this.client(this.url);
+    const resp = await this.client(this.url, options?.signal ? { signal: options.signal } : undefined);
     if (!resp.ok)
       throw new Error(
         `http GET request for ${this.url} failed with HTTP status code ${resp.status}`
@@ -108,7 +108,7 @@ export class HttpResource implements Resource {
     return await resp.text();
   }
 
-  async readAsXML(): Promise<XMLDocument> {
+  async readAsXML(): Promise<Document> {
     const resp = await this.client(this.url);
     if (!resp.ok)
       throw new Error(
@@ -116,7 +116,7 @@ export class HttpResource implements Resource {
       ); // TODO
     return new DOMParser().parseFromString(
       await resp.text(),
-      'application/xml'
+      this._link.mediaType.isHTML ? (this._link.mediaType.essence as 'application/xhtml+xml' | 'text/html') : 'text/xml'
     );
   }
 }

package/src/fetcher/Resource.ts

@@ -11,10 +11,15 @@ export class NumberRange {
   }
 }
 
+export interface ResourceReadOptions {
+  /** Aborts the underlying request, e.g. when a prefetched resource is no longer needed */
+  signal?: AbortSignal;
+}
+
 export abstract class Resource {
   abstract link(): Promise<Link>;
   abstract length(): Promise<number | undefined>; // TODO make try?
-  abstract read(range?: NumberRange): Promise<Uint8Array | undefined>;
+  abstract read(range?: NumberRange, options?: ResourceReadOptions): Promise<Uint8Array | undefined>;
   readAsString(): Promise<string | undefined> {
     return this.read().then(bytes => {
       if (bytes === undefined) return bytes;
@@ -27,11 +32,11 @@ export abstract class Resource {
       return JSON.parse(str);
     });
   }
-  readAsXML(): Promise<XMLDocument | undefined> {
-    return this.readAsString().then(str => {
+  readAsXML(): Promise<Document | undefined> {
+    return this.link().then(l => this.readAsString().then(str => {
       if (str === undefined) return str;
-      return new DOMParser().parseFromString(str, 'text/xml');
-    });
+      return new DOMParser().parseFromString(str, l.mediaType.isHTML ? (l.mediaType.essence as 'application/xhtml+xml' | 'text/html') : 'text/xml');
+    }));
   }
   abstract close(): void;
 }

package/src/publication/GuidedNavigation.ts

@@ -2,7 +2,6 @@ import {
   arrayfromJSONorString,
   setToArray,
 } from '../util/JSONParse.ts';
-import { Links } from "./Link.ts";
 
 export interface Clip {
     audioResource: string;
@@ -16,35 +15,34 @@ export interface Clip {
  * https://readium.org/guided-navigation/schema/document.schema.json
  */
 export class GuidedNavigationDocument {
-    public readonly links?: Links;
-    public readonly guided?: GuidedNavigationObject[];
+    /** Non-empty sequence of objects meant to be presented sequentially to the user. */
+    public readonly guided: GuidedNavigationObject[];
 
     constructor(values: {
-        links?: Links;
-        guided?: GuidedNavigationObject[];
+        guided: GuidedNavigationObject[];
     }) {
-        this.links = values.links;
         this.guided = values.guided;
     }
 
+    /**
+     * Deserializes a GuidedNavigationDocument from JSON.
+     * Returns undefined if `guided` is missing or has no valid object.
+     */
     public static deserialize(json: any): GuidedNavigationDocument | undefined {
         if (!json) return;
-        return new GuidedNavigationDocument({
-            links: Links.deserialize(json.links),
-            guided: GuidedNavigationObject.deserializeArray(json.guided),
-        });
+        const guided = GuidedNavigationObject.deserializeArray(json.guided);
+        if (!guided || guided.length === 0) return;
+        return new GuidedNavigationDocument({ guided });
     }
 
     public serialize(): any {
-        const json: any = {};
-        if (this.links !== undefined) json.links = this.links.serialize();
-        if (this.guided !== undefined) json.guided = this.guided.map(x => x.serialize());
-        return json;
+        return { guided: this.guided.map(x => x.serialize()) };
     }
 }
 
 /**
  * Represents a text value containing plain text, SSML, and language information.
+ * https://readium.org/guided-navigation/schema/text.schema.json
  */
 export class GuidedNavigationText {
     /** Plain text content */
@@ -76,11 +74,11 @@ export class GuidedNavigationText {
         if (json === undefined || json === null) return undefined;
 
         if (typeof json === 'string') {
-            return new GuidedNavigationText({ plain: json });
+            return json.length > 0 ? new GuidedNavigationText({ plain: json }) : undefined;
         }
 
-        // Only create if there are actual values
-        if (json.plain || json.ssml || json.language) {
+        // The schema requires a non-empty `plain` or `ssml`
+        if (json.plain || json.ssml) {
             return new GuidedNavigationText({
                 plain: json.plain,
                 ssml: json.ssml,
@@ -104,11 +102,82 @@ export class GuidedNavigationText {
 }
 
 /**
- * Guided Navigation Object
- * https://github.com/readium/guided-navigation/blob/main/schema/object.schema.json
+ * Text, audio, image or video description of a Guided Navigation Object.
+ * https://readium.org/guided-navigation/schema/description.schema.json
  */
+export class GuidedNavigationDescription {
+    /** References an audio resource or a fragment of it. */
+    public readonly audioref?: string;
+
+    /** References an image or a fragment of it. */
+    public readonly imgref?: string;
+
+    /** References a textual resource or a fragment of it. */
+    public readonly textref?: string;
+
+    /** References a video resource or a fragment of it. */
+    public readonly videoref?: string;
+
+    /** Textual description. */
+    public readonly text?: GuidedNavigationText;
+
+    constructor(values: {
+        audioref?: string;
+        imgref?: string;
+        textref?: string;
+        videoref?: string;
+        text?: GuidedNavigationText;
+    }) {
+        this.audioref = values.audioref;
+        this.imgref = values.imgref;
+        this.textref = values.textref;
+        this.videoref = values.videoref;
+        this.text = values.text;
+    }
+
+    /**
+     * Deserializes a GuidedNavigationDescription from JSON.
+     * Returns undefined if it has none of the refs nor text.
+     */
+    public static deserialize(json: any): GuidedNavigationDescription | undefined {
+        if (!json) return undefined;
+        const description = new GuidedNavigationDescription({
+            audioref: json.audioref,
+            imgref: json.imgref,
+            textref: json.textref,
+            videoref: json.videoref,
+            text: GuidedNavigationText.deserialize(json.text)
+        });
+        if (
+            description.audioref === undefined &&
+            description.imgref === undefined &&
+            description.textref === undefined &&
+            description.videoref === undefined &&
+            description.text === undefined
+        ) return undefined;
+        return description;
+    }
+
+    public serialize(): any {
+        const json: any = {};
+        if (this.audioref !== undefined) json.audioref = this.audioref;
+        if (this.imgref !== undefined) json.imgref = this.imgref;
+        if (this.textref !== undefined) json.textref = this.textref;
+        if (this.videoref !== undefined) json.videoref = this.videoref;
+        const text = this.text?.serialize();
+        if (text !== undefined) json.text = text;
+        return json;
+    }
+}
 
+/**
+ * Guided Navigation Object
+ * https://readium.org/guided-navigation/schema/document.schema.json
+ */
 export class GuidedNavigationObject {
+  /** Identifier of the object. */
+  public readonly id?: string;
+
   /** References an audio resource or a fragment of it. */
   public readonly audioref?: string;
 
@@ -121,13 +190,6 @@ export class GuidedNavigationObject {
   /** Convey the structural semantics of a publication. */
   public readonly role?: Set<string>;
 
-  /**
-   * Indicates the heading level (1-6) for the navigation object.
-   * @minimum 1
-   * @maximum 6
-   */
-  public readonly level?: number;
-
   /**
    * Textual equivalent of the resources or fragment of the resources referenced by the current Guided Navigation Object.
    */
@@ -136,32 +198,34 @@ export class GuidedNavigationObject {
   /** References a textual resource or a fragment of it. */
   public readonly textref?: string;
 
-  /**
-   * Describes the image referenced by the current Guided Navigation Object.
-   * This is a GuidedNavigationObject that should not contain 'level' or 'children' properties.
-   */
-  public readonly description?: Omit<GuidedNavigationObject, 'level' | 'children'>;
+  /** References a video resource or a fragment of it. */
+  public readonly videoref?: string;
+
+  /** Text, audio, image or video description of the current Guided Navigation Object. */
+  public readonly description?: GuidedNavigationDescription;
 
     /**
      * Creates a [GuidedNavigation] object.
     */
     constructor(values: {
+        id?: string;
         audioref?: string;
         children?: GuidedNavigationObject[];
         imgref?: string;
         role?: Set<string>;
-        level?: number;
         text?: GuidedNavigationText;
         textref?: string;
-        description?: Omit<GuidedNavigationObject, 'level' | 'children'>;
+        videoref?: string;
+        description?: GuidedNavigationDescription;
     }) {
+        this.id = values.id;
         this.audioref = values.audioref;
         this.children = values.children;
         this.imgref = values.imgref;
         this.role = values.role;
-        this.level = values.level !== undefined ? Math.min(6, Math.max(1, values.level)) : undefined;
         this.text = values.text;
         this.textref = values.textref;
+        this.videoref = values.videoref;
         this.description = values.description;
     }
 
@@ -188,23 +252,35 @@ export class GuidedNavigationObject {
     }
 
     /**
-     * Deserializes a GuidedNavigationObject from JSON
+     * Deserializes a GuidedNavigationObject from JSON.
+     * Returns undefined if it has none of the refs, text, nor children.
      */
     public static deserialize(json: any): GuidedNavigationObject | undefined {
         if (!json) return undefined;
 
-        return new GuidedNavigationObject({
+        const children = GuidedNavigationObject.deserializeArray(json.children);
+        const obj = new GuidedNavigationObject({
+            id: typeof json.id === 'string' ? json.id : undefined,
             audioref: json.audioref,
-            children: GuidedNavigationObject.deserializeArray(json.children),
+            children: children && children.length > 0 ? children : undefined,
             imgref: json.imgref,
             role: json.role
                 ? new Set<string>(arrayfromJSONorString(json.role))
                 : undefined,
-            level: typeof json.level === 'number' ? json.level : undefined,
             text: GuidedNavigationText.deserialize(json.text),
             textref: json.textref,
-            description: GuidedNavigationObject.deserialize(json.description)
+            videoref: json.videoref,
+            description: GuidedNavigationDescription.deserialize(json.description)
         });
+        if (
+            obj.audioref === undefined &&
+            obj.imgref === undefined &&
+            obj.textref === undefined &&
+            obj.videoref === undefined &&
+            obj.text === undefined &&
+            obj.children === undefined
+        ) return undefined;
+        return obj;
     }
 
     /**
@@ -213,8 +289,8 @@ export class GuidedNavigationObject {
     public static deserializeArray(json: any): GuidedNavigationObject[] | undefined {
         if (!(Array.isArray(json))) return undefined;
         return json
-            .map<GuidedNavigationObject>((item) => GuidedNavigationObject.deserialize(item) as GuidedNavigationObject)
-            .filter((x) => x !== undefined);
+            .map((item) => GuidedNavigationObject.deserialize(item))
+            .filter((x): x is GuidedNavigationObject => x !== undefined);
     }
 
     /**
@@ -222,11 +298,11 @@ export class GuidedNavigationObject {
      */
     public serialize(): any {
         const json: any = {};
+        if (this.id !== undefined) json.id = this.id;
         if (this.audioref !== undefined) json.audioref = this.audioref;
         if (this.children !== undefined) json.children = this.children.map(x => x.serialize());
         if (this.imgref !== undefined) json.imgref = this.imgref;
         if (this.role !== undefined) json.role = setToArray(this.role);
-        if (this.level !== undefined) json.level = this.level;
         if (this.text !== undefined) {
             const serializedText = this.text.serialize();
             if (serializedText !== undefined) {
@@ -234,9 +310,8 @@ export class GuidedNavigationObject {
             }
         }
         if (this.textref !== undefined) json.textref = this.textref;
-        if (this.description) {
-            json.description = this.description.serialize();
-        }
+        if (this.videoref !== undefined) json.videoref = this.videoref;
+        if (this.description !== undefined) json.description = this.description.serialize();
         return json;
     }
 

package/src/publication/Locator.ts

@@ -11,7 +11,7 @@ import { arrayfromJSONorString, numberfromJSON } from '../util/JSONParse.ts';
  */
 export class LocatorLocations {
   /** Contains one or more fragment in the resource referenced by the `Locator`. */
-  public readonly fragments: Array<string>;
+  public readonly fragments?: Array<string>;
 
   /** Progression in the resource expressed as a percentage (between 0 and 1). */
   public readonly progression?: number;

package/src/publication/Manifest.ts

@@ -43,7 +43,7 @@ export class Manifest {
   }) {
     this.context = values.context;
     this.metadata = values.metadata;
-    this.links = values.links;
+    this.links = values.links || new Links([]);
     this.readingOrder = values.readingOrder;
     this.resources = values.resources;
     this.toc = values.toc;
@@ -63,8 +63,6 @@ export class Manifest {
 
     if (!metadata) return;
 
-    const links = Links.deserialize(json.links);
-
     const readingOrder = Links.deserialize(
       json.readingOrder ? json.readingOrder : json.spine
     );
@@ -80,7 +78,7 @@ export class Manifest {
     return new Manifest({
       context: arrayfromJSONorString(json['@context']),
       metadata,
-      links,
+      links: Links.deserialize(json.links),
       readingOrder,
       resources: Links.deserialize(json.resources),
       toc: Links.deserialize(json.toc),
@@ -95,7 +93,7 @@ export class Manifest {
     const json: any = {};
     if (this.context !== undefined) json['@context'] = this.context;
     json.metadata = this.metadata.serialize();
-    if (this.links !== undefined) json.links = this.links.serialize();
+    if (this.links && this.links.items.length > 0) json.links = this.links.serialize();
     json.readingOrder = this.readingOrder.serialize();
     if (this.resources) json.resources = this.resources.serialize();
     if (this.toc) json.toc = this.toc.serialize();
@@ -222,26 +220,33 @@ export class Manifest {
 
   /** The URL where this publication is served, computed from the `Link` with `self` relation.
    *  e.g. https://provider.com/pub1293/manifest.json gives https://provider.com/pub1293/
+   *
+   *  Drops the query, fragment and last path segment, so for any hierarchical
+   *  URL the result ends in `/`. The frame CSP relies on this, since a source
+   *  path only prefix-matches when it ends in a slash.
    */
   public get baseURL(): string | undefined {
     const selfLink = this.links?.items.find(
       el => el.rels && el.rels.has('self')
     );
-    if (selfLink) {
-      let href = selfLink.href;
-      if (href) {
-        const li = href.lastIndexOf('/');
-        const lastpart = li === -1 ? undefined : href.substring(li + 1);
-
-        href = href.replace(new RegExp('/?$query$'), '');
-        href = href.replace(new RegExp('//$'), '');
-        if (lastpart) {
-          href = href.replace(new RegExp(lastpart + '$'), '');
-        }
-      }
-      return href;
+    if (!selfLink) return undefined;
+
+    const href = selfLink.href;
+    if (!href) return undefined;
+
+    try {
+      const url = new URL(href);
+      url.search = '';
+      url.hash = '';
+      url.pathname = url.pathname.substring(
+        0,
+        url.pathname.lastIndexOf('/') + 1
+      );
+      return url.href;
+    } catch {
+      // Relative self link (e.g. `/manifest.json`), not parseable by `URL`
+      return href.split(/[?#]/)[0].replace(/[^/]*$/, '');
     }
-    return undefined;
   }
 
   /**

package/src/publication/html/Locations.ts

@@ -21,17 +21,13 @@ export function getDomRange(loc: LocatorLocations): DomRange | undefined {
 // A WICG text-fragment directive (":~:text=...") found among fragments, per
 // https://wicg.github.io/scroll-to-text-fragment/.
 export function getTextFragment(loc: LocatorLocations): TextFragmentDirective | undefined {
-  for (const fragment of loc.fragments) {
-    const directive = decodeTextFragmentDirective(fragment);
-    if (directive) return directive;
-  }
-  return undefined;
+  return loc.fragments?.map(f => decodeTextFragmentDirective(f)).find(d => d);
 }
 
 export function getFragmentParameters(loc: LocatorLocations): Map<string, string> {
   return new Map(
     loc.fragments
-      .map(f => f.startsWith('#') ? f.slice(1) : f)
+      ?.map(f => f.startsWith('#') ? f.slice(1) : f)
       .join('&')
       .split('&')
       .filter(f => !f.startsWith('#'))
@@ -46,7 +42,7 @@ export function getHtmlId(loc: LocatorLocations): string | undefined {
   The HTML 5 specification (used for WebPub) allows any character in an HTML ID, except spaces.
   This is an issue to differentiate with named parameters, so we ignore any ID containing `=`.
   */
-  if (!loc.fragments.length) return;
+  if (!loc.fragments?.length) return;
   let f = loc.fragments.find(f => f.length && !f.includes('='));
   if (!f) {
     const fp = getFragmentParameters(loc);

package/src/publication/services/content/ContentTokenizer.ts

@@ -2,9 +2,13 @@ import { DefaultTextContentTokenizer, Range, TextTokenizer, TextUnit, Tokenizer
 import { Locator, LocatorText } from "../../Locator.ts";
 import { ContentElement, TextElement, TextSegment } from "./element/index.ts";
 
-// A tokenizer splitting a [Content.Element] into smaller pieces.
+/**
+ * A tokenizer splitting a [Content.Element] into smaller pieces.
+ * @deprecated Use `@readium/speech`, which segments text itself.
+ */
 export type ContentTokenizer  = Tokenizer<ContentElement, ContentElement>;
 
+/** @deprecated Use `@readium/speech`, which segments text itself. */
 export class TextContentTokenizer implements ContentTokenizer {
     /**
      *

package/src/publication/services/content/iterators/HTMLResourceContentIterator.ts

@@ -21,6 +21,8 @@ interface ElementWithDelta {
  * If you want to start from the end of the resource, the [locator] must have a `progression` of 1.0.
  *
  * Locators will contain a `before` context of up to `beforeMaxLength` characters.
+ *
+ * @deprecated Use `@readium/guided-navigation` and `@readium/speech` instead.
  */
 export class HTMLResourceContentIterator extends Iterator {
     private currentElement: ElementWithDelta | null = null;

package/src/util/mediatype/MediaType.ts

@@ -107,6 +107,13 @@ export class MediaType {
     return parts.length > 1 ? `+${parts[parts.length - 1]}` : undefined;
   }
 
+  /** The media type without its parameters, e.g. `text/html` for `text/html;charset=utf-8`.
+   *  See. https://mimesniff.spec.whatwg.org/#mime-type-essence
+   */
+  public get essence(): string {
+    return `${this.type}/${this.subtype}`;
+  }
+
   /** Parameter values might or might not be case-sensitive, depending on the semantics of
    * the parameter name.
    * https://tools.ietf.org/html/rfc2616#section-3.7

package/src/util/tokenizer/TextTokenizer.ts

@@ -3,16 +3,21 @@ import { Tokenizer } from "./Tokenizer.ts";
 import BasicEnglishTokenizer from "./tokenize-english/index.js";
 import BasicTokenizer, { TextlintSegment } from "./tokenize-text/index.js";
 
-// Start / End
+/**
+ * Start / End
+ * @deprecated Use `@readium/speech`, which segments text itself.
+ */
 export type Range = [number, number];
 
 /**
  * A tokenizer splitting a String into range tokens (e.g. words, sentences, etc.).
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export type TextTokenizer = Tokenizer<string, Range>;
 
 /**
  * A text token unit which can be used with a [TextTokenizer].
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export enum TextUnit {
     Word = "word",
@@ -20,7 +25,10 @@ export enum TextUnit {
     Paragraph = "paragraph",
 }
 
-//  A default cluster [TextTokenizer] taking advantage of the best capabilities of the navigator
+/**
+ * A default cluster [TextTokenizer] taking advantage of the best capabilities of the navigator
+ * @deprecated Use `@readium/speech`, which segments text itself.
+ */
 export const DefaultTextContentTokenizer = (language: Language | null, unit: TextUnit): TextTokenizer => {
     if("Segmenter" in Intl) {
         // Available in any evergreen browser EXCEPT for Firefox.
@@ -35,6 +43,7 @@ export const DefaultTextContentTokenizer = (language: Language | null, unit: Tex
 /**
  * A [TextTokenizer] using the Intl.Segmenter API.
  * Very aware of language-specific rules since it uses ICU behind the scenes.
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export class IntlTextTokenizer implements TextTokenizer {
     private segmenter: Intl.Segmenter;
@@ -68,6 +77,7 @@ export class IntlTextTokenizer implements TextTokenizer {
  * A [TextTokenizer] using a naive approach to splitting text into tokens.
  * This is a fallback for browsers that don't support Intl.Segmenter.
  * It works mainly on English and similar languages. Don't use unless necessary.
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export class NaiveTextTokenizer {
     private tokenizer: BasicTokenizer;
@@ -116,8 +126,11 @@ export class NaiveTextTokenizer {
 
 const trimmedMatcher = new RegExp("[\\p{L}\\p{N}]+", "u");
 
-// Unicode-aware of checking if there's anything that can be spoken in a string
-// "Spoken" in this case means at least one unicode letter or unicode number character
+/**
+ * Unicode-aware of checking if there's anything that can be spoken in a string
+ * "Spoken" in this case means at least one unicode letter or unicode number character
+ * @deprecated Use `@readium/speech`, which segments text itself.
+ */
 export const speakableToken = (token: string): string | null => {
     const trimmedToken = token.trimEnd();
     if(trimmedToken.length === 0) return null;

package/src/util/tokenizer/Tokenizer.ts

@@ -2,6 +2,7 @@
 
 /**
  * A tokenizer splits a piece of data [D] into a list of [T] tokens.
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export interface Tokenizer<D, T> {
     tokenize(data: D): T[];

package/types/src/fetcher/HttpFetcher.d.ts

@@ -1,6 +1,6 @@
 import { Link } from '../publication/Link.ts';
 import { Fetcher } from './Fetcher.ts';
-import { NumberRange, Resource } from './Resource.ts';
+import { NumberRange, Resource, ResourceReadOptions } from './Resource.ts';
 export type FetchImplementation = (input: RequestInfo | URL, init?: RequestInit | undefined) => Promise<Response>;
 export declare class HttpFetcher implements Fetcher {
     private readonly baseUrl?;
@@ -20,9 +20,9 @@ export declare class HttpResource implements Resource {
     private headResponse;
     close(): void;
     link(): Promise<Link>;
-    read(range?: NumberRange): Promise<Uint8Array | undefined>;
+    read(range?: NumberRange, options?: ResourceReadOptions): Promise<Uint8Array | undefined>;
     length(): Promise<number>;
     readAsJSON(): Promise<unknown>;
     readAsString(): Promise<string>;
-    readAsXML(): Promise<XMLDocument>;
+    readAsXML(): Promise<Document>;
 }

package/types/src/fetcher/Resource.d.ts

@@ -4,12 +4,16 @@ export declare class NumberRange {
     readonly endInclusive: number;
     constructor(start: number, endInclusive: number);
 }
+export interface ResourceReadOptions {
+    /** Aborts the underlying request, e.g. when a prefetched resource is no longer needed */
+    signal?: AbortSignal;
+}
 export declare abstract class Resource {
     abstract link(): Promise<Link>;
     abstract length(): Promise<number | undefined>;
-    abstract read(range?: NumberRange): Promise<Uint8Array | undefined>;
+    abstract read(range?: NumberRange, options?: ResourceReadOptions): Promise<Uint8Array | undefined>;
     readAsString(): Promise<string | undefined>;
     readAsJSON(): Promise<unknown | undefined>;
-    readAsXML(): Promise<XMLDocument | undefined>;
+    readAsXML(): Promise<Document | undefined>;
     abstract close(): void;
 }

package/types/src/publication/GuidedNavigation.d.ts

@@ -1,4 +1,3 @@
-import { Links } from "./Link.ts";
 export interface Clip {
     audioResource: string;
     fragmentId?: string;
@@ -10,17 +9,21 @@ export interface Clip {
  * https://readium.org/guided-navigation/schema/document.schema.json
  */
 export declare class GuidedNavigationDocument {
-    readonly links?: Links;
-    readonly guided?: GuidedNavigationObject[];
+    /** Non-empty sequence of objects meant to be presented sequentially to the user. */
+    readonly guided: GuidedNavigationObject[];
     constructor(values: {
-        links?: Links;
-        guided?: GuidedNavigationObject[];
+        guided: GuidedNavigationObject[];
     });
+    /**
+     * Deserializes a GuidedNavigationDocument from JSON.
+     * Returns undefined if `guided` is missing or has no valid object.
+     */
     static deserialize(json: any): GuidedNavigationDocument | undefined;
     serialize(): any;
 }
 /**
  * Represents a text value containing plain text, SSML, and language information.
+ * https://readium.org/guided-navigation/schema/text.schema.json
  */
 export declare class GuidedNavigationText {
     /** Plain text content */
@@ -46,11 +49,42 @@ export declare class GuidedNavigationText {
      */
     serialize(): any;
 }
+/**
+ * Text, audio, image or video description of a Guided Navigation Object.
+ * https://readium.org/guided-navigation/schema/description.schema.json
+ */
+export declare class GuidedNavigationDescription {
+    /** References an audio resource or a fragment of it. */
+    readonly audioref?: string;
+    /** References an image or a fragment of it. */
+    readonly imgref?: string;
+    /** References a textual resource or a fragment of it. */
+    readonly textref?: string;
+    /** References a video resource or a fragment of it. */
+    readonly videoref?: string;
+    /** Textual description. */
+    readonly text?: GuidedNavigationText;
+    constructor(values: {
+        audioref?: string;
+        imgref?: string;
+        textref?: string;
+        videoref?: string;
+        text?: GuidedNavigationText;
+    });
+    /**
+     * Deserializes a GuidedNavigationDescription from JSON.
+     * Returns undefined if it has none of the refs nor text.
+     */
+    static deserialize(json: any): GuidedNavigationDescription | undefined;
+    serialize(): any;
+}
 /**
  * Guided Navigation Object
- * https://github.com/readium/guided-navigation/blob/main/schema/object.schema.json
+ * https://readium.org/guided-navigation/schema/document.schema.json
  */
 export declare class GuidedNavigationObject {
+    /** Identifier of the object. */
+    readonly id?: string;
     /** References an audio resource or a fragment of it. */
     readonly audioref?: string;
     /** Items that are children of the containing Guided Navigation Object. */
@@ -59,35 +93,29 @@ export declare class GuidedNavigationObject {
     readonly imgref?: string;
     /** Convey the structural semantics of a publication. */
     readonly role?: Set<string>;
-    /**
-     * Indicates the heading level (1-6) for the navigation object.
-     * @minimum 1
-     * @maximum 6
-     */
-    readonly level?: number;
     /**
      * Textual equivalent of the resources or fragment of the resources referenced by the current Guided Navigation Object.
      */
     readonly text?: GuidedNavigationText;
     /** References a textual resource or a fragment of it. */
     readonly textref?: string;
-    /**
-     * Describes the image referenced by the current Guided Navigation Object.
-     * This is a GuidedNavigationObject that should not contain 'level' or 'children' properties.
-     */
-    readonly description?: Omit<GuidedNavigationObject, 'level' | 'children'>;
+    /** References a video resource or a fragment of it. */
+    readonly videoref?: string;
+    /** Text, audio, image or video description of the current Guided Navigation Object. */
+    readonly description?: GuidedNavigationDescription;
     /**
      * Creates a [GuidedNavigation] object.
     */
     constructor(values: {
+        id?: string;
         audioref?: string;
         children?: GuidedNavigationObject[];
         imgref?: string;
         role?: Set<string>;
-        level?: number;
         text?: GuidedNavigationText;
         textref?: string;
-        description?: Omit<GuidedNavigationObject, 'level' | 'children'>;
+        videoref?: string;
+        description?: GuidedNavigationDescription;
     });
     /**
      * Gets the plain text content.
@@ -103,7 +131,8 @@ export declare class GuidedNavigationObject {
      */
     get textLanguage(): string | undefined;
     /**
-     * Deserializes a GuidedNavigationObject from JSON
+     * Deserializes a GuidedNavigationObject from JSON.
+     * Returns undefined if it has none of the refs, text, nor children.
      */
     static deserialize(json: any): GuidedNavigationObject | undefined;
     /**

package/types/src/publication/Locator.d.ts

@@ -4,7 +4,7 @@
  */
 export declare class LocatorLocations {
     /** Contains one or more fragment in the resource referenced by the `Locator`. */
-    readonly fragments: Array<string>;
+    readonly fragments?: Array<string>;
     /** Progression in the resource expressed as a percentage (between 0 and 1). */
     readonly progression?: number;
     /** Progression in the publication expressed as a percentage (between 0 and 1). */

package/types/src/publication/Manifest.d.ts

@@ -50,6 +50,10 @@ export declare class Manifest {
     linkWithHref(href: string): Link | undefined;
     /** The URL where this publication is served, computed from the `Link` with `self` relation.
      *  e.g. https://provider.com/pub1293/manifest.json gives https://provider.com/pub1293/
+     *
+     *  Drops the query, fragment and last path segment, so for any hierarchical
+     *  URL the result ends in `/`. The frame CSP relies on this, since a source
+     *  path only prefix-matches when it ends in a slash.
      */
     get baseURL(): string | undefined;
     /**

package/types/src/publication/services/content/ContentTokenizer.d.ts

@@ -1,6 +1,11 @@
 import { TextTokenizer, TextUnit, Tokenizer } from "../../../util/index.ts";
 import { ContentElement } from "./element/index.ts";
+/**
+ * A tokenizer splitting a [Content.Element] into smaller pieces.
+ * @deprecated Use `@readium/speech`, which segments text itself.
+ */
 export type ContentTokenizer = Tokenizer<ContentElement, ContentElement>;
+/** @deprecated Use `@readium/speech`, which segments text itself. */
 export declare class TextContentTokenizer implements ContentTokenizer {
     private readonly defaultLanguage;
     private readonly contextSnippetLength;

package/types/src/publication/services/content/iterators/HTMLResourceContentIterator.d.ts

@@ -11,6 +11,8 @@ import { ContentElement } from "../element/index.ts";
  * If you want to start from the end of the resource, the [locator] must have a `progression` of 1.0.
  *
  * Locators will contain a `before` context of up to `beforeMaxLength` characters.
+ *
+ * @deprecated Use `@readium/guided-navigation` and `@readium/speech` instead.
  */
 export declare class HTMLResourceContentIterator extends Iterator {
     private resource;

package/types/src/util/mediatype/MediaType.d.ts

@@ -37,6 +37,10 @@ export declare class MediaType {
      *  See. https://tools.ietf.org/html/rfc6838#section-4.2.8
      */
     get structuredSyntaxSuffix(): string | undefined;
+    /** The media type without its parameters, e.g. `text/html` for `text/html;charset=utf-8`.
+     *  See. https://mimesniff.spec.whatwg.org/#mime-type-essence
+     */
+    get essence(): string;
     /** Parameter values might or might not be case-sensitive, depending on the semantics of
      * the parameter name.
      * https://tools.ietf.org/html/rfc2616#section-3.7

package/types/src/util/tokenizer/TextTokenizer.d.ts

@@ -1,22 +1,33 @@
 import { Language } from "../Language.ts";
 import { Tokenizer } from "./Tokenizer.ts";
+/**
+ * Start / End
+ * @deprecated Use `@readium/speech`, which segments text itself.
+ */
 export type Range = [number, number];
 /**
  * A tokenizer splitting a String into range tokens (e.g. words, sentences, etc.).
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export type TextTokenizer = Tokenizer<string, Range>;
 /**
  * A text token unit which can be used with a [TextTokenizer].
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export declare enum TextUnit {
     Word = "word",
     Sentence = "sentence",
     Paragraph = "paragraph"
 }
+/**
+ * A default cluster [TextTokenizer] taking advantage of the best capabilities of the navigator
+ * @deprecated Use `@readium/speech`, which segments text itself.
+ */
 export declare const DefaultTextContentTokenizer: (language: Language | null, unit: TextUnit) => TextTokenizer;
 /**
  * A [TextTokenizer] using the Intl.Segmenter API.
  * Very aware of language-specific rules since it uses ICU behind the scenes.
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export declare class IntlTextTokenizer implements TextTokenizer {
     private unit;
@@ -28,6 +39,7 @@ export declare class IntlTextTokenizer implements TextTokenizer {
  * A [TextTokenizer] using a naive approach to splitting text into tokens.
  * This is a fallback for browsers that don't support Intl.Segmenter.
  * It works mainly on English and similar languages. Don't use unless necessary.
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export declare class NaiveTextTokenizer {
     private unit;
@@ -36,4 +48,9 @@ export declare class NaiveTextTokenizer {
     constructor(language: Language | null, unit: TextUnit);
     tokenize(data: string): Range[];
 }
+/**
+ * Unicode-aware of checking if there's anything that can be spoken in a string
+ * "Spoken" in this case means at least one unicode letter or unicode number character
+ * @deprecated Use `@readium/speech`, which segments text itself.
+ */
 export declare const speakableToken: (token: string) => string | null;

package/types/src/util/tokenizer/Tokenizer.d.ts

@@ -1,5 +1,6 @@
 /**
  * A tokenizer splits a piece of data [D] into a list of [T] tokens.
+ * @deprecated Use `@readium/speech`, which segments text itself.
  */
 export interface Tokenizer<D, T> {
     tokenize(data: D): T[];