@sonordev/contracts 2.4.0 → 2.5.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 2.5.0
+
+A minor release: one new entry, `@sonordev/contracts/sentences`, and a cache tag for commerce. Every other entry is unchanged.
+
+- **New entry `@sonordev/contracts/sentences`**: where prose splits into sentences, so every app that cuts an excerpt, a social slide or a summary out of an article ends sentences in the same places.
+  - `splitSentences(text)` returns the trimmed sentences of `text`. It's lossless: joining the result with spaces gives back every word of the input, in order. The usual one-liners aren't: `text.match(/[^.!?]+[.!?]+(?=\s|$)/g)` skips ahead at a period it can't use (the first one in "9 p.m.") and drops every word before its next match, and `text.match(/[^.!?]+[.!?]+/g)` cuts "9 p.m." into "9 p." and "m.".
+  - It doesn't end a sentence at a dotted abbreviation of letters ("p.m.", "U.S.", "e.g."), a single letter ("J."), a common short form (titles, company and street suffixes, months, and days of the week when capitalized: "Dr.", "Inc.", "Ave.", "Sept.", "Mon."), a label before a number ("No. 5", "Fig. 2") or a list number ("1.", "Step 2."), and never before a lowercase word. A piece with no letter in it ("...", "1.") joins the next sentence. A `!` or `?` right after an abbreviation still ends one.
+  - Prices, versions, domains and email addresses ("$4.50", "v2.1", "example.com") aren't abbreviations: a sentence can end after them.
+  - It runs in linear time: a megabyte of text takes milliseconds, however many abbreviations it holds.
+  - A newline or a list marker isn't a boundary by itself, so split on lines or paragraphs first when those matter.
+  - Empty, whitespace-only, `null` and `undefined` input give `[]`.
+- **`site-cache`**: `SITE_CACHE_TAGS.commerce` (`commerce`) is the tag for products, services, events and membership plans. commerce-kit tags its server fetches with it, and the Sonor API expires it when an offering changes. The other tags are unchanged.
+
 ## 2.4.0
 
 A minor release: one new entry, `@sonordev/contracts/schema-placeholders`, and the llms.txt sanitizers stop cutting mid-word. Every other entry is unchanged.

package/README.md

@@ -26,6 +26,7 @@ pnpm add @sonordev/contracts
 | `@sonordev/contracts/voice` | The house voice's contraction rule. `findUncontracted` and `contractText` find and apply full forms that should be contractions; `findContracted` finds the contractions a question-form heading should expand | anything that checks or rewrites copy: Sonor's APIs and dashboard |
 | `@sonordev/contracts/error-page` | Whether stored text is a rendered error page rather than a page's content, and whether generated copy says the page itself is missing | anything that stores page text or writes page copy from it: the Sonor API's page-view and sitemap writers, Signal's metadata generators |
 | `@sonordev/contracts/schema-placeholders` | Whether stored JSON-LD carries a template's unfilled slots (`example.com` URLs, an `Organization` named "Example", a placeholder phone, `[Resident Name]`, `{plan.name}`), and the value without them | site-kit's schema output, the Sonor API's schema reads and writes |
+| `@sonordev/contracts/sentences` | Where prose splits into sentences, without dropping a word or ending one at "p.m." (`splitSentences`) | anything that cuts an excerpt, a social slide or a summary out of an article: the Sonor API's carousels, Signal's article pipeline |
 
 ## Schema placeholders
 
@@ -287,6 +288,68 @@ A text-only check can't prove a page failed. Where you observed the HTTP
 status, require 400 or more as well and use this as the fallback; the header of
 `src/contracts/error-page.ts` lists the other known limits.
 
