@ai-matrx/content-ir 0.18.3 → 0.18.4

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.18.4
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/content-ir-core/v0.18.3..npm/content-ir-core/v0.18.4 -- apps/shared/content-ir-core`).
+No source changes intended and no consumer action required.
+
+## Unreleased
+
+**`/source`: THE escaped-bracket rule** (verify-RC-B4 R3-2). `\[ … \]` is a
+display-math island only when its content is real TeX — a command, `^ { } =
+< > +`, or a subscript on a letter — and the `\[` is not an index on an
+identifier. Everything else is CommonMark's escaped brackets and stays text:
+citations `\[1\]`, dates `\[2026-09-25\]`, task boxes `- \[x\]`, `arr\[i\]`,
+editorial `\[was\]`, placeholders `\[site name\]`. New export
+`isEscapedBracketMath(content, before)`; the tokenizer asks it. Shared vectors:
+`__tests__/fixtures/escaped-bracket-vectors.json` (7 of 11 red before).
+No Python reader draws `\[ \]` math today (matrx-ai has no bracket-math
+detector), so the vectors are the contract for any future twin.
+- Consumer action: the renderer's math normalizer and the editor ask
+  `isEscapedBracketMath` instead of their own bracket rules (matrx-frontend
+  `components/markdown-core/math-normalizer.ts`).
+
 ## 0.18.3
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/index.cjs

@@ -5774,6 +5774,12 @@ function singleDollarMathEnd(text, open, limit = text.length) {
   const content = text.slice(open + 1, close);
   return isSingleDollarMath(content, text[close + 1]) ? close + 1 : -1;
 }
+var BRACKET_TEX_SIGNAL = /\\[A-Za-z]+|[\^{}=<>+]|_\{|(?:^|[^A-Za-z0-9])[A-Za-z]_[A-Za-z0-9](?![A-Za-z0-9])/;
+function isEscapedBracketMath(content, before) {
+  if (!content.trim()) return false;
+  if (before !== void 0 && /[A-Za-z0-9_)\]]/.test(before)) return false;
+  return BRACKET_TEX_SIGNAL.test(content);
+}
 
 // source/xml-tag.ts
 var XML_NAME_START = /[A-Za-z_]/;
@@ -6830,7 +6836,8 @@ var Tokenizer = class {
         const nextCh = text[i + 1];
         if (nextCh === "(" || nextCh === "[") {
           const close = within(nextCh === "(" ? "\\)" : "\\]", i + 2);
-          if (close !== -1) {
+          const isMath = close !== -1 && (nextCh === "(" || isEscapedBracketMath(text.slice(i + 2, close), i > 0 ? text[i - 1] : void 0));
+          if (close !== -1 && isMath) {
             inlines.push(this.island("math_inline", i, close + 2, true, { delimiter: nextCh === "(" ? "\\(" : "\\[" }));
             i = close + 2;
             continue;
@@ -7440,6 +7447,7 @@ exports.isCanonicalBlockIR = isCanonicalBlockIR;
 exports.isDirectiveClass = isDirectiveClass;
 exports.isDuplicateBlockSlug = isDuplicateBlockSlug;
 exports.isEmptyResidue = isEmptyResidue;
+exports.isEscapedBracketMath = isEscapedBracketMath;
 exports.isIrEnvelopeCache = isIrEnvelopeCache;
 exports.isJsonAnyField = isJsonAnyField;
 exports.isKindDirective = isKindDirective;