js/            Syntax highlighting (hirad.js, hiril.js), embedded

/js/*                      -> serveJS

func (s *server) serveJS(w http.ResponseWriter, r *http.Request) {

	name := strings.TrimPrefix(r.URL.Path, "/js/")

	var data []byte

	switch name {

	case "hirad.js":

		data = hiradJS

	case "hiril.js":

		data = hirilJS

	default:

		http.NotFound(w, r)

		return

	}

	w.Header().Set("Content-Type", "application/javascript; charset=utf-8")

	w.Header().Set("Cache-Control", "public, max-age=3600")

	w.Write(data)

}

	mux.HandleFunc("/js/", srv.serveJS)

func TestServeJS_Known(t *testing.T) {

	srv := testServer(t)

	for _, name := range []string{"hirad.js", "hiril.js"} {

		w := getMux(t, srv, "/js/"+name)

		assertCode(t, w, 200)

		assertHeader(t, w, "Content-Type", "javascript")

		assertHeader(t, w, "Cache-Control", "public")

		if w.Body.Len() == 0 {

			t.Errorf("empty body for %s", name)

		}

	}

}

func TestServeJS_Unknown(t *testing.T) {

	srv := testServer(t)

	w := getMux(t, srv, "/js/unknown.js")

	assertCode(t, w, 404)

}

	mux.HandleFunc("/js/", srv.serveJS)

-- Discussion 4: a shorter thread

INSERT INTO discussions (repo, title, body, author, created_at)

VALUES ('_site', 'Syntax highlighting for more languages?',

'Currently forge ships `hirad.js` and `hiril.js` for Radiance and RIL. Any plans to support other languages, or is the intent to keep it *minimal*?',

'bob.bsky.social', datetime('now', '-3 days'));

INSERT INTO replies (discussion_id, body, author, created_at)

VALUES (last_insert_rowid(), 'I think keeping it minimal is the right call. You can always drop your own highlighter scripts into `static/js/` and rebuild. The embed directive picks them up automatically.',

'cloudhead.io', datetime('now', '-2 days'));

-- Discussion 5: no replies yet

(function (hirad) {

//

// hirad - Radiance Syntax Highlighter

//

// Copyright (c) 2020-2025 Alexis Sellier

//

const selector = hirad || '.language-radiance';

const keywords = [

    'fn', 'if', 'else', 'for', 'while', 'break', 'switch', 'match', 'set',

    'record', 'union', 'constant', 'align', 'let', 'use', 'mod', 'module', 'case',

    'continue', 'return', 'true', 'false', 'loop', 'extern', 'panic',

    'device', 'register', 'bit', 'catch', 'throw', 'throws', 'test', 'trait', 'instance',

    'at', 'mut', 'nil', 'undefined', 'static', 'in', 'is', 'where', 'export',

    'as', 'and', 'or', 'xor', 'not', 'try', 'atomic', 'select', 'of', 'assert'

];

const types = ['bool', 'u8', 'u16', 'u32', 'u64', 'i8', 'i16', 'i32', 'i64', 'f32', 'void', 'opaque'];

// Syntax definition.

//

// The key becomes the class name of the span around the matched block of code.

const syntax = [

    ['comment', /(\/\/[^\n]*)/g],

    ['string' , /("(?:(?!").|\\.)*"|'[^']{1,2}')/g],

    ['number' , /\b(0x[0-9a-fA-F]+|0b[01]+|[0-9]+(?:\.[0-9]+)?)\b/g],

    ['ref'    , /(&|&'|\*)\b/g],

    ['delim'  , /(->|=>|\(|\)|\{|\}|\[|\])/g],

    ['builtin', /(@[a-zA-Z]+)/g],

    ['access' , /(\.|::)/g],

    ['op'     , /(=|<>|\.\.|\+|-|\*|\/|%|\?{1,2}|!{1,2}|>=?|<=?)/g],

    ['keyword', new RegExp('\\b(' + keywords.join('|') + ')\\b', 'g')],

    ['type'   , new RegExp('\\b(' + types.join('|') + ')\\b', 'g')],

];

const table = {};

// Encode ASCII characters to Braille to avoid conflicts between patterns.

const encode = (str) => {

    const encoded = [...str].map(c =>

        c.charCodeAt(0) <= 127 ? String.fromCharCode(c.charCodeAt(0) + 0x2800) : c

    ).join('');

    table[encoded] = str;

    return encoded;

};

// Decode Braille back to ASCII.

const decode = (str) =>

    table[str] || [...str].map(c => {

        const code = c.charCodeAt(0) - 0x2800;

        return code >= 0 && code <= 127 ? String.fromCharCode(code) : c;

    }).join('');

// Escape HTML special characters.

const escape = (str) =>

    str.replace(/</g, '&lt;').replace(/>/g, '&gt;');

// Highlight all matching elements.

for (const node of document.querySelectorAll(selector)) {

    for (const child of node.childNodes) {

        if (child.nodeType !== Node.TEXT_NODE) continue;

        if (/^\$\s/.test(child.nodeValue.trim())) continue; // Skip shell snippets.

        for (const [cls, re] of syntax) {

            child.nodeValue = child.nodeValue.replace(re, (_, m) =>

                '\u00ab' + encode(cls) + '\u00b7' +

                           encode(m)   +

                '\u00b7' + encode(cls) + '\u00bb'

            );

        }

    }

    node.innerHTML = node.innerHTML.replace(

        /\u00ab(.+?)\u00b7(.+?)\u00b7\1\u00bb/g,

        (_, name, value) => {

            value = value.replace(/\u00ab[^\u00b7]+\u00b7|\u00b7[^\u00bb]+\u00bb/g, '');

            return '<span class="' + decode(name) + '">'   +

                                     escape(decode(value)) +

                   '</span>';

        }

    );

}

})(window.hirad);

(function (hiril) {

//

// hiril - Radiance IL Syntax Highlighter

//

// Copyright (c) 2020-2025 Alexis Sellier

//

const selector = hiril || '.language-ril';

const keywords = ['fn', 'data', 'extern', 'mut', 'align'];

const instrs = [

    'reserve', 'load', 'sload', 'store', 'blit', 'copy',

    'add', 'sub', 'mul', 'sdiv', 'udiv', 'srem', 'urem', 'neg',

    'eq', 'ne', 'slt', 'sge', 'ult', 'uge',

    'and', 'or', 'xor', 'shl', 'sshr', 'ushr', 'not',

    'zext', 'sext', 'call', 'ret', 'jmp',

    'switch', 'unreachable', 'ecall', 'ebreak'

];

const branchOps = ['br.eq', 'br.ne', 'br.slt', 'br.ult'];

const dataItems = ['str', 'sym', 'undef'];

const types = ['w8', 'w16', 'w32', 'w64'];

// Syntax definition.

//

// The key becomes the class name of the span around the matched block of code.

const syntax = [

    ['comment', /(\/\/[^\n]*)/g],

    ['string' , /("[^"]*")/g],

    ['reg'    , /(%[0-9]+)/g],

    ['label'  , /(@[A-Za-z_][A-Za-z#0-9_]*)/g],

    ['symbol' , /(\$[A-Za-z_][A-Za-z0-9_]*)/g],

    ['number' , /\b(-?[0-9]+|0x[a-fA-F0-9]+)\b/g],

    ['delim'  , /([{}();:,])/g],

    ['keyword', new RegExp('\\b(' + keywords.join('|') + ')\\b', 'g')],

    ['instr'  , new RegExp('\\b(' + branchOps.join('|').replace(/\./g, '\\.') + ')\\b', 'g')],

    ['instr'  , new RegExp('\\b(' + instrs.join('|') + ')\\b', 'g')],

    ['type'   , new RegExp('\\b(' + dataItems.join('|') + ')\\b', 'g')],

    ['type'   , new RegExp('\\b(' + types.join('|') + ')\\b', 'g')],

];

const table = {};

// Encode ASCII characters to Braille to avoid conflicts between patterns.

const encode = (str) => {

    const encoded = [...str].map(c =>

        c.charCodeAt(0) <= 127 ? String.fromCharCode(c.charCodeAt(0) + 0x2800) : c

    ).join('');

    table[encoded] = str;

    return encoded;

};

// Decode Braille back to ASCII.

const decode = (str) =>

    table[str] || [...str].map(c => {

        const code = c.charCodeAt(0) - 0x2800;

        return code >= 0 && code <= 127 ? String.fromCharCode(code) : c;

    }).join('');

// Escape HTML special characters.

const escape = (str) =>

    str.replace(/</g, '&lt;').replace(/>/g, '&gt;');

// Highlight all matching elements.

for (const node of document.querySelectorAll(selector)) {

    for (const child of node.childNodes) {

        if (child.nodeType !== Node.TEXT_NODE) continue;

        if (/^\$\s/.test(child.nodeValue.trim())) continue; // Skip shell snippets.

        for (const [cls, re] of syntax) {

            child.nodeValue = child.nodeValue.replace(re, (_, m) =>

                '\u00ab' + encode(cls) + '\u00b7' +

                           encode(m)   +

                '\u00b7' + encode(cls) + '\u00bb'

            );

        }

    }

    node.innerHTML = node.innerHTML.replace(

        /\u00ab(.+?)\u00b7(.+?)\u00b7\1\u00bb/g,

        (_, name, value) => {

            value = value.replace(/\u00ab[^\u00b7]+\u00b7|\u00b7[^\u00bb]+\u00bb/g, '');

            return '<span class="' + decode(name) + '">'   +

                                     escape(decode(value)) +

                   '</span>';

        }

    );

}

})(window.hiril);

//go:embed static/js/hirad.js

var hiradJS []byte

//go:embed static/js/hiril.js

var hirilJS []byte

<script src="{{.BaseURL}}/js/hirad.js"></script>

<script src="{{.BaseURL}}/js/hiril.js"></script>