+## The sentences contract
+
+Cutting an excerpt, a slide or a summary out of an article starts with
+finding where its sentences end, and the usual one-liners for that get it
+wrong. `text.match(/[^.!?]+[.!?]+(?=\s|$)/g)` can't end a match at the first
+period of "9 p.m.", so it skips ahead and drops every word before the next
+match: "We open at 9 p.m. daily." comes back as "m." and " daily.". Without
+the lookahead, `text.match(/[^.!?]+[.!?]+/g)` cuts "9 p.m." into "9 p." and
+"m.". Both also drop any text after the last full stop. `splitSentences` is
+the one splitter to use instead.
+
+- **Lossless.** Joining the result with spaces gives back every word of the
+  input, in order. Nothing is dropped, added or reordered, and each sentence
+  comes back trimmed and non-empty.
+- **Where a sentence ends.** At `.`, `!` or `?` (and any closing `"`, `'`, `”`,
+  `’`, `)` or `]` after it) followed by whitespace and then `A` to `Z` or `0`
+  to `9`, optionally after one opening `"`, `'`, `“`, `‘`, `(` or `[`. Never
+  before a lowercase word or a symbol. Only ASCII capitals count: a sentence
+  that opens with an accented, Greek or Cyrillic capital, a currency sign, `#`,
+  `@` or an emoji stays joined to the one before it.
+- **Where it doesn't.** After a dotted abbreviation made of letters ("p.m.",
+  "U.S.", "e.g.", "Ph.D."), a single letter of either case (an initial like
+  "J.", but also "Plan A."), or a short form on its list: titles, company
+  suffixes, months, street suffixes and days of the week ("Dr.", "Inc.",
+  "Sept.", "Ave.", "Mon."). A few of those only count when capitalized, because
+  the lowercase word ends sentences too ("Mon." is a day, "the sun." isn't).
+  A label with a number after it stays together ("No. 5", "Fig. 2",
+  "Ste. 200"), while "No." before anything else ends a sentence. A list number
+  ("1.", "Step 2.", "Do three things: 1.") stays with its item.
+- **`!` and `?`.** An abbreviation only holds back a period. "Open until 9
+  p.m.? Yes!" is two sentences, under the same start-of-sentence rule as above.
+- **Prices, versions and web addresses** ("$4.50", "v2.1", "example.com",
+  "info@example.com") aren't abbreviations: a sentence can end after them.
+- **Never a bare mark.** A piece with no letter in it ("...", "?!", "1.")
+  isn't a sentence. It joins the next one.
+- **Prose, not layout.** A newline or a list marker doesn't start a new
+  sentence by itself. If lines or paragraphs matter, split on those first and
+  call `splitSentences` on each one.
+- **Empty is `[]`.** Empty, whitespace-only, `null` and `undefined` input all
+  give an empty array, never `null`, so callers can iterate without a guard.
+- **Linear time.** One pass over the text. A megabyte takes milliseconds,
+  however many abbreviations, stops or quotes it holds.
+
+```ts
+import { splitSentences } from '@sonordev/contracts/sentences'
+
+splitSentences('We open at 9 a.m. daily. Walk-ins are welcome.')
+// ['We open at 9 a.m. daily.', 'Walk-ins are welcome.']
+
+splitSentences(excerptSource).slice(0, 2).join(' ')
+// the first two sentences, whole
+```
+
+Known limits. Where it can't be sure it leans toward joining, because a
+sentence that runs long costs less than a lost word, and a caller that caps
+length should cut at a word. It can't tell an abbreviation that ends a
+sentence from one that doesn't ("Contact Acme Inc. Our team ..." and "... in
+Washington, D.C. Residents ..." each stay in one piece), it only knows English
+short forms (a period after one it doesn't know ends a sentence, so "Sra.
+García" splits after "Sra."), and the next sentence has to start with `A` to
+`Z` or a digit.
+
 ## Why it exists
 
 A rule that lives in several copies is how two of them end up disagreeing.

package/dist/sentences.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Sentences contract: how prose is split into sentences, so the APIs that cut
+ * an excerpt, a carousel slide or a summary out of an article agree on where
+ * a sentence ends. The APIs import it as `@sonordev/contracts/sentences`.
+ *
+ * Lossless: joining the result with spaces gives back every word of the input,
+ * in order. The usual one-liner, `text.match(/[^.!?]+[.!?]+(?=\s|$)/g)`, isn't.
+ * A period it can't use, like the first one in "9 p.m. call", makes match()
+ * skip ahead and silently drop every word before its next match, so a
+ * sentence about a 9 p.m. call comes back as "m.". Don't re-fork a regex for
+ * this.
+ *
+ * A sentence ends at . ! or ? (and any closing quote or bracket after it)
+ * followed by whitespace, then an optional opening quote or bracket, then
+ * A to Z or 0 to 9. Never before a lowercase word or a symbol, and only ASCII
+ * capitals count. It doesn't end at:
+ *  - an abbreviation: a dotted one made of letters ("p.m.", "U.S.", "e.g.",
+ *    "Ph.D."), a single letter ("J.", "Plan A."), or a short form listed below
+ *    (titles, months, days, company suffixes, street suffixes);
+ *  - a label that has a number after it ("No. 5", "Fig. 2", "Ste. 200");
+ *  - a list number ("1.", "Step 2.", "Do three things: 1.").
+ * A piece with no letter in it ("...", "1.") isn't a sentence and joins the
+ * next one. A "!" or "?" is never held back by an abbreviation (only a period
+ * is), though the same start-of-sentence rule applies after it.
+ *
+ * Prices, versions, domains and email addresses ("$4.50", "v2.1",
+ * "example.com") are not abbreviations: a sentence can end after them.
+ *
+ * Where it is unsure it leans toward not splitting, because a sentence that
+ * runs long costs less than a lost word. A period after a short form that
+ * isn't listed ends a sentence like any other.
+ *
+ * It reads sentences, not layout. A newline or a list marker doesn't start a
+ * new sentence by itself, so split text into lines or paragraphs first when
+ * those matter, then split each one.
+ */
+/**
+ * Splits prose into trimmed sentences without dropping or reordering a word.
+ * Empty, blank and nullish input give `[]`, never `null`.
+ *
+ * One pass, linear in the length of the text: each run of . ! ? (and the
+ * closing quotes or brackets after it) is looked at once, an abbreviation or
+ * list-marker check reads only the last few characters, and the check for a
+ * letter reads each character once.
+ */
+export declare function splitSentences(text: string | null | undefined): string[];

package/dist/sentences.js

@@ -0,0 +1,179 @@
+'use strict';
+
+// src/contracts/sentences.ts
+var ABBREVIATIONS = /* @__PURE__ */ new Set([
+  "mr",
+  "mrs",
+  "ms",
+  "dr",
+  "prof",
+  "st",
+  "jr",
+  "sr",
+  "vs",
+  "inc",
+  "co",
+  "corp",
+  "ltd",
+  "llc",
+  "approx",
+  "dept",
+  "jan",
+  "feb",
+  "mar",
+  "apr",
+  "jun",
+  "jul",
+  "aug",
+  "sep",
+  "sept",
+  "oct",
+  "nov",
+  "dec",
+  "gen",
+  "sen",
+  "gov",
+  "lt",
+  "col",
+  "capt",
+  "sgt",
+  "cpl",
+  "maj",
+  "adm",
+  "pres",
+  "atty",
+  "bros",
+  "mfg",
+  "assoc",
+  "univ",
+  "bldg",
+  "ste",
+  "ave",
+  "blvd",
+  "rd",
+  "ln",
+  "hwy",
+  "pkwy",
+  "pl"
+]);
+var CAPITALISED_ABBREVIATIONS = /* @__PURE__ */ new Set([
+  "Mon",
+  "Tue",
+  "Tues",
+  "Wed",
+  "Thu",
+  "Thur",
+  "Thurs",
+  "Fri",
+  "Sat",
+  "Sun",
+  "Mt",
+  "Ft",
+  "Ct",
+  "Rep",
+  "Rev",
+  "Hon"
+]);
+var BEFORE_NUMBER = /* @__PURE__ */ new Set([
+  "no",
+  "nos",
+  "fig",
+  "figs",
+  "vol",
+  "vols",
+  "ch",
+  "sec",
+  "pp",
+  "cf",
+  "ca",
+  "est",
+  "ext",
+  "tel",
+  "ph",
+  "ste",
+  "apt",
+  "bldg",
+  "rm",
+  "hwy",
+  "rt",
+  "rte"
+]);
+var DOTTED_SHORT = /^\d*(?:[A-Za-z]{1,2}\.)+[A-Za-z]{1,2}$/;
+var DOTTED_CAPS = /^(?:[A-Z][A-Za-z]*\.)+[A-Z][A-Za-z]*$/;
+var ABBREVIATION_RANGE = /[A-Za-z]\.[-–—/]/;
+var LIST_MARKER_ALONE = /^\s*(?:(?:step|tip|reason|rule|point|item|option)\s+)?\d{1,3}\.$/i;
+var LIST_MARKER_AFTER_COLON = /:\s+\d{1,3}\.$/;
+var LIST_MARKER_REACH = 24;
+var OPENERS = /* @__PURE__ */ new Set(['"', "'", "\u201C", "\u2018", "(", "["]);
+var CLOSERS = /* @__PURE__ */ new Set(['"', "'", "\u201D", "\u2019", ")", "]"]);
+var SPACE = /\s/;
+var LETTER = /\p{L}/u;
+var DIGIT = /[0-9]/;
+var SENTENCE_START = /[A-Z0-9]/;
+var isStop = (c) => c === "." || c === "!" || c === "?";
+var isSpace = (c) => SPACE.test(c);
+function startsSentence(source, at) {
+  const c = OPENERS.has(source[at]) ? source[at + 1] : source[at];
+  return c !== void 0 && SENTENCE_START.test(c);
+}
+function digitFollows(source, at) {
+  const c = OPENERS.has(source[at]) ? source[at + 1] : source[at];
+  return c !== void 0 && DIGIT.test(c);
+}
+function isDottedAbbreviation(bare) {
+  const compound = Math.max(bare.lastIndexOf("-"), bare.lastIndexOf("\u2013"), bare.lastIndexOf("\u2014"), bare.lastIndexOf("/"));
+  const last = bare.slice(compound + 1);
+  return DOTTED_SHORT.test(last) || DOTTED_CAPS.test(last) || ABBREVIATION_RANGE.test(bare);
+}
+function endsWithAbbreviation(source, end, digitNext) {
+  let from = end;
+  while (from > 0 && !isSpace(source[from - 1])) from--;
+  let to = end;
+  while (from < to && OPENERS.has(source[from])) from++;
+  while (to > from && CLOSERS.has(source[to - 1])) to--;
+  while (to > from && source[to - 1] === ".") to--;
+  const bare = source.slice(from, to);
+  const lower = bare.toLowerCase();
+  return isDottedAbbreviation(bare) || /^[A-Za-z]$/.test(bare) || ABBREVIATIONS.has(lower) || CAPITALISED_ABBREVIATIONS.has(bare) || digitNext && BEFORE_NUMBER.has(lower);
+}
+function endsWithListMarker(source, start, end) {
+  const from = Math.max(start, end - LIST_MARKER_REACH);
+  const tail = source.slice(from, end);
+  return from === start && LIST_MARKER_ALONE.test(tail) || LIST_MARKER_AFTER_COLON.test(tail);
+}
+function splitSentences(text) {
+  const source = (text ?? "").trim();
+  if (!source) return [];
+  const sentences = [];
+  let start = 0;
+  let scanned = 0;
+  let sawLetter = false;
+  let i = 0;
+  while (i < source.length) {
+    if (!isStop(source[i])) {
+      i++;
+      continue;
+    }
+    let endsStrong = false;
+    while (i < source.length && isStop(source[i])) {
+      if (source[i] !== ".") endsStrong = true;
+      i++;
+    }
+    while (i < source.length && CLOSERS.has(source[i])) i++;
+    let next = i;
+    while (next < source.length && isSpace(source[next])) next++;
+    if (next === i || !startsSentence(source, next)) continue;
+    if (!sawLetter) sawLetter = LETTER.test(source.slice(scanned, i));
+    scanned = i;
+    if (!sawLetter) continue;
+    if (!endsStrong && (endsWithAbbreviation(source, i, digitFollows(source, next)) || endsWithListMarker(source, start, i))) continue;
+    sentences.push(source.slice(start, i).trim());
+    start = i;
+    sawLetter = false;
+  }
+  const rest = source.slice(start).trim();
+  if (rest) sentences.push(rest);
+  return sentences;
+}
+
+exports.splitSentences = splitSentences;

package/dist/sentences.mjs

@@ -0,0 +1,177 @@
+// src/contracts/sentences.ts
+var ABBREVIATIONS = /* @__PURE__ */ new Set([
+  "mr",
+  "mrs",
+  "ms",
+  "dr",
+  "prof",
+  "st",
+  "jr",
+  "sr",
+  "vs",
+  "inc",
+  "co",
+  "corp",
+  "ltd",
+  "llc",
+  "approx",
+  "dept",
+  "jan",
+  "feb",
+  "mar",
+  "apr",
+  "jun",
+  "jul",
+  "aug",
+  "sep",
+  "sept",
+  "oct",
+  "nov",
+  "dec",
+  "gen",
+  "sen",
+  "gov",
+  "lt",
+  "col",
+  "capt",
+  "sgt",
+  "cpl",
+  "maj",
+  "adm",
+  "pres",
+  "atty",
+  "bros",
+  "mfg",
+  "assoc",
+  "univ",
+  "bldg",
+  "ste",
+  "ave",
+  "blvd",
+  "rd",
+  "ln",
+  "hwy",
+  "pkwy",
+  "pl"
+]);
+var CAPITALISED_ABBREVIATIONS = /* @__PURE__ */ new Set([
+  "Mon",
+  "Tue",
+  "Tues",
+  "Wed",
+  "Thu",
+  "Thur",
+  "Thurs",
+  "Fri",
+  "Sat",
+  "Sun",
+  "Mt",
+  "Ft",
+  "Ct",
+  "Rep",
+  "Rev",
+  "Hon"
+]);
+var BEFORE_NUMBER = /* @__PURE__ */ new Set([
+  "no",
+  "nos",
+  "fig",
+  "figs",
+  "vol",
+  "vols",
+  "ch",
+  "sec",
+  "pp",
+  "cf",
+  "ca",
+  "est",
+  "ext",
+  "tel",
+  "ph",
+  "ste",
+  "apt",
+  "bldg",
+  "rm",
+  "hwy",
+  "rt",
+  "rte"
+]);
+var DOTTED_SHORT = /^\d*(?:[A-Za-z]{1,2}\.)+[A-Za-z]{1,2}$/;
+var DOTTED_CAPS = /^(?:[A-Z][A-Za-z]*\.)+[A-Z][A-Za-z]*$/;
+var ABBREVIATION_RANGE = /[A-Za-z]\.[-–—/]/;
+var LIST_MARKER_ALONE = /^\s*(?:(?:step|tip|reason|rule|point|item|option)\s+)?\d{1,3}\.$/i;
+var LIST_MARKER_AFTER_COLON = /:\s+\d{1,3}\.$/;
+var LIST_MARKER_REACH = 24;
+var OPENERS = /* @__PURE__ */ new Set(['"', "'", "\u201C", "\u2018", "(", "["]);
+var CLOSERS = /* @__PURE__ */ new Set(['"', "'", "\u201D", "\u2019", ")", "]"]);
+var SPACE = /\s/;
+var LETTER = /\p{L}/u;
+var DIGIT = /[0-9]/;
+var SENTENCE_START = /[A-Z0-9]/;
+var isStop = (c) => c === "." || c === "!" || c === "?";
+var isSpace = (c) => SPACE.test(c);
+function startsSentence(source, at) {
+  const c = OPENERS.has(source[at]) ? source[at + 1] : source[at];
+  return c !== void 0 && SENTENCE_START.test(c);
+}
+function digitFollows(source, at) {
+  const c = OPENERS.has(source[at]) ? source[at + 1] : source[at];
+  return c !== void 0 && DIGIT.test(c);
+}
+function isDottedAbbreviation(bare) {
+  const compound = Math.max(bare.lastIndexOf("-"), bare.lastIndexOf("\u2013"), bare.lastIndexOf("\u2014"), bare.lastIndexOf("/"));
+  const last = bare.slice(compound + 1);
+  return DOTTED_SHORT.test(last) || DOTTED_CAPS.test(last) || ABBREVIATION_RANGE.test(bare);
+}
+function endsWithAbbreviation(source, end, digitNext) {
+  let from = end;
+  while (from > 0 && !isSpace(source[from - 1])) from--;
+  let to = end;
+  while (from < to && OPENERS.has(source[from])) from++;
+  while (to > from && CLOSERS.has(source[to - 1])) to--;
+  while (to > from && source[to - 1] === ".") to--;
+  const bare = source.slice(from, to);
+  const lower = bare.toLowerCase();
+  return isDottedAbbreviation(bare) || /^[A-Za-z]$/.test(bare) || ABBREVIATIONS.has(lower) || CAPITALISED_ABBREVIATIONS.has(bare) || digitNext && BEFORE_NUMBER.has(lower);
+}
+function endsWithListMarker(source, start, end) {
+  const from = Math.max(start, end - LIST_MARKER_REACH);
+  const tail = source.slice(from, end);
+  return from === start && LIST_MARKER_ALONE.test(tail) || LIST_MARKER_AFTER_COLON.test(tail);
+}
+function splitSentences(text) {
+  const source = (text ?? "").trim();
+  if (!source) return [];
+  const sentences = [];
+  let start = 0;
+  let scanned = 0;
+  let sawLetter = false;
+  let i = 0;
+  while (i < source.length) {
+    if (!isStop(source[i])) {
+      i++;
+      continue;
+    }
+    let endsStrong = false;
+    while (i < source.length && isStop(source[i])) {
+      if (source[i] !== ".") endsStrong = true;
+      i++;
+    }
+    while (i < source.length && CLOSERS.has(source[i])) i++;
+    let next = i;
+    while (next < source.length && isSpace(source[next])) next++;
+    if (next === i || !startsSentence(source, next)) continue;
+    if (!sawLetter) sawLetter = LETTER.test(source.slice(scanned, i));
+    scanned = i;
+    if (!sawLetter) continue;
+    if (!endsStrong && (endsWithAbbreviation(source, i, digitFollows(source, next)) || endsWithListMarker(source, start, i))) continue;
+    sentences.push(source.slice(start, i).trim());
+    start = i;
+    sawLetter = false;
+  }
+  const rest = source.slice(start).trim();
+  if (rest) sentences.push(rest);
+  return sentences;
+}
+
+export { splitSentences };

package/dist/site-cache.d.ts

@@ -27,6 +27,8 @@ export declare const SITE_CACHE_TAGS: {
     readonly taxonomy: 'editorial-taxonomy';
     /** Portfolio items (agency-site-kit). */
     readonly portfolio: 'portfolio';
+    /** Products, services, events and membership plans (commerce-kit). */
+    readonly commerce: 'commerce';
 };
 export type SiteCacheTag = (typeof SITE_CACHE_TAGS)[keyof typeof SITE_CACHE_TAGS];
 /** The body Sonor POSTs to the revalidation route. */

package/dist/site-cache.js

@@ -12,7 +12,9 @@ var SITE_CACHE_TAGS = {
   /** Article categories and tags. */
   taxonomy: "editorial-taxonomy",
   /** Portfolio items (agency-site-kit). */
-  portfolio: "portfolio"
+  portfolio: "portfolio",
+  /** Products, services, events and membership plans (commerce-kit). */
+  commerce: "commerce"
 };
 function isSiteRevalidatePong(body) {
   return typeof body === "object" && body !== null && body.ok === true && body.ping === true;

package/dist/site-cache.mjs

@@ -10,7 +10,9 @@ var SITE_CACHE_TAGS = {
   /** Article categories and tags. */
   taxonomy: "editorial-taxonomy",
   /** Portfolio items (agency-site-kit). */
-  portfolio: "portfolio"
+  portfolio: "portfolio",
+  /** Products, services, events and membership plans (commerce-kit). */
+  commerce: "commerce"
 };
 function isSiteRevalidatePong(body) {
   return typeof body === "object" && body !== null && body.ok === true && body.ping === true;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sonordev/contracts",
-  "version": "2.4.0",
-  "description": "The rules Sonor's sites, APIs and dashboard share: popup blocks and site design tokens, site hosts, SEO page identity, title quality, llms.txt sanitizers, the forms honeypot, fleet heartbeats, slot content and signing, site cache tags, portfolio metrics, the house voice's contraction rule, how a proposal's site plan counts its pages, what separates an error page from a page's content, and which stored JSON-LD is a template's unfilled placeholder. Pure functions, no dependencies.",
+  "version": "2.5.0",
+  "description": "The rules Sonor's sites, APIs and dashboard share: popup blocks and site design tokens, site hosts, SEO page identity, title quality, llms.txt sanitizers, the forms honeypot, fleet heartbeats, slot content and signing, site cache tags, portfolio metrics, the house voice's contraction rule, how a proposal's site plan counts its pages, what separates an error page from a page's content, which stored JSON-LD is a template's unfilled placeholder, and where prose splits into sentences. Pure functions, no dependencies.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -100,6 +100,11 @@
       "import": "./dist/schema-placeholders.mjs",
       "require": "./dist/schema-placeholders.js"
     },
+    "./sentences": {
+      "types": "./dist/sentences.d.ts",
+      "import": "./dist/sentences.mjs",
+      "require": "./dist/sentences.js"
+    },
     "./package.json": "./package.json"
   },
   "typesVersions": {