kokoirc 0.2.0

package/src/core/commands/help-formatter.ts

@@ -0,0 +1,185 @@
+// ─── Help Display Formatter ─────────────────────────────────
+// Three display modes using addLocalEvent() for in-buffer output.
+
+import { addLocalEvent } from "./helpers"
+import { getHelp, getCategories, type CommandHelp } from "./docs"
+import { commands, findByAlias, getCanonicalName } from "./registry"
+
+const CATEGORY_ORDER = [
+  "Connection", "Channel", "Messaging", "Moderation",
+  "Configuration", "Statusbar", "Info",
+]
+
+// ─── /help (no args) — categorized command list ─────────────
+
+export function showCommandList(): void {
+  const cats = getCategories()
+
+  // Collect commands that have doc files
+  const documented = new Set<string>()
+  for (const list of cats.values()) {
+    for (const name of list) documented.add(name)
+  }
+
+  // Commands without doc files go under "Other"
+  const other: string[] = []
+  for (const name of Object.keys(commands)) {
+    if (!documented.has(name)) other.push(name)
+  }
+  if (other.length > 0) cats.set("Other", other.sort())
+
+  addLocalEvent(`%Z7aa2f7───── Commands ─────────────────────────────────%N`)
+
+  // Ordered categories first, then any extras
+  const seen = new Set<string>()
+  const orderedCats = [...CATEGORY_ORDER, ...cats.keys()].filter((c) => {
+    if (seen.has(c)) return false
+    seen.add(c)
+    return cats.has(c)
+  })
+
+  for (const cat of orderedCats) {
+    const list = cats.get(cat)!
+    addLocalEvent(`  %Z7aa2f7${cat}%N`)
+    for (const name of list) {
+      const help = getHelp(name)
+      const desc = help?.description ?? commands[name]?.description ?? ""
+      addLocalEvent(`    %Zc0caf5${"/" + name}${" ".repeat(Math.max(1, 16 - name.length))}%Z565f89${desc}%N`)
+    }
+  }
+
+  addLocalEvent(`%Z7aa2f7─────────────────────────────────────────────────%N`)
+  addLocalEvent(`  %Z565f89Type %Z7aa2f7/help <command>%Z565f89 for details%N`)
+}
+
+// ─── /help <command> — full command help ────────────────────
+
+export function showCommandHelp(name: string): void {
+  const canonical = getCanonicalName(name)
+  const help = getHelp(canonical)
+  const def = commands[canonical] ?? findByAlias(name)
+
+  if (!help && !def) {
+    addLocalEvent(`%Zf7768eUnknown command: ${name}%N`)
+    return
+  }
+
+  addLocalEvent(`%Z7aa2f7───── /${canonical} ─────────────────────────────────%N`)
+
+  if (help) {
+    if (help.description) {
+      addLocalEvent(`  %Za9b1d6${help.description}%N`)
+    }
+    if (help.syntax) {
+      addLocalEvent("")
+      for (const line of help.syntax.split("\n")) {
+        addLocalEvent(`  %Zc0caf5${line}%N`)
+      }
+    }
+    if (def?.aliases?.length) {
+      addLocalEvent(`  %Z565f89Aliases: ${def.aliases.map((a) => "/" + a).join(", ")}%N`)
+    }
+    if (help.subcommands.length > 0) {
+      addLocalEvent("")
+      addLocalEvent(`  %Z7aa2f7Subcommands:%N`)
+      for (const sub of help.subcommands) {
+        const aliasNote = sub.aliases.length > 0 ? ` %Z565f89(${sub.aliases.join(", ")})%N` : ""
+        addLocalEvent(`    %Zc0caf5${sub.name.padEnd(14)}%Z565f89${sub.description}%N${aliasNote}`)
+      }
+    }
+    if (help.body) {
+      addLocalEvent("")
+      for (const line of help.body.split("\n")) {
+        addLocalEvent(`  %Za9b1d6${line}%N`)
+      }
+    }
+    if (help.examples.length > 0) {
+      addLocalEvent("")
+      addLocalEvent(`  %Z7aa2f7Examples:%N`)
+      for (const ex of help.examples) {
+        addLocalEvent(`    %Zc0caf5${ex}%N`)
+      }
+    }
+    if (help.seeAlso.length > 0) {
+      addLocalEvent("")
+      addLocalEvent(`  %Z565f89See also: ${help.seeAlso.map((s) => "/" + s).join(", ")}%N`)
+    }
+  } else if (def) {
+    // Fallback for commands without doc files
+    addLocalEvent(`  %Zc0caf5${def.usage}%N`)
+    addLocalEvent(`  %Za9b1d6${def.description}%N`)
+    if (def.aliases?.length) {
+      addLocalEvent(`  %Z565f89Aliases: ${def.aliases.map((a) => "/" + a).join(", ")}%N`)
+    }
+  }
+
+  addLocalEvent(`%Z7aa2f7─────────────────────────────────────────────────%N`)
+}
+
+// ─── /help <command> <subcommand> — subcommand detail ───────
+
+export function showSubcommandHelp(cmdName: string, subName: string): void {
+  const canonical = getCanonicalName(cmdName)
+  const help = getHelp(canonical)
+
+  if (!help) {
+    showCommandHelp(cmdName)
+    return
+  }
+
+  const sub = help.subcommands.find(
+    (s) => s.name === subName || s.aliases.includes(subName)
+  )
+
+  if (!sub) {
+    addLocalEvent(`%Zf7768eUnknown subcommand: /${canonical} ${subName}%N`)
+    if (help.subcommands.length > 0) {
+      const names = help.subcommands.map((s) => s.name).join(", ")
+      addLocalEvent(`  %Z565f89Available: ${names}%N`)
+    }
+    return
+  }
+
+  addLocalEvent(`%Z7aa2f7───── /${canonical} ${sub.name} ─────────────────────────%N`)
+
+  if (sub.description) {
+    addLocalEvent(`  %Za9b1d6${sub.description}%N`)
+  }
+  if (sub.syntax) {
+    addLocalEvent("")
+    for (const line of sub.syntax.split("\n")) {
+      addLocalEvent(`  %Zc0caf5${line}%N`)
+    }
+  }
+  if (sub.aliases.length > 0) {
+    addLocalEvent(`  %Z565f89Aliases: ${sub.aliases.join(", ")}%N`)
+  }
+
+  // Show flags and extra body content (after first paragraph and syntax)
+  const bodyLines = sub.body.split("\n")
+  let inFlags = false
+  const extraLines: string[] = []
+  for (const line of bodyLines) {
+    if (line.startsWith("**Flags:**")) {
+      inFlags = true
+      extraLines.push("")
+      addLocalEvent(`  %Z7aa2f7Flags:%N`)
+      continue
+    }
+    if (inFlags) {
+      if (line.startsWith("- ")) {
+        const flagText = line.slice(2)
+        const dashIdx = flagText.indexOf(" — ")
+        if (dashIdx > 0) {
+          addLocalEvent(`    %Zc0caf5${flagText.slice(0, dashIdx)}%Z565f89${flagText.slice(dashIdx)}%N`)
+        } else {
+          addLocalEvent(`    %Zc0caf5${flagText}%N`)
+        }
+      } else if (line.trim() === "") {
+        inFlags = false
+      }
+    }
+  }
+
+  addLocalEvent(`%Z7aa2f7─────────────────────────────────────────────────%N`)
+}

