@peaceroad/markdown-it-strong-ja 0.8.0 → 0.9.0

package/README.md

@@ -98,6 +98,14 @@ Terms used below:
 - Run: a contiguous group of the same marker (`*`, `**`, `***`, ...).
 - Line: text split by `\n`.
 
+### TL;DR
+
+- Baseline: start from plain `markdown-it` delimiter pairing.
+- Local helper path: only `*` runs with local Japanese context enter strong-ja boundary logic.
+- Mixed-text guard: `japanese-boundary-guard` additionally suppresses mixed JA/EN over-conversion.
+- Postprocess: token-only repairs run only for malformed link/reference-adjacent spans.
+
+
 ### Step 1: Build the baseline with plain `markdown-it`
 
 `markdown-it` runs first. If it can already parse a pattern (including cross-line `**...**`), that baseline structure is kept.
@@ -368,6 +376,7 @@ Supporting visuals:
 - Default: `true`
 - Set `false` to disable link/reference postprocess repairs.
 - In `mode: 'compatible'`, repairs are skipped even when this is `true`.
+- Repairs stay local to malformed link/reference-adjacent spans; valid inputs such as `[w](u) *string*  [w](u)` are left unchanged.
 
 ### `coreRulesBeforePostprocess`
 
@@ -387,7 +396,10 @@ Supporting visuals:
 
 ## Notes
 
-- Use `state.env.__strongJaTokenOpt` to override options per render.
-- Overrides are merged with plugin options, but setup-time behavior (such as rule registration/order) cannot be switched at render time.
-- This is an ESM plugin (`type: module`) and works in Node.js, browser bundlers, and VS Code extension pipelines that use `markdown-it` ESM.
+- Use `state.env.__strongJaTokenOpt` to override runtime-effective options per render.
+- Repeated `.use(...)` on the same `MarkdownIt` instance is treated as first-install-wins no-op. Create a new `MarkdownIt` instance for a different plugin option set.
+- Runtime-effective override keys are merged with plugin options, but setup-time behavior (such as rule registration/order) cannot be switched at render time and cannot be retrofitted after the first `.use(...)` on the same `MarkdownIt` instance.
+- `mode` and `postprocess` are runtime-effective via initial install or per-render override. `mditAttrs`, `patchCorePush`, and `coreRulesBeforePostprocess` are setup-time effective after the first `.use(...)` on a `MarkdownIt` instance.
+- This is an ESM plugin (`type: module`) and is tested against `markdown-it` 14.x in Node.js, browser bundlers, and VS Code extension pipelines that use `markdown-it` ESM.
+- The implementation relies on `markdown-it` internal ESM modules / core rule internals (`lib/token.mjs`, `lib/common/utils.mjs`, `ruler.__rules__`) plus a `scanDelims` prototype patch, so internal `markdown-it` changes may require plugin updates.
 - `scanDelims` patch is applied once per `MarkdownIt` prototype in the same process.

package/index.js

@@ -1,32 +1,41 @@
-import { hasCjkBreaksRule, normalizeCoreRulesBeforePostprocess, ensureCoreRuleOrder, deriveModeInfo } from './src/token-utils.js'
+import { hasCjkBreaksRule, ensureCoreRuleOrder, deriveOptionInfo } from './src/token-utils.js'
 import { patchScanDelims } from './src/token-core.js'
 import { registerTokenCompat } from './src/token-compat.js'
 import { registerTokenPostprocess } from './src/token-postprocess.js'
 
