@heroiclands/package-build 25.4.0 → 25.5.0

package/engine/verse-regions.mjs

@@ -22,6 +22,7 @@ import { parseExtensionAttributes } from "./extension-attributes.mjs";
  * @property {number} end - Closing line, zero based and inclusive.
  * @property {number} from - First offset of the complete region.
  * @property {number} to - Offset past the complete region.
+ * @property {number[]} contentStarts - Original-source content offsets for each region line, after container prefixes.
  * @property {number} bodyStart - First body offset.
  * @property {number} bodyEnd - Offset past body text, excluding its final newline.
  * @property {string} body - Authored body bytes.
@@ -81,6 +82,13 @@ export function verseDivPlugin(md) {
             for (const match of original.matchAll(/\r\n|\r|\n/g))
                 starts.push(match.index + match[0].length);
             const from = starts[first] ?? original.length;
+            const contentStarts = [];
+            for (let number = first; number < (closed ? close + 1 : past); number++) {
+                const normalizedStart = state.src.lastIndexOf("\n", state.bMarks[number] - 1) + 1;
+                contentStarts.push(
+                    starts[number] + state.bMarks[number] + state.tShift[number] - normalizedStart,
+                );
+            }
             const bodyStart = starts[first + 1] ?? original.length;
             let bodyEnd = starts[close] ?? original.length;
             if (bodyEnd > bodyStart) {
@@ -91,6 +99,7 @@ export function verseDivPlugin(md) {
                 start: first,
                 end: closed ? close : past - 1,
                 from,
+                contentStarts,
                 to: starts[closed ? close + 1 : past] ?? original.length,
                 bodyStart,
                 bodyEnd,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@heroiclands/package-build",
-    "version": "25.4.0",
+    "version": "25.5.0",
     "description": "Shared toolchain for building and shipping a HeroicLands Foundry VTT package \u2014 content compilation, manifest, localization, staging, bundle, release and deployment.",
     "license": "GPL-3.0-or-later",
     "type": "module",

package/types/engine/content-scroll.d.mts

@@ -2,7 +2,7 @@
  * Read every `scroll` fence in a source, and every fault in its opening.
  *
  * A fence inside a block quote or an HTML block is not read, and neither is a
- * fence quoted inside another fence.
+ * fence quoted inside another fence. Verse lines are inline content.
  *
  * @param {string} source - Markdown.
  * @returns {{blocks: Scroll[], errors: Array<{line: number, column: number, message: string}>}}

package/types/engine/content-verse.d.mts

@@ -46,7 +46,7 @@ export function parseVerse(body: string, { inline, footnotes }?: {
 }): VerseModel;
 /**
  * Validate a quoted verse span using its original source coordinates.
- * @param {{start: number, text: string, attrs: Array<[string,string]>}} span - Authored span.
+ * @param {{start: number, text: string, attrs: Array<[string,string]>, verseModel?: VerseModel}} span - Authored span.
  * @param {string} source - Complete Markdown source.
  * @returns {VerseDiagnostic[]} Located inline-only findings.
  */
@@ -54,6 +54,7 @@ export function inlineVerseFindings(span: {
     start: number;
     text: string;
     attrs: Array<[string, string]>;
+    verseModel?: VerseModel;
 }, source: string): VerseDiagnostic[];
 /** Logical line text for consumers that do not need source locations. */
 export function verseLines(body: any): string[];
@@ -214,6 +215,10 @@ export type VerseBlock = {
      * - Opening div's zero-based source line.
      */
     start: number;
+    /**
+     * - Opening delimiter's one-based source column, when known.
+     */
+    column?: number | undefined;
     /**
      * - Closing div's zero-based source line.
      */
@@ -273,7 +278,7 @@ export type VerseBlock = {
 };
 export type VerseDiagnostic = {
     line: number;
-    column: number;
+    column?: number;
     message: string;
 };
 /**

package/types/engine/roman-run.d.mts

@@ -36,9 +36,10 @@
  * @param {(span: RomanSpan) => string} [options.opaqueSpan] - Placeholder for an independent child. The default empty name keeps sentence state without introducing that child's letters.
  * @param {ReadonlyArray<readonly [number, number]>} [options.exclude] - Absolute source ranges that carry layout or presentation syntax.
  * @param {boolean} [options.markNames] - Whether name children contribute braces.
+ * @param {boolean} [options.preserveSlashEscape] - Keep a literal verse slash distinct from a line control.
  * @returns {{text: string, offsets: number[], spans: ProjectedSpan[]}} Logical text and source locations, with child ranges for presentation.
  */
-export function plainRomanRun(source: string, { from, to, spans, includeSpan, opaqueSpan, exclude, markNames, }?: {
+export function plainRomanRun(source: string, { from, to, spans, includeSpan, opaqueSpan, exclude, markNames, preserveSlashEscape, }?: {
     from?: number | undefined;
     to?: number | undefined;
     spans?: readonly RomanSpan[] | undefined;
@@ -46,6 +47,7 @@ export function plainRomanRun(source: string, { from, to, spans, includeSpan, op
     opaqueSpan?: ((span: RomanSpan) => string) | undefined;
     exclude?: readonly (readonly [number, number])[] | undefined;
     markNames?: boolean | undefined;
+    preserveSlashEscape?: boolean | undefined;
 }): {
     text: string;
     offsets: number[];

package/types/engine/verse-format.d.mts

@@ -1,7 +1,8 @@
 /**
- * Replace verse markup with opaque placeholders and restore its original bytes.
+ * Replace verse markup with opaque placeholders, retaining container prefixes
+ * and inline display widths. Restoration follows the formatter's line endings.
  * @param {string} source - Complete Markdown source.
- * @returns {{markdown: string, restore: (formatted: string) => string}} Protected source and exact restoration.
+ * @returns {{markdown: string, restore: (formatted: string) => string}} Protected source and restoration.
  */
 export function protectVerseSource(source: string): {
     markdown: string;

package/types/engine/verse-regions.d.mts

@@ -35,6 +35,10 @@ export type VerseRegion = {
      * - Offset past the complete region.
      */
     to: number;
+    /**
+     * - Original-source content offsets for each region line, after container prefixes.
+     */
+    contentStarts: number[];
     /**
      * - First body offset.
      */