package/src/core/commands/helpers.ts

@@ -0,0 +1,168 @@
+import { useStore } from "@/core/state/store"
+import { makeBufferId, BufferType } from "@/types"
+import type { AppConfig } from "@/types/config"
+import { CREDENTIAL_FIELDS } from "./types"
+import type { ResolvedConfig } from "./types"
+
+/** Display a local event message in the active buffer. */
+export function addLocalEvent(text: string) {
+  const s = useStore.getState()
+  const buf = s.activeBufferId
+  if (!buf) return
+  s.addMessage(buf, {
+    id: crypto.randomUUID(),
+    timestamp: new Date(),
+    type: "event",
+    text,
+    highlight: false,
+  })
+}
+
+/** Get the channel name from the active buffer (if it's a channel buffer). */
+export function getActiveChannel(): string | null {
+  const s = useStore.getState()
+  const buf = s.activeBufferId ? s.buffers.get(s.activeBufferId) : null
+  if (!buf || buf.type !== BufferType.Channel) return null
+  return buf.name
+}
+
+/** Switch to a connection's Status buffer. */
+export function switchToStatusBuffer(connId: string) {
+  const s = useStore.getState()
+  const statusId = makeBufferId(connId, "Status")
+  if (s.buffers.has(statusId)) {
+    s.setActiveBuffer(statusId)
+  }
+}
+
+// ─── /set helpers ───────────────────────────────────────────
+
+/** Resolve a dot-path like "general.nick" or "servers.ircnet.port" to the config value. */
+export function getConfigValue(config: AppConfig, path: string): ResolvedConfig | null {
+  const parts = path.split(".")
+  if (parts.length < 2) return null
+
+  const section = parts[0]
+
+  // servers.<id>.<field>
+  if (section === "servers") {
+    if (parts.length < 3) return null
+    const serverId = parts[1]
+    const field = parts.slice(2).join(".")
+    const server = config.servers[serverId]
+    if (!server || !(field in server)) return null
+    return {
+      value: (server as any)[field],
+      field,
+      isCredential: CREDENTIAL_FIELDS.has(field),
+      serverId,
+    }
+  }
+
+  // aliases.<name> — allow creating new aliases via /set
+  if (section === "aliases") {
+    if (parts.length < 2) return null
+    const name = parts[1]
+    const value = config.aliases[name] ?? ""
+    return { value, field: name, isCredential: false }
+  }
+
+  // sidepanel.left.<field> / sidepanel.right.<field>
+  if (section === "sidepanel") {
+    if (parts.length < 3) return null
+    const side = parts[1] as "left" | "right"
+    const field = parts[2]
+    const panel = config.sidepanel?.[side]
+    if (!panel || !(field in panel)) return null
+    return { value: (panel as any)[field], field, isCredential: false }
+  }
+
+  // general.<field>, display.<field>, statusbar.<field>
+  const field = parts.slice(1).join(".")
+  const obj = (config as any)[section]
+  if (!obj || typeof obj !== "object" || !(field in obj)) return null
+  return { value: obj[field], field, isCredential: false }
+}
+
+/** Set a value in the config object in-place. */
+export function setConfigValue(config: AppConfig, path: string, value: any): void {
+  const parts = path.split(".")
+  const section = parts[0]
+
+  if (section === "aliases" && parts.length >= 2) {
+    config.aliases[parts[1]] = String(value)
+    return
+  }
+
+  if (section === "servers" && parts.length >= 3) {
+    const server = config.servers[parts[1]]
+    if (server) (server as any)[parts.slice(2).join(".")] = value
+    return
+  }
+
+  if (section === "sidepanel" && parts.length >= 3) {
+    const panel = (config.sidepanel as any)?.[parts[1]]
+    if (panel) panel[parts[2]] = value
+    return
+  }
+
+  const field = parts.slice(1).join(".")
+  const obj = (config as any)[section]
+  if (obj) obj[field] = value
+}
+
+/** Coerce a raw string value to match the type of the existing value. */
+export function coerceValue(raw: string, existing: any): any {
+  if (typeof existing === "boolean") {
+    if (raw === "true") return true
+    if (raw === "false") return false
+    return undefined
+  }
+  if (typeof existing === "number") {
+    const n = Number(raw)
+    return isNaN(n) ? undefined : n
+  }
+  if (Array.isArray(existing)) {
+    return raw.split(",").map((s) => s.trim())
+  }
+  return raw
+}
+
+/** Format a value for display. Escapes % so the theme parser doesn't eat color codes. */
+export function formatValue(v: any): string {
+  const raw = Array.isArray(v) ? v.join(", ") : String(v)
+  return raw.replace(/%/g, "%%")
+}
+
+/** Display all settings grouped by section. */
+export function listAllSettings(config: AppConfig): void {
+  addLocalEvent(`%Z7aa2f7───── Settings ─────────────────────────────────%N`)
+
+  const showSection = (label: string, prefix: string, obj: Record<string, any>) => {
+    addLocalEvent(`%Z565f89[${label}]%N`)
+    for (const [key, val] of Object.entries(obj)) {
+      if (typeof val === "object" && val !== null && !Array.isArray(val)) continue
+      const fullPath = `${prefix}.${key}`
+      const isCredential = CREDENTIAL_FIELDS.has(key)
+      const display = isCredential ? "***" : formatValue(val)
+      const envTag = isCredential ? " %Z565f89[.env]%N" : ""
+      addLocalEvent(`  %Z7aa2f7${fullPath.padEnd(32)}%N= %Zc0caf5${display}%N${envTag}`)
+    }
+  }
+
+  showSection("general", "general", config.general)
+  showSection("display", "display", config.display)
+  showSection("sidepanel.left", "sidepanel.left", config.sidepanel.left)
+  showSection("sidepanel.right", "sidepanel.right", config.sidepanel.right)
+  showSection("statusbar", "statusbar", config.statusbar)
+
+  if (Object.keys(config.aliases).length > 0) {
+    showSection("aliases", "aliases", config.aliases)
+  }
+
+  for (const [id, srv] of Object.entries(config.servers)) {
+    showSection(`servers.${id}`, `servers.${id}`, srv)
+  }
+
+  addLocalEvent(`%Z7aa2f7─────────────────────────────────────────────────%N`)
+}

