punctilio 4.3.0 → 4.3.1

package/src/index.ts

@@ -34,6 +34,7 @@ export {
   replaceAllInView,
   type ReplaceAllOptions,
   runLegacyPass,
+  withProseView,
 } from "./prose-view.js"
 export { classifyApostrophes, niceQuotes, PUNCTUATION_STYLES, type PunctuationStyle, type QuoteOptions } from "./quotes.js"
 

package/src/prose-view.ts

@@ -247,6 +247,16 @@ function matchContainsBoundary(match: RegExpExecArray, view: ProseView): boolean
   return false
 }
 
+/** Count of node boundaries that fall at exactly `offset` (empty nodes stack). */
+export function boundaryCountAt(view: ProseView, offset: number): number {
+  let count = 0
+  for (const boundary of view.boundaries) {
+    if (boundary === offset) count++
+    else if (boundary > offset) break
+  }
+  return count
+}
+
 export function replaceAllInView(
   view: ProseView,
   regex: RegExp,
@@ -281,6 +291,26 @@ export function replaceAllInView(
   }
 }
 
+/**
+ * Splits sentinel-marked text on the separator, builds a ProseView over the
+ * fragments, runs `run` against the clean-text view, commits the queued edits,
+ * and rejoins the fragments with the separator. The separator count is
+ * preserved exactly: each fragment maps to one source node, and `commit()`
+ * never creates or destroys node boundaries.
+ */
+export function withProseView(
+  markedText: string,
+  separator: string,
+  run: (view: ProseView) => void,
+): string {
+  const fragments = separator.length > 0 ? markedText.split(separator) : [markedText]
+  const nodes: ProseNode[] = fragments.map((value) => ({ value }))
+  const view = buildProseView(nodes)
+  run(view)
+  view.commit()
+  return nodes.map((node) => node.value).join(separator)
+}
+
 export function runLegacyPass(
   view: ProseView,
   passFn: (markedText: string) => string,

package/src/quote-classifier.ts

@@ -1,5 +1,5 @@
 import { LATIN_LETTERS, TERMINAL_PUNCTUATION, UNICODE_SYMBOLS } from "./constants.js"
-import { buildProseView, type ProseNode, type ProseView } from "./prose-view.js"
+import { type ProseView, withProseView } from "./prose-view.js"
 
 const {
   EM_DASH,
@@ -860,15 +860,6 @@ function queueRenderEdits(view: ProseView, items: Item[], table: Record<QuoteRol
 // Public engine entry points
 // ---------------------------------------------------------------------------
 
-function withProseView(markedText: string, separator: string, run: (view: ProseView) => void): string {
-  const fragments = separator.length > 0 ? markedText.split(separator) : [markedText]
-  const nodes: ProseNode[] = fragments.map((value) => ({ value }))
-  const view = buildProseView(nodes)
-  run(view)
-  view.commit()
-  return nodes.map((node) => node.value).join(separator)
-}
-
 /**
  * The quote/apostrophe role classifier: one boundary-aware scan over the
  * clean text replaces the v4 ordered regex pipeline.