ropegeo-common 1.25.0 → 1.25.1

package/dist/models/betaSections/betaSection.d.ts

@@ -28,7 +28,7 @@ export declare abstract class BetaSection {
      * Builds a {@link BetaSectionExcerpt} for a verbatim excerpt from this section's text.
      * When the excerpt cannot be located, `start` and `end` are left undefined.
      */
-    toExcerpt(excerptText: string, relevanceStrength: RelevanceStrength, relevantPhrase: string): BetaSectionExcerpt;
+    toExcerpt(excerptText: string, relevanceStrength: RelevanceStrength, relevantPhrase?: string): BetaSectionExcerpt;
     /**
      * Renders an excerpt with nearby section context when its offsets still
      * match this section, otherwise falls back to the excerpt alone.

package/dist/models/betaSections/betaSection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"betaSection.d.ts","sourceRoot":"","sources":["../../../src/models/betaSections/betaSection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAWtD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAIF,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,WAAW,GACtC,IAAI,CAEN;AAED,8BAAsB,WAAW;IAC7B,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,IAAI,CAAC;IACzB,mEAAmE;IACnE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAElB,SAAS,aACL,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,IAAI,EACxB,EAAE,GAAE,MAAM,GAAG,IAAW;IAS5B;;;OAGG;IACH,SAAS,CACL,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,iBAAiB,EACpC,cAAc,EAAE,MAAM,GACvB,kBAAkB;IA6BrB;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;IAmDvD,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,WAAW;IA0B1E,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAS9E,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAS9E,SAAS,CAAC,MAAM,CAAC,uBAAuB,CACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,GACZ,IAAI;IAeP,SAAS,CAAC,MAAM,CAAC,qBAAqB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,SAAS,GAC7B,IAAI;IAcP,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAgB3C,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,SAAS,GAC7B,gBAAgB,EAAE;IAYrB,SAAS,CAAC,MAAM,CAAC,oBAAoB,CACjC,MAAM,EAAE,gBAAgB,EAAE,EAC1B,SAAS,EAAE,OAAO,GACnB,IAAI;CAeV"}
+{"version":3,"file":"betaSection.d.ts","sourceRoot":"","sources":["../../../src/models/betaSections/betaSection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAWtD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAIF,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,WAAW,GACtC,IAAI,CAEN;AAED,8BAAsB,WAAW;IAC7B,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,IAAI,CAAC;IACzB,mEAAmE;IACnE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAElB,SAAS,aACL,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,IAAI,EACxB,EAAE,GAAE,MAAM,GAAG,IAAW;IAS5B;;;OAGG;IACH,SAAS,CACL,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,iBAAiB,EACpC,cAAc,CAAC,EAAE,MAAM,GACxB,kBAAkB;IA6BrB;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;IAmDvD,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,WAAW;IA0B1E,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAS9E,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAS9E,SAAS,CAAC,MAAM,CAAC,uBAAuB,CACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,GACZ,IAAI;IAeP,SAAS,CAAC,MAAM,CAAC,qBAAqB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,SAAS,GAC7B,IAAI;IAcP,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAgB3C,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,SAAS,GAC7B,gBAAgB,EAAE;IAYrB,SAAS,CAAC,MAAM,CAAC,oBAAoB,CACjC,MAAM,EAAE,gBAAgB,EAAE,EAC1B,SAAS,EAAE,OAAO,GACnB,IAAI;CAeV"}

package/dist/models/betaSections/betaSectionExcerpt.d.ts

@@ -6,11 +6,11 @@ export declare class BetaSectionExcerpt {
     readonly relevanceStrength: RelevanceStrength;
     /**
      * Verbatim substring of the text block’s title and/or body that connects
-     * this excerpt to the map feature. Required even for title-only relevance
-     * (when `text` is omitted).
+     * this excerpt to the map feature. When omitted, excerpt HTML is not
+     * phrase-highlighted.
      */
-    readonly relevantPhrase: string;
-    constructor(text: string | undefined, start: number | undefined, end: number | undefined, relevanceStrength: RelevanceStrength, relevantPhrase: string);
+    readonly relevantPhrase?: string;
+    constructor(text: string | undefined, start: number | undefined, end: number | undefined, relevanceStrength: RelevanceStrength, relevantPhrase?: string);
     toPlain(): Record<string, unknown>;
     /** Returns displayable excerpt HTML when the owning beta section is unavailable. */
     toHtml(): string;

package/dist/models/betaSections/betaSectionExcerpt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"betaSectionExcerpt.d.ts","sourceRoot":"","sources":["../../../src/models/betaSections/betaSectionExcerpt.ts"],"names":[],"mappings":"AAEA,OAAO,EAEH,KAAK,iBAAiB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,kBAAkB;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAG5B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,iBAAiB,EAAE,iBAAiB,EACpC,cAAc,EAAE,MAAM;IAc1B,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiBlC,oFAAoF;IACpF,MAAM,IAAI,MAAM;IAOhB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB;IA6CtD,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAOnC,OAAO,CAAC,MAAM,CAAC,wBAAwB;CAK1C"}
+{"version":3,"file":"betaSectionExcerpt.d.ts","sourceRoot":"","sources":["../../../src/models/betaSections/betaSectionExcerpt.ts"],"names":[],"mappings":"AAEA,OAAO,EAEH,KAAK,iBAAiB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,kBAAkB;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;gBAG7B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,iBAAiB,EAAE,iBAAiB,EACpC,cAAc,CAAC,EAAE,MAAM;IAgB3B,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAmBlC,oFAAoF;IACpF,MAAM,IAAI,MAAM;IAKhB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB;IAiDtD,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAOnC,OAAO,CAAC,MAAM,CAAC,wBAAwB;CAK1C"}

