spec-up-t 1.3.1 → 1.4.0
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/.github/copilot-instructions.md +13 -0
- package/assets/compiled/body.js +17 -11
- package/assets/compiled/head.css +6 -4
- package/assets/css/collapse-definitions.css +0 -1
- package/assets/css/create-pdf.css +4 -2
- package/assets/css/create-term-filter.css +4 -4
- package/assets/css/definition-buttons-container.css +60 -0
- package/assets/css/insert-trefs.css +7 -0
- package/assets/css/sidebar-toc.css +2 -1
- package/assets/css/terms-and-definitions.css +73 -22
- package/assets/js/add-href-to-snapshot-link.js +16 -9
- package/assets/js/addAnchorsToTerms.js +1 -1
- package/assets/js/charts.js +10 -0
- package/assets/js/collapse-definitions.js +13 -2
- package/assets/js/collapse-meta-info.js +11 -9
- package/assets/js/definition-button-container-utils.js +82 -0
- package/assets/js/edit-term-buttons.js +77 -20
- package/assets/js/github-issues.js +35 -0
- package/assets/js/github-repo-info.js +144 -0
- package/assets/js/highlight-heading-plus-sibling-nodes.test.js +18 -0
- package/assets/js/insert-trefs.js +62 -13
- package/assets/js/mermaid-diagrams.js +11 -0
- package/assets/js/terminology-section-utility-container/README.md +107 -0
- package/assets/js/terminology-section-utility-container/create-alphabet-index.js +17 -0
- package/assets/js/{create-term-filter.js → terminology-section-utility-container/create-term-filter.js} +11 -44
- package/assets/js/terminology-section-utility-container/hide-show-utility-container.js +21 -0
- package/assets/js/terminology-section-utility-container/search.js +203 -0
- package/assets/js/terminology-section-utility-container.js +203 -0
- package/assets/js/tooltips.js +283 -0
- package/config/asset-map.json +24 -16
- package/index.js +57 -390
- package/package.json +5 -2
- package/src/add-remove-xref-source.js +20 -21
- package/src/collect-external-references.js +8 -337
- package/src/collect-external-references.test.js +440 -33
- package/src/configure.js +8 -109
- package/src/create-docx.js +7 -6
- package/src/create-pdf.js +15 -14
- package/src/freeze-spec-data.js +46 -0
- package/src/git-info.test.js +76 -0
- package/src/health-check/destination-gitignore-checker.js +5 -3
- package/src/health-check/external-specs-checker.js +5 -4
- package/src/health-check/specs-configuration-checker.js +2 -1
- package/src/health-check/term-references-checker.js +5 -3
- package/src/health-check/terms-intro-checker.js +2 -1
- package/src/health-check/tref-term-checker.js +8 -7
- package/src/health-check.js +8 -7
- package/src/init.js +3 -2
- package/src/install-from-boilerplate/add-gitignore-entries.js +3 -2
- package/src/install-from-boilerplate/add-scripts-keys.js +5 -4
- package/src/install-from-boilerplate/boilerplate/README.md +1 -1
- package/src/install-from-boilerplate/boilerplate/spec/example-markup-in-markdown.md +1 -1
- package/src/install-from-boilerplate/boilerplate/spec/spec-head.md +1 -1
- package/src/install-from-boilerplate/boilerplate/specs.json +2 -1
- package/src/install-from-boilerplate/config-scripts-keys.js +3 -3
- package/src/install-from-boilerplate/copy-boilerplate.js +2 -1
- package/src/install-from-boilerplate/copy-system-files.js +4 -3
- package/src/install-from-boilerplate/custom-update.js +12 -1
- package/src/install-from-boilerplate/help.txt +1 -1
- package/src/install-from-boilerplate/menu.sh +6 -6
- package/src/json-key-validator.js +17 -11
- package/src/markdown-it/README.md +207 -0
- package/src/markdown-it/definition-lists.js +397 -0
- package/src/markdown-it/index.js +83 -0
- package/src/markdown-it/link-enhancement.js +98 -0
- package/src/markdown-it/plugins.js +118 -0
- package/src/markdown-it/table-enhancement.js +97 -0
- package/src/markdown-it/template-tag-syntax.js +152 -0
- package/src/parsers/index.js +16 -0
- package/src/parsers/spec-parser.js +152 -0
- package/src/parsers/spec-parser.test.js +109 -0
- package/src/parsers/template-tag-parser.js +277 -0
- package/src/parsers/template-tag-parser.test.js +107 -0
- package/src/pipeline/configuration/configure-starterpack.js +200 -0
- package/src/{create-external-specs-list.js → pipeline/configuration/create-external-specs-list.js} +13 -12
- package/src/{create-term-index.js → pipeline/configuration/create-term-index.js} +19 -18
- package/src/{create-versions-index.js → pipeline/configuration/create-versions-index.js} +4 -3
- package/src/{insert-term-index.js → pipeline/configuration/insert-term-index.js} +2 -2
- package/src/pipeline/configuration/prepare-spec-configuration.js +70 -0
- package/src/pipeline/parsing/apply-markdown-it-extensions.js +35 -0
- package/src/pipeline/parsing/create-markdown-parser.js +94 -0
- package/src/pipeline/parsing/create-markdown-parser.test.js +49 -0
- package/src/{html-dom-processor.js → pipeline/postprocessing/definition-list-postprocessor.js} +69 -10
- package/src/{escape-handler.js → pipeline/preprocessing/escape-processor.js} +3 -1
- package/src/{fix-markdown-files.js → pipeline/preprocessing/normalize-terminology-markdown.js} +41 -31
- package/src/pipeline/references/collect-external-references.js +307 -0
- package/src/pipeline/references/external-references-service.js +231 -0
- package/src/pipeline/references/fetch-terms-from-index.js +198 -0
- package/src/pipeline/references/match-term.js +34 -0
- package/src/{collectExternalReferences/matchTerm.test.js → pipeline/references/match-term.test.js} +8 -2
- package/src/pipeline/references/process-xtrefs-data.js +94 -0
- package/src/pipeline/references/xtref-utils.js +166 -0
- package/src/pipeline/rendering/render-spec-document.js +146 -0
- package/src/pipeline/rendering/render-utils.js +154 -0
- package/src/utils/LOGGER.md +81 -0
- package/src/utils/{doesUrlExist.js → does-url-exist.js} +4 -3
- package/src/utils/fetch.js +5 -4
- package/src/utils/file-opener.js +3 -2
- package/src/utils/git-info.js +77 -0
- package/src/utils/logger.js +74 -0
- package/src/utils/regex-patterns.js +471 -0
- package/src/utils/regex-patterns.test.js +281 -0
- package/templates/template.html +56 -21
- package/assets/js/create-alphabet-index.js +0 -60
- package/assets/js/hide-show-utility-container.js +0 -16
- package/assets/js/index.js +0 -87
- package/assets/js/search.js +0 -365
- package/src/collectExternalReferences/fetchTermsFromIndex.js +0 -284
- package/src/collectExternalReferences/matchTerm.js +0 -32
- package/src/collectExternalReferences/processXTrefsData.js +0 -108
- package/src/freeze.js +0 -90
- package/src/markdown-it-extensions.js +0 -395
- package/src/references.js +0 -114
- /package/assets/css/{bootstrap.min.css → embedded-libraries/bootstrap.min.css} +0 -0
- /package/assets/css/{prism.css → embedded-libraries/prism.css} +0 -0
- /package/assets/css/{prism.dark.css → embedded-libraries/prism.dark.css} +0 -0
- /package/assets/css/{prism.default.css → embedded-libraries/prism.default.css} +0 -0
- /package/assets/js/{bootstrap.bundle.min.js → embedded-libraries/bootstrap.bundle.min.js} +0 -0
- /package/assets/js/{chart.js → embedded-libraries/chart.js} +0 -0
- /package/assets/js/{diff.min.js → embedded-libraries/diff.min.js} +0 -0
- /package/assets/js/{font-awesome.js → embedded-libraries/font-awesome.js} +0 -0
- /package/assets/js/{mermaid.js → embedded-libraries/mermaid.js} +0 -0
- /package/assets/js/{notyf.js → embedded-libraries/notyf.js} +0 -0
- /package/assets/js/{popper.js → embedded-libraries/popper.js} +0 -0
- /package/assets/js/{prism.dark.js → embedded-libraries/prism.dark.js} +0 -0
- /package/assets/js/{prism.default.js → embedded-libraries/prism.default.js} +0 -0
- /package/assets/js/{prism.js → embedded-libraries/prism.js} +0 -0
- /package/assets/js/{tippy.js → embedded-libraries/tippy.js} +0 -0
- /package/src/{escape-mechanism.js → pipeline/preprocessing/escape-placeholder-utils.js} +0 -0
- /package/src/utils/{isLineWithDefinition.js → is-line-with-definition.js} +0 -0
package/src/references.js
DELETED
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
const {JSDOM} = require("jsdom");
|
|
2
|
-
const axios = require('axios').default;
|
|
3
|
-
|
|
4
|
-
const spaceRegex = /\s+/g;
|
|
5
|
-
|
|
6
|
-
function validateReferences(references, definitions, render) {
|
|
7
|
-
const unresolvedRefs = [];
|
|
8
|
-
[...new Set(references)].forEach(
|
|
9
|
-
ref => {
|
|
10
|
-
if(render.includes(`id="term:${ref.replace(spaceRegex, '-').toLowerCase()}"`)) {
|
|
11
|
-
// Reference is resolved
|
|
12
|
-
} else {
|
|
13
|
-
unresolvedRefs.push(ref);
|
|
14
|
-
}
|
|
15
|
-
}
|
|
16
|
-
);
|
|
17
|
-
if (unresolvedRefs.length > 0 ) {
|
|
18
|
-
console.log('ℹ️ Unresolved References: ', unresolvedRefs)
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
const danglingDefs = [];
|
|
22
|
-
definitions.forEach(defs => {
|
|
23
|
-
let found = defs.some(def => render.includes(`href="#term:${def.replace(spaceRegex, '-').toLowerCase()}"`))
|
|
24
|
-
if (!found) {
|
|
25
|
-
danglingDefs.push(defs[0]);
|
|
26
|
-
}
|
|
27
|
-
})
|
|
28
|
-
if(danglingDefs.length > 0) {
|
|
29
|
-
console.log('ℹ️ Dangling Definitions: ', danglingDefs)
|
|
30
|
-
}
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
function findExternalSpecByKey(config, key) {
|
|
34
|
-
for (const spec of config.specs) {
|
|
35
|
-
if (spec.external_specs) {
|
|
36
|
-
for (const externalSpec of spec.external_specs) {
|
|
37
|
-
if (externalSpec.external_spec === key) {
|
|
38
|
-
return externalSpec;
|
|
39
|
-
}
|
|
40
|
-
}
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
return null;
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
async function fetchExternalSpecs(spec) {
|
|
47
|
-
try {
|
|
48
|
-
let results = await Promise.all(
|
|
49
|
-
spec.external_specs.map(s => {
|
|
50
|
-
const url = s["gh_page"];
|
|
51
|
-
return axios.get(url).catch(error => ({ error, url }));
|
|
52
|
-
})
|
|
53
|
-
);
|
|
54
|
-
|
|
55
|
-
const failed = results.filter(r => r && r.error);
|
|
56
|
-
if (failed.length > 0) {
|
|
57
|
-
failed.forEach(f => {
|
|
58
|
-
const msg = f.error.response
|
|
59
|
-
? `HTTP ${f.error.response.status} for ${f.url}`
|
|
60
|
-
: `Network error for ${f.url}: ${f.error.message}`;
|
|
61
|
-
console.error("❌ External spec fetch failed:", msg);
|
|
62
|
-
});
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
// Map results to objects keyed by external_spec if status is 200, otherwise null.
|
|
66
|
-
// This ensures only successful fetches are included, and failed ones are filtered out.
|
|
67
|
-
results = results
|
|
68
|
-
.map((r, index) =>
|
|
69
|
-
r && r.status === 200
|
|
70
|
-
? { [spec.external_specs[index].external_spec]: r.data }
|
|
71
|
-
: null
|
|
72
|
-
)
|
|
73
|
-
.filter(r => r); // Remove null values (failed fetches)
|
|
74
|
-
|
|
75
|
-
return results.map(r =>
|
|
76
|
-
createNewDLWithTerms(Object.keys(r)[0], Object.values(r)[0])
|
|
77
|
-
);
|
|
78
|
-
} catch (e) {
|
|
79
|
-
console.error("❌ Unexpected error in fetchExternalSpecs:", e);
|
|
80
|
-
return [];
|
|
81
|
-
}
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
function createNewDLWithTerms(title, html) {
|
|
86
|
-
const dom = new JSDOM(html);
|
|
87
|
-
const document = dom.window.document;
|
|
88
|
-
|
|
89
|
-
const newDl = document.createElement('dl');
|
|
90
|
-
newDl.setAttribute('id', title);
|
|
91
|
-
|
|
92
|
-
const terms = document.querySelectorAll('dt span[id^="term:"]');
|
|
93
|
-
|
|
94
|
-
terms.forEach(term => {
|
|
95
|
-
const modifiedId = `term:${title}:${term.id.split(':')[1]}`;
|
|
96
|
-
term.id = modifiedId;
|
|
97
|
-
const dt = term.closest('dt');
|
|
98
|
-
const dd = dt.nextElementSibling;
|
|
99
|
-
|
|
100
|
-
newDl.appendChild(dt.cloneNode(true));
|
|
101
|
-
if (dd && dd.tagName === 'DD') {
|
|
102
|
-
newDl.appendChild(dd.cloneNode(true));
|
|
103
|
-
}
|
|
104
|
-
});
|
|
105
|
-
|
|
106
|
-
return newDl.outerHTML;
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
module.exports = {
|
|
110
|
-
findExternalSpecByKey,
|
|
111
|
-
validateReferences,
|
|
112
|
-
fetchExternalSpecs,
|
|
113
|
-
createNewDLWithTerms
|
|
114
|
-
}
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|