@hia-doc/renderer-html 0.1.8 → 1.0.0-rc.1
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/README.md +243 -0
- package/dist/index.d.ts +1623 -126
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +829 -159
- package/dist/index.js.map +1 -1
- package/dist/information-architecture.d.ts +284 -20
- package/dist/information-architecture.d.ts.map +1 -1
- package/dist/information-architecture.js +42 -15
- package/dist/information-architecture.js.map +1 -1
- package/dist/portal-ui-locale.d.ts +108 -20
- package/dist/portal-ui-locale.d.ts.map +1 -1
- package/dist/portal-ui-locale.js +103 -27
- package/dist/portal-ui-locale.js.map +1 -1
- package/dist/presentation-profile.d.ts +176 -16
- package/dist/presentation-profile.d.ts.map +1 -1
- package/dist/presentation-profile.js +40 -14
- package/dist/presentation-profile.js.map +1 -1
- package/dist/route-history.d.ts +193 -0
- package/dist/route-history.d.ts.map +1 -0
- package/dist/route-history.js +246 -0
- package/dist/route-history.js.map +1 -0
- package/dist/site-chrome.d.ts +173 -0
- package/dist/site-chrome.d.ts.map +1 -0
- package/dist/site-chrome.js +187 -0
- package/dist/site-chrome.js.map +1 -0
- package/dist/site-navigation-chrome.d.ts +36 -0
- package/dist/site-navigation-chrome.d.ts.map +1 -0
- package/dist/site-navigation-chrome.js +430 -0
- package/dist/site-navigation-chrome.js.map +1 -0
- package/dist/site-navigation.d.ts +175 -0
- package/dist/site-navigation.d.ts.map +1 -0
- package/dist/site-navigation.js +176 -0
- package/dist/site-navigation.js.map +1 -0
- package/dist/site-reading.d.ts +171 -0
- package/dist/site-reading.d.ts.map +1 -0
- package/dist/site-reading.js +534 -0
- package/dist/site-reading.js.map +1 -0
- package/dist/source-lines.d.ts +2 -1
- package/dist/source-lines.d.ts.map +1 -1
- package/dist/source-lines.js +11 -7
- package/dist/source-lines.js.map +1 -1
- package/dist/theme-assets.d.ts +12 -3
- package/dist/theme-assets.d.ts.map +1 -1
- package/dist/theme-assets.js.map +1 -1
- package/package.json +10 -5
|
@@ -0,0 +1,534 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @lang zh-CN 仅在导航采用页面实际使用的双语阅读消息,供owner完整性评估共享。
|
|
3
|
+
* @lang en Bilingual reading messages actually used by navigation-adopted pages, shared with owner completeness evaluation.
|
|
4
|
+
*/
|
|
5
|
+
export const SITE_READING_MESSAGES = {
|
|
6
|
+
"site.reading.directory": ["文档目录", "Documentation directory"],
|
|
7
|
+
"site.reading.api": ["接口参考", "API reference"],
|
|
8
|
+
"site.reading.outline": ["本页内容", "On this page"],
|
|
9
|
+
"site.reading.search": ["搜索文档", "Search documentation"],
|
|
10
|
+
"site.reading.settings": ["阅读设置", "Reading settings"],
|
|
11
|
+
"site.reading.close": ["关闭", "Close"],
|
|
12
|
+
"site.reading.scheme": ["外观", "Appearance"],
|
|
13
|
+
"site.reading.light": ["浅色", "Light"],
|
|
14
|
+
"site.reading.dark": ["深色", "Dark"],
|
|
15
|
+
"site.reading.system": ["跟随系统", "System"],
|
|
16
|
+
"site.reading.wrap": ["代码长行", "Long code lines"],
|
|
17
|
+
"site.reading.scroll": ["块内滚动", "Scroll inside blocks"],
|
|
18
|
+
"site.reading.wrapped": ["自动换行", "Wrap lines"],
|
|
19
|
+
"site.reading.lines": ["源码行号", "Source line numbers"],
|
|
20
|
+
"site.reading.show": ["显示", "Show"],
|
|
21
|
+
"site.reading.hide": ["隐藏", "Hide"],
|
|
22
|
+
"site.reading.scope": ["设置仅影响当前页面,不保存偏好。", "Settings affect this page only and are not saved."],
|
|
23
|
+
"site.reading.searchscope": ["仅检索当前生成参考站,不向外发送查询。", "Search only this generated reference site, without sending queries elsewhere."],
|
|
24
|
+
"site.reading.loading": ["正在准备检索索引…", "Preparing the search index…"],
|
|
25
|
+
"site.reading.empty": ["没有匹配内容,请换一个关键词或从文档目录继续。", "No matches. Try another term or continue from the directory."],
|
|
26
|
+
"site.reading.error": ["检索索引暂不可用,请从文档目录继续。", "The search index is unavailable. Continue from the directory."],
|
|
27
|
+
"site.reading.source": ["源码阅读", "Source reading"],
|
|
28
|
+
"site.reading.boundary": ["公开源码片段,定位精度以来源证据为准。", "Public source excerpt. Position precision depends on the source evidence."],
|
|
29
|
+
"site.reading.return": ["返回接口", "Return to the API"],
|
|
30
|
+
"site.reading.snippet": ["源码片段", "Source excerpt"],
|
|
31
|
+
"site.reading.copy": ["复制", "Copy"],
|
|
32
|
+
"site.reading.copied": ["已复制", "Copied"],
|
|
33
|
+
"site.reading.manualcopy": ["请手动选择复制", "Select and copy manually"],
|
|
34
|
+
"site.reading.host": ["需要支持文件定位的集成宿主", "Requires an integration host that supports file navigation"],
|
|
35
|
+
"site.field.remarks": ["备注", "Remarks"],
|
|
36
|
+
"site.field.parameters": ["参数", "Parameters"],
|
|
37
|
+
"site.field.typeparameters": ["类型参数", "Type parameters"],
|
|
38
|
+
"site.field.returns": ["返回值", "Returns"],
|
|
39
|
+
"site.field.exceptions": ["异常", "Exceptions"],
|
|
40
|
+
"site.field.name": ["名称", "Name"],
|
|
41
|
+
"site.field.description": ["说明", "Description"],
|
|
42
|
+
"site.field.command.summary": ["用途摘要", "Purpose summary"],
|
|
43
|
+
"site.field.command.purpose": ["用途", "Purpose"],
|
|
44
|
+
"site.field.command.paths": ["路径基准", "Path bases"],
|
|
45
|
+
"site.field.command.effects": ["输出与副作用", "Outputs and effects"],
|
|
46
|
+
"site.field.command.offline": ["离线说明", "Offline reference"],
|
|
47
|
+
"site.field.command.parsing": ["参数解析规则", "Argument parsing rules"],
|
|
48
|
+
"site.field.command.configusage": ["配置文件用法", "Configuration usage"],
|
|
49
|
+
"site.field.command.configoverrides": ["配置覆盖规则", "Configuration overrides"],
|
|
50
|
+
"site.field.command.directonly": ["直接输入模式", "Direct-input mode"],
|
|
51
|
+
"site.field.command.versionidentity": ["版本输出身份", "Version output identity"],
|
|
52
|
+
"site.field.command.displayversion": ["输出版本值", "Displayed version value"],
|
|
53
|
+
"site.field.command.defaults": ["默认行为", "Default behavior"],
|
|
54
|
+
"site.field.command.metavar": ["参数值占位符", "Parameter value placeholder"],
|
|
55
|
+
"site.field.command.package": ["所属文档包", "Owning documentation package"],
|
|
56
|
+
"site.field.command.packageversion": ["文档包版本", "Documentation package version"],
|
|
57
|
+
"site.field.command.aliases": ["命令别名", "Command aliases"],
|
|
58
|
+
"site.field.command.helporder": ["帮助处理顺序", "Help precedence"],
|
|
59
|
+
"site.field.command.unknownoptions": ["未知选项处理", "Unknown-option handling"],
|
|
60
|
+
"site.field.command.filesystem": ["文件系统操作", "Filesystem effects"],
|
|
61
|
+
"site.field.command.network": ["网络访问", "Network access"],
|
|
62
|
+
"site.field.command.examples": ["调用示例", "Invocation example"],
|
|
63
|
+
"site.field.command.exitcode": ["退出码", "Exit code"],
|
|
64
|
+
"site.field.command.exitsummary": ["退出结果摘要", "Exit-result summary"],
|
|
65
|
+
"site.field.command.exitdescription": ["退出结果说明", "Exit-result description"],
|
|
66
|
+
"site.field.command.choices": ["允许值", "Allowed value"],
|
|
67
|
+
"site.field.command.defaultconditions": ["默认值适用条件", "Default-value condition"],
|
|
68
|
+
"site.field.command.defaultkind": ["默认值规则类型", "Default-rule kind"],
|
|
69
|
+
"site.field.command.defaultvalue": ["默认值", "Default value"],
|
|
70
|
+
"site.field.command.multiple": ["多值规则", "Multiple-value rule"],
|
|
71
|
+
"site.field.command.parametername": ["参数名称", "Parameter name"],
|
|
72
|
+
"site.field.command.required": ["必填规则", "Requiredness"],
|
|
73
|
+
"site.field.command.short": ["短选项名称", "Short-option name"],
|
|
74
|
+
"site.field.command.valuetype": ["参数值类型", "Parameter value type"],
|
|
75
|
+
"site.field.command.prerequisites": ["运行前置条件", "Runtime prerequisites"],
|
|
76
|
+
"site.field.command.section": ["所属章节", "Reference section"],
|
|
77
|
+
"site.kind.command": ["命令", "Command"],
|
|
78
|
+
"site.kind.command.group": ["命令组", "Command group"],
|
|
79
|
+
"site.kind.command.option": ["命名选项", "Named option"],
|
|
80
|
+
"site.kind.command.argument": ["位置参数", "Positional argument"],
|
|
81
|
+
"site.kind.constant": ["常量", "Constant"],
|
|
82
|
+
"site.kind.function": ["函数", "Function"],
|
|
83
|
+
"site.kind.member": ["成员", "Member"],
|
|
84
|
+
"site.kind.file": ["文件", "File"],
|
|
85
|
+
"site.kind.dotnet.method": ["方法", "Method"],
|
|
86
|
+
"site.kind.dotnet.type": ["类型", "Type"],
|
|
87
|
+
"site.kind.css.component.style": ["组件样式", "Component style"],
|
|
88
|
+
"site.kind.css.custom.property": ["自定义属性", "Custom property"],
|
|
89
|
+
"site.kind.css.layer": ["级联层", "Cascade layer"],
|
|
90
|
+
"site.kind.css.modifier": ["样式修饰", "Style modifier"],
|
|
91
|
+
"site.kind.css.selector": ["选择器", "Selector"],
|
|
92
|
+
"site.kind.design.token": ["设计令牌", "Design token"],
|
|
93
|
+
"site.kind.html.attribute": ["属性", "Attribute"],
|
|
94
|
+
"site.kind.html.component": ["组件", "Component"],
|
|
95
|
+
"site.kind.html.event": ["事件", "Event"],
|
|
96
|
+
"site.kind.html.slot": ["插槽", "Slot"],
|
|
97
|
+
"site.kind.html.style.hook": ["样式钩子", "Style hook"],
|
|
98
|
+
"site.kind.pug.mixin": ["混入", "Mixin"],
|
|
99
|
+
"site.kind.vue.exposed.api": ["公开接口", "Exposed API"]
|
|
100
|
+
};
|
|
101
|
+
/**
|
|
102
|
+
* @lang zh-CN 为owner生成的完整HTML附加阅读布局,不读取文件,不改写来源字节或片段。
|
|
103
|
+
* @lang en Adds reading layout to owner-generated complete HTML without reading files or rewriting source bytes or fragments.
|
|
104
|
+
* @param contents - 本次生成的完整HTML。 Complete HTML from this generation.
|
|
105
|
+
* @param file - owner生成的相对输出路径。 Owner-generated relative output path.
|
|
106
|
+
* @param locale - 已确认的界面语言,不改变正文语言。 Confirmed UI locale, independent of prose locale.
|
|
107
|
+
* @param interactive - 生成器已确认此页承载运行时交互。 The generator identified this page as the interactive runtime host.
|
|
108
|
+
* @param entries - 同次渲染公开条目,默认空上下文。 Public entries from the same render, defaulting to no context.
|
|
109
|
+
* @param customTokens - 主题owner已验证的显式颜色键,默认无覆写。 Explicit color keys validated by the theme owner, with no overrides by default.
|
|
110
|
+
* @param compactStaticText <lang><zh-CN>省略生成器自有静态消息包装,默认关闭。</zh-CN><en>Omit generator-owned static message wrappers, disabled by default.</en></lang>
|
|
111
|
+
* @returns 带阅读框架的HTML,不执行脚本或文件访问。 Reading-framed HTML, without script execution or file access.
|
|
112
|
+
*/
|
|
113
|
+
export function renderSiteReading(contents, file, locale, interactive, entries = [], customTokens = [], compactStaticText = false) {
|
|
114
|
+
// <lang><zh-CN>路径深度只来自生成器文件名,消息进入HTML前统一转义。</zh-CN><en>Depth comes only from generated file names; all messages are escaped before entering HTML.</en></lang>
|
|
115
|
+
const prefix = "../".repeat(file.split("/").length - 1);
|
|
116
|
+
const text = (id) => !interactive && compactStaticText
|
|
117
|
+
? escape(SITE_READING_MESSAGES[id][locale === "en" ? 1 : 0])
|
|
118
|
+
: `<span${interactive ? ` data-hia-ui-message="${id}"` : ""}>${escape(SITE_READING_MESSAGES[id][locale === "en" ? 1 : 0])}</span>`;
|
|
119
|
+
const source = file.startsWith("sources/");
|
|
120
|
+
// <lang><zh-CN>交互替换区域只包正文,移动目录和main地标留在外层,切换条目时不被innerHTML移除。</zh-CN><en>Keep only prose inside the replaceable region, leaving the mobile outline and main landmark outside entry innerHTML replacements.</en></lang>
|
|
121
|
+
if (interactive)
|
|
122
|
+
contents = contents.replace(/<main\b([^>]*?)\sdata-hia-project-content([^>]*>)([\s\S]*?)<\/main>/u, '<main$1$2<div data-hia-project-content>$3</div></main>');
|
|
123
|
+
// <lang><zh-CN>仅连接主题owner已经校验的语义变量,不把调用者颜色字符串重新拼入CSS。</zh-CN><en>Connect only semantic variables already validated by the theme owner, never interpolating caller color strings into CSS again.</en></lang>
|
|
124
|
+
const aliases = {
|
|
125
|
+
canvas: "--hia-bg:var(--hia-color-canvas)",
|
|
126
|
+
surface: "--hia-surface:var(--hia-color-surface)",
|
|
127
|
+
border: "--hia-border:var(--hia-color-border)",
|
|
128
|
+
text: "--hia-text:var(--hia-color-text)",
|
|
129
|
+
textMuted: "--hia-muted:var(--hia-color-text-muted)",
|
|
130
|
+
accentSoft: "--hia-accent-soft:var(--hia-color-accent-soft)",
|
|
131
|
+
accentContrast: "--hia-site-brand-contrast:var(--hia-color-accent-contrast)"
|
|
132
|
+
};
|
|
133
|
+
const declarations = customTokens.filter(token => Object.hasOwn(aliases, token)).map(token => aliases[token]).join(";");
|
|
134
|
+
const codeBackground = customTokens.includes("codeBackground") ? "[data-hia-site-navigation] .hia-signature,[data-hia-site-navigation] .hia-source-code{background:var(--hia-code-bg)}" : "";
|
|
135
|
+
if (declarations || codeBackground)
|
|
136
|
+
contents = contents.replace("</head>", `<style>:root[data-hia-site-navigation][data-hia-scheme]{${declarations}}${codeBackground}</style></head>`);
|
|
137
|
+
let sourceMobileDirectory = "";
|
|
138
|
+
// <lang><zh-CN>可执行页在解析正文前完成断点折叠,避免原生片段先按展开目录定位后再跳动;禁脚本时保留原生展开目录。</zh-CN><en>Executable pages settle breakpoint disclosure before prose parsing, avoiding fragment positioning against an expanded directory followed by a shift; script-free pages retain native open navigation.</en></lang>
|
|
139
|
+
const directory = (body) => `<details class="hia-site-directory" id="hia-site-directory" open><summary>${text("site.reading.directory")}</summary>${body}</details>${interactive ? '<script data-hia-directory-init>document.getElementById("hia-site-directory").open=!matchMedia("(max-width:800px)").matches;</script>' : ""}`;
|
|
140
|
+
if (source) {
|
|
141
|
+
// <lang><zh-CN>只为同一公开资产列出真实接口,源码页继续由CSP禁止脚本和外部读取。</zh-CN><en>List actual APIs for the same public asset only; the source-page CSP continues blocking scripts and external reads.</en></lang>
|
|
142
|
+
const owners = entries.filter(entry => entry.sourceUrl?.split("#")[0] === file);
|
|
143
|
+
const links = owners.map(entry => `<a href="${escape(prefix + entry.page)}">${escape(entry.name)}</a>`).join("");
|
|
144
|
+
const sidebar = `<aside class="hia-sidebar"><nav>${links}<a href="${prefix}index.html">${text("site.reading.return")}</a></nav></aside>`;
|
|
145
|
+
// <lang><zh-CN>来源页只复制无控件链接,手机原生折叠默认关闭,桌面目录保持可读;没有重复的表单ID。</zh-CN><en>Copy only control-free source links so native mobile navigation starts closed while desktop context stays readable, without duplicate form IDs.</en></lang>
|
|
146
|
+
sourceMobileDirectory = `<details class="hia-site-source-mobile-directory"><summary>${text("site.reading.directory")}</summary>${sidebar}</details>`;
|
|
147
|
+
contents = contents.replace("<html ", '<html data-hia-skin="portal.classic" data-hia-scheme="system" ')
|
|
148
|
+
.replace(/<title>([\s\S]*?) · Source \/ 源码<\/title>/u, (_, path) => `<title>${path} · ${escape(SITE_READING_MESSAGES["site.reading.source"][locale === "en" ? 1 : 0])}</title>`)
|
|
149
|
+
.replace(/<h1>[\s\S]*?<\/h1>/u, title => `<h1>${text("site.reading.source")}</h1><p class="hia-site-source-path">${title.replace(/<\/?h1>/gu, "").replace(/ · Source \/ 源码$/u, "")}</p><section id="hia-source-status" data-hia-source-boundary class="hia-site-notice">${text("site.reading.boundary")}</section><h2 id="hia-source-snippet">${text("site.reading.snippet")}</h2>`)
|
|
150
|
+
.replace(/<main\b/u, `<div class="hia-shell hia-project-shell hia-site-source-shell">${directory(sidebar)}<main class="hia-main hia-project-main"`)
|
|
151
|
+
.replace("</main>", "</main></div>");
|
|
152
|
+
}
|
|
153
|
+
else {
|
|
154
|
+
// <lang><zh-CN>目录保持单一DOM实例,避免复制语言控件ID或让惰性树出现两套状态。</zh-CN><en>Keep one directory DOM instance, avoiding duplicate locale-control IDs and divergent lazy-tree state.</en></lang>
|
|
155
|
+
contents = contents.replace(/<aside class="hia-sidebar">[\s\S]*?<\/aside>/u, sidebar => directory(sidebar.replace(/<h1>([\s\S]*?)<\/h1>/u, '<p class="hia-site-project-name">$1</p>')));
|
|
156
|
+
// <lang><zh-CN>静态索引及交互初始页以实际主内容标题为一级标题,接口片段自带一级标题。</zh-CN><en>Static indexes and the initial interactive page use the actual main-content heading as primary; API fragments already supply their own primary heading.</en></lang>
|
|
157
|
+
const main = /<main\b[^>]*>([\s\S]*?)<\/main>/u.exec(contents);
|
|
158
|
+
if (main && !main[1].includes("<h1"))
|
|
159
|
+
contents = contents.replace(main[0], main[0].replace(/<h2>([\s\S]*?)<\/h2>/u, "<h1>$1</h1>"));
|
|
160
|
+
}
|
|
161
|
+
// <lang><zh-CN>目录只指向本页真实小节,静态页和源码页在禁用脚本时仍可导航。</zh-CN><en>Outlines target actual sections only, retaining navigation on static/source pages without scripts.</en></lang>
|
|
162
|
+
const sections = [...contents.matchAll(/<(?:section|details)\b[^>]*id="([^"]+)"[^>]*data-hia-(?:topic-section|reading-section)="([^"]+)"[^>]*>[\s\S]*?<(?:h3|summary)[^>]*>([\s\S]*?)<\/(?:h3|summary)>/gu)];
|
|
163
|
+
const outlineLinks = source
|
|
164
|
+
? `<a href="#hia-source-status">${text("site.reading.boundary")}</a><a href="#hia-source-snippet">${text("site.reading.snippet")}</a>`
|
|
165
|
+
: sections.map(match => `<a href="#${match[1]}">${match[3]}</a>`).join("");
|
|
166
|
+
const outline = `<nav data-hia-reading-outline>${outlineLinks}</nav>`;
|
|
167
|
+
// <lang><zh-CN>已确认的恢复页用普通小节链接继续阅读,空页内目录不增加无内容控件;其它页面及有内容目录保持。</zh-CN><en>The confirmed recovery page continues through ordinary section links, omitting an empty outline control while retaining other pages and populated outlines.</en></lang>
|
|
168
|
+
const mobile = compactStaticText && !outlineLinks && contents.includes('<p data-hia-route-status role="status">')
|
|
169
|
+
? ""
|
|
170
|
+
: `<details class="hia-site-mobile-outline"><summary>${text("site.reading.outline")}</summary>${outline}</details>`;
|
|
171
|
+
contents = contents.replace(/(<main\b[^>]*>)/u, `$1${sourceMobileDirectory}${mobile}`).replace("</main>", `</main><aside class="hia-site-toc"><strong>${text("site.reading.outline")}</strong>${outline}</aside>`);
|
|
172
|
+
if (!interactive)
|
|
173
|
+
contents = contents.replace(/<button\b([^>]*data-hia-open-request[^>]*)>/gu, `<button disabled title="${escape(SITE_READING_MESSAGES["site.reading.host"][locale === "en" ? 1 : 0])}"$1>`);
|
|
174
|
+
if (interactive) {
|
|
175
|
+
// <lang><zh-CN>增强只在可执行的交互入口附加,源码及无脚本静态输出均不新增脚本。</zh-CN><en>Add enhancement only to the executable interactive entry, never to source or no-script static output.</en></lang>
|
|
176
|
+
const config = escape(JSON.stringify(SITE_READING_MESSAGES));
|
|
177
|
+
const pages = escape(JSON.stringify(entries.map(({ id, page, localePages }) => ({ id, page, localePages }))));
|
|
178
|
+
const scheme = /data-hia-scheme="(light|dark|system)"/u.exec(contents)?.[1] ?? "system";
|
|
179
|
+
const skin = /data-hia-skin="([^"]+)"/u.exec(contents)?.[1] ?? "portal.classic";
|
|
180
|
+
contents = contents.replace("</body>", `${renderSiteReadingDialogs(text)}<script src="${prefix}assets/hia-site-reading.js" data-hia-reading-messages="${config}" data-hia-reading-pages="${pages}" data-hia-reading-initial-scheme="${scheme}" data-hia-reading-initial-skin="${skin}" defer></script></body>`);
|
|
181
|
+
}
|
|
182
|
+
return contents;
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
|
|
186
|
+
* @lang zh-CN 生成已确认的原生模态与封闭设置选项。
|
|
187
|
+
|
|
188
|
+
* @lang en Generates confirmed native dialogs and closed setting choices.
|
|
189
|
+
* @param text <lang><zh-CN>只接受已知消息身份的可信标签工厂。</zh-CN><en>Trusted label factory accepting known message identities only.</en></lang>
|
|
190
|
+
* @returns <lang><zh-CN>两个原生dialog的完整HTML。</zh-CN><en>Complete HTML for two native dialogs.</en></lang>
|
|
191
|
+
|
|
192
|
+
*/
|
|
193
|
+
export function renderSiteReadingDialogs(text) {
|
|
194
|
+
const close = `<button type="button" data-hia-reading-close>${text("site.reading.close")}</button>`;
|
|
195
|
+
const select = (name, id, options) => `<label>${text(id)}<select data-hia-reading-${name}>${options.map(([value, label]) => `<option value="${value}" data-hia-ui-message="${label}">${text(label).replace(/<[^>]*>/gu, "")}</option>`).join("")}</select></label>`;
|
|
196
|
+
return `<dialog id="hia-reading-search" aria-labelledby="hia-reading-search-title"><header><h2 id="hia-reading-search-title">${text("site.reading.search")}</h2>${close}</header><div class="hia-site-dialog-body"><label for="hia-reading-query">${text("site.reading.searchscope")}</label><input id="hia-reading-query" type="search" autofocus><div data-hia-reading-results aria-live="polite"></div><a href="#hia-site-directory" data-hia-reading-directory>${text("site.reading.directory")}</a></div></dialog><dialog id="hia-reading-settings" aria-labelledby="hia-reading-settings-title"><header><h2 id="hia-reading-settings-title">${text("site.reading.settings")}</h2>${close}</header><div class="hia-site-dialog-body">${select("scheme", "site.reading.scheme", [["light", "site.reading.light"], ["dark", "site.reading.dark"], ["system", "site.reading.system"]])}${select("wrap", "site.reading.wrap", [["scroll", "site.reading.scroll"], ["wrap", "site.reading.wrapped"]])}${select("lines", "site.reading.lines", [["show", "site.reading.show"], ["hide", "site.reading.hide"]])}<p>${text("site.reading.scope")}</p></div></dialog>`;
|
|
197
|
+
}
|
|
198
|
+
/**
|
|
199
|
+
|
|
200
|
+
* @lang zh-CN 统一转义纯文本和属性。
|
|
201
|
+
|
|
202
|
+
* @lang en Escapes plain text and attributes consistently.
|
|
203
|
+
|
|
204
|
+
*/
|
|
205
|
+
function escape(value) {
|
|
206
|
+
return value.replace(/[&<>"']/gu, character => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" })[character]);
|
|
207
|
+
}
|
|
208
|
+
/**
|
|
209
|
+
* @lang zh-CN 导航采用页面的纯阅读增强;原生dialog约束焦点,查询本地索引,设置不持久化。
|
|
210
|
+
* @lang en Read-only enhancement for navigation-adopted pages, using native modal focus, local-index search and nonpersistent settings.
|
|
211
|
+
*/
|
|
212
|
+
export const SITE_READING_SCRIPT = String.raw `/**
|
|
213
|
+
* @file
|
|
214
|
+
* @lang zh-CN 当前生成参考站的只读阅读增强,查询留在本地,偏好仅在本页生效。
|
|
215
|
+
* @lang en Read-only enhancement for this generated reference site, with local queries and page-only preferences.
|
|
216
|
+
*/
|
|
217
|
+
(() => {
|
|
218
|
+
// <lang><zh-CN>只消费本页受控消息和现有目录,状态不进入Cookie或存储。</zh-CN><en>Consume controlled page messages and the existing directory, with no cookie/storage state.</en></lang>
|
|
219
|
+
const root = document.documentElement;
|
|
220
|
+
const script = document.querySelector('[data-hia-reading-messages]');
|
|
221
|
+
const messages = JSON.parse(script.dataset.hiaReadingMessages);
|
|
222
|
+
const pages = new Map(JSON.parse(script.dataset.hiaReadingPages).map(entry => [entry.id, entry]));
|
|
223
|
+
const directory = document.querySelector('.hia-site-directory');
|
|
224
|
+
const ui = document.querySelector('[data-hia-ui-locale-control]');
|
|
225
|
+
const query = document.getElementById('hia-reading-query');
|
|
226
|
+
const results = document.querySelector('[data-hia-reading-results]');
|
|
227
|
+
const text = id => messages[id]?.[(ui?.value || root.lang) === 'zh-CN' ? 0 : 1] || id;
|
|
228
|
+
const mobile = matchMedia('(max-width:800px)');
|
|
229
|
+
const synchronizeDirectory = () => { if (directory)
|
|
230
|
+
directory.open = !mobile.matches; };
|
|
231
|
+
synchronizeDirectory();
|
|
232
|
+
mobile.addEventListener('change', synchronizeDirectory);
|
|
233
|
+
root.dataset.hiaReadingReady = 'true';
|
|
234
|
+
/**
|
|
235
|
+
* @lang zh-CN 在独立生成器已声明的同页语言目标上保留当前真实锚点;显式目标片段优先,未知片段不传播。
|
|
236
|
+
* @lang en Preserve the current real anchor on independent generators' declared same-page locale targets, honoring explicit target fragments and excluding unknown fragments.
|
|
237
|
+
*/
|
|
238
|
+
function synchronizeNativeLocaleFragments() {
|
|
239
|
+
// <lang><zh-CN>片段只用于本页ID查找,不作为选择器、HTML或代码执行。</zh-CN><en>Use the fragment only for local ID lookup, never as a selector, HTML or executable code.</en></lang>
|
|
240
|
+
let anchor;
|
|
241
|
+
try { anchor = decodeURIComponent(location.hash.slice(1)); }
|
|
242
|
+
catch { anchor = undefined; }
|
|
243
|
+
for (const link of document.querySelectorAll('[data-hia-site-language]:not([data-hia-site-hrefs]),[data-hia-site-current]')) {
|
|
244
|
+
// <lang><zh-CN>缓存原始对应页,连续切换片段时清除旧片段;交互Portal另用条目身份同步。</zh-CN><en>Cache the original counterpart so fragment changes clear stale fragments; interactive Portals use their separate entry-identity synchronizer.</en></lang>
|
|
245
|
+
const target = new URL(link.dataset.hiaSiteNativeTarget || (link.dataset.hiaSiteNativeTarget = link.getAttribute('href')), document.baseURI);
|
|
246
|
+
if (!target.hash && anchor && document.getElementById(anchor)) target.hash = location.hash;
|
|
247
|
+
link.href = target.href;
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
synchronizeNativeLocaleFragments();
|
|
251
|
+
window.addEventListener('hashchange', synchronizeNativeLocaleFragments);
|
|
252
|
+
// <lang><zh-CN>阅读设置从本页构建默认开始,不继承其它站点的持久化主题。</zh-CN><en>Start settings from this page's build default rather than another site's persisted theme.</en></lang>
|
|
253
|
+
root.dataset.hiaScheme = script.dataset.hiaReadingInitialScheme;
|
|
254
|
+
root.dataset.hiaSkin = script.dataset.hiaReadingInitialSkin;
|
|
255
|
+
document.querySelector('[data-hia-reading-scheme]').value = root.dataset.hiaScheme;
|
|
256
|
+
for (const button of document.querySelectorAll('[data-hia-reading-dialog]'))
|
|
257
|
+
button.addEventListener('click', () => {
|
|
258
|
+
const dialog = document.getElementById('hia-reading-' + button.dataset.hiaReadingDialog);
|
|
259
|
+
if (dialog && !dialog.open) {
|
|
260
|
+
dialog.showModal();
|
|
261
|
+
if (dialog.id.endsWith('search')) {
|
|
262
|
+
query.focus();
|
|
263
|
+
search();
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
});
|
|
267
|
+
for (const button of document.querySelectorAll('[data-hia-reading-close]'))
|
|
268
|
+
button.addEventListener('click', () => button.closest('dialog').close());
|
|
269
|
+
document.addEventListener('keydown', event => {
|
|
270
|
+
// <lang><zh-CN>搜索输入可能先消费Escape清空文本;显式关闭当前模态并沿原生close恢复焦点。</zh-CN><en>A search input may consume Escape to clear text first; explicitly close the current modal and retain native focus restoration.</en></lang>
|
|
271
|
+
if (event.key === 'Escape') {
|
|
272
|
+
const dialog = document.querySelector('dialog[open]');
|
|
273
|
+
if (dialog) {
|
|
274
|
+
event.preventDefault();
|
|
275
|
+
dialog.close();
|
|
276
|
+
}
|
|
277
|
+
return;
|
|
278
|
+
}
|
|
279
|
+
if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 'k') {
|
|
280
|
+
event.preventDefault();
|
|
281
|
+
const dialog = document.getElementById('hia-reading-search');
|
|
282
|
+
// <lang><zh-CN>保持单一模态,快捷键不会在设置上再叠一层检索。</zh-CN><en>Keep one modal active so the shortcut cannot stack search over settings.</en></lang>
|
|
283
|
+
if (document.querySelector('dialog[open]') && !dialog.open)
|
|
284
|
+
return;
|
|
285
|
+
if (!dialog.open)
|
|
286
|
+
dialog.showModal();
|
|
287
|
+
query.focus();
|
|
288
|
+
search();
|
|
289
|
+
}
|
|
290
|
+
});
|
|
291
|
+
/**
|
|
292
|
+
* @lang zh-CN 返回当前可见目录节点,缺少选中节点时复用首个可见控件,避免隐藏桌面摘要吞掉焦点。
|
|
293
|
+
* @lang en Return to the visible current directory node, falling back to its first visible control instead of the hidden desktop summary.
|
|
294
|
+
*/
|
|
295
|
+
function focusReadingDirectory(event) {
|
|
296
|
+
// <lang><zh-CN>取消原生片段跳转,防止随后覆盖显式焦点或丢失当前条目地址。</zh-CN><en>Cancel native fragment navigation so it cannot overwrite explicit focus or discard the current entry address.</en></lang>
|
|
297
|
+
event.preventDefault();
|
|
298
|
+
document.getElementById('hia-reading-search').close();
|
|
299
|
+
directory.open = true;
|
|
300
|
+
// <lang><zh-CN>当前真实树节点优先,回退遍历保留普通目录与独立输出的可用控件。</zh-CN><en>Prefer the actual current tree node, with visible ordinary controls supporting other directory outputs.</en></lang>
|
|
301
|
+
const current = directory.querySelector('[data-hia-project-tree] [aria-current="page"]');
|
|
302
|
+
const target = current?.getClientRects().length ? current : Array.from(directory.querySelectorAll('summary,button:not(:disabled),a[href],input:not(:disabled),select:not(:disabled)')).find(control => control.getClientRects().length);
|
|
303
|
+
target?.scrollIntoView({block:'nearest', inline:'nearest'});
|
|
304
|
+
target?.focus({preventScroll:true});
|
|
305
|
+
}
|
|
306
|
+
document.querySelector('[data-hia-reading-directory]').addEventListener('click', focusReadingDirectory);
|
|
307
|
+
for (const name of ['scheme', 'wrap', 'lines'])
|
|
308
|
+
document.querySelector('[data-hia-reading-' + name + ']').addEventListener('change', event => {
|
|
309
|
+
if (name === 'scheme')
|
|
310
|
+
root.dataset.hiaScheme = event.target.value;
|
|
311
|
+
else
|
|
312
|
+
root.dataset['hiaReading' + name[0].toUpperCase() + name.slice(1)] = event.target.value;
|
|
313
|
+
});
|
|
314
|
+
// <lang><zh-CN>检索只使用同一生成根的索引,序号防止慢响应覆盖较新的查询;失败与空结果分开。</zh-CN><en>Search only the same generated root; a sequence prevents stale responses, separating failures from empty results.</en></lang>
|
|
315
|
+
let indexPromise;
|
|
316
|
+
let sequence = 0;
|
|
317
|
+
/**
|
|
318
|
+
* @lang zh-CN 读取当前生成根的受限索引,渲染最多200个匹配;过期响应不覆盖新查询。
|
|
319
|
+
* @lang en Reads the current generated root's bounded index and renders up to 200 matches without allowing stale responses to overwrite newer queries.
|
|
320
|
+
*/
|
|
321
|
+
async function search() {
|
|
322
|
+
const current = ++sequence;
|
|
323
|
+
results.textContent = text('site.reading.loading');
|
|
324
|
+
try {
|
|
325
|
+
if (!indexPromise)
|
|
326
|
+
indexPromise = fetch(script.dataset.hiaReadingStatic || 'search/index.json', { credentials: 'omit', signal: AbortSignal.timeout(10000) }).then(response => {
|
|
327
|
+
if (!response.ok)
|
|
328
|
+
throw new Error('index');
|
|
329
|
+
return response.json();
|
|
330
|
+
}).then(value => { if (!Array.isArray(value.entries))
|
|
331
|
+
throw new Error('index'); return value.entries; });
|
|
332
|
+
const entries = await indexPromise;
|
|
333
|
+
if (current !== sequence)
|
|
334
|
+
return;
|
|
335
|
+
const value = query.value.trim().toLowerCase();
|
|
336
|
+
const matches = entries.filter(entry => String(entry.searchText || '').toLowerCase().includes(value)).slice(0, 200);
|
|
337
|
+
results.replaceChildren();
|
|
338
|
+
for (const entry of matches) {
|
|
339
|
+
const link = document.createElement('a');
|
|
340
|
+
// <lang><zh-CN>静态生成器按真实页面跳转,通用Portal继续沿原条目事件路径。</zh-CN><en>Static generators navigate to actual pages; the generic Portal retains its original entry-event path.</en></lang>
|
|
341
|
+
if (script.dataset.hiaReadingStatic) {
|
|
342
|
+
const base = new URL(script.dataset.hiaReadingBase || './', location.href);
|
|
343
|
+
const target = new URL(entry.localePages?.[root.lang] || entry.page, base);
|
|
344
|
+
if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname))
|
|
345
|
+
throw new Error('index');
|
|
346
|
+
link.href = target.href;
|
|
347
|
+
} else link.href = '#entry=' + encodeURIComponent(entry.id);
|
|
348
|
+
link.textContent = entry.name + ' · ' + entry.kind;
|
|
349
|
+
// <lang><zh-CN>选择沿用树的成功后replaceState;普通href保留复制/新窗口路径,不额外制造无法恢复的历史项。</zh-CN><en>Selection reuses the tree's post-success replaceState; ordinary hrefs retain copy/new-window paths without creating unrestorable history entries.</en></lang>
|
|
350
|
+
link.addEventListener('click', event => { document.getElementById('hia-reading-search').close(); if (!script.dataset.hiaReadingStatic) { event.preventDefault(); document.dispatchEvent(new CustomEvent('hia:site-entry', { detail: entry.id })); } });
|
|
351
|
+
results.append(link);
|
|
352
|
+
}
|
|
353
|
+
if (!matches.length)
|
|
354
|
+
results.textContent = text('site.reading.empty');
|
|
355
|
+
}
|
|
356
|
+
catch {
|
|
357
|
+
if (current === sequence) {
|
|
358
|
+
indexPromise = undefined;
|
|
359
|
+
results.textContent = text('site.reading.error');
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
query.addEventListener('input', search);
|
|
364
|
+
/**
|
|
365
|
+
* @lang zh-CN 顶部语言切换仅在实际生成对应页存在时携带当前条目;首页恢复原始目标,缺对应语言禁用链接。
|
|
366
|
+
* @lang en Header language switching carries the current entry only when its generated counterpart exists, restoring original roots on the index and disabling absent counterparts.
|
|
367
|
+
*/
|
|
368
|
+
function synchronizeLocaleLinks(entry) {
|
|
369
|
+
// <lang><zh-CN>原根目标独立缓存,避免条目或界面语言连续切换累积片段;独立宿主的静态链接保持原职责。</zh-CN><en>Cache original roots separately to prevent fragment accumulation across entry or UI-language changes; independent hosts retain their static-link responsibilities.</en></lang>
|
|
370
|
+
for (const link of document.querySelectorAll('[data-hia-site-language][data-hia-site-hrefs]')) {
|
|
371
|
+
const roots = JSON.parse(link.dataset.hiaSiteLocaleRoots || (link.dataset.hiaSiteLocaleRoots = link.dataset.hiaSiteHrefs));
|
|
372
|
+
// <lang><zh-CN>实际页面目录是对应关系证据,不根据文件名猜译文;目标根始终来自已验证的导航输入。</zh-CN><en>The actual page directory proves counterparts without inferring translations from names; target roots always come from validated navigation input.</en></lang>
|
|
373
|
+
const targets = Object.fromEntries(Object.entries(roots).map(([locale, target]) => [locale, entry && entry.localePages?.[locale === 'zh-CN' ? 'en' : 'zh-CN'] ? target + '#entry=' + encodeURIComponent(entry.id) : target]));
|
|
374
|
+
link.dataset.hiaSiteHrefs = JSON.stringify(targets);
|
|
375
|
+
const locale = ui?.value || root.lang;
|
|
376
|
+
if (entry && !entry.localePages?.[locale === 'zh-CN' ? 'en' : 'zh-CN']) {
|
|
377
|
+
link.removeAttribute('href');
|
|
378
|
+
link.setAttribute('aria-disabled', 'true');
|
|
379
|
+
} else {
|
|
380
|
+
link.removeAttribute('aria-disabled');
|
|
381
|
+
link.href = targets[locale];
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
/**
|
|
386
|
+
* @lang zh-CN 当前版本链接保留已生成条目身份;其它版本仍由宿主显式路由决定。
|
|
387
|
+
* @lang en Retain the generated entry identity on current-version links while other versions keep explicit host routing.
|
|
388
|
+
*/
|
|
389
|
+
function synchronizeCurrentVersionEntry(entry) {
|
|
390
|
+
for (const link of document.querySelectorAll('.hia-site-version-menu a[aria-current="true"][data-hia-site-hrefs],.hia-site-mobile a[aria-current="true"][data-hia-site-hrefs]')) {
|
|
391
|
+
// <lang><zh-CN>原始根不随界面语言切换累积片段,目录恢复时回到同语言根。</zh-CN><en>Original roots never accumulate fragments across UI-language changes, and returning to the index restores the same-locale root.</en></lang>
|
|
392
|
+
const roots = JSON.parse(link.dataset.hiaSiteVersionRoots || (link.dataset.hiaSiteVersionRoots = link.dataset.hiaSiteHrefs));
|
|
393
|
+
const targets = Object.fromEntries(Object.entries(roots).map(([locale, target]) => [locale, entry?.localePages?.[locale] ? target + '#entry=' + encodeURIComponent(entry.id) : target]));
|
|
394
|
+
link.dataset.hiaSiteHrefs = JSON.stringify(targets);
|
|
395
|
+
link.href = targets[ui?.value || root.lang];
|
|
396
|
+
}
|
|
397
|
+
}
|
|
398
|
+
// <lang><zh-CN>每次实际条目切换后只建立真实锚点;目录位于正文外,避免改变正文语言块。</zh-CN><en>After actual entry changes, build real anchors outside prose, preserving content-language blocks.</en></lang>
|
|
399
|
+
/**
|
|
400
|
+
* @lang zh-CN 从当前真实小节建立页内目录,其普通链接保留可直接打开的静态对应页。
|
|
401
|
+
* @lang en Builds an outline from actual current sections, retaining directly openable static counterparts in ordinary links.
|
|
402
|
+
*/
|
|
403
|
+
function outline() {
|
|
404
|
+
const article = document.querySelector('[data-hia-project-content]');
|
|
405
|
+
// <lang><zh-CN>普通浏览器没有文件定位宿主,禁用纯请求控件;同源公开源码链接继续可用。</zh-CN><en>A standalone browser has no file-navigation host, so disable request-only controls while retaining public same-origin source links.</en></lang>
|
|
406
|
+
if (window.parent === window)
|
|
407
|
+
for (const button of article?.querySelectorAll('[data-hia-open-request]') || []) {
|
|
408
|
+
button.disabled = true;
|
|
409
|
+
button.title = text('site.reading.host');
|
|
410
|
+
}
|
|
411
|
+
// <lang><zh-CN>父级静态页承载整组小节,语言与版本单独跟随实际选择的成员身份。</zh-CN><en>The containing static page owns the complete section group, while language/version follow the actual selected member identity.</en></lang>
|
|
412
|
+
const containingEntry = pages.get(article?.querySelector('article[id]')?.id);
|
|
413
|
+
const entry = pages.get(article?.dataset.hiaReadingEntry) || containingEntry;
|
|
414
|
+
synchronizeLocaleLinks(entry);
|
|
415
|
+
synchronizeCurrentVersionEntry(entry);
|
|
416
|
+
const staticPage = script.dataset.hiaReadingStatic ? '' : containingEntry?.localePages?.[ui?.value] || containingEntry?.page || 'pages/index.html';
|
|
417
|
+
const sections = article?.querySelectorAll('[data-hia-topic-section][id], [data-hia-reading-section][id]') || [];
|
|
418
|
+
for (const nav of document.querySelectorAll('[data-hia-reading-outline]')) {
|
|
419
|
+
nav.replaceChildren();
|
|
420
|
+
for (const section of sections) {
|
|
421
|
+
const heading = section.querySelector(':scope > h3, :scope > summary');
|
|
422
|
+
if (!heading)
|
|
423
|
+
continue;
|
|
424
|
+
const link = document.createElement('a');
|
|
425
|
+
link.href = staticPage + '#' + encodeURIComponent(section.id);
|
|
426
|
+
link.textContent = heading.textContent;
|
|
427
|
+
link.addEventListener('click', event => {
|
|
428
|
+
event.preventDefault();
|
|
429
|
+
// <lang><zh-CN>原生details由summary承担焦点,details不加负tabindex,保留展开内容的顺序键盘访问。</zh-CN><en>Native details delegate focus to their summary without negative tabindex on details, preserving sequential keyboard access to expanded contents.</en></lang>
|
|
430
|
+
if (section.tagName === 'DETAILS') section.open = true;
|
|
431
|
+
const focusTarget = section.tagName === 'DETAILS' ? section.querySelector(':scope > summary') : section;
|
|
432
|
+
section.scrollIntoView({ block: 'start' });
|
|
433
|
+
focusTarget?.focus({ preventScroll: true });
|
|
434
|
+
});
|
|
435
|
+
nav.append(link);
|
|
436
|
+
}
|
|
437
|
+
}
|
|
438
|
+
for (const block of article?.querySelectorAll('.hia-signature') || []) {
|
|
439
|
+
if (block.previousElementSibling?.matches('[data-hia-reading-copy]'))
|
|
440
|
+
continue;
|
|
441
|
+
const button = document.createElement('button');
|
|
442
|
+
button.type = 'button';
|
|
443
|
+
button.dataset.hiaReadingCopy = '';
|
|
444
|
+
button.dataset.hiaUiMessage = 'site.reading.copy';
|
|
445
|
+
button.textContent = text('site.reading.copy');
|
|
446
|
+
button.addEventListener('click', async () => { try {
|
|
447
|
+
await navigator.clipboard.writeText(block.textContent);
|
|
448
|
+
button.dataset.hiaUiMessage = 'site.reading.copied';
|
|
449
|
+
}
|
|
450
|
+
catch {
|
|
451
|
+
button.dataset.hiaUiMessage = 'site.reading.manualcopy';
|
|
452
|
+
} button.textContent = text(button.dataset.hiaUiMessage); });
|
|
453
|
+
block.before(button);
|
|
454
|
+
}
|
|
455
|
+
}
|
|
456
|
+
document.addEventListener('hia:site-content', outline);
|
|
457
|
+
ui?.addEventListener('change', outline);
|
|
458
|
+
outline();
|
|
459
|
+
})();`;
|
|
460
|
+
/**
|
|
461
|
+
* @lang zh-CN 仅在站点导航明确启用时采用的确认稿阅读样式,旧调用与演示基线不受此选择影响。
|
|
462
|
+
* @lang en Confirmed reading styles selected only by explicit site navigation, keeping legacy calls and demonstration baselines outside this selection.
|
|
463
|
+
*/
|
|
464
|
+
export const SITE_READING_STYLE = `
|
|
465
|
+
:root[data-hia-site-navigation][data-hia-scheme] {--hia-bg:#f6f8fc;--hia-surface:#fff;--hia-text:#17253a;--hia-muted:#526177;--hia-border:#dce4ef;--hia-site-soft:#edf3ff;--hia-accent-soft:var(--hia-site-soft);--hia-site-brand-contrast:#fff;color-scheme:light}
|
|
466
|
+
:root[data-hia-site-navigation][data-hia-scheme="dark"] {--hia-bg:#0c1525;--hia-surface:#142138;--hia-text:#e8effa;--hia-muted:#b2c1d6;--hia-border:#34445c;--hia-site-soft:#1c3050;--hia-accent:#93c5fd;color-scheme:dark}
|
|
467
|
+
@media(prefers-color-scheme:dark){:root[data-hia-site-navigation][data-hia-scheme="system"]{--hia-bg:#0c1525;--hia-surface:#142138;--hia-text:#e8effa;--hia-muted:#b2c1d6;--hia-border:#34445c;--hia-site-soft:#1c3050;--hia-accent:#93c5fd;color-scheme:dark}}
|
|
468
|
+
[data-hia-site-navigation] body{font:16px/1.75 "Segoe UI","Microsoft YaHei",system-ui,sans-serif;background:var(--hia-bg);color:var(--hia-text)}
|
|
469
|
+
[data-hia-site-navigation] .hia-shell{width:min(1240px,calc(100% - 64px));margin:auto;grid-template-columns:232px minmax(0,1fr) 170px;gap:36px;align-items:start;padding:30px 0 60px;min-height:0}
|
|
470
|
+
[data-hia-site-navigation] .hia-sidebar{position:static;height:auto;padding:0 20px 0 0;background:transparent;border-right:1px solid var(--hia-border);font-size:.83rem}
|
|
471
|
+
[data-hia-site-navigation] .hia-project-split-site .hia-sidebar{height:auto;max-height:none;overflow:visible;position:static;top:auto}
|
|
472
|
+
[data-hia-site-navigation] .hia-site-mark{background:var(--hia-color-accent,#0047ab);color:var(--hia-site-brand-contrast)}
|
|
473
|
+
[data-hia-site-navigation] .hia-project-view-button[aria-pressed="true"]{background:var(--hia-color-accent,#0047ab);color:var(--hia-site-brand-contrast)}
|
|
474
|
+
.hia-site-directory{position:sticky;top:calc(var(--hia-site-header) + var(--hia-site-tabs) + 30px);max-height:calc(100dvh - var(--hia-site-header) - var(--hia-site-tabs) - 50px);overflow:auto;min-width:0}
|
|
475
|
+
.hia-site-directory>summary{display:none}.hia-site-directory h1{font-size:.9rem}.hia-site-directory .hia-theme-switch{display:none}
|
|
476
|
+
[data-hia-site-navigation] .hia-main{padding:7px 0;min-width:0;max-width:none;margin:0;border:0;border-radius:0;background:transparent}
|
|
477
|
+
[data-hia-site-navigation] .hia-project-entry{border:0;border-radius:0;background:transparent;padding:0;margin:0}
|
|
478
|
+
[data-hia-site-navigation] .hia-project-topic-header :is(h1,h2){font:700 2.35rem/1.25 Consolas,monospace;letter-spacing:-.045em;min-width:0;overflow-wrap:break-word;margin:16px 0 24px}
|
|
479
|
+
.hia-site-project-name{font-size:.9rem;font-weight:700}.hia-site-api-meta{display:flex;flex-wrap:wrap;gap:6px;margin-top:18px}
|
|
480
|
+
.hia-site-breadcrumbs{font-size:.75rem;color:var(--hia-muted);margin:0 0 28px;overflow-wrap:break-word}.hia-site-eyebrow{font-size:.76rem;letter-spacing:.13em;color:var(--hia-muted);font-weight:750;text-transform:uppercase;margin:0 0 20px}
|
|
481
|
+
[data-hia-site-navigation] .hia-kind{font-size:.75rem;border-radius:20px;border-color:var(--hia-border);padding:4px 10px;margin:0 6px 18px 0}
|
|
482
|
+
[data-hia-site-navigation] .hia-project-topic-section{border:0;border-radius:0;border-top:1px solid var(--hia-border);margin:18px 0;padding:22px 0;background:transparent}
|
|
483
|
+
[data-hia-site-navigation] .hia-project-topic-section>summary{padding:0;background:transparent;font-size:1.05rem}
|
|
484
|
+
[data-hia-site-navigation] .hia-project-topic-section-body{padding:16px 0 0}
|
|
485
|
+
[data-hia-site-navigation] .hia-project-topic-section[data-hia-topic-section="summary"]{border:0;padding:0}
|
|
486
|
+
[data-hia-site-navigation] .hia-project-topic-section[data-hia-topic-section="summary"]>h3{display:none}
|
|
487
|
+
[data-hia-site-navigation] .hia-signature{border:1px solid var(--hia-border);border-radius:10px;padding:17px 20px;background:var(--hia-surface);overflow:auto;max-width:100%;white-space:pre;font:13px/1.9 Consolas,monospace}
|
|
488
|
+
[data-hia-site-navigation] .hia-site-field{border-top:1px solid var(--hia-border);padding:22px 0;margin:18px 0}
|
|
489
|
+
[data-hia-site-navigation] .hia-site-field h3{font-size:1.14rem;margin:0 0 12px}
|
|
490
|
+
[data-hia-site-navigation] .hia-site-field code{font:13px Consolas,monospace}
|
|
491
|
+
/* <lang><zh-CN>源码折叠标题复用确认稿路径字体,避免基础主题字体回退引发长布局。</zh-CN><en>Source-disclosure headings reuse confirmed path typography to avoid costly base-theme font fallback.</en></lang> */
|
|
492
|
+
[data-hia-site-navigation] :is(.hia-source-preview,.hia-source-fragment) summary{font-family:Consolas,monospace}
|
|
493
|
+
.hia-site-field-table{width:100%;table-layout:fixed;border-collapse:separate;border-spacing:0;border:1px solid var(--hia-border);border-radius:10px;overflow:hidden;background:var(--hia-surface);font-size:.9rem}.hia-site-field-table th,.hia-site-field-table td{padding:13px 16px;vertical-align:top;text-align:left;border-bottom:1px solid var(--hia-border);overflow-wrap:break-word}.hia-site-field-table th{background:var(--hia-site-soft);font-weight:600}.hia-site-field-table th:first-child{width:27%}.hia-site-field-table tr:last-child td{border-bottom:0}.hia-site-field-table p{margin:0}
|
|
494
|
+
.hia-site-toc{position:sticky;top:calc(var(--hia-site-header) + var(--hia-site-tabs) + 30px);max-height:calc(100dvh - 180px);overflow:auto;border-left:1px solid var(--hia-border);padding-left:16px;font-size:.78rem;min-width:0}
|
|
495
|
+
.hia-site-toc strong{font-size:.7rem;color:var(--hia-muted)}[data-hia-reading-outline] a{display:block;padding:7px 0;color:var(--hia-muted);overflow-wrap:break-word}
|
|
496
|
+
.hia-site-mobile-outline,.hia-site-source-mobile-directory{display:none}.hia-site-source-shell h1{font-size:2.35rem}.hia-site-source-path{overflow-wrap:break-word;font:13px Consolas,monospace}
|
|
497
|
+
.hia-site-notice{padding:16px 18px;border:1px solid #ead8a8;border-left-width:3px;border-radius:7px;background:#fffbeb;color:#713f12;margin:24px 0;font-size:.87rem}
|
|
498
|
+
[data-hia-site-navigation] [data-hia-source-fetch-status]:not([hidden]),[data-hia-site-navigation] .hia-project-load-error{padding:16px 18px;background:var(--hia-site-soft);border:1px solid var(--hia-border);border-left:3px solid var(--hia-accent);border-radius:7px;margin:24px 0;font-size:.87rem}
|
|
499
|
+
[data-hia-site-navigation] [data-hia-source-state="denied"] [data-hia-source-fetch-status],[data-hia-site-navigation] [data-hia-source-state="aborted"] [data-hia-source-fetch-status]{background:#fffbeb;border-color:#ead8a8;color:#713f12}
|
|
500
|
+
[data-hia-site-navigation] :is([data-hia-source-state="integrity-error"],[data-hia-source-state="network-error"],[data-hia-source-state="not-found"]) [data-hia-source-fetch-status],[data-hia-site-navigation] .hia-project-load-error{background:#fff1f2;border-color:#f0bac2;color:#9f1239}
|
|
501
|
+
[data-hia-site-navigation] [data-hia-source-state="ready"] [data-hia-source-fetch-status]{background:#f0fdf4;border-color:#c6e7cf;color:#166534}
|
|
502
|
+
[data-hia-site-navigation] [data-hia-source-state]:not([data-hia-source-state="ready"]) .hia-source-code{display:none}
|
|
503
|
+
[data-hia-site-navigation] [data-hia-open-request]:disabled{opacity:.5;cursor:not-allowed}
|
|
504
|
+
.hia-site-source-shell .hia-source-code{border:1px solid var(--hia-border);border-radius:10px;background:var(--hia-surface);color:var(--hia-text);overflow:auto;max-width:100%;padding:14px 18px;font:13px/1.95 Consolas,monospace}
|
|
505
|
+
.hia-site-source-shell .hia-source-line-number{color:var(--hia-muted)}
|
|
506
|
+
.hia-site-source-shell .hia-sidebar a{display:block;padding:8px 10px;overflow-wrap:break-word}
|
|
507
|
+
/* <lang><zh-CN>增强控件在首绘保留最终尺寸,绑定完成前不可见且不可聚焦,避免顶部工具挤动正文。</zh-CN><en>Reserve final control dimensions at first paint, keeping controls invisible and unfocusable until bound so header tools do not move prose.</en></lang> */
|
|
508
|
+
.hia-site-reading-trigger{visibility:hidden;display:inline-flex;align-items:center;gap:10px;border:1px solid var(--hia-border);background:var(--hia-surface);color:var(--hia-text);border-radius:8px;padding:6px 11px;font:inherit;font-size:.79rem;min-height:36px;cursor:pointer}.hia-site-static-search{display:inline-flex}
|
|
509
|
+
[data-hia-reading-ready] .hia-site-reading-trigger{visibility:visible}
|
|
510
|
+
/* <lang><zh-CN>真正禁脚本时无增强待绑定,沿原生导航布局移除空控件位置。</zh-CN><en>With scripting disabled there is no pending enhancement, so retain native navigation geometry without empty control slots.</en></lang> */
|
|
511
|
+
@media(scripting:none){.hia-site-reading-trigger{display:none}}
|
|
512
|
+
[data-hia-site-navigation] dialog{width:min(650px,calc(100vw - 32px));max-height:calc(100dvh - 32px);padding:0;border:1px solid var(--hia-border);border-radius:16px;background:var(--hia-surface);color:var(--hia-text);box-shadow:0 25px 90px #00132d44}
|
|
513
|
+
[data-hia-site-navigation] dialog::backdrop{background:#0c1c3680}[data-hia-site-navigation] dialog header{display:flex;justify-content:space-between;align-items:center;padding:20px 22px;border-bottom:1px solid var(--hia-border);gap:12px}
|
|
514
|
+
[data-hia-site-navigation] dialog h2{margin:0;font-size:1rem}.hia-site-dialog-body{padding:22px}.hia-site-dialog-body label{display:flex;justify-content:space-between;align-items:center;gap:18px;padding:14px 0;border-bottom:1px solid var(--hia-border)}
|
|
515
|
+
.hia-site-dialog-body select,.hia-site-dialog-body input{font:inherit;color:inherit;border:1px solid var(--hia-border);border-radius:6px;background:var(--hia-surface);padding:8px;min-width:0}.hia-site-dialog-body input{width:100%;margin:14px 0}
|
|
516
|
+
[data-hia-reading-results]{max-height:45dvh;overflow:auto}[data-hia-reading-results] a{display:block;padding:12px;border-bottom:1px solid var(--hia-border);overflow-wrap:break-word}
|
|
517
|
+
[data-hia-reading-close],[data-hia-reading-copy]{border:1px solid var(--hia-border);border-radius:5px;background:var(--hia-surface);color:var(--hia-text);padding:5px 8px;cursor:pointer}
|
|
518
|
+
[data-hia-reading-copy]{float:right;font-size:.7rem}[data-hia-reading-wrap="wrap"] .hia-signature,[data-hia-reading-wrap="wrap"] .hia-source-code-line{white-space:pre-wrap!important;overflow-wrap:anywhere;min-width:0!important}
|
|
519
|
+
/* <lang><zh-CN>行号链接承接原锚点,整行仍呈现当前目标,覆盖原生输出和静态阅读。</zh-CN><en>Line-number links own existing anchors while the full row retains target styling for native output and static reading.</en></lang> */
|
|
520
|
+
.hia-source-code-line:target,.hia-source-code-line:has(>.hia-source-line-number:target){background:var(--hia-accent-soft)}
|
|
521
|
+
[data-hia-site-navigation] [data-hia-topic-section="declaration"]{position:relative;border:0;padding:0}
|
|
522
|
+
[data-hia-site-navigation] [data-hia-topic-section="declaration"]>h3{border:1px solid var(--hia-border);border-bottom:0;border-radius:10px 10px 0 0;background:var(--hia-surface);font-size:.7rem;font-weight:400;margin:0;padding:9px 16px}
|
|
523
|
+
[data-hia-site-navigation] [data-hia-topic-section="declaration"]>.hia-signature{border-radius:0 0 10px 10px;margin:0}
|
|
524
|
+
[data-hia-site-navigation] [data-hia-topic-section="declaration"]>[data-hia-reading-copy]{position:absolute;float:none;right:10px;top:5px}
|
|
525
|
+
[data-hia-reading-lines="hide"] .hia-source-line-number{display:none!important}
|
|
526
|
+
[data-hia-site-navigation] [id]{scroll-margin-top:16px}
|
|
527
|
+
@media(max-width:1150px){[data-hia-site-navigation] .hia-shell{grid-template-columns:210px minmax(0,1fr);gap:28px}.hia-site-toc{display:none}.hia-site-mobile-outline{display:block;border:1px solid var(--hia-border);border-radius:8px;background:var(--hia-surface);margin-bottom:14px}.hia-site-mobile-outline>summary{padding:11px 13px;font-size:.83rem}.hia-site-mobile-outline nav{padding:0 13px 12px}.hia-site-search-trigger kbd{display:none}}
|
|
528
|
+
@media(max-width:800px){[data-hia-site-navigation] .hia-shell{display:block;width:calc(100% - 36px);padding-top:18px}.hia-site-directory{position:static;max-height:none;margin-bottom:14px;border:1px solid var(--hia-border);border-radius:8px;background:var(--hia-surface)}.hia-site-directory>summary{display:block;padding:11px 13px;font-weight:600;font-size:.83rem}.hia-site-directory>summary:before{content:'▸ ';}.hia-site-directory[open]>summary:before{content:'▾ ';}[data-hia-site-navigation] .hia-sidebar{padding:13px;border:0;max-height:55dvh;overflow:auto}.hia-site-search-trigger{display:none}[data-hia-site-navigation] .hia-project-topic-header :is(h1,h2){font-size:1.6rem;overflow-wrap:anywhere}.hia-site-source-shell h1{font-size:1.9rem}.hia-site-reading-trigger{padding:5px 8px;min-height:34px;font-size:.72rem}}
|
|
529
|
+
@media(max-width:370px){[data-hia-site-navigation] .hia-shell{width:calc(100% - 32px)}.hia-site-reading-trigger{padding:4px 6px}}
|
|
530
|
+
@media(max-width:800px){.hia-site-source-shell>.hia-site-directory{display:none}.hia-site-source-mobile-directory{display:block;border:1px solid var(--hia-border);border-radius:8px;background:var(--hia-surface);margin-bottom:14px}.hia-site-source-mobile-directory>summary{padding:11px 13px;font-size:.83rem;font-weight:600}.hia-site-source-mobile-directory .hia-sidebar{max-height:none}}
|
|
531
|
+
@media print{[data-hia-site-navigation] .hia-shell{display:block;width:100%;padding:0}.hia-site-directory,.hia-site-toc,.hia-site-mobile-outline,.hia-site-source-mobile-directory,[data-hia-site-navigation] dialog,[data-hia-reading-copy]{display:none!important}[data-hia-site-navigation] .hia-main{width:100%}}
|
|
532
|
+
@media(forced-colors:active){.hia-site-directory,.hia-site-notice,[data-hia-site-navigation] dialog{border:1px solid CanvasText}[data-hia-site-navigation] a{color:LinkText}[data-hia-site-navigation] .hia-site-mark{background:Highlight;color:HighlightText}.hia-source-code-line:target,.hia-source-code-line:has(>.hia-source-line-number:target){outline:2px solid Highlight}}
|
|
533
|
+
`;
|
|
534
|
+
//# sourceMappingURL=site-reading.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"site-reading.js","sourceRoot":"","sources":["../src/site-reading.ts"],"names":[],"mappings":"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"}
|
package/dist/source-lines.d.ts
CHANGED
|
@@ -9,9 +9,10 @@
|
|
|
9
9
|
* @param content <lang><zh-CN>owner已限长的源码片段。</zh-CN><en>Source excerpt already bounded by its owner.</en></lang>
|
|
10
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
|
+
* @param styleMode <lang><zh-CN>默认inline保留自包含片段,stylesheet要求调用方已提供同行样式;其他运行时值采用inline。</zh-CN><en>Defaults to inline for self-contained fragments; stylesheet requires the caller to provide matching line styles, and other runtime values use inline.</en></lang>
|
|
12
13
|
* @returns <lang><zh-CN>仅span/a与转义文本,无脚本。</zh-CN><en>Spans/anchors and escaped text only, without scripts.</en></lang>
|
|
13
14
|
*/
|
|
14
|
-
export declare function renderSourceLines(content: string, startLine?: number, anchors?: boolean): string;
|
|
15
|
+
export declare function renderSourceLines(content: string, startLine?: number, anchors?: boolean, styleMode?: "inline" | "stylesheet"): string;
|
|
15
16
|
/**
|
|
16
17
|
* @lang zh-CN 复用现有主题生成无脚本源码页,为#L提供真实锚点;HTML不是fetch文本资产。
|
|
17
18
|
* @lang en Generates a script-free source page using the existing theme with real #L anchors; HTML is not a fetch text asset.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"source-lines.d.ts","sourceRoot":"","sources":["../src/source-lines.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH
|
|
1
|
+
{"version":3,"file":"source-lines.d.ts","sourceRoot":"","sources":["../src/source-lines.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,OAAO,UAAQ,EAAE,SAAS,GAAE,QAAQ,GAAG,YAAuB,GAAG,MAAM,CAcxI;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAErG"}
|