+const DEFAULT_OPTION = {
+  mditAttrs: true, // assume markdown-it-attrs integration by default
+  mode: 'japanese', // 'japanese'(->japanese-boundary-guard) | 'japanese-boundary' | 'japanese-boundary-guard' | 'aggressive' | 'compatible'
+  coreRulesBeforePostprocess: [], // e.g. ['cjk_breaks'] to keep rules ahead of postprocess
+  postprocess: true, // enable link/ref reconstruction pass
+  patchCorePush: true // keep restore-softbreaks after late cjk_breaks
+}
+
+const buildNormalizedOption = (md, option) => {
+  const opt = { ...DEFAULT_OPTION }
+  if (option) Object.assign(opt, option)
+  opt.hasCjkBreaks = hasCjkBreaksRule(md)
+  deriveOptionInfo(opt)
+  return opt
+}
+
 const mditStrongJa = (md, option) => {
-  if (option && typeof option.engine === 'string' && option.engine !== 'token') {
-    throw new Error('mditStrongJa: legacy engine was removed; use token (default)')
-  }
-  const opt = {
-    mditAttrs: true, // assume markdown-it-attrs integration by default
-    mode: 'japanese', // 'japanese'(->japanese-boundary-guard) | 'japanese-boundary' | 'japanese-boundary-guard' | 'aggressive' | 'compatible'
-    coreRulesBeforePostprocess: [], // e.g. ['cjk_breaks'] to keep rules ahead of postprocess
-    postprocess: true, // enable link/ref reconstruction pass
-    patchCorePush: true // keep restore-softbreaks after late cjk_breaks
-  }
-  if (option) Object.assign(opt, option)
-  opt.hasCjkBreaks = hasCjkBreaksRule(md)
-  deriveModeInfo(opt)
-
-  md.__strongJaTokenOpt = opt
+  if (option && typeof option.engine === 'string' && option.engine !== 'token') {
+    throw new Error('mditStrongJa: legacy engine was removed; use token (default)')
+  }
+  if (md.__strongJaTokenInstalled) {
+    return md
+  }
+  const nextOpt = buildNormalizedOption(md, option)
+  md.__strongJaTokenOpt = nextOpt
   patchScanDelims(md)
-  registerTokenCompat(md, opt)
+  registerTokenCompat(md, nextOpt)
 
-  registerTokenPostprocess(md, opt)
-  const coreRulesBeforePostprocess = normalizeCoreRulesBeforePostprocess(opt.coreRulesBeforePostprocess)
-  ensureCoreRuleOrder(md, coreRulesBeforePostprocess, 'strong_ja_token_postprocess')
+  registerTokenPostprocess(md, nextOpt)
+  ensureCoreRuleOrder(md, nextOpt.__strongJaNormalizedCoreRulesBeforePostprocess, 'strong_ja_token_postprocess')
+  md.__strongJaTokenInstalled = true
 
   return md
 }
-
-export default mditStrongJa
+
+export default mditStrongJa

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@peaceroad/markdown-it-strong-ja",
-  "description": "This is a plugin for markdown-it. It is an alternative to the standard `**` (strong)  and `*` (em) processing. It also processes strings that cannot be converted by the standard.",
-  "version": "0.8.0",
+  "description": "Extends asterisk emphasis handling for Japanese text while keeping markdown-it behavior as close as practical.",
+  "version": "0.9.0",
   "main": "index.js",
   "type": "module",
   "files": [
@@ -18,6 +18,7 @@
     "test:postprocess-fastpath": "node test/post-processing-fastpath.test.js",
     "test:postprocess-fastpath-roster": "node test/post-processing-fastpath-roster.test.js",
     "test:postprocess-flow": "node test/post-processing-flow.test.js",
+    "test:postprocess-link-helper": "node test/post-processing-link-helper.test.js",
     "test:postprocess-gate": "node test/postprocess-gate.js",
     "test:tokenonly-progress": "node test/post-processing-progress.test.js",
     "test:readme": "node test/test-readme.js",
@@ -35,13 +36,14 @@
     "markdown-it": "^14.1.0"
   },
   "devDependencies": {
-    "@peaceroad/markdown-it-cjk-breaks-mod": "^0.1.7",
-    "@peaceroad/markdown-it-hr-sandwiched-semantic-container": "^0.8.5",
-    "@peaceroad/markdown-it-renderer-image": "^0.10.0",
-    "@peaceroad/markdown-it-renderer-inline-text": "^0.6.0",
+    "@peaceroad/markdown-it-cjk-breaks-mod": "^0.1.10",
+    "@peaceroad/markdown-it-hr-sandwiched-semantic-container": "^0.11.0",
+    "@peaceroad/markdown-it-renderer-image": "^0.12.0",
+    "@peaceroad/markdown-it-renderer-inline-text": "^0.8.0",
     "markdown-it-attrs": "^4.3.1",
     "markdown-it-sub": "^2.0.0",
     "markdown-it-sup": "^2.0.0",
     "p7d-markdown-it-p-captions": "^0.21.0"
   }
 }
