@readium/shared 2.4.0 → 2.5.0

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,getTime as xe}from"./publication/html/Locations.js";import{getAuthenticate as se,getAvailability as ge,getCopies as ce,getHolds as de,getIndirectAcquisitions as ue,getNumberOfItems as Te,getPrice as be}from"./publication/opds/Properties.js";import{getImages as Ce}from"./publication/opds/Publication.js";import{buildHtmlTimeline as Pe}from"./publication/services/timeline/html.js";import{buildAudioTimeline as Ne}from"./publication/services/timeline/audio.js";import{Timeline as Ie}from"./publication/services/timeline/Timeline.js";import{buildTimeline as Re}from"./publication/services/timeline/index.js";import{Content as Ee}from"./publication/services/content/Content.js";import{TextContentTokenizer as Me}from"./publication/services/content/ContentTokenizer.js";import{IllegalStateError as ke,Iterator as ze}from"./publication/services/content/Iterator.js";import{AudioElement as he,ContentElement as Je,ImageElement as je,TextElement as Ge,TextSegment as Ve,TextualElement as qe,VideoElement as Be}from"./publication/services/content/element/element.js";import{Attribute as Ke,AttributeKeys as Qe,AttributesHolder as We}from"./publication/services/content/element/attributes.js";import{Body as Xe,Footnote as Ye,Heading as Ze,TextQuote as _e}from"./publication/services/content/element/text_role.js";import{PublicationContentIterator as et}from"./publication/services/content/iterators/PublicationContentIterator.js";import{PDFContentElement as ot,PageContentIteratorPDF as rt}from"./publication/services/content/iterators/PDFTextContentIterator.js";import{HTMLResourceContentIterator as at}from"./publication/services/content/iterators/HTMLResourceContentIterator.js";import{AltIdentifier as nt}from"./publication/AltIdentifier.js";import{BelongsTo as ft}from"./publication/BelongsTo.js";import{Contributor as lt,Contributors as st}from"./publication/Contributor.js";import{Link as ct,Links as dt}from"./publication/Link.js";import{LocalizedString as Tt}from"./publication/LocalizedString.js";import{Locator as yt,LocatorLocations as Ct,LocatorText as At}from"./publication/Locator.js";import{LocatorCollection as Lt,LocatorCollectionMetadata as Nt}from"./publication/LocatorCollection.js";import{Manifest as It}from"./publication/Manifest.js";import{Metadata as Rt}from"./publication/Metadata.js";import{Profile as Et}from"./publication/Profiles.js";import{Page as Mt,Properties as Dt}from"./publication/Properties.js";import{Publication as zt}from"./publication/Publication.js";import{PublicationCollection as ht}from"./publication/PublicationCollection.js";import{Layout as jt}from"./publication/Layout.js";import{ReadingProgression as Vt,leadingPage as qt}from"./publication/ReadingProgression.js";import{Subject as Ut,Subjects as Kt}from"./publication/Subject.js";import{TDM as Wt,TDMReservation as wt}from"./publication/TDM.js";import{GuidedNavigationDocument as Yt,GuidedNavigationObject as Zt,GuidedNavigationText as _t}from"./publication/GuidedNavigation.js";import{Price as eo}from"./opds/Price.js";import{Acquisition as oo}from"./opds/Acquisition.js";import{Holds as io}from"./opds/Holds.js";import{Copies as mo}from"./opds/Copies.js";import{Availability as po,AvailabilityStatus as fo}from"./opds/Availability.js";import{MediaType as lo}from"./util/mediatype/MediaType.js";import{arrayfromJSON as go,arrayfromJSONorString as co,datefromJSON as uo,numberfromJSON as To,positiveNumberfromJSON as bo,setToArray as yo}from"./util/JSONParse.js";import{formatNptTime as Ao,isNptStartOfResource as Po,parseNptTime as Lo}from"./util/npt.js";import{URITemplate as So}from"./util/URITemplate.js";import{DefaultTextContentTokenizer as Oo,IntlTextTokenizer as Ro,NaiveTextTokenizer as vo,TextUnit as Eo,speakableToken as Ho}from"./util/tokenizer/TextTokenizer.js";export{x as AccessMode,l as Accessibility,y as AccessibilityMetadataDisplayGuide,s as AccessibilityProfile,C as AccessibilitySummary,oo as Acquisition,A as AdditionalInformation,nt as AltIdentifier,Ke as Attribute,Qe as AttributeKeys,We as AttributesHolder,he as AudioElement,po as Availability,fo as AvailabilityStatus,ft as BelongsTo,Xe as Body,g as Certification,P as Conformance,Ee as Content,Je as ContentElement,lt as Contributor,st as Contributors,mo as Copies,Oo as DefaultTextContentTokenizer,$ as DomRange,te as DomRangePoint,o as EmptyFetcher,F as Encryption,c as Exemption,d as Feature,Ye as Footnote,Yt as GuidedNavigationDocument,Zt as GuidedNavigationObject,_t as GuidedNavigationText,at as HTMLResourceContentIterator,u as Hazard,L as HazardType,N as Hazards,Ze as Heading,io as Holds,i as HttpFetcher,a as HttpResource,ke as IllegalStateError,je as ImageElement,Ro as IntlTextTokenizer,ze as Iterator,jt as Layout,S as Legal,ct as Link,dt as Links,k as Localization,Tt as LocalizedString,yt as Locator,Lt as LocatorCollection,Nt as LocatorCollectionMetadata,Ct as LocatorLocations,At as LocatorText,It as Manifest,G as MediaOverlay,lo as MediaType,Rt as Metadata,vo as NaiveTextTokenizer,I as Navigation,O as NonvisualReading,n as NumberRange,ot as PDFContentElement,Mt as Page,rt as PageContentIteratorPDF,R as PrerecordedAudio,eo as Price,T as PrimaryAccessMode,Et as Profile,Dt as Properties,zt as Publication,ht as PublicationCollection,et as PublicationContentIterator,Vt as ReadingProgression,p as Resource,v as RichContent,E as RichContentType,Ut as Subject,Kt as Subjects,Wt as TDM,wt as TDMReservation,Me as TextContentTokenizer,Ge as TextElement,_e as TextQuote,Ve as TextSegment,Eo as TextUnit,qe as TextualElement,Ie as Timeline,So as URITemplate,Be as VideoElement,H as VisualAdjustments,M as WaysOfReading,go as arrayfromJSON,co as arrayfromJSONorString,Ne as buildAudioTimeline,Pe as buildHtmlTimeline,Re as buildTimeline,uo as datefromJSON,Ao as formatNptTime,se as getAuthenticate,ge as getAvailability,U as getContains,ce as getCopies,re as getCssSelector,ie as getDomRange,J as getEncryption,ae as getFragmentParameters,de as getHolds,me as getHtmlId,Ce as getImages,ue as getIndirectAcquisitions,Q as getLandmarks,W as getListOfAudioClips,w as getListOfIllustrations,X as getListOfTables,Y as getListOfVideoClips,q as getMediaOverlay,Te as getNumberOfItems,ne as getPage,Z as getPageList,pe as getPartialCfi,be as getPrice,fe as getSpace,xe as getTime,Po as isNptStartOfResource,qt as leadingPage,To as numberfromJSON,Lo as parseNptTime,bo as positiveNumberfromJSON,yo as setToArray,Ho 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 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};