package/dist/models/betaSections/betaSectionExcerpt.js

@@ -7,7 +7,9 @@ const relevanceStrength_1 = require("../relevanceStrength");
 class BetaSectionExcerpt {
     constructor(text, start, end, relevanceStrength, relevantPhrase) {
         (0, relevanceStrength_1.assertRelevanceStrength)(relevanceStrength, 'BetaSectionExcerpt.relevanceStrength');
-        BetaSectionExcerpt.assertNonEmptyString(relevantPhrase, 'BetaSectionExcerpt.relevantPhrase');
+        if (relevantPhrase !== undefined) {
+            BetaSectionExcerpt.assertNonEmptyString(relevantPhrase, 'BetaSectionExcerpt.relevantPhrase');
+        }
         this.text = text;
         this.start = start;
         this.end = end;
@@ -17,7 +19,6 @@ class BetaSectionExcerpt {
     toPlain() {
         const out = {
             relevanceStrength: this.relevanceStrength,
-            relevantPhrase: this.relevantPhrase,
         };
         if (this.text !== undefined) {
             out.text = this.text;
@@ -28,11 +29,15 @@ class BetaSectionExcerpt {
         if (this.end !== undefined) {
             out.end = this.end;
         }
+        if (this.relevantPhrase !== undefined) {
+            out.relevantPhrase = this.relevantPhrase;
+        }
         return out;
     }
     /** Returns displayable excerpt HTML when the owning beta section is unavailable. */
     toHtml() {
-        return (0, boldRelevantPhrase_1.boldRelevantPhraseInHtml)((0, normalizeExcerptHtml_1.normalizeExcerptListHtml)(this.text ?? ''), this.relevantPhrase);
+        const normalized = (0, normalizeExcerptHtml_1.normalizeExcerptListHtml)(this.text ?? '');
+        return (0, boldRelevantPhrase_1.boldRelevantPhraseInHtml)(normalized, this.relevantPhrase);
     }
     static fromResult(result) {
         if (result == null || typeof result !== 'object' || Array.isArray(result)) {
@@ -40,7 +45,10 @@ class BetaSectionExcerpt {
         }
         const r = result;
         const relevanceStrength = (0, relevanceStrength_1.assertRelevanceStrength)(r.relevanceStrength, 'BetaSectionExcerpt.relevanceStrength');
-        const relevantPhrase = BetaSectionExcerpt.assertNonEmptyString(r.relevantPhrase, 'BetaSectionExcerpt.relevantPhrase');
+        let relevantPhrase;
+        if (r.relevantPhrase !== undefined && r.relevantPhrase !== null) {
+            relevantPhrase = BetaSectionExcerpt.assertNonEmptyString(r.relevantPhrase, 'BetaSectionExcerpt.relevantPhrase');
+        }
         let text;
         if (r.text !== undefined) {
             if (typeof r.text !== 'string') {

package/dist/models/betaSections/boldRelevantPhrase.d.ts

@@ -2,7 +2,8 @@
  * Wraps the first contiguous text-run occurrence of `phrase` in `<b>…</b>`
  * without splitting HTML tags. If the phrase already sits fully inside a
  * `<b>`/`<strong>` element, or spans multiple text runs (tags in between),
- * returns `html` unchanged.
+ * returns `html` unchanged. When `phrase` is undefined/null/empty, returns
+ * `html` unchanged (no highlighting).
  */
-export declare function boldRelevantPhraseInHtml(html: string, phrase: string): string;
+export declare function boldRelevantPhraseInHtml(html: string, phrase: string | undefined | null): string;
 //# sourceMappingURL=boldRelevantPhrase.d.ts.map

package/dist/models/betaSections/boldRelevantPhrase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boldRelevantPhrase.d.ts","sourceRoot":"","sources":["../../../src/models/betaSections/boldRelevantPhrase.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAuB7E"}
+{"version":3,"file":"boldRelevantPhrase.d.ts","sourceRoot":"","sources":["../../../src/models/betaSections/boldRelevantPhrase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAClC,MAAM,CAuBR"}

package/dist/models/betaSections/boldRelevantPhrase.js

@@ -5,10 +5,11 @@ exports.boldRelevantPhraseInHtml = boldRelevantPhraseInHtml;
  * Wraps the first contiguous text-run occurrence of `phrase` in `<b>…</b>`
  * without splitting HTML tags. If the phrase already sits fully inside a
  * `<b>`/`<strong>` element, or spans multiple text runs (tags in between),
- * returns `html` unchanged.
+ * returns `html` unchanged. When `phrase` is undefined/null/empty, returns
+ * `html` unchanged (no highlighting).
  */
 function boldRelevantPhraseInHtml(html, phrase) {
-    if (html.length === 0 || phrase.length === 0)
+    if (html.length === 0 || phrase == null || phrase.length === 0)
         return html;
     const tokens = tokenizeHtml(html);
     for (let i = 0; i < tokens.length; i++) {

package/dist/models/minimap/legend/concrete/imageContext.d.ts

@@ -2,9 +2,12 @@ import { type RelevanceStrength } from '../../../relevanceStrength';
 export declare class ImageContext {
     readonly id: string;
     readonly relevanceStrength: RelevanceStrength;
-    /** Verbatim substring of the image caption and/or file URL. */
-    readonly relevantPhrase: string;
-    constructor(id: string, relevanceStrength: RelevanceStrength, relevantPhrase: string);
+    /**
+     * Verbatim substring of the image caption. When omitted, caption
+     * highlighting is skipped.
+     */
+    readonly relevantPhrase?: string;
+    constructor(id: string, relevanceStrength: RelevanceStrength, relevantPhrase?: string);
     toPlain(): Record<string, unknown>;
     static fromResult(result: unknown): ImageContext;
     private static assertNonEmptyString;

package/dist/models/minimap/legend/concrete/imageContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageContext.d.ts","sourceRoot":"","sources":["../../../../../src/models/minimap/legend/concrete/imageContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,iBAAiB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,qBAAa,YAAY;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM;IASpF,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQlC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY;IAiBhD,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAMtC"}
+{"version":3,"file":"imageContext.d.ts","sourceRoot":"","sources":["../../../../../src/models/minimap/legend/concrete/imageContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,iBAAiB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,qBAAa,YAAY;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;gBAErB,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,CAAC,EAAE,MAAM;IAWrF,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWlC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY;IAoBhD,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAMtC"}

package/dist/models/minimap/legend/concrete/imageContext.js

@@ -6,17 +6,22 @@ class ImageContext {
     constructor(id, relevanceStrength, relevantPhrase) {
         ImageContext.assertNonEmptyString(id, 'ImageContext.id');
         (0, relevanceStrength_1.assertRelevanceStrength)(relevanceStrength, 'ImageContext.relevanceStrength');
-        ImageContext.assertNonEmptyString(relevantPhrase, 'ImageContext.relevantPhrase');
+        if (relevantPhrase !== undefined) {
+            ImageContext.assertNonEmptyString(relevantPhrase, 'ImageContext.relevantPhrase');
+        }
         this.id = id;
         this.relevanceStrength = relevanceStrength;
         this.relevantPhrase = relevantPhrase;
     }
     toPlain() {
-        return {
+        const out = {
             id: this.id,
             relevanceStrength: this.relevanceStrength,
-            relevantPhrase: this.relevantPhrase,
         };
+        if (this.relevantPhrase !== undefined) {
+            out.relevantPhrase = this.relevantPhrase;
+        }
+        return out;
     }
     static fromResult(result) {
         if (result == null || typeof result !== 'object' || Array.isArray(result)) {
@@ -25,7 +30,10 @@ class ImageContext {
         const r = result;
         const id = ImageContext.assertNonEmptyString(r.id, 'ImageContext.id');
         const relevanceStrength = (0, relevanceStrength_1.assertRelevanceStrength)(r.relevanceStrength, 'ImageContext.relevanceStrength');
-        const relevantPhrase = ImageContext.assertNonEmptyString(r.relevantPhrase, 'ImageContext.relevantPhrase');
+        let relevantPhrase;
+        if (r.relevantPhrase !== undefined && r.relevantPhrase !== null) {
+            relevantPhrase = ImageContext.assertNonEmptyString(r.relevantPhrase, 'ImageContext.relevantPhrase');
+        }
         return new ImageContext(id, relevanceStrength, relevantPhrase);
     }
     static assertNonEmptyString(value, context) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ropegeo-common",
-    "version": "1.25.0",
+    "version": "1.25.1",
     "description": "Shared domain models and helpers for RopeGeo and WebScraper",
     "license": "ISC",
     "repository": {