@sonordev/contracts 1.0.0 → 2.1.0

package/dist/voice.js

@@ -0,0 +1,200 @@
+'use strict';
+
+// src/contracts/voice.ts
+var VOICE_MASK = "\u2800";
+var TABLE = [
+  ["do not", "don't"],
+  ["does not", "doesn't"],
+  ["did not", "didn't"],
+  ["is not", "isn't"],
+  ["are not", "aren't"],
+  ["was not", "wasn't"],
+  ["were not", "weren't"],
+  ["cannot", "can't"],
+  ["can not", "can't"],
+  ["will not", "won't"],
+  ["would not", "wouldn't"],
+  ["should not", "shouldn't"],
+  ["could not", "couldn't"],
+  ["has not", "hasn't"],
+  ["have not", "haven't"],
+  ["had not", "hadn't"],
+  ["must not", "mustn't"],
+  ["need not", "needn't"],
+  ["it is", "it's"],
+  ["that is", "that's"],
+  ["there is", "there's"],
+  ["here is", "here's"],
+  ["who is", "who's"],
+  ["what is", "what's"],
+  ["you are", "you're"],
+  ["we are", "we're"],
+  ["they are", "they're"],
+  ["I am", "I'm"],
+  ["you will", "you'll"],
+  ["we will", "we'll"],
+  ["they will", "they'll"],
+  ["it will", "it'll"],
+  ["we would", "we'd"],
+  ["you would", "you'd"],
+  ["they would", "they'd"],
+  ["let us", "let's"]
+];
+var PAIRS = TABLE.map(([full, contracted]) => ({
+  full,
+  contracted,
+  negation: / not$|^cannot$/.test(full),
+  pattern: new RegExp(`\\b${full.replace(/ /g, "[ \\t]+")}\\b`, "gi")
+}));
+var CAN_NOT_ONLY = /[ \t]+only\b/iy;
+var CLAUSE_END = /[ \t]*(?:[.,;:!?)\]}"\u201d\u2019\u2026\u2014\u2013-]|\r?\n|\r?$)/y;
+var CONJUNCTION = /[ \t]+(?:and|or|but|nor)\b/iy;
+var LET_US_SUGGESTIONS = /[ \t]+(?:look|start|begin|consider|turn|see|review|compare|break|dig|recap|unpack|explore|examine|revisit|focus|go|talk|move|get started|step back|zoom out)\b/iy;
+var PROSE_GAP = /[\s*_\u2800]/;
+var preserveCase = (match, replacement) => match[0] === match[0].toUpperCase() && match[0] !== match[0].toLowerCase() ? replacement[0].toUpperCase() + replacement.slice(1) : replacement;
+var maskAll = (text) => text.replace(/[^\r\n]/g, VOICE_MASK);
+function maskProtected(text, ranges) {
+  if (!ranges) return text;
+  if (!Array.isArray(ranges)) return maskAll(text);
+  if (ranges.length === 0) return text;
+  const length = text.length;
+  const edges = new Int32Array(length + 1);
+  let any = false;
+  for (const range of ranges) {
+    const from = range?.[0];
+    const to = range?.[1];
+    if (typeof from !== "number" || typeof to !== "number" || Number.isNaN(from) || Number.isNaN(to) || from > to) return maskAll(text);
+    const start = Math.max(0, Math.floor(from));
+    const end = Math.min(length, Math.ceil(to));
+    if (end <= start) continue;
+    edges[start] += 1;
+    edges[end] -= 1;
+    any = true;
+  }
+  if (!any) return text;
+  const parts = [];
+  let depth = 0;
+  let runStart = 0;
+  let runProtected = false;
+  for (let i = 0; i <= length; i++) {
+    const isProtected = i < length && (depth += edges[i]) > 0;
+    if (i === length || isProtected !== runProtected) {
+      if (i > runStart) parts.push(runProtected ? maskAll(text.slice(runStart, i)) : text.slice(runStart, i));
+      runStart = i;
+      runProtected = isProtected;
+    }
+  }
+  return parts.join("");
+}
+function walkBackOverGap(text, start) {
+  let at = start;
+  while (at > 0 && text[at - 1] !== "\n" && PROSE_GAP.test(text[at - 1])) at--;
+  return at;
+}
+function firstStop(text, from) {
+  for (let i = from; i < text.length; i++) {
+    const code = text.charCodeAt(i);
+    if (code === 46 || code === 33 || code === 63 || code === 10) return i;
+  }
+  return text.length;
+}
+function mustStayFull(pair, text, titleLike, start, end, look) {
+  if (pair.full === "can not") {
+    CAN_NOT_ONLY.lastIndex = end;
+    return CAN_NOT_ONLY.test(text);
+  }
+  if (pair.negation) return false;
+  CLAUSE_END.lastIndex = end;
+  if (CLAUSE_END.test(text)) return true;
+  CONJUNCTION.lastIndex = end;
+  if (CONJUNCTION.test(text)) return true;
+  if (pair.full === "what is") {
+    if (look.stop < end) look.stop = firstStop(text, end);
+    if (text.charCodeAt(look.stop) === 63) return true;
+    if (titleLike) {
+      const at = walkBackOverGap(text, start);
+      if (at === 0 || text[at - 1] === "\n") return true;
+    }
+  }
+  if (pair.full === "let us") {
+    const at = walkBackOverGap(text, start);
+    if (at > 0 && !".!?:\n".includes(text[at - 1])) return true;
+    LET_US_SUGGESTIONS.lastIndex = end;
+    return !LET_US_SUGGESTIONS.test(text);
+  }
+  return false;
+}
+function scanUncontracted(text, masked, titleLike) {
+  if (masked.length < 4) return [];
+  const hits = [];
+  const claimed = new Uint8Array(masked.length);
+  for (const pair of PAIRS) {
+    const look = { stop: -1 };
+    for (const found of masked.matchAll(pair.pattern)) {
+      const start = found.index ?? 0;
+      const end = start + found[0].length;
+      let overlaps = false;
+      for (let i = start; i < end; i++) {
+        if (claimed[i] === 1) {
+          overlaps = true;
+          break;
+        }
+      }
+      if (overlaps || mustStayFull(pair, masked, titleLike, start, end, look)) continue;
+      claimed.fill(1, start, end);
+      const match = text.slice(start, end);
+      hits.push({ index: start, length: end - start, match, suggestion: preserveCase(match, pair.contracted) });
+    }
+  }
+  return hits.sort((a, b) => a.index - b.index);
+}
+function findUncontracted(text, options) {
+  if (typeof text !== "string" || !text) return [];
+  return scanUncontracted(text, maskProtected(text, options?.protectedRanges), options?.titleLike === true);
+}
+function contractText(text, options) {
+  const hits = findUncontracted(text, options);
+  if (hits.length === 0) return text;
+  let out = "";
+  let cursor = 0;
+  for (const hit of hits) {
+    out += text.slice(cursor, hit.index) + hit.suggestion;
+    cursor = hit.index + hit.length;
+  }
+  return out + text.slice(cursor);
+}
+var CONTRACTION = /\b(?:[A-Za-z]+n['\u2019]t|(?:it|that|what|there|here|who|where|how|when|why|let|he|she)['\u2019]s|(?:you|we|they|who|what)['\u2019]re|(?:i|you|we|they|it|that|who|there|what)['\u2019]ll|(?:i|you|we|they|who|could|would|should|might|must)['\u2019]ve|(?:i|you|we|they|he|she|it|that|who|there)['\u2019]d|i['\u2019]m)\b/gi;
+var IRREGULAR_EXPANSIONS = {
+  "can't": "cannot",
+  "won't": "will not",
+  "shan't": "shall not",
+  "let's": "let us",
+  "i'm": "I am"
+};
+var SUFFIX_EXPANSIONS = { s: "is", re: "are", ll: "will", ve: "have", d: "would", m: "am" };
+function expandContraction(contraction) {
+  const plain = contraction.replace(/\u2019/g, "'");
+  const lower = plain.toLowerCase();
+  let expanded = IRREGULAR_EXPANSIONS[lower];
+  if (!expanded && lower.endsWith("n't")) expanded = `${plain.slice(0, -3)} not`;
+  if (!expanded) {
+    const [word, suffix] = plain.split("'");
+    expanded = `${word} ${SUFFIX_EXPANSIONS[suffix.toLowerCase()] ?? suffix}`;
+  }
+  return preserveCase(plain, expanded);
+}
+function findContracted(text, options) {
+  if (typeof text !== "string" || !text) return [];
+  const hits = [];
+  for (const found of maskProtected(text, options?.protectedRanges).matchAll(CONTRACTION)) {
+    const index = found.index ?? 0;
+    const match = text.slice(index, index + found[0].length);
+    hits.push({ index, length: match.length, match, suggestion: expandContraction(match) });
+  }
+  return hits;
+}
+
+exports.VOICE_MASK = VOICE_MASK;
+exports.contractText = contractText;
+exports.findContracted = findContracted;
+exports.findUncontracted = findUncontracted;

package/dist/voice.mjs

@@ -0,0 +1,195 @@
+// src/contracts/voice.ts
+var VOICE_MASK = "\u2800";
+var TABLE = [
+  ["do not", "don't"],
+  ["does not", "doesn't"],
+  ["did not", "didn't"],
+  ["is not", "isn't"],
+  ["are not", "aren't"],
+  ["was not", "wasn't"],
+  ["were not", "weren't"],
+  ["cannot", "can't"],
+  ["can not", "can't"],
+  ["will not", "won't"],
+  ["would not", "wouldn't"],
+  ["should not", "shouldn't"],
+  ["could not", "couldn't"],
+  ["has not", "hasn't"],
+  ["have not", "haven't"],
+  ["had not", "hadn't"],
+  ["must not", "mustn't"],
+  ["need not", "needn't"],
+  ["it is", "it's"],
+  ["that is", "that's"],
+  ["there is", "there's"],
+  ["here is", "here's"],
+  ["who is", "who's"],
+  ["what is", "what's"],
+  ["you are", "you're"],
+  ["we are", "we're"],
+  ["they are", "they're"],
+  ["I am", "I'm"],
+  ["you will", "you'll"],
+  ["we will", "we'll"],
+  ["they will", "they'll"],
+  ["it will", "it'll"],
+  ["we would", "we'd"],
+  ["you would", "you'd"],
+  ["they would", "they'd"],
+  ["let us", "let's"]
+];
+var PAIRS = TABLE.map(([full, contracted]) => ({
+  full,
+  contracted,
+  negation: / not$|^cannot$/.test(full),
+  pattern: new RegExp(`\\b${full.replace(/ /g, "[ \\t]+")}\\b`, "gi")
+}));
+var CAN_NOT_ONLY = /[ \t]+only\b/iy;
+var CLAUSE_END = /[ \t]*(?:[.,;:!?)\]}"\u201d\u2019\u2026\u2014\u2013-]|\r?\n|\r?$)/y;
+var CONJUNCTION = /[ \t]+(?:and|or|but|nor)\b/iy;
+var LET_US_SUGGESTIONS = /[ \t]+(?:look|start|begin|consider|turn|see|review|compare|break|dig|recap|unpack|explore|examine|revisit|focus|go|talk|move|get started|step back|zoom out)\b/iy;
+var PROSE_GAP = /[\s*_\u2800]/;
+var preserveCase = (match, replacement) => match[0] === match[0].toUpperCase() && match[0] !== match[0].toLowerCase() ? replacement[0].toUpperCase() + replacement.slice(1) : replacement;
+var maskAll = (text) => text.replace(/[^\r\n]/g, VOICE_MASK);
+function maskProtected(text, ranges) {
+  if (!ranges) return text;
+  if (!Array.isArray(ranges)) return maskAll(text);
+  if (ranges.length === 0) return text;
+  const length = text.length;
+  const edges = new Int32Array(length + 1);
+  let any = false;
+  for (const range of ranges) {
+    const from = range?.[0];
+    const to = range?.[1];
+    if (typeof from !== "number" || typeof to !== "number" || Number.isNaN(from) || Number.isNaN(to) || from > to) return maskAll(text);
+    const start = Math.max(0, Math.floor(from));
+    const end = Math.min(length, Math.ceil(to));
+    if (end <= start) continue;
+    edges[start] += 1;
+    edges[end] -= 1;
+    any = true;
+  }
+  if (!any) return text;
+  const parts = [];
+  let depth = 0;
+  let runStart = 0;
+  let runProtected = false;
+  for (let i = 0; i <= length; i++) {
+    const isProtected = i < length && (depth += edges[i]) > 0;
+    if (i === length || isProtected !== runProtected) {
+      if (i > runStart) parts.push(runProtected ? maskAll(text.slice(runStart, i)) : text.slice(runStart, i));
+      runStart = i;
+      runProtected = isProtected;
+    }
+  }
+  return parts.join("");
+}
+function walkBackOverGap(text, start) {
+  let at = start;
+  while (at > 0 && text[at - 1] !== "\n" && PROSE_GAP.test(text[at - 1])) at--;
+  return at;
+}
+function firstStop(text, from) {
+  for (let i = from; i < text.length; i++) {
+    const code = text.charCodeAt(i);
+    if (code === 46 || code === 33 || code === 63 || code === 10) return i;
+  }
+  return text.length;
+}
+function mustStayFull(pair, text, titleLike, start, end, look) {
+  if (pair.full === "can not") {
+    CAN_NOT_ONLY.lastIndex = end;
+    return CAN_NOT_ONLY.test(text);
+  }
+  if (pair.negation) return false;
+  CLAUSE_END.lastIndex = end;
+  if (CLAUSE_END.test(text)) return true;
+  CONJUNCTION.lastIndex = end;
+  if (CONJUNCTION.test(text)) return true;
+  if (pair.full === "what is") {
+    if (look.stop < end) look.stop = firstStop(text, end);
+    if (text.charCodeAt(look.stop) === 63) return true;
+    if (titleLike) {
+      const at = walkBackOverGap(text, start);
+      if (at === 0 || text[at - 1] === "\n") return true;
+    }
+  }
+  if (pair.full === "let us") {
+    const at = walkBackOverGap(text, start);
+    if (at > 0 && !".!?:\n".includes(text[at - 1])) return true;
+    LET_US_SUGGESTIONS.lastIndex = end;
+    return !LET_US_SUGGESTIONS.test(text);
+  }
+  return false;
+}
+function scanUncontracted(text, masked, titleLike) {
+  if (masked.length < 4) return [];
+  const hits = [];
+  const claimed = new Uint8Array(masked.length);
+  for (const pair of PAIRS) {
+    const look = { stop: -1 };
+    for (const found of masked.matchAll(pair.pattern)) {
+      const start = found.index ?? 0;
+      const end = start + found[0].length;
+      let overlaps = false;
+      for (let i = start; i < end; i++) {
+        if (claimed[i] === 1) {
+          overlaps = true;
+          break;
+        }
+      }
+      if (overlaps || mustStayFull(pair, masked, titleLike, start, end, look)) continue;
+      claimed.fill(1, start, end);
+      const match = text.slice(start, end);
+      hits.push({ index: start, length: end - start, match, suggestion: preserveCase(match, pair.contracted) });
+    }
+  }
+  return hits.sort((a, b) => a.index - b.index);
+}
+function findUncontracted(text, options) {
+  if (typeof text !== "string" || !text) return [];
+  return scanUncontracted(text, maskProtected(text, options?.protectedRanges), options?.titleLike === true);
+}
+function contractText(text, options) {
+  const hits = findUncontracted(text, options);
+  if (hits.length === 0) return text;
+  let out = "";
+  let cursor = 0;
+  for (const hit of hits) {
+    out += text.slice(cursor, hit.index) + hit.suggestion;
+    cursor = hit.index + hit.length;
+  }
+  return out + text.slice(cursor);
+}
+var CONTRACTION = /\b(?:[A-Za-z]+n['\u2019]t|(?:it|that|what|there|here|who|where|how|when|why|let|he|she)['\u2019]s|(?:you|we|they|who|what)['\u2019]re|(?:i|you|we|they|it|that|who|there|what)['\u2019]ll|(?:i|you|we|they|who|could|would|should|might|must)['\u2019]ve|(?:i|you|we|they|he|she|it|that|who|there)['\u2019]d|i['\u2019]m)\b/gi;
+var IRREGULAR_EXPANSIONS = {
+  "can't": "cannot",
+  "won't": "will not",
+  "shan't": "shall not",
+  "let's": "let us",
+  "i'm": "I am"
+};
+var SUFFIX_EXPANSIONS = { s: "is", re: "are", ll: "will", ve: "have", d: "would", m: "am" };
+function expandContraction(contraction) {
+  const plain = contraction.replace(/\u2019/g, "'");
+  const lower = plain.toLowerCase();
+  let expanded = IRREGULAR_EXPANSIONS[lower];
+  if (!expanded && lower.endsWith("n't")) expanded = `${plain.slice(0, -3)} not`;
+  if (!expanded) {
+    const [word, suffix] = plain.split("'");
+    expanded = `${word} ${SUFFIX_EXPANSIONS[suffix.toLowerCase()] ?? suffix}`;
+  }
+  return preserveCase(plain, expanded);
+}
+function findContracted(text, options) {
+  if (typeof text !== "string" || !text) return [];
+  const hits = [];
+  for (const found of maskProtected(text, options?.protectedRanges).matchAll(CONTRACTION)) {
+    const index = found.index ?? 0;
+    const match = text.slice(index, index + found[0].length);
+    hits.push({ index, length: match.length, match, suggestion: expandContraction(match) });
+  }
+  return hits;
+}
+
+export { VOICE_MASK, contractText, findContracted, findUncontracted };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sonordev/contracts",
-  "version": "1.0.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 signing and portfolio metrics. Pure functions, no dependencies.",
+  "version": "2.1.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 and the house voice's contraction rule. Pure functions, no dependencies.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -30,6 +30,21 @@
       "import": "./dist/slots.mjs",
       "require": "./dist/slots.js"
     },
+    "./slot-content": {
+      "types": "./dist/slot-content.d.ts",
+      "import": "./dist/slot-content.mjs",
+      "require": "./dist/slot-content.js"
+    },
+    "./site-cache": {
+      "types": "./dist/site-cache.d.ts",
+      "import": "./dist/site-cache.mjs",
+      "require": "./dist/site-cache.js"
+    },
+    "./site-edit": {
+      "types": "./dist/site-edit.d.ts",
+      "import": "./dist/site-edit.mjs",
+      "require": "./dist/site-edit.js"
+    },
     "./website": {
       "types": "./dist/website.d.ts",
       "import": "./dist/website.mjs",
@@ -65,6 +80,11 @@
       "import": "./dist/portfolio.mjs",
       "require": "./dist/portfolio.js"
     },
+    "./voice": {
+      "types": "./dist/voice.d.ts",
+      "import": "./dist/voice.mjs",
+      "require": "./dist/voice.js"
+    },
     "./package.json": "./package.json"
   },
   "typesVersions": {