package/dist/publication/html/Locations.js

@@ -1 +1 @@
-import{DomRange as u}from"./DomRange.js";import{parseNptTime as h}from"../../util/npt.js";function x(e){return e.otherLocations?.get("cssSelector")}function C(e){return e.otherLocations?.get("partialCfi")}function L(e){return u.deserialize(e.otherLocations?.get("domRange"))}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 N(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 W(e){const t=parseInt(n(e).get("page"));if(!isNaN(t)&&t>=0)return t}function R(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:m=>parseInt(m,10),a=s.split(",").map(c);if(a.length!==4||a.some(isNaN))return;const[g,p,f,l]=a;return{unit:i,x:g,y:p,width:f,height:l}}export{x as getCssSelector,L as getDomRange,n as getFragmentParameters,N as getHtmlId,W as getPage,C as getPartialCfi,y as getSpace,R 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 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};

package/dist/publication/html/index.js

@@ -1 +1 @@
-import{DomRange as g}from"./DomRange.js";import{DomRangePoint as r}from"./DomRangePoint.js";import{getCssSelector as m,getDomRange as n,getFragmentParameters as f,getHtmlId as i,getPage as p,getPartialCfi as P,getSpace as l,getTime as s}from"./Locations.js";export{g as DomRange,r as DomRangePoint,m as getCssSelector,n as getDomRange,f as getFragmentParameters,i as getHtmlId,p as getPage,P as getPartialCfi,l as getSpace,s as getTime};
+import{DomRange as g}from"./DomRange.js";import{DomRangePoint as a}from"./DomRangePoint.js";import{getCssSelector as o,getDomRange as n,getFragmentParameters as f,getHtmlId as i,getPage as p,getPartialCfi as x,getSpace as P,getTextFragment as l,getTime as s}from"./Locations.js";export{g as DomRange,a as DomRangePoint,o as getCssSelector,n as getDomRange,f as getFragmentParameters,i as getHtmlId,p as getPage,x as getPartialCfi,P as getSpace,l as getTextFragment,s as getTime};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@readium/shared",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "type": "module",
   "description": "Shared models to be used across other Readium projects and implementations in Typescript",
   "author": "readium",
@@ -55,6 +55,9 @@
     }
   },
   "sideEffects": false,
+  "dependencies": {
+    "@readium/helpers": "1.1.0"
+  },
   "files": [
     "dist",
     "src",

package/src/publication/html/Locations.ts

@@ -1,6 +1,7 @@
 import { LocatorLocations } from '../Locator.ts';
 import { DomRange } from './DomRange.ts';
 import { parseNptTime } from '../../util/npt.ts';
+import { decodeTextFragmentDirective, TextFragmentDirective } from '@readium/helpers';
 
 // HTML extensions for LocatorLocations.
 // https://github.com/readium/architecture/blob/master/models/locators/extensions/html.md
@@ -17,6 +18,16 @@ export function getDomRange(loc: LocatorLocations): DomRange | undefined {
   return DomRange.deserialize(loc.otherLocations?.get('domRange'));
 }
 
+// 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;
+}
+
 export function getFragmentParameters(loc: LocatorLocations): Map<string, string> {
   return new Map(
     loc.fragments

package/types/src/publication/html/Locations.d.ts

@@ -1,8 +1,10 @@
 import { LocatorLocations } from '../Locator.ts';
 import { DomRange } from './DomRange.ts';
+import { TextFragmentDirective } from '@readium/helpers';
 export declare function getCssSelector(loc: LocatorLocations): string | undefined;
 export declare function getPartialCfi(loc: LocatorLocations): string | undefined;
 export declare function getDomRange(loc: LocatorLocations): DomRange | undefined;
+export declare function getTextFragment(loc: LocatorLocations): TextFragmentDirective | undefined;
 export declare function getFragmentParameters(loc: LocatorLocations): Map<string, string>;
 export declare function getHtmlId(loc: LocatorLocations): string | undefined;
 export declare function getPage(loc: LocatorLocations): number | undefined;