@hia-doc/renderer-html 0.1.7 → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/source-lines.d.ts
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
* @lang zh-CN 转义授权正文并逐行编号;独立页使用L锚点,内联避免重复DOM id。
|
|
8
8
|
* @lang en Escapes/ numbers authorized text by line; standalone pages use L anchors while inline previews avoid duplicate DOM IDs.
|
|
9
9
|
* @param content <lang><zh-CN>owner已限长的源码片段。</zh-CN><en>Source excerpt already bounded by its owner.</en></lang>
|
|
10
|
-
* @param startLine <lang><zh-CN
|
|
10
|
+
* @param startLine <lang><zh-CN>片段的一基起始行;无效运行时值回退到1,绝不插入原始行号文本。</zh-CN><en>One-based first line; invalid runtime values fall back to one and never insert raw position text.</en></lang>
|
|
11
11
|
* @param anchors <lang><zh-CN>仅独立页生成L行id。</zh-CN><en>Only standalone pages emit L-line IDs.</en></lang>
|
|
12
12
|
* @returns <lang><zh-CN>仅span/a与转义文本,无脚本。</zh-CN><en>Spans/anchors and escaped text only, without scripts.</en></lang>
|
|
13
13
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"source-lines.d.ts","sourceRoot":"","sources":["../src/source-lines.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,OAAO,UAAQ,GAAG,MAAM,
|
|
1
|
+
{"version":3,"file":"source-lines.d.ts","sourceRoot":"","sources":["../src/source-lines.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,OAAO,UAAQ,GAAG,MAAM,CAWzF;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAErG"}
|
package/dist/source-lines.js
CHANGED
|
@@ -9,15 +9,17 @@ const LINE_STYLE = ".hia-source-code-line{display:block;min-width:max-content}.h
|
|
|
9
9
|
* @lang zh-CN 转义授权正文并逐行编号;独立页使用L锚点,内联避免重复DOM id。
|
|
10
10
|
* @lang en Escapes/ numbers authorized text by line; standalone pages use L anchors while inline previews avoid duplicate DOM IDs.
|
|
11
11
|
* @param content <lang><zh-CN>owner已限长的源码片段。</zh-CN><en>Source excerpt already bounded by its owner.</en></lang>
|
|
12
|
-
* @param startLine <lang><zh-CN
|
|
12
|
+
* @param startLine <lang><zh-CN>片段的一基起始行;无效运行时值回退到1,绝不插入原始行号文本。</zh-CN><en>One-based first line; invalid runtime values fall back to one and never insert raw position text.</en></lang>
|
|
13
13
|
* @param anchors <lang><zh-CN>仅独立页生成L行id。</zh-CN><en>Only standalone pages emit L-line IDs.</en></lang>
|
|
14
14
|
* @returns <lang><zh-CN>仅span/a与转义文本,无脚本。</zh-CN><en>Spans/anchors and escaped text only, without scripts.</en></lang>
|
|
15
15
|
*/
|
|
16
16
|
export function renderSourceLines(content, startLine = 1, anchors = false) {
|
|
17
|
+
// <lang><zh-CN>JS调用者可能绕过TS类型;只允许正安全整数进入HTML数字位置,拒绝把位置解释成属性。</zh-CN><en>JS callers can bypass TS types; admit only positive safe integers into HTML number positions, never interpreting positions as attributes.</en></lang>
|
|
18
|
+
const firstLine = Number.isSafeInteger(startLine) && startLine > 0 ? startLine : 1;
|
|
17
19
|
// <lang><zh-CN>数组只覆盖有界片段,不读取其它源码;编号只来自数值,正文永远转义。</zh-CN><en>The array covers the bounded excerpt only without other source reads; numbers derive from numeric positions and bodies are always escaped.</en></lang>
|
|
18
20
|
return content.split(/\r?\n/u).map((text, index) => {
|
|
19
21
|
// <lang><zh-CN>行号来自片段原始位置;固定行号列不改变源码缩进,标签仅在独立页可点击。</zh-CN><en>Numbers follow original excerpt positions; the fixed gutter preserves code indentation and is clickable only on standalone pages.</en></lang>
|
|
20
|
-
const number =
|
|
22
|
+
const number = firstLine + index;
|
|
21
23
|
const style = "display:inline-block;min-width:3ch;margin-inline-end:1.25rem;text-align:right;user-select:none";
|
|
22
24
|
const label = anchors ? `<a class="hia-source-line-number" href="#L${number}" aria-label="L${number}" style="${style}">${number}</a>` : `<span class="hia-source-line-number" aria-hidden="true" style="${style}">${number}</span>`;
|
|
23
25
|
return `<span class="hia-source-code-line" data-hia-source-line-number="${number}"${anchors ? ` id="L${number}" tabindex="-1"` : ""} style="display:block;min-width:max-content">${label}${escape(text)}</span>`;
|
package/dist/source-lines.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"source-lines.js","sourceRoot":"","sources":["../src/source-lines.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yIAAyI;AACzI,MAAM,UAAU,GAAG,8XAA8X,CAAC;AAElZ;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,SAAS,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK;IAC/E,mNAAmN;IACnN,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACjD,4MAA4M;QAC5M,MAAM,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;QACjC,MAAM,KAAK,GAAG,gGAAgG,CAAC;QAC/G,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,6CAA6C,MAAM,kBAAkB,MAAM,YAAY,KAAK,KAAK,MAAM,MAAM,CAAC,CAAC,CAAC,kEAAkE,KAAK,KAAK,MAAM,SAAS,CAAC;QACpO,OAAO,mEAAmE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,iBAAiB,CAAC,CAAC,CAAC,EAAE,gDAAgD,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;IACnN,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,UAAkB,EAAE,SAAiB;IAC3F,OAAO,sSAAsS,MAAM,CAAC,UAAU,CAAC,uHAAuH,UAAU,qTAAqT,MAAM,CAAC,UAAU,CAAC,yDAAyD,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,oCAAoC,CAAC;AACl5B,CAAC;AAED,mIAAmI;AACnI,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAE,CAAC,CAAC;AAC1I,CAAC"}
|
|
1
|
+
{"version":3,"file":"source-lines.js","sourceRoot":"","sources":["../src/source-lines.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yIAAyI;AACzI,MAAM,UAAU,GAAG,8XAA8X,CAAC;AAElZ;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,SAAS,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK;IAC/E,6NAA6N;IAC7N,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,mNAAmN;IACnN,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACjD,4MAA4M;QAC5M,MAAM,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;QACjC,MAAM,KAAK,GAAG,gGAAgG,CAAC;QAC/G,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,6CAA6C,MAAM,kBAAkB,MAAM,YAAY,KAAK,KAAK,MAAM,MAAM,CAAC,CAAC,CAAC,kEAAkE,KAAK,KAAK,MAAM,SAAS,CAAC;QACpO,OAAO,mEAAmE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,iBAAiB,CAAC,CAAC,CAAC,EAAE,gDAAgD,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;IACnN,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,UAAkB,EAAE,SAAiB;IAC3F,OAAO,sSAAsS,MAAM,CAAC,UAAU,CAAC,uHAAuH,UAAU,qTAAqT,MAAM,CAAC,UAAU,CAAC,yDAAyD,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,oCAAoC,CAAC;AACl5B,CAAC;AAED,mIAAmI;AACnI,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAE,CAAC,CAAC;AAC1I,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@hia-doc/renderer-html",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.8",
|
|
4
4
|
"description": "Minimal HTML renderer for HIA documents.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -30,8 +30,8 @@
|
|
|
30
30
|
},
|
|
31
31
|
"dependencies": {
|
|
32
32
|
"@hia-doc/core": "0.1.2",
|
|
33
|
-
"@hia-doc/
|
|
34
|
-
"@hia-doc/
|
|
33
|
+
"@hia-doc/theme-default": "0.1.4",
|
|
34
|
+
"@hia-doc/source-linkage": "0.1.1"
|
|
35
35
|
},
|
|
36
36
|
"sideEffects": false,
|
|
37
37
|
"scripts": {
|