apunkt/ktx
1
0
Fork 0
mirror of https://github.com/Kaelio/ktx.git synced 2026-06-19 08:28:06 +02:00
Code Issues Projects Releases Packages Wiki Activity

docs: rewrite the-context-layer concept and highlight markdown frontmatter (#181)

Browse source 
Restructure the-context-layer.mdx around two committed pillars (semantic
sources + wiki pages) with an inline anatomy card, replace the
semantic-layer-only comparison with a three-way matrix against company
brains and traditional semantic layers, and add a navigable-graph
explanation grounded in sl_refs/refs maintenance. Extend the docs-site
CodeBlock with a markdown highlighter that detects YAML frontmatter,
heading and list markers, and inline code so wiki examples render with
the same token colors as YAML/SQL blocks.
This commit is contained in:
Andrey Avtomonov 2026-05-20 14:16:33 +02:00 • committed by GitHub
parent 82d24c164f
commit fb82993ce1
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 311 additions and 80 deletions
Download patch file Download diff file Expand all files Collapse all files

109
docs-site/components/code-block.tsx
View file

@ -341,11 +341,120 @@ function highlightCodeLike(code: string) {
return parts;
}
function highlightMarkdownInline(text: string, keyPrefix: string): ReactNode[] {
const parts: ReactNode[] = [];
const pattern = /`(?:[^`\\]|\\.)+`/g;
let lastIndex = 0;
let tokenIndex = 0;
for (const match of text.matchAll(pattern)) {
const token = match[0];
const index = match.index ?? 0;
if (index > lastIndex) parts.push(text.slice(lastIndex, index));
pushMatchedToken(
parts,
token,
"ktx-token-string",
`${keyPrefix}-${tokenIndex}`,
);
lastIndex = index + token.length;
tokenIndex += 1;
}
if (lastIndex < text.length) parts.push(text.slice(lastIndex));
return parts;
}
function highlightMarkdown(code: string): ReactNode[] {
const parts: ReactNode[] = [];
let cursor = 0;
let tokenIndex = 0;
const fmMatch = code.match(/^---\r?\n([\s\S]*?)\r?\n---(\r?\n)?/);
if (fmMatch) {
pushMatchedToken(
parts,
"---",
"ktx-token-punctuation",
`md-fmstart-${tokenIndex}`,
);
tokenIndex += 1;
parts.push("\n");
parts.push(...highlightYaml(fmMatch[1]));
parts.push("\n");
pushMatchedToken(
parts,
"---",
"ktx-token-punctuation",
`md-fmend-${tokenIndex}`,
);
tokenIndex += 1;
if (fmMatch[2]) parts.push(fmMatch[2]);
cursor = fmMatch[0].length;
}
const rest = code.slice(cursor);
const lines = rest.split(/(\n)/);
for (const line of lines) {
if (line === "\n") {
parts.push(line);
continue;
}
const headingMatch = line.match(/^(\s*)(#{1,6})(\s+)(.*)$/);
if (headingMatch) {
parts.push(headingMatch[1]);
pushMatchedToken(
parts,
headingMatch[2],
"ktx-token-keyword",
`md-heading-${tokenIndex}`,
);
tokenIndex += 1;
parts.push(headingMatch[3]);
parts.push(
...highlightMarkdownInline(headingMatch[4], `md-heading-${tokenIndex}`),
);
tokenIndex += 1;
continue;
}
const listMatch = line.match(/^(\s*)([-*+]|\d+\.)(\s+)(.*)$/);
if (listMatch) {
parts.push(listMatch[1]);
pushMatchedToken(
parts,
listMatch[2],
"ktx-token-punctuation",
`md-list-${tokenIndex}`,
);
tokenIndex += 1;
parts.push(listMatch[3]);
parts.push(
...highlightMarkdownInline(listMatch[4], `md-list-${tokenIndex}`),
);
tokenIndex += 1;
continue;
}
parts.push(
...highlightMarkdownInline(line, `md-line-${tokenIndex}`),
);
tokenIndex += 1;
}
return parts;
}
function highlightCode(language: string | null, code: string) {
const normalized = normalizeLanguage(language);
if (normalized === "json" || normalized === "jsonc") return highlightJson(code);
if (normalized === "yaml" || normalized === "yml") return highlightYaml(code);
if (normalized === "sql") return highlightSql(code);
if (["markdown", "md", "mdx", "mdc"].includes(normalized)) {
return highlightMarkdown(code);
}
if (
[
"bash",