package/src/core/commands/index.ts

@@ -0,0 +1,7 @@
+export { parseCommand } from "./parser"
+export type { ParsedCommand } from "./parser"
+export { executeCommand, getCommandNames } from "./execution"
+export { commands } from "./registry"
+export type { CommandDef } from "./types"
+export { loadAllDocs, getHelp, getSubcommands, getCategories } from "./docs"
+export type { CommandHelp, SubcommandHelp } from "./docs"

package/src/core/commands/parser.ts

@@ -0,0 +1,33 @@
+export interface ParsedCommand {
+  command: string
+  args: string[]
+}
+
+const GREEDY_COMMANDS = new Set(["msg", "notice", "me", "quit", "topic", "kick", "kb", "close", "disconnect", "set", "alias"])
+
+export function parseCommand(input: string): ParsedCommand | null {
+  if (!input.startsWith("/")) return null
+
+  const trimmed = input.slice(1)
+  const spaceIndex = trimmed.indexOf(" ")
+
+  if (spaceIndex === -1) {
+    return { command: trimmed.toLowerCase(), args: [] }
+  }
+
+  const command = trimmed.slice(0, spaceIndex).toLowerCase()
+  const rest = trimmed.slice(spaceIndex + 1).trim()
+
+  if (GREEDY_COMMANDS.has(command)) {
+    if (command === "me" || command === "quit" || command === "close") {
+      return { command, args: [rest] }
+    }
+    const firstSpace = rest.indexOf(" ")
+    if (firstSpace === -1) {
+      return { command, args: [rest] }
+    }
+    return { command, args: [rest.slice(0, firstSpace), rest.slice(firstSpace + 1)] }
+  }
+
+  return { command, args: rest.split(/\s+/) }
+}