@techdocs/cli 1.13.0 → 1.14.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/CHANGELOG.md +13 -0
- package/dist/commands/generate/generate.cjs.js +9 -3
- package/dist/commands/generate/generate.cjs.js.map +1 -1
- package/dist/commands/index.cjs.js +17 -25
- package/dist/commands/index.cjs.js.map +1 -1
- package/dist/commands/serve/mkdocs.cjs.js +18 -7
- package/dist/commands/serve/mkdocs.cjs.js.map +1 -1
- package/dist/commands/serve/serve.cjs.js +26 -20
- package/dist/commands/serve/serve.cjs.js.map +1 -1
- package/dist/commands/serve/utils.cjs.js +11 -0
- package/dist/commands/serve/utils.cjs.js.map +1 -1
- package/dist/index.cjs.js +1 -1
- package/dist/lib/{engineConfig.cjs.js → engines/mkdocs.cjs.js} +5 -24
- package/dist/lib/engines/mkdocs.cjs.js.map +1 -0
- package/dist/lib/engines/registry.cjs.js +29 -0
- package/dist/lib/engines/registry.cjs.js.map +1 -0
- package/dist/lib/engines/zensical.cjs.js +119 -0
- package/dist/lib/engines/zensical.cjs.js.map +1 -0
- package/dist/lib/httpServer.cjs.js +4 -2
- package/dist/lib/httpServer.cjs.js.map +1 -1
- package/dist/lib/livereload.cjs.js +9 -6
- package/dist/lib/livereload.cjs.js.map +1 -1
- package/dist/lib/prepareServeConfig.cjs.js +17 -0
- package/dist/lib/prepareServeConfig.cjs.js.map +1 -0
- package/dist/lib/server.cjs.js +2 -1
- package/dist/lib/server.cjs.js.map +1 -1
- package/dist/{package.json.cjs.js → packages/techdocs-cli/package.json.cjs.js} +1 -1
- package/dist/plugins/techdocs-zensical-internal/src/TechdocsZensicalGenerator.cjs.js +178 -0
- package/dist/plugins/techdocs-zensical-internal/src/TechdocsZensicalGenerator.cjs.js.map +1 -0
- package/dist/plugins/techdocs-zensical-internal/src/zensicalHelpers.cjs.js +185 -0
- package/dist/plugins/techdocs-zensical-internal/src/zensicalHelpers.cjs.js.map +1 -0
- package/package.json +8 -3
- package/dist/lib/engineConfig.cjs.js.map +0 -1
- /package/dist/{package.json.cjs.js.map → packages/techdocs-cli/package.json.cjs.js.map} +0 -0
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var fs = require('fs-extra');
|
|
4
|
+
var path = require('node:path');
|
|
5
|
+
var node_crypto = require('node:crypto');
|
|
6
|
+
var pluginTechdocsNode = require('@backstage/plugin-techdocs-node');
|
|
7
|
+
var alpha = require('@backstage/plugin-techdocs-node/alpha');
|
|
8
|
+
var errors = require('@backstage/errors');
|
|
9
|
+
var zensicalHelpers = require('./zensicalHelpers.cjs.js');
|
|
10
|
+
|
|
11
|
+
function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
|
|
12
|
+
|
|
13
|
+
var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
|
|
14
|
+
var path__default = /*#__PURE__*/_interopDefaultCompat(path);
|
|
15
|
+
|
|
16
|
+
class TechdocsZensicalGenerator {
|
|
17
|
+
static defaultDockerImage = "ghcr.io/backstage/techdocs-zensical:v0.1.0";
|
|
18
|
+
logger;
|
|
19
|
+
containerRunner;
|
|
20
|
+
options;
|
|
21
|
+
static fromConfig(config, options) {
|
|
22
|
+
const { containerRunner, logger } = options;
|
|
23
|
+
return new TechdocsZensicalGenerator({
|
|
24
|
+
logger,
|
|
25
|
+
containerRunner,
|
|
26
|
+
config
|
|
27
|
+
});
|
|
28
|
+
}
|
|
29
|
+
constructor(options) {
|
|
30
|
+
this.logger = options.logger;
|
|
31
|
+
this.options = readZensicalGeneratorConfig(options.config);
|
|
32
|
+
this.containerRunner = options.containerRunner;
|
|
33
|
+
}
|
|
34
|
+
async run(options) {
|
|
35
|
+
const {
|
|
36
|
+
inputDir,
|
|
37
|
+
outputDir,
|
|
38
|
+
etag,
|
|
39
|
+
logger: childLogger,
|
|
40
|
+
logStream,
|
|
41
|
+
siteOptions,
|
|
42
|
+
runAsDefaultUser
|
|
43
|
+
} = options;
|
|
44
|
+
const { path: mkdocsYmlPath, content } = await pluginTechdocsNode.getMkdocsYml(
|
|
45
|
+
inputDir,
|
|
46
|
+
siteOptions
|
|
47
|
+
);
|
|
48
|
+
const docsDir = await alpha.validateMkdocsYaml(inputDir, content);
|
|
49
|
+
if (this.options.legacyCopyReadmeMdToIndexMd) {
|
|
50
|
+
await alpha.patchIndexPreBuild({ inputDir, logger: childLogger, docsDir });
|
|
51
|
+
}
|
|
52
|
+
await alpha.validateInputDirectory(inputDir);
|
|
53
|
+
const mountDirs = {
|
|
54
|
+
[inputDir]: "/input"
|
|
55
|
+
};
|
|
56
|
+
const relativeSiteDir = `.techdocs-zensical-site-${node_crypto.randomUUID()}`;
|
|
57
|
+
const builtSiteDir = path__default.default.join(
|
|
58
|
+
path__default.default.dirname(mkdocsYmlPath),
|
|
59
|
+
relativeSiteDir
|
|
60
|
+
);
|
|
61
|
+
await alpha.sanitizeMkdocsYml(
|
|
62
|
+
mkdocsYmlPath,
|
|
63
|
+
childLogger,
|
|
64
|
+
this.options.dangerouslyAllowAdditionalKeys,
|
|
65
|
+
this.options.dangerouslyAllowAdditionalPlugins
|
|
66
|
+
);
|
|
67
|
+
const zensicalConfigPath = await zensicalHelpers.patchZensicalConfig(
|
|
68
|
+
mkdocsYmlPath,
|
|
69
|
+
relativeSiteDir,
|
|
70
|
+
childLogger
|
|
71
|
+
);
|
|
72
|
+
try {
|
|
73
|
+
switch (this.options.runIn) {
|
|
74
|
+
case "local":
|
|
75
|
+
await alpha.runCommand({
|
|
76
|
+
command: "zensical",
|
|
77
|
+
args: ["build", "-f", zensicalConfigPath],
|
|
78
|
+
options: {
|
|
79
|
+
cwd: inputDir,
|
|
80
|
+
// Don't expose the backend's environment (and its secrets) to
|
|
81
|
+
// the docs build; the Docker path is scoped the same way.
|
|
82
|
+
env: {
|
|
83
|
+
NODE_ENV: process.env.NODE_ENV,
|
|
84
|
+
PATH: process.env.PATH,
|
|
85
|
+
HOME: process.env.HOME
|
|
86
|
+
}
|
|
87
|
+
},
|
|
88
|
+
logStream
|
|
89
|
+
});
|
|
90
|
+
childLogger.info(
|
|
91
|
+
`Successfully generated docs from ${inputDir} into ${outputDir} using local zensical`
|
|
92
|
+
);
|
|
93
|
+
break;
|
|
94
|
+
case "docker": {
|
|
95
|
+
const containerRunner = this.containerRunner || alpha.createDockerContainerRunner();
|
|
96
|
+
await containerRunner.runContainer({
|
|
97
|
+
imageName: this.options.dockerImage ?? TechdocsZensicalGenerator.defaultDockerImage,
|
|
98
|
+
// Set the entrypoint explicitly rather than relying on the image's.
|
|
99
|
+
command: ["zensical"],
|
|
100
|
+
args: [
|
|
101
|
+
"build",
|
|
102
|
+
"-f",
|
|
103
|
+
path__default.default.posix.join(
|
|
104
|
+
"/input",
|
|
105
|
+
...path__default.default.relative(inputDir, zensicalConfigPath).split(path__default.default.sep)
|
|
106
|
+
)
|
|
107
|
+
],
|
|
108
|
+
logStream,
|
|
109
|
+
mountDirs,
|
|
110
|
+
workingDir: "/input",
|
|
111
|
+
envVars: { HOME: "/tmp" },
|
|
112
|
+
pullImage: this.options.pullImage,
|
|
113
|
+
pullOptions: this.options.pullOptions,
|
|
114
|
+
defaultUser: runAsDefaultUser
|
|
115
|
+
});
|
|
116
|
+
childLogger.info(
|
|
117
|
+
`Successfully generated docs from ${inputDir} into ${outputDir} using zensical container`
|
|
118
|
+
);
|
|
119
|
+
break;
|
|
120
|
+
}
|
|
121
|
+
default:
|
|
122
|
+
throw new Error(
|
|
123
|
+
`Invalid config value "${this.options.runIn}" provided in 'techdocs.generator'.`
|
|
124
|
+
);
|
|
125
|
+
}
|
|
126
|
+
} catch (error) {
|
|
127
|
+
await fs__default.default.remove(builtSiteDir);
|
|
128
|
+
this.logger.debug(
|
|
129
|
+
`Failed to generate docs from ${inputDir} into ${outputDir}`
|
|
130
|
+
);
|
|
131
|
+
throw new errors.ForwardedError(
|
|
132
|
+
`Failed to generate docs from ${inputDir} into ${outputDir}`,
|
|
133
|
+
error
|
|
134
|
+
);
|
|
135
|
+
} finally {
|
|
136
|
+
await zensicalHelpers.cleanupZensicalConfig(zensicalConfigPath);
|
|
137
|
+
}
|
|
138
|
+
await fs__default.default.move(builtSiteDir, outputDir, { overwrite: true });
|
|
139
|
+
await zensicalHelpers.normalizeSearchIndex(outputDir, childLogger);
|
|
140
|
+
await alpha.createOrUpdateMetadata(
|
|
141
|
+
path__default.default.join(outputDir, "techdocs_metadata.json"),
|
|
142
|
+
childLogger,
|
|
143
|
+
"zensical"
|
|
144
|
+
);
|
|
145
|
+
if (etag) {
|
|
146
|
+
await alpha.storeEtagMetadata(
|
|
147
|
+
path__default.default.join(outputDir, "techdocs_metadata.json"),
|
|
148
|
+
etag
|
|
149
|
+
);
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
function readZensicalGeneratorConfig(config) {
|
|
154
|
+
return {
|
|
155
|
+
runIn: config.getOptionalString(
|
|
156
|
+
"techdocs.generator.runIn"
|
|
157
|
+
) ?? "docker",
|
|
158
|
+
// Deliberately not falling back to techdocs.generator.dockerImage: that
|
|
159
|
+
// is an MkDocs image and would build the site with MkDocs instead.
|
|
160
|
+
dockerImage: config.getOptionalString(
|
|
161
|
+
"techdocs.generator.zensical.dockerImage"
|
|
162
|
+
),
|
|
163
|
+
pullImage: config.getOptionalBoolean("techdocs.generator.pullImage"),
|
|
164
|
+
pullOptions: config.getOptional("techdocs.generator.pullOptions"),
|
|
165
|
+
dangerouslyAllowAdditionalKeys: config.getOptionalStringArray(
|
|
166
|
+
"techdocs.generator.mkdocs.dangerouslyAllowAdditionalKeys"
|
|
167
|
+
),
|
|
168
|
+
dangerouslyAllowAdditionalPlugins: config.getOptionalStringArray(
|
|
169
|
+
"techdocs.generator.mkdocs.dangerouslyAllowAdditionalPlugins"
|
|
170
|
+
),
|
|
171
|
+
legacyCopyReadmeMdToIndexMd: config.getOptionalBoolean(
|
|
172
|
+
"techdocs.generator.mkdocs.legacyCopyReadmeMdToIndexMd"
|
|
173
|
+
)
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
exports.TechdocsZensicalGenerator = TechdocsZensicalGenerator;
|
|
178
|
+
//# sourceMappingURL=TechdocsZensicalGenerator.cjs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"TechdocsZensicalGenerator.cjs.js","sources":["../../../../../../plugins/techdocs-zensical-internal/src/TechdocsZensicalGenerator.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Config } from '@backstage/config';\nimport fs from 'fs-extra';\nimport path from 'node:path';\nimport { randomUUID } from 'node:crypto';\nimport { getMkdocsYml } from '@backstage/plugin-techdocs-node';\nimport type {\n GeneratorBase,\n GeneratorOptions,\n GeneratorRunOptions,\n TechDocsContainerRunner,\n} from '@backstage/plugin-techdocs-node';\nimport {\n createDockerContainerRunner,\n createOrUpdateMetadata,\n patchIndexPreBuild,\n runCommand,\n sanitizeMkdocsYml,\n storeEtagMetadata,\n validateInputDirectory,\n validateMkdocsYaml,\n} from '@backstage/plugin-techdocs-node/alpha';\nimport type { ContainerRunnerPullOptions } from '@backstage/plugin-techdocs-node';\n\ntype ZensicalGeneratorConfig = {\n runIn: 'docker' | 'local';\n dockerImage?: string;\n pullImage?: boolean;\n pullOptions?: ContainerRunnerPullOptions;\n legacyCopyReadmeMdToIndexMd?: boolean;\n dangerouslyAllowAdditionalKeys?: string[];\n dangerouslyAllowAdditionalPlugins?: string[];\n};\nimport { ForwardedError } from '@backstage/errors';\nimport { LoggerService } from '@backstage/backend-plugin-api';\nimport {\n patchZensicalConfig,\n cleanupZensicalConfig,\n normalizeSearchIndex,\n} from './zensicalHelpers';\n\n/**\n * Generates documentation files using Zensical.\n * @public\n */\nexport class TechdocsZensicalGenerator implements GeneratorBase {\n public static readonly defaultDockerImage =\n 'ghcr.io/backstage/techdocs-zensical:v0.1.0';\n private readonly logger: LoggerService;\n private readonly containerRunner?: TechDocsContainerRunner;\n private readonly options: ZensicalGeneratorConfig;\n\n static fromConfig(config: Config, options: GeneratorOptions) {\n const { containerRunner, logger } = options;\n return new TechdocsZensicalGenerator({\n logger,\n containerRunner,\n config,\n });\n }\n\n constructor(options: {\n logger: LoggerService;\n containerRunner?: TechDocsContainerRunner;\n config: Config;\n }) {\n this.logger = options.logger;\n this.options = readZensicalGeneratorConfig(options.config);\n this.containerRunner = options.containerRunner;\n }\n\n public async run(options: GeneratorRunOptions): Promise<void> {\n const {\n inputDir,\n outputDir,\n etag,\n logger: childLogger,\n logStream,\n siteOptions,\n runAsDefaultUser,\n } = options;\n\n const { path: mkdocsYmlPath, content } = await getMkdocsYml(\n inputDir,\n siteOptions,\n );\n\n const docsDir = await validateMkdocsYaml(inputDir, content);\n\n if (this.options.legacyCopyReadmeMdToIndexMd) {\n await patchIndexPreBuild({ inputDir, logger: childLogger, docsDir });\n }\n\n await validateInputDirectory(inputDir);\n\n const mountDirs = {\n [inputDir]: '/input',\n };\n\n // Zensical requires site_dir to be within the project root.\n // Unique name so we never clobber a site/ directory committed to the repo.\n // Zensical resolves site_dir against the config file's directory, which\n // can be a subdirectory of inputDir (mkdocsConfigFileName).\n const relativeSiteDir = `.techdocs-zensical-site-${randomUUID()}`;\n const builtSiteDir = path.join(\n path.dirname(mkdocsYmlPath),\n relativeSiteDir,\n );\n // Same allowlist as the MkDocs path: Zensical consumes the same\n // mkdocs.yml format and honors options like plantuml_cmd.\n await sanitizeMkdocsYml(\n mkdocsYmlPath,\n childLogger,\n this.options.dangerouslyAllowAdditionalKeys,\n this.options.dangerouslyAllowAdditionalPlugins,\n );\n\n const zensicalConfigPath = await patchZensicalConfig(\n mkdocsYmlPath,\n relativeSiteDir,\n childLogger,\n );\n\n try {\n switch (this.options.runIn) {\n case 'local':\n await runCommand({\n command: 'zensical',\n args: ['build', '-f', zensicalConfigPath],\n options: {\n cwd: inputDir,\n // Don't expose the backend's environment (and its secrets) to\n // the docs build; the Docker path is scoped the same way.\n env: {\n NODE_ENV: process.env.NODE_ENV,\n PATH: process.env.PATH,\n HOME: process.env.HOME,\n },\n },\n logStream,\n });\n childLogger.info(\n `Successfully generated docs from ${inputDir} into ${outputDir} using local zensical`,\n );\n break;\n case 'docker': {\n const containerRunner =\n this.containerRunner || createDockerContainerRunner();\n await containerRunner.runContainer({\n imageName:\n this.options.dockerImage ??\n TechdocsZensicalGenerator.defaultDockerImage,\n // Set the entrypoint explicitly rather than relying on the image's.\n command: ['zensical'],\n args: [\n 'build',\n '-f',\n path.posix.join(\n '/input',\n ...path.relative(inputDir, zensicalConfigPath).split(path.sep),\n ),\n ],\n logStream,\n mountDirs,\n workingDir: '/input',\n envVars: { HOME: '/tmp' },\n pullImage: this.options.pullImage,\n pullOptions: this.options.pullOptions,\n defaultUser: runAsDefaultUser,\n });\n childLogger.info(\n `Successfully generated docs from ${inputDir} into ${outputDir} using zensical container`,\n );\n break;\n }\n default:\n throw new Error(\n `Invalid config value \"${this.options.runIn}\" provided in 'techdocs.generator'.`,\n );\n }\n } catch (error) {\n await fs.remove(builtSiteDir);\n this.logger.debug(\n `Failed to generate docs from ${inputDir} into ${outputDir}`,\n );\n throw new ForwardedError(\n `Failed to generate docs from ${inputDir} into ${outputDir}`,\n error,\n );\n } finally {\n await cleanupZensicalConfig(zensicalConfigPath);\n }\n\n await fs.move(builtSiteDir, outputDir, { overwrite: true });\n\n await normalizeSearchIndex(outputDir, childLogger);\n\n await createOrUpdateMetadata(\n path.join(outputDir, 'techdocs_metadata.json'),\n childLogger,\n 'zensical',\n );\n\n if (etag) {\n await storeEtagMetadata(\n path.join(outputDir, 'techdocs_metadata.json'),\n etag,\n );\n }\n }\n}\n\nfunction readZensicalGeneratorConfig(config: Config): ZensicalGeneratorConfig {\n return {\n runIn:\n (config.getOptionalString(\n 'techdocs.generator.runIn',\n ) as ZensicalGeneratorConfig['runIn']) ?? 'docker',\n // Deliberately not falling back to techdocs.generator.dockerImage: that\n // is an MkDocs image and would build the site with MkDocs instead.\n dockerImage: config.getOptionalString(\n 'techdocs.generator.zensical.dockerImage',\n ),\n pullImage: config.getOptionalBoolean('techdocs.generator.pullImage'),\n pullOptions: config.getOptional('techdocs.generator.pullOptions'),\n dangerouslyAllowAdditionalKeys: config.getOptionalStringArray(\n 'techdocs.generator.mkdocs.dangerouslyAllowAdditionalKeys',\n ),\n dangerouslyAllowAdditionalPlugins: config.getOptionalStringArray(\n 'techdocs.generator.mkdocs.dangerouslyAllowAdditionalPlugins',\n ),\n legacyCopyReadmeMdToIndexMd: config.getOptionalBoolean(\n 'techdocs.generator.mkdocs.legacyCopyReadmeMdToIndexMd',\n ),\n };\n}\n"],"names":["getMkdocsYml","validateMkdocsYaml","patchIndexPreBuild","validateInputDirectory","randomUUID","path","sanitizeMkdocsYml","patchZensicalConfig","runCommand","createDockerContainerRunner","fs","ForwardedError","cleanupZensicalConfig","normalizeSearchIndex","createOrUpdateMetadata","storeEtagMetadata"],"mappings":"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"}
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var fs = require('fs-extra');
|
|
4
|
+
var entities = require('entities');
|
|
5
|
+
var yaml = require('js-yaml');
|
|
6
|
+
var path = require('node:path');
|
|
7
|
+
var node_crypto = require('node:crypto');
|
|
8
|
+
var alpha = require('@backstage/plugin-techdocs-node/alpha');
|
|
9
|
+
|
|
10
|
+
function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
|
|
11
|
+
|
|
12
|
+
var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
|
|
13
|
+
var yaml__default = /*#__PURE__*/_interopDefaultCompat(yaml);
|
|
14
|
+
var path__default = /*#__PURE__*/_interopDefaultCompat(path);
|
|
15
|
+
|
|
16
|
+
const TECHDOCS_ZENSICAL_CORE_EXTENSIONS = [
|
|
17
|
+
"admonition",
|
|
18
|
+
"toc",
|
|
19
|
+
"pymdownx.details",
|
|
20
|
+
"pymdownx.tabbed",
|
|
21
|
+
"pymdownx.caret",
|
|
22
|
+
"pymdownx.critic",
|
|
23
|
+
"pymdownx.emoji",
|
|
24
|
+
"pymdownx.inlinehilite",
|
|
25
|
+
"pymdownx.magiclink",
|
|
26
|
+
"pymdownx.mark",
|
|
27
|
+
"pymdownx.smartsymbols",
|
|
28
|
+
"pymdownx.snippets",
|
|
29
|
+
"pymdownx.highlight",
|
|
30
|
+
"pymdownx.extra",
|
|
31
|
+
"pymdownx.tasklist",
|
|
32
|
+
"pymdownx.tilde"
|
|
33
|
+
];
|
|
34
|
+
const TECHDOCS_ZENSICAL_EXTRA_EXTENSIONS = [
|
|
35
|
+
"plantuml_markdown",
|
|
36
|
+
"markdown_inline_graphviz",
|
|
37
|
+
"mdx_truly_sane_lists"
|
|
38
|
+
];
|
|
39
|
+
const TECHDOCS_ZENSICAL_EXTENSION_OPTIONS = {
|
|
40
|
+
"pymdownx.snippets": {
|
|
41
|
+
restrict_base_path: true
|
|
42
|
+
},
|
|
43
|
+
"pymdownx.tabbed": {
|
|
44
|
+
alternate_style: true
|
|
45
|
+
},
|
|
46
|
+
toc: {
|
|
47
|
+
permalink: true
|
|
48
|
+
}
|
|
49
|
+
};
|
|
50
|
+
const TECHDOCS_ZENSICAL_LOCKED_EXTENSIONS = /* @__PURE__ */ new Set(["pymdownx.snippets"]);
|
|
51
|
+
const TECHDOCS_ZENSICAL_EXTENSION_ALIASES = {
|
|
52
|
+
"pymdownx.snippets:SnippetExtension": "pymdownx.snippets"
|
|
53
|
+
};
|
|
54
|
+
function isRecord(value) {
|
|
55
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
56
|
+
}
|
|
57
|
+
function readNamedEntries(value) {
|
|
58
|
+
const entries = /* @__PURE__ */ new Map();
|
|
59
|
+
const add = (name, options) => {
|
|
60
|
+
entries.set(name, isRecord(options) ? options : void 0);
|
|
61
|
+
};
|
|
62
|
+
if (Array.isArray(value)) {
|
|
63
|
+
for (const item of value) {
|
|
64
|
+
if (typeof item === "string") {
|
|
65
|
+
add(item, void 0);
|
|
66
|
+
} else if (isRecord(item)) {
|
|
67
|
+
for (const [name, options] of Object.entries(item)) {
|
|
68
|
+
add(name, options);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
} else if (isRecord(value)) {
|
|
73
|
+
for (const [name, options] of Object.entries(value)) {
|
|
74
|
+
add(name, options);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
return entries;
|
|
78
|
+
}
|
|
79
|
+
function writeNamedEntries(entries) {
|
|
80
|
+
return [...entries].map(
|
|
81
|
+
([name, options]) => options ? { [name]: options } : name
|
|
82
|
+
);
|
|
83
|
+
}
|
|
84
|
+
async function patchZensicalConfig(mkdocsYmlPath, siteDir, logger) {
|
|
85
|
+
const content = await fs__default.default.readFile(mkdocsYmlPath, "utf8");
|
|
86
|
+
const config = yaml__default.default.load(content, { schema: alpha.MKDOCS_SCHEMA });
|
|
87
|
+
const theme = isRecord(config.theme) ? config.theme : {};
|
|
88
|
+
const features = Array.isArray(theme.features) ? theme.features : [];
|
|
89
|
+
config.theme = {
|
|
90
|
+
...theme,
|
|
91
|
+
name: "material",
|
|
92
|
+
custom_dir: void 0,
|
|
93
|
+
features: [.../* @__PURE__ */ new Set([...features, "navigation.footer"])],
|
|
94
|
+
font: false
|
|
95
|
+
};
|
|
96
|
+
delete config.theme.palette;
|
|
97
|
+
config.site_dir = siteDir;
|
|
98
|
+
const extensions = readNamedEntries(config.markdown_extensions);
|
|
99
|
+
for (const [alias, name] of Object.entries(
|
|
100
|
+
TECHDOCS_ZENSICAL_EXTENSION_ALIASES
|
|
101
|
+
)) {
|
|
102
|
+
if (extensions.has(alias)) {
|
|
103
|
+
const options = extensions.get(alias);
|
|
104
|
+
extensions.delete(alias);
|
|
105
|
+
extensions.set(name, { ...options, ...extensions.get(name) });
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
for (const name of [
|
|
109
|
+
...TECHDOCS_ZENSICAL_CORE_EXTENSIONS,
|
|
110
|
+
...TECHDOCS_ZENSICAL_EXTRA_EXTENSIONS
|
|
111
|
+
]) {
|
|
112
|
+
const defaults = TECHDOCS_ZENSICAL_EXTENSION_OPTIONS[name];
|
|
113
|
+
const existing = TECHDOCS_ZENSICAL_LOCKED_EXTENSIONS.has(name) ? void 0 : extensions.get(name);
|
|
114
|
+
extensions.set(
|
|
115
|
+
name,
|
|
116
|
+
defaults || existing ? { ...defaults, ...existing } : void 0
|
|
117
|
+
);
|
|
118
|
+
}
|
|
119
|
+
config.markdown_extensions = writeNamedEntries(extensions);
|
|
120
|
+
if (config.plugins !== void 0) {
|
|
121
|
+
const plugins = readNamedEntries(config.plugins);
|
|
122
|
+
plugins.delete("techdocs-core");
|
|
123
|
+
config.plugins = writeNamedEntries(plugins);
|
|
124
|
+
}
|
|
125
|
+
const zensicalConfigPath = path__default.default.join(
|
|
126
|
+
path__default.default.dirname(mkdocsYmlPath),
|
|
127
|
+
`.mkdocs.zensical-${node_crypto.randomUUID()}.yml`
|
|
128
|
+
);
|
|
129
|
+
await fs__default.default.writeFile(
|
|
130
|
+
zensicalConfigPath,
|
|
131
|
+
yaml__default.default.dump(config, { schema: alpha.MKDOCS_SCHEMA })
|
|
132
|
+
);
|
|
133
|
+
logger.info(`Wrote Zensical config to ${zensicalConfigPath}`);
|
|
134
|
+
return zensicalConfigPath;
|
|
135
|
+
}
|
|
136
|
+
async function cleanupZensicalConfig(zensicalConfigPath) {
|
|
137
|
+
try {
|
|
138
|
+
await fs__default.default.remove(zensicalConfigPath);
|
|
139
|
+
} catch {
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
async function normalizeSearchIndex(outputDir, logger) {
|
|
143
|
+
const zensicalSearchPath = path__default.default.join(outputDir, "search.json");
|
|
144
|
+
const mkdocsSearchDir = path__default.default.join(outputDir, "search");
|
|
145
|
+
const mkdocsSearchPath = path__default.default.join(mkdocsSearchDir, "search_index.json");
|
|
146
|
+
if (!await fs__default.default.pathExists(zensicalSearchPath)) {
|
|
147
|
+
logger.warn("Zensical search.json not found; search indexing may not work");
|
|
148
|
+
return;
|
|
149
|
+
}
|
|
150
|
+
try {
|
|
151
|
+
const raw = await fs__default.default.readJson(zensicalSearchPath);
|
|
152
|
+
const items = raw.items ?? raw.docs ?? [];
|
|
153
|
+
const docs = items.map(
|
|
154
|
+
(item) => ({
|
|
155
|
+
title: item.title ?? "",
|
|
156
|
+
text: stripHtmlTags(item.text ?? ""),
|
|
157
|
+
location: item.location ?? ""
|
|
158
|
+
})
|
|
159
|
+
);
|
|
160
|
+
await fs__default.default.ensureDir(mkdocsSearchDir);
|
|
161
|
+
await fs__default.default.writeJson(mkdocsSearchPath, {
|
|
162
|
+
config: raw.config ?? {},
|
|
163
|
+
docs
|
|
164
|
+
});
|
|
165
|
+
logger.info(
|
|
166
|
+
`Normalized search index: ${docs.length} entries written to search/search_index.json`
|
|
167
|
+
);
|
|
168
|
+
} catch (error) {
|
|
169
|
+
logger.warn(`Failed to normalize search index: ${error}`);
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
function stripHtmlTags(html) {
|
|
173
|
+
let text = html;
|
|
174
|
+
let previous;
|
|
175
|
+
do {
|
|
176
|
+
previous = text;
|
|
177
|
+
text = text.replace(/<[^>]*>/g, "");
|
|
178
|
+
} while (text !== previous);
|
|
179
|
+
return entities.decodeHTML(text.replace(/[<>]/g, "")).replace(/\s+/g, " ").trim();
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
exports.cleanupZensicalConfig = cleanupZensicalConfig;
|
|
183
|
+
exports.normalizeSearchIndex = normalizeSearchIndex;
|
|
184
|
+
exports.patchZensicalConfig = patchZensicalConfig;
|
|
185
|
+
//# sourceMappingURL=zensicalHelpers.cjs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"zensicalHelpers.cjs.js","sources":["../../../../../../plugins/techdocs-zensical-internal/src/zensicalHelpers.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport fs from 'fs-extra';\nimport { decodeHTML } from 'entities';\nimport yaml from 'js-yaml';\nimport path from 'node:path';\nimport { randomUUID } from 'node:crypto';\nimport { LoggerService } from '@backstage/backend-plugin-api';\nimport { MKDOCS_SCHEMA } from '@backstage/plugin-techdocs-node/alpha';\n\ntype NamedOptions = Record<string, unknown> | undefined;\n\nconst TECHDOCS_ZENSICAL_CORE_EXTENSIONS = [\n 'admonition',\n 'toc',\n 'pymdownx.details',\n 'pymdownx.tabbed',\n 'pymdownx.caret',\n 'pymdownx.critic',\n 'pymdownx.emoji',\n 'pymdownx.inlinehilite',\n 'pymdownx.magiclink',\n 'pymdownx.mark',\n 'pymdownx.smartsymbols',\n 'pymdownx.snippets',\n 'pymdownx.highlight',\n 'pymdownx.extra',\n 'pymdownx.tasklist',\n 'pymdownx.tilde',\n];\n\nconst TECHDOCS_ZENSICAL_EXTRA_EXTENSIONS = [\n 'plantuml_markdown',\n 'markdown_inline_graphviz',\n 'mdx_truly_sane_lists',\n];\n\n/**\n * Options for the TechDocs extensions, set inline on each markdown_extensions\n * entry. Zensical rebuilds mdx_configs from markdown_extensions, so options\n * set through mdx_configs are ignored.\n */\nconst TECHDOCS_ZENSICAL_EXTENSION_OPTIONS: Record<string, NamedOptions> = {\n 'pymdownx.snippets': {\n restrict_base_path: true,\n },\n 'pymdownx.tabbed': {\n alternate_style: true,\n },\n toc: {\n permalink: true,\n },\n};\n\n/**\n * Extensions whose user options are ignored. Snippets options such as\n * `restrict_base_path: false` or `base_path` let docs include files from\n * outside the docs directory, and `techdocs-cli serve` doesn't sanitize\n * mkdocs.yml before building.\n */\nconst TECHDOCS_ZENSICAL_LOCKED_EXTENSIONS = new Set(['pymdownx.snippets']);\n\n/**\n * Alternate names the sanitizer accepts for TechDocs extensions, so they are\n * merged with (and locked like) the canonical entry instead of listed twice.\n */\nconst TECHDOCS_ZENSICAL_EXTENSION_ALIASES: Record<string, string> = {\n 'pymdownx.snippets:SnippetExtension': 'pymdownx.snippets',\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Reads an mkdocs.yml list of named entries (markdown_extensions or plugins)\n * into name/options pairs. Accepts every form MkDocs accepts: a list of\n * names, a list mixing names and single-key mappings, or a mapping.\n */\nfunction readNamedEntries(value: unknown): Map<string, NamedOptions> {\n const entries = new Map<string, NamedOptions>();\n const add = (name: string, options: unknown) => {\n entries.set(name, isRecord(options) ? options : undefined);\n };\n if (Array.isArray(value)) {\n for (const item of value) {\n if (typeof item === 'string') {\n add(item, undefined);\n } else if (isRecord(item)) {\n for (const [name, options] of Object.entries(item)) {\n add(name, options);\n }\n }\n }\n } else if (isRecord(value)) {\n for (const [name, options] of Object.entries(value)) {\n add(name, options);\n }\n }\n return entries;\n}\n\n/** Writes name/options pairs back as an mkdocs.yml list. */\nfunction writeNamedEntries(\n entries: Map<string, NamedOptions>,\n): Array<string | Record<string, unknown>> {\n return [...entries].map(([name, options]) =>\n options ? { [name]: options } : name,\n );\n}\n\n/**\n * Patches mkdocs.yml for Zensical builds: sets classic theme, injects markdown\n * extensions, sets site_dir, and removes the techdocs-core plugin.\n *\n * Writes to a uniquely named temporary file so the original config is not modified.\n *\n * @param mkdocsYmlPath - Path to the mkdocs.yml to patch.\n * @param siteDir - Output directory, relative to the mkdocs.yml directory.\n * @param logger - Logger for progress messages.\n * @returns Path to the patched temporary config.\n *\n * @public\n */\nexport async function patchZensicalConfig(\n mkdocsYmlPath: string,\n siteDir: string,\n logger: Pick<LoggerService, 'info'>,\n): Promise<string> {\n const content = await fs.readFile(mkdocsYmlPath, 'utf8');\n const config = yaml.load(content, { schema: MKDOCS_SCHEMA }) as Record<\n string,\n unknown\n >;\n\n const theme = isRecord(config.theme) ? config.theme : {};\n const features = Array.isArray(theme.features) ? theme.features : [];\n config.theme = {\n ...theme,\n name: 'material',\n custom_dir: undefined,\n features: [...new Set([...features, 'navigation.footer'])],\n font: false,\n };\n // Remove palette entirely — the TechDocs frontend handles dark/light\n // theming via CSS variable overrides in the shadow DOM. Leaving palette\n // in causes Zensical to emit data-md-color-scheme=\"default\" on <body>\n // which locks the output to light mode.\n delete (config.theme as Record<string, unknown>).palette;\n\n config.site_dir = siteDir;\n\n const extensions = readNamedEntries(config.markdown_extensions);\n for (const [alias, name] of Object.entries(\n TECHDOCS_ZENSICAL_EXTENSION_ALIASES,\n )) {\n if (extensions.has(alias)) {\n const options = extensions.get(alias);\n extensions.delete(alias);\n extensions.set(name, { ...options, ...extensions.get(name) });\n }\n }\n for (const name of [\n ...TECHDOCS_ZENSICAL_CORE_EXTENSIONS,\n ...TECHDOCS_ZENSICAL_EXTRA_EXTENSIONS,\n ]) {\n const defaults = TECHDOCS_ZENSICAL_EXTENSION_OPTIONS[name];\n const existing = TECHDOCS_ZENSICAL_LOCKED_EXTENSIONS.has(name)\n ? undefined\n : extensions.get(name);\n extensions.set(\n name,\n defaults || existing ? { ...defaults, ...existing } : undefined,\n );\n }\n config.markdown_extensions = writeNamedEntries(extensions);\n\n if (config.plugins !== undefined) {\n const plugins = readNamedEntries(config.plugins);\n plugins.delete('techdocs-core');\n config.plugins = writeNamedEntries(plugins);\n }\n\n const zensicalConfigPath = path.join(\n path.dirname(mkdocsYmlPath),\n `.mkdocs.zensical-${randomUUID()}.yml`,\n );\n await fs.writeFile(\n zensicalConfigPath,\n yaml.dump(config, { schema: MKDOCS_SCHEMA }),\n );\n\n logger.info(`Wrote Zensical config to ${zensicalConfigPath}`);\n return zensicalConfigPath;\n}\n\n/**\n * Removes a temporary config written by {@link patchZensicalConfig}.\n *\n * @public\n */\nexport async function cleanupZensicalConfig(\n zensicalConfigPath: string,\n): Promise<void> {\n try {\n await fs.remove(zensicalConfigPath);\n } catch {\n // Ignore cleanup errors\n }\n}\n\n/**\n * Normalizes Zensical's search output to the MkDocs format expected by the\n * TechDocs search collator.\n *\n * Zensical: search.json with { config, items: [...] } (HTML in text)\n * MkDocs: search/search_index.json with { config, docs: [...] } (plain text)\n */\nexport async function normalizeSearchIndex(\n outputDir: string,\n logger: LoggerService,\n): Promise<void> {\n const zensicalSearchPath = path.join(outputDir, 'search.json');\n const mkdocsSearchDir = path.join(outputDir, 'search');\n const mkdocsSearchPath = path.join(mkdocsSearchDir, 'search_index.json');\n\n if (!(await fs.pathExists(zensicalSearchPath))) {\n logger.warn('Zensical search.json not found; search indexing may not work');\n return;\n }\n\n try {\n const raw = await fs.readJson(zensicalSearchPath);\n const items = raw.items ?? raw.docs ?? [];\n\n const docs = items.map(\n (item: { title?: string; text?: string; location?: string }) => ({\n title: item.title ?? '',\n text: stripHtmlTags(item.text ?? ''),\n location: item.location ?? '',\n }),\n );\n\n await fs.ensureDir(mkdocsSearchDir);\n await fs.writeJson(mkdocsSearchPath, {\n config: raw.config ?? {},\n docs,\n });\n\n logger.info(\n `Normalized search index: ${docs.length} entries written to search/search_index.json`,\n );\n } catch (error) {\n logger.warn(`Failed to normalize search index: ${error}`);\n }\n}\n\nfunction stripHtmlTags(html: string): string {\n // Repeat until stable so removing one tag can't join fragments into another.\n let text = html;\n let previous;\n do {\n previous = text;\n text = text.replace(/<[^>]*>/g, '');\n } while (text !== previous);\n // Decode last, so entities like < become text rather than tags.\n return decodeHTML(text.replace(/[<>]/g, '')).replace(/\\s+/g, ' ').trim();\n}\n"],"names":["fs","yaml","MKDOCS_SCHEMA","path","randomUUID","decodeHTML"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@techdocs/cli",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.14.0",
|
|
4
4
|
"description": "Utility CLI for managing TechDocs sites in Backstage.",
|
|
5
5
|
"backstage": {
|
|
6
6
|
"role": "cli"
|
|
@@ -45,18 +45,22 @@
|
|
|
45
45
|
},
|
|
46
46
|
"dependencies": {
|
|
47
47
|
"@backstage/backend-defaults": "^0.18.1",
|
|
48
|
+
"@backstage/backend-plugin-api": "^1.11.0",
|
|
48
49
|
"@backstage/catalog-model": "^1.10.2",
|
|
49
50
|
"@backstage/cli-common": "^0.3.2",
|
|
50
51
|
"@backstage/config": "^1.3.10",
|
|
51
|
-
"@backstage/
|
|
52
|
+
"@backstage/errors": "^1.3.2",
|
|
53
|
+
"@backstage/plugin-techdocs-node": "^2.2.0",
|
|
52
54
|
"commander": "^14.0.3",
|
|
55
|
+
"entities": "^4.5.0",
|
|
53
56
|
"fs-extra": "^11.0.0",
|
|
54
57
|
"http-proxy": "^1.18.1",
|
|
55
58
|
"js-yaml": "^5.4.2",
|
|
56
59
|
"json5": "^2.1.3",
|
|
57
60
|
"react-dev-utils": "^12.0.0-next.60",
|
|
58
61
|
"serve-handler": "^6.1.3",
|
|
59
|
-
"winston": "^3.2.1"
|
|
62
|
+
"winston": "^3.2.1",
|
|
63
|
+
"ws": "^8.0.0"
|
|
60
64
|
},
|
|
61
65
|
"devDependencies": {
|
|
62
66
|
"@backstage/cli": "^0.36.7",
|
|
@@ -65,6 +69,7 @@
|
|
|
65
69
|
"@types/node": "^22.13.14",
|
|
66
70
|
"@types/serve-handler": "^6.1.0",
|
|
67
71
|
"@types/webpack-env": "^1.15.3",
|
|
72
|
+
"@types/ws": "^8.0.0",
|
|
68
73
|
"find-process": "^2.0.0",
|
|
69
74
|
"nodemon": "^3.0.1",
|
|
70
75
|
"techdocs-cli-embedded-app": "link:../techdocs-cli-embedded-app"
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"engineConfig.cjs.js","sources":["../../src/lib/engineConfig.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport http from 'node:http';\nimport { TECHDOCS_ENGINE_CATALOG_ANNOTATION_KEY } from '@backstage/plugin-techdocs-node';\nimport type { EngineSource } from './catalogEntity';\nimport {\n injectLivereloadParameters,\n proxyMkdocsLivereload,\n} from './livereload';\n\nexport type ServeOptions = {\n configFile?: string;\n clean?: boolean;\n dirtyReload?: boolean;\n strict?: boolean;\n useDocker?: boolean;\n};\n\nexport type EngineConfig = {\n binary: string;\n defaultImage: string;\n serveCommand: string;\n startupLogPattern: string;\n buildArgs(outputDir: string, configFile: string): string[];\n serveArgs(port: string, options: ServeOptions): string[];\n transformHtml(html: string): string;\n handleReloadRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n targetAddress: string,\n onError: (error: Error) => void,\n ): void;\n};\n\nconst mkdocsConfig: EngineConfig = {\n binary: 'mkdocs',\n defaultImage: 'spotify/techdocs',\n serveCommand: 'serve',\n startupLogPattern: 'Serving on',\n buildArgs(outputDir: string, configFile: string): string[] {\n return ['build', '-f', configFile, '-d', outputDir, '-v'];\n },\n serveArgs(port: string, options: ServeOptions): string[] {\n const addr = options.useDocker ? `0.0.0.0:${port}` : `127.0.0.1:${port}`;\n return [\n 'serve',\n '--dev-addr',\n addr,\n '--livereload',\n ...(options.configFile ? ['--config-file', options.configFile] : []),\n ...(options.clean ? ['--clean'] : []),\n ...(options.dirtyReload ? ['--dirtyreload'] : []),\n ...(options.strict ? ['--strict'] : []),\n ];\n },\n transformHtml(html: string): string {\n return injectLivereloadParameters(html);\n },\n handleReloadRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n targetAddress: string,\n onError: (error: Error) => void,\n ): void {\n proxyMkdocsLivereload({\n request: req,\n response: res,\n mkdocsTargetAddress: targetAddress,\n onError,\n });\n },\n};\n\nconst engineConfigs: Record<string, EngineConfig> = {\n mkdocs: mkdocsConfig,\n};\n\nexport function getEngineConfig(\n engine: string,\n source: EngineSource = 'default',\n): EngineConfig {\n const config = engineConfigs[engine];\n if (!config) {\n const supported = Object.keys(engineConfigs).join(', ');\n const origin = {\n flag: 'from --engine',\n annotation: `from the ${TECHDOCS_ENGINE_CATALOG_ANNOTATION_KEY} annotation in catalog-info.yaml`,\n default: 'default',\n }[source];\n const hint = source === 'annotation' ? ' Pass --engine to override.' : '';\n throw new Error(\n `Engine \"${engine}\" (${origin}) is not supported by techdocs-cli. Supported engines: ${supported}.${hint}`,\n );\n }\n return config;\n}\n"],"names":["injectLivereloadParameters","proxyMkdocsLivereload","TECHDOCS_ENGINE_CATALOG_ANNOTATION_KEY"],"mappings":";;;;;AAgDA,MAAM,YAAA,GAA6B;AAAA,EACjC,MAAA,EAAQ,QAAA;AAAA,EACR,YAAA,EAAc,kBAAA;AAAA,EACd,YAAA,EAAc,OAAA;AAAA,EACd,iBAAA,EAAmB,YAAA;AAAA,EACnB,SAAA,CAAU,WAAmB,UAAA,EAA8B;AACzD,IAAA,OAAO,CAAC,OAAA,EAAS,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,WAAW,IAAI,CAAA;AAAA,EAC1D,CAAA;AAAA,EACA,SAAA,CAAU,MAAc,OAAA,EAAiC;AACvD,IAAA,MAAM,OAAO,OAAA,CAAQ,SAAA,GAAY,WAAW,IAAI,CAAA,CAAA,GAAK,aAAa,IAAI,CAAA,CAAA;AACtE,IAAA,OAAO;AAAA,MACL,OAAA;AAAA,MACA,YAAA;AAAA,MACA,IAAA;AAAA,MACA,cAAA;AAAA,MACA,GAAI,QAAQ,UAAA,GAAa,CAAC,iBAAiB,OAAA,CAAQ,UAAU,IAAI,EAAC;AAAA,MAClE,GAAI,OAAA,CAAQ,KAAA,GAAQ,CAAC,SAAS,IAAI,EAAC;AAAA,MACnC,GAAI,OAAA,CAAQ,WAAA,GAAc,CAAC,eAAe,IAAI,EAAC;AAAA,MAC/C,GAAI,OAAA,CAAQ,MAAA,GAAS,CAAC,UAAU,IAAI;AAAC,KACvC;AAAA,EACF,CAAA;AAAA,EACA,cAAc,IAAA,EAAsB;AAClC,IAAA,OAAOA,sCAA2B,IAAI,CAAA;AAAA,EACxC,CAAA;AAAA,EACA,mBAAA,CACE,GAAA,EACA,GAAA,EACA,aAAA,EACA,OAAA,EACM;AACN,IAAAC,gCAAA,CAAsB;AAAA,MACpB,OAAA,EAAS,GAAA;AAAA,MACT,QAAA,EAAU,GAAA;AAAA,MACV,mBAAA,EAAqB,aAAA;AAAA,MACrB;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAEA,MAAM,aAAA,GAA8C;AAAA,EAClD,MAAA,EAAQ;AACV,CAAA;AAEO,SAAS,eAAA,CACd,MAAA,EACA,MAAA,GAAuB,SAAA,EACT;AACd,EAAA,MAAM,MAAA,GAAS,cAAc,MAAM,CAAA;AACnC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,YAAY,MAAA,CAAO,IAAA,CAAK,aAAa,CAAA,CAAE,KAAK,IAAI,CAAA;AACtD,IAAA,MAAM,MAAA,GAAS;AAAA,MACb,IAAA,EAAM,eAAA;AAAA,MACN,UAAA,EAAY,YAAYC,yDAAsC,CAAA,gCAAA,CAAA;AAAA,MAC9D,OAAA,EAAS;AAAA,MACT,MAAM,CAAA;AACR,IAAA,MAAM,IAAA,GAAO,MAAA,KAAW,YAAA,GAAe,6BAAA,GAAgC,EAAA;AACvE,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,WAAW,MAAM,CAAA,GAAA,EAAM,MAAM,CAAA,uDAAA,EAA0D,SAAS,IAAI,IAAI,CAAA;AAAA,KAC1G;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;;"}
|
|
File without changes
|