@takazudo/zudo-doc 5.7.0 → 5.9.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.
Files changed (54) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/README.md +17 -0
  3. package/dist/config.d.ts +18 -0
  4. package/dist/config.js +1 -0
  5. package/dist/eject/index.js +9 -0
  6. package/dist/i18n-defaults/index.js +3 -0
  7. package/dist/plugins/codex-resources.d.ts +4 -0
  8. package/dist/plugins/codex-resources.js +31 -0
  9. package/dist/plugins/internal/claude-resources/generate.js +20 -291
  10. package/dist/plugins/internal/codex-resources/agents-md.d.ts +6 -0
  11. package/dist/plugins/internal/codex-resources/agents-md.js +70 -0
  12. package/dist/plugins/internal/codex-resources/agents.d.ts +7 -0
  13. package/dist/plugins/internal/codex-resources/agents.js +104 -0
  14. package/dist/plugins/internal/codex-resources/config.d.ts +6 -0
  15. package/dist/plugins/internal/codex-resources/config.js +111 -0
  16. package/dist/plugins/internal/codex-resources/generate.d.ts +20 -0
  17. package/dist/plugins/internal/codex-resources/generate.js +34 -0
  18. package/dist/plugins/internal/codex-resources/hooks.d.ts +6 -0
  19. package/dist/plugins/internal/codex-resources/hooks.js +174 -0
  20. package/dist/plugins/internal/codex-resources/index.d.ts +24 -0
  21. package/dist/plugins/internal/codex-resources/index.js +21 -0
  22. package/dist/plugins/internal/codex-resources/overview.d.ts +10 -0
  23. package/dist/plugins/internal/codex-resources/overview.js +33 -0
  24. package/dist/plugins/internal/codex-resources/rules.d.ts +6 -0
  25. package/dist/plugins/internal/codex-resources/rules.js +255 -0
  26. package/dist/plugins/internal/codex-resources/skills.d.ts +2 -0
  27. package/dist/plugins/internal/codex-resources/skills.js +84 -0
  28. package/dist/plugins/internal/codex-resources/utils.d.ts +14 -0
  29. package/dist/plugins/internal/codex-resources/utils.js +80 -0
  30. package/dist/plugins/internal/resource-docs-shared/fs.d.ts +3 -0
  31. package/dist/plugins/internal/resource-docs-shared/fs.js +19 -0
  32. package/dist/plugins/internal/resource-docs-shared/index.d.ts +7 -0
  33. package/dist/plugins/internal/resource-docs-shared/index.js +44 -0
  34. package/dist/plugins/internal/resource-docs-shared/links.d.ts +22 -0
  35. package/dist/plugins/internal/resource-docs-shared/links.js +44 -0
  36. package/dist/plugins/internal/resource-docs-shared/markdown-structure.d.ts +9 -0
  37. package/dist/plugins/internal/resource-docs-shared/markdown-structure.js +22 -0
  38. package/dist/plugins/internal/resource-docs-shared/mdx.d.ts +23 -0
  39. package/dist/plugins/internal/resource-docs-shared/mdx.js +63 -0
  40. package/dist/plugins/internal/resource-docs-shared/skills.d.ts +37 -0
  41. package/dist/plugins/internal/resource-docs-shared/skills.js +318 -0
  42. package/dist/plugins/internal/resource-docs-shared/walk.d.ts +20 -0
  43. package/dist/plugins/internal/resource-docs-shared/walk.js +41 -0
  44. package/dist/preset.d.ts +8 -0
  45. package/dist/preset.js +11 -0
  46. package/dist/safelist.css +1 -1
  47. package/dist/settings.d.ts +5 -0
  48. package/dist/transitions/nested-island-props-refresh.js +9 -3
  49. package/eject/header/gen-nav-overflow-script.mjs +771 -0
  50. package/eject/header/header.tsx +2 -0
  51. package/eject/header/nav-overflow-script.ts +11 -8
  52. package/package.json +9 -4
  53. /package/dist/plugins/internal/{claude-resources → resource-docs-shared}/escape-for-mdx.d.ts +0 -0
  54. /package/dist/plugins/internal/{claude-resources → resource-docs-shared}/escape-for-mdx.js +0 -0
