feat(notes): add notes plugin with scratchpad, pinning, and launcher quick-capture

Author: ItsLemmy

notes/README.md

@@ -0,0 +1,65 @@
+# Notes
+
+Quick notes in a full-height side panel, stored as plain text files in a
+directory you control — yours to sync, edit externally, and grep.
+
+## Plugin
+
+| Field | Value |
+| --- | --- |
+| ID | `noctalia/notes` |
+| Entries | Panel: `panel`; bar widget: `notes`; launcher provider: `launcher` |
+
+## Usage
+
+1. Enable the plugin in Settings → Plugins.
+2. Add the `notes` bar widget and click it, or run:
+
+   ```sh
+   noctalia msg panel-toggle noctalia/notes:panel
+   ```
+
+3. **+** creates a note named after the current time; rename it from the editor
+   header (press Enter to apply). The editor autosaves a couple of seconds
+   after you stop typing, when you navigate away, and when the panel closes;
+   Ctrl+Enter saves immediately.
+4. The pin button on a row keeps that note at the top of the list and ranks it
+   higher in launcher results. Deleting asks for an inline confirmation.
+
+A pinned **Scratchpad** note always sits at the top of the list — the place to
+dump text instantly without naming anything.
+
+The `/nt` launcher command writes down a thought without opening the panel:
+type it, press Enter, done.
+
+- `/nt buy milk` → **Add to scratchpad** appends the line to the scratchpad
+  file; **New note** creates a note from it and opens the panel on it.
+- The text also fuzzy-matches existing note names; activating a match opens it
+  in the panel.
+- Bare `/nt` lists the scratchpad, your notes, and **New note from clipboard**.
+- **Add to scratchpad** is safe even if the scratchpad was left open in the
+  editor: the appended line shows up there instead of being lost.
+
+## IPC
+
+```sh
+noctalia msg panel-toggle noctalia/notes:panel   # toggle the panel
+noctalia msg panel-open noctalia/notes:panel     # open it
+noctalia msg panel-close                         # close the open panel
+```
+
+## Settings
+
+| Setting | Type | Default | Description |
+| --- | --- | --- | --- |
+| `notes_dir` | `string` | `~/Documents/Notes` | Where the note files live. Created on first open if missing. |
+| `extension` | `string` | `md` | Extension for note files (without the dot). Only files with this extension are listed. |
+| `glyph` | `glyph` | `notes` | Bar widget icon. |
+
+## Notes
+
+- Pins are stored in a hidden `.pinned.json` sidecar inside the notes
+  directory, so they sync with the notes.
+- The panel remembers which note was open across close/reopen.
+- Files are only written by autosave and the `/nt` actions; nothing else in
+  the notes directory is touched.

notes/launcher.luau

