@refrakt-md/highlight 0.3.0

package/dist/highlight.d.ts

@@ -0,0 +1,20 @@
+import type { LanguageRegistration } from 'shiki';
+import type { RendererNode } from '@refrakt-md/types';
+export interface HighlightOptions {
+    /** Languages to pre-load when using the default Shiki highlighter.
+     *  Accepts bundled language names or custom LanguageRegistration objects. */
+    langs?: (string | LanguageRegistration)[];
+    /** Custom highlight function. Receives raw code + language, returns HTML string.
+     *  Default: Shiki with css-variables theme. */
+    highlight?: (code: string, lang: string) => string;
+}
+/**
+ * Create a syntax highlight transform that walks the serialized tree,
+ * finds elements with `data-language` + text children, highlights them,
+ * and sets `data-codeblock: true` for raw HTML injection by the Renderer.
+ *
+ * Uses Shiki with a CSS variables theme by default. Pass a custom
+ * `highlight` function to use a different highlighter.
+ */
+export declare function createHighlightTransform(options?: HighlightOptions): Promise<(tree: RendererNode) => RendererNode>;
+//# sourceMappingURL=highlight.d.ts.map

package/dist/highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../src/highlight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,mBAAmB,CAAC;AAKrE,MAAM,WAAW,gBAAgB;IAChC;iFAC6E;IAC7E,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,oBAAoB,CAAC,EAAE,CAAC;IAC1C;mDAC+C;IAC/C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAUD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC7C,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,CAAC,IAAI,EAAE,YAAY,KAAK,YAAY,CAAC,CAmB/C"}

package/dist/highlight.js

@@ -0,0 +1,84 @@
+import { createHighlighter, createCssVariablesTheme } from 'shiki';
+import { isTag } from '@refrakt-md/transform';
+import { markdocLanguage } from './langs/markdoc.js';
+const cssVarsTheme = createCssVariablesTheme();
+const DEFAULT_LANGS = [
+    'javascript', 'typescript', 'html', 'css', 'json', 'shell',
+    'python', 'ruby', 'go', 'rust', 'java', 'c', 'cpp',
+    'markdown', 'yaml', 'toml', 'sql', 'graphql', 'svelte',
+    'jsx', 'tsx', 'diff', 'xml',
+    markdocLanguage,
+];
+/**
+ * Create a syntax highlight transform that walks the serialized tree,
+ * finds elements with `data-language` + text children, highlights them,
+ * and sets `data-codeblock: true` for raw HTML injection by the Renderer.
+ *
+ * Uses Shiki with a CSS variables theme by default. Pass a custom
+ * `highlight` function to use a different highlighter.
+ */
+export async function createHighlightTransform(options = {}) {
+    const { langs = DEFAULT_LANGS, highlight: customHighlight } = options;
+    let highlightFn;
+    if (customHighlight) {
+        highlightFn = customHighlight;
+    }
+    else {
+        const highlighter = await createHighlighter({
+            themes: [cssVarsTheme],
+            langs,
+        });
+        highlightFn = (code, lang) => {
+            const html = highlighter.codeToHtml(code, { lang, theme: 'css-variables' });
+            return extractInnerHtml(html);
+        };
+    }
+    return (tree) => walk(tree, highlightFn);
+}
+/** Walk the serialized tree, highlighting elements with `data-language`. */
+function walk(node, highlightFn) {
+    if (node === null || node === undefined)
+        return node;
+    if (typeof node === 'string' || typeof node === 'number')
+        return node;
+    if (!isTag(node))
+        return node;
+    const lang = node.attributes?.['data-language'];
+    if (lang && hasTextChildren(node)) {
+        return highlightNode(node, lang, highlightFn);
+    }
+    return {
+        ...node,
+        children: node.children.map(c => walk(c, highlightFn)),
+    };
+}
+function hasTextChildren(node) {
+    return node.children.some(c => typeof c === 'string');
+}
+function highlightNode(node, lang, highlightFn) {
+    const text = node.children
+        .filter((c) => typeof c === 'string')
+        .join('');
+    try {
+        const html = highlightFn(text, lang);
+        return {
+            ...node,
+            attributes: { ...node.attributes, 'data-codeblock': true },
+            children: [html],
+        };
+    }
+    catch {
+        // Unknown language or highlight failure — leave text unchanged
+        return node;
+    }
+}
+/** Strip Shiki's <pre><code> wrapper to get just the highlighted spans. */
+function extractInnerHtml(html) {
+    const codeStart = html.indexOf('<code>');
+    const codeEnd = html.lastIndexOf('</code>');
+    if (codeStart !== -1 && codeEnd !== -1) {
+        return html.slice(codeStart + '<code>'.length, codeEnd);
+    }
+    return html;
+}
+//# sourceMappingURL=highlight.js.map

package/dist/highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.js","sourceRoot":"","sources":["../src/highlight.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createHighlightTransform } from './highlight.js';
+export type { HighlightOptions } from './highlight.js';
+export { markdocLanguage } from './langs/markdoc.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createHighlightTransform } from './highlight.js';
+export { markdocLanguage } from './langs/markdoc.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/langs/markdoc.d.ts