@@ -0,0 +1,63 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import matter from "gray-matter";
4
+ function parseFrontmatter(content) {
5
+ try {
6
+ return matter(content);
7
+ } catch {
8
+ return null;
9
+ }
10
+ }
11
+ function escapeTitle(s) {
12
+ return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
13
+ }
14
+ function formatFrontmatterString(value) {
15
+ if (!/[\r\n]/.test(value)) {
16
+ try {
17
+ const parsed = matter(`---
18
+ value: ${value}
19
+ ---
20
+ `).data.value;
21
+ if (parsed === value) return value;
22
+ } catch {
23
+ }
24
+ }
25
+ return JSON.stringify(value);
26
+ }
27
+ function writeCategoryIndex(outputDir, label, position, description, renderString = (value) => `"${escapeTitle(value)}"`) {
28
+ const mdx = `---
29
+ title: ${renderString(label)}
30
+ description: ${renderString(description)}
31
+ sidebar_position: ${position}
32
+ category_no_page: true
33
+ generated: true
34
+ ---
35
+ `;
36
+ fs.writeFileSync(path.join(outputDir, "index.mdx"), mdx);
37
+ }
38
+ function writeUnlistedSubPage(outputPath, title, body, renderString = (value) => `"${escapeTitle(value)}"`) {
39
+ fs.writeFileSync(
40
+ outputPath,
41
+ `---
42
+ title: ${renderString(title)}
43
+ unlisted: true
44
+ generated: true
45
+ ---
46
+
47
+ ${body}
48
+ `
49
+ );
50
+ }
51
+ function assertNotIndexReserved(nameOrSlug, errorMessage) {
52
+ if (nameOrSlug === "index") {
53
+ throw new Error(errorMessage);
54
+ }
55
+ }
56
+ export {
57
+ assertNotIndexReserved,
58
+ escapeTitle,
59
+ formatFrontmatterString,
60
+ parseFrontmatter,
61
+ writeCategoryIndex,
62
+ writeUnlistedSubPage
63
+ };
@@ -0,0 +1,37 @@
1
+ import { type FrontmatterStringRenderer } from "./mdx.js";
2
+ export interface SkillReference {
3
+ name: string;
4
+ title: string;
5
+ content: string;
6
+ }
7
+ export interface SkillItem {
8
+ name: string;
9
+ dir: string;
10
+ description: string;
11
+ references: SkillReference[];
12
+ }
13
+ export type RenderExtraHeader = (skillAbsDir: string) => string;
14
+ export interface GenerateSkillsCategoryOptions {
15
+ skillsDirs: string[];
16
+ outputDir: string;
17
+ label: string;
18
+ position: number;
19
+ description: string;
20
+ sourceLabel: string;
21
+ renderExtraHeader?: RenderExtraHeader;
22
+ renderFrontmatterString?: FrontmatterStringRenderer;
23
+ }
24
+ export declare function getSkillFileTree(skillDir: string, subDirs: {
25
+ name: string;
26
+ files: string[];
27
+ }[]): string;
28
+ export declare function getScriptDescription(filePath: string): string;
29
+ export declare function getSkillReferences(skillsDir: string, skillDir: string): SkillReference[];
30
+ /**
31
+ * Generate a category containing Claude/Codex-shaped skill packages.
32
+ *
33
+ * Roots are considered in order. A root reached through more than one path is
34
+ * visited once; when distinct roots contain the same skill name, the first
35
+ * root wins and the later package is skipped.
36
+ */
37
+ export declare function generateSkillsCategory({ skillsDirs, outputDir, label, position, description, sourceLabel, renderExtraHeader, renderFrontmatterString, }: GenerateSkillsCategoryOptions): SkillItem[];
@@ -0,0 +1,318 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { escapeForMdx } from "./escape-for-mdx.js";
4
+ import {
5
+ assertNotIndexReserved,
6
+ escapeTitle,
7
+ parseFrontmatter,
8
+ writeCategoryIndex,
9
+ writeUnlistedSubPage
10
+ } from "./mdx.js";
11
+ import { cleanDir, ensureDir, listFiles } from "./fs.js";
12
+ function getSkillFileTree(skillDir, subDirs) {
13
+ const lines = [`${skillDir}/`];
14
+ const entries = [{ isDir: false, name: "SKILL.md" }];
15
+ for (const sub of subDirs) {
16
+ entries.push({ isDir: true, name: sub.name, children: sub.files });
17
+ }
18
+ for (let i = 0; i < entries.length; i++) {
19
+ const entry = entries[i];
20
+ if (!entry) continue;
21
+ const isLast = i === entries.length - 1;
22
+ const prefix = isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
23
+ if (!entry.isDir) {
24
+ lines.push(`${prefix}${entry.name}`);
25
+ } else {
26
+ lines.push(`${prefix}${entry.name}/`);
27
+ for (let j = 0; j < entry.children.length; j++) {
28
+ const child = entry.children[j];
29
+ if (!child) continue;
30
+ const childIsLast = j === entry.children.length - 1;
31
+ const continuation = isLast ? " " : "\u2502 ";
32
+ const childPrefix = childIsLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
33
+ lines.push(`${continuation}${childPrefix}${child}`);
34
+ }
35
+ }
36
+ }
37
+ return lines.join("\n");
38
+ }
39
+ function getScriptDescription(filePath) {
40
+ try {
41
+ const topLines = fs.readFileSync(filePath, "utf8").split("\n", 2);
42
+ const firstLine = topLines[0] ?? "";
43
+ const commentLine = firstLine.startsWith("#!") ? topLines[1] ?? "" : firstLine;
44
+ const match = commentLine.match(/^(?:#|\/\/)\s*(.+)/);
45
+ return match ? ` \u2014 ${match[1]}` : "";
46
+ } catch {
47
+ return "";
48
+ }
49
+ }
50
+ function getSkillReferences(skillsDir, skillDir) {
51
+ const refsDir = path.join(skillsDir, skillDir, "references");
52
+ if (!fs.existsSync(refsDir)) return [];
53
+ let files;
54
+ try {
55
+ files = fs.readdirSync(refsDir);
56
+ } catch (error) {
57
+ console.warn(
58
+ `resource-docs: unable to read references directory "${refsDir}", skipping it: ${error instanceof Error ? error.message : String(error)}`
59
+ );
60
+ return [];
61
+ }
62
+ return files.filter((f) => f.endsWith(".md")).flatMap((f) => {
63
+ const refPath = path.join(refsDir, f);
64
+ let content;
65
+ try {
66
+ content = fs.readFileSync(refPath, "utf8");
67
+ } catch (error) {
68
+ console.warn(
69
+ `resource-docs: unable to read skill reference "${refPath}", skipping it: ${error instanceof Error ? error.message : String(error)}`
70
+ );
71
+ return [];
72
+ }
73
+ const name = f.replace(/\.md$/, "");
74
+ const h1Match = content.match(/^#\s+(.+)$/m);
75
+ const title = h1Match?.[1] ?? name;
76
+ return [{ name, title, content }];
77
+ }).sort((a, b) => a.name.localeCompare(b.name));
78
+ }
79
+ function realPathOrWarn(filePath) {
80
+ try {
81
+ return fs.realpathSync(filePath);
82
+ } catch (error) {
83
+ console.warn(
84
+ `resource-docs: unable to resolve skills directory "${filePath}", skipping it: ${error instanceof Error ? error.message : String(error)}`
85
+ );
86
+ return null;
87
+ }
88
+ }
89
+ function readSkillDirs(skillsDir) {
90
+ let entries;
91
+ try {
92
+ entries = fs.readdirSync(skillsDir);
93
+ } catch (error) {
94
+ console.warn(
95
+ `resource-docs: unable to read skills directory "${skillsDir}", skipping it: ${error instanceof Error ? error.message : String(error)}`
96
+ );
97
+ return [];
98
+ }
99
+ return entries.filter((dir) => {
100
+ if (dir.startsWith(".")) return false;
101
+ const skillPath = path.join(skillsDir, dir);
102
+ try {
103
+ return fs.statSync(skillPath).isDirectory() && fs.existsSync(path.join(skillPath, "SKILL.md"));
104
+ } catch (error) {
105
+ console.warn(
106
+ `resource-docs: unable to read skill directory "${skillPath}", skipping it: ${error instanceof Error ? error.message : String(error)}`
107
+ );
108
+ return false;
109
+ }
110
+ });
111
+ }
112
+ function readSkillFiles(dir) {
113
+ try {
114
+ return listFiles(dir);
115
+ } catch (error) {
116
+ console.warn(
117
+ `resource-docs: unable to read skill files in "${dir}", skipping them: ${error instanceof Error ? error.message : String(error)}`
118
+ );
119
+ return [];
120
+ }
121
+ }
122
+ function readFrontmatterString(value, field, skillFile) {
123
+ if (value === void 0) return void 0;
124
+ if (typeof value === "string") return value;
125
+ console.warn(
126
+ `resource-docs: skill frontmatter field "${field}" in "${skillFile}" must be a string; using the fallback value.`
127
+ );
128
+ return void 0;
129
+ }
130
+ function generateSkillsCategory({
131
+ skillsDirs,
132
+ outputDir,
133
+ label,
134
+ position,
135
+ description,
136
+ sourceLabel,
137
+ renderExtraHeader,
138
+ renderFrontmatterString
139
+ }) {
140
+ cleanDir(outputDir);
141
+ const roots = [];
142
+ const seenRoots = /* @__PURE__ */ new Set();
143
+ for (const skillsDir of skillsDirs) {
144
+ if (!fs.existsSync(skillsDir)) continue;
145
+ const realDir = realPathOrWarn(skillsDir);
146
+ if (realDir === null || seenRoots.has(realDir)) continue;
147
+ seenRoots.add(realDir);
148
+ roots.push({ sourceDir: skillsDir, realDir });
149
+ }
150
+ if (roots.length === 0) return [];
151
+ const discovered = [];
152
+ const seenSkillDirs = /* @__PURE__ */ new Set();
153
+ const seenNames = /* @__PURE__ */ new Map();
154
+ for (const root of roots) {
155
+ for (const dir of readSkillDirs(root.sourceDir)) {
156
+ const skillAbsDir = path.join(root.sourceDir, dir);
157
+ const realSkillDir = realPathOrWarn(skillAbsDir);
158
+ if (realSkillDir === null || seenSkillDirs.has(realSkillDir)) continue;
159
+ seenSkillDirs.add(realSkillDir);
160
+ const previous = seenNames.get(dir);
161
+ if (previous !== void 0) {
162
+ console.warn(
163
+ `resource-docs: skill "${dir}" from "${root.sourceDir}" conflicts with the skill from "${previous}"; keeping the first one.`
164
+ );
165
+ continue;
166
+ }
167
+ seenNames.set(dir, root.sourceDir);
168
+ discovered.push({ sourceDir: root.sourceDir, dir, skillAbsDir, realSkillDir });
169
+ }
170
+ }
171
+ if (discovered.length === 0) return [];
172
+ ensureDir(outputDir);
173
+ const items = [];
174
+ const resourcePrefix = sourceLabel.startsWith(".claude/") ? "claude-resources" : "codex-resources";
175
+ for (const discoveredSkill of discovered) {
176
+ const { sourceDir, dir, skillAbsDir } = discoveredSkill;
177
+ assertNotIndexReserved(
178
+ dir,
179
+ `${resourcePrefix}: skill directory "${sourceLabel}/index/" uses the reserved name "index", which is used for the category metadata file. Rename the skill directory to resolve the conflict.`
180
+ );
181
+ let content;
182
+ try {
183
+ content = fs.readFileSync(path.join(skillAbsDir, "SKILL.md"), "utf8");
184
+ } catch (error) {
185
+ console.warn(
186
+ `resource-docs: unable to read skill "${skillAbsDir}/SKILL.md", skipping it: ${error instanceof Error ? error.message : String(error)}`
187
+ );
188
+ continue;
189
+ }
190
+ const parsed = parseFrontmatter(content);
191
+ if (!parsed) continue;
192
+ const skillFile = path.join(skillAbsDir, "SKILL.md");
193
+ const name = readFrontmatterString(parsed.data.name, "name", skillFile) || dir;
194
+ const skillDescription = readFrontmatterString(parsed.data.description, "description", skillFile) || "";
195
+ const references = getSkillReferences(sourceDir, dir);
196
+ items.push({ name, dir, description: skillDescription, references });
197
+ const scriptFiles = readSkillFiles(path.join(skillAbsDir, "scripts"));
198
+ const assetFiles = readSkillFiles(path.join(skillAbsDir, "assets"));
199
+ const refFiles = references.map((r) => `${r.name}.md`);
200
+ const subDirs = [];
201
+ if (scriptFiles.length > 0) subDirs.push({ name: "scripts", files: scriptFiles });
202
+ if (refFiles.length > 0) subDirs.push({ name: "references", files: refFiles });
203
+ if (assetFiles.length > 0) subDirs.push({ name: "assets", files: assetFiles });
204
+ let fileStructureSection = "";
205
+ if (subDirs.length > 0) {
206
+ const tree = `\`\`\`
207
+ ${getSkillFileTree(dir, subDirs)}
208
+ \`\`\``;
209
+ const links = [];
210
+ for (const ref of references) {
211
+ links.push(`- [references/${ref.name}.md](./ref-${ref.name})`);
212
+ }
213
+ for (const f of scriptFiles.filter((s) => s.endsWith(".md"))) {
214
+ const slug = f.replace(/\.md$/, "");
215
+ links.push(`- [scripts/${f}](./script-${slug})`);
216
+ }
217
+ for (const f of assetFiles.filter((a) => a.endsWith(".md"))) {
218
+ const slug = f.replace(/\.md$/, "");
219
+ links.push(`- [assets/${f}](./asset-${slug})`);
220
+ }
221
+ const linkList = links.length > 0 ? `
222
+
223
+ ${links.join("\n")}` : "";
224
+ fileStructureSection = `## File Structure
225
+
226
+ ${tree}${linkList}`;
227
+ }
228
+ const shortDesc = skillDescription.length > 200 ? skillDescription.substring(0, 200) + "..." : skillDescription;
229
+ let extraHeader = "";
230
+ if (renderExtraHeader) {
231
+ try {
232
+ extraHeader = renderExtraHeader(skillAbsDir).trim();
233
+ } catch (error) {
234
+ console.warn(
235
+ `resource-docs: unable to render extra metadata for skill "${skillAbsDir}", skipping it: ${error instanceof Error ? error.message : String(error)}`
236
+ );
237
+ }
238
+ }
239
+ let skillBody = parsed.content.trim();
240
+ skillBody = skillBody.replace(/\]\(references\/([^)]+)\.md\)/g, "](./ref-$1)").replace(/\]\(scripts\/([^)]+)\.md\)/g, "](./script-$1)").replace(/\]\(assets\/([^)]+)\.md\)/g, "](./asset-$1)");
241
+ const body = [
242
+ extraHeader,
243
+ fileStructureSection,
244
+ escapeForMdx(skillBody)
245
+ ].filter(Boolean).join("\n\n");
246
+ const renderString = renderFrontmatterString ?? ((value) => `"${escapeTitle(value)}"`);
247
+ const mdx = `---
248
+ title: ${renderString(name)}
249
+ description: ${renderString(shortDesc)}
250
+ sidebar_label: ${renderString(name)}
251
+ generated: true
252
+ ---
253
+
254
+ ${body}`;
255
+ const skillDirOut = path.join(outputDir, dir);
256
+ ensureDir(skillDirOut);
257
+ fs.writeFileSync(path.join(skillDirOut, "index.mdx"), mdx);
258
+ for (const ref of references) {
259
+ writeUnlistedSubPage(
260
+ path.join(skillDirOut, `ref-${ref.name}.mdx`),
261
+ ref.title,
262
+ escapeForMdx(ref.content.trim()),
263
+ renderFrontmatterString
264
+ );
265
+ }
266
+ for (const f of scriptFiles.filter((s) => s.endsWith(".md"))) {
267
+ const slug = f.replace(/\.md$/, "");
268
+ const scriptPath = path.join(skillAbsDir, "scripts", f);
269
+ let raw;
270
+ try {
271
+ raw = fs.readFileSync(scriptPath, "utf8");
272
+ } catch (error) {
273
+ console.warn(
274
+ `resource-docs: unable to read skill script "${scriptPath}", skipping it: ${error instanceof Error ? error.message : String(error)}`
275
+ );
276
+ continue;
277
+ }
278
+ const h1Match = raw.match(/^#\s+(.+)$/m);
279
+ const title = h1Match?.[1] ?? slug;
280
+ writeUnlistedSubPage(
281
+ path.join(skillDirOut, `script-${slug}.mdx`),
282
+ title,
283
+ escapeForMdx(raw.trim()),
284
+ renderFrontmatterString
285
+ );
286
+ }
287
+ for (const f of assetFiles.filter((a) => a.endsWith(".md"))) {
288
+ const slug = f.replace(/\.md$/, "");
289
+ const assetPath = path.join(skillAbsDir, "assets", f);
290
+ let raw;
291
+ try {
292
+ raw = fs.readFileSync(assetPath, "utf8");
293
+ } catch (error) {
294
+ console.warn(
295
+ `resource-docs: unable to read skill asset "${assetPath}", skipping it: ${error instanceof Error ? error.message : String(error)}`
296
+ );
297
+ continue;
298
+ }
299
+ const h1Match = raw.match(/^#\s+(.+)$/m);
300
+ const title = h1Match?.[1] ?? slug;
301
+ writeUnlistedSubPage(
302
+ path.join(skillDirOut, `asset-${slug}.mdx`),
303
+ title,
304
+ escapeForMdx(raw.trim()),
305
+ renderFrontmatterString
306
+ );
307
+ }
308
+ }
309
+ items.sort((a, b) => a.name.localeCompare(b.name));
310
+ writeCategoryIndex(outputDir, label, position, description, renderFrontmatterString);
311
+ return items;
312
+ }
313
+ export {
314
+ generateSkillsCategory,
315
+ getScriptDescription,
316
+ getSkillFileTree,
317
+ getSkillReferences
318
+ };
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Directory names skipped by basename at ANY depth of the walk.
3
+ *
4
+ * These are build output, vendored trees, and tooling scratch dirs that can
5
+ * belong to *any* project under the scan root, not just the one at its top
6
+ * level. Anchoring them to the scan root (the pre-#3200 behaviour) meant a
7
+ * doc site in a repo subdirectory with `scanRoot` widened to the repo root
8
+ * still walked its own `dist/`, `public/`, `out/`, and `test-results/` on
9
+ * every build — the exact nested layout `scanRoot` exists for.
10
+ *
11
+ * `.git` needs no entry here: dot-prefixed entries are already skipped at any
12
+ * depth by the loop below.
13
+ */
14
+ export declare const EXCLUDED_DIR_NAMES: Set<string>;
15
+ /**
16
+ * Find named regular files without following symlinked directories.
17
+ * Excludes are path-segment-boundary-aware, and dot-prefixed entries are
18
+ * skipped at every depth.
19
+ */
20
+ export declare function findNamedFiles(dir: string, excludeDirs: string[], fileNames: string[]): string[];
@@ -0,0 +1,41 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ const EXCLUDED_DIR_NAMES = /* @__PURE__ */ new Set([
4
+ "node_modules",
5
+ "worktrees",
6
+ "dist",
7
+ "out",
8
+ "public",
9
+ "__inbox",
10
+ "test-results"
11
+ ]);
12
+ function findNamedFiles(dir, excludeDirs, fileNames) {
13
+ const results = [];
14
+ if (!fs.existsSync(dir)) return results;
15
+ const excludes = excludeDirs.map(
16
+ (d) => d.endsWith(path.sep) ? d.slice(0, -path.sep.length) : d
17
+ );
18
+ const names = new Set(fileNames);
19
+ for (const item of fs.readdirSync(dir)) {
20
+ if (EXCLUDED_DIR_NAMES.has(item)) continue;
21
+ if (item.startsWith(".")) continue;
22
+ const itemPath = path.join(dir, item);
23
+ if (excludes.some((d) => itemPath === d || itemPath.startsWith(d + path.sep))) continue;
24
+ let stat;
25
+ try {
26
+ stat = fs.lstatSync(itemPath);
27
+ } catch {
28
+ continue;
29
+ }
30
+ if (stat.isDirectory()) {
31
+ results.push(...findNamedFiles(itemPath, excludes, fileNames));
32
+ } else if (stat.isFile() && names.has(item)) {
33
+ results.push(itemPath);
34
+ }
35
+ }
36
+ return results;
37
+ }
38
+ export {
39
+ EXCLUDED_DIR_NAMES,
40
+ findNamedFiles
41
+ };
package/dist/preset.d.ts CHANGED
@@ -58,6 +58,13 @@ export interface PresetClaudeResourcesConfig {
58
58
  */
59
59
  scanRoot?: string;
60
60
  }
61
+ /** The `settings.codexResources` block (or `false` when disabled). */
62
+ export interface PresetCodexResourcesConfig {
63
+ codexDir: string;
64
+ projectRoot?: string;
65
+ /** Root for `AGENTS.md` / `AGENTS.override.md` and `.agents/skills/` discovery; defaults to `projectRoot`. */
66
+ scanRoot?: string;
67
+ }
61
68
  export interface PresetChangelogConfig {
62
69
  sourceDir: string;
63
70
  outputFile: string;
@@ -97,6 +104,7 @@ export interface PresetSettings {
97
104
  docHistory?: boolean;
98
105
  docHistoryExclude?: string[];
99
106
  claudeResources?: PresetClaudeResourcesConfig | false;
107
+ codexResources?: PresetCodexResourcesConfig | false;
100
108
  /**
101
109
  * When `true` (the **default** when omitted — #2404), the preset adds the
102
110
  * package-owned route-injection plugin (`@takazudo/zudo-doc/plugins/routes`).
package/dist/preset.js CHANGED
@@ -182,6 +182,17 @@ function buildPlugins(settings, routeContext) {
182
182
  }
183
183
  }
184
184
  ] : [],
185
+ ...settings.codexResources ? [
186
+ {
187
+ name: "@takazudo/zudo-doc/plugins/codex-resources",
188
+ options: {
189
+ codexDir: settings.codexResources.codexDir,
190
+ projectRoot: settings.codexResources.projectRoot,
191
+ scanRoot: settings.codexResources.scanRoot,
192
+ docsDir: settings.docsDir
193
+ }
194
+ }
195
+ ] : [],
185
196
  ...settings.docHistory ? [
186
197
  {
187
198
  name: "@takazudo/zudo-doc/plugins/doc-history",
package/dist/safelist.css CHANGED
@@ -1,2 +1,2 @@
1
1
  /* generated by gen-safelist.mjs — do not edit by hand */
2
- @source inline("-domtweaker-enabled -elpath-enabled -link -mb-px -ml-hsp-sm -noscript -open -state -translate-x-full 2xl:w-[24px] [&::-webkit-details-marker]:hidden [&_a]:text-accent [&_a]:underline [&_nav]:mb-0 [data-admonition] [data-kbd-shortcut] [data-switcher-launcher] [doc-history-meta] [doc-history] [doc-layout] [llms-txt] [zudo-doc] a a2 abbr about above absent absolute accent accent- accent:accent- access across activated active actual actually added admonition admonition- admonition-body admonition-title admonition/callout after after-breadcrumb after-content after-navigate after-sidebar after-title against agent agents ai-chat ai-chat-md ai-chat-trigger alert align-top all allow-same-origin allow-scripts allowed alone already already-executed already-multiline already-picked also always an anchor and and/or animate-pulse animate-spin announce ansehen antialiased any anywhere anzeigen app appear application/json application/xml applied applies apply applying approach are area arg argument aria-atomic aria-busy aria-controls aria-current aria-disabled aria-expanded aria-haspopup aria-hidden aria-label aria-labelledby aria-live aria-orientation aria-pressed aria-selected aria-valuemax aria-valuemin aria-valuenow arm arms arrows article as asc aside aspect-[1200/630] aspect-square asset- assets assistant async at at-rule attach attribute attributes auf authored auto auto-logo-mask autogenerated availability available avoid await away b back backdrop:bg-bg/30 backdrop:bg-bg/80 backdrop:bg-overlay/60 backdrop:z-modal-backdrop background background-color backtick backticks baked banner bare base base- base64 base:base- based batch be bearbeiten because becomes been before below best best-effort between bg bg-[#fff] bg-accent bg-bg bg-chat-assistant-bg bg-chat-user-bg bg-code-bg bg-fg bg-info/10 bg-info/5 bg-muted bg-overlay/30 bg-surface bg-surface/50 bg-transparent bg-warning/10 bg-warning/5 bi bigint bin binaries bind binding blank blanks block blockquote blocks blur body body-end-components body-end-scripts bold boolean bootstrap border border-accent border-b border-b-2 border-b-[5px] border-bg/30 border-collapse border-danger border-dashed border-fg border-image border-info/30 border-l border-l-0 border-l-[3px] border-left-width border-muted border-none border-r border-r-0 border-radius border-solid border-t border-t-[2px] border-t-[3px] border-transparent border-warning/30 border-width border-y both bottom-hsp-lg bottom-vsp-xl boundaries box box-border br brackets brand breadcrumb:end breadcrumb:start break-words brief brown browser browser-tab browsers browses btn budget bug build builder built built-in bundler but button buttons by bypassed byte-identical bytes cache cached call callable called caller calls can cancellation candidate cannot canonical canvas caption captured captures card card-grid carry cases cat-nav- catch category caught caution center center/contain ch chains change changed changelog changelogs changes check child children choose chrome chrome-font ci circle cite class class-less class-mode claude claude-agents claude-commands claude-md claude-skills cleaned cleanly clear clearing click client client-router client-side clip clobber clobbering close closed closes closing closure code code-block-sr-announce code-group code-group-panel col col-resize colgroup collapses collapsible collision color color-scheme color-scheme-changed color-scheme-provider color-tweak colorization colors column comma command commands commas comment commercial commercial-font-denylist commit compare component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher composes composition compute computed concrete config configuration configurations configure configured confuse connect const construction consumer consumes contain container containers containing contains content content-admonition content-layer content-link content-type content-wrapper:end content-wrapper:start contents context contract control controller controls converts cookie-blocking copied copy core corners correct correctly corrupt could count covered covers crashes created cross-component crumb- cs css css-presence ctx cur current current-path/index.ts current-route currently cursor cursor-not-allowed cursor-pointer custom cycle danger dark data data-active data-admonition data-auto-logo data-base data-close-search data-current-locale data-default-locale data-doc-description data-doc-metainfo data-doc-pager data-doc-unavailable-versions data-find-active data-find-match data-footer data-group-id data-header data-header-logo data-header-nav data-header-right data-kbd-shortcut data-language-switcher data-loading-index data-mermaid-enlarge-ready data-mermaid-rendered data-mermaid-src data-nav-active data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-no-results data-open-search data-pan-active data-processed data-props data-result-count-template data-search-count data-search-count-narrow data-search-dialog data-search-input data-search-placeholder data-search-results data-search-unavailable data-sidebar-hidden data-sidebar-resizer data-site-nav data-switcher-card data-switcher-launcher data-tab-btn data-tab-default data-tab-label data-tab-value data-tabs data-taglist-group data-testid data-theme data-theme-pack data-theme-pack-switcher data-theme/style data-toc-hidden data-trailing-slash data-unavailable-label data-variant data-version-banner data-version-latest data-version-menu data-version-rewire data-version-slug data-version-switcher data-version-toggle data-version-trigger-label data-zd-mobile-sidebar data-zd-mobile-toc data-zd-nosidebar data-zd-theme-pack-css data-zd-theme-pack-css-loading data-zd-theme-pack-loading data-zd-toc data-zd-wide data-zfb-island data-zfb-island-remount data-zfb-transition-persist dd decimal declaration declare declares decoration decoration-muted deepest-match default default-transition-duration defaults deferral deferred del delegated delete deliberately delimiter dependency depends depth der desc description design design-token design-token-panel design-token-trigger desktop desktop-sidebar desktop-sidebar-toggle desktop-sidebar-toggle-island desktop-toc-toggle destroys destructive detach detached details determine deterministic dev develop dfn diagram diagrams dialog did die dieser diff diff-line-added diff-line-content diff-line-empty diff-line-num diff-line-removed diff-row different dir directly directories directory disabled disabled:opacity-50 disabled:pointer-events-none disc display display:none dist distance distinct div dl do doc doc-card- doc-content-band doc-history doc-history-generate doc-history-panel doc-history-trigger doc-page doc-pager doc-prose doc-title docblock docs docs- docs-v- document document-level documentation documented does dog double-registration draft drag drawer drift drifts drop dropdown dropdown-parent dropdowns dt duplicate duration-150 duration-200 during dynamically e e2e each earlier early ease-in-out edge editing einer either eject ejectable ejectables ejected el element elements els else em embedded emit emitting empty empty/undefined en enable enabled end enhanced enhancement enlarged entire entirely entities entries entry entrypoint equal error escape escaped even eventually every everything-enabled exactly exceeds excerpt excludes exclusively existing exists exit expected explicit export extends extra f factories failed fall fallback fallbacks falling falls false family fast favicon feature fg field fields fieldset figcaption figure file fill fills finally find find-match find-match-active fire fires first first-paint fix fixed fixed-width fixtures flag flash flat flex flex-1 flex-col flex-wrap flip flipping flips flow flush-left focus focus-visible:border-accent focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2 focus-visible:text-accent focus-visible:underline focus:border-accent focus:outline-none focus:text-accent focus:underline font font-bold font-face-parity font-family font-file-missing font-medium font-mono font-sans font-scale font-semibold font-size font-weight font-weight-bold font-weight-medium font-weight-normal font-weight-semibold font/woff2 fonts footer footer- for form format former found four-link fox frame free freeze fresh from frontmatter frontmatter-preview frozen fs-extra full fully function further g gains gap-[0.3em] gap-[clamp(1.5rem,3vw,4rem)] gap-hsp-2xs gap-hsp-lg gap-hsp-md gap-hsp-sm gap-hsp-xl gap-hsp-xs gap-vsp-2xs gap-vsp-3xs gap-vsp-lg gap-vsp-md gap-vsp-xs gap-x-hsp-2xs gap-x-hsp-lg gap-x-hsp-md gap-x-hsp-sm gap-x-hsp-xs gap-y-vsp-2xs gap-y-vsp-lg gap-y-vsp-md gap-y-vsp-xs gaps gate geladen2026 generate generated generation genuine geometry get getting-started github github-dark github-link give go got grab gradient granular graph gray-matter grid grid-cols-1 grid-cols-2 group group-focus-visible:text-accent group-focus-visible:underline group-focus-within:block group-hover:bg-fg group-hover:block group-hover:text-accent group-hover:text-bg group-hover:underline group-open:rotate-90 guard h-[0.5rem] h-[0.625rem] h-[0.875rem] h-[1.125rem] h-[1.25rem] h-[1.575rem] h-[10rem] h-[14px] h-[1em] h-[1lh] h-[2.5rem] h-[2rem] h-[3.5rem] h-[3rem] h-[90vh] h-[calc(100%-3rem)] h-[calc(100vh-3.5rem)] h-dvh h-full h-icon-lg h-icon-md h-icon-sm h-icon-xs h1 h1s h2 h22013h4 h2s h3 h4 h5 h6 half hand-copied hand-editable handle handled handler handlers happens hard-loaded hardcoded has hash-link have head head-links head-scripts header header- header-call:end header-call:start header-right heading heading-h2 heading-h3 heading-h4 heading-rule headings height here hex hidden hide hierarchical highlight history home horizontal host hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)] hover:bg-accent-hover hover:bg-accent/10 hover:bg-danger/10 hover:bg-surface hover:border-accent hover:border-accent-hover hover:border-fg hover:text-accent hover:text-accent-hover hover:text-fg hover:underline hr href hrefs hsp hsp-2xl hsp-2xs hsp-lg hsp-md hsp-sm hsp-xl hsp-xs html i i18n/theme. i2 i3 i4 ico icon icon-lg icon-md icon-sm icon-xs identical idle idx if iframe image image-enlarge image-overlay-inset image/avif image/gif image/jpeg image/png image/webp image/x-icon img implementation import important important-allowlist imports in inactive inbox includes including incomplete independently index index2026 indirectly info inherit inherited initial initialised injected inline inline-block inline-flex inner input input-clear ins inserted-after-color-mode inserted-after-color-scheme inserted-after-site-name inserted-first insertion inset-0 inside inside-only install installation installed instance instanceof instead instructions intended intent intercept internal interpolation into invalid invalidated inverse inversion invoke is island island-root issues it italic item item- items items-baseline items-center items-end items-start iteration its itself javascript js jsx jumps just justify-between justify-center justify-end justify-start katex kbd keep keeping keeps kept key keyboard keyboard-shortcut keydown keys keystroke keyword keywords khroma known-token-names kopieren label landing lands language-switcher last:border-b-0 later latest launch layout lazy leading-normal leading-relaxed leading-snug leading-tight leaf- leak leaves leaving left left-0 left:calc legend legitimate length lets letter-spacing lg lg:block lg:border lg:border-fg lg:border-solid lg:flex lg:flex-col lg:flex-row lg:gap-hsp-xl lg:grid-cols-3 lg:grid-cols-[repeat(auto-fit,minmax(12rem,1fr))] lg:h-[90vh] lg:hidden lg:justify-start lg:m-auto lg:max-h-[90vh] lg:max-w-[52.5rem] lg:ml-[var(--zd-sidebar-w)] lg:pt-vsp-2xl lg:px-hsp-2xl lg:py-vsp-2xl lg:text-left lg:w-[90vw] lg:w-[clamp(16rem,25%,22rem)] li li2 library license light light/dark like likely line line-height line/statement linger link link- links list list-disc list-none listener lists literal literally literals live lives llms llms-txt load loaded loading local local-1 local-2 local-3 locale locales log logo longer longest-match look loses lostpointercapture lower luminance m m-0 m-auto m21 m6 machinery main major make malformed malformed-markup malicious manually maps mark markdown marks match matching math math-display math-inline max max-h-[85vh] max-h-[90vh] max-h-full max-h-none max-w-[64rem] max-w-[85%] max-w-[85vw] max-w-[90vw] max-w-[calc(100vw-2rem)] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none max-w-sm max-width may mb-0 mb-vsp-2xs mb-vsp-lg mb-vsp-md mb-vsp-sm mb-vsp-xl mb-vsp-xs md mdx means measured measurement measures measuring mechanism menu mermaid message messages meta meta-knob meta-schema metadata migration min-h-0 min-h-[60vh] min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[3rem] min-w-[8rem] minifier minor mirror mirroring mirrors missing mit ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-sm ml-hsp-xl mobile mod modal modal-backdrop mode modify module moment monospace more most mount mounted mouseenter mouseleave move mr-hsp-sm ms mt-0 mt-vsp-2xl mt-vsp-2xs mt-vsp-3xs mt-vsp-lg mt-vsp-md mt-vsp-sm mt-vsp-xl must mutates mutation mutations muted mx-auto my-vsp-lg my-vsp-md n name named names native natural nav nav-active nav-card- nav/doc navigating navigation navigations near needed needs neither nested neutral never new newly-swapped next nicht no no-color-scheme no-data-theme-selector no-enlarge no-op no-repeat no-underline noch node node:buffer node:fs node:fs/promises node:module node:path node:url nodes nofollow noindex non-draggable non-empty non-light-dark non-literal non-persisted none noopener noreferrer normal noscript not notable note notes now null number numeric object object-contain observe observer occurred of off offered offsets ofl-required og:description og:image og:image:alt og:image:height og:image:width og:title og:type og:url oklch ol old older omit on once one only onto opacity-60 open open/close option or order original other others otherwise out outgoing outline-none over overflow overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y:auto override overrides overscroll-contain overwrite own owned p p-0 p-hsp-2xs p-hsp-lg p-hsp-md p-hsp-sm pack pack-scoped package package-default package-injected package-owned packages packs padding page page-loading page-loading-overlay page-loading-spinner page-navigate-end page-title page-wide pages pages/. paint paint-and-read palette pan panel panels paren-balance-aware parent parse parsed parser parses part pass passed passes patch path paths pattern payload payload-budget pb-[50vh] pb-vsp-md pb-vsp-xl pb-vsp-xs pending per per-block per-link permanently persisted persistence pi pick picked picks picocolors pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-sm pl-hsp-xl place placeholder placeholder:text-muted plain plural plus png16 png32 pnpm point pointer pointer-events-none pointercancel pointerdown pointermove pointerup polite polygon polyline popover populates port position position:fixed pr-[4px] pr-hsp-lg pr-hsp-md pr-hsp-sm pr-hsp-xl pre pre-lowercased preact preact/compat preact/hooks preact/jsx-runtime preconnect preference prefix preload pres present preserving preview preview-swatch-color previews2026 previously primary print private produce produced produces producing production project project-owned project-root-relative properties property props prose provided proxy pt-[0.15rem] pt-[2px] pt-vsp-3xs pt-vsp-md pt-vsp-sm pt-vsp-xl pt-vsp-xs ptag- public purely puts px px-hsp-2xl px-hsp-2xs px-hsp-lg px-hsp-md px-hsp-sm px-hsp-xl px-hsp-xs py-0 py-[2px] py-[4px] py-[calc(var(--spacing-vsp-xs)+0.15rem)] py-hsp-2xs py-hsp-3xs py-hsp-sm py-hsp-xs py-vsp-2xs py-vsp-3xs py-vsp-lg py-vsp-md py-vsp-sm py-vsp-xl py-vsp-xs q query question quick r radius radius-full radius-lg rail ramp range rather raw re-encode/decode re-exports re-querying re-render re-renders re-run re-running re-runs re-selects re-syncs reach reached reaches read reader reader-facing reading readings reads/rewrites real real-value received receives recorded recovers rect redefine redistribution ref- reference referenced references refetch refreshes regardless regenerate regenerates regex registry reinit reinits rejected rel relative release released reload relying rem remapped remembered remove removed render rendered renderer renderers renders reorder repaint repair repeated repeating replace replaced replacement replaces repopulate report repository required requires reserved resize resize-x resolve resolved resolves responded response restore restores restyle result result-click results results-area retry return returns reveal revision revisions rewire rewrite rewrites right right- right-0 right-hsp-lg ring-2 ring-accent risking ro robots role roles root rotate-180 rotate-90 round round-trip rounded rounded-[0.75rem] rounded-bl-[0.25rem] rounded-bl-[1rem] rounded-bl-lg rounded-br-[0.25rem] rounded-br-[1rem] rounded-full rounded-lg rounded-md rounded-t-[1rem] rounds route router routes routes-src rule run running runs runtime s safe safely safer same same-locale samp sans sans-serif scale scanned scanning scheme scoped scoping score scored script script- script-eval script-evaluation script-injection scripts scroll scrollbar scrolled scrollend scrolling seam search search-index section section- see seed sehen select select-none selection-bg selection-fg selector self self-contained self-hosted self-start semantic semibold semver sentinel separator serialised serialize server server-rendered session set sets setting settles setup shadow shadow-[0_1px_3px_color-mix(in_srgb,var(--color-fg)_8%,transparent)] shadow-lg shadow-md shadowed shape share shared sharing shell ship shipped ships short shortcut should show shown shrink-0 sidebar sidebar- sidebar-toggle-island sidebar-tree-island sidebar-w signal silently similarity simple since single single-line single-object-literal singular site site-search site-tree-nav-island sitemap- sites size skill skills skipped skipping skips slash slot slug slug-dir-parity slugs sm:border sm:border-muted sm:flex-row sm:grid-cols-2 sm:h-auto sm:items-center sm:justify-between sm:max-h-[80vh] sm:max-w-[52rem] sm:mx-auto sm:my-[10vh] sm:rounded-lg small smooth snapping snapshot snapshots so soft soft-nav solid some somehow source sources space-y-vsp-2xs spacing spacing-0 spacing-px span spans spec specifiers specify spelling splitter spread spurious square sr-only src stable stack stale standalone start state state- state:state- statement status stay staying sticky still stock stop stops stored straddles stray strict string strings strip stripe strips stroke-linecap stroke-linejoin stroke-width strong stronger stub-rendered style style-attribute styled styles stylesheet sub subagents subsequent substitute substitution subtracting success successful summary sup supply supported surface surfaces survives svg swap swapped swaps switcher switching synchronous synchronously syntactically syntax t tab tab-item tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tag tag- tag-item- tagged tags tags:audit take tbody td temp-element template temporary temporary-element terminal terms test-results tested text text-accent text-bg text-body text-caption text-center text-chat-assistant-text text-chat-user-text text-code-fg text-danger text-decoration text-display text-fg text-fg/60 text-heading text-info text-left text-micro text-muted text-muted/50 text-right text-scale-2xl text-scale-2xs text-scale-lg text-scale-md text-scale-sm text-scale-xl text-scale-xs text-small text-title text-warning text/css text/plain textarea tfoot th than that the thead their them theme theme-color theme-pack theme-pack-changed theme-packs theme-packs/index.json theme-toggle theme/token then there these they this those though three threw through throw throws tighten time tip title to toast toc toggle toggle- toggle-ai-chat toggle-design-token-panel toggles toggling token tokens tolerates too toolbar tooltip top top-0 top-[3.5rem] top-full top-level total touches tr tracked tracking-wide tracking-wider trade-off trailing transition transition-[background,color,border-color] transition-[left,color] transition-[right,color] transition-colors transition-transform translate-x-0 translated translations transparent treats tree tree-child- tree-item- tree-top- trigger trigger:ai-chat trigger:design-token-panel triggers true truncate truncated try ts tsx turn twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two type typeface typeof typography u ul umschalten unavailable unbalanced unchanged und undefined under underline underlines understand unit-tested unknown unlike unlisted unmaintained unobserve unreadable unrelated unreleased unresolvable unresolved unset unterminated until unusable unwrapped up up-to-date update uppercase use used useful user uses usual utf-8 utf8 utilities utility v v2 val value value-reader values var variable variant verbatim version version- version-menu version-switcher versions vertical via video viewing viewport viewports virtual:zudo-doc-chrome-bindings virtual:zudo-doc-design-token-panel-config virtual:zudo-doc-route-context visibility visible vocabulary void von vsp vsp-2xl vsp-2xs vsp-3xs vsp-lg vsp-md vsp-sm vsp-xl vsp-xs w w-1/2 w-[0.5rem] w-[0.625rem] w-[0.875rem] w-[1.125rem] w-[1.575rem] w-[1.5rem] w-[1.75rem] w-[12rem] w-[14px] w-[16px] w-[16rem] w-[18px] w-[1em] w-[2.5rem] w-[280px] w-[2rem] w-[320px] w-[360px] w-[90vw] w-[calc(100vw-2rem)] w-[var(--zd-sidebar-w)] w-dvw w-full w-icon-lg w-icon-md w-icon-sm w-icon-xs walk walks want warn warning was watching way wbr wbr- we website weight went were what when where whereas whether which while whitespace-nowrap whitespace-pre whole wide wide-gamut wider-than-scrollbar width will window wins wird wired with without word wordmark working works worktrees would wrap wrapped wrapper wrappers wrapping wraps written wrong wrote wurde x xl:flex xl:hidden y-scrollbar yet yields you your z-dropdown z-local-1 z-modal z-modal-backdrop z-popover z-sidebar z-toolbar zd-content zd-desktop-sidebar-toggle zd-desktop-toc-toggle zd-doc-content-band zd-enlarge-btn zd-enlarge-dialog zd-enlarge-dialog-close zd-enlargeable zd-html-preview-code zd-mermaid-dialog zd-mermaid-enlargeable zd-mermaid-tool-btn zd-mermaid-toolbar zd-mermaid-transform zd-mermaid-viewport zd-sidebar-content-wrapper zd-sidebar-open zd-theme-pack-dialog-title zd-toc-col zdtp zfb zfb:after-swap zfb:before-preparation zfb:before-swap zod zoom zudo-design-token-panel zudo-design-tokens/v3 zudo-doc zudo-doc-code-wrap zudo-doc-design-token-panel-modal zudo-doc-design-tokens zudo-doc-sidebar-visible zudo-doc-sidebar-width zudo-doc-theme zudo-doc-theme-pack zudo-doc-toc-visible zudo-doc-tweak zum");
2
+ @source inline("-domtweaker-enabled -elpath-enabled -link -mb-px -ml-hsp-sm -noscript -open -state -translate-x-full 2xl:w-[24px] [&::-webkit-details-marker]:hidden [&_a]:text-accent [&_a]:underline [&_nav]:mb-0 [data-admonition] [data-kbd-shortcut] [data-switcher-launcher] [doc-history-meta] [doc-history] [doc-layout] [llms-txt] [zudo-doc] a a2 abbr about above absent absolute accent accent- accent:accent- access across activated active actual actually added admonition admonition- admonition-body admonition-title admonition/callout after after-breadcrumb after-content after-navigate after-sidebar after-title against agent agents ai-chat ai-chat-md ai-chat-trigger alert align-top all allow allow-same-origin allow-scripts allowed alone already already-executed already-multiline already-picked also always an anchor and and/or animate-pulse animate-spin announce ansehen antialiased any anywhere anzeigen app appear application/json application/xml applied applies apply applying approach approval are area arg argument aria-atomic aria-busy aria-controls aria-current aria-disabled aria-expanded aria-haspopup aria-hidden aria-label aria-labelledby aria-live aria-orientation aria-pressed aria-selected aria-valuemax aria-valuemin aria-valuenow arm arms arrows article as asc aside aspect-[1200/630] aspect-square asset asset- assets assistant async at at-rule attach attribute attributes auf authored auto auto-logo-mask autogenerated availability available avoid await away b back backdrop:bg-bg/30 backdrop:bg-bg/80 backdrop:bg-overlay/60 backdrop:z-modal-backdrop background background-color backtick backticks baked banner bare base base- base64 base:base- based bash batch be bearbeiten because becomes been before below best best-effort between bg bg-[#fff] bg-accent bg-bg bg-chat-assistant-bg bg-chat-user-bg bg-code-bg bg-fg bg-info/10 bg-info/5 bg-muted bg-overlay/30 bg-surface bg-surface/50 bg-transparent bg-warning/10 bg-warning/5 bi bigint bin binaries bind binding blank blanks block blockquote blocks blur body body-end-components body-end-scripts bold boolean bootstrap border border-accent border-b border-b-2 border-b-[5px] border-bg/30 border-collapse border-danger border-dashed border-fg border-image border-info/30 border-l border-l-0 border-l-[3px] border-left-width border-muted border-none border-r border-r-0 border-radius border-solid border-t border-t-[2px] border-t-[3px] border-transparent border-warning/30 border-width border-y both bottom-hsp-lg bottom-vsp-xl boundaries box box-border br brackets brand breadcrumb:end breadcrumb:start break-words brief brown browser browser-tab browsers browses btn budget bug build builder built built-in bundler but button buttons by bypassed byte-identical bytes cache cached call callable called caller calls can cancellation candidate cannot canonical canvas caption captured captures card card-grid carry cases cat-nav- catch category caught caution center center/contain ch chains change changed changelog changelogs changes check child children choose chrome chrome-font ci circle cite class class-less class-mode claude claude-agents claude-commands claude-md claude-resources claude-skills cleaned cleanly clear clearing click client client-router client-side clip clobber clobbering close closed closes closing closure code code-block-sr-announce code-group code-group-panel codex codex-agents codex-agents-md codex-config codex-hooks codex-resources codex-rules codex-skills col col-resize colgroup collapses collapsible collision color color-scheme color-scheme-changed color-scheme-provider color-tweak colorization colors column comma command commands commas comment commercial commercial-font-denylist commit compare component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher composes composition compute computed concrete config configuration configurations configure configured conflicts confuse connect const construction consumer consumes contain container containers containing contains content content-admonition content-layer content-link content-type content-wrapper:end content-wrapper:start contents context contract control controller controls converts cookie-blocking copied copy core corners correct correctly corrupt could count covered covers crashes created cross-component crumb- cs css css-presence ctx cur current current-path/index.ts current-route currently cursor cursor-not-allowed cursor-pointer custom cycle danger dark data data-active data-admonition data-auto-logo data-base data-close-search data-current-locale data-default-locale data-doc-description data-doc-metainfo data-doc-pager data-doc-unavailable-versions data-find-active data-find-match data-footer data-group-id data-header data-header-logo data-header-nav data-header-right data-kbd-shortcut data-language-switcher data-loading-index data-mermaid-enlarge-ready data-mermaid-rendered data-mermaid-src data-nav-active data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-no-results data-open-search data-pan-active data-processed data-props data-result-count-template data-search-count data-search-count-narrow data-search-dialog data-search-input data-search-placeholder data-search-results data-search-unavailable data-sidebar-hidden data-sidebar-resizer data-site-nav data-switcher-card data-switcher-launcher data-tab-btn data-tab-default data-tab-label data-tab-value data-tabs data-taglist-group data-testid data-theme data-theme-pack data-theme-pack-switcher data-theme/style data-toc-hidden data-trailing-slash data-unavailable-label data-variant data-version-banner data-version-latest data-version-menu data-version-rewire data-version-slug data-version-switcher data-version-toggle data-version-trigger-label data-zd-mobile-sidebar data-zd-mobile-toc data-zd-nosidebar data-zd-props-preserve data-zd-theme-pack-css data-zd-theme-pack-css-loading data-zd-theme-pack-loading data-zd-toc data-zd-wide data-zfb-island data-zfb-island-remount data-zfb-transition-persist dd decimal decision declaration declare declares decoration decoration-muted deepest-match default default-transition-duration defaults deferral deferred del delegated delete deliberately delimiter dependency depends depth der desc description design design-token design-token-panel design-token-trigger desktop desktop-sidebar desktop-sidebar-toggle desktop-sidebar-toggle-island desktop-toc-toggle destroys destructive detach detached details determine deterministic dev develop dfn diagram diagrams dialog did die dieser diff diff-line-added diff-line-content diff-line-empty diff-line-num diff-line-removed diff-row different dir directly directories directory disabled disabled:opacity-50 disabled:pointer-events-none disc display display:none dist distance distinct div dl do doc doc-card- doc-content-band doc-history doc-history-generate doc-history-panel doc-history-trigger doc-page doc-pager doc-prose doc-title docblock docs docs- docs-v- document document-level documentation documented does dog double-registration draft drag drawer drift drifts drop dropdown dropdown-parent dropdowns dt duplicate duration-150 duration-200 during dynamically e e2e each earlier early ease-in-out edge editing einer either eject ejectable ejectables ejected el element elements els else em embedded emit emitting empty empty/undefined en enable enabled end enhanced enhancement enlarged entire entirely entities entries entry entrypoint equal error escape escaped even event eventually every everything-enabled exactly exceeds excerpt excludes exclusively existing exists exit expected explicit export extends extra f factories failed fall fallback fallbacks falling falls false family fast favicon feature fg field fields fieldset figcaption figure file files fill fills finally find find-match find-match-active fire fires first first-paint fix fixed fixed-width fixtures flag flash flat flex flex-1 flex-col flex-wrap flip flipping flips flow flush-left focus focus-visible:border-accent focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2 focus-visible:text-accent focus-visible:underline focus:border-accent focus:outline-none focus:text-accent focus:underline font font-bold font-face-parity font-family font-file-missing font-medium font-mono font-sans font-scale font-semibold font-size font-weight font-weight-bold font-weight-medium font-weight-normal font-weight-semibold font/woff2 fonts footer footer- for form format former found four-link fox frame free freeze fresh from frontmatter frontmatter-preview frozen frozen-script fs-extra full fully function further g gains gap-[0.3em] gap-[clamp(1.5rem,3vw,4rem)] gap-hsp-2xs gap-hsp-lg gap-hsp-md gap-hsp-sm gap-hsp-xl gap-hsp-xs gap-vsp-2xs gap-vsp-3xs gap-vsp-lg gap-vsp-md gap-vsp-xs gap-x-hsp-2xs gap-x-hsp-lg gap-x-hsp-md gap-x-hsp-sm gap-x-hsp-xs gap-y-vsp-2xs gap-y-vsp-lg gap-y-vsp-md gap-y-vsp-xs gaps gate geladen2026 generate generated generation genuine geometry get getting-started github github-dark github-link give go got grab gradient granular graph gray-matter grid grid-cols-1 grid-cols-2 group group-focus-visible:text-accent group-focus-visible:underline group-focus-within:block group-hover:bg-fg group-hover:block group-hover:text-accent group-hover:text-bg group-hover:underline group-open:rotate-90 guard h-[0.5rem] h-[0.625rem] h-[0.875rem] h-[1.125rem] h-[1.25rem] h-[1.575rem] h-[10rem] h-[14px] h-[1em] h-[1lh] h-[2.5rem] h-[2rem] h-[3.5rem] h-[3rem] h-[90vh] h-[calc(100%-3rem)] h-[calc(100vh-3.5rem)] h-dvh h-full h-icon-lg h-icon-md h-icon-sm h-icon-xs h1 h1s h2 h22013h4 h2s h3 h4 h5 h6 half hand-copied hand-editable handle handled handler handlers happens hard-loaded hardcoded has hash-link have head head-links head-scripts header header- header-call:end header-call:start header-right heading heading-h2 heading-h3 heading-h4 heading-rule headings height here hex hidden hide hierarchical highlight history home hook hooks hooks-json horizontal host hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)] hover:bg-accent-hover hover:bg-accent/10 hover:bg-danger/10 hover:bg-surface hover:border-accent hover:border-accent-hover hover:border-fg hover:text-accent hover:text-accent-hover hover:text-fg hover:underline hr href hrefs hsp hsp-2xl hsp-2xs hsp-lg hsp-md hsp-sm hsp-xl hsp-xs html i i18n/theme. i2 i3 i4 ico icon icon-lg icon-md icon-sm icon-xs identical idle idx if iframe image image-enlarge image-overlay-inset image/avif image/gif image/jpeg image/png image/webp image/x-icon img implementation import important important-allowlist imports in inactive inbox includes including incomplete independently index index2026 indirectly info inherit inherited initial initialised injected inline inline-block inline-flex inner input input-clear ins inserted-after-color-mode inserted-after-color-scheme inserted-after-site-name inserted-first insertion inset-0 inside inside-only install installation installed instance instanceof instead instructions intended intent intercept interface internal interpolation into invalid invalidated inverse inversion invocation invoke is island island-root issues it italic item item- items items-baseline items-center items-end items-start iteration its itself javascript js json jsx jumps just justification justify-between justify-center justify-end justify-start katex kbd keep keeping keeps kept key keyboard keyboard-shortcut keydown keys keystroke keyword keywords khroma known-token-names kopieren label landing lands language-switcher last:border-b-0 later latest launch layout lazy leading-normal leading-relaxed leading-snug leading-tight leaf- leak leaves leaving left left-0 left:calc legend legitimate length lets letter-spacing lg lg:block lg:border lg:border-fg lg:border-solid lg:flex lg:flex-col lg:flex-row lg:gap-hsp-xl lg:grid-cols-3 lg:grid-cols-[repeat(auto-fit,minmax(12rem,1fr))] lg:h-[90vh] lg:hidden lg:justify-start lg:m-auto lg:max-h-[90vh] lg:max-w-[52.5rem] lg:ml-[var(--zd-sidebar-w)] lg:pt-vsp-2xl lg:px-hsp-2xl lg:py-vsp-2xl lg:text-left lg:w-[90vw] lg:w-[clamp(16rem,25%,22rem)] li li2 library license lifecycle light light/dark like likely line line-height line/statement linger link link- links list list-disc list-none listener lists literal literally literals live lives llms llms-txt load loaded loading local local-1 local-2 local-3 locale locales log logo longer longest-match look loses lostpointercapture lower luminance m m-0 m-auto m21 m6 machinery main major make malformed malformed-markup malicious manually maps mark markdown marks match matching math math-display math-inline max max-h-[85vh] max-h-[90vh] max-h-full max-h-none max-w-[64rem] max-w-[85%] max-w-[85vw] max-w-[90vw] max-w-[calc(100vw-2rem)] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none max-w-sm max-width may mb-0 mb-vsp-2xs mb-vsp-lg mb-vsp-md mb-vsp-sm mb-vsp-xl mb-vsp-xs md mdx means measured measurement measures measuring mechanism menu mermaid message messages meta meta-knob meta-schema metadata migration min-h-0 min-h-[60vh] min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[3rem] min-w-[8rem] minifier minor mirror mirroring mirrors missing mit ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-sm ml-hsp-xl mobile mod modal modal-backdrop mode model modify module moment monospace more most mount mounted mouseenter mouseleave move mr-hsp-sm ms mt-0 mt-vsp-2xl mt-vsp-2xs mt-vsp-3xs mt-vsp-lg mt-vsp-md mt-vsp-sm mt-vsp-xl must mutates mutation mutations muted mx-auto my-vsp-lg my-vsp-md n name named names native natural nav nav-active nav-card- nav/doc navigating navigation navigations near needed needs neither nested neutral never new newly-swapped next nicht no no-color-scheme no-data-theme-selector no-enlarge no-op no-repeat no-underline noch node node:buffer node:fs node:fs/promises node:module node:path node:url nodes nofollow noindex non-draggable non-empty non-light-dark non-literal non-null non-persisted none noopener noreferrer normal noscript not notable note notes now null number numeric object object-contain observe observer occurred of off offered offsets ofl-required og:description og:image og:image:alt og:image:height og:image:width og:title og:type og:url oklch ol old older omit omitting on once one only onto opacity-60 open open/close option or order original other others otherwise out outgoing outline-none over overflow overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y:auto override overrides overscroll-contain overwrite own owned p p-0 p-hsp-2xs p-hsp-lg p-hsp-md p-hsp-sm pack pack-scoped package package-default package-injected package-owned packages packs padding page page-loading page-loading-overlay page-loading-spinner page-navigate-end page-title page-wide pages pages/. paint paint-and-read palette pan panel panels paren-balance-aware parent parse parsed parser parses part pass passed passes patch path paths pattern payload payload-budget pb-[50vh] pb-vsp-md pb-vsp-xl pb-vsp-xs pending per per-block per-link permanently persisted persistence pi pick picked picks picocolors pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-sm pl-hsp-xl place placeholder placeholder:text-muted plain plural plus png16 png32 pnpm point pointer pointer-events-none pointercancel pointerdown pointermove pointerup policy polite polygon polyline popover populates port position position:fixed pr-[4px] pr-hsp-lg pr-hsp-md pr-hsp-sm pr-hsp-xl pre pre-lowercased preact preact/compat preact/hooks preact/jsx-runtime preconnect preference prefix preload pres present preserving preview preview-swatch-color previews2026 previously primary print private produce produced produces producing production profiles project project-owned project-root-relative properties property props prose provided proxy pt-[0.15rem] pt-[2px] pt-vsp-3xs pt-vsp-md pt-vsp-sm pt-vsp-xl pt-vsp-xs ptag- public purely puts px px-hsp-2xl px-hsp-2xs px-hsp-lg px-hsp-md px-hsp-sm px-hsp-xl px-hsp-xs py-0 py-[2px] py-[4px] py-[calc(var(--spacing-vsp-xs)+0.15rem)] py-hsp-2xs py-hsp-3xs py-hsp-sm py-hsp-xs py-vsp-2xs py-vsp-3xs py-vsp-lg py-vsp-md py-vsp-sm py-vsp-xl py-vsp-xs python q query question quick r radius radius-full radius-lg rail ramp range rather raw re-encode/decode re-exports re-querying re-render re-renders re-run re-running re-runs re-selects re-syncs reach reached reaches read reader reader-facing reading readings reads/rewrites real real-value received receives recorded recovers rect redefine redistribution ref- reference referenced references refetch refreshes regardless regenerate regenerates regex registry reinit reinits rejected rel relative release released reload relying rem remapped remembered remove removed render rendered renderer renderers renders reorder repaint repair repeated repeating replace replaced replacement replaces repopulate report repository required requires reserved resize resize-x resolve resolved resolves responded response restore restores restyle result result-click results results-area retry return returns reveal revision revisions rewire rewrite rewrites right right- right-0 right-hsp-lg ring-2 ring-accent risking ro robots role roles root rotate-180 rotate-90 round round-trip rounded rounded-[0.75rem] rounded-bl-[0.25rem] rounded-bl-[1rem] rounded-bl-lg rounded-br-[0.25rem] rounded-br-[1rem] rounded-full rounded-lg rounded-md rounded-t-[1rem] rounds route router routes routes-src row rule rules run running runs runtime s safe safely safer same same-locale samp sans sans-serif scale scanned scanning scheme scoped scoping score scored script script- script-eval script-evaluation script-injection scripts scroll scrollbar scrolled scrollend scrolling seam search search-index section section- see seed sehen select select-none selection-bg selection-fg selector self self-contained self-hosted self-start semantic semibold semver sentinel separator serialised serialize server server-rendered session set sets setting settles setup shadow shadow-[0_1px_3px_color-mix(in_srgb,var(--color-fg)_8%,transparent)] shadow-lg shadow-md shadowed shape share shared sharing shell ship shipped ships short shortcut should show shown shrink-0 sidebar sidebar- sidebar-toggle-island sidebar-tree-island sidebar-w signal silently similarity simple since single single-line single-object-literal singular site site-search site-tree-nav-island sitemap- sites size skill skills skipped skipping skips slash slot slug slug-dir-parity slugs sm:border sm:border-muted sm:flex-row sm:grid-cols-2 sm:h-auto sm:items-center sm:justify-between sm:max-h-[80vh] sm:max-w-[52rem] sm:mx-auto sm:my-[10vh] sm:rounded-lg small smol-toml smooth snapping snapshot snapshots so soft soft-nav solid some somehow source sources space-y-vsp-2xs spacing spacing-0 spacing-px span spans spec specifiers specify spelling splitter spread spurious square sr-only src stable stack stale standalone start state state- state:state- statement status stay staying sticky still stock stop stops stored straddles stray strict string strings strip stripe strips stroke-linecap stroke-linejoin stroke-width strong stronger stub-rendered style style-attribute styled styles stylesheet sub subagents subsequent substitute substitution subtracting success successful summary sup supply supported surface surfaces survives svg swap swapped swaps switcher switching synchronous synchronously syntactically syntax t tab tab-item tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tag tag- tag-item- tagged tags tags:audit take tbody td temp-element template temporary temporary-element terminal terms test-results tested text text-accent text-bg text-body text-caption text-center text-chat-assistant-text text-chat-user-text text-code-fg text-danger text-decoration text-display text-fg text-fg/60 text-heading text-info text-left text-micro text-muted text-muted/50 text-right text-scale-2xl text-scale-2xs text-scale-lg text-scale-md text-scale-sm text-scale-xl text-scale-xs text-small text-title text-warning text/css text/plain textarea tfoot th than that the thead their them theme theme-color theme-pack theme-pack-changed theme-packs theme-packs/index.json theme-toggle theme/token then there these they this those though three threw through throw throws tighten time tip title to toast toc toggle toggle- toggle-ai-chat toggle-design-token-panel toggles toggling token tokens tolerates toml too toolbar tooltip top top-0 top-[3.5rem] top-full top-level total touches tr tracked tracking-wide tracking-wider trade-off trailing transition transition-[background,color,border-color] transition-[left,color] transition-[right,color] transition-colors transition-transform translate-x-0 translated translations transparent treats tree tree-child- tree-item- tree-top- trigger trigger:ai-chat trigger:design-token-panel triggers true truncate truncated try ts tsx turn twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two type typeface typeof typescript typography u ul umschalten unable unavailable unbalanced unchanged und undefined under underline underlines understand unit-tested unknown unlike unlisted unmaintained unobserve unreadable unrelated unreleased unresolvable unresolved unset unterminated until unusable unwrapped up up-to-date update uppercase use used useful user uses using usual utf-8 utf8 utilities utility v v2 val value value-reader values var variable variant verbatim version version- version-menu version-switcher versions vertical via video viewing viewport viewports virtual:zudo-doc-chrome-bindings virtual:zudo-doc-design-token-panel-config virtual:zudo-doc-route-context visibility visible vocabulary void von vsp vsp-2xl vsp-2xs vsp-3xs vsp-lg vsp-md vsp-sm vsp-xl vsp-xs w w-1/2 w-[0.5rem] w-[0.625rem] w-[0.875rem] w-[1.125rem] w-[1.575rem] w-[1.5rem] w-[1.75rem] w-[12rem] w-[14px] w-[16px] w-[16rem] w-[18px] w-[1em] w-[2.5rem] w-[280px] w-[2rem] w-[320px] w-[360px] w-[90vw] w-[calc(100vw-2rem)] w-[var(--zd-sidebar-w)] w-dvw w-full w-icon-lg w-icon-md w-icon-sm w-icon-xs walk walks want warn warning was watching way wbr wbr- we website weight went were what when where whereas whether which while whitespace-nowrap whitespace-pre whole wide wide-gamut wider-than-scrollbar width will window wins wird wired with without word wordmark working works worktrees would wrap wrapped wrapper wrappers wrapping wraps written wrong wrote wurde x xl:flex xl:hidden y-scrollbar yet yields you your z-dropdown z-local-1 z-modal z-modal-backdrop z-popover z-sidebar z-toolbar zd-content zd-desktop-sidebar-toggle zd-desktop-toc-toggle zd-doc-content-band zd-enlarge-btn zd-enlarge-dialog zd-enlarge-dialog-close zd-enlargeable zd-html-preview-code zd-mermaid-dialog zd-mermaid-enlargeable zd-mermaid-tool-btn zd-mermaid-toolbar zd-mermaid-transform zd-mermaid-viewport zd-sidebar-content-wrapper zd-sidebar-open zd-theme-pack-dialog-title zd-toc-col zdtp zfb zfb:after-swap zfb:before-preparation zfb:before-swap zod zoom zudo-design-token-panel zudo-design-tokens/v3 zudo-doc zudo-doc-code-wrap zudo-doc-design-token-panel-modal zudo-doc-design-tokens zudo-doc-sidebar-visible zudo-doc-sidebar-width zudo-doc-theme zudo-doc-theme-pack zudo-doc-toc-visible zudo-doc-tweak zum");
@@ -383,6 +383,11 @@ export interface Settings {
383
383
  projectRoot?: string;
384
384
  scanRoot?: string;
385
385
  } | false;
386
+ codexResources: {
387
+ codexDir: string;
388
+ projectRoot?: string;
389
+ scanRoot?: string;
390
+ } | false;
386
391
  defaultLocaleOnlyPrefixes: string[];
387
392
  footer: FooterConfig | false;
388
393
  headerNav: HeaderNavItem[];