@@ -0,0 +1,234 @@
+--!nonstrict
+-- Launcher quick-capture and note search.
+--
+-- `nt <text>` offers: append <text> to the scratchpad, create a new note from
+-- it, or open an existing note whose name fuzzy-matches. With no text, it
+-- lists the notes. Opening hands the target filename to the panel through
+-- noctalia.state ("open_note") and toggles the panel.
+
+local PANEL_ID = "noctalia/notes:panel"
+local SCRATCHPAD_BASE = "scratchpad"
+local MAX_MATCHES = 8
+
+local lastText = ""
+
+local function tr(key)
+  return noctalia.tr(key)
+end
+
+local function settings()
+  local dir = noctalia.expandPath(noctalia.getConfig("notes_dir"))
+  local extension = noctalia.string.trim(noctalia.getConfig("extension")):gsub("^%.", "")
+  if extension == "" then
+    extension = "md"
+  end
+  return dir, "." .. extension
+end
+
+local function noteFiles(dir, suffix)
+  local out = {}
+  local list = noctalia.listDir(dir)
+  if list ~= nil then
+    for _, name in ipairs(list) do
+      if #name > #suffix and name:sub(-#suffix) == suffix and name:sub(1, 1) ~= "." then
+        table.insert(out, name)
+      end
+    end
+    table.sort(out)
+  end
+  return out
+end
+
+local function loadPins(dir)
+  local out = {}
+  local raw = noctalia.readFile(dir .. "/.pinned.json")
+  if raw ~= nil then
+    local decoded = noctalia.json.decode(raw)
+    if type(decoded) == "table" then
+      for name, value in pairs(decoded) do
+        if type(name) == "string" and value == true then
+          out[name] = true
+        end
+      end
+    end
+  end
+  return out
+end
+
+local function bumpNotesState()
+  local bump = noctalia.state.get("notes_bump")
+  noctalia.state.set("notes_bump", (type(bump) == "number" and bump or 0) + 1)
+end
+
+local function openInPanel(file)
+  noctalia.state.set("open_note", file)
+  noctalia.togglePanel(PANEL_ID)
+end
+
+-- Creates a timestamp-named note holding `content` and opens it in the panel.
+local function createNote(content)
+  local dir, suffix = settings()
+  local ok, err = noctalia.mkdirAll(dir)
+  if not ok then
+    noctalia.notifyError(tr("title"), err or "")
+    return
+  end
+  local base = noctalia.formatTime("%Y-%m-%d %H.%M.%S")
+  local name = base .. suffix
+  local counter = 2
+  while noctalia.fileExists(dir .. "/" .. name) do
+    name = base .. " (" .. counter .. ")" .. suffix
+    counter += 1
+  end
+  local body = content
+  if body ~= "" and body:sub(-1) ~= "\n" then
+    body ..= "\n"
+  end
+  local wrote, werr = noctalia.writeFile(dir .. "/" .. name, body)
+  if not wrote then
+    noctalia.notifyError(tr("title"), werr or "")
+    return
+  end
+  bumpNotesState()
+  openInPanel(name)
+end
+
+-- Single-line, length-capped preview safe against cutting a UTF-8 sequence.
+local function previewLine(text)
+  local line = noctalia.string.trim(text):gsub("%s+", " ")
+  if #line <= 60 then
+    return line
+  end
+  local cut = 60
+  while cut > 1 and line:byte(cut + 1) ~= nil and line:byte(cut + 1) >= 0x80 and line:byte(cut + 1) < 0xC0 do
+    cut -= 1
+  end
+  return line:sub(1, cut) .. "…"
+end
+
+function onQuery(query)
+  local text = noctalia.string.trim(query)
+  lastText = text
+  local dir, suffix = settings()
+  local rows = {}
+
+  if text ~= "" then
+    table.insert(rows, {
+      id = "append",
+      title = tr("launcher.append_title"),
+      subtitle = text,
+      glyph = "pencil-plus",
+    })
+    table.insert(rows, {
+      id = "create",
+      title = tr("launcher.new_title"),
+      subtitle = text,
+      glyph = "file-plus",
+    })
+  else
+    table.insert(rows, {
+      id = "open:" .. SCRATCHPAD_BASE .. suffix,
+      title = tr("scratchpad"),
+      subtitle = tr("launcher.open_subtitle"),
+      glyph = "pinned",
+    })
+    table.insert(rows, {
+      id = "home",
+      title = tr("launcher.home_title"),
+      subtitle = tr("launcher.home_subtitle"),
+      glyph = "notes",
+    })
+    local clip = noctalia.clipboardText()
+    if type(clip) == "string" and noctalia.string.trim(clip) ~= "" then
+      table.insert(rows, {
+        id = "clip",
+        title = tr("launcher.clip_title"),
+        subtitle = previewLine(clip),
+        glyph = "clipboard-plus",
+      })
+    end
+  end
+
+  local pins = loadPins(dir)
+  local matches = {}
+  for _, name in ipairs(noteFiles(dir, suffix)) do
+    if name ~= SCRATCHPAD_BASE .. suffix then
+      local display = name:sub(1, #name - #suffix)
+      local score = text == "" and 0 or noctalia.fuzzyScore(text, display)
+      if score ~= nil then
+        table.insert(matches, { name = name, display = display, score = score, pinned = pins[name] == true })
+      end
+    end
+  end
+  table.sort(matches, function(a, b)
+    if a.score ~= b.score then
+      return a.score > b.score
+    end
+    if a.pinned ~= b.pinned then
+      return a.pinned
+    end
+    return a.display < b.display
+  end)
+  for i = 1, math.min(#matches, MAX_MATCHES) do
+    table.insert(rows, {
+      id = "open:" .. matches[i].name,
+      title = matches[i].display,
+      subtitle = tr("launcher.open_subtitle"),
+      glyph = matches[i].pinned and "pinned" or "notes",
+    })
+  end
+
+  launcher.setResults(query, rows)
+end
+
+function onActivate(id)
+  local dir, suffix = settings()
+
+  if id == "append" then
+    if lastText == "" then
+      return
+    end
+    local ok, err = noctalia.mkdirAll(dir)
+    if not ok then
+      noctalia.notifyError(tr("title"), err or "")
+      return
+    end
+    local path = dir .. "/" .. SCRATCHPAD_BASE .. suffix
+    local contents = noctalia.readFile(path) or ""
+    local sep = (contents == "" or contents:sub(-1) == "\n") and "" or "\n"
+    local wrote, werr = noctalia.writeFile(path, contents .. sep .. lastText .. "\n")
+    if not wrote then
+      noctalia.notifyError(tr("title"), werr or "")
+      return
+    end
+    bumpNotesState()
+    noctalia.notify(tr("title"), tr("launcher.appended"))
+    return
+  end
+
+  if id == "create" then
+    if lastText ~= "" then
+      createNote(lastText)
+    end
+    return
+  end
+
+  if id == "home" then
+    noctalia.state.set("open_home", true)
+    noctalia.togglePanel(PANEL_ID)
+    return
+  end
+
+  if id == "clip" then
+    local clip = noctalia.clipboardText()
+    if type(clip) == "string" and noctalia.string.trim(clip) ~= "" then
+      createNote(clip)
+    end
+    return
+  end
+
+  local file = id:match("^open:(.+)$")
+  if file ~= nil then
+    openInPanel(file)
+  end
+end

notes/notes.luau

@@ -0,0 +1,19 @@
+--!nonstrict
+-- Bar widget that opens the notes panel.
+
+local glyph = barWidget.getConfig("glyph")
+
+local function render()
+  barWidget.setGlyph(glyph)
+  barWidget.setTooltip(noctalia.tr("title"))
+end
+
+function update()
+  render()
+end
+
+function onClick()
+  noctalia.togglePanel("noctalia/notes:panel")
+end
+
+render()