@@ -0,0 +1,11 @@
+import type { LanguageRegistration } from 'shiki';
+/**
+ * TextMate grammar for Markdoc syntax.
+ *
+ * Highlights `{% tag %}` blocks with rune names, attributes, string values,
+ * numbers, and booleans. Markdown is the base language.
+ *
+ * Reusable by the VS Code extension (Phase 9a).
+ */
+export declare const markdocLanguage: LanguageRegistration;
+//# sourceMappingURL=markdoc.d.ts.map

package/dist/langs/markdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdoc.d.ts","sourceRoot":"","sources":["../../src/langs/markdoc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,oBAmD7B,CAAC"}

package/dist/langs/markdoc.js

@@ -0,0 +1,61 @@
+/**
+ * TextMate grammar for Markdoc syntax.
+ *
+ * Highlights `{% tag %}` blocks with rune names, attributes, string values,
+ * numbers, and booleans. Markdown is the base language.
+ *
+ * Reusable by the VS Code extension (Phase 9a).
+ */
+export const markdocLanguage = {
+    name: 'markdoc',
+    scopeName: 'text.html.markdoc',
+    displayName: 'Markdoc',
+    embeddedLangs: ['markdown'],
+    patterns: [
+        { include: '#markdoc-tag' },
+        { include: 'text.html.markdown' },
+    ],
+    repository: {
+        'markdoc-tag': {
+            name: 'meta.tag.markdoc',
+            begin: '(\\{%)(\\s*\\/?\\s*[a-z][a-z0-9-]*)',
+            end: '(%\\})',
+            beginCaptures: {
+                1: { name: 'punctuation.definition.tag.begin.markdoc' },
+                2: { name: 'entity.name.tag.markdoc' },
+            },
+            endCaptures: {
+                1: { name: 'punctuation.definition.tag.end.markdoc' },
+            },
+            patterns: [
+                { include: '#tag-attributes' },
+            ],
+        },
+        'tag-attributes': {
+            patterns: [
+                { include: '#attribute-name' },
+                { include: '#attribute-value-string' },
+                { include: '#attribute-value-number' },
+                { include: '#attribute-value-boolean' },
+            ],
+        },
+        'attribute-name': {
+            name: 'entity.other.attribute-name.markdoc',
+            match: '[a-zA-Z_][a-zA-Z0-9_-]*(?=\\s*=)',
+        },
+        'attribute-value-string': {
+            name: 'string.quoted.double.markdoc',
+            begin: '"',
+            end: '"',
+        },
+        'attribute-value-number': {
+            name: 'constant.numeric.markdoc',
+            match: '\\b\\d+\\b',
+        },
+        'attribute-value-boolean': {
+            name: 'constant.language.markdoc',
+            match: '\\b(true|false)\\b',
+        },
+    },
+};
+//# sourceMappingURL=markdoc.js.map

package/dist/langs/markdoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdoc.js","sourceRoot":"","sources":["../../src/langs/markdoc.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAyB;IACpD,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,mBAAmB;IAC9B,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,CAAC,UAAU,CAAC;IAC3B,QAAQ,EAAE;QACT,EAAE,OAAO,EAAE,cAAc,EAAE;QAC3B,EAAE,OAAO,EAAE,oBAAoB,EAAE;KACjC;IACD,UAAU,EAAE;QACX,aAAa,EAAE;YACd,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,qCAAqC;YAC5C,GAAG,EAAE,QAAQ;YACb,aAAa,EAAE;gBACd,CAAC,EAAE,EAAE,IAAI,EAAE,0CAA0C,EAAE;gBACvD,CAAC,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE;aACtC;YACD,WAAW,EAAE;gBACZ,CAAC,EAAE,EAAE,IAAI,EAAE,wCAAwC,EAAE;aACrD;YACD,QAAQ,EAAE;gBACT,EAAE,OAAO,EAAE,iBAAiB,EAAE;aAC9B;SACD;QACD,gBAAgB,EAAE;YACjB,QAAQ,EAAE;gBACT,EAAE,OAAO,EAAE,iBAAiB,EAAE;gBAC9B,EAAE,OAAO,EAAE,yBAAyB,EAAE;gBACtC,EAAE,OAAO,EAAE,yBAAyB,EAAE;gBACtC,EAAE,OAAO,EAAE,0BAA0B,EAAE;aACvC;SACD;QACD,gBAAgB,EAAE;YACjB,IAAI,EAAE,qCAAqC;YAC3C,KAAK,EAAE,kCAAkC;SACzC;QACD,wBAAwB,EAAE;YACzB,IAAI,EAAE,8BAA8B;YACpC,KAAK,EAAE,GAAG;YACV,GAAG,EAAE,GAAG;SACR;QACD,wBAAwB,EAAE;YACzB,IAAI,EAAE,0BAA0B;YAChC,KAAK,EAAE,YAAY;SACnB;QACD,yBAAyB,EAAE;YAC1B,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,oBAAoB;SAC3B;KACD;CACD,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@refrakt-md/highlight",
+  "description": "Syntax highlighting transform for refrakt.md — Shiki-based tree walker with pluggable highlighter",
+  "version": "0.3.0",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/refrakt-md/refrakt.git",
+    "directory": "packages/highlight"
+  },
+  "bugs": "https://github.com/refrakt-md/refrakt/issues",
+  "homepage": "https://github.com/refrakt-md/refrakt",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@refrakt-md/types": "0.3.0",
+    "@refrakt-md/transform": "0.3.0",
+    "shiki": "^3.0.0"
+  }
+}