+

package/src/token-compat.js

@@ -4,9 +4,8 @@ import {
   isJapaneseChar,
   hasCjkBreaksRule,
   isCjkBreaksRuleName,
-  deriveModeInfo,
-  MODE_FLAG_COMPATIBLE,
   getRuntimeOpt,
+  hasRuntimeOverride,
   moveRuleAfter
 } from './token-utils.js'
 
@@ -27,16 +26,16 @@ const trimTrailingSpaceTab = (text) => {
   return end === text.length ? text : text.slice(0, end)
 }
 
+const getStateSource = (state) => {
+  return state && typeof state.src === 'string' ? state.src : ''
+}
+
 const registerTokenCompat = (md, baseOpt) => {
-  const baseModeFlags = typeof baseOpt.__strongJaModeFlags === 'number'
-    ? baseOpt.__strongJaModeFlags
-    : deriveModeInfo(baseOpt).__strongJaModeFlags
-  const baseCompatible = (baseModeFlags & MODE_FLAG_COMPATIBLE) !== 0
   const isCompatibleMode = (state) => {
     const override = state && state.env && state.env.__strongJaTokenOpt
-    if (!override) return baseCompatible
+    if (!hasRuntimeOverride(override)) return baseOpt.__strongJaIsCompatibleMode === true
     const opt = getRuntimeOpt(state, baseOpt)
-    return (opt.__strongJaModeFlags & MODE_FLAG_COMPATIBLE) !== 0
+    return opt.__strongJaIsCompatibleMode === true
   }
 
   let hasTextJoinRule = false
@@ -88,6 +87,8 @@ const registerTokenCompat = (md, baseOpt) => {
     const normalizeSoftbreakSpacing = (state) => {
       if (isCompatibleMode(state)) return
       if (!state) return
+      const src = getStateSource(state)
+      if (!src || src.indexOf('\n') === -1) return
       if (baseOpt.hasCjkBreaks !== true && state.md) {
         baseOpt.hasCjkBreaks = hasCjkBreaksRule(state.md)
       }
@@ -170,11 +171,8 @@ const registerTokenCompat = (md, baseOpt) => {
   const restoreSoftbreaksAfterCjk = (state) => {
     if (isCompatibleMode(state)) return
     if (!state) return
-    const overrideOpt = state.env && state.env.__strongJaTokenOpt
-    if (overrideOpt) {
-      const opt = getRuntimeOpt(state, baseOpt)
-      if (opt.mditAttrs !== false) return
-    }
+    const src = getStateSource(state)
+    if (!src || src.indexOf('\n') === -1 || src.indexOf('{') === -1) return
     if (!state.md || state.md.__strongJaRestoreSoftbreaksForAttrs !== true) return
     if (baseOpt.hasCjkBreaks !== true && state.md) {
       baseOpt.hasCjkBreaks = hasCjkBreaksRule(state.md)
@@ -245,11 +243,8 @@ const registerTokenCompat = (md, baseOpt) => {
     md.core.ruler.before('linkify', 'strong_ja_token_pre_attrs', (state) => {
       if (isCompatibleMode(state)) return
       if (!state || !state.tokens) return
-      const overrideOpt = state.env && state.env.__strongJaTokenOpt
-      if (overrideOpt) {
-        const opt = getRuntimeOpt(state, baseOpt)
-        if (opt.mditAttrs === false) return
-      }
+      const src = getStateSource(state)
+      if (!src || src.indexOf('{') === -1 || src.indexOf('}') === -1) return
       for (let i = 0; i < state.tokens.length; i++) {
         const token = state.tokens[i]
         if (!token || token.type !== 'inline' || !token.children || token.children.length === 0) continue