From 3a6a88755f83fe209ad3b84a1b5ef8f6f51b6f8c Mon Sep 17 00:00:00 2001 From: Dobli Date: Sun, 1 Mar 2026 23:29:42 +0100 Subject: [PATCH 1/4] Make toc widget collapsible --- libraries/Library/Std/Widgets/Widgets.md | 59 ++++++++++++++++++------ 1 file changed, 46 insertions(+), 13 deletions(-) diff --git a/libraries/Library/Std/Widgets/Widgets.md b/libraries/Library/Std/Widgets/Widgets.md index ef5dac4f..1a67c9ce 100644 --- a/libraries/Library/Std/Widgets/Widgets.md +++ b/libraries/Library/Std/Widgets/Widgets.md @@ -102,9 +102,13 @@ config.set("std.widgets.toc", { function widgets.toc(options) options = options or config.get("std.widgets.toc") options.minHeaders = options.minHeaders or 3 + options.minLevel = options.minLevel or 1 + options.defaultOpen = options.defaultOpen or nil + options.header = options.header or "Table of Contents" local text = editor.getText() local pageName = editor.getCurrentPage() local parsedMarkdown = markdown.parseMarkdown(text) + -- Collect all headers local headers = {} for topLevelChild in parsedMarkdown.children do @@ -129,27 +133,56 @@ function widgets.toc(options) end end end + if options.minHeaders and options.minHeaders > #headers then return widget.new{} end + + -- Filter headers to display + local headersToDisplay = {} + for _, header in ipairs(headers) do + if not (options.maxHeader and header.level > options.maxHeader or + header.level < options.minLevel) then + table.insert(headersToDisplay, header) + end + end + -- Find min level local minLevel = 6 - for _, header in ipairs(headers) do - if header.level < minLevel then - minLevel = header.level - end + for _, header in ipairs(headersToDisplay) do + minLevel = math.min(minLevel, header.level) end - -- Build up markdown - local md = (options.header or "# Table of Contents") .. "\n" - for _, header in ipairs(headers) do - if not(options.maxHeader and header.level > options.maxHeader or - options.minLevel and header.level < options.minLevel) then - md = md .. string.rep(" ", (header.level - minLevel) * 2) .. - "* [[" .. pageName .. "@" .. header.pos .. "|" .. header.name .. "]]\n" - end + + -- Build TOC entries as DOM elements + local tocItems = {} + for _, header in ipairs(headersToDisplay) do + local indent = (header.level - minLevel) * 1.5 + table.insert(tocItems, dom.div { + style = "margin-left: " .. indent .. "rem; padding: 0.1rem 0;", + dom.a { + onclick = function() + editor.navigate({ page = pageName, pos = header.pos }) + end, + style = "cursor: pointer; text-decoration: none;", + "- " .. header.name + } + }) end + + -- Wrap in a
element for native show/hide toggle return widget.new { - markdown = md + html = dom.details { + open = options.defaultOpen, + dom.summary { + style = "cursor: pointer; font-weight: bold; user-select: none;", + options.header + }, + dom.div { + style = "padding-top: 0.5rem;", + table.unpack(tocItems) + } + }, + display = "block" } end ``` From 50ed0500e976aa5ccfaaa254acc1f7209efb5f43 Mon Sep 17 00:00:00 2001 From: Dobli Date: Tue, 3 Mar 2026 23:11:27 +0100 Subject: [PATCH 2/4] Use space-style for toc widget styling --- libraries/Library/Std/Widgets/Widgets.md | 27 ++++++++++++++++++++---- 1 file changed, 23 insertions(+), 4 deletions(-) diff --git a/libraries/Library/Std/Widgets/Widgets.md b/libraries/Library/Std/Widgets/Widgets.md index 1a67c9ce..349c9db0 100644 --- a/libraries/Library/Std/Widgets/Widgets.md +++ b/libraries/Library/Std/Widgets/Widgets.md @@ -80,6 +80,24 @@ end ``` ## Table of contents +```space-style +.sb-toc-summary { + cursor: pointer; + font-weight: bold; + user-select: none; +} +.sb-toc-content { + padding-top: 0.5rem; +} +.sb-toc-item { + padding: 0.1rem 0; +} +.sb-toc-link { + cursor: pointer; + text-decoration: none; +} +``` + ```space-lua -- priority: 10 widgets = widgets or {} @@ -158,12 +176,13 @@ function widgets.toc(options) for _, header in ipairs(headersToDisplay) do local indent = (header.level - minLevel) * 1.5 table.insert(tocItems, dom.div { - style = "margin-left: " .. indent .. "rem; padding: 0.1rem 0;", + class = "sb-toc-item", + style = "margin-left: " .. indent .. "rem;", dom.a { onclick = function() editor.navigate({ page = pageName, pos = header.pos }) end, - style = "cursor: pointer; text-decoration: none;", + class = "sb-toc-link", "- " .. header.name } }) @@ -174,11 +193,11 @@ function widgets.toc(options) html = dom.details { open = options.defaultOpen, dom.summary { - style = "cursor: pointer; font-weight: bold; user-select: none;", + class = "sb-toc-summary", options.header }, dom.div { - style = "padding-top: 0.5rem;", + class = "sb-toc-content", table.unpack(tocItems) } }, From 7a3ff21419ccd81603097952955c5f90d9524502 Mon Sep 17 00:00:00 2001 From: Dobli Date: Thu, 5 Mar 2026 22:22:24 +0100 Subject: [PATCH 3/4] Align new toc widget style with existing widgets --- libraries/Library/Std/Widgets/Widgets.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/libraries/Library/Std/Widgets/Widgets.md b/libraries/Library/Std/Widgets/Widgets.md index 349c9db0..a06ec19b 100644 --- a/libraries/Library/Std/Widgets/Widgets.md +++ b/libraries/Library/Std/Widgets/Widgets.md @@ -85,6 +85,9 @@ end cursor: pointer; font-weight: bold; user-select: none; + padding: 15px 10px; + margin: -10px; + background-color: var(--editor-widget-background-color); } .sb-toc-content { padding-top: 0.5rem; From 30a1356db8beb1443f24c3701bd11a9aa14c3012 Mon Sep 17 00:00:00 2001 From: Dobli Date: Thu, 5 Mar 2026 23:31:59 +0100 Subject: [PATCH 4/4] Set default state of toc to open --- libraries/Library/Std/Widgets/Widgets.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/libraries/Library/Std/Widgets/Widgets.md b/libraries/Library/Std/Widgets/Widgets.md index a06ec19b..01e81916 100644 --- a/libraries/Library/Std/Widgets/Widgets.md +++ b/libraries/Library/Std/Widgets/Widgets.md @@ -124,8 +124,9 @@ function widgets.toc(options) options = options or config.get("std.widgets.toc") options.minHeaders = options.minHeaders or 3 options.minLevel = options.minLevel or 1 - options.defaultOpen = options.defaultOpen or nil options.header = options.header or "Table of Contents" + local defaultOpen = (options.defaultOpen ~= false) or nil + local text = editor.getText() local pageName = editor.getCurrentPage() local parsedMarkdown = markdown.parseMarkdown(text) @@ -194,7 +195,7 @@ function widgets.toc(options) -- Wrap in a
element for native show/hide toggle return widget.new { html = dom.details { - open = options.defaultOpen, + open = defaultOpen, dom.summary { class = "sb-toc-summary", options.header