@sonordev/contracts 2.3.0 → 2.5.0

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.3.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, and what separates an error page from a page's content. 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",
@@ -95,6 +95,16 @@
       "import": "./dist/error-page.mjs",
       "require": "./dist/error-page.js"
     },
+    "./schema-placeholders": {
+      "types": "./dist/schema-placeholders.d.ts",
+      "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": {