punctilio 0.3.0 → 0.4.14

package/README.md

@@ -1,246 +1,99 @@
-# punctilio
-
-> *punctilio* (n.): a fine point of conduct or procedure
-
-Smart typography transformations for JavaScript/TypeScript. Converts ASCII punctuation to typographically correct Unicode characters. Originally built for [my personal website](https://turntrout.com/design).
-
-## Features
-
-| **Feature** | **Before** | **After** |
-|---------|--------|-------|
-| Smart quotes | "straight" | “curly” |
-| | 'apostrophes' | ‘apostrophes’ |
-| Em dashes | wait - why did you | wait—why did you |
-| En dashes | 1-5 | 1–5 |
-| | January-March | January–March |
-| Minus signs | -5 | −5 (proper Unicode minus) |
-| Ellipsis | ... | … |
-| Multiplication | 5x5 | 5×5 |
-| | 3*4 | 3×4 |
-| Math symbols | != | ≠ |
-| | +- | ± |
-| | <= | ≤ |
-| | >= | ≥ |
-| | ~= | ≈ |
-| Legal symbols | (c) | © |
-| | (r) | ® |
-| | (tm) | ™ |
-| Arrows | -> | → |
-| | <- | ← |
-| | <-> | ↔ |
-| Prime marks | 5'10" | 5′10″ |
-| Fractions (optional) | 1/2 | ½ |
-| | 3/4 | ¾ |
-| Degrees (optional) | 20 C | 20 °C |
-
-**Handles edge cases**: contractions, possessives, nested quotes, year abbreviations ('99), "rock 'n' roll"
-
-## Why another typography library?
-
-Existing solutions like [SmartyPants](https://daringfireball.net/projects/smartypants/) struggle with:
-
-- **Apostrophe ambiguity**: Is `'Twas` an opening quote or apostrophe? (It's an apostrophe)
-- **Cross-element text**: When quotes span `<em>"Hello</em> world"`, most libraries fail
-- **Context sensitivity**: `'99` (year) vs `'hello'` (quoted) vs `don't` (contraction)
-
-`punctilio` handles these through thorough regex patterns and an optional separator character for processing text that spans HTML elements.
-
-## Installation
+> *punctilio* (n.): precise observance of formalities.
 
-```bash
-npm install punctilio
-# or
-pnpm add punctilio
-```
-
-## Usage
-
-### Basic
-
-```typescript
-import { transform, niceQuotes, hyphenReplace } from 'punctilio'
-
-// Apply all transformations
-transform('"Hello," she said - "it\'s pages 1-5."')
-// → "Hello," she said—"it's pages 1–5."
-
-// Symbol transforms are included by default
-transform('Wait... 5x5 != 25 (c) 2024')
-// → Wait… 5×5 ≠ 25 © 2024
-
-// Or use individual functions
-niceQuotes('"Hello", she said.')
-// → "Hello", she said.
-
-hyphenReplace('word - word')
-// → word—word
-```
-
-### Transform Options
+The best typography package for English.
 
 ```typescript
 import { transform } from 'punctilio'
 
-// Enable optional transforms
-transform('Add 1/2 cup at 20 C', {
-  fractions: true,  // 1/2 → ½
-  degrees: true     // 20 C → 20 °C
-})
-// → Add ½ cup at 20 °C
-
-// Disable symbol transforms if you only want quotes/dashes
-transform('5x5 = 25', { symbols: false })
-// → 5x5 = 25 (unchanged)
-
-// Punctuation style: american (default), british, or none
-transform('"Hello".', { punctuationStyle: 'american' }) // → "Hello."
-transform('"Hello."', { punctuationStyle: 'british' })  // → "Hello".
-
-// Dash style: american (default), british, or none
-transform('word - word', { dashStyle: 'american' }) // → word—word
-transform('word - word', { dashStyle: 'british' })  // → word – word
+transform('"It\'s a beautiful thing, the destruction of words..." -- 1984')
+// → “It’s a beautiful thing, the destruction of words…” — 1984
 ```
 
-### With HTML Element Boundaries
-
-When processing text that spans multiple HTML elements, use a separator character to mark boundaries:
-
-```typescript
-import { transform, DEFAULT_SEPARATOR } from 'punctilio'
-
-// Your HTML: <p>"Hello <em>world</em>"</p>
-// Extract text with separator between elements:
-const text = `"Hello ${DEFAULT_SEPARATOR}world${DEFAULT_SEPARATOR}"`
-
-const result = transform(text, { separator: DEFAULT_SEPARATOR })
-// → "Hello \uE000world\uE000"
-// The separator is preserved; split on it to restore to your elements
+[![Test](https://github.com/alexander-turner/punctilio/actions/workflows/test.yml/badge.svg)](https://github.com/alexander-turner/punctilio/actions/workflows/test.yml)
+[![Lint](https://github.com/alexander-turner/punctilio/actions/workflows/lint.yml/badge.svg)](https://github.com/alexander-turner/punctilio/actions/workflows/lint.yml)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)](https://github.com/alexander-turner/punctilio)
+ 
+```bash
+npm install punctilio
 ```
 
-For a complete implementation showing how to use this with a HAST (HTML AST) tree, see the [`transformElement` function in TurnTrout.com](https://github.com/alexander-turner/TurnTrout.com/blob/main/quartz/plugins/transformers/formatting_improvement_html.ts).
-
-## API
-
-### `transform(text, options?)`
-
-Applies all typography transformations. Options:
-- `separator`: Boundary marker for HTML elements (default: `"\uE000"`)
-- `symbols`: Include symbol transforms (default: `true`)
-- `fractions`: Convert common fractions like 1/2 → ½ (default: `false`)
-- `degrees`: Convert temperature notation like 20 C → 20 °C (default: `false`)
-- `punctuationStyle`: `"american"` (default) puts periods/commas inside quotes; `"british"` puts them outside; `"none"` leaves unchanged
-- `dashStyle`: `"american"` (default) uses unspaced em dash (—); `"british"` uses spaced en dash ( – ); `"none"` skips dash conversion
+## Why punctilio?
 
-### Quote Functions
+As far as I can tell, `punctilio` is the most reliable and feature-complete. I built `punctilio` for [my website](https://turntrout.com/design). I wrote[^wrote] and sharpened the core regexes sporadically over several months, exhaustively testing edge cases. Eventually, I decided to spin off the functionality into its own package.
 
-#### `niceQuotes(text, options?)`
+[^wrote]: While Claude is the number one contributor to this repository, that’s just because Claude has helped me port my existing code and add minor features. The core regular expressions (e.g. dashes, quotes, multiplication signs) are human-written.
 
-Converts straight quotes to curly quotes. Options: `separator`, `punctuationStyle`.
+I tested `punctilio` 0.4 against [`smartypants`](https://www.npmjs.com/package/smartypants) 0.2.2, [`tipograph`](https://www.npmjs.com/package/tipograph) 0.7.4, and [`smartquotes`](https://www.npmjs.com/package/smartquotes) 2.3.2.[^python] These other packages have spotty feature coverage and inconsistent impact on text. For example, `smartypants` ignores leading apostrophes:
 
-Handles: opening/closing quotes, contractions (`don't`), possessives (`dog's`), year abbreviations (`'99`), special cases (`'n'`).
+[^python]: The Python libraries I found were closely related to the JavaScript packages, so I don’t include Python tests. 
 
-### Dash Functions
+| Input | `smartypants` | `punctilio` |
+|:-----:|:-----------------:|:-------:|
+| 'Twas the night | ‘Twas the night ✗ | ’Twas the night ✓ |
+| the '99 season | the ‘99 season ✗ | the ’99 season ✓ |
+| rock 'n' roll | rock ‘n’ roll ✗ | rock ’n’ roll ✓ |
 
-#### `hyphenReplace(text, options?)`
+By running [`benchmark.mjs`](./benchmark.mjs), I basically graded all libraries on a subset of [my unit tests](./src/tests/), selected to represent a wide range of features.
 
-Converts hyphens to proper dashes. Options: `separator`, `dashStyle`.
+| Package | Score |
+|--------:|:------|
+| `punctilio` | 79/82 (96%) |
+| `tipograph` | 48/82 (59%) |
+| `smartquotes` | 30/82 (37%) |
+| `smartypants` | 28/82 (35%) |
 
-Handles: em dashes (`word - word` → `word—word`), en dashes for ranges (`1-5` → `1–5`, `Jan-Mar` → `Jan–Mar`), minus signs (`-5` → `−5`). Preserves horizontal rules and compound words.
+| Feature | Example | `smartypants` | `tipograph` | `smartquotes` | `punctilio` |
+|--------:|:-------:|:-------:|:-------:|:-------:|:-------:|
+| Smart quotes | "hello" → “hello” | ✓ | ✓ | ✓ | ✓ |
+| Leading apostrophe | 'Twas → ’Twas | ✗ | ✗ | ✓ | ✓ |
+| Em dash | -- → — | ✓ | ✗ | ✗ | ✓ |
+| En dash (ranges) | 1-5 → 1–5 | ✗ | ✓ | ✗ | ✓ |
+| Minus sign | -5 → −5 | ✗ | ✓ | ✗ | ✓ |
+| Ellipsis | ... → … | ✓ | ✓ | ✗ | ✓ |
+| Multiplication | 5x5 → 5×5 | ✗ | ✗ | ✗ | ✓ |
+| Math symbols | != → ≠ | ✗ | ✓ | ✗ | ✓ |
+| Legal symbols | (c) → © | ✗ | © only | ✗ | ✓ |
+| Arrows | -> → → | ✗ | ✓ | ✗ | ✓ |
+| Prime marks | 5'10" → 5′10″ | ✗ | ✓ | ✓ | ✓ |
+| Degrees | 20 C → 20 °C | ✗ | ✗ | ✗ | ✓ |
+| Fractions | 1/2 → ½ | ✗ | ✗ | ✗ | ✓ |
+| Superscripts | 1st → 1ˢᵗ | ✗ | ✗ | ✗ | ✓ |
+| Localization | American/British | ✗ | ✗ | ✗ | ✓ |
+| Ligatures | ?? → ⁇ | ✗ | ✓ | ✗ | ✓ |
+| Non-English quotes | „Hallo" (German) | ✗ | ✓ | ✗ | ✗ |
 
-#### `enDashNumberRange(text, options?)`
+As far as I can tell, `punctilio`’s only missing feature is non-English quote support. I don’t have a personal reason to use non-English localization, but feel free to make a pull request!
 
-Converts number ranges only: `pages 10-20` → `pages 10–20`
+## Works with HTML DOMs via separation boundaries
 
-#### `enDashDateRange(text, options?)`
+Other typography libraries either transform plain strings or operate on AST nodes individually (`retext-smartypants` [can't map changes back to HTML](https://github.com/rehypejs/rehype-retext)). But real HTML has text spanning multiple elements—if you concatenate text from `<em>Wait</em>...`, transform it, then try to split it back, you've lost track of where `</em>` belonged. 
 
-Converts month ranges only: `January-March` → `January–March`
+`punctilio` introduces _separation boundaries_. First, insert a “separator” character (default: `U+E000`) at each element boundary before transforming (like at the start and end of an `<em>`). Every regex allows this character mid-pattern without breaking matches. For example, `.[SEP]..` still becomes `…[SEP]`. `punctilio` validates the output by ensuring the separator count remains the same. 
 
-#### `minusReplace(text, options?)`
-
-Converts hyphens to minus signs in numerical contexts: `-5` → `−5`
-
-### Symbol Functions
-
-#### `ellipsis(text, options?)`
-
-Converts three periods to ellipsis: `...` → `…`
-
-#### `multiplication(text, options?)`
-
-Converts multiplication patterns: `5x5` → `5×5`, `3*4` → `3×4`
-
-#### `mathSymbols(text)`
-
-Converts math operators:
-- `!=` → `≠`
-- `+-` or `+/-` → `±`
-- `<=` → `≤`
-- `>=` → `≥`
-- `~=` or `=~` → `≈`
-
-#### `legalSymbols(text)`
-
-Converts legal symbols:
-- `(c)` → `©`
-- `(r)` → `®`
-- `(tm)` → `™`
-
-#### `arrows(text, options?)`
-
-Converts arrow patterns:
-- `->` or `-->` → `→`
-- `<-` or `<--` → `←`
-- `<->` or `<-->` → `↔`
-
-#### `primeMarks(text, options?)`
-
-Converts straight quotes after numbers to prime marks:
-- `5'10"` → `5′10″` (feet and inches)
-- `45° 30' 15"` → `45° 30′ 15″` (coordinates)
-
-#### `fractions(text)`
-
-Converts common fractions: `1/2` → `½`, `1/4` → `¼`, `3/4` → `¾`, etc.
-
-#### `degrees(text)`
-
-Converts temperature notation: `20 C` → `20 °C`, `68 F` → `68 °F`
-
-#### `symbolTransform(text, options?)`
-
-Applies all symbol transforms except fractions and degrees.
-
-### Constants
+```typescript
+import { transform, DEFAULT_SEPARATOR } from 'punctilio'
 
-- `DEFAULT_SEPARATOR`: The default separator character (`"\uE000"`)
-- `months`: Regex-ready string of month names for date range detection
+transform(`"Wait${DEFAULT_SEPARATOR}"`)
+// → `“Wait”${DEFAULT_SEPARATOR}`
+// The separator doesn't block the information that this should be an end-quote!
+```
 
-## Character Reference
+Your DOM walker tracks which text node each segment came from, inserts separators between them, transforms the combined string, then splits on separators to update each node. Use the `separator` option if `U+E000` conflicts with your content. For an example of how to integrate this functionality, see [my website’s code](https://github.com/alexander-turner/TurnTrout.com/blob/main/quartz/plugins/transformers/formatting_improvement_html.ts). 
 
-| Input | Output | Unicode | Name |
-|-------|--------|---------|------|
-| `"` | `"` | U+201C | Left double quotation mark |
-| `"` | `"` | U+201D | Right double quotation mark |
-| `'` | `'` | U+2018 | Left single quotation mark |
-| `'` | `'` | U+2019 | Right single quotation mark (apostrophe) |
-| `--` | `—` | U+2014 | Em dash |
-| `-` (range) | `–` | U+2013 | En dash |
-| `-` (negative) | `−` | U+2212 | Minus sign |
-| `...` | `…` | U+2026 | Ellipsis |
-| `x` (multiply) | `×` | U+00D7 | Multiplication sign |
-| `!=` | `≠` | U+2260 | Not equal |
-| `+-` | `±` | U+00B1 | Plus-minus |
-| `<=` | `≤` | U+2264 | Less than or equal |
-| `>=` | `≥` | U+2265 | Greater than or equal |
-| `(c)` | `©` | U+00A9 | Copyright |
-| `(r)` | `®` | U+00AE | Registered |
-| `(tm)` | `™` | U+2122 | Trademark |
-| `->` | `→` | U+2192 | Right arrow |
-| `<-` | `←` | U+2190 | Left arrow |
-| `<->` | `↔` | U+2194 | Left-right arrow |
-| `'` (after digit) | `′` | U+2032 | Prime (feet, arcminutes) |
-| `"` (after digit) | `″` | U+2033 | Double prime (inches, arcseconds) |
+## Options
 
-## License
+`punctilio` doesn’t enable all transformations by default. Fractions and degrees tend to match too aggressively (perfectly applying the degree transformation requires semantic meaning). Superscript letters and punctuation ligatures have spotty font support—this README’s font doesn’t even support the example superscript! Furthermore, `ligatures = true` can change the meaning of text by collapsing question and exclamation marks.
 
-MIT © Alexander Turner
+```typescript
+transform(text, {
+  punctuationStyle: 'american' | 'british' | 'none',  // default: 'american'
+  dashStyle: 'american' | 'british' | 'none',         // default: 'american'
+
+  symbols: true,         // math, legal, arrows
+  collapseSpaces: true,  // normalize whitespace
+  fractions: false,      // 1/2 → ½
+  degrees: false,        // 20 C → 20 °C
+  superscript: false,    // 1st → 1ˢᵗ
+  ligatures: false,      // ??? → ⁇, ?! → ⁈, !? → ⁉, !!! → !
+})
+```

package/dist/constants.d.ts

@@ -49,6 +49,15 @@ export declare const UNICODE_SYMBOLS: {
     readonly RIGHT_DOUBLE_QUOTE: "”";
     readonly LEFT_SINGLE_QUOTE: "‘";
     readonly RIGHT_SINGLE_QUOTE: "’";
+    readonly NBSP: " ";
+    readonly SUPERSCRIPT_ST: "ˢᵗ";
+    readonly SUPERSCRIPT_ND: "ⁿᵈ";
+    readonly SUPERSCRIPT_RD: "ʳᵈ";
+    readonly SUPERSCRIPT_TH: "ᵗʰ";
+    readonly DOUBLE_QUESTION: "⁇";
+    readonly QUESTION_EXCLAMATION: "⁈";
+    readonly EXCLAMATION_QUESTION: "⁉";
+    readonly DOUBLE_EXCLAMATION: "‼";
 };
 /**
  * Default separator character for text spanning HTML elements.

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuClB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAA;AACzC,eAAO,MAAM,yBAAyB,QAA2D,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDlB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAA;AACzC,eAAO,MAAM,yBAAyB,QAA2D,CAAA"}

package/dist/constants.js

@@ -49,6 +49,17 @@ export const UNICODE_SYMBOLS = {
     RIGHT_DOUBLE_QUOTE: "\u201D",
     LEFT_SINGLE_QUOTE: "\u2018",
     RIGHT_SINGLE_QUOTE: "\u2019",
+    NBSP: "\u00A0",
+    // Superscript ordinal suffixes
+    SUPERSCRIPT_ST: "\u02E2\u1D57", // ˢᵗ
+    SUPERSCRIPT_ND: "\u207F\u1D48", // ⁿᵈ
+    SUPERSCRIPT_RD: "\u02B3\u1D48", // ʳᵈ
+    SUPERSCRIPT_TH: "\u1D57\u02B0", // ᵗʰ
+    // Punctuation ligatures
+    DOUBLE_QUESTION: "\u2047", // ⁇
+    QUESTION_EXCLAMATION: "\u2048", // ⁈
+    EXCLAMATION_QUESTION: "\u2049", // ⁉
+    DOUBLE_EXCLAMATION: "\u203C", // ‼
 };
 /**
  * Default separator character for text spanning HTML elements.

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,QAAQ;IAClB,cAAc,EAAE,QAAQ;IACxB,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,QAAQ;IACpB,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,QAAQ;IACpB,SAAS,EAAE,QAAQ;IACnB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,gBAAgB,EAAE,QAAQ;IAC1B,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,QAAQ;IACvB,KAAK,EAAE,QAAQ;IACf,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,QAAQ;IACf,iBAAiB,EAAE,QAAQ;IAC3B,kBAAkB,EAAE,QAAQ;IAC5B,iBAAiB,EAAE,QAAQ;IAC3B,kBAAkB,EAAE,QAAQ;CACpB,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAA;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,QAAQ;IAClB,cAAc,EAAE,QAAQ;IACxB,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,QAAQ;IACpB,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,QAAQ;IACpB,SAAS,EAAE,QAAQ;IACnB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,gBAAgB,EAAE,QAAQ;IAC1B,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,QAAQ;IACvB,KAAK,EAAE,QAAQ;IACf,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,QAAQ;IACf,iBAAiB,EAAE,QAAQ;IAC3B,kBAAkB,EAAE,QAAQ;IAC5B,iBAAiB,EAAE,QAAQ;IAC3B,kBAAkB,EAAE,QAAQ;IAC5B,IAAI,EAAE,QAAQ;IACd,+BAA+B;IAC/B,cAAc,EAAE,cAAc,EAAE,KAAK;IACrC,cAAc,EAAE,cAAc,EAAE,KAAK;IACrC,cAAc,EAAE,cAAc,EAAE,KAAK;IACrC,cAAc,EAAE,cAAc,EAAE,KAAK;IACrC,wBAAwB;IACxB,eAAe,EAAE,QAAQ,EAAE,IAAI;IAC/B,oBAAoB,EAAE,QAAQ,EAAE,IAAI;IACpC,oBAAoB,EAAE,QAAQ,EAAE,IAAI;IACpC,kBAAkB,EAAE,QAAQ,EAAE,IAAI;CAC1B,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAA;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA"}

package/dist/dashes.d.ts

@@ -36,6 +36,13 @@ export declare const months: string;
 export declare function enDashNumberRange(text: string, options?: DashOptions): string;
 /**
  * Replaces hyphens with en-dashes in month/date ranges.
+ * Supports formats like "January-March", "Jan-Mar", "February-April 2024",
+ * and "October 2012 - December 2014".
+ *
+ * Spacing around the en-dash is controlled by dashStyle:
+ * - "american" (default): No spaces (October 2012–December 2014)
+ * - "british": Spaced (October 2012 – December 2014)
+ * - "none": Preserve original spacing
  */
 export declare function enDashDateRange(text: string, options?: DashOptions): string;
 /**

package/dist/dashes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashes.d.ts","sourceRoot":"","sources":["../src/dashes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;AAEvD,MAAM,WAAW,WAAW;IAC1B;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAID;;GAEG;AACH,eAAO,MAAM,MAAM,QAKR,CAAA;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CASjF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAM/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAI5E;AAuDD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAe7E"}
+{"version":3,"file":"dashes.d.ts","sourceRoot":"","sources":["../src/dashes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;AAEvD,MAAM,WAAW,WAAW;IAC1B;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAID;;GAEG;AACH,eAAO,MAAM,MAAM,QAKR,CAAA;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CASjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CA8B/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAI5E;AAuDD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAe7E"}

package/dist/dashes.js

@@ -20,22 +20,51 @@ export const months = [
  */
 export function enDashNumberRange(text, options = {}) {
     const chr = options.separator ?? DEFAULT_SEPARATOR;
-    return text.replace(new RegExp(`\\b(?<![a-zA-Z.])((?:p\\.?|\\$)?\\d[\\d.,]*${chr}?)-(${chr}?\\$?\\d[\\d.,]*)(?!\\.\\d)\\b`, "g"), `$1${EN_DASH}$2`);
+    return text.replace(new RegExp(`\\b(?<![a-zA-Z.])(?<startNum>(?:p\\.?|\\$)?\\d[\\d.,]*${chr}?)-(?<endNum>${chr}?\\$?\\d[\\d.,]*)(?!\\.\\d)\\b`, "g"), `$<startNum>${EN_DASH}$<endNum>`);
 }
 /**
  * Replaces hyphens with en-dashes in month/date ranges.
+ * Supports formats like "January-March", "Jan-Mar", "February-April 2024",
+ * and "October 2012 - December 2014".
+ *
+ * Spacing around the en-dash is controlled by dashStyle:
+ * - "american" (default): No spaces (October 2012–December 2014)
+ * - "british": Spaced (October 2012 – December 2014)
+ * - "none": Preserve original spacing
  */
 export function enDashDateRange(text, options = {}) {
     const chr = options.separator ?? DEFAULT_SEPARATOR;
-    return text.replace(new RegExp(`\\b(${months}${chr}?)-(${chr}?(?:${months}))\\b`, "g"), `$1${EN_DASH}$2`);
+    const dashStyle = options.dashStyle ?? "american";
+    const startPattern = `(?<startMonth>${months})(?<startYear>${chr}? \\d{4})?(?<preSep>${chr}?)`;
+    const endPattern = `(?<postSep>${chr}?)(?<endMonth>${months})(?<endYear> \\d{4})?`;
+    const dateRangeRegex = new RegExp(`\\b${startPattern}(?<preSpace> ?)-(?<postSpace> ?)${endPattern}\\b`, "g");
+    return text.replace(dateRangeRegex, (...args) => {
+        const groups = args.at(-1);
+        const { startMonth, startYear = "", preSep, postSep, endMonth, endYear = "", preSpace, postSpace } = groups;
+        let pre, post;
+        if (dashStyle === "british") {
+            pre = " ";
+            post = " ";
+        }
+        else if (dashStyle === "none") {
+            pre = preSpace;
+            post = postSpace;
+        }
+        else {
+            // american (default)
+            pre = "";
+            post = "";
+        }
+        return `${startMonth}${startYear}${preSep}${pre}${EN_DASH}${post}${postSep}${endMonth}${endYear}`;
+    });
 }
 /**
  * Replaces hyphens with proper minus signs (−) in numerical contexts.
  */
 export function minusReplace(text, options = {}) {
     const chr = options.separator ?? DEFAULT_SEPARATOR;
-    const minusRegex = new RegExp(`(^|[\\s\\(${chr}""])-(\\s?\\d*\\.?\\d+)`, "gm");
-    return text.replaceAll(minusRegex, `$1${MINUS}$2`);
+    const minusRegex = new RegExp(`(?<beforeMinus>^|[\\s\\(${chr}""])-(?<number>\\s?\\d*\\.?\\d+)`, "gm");
+    return text.replaceAll(minusRegex, `$<beforeMinus>${MINUS}$<number>`);
 }
 /** Convert surrounded dashes and multiple dashes to em/en dashes */
 function convertParentheticalDashes(text, sep, style) {
@@ -44,8 +73,8 @@ function convertParentheticalDashes(text, sep, style) {
     const dash = style === "british" ? EN_DASH : EM_DASH;
     const spaced = style === "british";
     // Handle dashes with potential spaces
-    const preDash = new RegExp(`((?<markerBeforeTwo>${sep}?)[ ]+|(?<markerBeforeThree>${sep}))`);
-    const surroundedDash = new RegExp(`(?<=[^\\s>]|^)${preDash.source}[~${EN_DASH}${EM_DASH}-]+[ ]*(?<markerAfter>${sep}?)([ ]+|$)`, "g");
+    const preDash = new RegExp(`(?:(?<markerBeforeTwo>${sep}?)[ ]+|(?<markerBeforeThree>${sep}))`);
+    const surroundedDash = new RegExp(`(?<=[^\\s>]|^)${preDash.source}[~${EN_DASH}${EM_DASH}-]+[ ]*(?<markerAfter>${sep}?)(?<trailingSpace>[ ]+|$)`, "g");
     const replacement = spaced
         ? `$<markerBeforeTwo>$<markerBeforeThree> ${dash} $<markerAfter>`
         : `$<markerBeforeTwo>$<markerBeforeThree>${dash}$<markerAfter>`;
@@ -57,7 +86,7 @@ function convertParentheticalDashes(text, sep, style) {
         : `$<markerBefore>${dash}$<markerAfter>`;
     text = text.replace(multipleDashInWords, multiReplacement);
     // Handle dashes at start of line
-    text = text.replace(new RegExp(`^(${sep})?[-]+ `, "gm"), `$1${dash} `);
+    text = text.replace(new RegExp(`^(?<sepStart>${sep})?[-]+ `, "gm"), `$<sepStart>${dash} `);
     return text;
 }
 /** Normalize spacing around em dashes for American style */

package/dist/dashes.js.map

@@ -1 +1 @@
-{"version":3,"file":"dashes.js","sourceRoot":"","sources":["../src/dashes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dashes.js","sourceRoot":"","sources":["../src/dashes.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { niceQuotes, type QuoteOptions, type PunctuationStyle } from "./quotes.j
 import type { PunctuationStyle } from "./quotes.js";
 export { hyphenReplace, enDashNumberRange, enDashDateRange, minusReplace, months, type DashOptions, type DashStyle, } from "./dashes.js";
 import type { DashStyle } from "./dashes.js";
-export { ellipsis, multiplication, mathSymbols, legalSymbols, arrows, degrees, fractions, primeMarks, symbolTransform, type SymbolOptions, } from "./symbols.js";
+export { ellipsis, multiplication, mathSymbols, legalSymbols, arrows, degrees, fractions, primeMarks, collapseSpaces, superscript, punctuationLigatures, symbolTransform, type SymbolOptions, } from "./symbols.js";
 export interface TransformOptions {
     /**
      * A boundary marker character used when transforming text that spans
@@ -28,15 +28,15 @@ export interface TransformOptions {
      */
     symbols?: boolean;
     /**
-     * Whether to include fraction transforms (1/2 → ½)
-     * Default: false (can be aggressive)
-     */
-    fractions?: boolean;
-    /**
-     * Whether to include degree symbol transforms (20 C → 20 °C)
-     * Default: false (can be aggressive)
+     * Whether to collapse multiple consecutive spaces (including non-breaking
+     * spaces) into a single space. Keeps the first space in the sequence.
+     *
+     * - `true` (default): "hello  world" → "hello world"
+     * - `false`: Preserve multiple spaces
+     *
+     * Default: true
      */
-    degrees?: boolean;
+    collapseSpaces?: boolean;
     /**
      * How to handle punctuation placement around quotation marks.
      *
@@ -59,7 +59,31 @@ export interface TransformOptions {
      * Default: "american"
      */
     dashStyle?: DashStyle;
+    /**
+     * Whether to include fraction transforms (1/2 → ½)
+     * Default: false (can be aggressive)
+     */
+    fractions?: boolean;
+    /**
+     * Whether to include degree symbol transforms (20 C → 20 °C)
+     * Default: false (can be aggressive)
+     */
+    degrees?: boolean;
+    /**
+     * Whether to convert ordinal suffixes to Unicode superscript characters.
+     * Transforms numbers like "1st", "2nd", "3rd", "4th" to "1ˢᵗ", "2ⁿᵈ", "3ʳᵈ", "4ᵗʰ".
+     * Default: false
+     */
+    superscript?: boolean;
+    /**
+     * Whether to convert repeated punctuation marks to Unicode ligature characters.
+     * Squashes multiple marks: "???" → "⁇", "?!" → "⁈", "!?" → "⁉", "!!!" → "!"
+     * Default: false (poor font support)
+     */
+    ligatures?: boolean;
 }
+export { assertSeparatorCountPreserved, countSeparators } from "./utils.js";
+export { DEFAULT_SEPARATOR } from "./constants.js";
 /**
  * Applies all typography transformations: smart quotes, proper dashes,
  * and symbol improvements.
@@ -69,8 +93,11 @@ export interface TransformOptions {
  * 2. primeMarks (feet/inches, arcminutes/arcseconds)
  * 3. niceQuotes (smart quotes)
  * 4. symbolTransform (ellipses, multiplication, math symbols, legal symbols, arrows)
- * 5. fractions (optional, disabled by default)
- * 6. degrees (optional, disabled by default)
+ * 5. fractions (disabled by default)
+ * 6. degrees (disabled by default)
+ * 7. superscript (disabled by default)
+ * 8. ligatures (disabled by default)
+ * 9. collapseSpaces (collapses multiple spaces into one)
  *
  * @param text - The text to transform
  * @param options - Configuration options
@@ -91,9 +118,4 @@ export interface TransformOptions {
  * ```
  */
 export declare function transform(text: string, options?: TransformOptions): string;
-/**
- * Default separator character for boundary marking.
- * Uses Unicode Private Use Area character U+E000.
- */
-export declare const DEFAULT_SEPARATOR = "\uE000";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,YAAY,EACZ,MAAM,EACN,OAAO,EACP,SAAS,EACT,UAAU,EACV,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IAEnC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAoB9E;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,YAAY,EACZ,MAAM,EACN,OAAO,EACP,SAAS,EACT,UAAU,EACV,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IAEnC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IAErB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAQD,OAAO,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAoC9E"}