@hia-doc/renderer-html 0.1.5 → 0.1.7
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 +7 -0
- package/dist/index.d.ts +26 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +105 -53
- package/dist/index.js.map +1 -1
- package/dist/presentation-profile.d.ts +2 -0
- package/dist/presentation-profile.d.ts.map +1 -1
- package/dist/presentation-profile.js +13 -2
- package/dist/presentation-profile.js.map +1 -1
- package/dist/source-lines.d.ts +24 -0
- package/dist/source-lines.d.ts.map +1 -0
- package/dist/source-lines.js +41 -0
- package/dist/source-lines.js.map +1 -0
- package/package.json +3 -3
|
@@ -46,6 +46,8 @@ export interface PortalPreparedSourceAsset {
|
|
|
46
46
|
digest: string;
|
|
47
47
|
lineCount: number;
|
|
48
48
|
relativeUrl: string;
|
|
49
|
+
/** @lang zh-CN 可选同源源码页与行锚点;fetch仍用relativeUrl纯文本。 @lang en Optional same-origin source page/line anchor; fetch still uses relativeUrl plain text. */
|
|
50
|
+
linkUrl?: string;
|
|
49
51
|
revision: string;
|
|
50
52
|
sourceId: string;
|
|
51
53
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"presentation-profile.d.ts","sourceRoot":"","sources":["../src/presentation-profile.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"presentation-profile.d.ts","sourceRoot":"","sources":["../src/presentation-profile.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,EAEpC,KAAK,mCAAmC,EACxC,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,8HAA8H;AAC9H,eAAO,MAAM,gCAAgC,4CAA4C,CAAC;AAC1F,0GAA0G;AAC1G,eAAO,MAAM,8BAA8B,YAAY,CAAC;AACxD,2EAA2E;AAC3E,eAAO,MAAM,kCAAkC,0BAA0B,CAAC;AAE1E,yGAAyG;AACzG,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6JAA6J;AAC7J,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+FAA+F;AAC/F,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,+BAA+B,CAAC;IACxC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,mCAAmC,CAAC;IAChD,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,MAAM,EAAE,4BAA4B,EAAE,CAAC;CACxC;AAED,gIAAgI;AAChI,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;CACzB;AAED,yHAAyH;AACzH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,qJAAqJ;IACrJ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mJAAmJ;AACnJ,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,0BAA0B,EAAE,CAAC;IACxC,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,OAAO,EAAE,gCAAgC,CAAC;IAC1C,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAChE,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,+BAA+B,GAAG,wBAAwB,CAiHjH"}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
|
+
import { renderPublicSourcePage } from "./source-lines.js";
|
|
2
3
|
import { DOCUMENTATION_PRESENTATION_PROFILE_CONTRACT, DOCUMENTATION_PRESENTATION_PROFILE_CONTRACT_VERSION, createHiaDiagnostic, validateDocumentationPresentationProfile } from "@hia-doc/core";
|
|
3
4
|
import { getPortalThemeSkinCatalog } from "@hia-doc/theme-default";
|
|
4
5
|
/** @lang zh-CN Portal 输出中的中性 presentation profile 固定路径。 @lang en Fixed neutral presentation-profile path in Portal output. */
|
|
@@ -165,6 +166,13 @@ function createPortalSourceArtifacts(sources, mode) {
|
|
|
165
166
|
continue;
|
|
166
167
|
}
|
|
167
168
|
const relativeUrl = `${PORTAL_PUBLIC_SOURCE_DIRECTORY}/${contentHash}.txt`;
|
|
169
|
+
// <lang><zh-CN>同一文本可来自不同起始行,查看页路径包含行号,避免内容共享导致错误定位。</zh-CN><en>Identical text can originate at different first lines; viewer paths include the line number to prevent shared content from mislabeling positions.</en></lang>
|
|
170
|
+
const firstLine = source.startLine ?? 1;
|
|
171
|
+
if (!Number.isSafeInteger(firstLine) || firstLine < 1) {
|
|
172
|
+
diagnostics.push(createHiaDiagnostic("PRESENTATION_SOURCE_ASSET_INVALID", "An authorized source excerpt requires a positive integer start line.", "error"));
|
|
173
|
+
continue;
|
|
174
|
+
}
|
|
175
|
+
const viewerPath = `${PORTAL_PUBLIC_SOURCE_DIRECTORY}/${digestHex("sha256", `${identitySeed}:${contentHash}`)}.L${firstLine}.html`;
|
|
168
176
|
const lineCount = content.length === 0 ? 0 : content.split(/\r?\n/u).length;
|
|
169
177
|
const digest = `sha384-${digestBase64("sha384", content)}`;
|
|
170
178
|
const assetId = stableIdentity("portal.asset", `${identitySeed}:${contentHash}`);
|
|
@@ -172,6 +180,7 @@ function createPortalSourceArtifacts(sources, mode) {
|
|
|
172
180
|
assetId,
|
|
173
181
|
sourceId,
|
|
174
182
|
relativeUrl,
|
|
183
|
+
...(mode === "fetch" || mode === "link" ? { linkUrl: `${viewerPath}#L${firstLine}` } : {}),
|
|
175
184
|
revision: `content:${contentHash}`,
|
|
176
185
|
digest,
|
|
177
186
|
byteLength,
|
|
@@ -198,7 +207,9 @@ function createPortalSourceArtifacts(sources, mode) {
|
|
|
198
207
|
asset,
|
|
199
208
|
projection,
|
|
200
209
|
contentHash,
|
|
201
|
-
...(artifact ? { artifact } : {})
|
|
210
|
+
...(artifact ? { artifact } : {}),
|
|
211
|
+
// <lang><zh-CN>查看页正文只在写入者读取contents时纯函数生成,不在bundle阶段把所有行号HTML驻留内存。</zh-CN><en>Viewer bodies are generated purely when writers read contents, avoiding retention of every line-numbered HTML page during bundle preparation.</en></lang>
|
|
212
|
+
...(mode === "fetch" || mode === "link" ? { viewer: { path: viewerPath, get contents() { return renderPublicSourcePage(content, source.sourcePath, firstLine); }, contentType: "text/html; charset=utf-8", role: "asset" } } : {})
|
|
202
213
|
});
|
|
203
214
|
sourceByEntryId.set(source.entryId, projection);
|
|
204
215
|
}
|
|
@@ -208,7 +219,7 @@ function createPortalSourceArtifacts(sources, mode) {
|
|
|
208
219
|
const records = [...assetsBySourceId.values()].sort((left, right) => compareText(left.asset.assetId, right.asset.assetId));
|
|
209
220
|
// <lang zh-CN>内容寻址会让不同 source identity 共享同一路径;按路径再去重可避免输出重复 artifact。</lang>
|
|
210
221
|
// <lang en>Content addressing can map distinct source identities to one path, so deduplicate artifacts by path before emission.</lang>
|
|
211
|
-
const sourceArtifacts = [...new Map(records.flatMap(({ artifact }) => artifact ? [[artifact.path, artifact]] : [])).values()];
|
|
222
|
+
const sourceArtifacts = [...new Map(records.flatMap(({ artifact, viewer }) => [...(artifact ? [[artifact.path, artifact]] : []), ...(viewer ? [[viewer.path, viewer]] : [])])).values()];
|
|
212
223
|
const gitAttributes = sourceArtifacts.length > 0
|
|
213
224
|
? [{ path: ".gitattributes", contents: PORTAL_PUBLIC_SOURCE_GITATTRIBUTES, contentType: "text/plain; charset=utf-8", role: "asset" }]
|
|
214
225
|
: [];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"presentation-profile.js","sourceRoot":"","sources":["../src/presentation-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,2CAA2C,EAC3C,mDAAmD,EACnD,mBAAmB,EACnB,wCAAwC,EAMzC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EAE1B,MAAM,wBAAwB,CAAC;AAEhC,8HAA8H;AAC9H,MAAM,CAAC,MAAM,gCAAgC,GAAG,yCAAyC,CAAC;AAC1F,0GAA0G;AAC1G,MAAM,CAAC,MAAM,8BAA8B,GAAG,SAAS,CAAC;AACxD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAAG,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"presentation-profile.js","sourceRoot":"","sources":["../src/presentation-profile.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file
|
|
3
|
+
* @lang zh-CN 已授权源码的行投影及同源查看页;转义文本,不执行源码或生成外部链接。
|
|
4
|
+
* @lang en Line projection and same-origin viewing pages for authorized source; escapes text without executing source or generating external links.
|
|
5
|
+
*/
|
|
6
|
+
/**
|
|
7
|
+
* @lang zh-CN 转义授权正文并逐行编号;独立页使用L锚点,内联避免重复DOM id。
|
|
8
|
+
* @lang en Escapes/ numbers authorized text by line; standalone pages use L anchors while inline previews avoid duplicate DOM IDs.
|
|
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>片段的一基起始行。</zh-CN><en>One-based first line of the excerpt.</en></lang>
|
|
11
|
+
* @param anchors <lang><zh-CN>仅独立页生成L行id。</zh-CN><en>Only standalone pages emit L-line IDs.</en></lang>
|
|
12
|
+
* @returns <lang><zh-CN>仅span/a与转义文本,无脚本。</zh-CN><en>Spans/anchors and escaped text only, without scripts.</en></lang>
|
|
13
|
+
*/
|
|
14
|
+
export declare function renderSourceLines(content: string, startLine?: number, anchors?: boolean): string;
|
|
15
|
+
/**
|
|
16
|
+
* @lang zh-CN 复用现有主题生成无脚本源码页,为#L提供真实锚点;HTML不是fetch文本资产。
|
|
17
|
+
* @lang en Generates a script-free source page using the existing theme with real #L anchors; HTML is not a fetch text asset.
|
|
18
|
+
* @param content <lang><zh-CN>授权且限长的纯文本。</zh-CN><en>Authorized bounded plain text.</en></lang>
|
|
19
|
+
* @param sourcePath <lang><zh-CN>公开locator,在标题中转义。</zh-CN><en>Published locator, escaped in the title.</en></lang>
|
|
20
|
+
* @param startLine <lang><zh-CN>一基起始行。</zh-CN><en>One-based first line.</en></lang>
|
|
21
|
+
* @returns <lang><zh-CN>完整HTML;CSP禁止脚本/外部请求,长行局部滚动。</zh-CN><en>Complete HTML with CSP blocking scripts/external requests and local scrolling for long lines.</en></lang>
|
|
22
|
+
*/
|
|
23
|
+
export declare function renderPublicSourcePage(content: string, sourcePath: string, startLine: number): string;
|
|
24
|
+
//# sourceMappingURL=source-lines.d.ts.map
|
|
@@ -0,0 +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,CASzF;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAErG"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file
|
|
3
|
+
* @lang zh-CN 已授权源码的行投影及同源查看页;转义文本,不执行源码或生成外部链接。
|
|
4
|
+
* @lang en Line projection and same-origin viewing pages for authorized source; escapes text without executing source or generating external links.
|
|
5
|
+
*/
|
|
6
|
+
/** @lang zh-CN 已确认最小范围的行/焦点/定位样式,不改导航。 @lang en Line/focus/target styles for the confirmed minimal scope without changing navigation. */
|
|
7
|
+
const LINE_STYLE = ".hia-source-code-line{display:block;min-width:max-content}.hia-source-line-number{display:inline-block;min-width:3ch;margin-inline-end:1.25rem;color:inherit;text-align:right;user-select:none}.hia-source-code-line:target{background:color-mix(in srgb,var(--hia-accent,#0f4f82) 14%,transparent)}.hia-source-line-number:focus-visible{outline:3px solid currentColor;outline-offset:2px}";
|
|
8
|
+
/**
|
|
9
|
+
* @lang zh-CN 转义授权正文并逐行编号;独立页使用L锚点,内联避免重复DOM id。
|
|
10
|
+
* @lang en Escapes/ numbers authorized text by line; standalone pages use L anchors while inline previews avoid duplicate DOM IDs.
|
|
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>片段的一基起始行。</zh-CN><en>One-based first line of the excerpt.</en></lang>
|
|
13
|
+
* @param anchors <lang><zh-CN>仅独立页生成L行id。</zh-CN><en>Only standalone pages emit L-line IDs.</en></lang>
|
|
14
|
+
* @returns <lang><zh-CN>仅span/a与转义文本,无脚本。</zh-CN><en>Spans/anchors and escaped text only, without scripts.</en></lang>
|
|
15
|
+
*/
|
|
16
|
+
export function renderSourceLines(content, startLine = 1, anchors = false) {
|
|
17
|
+
// <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
|
+
return content.split(/\r?\n/u).map((text, index) => {
|
|
19
|
+
// <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 = startLine + index;
|
|
21
|
+
const style = "display:inline-block;min-width:3ch;margin-inline-end:1.25rem;text-align:right;user-select:none";
|
|
22
|
+
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
|
+
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>`;
|
|
24
|
+
}).join("");
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* @lang zh-CN 复用现有主题生成无脚本源码页,为#L提供真实锚点;HTML不是fetch文本资产。
|
|
28
|
+
* @lang en Generates a script-free source page using the existing theme with real #L anchors; HTML is not a fetch text asset.
|
|
29
|
+
* @param content <lang><zh-CN>授权且限长的纯文本。</zh-CN><en>Authorized bounded plain text.</en></lang>
|
|
30
|
+
* @param sourcePath <lang><zh-CN>公开locator,在标题中转义。</zh-CN><en>Published locator, escaped in the title.</en></lang>
|
|
31
|
+
* @param startLine <lang><zh-CN>一基起始行。</zh-CN><en>One-based first line.</en></lang>
|
|
32
|
+
* @returns <lang><zh-CN>完整HTML;CSP禁止脚本/外部请求,长行局部滚动。</zh-CN><en>Complete HTML with CSP blocking scripts/external requests and local scrolling for long lines.</en></lang>
|
|
33
|
+
*/
|
|
34
|
+
export function renderPublicSourcePage(content, sourcePath, startLine) {
|
|
35
|
+
return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src data:; style-src 'self' 'unsafe-inline'; base-uri 'none'; form-action 'none'"><title>${escape(sourcePath)} · Source / 源码</title><link rel="icon" href="data:,"><link rel="stylesheet" href="../assets/hia-default.css"><style>${LINE_STYLE}body{margin:0;padding:clamp(1rem,3vw,2rem)}main{max-width:70rem;margin:auto;padding:1rem;background:var(--hia-bg,#fff);border:1px solid var(--hia-border,#ac9474);border-radius:.7rem}h1{font-size:1.35rem;overflow-wrap:break-word}pre{overflow:auto;padding:1rem;line-height:1.6}</style></head><body><main><h1>${escape(sourcePath)} · Source / 源码</h1><pre class="hia-source-code"><code>${renderSourceLines(content, startLine, true)}</code></pre></main></body></html>`;
|
|
36
|
+
}
|
|
37
|
+
/** @lang zh-CN 转义文本/属性的HTML特殊字符,不解释源码。 @lang en Escapes HTML-special characters in text/attributes without interpreting source. */
|
|
38
|
+
function escape(value) {
|
|
39
|
+
return value.replace(/[&<>"']/gu, (character) => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" })[character]);
|
|
40
|
+
}
|
|
41
|
+
//# sourceMappingURL=source-lines.js.map
|
|
@@ -0,0 +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"}
|
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.7",
|
|
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/source-linkage": "0.1.1",
|
|
34
|
+
"@hia-doc/theme-default": "0.1.4"
|
|
35
35
|
},
|
|
36
36
|
"sideEffects": false,
|
|
37
37
|
"scripts": {
|